metal-orm 1.0.64 → 1.0.66

package/dist/index.d.ts

@@ -343,19 +343,19 @@ interface TableOptions {
     charset?: string;
     collation?: string;
 }
-interface TableHooks {
-    beforeInsert?(ctx: unknown, entity: unknown): Promise<void> | void;
-    afterInsert?(ctx: unknown, entity: unknown): Promise<void> | void;
-    beforeUpdate?(ctx: unknown, entity: unknown): Promise<void> | void;
-    afterUpdate?(ctx: unknown, entity: unknown): Promise<void> | void;
-    beforeDelete?(ctx: unknown, entity: unknown): Promise<void> | void;
-    afterDelete?(ctx: unknown, entity: unknown): Promise<void> | void;
+interface TableHooks<TEntity = unknown, TContext = unknown> {
+    beforeInsert?(ctx: TContext, entity: TEntity): Promise<void> | void;
+    afterInsert?(ctx: TContext, entity: TEntity): Promise<void> | void;
+    beforeUpdate?(ctx: TContext, entity: TEntity): Promise<void> | void;
+    afterUpdate?(ctx: TContext, entity: TEntity): Promise<void> | void;
+    beforeDelete?(ctx: TContext, entity: TEntity): Promise<void> | void;
+    afterDelete?(ctx: TContext, entity: TEntity): Promise<void> | void;
 }
 /**
  * Definition of a database table with its columns and relationships
  * @typeParam T - Type of the columns record
  */
-interface TableDef<T extends Record<string, ColumnDef> = Record<string, ColumnDef>> {
+interface TableDef<T extends Record<string, ColumnDef> = Record<string, ColumnDef>, TEntity = unknown, TContext = unknown> {
     /** Name of the table */
     name: string;
     /** Optional schema/catalog name */
@@ -365,7 +365,7 @@ interface TableDef<T extends Record<string, ColumnDef> = Record<string, ColumnDe
     /** Record of relationship definitions keyed by relation name */
     relations: Record<string, RelationDef>;
     /** Optional lifecycle hooks */
-    hooks?: TableHooks;
+    hooks?: TableHooks<TEntity, TContext>;
     /** Composite primary key definition (falls back to column.primary flags) */
     primaryKey?: string[];
     /** Secondary indexes */
@@ -396,7 +396,7 @@ interface TableDef<T extends Record<string, ColumnDef> = Record<string, ColumnDe
  * });
  * ```
  */
-declare const defineTable: <T extends Record<string, ColumnDef>>(name: string, columns: T, relations?: Record<string, RelationDef>, hooks?: TableHooks, options?: TableOptions) => TableDef<T>;
+declare const defineTable: <T extends Record<string, ColumnDef>, TEntity = unknown, TContext = unknown>(name: string, columns: T, relations?: Record<string, RelationDef>, hooks?: TableHooks<TEntity, TContext>, options?: TableOptions) => TableDef<T, TEntity, TContext>;
 /**
  * Assigns relations to a table definition while preserving literal typing.
  */
@@ -458,8 +458,8 @@ type ColumnToTs<T extends ColumnDef> = [
 type InferRow<TTable extends TableDef> = {
     [K in keyof TTable['columns']]: ColumnToTs<TTable['columns'][K]>;
 };
-type RelationResult$1<T extends RelationDef> = T extends HasManyRelation<infer TTarget> ? InferRow<TTarget>[] : T extends HasOneRelation<infer TTarget> ? InferRow<TTarget> | null : T extends BelongsToRelation<infer TTarget> ? InferRow<TTarget> | null : T extends BelongsToManyRelation<infer TTarget, TableDef> ? (InferRow<TTarget> & {
-    _pivot?: Record<string, unknown>;
+type RelationResult$1<T extends RelationDef> = T extends HasManyRelation<infer TTarget> ? InferRow<TTarget>[] : T extends HasOneRelation<infer TTarget> ? InferRow<TTarget> | null : T extends BelongsToRelation<infer TTarget> ? InferRow<TTarget> | null : T extends BelongsToManyRelation<infer TTarget, infer TPivot> ? (InferRow<TTarget> & {
+    _pivot?: InferRow<TPivot>;
 })[] : never;
 /**
  * Maps relation names to the expected row results
@@ -467,10 +467,10 @@ type RelationResult$1<T extends RelationDef> = T extends HasManyRelation<infer T
 type RelationMap<TTable extends TableDef> = {
     [K in keyof TTable['relations']]: RelationResult$1<TTable['relations'][K]>;
 };
-type RelationWrapper$1<TRel extends RelationDef> = TRel extends HasManyRelation<infer TTarget> ? HasManyCollection<EntityInstance<TTarget>> & ReadonlyArray<EntityInstance<TTarget>> : TRel extends HasOneRelation<infer TTarget> ? HasOneReference<EntityInstance<TTarget>> : TRel extends BelongsToManyRelation<infer TTarget> ? ManyToManyCollection<EntityInstance<TTarget> & {
-    _pivot?: Record<string, unknown>;
+type RelationWrapper$1<TRel extends RelationDef> = TRel extends HasManyRelation<infer TTarget> ? HasManyCollection<EntityInstance<TTarget>> & ReadonlyArray<EntityInstance<TTarget>> : TRel extends HasOneRelation<infer TTarget> ? HasOneReference<EntityInstance<TTarget>> : TRel extends BelongsToManyRelation<infer TTarget, infer TPivot> ? ManyToManyCollection<EntityInstance<TTarget> & {
+    _pivot?: InferRow<TPivot>;
 }> & ReadonlyArray<EntityInstance<TTarget> & {
-    _pivot?: Record<string, unknown>;
+    _pivot?: InferRow<TPivot>;
 }> : TRel extends BelongsToRelation<infer TTarget> ? BelongsToReference<EntityInstance<TTarget>> : never;
 interface HasManyCollection<TChild> {
     length: number;
@@ -1320,7 +1320,7 @@ declare const ntile: (n: number) => TypedExpression<number>;
  * @param defaultValue - Optional default value.
  * @returns A `TypedExpression<T>` representing the `LAG` window function.
  */
-declare const lag: <T = any>(col: ColumnRef | ColumnNode, offset?: number, defaultValue?: LiteralNode["value"]) => TypedExpression<T>;
+declare const lag: <T = unknown>(col: ColumnRef | ColumnNode, offset?: number, defaultValue?: LiteralNode["value"]) => TypedExpression<T>;
 /**
  * Creates a LEAD window function.
  *
@@ -1329,21 +1329,21 @@ declare const lag: <T = any>(col: ColumnRef | ColumnNode, offset?: number, defau
  * @param defaultValue - Optional default value.
  * @returns A `TypedExpression<T>` representing the `LEAD` window function.
  */
-declare const lead: <T = any>(col: ColumnRef | ColumnNode, offset?: number, defaultValue?: LiteralNode["value"]) => TypedExpression<T>;
+declare const lead: <T = unknown>(col: ColumnRef | ColumnNode, offset?: number, defaultValue?: LiteralNode["value"]) => TypedExpression<T>;
 /**
  * Creates a FIRST_VALUE window function.
  *
  * @param col - Column or expression to get first value from.
  * @returns A `TypedExpression<T>` representing the `FIRST_VALUE` window function.
  */
-declare const firstValue: <T = any>(col: ColumnRef | ColumnNode) => TypedExpression<T>;
+declare const firstValue: <T = unknown>(col: ColumnRef | ColumnNode) => TypedExpression<T>;
 /**
  * Creates a LAST_VALUE window function.
  *
  * @param col - Column or expression to get last value from.
  * @returns A `TypedExpression<T>` representing the `LAST_VALUE` window function.
  */
-declare const lastValue: <T = any>(col: ColumnRef | ColumnNode) => TypedExpression<T>;
+declare const lastValue: <T = unknown>(col: ColumnRef | ColumnNode) => TypedExpression<T>;
 /**
  * Creates a custom window function.
  *
@@ -1353,7 +1353,7 @@ declare const lastValue: <T = any>(col: ColumnRef | ColumnNode) => TypedExpressi
  * @param orderBy - Optional ORDER BY clauses.
  * @returns A `TypedExpression<T>` representing the window function.
  */
-declare const windowFunction: <T = any>(name: string, args?: (ColumnRef | ColumnNode | LiteralNode | JsonPathNode)[], partitionBy?: (ColumnRef | ColumnNode)[], orderBy?: {
+declare const windowFunction: <T = unknown>(name: string, args?: (ColumnRef | ColumnNode | LiteralNode | JsonPathNode)[], partitionBy?: (ColumnRef | ColumnNode)[], orderBy?: {
     column: ColumnRef | ColumnNode;
     direction: OrderDirection;
 }[]) => TypedExpression<T>;
@@ -2811,7 +2811,7 @@ interface TrackedEntity {
     /** The table definition this entity belongs to */
     table: TableDef;
     /** The actual entity instance */
-    entity: unknown;
+    entity: object;
     /** Primary key value of the entity */
     pk: string | number | null;
     /** Current status of the entity */
@@ -2986,6 +2986,71 @@ declare class Orm<E extends DomainEvent = OrmDomainEvent> {
     dispose(): Promise<void>;
 }
 
+type PrimaryKey$1 = string | number;
+/**
+ * Interface for entity context providing entity tracking and management.
+ */
+interface EntityContext {
+    /** The database dialect */
+    dialect: Dialect;
+    /** The database executor */
+    executor: DbExecutor;
+    /**
+     * Gets an entity by table and primary key.
+     * @param table - The table definition
+     * @param pk - The primary key value
+     * @returns The entity or undefined
+     */
+    getEntity(table: TableDef, pk: PrimaryKey$1): object | undefined;
+    /**
+     * Sets an entity in the context.
+     * @param table - The table definition
+     * @param pk - The primary key value
+     * @param entity - The entity to set
+     */
+    setEntity(table: TableDef, pk: PrimaryKey$1, entity: object): void;
+    /**
+     * Tracks a new entity.
+     * @param table - The table definition
+     * @param entity - The new entity
+     * @param pk - Optional primary key
+     */
+    trackNew(table: TableDef, entity: object, pk?: PrimaryKey$1): void;
+    /**
+     * Tracks a managed entity.
+     * @param table - The table definition
+     * @param pk - The primary key
+     * @param entity - The managed entity
+     */
+    trackManaged(table: TableDef, pk: PrimaryKey$1, entity: object): void;
+    /**
+     * Marks an entity as dirty.
+     * @param entity - The entity to mark
+     */
+    markDirty(entity: object): void;
+    /**
+     * Marks an entity as removed.
+     * @param entity - The entity to mark
+     */
+    markRemoved(entity: object): void;
+    /**
+     * Gets all tracked entities for a table.
+     * @param table - The table definition
+     * @returns Array of tracked entities
+     */
+    getEntitiesForTable(table: TableDef): TrackedEntity[];
+    /**
+     * Registers a relation change.
+     * @param root - The root entity
+     * @param relationKey - The relation key
+     * @param rootTable - The root table definition
+     * @param relationName - The relation name
+     * @param relation - The relation definition
+     * @param change - The relation change
+     */
+    registerRelationChange(root: unknown, relationKey: RelationKey$1, rootTable: TableDef, relationName: string, relation: RelationDef, change: RelationChange<unknown>): void;
+}
+
 /**
  * Simple identity map for tracking entities within a session.
  * Ensures that the same database record is represented by a single entity instance.
@@ -2999,7 +3064,7 @@ declare class IdentityMap {
      * @param pk The primary key value.
      * @returns The entity instance if found, undefined otherwise.
      */
-    getEntity(table: TableDef, pk: string | number): unknown | undefined;
+    getEntity(table: TableDef, pk: PrimaryKey$1): object | undefined;
     /**
      * Registers a tracked entity in the identity map.
      * @param tracked The tracked entity metadata and instance.
@@ -3048,7 +3113,7 @@ declare class UnitOfWork {
      * @param pk - The primary key value
      * @returns The entity or undefined if not found
      */
-    getEntity(table: TableDef, pk: string | number): unknown | undefined;
+    getEntity(table: TableDef, pk: PrimaryKey$1): object | undefined;
     /**
      * Gets all tracked entities for a specific table.
      * @param table - The table definition
@@ -3060,38 +3125,38 @@ declare class UnitOfWork {
      * @param entity - The entity to find
      * @returns The tracked entity or undefined if not found
      */
-    findTracked(entity: unknown): TrackedEntity | undefined;
+    findTracked(entity: object): TrackedEntity | undefined;
     /**
      * Sets an entity in the identity map.
      * @param table - The table definition
      * @param pk - The primary key value
      * @param entity - The entity instance
      */
-    setEntity(table: TableDef, pk: string | number, entity: unknown): void;
+    setEntity(table: TableDef, pk: PrimaryKey$1, entity: object): void;
     /**
      * Tracks a new entity.
      * @param table - The table definition
      * @param entity - The entity instance
      * @param pk - Optional primary key value
      */
-    trackNew(table: TableDef, entity: unknown, pk?: string | number): void;
+    trackNew(table: TableDef, entity: object, pk?: PrimaryKey$1): void;
     /**
      * Tracks a managed entity.
      * @param table - The table definition
      * @param pk - The primary key value
      * @param entity - The entity instance
      */
-    trackManaged(table: TableDef, pk: string | number, entity: unknown): void;
+    trackManaged(table: TableDef, pk: PrimaryKey$1, entity: object): void;
     /**
      * Marks an entity as dirty (modified).
      * @param entity - The entity to mark as dirty
      */
-    markDirty(entity: unknown): void;
+    markDirty(entity: object): void;
     /**
      * Marks an entity as removed.
      * @param entity - The entity to mark as removed
      */
-    markRemoved(entity: unknown): void;
+    markRemoved(entity: object): void;
     /**
      * Flushes pending changes to the database.
      */
@@ -3374,70 +3439,6 @@ interface ExecutionContext {
     interceptors: InterceptorPipeline;
 }
 
-/**
- * Interface for entity context providing entity tracking and management.
- */
-interface EntityContext {
-    /** The database dialect */
-    dialect: Dialect;
-    /** The database executor */
-    executor: DbExecutor;
-    /**
-     * Gets an entity by table and primary key.
-     * @param table - The table definition
-     * @param pk - The primary key value
-     * @returns The entity or undefined
-     */
-    getEntity(table: TableDef, pk: unknown): unknown;
-    /**
-     * Sets an entity in the context.
-     * @param table - The table definition
-     * @param pk - The primary key value
-     * @param entity - The entity to set
-     */
-    setEntity(table: TableDef, pk: unknown, entity: unknown): void;
-    /**
-     * Tracks a new entity.
-     * @param table - The table definition
-     * @param entity - The new entity
-     * @param pk - Optional primary key
-     */
-    trackNew(table: TableDef, entity: unknown, pk?: unknown): void;
-    /**
-     * Tracks a managed entity.
-     * @param table - The table definition
-     * @param pk - The primary key
-     * @param entity - The managed entity
-     */
-    trackManaged(table: TableDef, pk: unknown, entity: unknown): void;
-    /**
-     * Marks an entity as dirty.
-     * @param entity - The entity to mark
-     */
-    markDirty(entity: unknown): void;
-    /**
-     * Marks an entity as removed.
-     * @param entity - The entity to mark
-     */
-    markRemoved(entity: unknown): void;
-    /**
-     * Gets all tracked entities for a table.
-     * @param table - The table definition
-     * @returns Array of tracked entities
-     */
-    getEntitiesForTable(table: TableDef): TrackedEntity[];
-    /**
-     * Registers a relation change.
-     * @param root - The root entity
-     * @param relationKey - The relation key
-     * @param rootTable - The root table definition
-     * @param relationName - The relation name
-     * @param relation - The relation definition
-     * @param change - The relation change
-     */
-    registerRelationChange(root: unknown, relationKey: RelationKey$1, rootTable: TableDef, relationName: string, relation: RelationDef, change: RelationChange<unknown>): void;
-}
-
 /**
  * Context used during the hydration of entities from database results.
  * It carries necessary services and processors to handle identity management,
@@ -3577,38 +3578,38 @@ declare class OrmSession<E extends DomainEvent = OrmDomainEvent> implements Enti
      * @param pk - The primary key value
      * @returns The entity or undefined if not found
      */
-    getEntity(table: TableDef, pk: unknown): unknown | undefined;
+    getEntity(table: TableDef, pk: PrimaryKey$1): object | undefined;
     /**
      * Sets an entity in the identity map.
      * @param table - The table definition
      * @param pk - The primary key value
      * @param entity - The entity instance
      */
-    setEntity(table: TableDef, pk: unknown, entity: unknown): void;
+    setEntity(table: TableDef, pk: PrimaryKey$1, entity: object): void;
     /**
      * Tracks a new entity.
      * @param table - The table definition
      * @param entity - The entity instance
      * @param pk - Optional primary key value
      */
-    trackNew(table: TableDef, entity: unknown, pk?: unknown): void;
+    trackNew(table: TableDef, entity: object, pk?: PrimaryKey$1): void;
     /**
      * Tracks a managed entity.
      * @param table - The table definition
      * @param pk - The primary key value
      * @param entity - The entity instance
      */
-    trackManaged(table: TableDef, pk: unknown, entity: unknown): void;
+    trackManaged(table: TableDef, pk: PrimaryKey$1, entity: object): void;
     /**
      * Marks an entity as dirty (modified).
      * @param entity - The entity to mark as dirty
      */
-    markDirty(entity: unknown): void;
+    markDirty(entity: object): void;
     /**
      * Marks an entity as removed.
      * @param entity - The entity to mark as removed
      */
-    markRemoved(entity: unknown): void;
+    markRemoved(entity: object): void;
     /**
      * Registers a relation change.
      * @param root - The root entity
@@ -4229,7 +4230,7 @@ declare class SelectQueryBuilder<T = EntityInstance<TableDef>, TTable extends Ta
      *   .where(eq(userTable.columns.active, false));
      * qb.union(activeUsers).union(inactiveUsers);
      */
-    union<TSub extends TableDef>(query: SelectQueryBuilder<unknown, TSub> | SelectQueryNode): SelectQueryBuilder<T, TTable>;
+    union<TSub extends TableDef>(query: SelectQueryBuilder<T, TSub> | SelectQueryNode): SelectQueryBuilder<T, TTable>;
     /**
      * Combines this query with another using UNION ALL
      * @param query - Query to union with
@@ -4239,7 +4240,7 @@ declare class SelectQueryBuilder<T = EntityInstance<TableDef>, TTable extends Ta
      * const q2 = new SelectQueryBuilder(userTable).where(lt(userTable.columns.score, 20));
      * qb.unionAll(q1).unionAll(q2);
      */
-    unionAll<TSub extends TableDef>(query: SelectQueryBuilder<unknown, TSub> | SelectQueryNode): SelectQueryBuilder<T, TTable>;
+    unionAll<TSub extends TableDef>(query: SelectQueryBuilder<T, TSub> | SelectQueryNode): SelectQueryBuilder<T, TTable>;
     /**
      * Combines this query with another using INTERSECT
      * @param query - Query to intersect with
@@ -4251,7 +4252,7 @@ declare class SelectQueryBuilder<T = EntityInstance<TableDef>, TTable extends Ta
      *   .where(eq(userTable.columns.premium, true));
      * qb.intersect(activeUsers).intersect(premiumUsers);
      */
-    intersect<TSub extends TableDef>(query: SelectQueryBuilder<unknown, TSub> | SelectQueryNode): SelectQueryBuilder<T, TTable>;
+    intersect<TSub extends TableDef>(query: SelectQueryBuilder<T, TSub> | SelectQueryNode): SelectQueryBuilder<T, TTable>;
     /**
      * Combines this query with another using EXCEPT
      * @param query - Query to subtract
@@ -4262,7 +4263,7 @@ declare class SelectQueryBuilder<T = EntityInstance<TableDef>, TTable extends Ta
      *   .where(eq(userTable.columns.active, false));
      * qb.except(allUsers).except(inactiveUsers); // Only active users
      */
-    except<TSub extends TableDef>(query: SelectQueryBuilder<unknown, TSub> | SelectQueryNode): SelectQueryBuilder<T, TTable>;
+    except<TSub extends TableDef>(query: SelectQueryBuilder<T, TSub> | SelectQueryNode): SelectQueryBuilder<T, TTable>;
     /**
      * Adds a WHERE EXISTS condition to the query
      * @param subquery - Subquery to check for existence
@@ -4369,6 +4370,7 @@ type Ctor<T> = {
  */
 declare function esel<TEntity extends object, K extends keyof TEntity & string>(entity: Ctor<TEntity>, ...props: K[]): Record<K, ColumnDef>;
 
+type InsertRows = Record<string, ValueOperandInput>[];
 /**
  * Maintains immutable state for building INSERT queries
  */
@@ -4392,7 +4394,7 @@ declare class InsertQueryState {
      * @throws Error if mixing VALUES with SELECT source
      * @throws Error if invalid values are provided
      */
-    withValues(rows: Record<string, unknown>[]): InsertQueryState;
+    withValues(rows: InsertRows): InsertQueryState;
     /**
      * Sets the columns for the INSERT query
      * @param columns - Column nodes to insert into
@@ -4435,7 +4437,7 @@ declare class InsertQueryBuilder<T> {
      * @param rowOrRows - Single row object or array of row objects to insert
      * @returns A new InsertQueryBuilder with the VALUES clause added
      */
-    values(rowOrRows: Record<string, unknown> | Record<string, unknown>[]): InsertQueryBuilder<T>;
+    values(rowOrRows: Record<string, ValueOperandInput> | Record<string, ValueOperandInput>[]): InsertQueryBuilder<T>;
     /**
      * Specifies the columns for the INSERT query
      * @param columns - Column definitions or nodes to insert into
@@ -5917,7 +5919,7 @@ type OperandInput$2 = OperandNode | ColumnDef | string | number | boolean | null
  * @example
  * coalesce(users.nickname, users.firstName, 'Guest');
  */
-declare const coalesce: <T = any>(...args: OperandInput$2[]) => TypedExpression<T>;
+declare const coalesce: <T = unknown>(...args: OperandInput$2[]) => TypedExpression<T>;
 /**
  * Returns null if the two arguments are equal, otherwise returns the first argument.
  *
@@ -5925,21 +5927,21 @@ declare const coalesce: <T = any>(...args: OperandInput$2[]) => TypedExpression<
  * @param val2 - The second value to compare against.
  * @returns A `TypedExpression<T>` representing the `NULLIF` SQL function.
  */
-declare const nullif: <T = any>(val1: OperandInput$2, val2: OperandInput$2) => TypedExpression<T>;
+declare const nullif: <T = unknown>(val1: OperandInput$2, val2: OperandInput$2) => TypedExpression<T>;
 /**
  * Returns the largest value in a list.
  *
  * @param args - The list of values or columns to compare.
  * @returns A `TypedExpression<T>` representing the `GREATEST` SQL function.
  */
-declare const greatest: <T = any>(...args: OperandInput$2[]) => TypedExpression<T>;
+declare const greatest: <T = unknown>(...args: OperandInput$2[]) => TypedExpression<T>;
 /**
  * Returns the smallest value in a list.
  *
  * @param args - The list of values or columns to compare.
  * @returns A `TypedExpression<T>` representing the `LEAST` SQL function.
  */
-declare const least: <T = any>(...args: OperandInput$2[]) => TypedExpression<T>;
+declare const least: <T = unknown>(...args: OperandInput$2[]) => TypedExpression<T>;
 /**
  * Returns the first argument if it is not null, otherwise returns the second argument.
  *
@@ -5947,7 +5949,7 @@ declare const least: <T = any>(...args: OperandInput$2[]) => TypedExpression<T>;
  * @param defaultValue - The default value to return if val is null.
  * @returns A `TypedExpression<T>` representing the `COALESCE` SQL function.
  */
-declare const ifNull: <T = any>(val: OperandInput$2, defaultValue: OperandInput$2) => TypedExpression<T>;
+declare const ifNull: <T = unknown>(val: OperandInput$2, defaultValue: OperandInput$2) => TypedExpression<T>;
 
 type OperandInput$1 = OperandNode | ColumnDef | string | number | boolean | null;
 /**
@@ -5964,16 +5966,16 @@ declare const jsonLength: (target: OperandInput$1, path?: OperandInput$1) => Typ
  * @param target - JSON column or value.
  * @param path - JSON path to set.
  * @param value - Value to set.
- * @returns A `TypedExpression<any>` representing the `JSON_SET` SQL function.
+ * @returns A `TypedExpression<T>` representing the `JSON_SET` SQL function.
  */
-declare const jsonSet: (target: OperandInput$1, path: OperandInput$1, value: OperandInput$1) => TypedExpression<any>;
+declare const jsonSet: <T = unknown>(target: OperandInput$1, path: OperandInput$1, value: OperandInput$1) => TypedExpression<T>;
 /**
  * Aggregates values into a JSON array.
  *
  * @param value - Column or expression to aggregate.
- * @returns A `TypedExpression<any[]>` representing the `JSON_ARRAYAGG` SQL function.
+ * @returns A `TypedExpression<unknown[]>` representing the `JSON_ARRAYAGG` SQL function.
  */
-declare const jsonArrayAgg: (value: OperandInput$1) => TypedExpression<any[]>;
+declare const jsonArrayAgg: (value: OperandInput$1) => TypedExpression<unknown[]>;
 /**
  * Checks if a JSON document contains a specific piece of data.
  *
@@ -5990,9 +5992,9 @@ type OperandInput = OperandNode | ColumnDef | string | number | boolean | null;
  *
  * @param array - Array column or value.
  * @param value - Value to append.
- * @returns A `TypedExpression<any[]>` representing the `ARRAY_APPEND` SQL function.
+ * @returns A `TypedExpression<unknown[]>` representing the `ARRAY_APPEND` SQL function.
  */
-declare const arrayAppend: (array: OperandInput, value: OperandInput) => TypedExpression<any[]>;
+declare const arrayAppend: (array: OperandInput, value: OperandInput) => TypedExpression<unknown[]>;
 
 /**
  * Browser-compatible implementation of AsyncLocalStorage.
@@ -6946,4 +6948,4 @@ type PooledExecutorFactoryOptions<TConn> = {
  */
 declare function createPooledExecutorFactory<TConn>(opts: PooledExecutorFactoryOptions<TConn>): DbExecutorFactory;
 
-export { type AliasRefNode, type AnyDomainEvent, type ArithmeticExpressionNode, type TableRef as AstTableRef, AsyncLocalStorage, BelongsTo, BelongsToMany, type BelongsToManyOptions, type BelongsToManyRelation, type BelongsToOptions, type BelongsToReference, type BelongsToReferenceApi, type BelongsToRelation, type BetweenExpressionNode, type BinaryExpressionNode, type BitwiseExpressionNode, type CascadeMode, type CaseExpressionNode, type CastExpressionNode, type CheckConstraint, type CollateExpressionNode, Column, type ColumnDef, type ColumnDiff, type ColumnInput, type ColumnNode, type ColumnOptions, type ColumnRef, type ColumnToTs, type ColumnType, ConstructorMaterializationStrategy, type CreateTediousClientOptions, type DatabaseCheck, type DatabaseColumn, type DatabaseIndex, type DatabaseSchema, type DatabaseTable, type DbExecutor, type DbExecutorFactory, type DecoratedEntityInstance, DefaultBelongsToReference, DefaultEntityMaterializer, DefaultHasManyCollection, DefaultManyToManyCollection, type DefaultValue, DeleteQueryBuilder, type DialectName, type DomainEvent, DomainEventBus, type DomainEventHandler, Entity, type EntityContext, type EntityInstance, type EntityMaterializationStrategy, type EntityMaterializer, type EntityOptions, EntityStatus, type ExecutionContext, type ExistsExpressionNode, type ExpressionNode, type ExpressionVisitor, type ForeignKeyReference, type FunctionNode, type GroupConcatOptions, type HasDomainEvents, HasMany, type HasManyCollection, type HasManyOptions, type HasManyRelation, HasOne, type HasOneOptions, type HasOneReference, type HasOneReferenceApi, type HasOneRelation, type HydrationContext, type HydrationMetadata, type HydrationPivotPlan, type HydrationPlan, type HydrationRelationPlan, type InExpressionNode, type InExpressionRight, type IndexColumn, type IndexDef, type InferRow, type InitialHandlers, InsertQueryBuilder, type IntrospectOptions, type JsonPathNode, type Jsonify, type JsonifyScalar, type LiteralNode, type LiteralValue, type LogicalExpressionNode, type ManyToManyCollection, type MssqlClientLike, MySqlDialect, type MysqlClientLike, type NullExpressionNode, type OperandNode, type OperandVisitor, Orm, type OrmDomainEvent, type OrmInterceptor, type OrmOptions, OrmSession, type OrmSessionOptions, Pool, type PoolAdapter, type PoolLease, type PoolOptions, type PooledConnectionAdapter, type PostgresClientLike, PostgresDialect, PrimaryKey, type Primitive, PrototypeMaterializationStrategy, type QueryLogEntry, type QueryLogger, type QueryResult, type RawDefaultValue, type ReferentialAction, type RelationChange, type RelationChangeEntry, type RelationDef, type RelationKey$1 as RelationKey, RelationKinds, type RelationMap, type RelationTargetTable, type RelationType, type RenderColumnOptions, STANDARD_COLUMN_TYPES, type SaveGraphInputPayload, type SaveGraphInputScalar, type SaveGraphJsonScalar, type ScalarSubqueryNode, type SchemaChange, type SchemaChangeKind, type SchemaDiffOptions, type SchemaGenerateResult, type SchemaIntrospector, type SchemaPlan, SelectQueryBuilder, type SelectQueryInput, type SelectableKeys, type SimpleQueryRunner, SqlServerDialect, type SqliteClientLike, SqliteDialect, type StandardColumnType, type SynchronizeOptions, type TableDef, type TableHooks, type TableOptions, type TableRef$1 as TableRef, type TediousColumn, type TediousConnectionLike, type TediousModule, type TediousRequest, type TediousRequestCtor, type TediousTypes, type TrackedEntity, TypeScriptGenerator, type TypedExpression, type TypedLike, UpdateQueryBuilder, type ValueOperandInput, type WindowFunctionNode, abs, acos, add, addDomainEvent, age, aliasRef, and, arrayAppend, asType, ascii, asin, atan, atan2, avg, belongsTo, belongsToMany, between, bitAnd, bitLength, bitOr, bitXor, bootstrapEntities, caseWhen, cast, cbrt, ceil, ceiling, char, charLength, chr, clearExpressionDispatchers, clearOperandDispatchers, coalesce, col, collate, columnOperand, concat, concatWs, correlateBy, cos, cot, count, countAll, createEntityFromRow, createEntityProxy, createExecutorFromQueryRunner, createMssqlExecutor, createMysqlExecutor, createPooledExecutorFactory, createPostgresExecutor, createQueryLoggingExecutor, createSqliteExecutor, createTediousExecutor, createTediousMssqlClient, currentDate, currentTime, dateAdd, dateDiff, dateFormat, dateSub, dateTrunc, day, dayOfWeek, defineTable, degrees, deleteFrom, denseRank, diffSchema, div, endOfMonth, entityRef, eq, esel, executeHydrated, executeHydratedPlain, executeHydratedPlainWithContexts, executeHydratedWithContexts, executeSchemaSql, executeSchemaSqlFor, exists, exp, extract, firstValue, floor, fromUnixTime, generateCreateTableSql, generateSchemaSql, generateSchemaSqlFor, getColumn, getDecoratorMetadata, getSchemaIntrospector, getTableDefFromEntity, greatest, groupConcat, gt, gte, hasMany, hasOne, hour, hydrateRows, ifNull, inList, inSubquery, initcap, insertInto, instr, introspectSchema, isCaseExpressionNode, isCastExpressionNode, isCollateExpressionNode, isExpressionSelectionNode, isFunctionNode, isNotNull, isNull, isOperandNode, isValueOperandInput, isWindowFunctionNode, jsonArrayAgg, jsonContains, jsonLength, jsonPath, jsonSet, jsonify, lag, lastValue, lead, least, left, length, like, ln, loadBelongsToManyRelation, loadBelongsToRelation, loadHasManyRelation, loadHasOneRelation, localTime, localTimestamp, locate, log, log10, log2, logBase, lower, lpad, lt, lte, ltrim, materializeAs, max, md5, min, minute, mod, month, mul, neq, normalizeColumnType, notBetween, notExists, notInList, notInSubquery, notLike, now, ntile, nullif, octetLength, or, outerRef, pi, position, pow, power, quarter, radians, rand, random, rank, registerExpressionDispatcher, registerOperandDispatcher, registerSchemaIntrospector, relationLoaderCache, renderColumnDefinition, renderTypeWithArgs, repeat, replace, reverse, right, round, rowNumber, rowsToQueryResult, rpad, rtrim, second, sel, selectFrom, selectFromEntity, setRelations, sha1, sha2, shiftLeft, shiftRight, sign, sin, space, sqrt, stddev, sub, substr, sum, synchronizeSchema, tableRef, tan, toColumnRef, toTableRef, trim, trunc, truncate, unixTimestamp, update, upper, utcNow, valueToOperand, variance, visitExpression, visitOperand, weekOfYear, windowFunction, year };
+export { type AliasRefNode, type AnyDomainEvent, type ArithmeticExpressionNode, type TableRef as AstTableRef, AsyncLocalStorage, BelongsTo, BelongsToMany, type BelongsToManyOptions, type BelongsToManyRelation, type BelongsToOptions, type BelongsToReference, type BelongsToReferenceApi, type BelongsToRelation, type BetweenExpressionNode, type BinaryExpressionNode, type BitwiseExpressionNode, type CascadeMode, type CaseExpressionNode, type CastExpressionNode, type CheckConstraint, type CollateExpressionNode, Column, type ColumnDef, type ColumnDiff, type ColumnInput, type ColumnNode, type ColumnOptions, type ColumnRef, type ColumnToTs, type ColumnType, ConstructorMaterializationStrategy, type CreateTediousClientOptions, type DatabaseCheck, type DatabaseColumn, type DatabaseIndex, type DatabaseSchema, type DatabaseTable, type DbExecutor, type DbExecutorFactory, type DecoratedEntityInstance, DefaultBelongsToReference, DefaultEntityMaterializer, DefaultHasManyCollection, DefaultManyToManyCollection, type DefaultValue, DeleteQueryBuilder, type DialectName, type DomainEvent, DomainEventBus, type DomainEventHandler, Entity, type EntityContext, type EntityInstance, type EntityMaterializationStrategy, type EntityMaterializer, type EntityOptions, type PrimaryKey$1 as EntityPrimaryKey, EntityStatus, type ExecutionContext, type ExistsExpressionNode, type ExpressionNode, type ExpressionVisitor, type ForeignKeyReference, type FunctionNode, type GroupConcatOptions, type HasDomainEvents, HasMany, type HasManyCollection, type HasManyOptions, type HasManyRelation, HasOne, type HasOneOptions, type HasOneReference, type HasOneReferenceApi, type HasOneRelation, type HydrationContext, type HydrationMetadata, type HydrationPivotPlan, type HydrationPlan, type HydrationRelationPlan, type InExpressionNode, type InExpressionRight, type IndexColumn, type IndexDef, type InferRow, type InitialHandlers, InsertQueryBuilder, type IntrospectOptions, type JsonPathNode, type Jsonify, type JsonifyScalar, type LiteralNode, type LiteralValue, type LogicalExpressionNode, type ManyToManyCollection, type MssqlClientLike, MySqlDialect, type MysqlClientLike, type NullExpressionNode, type OperandNode, type OperandVisitor, Orm, type OrmDomainEvent, type OrmInterceptor, type OrmOptions, OrmSession, type OrmSessionOptions, Pool, type PoolAdapter, type PoolLease, type PoolOptions, type PooledConnectionAdapter, type PostgresClientLike, PostgresDialect, PrimaryKey, type Primitive, PrototypeMaterializationStrategy, type QueryLogEntry, type QueryLogger, type QueryResult, type RawDefaultValue, type ReferentialAction, type RelationChange, type RelationChangeEntry, type RelationDef, type RelationKey$1 as RelationKey, RelationKinds, type RelationMap, type RelationTargetTable, type RelationType, type RenderColumnOptions, STANDARD_COLUMN_TYPES, type SaveGraphInputPayload, type SaveGraphInputScalar, type SaveGraphJsonScalar, type ScalarSubqueryNode, type SchemaChange, type SchemaChangeKind, type SchemaDiffOptions, type SchemaGenerateResult, type SchemaIntrospector, type SchemaPlan, SelectQueryBuilder, type SelectQueryInput, type SelectableKeys, type SimpleQueryRunner, SqlServerDialect, type SqliteClientLike, SqliteDialect, type StandardColumnType, type SynchronizeOptions, type TableDef, type TableHooks, type TableOptions, type TableRef$1 as TableRef, type TediousColumn, type TediousConnectionLike, type TediousModule, type TediousRequest, type TediousRequestCtor, type TediousTypes, type TrackedEntity, TypeScriptGenerator, type TypedExpression, type TypedLike, UpdateQueryBuilder, type ValueOperandInput, type WindowFunctionNode, abs, acos, add, addDomainEvent, age, aliasRef, and, arrayAppend, asType, ascii, asin, atan, atan2, avg, belongsTo, belongsToMany, between, bitAnd, bitLength, bitOr, bitXor, bootstrapEntities, caseWhen, cast, cbrt, ceil, ceiling, char, charLength, chr, clearExpressionDispatchers, clearOperandDispatchers, coalesce, col, collate, columnOperand, concat, concatWs, correlateBy, cos, cot, count, countAll, createEntityFromRow, createEntityProxy, createExecutorFromQueryRunner, createMssqlExecutor, createMysqlExecutor, createPooledExecutorFactory, createPostgresExecutor, createQueryLoggingExecutor, createSqliteExecutor, createTediousExecutor, createTediousMssqlClient, currentDate, currentTime, dateAdd, dateDiff, dateFormat, dateSub, dateTrunc, day, dayOfWeek, defineTable, degrees, deleteFrom, denseRank, diffSchema, div, endOfMonth, entityRef, eq, esel, executeHydrated, executeHydratedPlain, executeHydratedPlainWithContexts, executeHydratedWithContexts, executeSchemaSql, executeSchemaSqlFor, exists, exp, extract, firstValue, floor, fromUnixTime, generateCreateTableSql, generateSchemaSql, generateSchemaSqlFor, getColumn, getDecoratorMetadata, getSchemaIntrospector, getTableDefFromEntity, greatest, groupConcat, gt, gte, hasMany, hasOne, hour, hydrateRows, ifNull, inList, inSubquery, initcap, insertInto, instr, introspectSchema, isCaseExpressionNode, isCastExpressionNode, isCollateExpressionNode, isExpressionSelectionNode, isFunctionNode, isNotNull, isNull, isOperandNode, isValueOperandInput, isWindowFunctionNode, jsonArrayAgg, jsonContains, jsonLength, jsonPath, jsonSet, jsonify, lag, lastValue, lead, least, left, length, like, ln, loadBelongsToManyRelation, loadBelongsToRelation, loadHasManyRelation, loadHasOneRelation, localTime, localTimestamp, locate, log, log10, log2, logBase, lower, lpad, lt, lte, ltrim, materializeAs, max, md5, min, minute, mod, month, mul, neq, normalizeColumnType, notBetween, notExists, notInList, notInSubquery, notLike, now, ntile, nullif, octetLength, or, outerRef, pi, position, pow, power, quarter, radians, rand, random, rank, registerExpressionDispatcher, registerOperandDispatcher, registerSchemaIntrospector, relationLoaderCache, renderColumnDefinition, renderTypeWithArgs, repeat, replace, reverse, right, round, rowNumber, rowsToQueryResult, rpad, rtrim, second, sel, selectFrom, selectFromEntity, setRelations, sha1, sha2, shiftLeft, shiftRight, sign, sin, space, sqrt, stddev, sub, substr, sum, synchronizeSchema, tableRef, tan, toColumnRef, toTableRef, trim, trunc, truncate, unixTimestamp, update, upper, utcNow, valueToOperand, variance, visitExpression, visitOperand, weekOfYear, windowFunction, year };

package/dist/index.js

@@ -11124,6 +11124,7 @@ var UnitOfWork = class {
     const key = findPrimaryKey(tracked.table);
     const val = tracked.entity[key];
     if (val === void 0 || val === null) return null;
+    if (typeof val !== "string" && typeof val !== "number") return null;
     return val;
   }
 };