@venizia/ignis-kernel 0.4.2 → 0.4.4

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

@@ -1,23 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-/** 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. */
-__exportStar(require("@venizia/ignis-filter"), exports);
-__exportStar(require("./errors"), exports);
-__exportStar(require("../query-schemas"), exports);
-__exportStar(require("./constants"), exports);
-__exportStar(require("./types"), exports);
-//# sourceMappingURL=index.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/base/repositories/common/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2OAA2O;AAC3O,wDAAsC;AAEtC,2CAAyB;AACzB,mDAAiC;AACjC,8CAA4B;AAC5B,0CAAwB","sourcesContent":["/** 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. */\nexport * from '@venizia/ignis-filter';\n\nexport * from './errors';\nexport * from '../query-schemas';\nexport * from './constants';\nexport * from './types';\n"]}

package/dist/cjs/base/repositories/common/response-reader.d.ts

@@ -1,68 +0,0 @@
-import type { ApplicationError, TResponsedError } from '@venizia/ignis-helpers/core';
-/**
- * What an IGNIS server answers - `Content-Range`, the error envelope - read once, here, for every
- * client of that server: the http connector, and a client that reads it without the connector.
- */
-export declare class HttpResponseReader {
-    static isPlainObject(value: unknown): value is Record<string, unknown>;
-    /** An empty string reads as absent, so a fallback still applies. */
-    static toText(value: unknown): string | undefined;
-    /**
-     * A `Content-Range` header as the IGNIS server writes it: `records 0-24/137` -> skip 0, total 137;
-     * an empty page, `records *\/137` -> total 137. Anything else, including an absent header or an
-     * unknown total, is `undefined`.
-     */
-    static parseContentRange(opts: {
-        header?: string | null;
-    }): {
-        skip?: number;
-        total: number;
-    } | undefined;
-    /**
-     * The IGNIS error envelope - `{ message, statusCode, normalized: { text, code, args }, requestId,
-     * extra, details }` - read off a parsed response body. A server configured with `error.rootKey`
-     * wraps it under that key; pass the same `rootKey` to unwrap it. A body without that key, or with a
-     * non-object under it (a proxy's `{ error: 'Bad Gateway' }`), is read as it stands.
-     *
-     * A body that is not a plain object yields `{}`; any other body yields its known fields, each
-     * `undefined` when absent or mistyped. An empty string reads as absent.
-     */
-    static readErrorEnvelope(opts: {
-        body: unknown;
-        rootKey?: string;
-    }): TResponsedError;
-    /** A failed response's envelope. A body that is not JSON yields `{}`, and the status alone still describes it. */
-    static readError(opts: {
-        response: Response;
-        rootKey?: string;
-    }): Promise<TResponsedError>;
-    /**
-     * A failed response as the error the server threw: its status, code, args and text, and its
-     * `extra` with the `requestId` added. `message` is `context` plus the server's text, for logs;
-     * `normalized.text` stays the server's, for display - `HTTP <status>` when the server sent none.
-     * `cause` is the server's `details.cause` - a 422's per-field issues, `{ path, message, code }`.
-     *
-     * `requestId` names the request this client made. A relaying server's `extra` carries the id of
-     * the request it made upstream: it joins `upstreamRequestIds`, nearest first, at every hop.
-     */
-    static toApplicationError(opts: {
-        response: Response;
-        /** Where it failed, for logs - e.g. `[HttpDataSource][read] 404 | /tickets`. */
-        context: string;
-        rootKey?: string;
-    }): Promise<ApplicationError>;
-    /**
-     * A body the server marked with `x-response-extra` carries `extra` beside its rows. `body` is what
-     * the route answers without extras: the `{ count, data }` envelope when the count was asked for in
-     * the body, the rows otherwise. Any other body is returned as it stands - an unmarked object is
-     * never unwrapped, so a row that has `data` and `extra` columns of its own is never misread.
-     */
-    static readExtra(opts: {
-        body: unknown;
-        headers: Pick<Headers, 'has'>;
-    }): {
-        body: unknown;
-        extra?: Record<string, unknown>;
-    };
-}
-//# sourceMappingURL=response-reader.d.ts.map

package/dist/cjs/base/repositories/common/response-reader.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"response-reader.d.ts","sourceRoot":"","sources":["../../../../../src/base/repositories/common/response-reader.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAErF;;;GAGG;AACH,qBAAa,kBAAkB;IAC7B,MAAM,CAAC,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAMtE,oEAAoE;IACpE,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS;IAIjD;;;;OAIG;IACH,MAAM,CAAC,iBAAiB,CAAC,IAAI,EAAE;QAC7B,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KACxB,GAAG;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS;IAoBhD;;;;;;;;OAQG;IACH,MAAM,CAAC,iBAAiB,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,eAAe;IA4BpF,kHAAkH;WACrG,SAAS,CAAC,IAAI,EAAE;QAAE,QAAQ,EAAE,QAAQ,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,eAAe,CAAC;IAahG;;;;;;;;OAQG;WACU,kBAAkB,CAAC,IAAI,EAAE;QACpC,QAAQ,EAAE,QAAQ,CAAC;QACnB,gFAAgF;QAChF,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA4B7B;;;;;OAKG;IACH,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAA;KAAE,GAAG;QACxE,IAAI,EAAE,OAAO,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACjC;CAeF"}

package/dist/cjs/base/repositories/common/response-reader.js

@@ -1,134 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.HttpResponseReader = void 0;
-const common_1 = require("@venizia/ignis-helpers/common");
-const core_1 = require("@venizia/ignis-helpers/core");
-/**
- * What an IGNIS server answers - `Content-Range`, the error envelope - read once, here, for every
- * client of that server: the http connector, and a client that reads it without the connector.
- */
-class HttpResponseReader {
-    static isPlainObject(value) {
-        return (!!value && typeof value === 'object' && Object.getPrototypeOf(value) === Object.prototype);
-    }
-    /** An empty string reads as absent, so a fallback still applies. */
-    static toText(value) {
-        return typeof value === 'string' && value !== '' ? value : undefined;
-    }
-    /**
-     * A `Content-Range` header as the IGNIS server writes it: `records 0-24/137` -> skip 0, total 137;
-     * an empty page, `records *\/137` -> total 137. Anything else, including an absent header or an
-     * unknown total, is `undefined`.
-     */
-    static parseContentRange(opts) {
-        const { header } = opts;
-        if (!header) {
-            return undefined;
-        }
-        const range = header.match(/(\d+)\s*-\s*(\d+)\s*\/\s*(\d+)/);
-        if (range) {
-            return { skip: Number(range[1]), total: Number(range[3]) };
-        }
-        const unsatisfied = header.match(/\*\s*\/\s*(\d+)/);
-        if (unsatisfied) {
-            return { total: Number(unsatisfied[1]) };
-        }
-        return undefined;
-    }
-    /**
-     * The IGNIS error envelope - `{ message, statusCode, normalized: { text, code, args }, requestId,
-     * extra, details }` - read off a parsed response body. A server configured with `error.rootKey`
-     * wraps it under that key; pass the same `rootKey` to unwrap it. A body without that key, or with a
-     * non-object under it (a proxy's `{ error: 'Bad Gateway' }`), is read as it stands.
-     *
-     * A body that is not a plain object yields `{}`; any other body yields its known fields, each
-     * `undefined` when absent or mistyped. An empty string reads as absent.
-     */
-    static readErrorEnvelope(opts) {
-        const { body, rootKey } = opts;
-        const wrapped = rootKey && HttpResponseReader.isPlainObject(body) ? body[rootKey] : undefined;
-        const envelope = HttpResponseReader.isPlainObject(wrapped) ? wrapped : body;
-        if (!HttpResponseReader.isPlainObject(envelope)) {
-            return {};
-        }
-        const { message, statusCode, normalized, requestId, extra, details } = envelope;
-        const normalizedRecord = HttpResponseReader.isPlainObject(normalized) ? normalized : {};
-        const { text, code, args } = normalizedRecord;
-        return {
-            message: HttpResponseReader.toText(message),
-            statusCode: typeof statusCode === 'number' ? statusCode : undefined,
-            normalized: {
-                text: HttpResponseReader.toText(text),
-                code: HttpResponseReader.toText(code),
-                args: HttpResponseReader.isPlainObject(args) ? { ...args } : undefined,
-            },
-            requestId: HttpResponseReader.toText(requestId),
-            extra: HttpResponseReader.isPlainObject(extra) ? { ...extra } : undefined,
-            details: HttpResponseReader.isPlainObject(details) ? { ...details } : undefined,
-        };
-    }
-    /** A failed response's envelope. A body that is not JSON yields `{}`, and the status alone still describes it. */
-    static async readError(opts) {
-        const text = await opts.response.text().catch(() => '');
-        let body;
-        try {
-            body = text ? JSON.parse(text) : undefined;
-        }
-        catch {
-            return {};
-        }
-        return HttpResponseReader.readErrorEnvelope({ body, rootKey: opts.rootKey });
-    }
-    /**
-     * A failed response as the error the server threw: its status, code, args and text, and its
-     * `extra` with the `requestId` added. `message` is `context` plus the server's text, for logs;
-     * `normalized.text` stays the server's, for display - `HTTP <status>` when the server sent none.
-     * `cause` is the server's `details.cause` - a 422's per-field issues, `{ path, message, code }`.
-     *
-     * `requestId` names the request this client made. A relaying server's `extra` carries the id of
-     * the request it made upstream: it joins `upstreamRequestIds`, nearest first, at every hop.
-     */
-    static async toApplicationError(opts) {
-        const { response, context, rootKey } = opts;
-        const server = await HttpResponseReader.readError({ response, rootKey });
-        const serverText = server.normalized?.text ?? server.message;
-        const displayText = serverText ?? `HTTP ${response.status}`;
-        const extra = { ...server.extra };
-        if (server.requestId) {
-            const upstreamRequestId = extra.requestId;
-            extra.requestId = server.requestId;
-            if (upstreamRequestId !== undefined && upstreamRequestId !== server.requestId) {
-                const known = Array.isArray(extra.upstreamRequestIds) ? extra.upstreamRequestIds : [];
-                extra.upstreamRequestIds = [upstreamRequestId, ...known];
-            }
-        }
-        return (0, core_1.getError)({
-            statusCode: response.status,
-            message: serverText ? `${context} | ${serverText}` : context,
-            messageCode: server.normalized?.code,
-            messageArgs: server.normalized?.args,
-            extra: Object.keys(extra).length > 0 ? extra : undefined,
-            cause: server.details?.cause,
-            transform: ({ message }) => ({ ...message, text: displayText }),
-        });
-    }
-    /**
-     * A body the server marked with `x-response-extra` carries `extra` beside its rows. `body` is what
-     * the route answers without extras: the `{ count, data }` envelope when the count was asked for in
-     * the body, the rows otherwise. Any other body is returned as it stands - an unmarked object is
-     * never unwrapped, so a row that has `data` and `extra` columns of its own is never misread.
-     */
-    static readExtra(opts) {
-        const { body, headers } = opts;
-        const isMarked = headers.has(common_1.HTTP.Headers.RESPONSE_EXTRA);
-        if (!isMarked ||
-            !HttpResponseReader.isPlainObject(body) ||
-            !HttpResponseReader.isPlainObject(body.extra)) {
-            return { body };
-        }
-        const { extra, ...envelope } = body;
-        return { body: 'count' in envelope ? envelope : envelope.data, extra: { ...extra } };
-    }
-}
-exports.HttpResponseReader = HttpResponseReader;
-//# sourceMappingURL=response-reader.js.map

package/dist/cjs/base/repositories/common/response-reader.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"response-reader.js","sourceRoot":"","sources":["../../../../../src/base/repositories/common/response-reader.ts"],"names":[],"mappings":"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","sourcesContent":["import { HTTP } from '@venizia/ignis-helpers/common';\nimport { getError } from '@venizia/ignis-helpers/core';\nimport type { ApplicationError, TResponsedError } from '@venizia/ignis-helpers/core';\n\n/**\n * What an IGNIS server answers - `Content-Range`, the error envelope - read once, here, for every\n * client of that server: the http connector, and a client that reads it without the connector.\n */\nexport class HttpResponseReader {\n  static isPlainObject(value: unknown): value is Record<string, unknown> {\n    return (\n      !!value && typeof value === 'object' && Object.getPrototypeOf(value) === Object.prototype\n    );\n  }\n\n  /** An empty string reads as absent, so a fallback still applies. */\n  static toText(value: unknown): string | undefined {\n    return typeof value === 'string' && value !== '' ? value : undefined;\n  }\n\n  /**\n   * A `Content-Range` header as the IGNIS server writes it: `records 0-24/137` -> skip 0, total 137;\n   * an empty page, `records *\\/137` -> total 137. Anything else, including an absent header or an\n   * unknown total, is `undefined`.\n   */\n  static parseContentRange(opts: {\n    header?: string | null;\n  }): { skip?: number; total: number } | undefined {\n    const { header } = opts;\n\n    if (!header) {\n      return undefined;\n    }\n\n    const range = header.match(/(\\d+)\\s*-\\s*(\\d+)\\s*\\/\\s*(\\d+)/);\n    if (range) {\n      return { skip: Number(range[1]), total: Number(range[3]) };\n    }\n\n    const unsatisfied = header.match(/\\*\\s*\\/\\s*(\\d+)/);\n    if (unsatisfied) {\n      return { total: Number(unsatisfied[1]) };\n    }\n\n    return undefined;\n  }\n\n  /**\n   * The IGNIS error envelope - `{ message, statusCode, normalized: { text, code, args }, requestId,\n   * extra, details }` - read off a parsed response body. A server configured with `error.rootKey`\n   * wraps it under that key; pass the same `rootKey` to unwrap it. A body without that key, or with a\n   * non-object under it (a proxy's `{ error: 'Bad Gateway' }`), is read as it stands.\n   *\n   * A body that is not a plain object yields `{}`; any other body yields its known fields, each\n   * `undefined` when absent or mistyped. An empty string reads as absent.\n   */\n  static readErrorEnvelope(opts: { body: unknown; rootKey?: string }): TResponsedError {\n    const { body, rootKey } = opts;\n\n    const wrapped = rootKey && HttpResponseReader.isPlainObject(body) ? body[rootKey] : undefined;\n    const envelope = HttpResponseReader.isPlainObject(wrapped) ? wrapped : body;\n\n    if (!HttpResponseReader.isPlainObject(envelope)) {\n      return {};\n    }\n\n    const { message, statusCode, normalized, requestId, extra, details } = envelope;\n    const normalizedRecord = HttpResponseReader.isPlainObject(normalized) ? normalized : {};\n    const { text, code, args } = normalizedRecord;\n\n    return {\n      message: HttpResponseReader.toText(message),\n      statusCode: typeof statusCode === 'number' ? statusCode : undefined,\n      normalized: {\n        text: HttpResponseReader.toText(text),\n        code: HttpResponseReader.toText(code),\n        args: HttpResponseReader.isPlainObject(args) ? { ...args } : undefined,\n      },\n      requestId: HttpResponseReader.toText(requestId),\n      extra: HttpResponseReader.isPlainObject(extra) ? { ...extra } : undefined,\n      details: HttpResponseReader.isPlainObject(details) ? { ...details } : undefined,\n    };\n  }\n\n  /** A failed response's envelope. A body that is not JSON yields `{}`, and the status alone still describes it. */\n  static async readError(opts: { response: Response; rootKey?: string }): Promise<TResponsedError> {\n    const text = await opts.response.text().catch(() => '');\n\n    let body: unknown;\n    try {\n      body = text ? JSON.parse(text) : undefined;\n    } catch {\n      return {};\n    }\n\n    return HttpResponseReader.readErrorEnvelope({ body, rootKey: opts.rootKey });\n  }\n\n  /**\n   * A failed response as the error the server threw: its status, code, args and text, and its\n   * `extra` with the `requestId` added. `message` is `context` plus the server's text, for logs;\n   * `normalized.text` stays the server's, for display - `HTTP <status>` when the server sent none.\n   * `cause` is the server's `details.cause` - a 422's per-field issues, `{ path, message, code }`.\n   *\n   * `requestId` names the request this client made. A relaying server's `extra` carries the id of\n   * the request it made upstream: it joins `upstreamRequestIds`, nearest first, at every hop.\n   */\n  static async toApplicationError(opts: {\n    response: Response;\n    /** Where it failed, for logs - e.g. `[HttpDataSource][read] 404 | /tickets`. */\n    context: string;\n    rootKey?: string;\n  }): Promise<ApplicationError> {\n    const { response, context, rootKey } = opts;\n    const server = await HttpResponseReader.readError({ response, rootKey });\n    const serverText = server.normalized?.text ?? server.message;\n    const displayText = serverText ?? `HTTP ${response.status}`;\n\n    const extra: Record<string, unknown> = { ...server.extra };\n    if (server.requestId) {\n      const upstreamRequestId = extra.requestId;\n      extra.requestId = server.requestId;\n\n      if (upstreamRequestId !== undefined && upstreamRequestId !== server.requestId) {\n        const known = Array.isArray(extra.upstreamRequestIds) ? extra.upstreamRequestIds : [];\n        extra.upstreamRequestIds = [upstreamRequestId, ...known];\n      }\n    }\n\n    return getError({\n      statusCode: response.status,\n      message: serverText ? `${context} | ${serverText}` : context,\n      messageCode: server.normalized?.code,\n      messageArgs: server.normalized?.args,\n      extra: Object.keys(extra).length > 0 ? extra : undefined,\n      cause: server.details?.cause,\n      transform: ({ message }) => ({ ...message, text: displayText }),\n    });\n  }\n\n  /**\n   * A body the server marked with `x-response-extra` carries `extra` beside its rows. `body` is what\n   * the route answers without extras: the `{ count, data }` envelope when the count was asked for in\n   * the body, the rows otherwise. Any other body is returned as it stands - an unmarked object is\n   * never unwrapped, so a row that has `data` and `extra` columns of its own is never misread.\n   */\n  static readExtra(opts: { body: unknown; headers: Pick<Headers, 'has'> }): {\n    body: unknown;\n    extra?: Record<string, unknown>;\n  } {\n    const { body, headers } = opts;\n    const isMarked = headers.has(HTTP.Headers.RESPONSE_EXTRA);\n\n    if (\n      !isMarked ||\n      !HttpResponseReader.isPlainObject(body) ||\n      !HttpResponseReader.isPlainObject(body.extra)\n    ) {\n      return { body };\n    }\n\n    const { extra, ...envelope } = body;\n    return { body: 'count' in envelope ? envelope : envelope.data, extra: { ...extra } };\n  }\n}\n"]}

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

@@ -1,208 +0,0 @@
-import type { AbstractDataSource } from '../../../datasources';
-import type { AbstractEntity, IdType } from '../../../models';
-import type { TByIdFilter, TFields, TFilter, TRow, TWhere } from '@venizia/ignis-filter';
-import type { TNullable } from '@venizia/ignis-helpers/common';
-import type { IExtraOptions, TFindOneOptions, TFindOptions, TFindRangeOptions } from './options';
-import type { TCount, TDataWithRange } from './results';
-/**
- * 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 = unknown, const F extends TFields<TDataObject> = TFields<TDataObject>>(opts: {
-        filter: TFilter<TDataObject, F>;
-        options: TFindRangeOptions<ExtraOptions, TRow<TDataObject, R, F>>;
-    }): Promise<TDataWithRange<TRow<TDataObject, R, F>>>;
-    find<R = unknown, const F extends TFields<TDataObject> = TFields<TDataObject>>(opts: {
-        filter: TFilter<TDataObject, F>;
-        options?: TFindOptions<ExtraOptions, TRow<TDataObject, R, F>>;
-    }): Promise<Array<TRow<TDataObject, R, F>>>;
-    findOne<R = unknown, const F extends TFields<TDataObject> = TFields<TDataObject>>(opts: {
-        filter: TFilter<TDataObject, F>;
-        options?: TFindOneOptions<ExtraOptions, TRow<TDataObject, R, F>>;
-    }): Promise<TNullable<TRow<TDataObject, R, F>>>;
-    findById<R = unknown, const F extends TFields<TDataObject> = TFields<TDataObject>>(opts: {
-        id: IdType;
-        filter?: TByIdFilter<TDataObject, F>;
-        options?: TFindOneOptions<ExtraOptions, TRow<TDataObject, R, F>>;
-    }): Promise<TNullable<TRow<TDataObject, R, F>>>;
-}
-/** 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> {
-}
-//# sourceMappingURL=contracts.d.ts.map

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

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

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

@@ -1,3 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=contracts.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"contracts.js","sourceRoot":"","sources":["../../../../../../src/base/repositories/common/types/contracts.ts"],"names":[],"mappings":"","sourcesContent":["import type { AbstractDataSource } from '@/base/datasources';\nimport type { AbstractEntity, IdType } from '@/base/models';\nimport type { TByIdFilter, TFields, TFilter, TRow, TWhere } from '@venizia/ignis-filter';\nimport type { TNullable } from '@venizia/ignis-helpers/common';\nimport type { IExtraOptions, TFindOneOptions, TFindOptions, TFindRangeOptions } from './options';\nimport type { TCount, TDataWithRange } from './results';\n\n/**\n * Base repository interface shared by every engine - engine-specific accessors (postgres's\n * `getEntitySchema()`/`getConnector()`) stay on the connector's own repository tier.\n */\nexport interface IRepository {\n  dataSource: AbstractDataSource;\n  entity: AbstractEntity;\n  getEntity(): AbstractEntity;\n}\n\n/** Interface for read-only repository operations. `TDataObject` is the row/document shape itself. */\nexport interface IReadableRepository<\n  TDataObject extends object = object,\n  ExtraOptions extends IExtraOptions = IExtraOptions,\n> extends IRepository {\n  count(opts: { where: TWhere<TDataObject>; options?: ExtraOptions }): Promise<TCount>;\n  existsWith(opts: { where: TWhere<TDataObject>; options?: ExtraOptions }): Promise<boolean>;\n\n  find<R = unknown, const F extends TFields<TDataObject> = TFields<TDataObject>>(opts: {\n    filter: TFilter<TDataObject, F>;\n    options: TFindRangeOptions<ExtraOptions, TRow<TDataObject, R, F>>;\n  }): Promise<TDataWithRange<TRow<TDataObject, R, F>>>;\n\n  find<R = unknown, const F extends TFields<TDataObject> = TFields<TDataObject>>(opts: {\n    filter: TFilter<TDataObject, F>;\n    options?: TFindOptions<ExtraOptions, TRow<TDataObject, R, F>>;\n  }): Promise<Array<TRow<TDataObject, R, F>>>;\n\n  findOne<R = unknown, const F extends TFields<TDataObject> = TFields<TDataObject>>(opts: {\n    filter: TFilter<TDataObject, F>;\n    options?: TFindOneOptions<ExtraOptions, TRow<TDataObject, R, F>>;\n  }): Promise<TNullable<TRow<TDataObject, R, F>>>;\n\n  findById<R = unknown, const F extends TFields<TDataObject> = TFields<TDataObject>>(opts: {\n    id: IdType;\n    filter?: TByIdFilter<TDataObject, F>;\n    options?: TFindOneOptions<ExtraOptions, TRow<TDataObject, R, F>>;\n  }): Promise<TNullable<TRow<TDataObject, R, F>>>;\n}\n\n/** Interface for create operations. */\nexport interface ICreatableRepository<\n  TDataObject extends object = object,\n  TPersistObject extends object = TDataObject,\n  ExtraOptions extends IExtraOptions = IExtraOptions,\n> extends IRepository {\n  create(opts: {\n    data: TPersistObject;\n    options: ExtraOptions & { shouldReturn: false };\n  }): Promise<TCount & { data: undefined | null }>;\n\n  create<R = TDataObject>(opts: {\n    data: TPersistObject;\n    options?: ExtraOptions & { shouldReturn?: true };\n  }): Promise<TCount & { data: R }>;\n\n  createAll(opts: {\n    data: Array<TPersistObject>;\n    options: ExtraOptions & { shouldReturn: false };\n  }): Promise<TCount & { data: undefined | null }>;\n\n  createAll<R = TDataObject>(opts: {\n    data: Array<TPersistObject>;\n    options?: ExtraOptions & { shouldReturn?: true };\n  }): Promise<TCount & { data: Array<R> }>;\n}\n\n/** Interface for update operations. */\nexport interface IUpdatableRepository<\n  TDataObject extends object = object,\n  TPersistObject extends object = TDataObject,\n  ExtraOptions extends IExtraOptions = IExtraOptions,\n> extends IRepository {\n  updateById(opts: {\n    id: IdType;\n    data: Partial<TPersistObject>;\n    options: ExtraOptions & { shouldReturn: false };\n  }): Promise<TCount & { data: undefined | null }>;\n\n  updateById<R = TDataObject>(opts: {\n    id: IdType;\n    data: Partial<TPersistObject>;\n    options?: ExtraOptions & { shouldReturn?: true };\n  }): Promise<TCount & { data: R }>;\n\n  updateAll(opts: {\n    data: Partial<TPersistObject>;\n    where: TWhere<TDataObject>;\n    options: ExtraOptions & { shouldReturn: false; force?: boolean };\n  }): Promise<TCount & { data: undefined | null }>;\n\n  updateAll<R = TDataObject>(opts: {\n    data: Partial<TPersistObject>;\n    where: TWhere<TDataObject>;\n    options?: ExtraOptions & { shouldReturn?: true; force?: boolean };\n  }): Promise<TCount & { data: Array<R> | null }>;\n\n  /** Alias for updateAll. */\n  updateBy(opts: {\n    data: Partial<TPersistObject>;\n    where: TWhere<TDataObject>;\n    options: ExtraOptions & { shouldReturn: false; force?: boolean };\n  }): Promise<TCount & { data: undefined | null }>;\n\n  /** Alias for updateAll. */\n  updateBy<R = TDataObject>(opts: {\n    data: Partial<TPersistObject>;\n    where: TWhere<TDataObject>;\n    options?: ExtraOptions & { shouldReturn?: true; force?: boolean };\n  }): Promise<TCount & { data: Array<R> | null }>;\n}\n\n/** Interface for delete operations. */\nexport interface IDeletableRepository<\n  TDataObject extends object = object,\n  ExtraOptions extends IExtraOptions = IExtraOptions,\n> extends IRepository {\n  deleteById(opts: {\n    id: IdType;\n    options: ExtraOptions & { shouldReturn: false };\n  }): Promise<TCount & { data: undefined | null }>;\n\n  deleteById<R = TDataObject>(opts: {\n    id: IdType;\n    options?: ExtraOptions & { shouldReturn?: true };\n  }): Promise<TCount & { data: R }>;\n\n  deleteAll(opts: {\n    where?: TWhere<TDataObject>;\n    options: ExtraOptions & { shouldReturn: false; force?: boolean };\n  }): Promise<TCount & { data: undefined | null }>;\n\n  deleteAll<R = TDataObject>(opts: {\n    where?: TWhere<TDataObject>;\n    options?: ExtraOptions & { shouldReturn?: true; force?: boolean };\n  }): Promise<TCount & { data: Array<R> | null }>;\n\n  /** Alias for deleteAll. */\n  deleteBy(opts: {\n    where?: TWhere<TDataObject>;\n    options: ExtraOptions & { shouldReturn: false; force?: boolean };\n  }): Promise<TCount & { data: undefined | null }>;\n\n  /** Alias for deleteAll. */\n  deleteBy<R = TDataObject>(opts: {\n    where?: TWhere<TDataObject>;\n    options?: ExtraOptions & { shouldReturn?: true; force?: boolean };\n  }): Promise<TCount & { data: Array<R> | null }>;\n}\n\n/** Interface for full CRUD repository operations - reads plus create, update, and delete. */\nexport interface IPersistableRepository<\n  TDataObject extends object = object,\n  TPersistObject extends object = TDataObject,\n  ExtraOptions extends IExtraOptions = IExtraOptions,\n>\n  extends\n    IReadableRepository<TDataObject, ExtraOptions>,\n    ICreatableRepository<TDataObject, TPersistObject, ExtraOptions>,\n    IUpdatableRepository<TDataObject, TPersistObject, ExtraOptions>,\n    IDeletableRepository<TDataObject, ExtraOptions> {}\n\n/**\n * Alias for IPersistableRepository - the name both DefaultRelationalRepository and\n * DefaultSearchRepository satisfy.\n */\nexport interface ICrudRepository<\n  TDataObject extends object = object,\n  TPersistObject extends object = TDataObject,\n  ExtraOptions extends IExtraOptions = IExtraOptions,\n> extends IPersistableRepository<TDataObject, TPersistObject, ExtraOptions> {}\n"]}

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

@@ -1,6 +0,0 @@
-export * from './contracts';
-export * from './options';
-export * from './query';
-export * from './results';
-export * from './result-schemas';
-//# sourceMappingURL=index.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/base/repositories/common/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAE1B,cAAc,kBAAkB,CAAC"}

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

@@ -1,23 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./contracts"), exports);
-__exportStar(require("./options"), exports);
-__exportStar(require("./query"), exports);
-__exportStar(require("./results"), exports);
-// Carries zod. Kept out of `results.ts` so the repository types stay reachable from a browser bundle.
-__exportStar(require("./result-schemas"), exports);
-//# sourceMappingURL=index.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../src/base/repositories/common/types/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8CAA4B;AAC5B,4CAA0B;AAC1B,0CAAwB;AACxB,4CAA0B;AAC1B,sGAAsG;AACtG,mDAAiC","sourcesContent":["export * from './contracts';\nexport * from './options';\nexport * from './query';\nexport * from './results';\n// Carries zod. Kept out of `results.ts` so the repository types stay reachable from a browser bundle.\nexport * from './result-schemas';\n"]}

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

@@ -1,89 +0,0 @@
-import type { ITransaction } from '../../../datasources';
-import type { IRetryBackoffOptions, TLogLevel } from '@venizia/ignis-helpers/core';
-import type { TNullable } from '@venizia/ignis-helpers/common';
-import type { SQL } from 'drizzle-orm';
-import type { TLockStrength } from '../constants';
-import type { TDataWithRange } from './results';
-/** Update data supporting both regular fields and JSON path updates via dot notation. */
-export type TUpdateData<T = any> = Partial<T> & {
-    [jsonPath: string]: any;
-};
-/** 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>;
-}
-/** 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>>;
-//# sourceMappingURL=options.d.ts.map