Project Sharing

const response = await fetch(BASE_URL + '/projects/proj_123/share', {
  headers: { 'Authorization': 'Bearer ' + accessToken }
});

const data = await response.json();
// { "success": true, "settings": {
//     "isEnabled": true,
//     "shareToken": "a1b2c3...",     // build the URL yourself:
//                                    // https://YOUR_APP_DOMAIN/share/{projectId}/{shareToken}
//     "domainRestrictions": [],      // allowed embed hosts; [] = any
//     "requirePassword": false
// } }

const response = await fetch(BASE_URL + '/projects/proj_123/share/enable', {
  method: 'POST',
  headers: { 'Authorization': 'Bearer ' + accessToken }
});

// WARNING: this REPLACES the whole settings object.
// Any field you omit reverts to its default — omitting isEnabled sets it to
// false, which takes the live share link and every embed offline.
// Always send the full object. shareToken is preserved server-side; rotate it
// with POST /projects/:id/share/regenerate.
const response = await fetch(BASE_URL + '/projects/proj_123/share', {
  method: 'PUT',
  headers: {
    'Authorization': 'Bearer ' + accessToken,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    isEnabled: true,
    requirePassword: true,
    password: 'secret123',
    domainRestrictions: ['shop.example.com']
  })
});

// { "success": true, "settings": { ...the stored object... } }

const response = await fetch(BASE_URL + '/projects/proj_123/share/regenerate', {
  method: 'POST',
  headers: { 'Authorization': 'Bearer ' + accessToken }
});

const response = await fetch(BASE_URL + '/share/proj_123/abc123', {
  headers: {
    // Required when calling Supabase Edge Functions directly from browser clients
    'apikey': SUPABASE_ANON_KEY,
    'Authorization': 'Bearer ' + SUPABASE_ANON_KEY,
    // Only when the share is password-protected:
    'X-Share-Password': 'secret123'
  }
});
const data = await response.json();
// Scene is already decompressed server-side, and every model carries a
// pre-signed download url. Full schema below.

const response = await fetch(BASE_URL + '/share/proj_123/abc123/submit', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'apikey': SUPABASE_ANON_KEY,
    'Authorization': 'Bearer ' + SUPABASE_ANON_KEY
  },
  body: JSON.stringify({
    formData: { name: 'Jane Smith', email: '[email protected]' },
    selectedOptions: {},
    configurationSummary: '...',
    screenshots: []
  })
});

const data = await response.json();
// Immediate acknowledgment:
// { "success": true, "requestId": "..." }
// Screenshots/PDF/emails/webhooks are processed asynchronously after response.

{
  "success": true,
  "project": {
    "id": "proj_123",
    "name": "Modern Office Chair",
    "type": "configurator",          // 'configurator' | 'viewer' | 'modular' | ...
    "data": {
      "models": [
        {
          "id": "mdl_7f2a",          // opaque model id — the keyspace targetObjectId uses
          "fileName": "Main_roof_3x3.glb",
          "url": "https://...supabase.co/storage/v1/object/sign/...",
                                     // PRE-SIGNED (1 year). Fetch the GLB directly.
          "assetId": "ast_991",      // present for asset-library models
          "uploadedModelPath": "user_1/project-models/...",
                                     // present for project-uploaded models
          "transform": { },          // raw stored transform
          "position": { "x": 0, "y": 0, "z": 0 },     // normalized to OBJECTS here
          "rotation": { "x": 0, "y": 1.57, "z": 0 },
          "scale":    { "x": 1, "y": 1, "z": 1 },
          "partTransforms": { },
          "deletedParts": [],
          "pivotData": { }
        }
      ],
      "sceneData": {
        "optionBlocks":    [ ],
        "projectSettings": { },      // REDACTED — see the security note below
        "formFields":      [ ],
        "animationBlocks": [ ],
        "pricingBlocks":   [ ],
        "pricingFormula":  [ ]
      },
      "camera": {                    // may be undefined — fall back to your own framing
        "position": { "x": 0, "y": 2, "z": 5 },
        "target":   { "x": 0, "y": 0, "z": 0 }
      },
      "renderQuality": "optimised",  // 'optimised' | 'low' | 'high'
      "saveConfigEnabled": false     // whether the Save Configuration flow is available
    }
  }
}