@spacefast/common 0.0.2

package/dist/contracts/git.d.ts

@@ -0,0 +1,288 @@
+import { z } from "zod";
+export declare const buildTargetValues: readonly ["production", "preview"];
+export declare const buildTriggerValues: readonly ["manual", "push", "pull_request", "retry"];
+export declare const buildTarget: z.ZodEnum<{
+    production: "production";
+    preview: "preview";
+}>;
+export declare const buildTrigger: z.ZodEnum<{
+    retry: "retry";
+    push: "push";
+    pull_request: "pull_request";
+    manual: "manual";
+}>;
+export declare const buildEnvironmentScopeValues: readonly ["runtime", "build", "build:production", "build:preview"];
+export declare const buildEnvironmentScope: z.ZodEnum<{
+    runtime: "runtime";
+    build: "build";
+    "build:production": "build:production";
+    "build:preview": "build:preview";
+}>;
+export declare const gitBuildSettingsSchema: z.ZodObject<{
+    rootDirectory: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    installDirectory: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    installCommand: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    buildCommand: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    outputDirectory: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    ignoredBuildCommand: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    frameworkPreset: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    platformPreset: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    allowUnsupportedPlatformFeatures: z.ZodDefault<z.ZodBoolean>;
+    timeoutSeconds: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+export declare const gitPlatformDetectionSchema: z.ZodObject<{
+    platform: z.ZodEnum<{
+        vercel: "vercel";
+        netlify: "netlify";
+        "cloudflare-pages": "cloudflare-pages";
+    }>;
+    rootDirectory: z.ZodNullable<z.ZodString>;
+    installDirectory: z.ZodNullable<z.ZodString>;
+    installCommand: z.ZodNullable<z.ZodString>;
+    buildCommand: z.ZodNullable<z.ZodString>;
+    outputDirectory: z.ZodNullable<z.ZodString>;
+    unsupportedFeatures: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export declare const gitConnectionSchema: z.ZodObject<{
+    id: z.ZodString;
+    spaceId: z.ZodString;
+    provider: z.ZodEnum<{
+        github: "github";
+        gitlab: "gitlab";
+        bitbucket: "bitbucket";
+        generic: "generic";
+    }>;
+    repositoryId: z.ZodNullable<z.ZodString>;
+    repositoryName: z.ZodString;
+    repositoryFullName: z.ZodString;
+    defaultBranch: z.ZodString;
+    productionBranch: z.ZodString;
+    cloneUrl: z.ZodString;
+    githubInstallationId: z.ZodNullable<z.ZodString>;
+    credentialConfigured: z.ZodBoolean;
+    autoDeployProduction: z.ZodBoolean;
+    autoDeployPreviews: z.ZodBoolean;
+    buildSettings: z.ZodObject<{
+        rootDirectory: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        installDirectory: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        installCommand: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        buildCommand: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        outputDirectory: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        ignoredBuildCommand: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        frameworkPreset: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        platformPreset: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        allowUnsupportedPlatformFeatures: z.ZodDefault<z.ZodBoolean>;
+        timeoutSeconds: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>;
+    connectedUserId: z.ZodNullable<z.ZodString>;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+}, z.core.$strip>;
+export declare const gitConnectionCreateSchema: z.ZodPipe<z.ZodObject<{
+    provider: z.ZodDefault<z.ZodEnum<{
+        github: "github";
+        gitlab: "gitlab";
+        bitbucket: "bitbucket";
+        generic: "generic";
+    }>>;
+    repositoryId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    repositoryName: z.ZodOptional<z.ZodString>;
+    repositoryFullName: z.ZodString;
+    defaultBranch: z.ZodDefault<z.ZodString>;
+    productionBranch: z.ZodOptional<z.ZodString>;
+    cloneUrl: z.ZodString;
+    githubInstallationId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    credential: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    autoDeployProduction: z.ZodDefault<z.ZodBoolean>;
+    autoDeployPreviews: z.ZodDefault<z.ZodBoolean>;
+    buildSettings: z.ZodOptional<z.ZodObject<{
+        rootDirectory: z.ZodOptional<z.ZodDefault<z.ZodNullable<z.ZodString>>>;
+        installDirectory: z.ZodOptional<z.ZodDefault<z.ZodNullable<z.ZodString>>>;
+        installCommand: z.ZodOptional<z.ZodDefault<z.ZodNullable<z.ZodString>>>;
+        buildCommand: z.ZodOptional<z.ZodDefault<z.ZodNullable<z.ZodString>>>;
+        outputDirectory: z.ZodOptional<z.ZodDefault<z.ZodNullable<z.ZodString>>>;
+        ignoredBuildCommand: z.ZodOptional<z.ZodDefault<z.ZodNullable<z.ZodString>>>;
+        frameworkPreset: z.ZodOptional<z.ZodDefault<z.ZodNullable<z.ZodString>>>;
+        platformPreset: z.ZodOptional<z.ZodDefault<z.ZodNullable<z.ZodString>>>;
+        allowUnsupportedPlatformFeatures: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+        timeoutSeconds: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>, z.ZodTransform<{
+    productionBranch: string;
+    provider: "github" | "gitlab" | "bitbucket" | "generic";
+    repositoryFullName: string;
+    defaultBranch: string;
+    cloneUrl: string;
+    autoDeployProduction: boolean;
+    autoDeployPreviews: boolean;
+    repositoryId?: string | null | undefined;
+    repositoryName?: string | undefined;
+    githubInstallationId?: string | null | undefined;
+    credential?: string | null | undefined;
+    buildSettings?: {
+        rootDirectory?: string | null | undefined;
+        installDirectory?: string | null | undefined;
+        installCommand?: string | null | undefined;
+        buildCommand?: string | null | undefined;
+        outputDirectory?: string | null | undefined;
+        ignoredBuildCommand?: string | null | undefined;
+        frameworkPreset?: string | null | undefined;
+        platformPreset?: string | null | undefined;
+        allowUnsupportedPlatformFeatures?: boolean | undefined;
+        timeoutSeconds?: number | undefined;
+    } | undefined;
+}, {
+    provider: "github" | "gitlab" | "bitbucket" | "generic";
+    repositoryFullName: string;
+    defaultBranch: string;
+    cloneUrl: string;
+    autoDeployProduction: boolean;
+    autoDeployPreviews: boolean;
+    repositoryId?: string | null | undefined;
+    repositoryName?: string | undefined;
+    productionBranch?: string | undefined;
+    githubInstallationId?: string | null | undefined;
+    credential?: string | null | undefined;
+    buildSettings?: {
+        rootDirectory?: string | null | undefined;
+        installDirectory?: string | null | undefined;
+        installCommand?: string | null | undefined;
+        buildCommand?: string | null | undefined;
+        outputDirectory?: string | null | undefined;
+        ignoredBuildCommand?: string | null | undefined;
+        frameworkPreset?: string | null | undefined;
+        platformPreset?: string | null | undefined;
+        allowUnsupportedPlatformFeatures?: boolean | undefined;
+        timeoutSeconds?: number | undefined;
+    } | undefined;
+}>>;
+export declare const gitConnectionPatchSchema: z.ZodObject<{
+    productionBranch: z.ZodOptional<z.ZodString>;
+    cloneUrl: z.ZodOptional<z.ZodString>;
+    credential: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    autoDeployProduction: z.ZodOptional<z.ZodBoolean>;
+    autoDeployPreviews: z.ZodOptional<z.ZodBoolean>;
+    buildSettings: z.ZodOptional<z.ZodObject<{
+        rootDirectory: z.ZodOptional<z.ZodDefault<z.ZodNullable<z.ZodString>>>;
+        installDirectory: z.ZodOptional<z.ZodDefault<z.ZodNullable<z.ZodString>>>;
+        installCommand: z.ZodOptional<z.ZodDefault<z.ZodNullable<z.ZodString>>>;
+        buildCommand: z.ZodOptional<z.ZodDefault<z.ZodNullable<z.ZodString>>>;
+        outputDirectory: z.ZodOptional<z.ZodDefault<z.ZodNullable<z.ZodString>>>;
+        ignoredBuildCommand: z.ZodOptional<z.ZodDefault<z.ZodNullable<z.ZodString>>>;
+        frameworkPreset: z.ZodOptional<z.ZodDefault<z.ZodNullable<z.ZodString>>>;
+        platformPreset: z.ZodOptional<z.ZodDefault<z.ZodNullable<z.ZodString>>>;
+        allowUnsupportedPlatformFeatures: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+        timeoutSeconds: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const gitConnectionAnalyzeSchema: z.ZodObject<{
+    ref: z.ZodOptional<z.ZodString>;
+    rootDirectory: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+export declare const gitConnectionAnalyzeCandidateSchema: z.ZodObject<{
+    rootDirectory: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    installDirectory: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    installCommand: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    buildCommand: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    outputDirectory: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    ignoredBuildCommand: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    frameworkPreset: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    platformPreset: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    allowUnsupportedPlatformFeatures: z.ZodDefault<z.ZodBoolean>;
+    timeoutSeconds: z.ZodDefault<z.ZodNumber>;
+    workingDirectory: z.ZodString;
+    confidence: z.ZodNumber;
+    reasons: z.ZodArray<z.ZodString>;
+    detectedFiles: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export declare const gitConnectionAnalyzeResponseSchema: z.ZodObject<{
+    detected: z.ZodObject<{
+        rootDirectory: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        installDirectory: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        installCommand: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        buildCommand: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        outputDirectory: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        ignoredBuildCommand: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        frameworkPreset: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        platformPreset: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        allowUnsupportedPlatformFeatures: z.ZodDefault<z.ZodBoolean>;
+        timeoutSeconds: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>;
+    detectedFiles: z.ZodArray<z.ZodString>;
+    candidates: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        rootDirectory: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        installDirectory: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        installCommand: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        buildCommand: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        outputDirectory: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        ignoredBuildCommand: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        frameworkPreset: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        platformPreset: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        allowUnsupportedPlatformFeatures: z.ZodDefault<z.ZodBoolean>;
+        timeoutSeconds: z.ZodDefault<z.ZodNumber>;
+        workingDirectory: z.ZodString;
+        confidence: z.ZodNumber;
+        reasons: z.ZodArray<z.ZodString>;
+        detectedFiles: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>>>;
+    platformConfigs: z.ZodArray<z.ZodObject<{
+        platform: z.ZodEnum<{
+            vercel: "vercel";
+            netlify: "netlify";
+            "cloudflare-pages": "cloudflare-pages";
+        }>;
+        rootDirectory: z.ZodNullable<z.ZodString>;
+        installDirectory: z.ZodNullable<z.ZodString>;
+        installCommand: z.ZodNullable<z.ZodString>;
+        buildCommand: z.ZodNullable<z.ZodString>;
+        outputDirectory: z.ZodNullable<z.ZodString>;
+        unsupportedFeatures: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>>;
+    unsupportedFeatures: z.ZodArray<z.ZodString>;
+    blocked: z.ZodBoolean;
+    message: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export declare const githubInstallationSchema: z.ZodObject<{
+    id: z.ZodString;
+    accountLogin: z.ZodString;
+    accountType: z.ZodNullable<z.ZodString>;
+    htmlUrl: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export declare const githubInstallationsResponseSchema: z.ZodObject<{
+    appConfigured: z.ZodBoolean;
+    installUrl: z.ZodNullable<z.ZodString>;
+    installations: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        accountLogin: z.ZodString;
+        accountType: z.ZodNullable<z.ZodString>;
+        htmlUrl: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const githubInstallationClaimSchema: z.ZodObject<{
+    installationId: z.ZodString;
+    state: z.ZodString;
+}, z.core.$strip>;
+export declare const githubInstallationClaimResponseSchema: z.ZodObject<{
+    installation: z.ZodObject<{
+        id: z.ZodString;
+        accountLogin: z.ZodString;
+        accountType: z.ZodNullable<z.ZodString>;
+        htmlUrl: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export declare const githubRepositorySchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    fullName: z.ZodString;
+    defaultBranch: z.ZodString;
+    cloneUrl: z.ZodString;
+    private: z.ZodBoolean;
+}, z.core.$strip>;
+export type BuildTarget = z.infer<typeof buildTarget>;
+export type BuildTrigger = z.infer<typeof buildTrigger>;
+export type BuildEnvironmentScope = z.infer<typeof buildEnvironmentScope>;
+export type GitBuildSettings = z.infer<typeof gitBuildSettingsSchema>;
+export type GitConnection = z.infer<typeof gitConnectionSchema>;
+export type GitConnectionCreate = z.infer<typeof gitConnectionCreateSchema>;
+export type GitConnectionPatch = z.infer<typeof gitConnectionPatchSchema>;
+export type GitConnectionAnalyzeResponse = z.infer<typeof gitConnectionAnalyzeResponseSchema>;

package/dist/contracts/git.js

@@ -0,0 +1,116 @@
+import { z } from "zod";
+import { BuildSettingsSchema } from "./builds.js";
+import { gitProvider } from "./enums.js";
+const nullableString = z.string().trim().min(1).nullable();
+export const buildTargetValues = ["production", "preview"];
+export const buildTriggerValues = ["manual", "push", "pull_request", "retry"];
+export const buildTarget = z.enum(buildTargetValues);
+export const buildTrigger = z.enum(buildTriggerValues);
+export const buildEnvironmentScopeValues = [
+    "runtime",
+    "build",
+    "build:production",
+    "build:preview",
+];
+export const buildEnvironmentScope = z.enum(buildEnvironmentScopeValues);
+export const gitBuildSettingsSchema = BuildSettingsSchema;
+export const gitPlatformDetectionSchema = z.object({
+    platform: z.enum(["vercel", "netlify", "cloudflare-pages"]),
+    rootDirectory: nullableString,
+    installDirectory: nullableString,
+    installCommand: nullableString,
+    buildCommand: nullableString,
+    outputDirectory: nullableString,
+    unsupportedFeatures: z.array(z.string()),
+});
+export const gitConnectionSchema = z.object({
+    id: z.string(),
+    spaceId: z.string(),
+    provider: gitProvider,
+    repositoryId: z.string().nullable(),
+    repositoryName: z.string(),
+    repositoryFullName: z.string(),
+    defaultBranch: z.string(),
+    productionBranch: z.string(),
+    cloneUrl: z.string(),
+    githubInstallationId: z.string().nullable(),
+    credentialConfigured: z.boolean(),
+    autoDeployProduction: z.boolean(),
+    autoDeployPreviews: z.boolean(),
+    buildSettings: gitBuildSettingsSchema,
+    connectedUserId: z.string().nullable(),
+    createdAt: z.string().datetime(),
+    updatedAt: z.string().datetime(),
+});
+export const gitConnectionCreateSchema = z
+    .object({
+    provider: gitProvider.default("github"),
+    repositoryId: z.string().trim().min(1).nullable().optional(),
+    repositoryName: z.string().trim().min(1).optional(),
+    repositoryFullName: z.string().trim().min(1),
+    defaultBranch: z.string().trim().min(1).default("main"),
+    productionBranch: z.string().trim().min(1).optional(),
+    cloneUrl: z.string().trim().min(1),
+    githubInstallationId: z.string().trim().min(1).nullable().optional(),
+    credential: z.string().trim().min(1).nullable().optional(),
+    autoDeployProduction: z.boolean().default(true),
+    autoDeployPreviews: z.boolean().default(true),
+    buildSettings: gitBuildSettingsSchema.partial().optional(),
+})
+    .transform((value) => ({
+    ...value,
+    productionBranch: value.productionBranch ?? value.defaultBranch,
+}));
+export const gitConnectionPatchSchema = z.object({
+    productionBranch: z.string().trim().min(1).optional(),
+    cloneUrl: z.string().trim().min(1).optional(),
+    credential: z.string().trim().min(1).nullable().optional(),
+    autoDeployProduction: z.boolean().optional(),
+    autoDeployPreviews: z.boolean().optional(),
+    buildSettings: gitBuildSettingsSchema.partial().optional(),
+});
+export const gitConnectionAnalyzeSchema = z.object({
+    ref: z.string().trim().min(1).optional(),
+    rootDirectory: z.string().trim().min(1).nullable().optional(),
+});
+export const gitConnectionAnalyzeCandidateSchema = gitBuildSettingsSchema.extend({
+    workingDirectory: z.string(),
+    confidence: z.number().int().nonnegative(),
+    reasons: z.array(z.string()),
+    detectedFiles: z.array(z.string()),
+});
+export const gitConnectionAnalyzeResponseSchema = z.object({
+    detected: gitBuildSettingsSchema,
+    detectedFiles: z.array(z.string()),
+    candidates: z.array(gitConnectionAnalyzeCandidateSchema).default([]),
+    platformConfigs: z.array(gitPlatformDetectionSchema),
+    unsupportedFeatures: z.array(z.string()),
+    blocked: z.boolean(),
+    message: z.string().nullable(),
+});
+export const githubInstallationSchema = z.object({
+    id: z.string(),
+    accountLogin: z.string(),
+    accountType: z.string().nullable(),
+    htmlUrl: z.string().url().nullable(),
+});
+export const githubInstallationsResponseSchema = z.object({
+    appConfigured: z.boolean(),
+    installUrl: z.string().url().nullable(),
+    installations: z.array(githubInstallationSchema),
+});
+export const githubInstallationClaimSchema = z.object({
+    installationId: z.string().trim().min(1),
+    state: z.string().trim().min(1),
+});
+export const githubInstallationClaimResponseSchema = z.object({
+    installation: githubInstallationSchema,
+});
+export const githubRepositorySchema = z.object({
+    id: z.string(),
+    name: z.string(),
+    fullName: z.string(),
+    defaultBranch: z.string(),
+    cloneUrl: z.string(),
+    private: z.boolean(),
+});

package/dist/contracts/ids.d.ts

@@ -0,0 +1,35 @@
+export declare const ID_PREFIXES: {
+    readonly ten: "Tenant";
+    readonly site: "Site";
+    readonly spc: "Space";
+    readonly ver: "Version";
+    readonly ann: "AnnotationThread";
+    readonly bld: "Build";
+    readonly dom: "Domain";
+    readonly dbn: "DomainBinding";
+    readonly sda: "SiteDomainAssignment";
+    readonly key: "ApiKey";
+    readonly upl: "UploadSession";
+    readonly psh: "PushNewSession";
+    readonly imp: "SpaceImport";
+    readonly exp: "SpaceExport";
+    readonly trf: "SpaceTransfer";
+    readonly op: "Operation";
+    readonly whk: "Webhook";
+    readonly whd: "WebhookDelivery";
+    readonly rec: "DnsRecord";
+    readonly evt: "ActivityEvent";
+    readonly pvc: "ProviderClient";
+    readonly tgs: "TagSet";
+    readonly tgv: "TagVersion";
+    readonly tgr: "TagRelease";
+    readonly tga: "TagRuntimeArtifact";
+    readonly tgp: "TagPreviewSession";
+    readonly bhk: "BuildHook";
+};
+export type IdPrefix = keyof typeof ID_PREFIXES;
+/** Any registered public resource id, e.g. `spc_…` or `ver_…`. */
+export type Id = `${IdPrefix}_${string}`;
+export declare const MAIN_TENANT_ID = "ten_main";
+/** Mint a globally unique id for a registered public resource prefix. */
+export declare function createId<P extends IdPrefix>(prefix: P): `${P}_${string}`;

package/dist/contracts/ids.js

@@ -0,0 +1,45 @@
+// Id prefix registry (internal-docs/platform.md "Id prefix registry", L1106-1127).
+// Every PUBLIC resource registers a prefix here before it ships; ids are globally
+// unique and handle ids (operations, exports, imports, transfers, builds) are
+// fetchable at a top-level collection with no extra context. Control-plane-internal
+// rows that never surface as public resource ids mint through the internal prefix
+// list in `apps/control-plane/src/lib/ids.ts`; promote a prefix into this table
+// before exposing the resource.
+export const ID_PREFIXES = {
+    ten: "Tenant",
+    site: "Site",
+    spc: "Space",
+    ver: "Version",
+    ann: "AnnotationThread",
+    bld: "Build",
+    dom: "Domain",
+    dbn: "DomainBinding",
+    sda: "SiteDomainAssignment",
+    key: "ApiKey",
+    upl: "UploadSession",
+    psh: "PushNewSession",
+    imp: "SpaceImport",
+    exp: "SpaceExport",
+    trf: "SpaceTransfer",
+    op: "Operation",
+    whk: "Webhook",
+    whd: "WebhookDelivery",
+    rec: "DnsRecord",
+    evt: "ActivityEvent",
+    pvc: "ProviderClient",
+    tgs: "TagSet",
+    tgv: "TagVersion",
+    tgr: "TagRelease",
+    tga: "TagRuntimeArtifact",
+    tgp: "TagPreviewSession",
+    // Reserved for the deferred build-hook surface; never minted yet.
+    bhk: "BuildHook",
+};
+// The main Stattic tenant every self-serve team/user/resource lives under. A
+// well-known CONSTANT, never configuration: grammatically a normal tenant id with
+// zero special cases in contracts, policy URIs, or parsers (spec L1100-1105).
+export const MAIN_TENANT_ID = "ten_main";
+/** Mint a globally unique id for a registered public resource prefix. */
+export function createId(prefix) {
+    return `${prefix}_${crypto.randomUUID().replaceAll("-", "")}`;
+}

package/dist/contracts/intercom.d.ts

@@ -0,0 +1,6 @@
+import { z } from "zod";
+export declare const IntercomMessengerJwtSchema: z.ZodObject<{
+    token: z.ZodString;
+    expiresAt: z.ZodString;
+}, z.core.$strip>;
+export type IntercomMessengerJwt = z.infer<typeof IntercomMessengerJwtSchema>;

package/dist/contracts/intercom.js

@@ -0,0 +1,5 @@
+import { z } from "zod";
+export const IntercomMessengerJwtSchema = z.object({
+    token: z.string().min(1).describe("Server-signed Intercom Messenger JWT."),
+    expiresAt: z.string().datetime().describe("JWT expiry timestamp."),
+});

package/dist/contracts/internal.d.ts

@@ -0,0 +1,103 @@
+import { z } from "zod";
+export declare const conventionFilesSchema: z.ZodObject<{
+    redirects: z.ZodOptional<z.ZodString>;
+    headers: z.ZodOptional<z.ZodString>;
+    routes: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const manifestFileSchema: z.ZodObject<{
+    path: z.ZodString;
+    size: z.ZodNumber;
+    sha256: z.ZodOptional<z.ZodString>;
+    contentType: z.ZodOptional<z.ZodString>;
+    sourceUrl: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const pendingUploadSchema: z.ZodObject<{
+    path: z.ZodString;
+    size: z.ZodNumber;
+    sha256: z.ZodOptional<z.ZodString>;
+    sourceUrl: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const uploadSessionModeSchema: z.ZodEnum<{
+    dist: "dist";
+    source: "source";
+}>;
+export declare const uploadTargetSchema: z.ZodObject<{
+    path: z.ZodString;
+    method: z.ZodEnum<{
+        PUT: "PUT";
+        POST: "POST";
+    }>;
+    url: z.ZodUnion<[z.ZodString, z.ZodString]>;
+    headers: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+    body: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"url">;
+        url: z.ZodString;
+    }, z.core.$strip>], "kind">>;
+    size: z.ZodOptional<z.ZodNumber>;
+    maxBytes: z.ZodOptional<z.ZodNumber>;
+    sha256: z.ZodOptional<z.ZodString>;
+    contentType: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const uploadInstructionsSchema: z.ZodObject<{
+    id: z.ZodString;
+    mode: z.ZodEnum<{
+        dist: "dist";
+        source: "source";
+    }>;
+    expiresAt: z.ZodString;
+    summary: z.ZodObject<{
+        upload: z.ZodNumber;
+        reused: z.ZodNumber;
+        ignored: z.ZodNumber;
+    }, z.core.$strip>;
+    targets: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        method: z.ZodEnum<{
+            PUT: "PUT";
+            POST: "POST";
+        }>;
+        url: z.ZodUnion<[z.ZodString, z.ZodString]>;
+        headers: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+        body: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"url">;
+            url: z.ZodString;
+        }, z.core.$strip>], "kind">>;
+        size: z.ZodOptional<z.ZodNumber>;
+        maxBytes: z.ZodOptional<z.ZodNumber>;
+        sha256: z.ZodOptional<z.ZodString>;
+        contentType: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    links: z.ZodObject<{
+        resume: z.ZodString;
+        finalize: z.ZodString;
+    }, z.core.$strip>;
+    details: z.ZodOptional<z.ZodObject<{
+        reused: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            path: z.ZodString;
+            reason: z.ZodString;
+        }, z.core.$strip>>>;
+        ignored: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            path: z.ZodString;
+            reason: z.ZodString;
+        }, z.core.$strip>>>;
+        diagnostics: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            code: z.ZodString;
+            severity: z.ZodEnum<{
+                info: "info";
+                warning: "warning";
+                error: "error";
+            }>;
+            message: z.ZodString;
+            path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            provider: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+                wpcloud: "wpcloud";
+                dns: "dns";
+                registrar: "registrar";
+                runtime: "runtime";
+            }>>>;
+            details: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+            fix: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            retryable: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;