@spacefast/common 0.0.23 → 0.0.24

package/dist/contracts/resources.js

@@ -1,6 +1,6 @@
 import { z } from "zod";
 import { AsyncOperationSchema, baseDiagnosticSchema } from "./common.js";
-import { normalizedSiteClass, publishSourceKind, versionStatus, spaceDisabledReasonCode, spaceStatus, } from "./enums.js";
+import { publishSourceKind, versionStatus, spaceDisabledReasonCode, spaceStatus } from "./enums.js";
 import { pendingUploadSchema } from "./internal.js";
 import { spaceConfigSchema } from "./space-config.js";
 export const DiagnosticSchema = baseDiagnosticSchema.extend({
@@ -30,7 +30,17 @@ export const spaceSettingsDigestSchema = z
 export const SpaceSchema = z.object({
     id: z.string(),
     tenantId: z.string(),
-    siteId: z.string().nullable(),
+    // Raw provider identity of the site this space IS — deliberately not hidden
+    // behind an abstraction, because a platform tenant provisioning under its own
+    // WP.Cloud client needs the real handle to reconcile against. Both are
+    // platform-surface fields (like `tenantId` and `principal`): the public API
+    // reference strips them, the platform document keeps them. Null until the
+    // space is placed.
+    providerRef: z.string().nullable().describe("WP.Cloud `atomic_site_id` serving this space."),
+    providerClientId: z
+        .string()
+        .nullable()
+        .describe("WP.Cloud client identity (`pvc_...`) the space's site is provisioned under."),
     teamId: z.string().nullable(),
     teamSlug: z.string().nullable(),
     principal: PrincipalRefSchema.nullable(),
@@ -39,7 +49,7 @@ export const SpaceSchema = z.object({
     title: z.string(),
     status: spaceStatus.describe("Operation-lifecycle status. Serving state is the separate `disabled` axis."),
     // Serving axis, distinct from the operation-lifecycle state: set whenever
-    // the space is dark. A disabled space can still be moving. Confirmed scan
+    // the space is dark. A disabled space can still be updating. Confirmed scan
     // takedowns use `abuse_takedown`; verdict and claim state are separate axes.
     disabled: z
         .object({
@@ -82,18 +92,15 @@ export const SpaceSchema = z.object({
     region: z
         .string()
         .describe('Alias of dataLocation for placement dashboards; "auto" only while no concrete region is known yet.'),
-    placementMode: normalizedSiteClass.describe("Requested placement mode for this space."),
     burstable: z
         .boolean()
         .nullable()
-        .describe("Whether a dedicated placement can burst provider PHP workers."),
+        .describe("Whether this space's site can burst provider PHP workers."),
     archivedBytes: z
         .number()
         .int()
         .nonnegative()
         .describe("Bytes currently archived out of the hot runtime store."),
-    tierPolicy: z.enum(["auto", "always_hot"]).describe("Storage tiering policy for this space."),
-    moving: z.boolean().describe("Whether a placement or transfer move is queued or running."),
     hasRuntime: z
         .boolean()
         .describe("Whether this space's live version runs code and therefore has a Runtime surface. Feature eligibility alone does not make the surface visible."),
@@ -177,6 +184,23 @@ export const VersionSchema = z.object({
     variables: z.null().describe("Variable dependency provenance is not publicly exposed."),
     fileCount: z.number().int().nullable(),
     totalBytes: z.number().int().nullable(),
+    // The runtime's catalog diff against the version this one replaced, written
+    // once at finalize. Zero on versions that never finalized.
+    filesAddedCount: z
+        .number()
+        .int()
+        .nonnegative()
+        .describe("Paths this version added against the version it replaced."),
+    filesChangedCount: z
+        .number()
+        .int()
+        .nonnegative()
+        .describe("Paths whose bytes changed against the version this one replaced."),
+    filesRemovedCount: z
+        .number()
+        .int()
+        .nonnegative()
+        .describe("Paths this version removed against the version it replaced."),
     pendingUploads: z.array(pendingUploadSchema),
     skippedPaths: z.array(z.string()),
     immutableUrl: z
@@ -200,12 +224,8 @@ export const VersionSchema = z.object({
     buildLog: z.string().nullable(),
     diagnostics: z.array(DiagnosticSchema).default([]),
     createdAt: z.string().datetime(),
-    // Retention anchor: stamped when the version first reaches "ready".
+    // Stamped when the version first reaches "ready".
     readyAt: 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(),
 });
 const activeVersionStatuses = new Set(["created", "uploading", "uploaded", "finalizing"]);