uql-orm 0.1.0

package/dist/type/utility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utility.js","sourceRoot":"","sources":["../../src/type/utility.ts"],"names":[],"mappings":""}

package/dist/util/dialect.util.d.ts

@@ -0,0 +1,13 @@
+import { type CascadeType, type EntityMeta, type FieldKey, type FieldOptions, type OnFieldCallback, QueryRaw, type QuerySelect, type QuerySortMap, type QueryWhere, type QueryWhereMap, type RelationKey } from '../type/index.js';
+export type CallbackKey = keyof Pick<FieldOptions, 'onInsert' | 'onUpdate' | 'onDelete'>;
+export declare function filterFieldKeys<E>(meta: EntityMeta<E>, payload: E, callbackKey: CallbackKey): FieldKey<E>[];
+export declare function getFieldCallbackValue(val: OnFieldCallback): import("../type/utility.js").Scalar | QueryRaw;
+export declare function fillOnFields<E>(meta: EntityMeta<E>, payload: E | E[], callbackKey: CallbackKey): E[];
+export declare function filterPersistableRelationKeys<E>(meta: EntityMeta<E>, payload: E, action: CascadeType): RelationKey<E>[];
+export declare function isCascadable(action: CascadeType, configuration?: boolean | CascadeType): boolean;
+export declare function filterRelationKeys<E>(meta: EntityMeta<E>, select?: QuerySelect<E>): RelationKey<E>[];
+export declare function isSelectingRelations<E>(meta: EntityMeta<E>, select?: QuerySelect<E>): boolean;
+export declare function buildSortMap<E>(sort: QuerySortMap<E> | undefined): QuerySortMap<E>;
+export declare function augmentWhere<E>(meta: EntityMeta<E>, target?: QueryWhere<E>, source?: QueryWhere<E>): QueryWhere<E>;
+export declare function buildQueryWhereAsMap<E>(meta: EntityMeta<E>, filter?: QueryWhere<E>): QueryWhereMap<E>;
+//# sourceMappingURL=dialect.util.d.ts.map

package/dist/util/dialect.util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dialect.util.d.ts","sourceRoot":"","sources":["../../src/util/dialect.util.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,QAAQ,EACb,KAAK,YAAY,EAIjB,KAAK,eAAe,EACpB,QAAQ,EACR,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,WAAW,EACjB,MAAM,kBAAkB,CAAC;AAG1B,MAAM,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,YAAY,EAAE,UAAU,GAAG,UAAU,GAAG,UAAU,CAAC,CAAC;AAEzF,wBAAgB,eAAe,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,WAAW,EAAE,WAAW,GAAG,QAAQ,CAAC,CAAC,CAAC,EAAE,CAM3G;AAED,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,eAAe,kDAEzD;AAED,wBAAgB,YAAY,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,GAAG,CAAC,EAAE,EAAE,WAAW,EAAE,WAAW,GAAG,CAAC,EAAE,CAWpG;AAED,wBAAgB,6BAA6B,CAAC,CAAC,EAC7C,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,EACnB,OAAO,EAAE,CAAC,EACV,MAAM,EAAE,WAAW,GAClB,WAAW,CAAC,CAAC,CAAC,EAAE,CAMlB;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,WAAW,EAAE,aAAa,CAAC,EAAE,OAAO,GAAG,WAAW,GAAG,OAAO,CAKhG;AAED,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,EAAE,CAGpG;AAED,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,OAAO,CAG7F;AASD,wBAAgB,YAAY,CAAC,CAAC,EAAE,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,SAAS,GAAG,YAAY,CAAC,CAAC,CAAC,CAElF;AAED,wBAAgB,YAAY,CAAC,CAAC,EAC5B,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,EACnB,MAAM,GAAE,UAAU,CAAC,CAAC,CAAM,EAC1B,MAAM,GAAE,UAAU,CAAC,CAAC,CAAM,GACzB,UAAU,CAAC,CAAC,CAAC,CAOf;AAED,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,MAAM,GAAE,UAAU,CAAC,CAAC,CAAM,GAAG,aAAa,CAAC,CAAC,CAAC,CAUzG"}

package/dist/util/dialect.util.js

@@ -0,0 +1,82 @@
+import { QueryRaw, } from '../type/index.js';
+import { getKeys } from './object.util.js';
+export function filterFieldKeys(meta, payload, callbackKey) {
+    const persistableKeys = Object.keys(payload).filter((key) => {
+        const fieldOpts = meta.fields[key];
+        return fieldOpts && !fieldOpts.virtual && (callbackKey !== 'onUpdate' || (fieldOpts.updatable ?? true));
+    });
+    return persistableKeys;
+}
+export function getFieldCallbackValue(val) {
+    return typeof val === 'function' ? val() : val;
+}
+export function fillOnFields(meta, payload, callbackKey) {
+    const payloads = Array.isArray(payload) ? payload : [payload];
+    const keys = getKeys(meta.fields).filter((key) => meta.fields[key]?.[callbackKey]);
+    return payloads.map((it) => {
+        for (const key of keys) {
+            if (it[key] === undefined) {
+                it[key] = getFieldCallbackValue(meta.fields[key][callbackKey]);
+            }
+        }
+        return it;
+    });
+}
+export function filterPersistableRelationKeys(meta, payload, action) {
+    const keys = Object.keys(payload);
+    return keys.filter((key) => {
+        const relOpts = meta.relations[key];
+        return relOpts && isCascadable(action, relOpts.cascade);
+    });
+}
+export function isCascadable(action, configuration) {
+    if (typeof configuration === 'boolean') {
+        return configuration;
+    }
+    return configuration === action;
+}
+export function filterRelationKeys(meta, select) {
+    const keys = filterPositiveKeys(select);
+    return keys.filter((key) => key in meta.relations);
+}
+export function isSelectingRelations(meta, select) {
+    const keys = filterPositiveKeys(select);
+    return keys.some((key) => key in meta.relations);
+}
+function filterPositiveKeys(select) {
+    if (!select) {
+        return [];
+    }
+    return getKeys(select).filter((key) => select[key]);
+}
+export function buildSortMap(sort) {
+    return (sort ?? {});
+}
+export function augmentWhere(meta, target = {}, source = {}) {
+    const targetComparison = buildQueryWhereAsMap(meta, target);
+    const sourceComparison = buildQueryWhereAsMap(meta, source);
+    return {
+        ...targetComparison,
+        ...sourceComparison,
+    };
+}
+export function buildQueryWhereAsMap(meta, filter = {}) {
+    if (filter instanceof QueryRaw) {
+        return { $and: [filter] };
+    }
+    if (isIdValue(filter)) {
+        return {
+            [meta.id]: filter,
+        };
+    }
+    return filter;
+}
+function isIdValue(filter) {
+    const type = typeof filter;
+    return (type === 'string' ||
+        type === 'number' ||
+        type === 'bigint' ||
+        typeof filter.toHexString === 'function' ||
+        Array.isArray(filter));
+}
+//# sourceMappingURL=dialect.util.js.map

package/dist/util/dialect.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dialect.util.js","sourceRoot":"","sources":["../../src/util/dialect.util.ts"],"names":[],"mappings":"AAAA,OAAO,EASL,QAAQ,GAMT,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAI3C,MAAM,UAAU,eAAe,CAAI,IAAmB,EAAE,OAAU,EAAE,WAAwB;IAC1F,MAAM,eAAe,GAAI,MAAM,CAAC,IAAI,CAAC,OAAiB,CAAc,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE;QAClF,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACnC,OAAO,SAAS,IAAI,CAAC,SAAS,CAAC,OAAO,IAAI,CAAC,WAAW,KAAK,UAAU,IAAI,CAAC,SAAS,CAAC,SAAS,IAAI,IAAI,CAAC,CAAC,CAAC;IAC1G,CAAC,CAAkB,CAAC;IACpB,OAAO,eAAe,CAAC;AACzB,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,GAAoB;IACxD,OAAO,OAAO,GAAG,KAAK,UAAU,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,YAAY,CAAI,IAAmB,EAAE,OAAgB,EAAE,WAAwB;IAC7F,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;IAC9D,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,WAAW,CAAC,CAAkB,CAAC;IACpG,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE;QACzB,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,IAAI,EAAE,CAAC,GAAG,CAAC,KAAK,SAAS,EAAE,CAAC;gBAC1B,EAAE,CAAC,GAAG,CAAC,GAAG,qBAAqB,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAE,CAAC,WAAW,CAAE,CAAkB,CAAC;YACpF,CAAC;QACH,CAAC;QACD,OAAO,EAAE,CAAC;IACZ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,6BAA6B,CAC3C,IAAmB,EACnB,OAAU,EACV,MAAmB;IAEnB,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,OAAiB,CAAa,CAAC;IACxD,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE;QACzB,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QACpC,OAAO,OAAO,IAAI,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IAC1D,CAAC,CAAqB,CAAC;AACzB,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,MAAmB,EAAE,aAAqC;IACrF,IAAI,OAAO,aAAa,KAAK,SAAS,EAAE,CAAC;QACvC,OAAO,aAAa,CAAC;IACvB,CAAC;IACD,OAAO,aAAa,KAAK,MAAM,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAI,IAAmB,EAAE,MAAuB;IAChF,MAAM,IAAI,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC;IACxC,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,IAAI,IAAI,CAAC,SAAS,CAAqB,CAAC;AACzE,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAI,IAAmB,EAAE,MAAuB;IAClF,MAAM,IAAI,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC;IACxC,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,IAAI,IAAI,CAAC,SAAS,CAAC,CAAC;AACnD,CAAC;AAED,SAAS,kBAAkB,CAAI,MAAuB;IACpD,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAa,CAAC;AAClE,CAAC;AAED,MAAM,UAAU,YAAY,CAAI,IAAiC;IAC/D,OAAO,CAAC,IAAI,IAAI,EAAE,CAAoB,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,YAAY,CAC1B,IAAmB,EACnB,SAAwB,EAAE,EAC1B,SAAwB,EAAE;IAE1B,MAAM,gBAAgB,GAAG,oBAAoB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC5D,MAAM,gBAAgB,GAAG,oBAAoB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC5D,OAAO;QACL,GAAG,gBAAgB;QACnB,GAAG,gBAAgB;KACpB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAI,IAAmB,EAAE,SAAwB,EAAE;IACrF,IAAI,MAAM,YAAY,QAAQ,EAAE,CAAC;QAC/B,OAAO,EAAE,IAAI,EAAE,CAAC,MAAM,CAAC,EAAsB,CAAC;IAChD,CAAC;IACD,IAAI,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;QACtB,OAAO;YACL,CAAC,IAAI,CAAC,EAAG,CAAC,EAAE,MAAM;SACC,CAAC;IACxB,CAAC;IACD,OAAO,MAA0B,CAAC;AACpC,CAAC;AAED,SAAS,SAAS,CAAI,MAAqB;IACzC,MAAM,IAAI,GAAG,OAAO,MAAM,CAAC;IAC3B,OAAO,CACL,IAAI,KAAK,QAAQ;QACjB,IAAI,KAAK,QAAQ;QACjB,IAAI,KAAK,QAAQ;QACjB,OAAQ,MAAkB,CAAC,WAAW,KAAK,UAAU;QACrD,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CACtB,CAAC;AACJ,CAAC"}

package/dist/util/field.util.d.ts

@@ -0,0 +1,14 @@
+import type { FieldOptions } from '../type/index.js';
+/**
+ * Checks if a field type is numeric (Number, BigInt, or explicit numeric logical types)
+ */
+export declare function isNumericType(type: unknown): boolean;
+/**
+ * Checks if a field type is JSON
+ */
+export declare function isJsonType(type: unknown): boolean;
+/**
+ * Checks if a field should be treated as auto-incrementing.
+ */
+export declare function isAutoIncrement(field: FieldOptions, isPrimaryKey: boolean): boolean;
+//# sourceMappingURL=field.util.d.ts.map

package/dist/util/field.util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"field.util.d.ts","sourceRoot":"","sources":["../../src/util/field.util.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAqC,MAAM,kBAAkB,CAAC;AA0BxF;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAMpD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAKjD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,OAAO,GAAG,OAAO,CASnF"}

package/dist/util/field.util.js

@@ -0,0 +1,57 @@
+const NUMERIC_COLUMN_TYPES = {
+    int: true,
+    integer: true,
+    tinyint: true,
+    smallint: true,
+    bigint: true,
+    float: true,
+    float4: true,
+    float8: true,
+    double: true,
+    'double precision': true,
+    decimal: true,
+    numeric: true,
+    real: true,
+    serial: true,
+    smallserial: true,
+    bigserial: true,
+};
+const JSON_COLUMN_TYPES = {
+    json: true,
+    jsonb: true,
+};
+/**
+ * Checks if a field type is numeric (Number, BigInt, or explicit numeric logical types)
+ */
+export function isNumericType(type) {
+    if (type === Number || type === BigInt)
+        return true;
+    if (typeof type === 'string') {
+        return type.toLowerCase() in NUMERIC_COLUMN_TYPES;
+    }
+    return false;
+}
+/**
+ * Checks if a field type is JSON
+ */
+export function isJsonType(type) {
+    if (typeof type === 'string') {
+        return type.toLowerCase() in JSON_COLUMN_TYPES;
+    }
+    return false;
+}
+/**
+ * Checks if a field should be treated as auto-incrementing.
+ */
+export function isAutoIncrement(field, isPrimaryKey) {
+    if (field.autoIncrement === false)
+        return false;
+    if (field.autoIncrement)
+        return true;
+    const colType = field.columnType?.toLowerCase();
+    if (colType === 'serial' || colType === 'smallserial' || colType === 'bigserial')
+        return true;
+    const isNumeric = isNumericType(field.type);
+    return isPrimaryKey && isNumeric && !field.onInsert && !field.columnType;
+}
+//# sourceMappingURL=field.util.js.map

package/dist/util/field.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"field.util.js","sourceRoot":"","sources":["../../src/util/field.util.ts"],"names":[],"mappings":"AAEA,MAAM,oBAAoB,GAAG;IAC3B,GAAG,EAAE,IAAI;IACT,OAAO,EAAE,IAAI;IACb,OAAO,EAAE,IAAI;IACb,QAAQ,EAAE,IAAI;IACd,MAAM,EAAE,IAAI;IACZ,KAAK,EAAE,IAAI;IACX,MAAM,EAAE,IAAI;IACZ,MAAM,EAAE,IAAI;IACZ,MAAM,EAAE,IAAI;IACZ,kBAAkB,EAAE,IAAI;IACxB,OAAO,EAAE,IAAI;IACb,OAAO,EAAE,IAAI;IACb,IAAI,EAAE,IAAI;IACV,MAAM,EAAE,IAAI;IACZ,WAAW,EAAE,IAAI;IACjB,SAAS,EAAE,IAAI;CACmC,CAAC;AAErD,MAAM,iBAAiB,GAAG;IACxB,IAAI,EAAE,IAAI;IACV,KAAK,EAAE,IAAI;CACoC,CAAC;AAElD;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,IAAa;IACzC,IAAI,IAAI,KAAK,MAAM,IAAI,IAAI,KAAK,MAAM;QAAE,OAAO,IAAI,CAAC;IACpD,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC7B,OAAO,IAAI,CAAC,WAAW,EAAE,IAAI,oBAAoB,CAAC;IACpD,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,IAAa;IACtC,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC7B,OAAO,IAAI,CAAC,WAAW,EAAE,IAAI,iBAAiB,CAAC;IACjD,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,KAAmB,EAAE,YAAqB;IACxE,IAAI,KAAK,CAAC,aAAa,KAAK,KAAK;QAAE,OAAO,KAAK,CAAC;IAChD,IAAI,KAAK,CAAC,aAAa;QAAE,OAAO,IAAI,CAAC;IAErC,MAAM,OAAO,GAAG,KAAK,CAAC,UAAU,EAAE,WAAW,EAAE,CAAC;IAChD,IAAI,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,aAAa,IAAI,OAAO,KAAK,WAAW;QAAE,OAAO,IAAI,CAAC;IAE9F,MAAM,SAAS,GAAG,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC5C,OAAO,YAAY,IAAI,SAAS,IAAI,CAAC,KAAK,CAAC,QAAQ,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC;AAC3E,CAAC"}

package/dist/util/hook.util.d.ts

@@ -0,0 +1,15 @@
+import type { HookEvent, Querier, Type } from '../type/index.js';
+/**
+ * Context passed to lifecycle hooks, providing access to the active querier
+ * so hooks can perform DB operations within the same transaction.
+ */
+export type HookContext = {
+    readonly querier: Querier;
+};
+/**
+ * Run all registered hooks for the given event on each payload.
+ * Hooks are invoked with `this` bound to the payload via `call`,
+ * so mutations go directly to the original object.
+ */
+export declare function runHooks<E extends object>(entity: Type<E>, event: HookEvent, payloads: E[], ctx: HookContext): Promise<void>;
+//# sourceMappingURL=hook.util.d.ts.map

package/dist/util/hook.util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook.util.d.ts","sourceRoot":"","sources":["../../src/util/hook.util.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAEjE;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B,CAAC;AAEF;;;;GAIG;AACH,wBAAsB,QAAQ,CAAC,CAAC,SAAS,MAAM,EAC7C,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,EACf,KAAK,EAAE,SAAS,EAChB,QAAQ,EAAE,CAAC,EAAE,EACb,GAAG,EAAE,WAAW,GACf,OAAO,CAAC,IAAI,CAAC,CAWf"}

package/dist/util/hook.util.js

@@ -0,0 +1,20 @@
+import { getMeta } from '../entity/decorator/index.js';
+/**
+ * Run all registered hooks for the given event on each payload.
+ * Hooks are invoked with `this` bound to the payload via `call`,
+ * so mutations go directly to the original object.
+ */
+export async function runHooks(entity, event, payloads, ctx) {
+    const meta = getMeta(entity);
+    const registrations = meta.hooks?.[event];
+    if (!registrations?.length)
+        return;
+    for (const payload of payloads) {
+        for (const { methodName } of registrations) {
+            const result = entity.prototype[methodName].call(payload, ctx);
+            if (result instanceof Promise)
+                await result;
+        }
+    }
+}
+//# sourceMappingURL=hook.util.js.map

package/dist/util/hook.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook.util.js","sourceRoot":"","sources":["../../src/util/hook.util.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAC;AAWvD;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,MAAe,EACf,KAAgB,EAChB,QAAa,EACb,GAAgB;IAEhB,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7B,MAAM,aAAa,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,CAAC;IAC1C,IAAI,CAAC,aAAa,EAAE,MAAM;QAAE,OAAO;IAEnC,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,KAAK,MAAM,EAAE,UAAU,EAAE,IAAI,aAAa,EAAE,CAAC;YAC3C,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;YAC/D,IAAI,MAAM,YAAY,OAAO;gBAAE,MAAM,MAAM,CAAC;QAC9C,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/util/index.d.ts

@@ -0,0 +1,9 @@
+export * from './dialect.util.js';
+export * from './field.util.js';
+export * from './hook.util.js';
+export * from './logger.js';
+export * from './object.util.js';
+export * from './raw.js';
+export * from './sql.util.js';
+export * from './string.util.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/util/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/util/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC"}

package/dist/util/index.js

@@ -0,0 +1,9 @@
+export * from './dialect.util.js';
+export * from './field.util.js';
+export * from './hook.util.js';
+export * from './logger.js';
+export * from './object.util.js';
+export * from './raw.js';
+export * from './sql.util.js';
+export * from './string.util.js';
+//# sourceMappingURL=index.js.map

package/dist/util/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/util/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC"}

package/dist/util/logger.d.ts

@@ -0,0 +1,34 @@
+import type { Logger, LoggingOptions } from '../type/logger.js';
+import type { SlowQueryOptions } from '../type/querier.js';
+/**
+ * Default implementation of the Logger interface using console methods.
+ */
+export declare class DefaultLogger implements Logger {
+    logQuery(query: string, values?: unknown[], duration?: number): void;
+    logSlowQuery(query: string, values?: unknown[], duration?: number, logParams?: boolean): void;
+    logWarn(message: string): void;
+    logError(message: string, error?: unknown): void;
+    logInfo(message: string): void;
+    logSchema(message: string): void;
+    logMigration(message: string): void;
+    logSkippedMigration(message: string): void;
+}
+/**
+ * A wrapper class that implements the Logger interface and handles different logging options.
+ */
+export declare class LoggerWrapper implements Logger {
+    private readonly slowQuery?;
+    private readonly levels;
+    private readonly logger?;
+    private readonly loggerFunction?;
+    constructor(options: LoggingOptions, slowQuery?: SlowQueryOptions | undefined);
+    logQuery(query: string, values?: unknown[], duration?: number): void;
+    logWarn(message: string): void;
+    logError(message: string, error?: unknown): void;
+    logInfo(message: string): void;
+    logSchema(message: string): void;
+    logMigration(message: string): void;
+    logSkippedMigration(message: string): void;
+    private log;
+}
+//# sourceMappingURL=logger.d.ts.map

package/dist/util/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/util/logger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAkB,cAAc,EAAY,MAAM,mBAAmB,CAAC;AAC1F,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAY3D;;GAEG;AACH,qBAAa,aAAc,YAAW,MAAM;IAC1C,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI;IAMpE,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,SAAS,UAAO,GAAG,IAAI;IAM1F,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI9B,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,IAAI;IAIhD,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI9B,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAIhC,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAInC,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;CAG3C;AAED;;GAEG;AACH,qBAAa,aAAc,YAAW,MAAM;IAOxC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC;IAN7B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IACvC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAiB;gBAG/C,OAAO,EAAE,cAAc,EACN,SAAS,CAAC,EAAE,gBAAgB,YAAA;IAuB/C,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI;IAwBpE,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI9B,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,IAAI;IAIhD,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI9B,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAIhC,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAInC,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI1C,OAAO,CAAC,GAAG;CAYZ"}

package/dist/util/logger.js

@@ -0,0 +1,129 @@
+const DEFAULT_LOG_LEVELS = [
+    'query',
+    'info',
+    'warn',
+    'error',
+    'schema',
+    'migration',
+    'skippedMigration',
+];
+/**
+ * Default implementation of the Logger interface using console methods.
+ */
+export class DefaultLogger {
+    logQuery(query, values, duration) {
+        const time = duration !== undefined ? ` [${duration}ms]` : '';
+        const params = values?.length ? ` -- ${JSON.stringify(values)}` : '';
+        console.log(`\x1b[36mquery:\x1b[0m ${query}${params}\x1b[32m${time}\x1b[0m`);
+    }
+    logSlowQuery(query, values, duration, logParams = true) {
+        const time = duration !== undefined ? ` [${duration}ms]` : '';
+        const params = logParams && values?.length ? ` -- ${JSON.stringify(values)}` : '';
+        console.warn(`\x1b[33mslow query:\x1b[0m ${query}${params}\x1b[31m${time}\x1b[0m`);
+    }
+    logWarn(message) {
+        console.warn(`\x1b[33mwarn:\x1b[0m ${message}`);
+    }
+    logError(message, error) {
+        console.error(`\x1b[31merror:\x1b[0m ${message}`, error);
+    }
+    logInfo(message) {
+        console.info(`\x1b[34minfo:\x1b[0m ${message}`);
+    }
+    logSchema(message) {
+        console.log(`\x1b[35mschema:\x1b[0m ${message}`);
+    }
+    logMigration(message) {
+        console.log(`\x1b[32mmigration:\x1b[0m ${message}`);
+    }
+    logSkippedMigration(message) {
+        console.info(`\x1b[33mskipped migration:\x1b[0m ${message}`);
+    }
+}
+/**
+ * A wrapper class that implements the Logger interface and handles different logging options.
+ */
+export class LoggerWrapper {
+    slowQuery;
+    levels;
+    logger;
+    loggerFunction;
+    constructor(options, slowQuery) {
+        this.slowQuery = slowQuery;
+        this.levels = new Set();
+        if (options === true) {
+            this.levels = new Set(DEFAULT_LOG_LEVELS);
+            this.logger = new DefaultLogger();
+        }
+        else if (Array.isArray(options)) {
+            this.levels = new Set(options);
+            this.logger = new DefaultLogger();
+        }
+        else if (typeof options === 'function') {
+            this.levels = new Set(DEFAULT_LOG_LEVELS);
+            this.loggerFunction = options;
+        }
+        else if (options && typeof options === 'object') {
+            this.levels = new Set(DEFAULT_LOG_LEVELS);
+            this.logger = options;
+        }
+        if (slowQuery !== undefined && !this.logger && !this.loggerFunction) {
+            this.logger = new DefaultLogger();
+        }
+    }
+    logQuery(query, values, duration) {
+        if (this.slowQuery !== undefined && duration !== undefined && duration >= this.slowQuery.threshold) {
+            const logParams = this.slowQuery.logParams !== false;
+            if (this.logger?.logSlowQuery) {
+                this.logger.logSlowQuery(query, values, duration, logParams);
+                return;
+            }
+            if (this.loggerFunction) {
+                this.loggerFunction(query, logParams ? values : undefined, duration);
+                return;
+            }
+            // If slowQuery threshold is met but no specific slowQuery logger exists,
+            // it falls through to the standard logQuery below.
+        }
+        if (this.levels.has('query')) {
+            if (this.logger?.logQuery) {
+                this.logger.logQuery(query, values, duration);
+            }
+            else if (this.loggerFunction) {
+                this.loggerFunction(query, values, duration);
+            }
+        }
+    }
+    logWarn(message) {
+        this.log('warn', message);
+    }
+    logError(message, error) {
+        this.log('error', message, error);
+    }
+    logInfo(message) {
+        this.log('info', message);
+    }
+    logSchema(message) {
+        this.log('schema', message);
+    }
+    logMigration(message) {
+        this.log('migration', message);
+    }
+    logSkippedMigration(message) {
+        this.log('skippedMigration', message);
+    }
+    log(level, message, error) {
+        if (this.levels.has(level)) {
+            const method = `log${level.charAt(0).toUpperCase()}${level.slice(1)}`;
+            const args = error !== undefined ? [message, error] : [message];
+            if (this.logger?.[method]) {
+                const logFn = this.logger[method];
+                logFn(...args);
+            }
+            else if (this.loggerFunction) {
+                this.loggerFunction(...args);
+            }
+        }
+    }
+}
+//# sourceMappingURL=logger.js.map

package/dist/util/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/util/logger.ts"],"names":[],"mappings":"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"}

package/dist/util/object.util.d.ts

@@ -0,0 +1,8 @@
+import type { FieldKey, FieldOptions } from '../type/index.js';
+export declare function clone<T>(value: T): T;
+export declare function hasKeys(obj: unknown): boolean;
+export declare function getKeys<T extends object>(obj: T): (keyof T & string)[];
+export declare function getFieldKeys<E>(fields: {
+    [K in FieldKey<E>]?: FieldOptions;
+}): FieldKey<E>[];
+//# sourceMappingURL=object.util.d.ts.map

package/dist/util/object.util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"object.util.d.ts","sourceRoot":"","sources":["../../src/util/object.util.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAE/D,wBAAgB,KAAK,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAQpC;AAED,wBAAgB,OAAO,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAE7C;AAED,wBAAgB,OAAO,CAAC,CAAC,SAAS,MAAM,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,EAAE,CAEtE;AAED,wBAAgB,YAAY,CAAC,CAAC,EAC5B,MAAM,EAAE;KACL,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,YAAY;CAClC,GACA,QAAQ,CAAC,CAAC,CAAC,EAAE,CAEf"}

package/dist/util/object.util.js

@@ -0,0 +1,19 @@
+export function clone(value) {
+    if (typeof value !== 'object' || value === null) {
+        return value;
+    }
+    if (Array.isArray(value)) {
+        return value.map((it) => clone(it));
+    }
+    return { ...value };
+}
+export function hasKeys(obj) {
+    return typeof obj === 'object' && obj !== null ? Object.keys(obj).length > 0 : false;
+}
+export function getKeys(obj) {
+    return obj ? Object.keys(obj) : [];
+}
+export function getFieldKeys(fields) {
+    return getKeys(fields).filter((field) => fields[field].eager ?? true);
+}
+//# sourceMappingURL=object.util.js.map

package/dist/util/object.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"object.util.js","sourceRoot":"","sources":["../../src/util/object.util.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,KAAK,CAAI,KAAQ;IAC/B,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAChD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAiB,CAAC;IACtD,CAAC;IACD,OAAO,EAAE,GAAG,KAAK,EAAE,CAAC;AACtB,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,GAAY;IAClC,OAAO,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;AACvF,CAAC;AAED,MAAM,UAAU,OAAO,CAAmB,GAAM;IAC9C,OAAO,GAAG,CAAC,CAAC,CAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAA0B,CAAC,CAAC,CAAC,EAAE,CAAC;AAC/D,CAAC;AAED,MAAM,UAAU,YAAY,CAC1B,MAEC;IAED,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAE,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC;AACzE,CAAC"}

package/dist/util/raw.d.ts

@@ -0,0 +1,9 @@
+import { type QueryRawFn, type Scalar } from '../type/index.js';
+/**
+ * Allow using any raw value that shouldn't be automatically escaped by the ORM.
+ * @param value the raw value
+ * @param alias optional alias
+ * @returns a QueryRaw instance
+ */
+export declare function raw(value: Scalar | QueryRawFn, alias?: string): any;
+//# sourceMappingURL=raw.d.ts.map

package/dist/util/raw.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"raw.d.ts","sourceRoot":"","sources":["../../src/util/raw.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,UAAU,EAAE,KAAK,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAE1E;;;;;GAKG;AACH,wBAAgB,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,GAAG,CAEnE"}

package/dist/util/raw.js

@@ -0,0 +1,11 @@
+import { QueryRaw } from '../type/index.js';
+/**
+ * Allow using any raw value that shouldn't be automatically escaped by the ORM.
+ * @param value the raw value
+ * @param alias optional alias
+ * @returns a QueryRaw instance
+ */
+export function raw(value, alias) {
+    return new QueryRaw(value, alias);
+}
+//# sourceMappingURL=raw.js.map

package/dist/util/raw.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"raw.js","sourceRoot":"","sources":["../../src/util/raw.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAgC,MAAM,kBAAkB,CAAC;AAE1E;;;;;GAKG;AACH,MAAM,UAAU,GAAG,CAAC,KAA0B,EAAE,KAAc;IAC5D,OAAO,IAAI,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;AACpC,CAAC"}

package/dist/util/sql.util.d.ts

@@ -0,0 +1,22 @@
+import type { QueryUpdateResult, RawRow } from '../type/index.js';
+export declare function flatObject<E extends object>(obj: E, pre?: string): E;
+export declare function unflatObjects<T extends object>(objects: RawRow[]): T[];
+export declare function obtainAttrsPaths<T extends object>(row: T): {
+    [k: string]: string[];
+};
+/**
+ * Escape a SQL identifier (table name, column name, etc.)
+ * @param val the identifier to escape
+ * @param escapeIdChar the escape character to use (e.g. ` or ")
+ * @param forbidQualified whether to forbid qualified identifiers (containing dots)
+ * @param addDot whether to add a dot suffix
+ */
+export declare function escapeSqlId(val: string, escapeIdChar?: '`' | '"', forbidQualified?: boolean, addDot?: boolean): string;
+/**
+ * Extract INSERT result IDs from raw database rows.
+ *
+ * UQL's SQL dialect always aliases the entity's ID column to `id` in RETURNING clauses,
+ * so the result rows always contain an `id` property regardless of the entity's @Id() key name.
+ */
+export declare function extractInsertResult(rows: RawRow[], changes?: number): QueryUpdateResult;
+//# sourceMappingURL=sql.util.d.ts.map

package/dist/util/sql.util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sql.util.d.ts","sourceRoot":"","sources":["../../src/util/sql.util.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAmB,iBAAiB,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAGnF,wBAAgB,UAAU,CAAC,CAAC,SAAS,MAAM,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,CAAC,CAKpE;AASD,wBAAgB,aAAa,CAAC,CAAC,SAAS,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,CAqCtE;AAED,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,MAAM,EAAE,GAAG,EAAE,CAAC;;EAexD;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CACzB,GAAG,EAAE,MAAM,EACX,YAAY,GAAE,GAAG,GAAG,GAAS,EAC7B,eAAe,CAAC,EAAE,OAAO,EACzB,MAAM,CAAC,EAAE,OAAO,GACf,MAAM,CAkBR;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,iBAAiB,CAGvF"}

package/dist/util/sql.util.js

@@ -0,0 +1,88 @@
+import { getKeys, hasKeys } from './object.util.js';
+export function flatObject(obj, pre) {
+    return getKeys(obj).reduce((acc, key) => flatObjectEntry(acc, key, obj[key], typeof obj[key] === 'object' ? '' : pre), {});
+}
+function flatObjectEntry(map, key, val, pre) {
+    const prefix = pre ? `${pre}.${key}` : key;
+    return typeof val === 'object'
+        ? getKeys(val).reduce((acc, prop) => flatObjectEntry(acc, prop, val[prop], prefix), map)
+        : { ...map, [prefix]: val };
+}
+export function unflatObjects(objects) {
+    if (!Array.isArray(objects) || !objects.length) {
+        return objects;
+    }
+    const attrsPaths = obtainAttrsPaths(objects[0]);
+    if (!hasKeys(attrsPaths)) {
+        return objects;
+    }
+    return objects.map((row) => {
+        const dto = {};
+        for (const col in row) {
+            if (row[col] === null) {
+                continue;
+            }
+            const attrPath = attrsPaths[col];
+            if (attrPath) {
+                const target = attrPath.slice(0, -1).reduce((acc, key) => {
+                    if (typeof acc[key] !== 'object') {
+                        acc[key] = {};
+                    }
+                    return acc[key];
+                }, dto);
+                target[attrPath[attrPath.length - 1]] = row[col];
+            }
+            else {
+                dto[col] = row[col];
+            }
+        }
+        return dto;
+    });
+}
+export function obtainAttrsPaths(row) {
+    return getKeys(row).reduce((acc, col) => {
+        // Support both dot notation (legacy) and underscore notation (new)
+        if (col.includes('.')) {
+            acc[col] = col.split('.');
+        }
+        else if (col.includes('_') && col !== col.toUpperCase()) {
+            // Convert underscore to dot notation for nested paths
+            // Skip all-uppercase (like UPPER_CASE constants)
+            acc[col] = col.split('_');
+        }
+        return acc;
+    }, {});
+}
+/**
+ * Escape a SQL identifier (table name, column name, etc.)
+ * @param val the identifier to escape
+ * @param escapeIdChar the escape character to use (e.g. ` or ")
+ * @param forbidQualified whether to forbid qualified identifiers (containing dots)
+ * @param addDot whether to add a dot suffix
+ */
+export function escapeSqlId(val, escapeIdChar = '`', forbidQualified, addDot) {
+    if (!val) {
+        return '';
+    }
+    if (!forbidQualified && val.includes('.')) {
+        const result = val
+            .split('.')
+            .map((it) => escapeSqlId(it, escapeIdChar, true))
+            .join('.');
+        return addDot ? result + '.' : result;
+    }
+    const escaped = escapeIdChar + val.replace(new RegExp(escapeIdChar, 'g'), escapeIdChar + escapeIdChar) + escapeIdChar;
+    const suffix = addDot ? '.' : '';
+    return escaped + suffix;
+}
+/**
+ * Extract INSERT result IDs from raw database rows.
+ *
+ * UQL's SQL dialect always aliases the entity's ID column to `id` in RETURNING clauses,
+ * so the result rows always contain an `id` property regardless of the entity's @Id() key name.
+ */
+export function extractInsertResult(rows, changes) {
+    const ids = rows.map((r) => r['id']);
+    return { changes, ids, firstId: ids?.[0] };
+}
+//# sourceMappingURL=sql.util.js.map