@fluojs/runtime 1.0.0-beta.1

package/dist/errors.d.ts

@@ -0,0 +1,39 @@
+import { FluoError } from '@fluojs/core';
+/**
+ * Structured context for runtime-level errors.
+ */
+export interface RuntimeErrorContext {
+    /** Name of the module where the error occurred. */
+    readonly module?: string;
+    /** DI token associated with the failure. */
+    readonly token?: unknown;
+    /** Application bootstrap or lifecycle phase. */
+    readonly phase?: string;
+    /** Actionable hint for resolving the error. */
+    readonly hint?: string;
+}
+/**
+ * Error thrown when a failure occurs during module graph compilation or resolution.
+ */
+export declare class ModuleGraphError extends FluoError {
+    constructor(message: string, context?: RuntimeErrorContext);
+}
+/**
+ * Error thrown when a provider is requested from a module that does not have visibility to it.
+ */
+export declare class ModuleVisibilityError extends FluoError {
+    constructor(message: string, context?: RuntimeErrorContext);
+}
+/**
+ * Error thrown when module injection metadata is missing or invalid.
+ */
+export declare class ModuleInjectionMetadataError extends FluoError {
+    constructor(message: string, context?: RuntimeErrorContext);
+}
+/**
+ * Error thrown when multiple providers are registered for the same token within a module.
+ */
+export declare class DuplicateProviderError extends FluoError {
+    constructor(message: string, context?: RuntimeErrorContext);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +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"}

package/dist/errors.js

@@ -0,0 +1,88 @@
+import { FluoError, formatTokenName } from '@fluojs/core';
+
+/**
+ * Structured context for runtime-level errors.
+ */
+
+function formatRuntimeContext(ctx) {
+  if (!ctx) return '';
+  const parts = [];
+  if (ctx.module) {
+    parts.push(`Module: ${ctx.module}`);
+  }
+  if (ctx.token !== undefined) {
+    parts.push(`Token: ${formatTokenName(ctx.token)}`);
+  }
+  if (ctx.phase) {
+    parts.push(`Phase: ${ctx.phase}`);
+  }
+  if (ctx.hint) {
+    parts.push(`Hint: ${ctx.hint}`);
+  }
+  if (parts.length === 0) return '';
+  return '\n  ' + parts.join('\n  ');
+}
+function buildRuntimeMeta(context) {
+  const meta = {};
+  if (context.module) meta['module'] = context.module;
+  if (context.token !== undefined) meta['token'] = formatTokenName(context.token);
+  if (context.phase) meta['phase'] = context.phase;
+  if (context.hint) meta['hint'] = context.hint;
+  return meta;
+}
+
+/**
+ * Error thrown when a failure occurs during module graph compilation or resolution.
+ */
+export class ModuleGraphError extends FluoError {
+  constructor(message, context) {
+    super(message + formatRuntimeContext(context), {
+      code: 'MODULE_GRAPH_ERROR',
+      ...(context ? {
+        meta: buildRuntimeMeta(context)
+      } : undefined)
+    });
+  }
+}
+
+/**
+ * Error thrown when a provider is requested from a module that does not have visibility to it.
+ */
+export class ModuleVisibilityError extends FluoError {
+  constructor(message, context) {
+    super(message + formatRuntimeContext(context), {
+      code: 'MODULE_VISIBILITY_ERROR',
+      ...(context ? {
+        meta: buildRuntimeMeta(context)
+      } : undefined)
+    });
+  }
+}
+
+/**
+ * Error thrown when module injection metadata is missing or invalid.
+ */
+export class ModuleInjectionMetadataError extends FluoError {
+  constructor(message, context) {
+    super(message + formatRuntimeContext(context), {
+      code: 'MODULE_INJECTION_METADATA_ERROR',
+      ...(context ? {
+        meta: buildRuntimeMeta(context)
+      } : undefined)
+    });
+  }
+}
+
+/**
+ * Error thrown when multiple providers are registered for the same token within a module.
+ */
+export class DuplicateProviderError extends FluoError {
+  constructor(message, context) {
+    super(message + formatRuntimeContext(context), {
+      code: 'DUPLICATE_PROVIDER_ERROR',
+      ...(context ? {
+        meta: buildRuntimeMeta(context)
+      } : undefined)
+    });
+  }
+}

package/dist/health/diagnostics.d.ts

@@ -0,0 +1,56 @@
+import type { Scope } from '@fluojs/di';
+import type { CompiledModule, ModuleType } from '../types.js';
+export interface RuntimeDiagnosticsGraph {
+    version: 1;
+    rootModule: string;
+    modules: RuntimeDiagnosticsModule[];
+    relationships: RuntimeDiagnosticsRelationships;
+}
+export interface RuntimeDiagnosticsModule {
+    name: string;
+    global: boolean;
+    imports: string[];
+    controllers: string[];
+    providers: RuntimeDiagnosticsProvider[];
+    exports: string[];
+}
+export interface RuntimeDiagnosticsProvider {
+    token: string;
+    type: 'class' | 'factory' | 'value' | 'existing';
+    scope: Scope;
+    multi: boolean;
+}
+export interface RuntimeDiagnosticsRelationships {
+    moduleImports: Array<{
+        from: string;
+        to: string;
+    }>;
+    moduleExports: Array<{
+        module: string;
+        token: string;
+    }>;
+    moduleProviders: Array<{
+        module: string;
+        token: string;
+        providerType: RuntimeDiagnosticsProvider['type'];
+        scope: Scope;
+        multi: boolean;
+    }>;
+    moduleControllers: Array<{
+        controller: string;
+        module: string;
+    }>;
+}
+export interface BootstrapTimingPhase {
+    durationMs: number;
+    name: 'bootstrap_module' | 'register_runtime_tokens' | 'resolve_lifecycle_instances' | 'run_bootstrap_lifecycle' | 'create_dispatcher';
+}
+export interface BootstrapTimingDiagnostics {
+    phases: BootstrapTimingPhase[];
+    totalMs: number;
+    version: 1;
+}
+export declare function createRuntimeDiagnosticsGraph(modules: readonly CompiledModule[], rootModule: ModuleType): RuntimeDiagnosticsGraph;
+export declare function renderRuntimeDiagnosticsMermaid(graph: RuntimeDiagnosticsGraph): string;
+export declare function createBootstrapTimingDiagnostics(phases: BootstrapTimingPhase[], totalMs: number): BootstrapTimingDiagnostics;
+//# sourceMappingURL=diagnostics.d.ts.map

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

@@ -0,0 +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"}

package/dist/health/diagnostics.js

@@ -0,0 +1,155 @@
+import { getClassDiMetadata } from '@fluojs/core/internal';
+function roundMs(value) {
+  return Number(value.toFixed(3));
+}
+function labelModule(moduleType) {
+  return moduleType.name || '<anonymous-module>';
+}
+function labelToken(token) {
+  if (typeof token === 'function') {
+    return token.name || '<anonymous-token>';
+  }
+  if (typeof token === 'symbol') {
+    return token.description ? `Symbol(${token.description})` : token.toString();
+  }
+  return String(token);
+}
+function providerShape(provider) {
+  if (typeof provider === 'function') {
+    return 'class';
+  }
+  if ('useFactory' in provider) {
+    return 'factory';
+  }
+  if ('useValue' in provider) {
+    return 'value';
+  }
+  if ('useExisting' in provider) {
+    return 'existing';
+  }
+  return 'class';
+}
+function providerScope(provider) {
+  if (typeof provider === 'function') {
+    return getClassDiMetadata(provider)?.scope ?? 'singleton';
+  }
+  if ('useValue' in provider || 'useExisting' in provider) {
+    return 'singleton';
+  }
+  if ('useFactory' in provider) {
+    return provider.scope ?? (provider.resolverClass ? getClassDiMetadata(provider.resolverClass)?.scope : undefined) ?? 'singleton';
+  }
+  if ('useClass' in provider) {
+    return provider.scope ?? getClassDiMetadata(provider.useClass)?.scope ?? 'singleton';
+  }
+  return 'singleton';
+}
+function providerToken(provider) {
+  if (typeof provider === 'function') {
+    return provider;
+  }
+  return provider.provide;
+}
+function normalizeProvider(provider) {
+  const multi = typeof provider === 'object' && provider !== null && 'multi' in provider && provider.multi === true;
+  return {
+    multi,
+    scope: providerScope(provider),
+    token: labelToken(providerToken(provider)),
+    type: providerShape(provider)
+  };
+}
+export function createRuntimeDiagnosticsGraph(modules, rootModule) {
+  const moduleDiagnostics = [];
+  const moduleImports = [];
+  const moduleExports = [];
+  const moduleProviders = [];
+  const moduleControllers = [];
+  for (const compiledModule of modules) {
+    const moduleName = labelModule(compiledModule.type);
+    const imports = (compiledModule.definition.imports ?? []).map(moduleType => labelModule(moduleType));
+    const controllers = (compiledModule.definition.controllers ?? []).map(controller => controller.name || '<anonymous-controller>');
+    const providers = (compiledModule.definition.providers ?? []).map(provider => normalizeProvider(provider));
+    const exports = Array.from(compiledModule.exportedTokens).map(token => labelToken(token));
+    moduleDiagnostics.push({
+      controllers,
+      exports,
+      global: compiledModule.definition.global ?? false,
+      imports,
+      name: moduleName,
+      providers
+    });
+    for (const imported of imports) {
+      moduleImports.push({
+        from: moduleName,
+        to: imported
+      });
+    }
+    for (const token of exports) {
+      moduleExports.push({
+        module: moduleName,
+        token
+      });
+    }
+    for (const provider of providers) {
+      moduleProviders.push({
+        module: moduleName,
+        multi: provider.multi,
+        providerType: provider.type,
+        scope: provider.scope,
+        token: provider.token
+      });
+    }
+    for (const controller of controllers) {
+      moduleControllers.push({
+        controller,
+        module: moduleName
+      });
+    }
+  }
+  return {
+    modules: moduleDiagnostics,
+    relationships: {
+      moduleControllers,
+      moduleExports,
+      moduleImports,
+      moduleProviders
+    },
+    rootModule: labelModule(rootModule),
+    version: 1
+  };
+}
+export function renderRuntimeDiagnosticsMermaid(graph) {
+  const lines = ['graph TD'];
+  const nodeByModule = new Map();
+  for (const [index, module] of graph.modules.entries()) {
+    const nodeId = `M${String(index + 1)}`;
+    nodeByModule.set(module.name, nodeId);
+    const summary = [module.name, `providers: ${String(module.providers.length)}`, `controllers: ${String(module.controllers.length)}`, `exports: ${String(module.exports.length)}`].join('\\n');
+    lines.push(`  ${nodeId}["${summary}"]`);
+  }
+  for (const relation of graph.relationships.moduleImports) {
+    const from = nodeByModule.get(relation.from);
+    const to = nodeByModule.get(relation.to);
+    if (!from || !to) {
+      continue;
+    }
+    lines.push(`  ${from} --> ${to}`);
+  }
+  const rootNodeId = nodeByModule.get(graph.rootModule);
+  if (rootNodeId) {
+    lines.push(`  class ${rootNodeId} rootModule`);
+    lines.push('  classDef rootModule stroke:#2563eb,stroke-width:2px');
+  }
+  return lines.join('\n');
+}
+export function createBootstrapTimingDiagnostics(phases, totalMs) {
+  return {
+    phases: phases.map(phase => ({
+      ...phase,
+      durationMs: roundMs(phase.durationMs)
+    })),
+    totalMs: roundMs(totalMs),
+    version: 1
+  };
+}

package/dist/health/health.d.ts

@@ -0,0 +1,18 @@
+import type { ModuleType } from '../types.js';
+export interface HealthStatus {
+    status: 'ok' | 'unavailable';
+}
+export interface HealthCheckResponse {
+    body: unknown;
+    statusCode?: number;
+}
+export interface ReadinessStatus {
+    status: 'ready' | 'starting' | 'unavailable';
+}
+export interface HealthModuleOptions {
+    healthCheck?: (ctx: import('@fluojs/http').RequestContext) => HealthStatus | HealthCheckResponse | Promise<HealthStatus | HealthCheckResponse>;
+    path?: string;
+}
+export type ReadinessCheck = () => boolean | Promise<boolean>;
+export declare function createHealthModule(options?: HealthModuleOptions): ModuleType;
+//# sourceMappingURL=health.d.ts.map

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

@@ -0,0 +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"}

package/dist/health/health.js

@@ -0,0 +1,82 @@
+function _applyDecs(e, t, n, r, o, i) { var a, c, u, s, f, l, p, d = Symbol.metadata || Symbol.for("Symbol.metadata"), m = Object.defineProperty, h = Object.create, y = [h(null), h(null)], v = t.length; function g(t, n, r) { return function (o, i) { n && (i = o, o = e); for (var a = 0; a < t.length; a++) i = t[a].apply(o, r ? [i] : []); return r ? i : o; }; } function b(e, t, n, r) { if ("function" != typeof e && (r || void 0 !== e)) throw new TypeError(t + " must " + (n || "be") + " a function" + (r ? "" : " or undefined")); return e; } function applyDec(e, t, n, r, o, i, u, s, f, l, p) { function d(e) { if (!p(e)) throw new TypeError("Attempted to access private element on non-instance"); } var h = [].concat(t[0]), v = t[3], w = !u, D = 1 === o, S = 3 === o, j = 4 === o, E = 2 === o; function I(t, n, r) { return function (o, i) { return n && (i = o, o = e), r && r(o), P[t].call(o, i); }; } if (!w) { var P = {}, k = [], F = S ? "get" : j || D ? "set" : "value"; if (f ? (l || D ? P = { get: _setFunctionName(function () { return v(this); }, r, "get"), set: function (e) { t[4](this, e); } } : P[F] = v, l || _setFunctionName(P[F], r, E ? "" : F)) : l || (P = Object.getOwnPropertyDescriptor(e, r)), !l && !f) { if ((c = y[+s][r]) && 7 !== (c ^ o)) throw Error("Decorating two elements with the same name (" + P[F].name + ") is not supported yet"); y[+s][r] = o < 3 ? 1 : o; } } for (var N = e, O = h.length - 1; O >= 0; O -= n ? 2 : 1) { var T = b(h[O], "A decorator", "be", !0), z = n ? h[O - 1] : void 0, A = {}, H = { kind: ["field", "accessor", "method", "getter", "setter", "class"][o], name: r, metadata: a, addInitializer: function (e, t) { if (e.v) throw new TypeError("attempted to call addInitializer after decoration was finished"); b(t, "An initializer", "be", !0), i.push(t); }.bind(null, A) }; if (w) c = T.call(z, N, H), A.v = 1, b(c, "class decorators", "return") && (N = c);else if (H.static = s, H.private = f, c = H.access = { has: f ? p.bind() : function (e) { return r in e; } }, j || (c.get = f ? E ? function (e) { return d(e), P.value; } : I("get", 0, d) : function (e) { return e[r]; }), E || S || (c.set = f ? I("set", 0, d) : function (e, t) { e[r] = t; }), N = T.call(z, D ? { get: P.get, set: P.set } : P[F], H), A.v = 1, D) { if ("object" == typeof N && N) (c = b(N.get, "accessor.get")) && (P.get = c), (c = b(N.set, "accessor.set")) && (P.set = c), (c = b(N.init, "accessor.init")) && k.unshift(c);else if (void 0 !== N) throw new TypeError("accessor decorators must return an object with get, set, or init properties or undefined"); } else b(N, (l ? "field" : "method") + " decorators", "return") && (l ? k.unshift(N) : P[F] = N); } return o < 2 && u.push(g(k, s, 1), g(i, s, 0)), l || w || (f ? D ? u.splice(-1, 0, I("get", s), I("set", s)) : u.push(E ? P[F] : b.call.bind(P[F])) : m(e, r, P)), N; } function w(e) { return m(e, d, { configurable: !0, enumerable: !0, value: a }); } return void 0 !== i && (a = i[d]), a = h(null == a ? null : a), f = [], l = function (e) { e && f.push(g(e)); }, p = function (t, r) { for (var i = 0; i < n.length; i++) { var a = n[i], c = a[1], l = 7 & c; if ((8 & c) == t && !l == r) { var p = a[2], d = !!a[3], m = 16 & c; applyDec(t ? e : e.prototype, a, m, d ? "#" + p : _toPropertyKey(p), l, l < 2 ? [] : t ? s = s || [] : u = u || [], f, !!t, d, r, t && d ? function (t) { return _checkInRHS(t) === e; } : o); } } }, p(8, 0), p(0, 0), p(8, 1), p(0, 1), l(u), l(s), c = f, v || w(e), { e: c, get c() { var n = []; return v && [w(e = applyDec(e, [t], r, e.name, 5, n)), g(n, 1)]; } }; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == typeof i ? i : i + ""; }
+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 { defineModule } from '../bootstrap.js';
+export function createHealthModule(options = {}) {
+  let _initProto, _initClass;
+  const basePath = options.path ?? '';
+  const readinessChecks = [];
+  let ready = false;
+  const resolveHealthResponse = async ctx => {
+    if (!options.healthCheck) {
+      return {
+        status: 'ok'
+      };
+    }
+    return options.healthCheck(ctx);
+  };
+  const isHealthCheckResponse = value => typeof value === 'object' && value !== null && 'body' in value;
+  let _HealthController;
+  class HealthController {
+    static {
+      ({
+        e: [_initProto],
+        c: [_HealthController, _initClass]
+      } = _applyDecs(this, [Controller(basePath)], [[Get('/health'), 2, "health"], [Get('/ready'), 2, "ready"]]));
+    }
+    constructor() {
+      _initProto(this);
+    }
+    async health(_input, ctx) {
+      const result = await resolveHealthResponse(ctx);
+      if (isHealthCheckResponse(result)) {
+        if (result.statusCode !== undefined) {
+          ctx.response.setStatus(result.statusCode);
+        }
+        return result.body;
+      }
+      return result;
+    }
+    async ready(_input, ctx) {
+      if (!ready) {
+        ctx.response.setStatus(503);
+        return {
+          status: 'starting'
+        };
+      }
+      for (const check of readinessChecks) {
+        const result = await check();
+        if (!result) {
+          ctx.response.setStatus(503);
+          return {
+            status: 'unavailable'
+          };
+        }
+      }
+      return {
+        status: 'ready'
+      };
+    }
+    static {
+      _initClass();
+    }
+  }
+  class HealthModule {
+    static addReadinessCheck(fn) {
+      readinessChecks.push(fn);
+    }
+    static markReady() {
+      ready = true;
+    }
+    static markStarting() {
+      ready = false;
+    }
+  }
+  defineModule(HealthModule, {
+    controllers: [_HealthController]
+  });
+  return HealthModule;
+}

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

@@ -0,0 +1,88 @@
+import { type CorsOptions, type HttpApplicationAdapter, type MiddlewareLike, type SecurityHeadersOptions } from '@fluojs/http';
+import type { Application, ApplicationLogger, CreateApplicationOptions, ModuleType } from './types.js';
+/**
+ * Input type for configuring CORS in an HTTP adapter.
+ */
+export type HttpAdapterCorsInput = false | string | string[] | CorsOptions;
+/**
+ * Resolved target for an HTTP server listener.
+ */
+export interface HttpAdapterListenTarget {
+    /** The local address or host the server is bound to. */
+    bindTarget: string;
+    /** The public URL of the running server. */
+    url: string;
+}
+/**
+ * Common middleware options for HTTP adapters.
+ */
+export interface HttpAdapterMiddlewareOptions {
+    /** CORS configuration for the adapter. */
+    cors?: HttpAdapterCorsInput;
+    /** Global prefix applied to all routes. */
+    globalPrefix?: string;
+    /** List of route patterns to exclude from the global prefix. */
+    globalPrefixExclude?: readonly string[];
+    /** Custom middleware to inject into the adapter pipeline. */
+    middleware?: MiddlewareLike[];
+    /** Security header configuration. */
+    securityHeaders?: false | SecurityHeadersOptions;
+}
+/**
+ * Options for bootstrapping an HTTP adapter application.
+ */
+export interface BootstrapHttpAdapterApplicationOptions extends Omit<CreateApplicationOptions, 'adapter' | 'logger' | 'middleware'>, HttpAdapterMiddlewareOptions {
+    /** Optional custom application logger. */
+    logger?: ApplicationLogger;
+}
+/**
+ * Options for running an HTTP adapter application with shutdown management.
+ */
+export interface RunHttpAdapterApplicationOptions extends BootstrapHttpAdapterApplicationOptions {
+    /** Timeout for marking shutdown as failed during signal-driven teardown in milliseconds. */
+    forceExitTimeoutMs?: number;
+    /** Custom shutdown registration logic. */
+    shutdownRegistration?: HttpAdapterShutdownRegistration;
+}
+/**
+ * Function type for registering custom application shutdown logic.
+ */
+export type HttpAdapterShutdownRegistration = (app: Application, logger: ApplicationLogger, forceExitTimeoutMs?: number) => void | (() => void);
+type ManagedHttpApplicationAdapter = HttpApplicationAdapter & {
+    getListenTarget(): HttpAdapterListenTarget;
+};
+/**
+ * Bootstraps an HTTP application with the provided adapter and options.
+ *
+ * @param rootModule The root application module class.
+ * @param options Bootstrap configuration for middleware and logging.
+ * @param adapter The HTTP platform adapter to use.
+ * @returns A promise that resolves to the initialized application instance.
+ */
+export declare function bootstrapHttpAdapterApplication(rootModule: ModuleType, options: BootstrapHttpAdapterApplicationOptions, adapter: HttpApplicationAdapter): Promise<Application>;
+/**
+ * Resolves the final middleware chain for an HTTP adapter based on options.
+ *
+ * @param options Middleware configuration including CORS and prefix settings.
+ * @returns An array of middleware instances to be registered in the adapter.
+ */
+export declare function createHttpAdapterMiddleware(options: HttpAdapterMiddlewareOptions): MiddlewareLike[];
+/**
+ * Formats a log message indicating that the HTTP adapter is listening on a specific target.
+ *
+ * @param target - The listen target containing the URL and bind target.
+ * @returns A formatted string message.
+ */
+export declare function formatHttpAdapterListenMessage(target: HttpAdapterListenTarget): string;
+/**
+ * Boots and runs an HTTP application using the provided adapter and options,
+ * including setup for shutdown management and logging.
+ *
+ * @param rootModule - The root application module class.
+ * @param options - Run configuration including shutdown and logging settings.
+ * @param adapter - The managed HTTP platform adapter to use.
+ * @returns A promise that resolves to the running application instance.
+ */
+export declare function runHttpAdapterApplication(rootModule: ModuleType, options: RunHttpAdapterApplicationOptions, adapter: ManagedHttpApplicationAdapter): Promise<Application>;
+export {};
+//# sourceMappingURL=http-adapter-shared.d.ts.map

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

@@ -0,0 +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"}