@nmtjs/common 0.16.1 → 0.17.0-beta.2

package/LICENSE.md

@@ -4,4 +4,4 @@ Permission is hereby granted, free of charge, to any person obtaining a copy of
 
 The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
 
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -1,9 +1,49 @@
 # NeemataJS - RPC application server for real-time applications (proof of concept)
 
 ### Built with following in mind:
+
 - transport-agnostic (like WebSockets, WebTransport, .etc)
 - format-agnostic (like JSON, MessagePack, BSON, .etc)
 - binary data streaming and event subscriptions
 - contract-based API
 - end-to-end type safety
-- CPU-intensive task execution on separate workers
+- CPU-intensive task execution on separate workers
+
+## Neem CLI draft
+
+`neem build` compiles config, app entries, plugin entries, and plugin-declared
+artifacts into `dist` by default. It writes an internal `neem.manifest.json`
+with relative artifact paths.
+
+`neem start` consumes an existing built output directory. It reads the manifest
+for executable artifacts and serialized runtime config, registers built plugin
+hooks, and starts app workers in production mode.
+
+`neem dev` uses `.neem` by default as a build-like watched output directory. It
+uses the same manifest shape as `start`, restarts app workers after successful
+config/app rebuilds, reloads plugin hooks after plugin entry rebuilds, and keeps
+existing workers alive on rebuild errors.
+
+## Service integration tests
+
+Service-backed package integration tests live beside package owners under
+`packages/*/tests/integration`.
+
+Local services:
+
+```sh
+docker compose up -d --wait redis valkey kafka
+```
+
+Run required service tests:
+
+```sh
+NMTJS_REQUIRE_SERVICE_TESTS=1 \
+REDIS_URL=redis://localhost:6379 \
+VALKEY_URL=redis://localhost:6380 \
+KAFKA_BROKERS=localhost:9092 \
+pnpm run test:integration:services
+```
+
+Without service env, these tests skip in normal package/root test runs. In CI,
+`NMTJS_REQUIRE_SERVICE_TESTS=1` makes missing service env fail instead of skip.

package/dist/abort-signal.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Little helper to combine multiple AbortSignals into one,
+ * with handling of null or undefined values.
+ */
+export declare function anyAbortSignal(...signals: (globalThis.AbortSignal | undefined | null)[]): globalThis.AbortSignal;

package/dist/{abortSignal.js → abort-signal.js}

@@ -1,4 +1,3 @@
-/// <reference lib="dom" />
 /**
  * Little helper to combine multiple AbortSignals into one,
  * with handling of null or undefined values.
@@ -12,7 +11,7 @@ export function anyAbortSignal(...signals) {
         return filtered[0];
     }
     else {
-        return AbortSignal.any(filtered);
+        return globalThis.AbortSignal.any(filtered);
     }
 }
-//# sourceMappingURL=abortSignal.js.map
+//# sourceMappingURL=abort-signal.js.map

package/dist/abort-signal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"abort-signal.js","sourceRoot":"","sources":["../src/abort-signal.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,UAAU,cAAc,CAC5B,GAAG,OAAsD;IAEzD,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,OAAO,CAA6B,CAAA;IACpE,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAA;IAC7C,CAAC;SAAM,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjC,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAA;IACpB,CAAC;SAAM,CAAC;QACN,OAAO,UAAU,CAAC,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;IAC7C,CAAC;AACH,CAAC"}

package/dist/error.d.ts

@@ -0,0 +1,13 @@
+export type SerializedError = {
+    readonly name?: string;
+    readonly message: string;
+    readonly stack?: string;
+    readonly cause?: SerializedError;
+};
+export declare const MAX_SERIALIZED_ERROR_DEPTH = 5;
+export type SerializeErrorOptions = {
+    depth?: number;
+    omitUndefinedStack?: boolean;
+    fallback?: (value: unknown) => SerializedError;
+};
+export declare function serializeError(value: unknown, options?: SerializeErrorOptions): SerializedError;

package/dist/error.js

@@ -0,0 +1,20 @@
+// Depth-limited so a cyclic cause chain cannot recurse forever.
+export const MAX_SERIALIZED_ERROR_DEPTH = 5;
+export function serializeError(value, options = {}) {
+    const { depth = MAX_SERIALIZED_ERROR_DEPTH, omitUndefinedStack = false, fallback, } = options;
+    if (value instanceof Error) {
+        const cause = value.cause;
+        return {
+            name: value.name,
+            message: value.message,
+            ...(omitUndefinedStack && value.stack === undefined
+                ? {}
+                : { stack: value.stack }),
+            ...(cause === undefined || depth <= 0
+                ? {}
+                : { cause: serializeError(cause, { ...options, depth: depth - 1 }) }),
+        };
+    }
+    return fallback ? fallback(value) : { message: String(value) };
+}
+//# sourceMappingURL=error.js.map

package/dist/error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.js","sourceRoot":"","sources":["../src/error.ts"],"names":[],"mappings":"AAOA,gEAAgE;AAChE,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAA;AAU3C,MAAM,UAAU,cAAc,CAC5B,KAAc,EACd,OAAO,GAA0B,EAAE;IAEnC,MAAM,EACJ,KAAK,GAAG,0BAA0B,EAClC,kBAAkB,GAAG,KAAK,EAC1B,QAAQ,GACT,GAAG,OAAO,CAAA;IAEX,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,MAAM,KAAK,GAAI,KAA8C,CAAC,KAAK,CAAA;QACnE,OAAO;YACL,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,GAAG,CAAC,kBAAkB,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS;gBACjD,CAAC,CAAC,EAAE;gBACJ,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC;YAC3B,GAAG,CAAC,KAAK,KAAK,SAAS,IAAI,KAAK,IAAI,CAAC;gBACnC,CAAC,CAAC,EAAE;gBACJ,CAAC,CAAC,EAAE,KAAK,EAAE,cAAc,CAAC,KAAK,EAAE,EAAE,GAAG,OAAO,EAAE,KAAK,EAAE,KAAK,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;SACxE,CAAA;IACH,CAAC;IAED,OAAO,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAA;AAChE,CAAC"}

package/dist/index.d.ts

@@ -1,5 +1,9 @@
-export * from './abortSignal.ts';
+export * from './abort-signal.ts';
 export * from './constants.ts';
+export * from './error.ts';
+export * from './operation-queue.ts';
+export * from './pool.ts';
+export * from './semaphore.ts';
 export * from './streams.ts';
 export * from './types.ts';
 export * from './utils.ts';

package/dist/index.js

@@ -1,5 +1,9 @@
-export * from './abortSignal.js';
+export * from './abort-signal.js';
 export * from './constants.js';
+export * from './error.js';
+export * from './operation-queue.js';
+export * from './pool.js';
+export * from './semaphore.js';
 export * from './streams.js';
 export * from './types.js';
 export * from './utils.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAA;AAChC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,cAAc,CAAA;AAC5B,cAAc,YAAY,CAAA;AAC1B,cAAc,YAAY,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAA;AACjC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,YAAY,CAAA;AAC1B,cAAc,sBAAsB,CAAA;AACpC,cAAc,WAAW,CAAA;AACzB,cAAc,gBAAgB,CAAA;AAC9B,cAAc,cAAc,CAAA;AAC5B,cAAc,YAAY,CAAA;AAC1B,cAAc,YAAY,CAAA"}

package/dist/operation-queue.d.ts

@@ -0,0 +1,26 @@
+import type { MaybePromise } from './types.ts';
+export type OperationQueueStrategy = 'serial' | 'latest';
+export type OperationQueueOptions = {
+    strategy?: OperationQueueStrategy;
+};
+export declare class OperationSupersededError extends Error {
+    constructor(message?: string);
+}
+export declare class OperationQueue {
+    private readonly strategy;
+    private tail;
+    private count;
+    private runningLatest;
+    private latestOperation;
+    private readonly idleWaiters;
+    constructor({ strategy }?: OperationQueueOptions);
+    get pending(): number;
+    get busy(): boolean;
+    run<T>(task: () => MaybePromise<T>): Promise<T>;
+    waitIdle(): Promise<void>;
+    private runSerial;
+    private runLatest;
+    private runLatestOperations;
+    private runLatestOperation;
+    private finishOperation;
+}

package/dist/operation-queue.js

@@ -0,0 +1,102 @@
+import { createFuture } from './utils.js';
+export class OperationSupersededError extends Error {
+    constructor(message = 'Operation superseded') {
+        super(message);
+        this.name = 'OperationSupersededError';
+    }
+}
+export class OperationQueue {
+    strategy;
+    tail = Promise.resolve();
+    count = 0;
+    runningLatest = false;
+    latestOperation;
+    idleWaiters = new Set();
+    constructor({ strategy = 'serial' } = {}) {
+        this.strategy = strategy;
+    }
+    get pending() {
+        return this.count;
+    }
+    get busy() {
+        return this.count > 0;
+    }
+    run(task) {
+        return this.strategy === 'latest'
+            ? this.runLatest(task)
+            : this.runSerial(task);
+    }
+    async waitIdle() {
+        if (!this.busy)
+            return;
+        await new Promise((resolve) => {
+            this.idleWaiters.add(resolve);
+        });
+    }
+    runSerial(task) {
+        this.count++;
+        const result = this.tail.then(task, task);
+        this.tail = result
+            .catch(() => undefined)
+            .finally(() => {
+            this.finishOperation();
+        });
+        return result;
+    }
+    runLatest(task) {
+        this.count++;
+        const { operation, promise } = createQueuedOperation(task);
+        if (this.runningLatest) {
+            const previous = this.latestOperation;
+            if (previous) {
+                previous.reject(new OperationSupersededError());
+                this.finishOperation();
+            }
+            this.latestOperation = operation;
+            return promise;
+        }
+        this.runningLatest = true;
+        void this.runLatestOperations(operation);
+        return promise;
+    }
+    async runLatestOperations(operation) {
+        let current = operation;
+        while (current) {
+            await this.runLatestOperation(current);
+            current = this.latestOperation;
+            this.latestOperation = undefined;
+        }
+        this.runningLatest = false;
+    }
+    async runLatestOperation(operation) {
+        try {
+            operation.resolve(await operation.task());
+        }
+        catch (error) {
+            operation.reject(error);
+        }
+        finally {
+            this.finishOperation();
+        }
+    }
+    finishOperation() {
+        this.count--;
+        if (this.count > 0)
+            return;
+        for (const resolve of this.idleWaiters)
+            resolve();
+        this.idleWaiters.clear();
+    }
+}
+function createQueuedOperation(task) {
+    const future = createFuture();
+    return {
+        operation: {
+            task: task,
+            resolve: future.resolve,
+            reject: future.reject,
+        },
+        promise: future.promise,
+    };
+}
+//# sourceMappingURL=operation-queue.js.map

package/dist/operation-queue.js.map

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

package/dist/pool.d.ts

@@ -0,0 +1,18 @@
+interface PoolOptions {
+    timeout?: number;
+}
+export declare class PoolError extends Error {
+}
+export declare class Pool<T = unknown> {
+    #private;
+    private readonly options;
+    constructor(options?: PoolOptions);
+    add(item: T): void;
+    remove(item: T): void;
+    capture(timeout?: number | undefined): Promise<T>;
+    next(exclusive?: boolean, timeout?: number | undefined): Promise<T>;
+    release(item: T): undefined;
+    isFree(item: T): boolean;
+    get items(): T[];
+}
+export {};

package/dist/pool.js

@@ -0,0 +1,106 @@
+export class PoolError extends Error {
+}
+// Ported from https://github.com/metarhia/metautil
+export class Pool {
+    options;
+    #items = [];
+    #free = [];
+    #queue = [];
+    #current = 0;
+    #size = 0;
+    #available = 0;
+    constructor(options = {}) {
+        this.options = options;
+    }
+    add(item) {
+        if (this.#items.includes(item))
+            throw new PoolError('Item already exists');
+        this.#size++;
+        this.#available++;
+        this.#items.push(item);
+        this.#free.push(true);
+    }
+    remove(item) {
+        if (this.#size === 0)
+            throw new PoolError('Pool is empty');
+        const index = this.#items.indexOf(item);
+        if (index < 0)
+            throw new PoolError('Item is not in the pool');
+        const isCaptured = this.isFree(item);
+        if (isCaptured)
+            this.#available--;
+        this.#size--;
+        this.#current--;
+        this.#items.splice(index, 1);
+        this.#free.splice(index, 1);
+    }
+    capture(timeout = this.options.timeout) {
+        return this.next(true, timeout);
+    }
+    async next(exclusive = false, timeout = this.options.timeout) {
+        if (this.#size === 0)
+            throw new PoolError('Pool is empty');
+        if (this.#available === 0) {
+            return new Promise((resolve, reject) => {
+                const waiting = {
+                    resolve: (item) => {
+                        if (exclusive)
+                            this.#capture(item);
+                        resolve(item);
+                    },
+                    timer: undefined,
+                };
+                if (timeout) {
+                    waiting.timer = setTimeout(() => {
+                        waiting.resolve = undefined;
+                        this.#queue.shift();
+                        reject(new PoolError('Next item timeout'));
+                    }, timeout);
+                }
+                this.#queue.push(waiting);
+            });
+        }
+        let item;
+        let free = false;
+        do {
+            item = this.#items[this.#current];
+            free = this.#free[this.#current];
+            this.#current++;
+            if (this.#current >= this.#size)
+                this.#current = 0;
+        } while (typeof item === 'undefined' || !free);
+        if (exclusive)
+            this.#capture(item);
+        return item;
+    }
+    release(item) {
+        const index = this.#items.indexOf(item);
+        if (index < 0)
+            throw new PoolError('Unexpected item');
+        if (this.#free[index])
+            throw new PoolError('Unable to release not captured item');
+        if (this.#queue.length > 0) {
+            const { resolve, timer } = this.#queue.shift();
+            clearTimeout(timer);
+            if (resolve)
+                return void setTimeout(resolve, 0, item);
+        }
+        this.#free[index] = true;
+        this.#available++;
+    }
+    isFree(item) {
+        const index = this.#items.indexOf(item);
+        if (index < 0)
+            return false;
+        return this.#free[index];
+    }
+    get items() {
+        return [...this.#items];
+    }
+    #capture(item) {
+        const index = this.#items.indexOf(item);
+        this.#free[index] = false;
+        this.#available--;
+    }
+}
+//# sourceMappingURL=pool.js.map

package/dist/pool.js.map

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

package/dist/semaphore.d.ts

@@ -0,0 +1,13 @@
+export declare class SemaphoreError extends Error {
+}
+export declare class Semaphore {
+    private readonly size;
+    private readonly timeout;
+    private counter;
+    private readonly queue;
+    constructor(concurrency: number, size?: number, timeout?: number);
+    enter(): Promise<void>;
+    leave(): void;
+    get isEmpty(): boolean;
+    get queueLength(): number;
+}

package/dist/semaphore.js

@@ -0,0 +1,56 @@
+export class SemaphoreError extends Error {
+}
+// Ported from https://github.com/metarhia/metautil
+export class Semaphore {
+    size;
+    timeout;
+    counter;
+    queue = [];
+    constructor(concurrency, size = 0, timeout = 0) {
+        this.size = size;
+        this.timeout = timeout;
+        this.counter = concurrency;
+    }
+    enter() {
+        if (this.counter > 0) {
+            this.counter--;
+            return Promise.resolve();
+        }
+        else if (this.queue.length >= this.size) {
+            return Promise.reject(new SemaphoreError('Queue is full'));
+        }
+        else {
+            return new Promise((resolve, reject) => {
+                const waiting = { resolve };
+                waiting.timer = setTimeout(() => {
+                    waiting.resolve = undefined;
+                    this.queue.shift();
+                    reject(new SemaphoreError('Timeout'));
+                }, this.timeout);
+                this.queue.push(waiting);
+            });
+        }
+    }
+    leave() {
+        if (this.queue.length === 0) {
+            this.counter++;
+        }
+        else {
+            const item = this.queue.shift();
+            if (item) {
+                const { resolve, timer } = item;
+                if (timer)
+                    clearTimeout(timer);
+                if (resolve)
+                    setTimeout(resolve, 0);
+            }
+        }
+    }
+    get isEmpty() {
+        return this.queue.length === 0;
+    }
+    get queueLength() {
+        return this.queue.length;
+    }
+}
+//# sourceMappingURL=semaphore.js.map

package/dist/semaphore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"semaphore.js","sourceRoot":"","sources":["../src/semaphore.ts"],"names":[],"mappings":"AAOA,MAAM,OAAO,cAAe,SAAQ,KAAK;CAAG;AAE5C,mDAAmD;AACnD,MAAM,OAAO,SAAS;IAOD,IAAI;IACJ,OAAO;IAPlB,OAAO,CAAQ;IAEN,KAAK,GAAyB,EAAE,CAAA;IAEjD,YACE,WAAmB,EACF,IAAI,GAAW,CAAC,EAChB,OAAO,GAAW,CAAC;oBADnB,IAAI;uBACJ,OAAO;QAExB,IAAI,CAAC,OAAO,GAAG,WAAW,CAAA;IAC5B,CAAC;IAED,KAAK;QACH,IAAI,IAAI,CAAC,OAAO,GAAG,CAAC,EAAE,CAAC;YACrB,IAAI,CAAC,OAAO,EAAE,CAAA;YACd,OAAO,OAAO,CAAC,OAAO,EAAE,CAAA;QAC1B,CAAC;aAAM,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YAC1C,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,cAAc,CAAC,eAAe,CAAC,CAAC,CAAA;QAC5D,CAAC;aAAM,CAAC;YACN,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;gBACrC,MAAM,OAAO,GAAuB,EAAE,OAAO,EAAE,CAAA;gBAC/C,OAAO,CAAC,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;oBAC9B,OAAO,CAAC,OAAO,GAAG,SAAS,CAAA;oBAC3B,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAA;oBAClB,MAAM,CAAC,IAAI,cAAc,CAAC,SAAS,CAAC,CAAC,CAAA;gBACvC,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,CAAA;gBAChB,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;YAC1B,CAAC,CAAC,CAAA;QACJ,CAAC;IACH,CAAC;IAED,KAAK;QACH,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC5B,IAAI,CAAC,OAAO,EAAE,CAAA;QAChB,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAA;YAC/B,IAAI,IAAI,EAAE,CAAC;gBACT,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,IAAI,CAAA;gBAC/B,IAAI,KAAK;oBAAE,YAAY,CAAC,KAAK,CAAC,CAAA;gBAC9B,IAAI,OAAO;oBAAE,UAAU,CAAC,OAAO,EAAE,CAAC,CAAC,CAAA;YACrC,CAAC;QACH,CAAC;IACH,CAAC;IAED,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,CAAA;IAChC,CAAC;IAED,IAAI,WAAW;QACb,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAA;IAC1B,CAAC;CACF"}

package/dist/streams.d.ts

@@ -1,15 +1,15 @@
 import type { MaybePromise } from './types.ts';
 export interface DuplexStreamOptions<O = unknown, I = O> {
-    start?: (controller: ReadableStreamDefaultController<O>) => void;
-    pull?: (controller: ReadableStreamDefaultController<O>) => MaybePromise<void>;
+    start?: (controller: globalThis.ReadableStreamDefaultController<O>) => void;
+    pull?: (controller: globalThis.ReadableStreamDefaultController<O>) => MaybePromise<void>;
     cancel?: (reason: unknown) => void;
     transform?: (chunk: I) => O;
     close?: () => void;
-    readableStrategy?: QueuingStrategy<O>;
-    writableStrategy?: QueuingStrategy<I>;
+    readableStrategy?: globalThis.QueuingStrategy<O>;
+    writableStrategy?: globalThis.QueuingStrategy<I>;
 }
 export declare class DuplexStream<O = unknown, I = O> {
-    readonly readable: ReadableStream<O>;
-    readonly writable: WritableStream<I>;
+    readonly readable: globalThis.ReadableStream<O>;
+    readonly writable: globalThis.WritableStream<I>;
     constructor(options?: DuplexStreamOptions<O, I>);
 }

package/dist/streams.js

@@ -3,11 +3,11 @@ export class DuplexStream {
     readable;
     writable;
     constructor(options = {}) {
-        this.readable = new ReadableStream({
+        this.readable = new globalThis.ReadableStream({
             cancel: options.cancel,
             start: (controller) => {
                 // @ts-expect-error
-                this.writable = new WritableStream({
+                this.writable = new globalThis.WritableStream({
                     write: (_chunk) => {
                         const chunk = options?.transform
                             ? options?.transform(_chunk)

package/dist/streams.js.map

@@ -1 +1 @@
-{"version":3,"file":"streams.js","sourceRoot":"","sources":["../src/streams.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAc1D,MAAM,OAAO,YAAY;IACd,QAAQ,CAAmB;IAC3B,QAAQ,CAAoB;IAErC,YAAY,OAAO,GAA8B,EAAE;QACjD,IAAI,CAAC,QAAQ,GAAG,IAAI,cAAc,CAChC;YACE,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,KAAK,EAAE,CAAC,UAAU,EAAE,EAAE;gBACpB,mBAAmB;gBACnB,IAAI,CAAC,QAAQ,GAAG,IAAI,cAAc,CAChC;oBACE,KAAK,EAAE,CAAC,MAAM,EAAE,EAAE;wBAChB,MAAM,KAAK,GAAG,OAAO,EAAE,SAAS;4BAC9B,CAAC,CAAC,OAAO,EAAE,SAAS,CAAC,MAAM,CAAC;4BAC5B,CAAC,CAAC,MAAM,CAAA;wBACV,UAAU,CAAC,OAAO,CAAC,KAAU,CAAC,CAAA;oBAChC,CAAC;oBACD,KAAK,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC;oBAC3C,KAAK,EAAE,GAAG,EAAE;wBACV,OAAO,EAAE,KAAK,EAAE,EAAE,CAAA;wBAClB,IAAI,CAAC;4BACH,UAAU,CAAC,KAAK,EAAE,CAAA;wBACpB,CAAC;wBAAC,MAAM,CAAC;4BACP,sDAAsD;wBACxD,CAAC;oBACH,CAAC;iBACF,EACD,OAAO,CAAC,gBAAgB,CACzB,CAAA;gBACD,OAAO,CAAC,KAAK,EAAE,CAAC,UAAU,CAAC,CAAA;YAC7B,CAAC;YACD,IAAI,EAAE,OAAO,EAAE,IAAI;SACpB,EACD,OAAO,CAAC,gBAAgB,CACzB,CAAA;IACH,CAAC;CACF"}
+{"version":3,"file":"streams.js","sourceRoot":"","sources":["../src/streams.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAgB1D,MAAM,OAAO,YAAY;IACd,QAAQ,CAA8B;IACtC,QAAQ,CAA+B;IAEhD,YAAY,OAAO,GAA8B,EAAE;QACjD,IAAI,CAAC,QAAQ,GAAG,IAAI,UAAU,CAAC,cAAc,CAC3C;YACE,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,KAAK,EAAE,CAAC,UAAU,EAAE,EAAE;gBACpB,mBAAmB;gBACnB,IAAI,CAAC,QAAQ,GAAG,IAAI,UAAU,CAAC,cAAc,CAC3C;oBACE,KAAK,EAAE,CAAC,MAAM,EAAE,EAAE;wBAChB,MAAM,KAAK,GAAG,OAAO,EAAE,SAAS;4BAC9B,CAAC,CAAC,OAAO,EAAE,SAAS,CAAC,MAAM,CAAC;4BAC5B,CAAC,CAAC,MAAM,CAAA;wBACV,UAAU,CAAC,OAAO,CAAC,KAAU,CAAC,CAAA;oBAChC,CAAC;oBACD,KAAK,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC;oBAC3C,KAAK,EAAE,GAAG,EAAE;wBACV,OAAO,EAAE,KAAK,EAAE,EAAE,CAAA;wBAClB,IAAI,CAAC;4BACH,UAAU,CAAC,KAAK,EAAE,CAAA;wBACpB,CAAC;wBAAC,MAAM,CAAC;4BACP,sDAAsD;wBACxD,CAAC;oBACH,CAAC;iBACF,EACD,OAAO,CAAC,gBAAgB,CACzB,CAAA;gBACD,OAAO,CAAC,KAAK,EAAE,CAAC,UAAU,CAAC,CAAA;YAC7B,CAAC;YACD,IAAI,EAAE,OAAO,EAAE,IAAI;SACpB,EACD,OAAO,CAAC,gBAAgB,CACzB,CAAA;IACH,CAAC;CACF"}

package/dist/types.d.ts

@@ -1,6 +1,7 @@
 declare const TSErrorSymbol: unique symbol;
 export type TSError<ErrorMessage extends string = string, TagType = never> = `TS Error: ${ErrorMessage}` & {
     [TSErrorSymbol]: true;
+    readonly __tag?: TagType;
 };
 export interface TypeProvider {
     readonly input: unknown;

package/dist/utils.d.ts

@@ -11,25 +11,18 @@ export declare function range(count: number, start?: number): {
         };
     };
 };
-export declare function debounce(cb: Callback, delay: number): ((...args: any[]) => void) & {
-    clear: () => any;
-};
-export interface Future<T = any> {
-    promise: Promise<T>;
-    resolve: (value: T) => void;
-    reject: (error: any) => void;
-}
+export type Future<T = any> = PromiseWithResolvers<T>;
 export declare function createFuture<T>(): Future<T>;
-export declare function onAbort<T extends Callback>(signal: AbortSignal, cb: T, reason?: any): () => void;
+export declare function onAbort<T extends Callback>(signal: globalThis.AbortSignal, cb: T, reason?: any): () => void;
 export declare function withTimeout(value: Promise<any>, timeout: number, timeoutError: Error): Promise<any>;
 export declare function tryCaptureStackTrace(depth?: number): string | undefined;
 export declare function isGeneratorFunction(value: any): value is GeneratorFunction;
 export declare function isAsyncGeneratorFunction(value: any): value is AsyncGeneratorFunction;
 export declare function isAsyncIterable(value: any): value is AsyncIterable<unknown>;
 export declare function throwError(message: string, ErrorClass?: ErrorConstructor): never;
-export declare function once(target: EventTarget, event: string): Promise<void>;
-export declare function onceAborted(signal: AbortSignal): Promise<void>;
-export declare function isAbortError(error: any): boolean;
+export declare function once(target: globalThis.EventTarget, event: string): Promise<void>;
+export declare function onceAborted(signal: globalThis.AbortSignal): Promise<void>;
+export declare function isAbortError(error: any): error is Error;
 /**
  * Very simple pattern matching function.
  */

package/dist/utils.js

@@ -1,4 +1,3 @@
-/// <reference lib="dom" />
 export const noopFn = () => { };
 export function merge(...objects) {
     return Object.assign({}, ...objects);
@@ -7,7 +6,7 @@ export function unique(array) {
     return new Set(array).values();
 }
 export function defer(cb, ms = 1, ...args) {
-    return new Promise((resolve, reject) => setTimeout(async () => {
+    return new Promise((resolve, reject) => globalThis.setTimeout(async () => {
         try {
             resolve(await cb(...args));
         }
@@ -33,25 +32,8 @@ export function range(count, start = 0) {
         },
     };
 }
-export function debounce(cb, delay) {
-    let timer;
-    const clear = () => timer && clearTimeout(timer);
-    const fn = (...args) => {
-        clear();
-        timer = setTimeout(cb, delay, ...args);
-    };
-    return Object.assign(fn, { clear });
-}
-// TODO: Promise.withResolvers?
 export function createFuture() {
-    let resolve;
-    let reject;
-    const promise = new Promise((res, rej) => {
-        resolve = res;
-        reject = rej;
-    });
-    // @ts-expect-error
-    return { resolve, reject, promise };
+    return Promise.withResolvers();
 }
 export function onAbort(signal, cb, reason) {
     const listener = () => cb(reason ?? signal.reason);
@@ -61,11 +43,11 @@ export function onAbort(signal, cb, reason) {
 export function withTimeout(value, timeout, timeoutError) {
     return Promise.race([
         value,
-        new Promise((_, reject) => setTimeout(reject, timeout, timeoutError)),
+        new Promise((_, reject) => globalThis.setTimeout(reject, timeout, timeoutError)),
     ]);
 }
 export function tryCaptureStackTrace(depth = 0) {
-    const traceLines = new Error().stack?.split('\n');
+    const traceLines = new Error().stack?.split('\n').slice(depth);
     if (traceLines) {
         for (const traceLine of traceLines) {
             const trimmed = traceLine.trim();
@@ -104,7 +86,7 @@ export function isAbortError(error) {
         error.name === 'AbortError' &&
         'code' in error &&
         (error.code === 20 || error.code === 'ABORT_ERR')) ||
-        (error instanceof Event && error.type === 'abort'));
+        (error instanceof globalThis.Event && error.type === 'abort'));
 }
 /**
  * Very simple pattern matching function.

package/dist/utils.js.map

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

package/package.json

@@ -15,12 +15,9 @@
     "LICENSE.md",
     "README.md"
   ],
-  "version": "0.16.1",
+  "version": "0.17.0-beta.2",
   "repository": {
     "type": "git",
     "url": "https://github.com/neematajs/neemata"
-  },
-  "scripts": {
-    "clean-build": "rm -rf ./dist"
   }
 }

package/src/{abortSignal.ts → abort-signal.ts}

@@ -1,18 +1,16 @@
-/// <reference lib="dom" />
-
 /**
  * Little helper to combine multiple AbortSignals into one,
  * with handling of null or undefined values.
  */
 export function anyAbortSignal(
-  ...signals: (AbortSignal | undefined | null)[]
-): AbortSignal {
-  const filtered = signals.filter(Boolean) as AbortSignal[]
+  ...signals: (globalThis.AbortSignal | undefined | null)[]
+): globalThis.AbortSignal {
+  const filtered = signals.filter(Boolean) as globalThis.AbortSignal[]
   if (filtered.length === 0) {
     throw new Error('No AbortSignals provided')
   } else if (filtered.length === 1) {
     return filtered[0]
   } else {
-    return AbortSignal.any(filtered)
+    return globalThis.AbortSignal.any(filtered)
   }
 }

package/src/error.ts

@@ -0,0 +1,44 @@
+export type SerializedError = {
+  readonly name?: string
+  readonly message: string
+  readonly stack?: string
+  readonly cause?: SerializedError
+}
+
+// Depth-limited so a cyclic cause chain cannot recurse forever.
+export const MAX_SERIALIZED_ERROR_DEPTH = 5
+
+export type SerializeErrorOptions = {
+  depth?: number
+  // Whether to drop the `stack` key when it is undefined instead of emitting it.
+  omitUndefinedStack?: boolean
+  // Handles values that are not Error instances (callers differ: normalize vs. passthrough).
+  fallback?: (value: unknown) => SerializedError
+}
+
+export function serializeError(
+  value: unknown,
+  options: SerializeErrorOptions = {},
+): SerializedError {
+  const {
+    depth = MAX_SERIALIZED_ERROR_DEPTH,
+    omitUndefinedStack = false,
+    fallback,
+  } = options
+
+  if (value instanceof Error) {
+    const cause = (value as Error & { readonly cause?: unknown }).cause
+    return {
+      name: value.name,
+      message: value.message,
+      ...(omitUndefinedStack && value.stack === undefined
+        ? {}
+        : { stack: value.stack }),
+      ...(cause === undefined || depth <= 0
+        ? {}
+        : { cause: serializeError(cause, { ...options, depth: depth - 1 }) }),
+    }
+  }
+
+  return fallback ? fallback(value) : { message: String(value) }
+}

package/src/index.ts

@@ -1,5 +1,9 @@
-export * from './abortSignal.ts'
+export * from './abort-signal.ts'
 export * from './constants.ts'
+export * from './error.ts'
+export * from './operation-queue.ts'
+export * from './pool.ts'
+export * from './semaphore.ts'
 export * from './streams.ts'
 export * from './types.ts'
 export * from './utils.ts'

package/src/operation-queue.ts

@@ -0,0 +1,134 @@
+import type { MaybePromise } from './types.ts'
+import { createFuture } from './utils.ts'
+
+export type OperationQueueStrategy = 'serial' | 'latest'
+
+export type OperationQueueOptions = { strategy?: OperationQueueStrategy }
+
+type QueuedOperation = {
+  task: () => MaybePromise<unknown>
+  resolve: (value: unknown) => void
+  reject: (error: unknown) => void
+}
+
+export class OperationSupersededError extends Error {
+  constructor(message = 'Operation superseded') {
+    super(message)
+    this.name = 'OperationSupersededError'
+  }
+}
+
+export class OperationQueue {
+  private readonly strategy: OperationQueueStrategy
+  private tail: Promise<unknown> = Promise.resolve()
+  private count = 0
+  private runningLatest = false
+  private latestOperation: QueuedOperation | undefined
+  private readonly idleWaiters = new Set<() => void>()
+
+  constructor({ strategy = 'serial' }: OperationQueueOptions = {}) {
+    this.strategy = strategy
+  }
+
+  get pending(): number {
+    return this.count
+  }
+
+  get busy(): boolean {
+    return this.count > 0
+  }
+
+  run<T>(task: () => MaybePromise<T>): Promise<T> {
+    return this.strategy === 'latest'
+      ? this.runLatest(task)
+      : this.runSerial(task)
+  }
+
+  async waitIdle(): Promise<void> {
+    if (!this.busy) return
+
+    await new Promise<void>((resolve) => {
+      this.idleWaiters.add(resolve)
+    })
+  }
+
+  private runSerial<T>(task: () => MaybePromise<T>): Promise<T> {
+    this.count++
+
+    const result = this.tail.then(task, task)
+    this.tail = result
+      .catch(() => undefined)
+      .finally(() => {
+        this.finishOperation()
+      })
+
+    return result
+  }
+
+  private runLatest<T>(task: () => MaybePromise<T>): Promise<T> {
+    this.count++
+
+    const { operation, promise } = createQueuedOperation(task)
+
+    if (this.runningLatest) {
+      const previous = this.latestOperation
+      if (previous) {
+        previous.reject(new OperationSupersededError())
+        this.finishOperation()
+      }
+      this.latestOperation = operation
+      return promise
+    }
+
+    this.runningLatest = true
+    void this.runLatestOperations(operation)
+
+    return promise
+  }
+
+  private async runLatestOperations(operation: QueuedOperation): Promise<void> {
+    let current: QueuedOperation | undefined = operation
+
+    while (current) {
+      await this.runLatestOperation(current)
+      current = this.latestOperation
+      this.latestOperation = undefined
+    }
+
+    this.runningLatest = false
+  }
+
+  private async runLatestOperation(operation: QueuedOperation): Promise<void> {
+    try {
+      operation.resolve(await operation.task())
+    } catch (error) {
+      operation.reject(error)
+    } finally {
+      this.finishOperation()
+    }
+  }
+
+  private finishOperation(): void {
+    this.count--
+    if (this.count > 0) return
+
+    for (const resolve of this.idleWaiters) resolve()
+    this.idleWaiters.clear()
+  }
+}
+
+function createQueuedOperation<T>(task: () => MaybePromise<T>): {
+  operation: QueuedOperation
+  promise: Promise<T>
+} {
+  const future = createFuture<T>()
+
+  return {
+    operation: {
+      task: task as () => MaybePromise<unknown>,
+      resolve: future.resolve as (value: unknown) => void,
+      reject: future.reject,
+    },
+    promise: future.promise,
+  }
+}

package/src/pool.ts

@@ -0,0 +1,111 @@
+import type { Callback } from './types.ts'
+
+interface PoolOptions {
+  timeout?: number
+}
+
+interface PoolQueueItem {
+  resolve?: Callback
+  timer?: ReturnType<typeof globalThis.setTimeout>
+}
+
+export class PoolError extends Error {}
+
+// Ported from https://github.com/metarhia/metautil
+export class Pool<T = unknown> {
+  #items: Array<T> = []
+  #free: Array<boolean> = []
+  #queue: PoolQueueItem[] = []
+  #current: number = 0
+  #size: number = 0
+  #available: number = 0
+
+  constructor(private readonly options: PoolOptions = {}) {}
+
+  add(item: T) {
+    if (this.#items.includes(item)) throw new PoolError('Item already exists')
+    this.#size++
+    this.#available++
+    this.#items.push(item)
+    this.#free.push(true)
+  }
+
+  remove(item: T) {
+    if (this.#size === 0) throw new PoolError('Pool is empty')
+    const index = this.#items.indexOf(item)
+    if (index < 0) throw new PoolError('Item is not in the pool')
+    const isCaptured = this.isFree(item)
+    if (isCaptured) this.#available--
+    this.#size--
+    this.#current--
+    this.#items.splice(index, 1)
+    this.#free.splice(index, 1)
+  }
+
+  capture(timeout = this.options.timeout) {
+    return this.next(true, timeout)
+  }
+
+  async next(exclusive = false, timeout = this.options.timeout): Promise<T> {
+    if (this.#size === 0) throw new PoolError('Pool is empty')
+    if (this.#available === 0) {
+      return new Promise((resolve, reject) => {
+        const waiting: PoolQueueItem = {
+          resolve: (item: T) => {
+            if (exclusive) this.#capture(item)
+            resolve(item)
+          },
+          timer: undefined,
+        }
+        if (timeout) {
+          waiting.timer = setTimeout(() => {
+            waiting.resolve = undefined
+            this.#queue.shift()
+            reject(new PoolError('Next item timeout'))
+          }, timeout)
+        }
+        this.#queue.push(waiting)
+      })
+    }
+    let item: T | undefined
+    let free = false
+    do {
+      item = this.#items[this.#current]
+      free = this.#free[this.#current]
+      this.#current++
+      if (this.#current >= this.#size) this.#current = 0
+    } while (typeof item === 'undefined' || !free)
+    if (exclusive) this.#capture(item)
+    return item
+  }
+
+  release(item: T) {
+    const index = this.#items.indexOf(item)
+    if (index < 0) throw new PoolError('Unexpected item')
+    if (this.#free[index])
+      throw new PoolError('Unable to release not captured item')
+    if (this.#queue.length > 0) {
+      const { resolve, timer } = this.#queue.shift()!
+      clearTimeout(timer)
+      if (resolve) return void setTimeout(resolve, 0, item)
+    }
+    this.#free[index] = true
+    this.#available++
+  }
+
+  isFree(item: T) {
+    const index = this.#items.indexOf(item)
+    if (index < 0) return false
+    return this.#free[index]
+  }
+
+  get items() {
+    return [...this.#items]
+  }
+
+  #capture(item: T) {
+    const index = this.#items.indexOf(item)
+    this.#free[index] = false
+    this.#available--
+  }
+}

package/src/semaphore.ts

@@ -0,0 +1,63 @@
+import type { Callback } from './types.ts'
+
+interface SemaphoreQueueItem {
+  resolve?: Callback
+  timer?: ReturnType<typeof setTimeout>
+}
+
+export class SemaphoreError extends Error {}
+
+// Ported from https://github.com/metarhia/metautil
+export class Semaphore {
+  private counter: number
+
+  private readonly queue: SemaphoreQueueItem[] = []
+
+  constructor(
+    concurrency: number,
+    private readonly size: number = 0,
+    private readonly timeout: number = 0,
+  ) {
+    this.counter = concurrency
+  }
+
+  enter(): Promise<void> {
+    if (this.counter > 0) {
+      this.counter--
+      return Promise.resolve()
+    } else if (this.queue.length >= this.size) {
+      return Promise.reject(new SemaphoreError('Queue is full'))
+    } else {
+      return new Promise((resolve, reject) => {
+        const waiting: SemaphoreQueueItem = { resolve }
+        waiting.timer = setTimeout(() => {
+          waiting.resolve = undefined
+          this.queue.shift()
+          reject(new SemaphoreError('Timeout'))
+        }, this.timeout)
+        this.queue.push(waiting)
+      })
+    }
+  }
+
+  leave() {
+    if (this.queue.length === 0) {
+      this.counter++
+    } else {
+      const item = this.queue.shift()
+      if (item) {
+        const { resolve, timer } = item
+        if (timer) clearTimeout(timer)
+        if (resolve) setTimeout(resolve, 0)
+      }
+    }
+  }
+
+  get isEmpty() {
+    return this.queue.length === 0
+  }
+
+  get queueLength() {
+    return this.queue.length
+  }
+}

package/src/streams.ts

@@ -3,26 +3,28 @@
 import type { MaybePromise } from './types.ts'
 
 export interface DuplexStreamOptions<O = unknown, I = O> {
-  start?: (controller: ReadableStreamDefaultController<O>) => void
-  pull?: (controller: ReadableStreamDefaultController<O>) => MaybePromise<void>
+  start?: (controller: globalThis.ReadableStreamDefaultController<O>) => void
+  pull?: (
+    controller: globalThis.ReadableStreamDefaultController<O>,
+  ) => MaybePromise<void>
   cancel?: (reason: unknown) => void
   transform?: (chunk: I) => O
   close?: () => void
-  readableStrategy?: QueuingStrategy<O>
-  writableStrategy?: QueuingStrategy<I>
+  readableStrategy?: globalThis.QueuingStrategy<O>
+  writableStrategy?: globalThis.QueuingStrategy<I>
 }
 
 export class DuplexStream<O = unknown, I = O> {
-  readonly readable: ReadableStream<O>
-  readonly writable!: WritableStream<I>
+  readonly readable: globalThis.ReadableStream<O>
+  readonly writable!: globalThis.WritableStream<I>
 
   constructor(options: DuplexStreamOptions<O, I> = {}) {
-    this.readable = new ReadableStream<O>(
+    this.readable = new globalThis.ReadableStream<O>(
       {
         cancel: options.cancel,
         start: (controller) => {
           // @ts-expect-error
-          this.writable = new WritableStream<I>(
+          this.writable = new globalThis.WritableStream<I>(
             {
               write: (_chunk) => {
                 const chunk = options?.transform

package/src/types.ts

@@ -2,9 +2,12 @@ const TSErrorSymbol: unique symbol = Symbol('TSError')
 
 export type TSError<
   ErrorMessage extends string = string,
-  // biome-ignore lint/correctness/noUnusedVariables: this is used to tag the type
+  // Used to tag the type.
   TagType = never,
-> = `TS Error: ${ErrorMessage}` & { [TSErrorSymbol]: true }
+> = `TS Error: ${ErrorMessage}` & {
+  [TSErrorSymbol]: true
+  readonly __tag?: TagType
+}
 
 export interface TypeProvider {
   readonly input: unknown
@@ -16,12 +19,8 @@ export type CallTypeProvider<T extends TypeProvider, V> = (T & {
 })['output']
 
 export type ClassConstructor<T = any, A extends any[] = any[]> =
-  | (abstract new (
-      ...args: A
-    ) => T)
-  | (new (
-      ...args: A
-    ) => T)
+  | (abstract new (...args: A) => T)
+  | (new (...args: A) => T)
 
 export type ClassInstance<T> = T extends ClassConstructor<infer U> ? U : never
 export type ClassConstructorArgs<T, A = never> =
@@ -40,9 +39,7 @@ export type ArrayMap<T extends readonly any[], K extends keyof T[number]> = {
 }
 
 export type UnionToIntersection<U> = (
-  U extends any
-    ? (k: U) => void
-    : never
+  U extends any ? (k: U) => void : never
 ) extends (k: infer I) => void
   ? I
   : never

package/src/utils.ts

@@ -1,5 +1,3 @@
-/// <reference lib="dom" />
-
 import type { Callback, Pattern } from './types.ts'
 
 export const noopFn = () => {}
@@ -18,7 +16,7 @@ export function defer<T extends Callback>(
   ...args: Parameters<T>
 ): Promise<Awaited<ReturnType<T>>> {
   return new Promise((resolve, reject) =>
-    setTimeout(async () => {
+    globalThis.setTimeout(async () => {
       try {
         resolve(await cb(...args))
       } catch (error) {
@@ -45,36 +43,14 @@ export function range(count: number, start = 0) {
   }
 }
 
-export function debounce(cb: Callback, delay: number) {
-  let timer: any
-  const clear = () => timer && clearTimeout(timer)
-  const fn = (...args: any[]) => {
-    clear()
-    timer = setTimeout(cb, delay, ...args)
-  }
-  return Object.assign(fn, { clear })
-}
+export type Future<T = any> = PromiseWithResolvers<T>
 
-// TODO: Promise.withResolvers?
-export interface Future<T = any> {
-  promise: Promise<T>
-  resolve: (value: T) => void
-  reject: (error: any) => void
-}
-// TODO: Promise.withResolvers?
 export function createFuture<T>(): Future<T> {
-  let resolve: Future<T>['resolve']
-  let reject: Future<T>['reject']
-  const promise = new Promise<T>((res, rej) => {
-    resolve = res
-    reject = rej
-  })
-  // @ts-expect-error
-  return { resolve, reject, promise }
+  return Promise.withResolvers<T>()
 }
 
 export function onAbort<T extends Callback>(
-  signal: AbortSignal,
+  signal: globalThis.AbortSignal,
   cb: T,
   reason?: any,
 ) {
@@ -90,12 +66,14 @@ export function withTimeout(
 ) {
   return Promise.race([
     value,
-    new Promise((_, reject) => setTimeout(reject, timeout, timeoutError)),
+    new Promise((_, reject) =>
+      globalThis.setTimeout(reject, timeout, timeoutError),
+    ),
   ])
 }
 
 export function tryCaptureStackTrace(depth = 0) {
-  const traceLines = new Error().stack?.split('\n')
+  const traceLines = new Error().stack?.split('\n').slice(depth)
   if (traceLines) {
     for (const traceLine of traceLines) {
       const trimmed = traceLine.trim()
@@ -132,23 +110,23 @@ export function throwError(message: string, ErrorClass = Error): never {
   throw new ErrorClass(message)
 }
 
-export function once(target: EventTarget, event: string) {
+export function once(target: globalThis.EventTarget, event: string) {
   return new Promise<void>((resolve) => {
     target.addEventListener(event, () => resolve(), { once: true })
   })
 }
 
-export function onceAborted(signal: AbortSignal) {
+export function onceAborted(signal: globalThis.AbortSignal) {
   return once(signal, 'abort')
 }
 
-export function isAbortError(error) {
+export function isAbortError(error: any): error is Error {
   return (
     (error instanceof Error &&
       error.name === 'AbortError' &&
       'code' in error &&
       (error.code === 20 || error.code === 'ABORT_ERR')) ||
-    (error instanceof Event && error.type === 'abort')
+    (error instanceof globalThis.Event && error.type === 'abort')
   )
 }
 

package/dist/abortSignal.d.ts

@@ -1,5 +0,0 @@
-/**
- * Little helper to combine multiple AbortSignals into one,
- * with handling of null or undefined values.
- */
-export declare function anyAbortSignal(...signals: (AbortSignal | undefined | null)[]): AbortSignal;

package/dist/abortSignal.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"abortSignal.js","sourceRoot":"","sources":["../src/abortSignal.ts"],"names":[],"mappings":"AAAA,2BAA2B;AAE3B;;;GAGG;AACH,MAAM,UAAU,cAAc,CAC5B,GAAG,OAA2C;IAE9C,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,OAAO,CAAkB,CAAA;IACzD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAA;IAC7C,CAAC;SAAM,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjC,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAA;IACpB,CAAC;SAAM,CAAC;QACN,OAAO,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;IAClC,CAAC;AACH,CAAC"}