@venizia/ignis-kernel 0.2.0-0

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

@@ -0,0 +1,108 @@
+import { z } from '@hono/zod-openapi';
+/**
+ * Local copy of `@venizia/ignis-helpers`'s error response schema - kept out of that package's
+ * `/core` subpath on purpose (it would force `@hono/zod-openapi` on every non-REST consumer of the
+ * pure error barrel). The kernel already depends on `@hono/zod-openapi` for its REST controller
+ * layer, so the shape is reproduced here rather than reached through the root barrel.
+ */
+export declare const ErrorSchema: z.ZodObject<{
+    statusCode: z.ZodOptional<z.ZodNumber>;
+    message: z.ZodString;
+    normalized: z.ZodOptional<z.ZodObject<{
+        text: z.ZodString;
+        code: z.ZodString;
+        args: z.ZodRecord<z.ZodString, z.ZodAny>;
+    }, z.core.$strip>>;
+    extra: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    requestId: z.ZodOptional<z.ZodString>;
+    details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+}, z.core.$strip>;
+export type NumberIdType = number;
+export type StringIdType = string;
+export type BigIntIdType = bigint;
+export type IdType = NumberIdType | StringIdType | BigIntIdType;
+/** Path-param id shape every entity family resolves to (`AbstractEntity.getIdType()`). */
+export type TIdSchemaType = 'number' | 'string';
+export declare const idParamsSchema: (opts?: {
+    idType: TIdSchemaType;
+}) => z.ZodObject<{
+    id: z.ZodNumber;
+}, z.core.$strip> | z.ZodObject<{
+    id: z.ZodString;
+}, z.core.$strip>;
+export declare const jsonContent: <T extends z.ZodType>(opts: {
+    schema: T;
+    description: string;
+    required?: boolean;
+}) => {
+    description: string;
+    content: {
+        'application/json': {
+            schema: T;
+        };
+    };
+    required: boolean | undefined;
+};
+/** OpenAPI Header Object format */
+type THeaderObject = {
+    description?: string;
+    schema: {
+        type: string;
+        examples?: Array<string>;
+    };
+};
+/** Map of header names to Header Objects */
+type TResponseHeaders = Record<string, THeaderObject>;
+type TJsonResponseOpts<T extends z.ZodType, H extends TResponseHeaders | undefined> = {
+    schema: T;
+    description?: string;
+    required?: boolean;
+    headers?: H;
+};
+export declare const jsonResponse: <ContentSchema extends z.ZodType, HeaderSchema extends TResponseHeaders | undefined = undefined>(opts: TJsonResponseOpts<ContentSchema, HeaderSchema>) => {
+    200: {
+        description: string;
+        content: {
+            'application/json': {
+                schema: ContentSchema;
+            };
+        };
+        required: boolean | undefined;
+    } | {
+        headers: NonNullable<HeaderSchema>;
+        description: string;
+        content: {
+            'application/json': {
+                schema: ContentSchema;
+            };
+        };
+        required: boolean | undefined;
+    };
+    "4xx | 5xx": {
+        description: string;
+        content: {
+            'application/json': {
+                schema: z.ZodObject<{
+                    statusCode: z.ZodOptional<z.ZodNumber>;
+                    message: z.ZodString;
+                    normalized: z.ZodOptional<z.ZodObject<{
+                        text: z.ZodString;
+                        code: z.ZodString;
+                        args: z.ZodRecord<z.ZodString, z.ZodAny>;
+                    }, z.core.$strip>>;
+                    extra: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+                    requestId: z.ZodOptional<z.ZodString>;
+                    details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+                }, z.core.$strip>;
+            };
+        };
+        required: boolean | undefined;
+    };
+};
+type TSnakeToCamelCase<S extends string> = S extends `${infer T}_${infer U}` ? `${T}${Capitalize<TSnakeToCamelCase<U>>}` : S;
+type TCamelCaseKeys<T extends z.ZodRawShape> = {
+    [K in keyof T as K extends string ? TSnakeToCamelCase<K> : K]: T[K] extends z.ZodType<infer U> ? z.ZodType<U> : T[K];
+};
+export declare const snakeToCamel: <T extends z.ZodRawShape>(shape: T) => z.ZodPipe<z.ZodPipe<z.ZodObject<{ -readonly [P in keyof T]: T[P]; }, z.core.$strip>, z.ZodTransform<any, z.core.$InferObjectOutput<{ -readonly [P in keyof T]: T[P]; }, {}>>>, z.ZodObject<TCamelCaseKeys<T> extends infer T_1 ? { -readonly [P_1 in keyof T_1]: T_1[P_1]; } : never, z.core.$strip>>;
+export {};
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/base/models/common/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,mBAAmB,CAAC;AAItC;;;;;GAKG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;iBA6BpB,CAAC;AAEL,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC;AAClC,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC;AAClC,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC;AAClC,MAAM,MAAM,MAAM,GAAG,YAAY,GAAG,YAAY,GAAG,YAAY,CAAC;AAEhE,0FAA0F;AAC1F,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEhD,eAAO,MAAM,cAAc,GAAI,OAAO;IAAE,MAAM,EAAE,aAAa,CAAA;CAAE;;;;iBAkC9D,CAAC;AAEF,eAAO,MAAM,WAAW,GAAI,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,MAAM;IACrD,MAAM,EAAE,CAAC,CAAC;IACV,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;;;;;;;;CAMA,CAAC;AAEF,mCAAmC;AACnC,KAAK,aAAa,GAAG;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;KAAE,CAAC;CACpD,CAAC;AAEF,4CAA4C;AAC5C,KAAK,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;AAEtD,KAAK,iBAAiB,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CAAC,SAAS,gBAAgB,GAAG,SAAS,IAAI;IACpF,MAAM,EAAE,CAAC,CAAC;IACV,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,CAAC,CAAC;CACb,CAAC;AAEF,eAAO,MAAM,YAAY,GACvB,aAAa,SAAS,CAAC,CAAC,OAAO,EAC/B,YAAY,SAAS,gBAAgB,GAAG,SAAS,GAAG,SAAS,EAE7D,MAAM,iBAAiB,CAAC,aAAa,EAAE,YAAY,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAcrD,CAAC;AAEF,KAAK,iBAAiB,CAAC,CAAC,SAAS,MAAM,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,IAAI,MAAM,CAAC,EAAE,GACxE,GAAG,CAAC,GAAG,UAAU,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,EAAE,GACzC,CAAC,CAAC;AAEN,KAAK,cAAc,CAAC,CAAC,SAAS,CAAC,CAAC,WAAW,IAAI;KAC5C,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,SAAS,MAAM,GAAG,iBAAiB,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,GAC1F,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GACZ,CAAC,CAAC,CAAC,CAAC;CACT,CAAC;AAEF,eAAO,MAAM,YAAY,GAAI,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE,OAAO,CAAC,0SAW7D,CAAC"}

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

@@ -0,0 +1,109 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.snakeToCamel = exports.jsonResponse = exports.jsonContent = exports.idParamsSchema = exports.ErrorSchema = void 0;
+const zod_openapi_1 = require("@hono/zod-openapi");
+const core_1 = require("@venizia/ignis-helpers/core");
+const common_1 = require("@venizia/ignis-helpers/common");
+/**
+ * Local copy of `@venizia/ignis-helpers`'s error response schema - kept out of that package's
+ * `/core` subpath on purpose (it would force `@hono/zod-openapi` on every non-REST consumer of the
+ * pure error barrel). The kernel already depends on `@hono/zod-openapi` for its REST controller
+ * layer, so the shape is reproduced here rather than reached through the root barrel.
+ */
+exports.ErrorSchema = zod_openapi_1.z
+    .object({
+    statusCode: zod_openapi_1.z.number().optional(),
+    message: zod_openapi_1.z.string(),
+    normalized: zod_openapi_1.z
+        .object({
+        text: zod_openapi_1.z.string(),
+        code: zod_openapi_1.z.string(),
+        args: zod_openapi_1.z.record(zod_openapi_1.z.string(), zod_openapi_1.z.any()),
+    })
+        .optional(),
+    extra: zod_openapi_1.z.record(zod_openapi_1.z.string(), zod_openapi_1.z.any()).optional(),
+    requestId: zod_openapi_1.z.string().optional(),
+    details: zod_openapi_1.z.record(zod_openapi_1.z.string(), zod_openapi_1.z.any()).optional(),
+})
+    .openapi({
+    description: 'Error Schema',
+    example: {
+        statusCode: 409,
+        message: 'A category named %{name} already exists.',
+        normalized: {
+            text: 'A category named %{name} already exists.',
+            code: 'server.commerce.category.create.duplicate_name',
+            args: { name: 'Ticket' },
+        },
+        extra: { categoryId: 42 },
+        requestId: 'abc-123-def',
+        details: { url: 'http://localhost:3000/categories', path: '/categories' },
+    },
+});
+const idParamsSchema = (opts) => {
+    const { idType = 'number' } = opts ?? {};
+    switch (idType) {
+        case 'number': {
+            return zod_openapi_1.z.object({
+                id: zod_openapi_1.z.number().openapi({
+                    param: {
+                        name: 'id',
+                        in: 'path',
+                        description: 'The unique id of the resource',
+                    },
+                    examples: [1, 2, 3],
+                }),
+            });
+        }
+        case 'string': {
+            return zod_openapi_1.z.object({
+                id: zod_openapi_1.z.string().openapi({
+                    param: {
+                        name: 'id',
+                        in: 'path',
+                        description: 'The unique id of the resource',
+                    },
+                    examples: ['4651e634-a530-4484-9b09-9616a28f35e3', 'some_unique_id'],
+                }),
+            });
+        }
+        default: {
+            throw (0, core_1.getError)({
+                message: `[idParamsSchema] Invalid input idType | valid: [string | number] | idType: ${idType}`,
+            });
+        }
+    }
+};
+exports.idParamsSchema = idParamsSchema;
+const jsonContent = (opts) => {
+    return {
+        description: opts.description,
+        content: { 'application/json': { schema: opts.schema } },
+        required: opts.required,
+    };
+};
+exports.jsonContent = jsonContent;
+const jsonResponse = (opts) => {
+    const baseResponse = (0, exports.jsonContent)({
+        required: opts.required,
+        description: opts.description ?? 'Success Response',
+        schema: opts.schema,
+    });
+    const successResponse = opts.headers ? { ...baseResponse, headers: opts.headers } : baseResponse;
+    return {
+        [common_1.HTTP.ResultCodes.RS_2.Ok]: successResponse,
+        ['4xx | 5xx']: (0, exports.jsonContent)({ description: 'Error Response', schema: exports.ErrorSchema }),
+    };
+};
+exports.jsonResponse = jsonResponse;
+const snakeToCamel = (shape) => {
+    const camelShape = Object.fromEntries(Object.entries(shape).map(([key, value]) => {
+        return [(0, core_1.toCamel)(key), value];
+    }));
+    return zod_openapi_1.z
+        .object(shape)
+        .transform(data => (0, core_1.keysToCamel)(data))
+        .pipe(zod_openapi_1.z.object(camelShape));
+};
+exports.snakeToCamel = snakeToCamel;
+//# sourceMappingURL=types.js.map

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

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

package/dist/cjs/base/models/index.d.ts

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

package/dist/cjs/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/cjs/base/models/index.js

@@ -0,0 +1,19 @@
+"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("./base"), exports);
+__exportStar(require("./common"), exports);
+//# sourceMappingURL=index.js.map

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

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

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

@@ -0,0 +1,7 @@
+import type { Container } from '../../helpers/inversion';
+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/cjs/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/cjs/base/providers/base.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseProvider = void 0;
+const core_1 = require("@venizia/ignis-helpers/core");
+class BaseProvider extends core_1.BaseHelper {
+}
+exports.BaseProvider = BaseProvider;
+//# sourceMappingURL=base.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../../../src/base/providers/base.ts"],"names":[],"mappings":";;;AACA,sDAAyD;AAGzD,MAAsB,YAAgB,SAAQ,iBAAU;CAEvD;AAFD,oCAEC"}

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

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

package/dist/cjs/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/cjs/base/providers/index.js

@@ -0,0 +1,18 @@
+"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("./base"), exports);
+//# sourceMappingURL=index.js.map

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

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

package/dist/cjs/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/cjs/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/cjs/base/repositories/common/constants.js

@@ -0,0 +1,65 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LockStrengths = exports.RelationTypes = exports.RepositoryErrorCodes = exports.RepositoryOperationScopes = exports.DEFAULT_MAX_LIMIT = exports.DEFAULT_LIMIT = void 0;
+const core_1 = require("@venizia/ignis-helpers/core");
+/** Default pagination limit for repository queries. */
+exports.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.
+ */
+exports.DEFAULT_MAX_LIMIT = 1000;
+/** Defines the operation scope for repository instances (READ_ONLY, WRITE_ONLY, READ_WRITE). */
+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);
+    }
+}
+exports.RepositoryOperationScopes = 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. */
+class RepositoryErrorCodes {
+    /** A verb the repository's `operationScope` does not permit (e.g. `create()` on a READ_ONLY one). */
+    static { this.OPERATION_NOT_ALLOWED = core_1.MessageCode.build({
+        parts: ['core', 'repository', 'operation_not_allowed'],
+    }); }
+}
+exports.RepositoryErrorCodes = RepositoryErrorCodes;
+/** Entity relation types (one-to-one/many-to-one, one-to-many). */
+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);
+    }
+}
+exports.RelationTypes = RelationTypes;
+/** PostgreSQL row-level lock strengths for SELECT ... FOR <strength>. */
+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);
+    }
+}
+exports.LockStrengths = LockStrengths;
+//# sourceMappingURL=constants.js.map

package/dist/cjs/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,sDAA0D;AAE1D,uDAAuD;AAC1C,QAAA,aAAa,GAAG,EAAE,CAAC;AAEhC;;;;;;;;;;GAUG;AACU,QAAA,iBAAiB,GAAG,IAAI,CAAC;AAEtC,gGAAgG;AAChG,MAAa,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;;AARH,8DASC;AAKD,kMAAkM;AAClM,MAAa,oBAAoB;IAC/B,qGAAqG;aACrF,0BAAqB,GAAG,kBAAW,CAAC,KAAK,CAAC;QACxD,KAAK,EAAE,CAAC,MAAM,EAAE,YAAY,EAAE,uBAAuB,CAAC;KACvD,CAAC,CAAC;;AAJL,oDAKC;AAKD,mEAAmE;AACnE,MAAa,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;;AAPH,sCAQC;AAKD,yEAAyE;AACzE,MAAa,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;;AAdH,sCAeC"}

package/dist/cjs/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/cjs/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/cjs/base/repositories/common/errors.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RepositoryErrors = void 0;
+const core_1 = require("@venizia/ignis-helpers/core");
+const common_1 = require("@venizia/ignis-helpers/common");
+/** Codes a client branches on for a repository-level failure that is the caller's fault, not the server's. */
+exports.RepositoryErrors = {
+    ENTITY_NOT_FOUND: {
+        message: { text: 'Entity not found', code: 'core.repository.entity_not_found' },
+        statusCode: common_1.HTTP.ResultCodes.RS_4.NotFound,
+        category: core_1.ErrorScopes.BUSINESS,
+    },
+};
+//# sourceMappingURL=errors.js.map

package/dist/cjs/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,sDAA0D;AAC1D,0DAAqD;AAErD,8GAA8G;AACjG,QAAA,gBAAgB,GAAG;IAC9B,gBAAgB,EAAE;QAChB,OAAO,EAAE,EAAE,IAAI,EAAE,kBAAkB,EAAE,IAAI,EAAE,kCAAkC,EAAE;QAC/E,UAAU,EAAE,aAAI,CAAC,WAAW,CAAC,IAAI,CAAC,QAAQ;QAC1C,QAAQ,EAAE,kBAAW,CAAC,QAAQ;KAC/B;CACkD,CAAC"}

package/dist/cjs/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';
+export * from '../query-schemas';
+export * from './constants';
+export * from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/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/cjs/base/repositories/common/index.js

@@ -0,0 +1,23 @@
+"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

@@ -0,0 +1 @@
+{"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"}