@spacefast/common 0.0.3 → 0.0.6

package/dist/contracts/teams.d.ts

@@ -1,16 +1,15 @@
 import { z } from "zod";
 export declare const TEAM_ROLE_VALUES: readonly ["owner", "admin", "member"];
-export declare const PLAN_FEATURE_VALUES: readonly ["version-diagnostics"];
 export declare const teamMemberRole: z.ZodEnum<{
-    owner: "owner";
     admin: "admin";
+    owner: "owner";
     member: "member";
 }>;
 export declare const teamInvitationCreateSchema: z.ZodObject<{
     email: z.ZodString;
     role: z.ZodDefault<z.ZodEnum<{
-        owner: "owner";
         admin: "admin";
+        owner: "owner";
         member: "member";
     }>>;
 }, z.core.$strip>;
@@ -35,8 +34,8 @@ export declare const TeamInvitationSchema: z.ZodObject<{
     teamId: z.ZodString;
     email: z.ZodString;
     role: z.ZodEnum<{
-        owner: "owner";
         admin: "admin";
+        owner: "owner";
         member: "member";
     }>;
     status: z.ZodString;
@@ -44,11 +43,11 @@ export declare const TeamInvitationSchema: z.ZodObject<{
     createdAt: z.ZodString;
 }, z.core.$strip>;
 export declare const teamPlanCode: z.ZodEnum<{
-    personal: "personal";
+    free: "free";
+    internal: "internal";
     work: "work";
+    personal: "personal";
     enterprise: "enterprise";
-    internal: "internal";
-    free: "free";
 }>;
 export declare const TeamSummarySchema: z.ZodObject<{
     id: z.ZodString;
@@ -56,16 +55,16 @@ export declare const TeamSummarySchema: z.ZodObject<{
     name: z.ZodString;
     slug: z.ZodString;
     role: z.ZodEnum<{
-        owner: "owner";
         admin: "admin";
+        owner: "owner";
         member: "member";
     }>;
     plan: z.ZodEnum<{
-        personal: "personal";
+        free: "free";
+        internal: "internal";
         work: "work";
+        personal: "personal";
         enterprise: "enterprise";
-        internal: "internal";
-        free: "free";
     }>;
     defaultDataLocation: z.ZodString;
     createdAt: z.ZodString;
@@ -77,16 +76,16 @@ export declare const TeamDetailSchema: z.ZodObject<{
     name: z.ZodString;
     slug: z.ZodString;
     role: z.ZodEnum<{
-        owner: "owner";
         admin: "admin";
+        owner: "owner";
         member: "member";
     }>;
     plan: z.ZodEnum<{
-        personal: "personal";
+        free: "free";
+        internal: "internal";
         work: "work";
+        personal: "personal";
         enterprise: "enterprise";
-        internal: "internal";
-        free: "free";
     }>;
     defaultDataLocation: z.ZodString;
     createdAt: z.ZodString;
@@ -102,16 +101,16 @@ export declare const teamListResponseSchema: z.ZodObject<{
         name: z.ZodString;
         slug: z.ZodString;
         role: z.ZodEnum<{
-            owner: "owner";
             admin: "admin";
+            owner: "owner";
             member: "member";
         }>;
         plan: z.ZodEnum<{
-            personal: "personal";
+            free: "free";
+            internal: "internal";
             work: "work";
+            personal: "personal";
             enterprise: "enterprise";
-            internal: "internal";
-            free: "free";
         }>;
         defaultDataLocation: z.ZodString;
         createdAt: z.ZodString;
@@ -128,8 +127,8 @@ export declare const teamMemberListResponseSchema: z.ZodObject<{
         teamId: z.ZodString;
         userId: z.ZodString;
         role: z.ZodEnum<{
-            owner: "owner";
             admin: "admin";
+            owner: "owner";
             member: "member";
         }>;
         createdAt: z.ZodString;
@@ -152,14 +151,29 @@ export declare const teamJoinResponseSchema: z.ZodObject<{
         role: z.ZodLiteral<"member">;
     }, z.core.$strip>;
 }, z.core.$strip>;
+export declare const teamInvitationAcceptSchema: z.ZodObject<{
+    invitationId: z.ZodString;
+}, z.core.$strip>;
+export declare const teamInvitationAcceptResponseSchema: z.ZodObject<{
+    data: z.ZodObject<{
+        teamId: z.ZodString;
+        teamSlug: z.ZodString;
+        userId: z.ZodString;
+        role: z.ZodEnum<{
+            admin: "admin";
+            owner: "owner";
+            member: "member";
+        }>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
 export declare const teamInvitationListResponseSchema: z.ZodObject<{
     data: z.ZodArray<z.ZodObject<{
         id: z.ZodString;
         teamId: z.ZodString;
         email: z.ZodString;
         role: z.ZodEnum<{
-            owner: "owner";
             admin: "admin";
+            owner: "owner";
             member: "member";
         }>;
         status: z.ZodString;
@@ -185,8 +199,8 @@ export declare const teamSettingsResponseSchema: z.ZodObject<{
     wpCloudCapabilities: z.ZodObject<{
         status: z.ZodEnum<{
             failed: "failed";
-            running: "running";
             ready: "ready";
+            running: "running";
             idle: "idle";
         }>;
         degraded: z.ZodBoolean;
@@ -218,12 +232,15 @@ export declare const teamInvitationPreviewSchema: z.ZodObject<{
     teamName: z.ZodString;
     invitedEmail: z.ZodString;
     status: z.ZodEnum<{
-        closed: "closed";
         expired: "expired";
+        closed: "closed";
         pending: "pending";
     }>;
     expiresAt: z.ZodString;
 }, z.core.$strip>;
+export declare const teamCreateSchema: z.ZodObject<{
+    name: z.ZodString;
+}, z.core.$strip>;
 export declare const teamUpdateSchema: z.ZodObject<{
     name: z.ZodOptional<z.ZodString>;
     slug: z.ZodOptional<z.ZodString>;

package/dist/contracts/teams.js

@@ -2,7 +2,6 @@ import { z } from "zod";
 import { CursorPaginationSchema, cursorListQuerySchema } from "./common.js";
 import { planCodeSchema, planLimitValueSchema } from "./features.js";
 export const TEAM_ROLE_VALUES = ["owner", "admin", "member"];
-export const PLAN_FEATURE_VALUES = ["version-diagnostics"];
 export const teamMemberRole = z.enum(TEAM_ROLE_VALUES);
 export const teamInvitationCreateSchema = z.object({
     email: z.string().trim().email().toLowerCase(),
@@ -74,6 +73,23 @@ export const teamJoinResponseSchema = z.object({
         role: z.literal("member"),
     }),
 });
+// Accepting an invitation is by its id (the opaque token carried in the accept
+// email link and returned by the invitations list/preview endpoints).
+export const teamInvitationAcceptSchema = z.object({
+    invitationId: z
+        .string()
+        .trim()
+        .min(1)
+        .describe("Id of the invitation 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."),
+        teamSlug: z.string().describe("URL-safe slug of the joined team."),
+        userId: z.string().describe("Id of the user that accepted the invitation."),
+        role: teamMemberRole.describe("Role granted by the invitation."),
+    }),
+});
 export const teamInvitationListResponseSchema = z.object({
     data: z.array(TeamInvitationSchema),
     pagination: CursorPaginationSchema,
@@ -153,6 +169,9 @@ export const teamInvitationPreviewSchema = z.object({
     status: z.enum(["pending", "expired", "closed"]).describe("Whether the invite can be accepted."),
     expiresAt: z.string().describe("When the invitation expires."),
 });
+export const teamCreateSchema = z.object({
+    name: z.string().trim().min(1).max(255).describe("Display name for the new team."),
+});
 export const teamUpdateSchema = z
     .object({
     name: z.string().trim().min(1).max(255).optional(),

package/dist/contracts/theme-json.d.ts

@@ -0,0 +1,30 @@
+import { z } from "zod";
+export declare const themeJsonColorPaletteEntrySchema: z.ZodObject<{
+    slug: z.ZodString;
+    color: z.ZodString;
+    name: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const themeJsonFontFamilyEntrySchema: z.ZodObject<{
+    slug: z.ZodString;
+    fontFamily: z.ZodString;
+    name: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const themeJsonSchema: z.ZodObject<{
+    settings: z.ZodOptional<z.ZodObject<{
+        color: z.ZodOptional<z.ZodObject<{
+            palette: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                slug: z.ZodString;
+                color: z.ZodString;
+                name: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>>;
+        }, z.core.$loose>>;
+        typography: z.ZodOptional<z.ZodObject<{
+            fontFamilies: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                slug: z.ZodString;
+                fontFamily: z.ZodString;
+                name: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>>;
+        }, z.core.$loose>>;
+    }, z.core.$loose>>;
+}, z.core.$loose>;
+export type ThemeJson = z.infer<typeof themeJsonSchema>;

package/dist/contracts/theme-json.js

@@ -0,0 +1,48 @@
+import { z } from "zod";
+// WordPress `theme.json`-compatible subset (access-plan §8 tier 3, middle
+// precedence: `sf.theme.jsonc` > `theme.json` > `spacefast.jsonc "pages.theme"`).
+// Real WP theme.json carries dozens of unrelated keys (layout, blocks,
+// customTemplates, styles, ...); this schema accepts the file as a loose
+// object (`.passthrough()`) and only VALIDATES the two branches gate pages
+// actually consume: `settings.color.palette` and
+// `settings.typography.fontFamilies`. Everything else rides through
+// unvalidated and is simply never read — this is not a reimplementation of
+// WP_Theme_JSON, just the safe slice that reaches presentation-only gate
+// pages (access-plan §8).
+const presetSlug = z
+    .string()
+    .min(1)
+    .max(64)
+    .regex(/^[a-z0-9-]+$/, { message: "Preset slugs are lowercase alphanumerics and dashes." });
+export const themeJsonColorPaletteEntrySchema = z.object({
+    slug: presetSlug,
+    color: z.string().min(1).max(128),
+    name: z.string().min(1).max(128).optional(),
+});
+export const themeJsonFontFamilyEntrySchema = z.object({
+    slug: presetSlug,
+    fontFamily: z.string().min(1).max(256),
+    name: z.string().min(1).max(128).optional(),
+});
+export const themeJsonSchema = z
+    .object({
+    settings: z
+        .object({
+        color: z
+            .object({
+            palette: z.array(themeJsonColorPaletteEntrySchema).max(64).optional(),
+        })
+            .passthrough()
+            .optional(),
+        typography: z
+            .object({
+            fontFamilies: z.array(themeJsonFontFamilyEntrySchema).max(32).optional(),
+        })
+            .passthrough()
+            .optional(),
+    })
+        .passthrough()
+        .optional(),
+})
+    .passthrough()
+    .describe("WordPress theme.json-compatible file; only color.palette/typography.fontFamilies feed gate pages.");

package/dist/contracts/transfers.d.ts

@@ -2,15 +2,15 @@ import { z } from "zod";
 export declare const principalIdSchema: z.ZodString;
 export declare const transferPrincipalInputSchema: z.ZodObject<{
     principalType: z.ZodEnum<{
-        external: "external";
         team: "team";
+        external: "external";
     }>;
     principalId: z.ZodString;
 }, z.core.$strip>;
 export declare const transferPrincipalSchema: z.ZodObject<{
     principalType: z.ZodEnum<{
-        external: "external";
         team: "team";
+        external: "external";
     }>;
     principalId: z.ZodString;
     tenantId: z.ZodString;
@@ -18,8 +18,8 @@ export declare const transferPrincipalSchema: z.ZodObject<{
 export declare const spaceTransferCreateSchema: z.ZodObject<{
     to: z.ZodObject<{
         principalType: z.ZodEnum<{
-            external: "external";
             team: "team";
+            external: "external";
         }>;
         principalId: z.ZodString;
     }, z.core.$strip>;
@@ -29,27 +29,27 @@ export declare const spaceTransferSchema: z.ZodObject<{
     spaceId: z.ZodString;
     from: z.ZodObject<{
         principalType: z.ZodEnum<{
-            external: "external";
             team: "team";
+            external: "external";
         }>;
         principalId: z.ZodString;
         tenantId: z.ZodString;
     }, z.core.$strip>;
     to: z.ZodObject<{
         principalType: z.ZodEnum<{
-            external: "external";
             team: "team";
+            external: "external";
         }>;
         principalId: z.ZodString;
         tenantId: z.ZodString;
     }, z.core.$strip>;
     status: z.ZodEnum<{
-        completed: "completed";
-        canceled: "canceled";
-        expired: "expired";
         moving: "moving";
         pending_confirmation: "pending_confirmation";
         confirming_domains: "confirming_domains";
+        completed: "completed";
+        canceled: "canceled";
+        expired: "expired";
     }>;
     requiredActions: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
         type: z.ZodLiteral<"dns">;
@@ -90,9 +90,9 @@ export declare const spaceTransferSchema: z.ZodObject<{
         message: z.ZodString;
         path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         provider: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+            registrar: "registrar";
             wpcloud: "wpcloud";
             dns: "dns";
-            registrar: "registrar";
             runtime: "runtime";
         }>>>;
         details: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;

package/dist/contracts/variables.d.ts

@@ -1,16 +1,16 @@
 import { z } from "zod";
 export declare const variableScope: z.ZodEnum<{
-    principal: "principal";
-    space: "space";
     site: "site";
+    space: "space";
+    principal: "principal";
 }>;
 export declare const variableNameSchema: z.ZodString;
 export declare const VariableSchema: z.ZodObject<{
     name: z.ZodString;
     scope: z.ZodEnum<{
-        principal: "principal";
-        space: "space";
         site: "site";
+        space: "space";
+        principal: "principal";
     }>;
     secret: z.ZodBoolean;
     value: z.ZodOptional<z.ZodString>;
@@ -23,8 +23,6 @@ export declare const variableProvenanceSchema: z.ZodArray<z.ZodObject<{
     name: z.ZodString;
     valueHash: z.ZodString;
 }, z.core.$strip>>;
-export type VariableProvenance = z.infer<typeof variableProvenanceSchema>;
-export declare function variableResourceId(scope: z.infer<typeof variableScope>, name: string): string;
 export declare const SystemVariableSchema: z.ZodObject<{
     name: z.ZodString;
     value: z.ZodString;
@@ -49,9 +47,9 @@ export declare const variableListResponseSchema: z.ZodObject<{
     data: z.ZodArray<z.ZodObject<{
         name: z.ZodString;
         scope: z.ZodEnum<{
-            principal: "principal";
-            space: "space";
             site: "site";
+            space: "space";
+            principal: "principal";
         }>;
         secret: z.ZodBoolean;
         value: z.ZodOptional<z.ZodString>;
@@ -68,9 +66,9 @@ export declare const spaceVariableListResponseSchema: z.ZodObject<{
     data: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
         name: z.ZodString;
         scope: z.ZodEnum<{
-            principal: "principal";
-            space: "space";
             site: "site";
+            space: "space";
+            principal: "principal";
         }>;
         secret: z.ZodBoolean;
         value: z.ZodOptional<z.ZodString>;
@@ -91,9 +89,9 @@ export declare const variableMutationResponseSchema: z.ZodObject<{
     data: z.ZodObject<{
         name: z.ZodString;
         scope: z.ZodEnum<{
-            principal: "principal";
-            space: "space";
             site: "site";
+            space: "space";
+            principal: "principal";
         }>;
         secret: z.ZodBoolean;
         value: z.ZodOptional<z.ZodString>;
@@ -106,10 +104,10 @@ export declare const variableMutationResponseSchema: z.ZodObject<{
         kind: z.ZodString;
         status: z.ZodEnum<{
             failed: "failed";
+            canceled: "canceled";
             queued: "queued";
             running: "running";
             succeeded: "succeeded";
-            canceled: "canceled";
         }>;
         resources: z.ZodArray<z.ZodObject<{
             type: z.ZodString;
@@ -130,9 +128,9 @@ export declare const variableMutationResponseSchema: z.ZodObject<{
             message: z.ZodString;
             path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             provider: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+                registrar: "registrar";
                 wpcloud: "wpcloud";
                 dns: "dns";
-                registrar: "registrar";
                 runtime: "runtime";
             }>>>;
             details: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
@@ -150,10 +148,10 @@ export declare const variableDeleteResponseSchema: z.ZodObject<{
         kind: z.ZodString;
         status: z.ZodEnum<{
             failed: "failed";
+            canceled: "canceled";
             queued: "queued";
             running: "running";
             succeeded: "succeeded";
-            canceled: "canceled";
         }>;
         resources: z.ZodArray<z.ZodObject<{
             type: z.ZodString;
@@ -174,9 +172,9 @@ export declare const variableDeleteResponseSchema: z.ZodObject<{
             message: z.ZodString;
             path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             provider: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+                registrar: "registrar";
                 wpcloud: "wpcloud";
                 dns: "dns";
-                registrar: "registrar";
                 runtime: "runtime";
             }>>>;
             details: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;

package/dist/contracts/variables.js

@@ -39,11 +39,6 @@ export const variableProvenanceSchema = z
         .describe("sha256 of the resolved value at finalize time. Never the value itself."),
 }))
     .describe("Variable names + value hashes baked into this version at finalize. Never values.");
-// Operation `resources` entry id for a coalesced variable write
-// (internal-docs/platform.md "Debounce contract"): `{scope}/{name}`.
-export function variableResourceId(scope, name) {
-    return `${scope}/${name}`;
-}
 // Platform-provided, read-only values (SPACEFAST_*) surfaced alongside stored
 // variables on list reads. Not persistable and not a Variable scope.
 export const SystemVariableSchema = z.object({

package/dist/contracts/webhooks.d.ts

@@ -18,8 +18,8 @@ export declare const webhookSchema: z.ZodObject<{
     principal: z.ZodNullable<z.ZodObject<{
         tenantId: z.ZodString;
         principalType: z.ZodEnum<{
-            external: "external";
             team: "team";
+            external: "external";
         }>;
         principalId: z.ZodString;
     }, z.core.$strip>>;
@@ -27,6 +27,7 @@ export declare const webhookSchema: z.ZodObject<{
     events: z.ZodArray<z.ZodString>;
     status: z.ZodEnum<{
         active: "active";
+        deleted: "deleted";
         disabled: "disabled";
         failing: "failing";
     }>;
@@ -47,8 +48,8 @@ export declare const webhookListResponseSchema: z.ZodObject<{
         principal: z.ZodNullable<z.ZodObject<{
             tenantId: z.ZodString;
             principalType: z.ZodEnum<{
-                external: "external";
                 team: "team";
+                external: "external";
             }>;
             principalId: z.ZodString;
         }, z.core.$strip>>;
@@ -56,6 +57,7 @@ export declare const webhookListResponseSchema: z.ZodObject<{
         events: z.ZodArray<z.ZodString>;
         status: z.ZodEnum<{
             active: "active";
+            deleted: "deleted";
             disabled: "disabled";
             failing: "failing";
         }>;
@@ -98,9 +100,9 @@ export declare const webhookDeliverySchema: z.ZodObject<{
         message: z.ZodString;
         path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         provider: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+            registrar: "registrar";
             wpcloud: "wpcloud";
             dns: "dns";
-            registrar: "registrar";
             runtime: "runtime";
         }>>>;
         details: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
@@ -139,9 +141,9 @@ export declare const webhookDeliveryListResponseSchema: z.ZodObject<{
             message: z.ZodString;
             path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             provider: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+                registrar: "registrar";
                 wpcloud: "wpcloud";
                 dns: "dns";
-                registrar: "registrar";
                 runtime: "runtime";
             }>>>;
             details: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;

package/dist/contracts/webhooks.js

@@ -24,7 +24,7 @@ export const webhookSchema = z.object({
         .nullable(),
     url: z.string().url(),
     events: z.array(z.string()),
-    status: z.enum(["active", "disabled", "failing"]),
+    status: z.enum(["active", "disabled", "failing", "deleted"]),
     secret: z.string().optional(),
     secretPreview: z.string(),
     previousSecretExpiresAt: z.string().datetime().nullable(),