@sequenceholdings/orm 2.1.1 → 2.2.0

package/dist/authoring.d.cts

@@ -1,8 +1,9 @@
 import { ColumnType, CanonicalColumn, ComparatorKind, CanonicalFunctionRef, CanonicalFetchShape, CanonicalDefinition, CanonicalTable } from './canonical.cjs';
-import { b as CellPart } from './constants-YoFGjIBM.cjs';
+import { b as CellPart } from './constants-C6EG6Wq7.cjs';
 import { ColumnsSelection } from 'drizzle-orm';
 import { TypedQueryBuilder } from 'drizzle-orm/query-builders/query-builder';
 import { QueryBuilder, PgView, PgTable, AnyPgColumn } from 'drizzle-orm/pg-core';
+export { S as SqlOperationDefinition, d as defineOperation } from './definition-DjfC7Lll.cjs';
 import 'zod';
 import './policy-1iZbGnZZ.cjs';
 
@@ -121,7 +122,7 @@ interface CowMutationInput {
 interface OverrideRowMutationInput<TOverlay extends OverlayTableRef = OverlayTableRef, TSynced extends SeqTable = SeqTable> {
     /** Writable ORM overlay table (or `{ tableName, columns }` descriptor). */
     overlay: TOverlay;
-    /** Read-only synced table reflecting the gold-layer source. */
+    /** Read-only synced table reflecting its qualified source relation. */
     synced: TSynced;
     /**
      * Property name of the single-column primary key shared by both tables.
@@ -411,7 +412,7 @@ declare function defineView<const TColumns extends Record<string, ColumnBuilder>
 interface OverlayWinsUnionInput<TOverlay extends SeqTable = SeqTable, TSynced extends SeqTable = SeqTable> {
     /** The ORM overlay table (writable, has `tombstone` if soft-delete is used). */
     overlay: TOverlay;
-    /** The synced (read-only) table reflecting the gold-layer source. */
+    /** The synced (read-only) table reflecting its qualified source relation. */
     synced: TSynced;
     /**
      * Property name of the single-column primary key shared by both tables.
@@ -451,7 +452,14 @@ declare const LINK_BRAND: "seq-link";
 /** A link target: a managed table/view, or a lazy thunk for forward/cyclic references. */
 type RelationRef = SeqTable | SeqView | (() => SeqTable | SeqView);
 /** Backward-compatible alias retained for existing consumers. */
-type TableRef = RelationRef;
+type TableRef = RelationRef | ExternalObjectRef;
+interface ExternalObjectRef {
+    readonly kind: 'seq-external-object';
+    readonly namespace: string;
+    readonly table: string;
+}
+/** Qualified identity resolved against a pinned namespace contract at compile time. */
+declare function objectRef(namespace: string, table: string): ExternalObjectRef;
 type LinkKind = 'toOne' | 'toMany' | 'toPlatformUser';
 type ReferentialAction = 'cascade' | 'restrict' | 'no action' | 'set null' | 'set default';
 interface SeqLink {
@@ -537,6 +545,7 @@ interface ForeignKeyInput {
     onUpdate?: ReferentialAction;
 }
 interface TableConfig {
+    displayName?: string;
     description?: string;
     /** Table-level migration rename hint (new in v2). */
     renamedFrom?: string;
@@ -583,7 +592,7 @@ interface SeqTable<TColumns extends Record<string, ColumnBuilder> = Record<strin
     readonly tableName: string;
     readonly columns: Readonly<TColumns>;
     readonly config: TableConfig;
-    /** Synced reflected source (`gold.*`) — set only by defineSyncedTable. */
+    /** Synced reflected source (`schema.table`) — set only by defineSyncedTable. */
     readonly source: string | undefined;
     /** Consumer file that defined the table (set when loaded via loadNamespaceFromDir). */
     readonly file: string | undefined;
@@ -595,11 +604,11 @@ interface SyncedTablePoliciesInput {
     read?: PolicyInput;
 }
 /**
- * Config for a read-only gold reflection. Columns (typed overload) are a contract
+ * Config for a read-only qualified-source reflection. Columns (typed overload) are a contract
  * for views/clients — ORM does not own synced DDL.
  */
 interface SyncedTableConfig {
-    /** Reflected read-only source, restricted to the gold layer: `gold.<table>`. */
+    /** Reflected read-only source as a safe qualified identifier: `<schema>.<table>`. */
     source: string;
     description?: string;
     /** Composite primary key: property names (or column names). Mutually exclusive with column-level `.primaryKey()`. */
@@ -632,12 +641,16 @@ interface NamespaceConfigInput {
     namespace: string;
     description?: string;
     capabilities?: NamespaceCapabilitiesInput;
+    imports?: readonly unknown[];
+    exports?: CanonicalDefinition['exports'];
 }
 interface SeqNamespaceConfig {
     readonly kind: typeof NAMESPACE_CONFIG_BRAND;
     readonly namespace: string;
     readonly description: string | undefined;
     readonly capabilities: NamespaceCapabilitiesInput;
+    readonly imports?: readonly unknown[];
+    readonly exports?: CanonicalDefinition['exports'];
     readonly file: string | undefined;
 }
 declare function isSeqNamespaceConfig(value: unknown): value is SeqNamespaceConfig;
@@ -774,4 +787,14 @@ declare function beginAuthoringContext(): AuthoringContext;
 declare function endAuthoringContext(context: AuthoringContext): void;
 declare function activeAuthoringContext(): AuthoringContext | undefined;
 
-export { type AuthoringContext, type AuthoringRegistration, COLUMN_BRAND, COLUMN_DEFAULT_FNS, type CheckInput, ColumnBuilder, type ColumnDefaultFn, type ColumnDefaultLiteral, type ColumnTypeSpec, type Comparator, type CowMutationInput, type DrizzleRelation, type DurationInput, ENUM_BRAND, type EnumRef, type EtlSourceInput, type ForeignKeyInput, type FunctionRef, type IndexInput, LINK_BRAND, type LinkKind, type LoadNamespaceOptions, type LoadedNamespaceV2, type ManualSourceInput, NAMESPACE_CONFIG_BRAND, NAMESPACE_CONFIG_FILE, type NamespaceCapabilitiesInput, type NamespaceConfigInput, ORM_TO_PIPELINE_TYPE, type OrmContractColumnMap, type OrmContractPipelineColumn, type OrmSyncedTableContract, type OrmToPipelineType, type OverlayTableRef, type OverlayWinsUnionInput, type OverrideRowMutationInput, type PolicyInput, type PolicyVariantInput, type PolicyWithVariantsInput, type PrefetchSourceInput, type ReferentialAction, type RelationRef, type ResolvedSourceInput, type ResolvedTableConfig, type ResolvedTablePoliciesInput, type RevertOverlayMutationInput, SCHEMA_DIR, SYNCED_CONTRACT_HASH_DOMAIN, type SeqLink, type SeqNamespaceConfig, type SeqTable, type SeqView, type SerializeNamespaceInput, type SyncedTableConfig, type SyncedTablePoliciesInput, TABLE_BRAND, type TableConfig, type TablePoliciesInput, type TableRef, type ToManyOptions, type ToOneOptions, type ToPlatformUserOptions, type TypedSyncedTableConfig, VIEW_BRAND, type ViewConfig, type ViewPoliciesInput, type ViewQueryContext, type 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 };
+interface CatalogFolders {
+    [name: string]: CatalogFolders | null;
+}
+/** Presentation-only organization; never included in the canonical schema hash. */
+interface NamespaceCatalog {
+    folders: CatalogFolders;
+    objects: Record<string, string>;
+}
+declare function validateNamespaceCatalog(catalog: NamespaceCatalog, file?: string): void;
+
+export { type AuthoringContext, type AuthoringRegistration, COLUMN_BRAND, COLUMN_DEFAULT_FNS, type CatalogFolders, type CheckInput, ColumnBuilder, type ColumnDefaultFn, type ColumnDefaultLiteral, type ColumnTypeSpec, type Comparator, type CowMutationInput, type DrizzleRelation, type DurationInput, ENUM_BRAND, type EnumRef, type EtlSourceInput, type ExternalObjectRef, type ForeignKeyInput, type FunctionRef, type IndexInput, LINK_BRAND, type LinkKind, type LoadNamespaceOptions, type LoadedNamespaceV2, type ManualSourceInput, NAMESPACE_CONFIG_BRAND, NAMESPACE_CONFIG_FILE, type NamespaceCapabilitiesInput, type NamespaceCatalog, type NamespaceConfigInput, ORM_TO_PIPELINE_TYPE, type OrmContractColumnMap, type OrmContractPipelineColumn, type OrmSyncedTableContract, type OrmToPipelineType, type OverlayTableRef, type OverlayWinsUnionInput, type OverrideRowMutationInput, type PolicyInput, type PolicyVariantInput, type PolicyWithVariantsInput, type PrefetchSourceInput, type ReferentialAction, type RelationRef, type ResolvedSourceInput, type ResolvedTableConfig, type ResolvedTablePoliciesInput, type RevertOverlayMutationInput, SCHEMA_DIR, SYNCED_CONTRACT_HASH_DOMAIN, type SeqLink, type SeqNamespaceConfig, type SeqTable, type SeqView, type SerializeNamespaceInput, type SyncedTableConfig, type SyncedTablePoliciesInput, TABLE_BRAND, type TableConfig, type TablePoliciesInput, type TableRef, type ToManyOptions, type ToOneOptions, type ToPlatformUserOptions, type TypedSyncedTableConfig, VIEW_BRAND, type ViewConfig, type ViewPoliciesInput, type ViewQueryContext, type 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 };

package/dist/authoring.d.ts

@@ -1,8 +1,9 @@
 import { ColumnType, CanonicalColumn, ComparatorKind, CanonicalFunctionRef, CanonicalFetchShape, CanonicalDefinition, CanonicalTable } from './canonical.js';
-import { b as CellPart } from './constants-YoFGjIBM.js';
+import { b as CellPart } from './constants-C6EG6Wq7.js';
 import { ColumnsSelection } from 'drizzle-orm';
 import { TypedQueryBuilder } from 'drizzle-orm/query-builders/query-builder';
 import { QueryBuilder, PgView, PgTable, AnyPgColumn } from 'drizzle-orm/pg-core';
+export { S as SqlOperationDefinition, d as defineOperation } from './definition-DjfC7Lll.js';
 import 'zod';
 import './policy-1iZbGnZZ.js';
 
@@ -121,7 +122,7 @@ interface CowMutationInput {
 interface OverrideRowMutationInput<TOverlay extends OverlayTableRef = OverlayTableRef, TSynced extends SeqTable = SeqTable> {
     /** Writable ORM overlay table (or `{ tableName, columns }` descriptor). */
     overlay: TOverlay;
-    /** Read-only synced table reflecting the gold-layer source. */
+    /** Read-only synced table reflecting its qualified source relation. */
     synced: TSynced;
     /**
      * Property name of the single-column primary key shared by both tables.
@@ -411,7 +412,7 @@ declare function defineView<const TColumns extends Record<string, ColumnBuilder>
 interface OverlayWinsUnionInput<TOverlay extends SeqTable = SeqTable, TSynced extends SeqTable = SeqTable> {
     /** The ORM overlay table (writable, has `tombstone` if soft-delete is used). */
     overlay: TOverlay;
-    /** The synced (read-only) table reflecting the gold-layer source. */
+    /** The synced (read-only) table reflecting its qualified source relation. */
     synced: TSynced;
     /**
      * Property name of the single-column primary key shared by both tables.
@@ -451,7 +452,14 @@ declare const LINK_BRAND: "seq-link";
 /** A link target: a managed table/view, or a lazy thunk for forward/cyclic references. */
 type RelationRef = SeqTable | SeqView | (() => SeqTable | SeqView);
 /** Backward-compatible alias retained for existing consumers. */
-type TableRef = RelationRef;
+type TableRef = RelationRef | ExternalObjectRef;
+interface ExternalObjectRef {
+    readonly kind: 'seq-external-object';
+    readonly namespace: string;
+    readonly table: string;
+}
+/** Qualified identity resolved against a pinned namespace contract at compile time. */
+declare function objectRef(namespace: string, table: string): ExternalObjectRef;
 type LinkKind = 'toOne' | 'toMany' | 'toPlatformUser';
 type ReferentialAction = 'cascade' | 'restrict' | 'no action' | 'set null' | 'set default';
 interface SeqLink {
@@ -537,6 +545,7 @@ interface ForeignKeyInput {
     onUpdate?: ReferentialAction;
 }
 interface TableConfig {
+    displayName?: string;
     description?: string;
     /** Table-level migration rename hint (new in v2). */
     renamedFrom?: string;
@@ -583,7 +592,7 @@ interface SeqTable<TColumns extends Record<string, ColumnBuilder> = Record<strin
     readonly tableName: string;
     readonly columns: Readonly<TColumns>;
     readonly config: TableConfig;
-    /** Synced reflected source (`gold.*`) — set only by defineSyncedTable. */
+    /** Synced reflected source (`schema.table`) — set only by defineSyncedTable. */
     readonly source: string | undefined;
     /** Consumer file that defined the table (set when loaded via loadNamespaceFromDir). */
     readonly file: string | undefined;
@@ -595,11 +604,11 @@ interface SyncedTablePoliciesInput {
     read?: PolicyInput;
 }
 /**
- * Config for a read-only gold reflection. Columns (typed overload) are a contract
+ * Config for a read-only qualified-source reflection. Columns (typed overload) are a contract
  * for views/clients — ORM does not own synced DDL.
  */
 interface SyncedTableConfig {
-    /** Reflected read-only source, restricted to the gold layer: `gold.<table>`. */
+    /** Reflected read-only source as a safe qualified identifier: `<schema>.<table>`. */
     source: string;
     description?: string;
     /** Composite primary key: property names (or column names). Mutually exclusive with column-level `.primaryKey()`. */
@@ -632,12 +641,16 @@ interface NamespaceConfigInput {
     namespace: string;
     description?: string;
     capabilities?: NamespaceCapabilitiesInput;
+    imports?: readonly unknown[];
+    exports?: CanonicalDefinition['exports'];
 }
 interface SeqNamespaceConfig {
     readonly kind: typeof NAMESPACE_CONFIG_BRAND;
     readonly namespace: string;
     readonly description: string | undefined;
     readonly capabilities: NamespaceCapabilitiesInput;
+    readonly imports?: readonly unknown[];
+    readonly exports?: CanonicalDefinition['exports'];
     readonly file: string | undefined;
 }
 declare function isSeqNamespaceConfig(value: unknown): value is SeqNamespaceConfig;
@@ -774,4 +787,14 @@ declare function beginAuthoringContext(): AuthoringContext;
 declare function endAuthoringContext(context: AuthoringContext): void;
 declare function activeAuthoringContext(): AuthoringContext | undefined;
 
-export { type AuthoringContext, type AuthoringRegistration, COLUMN_BRAND, COLUMN_DEFAULT_FNS, type CheckInput, ColumnBuilder, type ColumnDefaultFn, type ColumnDefaultLiteral, type ColumnTypeSpec, type Comparator, type CowMutationInput, type DrizzleRelation, type DurationInput, ENUM_BRAND, type EnumRef, type EtlSourceInput, type ForeignKeyInput, type FunctionRef, type IndexInput, LINK_BRAND, type LinkKind, type LoadNamespaceOptions, type LoadedNamespaceV2, type ManualSourceInput, NAMESPACE_CONFIG_BRAND, NAMESPACE_CONFIG_FILE, type NamespaceCapabilitiesInput, type NamespaceConfigInput, ORM_TO_PIPELINE_TYPE, type OrmContractColumnMap, type OrmContractPipelineColumn, type OrmSyncedTableContract, type OrmToPipelineType, type OverlayTableRef, type OverlayWinsUnionInput, type OverrideRowMutationInput, type PolicyInput, type PolicyVariantInput, type PolicyWithVariantsInput, type PrefetchSourceInput, type ReferentialAction, type RelationRef, type ResolvedSourceInput, type ResolvedTableConfig, type ResolvedTablePoliciesInput, type RevertOverlayMutationInput, SCHEMA_DIR, SYNCED_CONTRACT_HASH_DOMAIN, type SeqLink, type SeqNamespaceConfig, type SeqTable, type SeqView, type SerializeNamespaceInput, type SyncedTableConfig, type SyncedTablePoliciesInput, TABLE_BRAND, type TableConfig, type TablePoliciesInput, type TableRef, type ToManyOptions, type ToOneOptions, type ToPlatformUserOptions, type TypedSyncedTableConfig, VIEW_BRAND, type ViewConfig, type ViewPoliciesInput, type ViewQueryContext, type 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 };
+interface CatalogFolders {
+    [name: string]: CatalogFolders | null;
+}
+/** Presentation-only organization; never included in the canonical schema hash. */
+interface NamespaceCatalog {
+    folders: CatalogFolders;
+    objects: Record<string, string>;
+}
+declare function validateNamespaceCatalog(catalog: NamespaceCatalog, file?: string): void;
+
+export { type AuthoringContext, type AuthoringRegistration, COLUMN_BRAND, COLUMN_DEFAULT_FNS, type CatalogFolders, type CheckInput, ColumnBuilder, type ColumnDefaultFn, type ColumnDefaultLiteral, type ColumnTypeSpec, type Comparator, type CowMutationInput, type DrizzleRelation, type DurationInput, ENUM_BRAND, type EnumRef, type EtlSourceInput, type ExternalObjectRef, type ForeignKeyInput, type FunctionRef, type IndexInput, LINK_BRAND, type LinkKind, type LoadNamespaceOptions, type LoadedNamespaceV2, type ManualSourceInput, NAMESPACE_CONFIG_BRAND, NAMESPACE_CONFIG_FILE, type NamespaceCapabilitiesInput, type NamespaceCatalog, type NamespaceConfigInput, ORM_TO_PIPELINE_TYPE, type OrmContractColumnMap, type OrmContractPipelineColumn, type OrmSyncedTableContract, type OrmToPipelineType, type OverlayTableRef, type OverlayWinsUnionInput, type OverrideRowMutationInput, type PolicyInput, type PolicyVariantInput, type PolicyWithVariantsInput, type PrefetchSourceInput, type ReferentialAction, type RelationRef, type ResolvedSourceInput, type ResolvedTableConfig, type ResolvedTablePoliciesInput, type RevertOverlayMutationInput, SCHEMA_DIR, SYNCED_CONTRACT_HASH_DOMAIN, type SeqLink, type SeqNamespaceConfig, type SeqTable, type SeqView, type SerializeNamespaceInput, type SyncedTableConfig, type SyncedTablePoliciesInput, TABLE_BRAND, type TableConfig, type TablePoliciesInput, type TableRef, type ToManyOptions, type ToOneOptions, type ToPlatformUserOptions, type TypedSyncedTableConfig, VIEW_BRAND, type ViewConfig, type ViewPoliciesInput, type ViewQueryContext, type 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 };