@nmtjs/common 0.14.5 → 0.15.0-beta.10

package/LICENSE.md

@@ -1,4 +1,4 @@
-Copyright (c) 2024 Denis Ilchyshyn
+Copyright (c) 2025 Denys Ilchyshyn
 
 Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
 

package/README.md

@@ -6,4 +6,4 @@
 - 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

package/dist/abortSignal.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Combines multiple AbortSignals into one that aborts when any of the source signals abort.
+ *
+ * This is a custom implementation to work around memory leaks in Node.js's AbortSignal.any().
+ * Bun's implementation is fine, so we use the native version there.
+ *
+ * @see https://github.com/nodejs/node/issues/54614
+ */
+export declare function anyAbortSignal(...signals: (AbortSignal | undefined)[]): AbortSignal;

package/dist/abortSignal.js

@@ -0,0 +1,50 @@
+/**
+ * Combines multiple AbortSignals into one that aborts when any of the source signals abort.
+ *
+ * This is a custom implementation to work around memory leaks in Node.js's AbortSignal.any().
+ * Bun's implementation is fine, so we use the native version there.
+ *
+ * @see https://github.com/nodejs/node/issues/54614
+ */
+export function anyAbortSignal(...signals) {
+    const filtered = signals.filter(Boolean);
+    if (filtered.length === 0) {
+        return new AbortController().signal;
+    }
+    if (filtered.length === 1) {
+        return filtered[0];
+    }
+    // Use native implementation on Bun (no memory leak there)
+    if ('Bun' in globalThis) {
+        return AbortSignal.any(filtered);
+    }
+    // Custom implementation for Node.js to avoid memory leaks
+    const controller = new AbortController();
+    // Check if any signal is already aborted
+    for (const signal of filtered) {
+        if (signal.aborted) {
+            controller.abort();
+            return controller.signal;
+        }
+    }
+    // Track cleanup functions
+    const cleanups = [];
+    const onAbort = () => {
+        controller.abort();
+        // Clean up all listeners immediately after abort
+        cleanup();
+    };
+    const cleanup = () => {
+        for (const fn of cleanups) {
+            fn();
+        }
+        cleanups.length = 0;
+    };
+    // Attach listeners to all signals
+    for (const signal of filtered) {
+        signal.addEventListener('abort', onAbort, { once: true });
+        cleanups.push(() => signal.removeEventListener('abort', onAbort));
+    }
+    return controller.signal;
+}
+//# sourceMappingURL=abortSignal.js.map

package/dist/abortSignal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"abortSignal.js","sourceRoot":"","sources":["../src/abortSignal.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,UAAU,cAAc,CAC5B,GAAG,OAAoC;IAEvC,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,OAAO,CAAkB,CAAA;IAEzD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,IAAI,eAAe,EAAE,CAAC,MAAM,CAAA;IACrC,CAAC;IAED,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAA;IACpB,CAAC;IAED,0DAA0D;IAC1D,IAAI,KAAK,IAAI,UAAU,EAAE,CAAC;QACxB,OAAO,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;IAClC,CAAC;IAED,0DAA0D;IAC1D,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAA;IAExC,yCAAyC;IACzC,KAAK,MAAM,MAAM,IAAI,QAAQ,EAAE,CAAC;QAC9B,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,UAAU,CAAC,KAAK,EAAE,CAAA;YAClB,OAAO,UAAU,CAAC,MAAM,CAAA;QAC1B,CAAC;IACH,CAAC;IAED,0BAA0B;IAC1B,MAAM,QAAQ,GAAmB,EAAE,CAAA;IAEnC,MAAM,OAAO,GAAG,GAAG,EAAE;QACnB,UAAU,CAAC,KAAK,EAAE,CAAA;QAClB,iDAAiD;QACjD,OAAO,EAAE,CAAA;IACX,CAAC,CAAA;IAED,MAAM,OAAO,GAAG,GAAG,EAAE;QACnB,KAAK,MAAM,EAAE,IAAI,QAAQ,EAAE,CAAC;YAC1B,EAAE,EAAE,CAAA;QACN,CAAC;QACD,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAA;IACrB,CAAC,CAAA;IAED,kCAAkC;IAClC,KAAK,MAAM,MAAM,IAAI,QAAQ,EAAE,CAAC;QAC9B,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAA;QACzD,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAA;IACnE,CAAC;IAED,OAAO,UAAU,CAAC,MAAM,CAAA;AAC1B,CAAC"}

package/dist/constants.d.ts

@@ -0,0 +1,3 @@
+export declare const MAX_UINT32: number;
+export declare const MAX_UINT16: number;
+export declare const MAX_UINT8: number;

package/dist/constants.js

@@ -0,0 +1,4 @@
+export const MAX_UINT32 = 2 ** 32 - 1;
+export const MAX_UINT16 = 2 ** 16 - 1;
+export const MAX_UINT8 = 2 ** 8 - 1;
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAA;AACrC,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAA;AACrC,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA"}

package/dist/index.d.ts

@@ -1,2 +1,5 @@
+export * from './abortSignal.ts';
+export * from './constants.ts';
+export * from './streams.ts';
 export * from './types.ts';
 export * from './utils.ts';

package/dist/index.js

@@ -1,2 +1,6 @@
+export * from "./abortSignal.js";
+export * from "./constants.js";
+export * from "./streams.js";
 export * from "./types.js";
 export * from "./utils.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +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"}

package/dist/streams.d.ts

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

package/dist/streams.js

@@ -0,0 +1,34 @@
+// TODO: add proper queueing/backpressure strategy support
+export class DuplexStream {
+    readable;
+    writable;
+    constructor(options = {}) {
+        this.readable = new ReadableStream({
+            cancel: options.cancel,
+            start: (controller) => {
+                // @ts-expect-error
+                this.writable = new WritableStream({
+                    write: (_chunk) => {
+                        const chunk = options?.transform
+                            ? options?.transform(_chunk)
+                            : _chunk;
+                        controller.enqueue(chunk);
+                    },
+                    abort: (reason) => controller.error(reason),
+                    close: () => {
+                        options?.close?.();
+                        try {
+                            controller.close();
+                        }
+                        catch {
+                            // Controller may already be closed (e.g., via cancel)
+                        }
+                    },
+                }, options.writableStrategy);
+                options.start?.(controller);
+            },
+            pull: options?.pull,
+        }, options.readableStrategy);
+    }
+}
+//# sourceMappingURL=streams.js.map

package/dist/streams.js.map

@@ -0,0 +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,UAAqC,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"}

package/dist/types.d.ts

@@ -1,3 +1,7 @@
+declare const TSErrorSymbol: unique symbol;
+export type TSError<T extends string = string> = `Error: ${T}` & {
+    [TSErrorSymbol]: true;
+};
 export interface TypeProvider {
     readonly input: unknown;
     readonly output: unknown;
@@ -28,4 +32,5 @@ type MergeTypes<TypesArray extends any[], Res = {}> = TypesArray extends [
 type OnlyFirst<F, S> = F & {
     [Key in keyof Omit<S, keyof F>]?: never;
 };
+export type Pattern = RegExp | string | ((value: string) => boolean);
 export {};

package/dist/types.js

@@ -1 +1,3 @@
+const TSErrorSymbol = Symbol('TSError');
 export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,aAAa,GAAkB,MAAM,CAAC,SAAS,CAAC,CAAA"}

package/dist/utils.d.ts

@@ -1,6 +1,7 @@
-import type { Callback } from './types.ts';
+import type { Callback, Pattern } from './types.ts';
 export declare const noopFn: () => void;
 export declare function merge<T extends any[]>(...objects: T): any;
+export declare function unique<T>(array: Iterable<T>): Iterable<T>;
 export declare function defer<T extends Callback>(cb: T, ms?: number, ...args: Parameters<T>): Promise<Awaited<ReturnType<T>>>;
 export declare function range(count: number, start?: number): {
     [Symbol.iterator](): {
@@ -13,19 +14,23 @@ export declare function range(count: number, start?: number): {
 export declare function debounce(cb: Callback, delay: number): ((...args: any[]) => void) & {
     clear: () => any;
 };
-export interface InteractivePromise<T = any> {
+export interface Future<T = any> {
     promise: Promise<T>;
     resolve: (value: T) => void;
     reject: (error: any) => void;
-    toArgs: () => [resolve: this['resolve'], reject: this['reject']];
 }
-export declare function createPromise<T>(): InteractivePromise<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 withTimeout(value: Promise<any>, timeout: number, timeoutError: Error, controller?: AbortController): Promise<unknown>;
+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;
+/**
+ * Very simple pattern matching function.
+ */
+export declare function match(value: string, pattern: Pattern): boolean;

package/dist/utils.js

@@ -2,6 +2,9 @@ export const noopFn = () => { };
 export function merge(...objects) {
     return Object.assign({}, ...objects);
 }
+export function unique(array) {
+    return new Set(array).values();
+}
 export function defer(cb, ms = 1, ...args) {
     return new Promise((resolve, reject) => setTimeout(async () => {
         try {
@@ -39,7 +42,7 @@ export function debounce(cb, delay) {
     return Object.assign(fn, { clear });
 }
 // TODO: Promise.withResolvers?
-export function createPromise() {
+export function createFuture() {
     let resolve;
     let reject;
     const promise = new Promise((res, rej) => {
@@ -47,29 +50,31 @@ export function createPromise() {
         reject = rej;
     });
     // @ts-expect-error
-    return { resolve, reject, promise, toArgs: () => [resolve, reject] };
+    return { resolve, reject, promise };
 }
 export function onAbort(signal, cb, reason) {
     const listener = () => cb(reason ?? signal.reason);
     signal.addEventListener('abort', listener, { once: true });
     return () => signal.removeEventListener('abort', listener);
 }
-export function withTimeout(value, timeout, timeoutError, controller) {
-    return new Promise((resolve, reject) => {
-        const timer = setTimeout(reject, timeout, timeoutError);
-        const clearTimer = () => clearTimeout(timer);
-        const rejectWithTimeout = (error) => {
-            reject(error);
-            controller?.abort(error);
-        };
-        value.then(resolve).catch(rejectWithTimeout).finally(clearTimer);
-    });
+export function withTimeout(value, timeout, timeoutError) {
+    return Promise.race([
+        value,
+        new Promise((_, reject) => setTimeout(reject, timeout, timeoutError)),
+    ]);
 }
 export function tryCaptureStackTrace(depth = 0) {
-    return (new Error().stack
-        ?.split('\n')
-        .slice(4 + depth)
-        .join('\n') ?? undefined);
+    const traceLines = new Error().stack?.split('\n');
+    if (traceLines) {
+        for (const traceLine of traceLines) {
+            const trimmed = traceLine.trim();
+            if (trimmed.startsWith('at eval (') && trimmed.endsWith(')')) {
+                const trace = trimmed.slice(9, -1);
+                return trace;
+            }
+        }
+    }
+    return undefined;
 }
 export function isGeneratorFunction(value) {
     return (typeof value === 'function' &&
@@ -79,6 +84,9 @@ export function isAsyncGeneratorFunction(value) {
     return (typeof value === 'function' &&
         value.constructor.name === 'AsyncGeneratorFunction');
 }
+export function isAsyncIterable(value) {
+    return value && typeof value === 'object' && Symbol.asyncIterator in value;
+}
 export function throwError(message, ErrorClass = Error) {
     throw new ErrorClass(message);
 }
@@ -97,3 +105,32 @@ export function isAbortError(error) {
         (error.code === 20 || error.code === 'ABORT_ERR')) ||
         (error instanceof Event && error.type === 'abort'));
 }
+/**
+ * Very simple pattern matching function.
+ */
+export function match(value, pattern) {
+    if (typeof pattern === 'function') {
+        return pattern(value);
+    }
+    else if (typeof pattern === 'string') {
+        if (pattern === '*' || pattern === '**') {
+            return true;
+        }
+        else if (pattern.at(0) === '*' && pattern.at(-1) === '*') {
+            return value.includes(pattern.slice(1, -1));
+        }
+        else if (pattern.at(-1) === '*') {
+            return value.startsWith(pattern.slice(0, -1));
+        }
+        else if (pattern.at(0) === '*') {
+            return value.endsWith(pattern.slice(1));
+        }
+        else {
+            return value === pattern;
+        }
+    }
+    else {
+        return pattern.test(value);
+    }
+}
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

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

package/package.json

@@ -2,20 +2,18 @@
   "name": "@nmtjs/common",
   "type": "module",
   "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js",
-      "module-sync": "./dist/index.js"
-    }
+    ".": "./dist/index.js"
   },
   "files": [
     "dist",
+    "src",
     "LICENSE.md",
     "README.md"
   ],
-  "version": "0.14.5",
+  "version": "0.15.0-beta.10",
   "scripts": {
-    "build": "tsc",
+    "clean-build": "rm -rf ./dist",
+    "build": "tsc --declaration --sourceMap",
     "type-check": "tsc --noEmit"
   }
 }

package/src/abortSignal.ts

@@ -0,0 +1,61 @@
+/**
+ * Combines multiple AbortSignals into one that aborts when any of the source signals abort.
+ *
+ * This is a custom implementation to work around memory leaks in Node.js's AbortSignal.any().
+ * Bun's implementation is fine, so we use the native version there.
+ *
+ * @see https://github.com/nodejs/node/issues/54614
+ */
+export function anyAbortSignal(
+  ...signals: (AbortSignal | undefined)[]
+): AbortSignal {
+  const filtered = signals.filter(Boolean) as AbortSignal[]
+
+  if (filtered.length === 0) {
+    return new AbortController().signal
+  }
+
+  if (filtered.length === 1) {
+    return filtered[0]
+  }
+
+  // Use native implementation on Bun (no memory leak there)
+  if ('Bun' in globalThis) {
+    return AbortSignal.any(filtered)
+  }
+
+  // Custom implementation for Node.js to avoid memory leaks
+  const controller = new AbortController()
+
+  // Check if any signal is already aborted
+  for (const signal of filtered) {
+    if (signal.aborted) {
+      controller.abort()
+      return controller.signal
+    }
+  }
+
+  // Track cleanup functions
+  const cleanups: (() => void)[] = []
+
+  const onAbort = () => {
+    controller.abort()
+    // Clean up all listeners immediately after abort
+    cleanup()
+  }
+
+  const cleanup = () => {
+    for (const fn of cleanups) {
+      fn()
+    }
+    cleanups.length = 0
+  }
+
+  // Attach listeners to all signals
+  for (const signal of filtered) {
+    signal.addEventListener('abort', onAbort, { once: true })
+    cleanups.push(() => signal.removeEventListener('abort', onAbort))
+  }
+
+  return controller.signal
+}

package/src/constants.ts

@@ -0,0 +1,3 @@
+export const MAX_UINT32 = 2 ** 32 - 1
+export const MAX_UINT16 = 2 ** 16 - 1
+export const MAX_UINT8 = 2 ** 8 - 1

package/src/index.ts

@@ -0,0 +1,5 @@
+export * from './abortSignal.ts'
+export * from './constants.ts'
+export * from './streams.ts'
+export * from './types.ts'
+export * from './utils.ts'

package/src/streams.ts

@@ -0,0 +1,52 @@
+// TODO: add proper queueing/backpressure strategy support
+
+import type { Async } from './types.ts'
+
+export interface DuplexStreamOptions<O = unknown, I = O> {
+  start?: (controller: ReadableStreamDefaultController<O>) => void
+  pull?: (controller: ReadableStreamDefaultController<O>) => Async<void>
+  cancel?: (reason: unknown) => void
+  transform?: (chunk: I) => O
+  close?: () => void
+  readableStrategy?: QueuingStrategy<O>
+  writableStrategy?: QueuingStrategy<I>
+}
+
+export class DuplexStream<O = unknown, I = O> {
+  readonly readable: ReadableStream<O>
+  readonly writable!: WritableStream<I>
+
+  constructor(options: DuplexStreamOptions<O, I> = {}) {
+    this.readable = new ReadableStream<O>(
+      {
+        cancel: options.cancel,
+        start: (controller) => {
+          // @ts-expect-error
+          this.writable = new WritableStream<I>(
+            {
+              write: (_chunk) => {
+                const chunk = options?.transform
+                  ? options?.transform(_chunk)
+                  : _chunk
+                controller.enqueue(chunk as O)
+              },
+              abort: (reason) => controller.error(reason),
+              close: () => {
+                options?.close?.()
+                try {
+                  controller.close()
+                } catch {
+                  // Controller may already be closed (e.g., via cancel)
+                }
+              },
+            },
+            options.writableStrategy,
+          )
+          options.start?.(controller)
+        },
+        pull: options?.pull,
+      },
+      options.readableStrategy,
+    )
+  }
+}

package/src/types.ts

@@ -0,0 +1,80 @@
+const TSErrorSymbol: unique symbol = Symbol('TSError')
+
+export type TSError<T extends string = string> = `Error: ${T}` & {
+  [TSErrorSymbol]: true
+}
+
+export interface TypeProvider {
+  readonly input: unknown
+  readonly output: unknown
+}
+
+export type CallTypeProvider<T extends TypeProvider, V> = (T & {
+  input: V
+})['output']
+
+export type ClassConstructor<T = any, A extends any[] = any[]> =
+  | (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> = T extends ClassConstructor<
+  any,
+  infer U
+>
+  ? U
+  : A
+
+export type Callback<T extends any[] = any[], R = any> = (...args: T) => R
+export type OmitFirstItem<T extends any[]> = T extends [any, ...infer U]
+  ? U
+  : []
+export type ErrorClass = new (...args: any[]) => Error
+export type Extra = Record<string, any>
+export type Async<T> = T | Promise<T>
+
+export type ArrayMap<T extends readonly any[], K extends keyof T[number]> = {
+  [I in keyof T]: T[I][K]
+}
+
+export type UnionToIntersection<U> = (
+  U extends any
+    ? (k: U) => void
+    : never
+) extends (k: infer I) => void
+  ? I
+  : never
+
+export type Merge<
+  T1 extends Record<string, any>,
+  T2 extends Record<string, any>,
+> = {
+  [K in keyof T1 | keyof T2]: K extends keyof T2
+    ? T2[K]
+    : K extends keyof T1
+      ? T1[K]
+      : never
+}
+
+export type OneOf<
+  TypesArray extends any[],
+  Res = never,
+  AllProperties = MergeTypes<TypesArray>,
+> = TypesArray extends [infer Head, ...infer Rem]
+  ? OneOf<Rem, Res | OnlyFirst<Head, AllProperties>, AllProperties>
+  : Res
+
+type MergeTypes<TypesArray extends any[], Res = {}> = TypesArray extends [
+  infer Head,
+  ...infer Rem,
+]
+  ? MergeTypes<Rem, Res & Head>
+  : Res
+
+type OnlyFirst<F, S> = F & { [Key in keyof Omit<S, keyof F>]?: never }
+
+export type Pattern = RegExp | string | ((value: string) => boolean)

package/src/utils.ts

@@ -0,0 +1,174 @@
+import type { Callback, Pattern } from './types.ts'
+
+export const noopFn = () => {}
+
+export function merge<T extends any[]>(...objects: T) {
+  return Object.assign({}, ...objects)
+}
+
+export function unique<T>(array: Iterable<T>): Iterable<T> {
+  return new Set(array).values()
+}
+
+export function defer<T extends Callback>(
+  cb: T,
+  ms = 1,
+  ...args: Parameters<T>
+): Promise<Awaited<ReturnType<T>>> {
+  return new Promise((resolve, reject) =>
+    setTimeout(async () => {
+      try {
+        resolve(await cb(...args))
+      } catch (error) {
+        reject(error)
+      }
+    }, ms),
+  )
+}
+
+export function range(count: number, start = 0) {
+  let current = start
+  return {
+    [Symbol.iterator]() {
+      return {
+        next() {
+          if (current < count) {
+            return { done: false, value: current++ }
+          } else {
+            return { done: true, value: current }
+          }
+        },
+      }
+    },
+  }
+}
+
+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 })
+}
+
+// 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 }
+}
+
+export function onAbort<T extends Callback>(
+  signal: AbortSignal,
+  cb: T,
+  reason?: any,
+) {
+  const listener = () => cb(reason ?? signal.reason)
+  signal.addEventListener('abort', listener, { once: true })
+  return () => signal.removeEventListener('abort', listener)
+}
+
+export function withTimeout(
+  value: Promise<any>,
+  timeout: number,
+  timeoutError: Error,
+) {
+  return Promise.race([
+    value,
+    new Promise((_, reject) => setTimeout(reject, timeout, timeoutError)),
+  ])
+}
+
+export function tryCaptureStackTrace(depth = 0) {
+  const traceLines = new Error().stack?.split('\n')
+  if (traceLines) {
+    for (const traceLine of traceLines) {
+      const trimmed = traceLine.trim()
+
+      if (trimmed.startsWith('at eval (') && trimmed.endsWith(')')) {
+        const trace = trimmed.slice(9, -1)
+        return trace
+      }
+    }
+  }
+  return undefined
+}
+
+export function isGeneratorFunction(value: any): value is GeneratorFunction {
+  return (
+    typeof value === 'function' &&
+    value.constructor.name === 'GeneratorFunction'
+  )
+}
+
+export function isAsyncGeneratorFunction(
+  value: any,
+): value is AsyncGeneratorFunction {
+  return (
+    typeof value === 'function' &&
+    value.constructor.name === 'AsyncGeneratorFunction'
+  )
+}
+export function isAsyncIterable(value: any): value is AsyncIterable<unknown> {
+  return value && typeof value === 'object' && Symbol.asyncIterator in value
+}
+
+export function throwError(message: string, ErrorClass = Error): never {
+  throw new ErrorClass(message)
+}
+
+export function once(target: EventTarget, event: string) {
+  return new Promise<void>((resolve) => {
+    target.addEventListener(event, () => resolve(), { once: true })
+  })
+}
+
+export function onceAborted(signal: AbortSignal) {
+  return once(signal, 'abort')
+}
+
+export function isAbortError(error) {
+  return (
+    (error instanceof Error &&
+      error.name === 'AbortError' &&
+      'code' in error &&
+      (error.code === 20 || error.code === 'ABORT_ERR')) ||
+    (error instanceof Event && error.type === 'abort')
+  )
+}
+
+/**
+ * Very simple pattern matching function.
+ */
+export function match(value: string, pattern: Pattern) {
+  if (typeof pattern === 'function') {
+    return pattern(value)
+  } else if (typeof pattern === 'string') {
+    if (pattern === '*' || pattern === '**') {
+      return true
+    } else if (pattern.at(0) === '*' && pattern.at(-1) === '*') {
+      return value.includes(pattern.slice(1, -1))
+    } else if (pattern.at(-1) === '*') {
+      return value.startsWith(pattern.slice(0, -1))
+    } else if (pattern.at(0) === '*') {
+      return value.endsWith(pattern.slice(1))
+    } else {
+      return value === pattern
+    }
+  } else {
+    return pattern.test(value)
+  }
+}