@cleocode/lafs 2026.4.0 → 2026.4.4

package/dist/src/native-loader.js

@@ -0,0 +1,56 @@
+/**
+ * Native addon loader for lafs-core schema validation via napi-rs.
+ *
+ * @remarks
+ * Loads the napi-rs native addon synchronously on first use. Falls back
+ * gracefully if the native addon is not available (e.g., unsupported platform,
+ * Rust toolchain not installed). When unavailable, the AJV-based validator
+ * in `validateEnvelope.ts` is used instead.
+ *
+ * Follows the same pattern as `packages/cant/src/native-loader.ts`.
+ */
+import { createRequire } from 'node:module';
+let nativeModule = null;
+let loadAttempted = false;
+/**
+ * Attempt to load the native addon. Called lazily on first use.
+ * Native addons load synchronously via require() — no async init needed.
+ */
+function ensureLoaded() {
+    if (loadAttempted)
+        return;
+    loadAttempted = true;
+    const req = createRequire(import.meta.url);
+    try {
+        nativeModule = req('@cleocode/lafs-native');
+    }
+    catch {
+        try {
+            // Development fallback: try loading from the crate build output
+            nativeModule = req('../../crates/lafs-napi/index.cjs');
+        }
+        catch {
+            // Native addon not available — AJV fallback will be used
+            nativeModule = null;
+        }
+    }
+}
+/**
+ * Check if the native addon is available.
+ *
+ * @returns `true` if the native Rust binding was loaded successfully.
+ */
+export function isNativeAvailable() {
+    ensureLoaded();
+    return nativeModule !== null;
+}
+/**
+ * Get the native module, or `null` if unavailable.
+ *
+ * @returns The loaded native module, or `null` for AJV fallback.
+ */
+export function getNativeModule() {
+    ensureLoaded();
+    return nativeModule;
+}
+//# sourceMappingURL=native-loader.js.map

package/dist/src/native-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-loader.js","sourceRoot":"","sources":["../../src/native-loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AA6B5C,IAAI,YAAY,GAA4B,IAAI,CAAC;AACjD,IAAI,aAAa,GAAG,KAAK,CAAC;AAE1B;;;GAGG;AACH,SAAS,YAAY;IACnB,IAAI,aAAa;QAAE,OAAO;IAC1B,aAAa,GAAG,IAAI,CAAC;IAErB,MAAM,GAAG,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC3C,IAAI,CAAC;QACH,YAAY,GAAG,GAAG,CAAC,uBAAuB,CAAqB,CAAC;IAClE,CAAC;IAAC,MAAM,CAAC;QACP,IAAI,CAAC;YACH,gEAAgE;YAChE,YAAY,GAAG,GAAG,CAAC,kCAAkC,CAAqB,CAAC;QAC7E,CAAC;QAAC,MAAM,CAAC;YACP,yDAAyD;YACzD,YAAY,GAAG,IAAI,CAAC;QACtB,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB;IAC/B,YAAY,EAAE,CAAC;IACf,OAAO,YAAY,KAAK,IAAI,CAAC;AAC/B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe;IAC7B,YAAY,EAAE,CAAC;IACf,OAAO,YAAY,CAAC;AACtB,CAAC"}

package/dist/src/problemDetails.d.ts

@@ -4,32 +4,98 @@
  * Available for any transport, not just HTTP.
  */
 import type { LAFSError } from './types.js';
-/** RFC 9457 Problem Details with LAFS extensions */
+/**
+ * RFC 9457 Problem Details with LAFS extensions.
+ *
+ * @remarks
+ * Extends the standard RFC 9457 Problem Details object with LAFS-specific
+ * agent-actionable fields. The index signature allows pass-through of
+ * additional error details from {@link LAFSError.details}.
+ *
+ * @example
+ * ```typescript
+ * const pd: LafsProblemDetails = {
+ *   type: "https://lafs.dev/errors/v1/E_VALIDATION",
+ *   title: "E_VALIDATION",
+ *   status: 400,
+ *   detail: "Invalid input",
+ *   retryable: false,
+ * };
+ * ```
+ */
 export interface LafsProblemDetails {
+    /** URI reference identifying the problem type */
     type: string;
+    /** Short human-readable summary (typically the error code) */
     title: string;
+    /** HTTP status code for this error */
     status: number;
+    /** Human-readable explanation of the specific occurrence */
     detail: string;
+    /**
+     * URI reference identifying the specific occurrence (typically the request ID).
+     * @defaultValue `undefined`
+     */
     instance?: string;
+    /** Whether the operation that caused this error can be retried */
     retryable: boolean;
+    /**
+     * Recommended agent action (e.g., `"retry"`, `"escalate"`).
+     * @defaultValue `undefined`
+     */
     agentAction?: string;
+    /**
+     * Suggested delay in milliseconds before retrying.
+     * @defaultValue `undefined`
+     */
     retryAfterMs?: number;
+    /**
+     * Whether the error requires human escalation.
+     * @defaultValue `undefined`
+     */
     escalationRequired?: boolean;
+    /**
+     * Human-readable suggestion for resolving the error.
+     * @defaultValue `undefined`
+     */
     suggestedAction?: string;
+    /**
+     * Documentation URL for more information.
+     * @defaultValue `undefined`
+     */
     docUrl?: string;
+    /** Pass-through extension members from error details */
     [key: string]: unknown;
 }
 /**
  * Convert a LAFSError to an RFC 9457 Problem Details object.
+ *
+ * @param error - The LAFS error to convert
+ * @param requestId - Optional request ID to set as the `instance` field
+ * @returns An RFC 9457-compliant {@link LafsProblemDetails} object
+ *
+ * @remarks
  * Uses the error registry for HTTP status and type URI resolution.
+ * Agent-actionable fields (`agentAction`, `escalationRequired`, `suggestedAction`,
+ * `docUrl`) are mapped from the error when present. Non-empty `error.details`
+ * entries are spread as extension members, skipping keys that already exist
+ * in the Problem Details object.
  *
- * Agent-actionable fields (agentAction, escalationRequired, suggestedAction, docUrl)
- * are extracted from error.details if present, enabling forward-compatible extension
- * without requiring LAFSError type changes.
+ * @example
+ * ```typescript
+ * import { lafsErrorToProblemDetails } from "@cleocode/lafs";
+ *
+ * const pd = lafsErrorToProblemDetails(envelope.error!, envelope._meta.requestId);
+ * // pd.status === 400, pd.type === "https://lafs.dev/errors/v1/E_VALIDATION"
+ * ```
  */
 export declare function lafsErrorToProblemDetails(error: LAFSError, requestId?: string): LafsProblemDetails;
 /**
  * Content-Type for RFC 9457 Problem Details responses.
+ *
+ * @remarks
+ * Per RFC 9457, Problem Details responses MUST be served with this media type
+ * to distinguish them from regular JSON responses.
  */
 export declare const PROBLEM_DETAILS_CONTENT_TYPE: "application/problem+json";
 //# sourceMappingURL=problemDetails.d.ts.map

package/dist/src/problemDetails.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"problemDetails.d.ts","sourceRoot":"","sources":["../../src/problemDetails.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,oDAAoD;AACpD,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,SAAS,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,SAAS,EAChB,SAAS,CAAC,EAAE,MAAM,GACjB,kBAAkB,CA8BpB;AAED;;GAEG;AACH,eAAO,MAAM,4BAA4B,EAAG,0BAAmC,CAAC"}
+{"version":3,"file":"problemDetails.d.ts","sourceRoot":"","sources":["../../src/problemDetails.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,WAAW,kBAAkB;IACjC,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAC;IACb,8DAA8D;IAC9D,KAAK,EAAE,MAAM,CAAC;IACd,sCAAsC;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,4DAA4D;IAC5D,MAAM,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kEAAkE;IAClE,SAAS,EAAE,OAAO,CAAC;IACnB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wDAAwD;IACxD,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,SAAS,EAChB,SAAS,CAAC,EAAE,MAAM,GACjB,kBAAkB,CA8BpB;AAED;;;;;;GAMG;AACH,eAAO,MAAM,4BAA4B,EAAG,0BAAmC,CAAC"}

package/dist/src/problemDetails.js

@@ -6,11 +6,25 @@
 import { getRegistryCode } from './errorRegistry.js';
 /**
  * Convert a LAFSError to an RFC 9457 Problem Details object.
+ *
+ * @param error - The LAFS error to convert
+ * @param requestId - Optional request ID to set as the `instance` field
+ * @returns An RFC 9457-compliant {@link LafsProblemDetails} object
+ *
+ * @remarks
  * Uses the error registry for HTTP status and type URI resolution.
+ * Agent-actionable fields (`agentAction`, `escalationRequired`, `suggestedAction`,
+ * `docUrl`) are mapped from the error when present. Non-empty `error.details`
+ * entries are spread as extension members, skipping keys that already exist
+ * in the Problem Details object.
  *
- * Agent-actionable fields (agentAction, escalationRequired, suggestedAction, docUrl)
- * are extracted from error.details if present, enabling forward-compatible extension
- * without requiring LAFSError type changes.
+ * @example
+ * ```typescript
+ * import { lafsErrorToProblemDetails } from "@cleocode/lafs";
+ *
+ * const pd = lafsErrorToProblemDetails(envelope.error!, envelope._meta.requestId);
+ * // pd.status === 400, pd.type === "https://lafs.dev/errors/v1/E_VALIDATION"
+ * ```
  */
 export function lafsErrorToProblemDetails(error, requestId) {
     const registry = getRegistryCode(error.code);
@@ -46,6 +60,10 @@ export function lafsErrorToProblemDetails(error, requestId) {
 }
 /**
  * Content-Type for RFC 9457 Problem Details responses.
+ *
+ * @remarks
+ * Per RFC 9457, Problem Details responses MUST be served with this media type
+ * to distinguish them from regular JSON responses.
  */
 export const PROBLEM_DETAILS_CONTENT_TYPE = 'application/problem+json';
 //# sourceMappingURL=problemDetails.js.map

package/dist/src/problemDetails.js.map

@@ -1 +1 @@
-{"version":3,"file":"problemDetails.js","sourceRoot":"","sources":["../../src/problemDetails.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAqBrD;;;;;;;GAOG;AACH,MAAM,UAAU,yBAAyB,CACvC,KAAgB,EAChB,SAAkB;IAElB,MAAM,QAAQ,GAAG,eAAe,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAE7C,MAAM,EAAE,GAAuB;QAC7B,IAAI,EAAE,8BAA8B,KAAK,CAAC,IAAI,EAAE;QAChD,KAAK,EAAE,KAAK,CAAC,IAAI;QACjB,MAAM,EAAE,QAAQ,EAAE,UAAU,IAAI,GAAG;QACnC,MAAM,EAAE,KAAK,CAAC,OAAO;QACrB,SAAS,EAAE,KAAK,CAAC,SAAS;KAC3B,CAAC;IAEF,IAAI,SAAS;QAAE,EAAE,CAAC,QAAQ,GAAG,SAAS,CAAC;IACvC,IAAI,KAAK,CAAC,YAAY,IAAI,IAAI;QAAE,EAAE,CAAC,YAAY,GAAG,KAAK,CAAC,YAAY,CAAC;IAErE,wCAAwC;IACxC,IAAI,KAAK,CAAC,WAAW,IAAI,IAAI;QAAE,EAAE,CAAC,WAAW,GAAG,KAAK,CAAC,WAAW,CAAC;IAClE,IAAI,KAAK,CAAC,kBAAkB,IAAI,IAAI;QAAE,EAAE,CAAC,kBAAkB,GAAG,KAAK,CAAC,kBAAkB,CAAC;IACvF,IAAI,KAAK,CAAC,eAAe,IAAI,IAAI;QAAE,EAAE,CAAC,eAAe,GAAG,KAAK,CAAC,eAAe,CAAC;IAC9E,IAAI,KAAK,CAAC,MAAM,IAAI,IAAI;QAAE,EAAE,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;IAEnD,gDAAgD;IAChD,IAAI,KAAK,CAAC,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3D,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;YACzD,IAAI,CAAC,CAAC,GAAG,IAAI,EAAE,CAAC,EAAE,CAAC;gBACjB,EAAE,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;YAClB,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,EAAE,CAAC;AACZ,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,0BAAmC,CAAC"}
+{"version":3,"file":"problemDetails.js","sourceRoot":"","sources":["../../src/problemDetails.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAmErD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,yBAAyB,CACvC,KAAgB,EAChB,SAAkB;IAElB,MAAM,QAAQ,GAAG,eAAe,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAE7C,MAAM,EAAE,GAAuB;QAC7B,IAAI,EAAE,8BAA8B,KAAK,CAAC,IAAI,EAAE;QAChD,KAAK,EAAE,KAAK,CAAC,IAAI;QACjB,MAAM,EAAE,QAAQ,EAAE,UAAU,IAAI,GAAG;QACnC,MAAM,EAAE,KAAK,CAAC,OAAO;QACrB,SAAS,EAAE,KAAK,CAAC,SAAS;KAC3B,CAAC;IAEF,IAAI,SAAS;QAAE,EAAE,CAAC,QAAQ,GAAG,SAAS,CAAC;IACvC,IAAI,KAAK,CAAC,YAAY,IAAI,IAAI;QAAE,EAAE,CAAC,YAAY,GAAG,KAAK,CAAC,YAAY,CAAC;IAErE,wCAAwC;IACxC,IAAI,KAAK,CAAC,WAAW,IAAI,IAAI;QAAE,EAAE,CAAC,WAAW,GAAG,KAAK,CAAC,WAAW,CAAC;IAClE,IAAI,KAAK,CAAC,kBAAkB,IAAI,IAAI;QAAE,EAAE,CAAC,kBAAkB,GAAG,KAAK,CAAC,kBAAkB,CAAC;IACvF,IAAI,KAAK,CAAC,eAAe,IAAI,IAAI;QAAE,EAAE,CAAC,eAAe,GAAG,KAAK,CAAC,eAAe,CAAC;IAC9E,IAAI,KAAK,CAAC,MAAM,IAAI,IAAI;QAAE,EAAE,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;IAEnD,gDAAgD;IAChD,IAAI,KAAK,CAAC,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3D,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;YACzD,IAAI,CAAC,CAAC,GAAG,IAAI,EAAE,CAAC,EAAE,CAAC;gBACjB,EAAE,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;YAClB,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,EAAE,CAAC;AACZ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,0BAAmC,CAAC"}

package/dist/src/shutdown/index.d.ts

@@ -1,22 +1,58 @@
 /**
  * LAFS Graceful Shutdown Module
  *
- * Handles graceful shutdown of LAFS servers
+ * Handles graceful shutdown of LAFS servers.
+ *
+ * @packageDocumentation
  */
 import type { Server } from 'http';
+/** Configuration for the {@link gracefulShutdown} handler. */
 export interface GracefulShutdownConfig {
+    /**
+     * Maximum time in milliseconds to wait for in-flight requests before forcing exit.
+     * @defaultValue 30000
+     */
     timeout?: number;
+    /**
+     * POSIX signals that trigger a graceful shutdown.
+     * @defaultValue ['SIGTERM', 'SIGINT']
+     */
     signals?: NodeJS.Signals[];
+    /**
+     * Callback invoked at the start of shutdown, before the server stops accepting connections.
+     * @defaultValue undefined
+     */
     onShutdown?: () => Promise<void> | void;
+    /**
+     * Callback invoked after all connections have closed (or the timeout elapsed).
+     * @defaultValue undefined
+     */
     onClose?: () => Promise<void> | void;
 }
+/** Snapshot of the current shutdown state. */
 export interface ShutdownState {
+    /** Whether a shutdown sequence is currently in progress. */
     isShuttingDown: boolean;
+    /** Number of TCP connections still open. */
     activeConnections: number;
+    /**
+     * Timestamp when the shutdown sequence began.
+     * @defaultValue undefined
+     */
     shutdownStartTime?: Date;
 }
 /**
- * Enable graceful shutdown for an HTTP server
+ * Enable graceful shutdown for an HTTP server.
+ *
+ * @remarks
+ * Registers listeners for the configured signals (and uncaught errors) that
+ * trigger an orderly shutdown sequence: invoke the `onShutdown` callback,
+ * stop accepting new connections, drain existing connections up to the
+ * timeout, invoke the `onClose` callback, and exit the process. New
+ * connections received after shutdown starts are immediately destroyed.
+ *
+ * @param server - The Node.js HTTP server to manage
+ * @param config - Optional shutdown configuration
  *
  * @example
  * ```typescript
@@ -38,19 +74,65 @@ export interface ShutdownState {
  */
 export declare function gracefulShutdown(server: Server, config?: GracefulShutdownConfig): void;
 /**
- * Check if server is shutting down
+ * Check whether a shutdown sequence is currently in progress.
+ *
+ * @remarks
+ * Returns `true` once a shutdown signal has been received and the shutdown
+ * handler has started executing. Useful for guards that need to short-circuit
+ * work when the process is going down.
+ *
+ * @returns `true` if the server is shutting down, `false` otherwise
+ *
+ * @example
+ * ```typescript
+ * if (isShuttingDown()) {
+ *   return; // skip expensive work
+ * }
+ * ```
  */
 export declare function isShuttingDown(): boolean;
 /**
- * Get shutdown state
+ * Get a snapshot of the current shutdown state.
+ *
+ * @remarks
+ * Returns a shallow copy of the internal {@link ShutdownState}, including
+ * whether shutdown is in progress, the active connection count, and the
+ * shutdown start time (if applicable).
+ *
+ * @returns A copy of the current {@link ShutdownState}
+ *
+ * @example
+ * ```typescript
+ * const state = getShutdownState();
+ * console.log(`Connections: ${state.activeConnections}`);
+ * ```
  */
 export declare function getShutdownState(): ShutdownState;
 /**
- * Force immediate shutdown (emergency use only)
+ * Terminate the process immediately without waiting for connections to drain.
+ *
+ * @remarks
+ * Calls `process.exit()` with the given exit code. Intended only for
+ * emergency situations where a graceful shutdown has stalled or a fatal
+ * condition prevents orderly teardown.
+ *
+ * @param exitCode - Process exit code
+ *
+ * @example
+ * ```typescript
+ * forceShutdown(1);
+ * ```
  */
 export declare function forceShutdown(exitCode?: number): void;
 /**
- * Middleware to reject requests during shutdown
+ * Express middleware that rejects requests with 503 while the server is shutting down.
+ *
+ * @remarks
+ * Should be mounted early in the middleware stack so that new requests are
+ * immediately rejected once shutdown begins, preventing work from starting
+ * that cannot complete before the process exits.
+ *
+ * @returns An Express-compatible middleware function
  *
  * @example
  * ```typescript
@@ -63,7 +145,14 @@ export declare function shutdownMiddleware(): (_req: unknown, res: {
     };
 }, next: () => void) => void;
 /**
- * Wait for shutdown to complete
+ * Wait until a shutdown sequence begins.
+ *
+ * @remarks
+ * Polls the internal shutdown state every 100ms and resolves once
+ * `isShuttingDown` becomes `true`. Useful for test harnesses or background
+ * workers that need to block until the process is going down.
+ *
+ * @returns A promise that resolves when shutdown has started
  *
  * @example
  * ```typescript

package/dist/src/shutdown/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/shutdown/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAEnC,MAAM,WAAW,sBAAsB;IACrC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACxC,OAAO,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACtC;AAED,MAAM,WAAW,aAAa;IAC5B,cAAc,EAAE,OAAO,CAAC;IACxB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,iBAAiB,CAAC,EAAE,IAAI,CAAC;CAC1B;AAOD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,GAAE,sBAA2B,GAAG,IAAI,CAoC1F;AAgED;;GAEG;AACH,wBAAgB,cAAc,IAAI,OAAO,CAExC;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,aAAa,CAEhD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,QAAQ,GAAE,MAAU,GAAG,IAAI,CAGxD;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,KAE9B,MAAM,OAAO,EACb,KAAK;IAAE,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK;QAAE,IAAI,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAA;KAAE,CAAA;CAAE,EACpE,MAAM,MAAM,IAAI,UAWnB;AAED;;;;;;;GAOG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAIrD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/shutdown/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAEnC,8DAA8D;AAC9D,MAAM,WAAW,sBAAsB;IACrC;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC;IAE3B;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAExC;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACtC;AAED,8CAA8C;AAC9C,MAAM,WAAW,aAAa;IAC5B,4DAA4D;IAC5D,cAAc,EAAE,OAAO,CAAC;IAExB,4CAA4C;IAC5C,iBAAiB,EAAE,MAAM,CAAC;IAE1B;;;OAGG;IACH,iBAAiB,CAAC,EAAE,IAAI,CAAC;CAC1B;AAOD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,GAAE,sBAA2B,GAAG,IAAI,CAoC1F;AAgED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,cAAc,IAAI,OAAO,CAExC;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,gBAAgB,IAAI,aAAa,CAEhD;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,aAAa,CAAC,QAAQ,GAAE,MAAU,GAAG,IAAI,CAGxD;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,kBAAkB,KAE9B,MAAM,OAAO,EACb,KAAK;IAAE,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK;QAAE,IAAI,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAA;KAAE,CAAA;CAAE,EACpE,MAAM,MAAM,IAAI,UAWnB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAIrD"}

package/dist/src/shutdown/index.js

@@ -1,14 +1,26 @@
 /**
  * LAFS Graceful Shutdown Module
  *
- * Handles graceful shutdown of LAFS servers
+ * Handles graceful shutdown of LAFS servers.
+ *
+ * @packageDocumentation
  */
 const state = {
     isShuttingDown: false,
     activeConnections: 0,
 };
 /**
- * Enable graceful shutdown for an HTTP server
+ * Enable graceful shutdown for an HTTP server.
+ *
+ * @remarks
+ * Registers listeners for the configured signals (and uncaught errors) that
+ * trigger an orderly shutdown sequence: invoke the `onShutdown` callback,
+ * stop accepting new connections, drain existing connections up to the
+ * timeout, invoke the `onClose` callback, and exit the process. New
+ * connections received after shutdown starts are immediately destroyed.
+ *
+ * @param server - The Node.js HTTP server to manage
+ * @param config - Optional shutdown configuration
  *
  * @example
  * ```typescript
@@ -107,26 +119,72 @@ function sleep(ms) {
     return new Promise((resolve) => setTimeout(resolve, ms));
 }
 /**
- * Check if server is shutting down
+ * Check whether a shutdown sequence is currently in progress.
+ *
+ * @remarks
+ * Returns `true` once a shutdown signal has been received and the shutdown
+ * handler has started executing. Useful for guards that need to short-circuit
+ * work when the process is going down.
+ *
+ * @returns `true` if the server is shutting down, `false` otherwise
+ *
+ * @example
+ * ```typescript
+ * if (isShuttingDown()) {
+ *   return; // skip expensive work
+ * }
+ * ```
  */
 export function isShuttingDown() {
     return state.isShuttingDown;
 }
 /**
- * Get shutdown state
+ * Get a snapshot of the current shutdown state.
+ *
+ * @remarks
+ * Returns a shallow copy of the internal {@link ShutdownState}, including
+ * whether shutdown is in progress, the active connection count, and the
+ * shutdown start time (if applicable).
+ *
+ * @returns A copy of the current {@link ShutdownState}
+ *
+ * @example
+ * ```typescript
+ * const state = getShutdownState();
+ * console.log(`Connections: ${state.activeConnections}`);
+ * ```
  */
 export function getShutdownState() {
     return { ...state };
 }
 /**
- * Force immediate shutdown (emergency use only)
+ * Terminate the process immediately without waiting for connections to drain.
+ *
+ * @remarks
+ * Calls `process.exit()` with the given exit code. Intended only for
+ * emergency situations where a graceful shutdown has stalled or a fatal
+ * condition prevents orderly teardown.
+ *
+ * @param exitCode - Process exit code
+ *
+ * @example
+ * ```typescript
+ * forceShutdown(1);
+ * ```
  */
 export function forceShutdown(exitCode = 1) {
     console.log('Force shutting down...');
     process.exit(exitCode);
 }
 /**
- * Middleware to reject requests during shutdown
+ * Express middleware that rejects requests with 503 while the server is shutting down.
+ *
+ * @remarks
+ * Should be mounted early in the middleware stack so that new requests are
+ * immediately rejected once shutdown begins, preventing work from starting
+ * that cannot complete before the process exits.
+ *
+ * @returns An Express-compatible middleware function
  *
  * @example
  * ```typescript
@@ -146,7 +204,14 @@ export function shutdownMiddleware() {
     };
 }
 /**
- * Wait for shutdown to complete
+ * Wait until a shutdown sequence begins.
+ *
+ * @remarks
+ * Polls the internal shutdown state every 100ms and resolves once
+ * `isShuttingDown` becomes `true`. Useful for test harnesses or background
+ * workers that need to block until the process is going down.
+ *
+ * @returns A promise that resolves when shutdown has started
  *
  * @example
  * ```typescript

package/dist/src/shutdown/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/shutdown/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAiBH,MAAM,KAAK,GAAkB;IAC3B,cAAc,EAAE,KAAK;IACrB,iBAAiB,EAAE,CAAC;CACrB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAc,EAAE,SAAiC,EAAE;IAClF,MAAM,EAAE,OAAO,GAAG,KAAK,EAAE,OAAO,GAAG,CAAC,SAAS,EAAE,QAAQ,CAAC,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC;IAEzF,2BAA2B;IAC3B,MAAM,CAAC,EAAE,CAAC,YAAY,EAAE,CAAC,MAAM,EAAE,EAAE;QACjC,IAAI,KAAK,CAAC,cAAc,EAAE,CAAC;YACzB,MAAM,CAAC,OAAO,EAAE,CAAC;YACjB,OAAO;QACT,CAAC;QAED,KAAK,CAAC,iBAAiB,EAAE,CAAC;QAE1B,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;YACtB,KAAK,CAAC,iBAAiB,EAAE,CAAC;QAC5B,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,0BAA0B;IAC1B,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE;QACzB,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,KAAK,IAAI,EAAE;YAC5B,OAAO,CAAC,GAAG,CAAC,GAAG,MAAM,0CAA0C,CAAC,CAAC;YAEjE,MAAM,eAAe,CAAC,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;QAC9D,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,yBAAyB;IACzB,OAAO,CAAC,EAAE,CAAC,mBAAmB,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;QAC9C,OAAO,CAAC,KAAK,CAAC,qBAAqB,EAAE,KAAK,CAAC,CAAC;QAC5C,MAAM,eAAe,CAAC,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;IAC9D,CAAC,CAAC,CAAC;IAEH,OAAO,CAAC,EAAE,CAAC,oBAAoB,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;QAChD,OAAO,CAAC,KAAK,CAAC,sBAAsB,EAAE,MAAM,CAAC,CAAC;QAC9C,MAAM,eAAe,CAAC,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;IAC9D,CAAC,CAAC,CAAC;AACL,CAAC;AAED,KAAK,UAAU,eAAe,CAC5B,MAAc,EACd,OAAe,EACf,UAAuC,EACvC,OAAoC;IAEpC,IAAI,KAAK,CAAC,cAAc,EAAE,CAAC;QACzB,OAAO,CAAC,GAAG,CAAC,iCAAiC,CAAC,CAAC;QAC/C,OAAO;IACT,CAAC;IAED,KAAK,CAAC,cAAc,GAAG,IAAI,CAAC;IAC5B,KAAK,CAAC,iBAAiB,GAAG,IAAI,IAAI,EAAE,CAAC;IAErC,IAAI,CAAC;QACH,6BAA6B;QAC7B,IAAI,UAAU,EAAE,CAAC;YACf,MAAM,OAAO,CAAC,IAAI,CAAC;gBACjB,UAAU,EAAE;gBACZ,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,CACxB,UAAU,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC,EAAE,OAAO,CAAC,CACjE;aACF,CAAC,CAAC;QACL,CAAC;QAED,iCAAiC;QACjC,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;YACnB,IAAI,GAAG,EAAE,CAAC;gBACR,OAAO,CAAC,KAAK,CAAC,uBAAuB,EAAE,GAAG,CAAC,CAAC;YAC9C,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;YAC/B,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,uCAAuC;QACvC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC7B,OAAO,KAAK,CAAC,iBAAiB,GAAG,CAAC,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,GAAG,OAAO,EAAE,CAAC;YACvE,OAAO,CAAC,GAAG,CAAC,eAAe,KAAK,CAAC,iBAAiB,0BAA0B,CAAC,CAAC;YAC9E,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC;QACpB,CAAC;QAED,IAAI,KAAK,CAAC,iBAAiB,GAAG,CAAC,EAAE,CAAC;YAChC,OAAO,CAAC,IAAI,CAAC,yBAAyB,KAAK,CAAC,iBAAiB,qBAAqB,CAAC,CAAC;QACtF,CAAC;QAED,0BAA0B;QAC1B,IAAI,OAAO,EAAE,CAAC;YACZ,MAAM,OAAO,EAAE,CAAC;QAClB,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC;QAC1C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,wBAAwB,EAAE,KAAK,CAAC,CAAC;QAC/C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,SAAS,KAAK,CAAC,EAAU;IACvB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc;IAC5B,OAAO,KAAK,CAAC,cAAc,CAAC;AAC9B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB;IAC9B,OAAO,EAAE,GAAG,KAAK,EAAE,CAAC;AACtB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,WAAmB,CAAC;IAChD,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC;IACtC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AACzB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB;IAChC,OAAO,CACL,IAAa,EACb,GAAoE,EACpE,IAAgB,EAChB,EAAE;QACF,IAAI,KAAK,CAAC,cAAc,EAAE,CAAC;YACzB,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;gBACnB,KAAK,EAAE,0BAA0B;gBACjC,MAAM,EAAE,aAAa;aACtB,CAAC,CAAC;YACH,OAAO;QACT,CAAC;QACD,IAAI,EAAE,CAAC;IACT,CAAC,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe;IACnC,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,CAAC;QAC7B,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC;IACnB,CAAC;AACH,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/shutdown/index.ts"],"names":[],"mappings":"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"}