@columnus/shared 0.1.54 → 0.1.56

package/dist/bffProtocol.d.ts

@@ -31,6 +31,11 @@ export type SchemaDeployPhase = z.infer<typeof schemaDeployPhaseSchema>;
 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;
+/**
+ * Whether callers must wait (or BFF must recover) before starting another schema op.
+ * Matches beginBffDeploy: an active phase with an expired lease is supersedable, not blocking.
+ */
+export declare function isSchemaDeployOperationBlocking(phase: string | undefined, 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;
@@ -156,14 +161,14 @@ export declare const bffActiveOperationMetaSchema: z.ZodObject<{
     startedAt: z.ZodOptional<z.ZodNumber>;
 }, "strip", z.ZodTypeAny, {
     operationId: string;
-    desiredManifestHash?: string | undefined;
-    phase?: "cleaning" | "ready" | "deploying" | "succeeded" | "failed" | undefined;
     startedAt?: number | undefined;
+    desiredManifestHash?: string | undefined;
+    phase?: "ready" | "failed" | "cleaning" | "deploying" | "succeeded" | undefined;
 }, {
     operationId: string;
-    desiredManifestHash?: string | undefined;
-    phase?: "cleaning" | "ready" | "deploying" | "succeeded" | "failed" | undefined;
     startedAt?: number | undefined;
+    desiredManifestHash?: string | undefined;
+    phase?: "ready" | "failed" | "cleaning" | "deploying" | "succeeded" | undefined;
 }>;
 export type BffActiveOperationMeta = z.infer<typeof bffActiveOperationMetaSchema>;
 export declare const bffSchemaDeployResponseSchema: z.ZodObject<{
@@ -181,42 +186,42 @@ export declare const bffSchemaDeployResponseSchema: z.ZodObject<{
         startedAt: z.ZodOptional<z.ZodNumber>;
     }, "strip", z.ZodTypeAny, {
         operationId: string;
-        desiredManifestHash?: string | undefined;
-        phase?: "cleaning" | "ready" | "deploying" | "succeeded" | "failed" | undefined;
         startedAt?: number | undefined;
+        desiredManifestHash?: string | undefined;
+        phase?: "ready" | "failed" | "cleaning" | "deploying" | "succeeded" | undefined;
     }, {
         operationId: string;
-        desiredManifestHash?: string | undefined;
-        phase?: "cleaning" | "ready" | "deploying" | "succeeded" | "failed" | undefined;
         startedAt?: number | undefined;
+        desiredManifestHash?: string | undefined;
+        phase?: "ready" | "failed" | "cleaning" | "deploying" | "succeeded" | undefined;
     }>>;
 }, "strip", z.ZodTypeAny, {
     ok: boolean;
     operationId: string;
-    phase: "cleaning" | "ready" | "deploying" | "succeeded" | "failed";
+    phase: "ready" | "failed" | "cleaning" | "deploying" | "succeeded";
     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;
+        desiredManifestHash?: string | undefined;
+        phase?: "ready" | "failed" | "cleaning" | "deploying" | "succeeded" | undefined;
     } | undefined;
 }, {
     ok: boolean;
     operationId: string;
-    phase: "cleaning" | "ready" | "deploying" | "succeeded" | "failed";
+    phase: "ready" | "failed" | "cleaning" | "deploying" | "succeeded";
     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;
+        desiredManifestHash?: string | undefined;
+        phase?: "ready" | "failed" | "cleaning" | "deploying" | "succeeded" | undefined;
     } | undefined;
 }>;
 export type BffSchemaDeployResponse = z.infer<typeof bffSchemaDeployResponseSchema>;
@@ -279,14 +284,14 @@ export declare const bffErrorResponseSchema: z.ZodObject<{
         startedAt: z.ZodOptional<z.ZodNumber>;
     }, "strip", z.ZodTypeAny, {
         operationId: string;
-        desiredManifestHash?: string | undefined;
-        phase?: "cleaning" | "ready" | "deploying" | "succeeded" | "failed" | undefined;
         startedAt?: number | undefined;
+        desiredManifestHash?: string | undefined;
+        phase?: "ready" | "failed" | "cleaning" | "deploying" | "succeeded" | undefined;
     }, {
         operationId: string;
-        desiredManifestHash?: string | undefined;
-        phase?: "cleaning" | "ready" | "deploying" | "succeeded" | "failed" | undefined;
         startedAt?: number | undefined;
+        desiredManifestHash?: string | undefined;
+        phase?: "ready" | "failed" | "cleaning" | "deploying" | "succeeded" | undefined;
     }>>;
 }, "strip", z.ZodTypeAny, {
     error: string;
@@ -295,9 +300,9 @@ export declare const bffErrorResponseSchema: z.ZodObject<{
     logTail?: string | undefined;
     activeOperation?: {
         operationId: string;
-        desiredManifestHash?: string | undefined;
-        phase?: "cleaning" | "ready" | "deploying" | "succeeded" | "failed" | undefined;
         startedAt?: number | undefined;
+        desiredManifestHash?: string | undefined;
+        phase?: "ready" | "failed" | "cleaning" | "deploying" | "succeeded" | undefined;
     } | undefined;
 }, {
     error: string;
@@ -306,9 +311,9 @@ export declare const bffErrorResponseSchema: z.ZodObject<{
     logTail?: string | undefined;
     activeOperation?: {
         operationId: string;
-        desiredManifestHash?: string | undefined;
-        phase?: "cleaning" | "ready" | "deploying" | "succeeded" | "failed" | undefined;
         startedAt?: number | undefined;
+        desiredManifestHash?: string | undefined;
+        phase?: "ready" | "failed" | "cleaning" | "deploying" | "succeeded" | undefined;
     } | undefined;
 }>;
 export type BffErrorResponse = z.infer<typeof bffErrorResponseSchema>;
@@ -1264,6 +1269,7 @@ export declare const transferSessionRecordSchema: z.ZodObject<{
     }>>;
 }, "strip", z.ZodTypeAny, {
     tables: string[];
+    state: "exportReady" | "importAwaitingUpload" | "importUploaded" | "importCommitted" | "importFailed" | "expired";
     schemaHash: string;
     includeFileStorage: boolean;
     transferId: string;
@@ -1272,7 +1278,6 @@ export declare const transferSessionRecordSchema: z.ZodObject<{
     convexUrl: string;
     tenantSlug: string;
     maxBytes: number;
-    state: "exportReady" | "importAwaitingUpload" | "importUploaded" | "importCommitted" | "importFailed" | "expired";
     bytes?: number | undefined;
     operationId?: string | undefined;
     commitResult?: {
@@ -1282,6 +1287,7 @@ export declare const transferSessionRecordSchema: z.ZodObject<{
     } | undefined;
 }, {
     tables: string[];
+    state: "exportReady" | "importAwaitingUpload" | "importUploaded" | "importCommitted" | "importFailed" | "expired";
     schemaHash: string;
     includeFileStorage: boolean;
     transferId: string;
@@ -1290,7 +1296,6 @@ export declare const transferSessionRecordSchema: z.ZodObject<{
     convexUrl: string;
     tenantSlug: string;
     maxBytes: number;
-    state: "exportReady" | "importAwaitingUpload" | "importUploaded" | "importCommitted" | "importFailed" | "expired";
     bytes?: number | undefined;
     operationId?: string | undefined;
     commitResult?: {

package/dist/bffProtocol.js

@@ -4095,6 +4095,10 @@ function isSchemaDeployPhaseActive(phase) {
 function hasSchemaDeployOperationLeaseExpired(startedAt, now) {
   return startedAt !== void 0 && now - startedAt >= SCHEMA_DEPLOY_OPERATION_LEASE_MS;
 }
+function isSchemaDeployOperationBlocking(phase, startedAt, now = Date.now()) {
+  if (!isSchemaDeployPhaseActive(phase)) return false;
+  return !hasSchemaDeployOperationLeaseExpired(startedAt, now);
+}
 function base64UrlFromBytes(bytes) {
   let binary = "";
   for (const byte of bytes) binary += String.fromCharCode(byte);
@@ -4357,6 +4361,6 @@ var deployHealthResponseSchema = external_exports.object({
 });
 var BFF_JSON_BODY_LIMIT_BYTES = 2 * 1024 * 1024;
 
-export { BFF_JSON_BODY_LIMIT_BYTES, MAX_TRANSFER_BYTES as BFF_TRANSFER_MAX_BYTES, COLUMNUS_BFF_API_PREFIX, COLUMNUS_BFF_MANAGEMENT_PREFIX, COLUMNUS_BFF_MANAGEMENT_SECRET_HEADER, COLUMNUS_BFF_PROTOCOL_VERSION, COLUMNUS_DEPLOY_INTERNAL_PREFIX, COLUMNUS_DEPLOY_OPS_PREFIX, COLUMNUS_PREVIEW_REGISTRATION_SECRET_HEADER, MANIFEST_HASH_RE, OPERATION_ID_RE, SCHEMA_DEPLOY_OPERATION_LEASE_MS, TABLE_NAME_RE, TRANSFER_ID_RE, bffActiveOperationMetaSchema, bffErrorCodeSchema, bffErrorResponseSchema, bffHealthResponseSchema, bffPrepareOperationSchema, bffPrepareOperationTypeSchema, bffPrepareRequestSchema, bffPreparedBodyEnvelopeSchema, bffPreparedTenantSchema, bffPreviewRegisterRequestSchema, bffPreviewRemoveRequestSchema, bffSchemaDeployRequestSchema, bffSchemaDeployResponseSchema, bffTransferCommitRequestSchema, bffTransferCommitResponseSchema, bffTransferCreateResponseSchema, bffTransferScopeRequestSchema, bffTransferUploadResponseSchema, createOperationId, createRandomId, createTransferId, dataTransferManifestSchema, deployHealthResponseSchema, deployInternalSchemaDeployPayloadSchema, deployInternalSchemaDeployResponseSchema, deployInternalTransferCommitPayloadSchema, deployInternalTransferCreateResponseSchema, deployInternalTransferExportPayloadSchema, deployInternalTransferImportPreparePayloadSchema, hasSchemaDeployOperationLeaseExpired, isManifestHash, isOperationId, isSchemaDeployPhaseActive, isTransferId, manifestHashSchema, matchesDeployCompletion, operationIdSchema, schemaDeployPhaseSchema, transferIdSchema, transferOperationSchema, transferSessionRecordSchema, transferSessionStateSchema };
+export { BFF_JSON_BODY_LIMIT_BYTES, MAX_TRANSFER_BYTES as BFF_TRANSFER_MAX_BYTES, COLUMNUS_BFF_API_PREFIX, COLUMNUS_BFF_MANAGEMENT_PREFIX, COLUMNUS_BFF_MANAGEMENT_SECRET_HEADER, COLUMNUS_BFF_PROTOCOL_VERSION, COLUMNUS_DEPLOY_INTERNAL_PREFIX, COLUMNUS_DEPLOY_OPS_PREFIX, COLUMNUS_PREVIEW_REGISTRATION_SECRET_HEADER, MANIFEST_HASH_RE, OPERATION_ID_RE, SCHEMA_DEPLOY_OPERATION_LEASE_MS, TABLE_NAME_RE, TRANSFER_ID_RE, bffActiveOperationMetaSchema, bffErrorCodeSchema, bffErrorResponseSchema, bffHealthResponseSchema, bffPrepareOperationSchema, bffPrepareOperationTypeSchema, bffPrepareRequestSchema, bffPreparedBodyEnvelopeSchema, bffPreparedTenantSchema, bffPreviewRegisterRequestSchema, bffPreviewRemoveRequestSchema, bffSchemaDeployRequestSchema, bffSchemaDeployResponseSchema, bffTransferCommitRequestSchema, bffTransferCommitResponseSchema, bffTransferCreateResponseSchema, bffTransferScopeRequestSchema, bffTransferUploadResponseSchema, createOperationId, createRandomId, createTransferId, dataTransferManifestSchema, deployHealthResponseSchema, deployInternalSchemaDeployPayloadSchema, deployInternalSchemaDeployResponseSchema, deployInternalTransferCommitPayloadSchema, deployInternalTransferCreateResponseSchema, deployInternalTransferExportPayloadSchema, deployInternalTransferImportPreparePayloadSchema, hasSchemaDeployOperationLeaseExpired, isManifestHash, isOperationId, isSchemaDeployOperationBlocking, isSchemaDeployPhaseActive, isTransferId, manifestHashSchema, matchesDeployCompletion, operationIdSchema, schemaDeployPhaseSchema, transferIdSchema, transferOperationSchema, transferSessionRecordSchema, transferSessionStateSchema };
 //# sourceMappingURL=bffProtocol.js.map
 //# sourceMappingURL=bffProtocol.js.map