@hardlydifficult/throttle 2.0.0 → 3.0.0

package/README.md

@@ -1,6 +1,6 @@
 # @hardlydifficult/throttle
 
-Rate limiting with optional weight and state persistence.
+Rate limiting, exponential backoff, connection error detection, and throttled message updates.
 
 ## Installation
 
@@ -8,21 +8,96 @@ Rate limiting with optional weight and state persistence.
 npm install @hardlydifficult/throttle
 ```
 
-## Throttle
+## API
+
+### `Throttle`
+
+Token-bucket rate limiter with optional persistent state.
 
 ```typescript
-import { Throttle } from '@hardlydifficult/throttle';
+import { Throttle } from "@hardlydifficult/throttle";
 
 const throttle = new Throttle({
   unitsPerSecond: 10,
-  persistKey: 'api-throttle', // optional: survives restarts
-  stateDirectory: './my-state', // optional: defaults to ~/.app-state
-  onSleep: (ms, info) => console.log(`Sleeping ${ms}ms (weight: ${info.weight})`),
+  persistKey: "github-api", // optional: persist across restarts
+  stateDirectory: "/var/data", // optional: defaults to ~/.app-state
+  onSleep: (delayMs, info) => console.log(`Sleeping ${delayMs}ms`), // optional
 });
 
-await throttle.wait();   // consumes 1 unit (default)
-await throttle.wait(5);  // consumes 5 units
-await throttle.wait(10); // consumes 10 units, sleeps if needed
+await throttle.wait(); // waits if needed to stay within rate limit
+await throttle.wait(5); // consume 5 units
 ```
 
 When `persistKey` is set, throttle state is written to `{stateDirectory}/{persistKey}.json`. The default `stateDirectory` is `~/.app-state` (override with the `STATE_TRACKER_DIR` environment variable).
+
+**Options:**
+
+| Option | Type | Description |
+|--------|------|-------------|
+| `unitsPerSecond` | `number` | Rate limit (required) |
+| `persistKey` | `string` | Key for disk persistence (optional) |
+| `stateDirectory` | `string` | Directory for state files (optional) |
+| `onSleep` | `function` | Callback when throttle sleeps (optional) |
+
+### `getBackoffDelay(attempt: number, options?: BackoffOptions): number`
+
+Calculate exponential backoff delay: `min(initialDelay * 2^attempt, maxDelay)`.
+
+```typescript
+import { getBackoffDelay } from "@hardlydifficult/throttle";
+
+getBackoffDelay(0); // 1000
+getBackoffDelay(1); // 2000
+getBackoffDelay(2); // 4000
+getBackoffDelay(3, { initialDelayMs: 500, maxDelayMs: 10000 }); // 4000
+```
+
+### `sleep(ms: number): Promise<void>`
+
+Sleep for the specified duration.
+
+### `getRandomDelay(minMs: number, maxMs: number): number`
+
+Get a randomized delay between `minMs` and `maxMs` (inclusive).
+
+### `isConnectionError(error: unknown): boolean`
+
+Check if an error is a connection error (e.g., ECONNREFUSED). Walks the error chain (`cause`, `errors`, `lastError`) to find connection indicators.
+
+```typescript
+import { isConnectionError } from "@hardlydifficult/throttle";
+
+try {
+  await fetch("http://localhost:11434/api/generate");
+} catch (err) {
+  if (isConnectionError(err)) {
+    console.log("Service is not running");
+  }
+}
+```
+
+### `createThrottledUpdater(updateFn, intervalMs): ThrottledUpdater`
+
+Batch rapid updates to avoid rate limits while ensuring the final state is always sent.
+
+```typescript
+import { createThrottledUpdater } from "@hardlydifficult/throttle";
+
+const updater = createThrottledUpdater(
+  (text) => message.edit(text),
+  2000
+);
+
+updater.update("Step 1...");
+updater.update("Step 2...");
+updater.update("Step 3..."); // only this one gets sent
+
+await updater.flush(); // ensure final state is sent
+updater.stop(); // clean up
+```
+
+| Method | Description |
+|--------|-------------|
+| `update(text)` | Queue an update with the latest text |
+| `flush()` | Flush any pending update immediately |
+| `stop()` | Stop the updater and clear pending timeouts |

package/dist/ThrottledUpdater.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Throttled message updater
+ *
+ * Batches rapid updates to avoid rate limits while ensuring
+ * the final state is always sent.
+ */
+export interface ThrottledUpdater {
+    /** Queue an update with the latest text */
+    update(text: string): void;
+    /** Flush any pending update immediately */
+    flush(): Promise<void>;
+    /** Stop the updater and clear any pending timeouts */
+    stop(): void;
+}
+/**
+ * Create a throttled message updater
+ *
+ * Limits how frequently the update function is called while ensuring
+ * the most recent content is always eventually sent.
+ *
+ * @param updateFn - Async function to call with updated text
+ * @param intervalMs - Minimum interval between updates
+ * @returns ThrottledUpdater instance
+ *
+ * @example
+ * ```typescript
+ * const updater = createThrottledUpdater(
+ *   (text) => message.edit(text),
+ *   2000
+ * );
+ *
+ * // These rapid updates will be batched
+ * updater.update('Step 1...');
+ * updater.update('Step 2...');
+ * updater.update('Step 3...');
+ *
+ * // Ensure final state is sent
+ * await updater.flush();
+ * updater.stop();
+ * ```
+ */
+export declare function createThrottledUpdater(updateFn: (text: string) => Promise<void>, intervalMs: number): ThrottledUpdater;
+//# sourceMappingURL=ThrottledUpdater.d.ts.map

package/dist/ThrottledUpdater.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ThrottledUpdater.d.ts","sourceRoot":"","sources":["../src/ThrottledUpdater.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,2CAA2C;IAC3C,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,2CAA2C;IAC3C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,sDAAsD;IACtD,IAAI,IAAI,IAAI,CAAC;CACd;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,EACzC,UAAU,EAAE,MAAM,GACjB,gBAAgB,CA0ElB"}

package/dist/ThrottledUpdater.js

@@ -0,0 +1,100 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createThrottledUpdater = createThrottledUpdater;
+/**
+ * Create a throttled message updater
+ *
+ * Limits how frequently the update function is called while ensuring
+ * the most recent content is always eventually sent.
+ *
+ * @param updateFn - Async function to call with updated text
+ * @param intervalMs - Minimum interval between updates
+ * @returns ThrottledUpdater instance
+ *
+ * @example
+ * ```typescript
+ * const updater = createThrottledUpdater(
+ *   (text) => message.edit(text),
+ *   2000
+ * );
+ *
+ * // These rapid updates will be batched
+ * updater.update('Step 1...');
+ * updater.update('Step 2...');
+ * updater.update('Step 3...');
+ *
+ * // Ensure final state is sent
+ * await updater.flush();
+ * updater.stop();
+ * ```
+ */
+function createThrottledUpdater(updateFn, intervalMs) {
+    let lastUpdateTime = 0;
+    let pendingText = null;
+    let timeoutId = null;
+    let stopped = false;
+    const doUpdate = async (text) => {
+        if (stopped) {
+            return;
+        }
+        lastUpdateTime = Date.now();
+        pendingText = null;
+        try {
+            await updateFn(text);
+        }
+        catch {
+            // Errors are handled by the caller's updateFn
+        }
+    };
+    const scheduleUpdate = () => {
+        if (timeoutId || stopped || pendingText === null) {
+            return;
+        }
+        const elapsed = Date.now() - lastUpdateTime;
+        const delay = Math.max(0, intervalMs - elapsed);
+        timeoutId = setTimeout(() => {
+            timeoutId = null;
+            if (pendingText !== null && !stopped) {
+                void doUpdate(pendingText);
+            }
+        }, delay);
+    };
+    return {
+        update(text) {
+            if (stopped) {
+                return;
+            }
+            const now = Date.now();
+            if (now - lastUpdateTime >= intervalMs) {
+                // Enough time has passed, update immediately
+                void doUpdate(text);
+            }
+            else {
+                // Store for later and schedule if needed
+                pendingText = text;
+                scheduleUpdate();
+            }
+        },
+        async flush() {
+            if (stopped) {
+                return;
+            }
+            if (timeoutId) {
+                clearTimeout(timeoutId);
+                timeoutId = null;
+            }
+            if (pendingText !== null) {
+                await doUpdate(pendingText);
+            }
+        },
+        stop() {
+            stopped = true;
+            if (timeoutId) {
+                clearTimeout(timeoutId);
+                timeoutId = null;
+            }
+            pendingText = null;
+        },
+    };
+}
+//# sourceMappingURL=ThrottledUpdater.js.map

package/dist/ThrottledUpdater.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ThrottledUpdater.js","sourceRoot":"","sources":["../src/ThrottledUpdater.ts"],"names":[],"mappings":";;AA0CA,wDA6EC;AAxGD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,SAAgB,sBAAsB,CACpC,QAAyC,EACzC,UAAkB;IAElB,IAAI,cAAc,GAAG,CAAC,CAAC;IACvB,IAAI,WAAW,GAAkB,IAAI,CAAC;IACtC,IAAI,SAAS,GAAyC,IAAI,CAAC;IAC3D,IAAI,OAAO,GAAG,KAAK,CAAC;IAEpB,MAAM,QAAQ,GAAG,KAAK,EAAE,IAAY,EAAiB,EAAE;QACrD,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO;QACT,CAAC;QACD,cAAc,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC5B,WAAW,GAAG,IAAI,CAAC;QACnB,IAAI,CAAC;YACH,MAAM,QAAQ,CAAC,IAAI,CAAC,CAAC;QACvB,CAAC;QAAC,MAAM,CAAC;YACP,8CAA8C;QAChD,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,cAAc,GAAG,GAAS,EAAE;QAChC,IAAI,SAAS,IAAI,OAAO,IAAI,WAAW,KAAK,IAAI,EAAE,CAAC;YACjD,OAAO;QACT,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,cAAc,CAAC;QAC5C,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,CAAC;QAEhD,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE;YAC1B,SAAS,GAAG,IAAI,CAAC;YACjB,IAAI,WAAW,KAAK,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;gBACrC,KAAK,QAAQ,CAAC,WAAW,CAAC,CAAC;YAC7B,CAAC;QACH,CAAC,EAAE,KAAK,CAAC,CAAC;IACZ,CAAC,CAAC;IAEF,OAAO;QACL,MAAM,CAAC,IAAY;YACjB,IAAI,OAAO,EAAE,CAAC;gBACZ,OAAO;YACT,CAAC;YAED,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YACvB,IAAI,GAAG,GAAG,cAAc,IAAI,UAAU,EAAE,CAAC;gBACvC,6CAA6C;gBAC7C,KAAK,QAAQ,CAAC,IAAI,CAAC,CAAC;YACtB,CAAC;iBAAM,CAAC;gBACN,yCAAyC;gBACzC,WAAW,GAAG,IAAI,CAAC;gBACnB,cAAc,EAAE,CAAC;YACnB,CAAC;QACH,CAAC;QAED,KAAK,CAAC,KAAK;YACT,IAAI,OAAO,EAAE,CAAC;gBACZ,OAAO;YACT,CAAC;YACD,IAAI,SAAS,EAAE,CAAC;gBACd,YAAY,CAAC,SAAS,CAAC,CAAC;gBACxB,SAAS,GAAG,IAAI,CAAC;YACnB,CAAC;YACD,IAAI,WAAW,KAAK,IAAI,EAAE,CAAC;gBACzB,MAAM,QAAQ,CAAC,WAAW,CAAC,CAAC;YAC9B,CAAC;QACH,CAAC;QAED,IAAI;YACF,OAAO,GAAG,IAAI,CAAC;YACf,IAAI,SAAS,EAAE,CAAC;gBACd,YAAY,CAAC,SAAS,CAAC,CAAC;gBACxB,SAAS,GAAG,IAAI,CAAC;YACnB,CAAC;YACD,WAAW,GAAG,IAAI,CAAC;QACrB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/backoff.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Exponential backoff utilities for retry logic
+ */
+export interface BackoffOptions {
+    /** Initial delay in milliseconds (default: 1000) */
+    initialDelayMs?: number;
+    /** Maximum delay in milliseconds (default: 60000) */
+    maxDelayMs?: number;
+}
+/**
+ * Calculate exponential backoff delay for a given attempt number
+ * Uses formula: min(initialDelay * 2^attempt, maxDelay)
+ *
+ * @param attempt - The attempt number (0-indexed)
+ * @param options - Configuration options
+ * @returns Delay in milliseconds
+ */
+export declare function getBackoffDelay(attempt: number, options?: BackoffOptions): number;
+/**
+ * Sleep for the specified duration
+ */
+export declare function sleep(ms: number): Promise<void>;
+/**
+ * Get a randomized delay for retry logic
+ * Returns a delay between minMs and maxMs (inclusive)
+ */
+export declare function getRandomDelay(minMs: number, maxMs: number): number;
+//# sourceMappingURL=backoff.d.ts.map

package/dist/backoff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backoff.d.ts","sourceRoot":"","sources":["../src/backoff.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,cAAc;IAC7B,oDAAoD;IACpD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,qDAAqD;IACrD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAKD;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,cAAmB,GAC3B,MAAM,CAKR;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAI/C;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAEnE"}

package/dist/backoff.js

@@ -0,0 +1,40 @@
+"use strict";
+/**
+ * Exponential backoff utilities for retry logic
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getBackoffDelay = getBackoffDelay;
+exports.sleep = sleep;
+exports.getRandomDelay = getRandomDelay;
+const DEFAULT_INITIAL_DELAY_MS = 1000;
+const DEFAULT_MAX_DELAY_MS = 60000;
+/**
+ * Calculate exponential backoff delay for a given attempt number
+ * Uses formula: min(initialDelay * 2^attempt, maxDelay)
+ *
+ * @param attempt - The attempt number (0-indexed)
+ * @param options - Configuration options
+ * @returns Delay in milliseconds
+ */
+function getBackoffDelay(attempt, options = {}) {
+    const initialDelay = options.initialDelayMs ?? DEFAULT_INITIAL_DELAY_MS;
+    const maxDelay = options.maxDelayMs ?? DEFAULT_MAX_DELAY_MS;
+    const delay = initialDelay * Math.pow(2, attempt);
+    return Math.min(delay, maxDelay);
+}
+/**
+ * Sleep for the specified duration
+ */
+function sleep(ms) {
+    return new Promise((resolve) => {
+        setTimeout(resolve, ms);
+    });
+}
+/**
+ * Get a randomized delay for retry logic
+ * Returns a delay between minMs and maxMs (inclusive)
+ */
+function getRandomDelay(minMs, maxMs) {
+    return Math.floor(Math.random() * (maxMs - minMs + 1)) + minMs;
+}
+//# sourceMappingURL=backoff.js.map

package/dist/backoff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backoff.js","sourceRoot":"","sources":["../src/backoff.ts"],"names":[],"mappings":";AAAA;;GAEG;;AAoBH,0CAQC;AAKD,sBAIC;AAMD,wCAEC;AApCD,MAAM,wBAAwB,GAAG,IAAI,CAAC;AACtC,MAAM,oBAAoB,GAAG,KAAK,CAAC;AAEnC;;;;;;;GAOG;AACH,SAAgB,eAAe,CAC7B,OAAe,EACf,UAA0B,EAAE;IAE5B,MAAM,YAAY,GAAG,OAAO,CAAC,cAAc,IAAI,wBAAwB,CAAC;IACxE,MAAM,QAAQ,GAAG,OAAO,CAAC,UAAU,IAAI,oBAAoB,CAAC;IAC5D,MAAM,KAAK,GAAG,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IAClD,OAAO,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;AACnC,CAAC;AAED;;GAEG;AACH,SAAgB,KAAK,CAAC,EAAU;IAC9B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAC1B,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,SAAgB,cAAc,CAAC,KAAa,EAAE,KAAa;IACzD,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC;AACjE,CAAC"}

package/dist/index.d.ts

@@ -1,2 +1,5 @@
 export { Throttle, type ThrottleOptions, type ThrottleSleepInfo, } from "./Throttle";
+export { getBackoffDelay, sleep, getRandomDelay, type BackoffOptions, } from "./backoff";
+export { isConnectionError } from "./isConnectionError";
+export { createThrottledUpdater, type ThrottledUpdater, } from "./ThrottledUpdater";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,QAAQ,EACR,KAAK,eAAe,EACpB,KAAK,iBAAiB,GACvB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,QAAQ,EACR,KAAK,eAAe,EACpB,KAAK,iBAAiB,GACvB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,eAAe,EACf,KAAK,EACL,cAAc,EACd,KAAK,cAAc,GACpB,MAAM,WAAW,CAAC;AAEnB,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD,OAAO,EACL,sBAAsB,EACtB,KAAK,gBAAgB,GACtB,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -1,6 +1,14 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Throttle = void 0;
+exports.createThrottledUpdater = exports.isConnectionError = exports.getRandomDelay = exports.sleep = exports.getBackoffDelay = exports.Throttle = void 0;
 var Throttle_1 = require("./Throttle");
 Object.defineProperty(exports, "Throttle", { enumerable: true, get: function () { return Throttle_1.Throttle; } });
+var backoff_1 = require("./backoff");
+Object.defineProperty(exports, "getBackoffDelay", { enumerable: true, get: function () { return backoff_1.getBackoffDelay; } });
+Object.defineProperty(exports, "sleep", { enumerable: true, get: function () { return backoff_1.sleep; } });
+Object.defineProperty(exports, "getRandomDelay", { enumerable: true, get: function () { return backoff_1.getRandomDelay; } });
+var isConnectionError_1 = require("./isConnectionError");
+Object.defineProperty(exports, "isConnectionError", { enumerable: true, get: function () { return isConnectionError_1.isConnectionError; } });
+var ThrottledUpdater_1 = require("./ThrottledUpdater");
+Object.defineProperty(exports, "createThrottledUpdater", { enumerable: true, get: function () { return ThrottledUpdater_1.createThrottledUpdater; } });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,uCAIoB;AAHlB,oGAAA,QAAQ,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,uCAIoB;AAHlB,oGAAA,QAAQ,OAAA;AAKV,qCAKmB;AAJjB,0GAAA,eAAe,OAAA;AACf,gGAAA,KAAK,OAAA;AACL,yGAAA,cAAc,OAAA;AAIhB,yDAAwD;AAA/C,sHAAA,iBAAiB,OAAA;AAE1B,uDAG4B;AAF1B,0HAAA,sBAAsB,OAAA"}

package/dist/isConnectionError.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Connection error detection utilities
+ */
+/**
+ * Check if an error is a connection error (e.g., ECONNREFUSED when Ollama is not running).
+ * Walks the error chain (cause, errors, lastError) to find connection indicators.
+ */
+export declare function isConnectionError(error: unknown): boolean;
+//# sourceMappingURL=isConnectionError.d.ts.map

package/dist/isConnectionError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"isConnectionError.d.ts","sourceRoot":"","sources":["../src/isConnectionError.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CA4CzD"}

package/dist/isConnectionError.js

@@ -0,0 +1,46 @@
+"use strict";
+/**
+ * Connection error detection utilities
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isConnectionError = isConnectionError;
+/**
+ * Check if an error is a connection error (e.g., ECONNREFUSED when Ollama is not running).
+ * Walks the error chain (cause, errors, lastError) to find connection indicators.
+ */
+function isConnectionError(error) {
+    if (!(error instanceof Error)) {
+        return false;
+    }
+    const message = error.message.toLowerCase();
+    // Check the top-level message
+    if (message.includes("econnrefused") ||
+        message.includes("cannot connect to api")) {
+        return true;
+    }
+    // Check nested error properties from AI SDK RetryError / APICallError
+    const err = error;
+    if (err.lastError instanceof Error) {
+        if (isConnectionError(err.lastError)) {
+            return true;
+        }
+    }
+    if (err.cause instanceof Error) {
+        if (isConnectionError(err.cause)) {
+            return true;
+        }
+    }
+    if (Array.isArray(err.errors)) {
+        for (const nested of err.errors) {
+            if (isConnectionError(nested)) {
+                return true;
+            }
+        }
+    }
+    // Check for Node.js error code
+    if (err.code === "ECONNREFUSED") {
+        return true;
+    }
+    return false;
+}
+//# sourceMappingURL=isConnectionError.js.map

package/dist/isConnectionError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"isConnectionError.js","sourceRoot":"","sources":["../src/isConnectionError.ts"],"names":[],"mappings":";AAAA;;GAEG;;AAMH,8CA4CC;AAhDD;;;GAGG;AACH,SAAgB,iBAAiB,CAAC,KAAc;IAC9C,IAAI,CAAC,CAAC,KAAK,YAAY,KAAK,CAAC,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;IAE5C,8BAA8B;IAC9B,IACE,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC;QAChC,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAAC,EACzC,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,sEAAsE;IACtE,MAAM,GAAG,GAAG,KAA2C,CAAC;IAExD,IAAI,GAAG,CAAC,SAAS,YAAY,KAAK,EAAE,CAAC;QACnC,IAAI,iBAAiB,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;YACrC,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,IAAI,GAAG,CAAC,KAAK,YAAY,KAAK,EAAE,CAAC;QAC/B,IAAI,iBAAiB,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YACjC,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;QAC9B,KAAK,MAAM,MAAM,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;YAChC,IAAI,iBAAiB,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC9B,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;IACH,CAAC;IAED,+BAA+B;IAC/B,IAAI,GAAG,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;QAChC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hardlydifficult/throttle",
-  "version": "2.0.0",
+  "version": "3.0.0",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "files": [
@@ -15,7 +15,7 @@
     "clean": "rm -rf dist"
   },
   "dependencies": {
-    "@hardlydifficult/state-tracker": "file:../state-tracker"
+    "@hardlydifficult/state-tracker": "2.0.0"
   },
   "devDependencies": {
     "@types/node": "20.19.31",
@@ -23,7 +23,7 @@
     "vitest": "1.6.1"
   },
   "peerDependencies": {
-    "@hardlydifficult/state-tracker": ">=1.0.0"
+    "@hardlydifficult/state-tracker": "2.0.0"
   },
   "engines": {
     "node": ">=18.0.0"