@dsai-io/tools 0.0.1 → 1.0.7

package/dist/utils/circuit-breaker.cjs

@@ -0,0 +1,173 @@
+'use strict';
+
+/* @dsai-io/tools - DSAi Design System Build Tools */
+
+// src/utils/circuit-breaker.ts
+var CircuitState = /* @__PURE__ */ ((CircuitState2) => {
+  CircuitState2["CLOSED"] = "CLOSED";
+  CircuitState2["OPEN"] = "OPEN";
+  CircuitState2["HALF_OPEN"] = "HALF_OPEN";
+  return CircuitState2;
+})(CircuitState || {});
+var CircuitBreakerOpenError = class extends Error {
+  constructor(circuitName, resetAt) {
+    super(`Circuit breaker "${circuitName}" is open. Will retry at ${resetAt.toISOString()}`);
+    this.circuitName = circuitName;
+    this.resetAt = resetAt;
+    this.name = "CircuitBreakerOpenError";
+  }
+};
+var CircuitBreaker = class {
+  state = "CLOSED" /* CLOSED */;
+  failures = 0;
+  successes = 0;
+  totalCalls = 0;
+  openedAt;
+  resetAt;
+  lastError;
+  failureThreshold;
+  cooldownMs;
+  timeout;
+  name;
+  constructor(config = {}) {
+    this.failureThreshold = config.failureThreshold ?? 5;
+    this.cooldownMs = config.cooldownMs ?? 3e4;
+    this.timeout = config.timeout ?? 1e4;
+    this.name = config.name ?? "CircuitBreaker";
+  }
+  /**
+   * Execute a function with circuit breaker protection
+   */
+  async execute(fn) {
+    this.totalCalls++;
+    if (this.state === "OPEN" /* OPEN */ && this.canAttemptReset()) {
+      this.state = "HALF_OPEN" /* HALF_OPEN */;
+      this.failures = 0;
+    }
+    if (this.state === "OPEN" /* OPEN */) {
+      if (!this.resetAt) {
+        throw new Error(`Circuit breaker "${this.name}" is open but has no reset time`);
+      }
+      throw new CircuitBreakerOpenError(this.name, this.resetAt);
+    }
+    try {
+      const result = await this.executeWithTimeout(fn);
+      this.onSuccess();
+      return result;
+    } catch (error) {
+      this.onFailure(error);
+      throw error;
+    }
+  }
+  /**
+   * Execute function with timeout
+   */
+  async executeWithTimeout(fn) {
+    return Promise.race([
+      fn(),
+      new Promise((_, reject) => {
+        setTimeout(() => {
+          reject(new Error(`Circuit breaker timeout after ${this.timeout}ms`));
+        }, this.timeout);
+      })
+    ]);
+  }
+  /**
+   * Handle successful execution
+   */
+  onSuccess() {
+    this.successes++;
+    if (this.state === "HALF_OPEN" /* HALF_OPEN */) {
+      this.state = "CLOSED" /* CLOSED */;
+      this.failures = 0;
+      this.openedAt = void 0;
+      this.resetAt = void 0;
+      this.lastError = void 0;
+    }
+  }
+  /**
+   * Handle failed execution
+   */
+  onFailure(error) {
+    this.failures++;
+    this.lastError = error instanceof Error ? error.message : String(error);
+    if (this.state === "HALF_OPEN" /* HALF_OPEN */) {
+      this.openCircuit();
+    } else if (this.failures >= this.failureThreshold) {
+      this.openCircuit();
+    }
+  }
+  /**
+   * Open the circuit
+   */
+  openCircuit() {
+    this.state = "OPEN" /* OPEN */;
+    this.openedAt = /* @__PURE__ */ new Date();
+    this.resetAt = new Date(Date.now() + this.cooldownMs);
+  }
+  /**
+   * Check if circuit can attempt reset
+   */
+  canAttemptReset() {
+    if (!this.resetAt) {
+      return false;
+    }
+    return Date.now() >= this.resetAt.getTime();
+  }
+  /**
+   * Get current circuit breaker state
+   */
+  getState() {
+    return this.state;
+  }
+  /**
+   * Get circuit breaker statistics
+   */
+  getStats() {
+    return {
+      state: this.state,
+      failures: this.failures,
+      successes: this.successes,
+      totalCalls: this.totalCalls,
+      openedAt: this.openedAt,
+      resetAt: this.resetAt,
+      lastError: this.lastError
+    };
+  }
+  /**
+   * Manually reset circuit breaker
+   */
+  reset() {
+    this.state = "CLOSED" /* CLOSED */;
+    this.failures = 0;
+    this.successes = 0;
+    this.totalCalls = 0;
+    this.openedAt = void 0;
+    this.resetAt = void 0;
+    this.lastError = void 0;
+  }
+  /**
+   * Check if circuit is open
+   */
+  isOpen() {
+    return this.state === "OPEN" /* OPEN */;
+  }
+  /**
+   * Check if circuit is closed
+   */
+  isClosed() {
+    return this.state === "CLOSED" /* CLOSED */;
+  }
+  /**
+   * Check if circuit is half-open
+   */
+  isHalfOpen() {
+    return this.state === "HALF_OPEN" /* HALF_OPEN */;
+  }
+};
+
+exports.CircuitBreaker = CircuitBreaker;
+exports.CircuitBreakerOpenError = CircuitBreakerOpenError;
+exports.CircuitState = CircuitState;
+//# sourceMappingURL=circuit-breaker.cjs.map
+//# sourceMappingURL=circuit-breaker.cjs.map

package/dist/utils/circuit-breaker.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/circuit-breaker.ts"],"names":["CircuitState"],"mappings":"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","file":"circuit-breaker.cjs","sourcesContent":["/**\n * @fileoverview Circuit Breaker pattern implementation\n * Prevents cascade failures by tracking error rates and temporarily blocking requests\n */\n\n/**\n * Circuit breaker states\n */\nexport enum CircuitState {\n  /** Normal operation - requests are allowed */\n  CLOSED = 'CLOSED',\n  /** Failing - all requests are rejected immediately */\n  OPEN = 'OPEN',\n  /** Testing recovery - limited requests are allowed */\n  HALF_OPEN = 'HALF_OPEN',\n}\n\n/**\n * Circuit breaker configuration\n */\nexport interface CircuitBreakerConfig {\n  /** Number of failures before opening circuit */\n  failureThreshold?: number;\n  /** Time in ms before attempting to close circuit */\n  cooldownMs?: number;\n  /** Request timeout in ms */\n  timeout?: number;\n  /** Name for logging */\n  name?: string;\n}\n\n/**\n * Circuit breaker statistics\n */\nexport interface CircuitBreakerStats {\n  /** Current state */\n  state: CircuitState;\n  /** Total failures */\n  failures: number;\n  /** Total successes */\n  successes: number;\n  /** Total calls */\n  totalCalls: number;\n  /** Time circuit opened (if open) */\n  openedAt?: Date;\n  /** Time circuit will attempt to close */\n  resetAt?: Date;\n  /** Last error */\n  lastError?: string;\n}\n\n/**\n * Circuit breaker error thrown when circuit is open\n */\nexport class CircuitBreakerOpenError extends Error {\n  constructor(\n    public readonly circuitName: string,\n    public readonly resetAt: Date\n  ) {\n    super(`Circuit breaker \"${circuitName}\" is open. Will retry at ${resetAt.toISOString()}`);\n    this.name = 'CircuitBreakerOpenError';\n  }\n}\n\n/**\n * Circuit breaker implementation\n * Tracks failures and opens circuit to prevent cascade failures\n */\nexport class CircuitBreaker {\n  private state: CircuitState = CircuitState.CLOSED;\n  private failures = 0;\n  private successes = 0;\n  private totalCalls = 0;\n  private openedAt?: Date;\n  private resetAt?: Date;\n  private lastError?: string;\n\n  private readonly failureThreshold: number;\n  private readonly cooldownMs: number;\n  private readonly timeout: number;\n  private readonly name: string;\n\n  constructor(config: CircuitBreakerConfig = {}) {\n    this.failureThreshold = config.failureThreshold ?? 5;\n    this.cooldownMs = config.cooldownMs ?? 30000; // 30 seconds\n    this.timeout = config.timeout ?? 10000; // 10 seconds\n    this.name = config.name ?? 'CircuitBreaker';\n  }\n\n  /**\n   * Execute a function with circuit breaker protection\n   */\n  async execute<T>(fn: () => Promise<T>): Promise<T> {\n    this.totalCalls++;\n\n    // Check if circuit should transition from OPEN to HALF_OPEN\n    if (this.state === CircuitState.OPEN && this.canAttemptReset()) {\n      this.state = CircuitState.HALF_OPEN;\n      this.failures = 0; // Reset failure count for half-open state\n    }\n\n    // Reject immediately if circuit is open\n    if (this.state === CircuitState.OPEN) {\n      if (!this.resetAt) {\n        throw new Error(`Circuit breaker \"${this.name}\" is open but has no reset time`);\n      }\n      throw new CircuitBreakerOpenError(this.name, this.resetAt);\n    }\n\n    try {\n      // Execute with timeout\n      const result = await this.executeWithTimeout(fn);\n\n      // Record success\n      this.onSuccess();\n\n      return result;\n    } catch (error) {\n      // Record failure\n      this.onFailure(error);\n      throw error;\n    }\n  }\n\n  /**\n   * Execute function with timeout\n   */\n  private async executeWithTimeout<T>(fn: () => Promise<T>): Promise<T> {\n    return Promise.race([\n      fn(),\n      new Promise<T>((_, reject) => {\n        setTimeout(() => {\n          reject(new Error(`Circuit breaker timeout after ${this.timeout}ms`));\n        }, this.timeout);\n      }),\n    ]);\n  }\n\n  /**\n   * Handle successful execution\n   */\n  private onSuccess(): void {\n    this.successes++;\n\n    if (this.state === CircuitState.HALF_OPEN) {\n      // Successful call in HALF_OPEN state closes the circuit\n      this.state = CircuitState.CLOSED;\n      this.failures = 0;\n      this.openedAt = undefined;\n      this.resetAt = undefined;\n      this.lastError = undefined;\n    }\n  }\n\n  /**\n   * Handle failed execution\n   */\n  private onFailure(error: unknown): void {\n    this.failures++;\n    this.lastError = error instanceof Error ? error.message : String(error);\n\n    if (this.state === CircuitState.HALF_OPEN) {\n      // Failure in HALF_OPEN state immediately reopens circuit\n      this.openCircuit();\n    } else if (this.failures >= this.failureThreshold) {\n      // Threshold reached, open circuit\n      this.openCircuit();\n    }\n  }\n\n  /**\n   * Open the circuit\n   */\n  private openCircuit(): void {\n    this.state = CircuitState.OPEN;\n    this.openedAt = new Date();\n    this.resetAt = new Date(Date.now() + this.cooldownMs);\n  }\n\n  /**\n   * Check if circuit can attempt reset\n   */\n  private canAttemptReset(): boolean {\n    if (!this.resetAt) {\n      return false;\n    }\n    return Date.now() >= this.resetAt.getTime();\n  }\n\n  /**\n   * Get current circuit breaker state\n   */\n  getState(): CircuitState {\n    return this.state;\n  }\n\n  /**\n   * Get circuit breaker statistics\n   */\n  getStats(): CircuitBreakerStats {\n    return {\n      state: this.state,\n      failures: this.failures,\n      successes: this.successes,\n      totalCalls: this.totalCalls,\n      openedAt: this.openedAt,\n      resetAt: this.resetAt,\n      lastError: this.lastError,\n    };\n  }\n\n  /**\n   * Manually reset circuit breaker\n   */\n  reset(): void {\n    this.state = CircuitState.CLOSED;\n    this.failures = 0;\n    this.successes = 0;\n    this.totalCalls = 0;\n    this.openedAt = undefined;\n    this.resetAt = undefined;\n    this.lastError = undefined;\n  }\n\n  /**\n   * Check if circuit is open\n   */\n  isOpen(): boolean {\n    return this.state === CircuitState.OPEN;\n  }\n\n  /**\n   * Check if circuit is closed\n   */\n  isClosed(): boolean {\n    return this.state === CircuitState.CLOSED;\n  }\n\n  /**\n   * Check if circuit is half-open\n   */\n  isHalfOpen(): boolean {\n    return this.state === CircuitState.HALF_OPEN;\n  }\n}\n"]}

package/dist/utils/circuit-breaker.d.cts

@@ -0,0 +1,123 @@
+/**
+ * @fileoverview Circuit Breaker pattern implementation
+ * Prevents cascade failures by tracking error rates and temporarily blocking requests
+ */
+/**
+ * Circuit breaker states
+ */
+declare enum CircuitState {
+    /** Normal operation - requests are allowed */
+    CLOSED = "CLOSED",
+    /** Failing - all requests are rejected immediately */
+    OPEN = "OPEN",
+    /** Testing recovery - limited requests are allowed */
+    HALF_OPEN = "HALF_OPEN"
+}
+/**
+ * Circuit breaker configuration
+ */
+interface CircuitBreakerConfig {
+    /** Number of failures before opening circuit */
+    failureThreshold?: number;
+    /** Time in ms before attempting to close circuit */
+    cooldownMs?: number;
+    /** Request timeout in ms */
+    timeout?: number;
+    /** Name for logging */
+    name?: string;
+}
+/**
+ * Circuit breaker statistics
+ */
+interface CircuitBreakerStats {
+    /** Current state */
+    state: CircuitState;
+    /** Total failures */
+    failures: number;
+    /** Total successes */
+    successes: number;
+    /** Total calls */
+    totalCalls: number;
+    /** Time circuit opened (if open) */
+    openedAt?: Date;
+    /** Time circuit will attempt to close */
+    resetAt?: Date;
+    /** Last error */
+    lastError?: string;
+}
+/**
+ * Circuit breaker error thrown when circuit is open
+ */
+declare class CircuitBreakerOpenError extends Error {
+    readonly circuitName: string;
+    readonly resetAt: Date;
+    constructor(circuitName: string, resetAt: Date);
+}
+/**
+ * Circuit breaker implementation
+ * Tracks failures and opens circuit to prevent cascade failures
+ */
+declare class CircuitBreaker {
+    private state;
+    private failures;
+    private successes;
+    private totalCalls;
+    private openedAt?;
+    private resetAt?;
+    private lastError?;
+    private readonly failureThreshold;
+    private readonly cooldownMs;
+    private readonly timeout;
+    private readonly name;
+    constructor(config?: CircuitBreakerConfig);
+    /**
+     * Execute a function with circuit breaker protection
+     */
+    execute<T>(fn: () => Promise<T>): Promise<T>;
+    /**
+     * Execute function with timeout
+     */
+    private executeWithTimeout;
+    /**
+     * Handle successful execution
+     */
+    private onSuccess;
+    /**
+     * Handle failed execution
+     */
+    private onFailure;
+    /**
+     * Open the circuit
+     */
+    private openCircuit;
+    /**
+     * Check if circuit can attempt reset
+     */
+    private canAttemptReset;
+    /**
+     * Get current circuit breaker state
+     */
+    getState(): CircuitState;
+    /**
+     * Get circuit breaker statistics
+     */
+    getStats(): CircuitBreakerStats;
+    /**
+     * Manually reset circuit breaker
+     */
+    reset(): void;
+    /**
+     * Check if circuit is open
+     */
+    isOpen(): boolean;
+    /**
+     * Check if circuit is closed
+     */
+    isClosed(): boolean;
+    /**
+     * Check if circuit is half-open
+     */
+    isHalfOpen(): boolean;
+}
+
+export { CircuitBreaker, type CircuitBreakerConfig, CircuitBreakerOpenError, type CircuitBreakerStats, CircuitState };

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

@@ -0,0 +1,123 @@
+/**
+ * @fileoverview Circuit Breaker pattern implementation
+ * Prevents cascade failures by tracking error rates and temporarily blocking requests
+ */
+/**
+ * Circuit breaker states
+ */
+declare enum CircuitState {
+    /** Normal operation - requests are allowed */
+    CLOSED = "CLOSED",
+    /** Failing - all requests are rejected immediately */
+    OPEN = "OPEN",
+    /** Testing recovery - limited requests are allowed */
+    HALF_OPEN = "HALF_OPEN"
+}
+/**
+ * Circuit breaker configuration
+ */
+interface CircuitBreakerConfig {
+    /** Number of failures before opening circuit */
+    failureThreshold?: number;
+    /** Time in ms before attempting to close circuit */
+    cooldownMs?: number;
+    /** Request timeout in ms */
+    timeout?: number;
+    /** Name for logging */
+    name?: string;
+}
+/**
+ * Circuit breaker statistics
+ */
+interface CircuitBreakerStats {
+    /** Current state */
+    state: CircuitState;
+    /** Total failures */
+    failures: number;
+    /** Total successes */
+    successes: number;
+    /** Total calls */
+    totalCalls: number;
+    /** Time circuit opened (if open) */
+    openedAt?: Date;
+    /** Time circuit will attempt to close */
+    resetAt?: Date;
+    /** Last error */
+    lastError?: string;
+}
+/**
+ * Circuit breaker error thrown when circuit is open
+ */
+declare class CircuitBreakerOpenError extends Error {
+    readonly circuitName: string;
+    readonly resetAt: Date;
+    constructor(circuitName: string, resetAt: Date);
+}
+/**
+ * Circuit breaker implementation
+ * Tracks failures and opens circuit to prevent cascade failures
+ */
+declare class CircuitBreaker {
+    private state;
+    private failures;
+    private successes;
+    private totalCalls;
+    private openedAt?;
+    private resetAt?;
+    private lastError?;
+    private readonly failureThreshold;
+    private readonly cooldownMs;
+    private readonly timeout;
+    private readonly name;
+    constructor(config?: CircuitBreakerConfig);
+    /**
+     * Execute a function with circuit breaker protection
+     */
+    execute<T>(fn: () => Promise<T>): Promise<T>;
+    /**
+     * Execute function with timeout
+     */
+    private executeWithTimeout;
+    /**
+     * Handle successful execution
+     */
+    private onSuccess;
+    /**
+     * Handle failed execution
+     */
+    private onFailure;
+    /**
+     * Open the circuit
+     */
+    private openCircuit;
+    /**
+     * Check if circuit can attempt reset
+     */
+    private canAttemptReset;
+    /**
+     * Get current circuit breaker state
+     */
+    getState(): CircuitState;
+    /**
+     * Get circuit breaker statistics
+     */
+    getStats(): CircuitBreakerStats;
+    /**
+     * Manually reset circuit breaker
+     */
+    reset(): void;
+    /**
+     * Check if circuit is open
+     */
+    isOpen(): boolean;
+    /**
+     * Check if circuit is closed
+     */
+    isClosed(): boolean;
+    /**
+     * Check if circuit is half-open
+     */
+    isHalfOpen(): boolean;
+}
+
+export { CircuitBreaker, type CircuitBreakerConfig, CircuitBreakerOpenError, type CircuitBreakerStats, CircuitState };

package/dist/utils/circuit-breaker.js

@@ -0,0 +1,169 @@
+/* @dsai-io/tools - DSAi Design System Build Tools */
+
+// src/utils/circuit-breaker.ts
+var CircuitState = /* @__PURE__ */ ((CircuitState2) => {
+  CircuitState2["CLOSED"] = "CLOSED";
+  CircuitState2["OPEN"] = "OPEN";
+  CircuitState2["HALF_OPEN"] = "HALF_OPEN";
+  return CircuitState2;
+})(CircuitState || {});
+var CircuitBreakerOpenError = class extends Error {
+  constructor(circuitName, resetAt) {
+    super(`Circuit breaker "${circuitName}" is open. Will retry at ${resetAt.toISOString()}`);
+    this.circuitName = circuitName;
+    this.resetAt = resetAt;
+    this.name = "CircuitBreakerOpenError";
+  }
+};
+var CircuitBreaker = class {
+  state = "CLOSED" /* CLOSED */;
+  failures = 0;
+  successes = 0;
+  totalCalls = 0;
+  openedAt;
+  resetAt;
+  lastError;
+  failureThreshold;
+  cooldownMs;
+  timeout;
+  name;
+  constructor(config = {}) {
+    this.failureThreshold = config.failureThreshold ?? 5;
+    this.cooldownMs = config.cooldownMs ?? 3e4;
+    this.timeout = config.timeout ?? 1e4;
+    this.name = config.name ?? "CircuitBreaker";
+  }
+  /**
+   * Execute a function with circuit breaker protection
+   */
+  async execute(fn) {
+    this.totalCalls++;
+    if (this.state === "OPEN" /* OPEN */ && this.canAttemptReset()) {
+      this.state = "HALF_OPEN" /* HALF_OPEN */;
+      this.failures = 0;
+    }
+    if (this.state === "OPEN" /* OPEN */) {
+      if (!this.resetAt) {
+        throw new Error(`Circuit breaker "${this.name}" is open but has no reset time`);
+      }
+      throw new CircuitBreakerOpenError(this.name, this.resetAt);
+    }
+    try {
+      const result = await this.executeWithTimeout(fn);
+      this.onSuccess();
+      return result;
+    } catch (error) {
+      this.onFailure(error);
+      throw error;
+    }
+  }
+  /**
+   * Execute function with timeout
+   */
+  async executeWithTimeout(fn) {
+    return Promise.race([
+      fn(),
+      new Promise((_, reject) => {
+        setTimeout(() => {
+          reject(new Error(`Circuit breaker timeout after ${this.timeout}ms`));
+        }, this.timeout);
+      })
+    ]);
+  }
+  /**
+   * Handle successful execution
+   */
+  onSuccess() {
+    this.successes++;
+    if (this.state === "HALF_OPEN" /* HALF_OPEN */) {
+      this.state = "CLOSED" /* CLOSED */;
+      this.failures = 0;
+      this.openedAt = void 0;
+      this.resetAt = void 0;
+      this.lastError = void 0;
+    }
+  }
+  /**
+   * Handle failed execution
+   */
+  onFailure(error) {
+    this.failures++;
+    this.lastError = error instanceof Error ? error.message : String(error);
+    if (this.state === "HALF_OPEN" /* HALF_OPEN */) {
+      this.openCircuit();
+    } else if (this.failures >= this.failureThreshold) {
+      this.openCircuit();
+    }
+  }
+  /**
+   * Open the circuit
+   */
+  openCircuit() {
+    this.state = "OPEN" /* OPEN */;
+    this.openedAt = /* @__PURE__ */ new Date();
+    this.resetAt = new Date(Date.now() + this.cooldownMs);
+  }
+  /**
+   * Check if circuit can attempt reset
+   */
+  canAttemptReset() {
+    if (!this.resetAt) {
+      return false;
+    }
+    return Date.now() >= this.resetAt.getTime();
+  }
+  /**
+   * Get current circuit breaker state
+   */
+  getState() {
+    return this.state;
+  }
+  /**
+   * Get circuit breaker statistics
+   */
+  getStats() {
+    return {
+      state: this.state,
+      failures: this.failures,
+      successes: this.successes,
+      totalCalls: this.totalCalls,
+      openedAt: this.openedAt,
+      resetAt: this.resetAt,
+      lastError: this.lastError
+    };
+  }
+  /**
+   * Manually reset circuit breaker
+   */
+  reset() {
+    this.state = "CLOSED" /* CLOSED */;
+    this.failures = 0;
+    this.successes = 0;
+    this.totalCalls = 0;
+    this.openedAt = void 0;
+    this.resetAt = void 0;
+    this.lastError = void 0;
+  }
+  /**
+   * Check if circuit is open
+   */
+  isOpen() {
+    return this.state === "OPEN" /* OPEN */;
+  }
+  /**
+   * Check if circuit is closed
+   */
+  isClosed() {
+    return this.state === "CLOSED" /* CLOSED */;
+  }
+  /**
+   * Check if circuit is half-open
+   */
+  isHalfOpen() {
+    return this.state === "HALF_OPEN" /* HALF_OPEN */;
+  }
+};
+
+export { CircuitBreaker, CircuitBreakerOpenError, CircuitState };
+//# sourceMappingURL=circuit-breaker.js.map
+//# sourceMappingURL=circuit-breaker.js.map

package/dist/utils/circuit-breaker.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/circuit-breaker.ts"],"names":["CircuitState"],"mappings":"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","file":"circuit-breaker.js","sourcesContent":["/**\n * @fileoverview Circuit Breaker pattern implementation\n * Prevents cascade failures by tracking error rates and temporarily blocking requests\n */\n\n/**\n * Circuit breaker states\n */\nexport enum CircuitState {\n  /** Normal operation - requests are allowed */\n  CLOSED = 'CLOSED',\n  /** Failing - all requests are rejected immediately */\n  OPEN = 'OPEN',\n  /** Testing recovery - limited requests are allowed */\n  HALF_OPEN = 'HALF_OPEN',\n}\n\n/**\n * Circuit breaker configuration\n */\nexport interface CircuitBreakerConfig {\n  /** Number of failures before opening circuit */\n  failureThreshold?: number;\n  /** Time in ms before attempting to close circuit */\n  cooldownMs?: number;\n  /** Request timeout in ms */\n  timeout?: number;\n  /** Name for logging */\n  name?: string;\n}\n\n/**\n * Circuit breaker statistics\n */\nexport interface CircuitBreakerStats {\n  /** Current state */\n  state: CircuitState;\n  /** Total failures */\n  failures: number;\n  /** Total successes */\n  successes: number;\n  /** Total calls */\n  totalCalls: number;\n  /** Time circuit opened (if open) */\n  openedAt?: Date;\n  /** Time circuit will attempt to close */\n  resetAt?: Date;\n  /** Last error */\n  lastError?: string;\n}\n\n/**\n * Circuit breaker error thrown when circuit is open\n */\nexport class CircuitBreakerOpenError extends Error {\n  constructor(\n    public readonly circuitName: string,\n    public readonly resetAt: Date\n  ) {\n    super(`Circuit breaker \"${circuitName}\" is open. Will retry at ${resetAt.toISOString()}`);\n    this.name = 'CircuitBreakerOpenError';\n  }\n}\n\n/**\n * Circuit breaker implementation\n * Tracks failures and opens circuit to prevent cascade failures\n */\nexport class CircuitBreaker {\n  private state: CircuitState = CircuitState.CLOSED;\n  private failures = 0;\n  private successes = 0;\n  private totalCalls = 0;\n  private openedAt?: Date;\n  private resetAt?: Date;\n  private lastError?: string;\n\n  private readonly failureThreshold: number;\n  private readonly cooldownMs: number;\n  private readonly timeout: number;\n  private readonly name: string;\n\n  constructor(config: CircuitBreakerConfig = {}) {\n    this.failureThreshold = config.failureThreshold ?? 5;\n    this.cooldownMs = config.cooldownMs ?? 30000; // 30 seconds\n    this.timeout = config.timeout ?? 10000; // 10 seconds\n    this.name = config.name ?? 'CircuitBreaker';\n  }\n\n  /**\n   * Execute a function with circuit breaker protection\n   */\n  async execute<T>(fn: () => Promise<T>): Promise<T> {\n    this.totalCalls++;\n\n    // Check if circuit should transition from OPEN to HALF_OPEN\n    if (this.state === CircuitState.OPEN && this.canAttemptReset()) {\n      this.state = CircuitState.HALF_OPEN;\n      this.failures = 0; // Reset failure count for half-open state\n    }\n\n    // Reject immediately if circuit is open\n    if (this.state === CircuitState.OPEN) {\n      if (!this.resetAt) {\n        throw new Error(`Circuit breaker \"${this.name}\" is open but has no reset time`);\n      }\n      throw new CircuitBreakerOpenError(this.name, this.resetAt);\n    }\n\n    try {\n      // Execute with timeout\n      const result = await this.executeWithTimeout(fn);\n\n      // Record success\n      this.onSuccess();\n\n      return result;\n    } catch (error) {\n      // Record failure\n      this.onFailure(error);\n      throw error;\n    }\n  }\n\n  /**\n   * Execute function with timeout\n   */\n  private async executeWithTimeout<T>(fn: () => Promise<T>): Promise<T> {\n    return Promise.race([\n      fn(),\n      new Promise<T>((_, reject) => {\n        setTimeout(() => {\n          reject(new Error(`Circuit breaker timeout after ${this.timeout}ms`));\n        }, this.timeout);\n      }),\n    ]);\n  }\n\n  /**\n   * Handle successful execution\n   */\n  private onSuccess(): void {\n    this.successes++;\n\n    if (this.state === CircuitState.HALF_OPEN) {\n      // Successful call in HALF_OPEN state closes the circuit\n      this.state = CircuitState.CLOSED;\n      this.failures = 0;\n      this.openedAt = undefined;\n      this.resetAt = undefined;\n      this.lastError = undefined;\n    }\n  }\n\n  /**\n   * Handle failed execution\n   */\n  private onFailure(error: unknown): void {\n    this.failures++;\n    this.lastError = error instanceof Error ? error.message : String(error);\n\n    if (this.state === CircuitState.HALF_OPEN) {\n      // Failure in HALF_OPEN state immediately reopens circuit\n      this.openCircuit();\n    } else if (this.failures >= this.failureThreshold) {\n      // Threshold reached, open circuit\n      this.openCircuit();\n    }\n  }\n\n  /**\n   * Open the circuit\n   */\n  private openCircuit(): void {\n    this.state = CircuitState.OPEN;\n    this.openedAt = new Date();\n    this.resetAt = new Date(Date.now() + this.cooldownMs);\n  }\n\n  /**\n   * Check if circuit can attempt reset\n   */\n  private canAttemptReset(): boolean {\n    if (!this.resetAt) {\n      return false;\n    }\n    return Date.now() >= this.resetAt.getTime();\n  }\n\n  /**\n   * Get current circuit breaker state\n   */\n  getState(): CircuitState {\n    return this.state;\n  }\n\n  /**\n   * Get circuit breaker statistics\n   */\n  getStats(): CircuitBreakerStats {\n    return {\n      state: this.state,\n      failures: this.failures,\n      successes: this.successes,\n      totalCalls: this.totalCalls,\n      openedAt: this.openedAt,\n      resetAt: this.resetAt,\n      lastError: this.lastError,\n    };\n  }\n\n  /**\n   * Manually reset circuit breaker\n   */\n  reset(): void {\n    this.state = CircuitState.CLOSED;\n    this.failures = 0;\n    this.successes = 0;\n    this.totalCalls = 0;\n    this.openedAt = undefined;\n    this.resetAt = undefined;\n    this.lastError = undefined;\n  }\n\n  /**\n   * Check if circuit is open\n   */\n  isOpen(): boolean {\n    return this.state === CircuitState.OPEN;\n  }\n\n  /**\n   * Check if circuit is closed\n   */\n  isClosed(): boolean {\n    return this.state === CircuitState.CLOSED;\n  }\n\n  /**\n   * Check if circuit is half-open\n   */\n  isHalfOpen(): boolean {\n    return this.state === CircuitState.HALF_OPEN;\n  }\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dsai-io/tools",
-  "version": "0.0.1",
+  "version": "1.0.7",
   "description": "Build tooling and CLI for DSAi Design System",
   "type": "module",
   "main": "dist/index.cjs",
@@ -35,6 +35,11 @@
       "types": "./dist/cli/index.d.ts",
       "import": "./dist/cli/index.js",
       "require": "./dist/cli/index.cjs"
+    },
+    "./utils/circuit-breaker": {
+      "types": "./dist/utils/circuit-breaker.d.ts",
+      "import": "./dist/utils/circuit-breaker.js",
+      "require": "./dist/utils/circuit-breaker.cjs"
     }
   },
   "files": [
@@ -72,19 +77,19 @@
     "ora": "^9.0.0",
     "picocolors": "^1.1.1",
     "svgo": "^4.0.0",
-    "zod": "^3.25.0"
+    "zod": "^4.3.5"
   },
   "devDependencies": {
     "@clack/prompts": "^0.11.0",
     "@types/node": "^22.15.30",
     "@types/prompts": "^2.4.9",
-    "style-dictionary": "^5.1.1",
+    "style-dictionary": "^5.1.4",
     "tsup": "^8.5.1",
     "typescript": "^5.9.3",
-    "zod-to-json-schema": "^3.25.0"
+    "zod-to-json-schema": "^3.25.1"
   },
   "peerDependencies": {
-    "style-dictionary": "^5.1.1"
+    "style-dictionary": "^5.1.4"
   },
   "peerDependenciesMeta": {
     "style-dictionary": {