@spacefast/common 0.0.23 → 0.0.26

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/api-keys.js

@@ -149,7 +149,7 @@ export const ApiKeyPresetSchema = z
 ])
     .describe("Named policy preset compiled into a concrete access policy when the key is created.");
 // `system` is never a principal type: runtime/internal credentials are
-// platform-owned and omit ownerPrincipal entirely (internal-docs/platform.md).
+// platform-owned and omit ownerPrincipal entirely (the platform spec).
 const ApiKeyOwnerPrincipalSchema = z.object({
     type: z.enum(["team", "external"]).describe("Principal type that owns this key."),
     id: z.string().min(1).describe("Stable principal id (Better Auth team id, or external id)."),
@@ -239,7 +239,7 @@ export const ApiKeyPatchRequestSchema = z
     .refine((value) => Object.keys(value).length > 0, {
     message: "At least one mutable API key field is required.",
 });
-// Target §5C contract (internal-docs/cli-ux-dx-improvement-plan-2026-07-12.html
+// Target §5C contract (the internal plan
 // "API key: finite permissions, no broad role"): key creation selects an
 // explicit, finite scope and permission set — never a team-wide role that
 // falls out of an omitted field. This is deliberately a DISJOINT shape from

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,7 @@ 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 stripeSyncEventTypes: readonly ["checkout.session.completed", "checkout.session.expired", "checkout.session.async_payment_succeeded", "checkout.session.async_payment_failed", "customer.subscription.created", "customer.subscription.updated", "customer.subscription.paused", "customer.subscription.resumed", "customer.subscription.deleted", "customer.subscription.trial_will_end", "invoice.created", "invoice.finalized", "invoice.updated", "invoice.paid", "invoice.payment_succeeded", "invoice.payment_failed", "invoice.marked_uncollectible", "invoice.voided", "refund.created", "refund.updated", "charge.dispute.created", "charge.dispute.updated", "charge.dispute.closed", "charge.dispute.funds_withdrawn", "charge.dispute.funds_reinstated"];
 export declare const billingTransactionKindValues: readonly ["purchase", "renewal", "refund", "adjustment"];
 export declare const billingTransactionKindSchema: z.ZodEnum<{
     purchase: "purchase";
@@ -37,9 +31,9 @@ export type BillingTransactionScope = z.infer<typeof billingTransactionScopeSche
 export declare const billingAddonSourceValues: readonly ["grant", "stripe"];
 export declare const billingAddonLimitKeyValues: readonly ["teamMembers", "subTeams", "storageBytes", "externalDomainGroups"];
 export declare const billingAddonLimitKeySchema: z.ZodEnum<{
+    storageBytes: "storageBytes";
     teamMembers: "teamMembers";
     subTeams: "subTeams";
-    storageBytes: "storageBytes";
     externalDomainGroups: "externalDomainGroups";
 }>;
 export type BillingAddonLimitKey = z.infer<typeof billingAddonLimitKeySchema>;
@@ -47,8 +41,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 +54,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,44 @@ 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",
+// Keep Stripe endpoint subscriptions and the webhook intake allowlist on one
+// contract. The environment setup command imports this exact list, so adding a
+// new processor event cannot leave deployed webhook endpoints behind.
+export const stripeSyncEventTypes = [
+    "checkout.session.completed",
+    "checkout.session.expired",
+    "checkout.session.async_payment_succeeded",
+    "checkout.session.async_payment_failed",
+    "customer.subscription.created",
+    "customer.subscription.updated",
+    "customer.subscription.paused",
+    "customer.subscription.resumed",
+    "customer.subscription.deleted",
+    "customer.subscription.trial_will_end",
+    "invoice.created",
+    "invoice.finalized",
+    "invoice.updated",
+    "invoice.paid",
+    "invoice.payment_succeeded",
+    "invoice.payment_failed",
+    "invoice.marked_uncollectible",
+    "invoice.voided",
+    "refund.created",
+    "refund.updated",
+    "charge.dispute.created",
+    "charge.dispute.updated",
+    "charge.dispute.closed",
+    "charge.dispute.funds_withdrawn",
+    "charge.dispute.funds_reinstated",
 ];
 // 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 +68,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

@@ -1,4 +1,16 @@
 import { z } from "zod";
+export declare const BuildSettingsOverrideSchema: z.ZodObject<{
+    rootDirectory: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    installDirectory: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    installCommand: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    buildCommand: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    outputDirectory: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    ignoredBuildCommand: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    frameworkPreset: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    platformPreset: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    allowUnsupportedPlatformFeatures: z.ZodOptional<z.ZodBoolean>;
+    timeoutSeconds: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
 export declare const BuildSettingsSchema: z.ZodObject<{
     rootDirectory: z.ZodDefault<z.ZodNullable<z.ZodString>>;
     installDirectory: z.ZodDefault<z.ZodNullable<z.ZodString>>;
@@ -24,7 +36,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 +49,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>;
@@ -188,7 +200,7 @@ export declare const BuildSchema: z.ZodObject<{
         path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         provider: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
             registrar: "registrar";
-            wpcloud: "wpcloud";
+            infra: "infra";
             dns: "dns";
             runtime: "runtime";
         }>>>;
@@ -213,16 +225,16 @@ export declare const buildCreateRequestSchema: z.ZodObject<{
         pullRequestNumber: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>], "kind">;
     settings: z.ZodOptional<z.ZodObject<{
-        rootDirectory: z.ZodOptional<z.ZodDefault<z.ZodNullable<z.ZodString>>>;
-        installDirectory: z.ZodOptional<z.ZodDefault<z.ZodNullable<z.ZodString>>>;
-        installCommand: z.ZodOptional<z.ZodDefault<z.ZodNullable<z.ZodString>>>;
-        buildCommand: z.ZodOptional<z.ZodDefault<z.ZodNullable<z.ZodString>>>;
-        outputDirectory: z.ZodOptional<z.ZodDefault<z.ZodNullable<z.ZodString>>>;
-        ignoredBuildCommand: z.ZodOptional<z.ZodDefault<z.ZodNullable<z.ZodString>>>;
-        frameworkPreset: z.ZodOptional<z.ZodDefault<z.ZodNullable<z.ZodString>>>;
-        platformPreset: z.ZodOptional<z.ZodDefault<z.ZodNullable<z.ZodString>>>;
-        allowUnsupportedPlatformFeatures: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
-        timeoutSeconds: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+        rootDirectory: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        installDirectory: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        installCommand: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        buildCommand: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        outputDirectory: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        ignoredBuildCommand: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        frameworkPreset: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        platformPreset: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        allowUnsupportedPlatformFeatures: z.ZodOptional<z.ZodBoolean>;
+        timeoutSeconds: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>>;
     target: z.ZodOptional<z.ZodObject<{
         channel: z.ZodOptional<z.ZodDefault<z.ZodNullable<z.ZodString>>>;
@@ -239,7 +251,7 @@ export declare const buildCreateRequestSchema: z.ZodObject<{
         path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         provider: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
             registrar: "registrar";
-            wpcloud: "wpcloud";
+            infra: "infra";
             dns: "dns";
             runtime: "runtime";
         }>>>;
@@ -302,7 +314,7 @@ export declare const buildSourceArchiveUploadSchema: z.ZodObject<{
             path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             provider: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
                 registrar: "registrar";
-                wpcloud: "wpcloud";
+                infra: "infra";
                 dns: "dns";
                 runtime: "runtime";
             }>>>;
@@ -366,7 +378,7 @@ export declare const buildCreateResponseSchema: z.ZodObject<{
                 path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
                 provider: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
                     registrar: "registrar";
-                    wpcloud: "wpcloud";
+                    infra: "infra";
                     dns: "dns";
                     runtime: "runtime";
                 }>>>;
@@ -431,7 +443,7 @@ export declare const buildCreateResponseSchema: z.ZodObject<{
                     path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
                     provider: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
                         registrar: "registrar";
-                        wpcloud: "wpcloud";
+                        infra: "infra";
                         dns: "dns";
                         runtime: "runtime";
                     }>>>;
@@ -500,7 +512,7 @@ export declare const buildListResponseSchema: z.ZodObject<{
             path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             provider: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
                 registrar: "registrar";
-                wpcloud: "wpcloud";
+                infra: "infra";
                 dns: "dns";
                 runtime: "runtime";
             }>>>;

package/dist/contracts/builds.js

@@ -4,16 +4,30 @@ import { buildStatus } from "./enums.js";
 import { uploadInstructionsSchema } from "./internal.js";
 import { versionLogEntrySchema } from "./spaces.js";
 const nullableCommandSchema = z.string().trim().min(1).nullable();
-const buildTimeoutSecondsSchema = z.number().int().min(60).max(7200).default(900);
+const buildTimeoutSecondsSchema = z.number().int().min(60).max(7200);
 const scpStyleGitRemotePattern = /^[^@\s/:]+@[^:\s]+:[^\s]+$/;
 const gitCloneUrlSchema = z
     .string()
     .trim()
     .min(1)
     .refine((value) => scpStyleGitRemotePattern.test(value) || z.string().url().safeParse(value).success, "Clone URL must be a URL or scp-style Git remote.");
-// Build (`bld_`, internal-docs/platform.md "Build"): a first-class resource with
+// Build (`bld_`, the platform spec "Build"): a first-class resource with
 // its own table; ids are opaque and NEVER derived from version ids. The runner
 // mints the produced version through the normal finalize path.
+export const BuildSettingsOverrideSchema = z
+    .object({
+    rootDirectory: nullableCommandSchema.optional(),
+    installDirectory: nullableCommandSchema.optional(),
+    installCommand: nullableCommandSchema.optional(),
+    buildCommand: nullableCommandSchema.optional(),
+    outputDirectory: nullableCommandSchema.optional(),
+    ignoredBuildCommand: nullableCommandSchema.optional(),
+    frameworkPreset: nullableCommandSchema.optional(),
+    platformPreset: nullableCommandSchema.optional(),
+    allowUnsupportedPlatformFeatures: z.boolean().optional(),
+    timeoutSeconds: buildTimeoutSecondsSchema.optional(),
+})
+    .describe("Sparse per-request build setting overrides applied over saved settings.");
 export const BuildSettingsSchema = z
     .object({
     rootDirectory: nullableCommandSchema.default(null),
@@ -25,7 +39,7 @@ export const BuildSettingsSchema = z
     frameworkPreset: nullableCommandSchema.default(null),
     platformPreset: nullableCommandSchema.default(null),
     allowUnsupportedPlatformFeatures: z.boolean().default(false),
-    timeoutSeconds: buildTimeoutSecondsSchema,
+    timeoutSeconds: buildTimeoutSecondsSchema.default(900),
 })
     .describe("Resolved build settings. Builds persist this as an immutable `settingsSnapshot`.");
 export const BuildTargetSchema = z
@@ -49,8 +63,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 +147,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
@@ -219,9 +240,7 @@ export const BuildSchema = z.object({
 });
 export const buildCreateRequestSchema = z.object({
     input: BuildCreateInputSchema,
-    settings: BuildSettingsSchema.partial()
-        .optional()
-        .describe("Per-run settings overrides, persisted as `settingsSnapshot` after resolution."),
+    settings: BuildSettingsOverrideSchema.optional().describe("Per-run settings overrides, persisted as `settingsSnapshot` after resolution."),
     target: BuildTargetSchema.partial().optional(),
     diagnostics: z
         .array(baseDiagnosticSchema)

package/dist/contracts/channels.js

@@ -1,5 +1,5 @@
 import { z } from "zod";
-// Channels READ surface (internal-docs/platform.md "Channels"): a read-only
+// Channels READ surface (the platform spec "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.