Projects

const projects = await client.getProjects();
console.log(projects); // Project[]

const project = await client.getProject('proj_123');
console.log(project.name, project.type);

// Normalized scene access:
if (project.sceneData) {
  console.log('Scene models:', project.sceneData.models?.length || 0);
} else if (project.sceneDataCompressed) {
  // Runtime does not support decompression; consume compressed payload
  console.log('Compressed scene payload:', project.sceneDataEncoding);
}

const newProject = await client.createProject({
  name: 'Product Config',
  type: 'configurator'
});
console.log(newProject.id);

// A `data` payload REPLACES the stored scene — it is not a deep merge.
// The project row has several writers (this SDK, the owner's editor, the AI
// Assistant, approved AI changes, agent workflows, MCP clients), so a write
// built from a stale read erases whatever landed in between.
//
// Send baseUpdatedAt (optional, additive) and the server refuses a stale
// write with 409 instead of applying it. Omit it for last-write-wins.
const current = await client.getProject('proj_123');

try {
  const updated = await client.updateProject('proj_123', {
    name: 'Updated Name',
    data: { settings: { autoRotate: true } },
    baseUpdatedAt: current.updatedAt,
  });
} catch (error) {
  if (error instanceof ConflictError) {
    // Re-read at error.serverUpdatedAt and re-apply on top of the newer state.
  }
}

// A partial update that carries no `data` (a rename) cannot clobber scene
// data and does not need a baseline.

await client.deleteProject('proj_123');