uql-orm 0.22.0 → 0.24.0

package/dist/type/universalQuerier.d.ts

@@ -53,19 +53,29 @@ export interface UniversalQuerier {
      */
     count<E extends object>(entity: Type<E>, q?: QuerySearch<E>, opts?: QueryOptions): Promise<number>;
     /**
-     * inserts a record.
+     * Insert a single record and return its ID (provided, `onInsert`-generated, or
+     * database-generated - see {@link UniversalQuerier.insertMany} for the exact semantics).
+     * Returns `undefined` when the ID cannot be determined (e.g. MySQL/SQLite non-auto-increment
+     * keys in batches without explicit IDs).
      * @param entity the entity to persist on
      * @param payload the data to be persisted
      * @return the ID
      */
     insertOne<E extends object>(entity: Type<E>, payload: E): Promise<IdValue<E> | undefined>;
     /**
-     * Inserts many records.
+     * Insert multiple records in a single statement (auto-chunked when the batch exceeds the
+     * dialect's bind-parameter limit) and return their IDs in payload order.
+     *
+     * Provided IDs and client-generated ones (`@Id({ onInsert })`) are always returned as-is.
+     * Database-generated IDs are exact on `'returning'` dialects (Postgres, MariaDB, MongoDB);
+     * on MySQL/SQLite they are inferred from the driver header, which is only reliable for
+     * auto-increment keys in batches without explicit IDs - otherwise those entries are
+     * `undefined` rather than potentially wrong values.
      * @param entity the entity to persist on
      * @param payload the data to be persisted
      * @return the IDs
      */
-    insertMany?<E extends object>(entity: Type<E>, payload: E[]): Promise<IdValue<E>[]>;
+    insertMany<E extends object>(entity: Type<E>, payload: E[]): Promise<IdValue<E>[]>;
     /**
      * updates a record partially.
      * @param entity the entity to persist on
@@ -81,7 +91,7 @@ export interface UniversalQuerier {
      * @param payload the data to be persisted
      * @return the number of affected records
      */
-    updateMany?<E extends object>(entity: Type<E>, q: QuerySearch<E>, payload: UpdatePayload<E>, opts?: QueryOptions): Promise<number>;
+    updateMany<E extends object>(entity: Type<E>, q: QuerySearch<E>, payload: UpdatePayload<E>, opts?: QueryOptions): Promise<number>;
     /**
      * Insert or update a record based on the conflict paths.
      * @param entity the entity to persist on
@@ -89,7 +99,7 @@ export interface UniversalQuerier {
      * @param payload the data to be persisted
      * @return operation metadata; see {@link QueryUpdateResult}
      */
-    upsertOne?<E extends object>(entity: Type<E>, conflictPaths: QueryConflictPaths<E>, payload: E): Promise<QueryUpdateResult>;
+    upsertOne<E extends object>(entity: Type<E>, conflictPaths: QueryConflictPaths<E>, payload: E): Promise<QueryUpdateResult>;
     /**
      * Insert or update many records based on the conflict paths.
      * @param entity the entity to persist on
@@ -97,7 +107,7 @@ export interface UniversalQuerier {
      * @param payload the data to be persisted
      * @return operation metadata; see {@link QueryUpdateResult}
      */
-    upsertMany?<E extends object>(entity: Type<E>, conflictPaths: QueryConflictPaths<E>, payload: E[]): Promise<QueryUpdateResult>;
+    upsertMany<E extends object>(entity: Type<E>, conflictPaths: QueryConflictPaths<E>, payload: E[]): Promise<QueryUpdateResult>;
     /**
      * insert or update a record.
      * @param entity the entity to persist on
@@ -111,7 +121,7 @@ export interface UniversalQuerier {
      * @param payload the data to be persisted
      * @return the IDs
      */
-    saveMany?<E extends object>(entity: Type<E>, payload: E[]): Promise<IdValue<E>[]>;
+    saveMany<E extends object>(entity: Type<E>, payload: E[]): Promise<IdValue<E>[]>;
     /**
      * delete or SoftDelete a record.
      * @param entity the entity to persist on
@@ -126,6 +136,12 @@ export interface UniversalQuerier {
      * @return the number of affected records
      */
     deleteMany<E extends object>(entity: Type<E>, q: QuerySearch<E>, opts?: QueryOptions): Promise<number>;
+    /**
+     * Restore soft-deleted records (sets the soft-delete field back to `null`). Throws if the
+     * entity has no soft-delete field.
+     */
+    restoreOneById<E extends object>(entity: Type<E>, id: IdValue<E>): Promise<number>;
+    restoreMany<E extends object>(entity: Type<E>, q: QuerySearch<E>): Promise<number>;
     /**
      * runs an aggregate query (GROUP BY with aggregate functions).
      * @param entity the target entity

package/dist/util/hook.util.js

@@ -1,4 +1,4 @@
-import { getMeta } from '../entity/decorator/index.js';
+import { getMeta } from '../entity/index.js';
 /**
  * Run all registered hooks for the given event on each payload.
  * Hooks are invoked with `this` bound to the payload via `call`,

package/package.json

@@ -3,16 +3,17 @@
   "homepage": "https://uql-orm.dev",
   "description": "Extremely fast, type-safe TypeScript ORM - one API for every database",
   "license": "MIT",
-  "version": "0.22.0",
+  "version": "0.24.0",
   "type": "module",
   "engines": {
-    "node": ">=20"
+    "node": ">=24"
   },
   "sideEffects": false,
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "browser": {
-    "./dist/context/context.js": "./dist/context/context.browser.js"
+    "./dist/context/context.js": "./dist/context/context.browser.js",
+    "./dist/querier/querierContext.js": "./dist/querier/querierContext.browser.js"
   },
   "bin": {
     "uql-migrate": "./dist/migrate/bin.js"
@@ -72,13 +73,11 @@
     "@tursodatabase/serverless": ">=1.0.0",
     "better-sqlite3": ">=9.0.0",
     "express": ">=5.0.0",
-    "jiti": ">=2.0.0",
     "mariadb": ">=3.0.0",
     "mongodb": ">=6.0.0",
     "mysql2": ">=3.0.0",
     "pg": ">=8.0.0",
     "pg-query-stream": ">=4.0.0",
-    "reflect-metadata": ">=0.2.0",
     "rxjs": ">=7.0.0"
   },
   "peerDependenciesMeta": {
@@ -106,9 +105,6 @@
     "express": {
       "optional": true
     },
-    "jiti": {
-      "optional": true
-    },
     "mariadb": {
       "optional": true
     },
@@ -124,9 +120,6 @@
     "pg-query-stream": {
       "optional": true
     },
-    "reflect-metadata": {
-      "optional": true
-    },
     "rxjs": {
       "optional": true
     }
@@ -139,19 +132,17 @@
     "@nestjs/testing": "^11.1.28",
     "@tursodatabase/database": "^0.7.2",
     "@tursodatabase/serverless": "^1.4.0",
-    "@types/better-sqlite3": "^7.6.13",
+    "@types/better-sqlite3": "^9.6.0",
     "@types/express": "^5.0.6",
-    "@types/pg": "^8.20.1",
+    "@types/pg": "^8.20.3",
     "@types/ws": "^8.18.1",
     "better-sqlite3": "^13.0.2",
     "express": "^5.2.1",
-    "jiti": "^2.7.0",
     "mariadb": "^3.5.3",
     "mongodb": "^7.5.0",
     "mysql2": "^3.23.2",
     "pg": "^8.22.0",
     "pg-query-stream": "^4.16.0",
-    "reflect-metadata": "^0.2.2",
     "rxjs": "^7.8.2",
     "sqlite-vec": "^0.1.9",
     "ws": "^8.21.1"
@@ -207,5 +198,5 @@
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "0804fc0205c1f629e497df020835a17b63aed0e8"
+  "gitHead": "d9499a4b8c5ee866950b397fb87f55643d86fc39"
 }

package/dist/entity/decorator/field.d.ts

@@ -1,2 +0,0 @@
-import type { FieldOptions } from '../../type/index.js';
-export declare function Field<E>(opts?: FieldOptions): (target: object, key: string) => void;

package/dist/entity/decorator/field.js

@@ -1,7 +0,0 @@
-import { defineField } from '../metadata/definition.js';
-export function Field(opts) {
-    return (target, key) => {
-        const entity = target.constructor;
-        defineField(entity, key, opts);
-    };
-}

package/dist/entity/decorator/filter.d.ts

@@ -1,7 +0,0 @@
-import type { FilterOptions, Type } from '../../type/index.js';
-/**
- * Registers a named, default-on `$where` filter on the entity, applied to every query
- * unless bypassed via `QueryOptions.filters`.
- * @example `@Filter('active', { condition: { status: 'active' }, default: false })`
- */
-export declare function Filter<E>(name: string, opts: FilterOptions<E>): (entity: Type<E>) => void;

package/dist/entity/decorator/filter.js

@@ -1,11 +0,0 @@
-import { defineFilter } from '../metadata/definition.js';
-/**
- * Registers a named, default-on `$where` filter on the entity, applied to every query
- * unless bypassed via `QueryOptions.filters`.
- * @example `@Filter('active', { condition: { status: 'active' }, default: false })`
- */
-export function Filter(name, opts) {
-    return (entity) => {
-        defineFilter(entity, name, opts);
-    };
-}

package/dist/entity/decorator/hook.d.ts

@@ -1,7 +0,0 @@
-export declare const BeforeInsert: () => MethodDecorator;
-export declare const AfterInsert: () => MethodDecorator;
-export declare const BeforeUpdate: () => MethodDecorator;
-export declare const AfterUpdate: () => MethodDecorator;
-export declare const BeforeDelete: () => MethodDecorator;
-export declare const AfterDelete: () => MethodDecorator;
-export declare const AfterLoad: () => MethodDecorator;

package/dist/entity/decorator/hook.js

@@ -1,14 +0,0 @@
-import { defineHook } from '../metadata/definition.js';
-function createHookDecorator(event) {
-    return () => (target, key) => {
-        const entity = target.constructor;
-        defineHook(entity, String(key), event);
-    };
-}
-export const BeforeInsert = createHookDecorator('beforeInsert');
-export const AfterInsert = createHookDecorator('afterInsert');
-export const BeforeUpdate = createHookDecorator('beforeUpdate');
-export const AfterUpdate = createHookDecorator('afterUpdate');
-export const BeforeDelete = createHookDecorator('beforeDelete');
-export const AfterDelete = createHookDecorator('afterDelete');
-export const AfterLoad = createHookDecorator('afterLoad');

package/dist/entity/decorator/id.d.ts

@@ -1,2 +0,0 @@
-import type { FieldOptions } from '../../type/index.js';
-export declare function Id<E>(opts?: FieldOptions): (target: object, key: string) => void;

package/dist/entity/decorator/id.js

@@ -1,7 +0,0 @@
-import { defineId } from '../metadata/definition.js';
-export function Id(opts = {}) {
-    return (target, key) => {
-        const entity = target.constructor;
-        defineId(entity, key, opts);
-    };
-}

package/dist/entity/decorator/index-decorator.d.ts

@@ -1,22 +0,0 @@
-import type { IndexColumnInput, IndexOptions, Type } from '../../type/index.js';
-/**
- * Define a composite index on an entity class.
- *
- * @example
- * ```ts
- * @Index(['lastName', 'firstName'], { name: 'idx_users_fullname' })
- * @Entity()
- * export class User {
- *   @Id() id?: number;
- *   @Field() firstName?: string;
- *   @Field() lastName?: string;
- * }
- *
- * // With unique and partial index
- * @Index(['email'], { unique: true })
- * @Index(['status'], { where: "status = 'active'" })
- * @Entity()
- * export class User { ... }
- * ```
- */
-export declare function Index<E>(columns: readonly IndexColumnInput[], options?: IndexOptions): (target: Type<E>) => void;

package/dist/entity/decorator/index-decorator.js

@@ -1,26 +0,0 @@
-import { defineIndex } from '../metadata/definition.js';
-/**
- * Define a composite index on an entity class.
- *
- * @example
- * ```ts
- * @Index(['lastName', 'firstName'], { name: 'idx_users_fullname' })
- * @Entity()
- * export class User {
- *   @Id() id?: number;
- *   @Field() firstName?: string;
- *   @Field() lastName?: string;
- * }
- *
- * // With unique and partial index
- * @Index(['email'], { unique: true })
- * @Index(['status'], { where: "status = 'active'" })
- * @Entity()
- * export class User { ... }
- * ```
- */
-export function Index(columns, options = {}) {
-    return (target) => {
-        defineIndex(target, { ...options, columns });
-    };
-}

package/dist/entity/decorator/index.d.ts

@@ -1,8 +0,0 @@
-export { defineEntity, defineField, defineFilter, defineHook, defineId, defineIndex, defineRelation, getEntities, getMeta, } from '../metadata/definition.js';
-export * from './entity.js';
-export * from './field.js';
-export * from './filter.js';
-export * from './hook.js';
-export * from './id.js';
-export * from './index-decorator.js';
-export * from './relation.js';

package/dist/entity/decorator/index.js

@@ -1,8 +0,0 @@
-export { defineEntity, defineField, defineFilter, defineHook, defineId, defineIndex, defineRelation, getEntities, getMeta, } from '../metadata/definition.js';
-export * from './entity.js';
-export * from './field.js';
-export * from './filter.js';
-export * from './hook.js';
-export * from './id.js';
-export * from './index-decorator.js';
-export * from './relation.js';

package/dist/entity/decorator/relation.d.ts

@@ -1,8 +0,0 @@
-import type { RelationManyToManyOptions, RelationManyToOneOptions, RelationOneToManyOptions, RelationOneToOneOptions, RelationOptions } from '../../type/index.js';
-declare function Relation<E>(opts: RelationOptions<E>): (target: object, key: string) => void;
-type RelationReturn = ReturnType<typeof Relation>;
-export declare function OneToOne<E>(opts?: RelationOneToOneOptions<E>): RelationReturn;
-export declare function ManyToOne<E>(opts?: RelationManyToOneOptions<E>): RelationReturn;
-export declare function OneToMany<E>(opts: RelationOneToManyOptions<E>): RelationReturn;
-export declare function ManyToMany<E>(opts: RelationManyToManyOptions<E>): RelationReturn;
-export {};

package/dist/entity/decorator/relation.js

@@ -1,19 +0,0 @@
-import { defineRelation } from '../metadata/definition.js';
-function Relation(opts) {
-    return (target, key) => {
-        const entity = target.constructor;
-        defineRelation(entity, key, opts);
-    };
-}
-export function OneToOne(opts) {
-    return Relation({ cardinality: '11', ...opts });
-}
-export function ManyToOne(opts) {
-    return Relation({ cardinality: 'm1', ...opts });
-}
-export function OneToMany(opts) {
-    return Relation({ cardinality: '1m', ...opts });
-}
-export function ManyToMany(opts) {
-    return Relation({ cardinality: 'mm', ...opts });
-}

package/dist/migrate/codegen/smartRelationDetector.d.ts

@@ -1,47 +0,0 @@
-/**
- * Smart Relation Detector
- *
- * Uses heuristics and schema analysis to detect relationships between tables:
- * - Explicit foreign keys (highest confidence)
- * - Junction tables for ManyToMany
- * - Unique FK columns for OneToOne
- */
-import type { SchemaAST } from '../../schema/schemaAST.js';
-import type { DetectedRelation } from '../../schema/types.js';
-/**
- * Configuration for relation detection.
- */
-export interface RelationDetectorOptions {
-    /** Minimum confidence threshold (0-1) to include in results */
-    minConfidence?: number;
-    /** Custom singularize function */
-    singularize?: (name: string) => string;
-}
-/**
- * Detects relationships in a SchemaAST using multiple heuristics.
- */
-export declare class SmartRelationDetector {
-    private readonly ast;
-    private readonly options;
-    constructor(ast: SchemaAST, options?: RelationDetectorOptions);
-    /**
-     * Detect all relationships in the schema.
-     */
-    detectAll(): DetectedRelation[];
-    /**
-     * Detect junction tables that represent ManyToMany relationships.
-     */
-    private detectJunctionTables;
-    /**
-     * Detect relations where unique FK should upgrade to OneToOne.
-     */
-    private detectOneToOneRelations;
-    /**
-     * Default singularize function (delegates to shared utility).
-     */
-    private defaultSingularize;
-}
-/**
- * Create a SmartRelationDetector for the given AST.
- */
-export declare function createRelationDetector(ast: SchemaAST, options?: RelationDetectorOptions): SmartRelationDetector;

package/dist/migrate/codegen/smartRelationDetector.js

@@ -1,134 +0,0 @@
-/**
- * Smart Relation Detector
- *
- * Uses heuristics and schema analysis to detect relationships between tables:
- * - Explicit foreign keys (highest confidence)
- * - Junction tables for ManyToMany
- * - Unique FK columns for OneToOne
- */
-import { singularize } from '../../util/string.util.js';
-/**
- * Detects relationships in a SchemaAST using multiple heuristics.
- */
-export class SmartRelationDetector {
-    ast;
-    options;
-    constructor(ast, options = {}) {
-        this.ast = ast;
-        this.options = {
-            minConfidence: options.minConfidence ?? 0.5,
-            singularize: options.singularize ?? this.defaultSingularize.bind(this),
-        };
-    }
-    /**
-     * Detect all relationships in the schema.
-     */
-    detectAll() {
-        const relations = [];
-        // 1. Add explicit FK relationships (confidence: 1.0)
-        for (const rel of this.ast.relationships) {
-            relations.push({
-                type: rel.type,
-                from: {
-                    table: rel.from.table,
-                    columns: rel.from.columns,
-                },
-                to: {
-                    table: rel.to.table,
-                    columns: rel.to.columns,
-                },
-                through: rel.through,
-                confidence: 1.0,
-                source: 'explicit_fk',
-            });
-        }
-        // 2. Detect junction tables (ManyToMany)
-        const junctionRelations = this.detectJunctionTables();
-        relations.push(...junctionRelations);
-        // 3. Detect unique FK -> OneToOne upgrades
-        const oneToOneUpgrades = this.detectOneToOneRelations(relations);
-        relations.push(...oneToOneUpgrades);
-        // Filter by confidence
-        return relations.filter((r) => r.confidence >= this.options.minConfidence);
-    }
-    /**
-     * Detect junction tables that represent ManyToMany relationships.
-     */
-    detectJunctionTables() {
-        const relations = [];
-        for (const table of this.ast.tables.values()) {
-            if (!this.ast.isJunctionTable(table))
-                continue;
-            const outgoingRels = table.outgoingRelations;
-            if (outgoingRels.length !== 2)
-                continue;
-            const [rel1, rel2] = outgoingRels;
-            // Create ManyToMany relation
-            relations.push({
-                type: 'ManyToMany',
-                from: {
-                    table: rel1.to.table,
-                    columns: rel1.to.columns,
-                },
-                to: {
-                    table: rel2.to.table,
-                    columns: rel2.to.columns,
-                },
-                through: table,
-                confidence: 0.95,
-                source: 'junction_table',
-            });
-            // Also create inverse relation
-            relations.push({
-                type: 'ManyToMany',
-                from: {
-                    table: rel2.to.table,
-                    columns: rel2.to.columns,
-                },
-                to: {
-                    table: rel1.to.table,
-                    columns: rel1.to.columns,
-                },
-                through: table,
-                confidence: 0.95,
-                source: 'junction_table',
-            });
-        }
-        return relations;
-    }
-    /**
-     * Detect relations where unique FK should upgrade to OneToOne.
-     */
-    detectOneToOneRelations(existingRelations) {
-        const upgrades = [];
-        for (const rel of existingRelations) {
-            if (rel.source !== 'explicit_fk')
-                continue;
-            const fromCol = rel.from.columns[0];
-            if (fromCol?.isUnique && rel.type === 'ManyToOne') {
-                // Upgrade to OneToOne
-                upgrades.push({
-                    type: 'OneToOne',
-                    from: rel.from,
-                    to: rel.to,
-                    through: rel.through,
-                    confidence: 0.9,
-                    source: 'unique_fk',
-                });
-            }
-        }
-        return upgrades;
-    }
-    /**
-     * Default singularize function (delegates to shared utility).
-     */
-    defaultSingularize(name) {
-        return singularize(name);
-    }
-}
-/**
- * Create a SmartRelationDetector for the given AST.
- */
-export function createRelationDetector(ast, options) {
-    return new SmartRelationDetector(ast, options);
-}

package/dist/querier/decorator/index.d.ts

@@ -1,4 +0,0 @@
-export * from './injectQuerier.js';
-export * from './log.js';
-export * from './serialized.js';
-export * from './transactional.js';

package/dist/querier/decorator/index.js

@@ -1,4 +0,0 @@
-export * from './injectQuerier.js';
-export * from './log.js';
-export * from './serialized.js';
-export * from './transactional.js';

package/dist/querier/decorator/injectQuerier.d.ts

@@ -1,3 +0,0 @@
-import type { Key, Type } from '../../type/index.js';
-export declare function InjectQuerier(): (proto: Record<PropertyKey, any>, key: string, index: number) => void;
-export declare function getInjectedQuerierIndex<S>(service: Type<S>, key: Key<S>): any;

package/dist/querier/decorator/injectQuerier.js

@@ -1,33 +0,0 @@
-const metadataKey = Symbol('InjectQuerier');
-export function InjectQuerier() {
-    // biome-ignore lint/suspicious/noExplicitAny: `any` is required - class prototypes don't satisfy Record<K, unknown>
-    return (proto, key, index) => {
-        if (!proto[metadataKey]) {
-            proto[metadataKey] = new WeakMap();
-        }
-        if (!proto[metadataKey].has(proto.constructor)) {
-            proto[metadataKey].set(proto.constructor, {});
-        }
-        const meta = proto[metadataKey].get(proto.constructor);
-        const isAlreadyInjected = key in meta;
-        if (isAlreadyInjected) {
-            throw new TypeError(`@InjectQuerier() can only appears once in '${proto.constructor.name}.${key}'}`);
-        }
-        meta[key] = index;
-    };
-}
-export function getInjectedQuerierIndex(service, key) {
-    let proto = service.prototype;
-    while (proto.constructor !== Object) {
-        const meta = proto[metadataKey]?.get(proto.constructor);
-        if (meta && key in meta) {
-            return meta[key];
-        }
-        const keys = Object.getOwnPropertyNames(proto);
-        const isOwnKey = keys.includes(key);
-        if (isOwnKey) {
-            return;
-        }
-        proto = Object.getPrototypeOf(proto);
-    }
-}

package/dist/querier/decorator/log.d.ts

@@ -1,32 +0,0 @@
-import type { LoggerWrapper } from '../../util/logger.js';
-/**
- * A driver error enriched with context by {@link enrichError}. `query` is always attached; `values`
- * only when the querier's logger is configured to surface them (see {@link enrichError}) - they can
- * carry sensitive data (PII, tokens, etc.) and would otherwise leak into whatever error-tracking
- * pipeline (Sentry, console.error, ...) serializes the error, without the developer opting in.
- */
-export interface QueryError extends Error {
-    query?: string;
-    values?: unknown[];
-}
-/**
- * Tags `err` with the query it failed on (as `QueryError`) and re-throws. `values` is only attached
- * when `logger?.willLogValues()` is true - i.e. the app already has query values surfacing somewhere
- * (query-level or slow-query logging), so attaching them here doesn't introduce a new leak surface.
- * Shared by every query call site - `@Log()`, streams, transaction statements - so this logic lives
- * in one place.
- *
- * Not typed `never`: an async `catch` that calls a `never`-returning function ahead of a `finally`
- * containing an `if` trips a TS control-flow bug (`TS7027 Unreachable code`) unrelated to this logic.
- */
-export declare function enrichError(err: unknown, logger: LoggerWrapper | undefined, query: string, values?: unknown[]): void;
-/**
- * Decorator that logs the execution of a query method.
- * It tracks execution time and logs the query, parameters, and duration.
- * The decorated class must have a `logger` property of type LoggerWrapper.
- *
- * On failure, also attaches the query (and values, when the logger surfaces them) to the thrown
- * error via {@link enrichError} - so that context survives even when nothing gets logged, or is
- * printed in full when the app already opted into it.
- */
-export declare function Log(): (_target: object, _key: string, propDescriptor: PropertyDescriptor) => void;

package/dist/querier/decorator/log.js

@@ -1,52 +0,0 @@
-/**
- * Tags `err` with the query it failed on (as `QueryError`) and re-throws. `values` is only attached
- * when `logger?.willLogValues()` is true - i.e. the app already has query values surfacing somewhere
- * (query-level or slow-query logging), so attaching them here doesn't introduce a new leak surface.
- * Shared by every query call site - `@Log()`, streams, transaction statements - so this logic lives
- * in one place.
- *
- * Not typed `never`: an async `catch` that calls a `never`-returning function ahead of a `finally`
- * containing an `if` trips a TS control-flow bug (`TS7027 Unreachable code`) unrelated to this logic.
- */
-export function enrichError(err, logger, query, values) {
-    if (err instanceof Error) {
-        const queryError = err;
-        queryError.query ??= query;
-        if (values !== undefined && logger?.willLogValues()) {
-            queryError.values ??= values;
-        }
-    }
-    throw err;
-}
-/**
- * Decorator that logs the execution of a query method.
- * It tracks execution time and logs the query, parameters, and duration.
- * The decorated class must have a `logger` property of type LoggerWrapper.
- *
- * On failure, also attaches the query (and values, when the logger surfaces them) to the thrown
- * error via {@link enrichError} - so that context survives even when nothing gets logged, or is
- * printed in full when the app already opted into it.
- */
-export function Log() {
-    return (_target, _key, propDescriptor) => {
-        const originalMethod = propDescriptor.value;
-        propDescriptor.value = async function (...args) {
-            const startTime = performance.now();
-            const isSql = typeof args[0] === 'string';
-            const query = isSql ? args[0] : _key;
-            const values = isSql ? args[1] : args;
-            try {
-                return await originalMethod.apply(this, args);
-            }
-            catch (err) {
-                enrichError(err, this.logger, query, values);
-            }
-            finally {
-                if (this.logger) {
-                    const duration = performance.now() - startTime;
-                    this.logger.logQuery(query, values, Math.round(duration));
-                }
-            }
-        };
-    };
-}