@venizia/ignis-kernel 0.4.3 → 0.4.5

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

@@ -1,103 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.jsonResponse = exports.errorResponses = exports.jsonContent = exports.idParamsSchema = exports.ErrorSchema = void 0;
-const zod_openapi_1 = require("@hono/zod-openapi");
-const common_1 = require("@venizia/ignis-helpers/common");
-const core_1 = require("@venizia/ignis-helpers/core");
-/**
- * The error RESPONSE for OpenAPI docs - here, beside the REST layer that already needs `@hono/zod-openapi`.
- * Named, so every route's `4XX` and `5XX` reference one `ErrorResponse` component.
- */
-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('ErrorResponse', {
-    description: 'Error Schema',
-    example: {
-        statusCode: common_1.HTTP.ResultCodes.RS_4.Conflict,
-        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;
-/** The JSON error body of a route, under `4XX` and `5XX` - the range keys OpenAPI accepts. */
-const errorResponses = () => {
-    const errorResponse = (0, exports.jsonContent)({ description: 'Error Response', schema: exports.ErrorSchema });
-    return { '4XX': errorResponse, '5XX': errorResponse };
-};
-exports.errorResponses = errorResponses;
-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,
-        ...(0, exports.errorResponses)(),
-    };
-};
-exports.jsonResponse = jsonResponse;
-//# sourceMappingURL=schemas.js.map

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

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

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

@@ -1,22 +0,0 @@
-export type NumberIdType = number;
-export type StringIdType = string;
-export type BigIntIdType = bigint;
-export type IdType = NumberIdType | StringIdType | BigIntIdType;
-declare const entityIdBrand: unique symbol;
-/**
- * A string id a plain `string` cannot be assigned to, so passing a name, code or email where an id
- * belongs is a compile error. Opt a column in with `.$type<TEntityId>()`.
- *
- * IT VALIDATES NOTHING. `toEntityId` is a cast with a non-empty check; the value is making the
- * laundering VISIBLE at each boundary, not proving the string is a real id.
- *
- * The cost is not optional: Drizzle derives `$inferInsert` and `$inferSelect` from the same field,
- * so a branded column rejects every literal - `create({ data: { merchantId: 'M1' } })`, seeds,
- * fixtures, path params - until each converts. A union with `string` would restore those but makes
- * a plain `string` assignable again, which erases the whole guarantee. Measured, not assumed.
- */
-export type TEntityId = string & {
-    readonly [entityIdBrand]: never;
-};
-export {};
-//# sourceMappingURL=id.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"id.d.ts","sourceRoot":"","sources":["../../../../../../src/base/models/common/types/id.ts"],"names":[],"mappings":"AAAA,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,OAAO,CAAC,MAAM,aAAa,EAAE,OAAO,MAAM,CAAC;AAE3C;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,CAAC,aAAa,CAAC,EAAE,KAAK,CAAA;CAAE,CAAC"}

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

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

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

@@ -1 +0,0 @@
-{"version":3,"file":"id.js","sourceRoot":"","sources":["../../../../../../src/base/models/common/types/id.ts"],"names":[],"mappings":"","sourcesContent":["export type NumberIdType = number;\nexport type StringIdType = string;\nexport type BigIntIdType = bigint;\nexport type IdType = NumberIdType | StringIdType | BigIntIdType;\n\ndeclare const entityIdBrand: unique symbol;\n\n/**\n * A string id a plain `string` cannot be assigned to, so passing a name, code or email where an id\n * belongs is a compile error. Opt a column in with `.$type<TEntityId>()`.\n *\n * IT VALIDATES NOTHING. `toEntityId` is a cast with a non-empty check; the value is making the\n * laundering VISIBLE at each boundary, not proving the string is a real id.\n *\n * The cost is not optional: Drizzle derives `$inferInsert` and `$inferSelect` from the same field,\n * so a branded column rejects every literal - `create({ data: { merchantId: 'M1' } })`, seeds,\n * fixtures, path params - until each converts. A union with `string` would restore those but makes\n * a plain `string` assignable again, which erases the whole guarantee. Measured, not assumed.\n */\nexport type TEntityId = string & { readonly [entityIdBrand]: never };\n"]}

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

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

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

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

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

@@ -1,18 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./id"), exports);
-//# sourceMappingURL=index.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../src/base/models/common/types/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,uCAAqB","sourcesContent":["export * from './id';\n"]}

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

@@ -1,13 +0,0 @@
-import { z } from '@hono/zod-openapi';
-import type { TEntityId } from './types';
-/** 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>>;
-export {};
-//# sourceMappingURL=utilities.d.ts.map

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

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

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

@@ -1,24 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.snakeToCamel = exports.toEntityId = void 0;
-const zod_openapi_1 = require("@hono/zod-openapi");
-const core_1 = require("@venizia/ignis-helpers/core");
-/** The only way into `TEntityId`. Rejects an empty string - an id that is `''` collapses a `where` to no condition. */
-const toEntityId = (opts) => {
-    if (opts.value.length === 0) {
-        throw (0, core_1.getError)({ message: '[toEntityId] Refusing an empty string as an entity id' });
-    }
-    return opts.value;
-};
-exports.toEntityId = toEntityId;
-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=utilities.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"utilities.js","sourceRoot":"","sources":["../../../../../src/base/models/common/utilities.ts"],"names":[],"mappings":";;;AAAA,mDAAsC;AACtC,sDAA6E;AAG7E,uHAAuH;AAChH,MAAM,UAAU,GAAG,CAAC,IAAuB,EAAa,EAAE;IAC/D,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAA,eAAQ,EAAC,EAAE,OAAO,EAAE,uDAAuD,EAAE,CAAC,CAAC;IACvF,CAAC;IAED,OAAO,IAAI,CAAC,KAAkB,CAAC;AACjC,CAAC,CAAC;AANW,QAAA,UAAU,cAMrB;AAYK,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,IAAA,cAAO,EAAC,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC;IAC/B,CAAC,CAAC,CACkB,CAAC;IAEvB,OAAO,eAAC;SACL,MAAM,CAAC,KAAK,CAAC;SACb,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAA,kBAAW,EAAC,IAAI,CAAC,CAAC;SACtC,IAAI,CAAC,eAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC;AAChC,CAAC,CAAC;AAXW,QAAA,YAAY,gBAWvB","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"]}

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

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

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

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

@@ -1,19 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./base"), exports);
-__exportStar(require("./common"), exports);
-//# sourceMappingURL=index.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/base/models/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,yCAAuB;AACvB,2CAAyB","sourcesContent":["export * from './base';\nexport * from './common';\n"]}

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

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

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

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

@@ -1 +0,0 @@
-{"version":3,"file":"base.js","sourceRoot":"","sources":["../../../../src/base/providers/base.ts"],"names":[],"mappings":";;;AACA,sDAAyD;AAGzD,MAAsB,YAAgB,SAAQ,iBAAU;CAEvD;AAFD,oCAEC","sourcesContent":["import type { Container } from '@/helpers/inversion';\nimport { BaseHelper } from '@venizia/ignis-helpers/core';\nimport type { IProvider } from '@venizia/ignis-inversion';\n\nexport abstract class BaseProvider<T> extends BaseHelper implements IProvider<T> {\n  abstract value(container: Container): T;\n}\n"]}

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

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

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

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

@@ -1,18 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./base"), exports);
-//# sourceMappingURL=index.js.map

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

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

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

@@ -1,105 +0,0 @@
-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>;
-/** What `@repository` binds: MODEL, a model this application declares (the default); REMOTE, data behind another service's API, with no model. */
-export declare class RepositoryTypes {
-    static readonly MODEL = "model";
-    static readonly REMOTE = "remote";
-    static readonly SCHEME_SET: Set<string>;
-    static isValid(value: string): boolean;
-}
-/** Valid repository type values. */
-export type TRepositoryType = TConstValue<typeof RepositoryTypes>;
-/** What a row-scope filter (`@model` settings.access) does when `resolve()` returns null/undefined. */
-export declare class ScopeFilterMissingBehaviors {
-    /** An unresolved scope matches ZERO rows - the safe reading of "caller's scope is unknown". */
-    static readonly DENY = "deny";
-    /** Explicit opt-out: no scope is applied. For migrations and background jobs, never inferred from a request. */
-    static readonly ALLOW = "allow";
-    static readonly SCHEME_SET: Set<string>;
-    static isValid(behavior: string): boolean;
-}
-/** Valid scope-filter missing-behavior values. */
-export type TScopeFilterMissingBehavior = TConstValue<typeof ScopeFilterMissingBehaviors>;
-/**
- * What a scoped write does with a row whose scope column disagrees with the resolved scope
- * (`@model` settings.access.write.mode). A scope that returns `ScopeFilters.UNRESTRICTED`
- * passes either way.
- */
-export declare class ScopeWriteGuards {
-    /** Default. A row whose scope column disagrees, or is absent on create, is refused and nothing is written. */
-    static readonly REJECT = "reject";
-    /** An ABSENT scope column is filled from an equality scope; a value that disagrees is still refused. */
-    static readonly ASSIGN = "assign";
-    static readonly SCHEME_SET: Set<string>;
-    static isValid(guard: string): boolean;
-}
-/** Valid scope write-guard values. */
-export type TScopeWriteGuard = TConstValue<typeof ScopeWriteGuards>;
-/**
- * The third `resolve()` state, beside a `where` and `deny`-by-default null/undefined: unrestricted
- * for THIS call. `onMissing: 'allow'` cannot express it - `onMissing` lives on the model's static
- * settings, so using it for a per-user bypass (an internal operator) would also unscope every
- * ordinary user whose `resolve()` happens to return nothing.
- */
-export declare class ScopeFilters {
-    /**
-     * Return from `resolve()` to apply NO scope for this request - a caller the application has
-     * decided sees everything. Deliberately a symbol: forgetting to return must land in deny, and no
-     * JSON body, query string, or header can ever produce this value. `Symbol.for` so two installed
-     * copies of this package agree on identity, same as `DATA_SOURCE_BRAND`.
-     */
-    static readonly UNRESTRICTED: unique symbol;
-}
-/** 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;
-    /** A write whose scope column disagrees with the resolved scope, or whose scope cannot be verified (`access` write guard). */
-    static readonly SCOPE_WRITE_DENIED: 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

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

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

@@ -1,123 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.LockStrengths = exports.RelationTypes = exports.RepositoryErrorCodes = exports.ScopeFilters = exports.ScopeWriteGuards = exports.ScopeFilterMissingBehaviors = exports.RepositoryTypes = 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;
-/** What `@repository` binds: MODEL, a model this application declares (the default); REMOTE, data behind another service's API, with no model. */
-class RepositoryTypes {
-    static { this.MODEL = 'model'; }
-    static { this.REMOTE = 'remote'; }
-    static { this.SCHEME_SET = new Set([this.MODEL, this.REMOTE]); }
-    static isValid(value) {
-        return this.SCHEME_SET.has(value);
-    }
-}
-exports.RepositoryTypes = RepositoryTypes;
-/** What a row-scope filter (`@model` settings.access) does when `resolve()` returns null/undefined. */
-class ScopeFilterMissingBehaviors {
-    /** An unresolved scope matches ZERO rows - the safe reading of "caller's scope is unknown". */
-    static { this.DENY = 'deny'; }
-    /** Explicit opt-out: no scope is applied. For migrations and background jobs, never inferred from a request. */
-    static { this.ALLOW = 'allow'; }
-    static { this.SCHEME_SET = new Set([this.DENY, this.ALLOW]); }
-    static isValid(behavior) {
-        return this.SCHEME_SET.has(behavior);
-    }
-}
-exports.ScopeFilterMissingBehaviors = ScopeFilterMissingBehaviors;
-/**
- * What a scoped write does with a row whose scope column disagrees with the resolved scope
- * (`@model` settings.access.write.mode). A scope that returns `ScopeFilters.UNRESTRICTED`
- * passes either way.
- */
-class ScopeWriteGuards {
-    /** Default. A row whose scope column disagrees, or is absent on create, is refused and nothing is written. */
-    static { this.REJECT = 'reject'; }
-    /** An ABSENT scope column is filled from an equality scope; a value that disagrees is still refused. */
-    static { this.ASSIGN = 'assign'; }
-    static { this.SCHEME_SET = new Set([this.REJECT, this.ASSIGN]); }
-    static isValid(guard) {
-        return this.SCHEME_SET.has(guard);
-    }
-}
-exports.ScopeWriteGuards = ScopeWriteGuards;
-/**
- * The third `resolve()` state, beside a `where` and `deny`-by-default null/undefined: unrestricted
- * for THIS call. `onMissing: 'allow'` cannot express it - `onMissing` lives on the model's static
- * settings, so using it for a per-user bypass (an internal operator) would also unscope every
- * ordinary user whose `resolve()` happens to return nothing.
- */
-class ScopeFilters {
-    /**
-     * Return from `resolve()` to apply NO scope for this request - a caller the application has
-     * decided sees everything. Deliberately a symbol: forgetting to return must land in deny, and no
-     * JSON body, query string, or header can ever produce this value. `Symbol.for` so two installed
-     * copies of this package agree on identity, same as `DATA_SOURCE_BRAND`.
-     */
-    static { this.UNRESTRICTED = Symbol.for('@venizia/ignis-kernel:scope-filter-unrestricted'); }
-}
-exports.ScopeFilters = ScopeFilters;
-/** 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'],
-    }); }
-    /** A write whose scope column disagrees with the resolved scope, or whose scope cannot be verified (`access` write guard). */
-    static { this.SCOPE_WRITE_DENIED = core_1.MessageCode.build({
-        parts: ['core', 'repository', 'scope_write_denied'],
-    }); }
-}
-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

@@ -1 +0,0 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../../src/base/repositories/common/constants.ts"],"names":[],"mappings":"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","sourcesContent":["import type { TConstValue } from '@venizia/ignis-helpers/common';\nimport { MessageCode } from '@venizia/ignis-helpers/core';\n\n/** Default pagination limit for repository queries. */\nexport const DEFAULT_LIMIT = 10;\n\n/**\n * Largest `limit` a caller may ask for when a model declares no `maxLimit`.\n *\n * POLICY, not capacity - it sits far below what an engine can physically serve. It exists because\n * removing an accidental guardrail without replacing it would leave the framework less safe than\n * before: a search engine refused a page over 250 hits, so `limit: 5000` failed fast and cheap.\n * Once that page is served, something has to decide when a page is unreasonable.\n *\n * 1000 sits above any list screen and well below the physical ceiling, so reaching it means the\n * caller is doing something unusual - and a model raises it by saying so explicitly.\n */\nexport const DEFAULT_MAX_LIMIT = 1000;\n\n/** Defines the operation scope for repository instances (READ_ONLY, WRITE_ONLY, READ_WRITE). */\nexport class RepositoryOperationScopes {\n  static readonly READ_ONLY = 'READ_ONLY';\n  static readonly WRITE_ONLY = 'WRITE_ONLY';\n  static readonly READ_WRITE = 'READ_WRITE';\n  static readonly SCHEME_SET = new Set([this.READ_ONLY, this.WRITE_ONLY, this.READ_WRITE]);\n\n  static isValid(orgType: string): boolean {\n    return this.SCHEME_SET.has(orgType);\n  }\n}\n\n/** Valid repository operation scope values. */\nexport type TRepositoryOperationScope = TConstValue<typeof RepositoryOperationScopes>;\n\n/** What `@repository` binds: MODEL, a model this application declares (the default); REMOTE, data behind another service's API, with no model. */\nexport class RepositoryTypes {\n  static readonly MODEL = 'model';\n  static readonly REMOTE = 'remote';\n  static readonly SCHEME_SET = new Set([this.MODEL, this.REMOTE]);\n\n  static isValid(value: string): boolean {\n    return this.SCHEME_SET.has(value);\n  }\n}\n\n/** Valid repository type values. */\nexport type TRepositoryType = TConstValue<typeof RepositoryTypes>;\n\n/** What a row-scope filter (`@model` settings.access) does when `resolve()` returns null/undefined. */\nexport class ScopeFilterMissingBehaviors {\n  /** An unresolved scope matches ZERO rows - the safe reading of \"caller's scope is unknown\". */\n  static readonly DENY = 'deny';\n  /** Explicit opt-out: no scope is applied. For migrations and background jobs, never inferred from a request. */\n  static readonly ALLOW = 'allow';\n  static readonly SCHEME_SET = new Set([this.DENY, this.ALLOW]);\n\n  static isValid(behavior: string): boolean {\n    return this.SCHEME_SET.has(behavior);\n  }\n}\n\n/** Valid scope-filter missing-behavior values. */\nexport type TScopeFilterMissingBehavior = TConstValue<typeof ScopeFilterMissingBehaviors>;\n\n/**\n * What a scoped write does with a row whose scope column disagrees with the resolved scope\n * (`@model` settings.access.write.mode). A scope that returns `ScopeFilters.UNRESTRICTED`\n * passes either way.\n */\nexport class ScopeWriteGuards {\n  /** Default. A row whose scope column disagrees, or is absent on create, is refused and nothing is written. */\n  static readonly REJECT = 'reject';\n  /** An ABSENT scope column is filled from an equality scope; a value that disagrees is still refused. */\n  static readonly ASSIGN = 'assign';\n  static readonly SCHEME_SET = new Set([this.REJECT, this.ASSIGN]);\n\n  static isValid(guard: string): boolean {\n    return this.SCHEME_SET.has(guard);\n  }\n}\n\n/** Valid scope write-guard values. */\nexport type TScopeWriteGuard = TConstValue<typeof ScopeWriteGuards>;\n\n/**\n * The third `resolve()` state, beside a `where` and `deny`-by-default null/undefined: unrestricted\n * for THIS call. `onMissing: 'allow'` cannot express it - `onMissing` lives on the model's static\n * settings, so using it for a per-user bypass (an internal operator) would also unscope every\n * ordinary user whose `resolve()` happens to return nothing.\n */\nexport class ScopeFilters {\n  /**\n   * Return from `resolve()` to apply NO scope for this request - a caller the application has\n   * decided sees everything. Deliberately a symbol: forgetting to return must land in deny, and no\n   * JSON body, query string, or header can ever produce this value. `Symbol.for` so two installed\n   * copies of this package agree on identity, same as `DATA_SOURCE_BRAND`.\n   */\n  static readonly UNRESTRICTED = Symbol.for('@venizia/ignis-kernel:scope-filter-unrestricted');\n}\n\n/** 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. */\nexport class RepositoryErrorCodes {\n  /** A verb the repository's `operationScope` does not permit (e.g. `create()` on a READ_ONLY one). */\n  static readonly OPERATION_NOT_ALLOWED = MessageCode.build({\n    parts: ['core', 'repository', 'operation_not_allowed'],\n  });\n\n  /** A write whose scope column disagrees with the resolved scope, or whose scope cannot be verified (`access` write guard). */\n  static readonly SCOPE_WRITE_DENIED = MessageCode.build({\n    parts: ['core', 'repository', 'scope_write_denied'],\n  });\n}\n\n/** Valid repository error code values. */\nexport type TRepositoryErrorCode = TConstValue<typeof RepositoryErrorCodes>;\n\n/** Entity relation types (one-to-one/many-to-one, one-to-many). */\nexport class RelationTypes {\n  static readonly ONE = 'one';\n  static readonly MANY = 'many';\n  static readonly SCHEME_SET = new Set([this.ONE, this.MANY]);\n\n  static isValid(orgType: string): boolean {\n    return this.SCHEME_SET.has(orgType);\n  }\n}\n\n/** Valid relation type values. */\nexport type TRelationType = TConstValue<typeof RelationTypes>;\n\n/** PostgreSQL row-level lock strengths for SELECT ... FOR <strength>. */\nexport class LockStrengths {\n  static readonly UPDATE = 'update';\n  static readonly NO_KEY_UPDATE = 'no key update';\n  static readonly SHARE = 'share';\n  static readonly KEY_SHARE = 'key share';\n  static readonly SCHEME_SET = new Set([\n    this.UPDATE,\n    this.NO_KEY_UPDATE,\n    this.SHARE,\n    this.KEY_SHARE,\n  ]);\n\n  static isValid(strength: string): boolean {\n    return this.SCHEME_SET.has(strength);\n  }\n}\n\n/** Valid lock strength values. */\nexport type TLockStrength = TConstValue<typeof LockStrengths>;\n"]}

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

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

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