@spacefast/common 0.0.12 → 0.0.17

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

@@ -147,7 +147,6 @@ export declare const SuperadminSpaceDetailSchema: z.ZodObject<{
                 abuse_takedown: "abuse_takedown";
                 tenant_suspended: "tenant_suspended";
                 site_suspended: "site_suspended";
-                visit_cap_exceeded: "visit_cap_exceeded";
             }>;
         }, z.core.$strip>>;
         claimState: z.ZodNullable<z.ZodObject<{
@@ -186,6 +185,7 @@ export declare const SuperadminSpaceDetailSchema: z.ZodObject<{
             always_hot: "always_hot";
         }>;
         moving: z.ZodBoolean;
+        hasRuntime: z.ZodBoolean;
         channels: z.ZodRecord<z.ZodString, z.ZodObject<{
             versionId: z.ZodString;
             updatedAt: z.ZodString;
@@ -268,73 +268,14 @@ export declare const SuperadminSpaceDetailSchema: z.ZodObject<{
                 bodyEnd: z.ZodOptional<z.ZodArray<z.ZodString>>;
                 noscript: z.ZodOptional<z.ZodArray<z.ZodString>>;
             }, z.core.$strip>>;
+            dataSources: z.ZodOptional<z.ZodPipe<z.ZodUnknown, z.ZodRecord<z.ZodString, z.ZodObject<{
+                kind: z.ZodLiteral<"wordpress">;
+                url: z.ZodString;
+            }, z.core.$strict>>>>;
+            defaultDataSource: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>;
         settingsDigest: z.ZodString;
         noindex: z.ZodBoolean;
-        policy: z.ZodNullable<z.ZodObject<{
-            rules: z.ZodDefault<z.ZodArray<z.ZodObject<{
-                id: z.ZodOptional<z.ZodString>;
-                match: z.ZodDefault<z.ZodObject<{
-                    host: z.ZodOptional<z.ZodString>;
-                    hostPattern: z.ZodOptional<z.ZodString>;
-                    hostTemplate: z.ZodOptional<z.ZodString>;
-                    pathPattern: z.ZodOptional<z.ZodString>;
-                    channel: z.ZodOptional<z.ZodString>;
-                    ipCidrs: z.ZodOptional<z.ZodArray<z.ZodString>>;
-                    agent: z.ZodOptional<z.ZodString>;
-                    country: z.ZodOptional<z.ZodString>;
-                    countryNotIn: z.ZodOptional<z.ZodArray<z.ZodString>>;
-                    header: z.ZodOptional<z.ZodObject<{
-                        name: z.ZodString;
-                        value: z.ZodString;
-                    }, z.core.$strip>>;
-                }, z.core.$strip>>;
-                effect: z.ZodEnum<{
-                    allow: "allow";
-                    deny: "deny";
-                    challenge: "challenge";
-                }>;
-                auth: z.ZodOptional<z.ZodObject<{
-                    requiredGrants: z.ZodArray<z.ZodString>;
-                    issuers: z.ZodOptional<z.ZodArray<z.ZodObject<{
-                        kid: z.ZodString;
-                        alg: z.ZodLiteral<"EdDSA">;
-                        publicKey: z.ZodString;
-                        grantNamespaces: z.ZodArray<z.ZodString>;
-                    }, z.core.$strip>>>;
-                    acquire: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
-                        type: z.ZodLiteral<"password">;
-                        ref: z.ZodString;
-                        transport: z.ZodEnum<{
-                            basic: "basic";
-                            form: "form";
-                        }>;
-                        username: z.ZodOptional<z.ZodString>;
-                    }, z.core.$strip>, z.ZodObject<{
-                        type: z.ZodLiteral<"login">;
-                        url: z.ZodString;
-                        label: z.ZodOptional<z.ZodString>;
-                    }, z.core.$strip>], "type">>>;
-                }, z.core.$strip>>;
-                managedBy: z.ZodOptional<z.ZodEnum<{
-                    sharing: "sharing";
-                    firewall: "firewall";
-                    file_share: "file_share";
-                    cast_reviewer: "cast_reviewer";
-                    team_default: "team_default";
-                }>>;
-                expiresAt: z.ZodOptional<z.ZodNumber>;
-                reasonCode: z.ZodOptional<z.ZodString>;
-                message: z.ZodOptional<z.ZodString>;
-            }, z.core.$strip>>>;
-            issuers: z.ZodOptional<z.ZodArray<z.ZodObject<{
-                kid: z.ZodString;
-                alg: z.ZodLiteral<"EdDSA">;
-                publicKey: z.ZodString;
-                grantNamespaces: z.ZodArray<z.ZodString>;
-            }, z.core.$strip>>>;
-            sessionVersion: z.ZodOptional<z.ZodNumber>;
-        }, z.core.$strip>>;
         operation: z.ZodNullable<z.ZodObject<{
             id: z.ZodString;
             kind: z.ZodString;
@@ -379,6 +320,11 @@ export declare const SuperadminSpaceDetailSchema: z.ZodObject<{
         createdAt: z.ZodString;
         updatedAt: z.ZodString;
     }, z.core.$strip>;
+    access: z.ZodObject<{
+        generation: z.ZodNumber;
+        activeGrantCount: z.ZodNumber;
+        public: z.ZodBoolean;
+    }, z.core.$strict>;
     hostnames: z.ZodArray<z.ZodObject<{
         hostname: z.ZodString;
         url: z.ZodString;
@@ -460,6 +406,14 @@ export declare const SuperadminSpaceDetailSchema: z.ZodObject<{
         updatedAt: z.ZodString;
     }, z.core.$strip>>;
 }, z.core.$strip>;
+export declare const superadminSpaceViewLinkWriteSchema: z.ZodObject<{
+    path: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export declare const SuperadminSpaceViewLinkSchema: z.ZodObject<{
+    landingPath: z.ZodString;
+    expiresAt: z.ZodString;
+    url: z.ZodString;
+}, z.core.$strict>;
 export declare const SuperadminAnonymousSpaceSchema: z.ZodObject<{
     id: z.ZodString;
     tenantId: z.ZodString;
@@ -528,7 +482,6 @@ export declare const SuperadminAnonymousSpaceAssignResponseSchema: z.ZodObject<{
                 abuse_takedown: "abuse_takedown";
                 tenant_suspended: "tenant_suspended";
                 site_suspended: "site_suspended";
-                visit_cap_exceeded: "visit_cap_exceeded";
             }>;
         }, z.core.$strip>>;
         claimState: z.ZodNullable<z.ZodObject<{
@@ -567,6 +520,7 @@ export declare const SuperadminAnonymousSpaceAssignResponseSchema: z.ZodObject<{
             always_hot: "always_hot";
         }>;
         moving: z.ZodBoolean;
+        hasRuntime: z.ZodBoolean;
         channels: z.ZodRecord<z.ZodString, z.ZodObject<{
             versionId: z.ZodString;
             updatedAt: z.ZodString;
@@ -649,73 +603,14 @@ export declare const SuperadminAnonymousSpaceAssignResponseSchema: z.ZodObject<{
                 bodyEnd: z.ZodOptional<z.ZodArray<z.ZodString>>;
                 noscript: z.ZodOptional<z.ZodArray<z.ZodString>>;
             }, z.core.$strip>>;
+            dataSources: z.ZodOptional<z.ZodPipe<z.ZodUnknown, z.ZodRecord<z.ZodString, z.ZodObject<{
+                kind: z.ZodLiteral<"wordpress">;
+                url: z.ZodString;
+            }, z.core.$strict>>>>;
+            defaultDataSource: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>;
         settingsDigest: z.ZodString;
         noindex: z.ZodBoolean;
-        policy: z.ZodNullable<z.ZodObject<{
-            rules: z.ZodDefault<z.ZodArray<z.ZodObject<{
-                id: z.ZodOptional<z.ZodString>;
-                match: z.ZodDefault<z.ZodObject<{
-                    host: z.ZodOptional<z.ZodString>;
-                    hostPattern: z.ZodOptional<z.ZodString>;
-                    hostTemplate: z.ZodOptional<z.ZodString>;
-                    pathPattern: z.ZodOptional<z.ZodString>;
-                    channel: z.ZodOptional<z.ZodString>;
-                    ipCidrs: z.ZodOptional<z.ZodArray<z.ZodString>>;
-                    agent: z.ZodOptional<z.ZodString>;
-                    country: z.ZodOptional<z.ZodString>;
-                    countryNotIn: z.ZodOptional<z.ZodArray<z.ZodString>>;
-                    header: z.ZodOptional<z.ZodObject<{
-                        name: z.ZodString;
-                        value: z.ZodString;
-                    }, z.core.$strip>>;
-                }, z.core.$strip>>;
-                effect: z.ZodEnum<{
-                    allow: "allow";
-                    deny: "deny";
-                    challenge: "challenge";
-                }>;
-                auth: z.ZodOptional<z.ZodObject<{
-                    requiredGrants: z.ZodArray<z.ZodString>;
-                    issuers: z.ZodOptional<z.ZodArray<z.ZodObject<{
-                        kid: z.ZodString;
-                        alg: z.ZodLiteral<"EdDSA">;
-                        publicKey: z.ZodString;
-                        grantNamespaces: z.ZodArray<z.ZodString>;
-                    }, z.core.$strip>>>;
-                    acquire: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
-                        type: z.ZodLiteral<"password">;
-                        ref: z.ZodString;
-                        transport: z.ZodEnum<{
-                            basic: "basic";
-                            form: "form";
-                        }>;
-                        username: z.ZodOptional<z.ZodString>;
-                    }, z.core.$strip>, z.ZodObject<{
-                        type: z.ZodLiteral<"login">;
-                        url: z.ZodString;
-                        label: z.ZodOptional<z.ZodString>;
-                    }, z.core.$strip>], "type">>>;
-                }, z.core.$strip>>;
-                managedBy: z.ZodOptional<z.ZodEnum<{
-                    sharing: "sharing";
-                    firewall: "firewall";
-                    file_share: "file_share";
-                    cast_reviewer: "cast_reviewer";
-                    team_default: "team_default";
-                }>>;
-                expiresAt: z.ZodOptional<z.ZodNumber>;
-                reasonCode: z.ZodOptional<z.ZodString>;
-                message: z.ZodOptional<z.ZodString>;
-            }, z.core.$strip>>>;
-            issuers: z.ZodOptional<z.ZodArray<z.ZodObject<{
-                kid: z.ZodString;
-                alg: z.ZodLiteral<"EdDSA">;
-                publicKey: z.ZodString;
-                grantNamespaces: z.ZodArray<z.ZodString>;
-            }, z.core.$strip>>>;
-            sessionVersion: z.ZodOptional<z.ZodNumber>;
-        }, z.core.$strip>>;
         operation: z.ZodNullable<z.ZodObject<{
             id: z.ZodString;
             kind: z.ZodString;
@@ -767,3 +662,4 @@ export type SuperadminSpaceVersion = z.infer<typeof SuperadminSpaceVersionSchema
 export type SuperadminSpaceDetail = z.infer<typeof SuperadminSpaceDetailSchema>;
 export type SuperadminAnonymousSpace = z.infer<typeof SuperadminAnonymousSpaceSchema>;
 export type SuperadminAnonymousSpaceList = z.infer<typeof SuperadminAnonymousSpaceListSchema>;
+export type SuperadminSpaceViewLink = z.infer<typeof SuperadminSpaceViewLinkSchema>;

package/dist/contracts/superadmin-spaces.js

@@ -1,4 +1,5 @@
 import { z } from "zod";
+import { accessScopePathSchema } from "./access.js";
 import { SpaceSchema } from "./resources.js";
 import { ZERO_RUNTIME_KIND } from "./zero.js";
 const zeroLogLevelSchema = z.enum(["debug", "info", "warn", "error"]);
@@ -77,9 +78,30 @@ export const SuperadminSpaceVersionSchema = z.object({
 });
 export const SuperadminSpaceDetailSchema = z.object({
     space: SpaceSchema,
+    access: z
+        .object({
+        generation: z.number().int().nonnegative(),
+        activeGrantCount: z.number().int().nonnegative(),
+        public: z.boolean(),
+    })
+        .strict(),
     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.
+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.
+export const SuperadminSpaceViewLinkSchema = z
+    .object({
+    landingPath: z.string(),
+    expiresAt: z.string().datetime(),
+    url: z.string().url(),
+})
+    .strict();
 export const SuperadminAnonymousSpaceSchema = z.object({
     id: z.string(),
     tenantId: z.string(),

package/dist/contracts/superadmin-tenants.js

@@ -22,11 +22,11 @@ export const SuperadminProviderClientSchema = z.object({
         .string()
         .nullable()
         .describe("Default PHP version for sites provisioned under this client."),
-    status: providerClientStatus.describe("Whether this client identity may provision sites."),
+    status: providerClientStatus.describe("Whether this client identity can provision sites."),
     tokenHint: z
         .string()
         .nullable()
-        .describe("Masked tail of the stored API token (never the full value)."),
+        .describe("Masked tail of the stored API key (never the full value)."),
     createdAt: z.string().datetime(),
     updatedAt: z.string().datetime(),
 });
@@ -78,11 +78,11 @@ export const SuperadminTenantSchema = z.object({
         .string()
         .datetime()
         .nullable()
-        .describe("Billing grace deadline; present only while status is past_due."),
+        .describe("Billing grace deadline; present only when status is past_due."),
     defaultRegion: z
         .string()
         .nullable()
-        .describe('Default placement region for new sites; null/"auto" lets placement decide.'),
+        .describe('Default placement region for new sites; null or "auto" lets placement decide.'),
     metadata: z.record(z.string(), z.string()).nullable().describe("Operator-attached metadata."),
     providerClient: SuperadminProviderClientSchema.nullable().describe("ProviderClient owned by this tenant; null when the tenant provisions under the first-party client."),
     teamCount: z.number().int().nonnegative(),

package/dist/contracts/superadmin.d.ts

@@ -277,6 +277,10 @@ export declare const superadminAddonCreateSchema: z.ZodObject<{
     note: z.ZodOptional<z.ZodString>;
     expiresAt: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
+export declare const superadminStorageQuotaSetSchema: z.ZodObject<{
+    storageBytes: z.ZodNumber;
+    note: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
 export declare const SuperadminAddonSchema: z.ZodObject<{
     id: z.ZodString;
     teamId: z.ZodString;

package/dist/contracts/superadmin.js

@@ -136,10 +136,23 @@ export const SuperadminPlanGrantListSchema = makeOffsetListSchema("grants", Supe
 export const superadminAddonCreateSchema = z.object({
     team: z.string().trim().min(1).describe("Team id or slug."),
     limit: z.enum(["teamMembers", "subTeams", "storageBytes", "externalDomainGroups"]),
-    amount: z.number().int().positive().describe("Additive amount (seats count, bytes, ...)."),
+    amount: z
+        .number()
+        .int()
+        .positive()
+        .describe("Additive amount (seat count, bytes, and similar units)."),
     note: z.string().trim().max(500).optional(),
     expiresAt: z.string().datetime().optional(),
 });
+export const superadminStorageQuotaSetSchema = z.object({
+    storageBytes: z
+        .number()
+        .int()
+        .positive()
+        .max(Number.MAX_SAFE_INTEGER)
+        .describe("Desired total storage quota in bytes."),
+    note: z.string().trim().max(500).optional(),
+});
 export const SuperadminAddonSchema = z.object({
     id: z.string(),
     teamId: z.string(),

package/dist/contracts/tags.d.ts

@@ -1,10 +1,10 @@
 import { z } from "zod";
 export declare const tagVersionStatusSchema: z.ZodEnum<{
     approved: "approved";
+    published: "published";
     publishing: "publishing";
     draft: "draft";
     in_review: "in_review";
-    published: "published";
     abandoned: "abandoned";
 }>;
 export declare const tagEnvironmentSchema: z.ZodEnum<{
@@ -168,10 +168,10 @@ export declare const tagVersionSchema: z.ZodObject<{
     baseVersionId: z.ZodNullable<z.ZodString>;
     status: z.ZodEnum<{
         approved: "approved";
+        published: "published";
         publishing: "publishing";
         draft: "draft";
         in_review: "in_review";
-        published: "published";
         abandoned: "abandoned";
     }>;
     title: z.ZodString;
@@ -223,10 +223,10 @@ export declare const tagVersionListQuerySchema: z.ZodObject<{
     cursor: z.ZodOptional<z.ZodString>;
     status: z.ZodOptional<z.ZodEnum<{
         approved: "approved";
+        published: "published";
         publishing: "publishing";
         draft: "draft";
         in_review: "in_review";
-        published: "published";
         abandoned: "abandoned";
     }>>;
 }, z.core.$strip>;
@@ -238,10 +238,10 @@ export declare const tagVersionListResponseSchema: z.ZodObject<{
         baseVersionId: z.ZodNullable<z.ZodString>;
         status: z.ZodEnum<{
             approved: "approved";
+            published: "published";
             publishing: "publishing";
             draft: "draft";
             in_review: "in_review";
-            published: "published";
             abandoned: "abandoned";
         }>;
         title: z.ZodString;
@@ -301,10 +301,10 @@ export declare const tagVersionResponseSchema: z.ZodObject<{
         baseVersionId: z.ZodNullable<z.ZodString>;
         status: z.ZodEnum<{
             approved: "approved";
+            published: "published";
             publishing: "publishing";
             draft: "draft";
             in_review: "in_review";
-            published: "published";
             abandoned: "abandoned";
         }>;
         title: z.ZodString;
@@ -617,10 +617,10 @@ export declare const tagApplyResponseSchema: z.ZodObject<{
             baseVersionId: z.ZodNullable<z.ZodString>;
             status: z.ZodEnum<{
                 approved: "approved";
+                published: "published";
                 publishing: "publishing";
                 draft: "draft";
                 in_review: "in_review";
-                published: "published";
                 abandoned: "abandoned";
             }>;
             title: z.ZodString;

package/dist/contracts/tags.js

@@ -357,7 +357,7 @@ export const tagGraphWriteSchema = z
     .object(tagGraphBudgetedShape)
     .strict()
     .superRefine(refineTagGraphBudget)
-    .describe(`Tag graph v1 write input. The server enforces a maximum of ${TAG_GRAPH_MAX_ENCODED_BYTES} encoded bytes, ${TAG_GRAPH_MAX_TAGS} tags, ${TAG_GRAPH_MAX_TRIGGERS} triggers, ${TAG_GRAPH_MAX_VARIABLES} variables, ${TAG_GRAPH_MAX_SYSTEM_MODULES} system modules, ${TAG_GRAPH_MAX_ARRAY_ITEMS} items per nested array, ${TAG_GRAPH_MAX_OBJECT_KEYS} keys per object, ${TAG_GRAPH_MAX_STRING_BYTES} encoded bytes per string, and ${TAG_GRAPH_MAX_DEPTH} nested levels. Unknown top-level fields are rejected.`);
+    .describe(`Tag graph v1 write input. The server enforces these limits: ${TAG_GRAPH_MAX_ENCODED_BYTES} encoded bytes, ${TAG_GRAPH_MAX_TAGS} tags, ${TAG_GRAPH_MAX_TRIGGERS} triggers, ${TAG_GRAPH_MAX_VARIABLES} variables, and ${TAG_GRAPH_MAX_SYSTEM_MODULES} system modules. The server also enforces ${TAG_GRAPH_MAX_ARRAY_ITEMS} items per nested array, ${TAG_GRAPH_MAX_OBJECT_KEYS} keys per object, ${TAG_GRAPH_MAX_STRING_BYTES} encoded bytes per string, and ${TAG_GRAPH_MAX_DEPTH} nested levels. Unknown top-level fields are rejected.`);
 export const emptyTagGraph = {
     format: "spacefast.tag_graph.v1",
     tags: [],

package/dist/contracts/teams.d.ts

@@ -1,15 +1,15 @@
 import { z } from "zod";
 export declare const TEAM_ROLE_VALUES: readonly ["owner", "admin", "member"];
 export declare const teamMemberRole: z.ZodEnum<{
-    admin: "admin";
     owner: "owner";
+    admin: "admin";
     member: "member";
 }>;
 export declare const teamInvitationCreateSchema: z.ZodObject<{
     email: z.ZodString;
     role: z.ZodDefault<z.ZodEnum<{
-        admin: "admin";
         owner: "owner";
+        admin: "admin";
         member: "member";
     }>>;
 }, z.core.$strip>;
@@ -34,8 +34,8 @@ export declare const TeamInvitationSchema: z.ZodObject<{
     teamId: z.ZodString;
     email: z.ZodString;
     role: z.ZodEnum<{
-        admin: "admin";
         owner: "owner";
+        admin: "admin";
         member: "member";
     }>;
     status: z.ZodString;
@@ -55,8 +55,8 @@ export declare const TeamSummarySchema: z.ZodObject<{
     name: z.ZodString;
     slug: z.ZodString;
     role: z.ZodEnum<{
-        admin: "admin";
         owner: "owner";
+        admin: "admin";
         member: "member";
     }>;
     plan: z.ZodEnum<{
@@ -76,8 +76,8 @@ export declare const TeamDetailSchema: z.ZodObject<{
     name: z.ZodString;
     slug: z.ZodString;
     role: z.ZodEnum<{
-        admin: "admin";
         owner: "owner";
+        admin: "admin";
         member: "member";
     }>;
     plan: z.ZodEnum<{
@@ -101,8 +101,8 @@ export declare const teamListResponseSchema: z.ZodObject<{
         name: z.ZodString;
         slug: z.ZodString;
         role: z.ZodEnum<{
-            admin: "admin";
             owner: "owner";
+            admin: "admin";
             member: "member";
         }>;
         plan: z.ZodEnum<{
@@ -127,8 +127,8 @@ export declare const teamMemberListResponseSchema: z.ZodObject<{
         teamId: z.ZodString;
         userId: z.ZodString;
         role: z.ZodEnum<{
-            admin: "admin";
             owner: "owner";
+            admin: "admin";
             member: "member";
         }>;
         createdAt: z.ZodString;
@@ -160,8 +160,8 @@ export declare const teamInvitationAcceptResponseSchema: z.ZodObject<{
         teamSlug: z.ZodString;
         userId: z.ZodString;
         role: z.ZodEnum<{
-            admin: "admin";
             owner: "owner";
+            admin: "admin";
             member: "member";
         }>;
     }, z.core.$strip>;
@@ -172,8 +172,8 @@ export declare const teamInvitationListResponseSchema: z.ZodObject<{
         teamId: z.ZodString;
         email: z.ZodString;
         role: z.ZodEnum<{
-            admin: "admin";
             owner: "owner";
+            admin: "admin";
             member: "member";
         }>;
         status: z.ZodString;

package/dist/contracts/teams.js

@@ -38,9 +38,9 @@ export const TeamInvitationSchema = z.object({
 // tenant, carrying the resolved plan and default data location.
 export const teamPlanCode = planCodeSchema;
 export const TeamSummarySchema = z.object({
-    id: z.string().describe("Team id (the Better Auth team id in the main tenant)."),
-    tenantId: z.string().describe("Owning tenant; ten_main for self-serve teams."),
-    name: z.string().describe("Display name of the team."),
+    id: z.string().describe("The team id (the Better Auth team id in the main tenant)."),
+    tenantId: z.string().describe("The owning tenant id; `ten_main` for self-serve teams."),
+    name: z.string().describe("The team display name."),
     slug: z.string().describe("URL-safe team slug, unique per tenant."),
     role: teamMemberRole.describe("Requesting member's role; member for non-session credentials."),
     plan: teamPlanCode.describe("Resolved plan code from the active subscription."),
@@ -56,7 +56,7 @@ export const TeamDetailSchema = TeamSummarySchema.extend({
     stripeCustomerId: z
         .string()
         .nullable()
-        .describe("Stripe customer id linked to this team, when billing has been initialized."),
+        .describe("Stripe customer id linked to this team; null until billing is initialized."),
 });
 export const teamListResponseSchema = z.object({
     data: z.array(TeamSummarySchema),
@@ -80,13 +80,13 @@ export const teamInvitationAcceptSchema = z.object({
         .string()
         .trim()
         .min(1)
-        .describe("Id of the invitation to accept (the token from the invite link)."),
+        .describe("The invitation id to accept (the token from the invite link)."),
 });
 export const teamInvitationAcceptResponseSchema = z.object({
     data: z.object({
-        teamId: z.string().describe("Id of the team the caller joined."),
+        teamId: z.string().describe("The id of the team the caller joined."),
         teamSlug: z.string().describe("URL-safe slug of the joined team."),
-        userId: z.string().describe("Id of the user that accepted the invitation."),
+        userId: z.string().describe("The id of the user that accepted the invitation."),
         role: teamMemberRole.describe("Role granted by the invitation."),
     }),
 });
@@ -114,7 +114,7 @@ const wpCloudCapabilityOptionSchema = z.object({
 // Served by `GET /v1/teams/{teamId}/settings` (and echoed by the PATCH):
 // the default data location plus the placement options it may take.
 export const teamSettingsResponseSchema = z.object({
-    teamId: z.string().describe("Team the settings belong to."),
+    teamId: z.string().describe("The team id the settings belong to."),
     defaultDataLocation: teamDataLocationSchema,
     regionOptions: z
         .array(wpCloudCapabilityOptionSchema)
@@ -124,12 +124,12 @@ export const teamSettingsResponseSchema = z.object({
         datacenters: z.array(wpCloudCapabilityOptionSchema),
         phpVersions: z.array(wpCloudCapabilityOptionSchema),
     })
-        .describe("Live capabilities for the team's WP.Cloud provider account."),
+        .describe("Live capabilities for the team's infra provider account."),
 });
 // Served by `GET /v1/teams/{teamId}/usage`: counts and metered usage against
 // the named plan limits.
 export const teamUsageResponseSchema = z.object({
-    teamId: z.string().describe("Team the usage was metered for."),
+    teamId: z.string().describe("The team id the usage was metered for."),
     usage: z
         .object({
         spaces: z.number().int().describe("Live spaces in the team."),
@@ -140,18 +140,27 @@ export const teamUsageResponseSchema = z.object({
             .union([z.number(), z.literal("unlimited")])
             .describe('Plan storage quota; "unlimited" when unbounded.'),
         storageOverageBytes: z.number().describe("Bytes over the plan storage quota."),
-        storageCalculatedAt: z.string().nullable().describe("When storage was last accounted."),
+        storageCalculatedAt: z
+            .string()
+            .nullable()
+            .describe("Instant when storage was last accounted."),
         storageOverQuotaSince: z
             .string()
             .nullable()
-            .describe("When the team first went over its storage quota."),
-        storageWarningSentAt: z.string().nullable().describe("When the over-quota warning went out."),
+            .describe("Instant when the team first went over its storage quota."),
+        storageWarningSentAt: z
+            .string()
+            .nullable()
+            .describe("Instant when the over-quota warning went out."),
         buildsDeploysThisMonth: z
             .number()
             .int()
             .describe("Publishes (user pushes and CI builds pooled) this month."),
         buildsDeploysMonthly: planLimitValueSchema.describe("Monthly publish limit for the plan."),
-        meterStartedAt: z.string().nullable().describe("Start of the current metering month."),
+        meterStartedAt: z
+            .string()
+            .nullable()
+            .describe("Instant when the current metering month started."),
     })
         .describe("Usage counters against the named plan limits."),
 });
@@ -162,7 +171,7 @@ export const teamInvitationPreviewSchema = z.object({
     teamName: z.string().describe("Inviting team's display name."),
     invitedEmail: z.string().describe("Masked invited email address."),
     status: z.enum(["pending", "expired", "closed"]).describe("Whether the invite can be accepted."),
-    expiresAt: z.string().describe("When the invitation expires."),
+    expiresAt: z.string().describe("Instant when the invitation expires."),
 });
 export const teamCreateSchema = z.object({
     name: z.string().trim().min(1).max(255).describe("Display name for the new team."),
@@ -173,7 +182,7 @@ export const teamCreateSchema = z.object({
         .max(255)
         .meta({ pattern: "^[a-z0-9][a-z0-9-]*[a-z0-9]$|^[a-z0-9]$" })
         .optional()
-        .describe("Optional URL slug. When omitted, the lowest available slug is generated."),
+        .describe("Optional URL slug. If omitted, the server generates the lowest available slug."),
 });
 export const teamUpdateSchema = z
     .object({

package/dist/contracts/theme-json.js

@@ -44,4 +44,4 @@ export const themeJsonSchema = z
         .optional(),
 })
     .passthrough()
-    .describe("WordPress theme.json-compatible file; only color.palette/typography.fontFamilies infer Pages tokens.");
+    .describe("WordPress theme.json-compatible file. Only settings.color.palette and settings.typography.fontFamilies are used to infer Pages tokens.");

package/dist/contracts/transfers.d.ts

@@ -44,7 +44,6 @@ export declare const spaceTransferSchema: z.ZodObject<{
         tenantId: z.ZodString;
     }, z.core.$strip>;
     status: z.ZodEnum<{
-        moving: "moving";
         pending_confirmation: "pending_confirmation";
         confirming_domains: "confirming_domains";
         completed: "completed";

package/dist/contracts/transfers.js

@@ -10,11 +10,11 @@ export const principalIdSchema = z
     .min(1)
     .max(256)
     .regex(/^[^\s/\\]+$/)
-    .refine((value) => [...value].every((char) => {
+    .refine((value) => Array.from(value).every((char) => {
     const code = char.codePointAt(0) ?? 0;
     return code >= 32 && code !== 127;
 }))
-    .describe("Tenant-local principal id: a team id, or the integrator's own external customer id.");
+    .describe("Tenant-local principal id: a team id or an integrator external customer id.");
 // Request `to` omits tenantId: transfers are tenant-local and the tenant is
 // inferred from the space (internal-docs/platform.md "Transfer semantics").
 export const transferPrincipalInputSchema = z.object({
@@ -34,7 +34,7 @@ export const spaceTransferSchema = z.object({
     id: z.string().describe("SpaceTransfer id (`trf_`)."),
     spaceId: z.string().describe("Space being transferred."),
     from: transferPrincipalSchema.describe("Current owner. Keeps full control, serving, and billing attribution until `completed`."),
-    to: transferPrincipalSchema.describe("Receiving principal; confirm is a to-side action."),
+    to: transferPrincipalSchema.describe("Receiving principal. Confirm is a to-side action."),
     status: spaceTransferStatus.describe("Transfer state. `confirming_domains` waits on re-confirmation of bound domains; a failed move reverts to `pending_confirmation` with a diagnostic (there is no failed state)."),
     // Domain confirmations the receiving principal must complete before the move.
     requiredActions: requiredActionsSchema,
@@ -42,7 +42,7 @@ export const spaceTransferSchema = z.object({
     expiresAt: z
         .string()
         .datetime()
-        .describe("Pending transfers expire after this stamp (default 7 days)."),
+        .describe("Instant when a pending transfer expires (default 7 days)."),
     createdAt: z.string().datetime(),
     updatedAt: z.string().datetime(),
 });