@koralabs/kora-labs-common 6.18.1 → 6.18.3

package/chain/transport/rateLimit.d.ts

@@ -15,7 +15,11 @@ export declare const statedWaitMs: (headers: HeaderReader | undefined, body: unk
 /** Record that `key` must not be called for `waitMs` (only ever extends an existing block). */
 export declare const recordRateLimit: (key: string, waitMs: number, now?: number) => void;
 export declare const rateLimitWaitRemainingMs: (key: string, now?: number) => number;
-/** Wait out a recorded limit before calling `key`; throw (returning the wait) when it exceeds `maxWaitMs`. */
+/**
+ * Wait out a recorded limit before calling `key`; throw (returning the wait) when it exceeds `maxWaitMs`.
+ * A timer runs on the monotonic clock while the block is wall-clock ms (Date.now()), so it can fire a
+ * millisecond or more before Date.now() reaches the stated time: re-check and keep waiting until it has.
+ */
 export declare const waitForRateLimit: (key: string, maxWaitMs: number) => Promise<void>;
 /** Test seam: forget every recorded limit. */
 export declare const resetRateLimits: () => void;

package/chain/transport/rateLimit.js

@@ -86,14 +86,17 @@ exports.recordRateLimit = recordRateLimit;
 const rateLimitWaitRemainingMs = (key, now = Date.now()) => { var _a; return Math.max(0, ((_a = blockedUntilByKey.get(key)) !== null && _a !== void 0 ? _a : 0) - now); };
 exports.rateLimitWaitRemainingMs = rateLimitWaitRemainingMs;
 const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
-/** Wait out a recorded limit before calling `key`; throw (returning the wait) when it exceeds `maxWaitMs`. */
+/**
+ * Wait out a recorded limit before calling `key`; throw (returning the wait) when it exceeds `maxWaitMs`.
+ * A timer runs on the monotonic clock while the block is wall-clock ms (Date.now()), so it can fire a
+ * millisecond or more before Date.now() reaches the stated time: re-check and keep waiting until it has.
+ */
 const waitForRateLimit = async (key, maxWaitMs) => {
-    const remaining = (0, exports.rateLimitWaitRemainingMs)(key);
-    if (remaining === 0)
-        return;
-    if (remaining > maxWaitMs)
-        throw new RateLimitedError(key, remaining);
-    await sleep(remaining);
+    for (let remaining = (0, exports.rateLimitWaitRemainingMs)(key); remaining > 0; remaining = (0, exports.rateLimitWaitRemainingMs)(key)) {
+        if (remaining > maxWaitMs)
+            throw new RateLimitedError(key, remaining);
+        await sleep(remaining);
+    }
 };
 exports.waitForRateLimit = waitForRateLimit;
 /** Test seam: forget every recorded limit. */

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@koralabs/kora-labs-common",
-    "version": "6.18.1",
+    "version": "6.18.3",
     "description": "Kora Labs Common Utilities",
     "main": "index.js",
     "types": "index.d.ts",
@@ -69,7 +69,7 @@
         "pluralize-esm": "^9.0.5"
     },
     "overrides": {
-        "js-yaml": "4.3.1",
+        "js-yaml": "4.3.2",
         "brace-expansion": "5.0.9"
     },
     "peerDependencies": {