@venizia/ignis-kernel 0.4.6 → 0.4.7-1

package/dist/esm/base/models/common/schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../../../src/base/models/common/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,mBAAmB,CAAC;AAGtC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD;;;GAGG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;iBA6BpB,CAAC;AAEL,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEzD,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,8FAA8F;AAC9F,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAI1B,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"}
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../../../src/base/models/common/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,mBAAmB,CAAC;AAGtC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD;;;GAGG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;iBA6BpB,CAAC;AAEL,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEzD,sFAAsF;AACtF,qBAAa,cAAc;IACzB,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE;QAAE,MAAM,EAAE,aAAa,CAAA;KAAE;;;;;IAoChD,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;CAkB5E;AAED,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,+GAA+G;AAC/G,qBAAa,gBAAgB;IAC3B,oEAAoE;IACpE,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE;;;;;;;;;IAiBpE,qEAAqE;IACrE,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAUrE,MAAM,CAAC,WAAW,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,IAAI,EAAE;QAC5C,MAAM,EAAE,CAAC,CAAC;QACV,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;KACpB;;;;;;;;;IAQD,8FAA8F;IAC9F,MAAM,CAAC,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IASrB,MAAM,CAAC,YAAY,CACjB,aAAa,SAAS,CAAC,CAAC,OAAO,EAC/B,YAAY,SAAS,gBAAgB,GAAG,SAAS,GAAG,SAAS,EAC7D,IAAI,EAAE,iBAAiB,CAAC,aAAa,EAAE,YAAY,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgBvD"}

package/dist/esm/base/models/common/schemas.js

@@ -35,62 +35,113 @@ export const ErrorSchema = z
         details: { url: 'http://localhost:3000/categories', path: '/categories' },
     },
 });
-export const idParamsSchema = (opts) => {
-    const { idType = 'number' } = opts ?? {};
-    switch (idType) {
-        case 'number': {
-            return z.object({
-                id: z.number().openapi({
-                    param: {
-                        name: 'id',
-                        in: 'path',
-                        description: 'The unique id of the resource',
-                    },
-                    examples: [1, 2, 3],
-                }),
-            });
+/** OpenAPI schema builders for the parts of a route that every controller repeats. */
+export class OpenApiSchemas {
+    static idParams(opts) {
+        const { idType = 'number' } = opts ?? {};
+        switch (idType) {
+            case 'number': {
+                return z.object({
+                    id: z.number().openapi({
+                        param: {
+                            name: 'id',
+                            in: 'path',
+                            description: 'The unique id of the resource',
+                        },
+                        examples: [1, 2, 3],
+                    }),
+                });
+            }
+            case 'string': {
+                return z.object({
+                    id: 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 getError({
+                    message: `[OpenApiSchemas.idParams] Invalid input idType | valid: [string | number] | idType: ${idType}`,
+                });
+            }
         }
-        case 'string': {
-            return z.object({
-                id: z.string().openapi({
-                    param: {
-                        name: 'id',
-                        in: 'path',
-                        description: 'The unique id of the resource',
-                    },
-                    examples: ['4651e634-a530-4484-9b09-9616a28f35e3', 'some_unique_id'],
-                }),
-            });
+    }
+    static requiredString(opts) {
+        const { min, max, fixed } = opts ?? {};
+        let rs = z.string().nonempty();
+        if (min) {
+            rs = rs.min(min);
+        }
+        if (max) {
+            rs = rs.max(max);
         }
-        default: {
-            throw getError({
-                message: `[idParamsSchema] Invalid input idType | valid: [string | number] | idType: ${idType}`,
-            });
+        if (fixed) {
+            rs = rs.length(fixed);
         }
+        return rs;
+    }
+}
+/** OpenAPI response builders: the JSON and HTML bodies of a route, and the error bodies every route shares. */
+export class OpenApiResponses {
+    /** Creates HTML content configuration for OpenAPI documentation. */
+    static htmlContent(opts) {
+        const { description } = opts;
+        return {
+            description,
+            content: {
+                'text/html': {
+                    schema: z.string().openapi({
+                        description: 'HTML content',
+                        example: '<!DOCTYPE html><html><head><title>Page</title></head><body>...</body></html>',
+                    }),
+                },
+            },
+            required: opts?.required ?? false,
+        };
+    }
+    /** Creates HTML response configuration for OpenAPI documentation. */
+    static htmlResponse(opts) {
+        return {
+            [HTTP.ResultCodes.RS_2.Ok]: OpenApiResponses.htmlContent({
+                description: opts.description,
+                required: opts.required,
+            }),
+            ...OpenApiResponses.errorResponses(),
+        };
+    }
+    static jsonContent(opts) {
+        return {
+            description: opts.description,
+            content: { 'application/json': { schema: opts.schema } },
+            required: opts.required,
+        };
+    }
+    /** The JSON error body of a route, under `4XX` and `5XX` - the range keys OpenAPI accepts. */
+    static errorResponses() {
+        const errorResponse = OpenApiResponses.jsonContent({
+            description: 'Error Response',
+            schema: ErrorSchema,
+        });
+        return { '4XX': errorResponse, '5XX': errorResponse };
+    }
+    static jsonResponse(opts) {
+        const baseResponse = OpenApiResponses.jsonContent({
+            required: opts.required,
+            description: opts.description ?? 'Success Response',
+            schema: opts.schema,
+        });
+        const successResponse = opts.headers
+            ? { ...baseResponse, headers: opts.headers }
+            : baseResponse;
+        return {
+            [HTTP.ResultCodes.RS_2.Ok]: successResponse,
+            ...OpenApiResponses.errorResponses(),
+        };
     }
-};
-export const jsonContent = (opts) => {
-    return {
-        description: opts.description,
-        content: { 'application/json': { schema: opts.schema } },
-        required: opts.required,
-    };
-};
-/** The JSON error body of a route, under `4XX` and `5XX` - the range keys OpenAPI accepts. */
-export const errorResponses = () => {
-    const errorResponse = jsonContent({ description: 'Error Response', schema: ErrorSchema });
-    return { '4XX': errorResponse, '5XX': errorResponse };
-};
-export const jsonResponse = (opts) => {
-    const baseResponse = jsonContent({
-        required: opts.required,
-        description: opts.description ?? 'Success Response',
-        schema: opts.schema,
-    });
-    const successResponse = opts.headers ? { ...baseResponse, headers: opts.headers } : baseResponse;
-    return {
-        [HTTP.ResultCodes.RS_2.Ok]: successResponse,
-        ...errorResponses(),
-    };
-};
+}
 //# sourceMappingURL=schemas.js.map

package/dist/esm/base/models/common/schemas.js.map

@@ -1 +1 @@
-{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../../../../src/base/models/common/schemas.ts"],"names":[],"mappings":"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","sourcesContent":["import { z } from '@hono/zod-openapi';\nimport { HTTP } from '@venizia/ignis-helpers/common';\nimport { getError } from '@venizia/ignis-helpers/core';\nimport type { TIdSchemaType } from './constants';\n\n/**\n * The error RESPONSE for OpenAPI docs - here, beside the REST layer that already needs `@hono/zod-openapi`.\n * Named, so every route's `4XX` and `5XX` reference one `ErrorResponse` component.\n */\nexport const ErrorSchema = z\n  .object({\n    statusCode: z.number().optional(),\n    message: z.string(),\n    normalized: z\n      .object({\n        text: z.string(),\n        code: z.string(),\n        args: z.record(z.string(), z.any()),\n      })\n      .optional(),\n    extra: z.record(z.string(), z.any()).optional(),\n    requestId: z.string().optional(),\n    details: z.record(z.string(), z.any()).optional(),\n  })\n  .openapi('ErrorResponse', {\n    description: 'Error Schema',\n    example: {\n      statusCode: HTTP.ResultCodes.RS_4.Conflict,\n      message: 'A category named %{name} already exists.',\n      normalized: {\n        text: 'A category named %{name} already exists.',\n        code: 'server.commerce.category.create.duplicate_name',\n        args: { name: 'Ticket' },\n      },\n      extra: { categoryId: 42 },\n      requestId: 'abc-123-def',\n      details: { url: 'http://localhost:3000/categories', path: '/categories' },\n    },\n  });\n\nexport type TErrorResponse = z.infer<typeof ErrorSchema>;\n\nexport const idParamsSchema = (opts?: { idType: TIdSchemaType }) => {\n  const { idType = 'number' } = opts ?? {};\n\n  switch (idType) {\n    case 'number': {\n      return z.object({\n        id: z.number().openapi({\n          param: {\n            name: 'id',\n            in: 'path',\n            description: 'The unique id of the resource',\n          },\n          examples: [1, 2, 3],\n        }),\n      });\n    }\n    case 'string': {\n      return z.object({\n        id: z.string().openapi({\n          param: {\n            name: 'id',\n            in: 'path',\n            description: 'The unique id of the resource',\n          },\n          examples: ['4651e634-a530-4484-9b09-9616a28f35e3', 'some_unique_id'],\n        }),\n      });\n    }\n    default: {\n      throw getError({\n        message: `[idParamsSchema] Invalid input idType | valid: [string | number] | idType: ${idType}`,\n      });\n    }\n  }\n};\n\nexport const jsonContent = <T extends z.ZodType>(opts: {\n  schema: T;\n  description: string;\n  required?: boolean;\n}) => {\n  return {\n    description: opts.description,\n    content: { 'application/json': { schema: opts.schema } },\n    required: opts.required,\n  };\n};\n\n/** The JSON error body of a route, under `4XX` and `5XX` - the range keys OpenAPI accepts. */\nexport const errorResponses = () => {\n  const errorResponse = jsonContent({ description: 'Error Response', schema: ErrorSchema });\n\n  return { '4XX': errorResponse, '5XX': errorResponse };\n};\n\n/** OpenAPI Header Object format */\ntype THeaderObject = {\n  description?: string;\n  schema: { type: string; examples?: Array<string> };\n};\n\n/** Map of header names to Header Objects */\ntype TResponseHeaders = Record<string, THeaderObject>;\n\ntype TJsonResponseOpts<T extends z.ZodType, H extends TResponseHeaders | undefined> = {\n  schema: T;\n  description?: string;\n  required?: boolean;\n  headers?: H;\n};\n\nexport const jsonResponse = <\n  ContentSchema extends z.ZodType,\n  HeaderSchema extends TResponseHeaders | undefined = undefined,\n>(\n  opts: TJsonResponseOpts<ContentSchema, HeaderSchema>,\n) => {\n  const baseResponse = jsonContent({\n    required: opts.required,\n    description: opts.description ?? 'Success Response',\n    schema: opts.schema,\n  });\n\n  const successResponse = opts.headers ? { ...baseResponse, headers: opts.headers } : baseResponse;\n\n  return {\n    [HTTP.ResultCodes.RS_2.Ok]: successResponse,\n    ...errorResponses(),\n  };\n};\n"]}
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../../../../src/base/models/common/schemas.ts"],"names":[],"mappings":"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","sourcesContent":["import { z } from '@hono/zod-openapi';\nimport { HTTP } from '@venizia/ignis-helpers/common';\nimport { getError } from '@venizia/ignis-helpers/core';\nimport type { TIdSchemaType } from './constants';\n\n/**\n * The error RESPONSE for OpenAPI docs - here, beside the REST layer that already needs `@hono/zod-openapi`.\n * Named, so every route's `4XX` and `5XX` reference one `ErrorResponse` component.\n */\nexport const ErrorSchema = z\n  .object({\n    statusCode: z.number().optional(),\n    message: z.string(),\n    normalized: z\n      .object({\n        text: z.string(),\n        code: z.string(),\n        args: z.record(z.string(), z.any()),\n      })\n      .optional(),\n    extra: z.record(z.string(), z.any()).optional(),\n    requestId: z.string().optional(),\n    details: z.record(z.string(), z.any()).optional(),\n  })\n  .openapi('ErrorResponse', {\n    description: 'Error Schema',\n    example: {\n      statusCode: HTTP.ResultCodes.RS_4.Conflict,\n      message: 'A category named %{name} already exists.',\n      normalized: {\n        text: 'A category named %{name} already exists.',\n        code: 'server.commerce.category.create.duplicate_name',\n        args: { name: 'Ticket' },\n      },\n      extra: { categoryId: 42 },\n      requestId: 'abc-123-def',\n      details: { url: 'http://localhost:3000/categories', path: '/categories' },\n    },\n  });\n\nexport type TErrorResponse = z.infer<typeof ErrorSchema>;\n\n/** OpenAPI schema builders for the parts of a route that every controller repeats. */\nexport class OpenApiSchemas {\n  static idParams(opts?: { idType: TIdSchemaType }) {\n    const { idType = 'number' } = opts ?? {};\n\n    switch (idType) {\n      case 'number': {\n        return z.object({\n          id: z.number().openapi({\n            param: {\n              name: 'id',\n              in: 'path',\n              description: 'The unique id of the resource',\n            },\n            examples: [1, 2, 3],\n          }),\n        });\n      }\n      case 'string': {\n        return z.object({\n          id: z.string().openapi({\n            param: {\n              name: 'id',\n              in: 'path',\n              description: 'The unique id of the resource',\n            },\n            examples: ['4651e634-a530-4484-9b09-9616a28f35e3', 'some_unique_id'],\n          }),\n        });\n      }\n      default: {\n        throw getError({\n          message: `[OpenApiSchemas.idParams] Invalid input idType | valid: [string | number] | idType: ${idType}`,\n        });\n      }\n    }\n  }\n\n  static requiredString(opts?: { min?: number; max?: number; fixed?: number }) {\n    const { min, max, fixed } = opts ?? {};\n    let rs = z.string().nonempty();\n\n    if (min) {\n      rs = rs.min(min);\n    }\n\n    if (max) {\n      rs = rs.max(max);\n    }\n\n    if (fixed) {\n      rs = rs.length(fixed);\n    }\n\n    return rs;\n  }\n}\n\n/** OpenAPI Header Object format */\ntype THeaderObject = {\n  description?: string;\n  schema: { type: string; examples?: Array<string> };\n};\n\n/** Map of header names to Header Objects */\ntype TResponseHeaders = Record<string, THeaderObject>;\n\ntype TJsonResponseOpts<T extends z.ZodType, H extends TResponseHeaders | undefined> = {\n  schema: T;\n  description?: string;\n  required?: boolean;\n  headers?: H;\n};\n\n/** OpenAPI response builders: the JSON and HTML bodies of a route, and the error bodies every route shares. */\nexport class OpenApiResponses {\n  /** Creates HTML content configuration for OpenAPI documentation. */\n  static htmlContent(opts: { description: string; required?: boolean }) {\n    const { description } = opts;\n\n    return {\n      description,\n      content: {\n        'text/html': {\n          schema: z.string().openapi({\n            description: 'HTML content',\n            example: '<!DOCTYPE html><html><head><title>Page</title></head><body>...</body></html>',\n          }),\n        },\n      },\n      required: opts?.required ?? false,\n    };\n  }\n\n  /** Creates HTML response configuration for OpenAPI documentation. */\n  static htmlResponse(opts: { description: string; required?: boolean }) {\n    return {\n      [HTTP.ResultCodes.RS_2.Ok]: OpenApiResponses.htmlContent({\n        description: opts.description,\n        required: opts.required,\n      }),\n      ...OpenApiResponses.errorResponses(),\n    };\n  }\n\n  static jsonContent<T extends z.ZodType>(opts: {\n    schema: T;\n    description: string;\n    required?: boolean;\n  }) {\n    return {\n      description: opts.description,\n      content: { 'application/json': { schema: opts.schema } },\n      required: opts.required,\n    };\n  }\n\n  /** The JSON error body of a route, under `4XX` and `5XX` - the range keys OpenAPI accepts. */\n  static errorResponses() {\n    const errorResponse = OpenApiResponses.jsonContent({\n      description: 'Error Response',\n      schema: ErrorSchema,\n    });\n\n    return { '4XX': errorResponse, '5XX': errorResponse };\n  }\n\n  static jsonResponse<\n    ContentSchema extends z.ZodType,\n    HeaderSchema extends TResponseHeaders | undefined = undefined,\n  >(opts: TJsonResponseOpts<ContentSchema, HeaderSchema>) {\n    const baseResponse = OpenApiResponses.jsonContent({\n      required: opts.required,\n      description: opts.description ?? 'Success Response',\n      schema: opts.schema,\n    });\n\n    const successResponse = opts.headers\n      ? { ...baseResponse, headers: opts.headers }\n      : baseResponse;\n\n    return {\n      [HTTP.ResultCodes.RS_2.Ok]: successResponse,\n      ...OpenApiResponses.errorResponses(),\n    };\n  }\n}\n"]}

package/dist/esm/base/models/common/utilities.d.ts

@@ -1,13 +1,18 @@
 import { z } from '@hono/zod-openapi';
 import type { TEntityId } from './types/index.js';
-/** The only way into `TEntityId`. Rejects an empty string - an id that is `''` collapses a `where` to no condition. */
-export declare const toEntityId: (opts: {
-    value: string;
-}) => TEntityId;
 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>>;
+/** Conversions into the model types. */
+export declare class ModelUtility {
+    /** The only way into `TEntityId`. Rejects an empty string - an id that is `''` collapses a `where` to no condition. */
+    static toEntityId(opts: {
+        value: string;
+    }): TEntityId;
+    static snakeToCamel<T extends z.ZodRawShape>(opts: {
+        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=utilities.d.ts.map

package/dist/esm/base/models/common/utilities.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utilities.d.ts","sourceRoot":"","sources":["../../../../../src/base/models/common/utilities.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,mBAAmB,CAAC;AAEtC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEzC,uHAAuH;AACvH,eAAO,MAAM,UAAU,GAAI,MAAM;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,KAAG,SAMpD,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"}
+{"version":3,"file":"utilities.d.ts","sourceRoot":"","sources":["../../../../../src/base/models/common/utilities.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,mBAAmB,CAAC;AAEtC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEzC,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,wCAAwC;AACxC,qBAAa,YAAY;IACvB,uHAAuH;IACvH,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS;IAUrD,MAAM,CAAC,YAAY,CAAC,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE,IAAI,EAAE;QAAE,KAAK,EAAE,CAAC,CAAA;KAAE;CAahE"}

package/dist/esm/base/models/common/utilities.js

@@ -1,19 +1,25 @@
 import { z } from '@hono/zod-openapi';
-import { getError, keysToCamel, toCamel } from '@venizia/ignis-helpers/core';
-/** The only way into `TEntityId`. Rejects an empty string - an id that is `''` collapses a `where` to no condition. */
-export const toEntityId = (opts) => {
-    if (opts.value.length === 0) {
-        throw getError({ message: '[toEntityId] Refusing an empty string as an entity id' });
+import { getError, ParseUtility } from '@venizia/ignis-helpers/core';
+/** Conversions into the model types. */
+export class ModelUtility {
+    /** The only way into `TEntityId`. Rejects an empty string - an id that is `''` collapses a `where` to no condition. */
+    static toEntityId(opts) {
+        if (opts.value.length === 0) {
+            throw getError({
+                message: '[ModelUtility.toEntityId] Refusing an empty string as an entity id',
+            });
+        }
+        return opts.value;
     }
-    return opts.value;
-};
-export const snakeToCamel = (shape) => {
-    const camelShape = Object.fromEntries(Object.entries(shape).map(([key, value]) => {
-        return [toCamel(key), value];
-    }));
-    return z
-        .object(shape)
-        .transform((data) => keysToCamel(data))
-        .pipe(z.object(camelShape));
-};
+    static snakeToCamel(opts) {
+        const { shape } = opts;
+        const camelShape = Object.fromEntries(Object.entries(shape).map(([key, value]) => {
+            return [ParseUtility.toCamel({ input: key }), value];
+        }));
+        return z
+            .object(shape)
+            .transform((data) => ParseUtility.keysToCamel({ source: data }))
+            .pipe(z.object(camelShape));
+    }
+}
 //# sourceMappingURL=utilities.js.map

package/dist/esm/base/models/common/utilities.js.map

@@ -1 +1 @@
-{"version":3,"file":"utilities.js","sourceRoot":"","sources":["../../../../../src/base/models/common/utilities.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,mBAAmB,CAAC;AACtC,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,6BAA6B,CAAC;AAG7E,uHAAuH;AACvH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,IAAuB,EAAa,EAAE;IAC/D,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,MAAM,QAAQ,CAAC,EAAE,OAAO,EAAE,uDAAuD,EAAE,CAAC,CAAC;IACvF,CAAC;IAED,OAAO,IAAI,CAAC,KAAkB,CAAC;AACjC,CAAC,CAAC;AAYF,MAAM,CAAC,MAAM,YAAY,GAAG,CAA0B,KAAQ,EAAE,EAAE;IAChE,MAAM,UAAU,GAAG,MAAM,CAAC,WAAW,CACnC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;QACzC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC;IAC/B,CAAC,CAAC,CACkB,CAAC;IAEvB,OAAO,CAAC;SACL,MAAM,CAAC,KAAK,CAAC;SACb,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;SACtC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC;AAChC,CAAC,CAAC","sourcesContent":["import { z } from '@hono/zod-openapi';\nimport { getError, keysToCamel, toCamel } from '@venizia/ignis-helpers/core';\nimport type { TEntityId } from './types';\n\n/** The only way into `TEntityId`. Rejects an empty string - an id that is `''` collapses a `where` to no condition. */\nexport const toEntityId = (opts: { value: string }): TEntityId => {\n  if (opts.value.length === 0) {\n    throw getError({ message: '[toEntityId] Refusing an empty string as an entity id' });\n  }\n\n  return opts.value as TEntityId;\n};\n\ntype TSnakeToCamelCase<S extends string> = S extends `${infer T}_${infer U}`\n  ? `${T}${Capitalize<TSnakeToCamelCase<U>>}`\n  : S;\n\ntype TCamelCaseKeys<T extends z.ZodRawShape> = {\n  [K in keyof T as K extends string ? TSnakeToCamelCase<K> : K]: T[K] extends z.ZodType<infer U>\n    ? z.ZodType<U>\n    : T[K];\n};\n\nexport const snakeToCamel = <T extends z.ZodRawShape>(shape: T) => {\n  const camelShape = Object.fromEntries(\n    Object.entries(shape).map(([key, value]) => {\n      return [toCamel(key), value];\n    }),\n  ) as TCamelCaseKeys<T>;\n\n  return z\n    .object(shape)\n    .transform((data) => keysToCamel(data))\n    .pipe(z.object(camelShape));\n};\n"]}
+{"version":3,"file":"utilities.js","sourceRoot":"","sources":["../../../../../src/base/models/common/utilities.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,mBAAmB,CAAC;AACtC,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAarE,wCAAwC;AACxC,MAAM,OAAO,YAAY;IACvB,uHAAuH;IACvH,MAAM,CAAC,UAAU,CAAC,IAAuB;QACvC,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC5B,MAAM,QAAQ,CAAC;gBACb,OAAO,EAAE,oEAAoE;aAC9E,CAAC,CAAC;QACL,CAAC;QAED,OAAO,IAAI,CAAC,KAAkB,CAAC;IACjC,CAAC;IAED,MAAM,CAAC,YAAY,CAA0B,IAAkB;QAC7D,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;QACvB,MAAM,UAAU,GAAG,MAAM,CAAC,WAAW,CACnC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;YACzC,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC;QACvD,CAAC,CAAC,CACkB,CAAC;QAEvB,OAAO,CAAC;aACL,MAAM,CAAC,KAAK,CAAC;aACb,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,YAAY,CAAC,WAAW,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;aAC/D,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC;IAChC,CAAC;CACF","sourcesContent":["import { z } from '@hono/zod-openapi';\nimport { getError, ParseUtility } from '@venizia/ignis-helpers/core';\nimport type { TEntityId } from './types';\n\ntype TSnakeToCamelCase<S extends string> = S extends `${infer T}_${infer U}`\n  ? `${T}${Capitalize<TSnakeToCamelCase<U>>}`\n  : S;\n\ntype TCamelCaseKeys<T extends z.ZodRawShape> = {\n  [K in keyof T as K extends string ? TSnakeToCamelCase<K> : K]: T[K] extends z.ZodType<infer U>\n    ? z.ZodType<U>\n    : T[K];\n};\n\n/** Conversions into the model types. */\nexport class ModelUtility {\n  /** The only way into `TEntityId`. Rejects an empty string - an id that is `''` collapses a `where` to no condition. */\n  static toEntityId(opts: { value: string }): TEntityId {\n    if (opts.value.length === 0) {\n      throw getError({\n        message: '[ModelUtility.toEntityId] Refusing an empty string as an entity id',\n      });\n    }\n\n    return opts.value as TEntityId;\n  }\n\n  static snakeToCamel<T extends z.ZodRawShape>(opts: { shape: T }) {\n    const { shape } = opts;\n    const camelShape = Object.fromEntries(\n      Object.entries(shape).map(([key, value]) => {\n        return [ParseUtility.toCamel({ input: key }), value];\n      }),\n    ) as TCamelCaseKeys<T>;\n\n    return z\n      .object(shape)\n      .transform((data) => ParseUtility.keysToCamel({ source: data }))\n      .pipe(z.object(camelShape));\n  }\n}\n"]}

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

@@ -8,13 +8,21 @@ export type TDataRange = {
     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;
+/** The `Content-Range` of a page: building the range from a result, and writing it as a header value. */
+export declare class DataRangeUtility {
+    /** Content-Range envelope with an inclusive `end` - an empty page collapses `end` onto `start`. */
+    static buildDataRange(opts: {
+        skip?: number;
+        offset?: number;
+        dataLength: number;
+        total: number;
+    }): TDataRange;
+    /** `Content-Range` of a page: inclusive `end`, and `records * /<total>` (no space) when the page is empty. Exported so a route that writes the header itself uses the one formatter. */
+    static toContentRange(opts: {
+        range: TDataRange;
+        count: number;
+    }): string;
+}
 /** The `shouldQueryRange: true` result envelope; `extra` carries what a list answered beside its rows - see `x-request-extra`. */
 export type TDataWithRange<R> = {
     data: Array<R>;

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

@@ -1 +1 @@
-{"version":3,"file":"results.d.ts","sourceRoot":"","sources":["../../../../../../src/base/repositories/common/types/results.ts"],"names":[],"mappings":"AAAA,uLAAuL;AACvL,MAAM,MAAM,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvC,yFAAyF;AACzF,MAAM,MAAM,UAAU,GAAG;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,mGAAmG;AACnG,eAAO,MAAM,cAAc,GAAI,MAAM;IACnC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;CACf,KAAG,UAKH,CAAC;AAEF,kIAAkI;AAClI,MAAM,MAAM,cAAc,CAAC,CAAC,IAAI;IAC9B,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;IACf,KAAK,EAAE,UAAU,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC,CAAC"}
+{"version":3,"file":"results.d.ts","sourceRoot":"","sources":["../../../../../../src/base/repositories/common/types/results.ts"],"names":[],"mappings":"AAAA,uLAAuL;AACvL,MAAM,MAAM,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvC,yFAAyF;AACzF,MAAM,MAAM,UAAU,GAAG;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,yGAAyG;AACzG,qBAAa,gBAAgB;IAC3B,mGAAmG;IACnG,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE;QAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,MAAM,CAAC;QACnB,KAAK,EAAE,MAAM,CAAC;KACf,GAAG,UAAU;IAOd,wLAAwL;IACxL,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,UAAU,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM;CAK1E;AAED,kIAAkI;AAClI,MAAM,MAAM,cAAc,CAAC,CAAC,IAAI;IAC9B,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;IACf,KAAK,EAAE,UAAU,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC,CAAC"}

package/dist/esm/base/repositories/common/types/results.js

@@ -1,8 +1,17 @@
-/** 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 };
-};
+/** The `Content-Range` of a page: building the range from a result, and writing it as a header value. */
+export class DataRangeUtility {
+    /** Content-Range envelope with an inclusive `end` - an empty page collapses `end` onto `start`. */
+    static 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 };
+    }
+    /** `Content-Range` of a page: inclusive `end`, and `records * /<total>` (no space) when the page is empty. Exported so a route that writes the header itself uses the one formatter. */
+    static toContentRange(opts) {
+        const { range, count } = opts;
+        const { start, end, total } = range;
+        return count > 0 ? `records ${start}-${end}/${total}` : `records */${total}`;
+    }
+}
 //# sourceMappingURL=results.js.map

package/dist/esm/base/repositories/common/types/results.js.map

@@ -1 +1 @@
-{"version":3,"file":"results.js","sourceRoot":"","sources":["../../../../../../src/base/repositories/common/types/results.ts"],"names":[],"mappings":"AAUA,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","sourcesContent":["/** The count envelope. Spelled out rather than inferred from `CountSchema`, which lives in `result-schemas.ts` - inferring it here would put zod on every path that needs the TYPE. */\nexport type TCount = { count: number };\n\n/** Data range information for paginated queries. Follows HTTP Content-Range standard. */\nexport type TDataRange = {\n  start: number;\n  end: number;\n  total: number;\n};\n\n/** Content-Range envelope with an inclusive `end` - an empty page collapses `end` onto `start`. */\nexport const buildDataRange = (opts: {\n  skip?: number;\n  offset?: number;\n  dataLength: number;\n  total: number;\n}): TDataRange => {\n  const { skip, offset, dataLength, total } = opts;\n  const start = skip ?? offset ?? 0;\n  const end = dataLength > 0 ? start + dataLength - 1 : start;\n  return { start, end, total };\n};\n\n/** The `shouldQueryRange: true` result envelope; `extra` carries what a list answered beside its rows - see `x-request-extra`. */\nexport type TDataWithRange<R> = {\n  data: Array<R>;\n  range: TDataRange;\n  extra?: Record<string, unknown>;\n};\n"]}
+{"version":3,"file":"results.js","sourceRoot":"","sources":["../../../../../../src/base/repositories/common/types/results.ts"],"names":[],"mappings":"AAUA,yGAAyG;AACzG,MAAM,OAAO,gBAAgB;IAC3B,mGAAmG;IACnG,MAAM,CAAC,cAAc,CAAC,IAKrB;QACC,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;QACjD,MAAM,KAAK,GAAG,IAAI,IAAI,MAAM,IAAI,CAAC,CAAC;QAClC,MAAM,GAAG,GAAG,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;QAC5D,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC;IAC/B,CAAC;IAED,wLAAwL;IACxL,MAAM,CAAC,cAAc,CAAC,IAA0C;QAC9D,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;QAC9B,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,KAAK,CAAC;QACpC,OAAO,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,KAAK,IAAI,GAAG,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,aAAa,KAAK,EAAE,CAAC;IAC/E,CAAC;CACF","sourcesContent":["/** The count envelope. Spelled out rather than inferred from `CountSchema`, which lives in `result-schemas.ts` - inferring it here would put zod on every path that needs the TYPE. */\nexport type TCount = { count: number };\n\n/** Data range information for paginated queries. Follows HTTP Content-Range standard. */\nexport type TDataRange = {\n  start: number;\n  end: number;\n  total: number;\n};\n\n/** The `Content-Range` of a page: building the range from a result, and writing it as a header value. */\nexport class DataRangeUtility {\n  /** Content-Range envelope with an inclusive `end` - an empty page collapses `end` onto `start`. */\n  static buildDataRange(opts: {\n    skip?: number;\n    offset?: number;\n    dataLength: number;\n    total: number;\n  }): TDataRange {\n    const { skip, offset, dataLength, total } = opts;\n    const start = skip ?? offset ?? 0;\n    const end = dataLength > 0 ? start + dataLength - 1 : start;\n    return { start, end, total };\n  }\n\n  /** `Content-Range` of a page: inclusive `end`, and `records * /<total>` (no space) when the page is empty. Exported so a route that writes the header itself uses the one formatter. */\n  static toContentRange(opts: { range: TDataRange; count: number }): string {\n    const { range, count } = opts;\n    const { start, end, total } = range;\n    return count > 0 ? `records ${start}-${end}/${total}` : `records */${total}`;\n  }\n}\n\n/** The `shouldQueryRange: true` result envelope; `extra` carries what a list answered beside its rows - see `x-request-extra`. */\nexport type TDataWithRange<R> = {\n  data: Array<R>;\n  range: TDataRange;\n  extra?: Record<string, unknown>;\n};\n"]}

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

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

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

@@ -1,6 +1,6 @@
 import { MetadataRegistry } from '../../../helpers/inversion/index.js';
 import { BaseHelper, getError } from '@venizia/ignis-helpers/core';
-import { resolveValue } from '@venizia/ignis-helpers/common';
+import { ResolverUtility } from '@venizia/ignis-helpers/common';
 import { RetryBackoffStrategies, RetryHelper, RetryJitterModes } from '@venizia/ignis-helpers/core';
 // The file, not the `../common` barrel: the barrel re-exports the OpenAPI schemas, and this module is
 // on the `./repository` entry, which must load without `@hono/zod-openapi` installed.
@@ -163,9 +163,11 @@ export class AbstractRepository extends BaseHelper {
                 message: `[${this.constructor.name}] Cannot resolve entity. Either pass entityClass in constructor or use @repository decorator with model option.`,
             });
         }
-        // resolveValue() erases to the resolved value's structural type, not this class-or-resolver
+        // ResolverUtility.resolveValue() erases to the resolved value's structural type, not this class-or-resolver
         // union's member - the `@repository` decorator guarantees a class constructor here.
-        const ModelClass = resolveValue({ value: binding.model });
+        const ModelClass = ResolverUtility.resolveValue({
+            value: binding.model,
+        });
         return new ModelClass();
     }
     /** Rejects a verb the current operation scope does not permit. */

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

@@ -1 +1 @@
-{"version":3,"file":"abstract.js","sourceRoot":"","sources":["../../../../../src/base/repositories/core/abstract.ts"],"names":[],"mappings":"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","sourcesContent":["import type { AbstractDataSource } from '@/base/datasources';\nimport type { AbstractEntity, IdType } from '@/base/models';\nimport type { IModelMetadata } from '@/helpers/inversion';\nimport { MetadataRegistry } from '@/helpers/inversion';\nimport type { TClass, TNullable } from '@venizia/ignis-helpers/common';\nimport { BaseHelper, getError } from '@venizia/ignis-helpers/core';\nimport { resolveValue } from '@venizia/ignis-helpers/common';\nimport { RetryBackoffStrategies, RetryHelper, RetryJitterModes } from '@venizia/ignis-helpers/core';\nimport type {\n  IExtraOptions,\n  IPersistableRepository,\n  IWithReadRetry,\n  TCount,\n  TDataWithRange,\n  TFindOneOptions,\n  TFindOptions,\n  TFindRangeOptions,\n  TRepositoryOperationScope,\n} from '../common';\n// The file, not the `../common` barrel: the barrel re-exports the OpenAPI schemas, and this module is\n// on the `./repository` entry, which must load without `@hono/zod-openapi` installed.\nimport {\n  DEFAULT_MAX_LIMIT,\n  RepositoryErrorCodes,\n  RepositoryOperationScopes,\n} from '../common/constants';\nimport type {\n  TByIdFilter,\n  TFields,\n  TFilter,\n  TInclusion,\n  TRow,\n  TWhere,\n} from '@venizia/ignis-filter';\n\n/**\n * Engine-neutral repository plumbing - lazy dataSource/entity resolution, class-keyed `@model`\n * settings, operation scope. `TOptions` defaults to `IExtraOptions` so connectors can narrow it\n * while staying assignable to this base.\n */\nexport abstract class AbstractRepository<\n  TDataObject extends object,\n  TPersistObject extends object = TDataObject,\n  TOptions extends IExtraOptions = IExtraOptions,\n>\n  extends BaseHelper\n  implements IPersistableRepository<TDataObject, TPersistObject, TOptions>\n{\n  protected _operationScope: TRepositoryOperationScope;\n\n  /** Lazy-resolved on first access if not provided in constructor. */\n  protected _dataSource?: AbstractDataSource;\n\n  /** Lazy-resolved from @repository metadata on first access. */\n  protected _entity?: AbstractEntity;\n\n  /**\n   * Memoized @model settings for `this.entity`'s class. `null` means not yet resolved - `undefined`\n   * is itself a valid resolved value: the model declares no settings.\n   */\n  private _modelSettings: IModelMetadata['settings'] | null = null;\n\n  constructor(\n    dataSource?: AbstractDataSource,\n    opts?: {\n      scope?: string;\n      entityClass?: TClass<AbstractEntity>;\n      operationScope?: TRepositoryOperationScope;\n    },\n  ) {\n    const scopeName =\n      opts?.scope ??\n      (opts?.entityClass?.name ? [opts.entityClass.name, 'Repository'].join('') : new.target.name);\n\n    super({ scope: scopeName });\n\n    this._operationScope = opts?.operationScope ?? RepositoryOperationScopes.READ_ONLY;\n\n    if (dataSource) {\n      this._dataSource = dataSource;\n    }\n\n    if (opts?.entityClass) {\n      this._entity = new opts.entityClass();\n    }\n  }\n\n  get dataSource(): AbstractDataSource {\n    if (!this._dataSource) {\n      throw getError({\n        message: `[${this.constructor.name}] DataSource not available. Use @repository({ model: YourModel, dataSource: YourDataSource }) or pass dataSource in constructor.`,\n      });\n    }\n\n    return this._dataSource;\n  }\n\n  set dataSource(value: AbstractDataSource) {\n    this._dataSource = value;\n  }\n\n  /** Auto-resolves from @repository metadata if not explicitly set. */\n  get entity(): AbstractEntity {\n    this._entity ??= this.resolveEntity();\n    return this._entity;\n  }\n\n  set entity(value: AbstractEntity) {\n    this._entity = value;\n  }\n\n  get operationScope(): TRepositoryOperationScope {\n    return this._operationScope;\n  }\n\n  setDataSource(opts: { dataSource: AbstractDataSource }): void {\n    this._dataSource = opts.dataSource;\n  }\n\n  getEntity(): AbstractEntity {\n    return this.entity;\n  }\n\n  /**\n   * Resolved `@model` settings for `this.entity`'s class, keyed by Reflect target - not by\n   * `entity.name`, which can diverge from the `@model` registry key.\n   */\n  protected get modelSettings(): IModelMetadata['settings'] {\n    if (this._modelSettings !== null) {\n      return this._modelSettings;\n    }\n\n    this._modelSettings = MetadataRegistry.getInstance().getModelMetadata({\n      target: this.entity.constructor,\n    })?.settings;\n\n    return this._modelSettings;\n  }\n\n  protected get hiddenFields(): string[] {\n    return this.modelSettings?.hiddenProperties ?? [];\n  }\n\n  /** Default where from @model settings.query.filter.where, AND-merged into every query unless skipped. */\n  protected get defaultWhere(): TWhere | undefined {\n    return this.modelSettings?.query?.filter?.where;\n  }\n\n  protected get defaultLimit(): number | undefined {\n    return this.modelSettings?.query?.limit?.default;\n  }\n\n  /** Largest `limit` a caller may ask for, when the model declares one; undefined leaves the tier's own default in force. */\n  protected get maxLimit(): number | undefined {\n    return this.modelSettings?.query?.limit?.max;\n  }\n\n  /**\n   * Both bounds, in one place, for every tier.\n   *\n   * The upper bound is the point: `@model({ settings: { maxLimit } })` is public and validated at\n   * decoration time, but the relational tier read it nowhere, so `maxLimit: 2` still issued\n   * `LIMIT 50000000`.\n   *\n   * The lower bound matters just as much and is easy to miss: a NEGATIVE limit is not a smaller\n   * page. Drizzle renders the LIMIT clause only when the value is `>= 0`, so a negative one removes\n   * the clause and returns the whole table. The wire schema now rejects it too, but a server-side\n   * caller reaches this method without passing through the schema at all.\n   */\n  protected assertLimitWithinCeiling(opts: { limit?: number; scope?: string }): void {\n    const { limit, scope = 'find' } = opts;\n\n    if (limit === undefined) {\n      return;\n    }\n\n    // The shape check first, because it needs no metadata at all.\n    if (!Number.isInteger(limit) || limit < 0) {\n      throw getError({\n        message: `[${this.constructor.name}][${scope}] Invalid 'limit' | Expected a non-negative integer | Got: ${limit}`,\n      });\n    }\n\n    // `maxLimit` reaches `modelSettings`, which resolves the entity - and THAT throws for a\n    // repository with no `@repository` model binding. Such a repository is a misconfiguration this\n    // method has no business reporting, and the caller path that used to reach `getDefaultLimit()`\n    // never touched it either, because `??` short-circuits when a limit is given. So the ceiling is\n    // consulted only when the binding that makes it resolvable is actually present.\n    const hasModelBinding = Boolean(\n      MetadataRegistry.getInstance().getRepositoryBinding({ target: this.constructor })?.model,\n    );\n    const ceiling = (hasModelBinding ? this.maxLimit : undefined) ?? DEFAULT_MAX_LIMIT;\n\n    if (limit > ceiling) {\n      throw getError({\n        message: `[${this.constructor.name}][${scope}] Requested page exceeds this model's limit | requested: ${limit} | maximum: ${ceiling} | raise it with @model settings.maxLimit if larger pages are genuinely needed`,\n      });\n    }\n  }\n\n  /**\n   * The whole filter, relations included. Checking only the top-level `limit` left the identical\n   * defect reachable one level down: a relation scope's negative limit drops Drizzle's LIMIT clause\n   * for that relation and loads the entire related table.\n   *\n   * A relation's limit gets the SHAPE check only, not a ceiling. The ceiling belongs to the\n   * relation's own model, which this repository cannot resolve - claiming otherwise would enforce\n   * the parent's `maxLimit` on a different entity.\n   */\n  protected assertFilterLimits(opts: { filter?: TFilter; scope?: string }): void {\n    const { filter, scope = 'find' } = opts;\n\n    if (!filter) {\n      return;\n    }\n\n    this.assertLimitWithinCeiling({ limit: filter.limit, scope });\n\n    const walk = (inclusions: TInclusion[] | undefined, path: string): void => {\n      const inclusionsList = inclusions ?? [];\n      for (const inclusion of inclusionsList) {\n        const relationScope = inclusion.scope;\n        if (!relationScope) {\n          continue;\n        }\n\n        const relationPath = `${path}.${inclusion.relation}`;\n        const relationLimit = relationScope.limit;\n\n        if (\n          relationLimit !== undefined &&\n          (!Number.isInteger(relationLimit) || relationLimit < 0)\n        ) {\n          throw getError({\n            message: `[${this.constructor.name}][${scope}] Invalid 'limit' on relation scope | relation: ${relationPath} | Expected a non-negative integer | Got: ${relationLimit}`,\n          });\n        }\n\n        walk(relationScope.include, relationPath);\n      }\n    };\n\n    walk(filter.include, scope);\n  }\n\n  /** Resolves the entity instance from @repository metadata on first access. */\n  protected resolveEntity(): AbstractEntity {\n    const registry = MetadataRegistry.getInstance();\n    const binding = registry.getRepositoryBinding({ target: this.constructor });\n\n    if (!binding?.model) {\n      throw getError({\n        message: `[${this.constructor.name}] Cannot resolve entity. Either pass entityClass in constructor or use @repository decorator with model option.`,\n      });\n    }\n\n    // resolveValue() erases to the resolved value's structural type, not this class-or-resolver\n    // union's member - the `@repository` decorator guarantees a class constructor here.\n    const ModelClass = resolveValue({ value: binding.model }) as TClass<AbstractEntity>;\n    return new ModelClass();\n  }\n\n  /** Rejects a verb the current operation scope does not permit. */\n  protected denyOperation(opts: { methodName: string }): never {\n    throw getError({\n      messageCode: RepositoryErrorCodes.OPERATION_NOT_ALLOWED,\n      message: `[${opts.methodName}] Repository operation is NOT ALLOWED | scope: ${this.operationScope}`,\n    });\n  }\n\n  /**\n   * Shared retry orchestration for read verbs. Inside a transaction retry is skipped - the pool\n   * routes transactions to the primary, so there is no replica lag to wait out.\n   */\n  protected executeReadWithRetry<TResult>(opts: {\n    operation: string;\n    options: IExtraOptions & IWithReadRetry<TResult>;\n    defaultUntil: (result: TResult) => boolean;\n    execution: () => Promise<TResult>;\n  }): Promise<TResult> {\n    const { operation, options, defaultUntil, execution } = opts;\n\n    if (!options.retry) {\n      return execution();\n    }\n\n    if (options.transaction) {\n      this.logger.for(operation).debug('Read retry skipped inside transaction');\n      return execution();\n    }\n\n    const { maxAttempts, maxTotalMs, signal, backoff, until } = options.retry;\n\n    return RetryHelper.executeWithRetryUntil<TResult>({\n      operation: [this.constructor.name, operation].join('.'),\n      execution,\n      until: until ?? defaultUntil,\n      maxAttempts,\n      maxTotalMs,\n      signal,\n      backoff: backoff ?? {\n        strategy: RetryBackoffStrategies.EXPONENTIAL,\n        initialDelayMs: 50,\n        maxDelayMs: 500,\n        jitter: RetryJitterModes.EQUAL,\n      },\n      logger: this.logger,\n    });\n  }\n\n  /**\n   * A copy of `options` without `retry`, so re-entering a read verb takes its non-retry path - this\n   * is what keeps the retry recursion single-depth. Copy-then-delete rather than a rest-destructure\n   * (lint rejects the unused rest sibling) or `lodash/omit` (its `Omit<>` return type is not\n   * assignable back to `TOptions`).\n   */\n  private omitReadRetry<TReadOptions extends { retry?: unknown }>(\n    options: TReadOptions,\n  ): TReadOptions {\n    const rest = { ...options };\n    delete rest.retry;\n    return rest;\n  }\n\n  /** `find`, re-executed until the retry predicate holds - connectors dispatch here from `find` when `options.retry` is set. */\n  protected findUntil<R = TDataObject>(opts: {\n    filter: TFilter<TDataObject>;\n    options: TFindOptions<TOptions, R>;\n  }): Promise<Array<R>> {\n    const options = this.omitReadRetry(opts.options);\n\n    return this.executeReadWithRetry<Array<R>>({\n      operation: 'find',\n      options: opts.options,\n      defaultUntil: (result) => result.length > 0,\n      // `R` is named here, so the row is `R`; TypeScript cannot resolve `TRow` for an unresolved `R`.\n      execution: () => this.find<R>({ filter: opts.filter, options }) as Promise<Array<R>>,\n    });\n  }\n\n  /** `find` with the range envelope, re-executed until the retry predicate holds - split from `findUntil` so each result shape is checked against its own `find` overload. */\n  protected findRangeUntil<R = TDataObject>(opts: {\n    filter: TFilter<TDataObject>;\n    options: TFindRangeOptions<TOptions, R>;\n  }): Promise<TDataWithRange<R>> {\n    const options = this.omitReadRetry(opts.options);\n\n    return this.executeReadWithRetry<TDataWithRange<R>>({\n      operation: 'find',\n      options: opts.options,\n      defaultUntil: (result) => result.data.length > 0,\n      execution: () =>\n        this.find<R>({ filter: opts.filter, options }) as unknown as Promise<TDataWithRange<R>>,\n    });\n  }\n\n  /** `findOne`, re-executed until the retry predicate holds - also serves `findById` via its findOne delegation. */\n  protected findOneUntil<R = TDataObject>(opts: {\n    filter: TFilter<TDataObject>;\n    options: TFindOneOptions<TOptions, R>;\n  }): Promise<TNullable<R>> {\n    const options = this.omitReadRetry(opts.options);\n\n    return this.executeReadWithRetry<TNullable<R>>({\n      operation: 'findOne',\n      options: opts.options,\n      defaultUntil: (result) => result !== null && result !== undefined,\n      execution: () => this.findOne<R>({ filter: opts.filter, options }) as Promise<TNullable<R>>,\n    });\n  }\n\n  abstract count(opts: { where: TWhere<TDataObject>; options?: TOptions }): Promise<TCount>;\n\n  abstract existsWith(opts: { where: TWhere<TDataObject>; options?: TOptions }): Promise<boolean>;\n\n  abstract find<R = unknown, const F extends TFields<TDataObject> = TFields<TDataObject>>(opts: {\n    filter: TFilter<TDataObject, F>;\n    options: TFindRangeOptions<TOptions, TRow<TDataObject, R, F>>;\n  }): Promise<TDataWithRange<TRow<TDataObject, R, F>>>;\n\n  abstract find<R = unknown, const F extends TFields<TDataObject> = TFields<TDataObject>>(opts: {\n    filter: TFilter<TDataObject, F>;\n    options?: TFindOptions<TOptions, TRow<TDataObject, R, F>>;\n  }): Promise<Array<TRow<TDataObject, R, F>>>;\n\n  abstract findOne<R = unknown, const F extends TFields<TDataObject> = TFields<TDataObject>>(opts: {\n    filter: TFilter<TDataObject, F>;\n    options?: TFindOneOptions<TOptions, TRow<TDataObject, R, F>>;\n  }): Promise<TNullable<TRow<TDataObject, R, F>>>;\n\n  abstract findById<\n    R = unknown,\n    const F extends TFields<TDataObject> = TFields<TDataObject>,\n  >(opts: {\n    id: IdType;\n    filter?: TByIdFilter<TDataObject, F>;\n    options?: TFindOneOptions<TOptions, TRow<TDataObject, R, F>>;\n  }): Promise<TNullable<TRow<TDataObject, R, F>>>;\n\n  abstract create(opts: {\n    data: TPersistObject;\n    options: TOptions & { shouldReturn: false };\n  }): Promise<TCount & { data: undefined | null }>;\n\n  abstract create<R = TDataObject>(opts: {\n    data: TPersistObject;\n    options?: TOptions & { shouldReturn?: true };\n  }): Promise<TCount & { data: R }>;\n\n  abstract createAll(opts: {\n    data: Array<TPersistObject>;\n    options: TOptions & { shouldReturn: false };\n  }): Promise<TCount & { data: undefined | null }>;\n\n  abstract createAll<R = TDataObject>(opts: {\n    data: Array<TPersistObject>;\n    options?: TOptions & { shouldReturn?: true };\n  }): Promise<TCount & { data: Array<R> }>;\n\n  abstract updateById(opts: {\n    id: IdType;\n    data: Partial<TPersistObject>;\n    options: TOptions & { shouldReturn: false };\n  }): Promise<TCount & { data: undefined | null }>;\n\n  abstract updateById<R = TDataObject>(opts: {\n    id: IdType;\n    data: Partial<TPersistObject>;\n    options?: TOptions & { shouldReturn?: true };\n  }): Promise<TCount & { data: R }>;\n\n  abstract updateAll(opts: {\n    data: Partial<TPersistObject>;\n    where: TWhere<TDataObject>;\n    options: TOptions & { shouldReturn: false; force?: boolean };\n  }): Promise<TCount & { data: undefined | null }>;\n\n  abstract updateAll<R = TDataObject>(opts: {\n    data: Partial<TPersistObject>;\n    where: TWhere<TDataObject>;\n    options?: TOptions & { 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: TOptions & { shouldReturn: false; force?: boolean };\n  }): Promise<TCount & { data: undefined | null }>;\n  updateBy<R = TDataObject>(opts: {\n    data: Partial<TPersistObject>;\n    where: TWhere<TDataObject>;\n    options?: TOptions & { shouldReturn?: true; force?: boolean };\n  }): Promise<TCount & { data: Array<R> | null }>;\n  updateBy<R = TDataObject>(opts: {\n    data: Partial<TPersistObject>;\n    where: TWhere<TDataObject>;\n    options?: TOptions & { shouldReturn?: boolean; force?: boolean };\n  }): Promise<TCount & { data: TNullable<Array<R>> }> {\n    const { data, where, options } = opts;\n\n    if (options?.shouldReturn === false) {\n      return this.updateAll({ data, where, options: { ...options, shouldReturn: false } });\n    }\n\n    return this.updateAll<R>({ data, where, options });\n  }\n\n  abstract deleteById(opts: {\n    id: IdType;\n    options: TOptions & { shouldReturn: false };\n  }): Promise<TCount & { data: undefined | null }>;\n\n  abstract deleteById<R = TDataObject>(opts: {\n    id: IdType;\n    options?: TOptions & { shouldReturn?: true };\n  }): Promise<TCount & { data: R }>;\n\n  abstract deleteAll(opts: {\n    where?: TWhere<TDataObject>;\n    options: TOptions & { shouldReturn: false; force?: boolean };\n  }): Promise<TCount & { data: undefined | null }>;\n\n  abstract deleteAll<R = TDataObject>(opts: {\n    where?: TWhere<TDataObject>;\n    options?: TOptions & { 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: TOptions & { shouldReturn: false; force?: boolean };\n  }): Promise<TCount & { data: undefined | null }>;\n  deleteBy<R = TDataObject>(opts: {\n    where: TWhere<TDataObject>;\n    options?: TOptions & { shouldReturn?: true; force?: boolean };\n  }): Promise<TCount & { data: Array<R> | null }>;\n  deleteBy<R = TDataObject>(opts: {\n    where: TWhere<TDataObject>;\n    options?: TOptions & { shouldReturn?: boolean; force?: boolean };\n  }): Promise<TCount & { data: TNullable<Array<R>> }> {\n    const { where, options } = opts;\n\n    if (options?.shouldReturn === false) {\n      return this.deleteAll({ where, options: { ...options, shouldReturn: false } });\n    }\n\n    return this.deleteAll<R>({ where, options });\n  }\n}\n"]}
+{"version":3,"file":"abstract.js","sourceRoot":"","sources":["../../../../../src/base/repositories/core/abstract.ts"],"names":[],"mappings":"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","sourcesContent":["import type { AbstractDataSource } from '@/base/datasources';\nimport type { AbstractEntity, IdType } from '@/base/models';\nimport type { IModelMetadata } from '@/helpers/inversion';\nimport { MetadataRegistry } from '@/helpers/inversion';\nimport type { TClass, TNullable } from '@venizia/ignis-helpers/common';\nimport { BaseHelper, getError } from '@venizia/ignis-helpers/core';\nimport { ResolverUtility } from '@venizia/ignis-helpers/common';\nimport { RetryBackoffStrategies, RetryHelper, RetryJitterModes } from '@venizia/ignis-helpers/core';\nimport type {\n  IExtraOptions,\n  IPersistableRepository,\n  IWithReadRetry,\n  TCount,\n  TDataWithRange,\n  TFindOneOptions,\n  TFindOptions,\n  TFindRangeOptions,\n  TRepositoryOperationScope,\n} from '../common';\n// The file, not the `../common` barrel: the barrel re-exports the OpenAPI schemas, and this module is\n// on the `./repository` entry, which must load without `@hono/zod-openapi` installed.\nimport {\n  DEFAULT_MAX_LIMIT,\n  RepositoryErrorCodes,\n  RepositoryOperationScopes,\n} from '../common/constants';\nimport type {\n  TByIdFilter,\n  TFields,\n  TFilter,\n  TInclusion,\n  TRow,\n  TWhere,\n} from '@venizia/ignis-filter';\n\n/**\n * Engine-neutral repository plumbing - lazy dataSource/entity resolution, class-keyed `@model`\n * settings, operation scope. `TOptions` defaults to `IExtraOptions` so connectors can narrow it\n * while staying assignable to this base.\n */\nexport abstract class AbstractRepository<\n  TDataObject extends object,\n  TPersistObject extends object = TDataObject,\n  TOptions extends IExtraOptions = IExtraOptions,\n>\n  extends BaseHelper\n  implements IPersistableRepository<TDataObject, TPersistObject, TOptions>\n{\n  protected _operationScope: TRepositoryOperationScope;\n\n  /** Lazy-resolved on first access if not provided in constructor. */\n  protected _dataSource?: AbstractDataSource;\n\n  /** Lazy-resolved from @repository metadata on first access. */\n  protected _entity?: AbstractEntity;\n\n  /**\n   * Memoized @model settings for `this.entity`'s class. `null` means not yet resolved - `undefined`\n   * is itself a valid resolved value: the model declares no settings.\n   */\n  private _modelSettings: IModelMetadata['settings'] | null = null;\n\n  constructor(\n    dataSource?: AbstractDataSource,\n    opts?: {\n      scope?: string;\n      entityClass?: TClass<AbstractEntity>;\n      operationScope?: TRepositoryOperationScope;\n    },\n  ) {\n    const scopeName =\n      opts?.scope ??\n      (opts?.entityClass?.name ? [opts.entityClass.name, 'Repository'].join('') : new.target.name);\n\n    super({ scope: scopeName });\n\n    this._operationScope = opts?.operationScope ?? RepositoryOperationScopes.READ_ONLY;\n\n    if (dataSource) {\n      this._dataSource = dataSource;\n    }\n\n    if (opts?.entityClass) {\n      this._entity = new opts.entityClass();\n    }\n  }\n\n  get dataSource(): AbstractDataSource {\n    if (!this._dataSource) {\n      throw getError({\n        message: `[${this.constructor.name}] DataSource not available. Use @repository({ model: YourModel, dataSource: YourDataSource }) or pass dataSource in constructor.`,\n      });\n    }\n\n    return this._dataSource;\n  }\n\n  set dataSource(value: AbstractDataSource) {\n    this._dataSource = value;\n  }\n\n  /** Auto-resolves from @repository metadata if not explicitly set. */\n  get entity(): AbstractEntity {\n    this._entity ??= this.resolveEntity();\n    return this._entity;\n  }\n\n  set entity(value: AbstractEntity) {\n    this._entity = value;\n  }\n\n  get operationScope(): TRepositoryOperationScope {\n    return this._operationScope;\n  }\n\n  setDataSource(opts: { dataSource: AbstractDataSource }): void {\n    this._dataSource = opts.dataSource;\n  }\n\n  getEntity(): AbstractEntity {\n    return this.entity;\n  }\n\n  /**\n   * Resolved `@model` settings for `this.entity`'s class, keyed by Reflect target - not by\n   * `entity.name`, which can diverge from the `@model` registry key.\n   */\n  protected get modelSettings(): IModelMetadata['settings'] {\n    if (this._modelSettings !== null) {\n      return this._modelSettings;\n    }\n\n    this._modelSettings = MetadataRegistry.getInstance().getModelMetadata({\n      target: this.entity.constructor,\n    })?.settings;\n\n    return this._modelSettings;\n  }\n\n  protected get hiddenFields(): string[] {\n    return this.modelSettings?.hiddenProperties ?? [];\n  }\n\n  /** Default where from @model settings.query.filter.where, AND-merged into every query unless skipped. */\n  protected get defaultWhere(): TWhere | undefined {\n    return this.modelSettings?.query?.filter?.where;\n  }\n\n  protected get defaultLimit(): number | undefined {\n    return this.modelSettings?.query?.limit?.default;\n  }\n\n  /** Largest `limit` a caller may ask for, when the model declares one; undefined leaves the tier's own default in force. */\n  protected get maxLimit(): number | undefined {\n    return this.modelSettings?.query?.limit?.max;\n  }\n\n  /**\n   * Both bounds, in one place, for every tier.\n   *\n   * The upper bound is the point: `@model({ settings: { maxLimit } })` is public and validated at\n   * decoration time, but the relational tier read it nowhere, so `maxLimit: 2` still issued\n   * `LIMIT 50000000`.\n   *\n   * The lower bound matters just as much and is easy to miss: a NEGATIVE limit is not a smaller\n   * page. Drizzle renders the LIMIT clause only when the value is `>= 0`, so a negative one removes\n   * the clause and returns the whole table. The wire schema now rejects it too, but a server-side\n   * caller reaches this method without passing through the schema at all.\n   */\n  protected assertLimitWithinCeiling(opts: { limit?: number; scope?: string }): void {\n    const { limit, scope = 'find' } = opts;\n\n    if (limit === undefined) {\n      return;\n    }\n\n    // The shape check first, because it needs no metadata at all.\n    if (!Number.isInteger(limit) || limit < 0) {\n      throw getError({\n        message: `[${this.constructor.name}][${scope}] Invalid 'limit' | Expected a non-negative integer | Got: ${limit}`,\n      });\n    }\n\n    // `maxLimit` reaches `modelSettings`, which resolves the entity - and THAT throws for a\n    // repository with no `@repository` model binding. Such a repository is a misconfiguration this\n    // method has no business reporting, and the caller path that used to reach `getDefaultLimit()`\n    // never touched it either, because `??` short-circuits when a limit is given. So the ceiling is\n    // consulted only when the binding that makes it resolvable is actually present.\n    const hasModelBinding = Boolean(\n      MetadataRegistry.getInstance().getRepositoryBinding({ target: this.constructor })?.model,\n    );\n    const ceiling = (hasModelBinding ? this.maxLimit : undefined) ?? DEFAULT_MAX_LIMIT;\n\n    if (limit > ceiling) {\n      throw getError({\n        message: `[${this.constructor.name}][${scope}] Requested page exceeds this model's limit | requested: ${limit} | maximum: ${ceiling} | raise it with @model settings.maxLimit if larger pages are genuinely needed`,\n      });\n    }\n  }\n\n  /**\n   * The whole filter, relations included. Checking only the top-level `limit` left the identical\n   * defect reachable one level down: a relation scope's negative limit drops Drizzle's LIMIT clause\n   * for that relation and loads the entire related table.\n   *\n   * A relation's limit gets the SHAPE check only, not a ceiling. The ceiling belongs to the\n   * relation's own model, which this repository cannot resolve - claiming otherwise would enforce\n   * the parent's `maxLimit` on a different entity.\n   */\n  protected assertFilterLimits(opts: { filter?: TFilter; scope?: string }): void {\n    const { filter, scope = 'find' } = opts;\n\n    if (!filter) {\n      return;\n    }\n\n    this.assertLimitWithinCeiling({ limit: filter.limit, scope });\n\n    const walk = (inclusions: TInclusion[] | undefined, path: string): void => {\n      const inclusionsList = inclusions ?? [];\n      for (const inclusion of inclusionsList) {\n        const relationScope = inclusion.scope;\n        if (!relationScope) {\n          continue;\n        }\n\n        const relationPath = `${path}.${inclusion.relation}`;\n        const relationLimit = relationScope.limit;\n\n        if (\n          relationLimit !== undefined &&\n          (!Number.isInteger(relationLimit) || relationLimit < 0)\n        ) {\n          throw getError({\n            message: `[${this.constructor.name}][${scope}] Invalid 'limit' on relation scope | relation: ${relationPath} | Expected a non-negative integer | Got: ${relationLimit}`,\n          });\n        }\n\n        walk(relationScope.include, relationPath);\n      }\n    };\n\n    walk(filter.include, scope);\n  }\n\n  /** Resolves the entity instance from @repository metadata on first access. */\n  protected resolveEntity(): AbstractEntity {\n    const registry = MetadataRegistry.getInstance();\n    const binding = registry.getRepositoryBinding({ target: this.constructor });\n\n    if (!binding?.model) {\n      throw getError({\n        message: `[${this.constructor.name}] Cannot resolve entity. Either pass entityClass in constructor or use @repository decorator with model option.`,\n      });\n    }\n\n    // ResolverUtility.resolveValue() erases to the resolved value's structural type, not this class-or-resolver\n    // union's member - the `@repository` decorator guarantees a class constructor here.\n    const ModelClass = ResolverUtility.resolveValue({\n      value: binding.model,\n    }) as TClass<AbstractEntity>;\n    return new ModelClass();\n  }\n\n  /** Rejects a verb the current operation scope does not permit. */\n  protected denyOperation(opts: { methodName: string }): never {\n    throw getError({\n      messageCode: RepositoryErrorCodes.OPERATION_NOT_ALLOWED,\n      message: `[${opts.methodName}] Repository operation is NOT ALLOWED | scope: ${this.operationScope}`,\n    });\n  }\n\n  /**\n   * Shared retry orchestration for read verbs. Inside a transaction retry is skipped - the pool\n   * routes transactions to the primary, so there is no replica lag to wait out.\n   */\n  protected executeReadWithRetry<TResult>(opts: {\n    operation: string;\n    options: IExtraOptions & IWithReadRetry<TResult>;\n    defaultUntil: (result: TResult) => boolean;\n    execution: () => Promise<TResult>;\n  }): Promise<TResult> {\n    const { operation, options, defaultUntil, execution } = opts;\n\n    if (!options.retry) {\n      return execution();\n    }\n\n    if (options.transaction) {\n      this.logger.for(operation).debug('Read retry skipped inside transaction');\n      return execution();\n    }\n\n    const { maxAttempts, maxTotalMs, signal, backoff, until } = options.retry;\n\n    return RetryHelper.executeWithRetryUntil<TResult>({\n      operation: [this.constructor.name, operation].join('.'),\n      execution,\n      until: until ?? defaultUntil,\n      maxAttempts,\n      maxTotalMs,\n      signal,\n      backoff: backoff ?? {\n        strategy: RetryBackoffStrategies.EXPONENTIAL,\n        initialDelayMs: 50,\n        maxDelayMs: 500,\n        jitter: RetryJitterModes.EQUAL,\n      },\n      logger: this.logger,\n    });\n  }\n\n  /**\n   * A copy of `options` without `retry`, so re-entering a read verb takes its non-retry path - this\n   * is what keeps the retry recursion single-depth. Copy-then-delete rather than a rest-destructure\n   * (lint rejects the unused rest sibling) or `lodash/omit` (its `Omit<>` return type is not\n   * assignable back to `TOptions`).\n   */\n  private omitReadRetry<TReadOptions extends { retry?: unknown }>(\n    options: TReadOptions,\n  ): TReadOptions {\n    const rest = { ...options };\n    delete rest.retry;\n    return rest;\n  }\n\n  /** `find`, re-executed until the retry predicate holds - connectors dispatch here from `find` when `options.retry` is set. */\n  protected findUntil<R = TDataObject>(opts: {\n    filter: TFilter<TDataObject>;\n    options: TFindOptions<TOptions, R>;\n  }): Promise<Array<R>> {\n    const options = this.omitReadRetry(opts.options);\n\n    return this.executeReadWithRetry<Array<R>>({\n      operation: 'find',\n      options: opts.options,\n      defaultUntil: (result) => result.length > 0,\n      // `R` is named here, so the row is `R`; TypeScript cannot resolve `TRow` for an unresolved `R`.\n      execution: () => this.find<R>({ filter: opts.filter, options }) as Promise<Array<R>>,\n    });\n  }\n\n  /** `find` with the range envelope, re-executed until the retry predicate holds - split from `findUntil` so each result shape is checked against its own `find` overload. */\n  protected findRangeUntil<R = TDataObject>(opts: {\n    filter: TFilter<TDataObject>;\n    options: TFindRangeOptions<TOptions, R>;\n  }): Promise<TDataWithRange<R>> {\n    const options = this.omitReadRetry(opts.options);\n\n    return this.executeReadWithRetry<TDataWithRange<R>>({\n      operation: 'find',\n      options: opts.options,\n      defaultUntil: (result) => result.data.length > 0,\n      execution: () =>\n        this.find<R>({ filter: opts.filter, options }) as unknown as Promise<TDataWithRange<R>>,\n    });\n  }\n\n  /** `findOne`, re-executed until the retry predicate holds - also serves `findById` via its findOne delegation. */\n  protected findOneUntil<R = TDataObject>(opts: {\n    filter: TFilter<TDataObject>;\n    options: TFindOneOptions<TOptions, R>;\n  }): Promise<TNullable<R>> {\n    const options = this.omitReadRetry(opts.options);\n\n    return this.executeReadWithRetry<TNullable<R>>({\n      operation: 'findOne',\n      options: opts.options,\n      defaultUntil: (result) => result !== null && result !== undefined,\n      execution: () => this.findOne<R>({ filter: opts.filter, options }) as Promise<TNullable<R>>,\n    });\n  }\n\n  abstract count(opts: { where: TWhere<TDataObject>; options?: TOptions }): Promise<TCount>;\n\n  abstract existsWith(opts: { where: TWhere<TDataObject>; options?: TOptions }): Promise<boolean>;\n\n  abstract find<R = unknown, const F extends TFields<TDataObject> = TFields<TDataObject>>(opts: {\n    filter: TFilter<TDataObject, F>;\n    options: TFindRangeOptions<TOptions, TRow<TDataObject, R, F>>;\n  }): Promise<TDataWithRange<TRow<TDataObject, R, F>>>;\n\n  abstract find<R = unknown, const F extends TFields<TDataObject> = TFields<TDataObject>>(opts: {\n    filter: TFilter<TDataObject, F>;\n    options?: TFindOptions<TOptions, TRow<TDataObject, R, F>>;\n  }): Promise<Array<TRow<TDataObject, R, F>>>;\n\n  abstract findOne<R = unknown, const F extends TFields<TDataObject> = TFields<TDataObject>>(opts: {\n    filter: TFilter<TDataObject, F>;\n    options?: TFindOneOptions<TOptions, TRow<TDataObject, R, F>>;\n  }): Promise<TNullable<TRow<TDataObject, R, F>>>;\n\n  abstract findById<\n    R = unknown,\n    const F extends TFields<TDataObject> = TFields<TDataObject>,\n  >(opts: {\n    id: IdType;\n    filter?: TByIdFilter<TDataObject, F>;\n    options?: TFindOneOptions<TOptions, TRow<TDataObject, R, F>>;\n  }): Promise<TNullable<TRow<TDataObject, R, F>>>;\n\n  abstract create(opts: {\n    data: TPersistObject;\n    options: TOptions & { shouldReturn: false };\n  }): Promise<TCount & { data: undefined | null }>;\n\n  abstract create<R = TDataObject>(opts: {\n    data: TPersistObject;\n    options?: TOptions & { shouldReturn?: true };\n  }): Promise<TCount & { data: R }>;\n\n  abstract createAll(opts: {\n    data: Array<TPersistObject>;\n    options: TOptions & { shouldReturn: false };\n  }): Promise<TCount & { data: undefined | null }>;\n\n  abstract createAll<R = TDataObject>(opts: {\n    data: Array<TPersistObject>;\n    options?: TOptions & { shouldReturn?: true };\n  }): Promise<TCount & { data: Array<R> }>;\n\n  abstract updateById(opts: {\n    id: IdType;\n    data: Partial<TPersistObject>;\n    options: TOptions & { shouldReturn: false };\n  }): Promise<TCount & { data: undefined | null }>;\n\n  abstract updateById<R = TDataObject>(opts: {\n    id: IdType;\n    data: Partial<TPersistObject>;\n    options?: TOptions & { shouldReturn?: true };\n  }): Promise<TCount & { data: R }>;\n\n  abstract updateAll(opts: {\n    data: Partial<TPersistObject>;\n    where: TWhere<TDataObject>;\n    options: TOptions & { shouldReturn: false; force?: boolean };\n  }): Promise<TCount & { data: undefined | null }>;\n\n  abstract updateAll<R = TDataObject>(opts: {\n    data: Partial<TPersistObject>;\n    where: TWhere<TDataObject>;\n    options?: TOptions & { 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: TOptions & { shouldReturn: false; force?: boolean };\n  }): Promise<TCount & { data: undefined | null }>;\n  updateBy<R = TDataObject>(opts: {\n    data: Partial<TPersistObject>;\n    where: TWhere<TDataObject>;\n    options?: TOptions & { shouldReturn?: true; force?: boolean };\n  }): Promise<TCount & { data: Array<R> | null }>;\n  updateBy<R = TDataObject>(opts: {\n    data: Partial<TPersistObject>;\n    where: TWhere<TDataObject>;\n    options?: TOptions & { shouldReturn?: boolean; force?: boolean };\n  }): Promise<TCount & { data: TNullable<Array<R>> }> {\n    const { data, where, options } = opts;\n\n    if (options?.shouldReturn === false) {\n      return this.updateAll({ data, where, options: { ...options, shouldReturn: false } });\n    }\n\n    return this.updateAll<R>({ data, where, options });\n  }\n\n  abstract deleteById(opts: {\n    id: IdType;\n    options: TOptions & { shouldReturn: false };\n  }): Promise<TCount & { data: undefined | null }>;\n\n  abstract deleteById<R = TDataObject>(opts: {\n    id: IdType;\n    options?: TOptions & { shouldReturn?: true };\n  }): Promise<TCount & { data: R }>;\n\n  abstract deleteAll(opts: {\n    where?: TWhere<TDataObject>;\n    options: TOptions & { shouldReturn: false; force?: boolean };\n  }): Promise<TCount & { data: undefined | null }>;\n\n  abstract deleteAll<R = TDataObject>(opts: {\n    where?: TWhere<TDataObject>;\n    options?: TOptions & { 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: TOptions & { shouldReturn: false; force?: boolean };\n  }): Promise<TCount & { data: undefined | null }>;\n  deleteBy<R = TDataObject>(opts: {\n    where: TWhere<TDataObject>;\n    options?: TOptions & { shouldReturn?: true; force?: boolean };\n  }): Promise<TCount & { data: Array<R> | null }>;\n  deleteBy<R = TDataObject>(opts: {\n    where: TWhere<TDataObject>;\n    options?: TOptions & { shouldReturn?: boolean; force?: boolean };\n  }): Promise<TCount & { data: TNullable<Array<R>> }> {\n    const { where, options } = opts;\n\n    if (options?.shouldReturn === false) {\n      return this.deleteAll({ where, options: { ...options, shouldReturn: false } });\n    }\n\n    return this.deleteAll<R>({ where, options });\n  }\n}\n"]}