@venizia/ignis-kernel 0.2.0-0

package/LICENSE.md

@@ -0,0 +1,105 @@
+# Ignis Framework License
+
+Ignis is a TypeScript Server Infrastructure framework built on [Hono](https://hono.dev/).
+
+## MIT License
+
+Copyright (c) 2025 VENIZIA Ltd. Co.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+---
+
+## Packages
+
+This monorepo contains the following packages, all licensed under MIT:
+
+| Package | Description |
+|---------|-------------|
+| `@venizia/ignis` | Core framework - controllers, services, decorators |
+| `@venizia/ignis-kernel` | **This package** - browser-pure kernel: DI, lifecycle, controllers, auth seams |
+| `@venizia/ignis-boot` | Application bootstrapping & artifact auto-discovery |
+| `@venizia/ignis-helpers` | Utility helpers - logging, cron, Redis, queues, storage |
+| `@venizia/ignis-inversion` | Dependency Injection & IoC container |
+| `@venizia/dev-configs` | Shared ESLint, Prettier, TypeScript configurations |
+| `@venizia/ignis-docs` | Documentation and MCP Server |
+
+---
+
+## Third-Party Dependencies
+
+Ignis uses the following open-source libraries. We are grateful to the authors and contributors of these projects.
+
+### Core Dependencies
+
+| Library | License | Description |
+|---------|---------|-------------|
+| [Hono](https://github.com/honojs/hono) | MIT | Ultrafast web framework |
+| [Zod](https://github.com/colinhacks/zod) | MIT | TypeScript-first schema validation |
+| [Drizzle ORM](https://github.com/drizzle-team/drizzle-orm) | Apache-2.0 | TypeScript ORM |
+| [Jose](https://github.com/panva/jose) | MIT | JavaScript Object Signing and Encryption |
+
+### Helpers Dependencies
+
+| Library | License | Description |
+|---------|---------|-------------|
+| [Winston](https://github.com/winstonjs/winston) | MIT | Universal logging library |
+| [BullMQ](https://github.com/taskforcesh/bullmq) | MIT | Message queue and job scheduling |
+| [IORedis](https://github.com/redis/ioredis) | MIT | Redis client for Node.js |
+| [MinIO](https://github.com/minio/minio-js) | Apache-2.0 | S3-compatible object storage client |
+| [Axios](https://github.com/axios/axios) | MIT | HTTP client |
+| [Day.js](https://github.com/iamkun/dayjs) | MIT | Date manipulation library |
+| [Cron](https://github.com/kelektiv/node-cron) | MIT | Cron job scheduler |
+| [Socket.IO](https://github.com/socketio/socket.io) | MIT | Real-time bidirectional communication |
+| [MQTT.js](https://github.com/mqttjs/MQTT.js) | MIT | MQTT client |
+
+### Utility Dependencies
+
+| Library | License | Description |
+|---------|---------|-------------|
+| [Lodash](https://github.com/lodash/lodash) | MIT | Utility library |
+| [reflect-metadata](https://github.com/rbuckton/reflect-metadata) | Apache-2.0 | Metadata reflection API |
+| [glob](https://github.com/isaacs/node-glob) | ISC | File pattern matching (used by boot) |
+
+### Documentation Dependencies
+
+| Library | License | Description |
+|---------|---------|-------------|
+| [VitePress](https://github.com/vuejs/vitepress) | MIT | Static site generator |
+| [Fuse.js](https://github.com/krisk/fuse) | Apache-2.0 | Fuzzy search library |
+| [gray-matter](https://github.com/jonschlinkert/gray-matter) | MIT | Front-matter parser |
+
+---
+
+## Acknowledgments
+
+Ignis Framework is inspired by and built upon the work of many open-source projects:
+
+- **[Hono](https://hono.dev/)** by Yusuke Wada - The ultrafast web framework that powers Ignis
+- **[LoopBack 4](https://loopback.io/)** by IBM/StrongLoop - Inspiration for the enterprise architecture patterns
+- **[NestJS](https://nestjs.com/)** by Kamil Mysliwiec - Inspiration for decorator-based controllers
+- **[InversifyJS](https://inversify.io/)** - Inspiration for the IoC container design
+
+We thank all the maintainers and contributors of these projects for their excellent work.
+
+---
+
+## Contributing
+
+By contributing to Ignis, you agree that your contributions will be licensed under the MIT License.

package/README.md

@@ -0,0 +1,16 @@
+# @venizia/ignis-kernel
+
+Browser-pure kernel of the IGNIS framework: dependency injection, lifecycle, REST controllers,
+repository and datasource abstractions, and the authentication and authorization seams.
+
+No node builtin and no server-only peer, so the same kernel serves a Bun server (via
+`@venizia/ignis`, which re-exports this package in full) and a browser Worker.
+
+## Logging
+
+A host that imports only this package gets the console fallback logger, because nothing here loads
+`LoggerFactory` and installs the real resolver. Import `LoggerFactory` from `@venizia/ignis-helpers`
+once at startup to get the configured logger - loggers built before that import upgrade themselves
+on their next call through the resolver's generation counter, so nothing needs reconstructing.
+
+See the [IGNIS documentation](https://ignis.venizia.ai) for usage.

package/dist/cjs/base/applications/abstract.d.ts

@@ -0,0 +1,38 @@
+import { Container } from '../../helpers/inversion/container';
+import type { ValueOrPromise } from '@venizia/ignis-helpers/common';
+import type { IApplicationConfigs, IApplicationInfo } from './types';
+export declare abstract class AbstractApplication extends Container {
+    protected configs: IApplicationConfigs;
+    protected projectRoot: string;
+    private postStartHooks;
+    private postStopHooks;
+    constructor(opts: {
+        scope: string;
+        config: IApplicationConfigs;
+    });
+    abstract getAppInfo(): ValueOrPromise<IApplicationInfo>;
+    abstract preConfigure(): ValueOrPromise<void>;
+    abstract postConfigure(): ValueOrPromise<void>;
+    abstract staticConfigure(): void;
+    abstract setupMiddlewares(opts?: {
+        middlewares?: Record<string | symbol, any>;
+    }): ValueOrPromise<void>;
+    abstract initialize(): Promise<void>;
+    protected getDefaultAsyncContextEnabled(): boolean;
+    getProjectConfigs(): IApplicationConfigs;
+    getProjectRoot(): string;
+    registerPostStartHook(opts: {
+        identifier: string;
+        hook: () => ValueOrPromise<void>;
+    }): void;
+    /** Runs every post-start hook in isolation - the server is already listening, so a throwing hook must not cancel the ones behind it; failures are collected and reported as one error at the end. */
+    protected executePostStartHooks(): Promise<void>;
+    registerPostStopHook(opts: {
+        identifier: string;
+        hook: () => ValueOrPromise<void>;
+    }): void;
+    protected executePostStopHooks(): Promise<void>;
+    protected registerCoreBindings(): void;
+    init(): void;
+}
+//# sourceMappingURL=abstract.d.ts.map

package/dist/cjs/base/applications/abstract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"abstract.d.ts","sourceRoot":"","sources":["../../../../src/base/applications/abstract.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAC1D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAGpE,OAAO,KAAK,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAErE,8BAAsB,mBAAoB,SAAQ,SAAS;IACzD,SAAS,CAAC,OAAO,EAAE,mBAAmB,CAAC;IACvC,SAAS,CAAC,WAAW,EAAE,MAAM,CAAC;IAE9B,OAAO,CAAC,cAAc,CAAuE;IAC7F,OAAO,CAAC,aAAa,CAAuE;gBAEhF,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,mBAAmB,CAAA;KAAE;IAchE,QAAQ,CAAC,UAAU,IAAI,cAAc,CAAC,gBAAgB,CAAC;IACvD,QAAQ,CAAC,YAAY,IAAI,cAAc,CAAC,IAAI,CAAC;IAC7C,QAAQ,CAAC,aAAa,IAAI,cAAc,CAAC,IAAI,CAAC;IAE9C,QAAQ,CAAC,eAAe,IAAI,IAAI;IAEhC,QAAQ,CAAC,gBAAgB,CAAC,IAAI,CAAC,EAAE;QAC/B,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,GAAG,MAAM,EAAE,GAAG,CAAC,CAAC;KAC5C,GAAG,cAAc,CAAC,IAAI,CAAC;IAExB,QAAQ,CAAC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAEpC,SAAS,CAAC,6BAA6B,IAAI,OAAO;IAIlD,iBAAiB,IAAI,mBAAmB;IAIxC,cAAc,IAAI,MAAM;IAMxB,qBAAqB,CAAC,IAAI,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,cAAc,CAAC,IAAI,CAAC,CAAA;KAAE;IAOpF,qMAAqM;cACrL,qBAAqB;IAwCrC,oBAAoB,CAAC,IAAI,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,cAAc,CAAC,IAAI,CAAC,CAAA;KAAE;cAOnE,oBAAoB;IAWpC,SAAS,CAAC,oBAAoB;IAM9B,IAAI;CAGL"}

package/dist/cjs/base/applications/abstract.js

@@ -0,0 +1,96 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AbstractApplication = void 0;
+const bindings_1 = require("../../common/bindings");
+const container_1 = require("../../helpers/inversion/container");
+const core_1 = require("@venizia/ignis-helpers/core");
+const common_1 = require("@venizia/ignis-helpers/common");
+class AbstractApplication extends container_1.Container {
+    constructor(opts) {
+        const { scope, config } = opts;
+        super({ scope });
+        this.postStartHooks = [];
+        this.postStopHooks = [];
+        this.configs = Object.assign({}, config, {
+            asyncContext: {
+                enable: config?.asyncContext?.enable ?? this.getDefaultAsyncContextEnabled(),
+            },
+        });
+        this.projectRoot = this.getProjectRoot();
+        this.logger.for('constructor').info('Project root: %s', this.projectRoot);
+    }
+    getDefaultAsyncContextEnabled() {
+        return false;
+    }
+    getProjectConfigs() {
+        return this.configs;
+    }
+    getProjectRoot() {
+        const projectRoot = '';
+        this.bind({ key: bindings_1.CoreBindings.APPLICATION_PROJECT_ROOT }).toValue(projectRoot);
+        return projectRoot;
+    }
+    registerPostStartHook(opts) {
+        this.postStartHooks.push(opts);
+        this.logger
+            .for(this.registerPostStartHook.name)
+            .debug('Registered post-start hook | identifier: %s', opts.identifier);
+    }
+    /** Runs every post-start hook in isolation - the server is already listening, so a throwing hook must not cancel the ones behind it; failures are collected and reported as one error at the end. */
+    async executePostStartHooks() {
+        if (this.postStartHooks.length === 0) {
+            return;
+        }
+        const logger = this.logger.for(this.executePostStartHooks.name);
+        logger.info('Executing %s post-start hook(s)...', this.postStartHooks.length);
+        const failures = [];
+        for (const { identifier, hook } of this.postStartHooks) {
+            const t = performance.now();
+            try {
+                await hook();
+            }
+            catch (error) {
+                logger.error('Failed to execute hook | identifier: %s | error: %s', identifier, error);
+                failures.push({ identifier, error });
+                continue;
+            }
+            logger.info('Executed hook | identifier: %s | took: %s (ms)', identifier, performance.now() - t);
+        }
+        if (failures.length === 0) {
+            return;
+        }
+        throw (0, core_1.getError)({
+            statusCode: common_1.HTTP.ResultCodes.RS_5.InternalServerError,
+            message: `[executePostStartHooks] Failed post-start hook(s): ${failures
+                .map(failure => `${failure.identifier} (${failure.error})`)
+                .join(', ')}`,
+        });
+    }
+    registerPostStopHook(opts) {
+        this.postStopHooks.push(opts);
+        this.logger
+            .for(this.registerPostStopHook.name)
+            .debug('Registered post-stop hook | identifier: %s', opts.identifier);
+    }
+    async executePostStopHooks() {
+        const logger = this.logger.for(this.executePostStopHooks.name);
+        for (const { identifier, hook } of this.postStopHooks) {
+            try {
+                await hook();
+            }
+            catch (error) {
+                logger.error('Post-stop hook failed | identifier: %s | error: %s', identifier, error);
+            }
+        }
+    }
+    registerCoreBindings() {
+        this.bind({
+            key: bindings_1.CoreBindings.APPLICATION_INSTANCE,
+        }).toProvider(_ => this);
+    }
+    init() {
+        this.registerCoreBindings();
+    }
+}
+exports.AbstractApplication = AbstractApplication;
+//# sourceMappingURL=abstract.js.map

package/dist/cjs/base/applications/abstract.js.map

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

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

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

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

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

package/dist/cjs/base/applications/index.js

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/base/applications/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,6CAA2B;AAC3B,yCAAuB;AACvB,0CAAwB"}

package/dist/cjs/base/applications/rest.d.ts

@@ -0,0 +1,83 @@
+import type { TBindingNamespace } from '../../common/bindings';
+import type { Binding } from '../../helpers/inversion';
+import type { BaseComponent } from '../components';
+import type { IDataSource } from '../datasources';
+import type { IRepository } from '../repositories';
+import type { IService } from '../services';
+import type { TMixinOpts } from '../mixins/types';
+import { OpenAPIHono } from '@hono/zod-openapi';
+import type { AnyObject, IConfigurable, TClass, ValueOrPromise } from '@venizia/ignis-helpers/common';
+import { RequestIdGenerator } from '@venizia/ignis-helpers/core';
+import type { Env, Schema } from 'hono';
+import { BaseAppErrorMiddleware } from '../middlewares/app-error/app-error.middleware';
+import { AbstractApplication } from './abstract';
+import type { IApplicationConfigs } from './types';
+interface IRegisterDynamicBindingsOptions<T extends IConfigurable = IConfigurable> {
+    namespace: TBindingNamespace;
+    onBeforeConfigure?: (opts: {
+        binding: Binding<T>;
+    }) => Promise<void>;
+    onAfterConfigure?: (opts: {
+        binding: Binding<T>;
+        instance: T;
+    }) => Promise<void>;
+}
+/** Adds the `OpenAPIHono` router surface on top of `AbstractApplication` - no listening server, so this is the layer a browser Worker or gRPC-only host can extend without pulling in `Bun.serve` / `@hono/node-server`. */
+export declare abstract class RestApplication<AppEnv extends Env = Env, AppSchema extends Schema = {}, BasePath extends string = '/'> extends AbstractApplication {
+    private registeredBindings;
+    /** The router, and nothing else. What runtime is underneath and what socket is bound are `ServerApplication`'s to know - a browser Worker has neither, and carrying the union here made `RuntimeModules.detect()` answer `'node'` inside a Worker. */
+    protected server: {
+        hono: OpenAPIHono<AppEnv, AppSchema, BasePath>;
+    };
+    protected rootRouter: OpenAPIHono<AppEnv, AppSchema, BasePath>;
+    protected readonly requestIdGenerator: RequestIdGenerator;
+    constructor(opts: {
+        scope: string;
+        config: IApplicationConfigs;
+    });
+    getRootRouter(): OpenAPIHono<AppEnv, AppSchema, BasePath>;
+    getServer(): OpenAPIHono<AppEnv, AppSchema, BasePath>;
+    protected registerCoreBindings(): void;
+    /** The correlation id every host stamps - see {@link RequestIdGenerator} for why `crypto.randomUUID` is refused. */
+    protected generateRequestId(): string;
+    /** The error handler the default stack installs. `@venizia/ignis` overrides it to swap in the `ErrorPrettier`-backed formatter, which reaches `node:util` and so cannot live here. */
+    protected buildErrorMiddleware(): BaseAppErrorMiddleware;
+    /**
+     * The three registrations every host needs, in one place, so a server and a browser Worker cannot
+     * drift: a request id, the framework's error envelope, and a JSON 404.
+     *
+     * None is optional. Hono's own defaults answer a thrown `ApplicationError` with a generic 500 and
+     * an unrouted path with `text/plain` - a caller doing `response.json()` on that 404 gets a
+     * `SyntaxError` instead of an error envelope. And without `requestId()`, `context.get(REQUEST_ID_KEY)`
+     * is `undefined`, so `context.json` drops the one field that ties a response to a log line.
+     *
+     * Registered before `initialize()`, so an application installing its own handlers still wins.
+     */
+    protected registerDefaultMiddlewares(): ValueOrPromise<void>;
+    /**
+     * The artifact ordering, stated ONCE: datasources before repositories can auto-resolve them, and
+     * components before controllers because a component may contribute either.
+     *
+     * A browser Worker application inherits this and writes none of it. `BaseApplication` in
+     * `@venizia/ignis` is the one deliberate override - it interleaves phases only a server has
+     * (start-up banner, env validation, secret hydration and rotation) between these steps.
+     */
+    initialize(): Promise<void>;
+    protected inspectRoutes(): void;
+    protected registerDynamicBindings<T extends IConfigurable = IConfigurable>(opts: IRegisterDynamicBindingsOptions<T>): Promise<void>;
+    component<Base extends BaseComponent, Args extends AnyObject = any>(ctor: TClass<Base>, opts?: TMixinOpts<Args>): Binding<Base>;
+    registerComponents(): Promise<void>;
+    /**
+     * Handles the REST branch only - the kernel has no notion of gRPC (it reaches `node:module` via
+     * `AbstractGrpcController`, core-only). `BaseApplication` extends this with the gRPC branch, the
+     * unsupported-transport error and the orphaned-gRPC-controller warning.
+     */
+    registerControllers(): Promise<void>;
+    controller<Base, Args extends AnyObject = any>(ctor: TClass<Base>, opts?: TMixinOpts<Args>): Binding<Base>;
+    service<Base extends IService, Args extends AnyObject = any>(ctor: TClass<Base>, opts?: TMixinOpts<Args>): Binding<Base>;
+    repository<Base extends IRepository, Args extends AnyObject = any>(ctor: TClass<Base>, opts?: TMixinOpts<Args>): Binding<Base>;
+    dataSource<Base extends IDataSource, Args extends AnyObject = any>(ctor: TClass<Base>, opts?: TMixinOpts<Args>): Binding<Base>;
+    registerDataSources(): Promise<void>;
+}
+export {};
+//# sourceMappingURL=rest.d.ts.map

package/dist/cjs/base/applications/rest.d.ts.map

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

package/dist/cjs/base/applications/rest.js

@@ -0,0 +1,229 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RestApplication = void 0;
+const bindings_1 = require("../../common/bindings");
+const inversion_1 = require("../../helpers/inversion");
+const rest_component_1 = require("../components/controller/rest/rest.component");
+const constants_1 = require("../controllers/common/constants");
+const zod_openapi_1 = require("@hono/zod-openapi");
+const core_1 = require("@venizia/ignis-helpers/core");
+const dev_1 = require("hono/dev");
+const request_id_1 = require("hono/request-id");
+const app_error_middleware_1 = require("../middlewares/app-error/app-error.middleware");
+const not_found_middleware_1 = require("../middlewares/not-found/not-found.middleware");
+const abstract_1 = require("./abstract");
+/** Adds the `OpenAPIHono` router surface on top of `AbstractApplication` - no listening server, so this is the layer a browser Worker or gRPC-only host can extend without pulling in `Bun.serve` / `@hono/node-server`. */
+class RestApplication extends abstract_1.AbstractApplication {
+    constructor(opts) {
+        super(opts);
+        this.registeredBindings = {};
+        this.requestIdGenerator = new core_1.RequestIdGenerator({ scope: opts.scope });
+        const honoServer = new zod_openapi_1.OpenAPIHono({
+            strict: this.configs.strictPath ?? true,
+        });
+        this.rootRouter = new zod_openapi_1.OpenAPIHono({
+            strict: this.configs.strictPath ?? true,
+        });
+        this.server = { hono: honoServer };
+    }
+    getRootRouter() {
+        return this.rootRouter;
+    }
+    getServer() {
+        return this.server.hono;
+    }
+    registerCoreBindings() {
+        super.registerCoreBindings();
+        this.bind({
+            key: bindings_1.CoreBindings.APPLICATION_SERVER,
+        }).toProvider(_ => this.server);
+        this.bind({
+            key: bindings_1.CoreBindings.APPLICATION_ROOT_ROUTER,
+        }).toProvider(_ => this.rootRouter);
+    }
+    /** The correlation id every host stamps - see {@link RequestIdGenerator} for why `crypto.randomUUID` is refused. */
+    generateRequestId() {
+        return this.requestIdGenerator.nextId();
+    }
+    /** The error handler the default stack installs. `@venizia/ignis` overrides it to swap in the `ErrorPrettier`-backed formatter, which reaches `node:util` and so cannot live here. */
+    buildErrorMiddleware() {
+        const environment = this.configs.error?.environment;
+        return new app_error_middleware_1.BaseAppErrorMiddleware({
+            logger: this.logger,
+            rootKey: this.configs.error?.rootKey ?? undefined,
+            // Spread, not `environment: () => environment`: the option's PRESENCE is what claims this host
+            // has an ambient environment at all, so an unset config must leave it absent.
+            ...(environment === undefined ? {} : { environment: () => environment }),
+        });
+    }
+    /**
+     * The three registrations every host needs, in one place, so a server and a browser Worker cannot
+     * drift: a request id, the framework's error envelope, and a JSON 404.
+     *
+     * None is optional. Hono's own defaults answer a thrown `ApplicationError` with a generic 500 and
+     * an unrouted path with `text/plain` - a caller doing `response.json()` on that 404 gets a
+     * `SyntaxError` instead of an error envelope. And without `requestId()`, `context.get(REQUEST_ID_KEY)`
+     * is `undefined`, so `context.json` drops the one field that ties a response to a log line.
+     *
+     * Registered before `initialize()`, so an application installing its own handlers still wins.
+     */
+    registerDefaultMiddlewares() {
+        const server = this.getServer();
+        server.use((0, request_id_1.requestId)({ generator: () => this.generateRequestId() }));
+        server.onError(this.buildErrorMiddleware().value());
+        server.notFound((0, not_found_middleware_1.notFoundHandler)({ logger: this.logger }));
+    }
+    /**
+     * The artifact ordering, stated ONCE: datasources before repositories can auto-resolve them, and
+     * components before controllers because a component may contribute either.
+     *
+     * A browser Worker application inherits this and writes none of it. `BaseApplication` in
+     * `@venizia/ignis` is the one deliberate override - it interleaves phases only a server has
+     * (start-up banner, env validation, secret hydration and rotation) between these steps.
+     */
+    async initialize() {
+        this.staticConfigure();
+        await this.preConfigure();
+        await this.registerDataSources();
+        await this.registerComponents();
+        await this.registerControllers();
+        await this.postConfigure();
+    }
+    inspectRoutes() {
+        const t = performance.now();
+        const shouldShowRoutes = this.configs?.debug?.shouldShowRoutes ?? false;
+        if (!shouldShowRoutes) {
+            return;
+        }
+        this.logger.for(this.inspectRoutes.name).info('START | Inspect all application route(s)');
+        (0, dev_1.showRoutes)(this.getServer());
+        this.logger
+            .for(this.inspectRoutes.name)
+            .info('DONE | Inspect all application route(s) | Took: %s (ms)', performance.now() - t);
+    }
+    async registerDynamicBindings(opts) {
+        const logger = this.logger.for(this.registerDynamicBindings.name);
+        const { namespace, onBeforeConfigure, onAfterConfigure } = opts;
+        if (!this.registeredBindings[namespace]) {
+            this.registeredBindings[namespace] = new Set();
+        }
+        const configured = this.registeredBindings[namespace];
+        // A whole batch is drained before re-scanning: the re-scan exists only to pick up bindings a
+        // `configure()` added, and asking after every single item makes boot N+1 full scans of the
+        // binding map - 3.5ms at 200 controllers, against 0.04ms for this shape.
+        let bindings = this.findByTag({ tag: namespace, exclude: configured });
+        while (bindings.length > 0) {
+            for (const binding of bindings) {
+                // Within a batch a nested `configure()` may already have taken this one.
+                if (configured.has(binding.key)) {
+                    continue;
+                }
+                if (onBeforeConfigure) {
+                    await onBeforeConfigure({ binding });
+                }
+                const instance = this.get({ key: binding.key, isOptional: false });
+                if (!instance) {
+                    logger.debug('No binding instance | namespace: %s | key: %s', namespace, binding.key);
+                    configured.add(binding.key);
+                    continue;
+                }
+                await instance.configure();
+                configured.add(binding.key);
+                if (onAfterConfigure) {
+                    await onAfterConfigure({ binding, instance });
+                }
+            }
+            // Re-fetch excluding already configured - picks up dynamically added bindings
+            bindings = this.findByTag({ tag: namespace, exclude: configured });
+        }
+    }
+    component(ctor, opts) {
+        return this.bind({
+            key: inversion_1.BindingKeys.build(opts?.binding ?? { namespace: bindings_1.BindingNamespaces.COMPONENT, key: ctor.name }),
+        })
+            .toClass(ctor)
+            .setScope(inversion_1.BindingScopes.SINGLETON);
+    }
+    async registerComponents() {
+        await (0, core_1.executeWithPerformanceMeasure)({
+            logger: this.logger,
+            scope: this.registerComponents.name,
+            description: 'Register application components',
+            task: async () => {
+                await this.registerDynamicBindings({
+                    namespace: bindings_1.BindingNamespaces.COMPONENT,
+                    onAfterConfigure: async () => {
+                        // Register any datasources dynamically added by this component
+                        await this.registerDynamicBindings({ namespace: bindings_1.BindingNamespaces.DATASOURCE });
+                    },
+                });
+            },
+        });
+    }
+    /**
+     * Handles the REST branch only - the kernel has no notion of gRPC (it reaches `node:module` via
+     * `AbstractGrpcController`, core-only). `BaseApplication` extends this with the gRPC branch, the
+     * unsupported-transport error and the orphaned-gRPC-controller warning.
+     */
+    async registerControllers() {
+        await (0, core_1.executeWithPerformanceMeasure)({
+            logger: this.logger,
+            description: 'Register application REST controllers',
+            scope: this.registerControllers.name,
+            task: async () => {
+                const transports = this.configs.transports ?? [constants_1.ControllerTransports.REST];
+                if (!transports.includes(constants_1.ControllerTransports.REST)) {
+                    return;
+                }
+                const restComponent = new rest_component_1.RestComponent(this);
+                await restComponent.configure();
+            },
+        });
+    }
+    controller(ctor, opts) {
+        return this.bind({
+            key: inversion_1.BindingKeys.build(opts?.binding ?? {
+                namespace: bindings_1.BindingNamespaces.CONTROLLER,
+                key: ctor.name,
+            }),
+        }).toClass(ctor);
+    }
+    service(ctor, opts) {
+        return this.bind({
+            key: inversion_1.BindingKeys.build(opts?.binding ?? {
+                namespace: bindings_1.BindingNamespaces.SERVICE,
+                key: ctor.name,
+            }),
+        }).toClass(ctor);
+    }
+    repository(ctor, opts) {
+        return this.bind({
+            key: inversion_1.BindingKeys.build(opts?.binding ?? {
+                namespace: bindings_1.BindingNamespaces.REPOSITORY,
+                key: ctor.name,
+            }),
+        }).toClass(ctor);
+    }
+    dataSource(ctor, opts) {
+        return this.bind({
+            key: inversion_1.BindingKeys.build(opts?.binding ?? {
+                namespace: bindings_1.BindingNamespaces.DATASOURCE,
+                key: ctor.name,
+            }),
+        })
+            .toClass(ctor)
+            .setScope(inversion_1.BindingScopes.SINGLETON);
+    }
+    async registerDataSources() {
+        await (0, core_1.executeWithPerformanceMeasure)({
+            logger: this.logger,
+            scope: this.registerDataSources.name,
+            description: 'Register application data sources',
+            task: async () => {
+                await this.registerDynamicBindings({ namespace: bindings_1.BindingNamespaces.DATASOURCE });
+            },
+        });
+    }
+}
+exports.RestApplication = RestApplication;
+//# sourceMappingURL=rest.js.map

package/dist/cjs/base/applications/rest.js.map

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