@spacefast/common 0.0.13 → 0.0.18

package/dist/contracts/tags.d.ts

@@ -8,8 +8,8 @@ export declare const tagVersionStatusSchema: z.ZodEnum<{
     abandoned: "abandoned";
 }>;
 export declare const tagEnvironmentSchema: z.ZodEnum<{
-    preview: "preview";
     production: "production";
+    preview: "preview";
     development: "development";
 }>;
 export declare const tagConsentCategorySchema: z.ZodEnum<{
@@ -460,8 +460,8 @@ export declare const tagReleaseSchema: z.ZodObject<{
     id: z.ZodString;
     tagSetId: z.ZodString;
     environment: z.ZodEnum<{
-        preview: "preview";
         production: "production";
+        preview: "preview";
         development: "development";
     }>;
     versionId: z.ZodString;
@@ -476,8 +476,8 @@ export declare const tagReleaseListResponseSchema: z.ZodObject<{
         id: z.ZodString;
         tagSetId: z.ZodString;
         environment: z.ZodEnum<{
-            preview: "preview";
             production: "production";
+            preview: "preview";
             development: "development";
         }>;
         versionId: z.ZodString;
@@ -493,8 +493,8 @@ export declare const tagReleaseResponseSchema: z.ZodObject<{
         id: z.ZodString;
         tagSetId: z.ZodString;
         environment: z.ZodEnum<{
-            preview: "preview";
             production: "production";
+            preview: "preview";
             development: "development";
         }>;
         versionId: z.ZodString;
@@ -552,8 +552,8 @@ export declare const tagActivityEventSchema: z.ZodObject<{
     type: z.ZodString;
     versionId: z.ZodNullable<z.ZodString>;
     environment: z.ZodNullable<z.ZodEnum<{
-        preview: "preview";
         production: "production";
+        preview: "preview";
         development: "development";
     }>>;
     message: z.ZodString;
@@ -566,8 +566,8 @@ export declare const tagActivityResponseSchema: z.ZodObject<{
         type: z.ZodString;
         versionId: z.ZodNullable<z.ZodString>;
         environment: z.ZodNullable<z.ZodEnum<{
-            preview: "preview";
             production: "production";
+            preview: "preview";
             development: "development";
         }>>;
         message: z.ZodString;
@@ -579,8 +579,8 @@ export declare const tagEffectiveTagResponseSchema: z.ZodObject<{
     data: z.ZodObject<{
         tag: z.ZodRecord<z.ZodString, z.ZodUnknown>;
         environment: z.ZodEnum<{
-            preview: "preview";
             production: "production";
+            preview: "preview";
             development: "development";
         }>;
         source: z.ZodEnum<{
@@ -602,8 +602,8 @@ export declare const tagApplySchema: z.ZodObject<{
     description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     submit: z.ZodDefault<z.ZodBoolean>;
     releaseEnvironment: z.ZodOptional<z.ZodEnum<{
-        preview: "preview";
         production: "production";
+        preview: "preview";
         development: "development";
     }>>;
     expectedCurrentVersionId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -695,8 +695,8 @@ export declare const tagApplyResponseSchema: z.ZodObject<{
             id: z.ZodString;
             tagSetId: z.ZodString;
             environment: z.ZodEnum<{
-                preview: "preview";
                 production: "production";
+                preview: "preview";
                 development: "development";
             }>;
             versionId: z.ZodString;
@@ -722,8 +722,8 @@ export declare const tagPreviewSessionSchema: z.ZodObject<{
     id: z.ZodString;
     versionId: z.ZodString;
     environment: z.ZodEnum<{
-        preview: "preview";
         production: "production";
+        preview: "preview";
         development: "development";
     }>;
     previewUrl: z.ZodString;
@@ -741,8 +741,8 @@ export declare const tagPreviewSessionResponseSchema: z.ZodObject<{
         id: z.ZodString;
         versionId: z.ZodString;
         environment: z.ZodEnum<{
-            preview: "preview";
             production: "production";
+            preview: "preview";
             development: "development";
         }>;
         previewUrl: z.ZodString;
@@ -760,8 +760,8 @@ export declare const tagPreviewSessionCreateSchema: z.ZodObject<{
     url: z.ZodOptional<z.ZodString>;
     ttlSeconds: z.ZodDefault<z.ZodNumber>;
     environment: z.ZodDefault<z.ZodEnum<{
-        preview: "preview";
         production: "production";
+        preview: "preview";
         development: "development";
     }>>;
 }, z.core.$strip>;
@@ -769,8 +769,8 @@ export declare const tagDebugSessionCreateSchema: z.ZodObject<{
     url: z.ZodOptional<z.ZodString>;
     ttlSeconds: z.ZodDefault<z.ZodNumber>;
     environment: z.ZodDefault<z.ZodEnum<{
-        preview: "preview";
         production: "production";
+        preview: "preview";
         development: "development";
     }>>;
 }, z.core.$strip>;
@@ -905,8 +905,8 @@ export declare const tagTemplateSelectionSchema: z.ZodObject<{
         personalization: "personalization";
     }>>>;
     environments: z.ZodOptional<z.ZodArray<z.ZodEnum<{
-        preview: "preview";
         production: "production";
+        preview: "preview";
         development: "development";
     }>>>;
     schedule: z.ZodOptional<z.ZodObject<{
@@ -994,8 +994,8 @@ export declare const tagTemplateListResponseSchema: z.ZodObject<{
 export declare const tagConsentPolicyResponseSchema: z.ZodObject<{
     data: z.ZodObject<{
         environment: z.ZodEnum<{
-            preview: "preview";
             production: "production";
+            preview: "preview";
             development: "development";
         }>;
         versionId: z.ZodNullable<z.ZodString>;
@@ -1077,8 +1077,8 @@ export declare const tagTemplateGraphSchema: z.ZodObject<{
             personalization: "personalization";
         }>>>;
         environments: z.ZodOptional<z.ZodArray<z.ZodEnum<{
-            preview: "preview";
             production: "production";
+            preview: "preview";
             development: "development";
         }>>>;
         schedule: z.ZodOptional<z.ZodObject<{
@@ -1144,8 +1144,8 @@ export declare const tagEffectiveResponseSchema: z.ZodObject<{
     data: z.ZodObject<{
         tagSetId: z.ZodNullable<z.ZodString>;
         environment: z.ZodEnum<{
-            preview: "preview";
             production: "production";
+            preview: "preview";
             development: "development";
         }>;
         versionId: z.ZodNullable<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.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.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(),
 });

package/dist/contracts/variables.js

@@ -24,8 +24,8 @@ export const VariableSchema = z.object({
         .record(z.string(), z.string())
         .optional()
         .describe("Per-channel overrides compiled into channel template variants; omitted for secrets."),
-    createdAt: z.string().datetime().describe("When the variable was created."),
-    updatedAt: z.string().datetime().describe("When the value was last written."),
+    createdAt: z.string().datetime().describe("Instant when the variable was created."),
+    updatedAt: z.string().datetime().describe("Instant when the value was last written."),
 });
 // Version provenance (internal-docs/platform.md "Variable rules"): versions
 // record which variable names and value hashes they were finalized with —
@@ -37,7 +37,7 @@ export const variableProvenanceSchema = z
     name: z.string().describe("Variable name the version was finalized with."),
     valueHash: z
         .string()
-        .describe("sha256 of the resolved value at finalize time. Never the value itself."),
+        .describe("SHA-256 of the resolved value at finalize time. Never the value itself."),
 }))
     .describe("Variable names + value hashes baked into this version at finalize. Never values.");
 // Platform-provided, read-only values (SPACEFAST_*) surfaced alongside stored