@columnus/shared 0.1.47

package/dist/bffProtocol.d.ts

@@ -0,0 +1,1357 @@
+import { z } from "zod";
+import { MAX_TRANSFER_BYTES } from "./dataTransfer.ts";
+/** Versioned BFF ↔ Management ↔ deploy-service contract (D32). */
+export declare const COLUMNUS_BFF_PROTOCOL_VERSION: 1;
+export declare const COLUMNUS_BFF_API_PREFIX: "/api/columnus/v1";
+export declare const COLUMNUS_BFF_MANAGEMENT_PREFIX: "/internal/columnus-bff/v1";
+export declare const COLUMNUS_DEPLOY_INTERNAL_PREFIX: "/internal/v1";
+export declare const COLUMNUS_DEPLOY_OPS_PREFIX: "/ops/v1";
+/** Header carrying COLUMNUS_BFF_MANAGEMENT_SECRET (D6). */
+export declare const COLUMNUS_BFF_MANAGEMENT_SECRET_HEADER: "x-columnus-bff-management-secret";
+/** Header carrying COLUMNUS_PREVIEW_REGISTRATION_SECRET (D25). */
+export declare const COLUMNUS_PREVIEW_REGISTRATION_SECRET_HEADER: "x-columnus-preview-registration-secret";
+/** Caller-generated operation / idempotency IDs (not authorization credentials). */
+export declare const OPERATION_ID_RE: RegExp;
+/** Server-issued random transfer IDs (D10) — not signed bearer tokens. */
+export declare const TRANSFER_ID_RE: RegExp;
+export declare const MANIFEST_HASH_RE: RegExp;
+export declare const TABLE_NAME_RE: RegExp;
+export declare const operationIdSchema: z.ZodString;
+export declare const transferIdSchema: z.ZodString;
+export declare const manifestHashSchema: z.ZodString;
+export declare const bffPrepareOperationTypeSchema: z.ZodEnum<["schemaDeploy", "dataExport", "dataImportPrepare", "dataImportCommit"]>;
+export type BffPrepareOperationType = z.infer<typeof bffPrepareOperationTypeSchema>;
+export declare const transferOperationSchema: z.ZodEnum<["export", "import"]>;
+export type TransferOperation = z.infer<typeof transferOperationSchema>;
+export declare const transferSessionStateSchema: z.ZodEnum<["exportReady", "importAwaitingUpload", "importUploaded", "importCommitted", "importFailed", "expired"]>;
+export type TransferSessionState = z.infer<typeof transferSessionStateSchema>;
+export declare const schemaDeployPhaseSchema: z.ZodEnum<["cleaning", "ready", "deploying", "succeeded", "failed"]>;
+export type SchemaDeployPhase = z.infer<typeof schemaDeployPhaseSchema>;
+/** Active schema operations hold this lease before a new operation may supersede them. */
+export declare const SCHEMA_DEPLOY_OPERATION_LEASE_MS: number;
+export declare function isSchemaDeployPhaseActive(phase: string | undefined): boolean;
+export declare function hasSchemaDeployOperationLeaseExpired(startedAt: number | undefined, now: number): boolean;
+/** Cryptographically random ID suitable for operationId / transferId. */
+export declare function createRandomId(byteLength?: number): string;
+export declare function createOperationId(): string;
+export declare function createTransferId(): string;
+export declare function isOperationId(value: string): boolean;
+export declare function isTransferId(value: string): boolean;
+export declare function isManifestHash(value: string): boolean;
+/** True when completion should apply: same operation and matching desired hash. */
+export declare function matchesDeployCompletion(args: {
+    activeOperationId: string | undefined;
+    activeDesiredHash: string | undefined;
+    completionOperationId: string;
+    completionManifestHash: string;
+}): boolean;
+export declare const dataTransferManifestSchema: z.ZodEffects<z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    tables: z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">;
+    schemaHash: z.ZodString;
+    includeFileStorage: z.ZodBoolean;
+}, "strip", z.ZodTypeAny, {
+    tables: string[];
+    version: 1;
+    schemaHash: string;
+    includeFileStorage: boolean;
+}, {
+    tables: string[];
+    version: 1;
+    schemaHash: string;
+    includeFileStorage: boolean;
+}>, {
+    tables: string[];
+    version: 1;
+    schemaHash: string;
+    includeFileStorage: boolean;
+}, {
+    tables: string[];
+    version: 1;
+    schemaHash: string;
+    includeFileStorage: boolean;
+}>;
+export type DataTransferManifestV1 = z.infer<typeof dataTransferManifestSchema>;
+export declare const bffSchemaDeployRequestSchema: z.ZodObject<{
+    operationId: z.ZodString;
+    manifestJson: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    operationId: string;
+    manifestJson: string;
+}, {
+    operationId: string;
+    manifestJson: string;
+}>;
+export type BffSchemaDeployRequest = z.infer<typeof bffSchemaDeployRequestSchema>;
+export declare const bffTransferScopeRequestSchema: z.ZodObject<{
+    operationId: z.ZodString;
+    tables: z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">;
+    schemaHash: z.ZodString;
+    includeFileStorage: z.ZodBoolean;
+}, "strip", z.ZodTypeAny, {
+    tables: string[];
+    schemaHash: string;
+    includeFileStorage: boolean;
+    operationId: string;
+}, {
+    tables: string[];
+    schemaHash: string;
+    includeFileStorage: boolean;
+    operationId: string;
+}>;
+export type BffTransferScopeRequest = z.infer<typeof bffTransferScopeRequestSchema>;
+export declare const bffTransferCommitRequestSchema: z.ZodObject<{
+    operationId: z.ZodString;
+    /** Client echo; server also rechecks the transfer-bound hash. */
+    schemaHash: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    schemaHash: string;
+    operationId: string;
+}, {
+    schemaHash: string;
+    operationId: string;
+}>;
+export type BffTransferCommitRequest = z.infer<typeof bffTransferCommitRequestSchema>;
+export type BffTransferCommitArgs = BffTransferCommitRequest & {
+    transferId: z.infer<typeof transferIdSchema>;
+};
+export declare const bffHealthResponseSchema: z.ZodObject<{
+    ok: z.ZodBoolean;
+    commit: z.ZodString;
+    executor: z.ZodObject<{
+        ok: z.ZodBoolean;
+        commit: z.ZodOptional<z.ZodString>;
+        error: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        ok: boolean;
+        error?: string | undefined;
+        commit?: string | undefined;
+    }, {
+        ok: boolean;
+        error?: string | undefined;
+        commit?: string | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    ok: boolean;
+    commit: string;
+    executor: {
+        ok: boolean;
+        error?: string | undefined;
+        commit?: string | undefined;
+    };
+}, {
+    ok: boolean;
+    commit: string;
+    executor: {
+        ok: boolean;
+        error?: string | undefined;
+        commit?: string | undefined;
+    };
+}>;
+export type BffHealthResponse = z.infer<typeof bffHealthResponseSchema>;
+export declare const bffActiveOperationMetaSchema: z.ZodObject<{
+    operationId: z.ZodString;
+    desiredManifestHash: z.ZodOptional<z.ZodString>;
+    phase: z.ZodOptional<z.ZodEnum<["cleaning", "ready", "deploying", "succeeded", "failed"]>>;
+    startedAt: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    operationId: string;
+    desiredManifestHash?: string | undefined;
+    phase?: "cleaning" | "ready" | "deploying" | "succeeded" | "failed" | undefined;
+    startedAt?: number | undefined;
+}, {
+    operationId: string;
+    desiredManifestHash?: string | undefined;
+    phase?: "cleaning" | "ready" | "deploying" | "succeeded" | "failed" | undefined;
+    startedAt?: number | undefined;
+}>;
+export type BffActiveOperationMeta = z.infer<typeof bffActiveOperationMetaSchema>;
+export declare const bffSchemaDeployResponseSchema: z.ZodObject<{
+    ok: z.ZodBoolean;
+    operationId: z.ZodString;
+    phase: z.ZodEnum<["cleaning", "ready", "deploying", "succeeded", "failed"]>;
+    desiredManifestHash: z.ZodOptional<z.ZodString>;
+    deployedManifestHash: z.ZodOptional<z.ZodString>;
+    error: z.ZodOptional<z.ZodString>;
+    logTail: z.ZodOptional<z.ZodString>;
+    activeOperation: z.ZodOptional<z.ZodObject<{
+        operationId: z.ZodString;
+        desiredManifestHash: z.ZodOptional<z.ZodString>;
+        phase: z.ZodOptional<z.ZodEnum<["cleaning", "ready", "deploying", "succeeded", "failed"]>>;
+        startedAt: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        operationId: string;
+        desiredManifestHash?: string | undefined;
+        phase?: "cleaning" | "ready" | "deploying" | "succeeded" | "failed" | undefined;
+        startedAt?: number | undefined;
+    }, {
+        operationId: string;
+        desiredManifestHash?: string | undefined;
+        phase?: "cleaning" | "ready" | "deploying" | "succeeded" | "failed" | undefined;
+        startedAt?: number | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    ok: boolean;
+    operationId: string;
+    phase: "cleaning" | "ready" | "deploying" | "succeeded" | "failed";
+    error?: string | undefined;
+    desiredManifestHash?: string | undefined;
+    deployedManifestHash?: string | undefined;
+    logTail?: string | undefined;
+    activeOperation?: {
+        operationId: string;
+        desiredManifestHash?: string | undefined;
+        phase?: "cleaning" | "ready" | "deploying" | "succeeded" | "failed" | undefined;
+        startedAt?: number | undefined;
+    } | undefined;
+}, {
+    ok: boolean;
+    operationId: string;
+    phase: "cleaning" | "ready" | "deploying" | "succeeded" | "failed";
+    error?: string | undefined;
+    desiredManifestHash?: string | undefined;
+    deployedManifestHash?: string | undefined;
+    logTail?: string | undefined;
+    activeOperation?: {
+        operationId: string;
+        desiredManifestHash?: string | undefined;
+        phase?: "cleaning" | "ready" | "deploying" | "succeeded" | "failed" | undefined;
+        startedAt?: number | undefined;
+    } | undefined;
+}>;
+export type BffSchemaDeployResponse = z.infer<typeof bffSchemaDeployResponseSchema>;
+export declare const bffTransferCreateResponseSchema: z.ZodObject<{
+    ok: z.ZodLiteral<true>;
+    transferId: z.ZodString;
+    expiresAt: z.ZodNumber;
+    bytes: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    ok: true;
+    transferId: string;
+    expiresAt: number;
+    bytes?: number | undefined;
+}, {
+    ok: true;
+    transferId: string;
+    expiresAt: number;
+    bytes?: number | undefined;
+}>;
+export type BffTransferCreateResponse = z.infer<typeof bffTransferCreateResponseSchema>;
+export declare const bffTransferCommitResponseSchema: z.ZodObject<{
+    ok: z.ZodBoolean;
+    transferId: z.ZodString;
+    error: z.ZodOptional<z.ZodString>;
+    logTail: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    ok: boolean;
+    transferId: string;
+    error?: string | undefined;
+    logTail?: string | undefined;
+}, {
+    ok: boolean;
+    transferId: string;
+    error?: string | undefined;
+    logTail?: string | undefined;
+}>;
+export type BffTransferCommitResponse = z.infer<typeof bffTransferCommitResponseSchema>;
+export declare const bffTransferUploadResponseSchema: z.ZodObject<{
+    ok: z.ZodLiteral<true>;
+    bytes: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    bytes: number;
+    ok: true;
+}, {
+    bytes: number;
+    ok: true;
+}>;
+export type BffTransferUploadResponse = z.infer<typeof bffTransferUploadResponseSchema>;
+export declare const bffErrorCodeSchema: z.ZodEnum<["unauthorized", "forbidden", "unknown_host", "disabled_host", "conflict", "executor_mismatch", "executor_unavailable", "validation_error", "not_found", "payload_too_large", "gone", "internal_error"]>;
+export type BffErrorCode = z.infer<typeof bffErrorCodeSchema>;
+export declare const bffErrorResponseSchema: z.ZodObject<{
+    ok: z.ZodLiteral<false>;
+    error: z.ZodString;
+    code: z.ZodOptional<z.ZodEnum<["unauthorized", "forbidden", "unknown_host", "disabled_host", "conflict", "executor_mismatch", "executor_unavailable", "validation_error", "not_found", "payload_too_large", "gone", "internal_error"]>>;
+    logTail: z.ZodOptional<z.ZodString>;
+    activeOperation: z.ZodOptional<z.ZodObject<{
+        operationId: z.ZodString;
+        desiredManifestHash: z.ZodOptional<z.ZodString>;
+        phase: z.ZodOptional<z.ZodEnum<["cleaning", "ready", "deploying", "succeeded", "failed"]>>;
+        startedAt: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        operationId: string;
+        desiredManifestHash?: string | undefined;
+        phase?: "cleaning" | "ready" | "deploying" | "succeeded" | "failed" | undefined;
+        startedAt?: number | undefined;
+    }, {
+        operationId: string;
+        desiredManifestHash?: string | undefined;
+        phase?: "cleaning" | "ready" | "deploying" | "succeeded" | "failed" | undefined;
+        startedAt?: number | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    error: string;
+    ok: false;
+    code?: "unauthorized" | "forbidden" | "unknown_host" | "disabled_host" | "conflict" | "executor_mismatch" | "executor_unavailable" | "validation_error" | "not_found" | "payload_too_large" | "gone" | "internal_error" | undefined;
+    logTail?: string | undefined;
+    activeOperation?: {
+        operationId: string;
+        desiredManifestHash?: string | undefined;
+        phase?: "cleaning" | "ready" | "deploying" | "succeeded" | "failed" | undefined;
+        startedAt?: number | undefined;
+    } | undefined;
+}, {
+    error: string;
+    ok: false;
+    code?: "unauthorized" | "forbidden" | "unknown_host" | "disabled_host" | "conflict" | "executor_mismatch" | "executor_unavailable" | "validation_error" | "not_found" | "payload_too_large" | "gone" | "internal_error" | undefined;
+    logTail?: string | undefined;
+    activeOperation?: {
+        operationId: string;
+        desiredManifestHash?: string | undefined;
+        phase?: "cleaning" | "ready" | "deploying" | "succeeded" | "failed" | undefined;
+        startedAt?: number | undefined;
+    } | undefined;
+}>;
+export type BffErrorResponse = z.infer<typeof bffErrorResponseSchema>;
+export declare const bffPrepareOperationSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+    type: z.ZodLiteral<"schemaDeploy">;
+    operationId: z.ZodString;
+    manifestJson: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: "schemaDeploy";
+    operationId: string;
+    manifestJson: string;
+}, {
+    type: "schemaDeploy";
+    operationId: string;
+    manifestJson: string;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"dataExport">;
+    operationId: z.ZodString;
+    transferManifest: z.ZodEffects<z.ZodObject<{
+        version: z.ZodLiteral<1>;
+        tables: z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">;
+        schemaHash: z.ZodString;
+        includeFileStorage: z.ZodBoolean;
+    }, "strip", z.ZodTypeAny, {
+        tables: string[];
+        version: 1;
+        schemaHash: string;
+        includeFileStorage: boolean;
+    }, {
+        tables: string[];
+        version: 1;
+        schemaHash: string;
+        includeFileStorage: boolean;
+    }>, {
+        tables: string[];
+        version: 1;
+        schemaHash: string;
+        includeFileStorage: boolean;
+    }, {
+        tables: string[];
+        version: 1;
+        schemaHash: string;
+        includeFileStorage: boolean;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    type: "dataExport";
+    operationId: string;
+    transferManifest: {
+        tables: string[];
+        version: 1;
+        schemaHash: string;
+        includeFileStorage: boolean;
+    };
+}, {
+    type: "dataExport";
+    operationId: string;
+    transferManifest: {
+        tables: string[];
+        version: 1;
+        schemaHash: string;
+        includeFileStorage: boolean;
+    };
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"dataImportPrepare">;
+    operationId: z.ZodString;
+    transferManifest: z.ZodEffects<z.ZodObject<{
+        version: z.ZodLiteral<1>;
+        tables: z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">;
+        schemaHash: z.ZodString;
+        includeFileStorage: z.ZodBoolean;
+    }, "strip", z.ZodTypeAny, {
+        tables: string[];
+        version: 1;
+        schemaHash: string;
+        includeFileStorage: boolean;
+    }, {
+        tables: string[];
+        version: 1;
+        schemaHash: string;
+        includeFileStorage: boolean;
+    }>, {
+        tables: string[];
+        version: 1;
+        schemaHash: string;
+        includeFileStorage: boolean;
+    }, {
+        tables: string[];
+        version: 1;
+        schemaHash: string;
+        includeFileStorage: boolean;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    type: "dataImportPrepare";
+    operationId: string;
+    transferManifest: {
+        tables: string[];
+        version: 1;
+        schemaHash: string;
+        includeFileStorage: boolean;
+    };
+}, {
+    type: "dataImportPrepare";
+    operationId: string;
+    transferManifest: {
+        tables: string[];
+        version: 1;
+        schemaHash: string;
+        includeFileStorage: boolean;
+    };
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"dataImportCommit">;
+    operationId: z.ZodString;
+    transferId: z.ZodString;
+    schemaHash: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: "dataImportCommit";
+    schemaHash: string;
+    operationId: string;
+    transferId: string;
+}, {
+    type: "dataImportCommit";
+    schemaHash: string;
+    operationId: string;
+    transferId: string;
+}>]>;
+export type BffPrepareOperation = z.infer<typeof bffPrepareOperationSchema>;
+export declare const bffPrepareRequestSchema: z.ZodObject<{
+    protocolVersion: z.ZodLiteral<1>;
+    /** Trusted hostname only (already extracted by BFF). */
+    host: z.ZodString;
+    correlationId: z.ZodOptional<z.ZodString>;
+    operation: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+        type: z.ZodLiteral<"schemaDeploy">;
+        operationId: z.ZodString;
+        manifestJson: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        type: "schemaDeploy";
+        operationId: string;
+        manifestJson: string;
+    }, {
+        type: "schemaDeploy";
+        operationId: string;
+        manifestJson: string;
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"dataExport">;
+        operationId: z.ZodString;
+        transferManifest: z.ZodEffects<z.ZodObject<{
+            version: z.ZodLiteral<1>;
+            tables: z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">;
+            schemaHash: z.ZodString;
+            includeFileStorage: z.ZodBoolean;
+        }, "strip", z.ZodTypeAny, {
+            tables: string[];
+            version: 1;
+            schemaHash: string;
+            includeFileStorage: boolean;
+        }, {
+            tables: string[];
+            version: 1;
+            schemaHash: string;
+            includeFileStorage: boolean;
+        }>, {
+            tables: string[];
+            version: 1;
+            schemaHash: string;
+            includeFileStorage: boolean;
+        }, {
+            tables: string[];
+            version: 1;
+            schemaHash: string;
+            includeFileStorage: boolean;
+        }>;
+    }, "strip", z.ZodTypeAny, {
+        type: "dataExport";
+        operationId: string;
+        transferManifest: {
+            tables: string[];
+            version: 1;
+            schemaHash: string;
+            includeFileStorage: boolean;
+        };
+    }, {
+        type: "dataExport";
+        operationId: string;
+        transferManifest: {
+            tables: string[];
+            version: 1;
+            schemaHash: string;
+            includeFileStorage: boolean;
+        };
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"dataImportPrepare">;
+        operationId: z.ZodString;
+        transferManifest: z.ZodEffects<z.ZodObject<{
+            version: z.ZodLiteral<1>;
+            tables: z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">;
+            schemaHash: z.ZodString;
+            includeFileStorage: z.ZodBoolean;
+        }, "strip", z.ZodTypeAny, {
+            tables: string[];
+            version: 1;
+            schemaHash: string;
+            includeFileStorage: boolean;
+        }, {
+            tables: string[];
+            version: 1;
+            schemaHash: string;
+            includeFileStorage: boolean;
+        }>, {
+            tables: string[];
+            version: 1;
+            schemaHash: string;
+            includeFileStorage: boolean;
+        }, {
+            tables: string[];
+            version: 1;
+            schemaHash: string;
+            includeFileStorage: boolean;
+        }>;
+    }, "strip", z.ZodTypeAny, {
+        type: "dataImportPrepare";
+        operationId: string;
+        transferManifest: {
+            tables: string[];
+            version: 1;
+            schemaHash: string;
+            includeFileStorage: boolean;
+        };
+    }, {
+        type: "dataImportPrepare";
+        operationId: string;
+        transferManifest: {
+            tables: string[];
+            version: 1;
+            schemaHash: string;
+            includeFileStorage: boolean;
+        };
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"dataImportCommit">;
+        operationId: z.ZodString;
+        transferId: z.ZodString;
+        schemaHash: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        type: "dataImportCommit";
+        schemaHash: string;
+        operationId: string;
+        transferId: string;
+    }, {
+        type: "dataImportCommit";
+        schemaHash: string;
+        operationId: string;
+        transferId: string;
+    }>]>;
+}, "strip", z.ZodTypeAny, {
+    host: string;
+    protocolVersion: 1;
+    operation: {
+        type: "schemaDeploy";
+        operationId: string;
+        manifestJson: string;
+    } | {
+        type: "dataExport";
+        operationId: string;
+        transferManifest: {
+            tables: string[];
+            version: 1;
+            schemaHash: string;
+            includeFileStorage: boolean;
+        };
+    } | {
+        type: "dataImportPrepare";
+        operationId: string;
+        transferManifest: {
+            tables: string[];
+            version: 1;
+            schemaHash: string;
+            includeFileStorage: boolean;
+        };
+    } | {
+        type: "dataImportCommit";
+        schemaHash: string;
+        operationId: string;
+        transferId: string;
+    };
+    correlationId?: string | undefined;
+}, {
+    host: string;
+    protocolVersion: 1;
+    operation: {
+        type: "schemaDeploy";
+        operationId: string;
+        manifestJson: string;
+    } | {
+        type: "dataExport";
+        operationId: string;
+        transferManifest: {
+            tables: string[];
+            version: 1;
+            schemaHash: string;
+            includeFileStorage: boolean;
+        };
+    } | {
+        type: "dataImportPrepare";
+        operationId: string;
+        transferManifest: {
+            tables: string[];
+            version: 1;
+            schemaHash: string;
+            includeFileStorage: boolean;
+        };
+    } | {
+        type: "dataImportCommit";
+        schemaHash: string;
+        operationId: string;
+        transferId: string;
+    };
+    correlationId?: string | undefined;
+}>;
+export type BffPrepareRequest = z.infer<typeof bffPrepareRequestSchema>;
+export declare const bffPreparedTenantSchema: z.ZodObject<{
+    slug: z.ZodString;
+    convexUrl: z.ZodString;
+    authIssuer: z.ZodOptional<z.ZodString>;
+    deploymentName: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    slug: string;
+    convexUrl: string;
+    authIssuer?: string | undefined;
+    deploymentName?: string | undefined;
+}, {
+    slug: string;
+    convexUrl: string;
+    authIssuer?: string | undefined;
+    deploymentName?: string | undefined;
+}>;
+export type BffPreparedTenant = z.infer<typeof bffPreparedTenantSchema>;
+/** Inner payload shapes for deploy-service `/internal/v1/*` (D39). */
+export declare const deployInternalSchemaDeployPayloadSchema: z.ZodObject<{
+    manifestJson: z.ZodString;
+    convexDeployKey: z.ZodString;
+    convexUrl: z.ZodString;
+    authIssuer: z.ZodOptional<z.ZodString>;
+    previewName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    operationId: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    manifestJson: string;
+    convexUrl: string;
+    convexDeployKey: string;
+    operationId?: string | undefined;
+    authIssuer?: string | undefined;
+    previewName?: string | null | undefined;
+}, {
+    manifestJson: string;
+    convexUrl: string;
+    convexDeployKey: string;
+    operationId?: string | undefined;
+    authIssuer?: string | undefined;
+    previewName?: string | null | undefined;
+}>;
+export type DeployInternalSchemaDeployPayload = z.infer<typeof deployInternalSchemaDeployPayloadSchema>;
+export declare const deployInternalTransferExportPayloadSchema: z.ZodObject<{
+    transferManifest: z.ZodEffects<z.ZodObject<{
+        version: z.ZodLiteral<1>;
+        tables: z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">;
+        schemaHash: z.ZodString;
+        includeFileStorage: z.ZodBoolean;
+    }, "strip", z.ZodTypeAny, {
+        tables: string[];
+        version: 1;
+        schemaHash: string;
+        includeFileStorage: boolean;
+    }, {
+        tables: string[];
+        version: 1;
+        schemaHash: string;
+        includeFileStorage: boolean;
+    }>, {
+        tables: string[];
+        version: 1;
+        schemaHash: string;
+        includeFileStorage: boolean;
+    }, {
+        tables: string[];
+        version: 1;
+        schemaHash: string;
+        includeFileStorage: boolean;
+    }>;
+    convexDeployKey: z.ZodString;
+    convexUrl: z.ZodString;
+    tenantSlug: z.ZodString;
+    operationId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    operationId: string;
+    transferManifest: {
+        tables: string[];
+        version: 1;
+        schemaHash: string;
+        includeFileStorage: boolean;
+    };
+    convexUrl: string;
+    convexDeployKey: string;
+    tenantSlug: string;
+}, {
+    operationId: string;
+    transferManifest: {
+        tables: string[];
+        version: 1;
+        schemaHash: string;
+        includeFileStorage: boolean;
+    };
+    convexUrl: string;
+    convexDeployKey: string;
+    tenantSlug: string;
+}>;
+export type DeployInternalTransferExportPayload = z.infer<typeof deployInternalTransferExportPayloadSchema>;
+export declare const deployInternalTransferImportPreparePayloadSchema: z.ZodObject<{
+    transferManifest: z.ZodEffects<z.ZodObject<{
+        version: z.ZodLiteral<1>;
+        tables: z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">;
+        schemaHash: z.ZodString;
+        includeFileStorage: z.ZodBoolean;
+    }, "strip", z.ZodTypeAny, {
+        tables: string[];
+        version: 1;
+        schemaHash: string;
+        includeFileStorage: boolean;
+    }, {
+        tables: string[];
+        version: 1;
+        schemaHash: string;
+        includeFileStorage: boolean;
+    }>, {
+        tables: string[];
+        version: 1;
+        schemaHash: string;
+        includeFileStorage: boolean;
+    }, {
+        tables: string[];
+        version: 1;
+        schemaHash: string;
+        includeFileStorage: boolean;
+    }>;
+    convexDeployKey: z.ZodString;
+    convexUrl: z.ZodString;
+    tenantSlug: z.ZodString;
+    operationId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    operationId: string;
+    transferManifest: {
+        tables: string[];
+        version: 1;
+        schemaHash: string;
+        includeFileStorage: boolean;
+    };
+    convexUrl: string;
+    convexDeployKey: string;
+    tenantSlug: string;
+}, {
+    operationId: string;
+    transferManifest: {
+        tables: string[];
+        version: 1;
+        schemaHash: string;
+        includeFileStorage: boolean;
+    };
+    convexUrl: string;
+    convexDeployKey: string;
+    tenantSlug: string;
+}>;
+export type DeployInternalTransferImportPreparePayload = z.infer<typeof deployInternalTransferImportPreparePayloadSchema>;
+export declare const deployInternalTransferCommitPayloadSchema: z.ZodObject<{
+    transferId: z.ZodString;
+    convexDeployKey: z.ZodString;
+    convexUrl: z.ZodString;
+    tenantSlug: z.ZodString;
+    operationId: z.ZodString;
+    schemaHash: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    schemaHash: string;
+    operationId: string;
+    transferId: string;
+    convexUrl: string;
+    convexDeployKey: string;
+    tenantSlug: string;
+}, {
+    schemaHash: string;
+    operationId: string;
+    transferId: string;
+    convexUrl: string;
+    convexDeployKey: string;
+    tenantSlug: string;
+}>;
+export type DeployInternalTransferCommitPayload = z.infer<typeof deployInternalTransferCommitPayloadSchema>;
+/**
+ * Management prepare response: a discriminated envelope whose operation owns
+ * the exact deploy-service payload shape. BFF forwards `payload` wholesale and
+ * must never log it as a unit.
+ */
+export declare const bffPreparedBodyEnvelopeSchema: z.ZodDiscriminatedUnion<"operation", [z.ZodObject<{
+    protocolVersion: z.ZodLiteral<1>;
+    tenant: z.ZodObject<{
+        slug: z.ZodString;
+        convexUrl: z.ZodString;
+        authIssuer: z.ZodOptional<z.ZodString>;
+        deploymentName: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        slug: string;
+        convexUrl: string;
+        authIssuer?: string | undefined;
+        deploymentName?: string | undefined;
+    }, {
+        slug: string;
+        convexUrl: string;
+        authIssuer?: string | undefined;
+        deploymentName?: string | undefined;
+    }>;
+    correlationId: z.ZodOptional<z.ZodString>;
+} & {
+    operation: z.ZodLiteral<"schemaDeploy">;
+    payload: z.ZodObject<{
+        manifestJson: z.ZodString;
+        convexDeployKey: z.ZodString;
+        convexUrl: z.ZodString;
+        authIssuer: z.ZodOptional<z.ZodString>;
+        previewName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        operationId: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        manifestJson: string;
+        convexUrl: string;
+        convexDeployKey: string;
+        operationId?: string | undefined;
+        authIssuer?: string | undefined;
+        previewName?: string | null | undefined;
+    }, {
+        manifestJson: string;
+        convexUrl: string;
+        convexDeployKey: string;
+        operationId?: string | undefined;
+        authIssuer?: string | undefined;
+        previewName?: string | null | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    protocolVersion: 1;
+    operation: "schemaDeploy";
+    tenant: {
+        slug: string;
+        convexUrl: string;
+        authIssuer?: string | undefined;
+        deploymentName?: string | undefined;
+    };
+    payload: {
+        manifestJson: string;
+        convexUrl: string;
+        convexDeployKey: string;
+        operationId?: string | undefined;
+        authIssuer?: string | undefined;
+        previewName?: string | null | undefined;
+    };
+    correlationId?: string | undefined;
+}, {
+    protocolVersion: 1;
+    operation: "schemaDeploy";
+    tenant: {
+        slug: string;
+        convexUrl: string;
+        authIssuer?: string | undefined;
+        deploymentName?: string | undefined;
+    };
+    payload: {
+        manifestJson: string;
+        convexUrl: string;
+        convexDeployKey: string;
+        operationId?: string | undefined;
+        authIssuer?: string | undefined;
+        previewName?: string | null | undefined;
+    };
+    correlationId?: string | undefined;
+}>, z.ZodObject<{
+    protocolVersion: z.ZodLiteral<1>;
+    tenant: z.ZodObject<{
+        slug: z.ZodString;
+        convexUrl: z.ZodString;
+        authIssuer: z.ZodOptional<z.ZodString>;
+        deploymentName: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        slug: string;
+        convexUrl: string;
+        authIssuer?: string | undefined;
+        deploymentName?: string | undefined;
+    }, {
+        slug: string;
+        convexUrl: string;
+        authIssuer?: string | undefined;
+        deploymentName?: string | undefined;
+    }>;
+    correlationId: z.ZodOptional<z.ZodString>;
+} & {
+    operation: z.ZodLiteral<"dataExport">;
+    payload: z.ZodObject<{
+        transferManifest: z.ZodEffects<z.ZodObject<{
+            version: z.ZodLiteral<1>;
+            tables: z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">;
+            schemaHash: z.ZodString;
+            includeFileStorage: z.ZodBoolean;
+        }, "strip", z.ZodTypeAny, {
+            tables: string[];
+            version: 1;
+            schemaHash: string;
+            includeFileStorage: boolean;
+        }, {
+            tables: string[];
+            version: 1;
+            schemaHash: string;
+            includeFileStorage: boolean;
+        }>, {
+            tables: string[];
+            version: 1;
+            schemaHash: string;
+            includeFileStorage: boolean;
+        }, {
+            tables: string[];
+            version: 1;
+            schemaHash: string;
+            includeFileStorage: boolean;
+        }>;
+        convexDeployKey: z.ZodString;
+        convexUrl: z.ZodString;
+        tenantSlug: z.ZodString;
+        operationId: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        operationId: string;
+        transferManifest: {
+            tables: string[];
+            version: 1;
+            schemaHash: string;
+            includeFileStorage: boolean;
+        };
+        convexUrl: string;
+        convexDeployKey: string;
+        tenantSlug: string;
+    }, {
+        operationId: string;
+        transferManifest: {
+            tables: string[];
+            version: 1;
+            schemaHash: string;
+            includeFileStorage: boolean;
+        };
+        convexUrl: string;
+        convexDeployKey: string;
+        tenantSlug: string;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    protocolVersion: 1;
+    operation: "dataExport";
+    tenant: {
+        slug: string;
+        convexUrl: string;
+        authIssuer?: string | undefined;
+        deploymentName?: string | undefined;
+    };
+    payload: {
+        operationId: string;
+        transferManifest: {
+            tables: string[];
+            version: 1;
+            schemaHash: string;
+            includeFileStorage: boolean;
+        };
+        convexUrl: string;
+        convexDeployKey: string;
+        tenantSlug: string;
+    };
+    correlationId?: string | undefined;
+}, {
+    protocolVersion: 1;
+    operation: "dataExport";
+    tenant: {
+        slug: string;
+        convexUrl: string;
+        authIssuer?: string | undefined;
+        deploymentName?: string | undefined;
+    };
+    payload: {
+        operationId: string;
+        transferManifest: {
+            tables: string[];
+            version: 1;
+            schemaHash: string;
+            includeFileStorage: boolean;
+        };
+        convexUrl: string;
+        convexDeployKey: string;
+        tenantSlug: string;
+    };
+    correlationId?: string | undefined;
+}>, z.ZodObject<{
+    protocolVersion: z.ZodLiteral<1>;
+    tenant: z.ZodObject<{
+        slug: z.ZodString;
+        convexUrl: z.ZodString;
+        authIssuer: z.ZodOptional<z.ZodString>;
+        deploymentName: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        slug: string;
+        convexUrl: string;
+        authIssuer?: string | undefined;
+        deploymentName?: string | undefined;
+    }, {
+        slug: string;
+        convexUrl: string;
+        authIssuer?: string | undefined;
+        deploymentName?: string | undefined;
+    }>;
+    correlationId: z.ZodOptional<z.ZodString>;
+} & {
+    operation: z.ZodLiteral<"dataImportPrepare">;
+    payload: z.ZodObject<{
+        transferManifest: z.ZodEffects<z.ZodObject<{
+            version: z.ZodLiteral<1>;
+            tables: z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">;
+            schemaHash: z.ZodString;
+            includeFileStorage: z.ZodBoolean;
+        }, "strip", z.ZodTypeAny, {
+            tables: string[];
+            version: 1;
+            schemaHash: string;
+            includeFileStorage: boolean;
+        }, {
+            tables: string[];
+            version: 1;
+            schemaHash: string;
+            includeFileStorage: boolean;
+        }>, {
+            tables: string[];
+            version: 1;
+            schemaHash: string;
+            includeFileStorage: boolean;
+        }, {
+            tables: string[];
+            version: 1;
+            schemaHash: string;
+            includeFileStorage: boolean;
+        }>;
+        convexDeployKey: z.ZodString;
+        convexUrl: z.ZodString;
+        tenantSlug: z.ZodString;
+        operationId: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        operationId: string;
+        transferManifest: {
+            tables: string[];
+            version: 1;
+            schemaHash: string;
+            includeFileStorage: boolean;
+        };
+        convexUrl: string;
+        convexDeployKey: string;
+        tenantSlug: string;
+    }, {
+        operationId: string;
+        transferManifest: {
+            tables: string[];
+            version: 1;
+            schemaHash: string;
+            includeFileStorage: boolean;
+        };
+        convexUrl: string;
+        convexDeployKey: string;
+        tenantSlug: string;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    protocolVersion: 1;
+    operation: "dataImportPrepare";
+    tenant: {
+        slug: string;
+        convexUrl: string;
+        authIssuer?: string | undefined;
+        deploymentName?: string | undefined;
+    };
+    payload: {
+        operationId: string;
+        transferManifest: {
+            tables: string[];
+            version: 1;
+            schemaHash: string;
+            includeFileStorage: boolean;
+        };
+        convexUrl: string;
+        convexDeployKey: string;
+        tenantSlug: string;
+    };
+    correlationId?: string | undefined;
+}, {
+    protocolVersion: 1;
+    operation: "dataImportPrepare";
+    tenant: {
+        slug: string;
+        convexUrl: string;
+        authIssuer?: string | undefined;
+        deploymentName?: string | undefined;
+    };
+    payload: {
+        operationId: string;
+        transferManifest: {
+            tables: string[];
+            version: 1;
+            schemaHash: string;
+            includeFileStorage: boolean;
+        };
+        convexUrl: string;
+        convexDeployKey: string;
+        tenantSlug: string;
+    };
+    correlationId?: string | undefined;
+}>, z.ZodObject<{
+    protocolVersion: z.ZodLiteral<1>;
+    tenant: z.ZodObject<{
+        slug: z.ZodString;
+        convexUrl: z.ZodString;
+        authIssuer: z.ZodOptional<z.ZodString>;
+        deploymentName: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        slug: string;
+        convexUrl: string;
+        authIssuer?: string | undefined;
+        deploymentName?: string | undefined;
+    }, {
+        slug: string;
+        convexUrl: string;
+        authIssuer?: string | undefined;
+        deploymentName?: string | undefined;
+    }>;
+    correlationId: z.ZodOptional<z.ZodString>;
+} & {
+    operation: z.ZodLiteral<"dataImportCommit">;
+    payload: z.ZodObject<{
+        transferId: z.ZodString;
+        convexDeployKey: z.ZodString;
+        convexUrl: z.ZodString;
+        tenantSlug: z.ZodString;
+        operationId: z.ZodString;
+        schemaHash: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        schemaHash: string;
+        operationId: string;
+        transferId: string;
+        convexUrl: string;
+        convexDeployKey: string;
+        tenantSlug: string;
+    }, {
+        schemaHash: string;
+        operationId: string;
+        transferId: string;
+        convexUrl: string;
+        convexDeployKey: string;
+        tenantSlug: string;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    protocolVersion: 1;
+    operation: "dataImportCommit";
+    tenant: {
+        slug: string;
+        convexUrl: string;
+        authIssuer?: string | undefined;
+        deploymentName?: string | undefined;
+    };
+    payload: {
+        schemaHash: string;
+        operationId: string;
+        transferId: string;
+        convexUrl: string;
+        convexDeployKey: string;
+        tenantSlug: string;
+    };
+    correlationId?: string | undefined;
+}, {
+    protocolVersion: 1;
+    operation: "dataImportCommit";
+    tenant: {
+        slug: string;
+        convexUrl: string;
+        authIssuer?: string | undefined;
+        deploymentName?: string | undefined;
+    };
+    payload: {
+        schemaHash: string;
+        operationId: string;
+        transferId: string;
+        convexUrl: string;
+        convexDeployKey: string;
+        tenantSlug: string;
+    };
+    correlationId?: string | undefined;
+}>]>;
+export type BffPreparedBodyEnvelope = z.infer<typeof bffPreparedBodyEnvelopeSchema>;
+export type BffPreparedBodyEnvelopeFor<T extends BffPrepareOperationType> = Extract<BffPreparedBodyEnvelope, {
+    operation: T;
+}>;
+export declare const bffPreviewRegisterRequestSchema: z.ZodObject<{
+    hostname: z.ZodString;
+    convexUrl: z.ZodString;
+    deployKey: z.ZodString;
+    expectedCommit: z.ZodString;
+    expiresAt: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    hostname: string;
+    expiresAt: number;
+    convexUrl: string;
+    deployKey: string;
+    expectedCommit: string;
+}, {
+    hostname: string;
+    expiresAt: number;
+    convexUrl: string;
+    deployKey: string;
+    expectedCommit: string;
+}>;
+export type BffPreviewRegisterRequest = z.infer<typeof bffPreviewRegisterRequestSchema>;
+export declare const bffPreviewRemoveRequestSchema: z.ZodObject<{
+    hostname: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    hostname: string;
+}, {
+    hostname: string;
+}>;
+export type BffPreviewRemoveRequest = z.infer<typeof bffPreviewRemoveRequestSchema>;
+export declare const transferSessionRecordSchema: z.ZodObject<{
+    transferId: z.ZodString;
+    tenantSlug: z.ZodString;
+    convexUrl: z.ZodString;
+    operation: z.ZodEnum<["export", "import"]>;
+    tables: z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">;
+    schemaHash: z.ZodString;
+    includeFileStorage: z.ZodBoolean;
+    maxBytes: z.ZodNumber;
+    expiresAt: z.ZodNumber;
+    state: z.ZodEnum<["exportReady", "importAwaitingUpload", "importUploaded", "importCommitted", "importFailed", "expired"]>;
+    operationId: z.ZodOptional<z.ZodString>;
+    bytes: z.ZodOptional<z.ZodNumber>;
+    commitResult: z.ZodOptional<z.ZodObject<{
+        ok: z.ZodBoolean;
+        error: z.ZodOptional<z.ZodString>;
+        logTail: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        ok: boolean;
+        error?: string | undefined;
+        logTail?: string | undefined;
+    }, {
+        ok: boolean;
+        error?: string | undefined;
+        logTail?: string | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    tables: string[];
+    schemaHash: string;
+    includeFileStorage: boolean;
+    transferId: string;
+    expiresAt: number;
+    operation: "export" | "import";
+    convexUrl: string;
+    tenantSlug: string;
+    maxBytes: number;
+    state: "exportReady" | "importAwaitingUpload" | "importUploaded" | "importCommitted" | "importFailed" | "expired";
+    bytes?: number | undefined;
+    operationId?: string | undefined;
+    commitResult?: {
+        ok: boolean;
+        error?: string | undefined;
+        logTail?: string | undefined;
+    } | undefined;
+}, {
+    tables: string[];
+    schemaHash: string;
+    includeFileStorage: boolean;
+    transferId: string;
+    expiresAt: number;
+    operation: "export" | "import";
+    convexUrl: string;
+    tenantSlug: string;
+    maxBytes: number;
+    state: "exportReady" | "importAwaitingUpload" | "importUploaded" | "importCommitted" | "importFailed" | "expired";
+    bytes?: number | undefined;
+    operationId?: string | undefined;
+    commitResult?: {
+        ok: boolean;
+        error?: string | undefined;
+        logTail?: string | undefined;
+    } | undefined;
+}>;
+export type TransferSessionRecord = z.infer<typeof transferSessionRecordSchema>;
+export declare const deployInternalTransferCreateResponseSchema: z.ZodObject<{
+    ok: z.ZodLiteral<true>;
+    transferId: z.ZodString;
+    expiresAt: z.ZodNumber;
+    bytes: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    ok: true;
+    transferId: string;
+    expiresAt: number;
+    bytes?: number | undefined;
+}, {
+    ok: true;
+    transferId: string;
+    expiresAt: number;
+    bytes?: number | undefined;
+}>;
+export declare const deployInternalSchemaDeployResponseSchema: z.ZodObject<{
+    ok: z.ZodBoolean;
+    durationMs: z.ZodNumber;
+    prepareMs: z.ZodOptional<z.ZodNumber>;
+    cliMs: z.ZodOptional<z.ZodNumber>;
+    kernelCommit: z.ZodOptional<z.ZodString>;
+    error: z.ZodOptional<z.ZodString>;
+    logTail: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    ok: boolean;
+    durationMs: number;
+    error?: string | undefined;
+    logTail?: string | undefined;
+    prepareMs?: number | undefined;
+    cliMs?: number | undefined;
+    kernelCommit?: string | undefined;
+}, {
+    ok: boolean;
+    durationMs: number;
+    error?: string | undefined;
+    logTail?: string | undefined;
+    prepareMs?: number | undefined;
+    cliMs?: number | undefined;
+    kernelCommit?: string | undefined;
+}>;
+export declare const deployHealthResponseSchema: z.ZodObject<{
+    ok: z.ZodBoolean;
+    commit: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    ok: boolean;
+    commit?: string | undefined;
+}, {
+    ok: boolean;
+    commit?: string | undefined;
+}>;
+export type DeployHealthResponse = z.infer<typeof deployHealthResponseSchema>;
+/** Default JSON body size for non-streaming BFF routes (bytes). */
+export declare const BFF_JSON_BODY_LIMIT_BYTES: number;
+export { MAX_TRANSFER_BYTES as BFF_TRANSFER_MAX_BYTES };