@venizia/ignis 0.4.3 → 0.4.5

package/dist/base/applications/server.d.ts

@@ -1,53 +0,0 @@
-import { RestApplication } from '@venizia/ignis-kernel';
-import type { Env, Schema } from 'hono';
-import type { IServerApplication, IServerApplicationConfigs, IServerRuntimeConfigs, IShutdownSignalsOptions, TNodeServerInstance } from './common';
-/** Lives here, not in the kernel: `Bun.serve` resolves only through `@types/bun`, and emitting `Bun` into the kernel's published `.d.ts` would force that dependency on every browser consumer of `@venizia/ignis-kernel`. This package legitimately has Bun types - it is the layer that calls `Bun.serve`. */
-export type TBunServerInstance = ReturnType<typeof Bun.serve>;
-/** Adds the listening server (`Bun.serve` / `@hono/node-server`) on top of `RestApplication` - the only layer that touches a socket, so it is the layer that stays out of the browser-pure kernel. */
-export declare abstract class ServerApplication<AppEnv extends Env = Env, AppSchema extends Schema = {}, BasePath extends string = '/'> extends RestApplication<AppEnv, AppSchema, BasePath> implements IServerApplication<AppEnv, AppSchema, BasePath> {
-    /** Which runtime is underneath, and the socket once one is bound. Both live here, not on `RestApplication`: a browser Worker has neither, and `RuntimeModules.detect()` answers `'node'` there. */
-    protected runtime: import("@venizia/ignis-helpers").TRuntimeModule;
-    protected serverInstance?: TBunServerInstance | TNodeServerInstance;
-    /** Widened by this layer, which is the only one that binds a socket. Assigned by the base constructor - `declare` so no field initializer runs here and overwrites it with `undefined`. */
-    protected configs: IServerApplicationConfigs;
-    /**
-     * The address resolution the kernel deliberately does not do: `host` and `port` mean nothing to a
-     * host with no socket, and resolving them there silently configured every browser Worker with
-     * `localhost:3000`. Env is the fallback, explicit config always wins.
-     */
-    constructor(opts: {
-        scope: string;
-        config: IServerApplicationConfigs;
-    });
-    /** Restores the pre-split default: a server-capable application installs `hono/context-storage` unless the caller opts out explicitly. */
-    protected getDefaultAsyncContextEnabled(): boolean;
-    /** `configs.projectRoot` wins, else the process cwd. The value is bound AND handed to `ModuleUtility`, so every peer lookup (optional modules, the gRPC adapter) resolves under it - a compiled binary sets it to where its `node_modules` really is. */
-    getProjectRoot(): string;
-    getServerHost(): string;
-    getServerPort(): number;
-    getServerAddress(): string;
-    /** `configs.server` with unset keys dropped, so a missing option keeps Bun's default instead of passing `undefined`. */
-    protected getServerRuntimeOptions(): IServerRuntimeConfigs;
-    getServerInstance<T extends TBunServerInstance | TNodeServerInstance = TBunServerInstance | TNodeServerInstance>(): T | undefined;
-    protected startBunModule(): Promise<unknown>;
-    protected startNodeModule(): Promise<unknown>;
-    start(): Promise<void>;
-    /** Post-stop hooks, then the server, then the datasources - closed even when the server fails to, so a stopped application holds no connection. */
-    stop(): Promise<void>;
-    /** Set once `installShutdownSignals` ran; holds the way back, so a second call is a no-op. */
-    protected shutdownSignals?: {
-        uninstall: () => void;
-    };
-    /**
-     * Stops the application on a signal (SIGTERM and SIGINT by default), then exits the process.
-     * Opt-in: nothing is installed until you call it, usually right after `start()`.
-     *
-     * - Calls `stop()` once. A second signal while it runs is ignored.
-     * - Exits 0 when `stop()` finishes, 1 when it throws or does not finish within `timeoutMs`.
-     * - Idempotent: calling it again returns the same uninstall function and adds no listener.
-     * - Returns an uninstall function that removes the listeners and the pending timeout.
-     */
-    installShutdownSignals(opts?: IShutdownSignalsOptions): () => void;
-    protected stopServer(): Promise<void>;
-}
-//# sourceMappingURL=server.d.ts.map

package/dist/base/applications/server.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../src/base/applications/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAItE,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAGxC,OAAO,KAAK,EACV,kBAAkB,EAClB,yBAAyB,EACzB,qBAAqB,EACrB,uBAAuB,EACvB,mBAAmB,EACpB,MAAM,UAAU,CAAC;AAElB,gTAAgT;AAChT,MAAM,MAAM,kBAAkB,GAAG,UAAU,CAAC,OAAO,GAAG,CAAC,KAAK,CAAC,CAAC;AAqC9D,sMAAsM;AACtM,8BAAsB,iBAAiB,CACrC,MAAM,SAAS,GAAG,GAAG,GAAG,EACxB,SAAS,SAAS,MAAM,GAAG,EAAE,EAC7B,QAAQ,SAAS,MAAM,GAAG,GAAG,CAE7B,SAAQ,eAAe,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,CACnD,YAAW,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,CAAC;IAE1D,mMAAmM;IACnM,SAAS,CAAC,OAAO,kDAA2B;IAC5C,SAAS,CAAC,cAAc,CAAC,EAAE,kBAAkB,GAAG,mBAAmB,CAAC;IAEpE,2LAA2L;IAC3L,UAAkB,OAAO,EAAE,yBAAyB,CAAC;IAErD;;;;OAIG;gBACS,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,yBAAyB,CAAA;KAAE;IAWtE,0IAA0I;cACvH,6BAA6B,IAAI,OAAO;IAI3D,yPAAyP;IAChP,cAAc,IAAI,MAAM;IAejC,aAAa,IAAI,MAAM;IAIvB,aAAa,IAAI,MAAM;IAIvB,gBAAgB;IAIhB,wHAAwH;IACxH,SAAS,CAAC,uBAAuB,IAAI,qBAAqB;IAQ1D,iBAAiB,CACf,CAAC,SAAS,kBAAkB,GAAG,mBAAmB,GAAG,kBAAkB,GAAG,mBAAmB,KAC1F,CAAC,GAAG,SAAS;IAIlB,SAAS,CAAC,cAAc;IA2CxB,SAAS,CAAC,eAAe;IAuDnB,KAAK;IA0BX,mJAAmJ;IAC7I,IAAI;IAUV,8FAA8F;IAC9F,SAAS,CAAC,eAAe,CAAC,EAAE;QAAE,SAAS,EAAE,MAAM,IAAI,CAAA;KAAE,CAAC;IAEtD;;;;;;;;OAQG;IACH,sBAAsB,CAAC,IAAI,GAAE,uBAA4B,GAAG,MAAM,IAAI;cAyEtD,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;CAoC5C"}

package/dist/base/applications/server.js

@@ -1,296 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ServerApplication = void 0;
-const ignis_kernel_1 = require("@venizia/ignis-kernel");
-const ignis_helpers_1 = require("@venizia/ignis-helpers");
-const core_1 = require("@venizia/ignis-helpers/core");
-const common_1 = require("@venizia/ignis-helpers/common");
-const node_fs_1 = require("node:fs");
-const node_path_1 = __importDefault(require("node:path"));
-const DEFAULT_SHUTDOWN_SIGNALS = ['SIGTERM', 'SIGINT'];
-const DEFAULT_SHUTDOWN_TIMEOUT_MS = 15_000;
-const DEFAULT_SERVER_HOST = 'localhost';
-const DEFAULT_SERVER_PORT = 3000;
-const MAX_SERVER_PORT = 65535;
-/**
- * The first candidate USABLE as a port. Rejection is on validity, never falsiness: `0` legitimately
- * asks the OS for an ephemeral port, and taking the first TRUTHY value instead let an unusable
- * `PORT` shadow a usable `APP_ENV_SERVER_PORT` - `PORT=abc APP_ENV_SERVER_PORT=8080` bound 3000, as
- * did Docker's legacy container-link form `PORT=tcp://172.17.0.5:8080`.
- */
-const resolveServerPort = (opts) => {
-    for (const candidate of opts.candidates) {
-        if (candidate === undefined || candidate === null) {
-            continue;
-        }
-        const normalized = typeof candidate === 'string' ? candidate.trim() : candidate;
-        if (normalized === '') {
-            continue;
-        }
-        const parsed = Number(normalized);
-        if (!Number.isInteger(parsed) || parsed < 0 || parsed > MAX_SERVER_PORT) {
-            continue;
-        }
-        return parsed;
-    }
-    return DEFAULT_SERVER_PORT;
-};
-/** Adds the listening server (`Bun.serve` / `@hono/node-server`) on top of `RestApplication` - the only layer that touches a socket, so it is the layer that stays out of the browser-pure kernel. */
-class ServerApplication extends ignis_kernel_1.RestApplication {
-    /**
-     * The address resolution the kernel deliberately does not do: `host` and `port` mean nothing to a
-     * host with no socket, and resolving them there silently configured every browser Worker with
-     * `localhost:3000`. Env is the fallback, explicit config always wins.
-     */
-    constructor(opts) {
-        super(opts);
-        /** Which runtime is underneath, and the socket once one is bound. Both live here, not on `RestApplication`: a browser Worker has neither, and `RuntimeModules.detect()` answers `'node'` there. */
-        this.runtime = common_1.RuntimeModules.detect();
-        this.configs.host =
-            [opts.config.host, process.env.HOST, process.env.APP_ENV_SERVER_HOST].find(Boolean) ??
-                DEFAULT_SERVER_HOST;
-        this.configs.port = resolveServerPort({
-            candidates: [opts.config.port, process.env.PORT, process.env.APP_ENV_SERVER_PORT],
-        });
-    }
-    /** Restores the pre-split default: a server-capable application installs `hono/context-storage` unless the caller opts out explicitly. */
-    getDefaultAsyncContextEnabled() {
-        return true;
-    }
-    /** `configs.projectRoot` wins, else the process cwd. The value is bound AND handed to `ModuleUtility`, so every peer lookup (optional modules, the gRPC adapter) resolves under it - a compiled binary sets it to where its `node_modules` really is. */
-    getProjectRoot() {
-        const projectRoot = this.configs.projectRoot ?? process.cwd();
-        if (this.configs.projectRoot && !(0, node_fs_1.existsSync)(node_path_1.default.join(projectRoot, 'node_modules'))) {
-            this.logger
-                .for(this.getProjectRoot.name)
-                .warn('configs.projectRoot has no node_modules | root: %s | optional peers will not resolve from it', projectRoot);
-        }
-        this.bind({ key: ignis_kernel_1.CoreBindings.APPLICATION_PROJECT_ROOT }).toValue(projectRoot);
-        ignis_helpers_1.ModuleUtility.setProjectRoot({ projectRoot });
-        return projectRoot;
-    }
-    getServerHost() {
-        return this.configs.host;
-    }
-    getServerPort() {
-        return this.configs.port;
-    }
-    getServerAddress() {
-        return `${this.getServerHost()}:${this.getServerPort()}`;
-    }
-    /** `configs.server` with unset keys dropped, so a missing option keeps Bun's default instead of passing `undefined`. */
-    getServerRuntimeOptions() {
-        const { idleTimeout, maxRequestBodySize } = this.configs.server ?? {};
-        return {
-            ...(idleTimeout === undefined ? {} : { idleTimeout }),
-            ...(maxRequestBodySize === undefined ? {} : { maxRequestBodySize }),
-        };
-    }
-    getServerInstance() {
-        return this.serverInstance;
-    }
-    startBunModule() {
-        return new Promise((resolve, reject) => {
-            if (this.runtime !== common_1.RuntimeModules.BUN) {
-                return reject((0, core_1.getError)({
-                    message: `[startBunModule] Invalid runtime to start server | runtime: ${this.runtime} | required: ${common_1.RuntimeModules.BUN}`,
-                }));
-            }
-            const port = this.getServerPort();
-            const host = this.getServerHost();
-            const server = this.getServer();
-            Promise.resolve(Bun.serve({
-                port,
-                hostname: host,
-                fetch: server.fetch,
-                ...this.getServerRuntimeOptions(),
-            }))
-                .then((rs) => {
-                this.serverInstance = rs;
-                this.configs.port = rs.port;
-                this.inspectRoutes();
-                this.logger
-                    .for(this.start.name)
-                    .info('Server STARTED | Address: %s', this.getServerAddress());
-                this.logger
-                    .for(this.start.name)
-                    .info('Log folder: %s', node_path_1.default.resolve(process.env.APP_ENV_LOGGER_FOLDER_PATH ?? '').toString());
-                resolve(rs);
-            })
-                .catch(reject);
-        });
-    }
-    startNodeModule() {
-        return new Promise((resolve, reject) => {
-            if (this.runtime !== common_1.RuntimeModules.NODE) {
-                return reject((0, core_1.getError)({
-                    message: `[startNodeModule] Invalid runtime to start server | runtime: ${this.runtime} | required: ${common_1.RuntimeModules.NODE}`,
-                }));
-            }
-            const port = this.getServerPort();
-            const host = this.getServerHost();
-            const server = this.getServer();
-            const ignored = Object.keys(this.getServerRuntimeOptions());
-            if (ignored.length > 0) {
-                this.logger
-                    .for(this.startNodeModule.name)
-                    .warn('configs.server is Bun-only | ignored on node: %s', ignored.join(', '));
-            }
-            import('@hono/node-server')
-                .then((module) => {
-                const { serve } = module;
-                // Resolve from the listening callback, not serve()'s synchronous return - only then is the socket bound and the OS-assigned port (config port `0`) known.
-                const rs = serve({ fetch: server.fetch, port, hostname: host }, (info) => {
-                    this.configs.port = info.port;
-                    this.inspectRoutes();
-                    this.logger
-                        .for(this.start.name)
-                        .info('Server STARTED | Address: %s | Info: %j', this.getServerAddress(), info);
-                    this.logger
-                        .for(this.start.name)
-                        .info('Log folder: %s', node_path_1.default.resolve(process.env.APP_ENV_LOGGER_FOLDER_PATH ?? '').toString());
-                    this.serverInstance = rs;
-                    resolve(rs);
-                });
-            })
-                .catch((error) => {
-                this.logger
-                    .for(this.start.name)
-                    .error('Failed to import @hono/node-server | Error: %s', error);
-                reject((0, core_1.getError)({
-                    message: `[start] @hono/node-server is required for Node.js runtime. Please install '@hono/node-server'`,
-                }));
-            });
-        });
-    }
-    async start() {
-        await this.initialize();
-        await this.setupMiddlewares();
-        const server = this.getServer();
-        server.route(this.configs.path.base, this.rootRouter);
-        switch (this.runtime) {
-            case common_1.RuntimeModules.BUN: {
-                await this.startBunModule();
-                break;
-            }
-            case common_1.RuntimeModules.NODE: {
-                await this.startNodeModule();
-                break;
-            }
-            default: {
-                throw (0, core_1.getError)({
-                    message: '[start] Invalid runtimeModule to start server instance!',
-                });
-            }
-        }
-        await this.executePostStartHooks();
-    }
-    /** Post-stop hooks, then the server, then the datasources - closed even when the server fails to, so a stopped application holds no connection. */
-    async stop() {
-        await this.executePostStopHooks();
-        try {
-            await this.stopServer();
-        }
-        finally {
-            await this.closeDataSources();
-        }
-    }
-    /**
-     * Stops the application on a signal (SIGTERM and SIGINT by default), then exits the process.
-     * Opt-in: nothing is installed until you call it, usually right after `start()`.
-     *
-     * - Calls `stop()` once. A second signal while it runs is ignored.
-     * - Exits 0 when `stop()` finishes, 1 when it throws or does not finish within `timeoutMs`.
-     * - Idempotent: calling it again returns the same uninstall function and adds no listener.
-     * - Returns an uninstall function that removes the listeners and the pending timeout.
-     */
-    installShutdownSignals(opts = {}) {
-        if (this.shutdownSignals) {
-            return this.shutdownSignals.uninstall;
-        }
-        const { signals = DEFAULT_SHUTDOWN_SIGNALS, timeoutMs = DEFAULT_SHUTDOWN_TIMEOUT_MS, exit = (code) => process.exit(code), } = opts;
-        if (!Number.isFinite(timeoutMs) || timeoutMs <= 0) {
-            throw (0, core_1.getError)({
-                message: `[installShutdownSignals] timeoutMs must be a positive number of milliseconds | value: ${String(timeoutMs)}`,
-            });
-        }
-        const log = this.logger.for(this.installShutdownSignals.name);
-        let isShuttingDown = false;
-        let timer;
-        const finish = (code) => {
-            clearTimeout(timer);
-            exit(code);
-        };
-        const onSignal = (signal) => {
-            if (isShuttingDown) {
-                log.warn('Signal %s ignored | shutdown already in progress', signal);
-                return;
-            }
-            isShuttingDown = true;
-            log.info('Signal %s received | stopping the application | timeout: %s ms', signal, timeoutMs);
-            timer = setTimeout(() => {
-                log.error('Shutdown did not finish within %s ms | forcing exit', timeoutMs);
-                exit(1);
-            }, timeoutMs);
-            this.stop().then(() => {
-                log.info('Application stopped | exiting');
-                finish(0);
-            }, (error) => {
-                log.error('Shutdown failed | error: %s', error instanceof Error ? error.message : String(error));
-                finish(1);
-            });
-        };
-        const listeners = signals.map((signal) => {
-            const listener = () => onSignal(signal);
-            process.on(signal, listener);
-            return { signal, listener };
-        });
-        const uninstall = () => {
-            clearTimeout(timer);
-            for (const { signal, listener } of listeners) {
-                process.off(signal, listener);
-            }
-            this.shutdownSignals = undefined;
-        };
-        this.shutdownSignals = { uninstall };
-        return uninstall;
-    }
-    async stopServer() {
-        const instance = this.serverInstance;
-        if (!instance) {
-            this.logger.for(this.stop.name).info('Server was not started | Nothing to stop');
-            return;
-        }
-        switch (this.runtime) {
-            case common_1.RuntimeModules.BUN: {
-                await instance.stop();
-                break;
-            }
-            case common_1.RuntimeModules.NODE: {
-                // `close()` is callback-based: without this bridge stop() resolves while the socket is still bound, so an immediate restart races the previous listener.
-                await new Promise((resolve, reject) => {
-                    instance.close((error) => {
-                        if (error) {
-                            reject(error);
-                            return;
-                        }
-                        resolve();
-                    });
-                });
-                break;
-            }
-            default: {
-                throw (0, core_1.getError)({
-                    message: '[stop] Invalid runtimeModule to stop server instance!',
-                });
-            }
-        }
-        this.serverInstance = undefined;
-        this.logger.for(this.stop.name).info('Server STOPPED');
-    }
-}
-exports.ServerApplication = ServerApplication;
-//# sourceMappingURL=server.js.map

package/dist/base/applications/server.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"server.js","sourceRoot":"","sources":["../../../src/base/applications/server.ts"],"names":[],"mappings":"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","sourcesContent":["import { CoreBindings, RestApplication } from '@venizia/ignis-kernel';\nimport { ModuleUtility } from '@venizia/ignis-helpers';\nimport { getError } from '@venizia/ignis-helpers/core';\nimport { RuntimeModules } from '@venizia/ignis-helpers/common';\nimport type { Env, Schema } from 'hono';\nimport { existsSync } from 'node:fs';\nimport path from 'node:path';\nimport type {\n  IServerApplication,\n  IServerApplicationConfigs,\n  IServerRuntimeConfigs,\n  IShutdownSignalsOptions,\n  TNodeServerInstance,\n} from './common';\n\n/** Lives here, not in the kernel: `Bun.serve` resolves only through `@types/bun`, and emitting `Bun` into the kernel's published `.d.ts` would force that dependency on every browser consumer of `@venizia/ignis-kernel`. This package legitimately has Bun types - it is the layer that calls `Bun.serve`. */\nexport type TBunServerInstance = ReturnType<typeof Bun.serve>;\n\nconst DEFAULT_SHUTDOWN_SIGNALS: NodeJS.Signals[] = ['SIGTERM', 'SIGINT'];\nconst DEFAULT_SHUTDOWN_TIMEOUT_MS = 15_000;\n\nconst DEFAULT_SERVER_HOST = 'localhost';\nconst DEFAULT_SERVER_PORT = 3000;\nconst MAX_SERVER_PORT = 65535;\n\n/**\n * The first candidate USABLE as a port. Rejection is on validity, never falsiness: `0` legitimately\n * asks the OS for an ephemeral port, and taking the first TRUTHY value instead let an unusable\n * `PORT` shadow a usable `APP_ENV_SERVER_PORT` - `PORT=abc APP_ENV_SERVER_PORT=8080` bound 3000, as\n * did Docker's legacy container-link form `PORT=tcp://172.17.0.5:8080`.\n */\nconst resolveServerPort = (opts: { candidates: Array<number | string | undefined> }): number => {\n  for (const candidate of opts.candidates) {\n    if (candidate === undefined || candidate === null) {\n      continue;\n    }\n\n    const normalized = typeof candidate === 'string' ? candidate.trim() : candidate;\n    if (normalized === '') {\n      continue;\n    }\n\n    const parsed = Number(normalized);\n    if (!Number.isInteger(parsed) || parsed < 0 || parsed > MAX_SERVER_PORT) {\n      continue;\n    }\n\n    return parsed;\n  }\n\n  return DEFAULT_SERVER_PORT;\n};\n\n/** Adds the listening server (`Bun.serve` / `@hono/node-server`) on top of `RestApplication` - the only layer that touches a socket, so it is the layer that stays out of the browser-pure kernel. */\nexport abstract class ServerApplication<\n  AppEnv extends Env = Env,\n  AppSchema extends Schema = {},\n  BasePath extends string = '/',\n>\n  extends RestApplication<AppEnv, AppSchema, BasePath>\n  implements IServerApplication<AppEnv, AppSchema, BasePath>\n{\n  /** Which runtime is underneath, and the socket once one is bound. Both live here, not on `RestApplication`: a browser Worker has neither, and `RuntimeModules.detect()` answers `'node'` there. */\n  protected runtime = RuntimeModules.detect();\n  protected serverInstance?: TBunServerInstance | TNodeServerInstance;\n\n  /** Widened by this layer, which is the only one that binds a socket. Assigned by the base constructor - `declare` so no field initializer runs here and overwrites it with `undefined`. */\n  declare protected configs: IServerApplicationConfigs;\n\n  /**\n   * The address resolution the kernel deliberately does not do: `host` and `port` mean nothing to a\n   * host with no socket, and resolving them there silently configured every browser Worker with\n   * `localhost:3000`. Env is the fallback, explicit config always wins.\n   */\n  constructor(opts: { scope: string; config: IServerApplicationConfigs }) {\n    super(opts);\n\n    this.configs.host =\n      [opts.config.host, process.env.HOST, process.env.APP_ENV_SERVER_HOST].find(Boolean) ??\n      DEFAULT_SERVER_HOST;\n    this.configs.port = resolveServerPort({\n      candidates: [opts.config.port, process.env.PORT, process.env.APP_ENV_SERVER_PORT],\n    });\n  }\n\n  /** Restores the pre-split default: a server-capable application installs `hono/context-storage` unless the caller opts out explicitly. */\n  protected override getDefaultAsyncContextEnabled(): boolean {\n    return true;\n  }\n\n  /** `configs.projectRoot` wins, else the process cwd. The value is bound AND handed to `ModuleUtility`, so every peer lookup (optional modules, the gRPC adapter) resolves under it - a compiled binary sets it to where its `node_modules` really is. */\n  override getProjectRoot(): string {\n    const projectRoot = this.configs.projectRoot ?? process.cwd();\n    if (this.configs.projectRoot && !existsSync(path.join(projectRoot, 'node_modules'))) {\n      this.logger\n        .for(this.getProjectRoot.name)\n        .warn(\n          'configs.projectRoot has no node_modules | root: %s | optional peers will not resolve from it',\n          projectRoot,\n        );\n    }\n    this.bind<string>({ key: CoreBindings.APPLICATION_PROJECT_ROOT }).toValue(projectRoot);\n    ModuleUtility.setProjectRoot({ projectRoot });\n    return projectRoot;\n  }\n\n  getServerHost(): string {\n    return this.configs.host!;\n  }\n\n  getServerPort(): number {\n    return this.configs.port!;\n  }\n\n  getServerAddress() {\n    return `${this.getServerHost()}:${this.getServerPort()}`;\n  }\n\n  /** `configs.server` with unset keys dropped, so a missing option keeps Bun's default instead of passing `undefined`. */\n  protected getServerRuntimeOptions(): IServerRuntimeConfigs {\n    const { idleTimeout, maxRequestBodySize } = this.configs.server ?? {};\n    return {\n      ...(idleTimeout === undefined ? {} : { idleTimeout }),\n      ...(maxRequestBodySize === undefined ? {} : { maxRequestBodySize }),\n    };\n  }\n\n  getServerInstance<\n    T extends TBunServerInstance | TNodeServerInstance = TBunServerInstance | TNodeServerInstance,\n  >(): T | undefined {\n    return this.serverInstance as T | undefined;\n  }\n\n  protected startBunModule() {\n    return new Promise((resolve, reject) => {\n      if (this.runtime !== RuntimeModules.BUN) {\n        return reject(\n          getError({\n            message: `[startBunModule] Invalid runtime to start server | runtime: ${this.runtime} | required: ${RuntimeModules.BUN}`,\n          }),\n        );\n      }\n\n      const port = this.getServerPort();\n      const host = this.getServerHost();\n      const server = this.getServer();\n\n      Promise.resolve(\n        Bun.serve({\n          port,\n          hostname: host,\n          fetch: server.fetch,\n          ...this.getServerRuntimeOptions(),\n        }),\n      )\n        .then((rs) => {\n          this.serverInstance = rs;\n          this.configs.port = rs.port;\n          this.inspectRoutes();\n\n          this.logger\n            .for(this.start.name)\n            .info('Server STARTED | Address: %s', this.getServerAddress());\n          this.logger\n            .for(this.start.name)\n            .info(\n              'Log folder: %s',\n              path.resolve(process.env.APP_ENV_LOGGER_FOLDER_PATH ?? '').toString(),\n            );\n\n          resolve(rs);\n        })\n        .catch(reject);\n    });\n  }\n\n  protected startNodeModule() {\n    return new Promise((resolve, reject) => {\n      if (this.runtime !== RuntimeModules.NODE) {\n        return reject(\n          getError({\n            message: `[startNodeModule] Invalid runtime to start server | runtime: ${this.runtime} | required: ${RuntimeModules.NODE}`,\n          }),\n        );\n      }\n\n      const port = this.getServerPort();\n      const host = this.getServerHost();\n      const server = this.getServer();\n      const ignored = Object.keys(this.getServerRuntimeOptions());\n      if (ignored.length > 0) {\n        this.logger\n          .for(this.startNodeModule.name)\n          .warn('configs.server is Bun-only | ignored on node: %s', ignored.join(', '));\n      }\n\n      import('@hono/node-server')\n        .then((module) => {\n          const { serve } = module;\n\n          // Resolve from the listening callback, not serve()'s synchronous return - only then is the socket bound and the OS-assigned port (config port `0`) known.\n          const rs = serve({ fetch: server.fetch, port, hostname: host }, (info) => {\n            this.configs.port = info.port;\n            this.inspectRoutes();\n            this.logger\n              .for(this.start.name)\n              .info('Server STARTED | Address: %s | Info: %j', this.getServerAddress(), info);\n            this.logger\n              .for(this.start.name)\n              .info(\n                'Log folder: %s',\n                path.resolve(process.env.APP_ENV_LOGGER_FOLDER_PATH ?? '').toString(),\n              );\n\n            this.serverInstance = rs;\n            resolve(rs);\n          });\n        })\n        .catch((error) => {\n          this.logger\n            .for(this.start.name)\n            .error('Failed to import @hono/node-server | Error: %s', error);\n          reject(\n            getError({\n              message: `[start] @hono/node-server is required for Node.js runtime. Please install '@hono/node-server'`,\n            }),\n          );\n        });\n    });\n  }\n\n  async start() {\n    await this.initialize();\n    await this.setupMiddlewares();\n\n    const server = this.getServer();\n    server.route(this.configs.path.base, this.rootRouter);\n\n    switch (this.runtime) {\n      case RuntimeModules.BUN: {\n        await this.startBunModule();\n        break;\n      }\n      case RuntimeModules.NODE: {\n        await this.startNodeModule();\n        break;\n      }\n      default: {\n        throw getError({\n          message: '[start] Invalid runtimeModule to start server instance!',\n        });\n      }\n    }\n\n    await this.executePostStartHooks();\n  }\n\n  /** Post-stop hooks, then the server, then the datasources - closed even when the server fails to, so a stopped application holds no connection. */\n  async stop() {\n    await this.executePostStopHooks();\n\n    try {\n      await this.stopServer();\n    } finally {\n      await this.closeDataSources();\n    }\n  }\n\n  /** Set once `installShutdownSignals` ran; holds the way back, so a second call is a no-op. */\n  protected shutdownSignals?: { uninstall: () => void };\n\n  /**\n   * Stops the application on a signal (SIGTERM and SIGINT by default), then exits the process.\n   * Opt-in: nothing is installed until you call it, usually right after `start()`.\n   *\n   * - Calls `stop()` once. A second signal while it runs is ignored.\n   * - Exits 0 when `stop()` finishes, 1 when it throws or does not finish within `timeoutMs`.\n   * - Idempotent: calling it again returns the same uninstall function and adds no listener.\n   * - Returns an uninstall function that removes the listeners and the pending timeout.\n   */\n  installShutdownSignals(opts: IShutdownSignalsOptions = {}): () => void {\n    if (this.shutdownSignals) {\n      return this.shutdownSignals.uninstall;\n    }\n\n    const {\n      signals = DEFAULT_SHUTDOWN_SIGNALS,\n      timeoutMs = DEFAULT_SHUTDOWN_TIMEOUT_MS,\n      exit = (code: number) => process.exit(code),\n    } = opts;\n\n    if (!Number.isFinite(timeoutMs) || timeoutMs <= 0) {\n      throw getError({\n        message: `[installShutdownSignals] timeoutMs must be a positive number of milliseconds | value: ${String(timeoutMs)}`,\n      });\n    }\n\n    const log = this.logger.for(this.installShutdownSignals.name);\n    let isShuttingDown = false;\n    let timer: ReturnType<typeof setTimeout> | undefined;\n\n    const finish = (code: number) => {\n      clearTimeout(timer);\n      exit(code);\n    };\n\n    const onSignal = (signal: NodeJS.Signals) => {\n      if (isShuttingDown) {\n        log.warn('Signal %s ignored | shutdown already in progress', signal);\n        return;\n      }\n\n      isShuttingDown = true;\n      log.info('Signal %s received | stopping the application | timeout: %s ms', signal, timeoutMs);\n\n      timer = setTimeout(() => {\n        log.error('Shutdown did not finish within %s ms | forcing exit', timeoutMs);\n        exit(1);\n      }, timeoutMs);\n\n      this.stop().then(\n        () => {\n          log.info('Application stopped | exiting');\n          finish(0);\n        },\n        (error: unknown) => {\n          log.error(\n            'Shutdown failed | error: %s',\n            error instanceof Error ? error.message : String(error),\n          );\n          finish(1);\n        },\n      );\n    };\n\n    const listeners = signals.map((signal) => {\n      const listener = () => onSignal(signal);\n      process.on(signal, listener);\n      return { signal, listener };\n    });\n\n    const uninstall = () => {\n      clearTimeout(timer);\n      for (const { signal, listener } of listeners) {\n        process.off(signal, listener);\n      }\n      this.shutdownSignals = undefined;\n    };\n\n    this.shutdownSignals = { uninstall };\n    return uninstall;\n  }\n\n  protected async stopServer(): Promise<void> {\n    const instance = this.serverInstance;\n    if (!instance) {\n      this.logger.for(this.stop.name).info('Server was not started | Nothing to stop');\n      return;\n    }\n\n    switch (this.runtime) {\n      case RuntimeModules.BUN: {\n        await instance.stop();\n        break;\n      }\n      case RuntimeModules.NODE: {\n        // `close()` is callback-based: without this bridge stop() resolves while the socket is still bound, so an immediate restart races the previous listener.\n        await new Promise<void>((resolve, reject) => {\n          instance.close((error?: Error) => {\n            if (error) {\n              reject(error);\n              return;\n            }\n\n            resolve();\n          });\n        });\n        break;\n      }\n      default: {\n        throw getError({\n          message: '[stop] Invalid runtimeModule to stop server instance!',\n        });\n      }\n    }\n\n    this.serverInstance = undefined;\n    this.logger.for(this.stop.name).info('Server STOPPED');\n  }\n}\n"]}

package/dist/base/controllers/grpc/abstract.d.ts

@@ -1,48 +0,0 @@
-import type { ConnectRouter } from '@connectrpc/connect';
-import type { ValueOrPromise } from '@venizia/ignis-helpers/common';
-import { BaseHelper } from '@venizia/ignis-helpers/core';
-import type { IRpcMetadata } from '@venizia/ignis-kernel';
-import type { Env, Schema } from 'hono';
-import { Hono } from 'hono';
-import type { IConnectRpcModule, IGrpcBindRouteOptions, IGrpcController, IGrpcControllerOptions, IGrpcDefineRouteOptions, IRpcRegistration, TRpcHandler, TRpcMiddleware } from './common/types';
-/** Abstract base class for gRPC controllers, providing RPC registration and ConnectRPC integration. */
-export declare abstract class AbstractGrpcController<RouteEnv extends Env = Env, RouteSchema extends Schema = {}, BasePath extends string = '/', ServiceType = Parameters<ConnectRouter['service']>[0], ConfigurableOptions extends object = {}> extends BaseHelper implements IGrpcController<RouteEnv, RouteSchema, BasePath, ServiceType, ConfigurableOptions> {
-    isConfigured: boolean;
-    definitions: Record<string, IRpcRegistration<RouteEnv>>;
-    /** ConnectRPC service definition from @controller metadata. */
-    service: ServiceType;
-    path: string;
-    basePath: string;
-    /** Assigned by GrpcComponent from its options, before configure(). Absent means the adapter resolves the peer itself. */
-    connectRpcModule?: IConnectRpcModule;
-    /** ConnectRPC interceptors, assigned by GrpcComponent from its options before configure(). Applied to every RPC this controller registers. */
-    interceptors?: unknown[];
-    router: Hono<RouteEnv, RouteSchema, BasePath>;
-    constructor(opts: IGrpcControllerOptions);
-    /** Returns the per-controller sub-router. */
-    getRouter(): Hono<RouteEnv, RouteSchema, BasePath>;
-    /** Builds pre-built auth middleware from RPC config (symmetric with REST's buildRouteMiddlewares). */
-    buildRpcMiddlewares(opts: {
-        configs: IRpcMetadata;
-    }): TRpcMiddleware<RouteEnv>[];
-    /** Processes RPC config (symmetric with REST's getRouteConfigs). Returns configs as-is. */
-    getRouteConfigs(opts: {
-        configs: IRpcMetadata;
-    }): IRpcMetadata;
-    /** Registers RPC methods defined via @rpc/@unary/@serverStream/etc. decorators from the metadata registry. */
-    registerRpcsFromRegistry(): void;
-    /** Configures the controller by binding all RPCs, registering decorator-based RPCs, and mounting the adapter. Idempotent. */
-    configure(opts?: ConfigurableOptions): Promise<void>;
-    /** Override to register RPCs using bindRoute or defineRoute. */
-    abstract binding(): ValueOrPromise<void>;
-    /** Creates a fluent binding for registering an RPC (call .to() to attach handler). */
-    abstract bindRoute(opts: {
-        configs: IRpcMetadata;
-    }): IGrpcBindRouteOptions<RouteEnv>;
-    /** Defines and registers an RPC with its handler in a single call. */
-    abstract defineRoute(opts: {
-        configs: IRpcMetadata;
-        handler: TRpcHandler<unknown, unknown, RouteEnv>;
-    }): IGrpcDefineRouteOptions;
-}
-//# sourceMappingURL=abstract.d.ts.map

package/dist/base/controllers/grpc/abstract.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"abstract.d.ts","sourceRoot":"","sources":["../../../../src/base/controllers/grpc/abstract.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,EAAE,UAAU,EAAY,MAAM,6BAA6B,CAAC;AACnE,OAAO,KAAK,EAAsB,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAS9E,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AACxC,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAE5B,OAAO,KAAK,EACV,iBAAiB,EACjB,qBAAqB,EACrB,eAAe,EACf,sBAAsB,EACtB,uBAAuB,EACvB,gBAAgB,EAChB,WAAW,EACX,cAAc,EACf,MAAM,gBAAgB,CAAC;AAExB,uGAAuG;AACvG,8BAAsB,sBAAsB,CAC1C,QAAQ,SAAS,GAAG,GAAG,GAAG,EAC1B,WAAW,SAAS,MAAM,GAAG,EAAE,EAC/B,QAAQ,SAAS,MAAM,GAAG,GAAG,EAC7B,WAAW,GAAG,UAAU,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,EACrD,mBAAmB,SAAS,MAAM,GAAG,EAAE,CAEvC,SAAQ,UACR,YAAW,eAAe,CAAC,QAAQ,EAAE,WAAW,EAAE,QAAQ,EAAE,WAAW,EAAE,mBAAmB,CAAC;IAE7F,YAAY,UAAS;IAErB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,QAAQ,CAAC,CAAC,CAAM;IAE7D,+DAA+D;IAC/D,OAAO,EAAE,WAAW,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAM;IACtB,yHAAyH;IACzH,gBAAgB,CAAC,EAAE,iBAAiB,CAAC;IACrC,8IAA8I;IAC9I,YAAY,CAAC,EAAE,OAAO,EAAE,CAAC;IACzB,MAAM,EAAE,IAAI,CAAC,QAAQ,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC;gBAElC,IAAI,EAAE,sBAAsB;IA4BxC,6CAA6C;IAC7C,SAAS;IAIT,sGAAsG;IACtG,mBAAmB,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,YAAY,CAAA;KAAE,GAAG,cAAc,CAAC,QAAQ,CAAC,EAAE;IAqChF,2FAA2F;IAC3F,eAAe,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,YAAY,CAAA;KAAE,GAAG,YAAY;IAI9D,8GAA8G;IAC9G,wBAAwB,IAAI,IAAI;IAkChC,6HAA6H;IACvH,SAAS,CAAC,IAAI,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IA4B1D,gEAAgE;IAChE,QAAQ,CAAC,OAAO,IAAI,cAAc,CAAC,IAAI,CAAC;IAExC,sFAAsF;IACtF,QAAQ,CAAC,SAAS,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,YAAY,CAAA;KAAE,GAAG,qBAAqB,CAAC,QAAQ,CAAC;IAEpF,sEAAsE;IACtE,QAAQ,CAAC,WAAW,CAAC,IAAI,EAAE;QACzB,OAAO,EAAE,YAAY,CAAC;QACtB,OAAO,EAAE,WAAW,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;KAClD,GAAG,uBAAuB;CAC5B"}

package/dist/base/controllers/grpc/abstract.js

@@ -1,121 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.AbstractGrpcController = void 0;
-const core_1 = require("@venizia/ignis-helpers/core");
-const ignis_kernel_1 = require("@venizia/ignis-kernel");
-const hono_1 = require("hono");
-const adapter_1 = require("./adapter");
-/** Abstract base class for gRPC controllers, providing RPC registration and ConnectRPC integration. */
-class AbstractGrpcController extends core_1.BaseHelper {
-    constructor(opts) {
-        super(opts);
-        this.isConfigured = false;
-        this.definitions = {};
-        this.basePath = '';
-        const decoratorMetadata = ignis_kernel_1.MetadataRegistry.getInstance().getControllerMetadata({
-            target: new.target,
-        });
-        const resolvedPath = decoratorMetadata?.path ?? opts.path;
-        if (!resolvedPath) {
-            throw (0, core_1.getError)({
-                message: `[${new.target.name}] Controller path is required. Provide path via @controller decorator or constructor options.`,
-            });
-        }
-        this.path = resolvedPath;
-        this.router = new hono_1.Hono();
-        if (decoratorMetadata?.transport === ignis_kernel_1.ControllerTransports.GRPC && decoratorMetadata.service) {
-            // Decorator metadata stores `service` as `unknown`; ServiceType is this class's own generic, resolved only by convention at the decorator site.
-            this.service = decoratorMetadata.service;
-        }
-        else {
-            // ServiceType is unconstrained (no `extends` bound), so `undefined` cannot be proven to overlap it - this is the "not yet resolved" sentinel until binding() configures it.
-            this.service = undefined;
-        }
-    }
-    /** Returns the per-controller sub-router. */
-    getRouter() {
-        return this.router;
-    }
-    /** Builds pre-built auth middleware from RPC config (symmetric with REST's buildRouteMiddlewares). */
-    buildRpcMiddlewares(opts) {
-        const { configs } = opts;
-        const mws = [];
-        if (configs.authenticate) {
-            const { strategies = [], mode = ignis_kernel_1.AuthenticationModes.ANY } = configs.authenticate;
-            // Same boot-time guard the REST controller applies. Fixing only REST would leave every RPC
-            // with a misspelled strategy name silently unreachable.
-            ignis_kernel_1.AuthenticationStrategyRegistry.getInstance().reportUnregistered({
-                names: strategies,
-                scope: this.constructor.name,
-            });
-            if (strategies.length > 0) {
-                const authMw = (0, ignis_kernel_1.authenticate)({ strategies, mode });
-                // authMw is a Hono MiddlewareHandler built for raw Context<Env>; TRouteContext is a lightweight custom shape (different `json`/`req.valid` signatures), not a subtype - genuinely different context types bridged here.
-                mws.push((context, next) => authMw(context, next));
-            }
-        }
-        // Inject authorize middleware AFTER authenticate
-        if (configs.authorize) {
-            const specs = Array.isArray(configs.authorize)
-                ? configs.authorize
-                : [configs.authorize];
-            for (const spec of specs) {
-                const authzMw = (0, ignis_kernel_1.authorize)({ spec });
-                // Same TRouteContext-vs-Context<Env> bridge as authMw above.
-                mws.push((context, next) => authzMw(context, next));
-            }
-        }
-        return mws;
-    }
-    /** Processes RPC config (symmetric with REST's getRouteConfigs). Returns configs as-is. */
-    getRouteConfigs(opts) {
-        return opts.configs;
-    }
-    /** Registers RPC methods defined via @rpc/@unary/@serverStream/etc. decorators from the metadata registry. */
-    registerRpcsFromRegistry() {
-        const rpcs = ignis_kernel_1.MetadataRegistry.getInstance().getRpcs({
-            target: Object.getPrototypeOf(this),
-        });
-        if (!rpcs?.size) {
-            return;
-        }
-        const logger = this.logger.for(this.registerRpcsFromRegistry.name);
-        for (const [methodName, rpcMetadata] of rpcs) {
-            // Dynamic dispatch by decorator-recorded method name - the controller class has no static index signature, so this read cannot be typed narrower than `unknown`.
-            const handler = this[methodName];
-            if (typeof handler !== 'function') {
-                logger.warn('RPC method "%s" not found on controller', String(methodName));
-                continue;
-            }
-            const configs = this.getRouteConfigs({ configs: rpcMetadata });
-            this.bindRoute({ configs }).to({
-                handler: handler.bind(this),
-            });
-            logger.debug('Registered RPC | name: %s | method: %s | type: %s', rpcMetadata.name, String(methodName), rpcMetadata.method);
-        }
-    }
-    /** Configures the controller by binding all RPCs, registering decorator-based RPCs, and mounting the adapter. Idempotent. */
-    async configure(opts) {
-        if (this.isConfigured) {
-            return;
-        }
-        const t = performance.now();
-        const logger = this.logger.for(this.configure.name);
-        logger.info('START | Binding gRPC controller | Options: %j', opts ?? {});
-        await this.binding();
-        this.registerRpcsFromRegistry();
-        const adapter = await adapter_1.GrpcRequestAdapter.build({
-            controller: this,
-            module: this.connectRpcModule,
-            interceptors: this.interceptors,
-        });
-        this.router.use('*', adapter.middleware);
-        if (adapter.paths.length > 0) {
-            logger.debug('Adapter paths: %j', adapter.paths);
-        }
-        this.isConfigured = true;
-        logger.info('DONE | Binding gRPC controller | Took: %s (ms)', performance.now() - t);
-    }
-}
-exports.AbstractGrpcController = AbstractGrpcController;
-//# sourceMappingURL=abstract.js.map

package/dist/base/controllers/grpc/abstract.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"abstract.js","sourceRoot":"","sources":["../../../../src/base/controllers/grpc/abstract.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ConnectRouter } from '@connectrpc/connect';\nimport type { ValueOrPromise } from '@venizia/ignis-helpers/common';\nimport { BaseHelper, getError } from '@venizia/ignis-helpers/core';\nimport type { IAuthorizationSpec, IRpcMetadata } from '@venizia/ignis-kernel';\nimport {\n  authenticate as authenticateFn,\n  AuthenticationModes,\n  AuthenticationStrategyRegistry,\n  authorize as authorizeFn,\n  ControllerTransports,\n  MetadataRegistry,\n} from '@venizia/ignis-kernel';\nimport type { Env, Schema } from 'hono';\nimport { Hono } from 'hono';\nimport { GrpcRequestAdapter } from './adapter';\nimport type {\n  IConnectRpcModule,\n  IGrpcBindRouteOptions,\n  IGrpcController,\n  IGrpcControllerOptions,\n  IGrpcDefineRouteOptions,\n  IRpcRegistration,\n  TRpcHandler,\n  TRpcMiddleware,\n} from './common/types';\n\n/** Abstract base class for gRPC controllers, providing RPC registration and ConnectRPC integration. */\nexport abstract class AbstractGrpcController<\n  RouteEnv extends Env = Env,\n  RouteSchema extends Schema = {},\n  BasePath extends string = '/',\n  ServiceType = Parameters<ConnectRouter['service']>[0],\n  ConfigurableOptions extends object = {},\n>\n  extends BaseHelper\n  implements IGrpcController<RouteEnv, RouteSchema, BasePath, ServiceType, ConfigurableOptions>\n{\n  isConfigured = false;\n\n  definitions: Record<string, IRpcRegistration<RouteEnv>> = {};\n\n  /** ConnectRPC service definition from @controller metadata. */\n  service: ServiceType;\n  path: string;\n  basePath: string = '';\n  /** Assigned by GrpcComponent from its options, before configure(). Absent means the adapter resolves the peer itself. */\n  connectRpcModule?: IConnectRpcModule;\n  /** ConnectRPC interceptors, assigned by GrpcComponent from its options before configure(). Applied to every RPC this controller registers. */\n  interceptors?: unknown[];\n  router: Hono<RouteEnv, RouteSchema, BasePath>;\n\n  constructor(opts: IGrpcControllerOptions) {\n    super(opts);\n\n    const decoratorMetadata = MetadataRegistry.getInstance().getControllerMetadata({\n      target: new.target,\n    });\n\n    const resolvedPath = decoratorMetadata?.path ?? opts.path;\n\n    if (!resolvedPath) {\n      throw getError({\n        message: `[${new.target.name}] Controller path is required. Provide path via @controller decorator or constructor options.`,\n      });\n    }\n\n    this.path = resolvedPath;\n\n    this.router = new Hono<RouteEnv, RouteSchema, BasePath>();\n\n    if (decoratorMetadata?.transport === ControllerTransports.GRPC && decoratorMetadata.service) {\n      // Decorator metadata stores `service` as `unknown`; ServiceType is this class's own generic, resolved only by convention at the decorator site.\n      this.service = decoratorMetadata.service as ServiceType;\n    } else {\n      // ServiceType is unconstrained (no `extends` bound), so `undefined` cannot be proven to overlap it - this is the \"not yet resolved\" sentinel until binding() configures it.\n      this.service = undefined as ServiceType;\n    }\n  }\n\n  /** Returns the per-controller sub-router. */\n  getRouter() {\n    return this.router;\n  }\n\n  /** Builds pre-built auth middleware from RPC config (symmetric with REST's buildRouteMiddlewares). */\n  buildRpcMiddlewares(opts: { configs: IRpcMetadata }): TRpcMiddleware<RouteEnv>[] {\n    const { configs } = opts;\n    const mws: TRpcMiddleware<RouteEnv>[] = [];\n\n    if (configs.authenticate) {\n      const { strategies = [], mode = AuthenticationModes.ANY } = configs.authenticate;\n\n      // Same boot-time guard the REST controller applies. Fixing only REST would leave every RPC\n      // with a misspelled strategy name silently unreachable.\n      AuthenticationStrategyRegistry.getInstance().reportUnregistered({\n        names: strategies,\n        scope: this.constructor.name,\n      });\n\n      if (strategies.length > 0) {\n        const authMw = authenticateFn({ strategies, mode });\n\n        // authMw is a Hono MiddlewareHandler built for raw Context<Env>; TRouteContext is a lightweight custom shape (different `json`/`req.valid` signatures), not a subtype - genuinely different context types bridged here.\n        mws.push((context, next) => authMw(context as any, next));\n      }\n    }\n\n    // Inject authorize middleware AFTER authenticate\n    if (configs.authorize) {\n      const specs: IAuthorizationSpec[] = Array.isArray(configs.authorize)\n        ? configs.authorize\n        : [configs.authorize];\n      for (const spec of specs) {\n        const authzMw = authorizeFn({ spec });\n        // Same TRouteContext-vs-Context<Env> bridge as authMw above.\n        mws.push((context, next) => authzMw(context as any, next));\n      }\n    }\n\n    return mws;\n  }\n\n  /** Processes RPC config (symmetric with REST's getRouteConfigs). Returns configs as-is. */\n  getRouteConfigs(opts: { configs: IRpcMetadata }): IRpcMetadata {\n    return opts.configs;\n  }\n\n  /** Registers RPC methods defined via @rpc/@unary/@serverStream/etc. decorators from the metadata registry. */\n  registerRpcsFromRegistry(): void {\n    const rpcs = MetadataRegistry.getInstance().getRpcs({\n      target: Object.getPrototypeOf(this),\n    });\n\n    if (!rpcs?.size) {\n      return;\n    }\n\n    const logger = this.logger.for(this.registerRpcsFromRegistry.name);\n\n    for (const [methodName, rpcMetadata] of rpcs) {\n      // Dynamic dispatch by decorator-recorded method name - the controller class has no static index signature, so this read cannot be typed narrower than `unknown`.\n      const handler = (this as Record<string | symbol, unknown>)[methodName];\n      if (typeof handler !== 'function') {\n        logger.warn('RPC method \"%s\" not found on controller', String(methodName));\n        continue;\n      }\n\n      const configs = this.getRouteConfigs({ configs: rpcMetadata });\n\n      this.bindRoute({ configs }).to({\n        handler: (handler as TRpcHandler<unknown, unknown, RouteEnv>).bind(this),\n      });\n\n      logger.debug(\n        'Registered RPC | name: %s | method: %s | type: %s',\n        rpcMetadata.name,\n        String(methodName),\n        rpcMetadata.method,\n      );\n    }\n  }\n\n  /** Configures the controller by binding all RPCs, registering decorator-based RPCs, and mounting the adapter. Idempotent. */\n  async configure(opts?: ConfigurableOptions): Promise<void> {\n    if (this.isConfigured) {\n      return;\n    }\n\n    const t = performance.now();\n    const logger = this.logger.for(this.configure.name);\n\n    logger.info('START | Binding gRPC controller | Options: %j', opts ?? {});\n\n    await this.binding();\n    this.registerRpcsFromRegistry();\n\n    const adapter = await GrpcRequestAdapter.build({\n      controller: this,\n      module: this.connectRpcModule,\n      interceptors: this.interceptors,\n    });\n    this.router.use('*', adapter.middleware);\n\n    if (adapter.paths.length > 0) {\n      logger.debug('Adapter paths: %j', adapter.paths);\n    }\n\n    this.isConfigured = true;\n    logger.info('DONE | Binding gRPC controller | Took: %s (ms)', performance.now() - t);\n  }\n\n  /** Override to register RPCs using bindRoute or defineRoute. */\n  abstract binding(): ValueOrPromise<void>;\n\n  /** Creates a fluent binding for registering an RPC (call .to() to attach handler). */\n  abstract bindRoute(opts: { configs: IRpcMetadata }): IGrpcBindRouteOptions<RouteEnv>;\n\n  /** Defines and registers an RPC with its handler in a single call. */\n  abstract defineRoute(opts: {\n    configs: IRpcMetadata;\n    handler: TRpcHandler<unknown, unknown, RouteEnv>;\n  }): IGrpcDefineRouteOptions;\n}\n"]}

package/dist/base/controllers/grpc/adapter.d.ts

@@ -1,26 +0,0 @@
-import type { ConnectRouter } from '@connectrpc/connect';
-import { BaseHelper } from '@venizia/ignis-helpers/core';
-import type { Env, Schema } from 'hono';
-import type { AbstractGrpcController } from './abstract';
-import type { IConnectAdapterResult, IConnectRpcModule } from './common/types';
-/** Bridges IGNIS gRPC controllers with ConnectRPC: loads the peer deps via createRequire, wraps handlers into ConnectRPC's signature, dispatches through a Hono middleware, and isolates request-scoped context with AsyncLocalStorage. */
-export declare class GrpcRequestAdapter<RouteEnv extends Env = Env, RouteSchema extends Schema = {}, BasePath extends string = '/', ServiceType = Parameters<ConnectRouter['service']>[0], ConfigurableOptions extends object = {}> extends BaseHelper {
-    private createConnectRouter;
-    private protocol;
-    private controller;
-    private interceptors?;
-    private constructor();
-    /** Wraps IGNIS RPC registrations into ConnectRPC's (request, context) => response signature. */
-    private buildConnectHandlers;
-    /** Loose signature on purpose - the IGNIS `ServiceType` is opaque (`unknown`) while ConnectRPC expects `DescService`. */
-    private registerService;
-    /** Creates the Hono middleware that dispatches to ConnectRPC universal handlers. */
-    private buildMiddleware;
-    /** Validates peer deps, creates adapter, and returns paths + middleware. */
-    static build<RouteEnv extends Env = Env, RouteSchema extends Schema = {}, BasePath extends string = '/', ServiceType = Parameters<ConnectRouter['service']>[0], ConfigurableOptions extends object = {}>(opts: {
-        controller: AbstractGrpcController<RouteEnv, RouteSchema, BasePath, ServiceType, ConfigurableOptions>;
-        interceptors?: unknown[];
-        module?: IConnectRpcModule;
-    }): Promise<IConnectAdapterResult<RouteEnv, BasePath>>;
-}
-//# sourceMappingURL=adapter.d.ts.map