uql-orm 0.9.5 → 0.10.1

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,10 @@
+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 './relationQuery.util.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,yBAAyB,CAAC;AACxC,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC"}

package/dist/util/index.js

@@ -0,0 +1,10 @@
+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 './relationQuery.util.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,yBAAyB,CAAC;AACxC,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,10 @@
+import type { FieldKey, FieldOptions } from '../type/index.js';
+export declare function throwPendingTransaction(): never;
+export declare function throwNoPendingTransaction(): never;
+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,uBAAuB,IAAI,KAAK,CAE/C;AAED,wBAAgB,yBAAyB,IAAI,KAAK,CAEjD;AAED,wBAAgB,KAAK,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAQpC;AAED,wBAAgB,OAAO,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAI7C;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,29 @@
+export function throwPendingTransaction() {
+    throw TypeError('pending transaction');
+}
+export function throwNoPendingTransaction() {
+    throw TypeError('not a pending transaction');
+}
+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) {
+    if (typeof obj !== 'object' || obj === null)
+        return false;
+    for (const _ in obj)
+        return true;
+    return 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,uBAAuB;IACrC,MAAM,SAAS,CAAC,qBAAqB,CAAC,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,yBAAyB;IACvC,MAAM,SAAS,CAAC,2BAA2B,CAAC,CAAC;AAC/C,CAAC;AAED,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,CAAM,CAAC;IAC3C,CAAC;IACD,OAAO,EAAE,GAAG,KAAK,EAAE,CAAC;AACtB,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,GAAY;IAClC,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC1D,KAAK,MAAM,CAAC,IAAI,GAAG;QAAE,OAAO,IAAI,CAAC;IACjC,OAAO,KAAK,CAAC;AACf,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,18 @@
+import { QueryRaw, type QueryRawFn, type Scalar } from '../type/index.js';
+/**
+ * Create a raw SQL expression that bypasses the ORM's automatic escaping.
+ *
+ * **⚠️ Security:** This function bypasses SQL parameterization. Never pass
+ * unsanitized user input directly as the `value` argument — doing so may
+ * introduce SQL injection vulnerabilities. Use parameterized queries
+ * (e.g. `$where` operators) for any user-supplied data.
+ *
+ * This is a purely backend function only intended for developers who knows
+ * what they are doing.
+ *
+ * @param value the raw value or a function that receives dialect context
+ * @param alias optional alias for the expression (used in SELECT)
+ * @returns a QueryRaw instance
+ */
+export declare function raw(value: Scalar | QueryRawFn, alias?: string): QueryRaw;
+//# 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,EAAE,QAAQ,EAAE,KAAK,UAAU,EAAE,KAAK,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAE1E;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,QAAQ,CAExE"}

package/dist/util/raw.js

@@ -0,0 +1,20 @@
+import { QueryRaw } from '../type/index.js';
+/**
+ * Create a raw SQL expression that bypasses the ORM's automatic escaping.
+ *
+ * **⚠️ Security:** This function bypasses SQL parameterization. Never pass
+ * unsanitized user input directly as the `value` argument — doing so may
+ * introduce SQL injection vulnerabilities. Use parameterized queries
+ * (e.g. `$where` operators) for any user-supplied data.
+ *
+ * This is a purely backend function only intended for developers who knows
+ * what they are doing.
+ *
+ * @param value the raw value or a function that receives dialect context
+ * @param alias optional alias for the expression (used in SELECT)
+ * @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;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,GAAG,CAAC,KAA0B,EAAE,KAAc;IAC5D,OAAO,IAAI,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;AACpC,CAAC"}

package/dist/util/relationQuery.util.d.ts

@@ -0,0 +1,25 @@
+import type { EntityMeta, Query, QueryPopulate, RelationKey } from '../type/index.js';
+export type RelationRequestSummary<E> = {
+    readonly requestedKeys: RelationKey<E>[];
+    readonly joinableKeys: RelationKey<E>[];
+    readonly toManyKeys: RelationKey<E>[];
+};
+export declare function getRelationRequestSummary<E>(meta: EntityMeta<E>, populate?: QueryPopulate<E>): RelationRequestSummary<E>;
+/** True when `$populate` includes at least one relation key. */
+export declare function isPopulatingRelations<E>(meta: EntityMeta<E>, populate?: QueryPopulate<E>): boolean;
+export type RelationQuery<E extends object = object> = Query<E> & {
+    $required?: boolean;
+};
+export declare function getRelationQueryValue<E>(relKey: RelationKey<E>, populate?: QueryPopulate<E>): unknown;
+export declare function isRelationQueryObject<E extends object = object>(value: unknown): value is RelationQuery<E>;
+export type ParsedRelationQuery<E extends object = object> = {
+    query: RelationQuery<E>;
+    required: boolean;
+    /** Structured relation query object (recurse validation / nested semantics). */
+    nested: boolean;
+};
+export declare function parseRelationQueryValue<E extends object = object>(value: unknown): ParsedRelationQuery<E>;
+/** Parses the relation payload for `relKey` */
+export declare function parseRelationAtKey<E>(relKey: RelationKey<E>, populate?: QueryPopulate<E>): ParsedRelationQuery;
+export declare function forEachRequestedRelation<E extends object>(meta: EntityMeta<E>, populate: QueryPopulate<E> | undefined, fn: (relKey: RelationKey<E>, rawValue: unknown) => void): void;
+//# sourceMappingURL=relationQuery.util.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"relationQuery.util.d.ts","sourceRoot":"","sources":["../../src/util/relationQuery.util.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,aAAa,EAAe,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAGnG,MAAM,MAAM,sBAAsB,CAAC,CAAC,IAAI;IACtC,QAAQ,CAAC,aAAa,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC;IACzC,QAAQ,CAAC,YAAY,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC;IACxC,QAAQ,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC;CACvC,CAAC;AAEF,wBAAgB,yBAAyB,CAAC,CAAC,EACzC,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,EACnB,QAAQ,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC,GAC1B,sBAAsB,CAAC,CAAC,CAAC,CAuB3B;AAED,gEAAgE;AAChE,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,OAAO,CAGlG;AAED,MAAM,MAAM,aAAa,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,IAAI,KAAK,CAAC,CAAC,CAAC,GAAG;IAAE,SAAS,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AAa1F,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,OAAO,CAErG;AAED,wBAAgB,qBAAqB,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,aAAa,CAAC,CAAC,CAAC,CAG1G;AAED,MAAM,MAAM,mBAAmB,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,IAAI;IAC3D,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC;IACxB,QAAQ,EAAE,OAAO,CAAC;IAClB,gFAAgF;IAChF,MAAM,EAAE,OAAO,CAAC;CACjB,CAAC;AAEF,wBAAgB,uBAAuB,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,mBAAmB,CAAC,CAAC,CAAC,CAiBzG;AAED,+CAA+C;AAC/C,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,mBAAmB,CAE9G;AAED,wBAAgB,wBAAwB,CAAC,CAAC,SAAS,MAAM,EACvD,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,EACnB,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,SAAS,EACtC,EAAE,EAAE,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,KAAK,IAAI,GACtD,IAAI,CAIN"}

package/dist/util/relationQuery.util.js

@@ -0,0 +1,101 @@
+import { getKeys } from './object.util.js';
+export function getRelationRequestSummary(meta, populate) {
+    const requestedKeys = [];
+    const joinableKeys = [];
+    const toManyKeys = [];
+    if (!populate)
+        return { requestedKeys, joinableKeys, toManyKeys };
+    for (const key of getKeys(populate)) {
+        if (!populate[key])
+            continue;
+        const relOpts = meta.relations[key];
+        if (!relOpts)
+            continue;
+        requestedKeys.push(key);
+        if (relOpts.cardinality === '1m' || relOpts.cardinality === 'mm') {
+            toManyKeys.push(key);
+        }
+        else {
+            joinableKeys.push(key);
+        }
+    }
+    return { requestedKeys, joinableKeys, toManyKeys };
+}
+/** True when `$populate` includes at least one relation key. */
+export function isPopulatingRelations(meta, populate) {
+    if (!populate)
+        return false;
+    return getKeys(populate).some((key) => populate[key] && key in meta.relations);
+}
+// Keep in sync with nested keys allowed on `Query` / relation options (see `type/query.ts`).
+const RELATION_QUERY_BOOLEAN_KEYS = new Set(['$distinct', '$required']);
+const RELATION_QUERY_OBJECT_KEYS = new Set(['$select', '$populate', '$exclude', '$sort']);
+const RELATION_QUERY_NUMBER_KEYS = new Set(['$limit', '$skip']);
+const RELATION_QUERY_ALLOWED_KEYS = new Set([
+    ...RELATION_QUERY_BOOLEAN_KEYS,
+    ...RELATION_QUERY_OBJECT_KEYS,
+    ...RELATION_QUERY_NUMBER_KEYS,
+    '$where',
+]);
+export function getRelationQueryValue(relKey, populate) {
+    return populate?.[relKey];
+}
+export function isRelationQueryObject(value) {
+    if (!isRecord(value))
+        return false;
+    return isValidRelationQueryShape(value);
+}
+export function parseRelationQueryValue(value) {
+    if (isRelationQueryObject(value)) {
+        return { query: value, required: value.$required === true, nested: true };
+    }
+    if (Array.isArray(value)) {
+        const selectMap = {};
+        for (const key of value) {
+            selectMap[key] = 1;
+        }
+        return { query: { $select: selectMap }, required: false, nested: false };
+    }
+    if (value !== undefined && value !== null && value !== true && value !== 1) {
+        throw new TypeError(`Invalid relation query value '${String(value)}'. Expected true/1, relation query object, or relation $populate array.`);
+    }
+    return { query: {}, required: false, nested: false };
+}
+/** Parses the relation payload for `relKey` */
+export function parseRelationAtKey(relKey, populate) {
+    return parseRelationQueryValue(getRelationQueryValue(relKey, populate));
+}
+export function forEachRequestedRelation(meta, populate, fn) {
+    for (const relKey of getRelationRequestSummary(meta, populate).requestedKeys) {
+        fn(relKey, getRelationQueryValue(relKey, populate));
+    }
+}
+function isRecord(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
+function isBooleanLikeValue(value) {
+    return value === true || value === false || value === 0 || value === 1;
+}
+function isValidRelationQueryShape(query) {
+    let hasKnownKey = false;
+    for (const [key, value] of Object.entries(query)) {
+        if (!RELATION_QUERY_ALLOWED_KEYS.has(key)) {
+            return false;
+        }
+        hasKnownKey = true;
+        if (RELATION_QUERY_BOOLEAN_KEYS.has(key) && !isBooleanLikeValue(value)) {
+            return false;
+        }
+        if (RELATION_QUERY_OBJECT_KEYS.has(key) && !isRecord(value)) {
+            return false;
+        }
+        if (RELATION_QUERY_NUMBER_KEYS.has(key) && (typeof value !== 'number' || !Number.isFinite(value))) {
+            return false;
+        }
+        if (key === '$where' && !isRecord(value)) {
+            return false;
+        }
+    }
+    return hasKnownKey;
+}
+//# sourceMappingURL=relationQuery.util.js.map

package/dist/util/relationQuery.util.js.map

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

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

@@ -0,0 +1,50 @@
+import type { QueryUpdateResult, RawRow } from '../type/index.js';
+import type { PrimaryKey } from '../type/utility.js';
+export declare function flatObject<E extends object>(obj: E, pre?: string): E;
+export declare function unflatObjects<T extends object>(objects: RawRow[]): T[];
+/**
+ * Unflattens a single raw row using pre-computed attribute paths.
+ * Use this for streaming to avoid per-row array allocations.
+ */
+export declare function unflatObject<T extends object>(row: RawRow, attrsPaths: Record<string, string[]>): 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;
+/**
+ * Payload for building a QueryUpdateResult.
+ */
+export interface BuildUpdateResultPayload {
+    /** The count of rows affected by the statement. */
+    changes?: number;
+    /** The raw rows returned by the query (for RETURNING clauses). */
+    rows?: RawRow[];
+    /** The first (MySQL) or last (SQLite) auto-generated ID from the driver header. */
+    id?: PrimaryKey;
+    /** The ID strategy: 'first' (MySQL/MariaDB) or 'last' (SQLite/LibSQL/D1). */
+    insertIdStrategy?: 'first' | 'last';
+    /**
+     * Driver-specific upsert detection from the result header.
+     * MySQL/MariaDB `ON DUPLICATE KEY UPDATE` convention: 1 = insert, 2 = update, 0 = no-op.
+     */
+    upsertStatus?: number;
+}
+/**
+ * Unified utility to build a QueryUpdateResult from driver-specific results.
+ *
+ * UQL's SQL dialects always alias 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 buildUpdateResult(payload: BuildUpdateResultPayload): QueryUpdateResult;
+/**
+ * Checks if a value is of a primary key type (string, number, or bigint).
+ */
+export declare function isPrimaryKey(val: unknown): val is PrimaryKey;
+//# 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,EAAO,iBAAiB,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AACvE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAMrD,wBAAgB,UAAU,CAAC,CAAC,SAAS,MAAM,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,CAAC,CAKpE;AAcD,wBAAgB,aAAa,CAAC,CAAC,SAAS,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,CAYtE;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,CAwBnG;AAED,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,MAAM,EAAE,GAAG,EAAE,CAAC;;EAQxD;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,CAmBR;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,mDAAmD;IACnD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kEAAkE;IAClE,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,mFAAmF;IACnF,EAAE,CAAC,EAAE,UAAU,CAAC;IAChB,6EAA6E;IAC7E,gBAAgB,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IACpC;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,wBAAwB,GAAG,iBAAiB,CA8CtF;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,UAAU,CAE5D"}