@spacefast/common 0.0.11 → 0.0.13

package/dist/contracts/resources.js

@@ -1,5 +1,4 @@
 import { z } from "zod";
-import { policyDocSchema } from "./access.js";
 import { AsyncOperationSchema, baseDiagnosticSchema } from "./common.js";
 import { normalizedSiteClass, publishSourceKind, versionStatus, spaceDisabledReasonCode, spaceStatus, } from "./enums.js";
 import { pendingUploadSchema } from "./internal.js";
@@ -14,40 +13,12 @@ export const PrincipalRefSchema = z.object({
     principalType: z.enum(["team", "external"]),
     principalId: z.string(),
 });
-// ChannelPointer (internal-docs/platform.md "ChannelPointer"): exactly one of
-// `versionId` | `weighted` is present; an empty pointer is invalid. Weighted
-// pointers (gradual rollouts) are a future write surface — the shape is final.
-export const ChannelPointerSchema = z
-    .object({
-    versionId: z.string().optional().describe("Version this channel serves."),
-    weighted: z
-        .array(z.object({
-        versionId: z.string(),
-        percentage: z.number().int().min(1).max(100),
-    }))
-        .min(2)
-        .optional()
-        .describe("Weighted rollout across >=2 ready versions; percentages sum to 100."),
+// ChannelPointer (internal-docs/platform.md "ChannelPointer"): a channel names
+// exactly one version. A channel with no version yet is absent from the map
+// rather than present with an empty pointer.
+export const ChannelPointerSchema = z.object({
+    versionId: z.string().describe("Version this channel serves."),
     updatedAt: z.string().datetime(),
-})
-    .superRefine((value, ctx) => {
-    const hasVersion = value.versionId !== undefined;
-    const hasWeighted = value.weighted !== undefined;
-    if (hasVersion === hasWeighted) {
-        ctx.addIssue({
-            code: z.ZodIssueCode.custom,
-            message: "Exactly one of versionId or weighted must be present.",
-        });
-        return;
-    }
-    if (value.weighted &&
-        value.weighted.reduce((sum, entry) => sum + entry.percentage, 0) !== 100) {
-        ctx.addIssue({
-            code: z.ZodIssueCode.custom,
-            path: ["weighted"],
-            message: "Weighted percentages must sum to 100.",
-        });
-    }
 });
 // The versioned-settings CAS token: always the lowercase hex sha256 the
 // control plane computes over canonical {config, title}. Shared by the Space
@@ -91,7 +62,7 @@ export const SpaceSchema = z.object({
     expiryExtension: z.object({ extendedTo: z.string().datetime() }).nullable().optional(),
     defaultHostname: z
         .string()
-        .describe("Stable Spacefast-owned default hostname, built from the public project name under view.fast; survives slug renames."),
+        .describe("Current Spacefast-owned managed hostname under view.fast. Renaming the space changes this hostname; previously managed hostnames temporarily redirect to the current one."),
     publicName: z.string().describe("Public project label used in the managed view.fast hostname."),
     liveUrl: z
         .string()
@@ -107,7 +78,7 @@ export const SpaceSchema = z.object({
         .describe("Server-selected dashboard thumbnail. Screenshots use WordPress.com mShots; image thumbnails use WordPress.com Site Accelerator."),
     dataLocation: z
         .string()
-        .describe('Resolved data-location region. PATCH may queue a move to change it; "auto" only while no concrete region is known yet.'),
+        .describe('Resolved data-location region, fixed when the space is created and immutable afterwards; "auto" only while no concrete region is known yet.'),
     region: z
         .string()
         .describe('Alias of dataLocation for placement dashboards; "auto" only while no concrete region is known yet.'),
@@ -133,9 +104,6 @@ export const SpaceSchema = z.object({
     noindex: z
         .boolean()
         .describe("When true, the live production hostnames serve platform noindex directives. Immutable version and preview hostnames are always noindex regardless of this setting."),
-    policy: policyDocSchema
-        .nullable()
-        .describe("Deprecated space-level access projection. Use /v1/spaces/{spaceId}/access and /effective for the unified policy lane."),
     operation: AsyncOperationSchema.nullable(),
     createdAt: z.string().datetime(),
     updatedAt: z.string().datetime(),
@@ -201,9 +169,9 @@ export const VersionSchema = z.object({
     buildId: z.string().nullable(),
     // Import provenance: the source version this one was materialized from.
     importedFromVersionId: z.string().nullable(),
-    // Finalize-time variable resolution provenance — names and value hashes only,
-    // never values.
-    variables: z.array(z.object({ name: z.string(), valueHash: z.string() })).nullable(),
+    // Finalize-time dependency digests remain server-internal: historical rows
+    // cannot distinguish hashes of sealed values safely.
+    variables: z.null().describe("Variable dependency provenance is not publicly exposed."),
     fileCount: z.number().int().nullable(),
     totalBytes: z.number().int().nullable(),
     pendingUploads: z.array(pendingUploadSchema),
@@ -212,6 +180,10 @@ export const VersionSchema = z.object({
         .string()
         .nullable()
         .describe("Permanent version URL (v{number}--{label}.view.fast form), computed once and stored at ready; survives slug changes, transfers, and channel repointing. Null before ready."),
+    immutableUrlStatus: z
+        .enum(["converging", "ready"])
+        .nullable()
+        .describe("Whether the immutable version URL provider alias has converged. converging means the URL may not resolve yet."),
     isCurrentProduction: z.boolean(),
     siteTitle: z.string(),
     config: spaceConfigSchema
@@ -227,11 +199,9 @@ export const VersionSchema = z.object({
     createdAt: z.string().datetime(),
     // Retention anchor: stamped when the version first reaches "ready".
     readyAt: z.string().datetime().nullable(),
-    // Retention axes computed from plan policy at read time, never stored per row
-    // (internal-docs/platform.md "Version retention"). Null = not subject to that
-    // axis (live/channel-referenced, anonymous claim lifecycle, or the plan
-    // retains indefinitely).
-    accessibleUntil: z.string().datetime().nullable(),
+    // Storage retention deadline computed from plan policy at read time, never
+    // stored per row. Null = not subject to retention deletion
+    // (live/channel-referenced, anonymous claim lifecycle, or an unlimited plan).
     retainedUntil: z.string().datetime().nullable(),
     updatedAt: z.string().datetime(),
 });