@autonomaai/service-utils 1.0.0

package/dist/env.d.ts

@@ -0,0 +1,7 @@
+import { ZodSchema } from 'zod';
+export interface LoadEnvOptions<T> {
+    source?: NodeJS.ProcessEnv;
+    transform?: (data: T) => T;
+}
+export declare function loadValidatedEnv<T>(schema: ZodSchema<T>, options?: LoadEnvOptions<T>): T;
+//# sourceMappingURL=env.d.ts.map

package/dist/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,KAAK,CAAC;AAEhC,MAAM,WAAW,cAAc,CAAC,CAAC;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IAC3B,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC;CAC5B;AAED,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,CAAC,CAYxF"}

package/dist/env.js

@@ -0,0 +1,12 @@
+export function loadValidatedEnv(schema, options) {
+    const source = options?.source ?? process.env;
+    const parsed = schema.safeParse(source);
+    if (!parsed.success) {
+        const issues = parsed.error.issues
+            .map((issue) => `${issue.path.join('.') || 'root'}: ${issue.message}`)
+            .join('; ');
+        throw new Error(`Invalid environment configuration: ${issues}`);
+    }
+    return options?.transform ? options.transform(parsed.data) : parsed.data;
+}
+//# sourceMappingURL=env.js.map

package/dist/env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAOA,MAAM,UAAU,gBAAgB,CAAI,MAAoB,EAAE,OAA2B;IACnF,MAAM,MAAM,GAAG,OAAO,EAAE,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC;IAC9C,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAExC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM;aAC/B,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,MAAM,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC;aACrE,IAAI,CAAC,IAAI,CAAC,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,sCAAsC,MAAM,EAAE,CAAC,CAAC;IAClE,CAAC;IAED,OAAO,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC;AAC3E,CAAC"}

package/dist/fastify.d.ts

@@ -0,0 +1,15 @@
+import { FastifyInstance } from 'fastify';
+export interface RequestMetricsOptions {
+    logLevel?: 'info' | 'debug';
+}
+export declare function applyRequestMetricsHooks(app: FastifyInstance, options?: RequestMetricsOptions): void;
+export interface ErrorHandlerOptions {
+    exposeStack?: boolean;
+}
+export declare function attachGlobalErrorHandler(app: FastifyInstance, options?: ErrorHandlerOptions): void;
+export interface ShutdownHook {
+    name: string;
+    close: () => Promise<void> | void;
+}
+export declare function registerGracefulShutdown(app: FastifyInstance, hooks?: ShutdownHook[]): void;
+//# sourceMappingURL=fastify.d.ts.map

package/dist/fastify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fastify.d.ts","sourceRoot":"","sources":["../src/fastify.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAgC,MAAM,SAAS,CAAC;AAIxE,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CAC7B;AAED,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,eAAe,EAAE,OAAO,CAAC,EAAE,qBAAqB,QAqB7F;AAED,MAAM,WAAW,mBAAmB;IAClC,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,eAAe,EAAE,OAAO,CAAC,EAAE,mBAAmB,QAiB3F;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACnC;AAED,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,eAAe,EAAE,KAAK,GAAE,YAAY,EAAO,QAiBxF"}

package/dist/fastify.js

@@ -0,0 +1,57 @@
+const START_TIME = Symbol('requestStartTime');
+export function applyRequestMetricsHooks(app, options) {
+    const level = options?.logLevel ?? 'info';
+    app.addHook('onRequest', (request, _reply, done) => {
+        request[START_TIME] = process.hrtime.bigint();
+        done();
+    });
+    app.addHook('onResponse', (request, reply, done) => {
+        const started = request[START_TIME];
+        const durationMs = started ? Number((process.hrtime.bigint() - started) / BigInt(1e6)) : 0;
+        reply.header('X-Response-Time', `${durationMs}ms`);
+        app.log[level]({
+            method: request.method,
+            url: request.url,
+            statusCode: reply.statusCode,
+            duration: `${durationMs}ms`,
+            ip: request.ip
+        }, 'request completed');
+        done();
+    });
+}
+export function attachGlobalErrorHandler(app, options) {
+    app.setErrorHandler((error, request, reply) => {
+        app.log.error({
+            error: error.message,
+            stack: options?.exposeStack ? error.stack : undefined,
+            method: request.method,
+            url: request.url
+        }, 'request error');
+        const statusCode = error.statusCode ?? 500;
+        reply.status(statusCode).send({
+            error: {
+                message: statusCode === 500 ? 'Internal Server Error' : error.message,
+                statusCode
+            }
+        });
+    });
+}
+export function registerGracefulShutdown(app, hooks = []) {
+    const shutdown = async (signal) => {
+        app.log.warn({ signal }, 'received shutdown signal');
+        for (const hook of hooks) {
+            try {
+                await hook.close();
+                app.log.info({ resource: hook.name }, 'resource closed');
+            }
+            catch (error) {
+                app.log.error({ resource: hook.name, error }, 'failed to close resource');
+            }
+        }
+        await app.close();
+        process.exit(0);
+    };
+    process.once('SIGINT', shutdown);
+    process.once('SIGTERM', shutdown);
+}
+//# sourceMappingURL=fastify.js.map

package/dist/fastify.js.map

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

package/dist/health.d.ts

@@ -0,0 +1,17 @@
+export type HealthStatus = 'healthy' | 'degraded' | 'critical';
+export interface HealthHandlerOptions {
+    serviceName: string;
+    version?: string;
+    build?: string;
+    getStatus?: () => Promise<HealthStatus> | HealthStatus;
+    getDetails?: () => Promise<Record<string, unknown>> | Record<string, unknown>;
+}
+export declare function createHealthHandler(options: HealthHandlerOptions): () => Promise<{
+    details?: Record<string, unknown> | undefined;
+    status: HealthStatus;
+    service: string;
+    version: string;
+    build: string | undefined;
+    timestamp: string;
+}>;
+//# sourceMappingURL=health.d.ts.map

package/dist/health.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../src/health.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,UAAU,GAAG,UAAU,CAAC;AAE/D,MAAM,WAAW,oBAAoB;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,OAAO,CAAC,YAAY,CAAC,GAAG,YAAY,CAAC;IACvD,UAAU,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/E;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,oBAAoB;;;;;;;GAchE"}

package/dist/health.js

@@ -0,0 +1,15 @@
+export function createHealthHandler(options) {
+    return async () => {
+        const status = options.getStatus ? await options.getStatus() : 'healthy';
+        const details = options.getDetails ? await options.getDetails() : undefined;
+        return {
+            status,
+            service: options.serviceName,
+            version: options.version ?? '1.0.0',
+            build: options.build,
+            timestamp: new Date().toISOString(),
+            ...(details ? { details } : {})
+        };
+    };
+}
+//# sourceMappingURL=health.js.map

package/dist/health.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.js","sourceRoot":"","sources":["../src/health.ts"],"names":[],"mappings":"AAUA,MAAM,UAAU,mBAAmB,CAAC,OAA6B;IAC/D,OAAO,KAAK,IAAI,EAAE;QAChB,MAAM,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;QACzE,MAAM,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,MAAM,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;QAE5E,OAAO;YACL,MAAM;YACN,OAAO,EAAE,OAAO,CAAC,WAAW;YAC5B,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,OAAO;YACnC,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAChC,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export * from './logger.js';
+export * from './env.js';
+export * from './health.js';
+export * from './fastify.js';
+export * from './resilience/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,uBAAuB,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+export * from './logger.js';
+export * from './env.js';
+export * from './health.js';
+export * from './fastify.js';
+export * from './resilience/index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,uBAAuB,CAAC"}

package/dist/logger.d.ts

@@ -0,0 +1,8 @@
+import { Logger } from 'pino';
+export interface ServiceLoggerOptions {
+    serviceName: string;
+    level?: string;
+    pretty?: boolean;
+}
+export declare function createServiceLogger(options: ServiceLoggerOptions): Logger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA,OAAa,EAAE,MAAM,EAAiB,MAAM,MAAM,CAAC;AAEnD,MAAM,WAAW,oBAAoB;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,oBAAoB,GAAG,MAAM,CAsBzE"}

package/dist/logger.js

@@ -0,0 +1,22 @@
+import pino from 'pino';
+export function createServiceLogger(options) {
+    const isProduction = process.env.NODE_ENV === 'production';
+    const enablePretty = typeof options.pretty === 'boolean' ? options.pretty : !isProduction;
+    const baseOptions = {
+        level: options.level ?? process.env.LOG_LEVEL ?? 'info',
+        base: {
+            service: options.serviceName
+        }
+    };
+    if (enablePretty) {
+        baseOptions.transport = {
+            target: 'pino-pretty',
+            options: {
+                colorize: true,
+                singleLine: true
+            }
+        };
+    }
+    return pino(baseOptions);
+}
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA,OAAO,IAA+B,MAAM,MAAM,CAAC;AAQnD,MAAM,UAAU,mBAAmB,CAAC,OAA6B;IAC/D,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY,CAAC;IAC3D,MAAM,YAAY,GAAG,OAAO,OAAO,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC;IAE1F,MAAM,WAAW,GAAkB;QACjC,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,MAAM;QACvD,IAAI,EAAE;YACJ,OAAO,EAAE,OAAO,CAAC,WAAW;SAC7B;KACF,CAAC;IAEF,IAAI,YAAY,EAAE,CAAC;QACjB,WAAW,CAAC,SAAS,GAAG;YACtB,MAAM,EAAE,aAAa;YACrB,OAAO,EAAE;gBACP,QAAQ,EAAE,IAAI;gBACd,UAAU,EAAE,IAAI;aACjB;SACF,CAAC;IACJ,CAAC;IAED,OAAO,IAAI,CAAC,WAAW,CAAC,CAAC;AAC3B,CAAC"}

package/dist/resilience/bulkhead.d.ts

@@ -0,0 +1,95 @@
+/**
+ * Bulkhead Pattern
+ *
+ * Isolates failures by limiting concurrent executions.
+ * Prevents resource exhaustion by queuing excess requests.
+ *
+ * @example
+ * ```typescript
+ * const bulkhead = new Bulkhead({
+ *   name: 'trading-operations',
+ *   maxConcurrent: 10,
+ *   maxQueued: 100,
+ *   queueTimeout: 5000
+ * });
+ *
+ * try {
+ *   const result = await bulkhead.execute(() => executeTrade());
+ * } catch (error) {
+ *   if (error instanceof BulkheadFullError) {
+ *     // Handle overload
+ *   }
+ * }
+ * ```
+ */
+import { BulkheadConfig } from './types.js';
+/**
+ * Bulkhead implementation for isolating concurrent executions
+ */
+export declare class Bulkhead {
+    private static instances;
+    private readonly config;
+    private activeCalls;
+    private queue;
+    private stats;
+    constructor(config: Partial<BulkheadConfig> & {
+        name: string;
+    });
+    /**
+     * Execute a function through the bulkhead
+     */
+    execute<T>(fn: () => Promise<T>): Promise<T>;
+    /**
+     * Get bulkhead statistics
+     */
+    getStats(): {
+        currentActive: number;
+        currentQueued: number;
+        totalCalls: number;
+        successfulCalls: number;
+        failedCalls: number;
+        rejectedCalls: number;
+        timedOutCalls: number;
+    };
+    /**
+     * Get current utilization (0-1)
+     */
+    getUtilization(): number;
+    /**
+     * Get queue fill level (0-1)
+     */
+    getQueueFillLevel(): number;
+    /**
+     * Run execution immediately
+     */
+    private runExecution;
+    /**
+     * Queue execution for later
+     */
+    private queueExecution;
+    /**
+     * Process queued items when capacity becomes available
+     */
+    private processQueue;
+    /**
+     * Get stats for all bulkheads
+     */
+    static getAllStats(): Map<string, ReturnType<Bulkhead['getStats']>>;
+    /**
+     * Get a bulkhead by name
+     */
+    static get(name: string): Bulkhead | undefined;
+}
+/**
+ * Decorator to apply bulkhead to a method
+ */
+export declare function withBulkhead(config: Partial<BulkheadConfig> & {
+    name: string;
+}): <T extends (...args: any[]) => Promise<any>>(target: any, propertyKey: string, descriptor: TypedPropertyDescriptor<T>) => TypedPropertyDescriptor<T>;
+/**
+ * Create a bulkhead wrapper function
+ */
+export declare function createBulkhead(config: Partial<BulkheadConfig> & {
+    name: string;
+}): <T>(fn: () => Promise<T>) => Promise<T>;
+//# sourceMappingURL=bulkhead.d.ts.map

package/dist/resilience/bulkhead.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bulkhead.d.ts","sourceRoot":"","sources":["../../src/resilience/bulkhead.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,EAAE,cAAc,EAAqB,MAAM,YAAY,CAAC;AAe/D;;GAEG;AACH,qBAAa,QAAQ;IACnB,OAAO,CAAC,MAAM,CAAC,SAAS,CAAoC;IAE5D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoC;IAC3D,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,KAAK,CAA8B;IAE3C,OAAO,CAAC,KAAK,CAQX;gBAEU,MAAM,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE;IAK9D;;OAEG;IACG,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAmBlD;;OAEG;IACH,QAAQ;;;;;;;;;IAQR;;OAEG;IACH,cAAc,IAAI,MAAM;IAIxB;;OAEG;IACH,iBAAiB,IAAI,MAAM;IAI3B;;OAEG;YACW,YAAY;IAkB1B;;OAEG;IACH,OAAO,CAAC,cAAc;IAkBtB;;OAEG;IACH,OAAO,CAAC,YAAY;IAepB;;OAEG;IACH,MAAM,CAAC,WAAW,IAAI,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC;IAQnE;;OAEG;IACH,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS;CAG/C;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,IAG5D,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,GAAG,CAAC,EACzD,QAAQ,GAAG,EACX,aAAa,MAAM,EACnB,YAAY,uBAAuB,CAAC,CAAC,CAAC,gCAUzC;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GACjD,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAGzC"}

package/dist/resilience/bulkhead.js

@@ -0,0 +1,186 @@
+/**
+ * Bulkhead Pattern
+ *
+ * Isolates failures by limiting concurrent executions.
+ * Prevents resource exhaustion by queuing excess requests.
+ *
+ * @example
+ * ```typescript
+ * const bulkhead = new Bulkhead({
+ *   name: 'trading-operations',
+ *   maxConcurrent: 10,
+ *   maxQueued: 100,
+ *   queueTimeout: 5000
+ * });
+ *
+ * try {
+ *   const result = await bulkhead.execute(() => executeTrade());
+ * } catch (error) {
+ *   if (error instanceof BulkheadFullError) {
+ *     // Handle overload
+ *   }
+ * }
+ * ```
+ */
+import { BulkheadFullError } from './types.js';
+const DEFAULT_CONFIG = {
+    maxConcurrent: 10,
+    maxQueued: 100,
+    queueTimeout: 5000
+};
+/**
+ * Bulkhead implementation for isolating concurrent executions
+ */
+export class Bulkhead {
+    static instances = new Map();
+    config;
+    activeCalls = 0;
+    queue = [];
+    stats = {
+        totalCalls: 0,
+        successfulCalls: 0,
+        failedCalls: 0,
+        rejectedCalls: 0,
+        timedOutCalls: 0,
+        currentActive: 0,
+        currentQueued: 0
+    };
+    constructor(config) {
+        this.config = { ...DEFAULT_CONFIG, ...config };
+        Bulkhead.instances.set(this.config.name, this);
+    }
+    /**
+     * Execute a function through the bulkhead
+     */
+    async execute(fn) {
+        this.stats.totalCalls++;
+        // Check if we can execute immediately
+        if (this.activeCalls < this.config.maxConcurrent) {
+            return this.runExecution(fn);
+        }
+        // Check if queue is full
+        if (this.queue.length >= this.config.maxQueued) {
+            this.stats.rejectedCalls++;
+            this.config.onReject?.();
+            throw new BulkheadFullError(this.config.name);
+        }
+        // Add to queue
+        return this.queueExecution(fn);
+    }
+    /**
+     * Get bulkhead statistics
+     */
+    getStats() {
+        return {
+            ...this.stats,
+            currentActive: this.activeCalls,
+            currentQueued: this.queue.length
+        };
+    }
+    /**
+     * Get current utilization (0-1)
+     */
+    getUtilization() {
+        return this.activeCalls / this.config.maxConcurrent;
+    }
+    /**
+     * Get queue fill level (0-1)
+     */
+    getQueueFillLevel() {
+        return this.queue.length / this.config.maxQueued;
+    }
+    /**
+     * Run execution immediately
+     */
+    async runExecution(fn) {
+        this.activeCalls++;
+        this.stats.currentActive = this.activeCalls;
+        try {
+            const result = await fn();
+            this.stats.successfulCalls++;
+            return result;
+        }
+        catch (error) {
+            this.stats.failedCalls++;
+            throw error;
+        }
+        finally {
+            this.activeCalls--;
+            this.stats.currentActive = this.activeCalls;
+            this.processQueue();
+        }
+    }
+    /**
+     * Queue execution for later
+     */
+    queueExecution(fn) {
+        return new Promise((resolve, reject) => {
+            const timeout = setTimeout(() => {
+                // Remove from queue
+                const index = this.queue.findIndex(item => item.timeout === timeout);
+                if (index !== -1) {
+                    this.queue.splice(index, 1);
+                    this.stats.currentQueued = this.queue.length;
+                    this.stats.timedOutCalls++;
+                    reject(new Error(`Bulkhead queue timeout after ${this.config.queueTimeout}ms`));
+                }
+            }, this.config.queueTimeout);
+            this.queue.push({ fn, resolve, reject, timeout });
+            this.stats.currentQueued = this.queue.length;
+        });
+    }
+    /**
+     * Process queued items when capacity becomes available
+     */
+    processQueue() {
+        if (this.queue.length === 0)
+            return;
+        if (this.activeCalls >= this.config.maxConcurrent)
+            return;
+        const item = this.queue.shift();
+        if (!item)
+            return;
+        this.stats.currentQueued = this.queue.length;
+        clearTimeout(item.timeout);
+        this.runExecution(item.fn)
+            .then(item.resolve)
+            .catch(item.reject);
+    }
+    /**
+     * Get stats for all bulkheads
+     */
+    static getAllStats() {
+        const stats = new Map();
+        for (const [name, bulkhead] of this.instances) {
+            stats.set(name, bulkhead.getStats());
+        }
+        return stats;
+    }
+    /**
+     * Get a bulkhead by name
+     */
+    static get(name) {
+        return this.instances.get(name);
+    }
+}
+/**
+ * Decorator to apply bulkhead to a method
+ */
+export function withBulkhead(config) {
+    const bulkhead = new Bulkhead(config);
+    return function (target, propertyKey, descriptor) {
+        const originalMethod = descriptor.value;
+        descriptor.value = async function (...args) {
+            return bulkhead.execute(() => originalMethod.apply(this, args));
+        };
+        return descriptor;
+    };
+}
+/**
+ * Create a bulkhead wrapper function
+ */
+export function createBulkhead(config) {
+    const bulkhead = new Bulkhead(config);
+    return (fn) => bulkhead.execute(fn);
+}
+//# sourceMappingURL=bulkhead.js.map

package/dist/resilience/bulkhead.js.map

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

package/dist/resilience/circuit-breaker.d.ts

@@ -0,0 +1,111 @@
+/**
+ * Circuit Breaker Pattern
+ *
+ * Prevents cascading failures by failing fast when a service is down.
+ * After a threshold of failures, the circuit opens and rejects requests
+ * for a recovery period before allowing test requests through.
+ *
+ * States:
+ * - CLOSED: Normal operation, requests flow through
+ * - OPEN: Service is down, fail immediately
+ * - HALF_OPEN: Testing if service recovered
+ *
+ * @example
+ * ```typescript
+ * const breaker = new CircuitBreaker({
+ *   name: 'exchange-api',
+ *   failureThreshold: 5,
+ *   recoveryTimeout: 30000,
+ *   halfOpenMaxCalls: 3
+ * });
+ *
+ * try {
+ *   const result = await breaker.execute(() => fetchData());
+ * } catch (error) {
+ *   if (error instanceof CircuitBreakerOpenError) {
+ *     // Use fallback
+ *     return getCachedData();
+ *   }
+ *   throw error;
+ * }
+ * ```
+ */
+import { CircuitState, CircuitBreakerConfig, CircuitBreakerStats } from './types.js';
+/**
+ * Circuit Breaker implementation
+ */
+export declare class CircuitBreaker {
+    private static instances;
+    private readonly config;
+    private state;
+    private failureCount;
+    private successCount;
+    private lastFailureTime?;
+    private halfOpenCalls;
+    private stats;
+    constructor(config: Partial<CircuitBreakerConfig> & {
+        name: string;
+    });
+    /**
+     * Get current circuit state
+     */
+    getState(): CircuitState;
+    /**
+     * Get circuit breaker statistics
+     */
+    getStats(): CircuitBreakerStats;
+    /**
+     * Execute a function through the circuit breaker
+     */
+    execute<T>(fn: () => Promise<T>): Promise<T>;
+    /**
+     * Manually reset the circuit breaker
+     */
+    reset(): void;
+    /**
+     * Check if recovery should be attempted
+     */
+    private shouldAttemptRecovery;
+    /**
+     * Handle successful execution
+     */
+    private onSuccess;
+    /**
+     * Handle failed execution
+     */
+    private onFailure;
+    /**
+     * Transition to a new state
+     */
+    private transitionTo;
+    /**
+     * Check if error should be excluded from failure count
+     */
+    private isExcludedError;
+    /**
+     * Lock mechanism using a promise-based queue for atomic operations
+     */
+    private lockQueue;
+    private acquireLock;
+    /**
+     * Get stats for all circuit breakers (for monitoring)
+     */
+    static getAllStats(): Map<string, CircuitBreakerStats>;
+    /**
+     * Get a circuit breaker by name
+     */
+    static get(name: string): CircuitBreaker | undefined;
+}
+/**
+ * Decorator to apply circuit breaker to a method
+ */
+export declare function withCircuitBreaker(config: Partial<CircuitBreakerConfig> & {
+    name: string;
+}): <T extends (...args: any[]) => Promise<any>>(target: any, propertyKey: string, descriptor: TypedPropertyDescriptor<T>) => TypedPropertyDescriptor<T>;
+/**
+ * Create a circuit breaker wrapper function
+ */
+export declare function createCircuitBreaker(config: Partial<CircuitBreakerConfig> & {
+    name: string;
+}): <T>(fn: () => Promise<T>) => Promise<T>;
+//# sourceMappingURL=circuit-breaker.d.ts.map

package/dist/resilience/circuit-breaker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"circuit-breaker.d.ts","sourceRoot":"","sources":["../../src/resilience/circuit-breaker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,OAAO,EACL,YAAY,EACZ,oBAAoB,EACpB,mBAAmB,EAEpB,MAAM,YAAY,CAAC;AAUpB;;GAEG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAC,SAAS,CAA0C;IAElE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuB;IAC9C,OAAO,CAAC,KAAK,CAAqC;IAClD,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,eAAe,CAAC,CAAS;IACjC,OAAO,CAAC,aAAa,CAAK;IAE1B,OAAO,CAAC,KAAK,CAMX;gBAEU,MAAM,EAAE,OAAO,CAAC,oBAAoB,CAAC,GAAG;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE;IAKpE;;OAEG;IACH,QAAQ,IAAI,YAAY;IAUxB;;OAEG;IACH,QAAQ,IAAI,mBAAmB;IAO/B;;OAEG;IACG,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAwClD;;OAEG;IACH,KAAK,IAAI,IAAI;IASb;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAK7B;;OAEG;YACW,SAAS;IAkBvB;;OAEG;YACW,SAAS;IAuBvB;;OAEG;IACH,OAAO,CAAC,YAAY;IAmBpB;;OAEG;IACH,OAAO,CAAC,eAAe;IAOvB;;OAEG;IACH,OAAO,CAAC,SAAS,CAAoC;YAEvC,WAAW;IAUzB;;OAEG;IACH,MAAM,CAAC,WAAW,IAAI,GAAG,CAAC,MAAM,EAAE,mBAAmB,CAAC;IAQtD;;OAEG;IACH,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;CAGrD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,OAAO,CAAC,oBAAoB,CAAC,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,IAGxE,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,GAAG,CAAC,EACzD,QAAQ,GAAG,EACX,aAAa,MAAM,EACnB,YAAY,uBAAuB,CAAC,CAAC,CAAC,gCAUzC;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,OAAO,CAAC,oBAAoB,CAAC,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GACvD,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAGzC"}