@fluojs/runtime 1.0.0-beta.8 → 1.0.0

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/index.d.ts

@@ -1,6 +1,7 @@
 export * from './abort.js';
 export * from './bootstrap.js';
-export * from './health/diagnostics.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 * from './health/health.js';
 export type { MultipartOptions, MultipartRequestLike, MultipartResult, UploadedFile, } from './multipart.js';

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,cAAc,yBAAyB,CAAC;AACxC,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,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"}

package/dist/index.js

@@ -1,6 +1,6 @@
 export * from './abort.js';
 export * from './bootstrap.js';
-export * from './health/diagnostics.js';
+export { createBootstrapTimingDiagnostics, createRuntimeDiagnosticsGraph } from './health/diagnostics.js';
 export * from './errors.js';
 export * from './health/health.js';
 export * from './request-transaction.js';

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.
@@ -8,6 +8,22 @@ import type { BootstrapModuleOptions, CompiledModule, ModuleType } from './types
  * @returns The token that should be registered and resolved for the provider.
  */
 export declare function providerToken(provider: Provider): Token;
+/** Clears the process-local module graph compile cache for isolated regression tests. */
+export declare function clearModuleGraphCompileCacheForTesting(): void;
+/**
+ * Reads the current process-local module graph compile cache size for tests.
+ *
+ * @returns Number of successful compile snapshots currently retained in the cache.
+ */
+export declare function getModuleGraphCompileCacheSizeForTesting(): number;
+/**
+ * Builds the key used for opt-in module graph compile caching.
+ *
+ * @param rootModule Root module that would be compiled.
+ * @param options Bootstrap options that influence graph validation.
+ * @returns Process-local key that changes when metadata or runtime validation inputs change.
+ */
+export declare function createModuleGraphCacheKey(rootModule: ModuleType, options?: BootstrapModuleOptions): string;
 /**
  * Collects runtime provider tokens into a set for visibility and validation checks.
  *

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;AAK1C,OAAO,KAAK,EAAE,sBAAsB,EAAE,cAAc,EAAoB,UAAU,EAAE,MAAM,YAAY,CAAC;AAEvG;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,QAAQ,GAAG,KAAK,CAMvD;AAyDD;;;;;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,CASjH"}
+{"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"}