@venizia/ignis-kernel 0.2.0-8 → 0.2.0

package/dist/esm/base/components/controller/rest/rest.component.js

@@ -1,10 +1,9 @@
-import { ControllerTransports } from '../../../../base/controllers/common/constants.js';
+import { ControllerTransports } from '../../../controllers/common/constants.js';
 import { BindingNamespaces } from '../../../../common/bindings.js';
 import { Binding, BindingValueTypes, MetadataRegistry } from '../../../../helpers/inversion/index.js';
 import { BaseComponent } from '../../base.js';
 import { getError } from '@venizia/ignis-helpers/core';
-import { HTTP } from '@venizia/ignis-helpers/common';
-import isEmpty from 'lodash/isEmpty';
+import { HTTP, isEmpty } from '@venizia/ignis-helpers/common';
 import { RestBindingKeys } from './common/types.js';
 const DEFAULT_OPTIONS = {};
 /**
@@ -30,29 +29,20 @@ export class RestComponent extends BaseComponent {
     async binding() {
         const logger = this.logger.for(this.binding.name);
         const router = this.application.getRootRouter();
-        const configured = new Set();
-        // Batch drained before re-scanning - see `RestApplication.registerDynamicBindings` for why.
-        let bindings = this.application.findByTag({
+        await this.application.drainByTag({
             tag: BindingNamespaces.CONTROLLER,
-            exclude: configured,
-        });
-        while (bindings.length > 0) {
-            for (const binding of bindings) {
-                if (configured.has(binding.key)) {
-                    continue;
-                }
+            configured: new Set(),
+            onEach: async ({ binding }) => {
                 const target = binding.getBindingMeta({ type: BindingValueTypes.CLASS });
                 if (!target) {
-                    configured.add(binding.key);
-                    continue;
+                    return;
                 }
                 const metadata = MetadataRegistry.getInstance().getControllerMetadata({ target });
                 // Skip gRPC controllers - they are configured by GrpcComponent
                 if (metadata?.transport === ControllerTransports.GRPC) {
-                    configured.add(binding.key);
-                    continue;
+                    return;
                 }
-                if (!metadata?.path || isEmpty(metadata.path)) {
+                if (!metadata?.path || isEmpty({ value: metadata.path })) {
                     throw getError({
                         statusCode: HTTP.ResultCodes.RS_5.InternalServerError,
                         message: `[registerControllers] key: '${binding.key}' | Invalid controller metadata, 'path' is required for controller metadata`,
@@ -64,20 +54,13 @@ export class RestComponent extends BaseComponent {
                 });
                 if (!instance) {
                     logger.debug('No binding instance | key: %s', binding.key);
-                    configured.add(binding.key);
-                    continue;
+                    return;
                 }
                 await instance.configure();
                 router.route(metadata.path, instance.getRouter());
-                configured.add(binding.key);
                 logger.info('Configured REST controller | key: %s | path: %s', binding.key, metadata.path);
-            }
-            // Re-fetch excluding already configured - picks up dynamically added controllers
-            bindings = this.application.findByTag({
-                tag: BindingNamespaces.CONTROLLER,
-                exclude: configured,
-            });
-        }
+            },
+        });
     }
 }
 //# sourceMappingURL=rest.component.js.map

package/dist/esm/base/components/controller/rest/rest.component.js.map

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

package/dist/esm/base/configurations/base.d.ts

@@ -0,0 +1,14 @@
+import type { IConfigurable, ValueOrPromise } from '@venizia/ignis-helpers/common';
+import { BaseHelper } from '@venizia/ignis-helpers/core';
+import type { IConfiguration } from './common/index.js';
+export declare abstract class BaseConfiguration<ConfigurableOptions extends object = {}> extends BaseHelper implements IConfiguration, IConfigurable<ConfigurableOptions> {
+    protected isConfigured: boolean;
+    constructor(opts?: {
+        scope?: string;
+        identifier?: string;
+    });
+    configure(opts?: ConfigurableOptions): Promise<void>;
+    /** Override to perform setup work when the configuration is booted. */
+    protected setup(_opts?: ConfigurableOptions): ValueOrPromise<void>;
+}
+//# sourceMappingURL=base.d.ts.map

package/dist/esm/base/configurations/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../../src/base/configurations/base.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AACnF,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE/C,8BAAsB,iBAAiB,CAAC,mBAAmB,SAAS,MAAM,GAAG,EAAE,CAC7E,SAAQ,UACR,YAAW,cAAc,EAAE,aAAa,CAAC,mBAAmB,CAAC;IAE7D,SAAS,CAAC,YAAY,UAAS;gBAEnB,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE;IAIpD,SAAS,CAAC,IAAI,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAS1D,uEAAuE;IACvE,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,mBAAmB,GAAG,cAAc,CAAC,IAAI,CAAC;CACnE"}

package/dist/esm/base/configurations/base.js

@@ -0,0 +1,17 @@
+import { BaseHelper } from '@venizia/ignis-helpers/core';
+export class BaseConfiguration extends BaseHelper {
+    constructor(opts) {
+        super({ scope: opts?.scope ?? BaseConfiguration.name, identifier: opts?.identifier });
+        this.isConfigured = false;
+    }
+    async configure(opts) {
+        if (this.isConfigured) {
+            return;
+        }
+        await this.setup(opts);
+        this.isConfigured = true;
+    }
+    /** Override to perform setup work when the configuration is booted. */
+    setup(_opts) { }
+}
+//# sourceMappingURL=base.js.map

package/dist/esm/base/configurations/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../../../src/base/configurations/base.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAGzD,MAAM,OAAgB,iBACpB,SAAQ,UAAU;IAKlB,YAAY,IAA8C;QACxD,KAAK,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,IAAI,iBAAiB,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC;QAH9E,iBAAY,GAAG,KAAK,CAAC;IAI/B,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,IAA0B;QACxC,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACtB,OAAO;QACT,CAAC;QAED,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACvB,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;IAC3B,CAAC;IAED,uEAAuE;IAC7D,KAAK,CAAC,KAA2B,IAAyB,CAAC;CACtE"}

package/dist/esm/base/configurations/common/index.d.ts

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

package/dist/esm/base/configurations/common/index.d.ts.map

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

package/dist/esm/base/configurations/common/index.js

@@ -0,0 +1,2 @@
+export * from './types.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/base/configurations/common/index.js.map

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

package/dist/esm/base/configurations/common/types.d.ts

@@ -0,0 +1,3 @@
+export interface IConfiguration {
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/esm/base/configurations/common/types.d.ts.map

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

package/dist/esm/base/configurations/common/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../src/base/configurations/common/types.ts"],"names":[],"mappings":""}

package/dist/esm/base/configurations/index.d.ts

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

package/dist/esm/base/configurations/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/base/configurations/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC"}

package/dist/esm/base/configurations/index.js

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

package/dist/esm/base/configurations/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/base/configurations/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC"}

package/dist/esm/base/controllers/common/constants.d.ts

@@ -1,32 +1,30 @@
-import { z } from '@hono/zod-openapi';
 import type { TConstValue } from '@venizia/ignis-helpers/common';
-import type { TResponseHeaders } from './types.js';
+import type { TResponseHeaders } from './types/index.js';
+/**
+ * Constants with NO zod import, deliberately. The container's controller mixin imports
+ * `ControllerTransports` from here, so anything this file pulls in reaches every consumer of
+ * `Container` - the request schemas live in `schemas.ts` for exactly that reason.
+ */
 /** Transport protocol constants for controllers. */
 export declare class ControllerTransports {
     static readonly REST = "rest";
     static readonly GRPC = "grpc";
 }
 export type TControllerTransport = TConstValue<typeof ControllerTransports>;
+/** Shape of `data` in a `{ count, data }` response, echoed in the `X-Response-Format` header. */
+export declare class ResponseFormats {
+    static readonly OBJECT = "object";
+    static readonly ARRAY = "array";
+    static readonly SCHEME_SET: Set<string>;
+    static isValid(value: string): boolean;
+}
+export type TResponseFormat = TConstValue<typeof ResponseFormats>;
 /** Standard REST API path constants for CRUD controllers. */
 export declare class RestPaths {
     static readonly ROOT = "/";
     static readonly COUNT = "/count";
     static readonly FIND_ONE = "/find-one";
 }
-export declare const trackableHeaders: z.ZodObject<{
-    "x-request-id": z.ZodOptional<z.ZodString>;
-    "x-request-channel": z.ZodOptional<z.ZodString>;
-    "x-device-info": z.ZodOptional<z.ZodString>;
-}, z.core.$strip>;
-export declare const countableHeaders: z.ZodObject<{
-    "x-request-count": z.ZodOptional<z.ZodString>;
-}, z.core.$strip>;
-export declare const defaultRequestHeaders: z.ZodObject<{
-    "x-request-id": z.ZodOptional<z.ZodString>;
-    "x-request-channel": z.ZodOptional<z.ZodString>;
-    "x-device-info": z.ZodOptional<z.ZodString>;
-    "x-request-count": z.ZodOptional<z.ZodString>;
-}, z.core.$strip>;
 export declare const commonResponseHeaders: TResponseHeaders;
 export declare const findResponseHeaders: TResponseHeaders;
 //# sourceMappingURL=constants.d.ts.map

package/dist/esm/base/controllers/common/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../../src/base/controllers/common/constants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,mBAAmB,CAAC;AACtC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAEjE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAEhD,oDAAoD;AACpD,qBAAa,oBAAoB;IAC/B,MAAM,CAAC,QAAQ,CAAC,IAAI,UAAU;IAC9B,MAAM,CAAC,QAAQ,CAAC,IAAI,UAAU;CAC/B;AAED,MAAM,MAAM,oBAAoB,GAAG,WAAW,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAE5E,6DAA6D;AAC7D,qBAAa,SAAS;IACpB,MAAM,CAAC,QAAQ,CAAC,IAAI,OAAO;IAC3B,MAAM,CAAC,QAAQ,CAAC,KAAK,YAAY;IACjC,MAAM,CAAC,QAAQ,CAAC,QAAQ,eAAe;CACxC;AAED,eAAO,MAAM,gBAAgB;;;;iBAkB3B,CAAC;AAEH,eAAO,MAAM,gBAAgB;;iBAS3B,CAAC;AAEH,eAAO,MAAM,qBAAqB;;;;;iBAAkD,CAAC;AAErF,eAAO,MAAM,qBAAqB,EAAE,gBAanC,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,gBAMjC,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../../src/base/controllers/common/constants.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAEjE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAEhD;;;;GAIG;AAEH,oDAAoD;AACpD,qBAAa,oBAAoB;IAC/B,MAAM,CAAC,QAAQ,CAAC,IAAI,UAAU;IAC9B,MAAM,CAAC,QAAQ,CAAC,IAAI,UAAU;CAC/B;AAED,MAAM,MAAM,oBAAoB,GAAG,WAAW,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAE5E,iGAAiG;AACjG,qBAAa,eAAe;IAC1B,MAAM,CAAC,QAAQ,CAAC,MAAM,YAAY;IAClC,MAAM,CAAC,QAAQ,CAAC,KAAK,WAAW;IAEhC,MAAM,CAAC,QAAQ,CAAC,UAAU,cAA8C;IAExE,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;CAGvC;AAED,MAAM,MAAM,eAAe,GAAG,WAAW,CAAC,OAAO,eAAe,CAAC,CAAC;AAElE,6DAA6D;AAC7D,qBAAa,SAAS;IACpB,MAAM,CAAC,QAAQ,CAAC,IAAI,OAAO;IAC3B,MAAM,CAAC,QAAQ,CAAC,KAAK,YAAY;IACjC,MAAM,CAAC,QAAQ,CAAC,QAAQ,eAAe;CACxC;AAED,eAAO,MAAM,qBAAqB,EAAE,gBAanC,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,gBAMjC,CAAC"}

package/dist/esm/base/controllers/common/constants.js

@@ -1,45 +1,29 @@
-import { z } from '@hono/zod-openapi';
 import { HTTP } from '@venizia/ignis-helpers/common';
+/**
+ * Constants with NO zod import, deliberately. The container's controller mixin imports
+ * `ControllerTransports` from here, so anything this file pulls in reaches every consumer of
+ * `Container` - the request schemas live in `schemas.ts` for exactly that reason.
+ */
 /** Transport protocol constants for controllers. */
 export class ControllerTransports {
     static { this.REST = 'rest'; }
     static { this.GRPC = 'grpc'; }
 }
+/** Shape of `data` in a `{ count, data }` response, echoed in the `X-Response-Format` header. */
+export class ResponseFormats {
+    static { this.OBJECT = 'object'; }
+    static { this.ARRAY = 'array'; }
+    static { this.SCHEME_SET = new Set([this.OBJECT, this.ARRAY]); }
+    static isValid(value) {
+        return this.SCHEME_SET.has(value);
+    }
+}
 /** Standard REST API path constants for CRUD controllers. */
 export class RestPaths {
     static { this.ROOT = '/'; }
     static { this.COUNT = '/count'; }
     static { this.FIND_ONE = '/find-one'; }
 }
-export const trackableHeaders = z.object({
-    [HTTP.Headers.REQUEST_TRACING_ID]: z.string().optional().openapi({
-        description: 'Optional request ID',
-    }),
-    [HTTP.Headers.REQUEST_CHANNEL]: z
-        .string()
-        .optional()
-        .openapi({
-        description: 'Optional request channel',
-        examples: ['channel-1', 'web', 'spos'],
-    }),
-    [HTTP.Headers.REQUEST_DEVICE_INFO]: z
-        .string()
-        .optional()
-        .openapi({
-        description: 'Optional request device info',
-        examples: ['dev-1', 'device-abc', 'd-unique-id'],
-    }),
-});
-export const countableHeaders = z.object({
-    [HTTP.Headers.REQUEST_COUNT_DATA]: z
-        .string()
-        .optional()
-        .openapi({
-        description: 'Controls response format. When "true" (default): returns {count, data}. When "false": returns data only.',
-        examples: ['true', '1', 'false', '0'],
-    }),
-});
-export const defaultRequestHeaders = trackableHeaders.extend(countableHeaders.shape);
 export const commonResponseHeaders = {
     [HTTP.Headers.REQUEST_TRACING_ID]: {
         description: 'Echo of the request tracing ID',

package/dist/esm/base/controllers/common/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../../src/base/controllers/common/constants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,mBAAmB,CAAC;AAEtC,OAAO,EAAE,IAAI,EAAE,MAAM,+BAA+B,CAAC;AAGrD,oDAAoD;AACpD,MAAM,OAAO,oBAAoB;aACf,SAAI,GAAG,MAAM,CAAC;aACd,SAAI,GAAG,MAAM,CAAC;;AAKhC,6DAA6D;AAC7D,MAAM,OAAO,SAAS;aACJ,SAAI,GAAG,GAAG,CAAC;aACX,UAAK,GAAG,QAAQ,CAAC;aACjB,aAAQ,GAAG,WAAW,CAAC;;AAGzC,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,CAAC,IAAI,CAAC,OAAO,CAAC,kBAAkB,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC;QAC/D,WAAW,EAAE,qBAAqB;KACnC,CAAC;IACF,CAAC,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,EAAE,CAAC;SAC9B,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,OAAO,CAAC;QACP,WAAW,EAAE,0BAA0B;QACvC,QAAQ,EAAE,CAAC,WAAW,EAAE,KAAK,EAAE,MAAM,CAAC;KACvC,CAAC;IACJ,CAAC,IAAI,CAAC,OAAO,CAAC,mBAAmB,CAAC,EAAE,CAAC;SAClC,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,OAAO,CAAC;QACP,WAAW,EAAE,8BAA8B;QAC3C,QAAQ,EAAE,CAAC,OAAO,EAAE,YAAY,EAAE,aAAa,CAAC;KACjD,CAAC;CACL,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,CAAC,IAAI,CAAC,OAAO,CAAC,kBAAkB,CAAC,EAAE,CAAC;SACjC,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,OAAO,CAAC;QACP,WAAW,EACT,0GAA0G;QAC5G,QAAQ,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,CAAC;KACtC,CAAC;CACL,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,qBAAqB,GAAG,gBAAgB,CAAC,MAAM,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC;AAErF,MAAM,CAAC,MAAM,qBAAqB,GAAqB;IACrD,CAAC,IAAI,CAAC,OAAO,CAAC,kBAAkB,CAAC,EAAE;QACjC,WAAW,EAAE,gCAAgC;QAC7C,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;KAC3B;IACD,CAAC,IAAI,CAAC,OAAO,CAAC,mBAAmB,CAAC,EAAE;QAClC,WAAW,EAAE,+BAA+B;QAC5C,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,KAAK,CAAC,EAAE;KACzD;IACD,CAAC,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,EAAE;QAC9B,WAAW,EAAE,2BAA2B;QACxC,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,OAAO,EAAE,QAAQ,CAAC,EAAE;KAC1D;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,mBAAmB,GAAqB;IACnD,GAAG,qBAAqB;IACxB,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE;QAC5B,WAAW,EAAE,yDAAyD;QACtE,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,kBAAkB,EAAE,mBAAmB,CAAC,EAAE;KAChF;CACF,CAAC"}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../../src/base/controllers/common/constants.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,+BAA+B,CAAC;AAGrD;;;;GAIG;AAEH,oDAAoD;AACpD,MAAM,OAAO,oBAAoB;aACf,SAAI,GAAG,MAAM,CAAC;aACd,SAAI,GAAG,MAAM,CAAC;;AAKhC,iGAAiG;AACjG,MAAM,OAAO,eAAe;aACV,WAAM,GAAG,QAAQ,CAAC;aAClB,UAAK,GAAG,OAAO,CAAC;aAEhB,eAAU,GAAG,IAAI,GAAG,CAAS,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IAExE,MAAM,CAAC,OAAO,CAAC,KAAa;QAC1B,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;;AAKH,6DAA6D;AAC7D,MAAM,OAAO,SAAS;aACJ,SAAI,GAAG,GAAG,CAAC;aACX,UAAK,GAAG,QAAQ,CAAC;aACjB,aAAQ,GAAG,WAAW,CAAC;;AAGzC,MAAM,CAAC,MAAM,qBAAqB,GAAqB;IACrD,CAAC,IAAI,CAAC,OAAO,CAAC,kBAAkB,CAAC,EAAE;QACjC,WAAW,EAAE,gCAAgC;QAC7C,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;KAC3B;IACD,CAAC,IAAI,CAAC,OAAO,CAAC,mBAAmB,CAAC,EAAE;QAClC,WAAW,EAAE,+BAA+B;QAC5C,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,KAAK,CAAC,EAAE;KACzD;IACD,CAAC,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,EAAE;QAC9B,WAAW,EAAE,2BAA2B;QACxC,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,OAAO,EAAE,QAAQ,CAAC,EAAE;KAC1D;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,mBAAmB,GAAqB;IACnD,GAAG,qBAAqB;IACxB,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE;QAC5B,WAAW,EAAE,yDAAyD;QACtE,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,kBAAkB,EAAE,mBAAmB,CAAC,EAAE;KAChF;CACF,CAAC"}

package/dist/esm/{utilities/jsx.utility.d.ts → base/controllers/common/html-response.d.ts}

@@ -17,16 +17,27 @@ export declare const htmlResponse: (opts: {
     description: string;
     required?: boolean;
 }) => {
-    200: {
+    '4XX': {
         description: string;
         content: {
-            'text/html': {
-                schema: z.ZodString;
+            'application/json': {
+                schema: z.ZodObject<{
+                    statusCode: z.ZodOptional<z.ZodNumber>;
+                    message: z.ZodString;
+                    normalized: z.ZodOptional<z.ZodObject<{
+                        text: z.ZodString;
+                        code: z.ZodString;
+                        args: z.ZodRecord<z.ZodString, z.ZodAny>;
+                    }, z.core.$strip>>;
+                    extra: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+                    requestId: z.ZodOptional<z.ZodString>;
+                    details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+                }, z.core.$strip>;
             };
         };
-        required: boolean;
+        required: boolean | undefined;
     };
-    "4xx | 5xx": {
+    '5XX': {
         description: string;
         content: {
             'application/json': {
@@ -44,6 +55,16 @@ export declare const htmlResponse: (opts: {
                 }, z.core.$strip>;
             };
         };
+        required: boolean | undefined;
+    };
+    200: {
+        description: string;
+        content: {
+            'text/html': {
+                schema: z.ZodString;
+            };
+        };
+        required: boolean;
     };
 };
-//# sourceMappingURL=jsx.utility.d.ts.map
+//# sourceMappingURL=html-response.d.ts.map

package/dist/esm/base/controllers/common/html-response.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"html-response.d.ts","sourceRoot":"","sources":["../../../../../src/base/controllers/common/html-response.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,mBAAmB,CAAC;AAGtC,oEAAoE;AACpE,eAAO,MAAM,WAAW,GAAI,MAAM;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE;;;;;;;;CAe5E,CAAC;AAEF,qEAAqE;AACrE,eAAO,MAAM,YAAY,GAAI,MAAM;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAQ7E,CAAC"}

package/dist/esm/{utilities/jsx.utility.js → base/controllers/common/html-response.js}

@@ -1,6 +1,6 @@
+import { errorResponses } from '../../models/common/index.js';
 import { z } from '@hono/zod-openapi';
 import { HTTP } from '@venizia/ignis-helpers/common';
-import { ErrorSchema } from '../base/models/common/types.js';
 /** Creates HTML content configuration for OpenAPI documentation. */
 export const htmlContent = (opts) => {
     const { description } = opts;
@@ -24,14 +24,7 @@ export const htmlResponse = (opts) => {
             description: opts.description,
             required: opts.required,
         }),
-        ['4xx | 5xx']: {
-            description: 'Error Response',
-            content: {
-                'application/json': {
-                    schema: ErrorSchema,
-                },
-            },
-        },
+        ...errorResponses(),
     };
 };
-//# sourceMappingURL=jsx.utility.js.map
+//# sourceMappingURL=html-response.js.map

package/dist/esm/base/controllers/common/html-response.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"html-response.js","sourceRoot":"","sources":["../../../../../src/base/controllers/common/html-response.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,CAAC,EAAE,MAAM,mBAAmB,CAAC;AACtC,OAAO,EAAE,IAAI,EAAE,MAAM,+BAA+B,CAAC;AAErD,oEAAoE;AACpE,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,IAAiD,EAAE,EAAE;IAC/E,MAAM,EAAE,WAAW,EAAE,GAAG,IAAI,CAAC;IAE7B,OAAO;QACL,WAAW;QACX,OAAO,EAAE;YACP,WAAW,EAAE;gBACX,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC;oBACzB,WAAW,EAAE,cAAc;oBAC3B,OAAO,EAAE,8EAA8E;iBACxF,CAAC;aACH;SACF;QACD,QAAQ,EAAE,IAAI,EAAE,QAAQ,IAAI,KAAK;KAClC,CAAC;AACJ,CAAC,CAAC;AAEF,qEAAqE;AACrE,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,IAAiD,EAAE,EAAE;IAChF,OAAO;QACL,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,WAAW,CAAC;YACtC,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,QAAQ,EAAE,IAAI,CAAC,QAAQ;SACxB,CAAC;QACF,GAAG,cAAc,EAAE;KACpB,CAAC;AACJ,CAAC,CAAC"}

package/dist/esm/base/controllers/common/index.d.ts

@@ -1,3 +1,6 @@
 export * from './constants.js';
-export * from './types.js';
+export * from './schemas.js';
+export * from './html-response.js';
+export * from './schema-builders.js';
+export * from './types/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/esm/base/controllers/common/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/base/controllers/common/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/base/controllers/common/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAE5B,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,SAAS,CAAC"}

package/dist/esm/base/controllers/common/index.js

@@ -1,3 +1,7 @@
 export * from './constants.js';
-export * from './types.js';
+// Carries zod. Kept out of `constants.ts` so importing `Container` does not pull zod into a bundle.
+export * from './schemas.js';
+export * from './html-response.js';
+export * from './schema-builders.js';
+export * from './types/index.js';
 //# sourceMappingURL=index.js.map

package/dist/esm/base/controllers/common/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/base/controllers/common/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/base/controllers/common/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,oGAAoG;AACpG,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,SAAS,CAAC"}

package/dist/esm/{utilities/schema.utility.d.ts → base/controllers/common/schema-builders.d.ts}

@@ -6,5 +6,5 @@ export declare const requiredString: (opts?: {
 }) => z.ZodString;
 export declare const AnyObjectSchema: z.ZodObject<{}, z.core.$catchall<z.ZodAny>>;
 export type TAnyObjectSchema = z.ZodObject<z.ZodRawShape>;
-export type TInferSchema<T extends z.ZodTypeAny> = z.infer<T>;
-//# sourceMappingURL=schema.utility.d.ts.map
+export type TInferSchema<T extends z.ZodType> = z.infer<T>;
+//# sourceMappingURL=schema-builders.d.ts.map

package/dist/esm/base/controllers/common/schema-builders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-builders.d.ts","sourceRoot":"","sources":["../../../../../src/base/controllers/common/schema-builders.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,mBAAmB,CAAC;AAEtC,eAAO,MAAM,cAAc,GAAI,OAAO;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,gBAiBnF,CAAC;AAEF,eAAO,MAAM,eAAe,6CAE1B,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;AAC1D,MAAM,MAAM,YAAY,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC"}

package/dist/esm/{utilities/schema.utility.js → base/controllers/common/schema-builders.js}

@@ -16,4 +16,4 @@ export const requiredString = (opts) => {
 export const AnyObjectSchema = z.object().catchall(z.any()).openapi({
     description: 'Unknown schema',
 });
-//# sourceMappingURL=schema.utility.js.map
+//# sourceMappingURL=schema-builders.js.map

package/dist/esm/base/controllers/common/schema-builders.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-builders.js","sourceRoot":"","sources":["../../../../../src/base/controllers/common/schema-builders.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,mBAAmB,CAAC;AAEtC,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,IAAqD,EAAE,EAAE;IACtF,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,IAAI,IAAI,EAAE,CAAC;IACvC,IAAI,EAAE,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC;IAE/B,IAAI,GAAG,EAAE,CAAC;QACR,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACnB,CAAC;IAED,IAAI,GAAG,EAAE,CAAC;QACR,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACnB,CAAC;IAED,IAAI,KAAK,EAAE,CAAC;QACV,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACxB,CAAC;IAED,OAAO,EAAE,CAAC;AACZ,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,OAAO,CAAC;IAClE,WAAW,EAAE,gBAAgB;CAC9B,CAAC,CAAC"}

package/dist/esm/base/controllers/common/schemas.d.ts

@@ -0,0 +1,22 @@
+import { z } from '@hono/zod-openapi';
+/**
+ * The zod-backed request schemas, kept apart from `constants.ts` ON PURPOSE. `z.object()` runs at
+ * module load, so any bundle reaching this file carries the whole of zod. While these lived beside
+ * `ControllerTransports`, which the container's controller mixin imports, importing `Container`
+ * alone cost 437 KB - 423 KB of it zod - for a four-line const class.
+ */
+export declare const trackableHeaders: z.ZodObject<{
+    "x-request-id": z.ZodOptional<z.ZodString>;
+    "x-request-channel": z.ZodOptional<z.ZodString>;
+    "x-device-info": z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const countableHeaders: z.ZodObject<{
+    "x-request-count": z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const defaultRequestHeaders: z.ZodObject<{
+    "x-request-id": z.ZodOptional<z.ZodString>;
+    "x-request-channel": z.ZodOptional<z.ZodString>;
+    "x-device-info": z.ZodOptional<z.ZodString>;
+    "x-request-count": z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+//# sourceMappingURL=schemas.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../../../src/base/controllers/common/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,mBAAmB,CAAC;AAGtC;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB;;;;iBAkB3B,CAAC;AAEH,eAAO,MAAM,gBAAgB;;iBAS3B,CAAC;AAEH,eAAO,MAAM,qBAAqB;;;;;iBAAkD,CAAC"}

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

@@ -0,0 +1,38 @@
+import { z } from '@hono/zod-openapi';
+import { HTTP } from '@venizia/ignis-helpers/common';
+/**
+ * The zod-backed request schemas, kept apart from `constants.ts` ON PURPOSE. `z.object()` runs at
+ * module load, so any bundle reaching this file carries the whole of zod. While these lived beside
+ * `ControllerTransports`, which the container's controller mixin imports, importing `Container`
+ * alone cost 437 KB - 423 KB of it zod - for a four-line const class.
+ */
+export const trackableHeaders = z.object({
+    [HTTP.Headers.REQUEST_TRACING_ID]: z.string().optional().openapi({
+        description: 'Optional request ID',
+    }),
+    [HTTP.Headers.REQUEST_CHANNEL]: z
+        .string()
+        .optional()
+        .openapi({
+        description: 'Optional request channel',
+        examples: ['channel-1', 'web', 'spos'],
+    }),
+    [HTTP.Headers.REQUEST_DEVICE_INFO]: z
+        .string()
+        .optional()
+        .openapi({
+        description: 'Optional request device info',
+        examples: ['dev-1', 'device-abc', 'd-unique-id'],
+    }),
+});
+export const countableHeaders = z.object({
+    [HTTP.Headers.REQUEST_COUNT_DATA]: z
+        .string()
+        .optional()
+        .openapi({
+        description: 'Controls response format. When "true" (default): returns {count, data}. When "false": returns data only.',
+        examples: ['true', '1', 'false', '0'],
+    }),
+});
+export const defaultRequestHeaders = trackableHeaders.extend(countableHeaders.shape);
+//# sourceMappingURL=schemas.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../../../../src/base/controllers/common/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,mBAAmB,CAAC;AACtC,OAAO,EAAE,IAAI,EAAE,MAAM,+BAA+B,CAAC;AAErD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,CAAC,IAAI,CAAC,OAAO,CAAC,kBAAkB,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC;QAC/D,WAAW,EAAE,qBAAqB;KACnC,CAAC;IACF,CAAC,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,EAAE,CAAC;SAC9B,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,OAAO,CAAC;QACP,WAAW,EAAE,0BAA0B;QACvC,QAAQ,EAAE,CAAC,WAAW,EAAE,KAAK,EAAE,MAAM,CAAC;KACvC,CAAC;IACJ,CAAC,IAAI,CAAC,OAAO,CAAC,mBAAmB,CAAC,EAAE,CAAC;SAClC,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,OAAO,CAAC;QACP,WAAW,EAAE,8BAA8B;QAC3C,QAAQ,EAAE,CAAC,OAAO,EAAE,YAAY,EAAE,aAAa,CAAC;KACjD,CAAC;CACL,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,CAAC,IAAI,CAAC,OAAO,CAAC,kBAAkB,CAAC,EAAE,CAAC;SACjC,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,OAAO,CAAC;QACP,WAAW,EACT,0GAA0G;QAC5G,QAAQ,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,CAAC;KACtC,CAAC;CACL,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,qBAAqB,GAAG,gBAAgB,CAAC,MAAM,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC"}

package/dist/esm/base/controllers/common/types/context.d.ts

@@ -0,0 +1,29 @@
+import type { ValueOrPromise } from '@venizia/ignis-helpers/common';
+import type { Context, Env, TypedResponse } from 'hono';
+import type { ContentfulStatusCode, StatusCode } from 'hono/utils/http-status';
+/** Typed validation results for route handlers. */
+export interface IValidRequestProps<JsonType = unknown, QueryType = unknown, ParamType = unknown, HeaderType = unknown, CookieType = unknown, FormType = unknown> {
+    json?: JsonType;
+    query?: QueryType;
+    param?: ParamType;
+    header?: HeaderType;
+    cookie?: CookieType;
+    form?: FormType;
+}
+export type TJsonResponse<ResponseBody = unknown, ResponseStatusCode extends StatusCode = StatusCode> = Response & TypedResponse<ResponseBody, ResponseStatusCode, 'json'>;
+/** Polymorphic response body for endpoints honoring the `x-request-count-data` header - the count-wrapped `{ count, data }` or the raw payload; pass the unwrapped payload type as `T`. */
+export type TCountResponse<TData = unknown> = TData | {
+    count: number;
+    data: TData;
+};
+/** Lightweight typed context that bypasses RouteHandler inference. */
+export type TContext<RouteEnv extends Env = Env, ValidTargetKey extends string = string, ResponseBody = unknown> = Omit<Context<RouteEnv>, 'req' | 'json'> & {
+    req: Omit<Context<RouteEnv>['req'], 'valid'> & {
+        valid<T = unknown>(target: ValidTargetKey): T;
+    };
+    json<TStatusCode extends ContentfulStatusCode = 200>(body: ResponseBody, status?: TStatusCode): TJsonResponse<ResponseBody, TStatusCode>;
+};
+export type TRouteContext<RouteEnv extends Env = Env, ResponseBody = unknown> = TContext<RouteEnv, keyof IValidRequestProps, ResponseBody>;
+/** Lightweight handler type using TTypedContext to avoid heavy RouteHandler inference. */
+export type TRouteHandler<ResponseType = unknown, RouteEnv extends Env = Env> = (context: TRouteContext<RouteEnv, ResponseType>) => ValueOrPromise<Response | TypedResponse<ResponseType>>;
+//# sourceMappingURL=context.d.ts.map

package/dist/esm/base/controllers/common/types/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../../../../src/base/controllers/common/types/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,aAAa,EAAE,MAAM,MAAM,CAAC;AACxD,OAAO,KAAK,EAAE,oBAAoB,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAE/E,mDAAmD;AACnD,MAAM,WAAW,kBAAkB,CACjC,QAAQ,GAAG,OAAO,EAClB,SAAS,GAAG,OAAO,EACnB,SAAS,GAAG,OAAO,EACnB,UAAU,GAAG,OAAO,EACpB,UAAU,GAAG,OAAO,EACpB,QAAQ,GAAG,OAAO;IAElB,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,IAAI,CAAC,EAAE,QAAQ,CAAC;CACjB;AAED,MAAM,MAAM,aAAa,CACvB,YAAY,GAAG,OAAO,EACtB,kBAAkB,SAAS,UAAU,GAAG,UAAU,IAChD,QAAQ,GAAG,aAAa,CAAC,YAAY,EAAE,kBAAkB,EAAE,MAAM,CAAC,CAAC;AAEvE,2LAA2L;AAC3L,MAAM,MAAM,cAAc,CAAC,KAAK,GAAG,OAAO,IAAI,KAAK,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,KAAK,CAAA;CAAE,CAAC;AAErF,sEAAsE;AACtE,MAAM,MAAM,QAAQ,CAClB,QAAQ,SAAS,GAAG,GAAG,GAAG,EAC1B,cAAc,SAAS,MAAM,GAAG,MAAM,EACtC,YAAY,GAAG,OAAO,IACpB,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC,GAAG;IAC5C,GAAG,EAAE,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,GAAG;QAAE,KAAK,CAAC,CAAC,GAAG,OAAO,EAAE,MAAM,EAAE,cAAc,GAAG,CAAC,CAAA;KAAE,CAAC;IACjG,IAAI,CAAC,WAAW,SAAS,oBAAoB,GAAG,GAAG,EACjD,IAAI,EAAE,YAAY,EAClB,MAAM,CAAC,EAAE,WAAW,GACnB,aAAa,CAAC,YAAY,EAAE,WAAW,CAAC,CAAC;CAC7C,CAAC;AAEF,MAAM,MAAM,aAAa,CAAC,QAAQ,SAAS,GAAG,GAAG,GAAG,EAAE,YAAY,GAAG,OAAO,IAAI,QAAQ,CACtF,QAAQ,EACR,MAAM,kBAAkB,EACxB,YAAY,CACb,CAAC;AAEF,0FAA0F;AAC1F,MAAM,MAAM,aAAa,CAAC,YAAY,GAAG,OAAO,EAAE,QAAQ,SAAS,GAAG,GAAG,GAAG,IAAI,CAC9E,OAAO,EAAE,aAAa,CAAC,QAAQ,EAAE,YAAY,CAAC,KAC3C,cAAc,CAAC,QAAQ,GAAG,aAAa,CAAC,YAAY,CAAC,CAAC,CAAC"}

package/dist/esm/base/controllers/common/types/context.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=context.js.map

package/dist/esm/base/controllers/common/types/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../../../../../src/base/controllers/common/types/context.ts"],"names":[],"mappings":""}