@c9up/ream 0.1.3

package/dist/ConfigLoader.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Configuration loader — reads config/*.ts + .env files.
+ *
+ * @implements FR18, FR19
+ */
+/**
+ * In-memory config store. In production this is populated from config/*.ts
+ * files via `defineConfig()`. The class is its own contract — `AppContext.config`
+ * is typed against it directly (structural).
+ */
+export declare class ConfigStore {
+    private store;
+    get<T = unknown>(key: string): T | undefined;
+    set(key: string, value: unknown): void;
+    has(key: string): boolean;
+    /** Load config from an object (used for testing and initial setup). */
+    loadFromObject(config: Record<string, unknown>): void;
+}
+/**
+ * Read an environment variable with optional default.
+ * @implements FR19
+ */
+export declare function env(key: string, defaultValue?: string): string | undefined;
+/**
+ * Define typed configuration for a module.
+ * Returns the config object as-is (type-checked by the module's defineConfig).
+ */
+export declare function defineModuleConfig<T>(config: T): T;
+//# sourceMappingURL=ConfigLoader.d.ts.map

package/dist/ConfigLoader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConfigLoader.d.ts","sourceRoot":"","sources":["../src/ConfigLoader.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;GAIG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,KAAK,CAAkC;IAE/C,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAI5C,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI;IAItC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIzB,uEAAuE;IACvE,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;CAKtD;AAED;;;GAGG;AACH,wBAAgB,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAE1E;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,CAElD"}

package/dist/ConfigLoader.js

@@ -0,0 +1,43 @@
+/**
+ * Configuration loader — reads config/*.ts + .env files.
+ *
+ * @implements FR18, FR19
+ */
+/**
+ * In-memory config store. In production this is populated from config/*.ts
+ * files via `defineConfig()`. The class is its own contract — `AppContext.config`
+ * is typed against it directly (structural).
+ */
+export class ConfigStore {
+    store = new Map();
+    get(key) {
+        return this.store.get(key);
+    }
+    set(key, value) {
+        this.store.set(key, value);
+    }
+    has(key) {
+        return this.store.has(key);
+    }
+    /** Load config from an object (used for testing and initial setup). */
+    loadFromObject(config) {
+        for (const [key, value] of Object.entries(config)) {
+            this.store.set(key, value);
+        }
+    }
+}
+/**
+ * Read an environment variable with optional default.
+ * @implements FR19
+ */
+export function env(key, defaultValue) {
+    return process.env[key] ?? defaultValue;
+}
+/**
+ * Define typed configuration for a module.
+ * Returns the config object as-is (type-checked by the module's defineConfig).
+ */
+export function defineModuleConfig(config) {
+    return config;
+}
+//# sourceMappingURL=ConfigLoader.js.map

package/dist/ConfigLoader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConfigLoader.js","sourceRoot":"","sources":["../src/ConfigLoader.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;GAIG;AACH,MAAM,OAAO,WAAW;IACd,KAAK,GAAyB,IAAI,GAAG,EAAE,CAAA;IAE/C,GAAG,CAAc,GAAW;QAC1B,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAkB,CAAA;IAC7C,CAAC;IAED,GAAG,CAAC,GAAW,EAAE,KAAc;QAC7B,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;IAC5B,CAAC;IAED,GAAG,CAAC,GAAW;QACb,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;IAC5B,CAAC;IAED,uEAAuE;IACvE,cAAc,CAAC,MAA+B;QAC5C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAClD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;QAC5B,CAAC;IACH,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,UAAU,GAAG,CAAC,GAAW,EAAE,YAAqB;IACpD,OAAO,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,YAAY,CAAA;AACzC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAI,MAAS;IAC7C,OAAO,MAAM,CAAA;AACf,CAAC"}

package/dist/ErrorBoundary.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Root Error Boundary — all errors flow through the bus.
+ *
+ * @implements Story 4.8
+ *
+ * Catches all uncaught errors and emits them as event-bus events:
+ * - service.error — handler/business logic failures
+ * - security.rejected — Blackhole rejections
+ * - system.error — infrastructure failures (NAPI, DB)
+ * - system.fatal — unrecoverable process-level errors
+ */
+export type ErrorSeverity = 'info' | 'warning' | 'critical';
+export interface ErrorEvent {
+    type: 'service.error' | 'security.rejected' | 'system.error' | 'system.fatal' | 'system.info';
+    source: string;
+    message: string;
+    severity: ErrorSeverity;
+    correlationId?: string;
+    originalError?: string;
+    timestamp: string;
+}
+export type ErrorEmitter = (event: ErrorEvent) => void;
+/**
+ * Root Error Boundary.
+ *
+ * Wraps the entire application lifecycle:
+ * - Catches unhandledRejection and uncaughtException
+ * - Emits structured error events via the provided emitter (event bus)
+ * - In dev mode, also logs to console
+ */
+export declare class ErrorBoundary {
+    private emitter;
+    private devMode;
+    private installed;
+    private rejectionHandler?;
+    private exceptionHandler?;
+    constructor(emitter: ErrorEmitter, devMode?: boolean);
+    /** Install global error handlers. */
+    install(): void;
+    /** Uninstall global error handlers (for testing). Only removes OUR handlers. */
+    uninstall(): void;
+    /** Emit a service error (handler failure). */
+    serviceError(source: string, error: unknown, correlationId?: string): void;
+    /** Emit a security rejection. */
+    securityRejected(source: string, reason: string, correlationId?: string): void;
+    /** Emit a system error (infrastructure failure). */
+    systemError(source: string, error: unknown, correlationId?: string): void;
+    private handleError;
+    private emit;
+}
+//# sourceMappingURL=ErrorBoundary.d.ts.map

package/dist/ErrorBoundary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ErrorBoundary.d.ts","sourceRoot":"","sources":["../src/ErrorBoundary.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,SAAS,GAAG,UAAU,CAAA;AAE3D,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,eAAe,GAAG,mBAAmB,GAAG,cAAc,GAAG,cAAc,GAAG,aAAa,CAAA;IAC7F,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,aAAa,CAAA;IACvB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,MAAM,YAAY,GAAG,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAA;AAEtD;;;;;;;GAOG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,OAAO,CAAc;IAC7B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,SAAS,CAAQ;IACzB,OAAO,CAAC,gBAAgB,CAAC,CAA2B;IACpD,OAAO,CAAC,gBAAgB,CAAC,CAAwB;gBAErC,OAAO,EAAE,YAAY,EAAE,OAAO,UAAQ;IAKlD,qCAAqC;IACrC,OAAO,IAAI,IAAI;IA8Bf,gFAAgF;IAChF,SAAS,IAAI,IAAI;IAYjB,8CAA8C;IAC9C,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI;IAI1E,iCAAiC;IACjC,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI;IAY9E,oDAAoD;IACpD,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI;IAIzE,OAAO,CAAC,WAAW;IAuBnB,OAAO,CAAC,IAAI;CAoBb"}

package/dist/ErrorBoundary.js

@@ -0,0 +1,122 @@
+/**
+ * Root Error Boundary — all errors flow through the bus.
+ *
+ * @implements Story 4.8
+ *
+ * Catches all uncaught errors and emits them as event-bus events:
+ * - service.error — handler/business logic failures
+ * - security.rejected — Blackhole rejections
+ * - system.error — infrastructure failures (NAPI, DB)
+ * - system.fatal — unrecoverable process-level errors
+ */
+/**
+ * Root Error Boundary.
+ *
+ * Wraps the entire application lifecycle:
+ * - Catches unhandledRejection and uncaughtException
+ * - Emits structured error events via the provided emitter (event bus)
+ * - In dev mode, also logs to console
+ */
+export class ErrorBoundary {
+    emitter;
+    devMode;
+    installed = false;
+    rejectionHandler;
+    exceptionHandler;
+    constructor(emitter, devMode = false) {
+        this.emitter = emitter;
+        this.devMode = devMode;
+    }
+    /** Install global error handlers. */
+    install() {
+        if (this.installed)
+            return;
+        // Skip global install under vitest — each test instantiates its own
+        // Ignitor and rarely calls `.stop()`, so per-test listeners pile up on
+        // the singleton `process` and trigger Node's MaxListenersExceeded
+        // warning. Production code-paths still get coverage via direct
+        // `handleError`/`serviceError` calls; only the Node-level signal
+        // bridging is suppressed.
+        if (process.env.VITEST === 'true' || process.env.NODE_ENV === 'test') {
+            this.installed = true;
+            return;
+        }
+        this.rejectionHandler = (reason) => {
+            this.handleError('system.fatal', 'UnhandledRejection', reason);
+        };
+        this.exceptionHandler = (error) => {
+            this.handleError('system.fatal', 'UncaughtException', error);
+            // Node.js is in undefined state after uncaughtException — must exit
+            process.exit(1);
+        };
+        process.on('unhandledRejection', this.rejectionHandler);
+        process.on('uncaughtException', this.exceptionHandler);
+        this.installed = true;
+    }
+    /** Uninstall global error handlers (for testing). Only removes OUR handlers. */
+    uninstall() {
+        if (this.rejectionHandler) {
+            process.removeListener('unhandledRejection', this.rejectionHandler);
+        }
+        if (this.exceptionHandler) {
+            process.removeListener('uncaughtException', this.exceptionHandler);
+        }
+        this.rejectionHandler = undefined;
+        this.exceptionHandler = undefined;
+        this.installed = false;
+    }
+    /** Emit a service error (handler failure). */
+    serviceError(source, error, correlationId) {
+        this.handleError('service.error', source, error, correlationId);
+    }
+    /** Emit a security rejection. */
+    securityRejected(source, reason, correlationId) {
+        const event = {
+            type: 'security.rejected',
+            source,
+            message: reason,
+            severity: 'warning',
+            correlationId,
+            timestamp: new Date().toISOString(),
+        };
+        this.emit(event);
+    }
+    /** Emit a system error (infrastructure failure). */
+    systemError(source, error, correlationId) {
+        this.handleError('system.error', source, error, correlationId);
+    }
+    handleError(type, source, error, correlationId) {
+        const message = error instanceof Error ? error.message : String(error);
+        const stack = error instanceof Error ? error.stack : undefined;
+        const event = {
+            type,
+            source,
+            message,
+            severity: type === 'system.fatal' ? 'critical' : type === 'system.error' ? 'critical' : 'warning',
+            correlationId,
+            originalError: stack ?? message,
+            timestamp: new Date().toISOString(),
+        };
+        this.emit(event);
+    }
+    emit(event) {
+        try {
+            this.emitter(event);
+        }
+        catch {
+            // If the emitter itself fails, log to stderr as last resort
+            process.stderr.write(`[ErrorBoundary] Failed to emit: ${JSON.stringify(event)}\n`);
+        }
+        if (this.devMode) {
+            const prefix = event.type === 'system.fatal'
+                ? '✗ FATAL'
+                : event.type === 'system.error'
+                    ? '✗ ERROR'
+                    : event.type === 'security.rejected'
+                        ? '⚠ SECURITY'
+                        : '✗ SERVICE';
+            process.stderr.write(`${prefix} [${event.source}] ${event.message}\n`);
+        }
+    }
+}
+//# sourceMappingURL=ErrorBoundary.js.map

package/dist/ErrorBoundary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ErrorBoundary.js","sourceRoot":"","sources":["../src/ErrorBoundary.ts"],"names":[],"mappings":"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"}

package/dist/GracefulShutdown.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Graceful Shutdown — handles SIGTERM/SIGINT with drain timeout.
+ *
+ * @implements FR82
+ */
+export interface ShutdownOptions {
+    /** Maximum time to wait for drain in ms (default: 30000). */
+    drainTimeout?: number;
+    /** Callback to execute during shutdown. */
+    onShutdown: () => Promise<void>;
+    /** Optional logger. */
+    logger?: {
+        info: (msg: string) => void;
+        error: (msg: string) => void;
+    };
+}
+export interface ShutdownHandle {
+    /** Manually trigger shutdown (for testing). */
+    trigger: () => Promise<void>;
+    /** Remove signal listeners (for testing cleanup). */
+    cleanup: () => void;
+}
+/**
+ * Install graceful shutdown handlers for SIGTERM and SIGINT.
+ * Returns a handle to manually trigger shutdown or clean up listeners.
+ */
+export declare function installGracefulShutdown(options: ShutdownOptions): ShutdownHandle;
+//# sourceMappingURL=GracefulShutdown.d.ts.map

package/dist/GracefulShutdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GracefulShutdown.d.ts","sourceRoot":"","sources":["../src/GracefulShutdown.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,eAAe;IAC9B,6DAA6D;IAC7D,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,2CAA2C;IAC3C,UAAU,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IAC/B,uBAAuB;IACvB,MAAM,CAAC,EAAE;QAAE,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;QAAC,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;KAAE,CAAA;CACvE;AAED,MAAM,WAAW,cAAc;IAC7B,+CAA+C;IAC/C,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IAC5B,qDAAqD;IACrD,OAAO,EAAE,MAAM,IAAI,CAAA;CACpB;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,eAAe,GAAG,cAAc,CAqDhF"}

package/dist/GracefulShutdown.js

@@ -0,0 +1,55 @@
+/**
+ * Graceful Shutdown — handles SIGTERM/SIGINT with drain timeout.
+ *
+ * @implements FR82
+ */
+/**
+ * Install graceful shutdown handlers for SIGTERM and SIGINT.
+ * Returns a handle to manually trigger shutdown or clean up listeners.
+ */
+export function installGracefulShutdown(options) {
+    const drainTimeout = options.drainTimeout ?? 30_000;
+    const logger = options.logger ?? { info: () => { }, error: () => { } };
+    let shutdownInProgress = false;
+    const shutdown = async () => {
+        if (shutdownInProgress)
+            return;
+        shutdownInProgress = true;
+        logger.info('Graceful shutdown initiated...');
+        let timeoutHandle;
+        const drainPromise = options.onShutdown().catch((err) => {
+            logger.error(`Shutdown error: ${err instanceof Error ? err.message : String(err)}`);
+        });
+        const timeoutPromise = new Promise((resolve) => {
+            timeoutHandle = setTimeout(() => {
+                logger.error(`Drain timeout exceeded (${drainTimeout}ms) — forcing shutdown`);
+                resolve();
+            }, drainTimeout);
+        });
+        await Promise.race([drainPromise, timeoutPromise]);
+        if (timeoutHandle)
+            clearTimeout(timeoutHandle);
+        logger.info('Shutdown complete');
+        process.exit(0);
+    };
+    const onSigterm = () => {
+        shutdown().catch((err) => {
+            logger.error(`Fatal: ${err}`);
+            process.exit(1);
+        });
+    };
+    const onSigint = () => {
+        shutdown().catch((err) => {
+            logger.error(`Fatal: ${err}`);
+            process.exit(1);
+        });
+    };
+    process.on('SIGTERM', onSigterm);
+    process.on('SIGINT', onSigint);
+    const cleanup = () => {
+        process.off('SIGTERM', onSigterm);
+        process.off('SIGINT', onSigint);
+    };
+    return { trigger: shutdown, cleanup };
+}
+//# sourceMappingURL=GracefulShutdown.js.map

package/dist/GracefulShutdown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GracefulShutdown.js","sourceRoot":"","sources":["../src/GracefulShutdown.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAkBH;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CAAC,OAAwB;IAC9D,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,MAAM,CAAA;IACnD,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,GAAE,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,GAAE,CAAC,EAAE,CAAA;IACpE,IAAI,kBAAkB,GAAG,KAAK,CAAA;IAE9B,MAAM,QAAQ,GAAG,KAAK,IAAI,EAAE;QAC1B,IAAI,kBAAkB;YAAE,OAAM;QAC9B,kBAAkB,GAAG,IAAI,CAAA;QAEzB,MAAM,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAA;QAE7C,IAAI,aAAwD,CAAA;QAE5D,MAAM,YAAY,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;YACtD,MAAM,CAAC,KAAK,CAAC,mBAAmB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;QACrF,CAAC,CAAC,CAAA;QAEF,MAAM,cAAc,GAAG,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YACnD,aAAa,GAAG,UAAU,CAAC,GAAG,EAAE;gBAC9B,MAAM,CAAC,KAAK,CAAC,2BAA2B,YAAY,wBAAwB,CAAC,CAAA;gBAC7E,OAAO,EAAE,CAAA;YACX,CAAC,EAAE,YAAY,CAAC,CAAA;QAClB,CAAC,CAAC,CAAA;QAEF,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,YAAY,EAAE,cAAc,CAAC,CAAC,CAAA;QAClD,IAAI,aAAa;YAAE,YAAY,CAAC,aAAa,CAAC,CAAA;QAE9C,MAAM,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAA;QAChC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACjB,CAAC,CAAA;IAED,MAAM,SAAS,GAAG,GAAG,EAAE;QACrB,QAAQ,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;YACvB,MAAM,CAAC,KAAK,CAAC,UAAU,GAAG,EAAE,CAAC,CAAA;YAC7B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QACjB,CAAC,CAAC,CAAA;IACJ,CAAC,CAAA;IACD,MAAM,QAAQ,GAAG,GAAG,EAAE;QACpB,QAAQ,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;YACvB,MAAM,CAAC,KAAK,CAAC,UAAU,GAAG,EAAE,CAAC,CAAA;YAC7B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QACjB,CAAC,CAAC,CAAA;IACJ,CAAC,CAAA;IAED,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,SAAS,CAAC,CAAA;IAChC,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAA;IAE9B,MAAM,OAAO,GAAG,GAAG,EAAE;QACnB,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,SAAS,CAAC,CAAA;QACjC,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAA;IACjC,CAAC,CAAA;IAED,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAA;AACvC,CAAC"}

package/dist/HealthCheck.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Health Check — built-in /health endpoint compatible with Kubernetes liveness/readiness probes.
+ *
+ * @implements FR81
+ */
+export interface HealthStatus {
+    status: 'ok' | 'degraded' | 'error';
+    uptime: number;
+    timestamp: string;
+    checks: HealthCheckResult[];
+}
+export interface HealthCheckResult {
+    name: string;
+    status: 'ok' | 'warn' | 'error';
+    message?: string;
+    latency?: number;
+}
+export type HealthChecker = () => Promise<HealthCheckResult> | HealthCheckResult;
+/**
+ * Manages health check registrations and produces aggregated status.
+ */
+export declare class HealthCheck {
+    private checkers;
+    private startTime;
+    private checkTimeout;
+    constructor(options?: {
+        checkTimeout?: number;
+    });
+    /** Register a health checker. */
+    register(name: string, checker: HealthChecker): void;
+    /** Run all health checks and return aggregated status. */
+    check(): Promise<HealthStatus>;
+    /** Create the /health route handler. Returns 200 for ok, 503 for degraded/error. */
+    handler(): (ctx: {
+        response: {
+            status: number;
+            headers: Record<string, string>;
+            body: string;
+        };
+    }) => Promise<void>;
+}
+//# sourceMappingURL=HealthCheck.d.ts.map

package/dist/HealthCheck.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HealthCheck.d.ts","sourceRoot":"","sources":["../src/HealthCheck.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,IAAI,GAAG,UAAU,GAAG,OAAO,CAAA;IACnC,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,iBAAiB,EAAE,CAAA;CAC5B;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,IAAI,GAAG,MAAM,GAAG,OAAO,CAAA;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,MAAM,aAAa,GAAG,MAAM,OAAO,CAAC,iBAAiB,CAAC,GAAG,iBAAiB,CAAA;AAKhF;;GAEG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAwC;IACxD,OAAO,CAAC,SAAS,CAAa;IAC9B,OAAO,CAAC,YAAY,CAAQ;gBAEhB,OAAO,CAAC,EAAE;QAAE,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE;IAI/C,iCAAiC;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,IAAI;IAIpD,0DAA0D;IACpD,KAAK,IAAI,OAAO,CAAC,YAAY,CAAC;IAyCpC,oFAAoF;IACpF,OAAO,IAAI,CAAC,GAAG,EAAE;QACf,QAAQ,EAAE;YAAE,MAAM,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAA;KAC5E,KAAK,OAAO,CAAC,IAAI,CAAC;CAQpB"}

package/dist/HealthCheck.js

@@ -0,0 +1,65 @@
+/**
+ * Health Check — built-in /health endpoint compatible with Kubernetes liveness/readiness probes.
+ *
+ * @implements FR81
+ */
+/** Default per-checker timeout in ms. */
+const DEFAULT_CHECK_TIMEOUT = 5000;
+/**
+ * Manages health check registrations and produces aggregated status.
+ */
+export class HealthCheck {
+    checkers = new Map();
+    startTime = Date.now();
+    checkTimeout;
+    constructor(options) {
+        this.checkTimeout = options?.checkTimeout ?? DEFAULT_CHECK_TIMEOUT;
+    }
+    /** Register a health checker. */
+    register(name, checker) {
+        this.checkers.set(name, checker);
+    }
+    /** Run all health checks and return aggregated status. */
+    async check() {
+        const checks = [];
+        for (const [name, checker] of this.checkers) {
+            const start = Date.now();
+            try {
+                const result = await Promise.race([
+                    Promise.resolve(checker()),
+                    new Promise((_, reject) => setTimeout(() => reject(new Error(`Health check '${name}' timed out after ${this.checkTimeout}ms`)), this.checkTimeout)),
+                ]);
+                // Enforce authoritative name from registration key
+                result.name = name;
+                result.latency = Date.now() - start;
+                checks.push(result);
+            }
+            catch (err) {
+                checks.push({
+                    name,
+                    status: 'error',
+                    message: err instanceof Error ? err.message : String(err),
+                    latency: Date.now() - start,
+                });
+            }
+        }
+        const hasError = checks.some((c) => c.status === 'error');
+        const hasWarn = checks.some((c) => c.status === 'warn');
+        return {
+            status: hasError ? 'error' : hasWarn ? 'degraded' : 'ok',
+            uptime: Math.floor((Date.now() - this.startTime) / 1000),
+            timestamp: new Date().toISOString(),
+            checks,
+        };
+    }
+    /** Create the /health route handler. Returns 200 for ok, 503 for degraded/error. */
+    handler() {
+        return async (ctx) => {
+            const health = await this.check();
+            ctx.response.status = health.status === 'ok' ? 200 : 503;
+            ctx.response.headers['content-type'] = 'application/json';
+            ctx.response.body = JSON.stringify(health);
+        };
+    }
+}
+//# sourceMappingURL=HealthCheck.js.map

package/dist/HealthCheck.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HealthCheck.js","sourceRoot":"","sources":["../src/HealthCheck.ts"],"names":[],"mappings":"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"}

package/dist/HotReload.d.ts

@@ -0,0 +1,28 @@
+/**
+ * HotReload — re-registers routes and middleware when TS files change.
+ *
+ * The Hyper server (Rust) stays alive. Only the TypeScript handlers are swapped.
+ * This gives sub-100ms reload times since no Rust recompilation is needed.
+ *
+ * @implements FR75, FR76
+ */
+export interface HotReloadOptions {
+    /** Directories to watch for changes. */
+    watchDirs: string[];
+    /** File extensions to watch (default: ['.ts', '.js']). */
+    extensions?: string[];
+    /** Callback to execute on reload. */
+    onReload: () => Promise<void> | void;
+    /** Debounce delay in ms (default: 50). */
+    debounce?: number;
+    /** Logger (optional). */
+    logger?: {
+        info: (msg: string) => void;
+    };
+}
+/**
+ * Watch TypeScript files and trigger handler re-registration on changes.
+ * Returns a cleanup function to stop watching.
+ */
+export declare function startHotReload(options: HotReloadOptions): () => void;
+//# sourceMappingURL=HotReload.d.ts.map

package/dist/HotReload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HotReload.d.ts","sourceRoot":"","sources":["../src/HotReload.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,MAAM,WAAW,gBAAgB;IAC/B,wCAAwC;IACxC,SAAS,EAAE,MAAM,EAAE,CAAA;IACnB,0DAA0D;IAC1D,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;IACrB,qCAAqC;IACrC,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;IACpC,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,yBAAyB;IACzB,MAAM,CAAC,EAAE;QAAE,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;KAAE,CAAA;CACzC;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,gBAAgB,GAAG,MAAM,IAAI,CAgDpE"}

package/dist/HotReload.js

@@ -0,0 +1,60 @@
+/**
+ * HotReload — re-registers routes and middleware when TS files change.
+ *
+ * The Hyper server (Rust) stays alive. Only the TypeScript handlers are swapped.
+ * This gives sub-100ms reload times since no Rust recompilation is needed.
+ *
+ * @implements FR75, FR76
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+/**
+ * Watch TypeScript files and trigger handler re-registration on changes.
+ * Returns a cleanup function to stop watching.
+ */
+export function startHotReload(options) {
+    const extensions = options.extensions ?? ['.ts', '.js'];
+    const debounceMs = options.debounce ?? 50;
+    const logger = options.logger ?? { info: () => { } };
+    let debounceTimer;
+    const watchers = [];
+    const handleChange = (filename) => {
+        if (!filename || !extensions.some((ext) => filename.endsWith(ext)))
+            return;
+        if (debounceTimer)
+            clearTimeout(debounceTimer);
+        debounceTimer = setTimeout(async () => {
+            const start = Date.now();
+            try {
+                await options.onReload();
+                const duration = Date.now() - start;
+                logger.info(`Hot reload: ${duration}ms`);
+            }
+            catch (err) {
+                logger.info(`Hot reload failed: ${err instanceof Error ? err.message : String(err)}`);
+            }
+        }, debounceMs);
+    };
+    for (const dir of options.watchDirs) {
+        const resolved = path.resolve(dir);
+        if (!fs.existsSync(resolved))
+            continue;
+        try {
+            const watcher = fs.watch(resolved, { recursive: true }, (_event, filename) => {
+                handleChange(filename);
+            });
+            watchers.push(watcher);
+        }
+        catch {
+            // fs.watch with recursive may not be supported on all platforms
+        }
+    }
+    logger.info(`Hot reload watching: ${options.watchDirs.join(', ')}`);
+    return () => {
+        if (debounceTimer)
+            clearTimeout(debounceTimer);
+        for (const w of watchers)
+            w.close();
+    };
+}
+//# sourceMappingURL=HotReload.js.map

package/dist/HotReload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HotReload.js","sourceRoot":"","sources":["../src/HotReload.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAA;AAC7B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA;AAejC;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,OAAyB;IACtD,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,CAAC,KAAK,EAAE,KAAK,CAAC,CAAA;IACvD,MAAM,UAAU,GAAG,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAA;IACzC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,GAAE,CAAC,EAAE,CAAA;IAEnD,IAAI,aAAwD,CAAA;IAC5D,MAAM,QAAQ,GAAmB,EAAE,CAAA;IAEnC,MAAM,YAAY,GAAG,CAAC,QAAuB,EAAE,EAAE;QAC/C,IAAI,CAAC,QAAQ,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;YAAE,OAAM;QAE1E,IAAI,aAAa;YAAE,YAAY,CAAC,aAAa,CAAC,CAAA;QAC9C,aAAa,GAAG,UAAU,CAAC,KAAK,IAAI,EAAE;YACpC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;YACxB,IAAI,CAAC;gBACH,MAAM,OAAO,CAAC,QAAQ,EAAE,CAAA;gBACxB,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAA;gBACnC,MAAM,CAAC,IAAI,CAAC,eAAe,QAAQ,IAAI,CAAC,CAAA;YAC1C,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,CAAC,IAAI,CAAC,sBAAsB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;YACvF,CAAC;QACH,CAAC,EAAE,UAAU,CAAC,CAAA;IAChB,CAAC,CAAA;IAED,KAAK,MAAM,GAAG,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;QACpC,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;QAClC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC;YAAE,SAAQ;QAEtC,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,EAAE,CAAC,KAAK,CACtB,QAAQ,EACR,EAAE,SAAS,EAAE,IAAI,EAAE,EACnB,CAAC,MAAc,EAAE,QAAuB,EAAE,EAAE;gBAC1C,YAAY,CAAC,QAAQ,CAAC,CAAA;YACxB,CAAC,CACF,CAAA;YACD,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QACxB,CAAC;QAAC,MAAM,CAAC;YACP,gEAAgE;QAClE,CAAC;IACH,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,wBAAwB,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IAEnE,OAAO,GAAG,EAAE;QACV,IAAI,aAAa;YAAE,YAAY,CAAC,aAAa,CAAC,CAAA;QAC9C,KAAK,MAAM,CAAC,IAAI,QAAQ;YAAE,CAAC,CAAC,KAAK,EAAE,CAAA;IACrC,CAAC,CAAA;AACH,CAAC"}

package/dist/HttpKernel.d.ts

@@ -0,0 +1,62 @@
+/**
+ * HttpKernel — bridges HyperServer NAPI with Router + Middleware Pipeline + ExceptionHandler.
+ *
+ * Request flow (like AdonisJS):
+ * 1. Parse JSON from Rust NAPI
+ * 2. Create HttpContext
+ * 3. Onion pipeline: Server MW → Router MW → Route MW → Guards → Handler
+ * 4. ExceptionHandler for any errors
+ *
+ * @implements FR21, FR22, FR23, FR24
+ */
+import type { Container } from './container/Container.js';
+import { ExceptionHandler } from './http/Exception.js';
+import { HttpContext } from './http/HttpContext.js';
+import type { MiddlewareFunction, MiddlewareRegistry } from './middleware/Pipeline.js';
+import type { Router } from './router/Router.js';
+import type { Dict } from './types/helpers.js';
+export interface HttpKernelConfig {
+    router: Router;
+    middleware: MiddlewareRegistry;
+    container?: Container;
+    exceptionHandler?: ExceptionHandler;
+    serverMiddleware?: MiddlewareFunction[];
+    routerMiddleware?: MiddlewareFunction[];
+    onError?: (error: unknown, ctx: HttpContext) => void;
+    debug?: boolean;
+    /**
+     * Lazily-resolved streaming backend. The Ignitor wires this so that
+     * `ctx.response.sse()` can register / push / close streams against the
+     * Rust HyperServer registry. Returning `undefined` short-circuits the
+     * SSE path with a clean error — used by mock servers in unit tests.
+     */
+    streamBackend?: () => import('./http/SseStream.js').StreamBackend | undefined;
+}
+export interface HttpKernelResponse {
+    status: number;
+    headers: Dict;
+    body: string;
+    /**
+     * Streaming-response handle. Present when the route handler opened
+     * an `SseStream` (`response.sse()`). The HyperServer NAPI matches
+     * this id against its stream registry to keep the connection open
+     * and feed the body from JS-pushed chunks.
+     */
+    streamId?: string;
+}
+/**
+ * Shape the kernel expects when called with an already-parsed object — the
+ * NAPI bridge passes this directly to skip a JSON round-trip. The string
+ * form is the legacy entrypoint kept for serverless / fixture use.
+ */
+export interface HttpKernelRequest {
+    method: string;
+    path: string;
+    query: string;
+    headers: Dict;
+    body: string;
+    bodyEncoding?: 'utf8' | 'base64';
+    remoteAddr?: string;
+}
+export declare function createHttpKernel(config: HttpKernelConfig): (request: HttpKernelRequest) => Promise<HttpKernelResponse>;
+//# sourceMappingURL=HttpKernel.d.ts.map

package/dist/HttpKernel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HttpKernel.d.ts","sourceRoot":"","sources":["../src/HttpKernel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAA;AAEzD,OAAO,EAAqB,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AACzE,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AACnD,OAAO,KAAK,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAA;AAEtF,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAA;AAChD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAA;AAE9C,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,EAAE,kBAAkB,CAAA;IAC9B,SAAS,CAAC,EAAE,SAAS,CAAA;IACrB,gBAAgB,CAAC,EAAE,gBAAgB,CAAA;IACnC,gBAAgB,CAAC,EAAE,kBAAkB,EAAE,CAAA;IACvC,gBAAgB,CAAC,EAAE,kBAAkB,EAAE,CAAA;IACvC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,WAAW,KAAK,IAAI,CAAA;IACpD,KAAK,CAAC,EAAE,OAAO,CAAA;IACf;;;;;OAKG;IACH,aAAa,CAAC,EAAE,MAAM,OAAO,qBAAqB,EAAE,aAAa,GAAG,SAAS,CAAA;CAC9E;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,IAAI,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,IAAI,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,YAAY,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAA;IAChC,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,gBAAgB,GACvB,CAAC,OAAO,EAAE,iBAAiB,KAAK,OAAO,CAAC,kBAAkB,CAAC,CAyL7D"}