@spacefast/common 0.0.24 → 0.2.1

package/dist/contracts/resources.js

@@ -1,6 +1,6 @@
 import { z } from "zod";
 import { AsyncOperationSchema, baseDiagnosticSchema } from "./common.js";
-import { publishSourceKind, versionStatus, spaceDisabledReasonCode, spaceStatus } from "./enums.js";
+import { publishSourceKind, tenantMode, versionStatus, spaceDisabledReasonCode, spaceStatus, VERSION_IN_FLIGHT_STATUSES, } from "./enums.js";
 import { pendingUploadSchema } from "./internal.js";
 import { spaceConfigSchema } from "./space-config.js";
 export const DiagnosticSchema = baseDiagnosticSchema.extend({
@@ -13,7 +13,7 @@ export const PrincipalRefSchema = z.object({
     principalType: z.enum(["team", "external"]),
     principalId: z.string(),
 });
-// ChannelPointer (internal-docs/platform.md "ChannelPointer"): a channel names
+// ChannelPointer (the platform spec "ChannelPointer"): a channel names
 // exactly one version. A channel with no version yet is absent from the map
 // rather than present with an empty pointer.
 export const ChannelPointerSchema = z.object({
@@ -27,23 +27,97 @@ export const ChannelPointerSchema = z.object({
 export const spaceSettingsDigestSchema = z
     .string()
     .regex(/^[0-9a-f]{64}$/, "must be a 64-character lowercase hex sha256 digest");
+// Where a space actually runs. Partner tenants reconcile placement and health
+// against their own records, so this is the real handle set rather than a
+// status word: the region it was placed in, the runtime instance serving it,
+// the provider hostname that instance answers on, and one derived convergence
+// state. Every handle is null until the space is placed.
+export const spaceInfrastructureSchema = z.object({
+    region: z.string().nullable().describe("Concrete region the space's site was placed in."),
+    runtimeInstanceId: z.string().nullable().describe("Runtime instance serving this space."),
+    providerMainHostname: z
+        .string()
+        .nullable()
+        .describe("Primary hostname the provider answers on for this space's site."),
+    provisioningState: z
+        .enum(["provisioning", "converged", "degraded"])
+        .describe("Convergence of the space against its intended infrastructure: still being placed, matching intent, or failing to converge."),
+});
+/*
+ * Where a space's git remote is, and who owns it.
+ *
+ * The two cases are not the same offer. A Spacefast-hosted space hands out a
+ * remote you can push to, and pushing publishes. A space bound to a GitHub
+ * repository has GitHub as its source of truth: there is no remote to give out,
+ * because a direct push would be overwritten by the next sync. `managedBy` is
+ * the field a client branches on, so it never has to infer which world it is in
+ * from an absent one — `remoteUrl` is non-null exactly when it is `spacefast`,
+ * and `repository` exactly when it is `github`.
+ *
+ * Deliberately one flat object rather than a discriminated union: this schema
+ * is reachable from the Space resource and from every publish receipt, and a
+ * union here pushed the router's whole inferred type graph past TypeScript's
+ * instantiation-depth limit (api/structural-router.test.ts). The invariant that
+ * a union would have carried in the type is stated above and enforced by the
+ * one function that builds this block (push-new/space-git.ts).
+ *
+ * `remoteUrl` never carries a credential. Authentication is HTTP Basic with the
+ * username `t` and a space key or API key as the password, so the credential
+ * lives wherever that client already keeps it instead of being duplicated into
+ * a URL that lands in shell history and `git remote -v`.
+ */
+export const spaceGitSchema = z.object({
+    managedBy: z
+        .enum(["spacefast", "github"])
+        .describe("Who owns this space's git history. `spacefast`: push `remoteUrl` to publish. `github`: the space deploys from `repository` and direct pushes are refused."),
+    remoteUrl: z
+        .string()
+        .nullable()
+        .describe("Credential-free git remote to push to, or null when `managedBy` is `github`. Authenticate as HTTP Basic user `t` with a space key or API key as the password."),
+    repository: z
+        .string()
+        .nullable()
+        .describe("`owner/name` of the GitHub repository this space deploys from, else null."),
+    defaultBranch: z
+        .string()
+        .nullable()
+        .describe("Branch that publishes to the live channel when pushed."),
+});
+// Every `CONSUMER_HIDDEN_SPACE_FIELDS` member below is `.optional()` because
+// the consumer projection OMITS it rather than nulling it — absent means "not
+// your surface", null means "nothing here yet", and the response validator has
+// to accept both bodies from the one shared schema.
 export const SpaceSchema = z.object({
     id: z.string(),
-    tenantId: z.string(),
+    tenantId: z.string().optional(),
+    // Derived from the owning tenant, never stored on the space: `test` for a
+    // space under a linked test tenant, `live` otherwise. A platform-surface
+    // field like `tenantId` — stripped from the consumer view.
+    mode: tenantMode
+        .optional()
+        .describe("`test` when the owning tenant is a linked test tenant, `live` otherwise."),
     // Raw provider identity of the site this space IS — deliberately not hidden
     // behind an abstraction, because a platform tenant provisioning under its own
     // WP.Cloud client needs the real handle to reconcile against. Both are
     // platform-surface fields (like `tenantId` and `principal`): the public API
     // reference strips them, the platform document keeps them. Null until the
     // space is placed.
-    providerRef: z.string().nullable().describe("WP.Cloud `atomic_site_id` serving this space."),
+    providerRef: z
+        .string()
+        .nullable()
+        .optional()
+        .describe("WP Cloud `atomic_site_id` serving this space."),
     providerClientId: z
         .string()
         .nullable()
-        .describe("WP.Cloud client identity (`pvc_...`) the space's site is provisioned under."),
+        .optional()
+        .describe("WP Cloud client identity (`pvc_...`) the space's site is provisioned under."),
     teamId: z.string().nullable(),
     teamSlug: z.string().nullable(),
-    principal: PrincipalRefSchema.nullable(),
+    principal: PrincipalRefSchema.nullable().optional(),
+    // Present only for callers holding `infrastructure:read` on the space's
+    // tenant; absent (not null) for everyone else.
+    infrastructure: spaceInfrastructureSchema.optional(),
     anonymous: z.boolean(),
     slug: z.string(),
     title: z.string(),
@@ -57,7 +131,7 @@ export const SpaceSchema = z.object({
         reasonCode: spaceDisabledReasonCode.describe("Why serving is disabled."),
     })
         .nullable(),
-    // Anonymous-claim lifecycle (internal-docs/platform.md Space.claimState): null
+    // Anonymous-claim lifecycle (the platform spec Space.claimState): null
     // for spaces that never went through the anonymous lifecycle. `purgeAfter` is
     // the end of the one-day post-expiry recovery window before content deletion.
     claimState: z
@@ -114,21 +188,63 @@ export const SpaceSchema = z.object({
     noindex: z
         .boolean()
         .describe("When true, the live production hostnames serve platform noindex directives. Immutable version and preview hostnames are always noindex regardless of this setting."),
+    pinnedAt: z
+        .string()
+        .datetime()
+        .nullable()
+        .describe("Instant the space was pinned to the top of its team's space list, or null when it is not pinned. The pin is team-wide: everyone who can see the team sees it."),
+    git: spaceGitSchema
+        .nullable()
+        .describe("Git remote for this space, or null when it has no repository yet. Push to `remoteUrl` to publish."),
     operation: AsyncOperationSchema.nullable(),
     createdAt: z.string().datetime(),
     updatedAt: z.string().datetime(),
 });
-// PublishSource (internal-docs/platform.md "PublishSource"): the single
+// The fields a consumer-class credential never sees on a Space. ONE source of
+// truth: the response serializer omits exactly these for consumer callers, and
+// the public API reference strips exactly these from the shared schemas. They
+// are tenancy, on-behalf-of identity, and raw infrastructure — meaningful to a
+// partner running spaces for its own customers, noise (or a leak) to everyone
+// else.
+//
+// It lives below SpaceSchema so `satisfies` can pin every name to a real field:
+// a typo, or a later rename on the schema, is a compile error here rather than
+// a field that quietly stops being hidden.
+export const CONSUMER_HIDDEN_SPACE_FIELDS = [
+    "tenantId",
+    "mode",
+    "principal",
+    "providerRef",
+    "providerClientId",
+    "infrastructure",
+];
+// PublishSource (the platform spec "PublishSource"): the single
 // provenance shape for how a version came to exist. Sent on publish/version
 // create and echoed on the Version resource. Structured CI/git detail beyond
 // the named fields rides in `metadata` (string values only).
+// The git block of a PublishSource, exported on its own so servers echoing
+// declared provenance can validate just this piece without reaching into the
+// parent schema's internals.
+export const publishSourceGitSchema = z
+    .object({
+    repository: z.string().nullable().optional(),
+    repositoryFullName: z.string().nullable().optional(),
+    repositoryUrl: z.string().nullable().optional(),
+    ref: z.string().nullable().optional(),
+    branch: z.string().nullable().optional(),
+    branchAliasUrl: z.string().nullable().optional(),
+    commit: z.string().nullable().optional(),
+    commitSha: z.string().nullable().optional(),
+    pullRequestNumber: z.number().nullable().optional(),
+})
+    .catchall(z.unknown());
 export const PublishSourceSchema = z.object({
     kind: publishSourceKind.describe("How this version was produced."),
     client: z
         .string()
         .max(255)
         .optional()
-        .describe("Publishing client attribution, e.g. spacefast-cli/1.2.3."),
+        .describe("Publishing client attribution, for example `spacefast-cli/1.2.3`."),
     branch: z.string().max(255).optional().describe("Git branch the publish came from."),
     commit: z.string().max(64).optional().describe("Git commit SHA the publish came from."),
     message: z
@@ -144,20 +260,27 @@ export const PublishSourceSchema = z.object({
         .record(z.string(), z.string())
         .optional()
         .describe("Additional provenance (repository, CI run URL, workflow, actor, ...)."),
-    git: z
-        .object({
-        repository: z.string().nullable().optional(),
-        repositoryFullName: z.string().nullable().optional(),
-        repositoryUrl: z.string().nullable().optional(),
-        ref: z.string().nullable().optional(),
-        branch: z.string().nullable().optional(),
-        branchAliasUrl: z.string().nullable().optional(),
-        commit: z.string().nullable().optional(),
-        commitSha: z.string().nullable().optional(),
-        pullRequestNumber: z.number().nullable().optional(),
-    })
-        .catchall(z.unknown())
-        .optional(),
+    git: publishSourceGitSchema.optional(),
+});
+const VersionPublisherPersonSchema = z.object({
+    displayName: z.string().describe("The person's display name."),
+    avatarUrl: z
+        .string()
+        .nullable()
+        .describe("The person's avatar URL. The value is null when no avatar exists."),
+});
+export const VersionPublisherSchema = z.object({
+    type: z
+        .enum(["user", "api_key", "partner_token", "oauth_client", "anonymous_claim", "system"])
+        .describe("The type of actor that published the version."),
+    displayName: z
+        .string()
+        .describe("The display name of the person, agent, or system that published the version."),
+    avatarUrl: z
+        .string()
+        .nullable()
+        .describe("The publisher's avatar URL. The value is null when no avatar exists."),
+    authorizedBy: VersionPublisherPersonSchema.nullable().describe("The person who authorized the publisher. The value is null when the publisher is a person or has no known authorizer."),
 });
 export const VersionSchema = z.object({
     id: z.string(),
@@ -169,6 +292,7 @@ export const VersionSchema = z.object({
     number: z.number().int().positive().nullable(),
     spaceId: z.string(),
     source: PublishSourceSchema.nullable().describe("Publish provenance: who/what produced this version."),
+    publisher: VersionPublisherSchema.nullable().describe("The actor that published the version. The value is null for a legacy version with no attribution."),
     status: versionStatus,
     failureCode: z.string().nullable(),
     failureMessage: z.string().nullable(),
@@ -208,9 +332,9 @@ export const VersionSchema = z.object({
         .nullable()
         .describe("Permanent version URL (v{number}--{label}.view.fast form), computed once and stored at ready; survives slug changes, transfers, and channel repointing. Null before ready."),
     immutableUrlStatus: z
-        .enum(["converging", "ready"])
+        .enum(["pending", "ready"])
         .nullable()
-        .describe("Whether the immutable version URL provider alias has converged. converging means the URL may not resolve yet."),
+        .describe("Whether the immutable version URL is ready. pending means the URL might not resolve yet."),
     isCurrentProduction: z.boolean(),
     siteTitle: z.string(),
     config: spaceConfigSchema
@@ -228,7 +352,7 @@ export const VersionSchema = z.object({
     readyAt: z.string().datetime().nullable(),
     updatedAt: z.string().datetime(),
 });
-const activeVersionStatuses = new Set(["created", "uploading", "uploaded", "finalizing"]);
+const activeVersionStatuses = new Set(VERSION_IN_FLIGHT_STATUSES);
 export function hasActiveVersionStatus(status) {
     return Boolean(status && activeVersionStatuses.has(status));
 }

package/dist/contracts/route-inventory.d.ts

@@ -0,0 +1,358 @@
+import { z } from "zod";
+export declare const routeInventoryEdgeAuthV1Schema: z.ZodLiteral<"inherit">;
+export type RouteInventoryEdgeAuthV1 = z.infer<typeof routeInventoryEdgeAuthV1Schema>;
+export declare const routeInventoryRecordV1Schema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"redirect">;
+    status: z.ZodUnion<readonly [z.ZodLiteral<301>, z.ZodLiteral<302>, z.ZodLiteral<303>, z.ZodLiteral<307>, z.ZodLiteral<308>]>;
+    runtime: z.ZodLiteral<"routing">;
+    destination: z.ZodString;
+    id: z.core.$ZodBranded<z.ZodString, "ContentProgramSha256", "out">;
+    source: z.ZodString;
+    host: z.ZodString;
+    path: z.ZodString;
+    methods: z.ZodArray<z.ZodUnion<readonly [z.ZodLiteral<"*">, z.ZodEnum<{
+        POST: "POST";
+        PUT: "PUT";
+        GET: "GET";
+        HEAD: "HEAD";
+        PATCH: "PATCH";
+        DELETE: "DELETE";
+        OPTIONS: "OPTIONS";
+    }>]>>;
+    auth: z.ZodLiteral<"inherit">;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"rewrite">;
+    status: z.ZodLiteral<200>;
+    runtime: z.ZodLiteral<"routing">;
+    destination: z.ZodString;
+    id: z.core.$ZodBranded<z.ZodString, "ContentProgramSha256", "out">;
+    source: z.ZodString;
+    host: z.ZodString;
+    path: z.ZodString;
+    methods: z.ZodArray<z.ZodUnion<readonly [z.ZodLiteral<"*">, z.ZodEnum<{
+        POST: "POST";
+        PUT: "PUT";
+        GET: "GET";
+        HEAD: "HEAD";
+        PATCH: "PATCH";
+        DELETE: "DELETE";
+        OPTIONS: "OPTIONS";
+    }>]>>;
+    auth: z.ZodLiteral<"inherit">;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"proxy">;
+    status: z.ZodLiteral<200>;
+    cache: z.ZodOptional<z.ZodLiteral<"shared">>;
+    runtime: z.ZodLiteral<"routing">;
+    destination: z.ZodString;
+    id: z.core.$ZodBranded<z.ZodString, "ContentProgramSha256", "out">;
+    source: z.ZodString;
+    host: z.ZodString;
+    path: z.ZodString;
+    methods: z.ZodArray<z.ZodUnion<readonly [z.ZodLiteral<"*">, z.ZodEnum<{
+        POST: "POST";
+        PUT: "PUT";
+        GET: "GET";
+        HEAD: "HEAD";
+        PATCH: "PATCH";
+        DELETE: "DELETE";
+        OPTIONS: "OPTIONS";
+    }>]>>;
+    auth: z.ZodLiteral<"inherit">;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"not-found">;
+    status: z.ZodLiteral<404>;
+    runtime: z.ZodLiteral<"routing">;
+    destination: z.ZodString;
+    id: z.core.$ZodBranded<z.ZodString, "ContentProgramSha256", "out">;
+    source: z.ZodString;
+    host: z.ZodString;
+    path: z.ZodString;
+    methods: z.ZodArray<z.ZodUnion<readonly [z.ZodLiteral<"*">, z.ZodEnum<{
+        POST: "POST";
+        PUT: "PUT";
+        GET: "GET";
+        HEAD: "HEAD";
+        PATCH: "PATCH";
+        DELETE: "DELETE";
+        OPTIONS: "OPTIONS";
+    }>]>>;
+    auth: z.ZodLiteral<"inherit">;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"functions">;
+    runtime: z.ZodLiteral<"cloudflare-worker">;
+    id: z.core.$ZodBranded<z.ZodString, "ContentProgramSha256", "out">;
+    source: z.ZodString;
+    host: z.ZodString;
+    path: z.ZodString;
+    methods: z.ZodArray<z.ZodUnion<readonly [z.ZodLiteral<"*">, z.ZodEnum<{
+        POST: "POST";
+        PUT: "PUT";
+        GET: "GET";
+        HEAD: "HEAD";
+        PATCH: "PATCH";
+        DELETE: "DELETE";
+        OPTIONS: "OPTIONS";
+    }>]>>;
+    auth: z.ZodLiteral<"inherit">;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"php-function">;
+    runtime: z.ZodLiteral<"php">;
+    id: z.core.$ZodBranded<z.ZodString, "ContentProgramSha256", "out">;
+    source: z.ZodString;
+    host: z.ZodString;
+    path: z.ZodString;
+    methods: z.ZodArray<z.ZodUnion<readonly [z.ZodLiteral<"*">, z.ZodEnum<{
+        POST: "POST";
+        PUT: "PUT";
+        GET: "GET";
+        HEAD: "HEAD";
+        PATCH: "PATCH";
+        DELETE: "DELETE";
+        OPTIONS: "OPTIONS";
+    }>]>>;
+    auth: z.ZodLiteral<"inherit">;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"zero-control">;
+    runtime: z.ZodLiteral<"php">;
+    id: z.core.$ZodBranded<z.ZodString, "ContentProgramSha256", "out">;
+    source: z.ZodString;
+    host: z.ZodString;
+    path: z.ZodString;
+    methods: z.ZodArray<z.ZodUnion<readonly [z.ZodLiteral<"*">, z.ZodEnum<{
+        POST: "POST";
+        PUT: "PUT";
+        GET: "GET";
+        HEAD: "HEAD";
+        PATCH: "PATCH";
+        DELETE: "DELETE";
+        OPTIONS: "OPTIONS";
+    }>]>>;
+    auth: z.ZodLiteral<"inherit">;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"zero-endpoint">;
+    runtime: z.ZodLiteral<"quick-js">;
+    id: z.core.$ZodBranded<z.ZodString, "ContentProgramSha256", "out">;
+    source: z.ZodString;
+    host: z.ZodString;
+    path: z.ZodString;
+    methods: z.ZodArray<z.ZodUnion<readonly [z.ZodLiteral<"*">, z.ZodEnum<{
+        POST: "POST";
+        PUT: "PUT";
+        GET: "GET";
+        HEAD: "HEAD";
+        PATCH: "PATCH";
+        DELETE: "DELETE";
+        OPTIONS: "OPTIONS";
+    }>]>>;
+    auth: z.ZodLiteral<"inherit">;
+}, z.core.$strict>], "kind">;
+export type RouteInventoryRecordV1 = z.infer<typeof routeInventoryRecordV1Schema>;
+export declare const routeInventoryV1Schema: z.ZodObject<{
+    format: z.ZodLiteral<"stattic.route-inventory.v1">;
+    routes: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"redirect">;
+        status: z.ZodUnion<readonly [z.ZodLiteral<301>, z.ZodLiteral<302>, z.ZodLiteral<303>, z.ZodLiteral<307>, z.ZodLiteral<308>]>;
+        runtime: z.ZodLiteral<"routing">;
+        destination: z.ZodString;
+        id: z.core.$ZodBranded<z.ZodString, "ContentProgramSha256", "out">;
+        source: z.ZodString;
+        host: z.ZodString;
+        path: z.ZodString;
+        methods: z.ZodArray<z.ZodUnion<readonly [z.ZodLiteral<"*">, z.ZodEnum<{
+            POST: "POST";
+            PUT: "PUT";
+            GET: "GET";
+            HEAD: "HEAD";
+            PATCH: "PATCH";
+            DELETE: "DELETE";
+            OPTIONS: "OPTIONS";
+        }>]>>;
+        auth: z.ZodLiteral<"inherit">;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"rewrite">;
+        status: z.ZodLiteral<200>;
+        runtime: z.ZodLiteral<"routing">;
+        destination: z.ZodString;
+        id: z.core.$ZodBranded<z.ZodString, "ContentProgramSha256", "out">;
+        source: z.ZodString;
+        host: z.ZodString;
+        path: z.ZodString;
+        methods: z.ZodArray<z.ZodUnion<readonly [z.ZodLiteral<"*">, z.ZodEnum<{
+            POST: "POST";
+            PUT: "PUT";
+            GET: "GET";
+            HEAD: "HEAD";
+            PATCH: "PATCH";
+            DELETE: "DELETE";
+            OPTIONS: "OPTIONS";
+        }>]>>;
+        auth: z.ZodLiteral<"inherit">;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"proxy">;
+        status: z.ZodLiteral<200>;
+        cache: z.ZodOptional<z.ZodLiteral<"shared">>;
+        runtime: z.ZodLiteral<"routing">;
+        destination: z.ZodString;
+        id: z.core.$ZodBranded<z.ZodString, "ContentProgramSha256", "out">;
+        source: z.ZodString;
+        host: z.ZodString;
+        path: z.ZodString;
+        methods: z.ZodArray<z.ZodUnion<readonly [z.ZodLiteral<"*">, z.ZodEnum<{
+            POST: "POST";
+            PUT: "PUT";
+            GET: "GET";
+            HEAD: "HEAD";
+            PATCH: "PATCH";
+            DELETE: "DELETE";
+            OPTIONS: "OPTIONS";
+        }>]>>;
+        auth: z.ZodLiteral<"inherit">;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"not-found">;
+        status: z.ZodLiteral<404>;
+        runtime: z.ZodLiteral<"routing">;
+        destination: z.ZodString;
+        id: z.core.$ZodBranded<z.ZodString, "ContentProgramSha256", "out">;
+        source: z.ZodString;
+        host: z.ZodString;
+        path: z.ZodString;
+        methods: z.ZodArray<z.ZodUnion<readonly [z.ZodLiteral<"*">, z.ZodEnum<{
+            POST: "POST";
+            PUT: "PUT";
+            GET: "GET";
+            HEAD: "HEAD";
+            PATCH: "PATCH";
+            DELETE: "DELETE";
+            OPTIONS: "OPTIONS";
+        }>]>>;
+        auth: z.ZodLiteral<"inherit">;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"functions">;
+        runtime: z.ZodLiteral<"cloudflare-worker">;
+        id: z.core.$ZodBranded<z.ZodString, "ContentProgramSha256", "out">;
+        source: z.ZodString;
+        host: z.ZodString;
+        path: z.ZodString;
+        methods: z.ZodArray<z.ZodUnion<readonly [z.ZodLiteral<"*">, z.ZodEnum<{
+            POST: "POST";
+            PUT: "PUT";
+            GET: "GET";
+            HEAD: "HEAD";
+            PATCH: "PATCH";
+            DELETE: "DELETE";
+            OPTIONS: "OPTIONS";
+        }>]>>;
+        auth: z.ZodLiteral<"inherit">;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"php-function">;
+        runtime: z.ZodLiteral<"php">;
+        id: z.core.$ZodBranded<z.ZodString, "ContentProgramSha256", "out">;
+        source: z.ZodString;
+        host: z.ZodString;
+        path: z.ZodString;
+        methods: z.ZodArray<z.ZodUnion<readonly [z.ZodLiteral<"*">, z.ZodEnum<{
+            POST: "POST";
+            PUT: "PUT";
+            GET: "GET";
+            HEAD: "HEAD";
+            PATCH: "PATCH";
+            DELETE: "DELETE";
+            OPTIONS: "OPTIONS";
+        }>]>>;
+        auth: z.ZodLiteral<"inherit">;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"zero-control">;
+        runtime: z.ZodLiteral<"php">;
+        id: z.core.$ZodBranded<z.ZodString, "ContentProgramSha256", "out">;
+        source: z.ZodString;
+        host: z.ZodString;
+        path: z.ZodString;
+        methods: z.ZodArray<z.ZodUnion<readonly [z.ZodLiteral<"*">, z.ZodEnum<{
+            POST: "POST";
+            PUT: "PUT";
+            GET: "GET";
+            HEAD: "HEAD";
+            PATCH: "PATCH";
+            DELETE: "DELETE";
+            OPTIONS: "OPTIONS";
+        }>]>>;
+        auth: z.ZodLiteral<"inherit">;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"zero-endpoint">;
+        runtime: z.ZodLiteral<"quick-js">;
+        id: z.core.$ZodBranded<z.ZodString, "ContentProgramSha256", "out">;
+        source: z.ZodString;
+        host: z.ZodString;
+        path: z.ZodString;
+        methods: z.ZodArray<z.ZodUnion<readonly [z.ZodLiteral<"*">, z.ZodEnum<{
+            POST: "POST";
+            PUT: "PUT";
+            GET: "GET";
+            HEAD: "HEAD";
+            PATCH: "PATCH";
+            DELETE: "DELETE";
+            OPTIONS: "OPTIONS";
+        }>]>>;
+        auth: z.ZodLiteral<"inherit">;
+    }, z.core.$strict>], "kind">>;
+}, z.core.$strict>;
+export type RouteInventoryV1 = z.infer<typeof routeInventoryV1Schema>;
+export declare const spaceRouteSnapshotRouteV1Schema: z.ZodObject<{
+    id: z.core.$ZodBranded<z.ZodString, "ContentProgramSha256", "out">;
+    sourceRuleId: z.ZodNumber;
+    priority: z.ZodNumber;
+    host: z.ZodString;
+    methods: z.ZodArray<z.ZodUnion<readonly [z.ZodLiteral<"*">, z.ZodEnum<{
+        POST: "POST";
+        PUT: "PUT";
+        GET: "GET";
+        HEAD: "HEAD";
+        PATCH: "PATCH";
+        DELETE: "DELETE";
+        OPTIONS: "OPTIONS";
+    }>]>>;
+    match: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"exact">;
+        path: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"pattern">;
+        pattern: z.ZodString;
+    }, z.core.$strict>], "kind">;
+    destination: z.ZodString;
+    status: z.ZodUnion<readonly [z.ZodLiteral<301>, z.ZodLiteral<302>, z.ZodLiteral<303>, z.ZodLiteral<307>, z.ZodLiteral<308>]>;
+}, z.core.$strict>;
+export type SpaceRouteSnapshotRouteV1 = z.infer<typeof spaceRouteSnapshotRouteV1Schema>;
+export declare const spaceRouteSnapshotV1Schema: z.ZodObject<{
+    format: z.ZodLiteral<"spacefast.space-route-snapshot">;
+    version: z.ZodLiteral<1>;
+    spaceId: z.ZodTemplateLiteral<`spc_${string}`>;
+    source: z.ZodLiteral<"wordpress-redirection">;
+    capturedAt: z.ZodString;
+    revision: z.core.$ZodBranded<z.ZodString, "ContentProgramSha256", "out">;
+    routes: z.ZodArray<z.ZodObject<{
+        id: z.core.$ZodBranded<z.ZodString, "ContentProgramSha256", "out">;
+        sourceRuleId: z.ZodNumber;
+        priority: z.ZodNumber;
+        host: z.ZodString;
+        methods: z.ZodArray<z.ZodUnion<readonly [z.ZodLiteral<"*">, z.ZodEnum<{
+            POST: "POST";
+            PUT: "PUT";
+            GET: "GET";
+            HEAD: "HEAD";
+            PATCH: "PATCH";
+            DELETE: "DELETE";
+            OPTIONS: "OPTIONS";
+        }>]>>;
+        match: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"exact">;
+            path: z.ZodString;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"pattern">;
+            pattern: z.ZodString;
+        }, z.core.$strict>], "kind">;
+        destination: z.ZodString;
+        status: z.ZodUnion<readonly [z.ZodLiteral<301>, z.ZodLiteral<302>, z.ZodLiteral<303>, z.ZodLiteral<307>, z.ZodLiteral<308>]>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type SpaceRouteSnapshotV1 = z.infer<typeof spaceRouteSnapshotV1Schema>;