@venizia/ignis-connectors 0.2.0-0

package/dist/cjs/relational/core/repositories/core/readable.d.ts

@@ -0,0 +1,164 @@
+import type { IdType } from '@venizia/ignis-kernel';
+import type { IExtraOptions, TCount, TDataWithRange, TFilter, TFindOneOptions, TFindOptions, TFindRangeOptions, TWhere } from '@venizia/ignis-kernel';
+import type { IRelationalDataSource } from '../../../../relational/core/datasources/common';
+import type { BaseRelationalEntity, TTableInsert, TTableObject, TTableSchemaWithId } from '../../../../relational/core/models';
+import type { TClass, TNullable } from '@venizia/ignis-helpers/common';
+import type { IRelationalExtraOptions } from '../common';
+import { RelationalBaseRepository } from './base';
+/** Read-only repository. Write operations throw errors. */
+export declare class ReadableRelationalRepository<EntitySchema extends TTableSchemaWithId = TTableSchemaWithId, DataObject extends TTableObject<EntitySchema> = TTableObject<EntitySchema>, PersistObject extends TTableInsert<EntitySchema> = TTableInsert<EntitySchema>, ExtraOptions extends IExtraOptions = IRelationalExtraOptions, TDataSource extends IRelationalDataSource = IRelationalDataSource> extends RelationalBaseRepository<EntitySchema, DataObject, PersistObject, ExtraOptions, TDataSource> {
+    constructor(ds?: TDataSource, opts?: {
+        entityClass?: TClass<BaseRelationalEntity<EntitySchema>>;
+    });
+    /** Core API is ~15-20% faster but supports neither relations nor field selection. */
+    protected canUseCoreAPI(filter: TFilter<DataObject>): boolean;
+    /** Executes a query through the executor's Core-API `select`. */
+    protected findWithCoreAPI<R = DataObject>(opts: {
+        filter: TFilter<DataObject>;
+        isFindOne?: boolean;
+        options?: ExtraOptions;
+    }): Promise<Array<R>>;
+    /** Executes a query using the executor's relational Query API (supports relations and field selection). */
+    protected findWithQueryAPI<R = DataObject>(opts: {
+        filter: TFilter<DataObject>;
+        options?: ExtraOptions;
+    }): Promise<Array<R>>;
+    find<R = DataObject>(opts: {
+        filter: TFilter<DataObject>;
+        options: TFindRangeOptions<ExtraOptions, R>;
+    }): Promise<TDataWithRange<R>>;
+    find<R = DataObject>(opts: {
+        filter: TFilter<DataObject>;
+        options?: TFindOptions<ExtraOptions, R>;
+    }): Promise<Array<R>>;
+    /** Auto-selects Core API or Query API based on filter complexity. */
+    findOne<R = DataObject>(opts: {
+        filter: TFilter<DataObject>;
+        options?: TFindOneOptions<ExtraOptions, R>;
+    }): Promise<TNullable<R>>;
+    /** Delegates to findOne with id in the where clause. */
+    findById<R = DataObject>(opts: {
+        id: IdType;
+        filter?: Omit<TFilter<DataObject>, 'where'>;
+        options?: TFindOneOptions<ExtraOptions, R>;
+    }): Promise<TNullable<R>>;
+    count(opts: {
+        where: TWhere<DataObject>;
+        options?: ExtraOptions;
+    }): Promise<TCount>;
+    existsWith(opts: {
+        where: TWhere<DataObject>;
+        options?: ExtraOptions;
+    }): Promise<boolean>;
+    /** @throws Error - disabled in read-only repository. */
+    create(opts: {
+        data: PersistObject;
+        options: ExtraOptions & {
+            shouldReturn: false;
+        };
+    }): Promise<TCount & {
+        data: undefined | null;
+    }>;
+    create(opts: {
+        data: PersistObject;
+        options?: ExtraOptions & {
+            shouldReturn?: true;
+        };
+    }): Promise<TCount & {
+        data: DataObject;
+    }>;
+    /** @throws Error - disabled in read-only repository. */
+    createAll(opts: {
+        data: Array<PersistObject>;
+        options: ExtraOptions & {
+            shouldReturn: false;
+        };
+    }): Promise<TCount & {
+        data: undefined | null;
+    }>;
+    createAll(opts: {
+        data: Array<PersistObject>;
+        options?: ExtraOptions & {
+            shouldReturn?: true;
+        };
+    }): Promise<TCount & {
+        data: Array<DataObject>;
+    }>;
+    /** @throws Error - disabled in read-only repository. */
+    updateById(opts: {
+        id: IdType;
+        data: Partial<PersistObject>;
+        options: ExtraOptions & {
+            shouldReturn: false;
+        };
+    }): Promise<TCount & {
+        data: undefined | null;
+    }>;
+    updateById<R = DataObject>(opts: {
+        id: IdType;
+        data: Partial<R>;
+        options?: ExtraOptions & {
+            shouldReturn?: true;
+        };
+    }): Promise<TCount & {
+        data: DataObject;
+    }>;
+    /** @throws Error - disabled in read-only repository. */
+    updateAll(opts: {
+        data: Partial<PersistObject>;
+        where: TWhere<DataObject>;
+        options: ExtraOptions & {
+            shouldReturn: false;
+            force?: boolean;
+        };
+    }): Promise<TCount & {
+        data: undefined | null;
+    }>;
+    updateAll<R = DataObject>(opts: {
+        data: Partial<PersistObject>;
+        where: TWhere<DataObject>;
+        options?: ExtraOptions & {
+            shouldReturn?: true;
+            force?: boolean;
+        };
+    }): Promise<TCount & {
+        data: Array<R>;
+    }>;
+    /** @throws Error - disabled in read-only repository. */
+    deleteById(opts: {
+        id: IdType;
+        options: ExtraOptions & {
+            shouldReturn: false;
+        };
+    }): Promise<TCount & {
+        data: undefined | null;
+    }>;
+    deleteById<R = DataObject>(opts: {
+        id: IdType;
+        options?: ExtraOptions & {
+            shouldReturn?: true;
+        };
+    }): Promise<TCount & {
+        data: R;
+    }>;
+    /** @throws Error - disabled in read-only repository. */
+    deleteAll(opts: {
+        where?: TWhere<DataObject>;
+        options: ExtraOptions & {
+            shouldReturn: false;
+            force?: boolean;
+        };
+    }): Promise<TCount & {
+        data: undefined | null;
+    }>;
+    deleteAll<R = DataObject>(opts: {
+        where?: TWhere<DataObject>;
+        options?: ExtraOptions & {
+            shouldReturn?: true;
+            force?: boolean;
+        };
+    }): Promise<TCount & {
+        data: Array<R>;
+    }>;
+}
+//# sourceMappingURL=readable.d.ts.map

package/dist/cjs/relational/core/repositories/core/readable.d.ts.map

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

package/dist/cjs/relational/core/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 ignis_kernel_1 = require("@venizia/ignis-kernel");
+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: ignis_kernel_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() ?? ignis_kernel_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, ignis_kernel_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/cjs/relational/core/repositories/core/readable.js.map

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

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

@@ -0,0 +1,119 @@
+import type { IdType } from '@venizia/ignis-kernel';
+import type { IExtraOptions, TCount, TFilter, TFindOneOptions, TWhere } from '@venizia/ignis-kernel';
+import type { IRelationalDataSource } from '../../../../relational/core/datasources/common';
+import type { TTableInsert, TTableObject, TTableSchemaWithId } from '../../../../relational/core/models';
+import type { TNullable } from '@venizia/ignis-helpers/common';
+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/cjs/relational/core/repositories/core/soft-deletable.d.ts.map

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

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

@@ -0,0 +1,85 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SoftDeletableRelationalRepository = void 0;
+const ignis_kernel_1 = require("@venizia/ignis-kernel");
+const core_1 = require("@venizia/ignis-helpers/core");
+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, core_1.getError)({
+                error: ignis_kernel_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/cjs/relational/core/repositories/core/soft-deletable.js.map

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