@venizia/ignis-kernel 0.2.0-0

package/dist/cjs/base/repositories/common/types.d.ts

@@ -0,0 +1,331 @@
+import type { AbstractDataSource, ITransaction } from '../../../base/datasources';
+import type { AbstractEntity, IdType } from '../../../base/models';
+import { z } from '@hono/zod-openapi';
+import type { TFilter, TWhere } from '@venizia/ignis-filter';
+import type { TLogLevel } from '@venizia/ignis-helpers/core';
+import type { AnyType, TNullable } from '@venizia/ignis-helpers/common';
+import type { IRetryBackoffOptions } from '@venizia/ignis-helpers/core';
+import type { Column, SQL } from 'drizzle-orm';
+import type { TLockStrength } from './constants';
+/** Update data supporting both regular fields and JSON path updates via dot notation. */
+export type TUpdateData<T = any> = Partial<T> & {
+    [jsonPath: string]: any;
+};
+/** Zod schema for count operation results. */
+export declare const CountSchema: z.ZodObject<{
+    count: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+export type TCount = z.infer<typeof CountSchema>;
+/** Data range information for paginated queries. Follows HTTP Content-Range standard. */
+export type TDataRange = {
+    start: number;
+    end: number;
+    total: number;
+};
+/** Content-Range envelope with an inclusive `end` - an empty page collapses `end` onto `start`. */
+export declare const buildDataRange: (opts: {
+    skip?: number;
+    offset?: number;
+    dataLength: number;
+    total: number;
+}) => TDataRange;
+/** Options for Drizzle ORM query building, used internally by FilterBuilder. */
+export type TDrizzleQueryOptions = Partial<{
+    limit: number;
+    offset: number;
+    orderBy: SQL[];
+    where: SQL;
+    with: Record<string, true | TDrizzleQueryOptions>;
+    columns: Record<string, boolean>;
+}>;
+/** Configuration for repository operation logging. */
+export type TRepositoryLogOptions = {
+    use: boolean;
+    level?: TLogLevel;
+};
+/** Configuration for row-level lock wait behavior. Mutually exclusive: use noWait OR skipLocked. */
+export type TLockConfig = {
+    noWait: true;
+    skipLocked?: undefined;
+} | {
+    noWait?: undefined;
+    skipLocked: true;
+} | {
+    noWait?: undefined;
+    skipLocked?: undefined;
+};
+/** Row-level locking options for read operations. */
+export type TLockOptions = {
+    strength: TLockStrength;
+    config?: TLockConfig;
+};
+/** Neutral transaction association - postgres narrows to its own `IDatabaseTransaction` (via `isDatabaseTransaction`) where it needs `.connector`. */
+export interface IWithTransaction {
+    transaction?: ITransaction;
+}
+/** Extended options for repository operations with transaction, logging, and default filter bypass. */
+export interface IExtraOptions extends IWithTransaction {
+    log?: TRepositoryLogOptions;
+    /** If true, bypass the default filter configured in model settings (e.g., soft delete). */
+    shouldSkipDefaultFilter?: boolean;
+    /** Row-level locking. Requires transaction. Incompatible with include/fields (Query API). */
+    lock?: TLockOptions;
+}
+/**
+ * Read-after-write retry for read verbs behind a replicated pool. The read re-executes while
+ * `until(result)` returns false; on exhaustion the last result is returned as-is.
+ */
+export interface IReadRetryOptions<TResult> {
+    /** Default 3. */
+    maxAttempts?: number;
+    /** Total budget across attempts AND sleeps. Default: unlimited. */
+    maxTotalMs?: number;
+    /**
+     * Aborts between attempts and during backoff sleeps - pass the request signal so a cancelled
+     * request stops retrying.
+     */
+    signal?: AbortSignal;
+    /** Default: EXPONENTIAL from 50ms, capped at 500ms, EQUAL jitter - tuned for replica lag. */
+    backoff?: IRetryBackoffOptions;
+    /** Retry while false. Default per verb: findOne/findById non-null, find non-empty. */
+    until?: (result: TResult) => boolean;
+}
+/**
+ * Intersected into READ verb signatures only - a write verb's options type has no `retry`, so an
+ * inline `{ retry }` fails to compile and a pre-built object carrying it is inert.
+ */
+export interface IWithReadRetry<TResult> {
+    retry?: IReadRetryOptions<TResult>;
+}
+/** The `shouldQueryRange: true` result envelope. */
+export type TDataWithRange<R> = {
+    data: Array<R>;
+    range: TDataRange;
+};
+/** Options for `find` returning a plain array - the retry predicate sees `Array<R>`. */
+export type TFindOptions<TOptions extends IExtraOptions, R> = TOptions & {
+    shouldQueryRange?: false;
+} & IWithReadRetry<Array<R>>;
+/** Options for `find` with the range envelope - the retry predicate sees `{ data, range }`. */
+export type TFindRangeOptions<TOptions extends IExtraOptions, R> = TOptions & {
+    shouldQueryRange: true;
+} & IWithReadRetry<TDataWithRange<R>>;
+/** Options for `findOne`/`findById` - the retry predicate sees `TNullable<R>`. */
+export type TFindOneOptions<TOptions extends IExtraOptions, R> = TOptions & IWithReadRetry<TNullable<R>>;
+/**
+ * Base repository interface shared by every engine - engine-specific accessors (postgres's
+ * `getEntitySchema()`/`getConnector()`) stay on the connector's own repository tier.
+ */
+export interface IRepository {
+    dataSource: AbstractDataSource;
+    entity: AbstractEntity;
+    getEntity(): AbstractEntity;
+}
+/** Interface for read-only repository operations. `TDataObject` is the row/document shape itself. */
+export interface IReadableRepository<TDataObject extends object = object, ExtraOptions extends IExtraOptions = IExtraOptions> extends IRepository {
+    count(opts: {
+        where: TWhere<TDataObject>;
+        options?: ExtraOptions;
+    }): Promise<TCount>;
+    existsWith(opts: {
+        where: TWhere<TDataObject>;
+        options?: ExtraOptions;
+    }): Promise<boolean>;
+    find<R = TDataObject>(opts: {
+        filter: TFilter<TDataObject>;
+        options: TFindRangeOptions<ExtraOptions, R>;
+    }): Promise<TDataWithRange<R>>;
+    find<R = TDataObject>(opts: {
+        filter: TFilter<TDataObject>;
+        options?: TFindOptions<ExtraOptions, R>;
+    }): Promise<Array<R>>;
+    findOne<R = TDataObject>(opts: {
+        filter: TFilter<TDataObject>;
+        options?: TFindOneOptions<ExtraOptions, R>;
+    }): Promise<TNullable<R>>;
+    findById<R = TDataObject>(opts: {
+        id: IdType;
+        filter?: Omit<TFilter<TDataObject>, 'where'>;
+        options?: TFindOneOptions<ExtraOptions, R>;
+    }): Promise<TNullable<R>>;
+}
+/** Interface for create operations. */
+export interface ICreatableRepository<TDataObject extends object = object, TPersistObject extends object = TDataObject, ExtraOptions extends IExtraOptions = IExtraOptions> extends IRepository {
+    create(opts: {
+        data: TPersistObject;
+        options: ExtraOptions & {
+            shouldReturn: false;
+        };
+    }): Promise<TCount & {
+        data: undefined | null;
+    }>;
+    create<R = TDataObject>(opts: {
+        data: TPersistObject;
+        options?: ExtraOptions & {
+            shouldReturn?: true;
+        };
+    }): Promise<TCount & {
+        data: R;
+    }>;
+    createAll(opts: {
+        data: Array<TPersistObject>;
+        options: ExtraOptions & {
+            shouldReturn: false;
+        };
+    }): Promise<TCount & {
+        data: undefined | null;
+    }>;
+    createAll<R = TDataObject>(opts: {
+        data: Array<TPersistObject>;
+        options?: ExtraOptions & {
+            shouldReturn?: true;
+        };
+    }): Promise<TCount & {
+        data: Array<R>;
+    }>;
+}
+/** Interface for update operations. */
+export interface IUpdatableRepository<TDataObject extends object = object, TPersistObject extends object = TDataObject, ExtraOptions extends IExtraOptions = IExtraOptions> extends IRepository {
+    updateById(opts: {
+        id: IdType;
+        data: Partial<TPersistObject>;
+        options: ExtraOptions & {
+            shouldReturn: false;
+        };
+    }): Promise<TCount & {
+        data: undefined | null;
+    }>;
+    updateById<R = TDataObject>(opts: {
+        id: IdType;
+        data: Partial<TPersistObject>;
+        options?: ExtraOptions & {
+            shouldReturn?: true;
+        };
+    }): Promise<TCount & {
+        data: R;
+    }>;
+    updateAll(opts: {
+        data: Partial<TPersistObject>;
+        where: TWhere<TDataObject>;
+        options: ExtraOptions & {
+            shouldReturn: false;
+            force?: boolean;
+        };
+    }): Promise<TCount & {
+        data: undefined | null;
+    }>;
+    updateAll<R = TDataObject>(opts: {
+        data: Partial<TPersistObject>;
+        where: TWhere<TDataObject>;
+        options?: ExtraOptions & {
+            shouldReturn?: true;
+            force?: boolean;
+        };
+    }): Promise<TCount & {
+        data: Array<R> | null;
+    }>;
+    /** Alias for updateAll. */
+    updateBy(opts: {
+        data: Partial<TPersistObject>;
+        where: TWhere<TDataObject>;
+        options: ExtraOptions & {
+            shouldReturn: false;
+            force?: boolean;
+        };
+    }): Promise<TCount & {
+        data: undefined | null;
+    }>;
+    /** Alias for updateAll. */
+    updateBy<R = TDataObject>(opts: {
+        data: Partial<TPersistObject>;
+        where: TWhere<TDataObject>;
+        options?: ExtraOptions & {
+            shouldReturn?: true;
+            force?: boolean;
+        };
+    }): Promise<TCount & {
+        data: Array<R> | null;
+    }>;
+}
+/** Interface for delete operations. */
+export interface IDeletableRepository<TDataObject extends object = object, ExtraOptions extends IExtraOptions = IExtraOptions> extends IRepository {
+    deleteById(opts: {
+        id: IdType;
+        options: ExtraOptions & {
+            shouldReturn: false;
+        };
+    }): Promise<TCount & {
+        data: undefined | null;
+    }>;
+    deleteById<R = TDataObject>(opts: {
+        id: IdType;
+        options?: ExtraOptions & {
+            shouldReturn?: true;
+        };
+    }): Promise<TCount & {
+        data: R;
+    }>;
+    deleteAll(opts: {
+        where?: TWhere<TDataObject>;
+        options: ExtraOptions & {
+            shouldReturn: false;
+            force?: boolean;
+        };
+    }): Promise<TCount & {
+        data: undefined | null;
+    }>;
+    deleteAll<R = TDataObject>(opts: {
+        where?: TWhere<TDataObject>;
+        options?: ExtraOptions & {
+            shouldReturn?: true;
+            force?: boolean;
+        };
+    }): Promise<TCount & {
+        data: Array<R> | null;
+    }>;
+    /** Alias for deleteAll. */
+    deleteBy(opts: {
+        where?: TWhere<TDataObject>;
+        options: ExtraOptions & {
+            shouldReturn: false;
+            force?: boolean;
+        };
+    }): Promise<TCount & {
+        data: undefined | null;
+    }>;
+    /** Alias for deleteAll. */
+    deleteBy<R = TDataObject>(opts: {
+        where?: TWhere<TDataObject>;
+        options?: ExtraOptions & {
+            shouldReturn?: true;
+            force?: boolean;
+        };
+    }): Promise<TCount & {
+        data: Array<R> | null;
+    }>;
+}
+/** Interface for full CRUD repository operations - reads plus create, update, and delete. */
+export interface IPersistableRepository<TDataObject extends object = object, TPersistObject extends object = TDataObject, ExtraOptions extends IExtraOptions = IExtraOptions> extends IReadableRepository<TDataObject, ExtraOptions>, ICreatableRepository<TDataObject, TPersistObject, ExtraOptions>, IUpdatableRepository<TDataObject, TPersistObject, ExtraOptions>, IDeletableRepository<TDataObject, ExtraOptions> {
+}
+/**
+ * Alias for IPersistableRepository - the name both DefaultRelationalRepository and
+ * DefaultSearchRepository satisfy.
+ */
+export interface ICrudRepository<TDataObject extends object = object, TPersistObject extends object = TDataObject, ExtraOptions extends IExtraOptions = IExtraOptions> extends IPersistableRepository<TDataObject, TPersistObject, ExtraOptions> {
+}
+/** Options passed to query operator handler functions. */
+export interface IQueryHandlerOptions<T = any> {
+    column: Column;
+    value: T;
+}
+/**
+ * Operator-name to SQL-handler table a relational dialect translates with, so a second SQL engine
+ * swaps the whole table without touching the walk that reaches it. `column` is wider than
+ * `IQueryHandlerOptions` names it: the JSON-path branch hands handlers a raw `#>>` extraction
+ * expression, not a `Column`.
+ */
+export type TQueryOperatorHandlers = Record<string, (opts: {
+    column: AnyType;
+    value: AnyType;
+}) => SQL | undefined>;
+//# sourceMappingURL=types.d.ts.map

package/dist/cjs/base/repositories/common/types.d.ts.map

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

package/dist/cjs/base/repositories/common/types.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildDataRange = exports.CountSchema = void 0;
+const zod_openapi_1 = require("@hono/zod-openapi");
+/** Zod schema for count operation results. */
+exports.CountSchema = zod_openapi_1.z.object({ count: zod_openapi_1.z.number().default(0) }).openapi({
+    description: 'Total count of items matching the criteria.',
+    examples: [{ count: 0 }, { count: 10 }],
+});
+/** Content-Range envelope with an inclusive `end` - an empty page collapses `end` onto `start`. */
+const buildDataRange = (opts) => {
+    const { skip, offset, dataLength, total } = opts;
+    const start = skip ?? offset ?? 0;
+    const end = dataLength > 0 ? start + dataLength - 1 : start;
+    return { start, end, total };
+};
+exports.buildDataRange = buildDataRange;
+//# sourceMappingURL=types.js.map

package/dist/cjs/base/repositories/common/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../src/base/repositories/common/types.ts"],"names":[],"mappings":";;;AAEA,mDAAsC;AAatC,8CAA8C;AACjC,QAAA,WAAW,GAAG,eAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,eAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC;IAC5E,WAAW,EAAE,6CAA6C;IAC1D,QAAQ,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;CACxC,CAAC,CAAC;AAWH,mGAAmG;AAC5F,MAAM,cAAc,GAAG,CAAC,IAK9B,EAAc,EAAE;IACf,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;IACjD,MAAM,KAAK,GAAG,IAAI,IAAI,MAAM,IAAI,CAAC,CAAC;IAClC,MAAM,GAAG,GAAG,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IAC5D,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC;AAC/B,CAAC,CAAC;AAVW,QAAA,cAAc,kBAUzB"}

package/dist/cjs/base/repositories/core/abstract.d.ts

@@ -0,0 +1,258 @@
+import type { AbstractDataSource } from '../../../base/datasources';
+import type { AbstractEntity, IdType } from '../../../base/models';
+import type { IModelMetadata } from '../../../helpers/inversion';
+import type { TClass, TNullable } from '@venizia/ignis-helpers/common';
+import { BaseHelper } from '@venizia/ignis-helpers/core';
+import type { IExtraOptions, IPersistableRepository, IWithReadRetry, TCount, TDataWithRange, TFindOneOptions, TFindOptions, TFindRangeOptions, TRepositoryOperationScope } from '../common';
+import type { TFilter, TWhere } from '@venizia/ignis-filter';
+/**
+ * Engine-neutral repository plumbing - lazy dataSource/entity resolution, class-keyed `@model`
+ * settings, operation scope. `TOptions` defaults to `IExtraOptions` so connectors can narrow it
+ * while staying assignable to this base.
+ */
+export declare abstract class AbstractRepository<TDataObject extends object, TPersistObject extends object = TDataObject, TOptions extends IExtraOptions = IExtraOptions> extends BaseHelper implements IPersistableRepository<TDataObject, TPersistObject, TOptions> {
+    protected _operationScope: TRepositoryOperationScope;
+    /** Lazy-resolved on first access if not provided in constructor. */
+    protected _dataSource?: AbstractDataSource;
+    /** Lazy-resolved from @repository metadata on first access. */
+    protected _entity?: AbstractEntity;
+    /**
+     * Memoized @model settings for `this.entity`'s class. `null` means not yet resolved - `undefined`
+     * is itself a valid resolved value: the model declares no settings.
+     */
+    private _modelSettings;
+    constructor(dataSource?: AbstractDataSource, opts?: {
+        scope?: string;
+        entityClass?: TClass<AbstractEntity>;
+        operationScope?: TRepositoryOperationScope;
+    });
+    get dataSource(): AbstractDataSource;
+    set dataSource(value: AbstractDataSource);
+    /** Auto-resolves from @repository metadata if not explicitly set. */
+    get entity(): AbstractEntity;
+    set entity(value: AbstractEntity);
+    get operationScope(): TRepositoryOperationScope;
+    setDataSource(opts: {
+        dataSource: AbstractDataSource;
+    }): void;
+    getEntity(): AbstractEntity;
+    /**
+     * Resolved `@model` settings for `this.entity`'s class, keyed by Reflect target - not by
+     * `entity.name`, which can diverge from the `@model` registry key.
+     */
+    protected get modelSettings(): IModelMetadata['settings'];
+    protected get hiddenFields(): string[];
+    /** Default where from @model settings.defaultFilter.where, AND-merged into every query unless skipped. */
+    protected get defaultWhere(): TWhere | undefined;
+    protected get defaultLimit(): number | undefined;
+    /** Largest `limit` a caller may ask for, when the model declares one; undefined leaves the tier's own default in force. */
+    protected get maxLimit(): number | undefined;
+    /** Resolves the entity instance from @repository metadata on first access. */
+    protected resolveEntity(): AbstractEntity;
+    /** Rejects a verb the current operation scope does not permit. */
+    protected denyOperation(opts: {
+        methodName: string;
+    }): never;
+    /**
+     * Shared retry orchestration for read verbs. Inside a transaction retry is skipped - the pool
+     * routes transactions to the primary, so there is no replica lag to wait out.
+     */
+    protected executeReadWithRetry<TResult>(opts: {
+        operation: string;
+        options: IExtraOptions & IWithReadRetry<TResult>;
+        defaultUntil: (result: TResult) => boolean;
+        execution: () => Promise<TResult>;
+    }): Promise<TResult>;
+    /**
+     * A copy of `options` without `retry`, so re-entering a read verb takes its non-retry path - this
+     * is what keeps the retry recursion single-depth. Copy-then-delete rather than a rest-destructure
+     * (lint rejects the unused rest sibling) or `lodash/omit` (its `Omit<>` return type is not
+     * assignable back to `TOptions`).
+     */
+    private omitReadRetry;
+    /** `find`, re-executed until the retry predicate holds - connectors dispatch here from `find` when `options.retry` is set. */
+    protected findUntil<R = TDataObject>(opts: {
+        filter: TFilter<TDataObject>;
+        options: TFindOptions<TOptions, R>;
+    }): Promise<Array<R>>;
+    /** `find` with the range envelope, re-executed until the retry predicate holds - split from `findUntil` so each result shape is checked against its own `find` overload. */
+    protected findRangeUntil<R = TDataObject>(opts: {
+        filter: TFilter<TDataObject>;
+        options: TFindRangeOptions<TOptions, R>;
+    }): Promise<TDataWithRange<R>>;
+    /** `findOne`, re-executed until the retry predicate holds - also serves `findById` via its findOne delegation. */
+    protected findOneUntil<R = TDataObject>(opts: {
+        filter: TFilter<TDataObject>;
+        options: TFindOneOptions<TOptions, R>;
+    }): Promise<TNullable<R>>;
+    abstract count(opts: {
+        where: TWhere<TDataObject>;
+        options?: TOptions;
+    }): Promise<TCount>;
+    abstract existsWith(opts: {
+        where: TWhere<TDataObject>;
+        options?: TOptions;
+    }): Promise<boolean>;
+    abstract find<R = TDataObject>(opts: {
+        filter: TFilter<TDataObject>;
+        options: TFindRangeOptions<TOptions, R>;
+    }): Promise<TDataWithRange<R>>;
+    abstract find<R = TDataObject>(opts: {
+        filter: TFilter<TDataObject>;
+        options?: TFindOptions<TOptions, R>;
+    }): Promise<R[]>;
+    abstract findOne<R = TDataObject>(opts: {
+        filter: TFilter<TDataObject>;
+        options?: TFindOneOptions<TOptions, R>;
+    }): Promise<TNullable<R>>;
+    abstract findById<R = TDataObject>(opts: {
+        id: IdType;
+        filter?: Omit<TFilter<TDataObject>, 'where'>;
+        options?: TFindOneOptions<TOptions, R>;
+    }): Promise<TNullable<R>>;
+    abstract create(opts: {
+        data: TPersistObject;
+        options: TOptions & {
+            shouldReturn: false;
+        };
+    }): Promise<TCount & {
+        data: undefined | null;
+    }>;
+    abstract create<R = TDataObject>(opts: {
+        data: TPersistObject;
+        options?: TOptions & {
+            shouldReturn?: true;
+        };
+    }): Promise<TCount & {
+        data: R;
+    }>;
+    abstract createAll(opts: {
+        data: Array<TPersistObject>;
+        options: TOptions & {
+            shouldReturn: false;
+        };
+    }): Promise<TCount & {
+        data: undefined | null;
+    }>;
+    abstract createAll<R = TDataObject>(opts: {
+        data: Array<TPersistObject>;
+        options?: TOptions & {
+            shouldReturn?: true;
+        };
+    }): Promise<TCount & {
+        data: Array<R>;
+    }>;
+    abstract updateById(opts: {
+        id: IdType;
+        data: Partial<TPersistObject>;
+        options: TOptions & {
+            shouldReturn: false;
+        };
+    }): Promise<TCount & {
+        data: undefined | null;
+    }>;
+    abstract updateById<R = TDataObject>(opts: {
+        id: IdType;
+        data: Partial<TPersistObject>;
+        options?: TOptions & {
+            shouldReturn?: true;
+        };
+    }): Promise<TCount & {
+        data: R;
+    }>;
+    abstract updateAll(opts: {
+        data: Partial<TPersistObject>;
+        where: TWhere<TDataObject>;
+        options: TOptions & {
+            shouldReturn: false;
+            force?: boolean;
+        };
+    }): Promise<TCount & {
+        data: undefined | null;
+    }>;
+    abstract updateAll<R = TDataObject>(opts: {
+        data: Partial<TPersistObject>;
+        where: TWhere<TDataObject>;
+        options?: TOptions & {
+            shouldReturn?: true;
+            force?: boolean;
+        };
+    }): Promise<TCount & {
+        data: Array<R> | null;
+    }>;
+    /** Alias for updateAll. */
+    updateBy(opts: {
+        data: Partial<TPersistObject>;
+        where: TWhere<TDataObject>;
+        options: TOptions & {
+            shouldReturn: false;
+            force?: boolean;
+        };
+    }): Promise<TCount & {
+        data: undefined | null;
+    }>;
+    updateBy<R = TDataObject>(opts: {
+        data: Partial<TPersistObject>;
+        where: TWhere<TDataObject>;
+        options?: TOptions & {
+            shouldReturn?: true;
+            force?: boolean;
+        };
+    }): Promise<TCount & {
+        data: Array<R> | null;
+    }>;
+    abstract deleteById(opts: {
+        id: IdType;
+        options: TOptions & {
+            shouldReturn: false;
+        };
+    }): Promise<TCount & {
+        data: undefined | null;
+    }>;
+    abstract deleteById<R = TDataObject>(opts: {
+        id: IdType;
+        options?: TOptions & {
+            shouldReturn?: true;
+        };
+    }): Promise<TCount & {
+        data: R;
+    }>;
+    abstract deleteAll(opts: {
+        where?: TWhere<TDataObject>;
+        options: TOptions & {
+            shouldReturn: false;
+            force?: boolean;
+        };
+    }): Promise<TCount & {
+        data: undefined | null;
+    }>;
+    abstract deleteAll<R = TDataObject>(opts: {
+        where?: TWhere<TDataObject>;
+        options?: TOptions & {
+            shouldReturn?: true;
+            force?: boolean;
+        };
+    }): Promise<TCount & {
+        data: Array<R> | null;
+    }>;
+    /** Alias for deleteAll. */
+    deleteBy(opts: {
+        where: TWhere<TDataObject>;
+        options: TOptions & {
+            shouldReturn: false;
+            force?: boolean;
+        };
+    }): Promise<TCount & {
+        data: undefined | null;
+    }>;
+    deleteBy<R = TDataObject>(opts: {
+        where: TWhere<TDataObject>;
+        options?: TOptions & {
+            shouldReturn?: true;
+            force?: boolean;
+        };
+    }): Promise<TCount & {
+        data: Array<R> | null;
+    }>;
+}
+//# sourceMappingURL=abstract.d.ts.map

package/dist/cjs/base/repositories/core/abstract.d.ts.map

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