@venizia/ignis-kernel 0.2.0-0

package/dist/esm/base/metadata/injectors.js

@@ -0,0 +1,7 @@
+import { MetadataRegistry } from '../../helpers/inversion/index.js';
+import { inject as coreInject } from '@venizia/ignis-inversion';
+/** Marks a property or constructor parameter for dependency injection. */
+export const inject = (opts) => {
+    return coreInject({ ...opts, registry: MetadataRegistry.getInstance() });
+};
+//# sourceMappingURL=injectors.js.map

package/dist/esm/base/metadata/injectors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"injectors.js","sourceRoot":"","sources":["../../../../src/base/metadata/injectors.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAEhE,0EAA0E;AAC1E,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,IAAgD,EAAE,EAAE;IACzE,OAAO,UAAU,CAAC,EAAE,GAAG,IAAI,EAAE,QAAQ,EAAE,gBAAgB,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;AAC3E,CAAC,CAAC"}

package/dist/esm/base/metadata/persistents.d.ts

@@ -0,0 +1,10 @@
+import type { IDataSourceMetadata, IModelMetadata, IRepositoryMetadata } from '../../helpers/inversion/index.js';
+import type { IDataSource } from '../datasources/index.js';
+import type { AbstractEntity } from '../models/index.js';
+/** Registers a model class with its static schema and relations. */
+export declare const model: (metadata: IModelMetadata) => ClassDecorator;
+/** Registers a datasource with driver and auto-discovery settings. */
+export declare const datasource: (metadata?: IDataSourceMetadata) => ClassDecorator;
+/** Binds a repository to a model and datasource for schema auto-discovery. */
+export declare const repository: <Model extends AbstractEntity = AbstractEntity, DataSource extends IDataSource = IDataSource>(metadata: IRepositoryMetadata<Model, DataSource>) => ClassDecorator;
+//# sourceMappingURL=persistents.d.ts.map

package/dist/esm/base/metadata/persistents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"persistents.d.ts","sourceRoot":"","sources":["../../../../src/base/metadata/persistents.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,mBAAmB,EAEnB,cAAc,EACd,mBAAmB,EAEpB,MAAM,qBAAqB,CAAC;AAI7B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAEhD,oEAAoE;AACpE,eAAO,MAAM,KAAK,GAAI,UAAU,cAAc,KAAG,cA0BhD,CAAC;AAEF,sEAAsE;AACtE,eAAO,MAAM,UAAU,GAAI,WAAW,mBAAmB,KAAG,cAI3D,CAAC;AAiJF,8EAA8E;AAC9E,eAAO,MAAM,UAAU,GACrB,KAAK,SAAS,cAAc,GAAG,cAAc,EAC7C,UAAU,SAAS,WAAW,GAAG,WAAW,EAE5C,UAAU,mBAAmB,CAAC,KAAK,EAAE,UAAU,CAAC,KAC/C,cAaF,CAAC"}

package/dist/esm/base/metadata/persistents.js

@@ -0,0 +1,139 @@
+import { BindingNamespaces } from '../../common/bindings.js';
+import { BindingKeys, MetadataKeys, MetadataRegistry } from '../../helpers/inversion/index.js';
+import { getError } from '@venizia/ignis-helpers/core';
+import { resolveClass, resolveValue } from '@venizia/ignis-helpers/common';
+import { isDataSourceClass } from '../datasources/index.js';
+/** Registers a model class with its static schema and relations. */
+export const model = (metadata) => {
+    return target => {
+        const defaultLimit = metadata.settings?.defaultLimit;
+        if (defaultLimit !== undefined && (!Number.isInteger(defaultLimit) || defaultLimit <= 0)) {
+            throw getError({
+                message: `[model][${target.name}] Invalid 'defaultLimit' | Expected a positive integer | Got: ${defaultLimit}`,
+            });
+        }
+        // Validated at DECORATION time, like defaultLimit: a bad ceiling is a wiring mistake, and
+        // catching it at boot beats catching it on the one request that happens to reach the limit.
+        const maxLimit = metadata.settings?.maxLimit;
+        if (maxLimit !== undefined && (!Number.isInteger(maxLimit) || maxLimit <= 0)) {
+            throw getError({
+                message: `[model][${target.name}] Invalid 'maxLimit' | Expected a positive integer | Got: ${maxLimit}`,
+            });
+        }
+        // Auto-populate AUTHORIZATION_SUBJECT from authorize.principal if not already set
+        const principal = metadata.settings?.authorize?.principal;
+        if (principal && !Object.hasOwn(target, 'AUTHORIZATION_SUBJECT')) {
+            target.AUTHORIZATION_SUBJECT = principal;
+        }
+        MetadataRegistry.getInstance().registerModel({ target, metadata });
+    };
+};
+/** Registers a datasource with driver and auto-discovery settings. */
+export const datasource = (metadata) => {
+    return target => {
+        MetadataRegistry.getInstance().setDataSourceMetadata({ target, metadata });
+    };
+};
+/** Validates that both model and dataSource are provided together. */
+const validateRepositoryMetadata = (opts) => {
+    const { metadata, target } = opts;
+    if (!metadata.model) {
+        throw getError({
+            message: `[validateRepositoryMetadata][@repository][${target.name}] Invalid metadata | Missing 'model'`,
+        });
+    }
+    if (!metadata.dataSource) {
+        throw getError({
+            message: `[validateRepositoryMetadata][@repository][${target.name}] Invalid metadata | Missing 'dataSource'`,
+        });
+    }
+};
+/** Asserts the constructor's first parameter is an AbstractDataSource compatible with what @repository declared. */
+const validateFirstConstructorParameter = (opts) => {
+    const { target, firstParamType, resolvedDataSource } = opts;
+    // NOT `instanceof`: two copies of this package give two `AbstractDataSource` classes and the
+    // check would be false across them, rejecting a perfectly valid repository at import time.
+    const isDataSourceType = isDataSourceClass(firstParamType);
+    if (!isDataSourceType) {
+        throw getError({
+            message: `[@repository][${target.name}] Invalid constructor | First parameter must extend AbstractDataSource | Received: '${firstParamType.name}'`,
+        });
+    }
+    if (typeof resolvedDataSource !== 'function') {
+        return;
+    }
+    const isCompatible = firstParamType === resolvedDataSource || resolvedDataSource.prototype instanceof firstParamType;
+    if (!isCompatible) {
+        throw getError({
+            message: `[@repository][${target.name}] Invalid constructor | Type mismatch | Constructor expects '${firstParamType.name}' but @repository specifies '${resolvedDataSource.name}'`,
+        });
+    }
+};
+/** Auto-injects dataSource at constructor param[0] unless explicit @inject exists. */
+const registerDataSourceInjection = (opts) => {
+    const { target, registry, resolvedDataSource } = opts;
+    const paramTypes = Reflect.getMetadata('design:paramtypes', target);
+    const firstParamType = paramTypes?.[0];
+    if (firstParamType) {
+        validateFirstConstructorParameter({ target, firstParamType, resolvedDataSource });
+    }
+    // Own metadata only: `getInjectMetadata` walks the prototype chain, so a repository extending another @repository class would see the BASE's injection at param[0] and silently resolve the base's dataSource.
+    const ownInjects = Reflect.getOwnMetadata(MetadataKeys.INJECT, target);
+    const injectAtIndex0 = ownInjects?.find(entry => entry?.index === 0);
+    if (injectAtIndex0) {
+        const injectKey = injectAtIndex0.key;
+        const isDataSourceKey = typeof injectKey === 'string' && injectKey.startsWith(`${BindingNamespaces.DATASOURCE}.`);
+        if (!isDataSourceKey) {
+            throw getError({
+                message: `[@repository][${target.name}] Invalid constructor | First parameter must be a DataSource | Found @inject with key: '${injectKey.toString()}' | Expected key starting with '${BindingNamespaces.DATASOURCE}.'`,
+            });
+        }
+        return;
+    }
+    const dsName = typeof resolvedDataSource === 'string' ? resolvedDataSource : resolvedDataSource.name;
+    const dsBindingKey = BindingKeys.build({ namespace: BindingNamespaces.DATASOURCE, key: dsName });
+    // Copy-on-write for the same reason: setInjectMetadata mutates the array it reads through the prototype chain, which would rewrite the base repository's param[0] with this class's key.
+    if (!ownInjects) {
+        const inheritedInjects = registry.getInjectMetadata({ target });
+        Reflect.defineMetadata(MetadataKeys.INJECT, [...(inheritedInjects ?? [])], target);
+    }
+    registry.setInjectMetadata({
+        target,
+        index: 0,
+        metadata: { key: dsBindingKey, index: 0, isOptional: false },
+    });
+};
+/** Resolves repository metadata and registers bindings for schema auto-discovery. */
+const resolveRepositoryMetadata = (opts) => {
+    const { metadata, target, registry } = opts;
+    validateRepositoryMetadata({ metadata, target });
+    if (!metadata.model || !metadata.dataSource) {
+        return undefined;
+    }
+    const resolvedModel = resolveValue(metadata.model);
+    const resolvedDataSource = resolveClass(metadata.dataSource);
+    registry.registerRepositoryBinding({
+        repository: target,
+        model: resolvedModel,
+        dataSource: resolvedDataSource,
+    });
+    registerDataSourceInjection({ target, registry, resolvedDataSource });
+    return {
+        model: resolvedModel,
+        dataSource: resolvedDataSource,
+        operationScope: metadata.operationScope,
+    };
+};
+/** Binds a repository to a model and datasource for schema auto-discovery. */
+export const repository = (metadata) => {
+    return target => {
+        const registry = MetadataRegistry.getInstance();
+        const resolved = resolveRepositoryMetadata({ metadata, target, registry });
+        // `_resolved` is an internal cache field, not part of the public IRepositoryMetadata surface callers author - it is added here, so the merged literal needs the widened local type.
+        registry.setRepositoryMetadata({
+            target,
+            metadata: { ...metadata, _resolved: resolved },
+        });
+    };
+};
+//# sourceMappingURL=persistents.js.map

package/dist/esm/base/metadata/persistents.js.map

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

package/dist/esm/base/metadata/routes/common.d.ts

@@ -0,0 +1,24 @@
+/** Records the route/rpc decorators this runtime dropped, and warns about them once. Importing a module must stay side-effect free, so the drop is recorded at decoration time and reported later, at configure(). */
+export declare class DroppedRouteDecorators {
+    private static readonly dropped;
+    private static isReported;
+    /** True for the legacy (`experimentalDecorators`) call shape - under TC39 semantics decorators get `(method, context)` with no prototype to attach metadata to, so the route silently 404s; the drop is recorded instead. */
+    static isLegacyCall(opts: {
+        decorator: string;
+        propertyKey: unknown;
+    }): opts is {
+        decorator: string;
+        propertyKey: string | symbol;
+    };
+    /** Warns once per process about every route/rpc decorator this runtime dropped. */
+    static report(opts: {
+        logger: {
+            warn: (message: string, ...args: Array<unknown>) => void;
+        };
+    }): void;
+    /** @internal Test seam: every route/rpc decorator the runtime has dropped so far. */
+    static list(): Array<string>;
+}
+/** @internal Published name of {@link DroppedRouteDecorators.list} - the one core test that reaches it can only do so through the package barrel. */
+export declare const getDroppedRouteDecorators: () => Array<string>;
+//# sourceMappingURL=common.d.ts.map

package/dist/esm/base/metadata/routes/common.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../../../../src/base/metadata/routes/common.ts"],"names":[],"mappings":"AAAA,sNAAsN;AACtN,qBAAa,sBAAsB;IACjC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAqB;IACpD,OAAO,CAAC,MAAM,CAAC,UAAU,CAAS;IAElC,6NAA6N;IAC7N,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE;QACxB,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,EAAE,OAAO,CAAC;KACtB,GAAG,IAAI,IAAI;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE;IAY/D,mFAAmF;IACnF,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE;QAClB,MAAM,EAAE;YAAE,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,IAAI,CAAA;SAAE,CAAC;KACtE,GAAG,IAAI;IAaR,qFAAqF;IACrF,MAAM,CAAC,IAAI,IAAI,KAAK,CAAC,MAAM,CAAC;CAG7B;AAED,qJAAqJ;AACrJ,eAAO,MAAM,yBAAyB,QAAO,KAAK,CAAC,MAAM,CAAkC,CAAC"}

package/dist/esm/base/metadata/routes/common.js

@@ -0,0 +1,30 @@
+/** Records the route/rpc decorators this runtime dropped, and warns about them once. Importing a module must stay side-effect free, so the drop is recorded at decoration time and reported later, at configure(). */
+export class DroppedRouteDecorators {
+    static { this.dropped = []; }
+    static { this.isReported = false; }
+    /** True for the legacy (`experimentalDecorators`) call shape - under TC39 semantics decorators get `(method, context)` with no prototype to attach metadata to, so the route silently 404s; the drop is recorded instead. */
+    static isLegacyCall(opts) {
+        const { decorator, propertyKey } = opts;
+        if (typeof propertyKey === 'string' || typeof propertyKey === 'symbol') {
+            return true;
+        }
+        const methodName = propertyKey?.name ?? 'unknown';
+        DroppedRouteDecorators.dropped.push(`@${decorator} ${methodName}`);
+        return false;
+    }
+    /** Warns once per process about every route/rpc decorator this runtime dropped. */
+    static report(opts) {
+        if (DroppedRouteDecorators.isReported || DroppedRouteDecorators.dropped.length === 0) {
+            return;
+        }
+        DroppedRouteDecorators.isReported = true;
+        opts.logger.warn('IGNORED | %s route/rpc decorator(s) were compiled with TC39 semantics and could NOT be registered - their endpoints will 404 | Enable "experimentalDecorators" in the tsconfig your runtime actually resolves (a tsconfig whose "extends" chain the runtime cannot resolve is discarded whole) | dropped: %s', DroppedRouteDecorators.dropped.length, DroppedRouteDecorators.dropped.join(', '));
+    }
+    /** @internal Test seam: every route/rpc decorator the runtime has dropped so far. */
+    static list() {
+        return [...DroppedRouteDecorators.dropped];
+    }
+}
+/** @internal Published name of {@link DroppedRouteDecorators.list} - the one core test that reaches it can only do so through the package barrel. */
+export const getDroppedRouteDecorators = () => DroppedRouteDecorators.list();
+//# sourceMappingURL=common.js.map

package/dist/esm/base/metadata/routes/common.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.js","sourceRoot":"","sources":["../../../../../src/base/metadata/routes/common.ts"],"names":[],"mappings":"AAAA,sNAAsN;AACtN,MAAM,OAAO,sBAAsB;aACT,YAAO,GAAkB,EAAE,CAAC;aACrC,eAAU,GAAG,KAAK,CAAC;IAElC,6NAA6N;IAC7N,MAAM,CAAC,YAAY,CAAC,IAGnB;QACC,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,GAAG,IAAI,CAAC;QAExC,IAAI,OAAO,WAAW,KAAK,QAAQ,IAAI,OAAO,WAAW,KAAK,QAAQ,EAAE,CAAC;YACvE,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,UAAU,GAAI,WAAiC,EAAE,IAAI,IAAI,SAAS,CAAC;QACzE,sBAAsB,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,SAAS,IAAI,UAAU,EAAE,CAAC,CAAC;QACnE,OAAO,KAAK,CAAC;IACf,CAAC;IAED,mFAAmF;IACnF,MAAM,CAAC,MAAM,CAAC,IAEb;QACC,IAAI,sBAAsB,CAAC,UAAU,IAAI,sBAAsB,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACrF,OAAO;QACT,CAAC;QAED,sBAAsB,CAAC,UAAU,GAAG,IAAI,CAAC;QACzC,IAAI,CAAC,MAAM,CAAC,IAAI,CACd,8SAA8S,EAC9S,sBAAsB,CAAC,OAAO,CAAC,MAAM,EACrC,sBAAsB,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAC1C,CAAC;IACJ,CAAC;IAED,qFAAqF;IACrF,MAAM,CAAC,IAAI;QACT,OAAO,CAAC,GAAG,sBAAsB,CAAC,OAAO,CAAC,CAAC;IAC7C,CAAC;;AAGH,qJAAqJ;AACrJ,MAAM,CAAC,MAAM,yBAAyB,GAAG,GAAkB,EAAE,CAAC,sBAAsB,CAAC,IAAI,EAAE,CAAC"}

package/dist/esm/base/metadata/routes/controller.d.ts

@@ -0,0 +1,3 @@
+import type { TControllerMetadata } from '../../../helpers/inversion/index.js';
+export declare const controller: (metadata: TControllerMetadata) => ClassDecorator;
+//# sourceMappingURL=controller.d.ts.map

package/dist/esm/base/metadata/routes/controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"controller.d.ts","sourceRoot":"","sources":["../../../../../src/base/metadata/routes/controller.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAG/D,eAAO,MAAM,UAAU,GAAI,UAAU,mBAAmB,KAAG,cAI1D,CAAC"}

package/dist/esm/base/metadata/routes/controller.js

@@ -0,0 +1,7 @@
+import { MetadataRegistry } from '../../../helpers/inversion/index.js';
+export const controller = (metadata) => {
+    return target => {
+        MetadataRegistry.getInstance().setControllerMetadata({ target, metadata });
+    };
+};
+//# sourceMappingURL=controller.js.map

package/dist/esm/base/metadata/routes/controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"controller.js","sourceRoot":"","sources":["../../../../../src/base/metadata/routes/controller.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAEvD,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,QAA6B,EAAkB,EAAE;IAC1E,OAAO,MAAM,CAAC,EAAE;QACd,gBAAgB,CAAC,WAAW,EAAE,CAAC,qBAAqB,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC7E,CAAC,CAAC;AACJ,CAAC,CAAC"}

package/dist/esm/base/metadata/routes/index.d.ts

@@ -0,0 +1,5 @@
+export * from './controller.js';
+export * from './rest.js';
+export * from './rpc.js';
+export { getDroppedRouteDecorators } from './common.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/base/metadata/routes/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/base/metadata/routes/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,QAAQ,CAAC;AACvB,cAAc,OAAO,CAAC;AAKtB,OAAO,EAAE,yBAAyB,EAAE,MAAM,UAAU,CAAC"}

package/dist/esm/base/metadata/routes/index.js

@@ -0,0 +1,9 @@
+export * from './controller.js';
+export * from './rest.js';
+export * from './rpc.js';
+// `DroppedRouteDecorators` is decorator-migration instrumentation with no consumer outside this
+// directory - not re-exported. `getDroppedRouteDecorators` is a deliberate `@internal` test seam
+// (see its own doc comment) and the one core test that exercises it can only reach it through this
+// barrel, since a relative cross-package import trips `rootDir` when core actually compiles.
+export { getDroppedRouteDecorators } from './common.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/base/metadata/routes/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/base/metadata/routes/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,QAAQ,CAAC;AACvB,cAAc,OAAO,CAAC;AACtB,gGAAgG;AAChG,iGAAiG;AACjG,mGAAmG;AACnG,6FAA6F;AAC7F,OAAO,EAAE,yBAAyB,EAAE,MAAM,UAAU,CAAC"}

package/dist/esm/base/metadata/routes/rest.d.ts

@@ -0,0 +1,26 @@
+import type { IAuthRouteConfig } from '../../controllers/index.js';
+/** Generic route decorator. Registers route config in metadata registry. */
+export declare const api: <RestRouteConfigType extends IAuthRouteConfig>(opts: {
+    configs: RestRouteConfigType;
+}) => (target: any, propertyKey: string | symbol, _descriptor: PropertyDescriptor) => void;
+/** GET route decorator. Equivalent to @api but automatically sets method to 'get'. */
+export declare const get: <RestRouteConfigType extends Omit<IAuthRouteConfig, "method">>(opts: {
+    configs: RestRouteConfigType;
+}) => (target: any, propertyKey: string | symbol, _descriptor: PropertyDescriptor) => void;
+/** POST route decorator. Equivalent to @api but automatically sets method to 'post'. */
+export declare const post: <RestRouteConfigType extends Omit<IAuthRouteConfig, "method">>(opts: {
+    configs: RestRouteConfigType;
+}) => (target: any, propertyKey: string | symbol, _descriptor: PropertyDescriptor) => void;
+/** PUT route decorator. Equivalent to @api but automatically sets method to 'put'. */
+export declare const put: <RestRouteConfigType extends Omit<IAuthRouteConfig, "method">>(opts: {
+    configs: RestRouteConfigType;
+}) => (target: any, propertyKey: string | symbol, _descriptor: PropertyDescriptor) => void;
+/** PATCH route decorator. Equivalent to @api but automatically sets method to 'patch'. */
+export declare const patch: <RestRouteConfigType extends Omit<IAuthRouteConfig, "method">>(opts: {
+    configs: RestRouteConfigType;
+}) => (target: any, propertyKey: string | symbol, _descriptor: PropertyDescriptor) => void;
+/** DELETE route decorator. Equivalent to @api but automatically sets method to 'delete'. */
+export declare const del: <RestRouteConfigType extends Omit<IAuthRouteConfig, "method">>(opts: {
+    configs: RestRouteConfigType;
+}) => (target: any, propertyKey: string | symbol, _descriptor: PropertyDescriptor) => void;
+//# sourceMappingURL=rest.d.ts.map

package/dist/esm/base/metadata/routes/rest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rest.d.ts","sourceRoot":"","sources":["../../../../../src/base/metadata/routes/rest.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAG1D,4EAA4E;AAC5E,eAAO,MAAM,GAAG,GAAI,mBAAmB,SAAS,gBAAgB,EAAE,MAAM;IACtE,OAAO,EAAE,mBAAmB,CAAC;CAC9B,MAEG,QAAQ,GAAG,EACX,aAAa,MAAM,GAAG,MAAM,EAC5B,aAAa,kBAAkB,KAC9B,IAWJ,CAAC;AAEF,sFAAsF;AACtF,eAAO,MAAM,GAAG,GAAI,mBAAmB,SAAS,IAAI,CAAC,gBAAgB,EAAE,QAAQ,CAAC,EAAE,MAAM;IACtF,OAAO,EAAE,mBAAmB,CAAC;CAC9B,cAnBW,GAAG,eACE,MAAM,GAAG,MAAM,eACf,kBAAkB,KAC9B,IAoBJ,CAAC;AAEF,wFAAwF;AACxF,eAAO,MAAM,IAAI,GAAI,mBAAmB,SAAS,IAAI,CAAC,gBAAgB,EAAE,QAAQ,CAAC,EAAE,MAAM;IACvF,OAAO,EAAE,mBAAmB,CAAC;CAC9B,cA5BW,GAAG,eACE,MAAM,GAAG,MAAM,eACf,kBAAkB,KAC9B,IA6BJ,CAAC;AAEF,sFAAsF;AACtF,eAAO,MAAM,GAAG,GAAI,mBAAmB,SAAS,IAAI,CAAC,gBAAgB,EAAE,QAAQ,CAAC,EAAE,MAAM;IACtF,OAAO,EAAE,mBAAmB,CAAC;CAC9B,cArCW,GAAG,eACE,MAAM,GAAG,MAAM,eACf,kBAAkB,KAC9B,IAsCJ,CAAC;AAEF,0FAA0F;AAC1F,eAAO,MAAM,KAAK,GAAI,mBAAmB,SAAS,IAAI,CAAC,gBAAgB,EAAE,QAAQ,CAAC,EAAE,MAAM;IACxF,OAAO,EAAE,mBAAmB,CAAC;CAC9B,cA9CW,GAAG,eACE,MAAM,GAAG,MAAM,eACf,kBAAkB,KAC9B,IA+CJ,CAAC;AAEF,4FAA4F;AAC5F,eAAO,MAAM,GAAG,GAAI,mBAAmB,SAAS,IAAI,CAAC,gBAAgB,EAAE,QAAQ,CAAC,EAAE,MAAM;IACtF,OAAO,EAAE,mBAAmB,CAAC;CAC9B,cAvDW,GAAG,eACE,MAAM,GAAG,MAAM,eACf,kBAAkB,KAC9B,IAwDJ,CAAC"}

package/dist/esm/base/metadata/routes/rest.js

@@ -0,0 +1,47 @@
+import { MetadataRegistry } from '../../../helpers/inversion/index.js';
+import { HTTP } from '@venizia/ignis-helpers/common';
+import { DroppedRouteDecorators } from './common.js';
+/** Generic route decorator. Registers route config in metadata registry. */
+export const api = (opts) => {
+    return function (target, propertyKey, _descriptor) {
+        if (!DroppedRouteDecorators.isLegacyCall({ decorator: 'api', propertyKey })) {
+            return;
+        }
+        MetadataRegistry.getInstance().addRoute({
+            target,
+            methodName: propertyKey,
+            configs: opts.configs,
+        });
+    };
+};
+/** GET route decorator. Equivalent to @api but automatically sets method to 'get'. */
+export const get = (opts) => {
+    return api({
+        configs: { ...opts.configs, method: HTTP.Methods.GET },
+    });
+};
+/** POST route decorator. Equivalent to @api but automatically sets method to 'post'. */
+export const post = (opts) => {
+    return api({
+        configs: { ...opts.configs, method: HTTP.Methods.POST },
+    });
+};
+/** PUT route decorator. Equivalent to @api but automatically sets method to 'put'. */
+export const put = (opts) => {
+    return api({
+        configs: { ...opts.configs, method: HTTP.Methods.PUT },
+    });
+};
+/** PATCH route decorator. Equivalent to @api but automatically sets method to 'patch'. */
+export const patch = (opts) => {
+    return api({
+        configs: { ...opts.configs, method: HTTP.Methods.PATCH },
+    });
+};
+/** DELETE route decorator. Equivalent to @api but automatically sets method to 'delete'. */
+export const del = (opts) => {
+    return api({
+        configs: { ...opts.configs, method: HTTP.Methods.DELETE },
+    });
+};
+//# sourceMappingURL=rest.js.map

package/dist/esm/base/metadata/routes/rest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rest.js","sourceRoot":"","sources":["../../../../../src/base/metadata/routes/rest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,IAAI,EAAE,MAAM,+BAA+B,CAAC;AAErD,OAAO,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC;AAElD,4EAA4E;AAC5E,MAAM,CAAC,MAAM,GAAG,GAAG,CAA+C,IAEjE,EAAE,EAAE;IACH,OAAO,UACL,MAAW,EACX,WAA4B,EAC5B,WAA+B;QAE/B,IAAI,CAAC,sBAAsB,CAAC,YAAY,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC,EAAE,CAAC;YAC5E,OAAO;QACT,CAAC;QAED,gBAAgB,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC;YACtC,MAAM;YACN,UAAU,EAAE,WAAW;YACvB,OAAO,EAAE,IAAI,CAAC,OAAO;SACtB,CAAC,CAAC;IACL,CAAC,CAAC;AACJ,CAAC,CAAC;AAEF,sFAAsF;AACtF,MAAM,CAAC,MAAM,GAAG,GAAG,CAA+D,IAEjF,EAAE,EAAE;IACH,OAAO,GAAG,CAAC;QACT,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE;KACvD,CAAC,CAAC;AACL,CAAC,CAAC;AAEF,wFAAwF;AACxF,MAAM,CAAC,MAAM,IAAI,GAAG,CAA+D,IAElF,EAAE,EAAE;IACH,OAAO,GAAG,CAAC;QACT,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE;KACxD,CAAC,CAAC;AACL,CAAC,CAAC;AAEF,sFAAsF;AACtF,MAAM,CAAC,MAAM,GAAG,GAAG,CAA+D,IAEjF,EAAE,EAAE;IACH,OAAO,GAAG,CAAC;QACT,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE;KACvD,CAAC,CAAC;AACL,CAAC,CAAC;AAEF,0FAA0F;AAC1F,MAAM,CAAC,MAAM,KAAK,GAAG,CAA+D,IAEnF,EAAE,EAAE;IACH,OAAO,GAAG,CAAC;QACT,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE;KACzD,CAAC,CAAC;AACL,CAAC,CAAC;AAEF,4FAA4F;AAC5F,MAAM,CAAC,MAAM,GAAG,GAAG,CAA+D,IAEjF,EAAE,EAAE;IACH,OAAO,GAAG,CAAC;QACT,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE;KAC1D,CAAC,CAAC;AACL,CAAC,CAAC"}

package/dist/esm/base/metadata/routes/rpc.d.ts

@@ -0,0 +1,22 @@
+import type { IRpcMetadata } from '../../../helpers/inversion/common/types.js';
+/** Generic RPC decorator. Registers RPC config in metadata registry. */
+export declare const rpc: <RpcRouteConfigType extends IRpcMetadata>(opts: {
+    configs: RpcRouteConfigType;
+}) => (target: any, propertyKey: string | symbol, _descriptor: PropertyDescriptor) => void;
+/** Unary RPC decorator. Equivalent to @rpc but automatically sets method to 'unary'. */
+export declare const unary: <RpcRouteConfigType extends Omit<IRpcMetadata, "method">>(opts: {
+    configs: RpcRouteConfigType;
+}) => (target: any, propertyKey: string | symbol, _descriptor: PropertyDescriptor) => void;
+/** Server streaming RPC decorator. Equivalent to @rpc but automatically sets method to 'server_streaming'. */
+export declare const serverStream: <RpcRouteConfigType extends Omit<IRpcMetadata, "method">>(opts: {
+    configs: RpcRouteConfigType;
+}) => (target: any, propertyKey: string | symbol, _descriptor: PropertyDescriptor) => void;
+/** Client streaming RPC decorator. Equivalent to @rpc but automatically sets method to 'client_streaming'. */
+export declare const clientStream: <RpcRouteConfigType extends Omit<IRpcMetadata, "method">>(opts: {
+    configs: RpcRouteConfigType;
+}) => (target: any, propertyKey: string | symbol, _descriptor: PropertyDescriptor) => void;
+/** Bidirectional streaming RPC decorator. Equivalent to @rpc but automatically sets method to 'bidi_streaming'. */
+export declare const bidiStream: <RpcRouteConfigType extends Omit<IRpcMetadata, "method">>(opts: {
+    configs: RpcRouteConfigType;
+}) => (target: any, propertyKey: string | symbol, _descriptor: PropertyDescriptor) => void;
+//# sourceMappingURL=rpc.d.ts.map

package/dist/esm/base/metadata/routes/rpc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpc.d.ts","sourceRoot":"","sources":["../../../../../src/base/metadata/routes/rpc.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAKrE,wEAAwE;AACxE,eAAO,MAAM,GAAG,GAAI,kBAAkB,SAAS,YAAY,EAAE,MAAM;IACjE,OAAO,EAAE,kBAAkB,CAAC;CAC7B,MAEG,QAAQ,GAAG,EACX,aAAa,MAAM,GAAG,MAAM,EAC5B,aAAa,kBAAkB,KAC9B,IAWJ,CAAC;AAEF,wFAAwF;AACxF,eAAO,MAAM,KAAK,GAAI,kBAAkB,SAAS,IAAI,CAAC,YAAY,EAAE,QAAQ,CAAC,EAAE,MAAM;IACnF,OAAO,EAAE,kBAAkB,CAAC;CAC7B,cAnBW,GAAG,eACE,MAAM,GAAG,MAAM,eACf,kBAAkB,KAC9B,IAoBJ,CAAC;AAEF,8GAA8G;AAC9G,eAAO,MAAM,YAAY,GAAI,kBAAkB,SAAS,IAAI,CAAC,YAAY,EAAE,QAAQ,CAAC,EAAE,MAAM;IAC1F,OAAO,EAAE,kBAAkB,CAAC;CAC7B,cA5BW,GAAG,eACE,MAAM,GAAG,MAAM,eACf,kBAAkB,KAC9B,IA6BJ,CAAC;AAEF,8GAA8G;AAC9G,eAAO,MAAM,YAAY,GAAI,kBAAkB,SAAS,IAAI,CAAC,YAAY,EAAE,QAAQ,CAAC,EAAE,MAAM;IAC1F,OAAO,EAAE,kBAAkB,CAAC;CAC7B,cArCW,GAAG,eACE,MAAM,GAAG,MAAM,eACf,kBAAkB,KAC9B,IAsCJ,CAAC;AAEF,mHAAmH;AACnH,eAAO,MAAM,UAAU,GAAI,kBAAkB,SAAS,IAAI,CAAC,YAAY,EAAE,QAAQ,CAAC,EAAE,MAAM;IACxF,OAAO,EAAE,kBAAkB,CAAC;CAC7B,cA9CW,GAAG,eACE,MAAM,GAAG,MAAM,eACf,kBAAkB,KAC9B,IA+CJ,CAAC"}

package/dist/esm/base/metadata/routes/rpc.js

@@ -0,0 +1,41 @@
+import { MetadataRegistry } from '../../../helpers/inversion/registry.js';
+import { GRPC } from '@venizia/ignis-helpers/common';
+import { DroppedRouteDecorators } from './common.js';
+/** Generic RPC decorator. Registers RPC config in metadata registry. */
+export const rpc = (opts) => {
+    return function (target, propertyKey, _descriptor) {
+        if (!DroppedRouteDecorators.isLegacyCall({ decorator: 'rpc', propertyKey })) {
+            return;
+        }
+        MetadataRegistry.getInstance().addRpc({
+            target,
+            methodName: propertyKey,
+            configs: opts.configs,
+        });
+    };
+};
+/** Unary RPC decorator. Equivalent to @rpc but automatically sets method to 'unary'. */
+export const unary = (opts) => {
+    return rpc({
+        configs: { ...opts.configs, method: GRPC.Methods.UNARY },
+    });
+};
+/** Server streaming RPC decorator. Equivalent to @rpc but automatically sets method to 'server_streaming'. */
+export const serverStream = (opts) => {
+    return rpc({
+        configs: { ...opts.configs, method: GRPC.Methods.SERVER_STREAMING },
+    });
+};
+/** Client streaming RPC decorator. Equivalent to @rpc but automatically sets method to 'client_streaming'. */
+export const clientStream = (opts) => {
+    return rpc({
+        configs: { ...opts.configs, method: GRPC.Methods.CLIENT_STREAMING },
+    });
+};
+/** Bidirectional streaming RPC decorator. Equivalent to @rpc but automatically sets method to 'bidi_streaming'. */
+export const bidiStream = (opts) => {
+    return rpc({
+        configs: { ...opts.configs, method: GRPC.Methods.BIDI_STREAMING },
+    });
+};
+//# sourceMappingURL=rpc.js.map

package/dist/esm/base/metadata/routes/rpc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpc.js","sourceRoot":"","sources":["../../../../../src/base/metadata/routes/rpc.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAE,IAAI,EAAE,MAAM,+BAA+B,CAAC;AACrD,OAAO,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC;AAElD,wEAAwE;AACxE,MAAM,CAAC,MAAM,GAAG,GAAG,CAA0C,IAE5D,EAAE,EAAE;IACH,OAAO,UACL,MAAW,EACX,WAA4B,EAC5B,WAA+B;QAE/B,IAAI,CAAC,sBAAsB,CAAC,YAAY,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC,EAAE,CAAC;YAC5E,OAAO;QACT,CAAC;QAED,gBAAgB,CAAC,WAAW,EAAE,CAAC,MAAM,CAAC;YACpC,MAAM;YACN,UAAU,EAAE,WAAW;YACvB,OAAO,EAAE,IAAI,CAAC,OAAO;SACtB,CAAC,CAAC;IACL,CAAC,CAAC;AACJ,CAAC,CAAC;AAEF,wFAAwF;AACxF,MAAM,CAAC,MAAM,KAAK,GAAG,CAA0D,IAE9E,EAAE,EAAE;IACH,OAAO,GAAG,CAAC;QACT,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE;KACzD,CAAC,CAAC;AACL,CAAC,CAAC;AAEF,8GAA8G;AAC9G,MAAM,CAAC,MAAM,YAAY,GAAG,CAA0D,IAErF,EAAE,EAAE;IACH,OAAO,GAAG,CAAC;QACT,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,gBAAgB,EAAE;KACpE,CAAC,CAAC;AACL,CAAC,CAAC;AAEF,8GAA8G;AAC9G,MAAM,CAAC,MAAM,YAAY,GAAG,CAA0D,IAErF,EAAE,EAAE;IACH,OAAO,GAAG,CAAC;QACT,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,gBAAgB,EAAE;KACpE,CAAC,CAAC;AACL,CAAC,CAAC;AAEF,mHAAmH;AACnH,MAAM,CAAC,MAAM,UAAU,GAAG,CAA0D,IAEnF,EAAE,EAAE;IACH,OAAO,GAAG,CAAC;QACT,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE;KAClE,CAAC,CAAC;AACL,CAAC,CAAC"}

package/dist/esm/base/middlewares/app-error/app-error.middleware.d.ts

@@ -0,0 +1,76 @@
+import type { ILogger } from '@venizia/ignis-helpers/core';
+import { BaseHelper } from '@venizia/ignis-helpers/core';
+import type { IProvider } from '@venizia/ignis-inversion';
+import type { ErrorHandler } from 'hono/types';
+/** How a thrown error is rendered into the log line. Must never throw - a throw inside the error handler turns a handled failure into an unhandled one. */
+export type TErrorLogFormatter = (opts: {
+    error: unknown;
+    messageCode?: string;
+    extra?: Record<string, unknown>;
+    includeStack?: boolean;
+    maxStackFrames?: number;
+}) => string;
+/**
+ * Hono `onError`: ZodError -> 422, DB client error -> 400, retryable conflict -> 409, `getError` ->
+ * its own status, else 500. Browser-pure: the two reads that need a host - the ambient environment
+ * name and the error formatter - are constructor OPTIONS, not methods to subclass.
+ *
+ * They were hooks once, and three subclasses existed to answer them and nothing else. A class seam
+ * is also unreachable from application code, so the browser example had to fake the environment with
+ * a Hono middleware assigning `context.env`. `@venizia/ignis`'s `AppErrorMiddleware` now just
+ * supplies `process.env.NODE_ENV` and `ErrorPrettier` as options.
+ */
+export declare class BaseAppErrorMiddleware extends BaseHelper implements IProvider<ErrorHandler> {
+    private rootKey;
+    private intentionalStackFrames;
+    private unexpectedStackFrames;
+    /**
+     * How this host reads its ambient environment name, and the ONE option that says whether it has
+     * one at all: absent means it does not (a browser), so an unresolved name is by design; present
+     * but returning `undefined` means a host that should have one is misconfigured. Either way
+     * {@link isProduction} fails closed.
+     *
+     * A function, not a string: `process.env.NODE_ENV` has to be read per request, since a test - and
+     * a `--env-file` reload - can change it after the middleware is built.
+     */
+    private readonly environment?;
+    /** Replaces {@link renderErrorForLog} - `@venizia/ignis` passes `ErrorPrettier`, which reaches `node:util` and so cannot live here. */
+    private readonly formatErrorOverride?;
+    constructor(opts?: {
+        logger?: ILogger;
+        rootKey?: string;
+        intentionalStackFrames?: number;
+        unexpectedStackFrames?: number;
+        environment?: () => string | undefined;
+        formatError?: TErrorLogFormatter;
+    });
+    /** Renders a thrown error for the log, through the `formatError` option when one was given. */
+    protected formatError(opts: {
+        error: unknown;
+        messageCode?: string;
+        extra?: Record<string, unknown>;
+        includeStack?: boolean;
+        maxStackFrames?: number;
+    }): string;
+    /**
+     * The default log rendering: pure and deliberately small, so the whole middleware stays
+     * browser-pure.
+     *
+     * Must never throw, cycles included: a throw inside the error handler turns a handled failure
+     * into an unhandled one.
+     */
+    private renderErrorForLog;
+    private withRootKey;
+    /** Fail-closed: an unset or unrecognized env is production. */
+    private isProduction;
+    private classify;
+    /** An ApplicationError's `normalized` is authoritative - a `transform` may have reworded `text`. */
+    private build;
+    private resolve;
+    /** A throw site may set `logLevel` via `getError`; anything unset or malformed logs at `error`. */
+    private resolveLogLevel;
+    /** The one place a thrown error reaches the log - called once the status is known, so it carries it. */
+    private logError;
+    value(): ErrorHandler;
+}
+//# sourceMappingURL=app-error.middleware.d.ts.map

package/dist/esm/base/middlewares/app-error/app-error.middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-error.middleware.d.ts","sourceRoot":"","sources":["../../../../../src/base/middlewares/app-error/app-error.middleware.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAa,MAAM,6BAA6B,CAAC;AAEtE,OAAO,EAAE,UAAU,EAA4C,MAAM,6BAA6B,CAAC;AAEnG,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAE1D,OAAO,KAAK,EAAE,YAAY,EAAqB,MAAM,YAAY,CAAC;AAiBlE,2JAA2J;AAC3J,MAAM,MAAM,kBAAkB,GAAG,CAAC,IAAI,EAAE;IACtC,KAAK,EAAE,OAAO,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,KAAK,MAAM,CAAC;AA8Cb;;;;;;;;;GASG;AACH,qBAAa,sBAAuB,SAAQ,UAAW,YAAW,SAAS,CAAC,YAAY,CAAC;IACvF,OAAO,CAAC,OAAO,CAAoB;IACnC,OAAO,CAAC,sBAAsB,CAAS;IACvC,OAAO,CAAC,qBAAqB,CAAS;IAEtC;;;;;;;;OAQG;IACH,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAA2B;IAExD,uIAAuI;IACvI,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAC,CAAqB;gBAE9C,IAAI,CAAC,EAAE;QACjB,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,sBAAsB,CAAC,EAAE,MAAM,CAAC;QAChC,qBAAqB,CAAC,EAAE,MAAM,CAAC;QAC/B,WAAW,CAAC,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;QACvC,WAAW,CAAC,EAAE,kBAAkB,CAAC;KAClC;IAgBD,+FAA+F;IAC/F,SAAS,CAAC,WAAW,CAAC,IAAI,EAAE;QAC1B,KAAK,EAAE,OAAO,CAAC;QACf,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAChC,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,cAAc,CAAC,EAAE,MAAM,CAAC;KACzB,GAAG,MAAM;IAIV;;;;;;OAMG;IACH,OAAO,CAAC,iBAAiB;IAuCzB,OAAO,CAAC,WAAW;IAInB,+DAA+D;IAC/D,OAAO,CAAC,YAAY;IAgCpB,OAAO,CAAC,QAAQ;IAkBhB,oGAAoG;IACpG,OAAO,CAAC,KAAK;IAsBb,OAAO,CAAC,OAAO;IA+Cf,mGAAmG;IACnG,OAAO,CAAC,eAAe;IAUvB,wGAAwG;IACxG,OAAO,CAAC,QAAQ;IAgChB,KAAK,IAAI,YAAY;CAiDtB"}