@venizia/ignis-kernel 0.2.0-0

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

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

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

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

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

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

package/dist/esm/base/providers/base.d.ts

@@ -0,0 +1,7 @@
+import type { Container } from '../../helpers/inversion/index.js';
+import { BaseHelper } from '@venizia/ignis-helpers/core';
+import type { IProvider } from '@venizia/ignis-inversion';
+export declare abstract class BaseProvider<T> extends BaseHelper implements IProvider<T> {
+    abstract value(container: Container): T;
+}
+//# sourceMappingURL=base.d.ts.map

package/dist/esm/base/providers/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../../src/base/providers/base.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AACzD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAE1D,8BAAsB,YAAY,CAAC,CAAC,CAAE,SAAQ,UAAW,YAAW,SAAS,CAAC,CAAC,CAAC;IAC9E,QAAQ,CAAC,KAAK,CAAC,SAAS,EAAE,SAAS,GAAG,CAAC;CACxC"}

package/dist/esm/base/providers/base.js

@@ -0,0 +1,4 @@
+import { BaseHelper } from '@venizia/ignis-helpers/core';
+export class BaseProvider extends BaseHelper {
+}
+//# sourceMappingURL=base.js.map

package/dist/esm/base/providers/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../../../src/base/providers/base.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAGzD,MAAM,OAAgB,YAAgB,SAAQ,UAAU;CAEvD"}

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

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

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

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

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

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

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

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

package/dist/esm/base/repositories/common/constants.d.ts

@@ -0,0 +1,53 @@
+import type { TConstValue } from '@venizia/ignis-helpers/common';
+/** Default pagination limit for repository queries. */
+export declare const DEFAULT_LIMIT = 10;
+/**
+ * Largest `limit` a caller may ask for when a model declares no `maxLimit`.
+ *
+ * POLICY, not capacity - it sits far below what an engine can physically serve. It exists because
+ * removing an accidental guardrail without replacing it would leave the framework less safe than
+ * before: a search engine refused a page over 250 hits, so `limit: 5000` failed fast and cheap.
+ * Once that page is served, something has to decide when a page is unreasonable.
+ *
+ * 1000 sits above any list screen and well below the physical ceiling, so reaching it means the
+ * caller is doing something unusual - and a model raises it by saying so explicitly.
+ */
+export declare const DEFAULT_MAX_LIMIT = 1000;
+/** Defines the operation scope for repository instances (READ_ONLY, WRITE_ONLY, READ_WRITE). */
+export declare class RepositoryOperationScopes {
+    static readonly READ_ONLY = "READ_ONLY";
+    static readonly WRITE_ONLY = "WRITE_ONLY";
+    static readonly READ_WRITE = "READ_WRITE";
+    static readonly SCHEME_SET: Set<string>;
+    static isValid(orgType: string): boolean;
+}
+/** Valid repository operation scope values. */
+export type TRepositoryOperationScope = TConstValue<typeof RepositoryOperationScopes>;
+/** Machine-readable codes for repository-level failures, in the dotted namespace core already uses (`core.not_supported`, `core.search_engine.*`) - a client maps the code, never the message. */
+export declare class RepositoryErrorCodes {
+    /** A verb the repository's `operationScope` does not permit (e.g. `create()` on a READ_ONLY one). */
+    static readonly OPERATION_NOT_ALLOWED: string;
+}
+/** Valid repository error code values. */
+export type TRepositoryErrorCode = TConstValue<typeof RepositoryErrorCodes>;
+/** Entity relation types (one-to-one/many-to-one, one-to-many). */
+export declare class RelationTypes {
+    static readonly ONE = "one";
+    static readonly MANY = "many";
+    static readonly SCHEME_SET: Set<string>;
+    static isValid(orgType: string): boolean;
+}
+/** Valid relation type values. */
+export type TRelationType = TConstValue<typeof RelationTypes>;
+/** PostgreSQL row-level lock strengths for SELECT ... FOR <strength>. */
+export declare class LockStrengths {
+    static readonly UPDATE = "update";
+    static readonly NO_KEY_UPDATE = "no key update";
+    static readonly SHARE = "share";
+    static readonly KEY_SHARE = "key share";
+    static readonly SCHEME_SET: Set<string>;
+    static isValid(strength: string): boolean;
+}
+/** Valid lock strength values. */
+export type TLockStrength = TConstValue<typeof LockStrengths>;
+//# sourceMappingURL=constants.d.ts.map

package/dist/esm/base/repositories/common/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../../src/base/repositories/common/constants.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAGjE,uDAAuD;AACvD,eAAO,MAAM,aAAa,KAAK,CAAC;AAEhC;;;;;;;;;;GAUG;AACH,eAAO,MAAM,iBAAiB,OAAO,CAAC;AAEtC,gGAAgG;AAChG,qBAAa,yBAAyB;IACpC,MAAM,CAAC,QAAQ,CAAC,SAAS,eAAe;IACxC,MAAM,CAAC,QAAQ,CAAC,UAAU,gBAAgB;IAC1C,MAAM,CAAC,QAAQ,CAAC,UAAU,gBAAgB;IAC1C,MAAM,CAAC,QAAQ,CAAC,UAAU,cAA+D;IAEzF,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;CAGzC;AAED,+CAA+C;AAC/C,MAAM,MAAM,yBAAyB,GAAG,WAAW,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAEtF,kMAAkM;AAClM,qBAAa,oBAAoB;IAC/B,qGAAqG;IACrG,MAAM,CAAC,QAAQ,CAAC,qBAAqB,SAElC;CACJ;AAED,0CAA0C;AAC1C,MAAM,MAAM,oBAAoB,GAAG,WAAW,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAE5E,mEAAmE;AACnE,qBAAa,aAAa;IACxB,MAAM,CAAC,QAAQ,CAAC,GAAG,SAAS;IAC5B,MAAM,CAAC,QAAQ,CAAC,IAAI,UAAU;IAC9B,MAAM,CAAC,QAAQ,CAAC,UAAU,cAAkC;IAE5D,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;CAGzC;AAED,kCAAkC;AAClC,MAAM,MAAM,aAAa,GAAG,WAAW,CAAC,OAAO,aAAa,CAAC,CAAC;AAE9D,yEAAyE;AACzE,qBAAa,aAAa;IACxB,MAAM,CAAC,QAAQ,CAAC,MAAM,YAAY;IAClC,MAAM,CAAC,QAAQ,CAAC,aAAa,mBAAmB;IAChD,MAAM,CAAC,QAAQ,CAAC,KAAK,WAAW;IAChC,MAAM,CAAC,QAAQ,CAAC,SAAS,eAAe;IACxC,MAAM,CAAC,QAAQ,CAAC,UAAU,cAKvB;IAEH,MAAM,CAAC,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;CAG1C;AAED,kCAAkC;AAClC,MAAM,MAAM,aAAa,GAAG,WAAW,CAAC,OAAO,aAAa,CAAC,CAAC"}

package/dist/esm/base/repositories/common/constants.js

@@ -0,0 +1,58 @@
+import { MessageCode } from '@venizia/ignis-helpers/core';
+/** Default pagination limit for repository queries. */
+export const DEFAULT_LIMIT = 10;
+/**
+ * Largest `limit` a caller may ask for when a model declares no `maxLimit`.
+ *
+ * POLICY, not capacity - it sits far below what an engine can physically serve. It exists because
+ * removing an accidental guardrail without replacing it would leave the framework less safe than
+ * before: a search engine refused a page over 250 hits, so `limit: 5000` failed fast and cheap.
+ * Once that page is served, something has to decide when a page is unreasonable.
+ *
+ * 1000 sits above any list screen and well below the physical ceiling, so reaching it means the
+ * caller is doing something unusual - and a model raises it by saying so explicitly.
+ */
+export const DEFAULT_MAX_LIMIT = 1000;
+/** Defines the operation scope for repository instances (READ_ONLY, WRITE_ONLY, READ_WRITE). */
+export class RepositoryOperationScopes {
+    static { this.READ_ONLY = 'READ_ONLY'; }
+    static { this.WRITE_ONLY = 'WRITE_ONLY'; }
+    static { this.READ_WRITE = 'READ_WRITE'; }
+    static { this.SCHEME_SET = new Set([this.READ_ONLY, this.WRITE_ONLY, this.READ_WRITE]); }
+    static isValid(orgType) {
+        return this.SCHEME_SET.has(orgType);
+    }
+}
+/** Machine-readable codes for repository-level failures, in the dotted namespace core already uses (`core.not_supported`, `core.search_engine.*`) - a client maps the code, never the message. */
+export class RepositoryErrorCodes {
+    /** A verb the repository's `operationScope` does not permit (e.g. `create()` on a READ_ONLY one). */
+    static { this.OPERATION_NOT_ALLOWED = MessageCode.build({
+        parts: ['core', 'repository', 'operation_not_allowed'],
+    }); }
+}
+/** Entity relation types (one-to-one/many-to-one, one-to-many). */
+export class RelationTypes {
+    static { this.ONE = 'one'; }
+    static { this.MANY = 'many'; }
+    static { this.SCHEME_SET = new Set([this.ONE, this.MANY]); }
+    static isValid(orgType) {
+        return this.SCHEME_SET.has(orgType);
+    }
+}
+/** PostgreSQL row-level lock strengths for SELECT ... FOR <strength>. */
+export class LockStrengths {
+    static { this.UPDATE = 'update'; }
+    static { this.NO_KEY_UPDATE = 'no key update'; }
+    static { this.SHARE = 'share'; }
+    static { this.KEY_SHARE = 'key share'; }
+    static { this.SCHEME_SET = new Set([
+        this.UPDATE,
+        this.NO_KEY_UPDATE,
+        this.SHARE,
+        this.KEY_SHARE,
+    ]); }
+    static isValid(strength) {
+        return this.SCHEME_SET.has(strength);
+    }
+}
+//# sourceMappingURL=constants.js.map

package/dist/esm/base/repositories/common/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../../src/base/repositories/common/constants.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAE1D,uDAAuD;AACvD,MAAM,CAAC,MAAM,aAAa,GAAG,EAAE,CAAC;AAEhC;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,CAAC;AAEtC,gGAAgG;AAChG,MAAM,OAAO,yBAAyB;aACpB,cAAS,GAAG,WAAW,CAAC;aACxB,eAAU,GAAG,YAAY,CAAC;aAC1B,eAAU,GAAG,YAAY,CAAC;aAC1B,eAAU,GAAG,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;IAEzF,MAAM,CAAC,OAAO,CAAC,OAAe;QAC5B,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACtC,CAAC;;AAMH,kMAAkM;AAClM,MAAM,OAAO,oBAAoB;IAC/B,qGAAqG;aACrF,0BAAqB,GAAG,WAAW,CAAC,KAAK,CAAC;QACxD,KAAK,EAAE,CAAC,MAAM,EAAE,YAAY,EAAE,uBAAuB,CAAC;KACvD,CAAC,CAAC;;AAML,mEAAmE;AACnE,MAAM,OAAO,aAAa;aACR,QAAG,GAAG,KAAK,CAAC;aACZ,SAAI,GAAG,MAAM,CAAC;aACd,eAAU,GAAG,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAE5D,MAAM,CAAC,OAAO,CAAC,OAAe;QAC5B,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACtC,CAAC;;AAMH,yEAAyE;AACzE,MAAM,OAAO,aAAa;aACR,WAAM,GAAG,QAAQ,CAAC;aAClB,kBAAa,GAAG,eAAe,CAAC;aAChC,UAAK,GAAG,OAAO,CAAC;aAChB,cAAS,GAAG,WAAW,CAAC;aACxB,eAAU,GAAG,IAAI,GAAG,CAAC;QACnC,IAAI,CAAC,MAAM;QACX,IAAI,CAAC,aAAa;QAClB,IAAI,CAAC,KAAK;QACV,IAAI,CAAC,SAAS;KACf,CAAC,CAAC;IAEH,MAAM,CAAC,OAAO,CAAC,QAAgB;QAC7B,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACvC,CAAC"}

package/dist/esm/base/repositories/common/errors.d.ts

@@ -0,0 +1,18 @@
+import type { TRegisterErrors } from '@venizia/ignis-helpers/core';
+/** Codes a client branches on for a repository-level failure that is the caller's fault, not the server's. */
+export declare const RepositoryErrors: {
+    readonly ENTITY_NOT_FOUND: {
+        readonly message: {
+            readonly text: "Entity not found";
+            readonly code: "core.repository.entity_not_found";
+        };
+        readonly statusCode: 404;
+        readonly category: "business";
+    };
+};
+/** Registers these codes with the shared key registry so a consumer gets autocomplete on `messageCode`. Augments the `/core` subpath, not the root barrel - kernel never imports the bare package, so nothing else in this program would make the root specifier resolvable for the merge. */
+declare module '@venizia/ignis-helpers/core' {
+    interface IErrorKeyRegistry extends TRegisterErrors<typeof RepositoryErrors> {
+    }
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/esm/base/repositories/common/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../../../src/base/repositories/common/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAoB,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAIrF,8GAA8G;AAC9G,eAAO,MAAM,gBAAgB;;;;;;;;;CAMwB,CAAC;AAEtD,8RAA8R;AAC9R,OAAO,QAAQ,6BAA6B,CAAC;IAC3C,UAAU,iBAAkB,SAAQ,eAAe,CAAC,OAAO,gBAAgB,CAAC;KAAG;CAChF"}

package/dist/esm/base/repositories/common/errors.js

@@ -0,0 +1,11 @@
+import { ErrorScopes } from '@venizia/ignis-helpers/core';
+import { HTTP } from '@venizia/ignis-helpers/common';
+/** Codes a client branches on for a repository-level failure that is the caller's fault, not the server's. */
+export const RepositoryErrors = {
+    ENTITY_NOT_FOUND: {
+        message: { text: 'Entity not found', code: 'core.repository.entity_not_found' },
+        statusCode: HTTP.ResultCodes.RS_4.NotFound,
+        category: ErrorScopes.BUSINESS,
+    },
+};
+//# sourceMappingURL=errors.js.map

package/dist/esm/base/repositories/common/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../../../src/base/repositories/common/errors.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC1D,OAAO,EAAE,IAAI,EAAE,MAAM,+BAA+B,CAAC;AAErD,8GAA8G;AAC9G,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,gBAAgB,EAAE;QAChB,OAAO,EAAE,EAAE,IAAI,EAAE,kBAAkB,EAAE,IAAI,EAAE,kCAAkC,EAAE;QAC/E,UAAU,EAAE,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,QAAQ;QAC1C,QAAQ,EAAE,WAAW,CAAC,QAAQ;KAC/B;CACkD,CAAC"}

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

@@ -0,0 +1,7 @@
+/** The filter vocabulary (operators, sorts, the `TFilter` shape) lives in `@venizia/ignis-filter` so a browser data layer can speak the same language; re-exported here so every existing `@venizia/ignis-core` import keeps resolving. */
+export * from '@venizia/ignis-filter';
+export * from './errors.js';
+export * from '../query-schemas/index.js';
+export * from './constants.js';
+export * from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/base/repositories/common/index.ts"],"names":[],"mappings":"AAAA,2OAA2O;AAC3O,cAAc,uBAAuB,CAAC;AAEtC,cAAc,UAAU,CAAC;AACzB,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC"}

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

@@ -0,0 +1,7 @@
+/** The filter vocabulary (operators, sorts, the `TFilter` shape) lives in `@venizia/ignis-filter` so a browser data layer can speak the same language; re-exported here so every existing `@venizia/ignis-core` import keeps resolving. */
+export * from '@venizia/ignis-filter';
+export * from './errors.js';
+export * from '../query-schemas/index.js';
+export * from './constants.js';
+export * from './types.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/base/repositories/common/index.ts"],"names":[],"mappings":"AAAA,2OAA2O;AAC3O,cAAc,uBAAuB,CAAC;AAEtC,cAAc,UAAU,CAAC;AACzB,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC"}

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

@@ -0,0 +1,331 @@
+import type { AbstractDataSource, ITransaction } from '../../../base/datasources/index.js';
+import type { AbstractEntity, IdType } from '../../../base/models/index.js';
+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.js';
+/** 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/esm/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/esm/base/repositories/common/types.js

@@ -0,0 +1,14 @@
+import { z } from '@hono/zod-openapi';
+/** Zod schema for count operation results. */
+export const CountSchema = z.object({ count: 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`. */
+export 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 };
+};
+//# sourceMappingURL=types.js.map

package/dist/esm/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,OAAO,EAAE,CAAC,EAAE,MAAM,mBAAmB,CAAC;AAatC,8CAA8C;AAC9C,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,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;AACnG,MAAM,CAAC,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"}