@anuragpal02/zcl-contracts 0.28.0 → 0.30.0

package/dist/client.d.ts

@@ -4,7 +4,7 @@ import { type ApiErrorCode } from './common.js';
 import { type CreditBalanceResponse } from './credits.js';
 import { workspaceMemberSchema, type CreateWorkspaceRequest, type InviteMemberRequest, type InviteMemberResponse, type ListMembersResponse, type UpdateMemberRoleRequest, type UpdateWorkspaceRequest, type Workspace, type WorkspaceMembership } from './workspaces.js';
 import { type Asset, type AssetUpload, type CreateAssetUploadRequest, type CreateAssetUploadResponse, type FinalizeAssetUploadRequest, type ListAssetsResponse, type ListWorkspaceAssetsResponse, type WorkspaceAssetFilter } from './assets.js';
-import { projectRunListResponseSchema, projectRunResponseSchema, type CreateProjectRequest, type CreateProjectRunRequest, type LedMapResponse, type ListProjectRunsQuery, type ListProjectsQuery, type Project, type UpdateLedMapRequest, type UpdateProjectRequest, type UpdateProjectRunRequest } from './projects.js';
+import { projectRunListResponseSchema, projectRunResponseSchema, type CreateLedMapRequest, type CreateProjectRequest, type CreateProjectRunRequest, type LedMapListResponse, type LedMapResponse, type LedMapUpdateResponse, type LedMapUsageResponse, type ListLedMapsQuery, type ListProjectRunsQuery, type ListProjectsQuery, type Project, type UpdateLedMapMetadataRequest, type UpdateLedMapRequest, type UpdateProjectRequest, type UpdateProjectRunRequest } from './projects.js';
 import { type CreateGenerationJobRequest, type CreatePanelSetRequest, type CreatePanelSetResponse, type CreateSmartVideoRequest, type CreateSmartVideoResponse, type CreateVideoLoopRequest, type CreateVideoUpscaleRequest, type EditGenerationJobRequest, type GenerationJobResponse, type GenerationJobStatus, type GenerationJobType, type ListGenerationJobsResponse } from './generation.js';
 import { type DescribeImageRequest, type DescribeImageResponse } from './assistant.js';
 import { type AdminAdjustCreditsRequest, type AdminAdjustCreditsResponse, type AdminJobDetailResponse, type AdminJobStatus, type AdminMeResponse, type AdminUsageResponse, type AdminUserDetailResponse, type AdminWorkspaceDetailResponse, type ListAdminAuditResponse, type ListAdminJobsResponse, type ListAdminUsersResponse, type ListAdminWorkspacesResponse, type SetPlatformAdminRequest, type SetPlatformAdminResponse, type SetUserDisabledRequest, type SetUserDisabledResponse, type StepUpStartResponse, type StepUpVerifyResponse } from './admin.js';
@@ -82,8 +82,15 @@ export declare function createZclApiClient(options: ZclApiClientOptions): {
     ledMaps: {
         get(workspaceId: string, projectId: string): Promise<LedMapResponse>;
         update(workspaceId: string, projectId: string, input: UpdateLedMapRequest): Promise<LedMapResponse>;
+        list(workspaceId: string, projectId: string, query?: ListLedMapsQuery): Promise<LedMapListResponse>;
+        create(workspaceId: string, projectId: string, input?: CreateLedMapRequest): Promise<LedMapResponse>;
         getById(workspaceId: string, projectId: string, ledMapId: string): Promise<LedMapResponse>;
-        updateById(workspaceId: string, projectId: string, ledMapId: string, input: UpdateLedMapRequest): Promise<LedMapResponse>;
+        updateById(workspaceId: string, projectId: string, ledMapId: string, input: UpdateLedMapRequest): Promise<LedMapUpdateResponse>;
+        usage(workspaceId: string, projectId: string, ledMapId: string): Promise<LedMapUsageResponse>;
+        updateMetadata(workspaceId: string, projectId: string, ledMapId: string, input: UpdateLedMapMetadataRequest): Promise<LedMapResponse>;
+        remove(workspaceId: string, projectId: string, ledMapId: string): Promise<{
+            data: Record<string, never>;
+        }>;
     };
     runs: {
         list(workspaceId: string, projectId: string, query?: ListProjectRunsQuery): Promise<z.infer<typeof projectRunListResponseSchema>>;

package/dist/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EASL,KAAK,mBAAmB,EACxB,KAAK,2BAA2B,EAChC,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,qBAAqB,EAC1B,KAAK,2BAA2B,EAChC,KAAK,eAAe,EACpB,KAAK,aAAa,EACnB,MAAM,WAAW,CAAA;AAClB,OAAO,EAA2C,KAAK,YAAY,EAAE,MAAM,aAAa,CAAA;AACxF,OAAO,EAA+B,KAAK,qBAAqB,EAAE,MAAM,cAAc,CAAA;AACtF,OAAO,EAOL,qBAAqB,EAIrB,KAAK,sBAAsB,EAC3B,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,EAC3B,KAAK,SAAS,EACd,KAAK,mBAAmB,EACzB,MAAM,iBAAiB,CAAA;AACxB,OAAO,EAOL,KAAK,KAAK,EACV,KAAK,WAAW,EAChB,KAAK,wBAAwB,EAC7B,KAAK,yBAAyB,EAC9B,KAAK,0BAA0B,EAC/B,KAAK,kBAAkB,EACvB,KAAK,2BAA2B,EAChC,KAAK,oBAAoB,EAC1B,MAAM,aAAa,CAAA;AACpB,OAAO,EAQL,4BAA4B,EAC5B,wBAAwB,EAMxB,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,KAAK,uBAAuB,EAC5B,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACnB,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,EACrB,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACtB,KAAK,OAAO,EACZ,KAAK,2BAA2B,EAChC,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,KAAK,uBAAuB,EAC7B,MAAM,eAAe,CAAA;AACtB,OAAO,EAWL,KAAK,0BAA0B,EAC/B,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,EAC3B,KAAK,uBAAuB,EAC5B,KAAK,wBAAwB,EAC7B,KAAK,sBAAsB,EAC3B,KAAK,yBAAyB,EAC9B,KAAK,wBAAwB,EAC7B,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,0BAA0B,EAChC,MAAM,iBAAiB,CAAA;AACxB,OAAO,EAGL,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC3B,MAAM,gBAAgB,CAAA;AACvB,OAAO,EAmBL,KAAK,yBAAyB,EAC9B,KAAK,0BAA0B,EAC/B,KAAK,sBAAsB,EAC3B,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACvB,KAAK,uBAAuB,EAC5B,KAAK,4BAA4B,EACjC,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,EAC3B,KAAK,2BAA2B,EAChC,KAAK,uBAAuB,EAC5B,KAAK,wBAAwB,EAC7B,KAAK,sBAAsB,EAC3B,KAAK,uBAAuB,EAC5B,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EAC1B,MAAM,YAAY,CAAA;AAEnB,KAAK,SAAS,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAA;AAExD,MAAM,MAAM,mBAAmB,GAAG;IAChC,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,SAAS,CAAA;CAClB,CAAA;AAED,MAAM,MAAM,uBAAuB,GAAG,SAAS,GAAG;IAChD,UAAU,EAAE,mBAAmB,CAAA;CAChC,CAAA;AAED,MAAM,MAAM,qBAAqB,GAAG;IAClC,IAAI,EAAE,uBAAuB,EAAE,CAAA;IAC/B,UAAU,EAAE;QACV,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;KAC1B,CAAA;CACF,CAAA;AAQD,qBAAa,WAAY,SAAQ,KAAK;aAElB,IAAI,EAAE,YAAY;aAElB,MAAM,EAAE,MAAM;aACd,SAAS,CAAC,EAAE,MAAM;gBAHlB,IAAI,EAAE,YAAY,EAClC,OAAO,EAAE,MAAM,EACC,MAAM,EAAE,MAAM,EACd,SAAS,CAAC,EAAE,MAAM,YAAA;CAKrC;AA8BD,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,mBAAmB;;sBAuD3C,aAAa,GAAG,OAAO,CAAC,mBAAmB,CAAC;qBAM7C,YAAY,GAAG,OAAO,CAAC,mBAAmB,CAAC;kBAM9C,OAAO,CAAC,cAAc,CAAC;oCAGL,2BAA2B,GAAG,OAAO,CAAC,qBAAqB,CAAC;oCAM5D,2BAA2B,GAAG,OAAO,CAAC,qBAAqB,CAAC;;;eAQjF,OAAO,CAAC,eAAe,CAAC;;;gBAKvB,OAAO,CAAC,qBAAqB,CAAC;sBAGxB,sBAAsB,GAAG,OAAO,CAAC;YAAE,IAAI,EAAE,SAAS,CAAA;SAAE,CAAC;4BAM/C,MAAM,SAAS,sBAAsB,GAAG,OAAO,CAAC;YAAE,IAAI,EAAE,SAAS,CAAA;SAAE,CAAC;iCAOzE,MAAM,YACV;YAAE,MAAM,CAAC,EAAE,MAAM,CAAC;YAAC,KAAK,CAAC,EAAE,MAAM,CAAA;SAAE,GAC3C,OAAO,CAAC,mBAAmB,CAAC;kCAWL,MAAM,SAAS,mBAAmB,GAAG,OAAO,CAAC,oBAAoB,CAAC;sCAO7E,MAAM,UACX,MAAM,SACP,uBAAuB,GAC7B,OAAO,CAAC;YAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAA;SAAE,CAAC;kCAMjC,MAAM,UAAU,MAAM,GAAG,OAAO,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA;SAAE,CAAC;kCAKjE,MAAM,YAAY,MAAM,GAAG,OAAO,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA;SAAE,CAAC;;;0BAQ9E,MAAM,YACV,iBAAiB,GACzB,OAAO,CAAC;YAAE,IAAI,EAAE,OAAO,EAAE,CAAC;YAAC,UAAU,EAAE;gBAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;aAAE,CAAA;SAAE,CAAC;4BAuBtD,MAAM,SAAS,oBAAoB,GAAG,OAAO,CAAC;YAAE,IAAI,EAAE,OAAO,CAAA;SAAE,CAAC;yBAMnE,MAAM,aAAa,MAAM,GAAG,OAAO,CAAC;YAAE,IAAI,EAAE,OAAO,CAAA;SAAE,CAAC;4BAGnD,MAAM,aAAa,MAAM,SAAS,oBAAoB,GAAG,OAAO,CAAC;YAAE,IAAI,EAAE,OAAO,CAAA;SAAE,CAAC;;;yBAQtF,MAAM,aAAa,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;4BAOhD,MAAM,aAAa,MAAM,SAAS,mBAAmB,GAAG,OAAO,CAAC,cAAc,CAAC;0BAOjF,MAAM,aAAa,MAAM,UAAS,gBAAgB,GAAQ,OAAO,CAAC,kBAAkB,CAAC;4BAanF,MAAM,aAAa,MAAM,UAAU,mBAAmB,GAAG,OAAO,CAAC,cAAc,CAAC;6BAQ/E,MAAM,aAAa,MAAM,YAAY,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;gCAU3E,MAAM,aACR,MAAM,YACP,MAAM,SACT,mBAAmB,GACzB,OAAO,CAAC,oBAAoB,CAAC;2BAQb,MAAM,aAAa,MAAM,YAAY,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;oCAS9E,MAAM,aACR,MAAM,YACP,MAAM,SACT,2BAA2B,GACjC,OAAO,CAAC,cAAc,CAAC;4BAQN,MAAM,aAAa,MAAM,YAAY,MAAM,GAAG,OAAO,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA;SAAE,CAAC;;;0BAU3F,MAAM,aACR,MAAM,UACV,oBAAoB,GAC1B,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;yBAcvC,MAAM,aAAa,MAAM,SAAS,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;4BAI9F,MAAM,aACR,MAAM,SACV,uBAAuB,GAC7B,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;4BAOrC,MAAM,aACR,MAAM,SACV,MAAM,SACN,uBAAuB,GAC7B,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;;;kCASrC,MAAM,aACR,MAAM,SACV,wBAAwB,GAC9B,OAAO,CAAC,yBAAyB,CAAC;6BAMV,WAAW,QAAQ,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;8BAWvD,MAAM,aACR,MAAM,WACR,MAAM,SACR,0BAA0B,GAChC,OAAO,CAAC,KAAK,CAAC;0BAMC,MAAM,aAAa,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;mCAM1D,MAAM,YACV;YAAE,MAAM,CAAC,EAAE,MAAM,CAAC;YAAC,KAAK,CAAC,EAAE,MAAM,CAAC;YAAC,MAAM,CAAC,EAAE,oBAAoB,CAAA;SAAE,GAC1E,OAAO,CAAC,2BAA2B,CAAC;gCAgBf,MAAM,aAAa,MAAM,WAAW,MAAM,GAAG,MAAM;;;yBAK1D,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC;;;4BAMzC,MAAM,aACR,MAAM,SACV,0BAA0B,GAChC,OAAO,CAAC,qBAAqB,CAAC;0BAWlB,MAAM,aACR,MAAM,SACV,wBAAwB,GAC9B,OAAO,CAAC,qBAAqB,CAAC;oCAYlB,MAAM,aACR,MAAM,SACV,qBAAqB,GAC3B,OAAO,CAAC,sBAAsB,CAAC;qCAYnB,MAAM,aACR,MAAM,SACV,sBAAsB,GAC5B,OAAO,CAAC,qBAAqB,CAAC;wCASlB,MAAM,aACR,MAAM,SACV,yBAAyB,GAC/B,OAAO,CAAC,qBAAqB,CAAC;sCASlB,MAAM,aACR,MAAM,SACV,uBAAuB,GAC7B,OAAO,CAAC,wBAAwB,CAAC;yBAQnB,MAAM,aAAa,MAAM,SAAS,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC;0BAO3E,MAAM,aACR,MAAM,YACR;YACP,MAAM,CAAC,EAAE,mBAAmB,CAAA;YAC5B,cAAc,CAAC,EAAE,MAAM,CAAA;YACvB,KAAK,CAAC,EAAE,MAAM,CAAA;YACd,MAAM,CAAC,EAAE,MAAM,CAAA;YACf,KAAK,CAAC,EAAE,MAAM,CAAA;SACf,GACA,OAAO,CAAC,0BAA0B,CAAC;;;mCA0BvB,MAAM,aACR,MAAM,SACV,oBAAoB,GAC1B,OAAO,CAAC,qBAAqB,CAAC;;;cAY3B,OAAO,CAAC,eAAe,CAAC;4BAGX;YAAE,CAAC,CAAC,EAAE,MAAM,CAAC;YAAC,KAAK,CAAC,EAAE,MAAM,CAAC;YAAC,MAAM,CAAC,EAAE,MAAM,CAAA;SAAE,GAAQ,OAAO,CAAC,sBAAsB,CAAC;iCAcjF;YAAE,CAAC,CAAC,EAAE,MAAM,CAAC;YAAC,KAAK,CAAC,EAAE,MAAM,CAAC;YAAC,MAAM,CAAC,EAAE,MAAM,CAAA;SAAE,GAAQ,OAAO,CAAC,2BAA2B,CAAC;wBAcnG,MAAM,GAAG,OAAO,CAAC,uBAAuB,CAAC;kCAG/B,MAAM,GAAG,OAAO,CAAC,4BAA4B,CAAC;mCAIzD,MAAM,SACZ,yBAAyB,GAC/B,OAAO,CAAC,0BAA0B,CAAC;iCAO5B,MAAM,SACP,uBAAuB,GAC7B,OAAO,CAAC,wBAAwB,CAAC;gCAO1B,MAAM,SACP,sBAAsB,GAC5B,OAAO,CAAC,uBAAuB,CAAC;+BAOxB;YAAE,MAAM,CAAC,EAAE,MAAM,CAAC;YAAC,OAAO,CAAC,EAAE,MAAM,CAAC;YAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;YAAC,KAAK,CAAC,EAAE,MAAM,CAAC;YAAC,MAAM,CAAC,EAAE,MAAM,CAAA;SAAE,GACjG,OAAO,CAAC,sBAAsB,CAAC;2BAqBvB;YACP,WAAW,CAAC,EAAE,MAAM,CAAA;YACpB,MAAM,CAAC,EAAE,cAAc,CAAA;YACvB,IAAI,CAAC,EAAE,iBAAiB,CAAA;YACxB,MAAM,CAAC,EAAE,MAAM,CAAA;YACf,KAAK,CAAC,EAAE,MAAM,CAAA;YACd,MAAM,CAAC,EAAE,MAAM,CAAA;SAChB,GACA,OAAO,CAAC,qBAAqB,CAAC;sBAuBnB,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC;2BAGpC;YAAE,UAAU,CAAC,EAAE,MAAM,CAAA;SAAE,GAAQ,OAAO,CAAC,kBAAkB,CAAC;;qBASjE,OAAO,CAAC,mBAAmB,CAAC;yBAGxB,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC;;;EAS1D;AAED,MAAM,MAAM,YAAY,GAAG,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAA"}

package/dist/client.js

@@ -4,7 +4,7 @@ import { errorResponseSchema, listResponseSchema } from './common.js';
 import { creditBalanceResponseSchema } from './credits.js';
 import { createWorkspaceRequestSchema, inviteMemberRequestSchema, inviteMemberResponseSchema, listMembersResponseSchema, updateMemberRoleRequestSchema, updateWorkspaceRequestSchema, workspaceMemberSchema, workspaceMembershipSchema, workspaceResponseSchema, workspaceSchema } from './workspaces.js';
 import { assetSchema, createAssetUploadRequestSchema, createAssetUploadResponseSchema, finalizeAssetUploadRequestSchema, listAssetsResponseSchema, listWorkspaceAssetsResponseSchema } from './assets.js';
-import { createProjectRequestSchema, createProjectRunRequestSchema, ledMapResponseSchema, projectRunListResponseSchema, projectRunResponseSchema, projectSchema, updateLedMapRequestSchema, updateProjectRequestSchema, updateProjectRunRequestSchema } from './projects.js';
+import { createLedMapRequestSchema, createProjectRequestSchema, createProjectRunRequestSchema, ledMapListResponseSchema, ledMapResponseSchema, ledMapUpdateResponseSchema, ledMapUsageResponseSchema, projectRunListResponseSchema, projectRunResponseSchema, projectSchema, updateLedMapMetadataRequestSchema, updateLedMapRequestSchema, updateProjectRequestSchema, updateProjectRunRequestSchema } from './projects.js';
 import { createGenerationJobRequestSchema, createPanelSetRequestSchema, createPanelSetResponseSchema, createSmartVideoRequestSchema, createSmartVideoResponseSchema, createVideoLoopRequestSchema, createVideoUpscaleRequestSchema, editGenerationJobRequestSchema, generationJobResponseSchema, listGenerationJobsResponseSchema } from './generation.js';
 import { describeImageRequestSchema, describeImageResponseSchema } from './assistant.js';
 import { adminAdjustCreditsRequestSchema, adminAdjustCreditsResponseSchema, adminJobDetailResponseSchema, adminMeResponseSchema, adminUsageResponseSchema, adminUserDetailResponseSchema, adminWorkspaceDetailResponseSchema, listAdminAuditResponseSchema, listAdminJobsResponseSchema, listAdminUsersResponseSchema, listAdminWorkspacesResponseSchema, setPlatformAdminRequestSchema, setPlatformAdminResponseSchema, setUserDisabledRequestSchema, setUserDisabledResponseSchema, stepUpStartResponseSchema, stepUpVerifyRequestSchema, stepUpVerifyResponseSchema } from './admin.js';
@@ -207,19 +207,59 @@ export function createZclApiClient(options) {
             get(workspaceId, projectId) {
                 return request(`/workspaces/${workspaceId}/projects/${projectId}/led-map`, ledMapResponseSchema);
             },
+            // The project-level alias. Legacy: it resolves to the project's OLDEST map, which is
+            // how two creations end up silently editing one row. Phase B removes the need for it —
+            // prefer the by-id methods below. Its response stays on ledMapResponseSchema because
+            // the alias cannot branch (it has no creation to repoint).
             update(workspaceId, projectId, input) {
                 return request(`/workspaces/${workspaceId}/projects/${projectId}/led-map`, ledMapResponseSchema, {
                     method: 'PATCH',
                     body: updateLedMapRequestSchema.parse(input)
                 });
             },
+            // The project's maps, for the picker and the library listing. Keyset-paginated.
+            list(workspaceId, projectId, query = {}) {
+                const params = new URLSearchParams();
+                if (query.cursor !== undefined) {
+                    params.set('cursor', query.cursor);
+                }
+                if (query.limit !== undefined) {
+                    params.set('limit', String(query.limit));
+                }
+                const qs = params.toString() ? `?${params.toString()}` : '';
+                return request(`/workspaces/${workspaceId}/projects/${projectId}/led-maps${qs}`, ledMapListResponseSchema);
+            },
+            // "Start a new map". Omit `input` (or `copyFromLedMapId`) for an empty map the
+            // creation owns outright, rather than falling back to the project alias above.
+            create(workspaceId, projectId, input) {
+                return request(`/workspaces/${workspaceId}/projects/${projectId}/led-maps`, ledMapResponseSchema, {
+                    method: 'POST',
+                    body: createLedMapRequestSchema.parse(input ?? {})
+                });
+            },
             // One specific map by id. The projectId in the path is the tenant gate, not a lookup
             // key — the server filters on (id AND project_id) and 404s a map from another project.
             getById(workspaceId, projectId, ledMapId) {
                 return request(`/workspaces/${workspaceId}/projects/${projectId}/led-maps/${ledMapId}`, ledMapResponseSchema);
             },
+            // Geometry PATCH. Returns the FORK SIGNAL: when the server branches a shared map,
+            // `branchedFrom` is the id the edit started from and `data.id` is a NEW row the
+            // caller must repoint its creation at. See `ledMapUpdateResponseSchema`.
             updateById(workspaceId, projectId, ledMapId, input) {
-                return request(`/workspaces/${workspaceId}/projects/${projectId}/led-maps/${ledMapId}`, ledMapResponseSchema, { method: 'PATCH', body: updateLedMapRequestSchema.parse(input) });
+                return request(`/workspaces/${workspaceId}/projects/${projectId}/led-maps/${ledMapId}`, ledMapUpdateResponseSchema, { method: 'PATCH', body: updateLedMapRequestSchema.parse(input) });
+            },
+            // The creations referencing this map — the shared badge and the delete refusal.
+            usage(workspaceId, projectId, ledMapId) {
+                return request(`/workspaces/${workspaceId}/projects/${projectId}/led-maps/${ledMapId}/usage`, ledMapUsageResponseSchema);
+            },
+            // Rename only. A separate route from the geometry PATCH because it must NOT bump
+            // `version` — see `updateLedMapMetadataRequestSchema`.
+            updateMetadata(workspaceId, projectId, ledMapId, input) {
+                return request(`/workspaces/${workspaceId}/projects/${projectId}/led-maps/${ledMapId}/metadata`, ledMapResponseSchema, { method: 'PATCH', body: updateLedMapMetadataRequestSchema.parse(input) });
+            },
+            // Refused with a 409 naming the creations when any creation still references the map.
+            remove(workspaceId, projectId, ledMapId) {
+                return request(`/workspaces/${workspaceId}/projects/${projectId}/led-maps/${ledMapId}`, z.object({ data: z.object({}) }), { method: 'DELETE' });
             }
         },
         runs: {

package/dist/generation.d.ts

@@ -255,6 +255,40 @@ export declare const panelVideoDescriptorSchema: z.ZodDiscriminatedUnion<[z.ZodO
     nativeH: z.ZodNumber;
     mode: z.ZodLiteral<"mirror">;
 }, z.core.$strip>], "mode">;
+/**
+ * Why a job failed, in a form a client may map to human copy.
+ *
+ * A CLOSED set, deliberately. The server stores its failure reasons in two
+ * places and neither is safe to forward verbatim:
+ *   - `generation_job_events.data.reason` — written by EVERY failure path, but
+ *     heterogeneous: the image paths store short codes, while the video paths
+ *     store `err.message.slice(0, 200)`, an arbitrary provider exception that
+ *     can carry an endpoint URL or a request id.
+ *   - `generation_job_steps.error` — short codes, but the IMAGE paths only; it
+ *     covers no video failure and no reconciler-reaped job.
+ *
+ * Because something must map either way, the mapping lives at the API boundary
+ * and this enum makes it total: a value nobody mapped cannot reach a client, it
+ * degrades to `unknown`. That containment is structural rather than a matter of
+ * reviewer discipline — the next person to add a workflow cannot leak by
+ * default.
+ *
+ * Members name the USER'S SITUATION, not the system's fault, so client copy
+ * falls out of the code almost mechanically. The test: if a member's best copy
+ * is "something went wrong", it belongs in `internal_error`.
+ */
+export declare const generationFailureReasonSchema: z.ZodEnum<{
+    internal_error: "internal_error";
+    unknown: "unknown";
+    prompt_blocked: "prompt_blocked";
+    content_blocked: "content_blocked";
+    no_image: "no_image";
+    invalid_request: "invalid_request";
+    provider_unavailable: "provider_unavailable";
+    source_missing: "source_missing";
+    panel_geometry_missing: "panel_geometry_missing";
+    timed_out: "timed_out";
+}>;
 export declare const generationJobSchema: z.ZodObject<{
     id: z.ZodString;
     workspaceId: z.ZodString;
@@ -291,6 +325,18 @@ export declare const generationJobSchema: z.ZodObject<{
     sourceAssetIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
     parentJobId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
     variantGroupId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    failureReason: z.ZodDefault<z.ZodNullable<z.ZodEnum<{
+        internal_error: "internal_error";
+        unknown: "unknown";
+        prompt_blocked: "prompt_blocked";
+        content_blocked: "content_blocked";
+        no_image: "no_image";
+        invalid_request: "invalid_request";
+        provider_unavailable: "provider_unavailable";
+        source_missing: "source_missing";
+        panel_geometry_missing: "panel_geometry_missing";
+        timed_out: "timed_out";
+    }>>>;
 }, z.core.$strip>;
 export declare const createGenerationJobRequestSchema: z.ZodObject<{
     prompt: z.ZodString;
@@ -343,6 +389,18 @@ export declare const generationJobResponseSchema: z.ZodObject<{
         sourceAssetIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
         parentJobId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
         variantGroupId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        failureReason: z.ZodDefault<z.ZodNullable<z.ZodEnum<{
+            internal_error: "internal_error";
+            unknown: "unknown";
+            prompt_blocked: "prompt_blocked";
+            content_blocked: "content_blocked";
+            no_image: "no_image";
+            invalid_request: "invalid_request";
+            provider_unavailable: "provider_unavailable";
+            source_missing: "source_missing";
+            panel_geometry_missing: "panel_geometry_missing";
+            timed_out: "timed_out";
+        }>>>;
     }, z.core.$strip>;
 }, z.core.$strip>;
 export declare const createSmartVideoResponseSchema: z.ZodObject<{
@@ -383,6 +441,18 @@ export declare const createSmartVideoResponseSchema: z.ZodObject<{
             sourceAssetIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
             parentJobId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
             variantGroupId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            failureReason: z.ZodDefault<z.ZodNullable<z.ZodEnum<{
+                internal_error: "internal_error";
+                unknown: "unknown";
+                prompt_blocked: "prompt_blocked";
+                content_blocked: "content_blocked";
+                no_image: "no_image";
+                invalid_request: "invalid_request";
+                provider_unavailable: "provider_unavailable";
+                source_missing: "source_missing";
+                panel_geometry_missing: "panel_geometry_missing";
+                timed_out: "timed_out";
+            }>>>;
         }, z.core.$strip>;
         videoPlan: z.ZodObject<{
             jobs: z.ZodArray<z.ZodObject<{
@@ -502,6 +572,18 @@ export declare const createPanelSetResponseSchema: z.ZodObject<{
         sourceAssetIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
         parentJobId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
         variantGroupId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        failureReason: z.ZodDefault<z.ZodNullable<z.ZodEnum<{
+            internal_error: "internal_error";
+            unknown: "unknown";
+            prompt_blocked: "prompt_blocked";
+            content_blocked: "content_blocked";
+            no_image: "no_image";
+            invalid_request: "invalid_request";
+            provider_unavailable: "provider_unavailable";
+            source_missing: "source_missing";
+            panel_geometry_missing: "panel_geometry_missing";
+            timed_out: "timed_out";
+        }>>>;
     }, z.core.$strip>;
     panels: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
         jobId: z.ZodString;
@@ -579,6 +661,18 @@ export declare const listGenerationJobsResponseSchema: z.ZodObject<{
         sourceAssetIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
         parentJobId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
         variantGroupId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        failureReason: z.ZodDefault<z.ZodNullable<z.ZodEnum<{
+            internal_error: "internal_error";
+            unknown: "unknown";
+            prompt_blocked: "prompt_blocked";
+            content_blocked: "content_blocked";
+            no_image: "no_image";
+            invalid_request: "invalid_request";
+            provider_unavailable: "provider_unavailable";
+            source_missing: "source_missing";
+            panel_geometry_missing: "panel_geometry_missing";
+            timed_out: "timed_out";
+        }>>>;
     }, z.core.$strip>>;
     pagination: z.ZodObject<{
         nextCursor: z.ZodNullable<z.ZodString>;
@@ -602,6 +696,7 @@ export type PanelPlanEntry = z.infer<typeof panelPlanEntrySchema>;
 export type VideoPlan = z.infer<typeof videoPlanSchema>;
 export type PanelVideoDescriptor = z.infer<typeof panelVideoDescriptorSchema>;
 export type CreateSmartVideoResponse = z.infer<typeof createSmartVideoResponseSchema>;
+export type GenerationFailureReason = z.infer<typeof generationFailureReasonSchema>;
 export type GenerationJob = z.infer<typeof generationJobSchema>;
 export type CreateGenerationJobRequest = z.input<typeof createGenerationJobRequestSchema>;
 export type ListGenerationJobsQuery = z.input<typeof listGenerationJobsQuerySchema>;

package/dist/generation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generation.d.ts","sourceRoot":"","sources":["../src/generation.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"generation.d.ts","sourceRoot":"","sources":["../src/generation.ts"],"names":[],"mappings":"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"}

package/dist/generation.js

@@ -153,6 +153,55 @@ export const panelVideoDescriptorSchema = z.discriminatedUnion('mode', [
     z.object({ mode: z.literal('reuse'), ...panelVideoDescriptorBase, assetId: idSchema }),
     z.object({ mode: z.literal('mirror'), ...panelVideoDescriptorBase, sourcePanelId: ledPanelIdSchema })
 ]);
+/**
+ * Why a job failed, in a form a client may map to human copy.
+ *
+ * A CLOSED set, deliberately. The server stores its failure reasons in two
+ * places and neither is safe to forward verbatim:
+ *   - `generation_job_events.data.reason` — written by EVERY failure path, but
+ *     heterogeneous: the image paths store short codes, while the video paths
+ *     store `err.message.slice(0, 200)`, an arbitrary provider exception that
+ *     can carry an endpoint URL or a request id.
+ *   - `generation_job_steps.error` — short codes, but the IMAGE paths only; it
+ *     covers no video failure and no reconciler-reaped job.
+ *
+ * Because something must map either way, the mapping lives at the API boundary
+ * and this enum makes it total: a value nobody mapped cannot reach a client, it
+ * degrades to `unknown`. That containment is structural rather than a matter of
+ * reviewer discipline — the next person to add a workflow cannot leak by
+ * default.
+ *
+ * Members name the USER'S SITUATION, not the system's fault, so client copy
+ * falls out of the code almost mechanically. The test: if a member's best copy
+ * is "something went wrong", it belongs in `internal_error`.
+ */
+export const generationFailureReasonSchema = z.enum([
+    /** The prompt tripped a safety filter. Actionable: reword it. */
+    'prompt_blocked',
+    /** The OUTPUT tripped a safety filter. Actionable: reword or retry. */
+    'content_blocked',
+    /** The model answered without an image. Actionable: retry or reword. */
+    'no_image',
+    /** The request itself was rejected as invalid. Rarely user-actionable. */
+    'invalid_request',
+    /** Provider down / rate-limited / unreachable. Actionable: just retry. */
+    'provider_unavailable',
+    /** A required source image (edit parent, panel master) could not be read. */
+    'source_missing',
+    /**
+     * A panel job carried no pinned geometry. Kept DISTINCT from internal_error
+     * because the user can act on it — re-run the LED map step — and telling
+     * someone "something went wrong" when the fix is one click away is precisely
+     * the failure this field exists to end.
+     */
+    'panel_geometry_missing',
+    /** Ours, and nothing the user can do. Misconfiguration, bugs, bad state. */
+    'internal_error',
+    /** Reaped for exceeding its budget without finishing. Actionable: retry. */
+    'timed_out',
+    /** Unmapped. The fallback that makes the set total; never leaks a raw value. */
+    'unknown'
+]);
 export const generationJobSchema = z.object({
     id: idSchema,
     workspaceId: idSchema,
@@ -180,7 +229,16 @@ export const generationJobSchema = z.object({
     runId: idSchema.nullable().default(null),
     sourceAssetIds: z.array(idSchema).default([]),
     parentJobId: idSchema.nullable().default(null),
-    variantGroupId: idSchema.nullable().default(null)
+    variantGroupId: idSchema.nullable().default(null),
+    /**
+     * Why this job failed. Null on every non-failed job, and null on a failed job
+     * whose reason could not be determined. Defaults so pre-0.30 payloads parse —
+     * which, per the `z.infer` note above, makes it a REQUIRED output field and so
+     * a compile error in `mapJob` and the fixtures until they are updated. That is
+     * the point: the alternative is another field silently emitting null for
+     * months, as `ledMapId` did.
+     */
+    failureReason: generationFailureReasonSchema.nullable().default(null)
 });
 export const createGenerationJobRequestSchema = imageGenerateParamsSchema;
 export const generationJobResponseSchema = apiSuccessSchema(generationJobSchema);

package/dist/projects.d.ts

@@ -40,6 +40,19 @@ export declare const ledPanelsSchema: z.ZodArray<z.ZodObject<{
     showLabel: z.ZodOptional<z.ZodBoolean>;
     mirrorOf: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNull]>>;
 }, z.core.$strip>>;
+/**
+ * Library membership state of a map. 'draft' = private to one creation;
+ * 'library' = saved and reusable.
+ *
+ * NOTE for Phase B: this is NOT the picker's predicate. The picker filters on
+ * `jsonb_array_length(panels_json) > 0` and nothing else — `scripts/backfill-runs.ts`
+ * promoted exactly the non-empty set to 'library', but every map created since is
+ * 'draft' with panels, so filtering on this enum would hide all of them.
+ */
+export declare const ledMapLibraryStatusSchema: z.ZodEnum<{
+    draft: "draft";
+    library: "library";
+}>;
 export declare const ledMapSchema: z.ZodObject<{
     id: z.ZodString;
     projectId: z.ZodString;
@@ -122,6 +135,240 @@ export declare const ledMapResponseSchema: z.ZodObject<{
         updatedAt: z.ZodString;
     }, z.core.$strip>;
 }, z.core.$strip>;
+/**
+ * A creation that references a map. Powers two Phase B surfaces: the
+ * "Shared · used in Day 1 Opener, Day 2 Keynote" badge on a locked editor, and the
+ * named refusal when a delete is blocked (`project_runs.led_map_id` is
+ * ON DELETE restrict, so the database blocks it either way — this is what turns a
+ * bare FK error into a sentence).
+ *
+ * Deliberately its own aggregate rather than something derived client-side from
+ * `runs.list`: that listing is keyset-paginated with a default limit, so a map used
+ * by a creation on page 2 would be reported as unshared.
+ */
+export declare const ledMapUsageSchema: z.ZodObject<{
+    runId: z.ZodString;
+    name: z.ZodString;
+}, z.core.$strip>;
+/**
+ * Rename a map (or move it between library states) WITHOUT touching its geometry.
+ * `updateLedMapRequestSchema` replaces the whole panel array, so before this there
+ * was no way to rename a map at all.
+ *
+ * DELIBERATELY NO `expectedVersion`, AND THE SERVER MUST NOT BUMP `version` ON IT.
+ * This is not stylistic. `version` is not only the geometry concurrency token — it is
+ * half the free centre-panel reuse gate (zcl-api
+ * services/generation-service.ts:726-739, `if (master.ledMapVersion !== map.version)
+ * { return false }`). Bumping it on a rename would make RENAMING A MAP SILENTLY COST
+ * THE USER CREDITS on their next Generate All. zcl-web-next's editor already names
+ * this exact hazard for panel labels (rebuild-panel-set.ts:568-571: gating on the
+ * version counter "would permanently unrestore a user's wall because they renamed
+ * 'LED 3'").
+ *
+ * So a metadata PATCH stays outside the geometry concurrency protocol entirely: no
+ * CAS token in, no counter bump out. Concurrent renames are last-write-wins, which is
+ * the correct semantics for a scalar. Do not add `expectedVersion` here "for
+ * consistency" with the geometry PATCH — the asymmetry is the point.
+ *
+ * `name: null` clears the name (back to an unnamed working copy). `name: ''` and
+ * whitespace-only are rejected. Unknown keys — notably a smuggled `panels` or
+ * `expectedVersion` — are STRIPPED by zod rather than rejected, so they never reach
+ * the server; a patch whose only keys are unknown fails the refine below.
+ *
+ * Response reuses `ledMapResponseSchema` — a renamed map is just a map.
+ */
+export declare const updateLedMapMetadataRequestSchema: z.ZodObject<{
+    name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    libraryStatus: z.ZodOptional<z.ZodEnum<{
+        draft: "draft";
+        library: "library";
+    }>>;
+}, z.core.$strip>;
+/**
+ * One row in the LED map picker / library listing.
+ *
+ * Carries `panelCount` and DELIBERATELY NOT the `panels` array: a picker listing N
+ * maps must not ship N full panel arrays (up to 200 panels each) just to render "4
+ * panels" and a thumbnail. Fetch `ledMaps.getById` when the geometry is actually
+ * needed.
+ *
+ * DELIBERATELY NO `superRefine`, unlike `ledMapSchema`. That schema enforces a
+ * panels⇄bounds biconditional (empty maps have null bounds; non-empty maps have
+ * bounds that match), and it CANNOT be checked here — `panelCount` is a count, and
+ * bounds cannot be recomputed from a count. A summary with `panelCount: 4` and
+ * `bounds: null` therefore parses cleanly. Do not "restore" the refinement.
+ *
+ * `name`, `libraryStatus` and `forkedFromLedMapId` all `.default()`, so — per the
+ * house rule spelled out on `ledMapSchema.id` — zcl-api's `z.infer` turns them into
+ * REQUIRED output fields. The mapper that will break at compile time until it emits
+ * them is the new summary mapper feeding the list route in
+ * services/postgres-services.ts (alongside `mapLedMap`), which must also compute
+ * `panelCount` and join `usage`. That compile error is the desired failure mode.
+ */
+export declare const ledMapSummarySchema: z.ZodObject<{
+    id: z.ZodString;
+    projectId: z.ZodString;
+    name: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    libraryStatus: z.ZodDefault<z.ZodEnum<{
+        draft: "draft";
+        library: "library";
+    }>>;
+    forkedFromLedMapId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    version: z.ZodNumber;
+    panelCount: z.ZodNumber;
+    bounds: z.ZodNullable<z.ZodObject<{
+        minX: z.ZodNumber;
+        minY: z.ZodNumber;
+        maxX: z.ZodNumber;
+        maxY: z.ZodNumber;
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+        aspectRatio: z.ZodNumber;
+    }, z.core.$strip>>;
+    usage: z.ZodArray<z.ZodObject<{
+        runId: z.ZodString;
+        name: z.ZodString;
+    }, z.core.$strip>>;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+}, z.core.$strip>;
+/**
+ * LED maps list query. Keyset-paginated, mirroring `listProjectRunsQuerySchema`
+ * exactly (minus its `status` filter — the picker's predicate is server-side and
+ * not client-selectable).
+ *
+ * The response is `ledMapListResponseSchema` =
+ *   { data: LedMapSummary[]; pagination: { nextCursor: string | null } }.
+ */
+export declare const listLedMapsQuerySchema: z.ZodObject<{
+    cursor: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+}, z.core.$strip>;
+/**
+ * Create a map a creation owns outright — the picker's "Start a new map".
+ *
+ * THIS PATH DOES NOT EXIST TODAY, and neither of the two adjacent ones can stand in:
+ *
+ *   - `createProjectRunRequestSchema.copyFromLedMapId` is `.optional()` where ABSENT
+ *     means "copy the project's oldest map" (zcl-api
+ *     services/project-run-service.ts:249-271). It therefore cannot distinguish
+ *     "default" from "explicitly none".
+ *   - `getLedMap`'s lazy insert fires only when a project has ZERO maps, so it can
+ *     never mint a second one.
+ *
+ * Phase B establishes that no creation may carry `ledMapId = null`: null is not "no
+ * map", it is "share the project's oldest map by accident" — the silent-sharing
+ * defect where two creations edit one row through one alias and one silently reverts
+ * the other's work. An explicit create path is what lets a creation own an EMPTY map
+ * instead of falling back to that alias.
+ *
+ * Omit `copyFromLedMapId` for an empty map; supply it to seed from an existing map in
+ * the same project. Response reuses `ledMapResponseSchema` — a created map is just a
+ * map, so there is no new envelope.
+ */
+export declare const createLedMapRequestSchema: z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    copyFromLedMapId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const ledMapListResponseSchema: z.ZodObject<{
+    data: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        projectId: z.ZodString;
+        name: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        libraryStatus: z.ZodDefault<z.ZodEnum<{
+            draft: "draft";
+            library: "library";
+        }>>;
+        forkedFromLedMapId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        version: z.ZodNumber;
+        panelCount: z.ZodNumber;
+        bounds: z.ZodNullable<z.ZodObject<{
+            minX: z.ZodNumber;
+            minY: z.ZodNumber;
+            maxX: z.ZodNumber;
+            maxY: z.ZodNumber;
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+            aspectRatio: z.ZodNumber;
+        }, z.core.$strip>>;
+        usage: z.ZodArray<z.ZodObject<{
+            runId: z.ZodString;
+            name: z.ZodString;
+        }, z.core.$strip>>;
+        createdAt: z.ZodString;
+        updatedAt: z.ZodString;
+    }, z.core.$strip>>;
+    pagination: z.ZodObject<{
+        nextCursor: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export declare const ledMapUsageResponseSchema: z.ZodObject<{
+    data: z.ZodArray<z.ZodObject<{
+        runId: z.ZodString;
+        name: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/**
+ * The by-id map PATCH response — and THE FORK SIGNAL.
+ *
+ * `data` is the map that now holds the geometry, which may be a NEW ROW: editing a
+ * map that two or more creations share branches it server-side, inside the PATCH
+ * (lazily, on the first geometry-significant change — never on a button click, so a
+ * user who opens a shared map and changes nothing keeps free centre-panel reuse).
+ *
+ * `branchedFrom` is the id the edit STARTED from when the server branched, and null
+ * when it edited in place. The client detects a branch with `branchedFrom !== null`
+ * and MUST repoint its creation at `data.id` — the id it sent is no longer the map it
+ * is editing.
+ *
+ * DO NOT signal a branch through the 409 instead. That 409's ambiguity across
+ * *wrong version / wrong project / no such map* is deliberate anti-tenant-probing
+ * (zcl-api services/postgres-services.ts:1662-1664) — it exists so a caller cannot
+ * learn whether a map id exists in someone else's tenant. A fork is a SUCCESS, and
+ * needs a success-shaped response, not a richer error.
+ *
+ * `branchedFrom` `.default()`s, so per the house rule on `ledMapSchema.id` it becomes
+ * a REQUIRED output field under `z.infer`: zcl-api's `updateLedMapById` route handler
+ * (led-map.routes.ts, currently parsing its outbound body through
+ * `ledMapResponseSchema`) breaks at compile time until it switches to this schema and
+ * emits the field. That is the desired failure mode.
+ */
+export declare const ledMapUpdateResponseSchema: z.ZodObject<{
+    data: z.ZodObject<{
+        id: z.ZodString;
+        projectId: z.ZodString;
+        name: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        libraryStatus: z.ZodDefault<z.ZodEnum<{
+            draft: "draft";
+            library: "library";
+        }>>;
+        forkedFromLedMapId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        version: z.ZodNumber;
+        panels: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+            color: z.ZodOptional<z.ZodString>;
+            showLabel: z.ZodOptional<z.ZodBoolean>;
+            mirrorOf: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNull]>>;
+        }, z.core.$strip>>;
+        bounds: z.ZodNullable<z.ZodObject<{
+            minX: z.ZodNumber;
+            minY: z.ZodNumber;
+            maxX: z.ZodNumber;
+            maxY: z.ZodNumber;
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+            aspectRatio: z.ZodNumber;
+        }, z.core.$strip>>;
+        createdAt: z.ZodString;
+        updatedAt: z.ZodString;
+    }, z.core.$strip>;
+    branchedFrom: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
 export declare const projectSchema: z.ZodObject<{
     id: z.ZodString;
     workspaceId: z.ZodString;
@@ -292,9 +539,22 @@ export type CreateProjectRequest = z.input<typeof createProjectRequestSchema>;
 export type UpdateProjectRequest = z.infer<typeof updateProjectRequestSchema>;
 export type LedBounds = z.infer<typeof ledBoundsSchema>;
 export type LedMap = z.infer<typeof ledMapSchema>;
+export type LedMapLibraryStatus = z.infer<typeof ledMapLibraryStatusSchema>;
 export type LedMapResponse = z.infer<typeof ledMapResponseSchema>;
 export type LedPanel = z.infer<typeof ledPanelSchema>;
+export type LedMapSummary = z.infer<typeof ledMapSummarySchema>;
+export type LedMapUsage = z.infer<typeof ledMapUsageSchema>;
+export type LedMapListResponse = z.infer<typeof ledMapListResponseSchema>;
+export type LedMapUsageResponse = z.infer<typeof ledMapUsageResponseSchema>;
+export type LedMapUpdateResponse = z.infer<typeof ledMapUpdateResponseSchema>;
+export type ListLedMapsQuery = z.infer<typeof listLedMapsQuerySchema>;
+/**
+ * `z.infer`, not `z.input` (contrast `CreateProjectRequest`): neither field here
+ * `.default()`s, so input and output coincide and there is nothing to widen.
+ */
+export type CreateLedMapRequest = z.infer<typeof createLedMapRequestSchema>;
 export type UpdateLedMapRequest = z.infer<typeof updateLedMapRequestSchema>;
+export type UpdateLedMapMetadataRequest = z.infer<typeof updateLedMapMetadataRequestSchema>;
 export type Project = z.infer<typeof projectSchema>;
 export type ProjectStatus = z.infer<typeof projectStatusSchema>;
 export type ProjectVisibility = z.infer<typeof projectVisibilitySchema>;

package/dist/projects.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"projects.d.ts","sourceRoot":"","sources":["../src/projects.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"projects.d.ts","sourceRoot":"","sources":["../src/projects.ts"],"names":[],"mappings":"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"}

package/dist/projects.js

@@ -77,6 +77,16 @@ function boundsMatchPanels(bounds, panels) {
         bounds.height === height &&
         Math.abs(bounds.aspectRatio - aspectRatio) < 1e-9);
 }
+/**
+ * Library membership state of a map. 'draft' = private to one creation;
+ * 'library' = saved and reusable.
+ *
+ * NOTE for Phase B: this is NOT the picker's predicate. The picker filters on
+ * `jsonb_array_length(panels_json) > 0` and nothing else — `scripts/backfill-runs.ts`
+ * promoted exactly the non-empty set to 'library', but every map created since is
+ * 'draft' with panels, so filtering on this enum would hide all of them.
+ */
+export const ledMapLibraryStatusSchema = z.enum(['draft', 'library']);
 export const ledMapSchema = z
     .object({
     /**
@@ -118,7 +128,7 @@ export const ledMapSchema = z
     /** Library display name. Null while the map is an unnamed working copy. */
     name: z.string().trim().min(1).max(120).nullable().default(null),
     /** 'draft' = private to one creation; 'library' = saved and reusable. */
-    libraryStatus: z.enum(['draft', 'library']).default('draft'),
+    libraryStatus: ledMapLibraryStatusSchema.default('draft'),
     /** The map this one was branched from, or null. */
     forkedFromLedMapId: idSchema.nullable().default(null),
     version: z.number().int().nonnegative(),
@@ -155,6 +165,165 @@ export const updateLedMapRequestSchema = z.object({
     panels: ledPanelsSchema
 });
 export const ledMapResponseSchema = apiSuccessSchema(ledMapSchema);
+/**
+ * A creation that references a map. Powers two Phase B surfaces: the
+ * "Shared · used in Day 1 Opener, Day 2 Keynote" badge on a locked editor, and the
+ * named refusal when a delete is blocked (`project_runs.led_map_id` is
+ * ON DELETE restrict, so the database blocks it either way — this is what turns a
+ * bare FK error into a sentence).
+ *
+ * Deliberately its own aggregate rather than something derived client-side from
+ * `runs.list`: that listing is keyset-paginated with a default limit, so a map used
+ * by a creation on page 2 would be reported as unshared.
+ */
+export const ledMapUsageSchema = z.object({
+    runId: idSchema,
+    name: z.string().min(1)
+});
+/**
+ * Rename a map (or move it between library states) WITHOUT touching its geometry.
+ * `updateLedMapRequestSchema` replaces the whole panel array, so before this there
+ * was no way to rename a map at all.
+ *
+ * DELIBERATELY NO `expectedVersion`, AND THE SERVER MUST NOT BUMP `version` ON IT.
+ * This is not stylistic. `version` is not only the geometry concurrency token — it is
+ * half the free centre-panel reuse gate (zcl-api
+ * services/generation-service.ts:726-739, `if (master.ledMapVersion !== map.version)
+ * { return false }`). Bumping it on a rename would make RENAMING A MAP SILENTLY COST
+ * THE USER CREDITS on their next Generate All. zcl-web-next's editor already names
+ * this exact hazard for panel labels (rebuild-panel-set.ts:568-571: gating on the
+ * version counter "would permanently unrestore a user's wall because they renamed
+ * 'LED 3'").
+ *
+ * So a metadata PATCH stays outside the geometry concurrency protocol entirely: no
+ * CAS token in, no counter bump out. Concurrent renames are last-write-wins, which is
+ * the correct semantics for a scalar. Do not add `expectedVersion` here "for
+ * consistency" with the geometry PATCH — the asymmetry is the point.
+ *
+ * `name: null` clears the name (back to an unnamed working copy). `name: ''` and
+ * whitespace-only are rejected. Unknown keys — notably a smuggled `panels` or
+ * `expectedVersion` — are STRIPPED by zod rather than rejected, so they never reach
+ * the server; a patch whose only keys are unknown fails the refine below.
+ *
+ * Response reuses `ledMapResponseSchema` — a renamed map is just a map.
+ */
+export const updateLedMapMetadataRequestSchema = z
+    .object({
+    name: z.string().trim().min(1).max(120).nullable().optional(),
+    libraryStatus: ledMapLibraryStatusSchema.optional()
+})
+    .refine((input) => input.name !== undefined || input.libraryStatus !== undefined, 'At least one field is required');
+/**
+ * One row in the LED map picker / library listing.
+ *
+ * Carries `panelCount` and DELIBERATELY NOT the `panels` array: a picker listing N
+ * maps must not ship N full panel arrays (up to 200 panels each) just to render "4
+ * panels" and a thumbnail. Fetch `ledMaps.getById` when the geometry is actually
+ * needed.
+ *
+ * DELIBERATELY NO `superRefine`, unlike `ledMapSchema`. That schema enforces a
+ * panels⇄bounds biconditional (empty maps have null bounds; non-empty maps have
+ * bounds that match), and it CANNOT be checked here — `panelCount` is a count, and
+ * bounds cannot be recomputed from a count. A summary with `panelCount: 4` and
+ * `bounds: null` therefore parses cleanly. Do not "restore" the refinement.
+ *
+ * `name`, `libraryStatus` and `forkedFromLedMapId` all `.default()`, so — per the
+ * house rule spelled out on `ledMapSchema.id` — zcl-api's `z.infer` turns them into
+ * REQUIRED output fields. The mapper that will break at compile time until it emits
+ * them is the new summary mapper feeding the list route in
+ * services/postgres-services.ts (alongside `mapLedMap`), which must also compute
+ * `panelCount` and join `usage`. That compile error is the desired failure mode.
+ */
+export const ledMapSummarySchema = z.object({
+    id: idSchema,
+    projectId: idSchema,
+    /** Library display name. Null while the map is an unnamed working copy. */
+    name: z.string().trim().min(1).max(120).nullable().default(null),
+    libraryStatus: ledMapLibraryStatusSchema.default('draft'),
+    /** The map this one was branched from, or null. */
+    forkedFromLedMapId: idSchema.nullable().default(null),
+    version: z.number().int().nonnegative(),
+    /** Panel count only — see the note above on why `panels` is absent. */
+    panelCount: z.number().int().nonnegative(),
+    bounds: ledBoundsSchema.nullable(),
+    /**
+     * The creations using this map. `[]` for an orphan map — orphans stay listed,
+     * because their creation may be archived and archived creations can be restored.
+     */
+    usage: z.array(ledMapUsageSchema),
+    createdAt: isoDateSchema,
+    updatedAt: isoDateSchema
+});
+/**
+ * LED maps list query. Keyset-paginated, mirroring `listProjectRunsQuerySchema`
+ * exactly (minus its `status` filter — the picker's predicate is server-side and
+ * not client-selectable).
+ *
+ * The response is `ledMapListResponseSchema` =
+ *   { data: LedMapSummary[]; pagination: { nextCursor: string | null } }.
+ */
+export const listLedMapsQuerySchema = z.object({
+    cursor: z.string().min(1).optional(),
+    limit: z.coerce.number().int().min(1).max(100).optional()
+});
+/**
+ * Create a map a creation owns outright — the picker's "Start a new map".
+ *
+ * THIS PATH DOES NOT EXIST TODAY, and neither of the two adjacent ones can stand in:
+ *
+ *   - `createProjectRunRequestSchema.copyFromLedMapId` is `.optional()` where ABSENT
+ *     means "copy the project's oldest map" (zcl-api
+ *     services/project-run-service.ts:249-271). It therefore cannot distinguish
+ *     "default" from "explicitly none".
+ *   - `getLedMap`'s lazy insert fires only when a project has ZERO maps, so it can
+ *     never mint a second one.
+ *
+ * Phase B establishes that no creation may carry `ledMapId = null`: null is not "no
+ * map", it is "share the project's oldest map by accident" — the silent-sharing
+ * defect where two creations edit one row through one alias and one silently reverts
+ * the other's work. An explicit create path is what lets a creation own an EMPTY map
+ * instead of falling back to that alias.
+ *
+ * Omit `copyFromLedMapId` for an empty map; supply it to seed from an existing map in
+ * the same project. Response reuses `ledMapResponseSchema` — a created map is just a
+ * map, so there is no new envelope.
+ */
+export const createLedMapRequestSchema = z.object({
+    name: z.string().trim().min(1).max(120).optional(),
+    /** Seed the new map by copying an existing one in the same project. Omit for an empty map. */
+    copyFromLedMapId: idSchema.optional()
+});
+export const ledMapListResponseSchema = listResponseSchema(ledMapSummarySchema);
+export const ledMapUsageResponseSchema = apiSuccessSchema(z.array(ledMapUsageSchema));
+/**
+ * The by-id map PATCH response — and THE FORK SIGNAL.
+ *
+ * `data` is the map that now holds the geometry, which may be a NEW ROW: editing a
+ * map that two or more creations share branches it server-side, inside the PATCH
+ * (lazily, on the first geometry-significant change — never on a button click, so a
+ * user who opens a shared map and changes nothing keeps free centre-panel reuse).
+ *
+ * `branchedFrom` is the id the edit STARTED from when the server branched, and null
+ * when it edited in place. The client detects a branch with `branchedFrom !== null`
+ * and MUST repoint its creation at `data.id` — the id it sent is no longer the map it
+ * is editing.
+ *
+ * DO NOT signal a branch through the 409 instead. That 409's ambiguity across
+ * *wrong version / wrong project / no such map* is deliberate anti-tenant-probing
+ * (zcl-api services/postgres-services.ts:1662-1664) — it exists so a caller cannot
+ * learn whether a map id exists in someone else's tenant. A fork is a SUCCESS, and
+ * needs a success-shaped response, not a richer error.
+ *
+ * `branchedFrom` `.default()`s, so per the house rule on `ledMapSchema.id` it becomes
+ * a REQUIRED output field under `z.infer`: zcl-api's `updateLedMapById` route handler
+ * (led-map.routes.ts, currently parsing its outbound body through
+ * `ledMapResponseSchema`) breaks at compile time until it switches to this schema and
+ * emits the field. That is the desired failure mode.
+ */
+export const ledMapUpdateResponseSchema = z.object({
+    data: ledMapSchema,
+    branchedFrom: idSchema.nullable().default(null)
+});
 export const projectSchema = z.object({
     id: idSchema,
     workspaceId: idSchema,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@anuragpal02/zcl-contracts",
-  "version": "0.28.0",
+  "version": "0.30.0",
   "private": false,
   "type": "module",
   "main": "./dist/index.js",