mini-semaphore 1.4.2 → 1.5.1

package/README.md

@@ -163,6 +163,69 @@ async function resolve(id: string | number): Promise<TType> {
 }
 
 ```
+
+---
+> ## Abortable Semaphore
+
+Starting from version **1.4.3**, `mini-semaphore` introduces support for abortable semaphores.  
+This feature allows you to cancel pending tasks and notify listeners when an abort event occurs.  
+This is particularly useful in scenarios where you need to terminate ongoing operations gracefully.
+
+### Key Features
+
+- **Abort Method**: Immediately cancels all pending tasks and restores the semaphore's capacity.
+- **Event Emission**: Emits an `abort` event to notify listeners of the cancellation.
+- **Listener Management**: Provides `onAbort` and `offAbort` methods to register and remove event listeners.
+
+### Example Usage
+
+```typescript
+import { createWithAbort } from "mini-semaphore";
+
+// Create an abortable semaphore with a capacity of 3
+const semaphore = createWithAbort(3);
+
+// Register an abort event listener
+semaphore.onAbort((reason) => {
+    console.log("Abort event received:", reason.message);
+});
+
+// Simulate tasks
+const task = async (id: number) => {
+    try {
+        await semaphore.acquire();
+        console.log(`Task ${id} started`);
+        await new Promise((resolve) => setTimeout(resolve, 1000)); // Simulate work
+        console.log(`Task ${id} completed`);
+        semaphore.release();
+    } catch (e) {
+        console.log(`Task ${id} aborted:`, e.message);
+    }
+};
+
+// Start tasks
+const tasks = [1, 2, 3, 4, 5].map((id) => task(id));
+
+// Abort all pending tasks after 2 seconds
+setTimeout(() => {
+    semaphore.abort();
+}, 2000);
+
+// Wait for all tasks to settle
+Promise.allSettled(tasks).then(() => {
+    console.log("All tasks settled");
+});
+```
+
+### Explanation
+
+1. **Creating an Abortable Semaphore**: Use `createWithAbort` to create a semaphore with abort capabilities.
+2. **Registering Listeners**: Use `onAbort` to listen for abort events and handle cleanup or logging.
+3. **Aborting Tasks**: Call `abort` to cancel all pending tasks. Tasks that are already running will not be interrupted but will complete normally.
+4. **Graceful Cleanup**: Use `offAbort` to remove listeners when they are no longer needed.
+
+This feature enhances the flexibility of `mini-semaphore`, making it suitable for more complex concurrency control scenarios.
+
 > ## Authors
 
  + **jeffy-g** - [jeffy-g](https://github.com/jeffy-g)

package/cjs/class.d.ts

@@ -0,0 +1,85 @@
+/*!
+ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
+  Copyright (C) 2020 jeffy-g <hirotom1107@gmail.com>
+  Released under the MIT license
+  https://opensource.org/licenses/mit-license.php
+ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
+*/
+/**
+ * @file minimal implementation of semaphore (class implementation
+ * @author jeffy-g <hirotom1107@gmail.com>
+ * @version 1.0
+ */
+import * as core from "./core";
+import { Deque } from "./deque";
+export type * from "./core";
+/**
+ * #### 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 core.TFlowableLock {
+    /**
+     * spare capacity
+     */
+    capacity: number;
+    /**
+     * limitation
+     */
+    limit: number;
+    /**
+     * queue of Promise's `resolve`
+     */
+    q: Deque<core.TVoidFunction>;
+    /**
+     * constructs a semaphore instance limited at `capacity`
+     *
+     * @param {number} 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`
+     *
+     * @param {boolean=} lazy
+     */
+    acquire(lazy?: boolean): Promise<void>;
+    release(): void;
+    /**
+     * @param {number} restriction
+     */
+    setRestriction(restriction: number): void;
+    get pending(): number;
+    /**
+     * automatic acquire/release
+     *
+     * @template {any} T description
+     * @param {() => Promise<T>} process
+     * @param {boolean=} lazy
+     */
+    flow<T>(process: () => Promise<T>, lazy?: boolean): Promise<T>;
+}

package/cjs/core.d.ts

@@ -0,0 +1,107 @@
+/*!
+ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
+  Copyright (C) 2020 jeffy-g <hirotom1107@gmail.com>
+  Released under the MIT license
+  https://opensource.org/licenses/mit-license.php
+ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
+*/
+/**
+ * @file minimal implementation of semaphore (core
+ * @author jeffy-g <hirotom1107@gmail.com>
+ * @version 1.0
+ */
+import type { Deque } from "./deque";
+/**
+ * basic of simplified lock interface
+ */
+export interface ISimplifiedLock {
+    /**
+     *  acquire the process rights
+     *
+     * @param {boolean} 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
+     * @type {number}
+     */
+    limit: number;
+    /**
+     * capacity
+     * @type {number}
+     */
+    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 type TFlowableLock<T = TVoidFunction> = IFlowableLock & {
+    /**
+     * pending
+     */
+    readonly q: Deque<T>;
+};
+export type TResolver = {
+    resolve: () => void;
+    reject: (reason: any) => void;
+};
+export type TAbortListener = (reason: IProcessAbortedError) => void;
+export type TFlowableLockWithAbort = IFlowableLock & {
+    readonly q: Deque<TResolver>;
+    abort(): void;
+    onAbort(listener: TAbortListener): void;
+    offAbort(listener: TAbortListener): void;
+};
+export declare interface IProcessAbortedError {
+    readonly message: "Process Aborted";
+}
+export type TVoidFunction = () => void;
+/**
+ *
+ * @param {TFlowableLock} dis
+ * @param {boolean} [lazy] default: true
+ * @returns {Promise<void>}
+ */
+export declare const acquire: (dis: TFlowableLock, lazy?: boolean) => Promise<void>;
+/**
+ * @param {TFlowableLock} dis
+ * @returns {void}
+ */
+export declare const release: (dis: TFlowableLock) => void;
+/**
+ * @param {TFlowableLockWithAbort} dis
+ * @returns {Promise<void>}
+ */
+export declare const acquireWithAbort: (dis: TFlowableLockWithAbort) => Promise<void>;
+/**
+ * @param {TFlowableLockWithAbort} dis
+ * @returns {void}
+ */
+export declare const releaseWithAbort: (dis: TFlowableLockWithAbort) => void;

package/cjs/core.js

@@ -2,13 +2,16 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.releaseWithAbort = exports.acquireWithAbort = exports.release = exports.acquire = void 0;
 /**
- * @typedef {import("./index").TVoidFunction} TVoidFunction
- * @typedef {import("./index").Deque<TVoidFunction>} Deque
- * @typedef {import("./index").TFlowableLockWithAbort} TFlowableLockWithAbort
- * @typedef {import("./index").Deque<TResolver>} DequeWithAbort
- * @typedef {import("./index").ISimplifiedLock} ISimplifiedLock
- * @typedef {import("./index").TFlowableLock} TFlowableLock
- * @typedef {import("./index").IFlowableLock} IFlowableLock
+ * @import {
+ *   TResolver,
+ *   TVoidFunction,
+ *   TFlowableLockWithAbort,
+ *   ISimplifiedLock,
+ *   TFlowableLock,
+ *   IFlowableLock,
+ *   Deque,
+ * } from "./index.mjs";
+ * @typedef {Deque<TResolver>} DequeWithAbort
  */
 /**
  * Throws an error indicating an inconsistent state in mini-semaphore.
@@ -51,7 +54,7 @@ exports.acquire = acquire;
  * @returns {void}
  */
 const release = (dis) => {
-    /** @type {Deque} */
+    /** @type {Deque<TVoidFunction>} */
     let dq;
     if ((dq = dis.q).length) {
         (dq.shift() || /* istanbul ignore next */ THROW)();
@@ -91,13 +94,9 @@ const releaseWithAbort = (dis) => {
     let dq;
     if ((dq = dis.q).length) {
         const resolver = dq.shift();
+        resolver && resolver.resolve() || (
         /* istanbul ignore next */
-        if (!resolver) {
-            THROW();
-        }
-        else {
-            resolver.resolve();
-        }
+        THROW());
     }
     else {
         if (dis.capacity < dis.limit) {

package/cjs/deque.d.ts

@@ -0,0 +1,28 @@
+/**
+ * ### Implementation restricted to FIFO
+ *
+ * This class uses a ring buffer for efficient FIFO operations.
+ * The maximum buffer size is **`1073741824`**.
+ *
+ * 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
+ *
+ * @template {any} T
+ */
+export declare class Deque<T extends any> {
+    _c: number;
+    _l: number;
+    _f: number;
+    _a: T[];
+    length: number;
+    /**
+     * default capacity `16`
+     * @param {number=} ic initial capacity
+     */
+    constructor(ic?: number);
+    /**
+     * @param {T} s subject
+     */
+    push(s: T): void;
+    shift(): T | undefined;
+}

package/cjs/flow-restrictor.d.ts

@@ -0,0 +1,21 @@
+import type { IFlowableLock } from "./class";
+/**
+ * @internal
+ * @date 2020/6/18
+ */
+type TFlowableLockWithTimeStamp = IFlowableLock & {
+    last?: number;
+};
+/**
+ * @typedef {import("./index").IFlowableLock & { last?: number }} TFlowableLockWithTimeStamp
+ */
+/**
+ * Flow Restriction
+ */
+export declare const restrictor: {
+    getLockByKey: (key: PropertyKey) => Promise<TFlowableLockWithTimeStamp>;
+    cleanup: (timeSpan: number, debug?: true) => Promise<number>;
+    multi: <T>(key: PropertyKey, restriction: number, pb: () => Promise<T>) => Promise<T>;
+    one: <T>(key: PropertyKey, pb: () => Promise<T>) => Promise<T>;
+};
+export {};

package/cjs/index.d.ts

@@ -100,9 +100,15 @@ 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;
 };
 
 /**

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.4.2";
+exports.version = "v1.5.1";

package/cjs/object.d.ts

@@ -0,0 +1,86 @@
+/*!
+ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
+  Copyright (C) 2020 jeffy-g <hirotom1107@gmail.com>
+  Released under the MIT license
+  https://opensource.org/licenses/mit-license.php
+ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
+*/
+/**
+ * @file minimal implementation of semaphore (object implementation
+ * @author jeffy-g <hirotom1107@gmail.com>
+ * @version 1.0
+ */
+import * as core from "./core";
+import { Deque } from "./deque";
+export type * from "./core";
+/**
+ * object implementation of `IFlowableLock`
+ *
+ *   + constructs a semaphore object limited at `capacity`
+ *
+ * @param {number} capacity limitation of concurrent async by `capacity`
+ * @date 2020/2/7
+ * @version 1.0
+ */
+export declare const create: (capacity: number) => {
+    pending: number;
+    /**
+     *
+     * @param {boolean} [lazy]
+     * @returns {Promise<void>}
+     */
+    acquire(lazy?: boolean): Promise<void>;
+    release(): void;
+    /**
+     * @template {any} T
+     * @param {() => Promise<T>} process
+     * @param {boolean} [lazy]
+     * @returns {Promise<T>}
+     */
+    flow<T>(process: () => Promise<T>, lazy?: boolean): Promise<T>;
+    setRestriction(restriction: number): void;
+    limit: number;
+    capacity: number;
+    q: Deque<core.TVoidFunction>;
+};
+/**
+ * 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) => {
+    pending: number;
+    /**
+     * @returns {Promise<void>}
+     */
+    acquire(): Promise<void>;
+    release(): void;
+    /**
+     * @template {any} T
+     * @param {() => Promise<T>} process
+     * @returns {Promise<T>}
+     */
+    flow<T>(process: () => Promise<T>): Promise<T>;
+    /**
+     * @throws {AggregateError} description
+     */
+    abort(): void;
+    /**
+     * Registers an event listener for the "abort" event.
+     * @param {TAbortListener} listener
+     */
+    onAbort(listener: core.TAbortListener): void;
+    /**
+     * Removes an event listener for the "abort" event.
+     * @param {TAbortListener} listener
+     */
+    offAbort(listener: core.TAbortListener): void;
+    setRestriction(restriction: number): void;
+    limit: number;
+    capacity: number;
+    q: Deque<core.TResolver>;
+};

package/cjs/object.js

@@ -20,7 +20,17 @@ const r = core.release;
 const aa = core.acquireWithAbort;
 const ra = core.releaseWithAbort;
 /**
- * @template {core.IFlowableLock & { q: Deque<unknown>}} T
+ * @import {
+ *   TResolver,
+ *   TFlowableLock,
+ *   IFlowableLock,
+ *   TAbortListener,
+ *   IProcessAbortedError,
+ *   TFlowableLockWithAbort,
+ * } from "./index.mjs";
+ */
+/**
+ * @template {IFlowableLock & { q: Deque<unknown>}} T
  * @param {number} capacity
  * @returns
  */
@@ -47,9 +57,9 @@ const createBase = (capacity) => {
  * @version 1.0
  */
 const create = (capacity) => {
-    /** @type {core.TFlowableLock} */
+    /** @type {TFlowableLock} */
     const base = createBase(capacity);
-    return /** @satisfies {core.TFlowableLock} */ ({
+    return /** @satisfies {TFlowableLock} */ ({
         ...base,
         get pending() {
             return this.q.length;
@@ -93,9 +103,11 @@ exports.create = create;
  * @version 1.4
  */
 const createWithAbort = (capacity) => {
-    /** @type {core.TFlowableLockWithAbort} */
+    /** @type {TFlowableLockWithAbort} */
     const base = createBase(capacity);
-    return /** @satisfies {core.TFlowableLockWithAbort} */ ({
+    /** @type {TAbortListener[]} */
+    const abortListeners = [];
+    return /** @satisfies {TFlowableLockWithAbort} */ ({
         ...base,
         get pending() {
             return this.q.length;
@@ -115,27 +127,51 @@ const createWithAbort = (capacity) => {
          * @returns {Promise<T>}
          */
         async flow(process) {
-            await aa(this);
+            /** @type {T | undefined} */
+            let result;
             try {
-                return await process();
+                await aa(this);
+                result = await process();
+                ra(this);
             }
             finally {
-                ra(this);
+                return /** @type {T} */ (result);
             }
         },
         /**
          * @throws {AggregateError} description
          */
         abort() {
-            const dq = this.q;
-            let resolver;
+            /** @type {IProcessAbortedError} */
             const reason = {
                 message: "Process Aborted"
             };
+            abortListeners.forEach(listener => listener(reason));
+            const dq = this.q;
+            let resolver;
             while (resolver = dq.shift()) {
                 resolver.reject(reason);
             }
             this.capacity = this.limit;
+        },
+        /**
+         * Registers an event listener for the "abort" event.
+         * @param {TAbortListener} listener
+         */
+        onAbort(listener) {
+            if (!abortListeners.includes(listener)) {
+                abortListeners.push(listener);
+            }
+        },
+        /**
+         * Removes an event listener for the "abort" event.
+         * @param {TAbortListener} listener
+         */
+        offAbort(listener) {
+            const idx = abortListeners.findIndex(ls => listener === ls);
+            if (idx !== -1) {
+                /*return */ abortListeners.splice(idx, 1);
+            }
         }
     });
 };

package/esm/core.mjs

@@ -1,11 +1,14 @@
 /**
- * @typedef {import("./index.mjs").TVoidFunction} TVoidFunction
- * @typedef {import("./index.mjs").Deque<TVoidFunction>} Deque
- * @typedef {import("./index.mjs").TFlowableLockWithAbort} TFlowableLockWithAbort
- * @typedef {import("./index.mjs").Deque<TResolver>} DequeWithAbort
- * @typedef {import("./index.mjs").ISimplifiedLock} ISimplifiedLock
- * @typedef {import("./index.mjs").TFlowableLock} TFlowableLock
- * @typedef {import("./index.mjs").IFlowableLock} IFlowableLock
+ * @import {
+ *   TResolver,
+ *   TVoidFunction,
+ *   TFlowableLockWithAbort,
+ *   ISimplifiedLock,
+ *   TFlowableLock,
+ *   IFlowableLock,
+ *   Deque,
+ * } from "./index.mjs";
+ * @typedef {Deque<TResolver>} DequeWithAbort
  */
 /**
  * Throws an error indicating an inconsistent state in mini-semaphore.
@@ -47,7 +50,7 @@ export const acquire = (dis, lazy = true) => {
  * @returns {void}
  */
 export const release = (dis) => {
-    /** @type {Deque} */
+    /** @type {Deque<TVoidFunction>} */
     let dq;
     if ((dq = dis.q).length) {
         (dq.shift() || /* istanbul ignore next */ THROW)();
@@ -85,13 +88,9 @@ export const releaseWithAbort = (dis) => {
     let dq;
     if ((dq = dis.q).length) {
         const resolver = dq.shift();
+        resolver && resolver.resolve() || (
         /* istanbul ignore next */
-        if (!resolver) {
-            THROW();
-        }
-        else {
-            resolver.resolve();
-        }
+        THROW());
     }
     else {
         if (dis.capacity < dis.limit) {

package/esm/index.d.mts

@@ -100,9 +100,15 @@ 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;
 };
 
 /**

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.4.2";
+export const version = "v1.5.1";

package/esm/object.mjs

@@ -17,7 +17,17 @@ const r = core.release;
 const aa = core.acquireWithAbort;
 const ra = core.releaseWithAbort;
 /**
- * @template {core.IFlowableLock & { q: Deque<unknown>}} T
+ * @import {
+ *   TResolver,
+ *   TFlowableLock,
+ *   IFlowableLock,
+ *   TAbortListener,
+ *   IProcessAbortedError,
+ *   TFlowableLockWithAbort,
+ * } from "./index.mjs";
+ */
+/**
+ * @template {IFlowableLock & { q: Deque<unknown>}} T
  * @param {number} capacity
  * @returns
  */
@@ -44,9 +54,9 @@ const createBase = (capacity) => {
  * @version 1.0
  */
 export const create = (capacity) => {
-    /** @type {core.TFlowableLock} */
+    /** @type {TFlowableLock} */
     const base = createBase(capacity);
-    return /** @satisfies {core.TFlowableLock} */ ({
+    return /** @satisfies {TFlowableLock} */ ({
         ...base,
         get pending() {
             return this.q.length;
@@ -89,9 +99,11 @@ export const create = (capacity) => {
  * @version 1.4
  */
 export const createWithAbort = (capacity) => {
-    /** @type {core.TFlowableLockWithAbort} */
+    /** @type {TFlowableLockWithAbort} */
     const base = createBase(capacity);
-    return /** @satisfies {core.TFlowableLockWithAbort} */ ({
+    /** @type {TAbortListener[]} */
+    const abortListeners = [];
+    return /** @satisfies {TFlowableLockWithAbort} */ ({
         ...base,
         get pending() {
             return this.q.length;
@@ -111,27 +123,51 @@ export const createWithAbort = (capacity) => {
          * @returns {Promise<T>}
          */
         async flow(process) {
-            await aa(this);
+            /** @type {T | undefined} */
+            let result;
             try {
-                return await process();
+                await aa(this);
+                result = await process();
+                ra(this);
             }
             finally {
-                ra(this);
+                return /** @type {T} */ (result);
             }
         },
         /**
          * @throws {AggregateError} description
          */
         abort() {
-            const dq = this.q;
-            let resolver;
+            /** @type {IProcessAbortedError} */
             const reason = {
                 message: "Process Aborted"
             };
+            abortListeners.forEach(listener => listener(reason));
+            const dq = this.q;
+            let resolver;
             while (resolver = dq.shift()) {
                 resolver.reject(reason);
             }
             this.capacity = this.limit;
+        },
+        /**
+         * Registers an event listener for the "abort" event.
+         * @param {TAbortListener} listener
+         */
+        onAbort(listener) {
+            if (!abortListeners.includes(listener)) {
+                abortListeners.push(listener);
+            }
+        },
+        /**
+         * Removes an event listener for the "abort" event.
+         * @param {TAbortListener} listener
+         */
+        offAbort(listener) {
+            const idx = abortListeners.findIndex(ls => listener === ls);
+            if (idx !== -1) {
+                /*return */ abortListeners.splice(idx, 1);
+            }
         }
     });
 };

package/index.d.ts

@@ -100,9 +100,15 @@ 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;
 };
 
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mini-semaphore",
-  "version": "1.4.2",
+  "version": "1.5.1",
   "description": "A lightweight version of Semaphore",
   "private": false,
   "main": "./cjs/index.js",
@@ -8,6 +8,43 @@
   "unpkg": "./umd/index.js",
   "sideEffects": false,
   "types": "./index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./index.d.ts",
+      "import": "./esm/index.mjs",
+      "require": "./cjs/index.js"
+    },
+    "./class": {
+      "import": "./esm/class.mjs",
+      "require": "./cjs/class.js"
+    },
+    "./object": {
+      "import": "./esm/object.mjs",
+      "require": "./cjs/object.js"
+    },
+    "./deque": {
+      "import": "./esm/deque.mjs",
+      "require": "./cjs/deque.js"
+    },
+    "./flow-restrictor": {
+      "import": "./esm/flow-restrictor.mjs",
+      "require": "./cjs/flow-restrictor.js"
+    },
+    "./umd": {
+      "import": "./umd/index.js",
+      "require": "./umd/index.js",
+      "types": "./umd/index.d.ts"
+    },
+    "./webpack": {
+      "import": "./webpack/index.js",
+      "require": "./webpack/index.js",
+      "types": "./webpack/index.d.ts"
+    },
+    "./webpack-esm": {
+      "import": "./webpack-esm/index.mjs",
+      "types": "./webpack-esm/index.d.mts"
+    }
+  },
   "author": "jeffy-g",
   "license": "MIT",
   "bugs": {

package/umd/index.d.ts

@@ -100,9 +100,15 @@ 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;
 };
 
 /**

package/umd/index.js

@@ -1,7 +1,8 @@
 /*! 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={139:(e,t,i)=>{Object.defineProperty(t,"__esModule",{value:!0}),t.createWithAbort=t.create=void 0;const r=i(461),n=i(761),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=>({...l(e),get pending(){return this.q.length},acquire(){return o(this)},release(){
-c(this)},async flow(e){await o(this);try{return await e()}finally{c(this)}},abort(){const e=this.q;let t;const i={message:"Process Aborted"};for(;t=e.shift();)t.reject(i);this.capacity=this.limit}})},461:(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++}},464:(e,t,i)=>{Object.defineProperty(t,"__esModule",{value:!0}),t.restrictor=void 0;const r=i(518);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)}}})()},518:(e,t,i)=>{Object.defineProperty(t,"__esModule",{value:!0}),t.MiniSemaphore=void 0;const r=i(461),n=i(761),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)}}}},761:(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)}}}},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(518);Object.defineProperty(e,"MiniSemaphore",{enumerable:!0,get:function(){return t.MiniSemaphore}});var n=i(139);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(761);Object.defineProperty(e,"Deque",{enumerable:!0,get:function(){return s.Deque}});var a=i(464);Object.defineProperty(e,"restrictor",{enumerable:!0,get:function(){return a.restrictor}}),e.version="v1.4.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,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)}}},(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("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.1"})(),r})());

package/webpack/index.d.ts

@@ -100,9 +100,15 @@ 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;
 };
 
 /**

package/webpack/index.js

@@ -1,7 +1,7 @@
 /*! For license information please see index.js.LICENSE.txt */
-(()=>{"use strict";var e={139:(e,t,i)=>{Object.defineProperty(t,"__esModule",{value:!0}),t.createWithAbort=t.create=void 0;const r=i(461),n=i(761),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=>({...l(e),get pending(){return this.q.length},acquire(){return c(this)},release(){o(this)},async flow(e){await c(this);try{return await e()}finally{o(this)}},abort(){const e=this.q;let t;const i={message:"Process Aborted"};for(;t=e.shift();)t.reject(i);this.capacity=this.limit}})},461:(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++}},464:(e,t,i)=>{
-Object.defineProperty(t,"__esModule",{value:!0}),t.restrictor=void 0;const r=i(518);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)}}})()},518:(e,t,i)=>{Object.defineProperty(t,"__esModule",{value:!0}),t.MiniSemaphore=void 0;const r=i(461),n=i(761),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)}}}},761:(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)}}}},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(518);Object.defineProperty(e,"MiniSemaphore",{enumerable:!0,get:function(){return t.MiniSemaphore}});var n=i(139);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(761);Object.defineProperty(e,"Deque",{enumerable:!0,get:function(){return s.Deque}});var a=i(464);Object.defineProperty(e,"restrictor",{enumerable:!0,get:function(){return a.restrictor}}),e.version="v1.4.2"})(),module.exports=r})();
+(()=>{"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,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)}}}},(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)}}},(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),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)}}})()},(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++}}],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(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.1"})(),module.exports=r})();

package/webpack-esm/index.d.mts

@@ -100,9 +100,15 @@ 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;
 };
 
 /**

package/webpack-esm/index.mjs

@@ -1,7 +1,8 @@
 /*! For license information please see index.js.LICENSE.txt */
-var e={139:(e,t,i)=>{Object.defineProperty(t,"__esModule",{value:!0}),t.createWithAbort=t.create=void 0;const r=i(461),s=i(761),n=r.acquire,a=r.release,c=r.acquireWithAbort,o=r.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=>({...l(e),get pending(){return this.q.length},acquire(){return c(this)},release(){o(this)},async flow(e){await c(this);try{return await e()}finally{o(this)}},abort(){const e=this.q;let t;const i={message:"Process Aborted"};for(;t=e.shift();)t.reject(i);this.capacity=this.limit}})},461:(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++}},464:(e,t,i)=>{
-Object.defineProperty(t,"__esModule",{value:!0}),t.restrictor=void 0;const r=i(518);t.restrictor=(()=>{const{MiniSemaphore:e}=r,t=new e(1);let i=Object.create(null);async function s(r,s,n){const a=await(async(r,s)=>{await t.acquire(!1);let n=i[r];if(n||(i[r]=n=new e(s)),n.limit!==s)throw t.release(),new ReferenceError(`Cannot get object with different restriction: key: '${String(r)}', lock.limit: ${n.limit} <-> restriction: ${s},`);return t.release(),n})(r,s),c=a.flow(n);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 s=i,n=Object.create(null),a=Object.keys(s);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=s[i];l.last&&Date.now()-l.last>=e?(o++,
-r&&c.push(i)):n[i]=l}return i=n,t.release(),r&&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)}}})()},518:(e,t,i)=>{Object.defineProperty(t,"__esModule",{value:!0}),t.MiniSemaphore=void 0;const r=i(461),s=i(761),n=r.acquire,a=r.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)}}}},761:(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 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,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,s)=>{for(let n=0;n<s;++n)i[n+r]=e[n+t],e[n+t]=void 0})(e._a,0,e._a,i,t)}}}},t={};function i(r){var s=t[r];if(void 0!==s)return s.exports;var n=t[r]={exports:{}};return e[r](n,n.exports,i),n.exports}var r={};(()=>{var e=r;Object.defineProperty(e,"BJ",{value:!0}),e.rE=e.Ws=e.Jj=e.Xz=e.vt=e.C=void 0
-;var t=i(518);Object.defineProperty(e,"C",{enumerable:!0,get:function(){return t.MiniSemaphore}});var s=i(139);Object.defineProperty(e,"vt",{enumerable:!0,get:function(){return s.create}}),Object.defineProperty(e,"Xz",{enumerable:!0,get:function(){return s.createWithAbort}});var n=i(761);Object.defineProperty(e,"Jj",{enumerable:!0,get:function(){return n.Deque}});var a=i(464);Object.defineProperty(e,"Ws",{enumerable:!0,get:function(){return a.restrictor}}),e.rE="v1.4.2"})();const s=r.Jj,n=r.C,a=r.BJ,c=r.vt,o=r.Xz,l=r.Ws,h=r.rE;export{s as Deque,n as MiniSemaphore,a as __esModule,c as create,o as createWithAbort,l as restrictor,h as version};
+var e=[,,(e,t,r)=>{Object.defineProperty(t,"__esModule",{value:!0}),t.MiniSemaphore=void 0;const i=r(6),s=r(4),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)}}}},(e,t,r)=>{Object.defineProperty(t,"__esModule",{value:!0}),t.createWithAbort=t.create=void 0;const i=r(6),s=r(4),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)}}}},(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)}}},(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 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)}}})()},(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++}}],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(2);Object.defineProperty(e,"MiniSemaphore",{enumerable:!0,get:function(){return t.MiniSemaphore}});var s=r(3);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(4);Object.defineProperty(e,"Deque",{enumerable:!0,get:function(){return n.Deque}});var a=r(5);Object.defineProperty(e,"restrictor",{enumerable:!0,get:function(){return a.restrictor}}),e.version="v1.5.1"})()
+;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};