uql-orm 0.9.5 → 0.10.2

package/dist/querier/abstractQuerier.js

@@ -0,0 +1,426 @@
+import { __decorate, __metadata } from "tslib";
+import { getMeta } from '../entity/decorator/index.js';
+import { augmentWhere, clone, filterPersistableRelationKeys, forEachRequestedRelation, getKeys, getRelationRequestSummary, LoggerWrapper, parseRelationAtKey, parseRelationQueryValue, runHooks, } from '../util/index.js';
+import { Serialized } from './decorator/index.js';
+/**
+ * Base class for all database queriers.
+ * It provides a standardized way to execute tasks serially to prevent race conditions on database connections.
+ */
+export class AbstractQuerier {
+    extra;
+    static emittedWarnings = new Set();
+    /** Clears process-wide warning deduplication. For tests only. */
+    static clearEmittedWarningsForTests() {
+        AbstractQuerier.emittedWarnings.clear();
+    }
+    /**
+     * Internal promise used to queue database operations.
+     * This ensures that each operation is executed serially, preventing race conditions
+     * and ensuring that the database connection is used safely across concurrent calls.
+     */
+    taskQueue = Promise.resolve();
+    logger;
+    constructor(extra) {
+        this.extra = extra;
+        this.logger = new LoggerWrapper(extra?.logger, extra?.slowQuery);
+    }
+    validateProjectionQuery(entity, q) {
+        this.validateProjectionQueryRecursive(entity, q, getMeta(entity).name ?? entity.name);
+    }
+    validateProjectionQueryRecursive(entity, q, path) {
+        const meta = getMeta(entity);
+        if (q.$select && q.$exclude) {
+            for (const [key, value] of Object.entries(q.$select)) {
+                if (key in meta.fields && value) {
+                    throw new TypeError(`Cannot combine $select and $exclude when $select includes positive scalar fields (${key}) at ${path}. Use either $select (whitelist) or $exclude (subtractive) in a single query.`);
+                }
+            }
+        }
+        forEachRequestedRelation(meta, q.$populate, (relKey, relValue) => {
+            const relOpts = meta.relations[relKey];
+            if (!relOpts?.entity)
+                return;
+            const relEntity = relOpts.entity();
+            const parsed = parseRelationQueryValue(relValue);
+            if (parsed.nested) {
+                this.validateProjectionQueryRecursive(relEntity, parsed.query, `${path}.${relKey}`);
+            }
+        });
+    }
+    /**
+     * Resolves entity from either a separate argument or from $entity field in query.
+     */
+    resolveEntityAndQuery(entityOrQuery, maybeQuery) {
+        if (typeof entityOrQuery === 'function' && entityOrQuery.prototype) {
+            return [entityOrQuery, maybeQuery ?? {}];
+        }
+        const q = entityOrQuery;
+        if (!q.$entity) {
+            throw new TypeError('$entity is required when using query-object syntax');
+        }
+        const { $entity, ...query } = q;
+        return [$entity, query];
+    }
+    findOneById(entity, id, q = {}) {
+        const meta = getMeta(entity);
+        q.$where = augmentWhere(meta, q.$where, id);
+        return this.findOne(entity, q);
+    }
+    async findOne(entityOrQuery, maybeQuery) {
+        const [entity, q] = this.resolveEntityAndQuery(entityOrQuery, maybeQuery);
+        const rows = await this.findMany(entity, { ...q, $limit: 1 });
+        return rows[0];
+    }
+    async findMany(entityOrQuery, maybeQuery) {
+        const [entity, q] = this.resolveEntityAndQuery(entityOrQuery, maybeQuery);
+        this.validateProjectionQuery(entity, q);
+        const founds = await this.internalFindMany(entity, q);
+        await this.emitHook(entity, 'afterLoad', founds);
+        return founds;
+    }
+    findManyStream(entityOrQuery, maybeQuery) {
+        const [entity, q] = this.resolveEntityAndQuery(entityOrQuery, maybeQuery);
+        this.validateProjectionQuery(entity, q);
+        return this.internalFindManyStream(entity, q);
+    }
+    async findManyAndCount(entityOrQuery, maybeQuery) {
+        const [entity, q] = this.resolveEntityAndQuery(entityOrQuery, maybeQuery);
+        this.validateProjectionQuery(entity, q);
+        const { $sort: _, $limit: _l, $skip: _s, ...qCount } = q;
+        const [founds, count] = await Promise.all([this.internalFindMany(entity, q), this.internalCount(entity, qCount)]);
+        await this.emitHook(entity, 'afterLoad', founds);
+        return [founds, count];
+    }
+    count(entityOrQuery, maybeQuery) {
+        const [entity, q] = this.resolveEntityAndQuery(entityOrQuery, maybeQuery);
+        return this.internalCount(entity, q);
+    }
+    /**
+     * Run an aggregate query.
+     */
+    aggregate(entity, q) {
+        return this.internalAggregate(entity, q);
+    }
+    async insertOne(entity, payload) {
+        const [id] = await this.insertMany(entity, [payload]);
+        return id;
+    }
+    async insertMany(entity, payload) {
+        await this.emitHook(entity, 'beforeInsert', payload);
+        const ids = await this.internalInsertMany(entity, payload);
+        await this.emitHook(entity, 'afterInsert', payload);
+        return ids;
+    }
+    updateOneById(entity, id, payload) {
+        return this.updateMany(entity, { $where: id }, payload);
+    }
+    async updateMany(entity, q, payload) {
+        await this.emitHook(entity, 'beforeUpdate', [payload]);
+        const changes = await this.internalUpdateMany(entity, q, payload);
+        await this.emitHook(entity, 'afterUpdate', [payload]);
+        return changes;
+    }
+    deleteOneById(entity, id, opts) {
+        return this.deleteMany(entity, { $where: id }, opts);
+    }
+    async deleteMany(entityOrQuery, qOrOpts, maybeOpts) {
+        let entity;
+        let q;
+        let opts;
+        if (typeof entityOrQuery === 'function' && entityOrQuery.prototype) {
+            entity = entityOrQuery;
+            q = qOrOpts;
+            opts = maybeOpts;
+        }
+        else {
+            const { $entity, ...rest } = entityOrQuery;
+            entity = $entity;
+            q = rest;
+            opts = qOrOpts;
+        }
+        await this.emitHook(entity, 'beforeDelete', []);
+        const changes = await this.internalDeleteMany(entity, q, opts);
+        await this.emitHook(entity, 'afterDelete', []);
+        return changes;
+    }
+    async saveOne(entity, payload) {
+        const [id] = await this.saveMany(entity, [payload]);
+        return id;
+    }
+    async saveMany(entity, payload) {
+        const meta = getMeta(entity);
+        const toInsert = [];
+        const toUpdate = [];
+        const existingIds = [];
+        const idKey = (meta.id ?? 'id');
+        for (const it of payload) {
+            const id = it[idKey];
+            if (!id) {
+                toInsert.push(it);
+            }
+            else if (Object.keys(it).length === 1) {
+                existingIds.push(id);
+            }
+            else {
+                toUpdate.push(it);
+            }
+        }
+        const [insertedIds, updatedIds] = await Promise.all([
+            toInsert.length ? this.insertMany(entity, toInsert) : [],
+            Promise.all(toUpdate.map(async (it) => {
+                const id = it[idKey];
+                const data = { ...it };
+                delete data[idKey];
+                await this.updateOneById(entity, id, data);
+                return id;
+            })),
+        ]);
+        return [...existingIds, ...insertedIds, ...updatedIds];
+    }
+    async fillToManyRelations(entity, payload, populate) {
+        if (!payload.length) {
+            return;
+        }
+        const meta = getMeta(entity);
+        const relKeys = getRelationRequestSummary(meta, populate).toManyKeys;
+        for (const relKey of relKeys) {
+            const relOpts = meta.relations[relKey];
+            if (!relOpts)
+                continue;
+            const relEntity = relOpts.entity();
+            const relationQuery = clone(parseRelationAtKey(relKey, populate).query);
+            if (relOpts.through) {
+                await this.fillToManyThroughRelation(payload, meta, relKey, relOpts, relationQuery);
+            }
+            else if (relOpts.cardinality === '1m') {
+                await this.fillToManyOneToMany(payload, meta, relKey, relOpts, relationQuery, relEntity);
+            }
+        }
+    }
+    async fillToManyThroughRelation(payload, meta, relKey, relOpts, relationQuery) {
+        const localField = relOpts.references[0].local;
+        const throughEntity = relOpts.through();
+        const throughMeta = getMeta(throughEntity);
+        const targetRelKey = getKeys(throughMeta.relations).find((key) => throughMeta.relations[key].references.some(({ local }) => local === relOpts.references[1].local));
+        const ids = payload.map((it) => it[meta.id]);
+        const throughFounds = await this.findMany(throughEntity, {
+            ...relationQuery,
+            $select: {
+                [localField]: true,
+            },
+            $populate: {
+                [targetRelKey]: {
+                    ...relationQuery,
+                    $required: true,
+                },
+            },
+            $where: {
+                ...relationQuery.$where,
+                [localField]: ids,
+            },
+        });
+        const founds = throughFounds.map((it) => ({
+            ...it[targetRelKey],
+            [localField]: it[localField],
+        }));
+        this.putChildrenInParents(payload, founds, meta.id, localField, relKey);
+    }
+    async fillToManyOneToMany(payload, meta, relKey, relOpts, relationQuery, relEntity) {
+        const foreignField = relOpts.references[0].foreign;
+        if (relationQuery.$select) {
+            if (!relationQuery.$select[foreignField]) {
+                relationQuery.$select[foreignField] = true;
+            }
+        }
+        const ids = payload.map((it) => it[meta.id]);
+        relationQuery.$where = { ...relationQuery.$where, [foreignField]: ids };
+        const founds = await this.findMany(relEntity, relationQuery);
+        this.putChildrenInParents(payload, founds, meta.id, foreignField, relKey);
+    }
+    putChildrenInParents(parents, children, parentIdKey, referenceKey, relKey) {
+        const childrenByParentId = {};
+        for (const child of children) {
+            const parentId = String(child[referenceKey]);
+            if (!childrenByParentId[parentId])
+                childrenByParentId[parentId] = [];
+            childrenByParentId[parentId].push(child);
+        }
+        for (const parent of parents) {
+            parent[relKey] = childrenByParentId[String(parent[parentIdKey])];
+        }
+    }
+    async insertRelations(entity, payload) {
+        const meta = getMeta(entity);
+        const entries = payload.reduce((acc, it) => {
+            const relKeys = filterPersistableRelationKeys(meta, it, 'persist');
+            if (relKeys.length > 0)
+                acc.push({ it, relKeys });
+            return acc;
+        }, []);
+        if (!entries.length)
+            return;
+        await Promise.all(entries.map(({ it, relKeys }) => Promise.all(relKeys.map((relKey) => this.saveRelation(entity, it, relKey)))));
+    }
+    async updateRelations(entity, q, payload) {
+        const meta = getMeta(entity);
+        const relKeys = filterPersistableRelationKeys(meta, payload, 'persist');
+        if (!relKeys.length) {
+            return;
+        }
+        const founds = await this.findMany(entity, { ...q, $select: { [meta.id]: true } });
+        const ids = founds.map((found) => found[meta.id]);
+        await Promise.all(ids.map((id) => Promise.all(relKeys.map((relKey) => this.saveRelation(entity, { ...payload, [meta.id]: id }, relKey, true)))));
+    }
+    async deleteRelations(entity, ids, opts) {
+        const meta = getMeta(entity);
+        const relKeys = filterPersistableRelationKeys(meta, meta.relations, 'delete');
+        for (const relKey of relKeys) {
+            const relOpts = meta.relations[relKey];
+            if (!relOpts)
+                continue;
+            const relEntity = relOpts.entity();
+            const localField = relOpts.references[0].local;
+            if (relOpts.through) {
+                const throughEntity = relOpts.through();
+                await this.deleteMany(throughEntity, { $where: { [localField]: ids } }, opts);
+            }
+            else {
+                const foreignField = relOpts.references[0].foreign;
+                await this.deleteMany(relEntity, { $where: { [foreignField]: ids } }, opts);
+            }
+        }
+    }
+    async saveRelation(entity, payload, relKey, isUpdate) {
+        const meta = getMeta(entity);
+        const id = payload[meta.id];
+        const relOpts = meta.relations[relKey];
+        if (!relOpts)
+            return;
+        const relEntity = relOpts.entity();
+        const relPayload = payload[relKey];
+        switch (relOpts.cardinality) {
+            case '1m':
+            case 'mm':
+                return this.saveToMany(relOpts, relEntity, id, relPayload, isUpdate);
+            case '11':
+                return this.saveOneToOne(relEntity, relOpts, id, relPayload);
+            case 'm1':
+                if (relPayload)
+                    return this.saveManyToOne(entity, relEntity, relOpts, id, relPayload);
+        }
+    }
+    async saveToMany(relOpts, relEntity, id, relPayload, isUpdate) {
+        const { references, through } = relOpts;
+        if (through) {
+            const localField = references[0].local;
+            const throughEntity = through();
+            if (isUpdate) {
+                await this.deleteMany(throughEntity, { $where: { [localField]: id } });
+            }
+            if (relPayload) {
+                const savedIds = await this.saveMany(relEntity, relPayload);
+                const throughBodies = savedIds.map((relId) => ({
+                    [references[0].local]: id,
+                    [references[1].local]: relId,
+                }));
+                await this.insertMany(throughEntity, throughBodies);
+            }
+            return;
+        }
+        const foreignField = references[0].foreign;
+        if (isUpdate) {
+            await this.deleteMany(relEntity, { $where: { [foreignField]: id } });
+        }
+        if (relPayload) {
+            for (const it of relPayload) {
+                it[foreignField] = id;
+            }
+            await this.saveMany(relEntity, relPayload);
+        }
+    }
+    async saveOneToOne(relEntity, relOpts, id, relPayload) {
+        const foreignField = relOpts.references[0].foreign;
+        if (relPayload === null) {
+            await this.deleteMany(relEntity, { $where: { [foreignField]: id } });
+            return;
+        }
+        await this.saveOne(relEntity, { ...relPayload, [foreignField]: id });
+    }
+    async saveManyToOne(entity, relEntity, relOpts, id, relPayload) {
+        const localField = relOpts.references[0].local;
+        const referenceId = await this.insertOne(relEntity, relPayload);
+        await this.updateOneById(entity, id, { [localField]: referenceId });
+    }
+    async transaction(callback, opts) {
+        if (this.hasOpenTransaction) {
+            return callback();
+        }
+        try {
+            await this.beginTransaction(opts);
+            const res = await callback();
+            await this.commitTransaction();
+            return res;
+        }
+        catch (err) {
+            await this.rollbackTransaction();
+            throw err;
+        }
+        finally {
+            await this.release();
+        }
+    }
+    /**
+     * Emit a lifecycle hook event for the given entity.
+     * Fires global listeners first, then entity-level hooks.
+     */
+    async emitHook(entity, event, payloads) {
+        const listeners = this.extra?.listeners;
+        const meta = getMeta(entity);
+        const registrations = meta.hooks?.[event];
+        // Fast bail-out: skip if no listeners and no entity hooks
+        if (!listeners?.length && !registrations?.length)
+            return;
+        // Fire global listeners first
+        if (listeners?.length) {
+            for (const listener of listeners) {
+                const fn = listener[event];
+                if (fn) {
+                    const result = fn({ entity, querier: this, payloads, event });
+                    if (result instanceof Promise)
+                        await result;
+                }
+            }
+        }
+        // Fire entity-level hooks
+        if (registrations?.length) {
+            await runHooks(entity, event, payloads, { querier: this });
+        }
+    }
+    async releaseIfFree() {
+        if (!this.hasOpenTransaction) {
+            await this.internalRelease();
+        }
+    }
+    /**
+     * Schedules a task to be executed serially in the querier instance.
+     * This is used by the @Serialized decorator to protect database-level operations.
+     *
+     * @param task - The async task to execute.
+     * @returns A promise that resolves with the task's result.
+     */
+    async serialize(task) {
+        const res = this.taskQueue.then(task);
+        this.taskQueue = res.catch(() => { });
+        return res;
+    }
+    async release() {
+        return this.internalRelease();
+    }
+}
+__decorate([
+    Serialized(),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", Promise)
+], AbstractQuerier.prototype, "release", null);
+//# sourceMappingURL=abstractQuerier.js.map

package/dist/querier/abstractQuerier.js.map

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

package/dist/querier/abstractQuerierPool.d.ts

@@ -0,0 +1,27 @@
+import type { AbstractDialect } from '../dialect/index.js';
+import type { ExtraOptions, Querier, QuerierPool, TransactionOptions } from '../type/index.js';
+/**
+ * Base pool: dialect id and behavior come only from the `dialect` instance (see {@link QuerierPool}).
+ */
+export declare abstract class AbstractQuerierPool<D extends AbstractDialect, Q extends Querier> implements QuerierPool<Q, D> {
+    readonly dialect: D;
+    readonly extra?: ExtraOptions | undefined;
+    constructor(dialect: D, extra?: ExtraOptions | undefined);
+    /**
+     * get a querier from the pool.
+     */
+    abstract getQuerier(): Promise<Q>;
+    /**
+     * get a querier from the pool and run the given callback inside a transaction.
+     */
+    transaction<T>(callback: (querier: Q) => Promise<T>, opts?: TransactionOptions): Promise<T>;
+    /**
+     * get a querier from the pool, run the given callback, and release the querier.
+     */
+    withQuerier<T>(callback: (querier: Q) => Promise<T>): Promise<T>;
+    /**
+     * end the pool.
+     */
+    abstract end(): Promise<void>;
+}
+//# sourceMappingURL=abstractQuerierPool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"abstractQuerierPool.d.ts","sourceRoot":"","sources":["../../src/querier/abstractQuerierPool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAE/F;;GAEG;AACH,8BAAsB,mBAAmB,CAAC,CAAC,SAAS,eAAe,EAAE,CAAC,SAAS,OAAO,CAAE,YAAW,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC;IAEhH,QAAQ,CAAC,OAAO,EAAE,CAAC;IACnB,QAAQ,CAAC,KAAK,CAAC,EAAE,YAAY;gBADpB,OAAO,EAAE,CAAC,EACV,KAAK,CAAC,EAAE,YAAY,YAAA;IAG/B;;OAEG;IACH,QAAQ,CAAC,UAAU,IAAI,OAAO,CAAC,CAAC,CAAC;IAEjC;;OAEG;IACG,WAAW,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,CAAC,CAAC;IAKjG;;OAEG;IACG,WAAW,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAStE;;OAEG;IACH,QAAQ,CAAC,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAC9B"}

package/dist/querier/abstractQuerierPool.js

@@ -0,0 +1,31 @@
+/**
+ * Base pool: dialect id and behavior come only from the `dialect` instance (see {@link QuerierPool}).
+ */
+export class AbstractQuerierPool {
+    dialect;
+    extra;
+    constructor(dialect, extra) {
+        this.dialect = dialect;
+        this.extra = extra;
+    }
+    /**
+     * get a querier from the pool and run the given callback inside a transaction.
+     */
+    async transaction(callback, opts) {
+        const querier = await this.getQuerier();
+        return querier.transaction(() => callback(querier), opts);
+    }
+    /**
+     * get a querier from the pool, run the given callback, and release the querier.
+     */
+    async withQuerier(callback) {
+        const querier = await this.getQuerier();
+        try {
+            return await callback(querier);
+        }
+        finally {
+            await querier.release();
+        }
+    }
+}
+//# sourceMappingURL=abstractQuerierPool.js.map

package/dist/querier/abstractQuerierPool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"abstractQuerierPool.js","sourceRoot":"","sources":["../../src/querier/abstractQuerierPool.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,OAAgB,mBAAmB;IAE5B;IACA;IAFX,YACW,OAAU,EACV,KAAoB;QADpB,YAAO,GAAP,OAAO,CAAG;QACV,UAAK,GAAL,KAAK,CAAe;IAC5B,CAAC;IAOJ;;OAEG;IACH,KAAK,CAAC,WAAW,CAAI,QAAoC,EAAE,IAAyB;QAClF,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC;QACxC,OAAO,OAAO,CAAC,WAAW,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,CAAC;IAC5D,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,WAAW,CAAI,QAAoC;QACvD,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC;QACxC,IAAI,CAAC;YACH,OAAO,MAAM,QAAQ,CAAC,OAAO,CAAC,CAAC;QACjC,CAAC;gBAAS,CAAC;YACT,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC;QAC1B,CAAC;IACH,CAAC;CAMF"}

package/dist/querier/abstractSqlQuerier.d.ts

@@ -0,0 +1,53 @@
+import type { AbstractSqlDialect } from '../dialect/index.js';
+import type { ExtraOptions, IdValue, Query, QueryAggregate, QueryAggregateResult, QueryConflictPaths, QueryOptions, QuerySearch, QueryUpdateResult, SqlQuerier, TransactionOptions, Type, UpdatePayload } from '../type/index.js';
+import type { BuildUpdateResultPayload } from '../util/sql.util.js';
+import { AbstractQuerier } from './abstractQuerier.js';
+export declare abstract class AbstractSqlQuerier extends AbstractQuerier implements SqlQuerier {
+    readonly dialect: AbstractSqlDialect;
+    readonly extra?: ExtraOptions | undefined;
+    private hasPendingTransaction?;
+    constructor(dialect: AbstractSqlDialect, extra?: ExtraOptions | undefined);
+    /**
+     * internal read query.
+     */
+    protected abstract internalAll<T>(query: string, values?: unknown[]): Promise<T[]>;
+    /**
+     * internal insert/update/delete/ddl query.
+     */
+    protected abstract internalRun(query: string, values?: unknown[]): Promise<QueryUpdateResult>;
+    /**
+     * Build a QueryUpdateResult with affected changes and calculated IDs.
+     */
+    protected buildUpdateResult(payload: BuildUpdateResultPayload): QueryUpdateResult;
+    /**
+     * Hook for subclasses (e.g. pool queriers) to establish a connection.
+     * Called before every query but outside the `@Log()` timer.
+     */
+    protected lazyConnect(): Promise<void>;
+    all<T>(query: string, values?: unknown[]): Promise<T[]>;
+    private timedAll;
+    run(query: string, values?: unknown[]): Promise<QueryUpdateResult>;
+    private timedRun;
+    protected internalFindMany<E extends object>(entity: Type<E>, q: Query<E>): Promise<E[]>;
+    protected internalFindManyStream<E extends object>(entity: Type<E>, q: Query<E>): AsyncGenerator<Awaited<E>, void, unknown>;
+    /**
+     * 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.
+     */
+    protected internalStream<T>(query: string, values?: unknown[]): AsyncIterable<T>;
+    private hydrateJsonFields;
+    private hydrateJsonFieldsRecursive;
+    protected internalCount<E extends object>(entity: Type<E>, q?: QuerySearch<E>): Promise<number>;
+    protected internalAggregate<E extends object, Q extends QueryAggregate<E>>(entity: Type<E>, q: Q): Promise<QueryAggregateResult<E, Q['$group']>[]>;
+    internalInsertMany<E extends object>(entity: Type<E>, payload: E[]): Promise<IdValue<E>[]>;
+    internalUpdateMany<E extends object>(entity: Type<E>, q: QuerySearch<E>, payload: UpdatePayload<E>): Promise<number>;
+    upsertOne<E extends object>(entity: Type<E>, conflictPaths: QueryConflictPaths<E>, payload: E): Promise<QueryUpdateResult>;
+    upsertMany<E extends object>(entity: Type<E>, conflictPaths: QueryConflictPaths<E>, payload: E[]): Promise<QueryUpdateResult>;
+    protected internalDeleteMany<E extends object>(entity: Type<E>, q: QuerySearch<E>, opts?: QueryOptions): Promise<number>;
+    get hasOpenTransaction(): boolean;
+    beginTransaction(opts?: TransactionOptions): Promise<void>;
+    commitTransaction(): Promise<void>;
+    rollbackTransaction(): Promise<void>;
+}
+//# sourceMappingURL=abstractSqlQuerier.d.ts.map

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

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