@webpieces/http-routing 0.3.368 → 0.3.370

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@webpieces/http-routing",
-  "version": "0.3.368",
+  "version": "0.3.370",
   "description": "Decorator-based routing with auto-wiring for WebPieces",
   "type": "commonjs",
   "main": "./src/index.js",
@@ -22,9 +22,9 @@
   },
   "dependencies": {
     "@inversifyjs/binding-decorators": "1.1.5",
-    "@webpieces/core-context": "0.3.368",
-    "@webpieces/core-util": "0.3.368",
-    "@webpieces/gcp-identity": "0.3.368",
+    "@webpieces/core-context": "0.3.370",
+    "@webpieces/core-util": "0.3.370",
+    "@webpieces/gcp-identity": "0.3.370",
     "inversify": "7.10.4",
     "jsonwebtoken": "9.0.2",
     "minimatch": "10.0.1"

package/src/AppModules.d.ts

@@ -53,6 +53,7 @@ export interface AppModules {
     getBindingModules(): ContainerModule[];
     /** The route groups to configure onto the router, in order. */
     getRoutingModules(): RouteModule[];
-    /** This app's own context keys, registered into the global HeaderRegistry at startup. */
+    /** This company's own context keys(usually all keys across all servers),
+     * registered into the global HeaderRegistry at startup. */
     getHeaders(): ContextKey[];
 }

package/src/AppModules.js.map

@@ -1 +1 @@
-{"version":3,"file":"AppModules.js","sourceRoot":"","sources":["../../../../../packages/http/http-routing/src/AppModules.ts"],"names":[],"mappings":"","sourcesContent":["import { ContainerModule } from 'inversify';\nimport { ContextKey } from '@webpieces/core-util';\nimport { WebpiecesRouter } from './WebpiecesRouter';\n\n/**\n * RouteModule - a reusable, named group of routes + filters, configured onto the\n * {@link WebpiecesRouter}. This is the TypeScript analog of a Java WebPieces \"RouteModule\":\n * instead of one anonymous `(router) => { ... }` block, each cohesive group of routes/filters\n * lives in its own named class, and an app composes several of them.\n *\n * A RouteModule holds business logic (it configures the router), so it is an interface — the\n * same category as {@link Routes} / {@link Filter}, NOT a data-only class (per the webpieces\n * guidelines).\n *\n * ```ts\n * export class AuthRoutes implements RouteModule {\n *   configure(router: WebpiecesRouter): void {\n *     router.addFilter(new FilterDefinition(1800, LogApiFilter, '*'));\n *     router.addRoutes(AuthApi, AuthController);\n *   }\n * }\n * ```\n */\nexport interface RouteModule {\n    /** Declare this group's routes + filters via {@link WebpiecesRouter.addRoutes} / addFilter. */\n    configure(router: WebpiecesRouter): void;\n}\n\n/**\n * AppModules - an app's COMPLETE server-surface declaration in one object: its DI binding modules,\n * its route groups, and its own context-key headers. It replaces the old split of a\n * `ContainerModule[]` + a `ContextKey[]` + an inline `(router) => void` callback threaded through\n * the bootstrap in separate arguments.\n *\n * Apps implement this on a class with a static `create()` factory, so the real server AND its\n * tests build the SAME object (tests then tweak it / pass a test override module):\n *\n * ```ts\n * export class MyAppModules implements AppModules {\n *   static create(): MyAppModules { return new MyAppModules(); }\n *   getBindingModules(): ContainerModule[] { return [InversifyModule]; }\n *   getRoutingModules(): RouteModule[] { return [new AppRoutes()]; }\n *   getHeaders(): ContextKey[] { return AppHeaders.getAllHeaders(); }\n * }\n *\n * // server.ts\n * await bootstrapServer(new BootstrapOptions(8200, 'my-svr'), MyAppModules.create());\n * ```\n *\n * AppModules is a provider interface (it hands back the app's pieces), the same category as the\n * former WebAppMeta — hence an interface, not a data-only class.\n */\nexport interface AppModules {\n    /** App-specific DI ContainerModules (beyond the standard company/framework set). */\n    getBindingModules(): ContainerModule[];\n    /** The route groups to configure onto the router, in order. */\n    getRoutingModules(): RouteModule[];\n    /** This app's own context keys, registered into the global HeaderRegistry at startup. */\n    getHeaders(): ContextKey[];\n}\n"]}
+{"version":3,"file":"AppModules.js","sourceRoot":"","sources":["../../../../../packages/http/http-routing/src/AppModules.ts"],"names":[],"mappings":"","sourcesContent":["import { ContainerModule } from 'inversify';\nimport { ContextKey } from '@webpieces/core-util';\nimport { WebpiecesRouter } from './WebpiecesRouter';\n\n/**\n * RouteModule - a reusable, named group of routes + filters, configured onto the\n * {@link WebpiecesRouter}. This is the TypeScript analog of a Java WebPieces \"RouteModule\":\n * instead of one anonymous `(router) => { ... }` block, each cohesive group of routes/filters\n * lives in its own named class, and an app composes several of them.\n *\n * A RouteModule holds business logic (it configures the router), so it is an interface — the\n * same category as {@link Routes} / {@link Filter}, NOT a data-only class (per the webpieces\n * guidelines).\n *\n * ```ts\n * export class AuthRoutes implements RouteModule {\n *   configure(router: WebpiecesRouter): void {\n *     router.addFilter(new FilterDefinition(1800, LogApiFilter, '*'));\n *     router.addRoutes(AuthApi, AuthController);\n *   }\n * }\n * ```\n */\nexport interface RouteModule {\n    /** Declare this group's routes + filters via {@link WebpiecesRouter.addRoutes} / addFilter. */\n    configure(router: WebpiecesRouter): void;\n}\n\n/**\n * AppModules - an app's COMPLETE server-surface declaration in one object: its DI binding modules,\n * its route groups, and its own context-key headers. It replaces the old split of a\n * `ContainerModule[]` + a `ContextKey[]` + an inline `(router) => void` callback threaded through\n * the bootstrap in separate arguments.\n *\n * Apps implement this on a class with a static `create()` factory, so the real server AND its\n * tests build the SAME object (tests then tweak it / pass a test override module):\n *\n * ```ts\n * export class MyAppModules implements AppModules {\n *   static create(): MyAppModules { return new MyAppModules(); }\n *   getBindingModules(): ContainerModule[] { return [InversifyModule]; }\n *   getRoutingModules(): RouteModule[] { return [new AppRoutes()]; }\n *   getHeaders(): ContextKey[] { return AppHeaders.getAllHeaders(); }\n * }\n *\n * // server.ts\n * await bootstrapServer(new BootstrapOptions(8200, 'my-svr'), MyAppModules.create());\n * ```\n *\n * AppModules is a provider interface (it hands back the app's pieces), the same category as the\n * former WebAppMeta — hence an interface, not a data-only class.\n */\nexport interface AppModules {\n    /** App-specific DI ContainerModules (beyond the standard company/framework set). */\n    getBindingModules(): ContainerModule[];\n    /** The route groups to configure onto the router, in order. */\n    getRoutingModules(): RouteModule[];\n    /** This company's own context keys(usually all keys across all servers),\n     * registered into the global HeaderRegistry at startup. */\n    getHeaders(): ContextKey[];\n}\n"]}

package/src/setupRuntime.d.ts

@@ -1,38 +1,30 @@
 import { ContainerModule } from 'inversify';
-import { ContextKey, LoggerFactory } from '@webpieces/core-util';
+import { LoggerFactory } from '@webpieces/core-util';
 import { WebpiecesConfig } from './WebpiecesConfig';
 import { AppModules } from './AppModules';
 import { ApiFactory } from './ApiFactory';
 /**
  * RuntimeSetupOptions - the environment/wiring inputs to {@link setupRuntime} (everything NOT
- * declared by the app's {@link AppModules}): the logging backend, the company/platform header
- * tiers, the test-override module, and config. Data-only structure (a class, per the webpieces
- * guidelines). The app's own binding modules + route groups + headers come from the AppModules
- * passed alongside.
+ * declared by the app's {@link AppModules}): the logging backend, whether to include the platform
+ * default headers, and config. Data-only structure (a class, per the webpieces guidelines). The
+ * app's own binding modules + route groups + headers come from the AppModules passed alongside;
+ * the test-override module is the separate `appOverrides` param of {@link setupRuntime}.
  *
- * Header tiers mirror {@link HeaderRegistry.configure}: platform defaults + org/company keys +
- * this-service keys (the this-service keys are AppModules.getHeaders()).
+ * Headers: {@link HeaderRegistry.configure} registers the platform defaults (when
+ * `platformHeaders` is true) plus AppModules.getHeaders() (by convention the company-wide set).
  */
 export declare class RuntimeSetupOptions {
     /** Logging backend to install (LogManager.setFactory). */
     readonly loggerFactory: LoggerFactory;
-    /** Org/company-wide shared context keys (the company layer passes these in). */
-    readonly companyHeaders: ContextKey[];
     /** Include the webpieces platform default headers. */
     readonly platformHeaders: boolean;
-    /** A single DI module loaded LAST so tests can rebind bindings to mocks. */
-    readonly appOverrides?: ContainerModule | undefined;
     /** Optional WebpiecesConfig (e.g. recording flags); defaults to a fresh one. */
     readonly config?: WebpiecesConfig | undefined;
     constructor(
     /** Logging backend to install (LogManager.setFactory). */
     loggerFactory: LoggerFactory, 
-    /** Org/company-wide shared context keys (the company layer passes these in). */
-    companyHeaders?: ContextKey[], 
     /** Include the webpieces platform default headers. */
     platformHeaders?: boolean, 
-    /** A single DI module loaded LAST so tests can rebind bindings to mocks. */
-    appOverrides?: ContainerModule | undefined, 
     /** Optional WebpiecesConfig (e.g. recording flags); defaults to a fresh one. */
     config?: WebpiecesConfig | undefined);
 }
@@ -50,4 +42,7 @@ export declare class RuntimeSetupOptions {
  * `createApiClient()` for in-process tests. There is NO express (or any transport) here; a
  * transport adapter (e.g. WebpiecesExpressRouter in @webpieces/http-server) serves the result.
  */
-export declare function setupRuntime(options: RuntimeSetupOptions, appModules: AppModules): Promise<ApiFactory>;
+export declare function setupRuntime(options: RuntimeSetupOptions, appModules: AppModules, 
+/** A single DI module loaded LAST so tests can rebind bindings to mocks.
+ * Or special case servers that want to override specific things */
+appOverrides?: ContainerModule): Promise<ApiFactory>;

package/src/setupRuntime.js

@@ -7,35 +7,27 @@ const WebpiecesConfig_1 = require("./WebpiecesConfig");
 const WebpiecesRouter_1 = require("./WebpiecesRouter");
 /**
  * RuntimeSetupOptions - the environment/wiring inputs to {@link setupRuntime} (everything NOT
- * declared by the app's {@link AppModules}): the logging backend, the company/platform header
- * tiers, the test-override module, and config. Data-only structure (a class, per the webpieces
- * guidelines). The app's own binding modules + route groups + headers come from the AppModules
- * passed alongside.
+ * declared by the app's {@link AppModules}): the logging backend, whether to include the platform
+ * default headers, and config. Data-only structure (a class, per the webpieces guidelines). The
+ * app's own binding modules + route groups + headers come from the AppModules passed alongside;
+ * the test-override module is the separate `appOverrides` param of {@link setupRuntime}.
  *
- * Header tiers mirror {@link HeaderRegistry.configure}: platform defaults + org/company keys +
- * this-service keys (the this-service keys are AppModules.getHeaders()).
+ * Headers: {@link HeaderRegistry.configure} registers the platform defaults (when
+ * `platformHeaders` is true) plus AppModules.getHeaders() (by convention the company-wide set).
  */
 class RuntimeSetupOptions {
     loggerFactory;
-    companyHeaders;
     platformHeaders;
-    appOverrides;
     config;
     constructor(
     /** Logging backend to install (LogManager.setFactory). */
     loggerFactory, 
-    /** Org/company-wide shared context keys (the company layer passes these in). */
-    companyHeaders = [], 
     /** Include the webpieces platform default headers. */
     platformHeaders = true, 
-    /** A single DI module loaded LAST so tests can rebind bindings to mocks. */
-    appOverrides, 
     /** Optional WebpiecesConfig (e.g. recording flags); defaults to a fresh one. */
     config) {
         this.loggerFactory = loggerFactory;
-        this.companyHeaders = companyHeaders;
         this.platformHeaders = platformHeaders;
-        this.appOverrides = appOverrides;
         this.config = config;
     }
 }
@@ -54,15 +46,18 @@ exports.RuntimeSetupOptions = RuntimeSetupOptions;
  * `createApiClient()` for in-process tests. There is NO express (or any transport) here; a
  * transport adapter (e.g. WebpiecesExpressRouter in @webpieces/http-server) serves the result.
  */
-async function setupRuntime(options, appModules) {
+async function setupRuntime(options, appModules, 
+/** A single DI module loaded LAST so tests can rebind bindings to mocks.
+ * Or special case servers that want to override specific things */
+appOverrides) {
     // 1. Register the global HeaderRegistry FIRST (this service's own keys come from AppModules).
-    core_util_1.HeaderRegistry.configure(appModules.getHeaders(), options.companyHeaders, options.platformHeaders);
+    core_util_1.HeaderRegistry.configure(appModules.getHeaders(), options.platformHeaders);
     // 2. Install the logging backend ONCE, before anything else logs.
     core_util_1.LogManager.setFactory(options.loggerFactory);
     // 3. Build the node-only router + DI container.
     const router = await WebpiecesRouter_1.WebpiecesRouterFactory.create({
         appBindings: [...appModules.getBindingModules()],
-        appOverrides: options.appOverrides,
+        appOverrides: appOverrides,
         config: options.config ?? new WebpiecesConfig_1.WebpiecesConfig(),
     });
     // 4. Let each route group declare its routes + filters, then hand back the consumer surface.

package/src/setupRuntime.js.map

@@ -1 +1 @@
-{"version":3,"file":"setupRuntime.js","sourceRoot":"","sources":["../../../../../packages/http/http-routing/src/setupRuntime.ts"],"names":[],"mappings":";;;AA8CA,oCAsBC;AAnED,oDAA6F;AAC7F,uDAAoD;AACpD,uDAA2D;AAI3D;;;;;;;;;GASG;AACH,MAAa,mBAAmB;IAGR;IAEA;IAEA;IAEA;IAEA;IAVpB;IACI,0DAA0D;IAC1C,aAA4B;IAC5C,gFAAgF;IAChE,iBAA+B,EAAE;IACjD,sDAAsD;IACtC,kBAA2B,IAAI;IAC/C,4EAA4E;IAC5D,YAA8B;IAC9C,gFAAgF;IAChE,MAAwB;QARxB,kBAAa,GAAb,aAAa,CAAe;QAE5B,mBAAc,GAAd,cAAc,CAAmB;QAEjC,oBAAe,GAAf,eAAe,CAAgB;QAE/B,iBAAY,GAAZ,YAAY,CAAkB;QAE9B,WAAM,GAAN,MAAM,CAAkB;IACzC,CAAC;CACP;AAbD,kDAaC;AAED;;;;;;;;;;;;;GAaG;AACI,KAAK,UAAU,YAAY,CAC9B,OAA4B,EAC5B,UAAsB;IAEtB,8FAA8F;IAC9F,0BAAc,CAAC,SAAS,CAAC,UAAU,CAAC,UAAU,EAAE,EAAE,OAAO,CAAC,cAAc,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC;IAEnG,kEAAkE;IAClE,sBAAU,CAAC,UAAU,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;IAE7C,gDAAgD;IAChD,MAAM,MAAM,GAAG,MAAM,wCAAsB,CAAC,MAAM,CAAC;QAC/C,WAAW,EAAE,CAAC,GAAG,UAAU,CAAC,iBAAiB,EAAE,CAAC;QAChD,YAAY,EAAE,OAAO,CAAC,YAAY;QAClC,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,IAAI,iCAAe,EAAE;KAClD,CAAC,CAAC;IAEH,6FAA6F;IAC7F,KAAK,MAAM,WAAW,IAAI,UAAU,CAAC,iBAAiB,EAAE,EAAE,CAAC;QACvD,WAAW,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAClC,CAAC;IACD,OAAO,MAAM,CAAC;AAClB,CAAC","sourcesContent":["import { ContainerModule } from 'inversify';\nimport { ContextKey, HeaderRegistry, LoggerFactory, LogManager } from '@webpieces/core-util';\nimport { WebpiecesConfig } from './WebpiecesConfig';\nimport { WebpiecesRouterFactory } from './WebpiecesRouter';\nimport { AppModules } from './AppModules';\nimport { ApiFactory } from './ApiFactory';\n\n/**\n * RuntimeSetupOptions - the environment/wiring inputs to {@link setupRuntime} (everything NOT\n * declared by the app's {@link AppModules}): the logging backend, the company/platform header\n * tiers, the test-override module, and config. Data-only structure (a class, per the webpieces\n * guidelines). The app's own binding modules + route groups + headers come from the AppModules\n * passed alongside.\n *\n * Header tiers mirror {@link HeaderRegistry.configure}: platform defaults + org/company keys +\n * this-service keys (the this-service keys are AppModules.getHeaders()).\n */\nexport class RuntimeSetupOptions {\n    constructor(\n        /** Logging backend to install (LogManager.setFactory). */\n        public readonly loggerFactory: LoggerFactory,\n        /** Org/company-wide shared context keys (the company layer passes these in). */\n        public readonly companyHeaders: ContextKey[] = [],\n        /** Include the webpieces platform default headers. */\n        public readonly platformHeaders: boolean = true,\n        /** A single DI module loaded LAST so tests can rebind bindings to mocks. */\n        public readonly appOverrides?: ContainerModule,\n        /** Optional WebpiecesConfig (e.g. recording flags); defaults to a fresh one. */\n        public readonly config?: WebpiecesConfig,\n    ) {}\n}\n\n/**\n * setupRuntime - the ONE canonical, TRANSPORT-FREE startup sequence, reusable by any company/app\n * AND any framework adapter (express, fastify, a serverless handler, ...). It runs, in the correct\n * fail-fast order:\n *\n *   1. HeaderRegistry.configure  (filters read it at construction; logging masks off it)\n *   2. LogManager.setFactory     (fails fast unless the registry is configured first)\n *   3. build the router + DI container (from appModules.getBindingModules())\n *   4. configure each appModules.getRoutingModules() onto the router (addRoutes/addFilter)\n *\n * and returns the built {@link ApiFactory} — `apiClients()` for a transport to bind, or\n * `createApiClient()` for in-process tests. There is NO express (or any transport) here; a\n * transport adapter (e.g. WebpiecesExpressRouter in @webpieces/http-server) serves the result.\n */\nexport async function setupRuntime(\n    options: RuntimeSetupOptions,\n    appModules: AppModules,\n): Promise<ApiFactory> {\n    // 1. Register the global HeaderRegistry FIRST (this service's own keys come from AppModules).\n    HeaderRegistry.configure(appModules.getHeaders(), options.companyHeaders, options.platformHeaders);\n\n    // 2. Install the logging backend ONCE, before anything else logs.\n    LogManager.setFactory(options.loggerFactory);\n\n    // 3. Build the node-only router + DI container.\n    const router = await WebpiecesRouterFactory.create({\n        appBindings: [...appModules.getBindingModules()],\n        appOverrides: options.appOverrides,\n        config: options.config ?? new WebpiecesConfig(),\n    });\n\n    // 4. Let each route group declare its routes + filters, then hand back the consumer surface.\n    for (const routeModule of appModules.getRoutingModules()) {\n        routeModule.configure(router);\n    }\n    return router;\n}\n"]}
+{"version":3,"file":"setupRuntime.js","sourceRoot":"","sources":["../../../../../packages/http/http-routing/src/setupRuntime.ts"],"names":[],"mappings":";;;AA0CA,oCAyBC;AAlED,oDAAiF;AACjF,uDAAoD;AACpD,uDAA2D;AAI3D;;;;;;;;;GASG;AACH,MAAa,mBAAmB;IAGR;IAEA;IAEA;IANpB;IACI,0DAA0D;IAC1C,aAA4B;IAC5C,sDAAsD;IACtC,kBAA2B,IAAI;IAC/C,gFAAgF;IAChE,MAAwB;QAJxB,kBAAa,GAAb,aAAa,CAAe;QAE5B,oBAAe,GAAf,eAAe,CAAgB;QAE/B,WAAM,GAAN,MAAM,CAAkB;IACzC,CAAC;CACP;AATD,kDASC;AAED;;;;;;;;;;;;;GAaG;AACI,KAAK,UAAU,YAAY,CAC9B,OAA4B,EAC5B,UAAsB;AACtB;mEACmE;AACnE,YAA8B;IAE9B,8FAA8F;IAC9F,0BAAc,CAAC,SAAS,CAAC,UAAU,CAAC,UAAU,EAAE,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC;IAE3E,kEAAkE;IAClE,sBAAU,CAAC,UAAU,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;IAE7C,gDAAgD;IAChD,MAAM,MAAM,GAAG,MAAM,wCAAsB,CAAC,MAAM,CAAC;QAC/C,WAAW,EAAE,CAAC,GAAG,UAAU,CAAC,iBAAiB,EAAE,CAAC;QAChD,YAAY,EAAE,YAAY;QAC1B,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,IAAI,iCAAe,EAAE;KAClD,CAAC,CAAC;IAEH,6FAA6F;IAC7F,KAAK,MAAM,WAAW,IAAI,UAAU,CAAC,iBAAiB,EAAE,EAAE,CAAC;QACvD,WAAW,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAClC,CAAC;IACD,OAAO,MAAM,CAAC;AAClB,CAAC","sourcesContent":["import { ContainerModule } from 'inversify';\nimport { HeaderRegistry, LoggerFactory, LogManager } from '@webpieces/core-util';\nimport { WebpiecesConfig } from './WebpiecesConfig';\nimport { WebpiecesRouterFactory } from './WebpiecesRouter';\nimport { AppModules } from './AppModules';\nimport { ApiFactory } from './ApiFactory';\n\n/**\n * RuntimeSetupOptions - the environment/wiring inputs to {@link setupRuntime} (everything NOT\n * declared by the app's {@link AppModules}): the logging backend, whether to include the platform\n * default headers, and config. Data-only structure (a class, per the webpieces guidelines). The\n * app's own binding modules + route groups + headers come from the AppModules passed alongside;\n * the test-override module is the separate `appOverrides` param of {@link setupRuntime}.\n *\n * Headers: {@link HeaderRegistry.configure} registers the platform defaults (when\n * `platformHeaders` is true) plus AppModules.getHeaders() (by convention the company-wide set).\n */\nexport class RuntimeSetupOptions {\n    constructor(\n        /** Logging backend to install (LogManager.setFactory). */\n        public readonly loggerFactory: LoggerFactory,\n        /** Include the webpieces platform default headers. */\n        public readonly platformHeaders: boolean = true,\n        /** Optional WebpiecesConfig (e.g. recording flags); defaults to a fresh one. */\n        public readonly config?: WebpiecesConfig,\n    ) {}\n}\n\n/**\n * setupRuntime - the ONE canonical, TRANSPORT-FREE startup sequence, reusable by any company/app\n * AND any framework adapter (express, fastify, a serverless handler, ...). It runs, in the correct\n * fail-fast order:\n *\n *   1. HeaderRegistry.configure  (filters read it at construction; logging masks off it)\n *   2. LogManager.setFactory     (fails fast unless the registry is configured first)\n *   3. build the router + DI container (from appModules.getBindingModules())\n *   4. configure each appModules.getRoutingModules() onto the router (addRoutes/addFilter)\n *\n * and returns the built {@link ApiFactory} — `apiClients()` for a transport to bind, or\n * `createApiClient()` for in-process tests. There is NO express (or any transport) here; a\n * transport adapter (e.g. WebpiecesExpressRouter in @webpieces/http-server) serves the result.\n */\nexport async function setupRuntime(\n    options: RuntimeSetupOptions,\n    appModules: AppModules,\n    /** A single DI module loaded LAST so tests can rebind bindings to mocks.\n     * Or special case servers that want to override specific things */\n    appOverrides?: ContainerModule,\n): Promise<ApiFactory> {\n    // 1. Register the global HeaderRegistry FIRST (this service's own keys come from AppModules).\n    HeaderRegistry.configure(appModules.getHeaders(), options.platformHeaders);\n\n    // 2. Install the logging backend ONCE, before anything else logs.\n    LogManager.setFactory(options.loggerFactory);\n\n    // 3. Build the node-only router + DI container.\n    const router = await WebpiecesRouterFactory.create({\n        appBindings: [...appModules.getBindingModules()],\n        appOverrides: appOverrides,\n        config: options.config ?? new WebpiecesConfig(),\n    });\n\n    // 4. Let each route group declare its routes + filters, then hand back the consumer surface.\n    for (const routeModule of appModules.getRoutingModules()) {\n        routeModule.configure(router);\n    }\n    return router;\n}\n"]}