@spacefast/common 0.0.21 → 0.0.24

package/dist/contracts/api-keys.d.ts

@@ -7,6 +7,8 @@ export declare const StatticActionSchema: z.ZodEnum<{
     "spaces:write": "spaces:write";
     "spaces:rename": "spaces:rename";
     "domains:read": "domains:read";
+    "spaces:publish": "spaces:publish";
+    "builds:trigger": "builds:trigger";
     "mcp:tools": "mcp:tools";
     "*": "*";
     "sites:read": "sites:read";
@@ -16,7 +18,6 @@ export declare const StatticActionSchema: z.ZodEnum<{
     "sites:policy.write": "sites:policy.write";
     "spaces:create": "spaces:create";
     "spaces:delete": "spaces:delete";
-    "spaces:publish": "spaces:publish";
     "spaces:transfer": "spaces:transfer";
     "spaces:export": "spaces:export";
     "spaces:import": "spaces:import";
@@ -35,7 +36,6 @@ export declare const StatticActionSchema: z.ZodEnum<{
     "webhooks:read": "webhooks:read";
     "webhooks:write": "webhooks:write";
     "builds:read": "builds:read";
-    "builds:trigger": "builds:trigger";
     "builds:create": "builds:create";
     "teams:write": "teams:write";
     "teams:members.write": "teams:members.write";
@@ -91,6 +91,8 @@ export declare const ApiCredentialPolicySchema: z.ZodObject<{
             "spaces:write": "spaces:write";
             "spaces:rename": "spaces:rename";
             "domains:read": "domains:read";
+            "spaces:publish": "spaces:publish";
+            "builds:trigger": "builds:trigger";
             "mcp:tools": "mcp:tools";
             "*": "*";
             "sites:read": "sites:read";
@@ -100,7 +102,6 @@ export declare const ApiCredentialPolicySchema: z.ZodObject<{
             "sites:policy.write": "sites:policy.write";
             "spaces:create": "spaces:create";
             "spaces:delete": "spaces:delete";
-            "spaces:publish": "spaces:publish";
             "spaces:transfer": "spaces:transfer";
             "spaces:export": "spaces:export";
             "spaces:import": "spaces:import";
@@ -119,7 +120,6 @@ export declare const ApiCredentialPolicySchema: z.ZodObject<{
             "webhooks:read": "webhooks:read";
             "webhooks:write": "webhooks:write";
             "builds:read": "builds:read";
-            "builds:trigger": "builds:trigger";
             "builds:create": "builds:create";
             "teams:write": "teams:write";
             "teams:members.write": "teams:members.write";
@@ -135,8 +135,8 @@ export declare const ApiCredentialPolicySchema: z.ZodObject<{
             "request.client": z.ZodOptional<z.ZodEnum<{
                 api: "api";
                 dashboard: "dashboard";
-                worker: "worker";
                 cli: "cli";
+                worker: "worker";
             }>>;
         }, z.core.$strict>>;
     }, z.core.$strict>>;
@@ -197,6 +197,8 @@ export declare const ApiKeySchema: z.ZodObject<{
                 "spaces:write": "spaces:write";
                 "spaces:rename": "spaces:rename";
                 "domains:read": "domains:read";
+                "spaces:publish": "spaces:publish";
+                "builds:trigger": "builds:trigger";
                 "mcp:tools": "mcp:tools";
                 "*": "*";
                 "sites:read": "sites:read";
@@ -206,7 +208,6 @@ export declare const ApiKeySchema: z.ZodObject<{
                 "sites:policy.write": "sites:policy.write";
                 "spaces:create": "spaces:create";
                 "spaces:delete": "spaces:delete";
-                "spaces:publish": "spaces:publish";
                 "spaces:transfer": "spaces:transfer";
                 "spaces:export": "spaces:export";
                 "spaces:import": "spaces:import";
@@ -225,7 +226,6 @@ export declare const ApiKeySchema: z.ZodObject<{
                 "webhooks:read": "webhooks:read";
                 "webhooks:write": "webhooks:write";
                 "builds:read": "builds:read";
-                "builds:trigger": "builds:trigger";
                 "builds:create": "builds:create";
                 "teams:write": "teams:write";
                 "teams:members.write": "teams:members.write";
@@ -241,8 +241,8 @@ export declare const ApiKeySchema: z.ZodObject<{
                 "request.client": z.ZodOptional<z.ZodEnum<{
                     api: "api";
                     dashboard: "dashboard";
-                    worker: "worker";
                     cli: "cli";
+                    worker: "worker";
                 }>>;
             }, z.core.$strict>>;
         }, z.core.$strict>>;
@@ -311,6 +311,8 @@ export declare const ApiKeyListResponseSchema: z.ZodObject<{
                     "spaces:write": "spaces:write";
                     "spaces:rename": "spaces:rename";
                     "domains:read": "domains:read";
+                    "spaces:publish": "spaces:publish";
+                    "builds:trigger": "builds:trigger";
                     "mcp:tools": "mcp:tools";
                     "*": "*";
                     "sites:read": "sites:read";
@@ -320,7 +322,6 @@ export declare const ApiKeyListResponseSchema: z.ZodObject<{
                     "sites:policy.write": "sites:policy.write";
                     "spaces:create": "spaces:create";
                     "spaces:delete": "spaces:delete";
-                    "spaces:publish": "spaces:publish";
                     "spaces:transfer": "spaces:transfer";
                     "spaces:export": "spaces:export";
                     "spaces:import": "spaces:import";
@@ -339,7 +340,6 @@ export declare const ApiKeyListResponseSchema: z.ZodObject<{
                     "webhooks:read": "webhooks:read";
                     "webhooks:write": "webhooks:write";
                     "builds:read": "builds:read";
-                    "builds:trigger": "builds:trigger";
                     "builds:create": "builds:create";
                     "teams:write": "teams:write";
                     "teams:members.write": "teams:members.write";
@@ -355,8 +355,8 @@ export declare const ApiKeyListResponseSchema: z.ZodObject<{
                     "request.client": z.ZodOptional<z.ZodEnum<{
                         api: "api";
                         dashboard: "dashboard";
-                        worker: "worker";
                         cli: "cli";
+                        worker: "worker";
                     }>>;
                 }, z.core.$strict>>;
             }, z.core.$strict>>;
@@ -405,6 +405,8 @@ export declare const ApiKeyCreateRequestSchema: z.ZodObject<{
                 "spaces:write": "spaces:write";
                 "spaces:rename": "spaces:rename";
                 "domains:read": "domains:read";
+                "spaces:publish": "spaces:publish";
+                "builds:trigger": "builds:trigger";
                 "mcp:tools": "mcp:tools";
                 "*": "*";
                 "sites:read": "sites:read";
@@ -414,7 +416,6 @@ export declare const ApiKeyCreateRequestSchema: z.ZodObject<{
                 "sites:policy.write": "sites:policy.write";
                 "spaces:create": "spaces:create";
                 "spaces:delete": "spaces:delete";
-                "spaces:publish": "spaces:publish";
                 "spaces:transfer": "spaces:transfer";
                 "spaces:export": "spaces:export";
                 "spaces:import": "spaces:import";
@@ -433,7 +434,6 @@ export declare const ApiKeyCreateRequestSchema: z.ZodObject<{
                 "webhooks:read": "webhooks:read";
                 "webhooks:write": "webhooks:write";
                 "builds:read": "builds:read";
-                "builds:trigger": "builds:trigger";
                 "builds:create": "builds:create";
                 "teams:write": "teams:write";
                 "teams:members.write": "teams:members.write";
@@ -449,8 +449,8 @@ export declare const ApiKeyCreateRequestSchema: z.ZodObject<{
                 "request.client": z.ZodOptional<z.ZodEnum<{
                     api: "api";
                     dashboard: "dashboard";
-                    worker: "worker";
                     cli: "cli";
+                    worker: "worker";
                 }>>;
             }, z.core.$strict>>;
         }, z.core.$strict>>;
@@ -481,6 +481,8 @@ export declare const ApiKeyPatchRequestSchema: z.ZodObject<{
                 "spaces:write": "spaces:write";
                 "spaces:rename": "spaces:rename";
                 "domains:read": "domains:read";
+                "spaces:publish": "spaces:publish";
+                "builds:trigger": "builds:trigger";
                 "mcp:tools": "mcp:tools";
                 "*": "*";
                 "sites:read": "sites:read";
@@ -490,7 +492,6 @@ export declare const ApiKeyPatchRequestSchema: z.ZodObject<{
                 "sites:policy.write": "sites:policy.write";
                 "spaces:create": "spaces:create";
                 "spaces:delete": "spaces:delete";
-                "spaces:publish": "spaces:publish";
                 "spaces:transfer": "spaces:transfer";
                 "spaces:export": "spaces:export";
                 "spaces:import": "spaces:import";
@@ -509,7 +510,6 @@ export declare const ApiKeyPatchRequestSchema: z.ZodObject<{
                 "webhooks:read": "webhooks:read";
                 "webhooks:write": "webhooks:write";
                 "builds:read": "builds:read";
-                "builds:trigger": "builds:trigger";
                 "builds:create": "builds:create";
                 "teams:write": "teams:write";
                 "teams:members.write": "teams:members.write";
@@ -525,8 +525,8 @@ export declare const ApiKeyPatchRequestSchema: z.ZodObject<{
                 "request.client": z.ZodOptional<z.ZodEnum<{
                     api: "api";
                     dashboard: "dashboard";
-                    worker: "worker";
                     cli: "cli";
+                    worker: "worker";
                 }>>;
             }, z.core.$strict>>;
         }, z.core.$strict>>;
@@ -556,6 +556,8 @@ export declare const ApiKeyScopedCreateRequestSchema: z.ZodObject<{
         "spaces:write": "spaces:write";
         "spaces:rename": "spaces:rename";
         "domains:read": "domains:read";
+        "spaces:publish": "spaces:publish";
+        "builds:trigger": "builds:trigger";
         "mcp:tools": "mcp:tools";
         "*": "*";
         "sites:read": "sites:read";
@@ -565,7 +567,6 @@ export declare const ApiKeyScopedCreateRequestSchema: z.ZodObject<{
         "sites:policy.write": "sites:policy.write";
         "spaces:create": "spaces:create";
         "spaces:delete": "spaces:delete";
-        "spaces:publish": "spaces:publish";
         "spaces:transfer": "spaces:transfer";
         "spaces:export": "spaces:export";
         "spaces:import": "spaces:import";
@@ -584,7 +585,6 @@ export declare const ApiKeyScopedCreateRequestSchema: z.ZodObject<{
         "webhooks:read": "webhooks:read";
         "webhooks:write": "webhooks:write";
         "builds:read": "builds:read";
-        "builds:trigger": "builds:trigger";
         "builds:create": "builds:create";
         "teams:write": "teams:write";
         "teams:members.write": "teams:members.write";
@@ -617,6 +617,8 @@ export declare const ApiKeyScopedPatchRequestSchema: z.ZodObject<{
         "spaces:write": "spaces:write";
         "spaces:rename": "spaces:rename";
         "domains:read": "domains:read";
+        "spaces:publish": "spaces:publish";
+        "builds:trigger": "builds:trigger";
         "mcp:tools": "mcp:tools";
         "*": "*";
         "sites:read": "sites:read";
@@ -626,7 +628,6 @@ export declare const ApiKeyScopedPatchRequestSchema: z.ZodObject<{
         "sites:policy.write": "sites:policy.write";
         "spaces:create": "spaces:create";
         "spaces:delete": "spaces:delete";
-        "spaces:publish": "spaces:publish";
         "spaces:transfer": "spaces:transfer";
         "spaces:export": "spaces:export";
         "spaces:import": "spaces:import";
@@ -645,7 +646,6 @@ export declare const ApiKeyScopedPatchRequestSchema: z.ZodObject<{
         "webhooks:read": "webhooks:read";
         "webhooks:write": "webhooks:write";
         "builds:read": "builds:read";
-        "builds:trigger": "builds:trigger";
         "builds:create": "builds:create";
         "teams:write": "teams:write";
         "teams:members.write": "teams:members.write";

package/dist/contracts/beta.js

@@ -1,7 +1,7 @@
 import { z } from "zod";
 import { makeOffsetListSchema } from "./common.js";
 import { superadminPaginationSchema } from "./superadmin.js";
-// Private-beta enrollment contracts (internal-docs/prelaunch-private-beta-plan.md).
+// Private-beta enrollment contracts.
 // Two invite systems coexist: `stattic_beta_signups` (this file) is the public
 // waitlist, while `stattic_auth_invitation` stays team-membership-only — the
 // two share no rows, routes, or email templates.

package/dist/contracts/billing.d.ts

@@ -1,10 +1,8 @@
 import { z } from "zod";
-export declare const billingProviderValues: readonly ["stripe", "app_store", "google_play", "grant"];
+export declare const billingProviderValues: readonly ["stripe", "grant"];
 export declare const billingProviderSchema: z.ZodEnum<{
     grant: "grant";
     stripe: "stripe";
-    app_store: "app_store";
-    google_play: "google_play";
 }>;
 export declare const billingIntervalValues: readonly ["monthly", "yearly"];
 export declare const billingIntervalSchema: z.ZodEnum<{
@@ -12,11 +10,6 @@ export declare const billingIntervalSchema: z.ZodEnum<{
     yearly: "yearly";
 }>;
 export type BillingIntervalValue = z.infer<typeof billingIntervalSchema>;
-export declare const appStoreEnvironmentValues: readonly ["Sandbox", "Production", "Xcode", "LocalTesting"];
-export declare const googlePlaySubscriptionStateValues: readonly ["SUBSCRIPTION_STATE_UNSPECIFIED", "SUBSCRIPTION_STATE_PENDING", "SUBSCRIPTION_STATE_ACTIVE", "SUBSCRIPTION_STATE_PAUSED", "SUBSCRIPTION_STATE_IN_GRACE_PERIOD", "SUBSCRIPTION_STATE_ON_HOLD", "SUBSCRIPTION_STATE_CANCELED", "SUBSCRIPTION_STATE_EXPIRED", "SUBSCRIPTION_STATE_PENDING_PURCHASE_EXPIRED"];
-export type GooglePlaySubscriptionState = (typeof googlePlaySubscriptionStateValues)[number];
-export declare const googlePlayAcknowledgementStateValues: readonly ["ACKNOWLEDGEMENT_STATE_UNSPECIFIED", "ACKNOWLEDGEMENT_STATE_PENDING", "ACKNOWLEDGEMENT_STATE_ACKNOWLEDGED"];
-export type GooglePlayAcknowledgementState = (typeof googlePlayAcknowledgementStateValues)[number];
 export declare const billingTransactionKindValues: readonly ["purchase", "renewal", "refund", "adjustment"];
 export declare const billingTransactionKindSchema: z.ZodEnum<{
     purchase: "purchase";
@@ -47,8 +40,6 @@ export declare const billingPlanSourceSchema: z.ZodObject<{
     provider: z.ZodEnum<{
         grant: "grant";
         stripe: "stripe";
-        app_store: "app_store";
-        google_play: "google_play";
     }>;
     planCode: z.ZodEnum<{
         free: "free";
@@ -62,30 +53,6 @@ export declare const billingPlanSourceSchema: z.ZodObject<{
     expiresAt: z.ZodNullable<z.ZodString>;
 }, z.core.$strip>;
 export type BillingPlanSource = z.infer<typeof billingPlanSourceSchema>;
-export declare const billingStoreAccountResponseSchema: z.ZodObject<{
-    token: z.ZodString;
-    appStoreProducts: z.ZodArray<z.ZodString>;
-    googlePlayBasePlans: z.ZodArray<z.ZodString>;
-}, z.core.$strip>;
-export declare const appStoreVerifyRequestSchema: z.ZodObject<{
-    transactionId: z.ZodString;
-}, z.core.$strip>;
-export declare const googlePlayRecoverRequestSchema: z.ZodObject<{
-    purchaseToken: z.ZodString;
-}, z.core.$strip>;
-export declare const storeSubscriptionResultSchema: z.ZodObject<{
-    provider: z.ZodEnum<{
-        grant: "grant";
-        stripe: "stripe";
-        app_store: "app_store";
-        google_play: "google_play";
-    }>;
-    reference: z.ZodString;
-    productId: z.ZodString;
-    planCode: z.ZodNullable<z.ZodString>;
-    isActive: z.ZodBoolean;
-    expiresAt: z.ZodNullable<z.ZodString>;
-}, z.core.$strip>;
 export declare const stripeCheckoutRequestSchema: z.ZodObject<{
     planCode: z.ZodDefault<z.ZodEnum<{
         free: "free";

package/dist/contracts/billing.js

@@ -3,37 +3,14 @@ import { planCodeSchema, planLimitValueSchema } from "./features.js";
 // Billing providers a team plan can resolve from. `grant` is a
 // superadmin-assigned subscription: no payment, no transactions, just an
 // operator-issued entitlement row (optionally expiring).
-export const billingProviderValues = ["stripe", "app_store", "google_play", "grant"];
+export const billingProviderValues = ["stripe", "grant"];
 export const billingProviderSchema = z.enum(billingProviderValues).describe("Billing provider.");
 export const billingIntervalValues = ["monthly", "yearly"];
 export const billingIntervalSchema = z.enum(billingIntervalValues);
-export const appStoreEnvironmentValues = [
-    "Sandbox",
-    "Production",
-    "Xcode",
-    "LocalTesting",
-];
-// Google Play subscriptionsv2 states (subset we persist verbatim).
-export const googlePlaySubscriptionStateValues = [
-    "SUBSCRIPTION_STATE_UNSPECIFIED",
-    "SUBSCRIPTION_STATE_PENDING",
-    "SUBSCRIPTION_STATE_ACTIVE",
-    "SUBSCRIPTION_STATE_PAUSED",
-    "SUBSCRIPTION_STATE_IN_GRACE_PERIOD",
-    "SUBSCRIPTION_STATE_ON_HOLD",
-    "SUBSCRIPTION_STATE_CANCELED",
-    "SUBSCRIPTION_STATE_EXPIRED",
-    "SUBSCRIPTION_STATE_PENDING_PURCHASE_EXPIRED",
-];
-export const googlePlayAcknowledgementStateValues = [
-    "ACKNOWLEDGEMENT_STATE_UNSPECIFIED",
-    "ACKNOWLEDGEMENT_STATE_PENDING",
-    "ACKNOWLEDGEMENT_STATE_ACKNOWLEDGED",
-];
 // Transaction ledger vocabulary. Every REAL payment event lands as one row —
 // operator grants never do (no transactions by definition). Amounts are
-// micros of the payment currency (1_000_000 micros = 1 unit) so Apple
-// milliunits, Google units+nanos, and Stripe cents all normalize losslessly.
+// micros of the payment currency (1_000_000 micros = 1 unit) so Stripe cents
+// normalize losslessly.
 export const billingTransactionKindValues = [
     "purchase",
     "renewal",
@@ -61,33 +38,7 @@ export const billingPlanSourceSchema = z.object({
     provider: billingProviderSchema,
     planCode: planCodeSchema,
     active: z.boolean(),
-    detail: z
-        .string()
-        .describe("Provider-specific reference: subscription/grant id, transaction id, or token."),
-    expiresAt: z.string().datetime().nullable(),
-});
-// Mobile-client store flows: the team's store account token is passed as
-// Apple `appAccountToken` / Google `obfuscatedExternalAccountId` at purchase
-// time so receipts bind back to the team server-side.
-export const billingStoreAccountResponseSchema = z.object({
-    token: z.string().uuid(),
-    appStoreProducts: z.array(z.string()).describe("App Store product ids sold by this deployment."),
-    googlePlayBasePlans: z
-        .array(z.string())
-        .describe("Google Play base plan ids sold by this deployment."),
-});
-export const appStoreVerifyRequestSchema = z.object({
-    transactionId: z.string().trim().min(1),
-});
-export const googlePlayRecoverRequestSchema = z.object({
-    purchaseToken: z.string().trim().min(1),
-});
-export const storeSubscriptionResultSchema = z.object({
-    provider: billingProviderSchema,
-    reference: z.string().describe("Provider-side id: transaction id or purchase token."),
-    productId: z.string(),
-    planCode: z.string().nullable(),
-    isActive: z.boolean(),
+    detail: z.string().describe("Provider-specific reference: subscription or grant id."),
     expiresAt: z.string().datetime().nullable(),
 });
 export const stripeCheckoutRequestSchema = z.object({

package/dist/contracts/builds.d.ts

@@ -24,7 +24,7 @@ declare const InternalBuildSourceSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     kind: z.ZodLiteral<"archive">;
     uploadId: z.ZodOptional<z.ZodString>;
     sourceMetadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-    objectKey: z.ZodOptional<z.ZodString>;
+    sourceBuildId: z.ZodOptional<z.ZodString>;
     uploadedAt: z.ZodOptional<z.ZodString>;
     recoveredAt: z.ZodOptional<z.ZodString>;
     sha256: z.ZodOptional<z.ZodString>;
@@ -37,7 +37,7 @@ declare const InternalBuildInputSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     kind: z.ZodLiteral<"archive">;
     uploadId: z.ZodOptional<z.ZodString>;
     sourceMetadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-    objectKey: z.ZodOptional<z.ZodString>;
+    sourceBuildId: z.ZodOptional<z.ZodString>;
     uploadedAt: z.ZodOptional<z.ZodString>;
     recoveredAt: z.ZodOptional<z.ZodString>;
     sha256: z.ZodOptional<z.ZodString>;
@@ -181,8 +181,8 @@ export declare const BuildSchema: z.ZodObject<{
         code: z.ZodString;
         severity: z.ZodEnum<{
             info: "info";
-            error: "error";
             warning: "warning";
+            error: "error";
         }>;
         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";
-            error: "error";
             warning: "warning";
+            error: "error";
         }>;
         message: z.ZodString;
         path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -295,8 +295,8 @@ export declare const buildSourceArchiveUploadSchema: z.ZodObject<{
             code: z.ZodString;
             severity: z.ZodEnum<{
                 info: "info";
-                error: "error";
                 warning: "warning";
+                error: "error";
             }>;
             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";
-                    error: "error";
                     warning: "warning";
+                    error: "error";
                 }>;
                 message: z.ZodString;
                 path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -424,8 +424,8 @@ export declare const buildCreateResponseSchema: z.ZodObject<{
                     code: z.ZodString;
                     severity: z.ZodEnum<{
                         info: "info";
-                        error: "error";
                         warning: "warning";
+                        error: "error";
                     }>;
                     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";
-                error: "error";
                 warning: "warning";
+                error: "error";
             }>;
             message: z.ZodString;
             path: z.ZodOptional<z.ZodNullable<z.ZodString>>;

package/dist/contracts/builds.js

@@ -49,8 +49,15 @@ const internalArchiveBuildSourceSchema = z.object({
         .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."),
+    sourceBuildId: z
+        .string()
+        .optional()
+        .describe("Build id whose provider runtime holds the source archive."),
+    uploadedAt: z
+        .string()
+        .datetime()
+        .optional()
+        .describe("When the archive reached the provider runtime."),
     recoveredAt: z
         .string()
         .datetime()
@@ -126,7 +133,7 @@ export const PublicBuildInputSchema = z
     })
         .strict(),
 ])
-    .describe("Public build input. Internal clone URLs and staged object keys are hidden.");
+    .describe("Public build input. Internal clone URLs and provider source references are hidden.");
 export const BuildCreateInputSchema = z
     .discriminatedUnion("kind", [
     z

package/dist/contracts/cli.d.ts

@@ -0,0 +1,10 @@
+export declare const CLI_EXIT_CODES: {
+    readonly ok: 0;
+    readonly validation: 2;
+    readonly auth: 10;
+    readonly notFound: 20;
+    readonly conflict: 30;
+    readonly network: 40;
+    readonly timeout: 50;
+    readonly unknown: 1;
+};

package/dist/contracts/cli.js

@@ -0,0 +1,10 @@
+export const CLI_EXIT_CODES = {
+    ok: 0,
+    validation: 2,
+    auth: 10,
+    notFound: 20,
+    conflict: 30,
+    network: 40,
+    timeout: 50,
+    unknown: 1,
+};

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

@@ -0,0 +1,63 @@
+import { z } from "zod";
+/** A person, as everyone else may see them. Identity colors are not themeable. */
+export declare const publicActorSchema: z.ZodObject<{
+    name: z.ZodString;
+    color: z.ZodString;
+    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. */
+export declare const publicThreadSchema: z.ZodObject<{
+    id: z.ZodString;
+    path: z.ZodString;
+    version_id: z.ZodNullable<z.ZodString>;
+    author: z.ZodObject<{
+        name: z.ZodString;
+        color: z.ZodString;
+        avatar_url: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    excerpt: z.ZodString;
+    open: z.ZodBoolean;
+    unread: z.ZodBoolean;
+    reply_count: z.ZodNumber;
+    reacted: z.ZodBoolean;
+    created_at: z.ZodString;
+}, z.core.$strip>;
+export type PublicThread = z.infer<typeof publicThreadSchema>;
+export declare const publicEventKindSchema: z.ZodEnum<{
+    publish: "publish";
+    archive: "archive";
+    thread: "thread";
+    reply: "reply";
+    reaction: "reaction";
+}>;
+export type PublicEventKind = z.infer<typeof publicEventKindSchema>;
+/** One activity tick. `line` is the rendered sentence; the rest is addressing. */
+export declare const publicEventSchema: z.ZodObject<{
+    kind: z.ZodEnum<{
+        publish: "publish";
+        archive: "archive";
+        thread: "thread";
+        reply: "reply";
+        reaction: "reaction";
+    }>;
+    actor: z.ZodOptional<z.ZodObject<{
+        name: z.ZodString;
+        color: z.ZodString;
+        avatar_url: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    thread_id: z.ZodOptional<z.ZodString>;
+    path: z.ZodOptional<z.ZodString>;
+    version_id: z.ZodOptional<z.ZodString>;
+    line: z.ZodString;
+    at: z.ZodString;
+}, z.core.$strip>;
+export type PublicEvent = z.infer<typeof publicEventSchema>;
+/** A version as a chip or a switcher names it. */
+export declare const publicVersionSchema: z.ZodObject<{
+    id: z.ZodString;
+    label: z.ZodString;
+    live: z.ZodBoolean;
+    published_at: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type PublicVersion = z.infer<typeof publicVersionSchema>;

package/dist/contracts/collab-public.js

@@ -0,0 +1,46 @@
+// 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.
+import { z } from "zod";
+/** A person, as everyone else may see them. Identity colors are not themeable. */
+export const publicActorSchema = z.object({
+    name: z.string().min(1).max(160),
+    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. */
+export const publicThreadSchema = z.object({
+    id: z.string().min(1).max(128),
+    path: z.string().min(1).max(2048),
+    version_id: z.string().min(1).max(128).nullable(),
+    author: publicActorSchema,
+    excerpt: z.string().max(2048),
+    open: z.boolean(),
+    unread: z.boolean(),
+    reply_count: z.number().int().min(0),
+    /** The viewer reacted to this thread. */
+    reacted: z.boolean(),
+    created_at: z.string().min(1).max(64),
+});
+export const publicEventKindSchema = z.enum(["thread", "reply", "reaction", "archive", "publish"]);
+/** One activity tick. `line` is the rendered sentence; the rest is addressing. */
+export const publicEventSchema = z.object({
+    kind: publicEventKindSchema,
+    actor: publicActorSchema.optional(),
+    thread_id: z.string().min(1).max(128).optional(),
+    path: z.string().min(1).max(2048).optional(),
+    version_id: z.string().min(1).max(128).optional(),
+    line: z.string().max(2048),
+    at: z.string().min(1).max(64),
+});
+/** A version as a chip or a switcher names it. */
+export const publicVersionSchema = z.object({
+    id: z.string().min(1).max(128),
+    label: z.string().min(1).max(64),
+    live: z.boolean(),
+    published_at: z.string().min(1).max(64).nullable(),
+});