@spacefast/common 0.0.23 → 0.0.26

package/dist/contracts/repository-connections.d.ts

@@ -9,6 +9,12 @@ export declare const repositoryConnectionSyncStatusSchema: z.ZodEnum<{
     idle: "idle";
     syncing: "syncing";
 }>;
+export declare const repositoryProviderAccessStatusSchema: z.ZodEnum<{
+    active: "active";
+    suspended: "suspended";
+    revoked: "revoked";
+    reauthorization_required: "reauthorization_required";
+}>;
 export declare const RepositoryConnectionSchema: z.ZodObject<{
     id: z.ZodString;
     spaceId: z.ZodString;
@@ -51,6 +57,13 @@ export declare const RepositoryConnectionSchema: z.ZodObject<{
         idle: "idle";
         syncing: "syncing";
     }>;
+    providerAccessStatus: z.ZodDefault<z.ZodEnum<{
+        active: "active";
+        suspended: "suspended";
+        revoked: "revoked";
+        reauthorization_required: "reauthorization_required";
+    }>>;
+    providerAccessError: z.ZodDefault<z.ZodNullable<z.ZodString>>;
     lastSyncedAt: z.ZodNullable<z.ZodString>;
     lastSyncError: z.ZodNullable<z.ZodString>;
     syncRunId: z.ZodNullable<z.ZodString>;
@@ -81,16 +94,16 @@ export declare const repositoryConnectionCreateSchema: z.ZodObject<{
     autoDeployProduction: z.ZodDefault<z.ZodBoolean>;
     autoDeployPreviews: z.ZodDefault<z.ZodBoolean>;
     buildSettings: 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>>;
 }, z.core.$strip>;
 export declare const repositoryConnectionPatchSchema: z.ZodObject<{
@@ -105,16 +118,16 @@ export declare const repositoryConnectionPatchSchema: z.ZodObject<{
     autoDeployProduction: z.ZodOptional<z.ZodBoolean>;
     autoDeployPreviews: z.ZodOptional<z.ZodBoolean>;
     buildSettings: 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>>;
 }, z.core.$strip>;
 export declare const repositoryImportRemoteSchema: z.ZodObject<{
@@ -132,16 +145,16 @@ export declare const repositoryImportRemoteSchema: z.ZodObject<{
     productionBranch: z.ZodOptional<z.ZodString>;
     cloneUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     buildSettings: 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>>;
     autoDeployProduction: z.ZodDefault<z.ZodBoolean>;
     autoDeployPreviews: z.ZodDefault<z.ZodBoolean>;

package/dist/contracts/repository-connections.js

@@ -1,5 +1,5 @@
 import { z } from "zod";
-import { BuildSettingsSchema } from "./builds.js";
+import { BuildSettingsOverrideSchema, BuildSettingsSchema } from "./builds.js";
 import { CursorPaginationSchema, cursorListQuerySchema } from "./common.js";
 import { gitProvider } from "./enums.js";
 // Two connection types only:
@@ -9,6 +9,12 @@ import { gitProvider } from "./enums.js";
 // not a connection type, so `import` is intentionally absent from this union.
 export const repositoryConnectionTypeSchema = z.enum(["connected", "hosted"]);
 export const repositoryConnectionSyncStatusSchema = z.enum(["idle", "syncing", "ready", "failed"]);
+export const repositoryProviderAccessStatusSchema = z.enum([
+    "active",
+    "suspended",
+    "revoked",
+    "reauthorization_required",
+]);
 export const RepositoryConnectionSchema = z.object({
     id: z.string().describe("Repository connection id (`rpc_`)."),
     spaceId: z.string(),
@@ -37,6 +43,8 @@ export const RepositoryConnectionSchema = z.object({
     autoDeployPreviews: z.boolean(),
     buildSettings: BuildSettingsSchema,
     syncStatus: repositoryConnectionSyncStatusSchema,
+    providerAccessStatus: repositoryProviderAccessStatusSchema.default("active"),
+    providerAccessError: z.string().nullable().default(null),
     lastSyncedAt: z.string().datetime().nullable(),
     lastSyncError: z.string().nullable(),
     syncRunId: z.string().nullable(),
@@ -64,7 +72,7 @@ export const repositoryConnectionCreateSchema = z.object({
     credential: z.string().trim().min(1).nullable().optional(),
     autoDeployProduction: z.boolean().default(true),
     autoDeployPreviews: z.boolean().default(true),
-    buildSettings: BuildSettingsSchema.partial().optional(),
+    buildSettings: BuildSettingsOverrideSchema.optional(),
 });
 export const repositoryConnectionPatchSchema = z.object({
     connectionType: repositoryConnectionTypeSchema.optional(),
@@ -74,7 +82,7 @@ export const repositoryConnectionPatchSchema = z.object({
     credential: z.string().trim().min(1).nullable().optional(),
     autoDeployProduction: z.boolean().optional(),
     autoDeployPreviews: z.boolean().optional(),
-    buildSettings: BuildSettingsSchema.partial().optional(),
+    buildSettings: BuildSettingsOverrideSchema.optional(),
 });
 // Importing an existing external remote is an action/flag, not a connection
 // type. It produces a `connected` connection seeded from an upstream remote.

package/dist/contracts/resources.d.ts

@@ -10,7 +10,7 @@ export declare const DiagnosticSchema: 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";
     }>>>;
@@ -38,7 +38,8 @@ export declare const spaceSettingsDigestSchema: z.ZodString;
 export declare const SpaceSchema: z.ZodObject<{
     id: z.ZodString;
     tenantId: z.ZodString;
-    siteId: z.ZodNullable<z.ZodString>;
+    providerRef: z.ZodNullable<z.ZodString>;
+    providerClientId: z.ZodNullable<z.ZodString>;
     teamId: z.ZodNullable<z.ZodString>;
     teamSlug: z.ZodNullable<z.ZodString>;
     principal: z.ZodNullable<z.ZodObject<{
@@ -56,7 +57,6 @@ export declare const SpaceSchema: z.ZodObject<{
         active: "active";
         provisioning: "provisioning";
         updating: "updating";
-        moving: "moving";
         deleting: "deleting";
         failed: "failed";
     }>;
@@ -67,6 +67,7 @@ export declare const SpaceSchema: z.ZodObject<{
             abuse_takedown: "abuse_takedown";
             tenant_suspended: "tenant_suspended";
             site_suspended: "site_suspended";
+            author_removed: "author_removed";
         }>;
     }, z.core.$strip>>;
     claimState: z.ZodNullable<z.ZodObject<{
@@ -94,17 +95,8 @@ export declare const SpaceSchema: z.ZodObject<{
     }, z.core.$strip>>;
     dataLocation: z.ZodString;
     region: z.ZodString;
-    placementMode: z.ZodEnum<{
-        shared: "shared";
-        dedicated: "dedicated";
-    }>;
     burstable: z.ZodNullable<z.ZodBoolean>;
     archivedBytes: z.ZodNumber;
-    tierPolicy: z.ZodEnum<{
-        auto: "auto";
-        always_hot: "always_hot";
-    }>;
-    moving: z.ZodBoolean;
     hasRuntime: z.ZodBoolean;
     channels: z.ZodRecord<z.ZodString, z.ZodObject<{
         versionId: z.ZodString;
@@ -122,6 +114,7 @@ export declare const SpaceSchema: z.ZodObject<{
             title: z.ZodOptional<z.ZodString>;
             description: z.ZodOptional<z.ZodString>;
             image: z.ZodOptional<z.ZodString>;
+            favicon: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>;
         superpowers: z.ZodOptional<z.ZodObject<{
             enabled: z.ZodOptional<z.ZodBoolean>;
@@ -174,10 +167,6 @@ export declare const SpaceSchema: z.ZodObject<{
             timeoutSeconds: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strict>>;
         placement: z.ZodOptional<z.ZodObject<{
-            mode: z.ZodOptional<z.ZodEnum<{
-                shared: "shared";
-                dedicated: "dedicated";
-            }>>;
             burstable: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strict>>;
         markdownNegotiation: z.ZodOptional<z.ZodBoolean>;
@@ -226,7 +215,7 @@ export declare const SpaceSchema: 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";
             }>>>;
@@ -329,6 +318,9 @@ export declare const VersionSchema: z.ZodObject<{
     variables: z.ZodNull;
     fileCount: z.ZodNullable<z.ZodNumber>;
     totalBytes: z.ZodNullable<z.ZodNumber>;
+    filesAddedCount: z.ZodNumber;
+    filesChangedCount: z.ZodNumber;
+    filesRemovedCount: z.ZodNumber;
     pendingUploads: z.ZodArray<z.ZodObject<{
         path: z.ZodString;
         size: z.ZodNumber;
@@ -355,6 +347,7 @@ export declare const VersionSchema: z.ZodObject<{
             title: z.ZodOptional<z.ZodString>;
             description: z.ZodOptional<z.ZodString>;
             image: z.ZodOptional<z.ZodString>;
+            favicon: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>;
         superpowers: z.ZodOptional<z.ZodObject<{
             enabled: z.ZodOptional<z.ZodBoolean>;
@@ -407,10 +400,6 @@ export declare const VersionSchema: z.ZodObject<{
             timeoutSeconds: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strict>>;
         placement: z.ZodOptional<z.ZodObject<{
-            mode: z.ZodOptional<z.ZodEnum<{
-                shared: "shared";
-                dedicated: "dedicated";
-            }>>;
             burstable: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strict>>;
         markdownNegotiation: z.ZodOptional<z.ZodBoolean>;
@@ -457,7 +446,7 @@ export declare const VersionSchema: 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";
             }>>>;
@@ -484,7 +473,7 @@ export declare const VersionSchema: 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";
         }>>>;
@@ -497,7 +486,6 @@ export declare const VersionSchema: z.ZodObject<{
     }, z.core.$strip>>>;
     createdAt: z.ZodString;
     readyAt: z.ZodNullable<z.ZodString>;
-    retainedUntil: z.ZodNullable<z.ZodString>;
     updatedAt: z.ZodString;
 }, z.core.$strip>;
 export declare function hasActiveVersionStatus(status: string | null | undefined): boolean;

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({
@@ -13,7 +13,7 @@ export const PrincipalRefSchema = z.object({
     principalType: z.enum(["team", "external"]),
     principalId: z.string(),
 });
-// ChannelPointer (internal-docs/platform.md "ChannelPointer"): a channel names
+// ChannelPointer (the platform spec "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({
@@ -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({
@@ -47,7 +57,7 @@ export const SpaceSchema = z.object({
         reasonCode: spaceDisabledReasonCode.describe("Why serving is disabled."),
     })
         .nullable(),
-    // Anonymous-claim lifecycle (internal-docs/platform.md Space.claimState): null
+    // Anonymous-claim lifecycle (the platform spec Space.claimState): null
     // for spaces that never went through the anonymous lifecycle. `purgeAfter` is
     // the end of the one-day post-expiry recovery window before content deletion.
     claimState: z
@@ -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."),
@@ -111,7 +118,7 @@ export const SpaceSchema = z.object({
     createdAt: z.string().datetime(),
     updatedAt: z.string().datetime(),
 });
-// PublishSource (internal-docs/platform.md "PublishSource"): the single
+// PublishSource (the platform spec "PublishSource"): the single
 // provenance shape for how a version came to exist. Sent on publish/version
 // create and echoed on the Version resource. Structured CI/git detail beyond
 // the named fields rides in `metadata` (string values only).
@@ -121,7 +128,7 @@ export const PublishSourceSchema = z.object({
         .string()
         .max(255)
         .optional()
-        .describe("Publishing client attribution, e.g. spacefast-cli/1.2.3."),
+        .describe("Publishing client attribution, for example `spacefast-cli/1.2.3`."),
     branch: z.string().max(255).optional().describe("Git branch the publish came from."),
     commit: z.string().max(64).optional().describe("Git commit SHA the publish came from."),
     message: z
@@ -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"]);