@venizia/ignis-kernel 0.2.0-0

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

@@ -0,0 +1,258 @@
+import type { AbstractDataSource } from '../../../base/datasources/index.js';
+import type { AbstractEntity, IdType } from '../../../base/models/index.js';
+import type { IModelMetadata } from '../../../helpers/inversion/index.js';
+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/index.js';
+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/esm/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":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAC5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D,OAAO,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,EAAE,UAAU,EAAY,MAAM,6BAA6B,CAAC;AAOnE,OAAO,KAAK,EACV,aAAa,EACb,sBAAsB,EACtB,cAAc,EACd,MAAM,EACN,cAAc,EACd,eAAe,EACf,YAAY,EACZ,iBAAiB,EACjB,yBAAyB,EAC1B,MAAM,WAAW,CAAC;AAEnB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAE7D;;;;GAIG;AACH,8BAAsB,kBAAkB,CACtC,WAAW,SAAS,MAAM,EAC1B,cAAc,SAAS,MAAM,GAAG,WAAW,EAC3C,QAAQ,SAAS,aAAa,GAAG,aAAa,CAE9C,SAAQ,UACR,YAAW,sBAAsB,CAAC,WAAW,EAAE,cAAc,EAAE,QAAQ,CAAC;IAExE,SAAS,CAAC,eAAe,EAAE,yBAAyB,CAAC;IAErD,oEAAoE;IACpE,SAAS,CAAC,WAAW,CAAC,EAAE,kBAAkB,CAAC;IAE3C,+DAA+D;IAC/D,SAAS,CAAC,OAAO,CAAC,EAAE,cAAc,CAAC;IAEnC;;;OAGG;IACH,OAAO,CAAC,cAAc,CAA2C;gBAG/D,UAAU,CAAC,EAAE,kBAAkB,EAC/B,IAAI,CAAC,EAAE;QACL,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,WAAW,CAAC,EAAE,MAAM,CAAC,cAAc,CAAC,CAAC;QACrC,cAAc,CAAC,EAAE,yBAAyB,CAAC;KAC5C;IAmBH,IAAI,UAAU,IAAI,kBAAkB,CAQnC;IAED,IAAI,UAAU,CAAC,KAAK,EAAE,kBAAkB,EAEvC;IAED,qEAAqE;IACrE,IAAI,MAAM,IAAI,cAAc,CAG3B;IAED,IAAI,MAAM,CAAC,KAAK,EAAE,cAAc,EAE/B;IAED,IAAI,cAAc,IAAI,yBAAyB,CAE9C;IAED,aAAa,CAAC,IAAI,EAAE;QAAE,UAAU,EAAE,kBAAkB,CAAA;KAAE,GAAG,IAAI;IAI7D,SAAS,IAAI,cAAc;IAI3B;;;OAGG;IACH,SAAS,KAAK,aAAa,IAAI,cAAc,CAAC,UAAU,CAAC,CAUxD;IAED,SAAS,KAAK,YAAY,IAAI,MAAM,EAAE,CAErC;IAED,0GAA0G;IAC1G,SAAS,KAAK,YAAY,IAAI,MAAM,GAAG,SAAS,CAE/C;IAED,SAAS,KAAK,YAAY,IAAI,MAAM,GAAG,SAAS,CAE/C;IAED,2HAA2H;IAC3H,SAAS,KAAK,QAAQ,IAAI,MAAM,GAAG,SAAS,CAE3C;IAED,8EAA8E;IAC9E,SAAS,CAAC,aAAa,IAAI,cAAc;IAgBzC,kEAAkE;IAClE,SAAS,CAAC,aAAa,CAAC,IAAI,EAAE;QAAE,UAAU,EAAE,MAAM,CAAA;KAAE,GAAG,KAAK;IAO5D;;;OAGG;IACH,SAAS,CAAC,oBAAoB,CAAC,OAAO,EAAE,IAAI,EAAE;QAC5C,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,aAAa,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;QACjD,YAAY,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,OAAO,CAAC;QAC3C,SAAS,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;KACnC,GAAG,OAAO,CAAC,OAAO,CAAC;IA+BpB;;;;;OAKG;IACH,OAAO,CAAC,aAAa;IAQrB,8HAA8H;IAC9H,SAAS,CAAC,SAAS,CAAC,CAAC,GAAG,WAAW,EAAE,IAAI,EAAE;QACzC,MAAM,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;QAC7B,OAAO,EAAE,YAAY,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;KACpC,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAWrB,4KAA4K;IAC5K,SAAS,CAAC,cAAc,CAAC,CAAC,GAAG,WAAW,EAAE,IAAI,EAAE;QAC9C,MAAM,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;QAC7B,OAAO,EAAE,iBAAiB,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;KACzC,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;IAW9B,kHAAkH;IAClH,SAAS,CAAC,YAAY,CAAC,CAAC,GAAG,WAAW,EAAE,IAAI,EAAE;QAC5C,MAAM,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;QAC7B,OAAO,EAAE,eAAe,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;KACvC,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IAWzB,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC;QAAC,OAAO,CAAC,EAAE,QAAQ,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAEzF,QAAQ,CAAC,UAAU,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC;QAAC,OAAO,CAAC,EAAE,QAAQ,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC;IAE/F,QAAQ,CAAC,IAAI,CAAC,CAAC,GAAG,WAAW,EAAE,IAAI,EAAE;QACnC,MAAM,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;QAC7B,OAAO,EAAE,iBAAiB,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;KACzC,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;IAE9B,QAAQ,CAAC,IAAI,CAAC,CAAC,GAAG,WAAW,EAAE,IAAI,EAAE;QACnC,MAAM,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;QAC7B,OAAO,CAAC,EAAE,YAAY,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;KACrC,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;IAEhB,QAAQ,CAAC,OAAO,CAAC,CAAC,GAAG,WAAW,EAAE,IAAI,EAAE;QACtC,MAAM,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;QAC7B,OAAO,CAAC,EAAE,eAAe,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;KACxC,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IAEzB,QAAQ,CAAC,QAAQ,CAAC,CAAC,GAAG,WAAW,EAAE,IAAI,EAAE;QACvC,EAAE,EAAE,MAAM,CAAC;QACX,MAAM,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC,CAAC;QAC7C,OAAO,CAAC,EAAE,eAAe,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;KACxC,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IAEzB,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE;QACpB,IAAI,EAAE,cAAc,CAAC;QACrB,OAAO,EAAE,QAAQ,GAAG;YAAE,YAAY,EAAE,KAAK,CAAA;SAAE,CAAC;KAC7C,GAAG,OAAO,CAAC,MAAM,GAAG;QAAE,IAAI,EAAE,SAAS,GAAG,IAAI,CAAA;KAAE,CAAC;IAEhD,QAAQ,CAAC,MAAM,CAAC,CAAC,GAAG,WAAW,EAAE,IAAI,EAAE;QACrC,IAAI,EAAE,cAAc,CAAC;QACrB,OAAO,CAAC,EAAE,QAAQ,GAAG;YAAE,YAAY,CAAC,EAAE,IAAI,CAAA;SAAE,CAAC;KAC9C,GAAG,OAAO,CAAC,MAAM,GAAG;QAAE,IAAI,EAAE,CAAC,CAAA;KAAE,CAAC;IAEjC,QAAQ,CAAC,SAAS,CAAC,IAAI,EAAE;QACvB,IAAI,EAAE,KAAK,CAAC,cAAc,CAAC,CAAC;QAC5B,OAAO,EAAE,QAAQ,GAAG;YAAE,YAAY,EAAE,KAAK,CAAA;SAAE,CAAC;KAC7C,GAAG,OAAO,CAAC,MAAM,GAAG;QAAE,IAAI,EAAE,SAAS,GAAG,IAAI,CAAA;KAAE,CAAC;IAEhD,QAAQ,CAAC,SAAS,CAAC,CAAC,GAAG,WAAW,EAAE,IAAI,EAAE;QACxC,IAAI,EAAE,KAAK,CAAC,cAAc,CAAC,CAAC;QAC5B,OAAO,CAAC,EAAE,QAAQ,GAAG;YAAE,YAAY,CAAC,EAAE,IAAI,CAAA;SAAE,CAAC;KAC9C,GAAG,OAAO,CAAC,MAAM,GAAG;QAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,CAAA;KAAE,CAAC;IAExC,QAAQ,CAAC,UAAU,CAAC,IAAI,EAAE;QACxB,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;QAC9B,OAAO,EAAE,QAAQ,GAAG;YAAE,YAAY,EAAE,KAAK,CAAA;SAAE,CAAC;KAC7C,GAAG,OAAO,CAAC,MAAM,GAAG;QAAE,IAAI,EAAE,SAAS,GAAG,IAAI,CAAA;KAAE,CAAC;IAEhD,QAAQ,CAAC,UAAU,CAAC,CAAC,GAAG,WAAW,EAAE,IAAI,EAAE;QACzC,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;QAC9B,OAAO,CAAC,EAAE,QAAQ,GAAG;YAAE,YAAY,CAAC,EAAE,IAAI,CAAA;SAAE,CAAC;KAC9C,GAAG,OAAO,CAAC,MAAM,GAAG;QAAE,IAAI,EAAE,CAAC,CAAA;KAAE,CAAC;IAEjC,QAAQ,CAAC,SAAS,CAAC,IAAI,EAAE;QACvB,IAAI,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;QAC9B,KAAK,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC;QAC3B,OAAO,EAAE,QAAQ,GAAG;YAAE,YAAY,EAAE,KAAK,CAAC;YAAC,KAAK,CAAC,EAAE,OAAO,CAAA;SAAE,CAAC;KAC9D,GAAG,OAAO,CAAC,MAAM,GAAG;QAAE,IAAI,EAAE,SAAS,GAAG,IAAI,CAAA;KAAE,CAAC;IAEhD,QAAQ,CAAC,SAAS,CAAC,CAAC,GAAG,WAAW,EAAE,IAAI,EAAE;QACxC,IAAI,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;QAC9B,KAAK,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC;QAC3B,OAAO,CAAC,EAAE,QAAQ,GAAG;YAAE,YAAY,CAAC,EAAE,IAAI,CAAC;YAAC,KAAK,CAAC,EAAE,OAAO,CAAA;SAAE,CAAC;KAC/D,GAAG,OAAO,CAAC,MAAM,GAAG;QAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,CAAA;KAAE,CAAC;IAE/C,2BAA2B;IAC3B,QAAQ,CAAC,IAAI,EAAE;QACb,IAAI,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;QAC9B,KAAK,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC;QAC3B,OAAO,EAAE,QAAQ,GAAG;YAAE,YAAY,EAAE,KAAK,CAAC;YAAC,KAAK,CAAC,EAAE,OAAO,CAAA;SAAE,CAAC;KAC9D,GAAG,OAAO,CAAC,MAAM,GAAG;QAAE,IAAI,EAAE,SAAS,GAAG,IAAI,CAAA;KAAE,CAAC;IAChD,QAAQ,CAAC,CAAC,GAAG,WAAW,EAAE,IAAI,EAAE;QAC9B,IAAI,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;QAC9B,KAAK,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC;QAC3B,OAAO,CAAC,EAAE,QAAQ,GAAG;YAAE,YAAY,CAAC,EAAE,IAAI,CAAC;YAAC,KAAK,CAAC,EAAE,OAAO,CAAA;SAAE,CAAC;KAC/D,GAAG,OAAO,CAAC,MAAM,GAAG;QAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,CAAA;KAAE,CAAC;IAe/C,QAAQ,CAAC,UAAU,CAAC,IAAI,EAAE;QACxB,EAAE,EAAE,MAAM,CAAC;QACX,OAAO,EAAE,QAAQ,GAAG;YAAE,YAAY,EAAE,KAAK,CAAA;SAAE,CAAC;KAC7C,GAAG,OAAO,CAAC,MAAM,GAAG;QAAE,IAAI,EAAE,SAAS,GAAG,IAAI,CAAA;KAAE,CAAC;IAEhD,QAAQ,CAAC,UAAU,CAAC,CAAC,GAAG,WAAW,EAAE,IAAI,EAAE;QACzC,EAAE,EAAE,MAAM,CAAC;QACX,OAAO,CAAC,EAAE,QAAQ,GAAG;YAAE,YAAY,CAAC,EAAE,IAAI,CAAA;SAAE,CAAC;KAC9C,GAAG,OAAO,CAAC,MAAM,GAAG;QAAE,IAAI,EAAE,CAAC,CAAA;KAAE,CAAC;IAEjC,QAAQ,CAAC,SAAS,CAAC,IAAI,EAAE;QACvB,KAAK,CAAC,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC;QAC5B,OAAO,EAAE,QAAQ,GAAG;YAAE,YAAY,EAAE,KAAK,CAAC;YAAC,KAAK,CAAC,EAAE,OAAO,CAAA;SAAE,CAAC;KAC9D,GAAG,OAAO,CAAC,MAAM,GAAG;QAAE,IAAI,EAAE,SAAS,GAAG,IAAI,CAAA;KAAE,CAAC;IAEhD,QAAQ,CAAC,SAAS,CAAC,CAAC,GAAG,WAAW,EAAE,IAAI,EAAE;QACxC,KAAK,CAAC,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC;QAC5B,OAAO,CAAC,EAAE,QAAQ,GAAG;YAAE,YAAY,CAAC,EAAE,IAAI,CAAC;YAAC,KAAK,CAAC,EAAE,OAAO,CAAA;SAAE,CAAC;KAC/D,GAAG,OAAO,CAAC,MAAM,GAAG;QAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,CAAA;KAAE,CAAC;IAE/C,2BAA2B;IAC3B,QAAQ,CAAC,IAAI,EAAE;QACb,KAAK,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC;QAC3B,OAAO,EAAE,QAAQ,GAAG;YAAE,YAAY,EAAE,KAAK,CAAC;YAAC,KAAK,CAAC,EAAE,OAAO,CAAA;SAAE,CAAC;KAC9D,GAAG,OAAO,CAAC,MAAM,GAAG;QAAE,IAAI,EAAE,SAAS,GAAG,IAAI,CAAA;KAAE,CAAC;IAChD,QAAQ,CAAC,CAAC,GAAG,WAAW,EAAE,IAAI,EAAE;QAC9B,KAAK,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC;QAC3B,OAAO,CAAC,EAAE,QAAQ,GAAG;YAAE,YAAY,CAAC,EAAE,IAAI,CAAC;YAAC,KAAK,CAAC,EAAE,OAAO,CAAA;SAAE,CAAC;KAC/D,GAAG,OAAO,CAAC,MAAM,GAAG;QAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,CAAA;KAAE,CAAC;CAahD"}

package/dist/esm/base/repositories/core/abstract.js

@@ -0,0 +1,191 @@
+import { MetadataRegistry } from '../../../helpers/inversion/index.js';
+import { BaseHelper, getError } from '@venizia/ignis-helpers/core';
+import { resolveValue } from '@venizia/ignis-helpers/common';
+import { executeWithRetryUntil, RetryBackoffStrategies, RetryJitterModes, } from '@venizia/ignis-helpers/core';
+import { RepositoryErrorCodes, RepositoryOperationScopes } from '../common/index.js';
+/**
+ * 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 class AbstractRepository extends BaseHelper {
+    constructor(dataSource, opts) {
+        const scopeName = opts?.scope ??
+            (opts?.entityClass?.name ? [opts.entityClass.name, 'Repository'].join('') : new.target.name);
+        super({ scope: scopeName });
+        /**
+         * 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.
+         */
+        this._modelSettings = null;
+        this._operationScope = opts?.operationScope ?? RepositoryOperationScopes.READ_ONLY;
+        if (dataSource) {
+            this._dataSource = dataSource;
+        }
+        if (opts?.entityClass) {
+            this._entity = new opts.entityClass();
+        }
+    }
+    get dataSource() {
+        if (!this._dataSource) {
+            throw getError({
+                message: `[${this.constructor.name}] DataSource not available. Use @repository({ model: YourModel, dataSource: YourDataSource }) or pass dataSource in constructor.`,
+            });
+        }
+        return this._dataSource;
+    }
+    set dataSource(value) {
+        this._dataSource = value;
+    }
+    /** Auto-resolves from @repository metadata if not explicitly set. */
+    get entity() {
+        this._entity ??= this.resolveEntity();
+        return this._entity;
+    }
+    set entity(value) {
+        this._entity = value;
+    }
+    get operationScope() {
+        return this._operationScope;
+    }
+    setDataSource(opts) {
+        this._dataSource = opts.dataSource;
+    }
+    getEntity() {
+        return this.entity;
+    }
+    /**
+     * Resolved `@model` settings for `this.entity`'s class, keyed by Reflect target - not by
+     * `entity.name`, which can diverge from the `@model` registry key.
+     */
+    get modelSettings() {
+        if (this._modelSettings !== null) {
+            return this._modelSettings;
+        }
+        this._modelSettings = MetadataRegistry.getInstance().getModelMetadata({
+            target: this.entity.constructor,
+        })?.settings;
+        return this._modelSettings;
+    }
+    get hiddenFields() {
+        return this.modelSettings?.hiddenProperties ?? [];
+    }
+    /** Default where from @model settings.defaultFilter.where, AND-merged into every query unless skipped. */
+    get defaultWhere() {
+        return this.modelSettings?.defaultFilter?.where;
+    }
+    get defaultLimit() {
+        return this.modelSettings?.defaultLimit;
+    }
+    /** Largest `limit` a caller may ask for, when the model declares one; undefined leaves the tier's own default in force. */
+    get maxLimit() {
+        return this.modelSettings?.maxLimit;
+    }
+    /** Resolves the entity instance from @repository metadata on first access. */
+    resolveEntity() {
+        const registry = MetadataRegistry.getInstance();
+        const binding = registry.getRepositoryBinding({ name: this.constructor.name });
+        if (!binding?.model) {
+            throw getError({
+                message: `[${this.constructor.name}] Cannot resolve entity. Either pass entityClass in constructor or use @repository decorator with model option.`,
+            });
+        }
+        // resolveValue() erases to the resolved value's structural type, not this class-or-resolver
+        // union's member - the `@repository` decorator guarantees a class constructor here.
+        const ctor = resolveValue(binding.model);
+        return new ctor();
+    }
+    /** Rejects a verb the current operation scope does not permit. */
+    denyOperation(opts) {
+        throw getError({
+            messageCode: RepositoryErrorCodes.OPERATION_NOT_ALLOWED,
+            message: `[${opts.methodName}] Repository operation is NOT ALLOWED | scope: ${this.operationScope}`,
+        });
+    }
+    /**
+     * 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.
+     */
+    executeReadWithRetry(opts) {
+        const { operation, options, defaultUntil, execution } = opts;
+        if (!options.retry) {
+            return execution();
+        }
+        if (options.transaction) {
+            this.logger.for(operation).debug('Read retry skipped inside transaction');
+            return execution();
+        }
+        const { maxAttempts, maxTotalMs, signal, backoff, until } = options.retry;
+        return executeWithRetryUntil({
+            operation: [this.constructor.name, operation].join('.'),
+            execution,
+            until: until ?? defaultUntil,
+            maxAttempts,
+            maxTotalMs,
+            signal,
+            backoff: backoff ?? {
+                strategy: RetryBackoffStrategies.EXPONENTIAL,
+                initialDelayMs: 50,
+                maxDelayMs: 500,
+                jitter: RetryJitterModes.EQUAL,
+            },
+            logger: this.logger,
+        });
+    }
+    /**
+     * 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`).
+     */
+    omitReadRetry(options) {
+        const rest = { ...options };
+        delete rest.retry;
+        return rest;
+    }
+    /** `find`, re-executed until the retry predicate holds - connectors dispatch here from `find` when `options.retry` is set. */
+    findUntil(opts) {
+        const options = this.omitReadRetry(opts.options);
+        return this.executeReadWithRetry({
+            operation: 'find',
+            options: opts.options,
+            defaultUntil: result => result.length > 0,
+            execution: () => this.find({ filter: opts.filter, options }),
+        });
+    }
+    /** `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. */
+    findRangeUntil(opts) {
+        const options = this.omitReadRetry(opts.options);
+        return this.executeReadWithRetry({
+            operation: 'find',
+            options: opts.options,
+            defaultUntil: result => result.data.length > 0,
+            execution: () => this.find({ filter: opts.filter, options }),
+        });
+    }
+    /** `findOne`, re-executed until the retry predicate holds - also serves `findById` via its findOne delegation. */
+    findOneUntil(opts) {
+        const options = this.omitReadRetry(opts.options);
+        return this.executeReadWithRetry({
+            operation: 'findOne',
+            options: opts.options,
+            defaultUntil: result => result !== null && result !== undefined,
+            execution: () => this.findOne({ filter: opts.filter, options }),
+        });
+    }
+    updateBy(opts) {
+        const { data, where, options } = opts;
+        if (options?.shouldReturn === false) {
+            return this.updateAll({ data, where, options: { ...options, shouldReturn: false } });
+        }
+        return this.updateAll({ data, where, options });
+    }
+    deleteBy(opts) {
+        const { where, options } = opts;
+        if (options?.shouldReturn === false) {
+            return this.deleteAll({ where, options: { ...options, shouldReturn: false } });
+        }
+        return this.deleteAll({ where, options });
+    }
+}
+//# sourceMappingURL=abstract.js.map

package/dist/esm/base/repositories/core/abstract.js.map

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

package/dist/esm/base/repositories/core/index.d.ts

@@ -0,0 +1,2 @@
+export * from './abstract.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/base/repositories/core/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/base/repositories/core/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC"}

package/dist/esm/base/repositories/core/index.js

@@ -0,0 +1,2 @@
+export * from './abstract.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/base/repositories/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/base/repositories/core/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC"}

package/dist/esm/base/repositories/index.d.ts

@@ -0,0 +1,4 @@
+export * from './common/index.js';
+export * from './core/index.js';
+export * from './query-schemas/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/base/repositories/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/base/repositories/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC;AACvB,cAAc,iBAAiB,CAAC"}

package/dist/esm/base/repositories/index.js

@@ -0,0 +1,4 @@
+export * from './common/index.js';
+export * from './core/index.js';
+export * from './query-schemas/index.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/base/repositories/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/base/repositories/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC;AACvB,cAAc,iBAAiB,CAAC"}

package/dist/esm/base/repositories/query-schemas/index.d.ts

@@ -0,0 +1,4 @@
+/** Side-effect import, and load order is the point: `@hono/zod-openapi` peers on `zod`, so importing it patches `.openapi()` onto the shared `ZodType` prototype. `buildQuerySchemas` runs at module scope below, and ESM evaluates imports first, so the method exists by the time the decorator is called. Without this line the schemas silently build undecorated whenever this module happens to load before anything else pulls in the OpenAPI layer. */
+import '@hono/zod-openapi';
+export declare const FieldsSchema: import("zod").ZodOptional<import("zod").ZodUnion<[import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodBoolean>, import("zod").ZodArray<import("zod").ZodString>]>>, FilterSchema: any, InclusionSchema: any, LimitSchema: import("zod").ZodOptional<import("zod").ZodNumber>, OffsetSchema: import("zod").ZodOptional<import("zod").ZodNumber>, OrderBySchema: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>, SkipSchema: import("zod").ZodOptional<import("zod").ZodNumber>, WhereSchema: import("zod").ZodUnion<readonly [import("zod").ZodType<any, unknown, import("zod/v4/core").$ZodTypeInternals<any, unknown>>, import("zod").ZodPipe<import("zod").ZodPipe<import("zod").ZodString, import("zod").ZodTransform<any, string>>, import("zod").ZodType<any, unknown, import("zod/v4/core").$ZodTypeInternals<any, unknown>>>]>;
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/base/repositories/query-schemas/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/base/repositories/query-schemas/index.ts"],"names":[],"mappings":"AAEA,+bAA+b;AAC/b,OAAO,mBAAmB,CAAC;AAO3B,eAAO,MACL,YAAY,oLACZ,YAAY,OACZ,eAAe,OACf,WAAW,sDACX,YAAY,sDACZ,aAAa,8EACb,UAAU,sDACV,WAAW,2UACwC,CAAC"}

package/dist/esm/base/repositories/query-schemas/index.js

@@ -0,0 +1,9 @@
+import { buildQuerySchemas } from '@venizia/ignis-filter/schemas';
+/** Side-effect import, and load order is the point: `@hono/zod-openapi` peers on `zod`, so importing it patches `.openapi()` onto the shared `ZodType` prototype. `buildQuerySchemas` runs at module scope below, and ESM evaluates imports first, so the method exists by the time the decorator is called. Without this line the schemas silently build undecorated whenever this module happens to load before anything else pulls in the OpenAPI layer. */
+import '@hono/zod-openapi';
+/** The schemas themselves live in `@venizia/ignis-filter`, built with plain `zod` so a browser can use them. Documentation metadata is injected here because it is a server concern - `.openapi()` returns a new schema rather than mutating, and three of the decorations sit on inner nodes, so they cannot be applied after the tree is composed. */
+const openApiDecorator = (schema, metadata) => {
+    return schema.openapi(metadata);
+};
+export const { FieldsSchema, FilterSchema, InclusionSchema, LimitSchema, OffsetSchema, OrderBySchema, SkipSchema, WhereSchema, } = buildQuerySchemas({ decorate: openApiDecorator });
+//# sourceMappingURL=index.js.map

package/dist/esm/base/repositories/query-schemas/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/base/repositories/query-schemas/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAyB,MAAM,+BAA+B,CAAC;AAEzF,+bAA+b;AAC/b,OAAO,mBAAmB,CAAC;AAE3B,wVAAwV;AACxV,MAAM,gBAAgB,GAAqB,CAAC,MAAM,EAAE,QAAQ,EAAE,EAAE;IAC9D,OAAQ,MAAc,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;AAC3C,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,EACX,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,WAAW,EACX,YAAY,EACZ,aAAa,EACb,UAAU,EACV,WAAW,GACZ,GAAG,iBAAiB,CAAC,EAAE,QAAQ,EAAE,gBAAgB,EAAE,CAAC,CAAC"}

package/dist/esm/base/request-context/common/index.d.ts

@@ -0,0 +1,2 @@
+export * from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/base/request-context/common/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/base/request-context/common/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC"}

package/dist/esm/base/request-context/common/index.js

@@ -0,0 +1,2 @@
+export * from './types.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/base/request-context/common/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/base/request-context/common/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC"}

package/dist/esm/base/request-context/common/types.d.ts

@@ -0,0 +1,7 @@
+import type { Context } from 'hono';
+/**
+ * Reads the host's ambient request context, synchronously. `undefined` means THERE IS NO REQUEST
+ * CONTEXT - a distinct state from a context that carries no user, and callers act on the difference.
+ */
+export type TRequestContextResolver = () => Context | undefined;
+//# sourceMappingURL=types.d.ts.map

package/dist/esm/base/request-context/common/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/base/request-context/common/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAEpC;;;GAGG;AACH,MAAM,MAAM,uBAAuB,GAAG,MAAM,OAAO,GAAG,SAAS,CAAC"}

package/dist/esm/base/request-context/common/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/esm/base/request-context/common/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../src/base/request-context/common/types.ts"],"names":[],"mappings":""}

package/dist/esm/base/request-context/index.d.ts

@@ -0,0 +1,3 @@
+export * from './common/index.js';
+export * from './registry.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/base/request-context/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/base/request-context/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC"}

package/dist/esm/base/request-context/index.js

@@ -0,0 +1,3 @@
+export * from './common/index.js';
+export * from './registry.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/base/request-context/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/base/request-context/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC"}

package/dist/esm/base/request-context/registry.d.ts

@@ -0,0 +1,13 @@
+import type { Context } from 'hono';
+import type { TRequestContextResolver } from './common/types.js';
+export declare class RequestContextRegistry {
+    static readonly SINGLETON_REAL_KEY = "request-context-resolver";
+    /** Realm-anchored, so a second copy of this package installs the resolver the first copy reads. */
+    private static slot;
+    static setResolver(opts: {
+        resolver: TRequestContextResolver;
+    }): void;
+    static clearResolver(): void;
+    static resolve(): Context | undefined;
+}
+//# sourceMappingURL=registry.d.ts.map

package/dist/esm/base/request-context/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../../src/base/request-context/registry.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACpC,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AAgB9D,qBAAa,sBAAsB;IACjC,MAAM,CAAC,QAAQ,CAAC,kBAAkB,8BAA8B;IAEhE,mGAAmG;IACnG,OAAO,CAAC,MAAM,CAAC,IAAI;IAOnB,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE;QAAE,QAAQ,EAAE,uBAAuB,CAAA;KAAE,GAAG,IAAI;IAIrE,MAAM,CAAC,aAAa,IAAI,IAAI;IAI5B,MAAM,CAAC,OAAO,IAAI,OAAO,GAAG,SAAS;CAGtC"}

package/dist/esm/base/request-context/registry.js

@@ -0,0 +1,21 @@
+import { SingletonRealm } from '../../helpers/singleton-realm.js';
+export class RequestContextRegistry {
+    static { this.SINGLETON_REAL_KEY = 'request-context-resolver'; }
+    /** Realm-anchored, so a second copy of this package installs the resolver the first copy reads. */
+    static slot() {
+        return SingletonRealm.resolve({
+            key: RequestContextRegistry.SINGLETON_REAL_KEY,
+            create: () => ({ resolver: undefined }),
+        });
+    }
+    static setResolver(opts) {
+        this.slot().resolver = opts.resolver;
+    }
+    static clearResolver() {
+        this.slot().resolver = undefined;
+    }
+    static resolve() {
+        return this.slot().resolver?.();
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist/esm/base/request-context/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../../src/base/request-context/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAkB3D,MAAM,OAAO,sBAAsB;aACjB,uBAAkB,GAAG,0BAA0B,CAAC;IAEhE,mGAAmG;IAC3F,MAAM,CAAC,IAAI;QACjB,OAAO,cAAc,CAAC,OAAO,CAAC;YAC5B,GAAG,EAAE,sBAAsB,CAAC,kBAAkB;YAC9C,MAAM,EAAE,GAAkB,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;SACvD,CAAC,CAAC;IACL,CAAC;IAED,MAAM,CAAC,WAAW,CAAC,IAA2C;QAC5D,IAAI,CAAC,IAAI,EAAE,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;IACvC,CAAC;IAED,MAAM,CAAC,aAAa;QAClB,IAAI,CAAC,IAAI,EAAE,CAAC,QAAQ,GAAG,SAAS,CAAC;IACnC,CAAC;IAED,MAAM,CAAC,OAAO;QACZ,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC;IAClC,CAAC"}

package/dist/esm/base/services/base-crud.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=base-crud.d.ts.map