@superblocksteam/shared 0.9614.3 → 0.9615.1

package/dist/database-lifecycle/appDatabaseCompatibility.d.ts

@@ -14,11 +14,13 @@ export declare const APP_DATABASE_COMPATIBILITY_STATES: readonly ["compatible",
 export type AppDatabaseCompatibilityState = (typeof APP_DATABASE_COMPATIBILITY_STATES)[number];
 /** Lifecycle operations an App Database cannot work without. */
 export declare const APP_DATABASE_REQUIRED_OPERATIONS: readonly LifecycleOperation[];
-export type AppDatabaseTagCompatibility = {
-    /** App view modes that offer this data tag, for messaging. */
+export type AppDatabaseTagRef = {
+    /** App view modes that offer this data tag. */
     availableModes: ViewMode[];
-    missingOperations: LifecycleOperation[];
     profileKey: string;
+};
+export type AppDatabaseTagCompatibility = AppDatabaseTagRef & {
+    missingOperations: LifecycleOperation[];
     requiredOperations: LifecycleOperation[];
     supportState: AppDatabaseTagSupportState;
 };

package/dist/database-lifecycle/appDatabaseCompatibility.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"appDatabaseCompatibility.d.ts","sourceRoot":"","sources":["../../src/database-lifecycle/appDatabaseCompatibility.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD;;;;;;;GAOG;AACH,eAAO,MAAM,+BAA+B,kEAAmE,CAAC;AAChH,MAAM,MAAM,0BAA0B,GAAG,CAAC,OAAO,+BAA+B,CAAC,CAAC,MAAM,CAAC,CAAC;AAE1F,eAAO,MAAM,iCAAiC,oEAAqE,CAAC;AACpH,MAAM,MAAM,6BAA6B,GAAG,CAAC,OAAO,iCAAiC,CAAC,CAAC,MAAM,CAAC,CAAC;AAE/F,gEAAgE;AAChE,eAAO,MAAM,gCAAgC,EAAE,SAAS,kBAAkB,EAA0C,CAAC;AAErH,MAAM,MAAM,2BAA2B,GAAG;IACxC,8DAA8D;IAC9D,cAAc,EAAE,QAAQ,EAAE,CAAC;IAC3B,iBAAiB,EAAE,kBAAkB,EAAE,CAAC;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB,EAAE,kBAAkB,EAAE,CAAC;IACzC,YAAY,EAAE,0BAA0B,CAAC;CAC1C,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACrC,aAAa,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,cAAc,EAAE,OAAO,CAAC;IACxB,yEAAyE;IACzE,cAAc,EAAE,OAAO,CAAC;IACxB,YAAY,EAAE,6BAA6B,CAAC;IAC5C,2EAA2E;IAC3E,IAAI,EAAE,2BAA2B,EAAE,CAAC;CACrC,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,8BAA8B,CAAC,IAAI,EAAE,SAAS,2BAA2B,EAAE,GAAG;IAC5F,cAAc,EAAE,OAAO,CAAC;IACxB,YAAY,EAAE,6BAA6B,CAAC;CAC7C,CAQA"}
+{"version":3,"file":"appDatabaseCompatibility.d.ts","sourceRoot":"","sources":["../../src/database-lifecycle/appDatabaseCompatibility.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD;;;;;;;GAOG;AACH,eAAO,MAAM,+BAA+B,kEAAmE,CAAC;AAChH,MAAM,MAAM,0BAA0B,GAAG,CAAC,OAAO,+BAA+B,CAAC,CAAC,MAAM,CAAC,CAAC;AAE1F,eAAO,MAAM,iCAAiC,oEAAqE,CAAC;AACpH,MAAM,MAAM,6BAA6B,GAAG,CAAC,OAAO,iCAAiC,CAAC,CAAC,MAAM,CAAC,CAAC;AAE/F,gEAAgE;AAChE,eAAO,MAAM,gCAAgC,EAAE,SAAS,kBAAkB,EAA0C,CAAC;AAErH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,+CAA+C;IAC/C,cAAc,EAAE,QAAQ,EAAE,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,2BAA2B,GAAG,iBAAiB,GAAG;IAC5D,iBAAiB,EAAE,kBAAkB,EAAE,CAAC;IACxC,kBAAkB,EAAE,kBAAkB,EAAE,CAAC;IACzC,YAAY,EAAE,0BAA0B,CAAC;CAC1C,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACrC,aAAa,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,cAAc,EAAE,OAAO,CAAC;IACxB,yEAAyE;IACzE,cAAc,EAAE,OAAO,CAAC;IACxB,YAAY,EAAE,6BAA6B,CAAC;IAC5C,2EAA2E;IAC3E,IAAI,EAAE,2BAA2B,EAAE,CAAC;CACrC,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,8BAA8B,CAAC,IAAI,EAAE,SAAS,2BAA2B,EAAE,GAAG;IAC5F,cAAc,EAAE,OAAO,CAAC;IACxB,YAAY,EAAE,6BAA6B,CAAC;CAC7C,CAQA"}

package/dist/database-lifecycle/appDatabaseCompatibility.js.map

@@ -1 +1 @@
-{"version":3,"file":"appDatabaseCompatibility.js","sourceRoot":"","sources":["../../src/database-lifecycle/appDatabaseCompatibility.ts"],"names":[],"mappings":";;;AAkDA,wEAWC;AA1DD;;;;;;;GAOG;AACU,QAAA,+BAA+B,GAAG,CAAC,WAAW,EAAE,yBAAyB,EAAE,aAAa,CAAU,CAAC;AAGnG,QAAA,iCAAiC,GAAG,CAAC,YAAY,EAAE,cAAc,EAAE,yBAAyB,CAAU,CAAC;AAGpH,gEAAgE;AACnD,QAAA,gCAAgC,GAAkC,CAAC,iBAAiB,EAAE,gBAAgB,CAAC,CAAC;AA0BrH;;;;;GAKG;AACH,SAAgB,8BAA8B,CAAC,IAA4C;IAIzF,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,YAAY,KAAK,aAAa,CAAC,EAAE,CAAC;QAC3D,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,YAAY,EAAE,cAAc,EAAE,CAAC;IAChE,CAAC;IACD,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,YAAY,KAAK,yBAAyB,CAAC,EAAE,CAAC;QACvE,OAAO,EAAE,cAAc,EAAE,KAAK,EAAE,YAAY,EAAE,yBAAyB,EAAE,CAAC;IAC5E,CAAC;IACD,OAAO,EAAE,cAAc,EAAE,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,CAAC;AAC/D,CAAC"}
+{"version":3,"file":"appDatabaseCompatibility.js","sourceRoot":"","sources":["../../src/database-lifecycle/appDatabaseCompatibility.ts"],"names":[],"mappings":";;;AAqDA,wEAWC;AA7DD;;;;;;;GAOG;AACU,QAAA,+BAA+B,GAAG,CAAC,WAAW,EAAE,yBAAyB,EAAE,aAAa,CAAU,CAAC;AAGnG,QAAA,iCAAiC,GAAG,CAAC,YAAY,EAAE,cAAc,EAAE,yBAAyB,CAAU,CAAC;AAGpH,gEAAgE;AACnD,QAAA,gCAAgC,GAAkC,CAAC,iBAAiB,EAAE,gBAAgB,CAAC,CAAC;AA6BrH;;;;;GAKG;AACH,SAAgB,8BAA8B,CAAC,IAA4C;IAIzF,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,YAAY,KAAK,aAAa,CAAC,EAAE,CAAC;QAC3D,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,YAAY,EAAE,cAAc,EAAE,CAAC;IAChE,CAAC;IACD,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,YAAY,KAAK,yBAAyB,CAAC,EAAE,CAAC;QACvE,OAAO,EAAE,cAAc,EAAE,KAAK,EAAE,YAAY,EAAE,yBAAyB,EAAE,CAAC;IAC5E,CAAC;IACD,OAAO,EAAE,cAAc,EAAE,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,CAAC;AAC/D,CAAC"}

package/dist/database-lifecycle/appDatabaseImport.d.ts

@@ -0,0 +1,70 @@
+import type { DataImportKind } from './dataImport.js';
+export declare const APP_DATABASE_IMPORT_OPERATIONS: readonly ["prepare_import_prefix_upload", "inspect_import_prefix"];
+export declare const APP_DATABASE_IMPORT_STATES: readonly ["requested", "preparing_prefix_upload", "awaiting_prefix_upload", "validating_schema", "schema_validated", "failed", "cancelled"];
+export declare const APP_DATABASE_IMPORT_ERROR_CODES: readonly ["prefix_incomplete", "schema_mismatch", "unsupported_archive_format", "archive_corrupt", "postgres_version_newer_than_target", "unsupported_object", "schema_not_aligned", "missing_bucket_access", "internal", "invalid_input", "size_mismatch"];
+export type AppDatabaseImportKind = Extract<DataImportKind, 'pg_dump_custom'>;
+export type AppDatabaseImportLifecycleOperation = (typeof APP_DATABASE_IMPORT_OPERATIONS)[number];
+export type AppDatabaseImportState = (typeof APP_DATABASE_IMPORT_STATES)[number];
+export type AppDatabaseImportErrorCode = (typeof APP_DATABASE_IMPORT_ERROR_CODES)[number];
+export type AppDatabaseImportValidationMetadata = {
+    postgresMajorVersion: number;
+    tableNames: string[];
+};
+export type AppDatabaseImportDispatchDetails = {
+    importId: string;
+    kind: AppDatabaseImportKind;
+    prefixSizeBytes: number;
+    profileToken: string;
+    resourceToken: string;
+};
+type AppDatabaseImportDispatchBase<TDesiredSpec> = {
+    applicationId: string;
+    bindingId: string;
+    bindingKey: string;
+    connectionMetadata?: Record<string, string | number | boolean>;
+    continuation?: never;
+    desiredSpec: TDesiredSpec;
+    desiredSpecHash: string;
+    environment?: never;
+    metadata?: never;
+    migrations?: never;
+    organizationId: string;
+    profile: string;
+    provisioningId?: never;
+    requestId: string;
+    resourceKey: string;
+};
+export type PrepareImportPrefixUploadDispatchPayloadEnvelope<TDesiredSpec> = AppDatabaseImportDispatchBase<TDesiredSpec> & {
+    import: AppDatabaseImportDispatchDetails & {
+        expectedSizeBytes: number;
+    };
+    operation: 'prepare_import_prefix_upload';
+};
+export type InspectImportPrefixDispatchPayloadEnvelope<TDesiredSpec> = AppDatabaseImportDispatchBase<TDesiredSpec> & {
+    import: AppDatabaseImportDispatchDetails & {
+        prefixObjectKey: string;
+    };
+    operation: 'inspect_import_prefix';
+};
+export type AppDatabaseImportDispatchPayloadEnvelope<TDesiredSpec> = InspectImportPrefixDispatchPayloadEnvelope<TDesiredSpec> | PrepareImportPrefixUploadDispatchPayloadEnvelope<TDesiredSpec>;
+export type PrepareImportPrefixUploadCallbackResult = {
+    prefixObjectKey: string;
+    prefixUploadHeaders?: Record<string, string>;
+    prefixUploadUrl: string;
+    result: 'prefix_upload_url';
+};
+export type InspectImportPrefixCallbackResult = {
+    inspectedPrefixSizeBytes: number;
+    nextPrefixSizeBytes: number;
+    result: 'prefix_incomplete';
+} | {
+    result: 'schema_validated';
+    validationMetadata: AppDatabaseImportValidationMetadata;
+};
+export type AppDatabaseImportCallbackResult = InspectImportPrefixCallbackResult | PrepareImportPrefixUploadCallbackResult;
+export declare function isAppDatabaseImportLifecycleOperation(value: string): value is AppDatabaseImportLifecycleOperation;
+export declare function isAppDatabaseImportDispatchPayload(value: unknown): value is AppDatabaseImportDispatchPayloadEnvelope<Record<string, unknown>>;
+export declare function isAppDatabaseImportCallbackResult(value: unknown): value is AppDatabaseImportCallbackResult;
+export declare function parseAppDatabaseImportValidationMetadata(value: unknown): AppDatabaseImportValidationMetadata | undefined;
+export {};
+//# sourceMappingURL=appDatabaseImport.d.ts.map

package/dist/database-lifecycle/appDatabaseImport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"appDatabaseImport.d.ts","sourceRoot":"","sources":["../../src/database-lifecycle/appDatabaseImport.ts"],"names":[],"mappings":"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"}

package/dist/database-lifecycle/appDatabaseImport.js

@@ -0,0 +1,111 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.APP_DATABASE_IMPORT_ERROR_CODES = exports.APP_DATABASE_IMPORT_STATES = exports.APP_DATABASE_IMPORT_OPERATIONS = void 0;
+exports.isAppDatabaseImportLifecycleOperation = isAppDatabaseImportLifecycleOperation;
+exports.isAppDatabaseImportDispatchPayload = isAppDatabaseImportDispatchPayload;
+exports.isAppDatabaseImportCallbackResult = isAppDatabaseImportCallbackResult;
+exports.parseAppDatabaseImportValidationMetadata = parseAppDatabaseImportValidationMetadata;
+exports.APP_DATABASE_IMPORT_OPERATIONS = ['prepare_import_prefix_upload', 'inspect_import_prefix'];
+// Subset of DATA_IMPORT_STATES. Prefix success is schema_validated, not ready.
+exports.APP_DATABASE_IMPORT_STATES = [
+    'requested',
+    'preparing_prefix_upload',
+    'awaiting_prefix_upload',
+    'validating_schema',
+    'schema_validated',
+    'failed',
+    'cancelled'
+];
+exports.APP_DATABASE_IMPORT_ERROR_CODES = [
+    'prefix_incomplete',
+    'schema_mismatch',
+    'unsupported_archive_format',
+    'archive_corrupt',
+    'postgres_version_newer_than_target',
+    'unsupported_object',
+    'schema_not_aligned',
+    'missing_bucket_access',
+    'internal',
+    'invalid_input',
+    'size_mismatch'
+];
+const importOperations = new Set(exports.APP_DATABASE_IMPORT_OPERATIONS);
+function isAppDatabaseImportLifecycleOperation(value) {
+    return importOperations.has(value);
+}
+function isAppDatabaseImportDispatchPayload(value) {
+    if (!isUnknownRecord(value) || !hasImportDispatchBase(value)) {
+        return false;
+    }
+    if (!isNonEmptyString(value.import.profileToken) || !isNonEmptyString(value.import.resourceToken)) {
+        return false;
+    }
+    if (value.operation === 'prepare_import_prefix_upload') {
+        return value.import.prefixObjectKey === undefined && isPositiveInteger(value.import.expectedSizeBytes);
+    }
+    return (value.operation === 'inspect_import_prefix' &&
+        value.import.expectedSizeBytes === undefined &&
+        isNonEmptyString(value.import.prefixObjectKey));
+}
+function isAppDatabaseImportCallbackResult(value) {
+    if (!isUnknownRecord(value)) {
+        return false;
+    }
+    if (value.result === 'prefix_upload_url') {
+        return (isNonEmptyString(value.prefixObjectKey) && isNonEmptyString(value.prefixUploadUrl) && isOptionalStringMap(value.prefixUploadHeaders));
+    }
+    if (value.result === 'prefix_incomplete') {
+        return (isPositiveInteger(value.inspectedPrefixSizeBytes) &&
+            isPositiveInteger(value.nextPrefixSizeBytes) &&
+            value.nextPrefixSizeBytes > value.inspectedPrefixSizeBytes);
+    }
+    return value.result === 'schema_validated' && parseAppDatabaseImportValidationMetadata(value.validationMetadata) !== undefined;
+}
+// Rebuild metadata from its allowlisted fields so archive contents, SQL, rows,
+// and other worker-provided details cannot cross this contract boundary.
+function parseAppDatabaseImportValidationMetadata(value) {
+    if (!isUnknownRecord(value) ||
+        !isPositiveInteger(value.postgresMajorVersion) ||
+        !Array.isArray(value.tableNames) ||
+        !value.tableNames.every(isNonEmptyString)) {
+        return undefined;
+    }
+    return {
+        postgresMajorVersion: value.postgresMajorVersion,
+        tableNames: [...value.tableNames]
+    };
+}
+function hasImportDispatchBase(value) {
+    return (isNonEmptyString(value.applicationId) &&
+        isNonEmptyString(value.bindingId) &&
+        isNonEmptyString(value.bindingKey) &&
+        isUnknownRecord(value.desiredSpec) &&
+        isNonEmptyString(value.desiredSpecHash) &&
+        isUnknownRecord(value.import) &&
+        isNonEmptyString(value.import.importId) &&
+        value.import.kind === 'pg_dump_custom' &&
+        isPositiveInteger(value.import.prefixSizeBytes) &&
+        isNonEmptyString(value.organizationId) &&
+        isNonEmptyString(value.profile) &&
+        isNonEmptyString(value.requestId) &&
+        isNonEmptyString(value.resourceKey));
+}
+function isOptionalStringMap(value) {
+    if (value === undefined) {
+        return true;
+    }
+    if (!isUnknownRecord(value)) {
+        return false;
+    }
+    return Object.entries(value).every(([key, entry]) => key.length > 0 && typeof entry === 'string' && entry.length > 0);
+}
+function isNonEmptyString(value) {
+    return typeof value === 'string' && value.trim().length > 0;
+}
+function isPositiveInteger(value) {
+    return typeof value === 'number' && Number.isSafeInteger(value) && value > 0;
+}
+function isUnknownRecord(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
+//# sourceMappingURL=appDatabaseImport.js.map

package/dist/database-lifecycle/appDatabaseImport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"appDatabaseImport.js","sourceRoot":"","sources":["../../src/database-lifecycle/appDatabaseImport.ts"],"names":[],"mappings":"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"}

package/dist/database-lifecycle/appDatabaseImport.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=appDatabaseImport.test.d.ts.map

package/dist/database-lifecycle/appDatabaseImport.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"appDatabaseImport.test.d.ts","sourceRoot":"","sources":["../../src/database-lifecycle/appDatabaseImport.test.ts"],"names":[],"mappings":""}

package/dist/database-lifecycle/appDatabaseImport.test.js

@@ -0,0 +1,145 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const appDatabaseImport_js_1 = require("./appDatabaseImport.js");
+(0, vitest_1.describe)('App Database import contracts', () => {
+    (0, vitest_1.test)('validates operation-specific dispatch fields', () => {
+        const base = {
+            applicationId: 'application-id',
+            bindingId: 'binding-id',
+            bindingKey: 'binding-key',
+            desiredSpec: { engine: 'postgres', logicalName: 'Orders DB' },
+            desiredSpecHash: 'desired-spec-hash',
+            import: {
+                importId: 'import-id',
+                kind: 'pg_dump_custom',
+                prefixSizeBytes: 1_024,
+                profileToken: 'profile-token',
+                resourceToken: 'resource-token'
+            },
+            organizationId: 'organization-id',
+            profile: 'production',
+            requestId: 'request-id',
+            resourceKey: 'organization/application/database/profile/default'
+        };
+        (0, vitest_1.expect)((0, appDatabaseImport_js_1.isAppDatabaseImportDispatchPayload)({
+            ...base,
+            import: { ...base.import, expectedSizeBytes: 10_000 },
+            operation: 'prepare_import_prefix_upload'
+        })).toBe(true);
+        (0, vitest_1.expect)((0, appDatabaseImport_js_1.isAppDatabaseImportDispatchPayload)({
+            ...base,
+            import: base.import,
+            operation: 'prepare_import_prefix_upload'
+        })).toBe(false);
+        (0, vitest_1.expect)((0, appDatabaseImport_js_1.isAppDatabaseImportDispatchPayload)({
+            ...base,
+            import: {
+                ...base.import,
+                expectedSizeBytes: 10_000,
+                prefixObjectKey: 'imports/import-id/prefix'
+            },
+            operation: 'prepare_import_prefix_upload'
+        })).toBe(false);
+        (0, vitest_1.expect)((0, appDatabaseImport_js_1.isAppDatabaseImportDispatchPayload)({
+            ...base,
+            import: { ...base.import, prefixObjectKey: 'imports/import-id/prefix' },
+            operation: 'inspect_import_prefix'
+        })).toBe(true);
+        (0, vitest_1.expect)((0, appDatabaseImport_js_1.isAppDatabaseImportDispatchPayload)({
+            ...base,
+            import: {
+                ...base.import,
+                expectedSizeBytes: 10_000,
+                prefixObjectKey: 'imports/import-id/prefix'
+            },
+            operation: 'inspect_import_prefix'
+        })).toBe(false);
+        (0, vitest_1.expect)({
+            ...base,
+            import: { ...base.import, expectedSizeBytes: 10_000 },
+            operation: 'prepare_import_prefix_upload'
+        }).not.toHaveProperty('import.prefixObjectKey');
+        (0, vitest_1.expect)((0, appDatabaseImport_js_1.isAppDatabaseImportDispatchPayload)({
+            ...base,
+            operation: 'inspect_import_prefix'
+        })).toBe(false);
+        (0, vitest_1.expect)((0, appDatabaseImport_js_1.isAppDatabaseImportDispatchPayload)({
+            ...base,
+            import: { ...base.import, profileToken: '' },
+            operation: 'prepare_import_prefix_upload'
+        })).toBe(false);
+        (0, vitest_1.expect)((0, appDatabaseImport_js_1.isAppDatabaseImportDispatchPayload)({
+            ...base,
+            import: { ...base.import, resourceToken: '' },
+            operation: 'prepare_import_prefix_upload'
+        })).toBe(false);
+        const withoutOrganization = { ...base };
+        delete withoutOrganization.organizationId;
+        (0, vitest_1.expect)((0, appDatabaseImport_js_1.isAppDatabaseImportDispatchPayload)({
+            ...withoutOrganization,
+            import: { ...base.import, expectedSizeBytes: 10_000 },
+            operation: 'prepare_import_prefix_upload'
+        })).toBe(false);
+    });
+    (0, vitest_1.test)('requires prefix growth and narrow nested callback results', () => {
+        (0, vitest_1.expect)((0, appDatabaseImport_js_1.isAppDatabaseImportCallbackResult)({
+            inspectedPrefixSizeBytes: 1_024,
+            nextPrefixSizeBytes: 2_048,
+            result: 'prefix_incomplete'
+        })).toBe(true);
+        (0, vitest_1.expect)((0, appDatabaseImport_js_1.isAppDatabaseImportCallbackResult)({
+            inspectedPrefixSizeBytes: 1_024,
+            nextPrefixSizeBytes: 1_024,
+            result: 'prefix_incomplete'
+        })).toBe(false);
+        (0, vitest_1.expect)((0, appDatabaseImport_js_1.isAppDatabaseImportCallbackResult)({
+            prefixObjectKey: 'imports/import-id/prefix',
+            prefixUploadUrl: 'https://uploads.example/prefix',
+            result: 'prefix_upload_url'
+        })).toBe(true);
+        (0, vitest_1.expect)((0, appDatabaseImport_js_1.isAppDatabaseImportCallbackResult)({
+            prefixUploadUrl: 'https://uploads.example/prefix',
+            result: 'prefix_upload_url'
+        })).toBe(false);
+        const callback = {
+            bindingKey: 'binding-key',
+            import: {
+                prefixObjectKey: 'imports/import-id/prefix',
+                prefixUploadUrl: 'https://uploads.example/prefix',
+                result: 'prefix_upload_url'
+            },
+            lifecycleState: 'ready',
+            requestId: 'request-id'
+        };
+        if (callback.import.result !== 'prefix_upload_url') {
+            throw new Error('Expected prefix upload URL callback');
+        }
+        (0, vitest_1.expect)(callback.import.prefixUploadUrl).toContain('https://');
+        (0, vitest_1.expect)((0, appDatabaseImport_js_1.isAppDatabaseImportCallbackResult)({
+            result: 'schema_validated',
+            validationMetadata: {
+                postgresMajorVersion: 16,
+                tableNames: ['public.orders']
+            }
+        })).toBe(true);
+        (0, vitest_1.expect)((0, appDatabaseImport_js_1.isAppDatabaseImportCallbackResult)({
+            postgresMajorVersion: 16,
+            result: 'schema_validated',
+            tableNames: ['public.orders']
+        })).toBe(false);
+    });
+    (0, vitest_1.test)('retains only allowlisted validation metadata', () => {
+        (0, vitest_1.expect)((0, appDatabaseImport_js_1.parseAppDatabaseImportValidationMetadata)({
+            postgresMajorVersion: 16,
+            rows: [{ secret: 'value' }],
+            sql: 'CREATE TABLE private_data',
+            tableNames: ['public.orders', 'public.customers']
+        })).toEqual({
+            postgresMajorVersion: 16,
+            tableNames: ['public.orders', 'public.customers']
+        });
+        (0, vitest_1.expect)((0, appDatabaseImport_js_1.parseAppDatabaseImportValidationMetadata)({ postgresMajorVersion: 16, tableNames: [''] })).toBeUndefined();
+    });
+});
+//# sourceMappingURL=appDatabaseImport.test.js.map

package/dist/database-lifecycle/appDatabaseImport.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"appDatabaseImport.test.js","sourceRoot":"","sources":["../../src/database-lifecycle/appDatabaseImport.test.ts"],"names":[],"mappings":"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"}

package/dist/database-lifecycle/appDatabaseStatus.d.ts

@@ -0,0 +1,79 @@
+import type { AppDatabaseTagRef } from './appDatabaseCompatibility.js';
+import type { DatabaseEngine, LifecycleMigrationState, LifecycleState } from './index.js';
+/**
+ * Builder-safe physical instance fields. Pool capacity and the internal
+ * instance id stay off this payload: they are org-wide admin facts, and
+ * capacity.used counts every application in the org.
+ */
+export type AppDatabaseStatusInstance = {
+    engine: DatabaseEngine;
+    engineVersion: string | null;
+    region: string;
+};
+export type AppDatabaseStatusIntegration = {
+    apiNames: string[];
+    id: string;
+    name: string;
+    pluginId: string;
+};
+export type AppDatabaseStatusBinding = {
+    bindingId: string;
+    created: string;
+    instance: AppDatabaseStatusInstance | null;
+    integration: AppDatabaseStatusIntegration | null;
+    lastActivity: string;
+    lifecycleState: LifecycleState;
+    logicalName: string;
+    migrationDirectory: string | null;
+    migrationState: LifecycleMigrationState;
+};
+export type AppDatabaseStatusTag = AppDatabaseTagRef & {
+    /** Null when this data tag has no live (non-cancelled) database. */
+    binding: AppDatabaseStatusBinding | null;
+    /**
+     * True when this data tag had a database that was retired. The live
+     * binding is omitted so the tag can be provisioned again, but Status
+     * still shows Deleted instead of No database.
+     */
+    deleted: boolean;
+    displayName: string;
+    isDefaultEditor: boolean;
+};
+export type AppDatabaseStatus = {
+    applicationId: string;
+    /**
+     * Whether the app declares an App Database right now (working-state
+     * requirement). Same meaning as AppDatabaseCompatibility.hasAppDatabase.
+     * A leftover live binding with no requirement still appears under tags.
+     */
+    hasAppDatabase: boolean;
+    /**
+     * Whether leftover App Database code is still in the working tree: SQL
+     * in the last known migration folder, or APIs still wired to the app's
+     * Postgres integration. Used to offer Clark cleanup after Edit databases
+     * are gone. Not a complete scan of every page or helper.
+     */
+    hasDatabaseCode: boolean;
+    /**
+     * Whether the currently live published version stamped a database
+     * requirement. Working-state (Edit) rows are not this signal: a leftover
+     * production database stays undeletable until a version without databases
+     * is live.
+     */
+    liveVersionHasAppDatabase: boolean;
+    tags: AppDatabaseStatusTag[];
+};
+/**
+ * Edit lifecycle membership: tags used for edit provisioning and migrations.
+ * That is every editor-only tag, plus the editor default even when that
+ * default is also deploy-allowed.
+ */
+export declare function isEditLifecycleTag(tag: Pick<AppDatabaseStatusTag, 'availableModes'>): boolean;
+/**
+ * Deploy lifecycle membership for builder-facing grouping: deploy-allowed
+ * tags that are not the editor default. Publish still may write the editor
+ * default when it is also deploy-allowed; that tag stays an Edit database.
+ */
+export declare function isDeployLifecycleTag(tag: Pick<AppDatabaseStatusTag, 'availableModes'>): boolean;
+export declare function isProductionDatabaseRetirementEligible(status: AppDatabaseStatus): boolean;
+//# sourceMappingURL=appDatabaseStatus.d.ts.map

package/dist/database-lifecycle/appDatabaseStatus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"appDatabaseStatus.d.ts","sourceRoot":"","sources":["../../src/database-lifecycle/appDatabaseStatus.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,KAAK,EAAE,cAAc,EAAE,uBAAuB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE1F;;;;GAIG;AACH,MAAM,MAAM,yBAAyB,GAAG;IACtC,MAAM,EAAE,cAAc,CAAC;IACvB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,4BAA4B,GAAG;IACzC,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,yBAAyB,GAAG,IAAI,CAAC;IAC3C,WAAW,EAAE,4BAA4B,GAAG,IAAI,CAAC;IACjD,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,cAAc,CAAC;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,cAAc,EAAE,uBAAuB,CAAC;CACzC,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG,iBAAiB,GAAG;IACrD,oEAAoE;IACpE,OAAO,EAAE,wBAAwB,GAAG,IAAI,CAAC;IACzC;;;;OAIG;IACH,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,OAAO,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,aAAa,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,cAAc,EAAE,OAAO,CAAC;IACxB;;;;;OAKG;IACH,eAAe,EAAE,OAAO,CAAC;IACzB;;;;;OAKG;IACH,yBAAyB,EAAE,OAAO,CAAC;IACnC,IAAI,EAAE,oBAAoB,EAAE,CAAC;CAC9B,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,IAAI,CAAC,oBAAoB,EAAE,gBAAgB,CAAC,GAAG,OAAO,CAE7F;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,IAAI,CAAC,oBAAoB,EAAE,gBAAgB,CAAC,GAAG,OAAO,CAE/F;AAED,wBAAgB,sCAAsC,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAIzF"}

package/dist/database-lifecycle/appDatabaseStatus.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isEditLifecycleTag = isEditLifecycleTag;
+exports.isDeployLifecycleTag = isDeployLifecycleTag;
+exports.isProductionDatabaseRetirementEligible = isProductionDatabaseRetirementEligible;
+const index_js_1 = require("../types/event/index.js");
+/**
+ * Edit lifecycle membership: tags used for edit provisioning and migrations.
+ * That is every editor-only tag, plus the editor default even when that
+ * default is also deploy-allowed.
+ */
+function isEditLifecycleTag(tag) {
+    return tag.availableModes.includes(index_js_1.ViewMode.EDITOR);
+}
+/**
+ * Deploy lifecycle membership for builder-facing grouping: deploy-allowed
+ * tags that are not the editor default. Publish still may write the editor
+ * default when it is also deploy-allowed; that tag stays an Edit database.
+ */
+function isDeployLifecycleTag(tag) {
+    return tag.availableModes.includes(index_js_1.ViewMode.DEPLOYED) && !tag.availableModes.includes(index_js_1.ViewMode.EDITOR);
+}
+function isProductionDatabaseRetirementEligible(status) {
+    const hasEditDatabase = status.tags.some((tag) => tag.binding !== null && isEditLifecycleTag(tag));
+    const hasLeftoverProductionDatabase = status.tags.some((tag) => tag.binding !== null && !isEditLifecycleTag(tag));
+    return !hasEditDatabase && hasLeftoverProductionDatabase && !status.liveVersionHasAppDatabase;
+}
+//# sourceMappingURL=appDatabaseStatus.js.map

package/dist/database-lifecycle/appDatabaseStatus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"appDatabaseStatus.js","sourceRoot":"","sources":["../../src/database-lifecycle/appDatabaseStatus.ts"],"names":[],"mappings":";;AA6EA,gDAEC;AAOD,oDAEC;AAED,wFAIC;AA9FD,sDAAmD;AAwEnD;;;;GAIG;AACH,SAAgB,kBAAkB,CAAC,GAAiD;IAClF,OAAO,GAAG,CAAC,cAAc,CAAC,QAAQ,CAAC,mBAAQ,CAAC,MAAM,CAAC,CAAC;AACtD,CAAC;AAED;;;;GAIG;AACH,SAAgB,oBAAoB,CAAC,GAAiD;IACpF,OAAO,GAAG,CAAC,cAAc,CAAC,QAAQ,CAAC,mBAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,cAAc,CAAC,QAAQ,CAAC,mBAAQ,CAAC,MAAM,CAAC,CAAC;AACzG,CAAC;AAED,SAAgB,sCAAsC,CAAC,MAAyB;IAC9E,MAAM,eAAe,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,KAAK,IAAI,IAAI,kBAAkB,CAAC,GAAG,CAAC,CAAC,CAAC;IACnG,MAAM,6BAA6B,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,KAAK,IAAI,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAC,CAAC;IAClH,OAAO,CAAC,eAAe,IAAI,6BAA6B,IAAI,CAAC,MAAM,CAAC,yBAAyB,CAAC;AAChG,CAAC"}

package/dist/database-lifecycle/appDatabaseStatus.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=appDatabaseStatus.test.d.ts.map

package/dist/database-lifecycle/appDatabaseStatus.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"appDatabaseStatus.test.d.ts","sourceRoot":"","sources":["../../src/database-lifecycle/appDatabaseStatus.test.ts"],"names":[],"mappings":""}

package/dist/database-lifecycle/appDatabaseStatus.test.js

@@ -0,0 +1,88 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const index_js_1 = require("../types/event/index.js");
+const appDatabaseStatus_js_1 = require("./appDatabaseStatus.js");
+const binding = {
+    bindingId: 'binding-1',
+    created: '2026-09-14T00:00:00.000Z',
+    instance: null,
+    integration: null,
+    lastActivity: '2026-09-14T00:00:00.000Z',
+    lifecycleState: 'ready',
+    logicalName: 'app_db',
+    migrationDirectory: null,
+    migrationState: 'migrated'
+};
+function status(overrides = {}) {
+    return {
+        applicationId: 'app-1',
+        hasAppDatabase: false,
+        hasDatabaseCode: false,
+        liveVersionHasAppDatabase: false,
+        tags: [
+            {
+                availableModes: [index_js_1.ViewMode.DEPLOYED],
+                binding,
+                deleted: false,
+                displayName: 'Production',
+                isDefaultEditor: false,
+                profileKey: 'production'
+            }
+        ],
+        ...overrides
+    };
+}
+(0, vitest_1.describe)('production database retirement eligibility', () => {
+    (0, vitest_1.it)('offers deletion after a live version that does not need a database and Edit leftovers are gone', () => {
+        (0, vitest_1.expect)((0, appDatabaseStatus_js_1.isProductionDatabaseRetirementEligible)(status())).toBe(true);
+    });
+    (0, vitest_1.it)('refuses deletion while the live version still needs a database', () => {
+        (0, vitest_1.expect)((0, appDatabaseStatus_js_1.isProductionDatabaseRetirementEligible)(status({ liveVersionHasAppDatabase: true }))).toBe(false);
+    });
+    (0, vitest_1.it)('refuses deletion while an Edit-only database remains', () => {
+        (0, vitest_1.expect)((0, appDatabaseStatus_js_1.isProductionDatabaseRetirementEligible)(status({
+            tags: [
+                ...status().tags,
+                {
+                    availableModes: [index_js_1.ViewMode.EDITOR],
+                    binding: { ...binding, bindingId: 'edit-binding' },
+                    deleted: false,
+                    displayName: 'Staging',
+                    isDefaultEditor: true,
+                    profileKey: 'staging'
+                }
+            ]
+        }))).toBe(false);
+    });
+    (0, vitest_1.it)('offers deletion of an unassigned leftover after a live version that does not need a database', () => {
+        (0, vitest_1.expect)((0, appDatabaseStatus_js_1.isProductionDatabaseRetirementEligible)(status({
+            tags: [
+                {
+                    availableModes: [],
+                    binding,
+                    deleted: false,
+                    displayName: 'Removed production',
+                    isDefaultEditor: false,
+                    profileKey: 'removed-production'
+                }
+            ]
+        }))).toBe(true);
+    });
+    (0, vitest_1.it)('refuses deletion while the editor default is still live, even when that tag is also deploy-allowed', () => {
+        (0, vitest_1.expect)((0, appDatabaseStatus_js_1.isProductionDatabaseRetirementEligible)(status({
+            tags: [
+                ...status().tags,
+                {
+                    availableModes: [index_js_1.ViewMode.EDITOR, index_js_1.ViewMode.DEPLOYED],
+                    binding: { ...binding, bindingId: 'edit-binding' },
+                    deleted: false,
+                    displayName: 'Staging',
+                    isDefaultEditor: true,
+                    profileKey: 'staging'
+                }
+            ]
+        }))).toBe(false);
+    });
+});
+//# sourceMappingURL=appDatabaseStatus.test.js.map

package/dist/database-lifecycle/appDatabaseStatus.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"appDatabaseStatus.test.js","sourceRoot":"","sources":["../../src/database-lifecycle/appDatabaseStatus.test.ts"],"names":[],"mappings":"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"}