@sequenceholdings/orm 2.1.1 → 2.2.0

package/dist/index.d.ts

@@ -1,12 +1,13 @@
-export { AuthoringContext, AuthoringRegistration, COLUMN_BRAND, COLUMN_DEFAULT_FNS, CheckInput, ColumnBuilder, ColumnDefaultFn, ColumnDefaultLiteral, ColumnTypeSpec, Comparator, CowMutationInput, DrizzleRelation, DurationInput, ENUM_BRAND, EnumRef, EtlSourceInput, ForeignKeyInput, FunctionRef, IndexInput, LINK_BRAND, LinkKind, LoadNamespaceOptions, LoadedNamespaceV2, ManualSourceInput, NAMESPACE_CONFIG_BRAND, NAMESPACE_CONFIG_FILE, NamespaceCapabilitiesInput, NamespaceConfigInput, ORM_TO_PIPELINE_TYPE, OrmContractColumnMap, OrmContractPipelineColumn, OrmSyncedTableContract, OrmToPipelineType, OverlayTableRef, OverlayWinsUnionInput, OverrideRowMutationInput, PolicyInput, PolicyVariantInput, PolicyWithVariantsInput, PrefetchSourceInput, ReferentialAction, RelationRef, ResolvedSourceInput, ResolvedTableConfig, ResolvedTablePoliciesInput, RevertOverlayMutationInput, SCHEMA_DIR, SYNCED_CONTRACT_HASH_DOMAIN, SeqLink, SeqNamespaceConfig, SeqTable, SeqView, SerializeNamespaceInput, SyncedTableConfig, SyncedTablePoliciesInput, TABLE_BRAND, TableConfig, TablePoliciesInput, TableRef, ToManyOptions, ToOneOptions, ToPlatformUserOptions, TypedSyncedTableConfig, VIEW_BRAND, ViewConfig, ViewPoliciesInput, ViewQueryContext, ViewSelectQuery, activeAuthoringContext, beginAuthoringContext, computeCanonicalHash, computeSyncedContractHash, custom, defineEnum, defineNamespace, defineResolvedTable, defineSyncedTable, defineTable, defineView, deriveColumnName, endAuthoringContext, etlSource, extractOrmSyncedTableContract, highest, isColumnBuilder, isEnumRef, isSeqLink, isSeqNamespaceConfig, isSeqTable, isSeqView, latest, loadNamespaceFromDir, lowest, managedFn, manualSource, nonNullFirst, overlayWinsUnion, overrideRowMutation, prefetchSource, priority, revertOverlayMutation, serializeNamespace, syncedContractSurface, t, toMany, toOne, toPlatformUser } from './authoring.js';
+export { AuthoringContext, AuthoringRegistration, COLUMN_BRAND, COLUMN_DEFAULT_FNS, CatalogFolders, CheckInput, ColumnBuilder, ColumnDefaultFn, ColumnDefaultLiteral, ColumnTypeSpec, Comparator, CowMutationInput, DrizzleRelation, DurationInput, ENUM_BRAND, EnumRef, EtlSourceInput, ExternalObjectRef, ForeignKeyInput, FunctionRef, IndexInput, LINK_BRAND, LinkKind, LoadNamespaceOptions, LoadedNamespaceV2, ManualSourceInput, NAMESPACE_CONFIG_BRAND, NAMESPACE_CONFIG_FILE, NamespaceCapabilitiesInput, NamespaceCatalog, NamespaceConfigInput, ORM_TO_PIPELINE_TYPE, OrmContractColumnMap, OrmContractPipelineColumn, OrmSyncedTableContract, OrmToPipelineType, OverlayTableRef, OverlayWinsUnionInput, OverrideRowMutationInput, PolicyInput, PolicyVariantInput, PolicyWithVariantsInput, PrefetchSourceInput, ReferentialAction, RelationRef, ResolvedSourceInput, ResolvedTableConfig, ResolvedTablePoliciesInput, RevertOverlayMutationInput, SCHEMA_DIR, SYNCED_CONTRACT_HASH_DOMAIN, SeqLink, SeqNamespaceConfig, SeqTable, SeqView, SerializeNamespaceInput, SyncedTableConfig, SyncedTablePoliciesInput, TABLE_BRAND, TableConfig, TablePoliciesInput, TableRef, ToManyOptions, ToOneOptions, ToPlatformUserOptions, TypedSyncedTableConfig, VIEW_BRAND, ViewConfig, ViewPoliciesInput, ViewQueryContext, ViewSelectQuery, activeAuthoringContext, beginAuthoringContext, computeCanonicalHash, computeSyncedContractHash, custom, defineEnum, defineNamespace, defineResolvedTable, defineSyncedTable, defineTable, defineView, deriveColumnName, endAuthoringContext, etlSource, extractOrmSyncedTableContract, highest, isColumnBuilder, isEnumRef, isSeqLink, isSeqNamespaceConfig, isSeqTable, isSeqView, latest, loadNamespaceFromDir, lowest, managedFn, manualSource, nonNullFirst, objectRef, overlayWinsUnion, overrideRowMutation, prefetchSource, priority, revertOverlayMutation, serializeNamespace, syncedContractSurface, t, toMany, toOne, toPlatformUser, validateNamespaceCatalog } from './authoring.js';
+export { S as SqlOperationDefinition, d as defineOperation } from './definition-DjfC7Lll.js';
 import { CanonicalDefinition } from './canonical.js';
-export { CANONICAL_FORMAT, CanonicalColumn, CanonicalEnum, CanonicalLink, CanonicalTable, CanonicalView, IDENTIFIER_RE, canonicalActionSchema, canonicalColumnSchema, canonicalDefinitionSchema, canonicalEnumSchema, canonicalIndexSchema, canonicalLinkSchema, canonicalPoliciesSchema, canonicalRelations, canonicalTableSchema, canonicalViewSchema, normalizeCanonical } from './canonical.js';
+export { CANONICAL_FORMAT, CanonicalColumn, CanonicalEnum, CanonicalLink, CanonicalTable, CanonicalView, IDENTIFIER_RE, OntologyContract, canonicalActionSchema, canonicalColumnSchema, canonicalDefinitionSchema, canonicalEnumSchema, canonicalIndexSchema, canonicalLinkSchema, canonicalPoliciesSchema, canonicalRelations, canonicalTableSchema, canonicalViewSchema, normalizeCanonical, ontologyContractSchema, readOntologyContract } from './canonical.js';
 import { CustomRolesBlock } from '@sequenceholdings/custom-roles-manifest';
 export { CustomRolesBlock, capabilityPinsSchema, customRolesBlockSchema, customRolesDeclared, parseCapabilityPin, validateCapabilityPins } from '@sequenceholdings/custom-roles-manifest';
 import { z } from 'zod';
 import { PredIr } from './ir.js';
-export { CLAIMS_CONTRACT, CMP_OPS, CellSelectionIr, ClaimKey, CmpOp, CompiledArtifact, CompiledOperation, DATE_BUCKETS, DateBucket, GroupByKeyIr, INPUT_REF_KINDS, IR_VERSION, InputRefKind, IrVersionError, LEGACY_IR_VERSION, LimitIr, OrderIr, PrefetchPlanIr, ResolvedMetaIr, ResolvedSourceIr, RootIr, SelectionIr, TableMetaIr, ValueIr, VariableDefaultIr, VariableIr, compiledArtifactSchema, compiledOperationSchema, indexByHash, limitIrSchema, normalizeIr, orderIrSchema, predIrSchema, prefetchPlanIrSchema, requiredArtifactIrVersion, resolvedMetaIrSchema, resolvedSourceIrSchema, rootIrSchema, selectionIrSchema, tableMetaIrSchema, valueIrSchema, variableDefaultIrSchema, variableIrSchema } from './ir.js';
-export { e as CAPABILITY_KEY_PATTERN, C as CELLS_FIELD, a as CELL_PARTS, f as CELL_PART_SUFFIX, g as CLAIM_KEY_PATTERN, h as COLUMN_IDENTIFIER_PATTERN, i as CONSUMER_ROLE_SUFFIX, b as CellPart, D as DEFINITION_FILE_EXTENSIONS, H as HASH_DOMAIN, I as IDENTIFIER_PATTERN, M as MATERIALIZE_ACTOR, j as MATERIALIZE_CLAIMS_JSON, k as MAX_DEFINITION_FILE_BYTES, l as MAX_GENERATED_SDL_BYTES, m as MAX_IDENTIFIER_LENGTH, n as MAX_TRACKED_COLUMN_NAME, o as NAMESPACE_CONFIG_FILENAMES, N as NAMESPACE_PATTERN, O as ORM_DATA_TOKEN_HEADER, p as ORM_REGISTRATION_MAX_BYTES, q as ORM_SCHEMA_PREFIX, d as ORM_SERVICE_DATA_TOKEN_HEADER, Q as QUALIFIED_TABLE_PATTERN, R as RESERVED_COLUMN_NAMES, r as RESERVED_TABLE_NAMES, S as SYNCED_SOURCE_PATTERN, c as cellColumnName, s as consumerRoleName, t as materializeLockKey, u as materializedRefreshFunctionName, v as ormSchemaName } from './constants-YoFGjIBM.js';
+export { CLAIMS_CONTRACT, CMP_OPS, COMPOSED_IR_VERSION, CellSelectionIr, ClaimKey, CmpOp, CompiledArtifact, CompiledOperation, DATE_BUCKETS, DateBucket, GUARDED_IR_VERSION, GroupByKeyIr, INPUT_REF_KINDS, IR_VERSION, InputRefKind, IrVersionError, LEGACY_IR_VERSION, LimitIr, OrderIr, PrefetchPlanIr, RUNTIME_SQL_IR_VERSION, ResolvedMetaIr, ResolvedSourceIr, RootIr, SQL_IR_VERSION, SelectionIr, TableMetaIr, ValueIr, VariableDefaultIr, VariableIr, compiledArtifactSchema, compiledOperationSchema, indexByHash, limitIrSchema, normalizeIr, orderIrSchema, predIrSchema, prefetchPlanIrSchema, requiredArtifactIrVersion, resolvedMetaIrSchema, resolvedSourceIrSchema, rootIrSchema, selectionIrSchema, tableMetaIrSchema, valueIrSchema, variableDefaultIrSchema, variableIrSchema } from './ir.js';
+export { e as CAPABILITY_KEY_PATTERN, C as CELLS_FIELD, a as CELL_PARTS, f as CELL_PART_SUFFIX, g as CLAIM_KEY_PATTERN, h as COLUMN_IDENTIFIER_PATTERN, i as CONSUMER_ROLE_SUFFIX, b as CellPart, D as DEFINITION_FILE_EXTENSIONS, H as HASH_DOMAIN, I as IDENTIFIER_PATTERN, M as MATERIALIZE_ACTOR, j as MATERIALIZE_CLAIMS_JSON, k as MAX_DEFINITION_FILE_BYTES, l as MAX_GENERATED_SDL_BYTES, m as MAX_IDENTIFIER_LENGTH, n as MAX_TRACKED_COLUMN_NAME, o as NAMESPACE_CONFIG_FILENAMES, N as NAMESPACE_PATTERN, O as ORM_DATA_TOKEN_HEADER, p as ORM_REGISTRATION_MAX_BYTES, q as ORM_SCHEMA_PREFIX, d as ORM_SERVICE_DATA_TOKEN_HEADER, Q as QUALIFIED_TABLE_PATTERN, R as RESERVED_COLUMN_NAMES, r as RESERVED_TABLE_NAMES, S as SYNCED_SOURCE_PATTERN, c as cellColumnName, s as consumerRoleName, t as materializeLockKey, u as materializedRefreshFunctionName, v as ormSchemaName } from './constants-C6EG6Wq7.js';
 import { generateDrizzleJson } from 'drizzle-kit/api';
 import { PgTableWithColumns } from 'drizzle-orm/pg-core';
 export { P as PolicyExpression, p as policyExpressionSchema, a as policyVariantSchema } from './policy-1iZbGnZZ.js';
@@ -51,8 +52,8 @@ declare const actionParamSchema: z.ZodObject<{
     type: z.ZodEnum<{
         bigint: "bigint";
         boolean: "boolean";
-        text: "text";
         date: "date";
+        text: "text";
         timestamptz: "timestamptz";
         jsonb: "jsonb";
         uuid: "uuid";
@@ -76,8 +77,8 @@ declare const actionSchema: z.ZodObject<{
         type: z.ZodEnum<{
             bigint: "bigint";
             boolean: "boolean";
-            text: "text";
             date: "date";
+            text: "text";
             timestamptz: "timestamptz";
             jsonb: "jsonb";
             uuid: "uuid";
@@ -93,8 +94,8 @@ declare const actionSchema: z.ZodObject<{
     returns: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEnum<{
         bigint: "bigint";
         boolean: "boolean";
-        text: "text";
         date: "date";
+        text: "text";
         timestamptz: "timestamptz";
         jsonb: "jsonb";
         uuid: "uuid";
@@ -128,8 +129,8 @@ type ColumnType = (typeof COLUMN_TYPES)[number];
 declare const columnTypeSchema: z.ZodEnum<{
     bigint: "bigint";
     boolean: "boolean";
-    text: "text";
     date: "date";
+    text: "text";
     timestamptz: "timestamptz";
     jsonb: "jsonb";
     uuid: "uuid";
@@ -160,8 +161,8 @@ declare const columnSchema: z.ZodObject<{
     type: z.ZodEnum<{
         bigint: "bigint";
         boolean: "boolean";
-        text: "text";
         date: "date";
+        text: "text";
         timestamptz: "timestamptz";
         jsonb: "jsonb";
         uuid: "uuid";
@@ -210,8 +211,8 @@ declare const tableFileSchema: z.ZodObject<{
         type: z.ZodEnum<{
             bigint: "bigint";
             boolean: "boolean";
-            text: "text";
             date: "date";
+            text: "text";
             timestamptz: "timestamptz";
             jsonb: "jsonb";
             uuid: "uuid";
@@ -261,8 +262,8 @@ declare const tableFileSchema: z.ZodObject<{
             type: z.ZodEnum<{
                 bigint: "bigint";
                 boolean: "boolean";
-                text: "text";
                 date: "date";
+                text: "text";
                 timestamptz: "timestamptz";
                 jsonb: "jsonb";
                 uuid: "uuid";
@@ -278,8 +279,8 @@ declare const tableFileSchema: z.ZodObject<{
         returns: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEnum<{
             bigint: "bigint";
             boolean: "boolean";
-            text: "text";
             date: "date";
+            text: "text";
             timestamptz: "timestamptz";
             jsonb: "jsonb";
             uuid: "uuid";
@@ -360,6 +361,11 @@ type SyncedColumnType = ColumnType | {
 };
 type SyncedPredicateColumnTypes = Readonly<Record<string, SyncedColumnType>>;
 interface CompilePredIrToSqlOptions {
+    readonly alias?: string;
+    readonly exists?: (predicate: Extract<PredIr, {
+        kind: 'exists';
+    }>) => string;
+    readonly namespace?: string;
     /** Column name → declared type, for claim casts in comparisons. */
     readonly columnTypes?: SyncedPredicateColumnTypes;
     /** Logical column name → physical column name for the synced backing. */
@@ -425,10 +431,9 @@ declare const ROLES_CLAIM_KEY = "roles";
 declare const quoteIdentifier: (name: string) => string;
 declare const quoteLiteral: (value: string) => string;
 declare const claimExpression: (key: string) => string;
-/** NULL claims (or a missing capabilities array) coalesce to false — capability checks fail closed. */
-declare const capabilityExpression: (key: string) => string;
+declare const capabilityExpression: (key: string, namespace?: string) => string;
 /** NULL claims (or a missing roles array) coalesce to false — role checks fail closed. */
-declare const roleExpression: (key: string) => string;
+declare const roleExpression: (key: string, namespace?: string) => string;
 
 /** drizzle-kit's serialized schema — the diff/replay artifact the registry stores. */
 type NamespaceSnapshot = ReturnType<typeof generateDrizzleJson>;
@@ -756,6 +761,7 @@ declare const ormMigrationExportSchema: z.ZodObject<{
             }, z.core.$strip>>>;
             tables: z.ZodArray<z.ZodObject<{
                 table: z.ZodString;
+                displayName: z.ZodOptional<z.ZodString>;
                 description: z.ZodOptional<z.ZodString>;
                 renamedFrom: z.ZodOptional<z.ZodString>;
                 source: z.ZodOptional<z.ZodString>;
@@ -765,8 +771,8 @@ declare const ormMigrationExportSchema: z.ZodObject<{
                     type: z.ZodUnion<readonly [z.ZodEnum<{
                         bigint: "bigint";
                         boolean: "boolean";
-                        text: "text";
                         date: "date";
+                        text: "text";
                         timestamptz: "timestamptz";
                         jsonb: "jsonb";
                         uuid: "uuid";
@@ -810,6 +816,7 @@ declare const ormMigrationExportSchema: z.ZodObject<{
                         toPlatformUser: "toPlatformUser";
                     }>;
                     target: z.ZodOptional<z.ZodString>;
+                    namespace: z.ZodOptional<z.ZodString>;
                     on: z.ZodString;
                     references: z.ZodOptional<z.ZodString>;
                     enforce: z.ZodDefault<z.ZodBoolean>;
@@ -879,8 +886,8 @@ declare const ormMigrationExportSchema: z.ZodObject<{
                         type: z.ZodEnum<{
                             bigint: "bigint";
                             boolean: "boolean";
-                            text: "text";
                             date: "date";
+                            text: "text";
                             timestamptz: "timestamptz";
                             jsonb: "jsonb";
                             uuid: "uuid";
@@ -949,8 +956,8 @@ declare const ormMigrationExportSchema: z.ZodObject<{
                     type: z.ZodUnion<readonly [z.ZodEnum<{
                         bigint: "bigint";
                         boolean: "boolean";
-                        text: "text";
                         date: "date";
+                        text: "text";
                         timestamptz: "timestamptz";
                         jsonb: "jsonb";
                         uuid: "uuid";
@@ -994,6 +1001,7 @@ declare const ormMigrationExportSchema: z.ZodObject<{
                         toPlatformUser: "toPlatformUser";
                     }>;
                     target: z.ZodOptional<z.ZodString>;
+                    namespace: z.ZodOptional<z.ZodString>;
                     on: z.ZodString;
                     references: z.ZodOptional<z.ZodString>;
                     enforce: z.ZodDefault<z.ZodBoolean>;
@@ -1115,10 +1123,411 @@ declare const ormMigrationExportSchema: z.ZodObject<{
                 }, z.core.$strict>>;
                 internal: z.ZodOptional<z.ZodLiteral<true>>;
             }, z.core.$strip>>>;
+            exports: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+                read: z.ZodUnion<readonly [z.ZodLiteral<true>, z.ZodObject<{
+                    capability: z.ZodString;
+                }, z.core.$strict>, z.ZodObject<{
+                    role: z.ZodString;
+                }, z.core.$strict>]>;
+                write: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<true>, z.ZodObject<{
+                    capability: z.ZodString;
+                }, z.core.$strict>, z.ZodObject<{
+                    role: z.ZodString;
+                }, z.core.$strict>]>>;
+            }, z.core.$strict>>>;
             capabilities: z.ZodDefault<z.ZodObject<{
                 roles: z.ZodOptional<z.ZodUnknown>;
                 uses: z.ZodDefault<z.ZodArray<z.ZodString>>;
             }, z.core.$strip>>;
+            imports: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                definition_format: z.ZodLiteral<2>;
+                namespace: z.ZodString;
+                description: z.ZodOptional<z.ZodString>;
+                enums: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                    name: z.ZodString;
+                    values: z.ZodArray<z.ZodString>;
+                }, z.core.$strip>>>;
+                tables: z.ZodArray<z.ZodObject<{
+                    table: z.ZodString;
+                    displayName: z.ZodOptional<z.ZodString>;
+                    description: z.ZodOptional<z.ZodString>;
+                    renamedFrom: z.ZodOptional<z.ZodString>;
+                    source: z.ZodOptional<z.ZodString>;
+                    columns: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                        name: z.ZodString;
+                        columnName: z.ZodString;
+                        type: z.ZodUnion<readonly [z.ZodEnum<{
+                            bigint: "bigint";
+                            boolean: "boolean";
+                            date: "date";
+                            text: "text";
+                            timestamptz: "timestamptz";
+                            jsonb: "jsonb";
+                            uuid: "uuid";
+                            integer: "integer";
+                            numeric: "numeric";
+                            double: "double";
+                        }>, z.ZodObject<{
+                            enum: z.ZodString;
+                        }, z.core.$strip>]>;
+                        nullable: z.ZodDefault<z.ZodBoolean>;
+                        unique: z.ZodDefault<z.ZodBoolean>;
+                        default: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>>;
+                        defaultFn: z.ZodOptional<z.ZodEnum<{
+                            "gen_random_uuid()": "gen_random_uuid()";
+                            "now()": "now()";
+                        }>>;
+                        onUpdateFn: z.ZodOptional<z.ZodEnum<{
+                            "now()": "now()";
+                        }>>;
+                        description: z.ZodOptional<z.ZodString>;
+                        renamedFrom: z.ZodOptional<z.ZodString>;
+                        cast: z.ZodOptional<z.ZodString>;
+                        deprecated: z.ZodDefault<z.ZodBoolean>;
+                        cell: z.ZodOptional<z.ZodObject<{
+                            of: z.ZodString;
+                            part: z.ZodEnum<{
+                                at: "at";
+                                by: "by";
+                                rev: "rev";
+                                source: "source";
+                                conflicts: "conflicts";
+                            }>;
+                        }, z.core.$strict>>;
+                    }, z.core.$strip>>>;
+                    primaryKey: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                    links: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                        name: z.ZodString;
+                        kind: z.ZodEnum<{
+                            toOne: "toOne";
+                            toMany: "toMany";
+                            toPlatformUser: "toPlatformUser";
+                        }>;
+                        target: z.ZodOptional<z.ZodString>;
+                        namespace: z.ZodOptional<z.ZodString>;
+                        on: z.ZodString;
+                        references: z.ZodOptional<z.ZodString>;
+                        enforce: z.ZodDefault<z.ZodBoolean>;
+                        onDelete: z.ZodOptional<z.ZodEnum<{
+                            cascade: "cascade";
+                            restrict: "restrict";
+                            "no action": "no action";
+                            "set null": "set null";
+                            "set default": "set default";
+                        }>>;
+                        onUpdate: z.ZodOptional<z.ZodEnum<{
+                            cascade: "cascade";
+                            restrict: "restrict";
+                            "no action": "no action";
+                            "set null": "set null";
+                            "set default": "set default";
+                        }>>;
+                        description: z.ZodOptional<z.ZodString>;
+                    }, z.core.$strip>>>;
+                    indexes: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                        columns: z.ZodArray<z.ZodString>;
+                        unique: z.ZodDefault<z.ZodBoolean>;
+                        name: z.ZodOptional<z.ZodString>;
+                    }, z.core.$strip>>>;
+                    checks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                        name: z.ZodString;
+                        expression: z.ZodString;
+                    }, z.core.$strict>>>;
+                    policies: z.ZodDefault<z.ZodObject<{
+                        read: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+                            default: z.ZodString;
+                            variants: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                                when: z.ZodString;
+                                allow: z.ZodOptional<z.ZodLiteral<true>>;
+                                policy: z.ZodOptional<z.ZodString>;
+                            }, z.core.$strip>>>;
+                        }, z.core.$strip>]>>;
+                        write: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+                            default: z.ZodString;
+                            variants: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                                when: z.ZodString;
+                                allow: z.ZodOptional<z.ZodLiteral<true>>;
+                                policy: z.ZodOptional<z.ZodString>;
+                            }, z.core.$strip>>>;
+                        }, z.core.$strip>]>>;
+                        insert: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+                            default: z.ZodString;
+                            variants: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                                when: z.ZodString;
+                                allow: z.ZodOptional<z.ZodLiteral<true>>;
+                                policy: z.ZodOptional<z.ZodString>;
+                            }, z.core.$strip>>>;
+                        }, z.core.$strip>]>>;
+                        update: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+                            default: z.ZodString;
+                            variants: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                                when: z.ZodString;
+                                allow: z.ZodOptional<z.ZodLiteral<true>>;
+                                policy: z.ZodOptional<z.ZodString>;
+                            }, z.core.$strip>>>;
+                        }, z.core.$strip>]>>;
+                    }, z.core.$strip>>;
+                    actions: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                        name: z.ZodString;
+                        requires: z.ZodOptional<z.ZodString>;
+                        params: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+                            type: z.ZodEnum<{
+                                bigint: "bigint";
+                                boolean: "boolean";
+                                date: "date";
+                                text: "text";
+                                timestamptz: "timestamptz";
+                                jsonb: "jsonb";
+                                uuid: "uuid";
+                                integer: "integer";
+                                numeric: "numeric";
+                                double: "double";
+                            }>;
+                            nullable: z.ZodDefault<z.ZodBoolean>;
+                        }, z.core.$strip>>>;
+                        executes: z.ZodString;
+                        returns: z.ZodDefault<z.ZodEnum<{
+                            rows: "rows";
+                            rowsAffected: "rowsAffected";
+                            scalar: "scalar";
+                        }>>;
+                        audit: z.ZodOptional<z.ZodObject<{
+                            action: z.ZodString;
+                            resource: z.ZodString;
+                        }, z.core.$strip>>;
+                    }, z.core.$strip>>>;
+                    cowMutations: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                        kind: z.ZodEnum<{
+                            override: "override";
+                            revert: "revert";
+                        }>;
+                        name: z.ZodString;
+                        synced: z.ZodString;
+                        pk: z.ZodString;
+                        copy: z.ZodDefault<z.ZodArray<z.ZodString>>;
+                        set: z.ZodDefault<z.ZodArray<z.ZodString>>;
+                    }, z.core.$strip>>>;
+                    foreignKeys: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                        name: z.ZodString;
+                        columns: z.ZodArray<z.ZodString>;
+                        target: z.ZodString;
+                        references: z.ZodArray<z.ZodString>;
+                        deferrable: z.ZodOptional<z.ZodEnum<{
+                            "initially-immediate": "initially-immediate";
+                            "initially-deferred": "initially-deferred";
+                        }>>;
+                        onDelete: z.ZodOptional<z.ZodEnum<{
+                            cascade: "cascade";
+                            restrict: "restrict";
+                            "no action": "no action";
+                            "set null": "set null";
+                            "set default": "set default";
+                        }>>;
+                        onUpdate: z.ZodOptional<z.ZodEnum<{
+                            cascade: "cascade";
+                            restrict: "restrict";
+                            "no action": "no action";
+                            "set null": "set null";
+                            "set default": "set default";
+                        }>>;
+                    }, z.core.$strict>>>;
+                    cellMetadata: z.ZodOptional<z.ZodLiteral<true>>;
+                    internal: z.ZodOptional<z.ZodLiteral<true>>;
+                    materializes: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>>;
+                views: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    view: z.ZodString;
+                    description: z.ZodOptional<z.ZodString>;
+                    columns: z.ZodArray<z.ZodObject<{
+                        name: z.ZodString;
+                        columnName: z.ZodString;
+                        type: z.ZodUnion<readonly [z.ZodEnum<{
+                            bigint: "bigint";
+                            boolean: "boolean";
+                            date: "date";
+                            text: "text";
+                            timestamptz: "timestamptz";
+                            jsonb: "jsonb";
+                            uuid: "uuid";
+                            integer: "integer";
+                            numeric: "numeric";
+                            double: "double";
+                        }>, z.ZodObject<{
+                            enum: z.ZodString;
+                        }, z.core.$strip>]>;
+                        nullable: z.ZodDefault<z.ZodBoolean>;
+                        unique: z.ZodDefault<z.ZodBoolean>;
+                        default: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>>;
+                        defaultFn: z.ZodOptional<z.ZodEnum<{
+                            "gen_random_uuid()": "gen_random_uuid()";
+                            "now()": "now()";
+                        }>>;
+                        onUpdateFn: z.ZodOptional<z.ZodEnum<{
+                            "now()": "now()";
+                        }>>;
+                        description: z.ZodOptional<z.ZodString>;
+                        renamedFrom: z.ZodOptional<z.ZodString>;
+                        cast: z.ZodOptional<z.ZodString>;
+                        deprecated: z.ZodDefault<z.ZodBoolean>;
+                        cell: z.ZodOptional<z.ZodObject<{
+                            of: z.ZodString;
+                            part: z.ZodEnum<{
+                                at: "at";
+                                by: "by";
+                                rev: "rev";
+                                source: "source";
+                                conflicts: "conflicts";
+                            }>;
+                        }, z.core.$strict>>;
+                    }, z.core.$strip>>;
+                    primaryKey: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                    links: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                        name: z.ZodString;
+                        kind: z.ZodEnum<{
+                            toOne: "toOne";
+                            toMany: "toMany";
+                            toPlatformUser: "toPlatformUser";
+                        }>;
+                        target: z.ZodOptional<z.ZodString>;
+                        namespace: z.ZodOptional<z.ZodString>;
+                        on: z.ZodString;
+                        references: z.ZodOptional<z.ZodString>;
+                        enforce: z.ZodDefault<z.ZodBoolean>;
+                        onDelete: z.ZodOptional<z.ZodEnum<{
+                            cascade: "cascade";
+                            restrict: "restrict";
+                            "no action": "no action";
+                            "set null": "set null";
+                            "set default": "set default";
+                        }>>;
+                        onUpdate: z.ZodOptional<z.ZodEnum<{
+                            cascade: "cascade";
+                            restrict: "restrict";
+                            "no action": "no action";
+                            "set null": "set null";
+                            "set default": "set default";
+                        }>>;
+                        description: z.ZodOptional<z.ZodString>;
+                    }, z.core.$strip>>>;
+                    policies: z.ZodObject<{
+                        read: z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+                            default: z.ZodString;
+                            variants: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                                when: z.ZodString;
+                                allow: z.ZodOptional<z.ZodLiteral<true>>;
+                                policy: z.ZodOptional<z.ZodString>;
+                            }, z.core.$strip>>>;
+                        }, z.core.$strip>]>;
+                    }, z.core.$strict>;
+                    query: z.ZodString;
+                    dependencies: z.ZodArray<z.ZodString>;
+                    resolved: z.ZodOptional<z.ZodObject<{
+                        sources: z.ZodArray<z.ZodObject<{
+                            name: z.ZodString;
+                            kind: z.ZodEnum<{
+                                manual: "manual";
+                                prefetch: "prefetch";
+                                etl: "etl";
+                            }>;
+                            table: z.ZodString;
+                            columns: z.ZodArray<z.ZodString>;
+                            updatedAt: z.ZodOptional<z.ZodString>;
+                            key: z.ZodOptional<z.ZodString>;
+                            fetch: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
+                                shape: z.ZodLiteral<"single">;
+                            }, z.core.$strict>, z.ZodObject<{
+                                shape: z.ZodLiteral<"batch">;
+                                maxKeys: z.ZodNumber;
+                            }, z.core.$strict>]>>;
+                            function: z.ZodOptional<z.ZodObject<{
+                                kind: z.ZodEnum<{
+                                    managed: "managed";
+                                    native: "native";
+                                }>;
+                                id: z.ZodString;
+                            }, z.core.$strict>>;
+                            prefetchDefaults: z.ZodOptional<z.ZodObject<{
+                                maxStalenessMs: z.ZodNumber;
+                                timeoutMs: z.ZodNumber;
+                                onError: z.ZodEnum<{
+                                    fallback: "fallback";
+                                    fail: "fail";
+                                }>;
+                            }, z.core.$strict>>;
+                            writeback: z.ZodOptional<z.ZodObject<{
+                                columns: z.ZodArray<z.ZodString>;
+                                defaultMode: z.ZodEnum<{
+                                    sync: "sync";
+                                    async: "async";
+                                }>;
+                                timeoutMs: z.ZodNumber;
+                                clearManualOnConfirm: z.ZodBoolean;
+                            }, z.core.$strict>>;
+                        }, z.core.$strict>>;
+                        resolve: z.ZodArray<z.ZodObject<{
+                            column: z.ZodString;
+                            comparator: z.ZodEnum<{
+                                custom: "custom";
+                                latest: "latest";
+                                highest: "highest";
+                                lowest: "lowest";
+                                priority: "priority";
+                                nonNullFirst: "nonNullFirst";
+                            }>;
+                            candidates: z.ZodArray<z.ZodString>;
+                            orderBy: z.ZodOptional<z.ZodString>;
+                        }, z.core.$strict>>;
+                        deletedBy: z.ZodDefault<z.ZodArray<z.ZodString>>;
+                        materialized: z.ZodOptional<z.ZodObject<{
+                            table: z.ZodString;
+                            compute: z.ZodString;
+                        }, z.core.$strict>>;
+                        policies: z.ZodDefault<z.ZodObject<{
+                            write: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+                                default: z.ZodString;
+                                variants: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                                    when: z.ZodString;
+                                    allow: z.ZodOptional<z.ZodLiteral<true>>;
+                                    policy: z.ZodOptional<z.ZodString>;
+                                }, z.core.$strip>>>;
+                            }, z.core.$strip>]>>;
+                            insert: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+                                default: z.ZodString;
+                                variants: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                                    when: z.ZodString;
+                                    allow: z.ZodOptional<z.ZodLiteral<true>>;
+                                    policy: z.ZodOptional<z.ZodString>;
+                                }, z.core.$strip>>>;
+                            }, z.core.$strip>]>>;
+                            update: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+                                default: z.ZodString;
+                                variants: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                                    when: z.ZodString;
+                                    allow: z.ZodOptional<z.ZodLiteral<true>>;
+                                    policy: z.ZodOptional<z.ZodString>;
+                                }, z.core.$strip>>>;
+                            }, z.core.$strip>]>>;
+                        }, z.core.$strict>>;
+                    }, z.core.$strict>>;
+                    internal: z.ZodOptional<z.ZodLiteral<true>>;
+                }, z.core.$strip>>>;
+                exports: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+                    read: z.ZodUnion<readonly [z.ZodLiteral<true>, z.ZodObject<{
+                        capability: z.ZodString;
+                    }, z.core.$strict>, z.ZodObject<{
+                        role: z.ZodString;
+                    }, z.core.$strict>]>;
+                    write: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<true>, z.ZodObject<{
+                        capability: z.ZodString;
+                    }, z.core.$strict>, z.ZodObject<{
+                        role: z.ZodString;
+                    }, z.core.$strict>]>>;
+                }, z.core.$strict>>>;
+                capabilities: z.ZodDefault<z.ZodObject<{
+                    roles: z.ZodOptional<z.ZodUnknown>;
+                    uses: z.ZodDefault<z.ZodArray<z.ZodString>>;
+                }, z.core.$strip>>;
+            }, z.core.$strip>>>;
         }, z.core.$strip>;
         documents: z.ZodArray<z.ZodObject<{
             path: z.ZodString;
@@ -1387,4 +1796,55 @@ declare function parseCanonicalDefinition(value: unknown): NamespaceDefinition;
 
 declare const parsedPredicateSchema: z.ZodPipe<z.ZodString, z.ZodTransform<ParsedPredicate, string>>;
 
-export { ACTION_REQUIRES_DENIED_SQLSTATE, ACTION_VALIDATES_FAILED_SQLSTATE, AUDIT_ACTIONS, type ActionDefinition, CAPABILITIES_CLAIM_KEY, CLAIMS_SETTING, COLUMN_TYPES, COMPARE_OPS, CanonicalDefinition, type ColumnDefault, type ColumnDefinition, type ColumnType, type CommittedChainEntry, type CommittedMigration, type CompareOp, type CompilePredIrToSqlOptions, type CompiledStatement, type DefinitionFile, type DefinitionSource, type DestructiveStatement, type DiffOptions, type DrizzleEntities, type IndexDefinition, type JournalEntry, type LinkDefinition, type LoadedNamespace, MIGRATIONS_DIRNAME, type MigrationJournal, type MigrationWorkspace, type NamespaceCapabilities, type NamespaceConfig, type NamespaceDefinition, type NamespaceSnapshot, ORM_MIGRATION_EXPORT_FILE, ORM_MIGRATION_EXPORT_MAX_BYTES, type Operand, OrmDefinitionError, type OrmMigrationExport, type ParsedPredicate, type PlannedMigration, PredIr, type Predicate, type PredicateColumnTypes, PredicateParseError, ROLES_CLAIM_KEY, type RebaseEntry, type RebaseEntryInput, type RebaseNoopOptions, STATEMENT_KINDS, SYNCED_VIEW_EXECUTION_OWNER_ROLE, type StatementKind, type SyncedBacking, type SyncedColumnType, type SyncedPredicateColumnTypes, type TableFile, type ValidatesEntry, type WrittenMigration, actionFunctionName, actionFunctionStatements, actionParamArg, actionParamOrder, actionParamSchema, actionPrepareChecks, actionSchema, actionWriteTargets, actionsInterfaceName, applyMigrationHints, applyMigrationHintsV2, buildActionParamsSchema, buildDrizzleEntities, buildDrizzleEntitiesV2, buildNamespaceDefinition, buildRebaseJournalEntry, canonicalizeDefinition, capabilityExpression, castParts, checksumOf, claimExpression, classifyDestructive, columnSchema, columnTypeSchema, compileActionRequires, compileActionStatements, compileNamespace, compilePredIrToSql, compilePredicate, computeDefinitionHash, convertV1DefinitionToCanonical, createOrmMigrationExport, declaredCapabilityKeys, diffCommand, diffStatements, emptyJournal, emptySnapshot, extractNamedParams, generateNamespaceTypes, generateSnapshot, generateSnapshotV2, identifierSchema, isFunctionDefault, isOwnedStatement, isOwnedStatementV2, isQualifiedReference, loadCommittedMigrations, loadCommittedTipMigration, loadNamespaceDefinition, migrationName, namespaceConfigSchema, namespaceSchema, normalizeSnapshot, ormMigrationExportSchema, parseCanonicalDefinition, parseDefinitionSources, parseOrmMigrationExport, parsePredicate, parseTableFile, parsedPredicateSchema, pendingKitStatements, pendingKitStatementsV2, planCommittedMigrationV2, planMigration, planMigrationV2, predicateOperands, quoteIdentifier, quoteLiteral, readMigrationSql, readMigrationWorkspace, readSnapshot, rebaseViolations, referencedCapabilities, referencedColumns, renderMigrationSql, renderOrmMigrationExport, rewriteSyncedSourceRelationsInViewQuery, roleExpression, securityStatements, sqlTypeName, stableJson, syncedBackingRevokeStatements, syncedTables, syncedViewDropStatements, syncedViewStatements, tableFileSchema, tableReferenceSchema, typesInterfaceName, validateViewCatalogStatement, verifyRebaseIsNoop, walkPredicate, writeMigration };
+/** How a re-run treats a source key that is already in the ORM table. */
+declare const IMPORT_CONFLICT_MODES: readonly ["error", "skip", "update"];
+type ImportConflictMode = (typeof IMPORT_CONFLICT_MODES)[number];
+/**
+ * Copy one Lakebase/Postgres relation into an owned ORM table.
+ * The relation is where a warehouse table already lands after sync; this
+ * spec never accepts SQL text.
+ */
+declare const importSpecSchema: z.ZodObject<{
+    table: z.ZodString;
+    from: z.ZodString;
+    columns: z.ZodArray<z.ZodObject<{
+        target: z.ZodString;
+        source: z.ZodString;
+        nullDefault: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
+    }, z.core.$strict>>;
+    onConflict: z.ZodDefault<z.ZodEnum<{
+        error: "error";
+        update: "update";
+        skip: "skip";
+    }>>;
+    batchSize: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strict>;
+type ImportSpec = z.infer<typeof importSpecSchema>;
+type ImportPlan = {
+    readonly probeSql: string;
+    readonly script: string;
+    readonly batchSize: number;
+    readonly onConflict: ImportConflictMode;
+    readonly warnings: readonly string[];
+};
+type ImportPlanResult = {
+    ok: true;
+    plan: ImportPlan;
+} | {
+    ok: false;
+    errors: readonly string[];
+};
+
+/**
+ * Plan a set-based copy from an existing Postgres relation into an owned ORM
+ * table. The relation is the Lakebase landing of a warehouse table. The plan
+ * is SQL text: identifiers are allowlisted, constants are typed literals, and
+ * no caller SQL is interpolated.
+ */
+declare function planTableImport({ definition, spec, after, }: {
+    definition: unknown;
+    spec: unknown;
+    after?: string;
+}): ImportPlanResult;
+
+export { ACTION_REQUIRES_DENIED_SQLSTATE, ACTION_VALIDATES_FAILED_SQLSTATE, AUDIT_ACTIONS, type ActionDefinition, CAPABILITIES_CLAIM_KEY, CLAIMS_SETTING, COLUMN_TYPES, COMPARE_OPS, CanonicalDefinition, type ColumnDefault, type ColumnDefinition, type ColumnType, type CommittedChainEntry, type CommittedMigration, type CompareOp, type CompilePredIrToSqlOptions, type CompiledStatement, type DefinitionFile, type DefinitionSource, type DestructiveStatement, type DiffOptions, type DrizzleEntities, IMPORT_CONFLICT_MODES, type ImportConflictMode, type ImportPlan, type ImportPlanResult, type ImportSpec, type IndexDefinition, type JournalEntry, type LinkDefinition, type LoadedNamespace, MIGRATIONS_DIRNAME, type MigrationJournal, type MigrationWorkspace, type NamespaceCapabilities, type NamespaceConfig, type NamespaceDefinition, type NamespaceSnapshot, ORM_MIGRATION_EXPORT_FILE, ORM_MIGRATION_EXPORT_MAX_BYTES, type Operand, OrmDefinitionError, type OrmMigrationExport, type ParsedPredicate, type PlannedMigration, PredIr, type Predicate, type PredicateColumnTypes, PredicateParseError, ROLES_CLAIM_KEY, type RebaseEntry, type RebaseEntryInput, type RebaseNoopOptions, STATEMENT_KINDS, SYNCED_VIEW_EXECUTION_OWNER_ROLE, type StatementKind, type SyncedBacking, type SyncedColumnType, type SyncedPredicateColumnTypes, type TableFile, type ValidatesEntry, type WrittenMigration, actionFunctionName, actionFunctionStatements, actionParamArg, actionParamOrder, actionParamSchema, actionPrepareChecks, actionSchema, actionWriteTargets, actionsInterfaceName, applyMigrationHints, applyMigrationHintsV2, buildActionParamsSchema, buildDrizzleEntities, buildDrizzleEntitiesV2, buildNamespaceDefinition, buildRebaseJournalEntry, canonicalizeDefinition, capabilityExpression, castParts, checksumOf, claimExpression, classifyDestructive, columnSchema, columnTypeSchema, compileActionRequires, compileActionStatements, compileNamespace, compilePredIrToSql, compilePredicate, computeDefinitionHash, convertV1DefinitionToCanonical, createOrmMigrationExport, declaredCapabilityKeys, diffCommand, diffStatements, emptyJournal, emptySnapshot, extractNamedParams, generateNamespaceTypes, generateSnapshot, generateSnapshotV2, identifierSchema, importSpecSchema, isFunctionDefault, isOwnedStatement, isOwnedStatementV2, isQualifiedReference, loadCommittedMigrations, loadCommittedTipMigration, loadNamespaceDefinition, migrationName, namespaceConfigSchema, namespaceSchema, normalizeSnapshot, ormMigrationExportSchema, parseCanonicalDefinition, parseDefinitionSources, parseOrmMigrationExport, parsePredicate, parseTableFile, parsedPredicateSchema, pendingKitStatements, pendingKitStatementsV2, planCommittedMigrationV2, planMigration, planMigrationV2, planTableImport, predicateOperands, quoteIdentifier, quoteLiteral, readMigrationSql, readMigrationWorkspace, readSnapshot, rebaseViolations, referencedCapabilities, referencedColumns, renderMigrationSql, renderOrmMigrationExport, rewriteSyncedSourceRelationsInViewQuery, roleExpression, securityStatements, sqlTypeName, stableJson, syncedBackingRevokeStatements, syncedTables, syncedViewDropStatements, syncedViewStatements, tableFileSchema, tableReferenceSchema, typesInterfaceName, validateViewCatalogStatement, verifyRebaseIsNoop, walkPredicate, writeMigration };