@spacefast/common 0.0.26 → 0.2.1

package/dist/contracts/superadmin-spaces.js

@@ -41,11 +41,9 @@ export const SuperadminSpaceVersionZeroSchema = z
     runnerCompatibilityTarget: z.string().nullable(),
     runnerSha256: z.string().nullable(),
     blockIncompatibleRollback: z.boolean(),
-    // No log counts. A capsule's output is the space's runtime log like any
-    // other tier's, and that lives in one place only — the provider's PHP error
-    // log, windowed and paged. Summarising it per version would mean scanning
-    // that window on every superadmin page load; read it on the log surface
-    // instead.
+    // No log counts: a capsule's output goes to the provider's PHP error log
+    // like every other tier's, and summarising it per version would scan that
+    // window on every page load. Read it on the log surface instead.
     operations: z
         .object({
         replayEventCount: z.number().int().nonnegative(),
@@ -91,13 +89,12 @@ export const SuperadminSpaceDetailSchema = z.object({
     hostnames: z.array(SuperadminSpaceHostnameSchema),
     versions: z.array(SuperadminSpaceVersionSchema),
 });
-// Operator view links. Ops Slack links superadmin instead of a customer's own
-// private URL, so this is the hop that opens the actual page from an alert.
+// Opens the customer's actual page from an operator alert.
 export const superadminSpaceViewLinkWriteSchema = z
     .object({ path: accessScopePathSchema.optional() })
     .strict();
-// Stateless: the URL is a signed token, so there is no row to name, list, or
-// revoke individually — it simply expires.
+// Stateless: the URL is a signed token. There is nothing to list or revoke, and
+// it expires on its own.
 export const SuperadminSpaceViewLinkSchema = z
     .object({
     landingPath: z.string(),
@@ -105,10 +102,77 @@ export const SuperadminSpaceViewLinkSchema = z
     url: z.string().url(),
 })
     .strict();
-// The cross-tenant Space list. Same Space resource the customer API returns —
-// operators need the identical shape, not a parallel projection — narrowed by
-// the operator-only facets (tenant, team, ownership, lifecycle, serving).
-export const SuperadminSpaceListSchema = makeOffsetListSchema("spaces", SpaceSchema, superadminPaginationSchema);
+export const SuperadminEngineSyncStateSchema = z.enum(["idle", "pending", "running", "failed"]);
+export const SuperadminSpacePlacementSchema = z
+    .object({
+    state: z.enum(["placed", "unplaced"]),
+    providerRef: z.string().nullable(),
+    providerClientId: z.string().nullable(),
+    providerTargetId: z.string().nullable(),
+    primaryHostname: z.string().nullable(),
+    runtimeInstanceId: z.string().nullable(),
+    region: z.string(),
+    geoAffinity: z.string().nullable(),
+})
+    .strict();
+export const SuperadminSpaceEngineSchema = z
+    .object({
+    reportedRevision: z.string().nullable(),
+    targetRevision: z.string().nullable(),
+    desiredRevision: z.string().nullable(),
+    reportedAt: z.string().datetime().nullable(),
+    state: SuperadminEngineSyncStateSchema,
+    lastError: z.string().nullable(),
+    attemptCount: z.number().int().nonnegative(),
+    nextAttemptAt: z.string().datetime().nullable(),
+    diverged: z.boolean(),
+})
+    .strict();
+export const SuperadminSpaceLiveVersionSchema = z
+    .object({
+    id: z.string(),
+    number: z.number().int().positive().nullable(),
+    status: z.string(),
+})
+    .strict();
+export const SuperadminSpaceRetainedDeletionSchema = z
+    .object({
+    state: z.enum(["pending", "purging", "purged"]),
+    requestedAt: z.string().datetime(),
+    cleanupDueAt: z.string().datetime(),
+    overdue: z.boolean(),
+})
+    .strict();
+// The operator directory must also represent damaged legacy rows. A missing
+// default hostname is an issue to repair from Manage, not a reason to fail the
+// whole fleet list against the strict customer Space contract.
+export const SuperadminSpaceListItemSchema = SpaceSchema.pick({
+    id: true,
+    tenantId: true,
+    providerRef: true,
+    providerClientId: true,
+    teamId: true,
+    teamSlug: true,
+    anonymous: true,
+    slug: true,
+    title: true,
+    status: true,
+    disabled: true,
+    dataLocation: true,
+    region: true,
+    burstable: true,
+    archivedBytes: true,
+    createdAt: true,
+    updatedAt: true,
+}).extend({
+    defaultHostname: z.string().nullable(),
+    liveUrl: z.string().nullable(),
+    placement: SuperadminSpacePlacementSchema,
+    engine: SuperadminSpaceEngineSchema,
+    liveVersion: SuperadminSpaceLiveVersionSchema.nullable(),
+    retainedDeletion: SuperadminSpaceRetainedDeletionSchema.nullable(),
+});
+export const SuperadminSpaceListSchema = makeOffsetListSchema("spaces", SuperadminSpaceListItemSchema, superadminPaginationSchema);
 export const superadminSpaceListQuerySchema = z.object({
     limit: z.coerce.number().int().min(1).max(100).default(25),
     offset: z.coerce.number().int().min(0).default(0),
@@ -117,18 +181,57 @@ export const superadminSpaceListQuerySchema = z.object({
     search: z.string().trim().optional(),
     tenantId: z.string().trim().optional(),
     teamId: z.string().trim().optional(),
-    // Customer-360: every space owned by any team this user is a member of.
+    // Every space owned by any team this user is a member of.
     memberUserId: z.string().trim().optional(),
     ownership: z.enum(["team", "external", "anonymous"]).optional(),
     status: spaceStatus.optional(),
-    // Serving axis, independent of lifecycle status: true selects spaces whose
-    // serving is currently disabled (takedown, suspension), false the rest.
+    // Independent of lifecycle status: true selects spaces whose serving is
+    // disabled (takedown, suspension).
     disabled: z.stringbool().optional(),
+    retainedDeletion: z.enum(["pending", "overdue"]).optional(),
+    placement: z.enum(["placed", "unplaced"]).optional(),
+    diverged: z.stringbool().optional(),
+    engineState: SuperadminEngineSyncStateSchema.optional(),
+    engineRevision: z.string().trim().min(1).optional(),
+    sort: z.enum(["created", "title", "engine", "placement"]).default("created"),
+    direction: z.enum(["asc", "desc"]).default("desc"),
 });
-// Per-space scan visibility. The evidence is content-addressed — one verdict
-// per (digest, engine, signature DB version), shared by every version that
-// published the same bytes — so this projects it back onto the version's
-// manifest, which is the coordinate an operator actually has.
+export const SuperadminSpacePurgeResponseSchema = z
+    .object({
+    // Injected by the control-plane response layer after route validation.
+    $schema: z.string().url().optional(),
+    spaceId: z.string(),
+    operationId: z.string(),
+})
+    .strict();
+export const SuperadminManageResponseSchema = z
+    .object({
+    // Injected by the control-plane response layer after route validation, not
+    // by the handler, so the browser-side contract must accept it.
+    $schema: z.string().url().optional(),
+    entity: z.enum(["space", "pool", "provider_site"]),
+    binding: z
+        .object({
+        spaceId: z.string().nullable(),
+        poolId: z.string().nullable(),
+        providerSiteId: z.string().nullable(),
+    })
+        .strict(),
+    space: SuperadminSpaceListItemSchema.nullable(),
+    placement: SuperadminSpacePlacementSchema,
+    engine: SuperadminSpaceEngineSchema,
+    health: z
+        .object({
+        status: z.enum(["healthy", "attention", "unknown"]),
+        issues: z.array(z.string()),
+    })
+        .strict(),
+})
+    .strict();
+// Per-space scan visibility. Evidence is content-addressed: one verdict per
+// (digest, engine, signature DB version), shared by every version that
+// published the same bytes. This projects it onto the version's manifest, the
+// coordinate an operator actually has.
 export const superadminSpaceScanResultsQuerySchema = z.object({
     // Narrow to one version; otherwise the newest `versionLimit` are returned.
     versionId: z.string().trim().min(1).optional(),
@@ -138,8 +241,8 @@ export const SuperadminSpaceScanVerdictSchema = z
     .object({
     engine: z.string(),
     signatureDbVersion: z.string(),
-    // The evidence row exactly as the engine wrote it. The hash allowlist never
-    // rewrites this — suppression is prospective, not a retraction.
+    // The engine's row verbatim. The hash allowlist never rewrites it;
+    // suppression is prospective, not a retraction.
     verdict: z.enum(["clean", "flagged", "skipped"]),
     // What enforcement acts on: an allowlisted media-hash flag reads clean.
     effectiveVerdict: z.enum(["clean", "flagged", "skipped"]),
@@ -166,6 +269,10 @@ export const SuperadminSpaceScanVersionSchema = z
     number: z.number().int().nullable(),
     status: z.string(),
     readyAt: z.string().datetime().nullable(),
+    // The runtime catalog is the sole file authority. A read failure degrades
+    // this operator surface without substituting database evidence for files.
+    catalogStatus: z.enum(["available", "not_ready", "unavailable"]),
+    catalogFailureKind: z.enum(["fetch_failed", "invalid_payload"]).nullable(),
     files: z.array(SuperadminSpaceScanFileSchema),
     // One bucket per manifest file, by the worst effective verdict it carries:
     // flagged beats skipped beats clean, and a file with no evidence row at all
@@ -187,9 +294,8 @@ export const SuperadminSpaceScanResultsSchema = z
     versions: z.array(SuperadminSpaceScanVersionSchema),
 })
     .strict();
-// Operator re-home: one assign for every space, claimed or not. The reason is
-// the operator's own note on why ownership moved — it lands in the space's
-// activity feed, so the customer can read it.
+// One assign for every space, claimed or not. `reason` lands in the space's
+// activity feed, where the customer can read it.
 export const superadminSpaceAssignSchema = z
     .object({
     teamId: z.string().min(1),

package/dist/contracts/superadmin-teams.d.ts

@@ -10,6 +10,7 @@ export declare const SuperadminTeamSchema: z.ZodObject<{
     deletedAt: z.ZodNullable<z.ZodString>;
     memberCount: z.ZodNumber;
     spaceCount: z.ZodNumber;
+    activeSpaceCount: z.ZodNumber;
     createdAt: z.ZodString;
     updatedAt: z.ZodString;
 }, z.core.$strip>;
@@ -42,6 +43,7 @@ export declare const SuperadminTeamDetailSchema: z.ZodObject<{
     deletedAt: z.ZodNullable<z.ZodString>;
     memberCount: z.ZodNumber;
     spaceCount: z.ZodNumber;
+    activeSpaceCount: z.ZodNumber;
     createdAt: z.ZodString;
     updatedAt: z.ZodString;
     members: z.ZodArray<z.ZodObject<{
@@ -75,6 +77,7 @@ export declare const SuperadminTeamListSchema: z.ZodObject<{
         deletedAt: z.ZodNullable<z.ZodString>;
         memberCount: z.ZodNumber;
         spaceCount: z.ZodNumber;
+        activeSpaceCount: z.ZodNumber;
         createdAt: z.ZodString;
         updatedAt: z.ZodString;
     }, z.core.$strip>>;

package/dist/contracts/superadmin-teams.js

@@ -13,11 +13,10 @@ export const SuperadminTeamSchema = z.object({
     deletedAt: z.string().datetime().nullable(),
     memberCount: z.number().int().nonnegative(),
     spaceCount: z.number().int().nonnegative(),
+    activeSpaceCount: z.number().int().nonnegative(),
     createdAt: z.string().datetime(),
     updatedAt: z.string().datetime(),
 });
-// Superadmin reads the same membership shape every other surface does, plus
-// the one operator-only fact the product API never exposes.
 export const SuperadminTeamMemberSchema = TeamMemberSchema.extend({
     userBanned: z.boolean().describe("Whether the member's user account is banned."),
 });