@fluojs/runtime 2.0.1 → 3.0.0

package/dist/devtools/studio-runtime.js

@@ -1,28 +1,25 @@
-import { createStudioLiveSnapshot, handlerToStudioRouteDescriptor } from './snapshot.js';
+import { createStudioLiveSnapshot } from './snapshot.js';
+import { StudioRequestObserver } from './studio-request-observer.js';
+import { captureStudioDevtoolsConfig } from './studio-runtime-config.js';
 const runtimePerformance = globalThis.performance ?? {
   now: () => Date.now()
 };
 const processStart = runtimePerformance.now();
 
 /**
- * Describes Studio Devtools Runtime Transport data used by the Studio devtool.
+ * Host-owned transport that receives live Studio events.
+ *
+ * Transport failures are ignored so Studio instrumentation remains observational.
  */
 
 /**
- * Describes Studio Devtools Runtime Options data used by the Studio devtool.
+ * Options for a host-owned Studio bridge.
  */
 
 /**
  * Describes Studio Bootstrap Snapshot Input data used by the Studio devtool.
  */
 
-/**
- * Describes Studio Devtools Config data used by the Studio devtool.
- */
-
-function isEnabled(value) {
-  return value === '1' || value === 'true' || value === 'yes';
-}
 function createEpoch() {
   if (typeof globalThis.crypto?.randomUUID === 'function') {
     return globalThis.crypto.randomUUID();
@@ -32,77 +29,6 @@ function createEpoch() {
 function createAppId() {
   return `app-${Date.now().toString(36)}-${Math.random().toString(36).slice(2)}`;
 }
-function createRequestId() {
-  return `req-${Date.now().toString(36)}-${Math.random().toString(36).slice(2)}`;
-}
-function normalizeRuntime(value) {
-  if (value === 'node' || value === 'bun' || value === 'deno' || value === 'worker') {
-    return value;
-  }
-  return 'node';
-}
-function isRecord(value) {
-  return typeof value === 'object' && value !== null;
-}
-function resolveEndpoint(env) {
-  if (env.FLUO_STUDIO_ENDPOINT) {
-    return env.FLUO_STUDIO_ENDPOINT;
-  }
-  if (!env.FLUO_STUDIO_URL) {
-    return undefined;
-  }
-  try {
-    return new URL('/api/runtime/events', env.FLUO_STUDIO_URL).toString();
-  } catch {
-    return undefined;
-  }
-}
-function toErrorPayload(error) {
-  if (error instanceof Error) {
-    return {
-      message: error.message,
-      name: error.name
-    };
-  }
-  return {
-    message: String(error)
-  };
-}
-function sanitizeRequestUrl(value) {
-  try {
-    const parsed = new URL(value, 'http://fluo.local');
-    return parsed.pathname || '/';
-  } catch {
-    return value.split('#', 1)[0]?.split('?', 1)[0] || value;
-  }
-}
-function traceToPayload(trace, statusCode) {
-  const payload = {
-    method: trace.method,
-    path: trace.path,
-    requestId: trace.requestId,
-    startedAt: trace.startedAt,
-    status: trace.status,
-    url: trace.url
-  };
-  if (trace.handler) {
-    const route = handlerToStudioRouteDescriptor(trace.handler);
-    payload.controller = route.controller;
-    payload.handler = route.handler;
-    payload.routeId = route.id;
-  }
-  if (trace.error) {
-    payload.error = trace.error;
-  }
-  if (statusCode !== undefined) {
-    payload.statusCode = statusCode;
-  }
-  if (trace.status === 'succeeded' || trace.status === 'failed' || trace.status === 'finished') {
-    payload.finishedAt = new Date().toISOString();
-    payload.durationMs = Number((runtimePerformance.now() - trace.startMs).toFixed(3));
-  }
-  return payload;
-}
 class FetchStudioTransport {
   constructor(endpoint, token) {
     this.endpoint = endpoint;
@@ -119,73 +45,13 @@ class FetchStudioTransport {
     });
   }
 }
-class StudioRequestObserver {
-  traces = new WeakMap();
-  constructor(runtime) {
-    this.runtime = runtime;
-  }
-  onRequestStart(context) {
-    const request = context.requestContext.request;
-    const requestId = request.requestId ?? (typeof request.headers['x-request-id'] === 'string' ? request.headers['x-request-id'] : undefined) ?? createRequestId();
-    const trace = {
-      method: request.method,
-      path: request.path,
-      requestId,
-      startedAt: new Date().toISOString(),
-      startMs: runtimePerformance.now(),
-      status: 'started',
-      url: sanitizeRequestUrl(request.url)
-    };
-    this.traces.set(context.requestContext, trace);
-    this.runtime.publish('request', traceToPayload(trace));
-  }
-  onHandlerMatched(context) {
-    const trace = this.ensureTrace(context);
-    trace.handler = context.handler;
-    trace.status = 'matched';
-    this.runtime.publish('request', traceToPayload(trace));
-  }
-  onRequestSuccess(context) {
-    const trace = this.ensureTrace(context);
-    trace.handler = context.handler ?? trace.handler;
-    trace.status = 'succeeded';
-  }
-  onRequestError(context, error) {
-    const trace = this.ensureTrace(context);
-    trace.handler = context.handler ?? trace.handler;
-    trace.error = toErrorPayload(error);
-    trace.status = 'failed';
-    this.runtime.publish('request', traceToPayload(trace, context.requestContext.response.statusCode));
-  }
-  onRequestFinish(context) {
-    const trace = this.ensureTrace(context);
-    trace.handler = context.handler ?? trace.handler;
-    if (trace.status !== 'failed' && trace.status !== 'succeeded') {
-      trace.status = 'finished';
-    }
-    this.runtime.publish('request', traceToPayload(trace, context.requestContext.response.statusCode));
-  }
-  ensureTrace(context) {
-    const existing = this.traces.get(context.requestContext);
-    if (existing) {
-      return existing;
-    }
-    const request = context.requestContext.request;
-    const trace = {
-      method: request.method,
-      path: request.path,
-      requestId: request.requestId ?? createRequestId(),
-      startedAt: new Date().toISOString(),
-      startMs: runtimePerformance.now(),
-      status: 'started',
-      url: sanitizeRequestUrl(request.url)
-    };
-    this.traces.set(context.requestContext, trace);
-    return trace;
-  }
-}
 
-/** Process-local runtime bridge used only when Studio env injection is present. */
+/**
+ * Host-owned bridge for publishing live Studio bootstrap and request events.
+ *
+ * Pass an instance as `studioDevtools` to application or context bootstrap.
+ * Event delivery is observational: transport throws and rejections never alter runtime behavior.
+ */
 export class StudioDevtoolsRuntime {
   epoch;
   observer = new StudioRequestObserver(this);
@@ -215,7 +81,11 @@ export class StudioDevtoolsRuntime {
       type,
       version: 1
     };
-    void Promise.resolve(this.options.transport.publish(event)).catch(() => undefined);
+    try {
+      void Promise.resolve(this.options.transport.publish(event)).catch(() => undefined);
+    } catch {
+      // Studio instrumentation must remain observational when a host transport throws.
+    }
   }
   publishBootstrapSnapshot(input) {
     const snapshot = createStudioLiveSnapshot({
@@ -237,17 +107,6 @@ export class StudioDevtoolsRuntime {
     });
   }
 }
-const STUDIO_DEVTOOLS_GLOBAL_CONFIG_KEY = '__FLUO_STUDIO_DEVTOOLS_CONFIG__';
-function isStudioDevtoolsConfig(value) {
-  if (!isRecord(value)) {
-    return false;
-  }
-  return value.FLUO_STUDIO === undefined || typeof value.FLUO_STUDIO === 'string';
-}
-function readInjectedStudioDevtoolsConfig() {
-  const value = globalThis[STUDIO_DEVTOOLS_GLOBAL_CONFIG_KEY];
-  return isStudioDevtoolsConfig(value) ? value : undefined;
-}
 
 /**
  * Creates the Studio runtime bridge from explicit CLI-injected config.
@@ -256,20 +115,17 @@ function readInjectedStudioDevtoolsConfig() {
  * @param config Explicit Studio config injected by the application boundary.
  * @returns Studio runtime bridge, or `undefined` when Studio is disabled or incomplete.
  */
-export function createStudioDevtoolsRuntimeFromConfig(config = readInjectedStudioDevtoolsConfig()) {
-  if (!config || !isEnabled(config.FLUO_STUDIO)) {
-    return undefined;
-  }
-  const endpoint = resolveEndpoint(config);
-  if (!endpoint || !config.FLUO_STUDIO_TOKEN || typeof globalThis.fetch !== 'function') {
+export function createStudioDevtoolsRuntimeFromConfig(config) {
+  const snapshot = captureStudioDevtoolsConfig(config);
+  if (!snapshot || typeof globalThis.fetch !== 'function') {
     return undefined;
   }
-  const epoch = config.FLUO_STUDIO_EPOCH ?? createEpoch();
+  const epoch = snapshot.epoch ?? createEpoch();
   return new StudioDevtoolsRuntime({
-    appId: config.FLUO_STUDIO_APP_ID ?? createAppId(),
+    appId: snapshot.appId ?? createAppId(),
     epoch,
-    runtime: normalizeRuntime(config.FLUO_STUDIO_RUNTIME),
-    transport: new FetchStudioTransport(endpoint, config.FLUO_STUDIO_TOKEN)
+    runtime: snapshot.runtime,
+    transport: new FetchStudioTransport(snapshot.endpoint, snapshot.token)
   });
 }
 

package/dist/errors.d.ts

@@ -1,4 +1,30 @@
 import { FluoError } from '@fluojs/core';
+/**
+ * Public lifecycle operations supported by {@link PlatformLifecycleConflictError}.
+ */
+export type PlatformLifecycleOperation = 'start' | 'stop';
+/**
+ * Error returned when a platform shell lifecycle request overlaps an active transition.
+ *
+ * @remarks
+ * Platform shell lifecycle transitions are strictly exclusive. Callers can inspect
+ * {@link PlatformLifecycleConflictError.activeOperation} and
+ * {@link PlatformLifecycleConflictError.requestedOperation}, wait for their own active
+ * operation to settle, and then retry explicitly.
+ */
+export declare class PlatformLifecycleConflictError extends FluoError {
+    /** Lifecycle operation that currently owns the platform shell transition. */
+    readonly activeOperation: PlatformLifecycleOperation;
+    /** Lifecycle operation rejected because another transition is active. */
+    readonly requestedOperation: PlatformLifecycleOperation;
+    /**
+     * Creates a platform lifecycle conflict error.
+     *
+     * @param activeOperation Lifecycle operation that currently owns the transition.
+     * @param requestedOperation Overlapping lifecycle operation that was rejected.
+     */
+    constructor(activeOperation: PlatformLifecycleOperation, requestedOperation: PlatformLifecycleOperation);
+}
 /**
  * Structured context for runtime-level errors.
  */

package/dist/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAmB,MAAM,cAAc,CAAC;AAE1D;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,mDAAmD;IACnD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,4CAA4C;IAC5C,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,gDAAgD;IAChD,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,+CAA+C;IAC/C,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAuCD;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,SAAS;gBACjC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB;CAS3D;AAED;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,SAAS;gBACtC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB;CAS3D;AAED;;GAEG;AACH,qBAAa,4BAA6B,SAAQ,SAAS;gBAC7C,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB;CAS3D;AAED;;GAEG;AACH,qBAAa,sBAAuB,SAAQ,SAAS;gBACvC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB;CAS3D"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAmB,MAAM,cAAc,CAAC;AAE1D;;GAEG;AACH,MAAM,MAAM,0BAA0B,GAAG,OAAO,GAAG,MAAM,CAAC;AAE1D;;;;;;;;GAQG;AACH,qBAAa,8BAA+B,SAAQ,SAAS;IAC3D,6EAA6E;IAC7E,QAAQ,CAAC,eAAe,EAAE,0BAA0B,CAAC;IACrD,yEAAyE;IACzE,QAAQ,CAAC,kBAAkB,EAAE,0BAA0B,CAAC;IAExD;;;;;OAKG;gBACS,eAAe,EAAE,0BAA0B,EAAE,kBAAkB,EAAE,0BAA0B;CAWxG;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,mDAAmD;IACnD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,4CAA4C;IAC5C,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,gDAAgD;IAChD,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,+CAA+C;IAC/C,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAuCD;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,SAAS;gBACjC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB;CAS3D;AAED;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,SAAS;gBACtC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB;CAS3D;AAED;;GAEG;AACH,qBAAa,4BAA6B,SAAQ,SAAS;gBAC7C,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB;CAS3D;AAED;;GAEG;AACH,qBAAa,sBAAuB,SAAQ,SAAS;gBACvC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB;CAS3D"}

package/dist/errors.js

@@ -1,5 +1,43 @@
 import { FluoError, formatTokenName } from '@fluojs/core';
 
+/**
+ * Public lifecycle operations supported by {@link PlatformLifecycleConflictError}.
+ */
+
+/**
+ * Error returned when a platform shell lifecycle request overlaps an active transition.
+ *
+ * @remarks
+ * Platform shell lifecycle transitions are strictly exclusive. Callers can inspect
+ * {@link PlatformLifecycleConflictError.activeOperation} and
+ * {@link PlatformLifecycleConflictError.requestedOperation}, wait for their own active
+ * operation to settle, and then retry explicitly.
+ */
+export class PlatformLifecycleConflictError extends FluoError {
+  /** Lifecycle operation that currently owns the platform shell transition. */
+  activeOperation;
+  /** Lifecycle operation rejected because another transition is active. */
+  requestedOperation;
+
+  /**
+   * Creates a platform lifecycle conflict error.
+   *
+   * @param activeOperation Lifecycle operation that currently owns the transition.
+   * @param requestedOperation Overlapping lifecycle operation that was rejected.
+   */
+  constructor(activeOperation, requestedOperation) {
+    super(`Cannot ${requestedOperation} the platform shell while ${activeOperation} is active.`, {
+      code: 'PLATFORM_LIFECYCLE_CONFLICT',
+      meta: {
+        activeOperation,
+        requestedOperation
+      }
+    });
+    this.activeOperation = activeOperation;
+    this.requestedOperation = requestedOperation;
+  }
+}
+
 /**
  * Structured context for runtime-level errors.
  */

package/dist/health/health.d.ts

@@ -1,3 +1,5 @@
+import type { Constructor } from '@fluojs/core';
+import { type Middleware } from '@fluojs/http/portable';
 import type { ModuleType } from '../types.js';
 /**
  * Describes the health status contract.
@@ -22,13 +24,15 @@ export interface ReadinessStatus {
  * Describes the health module options contract.
  */
 export interface HealthModuleOptions {
-    healthCheck?: (ctx: import('@fluojs/http').RequestContext) => HealthStatus | HealthCheckResponse | Promise<HealthStatus | HealthCheckResponse>;
+    /** Class-based middleware applied only to the generated `/health` and `/ready` endpoints. */
+    endpointMiddleware?: readonly Constructor<Middleware>[];
+    healthCheck?: (ctx: import('@fluojs/http/portable').RequestContext) => HealthStatus | HealthCheckResponse | Promise<HealthStatus | HealthCheckResponse>;
     path?: string;
 }
 /**
  * Defines the readiness check type.
  */
-export type ReadinessCheck = (ctx: import('@fluojs/http').RequestContext) => boolean | Promise<boolean>;
+export type ReadinessCheck = (ctx: import('@fluojs/http/portable').RequestContext) => boolean | Promise<boolean>;
 /** Runtime-owned health module class returned by `HealthModule.forRoot(...)`. */
 export interface RuntimeHealthModule extends ModuleType {
     readonly name: string;

package/dist/health/health.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../../src/health/health.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,IAAI,GAAG,aAAa,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,OAAO,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,OAAO,GAAG,UAAU,GAAG,aAAa,CAAC;CAC9C;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,cAAc,EAAE,cAAc,KACrD,YAAY,GACZ,mBAAmB,GACnB,OAAO,CAAC,YAAY,GAAG,mBAAmB,CAAC,CAAC;IAChD,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,GAAG,EAAE,OAAO,cAAc,EAAE,cAAc,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;AAExG,iFAAiF;AACjF,MAAM,WAAW,mBAAoB,SAAQ,UAAU;IACrD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,sFAAsF;IACtF,iBAAiB,CAAC,EAAE,EAAE,cAAc,GAAG,IAAI,CAAC;IAC5C,+EAA+E;IAC/E,SAAS,IAAI,IAAI,CAAC;IAClB,kFAAkF;IAClF,YAAY,IAAI,IAAI,CAAC;CACtB;AAkFD;;GAEG;AACH,qBAAa,YAAY;IACvB;;;;;OAKG;IACH,MAAM,CAAC,OAAO,CAAC,OAAO,GAAE,mBAAwB,GAAG,mBAAmB;CAGvE;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,GAAE,mBAAwB,GAAG,mBAAmB,CAEzF"}
+{"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../../src/health/health.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAA8B,KAAK,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAGpF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,IAAI,GAAG,aAAa,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,OAAO,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,OAAO,GAAG,UAAU,GAAG,aAAa,CAAC;CAC9C;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,6FAA6F;IAC7F,kBAAkB,CAAC,EAAE,SAAS,WAAW,CAAC,UAAU,CAAC,EAAE,CAAC;IACxD,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,uBAAuB,EAAE,cAAc,KAC9D,YAAY,GACZ,mBAAmB,GACnB,OAAO,CAAC,YAAY,GAAG,mBAAmB,CAAC,CAAC;IAChD,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,GAAG,EAAE,OAAO,uBAAuB,EAAE,cAAc,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;AAEjH,iFAAiF;AACjF,MAAM,WAAW,mBAAoB,SAAQ,UAAU;IACrD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,sFAAsF;IACtF,iBAAiB,CAAC,EAAE,EAAE,cAAc,GAAG,IAAI,CAAC;IAC5C,+EAA+E;IAC/E,SAAS,IAAI,IAAI,CAAC;IAClB,kFAAkF;IAClF,YAAY,IAAI,IAAI,CAAC;CACtB;AAqFD;;GAEG;AACH,qBAAa,YAAY;IACvB;;;;;OAKG;IACH,MAAM,CAAC,OAAO,CAAC,OAAO,GAAE,mBAAwB,GAAG,mBAAmB;CAGvE;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,GAAE,mBAAwB,GAAG,mBAAmB,CAEzF"}

package/dist/health/health.js

@@ -3,7 +3,7 @@ function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol"
 function _toPrimitive(t, r) { if ("object" != typeof t || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != typeof i) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
 function _setFunctionName(e, t, n) { "symbol" == typeof t && (t = (t = t.description) ? "[" + t + "]" : ""); try { Object.defineProperty(e, "name", { configurable: !0, value: n ? n + " " + t : t }); } catch (e) {} return e; }
 function _checkInRHS(e) { if (Object(e) !== e) throw TypeError("right-hand side of 'in' should be an object, got " + (null !== e ? typeof e : "null")); return e; }
-import { Controller, Get } from '@fluojs/http';
+import { Controller, forRoutes, Get } from '@fluojs/http/portable';
 import { defineModule } from '../bootstrap.js';
 
 /**
@@ -102,7 +102,8 @@ function createRuntimeHealthModule(options = {}) {
     value: 'HealthModule'
   });
   defineModule(RuntimeHealthModule, {
-    controllers: [_HealthController]
+    controllers: [_HealthController],
+    middleware: (options.endpointMiddleware ?? []).map(middlewareClass => forRoutes(middlewareClass, `${basePath}/health`, `${basePath}/ready`))
   });
   return RuntimeHealthModule;
 }

package/dist/http-adapter-shared.d.ts

@@ -1,4 +1,4 @@
-import { type CorsOptions, type HttpApplicationAdapter, type MiddlewareLike, type SecurityHeadersOptions } from '@fluojs/http';
+import { type CorsOptions, type HttpApplicationAdapter, type MiddlewareLike, type SecurityHeadersOptions } from '@fluojs/http/portable';
 import { createDefaultApplicationLogger } from './logging/default-logger.js';
 import type { Application, ApplicationLogger, CreateApplicationOptions, ModuleType } from './types.js';
 export { createDefaultApplicationLogger };

package/dist/http-adapter-shared.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"http-adapter-shared.d.ts","sourceRoot":"","sources":["../src/http-adapter-shared.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,WAAW,EAKhB,KAAK,sBAAsB,EAE3B,KAAK,cAAc,EAKnB,KAAK,sBAAsB,EAC5B,MAAM,cAAc,CAAC;AAGtB,OAAO,EAAE,8BAA8B,EAAE,MAAM,6BAA6B,CAAC;AAC7E,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAEvG,OAAO,EAAE,8BAA8B,EAAE,CAAC;AAE1C;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,EAAE,GAAG,WAAW,CAAC;AAE3E;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,wDAAwD;IACxD,UAAU,EAAE,MAAM,CAAC;IACnB,4CAA4C;IAC5C,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C,0CAA0C;IAC1C,IAAI,CAAC,EAAE,oBAAoB,CAAC;IAC5B,2CAA2C;IAC3C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gEAAgE;IAChE,mBAAmB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,6DAA6D;IAC7D,UAAU,CAAC,EAAE,cAAc,EAAE,CAAC;IAC9B,qCAAqC;IACrC,eAAe,CAAC,EAAE,KAAK,GAAG,sBAAsB,CAAC;CAClD;AAED;;GAEG;AACH,MAAM,WAAW,sCACf,SAAQ,IAAI,CAAC,wBAAwB,EAAE,SAAS,GAAG,YAAY,CAAC,EAC9D,4BAA4B;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,gCAAiC,SAAQ,sCAAsC;IAC9F,4FAA4F;IAC5F,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,0CAA0C;IAC1C,oBAAoB,CAAC,EAAE,+BAA+B,CAAC;CACxD;AAED;;GAEG;AACH,MAAM,MAAM,+BAA+B,GAAG,CAC5C,GAAG,EAAE,WAAW,EAChB,MAAM,EAAE,iBAAiB,EACzB,kBAAkB,CAAC,EAAE,MAAM,KACxB,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,CAAC;AAEzB,KAAK,6BAA6B,GAAG,sBAAsB,GAAG;IAC5D,eAAe,IAAI,uBAAuB,CAAC;CAC5C,CAAC;AAEF;;;;;;;;GAQG;AACH,wBAAsB,+BAA+B,CACnD,UAAU,EAAE,UAAU,EACtB,OAAO,EAAE,sCAAsC,EAC/C,OAAO,EAAE,sBAAsB,EAC/B,MAAM,GAAE,iBAAoD,GAC3D,OAAO,CAAC,WAAW,CAAC,CAQtB;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,4BAA4B,GAAG,cAAc,EAAE,CAkBnG;AAED;;;;;GAKG;AACH,wBAAgB,8BAA8B,CAAC,MAAM,EAAE,uBAAuB,GAAG,MAAM,CAItF;AAED;;;;;;;;;GASG;AACH,wBAAsB,yBAAyB,CAC7C,UAAU,EAAE,UAAU,EACtB,OAAO,EAAE,gCAAgC,EACzC,OAAO,EAAE,6BAA6B,EACtC,MAAM,GAAE,iBAAoD,GAC3D,OAAO,CAAC,WAAW,CAAC,CA8EtB"}
+{"version":3,"file":"http-adapter-shared.d.ts","sourceRoot":"","sources":["../src/http-adapter-shared.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,WAAW,EAKhB,KAAK,sBAAsB,EAE3B,KAAK,cAAc,EAKnB,KAAK,sBAAsB,EAC5B,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EAAE,8BAA8B,EAAE,MAAM,6BAA6B,CAAC;AAC7E,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAEvG,OAAO,EAAE,8BAA8B,EAAE,CAAC;AAE1C;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,EAAE,GAAG,WAAW,CAAC;AAE3E;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,wDAAwD;IACxD,UAAU,EAAE,MAAM,CAAC;IACnB,4CAA4C;IAC5C,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C,0CAA0C;IAC1C,IAAI,CAAC,EAAE,oBAAoB,CAAC;IAC5B,2CAA2C;IAC3C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gEAAgE;IAChE,mBAAmB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,6DAA6D;IAC7D,UAAU,CAAC,EAAE,cAAc,EAAE,CAAC;IAC9B,qCAAqC;IACrC,eAAe,CAAC,EAAE,KAAK,GAAG,sBAAsB,CAAC;CAClD;AAED;;GAEG;AACH,MAAM,WAAW,sCACf,SAAQ,IAAI,CAAC,wBAAwB,EAAE,SAAS,GAAG,YAAY,CAAC,EAC9D,4BAA4B;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,gCAAiC,SAAQ,sCAAsC;IAC9F,4FAA4F;IAC5F,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,0CAA0C;IAC1C,oBAAoB,CAAC,EAAE,+BAA+B,CAAC;CACxD;AAED;;GAEG;AACH,MAAM,MAAM,+BAA+B,GAAG,CAC5C,GAAG,EAAE,WAAW,EAChB,MAAM,EAAE,iBAAiB,EACzB,kBAAkB,CAAC,EAAE,MAAM,KACxB,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,CAAC;AAEzB,KAAK,6BAA6B,GAAG,sBAAsB,GAAG;IAC5D,eAAe,IAAI,uBAAuB,CAAC;CAC5C,CAAC;AAEF;;;;;;;;GAQG;AACH,wBAAsB,+BAA+B,CACnD,UAAU,EAAE,UAAU,EACtB,OAAO,EAAE,sCAAsC,EAC/C,OAAO,EAAE,sBAAsB,EAC/B,MAAM,GAAE,iBAAoD,GAC3D,OAAO,CAAC,WAAW,CAAC,CAQtB;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,4BAA4B,GAAG,cAAc,EAAE,CAkBnG;AAED;;;;;GAKG;AACH,wBAAgB,8BAA8B,CAAC,MAAM,EAAE,uBAAuB,GAAG,MAAM,CAItF;AAED;;;;;;;;;GASG;AACH,wBAAsB,yBAAyB,CAC7C,UAAU,EAAE,UAAU,EACtB,OAAO,EAAE,gCAAgC,EACzC,OAAO,EAAE,6BAA6B,EACtC,MAAM,GAAE,iBAAoD,GAC3D,OAAO,CAAC,WAAW,CAAC,CA8EtB"}

package/dist/http-adapter-shared.js

@@ -1,4 +1,4 @@
-import { createCorsMiddleware, createErrorResponse, createSecurityHeadersMiddleware, matchRoutePattern, NotFoundException, normalizeRoutePattern } from '@fluojs/http';
+import { createCorsMiddleware, createErrorResponse, createSecurityHeadersMiddleware, matchRoutePattern, NotFoundException, normalizeRoutePattern } from '@fluojs/http/portable';
 import { bootstrapApplication } from './bootstrap.js';
 import { createDefaultApplicationLogger } from './logging/default-logger.js';
 export { createDefaultApplicationLogger };

package/dist/index.d.ts

@@ -1,12 +1,15 @@
 export * from './abort.js';
 export * from './bootstrap.js';
-export { createBootstrapTimingDiagnostics, createRuntimeDiagnosticsGraph, } from './health/diagnostics.js';
-export type { BootstrapTimingDiagnostics, BootstrapTimingPhase, RuntimeDiagnosticsGraph, RuntimeDiagnosticsModule, RuntimeDiagnosticsProvider, RuntimeDiagnosticsRelationships, } from './health/diagnostics.js';
 export * from './errors.js';
+export type { BootstrapTimingDiagnostics, BootstrapTimingPhase, RuntimeDiagnosticsGraph, RuntimeDiagnosticsModule, RuntimeDiagnosticsProvider, RuntimeDiagnosticsRelationships, } from './health/diagnostics.js';
+export { createBootstrapTimingDiagnostics, createRuntimeDiagnosticsGraph, } from './health/diagnostics.js';
 export * from './health/health.js';
-export type { MultipartOptions, MultipartRequestLike, MultipartResult, UploadedFile, } from './multipart.js';
+export { ModuleGraphCompileCache } from './module-graph.js';
+export type { MultipartFieldPart, MultipartFilePart, MultipartOptions, MultipartPart, MultipartRequestLike, MultipartResult, UploadedFile, } from './multipart.js';
+export { MultipartBodyConsumedError } from './multipart.js';
 export type { PersistencePlatformStatusSnapshot, PlatformCheckResult, PlatformComponent, PlatformComponentInput, PlatformComponentRegistration, PlatformDiagnosticIssue, PlatformHealthReport, PlatformOptionsBase, PlatformReadinessReport, PlatformShell, PlatformShellSnapshot, PlatformSnapshot, PlatformState, PlatformValidationResult, } from './platform-contract.js';
 export * from './request-transaction.js';
+export * from './route-inspection.js';
 export { APPLICATION_LOGGER, PLATFORM_SHELL } from './tokens.js';
 export * from './types.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EACL,gCAAgC,EAChC,6BAA6B,GAC9B,MAAM,yBAAyB,CAAC;AACjC,YAAY,EACV,0BAA0B,EAC1B,oBAAoB,EACpB,uBAAuB,EACvB,wBAAwB,EACxB,0BAA0B,EAC1B,+BAA+B,GAChC,MAAM,yBAAyB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,YAAY,EACV,gBAAgB,EAChB,oBAAoB,EACpB,eAAe,EACf,YAAY,GACb,MAAM,gBAAgB,CAAC;AACxB,YAAY,EACV,iCAAiC,EACjC,mBAAmB,EACnB,iBAAiB,EACjB,sBAAsB,EACtB,6BAA6B,EAC7B,uBAAuB,EACvB,oBAAoB,EACpB,mBAAmB,EACnB,uBAAuB,EACvB,aAAa,EACb,qBAAqB,EACrB,gBAAgB,EAChB,aAAa,EACb,wBAAwB,GACzB,MAAM,wBAAwB,CAAC;AAChC,cAAc,0BAA0B,CAAC;AACzC,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACjE,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,YAAY,EACV,0BAA0B,EAC1B,oBAAoB,EACpB,uBAAuB,EACvB,wBAAwB,EACxB,0BAA0B,EAC1B,+BAA+B,GAChC,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,gCAAgC,EAChC,6BAA6B,GAC9B,MAAM,yBAAyB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,OAAO,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,YAAY,EACV,kBAAkB,EAClB,iBAAiB,EACjB,gBAAgB,EAChB,aAAa,EACb,oBAAoB,EACpB,eAAe,EACf,YAAY,GACb,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,0BAA0B,EAAE,MAAM,gBAAgB,CAAC;AAC5D,YAAY,EACV,iCAAiC,EACjC,mBAAmB,EACnB,iBAAiB,EACjB,sBAAsB,EACtB,6BAA6B,EAC7B,uBAAuB,EACvB,oBAAoB,EACpB,mBAAmB,EACnB,uBAAuB,EACvB,aAAa,EACb,qBAAqB,EACrB,gBAAgB,EAChB,aAAa,EACb,wBAAwB,GACzB,MAAM,wBAAwB,CAAC;AAChC,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC;AACtC,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACjE,cAAc,YAAY,CAAC"}

package/dist/index.js

@@ -1,8 +1,11 @@
 export * from './abort.js';
 export * from './bootstrap.js';
-export { createBootstrapTimingDiagnostics, createRuntimeDiagnosticsGraph } from './health/diagnostics.js';
 export * from './errors.js';
+export { createBootstrapTimingDiagnostics, createRuntimeDiagnosticsGraph } from './health/diagnostics.js';
 export * from './health/health.js';
+export { ModuleGraphCompileCache } from './module-graph.js';
+export { MultipartBodyConsumedError } from './multipart.js';
 export * from './request-transaction.js';
+export * from './route-inspection.js';
 export { APPLICATION_LOGGER, PLATFORM_SHELL } from './tokens.js';
 export * from './types.js';

package/dist/internal/route-inspection-metadata.d.ts

@@ -0,0 +1,30 @@
+import type { MetadataPropertyKey } from '@fluojs/core';
+/** Describes package-integration metadata that classifies a compiled runtime route. */
+export interface RuntimeRouteInspectionMetadata {
+    readonly kind: string;
+}
+/**
+ * Records route inspection metadata in a TC39 standard decorator metadata bag.
+ *
+ * @param metadata Standard decorator metadata bag that owns the route marker.
+ * @param propertyKey Controller method key associated with the route.
+ * @param value Route inspection metadata to store as an immutable snapshot.
+ */
+export declare function defineStandardRuntimeRouteInspectionMetadata(metadata: unknown, propertyKey: MetadataPropertyKey, value: RuntimeRouteInspectionMetadata): void;
+/**
+ * Records route inspection metadata for legacy decorator-call compatibility.
+ *
+ * @param target Controller prototype that owns the decorated route.
+ * @param propertyKey Controller method key associated with the route.
+ * @param value Route inspection metadata to store as an immutable snapshot.
+ */
+export declare function defineLegacyRuntimeRouteInspectionMetadata(target: object, propertyKey: MetadataPropertyKey, value: RuntimeRouteInspectionMetadata): void;
+/**
+ * Reads the immutable route inspection marker for a compiled controller method.
+ *
+ * @param controllerToken Controller class that owns the route handler.
+ * @param propertyKey Controller method key associated with the route.
+ * @returns The normalized route metadata when a package integration recorded one.
+ */
+export declare function getRuntimeRouteInspectionMetadata(controllerToken: Function, propertyKey: MetadataPropertyKey): RuntimeRouteInspectionMetadata | undefined;
+//# sourceMappingURL=route-inspection-metadata.d.ts.map

package/dist/internal/route-inspection-metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-inspection-metadata.d.ts","sourceRoot":"","sources":["../../src/internal/route-inspection-metadata.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAUxD,uFAAuF;AACvF,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAwBD;;;;;;GAMG;AACH,wBAAgB,4CAA4C,CAC1D,QAAQ,EAAE,OAAO,EACjB,WAAW,EAAE,mBAAmB,EAChC,KAAK,EAAE,8BAA8B,GACpC,IAAI,CAEN;AAED;;;;;;GAMG;AACH,wBAAgB,0CAA0C,CACxD,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,mBAAmB,EAChC,KAAK,EAAE,8BAA8B,GACpC,IAAI,CASN;AAWD;;;;;;GAMG;AACH,wBAAgB,iCAAiC,CAC/C,eAAe,EAAE,QAAQ,EACzB,WAAW,EAAE,mBAAmB,GAC/B,8BAA8B,GAAG,SAAS,CAO5C"}

package/dist/internal/route-inspection-metadata.js

@@ -0,0 +1,68 @@
+import { getStandardMetadataBag } from '@fluojs/core/internal';
+const runtimeRouteInspectionMetadataKey = Symbol.for('fluo.runtime.route-inspection');
+const legacyRouteInspectionMetadataStore = new WeakMap();
+
+/** Describes package-integration metadata that classifies a compiled runtime route. */
+
+function cloneMetadata(metadata) {
+  return Object.freeze({
+    kind: metadata.kind
+  });
+}
+function getMetadataMap(metadata) {
+  const metadataBag = typeof metadata === 'object' && metadata !== null ? metadata : {};
+  const current = Object.hasOwn(metadataBag, runtimeRouteInspectionMetadataKey) ? Reflect.get(metadataBag, runtimeRouteInspectionMetadataKey) : undefined;
+  if (current instanceof Map) {
+    return current;
+  }
+  const inherited = Reflect.get(metadataBag, runtimeRouteInspectionMetadataKey);
+  const created = inherited instanceof Map ? new Map(inherited) : new Map();
+  Reflect.set(metadataBag, runtimeRouteInspectionMetadataKey, created);
+  return created;
+}
+
+/**
+ * Records route inspection metadata in a TC39 standard decorator metadata bag.
+ *
+ * @param metadata Standard decorator metadata bag that owns the route marker.
+ * @param propertyKey Controller method key associated with the route.
+ * @param value Route inspection metadata to store as an immutable snapshot.
+ */
+export function defineStandardRuntimeRouteInspectionMetadata(metadata, propertyKey, value) {
+  getMetadataMap(metadata).set(propertyKey, cloneMetadata(value));
+}
+
+/**
+ * Records route inspection metadata for legacy decorator-call compatibility.
+ *
+ * @param target Controller prototype that owns the decorated route.
+ * @param propertyKey Controller method key associated with the route.
+ * @param value Route inspection metadata to store as an immutable snapshot.
+ */
+export function defineLegacyRuntimeRouteInspectionMetadata(target, propertyKey, value) {
+  let routeMap = legacyRouteInspectionMetadataStore.get(target);
+  if (!routeMap) {
+    routeMap = new Map();
+    legacyRouteInspectionMetadataStore.set(target, routeMap);
+  }
+  routeMap.set(propertyKey, cloneMetadata(value));
+}
+function isRuntimeRouteInspectionMetadata(value) {
+  const kind = typeof value === 'object' && value !== null ? Reflect.get(value, 'kind') : undefined;
+  return typeof value === 'object' && value !== null && typeof kind === 'string' && kind.length > 0;
+}
+
+/**
+ * Reads the immutable route inspection marker for a compiled controller method.
+ *
+ * @param controllerToken Controller class that owns the route handler.
+ * @param propertyKey Controller method key associated with the route.
+ * @returns The normalized route metadata when a package integration recorded one.
+ */
+export function getRuntimeRouteInspectionMetadata(controllerToken, propertyKey) {
+  const legacyMetadata = legacyRouteInspectionMetadataStore.get(controllerToken.prototype)?.get(propertyKey);
+  const standardRouteMap = getStandardMetadataBag(controllerToken)?.[runtimeRouteInspectionMetadataKey];
+  const standardMetadata = standardRouteMap instanceof Map ? standardRouteMap.get(propertyKey) : undefined;
+  const metadata = legacyMetadata ?? standardMetadata;
+  return isRuntimeRouteInspectionMetadata(metadata) ? cloneMetadata(metadata) : undefined;
+}

package/dist/internal.d.ts

@@ -1,4 +1,9 @@
 export { getRuntimeClassDiMetadata } from './internal/core-metadata.js';
+export type { RuntimeRouteInspectionMetadata } from './internal/route-inspection-metadata.js';
+export { defineLegacyRuntimeRouteInspectionMetadata, defineStandardRuntimeRouteInspectionMetadata, getRuntimeRouteInspectionMetadata, } from './internal/route-inspection-metadata.js';
+export { defineModule } from './module-definition.js';
+export { createRuntimeRouteInspection } from './route-inspection.js';
 export type { BootstrapReadySignal } from './tokens.js';
-export { APPLICATION_LOGGER, BOOTSTRAP_READY_SIGNAL, COMPILED_MODULES, HTTP_APPLICATION_ADAPTER, PLATFORM_SHELL, RUNTIME_CLEANUP_REGISTRATION, RUNTIME_CONTAINER, } from './tokens.js';
+export { APPLICATION_LOGGER, BOOTSTRAP_PROVIDER_TOKENS, BOOTSTRAP_READY_SIGNAL, COMPILED_MODULES, HTTP_APPLICATION_ADAPTER, PLATFORM_SHELL, RUNTIME_CLEANUP_REGISTRATION, RUNTIME_CONTAINER, } from './tokens.js';
+export type { ModuleDefinition, ModuleType } from './types.js';
 //# sourceMappingURL=internal.d.ts.map

package/dist/internal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"internal.d.ts","sourceRoot":"","sources":["../src/internal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AACxE,YAAY,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,EACL,kBAAkB,EAClB,sBAAsB,EACtB,gBAAgB,EAChB,wBAAwB,EACxB,cAAc,EACd,4BAA4B,EAC5B,iBAAiB,GAClB,MAAM,aAAa,CAAC"}
+{"version":3,"file":"internal.d.ts","sourceRoot":"","sources":["../src/internal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AACxE,YAAY,EAAE,8BAA8B,EAAE,MAAM,yCAAyC,CAAC;AAC9F,OAAO,EACL,0CAA0C,EAC1C,4CAA4C,EAC5C,iCAAiC,GAClC,MAAM,yCAAyC,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,4BAA4B,EAAE,MAAM,uBAAuB,CAAC;AACrE,YAAY,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,EACL,kBAAkB,EAClB,yBAAyB,EACzB,sBAAsB,EACtB,gBAAgB,EAChB,wBAAwB,EACxB,cAAc,EACd,4BAA4B,EAC5B,iBAAiB,GAClB,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC"}

package/dist/internal.js

@@ -1,2 +1,5 @@
 export { getRuntimeClassDiMetadata } from './internal/core-metadata.js';
-export { APPLICATION_LOGGER, BOOTSTRAP_READY_SIGNAL, COMPILED_MODULES, HTTP_APPLICATION_ADAPTER, PLATFORM_SHELL, RUNTIME_CLEANUP_REGISTRATION, RUNTIME_CONTAINER } from './tokens.js';
+export { defineLegacyRuntimeRouteInspectionMetadata, defineStandardRuntimeRouteInspectionMetadata, getRuntimeRouteInspectionMetadata } from './internal/route-inspection-metadata.js';
+export { defineModule } from './module-definition.js';
+export { createRuntimeRouteInspection } from './route-inspection.js';
+export { APPLICATION_LOGGER, BOOTSTRAP_PROVIDER_TOKENS, BOOTSTRAP_READY_SIGNAL, COMPILED_MODULES, HTTP_APPLICATION_ADAPTER, PLATFORM_SHELL, RUNTIME_CLEANUP_REGISTRATION, RUNTIME_CONTAINER } from './tokens.js';

package/dist/module-definition.d.ts

@@ -0,0 +1,10 @@
+import type { ModuleDefinition, ModuleType } from './types.js';
+/**
+ * Associates a portable module definition with a module type.
+ *
+ * @param moduleType Module class that should receive runtime module metadata.
+ * @param definition Module definition contract (`imports`, `providers`, `controllers`, `exports`, etc.).
+ * @returns The same `moduleType` reference for fluent helper composition.
+ */
+export declare function defineModule<T extends ModuleType>(moduleType: T, definition: ModuleDefinition): T;
+//# sourceMappingURL=module-definition.d.ts.map

package/dist/module-definition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module-definition.d.ts","sourceRoot":"","sources":["../src/module-definition.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE/D;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,UAAU,EAAE,UAAU,EAAE,CAAC,EAAE,UAAU,EAAE,gBAAgB,GAAG,CAAC,CAIjG"}

package/dist/module-definition.js

@@ -0,0 +1,12 @@
+import { defineRuntimeModuleMetadata } from './internal/core-metadata.js';
+/**
+ * Associates a portable module definition with a module type.
+ *
+ * @param moduleType Module class that should receive runtime module metadata.
+ * @param definition Module definition contract (`imports`, `providers`, `controllers`, `exports`, etc.).
+ * @returns The same `moduleType` reference for fluent helper composition.
+ */
+export function defineModule(moduleType, definition) {
+  defineRuntimeModuleMetadata(moduleType, definition);
+  return moduleType;
+}