@venizia/ignis 0.1.1-8 → 0.1.1

package/dist/connectors/relational/repositories/core/readable.js

@@ -0,0 +1,207 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReadableRelationalRepository = void 0;
+const common_1 = require("../../../../base/repositories/common");
+const omit_1 = __importDefault(require("lodash/omit"));
+const base_1 = require("./base");
+/** Read-only repository. Write operations throw errors. */
+class ReadableRelationalRepository extends base_1.RelationalBaseRepository {
+    constructor(ds, opts) {
+        super(ds, {
+            entityClass: opts?.entityClass,
+            operationScope: common_1.RepositoryOperationScopes.READ_ONLY,
+        });
+    }
+    /** Core API is ~15-20% faster but supports neither relations nor field selection. */
+    canUseCoreAPI(filter) {
+        const hasInclude = filter.include && filter.include.length > 0;
+        const hasFields = filter.fields &&
+            (Array.isArray(filter.fields)
+                ? filter.fields.length > 0
+                : Object.keys(filter.fields).length > 0);
+        return !hasInclude && !hasFields;
+    }
+    /** Executes a query through the executor's Core-API `select`. */
+    async findWithCoreAPI(opts) {
+        const { filter, isFindOne = false, options } = opts;
+        const schema = this.entity.schema;
+        const mergedFilter = this.applyDefaultFilter({
+            userFilter: filter,
+            shouldSkipDefaultFilter: options?.shouldSkipDefaultFilter,
+        });
+        const where = mergedFilter.where
+            ? this.queryDialect.toWhere({
+                tableName: this.entity.name,
+                schema,
+                where: mergedFilter.where,
+            })
+            : undefined;
+        const orderBy = mergedFilter.order
+            ? this.queryDialect.toOrderBy({
+                tableName: this.entity.name,
+                schema,
+                order: mergedFilter.order,
+            })
+            : undefined;
+        const limit = isFindOne ? 1 : mergedFilter.limit;
+        const offset = mergedFilter.skip ?? mergedFilter.offset;
+        return this.queryExecutor.select({
+            connector: this.resolveConnector({ transaction: options?.transaction }),
+            table: schema,
+            columns: this.getVisibleProperties(),
+            where,
+            orderBy,
+            limit,
+            offset,
+            lock: opts.options?.lock,
+        });
+    }
+    /** Executes a query using the executor's relational Query API (supports relations and field selection). */
+    async findWithQueryAPI(opts) {
+        const queryOptions = this.buildQuery({ filter: opts.filter });
+        return this.queryExecutor.findMany({
+            connector: this.resolveConnector({ transaction: opts.options?.transaction }),
+            entityName: this.entity.name,
+            query: queryOptions,
+            scope: this.constructor.name,
+        });
+    }
+    /** Auto-selects Core API or Query API based on filter complexity. */
+    async find(opts) {
+        const { filter, options } = opts;
+        if (options?.retry) {
+            return options.shouldQueryRange === true
+                ? this.findRangeUntil({ filter, options })
+                : this.findUntil({ filter, options });
+        }
+        const shouldQueryRange = options?.shouldQueryRange === true;
+        const baseFilter = this.applyDefaultFilter({
+            userFilter: filter,
+            shouldSkipDefaultFilter: options?.shouldSkipDefaultFilter,
+        });
+        const mergedFilter = {
+            ...baseFilter,
+            limit: baseFilter.limit ?? this.getDefaultLimit() ?? common_1.DEFAULT_LIMIT,
+        };
+        // ExtraOptions is caller-bound and otherwise unconstrained, so the spread cannot be proven to still satisfy the generic bound.
+        const effectiveOptions = { ...options, shouldSkipDefaultFilter: true };
+        const useCoreAPI = this.canUseCoreAPI(mergedFilter);
+        this.validateLockOptions({
+            lock: options?.lock,
+            transaction: options?.transaction,
+            usesQueryAPI: !useCoreAPI,
+        });
+        const dataPromise = useCoreAPI
+            ? this.findWithCoreAPI({ filter: mergedFilter, options: effectiveOptions })
+            : this.findWithQueryAPI({ filter: mergedFilter, options: effectiveOptions });
+        if (!shouldQueryRange) {
+            return dataPromise;
+        }
+        // A transaction connector wraps a single client, so running data and count in parallel would reuse it while still busy - parallel is only safe outside a transaction.
+        const countPromise = () => this.count({ where: mergedFilter.where ?? {}, options: effectiveOptions });
+        let data;
+        let total;
+        if (effectiveOptions.transaction) {
+            data = await dataPromise;
+            ({ count: total } = await countPromise());
+        }
+        else {
+            [data, { count: total }] = await Promise.all([dataPromise, countPromise()]);
+        }
+        return {
+            data,
+            range: (0, common_1.buildDataRange)({
+                skip: mergedFilter.skip,
+                offset: mergedFilter.offset,
+                dataLength: data.length,
+                total,
+            }),
+        };
+    }
+    /** Auto-selects Core API or Query API based on filter complexity. */
+    async findOne(opts) {
+        if (opts.options?.retry) {
+            return this.findOneUntil({ filter: opts.filter, options: opts.options });
+        }
+        const filter = opts.filter;
+        const useCoreAPI = this.canUseCoreAPI(filter);
+        this.validateLockOptions({
+            lock: opts?.options?.lock,
+            transaction: opts?.options?.transaction,
+            usesQueryAPI: !useCoreAPI,
+        });
+        if (useCoreAPI) {
+            const results = await this.findWithCoreAPI({
+                filter,
+                isFindOne: true,
+                options: opts?.options,
+            });
+            return results[0] ?? null;
+        }
+        const mergedFilter = this.applyDefaultFilter({
+            userFilter: filter,
+            shouldSkipDefaultFilter: opts?.options?.shouldSkipDefaultFilter,
+        });
+        const queryOptions = (0, omit_1.default)(this.buildQuery({ filter: mergedFilter }), ['limit']);
+        return this.queryExecutor.findFirst({
+            connector: this.resolveConnector({ transaction: opts?.options?.transaction }),
+            entityName: this.entity.name,
+            query: queryOptions,
+            scope: this.constructor.name,
+        });
+    }
+    /** Delegates to findOne with id in the where clause. */
+    findById(opts) {
+        return this.findOne({
+            filter: {
+                ...opts.filter,
+                where: { id: opts.id },
+            },
+            options: opts.options,
+        });
+    }
+    async count(opts) {
+        const mergedFilter = this.applyDefaultFilter({
+            userFilter: { where: opts.where },
+            shouldSkipDefaultFilter: opts.options?.shouldSkipDefaultFilter,
+        });
+        const where = this.queryDialect.toWhere({
+            tableName: this.entity.name,
+            schema: this.entity.schema,
+            where: mergedFilter.where ?? {},
+        });
+        const count = await this.queryExecutor.count({
+            connector: this.resolveConnector({ transaction: opts.options?.transaction }),
+            table: this.entity.schema,
+            where,
+        });
+        return { count };
+    }
+    async existsWith(opts) {
+        const rs = await this.count(opts);
+        return rs.count > 0;
+    }
+    create(_opts) {
+        return this.denyOperation({ methodName: this.create.name });
+    }
+    createAll(_opts) {
+        return this.denyOperation({ methodName: this.createAll.name });
+    }
+    updateById(_opts) {
+        return this.denyOperation({ methodName: this.updateById.name });
+    }
+    updateAll(_opts) {
+        return this.denyOperation({ methodName: this.updateAll.name });
+    }
+    deleteById(_opts) {
+        return this.denyOperation({ methodName: this.deleteById.name });
+    }
+    deleteAll(_opts) {
+        return this.denyOperation({ methodName: this.deleteAll.name });
+    }
+}
+exports.ReadableRelationalRepository = ReadableRelationalRepository;
+//# sourceMappingURL=readable.js.map

package/dist/connectors/relational/repositories/core/readable.js.map

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

package/dist/connectors/relational/repositories/core/soft-deletable.d.ts

@@ -0,0 +1,119 @@
+import type { IdType } from '../../../../base/models';
+import type { IExtraOptions, TCount, TFilter, TFindOneOptions, TWhere } from '../../../../base/repositories/common';
+import type { IRelationalDataSource } from '../../../../connectors/relational/datasources/common';
+import type { TTableInsert, TTableObject, TTableSchemaWithId } from '../../../../connectors/relational/models';
+import type { TNullable } from '@venizia/ignis-helpers';
+import type { AnyColumn } from 'drizzle-orm';
+import type { IRelationalExtraOptions } from '../common';
+import { DefaultRelationalRepository } from './default';
+/** Drizzle's root `AnyColumn<TPartial>` is the exact dialect-free twin of `AnyPgColumn<TPartial>`, so a `timestamp('deleted_at')` still satisfies this bound. */
+export type TDeletedAtColumn = AnyColumn<{
+    data: Date | string | null;
+}>;
+export type TSoftDeletableTableSchema = TTableSchemaWithId & {
+    deletedAt: TDeletedAtColumn;
+};
+/** Repository that soft-deletes (sets `deletedAt`) instead of physically removing rows; models need a `deletedAt` column and `defaultFilter: { where: { deletedAt: null } }` in `@model` settings. */
+export declare class SoftDeletableRelationalRepository<EntitySchema extends TSoftDeletableTableSchema = TSoftDeletableTableSchema, DataObject extends TTableObject<EntitySchema> = TTableObject<EntitySchema>, PersistObject extends TTableInsert<EntitySchema> = TTableInsert<EntitySchema>, ExtraOptions extends IExtraOptions = IRelationalExtraOptions, TDataSource extends IRelationalDataSource = IRelationalDataSource> extends DefaultRelationalRepository<EntitySchema, DataObject, PersistObject, ExtraOptions, TDataSource> {
+    private softDeletePatch;
+    /** `isStrict` is evaluated AFTER `options.retry` has been exhausted - the retry loop lives inside `super.findById` -> `findOne`, so a strict read waits out replica lag before it 404s. */
+    findById<R = DataObject>(opts: {
+        id: IdType;
+        filter?: Omit<TFilter<DataObject>, 'where'>;
+        options?: TFindOneOptions<ExtraOptions, R> & {
+            isStrict?: false;
+        };
+    }): Promise<TNullable<R>>;
+    findById<R = DataObject>(opts: {
+        id: IdType;
+        filter?: Omit<TFilter<DataObject>, 'where'>;
+        options?: TFindOneOptions<ExtraOptions, R> & {
+            isStrict?: true;
+        };
+    }): Promise<R>;
+    deleteById(opts: {
+        id: IdType;
+        options: ExtraOptions & {
+            shouldReturn: false;
+            shouldHardDelete?: boolean;
+        };
+    }): Promise<TCount & {
+        data: undefined | null;
+    }>;
+    deleteById<R = DataObject>(opts: {
+        id: IdType;
+        options?: ExtraOptions & {
+            shouldReturn?: true;
+            shouldHardDelete?: boolean;
+        };
+    }): Promise<TCount & {
+        data: R;
+    }>;
+    deleteAll(opts: {
+        where?: TWhere<DataObject>;
+        options: ExtraOptions & {
+            shouldReturn: false;
+            force?: boolean;
+            shouldHardDelete?: boolean;
+        };
+    }): Promise<TCount & {
+        data: undefined | null;
+    }>;
+    deleteAll<R = DataObject>(opts: {
+        where?: TWhere<DataObject>;
+        options?: ExtraOptions & {
+            shouldReturn?: true;
+            force?: boolean;
+            shouldHardDelete?: boolean;
+        };
+    }): Promise<TCount & {
+        data: Array<R>;
+    }>;
+    deleteBy(opts: {
+        where: TWhere<DataObject>;
+        options: ExtraOptions & {
+            shouldReturn: false;
+            force?: boolean;
+            shouldHardDelete?: boolean;
+        };
+    }): Promise<TCount & {
+        data: undefined | null;
+    }>;
+    deleteBy<R = DataObject>(opts: {
+        where: TWhere<DataObject>;
+        options?: ExtraOptions & {
+            shouldReturn?: true;
+            force?: boolean;
+            shouldHardDelete?: boolean;
+        };
+    }): Promise<TCount & {
+        data: Array<R>;
+    }>;
+    restoreById<R = DataObject>(opts: {
+        id: IdType;
+        options?: ExtraOptions & {
+            shouldReturn?: boolean;
+        };
+    }): Promise<TCount & {
+        data: TNullable<R>;
+    }>;
+    restoreAll<R = DataObject>(opts: {
+        where?: TWhere<DataObject>;
+        options?: ExtraOptions & {
+            shouldReturn?: boolean;
+            force?: boolean;
+        };
+    }): Promise<TCount & {
+        data: TNullable<Array<R>>;
+    }>;
+    restoreBy<R = DataObject>(opts: {
+        where: TWhere<DataObject>;
+        options?: ExtraOptions & {
+            shouldReturn?: boolean;
+            force?: boolean;
+        };
+    }): Promise<TCount & {
+        data: TNullable<Array<R>>;
+    }>;
+}
+//# sourceMappingURL=soft-deletable.d.ts.map

package/dist/connectors/relational/repositories/core/soft-deletable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"soft-deletable.d.ts","sourceRoot":"","sources":["../../../../../src/connectors/relational/repositories/core/soft-deletable.ts"],"names":[],"mappings":"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"}

package/dist/connectors/relational/repositories/core/soft-deletable.js

@@ -0,0 +1,85 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SoftDeletableRelationalRepository = void 0;
+const common_1 = require("../../../../base/repositories/common");
+const ignis_helpers_1 = require("@venizia/ignis-helpers");
+const default_1 = require("./default");
+/** Repository that soft-deletes (sets `deletedAt`) instead of physically removing rows; models need a `deletedAt` column and `defaultFilter: { where: { deletedAt: null } }` in `@model` settings. */
+class SoftDeletableRelationalRepository extends default_1.DefaultRelationalRepository {
+    softDeletePatch(deletedAt) {
+        return { deletedAt };
+    }
+    async findById(opts) {
+        const result = await super.findById(opts);
+        if (opts.options?.isStrict && !result) {
+            throw (0, ignis_helpers_1.getError)({
+                error: common_1.RepositoryErrors.ENTITY_NOT_FOUND,
+                message: `[${this.constructor.name}][findById] Entity with id ${opts.id} not found`,
+                messageArgs: { id: opts.id },
+            });
+        }
+        return result;
+    }
+    async deleteById(opts) {
+        if (opts.options?.shouldHardDelete) {
+            return super.deleteById(opts);
+        }
+        return this.updateById({
+            id: opts.id,
+            data: this.softDeletePatch(new Date()),
+            options: opts.options,
+        });
+    }
+    deleteAll(opts) {
+        if (opts.options?.shouldHardDelete) {
+            return super.deleteAll(opts);
+        }
+        return this.updateAll({
+            where: opts.where ?? {},
+            data: this.softDeletePatch(new Date()),
+            options: opts.options,
+        });
+    }
+    deleteBy(opts) {
+        if (opts.options?.shouldHardDelete) {
+            return super.deleteBy(opts);
+        }
+        return this.updateAll({
+            where: opts.where,
+            data: this.softDeletePatch(new Date()),
+            options: opts.options,
+        });
+    }
+    async restoreById(opts) {
+        this.validateId({ id: opts.id, operationName: 'restoreById' });
+        const { shouldReturn = true, ...restOptions } = opts.options ?? {};
+        // `updateById` is overloaded on the literal `shouldReturn: true | false` and the spread below widens it back to `boolean`, so this calls `_update` directly.
+        const options = {
+            ...restOptions,
+            shouldReturn,
+            shouldSkipDefaultFilter: true,
+        };
+        const rs = await this._update({
+            where: { id: opts.id },
+            data: this.softDeletePatch(null),
+            options,
+        });
+        return { count: rs.count, data: rs.data?.[0] ?? null };
+    }
+    async restoreAll(opts) {
+        const { shouldReturn = true, force, ...restOptions } = opts.options ?? {};
+        // `updateAll` forwards straight to `_update`, so calling it here directly is behavior-identical.
+        const options = {
+            ...restOptions,
+            shouldReturn,
+            force,
+            shouldSkipDefaultFilter: true,
+        };
+        return this._update({ where: opts.where ?? {}, data: this.softDeletePatch(null), options });
+    }
+    async restoreBy(opts) {
+        return this.restoreAll(opts);
+    }
+}
+exports.SoftDeletableRelationalRepository = SoftDeletableRelationalRepository;
+//# sourceMappingURL=soft-deletable.js.map

package/dist/connectors/relational/repositories/core/soft-deletable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"soft-deletable.js","sourceRoot":"","sources":["../../../../../src/connectors/relational/repositories/core/soft-deletable.ts"],"names":[],"mappings":"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"}

package/dist/connectors/relational/repositories/dialect/filter.d.ts

@@ -0,0 +1,191 @@
+import type { TDrizzleQueryOptions, TFields, TFilter, TInclusion, TQueryOperatorHandlers, TWhere } from '../../../../base/repositories/common';
+import { Sorts } from '../../../../base/repositories/common';
+import type { TTableObject, TTableSchemaWithId } from '../../../../connectors/relational/models/common';
+import type { TConstValue } from '@venizia/ignis-helpers';
+import { BaseHelper } from '@venizia/ignis-helpers';
+import { type SQL } from 'drizzle-orm';
+import type { TRelationConfig, TTableColumns } from '../common';
+/**
+ * Converts filter objects into Drizzle query options (where, order, columns, relations). The
+ * operator table and both JSON extractions are abstract rather than defaulted, so this tier
+ * emits no engine-specific SQL.
+ */
+export declare abstract class FilterBuilder extends BaseHelper {
+    /**
+     * Per-schema memo of resolved relations. `@model` settings are
+     * immutable after boot, so the lookup and resolver run once per schema.
+     */
+    private readonly _relationsCache;
+    constructor();
+    /** Handler table for `where` translation. Abstract so this class names no engine. */
+    protected abstract get operators(): TQueryOperatorHandlers;
+    /**
+     * Merges default and user filters. `where` merges at the TOP KEY LEVEL, never index-wise - that
+     * corrupts operator arrays. Operator-object collisions AND-compose, so a default scope can only
+     * be narrowed, and a user `undefined` never overrides a defined default. Other parts user-wins.
+     */
+    mergeFilter<T = any>(opts: {
+        defaultFilter?: TFilter<T>;
+        userFilter?: TFilter<T>;
+    }): TFilter<T>;
+    /**
+     * Top-key merge: operator-object collisions AND-compose under the reserved `and` key, merging
+     * with an existing `and` rather than clobbering it. Every other collision is user-wins.
+     */
+    private mergeWhere;
+    /**
+     * Registry lookup shared by the resolvers below. A failure degrades to no settings rather than
+     * failing the query, and is never silent - a degraded `resolveHiddenProperties` would stop
+     * hidden columns being omitted.
+     */
+    private resolveModelEntry;
+    /**
+     * Resolves hidden properties by SQL table name, not class - `toInclude` has a relation's
+     * `schema` and no class reference. Diverges from the class-keyed lookup elsewhere when
+     * `@model({ tableName })` differs from the table name.
+     */
+    resolveHiddenProperties(opts: {
+        schema: TTableSchemaWithId;
+    }): Set<string>;
+    /** Resolves default filter for a schema from MetadataRegistry. */
+    resolveDefaultFilter(opts: {
+        schema: TTableSchemaWithId;
+    }): TFilter | undefined;
+    /** Resolves default row limit for a schema from MetadataRegistry. */
+    resolveDefaultLimit(opts: {
+        schema: TTableSchemaWithId;
+    }): number | undefined;
+    /** Resolves relation configurations for a schema from MetadataRegistry. Memoized per schema. */
+    resolveRelations(opts: {
+        schema: TTableSchemaWithId;
+    }): Record<string, TRelationConfig>;
+    private resolveRelationsUncached;
+    /** Builds Drizzle query options from a filter object. */
+    build<Schema extends TTableSchemaWithId>(opts: {
+        tableName: string;
+        schema: Schema;
+        filter: TFilter<TTableObject<Schema>>;
+    }): TDrizzleQueryOptions;
+    /** Converts fields selection to Drizzle columns format. */
+    toColumns(opts: {
+        fields: TFields;
+    }): Record<string, boolean>;
+    /**
+     * Converts a where clause to a Drizzle SQL condition (supports operators, JSON paths, AND/OR).
+     */
+    toWhere<Schema extends TTableSchemaWithId>(opts: {
+        tableName: string;
+        schema: Schema;
+        where: TWhere<TTableObject<Schema>>;
+    }): SQL | undefined;
+    /**
+     * Conditions contributed by a single where key: a logical
+     * group, a JSON path, a bare value or an operator object.
+     */
+    private buildWhereKeyConditions;
+    /** Converts order strings to Drizzle SQL order expressions (supports JSON paths). */
+    toOrderBy<Schema extends TTableSchemaWithId>(opts: {
+        tableName: string;
+        schema: Schema;
+        order: string[];
+    }): SQL[];
+    /**
+     * Converts include clause to Drizzle 'with' options
+     * with nested filtering and hidden prop exclusion.
+     */
+    toInclude(opts: {
+        include: TInclusion[];
+        relations: {
+            [relationName: string]: TRelationConfig;
+        };
+    }): Record<string, true | TDrizzleQueryOptions>;
+    /**
+     * Column selection with hidden properties removed;
+     * a nullish `columns` means "every schema column".
+     */
+    private omitHiddenColumns;
+    private getColumns;
+    private isPrimitiveValue;
+    /**
+     * Protected, not private: an engine overriding `buildJsonWhereCondition` must tell an operator
+     * object from a bare value, and cannot reach the base's own walk to do it.
+     */
+    protected isOperatorObject(opts: {
+        value: any;
+    }): boolean;
+    /**
+     * Builds a SQL condition for a simple value (null, array, or
+     * equality). Protected for the same reason as `isOperatorObject`: an
+     * overridden `buildJsonWhereCondition` needs the bare-value branch.
+     */
+    protected buildValueCondition(opts: {
+        column: any;
+        value: any;
+    }): SQL;
+    protected buildOperatorConditions(opts: {
+        column: any;
+        value: Record<string, any>;
+    }): SQL[];
+    /**
+     * Negates a nested condition: `not: <operatorObject>` recurses into the
+     * operators, `not: <bareValue>` negates that value equality/array/null condition.
+     */
+    private buildNotCondition;
+    /** Builds SQL conditions for logical groups (AND/OR). */
+    private buildLogicalGroupCondition;
+    protected validateJsonColumn(opts: {
+        key: string;
+        columns: TTableColumns;
+        tableName: string;
+        methodName: string;
+    }): {
+        column: TTableColumns[string];
+        path: string[];
+    };
+    /**
+     * Whether a JSON operand needs the engine's numeric extraction: numeric comparisons, eq/ne/neq
+     * with a number, in/inq/nin with an all-number array. Only picks between the two fragments the
+     * engine passed in, so an engine with already-typed extraction returns false.
+     */
+    protected jsonNeedsNumericCast(opts: {
+        operators: Record<string, any>;
+    }): boolean;
+    /**
+     * Emits the engine JSON extraction for one where key. Abstract because the syntax is
+     * engine-owned: a default would hand the next engine one branch's SQL with no compile error.
+     */
+    protected abstract buildJsonWhereCondition(opts: {
+        key: string;
+        value: any;
+        columns: TTableColumns;
+        tableName: string;
+    }): SQL[];
+    /**
+     * A bare JSON operand IS its operator equivalent - `isOperatorObject` counts an array
+     * as primitive, so `[10, 20]` must take the same cast `{ inq: [10, 20] }` does.
+     */
+    protected toBareJsonOperators(opts: {
+        value: any;
+    }): Record<string, any>;
+    /**
+     * The cast belongs to each OPERATOR, not the object: one object-wide cast misses the operand in
+     * `{ not: { gt: 50 } }` (-> `text > integer`) and over-casts the extraction `like` shares in
+     * `{ gte: 1, like: '%a%' }` (-> `numeric ~~ text`).
+     */
+    protected buildJsonOperatorConditions(opts: {
+        jsonPath: string;
+        safeNumericCast: string;
+        operators: Record<string, any>;
+    }): SQL[];
+    /**
+     * Emits the engine's JSON extraction for one order key.
+     * Abstract for the same reason as `buildJsonWhereCondition`.
+     */
+    protected abstract buildJsonOrderBy(opts: {
+        key: string;
+        direction: TConstValue<typeof Sorts>;
+        columns: TTableColumns;
+        tableName: string;
+    }): SQL;
+}
+//# sourceMappingURL=filter.d.ts.map

package/dist/connectors/relational/repositories/dialect/filter.d.ts.map

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