metal-orm 1.0.16 → 1.0.17

package/dist/index.d.cts

@@ -1,12 +1,15 @@
-import { O as OperandNode, C as ColumnRef, a as ColumnNode, B as BinaryExpressionNode, E as ExpressionNode, L as LogicalExpressionNode, N as NullExpressionNode, b as LiteralNode, I as InExpressionNode, c as BetweenExpressionNode, J as JsonPathNode, d as CaseExpressionNode, S as SelectQueryNode, e as ExistsExpressionNode, W as WindowFunctionNode, f as OrderDirection, F as FunctionNode, g as ScalarSubqueryNode, h as ColumnDef, T as TableRef, i as TableDef, j as InsertQueryNode, k as InsertCompiler, l as CompiledQuery, D as Dialect, m as DialectKey, U as UpdateQueryNode, n as UpdateCompiler, o as DeleteQueryNode, p as DeleteCompiler, q as CompilerContext, r as ForeignKeyReference, s as IndexColumn, t as IndexDef, u as DbExecutor, H as HydrationPlan, v as NamingStrategy, R as RelationMap, w as EntityContext, x as Entity, y as HasManyRelation, z as HasOneRelation, A as BelongsToRelation, G as BelongsToManyRelation, K as HasManyCollection, M as BelongsToReference, P as ManyToManyCollection, Q as OrmSession, V as SelectQueryBuilder, X as ExecutionContext, Y as HydrationContext } from './select-BKZrMRCQ.cjs';
-export { a8 as CascadeMode, Z as CheckConstraint, ae as ColumnToTs, a1 as ColumnType, au as DbExecutorFactory, a4 as DefaultValue, ay as DomainEventBus, ax as DomainEventHandler, aA as EntityStatus, av as ExternalTransaction, aF as HasDomainEvents, ag as HasOneReference, aq as HydrationMetadata, ao as HydrationPivotPlan, ap as HydrationRelationPlan, af as InferRow, aw as Orm, ar as OrmInterceptor, at as OrmOptions, as as OrmSessionOptions, aG as QueryLogEntry, aH as QueryLogger, aJ as QueryResult, a3 as RawDefaultValue, a2 as ReferentialAction, aD as RelationChange, aE as RelationChangeEntry, a9 as RelationDef, aC as RelationKey, a6 as RelationKinds, a7 as RelationType, aL as SimpleQueryRunner, $ as TableHooks, _ as TableOptions, aB as TrackedEntity, az as addDomainEvent, ac as belongsTo, ad as belongsToMany, a5 as col, ah as createColumn, aM as createExecutorFromQueryRunner, ai as createLiteral, aI as createQueryLoggingExecutor, a0 as defineTable, aa as hasMany, ab as hasOne, al as isCaseExpressionNode, an as isExpressionSelectionNode, ak as isFunctionNode, aj as isOperandNode, am as isWindowFunctionNode, aK as rowsToQueryResult } from './select-BKZrMRCQ.cjs';
+import { L as LiteralNode, O as OperandNode, C as ColumnRef, a as ColumnNode, B as BinaryExpressionNode, E as ExpressionNode, b as LogicalExpressionNode, N as NullExpressionNode, I as InExpressionNode, c as BetweenExpressionNode, J as JsonPathNode, d as CaseExpressionNode, S as SelectQueryNode, e as ExistsExpressionNode, W as WindowFunctionNode, f as OrderDirection, F as FunctionNode, g as ScalarSubqueryNode, h as ColumnDef, T as TableRef, i as TableDef, j as InsertQueryNode, k as InsertCompiler, l as CompiledQuery, D as Dialect, m as DialectKey, U as UpdateQueryNode, n as UpdateCompiler, o as DeleteQueryNode, p as DeleteCompiler, q as CompilerContext, r as ForeignKeyReference, s as IndexColumn, t as IndexDef, u as DbExecutor, H as HydrationPlan, v as NamingStrategy, R as RelationMap, w as EntityContext, x as Entity, y as HasManyRelation, z as HasOneRelation, A as BelongsToRelation, G as BelongsToManyRelation, K as HasManyCollection, M as BelongsToReference, P as ManyToManyCollection, Q as OrmSession, V as SelectQueryBuilder, X as ExecutionContext, Y as HydrationContext } from './select-BPCn6MOH.cjs';
+export { aI as AnyDomainEvent, a8 as CascadeMode, Z as CheckConstraint, af as ColumnToTs, a1 as ColumnType, av as DbExecutorFactory, a4 as DefaultValue, aH as DomainEvent, aA as DomainEventBus, ay as DomainEventHandler, aC as EntityStatus, aw as ExternalTransaction, aK as HasDomainEvents, ah as HasOneReference, ar as HydrationMetadata, ap as HydrationPivotPlan, aq as HydrationRelationPlan, ag as InferRow, az as InitialHandlers, ax as Orm, aJ as OrmDomainEvent, as as OrmInterceptor, au as OrmOptions, at as OrmSessionOptions, aL as QueryLogEntry, aM as QueryLogger, aO as QueryResult, a3 as RawDefaultValue, a2 as ReferentialAction, aF as RelationChange, aG as RelationChangeEntry, a9 as RelationDef, aE as RelationKey, a6 as RelationKinds, ae as RelationTargetTable, a7 as RelationType, aQ as SimpleQueryRunner, $ as TableHooks, _ as TableOptions, aD as TrackedEntity, aB as addDomainEvent, ac as belongsTo, ad as belongsToMany, a5 as col, ai as createColumn, aR as createExecutorFromQueryRunner, aj as createLiteral, aN as createQueryLoggingExecutor, a0 as defineTable, aa as hasMany, ab as hasOne, am as isCaseExpressionNode, ao as isExpressionSelectionNode, al as isFunctionNode, ak as isOperandNode, an as isWindowFunctionNode, aP as rowsToQueryResult } from './select-BPCn6MOH.cjs';
 
+type LiteralValue = LiteralNode['value'];
+type ValueOperandInput = OperandNode | LiteralValue;
 /**
  * Converts a primitive or existing operand into an operand node
  * @param value - Value or operand to normalize
  * @returns OperandNode representing the value
  */
-declare const valueToOperand: (value: unknown) => OperandNode;
+declare const valueToOperand: (value: ValueOperandInput) => OperandNode;
+declare const isValueOperandInput: (value: unknown) => value is ValueOperandInput;
 declare const columnOperand: (col: ColumnRef | ColumnNode) => ColumnNode;
 /**
  * Creates an equality expression (left = right)
@@ -221,6 +224,30 @@ declare const sum: (col: ColumnRef | ColumnNode) => FunctionNode;
  * @returns Function node with AVG
  */
 declare const avg: (col: ColumnRef | ColumnNode) => FunctionNode;
+/**
+ * Creates a MIN function expression
+ * @param col - Column to take the minimum of
+ * @returns Function node with MIN
+ */
+declare const min: (col: ColumnRef | ColumnNode) => FunctionNode;
+/**
+ * Creates a MAX function expression
+ * @param col - Column to take the maximum of
+ * @returns Function node with MAX
+ */
+declare const max: (col: ColumnRef | ColumnNode) => FunctionNode;
+type GroupConcatOrderByInput = {
+    column: ColumnRef | ColumnNode;
+    direction?: OrderDirection;
+};
+type GroupConcatOptions = {
+    separator?: ValueOperandInput;
+    orderBy?: GroupConcatOrderByInput[];
+};
+/**
+ * Aggregates grouped strings into a single value.
+ */
+declare const groupConcat: (col: ColumnRef | ColumnNode, options?: GroupConcatOptions) => FunctionNode;
 
 /**
  * Visitor for expression nodes
@@ -286,6 +313,18 @@ declare const toColumnRef: (col: ColumnRef | ColumnDef) => ColumnRef;
  */
 declare const toTableRef: (table: TableRef | TableDef) => TableRef;
 
+/**
+ * Build a typed selection map from a TableDef.
+ */
+declare function sel<TTable extends TableDef, K extends keyof TTable['columns'] & string>(table: TTable, ...cols: K[]): Record<K, TTable['columns'][K]>;
+type Ctor<T> = {
+    new (...args: any[]): T;
+};
+/**
+ * Build a typed selection map from an entity constructor.
+ */
+declare function esel<TEntity, K extends keyof TEntity & string>(entity: Ctor<TEntity>, ...props: K[]): Record<K, ColumnDef>;
+
 /**
  * Maintains immutable state for building INSERT queries
  */
@@ -1181,12 +1220,22 @@ declare const loadHasOneRelation: (ctx: EntityContext, rootTable: TableDef, _rel
 declare const loadBelongsToRelation: (ctx: EntityContext, rootTable: TableDef, _relationName: string, relation: BelongsToRelation) => Promise<Map<string, Record<string, any>>>;
 declare const loadBelongsToManyRelation: (ctx: EntityContext, rootTable: TableDef, _relationName: string, relation: BelongsToManyRelation) => Promise<Map<string, Rows$3>>;
 
+/**
+ * Metadata stored on entity instances for ORM internal use
+ * @typeParam TTable - Table definition type
+ */
 interface EntityMeta<TTable extends TableDef> {
+    /** Entity context */
     ctx: EntityContext;
+    /** Table definition */
     table: TTable;
+    /** Relations that should be loaded lazily */
     lazyRelations: (keyof RelationMap<TTable>)[];
+    /** Cache for relation promises */
     relationCache: Map<string, Promise<any>>;
+    /** Hydration data for relations */
     relationHydration: Map<string, Map<string, any>>;
+    /** Relation wrapper instances */
     relationWrappers: Map<string, unknown>;
 }
 
@@ -1303,4 +1352,4 @@ interface MssqlClientLike {
 }
 declare function createMssqlExecutor(client: MssqlClientLike): DbExecutor;
 
-export { AsyncLocalStorage, BelongsToManyRelation, BelongsToReference, BelongsToRelation, BetweenExpressionNode, BinaryExpressionNode, CaseExpressionNode, ColumnDef, type ColumnDiff, ColumnNode, ColumnRef, type DatabaseCheck, type DatabaseColumn, type DatabaseIndex, type DatabaseSchema, type DatabaseTable, DbExecutor, DefaultBelongsToReference, DefaultHasManyCollection, DefaultManyToManyCollection, DeleteQueryBuilder, type DialectName, Entity, EntityContext, ExecutionContext, ExistsExpressionNode, ExpressionNode, type ExpressionVisitor, ForeignKeyReference, FunctionNode, HasManyCollection, HasManyRelation, HasOneRelation, HydrationContext, HydrationPlan, InExpressionNode, IndexColumn, IndexDef, InsertQueryBuilder, type IntrospectOptions, JsonPathNode, LiteralNode, LogicalExpressionNode, ManyToManyCollection, type MssqlClientLike, MySqlDialect, type MysqlClientLike, NullExpressionNode, OperandNode, type OperandVisitor, OrmSession, type PostgresClientLike, PostgresDialect, RelationMap, type RenderColumnOptions, ScalarSubqueryNode, type SchemaChange, type SchemaChangeKind, type SchemaDiffOptions, type SchemaGenerateResult, type SchemaIntrospector, type SchemaPlan, SelectQueryBuilder, SqlServerDialect, type SqliteClientLike, SqliteDialect, type SynchronizeOptions, TableDef, TableRef, TypeScriptGenerator, UpdateQueryBuilder, WindowFunctionNode, abs, acos, and, ascii, asin, atan, atan2, avg, between, caseWhen, ceil, ceiling, char, charLength, clearExpressionDispatchers, clearOperandDispatchers, columnOperand, concat, concatWs, cos, cot, count, createEntityFromRow, createEntityProxy, createMssqlExecutor, createMysqlExecutor, createPostgresExecutor, createSqliteExecutor, currentDate, currentTime, dateAdd, dateDiff, dateFormat, dateSub, dateTrunc, day, dayOfWeek, degrees, denseRank, diffSchema, endOfMonth, eq, executeHydrated, executeHydratedWithContexts, exists, exp, extract, firstValue, floor, fromUnixTime, generateCreateTableSql, generateSchemaSql, getSchemaIntrospector, gt, gte, hydrateRows, inList, instr, introspectSchema, isNotNull, isNull, jsonPath, lag, lastValue, lead, left, length, like, ln, loadBelongsToManyRelation, loadBelongsToRelation, loadHasManyRelation, loadHasOneRelation, locate, log, log10, logBase, lower, lpad, lt, lte, ltrim, mod, month, neq, notBetween, notExists, notInList, notLike, now, ntile, or, pi, position, pow, power, radians, rand, random, rank, registerExpressionDispatcher, registerOperandDispatcher, registerSchemaIntrospector, renderColumnDefinition, repeat, replace, right, round, rowNumber, rpad, rtrim, sign, sin, space, sqrt, substr, sum, synchronizeSchema, tan, toColumnRef, toTableRef, trim, trunc, truncate, unixTimestamp, upper, utcNow, valueToOperand, visitExpression, visitOperand, weekOfYear, windowFunction, year };
+export { AsyncLocalStorage, BelongsToManyRelation, BelongsToReference, BelongsToRelation, BetweenExpressionNode, BinaryExpressionNode, CaseExpressionNode, ColumnDef, type ColumnDiff, ColumnNode, ColumnRef, type DatabaseCheck, type DatabaseColumn, type DatabaseIndex, type DatabaseSchema, type DatabaseTable, DbExecutor, DefaultBelongsToReference, DefaultHasManyCollection, DefaultManyToManyCollection, DeleteQueryBuilder, type DialectName, Entity, EntityContext, ExecutionContext, ExistsExpressionNode, ExpressionNode, type ExpressionVisitor, ForeignKeyReference, FunctionNode, type GroupConcatOptions, HasManyCollection, HasManyRelation, HasOneRelation, HydrationContext, HydrationPlan, InExpressionNode, IndexColumn, IndexDef, InsertQueryBuilder, type IntrospectOptions, JsonPathNode, LiteralNode, type LiteralValue, LogicalExpressionNode, ManyToManyCollection, type MssqlClientLike, MySqlDialect, type MysqlClientLike, NullExpressionNode, OperandNode, type OperandVisitor, OrmSession, type PostgresClientLike, PostgresDialect, RelationMap, type RenderColumnOptions, ScalarSubqueryNode, type SchemaChange, type SchemaChangeKind, type SchemaDiffOptions, type SchemaGenerateResult, type SchemaIntrospector, type SchemaPlan, SelectQueryBuilder, SqlServerDialect, type SqliteClientLike, SqliteDialect, type SynchronizeOptions, TableDef, TableRef, TypeScriptGenerator, UpdateQueryBuilder, type ValueOperandInput, WindowFunctionNode, abs, acos, and, ascii, asin, atan, atan2, avg, between, caseWhen, ceil, ceiling, char, charLength, clearExpressionDispatchers, clearOperandDispatchers, columnOperand, concat, concatWs, cos, cot, count, createEntityFromRow, createEntityProxy, createMssqlExecutor, createMysqlExecutor, createPostgresExecutor, createSqliteExecutor, currentDate, currentTime, dateAdd, dateDiff, dateFormat, dateSub, dateTrunc, day, dayOfWeek, degrees, denseRank, diffSchema, endOfMonth, eq, esel, executeHydrated, executeHydratedWithContexts, exists, exp, extract, firstValue, floor, fromUnixTime, generateCreateTableSql, generateSchemaSql, getSchemaIntrospector, groupConcat, gt, gte, hydrateRows, inList, instr, introspectSchema, isNotNull, isNull, isValueOperandInput, jsonPath, lag, lastValue, lead, left, length, like, ln, loadBelongsToManyRelation, loadBelongsToRelation, loadHasManyRelation, loadHasOneRelation, locate, log, log10, logBase, lower, lpad, lt, lte, ltrim, max, min, mod, month, neq, notBetween, notExists, notInList, notLike, now, ntile, or, pi, position, pow, power, radians, rand, random, rank, registerExpressionDispatcher, registerOperandDispatcher, registerSchemaIntrospector, renderColumnDefinition, repeat, replace, right, round, rowNumber, rpad, rtrim, sel, sign, sin, space, sqrt, substr, sum, synchronizeSchema, tan, toColumnRef, toTableRef, trim, trunc, truncate, unixTimestamp, upper, utcNow, valueToOperand, visitExpression, visitOperand, weekOfYear, windowFunction, year };

package/dist/index.d.ts

@@ -1,12 +1,15 @@
-import { O as OperandNode, C as ColumnRef, a as ColumnNode, B as BinaryExpressionNode, E as ExpressionNode, L as LogicalExpressionNode, N as NullExpressionNode, b as LiteralNode, I as InExpressionNode, c as BetweenExpressionNode, J as JsonPathNode, d as CaseExpressionNode, S as SelectQueryNode, e as ExistsExpressionNode, W as WindowFunctionNode, f as OrderDirection, F as FunctionNode, g as ScalarSubqueryNode, h as ColumnDef, T as TableRef, i as TableDef, j as InsertQueryNode, k as InsertCompiler, l as CompiledQuery, D as Dialect, m as DialectKey, U as UpdateQueryNode, n as UpdateCompiler, o as DeleteQueryNode, p as DeleteCompiler, q as CompilerContext, r as ForeignKeyReference, s as IndexColumn, t as IndexDef, u as DbExecutor, H as HydrationPlan, v as NamingStrategy, R as RelationMap, w as EntityContext, x as Entity, y as HasManyRelation, z as HasOneRelation, A as BelongsToRelation, G as BelongsToManyRelation, K as HasManyCollection, M as BelongsToReference, P as ManyToManyCollection, Q as OrmSession, V as SelectQueryBuilder, X as ExecutionContext, Y as HydrationContext } from './select-BKZrMRCQ.js';
-export { a8 as CascadeMode, Z as CheckConstraint, ae as ColumnToTs, a1 as ColumnType, au as DbExecutorFactory, a4 as DefaultValue, ay as DomainEventBus, ax as DomainEventHandler, aA as EntityStatus, av as ExternalTransaction, aF as HasDomainEvents, ag as HasOneReference, aq as HydrationMetadata, ao as HydrationPivotPlan, ap as HydrationRelationPlan, af as InferRow, aw as Orm, ar as OrmInterceptor, at as OrmOptions, as as OrmSessionOptions, aG as QueryLogEntry, aH as QueryLogger, aJ as QueryResult, a3 as RawDefaultValue, a2 as ReferentialAction, aD as RelationChange, aE as RelationChangeEntry, a9 as RelationDef, aC as RelationKey, a6 as RelationKinds, a7 as RelationType, aL as SimpleQueryRunner, $ as TableHooks, _ as TableOptions, aB as TrackedEntity, az as addDomainEvent, ac as belongsTo, ad as belongsToMany, a5 as col, ah as createColumn, aM as createExecutorFromQueryRunner, ai as createLiteral, aI as createQueryLoggingExecutor, a0 as defineTable, aa as hasMany, ab as hasOne, al as isCaseExpressionNode, an as isExpressionSelectionNode, ak as isFunctionNode, aj as isOperandNode, am as isWindowFunctionNode, aK as rowsToQueryResult } from './select-BKZrMRCQ.js';
+import { L as LiteralNode, O as OperandNode, C as ColumnRef, a as ColumnNode, B as BinaryExpressionNode, E as ExpressionNode, b as LogicalExpressionNode, N as NullExpressionNode, I as InExpressionNode, c as BetweenExpressionNode, J as JsonPathNode, d as CaseExpressionNode, S as SelectQueryNode, e as ExistsExpressionNode, W as WindowFunctionNode, f as OrderDirection, F as FunctionNode, g as ScalarSubqueryNode, h as ColumnDef, T as TableRef, i as TableDef, j as InsertQueryNode, k as InsertCompiler, l as CompiledQuery, D as Dialect, m as DialectKey, U as UpdateQueryNode, n as UpdateCompiler, o as DeleteQueryNode, p as DeleteCompiler, q as CompilerContext, r as ForeignKeyReference, s as IndexColumn, t as IndexDef, u as DbExecutor, H as HydrationPlan, v as NamingStrategy, R as RelationMap, w as EntityContext, x as Entity, y as HasManyRelation, z as HasOneRelation, A as BelongsToRelation, G as BelongsToManyRelation, K as HasManyCollection, M as BelongsToReference, P as ManyToManyCollection, Q as OrmSession, V as SelectQueryBuilder, X as ExecutionContext, Y as HydrationContext } from './select-BPCn6MOH.js';
+export { aI as AnyDomainEvent, a8 as CascadeMode, Z as CheckConstraint, af as ColumnToTs, a1 as ColumnType, av as DbExecutorFactory, a4 as DefaultValue, aH as DomainEvent, aA as DomainEventBus, ay as DomainEventHandler, aC as EntityStatus, aw as ExternalTransaction, aK as HasDomainEvents, ah as HasOneReference, ar as HydrationMetadata, ap as HydrationPivotPlan, aq as HydrationRelationPlan, ag as InferRow, az as InitialHandlers, ax as Orm, aJ as OrmDomainEvent, as as OrmInterceptor, au as OrmOptions, at as OrmSessionOptions, aL as QueryLogEntry, aM as QueryLogger, aO as QueryResult, a3 as RawDefaultValue, a2 as ReferentialAction, aF as RelationChange, aG as RelationChangeEntry, a9 as RelationDef, aE as RelationKey, a6 as RelationKinds, ae as RelationTargetTable, a7 as RelationType, aQ as SimpleQueryRunner, $ as TableHooks, _ as TableOptions, aD as TrackedEntity, aB as addDomainEvent, ac as belongsTo, ad as belongsToMany, a5 as col, ai as createColumn, aR as createExecutorFromQueryRunner, aj as createLiteral, aN as createQueryLoggingExecutor, a0 as defineTable, aa as hasMany, ab as hasOne, am as isCaseExpressionNode, ao as isExpressionSelectionNode, al as isFunctionNode, ak as isOperandNode, an as isWindowFunctionNode, aP as rowsToQueryResult } from './select-BPCn6MOH.js';
 
+type LiteralValue = LiteralNode['value'];
+type ValueOperandInput = OperandNode | LiteralValue;
 /**
  * Converts a primitive or existing operand into an operand node
  * @param value - Value or operand to normalize
  * @returns OperandNode representing the value
  */
-declare const valueToOperand: (value: unknown) => OperandNode;
+declare const valueToOperand: (value: ValueOperandInput) => OperandNode;
+declare const isValueOperandInput: (value: unknown) => value is ValueOperandInput;
 declare const columnOperand: (col: ColumnRef | ColumnNode) => ColumnNode;
 /**
  * Creates an equality expression (left = right)
@@ -221,6 +224,30 @@ declare const sum: (col: ColumnRef | ColumnNode) => FunctionNode;
  * @returns Function node with AVG
  */
 declare const avg: (col: ColumnRef | ColumnNode) => FunctionNode;
+/**
+ * Creates a MIN function expression
+ * @param col - Column to take the minimum of
+ * @returns Function node with MIN
+ */
+declare const min: (col: ColumnRef | ColumnNode) => FunctionNode;
+/**
+ * Creates a MAX function expression
+ * @param col - Column to take the maximum of
+ * @returns Function node with MAX
+ */
+declare const max: (col: ColumnRef | ColumnNode) => FunctionNode;
+type GroupConcatOrderByInput = {
+    column: ColumnRef | ColumnNode;
+    direction?: OrderDirection;
+};
+type GroupConcatOptions = {
+    separator?: ValueOperandInput;
+    orderBy?: GroupConcatOrderByInput[];
+};
+/**
+ * Aggregates grouped strings into a single value.
+ */
+declare const groupConcat: (col: ColumnRef | ColumnNode, options?: GroupConcatOptions) => FunctionNode;
 
 /**
  * Visitor for expression nodes
@@ -286,6 +313,18 @@ declare const toColumnRef: (col: ColumnRef | ColumnDef) => ColumnRef;
  */
 declare const toTableRef: (table: TableRef | TableDef) => TableRef;
 
+/**
+ * Build a typed selection map from a TableDef.
+ */
+declare function sel<TTable extends TableDef, K extends keyof TTable['columns'] & string>(table: TTable, ...cols: K[]): Record<K, TTable['columns'][K]>;
+type Ctor<T> = {
+    new (...args: any[]): T;
+};
+/**
+ * Build a typed selection map from an entity constructor.
+ */
+declare function esel<TEntity, K extends keyof TEntity & string>(entity: Ctor<TEntity>, ...props: K[]): Record<K, ColumnDef>;
+
 /**
  * Maintains immutable state for building INSERT queries
  */
@@ -1181,12 +1220,22 @@ declare const loadHasOneRelation: (ctx: EntityContext, rootTable: TableDef, _rel
 declare const loadBelongsToRelation: (ctx: EntityContext, rootTable: TableDef, _relationName: string, relation: BelongsToRelation) => Promise<Map<string, Record<string, any>>>;
 declare const loadBelongsToManyRelation: (ctx: EntityContext, rootTable: TableDef, _relationName: string, relation: BelongsToManyRelation) => Promise<Map<string, Rows$3>>;
 
+/**
+ * Metadata stored on entity instances for ORM internal use
+ * @typeParam TTable - Table definition type
+ */
 interface EntityMeta<TTable extends TableDef> {
+    /** Entity context */
     ctx: EntityContext;
+    /** Table definition */
     table: TTable;
+    /** Relations that should be loaded lazily */
     lazyRelations: (keyof RelationMap<TTable>)[];
+    /** Cache for relation promises */
     relationCache: Map<string, Promise<any>>;
+    /** Hydration data for relations */
     relationHydration: Map<string, Map<string, any>>;
+    /** Relation wrapper instances */
     relationWrappers: Map<string, unknown>;
 }
 
@@ -1303,4 +1352,4 @@ interface MssqlClientLike {
 }
 declare function createMssqlExecutor(client: MssqlClientLike): DbExecutor;
 
-export { AsyncLocalStorage, BelongsToManyRelation, BelongsToReference, BelongsToRelation, BetweenExpressionNode, BinaryExpressionNode, CaseExpressionNode, ColumnDef, type ColumnDiff, ColumnNode, ColumnRef, type DatabaseCheck, type DatabaseColumn, type DatabaseIndex, type DatabaseSchema, type DatabaseTable, DbExecutor, DefaultBelongsToReference, DefaultHasManyCollection, DefaultManyToManyCollection, DeleteQueryBuilder, type DialectName, Entity, EntityContext, ExecutionContext, ExistsExpressionNode, ExpressionNode, type ExpressionVisitor, ForeignKeyReference, FunctionNode, HasManyCollection, HasManyRelation, HasOneRelation, HydrationContext, HydrationPlan, InExpressionNode, IndexColumn, IndexDef, InsertQueryBuilder, type IntrospectOptions, JsonPathNode, LiteralNode, LogicalExpressionNode, ManyToManyCollection, type MssqlClientLike, MySqlDialect, type MysqlClientLike, NullExpressionNode, OperandNode, type OperandVisitor, OrmSession, type PostgresClientLike, PostgresDialect, RelationMap, type RenderColumnOptions, ScalarSubqueryNode, type SchemaChange, type SchemaChangeKind, type SchemaDiffOptions, type SchemaGenerateResult, type SchemaIntrospector, type SchemaPlan, SelectQueryBuilder, SqlServerDialect, type SqliteClientLike, SqliteDialect, type SynchronizeOptions, TableDef, TableRef, TypeScriptGenerator, UpdateQueryBuilder, WindowFunctionNode, abs, acos, and, ascii, asin, atan, atan2, avg, between, caseWhen, ceil, ceiling, char, charLength, clearExpressionDispatchers, clearOperandDispatchers, columnOperand, concat, concatWs, cos, cot, count, createEntityFromRow, createEntityProxy, createMssqlExecutor, createMysqlExecutor, createPostgresExecutor, createSqliteExecutor, currentDate, currentTime, dateAdd, dateDiff, dateFormat, dateSub, dateTrunc, day, dayOfWeek, degrees, denseRank, diffSchema, endOfMonth, eq, executeHydrated, executeHydratedWithContexts, exists, exp, extract, firstValue, floor, fromUnixTime, generateCreateTableSql, generateSchemaSql, getSchemaIntrospector, gt, gte, hydrateRows, inList, instr, introspectSchema, isNotNull, isNull, jsonPath, lag, lastValue, lead, left, length, like, ln, loadBelongsToManyRelation, loadBelongsToRelation, loadHasManyRelation, loadHasOneRelation, locate, log, log10, logBase, lower, lpad, lt, lte, ltrim, mod, month, neq, notBetween, notExists, notInList, notLike, now, ntile, or, pi, position, pow, power, radians, rand, random, rank, registerExpressionDispatcher, registerOperandDispatcher, registerSchemaIntrospector, renderColumnDefinition, repeat, replace, right, round, rowNumber, rpad, rtrim, sign, sin, space, sqrt, substr, sum, synchronizeSchema, tan, toColumnRef, toTableRef, trim, trunc, truncate, unixTimestamp, upper, utcNow, valueToOperand, visitExpression, visitOperand, weekOfYear, windowFunction, year };
+export { AsyncLocalStorage, BelongsToManyRelation, BelongsToReference, BelongsToRelation, BetweenExpressionNode, BinaryExpressionNode, CaseExpressionNode, ColumnDef, type ColumnDiff, ColumnNode, ColumnRef, type DatabaseCheck, type DatabaseColumn, type DatabaseIndex, type DatabaseSchema, type DatabaseTable, DbExecutor, DefaultBelongsToReference, DefaultHasManyCollection, DefaultManyToManyCollection, DeleteQueryBuilder, type DialectName, Entity, EntityContext, ExecutionContext, ExistsExpressionNode, ExpressionNode, type ExpressionVisitor, ForeignKeyReference, FunctionNode, type GroupConcatOptions, HasManyCollection, HasManyRelation, HasOneRelation, HydrationContext, HydrationPlan, InExpressionNode, IndexColumn, IndexDef, InsertQueryBuilder, type IntrospectOptions, JsonPathNode, LiteralNode, type LiteralValue, LogicalExpressionNode, ManyToManyCollection, type MssqlClientLike, MySqlDialect, type MysqlClientLike, NullExpressionNode, OperandNode, type OperandVisitor, OrmSession, type PostgresClientLike, PostgresDialect, RelationMap, type RenderColumnOptions, ScalarSubqueryNode, type SchemaChange, type SchemaChangeKind, type SchemaDiffOptions, type SchemaGenerateResult, type SchemaIntrospector, type SchemaPlan, SelectQueryBuilder, SqlServerDialect, type SqliteClientLike, SqliteDialect, type SynchronizeOptions, TableDef, TableRef, TypeScriptGenerator, UpdateQueryBuilder, type ValueOperandInput, WindowFunctionNode, abs, acos, and, ascii, asin, atan, atan2, avg, between, caseWhen, ceil, ceiling, char, charLength, clearExpressionDispatchers, clearOperandDispatchers, columnOperand, concat, concatWs, cos, cot, count, createEntityFromRow, createEntityProxy, createMssqlExecutor, createMysqlExecutor, createPostgresExecutor, createSqliteExecutor, currentDate, currentTime, dateAdd, dateDiff, dateFormat, dateSub, dateTrunc, day, dayOfWeek, degrees, denseRank, diffSchema, endOfMonth, eq, esel, executeHydrated, executeHydratedWithContexts, exists, exp, extract, firstValue, floor, fromUnixTime, generateCreateTableSql, generateSchemaSql, getSchemaIntrospector, groupConcat, gt, gte, hydrateRows, inList, instr, introspectSchema, isNotNull, isNull, isValueOperandInput, jsonPath, lag, lastValue, lead, left, length, like, ln, loadBelongsToManyRelation, loadBelongsToRelation, loadHasManyRelation, loadHasOneRelation, locate, log, log10, logBase, lower, lpad, lt, lte, ltrim, max, min, mod, month, neq, notBetween, notExists, notInList, notLike, now, ntile, or, pi, position, pow, power, radians, rand, random, rank, registerExpressionDispatcher, registerOperandDispatcher, registerSchemaIntrospector, renderColumnDefinition, repeat, replace, right, round, rowNumber, rpad, rtrim, sel, sign, sin, space, sqrt, substr, sum, synchronizeSchema, tan, toColumnRef, toTableRef, trim, trunc, truncate, unixTimestamp, upper, utcNow, valueToOperand, visitExpression, visitOperand, weekOfYear, windowFunction, year };