@gershy/util-throttler 0.0.1

package/cmp/cjs/main.d.ts

@@ -0,0 +1,10 @@
+import '../sideEffects.js';
+import '@gershy/clearing';
+export default class Throttler {
+    private limit;
+    private active;
+    private pending;
+    constructor(limit: number);
+    private finish;
+    do<T>(fn: () => Promise<T>): Promise<T>;
+}

package/cmp/cjs/main.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+require("@gershy/clearing");
+// TODO: @gershy/throttler
+class Throttler {
+    limit;
+    active;
+    pending;
+    constructor(limit) {
+        if (limit < 1)
+            throw Error('limit too low')[mod]({ limit });
+        if (Math.floor(limit) !== limit)
+            throw Error('limit invalid')[mod]({ limit });
+        this.limit = limit;
+        this.active = new Set();
+        this.pending = [];
+    }
+    finish(donePrm) {
+        this.active[rem](donePrm);
+        const next = this.pending.shift();
+        if (!next)
+            return;
+        // Safely run `fn` - wire resolve+reject to the `Promise.later` value
+        const { prm, fn } = next;
+        this.do(fn).then(val => prm.resolve(val), err => prm.reject(err));
+    }
+    do(fn) {
+        if (this.active.size < this.limit) {
+            const prm = fn(); // Synchronous throws will propagate!
+            this.active.add(prm);
+            return prm.finally(() => this.finish(prm));
+        }
+        const prm = Promise[later]();
+        this.pending.push({ prm, fn });
+        return prm;
+    }
+}
+exports.default = Throttler;

package/cmp/cjs/package.json

@@ -0,0 +1 @@
+{"type":"commonjs"}

package/cmp/mjs/main.d.ts

@@ -0,0 +1,10 @@
+import '../sideEffects.js';
+import '@gershy/clearing';
+export default class Throttler {
+    private limit;
+    private active;
+    private pending;
+    constructor(limit: number);
+    private finish;
+    do<T>(fn: () => Promise<T>): Promise<T>;
+}

package/cmp/mjs/main.js

@@ -0,0 +1,35 @@
+import '@gershy/clearing';
+// TODO: @gershy/throttler
+export default class Throttler {
+    limit;
+    active;
+    pending;
+    constructor(limit) {
+        if (limit < 1)
+            throw Error('limit too low')[mod]({ limit });
+        if (Math.floor(limit) !== limit)
+            throw Error('limit invalid')[mod]({ limit });
+        this.limit = limit;
+        this.active = new Set();
+        this.pending = [];
+    }
+    finish(donePrm) {
+        this.active[rem](donePrm);
+        const next = this.pending.shift();
+        if (!next)
+            return;
+        // Safely run `fn` - wire resolve+reject to the `Promise.later` value
+        const { prm, fn } = next;
+        this.do(fn).then(val => prm.resolve(val), err => prm.reject(err));
+    }
+    do(fn) {
+        if (this.active.size < this.limit) {
+            const prm = fn(); // Synchronous throws will propagate!
+            this.active.add(prm);
+            return prm.finally(() => this.finish(prm));
+        }
+        const prm = Promise[later]();
+        this.pending.push({ prm, fn });
+        return prm;
+    }
+}

package/cmp/mjs/package.json

@@ -0,0 +1 @@
+{"type":"module"}

package/cmp/sideEffects.d.ts

@@ -0,0 +1,2 @@
+declare global {}
+export {};

package/license

@@ -0,0 +1,15 @@
+ISC License
+
+Copyright (c) 2026 Gershom Maes
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
+AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
+OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+PERFORMANCE OF THIS SOFTWARE.

package/package.json

@@ -0,0 +1 @@
+{"name":"@gershy/util-throttler","version":"0.0.1","description":"TODO","keywords":["TODO"],"author":"Gershom Maes","repository":{"type":"git","url":"git+https://github.com/gershy/utilThrottler.git"},"bugs":{"url":"https://github.com/gershy/utilThrottler/issues"},"homepage":"https://github.com/gershy/utilThrottler#readme","license":"ISC","peerDependencies":{"@gershy/clearing":"^0.0.17"},"devDependencies":{"@types/node":"^24.10.1","tsx":"^4.21.0","typescript":"^5.9.3"},"type":"module","files":["cmp"],"sideEffects":false,"types":"./cmp/mjs/main.d.ts","exports":{".":{"import":"./cmp/mjs/main.js","require":"./cmp/cjs/main.js"}},"scripts":{"test":"npm run ts.check && npx tsx ./src/main.test.ts","ts.check":"npx tsc --noEmit","build.cjs":"tsc -p build/tsconfig.cjs.json","build.mjs":"tsc -p build/tsconfig.mjs.json","build":"node ./build/act.js removeCmp && npm run build.cjs && npm run build.mjs && node ./build/act.js finalizeExportVariants","git.pub":"npm run test && git add --all && git commit -m \"automated\" && git push","npm.login":"npm login","npm.pub":"npm run test && npm run build && npm publish --access public"}}

package/readme.md

@@ -0,0 +1,3 @@
+# TODO
+
+Looks like someone needs to write this readme...