uql-orm 0.9.5 → 0.10.1

package/dist/querier/abstractSqlQuerier.js

@@ -0,0 +1,256 @@
+import { __decorate, __metadata } from "tslib";
+import { getMeta } from '../entity/index.js';
+import { buildUpdateResult, clone, getRelationRequestSummary, obtainAttrsPaths, throwNoPendingTransaction, throwPendingTransaction, unflatObject, unflatObjects, } from '../util/index.js';
+import { AbstractQuerier } from './abstractQuerier.js';
+import { Log, Serialized } from './decorator/index.js';
+export class AbstractSqlQuerier extends AbstractQuerier {
+    dialect;
+    extra;
+    hasPendingTransaction;
+    constructor(dialect, extra) {
+        super(extra);
+        this.dialect = dialect;
+        this.extra = extra;
+    }
+    /**
+     * Build a QueryUpdateResult with affected changes and calculated IDs.
+     */
+    buildUpdateResult(payload) {
+        return buildUpdateResult({
+            insertIdStrategy: this.dialect.insertIdStrategy,
+            ...payload,
+        });
+    }
+    /**
+     * Hook for subclasses (e.g. pool queriers) to establish a connection.
+     * Called before every query but outside the `@Log()` timer.
+     */
+    async lazyConnect() { }
+    async all(query, values) {
+        await this.lazyConnect();
+        return this.timedAll(query, values);
+    }
+    async timedAll(query, values) {
+        return this.internalAll(query, this.dialect.normalizeValues(values));
+    }
+    async run(query, values) {
+        await this.lazyConnect();
+        return this.timedRun(query, values);
+    }
+    async timedRun(query, values) {
+        return this.internalRun(query, this.dialect.normalizeValues(values));
+    }
+    async internalFindMany(entity, q) {
+        const ctx = this.dialect.createContext();
+        this.dialect.find(ctx, entity, q);
+        const res = await this.all(ctx.sql, ctx.values);
+        const founds = unflatObjects(res).map((row) => this.hydrateJsonFields(entity, row));
+        await this.fillToManyRelations(entity, founds, q.$populate);
+        return founds;
+    }
+    async *internalFindManyStream(entity, q) {
+        const meta = getMeta(entity);
+        const { toManyKeys } = getRelationRequestSummary(meta, q.$populate);
+        if (toManyKeys.length) {
+            throw new TypeError(`findManyStream does not load to-many relations (${toManyKeys.join(', ')}). Use findMany so fillToManyRelations can run, or omit those keys from the stream query.`);
+        }
+        const ctx = this.dialect.createContext();
+        this.dialect.find(ctx, entity, q);
+        const normalizedParams = this.dialect.normalizeValues(ctx.values);
+        let attrsPaths;
+        for await (const row of this.internalStream(ctx.sql, normalizedParams)) {
+            attrsPaths ??= obtainAttrsPaths(row);
+            yield this.hydrateJsonFields(entity, unflatObject(row, attrsPaths));
+        }
+    }
+    /**
+     * Internal streaming query — returns an async iterable of raw rows.
+     * Default implementation falls back to `internalAll()` then yields each row.
+     * Drivers with native cursor/streaming APIs (SQLite, Pg) should override this.
+     */
+    async *internalStream(query, values) {
+        const rows = await this.internalAll(query, this.dialect.normalizeValues(values));
+        yield* rows;
+    }
+    hydrateJsonFields(entity, dto) {
+        this.hydrateJsonFieldsRecursive(entity, dto, new WeakSet());
+        return dto;
+    }
+    hydrateJsonFieldsRecursive(entity, dto, visited) {
+        if (!dto || typeof dto !== 'object' || visited.has(dto)) {
+            return;
+        }
+        visited.add(dto);
+        const meta = getMeta(entity);
+        const row = dto;
+        for (const key in meta.fields) {
+            const field = meta.fields[key];
+            if (!field || (field.type !== 'json' && field.type !== 'jsonb')) {
+                continue;
+            }
+            const value = row[key];
+            if (typeof value !== 'string') {
+                continue;
+            }
+            try {
+                row[key] = JSON.parse(value);
+            }
+            catch {
+                // Keep the original value when the driver returns non-JSON text.
+            }
+        }
+        for (const key in meta.relations) {
+            const rel = meta.relations[key];
+            const relEntity = rel?.entity?.();
+            if (!relEntity) {
+                continue;
+            }
+            const value = row[key];
+            if (Array.isArray(value)) {
+                for (const it of value) {
+                    this.hydrateJsonFieldsRecursive(relEntity, it, visited);
+                }
+                continue;
+            }
+            if (value && typeof value === 'object') {
+                this.hydrateJsonFieldsRecursive(relEntity, value, visited);
+            }
+        }
+    }
+    async internalCount(entity, q = {}) {
+        const ctx = this.dialect.createContext();
+        this.dialect.count(ctx, entity, q);
+        const res = await this.all(ctx.sql, ctx.values);
+        return Number(res[0].count);
+    }
+    async internalAggregate(entity, q) {
+        const ctx = this.dialect.createContext();
+        this.dialect.aggregate(ctx, entity, q);
+        // biome-ignore lint/suspicious/noExplicitAny: raw DB rows satisfy QueryAggregateResult at runtime but TS can't verify
+        return this.all(ctx.sql, ctx.values);
+    }
+    async internalInsertMany(entity, payload) {
+        if (!payload?.length) {
+            return [];
+        }
+        payload = clone(payload);
+        const ctx = this.dialect.createContext();
+        this.dialect.insert(ctx, entity, payload);
+        const { ids = [] } = await this.run(ctx.sql, ctx.values);
+        const meta = getMeta(entity);
+        const idKey = meta.id;
+        const payloadIds = payload.map((it, index) => {
+            const id = ids[index];
+            it[idKey] ??= id;
+            return it[idKey];
+        });
+        await this.insertRelations(entity, payload);
+        return payloadIds;
+    }
+    async internalUpdateMany(entity, q, payload) {
+        payload = clone(payload);
+        const ctx = this.dialect.createContext();
+        this.dialect.update(ctx, entity, q, payload);
+        const { changes = 0 } = await this.run(ctx.sql, ctx.values);
+        await this.updateRelations(entity, q, payload);
+        return changes;
+    }
+    async upsertOne(entity, conflictPaths, payload) {
+        return this.upsertMany(entity, conflictPaths, [payload]);
+    }
+    async upsertMany(entity, conflictPaths, payload) {
+        if (!payload?.length) {
+            return { changes: 0 };
+        }
+        payload = clone(payload);
+        const ctx = this.dialect.createContext();
+        this.dialect.upsert(ctx, entity, conflictPaths, payload);
+        return this.run(ctx.sql, ctx.values);
+    }
+    async internalDeleteMany(entity, q, opts) {
+        const meta = getMeta(entity);
+        const findCtx = this.dialect.createContext();
+        this.dialect.find(findCtx, entity, { ...q, $select: { [meta.id]: true } });
+        const founds = await this.all(findCtx.sql, findCtx.values);
+        if (!founds.length) {
+            return 0;
+        }
+        const ids = founds.map((it) => it[meta.id]);
+        const deleteCtx = this.dialect.createContext();
+        this.dialect.delete(deleteCtx, entity, { $where: ids }, opts);
+        const { changes = 0 } = await this.run(deleteCtx.sql, deleteCtx.values);
+        await this.deleteRelations(entity, ids, opts);
+        return changes;
+    }
+    get hasOpenTransaction() {
+        return !!this.hasPendingTransaction;
+    }
+    async beginTransaction(opts) {
+        if (this.hasPendingTransaction) {
+            throwPendingTransaction();
+        }
+        await this.lazyConnect();
+        const statements = this.dialect.getBeginTransactionStatements(opts?.isolationLevel);
+        for (const sql of statements) {
+            await this.internalRun(sql);
+        }
+        this.hasPendingTransaction = true;
+    }
+    async commitTransaction() {
+        if (!this.hasPendingTransaction) {
+            throwNoPendingTransaction();
+        }
+        await this.internalRun(this.dialect.commitTransactionCommand);
+        this.hasPendingTransaction = false;
+    }
+    async rollbackTransaction() {
+        if (!this.hasPendingTransaction) {
+            throwNoPendingTransaction();
+        }
+        await this.internalRun(this.dialect.rollbackTransactionCommand);
+        this.hasPendingTransaction = false;
+    }
+}
+__decorate([
+    Serialized(),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String, Array]),
+    __metadata("design:returntype", Promise)
+], AbstractSqlQuerier.prototype, "all", null);
+__decorate([
+    Log(),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String, Array]),
+    __metadata("design:returntype", Promise)
+], AbstractSqlQuerier.prototype, "timedAll", null);
+__decorate([
+    Serialized(),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String, Array]),
+    __metadata("design:returntype", Promise)
+], AbstractSqlQuerier.prototype, "run", null);
+__decorate([
+    Log(),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String, Array]),
+    __metadata("design:returntype", Promise)
+], AbstractSqlQuerier.prototype, "timedRun", null);
+__decorate([
+    Serialized(),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", Promise)
+], AbstractSqlQuerier.prototype, "beginTransaction", null);
+__decorate([
+    Serialized(),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", Promise)
+], AbstractSqlQuerier.prototype, "commitTransaction", null);
+__decorate([
+    Serialized(),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", Promise)
+], AbstractSqlQuerier.prototype, "rollbackTransaction", null);
+//# sourceMappingURL=abstractSqlQuerier.js.map

package/dist/querier/abstractSqlQuerier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"abstractSqlQuerier.js","sourceRoot":"","sources":["../../src/querier/abstractSqlQuerier.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAiB7C,OAAO,EACL,iBAAiB,EACjB,KAAK,EACL,yBAAyB,EACzB,gBAAgB,EAChB,yBAAyB,EACzB,uBAAuB,EACvB,YAAY,EACZ,aAAa,GACd,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,GAAG,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEvD,MAAM,OAAgB,kBAAmB,SAAQ,eAAe;IAInD;IACS;IAJZ,qBAAqB,CAAW;IAExC,YACW,OAA2B,EAClB,KAAoB;QAEtC,KAAK,CAAC,KAAK,CAAC,CAAC;QAHJ,YAAO,GAAP,OAAO,CAAoB;QAClB,UAAK,GAAL,KAAK,CAAe;IAGxC,CAAC;IAYD;;OAEG;IACO,iBAAiB,CAAC,OAAiC;QAC3D,OAAO,iBAAiB,CAAC;YACvB,gBAAgB,EAAE,IAAI,CAAC,OAAO,CAAC,gBAAgB;YAC/C,GAAG,OAAO;SACX,CAAC,CAAC;IACL,CAAC;IAED;;;OAGG;IACO,KAAK,CAAC,WAAW,KAAmB,CAAC;IAGzC,AAAN,KAAK,CAAC,GAAG,CAAI,KAAa,EAAE,MAAkB;QAC5C,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QACzB,OAAO,IAAI,CAAC,QAAQ,CAAI,KAAK,EAAE,MAAM,CAAC,CAAC;IACzC,CAAC;IAGa,AAAN,KAAK,CAAC,QAAQ,CAAI,KAAa,EAAE,MAAkB;QACzD,OAAO,IAAI,CAAC,WAAW,CAAI,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC;IAC1E,CAAC;IAGK,AAAN,KAAK,CAAC,GAAG,CAAC,KAAa,EAAE,MAAkB;QACzC,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QACzB,OAAO,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IACtC,CAAC;IAGa,AAAN,KAAK,CAAC,QAAQ,CAAC,KAAa,EAAE,MAAkB;QACtD,OAAO,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC;IACvE,CAAC;IAEkB,KAAK,CAAC,gBAAgB,CAAmB,MAAe,EAAE,CAAW;QACtF,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC;QACzC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;QAClC,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,GAAG,CAAS,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;QACxD,MAAM,MAAM,GAAG,aAAa,CAAI,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,iBAAiB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC;QACvF,MAAM,IAAI,CAAC,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC;QAC5D,OAAO,MAAM,CAAC;IAChB,CAAC;IAEkB,KAAK,CAAC,CAAC,sBAAsB,CAAmB,MAAe,EAAE,CAAW;QAC7F,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;QAC7B,MAAM,EAAE,UAAU,EAAE,GAAG,yBAAyB,CAAC,IAAI,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC;QACpE,IAAI,UAAU,CAAC,MAAM,EAAE,CAAC;YACtB,MAAM,IAAI,SAAS,CACjB,mDAAmD,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,2FAA2F,CACpK,CAAC;QACJ,CAAC;QACD,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC;QACzC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;QAClC,MAAM,gBAAgB,GAAG,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAClE,IAAI,UAAgD,CAAC;QACrD,IAAI,KAAK,EAAE,MAAM,GAAG,IAAI,IAAI,CAAC,cAAc,CAAS,GAAG,CAAC,GAAG,EAAE,gBAAgB,CAAC,EAAE,CAAC;YAC/E,UAAU,KAAK,gBAAgB,CAAC,GAAG,CAAC,CAAC;YACrC,MAAM,IAAI,CAAC,iBAAiB,CAAC,MAAM,EAAE,YAAY,CAAI,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC;QACzE,CAAC;IACH,CAAC;IAED;;;;OAIG;IACO,KAAK,CAAC,CAAC,cAAc,CAAI,KAAa,EAAE,MAAkB;QAClE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,WAAW,CAAI,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC;QACpF,KAAK,CAAC,CAAC,IAAI,CAAC;IACd,CAAC;IAEO,iBAAiB,CAAmB,MAAe,EAAE,GAAM;QACjE,IAAI,CAAC,0BAA0B,CAAC,MAAM,EAAE,GAAG,EAAE,IAAI,OAAO,EAAU,CAAC,CAAC;QACpE,OAAO,GAAG,CAAC;IACb,CAAC;IAEO,0BAA0B,CAAmB,MAAe,EAAE,GAAM,EAAE,OAAwB;QACpG,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACxD,OAAO;QACT,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAEjB,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;QAC7B,MAAM,GAAG,GAAG,GAA8B,CAAC;QAE3C,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAC9B,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC/B,IAAI,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,MAAM,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,CAAC,EAAE,CAAC;gBAChE,SAAS;YACX,CAAC;YACD,MAAM,KAAK,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;YACvB,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;gBAC9B,SAAS;YACX,CAAC;YACD,IAAI,CAAC;gBACH,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YAC/B,CAAC;YAAC,MAAM,CAAC;gBACP,iEAAiE;YACnE,CAAC;QACH,CAAC;QAED,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACjC,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;YAChC,MAAM,SAAS,GAAG,GAAG,EAAE,MAAM,EAAE,EAAE,CAAC;YAClC,IAAI,CAAC,SAAS,EAAE,CAAC;gBACf,SAAS;YACX,CAAC;YACD,MAAM,KAAK,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;YACvB,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;gBACzB,KAAK,MAAM,EAAE,IAAI,KAAK,EAAE,CAAC;oBACvB,IAAI,CAAC,0BAA0B,CAAC,SAAS,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;gBAC1D,CAAC;gBACD,SAAS;YACX,CAAC;YACD,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;gBACvC,IAAI,CAAC,0BAA0B,CAAC,SAAS,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;YAC7D,CAAC;QACH,CAAC;IACH,CAAC;IAEkB,KAAK,CAAC,aAAa,CAAmB,MAAe,EAAE,IAAoB,EAAE;QAC9F,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC;QACzC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;QACnC,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,GAAG,CAAoB,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;QACnE,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IAC9B,CAAC;IAEkB,KAAK,CAAC,iBAAiB,CACxC,MAAe,EACf,CAAI;QAEJ,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC;QACzC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;QACvC,sHAAsH;QACtH,OAAO,IAAI,CAAC,GAAG,CAAM,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC5C,CAAC;IAEQ,KAAK,CAAC,kBAAkB,CAAmB,MAAe,EAAE,OAAY;QAC/E,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC;YACrB,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC;QACzB,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC;QACzC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;QAC1C,MAAM,EAAE,GAAG,GAAG,EAAE,EAAE,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;QACzD,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;QAC7B,MAAM,KAAK,GAAG,IAAI,CAAC,EAAG,CAAC;QACvB,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,EAAE;YAC3C,MAAM,EAAE,GAAG,GAAG,CAAC,KAAK,CAAoB,CAAC;YACzC,EAAE,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;YACjB,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC;QACnB,CAAC,CAAC,CAAC;QACH,MAAM,IAAI,CAAC,eAAe,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC5C,OAAO,UAA0B,CAAC;IACpC,CAAC;IAEQ,KAAK,CAAC,kBAAkB,CAAmB,MAAe,EAAE,CAAiB,EAAE,OAAyB;QAC/G,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC;QACzB,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC;QACzC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC;QAC7C,MAAM,EAAE,OAAO,GAAG,CAAC,EAAE,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;QAC5D,MAAM,IAAI,CAAC,eAAe,CAAC,MAAM,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC;QAC/C,OAAO,OAAO,CAAC;IACjB,CAAC;IAEQ,KAAK,CAAC,SAAS,CAAmB,MAAe,EAAE,aAAoC,EAAE,OAAU;QAC1G,OAAO,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,aAAa,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IAC3D,CAAC;IAEQ,KAAK,CAAC,UAAU,CAAmB,MAAe,EAAE,aAAoC,EAAE,OAAY;QAC7G,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC;YACrB,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;QACxB,CAAC;QACD,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC;QACzB,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC;QACzC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,CAAC,CAAC;QACzD,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACvC,CAAC;IAEkB,KAAK,CAAC,kBAAkB,CACzC,MAAe,EACf,CAAiB,EACjB,IAAmB;QAEnB,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;QAC7B,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC;QAC7C,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,GAAG,CAAC,EAAE,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,EAAG,CAAC,EAAE,IAAI,EAAE,EAAc,CAAC,CAAC;QACxF,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,GAAG,CAAI,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QAC9D,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;YACnB,OAAO,CAAC,CAAC;QACX,CAAC;QACD,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,EAAG,CAAC,CAAC,CAAC;QAC7C,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC;QAC/C,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE,IAAI,CAAC,CAAC;QAC9D,MAAM,EAAE,OAAO,GAAG,CAAC,EAAE,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;QACxE,MAAM,IAAI,CAAC,eAAe,CAAC,MAAM,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;QAC9C,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,IAAa,kBAAkB;QAC7B,OAAO,CAAC,CAAC,IAAI,CAAC,qBAAqB,CAAC;IACtC,CAAC;IAGc,AAAN,KAAK,CAAC,gBAAgB,CAAC,IAAyB;QACvD,IAAI,IAAI,CAAC,qBAAqB,EAAE,CAAC;YAC/B,uBAAuB,EAAE,CAAC;QAC5B,CAAC;QACD,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QACzB,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,6BAA6B,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;QACpF,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;YAC7B,MAAM,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QAC9B,CAAC;QACD,IAAI,CAAC,qBAAqB,GAAG,IAAI,CAAC;IACpC,CAAC;IAGc,AAAN,KAAK,CAAC,iBAAiB;QAC9B,IAAI,CAAC,IAAI,CAAC,qBAAqB,EAAE,CAAC;YAChC,yBAAyB,EAAE,CAAC;QAC9B,CAAC;QACD,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,wBAAwB,CAAC,CAAC;QAC9D,IAAI,CAAC,qBAAqB,GAAG,KAAK,CAAC;IACrC,CAAC;IAGc,AAAN,KAAK,CAAC,mBAAmB;QAChC,IAAI,CAAC,IAAI,CAAC,qBAAqB,EAAE,CAAC;YAChC,yBAAyB,EAAE,CAAC;QAC9B,CAAC;QACD,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,0BAA0B,CAAC,CAAC;QAChE,IAAI,CAAC,qBAAqB,GAAG,KAAK,CAAC;IACrC,CAAC;CACF;AA5NO;IADL,UAAU,EAAE;;;;6CAIZ;AAGa;IADb,GAAG,EAAE;;;;kDAGL;AAGK;IADL,UAAU,EAAE;;;;6CAIZ;AAGa;IADb,GAAG,EAAE;;;;kDAGL;AA4Kc;IADd,UAAU,EAAE;;;;0DAWZ;AAGc;IADd,UAAU,EAAE;;;;2DAOZ;AAGc;IADd,UAAU,EAAE;;;;6DAOZ"}

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

@@ -0,0 +1,5 @@
+export * from './injectQuerier.js';
+export * from './log.js';
+export * from './serialized.js';
+export * from './transactional.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/querier/decorator/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,UAAU,CAAC;AACzB,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC"}

package/dist/querier/decorator/index.js

@@ -0,0 +1,5 @@
+export * from './injectQuerier.js';
+export * from './log.js';
+export * from './serialized.js';
+export * from './transactional.js';
+//# sourceMappingURL=index.js.map

package/dist/querier/decorator/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/querier/decorator/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,UAAU,CAAC;AACzB,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC"}

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

@@ -0,0 +1,4 @@
+import type { Key, Primitive, Type } from '../../type/index.js';
+export declare function InjectQuerier(): (proto: Record<Primitive, any>, key: string, index: number) => void;
+export declare function getInjectedQuerierIndex<S>(service: Type<S>, key: Key<S>): any;
+//# sourceMappingURL=injectQuerier.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"injectQuerier.d.ts","sourceRoot":"","sources":["../../../src/querier/decorator/injectQuerier.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAIhE,wBAAgB,aAAa,KAEnB,OAAO,MAAM,CAAC,SAAS,EAAE,GAAG,CAAC,EAAE,KAAK,MAAM,EAAE,OAAO,MAAM,UAkBlE;AAED,wBAAgB,uBAAuB,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,OAmBvE"}

package/dist/querier/decorator/injectQuerier.js

@@ -0,0 +1,34 @@
+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);
+    }
+}
+//# sourceMappingURL=injectQuerier.js.map

package/dist/querier/decorator/injectQuerier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"injectQuerier.js","sourceRoot":"","sources":["../../../src/querier/decorator/injectQuerier.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,GAAG,MAAM,CAAC,eAAe,CAAC,CAAC;AAE5C,MAAM,UAAU,aAAa;IAC3B,oHAAoH;IACpH,OAAO,CAAC,KAA6B,EAAE,GAAW,EAAE,KAAa,EAAE,EAAE;QACnE,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,CAAC;YACxB,KAAK,CAAC,WAAW,CAAC,GAAG,IAAI,OAAO,EAAE,CAAC;QACrC,CAAC;QAED,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,CAAC;YAC/C,KAAK,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;QAChD,CAAC;QAED,MAAM,IAAI,GAAG,KAAK,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;QACvD,MAAM,iBAAiB,GAAG,GAAG,IAAI,IAAI,CAAC;QAEtC,IAAI,iBAAiB,EAAE,CAAC;YACtB,MAAM,IAAI,SAAS,CAAC,8CAA8C,KAAK,CAAC,WAAW,CAAC,IAAI,IAAI,GAAG,IAAI,CAAC,CAAC;QACvG,CAAC;QAED,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IACpB,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAI,OAAgB,EAAE,GAAW;IACtE,IAAI,KAAK,GAAG,OAAO,CAAC,SAAS,CAAC;IAE9B,OAAO,KAAK,CAAC,WAAW,KAAK,MAAM,EAAE,CAAC;QACpC,MAAM,IAAI,GAAG,KAAK,CAAC,WAAW,CAAC,EAAE,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;QAExD,IAAI,IAAI,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC;YACxB,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC;QACnB,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,CAAC,mBAAmB,CAAC,KAAK,CAAa,CAAC;QAC3D,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QAEpC,IAAI,QAAQ,EAAE,CAAC;YACb,OAAO;QACT,CAAC;QAED,KAAK,GAAG,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;IACvC,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,7 @@
+/**
+ * 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.
+ */
+export declare function Log(): (_target: object, _key: string, propDescriptor: PropertyDescriptor) => void;
+//# sourceMappingURL=log.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"log.d.ts","sourceRoot":"","sources":["../../../src/querier/decorator/log.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,wBAAgB,GAAG,KACT,SAAS,MAAM,EAAE,MAAM,MAAM,EAAE,gBAAgB,kBAAkB,KAAG,IAAI,CAkBjF"}

package/dist/querier/decorator/log.js

@@ -0,0 +1,27 @@
+/**
+ * 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.
+ */
+export function Log() {
+    return (_target, _key, propDescriptor) => {
+        const originalMethod = propDescriptor.value;
+        propDescriptor.value = async function (...args) {
+            if (!this.logger) {
+                return originalMethod.apply(this, args);
+            }
+            const startTime = performance.now();
+            try {
+                return await originalMethod.apply(this, args);
+            }
+            finally {
+                const duration = performance.now() - startTime;
+                const isSql = typeof args[0] === 'string';
+                const query = isSql ? args[0] : _key;
+                const values = isSql ? args[1] : args;
+                this.logger.logQuery(query, values, Math.round(duration));
+            }
+        };
+    };
+}
+//# sourceMappingURL=log.js.map

package/dist/querier/decorator/log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.js","sourceRoot":"","sources":["../../../src/querier/decorator/log.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,UAAU,GAAG;IACjB,OAAO,CAAC,OAAe,EAAE,IAAY,EAAE,cAAkC,EAAQ,EAAE;QACjF,MAAM,cAAc,GAAG,cAAc,CAAC,KAAK,CAAC;QAC5C,cAAc,CAAC,KAAK,GAAG,KAAK,WAA6C,GAAG,IAAe;YACzF,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;gBACjB,OAAO,cAAc,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YAC1C,CAAC;YACD,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;YACpC,IAAI,CAAC;gBACH,OAAO,MAAM,cAAc,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YAChD,CAAC;oBAAS,CAAC;gBACT,MAAM,QAAQ,GAAG,WAAW,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;gBAC/C,MAAM,KAAK,GAAG,OAAO,IAAI,CAAC,CAAC,CAAC,KAAK,QAAQ,CAAC;gBAC1C,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAE,IAAI,CAAC,CAAC,CAAY,CAAC,CAAC,CAAC,IAAI,CAAC;gBACjD,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,CAAE,IAAI,CAAC,CAAC,CAA2B,CAAC,CAAC,CAAC,IAAI,CAAC;gBACjE,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC;YAC5D,CAAC;QACH,CAAC,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,7 @@
+/**
+ * Decorator that ensures the decorated method is executed serially within the Querier instance.
+ * It uses a private promise queue to prevent race conditions on the database connection.
+ * Note: The decorated class must extend AbstractQuerier or implement a compatible serialize method.
+ */
+export declare function Serialized(): (_target: object, _key: string, propDescriptor: PropertyDescriptor) => void;
+//# sourceMappingURL=serialized.d.ts.map

package/dist/querier/decorator/serialized.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialized.d.ts","sourceRoot":"","sources":["../../../src/querier/decorator/serialized.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,UAAU,KAChB,SAAS,MAAM,EAAE,MAAM,MAAM,EAAE,gBAAgB,kBAAkB,KAAG,IAAI,CAMjF"}

package/dist/querier/decorator/serialized.js

@@ -0,0 +1,14 @@
+/**
+ * Decorator that ensures the decorated method is executed serially within the Querier instance.
+ * It uses a private promise queue to prevent race conditions on the database connection.
+ * Note: The decorated class must extend AbstractQuerier or implement a compatible serialize method.
+ */
+export function Serialized() {
+    return (_target, _key, propDescriptor) => {
+        const originalMethod = propDescriptor.value;
+        propDescriptor.value = function (...args) {
+            return this.serialize(() => originalMethod.apply(this, args));
+        };
+    };
+}
+//# sourceMappingURL=serialized.js.map

package/dist/querier/decorator/serialized.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialized.js","sourceRoot":"","sources":["../../../src/querier/decorator/serialized.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,UAAU,UAAU;IACxB,OAAO,CAAC,OAAe,EAAE,IAAY,EAAE,cAAkC,EAAQ,EAAE;QACjF,MAAM,cAAc,GAAG,cAAc,CAAC,KAAK,CAAC;QAC5C,cAAc,CAAC,KAAK,GAAG,UAA+D,GAAG,IAAe;YACtG,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,CAAC,cAAc,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;QAChE,CAAC,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,7 @@
+import type { IsolationLevel, QuerierPool } from '../../type/index.js';
+export declare function Transactional({ propagation, pool, isolationLevel, }?: {
+    readonly propagation?: 'supported' | 'required';
+    readonly pool?: QuerierPool;
+    readonly isolationLevel?: IsolationLevel;
+}): (target: object, key: string, propDescriptor: PropertyDescriptor) => void;
+//# sourceMappingURL=transactional.d.ts.map

package/dist/querier/decorator/transactional.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transactional.d.ts","sourceRoot":"","sources":["../../../src/querier/decorator/transactional.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAW,WAAW,EAAQ,MAAM,qBAAqB,CAAC;AAGtF,wBAAgB,aAAa,CAAC,EAC5B,WAAwB,EACxB,IAAI,EACJ,cAAc,GACf,GAAE;IACD,QAAQ,CAAC,WAAW,CAAC,EAAE,WAAW,GAAG,UAAU,CAAC;IAChD,QAAQ,CAAC,IAAI,CAAC,EAAE,WAAW,CAAC;IAC5B,QAAQ,CAAC,cAAc,CAAC,EAAE,cAAc,CAAC;CACrC,IACI,QAAQ,MAAM,EAAE,KAAK,MAAM,EAAE,gBAAgB,kBAAkB,KAAG,IAAI,CA6C/E"}

package/dist/querier/decorator/transactional.js

@@ -0,0 +1,49 @@
+import { getQuerierPool } from '../../options.js';
+import { getInjectedQuerierIndex } from './injectQuerier.js';
+export function Transactional({ propagation = 'required', pool, isolationLevel, } = {}) {
+    return (target, key, propDescriptor) => {
+        // biome-ignore lint/suspicious/noExplicitAny: decorator pattern — runtime constructor type is erased
+        const theClass = target.constructor;
+        const originalMethod = propDescriptor.value;
+        const injectedQuerierIndex = getInjectedQuerierIndex(theClass, key);
+        if (injectedQuerierIndex === undefined) {
+            throw TypeError(`missing decorator @InjectQuerier() in '${target.constructor.name}.${key}'`);
+        }
+        propDescriptor.value = async function func(...args) {
+            const params = [...args];
+            let isOwnTransaction = false;
+            let querier;
+            if (params[injectedQuerierIndex]) {
+                querier = params[injectedQuerierIndex];
+            }
+            else {
+                isOwnTransaction = true;
+                pool ??= getQuerierPool();
+                querier = await pool.getQuerier();
+                params[injectedQuerierIndex] = querier;
+            }
+            try {
+                if (propagation === 'required' && !querier.hasOpenTransaction) {
+                    await querier.beginTransaction(isolationLevel ? { isolationLevel } : undefined);
+                }
+                const resp = await originalMethod.apply(this, params);
+                if (isOwnTransaction && querier.hasOpenTransaction) {
+                    await querier.commitTransaction();
+                }
+                return resp;
+            }
+            catch (err) {
+                if (isOwnTransaction && querier.hasOpenTransaction) {
+                    await querier.rollbackTransaction();
+                }
+                throw err;
+            }
+            finally {
+                if (isOwnTransaction) {
+                    await querier.release();
+                }
+            }
+        };
+    };
+}
+//# sourceMappingURL=transactional.js.map

package/dist/querier/decorator/transactional.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transactional.js","sourceRoot":"","sources":["../../../src/querier/decorator/transactional.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAE7D,MAAM,UAAU,aAAa,CAAC,EAC5B,WAAW,GAAG,UAAU,EACxB,IAAI,EACJ,cAAc,MAKZ,EAAE;IACJ,OAAO,CAAC,MAAc,EAAE,GAAW,EAAE,cAAkC,EAAQ,EAAE;QAC/E,qGAAqG;QACrG,MAAM,QAAQ,GAAG,MAAM,CAAC,WAAwB,CAAC;QACjD,MAAM,cAAc,GAAG,cAAc,CAAC,KAAK,CAAC;QAC5C,MAAM,oBAAoB,GAAG,uBAAuB,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;QAEpE,IAAI,oBAAoB,KAAK,SAAS,EAAE,CAAC;YACvC,MAAM,SAAS,CAAC,0CAA0C,MAAM,CAAC,WAAW,CAAC,IAAI,IAAI,GAAG,GAAG,CAAC,CAAC;QAC/F,CAAC;QAED,cAAc,CAAC,KAAK,GAAG,KAAK,UAAU,IAAI,CAAe,GAAG,IAAe;YACzE,MAAM,MAAM,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC;YACzB,IAAI,gBAAgB,GAAG,KAAK,CAAC;YAC7B,IAAI,OAAgB,CAAC;YAErB,IAAI,MAAM,CAAC,oBAAoB,CAAC,EAAE,CAAC;gBACjC,OAAO,GAAG,MAAM,CAAC,oBAAoB,CAAY,CAAC;YACpD,CAAC;iBAAM,CAAC;gBACN,gBAAgB,GAAG,IAAI,CAAC;gBACxB,IAAI,KAAK,cAAc,EAAE,CAAC;gBAC1B,OAAO,GAAG,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC;gBAClC,MAAM,CAAC,oBAAoB,CAAC,GAAG,OAAO,CAAC;YACzC,CAAC;YAED,IAAI,CAAC;gBACH,IAAI,WAAW,KAAK,UAAU,IAAI,CAAC,OAAO,CAAC,kBAAkB,EAAE,CAAC;oBAC9D,MAAM,OAAO,CAAC,gBAAgB,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;gBAClF,CAAC;gBACD,MAAM,IAAI,GAAG,MAAM,cAAc,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;gBACtD,IAAI,gBAAgB,IAAI,OAAO,CAAC,kBAAkB,EAAE,CAAC;oBACnD,MAAM,OAAO,CAAC,iBAAiB,EAAE,CAAC;gBACpC,CAAC;gBACD,OAAO,IAAI,CAAC;YACd,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,IAAI,gBAAgB,IAAI,OAAO,CAAC,kBAAkB,EAAE,CAAC;oBACnD,MAAM,OAAO,CAAC,mBAAmB,EAAE,CAAC;gBACtC,CAAC;gBACD,MAAM,GAAG,CAAC;YACZ,CAAC;oBAAS,CAAC;gBACT,IAAI,gBAAgB,EAAE,CAAC;oBACrB,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC;gBAC1B,CAAC;YACH,CAAC;QACH,CAAC,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC"}

package/dist/querier/index.d.ts

@@ -0,0 +1,5 @@
+export * from './abstractQuerier.js';
+export * from './abstractQuerierPool.js';
+export * from './abstractSqlQuerier.js';
+export * from './decorator/index.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/querier/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC"}

package/dist/querier/index.js

@@ -0,0 +1,5 @@
+export * from './abstractQuerier.js';
+export * from './abstractQuerierPool.js';
+export * from './abstractSqlQuerier.js';
+export * from './decorator/index.js';
+//# sourceMappingURL=index.js.map

package/dist/querier/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/querier/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC"}

package/dist/schema/canonicalType.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Canonical Type System
+ *
+ * Provides bidirectional mapping between:
+ * - SQL types (dialect-specific)
+ * - Canonical types (dialect-agnostic)
+ * - TypeScript types (for entity generation)
+ */
+import type { AbstractDialect } from '../dialect/abstractDialect.js';
+import type { ColumnType, FieldOptions } from '../type/entity.js';
+import type { CanonicalType, TypeCategory } from './types.js';
+/** Type guard for all vector-family categories. */
+export declare function isVectorCategory(category: TypeCategory): boolean;
+/** Vector cast types supported by pgvector. */
+export type VectorCast = 'vector' | 'halfvec' | 'sparsevec';
+/**
+ * Resolve the effective vector cast type from field options.
+ * Follows the canonical type system priority: `columnType > type`.
+ */
+export declare function resolveVectorCast(field: {
+    type?: unknown;
+    columnType?: unknown;
+} | undefined): VectorCast;
+/**
+ * Parse a SQL type string into a canonical type.
+ * Handles complex types like VARCHAR(255), DECIMAL(10,2), etc.
+ */
+export declare function sqlToCanonical(sqlType: string): CanonicalType;
+/**
+ * Convert a canonical type to a SQL type string for a specific dialect instance.
+ */
+export declare function canonicalToSql(type: CanonicalType, dialect: AbstractDialect): string;
+/**
+ * Convert a canonical type to a TypeScript type string.
+ */
+export declare function canonicalToTypeScript(type: CanonicalType): string;
+/**
+ * Convert UQL FieldOptions to a canonical type.
+ */
+export declare function fieldOptionsToCanonical(options: FieldOptions, tsType?: unknown): CanonicalType;
+/**
+ * Compare two canonical types for equality.
+ * Used for schema diffing.
+ */
+export declare function areTypesEqual(a: CanonicalType, b: CanonicalType): boolean;
+/**
+ * Check if changing from type A to type B could cause data loss.
+ */
+export declare function isBreakingTypeChange(from: CanonicalType, to: CanonicalType): boolean;
+/**
+ * Get the UQL ColumnType that best matches a canonical type.
+ */
+export declare function canonicalToColumnType(type: CanonicalType): ColumnType;
+//# sourceMappingURL=canonicalType.d.ts.map

package/dist/schema/canonicalType.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canonicalType.d.ts","sourceRoot":"","sources":["../../src/schema/canonicalType.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAElE,OAAO,KAAK,EAAE,aAAa,EAAe,YAAY,EAAE,MAAM,YAAY,CAAC;AAM3E,mDAAmD;AACnD,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,YAAY,GAAG,OAAO,CAEhE;AAED,+CAA+C;AAC/C,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,SAAS,GAAG,WAAW,CAAC;AAE5D;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,UAAU,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,SAAS,GAAG,UAAU,CAKzG;AAgQD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,CA8D7D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,eAAe,GAAG,MAAM,CAuBpF;AAoCD;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,CAEjE;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,YAAY,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,aAAa,CA4D9F;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,aAAa,GAAG,OAAO,CA4CzE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,aAAa,EAAE,EAAE,EAAE,aAAa,GAAG,OAAO,CAkCpF;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,aAAa,GAAG,UAAU,CAqCrE"}