@fluojs/runtime 1.0.0-beta.1 → 1.0.0-beta.11

package/dist/health/diagnostics.d.ts

@@ -1,11 +1,17 @@
 import type { Scope } from '@fluojs/di';
 import type { CompiledModule, ModuleType } from '../types.js';
+/**
+ * Describes the runtime diagnostics graph contract.
+ */
 export interface RuntimeDiagnosticsGraph {
     version: 1;
     rootModule: string;
     modules: RuntimeDiagnosticsModule[];
     relationships: RuntimeDiagnosticsRelationships;
 }
+/**
+ * Describes the runtime diagnostics module contract.
+ */
 export interface RuntimeDiagnosticsModule {
     name: string;
     global: boolean;
@@ -14,12 +20,18 @@ export interface RuntimeDiagnosticsModule {
     providers: RuntimeDiagnosticsProvider[];
     exports: string[];
 }
+/**
+ * Describes the runtime diagnostics provider contract.
+ */
 export interface RuntimeDiagnosticsProvider {
     token: string;
     type: 'class' | 'factory' | 'value' | 'existing';
     scope: Scope;
     multi: boolean;
 }
+/**
+ * Describes the runtime diagnostics relationships contract.
+ */
 export interface RuntimeDiagnosticsRelationships {
     moduleImports: Array<{
         from: string;
@@ -41,16 +53,42 @@ export interface RuntimeDiagnosticsRelationships {
         module: string;
     }>;
 }
+/**
+ * Describes the bootstrap timing phase contract.
+ */
 export interface BootstrapTimingPhase {
     durationMs: number;
     name: 'bootstrap_module' | 'register_runtime_tokens' | 'resolve_lifecycle_instances' | 'run_bootstrap_lifecycle' | 'create_dispatcher';
 }
+/**
+ * Describes the bootstrap timing diagnostics contract.
+ */
 export interface BootstrapTimingDiagnostics {
     phases: BootstrapTimingPhase[];
     totalMs: number;
     version: 1;
 }
+/**
+ * Create runtime diagnostics graph.
+ *
+ * @param modules The modules.
+ * @param rootModule The root module.
+ * @returns The create runtime diagnostics graph result.
+ */
 export declare function createRuntimeDiagnosticsGraph(modules: readonly CompiledModule[], rootModule: ModuleType): RuntimeDiagnosticsGraph;
+/**
+ * Render runtime diagnostics mermaid.
+ *
+ * @param graph The graph.
+ * @returns The render runtime diagnostics mermaid result.
+ */
 export declare function renderRuntimeDiagnosticsMermaid(graph: RuntimeDiagnosticsGraph): string;
+/**
+ * Create bootstrap timing diagnostics.
+ *
+ * @param phases The phases.
+ * @param totalMs The total ms.
+ * @returns The create bootstrap timing diagnostics result.
+ */
 export declare function createBootstrapTimingDiagnostics(phases: BootstrapTimingPhase[], totalMs: number): BootstrapTimingDiagnostics;
 //# sourceMappingURL=diagnostics.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../../src/health/diagnostics.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAY,KAAK,EAAE,MAAM,YAAY,CAAC;AAElD,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9D,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,CAAC,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,wBAAwB,EAAE,CAAC;IACpC,aAAa,EAAE,+BAA+B,CAAC;CAChD;AAED,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,SAAS,EAAE,0BAA0B,EAAE,CAAC;IACxC,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,0BAA0B;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,OAAO,GAAG,SAAS,GAAG,OAAO,GAAG,UAAU,CAAC;IACjD,KAAK,EAAE,KAAK,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,+BAA+B;IAC9C,aAAa,EAAE,KAAK,CAAC;QACnB,IAAI,EAAE,MAAM,CAAC;QACb,EAAE,EAAE,MAAM,CAAC;KACZ,CAAC,CAAC;IACH,aAAa,EAAE,KAAK,CAAC;QACnB,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,MAAM,CAAC;KACf,CAAC,CAAC;IACH,eAAe,EAAE,KAAK,CAAC;QACrB,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,MAAM,CAAC;QACd,YAAY,EAAE,0BAA0B,CAAC,MAAM,CAAC,CAAC;QACjD,KAAK,EAAE,KAAK,CAAC;QACb,KAAK,EAAE,OAAO,CAAC;KAChB,CAAC,CAAC;IACH,iBAAiB,EAAE,KAAK,CAAC;QACvB,UAAU,EAAE,MAAM,CAAC;QACnB,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC,CAAC;CACJ;AAED,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EACA,kBAAkB,GAClB,yBAAyB,GACzB,6BAA6B,GAC7B,yBAAyB,GACzB,mBAAmB,CAAC;CACzB;AAED,MAAM,WAAW,0BAA0B;IACzC,MAAM,EAAE,oBAAoB,EAAE,CAAC;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,CAAC,CAAC;CACZ;AAiFD,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,SAAS,cAAc,EAAE,EAAE,UAAU,EAAE,UAAU,GAAG,uBAAuB,CAkEjI;AAED,wBAAgB,+BAA+B,CAAC,KAAK,EAAE,uBAAuB,GAAG,MAAM,CAoCtF;AAED,wBAAgB,gCAAgC,CAC9C,MAAM,EAAE,oBAAoB,EAAE,EAC9B,OAAO,EAAE,MAAM,GACd,0BAA0B,CAS5B"}
+{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../../src/health/diagnostics.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAY,KAAK,EAAE,MAAM,YAAY,CAAC;AAElD,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9D;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,CAAC,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,wBAAwB,EAAE,CAAC;IACpC,aAAa,EAAE,+BAA+B,CAAC;CAChD;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,SAAS,EAAE,0BAA0B,EAAE,CAAC;IACxC,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,OAAO,GAAG,SAAS,GAAG,OAAO,GAAG,UAAU,CAAC;IACjD,KAAK,EAAE,KAAK,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,+BAA+B;IAC9C,aAAa,EAAE,KAAK,CAAC;QACnB,IAAI,EAAE,MAAM,CAAC;QACb,EAAE,EAAE,MAAM,CAAC;KACZ,CAAC,CAAC;IACH,aAAa,EAAE,KAAK,CAAC;QACnB,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,MAAM,CAAC;KACf,CAAC,CAAC;IACH,eAAe,EAAE,KAAK,CAAC;QACrB,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,MAAM,CAAC;QACd,YAAY,EAAE,0BAA0B,CAAC,MAAM,CAAC,CAAC;QACjD,KAAK,EAAE,KAAK,CAAC;QACb,KAAK,EAAE,OAAO,CAAC;KAChB,CAAC,CAAC;IACH,iBAAiB,EAAE,KAAK,CAAC;QACvB,UAAU,EAAE,MAAM,CAAC;QACnB,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC,CAAC;CACJ;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EACA,kBAAkB,GAClB,yBAAyB,GACzB,6BAA6B,GAC7B,yBAAyB,GACzB,mBAAmB,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,MAAM,EAAE,oBAAoB,EAAE,CAAC;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,CAAC,CAAC;CACZ;AAiFD;;;;;;GAMG;AACH,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,SAAS,cAAc,EAAE,EAAE,UAAU,EAAE,UAAU,GAAG,uBAAuB,CAkEjI;AAED;;;;;GAKG;AACH,wBAAgB,+BAA+B,CAAC,KAAK,EAAE,uBAAuB,GAAG,MAAM,CAoCtF;AAED;;;;;;GAMG;AACH,wBAAgB,gCAAgC,CAC9C,MAAM,EAAE,oBAAoB,EAAE,EAC9B,OAAO,EAAE,MAAM,GACd,0BAA0B,CAS5B"}

package/dist/health/diagnostics.js

@@ -1,4 +1,29 @@
 import { getClassDiMetadata } from '@fluojs/core/internal';
+
+/**
+ * Describes the runtime diagnostics graph contract.
+ */
+
+/**
+ * Describes the runtime diagnostics module contract.
+ */
+
+/**
+ * Describes the runtime diagnostics provider contract.
+ */
+
+/**
+ * Describes the runtime diagnostics relationships contract.
+ */
+
+/**
+ * Describes the bootstrap timing phase contract.
+ */
+
+/**
+ * Describes the bootstrap timing diagnostics contract.
+ */
+
 function roundMs(value) {
   return Number(value.toFixed(3));
 }
@@ -59,6 +84,14 @@ function normalizeProvider(provider) {
     type: providerShape(provider)
   };
 }
+
+/**
+ * Create runtime diagnostics graph.
+ *
+ * @param modules The modules.
+ * @param rootModule The root module.
+ * @returns The create runtime diagnostics graph result.
+ */
 export function createRuntimeDiagnosticsGraph(modules, rootModule) {
   const moduleDiagnostics = [];
   const moduleImports = [];
@@ -119,6 +152,13 @@ export function createRuntimeDiagnosticsGraph(modules, rootModule) {
     version: 1
   };
 }
+
+/**
+ * Render runtime diagnostics mermaid.
+ *
+ * @param graph The graph.
+ * @returns The render runtime diagnostics mermaid result.
+ */
 export function renderRuntimeDiagnosticsMermaid(graph) {
   const lines = ['graph TD'];
   const nodeByModule = new Map();
@@ -143,6 +183,14 @@ export function renderRuntimeDiagnosticsMermaid(graph) {
   }
   return lines.join('\n');
 }
+
+/**
+ * Create bootstrap timing diagnostics.
+ *
+ * @param phases The phases.
+ * @param totalMs The total ms.
+ * @returns The create bootstrap timing diagnostics result.
+ */
 export function createBootstrapTimingDiagnostics(phases, totalMs) {
   return {
     phases: phases.map(phase => ({

package/dist/health/health.d.ts

@@ -1,18 +1,52 @@
 import type { ModuleType } from '../types.js';
+/**
+ * Describes the health status contract.
+ */
 export interface HealthStatus {
     status: 'ok' | 'unavailable';
 }
+/**
+ * Describes the health check response contract.
+ */
 export interface HealthCheckResponse {
     body: unknown;
     statusCode?: number;
 }
+/**
+ * Describes the readiness status contract.
+ */
 export interface ReadinessStatus {
     status: 'ready' | 'starting' | 'unavailable';
 }
+/**
+ * Describes the health module options contract.
+ */
 export interface HealthModuleOptions {
     healthCheck?: (ctx: import('@fluojs/http').RequestContext) => HealthStatus | HealthCheckResponse | Promise<HealthStatus | HealthCheckResponse>;
     path?: string;
 }
+/**
+ * Defines the readiness check type.
+ */
 export type ReadinessCheck = () => boolean | Promise<boolean>;
+/**
+ * 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.
+ *
+ * @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,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,IAAI,GAAG,aAAa,CAAC;CAC9B;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,OAAO,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,OAAO,GAAG,UAAU,GAAG,aAAa,CAAC;CAC9C;AAED,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,MAAM,MAAM,cAAc,GAAG,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;AAE9D,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,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;AAkF9D;;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

@@ -5,7 +5,28 @@ function _setFunctionName(e, t, n) { "symbol" == typeof t && (t = (t = t.descrip
 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 { defineModule } from '../bootstrap.js';
-export function createHealthModule(options = {}) {
+
+/**
+ * Describes the health status contract.
+ */
+
+/**
+ * Describes the health check response contract.
+ */
+
+/**
+ * Describes the readiness status contract.
+ */
+
+/**
+ * Describes the health module options contract.
+ */
+
+/**
+ * Defines the readiness check type.
+ */
+
+function createRuntimeHealthModule(options = {}) {
   let _initProto, _initClass;
   const basePath = options.path ?? '';
   const readinessChecks = [];
@@ -64,7 +85,7 @@ export function createHealthModule(options = {}) {
       _initClass();
     }
   }
-  class HealthModule {
+  class RuntimeHealthModule {
     static addReadinessCheck(fn) {
       readinessChecks.push(fn);
     }
@@ -75,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/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/logging/json-logger.d.ts

@@ -1,3 +1,8 @@
 import type { ApplicationLogger } from '../types.js';
+/**
+ * Create json application logger.
+ *
+ * @returns The create json application logger result.
+ */
 export declare function createJsonApplicationLogger(): ApplicationLogger;
 //# sourceMappingURL=json-logger.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"json-logger.d.ts","sourceRoot":"","sources":["../../src/logging/json-logger.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAqCrD,wBAAgB,2BAA2B,IAAI,iBAAiB,CAe/D"}
+{"version":3,"file":"json-logger.d.ts","sourceRoot":"","sources":["../../src/logging/json-logger.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAqCrD;;;;GAIG;AACH,wBAAgB,2BAA2B,IAAI,iBAAiB,CAe/D"}

package/dist/logging/json-logger.js

@@ -21,6 +21,12 @@ function buildEntry(level, message, context, error) {
   }
   return entry;
 }
+
+/**
+ * Create json application logger.
+ *
+ * @returns The create json application logger result.
+ */
 export function createJsonApplicationLogger() {
   return {
     debug(message, context) {

package/dist/logging/logger.d.ts

@@ -1,3 +1,37 @@
 import type { ApplicationLogger } from '../types.js';
-export declare function createConsoleApplicationLogger(): ApplicationLogger;
+/** 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(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,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,22 +29,72 @@ function formatLog(level, context, message, color) {
   const contextLabel = colorize(`[${context}]`, BRIGHT_YELLOW, color);
   return `${prefix} ${pid} - ${timestamp} ${levelLabel} ${contextLabel} ${message}`;
 }
-export function createConsoleApplicationLogger() {
+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(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

@@ -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;AAyTD;;;;;;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,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"}