@hardlydifficult/throttle 1.0.0 → 3.0.0

package/README.md

@@ -1,6 +1,6 @@
 # @hardlydifficult/throttle
 
-Rate limiting utilities with optional state persistence.
+Rate limiting, exponential backoff, connection error detection, and throttled message updates.
 
 ## Installation
 
@@ -8,35 +8,96 @@ Rate limiting utilities with optional state persistence.
 npm install @hardlydifficult/throttle
 ```
 
-## Throttle
+## API
 
-Delay-based rate limiting with human-readable durations.
+### `Throttle`
+
+Token-bucket rate limiter with optional persistent state.
 
 ```typescript
-import { Throttle } from '@hardlydifficult/throttle';
+import { Throttle } from "@hardlydifficult/throttle";
 
 const throttle = new Throttle({
-  minimumDelay: { value: 1.5, unit: 'minutes' },
-  onSleep: (ms) => console.log(`Sleeping ${ms}ms`),
+  unitsPerSecond: 10,
+  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(); // resolves immediately
-await throttle.wait(); // sleeps 90s before resolving
+await throttle.wait(); // waits if needed to stay within rate limit
+await throttle.wait(5); // consume 5 units
 ```
 
-## WeightedThrottle
+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) |
 
-Per-operation weight support with optional state persistence across restarts.
+### `getBackoffDelay(attempt: number, options?: BackoffOptions): number`
+
+Calculate exponential backoff delay: `min(initialDelay * 2^attempt, maxDelay)`.
 
 ```typescript
-import { WeightedThrottle } from '@hardlydifficult/throttle';
+import { getBackoffDelay } from "@hardlydifficult/throttle";
 
-const throttle = new WeightedThrottle({
-  unitsPerSecond: 10,
-  persistKey: 'api-throttle', // optional: survives restarts
-  onSleep: (ms, info) => console.log(`Sleeping ${ms}ms (weight: ${info.weight})`),
-});
+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`
 
-await throttle.wait(5);  // consumes 5 units
-await throttle.wait(10); // consumes 10 units, sleeps if needed
+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/Throttle.d.ts

@@ -1,13 +1,20 @@
-import { type TimeSpan } from "@hardlydifficult/date-time";
+export interface ThrottleSleepInfo {
+    weight: number;
+    limitPerSecond: number;
+    scheduledStart: number;
+}
 export interface ThrottleOptions {
-    minimumDelay: TimeSpan;
-    onSleep?: (ms: number) => void;
+    unitsPerSecond: number;
+    persistKey?: string;
+    stateDirectory?: string;
+    onSleep?: (delayMs: number, info: ThrottleSleepInfo) => void;
 }
 export declare class Throttle {
-    private lastTimestamp;
-    private readonly minimumDelayMs;
+    private nextAvailableAt;
+    private readonly unitsPerSecond;
+    private readonly stateTracker?;
     private readonly onSleep?;
     constructor(options: ThrottleOptions);
-    wait(): Promise<void>;
+    wait(weight?: number): Promise<void>;
 }
 //# sourceMappingURL=Throttle.d.ts.map

package/dist/Throttle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Throttle.d.ts","sourceRoot":"","sources":["../src/Throttle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,QAAQ,EAAkB,MAAM,4BAA4B,CAAC;AAO3E,MAAM,WAAW,eAAe;IAC9B,YAAY,EAAE,QAAQ,CAAC;IACvB,OAAO,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;CAChC;AAED,qBAAa,QAAQ;IACnB,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAuB;gBAEpC,OAAO,EAAE,eAAe;IAQ9B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAY5B"}
+{"version":3,"file":"Throttle.d.ts","sourceRoot":"","sources":["../src/Throttle.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,eAAe;IAC9B,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,KAAK,IAAI,CAAC;CAC9D;AAED,qBAAa,QAAQ;IACnB,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAuB;IACrD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAqD;gBAElE,OAAO,EAAE,eAAe;IAoB9B,IAAI,CAAC,MAAM,SAAI,GAAG,OAAO,CAAC,IAAI,CAAC;CAuBtC"}

package/dist/Throttle.js

@@ -1,29 +1,51 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Throttle = void 0;
-const date_time_1 = require("@hardlydifficult/date-time");
+const state_tracker_1 = require("@hardlydifficult/state-tracker");
 const sleep = (ms) => new Promise((resolve) => {
     setTimeout(resolve, ms);
 });
 class Throttle {
-    lastTimestamp = 0;
-    minimumDelayMs;
+    nextAvailableAt;
+    unitsPerSecond;
+    stateTracker;
     onSleep;
     constructor(options) {
-        this.minimumDelayMs = (0, date_time_1.toMilliseconds)(options.minimumDelay);
-        if (this.minimumDelayMs <= 0) {
-            throw new Error("Throttle minimumDelay must be a positive duration");
-        }
+        this.unitsPerSecond = options.unitsPerSecond;
         this.onSleep = options.onSleep;
+        if (!Number.isFinite(this.unitsPerSecond) || this.unitsPerSecond <= 0) {
+            throw new Error("Throttle requires a positive unitsPerSecond value");
+        }
+        if (options.persistKey !== undefined) {
+            this.stateTracker = new state_tracker_1.StateTracker({
+                key: options.persistKey,
+                default: Date.now(),
+                stateDirectory: options.stateDirectory,
+            });
+            this.nextAvailableAt = this.stateTracker.load();
+        }
+        else {
+            this.nextAvailableAt = 0;
+        }
     }
-    async wait() {
+    async wait(weight = 1) {
+        if (!Number.isFinite(weight) || weight <= 0) {
+            return;
+        }
         const now = Date.now();
-        const target = Math.max(now, this.lastTimestamp + this.minimumDelayMs);
-        const delay = target - now;
-        this.lastTimestamp = target;
-        if (delay > 0) {
-            this.onSleep?.(delay);
-            await sleep(delay);
+        const startAt = Math.max(now, this.nextAvailableAt);
+        const processingWindowMs = (weight / this.unitsPerSecond) * 1000;
+        const delayMs = startAt - now;
+        const newNextAvailableAt = startAt + processingWindowMs;
+        this.stateTracker?.save(newNextAvailableAt);
+        this.nextAvailableAt = newNextAvailableAt;
+        if (delayMs > 0) {
+            this.onSleep?.(delayMs, {
+                weight,
+                limitPerSecond: this.unitsPerSecond,
+                scheduledStart: startAt,
+            });
+            await sleep(delayMs);
         }
     }
 }

package/dist/Throttle.js.map

@@ -1 +1 @@
-{"version":3,"file":"Throttle.js","sourceRoot":"","sources":["../src/Throttle.ts"],"names":[],"mappings":";;;AAAA,0DAA2E;AAE3E,MAAM,KAAK,GAAG,CAAC,EAAU,EAAiB,EAAE,CAC1C,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;IACtB,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;AAC1B,CAAC,CAAC,CAAC;AAOL,MAAa,QAAQ;IACX,aAAa,GAAG,CAAC,CAAC;IACT,cAAc,CAAS;IACvB,OAAO,CAAwB;IAEhD,YAAY,OAAwB;QAClC,IAAI,CAAC,cAAc,GAAG,IAAA,0BAAc,EAAC,OAAO,CAAC,YAAY,CAAC,CAAC;QAC3D,IAAI,IAAI,CAAC,cAAc,IAAI,CAAC,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;QACvE,CAAC;QACD,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IACjC,CAAC;IAED,KAAK,CAAC,IAAI;QACR,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,cAAc,CAAC,CAAC;QACvE,MAAM,KAAK,GAAG,MAAM,GAAG,GAAG,CAAC;QAE3B,IAAI,CAAC,aAAa,GAAG,MAAM,CAAC;QAE5B,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;YACd,IAAI,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC;YACtB,MAAM,KAAK,CAAC,KAAK,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;CACF;AAzBD,4BAyBC"}
+{"version":3,"file":"Throttle.js","sourceRoot":"","sources":["../src/Throttle.ts"],"names":[],"mappings":";;;AAAA,kEAA8D;AAE9D,MAAM,KAAK,GAAG,CAAC,EAAU,EAAiB,EAAE,CAC1C,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;IACtB,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;AAC1B,CAAC,CAAC,CAAC;AAeL,MAAa,QAAQ;IACX,eAAe,CAAS;IACf,cAAc,CAAS;IACvB,YAAY,CAAwB;IACpC,OAAO,CAAsD;IAE9E,YAAY,OAAwB;QAClC,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;QAC7C,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;QAE/B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,IAAI,CAAC,cAAc,IAAI,CAAC,EAAE,CAAC;YACtE,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;QACvE,CAAC;QAED,IAAI,OAAO,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;YACrC,IAAI,CAAC,YAAY,GAAG,IAAI,4BAAY,CAAC;gBACnC,GAAG,EAAE,OAAO,CAAC,UAAU;gBACvB,OAAO,EAAE,IAAI,CAAC,GAAG,EAAE;gBACnB,cAAc,EAAE,OAAO,CAAC,cAAc;aACvC,CAAC,CAAC;YACH,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC;QAClD,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,eAAe,GAAG,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC;QACnB,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,IAAI,CAAC,EAAE,CAAC;YAC5C,OAAO;QACT,CAAC;QAED,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,eAAe,CAAC,CAAC;QACpD,MAAM,kBAAkB,GAAG,CAAC,MAAM,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,IAAI,CAAC;QACjE,MAAM,OAAO,GAAG,OAAO,GAAG,GAAG,CAAC;QAC9B,MAAM,kBAAkB,GAAG,OAAO,GAAG,kBAAkB,CAAC;QAExD,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,kBAAkB,CAAC,CAAC;QAC5C,IAAI,CAAC,eAAe,GAAG,kBAAkB,CAAC;QAE1C,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;YAChB,IAAI,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE;gBACtB,MAAM;gBACN,cAAc,EAAE,IAAI,CAAC,cAAc;gBACnC,cAAc,EAAE,OAAO;aACxB,CAAC,CAAC;YACH,MAAM,KAAK,CAAC,OAAO,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;CACF;AAjDD,4BAiDC"}

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,3 +1,5 @@
-export { Throttle, type ThrottleOptions } from "./Throttle";
-export { WeightedThrottle, type WeightedThrottleOptions, type WeightedThrottleSleepInfo, } from "./WeightedThrottle";
+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,EAAE,QAAQ,EAAE,KAAK,eAAe,EAAE,MAAM,YAAY,CAAC;AAC5D,OAAO,EACL,gBAAgB,EAChB,KAAK,uBAAuB,EAC5B,KAAK,yBAAyB,GAC/B,MAAM,oBAAoB,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,8 +1,14 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.WeightedThrottle = 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 WeightedThrottle_1 = require("./WeightedThrottle");
-Object.defineProperty(exports, "WeightedThrottle", { enumerable: true, get: function () { return WeightedThrottle_1.WeightedThrottle; } });
+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,uCAA4D;AAAnD,oGAAA,QAAQ,OAAA;AACjB,uDAI4B;AAH1B,oHAAA,gBAAgB,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": "1.0.0",
+  "version": "3.0.0",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "files": [
@@ -15,8 +15,7 @@
     "clean": "rm -rf dist"
   },
   "dependencies": {
-    "@hardlydifficult/state-tracker": "1.0.0",
-    "@hardlydifficult/date-time": "1.0.0"
+    "@hardlydifficult/state-tracker": "2.0.0"
   },
   "devDependencies": {
     "@types/node": "20.19.31",
@@ -24,8 +23,7 @@
     "vitest": "1.6.1"
   },
   "peerDependencies": {
-    "@hardlydifficult/state-tracker": "1.0.0",
-    "@hardlydifficult/date-time": "1.0.0"
+    "@hardlydifficult/state-tracker": "2.0.0"
   },
   "engines": {
     "node": ">=18.0.0"

package/dist/WeightedThrottle.d.ts

@@ -1,20 +0,0 @@
-export interface WeightedThrottleSleepInfo {
-    weight: number;
-    limitPerSecond: number;
-    scheduledStart: number;
-}
-export interface WeightedThrottleOptions {
-    unitsPerSecond: number;
-    persistKey?: string;
-    stateDirectory?: string;
-    onSleep?: (delayMs: number, info: WeightedThrottleSleepInfo) => void;
-}
-export declare class WeightedThrottle {
-    private nextAvailableAt;
-    private readonly unitsPerSecond;
-    private readonly stateTracker?;
-    private readonly onSleep?;
-    constructor(options: WeightedThrottleOptions);
-    wait(weight: number): Promise<void>;
-}
-//# sourceMappingURL=WeightedThrottle.d.ts.map

package/dist/WeightedThrottle.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"WeightedThrottle.d.ts","sourceRoot":"","sources":["../src/WeightedThrottle.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,yBAAyB;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,uBAAuB;IACtC,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,yBAAyB,KAAK,IAAI,CAAC;CACtE;AAED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAuB;IACrD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAGf;gBAEE,OAAO,EAAE,uBAAuB;IAsBtC,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAuB1C"}

package/dist/WeightedThrottle.js

@@ -1,53 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.WeightedThrottle = void 0;
-const state_tracker_1 = require("@hardlydifficult/state-tracker");
-const sleep = (ms) => new Promise((resolve) => {
-    setTimeout(resolve, ms);
-});
-class WeightedThrottle {
-    nextAvailableAt;
-    unitsPerSecond;
-    stateTracker;
-    onSleep;
-    constructor(options) {
-        this.unitsPerSecond = options.unitsPerSecond;
-        this.onSleep = options.onSleep;
-        if (!Number.isFinite(this.unitsPerSecond) || this.unitsPerSecond <= 0) {
-            throw new Error("WeightedThrottle requires a positive unitsPerSecond value");
-        }
-        if (options.persistKey !== undefined) {
-            this.stateTracker = new state_tracker_1.StateTracker({
-                key: options.persistKey,
-                default: Date.now(),
-                stateDirectory: options.stateDirectory,
-            });
-            this.nextAvailableAt = this.stateTracker.load();
-        }
-        else {
-            this.nextAvailableAt = 0;
-        }
-    }
-    async wait(weight) {
-        if (!Number.isFinite(weight) || weight <= 0) {
-            return;
-        }
-        const now = Date.now();
-        const startAt = Math.max(now, this.nextAvailableAt);
-        const processingWindowMs = (weight / this.unitsPerSecond) * 1000;
-        const delayMs = startAt - now;
-        const newNextAvailableAt = startAt + processingWindowMs;
-        this.stateTracker?.save(newNextAvailableAt);
-        this.nextAvailableAt = newNextAvailableAt;
-        if (delayMs > 0) {
-            this.onSleep?.(delayMs, {
-                weight,
-                limitPerSecond: this.unitsPerSecond,
-                scheduledStart: startAt,
-            });
-            await sleep(delayMs);
-        }
-    }
-}
-exports.WeightedThrottle = WeightedThrottle;
-//# sourceMappingURL=WeightedThrottle.js.map

package/dist/WeightedThrottle.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"WeightedThrottle.js","sourceRoot":"","sources":["../src/WeightedThrottle.ts"],"names":[],"mappings":";;;AAAA,kEAA8D;AAE9D,MAAM,KAAK,GAAG,CAAC,EAAU,EAAiB,EAAE,CAC1C,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;IACtB,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;AAC1B,CAAC,CAAC,CAAC;AAeL,MAAa,gBAAgB;IACnB,eAAe,CAAS;IACf,cAAc,CAAS;IACvB,YAAY,CAAwB;IACpC,OAAO,CAGd;IAEV,YAAY,OAAgC;QAC1C,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;QAC7C,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;QAE/B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,IAAI,CAAC,cAAc,IAAI,CAAC,EAAE,CAAC;YACtE,MAAM,IAAI,KAAK,CACb,2DAA2D,CAC5D,CAAC;QACJ,CAAC;QAED,IAAI,OAAO,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;YACrC,IAAI,CAAC,YAAY,GAAG,IAAI,4BAAY,CAAC;gBACnC,GAAG,EAAE,OAAO,CAAC,UAAU;gBACvB,OAAO,EAAE,IAAI,CAAC,GAAG,EAAE;gBACnB,cAAc,EAAE,OAAO,CAAC,cAAc;aACvC,CAAC,CAAC;YACH,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC;QAClD,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,eAAe,GAAG,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,MAAc;QACvB,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,IAAI,CAAC,EAAE,CAAC;YAC5C,OAAO;QACT,CAAC;QAED,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,eAAe,CAAC,CAAC;QACpD,MAAM,kBAAkB,GAAG,CAAC,MAAM,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,IAAI,CAAC;QACjE,MAAM,OAAO,GAAG,OAAO,GAAG,GAAG,CAAC;QAC9B,MAAM,kBAAkB,GAAG,OAAO,GAAG,kBAAkB,CAAC;QAExD,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,kBAAkB,CAAC,CAAC;QAC5C,IAAI,CAAC,eAAe,GAAG,kBAAkB,CAAC;QAE1C,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;YAChB,IAAI,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE;gBACtB,MAAM;gBACN,cAAc,EAAE,IAAI,CAAC,cAAc;gBACnC,cAAc,EAAE,OAAO;aACxB,CAAC,CAAC;YACH,MAAM,KAAK,CAAC,OAAO,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;CACF;AAtDD,4CAsDC"}