@cleocode/lafs 2026.4.0 → 2026.4.4

package/dist/src/circuit-breaker/index.js

@@ -1,16 +1,48 @@
 /**
  * LAFS Circuit Breaker Module
  *
- * Provides circuit breaker pattern for resilient service calls
+ * Provides circuit breaker pattern for resilient service calls.
+ *
+ * @packageDocumentation
+ */
+/**
+ * Error thrown when a circuit breaker rejects a call.
+ *
+ * @remarks
+ * This error is raised when the circuit is in the OPEN state or when the
+ * HALF_OPEN call limit has been reached. Callers should catch this to
+ * implement fallback logic or return a 503 response.
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await breaker.execute(() => fetch('/api'));
+ * } catch (err) {
+ *   if (err instanceof CircuitBreakerError) {
+ *     console.log('Circuit open, using fallback');
+ *   }
+ * }
+ * ```
  */
 export class CircuitBreakerError extends Error {
+    /**
+     * Creates a new CircuitBreakerError.
+     *
+     * @param message - Descriptive error message indicating why the call was rejected
+     */
     constructor(message) {
         super(message);
         this.name = 'CircuitBreakerError';
     }
 }
 /**
- * Circuit breaker for protecting against cascading failures
+ * Circuit breaker for protecting against cascading failures.
+ *
+ * @remarks
+ * Implements the circuit breaker pattern with three states: CLOSED (normal),
+ * OPEN (rejecting calls), and HALF_OPEN (testing recovery). The breaker
+ * automatically transitions between states based on failure and success
+ * thresholds, and schedules reset timers when the circuit opens.
  *
  * @example
  * ```typescript
@@ -35,14 +67,27 @@ export class CircuitBreakerError extends Error {
  */
 export class CircuitBreaker {
     config;
+    /** Current circuit state. */
     state = 'CLOSED';
+    /** Total failure count since last reset. */
     failures = 0;
+    /** Total success count since last reset. */
     successes = 0;
+    /** Timestamp of the most recent failure. */
     lastFailureTime;
+    /** Consecutive successes since the last failure. */
     consecutiveSuccesses = 0;
+    /** Lifetime call count. */
     totalCalls = 0;
+    /** Number of calls made while in the HALF_OPEN state. */
     halfOpenCalls = 0;
+    /** Timer handle for the scheduled OPEN-to-HALF_OPEN transition. */
     resetTimer;
+    /**
+     * Creates a new CircuitBreaker with the given configuration.
+     *
+     * @param config - Circuit breaker configuration with name, thresholds, and timeouts
+     */
     constructor(config) {
         this.config = config;
         this.config = {
@@ -54,7 +99,24 @@ export class CircuitBreaker {
         };
     }
     /**
-     * Execute a function with circuit breaker protection
+     * Execute a function with circuit breaker protection.
+     *
+     * @remarks
+     * When the circuit is CLOSED, calls pass through normally. When OPEN, calls
+     * are rejected with a {@link CircuitBreakerError} unless the reset timeout has
+     * elapsed (triggering HALF_OPEN). In HALF_OPEN, a limited number of trial
+     * calls are permitted; successes may close the circuit while failures re-open it.
+     *
+     * @typeParam T - Return type of the wrapped function
+     * @param fn - Async function to execute under circuit breaker protection
+     * @returns The result of invoking `fn`
+     *
+     * @example
+     * ```typescript
+     * const result = await breaker.execute(async () => {
+     *   return await fetch('https://api.example.com/data');
+     * });
+     * ```
      */
     async execute(fn) {
         this.totalCalls++;
@@ -83,13 +145,40 @@ export class CircuitBreaker {
         }
     }
     /**
-     * Get current circuit breaker state
+     * Get the current circuit breaker state.
+     *
+     * @remarks
+     * Returns one of `'CLOSED'`, `'OPEN'`, or `'HALF_OPEN'`. Useful for
+     * dashboards or conditional logic that needs to know whether calls will
+     * be accepted.
+     *
+     * @returns The current {@link CircuitState}
+     *
+     * @example
+     * ```typescript
+     * if (breaker.getState() === 'OPEN') {
+     *   console.log('Circuit is open, requests will be rejected');
+     * }
+     * ```
      */
     getState() {
         return this.state;
     }
     /**
-     * Get circuit breaker metrics
+     * Get a snapshot of the circuit breaker's runtime metrics.
+     *
+     * @remarks
+     * Returns a copy of the internal counters including failure/success counts,
+     * the current state, and the timestamp of the last failure. Useful for
+     * monitoring and observability.
+     *
+     * @returns A {@link CircuitBreakerMetrics} snapshot
+     *
+     * @example
+     * ```typescript
+     * const metrics = breaker.getMetrics();
+     * console.log(`State: ${metrics.state}, Failures: ${metrics.failures}`);
+     * ```
      */
     getMetrics() {
         return {
@@ -102,18 +191,41 @@ export class CircuitBreaker {
         };
     }
     /**
-     * Manually open the circuit breaker
+     * Manually open the circuit breaker, rejecting all subsequent calls.
+     *
+     * @remarks
+     * Forces the circuit into the OPEN state regardless of the current failure
+     * count. Useful for administrative controls or when an external signal
+     * indicates the downstream service is unavailable.
+     *
+     * @example
+     * ```typescript
+     * breaker.forceOpen();
+     * console.log(breaker.getState()); // 'OPEN'
+     * ```
      */
     forceOpen() {
         this.transitionTo('OPEN');
     }
     /**
-     * Manually close the circuit breaker
+     * Manually close the circuit breaker and reset all counters.
+     *
+     * @remarks
+     * Forces the circuit into the CLOSED state and clears failure/success
+     * counters and any pending reset timer. Useful for administrative recovery
+     * after a known issue has been resolved.
+     *
+     * @example
+     * ```typescript
+     * breaker.forceClose();
+     * console.log(breaker.getState()); // 'CLOSED'
+     * ```
      */
     forceClose() {
         this.transitionTo('CLOSED');
         this.reset();
     }
+    /** Records a successful call and may transition from HALF_OPEN to CLOSED. */
     onSuccess() {
         this.successes++;
         this.consecutiveSuccesses++;
@@ -124,6 +236,7 @@ export class CircuitBreaker {
             }
         }
     }
+    /** Records a failed call and may trip the circuit to OPEN. */
     onFailure() {
         this.failures++;
         this.consecutiveSuccesses = 0;
@@ -139,6 +252,7 @@ export class CircuitBreaker {
             }
         }
     }
+    /** Transitions the circuit to the given state, resetting HALF_OPEN call count when entering HALF_OPEN. */
     transitionTo(newState) {
         console.log(`Circuit breaker '${this.config.name}': ${this.state} -> ${newState}`);
         this.state = newState;
@@ -146,12 +260,14 @@ export class CircuitBreaker {
             this.halfOpenCalls = 0;
         }
     }
+    /** Returns `true` if enough time has elapsed since the last failure to attempt a reset. */
     shouldAttemptReset() {
         if (!this.lastFailureTime)
             return true;
         const elapsed = Date.now() - this.lastFailureTime.getTime();
         return elapsed >= (this.config.resetTimeout || 30000);
     }
+    /** Schedules a timer to transition from OPEN to HALF_OPEN after the configured reset timeout. */
     scheduleReset() {
         if (this.resetTimer) {
             clearTimeout(this.resetTimer);
@@ -162,6 +278,7 @@ export class CircuitBreaker {
             }
         }, this.config.resetTimeout || 30000);
     }
+    /** Resets all failure/success counters and clears the pending reset timer. */
     reset() {
         this.failures = 0;
         this.consecutiveSuccesses = 0;
@@ -173,7 +290,12 @@ export class CircuitBreaker {
     }
 }
 /**
- * Circuit breaker registry for managing multiple breakers
+ * Registry for managing multiple named circuit breakers.
+ *
+ * @remarks
+ * Provides centralized creation, lookup, and metrics aggregation for
+ * circuit breakers. Each breaker is stored by name and can be retrieved
+ * or lazily created via {@link CircuitBreakerRegistry.getOrCreate}.
  *
  * @example
  * ```typescript
@@ -188,15 +310,65 @@ export class CircuitBreaker {
  * ```
  */
 export class CircuitBreakerRegistry {
+    /** Internal map of circuit breaker name to instance. */
     breakers = new Map();
+    /**
+     * Register a new circuit breaker with the given name and configuration.
+     *
+     * @remarks
+     * Creates a new {@link CircuitBreaker}, stores it in the registry, and
+     * returns it. If a breaker with the same name already exists, it is replaced.
+     *
+     * @param name - Unique name for the circuit breaker
+     * @param config - Configuration options (name is set automatically)
+     * @returns The newly created {@link CircuitBreaker}
+     *
+     * @example
+     * ```typescript
+     * const breaker = registry.add('user-service', { failureThreshold: 3 });
+     * ```
+     */
     add(name, config) {
         const breaker = new CircuitBreaker({ ...config, name });
         this.breakers.set(name, breaker);
         return breaker;
     }
+    /**
+     * Retrieve a circuit breaker by name.
+     *
+     * @remarks
+     * Returns `undefined` if no breaker with the given name has been registered.
+     *
+     * @param name - Name of the circuit breaker to look up
+     * @returns The matching {@link CircuitBreaker}, or `undefined` if not found
+     *
+     * @example
+     * ```typescript
+     * const breaker = registry.get('payment-api');
+     * if (breaker) {
+     *   await breaker.execute(() => callPaymentApi());
+     * }
+     * ```
+     */
     get(name) {
         return this.breakers.get(name);
     }
+    /**
+     * Retrieve an existing circuit breaker or create one if it does not exist.
+     *
+     * @remarks
+     * This is useful when callers want a breaker but do not know whether it
+     * has already been registered, avoiding duplicate creation.
+     *
+     * @param name - Name of the circuit breaker
+     * @param config - Configuration to use if a new breaker must be created
+     * @returns The existing or newly created {@link CircuitBreaker}
+     *
+     * @example
+     * ```typescript
+     * const breaker = registry.getOrCreate('cache-api', { failureThreshold: 10 });
+     * ```
+     */
     getOrCreate(name, config) {
         let breaker = this.breakers.get(name);
         if (!breaker) {
@@ -204,6 +376,23 @@ export class CircuitBreakerRegistry {
         }
         return breaker;
     }
+    /**
+     * Collect metrics from all registered circuit breakers.
+     *
+     * @remarks
+     * Returns a record keyed by breaker name with each value being the
+     * corresponding {@link CircuitBreakerMetrics} snapshot.
+     *
+     * @returns A record mapping breaker names to their current metrics
+     *
+     * @example
+     * ```typescript
+     * const allMetrics = registry.getAllMetrics();
+     * for (const [name, metrics] of Object.entries(allMetrics)) {
+     *   console.log(`${name}: ${metrics.state}`);
+     * }
+     * ```
+     */
     getAllMetrics() {
         const metrics = {};
         this.breakers.forEach((breaker, name) => {
@@ -211,6 +400,18 @@ export class CircuitBreakerRegistry {
         });
         return metrics;
     }
+    /**
+     * Force-close all registered circuit breakers, resetting their counters.
+     *
+     * @remarks
+     * Iterates over every registered breaker and calls {@link CircuitBreaker.forceClose}.
+     * Useful for administrative recovery or test teardown.
+     *
+     * @example
+     * ```typescript
+     * registry.resetAll();
+     * ```
+     */
     resetAll() {
         this.breakers.forEach((breaker) => {
             breaker.forceClose();
@@ -218,7 +419,15 @@ export class CircuitBreakerRegistry {
     }
 }
 /**
- * Create a circuit breaker middleware for Express
+ * Create an Express middleware that wraps downstream handlers with a circuit breaker.
+ *
+ * @remarks
+ * Instantiates a {@link CircuitBreaker} from the provided config and wraps the
+ * `next()` call. When the circuit is open, the middleware responds with a 503
+ * status and a JSON error body instead of forwarding the request.
+ *
+ * @param config - Circuit breaker configuration for the middleware instance
+ * @returns An Express-compatible middleware function
  *
  * @example
  * ```typescript

package/dist/src/circuit-breaker/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/circuit-breaker/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAqBH,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IAC5C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,OAAO,cAAc;IAUL;IATZ,KAAK,GAAiB,QAAQ,CAAC;IAC/B,QAAQ,GAAG,CAAC,CAAC;IACb,SAAS,GAAG,CAAC,CAAC;IACd,eAAe,CAAQ;IACvB,oBAAoB,GAAG,CAAC,CAAC;IACzB,UAAU,GAAG,CAAC,CAAC;IACf,aAAa,GAAG,CAAC,CAAC;IAClB,UAAU,CAAkB;IAEpC,YAAoB,MAA4B;QAA5B,WAAM,GAAN,MAAM,CAAsB;QAC9C,IAAI,CAAC,MAAM,GAAG;YACZ,gBAAgB,EAAE,CAAC;YACnB,YAAY,EAAE,KAAK;YACnB,gBAAgB,EAAE,CAAC;YACnB,gBAAgB,EAAE,CAAC;YACnB,GAAG,MAAM;SACV,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAO,CAAI,EAAoB;QACnC,IAAI,CAAC,UAAU,EAAE,CAAC;QAElB,IAAI,IAAI,CAAC,KAAK,KAAK,MAAM,EAAE,CAAC;YAC1B,IAAI,IAAI,CAAC,kBAAkB,EAAE,EAAE,CAAC;gBAC9B,IAAI,CAAC,YAAY,CAAC,WAAW,CAAC,CAAC;YACjC,CAAC;iBAAM,CAAC;gBACN,MAAM,IAAI,mBAAmB,CAAC,oBAAoB,IAAI,CAAC,MAAM,CAAC,IAAI,WAAW,CAAC,CAAC;YACjF,CAAC;QACH,CAAC;QAED,IAAI,IAAI,CAAC,KAAK,KAAK,WAAW,EAAE,CAAC;YAC/B,IAAI,IAAI,CAAC,aAAa,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,gBAAgB,IAAI,CAAC,CAAC,EAAE,CAAC;gBAC9D,MAAM,IAAI,mBAAmB,CAC3B,oBAAoB,IAAI,CAAC,MAAM,CAAC,IAAI,oCAAoC,CACzE,CAAC;YACJ,CAAC;YACD,IAAI,CAAC,aAAa,EAAE,CAAC;QACvB,CAAC;QAED,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,EAAE,EAAE,CAAC;YAC1B,IAAI,CAAC,SAAS,EAAE,CAAC;YACjB,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,SAAS,EAAE,CAAC;YACjB,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED;;OAEG;IACH,UAAU;QACR,OAAO;YACL,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,eAAe,EAAE,IAAI,CAAC,eAAe;YACrC,oBAAoB,EAAE,IAAI,CAAC,oBAAoB;YAC/C,UAAU,EAAE,IAAI,CAAC,UAAU;SAC5B,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,SAAS;QACP,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;IAC5B,CAAC;IAED;;OAEG;IACH,UAAU;QACR,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;QAC5B,IAAI,CAAC,KAAK,EAAE,CAAC;IACf,CAAC;IAEO,SAAS;QACf,IAAI,CAAC,SAAS,EAAE,CAAC;QACjB,IAAI,CAAC,oBAAoB,EAAE,CAAC;QAE5B,IAAI,IAAI,CAAC,KAAK,KAAK,WAAW,EAAE,CAAC;YAC/B,IAAI,IAAI,CAAC,oBAAoB,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,gBAAgB,IAAI,CAAC,CAAC,EAAE,CAAC;gBACrE,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;gBAC5B,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,CAAC;QACH,CAAC;IACH,CAAC;IAEO,SAAS;QACf,IAAI,CAAC,QAAQ,EAAE,CAAC;QAChB,IAAI,CAAC,oBAAoB,GAAG,CAAC,CAAC;QAC9B,IAAI,CAAC,eAAe,GAAG,IAAI,IAAI,EAAE,CAAC;QAElC,IAAI,IAAI,CAAC,KAAK,KAAK,WAAW,EAAE,CAAC;YAC/B,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;YAC1B,IAAI,CAAC,aAAa,EAAE,CAAC;QACvB,CAAC;aAAM,IAAI,IAAI,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;YACnC,IAAI,IAAI,CAAC,QAAQ,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,gBAAgB,IAAI,CAAC,CAAC,EAAE,CAAC;gBACzD,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;gBAC1B,IAAI,CAAC,aAAa,EAAE,CAAC;YACvB,CAAC;QACH,CAAC;IACH,CAAC;IAEO,YAAY,CAAC,QAAsB;QACzC,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,CAAC,MAAM,CAAC,IAAI,MAAM,IAAI,CAAC,KAAK,OAAO,QAAQ,EAAE,CAAC,CAAC;QACnF,IAAI,CAAC,KAAK,GAAG,QAAQ,CAAC;QAEtB,IAAI,QAAQ,KAAK,WAAW,EAAE,CAAC;YAC7B,IAAI,CAAC,aAAa,GAAG,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;IAEO,kBAAkB;QACxB,IAAI,CAAC,IAAI,CAAC,eAAe;YAAE,OAAO,IAAI,CAAC;QAEvC,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,eAAe,CAAC,OAAO,EAAE,CAAC;QAC5D,OAAO,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,YAAY,IAAI,KAAK,CAAC,CAAC;IACxD,CAAC;IAEO,aAAa;QACnB,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACpB,YAAY,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAChC,CAAC;QAED,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC,GAAG,EAAE;YAChC,IAAI,IAAI,CAAC,KAAK,KAAK,MAAM,EAAE,CAAC;gBAC1B,IAAI,CAAC,YAAY,CAAC,WAAW,CAAC,CAAC;YACjC,CAAC;QACH,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,YAAY,IAAI,KAAK,CAAC,CAAC;IACxC,CAAC;IAEO,KAAK;QACX,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC;QAClB,IAAI,CAAC,oBAAoB,GAAG,CAAC,CAAC;QAC9B,IAAI,CAAC,aAAa,GAAG,CAAC,CAAC;QAEvB,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACpB,YAAY,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAC9B,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;QAC9B,CAAC;IACH,CAAC;CACF;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,OAAO,sBAAsB;IACzB,QAAQ,GAAG,IAAI,GAAG,EAA0B,CAAC;IAErD,GAAG,CAAC,IAAY,EAAE,MAA0C;QAC1D,MAAM,OAAO,GAAG,IAAI,cAAc,CAAC,EAAE,GAAG,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QACxD,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACjC,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC;IAED,WAAW,CAAC,IAAY,EAAE,MAA0C;QAClE,IAAI,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACtC,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACnC,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,aAAa;QACX,MAAM,OAAO,GAA0C,EAAE,CAAC;QAC1D,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE;YACtC,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;QACvC,CAAC,CAAC,CAAC;QACH,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,QAAQ;QACN,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;YAChC,OAAO,CAAC,UAAU,EAAE,CAAC;QACvB,CAAC,CAAC,CAAC;IACL,CAAC;CACF;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,wBAAwB,CAAC,MAA4B;IACnE,MAAM,OAAO,GAAG,IAAI,cAAc,CAAC,MAAM,CAAC,CAAC;IAE3C,OAAO,KAAK,EACV,IAAa,EACb,GAAoE,EACpE,IAAgB,EAChB,EAAE;QACF,IAAI,CAAC;YACH,MAAM,OAAO,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE;gBAC/B,IAAI,EAAE,CAAC;YACT,CAAC,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,mBAAmB,EAAE,CAAC;gBACzC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;oBACnB,KAAK,EAAE,iCAAiC;oBACxC,MAAM,EAAE,yBAAyB;iBAClC,CAAC,CAAC;YACL,CAAC;iBAAM,CAAC;gBACN,MAAM,KAAK,CAAC;YACd,CAAC;QACH,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/circuit-breaker/index.ts"],"names":[],"mappings":"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"}

package/dist/src/compliance.d.ts

@@ -1,32 +1,208 @@
 import type { ConformanceReport, FlagInput, LAFSEnvelope } from './types.js';
 import { type EnvelopeValidationResult } from './validateEnvelope.js';
+/**
+ * Identifies which stage of the compliance pipeline produced an issue.
+ *
+ * @remarks
+ * Used by {@link ComplianceIssue} to classify where a failure originated
+ * during multi-stage LAFS compliance enforcement.
+ */
 export type ComplianceStage = 'schema' | 'envelope' | 'flags' | 'format';
+/**
+ * Describes a single compliance failure detected during enforcement.
+ *
+ * @remarks
+ * Each issue maps to a specific pipeline stage and includes a human-readable
+ * message with an optional detail string for diagnostics.
+ */
 export interface ComplianceIssue {
+    /** The pipeline stage that produced this issue. */
     stage: ComplianceStage;
+    /** A short, human-readable description of the failure. */
     message: string;
+    /**
+     * Additional diagnostic information about the failure.
+     * @defaultValue undefined
+     */
     detail?: string;
 }
+/**
+ * Options controlling which compliance stages are executed.
+ *
+ * @remarks
+ * All options default to safe values so callers can pass an empty object
+ * and still get schema validation.
+ */
 export interface EnforceComplianceOptions {
+    /**
+     * Whether to run envelope conformance checks after schema validation.
+     * @defaultValue true
+     */
     checkConformance?: boolean;
+    /**
+     * Whether to run flag conformance checks.
+     * @defaultValue false
+     */
     checkFlags?: boolean;
+    /**
+     * Flag input to validate when {@link checkFlags} is enabled.
+     * @defaultValue undefined
+     */
     flags?: FlagInput;
+    /**
+     * When true, asserts that the resolved output format is JSON.
+     * @defaultValue false
+     */
     requireJsonOutput?: boolean;
 }
+/**
+ * Aggregated result of a full LAFS compliance run.
+ *
+ * @remarks
+ * Contains the overall pass/fail status, per-stage reports, and the
+ * parsed envelope when schema validation succeeds.
+ */
 export interface ComplianceResult {
+    /** True when every executed stage passes with zero issues. */
     ok: boolean;
+    /**
+     * The parsed envelope, present only when schema validation succeeds.
+     * @defaultValue undefined
+     */
     envelope?: LAFSEnvelope;
+    /** Schema validation result from the native validator (or AJV fallback). */
     validation: EnvelopeValidationResult;
+    /**
+     * Envelope conformance report, present when {@link EnforceComplianceOptions.checkConformance} is true.
+     * @defaultValue undefined
+     */
     envelopeConformance?: ConformanceReport;
+    /**
+     * Flag conformance report, present when {@link EnforceComplianceOptions.checkFlags} is true.
+     * @defaultValue undefined
+     */
     flagConformance?: ConformanceReport;
+    /** All issues collected across every executed stage. */
     issues: ComplianceIssue[];
 }
+/**
+ * Error thrown when {@link assertCompliance} or {@link withCompliance} detects failures.
+ *
+ * @remarks
+ * Extends `Error` with a structured `issues` array so callers can
+ * programmatically inspect each failure without parsing the message string.
+ *
+ * @example
+ * ```ts
+ * try {
+ *   assertCompliance(envelope);
+ * } catch (err) {
+ *   if (err instanceof ComplianceError) {
+ *     console.log(err.issues);
+ *   }
+ * }
+ * ```
+ */
 export declare class ComplianceError extends Error {
+    /** The structured list of compliance issues that caused this error. */
     readonly issues: ComplianceIssue[];
+    /**
+     * Creates a new ComplianceError from a list of issues.
+     *
+     * @param issues - The compliance issues that triggered this error.
+     */
     constructor(issues: ComplianceIssue[]);
 }
+/**
+ * Runs the full LAFS compliance pipeline against an unknown input value.
+ *
+ * @remarks
+ * Executes stages in order: schema validation, envelope conformance,
+ * flag conformance, and output-format assertion. Each stage is gated
+ * by the corresponding option. Schema validation always runs first;
+ * if it fails, later stages are skipped.
+ *
+ * @param input - The raw value to validate as a LAFS envelope.
+ * @param options - Controls which optional stages execute.
+ * @returns A {@link ComplianceResult} with the aggregate pass/fail status and per-stage reports.
+ *
+ * @example
+ * ```ts
+ * const result = enforceCompliance(rawJson, { checkFlags: true, flags: { jsonFlag: true } });
+ * if (!result.ok) {
+ *   console.error(result.issues);
+ * }
+ * ```
+ */
 export declare function enforceCompliance(input: unknown, options?: EnforceComplianceOptions): ComplianceResult;
+/**
+ * Validates input and throws {@link ComplianceError} on any failure.
+ *
+ * @remarks
+ * Thin wrapper around {@link enforceCompliance} that converts a non-ok
+ * result into an exception. Useful in pipelines where compliance is a
+ * hard gate.
+ *
+ * @param input - The raw value to validate as a LAFS envelope.
+ * @param options - Controls which optional stages execute.
+ * @returns The validated {@link LAFSEnvelope} when all stages pass.
+ * @throws {@link ComplianceError} When any compliance stage fails.
+ *
+ * @example
+ * ```ts
+ * const envelope = assertCompliance(rawJson);
+ * ```
+ */
 export declare function assertCompliance(input: unknown, options?: EnforceComplianceOptions): LAFSEnvelope;
+/**
+ * Wraps an envelope-producing function with automatic compliance enforcement.
+ *
+ * @remarks
+ * Returns a new async function that calls the producer, then pipes the
+ * result through {@link assertCompliance}. If the producer returns a
+ * non-compliant envelope, the wrapper throws {@link ComplianceError}.
+ *
+ * @typeParam TArgs - Argument types forwarded to the producer function.
+ * @typeParam TResult - The envelope subtype returned by the producer.
+ * @param producer - A sync or async function that produces a LAFS envelope.
+ * @param options - Compliance options forwarded to {@link assertCompliance}.
+ * @returns An async function with the same signature that enforces compliance on every call.
+ *
+ * @example
+ * ```ts
+ * const safeFetch = withCompliance(fetchEnvelope, { checkConformance: true });
+ * const envelope = await safeFetch('/api/data');
+ * ```
+ */
 export declare function withCompliance<TArgs extends unknown[], TResult extends LAFSEnvelope>(producer: (...args: TArgs) => TResult | Promise<TResult>, options?: EnforceComplianceOptions): (...args: TArgs) => Promise<LAFSEnvelope>;
+/**
+ * Middleware signature for intercepting LAFS envelopes in a pipeline.
+ *
+ * @remarks
+ * Follows a standard middleware pattern: receive the current envelope,
+ * call `next()` to continue the chain, then optionally transform the result.
+ *
+ * @param envelope - The envelope entering this middleware.
+ * @param next - Callback that invokes the next middleware or terminal handler.
+ * @returns The (possibly transformed) envelope to pass upstream.
+ */
 export type ComplianceMiddleware = (envelope: LAFSEnvelope, next: () => LAFSEnvelope | Promise<LAFSEnvelope>) => Promise<LAFSEnvelope> | LAFSEnvelope;
+/**
+ * Creates a {@link ComplianceMiddleware} that enforces LAFS compliance on the next handler's output.
+ *
+ * @remarks
+ * The returned middleware calls `next()`, then pipes the candidate envelope
+ * through {@link assertCompliance}. Non-compliant envelopes cause a
+ * {@link ComplianceError} to propagate.
+ *
+ * @param options - Compliance options forwarded to {@link assertCompliance}.
+ * @returns A middleware function that validates the downstream envelope.
+ *
+ * @example
+ * ```ts
+ * const mw = createComplianceMiddleware({ checkConformance: true });
+ * const result = await mw(currentEnvelope, () => produceEnvelope());
+ * ```
+ */
 export declare function createComplianceMiddleware(options?: EnforceComplianceOptions): ComplianceMiddleware;
 //# sourceMappingURL=compliance.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"compliance.d.ts","sourceRoot":"","sources":["../../src/compliance.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC7E,OAAO,EAEL,KAAK,wBAAwB,EAE9B,MAAM,uBAAuB,CAAC;AAE/B,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,UAAU,GAAG,OAAO,GAAG,QAAQ,CAAC;AAEzE,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,eAAe,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,wBAAwB;IACvC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,OAAO,CAAC;IACZ,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,UAAU,EAAE,wBAAwB,CAAC;IACrC,mBAAmB,CAAC,EAAE,iBAAiB,CAAC;IACxC,eAAe,CAAC,EAAE,iBAAiB,CAAC;IACpC,MAAM,EAAE,eAAe,EAAE,CAAC;CAC3B;AAED,qBAAa,eAAgB,SAAQ,KAAK;IACxC,QAAQ,CAAC,MAAM,EAAE,eAAe,EAAE,CAAC;gBAEvB,MAAM,EAAE,eAAe,EAAE;CAKtC;AAYD,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,OAAO,EACd,OAAO,GAAE,wBAA6B,GACrC,gBAAgB,CA2DlB;AAED,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,OAAO,EACd,OAAO,GAAE,wBAA6B,GACrC,YAAY,CAMd;AAED,wBAAgB,cAAc,CAAC,KAAK,SAAS,OAAO,EAAE,EAAE,OAAO,SAAS,YAAY,EAClF,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,EACxD,OAAO,GAAE,wBAA6B,GACrC,CAAC,GAAG,IAAI,EAAE,KAAK,KAAK,OAAO,CAAC,YAAY,CAAC,CAK3C;AAED,MAAM,MAAM,oBAAoB,GAAG,CACjC,QAAQ,EAAE,YAAY,EACtB,IAAI,EAAE,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,KAC7C,OAAO,CAAC,YAAY,CAAC,GAAG,YAAY,CAAC;AAE1C,wBAAgB,0BAA0B,CACxC,OAAO,GAAE,wBAA6B,GACrC,oBAAoB,CAKtB"}
+{"version":3,"file":"compliance.d.ts","sourceRoot":"","sources":["../../src/compliance.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC7E,OAAO,EAEL,KAAK,wBAAwB,EAE9B,MAAM,uBAAuB,CAAC;AAE/B;;;;;;GAMG;AACH,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,UAAU,GAAG,OAAO,GAAG,QAAQ,CAAC;AAEzE;;;;;;GAMG;AACH,MAAM,WAAW,eAAe;IAC9B,mDAAmD;IACnD,KAAK,EAAE,eAAe,CAAC;IACvB,0DAA0D;IAC1D,OAAO,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,wBAAwB;IACvC;;;OAGG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;OAGG;IACH,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB;;;OAGG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED;;;;;;GAMG;AACH,MAAM,WAAW,gBAAgB;IAC/B,8DAA8D;IAC9D,EAAE,EAAE,OAAO,CAAC;IACZ;;;OAGG;IACH,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,4EAA4E;IAC5E,UAAU,EAAE,wBAAwB,CAAC;IACrC;;;OAGG;IACH,mBAAmB,CAAC,EAAE,iBAAiB,CAAC;IACxC;;;OAGG;IACH,eAAe,CAAC,EAAE,iBAAiB,CAAC;IACpC,wDAAwD;IACxD,MAAM,EAAE,eAAe,EAAE,CAAC;CAC3B;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,eAAgB,SAAQ,KAAK;IACxC,uEAAuE;IACvE,QAAQ,CAAC,MAAM,EAAE,eAAe,EAAE,CAAC;IAEnC;;;;OAIG;gBACS,MAAM,EAAE,eAAe,EAAE;CAKtC;AAYD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,OAAO,EACd,OAAO,GAAE,wBAA6B,GACrC,gBAAgB,CA2DlB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,OAAO,EACd,OAAO,GAAE,wBAA6B,GACrC,YAAY,CAMd;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,cAAc,CAAC,KAAK,SAAS,OAAO,EAAE,EAAE,OAAO,SAAS,YAAY,EAClF,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,EACxD,OAAO,GAAE,wBAA6B,GACrC,CAAC,GAAG,IAAI,EAAE,KAAK,KAAK,OAAO,CAAC,YAAY,CAAC,CAK3C;AAED;;;;;;;;;;GAUG;AACH,MAAM,MAAM,oBAAoB,GAAG,CACjC,QAAQ,EAAE,YAAY,EACtB,IAAI,EAAE,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,KAC7C,OAAO,CAAC,YAAY,CAAC,GAAG,YAAY,CAAC;AAE1C;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,GAAE,wBAA6B,GACrC,oBAAoB,CAKtB"}