mini-semaphore 1.5.2 → 1.5.4

package/README.md

@@ -226,6 +226,32 @@ Promise.allSettled(tasks).then(() => {
 
 This feature enhances the flexibility of `mini-semaphore`, making it suitable for more complex concurrency control scenarios.
 
+---
+
+> ## Type Information for Subpath Imports
+
+`mini-semaphore` provides full `.d.ts` typings for the root entry:
+
+```ts
+import { create, MiniSemaphore, restrictor } from "mini-semaphore";
+```
+
+Subpath entries (for example `mini-semaphore/class`, `mini-semaphore/object`, `mini-semaphore/deque`, and `mini-semaphore/flow-restrictor`) are  
+primarily intended for advanced usage and are documented with JSDoc type annotations in the distributed ESM files.
+
+```js
+import { create } from "mini-semaphore/object";
+import { MiniSemaphore } from "mini-semaphore/class";
+```
+
+> ### Notes
+
+- Subpath imports are runtime-supported and JSDoc-typed.
+- Dedicated `.d.ts` files for subpath exports may not be provided.
+- If your TypeScript setup does not infer types from JSDoc in `node_modules`, prefer importing from the root package (`"mini-semaphore"`).
+
+---
+
 > ## Authors
 
  + **jeffy-g** - [jeffy-g](https://github.com/jeffy-g)

package/cjs/class.js

@@ -54,7 +54,7 @@ class MiniSemaphore {
     constructor(capacity) {
         /** @type {number} */
         this.limit = this.capacity = capacity;
-        /** @type {Deque<() => void>} */
+        /** @type {import("./index").Deque<() => void>} */
         this.q = new deque_1.Deque(capacity);
     }
     /**

package/cjs/core.js

@@ -3,14 +3,12 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.releaseWithAbort = exports.acquireWithAbort = exports.release = exports.acquire = void 0;
 /**
  * @import {
+ *   Deque,
  *   TResolver,
  *   TVoidFunction,
- *   TFlowableLockWithAbort,
- *   ISimplifiedLock,
  *   TFlowableLock,
- *   IFlowableLock,
- *   Deque,
- * } from "./index.mjs";
+ *   TFlowableLockWithAbort,
+ * } from "./index";
  * @typedef {Deque<TResolver>} DequeWithAbort
  */
 /**
@@ -63,7 +61,7 @@ const release = (dis) => {
         dis.capacity++;
     }
     if (dis.capacity > dis.limit) {
-        console.warn("inconsistent release!");
+        console.warn(new Error("[mini-semaphore] inconsistent release!"));
         dis.capacity = dis.limit;
     }
 };

package/cjs/deque.d.ts

@@ -11,7 +11,6 @@
  */
 export declare class Deque<T extends any> {
     _c: number;
-    _l: number;
     _f: number;
     _a: T[];
     length: number;

package/cjs/deque.js

@@ -60,11 +60,6 @@ class Deque {
          * @internal
          */
         this._c = gc(ic || 16);
-        /**
-         * current length (size
-         * @internal
-         */
-        this._l = 0;
         /**
          * current front position
          * @internal
@@ -84,16 +79,16 @@ class Deque {
      * @param {T} s subject
      */
     push(s) {
-        const l = this._l;
+        const l = this.length;
         if (this._c < l + 1) {
             rt(this, gc(this._c * 1.5 + 16));
         }
         const i = (this._f + l) & (this._c - 1);
         this._a[i] = s;
-        this.length = this._l = l + 1;
+        this.length = l + 1;
     }
     shift() {
-        const l = this._l;
+        const l = this.length;
         /* istanbul ignore if */
         if (l === 0) {
             return void 0;
@@ -102,7 +97,7 @@ class Deque {
         const r = this._a[f];
         this._a[f] = /** @type {T} */ (void 0);
         this._f = (f + 1) & (this._c - 1);
-        this.length = this._l = l - 1;
+        this.length = l - 1;
         return r;
     }
 }
@@ -118,7 +113,7 @@ exports.Deque = Deque;
 const rt = (dis, n) => {
     const oc = dis._c;
     dis._c = n;
-    const lastIndex = dis._f + dis._l;
+    const lastIndex = dis._f + dis.length;
     /* istanbul ignore next */
     if (lastIndex > oc) {
         const mc = (lastIndex) & (oc - 1);

package/cjs/index.d.ts

@@ -10,11 +10,6 @@ export declare class Deque<T extends any> {
      * @internal
      */
     _c: number;
-    /**
-     * current length (size
-     * @internal
-     */
-    _l: number;
     /**
      * current front position
      * @internal

package/cjs/index.js

@@ -10,4 +10,4 @@ var deque_1 = require("./deque");
 Object.defineProperty(exports, "Deque", { enumerable: true, get: function () { return deque_1.Deque; } });
 var flow_restrictor_1 = require("./flow-restrictor");
 Object.defineProperty(exports, "restrictor", { enumerable: true, get: function () { return flow_restrictor_1.restrictor; } });
-exports.version = "v1.5.2";
+exports.version = "v1.5.4";

package/cjs/object.js

@@ -27,10 +27,10 @@ const ra = core.releaseWithAbort;
  *   TAbortListener,
  *   IProcessAbortedError,
  *   TFlowableLockWithAbort,
- * } from "./index.mjs";
+ * } from "./index";
  */
 /**
- * @template {IFlowableLock & { q: Deque<unknown>}} T
+ * @template {IFlowableLock & { q: import("./index").Deque<unknown>}} T
  * @param {number} capacity
  * @returns
  */
@@ -148,6 +148,7 @@ const createWithAbort = (capacity) => {
             };
             abortListeners.forEach(listener => listener(reason));
             const dq = this.q;
+            /** @type {TResolver=} */
             let resolver;
             while (resolver = dq.shift()) {
                 resolver.reject(reason);

package/esm/class.mjs

@@ -51,7 +51,7 @@ export class MiniSemaphore {
     constructor(capacity) {
         /** @type {number} */
         this.limit = this.capacity = capacity;
-        /** @type {Deque<() => void>} */
+        /** @type {import("./index.mjs").Deque<() => void>} */
         this.q = new Deque(capacity);
     }
     /**

package/esm/core.mjs

@@ -1,12 +1,10 @@
 /**
  * @import {
+ *   Deque,
  *   TResolver,
  *   TVoidFunction,
- *   TFlowableLockWithAbort,
- *   ISimplifiedLock,
  *   TFlowableLock,
- *   IFlowableLock,
- *   Deque,
+ *   TFlowableLockWithAbort,
  * } from "./index.mjs";
  * @typedef {Deque<TResolver>} DequeWithAbort
  */
@@ -59,7 +57,7 @@ export const release = (dis) => {
         dis.capacity++;
     }
     if (dis.capacity > dis.limit) {
-        console.warn("inconsistent release!");
+        console.warn(new Error("[mini-semaphore] inconsistent release!"));
         dis.capacity = dis.limit;
     }
 };

package/esm/deque.mjs

@@ -57,11 +57,6 @@ export class Deque {
          * @internal
          */
         this._c = gc(ic || 16);
-        /**
-         * current length (size
-         * @internal
-         */
-        this._l = 0;
         /**
          * current front position
          * @internal
@@ -81,16 +76,16 @@ export class Deque {
      * @param {T} s subject
      */
     push(s) {
-        const l = this._l;
+        const l = this.length;
         if (this._c < l + 1) {
             rt(this, gc(this._c * 1.5 + 16));
         }
         const i = (this._f + l) & (this._c - 1);
         this._a[i] = s;
-        this.length = this._l = l + 1;
+        this.length = l + 1;
     }
     shift() {
-        const l = this._l;
+        const l = this.length;
         /* istanbul ignore if */
         if (l === 0) {
             return void 0;
@@ -99,7 +94,7 @@ export class Deque {
         const r = this._a[f];
         this._a[f] = /** @type {T} */ (void 0);
         this._f = (f + 1) & (this._c - 1);
-        this.length = this._l = l - 1;
+        this.length = l - 1;
         return r;
     }
 }
@@ -114,7 +109,7 @@ export class Deque {
 const rt = (dis, n) => {
     const oc = dis._c;
     dis._c = n;
-    const lastIndex = dis._f + dis._l;
+    const lastIndex = dis._f + dis.length;
     /* istanbul ignore next */
     if (lastIndex > oc) {
         const mc = (lastIndex) & (oc - 1);

package/esm/index.d.mts

@@ -10,11 +10,6 @@ export declare class Deque<T extends any> {
      * @internal
      */
     _c: number;
-    /**
-     * current length (size
-     * @internal
-     */
-    _l: number;
     /**
      * current front position
      * @internal

package/esm/index.mjs

@@ -2,4 +2,4 @@ export { MiniSemaphore } from "./class.mjs";
 export { create, createWithAbort } from "./object.mjs";
 export { Deque } from "./deque.mjs";
 export { restrictor } from "./flow-restrictor.mjs";
-export const version = "v1.5.2";
+export const version = "v1.5.4";

package/esm/object.mjs

@@ -27,7 +27,7 @@ const ra = core.releaseWithAbort;
  * } from "./index.mjs";
  */
 /**
- * @template {IFlowableLock & { q: Deque<unknown>}} T
+ * @template {IFlowableLock & { q: import("./index.mjs").Deque<unknown>}} T
  * @param {number} capacity
  * @returns
  */
@@ -144,6 +144,7 @@ export const createWithAbort = (capacity) => {
             };
             abortListeners.forEach(listener => listener(reason));
             const dq = this.q;
+            /** @type {TResolver=} */
             let resolver;
             while (resolver = dq.shift()) {
                 resolver.reject(reason);

package/index.d.ts

@@ -10,11 +10,6 @@ export declare class Deque<T extends any> {
      * @internal
      */
     _c: number;
-    /**
-     * current length (size
-     * @internal
-     */
-    _l: number;
     /**
      * current front position
      * @internal

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mini-semaphore",
-  "version": "1.5.2",
+  "version": "1.5.4",
   "description": "A lightweight version of Semaphore",
   "private": false,
   "main": "./cjs/index.js",
@@ -33,16 +33,16 @@
     "./umd": {
       "import": "./umd/index.js",
       "require": "./umd/index.js",
-      "types": "./umd/index.d.ts"
+      "types": "./index.d.ts"
     },
     "./webpack": {
       "import": "./webpack/index.js",
       "require": "./webpack/index.js",
-      "types": "./webpack/index.d.ts"
+      "types": "./index.d.ts"
     },
     "./webpack-esm": {
       "import": "./webpack-esm/index.mjs",
-      "types": "./webpack-esm/index.d.mts"
+      "types": "./index.d.ts"
     }
   },
   "author": "jeffy-g",

package/umd/index.js

@@ -1,8 +1,2 @@
 /*! For license information please see index.js.LICENSE.txt */
-((e,t)=>{'object'==typeof exports&&'object'==typeof module?module.exports=t():'function'==typeof define&&define.amd?define([],t):'object'==typeof exports?exports.MiniSema=t():e.MiniSema=t()})(globalThis,()=>(()=>{"use strict";var e={684(e,t,i){Object.defineProperty(t,"__esModule",{value:!0}),t.MiniSemaphore=void 0;const r=i(721),n=i(884),s=r.acquire,a=r.release;t.MiniSemaphore=class{constructor(e){this.limit=this.capacity=e,this.q=new n.Deque(e)}acquire(e){return s(this,e)}release(){a(this)}setRestriction(e){this.limit=this.capacity=e}get pending(){return this.q.length}async flow(e,t){await s(this,t);try{return await e()}finally{a(this)}}}},721(e,t){Object.defineProperty(t,"__esModule",{value:!0}),t.releaseWithAbort=t.acquireWithAbort=t.release=t.acquire=void 0;const i=()=>{
-throw new Error("mini-semaphore: Detected an inconsistent state, possibly due to a logic error or unexpected behavior.")},r=(e,t)=>{e.capacity>0?(e.capacity--,t()):e.q.push(t)};t.acquire=(e,t=!0)=>new Promise(i=>{t?setTimeout(()=>r(e,i),4):r(e,i)});t.release=e=>{let t;(t=e.q).length?(t.shift()||i)():e.capacity++,e.capacity>e.limit&&(console.warn("inconsistent release!"),e.capacity=e.limit)};t.acquireWithAbort=e=>new Promise((t,i)=>{e.capacity>0?(e.capacity--,t()):e.q.push({resolve:t,reject:i})});t.releaseWithAbort=e=>{let t;if((t=e.q).length){const e=t.shift();e&&e.resolve()||i()}else e.capacity<e.limit&&e.capacity++}},884(e,t){Object.defineProperty(t,"__esModule",{value:!0}),t.Deque=void 0;const i=e=>(e=>(e>>>=0,e--,e|=e>>1,e|=e>>2,e|=e>>4,e|=e>>8,
-1+(e|=e>>16)))(Math.min(Math.max(16,0|e),1073741824));t.Deque=class{constructor(e){this._c=i(e||16),this._l=0,this._f=0,this._a=[],this.length=0}push(e){const t=this._l;this._c<t+1&&r(this,i(1.5*this._c+16));const n=this._f+t&this._c-1;this._a[n]=e,this.length=this._l=t+1}shift(){const e=this._l;if(0===e)return;const t=this._f,i=this._a[t];return this._a[t]=void 0,this._f=t+1&this._c-1,this.length=this._l=e-1,i}};const r=(e,t)=>{const i=e._c;e._c=t;const r=e._f+e._l;if(r>i){const t=r&i-1;((e,t,i,r,n)=>{for(let s=0;s<n;++s)i[s+r]=e[s+t],e[s+t]=void 0})(e._a,0,e._a,i,t)}}},650(e,t,i){Object.defineProperty(t,"__esModule",{value:!0}),t.restrictor=void 0;const r=i(684);t.restrictor=(()=>{const{MiniSemaphore:e}=r,t=new e(1);let i=Object.create(null);async function n(r,n,s){
-const a=await(async(r,n)=>{await t.acquire(!1);let s=i[r];if(s||(i[r]=s=new e(n)),s.limit!==n)throw t.release(),new ReferenceError(`Cannot get object with different restriction: key: '${String(r)}', lock.limit: ${s.limit} <-> restriction: ${n},`);return t.release(),s})(r,n),o=a.flow(s);return a.last=Date.now(),o}return{getLockByKey:async e=>{await t.acquire(!1);const r=i[e];return t.release(),r},cleanup:async(e,r)=>{await t.acquire(!1);const n=i,s=Object.create(null),a=Object.keys(n);let o,c=0;!e&&(e=1),e*=1e3,r&&(o=[]);for(let t=0,i=a.length;t<i;){const i=a[t++],l=n[i];l.last&&Date.now()-l.last>=e?(c++,r&&o.push(i)):s[i]=l}return i=s,t.release(),r&&console.log(`eliminated: [\n${o.join(",\n")}\n]\nlived: [\n${Object.keys(s).join(",\n")}\n]`),c},multi:n,one:async function(e,t){
-return n(e,1,t)}}})()},121(e,t,i){Object.defineProperty(t,"__esModule",{value:!0}),t.createWithAbort=t.create=void 0;const r=i(721),n=i(884),s=r.acquire,a=r.release,o=r.acquireWithAbort,c=r.releaseWithAbort,l=e=>({capacity:e,limit:e,q:new n.Deque(e),setRestriction(e){this.limit=this.capacity=e}});t.create=e=>({...l(e),get pending(){return this.q.length},acquire(e){return s(this,e)},release(){a(this)},async flow(e,t){await s(this,t);try{return await e()}finally{a(this)}}});t.createWithAbort=e=>{const t=l(e),i=[];return{...t,get pending(){return this.q.length},acquire(){return o(this)},release(){c(this)},async flow(e){let t;try{await o(this),t=await e(),c(this)}finally{return t}},abort(){const e={message:"Process Aborted"};i.forEach(t=>t(e));const t=this.q;let r;for(;r=t.shift();)r.reject(e)
-;this.capacity=this.limit},onAbort(e){i.includes(e)||i.push(e)},offAbort(e){const t=i.findIndex(t=>e===t);-1!==t&&i.splice(t,1)}}}}},t={};function i(r){var n=t[r];if(void 0!==n)return n.exports;var s=t[r]={exports:{}};return e[r](s,s.exports,i),s.exports}var r={};return(()=>{var e=r;Object.defineProperty(e,"__esModule",{value:!0}),e.version=e.restrictor=e.Deque=e.createWithAbort=e.create=e.MiniSemaphore=void 0;var t=i(684);Object.defineProperty(e,"MiniSemaphore",{enumerable:!0,get:function(){return t.MiniSemaphore}});var n=i(121);Object.defineProperty(e,"create",{enumerable:!0,get:function(){return n.create}}),Object.defineProperty(e,"createWithAbort",{enumerable:!0,get:function(){return n.createWithAbort}});var s=i(884);Object.defineProperty(e,"Deque",{enumerable:!0,get:function(){
-return s.Deque}});var a=i(650);Object.defineProperty(e,"restrictor",{enumerable:!0,get:function(){return a.restrictor}}),e.version="v1.5.2"})(),r})());
+((e,t)=>{"object"==typeof exports&&"object"==typeof module?module.exports=t():"function"==typeof define&&define.amd?define([],t):"object"==typeof exports?exports.MiniSema=t():e.MiniSema=t()})(globalThis,()=>(()=>{"use strict";var e=[,,(e,t,i)=>{Object.defineProperty(t,"__esModule",{value:!0}),t.MiniSemaphore=void 0;const r=i(6),n=i(4),s=r.acquire,a=r.release;t.MiniSemaphore=class{constructor(e){this.limit=this.capacity=e,this.q=new n.Deque(e)}acquire(e){return s(this,e)}release(){a(this)}setRestriction(e){this.limit=this.capacity=e}get pending(){return this.q.length}async flow(e,t){await s(this,t);try{return await e()}finally{a(this)}}}},(e,t,i)=>{Object.defineProperty(t,"__esModule",{value:!0}),t.createWithAbort=t.create=void 0;const r=i(6),n=i(4),s=r.acquire,a=r.release,o=r.acquireWithAbort,c=r.releaseWithAbort,l=e=>({capacity:e,limit:e,q:new n.Deque(e),setRestriction(e){this.limit=this.capacity=e}});t.create=e=>({...l(e),get pending(){return this.q.length},acquire(e){return s(this,e)},release(){a(this)},async flow(e,t){await s(this,t);try{return await e()}finally{a(this)}}}),t.createWithAbort=e=>{const t=l(e),i=[];return{...t,get pending(){return this.q.length},acquire(){return o(this)},release(){c(this)},async flow(e){let t;try{await o(this),t=await e(),c(this)}finally{return t}},abort(){const e={message:"Process Aborted"};i.forEach(t=>t(e));const t=this.q;let r;for(;r=t.shift();)r.reject(e);this.capacity=this.limit},onAbort(e){i.includes(e)||i.push(e)},offAbort(e){const t=i.findIndex(t=>e===t);-1!==t&&i.splice(t,1)}}}},(e,t)=>{Object.defineProperty(t,"__esModule",{value:!0}),t.Deque=void 0;const i=e=>(e=>(e>>>=0,e--,e|=e>>1,e|=e>>2,e|=e>>4,1+((e|=e>>8)|e>>16)))(Math.min(Math.max(16,0|e),1073741824));t.Deque=class{constructor(e){this._c=i(e||16),this._f=0,this._a=[],this.length=0}push(e){const t=this.length;this._c<t+1&&r(this,i(1.5*this._c+16));const n=this._f+t&this._c-1;this._a[n]=e,this.length=t+1}shift(){const e=this.length;if(0===e)return;const t=this._f,i=this._a[t];return this._a[t]=void 0,this._f=t+1&this._c-1,this.length=e-1,i}};const r=(e,t)=>{const i=e._c;e._c=t;const r=e._f+e.length;if(r>i){const t=r&i-1;((e,t,i,r,n)=>{for(let t=0;t<n;++t)i[t+r]=e[t+0],e[t+0]=void 0})(e._a,0,e._a,i,t)}}},(e,t,i)=>{Object.defineProperty(t,"__esModule",{value:!0}),t.restrictor=void 0;const r=i(2);t.restrictor=(()=>{const{MiniSemaphore:e}=r,t=new e(1);let i=Object.create(null);async function n(r,n,s){const a=await(async(r,n)=>{await t.acquire(!1);let s=i[r];if(s||(i[r]=s=new e(n)),s.limit!==n)throw t.release(),new ReferenceError(`Cannot get object with different restriction: key: '${String(r)}', lock.limit: ${s.limit} <-> restriction: ${n},`);return t.release(),s})(r,n),o=a.flow(s);return a.last=Date.now(),o}return{getLockByKey:async e=>{await t.acquire(!1);const r=i[e];return t.release(),r},cleanup:async(e,r)=>{await t.acquire(!1);const n=i,s=Object.create(null),a=Object.keys(n);let o,c=0;!e&&(e=1),e*=1e3,r&&(o=[]);for(let t=0,i=a.length;t<i;){const i=a[t++],l=n[i];l.last&&Date.now()-l.last>=e?(c++,r&&o.push(i)):s[i]=l}return i=s,t.release(),r&&console.log(`eliminated: [\n${o.join(",\n")}\n]\nlived: [\n${Object.keys(s).join(",\n")}\n]`),c},multi:n,one:async function(e,t){return n(e,1,t)}}})()},(e,t)=>{Object.defineProperty(t,"__esModule",{value:!0}),t.releaseWithAbort=t.acquireWithAbort=t.release=t.acquire=void 0;const i=()=>{throw new Error("mini-semaphore: Detected an inconsistent state, possibly due to a logic error or unexpected behavior.")},r=(e,t)=>{e.capacity>0?(e.capacity--,t()):e.q.push(t)};t.acquire=(e,t=!0)=>new Promise(i=>{t?setTimeout(()=>r(e,i),4):r(e,i)}),t.release=e=>{let t;(t=e.q).length?(t.shift()||i)():e.capacity++,e.capacity>e.limit&&(console.warn(new Error("[mini-semaphore] inconsistent release!")),e.capacity=e.limit)},t.acquireWithAbort=e=>new Promise((t,i)=>{e.capacity>0?(e.capacity--,t()):e.q.push({resolve:t,reject:i})}),t.releaseWithAbort=e=>{let t;if((t=e.q).length){const e=t.shift();e&&e.resolve()||i()}else e.capacity<e.limit&&e.capacity++}}],t={};function i(r){var n=t[r];if(void 0!==n)return n.exports;var s=t[r]={exports:{}};return e[r](s,s.exports,i),s.exports}var r={};return(()=>{var e=r;Object.defineProperty(e,"__esModule",{value:!0}),e.version=e.restrictor=e.Deque=e.createWithAbort=e.create=e.MiniSemaphore=void 0;var t=i(2);Object.defineProperty(e,"MiniSemaphore",{enumerable:!0,get:function(){return t.MiniSemaphore}});var n=i(3);Object.defineProperty(e,"create",{enumerable:!0,get:function(){return n.create}}),Object.defineProperty(e,"createWithAbort",{enumerable:!0,get:function(){return n.createWithAbort}});var s=i(4);Object.defineProperty(e,"Deque",{enumerable:!0,get:function(){return s.Deque}});var a=i(5);Object.defineProperty(e,"restrictor",{enumerable:!0,get:function(){return a.restrictor}}),e.version="v1.5.4"})(),r})());

package/webpack/index.js

@@ -1,7 +1,2 @@
 /*! For license information please see index.js.LICENSE.txt */
-(()=>{"use strict";var e={684(e,t,i){Object.defineProperty(t,"__esModule",{value:!0}),t.MiniSemaphore=void 0;const r=i(721),n=i(884),s=r.acquire,a=r.release;t.MiniSemaphore=class{constructor(e){this.limit=this.capacity=e,this.q=new n.Deque(e)}acquire(e){return s(this,e)}release(){a(this)}setRestriction(e){this.limit=this.capacity=e}get pending(){return this.q.length}async flow(e,t){await s(this,t);try{return await e()}finally{a(this)}}}},721(e,t){Object.defineProperty(t,"__esModule",{value:!0}),t.releaseWithAbort=t.acquireWithAbort=t.release=t.acquire=void 0;const i=()=>{throw new Error("mini-semaphore: Detected an inconsistent state, possibly due to a logic error or unexpected behavior.")},r=(e,t)=>{e.capacity>0?(e.capacity--,t()):e.q.push(t)};t.acquire=(e,t=!0)=>new Promise(i=>{
-t?setTimeout(()=>r(e,i),4):r(e,i)});t.release=e=>{let t;(t=e.q).length?(t.shift()||i)():e.capacity++,e.capacity>e.limit&&(console.warn("inconsistent release!"),e.capacity=e.limit)};t.acquireWithAbort=e=>new Promise((t,i)=>{e.capacity>0?(e.capacity--,t()):e.q.push({resolve:t,reject:i})});t.releaseWithAbort=e=>{let t;if((t=e.q).length){const e=t.shift();e&&e.resolve()||i()}else e.capacity<e.limit&&e.capacity++}},884(e,t){Object.defineProperty(t,"__esModule",{value:!0}),t.Deque=void 0;const i=e=>(e=>(e>>>=0,e--,e|=e>>1,e|=e>>2,e|=e>>4,e|=e>>8,1+(e|=e>>16)))(Math.min(Math.max(16,0|e),1073741824));t.Deque=class{constructor(e){this._c=i(e||16),this._l=0,this._f=0,this._a=[],this.length=0}push(e){const t=this._l;this._c<t+1&&r(this,i(1.5*this._c+16));const n=this._f+t&this._c-1;this._a[n]=e,
-this.length=this._l=t+1}shift(){const e=this._l;if(0===e)return;const t=this._f,i=this._a[t];return this._a[t]=void 0,this._f=t+1&this._c-1,this.length=this._l=e-1,i}};const r=(e,t)=>{const i=e._c;e._c=t;const r=e._f+e._l;if(r>i){const t=r&i-1;((e,t,i,r,n)=>{for(let s=0;s<n;++s)i[s+r]=e[s+t],e[s+t]=void 0})(e._a,0,e._a,i,t)}}},650(e,t,i){Object.defineProperty(t,"__esModule",{value:!0}),t.restrictor=void 0;const r=i(684);t.restrictor=(()=>{const{MiniSemaphore:e}=r,t=new e(1);let i=Object.create(null);async function n(r,n,s){const a=await(async(r,n)=>{await t.acquire(!1);let s=i[r];if(s||(i[r]=s=new e(n)),s.limit!==n)throw t.release(),new ReferenceError(`Cannot get object with different restriction: key: '${String(r)}', lock.limit: ${s.limit} <-> restriction: ${n},`);return t.release(),s
-})(r,n),c=a.flow(s);return a.last=Date.now(),c}return{getLockByKey:async e=>{await t.acquire(!1);const r=i[e];return t.release(),r},cleanup:async(e,r)=>{await t.acquire(!1);const n=i,s=Object.create(null),a=Object.keys(n);let c,o=0;!e&&(e=1),e*=1e3,r&&(c=[]);for(let t=0,i=a.length;t<i;){const i=a[t++],l=n[i];l.last&&Date.now()-l.last>=e?(o++,r&&c.push(i)):s[i]=l}return i=s,t.release(),r&&console.log(`eliminated: [\n${c.join(",\n")}\n]\nlived: [\n${Object.keys(s).join(",\n")}\n]`),o},multi:n,one:async function(e,t){return n(e,1,t)}}})()},121(e,t,i){Object.defineProperty(t,"__esModule",{value:!0}),t.createWithAbort=t.create=void 0;const r=i(721),n=i(884),s=r.acquire,a=r.release,c=r.acquireWithAbort,o=r.releaseWithAbort,l=e=>({capacity:e,limit:e,q:new n.Deque(e),setRestriction(e){
-this.limit=this.capacity=e}});t.create=e=>({...l(e),get pending(){return this.q.length},acquire(e){return s(this,e)},release(){a(this)},async flow(e,t){await s(this,t);try{return await e()}finally{a(this)}}});t.createWithAbort=e=>{const t=l(e),i=[];return{...t,get pending(){return this.q.length},acquire(){return c(this)},release(){o(this)},async flow(e){let t;try{await c(this),t=await e(),o(this)}finally{return t}},abort(){const e={message:"Process Aborted"};i.forEach(t=>t(e));const t=this.q;let r;for(;r=t.shift();)r.reject(e);this.capacity=this.limit},onAbort(e){i.includes(e)||i.push(e)},offAbort(e){const t=i.findIndex(t=>e===t);-1!==t&&i.splice(t,1)}}}}},t={};function i(r){var n=t[r];if(void 0!==n)return n.exports;var s=t[r]={exports:{}};return e[r](s,s.exports,i),s.exports}var r={}
-;(()=>{var e=r;Object.defineProperty(e,"__esModule",{value:!0}),e.version=e.restrictor=e.Deque=e.createWithAbort=e.create=e.MiniSemaphore=void 0;var t=i(684);Object.defineProperty(e,"MiniSemaphore",{enumerable:!0,get:function(){return t.MiniSemaphore}});var n=i(121);Object.defineProperty(e,"create",{enumerable:!0,get:function(){return n.create}}),Object.defineProperty(e,"createWithAbort",{enumerable:!0,get:function(){return n.createWithAbort}});var s=i(884);Object.defineProperty(e,"Deque",{enumerable:!0,get:function(){return s.Deque}});var a=i(650);Object.defineProperty(e,"restrictor",{enumerable:!0,get:function(){return a.restrictor}}),e.version="v1.5.2"})(),module.exports=r})();
+(()=>{"use strict";var e=[,,(e,t,r)=>{Object.defineProperty(t,"__esModule",{value:!0}),t.MiniSemaphore=void 0;const i=r(6),n=r(4),s=i.acquire,a=i.release;t.MiniSemaphore=class{constructor(e){this.limit=this.capacity=e,this.q=new n.Deque(e)}acquire(e){return s(this,e)}release(){a(this)}setRestriction(e){this.limit=this.capacity=e}get pending(){return this.q.length}async flow(e,t){await s(this,t);try{return await e()}finally{a(this)}}}},(e,t,r)=>{Object.defineProperty(t,"__esModule",{value:!0}),t.createWithAbort=t.create=void 0;const i=r(6),n=r(4),s=i.acquire,a=i.release,c=i.acquireWithAbort,o=i.releaseWithAbort,l=e=>({capacity:e,limit:e,q:new n.Deque(e),setRestriction(e){this.limit=this.capacity=e}});t.create=e=>({...l(e),get pending(){return this.q.length},acquire(e){return s(this,e)},release(){a(this)},async flow(e,t){await s(this,t);try{return await e()}finally{a(this)}}}),t.createWithAbort=e=>{const t=l(e),r=[];return{...t,get pending(){return this.q.length},acquire(){return c(this)},release(){o(this)},async flow(e){let t;try{await c(this),t=await e(),o(this)}finally{return t}},abort(){const e={message:"Process Aborted"};r.forEach(t=>t(e));const t=this.q;let i;for(;i=t.shift();)i.reject(e);this.capacity=this.limit},onAbort(e){r.includes(e)||r.push(e)},offAbort(e){const t=r.findIndex(t=>e===t);-1!==t&&r.splice(t,1)}}}},(e,t)=>{Object.defineProperty(t,"__esModule",{value:!0}),t.Deque=void 0;const r=e=>(e=>(e>>>=0,e--,e|=e>>1,e|=e>>2,e|=e>>4,1+((e|=e>>8)|e>>16)))(Math.min(Math.max(16,0|e),1073741824));t.Deque=class{constructor(e){this._c=r(e||16),this._f=0,this._a=[],this.length=0}push(e){const t=this.length;this._c<t+1&&i(this,r(1.5*this._c+16));const n=this._f+t&this._c-1;this._a[n]=e,this.length=t+1}shift(){const e=this.length;if(0===e)return;const t=this._f,r=this._a[t];return this._a[t]=void 0,this._f=t+1&this._c-1,this.length=e-1,r}};const i=(e,t)=>{const r=e._c;e._c=t;const i=e._f+e.length;if(i>r){const t=i&r-1;((e,t,r,i,n)=>{for(let t=0;t<n;++t)r[t+i]=e[t+0],e[t+0]=void 0})(e._a,0,e._a,r,t)}}},(e,t,r)=>{Object.defineProperty(t,"__esModule",{value:!0}),t.restrictor=void 0;const i=r(2);t.restrictor=(()=>{const{MiniSemaphore:e}=i,t=new e(1);let r=Object.create(null);async function n(i,n,s){const a=await(async(i,n)=>{await t.acquire(!1);let s=r[i];if(s||(r[i]=s=new e(n)),s.limit!==n)throw t.release(),new ReferenceError(`Cannot get object with different restriction: key: '${String(i)}', lock.limit: ${s.limit} <-> restriction: ${n},`);return t.release(),s})(i,n),c=a.flow(s);return a.last=Date.now(),c}return{getLockByKey:async e=>{await t.acquire(!1);const i=r[e];return t.release(),i},cleanup:async(e,i)=>{await t.acquire(!1);const n=r,s=Object.create(null),a=Object.keys(n);let c,o=0;!e&&(e=1),e*=1e3,i&&(c=[]);for(let t=0,r=a.length;t<r;){const r=a[t++],l=n[r];l.last&&Date.now()-l.last>=e?(o++,i&&c.push(r)):s[r]=l}return r=s,t.release(),i&&console.log(`eliminated: [\n${c.join(",\n")}\n]\nlived: [\n${Object.keys(s).join(",\n")}\n]`),o},multi:n,one:async function(e,t){return n(e,1,t)}}})()},(e,t)=>{Object.defineProperty(t,"__esModule",{value:!0}),t.releaseWithAbort=t.acquireWithAbort=t.release=t.acquire=void 0;const r=()=>{throw new Error("mini-semaphore: Detected an inconsistent state, possibly due to a logic error or unexpected behavior.")},i=(e,t)=>{e.capacity>0?(e.capacity--,t()):e.q.push(t)};t.acquire=(e,t=!0)=>new Promise(r=>{t?setTimeout(()=>i(e,r),4):i(e,r)}),t.release=e=>{let t;(t=e.q).length?(t.shift()||r)():e.capacity++,e.capacity>e.limit&&(console.warn(new Error("[mini-semaphore] inconsistent release!")),e.capacity=e.limit)},t.acquireWithAbort=e=>new Promise((t,r)=>{e.capacity>0?(e.capacity--,t()):e.q.push({resolve:t,reject:r})}),t.releaseWithAbort=e=>{let t;if((t=e.q).length){const e=t.shift();e&&e.resolve()||r()}else e.capacity<e.limit&&e.capacity++}}],t={};function r(i){var n=t[i];if(void 0!==n)return n.exports;var s=t[i]={exports:{}};return e[i](s,s.exports,r),s.exports}var i={};(()=>{var e=i;Object.defineProperty(e,"__esModule",{value:!0}),e.version=e.restrictor=e.Deque=e.createWithAbort=e.create=e.MiniSemaphore=void 0;var t=r(2);Object.defineProperty(e,"MiniSemaphore",{enumerable:!0,get:function(){return t.MiniSemaphore}});var n=r(3);Object.defineProperty(e,"create",{enumerable:!0,get:function(){return n.create}}),Object.defineProperty(e,"createWithAbort",{enumerable:!0,get:function(){return n.createWithAbort}});var s=r(4);Object.defineProperty(e,"Deque",{enumerable:!0,get:function(){return s.Deque}});var a=r(5);Object.defineProperty(e,"restrictor",{enumerable:!0,get:function(){return a.restrictor}}),e.version="v1.5.4"})(),module.exports=i})();

package/webpack-esm/index.mjs

@@ -1,8 +1,2 @@
-/*! For license information please see index.js.LICENSE.txt */
-var e={684(e,t,r){Object.defineProperty(t,"__esModule",{value:!0}),t.MiniSemaphore=void 0;const i=r(721),s=r(884),n=i.acquire,a=i.release;t.MiniSemaphore=class{constructor(e){this.limit=this.capacity=e,this.q=new s.Deque(e)}acquire(e){return n(this,e)}release(){a(this)}setRestriction(e){this.limit=this.capacity=e}get pending(){return this.q.length}async flow(e,t){await n(this,t);try{return await e()}finally{a(this)}}}},721(e,t){Object.defineProperty(t,"__esModule",{value:!0}),t.releaseWithAbort=t.acquireWithAbort=t.release=t.acquire=void 0;const r=()=>{throw new Error("mini-semaphore: Detected an inconsistent state, possibly due to a logic error or unexpected behavior.")},i=(e,t)=>{e.capacity>0?(e.capacity--,t()):e.q.push(t)};t.acquire=(e,t=!0)=>new Promise(r=>{
-t?setTimeout(()=>i(e,r),4):i(e,r)});t.release=e=>{let t;(t=e.q).length?(t.shift()||r)():e.capacity++,e.capacity>e.limit&&(console.warn("inconsistent release!"),e.capacity=e.limit)};t.acquireWithAbort=e=>new Promise((t,r)=>{e.capacity>0?(e.capacity--,t()):e.q.push({resolve:t,reject:r})});t.releaseWithAbort=e=>{let t;if((t=e.q).length){const e=t.shift();e&&e.resolve()||r()}else e.capacity<e.limit&&e.capacity++}},884(e,t){Object.defineProperty(t,"__esModule",{value:!0}),t.Deque=void 0;const r=e=>(e=>(e>>>=0,e--,e|=e>>1,e|=e>>2,e|=e>>4,e|=e>>8,1+(e|=e>>16)))(Math.min(Math.max(16,0|e),1073741824));t.Deque=class{constructor(e){this._c=r(e||16),this._l=0,this._f=0,this._a=[],this.length=0}push(e){const t=this._l;this._c<t+1&&i(this,r(1.5*this._c+16));const s=this._f+t&this._c-1;this._a[s]=e,
-this.length=this._l=t+1}shift(){const e=this._l;if(0===e)return;const t=this._f,r=this._a[t];return this._a[t]=void 0,this._f=t+1&this._c-1,this.length=this._l=e-1,r}};const i=(e,t)=>{const r=e._c;e._c=t;const i=e._f+e._l;if(i>r){const t=i&r-1;((e,t,r,i,s)=>{for(let n=0;n<s;++n)r[n+i]=e[n+t],e[n+t]=void 0})(e._a,0,e._a,r,t)}}},650(e,t,r){Object.defineProperty(t,"__esModule",{value:!0}),t.restrictor=void 0;const i=r(684);t.restrictor=(()=>{const{MiniSemaphore:e}=i,t=new e(1);let r=Object.create(null);async function s(i,s,n){const a=await(async(i,s)=>{await t.acquire(!1);let n=r[i];if(n||(r[i]=n=new e(s)),n.limit!==s)throw t.release(),new ReferenceError(`Cannot get object with different restriction: key: '${String(i)}', lock.limit: ${n.limit} <-> restriction: ${s},`);return t.release(),n
-})(i,s),c=a.flow(n);return a.last=Date.now(),c}return{getLockByKey:async e=>{await t.acquire(!1);const i=r[e];return t.release(),i},cleanup:async(e,i)=>{await t.acquire(!1);const s=r,n=Object.create(null),a=Object.keys(s);let c,o=0;!e&&(e=1),e*=1e3,i&&(c=[]);for(let t=0,r=a.length;t<r;){const r=a[t++],l=s[r];l.last&&Date.now()-l.last>=e?(o++,i&&c.push(r)):n[r]=l}return r=n,t.release(),i&&console.log(`eliminated: [\n${c.join(",\n")}\n]\nlived: [\n${Object.keys(n).join(",\n")}\n]`),o},multi:s,one:async function(e,t){return s(e,1,t)}}})()},121(e,t,r){Object.defineProperty(t,"__esModule",{value:!0}),t.createWithAbort=t.create=void 0;const i=r(721),s=r(884),n=i.acquire,a=i.release,c=i.acquireWithAbort,o=i.releaseWithAbort,l=e=>({capacity:e,limit:e,q:new s.Deque(e),setRestriction(e){
-this.limit=this.capacity=e}});t.create=e=>({...l(e),get pending(){return this.q.length},acquire(e){return n(this,e)},release(){a(this)},async flow(e,t){await n(this,t);try{return await e()}finally{a(this)}}});t.createWithAbort=e=>{const t=l(e),r=[];return{...t,get pending(){return this.q.length},acquire(){return c(this)},release(){o(this)},async flow(e){let t;try{await c(this),t=await e(),o(this)}finally{return t}},abort(){const e={message:"Process Aborted"};r.forEach(t=>t(e));const t=this.q;let i;for(;i=t.shift();)i.reject(e);this.capacity=this.limit},onAbort(e){r.includes(e)||r.push(e)},offAbort(e){const t=r.findIndex(t=>e===t);-1!==t&&r.splice(t,1)}}}}},t={};function r(i){var s=t[i];if(void 0!==s)return s.exports;var n=t[i]={exports:{}};return e[i](n,n.exports,r),n.exports}var i={}
-;(()=>{var e=i;Object.defineProperty(e,"__esModule",{value:!0}),e.version=e.restrictor=e.Deque=e.createWithAbort=e.create=e.MiniSemaphore=void 0;var t=r(684);Object.defineProperty(e,"MiniSemaphore",{enumerable:!0,get:function(){return t.MiniSemaphore}});var s=r(121);Object.defineProperty(e,"create",{enumerable:!0,get:function(){return s.create}}),Object.defineProperty(e,"createWithAbort",{enumerable:!0,get:function(){return s.createWithAbort}});var n=r(884);Object.defineProperty(e,"Deque",{enumerable:!0,get:function(){return n.Deque}});var a=r(650);Object.defineProperty(e,"restrictor",{enumerable:!0,get:function(){return a.restrictor}}),e.version="v1.5.2"})();const s=i.Deque,n=i.MiniSemaphore,a=i.__esModule,c=i.create,o=i.createWithAbort,l=i.restrictor,h=i.version
-;export{s as Deque,n as MiniSemaphore,a as __esModule,c as create,o as createWithAbort,l as restrictor,h as version,i as default};
+/*! For license information please see index.mjs.LICENSE.txt */
+var e=[,,(e,t,r)=>{Object.defineProperty(t,"__esModule",{value:!0}),t.MiniSemaphore=void 0;const i=r(6),n=r(4),s=i.acquire,a=i.release;t.MiniSemaphore=class{constructor(e){this.limit=this.capacity=e,this.q=new n.Deque(e)}acquire(e){return s(this,e)}release(){a(this)}setRestriction(e){this.limit=this.capacity=e}get pending(){return this.q.length}async flow(e,t){await s(this,t);try{return await e()}finally{a(this)}}}},(e,t,r)=>{Object.defineProperty(t,"__esModule",{value:!0}),t.createWithAbort=t.create=void 0;const i=r(6),n=r(4),s=i.acquire,a=i.release,c=i.acquireWithAbort,o=i.releaseWithAbort,l=e=>({capacity:e,limit:e,q:new n.Deque(e),setRestriction(e){this.limit=this.capacity=e}});t.create=e=>({...l(e),get pending(){return this.q.length},acquire(e){return s(this,e)},release(){a(this)},async flow(e,t){await s(this,t);try{return await e()}finally{a(this)}}}),t.createWithAbort=e=>{const t=l(e),r=[];return{...t,get pending(){return this.q.length},acquire(){return c(this)},release(){o(this)},async flow(e){let t;try{await c(this),t=await e(),o(this)}finally{return t}},abort(){const e={message:"Process Aborted"};r.forEach(t=>t(e));const t=this.q;let i;for(;i=t.shift();)i.reject(e);this.capacity=this.limit},onAbort(e){r.includes(e)||r.push(e)},offAbort(e){const t=r.findIndex(t=>e===t);-1!==t&&r.splice(t,1)}}}},(e,t)=>{Object.defineProperty(t,"__esModule",{value:!0}),t.Deque=void 0;const r=e=>(e=>(e>>>=0,e--,e|=e>>1,e|=e>>2,e|=e>>4,1+((e|=e>>8)|e>>16)))(Math.min(Math.max(16,0|e),1073741824));t.Deque=class{constructor(e){this._c=r(e||16),this._f=0,this._a=[],this.length=0}push(e){const t=this.length;this._c<t+1&&i(this,r(1.5*this._c+16));const n=this._f+t&this._c-1;this._a[n]=e,this.length=t+1}shift(){const e=this.length;if(0===e)return;const t=this._f,r=this._a[t];return this._a[t]=void 0,this._f=t+1&this._c-1,this.length=e-1,r}};const i=(e,t)=>{const r=e._c;e._c=t;const i=e._f+e.length;if(i>r){const t=i&r-1;((e,t,r,i,n)=>{for(let t=0;t<n;++t)r[t+i]=e[t+0],e[t+0]=void 0})(e._a,0,e._a,r,t)}}},(e,t,r)=>{Object.defineProperty(t,"__esModule",{value:!0}),t.restrictor=void 0;const i=r(2);t.restrictor=(()=>{const{MiniSemaphore:e}=i,t=new e(1);let r=Object.create(null);async function n(i,n,s){const a=await(async(i,n)=>{await t.acquire(!1);let s=r[i];if(s||(r[i]=s=new e(n)),s.limit!==n)throw t.release(),new ReferenceError(`Cannot get object with different restriction: key: '${String(i)}', lock.limit: ${s.limit} <-> restriction: ${n},`);return t.release(),s})(i,n),c=a.flow(s);return a.last=Date.now(),c}return{getLockByKey:async e=>{await t.acquire(!1);const i=r[e];return t.release(),i},cleanup:async(e,i)=>{await t.acquire(!1);const n=r,s=Object.create(null),a=Object.keys(n);let c,o=0;!e&&(e=1),e*=1e3,i&&(c=[]);for(let t=0,r=a.length;t<r;){const r=a[t++],l=n[r];l.last&&Date.now()-l.last>=e?(o++,i&&c.push(r)):s[r]=l}return r=s,t.release(),i&&console.log(`eliminated: [\n${c.join(",\n")}\n]\nlived: [\n${Object.keys(s).join(",\n")}\n]`),o},multi:n,one:async function(e,t){return n(e,1,t)}}})()},(e,t)=>{Object.defineProperty(t,"__esModule",{value:!0}),t.releaseWithAbort=t.acquireWithAbort=t.release=t.acquire=void 0;const r=()=>{throw new Error("mini-semaphore: Detected an inconsistent state, possibly due to a logic error or unexpected behavior.")},i=(e,t)=>{e.capacity>0?(e.capacity--,t()):e.q.push(t)};t.acquire=(e,t=!0)=>new Promise(r=>{t?setTimeout(()=>i(e,r),4):i(e,r)}),t.release=e=>{let t;(t=e.q).length?(t.shift()||r)():e.capacity++,e.capacity>e.limit&&(console.warn(new Error("[mini-semaphore] inconsistent release!")),e.capacity=e.limit)},t.acquireWithAbort=e=>new Promise((t,r)=>{e.capacity>0?(e.capacity--,t()):e.q.push({resolve:t,reject:r})}),t.releaseWithAbort=e=>{let t;if((t=e.q).length){const e=t.shift();e&&e.resolve()||r()}else e.capacity<e.limit&&e.capacity++}}],t={};function r(i){var n=t[i];if(void 0!==n)return n.exports;var s=t[i]={exports:{}};return e[i](s,s.exports,r),s.exports}var i={};(()=>{var e=i;Object.defineProperty(e,"__esModule",{value:!0}),e.version=e.restrictor=e.Deque=e.createWithAbort=e.create=e.MiniSemaphore=void 0;var t=r(2);Object.defineProperty(e,"MiniSemaphore",{enumerable:!0,get:function(){return t.MiniSemaphore}});var n=r(3);Object.defineProperty(e,"create",{enumerable:!0,get:function(){return n.create}}),Object.defineProperty(e,"createWithAbort",{enumerable:!0,get:function(){return n.createWithAbort}});var s=r(4);Object.defineProperty(e,"Deque",{enumerable:!0,get:function(){return s.Deque}});var a=r(5);Object.defineProperty(e,"restrictor",{enumerable:!0,get:function(){return a.restrictor}}),e.version="v1.5.4"})();const n=i.Deque,s=i.MiniSemaphore,a=i.__esModule,c=i.create,o=i.createWithAbort,l=i.restrictor,h=i.version;export{n as Deque,s as MiniSemaphore,a as __esModule,c as create,o as createWithAbort,l as restrictor,h as version,i as default};

package/umd/index.d.ts

@@ -1,236 +0,0 @@
-/**
- * ### Implementation restricted to FIFO
- *
- * this class is based on https://github.com/petkaantonov/deque/blob/master/js/deque.js
- * Released under the MIT License: https://github.com/petkaantonov/deque/blob/master/LICENSE
- */
-export declare class Deque<T extends any> {
-    /**
-     * capacity
-     * @internal
-     */
-    _c: number;
-    /**
-     * current length (size
-     * @internal
-     */
-    _l: number;
-    /**
-     * current front position
-     * @internal
-     */
-    _f: number;
-    /**
-     * @internal
-     */
-    _a: T[];
-
-    /**
-     * default capacity `16`
-     * @param ic initial capacity
-     */
-    constructor(ic?: number);
-    /**
-     * @param s subject
-     */
-    push(s: T): void;
-    shift(): T | undefined;
-    // clear(): void;
-    readonly length: number;
-}
-
-/**
- * basic of simplified lock interface
- */
-export interface ISimplifiedLock {
-    /**
-     *  acquire the process rights
-     *
-     * @param lazy Whether the privilege acquisition process is deffer. default `true`
-     */
-    acquire(lazy?: boolean): Promise<void>;
-    /**
-     *  release the pending of one
-     */
-    release(): void;
-    /**
-     * Change sharing restrictions to the value of `restriction`
-     * @param {number} restriction
-     */
-    setRestriction(restriction: number): void;
-    /**
-     * Get the number of currently pending processes
-     * @type {number}
-     */
-    readonly pending: number;
-    /**
-     * limitation
-     */
-    limit: number;
-    /**
-     * capacity
-     */
-    capacity: number;
-}
-/**
- * extention of `ISimplifiedLock` interface
- */
-export interface IFlowableLock extends ISimplifiedLock {
-    /**
-     * combination of acquire/release
-     *
-     *   + acquire/release is automatic
-     *
-     * @param lazy Whether the privilege acquisition process is deffer. default `true`
-     */
-    flow<T>(f: () => Promise<T>, lazy?: boolean): Promise<T>;
-}
-/**
- * internal type for `createMiniSemaphore`
- */
-export declare type TFlowableLock<T = TVoidFunction> = IFlowableLock & {
-    /**
-     * pending
-     */
-    readonly q: Deque<T>;
-};
-export declare type TVoidFunction = () => void;
-
-export declare type TResolver = {
-    resolve: () => void;
-    reject: (reason: any) => void;
-};
-export declare interface IProcessAbortedError {
-    readonly message: "Process Aborted";
-}
-export type TAbortListener = (reason: IProcessAbortedError) => void;
-export declare type TFlowableLockWithAbort = IFlowableLock & {
-    readonly q: Deque<TResolver>;
-    abort(): void;
-    onAbort(listener: TAbortListener): void;
-    offAbort(listener: TAbortListener): void;
-};
-
-/**
- * #### Mini Semaphore
- *
- *   + minimal implementation of semaphore
- *
- * @example
- * import { MiniSemaphore } from "mini-semaphore";
- *
- * const s = new MiniSemaphore(10);
- * async function fetchTypeData(type_id) {
- *   await s.acquire();
- *   try {
- *       return fetch(`https://esi.evetech.net/latest/universe/types/${type_id}/`);
- *   } finally {
- *       s.release();
- *   }
- * }
- *
- * //
- * // or automatic acquire/release
- * //
- * async function fetchTypeData(type_id) {
- *   return s.flow(async () => fetch(`https://esi.evetech.net/latest/universe/types/${type_id}/`));
- * }
- *
- * @date 2020/2/7
- * @version 1.0
- */
-export declare class MiniSemaphore implements TFlowableLock {
-    /**
-     * spare capacity
-     */
-    capacity: number;
-    /**
-     * limitation
-     */
-    limit: number;
-    /**
-     * queue of Promise's `resolve`
-     */
-    q: Deque<TVoidFunction>;
-    /**
-     * constructs a semaphore instance limited at `capacity`
-     *
-     * @param capacity limitation of concurrent async by `capacity`
-     */
-    constructor(capacity: number);
-    /**
-     * If there is enough capacity, execute the `resolve` immediately
-     *
-     * If not, put it in a queue and wait for the currently pending process to execute `release`
-     */
-    acquire(lazy?: boolean): Promise<void>;
-    release(): void;
-    setRestriction(restriction: number): void;
-    get pending(): number;
-    /**
-     * automatic acquire/release
-     * @param process
-     */
-    flow<T>(process: () => Promise<T>, lazy?: boolean): Promise<T>;
-}
-
-/**
- * object implementation of `TFlowableLock`
- *
- *   + constructs a semaphore object limited at `capacity`
- *
- * @param capacity limitation of concurrent async by `capacity`
- * @date 2020/2/7
- * @version 1.0
- */
-export declare const create: (capacity: number) => TFlowableLock;
-/**
- * object implementation of `TFlowableLockWithAbort`
- * 
- *   + constructs a semaphore object limited at `capacity`
- * 
- * @param {number} capacity limitation of concurrent async by `capacity`
- * @date 2025/5/12
- * @version 1.4
- */
-export declare const createWithAbort: (capacity: number) => TFlowableLockWithAbort;
-
-
-declare namespace fr {
-    /**
-     * Eliminate unused instances for the `timeSpan` seconds
-     * 
-     * @param timeSpan specify unit as seconds
-     * @returns {Promise<number>} eliminated count
-     * @date 2020/6/19
-     */
-    const cleanup: (timeSpan: number, debug?: true | undefined) => Promise<number>;
-    /**
-     * get the semaphore associated with the value of `key`
-     *
-     *   + ⚠️ The object to be retrieved with `key` must already be created with `multi` ore `one`
-     *
-     * @param key
-     * @returns `IFlowableLock` instance or `undefined`
-     */
-    export const getLockByKey: (key: string | number) => Promise<IFlowableLock | undefined>;
-    /**
-     * Allocate a semaphore for each `key`, and limit the number of shares with the value of `restriction`
-     *
-     * @param key number or string as tag
-     * @param restriction number of process restriction
-     * @param pb the process body
-     */
-    export function multi<T>(key: string | number, restriction: number, pb: () => Promise<T>): Promise<T>;
-    /**
-     * synonym of `multi(key, 1, pb)`
-     *
-     *  + use case
-     *    * Avoid concurrent requests to the same url
-     *
-     * @param key number or string as tag
-     * @param pb the process body
-     */
-    export function one<T>(key: string | number, pb: () => Promise<T>): Promise<T>;
-}
-export declare const restrictor: typeof fr;

package/webpack/index.d.ts

@@ -1,236 +0,0 @@
-/**
- * ### Implementation restricted to FIFO
- *
- * this class is based on https://github.com/petkaantonov/deque/blob/master/js/deque.js
- * Released under the MIT License: https://github.com/petkaantonov/deque/blob/master/LICENSE
- */
-export declare class Deque<T extends any> {
-    /**
-     * capacity
-     * @internal
-     */
-    _c: number;
-    /**
-     * current length (size
-     * @internal
-     */
-    _l: number;
-    /**
-     * current front position
-     * @internal
-     */
-    _f: number;
-    /**
-     * @internal
-     */
-    _a: T[];
-
-    /**
-     * default capacity `16`
-     * @param ic initial capacity
-     */
-    constructor(ic?: number);
-    /**
-     * @param s subject
-     */
-    push(s: T): void;
-    shift(): T | undefined;
-    // clear(): void;
-    readonly length: number;
-}
-
-/**
- * basic of simplified lock interface
- */
-export interface ISimplifiedLock {
-    /**
-     *  acquire the process rights
-     *
-     * @param lazy Whether the privilege acquisition process is deffer. default `true`
-     */
-    acquire(lazy?: boolean): Promise<void>;
-    /**
-     *  release the pending of one
-     */
-    release(): void;
-    /**
-     * Change sharing restrictions to the value of `restriction`
-     * @param {number} restriction
-     */
-    setRestriction(restriction: number): void;
-    /**
-     * Get the number of currently pending processes
-     * @type {number}
-     */
-    readonly pending: number;
-    /**
-     * limitation
-     */
-    limit: number;
-    /**
-     * capacity
-     */
-    capacity: number;
-}
-/**
- * extention of `ISimplifiedLock` interface
- */
-export interface IFlowableLock extends ISimplifiedLock {
-    /**
-     * combination of acquire/release
-     *
-     *   + acquire/release is automatic
-     *
-     * @param lazy Whether the privilege acquisition process is deffer. default `true`
-     */
-    flow<T>(f: () => Promise<T>, lazy?: boolean): Promise<T>;
-}
-/**
- * internal type for `createMiniSemaphore`
- */
-export declare type TFlowableLock<T = TVoidFunction> = IFlowableLock & {
-    /**
-     * pending
-     */
-    readonly q: Deque<T>;
-};
-export declare type TVoidFunction = () => void;
-
-export declare type TResolver = {
-    resolve: () => void;
-    reject: (reason: any) => void;
-};
-export declare interface IProcessAbortedError {
-    readonly message: "Process Aborted";
-}
-export type TAbortListener = (reason: IProcessAbortedError) => void;
-export declare type TFlowableLockWithAbort = IFlowableLock & {
-    readonly q: Deque<TResolver>;
-    abort(): void;
-    onAbort(listener: TAbortListener): void;
-    offAbort(listener: TAbortListener): void;
-};
-
-/**
- * #### Mini Semaphore
- *
- *   + minimal implementation of semaphore
- *
- * @example
- * import { MiniSemaphore } from "mini-semaphore";
- *
- * const s = new MiniSemaphore(10);
- * async function fetchTypeData(type_id) {
- *   await s.acquire();
- *   try {
- *       return fetch(`https://esi.evetech.net/latest/universe/types/${type_id}/`);
- *   } finally {
- *       s.release();
- *   }
- * }
- *
- * //
- * // or automatic acquire/release
- * //
- * async function fetchTypeData(type_id) {
- *   return s.flow(async () => fetch(`https://esi.evetech.net/latest/universe/types/${type_id}/`));
- * }
- *
- * @date 2020/2/7
- * @version 1.0
- */
-export declare class MiniSemaphore implements TFlowableLock {
-    /**
-     * spare capacity
-     */
-    capacity: number;
-    /**
-     * limitation
-     */
-    limit: number;
-    /**
-     * queue of Promise's `resolve`
-     */
-    q: Deque<TVoidFunction>;
-    /**
-     * constructs a semaphore instance limited at `capacity`
-     *
-     * @param capacity limitation of concurrent async by `capacity`
-     */
-    constructor(capacity: number);
-    /**
-     * If there is enough capacity, execute the `resolve` immediately
-     *
-     * If not, put it in a queue and wait for the currently pending process to execute `release`
-     */
-    acquire(lazy?: boolean): Promise<void>;
-    release(): void;
-    setRestriction(restriction: number): void;
-    get pending(): number;
-    /**
-     * automatic acquire/release
-     * @param process
-     */
-    flow<T>(process: () => Promise<T>, lazy?: boolean): Promise<T>;
-}
-
-/**
- * object implementation of `TFlowableLock`
- *
- *   + constructs a semaphore object limited at `capacity`
- *
- * @param capacity limitation of concurrent async by `capacity`
- * @date 2020/2/7
- * @version 1.0
- */
-export declare const create: (capacity: number) => TFlowableLock;
-/**
- * object implementation of `TFlowableLockWithAbort`
- * 
- *   + constructs a semaphore object limited at `capacity`
- * 
- * @param {number} capacity limitation of concurrent async by `capacity`
- * @date 2025/5/12
- * @version 1.4
- */
-export declare const createWithAbort: (capacity: number) => TFlowableLockWithAbort;
-
-
-declare namespace fr {
-    /**
-     * Eliminate unused instances for the `timeSpan` seconds
-     * 
-     * @param timeSpan specify unit as seconds
-     * @returns {Promise<number>} eliminated count
-     * @date 2020/6/19
-     */
-    const cleanup: (timeSpan: number, debug?: true | undefined) => Promise<number>;
-    /**
-     * get the semaphore associated with the value of `key`
-     *
-     *   + ⚠️ The object to be retrieved with `key` must already be created with `multi` ore `one`
-     *
-     * @param key
-     * @returns `IFlowableLock` instance or `undefined`
-     */
-    export const getLockByKey: (key: string | number) => Promise<IFlowableLock | undefined>;
-    /**
-     * Allocate a semaphore for each `key`, and limit the number of shares with the value of `restriction`
-     *
-     * @param key number or string as tag
-     * @param restriction number of process restriction
-     * @param pb the process body
-     */
-    export function multi<T>(key: string | number, restriction: number, pb: () => Promise<T>): Promise<T>;
-    /**
-     * synonym of `multi(key, 1, pb)`
-     *
-     *  + use case
-     *    * Avoid concurrent requests to the same url
-     *
-     * @param key number or string as tag
-     * @param pb the process body
-     */
-    export function one<T>(key: string | number, pb: () => Promise<T>): Promise<T>;
-}
-export declare const restrictor: typeof fr;

package/webpack-esm/index.d.mts

@@ -1,236 +0,0 @@
-/**
- * ### Implementation restricted to FIFO
- *
- * this class is based on https://github.com/petkaantonov/deque/blob/master/js/deque.js
- * Released under the MIT License: https://github.com/petkaantonov/deque/blob/master/LICENSE
- */
-export declare class Deque<T extends any> {
-    /**
-     * capacity
-     * @internal
-     */
-    _c: number;
-    /**
-     * current length (size
-     * @internal
-     */
-    _l: number;
-    /**
-     * current front position
-     * @internal
-     */
-    _f: number;
-    /**
-     * @internal
-     */
-    _a: T[];
-
-    /**
-     * default capacity `16`
-     * @param ic initial capacity
-     */
-    constructor(ic?: number);
-    /**
-     * @param s subject
-     */
-    push(s: T): void;
-    shift(): T | undefined;
-    // clear(): void;
-    readonly length: number;
-}
-
-/**
- * basic of simplified lock interface
- */
-export interface ISimplifiedLock {
-    /**
-     *  acquire the process rights
-     *
-     * @param lazy Whether the privilege acquisition process is deffer. default `true`
-     */
-    acquire(lazy?: boolean): Promise<void>;
-    /**
-     *  release the pending of one
-     */
-    release(): void;
-    /**
-     * Change sharing restrictions to the value of `restriction`
-     * @param {number} restriction
-     */
-    setRestriction(restriction: number): void;
-    /**
-     * Get the number of currently pending processes
-     * @type {number}
-     */
-    readonly pending: number;
-    /**
-     * limitation
-     */
-    limit: number;
-    /**
-     * capacity
-     */
-    capacity: number;
-}
-/**
- * extention of `ISimplifiedLock` interface
- */
-export interface IFlowableLock extends ISimplifiedLock {
-    /**
-     * combination of acquire/release
-     *
-     *   + acquire/release is automatic
-     *
-     * @param lazy Whether the privilege acquisition process is deffer. default `true`
-     */
-    flow<T>(f: () => Promise<T>, lazy?: boolean): Promise<T>;
-}
-/**
- * internal type for `createMiniSemaphore`
- */
-export declare type TFlowableLock<T = TVoidFunction> = IFlowableLock & {
-    /**
-     * pending
-     */
-    readonly q: Deque<T>;
-};
-export declare type TVoidFunction = () => void;
-
-export declare type TResolver = {
-    resolve: () => void;
-    reject: (reason: any) => void;
-};
-export declare interface IProcessAbortedError {
-    readonly message: "Process Aborted";
-}
-export type TAbortListener = (reason: IProcessAbortedError) => void;
-export declare type TFlowableLockWithAbort = IFlowableLock & {
-    readonly q: Deque<TResolver>;
-    abort(): void;
-    onAbort(listener: TAbortListener): void;
-    offAbort(listener: TAbortListener): void;
-};
-
-/**
- * #### Mini Semaphore
- *
- *   + minimal implementation of semaphore
- *
- * @example
- * import { MiniSemaphore } from "mini-semaphore";
- *
- * const s = new MiniSemaphore(10);
- * async function fetchTypeData(type_id) {
- *   await s.acquire();
- *   try {
- *       return fetch(`https://esi.evetech.net/latest/universe/types/${type_id}/`);
- *   } finally {
- *       s.release();
- *   }
- * }
- *
- * //
- * // or automatic acquire/release
- * //
- * async function fetchTypeData(type_id) {
- *   return s.flow(async () => fetch(`https://esi.evetech.net/latest/universe/types/${type_id}/`));
- * }
- *
- * @date 2020/2/7
- * @version 1.0
- */
-export declare class MiniSemaphore implements TFlowableLock {
-    /**
-     * spare capacity
-     */
-    capacity: number;
-    /**
-     * limitation
-     */
-    limit: number;
-    /**
-     * queue of Promise's `resolve`
-     */
-    q: Deque<TVoidFunction>;
-    /**
-     * constructs a semaphore instance limited at `capacity`
-     *
-     * @param capacity limitation of concurrent async by `capacity`
-     */
-    constructor(capacity: number);
-    /**
-     * If there is enough capacity, execute the `resolve` immediately
-     *
-     * If not, put it in a queue and wait for the currently pending process to execute `release`
-     */
-    acquire(lazy?: boolean): Promise<void>;
-    release(): void;
-    setRestriction(restriction: number): void;
-    get pending(): number;
-    /**
-     * automatic acquire/release
-     * @param process
-     */
-    flow<T>(process: () => Promise<T>, lazy?: boolean): Promise<T>;
-}
-
-/**
- * object implementation of `TFlowableLock`
- *
- *   + constructs a semaphore object limited at `capacity`
- *
- * @param capacity limitation of concurrent async by `capacity`
- * @date 2020/2/7
- * @version 1.0
- */
-export declare const create: (capacity: number) => TFlowableLock;
-/**
- * object implementation of `TFlowableLockWithAbort`
- * 
- *   + constructs a semaphore object limited at `capacity`
- * 
- * @param {number} capacity limitation of concurrent async by `capacity`
- * @date 2025/5/12
- * @version 1.4
- */
-export declare const createWithAbort: (capacity: number) => TFlowableLockWithAbort;
-
-
-declare namespace fr {
-    /**
-     * Eliminate unused instances for the `timeSpan` seconds
-     * 
-     * @param timeSpan specify unit as seconds
-     * @returns {Promise<number>} eliminated count
-     * @date 2020/6/19
-     */
-    const cleanup: (timeSpan: number, debug?: true | undefined) => Promise<number>;
-    /**
-     * get the semaphore associated with the value of `key`
-     *
-     *   + ⚠️ The object to be retrieved with `key` must already be created with `multi` ore `one`
-     *
-     * @param key
-     * @returns `IFlowableLock` instance or `undefined`
-     */
-    export const getLockByKey: (key: string | number) => Promise<IFlowableLock | undefined>;
-    /**
-     * Allocate a semaphore for each `key`, and limit the number of shares with the value of `restriction`
-     *
-     * @param key number or string as tag
-     * @param restriction number of process restriction
-     * @param pb the process body
-     */
-    export function multi<T>(key: string | number, restriction: number, pb: () => Promise<T>): Promise<T>;
-    /**
-     * synonym of `multi(key, 1, pb)`
-     *
-     *  + use case
-     *    * Avoid concurrent requests to the same url
-     *
-     * @param key number or string as tag
-     * @param pb the process body
-     */
-    export function one<T>(key: string | number, pb: () => Promise<T>): Promise<T>;
-}
-export declare const restrictor: typeof fr;