@spacefast/common 0.0.11 → 0.0.13

package/dist/contracts/spaces.js

@@ -1,32 +1,29 @@
 import { z } from "zod";
+import { SPACE_SLUG_MAX_LENGTH } from "../slug-policy/index.js";
+import { openHandoffSchema } from "./access.js";
 import { AsyncOperationSchema, baseDiagnosticSchema, CursorPaginationSchema, cursorListQuerySchema, } from "./common.js";
 import { versionStatus, spaceStatus } from "./enums.js";
+import { runtimeKindSchema } from "./execution.js";
 import { conventionFilesSchema, uploadInstructionsSchema, manifestFileSchema } from "./internal.js";
-import { ChannelPointerSchema, VersionSchema, PublishSourceSchema, SpaceSchema, spaceSettingsDigestSchema, } from "./resources.js";
+import { VersionSchema, PublishSourceSchema, SpaceSchema, spaceSettingsDigestSchema, } from "./resources.js";
+import { runtimeAppSchema } from "./runtime-app.js";
 import { spaceConfigSchema, spacePlacementConfigSchema } from "./space-config.js";
 import { principalIdSchema } from "./transfers.js";
-import { zeroRuntimeKindSchema } from "./zero.js";
-export const AnonymousSpaceAccessSchema = z.object({
-    claimToken: z
+export const spaceClaimReceiptSchema = z.object({
+    token: z
         .string()
-        .nullable()
+        .min(1)
         .describe("One-time, space-scoped credential returned only at anonymous space creation. Save it immediately — it is never shown again and is required to publish and manage the space until it is claimed."),
-    claimUrl: z
+    url: z
         .string()
-        .nullable()
+        .url()
         .describe("Browser-only claim link in `/claim#nonce` form. The fragment is a human handoff capability; API clients use the claim token as bearer auth for publish/update/status/exchange."),
-    expiresAt: z
-        .string()
-        .datetime()
-        .nullable()
-        .describe("When the unclaimed space expires if nobody publishes to it or claims it."),
-    warning: z
-        .string()
-        .describe("Human-readable notice explaining that the space is anonymous and will expire unless claimed."),
+    expiresAt: z.string().datetime(),
 });
 export const SpaceCreateResponseSchema = z.object({
     space: SpaceSchema,
-    anonymousAccess: AnonymousSpaceAccessSchema.optional(),
+    open: openHandoffSchema,
+    claim: spaceClaimReceiptSchema.optional(),
 });
 // Stored per-version diagnostic surfaced on the space diagnostics feed: the shared
 // Diagnostic shape (contracts/common.ts) plus persistence identity.
@@ -70,6 +67,12 @@ export const spaceCreateSchema = z
 export const spacePatchSchema = z
     .object({
     title: z.string().min(1).max(255).optional(),
+    slug: z
+        .string()
+        .min(2)
+        .max(SPACE_SLUG_MAX_LENGTH)
+        .optional()
+        .describe("Renames the space and its managed view.fast hostname. Send slug by itself. Previously managed hostnames keep a temporary, path- and query-preserving 307 redirect to the current hostname; immutable version URLs do not change."),
     config: spaceConfigSchema
         .nullable()
         .optional()
@@ -87,21 +90,16 @@ export const spacePatchSchema = z
         .boolean()
         .optional()
         .describe("Hide the live production site from search engines. Applies only to claimed spaces' live hostnames; preview and version hostnames are always noindex."),
-    password: z
-        .string()
-        .min(1)
-        .max(255)
-        .nullable()
-        .optional()
-        .describe("Sets (string) or removes (null) space password protection."),
 })
-    // Strict so an unknown field (notably `slug`) is rejected with a validation
-    // error rather than silently stripped. Slug rename is a deliberately
-    // post-flip surface (its dormant reserve/commit core + retained-hostname 308
-    // serving land with the slug-rename activation card); accepting-and-dropping
-    // `slug` here would be a silent no-op, so the live PATCH must refuse it.
     .strict()
     .superRefine((value, ctx) => {
+    if (value.slug !== undefined && Object.keys(value).some((key) => key !== "slug")) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: "slug must be updated in a separate request.",
+            path: ["slug"],
+        });
+    }
     if (value.force === true && value.baseSettingsDigest === undefined) {
         ctx.addIssue({
             code: z.ZodIssueCode.custom,
@@ -166,6 +164,24 @@ export const anonymousClaimSpacePreviewSchema = z.object({
     liveUrl: z.string().nullable(),
     createdAt: z.string().datetime().nullable(),
 });
+export const anonymousClaimSharingSummarySchema = z.object({
+    people: z.array(z.object({
+        id: z.string(),
+        displayName: z.string(),
+        status: z.enum(["pending", "accepted"]),
+        grants: z.array(z.object({
+            scope: z.string().startsWith("/"),
+            role: z.enum(["viewer", "commenter", "editor"]),
+        })),
+    })),
+    links: z.array(z.object({
+        id: z.string(),
+        name: z.string(),
+        landingPath: z.string().startsWith("/"),
+        scopes: z.array(z.string().startsWith("/")),
+        expiresAt: z.string().datetime().nullable(),
+    })),
+});
 export const anonymousClaimResponseSchema = z.object({
     state: z.enum(["unclaimed", "claimed"]),
     action: z.enum(["claimed", "login_required", "team_required", "confirm_assign"]),
@@ -185,6 +201,7 @@ export const anonymousClaimResponseSchema = z.object({
     })
         .describe("Server-authoritative continuation eligibility and claim result."),
     teams: z.array(anonymousClaimTeamSchema).optional(),
+    sharing: anonymousClaimSharingSummarySchema,
 });
 export const anonymousClaimStatusResponseSchema = z.object({
     publish: z.object({
@@ -228,6 +245,20 @@ export const anonymousClaimExchangeResponseSchema = z.object({
         teamId: z.string(),
     }),
 });
+export const anonymousClaimRotateSchema = z.object({
+    spaceId: z.string().min(1),
+});
+export const anonymousClaimRotateResponseSchema = z.object({
+    spaceId: z.string(),
+    claimToken: z
+        .string()
+        .describe("Replacement claim token. Shown exactly once; store it before leaving this response."),
+    claimNonce: z
+        .string()
+        .describe("Replacement browser claim nonce embedded in claimUrl. Shown exactly once."),
+    claimUrl: z.string().url(),
+    expiresAt: z.string().datetime(),
+});
 export const spaceClaimReminderSchema = z.object({
     email: z
         .string()
@@ -238,6 +269,30 @@ export const spaceClaimReminderSchema = z.object({
 export const spaceClaimReminderResponseSchema = z.object({
     accepted: z.literal(true),
 });
+// Shared by spaceVersionCreateSchema and publishRequestSchema: both accept the
+// same manifest-mutation fields and enforce the same "requires a declared
+// files manifest / snapshot mode" rules on them.
+const manifestMutationFieldsSchema = {
+    deletePaths: z
+        .array(z.string().min(1))
+        .default([])
+        .describe("Explicit paths to remove when publishMode is additive. Omitted paths are retained; only paths listed here are deleted."),
+    immutableAssetPrefixes: z
+        .array(z.string().min(2))
+        .optional()
+        .describe("Publisher-owned directory prefixes whose declared files are immutable generation assets. Snapshot publishes retain the current generation's matching files for exactly one subsequent generation."),
+};
+function refineManifestMutationRules(value, ctx) {
+    if (value.immutableAssetPrefixes !== undefined) {
+        if (value.publishMode !== "snapshot") {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                message: "immutableAssetPrefixes requires snapshot publish mode.",
+                path: ["immutableAssetPrefixes"],
+            });
+        }
+    }
+}
 export const spaceVersionCreateSchema = z
     .object({
     source: PublishSourceSchema.optional().describe('Publish provenance recorded on the version; defaults to {kind: "direct_upload"}.'),
@@ -257,24 +312,16 @@ export const spaceVersionCreateSchema = z
     conventionFiles: conventionFilesSchema
         .optional()
         .describe("Routing convention contents used when deciding whether this publish is unchanged. The same values are supplied again when the version is finalized."),
+    finalize: z
+        .object({ channel: z.literal("live").nullable().optional() })
+        .optional()
+        .describe("Finalize intent for a declared upload. When every declared file lands, the version finalizes itself; the explicit finalize call remains available for recovery and replay."),
     files: z
         .array(manifestFileSchema)
-        .optional()
-        .describe("Full desired file manifest. For first deploys, send path/size/contentType without hashes so upload can begin immediately. For updates, include sha256 to let the server skip unchanged files. Omit entirely for an open session: the upload token then authorizes any policy-valid path within plan caps and finalize derives the manifest from what was uploaded."),
-    deletePaths: z
-        .array(z.string().min(1))
-        .default([])
-        .describe("Explicit paths to remove when publishMode is additive. Omitted paths are retained; only paths listed here are deleted."),
+        .describe("Full desired file manifest. For first deploys, send path/size/contentType without hashes so upload can begin immediately. For updates, include sha256 to let the server skip unchanged files."),
+    ...manifestMutationFieldsSchema,
 })
-    .superRefine((value, ctx) => {
-    if (value.files === undefined && value.deletePaths.length > 0) {
-        ctx.addIssue({
-            code: z.ZodIssueCode.custom,
-            message: "deletePaths requires a declared files manifest.",
-            path: ["deletePaths"],
-        });
-    }
-});
+    .superRefine(refineManifestMutationRules);
 export const spaceVersionListSchema = z.object({
     data: z.array(VersionSchema),
     pagination: CursorPaginationSchema,
@@ -442,7 +489,6 @@ export const spaceVersionComputedRoutingSummarySchema = z.object({
         headerRuleCount: z.number().int().nonnegative(),
         staticRedirectCount: z.number().int().nonnegative(),
         dynamicRedirectCount: z.number().int().nonnegative(),
-        basicAuthRuleCount: z.number().int().nonnegative(),
         proxyRuleCount: z.number().int().nonnegative(),
     }),
     diagnostics: z.array(spaceVersionRoutingDiagnosticSchema),
@@ -467,16 +513,31 @@ export const spaceVersionFileDiffEntrySchema = z.object({
         format: z.literal("unified"),
         content: z.string(),
         truncated: z.boolean(),
+        truncationReason: z.literal("patch_byte_limit").nullable(),
     })
         .nullable(),
+    patchOmission: z
+        .enum(["input_too_large", "not_previewable", "content_unavailable", "patch_budget_exhausted"])
+        .nullable(),
 });
-export const spaceVersionFileDiffQuerySchema = z.object({
+export const spaceVersionFileDiffQuerySchema = cursorListQuerySchema.extend({
     baseVersionId: z.string().optional(),
 });
 export const spaceVersionFileDiffResponseSchema = z.object({
     versionId: z.string(),
     baseVersionId: z.string().nullable(),
     files: z.array(spaceVersionFileDiffEntrySchema),
+    pagination: CursorPaginationSchema,
+    limits: z.object({
+        maxFiles: z.number().int().positive(),
+        maxInputBytes: z.number().int().positive(),
+        maxPatchBytes: z.number().int().positive(),
+        readConcurrency: z.number().int().positive(),
+    }),
+    usage: z.object({
+        inputBytes: z.number().int().nonnegative(),
+        patchBytes: z.number().int().nonnegative(),
+    }),
 });
 // Upload state is inferable (internal-docs/platform.md L2216): `upload` present means bytes are
 // still needed (then finalize); `versionId` null means the manifest matched and nothing changed.
@@ -502,13 +563,21 @@ export const publishRequestSchema = z
     principal: principalRefInputSchema.optional(),
     files: z
         .array(manifestFileSchema)
-        .optional()
-        .describe("Desired file manifest for a declared publish session. Clients upload returned paths, then finalize. Omit for inline one-shot and open-session publishes."),
-    deletePaths: z
-        .array(z.string().min(1))
-        .default([])
-        .describe("Explicit paths to remove when publishMode is additive. Omitted paths are retained; only paths listed here are deleted."),
+        .describe("Desired file manifest for a declared publish session. Clients upload returned paths, then finalize."),
+    ...manifestMutationFieldsSchema,
     source: PublishSourceSchema.optional().describe('Publish provenance recorded on the version; defaults to {kind: "direct_upload"}.'),
+    // Same fields, same bounds as spaceVersionCreateSchema: a publish that ran
+    // a build carries its transcript and provenance whichever door it enters
+    // by, so the first version of a space is not poorer than its second.
+    sourceMetadata: z
+        .record(z.string(), z.unknown())
+        .optional()
+        .describe("Additional control-plane-only provenance for build/deploy read models."),
+    buildLog: z
+        .string()
+        .max(64_000)
+        .optional()
+        .describe("Bounded build transcript for deploys that ran a local build before publishing."),
     publishMode: z
         .enum(["additive", "snapshot"])
         .default("additive")
@@ -531,9 +600,7 @@ export const publishRequestSchema = z
         dataLocation: z.string().min(1).optional(),
     })
         .optional(),
-    config: spaceConfigSchema
-        .optional()
-        .describe("SpaceConfig overlay to store on the space (sf.jsonc contents)."),
+    config: spaceConfigSchema.optional().describe("SpaceConfig overlay to store on the space."),
 })
     .superRefine((value, ctx) => {
     if (value.teamId && value.principal?.type === "team" && value.teamId !== value.principal.id) {
@@ -543,13 +610,7 @@ export const publishRequestSchema = z
             path: ["principal", "id"],
         });
     }
-    if (value.files === undefined && value.deletePaths.length > 0) {
-        ctx.addIssue({
-            code: z.ZodIssueCode.custom,
-            message: "deletePaths requires a declared files manifest.",
-            path: ["deletePaths"],
-        });
-    }
+    refineManifestMutationRules(value, ctx);
 });
 export const publishUploadReceiptSchema = z.object({
     ...uploadInstructionsSchema.shape,
@@ -569,21 +630,47 @@ export const publishReceiptVersionSchema = z.object({
     number: z.number().int().positive().nullable().optional(),
     manifestHash: z.string().nullable(),
 });
+// Liveness is never a version status — it is the channel pointer, reported
+// here. "Ready and live" (activated), "ready but outraced" (superseded), and
+// "ready by design" (unpromoted) are three different receipts.
+export const publishActivationSchema = z.object({
+    channel: z
+        .enum(["live"])
+        .nullable()
+        .describe("Channel this publish targeted. null = ready version without promotion."),
+    outcome: z
+        .enum(["activated", "unpromoted", "superseded", "pending"])
+        .describe("activated: the live pointer moved to this version. unpromoted: ready with channel null, by request. superseded: ready, but a newer publish holds the live pointer. pending: not settled yet."),
+    currentLiveVersionId: z
+        .string()
+        .nullable()
+        .describe("The version currently serving live traffic, or null when the space has none."),
+});
+// The receipt's normative next step: the deterministic projection of
+// (version status, activation outcome, pending bytes, operation state). An
+// agent drives the whole lifecycle by branching on `action` alone.
+export const publishNextSchema = z.object({
+    action: z
+        .enum(["done", "upload", "finalize", "poll"])
+        .describe("done: stop, this request's intent is settled. upload: PUT the upload targets, then follow the finalize link. finalize: all bytes are present, POST url to commit. poll: server-side work in flight, GET url after retryAfter seconds."),
+    url: z.string().optional().describe("The endpoint the action applies to."),
+    retryAfter: z
+        .number()
+        .int()
+        .positive()
+        .optional()
+        .describe("Polling cadence in seconds; present only when action is poll."),
+    hint: z.string().max(140).describe("One plain sentence for an agent mid-loop."),
+});
 export const publishReceiptSchema = z.object({
     space: publishReceiptSpaceSchema,
+    open: openHandoffSchema.optional(),
     version: publishReceiptVersionSchema,
+    activation: publishActivationSchema,
+    next: publishNextSchema,
     operation: AsyncOperationSchema.optional().describe("Background finalize operation when publish work continues asynchronously."),
-    // Paste-ready one-liner (URL + claim nudge) so agents propagate consistent
-    // claim copy into transcripts (internal-docs/platform.md M1a "share blurb").
-    shareBlurb: z.string(),
     upload: publishUploadReceiptSchema.optional(),
-    claim: z
-        .object({
-        token: z.string().optional(),
-        url: z.string(),
-        expiresAt: z.string().datetime(),
-    })
-        .optional(),
+    claim: spaceClaimReceiptSchema.optional(),
     diagnostics: z
         .array(baseDiagnosticSchema)
         .optional()
@@ -665,23 +752,17 @@ export const spaceRuntimeStatusSchema = z.object({
         .describe("Live space URL. Flips to the latest version after a successful publish to `live`."),
     runtimeState: spaceStatus.describe("Space operation-lifecycle status."),
     liveVersionStatus: versionStatus.nullable(),
-    liveRuntimeKind: zeroRuntimeKindSchema
+    liveRuntimeKind: runtimeKindSchema
         .nullable()
         .describe("Runtime kind declared by the live version, if any."),
     pendingVersionStatus: versionStatus.nullable(),
     operation: AsyncOperationSchema.nullable(),
-});
-// Channel listing entry: the channel name plus its spec ChannelPointer.
-export const spaceChannelSchema = z.object({
-    name: z.string().describe('Channel name; "live" is the default channel.'),
-    pointer: ChannelPointerSchema,
-});
-export const spaceChannelListResponseSchema = z.object({
-    data: z.array(spaceChannelSchema),
-    pagination: CursorPaginationSchema,
+    app: runtimeAppSchema
+        .nullable()
+        .describe("What the live version runs: its Zero capsule or Functions worker, discriminated by `runtimeKind`. Null for a static space, and null for callers whose credential does not carry `versions:read` — describing an app is a read of the version's contents, not of the space's serving state."),
 });
 export const spaceApplyChangeBaseSchema = z.object({
-    kind: z.enum(["variable", "routing", "password", "settings"]),
+    kind: z.enum(["variable", "routing", "access", "settings"]),
     name: z.string(),
     label: z.string(),
 });
@@ -690,7 +771,6 @@ export const spaceApplyChangeSchema = spaceApplyChangeBaseSchema.extend({
     id: z.string(),
     sourceSurface: z.string(),
     applyMode: spaceApplyModeSchema,
-    changesetId: z.string().optional(),
     before: z.record(z.string(), z.unknown()).nullable().optional(),
     after: z.record(z.string(), z.unknown()).nullable().optional(),
     metadata: z.record(z.string(), z.unknown()).optional(),

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

@@ -1,5 +1,5 @@
 import { z } from "zod";
-export declare const superadminEmailStatusValues: readonly ["all", "scheduled", "sent", "delivered", "bounced", "dropped", "complained", "opened", "clicked", "failed"];
+export declare const superadminEmailStatusValues: readonly ["all", "scheduled", "sent", "suppressed", "delivered", "bounced", "dropped", "complained", "opened", "clicked", "failed"];
 export declare const superadminEmailCategoryValues: readonly ["transactional", "announcements", "offers", "system", "invites"];
 export declare const superadminEmailListQuerySchema: z.ZodObject<{
     limit: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
@@ -7,11 +7,12 @@ export declare const superadminEmailListQuerySchema: z.ZodObject<{
     status: z.ZodDefault<z.ZodEnum<{
         all: "all";
         failed: "failed";
-        delivered: "delivered";
-        dropped: "dropped";
         scheduled: "scheduled";
+        delivered: "delivered";
         sent: "sent";
+        suppressed: "suppressed";
         bounced: "bounced";
+        dropped: "dropped";
         complained: "complained";
         opened: "opened";
         clicked: "clicked";
@@ -49,6 +50,12 @@ export declare const superadminEmailSendSchema: z.ZodObject<{
         offers: "offers";
         invites: "invites";
     }>>;
+    preferenceTopic: z.ZodEnum<{
+        system: "system";
+        announcements: "announcements";
+        offers: "offers";
+        invites: "invites";
+    }>;
     type: z.ZodDefault<z.ZodString>;
     props: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     sendAt: z.ZodOptional<z.ZodString>;
@@ -92,6 +99,13 @@ export declare const SuperadminEmailSchema: z.ZodObject<{
     type: z.ZodString;
     template: z.ZodString;
     category: z.ZodString;
+    preferenceTopic: z.ZodNullable<z.ZodEnum<{
+        system: "system";
+        announcements: "announcements";
+        offers: "offers";
+        invites: "invites";
+    }>>;
+    essentialAuth: z.ZodBoolean;
     props: z.ZodRecord<z.ZodString, z.ZodUnknown>;
     options: z.ZodRecord<z.ZodString, z.ZodUnknown>;
     metadata: z.ZodNullable<z.ZodObject<{
@@ -125,6 +139,7 @@ export declare const SuperadminEmailSchema: z.ZodObject<{
     fakeOpenedAt: z.ZodNullable<z.ZodString>;
     combinedOpenedAt: z.ZodNullable<z.ZodString>;
     unsubscribedAt: z.ZodNullable<z.ZodString>;
+    suppressedAt: z.ZodNullable<z.ZodString>;
     failedAt: z.ZodNullable<z.ZodString>;
     createdAt: z.ZodString;
     updatedAt: z.ZodString;
@@ -148,6 +163,13 @@ export declare const SuperadminEmailListSchema: z.ZodObject<{
         type: z.ZodString;
         template: z.ZodString;
         category: z.ZodString;
+        preferenceTopic: z.ZodNullable<z.ZodEnum<{
+            system: "system";
+            announcements: "announcements";
+            offers: "offers";
+            invites: "invites";
+        }>>;
+        essentialAuth: z.ZodBoolean;
         props: z.ZodRecord<z.ZodString, z.ZodUnknown>;
         options: z.ZodRecord<z.ZodString, z.ZodUnknown>;
         metadata: z.ZodNullable<z.ZodObject<{
@@ -181,6 +203,7 @@ export declare const SuperadminEmailListSchema: z.ZodObject<{
         fakeOpenedAt: z.ZodNullable<z.ZodString>;
         combinedOpenedAt: z.ZodNullable<z.ZodString>;
         unsubscribedAt: z.ZodNullable<z.ZodString>;
+        suppressedAt: z.ZodNullable<z.ZodString>;
         failedAt: z.ZodNullable<z.ZodString>;
         createdAt: z.ZodString;
         updatedAt: z.ZodString;
@@ -203,6 +226,7 @@ export declare const SuperadminEmailSendResultSchema: z.ZodObject<{
             error: "error";
             scheduled: "scheduled";
             sent: "sent";
+            suppressed: "suppressed";
         }>;
         error: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;

package/dist/contracts/superadmin-emails.js

@@ -1,10 +1,12 @@
 import { z } from "zod";
 import { makeOffsetListSchema } from "./common.js";
+import { emailCategoryValues, emailPreferenceTopicValues } from "./email-preferences.js";
 import { superadminPaginationSchema } from "./superadmin.js";
 export const superadminEmailStatusValues = [
     "all",
     "scheduled",
     "sent",
+    "suppressed",
     "delivered",
     "bounced",
     "dropped",
@@ -13,20 +15,9 @@ export const superadminEmailStatusValues = [
     "clicked",
     "failed",
 ];
-// "invites" is the invite/request sending stream (access-plan X-25): mail
-// carrying sender-authored content to arbitrary non-user addresses is
-// attacker-adjacent, so it is categorized apart from transactional mail —
-// burned reputation on the invite stream must never take down password
-// resets. Stream-level isolation at the provider (a separate SES
-// configuration set / sending identity) is an infra follow-up; the category
-// is the seam it keys off.
-export const superadminEmailCategoryValues = [
-    "transactional",
-    "announcements",
-    "offers",
-    "system",
-    "invites",
-];
+// Delivery category is provider-facing telemetry/routing. Recipient control is
+// modeled independently by preferenceTopic; essential auth has no topic.
+export const superadminEmailCategoryValues = emailCategoryValues;
 export const superadminEmailListQuerySchema = z.object({
     limit: z.coerce.number().int().min(1).max(100).default(25),
     offset: z.coerce.number().int().min(0).default(0),
@@ -44,6 +35,7 @@ export const superadminEmailSendSchema = z.object({
     html: z.string().optional(),
     template: z.string().trim().min(1).default("generic-message"),
     category: z.enum(superadminEmailCategoryValues).default("transactional"),
+    preferenceTopic: z.enum(emailPreferenceTopicValues),
     type: z.string().trim().min(1).default("generic-message"),
     props: z.record(z.string(), z.unknown()).default({}),
     sendAt: z.string().datetime().optional(),
@@ -90,6 +82,8 @@ export const SuperadminEmailSchema = z.object({
     type: z.string(),
     template: z.string(),
     category: z.string(),
+    preferenceTopic: z.enum(emailPreferenceTopicValues).nullable(),
+    essentialAuth: z.boolean(),
     props: z.record(z.string(), z.unknown()),
     options: z.record(z.string(), z.unknown()),
     metadata: SuperadminEmailMetadataSchema.nullable(),
@@ -104,6 +98,7 @@ export const SuperadminEmailSchema = z.object({
     fakeOpenedAt: z.string().datetime().nullable(),
     combinedOpenedAt: z.string().datetime().nullable(),
     unsubscribedAt: z.string().datetime().nullable(),
+    suppressedAt: z.string().datetime().nullable(),
     failedAt: z.string().datetime().nullable(),
     createdAt: z.string().datetime(),
     updatedAt: z.string().datetime(),
@@ -114,7 +109,7 @@ export const SuperadminEmailSendResultSchema = z.object({
         id: z.string(),
         userId: z.string().nullable().optional(),
         email: z.string().optional(),
-        status: z.enum(["sent", "scheduled", "error"]),
+        status: z.enum(["sent", "scheduled", "suppressed", "error"]),
         error: z.string().optional(),
     })),
 });

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

@@ -8,8 +8,8 @@ export declare const superadminEdgePurgeSchema: z.ZodObject<{
     uris: z.ZodNullable<z.ZodArray<z.ZodString>>;
     status: z.ZodEnum<{
         pending: "pending";
-        purged: "purged";
         superseded: "superseded";
+        purged: "purged";
     }>;
     executedAt: z.ZodNullable<z.ZodString>;
     createdAt: z.ZodString;
@@ -17,8 +17,8 @@ export declare const superadminEdgePurgeSchema: z.ZodObject<{
 export declare const superadminEdgePurgeListQuerySchema: z.ZodObject<{
     status: z.ZodOptional<z.ZodEnum<{
         pending: "pending";
-        purged: "purged";
         superseded: "superseded";
+        purged: "purged";
     }>>;
     providerSiteId: z.ZodOptional<z.ZodString>;
     hostname: z.ZodOptional<z.ZodString>;