dynamic-throttled-queue 2.1.1-rc.bcc09d3 → 2.2.0-rc.7fbd417

package/README.md

@@ -26,7 +26,7 @@ throttle(() => {
 });
 ```
 
-Callbacks can return `false` to signal an error (used for dynamic rate adjustment and retry). Async callbacks (returning a Promise) are also supported — rejections and `false` resolutions count as errors.
+Callbacks can return `false` to signal a failure (used for dynamic rate adjustment and retry). Async callbacks (returning a Promise) are also supported — rejections and `false` resolutions count as failures. By default, every failure reduces the adaptive rate; use `rateOutcomeClassifier` when only selected failures should do so.
 
 Set `concurrency` to bound callbacks that are still awaiting asynchronous completion. This limit is independent of the request-start rate; omitting it preserves the existing unlimited in-flight behavior.
 
@@ -43,6 +43,8 @@ Set `concurrency` to bound callbacks that are still awaiting asynchronous comple
 | `retry` | `number` | `0` | Non-negative integer number of times to retry failed callbacks |
 | `concurrency` | `number` | — | Maximum callbacks awaiting asynchronous completion; omit for no limit |
 | `compact_threshold` | `number` | `512` | Non-negative integer minimum dead slots before internal queue compaction triggers; `0` compacts at the earliest eligible point |
+| `rateStrategy` | `RateStrategy` | `linear` | Pure policy that requests the next rate and an optional backoff after each observation window |
+| `rateOutcomeClassifier` | `RateOutcomeClassifier` | — | Decides whether a failed callback outcome contributes to adaptive-rate error counting |
 | `onRateChange` | `(rate: number) => void` | — | Called when the current rate changes |
 
 `retry`, `errors_per_interval`, and `compact_threshold` reject fractional and non-finite values. `errors_per_interval` must be at least `1`; `retry` and `compact_threshold` may be `0`.
@@ -117,6 +119,85 @@ for (let i = 0; i < 100; i++) {
 }
 ```
 
+### Rate outcome classification
+
+`rateOutcomeClassifier` receives only failed callback outcomes and returns whether each one should reduce the adaptive rate. It does not change retry eligibility: `false`, thrown errors, and rejected promises still retry under the existing `retry` option.
+
+```ts
+import {
+  createThrottledQueue,
+  type RateFailureOutcome,
+} from "dynamic-throttled-queue";
+
+function affectsCapacity(outcome: RateFailureOutcome) {
+  if (outcome.kind === "returned-false") return false;
+
+  // Treat HTTP 429 and 5xx as capacity signals, while ignoring other failures.
+  const status = (outcome.error as { status?: number }).status;
+  return status === 429 || (status !== undefined && status >= 500 && status < 600);
+}
+
+const throttle = createThrottledQueue({
+  min_rpi: 1,
+  max_rpi: 10,
+  interval: 1000,
+  rateOutcomeClassifier: affectsCapacity,
+});
+```
+
+The normalized outcomes are `{ kind: "returned-false" }`, `{ kind: "thrown", error }`, and `{ kind: "rejected", error }`. Omitting the classifier preserves the default behavior: every failure reduces the adaptive rate. If the classifier throws, the original failure safely counts as rate-reducing and no separate classifier error is surfaced.
+
+### Rate strategies
+
+The default `linear` strategy preserves the adaptive behavior above: it changes the rate by one request per interval. Use `aimd` when a capacity signal should reduce throughput more quickly while recovery remains gradual. AIMD increases by a fixed amount after a clean eligible observation window and reduces the rate by a multiplier when the error threshold is reached.
+
+```ts
+import { aimd, createThrottledQueue } from "dynamic-throttled-queue";
+
+const throttle = createThrottledQueue({
+  min_rpi: 1,
+  max_rpi: 100,
+  interval: 1000,
+  rateStrategy: aimd({ increaseBy: 2, decreaseFactor: 0.5 }),
+});
+```
+
+`aimd()` defaults to `{ increaseBy: 1, decreaseFactor: 0.5 }`. `increaseBy` must be a positive integer; `decreaseFactor` must be greater than `0` and less than `1`. AIMD uses `Math.floor(currentRate * decreaseFactor)` when reducing the rate, then the queue applies its configured `min_rpi` and `max_rpi` bounds. Like `linear`, it holds steady for partial-error, empty, and immediately-post-backoff observation windows.
+
+You can also import and pass `linear` explicitly, or provide a custom pure strategy:
+
+```ts
+import {
+  createThrottledQueue,
+  linear,
+  type RateStrategy,
+} from "dynamic-throttled-queue";
+
+const conservative: RateStrategy = ({
+  currentRate,
+  minRate,
+  errorCount,
+  errorThreshold,
+}) => ({
+  nextRate: errorCount >= errorThreshold ? Math.max(minRate, currentRate - 1) : currentRate,
+  shouldBackOff: errorCount >= errorThreshold,
+});
+
+const throttle = createThrottledQueue({
+  min_rpi: 1,
+  max_rpi: 10,
+  interval: 1000,
+  rateStrategy: conservative,
+});
+
+// Equivalent to omitting rateStrategy:
+createThrottledQueue({ min_rpi: 1, max_rpi: 10, interval: 1000, rateStrategy: linear });
+```
+
+A `RateStrategy` receives a frozen observation with `currentRate`, `minRate`, `maxRate`, `errorCount`, `errorThreshold`, `hasPendingWork`, and `wasBackedOff`; it returns `{ nextRate, shouldBackOff }`. Every queue starts at the midpoint of its configured range. The queue clamps finite integer `nextRate` values to its bounds. `shouldBackOff` requests a pause, which the queue performs only when `back_off` is `true`.
+
+Strategies must return a finite integer `nextRate` and a boolean `shouldBackOff`. A malformed decision or a strategy exception permanently halts that queue, clears its timers, retains unstarted callbacks in `pending`, and surfaces the original error. Create a new queue instance to resume work.
+
 ### Backoff
 
 ```ts

package/dist/dynamic-throttled-queue.d.ts

@@ -1,3 +1,33 @@
+export type RateStrategyObservation = Readonly<{
+    currentRate: number;
+    minRate: number;
+    maxRate: number;
+    errorCount: number;
+    errorThreshold: number;
+    hasPendingWork: boolean;
+    wasBackedOff: boolean;
+}>;
+export type RateStrategyDecision = Readonly<{
+    nextRate: number;
+    shouldBackOff: boolean;
+}>;
+export type RateStrategy = (observation: RateStrategyObservation) => RateStrategyDecision;
+export type AimdOptions = {
+    increaseBy?: number;
+    decreaseFactor?: number;
+};
+export type RateFailureOutcome = Readonly<{
+    kind: "returned-false";
+}> | Readonly<{
+    kind: "thrown";
+    error: unknown;
+}> | Readonly<{
+    kind: "rejected";
+    error: unknown;
+}>;
+export type RateOutcomeClassifier = (outcome: RateFailureOutcome) => boolean;
+export declare const linear: RateStrategy;
+export declare function aimd({ increaseBy, decreaseFactor }?: AimdOptions): RateStrategy;
 /** Return `false` to signal failure (increments error count, triggers retry if configured). */
 export type ThrottleCallback = () => boolean | void | Promise<boolean | void>;
 export type ThrottleOptions = {
@@ -14,6 +44,10 @@ export type ThrottleOptions = {
     concurrency?: number;
     /** Non-negative integer dead slots before queue compaction triggers. Default 512. */
     compact_threshold?: number;
+    /** Policy used to request the next rate and any backoff after each observation window. */
+    rateStrategy?: RateStrategy;
+    /** Decides whether a failed callback outcome contributes to adaptive-rate error counting. */
+    rateOutcomeClassifier?: RateOutcomeClassifier;
     onRateChange?: (rate: number) => void;
 };
 export type ThrottleFn = (callback: ThrottleCallback) => void;

package/dist/dynamic-throttled-queue.js

@@ -1,5 +1,33 @@
+import { createRateController } from "./rate-controller.js";
+import { createScheduler } from "./scheduler.js";
+export const linear = ({ minRate, maxRate, currentRate, errorCount, errorThreshold, hasPendingWork, wasBackedOff, }) => {
+    if (errorCount >= errorThreshold) {
+        return { nextRate: Math.max(minRate, currentRate - 1), shouldBackOff: true };
+    }
+    if (!wasBackedOff && errorCount === 0 && hasPendingWork) {
+        return { nextRate: Math.min(maxRate, currentRate + 1), shouldBackOff: false };
+    }
+    return { nextRate: currentRate, shouldBackOff: false };
+};
+export function aimd({ increaseBy = 1, decreaseFactor = 0.5 } = {}) {
+    if (!Number.isInteger(increaseBy) || increaseBy < 1) {
+        throw new Error("increaseBy must be a positive integer");
+    }
+    if (!Number.isFinite(decreaseFactor) || decreaseFactor <= 0 || decreaseFactor >= 1) {
+        throw new Error("decreaseFactor must be a number greater than 0 and less than 1");
+    }
+    return ({ currentRate, errorCount, errorThreshold, hasPendingWork, wasBackedOff }) => {
+        if (errorCount >= errorThreshold) {
+            return { nextRate: Math.floor(currentRate * decreaseFactor), shouldBackOff: true };
+        }
+        if (!wasBackedOff && errorCount === 0 && hasPendingWork) {
+            return { nextRate: currentRate + increaseBy, shouldBackOff: false };
+        }
+        return { nextRate: currentRate, shouldBackOff: false };
+    };
+}
 export function createThrottledQueue(options) {
-    const { min_rpi, interval, max_rpi = min_rpi, evenly_spaced = true, back_off = false, retry = 0, concurrency, compact_threshold = 512, onRateChange, } = options;
+    const { min_rpi, interval, max_rpi = min_rpi, concurrency, retry = 0, compact_threshold = 512 } = options;
     const errors_per_interval = options.errors_per_interval ?? 5;
     if (!Number.isInteger(min_rpi) || min_rpi < 1) {
         throw new Error("min_rpi must be a positive integer");
@@ -22,156 +50,10 @@ export function createThrottledQueue(options) {
     if (!Number.isInteger(compact_threshold) || compact_threshold < 0) {
         throw new Error("compact_threshold must be a non-negative integer");
     }
-    let current_rpi = Math.ceil((max_rpi + min_rpi) / 2);
-    let dyn_interval = evenly_spaced ? interval / current_rpi : interval;
-    let dyn_requests_per_interval = evenly_spaced ? 1 : current_rpi;
-    let error_count = 0;
-    let skippedLast = false;
-    let isRunning = false;
-    let last_called = 0;
-    let timeout;
-    let dynTimeout;
-    let active_count = 0;
-    let isStopped = false;
-    const max_concurrency = concurrency ?? Infinity;
-    const queue = [];
-    let head = 0;
-    /** Halts timers. Retains unprocessed queue items; next enqueue resumes from where it left off. */
-    function halt() {
-        isRunning = false;
-        skippedLast = false;
-        clearTimeout(timeout);
-        timeout = undefined;
-        clearTimeout(dynTimeout);
-        dynTimeout = undefined;
-        if (head >= queue.length) {
-            queue.length = 0;
-            head = 0;
-        }
-    }
-    function stop() {
-        isStopped = true;
-        halt();
-    }
-    function handleResult(item, result) {
-        if (result === false) {
-            error_count++;
-            if (item.retries > 0) {
-                queue.push({ fn: item.fn, retries: item.retries - 1 });
-                if (!isRunning && !isStopped && queue.length > head) {
-                    start();
-                }
-            }
-        }
-    }
-    function handleSettlement(item, result, resume = false) {
-        active_count--;
-        handleResult(item, result);
-        // A released slot can unblock pending work; dequeue still observes rate pacing.
-        if (resume && isRunning && !skippedLast && queue.length > head) {
-            dequeue();
-        }
-    }
-    function dequeue() {
-        const threshold = last_called + dyn_interval;
-        const now = Date.now();
-        if (now < threshold) {
-            clearTimeout(timeout);
-            timeout = setTimeout(dequeue, threshold - now);
-            return;
-        }
-        // Retries appended by settlement are outside this batch and need another start opportunity.
-        const end = Math.min(head + dyn_requests_per_interval, queue.length);
-        let started = 0;
-        while (head < end && active_count < max_concurrency) {
-            const item = queue[head++];
-            active_count++;
-            if (started++ === 0) {
-                last_called = Date.now();
-            }
-            let result;
-            try {
-                result = item.fn();
-            }
-            catch {
-                handleSettlement(item, false);
-                continue;
-            }
-            if (result instanceof Promise) {
-                void result.then(value => handleSettlement(item, value, true), () => handleSettlement(item, false, true));
-            }
-            else {
-                handleSettlement(item, result);
-            }
-        }
-        // ponytail: splice is O(n), amortized by only firing when head > half array length
-        if (head > compact_threshold && head > queue.length / 2) {
-            queue.splice(0, head);
-            head = 0;
-        }
-        if (head >= queue.length) {
-            halt();
-            return;
-        }
-        if (active_count >= max_concurrency) {
-            return;
-        }
-        timeout = setTimeout(dequeue, dyn_interval);
-    }
-    function applyRate(newRpi) {
-        if (newRpi === current_rpi)
-            return;
-        current_rpi = newRpi;
-        onRateChange?.(current_rpi);
-        if (evenly_spaced) {
-            dyn_interval = interval / current_rpi;
-        }
-        else {
-            dyn_requests_per_interval = current_rpi;
-        }
-    }
-    // ponytail: async callbacks resolve after adjustRate fires — error_count may lag by one interval under async load
-    function adjustRate() {
-        dynTimeout = undefined;
-        const wasSkipped = skippedLast;
-        skippedLast = false;
-        if (error_count >= errors_per_interval) {
-            applyRate(Math.max(min_rpi, current_rpi - 1));
-            if (isRunning && back_off && !wasSkipped) {
-                clearTimeout(timeout);
-                skippedLast = true;
-                timeout = setTimeout(dequeue, dyn_interval + interval);
-            }
-        }
-        else if (!wasSkipped && error_count === 0 && queue.length > head) {
-            applyRate(Math.min(max_rpi, current_rpi + 1));
-        }
-        error_count = 0;
-        if (isRunning) {
-            dynTimeout = setTimeout(adjustRate, interval);
-        }
-    }
-    function start() {
-        if (skippedLast)
-            return;
-        isRunning = true;
-        last_called = Date.now();
-        clearTimeout(timeout);
-        timeout = setTimeout(dequeue, dyn_interval);
-        if (!dynTimeout) {
-            dynTimeout = setTimeout(adjustRate, interval);
-        }
-    }
-    function enqueue(callback) {
-        queue.push({ fn: callback, retries: retry });
-        isStopped = false;
-        if (!isRunning) {
-            start();
-        }
-    }
-    enqueue.stop = stop;
-    // ponytail: defineProperty needed for getter; stop is plain assignment
-    Object.defineProperty(enqueue, "pending", { get: () => queue.length - head });
-    return enqueue;
+    return createScheduler(options, createRateController({
+        min_rpi,
+        max_rpi,
+        errors_per_interval,
+    }, options.rateStrategy ?? linear));
 }
 //# sourceMappingURL=dynamic-throttled-queue.js.map

package/dist/dynamic-throttled-queue.js.map

@@ -1 +1 @@
-{"version":3,"file":"dynamic-throttled-queue.js","sourceRoot":"","sources":["../src/dynamic-throttled-queue.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"dynamic-throttled-queue.js","sourceRoot":"","sources":["../src/dynamic-throttled-queue.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,6BAA6B;AAC5D,OAAO,EAAE,eAAe,EAAE,uBAAuB;AA+BjD,MAAM,CAAC,MAAM,MAAM,GAAiB,CAAC,EACnC,OAAO,EACP,OAAO,EACP,WAAW,EACX,UAAU,EACV,cAAc,EACd,cAAc,EACd,YAAY,GACb,EAAE,EAAE;IACH,IAAI,UAAU,IAAI,cAAc,EAAE,CAAC;QACjC,OAAO,EAAE,QAAQ,EAAE,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,WAAW,GAAG,CAAC,CAAC,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;IAC/E,CAAC;IACD,IAAI,CAAC,YAAY,IAAI,UAAU,KAAK,CAAC,IAAI,cAAc,EAAE,CAAC;QACxD,OAAO,EAAE,QAAQ,EAAE,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,WAAW,GAAG,CAAC,CAAC,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC;IAChF,CAAC;IACD,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC;AACzD,CAAC,CAAC;AAEF,MAAM,UAAU,IAAI,CAAC,EAAE,UAAU,GAAG,CAAC,EAAE,cAAc,GAAG,GAAG,KAAkB,EAAE;IAC7E,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,UAAU,CAAC,IAAI,UAAU,GAAG,CAAC,EAAE,CAAC;QACpD,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;IAC3D,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAC,IAAI,cAAc,IAAI,CAAC,IAAI,cAAc,IAAI,CAAC,EAAE,CAAC;QACnF,MAAM,IAAI,KAAK,CAAC,gEAAgE,CAAC,CAAC;IACpF,CAAC;IACD,OAAO,CAAC,EAAE,WAAW,EAAE,UAAU,EAAE,cAAc,EAAE,cAAc,EAAE,YAAY,EAAE,EAAE,EAAE;QACnF,IAAI,UAAU,IAAI,cAAc,EAAE,CAAC;YACjC,OAAO,EAAE,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,WAAW,GAAG,cAAc,CAAC,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;QACrF,CAAC;QACD,IAAI,CAAC,YAAY,IAAI,UAAU,KAAK,CAAC,IAAI,cAAc,EAAE,CAAC;YACxD,OAAO,EAAE,QAAQ,EAAE,WAAW,GAAG,UAAU,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC;QACtE,CAAC;QACD,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC;IACzD,CAAC,CAAC;AACJ,CAAC;AAiCD,MAAM,UAAU,oBAAoB,CAAC,OAAwB;IAC3D,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,GAAG,OAAO,EAAE,WAAW,EAAE,KAAK,GAAG,CAAC,EAAE,iBAAiB,GAAG,GAAG,EAAE,GAAG,OAAO,CAAC;IAE1G,MAAM,mBAAmB,GAAG,OAAO,CAAC,mBAAmB,IAAI,CAAC,CAAC;IAE7D,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;QAC9C,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;IACxD,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,OAAO,GAAG,OAAO,EAAE,CAAC;QACpD,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;IAC3D,CAAC;IACD,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,IAAI,CAAC,EAAE,CAAC;QAClD,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;IACxD,CAAC;IAED,IAAI,WAAW,KAAK,SAAS,IAAI,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,WAAW,CAAC,IAAI,WAAW,GAAG,CAAC,CAAC,EAAE,CAAC;QACrF,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;IAC5D,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,mBAAmB,CAAC,IAAI,mBAAmB,GAAG,CAAC,EAAE,CAAC;QACtE,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;IACpE,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QAC1C,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;IAC1D,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,iBAAiB,CAAC,IAAI,iBAAiB,GAAG,CAAC,EAAE,CAAC;QAClE,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;IACtE,CAAC;IACD,OAAO,eAAe,CAAC,OAAO,EAAE,oBAAoB,CAAC;QACnD,OAAO;QACP,OAAO;QACP,mBAAmB;KACpB,EAAE,OAAO,CAAC,YAAY,IAAI,MAAM,CAAC,CAAC,CAAC;AACtC,CAAC"}

package/dist/rate-controller.d.ts

@@ -0,0 +1,21 @@
+import type { RateStrategy } from "./dynamic-throttled-queue.js";
+type RateControllerOptions = {
+    min_rpi: number;
+    max_rpi: number;
+    errors_per_interval: number;
+};
+type Observation = {
+    hasPendingWork: boolean;
+    wasBackedOff: boolean;
+};
+export type RateDecision = {
+    rate: number;
+    shouldBackOff: boolean;
+};
+export type RateController = {
+    readonly rate: number;
+    recordCompletion: (isRateReducing: boolean) => void;
+    observe: (observation: Observation) => RateDecision;
+};
+export declare function createRateController(options: RateControllerOptions, strategy: RateStrategy): RateController;
+export {};

package/dist/rate-controller.js

@@ -0,0 +1,40 @@
+function validateDecision(decision) {
+    if (typeof decision !== "object" || decision === null) {
+        throw new TypeError("rate strategy must return a decision object");
+    }
+    const candidate = decision;
+    if (!Number.isFinite(candidate.nextRate) || !Number.isInteger(candidate.nextRate)) {
+        throw new TypeError("rate strategy must return a finite integer nextRate");
+    }
+    if (typeof candidate.shouldBackOff !== "boolean") {
+        throw new TypeError("rate strategy must return a boolean shouldBackOff");
+    }
+    return candidate;
+}
+export function createRateController(options, strategy) {
+    let rate = Math.ceil((options.max_rpi + options.min_rpi) / 2);
+    let errorCount = 0;
+    return {
+        get rate() {
+            return rate;
+        },
+        recordCompletion(isRateReducing) {
+            if (isRateReducing)
+                errorCount++;
+        },
+        observe(observation) {
+            const decision = validateDecision(strategy(Object.freeze({
+                currentRate: rate,
+                minRate: options.min_rpi,
+                maxRate: options.max_rpi,
+                errorCount,
+                errorThreshold: options.errors_per_interval,
+                ...observation,
+            })));
+            rate = Math.min(options.max_rpi, Math.max(options.min_rpi, decision.nextRate));
+            errorCount = 0;
+            return { rate, shouldBackOff: decision.shouldBackOff };
+        },
+    };
+}
+//# sourceMappingURL=rate-controller.js.map

package/dist/rate-controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-controller.js","sourceRoot":"","sources":["../src/rate-controller.ts"],"names":[],"mappings":"AAwBA,SAAS,gBAAgB,CAAC,QAAiB;IACzC,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;QACtD,MAAM,IAAI,SAAS,CAAC,6CAA6C,CAAC,CAAC;IACrE,CAAC;IACD,MAAM,SAAS,GAAG,QAAgC,CAAC;IACnD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC;QAClF,MAAM,IAAI,SAAS,CAAC,qDAAqD,CAAC,CAAC;IAC7E,CAAC;IACD,IAAI,OAAO,SAAS,CAAC,aAAa,KAAK,SAAS,EAAE,CAAC;QACjD,MAAM,IAAI,SAAS,CAAC,mDAAmD,CAAC,CAAC;IAC3E,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,OAA8B,EAAE,QAAsB;IACzF,IAAI,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9D,IAAI,UAAU,GAAG,CAAC,CAAC;IAEnB,OAAO;QACL,IAAI,IAAI;YACN,OAAO,IAAI,CAAC;QACd,CAAC;QACD,gBAAgB,CAAC,cAAuB;YACtC,IAAI,cAAc;gBAAE,UAAU,EAAE,CAAC;QACnC,CAAC;QACD,OAAO,CAAC,WAAwB;YAC9B,MAAM,QAAQ,GAAG,gBAAgB,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC;gBACvD,WAAW,EAAE,IAAI;gBACjB,OAAO,EAAE,OAAO,CAAC,OAAO;gBACxB,OAAO,EAAE,OAAO,CAAC,OAAO;gBACxB,UAAU;gBACV,cAAc,EAAE,OAAO,CAAC,mBAAmB;gBAC3C,GAAG,WAAW;aACf,CAAC,CAAC,CAAC,CAAC;YACL,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;YAC/E,UAAU,GAAG,CAAC,CAAC;YACf,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,QAAQ,CAAC,aAAa,EAAE,CAAC;QACzD,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/scheduler.d.ts

@@ -0,0 +1,3 @@
+import type { ThrottleHandle, ThrottleOptions } from "./dynamic-throttled-queue.js";
+import type { RateController } from "./rate-controller.js";
+export declare function createScheduler(options: ThrottleOptions, rateController: RateController): ThrottleHandle;

package/dist/scheduler.js

@@ -0,0 +1,157 @@
+export function createScheduler(options, rateController) {
+    const { interval, evenly_spaced = true, retry = 0, concurrency, compact_threshold = 512, back_off = false, rateOutcomeClassifier, onRateChange, } = options;
+    let current_rpi = rateController.rate;
+    let dyn_interval = evenly_spaced ? interval / current_rpi : interval;
+    let dyn_requests_per_interval = evenly_spaced ? 1 : current_rpi;
+    let skippedLast = false;
+    let isRunning = false;
+    let last_called = 0;
+    let timeout;
+    let dynTimeout;
+    let active_count = 0;
+    let isStopped = false;
+    let hasStrategyFailure = false;
+    let strategyFailure;
+    const max_concurrency = concurrency ?? Infinity;
+    const queue = [];
+    let head = 0;
+    function halt() {
+        isRunning = false;
+        skippedLast = false;
+        clearTimeout(timeout);
+        timeout = undefined;
+        clearTimeout(dynTimeout);
+        dynTimeout = undefined;
+        if (head >= queue.length) {
+            queue.length = 0;
+            head = 0;
+        }
+    }
+    function stop() {
+        isStopped = true;
+        halt();
+    }
+    function isRateReducing(outcome) {
+        if (!outcome)
+            return false;
+        try {
+            return rateOutcomeClassifier?.(outcome) ?? true;
+        }
+        catch {
+            return true;
+        }
+    }
+    function handleResult(item, outcome) {
+        rateController.recordCompletion(isRateReducing(outcome));
+        if (outcome && item.retries > 0) {
+            queue.push({ fn: item.fn, retries: item.retries - 1 });
+            if (!isRunning && !isStopped && queue.length > head)
+                start();
+        }
+    }
+    function handleSettlement(item, outcome, resume = false) {
+        active_count--;
+        handleResult(item, outcome);
+        if (resume && isRunning && !skippedLast && queue.length > head)
+            dequeue();
+    }
+    function execute(item) {
+        active_count++;
+        let result;
+        try {
+            result = item.fn();
+        }
+        catch (error) {
+            handleSettlement(item, { kind: "thrown", error });
+            return;
+        }
+        if (result instanceof Promise) {
+            void result.then(value => handleSettlement(item, value === false ? { kind: "returned-false" } : undefined, true), (error) => handleSettlement(item, { kind: "rejected", error }, true));
+            return;
+        }
+        handleSettlement(item, result === false ? { kind: "returned-false" } : undefined);
+    }
+    function dequeue() {
+        const threshold = last_called + dyn_interval;
+        const now = Date.now();
+        if (now < threshold) {
+            clearTimeout(timeout);
+            timeout = setTimeout(dequeue, threshold - now);
+            return;
+        }
+        const end = Math.min(head + dyn_requests_per_interval, queue.length);
+        let started = 0;
+        while (head < end && active_count < max_concurrency) {
+            const item = queue[head++];
+            if (started++ === 0)
+                last_called = Date.now();
+            execute(item);
+        }
+        if (head > compact_threshold && head > queue.length / 2) {
+            queue.splice(0, head);
+            head = 0;
+        }
+        if (head >= queue.length) {
+            halt();
+            return;
+        }
+        if (active_count >= max_concurrency)
+            return;
+        timeout = setTimeout(dequeue, dyn_interval);
+    }
+    function applyRate(newRpi) {
+        if (newRpi === current_rpi)
+            return;
+        current_rpi = newRpi;
+        onRateChange?.(current_rpi);
+        if (evenly_spaced)
+            dyn_interval = interval / current_rpi;
+        else
+            dyn_requests_per_interval = current_rpi;
+    }
+    function adjustRate() {
+        dynTimeout = undefined;
+        const wasSkipped = skippedLast;
+        skippedLast = false;
+        let decision;
+        try {
+            decision = rateController.observe({ hasPendingWork: queue.length > head, wasBackedOff: wasSkipped });
+        }
+        catch (error) {
+            hasStrategyFailure = true;
+            strategyFailure = error;
+            halt();
+            throw error;
+        }
+        applyRate(decision.rate);
+        if (decision.shouldBackOff && back_off) {
+            clearTimeout(timeout);
+            skippedLast = true;
+            timeout = setTimeout(dequeue, dyn_interval + interval);
+        }
+        if (isRunning)
+            dynTimeout = setTimeout(adjustRate, interval);
+    }
+    function start() {
+        if (skippedLast)
+            return;
+        isRunning = true;
+        last_called = Date.now();
+        clearTimeout(timeout);
+        timeout = setTimeout(dequeue, dyn_interval);
+        if (!dynTimeout)
+            dynTimeout = setTimeout(adjustRate, interval);
+    }
+    function enqueue(callback) {
+        if (hasStrategyFailure)
+            throw strategyFailure;
+        queue.push({ fn: callback, retries: retry });
+        isStopped = false;
+        if (!isRunning)
+            start();
+    }
+    enqueue.stop = stop;
+    Object.defineProperty(enqueue, "pending", { get: () => queue.length - head });
+    return enqueue;
+}
+//# sourceMappingURL=scheduler.js.map

package/dist/scheduler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduler.js","sourceRoot":"","sources":["../src/scheduler.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dynamic-throttled-queue",
-  "version": "2.1.1-rc.bcc09d3",
+  "version": "2.2.0-rc.7fbd417",
   "type": "module",
   "description": "Dynamically throttles arbitrary code to execute between a minimum and maximum number of times per interval. Best for making throttled API requests.",
   "files": [