airbag 0.1.0

package/dist/index.mjs

@@ -0,0 +1,353 @@
+// src/errors.ts
+var AirbagError = class extends Error {
+  constructor(message, code, context, options) {
+    super(message, options);
+    this.name = "AirbagError";
+    this.code = code;
+    this.context = context;
+    Object.setPrototypeOf(this, new.target.prototype);
+  }
+};
+var TimeoutError = class extends AirbagError {
+  constructor(context, timeout) {
+    super(
+      `"${context.functionName}" timed out after ${timeout}ms`,
+      "TIMEOUT",
+      context
+    );
+    this.name = "TimeoutError";
+    this.timeout = timeout;
+  }
+};
+var RetryExhaustedError = class extends AirbagError {
+  constructor(context, cause) {
+    super(
+      `"${context.functionName}" failed after ${context.maxAttempts} attempt(s): ${cause.message}`,
+      "RETRY_EXHAUSTED",
+      context,
+      { cause }
+    );
+    this.name = "RetryExhaustedError";
+  }
+};
+var CircuitOpenError = class extends AirbagError {
+  constructor(context) {
+    super(
+      `Circuit breaker is open for "${context.functionName}"`,
+      "CIRCUIT_OPEN",
+      context
+    );
+    this.name = "CircuitOpenError";
+  }
+};
+var AbortError = class extends AirbagError {
+  constructor(context) {
+    super(
+      `Execution of "${context.functionName}" was aborted`,
+      "ABORTED",
+      context
+    );
+    this.name = "AbortError";
+  }
+};
+
+// src/config.ts
+var DEFAULTS = {
+  name: "anonymous",
+  adapter: {},
+  retry: {
+    count: 0,
+    backoff: "exponential",
+    baseDelay: 1e3,
+    maxDelay: 3e4,
+    jitter: true
+  },
+  timeout: 3e4,
+  circuitBreaker: {
+    enabled: false,
+    threshold: 5,
+    resetTimeout: 6e4
+  }
+};
+function resolveConfig(...layers) {
+  const resolved = {
+    name: DEFAULTS.name,
+    adapter: { ...DEFAULTS.adapter },
+    retry: { ...DEFAULTS.retry },
+    timeout: DEFAULTS.timeout,
+    circuitBreaker: { ...DEFAULTS.circuitBreaker }
+  };
+  for (const layer of layers) {
+    if (!layer) continue;
+    if (layer.name !== void 0) resolved.name = layer.name;
+    if (layer.timeout !== void 0) resolved.timeout = layer.timeout;
+    if (layer.signal !== void 0) resolved.signal = layer.signal;
+    const flatAdapter = {};
+    if (layer.onLoading) flatAdapter.onLoading = layer.onLoading;
+    if (layer.onSuccess) flatAdapter.onSuccess = layer.onSuccess;
+    if (layer.onError) flatAdapter.onError = layer.onError;
+    if (layer.onRetry) flatAdapter.onRetry = layer.onRetry;
+    if (layer.onFinish) flatAdapter.onFinish = layer.onFinish;
+    resolved.adapter = { ...resolved.adapter, ...flatAdapter, ...layer.adapter ?? {} };
+    if (layer.retries !== void 0) {
+      resolved.retry = { ...resolved.retry, count: layer.retries };
+    }
+    if (layer.retry) {
+      resolved.retry = { ...resolved.retry, ...layer.retry };
+    }
+    if (layer.circuitBreaker) {
+      resolved.circuitBreaker = { ...resolved.circuitBreaker, ...layer.circuitBreaker };
+    }
+  }
+  return resolved;
+}
+
+// src/circuit-breaker.ts
+function createCircuitBreaker(config) {
+  let state = "closed";
+  let failureCount = 0;
+  let lastFailureTime = 0;
+  return {
+    canExecute() {
+      if (!config.enabled) return true;
+      if (state === "closed") return true;
+      if (state === "open") {
+        const elapsed = Date.now() - lastFailureTime;
+        if (elapsed >= config.resetTimeout) {
+          state = "half-open";
+          return true;
+        }
+        return false;
+      }
+      return true;
+    },
+    recordSuccess() {
+      if (!config.enabled) return;
+      if (state === "half-open") {
+        state = "closed";
+        failureCount = 0;
+      }
+    },
+    recordFailure() {
+      if (!config.enabled) return;
+      failureCount++;
+      lastFailureTime = Date.now();
+      if (state === "half-open" || failureCount >= config.threshold) {
+        state = "open";
+      }
+    },
+    getState() {
+      return state;
+    },
+    reset() {
+      state = "closed";
+      failureCount = 0;
+      lastFailureTime = 0;
+    }
+  };
+}
+
+// src/utils.ts
+var InternalTimeoutError = class _InternalTimeoutError extends Error {
+  constructor(ms) {
+    super(`Timed out after ${ms}ms`);
+    this.name = "InternalTimeoutError";
+    this.ms = ms;
+    Object.setPrototypeOf(this, _InternalTimeoutError.prototype);
+  }
+};
+var InternalAbortError = class _InternalAbortError extends Error {
+  constructor() {
+    super("Operation aborted");
+    this.name = "InternalAbortError";
+    Object.setPrototypeOf(this, _InternalAbortError.prototype);
+  }
+};
+function toError(value) {
+  if (value instanceof Error) return value;
+  if (typeof value === "string") return new Error(value);
+  return new Error(String(value));
+}
+function buildContext(functionName, startTime, attempt, maxAttempts) {
+  return {
+    functionName,
+    duration: Date.now() - startTime,
+    timestamp: Date.now(),
+    attempt,
+    maxAttempts
+  };
+}
+function calculateDelay(attemptIndex, config) {
+  let delay;
+  switch (config.backoff) {
+    case "exponential":
+      delay = config.baseDelay * Math.pow(2, attemptIndex);
+      break;
+    case "linear":
+      delay = config.baseDelay * (attemptIndex + 1);
+      break;
+    case "fixed":
+      delay = config.baseDelay;
+      break;
+  }
+  if (config.jitter) {
+    delay = delay * (0.5 + Math.random() * 0.5);
+  }
+  return Math.min(delay, config.maxDelay);
+}
+function wait(ms, signal) {
+  return new Promise((resolve, reject) => {
+    if (signal?.aborted) {
+      reject(new InternalAbortError());
+      return;
+    }
+    const timer = setTimeout(resolve, ms);
+    const onAbort = () => {
+      clearTimeout(timer);
+      reject(new InternalAbortError());
+    };
+    signal?.addEventListener("abort", onAbort, { once: true });
+  });
+}
+function withTimeout(promise, ms, signal) {
+  if (ms <= 0 || !Number.isFinite(ms)) return promise;
+  return new Promise((resolve, reject) => {
+    let settled = false;
+    if (signal?.aborted) {
+      reject(new InternalAbortError());
+      return;
+    }
+    const timer = setTimeout(() => {
+      if (!settled) {
+        settled = true;
+        reject(new InternalTimeoutError(ms));
+      }
+    }, ms);
+    const onAbort = () => {
+      if (!settled) {
+        settled = true;
+        clearTimeout(timer);
+        reject(new InternalAbortError());
+      }
+    };
+    signal?.addEventListener("abort", onAbort, { once: true });
+    promise.then(
+      (value) => {
+        if (!settled) {
+          settled = true;
+          clearTimeout(timer);
+          signal?.removeEventListener("abort", onAbort);
+          resolve(value);
+        }
+      },
+      (error) => {
+        if (!settled) {
+          settled = true;
+          clearTimeout(timer);
+          signal?.removeEventListener("abort", onAbort);
+          reject(error);
+        }
+      }
+    );
+  });
+}
+function safeInvoke(fn, args) {
+  return new Promise((resolve, reject) => {
+    Promise.resolve().then(() => fn(...args)).then(resolve, reject);
+  });
+}
+function settle(promise) {
+  return promise.then((value) => ({ ok: true, value })).catch((error) => ({ ok: false, error: toError(error) }));
+}
+
+// src/airbag.ts
+function emitSuccess(config, ctx, value) {
+  config.adapter.onSuccess?.(value, ctx);
+  config.adapter.onLoading?.(false, ctx);
+  config.adapter.onFinish?.(ctx);
+  return value;
+}
+function emitFailure(config, ctx, error) {
+  config.adapter.onError?.(error, ctx);
+  config.adapter.onLoading?.(false, ctx);
+  config.adapter.onFinish?.(ctx);
+  throw error;
+}
+async function execute(fn, args, config, breaker) {
+  const startTime = Date.now();
+  const maxAttempts = Math.max(1, config.retry.count + 1);
+  const getContext = (attempt) => buildContext(config.name, startTime, attempt, maxAttempts);
+  if (!breaker.canExecute()) {
+    const ctx2 = getContext(0);
+    throw new CircuitOpenError(ctx2);
+  }
+  config.adapter.onLoading?.(true, getContext(0));
+  let lastError = new Error("No attempts executed");
+  let lastAttempt = 0;
+  for (let attempt = 0; attempt < maxAttempts; attempt++) {
+    lastAttempt = attempt;
+    if (attempt > 0) {
+      config.adapter.onRetry?.(attempt, lastError, getContext(attempt));
+      const delayed = await settle(
+        wait(calculateDelay(attempt - 1, config.retry), config.signal)
+      );
+      if (!delayed.ok) {
+        const ctx2 = getContext(attempt);
+        return emitFailure(config, ctx2, new AbortError(ctx2));
+      }
+    }
+    const result = await settle(
+      withTimeout(safeInvoke(fn, args), config.timeout, config.signal)
+    );
+    if (result.ok) {
+      breaker.recordSuccess();
+      return emitSuccess(config, getContext(attempt), result.value);
+    }
+    if (result.error instanceof InternalAbortError) {
+      const ctx2 = getContext(attempt);
+      return emitFailure(config, ctx2, new AbortError(ctx2));
+    }
+    lastError = result.error;
+  }
+  breaker.recordFailure();
+  const ctx = getContext(lastAttempt);
+  const finalError = lastError instanceof InternalTimeoutError ? new TimeoutError(ctx, config.timeout) : new RetryExhaustedError(ctx, lastError);
+  return emitFailure(config, ctx, finalError);
+}
+function createWrapped(fn, optionLayers, sharedBreaker) {
+  const config = resolveConfig(...optionLayers);
+  const breaker = sharedBreaker ?? createCircuitBreaker(config.circuitBreaker);
+  const wrapped = ((...args) => execute(fn, args, config, breaker));
+  wrapped.with = (overrides) => createWrapped(fn, [...optionLayers, overrides], breaker);
+  wrapped.reset = () => breaker.reset();
+  return wrapped;
+}
+function airbag(fn, options) {
+  return createWrapped(fn, [options]);
+}
+
+// src/instance.ts
+function createAirbagInstance(globalOptions) {
+  let globals = { ...globalOptions };
+  return {
+    wrap(fn, options) {
+      return createWrapped(fn, [globals, options]);
+    },
+    configure(options) {
+      globals = { ...globals, ...options };
+    },
+    getDefaults() {
+      return resolveConfig(globals);
+    }
+  };
+}
+export {
+  AbortError,
+  AirbagError,
+  CircuitOpenError,
+  RetryExhaustedError,
+  TimeoutError,
+  airbag,
+  createAirbagInstance
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/errors.ts","../src/config.ts","../src/circuit-breaker.ts","../src/utils.ts","../src/airbag.ts","../src/instance.ts"],"sourcesContent":["import type { AirbagErrorCode, ExecutionContext } from './interfaces';\r\n\r\nexport class AirbagError extends Error {\r\n  readonly code: AirbagErrorCode;\r\n  readonly context: ExecutionContext;\r\n\r\n  constructor(\r\n    message: string,\r\n    code: AirbagErrorCode,\r\n    context: ExecutionContext,\r\n    options?: { cause?: Error }\r\n  ) {\r\n    super(message, options);\r\n    this.name = 'AirbagError';\r\n    this.code = code;\r\n    this.context = context;\r\n    Object.setPrototypeOf(this, new.target.prototype);\r\n  }\r\n}\r\n\r\nexport class TimeoutError extends AirbagError {\r\n  readonly timeout: number;\r\n\r\n  constructor(context: ExecutionContext, timeout: number) {\r\n    super(\r\n      `\"${context.functionName}\" timed out after ${timeout}ms`,\r\n      'TIMEOUT',\r\n      context\r\n    );\r\n    this.name = 'TimeoutError';\r\n    this.timeout = timeout;\r\n  }\r\n}\r\n\r\nexport class RetryExhaustedError extends AirbagError {\r\n  constructor(context: ExecutionContext, cause: Error) {\r\n    super(\r\n      `\"${context.functionName}\" failed after ${context.maxAttempts} attempt(s): ${cause.message}`,\r\n      'RETRY_EXHAUSTED',\r\n      context,\r\n      { cause }\r\n    );\r\n    this.name = 'RetryExhaustedError';\r\n  }\r\n}\r\n\r\nexport class CircuitOpenError extends AirbagError {\r\n  constructor(context: ExecutionContext) {\r\n    super(\r\n      `Circuit breaker is open for \"${context.functionName}\"`,\r\n      'CIRCUIT_OPEN',\r\n      context\r\n    );\r\n    this.name = 'CircuitOpenError';\r\n  }\r\n}\r\n\r\nexport class AbortError extends AirbagError {\r\n  constructor(context: ExecutionContext) {\r\n    super(\r\n      `Execution of \"${context.functionName}\" was aborted`,\r\n      'ABORTED',\r\n      context\r\n    );\r\n    this.name = 'AbortError';\r\n  }\r\n}\r\n","import type { AirbagAdapter, AirbagOptions, AirbagResolvedConfig } from './interfaces';\n\nconst DEFAULTS: AirbagResolvedConfig = {\n  name: 'anonymous',\n  adapter: {},\n  retry: {\n    count: 0,\n    backoff: 'exponential',\n    baseDelay: 1000,\n    maxDelay: 30_000,\n    jitter: true,\n  },\n  timeout: 30_000,\n  circuitBreaker: {\n    enabled: false,\n    threshold: 5,\n    resetTimeout: 60_000,\n  },\n};\n\nexport function resolveConfig<TReturn>(\n  ...layers: Array<AirbagOptions<TReturn> | undefined>\n): AirbagResolvedConfig<TReturn> {\n  const resolved: AirbagResolvedConfig<TReturn> = {\n    name: DEFAULTS.name,\n    adapter: { ...DEFAULTS.adapter } as AirbagResolvedConfig<TReturn>['adapter'],\n    retry: { ...DEFAULTS.retry },\n    timeout: DEFAULTS.timeout,\n    circuitBreaker: { ...DEFAULTS.circuitBreaker },\n  };\n\n  for (const layer of layers) {\n    if (!layer) continue;\n\n    if (layer.name !== undefined) resolved.name = layer.name;\n    if (layer.timeout !== undefined) resolved.timeout = layer.timeout;\n    if (layer.signal !== undefined) resolved.signal = layer.signal;\n\n    const flatAdapter: Partial<AirbagAdapter<TReturn>> = {};\n    if (layer.onLoading) flatAdapter.onLoading = layer.onLoading;\n    if (layer.onSuccess) flatAdapter.onSuccess = layer.onSuccess;\n    if (layer.onError) flatAdapter.onError = layer.onError;\n    if (layer.onRetry) flatAdapter.onRetry = layer.onRetry;\n    if (layer.onFinish) flatAdapter.onFinish = layer.onFinish;\n\n    resolved.adapter = { ...resolved.adapter, ...flatAdapter, ...(layer.adapter ?? {}) };\n\n    if (layer.retries !== undefined) {\n      resolved.retry = { ...resolved.retry, count: layer.retries };\n    }\n\n    if (layer.retry) {\n      resolved.retry = { ...resolved.retry, ...layer.retry };\n    }\n\n    if (layer.circuitBreaker) {\n      resolved.circuitBreaker = { ...resolved.circuitBreaker, ...layer.circuitBreaker };\n    }\n  }\n\n  return resolved;\n}\n","import type { CircuitBreakerConfig, CircuitBreakerState, CircuitBreakerInstance } from './interfaces';\r\n\r\nexport function createCircuitBreaker(config: CircuitBreakerConfig): CircuitBreakerInstance {\r\n  let state: CircuitBreakerState = 'closed';\r\n  let failureCount = 0;\r\n  let lastFailureTime = 0;\r\n\r\n  return {\r\n    canExecute(): boolean {\r\n      if (!config.enabled) return true;\r\n      if (state === 'closed') return true;\r\n\r\n      if (state === 'open') {\r\n        const elapsed = Date.now() - lastFailureTime;\r\n        if (elapsed >= config.resetTimeout) {\r\n          state = 'half-open';\r\n          return true;\r\n        }\r\n        return false;\r\n      }\r\n\r\n      return true;\r\n    },\r\n\r\n    recordSuccess(): void {\r\n      if (!config.enabled) return;\r\n      if (state === 'half-open') {\r\n        state = 'closed';\r\n        failureCount = 0;\r\n      }\r\n    },\r\n\r\n    recordFailure(): void {\r\n      if (!config.enabled) return;\r\n      failureCount++;\r\n      lastFailureTime = Date.now();\r\n      if (state === 'half-open' || failureCount >= config.threshold) {\r\n        state = 'open';\r\n      }\r\n    },\r\n\r\n    getState(): CircuitBreakerState {\r\n      return state;\r\n    },\r\n\r\n    reset(): void {\r\n      state = 'closed';\r\n      failureCount = 0;\r\n      lastFailureTime = 0;\r\n    },\r\n  };\r\n}\r\n","import type { RetryConfig, ExecutionContext, Result } from './interfaces';\r\n\r\nexport class InternalTimeoutError extends Error {\r\n  readonly ms: number;\r\n\r\n  constructor(ms: number) {\r\n    super(`Timed out after ${ms}ms`);\r\n    this.name = 'InternalTimeoutError';\r\n    this.ms = ms;\r\n    Object.setPrototypeOf(this, InternalTimeoutError.prototype);\r\n  }\r\n}\r\n\r\nexport class InternalAbortError extends Error {\r\n  constructor() {\r\n    super('Operation aborted');\r\n    this.name = 'InternalAbortError';\r\n    Object.setPrototypeOf(this, InternalAbortError.prototype);\r\n  }\r\n}\r\n\r\nexport function toError(value: unknown): Error {\r\n  if (value instanceof Error) return value;\r\n  if (typeof value === 'string') return new Error(value);\r\n  return new Error(String(value));\r\n}\r\n\r\nexport function buildContext(\r\n  functionName: string,\r\n  startTime: number,\r\n  attempt: number,\r\n  maxAttempts: number\r\n): ExecutionContext {\r\n  return {\r\n    functionName,\r\n    duration: Date.now() - startTime,\r\n    timestamp: Date.now(),\r\n    attempt,\r\n    maxAttempts,\r\n  };\r\n}\r\n\r\nexport function calculateDelay(attemptIndex: number, config: RetryConfig): number {\r\n  let delay: number;\r\n\r\n  switch (config.backoff) {\r\n    case 'exponential':\r\n      delay = config.baseDelay * Math.pow(2, attemptIndex);\r\n      break;\r\n    case 'linear':\r\n      delay = config.baseDelay * (attemptIndex + 1);\r\n      break;\r\n    case 'fixed':\r\n      delay = config.baseDelay;\r\n      break;\r\n  }\r\n\r\n  if (config.jitter) {\r\n    delay = delay * (0.5 + Math.random() * 0.5);\r\n  }\r\n\r\n  return Math.min(delay, config.maxDelay);\r\n}\r\n\r\nexport function wait(ms: number, signal?: AbortSignal): Promise<void> {\r\n  return new Promise<void>((resolve, reject) => {\r\n    if (signal?.aborted) {\r\n      reject(new InternalAbortError());\r\n      return;\r\n    }\r\n\r\n    const timer = setTimeout(resolve, ms);\r\n\r\n    const onAbort = () => {\r\n      clearTimeout(timer);\r\n      reject(new InternalAbortError());\r\n    };\r\n\r\n    signal?.addEventListener('abort', onAbort, { once: true });\r\n  });\r\n}\r\n\r\nexport function withTimeout<T>(\r\n  promise: Promise<T>,\r\n  ms: number,\r\n  signal?: AbortSignal\r\n): Promise<T> {\r\n  if (ms <= 0 || !Number.isFinite(ms)) return promise;\r\n\r\n  return new Promise<T>((resolve, reject) => {\r\n    let settled = false;\r\n\r\n    if (signal?.aborted) {\r\n      reject(new InternalAbortError());\r\n      return;\r\n    }\r\n\r\n    const timer = setTimeout(() => {\r\n      if (!settled) {\r\n        settled = true;\r\n        reject(new InternalTimeoutError(ms));\r\n      }\r\n    }, ms);\r\n\r\n    const onAbort = () => {\r\n      if (!settled) {\r\n        settled = true;\r\n        clearTimeout(timer);\r\n        reject(new InternalAbortError());\r\n      }\r\n    };\r\n\r\n    signal?.addEventListener('abort', onAbort, { once: true });\r\n\r\n    promise.then(\r\n      (value) => {\r\n        if (!settled) {\r\n          settled = true;\r\n          clearTimeout(timer);\r\n          signal?.removeEventListener('abort', onAbort);\r\n          resolve(value);\r\n        }\r\n      },\r\n      (error) => {\r\n        if (!settled) {\r\n          settled = true;\r\n          clearTimeout(timer);\r\n          signal?.removeEventListener('abort', onAbort);\r\n          reject(error);\r\n        }\r\n      }\r\n    );\r\n  });\r\n}\r\n\r\n/**\r\n * Safely invokes an async function, converting synchronous throws\r\n * into promise rejections so they can be handled uniformly.\r\n */\r\nexport function safeInvoke<TArgs extends unknown[], TReturn>(\r\n  fn: (...args: TArgs) => Promise<TReturn>,\r\n  args: TArgs\r\n): Promise<TReturn> {\r\n  return new Promise<TReturn>((resolve, reject) => {\r\n    Promise.resolve()\r\n      .then(() => fn(...args))\r\n      .then(resolve, reject);\r\n  });\r\n}\r\n\r\n/**\r\n * Wraps a promise into a discriminated Result union,\r\n * guaranteeing the promise never rejects.\r\n */\r\nexport function settle<T>(promise: Promise<T>): Promise<Result<T>> {\r\n  return promise\r\n    .then((value): Result<T> => ({ ok: true, value }))\r\n    .catch((error): Result<T> => ({ ok: false, error: toError(error) }));\r\n}\r\n","import type {\r\n  AirbagOptions,\r\n  AirbagResolvedConfig,\r\n  CircuitBreakerInstance,\r\n  ExecutionContext,\r\n  WrappedFunction,\r\n} from './interfaces';\r\nimport { AirbagError, TimeoutError, RetryExhaustedError, CircuitOpenError, AbortError } from './errors';\r\nimport { resolveConfig } from './config';\r\nimport { createCircuitBreaker } from './circuit-breaker';\r\nimport {\r\n  InternalTimeoutError,\r\n  InternalAbortError,\r\n  buildContext,\r\n  calculateDelay,\r\n  wait,\r\n  withTimeout,\r\n  safeInvoke,\r\n  settle,\r\n} from './utils';\r\n\r\nfunction emitSuccess<TReturn>(\r\n  config: AirbagResolvedConfig<TReturn>,\r\n  ctx: ExecutionContext,\r\n  value: TReturn\r\n): TReturn {\r\n  config.adapter.onSuccess?.(value, ctx);\r\n  config.adapter.onLoading?.(false, ctx);\r\n  config.adapter.onFinish?.(ctx);\r\n  return value;\r\n}\r\n\r\nfunction emitFailure<TReturn>(\r\n  config: AirbagResolvedConfig<TReturn>,\r\n  ctx: ExecutionContext,\r\n  error: AirbagError\r\n): never {\r\n  config.adapter.onError?.(error, ctx);\r\n  config.adapter.onLoading?.(false, ctx);\r\n  config.adapter.onFinish?.(ctx);\r\n  throw error;\r\n}\r\n\r\nasync function execute<TArgs extends unknown[], TReturn>(\r\n  fn: (...args: TArgs) => Promise<TReturn>,\r\n  args: TArgs,\r\n  config: AirbagResolvedConfig<TReturn>,\r\n  breaker: CircuitBreakerInstance\r\n): Promise<TReturn> {\r\n  const startTime = Date.now();\r\n  const maxAttempts = Math.max(1, config.retry.count + 1);\r\n  const getContext = (attempt: number): ExecutionContext =>\r\n    buildContext(config.name, startTime, attempt, maxAttempts);\r\n\r\n  if (!breaker.canExecute()) {\r\n    const ctx = getContext(0);\r\n    throw new CircuitOpenError(ctx);\r\n  }\r\n\r\n  config.adapter.onLoading?.(true, getContext(0));\r\n\r\n  let lastError: Error = new Error('No attempts executed');\r\n  let lastAttempt = 0;\r\n\r\n  for (let attempt = 0; attempt < maxAttempts; attempt++) {\r\n    lastAttempt = attempt;\r\n\r\n    if (attempt > 0) {\r\n      config.adapter.onRetry?.(attempt, lastError, getContext(attempt));\r\n\r\n      const delayed = await settle(\r\n        wait(calculateDelay(attempt - 1, config.retry), config.signal)\r\n      );\r\n\r\n      if (!delayed.ok) {\r\n        const ctx = getContext(attempt);\r\n        return emitFailure(config, ctx, new AbortError(ctx));\r\n      }\r\n    }\r\n\r\n    const result = await settle(\r\n      withTimeout(safeInvoke(fn, args), config.timeout, config.signal)\r\n    );\r\n\r\n    if (result.ok) {\r\n      breaker.recordSuccess();\r\n      return emitSuccess(config, getContext(attempt), result.value);\r\n    }\r\n\r\n    if (result.error instanceof InternalAbortError) {\r\n      const ctx = getContext(attempt);\r\n      return emitFailure(config, ctx, new AbortError(ctx));\r\n    }\r\n\r\n    lastError = result.error;\r\n  }\r\n\r\n  breaker.recordFailure();\r\n  const ctx = getContext(lastAttempt);\r\n\r\n  const finalError = lastError instanceof InternalTimeoutError\r\n    ? new TimeoutError(ctx, config.timeout)\r\n    : new RetryExhaustedError(ctx, lastError);\r\n\r\n  return emitFailure(config, ctx, finalError);\r\n}\r\n\r\nexport function createWrapped<TArgs extends unknown[], TReturn>(\r\n  fn: (...args: TArgs) => Promise<TReturn>,\r\n  optionLayers: Array<AirbagOptions<TReturn> | undefined>,\r\n  sharedBreaker?: CircuitBreakerInstance\r\n): WrappedFunction<TArgs, TReturn> {\r\n  const config = resolveConfig<TReturn>(...optionLayers);\r\n  const breaker = sharedBreaker ?? createCircuitBreaker(config.circuitBreaker);\r\n\r\n  const wrapped = ((...args: TArgs): Promise<TReturn> =>\r\n    execute(fn, args, config, breaker)\r\n  ) as WrappedFunction<TArgs, TReturn>;\r\n\r\n  wrapped.with = (overrides: AirbagOptions<TReturn>): WrappedFunction<TArgs, TReturn> =>\r\n    createWrapped(fn, [...optionLayers, overrides], breaker);\r\n\r\n  wrapped.reset = (): void => breaker.reset();\r\n\r\n  return wrapped;\r\n}\r\n\r\n/**\r\n * Wraps an async function with execution orchestration.\r\n *\r\n * The returned function has the same signature as the original but adds:\r\n * - Automatic loading state management\r\n * - Configurable retries with exponential backoff\r\n * - Timeout enforcement\r\n * - Circuit breaker protection\r\n * - Structured error reporting via adapters\r\n *\r\n * @typeParam TArgs - Tuple of the original function's parameter types\r\n * @typeParam TReturn - The resolved type of the original function's promise\r\n *\r\n * @example\r\n * ```ts\r\n * const safeFetch = airbag(fetchUser, {\r\n *   name: 'fetchUser',\r\n *   timeout: 5000,\r\n *   retry: { count: 3 },\r\n *   adapter: {\r\n *     onError: (err) => toast.error(err.message),\r\n *   },\r\n * });\r\n *\r\n * const user = await safeFetch('user-123');\r\n * ```\r\n */\r\nexport function airbag<TArgs extends unknown[], TReturn>(\r\n  fn: (...args: TArgs) => Promise<TReturn>,\r\n  options?: AirbagOptions<TReturn>\r\n): WrappedFunction<TArgs, TReturn> {\r\n  return createWrapped(fn, [options]);\r\n}\r\n","import type { AirbagInstance, AirbagOptions, AirbagResolvedConfig, WrappedFunction } from './interfaces';\r\nimport { resolveConfig } from './config';\r\nimport { createWrapped } from './airbag';\r\n\r\n/**\r\n * Creates a pre-configured airbag instance with shared global defaults.\r\n *\r\n * All functions wrapped through this instance inherit the global options\r\n * before applying their own instance-level and execution-level overrides.\r\n *\r\n * @example\r\n * ```ts\r\n * const { wrap } = createAirbagInstance({\r\n *   retry: { count: 3 },\r\n *   adapter: {\r\n *     onError: (err) => logger.error(err),\r\n *   },\r\n * });\r\n *\r\n * const safeFetch = wrap(fetchUser, { timeout: 5000 });\r\n * const user = await safeFetch('user-123');\r\n * ```\r\n */\r\nexport function createAirbagInstance(globalOptions?: AirbagOptions): AirbagInstance {\r\n  let globals: AirbagOptions = { ...globalOptions };\r\n\r\n  return {\r\n    wrap<TArgs extends unknown[], TReturn>(\r\n      fn: (...args: TArgs) => Promise<TReturn>,\r\n      options?: AirbagOptions<TReturn>\r\n    ): WrappedFunction<TArgs, TReturn> {\r\n      return createWrapped(fn, [globals as AirbagOptions<TReturn>, options]);\r\n    },\r\n\r\n    configure(options: AirbagOptions): void {\r\n      globals = { ...globals, ...options };\r\n    },\r\n\r\n    getDefaults(): AirbagResolvedConfig {\r\n      return resolveConfig(globals);\r\n    },\r\n  };\r\n}\r\n"],"mappings":"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","names":["ctx"]}

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "airbag",
+  "version": "0.1.0",
+  "description": "Execution Orchestration Layer for JavaScript/TypeScript — declarative async function wrapping with retries, timeouts, and circuit breaking",
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.mts",
+        "default": "./dist/index.mjs"
+      },
+      "require": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      }
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "error-handling",
+    "retry",
+    "timeout",
+    "circuit-breaker",
+    "async",
+    "promise",
+    "typescript",
+    "try-catch",
+    "orchestration"
+  ],
+  "license": "MIT",
+  "devDependencies": {
+    "tsup": "^8.0.0",
+    "typescript": "^5.3.0"
+  },
+  "engines": {
+    "node": ">=16"
+  }
+}