@spacefast/common 0.0.11 → 0.0.13

package/dist/contracts/builds.d.ts

@@ -181,8 +181,8 @@ export declare const BuildSchema: z.ZodObject<{
         code: z.ZodString;
         severity: z.ZodEnum<{
             info: "info";
-            warning: "warning";
             error: "error";
+            warning: "warning";
         }>;
         message: z.ZodString;
         path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -232,8 +232,8 @@ export declare const buildCreateRequestSchema: z.ZodObject<{
         code: z.ZodString;
         severity: z.ZodEnum<{
             info: "info";
-            warning: "warning";
             error: "error";
+            warning: "warning";
         }>;
         message: z.ZodString;
         path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -264,8 +264,8 @@ export declare const buildSourceArchiveUploadSchema: z.ZodObject<{
     targets: z.ZodDefault<z.ZodArray<z.ZodObject<{
         path: z.ZodString;
         method: z.ZodEnum<{
-            PUT: "PUT";
             POST: "POST";
+            PUT: "PUT";
         }>;
         url: z.ZodUnion<[z.ZodString, z.ZodString]>;
         headers: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
@@ -295,8 +295,8 @@ export declare const buildSourceArchiveUploadSchema: z.ZodObject<{
             code: z.ZodString;
             severity: z.ZodEnum<{
                 info: "info";
-                warning: "warning";
                 error: "error";
+                warning: "warning";
             }>;
             message: z.ZodString;
             path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -359,8 +359,8 @@ export declare const buildCreateResponseSchema: z.ZodObject<{
                 code: z.ZodString;
                 severity: z.ZodEnum<{
                     info: "info";
-                    warning: "warning";
                     error: "error";
+                    warning: "warning";
                 }>;
                 message: z.ZodString;
                 path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -393,8 +393,8 @@ export declare const buildCreateResponseSchema: z.ZodObject<{
             targets: z.ZodDefault<z.ZodArray<z.ZodObject<{
                 path: z.ZodString;
                 method: z.ZodEnum<{
-                    PUT: "PUT";
                     POST: "POST";
+                    PUT: "PUT";
                 }>;
                 url: z.ZodUnion<[z.ZodString, z.ZodString]>;
                 headers: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
@@ -424,8 +424,8 @@ export declare const buildCreateResponseSchema: z.ZodObject<{
                     code: z.ZodString;
                     severity: z.ZodEnum<{
                         info: "info";
-                        warning: "warning";
                         error: "error";
+                        warning: "warning";
                     }>;
                     message: z.ZodString;
                     path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -493,8 +493,8 @@ export declare const buildListResponseSchema: z.ZodObject<{
             code: z.ZodString;
             severity: z.ZodEnum<{
                 info: "info";
-                warning: "warning";
                 error: "error";
+                warning: "warning";
             }>;
             message: z.ZodString;
             path: z.ZodOptional<z.ZodNullable<z.ZodString>>;

package/dist/contracts/builds.js

@@ -40,6 +40,32 @@ export const BuildTargetSchema = z
     preview: z.boolean().default(false).describe("Whether the build targets preview behavior."),
 })
     .describe("Where a successful build should publish or preview.");
+// Shared by InternalBuildSourceSchema and InternalBuildInputSchema: both carry
+// this exact archive-source member in their `kind` discriminated union.
+const internalArchiveBuildSourceSchema = z.object({
+    kind: z.literal("archive").describe("Build from an uploaded source archive."),
+    uploadId: z.string().optional().describe("Upload session (`upl_`) carrying the archive."),
+    sourceMetadata: z
+        .record(z.string(), z.unknown())
+        .optional()
+        .describe("Internal source provenance copied to the produced Version."),
+    objectKey: z.string().optional().describe("Internal staged archive object key."),
+    uploadedAt: z.string().datetime().optional().describe("When the archive finished staging."),
+    recoveredAt: z
+        .string()
+        .datetime()
+        .optional()
+        .describe("When an interrupted archive upload was recovered."),
+    sha256: z.string().optional().describe("SHA-256 checksum of the staged source archive."),
+    compressedBytes: z.number().int().nonnegative().optional(),
+    expandedBytes: z.number().int().nonnegative().optional(),
+    fileCount: z.number().int().nonnegative().optional(),
+    expiresAt: z
+        .string()
+        .datetime()
+        .optional()
+        .describe("Server-enforced upload expiry while the archive is waiting for upload."),
+});
 const InternalBuildSourceSchema = z
     .discriminatedUnion("kind", [
     z.object({
@@ -48,58 +74,12 @@ const InternalBuildSourceSchema = z
         ref: z.string().describe("Branch, tag, or ref to build."),
         commit: z.string().optional().describe("Exact commit built, once resolved."),
     }),
-    z.object({
-        kind: z.literal("archive").describe("Build from an uploaded source archive."),
-        uploadId: z.string().optional().describe("Upload session (`upl_`) carrying the archive."),
-        sourceMetadata: z
-            .record(z.string(), z.unknown())
-            .optional()
-            .describe("Internal source provenance copied to the produced Version."),
-        objectKey: z.string().optional().describe("Internal staged archive object key."),
-        uploadedAt: z.string().datetime().optional().describe("When the archive finished staging."),
-        recoveredAt: z
-            .string()
-            .datetime()
-            .optional()
-            .describe("When an interrupted archive upload was recovered."),
-        sha256: z.string().optional().describe("SHA-256 checksum of the staged source archive."),
-        compressedBytes: z.number().int().nonnegative().optional(),
-        expandedBytes: z.number().int().nonnegative().optional(),
-        fileCount: z.number().int().nonnegative().optional(),
-        expiresAt: z
-            .string()
-            .datetime()
-            .optional()
-            .describe("Server-enforced upload expiry while the archive is waiting for upload."),
-    }),
+    internalArchiveBuildSourceSchema,
 ])
     .describe("Legacy internal build source shape retained while build routes migrate to input.");
 const InternalBuildInputSchema = z
     .discriminatedUnion("kind", [
-    z.object({
-        kind: z.literal("archive").describe("Build from an uploaded source archive."),
-        uploadId: z.string().optional().describe("Upload session (`upl_`) carrying the archive."),
-        sourceMetadata: z
-            .record(z.string(), z.unknown())
-            .optional()
-            .describe("Internal source provenance copied to the produced Version."),
-        objectKey: z.string().optional().describe("Internal staged archive object key."),
-        uploadedAt: z.string().datetime().optional().describe("When the archive finished staging."),
-        recoveredAt: z
-            .string()
-            .datetime()
-            .optional()
-            .describe("When an interrupted archive upload was recovered."),
-        sha256: z.string().optional().describe("SHA-256 checksum of the staged source archive."),
-        compressedBytes: z.number().int().nonnegative().optional(),
-        expandedBytes: z.number().int().nonnegative().optional(),
-        fileCount: z.number().int().nonnegative().optional(),
-        expiresAt: z
-            .string()
-            .datetime()
-            .optional()
-            .describe("Server-enforced upload expiry while the archive is waiting for upload."),
-    }),
+    internalArchiveBuildSourceSchema,
     z.object({
         kind: z.literal("connected_repository").describe("Build from a repository connection."),
         repositoryConnectionId: z.string().describe("Repository connection (`rpc_`) to build from."),

package/dist/contracts/channels.js

@@ -4,8 +4,7 @@ import { z } from "zod";
 // activity log. No writes, no new storage — promotion stays owned by the
 // publish/version lifecycle. Additive only.
 // One row of the channel list: where each named channel points right now.
-// `currentVersionId` is the live pointer (`channels.versionId`); weighted
-// pointers are not surfaced here yet (live-only at launch).
+// `currentVersionId` is the channel's version pointer (`channels.versionId`).
 export const channelListItemSchema = z.object({
     name: z.string().describe("Channel name; `live` is the default channel."),
     currentVersionId: z

package/dist/contracts/comments.d.ts

@@ -1,123 +1,120 @@
 import { z } from "zod";
-export declare const collaborationModeSchema: z.ZodEnum<{
-    review: "review";
-}>;
+import type { GrantCapability } from "./grants.js";
 export declare const commentThreadStatusSchema: z.ZodEnum<{
     open: "open";
     archived: "archived";
 }>;
-export declare const collaborationReviewerLevelSchema: z.ZodEnum<{
-    viewer: "viewer";
-    commenter: "commenter";
-    editor: "editor";
-}>;
-export declare const collaborationInvitedReviewerSchema: z.ZodObject<{
-    email: z.ZodString;
-    level: z.ZodEnum<{
+export declare const COMMENT_SEARCH_QUERY_MAX_LENGTH = 160;
+export declare function normalizeCommentSearchQuery(value: string | undefined): string | undefined;
+export declare const COMMENT_PAGE_PATH_MAX_LENGTH = 2048;
+export declare const commentCapabilitiesSchema: z.ZodArray<z.ZodEnum<{
+    "page.view": "page.view";
+    "comments.read": "comments.read";
+    "comments.write": "comments.write";
+}>>;
+export type CommentCapability = Extract<GrantCapability, "page.view" | "comments.read" | "comments.write">;
+export type CommentCapabilities = CommentCapability[];
+export declare const collaborationGuestProjectionSchema: z.ZodObject<{
+    anonymousId: z.ZodString;
+    name: z.ZodString;
+    namedByUser: z.ZodBoolean;
+    grantId: z.ZodString;
+    admittedBy: z.ZodUnion<readonly [z.ZodLiteral<"anyone">, z.ZodTemplateLiteral<`link:${string}`>, z.ZodTemplateLiteral<`password:${string}`>]>;
+    emailVerified: z.ZodDefault<z.ZodBoolean>;
+    capabilities: z.ZodArray<z.ZodEnum<{
+        "page.view": "page.view";
+        "comments.read": "comments.read";
+        "comments.write": "comments.write";
+    }>>;
+}, z.core.$strip>;
+export type CollaborationGuestProjection = z.infer<typeof collaborationGuestProjectionSchema>;
+export declare const collaborationTicketClaimsSchema: z.ZodObject<{
+    sub: z.ZodString;
+    email: z.ZodOptional<z.ZodString>;
+    role: z.ZodEnum<{
         viewer: "viewer";
         commenter: "commenter";
         editor: "editor";
+        manager: "manager";
+    }>;
+    actorKind: z.ZodEnum<{
+        user: "user";
+        guest: "guest";
     }>;
+    capabilities: z.ZodArray<z.ZodEnum<{
+        "page.view": "page.view";
+        "comments.read": "comments.read";
+        "comments.write": "comments.write";
+    }>>;
+    anonymousId: z.ZodOptional<z.ZodString>;
+    namedByUser: z.ZodOptional<z.ZodBoolean>;
+    admittedBy: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"anyone">, z.ZodTemplateLiteral<`link:${string}`>, z.ZodTemplateLiteral<`password:${string}`>]>>;
+    emailVerified: z.ZodOptional<z.ZodBoolean>;
+    room: z.ZodString;
+    scope: z.ZodString;
+    surface: z.ZodEnum<{
+        preview: "preview";
+        published: "published";
+    }>;
+    nonce: z.ZodString;
+    iat: z.ZodNumber;
+    nbf: z.ZodNumber;
+    exp: z.ZodNumber;
+    iss: z.ZodLiteral<"spacefast-api">;
+    aud: z.ZodString;
 }, z.core.$strip>;
 export declare const collaborationSettingsSchema: z.ZodObject<{
-    anonymousReviewers: z.ZodOptional<z.ZodBoolean>;
-    publishedAnonymousCommenters: z.ZodOptional<z.ZodBoolean>;
-    invitedReviewers: z.ZodOptional<z.ZodArray<z.ZodObject<{
-        email: z.ZodString;
-        level: z.ZodEnum<{
-            viewer: "viewer";
-            commenter: "commenter";
-            editor: "editor";
-        }>;
-    }, z.core.$strip>>>;
+    spamFilterEnabled: z.ZodOptional<z.ZodBoolean>;
     publishedComments: z.ZodOptional<z.ZodBoolean>;
-    allowedOrigins: z.ZodOptional<z.ZodArray<z.ZodString>>;
     notificationPreferences: z.ZodOptional<z.ZodObject<{
         newThreads: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
         newReplies: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
         statusChanges: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
     }, z.core.$strip>>;
-}, z.core.$catchall<z.ZodUnknown>>;
+}, z.core.$strict>;
 export declare const collaborationSchema: z.ZodObject<{
     spaceId: z.ZodString;
     enabled: z.ZodBoolean;
-    mode: z.ZodEnum<{
-        review: "review";
-    }>;
     castResourceId: z.ZodNullable<z.ZodString>;
     castResourceKey: z.ZodNullable<z.ZodString>;
     settings: z.ZodObject<{
-        anonymousReviewers: z.ZodOptional<z.ZodBoolean>;
-        publishedAnonymousCommenters: z.ZodOptional<z.ZodBoolean>;
-        invitedReviewers: z.ZodOptional<z.ZodArray<z.ZodObject<{
-            email: z.ZodString;
-            level: z.ZodEnum<{
-                viewer: "viewer";
-                commenter: "commenter";
-                editor: "editor";
-            }>;
-        }, z.core.$strip>>>;
+        spamFilterEnabled: z.ZodOptional<z.ZodBoolean>;
         publishedComments: z.ZodOptional<z.ZodBoolean>;
-        allowedOrigins: z.ZodOptional<z.ZodArray<z.ZodString>>;
         notificationPreferences: z.ZodOptional<z.ZodObject<{
             newThreads: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
             newReplies: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
             statusChanges: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
         }, z.core.$strip>>;
-    }, z.core.$catchall<z.ZodUnknown>>;
+    }, z.core.$strict>;
     createdAt: z.ZodNullable<z.ZodString>;
     updatedAt: z.ZodNullable<z.ZodString>;
 }, z.core.$strip>;
 export declare const collaborationUpdateSchema: z.ZodObject<{
     enabled: z.ZodBoolean;
-    mode: z.ZodOptional<z.ZodEnum<{
-        review: "review";
-    }>>;
     settings: z.ZodOptional<z.ZodObject<{
-        anonymousReviewers: z.ZodOptional<z.ZodBoolean>;
-        publishedAnonymousCommenters: z.ZodOptional<z.ZodBoolean>;
-        invitedReviewers: z.ZodOptional<z.ZodArray<z.ZodObject<{
-            email: z.ZodString;
-            level: z.ZodEnum<{
-                viewer: "viewer";
-                commenter: "commenter";
-                editor: "editor";
-            }>;
-        }, z.core.$strip>>>;
+        spamFilterEnabled: z.ZodOptional<z.ZodBoolean>;
         publishedComments: z.ZodOptional<z.ZodBoolean>;
-        allowedOrigins: z.ZodOptional<z.ZodArray<z.ZodString>>;
         notificationPreferences: z.ZodOptional<z.ZodObject<{
             newThreads: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
             newReplies: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
             statusChanges: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
         }, z.core.$strip>>;
-    }, z.core.$catchall<z.ZodUnknown>>>;
+    }, z.core.$strict>>;
 }, z.core.$strip>;
-export declare const collaborationTokenRequestSchema: z.ZodObject<{
-    versionId: z.ZodOptional<z.ZodString>;
+export declare const commentsTicketRequestSchema: z.ZodObject<{
+    spaceId: z.ZodString;
     pagePath: z.ZodDefault<z.ZodString>;
-    displayName: z.ZodOptional<z.ZodString>;
+    origin: z.ZodString;
+    versionId: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
-export declare const collaborationTokenResponseSchema: z.ZodObject<{
+export declare const commentsTicketResponseSchema: z.ZodObject<{
     token: z.ZodString;
     expiresAt: z.ZodString;
     cast: z.ZodObject<{
         resource: z.ZodString;
-        room: z.ZodNullable<z.ZodString>;
+        room: z.ZodString;
     }, z.core.$strip>;
 }, z.core.$strip>;
-export declare const collaborationHandoffRequestSchema: z.ZodObject<{
-    versionId: z.ZodString;
-    pagePath: z.ZodDefault<z.ZodString>;
-}, z.core.$strip>;
-export declare const collaborationHandoffResponseSchema: z.ZodObject<{
-    handoffToken: z.ZodString;
-    expiresAt: z.ZodString;
-    url: z.ZodNullable<z.ZodString>;
-}, z.core.$strip>;
-export declare const collaborationHandoffExchangeSchema: z.ZodObject<{
-    handoffToken: z.ZodString;
-}, z.core.$strip>;
 export declare const realtimeTokenRequestSchema: z.ZodObject<{
     versionId: z.ZodOptional<z.ZodString>;
     scope: z.ZodDefault<z.ZodEnum<{
@@ -131,7 +128,6 @@ export declare const realtimeTokenResponseSchema: z.ZodObject<{
     cast: z.ZodObject<{
         resource: z.ZodString;
         room: z.ZodString;
-        loaderUrl: z.ZodString;
     }, z.core.$strip>;
 }, z.core.$strip>;
 export declare const noticePublishSchema: z.ZodObject<{
@@ -142,8 +138,8 @@ export declare const noticePublishSchema: z.ZodObject<{
     level: z.ZodDefault<z.ZodEnum<{
         info: "info";
         success: "success";
-        warning: "warning";
         error: "error";
+        warning: "warning";
     }>>;
     payload: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     durable: z.ZodDefault<z.ZodBoolean>;
@@ -161,30 +157,20 @@ export declare const collabOverlayConfigQuerySchema: z.ZodObject<{
 }, z.core.$strip>;
 export declare const collabOverlayConfigSchema: z.ZodObject<{
     enabled: z.ZodBoolean;
-    anonymous_commenters: z.ZodBoolean;
-    resource_key: z.ZodNullable<z.ZodString>;
-    room_key: z.ZodNullable<z.ZodString>;
-    version: z.ZodObject<{
-        id: z.ZodNullable<z.ZodString>;
-        current: z.ZodNullable<z.ZodString>;
-    }, z.core.$strip>;
-    ws_url: z.ZodNullable<z.ZodString>;
-    endpoints: z.ZodObject<{
-        token: z.ZodString;
-        handoff_exchange: z.ZodString;
-        auth_bridge: z.ZodString;
-        screenshots: z.ZodString;
-    }, z.core.$strip>;
-    features: z.ZodObject<{
-        drawing: z.ZodBoolean;
-        capture: z.ZodBoolean;
-        notices: z.ZodBoolean;
-    }, z.core.$strip>;
+    surface_url: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export declare const COLLAB_VERSION_URLS_MAX_IDS = 50;
+export declare const collabVersionUrlSchema: z.ZodObject<{
+    id: z.ZodString;
+    url: z.ZodString;
+    number: z.ZodNullable<z.ZodNumber>;
+    createdAt: z.ZodNullable<z.ZodString>;
 }, z.core.$strip>;
 export declare const commentAuthorSchema: z.ZodObject<{
     kind: z.ZodNullable<z.ZodString>;
     id: z.ZodNullable<z.ZodString>;
     name: z.ZodNullable<z.ZodString>;
+    color: z.ZodNullable<z.ZodString>;
 }, z.core.$strip>;
 export declare const commentTargetSchema: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 export declare const commentThreadSchema: z.ZodObject<{
@@ -199,6 +185,11 @@ export declare const commentThreadSchema: z.ZodObject<{
         open: "open";
         archived: "archived";
     }>;
+    moderationState: z.ZodEnum<{
+        spam: "spam";
+        clear: "clear";
+    }>;
+    heldCommentIds: z.ZodArray<z.ZodString>;
     unread: z.ZodBoolean;
     unreadCount: z.ZodNumber;
     body: z.ZodNullable<z.ZodString>;
@@ -206,6 +197,7 @@ export declare const commentThreadSchema: z.ZodObject<{
         kind: z.ZodNullable<z.ZodString>;
         id: z.ZodNullable<z.ZodString>;
         name: z.ZodNullable<z.ZodString>;
+        color: z.ZodNullable<z.ZodString>;
     }, z.core.$strip>>;
     target: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     comments: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
@@ -220,8 +212,19 @@ export declare const commentListQuerySchema: z.ZodObject<{
         open: "open";
         archived: "archived";
     }>>;
+    filter: z.ZodOptional<z.ZodEnum<{
+        open: "open";
+        spam: "spam";
+        archived: "archived";
+    }>>;
     pagePath: z.ZodOptional<z.ZodString>;
+    q: z.ZodOptional<z.ZodString>;
+    author: z.ZodOptional<z.ZodString>;
+    unread: z.ZodOptional<z.ZodCodec<z.ZodString, z.ZodBoolean>>;
 }, z.core.$strip>;
+export declare const commentSpamFeedbackSchema: z.ZodDefault<z.ZodObject<{
+    commentId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>>;
 export declare const commentCreateSchema: z.ZodObject<{
     pagePath: z.ZodDefault<z.ZodString>;
     body: z.ZodString;
@@ -232,8 +235,8 @@ export declare const commentScreenshotCreateSchema: z.ZodObject<{
     versionId: z.ZodString;
     pagePath: z.ZodDefault<z.ZodString>;
     contentType: z.ZodEnum<{
-        "image/png": "image/png";
         "image/jpeg": "image/jpeg";
+        "image/png": "image/png";
         "image/webp": "image/webp";
     }>;
     contentBase64: z.ZodString;
@@ -277,6 +280,11 @@ export declare const commentListResponseSchema: z.ZodObject<{
             open: "open";
             archived: "archived";
         }>;
+        moderationState: z.ZodEnum<{
+            spam: "spam";
+            clear: "clear";
+        }>;
+        heldCommentIds: z.ZodArray<z.ZodString>;
         unread: z.ZodBoolean;
         unreadCount: z.ZodNumber;
         body: z.ZodNullable<z.ZodString>;
@@ -284,6 +292,7 @@ export declare const commentListResponseSchema: z.ZodObject<{
             kind: z.ZodNullable<z.ZodString>;
             id: z.ZodNullable<z.ZodString>;
             name: z.ZodNullable<z.ZodString>;
+            color: z.ZodNullable<z.ZodString>;
         }, z.core.$strip>>;
         target: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
         comments: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
@@ -302,8 +311,8 @@ export declare const commentExportResponseSchema: z.ZodObject<{
     }>;
     content: z.ZodString;
 }, z.core.$strip>;
-export type CollaborationInvitedReviewer = z.infer<typeof collaborationInvitedReviewerSchema>;
 export type Collaboration = z.infer<typeof collaborationSchema>;
 export type CollaborationUpdate = z.infer<typeof collaborationUpdateSchema>;
 export type CollabOverlayConfig = z.infer<typeof collabOverlayConfigSchema>;
+export type CollabVersionUrl = z.infer<typeof collabVersionUrlSchema>;
 export type CommentThread = z.infer<typeof commentThreadSchema>;