@cleocode/lafs 2026.3.74 → 2026.4.3

package/dist/src/mviProjection.js

@@ -1,9 +1,22 @@
 /**
  * Project an envelope to the declared MVI verbosity level.
- * - 'minimal': Only fields required for agent control flow
- * - 'standard': All commonly useful fields (current default behavior)
- * - 'full': Complete echo-back including request parameters
- * - 'custom': No projection (controlled by _fields)
+ *
+ * @param envelope - The full LAFS envelope to project
+ * @param mviLevel - Override MVI level; falls back to `envelope._meta.mvi`, then `'standard'`
+ * @returns A plain object containing only the fields appropriate for the resolved MVI level
+ *
+ * @remarks
+ * MVI levels control projection behavior:
+ * - `'minimal'`: only fields required for agent control flow (success, error code, retry info)
+ * - `'standard'`: all commonly useful fields (current default behavior)
+ * - `'full'`: complete echo-back including request parameters
+ * - `'custom'`: no projection (controlled by field extraction layer)
+ *
+ * @example
+ * ```ts
+ * const minimal = projectEnvelope(envelope, 'minimal');
+ * // minimal contains only: success, _meta (requestId, contextVersion), result/error
+ * ```
  */
 export function projectEnvelope(envelope, mviLevel) {
     const level = mviLevel ?? envelope._meta.mvi ?? 'standard';
@@ -108,9 +121,23 @@ function projectErrorMinimal(error) {
 }
 /**
  * Estimate token count for a projected envelope.
- * Uses simple heuristic: 1 token per ~4 characters of JSON.
+ *
+ * @param projected - The projected envelope object to estimate
+ * @returns The estimated token count based on JSON serialization length
+ *
+ * @remarks
+ * Uses a simple heuristic of 1 token per approximately 4 characters of
+ * JSON-serialized output. This is an approximation suitable for budget
+ * enforcement, not an exact tokenizer count.
+ *
+ * @example
+ * ```ts
+ * const tokens = estimateProjectedTokens(projectEnvelope(envelope, 'minimal'));
+ * // tokens ~= Math.ceil(JSON.stringify(projected).length / 4)
+ * ```
  */
 export function estimateProjectedTokens(projected) {
     const json = JSON.stringify(projected);
     return Math.ceil(json.length / 4);
 }
+//# sourceMappingURL=mviProjection.js.map

package/dist/src/mviProjection.js.map

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

package/dist/src/native-loader.d.ts

@@ -0,0 +1,49 @@
+/**
+ * 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`.
+ */
+/** Shape of a structured validation error from the native binding. */
+interface NativeValidationError {
+    /** JSON Pointer path to the failing property. */
+    path: string;
+    /** JSON Schema keyword that triggered the error. */
+    keyword: string;
+    /** Human-readable error message. */
+    message: string;
+    /** Keyword-specific parameters. */
+    params: Record<string, unknown>;
+}
+/** Shape of the validation result from the native binding. */
+export interface NativeValidationResult {
+    /** Whether the envelope conforms to the schema. */
+    valid: boolean;
+    /** Flattened human-readable error messages. */
+    errors: string[];
+    /** Structured error objects. */
+    structuredErrors: NativeValidationError[];
+}
+/** Shape of the native LAFS addon. */
+interface LafsNativeModule {
+    lafsValidateEnvelope(payload: string): NativeValidationResult;
+}
+/**
+ * Check if the native addon is available.
+ *
+ * @returns `true` if the native Rust binding was loaded successfully.
+ */
+export declare function isNativeAvailable(): boolean;
+/**
+ * Get the native module, or `null` if unavailable.
+ *
+ * @returns The loaded native module, or `null` for AJV fallback.
+ */
+export declare function getNativeModule(): LafsNativeModule | null;
+export {};
+//# sourceMappingURL=native-loader.d.ts.map

package/dist/src/native-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-loader.d.ts","sourceRoot":"","sources":["../../src/native-loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,sEAAsE;AACtE,UAAU,qBAAqB;IAC7B,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAC;IACb,oDAAoD;IACpD,OAAO,EAAE,MAAM,CAAC;IAChB,oCAAoC;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,mCAAmC;IACnC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED,8DAA8D;AAC9D,MAAM,WAAW,sBAAsB;IACrC,mDAAmD;IACnD,KAAK,EAAE,OAAO,CAAC;IACf,+CAA+C;IAC/C,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,gCAAgC;IAChC,gBAAgB,EAAE,qBAAqB,EAAE,CAAC;CAC3C;AAED,sCAAsC;AACtC,UAAU,gBAAgB;IACxB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,sBAAsB,CAAC;CAC/D;AA2BD;;;;GAIG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAG3C;AAED;;;;GAIG;AACH,wBAAgB,eAAe,IAAI,gBAAgB,GAAG,IAAI,CAGzD"}

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,31 +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

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

@@ -1,11 +1,30 @@
+/**
+ * Core RFC 9457 Problem Details bridge.
+ * Converts LAFSError to RFC 9457-compliant Problem Details objects.
+ * Available for any transport, not just HTTP.
+ */
 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.
+ *
+ * @example
+ * ```typescript
+ * import { lafsErrorToProblemDetails } from "@cleocode/lafs";
  *
- * Agent-actionable fields (agentAction, escalationRequired, suggestedAction, docUrl)
- * are extracted from error.details if present, enabling forward-compatible extension
- * without requiring LAFSError type changes.
+ * 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);
@@ -41,5 +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

@@ -0,0 +1 @@
+{"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 { Server } from 'http';
+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,28 +74,85 @@ 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
  * app.use(shutdownMiddleware());
  * ```
  */
-export declare function shutdownMiddleware(): (req: any, res: any, next: any) => void;
+export declare function shutdownMiddleware(): (_req: unknown, res: {
+    status: (code: number) => {
+        json: (body: unknown) => void;
+    };
+}, 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
@@ -67,3 +160,4 @@ export declare function shutdownMiddleware(): (req: any, res: any, next: any) =>
  * ```
  */
 export declare function waitForShutdown(): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"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
+    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
@@ -70,7 +82,7 @@ async function performShutdown(server, timeout, onShutdown, onClose) {
         if (onShutdown) {
             await Promise.race([
                 onShutdown(),
-                new Promise((_, reject) => setTimeout(() => reject(new Error('Shutdown timeout')), timeout))
+                new Promise((_, reject) => setTimeout(() => reject(new Error('Shutdown timeout')), timeout)),
             ]);
         }
         // Stop accepting new connections
@@ -104,29 +116,75 @@ async function performShutdown(server, timeout, onShutdown, onClose) {
     }
 }
 function sleep(ms) {
-    return new Promise(resolve => setTimeout(resolve, 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
@@ -134,11 +192,11 @@ export function forceShutdown(exitCode = 1) {
  * ```
  */
 export function shutdownMiddleware() {
-    return (req, res, next) => {
+    return (_req, res, next) => {
         if (state.isShuttingDown) {
             res.status(503).json({
                 error: 'Service is shutting down',
-                status: 'unavailable'
+                status: 'unavailable',
             });
             return;
         }
@@ -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
@@ -158,3 +223,4 @@ export async function waitForShutdown() {
         await sleep(100);
     }
 }
+//# sourceMappingURL=index.js.map

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

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