@venizia/ignis 0.4.3 → 0.4.5

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

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

@@ -0,0 +1,31 @@
+import type { ConnectRouter } from '@connectrpc/connect';
+import { BaseHelper } from '@venizia/ignis-helpers/core';
+import type { Env, Schema } from 'hono';
+import type { AbstractGrpcController } from './abstract.js';
+import type { IConnectAdapterResult, IConnectRpcModule } from './common/types.js';
+/** Bridges IGNIS gRPC controllers with ConnectRPC: loads the peer deps with `ModuleUtility.load` (the ES module copy an application's own import gets), 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();
+    /**
+     * The ConnectRPC peers, loaded as ES modules from the project root (or taken from `ModuleUtility.register`,
+     * which is what a compiled binary has). A missing peer rejects with the error that names what to install.
+     */
+    private static loadModule;
+    /** 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

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

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../../../src/base/controllers/grpc/adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAkB,MAAM,qBAAqB,CAAC;AAOzE,OAAO,EAAE,UAAU,EAAY,MAAM,6BAA6B,CAAC;AAGnE,OAAO,KAAK,EAAE,GAAG,EAA4B,MAAM,EAAE,MAAM,MAAM,CAAC;AAGlE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AACzD,OAAO,KAAK,EAAE,qBAAqB,EAAE,iBAAiB,EAAoB,MAAM,gBAAgB,CAAC;AAUjG,ySAAyS;AACzS,qBAAa,kBAAkB,CAC7B,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,CACvC,SAAQ,UAAU;IAClB,OAAO,CAAC,mBAAmB,CAAoD;IAC/E,OAAO,CAAC,QAAQ,CAGd;IAEF,OAAO,CAAC,UAAU,CAMhB;IACF,OAAO,CAAC,YAAY,CAAC,CAAY;IAEjC,OAAO;IAmBP;;;OAGG;mBACkB,UAAU;IAW/B,gGAAgG;IAChG,OAAO,CAAC,oBAAoB;IA8B5B,yHAAyH;IACzH,OAAO,CAAC,eAAe;IAQvB,oFAAoF;IACpF,OAAO,CAAC,eAAe;IA8DvB,4EAA4E;WAC/D,KAAK,CAChB,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,EACvC,IAAI,EAAE;QACN,UAAU,EAAE,sBAAsB,CAChC,QAAQ,EACR,WAAW,EACX,QAAQ,EACR,WAAW,EACX,mBAAmB,CACpB,CAAC;QACF,YAAY,CAAC,EAAE,OAAO,EAAE,CAAC;QACzB,MAAM,CAAC,EAAE,iBAAiB,CAAC;KAC5B,GAAG,OAAO,CAAC,qBAAqB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;CAmDvD"}

package/dist/esm/base/controllers/grpc/adapter.js

@@ -0,0 +1,144 @@
+import { BaseHelper, getError } from '@venizia/ignis-helpers/core';
+import { GRPC, HTTP } from '@venizia/ignis-helpers/common';
+import { ModuleUtility } from '@venizia/ignis-helpers';
+import { AsyncLocalStorage } from 'node:async_hooks';
+const CONNECT_RPC_MODULES = ['@connectrpc/connect'];
+const CONNECT_RPC_PROTOCOL_MODULE = '@connectrpc/connect/protocol';
+/** Bridges IGNIS gRPC controllers with ConnectRPC: loads the peer deps with `ModuleUtility.load` (the ES module copy an application's own import gets), wraps handlers into ConnectRPC's signature, dispatches through a Hono middleware, and isolates request-scoped context with AsyncLocalStorage. */
+export class GrpcRequestAdapter extends BaseHelper {
+    constructor(opts) {
+        super({ scope: GrpcRequestAdapter.name });
+        this.controller = opts.controller;
+        this.interceptors = opts.interceptors;
+        this.createConnectRouter = opts.module.connect.createConnectRouter;
+        this.protocol = opts.module.protocol;
+    }
+    /**
+     * The ConnectRPC peers, loaded as ES modules from the project root (or taken from `ModuleUtility.register`,
+     * which is what a compiled binary has). A missing peer rejects with the error that names what to install.
+     */
+    static async loadModule() {
+        ModuleUtility.assertInstalled({ modules: CONNECT_RPC_MODULES, allowRegistered: true });
+        const [connect, protocol] = await Promise.all([
+            ModuleUtility.load({ module: CONNECT_RPC_MODULES[0] }),
+            ModuleUtility.load({ module: CONNECT_RPC_PROTOCOL_MODULE }),
+        ]);
+        return { connect, protocol };
+    }
+    /** Wraps IGNIS RPC registrations into ConnectRPC's (request, context) => response signature. */
+    buildConnectHandlers(opts) {
+        const handlers = {};
+        for (const name in opts.definitions) {
+            const { handler, middlewares } = opts.definitions[name];
+            handlers[name] = async (request, _connectContext) => {
+                const context = opts.storage.getStore();
+                if (!context) {
+                    throw getError({
+                        statusCode: HTTP.ResultCodes.RS_5.InternalServerError,
+                        message: `[GrpcRequestAdapter] Missing Hono context for RPC "${name}"`,
+                    });
+                }
+                // Run pre-built auth middlewares (built by AbstractGrpcController.buildRpcMiddlewares)
+                for (const mw of middlewares) {
+                    await mw(context, async () => { });
+                }
+                return handler({ request, context });
+            };
+        }
+        return handlers;
+    }
+    /** Loose signature on purpose - the IGNIS `ServiceType` is opaque (`unknown`) while ConnectRPC expects `DescService`. */
+    registerService(opts) {
+        const { router, handlers } = opts;
+        router.service(this.controller.service, handlers);
+    }
+    /** Creates the Hono middleware that dispatches to ConnectRPC universal handlers. */
+    buildMiddleware(opts) {
+        const { handlerMap, controllerPath, storage } = opts;
+        const { universalServerRequestFromFetch, universalServerResponseToFetch } = this.protocol;
+        return async (context, next) => {
+            let pathname = context.req.path;
+            // context.req.path is the full original URL path, so strip the basePath + controllerPath prefix to get the ConnectRPC handler path (/package.Service/Method).
+            if (controllerPath && pathname.startsWith(controllerPath)) {
+                pathname = pathname.slice(controllerPath.length) || '/';
+            }
+            const handler = handlerMap.get(pathname);
+            if (!handler) {
+                return next();
+            }
+            // `context` is Hono's real Context<RouteEnv>; TRouteContext is a lightweight custom shape (different `json`/`req.valid` signatures) built on it, not a subtype - hence this bridge.
+            return storage.run(context, async () => {
+                try {
+                    const body = await context.req.arrayBuffer();
+                    const freshRequest = new Request(context.req.url, {
+                        method: context.req.method,
+                        headers: context.req.raw.headers,
+                        body: body.byteLength > 0 ? body : undefined,
+                    });
+                    const uReq = universalServerRequestFromFetch(freshRequest, {});
+                    const uRes = await handler(uReq);
+                    return universalServerResponseToFetch(uRes);
+                }
+                catch (error) {
+                    const message = error instanceof Error ? error.message : 'Internal gRPC error';
+                    // Preserve gRPC status code from ConnectError (duck-type check avoids peer dep coupling)
+                    const code = typeof error === 'object' &&
+                        error !== null &&
+                        'code' in error &&
+                        typeof error.code === 'number'
+                        ? error.code
+                        : GRPC.ResultCodes.INTERNAL;
+                    return new Response(JSON.stringify({ message, code }), {
+                        status: code === GRPC.ResultCodes.OK
+                            ? HTTP.ResultCodes.RS_2.Ok
+                            : HTTP.ResultCodes.RS_5.InternalServerError,
+                        headers: {
+                            [HTTP.Headers.CONTENT_TYPE]: HTTP.HeaderValues.APPLICATION_JSON,
+                            [GRPC.Headers.GRPC_STATUS]: String(code),
+                            [GRPC.Headers.GRPC_MESSAGE]: encodeURIComponent(message),
+                        },
+                    });
+                }
+            });
+        };
+    }
+    /** Validates peer deps, creates adapter, and returns paths + middleware. */
+    static async build(opts) {
+        const module = opts.module ?? (await GrpcRequestAdapter.loadModule());
+        const adapter = new GrpcRequestAdapter({ ...opts, module });
+        const routerOpts = {};
+        if (adapter.interceptors?.length) {
+            routerOpts.interceptors = adapter.interceptors;
+        }
+        const connectRouter = adapter.createConnectRouter(routerOpts);
+        // Per-controller async storage - each concurrent request gets its own isolated context.
+        const storage = new AsyncLocalStorage();
+        if (adapter.controller.service) {
+            adapter.registerService({
+                router: connectRouter,
+                handlers: adapter.buildConnectHandlers({
+                    definitions: adapter.controller.definitions,
+                    storage,
+                }),
+            });
+        }
+        const handlerMap = new Map();
+        const paths = [];
+        for (const handler of connectRouter.handlers) {
+            handlerMap.set(handler.requestPath, handler);
+            paths.push(handler.requestPath);
+        }
+        return {
+            paths,
+            middleware: adapter.buildMiddleware({
+                handlerMap,
+                controllerPath: [
+                    adapter.controller.basePath.replace(/\/$/, ''),
+                    adapter.controller.path,
+                ].join(''),
+                storage,
+            }),
+        };
+    }
+}
+//# sourceMappingURL=adapter.js.map

package/dist/esm/base/controllers/grpc/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../../../../src/base/controllers/grpc/adapter.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ConnectRouter, HandlerContext } from '@connectrpc/connect';\nimport type {\n  UniversalHandler,\n  UniversalServerRequest,\n  UniversalServerResponse,\n} from '@connectrpc/connect/protocol';\nimport type { ValueOrPromise } from '@venizia/ignis-helpers/common';\nimport { BaseHelper, getError } from '@venizia/ignis-helpers/core';\nimport { GRPC, HTTP } from '@venizia/ignis-helpers/common';\nimport { ModuleUtility } from '@venizia/ignis-helpers';\nimport type { Env, Input, MiddlewareHandler, Schema } from 'hono';\nimport { AsyncLocalStorage } from 'node:async_hooks';\nimport type { TRouteContext } from '@venizia/ignis-kernel';\nimport type { AbstractGrpcController } from './abstract';\nimport type { IConnectAdapterResult, IConnectRpcModule, IRpcRegistration } from './common/types';\n\nconst CONNECT_RPC_MODULES = ['@connectrpc/connect'];\nconst CONNECT_RPC_PROTOCOL_MODULE = '@connectrpc/connect/protocol';\n\ntype TConnectHandler<RequestType = unknown, ResponseType = unknown> = (\n  request: RequestType,\n  context: HandlerContext,\n) => ValueOrPromise<ResponseType>;\n\n/** Bridges IGNIS gRPC controllers with ConnectRPC: loads the peer deps with `ModuleUtility.load` (the ES module copy an application's own import gets), wraps handlers into ConnectRPC's signature, dispatches through a Hono middleware, and isolates request-scoped context with AsyncLocalStorage. */\nexport class GrpcRequestAdapter<\n  RouteEnv extends Env = Env,\n  RouteSchema extends Schema = {},\n  BasePath extends string = '/',\n  ServiceType = Parameters<ConnectRouter['service']>[0],\n  ConfigurableOptions extends object = {},\n> extends BaseHelper {\n  private createConnectRouter: (opts?: Record<string, unknown>) => ConnectRouter;\n  private protocol: {\n    universalServerRequestFromFetch: (req: Request, ctx: object) => UniversalServerRequest;\n    universalServerResponseToFetch: (res: UniversalServerResponse) => Response;\n  };\n\n  private controller: AbstractGrpcController<\n    RouteEnv,\n    RouteSchema,\n    BasePath,\n    ServiceType,\n    ConfigurableOptions\n  >;\n  private interceptors?: unknown[];\n\n  private constructor(opts: {\n    controller: AbstractGrpcController<\n      RouteEnv,\n      RouteSchema,\n      BasePath,\n      ServiceType,\n      ConfigurableOptions\n    >;\n    interceptors?: unknown[];\n    module: IConnectRpcModule;\n  }) {\n    super({ scope: GrpcRequestAdapter.name });\n\n    this.controller = opts.controller;\n    this.interceptors = opts.interceptors;\n    this.createConnectRouter = opts.module.connect.createConnectRouter;\n    this.protocol = opts.module.protocol;\n  }\n\n  /**\n   * The ConnectRPC peers, loaded as ES modules from the project root (or taken from `ModuleUtility.register`,\n   * which is what a compiled binary has). A missing peer rejects with the error that names what to install.\n   */\n  private static async loadModule(): Promise<IConnectRpcModule> {\n    ModuleUtility.assertInstalled({ modules: CONNECT_RPC_MODULES, allowRegistered: true });\n\n    const [connect, protocol] = await Promise.all([\n      ModuleUtility.load<IConnectRpcModule['connect']>({ module: CONNECT_RPC_MODULES[0] }),\n      ModuleUtility.load<IConnectRpcModule['protocol']>({ module: CONNECT_RPC_PROTOCOL_MODULE }),\n    ]);\n\n    return { connect, protocol };\n  }\n\n  /** Wraps IGNIS RPC registrations into ConnectRPC's (request, context) => response signature. */\n  private buildConnectHandlers(opts: {\n    definitions: Record<string, IRpcRegistration<RouteEnv>>;\n    storage: AsyncLocalStorage<TRouteContext<RouteEnv>>;\n  }): Record<string, TConnectHandler> {\n    const handlers: Record<string, TConnectHandler> = {};\n\n    for (const name in opts.definitions) {\n      const { handler, middlewares } = opts.definitions[name];\n\n      handlers[name] = async (request: unknown, _connectContext: HandlerContext) => {\n        const context = opts.storage.getStore();\n        if (!context) {\n          throw getError({\n            statusCode: HTTP.ResultCodes.RS_5.InternalServerError,\n            message: `[GrpcRequestAdapter] Missing Hono context for RPC \"${name}\"`,\n          });\n        }\n\n        // Run pre-built auth middlewares (built by AbstractGrpcController.buildRpcMiddlewares)\n        for (const mw of middlewares) {\n          await mw(context, async () => {});\n        }\n\n        return handler({ request, context });\n      };\n    }\n\n    return handlers;\n  }\n\n  /** Loose signature on purpose - the IGNIS `ServiceType` is opaque (`unknown`) while ConnectRPC expects `DescService`. */\n  private registerService(opts: {\n    router: ConnectRouter;\n    handlers: Record<string, TConnectHandler>;\n  }) {\n    const { router, handlers } = opts;\n    (router.service as Function)(this.controller.service, handlers);\n  }\n\n  /** Creates the Hono middleware that dispatches to ConnectRPC universal handlers. */\n  private buildMiddleware(opts: {\n    handlerMap: Map<string, UniversalHandler>;\n    controllerPath: string;\n    storage: AsyncLocalStorage<TRouteContext<RouteEnv>>;\n  }): MiddlewareHandler<RouteEnv, BasePath, Input> {\n    const { handlerMap, controllerPath, storage } = opts;\n    const { universalServerRequestFromFetch, universalServerResponseToFetch } = this.protocol;\n\n    return async (context, next) => {\n      let pathname = context.req.path;\n\n      // context.req.path is the full original URL path, so strip the basePath + controllerPath prefix to get the ConnectRPC handler path (/package.Service/Method).\n      if (controllerPath && pathname.startsWith(controllerPath)) {\n        pathname = pathname.slice(controllerPath.length) || '/';\n      }\n\n      const handler = handlerMap.get(pathname);\n      if (!handler) {\n        return next();\n      }\n\n      // `context` is Hono's real Context<RouteEnv>; TRouteContext is a lightweight custom shape (different `json`/`req.valid` signatures) built on it, not a subtype - hence this bridge.\n      return storage.run(context as TRouteContext<RouteEnv>, async () => {\n        try {\n          const body = await context.req.arrayBuffer();\n          const freshRequest = new Request(context.req.url, {\n            method: context.req.method,\n            headers: context.req.raw.headers,\n            body: body.byteLength > 0 ? body : undefined,\n          });\n\n          const uReq = universalServerRequestFromFetch(freshRequest, {});\n          const uRes = await handler(uReq);\n          return universalServerResponseToFetch(uRes);\n        } catch (error) {\n          const message = error instanceof Error ? error.message : 'Internal gRPC error';\n\n          // Preserve gRPC status code from ConnectError (duck-type check avoids peer dep coupling)\n          const code =\n            typeof error === 'object' &&\n            error !== null &&\n            'code' in error &&\n            typeof error.code === 'number'\n              ? error.code\n              : GRPC.ResultCodes.INTERNAL;\n\n          return new Response(JSON.stringify({ message, code }), {\n            status:\n              code === GRPC.ResultCodes.OK\n                ? HTTP.ResultCodes.RS_2.Ok\n                : HTTP.ResultCodes.RS_5.InternalServerError,\n            headers: {\n              [HTTP.Headers.CONTENT_TYPE]: HTTP.HeaderValues.APPLICATION_JSON,\n              [GRPC.Headers.GRPC_STATUS]: String(code),\n              [GRPC.Headers.GRPC_MESSAGE]: encodeURIComponent(message),\n            },\n          });\n        }\n      });\n    };\n  }\n\n  /** Validates peer deps, creates adapter, and returns paths + middleware. */\n  static async build<\n    RouteEnv extends Env = Env,\n    RouteSchema extends Schema = {},\n    BasePath extends string = '/',\n    ServiceType = Parameters<ConnectRouter['service']>[0],\n    ConfigurableOptions extends object = {},\n  >(opts: {\n    controller: AbstractGrpcController<\n      RouteEnv,\n      RouteSchema,\n      BasePath,\n      ServiceType,\n      ConfigurableOptions\n    >;\n    interceptors?: unknown[];\n    module?: IConnectRpcModule;\n  }): Promise<IConnectAdapterResult<RouteEnv, BasePath>> {\n    const module = opts.module ?? (await GrpcRequestAdapter.loadModule());\n\n    const adapter = new GrpcRequestAdapter<\n      RouteEnv,\n      RouteSchema,\n      BasePath,\n      ServiceType,\n      ConfigurableOptions\n    >({ ...opts, module });\n\n    const routerOpts: Record<string, unknown> = {};\n    if (adapter.interceptors?.length) {\n      routerOpts.interceptors = adapter.interceptors;\n    }\n\n    const connectRouter = adapter.createConnectRouter(routerOpts);\n\n    // Per-controller async storage - each concurrent request gets its own isolated context.\n    const storage = new AsyncLocalStorage<TRouteContext<RouteEnv>>();\n\n    if (adapter.controller.service) {\n      adapter.registerService({\n        router: connectRouter,\n        handlers: adapter.buildConnectHandlers({\n          definitions: adapter.controller.definitions,\n          storage,\n        }),\n      });\n    }\n\n    const handlerMap = new Map<string, UniversalHandler>();\n    const paths: string[] = [];\n\n    for (const handler of connectRouter.handlers) {\n      handlerMap.set(handler.requestPath, handler);\n      paths.push(handler.requestPath);\n    }\n\n    return {\n      paths,\n      middleware: adapter.buildMiddleware({\n        handlerMap,\n        controllerPath: [\n          adapter.controller.basePath.replace(/\\/$/, ''),\n          adapter.controller.path,\n        ].join(''),\n        storage,\n      }),\n    };\n  }\n}\n"]}

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

@@ -0,0 +1,19 @@
+import type { IRpcMetadata } from '@venizia/ignis-kernel';
+import type { Env, Schema } from 'hono';
+import { AbstractGrpcController } from './abstract.js';
+import type { IGrpcBindRouteOptions, IGrpcDefineRouteOptions, TRpcHandler } from './common/types.js';
+/** Recommended base class for gRPC controllers with concrete bindRoute and defineRoute implementations. */
+export declare abstract class BaseGrpcController<RouteEnv extends Env = Env, RouteSchema extends Schema = {}, BasePath extends string = '/', ServiceType = unknown, ConfigurableOptions extends object = {}> extends AbstractGrpcController<RouteEnv, RouteSchema, BasePath, ServiceType, ConfigurableOptions> {
+    /** Creates a fluent binding for registering an RPC (call .to() to attach handler). */
+    bindRoute(opts: {
+        configs: IRpcMetadata;
+    }): IGrpcBindRouteOptions<RouteEnv>;
+    /** Defines and registers an RPC with its handler in a single call. */
+    defineRoute(opts: {
+        configs: IRpcMetadata;
+        handler: TRpcHandler<unknown, unknown, RouteEnv>;
+    }): IGrpcDefineRouteOptions;
+    /** Internal: validates and stores handler + configs in definitions. Throws on non-unary methods. */
+    private registerRoute;
+}
+//# sourceMappingURL=base.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../../../src/base/controllers/grpc/base.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAG1D,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AACxC,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,KAAK,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElG,2GAA2G;AAC3G,8BAAsB,kBAAkB,CACtC,QAAQ,SAAS,GAAG,GAAG,GAAG,EAC1B,WAAW,SAAS,MAAM,GAAG,EAAE,EAC/B,QAAQ,SAAS,MAAM,GAAG,GAAG,EAC7B,WAAW,GAAG,OAAO,EACrB,mBAAmB,SAAS,MAAM,GAAG,EAAE,CACvC,SAAQ,sBAAsB,CAC9B,QAAQ,EACR,WAAW,EACX,QAAQ,EACR,WAAW,EACX,mBAAmB,CACpB;IACC,sFAAsF;IACtF,SAAS,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,YAAY,CAAA;KAAE,GAAG,qBAAqB,CAAC,QAAQ,CAAC;IAY3E,sEAAsE;IACtE,WAAW,CAAC,IAAI,EAAE;QAChB,OAAO,EAAE,YAAY,CAAC;QACtB,OAAO,EAAE,WAAW,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;KAClD,GAAG,uBAAuB;IAM3B,oGAAoG;IACpG,OAAO,CAAC,aAAa;CAqBtB"}

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

@@ -0,0 +1,40 @@
+import { getError } from '@venizia/ignis-helpers/core';
+import { GRPC } from '@venizia/ignis-helpers/common';
+import { AbstractGrpcController } from './abstract.js';
+/** Recommended base class for gRPC controllers with concrete bindRoute and defineRoute implementations. */
+export class BaseGrpcController extends AbstractGrpcController {
+    /** Creates a fluent binding for registering an RPC (call .to() to attach handler). */
+    bindRoute(opts) {
+        const configs = this.getRouteConfigs({ configs: opts.configs });
+        return {
+            configs,
+            to: ({ handler }) => {
+                this.registerRoute({ configs, handler });
+                return { configs };
+            },
+        };
+    }
+    /** Defines and registers an RPC with its handler in a single call. */
+    defineRoute(opts) {
+        const configs = this.getRouteConfigs({ configs: opts.configs });
+        this.registerRoute({ configs, handler: opts.handler });
+        return { configs };
+    }
+    /** Internal: validates and stores handler + configs in definitions. Throws on non-unary methods. */
+    registerRoute(opts) {
+        const { configs, handler } = opts;
+        const logger = this.logger.for('registerRoute');
+        if (configs.method !== GRPC.Methods.UNARY) {
+            throw getError({
+                message: `[${this.constructor.name}] RPC method "${configs.name}" uses "${configs.method}" which is not supported. Only unary RPCs are supported in the current version (HTTP/1.1 Connect protocol).`,
+            });
+        }
+        if (this.definitions[configs.name]) {
+            logger.warn('Overwriting RPC handler | name: %s', configs.name);
+        }
+        const middlewares = this.buildRpcMiddlewares({ configs });
+        this.definitions[configs.name] = { configs, handler, middlewares };
+        logger.debug('Registered RPC | name: %s | method: %s', configs.name, configs.method);
+    }
+}
+//# sourceMappingURL=base.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../../../../src/base/controllers/grpc/base.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AACvD,OAAO,EAAE,IAAI,EAAE,MAAM,+BAA+B,CAAC;AAErD,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAGpD,2GAA2G;AAC3G,MAAM,OAAgB,kBAMpB,SAAQ,sBAMT;IACC,sFAAsF;IACtF,SAAS,CAAC,IAA+B;QACvC,MAAM,OAAO,GAAG,IAAI,CAAC,eAAe,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;QAEhE,OAAO;YACL,OAAO;YACP,EAAE,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE;gBAClB,IAAI,CAAC,aAAa,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;gBACzC,OAAO,EAAE,OAAO,EAAE,CAAC;YACrB,CAAC;SACF,CAAC;IACJ,CAAC;IAED,sEAAsE;IACtE,WAAW,CAAC,IAGX;QACC,MAAM,OAAO,GAAG,IAAI,CAAC,eAAe,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;QAChE,IAAI,CAAC,aAAa,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;QACvD,OAAO,EAAE,OAAO,EAAE,CAAC;IACrB,CAAC;IAED,oGAAoG;IAC5F,aAAa,CAAC,IAGrB;QACC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;QAClC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;QAEhD,IAAI,OAAO,CAAC,MAAM,KAAK,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;YAC1C,MAAM,QAAQ,CAAC;gBACb,OAAO,EAAE,IAAI,IAAI,CAAC,WAAW,CAAC,IAAI,iBAAiB,OAAO,CAAC,IAAI,WAAW,OAAO,CAAC,MAAM,6GAA6G;aACtM,CAAC,CAAC;QACL,CAAC;QAED,IAAI,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YACnC,MAAM,CAAC,IAAI,CAAC,oCAAoC,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;QAClE,CAAC;QAED,MAAM,WAAW,GAAG,IAAI,CAAC,mBAAmB,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;QAC1D,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC;QACnE,MAAM,CAAC,KAAK,CAAC,wCAAwC,EAAE,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IACvF,CAAC;CACF","sourcesContent":["import type { IRpcMetadata } from '@venizia/ignis-kernel';\nimport { getError } from '@venizia/ignis-helpers/core';\nimport { GRPC } from '@venizia/ignis-helpers/common';\nimport type { Env, Schema } from 'hono';\nimport { AbstractGrpcController } from './abstract';\nimport type { IGrpcBindRouteOptions, IGrpcDefineRouteOptions, TRpcHandler } from './common/types';\n\n/** Recommended base class for gRPC controllers with concrete bindRoute and defineRoute implementations. */\nexport abstract class BaseGrpcController<\n  RouteEnv extends Env = Env,\n  RouteSchema extends Schema = {},\n  BasePath extends string = '/',\n  ServiceType = unknown,\n  ConfigurableOptions extends object = {},\n> extends AbstractGrpcController<\n  RouteEnv,\n  RouteSchema,\n  BasePath,\n  ServiceType,\n  ConfigurableOptions\n> {\n  /** Creates a fluent binding for registering an RPC (call .to() to attach handler). */\n  bindRoute(opts: { configs: IRpcMetadata }): IGrpcBindRouteOptions<RouteEnv> {\n    const configs = this.getRouteConfigs({ configs: opts.configs });\n\n    return {\n      configs,\n      to: ({ handler }) => {\n        this.registerRoute({ configs, handler });\n        return { configs };\n      },\n    };\n  }\n\n  /** Defines and registers an RPC with its handler in a single call. */\n  defineRoute(opts: {\n    configs: IRpcMetadata;\n    handler: TRpcHandler<unknown, unknown, RouteEnv>;\n  }): IGrpcDefineRouteOptions {\n    const configs = this.getRouteConfigs({ configs: opts.configs });\n    this.registerRoute({ configs, handler: opts.handler });\n    return { configs };\n  }\n\n  /** Internal: validates and stores handler + configs in definitions. Throws on non-unary methods. */\n  private registerRoute(opts: {\n    configs: IRpcMetadata;\n    handler: TRpcHandler<unknown, unknown, RouteEnv>;\n  }): void {\n    const { configs, handler } = opts;\n    const logger = this.logger.for('registerRoute');\n\n    if (configs.method !== GRPC.Methods.UNARY) {\n      throw getError({\n        message: `[${this.constructor.name}] RPC method \"${configs.name}\" uses \"${configs.method}\" which is not supported. Only unary RPCs are supported in the current version (HTTP/1.1 Connect protocol).`,\n      });\n    }\n\n    if (this.definitions[configs.name]) {\n      logger.warn('Overwriting RPC handler | name: %s', configs.name);\n    }\n\n    const middlewares = this.buildRpcMiddlewares({ configs });\n    this.definitions[configs.name] = { configs, handler, middlewares };\n    logger.debug('Registered RPC | name: %s | method: %s', configs.name, configs.method);\n  }\n}\n"]}

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

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

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

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../src/base/controllers/grpc/common/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC","sourcesContent":["export * from './types';\n"]}

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

@@ -0,0 +1,74 @@
+import type { TRouteContext } from '@venizia/ignis-kernel';
+import type { IRpcMetadata } from '@venizia/ignis-kernel';
+import type { ConnectRouter } from '@connectrpc/connect';
+import type { UniversalServerRequest, UniversalServerResponse } from '@connectrpc/connect/protocol';
+import type { IConfigurable, ValueOrPromise } from '@venizia/ignis-helpers/common';
+import type { Env, Hono, Input, MiddlewareHandler, Next, Schema } from 'hono';
+/**
+ * The ConnectRPC peer itself, handed over by an application that already holds it. A
+ * `bun build --compile` binary carries no `node_modules`, so the lookup {@link GrpcRequestAdapter} makes with
+ * `ModuleUtility.load` has nothing to resolve against - passing the modules through the gRPC
+ * component options (or `ModuleUtility.register`) is what a compiled application does instead. Both entry points are needed: the
+ * adapter builds its router from `@connectrpc/connect` and converts requests with
+ * `@connectrpc/connect/protocol`. Typed as the shape the adapter actually calls, so a wrong module
+ * is a compile error rather than a boot crash.
+ */
+export interface IConnectRpcModule {
+    connect: {
+        createConnectRouter: (opts?: Record<string, unknown>) => ConnectRouter;
+    };
+    protocol: {
+        universalServerRequestFromFetch: (request: Request, context: object) => UniversalServerRequest;
+        universalServerResponseToFetch: (response: UniversalServerResponse) => Response;
+    };
+}
+/** Configuration options for gRPC controller instantiation. */
+export interface IGrpcControllerOptions {
+    scope: string;
+    /** Falls back to @controller decorator path if not provided. */
+    path?: string;
+}
+/** Typed handler signature for gRPC RPC methods. */
+export type TRpcHandler<RequestType = unknown, ResponseType = unknown, RouteEnv extends Env = Env> = (opts: {
+    request: RequestType;
+    context: TRouteContext<RouteEnv>;
+}) => ValueOrPromise<ResponseType>;
+/** Pre-built middleware function for gRPC auth enforcement. */
+export type TRpcMiddleware<RouteEnv extends Env = Env> = (context: TRouteContext<RouteEnv>, next: Next) => ValueOrPromise<void | Response>;
+/** Unified registration entry: metadata + handler + pre-built middlewares stored together. */
+export interface IRpcRegistration<RouteEnv extends Env = Env> {
+    configs: IRpcMetadata;
+    handler: TRpcHandler<unknown, unknown, RouteEnv>;
+    middlewares: TRpcMiddleware<RouteEnv>[];
+}
+/** Return type from defineRoute - contains processed configs. */
+export interface IGrpcDefineRouteOptions {
+    configs: IRpcMetadata;
+}
+/** Fluent binding for two-step RPC registration: bindRoute({ configs }).to({ handler }). */
+export interface IGrpcBindRouteOptions<RouteEnv extends Env = Env> {
+    configs: IRpcMetadata;
+    to: (opts: {
+        handler: TRpcHandler<unknown, unknown, RouteEnv>;
+    }) => IGrpcDefineRouteOptions;
+}
+/** gRPC controller interface defining RPC registration and configuration contract. */
+export interface IGrpcController<RouteEnv extends Env = Env, RouteSchema extends Schema = {}, BasePath extends string = '/', ServiceType = unknown, ConfigurableOptions extends object = {}> extends IConfigurable<ConfigurableOptions> {
+    service: ServiceType;
+    router: Hono<RouteEnv, RouteSchema, BasePath>;
+    definitions: Record<string, IRpcRegistration<RouteEnv>>;
+    getRouter(): Hono<RouteEnv, RouteSchema, BasePath>;
+    bindRoute(opts: {
+        configs: IRpcMetadata;
+    }): IGrpcBindRouteOptions<RouteEnv>;
+    defineRoute(opts: {
+        configs: IRpcMetadata;
+        handler: TRpcHandler<unknown, unknown, RouteEnv>;
+    }): IGrpcDefineRouteOptions;
+}
+/** Result from GrpcRequestAdapter.build(). */
+export interface IConnectAdapterResult<RouteEnv extends Env = Env, BasePath extends string = '/', RouteInput extends Input = {}> {
+    paths: string[];
+    middleware: MiddlewareHandler<RouteEnv, BasePath, RouteInput>;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../../src/base/controllers/grpc/common/types.ts"],"names":[],"mappings":"","sourcesContent":["import type { TRouteContext } from '@venizia/ignis-kernel';\nimport type { IRpcMetadata } from '@venizia/ignis-kernel';\nimport type { ConnectRouter } from '@connectrpc/connect';\nimport type { UniversalServerRequest, UniversalServerResponse } from '@connectrpc/connect/protocol';\nimport type { IConfigurable, ValueOrPromise } from '@venizia/ignis-helpers/common';\nimport type { Env, Hono, Input, MiddlewareHandler, Next, Schema } from 'hono';\n\n/**\n * The ConnectRPC peer itself, handed over by an application that already holds it. A\n * `bun build --compile` binary carries no `node_modules`, so the lookup {@link GrpcRequestAdapter} makes with\n * `ModuleUtility.load` has nothing to resolve against - passing the modules through the gRPC\n * component options (or `ModuleUtility.register`) is what a compiled application does instead. Both entry points are needed: the\n * adapter builds its router from `@connectrpc/connect` and converts requests with\n * `@connectrpc/connect/protocol`. Typed as the shape the adapter actually calls, so a wrong module\n * is a compile error rather than a boot crash.\n */\nexport interface IConnectRpcModule {\n  connect: {\n    createConnectRouter: (opts?: Record<string, unknown>) => ConnectRouter;\n  };\n  protocol: {\n    universalServerRequestFromFetch: (request: Request, context: object) => UniversalServerRequest;\n    universalServerResponseToFetch: (response: UniversalServerResponse) => Response;\n  };\n}\n\n/** Configuration options for gRPC controller instantiation. */\nexport interface IGrpcControllerOptions {\n  scope: string;\n  /** Falls back to @controller decorator path if not provided. */\n  path?: string;\n}\n\n/** Typed handler signature for gRPC RPC methods. */\nexport type TRpcHandler<\n  RequestType = unknown,\n  ResponseType = unknown,\n  RouteEnv extends Env = Env,\n> = (opts: {\n  request: RequestType;\n  context: TRouteContext<RouteEnv>;\n}) => ValueOrPromise<ResponseType>;\n\n/** Pre-built middleware function for gRPC auth enforcement. */\nexport type TRpcMiddleware<RouteEnv extends Env = Env> = (\n  context: TRouteContext<RouteEnv>,\n  next: Next,\n) => ValueOrPromise<void | Response>;\n\n/** Unified registration entry: metadata + handler + pre-built middlewares stored together. */\nexport interface IRpcRegistration<RouteEnv extends Env = Env> {\n  configs: IRpcMetadata;\n  handler: TRpcHandler<unknown, unknown, RouteEnv>;\n  middlewares: TRpcMiddleware<RouteEnv>[];\n}\n\n/** Return type from defineRoute - contains processed configs. */\nexport interface IGrpcDefineRouteOptions {\n  configs: IRpcMetadata;\n}\n\n/** Fluent binding for two-step RPC registration: bindRoute({ configs }).to({ handler }). */\nexport interface IGrpcBindRouteOptions<RouteEnv extends Env = Env> {\n  configs: IRpcMetadata;\n  to: (opts: { handler: TRpcHandler<unknown, unknown, RouteEnv> }) => IGrpcDefineRouteOptions;\n}\n\n/** gRPC controller interface defining RPC registration and configuration contract. */\nexport interface IGrpcController<\n  RouteEnv extends Env = Env,\n  RouteSchema extends Schema = {},\n  BasePath extends string = '/',\n  ServiceType = unknown,\n  ConfigurableOptions extends object = {},\n> extends IConfigurable<ConfigurableOptions> {\n  service: ServiceType;\n  router: Hono<RouteEnv, RouteSchema, BasePath>;\n\n  definitions: Record<string, IRpcRegistration<RouteEnv>>;\n\n  getRouter(): Hono<RouteEnv, RouteSchema, BasePath>;\n\n  bindRoute(opts: { configs: IRpcMetadata }): IGrpcBindRouteOptions<RouteEnv>;\n  defineRoute(opts: {\n    configs: IRpcMetadata;\n    handler: TRpcHandler<unknown, unknown, RouteEnv>;\n  }): IGrpcDefineRouteOptions;\n}\n\n/** Result from GrpcRequestAdapter.build(). */\nexport interface IConnectAdapterResult<\n  RouteEnv extends Env = Env,\n  BasePath extends string = '/',\n  RouteInput extends Input = {},\n> {\n  paths: string[];\n  middleware: MiddlewareHandler<RouteEnv, BasePath, RouteInput>;\n}\n"]}

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

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

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

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/base/controllers/grpc/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC","sourcesContent":["export * from './abstract';\nexport * from './adapter';\nexport * from './base';\nexport * from './common';\n"]}

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

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

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

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

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

@@ -0,0 +1,5 @@
+// Every controller tier moved to the kernel except gRPC (ConnectRPC over `node:async_hooks` /
+// `node:module` - inherently server-only, never browser-pure).
+export * from '@venizia/ignis-kernel';
+export * from './grpc/index.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/base/controllers/index.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAC9F,+DAA+D;AAC/D,cAAc,uBAAuB,CAAC;AAEtC,cAAc,QAAQ,CAAC","sourcesContent":["// Every controller tier moved to the kernel except gRPC (ConnectRPC over `node:async_hooks` /\n// `node:module` - inherently server-only, never browser-pure).\nexport * from '@venizia/ignis-kernel';\n\nexport * from './grpc';\n"]}

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

@@ -0,0 +1,5 @@
+export * from '@venizia/ignis-kernel';
+export * from './applications/index.js';
+export * from './controllers/index.js';
+export * from './metadata/index.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/base/index.ts"],"names":[],"mappings":"AAIA,cAAc,uBAAuB,CAAC;AAEtC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC"}

package/dist/esm/base/index.js

@@ -0,0 +1,9 @@
+// `components`, `datasources`, `mixins`, `models`, `providers`, `repositories`, most of
+// `controllers` and `metadata`, and two of the five files under `applications`, moved to the
+// kernel - re-exported here so `@/base/...` keeps resolving for every core file that has not been
+// individually repointed.
+export * from '@venizia/ignis-kernel';
+export * from './applications/index.js';
+export * from './controllers/index.js';
+export * from './metadata/index.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/base/index.ts"],"names":[],"mappings":"AAAA,wFAAwF;AACxF,6FAA6F;AAC7F,kGAAkG;AAClG,0BAA0B;AAC1B,cAAc,uBAAuB,CAAC;AAEtC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC","sourcesContent":["// `components`, `datasources`, `mixins`, `models`, `providers`, `repositories`, most of\n// `controllers` and `metadata`, and two of the five files under `applications`, moved to the\n// kernel - re-exported here so `@/base/...` keeps resolving for every core file that has not been\n// individually repointed.\nexport * from '@venizia/ignis-kernel';\n\nexport * from './applications';\nexport * from './controllers';\nexport * from './metadata';\n"]}

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

@@ -0,0 +1,3 @@
+export * from '@venizia/ignis-kernel';
+export * from './request-context.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/base/metadata/index.ts"],"names":[],"mappings":"AAEA,cAAc,uBAAuB,CAAC;AAEtC,cAAc,mBAAmB,CAAC"}

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

@@ -0,0 +1,5 @@
+// `injectors`, `persistents` and `routes` moved to the kernel; `request-context.ts` stays - it
+// wraps `hono/context-storage`, which needs `node:async_hooks`.
+export * from '@venizia/ignis-kernel';
+export * from './request-context.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/base/metadata/index.ts"],"names":[],"mappings":"AAAA,+FAA+F;AAC/F,gEAAgE;AAChE,cAAc,uBAAuB,CAAC;AAEtC,cAAc,mBAAmB,CAAC","sourcesContent":["// `injectors`, `persistents` and `routes` moved to the kernel; `request-context.ts` stays - it\n// wraps `hono/context-storage`, which needs `node:async_hooks`.\nexport * from '@venizia/ignis-kernel';\n\nexport * from './request-context';\n"]}

package/dist/esm/base/metadata/request-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-context.d.ts","sourceRoot":"","sources":["../../../../src/base/metadata/request-context.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AAEtC,eAAO,MAAM,iBAAiB,GAAI,MAAM,SAAS,GAAG,GAAG,GAAG,0DAEzD,CAAC"}

package/dist/esm/base/metadata/request-context.js

@@ -0,0 +1,5 @@
+import { tryGetContext } from 'hono/context-storage';
+export const useRequestContext = () => {
+    return tryGetContext();
+};
+//# sourceMappingURL=request-context.js.map

package/dist/esm/base/metadata/request-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-context.js","sourceRoot":"","sources":["../../../../src/base/metadata/request-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAGrD,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAA6B,EAAE;IAC9D,OAAO,aAAa,EAAU,CAAC;AACjC,CAAC,CAAC","sourcesContent":["import { tryGetContext } from 'hono/context-storage';\nimport type { Env } from 'hono/types';\n\nexport const useRequestContext = <AppEnv extends Env = Env>() => {\n  return tryGetContext<AppEnv>();\n};\n"]}

package/dist/esm/base/middlewares/app-error/app-error.middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-error.middleware.d.ts","sourceRoot":"","sources":["../../../../../src/base/middlewares/app-error/app-error.middleware.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAEhE;;;;;;;;GAQG;AACH,qBAAa,kBAAmB,SAAQ,sBAAsB;gBAChD,IAAI,CAAC,EAAE;QACjB,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,sBAAsB,CAAC,EAAE,MAAM,CAAC;QAChC,qBAAqB,CAAC,EAAE,MAAM,CAAC;QAC/B,WAAW,CAAC,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;QACvC,WAAW,CAAC,EAAE,kBAAkB,CAAC;KAClC;CASF"}

package/dist/esm/base/middlewares/app-error/app-error.middleware.js

@@ -0,0 +1,23 @@
+import { Environment, ErrorPrettier } from '@venizia/ignis-helpers';
+import { BaseAppErrorMiddleware } from '@venizia/ignis-kernel';
+/**
+ * The server-side error handler: everything it does lives on {@link BaseAppErrorMiddleware}, which
+ * is browser-pure. This supplies the two host reads as OPTIONS - the ambient `NODE_ENV` through
+ * `Environment.ambient` (a read `bun build` cannot fold into a literal), and `ErrorPrettier`, which
+ * reaches `node:util` and so cannot sit in the kernel.
+ *
+ * A class only so the name `AppErrorMiddleware` keeps resolving for existing consumers; it overrides
+ * nothing. New code can pass the same two options to `BaseAppErrorMiddleware` directly.
+ */
+export class AppErrorMiddleware extends BaseAppErrorMiddleware {
+    constructor(opts) {
+        super({
+            ...opts,
+            // Present, so an unresolved name here is a real misconfiguration and keeps its error line - a
+            // node host always HAS an ambient environment, even when it is not set.
+            environment: opts?.environment ?? (() => Environment.ambient),
+            formatError: opts?.formatError ?? ((formatOpts) => ErrorPrettier.format(formatOpts)),
+        });
+    }
+}
+//# sourceMappingURL=app-error.middleware.js.map

package/dist/esm/base/middlewares/app-error/app-error.middleware.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-error.middleware.js","sourceRoot":"","sources":["../../../../../src/base/middlewares/app-error/app-error.middleware.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACpE,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAI/D;;;;;;;;GAQG;AACH,MAAM,OAAO,kBAAmB,SAAQ,sBAAsB;IAC5D,YAAY,IAOX;QACC,KAAK,CAAC;YACJ,GAAG,IAAI;YACP,8FAA8F;YAC9F,wEAAwE;YACxE,WAAW,EAAE,IAAI,EAAE,WAAW,IAAI,CAAC,GAAG,EAAE,CAAC,WAAW,CAAC,OAAO,CAAC;YAC7D,WAAW,EAAE,IAAI,EAAE,WAAW,IAAI,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,aAAa,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;SACrF,CAAC,CAAC;IACL,CAAC;CACF","sourcesContent":["import { Environment, ErrorPrettier } from '@venizia/ignis-helpers';\nimport { BaseAppErrorMiddleware } from '@venizia/ignis-kernel';\nimport type { ILogger } from '@venizia/ignis-helpers/core';\nimport type { TErrorLogFormatter } from '@venizia/ignis-kernel';\n\n/**\n * The server-side error handler: everything it does lives on {@link BaseAppErrorMiddleware}, which\n * is browser-pure. This supplies the two host reads as OPTIONS - the ambient `NODE_ENV` through\n * `Environment.ambient` (a read `bun build` cannot fold into a literal), and `ErrorPrettier`, which\n * reaches `node:util` and so cannot sit in the kernel.\n *\n * A class only so the name `AppErrorMiddleware` keeps resolving for existing consumers; it overrides\n * nothing. New code can pass the same two options to `BaseAppErrorMiddleware` directly.\n */\nexport class AppErrorMiddleware extends BaseAppErrorMiddleware {\n  constructor(opts?: {\n    logger?: ILogger;\n    rootKey?: string;\n    intentionalStackFrames?: number;\n    unexpectedStackFrames?: number;\n    environment?: () => string | undefined;\n    formatError?: TErrorLogFormatter;\n  }) {\n    super({\n      ...opts,\n      // Present, so an unresolved name here is a real misconfiguration and keeps its error line - a\n      // node host always HAS an ambient environment, even when it is not set.\n      environment: opts?.environment ?? (() => Environment.ambient),\n      formatError: opts?.formatError ?? ((formatOpts) => ErrorPrettier.format(formatOpts)),\n    });\n  }\n}\n"]}

package/dist/esm/base/middlewares/app-error/index.d.ts

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

package/dist/esm/base/middlewares/app-error/index.d.ts.map

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

package/dist/esm/base/middlewares/app-error/index.js

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

package/dist/esm/base/middlewares/app-error/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/base/middlewares/app-error/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC","sourcesContent":["export * from './app-error.middleware';\n"]}

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

@@ -0,0 +1,4 @@
+export * from '@venizia/ignis-kernel';
+export * from './app-error/index.js';
+export * from './request-spy/index.js';
+//# sourceMappingURL=index.d.ts.map