@venizia/ignis 0.4.3 → 0.4.4

package/dist/esm/components/controller/grpc/grpc.component.js

@@ -0,0 +1,87 @@
+import { BaseComponent } from '@venizia/ignis-kernel';
+import { ControllerTransports } from '@venizia/ignis-kernel';
+import { BindingNamespaces } from '@venizia/ignis-kernel';
+import { Binding, BindingValueTypes, MetadataRegistry } from '@venizia/ignis-kernel';
+import { getError } from '@venizia/ignis-helpers/core';
+import { HTTP, isEmpty } from '@venizia/ignis-helpers/common';
+import { GrpcBindingKeys } from './common/types.js';
+const DEFAULT_OPTIONS = {};
+export class GrpcComponent extends BaseComponent {
+    constructor(application) {
+        super({
+            scope: GrpcComponent.name,
+            initDefault: { enable: true, container: application },
+            bindings: {
+                [GrpcBindingKeys.GRPC_COMPONENT_OPTIONS]: Binding.bind({
+                    key: GrpcBindingKeys.GRPC_COMPONENT_OPTIONS,
+                }).toValue(DEFAULT_OPTIONS),
+            },
+        });
+        this.application = application;
+    }
+    async binding() {
+        const logger = this.logger.for(this.binding.name);
+        const router = this.application.getRootRouter();
+        const options = this.application.get({
+            key: GrpcBindingKeys.GRPC_COMPONENT_OPTIONS,
+            isOptional: true,
+        });
+        // Batch drained before re-scanning - see `RestApplication.registerDynamicBindings` for why.
+        const configured = new Set();
+        let bindings = this.application.findByTag({
+            tag: BindingNamespaces.CONTROLLER,
+            exclude: configured,
+        });
+        while (bindings.length > 0) {
+            for (const binding of bindings) {
+                if (configured.has(binding.key)) {
+                    continue;
+                }
+                const target = binding.getBindingMeta({ type: BindingValueTypes.CLASS });
+                if (!target) {
+                    configured.add(binding.key);
+                    continue;
+                }
+                const metadata = MetadataRegistry.getInstance().getControllerMetadata({ target });
+                // Skip non-gRPC controllers — they are configured by RestComponent
+                if (metadata?.transport !== ControllerTransports.GRPC) {
+                    configured.add(binding.key);
+                    continue;
+                }
+                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 gRPC controller metadata`,
+                    });
+                }
+                const instance = this.application.get({
+                    key: binding.key,
+                    isOptional: false,
+                });
+                if (!instance) {
+                    logger.debug('No binding instance | key: %s', binding.key);
+                    configured.add(binding.key);
+                    continue;
+                }
+                if (!instance.service) {
+                    logger.warn('gRPC controller has no service definition, skipping | key: %s', binding.key);
+                    configured.add(binding.key);
+                    continue;
+                }
+                instance.basePath = this.application.getProjectConfigs().path.base;
+                instance.connectRpcModule = options?.module;
+                instance.interceptors = options?.interceptors;
+                await instance.configure();
+                router.route(metadata.path, instance.getRouter());
+                configured.add(binding.key);
+                logger.info('Configured gRPC 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=grpc.component.js.map

package/dist/esm/components/controller/grpc/grpc.component.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"grpc.component.js","sourceRoot":"","sources":["../../../../../src/components/controller/grpc/grpc.component.ts"],"names":[],"mappings":"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","sourcesContent":["import type { BaseApplication } from '@/base/applications';\nimport { BaseComponent } from '@venizia/ignis-kernel';\nimport { ControllerTransports } from '@venizia/ignis-kernel';\nimport type { AbstractGrpcController } from '@/base/controllers/grpc';\nimport { BindingNamespaces } from '@venizia/ignis-kernel';\nimport { Binding, BindingValueTypes, MetadataRegistry } from '@venizia/ignis-kernel';\nimport { getError } from '@venizia/ignis-helpers/core';\nimport { HTTP, isEmpty } from '@venizia/ignis-helpers/common';\nimport type { IGrpcComponentConfig } from './common/types';\nimport { GrpcBindingKeys } from './common/types';\n\nconst DEFAULT_OPTIONS: IGrpcComponentConfig = {};\n\nexport class GrpcComponent extends BaseComponent {\n  constructor(private application: BaseApplication) {\n    super({\n      scope: GrpcComponent.name,\n      initDefault: { enable: true, container: application },\n      bindings: {\n        [GrpcBindingKeys.GRPC_COMPONENT_OPTIONS]: Binding.bind<IGrpcComponentConfig>({\n          key: GrpcBindingKeys.GRPC_COMPONENT_OPTIONS,\n        }).toValue(DEFAULT_OPTIONS),\n      },\n    });\n  }\n\n  override async binding(): Promise<void> {\n    const logger = this.logger.for(this.binding.name);\n    const router = this.application.getRootRouter();\n\n    const options = this.application.get<IGrpcComponentConfig>({\n      key: GrpcBindingKeys.GRPC_COMPONENT_OPTIONS,\n      isOptional: true,\n    });\n\n    // Batch drained before re-scanning - see `RestApplication.registerDynamicBindings` for why.\n    const configured = new Set<string>();\n\n    let bindings = this.application.findByTag({\n      tag: BindingNamespaces.CONTROLLER,\n      exclude: configured,\n    });\n\n    while (bindings.length > 0) {\n      for (const binding of bindings) {\n        if (configured.has(binding.key)) {\n          continue;\n        }\n\n        const target = binding.getBindingMeta({ type: BindingValueTypes.CLASS });\n        if (!target) {\n          configured.add(binding.key);\n          continue;\n        }\n\n        const metadata = MetadataRegistry.getInstance().getControllerMetadata({ target });\n\n        // Skip non-gRPC controllers — they are configured by RestComponent\n        if (metadata?.transport !== ControllerTransports.GRPC) {\n          configured.add(binding.key);\n          continue;\n        }\n\n        if (!metadata?.path || isEmpty({ value: metadata.path })) {\n          throw getError({\n            statusCode: HTTP.ResultCodes.RS_5.InternalServerError,\n            message: `[registerControllers] key: '${binding.key}' | Invalid controller metadata, 'path' is required for gRPC controller metadata`,\n          });\n        }\n\n        const instance = this.application.get<AbstractGrpcController>({\n          key: binding.key,\n          isOptional: false,\n        });\n\n        if (!instance) {\n          logger.debug('No binding instance | key: %s', binding.key);\n          configured.add(binding.key);\n          continue;\n        }\n\n        if (!instance.service) {\n          logger.warn('gRPC controller has no service definition, skipping | key: %s', binding.key);\n          configured.add(binding.key);\n          continue;\n        }\n\n        instance.basePath = this.application.getProjectConfigs().path.base;\n        instance.connectRpcModule = options?.module;\n        instance.interceptors = options?.interceptors;\n        await instance.configure();\n\n        router.route(metadata.path, instance.getRouter());\n        configured.add(binding.key);\n\n        logger.info('Configured gRPC controller | key: %s | path: %s', binding.key, metadata.path);\n      }\n\n      // Re-fetch excluding already configured — picks up dynamically added controllers\n      bindings = this.application.findByTag({\n        tag: BindingNamespaces.CONTROLLER,\n        exclude: configured,\n      });\n    }\n  }\n}\n"]}

package/dist/esm/components/controller/grpc/index.d.ts

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

package/dist/esm/components/controller/grpc/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/components/controller/grpc/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,kBAAkB,CAAC"}

package/dist/esm/components/controller/grpc/index.js

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

package/dist/esm/components/controller/grpc/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/components/controller/grpc/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,kBAAkB,CAAC","sourcesContent":["export * from './common';\nexport * from './grpc.component';\n"]}

package/dist/esm/components/controller/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/controller/index.ts"],"names":[],"mappings":""}

package/dist/esm/components/controller/index.js

@@ -0,0 +1,7 @@
+export {};
+// `RestComponent` moved to `@venizia/ignis-kernel` - `RestApplication` owns REST controller
+// registration by inheritance now. This package's own `@/index` re-export of the kernel barrel
+// still surfaces it publicly.
+// gRPC excluded from this barrel - import directly from the subpath.
+// export * from './grpc/index.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/components/controller/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/components/controller/index.ts"],"names":[],"mappings":";AAAA,4FAA4F;AAC5F,+FAA+F;AAC/F,8BAA8B;AAC9B,qEAAqE;AACrE,0BAA0B","sourcesContent":["// `RestComponent` moved to `@venizia/ignis-kernel` - `RestApplication` owns REST controller\n// registration by inheritance now. This package's own `@/index` re-export of the kernel barrel\n// still surfaces it publicly.\n// gRPC excluded from this barrel - import directly from the subpath.\n// export * from './grpc';\n"]}

package/dist/esm/components/health-check/common/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../../src/components/health-check/common/constants.ts"],"names":[],"mappings":"AAAA,qBAAa,kBAAkB;IAC7B,mGAAmG;IACnG,MAAM,CAAC,QAAQ,CAAC,UAAU,kBAAkB;CAC7C"}

package/dist/esm/components/health-check/common/constants.js

@@ -0,0 +1,5 @@
+export class HealthCheckHeaders {
+    /** Where a gated stats request carries its key; lowercase because Hono normalises header names. */
+    static { this.SECRET_KEY = 'x-health-key'; }
+}
+//# sourceMappingURL=constants.js.map

package/dist/esm/components/health-check/common/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../../src/components/health-check/common/constants.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,kBAAkB;IAC7B,mGAAmG;aACnF,eAAU,GAAG,cAAc,CAAC","sourcesContent":["export class HealthCheckHeaders {\n  /** Where a gated stats request carries its key; lowercase because Hono normalises header names. */\n  static readonly SECRET_KEY = 'x-health-key';\n}\n"]}

package/dist/esm/components/health-check/common/index.d.ts

@@ -0,0 +1,5 @@
+export * from './constants.js';
+export * from './keys.js';
+export * from './rest-paths.js';
+export * from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/components/health-check/common/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/components/health-check/common/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,QAAQ,CAAC;AACvB,cAAc,cAAc,CAAC;AAC7B,cAAc,SAAS,CAAC"}

package/dist/esm/components/health-check/common/index.js

@@ -0,0 +1,5 @@
+export * from './constants.js';
+export * from './keys.js';
+export * from './rest-paths.js';
+export * from './types.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/components/health-check/common/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/components/health-check/common/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,QAAQ,CAAC;AACvB,cAAc,cAAc,CAAC;AAC7B,cAAc,SAAS,CAAC","sourcesContent":["export * from './constants';\nexport * from './keys';\nexport * from './rest-paths';\nexport * from './types';\n"]}

package/dist/esm/components/health-check/common/keys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keys.d.ts","sourceRoot":"","sources":["../../../../../src/components/health-check/common/keys.ts"],"names":[],"mappings":"AAAA,qBAAa,sBAAsB;IACjC,MAAM,CAAC,QAAQ,CAAC,oBAAoB,+BAA+B;IACnE,wGAAwG;IACxG,MAAM,CAAC,QAAQ,CAAC,gBAAgB,wCAAwC;CACzE"}

package/dist/esm/components/health-check/common/keys.js

@@ -0,0 +1,6 @@
+export class HealthCheckBindingKeys {
+    static { this.HEALTH_CHECK_OPTIONS = '@app/health-check/options'; }
+    /** The component resolves `getAppInfo()` once (it is async) and binds the result for the controller. */
+    static { this.APPLICATION_INFO = '@app/health-check/application-info'; }
+}
+//# sourceMappingURL=keys.js.map

package/dist/esm/components/health-check/common/keys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keys.js","sourceRoot":"","sources":["../../../../../src/components/health-check/common/keys.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,sBAAsB;aACjB,yBAAoB,GAAG,2BAA2B,CAAC;IACnE,wGAAwG;aACxF,qBAAgB,GAAG,oCAAoC,CAAC","sourcesContent":["export class HealthCheckBindingKeys {\n  static readonly HEALTH_CHECK_OPTIONS = '@app/health-check/options';\n  /** The component resolves `getAppInfo()` once (it is async) and binds the result for the controller. */\n  static readonly APPLICATION_INFO = '@app/health-check/application-info';\n}\n"]}

package/dist/esm/components/health-check/common/rest-paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rest-paths.d.ts","sourceRoot":"","sources":["../../../../../src/components/health-check/common/rest-paths.ts"],"names":[],"mappings":"AAAA,qBAAa,oBAAoB;IAC/B,MAAM,CAAC,QAAQ,CAAC,IAAI,OAAO;IAC3B,MAAM,CAAC,QAAQ,CAAC,IAAI,WAAW;IAC/B,MAAM,CAAC,QAAQ,CAAC,KAAK,YAAY;CAClC"}

package/dist/esm/components/health-check/common/rest-paths.js

@@ -0,0 +1,6 @@
+export class HealthCheckRestPaths {
+    static { this.ROOT = '/'; }
+    static { this.PING = '/ping'; }
+    static { this.STATS = '/stats'; }
+}
+//# sourceMappingURL=rest-paths.js.map

package/dist/esm/components/health-check/common/rest-paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rest-paths.js","sourceRoot":"","sources":["../../../../../src/components/health-check/common/rest-paths.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,oBAAoB;aACf,SAAI,GAAG,GAAG,CAAC;aACX,SAAI,GAAG,OAAO,CAAC;aACf,UAAK,GAAG,QAAQ,CAAC","sourcesContent":["export class HealthCheckRestPaths {\n  static readonly ROOT = '/';\n  static readonly PING = '/ping';\n  static readonly STATS = '/stats';\n}\n"]}

package/dist/esm/components/health-check/common/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/components/health-check/common/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAE9D,MAAM,WAAW,mBAAmB;IAClC,6FAA6F;IAC7F,WAAW,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAChC;;;;OAIG;IACH,KAAK,CAAC,EAAE;QACN;;;;WAIG;QACH,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB;;;;WAIG;QACH,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,4FAA4F;QAC5F,SAAS,CAAC,EAAE,UAAU,CAAC;KACxB,CAAC;CACH"}

package/dist/esm/components/health-check/common/types.js

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

package/dist/esm/components/health-check/common/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../src/components/health-check/common/types.ts"],"names":[],"mappings":"","sourcesContent":["import type { IBuildInfo } from '@venizia/ignis-helpers/core';\n\nexport interface IHealthCheckOptions {\n  /** Partially-filled bindings are accepted; every missing field falls back to its default. */\n  restOptions?: { path?: string };\n  /**\n   * `GET <path>/stats`: build stamp, process and memory. The runtime and version it reports are\n   * exactly what an attacker needs to pick an exploit, so the default is CLOSED on every host that\n   * is not provably a development one.\n   */\n  stats?: {\n    /**\n     * Default: open only when `NODE_ENV` names a development environment\n     * (`Environment.DEVELOPMENT_ENVS`). `staging`, `uat`, `production`, an unrecognised name and an\n     * unset `NODE_ENV` all keep the route closed.\n     */\n    enable?: boolean;\n    /**\n     * When set, the route answers only for a request carrying this value in `X-Health-Key`, and a\n     * refusal is indistinguishable from an unmounted route. A blank value fails closed.\n     * Without the field the route is open to anything that can reach the port.\n     */\n    secretKey?: string;\n    /** Wins over {@link BuildInfoRegistry}; a host that stamps its own build passes it here. */\n    buildInfo?: IBuildInfo;\n  };\n}\n"]}

package/dist/esm/components/health-check/component.d.ts

@@ -0,0 +1,15 @@
+import { type BaseApplication } from '../../base/applications/index.js';
+import { BaseComponent } from '@venizia/ignis-kernel';
+import { type IHealthCheckOptions } from './common/index.js';
+export declare class HealthCheckComponent extends BaseComponent<IHealthCheckOptions> {
+    private application;
+    constructor(application: BaseApplication);
+    /**
+     * `application.component(HealthCheckComponent, { options })` lands here. Options given at the
+     * call site are the most explicit statement of intent, so they take the binding over anything
+     * bound earlier; `initDefaultBindings` then finds the key taken and leaves the default aside.
+     */
+    configure(opts?: IHealthCheckOptions): Promise<void>;
+    binding(): Promise<void>;
+}
+//# sourceMappingURL=component.d.ts.map

package/dist/esm/components/health-check/component.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"component.d.ts","sourceRoot":"","sources":["../../../../src/components/health-check/component.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAGtD,OAAO,EAA0B,KAAK,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAY5E,qBAAa,oBAAqB,SAAQ,aAAa,CAAC,mBAAmB,CAAC;IAEpB,OAAO,CAAC,WAAW;gBAAX,WAAW,EAAE,eAAe;IAa1F;;;;OAIG;IACY,SAAS,CAAC,IAAI,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBpD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAmCxC"}

package/dist/esm/components/health-check/component.js

@@ -0,0 +1,90 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+var HealthCheckComponent_1;
+import { BaseComponent } from '@venizia/ignis-kernel';
+import { controller, inject } from '../../base/metadata/index.js';
+import { CoreBindings } from '@venizia/ignis-kernel';
+import { HealthCheckBindingKeys } from './common/index.js';
+import { HealthCheckController } from './controller.js';
+import { HealthCheckReporter } from './reporter.js';
+import { Environment } from '@venizia/ignis-helpers';
+import { Binding } from '@venizia/ignis-kernel';
+const DEFAULT_REST_PATH = '/health';
+const DEFAULT_OPTIONS = {
+    restOptions: { path: DEFAULT_REST_PATH },
+};
+let HealthCheckComponent = HealthCheckComponent_1 = class HealthCheckComponent extends BaseComponent {
+    constructor(application) {
+        super({
+            scope: HealthCheckComponent_1.name,
+            initDefault: { enable: true, container: application },
+            bindings: {
+                [HealthCheckBindingKeys.HEALTH_CHECK_OPTIONS]: Binding.bind({
+                    key: HealthCheckBindingKeys.HEALTH_CHECK_OPTIONS,
+                }).toValue(DEFAULT_OPTIONS),
+            },
+        });
+        this.application = application;
+    }
+    /**
+     * `application.component(HealthCheckComponent, { options })` lands here. Options given at the
+     * call site are the most explicit statement of intent, so they take the binding over anything
+     * bound earlier; `initDefaultBindings` then finds the key taken and leaves the default aside.
+     */
+    async configure(opts) {
+        // The base short-circuits a second call; binding before that check would swap the options
+        // under routes that were already mounted from the first ones.
+        if (this.isConfigured) {
+            return;
+        }
+        if (opts !== undefined) {
+            this.application
+                .bind({ key: HealthCheckBindingKeys.HEALTH_CHECK_OPTIONS })
+                .toValue(opts);
+        }
+        await super.configure(opts);
+    }
+    async binding() {
+        const healthOptions = this.application.get({
+            key: HealthCheckBindingKeys.HEALTH_CHECK_OPTIONS,
+            isOptional: true,
+        });
+        // A partially filled options binding (env/config driven) must not take the app down at boot.
+        const path = healthOptions?.restOptions?.path ?? DEFAULT_REST_PATH;
+        // Legal, occasionally correct, and silent until now: `stats.enable: true` bypasses the
+        // environment gate, so the same code that opened the route for a local run opens it in
+        // production. Warn rather than refuse - only the operator knows whether the port is reachable.
+        if (healthOptions && HealthCheckReporter.isStatsUnguarded({ options: healthOptions })) {
+            this.logger
+                .for(this.binding.name)
+                .warn('GET %s/stats is ENABLED with no secretKey on env "%s" - build stamp, runtime version and memory are readable by anything that reaches this port. Set stats.secretKey, or drop stats.enable and let the environment decide.', path, Environment.ambient ?? 'unset');
+        }
+        // `getAppInfo()` is async while the container builds the controller synchronously, so the
+        // resolved value is bound here rather than resolved inside the controller.
+        this.application
+            .bind({ key: HealthCheckBindingKeys.APPLICATION_INFO })
+            .toValue(await this.application.getAppInfo());
+        // The gate and the app identity are per container, but `@controller` writes the PATH onto this
+        // one shared class in the process-wide MetadataRegistry, and `RestComponent` reads it back at
+        // step 8. Two applications booted one after another are safe; two booted CONCURRENTLY with
+        // different `restOptions.path` would race here, and nothing in this component prevents that.
+        Reflect.decorate([controller({ path })], HealthCheckController);
+        this.application.controller(HealthCheckController);
+    }
+};
+HealthCheckComponent = HealthCheckComponent_1 = __decorate([
+    __param(0, inject({ key: CoreBindings.APPLICATION_INSTANCE })),
+    __metadata("design:paramtypes", [Function])
+], HealthCheckComponent);
+export { HealthCheckComponent };
+//# sourceMappingURL=component.js.map

package/dist/esm/components/health-check/component.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"component.js","sourceRoot":"","sources":["../../../../src/components/health-check/component.ts"],"names":[],"mappings":"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","sourcesContent":["import { type BaseApplication } from '@/base/applications';\nimport { BaseComponent } from '@venizia/ignis-kernel';\nimport { controller, inject } from '@/base/metadata';\nimport { CoreBindings } from '@venizia/ignis-kernel';\nimport { HealthCheckBindingKeys, type IHealthCheckOptions } from './common';\nimport { HealthCheckController } from './controller';\nimport { HealthCheckReporter } from './reporter';\nimport { Environment } from '@venizia/ignis-helpers';\nimport { Binding } from '@venizia/ignis-kernel';\nimport type { IApplicationInfo } from '@venizia/ignis-kernel';\n\nconst DEFAULT_REST_PATH = '/health';\nconst DEFAULT_OPTIONS: IHealthCheckOptions = {\n  restOptions: { path: DEFAULT_REST_PATH },\n};\n\nexport class HealthCheckComponent extends BaseComponent<IHealthCheckOptions> {\n  constructor(\n    @inject({ key: CoreBindings.APPLICATION_INSTANCE }) private application: BaseApplication,\n  ) {\n    super({\n      scope: HealthCheckComponent.name,\n      initDefault: { enable: true, container: application },\n      bindings: {\n        [HealthCheckBindingKeys.HEALTH_CHECK_OPTIONS]: Binding.bind<IHealthCheckOptions>({\n          key: HealthCheckBindingKeys.HEALTH_CHECK_OPTIONS,\n        }).toValue(DEFAULT_OPTIONS),\n      },\n    });\n  }\n\n  /**\n   * `application.component(HealthCheckComponent, { options })` lands here. Options given at the\n   * call site are the most explicit statement of intent, so they take the binding over anything\n   * bound earlier; `initDefaultBindings` then finds the key taken and leaves the default aside.\n   */\n  override async configure(opts?: IHealthCheckOptions): Promise<void> {\n    // The base short-circuits a second call; binding before that check would swap the options\n    // under routes that were already mounted from the first ones.\n    if (this.isConfigured) {\n      return;\n    }\n\n    if (opts !== undefined) {\n      this.application\n        .bind<IHealthCheckOptions>({ key: HealthCheckBindingKeys.HEALTH_CHECK_OPTIONS })\n        .toValue(opts);\n    }\n\n    await super.configure(opts);\n  }\n\n  override async binding(): Promise<void> {\n    const healthOptions = this.application.get<IHealthCheckOptions>({\n      key: HealthCheckBindingKeys.HEALTH_CHECK_OPTIONS,\n      isOptional: true,\n    });\n\n    // A partially filled options binding (env/config driven) must not take the app down at boot.\n    const path = healthOptions?.restOptions?.path ?? DEFAULT_REST_PATH;\n\n    // Legal, occasionally correct, and silent until now: `stats.enable: true` bypasses the\n    // environment gate, so the same code that opened the route for a local run opens it in\n    // production. Warn rather than refuse - only the operator knows whether the port is reachable.\n    if (healthOptions && HealthCheckReporter.isStatsUnguarded({ options: healthOptions })) {\n      this.logger\n        .for(this.binding.name)\n        .warn(\n          'GET %s/stats is ENABLED with no secretKey on env \"%s\" - build stamp, runtime version and memory are readable by anything that reaches this port. Set stats.secretKey, or drop stats.enable and let the environment decide.',\n          path,\n          Environment.ambient ?? 'unset',\n        );\n    }\n\n    // `getAppInfo()` is async while the container builds the controller synchronously, so the\n    // resolved value is bound here rather than resolved inside the controller.\n    this.application\n      .bind<IApplicationInfo>({ key: HealthCheckBindingKeys.APPLICATION_INFO })\n      .toValue(await this.application.getAppInfo());\n\n    // The gate and the app identity are per container, but `@controller` writes the PATH onto this\n    // one shared class in the process-wide MetadataRegistry, and `RestComponent` reads it back at\n    // step 8. Two applications booted one after another are safe; two booted CONCURRENTLY with\n    // different `restOptions.path` would race here, and nothing in this component prevents that.\n    Reflect.decorate([controller({ path })], HealthCheckController);\n    this.application.controller(HealthCheckController);\n  }\n}\n"]}

package/dist/esm/components/health-check/controller.d.ts

@@ -0,0 +1,16 @@
+import { BaseRestController, type TRouteContext } from '../../base/controllers/index.js';
+import type { IApplicationInfo } from '@venizia/ignis-kernel';
+import { type ValueOrPromise } from '@venizia/ignis-helpers/common';
+import { type IHealthCheckOptions } from './common/index.js';
+export declare class HealthCheckController extends BaseRestController {
+    private readonly healthOptions;
+    private readonly appInfo?;
+    /**
+     * Both dependencies arrive through the container, so two applications in one process each get
+     * their own gate - a static field would let the last one to boot decide for every other.
+     */
+    constructor(healthOptions?: IHealthCheckOptions, appInfo?: IApplicationInfo | undefined);
+    binding(): ValueOrPromise<void>;
+    pingPong(context: TRouteContext): import("@venizia/ignis-kernel").TJsonResponse<unknown, 200>;
+}
+//# sourceMappingURL=controller.d.ts.map

package/dist/esm/components/health-check/controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"controller.d.ts","sourceRoot":"","sources":["../../../../src/components/health-check/controller.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,KAAK,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAG5E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAE9D,OAAO,EAAQ,KAAK,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC1E,OAAO,EAIL,KAAK,mBAAmB,EACzB,MAAM,UAAU,CAAC;AA+ElB,qBAAa,qBAAsB,SAAQ,kBAAkB;IAOzD,OAAO,CAAC,QAAQ,CAAC,aAAa;IAE9B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC;IAR3B;;;OAGG;gBAGgB,aAAa,GAAE,mBAAwB,EAEvC,OAAO,CAAC,EAAE,gBAAgB,YAAA;IAQpC,OAAO,IAAI,cAAc,CAAC,IAAI,CAAC;IAuCxC,QAAQ,CAAC,OAAO,EAAE,aAAa;CAShC"}

package/dist/esm/components/health-check/controller.js

@@ -0,0 +1,154 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+var HealthCheckController_1;
+import { BaseRestController } from '../../base/controllers/index.js';
+import { api, inject } from '../../base/metadata/index.js';
+import { jsonContent, jsonResponse } from '@venizia/ignis-kernel';
+import { z } from '@hono/zod-openapi';
+import { HTTP } from '@venizia/ignis-helpers/common';
+import { HealthCheckBindingKeys, HealthCheckHeaders, HealthCheckRestPaths, } from './common/index.js';
+import { HealthCheckReporter } from './reporter.js';
+const RouteConfigs = {
+    ROOT: {
+        method: HTTP.Methods.GET,
+        path: HealthCheckRestPaths.ROOT,
+        responses: jsonResponse({
+            schema: z.object({ status: z.string(), timestamp: z.iso.datetime() }).openapi({
+                description: 'HealthCheck Schema',
+                examples: [{ status: 'ok', timestamp: new Date().toISOString() }],
+            }),
+            description: 'Health check status',
+        }),
+    },
+    STATS: {
+        method: HTTP.Methods.GET,
+        path: HealthCheckRestPaths.STATS,
+        request: {
+            headers: z.object({
+                [HealthCheckHeaders.SECRET_KEY]: z.string().optional().openapi({
+                    description: 'The stats key',
+                }),
+            }),
+        },
+        responses: jsonResponse({
+            schema: z
+                .object({
+                status: z.string(),
+                timestamp: z.iso.datetime(),
+                build: z.object({
+                    service: z.string(),
+                    version: z.string(),
+                    commit: z.string(),
+                    branch: z.string(),
+                    builtAt: z.string(),
+                }),
+                process: z.object({
+                    pid: z.number(),
+                    uptime: z.number(),
+                    uptimeHuman: z.string(),
+                    runtime: z.string(),
+                    environment: z.string(),
+                }),
+                memory: z.object({ rss: z.string(), heapUsed: z.string(), heapTotal: z.string() }),
+            })
+                .openapi({ description: 'HealthCheck Stats Schema' }),
+            description: 'Build stamp, process and memory - closed outside the development environments unless enabled',
+        }),
+    },
+    PING: {
+        method: HTTP.Methods.POST,
+        path: HealthCheckRestPaths.PING,
+        request: {
+            body: jsonContent({
+                description: 'PING | Request body',
+                schema: z.object({
+                    type: z.string().optional().default('PING'),
+                    message: z.string().min(1).max(255),
+                }),
+            }),
+        },
+        responses: jsonResponse({
+            schema: z
+                .object({
+                type: z.string().optional().default('PONG'),
+                date: z.iso.datetime(),
+                message: z.string(),
+            })
+                .openapi({
+                description: 'HealthCheck PingPong Schema',
+                examples: [{ date: new Date().toISOString(), message: 'ok' }],
+            }),
+            description: 'HealthCheck PingPong Message',
+        }),
+    },
+};
+let HealthCheckController = HealthCheckController_1 = class HealthCheckController extends BaseRestController {
+    /**
+     * Both dependencies arrive through the container, so two applications in one process each get
+     * their own gate - a static field would let the last one to boot decide for every other.
+     */
+    constructor(healthOptions = {}, appInfo) {
+        super({ scope: HealthCheckController_1.name });
+        this.healthOptions = healthOptions;
+        this.appInfo = appInfo;
+        // Note: This is optional declare internal controller route definitions
+        this.definitions = RouteConfigs;
+    }
+    binding() {
+        // Public liveness probe: status and clock only. Nothing here names a runtime or a version.
+        this.bindRoute({ configs: RouteConfigs.ROOT }).to({
+            handler: (context) => {
+                return context.json(HealthCheckReporter.buildSummary(), HTTP.ResultCodes.RS_2.Ok);
+            },
+        });
+        if (!HealthCheckReporter.isStatsEnabled({ options: this.healthOptions })) {
+            this.logger
+                .for(this.binding.name)
+                .debug('Stats route disabled | path: %s', HealthCheckRestPaths.STATS);
+            return;
+        }
+        this.bindRoute({ configs: RouteConfigs.STATS }).to({
+            handler: (context) => {
+                // `context.notFound()`, not a thrown 404: it runs the application's own notFound handler,
+                // so the refusal is byte-identical to the answer for a route that was never mounted. A
+                // thrown `ApplicationError` serializes a different body and would confirm the route exists.
+                if (!HealthCheckReporter.isStatsAuthorized({
+                    options: this.healthOptions,
+                    header: context.req.header(HealthCheckHeaders.SECRET_KEY),
+                })) {
+                    return context.notFound();
+                }
+                return context.json(HealthCheckReporter.buildStats({ options: this.healthOptions, appInfo: this.appInfo }), HTTP.ResultCodes.RS_2.Ok);
+            },
+        });
+    }
+    // Method 3: Using 'decorators' to create a controller route, with an explicit type assertion for the validated request data
+    pingPong(context) {
+        const { message } = context.req.valid('json');
+        // Return type is automatically validated against the response schema
+        return context.json({ type: 'PONG', date: new Date().toISOString(), message }, HTTP.ResultCodes.RS_2.Ok);
+    }
+};
+__decorate([
+    api({ configs: RouteConfigs.PING }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", void 0)
+], HealthCheckController.prototype, "pingPong", null);
+HealthCheckController = HealthCheckController_1 = __decorate([
+    __param(0, inject({ key: HealthCheckBindingKeys.HEALTH_CHECK_OPTIONS, isOptional: true })),
+    __param(1, inject({ key: HealthCheckBindingKeys.APPLICATION_INFO, isOptional: true })),
+    __metadata("design:paramtypes", [Object, Object])
+], HealthCheckController);
+export { HealthCheckController };
+//# sourceMappingURL=controller.js.map

package/dist/esm/components/health-check/controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"controller.js","sourceRoot":"","sources":["../../../../src/components/health-check/controller.ts"],"names":[],"mappings":"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","sourcesContent":["import { BaseRestController, type TRouteContext } from '@/base/controllers';\nimport { api, inject } from '@/base/metadata';\nimport { jsonContent, jsonResponse } from '@venizia/ignis-kernel';\nimport type { IApplicationInfo } from '@venizia/ignis-kernel';\nimport { z } from '@hono/zod-openapi';\nimport { HTTP, type ValueOrPromise } from '@venizia/ignis-helpers/common';\nimport {\n  HealthCheckBindingKeys,\n  HealthCheckHeaders,\n  HealthCheckRestPaths,\n  type IHealthCheckOptions,\n} from './common';\nimport { HealthCheckReporter } from './reporter';\n\nconst RouteConfigs = {\n  ROOT: {\n    method: HTTP.Methods.GET,\n    path: HealthCheckRestPaths.ROOT,\n    responses: jsonResponse({\n      schema: z.object({ status: z.string(), timestamp: z.iso.datetime() }).openapi({\n        description: 'HealthCheck Schema',\n        examples: [{ status: 'ok', timestamp: new Date().toISOString() }],\n      }),\n      description: 'Health check status',\n    }),\n  },\n  STATS: {\n    method: HTTP.Methods.GET,\n    path: HealthCheckRestPaths.STATS,\n    request: {\n      headers: z.object({\n        [HealthCheckHeaders.SECRET_KEY]: z.string().optional().openapi({\n          description: 'The stats key',\n        }),\n      }),\n    },\n    responses: jsonResponse({\n      schema: z\n        .object({\n          status: z.string(),\n          timestamp: z.iso.datetime(),\n          build: z.object({\n            service: z.string(),\n            version: z.string(),\n            commit: z.string(),\n            branch: z.string(),\n            builtAt: z.string(),\n          }),\n          process: z.object({\n            pid: z.number(),\n            uptime: z.number(),\n            uptimeHuman: z.string(),\n            runtime: z.string(),\n            environment: z.string(),\n          }),\n          memory: z.object({ rss: z.string(), heapUsed: z.string(), heapTotal: z.string() }),\n        })\n        .openapi({ description: 'HealthCheck Stats Schema' }),\n      description:\n        'Build stamp, process and memory - closed outside the development environments unless enabled',\n    }),\n  },\n  PING: {\n    method: HTTP.Methods.POST,\n    path: HealthCheckRestPaths.PING,\n    request: {\n      body: jsonContent({\n        description: 'PING | Request body',\n        schema: z.object({\n          type: z.string().optional().default('PING'),\n          message: z.string().min(1).max(255),\n        }),\n      }),\n    },\n    responses: jsonResponse({\n      schema: z\n        .object({\n          type: z.string().optional().default('PONG'),\n          date: z.iso.datetime(),\n          message: z.string(),\n        })\n        .openapi({\n          description: 'HealthCheck PingPong Schema',\n          examples: [{ date: new Date().toISOString(), message: 'ok' }],\n        }),\n      description: 'HealthCheck PingPong Message',\n    }),\n  },\n} as const;\n\nexport class HealthCheckController extends BaseRestController {\n  /**\n   * Both dependencies arrive through the container, so two applications in one process each get\n   * their own gate - a static field would let the last one to boot decide for every other.\n   */\n  constructor(\n    @inject({ key: HealthCheckBindingKeys.HEALTH_CHECK_OPTIONS, isOptional: true })\n    private readonly healthOptions: IHealthCheckOptions = {},\n    @inject({ key: HealthCheckBindingKeys.APPLICATION_INFO, isOptional: true })\n    private readonly appInfo?: IApplicationInfo,\n  ) {\n    super({ scope: HealthCheckController.name });\n\n    // Note: This is optional declare internal controller route definitions\n    this.definitions = RouteConfigs;\n  }\n\n  override binding(): ValueOrPromise<void> {\n    // Public liveness probe: status and clock only. Nothing here names a runtime or a version.\n    this.bindRoute({ configs: RouteConfigs.ROOT }).to({\n      handler: (context) => {\n        return context.json(HealthCheckReporter.buildSummary(), HTTP.ResultCodes.RS_2.Ok);\n      },\n    });\n\n    if (!HealthCheckReporter.isStatsEnabled({ options: this.healthOptions })) {\n      this.logger\n        .for(this.binding.name)\n        .debug('Stats route disabled | path: %s', HealthCheckRestPaths.STATS);\n      return;\n    }\n\n    this.bindRoute({ configs: RouteConfigs.STATS }).to({\n      handler: (context) => {\n        // `context.notFound()`, not a thrown 404: it runs the application's own notFound handler,\n        // so the refusal is byte-identical to the answer for a route that was never mounted. A\n        // thrown `ApplicationError` serializes a different body and would confirm the route exists.\n        if (\n          !HealthCheckReporter.isStatsAuthorized({\n            options: this.healthOptions,\n            header: context.req.header(HealthCheckHeaders.SECRET_KEY),\n          })\n        ) {\n          return context.notFound();\n        }\n\n        return context.json(\n          HealthCheckReporter.buildStats({ options: this.healthOptions, appInfo: this.appInfo }),\n          HTTP.ResultCodes.RS_2.Ok,\n        );\n      },\n    });\n  }\n\n  // Method 3: Using 'decorators' to create a controller route, with an explicit type assertion for the validated request data\n  @api({ configs: RouteConfigs.PING })\n  pingPong(context: TRouteContext) {\n    const { message } = context.req.valid<{ type?: string; message: string }>('json');\n\n    // Return type is automatically validated against the response schema\n    return context.json(\n      { type: 'PONG', date: new Date().toISOString(), message },\n      HTTP.ResultCodes.RS_2.Ok,\n    );\n  }\n}\n"]}

package/dist/esm/components/health-check/index.d.ts

@@ -0,0 +1,5 @@
+export * from './common/index.js';
+export * from './component.js';
+export * from './controller.js';
+export * from './reporter.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/components/health-check/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/health-check/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC"}

package/dist/esm/components/health-check/index.js

@@ -0,0 +1,5 @@
+export * from './common/index.js';
+export * from './component.js';
+export * from './controller.js';
+export * from './reporter.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/components/health-check/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/components/health-check/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC","sourcesContent":["export * from './common';\nexport * from './component';\nexport * from './controller';\nexport * from './reporter';\n"]}