@fluojs/runtime 1.0.0-beta.9 → 1.0.0

package/dist/health/health.d.ts

@@ -28,12 +28,25 @@ export interface HealthModuleOptions {
 /**
  * Defines the readiness check type.
  */
-export type ReadinessCheck = () => boolean | Promise<boolean>;
+export type ReadinessCheck = (ctx: import('@fluojs/http').RequestContext) => boolean | Promise<boolean>;
 /**
- * Create health module.
+ * Runtime health module facade for application module imports.
+ */
+export declare class HealthModule {
+    /**
+     * Creates a runtime-owned `/health` and `/ready` module.
+     *
+     * @param options Runtime health endpoint options.
+     * @returns A module class that can be imported into an application module.
+     */
+    static forRoot(options?: HealthModuleOptions): ModuleType;
+}
+/**
+ * Creates a runtime-owned `/health` and `/ready` module.
  *
- * @param options The options.
- * @returns The create health module result.
+ * @deprecated Prefer `HealthModule.forRoot(...)` for application-facing module registration.
+ * @param options Runtime health endpoint options.
+ * @returns A module class that can be imported into an application module.
  */
 export declare function createHealthModule(options?: HealthModuleOptions): ModuleType;
 //# sourceMappingURL=health.d.ts.map

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,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;AAE9D;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,GAAE,mBAAwB,GAAG,UAAU,CA0EhF"}
+{"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;AAkFxG;;GAEG;AACH,qBAAa,YAAY;IACvB;;;;;OAKG;IACH,MAAM,CAAC,OAAO,CAAC,OAAO,GAAE,mBAAwB,GAAG,UAAU;CAG9D;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,GAAE,mBAAwB,GAAG,UAAU,CAEhF"}

package/dist/health/health.js

@@ -26,13 +26,7 @@ import { defineModule } from '../bootstrap.js';
  * Defines the readiness check type.
  */
 
-/**
- * Create health module.
- *
- * @param options The options.
- * @returns The create health module result.
- */
-export function createHealthModule(options = {}) {
+function createRuntimeHealthModule(options = {}) {
   let _initProto, _initClass;
   const basePath = options.path ?? '';
   const readinessChecks = [];
@@ -75,7 +69,7 @@ export function createHealthModule(options = {}) {
         };
       }
       for (const check of readinessChecks) {
-        const result = await check();
+        const result = await check(ctx);
         if (!result) {
           ctx.response.setStatus(503);
           return {
@@ -91,7 +85,7 @@ export function createHealthModule(options = {}) {
       _initClass();
     }
   }
-  class HealthModule {
+  class RuntimeHealthModule {
     static addReadinessCheck(fn) {
       readinessChecks.push(fn);
     }
@@ -102,8 +96,37 @@ export function createHealthModule(options = {}) {
       ready = false;
     }
   }
-  defineModule(HealthModule, {
+  Object.defineProperty(RuntimeHealthModule, 'name', {
+    value: 'HealthModule'
+  });
+  defineModule(RuntimeHealthModule, {
     controllers: [_HealthController]
   });
-  return HealthModule;
+  return RuntimeHealthModule;
+}
+
+/**
+ * Runtime health module facade for application module imports.
+ */
+export class HealthModule {
+  /**
+   * Creates a runtime-owned `/health` and `/ready` module.
+   *
+   * @param options Runtime health endpoint options.
+   * @returns A module class that can be imported into an application module.
+   */
+  static forRoot(options = {}) {
+    return createRuntimeHealthModule(options);
+  }
+}
+
+/**
+ * Creates a runtime-owned `/health` and `/ready` module.
+ *
+ * @deprecated Prefer `HealthModule.forRoot(...)` for application-facing module registration.
+ * @param options Runtime health endpoint options.
+ * @returns A module class that can be imported into an application module.
+ */
+export function createHealthModule(options = {}) {
+  return HealthModule.forRoot(options);
 }

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,EAOL,KAAK,WAAW,EAEhB,KAAK,sBAAsB,EAE3B,KAAK,cAAc,EAEnB,KAAK,sBAAsB,EAC5B,MAAM,cAAc,CAAC;AAItB,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAEvG;;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,QAAQ,GAAG,YAAY,CAAC,EACzE,4BAA4B;IAC9B,0CAA0C;IAC1C,MAAM,CAAC,EAAE,iBAAiB,CAAC;CAC5B;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;;;;;;;GAOG;AACH,wBAAsB,+BAA+B,CACnD,UAAU,EAAE,UAAU,EACtB,OAAO,EAAE,sCAAsC,EAC/C,OAAO,EAAE,sBAAsB,GAC9B,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;;;;;;;;GAQG;AACH,wBAAsB,yBAAyB,CAC7C,UAAU,EAAE,UAAU,EACtB,OAAO,EAAE,gCAAgC,EACzC,OAAO,EAAE,6BAA6B,GACrC,OAAO,CAAC,WAAW,CAAC,CA6CtB"}
+{"version":3,"file":"http-adapter-shared.d.ts","sourceRoot":"","sources":["../src/http-adapter-shared.ts"],"names":[],"mappings":"AAAA,OAAO,EAOL,KAAK,WAAW,EAEhB,KAAK,sBAAsB,EAE3B,KAAK,cAAc,EAEnB,KAAK,sBAAsB,EAC5B,MAAM,cAAc,CAAC;AAItB,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAEvG;;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,QAAQ,GAAG,YAAY,CAAC,EACzE,4BAA4B;IAC9B,0CAA0C;IAC1C,MAAM,CAAC,EAAE,iBAAiB,CAAC;CAC5B;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;;;;;;;GAOG;AACH,wBAAsB,+BAA+B,CACnD,UAAU,EAAE,UAAU,EACtB,OAAO,EAAE,sCAAsC,EAC/C,OAAO,EAAE,sBAAsB,GAC9B,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;;;;;;;;GAQG;AACH,wBAAsB,yBAAyB,CAC7C,UAAU,EAAE,UAAU,EACtB,OAAO,EAAE,gCAAgC,EACzC,OAAO,EAAE,6BAA6B,GACrC,OAAO,CAAC,WAAW,CAAC,CA+EtB"}

package/dist/http-adapter-shared.js

@@ -106,15 +106,42 @@ export async function runHttpAdapterApplication(rootModule, options, adapter) {
     }
     throw error;
   }
-  const unregisterShutdownSignals = options.shutdownRegistration?.(app, logger, options.forceExitTimeoutMs) ?? (() => {});
+  let unregisterShutdownSignals;
+  try {
+    unregisterShutdownSignals = options.shutdownRegistration?.(app, logger, options.forceExitTimeoutMs) ?? (() => {});
+  } catch (error) {
+    logger.error('Failed to register shutdown signals.', error, 'FluoFactory');
+    try {
+      await app.close('bootstrap-failed');
+    } catch (closeError) {
+      logger.error('Failed to close application after shutdown registration failure.', closeError, 'FluoFactory');
+    }
+    throw error;
+  }
   const close = app.close.bind(app);
   let shutdownSignalsUnregistered = false;
   app.close = async signal => {
+    let unregisterError;
     if (!shutdownSignalsUnregistered) {
-      unregisterShutdownSignals();
-      shutdownSignalsUnregistered = true;
+      try {
+        unregisterShutdownSignals();
+      } catch (error) {
+        unregisterError = error;
+      } finally {
+        shutdownSignalsUnregistered = true;
+      }
+    }
+    try {
+      await close(signal);
+    } catch (closeError) {
+      if (unregisterError) {
+        throw new AggregateError([unregisterError, closeError], 'Application close failed during shutdown signal cleanup.');
+      }
+      throw closeError;
+    }
+    if (unregisterError) {
+      throw unregisterError;
     }
-    await close(signal);
   };
   return app;
 }

package/dist/internal/core-metadata.d.ts

@@ -0,0 +1,84 @@
+import type { InjectionToken, Token } from '@fluojs/core';
+import type { Scope } from '@fluojs/di';
+import type { ModuleDefinition } from '../types.js';
+/** Runtime-local view of DI forward references consumed by module graph compilation. */
+export type RuntimeForwardRef = {
+    __forwardRef__: true;
+    forwardRef: () => Token;
+};
+/** Runtime-local view of optional DI tokens consumed by module graph compilation. */
+export type RuntimeOptionalToken = {
+    __optional__: true;
+    token: Token;
+};
+/** Runtime-local union for DI dependency metadata consumed by module graph compilation. */
+export type RuntimeInjectionToken = Token | RuntimeForwardRef | RuntimeOptionalToken;
+/** Runtime-local class DI metadata view used for provider scope and dependency validation. */
+export interface RuntimeClassDiMetadata {
+    inject?: readonly RuntimeInjectionToken[];
+    scope?: Scope;
+}
+/** Runtime-local writable class DI metadata shape used by explicit metadata-version tests. */
+export interface RuntimeWritableClassDiMetadata {
+    inject?: InjectionToken[];
+    scope?: Scope;
+}
+/** Runtime-local module metadata view used while compiling application module graphs. */
+export type RuntimeModuleMetadata = Pick<ModuleDefinition, 'controllers' | 'exports' | 'global' | 'imports' | 'middleware' | 'providers'>;
+/** Runtime-local writable module metadata shape used by decorators, tests, and dynamic module normalization. */
+export interface RuntimeWritableModuleMetadata {
+    controllers?: unknown[];
+    exports?: unknown[];
+    global?: boolean;
+    imports?: unknown[];
+    middleware?: unknown[];
+    providers?: unknown[];
+}
+/**
+ * Writes runtime-visible module metadata through the runtime-owned core metadata seam.
+ *
+ * @param target Module constructor that should receive the metadata snapshot.
+ * @param metadata Module metadata used by decorators, tests, or dynamic module normalization.
+ */
+export declare function defineRuntimeModuleMetadata(target: Function, metadata: RuntimeWritableModuleMetadata): void;
+/**
+ * Writes runtime-visible class DI metadata through the runtime-owned core metadata seam.
+ *
+ * @param target Class constructor that should receive DI metadata.
+ * @param metadata DI metadata used by explicit runtime metadata-version tests.
+ */
+export declare function defineRuntimeClassDiMetadata(target: Function, metadata: RuntimeWritableClassDiMetadata): void;
+/**
+ * Reads runtime-visible class DI metadata without spreading peer internal imports.
+ *
+ * @param target Class constructor whose effective DI metadata should be read.
+ * @returns The effective class DI metadata when present.
+ */
+export declare function getRuntimeClassDiMetadata(target: Function): RuntimeClassDiMetadata | undefined;
+/**
+ * Reads own runtime-visible class DI metadata without inherited metadata fallback.
+ *
+ * @param target Class constructor whose own DI metadata should be read.
+ * @returns The own class DI metadata when present.
+ */
+export declare function getOwnRuntimeClassDiMetadata(target: Function): RuntimeClassDiMetadata | undefined;
+/**
+ * Reads the current module metadata version for runtime compile-cache keys.
+ *
+ * @returns Monotonic module metadata version maintained by the core metadata store.
+ */
+export declare function getRuntimeModuleMetadataVersion(): number;
+/**
+ * Reads the current class DI metadata version for runtime compile-cache keys.
+ *
+ * @returns Monotonic class DI metadata version maintained by the core metadata store.
+ */
+export declare function getRuntimeClassDiMetadataVersion(): number;
+/**
+ * Reads runtime-visible module metadata during graph compilation.
+ *
+ * @param target Module constructor whose metadata should be read.
+ * @returns Module metadata normalized by the core metadata store.
+ */
+export declare function getRuntimeModuleMetadata(target: Function): RuntimeModuleMetadata;
+//# sourceMappingURL=core-metadata.d.ts.map

package/dist/internal/core-metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core-metadata.d.ts","sourceRoot":"","sources":["../../src/internal/core-metadata.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAU1D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAExC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEpD,wFAAwF;AACxF,MAAM,MAAM,iBAAiB,GAAG;IAAE,cAAc,EAAE,IAAI,CAAC;IAAC,UAAU,EAAE,MAAM,KAAK,CAAA;CAAE,CAAC;AAClF,qFAAqF;AACrF,MAAM,MAAM,oBAAoB,GAAG;IAAE,YAAY,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,KAAK,CAAA;CAAE,CAAC;AACxE,2FAA2F;AAC3F,MAAM,MAAM,qBAAqB,GAAG,KAAK,GAAG,iBAAiB,GAAG,oBAAoB,CAAC;AAErF,8FAA8F;AAC9F,MAAM,WAAW,sBAAsB;IACrC,MAAM,CAAC,EAAE,SAAS,qBAAqB,EAAE,CAAC;IAC1C,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAED,8FAA8F;AAC9F,MAAM,WAAW,8BAA8B;IAC7C,MAAM,CAAC,EAAE,cAAc,EAAE,CAAC;IAC1B,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAED,yFAAyF;AACzF,MAAM,MAAM,qBAAqB,GAAG,IAAI,CACtC,gBAAgB,EAChB,aAAa,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,GAAG,YAAY,GAAG,WAAW,CAC9E,CAAC;AAEF,gHAAgH;AAChH,MAAM,WAAW,6BAA6B;IAC5C,WAAW,CAAC,EAAE,OAAO,EAAE,CAAC;IACxB,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC;IACpB,UAAU,CAAC,EAAE,OAAO,EAAE,CAAC;IACvB,SAAS,CAAC,EAAE,OAAO,EAAE,CAAC;CACvB;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,6BAA6B,GAAG,IAAI,CAE3G;AAED;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,8BAA8B,GAAG,IAAI,CAE7G;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,QAAQ,GAAG,sBAAsB,GAAG,SAAS,CAE9F;AAED;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,QAAQ,GAAG,sBAAsB,GAAG,SAAS,CAEjG;AAED;;;;GAIG;AACH,wBAAgB,+BAA+B,IAAI,MAAM,CAExD;AAED;;;;GAIG;AACH,wBAAgB,gCAAgC,IAAI,MAAM,CAEzD;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,QAAQ,GAAG,qBAAqB,CAEhF"}

package/dist/internal/core-metadata.js

@@ -0,0 +1,83 @@
+import { defineClassDiMetadata as definePeerClassDiMetadata, defineModuleMetadata as definePeerModuleMetadata, getClassDiMetadata as getPeerClassDiMetadata, getClassDiMetadataVersion as getPeerClassDiMetadataVersion, getModuleMetadata as getPeerModuleMetadata, getModuleMetadataVersion as getPeerModuleMetadataVersion, getOwnClassDiMetadata as getPeerOwnClassDiMetadata } from '@fluojs/core/internal';
+
+/** Runtime-local view of DI forward references consumed by module graph compilation. */
+
+/** Runtime-local view of optional DI tokens consumed by module graph compilation. */
+
+/** Runtime-local union for DI dependency metadata consumed by module graph compilation. */
+
+/** Runtime-local class DI metadata view used for provider scope and dependency validation. */
+
+/** Runtime-local writable class DI metadata shape used by explicit metadata-version tests. */
+
+/** Runtime-local module metadata view used while compiling application module graphs. */
+
+/** Runtime-local writable module metadata shape used by decorators, tests, and dynamic module normalization. */
+
+/**
+ * Writes runtime-visible module metadata through the runtime-owned core metadata seam.
+ *
+ * @param target Module constructor that should receive the metadata snapshot.
+ * @param metadata Module metadata used by decorators, tests, or dynamic module normalization.
+ */
+export function defineRuntimeModuleMetadata(target, metadata) {
+  definePeerModuleMetadata(target, metadata);
+}
+
+/**
+ * Writes runtime-visible class DI metadata through the runtime-owned core metadata seam.
+ *
+ * @param target Class constructor that should receive DI metadata.
+ * @param metadata DI metadata used by explicit runtime metadata-version tests.
+ */
+export function defineRuntimeClassDiMetadata(target, metadata) {
+  definePeerClassDiMetadata(target, metadata);
+}
+
+/**
+ * Reads runtime-visible class DI metadata without spreading peer internal imports.
+ *
+ * @param target Class constructor whose effective DI metadata should be read.
+ * @returns The effective class DI metadata when present.
+ */
+export function getRuntimeClassDiMetadata(target) {
+  return getPeerClassDiMetadata(target);
+}
+
+/**
+ * Reads own runtime-visible class DI metadata without inherited metadata fallback.
+ *
+ * @param target Class constructor whose own DI metadata should be read.
+ * @returns The own class DI metadata when present.
+ */
+export function getOwnRuntimeClassDiMetadata(target) {
+  return getPeerOwnClassDiMetadata(target);
+}
+
+/**
+ * Reads the current module metadata version for runtime compile-cache keys.
+ *
+ * @returns Monotonic module metadata version maintained by the core metadata store.
+ */
+export function getRuntimeModuleMetadataVersion() {
+  return getPeerModuleMetadataVersion();
+}
+
+/**
+ * Reads the current class DI metadata version for runtime compile-cache keys.
+ *
+ * @returns Monotonic class DI metadata version maintained by the core metadata store.
+ */
+export function getRuntimeClassDiMetadataVersion() {
+  return getPeerClassDiMetadataVersion();
+}
+
+/**
+ * Reads runtime-visible module metadata during graph compilation.
+ *
+ * @param target Module constructor whose metadata should be read.
+ * @returns Module metadata normalized by the core metadata store.
+ */
+export function getRuntimeModuleMetadata(target) {
+  return getPeerModuleMetadata(target);
+}

package/dist/internal/http-runtime.d.ts

@@ -0,0 +1,5 @@
+import { DefaultBinder } from '@fluojs/http/internal';
+import { attachFrameworkRequestNativeRouteHandoff, consumeRawRequestNativeRouteHandoff } from '@fluojs/http/internal';
+export { DefaultBinder as RuntimeDefaultBinder };
+export { attachFrameworkRequestNativeRouteHandoff as attachRuntimeFrameworkRequestNativeRouteHandoff, consumeRawRequestNativeRouteHandoff as consumeRuntimeRawRequestNativeRouteHandoff, };
+//# sourceMappingURL=http-runtime.d.ts.map

package/dist/internal/http-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-runtime.d.ts","sourceRoot":"","sources":["../../src/internal/http-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EACL,wCAAwC,EACxC,mCAAmC,EACpC,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,aAAa,IAAI,oBAAoB,EAAE,CAAC;AACjD,OAAO,EACL,wCAAwC,IAAI,+CAA+C,EAC3F,mCAAmC,IAAI,0CAA0C,GAClF,CAAC"}

package/dist/internal/http-runtime.js

@@ -0,0 +1,4 @@
+import { DefaultBinder } from '@fluojs/http/internal';
+import { attachFrameworkRequestNativeRouteHandoff, consumeRawRequestNativeRouteHandoff } from '@fluojs/http/internal';
+export { DefaultBinder as RuntimeDefaultBinder };
+export { attachFrameworkRequestNativeRouteHandoff as attachRuntimeFrameworkRequestNativeRouteHandoff, consumeRawRequestNativeRouteHandoff as consumeRuntimeRawRequestNativeRouteHandoff };

package/dist/internal.d.ts

@@ -1,2 +1,3 @@
-export { APPLICATION_LOGGER, COMPILED_MODULES, HTTP_APPLICATION_ADAPTER, PLATFORM_SHELL, RUNTIME_CONTAINER, } from './tokens.js';
+export { APPLICATION_LOGGER, BOOTSTRAP_READY_SIGNAL, COMPILED_MODULES, HTTP_APPLICATION_ADAPTER, PLATFORM_SHELL, RUNTIME_CONTAINER, RUNTIME_CLEANUP_REGISTRATION, } from './tokens.js';
+export type { BootstrapReadySignal } from './tokens.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,EACL,kBAAkB,EAClB,gBAAgB,EAChB,wBAAwB,EACxB,cAAc,EACd,iBAAiB,GAClB,MAAM,aAAa,CAAC"}
+{"version":3,"file":"internal.d.ts","sourceRoot":"","sources":["../src/internal.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,sBAAsB,EACtB,gBAAgB,EAChB,wBAAwB,EACxB,cAAc,EACd,iBAAiB,EACjB,4BAA4B,GAC7B,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC"}

package/dist/internal.js

@@ -1 +1 @@
-export { APPLICATION_LOGGER, COMPILED_MODULES, HTTP_APPLICATION_ADAPTER, PLATFORM_SHELL, RUNTIME_CONTAINER } from './tokens.js';
+export { APPLICATION_LOGGER, BOOTSTRAP_READY_SIGNAL, COMPILED_MODULES, HTTP_APPLICATION_ADAPTER, PLATFORM_SHELL, RUNTIME_CONTAINER, RUNTIME_CLEANUP_REGISTRATION } from './tokens.js';

package/dist/logging/logger.d.ts

@@ -1,8 +1,37 @@
 import type { ApplicationLogger } from '../types.js';
+/** Severity threshold accepted by `createConsoleApplicationLogger(...)`. */
+export type ConsoleApplicationLoggerLevel = 'debug' | 'error' | 'log' | 'warn';
+/** Console formatting mode accepted by `createConsoleApplicationLogger(...)`. */
+export type ConsoleApplicationLoggerMode = 'minimal' | 'pretty' | 'silent';
+/** Options used to tune the Node console logger without replacing the runtime logger contract. */
+export interface ConsoleApplicationLoggerOptions {
+    /**
+     * Controls console formatting.
+     *
+     * - `pretty` keeps the historical timestamp, pid, level, context, and message format.
+     * - `minimal` writes only `[fluo] LEVEL [context] message`.
+     * - `silent` suppresses all logger methods.
+     */
+    mode?: ConsoleApplicationLoggerMode;
+    /** Lowest severity emitted by the logger. Defaults to `debug`, preserving existing output. */
+    level?: ConsoleApplicationLoggerLevel;
+    /** Override TTY-aware ANSI color detection. */
+    color?: boolean;
+    /** Explicit host color environment passed from the application/bootstrap boundary. */
+    environment?: ConsoleApplicationLoggerEnvironment;
+}
+/** Host color environment used by `createConsoleApplicationLogger(...)` without reading globals directly. */
+export interface ConsoleApplicationLoggerEnvironment {
+    /** Whether `NO_COLOR`-style color suppression is enabled. */
+    noColor?: boolean;
+    /** `FORCE_COLOR`-style value used to force ANSI color output when truthy. */
+    forceColor?: string;
+}
 /**
  * Create console application logger.
  *
+ * @param options Console logger mode, severity threshold, and color override.
  * @returns The create console application logger result.
  */
-export declare function createConsoleApplicationLogger(): ApplicationLogger;
+export declare function createConsoleApplicationLogger(options?: ConsoleApplicationLoggerOptions): ApplicationLogger;
 //# sourceMappingURL=logger.d.ts.map

package/dist/logging/logger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/logging/logger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAuBrD;;;;GAIG;AACH,wBAAgB,8BAA8B,IAAI,iBAAiB,CAmBlE"}
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/logging/logger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAErD,4EAA4E;AAC5E,MAAM,MAAM,6BAA6B,GAAG,OAAO,GAAG,OAAO,GAAG,KAAK,GAAG,MAAM,CAAC;AAC/E,iFAAiF;AACjF,MAAM,MAAM,4BAA4B,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE3E,kGAAkG;AAClG,MAAM,WAAW,+BAA+B;IAC9C;;;;;;OAMG;IACH,IAAI,CAAC,EAAE,4BAA4B,CAAC;IACpC,8FAA8F;IAC9F,KAAK,CAAC,EAAE,6BAA6B,CAAC;IACtC,+CAA+C;IAC/C,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,sFAAsF;IACtF,WAAW,CAAC,EAAE,mCAAmC,CAAC;CACnD;AAED,6GAA6G;AAC7G,MAAM,WAAW,mCAAmC;IAClD,6DAA6D;IAC7D,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,6EAA6E;IAC7E,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AA2DD;;;;;GAKG;AACH,wBAAgB,8BAA8B,CAAC,OAAO,GAAE,+BAAoC,GAAG,iBAAiB,CA2C/G"}

package/dist/logging/logger.js

@@ -1,8 +1,22 @@
+/** Severity threshold accepted by `createConsoleApplicationLogger(...)`. */
+
+/** Console formatting mode accepted by `createConsoleApplicationLogger(...)`. */
+
+/** Options used to tune the Node console logger without replacing the runtime logger contract. */
+
+/** Host color environment used by `createConsoleApplicationLogger(...)` without reading globals directly. */
+
 const RESET = '\u001B[0m';
 const BRIGHT_GREEN = '\u001B[32m';
 const BRIGHT_RED = '\u001B[31m';
 const BRIGHT_YELLOW = '\u001B[33m';
 const DIM = '\u001B[2m';
+const LEVEL_PRIORITY = {
+  debug: 10,
+  log: 20,
+  warn: 30,
+  error: 40
+};
 function colorize(value, color, enabled) {
   return enabled ? `${color}${value}${RESET}` : value;
 }
@@ -15,28 +29,72 @@ function formatLog(level, context, message, color) {
   const contextLabel = colorize(`[${context}]`, BRIGHT_YELLOW, color);
   return `${prefix} ${pid} - ${timestamp} ${levelLabel} ${contextLabel} ${message}`;
 }
+function formatMinimalLog(level, context, message, color) {
+  const prefix = colorize('[fluo]', BRIGHT_GREEN, color);
+  const levelColor = level === 'ERROR' || level === 'WARN' ? BRIGHT_RED : BRIGHT_GREEN;
+  const levelLabel = colorize(level, levelColor, color);
+  const contextLabel = colorize(`[${context}]`, BRIGHT_YELLOW, color);
+  return `${prefix} ${levelLabel} ${contextLabel} ${message}`;
+}
+function shouldLog(currentLevel, configuredLevel) {
+  return LEVEL_PRIORITY[currentLevel] >= LEVEL_PRIORITY[configuredLevel];
+}
+function isForceColorEnabled(value) {
+  return value !== undefined && value !== '' && value !== '0' && value !== 'false' && value !== 'no' && value !== 'off';
+}
+function shouldUseColor(stream, environment) {
+  if (environment.noColor === true) {
+    return false;
+  }
+  if (isForceColorEnabled(environment.forceColor)) {
+    return true;
+  }
+  return Boolean(stream.isTTY);
+}
 
 /**
  * Create console application logger.
  *
+ * @param options Console logger mode, severity threshold, and color override.
  * @returns The create console application logger result.
  */
-export function createConsoleApplicationLogger() {
+export function createConsoleApplicationLogger(options = {}) {
+  const mode = options.mode ?? 'pretty';
+  const level = options.level ?? 'debug';
+  const environment = options.environment ?? {};
+  const format = mode === 'minimal' ? formatMinimalLog : formatLog;
+  if (mode === 'silent') {
+    return {
+      debug() {},
+      error() {},
+      log() {},
+      warn() {}
+    };
+  }
   return {
     debug(message, context = 'fluo') {
-      console.debug(formatLog('DEBUG', context, message, Boolean(process.stdout.isTTY)));
+      if (shouldLog('debug', level)) {
+        console.debug(format('DEBUG', context, message, options.color ?? shouldUseColor(process.stdout, environment)));
+      }
     },
     error(message, error, context = 'fluo') {
-      console.error(formatLog('ERROR', context, message, Boolean(process.stderr.isTTY)));
+      if (!shouldLog('error', level)) {
+        return;
+      }
+      console.error(format('ERROR', context, message, options.color ?? shouldUseColor(process.stderr, environment)));
       if (error) {
         console.error(error);
       }
     },
     log(message, context = 'fluo') {
-      console.log(formatLog('LOG', context, message, Boolean(process.stdout.isTTY)));
+      if (shouldLog('log', level)) {
+        console.log(format('LOG', context, message, options.color ?? shouldUseColor(process.stdout, environment)));
+      }
     },
     warn(message, context = 'fluo') {
-      console.warn(formatLog('WARN', context, message, Boolean(process.stderr.isTTY)));
+      if (shouldLog('warn', level)) {
+        console.warn(format('WARN', context, message, options.color ?? shouldUseColor(process.stderr, environment)));
+      }
     }
   };
 }

package/dist/module-graph.d.ts

@@ -1,5 +1,5 @@
-import type { Provider } from '@fluojs/di';
 import type { Token } from '@fluojs/core';
+import type { Provider } from '@fluojs/di';
 import type { BootstrapModuleOptions, CompiledModule, ModuleType } from './types.js';
 /**
  * Returns the public token represented by a provider declaration.

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

@@ -1 +1 @@
-{"version":3,"file":"module-graph.d.ts","sourceRoot":"","sources":["../src/module-graph.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAW1C,OAAO,KAAK,EAAE,sBAAsB,EAAE,cAAc,EAAoB,UAAU,EAAE,MAAM,YAAY,CAAC;AAEvG;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,QAAQ,GAAG,KAAK,CAMvD;AAiBD,yFAAyF;AACzF,wBAAgB,sCAAsC,IAAI,IAAI,CAE7D;AAED;;;;GAIG;AACH,wBAAgB,wCAAwC,IAAI,MAAM,CAEjE;AAgFD;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,UAAU,EAAE,UAAU,EAAE,OAAO,GAAE,sBAA2B,GAAG,MAAM,CAY9G;AAiRD;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,GAAE,QAAQ,EAAO,GAAG,GAAG,CAAC,KAAK,CAAC,CAE5E;AA8UD;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,UAAU,EAAE,OAAO,GAAE,sBAA2B,GAAG,cAAc,EAAE,CA4BjH"}
+{"version":3,"file":"module-graph.d.ts","sourceRoot":"","sources":["../src/module-graph.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAY3C,OAAO,KAAK,EAAE,sBAAsB,EAAE,cAAc,EAAoB,UAAU,EAAE,MAAM,YAAY,CAAC;AAEvG;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,QAAQ,GAAG,KAAK,CAMvD;AAiBD,yFAAyF;AACzF,wBAAgB,sCAAsC,IAAI,IAAI,CAE7D;AAED;;;;GAIG;AACH,wBAAgB,wCAAwC,IAAI,MAAM,CAEjE;AAgFD;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,UAAU,EAAE,UAAU,EAAE,OAAO,GAAE,sBAA2B,GAAG,MAAM,CAY9G;AAiRD;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,GAAE,QAAQ,EAAO,GAAG,GAAG,CAAC,KAAK,CAAC,CAE5E;AA8UD;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,UAAU,EAAE,OAAO,GAAE,sBAA2B,GAAG,cAAc,EAAE,CA4BjH"}

package/dist/module-graph.js

@@ -1,4 +1,4 @@
-import { getClassDiMetadata, getClassDiMetadataVersion, getModuleMetadata, getModuleMetadataVersion, getOwnClassDiMetadata } from '@fluojs/core/internal';
+import { getRuntimeClassDiMetadata, getRuntimeClassDiMetadataVersion, getOwnRuntimeClassDiMetadata, getRuntimeModuleMetadata, getRuntimeModuleMetadataVersion } from './internal/core-metadata.js';
 import { ModuleGraphError, ModuleInjectionMetadataError, ModuleVisibilityError } from './errors.js';
 /**
  * Returns the public token represented by a provider declaration.
@@ -98,7 +98,7 @@ function describeProviderForCacheKey(provider) {
 export function createModuleGraphCacheKey(rootModule, options = {}) {
   const runtimeProviders = (options.providers ?? []).map(describeProviderForCacheKey).join('|');
   const validationTokens = (options.validationTokens ?? []).map(describeTokenForCacheKey).join('|');
-  return [`root:${describeTokenForCacheKey(rootModule)}`, `module:${getModuleMetadataVersion()}`, `class-di:${getClassDiMetadataVersion()}`, `algorithm:${MODULE_GRAPH_COMPILE_ALGORITHM_VERSION}`, `runtime:${runtimeProviders}`, `validation:${validationTokens}`].join(';');
+  return [`root:${describeTokenForCacheKey(rootModule)}`, `module:${getRuntimeModuleMetadataVersion()}`, `class-di:${getRuntimeClassDiMetadataVersion()}`, `algorithm:${MODULE_GRAPH_COMPILE_ALGORITHM_VERSION}`, `runtime:${runtimeProviders}`, `validation:${validationTokens}`].join(';');
 }
 function cloneModuleDefinition(definition) {
   return {
@@ -287,7 +287,7 @@ function createModuleGraphCacheSnapshot(modules) {
   return Object.freeze(cloneCompiledModules(modules).map(compiledModule => freezeCompiledModule(compiledModule)));
 }
 function getEffectiveClassDiMetadata(target) {
-  const metadata = getClassDiMetadata(target);
+  const metadata = getRuntimeClassDiMetadata(target);
   if (!metadata) {
     return undefined;
   }
@@ -335,7 +335,7 @@ function mergeRuntimeTokenSets(providers = [], validationTokens = []) {
   return new Set([...createRuntimeTokenSet(providers), ...validationTokens]);
 }
 function requiredConstructorParameters(target) {
-  if (getOwnClassDiMetadata(target)?.inject !== undefined) {
+  if (getOwnRuntimeClassDiMetadata(target)?.inject !== undefined) {
     return 0;
   }
   return target.length;
@@ -398,7 +398,7 @@ function compileModule(moduleType, runtimeProviderTokens, compiled = new Map(),
     });
   }
   visiting.add(moduleType);
-  const definition = normalizeModuleDefinition(getModuleMetadata(moduleType));
+  const definition = normalizeModuleDefinition(getRuntimeModuleMetadata(moduleType));
   for (const imported of definition.imports ?? []) {
     compileModule(imported, runtimeProviderTokens, compiled, visiting, ordered);
   }

package/dist/tokens.d.ts

@@ -3,7 +3,13 @@ import type { Container } from '@fluojs/di';
 import type { HttpApplicationAdapter } from '@fluojs/http';
 import type { ApplicationLogger } from './types.js';
 import type { CompiledModule } from './types.js';
+import type { RuntimeCleanupRegistration } from './types.js';
 import type { PlatformShell } from './platform-contract.js';
+/** Internal signal that resolves only after application bootstrap reaches runtime readiness. */
+export interface BootstrapReadySignal {
+    /** Waits until every bootstrap hook and runtime readiness transition has completed. */
+    wait(): Promise<void>;
+}
 /**
  * Injection token for the application logger.
  */
@@ -24,4 +30,10 @@ export declare const HTTP_APPLICATION_ADAPTER: Token<HttpApplicationAdapter>;
  * Injection token for the platform shell.
  */
 export declare const PLATFORM_SHELL: Token<PlatformShell>;
+/**
+ * Internal injection token for registering runtime-owned cleanup callbacks.
+ */
+export declare const RUNTIME_CLEANUP_REGISTRATION: Token<RuntimeCleanupRegistration>;
+/** Internal injection token for integrations that must defer work until full runtime readiness. */
+export declare const BOOTSTRAP_READY_SIGNAL: Token<BootstrapReadySignal>;
 //# sourceMappingURL=tokens.d.ts.map

package/dist/tokens.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tokens.d.ts","sourceRoot":"","sources":["../src/tokens.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAE3D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAE5D;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,KAAK,CAAC,iBAAiB,CAAiD,CAAC;AAE1G;;GAEG;AACH,eAAO,MAAM,iBAAiB,EAAE,KAAK,CAAC,SAAS,CAA+B,CAAC;AAE/E;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,KAAK,CAAC,SAAS,cAAc,EAAE,CAA8B,CAAC;AAE7F;;GAEG;AACH,eAAO,MAAM,wBAAwB,EAAE,KAAK,CAAC,sBAAsB,CAAsC,CAAC;AAE1G;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,KAAK,CAAC,aAAa,CAA4B,CAAC"}
+{"version":3,"file":"tokens.d.ts","sourceRoot":"","sources":["../src/tokens.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAE3D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,YAAY,CAAC;AAC7D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAE5D,gGAAgG;AAChG,MAAM,WAAW,oBAAoB;IACnC,uFAAuF;IACvF,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB;AAED;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,KAAK,CAAC,iBAAiB,CAAiD,CAAC;AAE1G;;GAEG;AACH,eAAO,MAAM,iBAAiB,EAAE,KAAK,CAAC,SAAS,CAA+B,CAAC;AAE/E;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,KAAK,CAAC,SAAS,cAAc,EAAE,CAA8B,CAAC;AAE7F;;GAEG;AACH,eAAO,MAAM,wBAAwB,EAAE,KAAK,CAAC,sBAAsB,CAAsC,CAAC;AAE1G;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,KAAK,CAAC,aAAa,CAA4B,CAAC;AAE7E;;GAEG;AACH,eAAO,MAAM,4BAA4B,EAAE,KAAK,CAAC,0BAA0B,CAA0C,CAAC;AAEtH,mGAAmG;AACnG,eAAO,MAAM,sBAAsB,EAAE,KAAK,CAAC,oBAAoB,CAAoC,CAAC"}

package/dist/tokens.js

@@ -1,3 +1,5 @@
+/** Internal signal that resolves only after application bootstrap reaches runtime readiness. */
+
 /**
  * Injection token for the application logger.
  */
@@ -21,4 +23,12 @@ export const HTTP_APPLICATION_ADAPTER = Symbol('HTTP_APPLICATION_ADAPTER');
 /**
  * Injection token for the platform shell.
  */
-export const PLATFORM_SHELL = Symbol('PLATFORM_SHELL');
+export const PLATFORM_SHELL = Symbol('PLATFORM_SHELL');
+
+/**
+ * Internal injection token for registering runtime-owned cleanup callbacks.
+ */
+export const RUNTIME_CLEANUP_REGISTRATION = Symbol('RUNTIME_CLEANUP_REGISTRATION');
+
+/** Internal injection token for integrations that must defer work until full runtime readiness. */
+export const BOOTSTRAP_READY_SIGNAL = Symbol('BOOTSTRAP_READY_SIGNAL');

package/dist/types.d.ts

@@ -81,6 +81,8 @@ export interface ApplicationLogger {
     log(message: string, context?: string): void;
     warn(message: string, context?: string): void;
 }
+/** Registers runtime-owned cleanup callbacks that must run during bootstrap failure or shutdown. */
+export type RuntimeCleanupRegistration = (cleanup: () => void) => () => void;
 /** Runtime-visible application states for HTTP and microservice shells. */
 export type ApplicationState = 'bootstrapped' | 'ready' | 'closed';
 /**