@gwash3189/fusebox 0.0.0-stage → 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 gwash3189
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,65 @@
-# Temporary Holding Version
+# @gwash3189/fusebox
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+A fluent, zero-dependency TypeScript circuit breaker library with sliding failure windows, cooldown recovery, fallbacks, and lifecycle event hooks.
+
+## Installation
+
+```bash
+npm install @gwash3189/fusebox
+```
+
+## Usage
+
+```ts
+import Breaker from '@gwash3189/fusebox'
+
+const result = await Breaker.for('stripe-api')
+  .threshold({ failures: 5, within: 10_000 })
+  .cooldown(30_000)
+  .fallback(() => ({ cached: true }))
+  .work(async () => {
+    return await fetchStripeCustomer(id)
+  })
+  .on('open', (err, key) => {
+    console.warn(`Circuit ${key} opened due to:`, err)
+  })
+  .on('half-open', (key) => {
+    console.info(`Testing downstream recovery for ${key}`)
+  })
+  .on('close', (key) => {
+    console.info(`Circuit ${key} recovered and closed`)
+  })
+```
+
+## Circuit States
+
+1. **`closed`**: Normal operation. Requests pass through to `.work()`. Failures are tracked within the configured `within` time window (or consecutively if `within` is omitted).
+2. **`open`**: When failures reach `threshold`, the circuit trips to `open` for the duration of `cooldown` ms. Calls fail fast with `CircuitOpenError` (or invoke `.fallback()` if configured) without calling `.work()`.
+3. **`half-open`**: Once `cooldown` has elapsed, the next call is allowed through as a single probe:
+   - If the probe succeeds, the circuit transitions back to **`closed`**.
+   - If the probe fails, the circuit immediately re-opens for another `cooldown` period.
+   - Concurrent calls while the probe is in flight fail fast.
+
+## API
+
+- `Breaker.for(key: string)` / `Breaker.key(key: string)`: Select or create the circuit breaker state for `key`.
+- `.threshold(failures: number | { failures: number, within?: number })`: Number of failures required to trip the circuit (default: `5`).
+- `.cooldown(ms: number)`: Duration in milliseconds the circuit stays open before allowing a half-open probe (default: `30_000`).
+- `.fallback(fn: (error: unknown) => Promise<T> | T)`: Fallback function invoked when `.work()` fails or when the circuit is open.
+- `.work(fn: () => Promise<T> | T)`: The protected operation to execute.
+- `.on('open' | 'close' | 'half-open' | 'failure' | 'reject', handler)`: Subscribe to circuit lifecycle events.
+- `.state`: Inspect the current state (`'closed' | 'open' | 'half-open'`) of the circuit.
+- `.reset()` / `resetCircuits()`: Reset a specific circuit or all circuits back to `'closed'`.
+
+## Development
+
+```bash
+npm test           # Run tests with Vitest
+npm run lint       # Run linter with Oxlint
+npm run type-check # Run TypeScript type checker
+npm run build      # Build ESM + CJS bundles with tsdown
+```
+
+## License
+
+MIT

package/dist/index.cjs

@@ -0,0 +1,229 @@
+Object.defineProperties(exports, { __esModule: { value: true }, [Symbol.toStringTag]: { value: 'Module' } });
+// src/errors.ts
+var FuseboxError = class extends Error {
+	constructor(message) {
+		super(message);
+		this.name = "FuseboxError";
+		Object.setPrototypeOf(this, new.target.prototype);
+	}
+};
+var CircuitOpenError = class extends FuseboxError {
+	key;
+	remainingCooldownMs;
+	constructor(key, remainingCooldownMs) {
+		super(`Circuit breaker "${key}" is open. Cooldown remaining: ${Math.max(0, remainingCooldownMs)}ms`);
+		this.name = "CircuitOpenError";
+		this.key = key;
+		this.remainingCooldownMs = Math.max(0, remainingCooldownMs);
+	}
+};
+
+// src/breaker.ts
+const circuits = /* @__PURE__ */ new Map();
+function getOrCreateCircuit(key) {
+	let entry = circuits.get(key);
+	if (!entry) {
+		entry = {
+			state: "closed",
+			failureTimestamps: [],
+			openedAt: null,
+			halfOpenInFlight: false
+		};
+		circuits.set(key, entry);
+	}
+	return entry;
+}
+var BreakerBuilder = class BreakerBuilder {
+	config;
+	executionPromise;
+	constructor(config) {
+		this.config = {
+			key: config?.key ?? "default",
+			failures: config?.failures ?? 5,
+			withinMs: config?.withinMs,
+			cooldownMs: config?.cooldownMs ?? 3e4,
+			workFn: config?.workFn,
+			fallbackFn: config?.fallbackFn,
+			openHandlers: [...config?.openHandlers ?? []],
+			closeHandlers: [...config?.closeHandlers ?? []],
+			halfOpenHandlers: [...config?.halfOpenHandlers ?? []],
+			failureHandlers: [...config?.failureHandlers ?? []],
+			rejectHandlers: [...config?.rejectHandlers ?? []]
+		};
+	}
+	for(key) {
+		if (!key || key.trim().length === 0) throw new RangeError("circuit key must be a non-empty string");
+		return new BreakerBuilder({
+			...this.config,
+			key
+		});
+	}
+	key(key) {
+		return this.for(key);
+	}
+	threshold(options) {
+		if (typeof options === "number") {
+			if (!Number.isInteger(options) || options < 1) throw new RangeError("failures threshold must be an integer of at least 1");
+			return new BreakerBuilder({
+				...this.config,
+				failures: options,
+				withinMs: void 0
+			});
+		}
+		if (!Number.isInteger(options.failures) || options.failures < 1) throw new RangeError("failures threshold must be an integer of at least 1");
+		if (options.within !== void 0 && options.within <= 0) throw new RangeError("within window must be a positive number");
+		return new BreakerBuilder({
+			...this.config,
+			failures: options.failures,
+			withinMs: options.within
+		});
+	}
+	cooldown(ms) {
+		if (ms < 0) throw new RangeError("cooldown must be a non-negative number");
+		return new BreakerBuilder({
+			...this.config,
+			cooldownMs: ms
+		});
+	}
+	fallback(fn) {
+		return new BreakerBuilder({
+			...this.config,
+			fallbackFn: fn
+		});
+	}
+	work(fn) {
+		return new BreakerBuilder({
+			...this.config,
+			workFn: fn
+		});
+	}
+	on(event, handler) {
+		switch (event) {
+			case "open": return new BreakerBuilder({
+				...this.config,
+				openHandlers: [...this.config.openHandlers, handler]
+			});
+			case "close": return new BreakerBuilder({
+				...this.config,
+				closeHandlers: [...this.config.closeHandlers, handler]
+			});
+			case "half-open": return new BreakerBuilder({
+				...this.config,
+				halfOpenHandlers: [...this.config.halfOpenHandlers, handler]
+			});
+			case "failure": return new BreakerBuilder({
+				...this.config,
+				failureHandlers: [...this.config.failureHandlers, handler]
+			});
+			case "reject": return new BreakerBuilder({
+				...this.config,
+				rejectHandlers: [...this.config.rejectHandlers, handler]
+			});
+		}
+	}
+	get state() {
+		const entry = getOrCreateCircuit(this.config.key);
+		if (entry.state === "open" && entry.openedAt !== null) {
+			if (Date.now() - entry.openedAt >= this.config.cooldownMs) return "half-open";
+		}
+		return entry.state;
+	}
+	reset(key) {
+		circuits.delete(key ?? this.config.key);
+	}
+	resetAll() {
+		circuits.clear();
+	}
+	then(onfulfilled, onrejected) {
+		if (!this.executionPromise) this.executionPromise = this.execute();
+		return this.executionPromise.then(onfulfilled, onrejected);
+	}
+	catch(onrejected) {
+		return this.then(void 0, onrejected);
+	}
+	finally(onfinally) {
+		return this.then((value) => {
+			onfinally?.();
+			return value;
+		}, (reason) => {
+			onfinally?.();
+			throw reason;
+		});
+	}
+	async execute() {
+		const { key, failures, withinMs, cooldownMs, workFn, fallbackFn, openHandlers, closeHandlers, halfOpenHandlers, failureHandlers, rejectHandlers } = this.config;
+		if (!workFn) throw new Error("No work function provided. Call .work(fn) before awaiting.");
+		const entry = getOrCreateCircuit(key);
+		const now = Date.now();
+		if (entry.state === "open") {
+			const elapsed = entry.openedAt !== null ? now - entry.openedAt : cooldownMs;
+			if (elapsed >= cooldownMs) {
+				entry.state = "half-open";
+				entry.halfOpenInFlight = false;
+				for (const handler of halfOpenHandlers) await handler(key);
+			} else {
+				const openError = new CircuitOpenError(key, cooldownMs - elapsed);
+				for (const handler of rejectHandlers) await handler(openError, key);
+				if (fallbackFn) return await fallbackFn(openError);
+				throw openError;
+			}
+		}
+		if (entry.state === "half-open") {
+			if (entry.halfOpenInFlight) {
+				const openError = new CircuitOpenError(key, cooldownMs);
+				for (const handler of rejectHandlers) await handler(openError, key);
+				if (fallbackFn) return await fallbackFn(openError);
+				throw openError;
+			}
+			entry.halfOpenInFlight = true;
+		}
+		try {
+			const result = await workFn();
+			if (entry.state === "half-open") {
+				entry.state = "closed";
+				entry.failureTimestamps = [];
+				entry.openedAt = null;
+				entry.halfOpenInFlight = false;
+				for (const handler of closeHandlers) await handler(key);
+			} else if (withinMs === void 0) entry.failureTimestamps = [];
+			return result;
+		} catch (error) {
+			for (const handler of failureHandlers) await handler(error, key);
+			const failTime = Date.now();
+			if (entry.state === "half-open") {
+				entry.state = "open";
+				entry.openedAt = failTime;
+				entry.halfOpenInFlight = false;
+				entry.failureTimestamps = [failTime];
+				for (const handler of openHandlers) await handler(error, key);
+			} else {
+				if (withinMs !== void 0) {
+					const cutoff = failTime - withinMs;
+					entry.failureTimestamps = entry.failureTimestamps.filter((t) => t >= cutoff);
+				}
+				entry.failureTimestamps.push(failTime);
+				if (entry.failureTimestamps.length >= failures) {
+					entry.state = "open";
+					entry.openedAt = failTime;
+					for (const handler of openHandlers) await handler(error, key);
+				}
+			}
+			if (fallbackFn) return await fallbackFn(error);
+			throw error;
+		}
+	}
+};
+const Breaker = new BreakerBuilder();
+const Fusebox = Breaker;
+function resetCircuits() {
+	circuits.clear();
+}
+
+exports.Breaker = Breaker;
+exports.BreakerBuilder = BreakerBuilder;
+exports.CircuitOpenError = CircuitOpenError;
+exports.Fusebox = Fusebox;
+exports.FuseboxError = FuseboxError;
+exports.default = Breaker;
+exports.resetCircuits = resetCircuits;
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":[],"sources":["../src/errors.ts","../src/breaker.ts"],"sourcesContent":["export class FuseboxError extends Error {\n  constructor(message: string) {\n    super(message)\n    this.name = 'FuseboxError'\n    Object.setPrototypeOf(this, new.target.prototype)\n  }\n}\n\nexport class CircuitOpenError extends FuseboxError {\n  readonly key: string\n  readonly remainingCooldownMs: number\n\n  constructor(key: string, remainingCooldownMs: number) {\n    super(\n      `Circuit breaker \"${key}\" is open. Cooldown remaining: ${Math.max(0, remainingCooldownMs)}ms`\n    )\n    this.name = 'CircuitOpenError'\n    this.key = key\n    this.remainingCooldownMs = Math.max(0, remainingCooldownMs)\n  }\n}\n","import { CircuitOpenError } from './errors'\n\nexport type CircuitState = 'closed' | 'open' | 'half-open'\n\nexport interface ThresholdConfig {\n  failures: number\n  within?: number\n}\n\nexport type BreakerEvent = 'open' | 'close' | 'half-open' | 'failure' | 'reject'\n\nexport type OpenHandler = (error: unknown, key: string) => void | Promise<void>\nexport type CloseHandler = (key: string) => void | Promise<void>\nexport type HalfOpenHandler = (key: string) => void | Promise<void>\nexport type FailureHandler = (error: unknown, key: string) => void | Promise<void>\nexport type RejectHandler = (error: CircuitOpenError, key: string) => void | Promise<void>\n\nexport type FallbackFn<T = unknown> = (error: unknown) => Promise<T> | T\nexport type WorkFn<T = unknown> = () => Promise<T> | T\n\ninterface CircuitEntry {\n  state: CircuitState\n  failureTimestamps: number[]\n  openedAt: number | null\n  halfOpenInFlight: boolean\n}\n\nconst circuits = new Map<string, CircuitEntry>()\n\nfunction getOrCreateCircuit(key: string): CircuitEntry {\n  let entry = circuits.get(key)\n  if (!entry) {\n    entry = {\n      state: 'closed',\n      failureTimestamps: [],\n      openedAt: null,\n      halfOpenInFlight: false,\n    }\n    circuits.set(key, entry)\n  }\n  return entry\n}\n\ninterface BreakerConfig<T = unknown> {\n  key: string\n  failures: number\n  withinMs?: number\n  cooldownMs: number\n  workFn?: WorkFn<T>\n  fallbackFn?: FallbackFn<T>\n  openHandlers: OpenHandler[]\n  closeHandlers: CloseHandler[]\n  halfOpenHandlers: HalfOpenHandler[]\n  failureHandlers: FailureHandler[]\n  rejectHandlers: RejectHandler[]\n}\n\nexport class BreakerBuilder<T = unknown> implements PromiseLike<T> {\n  private readonly config: BreakerConfig<T>\n  private executionPromise?: Promise<T>\n\n  constructor(config?: Partial<BreakerConfig<T>>) {\n    this.config = {\n      key: config?.key ?? 'default',\n      failures: config?.failures ?? 5,\n      withinMs: config?.withinMs,\n      cooldownMs: config?.cooldownMs ?? 30_000,\n      workFn: config?.workFn,\n      fallbackFn: config?.fallbackFn,\n      openHandlers: [...(config?.openHandlers ?? [])],\n      closeHandlers: [...(config?.closeHandlers ?? [])],\n      halfOpenHandlers: [...(config?.halfOpenHandlers ?? [])],\n      failureHandlers: [...(config?.failureHandlers ?? [])],\n      rejectHandlers: [...(config?.rejectHandlers ?? [])],\n    }\n  }\n\n  for(key: string): BreakerBuilder<T> {\n    if (!key || key.trim().length === 0) {\n      throw new RangeError('circuit key must be a non-empty string')\n    }\n    return new BreakerBuilder<T>({ ...this.config, key })\n  }\n\n  key(key: string): BreakerBuilder<T> {\n    return this.for(key)\n  }\n\n  threshold(options: ThresholdConfig | number): BreakerBuilder<T> {\n    if (typeof options === 'number') {\n      if (!Number.isInteger(options) || options < 1) {\n        throw new RangeError('failures threshold must be an integer of at least 1')\n      }\n      return new BreakerBuilder<T>({ ...this.config, failures: options, withinMs: undefined })\n    }\n\n    if (!Number.isInteger(options.failures) || options.failures < 1) {\n      throw new RangeError('failures threshold must be an integer of at least 1')\n    }\n    if (options.within !== undefined && options.within <= 0) {\n      throw new RangeError('within window must be a positive number')\n    }\n\n    return new BreakerBuilder<T>({\n      ...this.config,\n      failures: options.failures,\n      withinMs: options.within,\n    })\n  }\n\n  cooldown(ms: number): BreakerBuilder<T> {\n    if (ms < 0) {\n      throw new RangeError('cooldown must be a non-negative number')\n    }\n    return new BreakerBuilder<T>({ ...this.config, cooldownMs: ms })\n  }\n\n  fallback<R = T>(fn: FallbackFn<R>): BreakerBuilder<T | R> {\n    return new BreakerBuilder<T | R>({\n      ...(this.config as unknown as BreakerConfig<T | R>),\n      fallbackFn: fn,\n    })\n  }\n\n  work<R>(fn: WorkFn<R>): BreakerBuilder<R> {\n    return new BreakerBuilder<R>({\n      ...(this.config as unknown as BreakerConfig<R>),\n      workFn: fn,\n    })\n  }\n\n  on(event: 'open', handler: OpenHandler): BreakerBuilder<T>\n  on(event: 'close', handler: CloseHandler): BreakerBuilder<T>\n  on(event: 'half-open', handler: HalfOpenHandler): BreakerBuilder<T>\n  on(event: 'failure', handler: FailureHandler): BreakerBuilder<T>\n  on(event: 'reject', handler: RejectHandler): BreakerBuilder<T>\n  on(\n    event: BreakerEvent,\n    handler: OpenHandler | CloseHandler | HalfOpenHandler | FailureHandler | RejectHandler\n  ): BreakerBuilder<T> {\n    switch (event) {\n      case 'open':\n        return new BreakerBuilder<T>({\n          ...this.config,\n          openHandlers: [...this.config.openHandlers, handler as OpenHandler],\n        })\n      case 'close':\n        return new BreakerBuilder<T>({\n          ...this.config,\n          closeHandlers: [...this.config.closeHandlers, handler as CloseHandler],\n        })\n      case 'half-open':\n        return new BreakerBuilder<T>({\n          ...this.config,\n          halfOpenHandlers: [...this.config.halfOpenHandlers, handler as HalfOpenHandler],\n        })\n      case 'failure':\n        return new BreakerBuilder<T>({\n          ...this.config,\n          failureHandlers: [...this.config.failureHandlers, handler as FailureHandler],\n        })\n      case 'reject':\n        return new BreakerBuilder<T>({\n          ...this.config,\n          rejectHandlers: [...this.config.rejectHandlers, handler as RejectHandler],\n        })\n    }\n  }\n\n  get state(): CircuitState {\n    const entry = getOrCreateCircuit(this.config.key)\n    if (entry.state === 'open' && entry.openedAt !== null) {\n      const elapsed = Date.now() - entry.openedAt\n      if (elapsed >= this.config.cooldownMs) {\n        return 'half-open'\n      }\n    }\n    return entry.state\n  }\n\n  reset(key?: string): void {\n    circuits.delete(key ?? this.config.key)\n  }\n\n  resetAll(): void {\n    circuits.clear()\n  }\n\n  then<TResult1 = T, TResult2 = never>(\n    onfulfilled?: ((value: T) => TResult1 | PromiseLike<TResult1>) | null | undefined,\n    onrejected?: ((reason: unknown) => TResult2 | PromiseLike<TResult2>) | null | undefined\n  ): Promise<TResult1 | TResult2> {\n    if (!this.executionPromise) {\n      this.executionPromise = this.execute()\n    }\n    return this.executionPromise.then(onfulfilled, onrejected)\n  }\n\n  catch<TResult = never>(\n    onrejected?: ((reason: unknown) => TResult | PromiseLike<TResult>) | null | undefined\n  ): Promise<T | TResult> {\n    return this.then(undefined, onrejected)\n  }\n\n  finally(onfinally?: (() => void) | null | undefined): Promise<T> {\n    return this.then(\n      (value) => {\n        onfinally?.()\n        return value\n      },\n      (reason) => {\n        onfinally?.()\n        throw reason\n      }\n    )\n  }\n\n  private async execute(): Promise<T> {\n    const {\n      key,\n      failures,\n      withinMs,\n      cooldownMs,\n      workFn,\n      fallbackFn,\n      openHandlers,\n      closeHandlers,\n      halfOpenHandlers,\n      failureHandlers,\n      rejectHandlers,\n    } = this.config\n\n    if (!workFn) {\n      throw new Error('No work function provided. Call .work(fn) before awaiting.')\n    }\n\n    const entry = getOrCreateCircuit(key)\n    const now = Date.now()\n\n    if (entry.state === 'open') {\n      const elapsed = entry.openedAt !== null ? now - entry.openedAt : cooldownMs\n      if (elapsed >= cooldownMs) {\n        entry.state = 'half-open'\n        entry.halfOpenInFlight = false\n        for (const handler of halfOpenHandlers) {\n          await handler(key)\n        }\n      } else {\n        const openError = new CircuitOpenError(key, cooldownMs - elapsed)\n        for (const handler of rejectHandlers) {\n          await handler(openError, key)\n        }\n        if (fallbackFn) {\n          return await fallbackFn(openError)\n        }\n        throw openError\n      }\n    }\n\n    if (entry.state === 'half-open') {\n      if (entry.halfOpenInFlight) {\n        const openError = new CircuitOpenError(key, cooldownMs)\n        for (const handler of rejectHandlers) {\n          await handler(openError, key)\n        }\n        if (fallbackFn) {\n          return await fallbackFn(openError)\n        }\n        throw openError\n      }\n      entry.halfOpenInFlight = true\n    }\n\n    try {\n      const result = await workFn()\n\n      if (entry.state === 'half-open') {\n        entry.state = 'closed'\n        entry.failureTimestamps = []\n        entry.openedAt = null\n        entry.halfOpenInFlight = false\n        for (const handler of closeHandlers) {\n          await handler(key)\n        }\n      } else if (withinMs === undefined) {\n        entry.failureTimestamps = []\n      }\n\n      return result\n    } catch (error) {\n      for (const handler of failureHandlers) {\n        await handler(error, key)\n      }\n\n      const failTime = Date.now()\n\n      if (entry.state === 'half-open') {\n        entry.state = 'open'\n        entry.openedAt = failTime\n        entry.halfOpenInFlight = false\n        entry.failureTimestamps = [failTime]\n        for (const handler of openHandlers) {\n          await handler(error, key)\n        }\n      } else {\n        if (withinMs !== undefined) {\n          const cutoff = failTime - withinMs\n          entry.failureTimestamps = entry.failureTimestamps.filter((t) => t >= cutoff)\n        }\n        entry.failureTimestamps.push(failTime)\n\n        if (entry.failureTimestamps.length >= failures) {\n          entry.state = 'open'\n          entry.openedAt = failTime\n          for (const handler of openHandlers) {\n            await handler(error, key)\n          }\n        }\n      }\n\n      if (fallbackFn) {\n        return await fallbackFn(error)\n      }\n\n      throw error\n    }\n  }\n}\n\nexport const Breaker: BreakerBuilder = new BreakerBuilder()\nexport const Fusebox: BreakerBuilder = Breaker\n\nexport function resetCircuits(): void {\n  circuits.clear()\n}\n\nexport default Breaker\n"],"mappings":"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"}

package/dist/index.d.cts

@@ -0,0 +1,62 @@
+export declare class FuseboxError extends Error {
+  constructor(message: string);
+}
+export declare class CircuitOpenError extends FuseboxError {
+  readonly key: string;
+  readonly remainingCooldownMs: number;
+  constructor(key: string, remainingCooldownMs: number);
+}
+type CircuitState = 'closed' | 'open' | 'half-open';
+interface ThresholdConfig {
+  failures: number;
+  within?: number;
+}
+type BreakerEvent = 'open' | 'close' | 'half-open' | 'failure' | 'reject';
+type OpenHandler = (error: unknown, key: string) => void | Promise<void>;
+type CloseHandler = (key: string) => void | Promise<void>;
+type HalfOpenHandler = (key: string) => void | Promise<void>;
+type FailureHandler = (error: unknown, key: string) => void | Promise<void>;
+type RejectHandler = (error: CircuitOpenError, key: string) => void | Promise<void>;
+type FallbackFn<T = unknown> = (error: unknown) => Promise<T> | T;
+type WorkFn<T = unknown> = () => Promise<T> | T;
+interface BreakerConfig<T = unknown> {
+  key: string;
+  failures: number;
+  withinMs?: number;
+  cooldownMs: number;
+  workFn?: WorkFn<T>;
+  fallbackFn?: FallbackFn<T>;
+  openHandlers: OpenHandler[];
+  closeHandlers: CloseHandler[];
+  halfOpenHandlers: HalfOpenHandler[];
+  failureHandlers: FailureHandler[];
+  rejectHandlers: RejectHandler[];
+}
+export declare class BreakerBuilder<T = unknown> implements PromiseLike<T> {
+  private readonly config;
+  private executionPromise?;
+  constructor(config?: Partial<BreakerConfig<T>>);
+  for(key: string): BreakerBuilder<T>;
+  key(key: string): BreakerBuilder<T>;
+  threshold(options: ThresholdConfig | number): BreakerBuilder<T>;
+  cooldown(ms: number): BreakerBuilder<T>;
+  fallback<R = T>(fn: FallbackFn<R>): BreakerBuilder<T | R>;
+  work<R>(fn: WorkFn<R>): BreakerBuilder<R>;
+  on(event: 'open', handler: OpenHandler): BreakerBuilder<T>;
+  on(event: 'close', handler: CloseHandler): BreakerBuilder<T>;
+  on(event: 'half-open', handler: HalfOpenHandler): BreakerBuilder<T>;
+  on(event: 'failure', handler: FailureHandler): BreakerBuilder<T>;
+  on(event: 'reject', handler: RejectHandler): BreakerBuilder<T>;
+  get state(): CircuitState;
+  reset(key?: string): void;
+  resetAll(): void;
+  then<TResult1 = T, TResult2 = never>(onfulfilled?: ((value: T) => TResult1 | PromiseLike<TResult1>) | null | undefined, onrejected?: ((reason: unknown) => TResult2 | PromiseLike<TResult2>) | null | undefined): Promise<TResult1 | TResult2>;
+  catch<TResult = never>(onrejected?: ((reason: unknown) => TResult | PromiseLike<TResult>) | null | undefined): Promise<T | TResult>;
+  finally(onfinally?: (() => void) | null | undefined): Promise<T>;
+  private execute;
+}
+export declare const Breaker: BreakerBuilder;
+export declare const Fusebox: BreakerBuilder;
+export declare function resetCircuits(): void;
+export { Breaker as default, type BreakerEvent, type CircuitState, type CloseHandler, type FailureHandler, type FallbackFn, type HalfOpenHandler, type OpenHandler, type RejectHandler, type ThresholdConfig, type WorkFn };
+//# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/errors.ts","../src/breaker.ts"],"mappings":"A,qBAAa,qBAAqB;EAChC,YAAY;;qBAOD,yBAAyB;WAC3B;WACA;EAET,YAAY,aAAa;;KCVf;UAEK;EACf;EACA;;KAGU;KAEA,eAAe,gBAAgB,uBAAuB;KACtD,gBAAgB,uBAAuB;KACvC,mBAAmB,uBAAuB;KAC1C,kBAAkB,gBAAgB,uBAAuB;KACzD,iBAAiB,OAAO,kBAAkB,uBAAuB;KAEjE,WAAW,gBAAgB,mBAAmB,QAAQ,KAAK;KAC3D,OAAO,qBAAqB,QAAQ,KAAK;UAyB3C,cAAc;EACtB;EACA;EACA;EACA;EACA,SAAS,OAAO;EAChB,aAAa,WAAW;EACxB,cAAc;EACd,eAAe;EACf,kBAAkB;EAClB,iBAAiB;EACjB,gBAAgB;;qBAGL,eAAe,wBAAwB,YAAY;mBAC7C;UACT;EAER,YAAY,SAAS,QAAQ,cAAc;EAgB3C,IAAI,cAAc,eAAe;EAOjC,IAAI,cAAc,eAAe;EAIjC,UAAU,SAAS,2BAA2B,eAAe;EAsB7D,SAAS,aAAa,eAAe;EAOrC,SAAS,IAAI,GAAG,IAAI,WAAW,KAAK,eAAe,IAAI;EAOvD,KAAK,GAAG,IAAI,OAAO,KAAK,eAAe;EAOvC,GAAG,eAAe,SAAS,cAAc,eAAe;EACxD,GAAG,gBAAgB,SAAS,eAAe,eAAe;EAC1D,GAAG,oBAAoB,SAAS,kBAAkB,eAAe;EACjE,GAAG,kBAAkB,SAAS,iBAAiB,eAAe;EAC9D,GAAG,iBAAiB,SAAS,gBAAgB,eAAe;MAkCxD,SAAS;EAWb,MAAM;EAIN;EAIA,KAAK,WAAW,GAAG,kBACjB,gBAAgB,OAAO,MAAM,WAAW,YAAY,+BACpD,eAAe,oBAAoB,WAAW,YAAY,gCACzD,QAAQ,WAAW;EAOtB,MAAM,iBACJ,eAAe,oBAAoB,UAAU,YAAY,+BACxD,QAAQ,IAAI;EAIf,QAAQ,8CAA8C,QAAQ;UAahD;;qBAgHH,SAAS;qBACT,SAAS;wBAEN"}

package/dist/index.d.mts

@@ -0,0 +1,62 @@
+export declare class FuseboxError extends Error {
+  constructor(message: string);
+}
+export declare class CircuitOpenError extends FuseboxError {
+  readonly key: string;
+  readonly remainingCooldownMs: number;
+  constructor(key: string, remainingCooldownMs: number);
+}
+type CircuitState = 'closed' | 'open' | 'half-open';
+interface ThresholdConfig {
+  failures: number;
+  within?: number;
+}
+type BreakerEvent = 'open' | 'close' | 'half-open' | 'failure' | 'reject';
+type OpenHandler = (error: unknown, key: string) => void | Promise<void>;
+type CloseHandler = (key: string) => void | Promise<void>;
+type HalfOpenHandler = (key: string) => void | Promise<void>;
+type FailureHandler = (error: unknown, key: string) => void | Promise<void>;
+type RejectHandler = (error: CircuitOpenError, key: string) => void | Promise<void>;
+type FallbackFn<T = unknown> = (error: unknown) => Promise<T> | T;
+type WorkFn<T = unknown> = () => Promise<T> | T;
+interface BreakerConfig<T = unknown> {
+  key: string;
+  failures: number;
+  withinMs?: number;
+  cooldownMs: number;
+  workFn?: WorkFn<T>;
+  fallbackFn?: FallbackFn<T>;
+  openHandlers: OpenHandler[];
+  closeHandlers: CloseHandler[];
+  halfOpenHandlers: HalfOpenHandler[];
+  failureHandlers: FailureHandler[];
+  rejectHandlers: RejectHandler[];
+}
+export declare class BreakerBuilder<T = unknown> implements PromiseLike<T> {
+  private readonly config;
+  private executionPromise?;
+  constructor(config?: Partial<BreakerConfig<T>>);
+  for(key: string): BreakerBuilder<T>;
+  key(key: string): BreakerBuilder<T>;
+  threshold(options: ThresholdConfig | number): BreakerBuilder<T>;
+  cooldown(ms: number): BreakerBuilder<T>;
+  fallback<R = T>(fn: FallbackFn<R>): BreakerBuilder<T | R>;
+  work<R>(fn: WorkFn<R>): BreakerBuilder<R>;
+  on(event: 'open', handler: OpenHandler): BreakerBuilder<T>;
+  on(event: 'close', handler: CloseHandler): BreakerBuilder<T>;
+  on(event: 'half-open', handler: HalfOpenHandler): BreakerBuilder<T>;
+  on(event: 'failure', handler: FailureHandler): BreakerBuilder<T>;
+  on(event: 'reject', handler: RejectHandler): BreakerBuilder<T>;
+  get state(): CircuitState;
+  reset(key?: string): void;
+  resetAll(): void;
+  then<TResult1 = T, TResult2 = never>(onfulfilled?: ((value: T) => TResult1 | PromiseLike<TResult1>) | null | undefined, onrejected?: ((reason: unknown) => TResult2 | PromiseLike<TResult2>) | null | undefined): Promise<TResult1 | TResult2>;
+  catch<TResult = never>(onrejected?: ((reason: unknown) => TResult | PromiseLike<TResult>) | null | undefined): Promise<T | TResult>;
+  finally(onfinally?: (() => void) | null | undefined): Promise<T>;
+  private execute;
+}
+export declare const Breaker: BreakerBuilder;
+export declare const Fusebox: BreakerBuilder;
+export declare function resetCircuits(): void;
+export { Breaker as default, type BreakerEvent, type CircuitState, type CloseHandler, type FailureHandler, type FallbackFn, type HalfOpenHandler, type OpenHandler, type RejectHandler, type ThresholdConfig, type WorkFn };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/errors.ts","../src/breaker.ts"],"mappings":"A,qBAAa,qBAAqB;EAChC,YAAY;;qBAOD,yBAAyB;WAC3B;WACA;EAET,YAAY,aAAa;;KCVf;UAEK;EACf;EACA;;KAGU;KAEA,eAAe,gBAAgB,uBAAuB;KACtD,gBAAgB,uBAAuB;KACvC,mBAAmB,uBAAuB;KAC1C,kBAAkB,gBAAgB,uBAAuB;KACzD,iBAAiB,OAAO,kBAAkB,uBAAuB;KAEjE,WAAW,gBAAgB,mBAAmB,QAAQ,KAAK;KAC3D,OAAO,qBAAqB,QAAQ,KAAK;UAyB3C,cAAc;EACtB;EACA;EACA;EACA;EACA,SAAS,OAAO;EAChB,aAAa,WAAW;EACxB,cAAc;EACd,eAAe;EACf,kBAAkB;EAClB,iBAAiB;EACjB,gBAAgB;;qBAGL,eAAe,wBAAwB,YAAY;mBAC7C;UACT;EAER,YAAY,SAAS,QAAQ,cAAc;EAgB3C,IAAI,cAAc,eAAe;EAOjC,IAAI,cAAc,eAAe;EAIjC,UAAU,SAAS,2BAA2B,eAAe;EAsB7D,SAAS,aAAa,eAAe;EAOrC,SAAS,IAAI,GAAG,IAAI,WAAW,KAAK,eAAe,IAAI;EAOvD,KAAK,GAAG,IAAI,OAAO,KAAK,eAAe;EAOvC,GAAG,eAAe,SAAS,cAAc,eAAe;EACxD,GAAG,gBAAgB,SAAS,eAAe,eAAe;EAC1D,GAAG,oBAAoB,SAAS,kBAAkB,eAAe;EACjE,GAAG,kBAAkB,SAAS,iBAAiB,eAAe;EAC9D,GAAG,iBAAiB,SAAS,gBAAgB,eAAe;MAkCxD,SAAS;EAWb,MAAM;EAIN;EAIA,KAAK,WAAW,GAAG,kBACjB,gBAAgB,OAAO,MAAM,WAAW,YAAY,+BACpD,eAAe,oBAAoB,WAAW,YAAY,gCACzD,QAAQ,WAAW;EAOtB,MAAM,iBACJ,eAAe,oBAAoB,UAAU,YAAY,+BACxD,QAAQ,IAAI;EAIf,QAAQ,8CAA8C,QAAQ;UAahD;;qBAgHH,SAAS;qBACT,SAAS;wBAEN"}

package/dist/index.mjs

@@ -0,0 +1,222 @@
+// src/errors.ts
+var FuseboxError = class extends Error {
+	constructor(message) {
+		super(message);
+		this.name = "FuseboxError";
+		Object.setPrototypeOf(this, new.target.prototype);
+	}
+};
+var CircuitOpenError = class extends FuseboxError {
+	key;
+	remainingCooldownMs;
+	constructor(key, remainingCooldownMs) {
+		super(`Circuit breaker "${key}" is open. Cooldown remaining: ${Math.max(0, remainingCooldownMs)}ms`);
+		this.name = "CircuitOpenError";
+		this.key = key;
+		this.remainingCooldownMs = Math.max(0, remainingCooldownMs);
+	}
+};
+
+// src/breaker.ts
+const circuits = /* @__PURE__ */ new Map();
+function getOrCreateCircuit(key) {
+	let entry = circuits.get(key);
+	if (!entry) {
+		entry = {
+			state: "closed",
+			failureTimestamps: [],
+			openedAt: null,
+			halfOpenInFlight: false
+		};
+		circuits.set(key, entry);
+	}
+	return entry;
+}
+var BreakerBuilder = class BreakerBuilder {
+	config;
+	executionPromise;
+	constructor(config) {
+		this.config = {
+			key: config?.key ?? "default",
+			failures: config?.failures ?? 5,
+			withinMs: config?.withinMs,
+			cooldownMs: config?.cooldownMs ?? 3e4,
+			workFn: config?.workFn,
+			fallbackFn: config?.fallbackFn,
+			openHandlers: [...config?.openHandlers ?? []],
+			closeHandlers: [...config?.closeHandlers ?? []],
+			halfOpenHandlers: [...config?.halfOpenHandlers ?? []],
+			failureHandlers: [...config?.failureHandlers ?? []],
+			rejectHandlers: [...config?.rejectHandlers ?? []]
+		};
+	}
+	for(key) {
+		if (!key || key.trim().length === 0) throw new RangeError("circuit key must be a non-empty string");
+		return new BreakerBuilder({
+			...this.config,
+			key
+		});
+	}
+	key(key) {
+		return this.for(key);
+	}
+	threshold(options) {
+		if (typeof options === "number") {
+			if (!Number.isInteger(options) || options < 1) throw new RangeError("failures threshold must be an integer of at least 1");
+			return new BreakerBuilder({
+				...this.config,
+				failures: options,
+				withinMs: void 0
+			});
+		}
+		if (!Number.isInteger(options.failures) || options.failures < 1) throw new RangeError("failures threshold must be an integer of at least 1");
+		if (options.within !== void 0 && options.within <= 0) throw new RangeError("within window must be a positive number");
+		return new BreakerBuilder({
+			...this.config,
+			failures: options.failures,
+			withinMs: options.within
+		});
+	}
+	cooldown(ms) {
+		if (ms < 0) throw new RangeError("cooldown must be a non-negative number");
+		return new BreakerBuilder({
+			...this.config,
+			cooldownMs: ms
+		});
+	}
+	fallback(fn) {
+		return new BreakerBuilder({
+			...this.config,
+			fallbackFn: fn
+		});
+	}
+	work(fn) {
+		return new BreakerBuilder({
+			...this.config,
+			workFn: fn
+		});
+	}
+	on(event, handler) {
+		switch (event) {
+			case "open": return new BreakerBuilder({
+				...this.config,
+				openHandlers: [...this.config.openHandlers, handler]
+			});
+			case "close": return new BreakerBuilder({
+				...this.config,
+				closeHandlers: [...this.config.closeHandlers, handler]
+			});
+			case "half-open": return new BreakerBuilder({
+				...this.config,
+				halfOpenHandlers: [...this.config.halfOpenHandlers, handler]
+			});
+			case "failure": return new BreakerBuilder({
+				...this.config,
+				failureHandlers: [...this.config.failureHandlers, handler]
+			});
+			case "reject": return new BreakerBuilder({
+				...this.config,
+				rejectHandlers: [...this.config.rejectHandlers, handler]
+			});
+		}
+	}
+	get state() {
+		const entry = getOrCreateCircuit(this.config.key);
+		if (entry.state === "open" && entry.openedAt !== null) {
+			if (Date.now() - entry.openedAt >= this.config.cooldownMs) return "half-open";
+		}
+		return entry.state;
+	}
+	reset(key) {
+		circuits.delete(key ?? this.config.key);
+	}
+	resetAll() {
+		circuits.clear();
+	}
+	then(onfulfilled, onrejected) {
+		if (!this.executionPromise) this.executionPromise = this.execute();
+		return this.executionPromise.then(onfulfilled, onrejected);
+	}
+	catch(onrejected) {
+		return this.then(void 0, onrejected);
+	}
+	finally(onfinally) {
+		return this.then((value) => {
+			onfinally?.();
+			return value;
+		}, (reason) => {
+			onfinally?.();
+			throw reason;
+		});
+	}
+	async execute() {
+		const { key, failures, withinMs, cooldownMs, workFn, fallbackFn, openHandlers, closeHandlers, halfOpenHandlers, failureHandlers, rejectHandlers } = this.config;
+		if (!workFn) throw new Error("No work function provided. Call .work(fn) before awaiting.");
+		const entry = getOrCreateCircuit(key);
+		const now = Date.now();
+		if (entry.state === "open") {
+			const elapsed = entry.openedAt !== null ? now - entry.openedAt : cooldownMs;
+			if (elapsed >= cooldownMs) {
+				entry.state = "half-open";
+				entry.halfOpenInFlight = false;
+				for (const handler of halfOpenHandlers) await handler(key);
+			} else {
+				const openError = new CircuitOpenError(key, cooldownMs - elapsed);
+				for (const handler of rejectHandlers) await handler(openError, key);
+				if (fallbackFn) return await fallbackFn(openError);
+				throw openError;
+			}
+		}
+		if (entry.state === "half-open") {
+			if (entry.halfOpenInFlight) {
+				const openError = new CircuitOpenError(key, cooldownMs);
+				for (const handler of rejectHandlers) await handler(openError, key);
+				if (fallbackFn) return await fallbackFn(openError);
+				throw openError;
+			}
+			entry.halfOpenInFlight = true;
+		}
+		try {
+			const result = await workFn();
+			if (entry.state === "half-open") {
+				entry.state = "closed";
+				entry.failureTimestamps = [];
+				entry.openedAt = null;
+				entry.halfOpenInFlight = false;
+				for (const handler of closeHandlers) await handler(key);
+			} else if (withinMs === void 0) entry.failureTimestamps = [];
+			return result;
+		} catch (error) {
+			for (const handler of failureHandlers) await handler(error, key);
+			const failTime = Date.now();
+			if (entry.state === "half-open") {
+				entry.state = "open";
+				entry.openedAt = failTime;
+				entry.halfOpenInFlight = false;
+				entry.failureTimestamps = [failTime];
+				for (const handler of openHandlers) await handler(error, key);
+			} else {
+				if (withinMs !== void 0) {
+					const cutoff = failTime - withinMs;
+					entry.failureTimestamps = entry.failureTimestamps.filter((t) => t >= cutoff);
+				}
+				entry.failureTimestamps.push(failTime);
+				if (entry.failureTimestamps.length >= failures) {
+					entry.state = "open";
+					entry.openedAt = failTime;
+					for (const handler of openHandlers) await handler(error, key);
+				}
+			}
+			if (fallbackFn) return await fallbackFn(error);
+			throw error;
+		}
+	}
+};
+const Breaker = new BreakerBuilder();
+const Fusebox = Breaker;
+function resetCircuits() {
+	circuits.clear();
+}
+
+export { Breaker, Breaker as default, BreakerBuilder, CircuitOpenError, Fusebox, FuseboxError, resetCircuits };
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/errors.ts","../src/breaker.ts"],"sourcesContent":["export class FuseboxError extends Error {\n  constructor(message: string) {\n    super(message)\n    this.name = 'FuseboxError'\n    Object.setPrototypeOf(this, new.target.prototype)\n  }\n}\n\nexport class CircuitOpenError extends FuseboxError {\n  readonly key: string\n  readonly remainingCooldownMs: number\n\n  constructor(key: string, remainingCooldownMs: number) {\n    super(\n      `Circuit breaker \"${key}\" is open. Cooldown remaining: ${Math.max(0, remainingCooldownMs)}ms`\n    )\n    this.name = 'CircuitOpenError'\n    this.key = key\n    this.remainingCooldownMs = Math.max(0, remainingCooldownMs)\n  }\n}\n","import { CircuitOpenError } from './errors'\n\nexport type CircuitState = 'closed' | 'open' | 'half-open'\n\nexport interface ThresholdConfig {\n  failures: number\n  within?: number\n}\n\nexport type BreakerEvent = 'open' | 'close' | 'half-open' | 'failure' | 'reject'\n\nexport type OpenHandler = (error: unknown, key: string) => void | Promise<void>\nexport type CloseHandler = (key: string) => void | Promise<void>\nexport type HalfOpenHandler = (key: string) => void | Promise<void>\nexport type FailureHandler = (error: unknown, key: string) => void | Promise<void>\nexport type RejectHandler = (error: CircuitOpenError, key: string) => void | Promise<void>\n\nexport type FallbackFn<T = unknown> = (error: unknown) => Promise<T> | T\nexport type WorkFn<T = unknown> = () => Promise<T> | T\n\ninterface CircuitEntry {\n  state: CircuitState\n  failureTimestamps: number[]\n  openedAt: number | null\n  halfOpenInFlight: boolean\n}\n\nconst circuits = new Map<string, CircuitEntry>()\n\nfunction getOrCreateCircuit(key: string): CircuitEntry {\n  let entry = circuits.get(key)\n  if (!entry) {\n    entry = {\n      state: 'closed',\n      failureTimestamps: [],\n      openedAt: null,\n      halfOpenInFlight: false,\n    }\n    circuits.set(key, entry)\n  }\n  return entry\n}\n\ninterface BreakerConfig<T = unknown> {\n  key: string\n  failures: number\n  withinMs?: number\n  cooldownMs: number\n  workFn?: WorkFn<T>\n  fallbackFn?: FallbackFn<T>\n  openHandlers: OpenHandler[]\n  closeHandlers: CloseHandler[]\n  halfOpenHandlers: HalfOpenHandler[]\n  failureHandlers: FailureHandler[]\n  rejectHandlers: RejectHandler[]\n}\n\nexport class BreakerBuilder<T = unknown> implements PromiseLike<T> {\n  private readonly config: BreakerConfig<T>\n  private executionPromise?: Promise<T>\n\n  constructor(config?: Partial<BreakerConfig<T>>) {\n    this.config = {\n      key: config?.key ?? 'default',\n      failures: config?.failures ?? 5,\n      withinMs: config?.withinMs,\n      cooldownMs: config?.cooldownMs ?? 30_000,\n      workFn: config?.workFn,\n      fallbackFn: config?.fallbackFn,\n      openHandlers: [...(config?.openHandlers ?? [])],\n      closeHandlers: [...(config?.closeHandlers ?? [])],\n      halfOpenHandlers: [...(config?.halfOpenHandlers ?? [])],\n      failureHandlers: [...(config?.failureHandlers ?? [])],\n      rejectHandlers: [...(config?.rejectHandlers ?? [])],\n    }\n  }\n\n  for(key: string): BreakerBuilder<T> {\n    if (!key || key.trim().length === 0) {\n      throw new RangeError('circuit key must be a non-empty string')\n    }\n    return new BreakerBuilder<T>({ ...this.config, key })\n  }\n\n  key(key: string): BreakerBuilder<T> {\n    return this.for(key)\n  }\n\n  threshold(options: ThresholdConfig | number): BreakerBuilder<T> {\n    if (typeof options === 'number') {\n      if (!Number.isInteger(options) || options < 1) {\n        throw new RangeError('failures threshold must be an integer of at least 1')\n      }\n      return new BreakerBuilder<T>({ ...this.config, failures: options, withinMs: undefined })\n    }\n\n    if (!Number.isInteger(options.failures) || options.failures < 1) {\n      throw new RangeError('failures threshold must be an integer of at least 1')\n    }\n    if (options.within !== undefined && options.within <= 0) {\n      throw new RangeError('within window must be a positive number')\n    }\n\n    return new BreakerBuilder<T>({\n      ...this.config,\n      failures: options.failures,\n      withinMs: options.within,\n    })\n  }\n\n  cooldown(ms: number): BreakerBuilder<T> {\n    if (ms < 0) {\n      throw new RangeError('cooldown must be a non-negative number')\n    }\n    return new BreakerBuilder<T>({ ...this.config, cooldownMs: ms })\n  }\n\n  fallback<R = T>(fn: FallbackFn<R>): BreakerBuilder<T | R> {\n    return new BreakerBuilder<T | R>({\n      ...(this.config as unknown as BreakerConfig<T | R>),\n      fallbackFn: fn,\n    })\n  }\n\n  work<R>(fn: WorkFn<R>): BreakerBuilder<R> {\n    return new BreakerBuilder<R>({\n      ...(this.config as unknown as BreakerConfig<R>),\n      workFn: fn,\n    })\n  }\n\n  on(event: 'open', handler: OpenHandler): BreakerBuilder<T>\n  on(event: 'close', handler: CloseHandler): BreakerBuilder<T>\n  on(event: 'half-open', handler: HalfOpenHandler): BreakerBuilder<T>\n  on(event: 'failure', handler: FailureHandler): BreakerBuilder<T>\n  on(event: 'reject', handler: RejectHandler): BreakerBuilder<T>\n  on(\n    event: BreakerEvent,\n    handler: OpenHandler | CloseHandler | HalfOpenHandler | FailureHandler | RejectHandler\n  ): BreakerBuilder<T> {\n    switch (event) {\n      case 'open':\n        return new BreakerBuilder<T>({\n          ...this.config,\n          openHandlers: [...this.config.openHandlers, handler as OpenHandler],\n        })\n      case 'close':\n        return new BreakerBuilder<T>({\n          ...this.config,\n          closeHandlers: [...this.config.closeHandlers, handler as CloseHandler],\n        })\n      case 'half-open':\n        return new BreakerBuilder<T>({\n          ...this.config,\n          halfOpenHandlers: [...this.config.halfOpenHandlers, handler as HalfOpenHandler],\n        })\n      case 'failure':\n        return new BreakerBuilder<T>({\n          ...this.config,\n          failureHandlers: [...this.config.failureHandlers, handler as FailureHandler],\n        })\n      case 'reject':\n        return new BreakerBuilder<T>({\n          ...this.config,\n          rejectHandlers: [...this.config.rejectHandlers, handler as RejectHandler],\n        })\n    }\n  }\n\n  get state(): CircuitState {\n    const entry = getOrCreateCircuit(this.config.key)\n    if (entry.state === 'open' && entry.openedAt !== null) {\n      const elapsed = Date.now() - entry.openedAt\n      if (elapsed >= this.config.cooldownMs) {\n        return 'half-open'\n      }\n    }\n    return entry.state\n  }\n\n  reset(key?: string): void {\n    circuits.delete(key ?? this.config.key)\n  }\n\n  resetAll(): void {\n    circuits.clear()\n  }\n\n  then<TResult1 = T, TResult2 = never>(\n    onfulfilled?: ((value: T) => TResult1 | PromiseLike<TResult1>) | null | undefined,\n    onrejected?: ((reason: unknown) => TResult2 | PromiseLike<TResult2>) | null | undefined\n  ): Promise<TResult1 | TResult2> {\n    if (!this.executionPromise) {\n      this.executionPromise = this.execute()\n    }\n    return this.executionPromise.then(onfulfilled, onrejected)\n  }\n\n  catch<TResult = never>(\n    onrejected?: ((reason: unknown) => TResult | PromiseLike<TResult>) | null | undefined\n  ): Promise<T | TResult> {\n    return this.then(undefined, onrejected)\n  }\n\n  finally(onfinally?: (() => void) | null | undefined): Promise<T> {\n    return this.then(\n      (value) => {\n        onfinally?.()\n        return value\n      },\n      (reason) => {\n        onfinally?.()\n        throw reason\n      }\n    )\n  }\n\n  private async execute(): Promise<T> {\n    const {\n      key,\n      failures,\n      withinMs,\n      cooldownMs,\n      workFn,\n      fallbackFn,\n      openHandlers,\n      closeHandlers,\n      halfOpenHandlers,\n      failureHandlers,\n      rejectHandlers,\n    } = this.config\n\n    if (!workFn) {\n      throw new Error('No work function provided. Call .work(fn) before awaiting.')\n    }\n\n    const entry = getOrCreateCircuit(key)\n    const now = Date.now()\n\n    if (entry.state === 'open') {\n      const elapsed = entry.openedAt !== null ? now - entry.openedAt : cooldownMs\n      if (elapsed >= cooldownMs) {\n        entry.state = 'half-open'\n        entry.halfOpenInFlight = false\n        for (const handler of halfOpenHandlers) {\n          await handler(key)\n        }\n      } else {\n        const openError = new CircuitOpenError(key, cooldownMs - elapsed)\n        for (const handler of rejectHandlers) {\n          await handler(openError, key)\n        }\n        if (fallbackFn) {\n          return await fallbackFn(openError)\n        }\n        throw openError\n      }\n    }\n\n    if (entry.state === 'half-open') {\n      if (entry.halfOpenInFlight) {\n        const openError = new CircuitOpenError(key, cooldownMs)\n        for (const handler of rejectHandlers) {\n          await handler(openError, key)\n        }\n        if (fallbackFn) {\n          return await fallbackFn(openError)\n        }\n        throw openError\n      }\n      entry.halfOpenInFlight = true\n    }\n\n    try {\n      const result = await workFn()\n\n      if (entry.state === 'half-open') {\n        entry.state = 'closed'\n        entry.failureTimestamps = []\n        entry.openedAt = null\n        entry.halfOpenInFlight = false\n        for (const handler of closeHandlers) {\n          await handler(key)\n        }\n      } else if (withinMs === undefined) {\n        entry.failureTimestamps = []\n      }\n\n      return result\n    } catch (error) {\n      for (const handler of failureHandlers) {\n        await handler(error, key)\n      }\n\n      const failTime = Date.now()\n\n      if (entry.state === 'half-open') {\n        entry.state = 'open'\n        entry.openedAt = failTime\n        entry.halfOpenInFlight = false\n        entry.failureTimestamps = [failTime]\n        for (const handler of openHandlers) {\n          await handler(error, key)\n        }\n      } else {\n        if (withinMs !== undefined) {\n          const cutoff = failTime - withinMs\n          entry.failureTimestamps = entry.failureTimestamps.filter((t) => t >= cutoff)\n        }\n        entry.failureTimestamps.push(failTime)\n\n        if (entry.failureTimestamps.length >= failures) {\n          entry.state = 'open'\n          entry.openedAt = failTime\n          for (const handler of openHandlers) {\n            await handler(error, key)\n          }\n        }\n      }\n\n      if (fallbackFn) {\n        return await fallbackFn(error)\n      }\n\n      throw error\n    }\n  }\n}\n\nexport const Breaker: BreakerBuilder = new BreakerBuilder()\nexport const Fusebox: BreakerBuilder = Breaker\n\nexport function resetCircuits(): void {\n  circuits.clear()\n}\n\nexport default Breaker\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,73 @@
 {
   "name": "@gwash3189/fusebox",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.0.1",
+  "description": "A fluent, lightweight TypeScript circuit breaker library with sliding failure windows, cooldown recovery, fallbacks, and lifecycle hooks.",
+  "license": "MIT",
+  "author": "gwash3189",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Gwash3189/fusebox.git"
+  },
+  "homepage": "https://github.com/Gwash3189/fusebox#readme",
+  "bugs": {
+    "url": "https://github.com/Gwash3189/fusebox/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.mts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.mts",
+        "default": "./dist/index.mjs"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsdown",
+    "dev": "tsdown --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "type-check": "tsc --noEmit",
+    "lint": "oxlint",
+    "lint:fix": "oxlint --fix",
+    "format": "prettier --write \"src/**/*.ts\" \"test/**/*.ts\"",
+    "format:check": "prettier --check \"src/**/*.ts\" \"test/**/*.ts\"",
+    "prepublishOnly": "npm run type-check && npm run lint && npm run test && npm run build",
+    "clean": "rm -rf dist"
+  },
+  "devDependencies": {
+    "@types/node": "^26.6.6",
+    "@vitest/coverage-v8": "^5.1.0",
+    "oxlint": "^1.90.0",
+    "prettier": "^3.9.10",
+    "tsdown": "^0.23.4",
+    "typescript": "^7.0.2",
+    "vitest": "^5.1.0"
+  },
+  "keywords": [
+    "circuit-breaker",
+    "fusebox",
+    "breaker",
+    "resilience",
+    "fault-tolerance",
+    "typescript"
+  ],
+  "engines": {
+    "node": ">=22.0.0"
+  }
+}