@venizia/ignis 0.4.3 → 0.4.5

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

@@ -0,0 +1,44 @@
+import type { IApplication, IApplicationConfigs as IKernelApplicationConfigs } from '@venizia/ignis-kernel';
+import type { Env, Schema } from 'hono';
+/**
+ * What a host with a real socket configures on top of the kernel's shape. `host` and `port` are
+ * meaningless to a browser Worker, which is why they are not on the kernel's own interface - see
+ * {@link IServerApplication}.
+ */
+export interface IServerApplicationConfigs extends IKernelApplicationConfigs {
+    host?: string;
+    port?: number;
+    /** Bound as `CoreBindings.APPLICATION_PROJECT_ROOT` at construction and handed to `ModuleUtility`; default `process.cwd()`. Must be the directory holding `node_modules` at run time - never `__dirname` inside a compiled binary. */
+    projectRoot?: string;
+    /** Bun-only socket options passed straight to `Bun.serve`. Unset keys keep Bun's own defaults. */
+    server?: IServerRuntimeConfigs;
+}
+/** The `Bun.serve` options an application has a reason to change without re-implementing `startBunModule`. */
+export interface IServerRuntimeConfigs {
+    /** Seconds a connection may sit idle before Bun closes it; Bun caps it at 255. */
+    idleTimeout?: number;
+    /** Largest request body in bytes. */
+    maxRequestBodySize?: number;
+}
+/**
+ * The kernel's contract plus what only a listening server can answer. `RestApplication` deliberately
+ * implements none of these: a browser Worker has no host, no port, and nothing to `start()` - it
+ * answers `postMessage` instead.
+ */
+/** Options of `ServerApplication.installShutdownSignals`. */
+export interface IShutdownSignalsOptions {
+    /** The signals that stop the application. Default `['SIGTERM', 'SIGINT']`. */
+    signals?: NodeJS.Signals[];
+    /** How long a shutdown may take before the process is force-exited with code 1. Default `15_000`. */
+    timeoutMs?: number;
+    /** What ends the process: `process.exit` by default. A seam for tests and for hosts that exit differently. */
+    exit?: (code: number) => void;
+}
+export interface IServerApplication<AppEnv extends Env = Env, AppSchema extends Schema = Schema, BasePath extends string = '/'> extends IApplication<AppEnv, AppSchema, BasePath> {
+    getServerHost(): string;
+    getServerPort(): number;
+    getServerAddress(): string;
+    start(): Promise<void> | void;
+    stop(): Promise<void> | void;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/base/applications/common/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EACZ,mBAAmB,IAAI,yBAAyB,EACjD,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAExC;;;;GAIG;AACH,MAAM,WAAW,yBAA0B,SAAQ,yBAAyB;IAC1E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sOAAsO;IACtO,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kGAAkG;IAClG,MAAM,CAAC,EAAE,qBAAqB,CAAC;CAChC;AAED,8GAA8G;AAC9G,MAAM,WAAW,qBAAqB;IACpC,kFAAkF;IAClF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qCAAqC;IACrC,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;;;GAIG;AACH,6DAA6D;AAC7D,MAAM,WAAW,uBAAuB;IACtC,8EAA8E;IAC9E,OAAO,CAAC,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC;IAE3B,qGAAqG;IACrG,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,8GAA8G;IAC9G,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC/B;AAED,MAAM,WAAW,kBAAkB,CACjC,MAAM,SAAS,GAAG,GAAG,GAAG,EACxB,SAAS,SAAS,MAAM,GAAG,MAAM,EACjC,QAAQ,SAAS,MAAM,GAAG,GAAG,CAC7B,SAAQ,YAAY,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,CAAC;IACjD,aAAa,IAAI,MAAM,CAAC;IACxB,aAAa,IAAI,MAAM,CAAC;IACxB,gBAAgB,IAAI,MAAM,CAAC;IAE3B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC9B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CAC9B"}

package/dist/esm/base/applications/common/types.js

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../src/base/applications/common/types.ts"],"names":[],"mappings":"","sourcesContent":["import type {\n  IApplication,\n  IApplicationConfigs as IKernelApplicationConfigs,\n} from '@venizia/ignis-kernel';\nimport type { Env, Schema } from 'hono';\n\n/**\n * What a host with a real socket configures on top of the kernel's shape. `host` and `port` are\n * meaningless to a browser Worker, which is why they are not on the kernel's own interface - see\n * {@link IServerApplication}.\n */\nexport interface IServerApplicationConfigs extends IKernelApplicationConfigs {\n  host?: string;\n  port?: number;\n  /** Bound as `CoreBindings.APPLICATION_PROJECT_ROOT` at construction and handed to `ModuleUtility`; default `process.cwd()`. Must be the directory holding `node_modules` at run time - never `__dirname` inside a compiled binary. */\n  projectRoot?: string;\n  /** Bun-only socket options passed straight to `Bun.serve`. Unset keys keep Bun's own defaults. */\n  server?: IServerRuntimeConfigs;\n}\n\n/** The `Bun.serve` options an application has a reason to change without re-implementing `startBunModule`. */\nexport interface IServerRuntimeConfigs {\n  /** Seconds a connection may sit idle before Bun closes it; Bun caps it at 255. */\n  idleTimeout?: number;\n  /** Largest request body in bytes. */\n  maxRequestBodySize?: number;\n}\n\n/**\n * The kernel's contract plus what only a listening server can answer. `RestApplication` deliberately\n * implements none of these: a browser Worker has no host, no port, and nothing to `start()` - it\n * answers `postMessage` instead.\n */\n/** Options of `ServerApplication.installShutdownSignals`. */\nexport interface IShutdownSignalsOptions {\n  /** The signals that stop the application. Default `['SIGTERM', 'SIGINT']`. */\n  signals?: NodeJS.Signals[];\n\n  /** How long a shutdown may take before the process is force-exited with code 1. Default `15_000`. */\n  timeoutMs?: number;\n\n  /** What ends the process: `process.exit` by default. A seam for tests and for hosts that exit differently. */\n  exit?: (code: number) => void;\n}\n\nexport interface IServerApplication<\n  AppEnv extends Env = Env,\n  AppSchema extends Schema = Schema,\n  BasePath extends string = '/',\n> extends IApplication<AppEnv, AppSchema, BasePath> {\n  getServerHost(): string;\n  getServerPort(): number;\n  getServerAddress(): string;\n\n  start(): Promise<void> | void;\n  stop(): Promise<void> | void;\n}\n"]}

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

@@ -0,0 +1,6 @@
+export * from '@venizia/ignis-kernel';
+export * from './base.js';
+export * from './boot-steps.js';
+export * from './common/index.js';
+export * from './server.js';
+//# sourceMappingURL=index.d.ts.map

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

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

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

@@ -0,0 +1,9 @@
+// `abstract.ts`, `rest.ts` and `types.ts` moved to the kernel; `base.ts` (BaseApplication) and
+// `server.ts` (ServerApplication) stay - both are node-shaped (secrets/boot wiring, the listening
+// server).
+export * from '@venizia/ignis-kernel';
+export * from './base.js';
+export * from './boot-steps.js';
+export * from './common/index.js';
+export * from './server.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/base/applications/index.ts"],"names":[],"mappings":"AAAA,+FAA+F;AAC/F,kGAAkG;AAClG,WAAW;AACX,cAAc,uBAAuB,CAAC;AAEtC,cAAc,QAAQ,CAAC;AACvB,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC","sourcesContent":["// `abstract.ts`, `rest.ts` and `types.ts` moved to the kernel; `base.ts` (BaseApplication) and\n// `server.ts` (ServerApplication) stay - both are node-shaped (secrets/boot wiring, the listening\n// server).\nexport * from '@venizia/ignis-kernel';\n\nexport * from './base';\nexport * from './boot-steps';\nexport * from './common';\nexport * from './server';\n"]}

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

@@ -0,0 +1,71 @@
+import { RestApplication } from '@venizia/ignis-kernel';
+import type { Env, Schema } from 'hono';
+import type { IServerApplication, IServerApplicationConfigs, IServerRuntimeConfigs, IShutdownSignalsOptions } from './common/index.js';
+/** 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>;
+/** What the process runs on. `Bun` is the one global that tells the runtimes apart, and it cannot be hidden in a test, so the guard reads this snapshot instead. */
+export interface IRuntimeSnapshot {
+    /** `Bun.version`, set only under Bun. */
+    bunVersion?: string;
+    /** `process.release.name` and `process.version` of a runtime that is not Bun (`node`, `v24.14.0`). */
+    otherName?: string;
+    otherVersion?: string;
+}
+export declare const readRuntimeSnapshot: () => IRuntimeSnapshot;
+/**
+ * IGNIS runs on Bun 1.4 or later, and nothing else. One refusal at the top of `start()`, before any
+ * hook, datasource or socket is touched, replaces a failure that would otherwise surface halfway
+ * through startup.
+ */
+export declare const assertBunRuntime: (opts?: {
+    runtime?: IRuntimeSnapshot;
+}) => void;
+/** Adds the listening server (`Bun.serve`) 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. `start()` refuses to run unless this is Bun. */
+    protected runtime: "bun" | undefined;
+    protected serverInstance?: TBunServerInstance;
+    /** 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;
+    /** What `start()` checks. A seam for the guard's test: the `Bun` global cannot be hidden from inside Bun. */
+    protected getRuntimeSnapshot(): IRuntimeSnapshot;
+    getServerInstance<T extends TBunServerInstance = TBunServerInstance>(): T | undefined;
+    protected startBunModule(): 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/esm/base/applications/server.d.ts.map

@@ -0,0 +1 @@
+{"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,EACxB,MAAM,UAAU,CAAC;AAElB,gTAAgT;AAChT,MAAM,MAAM,kBAAkB,GAAG,UAAU,CAAC,OAAO,GAAG,CAAC,KAAK,CAAC,CAAC;AAI9D,oKAAoK;AACpK,MAAM,WAAW,gBAAgB;IAC/B,yCAAyC;IACzC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sGAAsG;IACtG,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,eAAO,MAAM,mBAAmB,QAAO,gBAIrC,CAAC;AAYH;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,GAAI,OAAM;IAAE,OAAO,CAAC,EAAE,gBAAgB,CAAA;CAAO,KAAG,IAa5E,CAAC;AAqCF,gLAAgL;AAChL,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,0LAA0L;IAC1L,SAAS,CAAC,OAAO,oBAA2B;IAC5C,SAAS,CAAC,cAAc,CAAC,EAAE,kBAAkB,CAAC;IAE9C,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,6GAA6G;IAC7G,SAAS,CAAC,kBAAkB,IAAI,gBAAgB;IAIhD,iBAAiB,CAAC,CAAC,SAAS,kBAAkB,GAAG,kBAAkB,KAAK,CAAC,GAAG,SAAS;IAIrF,SAAS,CAAC,cAAc;IAmClB,KAAK;IAcX,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;CAY5C"}

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

@@ -0,0 +1,239 @@
+import { CoreBindings, RestApplication } from '@venizia/ignis-kernel';
+import { ModuleUtility } from '@venizia/ignis-helpers';
+import { getError } from '@venizia/ignis-helpers/core';
+import { RuntimeModules } from '@venizia/ignis-helpers/common';
+import { existsSync } from 'node:fs';
+import path from 'node:path';
+const MINIMUM_BUN = { major: 1, minor: 4 };
+export const readRuntimeSnapshot = () => ({
+    bunVersion: RuntimeModules.isBun() ? Bun.version : undefined,
+    otherName: globalThis.process?.release?.name,
+    otherVersion: globalThis.process?.version,
+});
+const describeRuntime = (opts) => {
+    const { bunVersion, otherName, otherVersion } = opts.runtime;
+    if (bunVersion !== undefined) {
+        return `bun ${bunVersion}`;
+    }
+    return otherName ? `${otherName} ${otherVersion ?? ''}`.trim() : 'an unknown runtime';
+};
+/**
+ * IGNIS runs on Bun 1.4 or later, and nothing else. One refusal at the top of `start()`, before any
+ * hook, datasource or socket is touched, replaces a failure that would otherwise surface halfway
+ * through startup.
+ */
+export const assertBunRuntime = (opts = {}) => {
+    const runtime = opts.runtime ?? readRuntimeSnapshot();
+    if (runtime.bunVersion !== undefined) {
+        const [major = 0, minor = 0] = runtime.bunVersion.split('.').map(Number);
+        if (major > MINIMUM_BUN.major || (major === MINIMUM_BUN.major && minor >= MINIMUM_BUN.minor)) {
+            return;
+        }
+    }
+    throw getError({
+        message: `IGNIS requires Bun >= ${MINIMUM_BUN.major}.${MINIMUM_BUN.minor} (running on ${describeRuntime({ runtime })})`,
+    });
+};
+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`) 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 class ServerApplication extends 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. `start()` refuses to run unless this is Bun. */
+        this.runtime = 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 && !existsSync(path.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: CoreBindings.APPLICATION_PROJECT_ROOT }).toValue(projectRoot);
+        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 }),
+        };
+    }
+    /** What `start()` checks. A seam for the guard's test: the `Bun` global cannot be hidden from inside Bun. */
+    getRuntimeSnapshot() {
+        return readRuntimeSnapshot();
+    }
+    getServerInstance() {
+        return this.serverInstance;
+    }
+    startBunModule() {
+        return new Promise((resolve, reject) => {
+            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', path.resolve(process.env.APP_ENV_LOGGER_FOLDER_PATH ?? '').toString());
+                resolve(rs);
+            })
+                .catch(reject);
+        });
+    }
+    async start() {
+        assertBunRuntime({ runtime: this.getRuntimeSnapshot() });
+        await this.initialize();
+        await this.setupMiddlewares();
+        const server = this.getServer();
+        server.route(this.configs.path.base, this.rootRouter);
+        await this.startBunModule();
+        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 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;
+        }
+        await instance.stop();
+        this.serverInstance = undefined;
+        this.logger.for(this.stop.name).info('Server STOPPED');
+    }
+}
+//# sourceMappingURL=server.js.map

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

@@ -0,0 +1 @@
+{"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} 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 MINIMUM_BUN = { major: 1, minor: 4 };\n\n/** What the process runs on. `Bun` is the one global that tells the runtimes apart, and it cannot be hidden in a test, so the guard reads this snapshot instead. */\nexport interface IRuntimeSnapshot {\n  /** `Bun.version`, set only under Bun. */\n  bunVersion?: string;\n  /** `process.release.name` and `process.version` of a runtime that is not Bun (`node`, `v24.14.0`). */\n  otherName?: string;\n  otherVersion?: string;\n}\n\nexport const readRuntimeSnapshot = (): IRuntimeSnapshot => ({\n  bunVersion: RuntimeModules.isBun() ? Bun.version : undefined,\n  otherName: globalThis.process?.release?.name,\n  otherVersion: globalThis.process?.version,\n});\n\nconst describeRuntime = (opts: { runtime: IRuntimeSnapshot }): string => {\n  const { bunVersion, otherName, otherVersion } = opts.runtime;\n\n  if (bunVersion !== undefined) {\n    return `bun ${bunVersion}`;\n  }\n\n  return otherName ? `${otherName} ${otherVersion ?? ''}`.trim() : 'an unknown runtime';\n};\n\n/**\n * IGNIS runs on Bun 1.4 or later, and nothing else. One refusal at the top of `start()`, before any\n * hook, datasource or socket is touched, replaces a failure that would otherwise surface halfway\n * through startup.\n */\nexport const assertBunRuntime = (opts: { runtime?: IRuntimeSnapshot } = {}): void => {\n  const runtime = opts.runtime ?? readRuntimeSnapshot();\n\n  if (runtime.bunVersion !== undefined) {\n    const [major = 0, minor = 0] = runtime.bunVersion.split('.').map(Number);\n    if (major > MINIMUM_BUN.major || (major === MINIMUM_BUN.major && minor >= MINIMUM_BUN.minor)) {\n      return;\n    }\n  }\n\n  throw getError({\n    message: `IGNIS requires Bun >= ${MINIMUM_BUN.major}.${MINIMUM_BUN.minor} (running on ${describeRuntime({ runtime })})`,\n  });\n};\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`) 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. `start()` refuses to run unless this is Bun. */\n  protected runtime = RuntimeModules.detect();\n  protected serverInstance?: TBunServerInstance;\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  /** What `start()` checks. A seam for the guard's test: the `Bun` global cannot be hidden from inside Bun. */\n  protected getRuntimeSnapshot(): IRuntimeSnapshot {\n    return readRuntimeSnapshot();\n  }\n\n  getServerInstance<T extends TBunServerInstance = TBunServerInstance>(): T | undefined {\n    return this.serverInstance as T | undefined;\n  }\n\n  protected startBunModule() {\n    return new Promise((resolve, reject) => {\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  async start() {\n    assertBunRuntime({ runtime: this.getRuntimeSnapshot() });\n\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    await this.startBunModule();\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    await instance.stop();\n\n    this.serverInstance = undefined;\n    this.logger.for(this.stop.name).info('Server STOPPED');\n  }\n}\n"]}

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

@@ -0,0 +1,48 @@
+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.js';
+/** 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/esm/base/controllers/grpc/abstract.d.ts.map

@@ -0,0 +1 @@
+{"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/esm/base/controllers/grpc/abstract.js

@@ -0,0 +1,117 @@
+import { BaseHelper, getError } from '@venizia/ignis-helpers/core';
+import { authenticate as authenticateFn, AuthenticationModes, AuthenticationStrategyRegistry, authorize as authorizeFn, ControllerTransports, MetadataRegistry, } from '@venizia/ignis-kernel';
+import { Hono } from 'hono';
+import { GrpcRequestAdapter } from './adapter.js';
+/** Abstract base class for gRPC controllers, providing RPC registration and ConnectRPC integration. */
+export class AbstractGrpcController extends BaseHelper {
+    constructor(opts) {
+        super(opts);
+        this.isConfigured = false;
+        this.definitions = {};
+        this.basePath = '';
+        const decoratorMetadata = MetadataRegistry.getInstance().getControllerMetadata({
+            target: new.target,
+        });
+        const resolvedPath = decoratorMetadata?.path ?? opts.path;
+        if (!resolvedPath) {
+            throw getError({
+                message: `[${new.target.name}] Controller path is required. Provide path via @controller decorator or constructor options.`,
+            });
+        }
+        this.path = resolvedPath;
+        this.router = new Hono();
+        if (decoratorMetadata?.transport === 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 = 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.
+            AuthenticationStrategyRegistry.getInstance().reportUnregistered({
+                names: strategies,
+                scope: this.constructor.name,
+            });
+            if (strategies.length > 0) {
+                const authMw = authenticateFn({ 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 = authorizeFn({ 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 = 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 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);
+    }
+}
+//# sourceMappingURL=abstract.js.map