@spacefast/common 0.0.24 → 0.2.1

package/dist/contracts/tags.js

@@ -1,6 +1,7 @@
 import { z } from "zod";
+import { normalizeSlug } from "../utils/slug.js";
 import { baseDiagnosticSchema, CursorPaginationSchema, cursorListQuerySchema, dataEnvelope, } from "./common.js";
-export const tagVersionStatusSchema = z.enum([
+export const tagRevisionStatusSchema = z.enum([
     "draft",
     "in_review",
     "approved",
@@ -21,6 +22,10 @@ export const TAG_PRIVACY_SIGNAL_CONSENT_CATEGORIES = [
     "marketing",
     "personalization",
 ];
+// `defaultGranted` is the non-GDPR default. `requiresConsentInGdprCountries`
+// mirrors wpcom's per-tracker flag of the same name: inside the GDPR zone the
+// category is denied until the visitor explicitly grants it, and the zone check
+// fails closed on unknown geo (see `isGdprCountry` in utils/privacy-regions).
 export const TAG_CONSENT_CATEGORY_DEFINITIONS = [
     {
         id: "necessary",
@@ -29,6 +34,7 @@ export const TAG_CONSENT_CATEGORY_DEFINITIONS = [
         defaultGranted: true,
         required: true,
         privacySignalDefaultDenied: false,
+        requiresConsentInGdprCountries: false,
     },
     {
         id: "functional",
@@ -37,6 +43,7 @@ export const TAG_CONSENT_CATEGORY_DEFINITIONS = [
         defaultGranted: true,
         required: false,
         privacySignalDefaultDenied: false,
+        requiresConsentInGdprCountries: false,
     },
     {
         id: "analytics",
@@ -45,6 +52,7 @@ export const TAG_CONSENT_CATEGORY_DEFINITIONS = [
         defaultGranted: true,
         required: false,
         privacySignalDefaultDenied: true,
+        requiresConsentInGdprCountries: true,
     },
     {
         id: "marketing",
@@ -53,6 +61,7 @@ export const TAG_CONSENT_CATEGORY_DEFINITIONS = [
         defaultGranted: true,
         required: false,
         privacySignalDefaultDenied: true,
+        requiresConsentInGdprCountries: true,
     },
     {
         id: "personalization",
@@ -61,6 +70,7 @@ export const TAG_CONSENT_CATEGORY_DEFINITIONS = [
         defaultGranted: true,
         required: false,
         privacySignalDefaultDenied: true,
+        requiresConsentInGdprCountries: true,
     },
 ];
 export const TAG_CONSENT_CATEGORY_IDS = TAG_CONSENT_CATEGORY_DEFINITIONS.map((category) => category.id);
@@ -75,6 +85,7 @@ export const tagConsentPolicySchema = z.object({
         defaultGranted: z.boolean(),
         required: z.boolean().default(false),
         privacySignalDefaultDenied: z.boolean().default(false),
+        requiresConsentInGdprCountries: z.boolean().default(false),
     }))
         .default(Object.fromEntries(TAG_CONSENT_CATEGORY_DEFINITIONS.map((category) => [
         category.id,
@@ -84,6 +95,7 @@ export const tagConsentPolicySchema = z.object({
             defaultGranted: category.defaultGranted,
             required: category.required,
             privacySignalDefaultDenied: category.privacySignalDefaultDenied,
+            requiresConsentInGdprCountries: category.requiresConsentInGdprCountries,
         },
     ]))),
     defaultByCategory: z.record(z.string(), z.boolean()).default(DEFAULT_TAG_CONSENT_DEFAULTS),
@@ -336,7 +348,7 @@ export const tagGraphSchema = z
     consentPolicy: z.record(z.string(), z.unknown()).optional(),
 })
     .passthrough();
-const tagGraphBudgetedShape = {
+const tagGraphBudgetedFields = {
     format: z.literal("spacefast.tag_graph.v1").default("spacefast.tag_graph.v1"),
     tags: z.array(z.record(z.string(), z.unknown())).max(TAG_GRAPH_MAX_TAGS).default([]),
     triggers: z.array(z.record(z.string(), z.unknown())).max(TAG_GRAPH_MAX_TRIGGERS).default([]),
@@ -350,11 +362,11 @@ const tagGraphBudgetedShape = {
     consentPolicy: z.record(z.string(), z.unknown()).optional(),
 };
 export const tagGraphCloneSchema = z
-    .object(tagGraphBudgetedShape)
+    .object(tagGraphBudgetedFields)
     .passthrough()
     .superRefine(refineTagGraphBudget);
 export const tagGraphWriteSchema = z
-    .object(tagGraphBudgetedShape)
+    .object(tagGraphBudgetedFields)
     .strict()
     .superRefine(refineTagGraphBudget)
     .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.`);
@@ -371,12 +383,12 @@ export const tagValidationResultSchema = z.object({
     requiredApprovals: z.array(z.string()),
     graphRevision: z.number().int().positive(),
 });
-export const tagVersionSchema = z.object({
+export const tagRevisionSchema = z.object({
     id: z.string(),
     tagSetId: z.string(),
-    versionNumber: z.number().int().positive(),
-    baseVersionId: z.string().nullable(),
-    status: tagVersionStatusSchema,
+    revisionNumber: z.number().int().positive(),
+    baseRevisionId: z.string().nullable(),
+    status: tagRevisionStatusSchema,
     title: z.string(),
     description: z.string().nullable(),
     graph: tagGraphSchema,
@@ -391,26 +403,28 @@ export const tagVersionSchema = z.object({
     publishedAt: z.string().nullable(),
     immutableAt: z.string().nullable(),
 });
-export const tagVersionListQuerySchema = cursorListQuerySchema.extend({
-    status: tagVersionStatusSchema.optional(),
+export const tagRevisionListQuerySchema = cursorListQuerySchema.extend({
+    status: tagRevisionStatusSchema
+        .optional()
+        .describe("Return only revisions in this review state."),
 });
-export const tagVersionListResponseSchema = z.object({
-    data: z.array(tagVersionSchema),
+export const tagRevisionListResponseSchema = z.object({
+    data: z.array(tagRevisionSchema),
     pagination: CursorPaginationSchema,
 });
-export const tagVersionResponseSchema = dataEnvelope(tagVersionSchema);
-export const tagVersionCreateSchema = z.object({
-    title: z.string().trim().min(1).max(255).default("Draft tag version"),
+export const tagRevisionResponseSchema = dataEnvelope(tagRevisionSchema);
+export const tagRevisionCreateSchema = z.object({
+    title: z.string().trim().min(1).max(255).default("Draft tag revision"),
     description: z.string().trim().max(4_000).nullable().optional(),
-    baseVersionId: z.string().trim().min(1).nullable().optional(),
+    baseRevisionId: z.string().trim().min(1).nullable().optional(),
     graph: tagGraphWriteSchema.optional(),
 });
-export const tagVersionPatchSchema = z.object({
+export const tagRevisionPatchSchema = z.object({
     title: z.string().trim().min(1).max(255).optional(),
     description: z.string().trim().max(4_000).nullable().optional(),
 });
 export const tagGraphResponseSchema = dataEnvelope(z.object({
-    versionId: z.string(),
+    revisionId: z.string(),
     graph: tagGraphSchema,
     graphRevision: z.number().int().positive(),
 }));
@@ -429,8 +443,8 @@ export const tagGraphPatchSchema = z.object({
 });
 export const tagValidateResponseSchema = dataEnvelope(tagValidationResultSchema);
 export const tagDiffSchema = z.object({
-    baseVersionId: z.string().nullable(),
-    targetVersionId: z.string(),
+    baseRevisionId: z.string().nullable(),
+    targetRevisionId: z.string(),
     addedTagIds: z.array(z.string()),
     removedTagIds: z.array(z.string()),
     changedTagIds: z.array(z.string()),
@@ -441,8 +455,8 @@ export const tagReleaseSchema = z.object({
     id: z.string(),
     tagSetId: z.string(),
     environment: tagEnvironmentSchema,
-    versionId: z.string(),
-    previousVersionId: z.string().nullable(),
+    revisionId: z.string(),
+    previousRevisionId: z.string().nullable(),
     sdkRevision: z.string(),
     staticDigest: z.string(),
     releaseNotes: z.string().nullable(),
@@ -483,7 +497,7 @@ export const tagInheritancePatchSchema = z.object({
 export const tagActivityEventSchema = z.object({
     id: z.string(),
     type: z.string(),
-    versionId: z.string().nullable(),
+    revisionId: z.string().nullable(),
     environment: tagEnvironmentSchema.nullable(),
     message: z.string(),
     actor: z.record(z.string(), z.unknown()).nullable(),
@@ -496,8 +510,8 @@ export const tagEffectiveTagResponseSchema = dataEnvelope(z.object({
     source: z.enum(["system", "team", "space", "unknown"]),
 }));
 export const tagReleasePutSchema = z.object({
-    versionId: z.string().trim().min(1),
-    expectedCurrentVersionId: z.string().trim().min(1).nullable().optional(),
+    revisionId: z.string().trim().min(1),
+    expectedCurrentRevisionId: z.string().trim().min(1).nullable().optional(),
     releaseNotes: z.string().trim().max(4_000).nullable().optional(),
 });
 export const tagApplySchema = z.object({
@@ -506,10 +520,10 @@ export const tagApplySchema = z.object({
     description: z.string().trim().max(4_000).nullable().optional(),
     submit: z.boolean().default(false),
     releaseEnvironment: tagEnvironmentSchema.optional(),
-    expectedCurrentVersionId: z.string().trim().min(1).nullable().optional(),
+    expectedCurrentRevisionId: z.string().trim().min(1).nullable().optional(),
 });
 export const tagApplyResponseSchema = dataEnvelope(z.object({
-    version: tagVersionSchema,
+    revision: tagRevisionSchema,
     validation: tagValidationResultSchema,
     release: tagReleaseSchema
         .extend({
@@ -525,7 +539,7 @@ export const tagApplyResponseSchema = dataEnvelope(z.object({
 }));
 export const tagPreviewSessionSchema = z.object({
     id: z.string(),
-    versionId: z.string(),
+    revisionId: z.string(),
     environment: tagEnvironmentSchema,
     previewUrl: z.string(),
     sdkRevision: z.string(),
@@ -536,6 +550,7 @@ export const tagPreviewSessionSchema = z.object({
     revokedAt: z.string().nullable(),
 });
 export const tagPreviewSessionResponseSchema = dataEnvelope(tagPreviewSessionSchema);
+export const tagPreviewSessionListResponseSchema = dataEnvelope(z.array(tagPreviewSessionSchema));
 export const tagPreviewSessionCreateSchema = z.object({
     url: z.string().url().optional(),
     ttlSeconds: z.number().int().min(60).max(86_400).default(3_600),
@@ -658,7 +673,7 @@ export const tagTemplateListResponseSchema = dataEnvelope(z.object({
 }));
 export const tagConsentPolicyResponseSchema = dataEnvelope(z.object({
     environment: tagEnvironmentSchema,
-    versionId: z.string().nullable(),
+    revisionId: z.string().nullable(),
     graphRevision: z.number().int().nonnegative(),
     policy: tagConsentPolicySchema,
 }));
@@ -883,12 +898,7 @@ function templateFieldValue(config, key) {
     return typeof value === "string" ? value.trim() : "";
 }
 export function safeTagIdPart(value) {
-    return value
-        .trim()
-        .toLowerCase()
-        .replace(/[^a-z0-9]+/g, "-")
-        .replace(/^-+|-+$/g, "")
-        .slice(0, 64);
+    return normalizeSlug(value, { maxLength: 64 });
 }
 function htmlScript(code) {
     return /^\s*<script\b[^>]*>[\s\S]*<\/script>\s*$/i.test(code)
@@ -1224,12 +1234,12 @@ export function tagGraphFromTemplateSelections(selections) {
 export const tagEffectiveResponseSchema = dataEnvelope(z.object({
     tagSetId: z.string().nullable(),
     environment: tagEnvironmentSchema,
-    versionId: z.string().nullable(),
+    revisionId: z.string().nullable(),
     graph: tagGraphSchema,
     graphRevision: z.number().int().nonnegative(),
     sdkRevision: z.string().nullable(),
     sources: z.array(z.object({
         type: z.enum(["team", "space", "system"]),
-        versionId: z.string().nullable(),
+        revisionId: z.string().nullable(),
     })),
 }));

package/dist/contracts/teams.d.ts

@@ -1,21 +1,21 @@
 import { z } from "zod";
 export declare const TEAM_ROLE_VALUES: readonly ["owner", "admin", "member"];
 export declare const teamMemberRole: z.ZodEnum<{
-    owner: "owner";
     admin: "admin";
+    owner: "owner";
     member: "member";
 }>;
 /**
- * Better Auth stores the member role as free text, so every surface that reads
- * it back has to land on the same canonical value. Unknown roles carry no
- * privilege, so they read as the least-privileged one.
+ * Better Auth stores the member role as free text. Unknown roles carry no
+ * privilege, so they read as `member`.
  */
-export declare function normalizeTeamMemberRole(role: string | null | undefined): "owner" | "admin" | "member";
+export declare function normalizeTeamMemberRole(role: string | null | undefined): "admin" | "owner" | "member";
 export declare const teamInvitationCreateSchema: z.ZodObject<{
+    teamId: z.ZodString;
     email: z.ZodString;
     role: z.ZodDefault<z.ZodEnum<{
-        owner: "owner";
         admin: "admin";
+        owner: "owner";
         member: "member";
     }>>;
 }, z.core.$strip>;
@@ -26,6 +26,7 @@ export declare const teamMemberListQuerySchema: z.ZodObject<{
 export declare const teamInvitationListQuerySchema: z.ZodObject<{
     limit: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
     cursor: z.ZodOptional<z.ZodString>;
+    teamId: z.ZodString;
 }, z.core.$strip>;
 export declare const teamListQuerySchema: z.ZodObject<{
     limit: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
@@ -46,8 +47,8 @@ export declare const TeamMemberSchema: z.ZodObject<{
     teamId: z.ZodString;
     userId: z.ZodString;
     role: z.ZodEnum<{
-        owner: "owner";
         admin: "admin";
+        owner: "owner";
         member: "member";
     }>;
     createdAt: z.ZodString;
@@ -60,22 +61,50 @@ export declare const TeamMemberSchema: z.ZodObject<{
 }, z.core.$strip>;
 export declare const teamMemberRoleUpdateSchema: z.ZodObject<{
     role: z.ZodEnum<{
-        owner: "owner";
         admin: "admin";
+        owner: "owner";
         member: "member";
     }>;
 }, z.core.$strip>;
 export type TeamMember = z.infer<typeof TeamMemberSchema>;
+/**
+ * The one invitation status vocabulary, shared by the collection and the by-id
+ * read. Better Auth's organization plugin owns the stored column and writes
+ * `pending | accepted | rejected | canceled`; `expired` is derived, because a
+ * still-pending invitation past `expiresAt` can never be accepted and no writer
+ * ever rewrites the row.
+ */
+export declare const teamInvitationStatus: z.ZodEnum<{
+    canceled: "canceled";
+    expired: "expired";
+    pending: "pending";
+    accepted: "accepted";
+    rejected: "rejected";
+}>;
+export type TeamInvitationStatus = z.infer<typeof teamInvitationStatus>;
+/**
+ * The stored column is free text over a closed domain. An unrecognized value is
+ * not something a recipient may act on, so it fails closed to `canceled` —
+ * never `pending` (which would offer a dead link) and never `accepted` (which
+ * would claim a membership nobody holds).
+ */
+export declare function normalizeTeamInvitationStatus(status: string | null | undefined): "canceled" | "expired" | "pending" | "accepted" | "rejected";
 export declare const TeamInvitationSchema: 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;
+    status: z.ZodEnum<{
+        canceled: "canceled";
+        expired: "expired";
+        pending: "pending";
+        accepted: "accepted";
+        rejected: "rejected";
+    }>;
     expiresAt: z.ZodString;
     createdAt: z.ZodString;
 }, z.core.$strip>;
@@ -93,8 +122,8 @@ 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<{
@@ -114,8 +143,8 @@ 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<{
@@ -131,6 +160,30 @@ export declare const TeamDetailSchema: z.ZodObject<{
     logo: z.ZodNullable<z.ZodString>;
     metadata: z.ZodNullable<z.ZodString>;
     stripeCustomerId: z.ZodNullable<z.ZodString>;
+    systemSpaceId: z.ZodNullable<z.ZodString>;
+    manifestStatus: z.ZodObject<{
+        items: z.ZodArray<z.ZodObject<{
+            key: z.ZodString;
+            state: z.ZodEnum<{
+                active: "active";
+                failed: "failed";
+                pending: "pending";
+            }>;
+            detail: z.ZodOptional<z.ZodString>;
+            since: z.ZodString;
+            audience: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        sourceVersionId: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>;
+    presentation: z.ZodNullable<z.ZodObject<{
+        name: z.ZodOptional<z.ZodString>;
+        logo: z.ZodOptional<z.ZodString>;
+        supportUrl: z.ZodOptional<z.ZodString>;
+        claimOrigin: z.ZodOptional<z.ZodString>;
+        accessHandoffOrigin: z.ZodOptional<z.ZodString>;
+        problemDocsBaseUrl: z.ZodOptional<z.ZodString>;
+        contacts: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, z.core.$strict>>;
 }, z.core.$strip>;
 export declare const teamListResponseSchema: z.ZodObject<{
     data: z.ZodArray<z.ZodObject<{
@@ -139,8 +192,8 @@ 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<{
@@ -165,8 +218,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;
@@ -189,7 +242,7 @@ export declare const teamJoinResponseSchema: z.ZodObject<{
         role: z.ZodLiteral<"member">;
     }, z.core.$strip>;
 }, z.core.$strip>;
-export declare const teamInvitationAcceptSchema: z.ZodObject<{
+export declare const teamInvitationParamsSchema: z.ZodObject<{
     invitationId: z.ZodString;
 }, z.core.$strip>;
 export declare const teamInvitationAcceptResponseSchema: z.ZodObject<{
@@ -198,8 +251,8 @@ export declare const teamInvitationAcceptResponseSchema: z.ZodObject<{
         teamSlug: z.ZodString;
         userId: z.ZodString;
         role: z.ZodEnum<{
-            owner: "owner";
             admin: "admin";
+            owner: "owner";
             member: "member";
         }>;
     }, z.core.$strip>;
@@ -210,11 +263,17 @@ export declare const teamInvitationListResponseSchema: z.ZodObject<{
         teamId: z.ZodString;
         email: z.ZodString;
         role: z.ZodEnum<{
-            owner: "owner";
             admin: "admin";
+            owner: "owner";
             member: "member";
         }>;
-        status: z.ZodString;
+        status: z.ZodEnum<{
+            canceled: "canceled";
+            expired: "expired";
+            pending: "pending";
+            accepted: "accepted";
+            rejected: "rejected";
+        }>;
         expiresAt: z.ZodString;
         createdAt: z.ZodString;
     }, z.core.$strip>>;
@@ -234,15 +293,12 @@ export declare const teamSettingsResponseSchema: z.ZodObject<{
         id: z.ZodString;
         label: z.ZodString;
     }, z.core.$strip>>;
-    wpCloudCapabilities: z.ZodObject<{
+    infraCapabilities: z.ZodObject<{
         datacenters: z.ZodArray<z.ZodObject<{
             id: z.ZodString;
             label: z.ZodString;
         }, z.core.$strip>>;
-        phpVersions: z.ZodArray<z.ZodObject<{
-            id: z.ZodString;
-            label: z.ZodString;
-        }, z.core.$strip>>;
+        phpVersion: z.ZodLiteral<"8.5">;
     }, z.core.$strip>;
 }, z.core.$strip>;
 export declare const teamUsageResponseSchema: z.ZodObject<{
@@ -266,14 +322,16 @@ export declare const teamUsageResponseSchema: z.ZodObject<{
         storageBytes: z.ZodNumber;
     }, z.core.$strip>>;
 }, z.core.$strip>;
-export declare const teamInvitationPreviewSchema: z.ZodObject<{
+export declare const teamInvitationDetailSchema: z.ZodObject<{
     id: z.ZodString;
     teamName: z.ZodString;
-    invitedEmail: z.ZodString;
+    email: z.ZodString;
     status: z.ZodEnum<{
+        canceled: "canceled";
         expired: "expired";
-        closed: "closed";
         pending: "pending";
+        accepted: "accepted";
+        rejected: "rejected";
     }>;
     expiresAt: z.ZodString;
 }, z.core.$strip>;
@@ -287,4 +345,6 @@ export declare const teamUpdateSchema: z.ZodObject<{
     logo: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     metadata: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     defaultDataLocation: z.ZodOptional<z.ZodString>;
+    systemSpaceId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    baseSystemSpaceId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
 }, z.core.$strip>;