@spacefast/common 0.0.24 → 0.2.1

package/dist/contracts/channels.d.ts

@@ -1,10 +1,33 @@
 import { z } from "zod";
+export declare const channelChangeKindSchema: z.ZodEnum<{
+    publish: "publish";
+    rollback: "rollback";
+    promote: "promote";
+}>;
+export type ChannelChangeKind = z.infer<typeof channelChangeKindSchema>;
+export declare const channelLastChangeSchema: z.ZodObject<{
+    kind: z.ZodNullable<z.ZodEnum<{
+        publish: "publish";
+        rollback: "rollback";
+        promote: "promote";
+    }>>;
+    at: z.ZodString;
+}, z.core.$strip>;
+export type ChannelLastChange = z.infer<typeof channelLastChangeSchema>;
 export declare const channelListItemSchema: z.ZodObject<{
     name: z.ZodString;
     currentVersionId: z.ZodNullable<z.ZodString>;
     currentDeploymentUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     previousVersionId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     updatedAt: z.ZodString;
+    lastChange: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        kind: z.ZodNullable<z.ZodEnum<{
+            publish: "publish";
+            rollback: "rollback";
+            promote: "promote";
+        }>>;
+        at: z.ZodString;
+    }, z.core.$strip>>>;
 }, z.core.$strip>;
 export type ChannelListItem = z.infer<typeof channelListItemSchema>;
 export declare const channelHistoryEntrySchema: z.ZodObject<{
@@ -15,10 +38,16 @@ export declare const channelHistoryEntrySchema: z.ZodObject<{
         system: "system";
         user: "user";
         api_key: "api_key";
+        partner_token: "partner_token";
         oauth_client: "oauth_client";
         anonymous_claim: "anonymous_claim";
     }>>>;
     actorId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    kind: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+        publish: "publish";
+        rollback: "rollback";
+        promote: "promote";
+    }>>>;
     at: z.ZodString;
 }, z.core.$strip>;
 export type ChannelHistoryEntry = z.infer<typeof channelHistoryEntrySchema>;
@@ -29,6 +58,14 @@ export declare const channelListResponseSchema: z.ZodObject<{
         currentDeploymentUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         previousVersionId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         updatedAt: z.ZodString;
+        lastChange: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            kind: z.ZodNullable<z.ZodEnum<{
+                publish: "publish";
+                rollback: "rollback";
+                promote: "promote";
+            }>>;
+            at: z.ZodString;
+        }, z.core.$strip>>>;
     }, z.core.$strip>>;
 }, z.core.$strip>;
 export declare const channelHistoryResponseSchema: z.ZodObject<{
@@ -40,10 +77,16 @@ export declare const channelHistoryResponseSchema: z.ZodObject<{
             system: "system";
             user: "user";
             api_key: "api_key";
+            partner_token: "partner_token";
             oauth_client: "oauth_client";
             anonymous_claim: "anonymous_claim";
         }>>>;
         actorId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        kind: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+            publish: "publish";
+            rollback: "rollback";
+            promote: "promote";
+        }>>>;
         at: z.ZodString;
     }, z.core.$strip>>;
 }, z.core.$strip>;

package/dist/contracts/channels.js

@@ -1,12 +1,21 @@
 import { z } from "zod";
-// Channels READ surface (internal-docs/platform.md "Channels"): a read-only
-// projection over the existing `channels` table and the `channel.promoted`
-// 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.
+// Channels READ surface (the platform spec "Channels"): a projection over the
+// `channels` table and the `channel.promoted` activity log. No writes:
+// promotion stays owned by the publish/version lifecycle.
+// How a channel pointer moved: a fresh publish going live, a forward promote,
+// or a rollback to an older version. Recorded on the `channel.promoted` event
+// at write time; null on events that predate kind recording.
+export const channelChangeKindSchema = z.enum(["publish", "promote", "rollback"]);
+// The channel's most recent pointer move, straight from the promotion log.
+export const channelLastChangeSchema = z.object({
+    kind: channelChangeKindSchema
+        .nullable()
+        .describe("How the pointer moved, or null when the log entry predates kind recording."),
+    at: z.string().datetime().describe("Instant the pointer moved, from the promotion log."),
+});
 // `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."),
+    name: z.string().describe("Channel name; `live` is the default."),
     currentVersionId: z
         .string()
         .nullable()
@@ -22,10 +31,13 @@ export const channelListItemSchema = z.object({
         .optional()
         .describe("Last version this channel served before the current pointer (rollback target)."),
     updatedAt: z.string().datetime().describe("Instant when this channel pointer last moved."),
+    lastChange: channelLastChangeSchema
+        .nullable()
+        .optional()
+        .describe("The most recent pointer move from the promotion log, or null when none exists."),
 });
 // One entry of a channel's promotion history (the deploy log): a single
-// `channel.promoted` event, newest first. This is the audit trail of every
-// pointer move on the channel.
+// `channel.promoted` event, newest first.
 export const channelHistoryEntrySchema = z.object({
     versionId: z.string().describe("Version the channel was promoted to."),
     channel: z.string().describe("Channel that moved."),
@@ -35,11 +47,15 @@ export const channelHistoryEntrySchema = z.object({
         .optional()
         .describe("Version the channel served immediately before this promotion."),
     actorType: z
-        .enum(["user", "api_key", "oauth_client", "anonymous_claim", "system"])
+        .enum(["user", "api_key", "partner_token", "oauth_client", "anonymous_claim", "system"])
         .nullable()
         .optional()
         .describe("Kind of actor that performed the promotion."),
     actorId: z.string().nullable().optional().describe("Identifier of the promoting actor."),
+    kind: channelChangeKindSchema
+        .nullable()
+        .optional()
+        .describe("How the pointer moved, or null when the entry predates kind recording."),
     at: z.string().datetime().describe("Instant when the promotion happened."),
 });
 export const channelListResponseSchema = z.object({

package/dist/contracts/cli.d.ts

@@ -1,3 +1,4 @@
+import { z } from "zod";
 export declare const CLI_EXIT_CODES: {
     readonly ok: 0;
     readonly validation: 2;
@@ -8,3 +9,9 @@ export declare const CLI_EXIT_CODES: {
     readonly timeout: 50;
     readonly unknown: 1;
 };
+export declare const cliWarningSchema: z.ZodObject<{
+    code: z.ZodString;
+    message: z.ZodString;
+    hint: z.ZodString;
+}, z.core.$strip>;
+export type CliWarning = z.infer<typeof cliWarningSchema>;

package/dist/contracts/cli.js

@@ -1,3 +1,4 @@
+import { z } from "zod";
 export const CLI_EXIT_CODES = {
     ok: 0,
     validation: 2,
@@ -8,3 +9,8 @@ export const CLI_EXIT_CODES = {
     timeout: 50,
     unknown: 1,
 };
+export const cliWarningSchema = z.object({
+    code: z.string().min(1),
+    message: z.string().min(1),
+    hint: z.string().min(1),
+});

package/dist/contracts/collab-public.d.ts

@@ -6,7 +6,7 @@ export declare const publicActorSchema: z.ZodObject<{
     avatar_url: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export type PublicActor = z.infer<typeof publicActorSchema>;
-/** A thread as a list renders it — the body is an excerpt, the anchor is gone. */
+/** A thread as a list renders it. The body is an excerpt, the anchor is gone. */
 export declare const publicThreadSchema: z.ZodObject<{
     id: z.ZodString;
     path: z.ZodString;

package/dist/contracts/collab-public.js

@@ -1,10 +1,7 @@
-// The Collab public types — the sanitized shapes every collab surface emits or
-// renders (collab-public-api.html §5). One home: the SDK, the overlay, the
-// dashboard bridge, the control-plane projection and any published layout all
-// import from here. Re-exported nowhere.
-//
-// Sanitized means sanitized: no emails, no raw authority refs, no anchors. A
-// custom layout can restyle everything these carry and escalate nothing.
+// The sanitized shapes every collab surface emits or renders
+// (collab-public-api.html §5). One home, imported directly, re-exported nowhere.
+// Sanitized means no emails, no raw authority refs, no anchors: a custom layout
+// can restyle everything these carry and escalate nothing.
 import { z } from "zod";
 /** A person, as everyone else may see them. Identity colors are not themeable. */
 export const publicActorSchema = z.object({
@@ -12,7 +9,7 @@ export const publicActorSchema = z.object({
     color: z.string().min(1).max(32),
     avatar_url: z.string().url().max(2048).optional(),
 });
-/** A thread as a list renders it — the body is an excerpt, the anchor is gone. */
+/** A thread as a list renders it. The body is an excerpt, the anchor is gone. */
 export const publicThreadSchema = z.object({
     id: z.string().min(1).max(128),
     path: z.string().min(1).max(2048),

package/dist/contracts/comments.d.ts

@@ -4,6 +4,17 @@ export declare const commentThreadStatusSchema: z.ZodEnum<{
     open: "open";
     archived: "archived";
 }>;
+/**
+ * What a moderator may ask a thread to become. Spam is not a stored status —
+ * Cast holds it as the thread's moderation state — so "spam" is a verdict the
+ * wire accepts, and reading a thread back always reports `open` or `archived`
+ * with `moderationState` beside it.
+ */
+export declare const commentThreadStatusPatchSchema: z.ZodEnum<{
+    open: "open";
+    spam: "spam";
+    archived: "archived";
+}>;
 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;
@@ -41,12 +52,10 @@ export declare const collaborationPublicProfileSchema: z.ZodObject<{
 }, z.core.$strict>;
 export type CollaborationPublicProfile = z.infer<typeof collaborationPublicProfileSchema>;
 /**
- * Where the browser holding this ticket is.
- *
- * "embed" is a third-party site the owner allowlisted, and it is its own state
- * precisely so nothing pretends a foreign origin is a published Spacefast host:
- * the room an embed ticket names is origin-scoped, and both the mint and Cast
- * refuse the pairing in either direction.
+ * Where the browser holding this ticket is. "embed" is a third-party site the
+ * owner allowlisted, kept a separate state so no foreign origin passes as a
+ * published host: an embed ticket's room is origin-scoped, and both the mint
+ * and Cast refuse the pairing in either direction.
  */
 export declare const collaborationSurfaceSchema: z.ZodEnum<{
     preview: "preview";
@@ -63,9 +72,9 @@ export declare const collaborationTicketClaimsSchema: z.ZodObject<{
         avatar_url: z.ZodNullable<z.ZodURL>;
     }, z.core.$strict>>;
     role: z.ZodEnum<{
+        editor: "editor";
         viewer: "viewer";
         commenter: "commenter";
-        editor: "editor";
         manager: "manager";
     }>;
     actorKind: z.ZodEnum<{
@@ -97,6 +106,8 @@ export declare const collaborationTicketClaimsSchema: z.ZodObject<{
     iss: z.ZodLiteral<"spacefast-api">;
     aud: z.ZodString;
 }, z.core.$strip>;
+/** Where a team without the collab.comments feature applies for access. */
+export declare const COMMENTS_WAITLIST_URL = "https://spacefast.com/waitlists/collab";
 export declare const commentsSurfaceSchema: z.ZodEnum<{
     off: "off";
     previews: "previews";
@@ -104,13 +115,11 @@ export declare const commentsSurfaceSchema: z.ZodEnum<{
 }>;
 export declare const COMMENTS_EMBED_ORIGINS_MAX = 20;
 /**
- * A site the Space owner allows the one-line Collab insert to run on.
- *
- * Exactly one https origin — scheme, host, and port, nothing else. No
- * wildcards: on a foreign site this list IS the entitlement, and `*.example.com`
- * hands it to every subdomain the site ever loses control of. An off-shape
- * value is refused rather than normalized, so what the owner typed and what the
- * server matches are the same string.
+ * A site the Space owner allows the one-line Collab insert to run on. Exactly
+ * one https origin, nothing else: on a foreign site this list IS the
+ * entitlement, and `*.example.com` hands it to every subdomain the site ever
+ * loses control of. An off-shape value is refused rather than normalized, so
+ * the owner's string and the matched string are the same.
  */
 export declare const commentsEmbedOriginSchema: z.ZodString;
 export declare const collaborationSettingsSchema: z.ZodObject<{
@@ -167,11 +176,9 @@ export declare const collaborationUpdateSchema: z.ZodObject<{
     }, z.core.$strict>;
 }, z.core.$strip>;
 /**
- * The overlay's whole configuration, in one shape.
- *
- * Both lanes carry this: the Space's own origins get it from the runtime's
- * same-origin exchange, a third-party site fetches it over CORS keyed by
- * `data-space`. Only the transport differs — the SDK parses one shape.
+ * The overlay's whole configuration. Both lanes carry it: the Space's own
+ * origins from the runtime's same-origin exchange, a third-party site over CORS
+ * keyed by `data-space`. Only the transport differs.
  */
 export declare const collabOverlayConfigSchema: z.ZodObject<{
     enabled: z.ZodBoolean;
@@ -247,11 +254,9 @@ export declare const realtimeTokenResponseSchema: z.ZodObject<{
     }, z.core.$strip>;
 }, z.core.$strip>;
 /**
- * A Space-level fact worth interrupting someone for. It travels as a `notice`
- * on the Space's notice room — never as an event in a page room — because it
- * is not conversation content: every open surface needs it regardless of which
- * page it happens to be sitting on, including surfaces (the dashboard) that
- * are in no page room at all.
+ * A Space-level fact worth interrupting someone for. It travels on the Space's
+ * notice room, never as a page-room event: every open surface needs it whatever
+ * page it is on, including the dashboard, which is in no page room at all.
  */
 export declare const noticePublishSchema: z.ZodObject<{
     versionId: z.ZodOptional<z.ZodString>;
@@ -296,14 +301,13 @@ export declare const commentAuthorSchema: z.ZodObject<{
 }, z.core.$strip>;
 export declare const commentTargetSchema: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 /**
- * How many attachments one thread or reply may carry. Mirrors Cast's own
- * `@attachment_limit`: Cast is the authority that enforces it on write, this
- * bound is what REST readers can rely on.
+ * How many attachments one thread or reply may carry. Mirrors Cast's
+ * `@attachment_limit`: Cast enforces it on write, this is what REST readers get.
  */
 export declare const COMMENT_ATTACHMENT_MAX_COUNT = 10;
 /**
  * A pointer to a storage object on the Space's own runtime plus the descriptor
- * needed to render it — never a URL. Cast stores exactly this (snake_case) under
+ * needed to render it, never a URL. Cast stores exactly this (snake_case) under
  * `metadata.attachments`; the id is a bare 32-hex object id.
  */
 export declare const commentAttachmentSchema: z.ZodObject<{
@@ -324,9 +328,8 @@ export declare const commentAttachmentSchema: z.ZodObject<{
     }, z.core.$strip>>;
 }, z.core.$strip>;
 /**
- * What a REST reader gets: the stored attachment plus a freshly composed read
- * URL. `url` is null when the runtime's revocable read key cannot be resolved —
- * an honest degraded read rather than a dead link or a dropped attachment.
+ * The stored attachment plus a freshly composed read URL. `url` is null when the
+ * runtime's revocable read key cannot be resolved.
  */
 export declare const commentAttachmentViewSchema: z.ZodObject<{
     id: z.ZodString;
@@ -490,9 +493,6 @@ export declare const commentListQuerySchema: z.ZodObject<{
     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;
@@ -503,11 +503,20 @@ export declare const commentReplySchema: z.ZodObject<{
     body: z.ZodString;
     idempotencyKey: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
+export declare const commentReplyResponseSchema: z.ZodObject<{
+    status: z.ZodEnum<{
+        inserted: "inserted";
+        existing: "existing";
+    }>;
+    comment: z.ZodObject<{}, z.core.$loose>;
+}, z.core.$loose>;
 export declare const commentPatchSchema: z.ZodObject<{
     status: z.ZodOptional<z.ZodEnum<{
         open: "open";
+        spam: "spam";
         archived: "archived";
     }>>;
+    spamCommentId: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export declare const commentExportQuerySchema: z.ZodObject<{
     format: z.ZodDefault<z.ZodEnum<{
@@ -614,5 +623,6 @@ export type CollaborationUpdate = z.infer<typeof collaborationUpdateSchema>;
 export type CommentsSurface = z.infer<typeof commentsSurfaceSchema>;
 export type CollabVersionUrl = z.infer<typeof collabVersionUrlSchema>;
 export type CommentThread = z.infer<typeof commentThreadSchema>;
+export type CommentThreadStatusPatch = z.infer<typeof commentThreadStatusPatchSchema>;
 export type CommentAttachment = z.infer<typeof commentAttachmentSchema>;
 export type CommentAttachmentView = z.infer<typeof commentAttachmentViewSchema>;