@vielzeug/familiar 26.11.4 → 26.11.6
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/_pool-core.js +1 -2
- package/dist/_pool.cjs +1 -1
- package/dist/_pool.cjs.map +1 -1
- package/dist/_pool.js +47 -48
- package/dist/_stream-pool.cjs +1 -1
- package/dist/_stream-pool.cjs.map +1 -1
- package/dist/_stream-pool.js +27 -28
- package/dist/_timers.js +1 -2
- package/dist/errors.js +1 -2
- package/dist/familiar.js +5 -10
- package/dist/familiar.js.map +1 -1
- package/dist/index.cjs +1 -1
- package/dist/index.js +3 -3
- package/dist/protocol.js +1 -2
- package/dist/testing/testing.cjs +1 -1
- package/dist/testing/testing.cjs.map +1 -1
- package/dist/testing/testing.js +35 -36
- package/dist/worker.cjs +1 -1
- package/dist/worker.cjs.map +1 -1
- package/dist/worker.js +46 -47
- package/package.json +8 -8
package/dist/familiar.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"familiar.js","names":["timer","message","opts","maxQueue","operation","timeoutMs","MAX_TIMEOUT","priority","timeout","name","freeSlots","slots","waiters","idleWaiters","capacityWaiters","tappers","tapper","disposalController","active","waiterSequence","capacitySequence","completed","failed","drainPromise","terminated","waiter","drainOptions","index","reject","reason","signal","abortError","settled","resolve","b","a","acquireOptions","options","fn","slot","free","error","next","event","handler","tapOptions","delta","core","transferables","runOptions","value","input","owner","tasks","controller","inputs","task","pool","token","iterator","running","acquired","resolvedConcurrency","concurrency","onFull","response","cause","#url","url","#pending","#stopWorker","#settlePending","#dispatch","chunks","done","result","#disposed","worker","#ensureWorker","id","#taskId","pending","#worker","#onMessage","#failWorker","kind","resolvedUrl","resolved"],"sources":["../src/_timers.ts","../src/errors.ts","../src/_pool-core.ts","../src/_pool.ts","../src/_stream-pool.ts","../src/worker.ts"],"sourcesContent":["/**\n * Node compatibility helper: `unref()`s a timer so a pending per-task timeout/watchdog does not\n * keep a Node event loop (e.g. a Worker polyfill) alive. Browsers return a plain number from\n * `setTimeout`/`setInterval`, so this is a no-op there.\n *\n * Not part of the public API surface.\n */\nexport function unrefTimer(timer: ReturnType<typeof setTimeout> | ReturnType<typeof setInterval>): void {\n if (typeof timer === 'object' && timer !== null && 'unref' in timer) {\n (timer as { unref(): void }).unref();\n }\n}\n","/** Base class for all familiar errors. Use `instanceof FamiliarError` to catch any familiar-originated error. */\nexport class FamiliarError extends Error {\n constructor(message: string, opts?: ErrorOptions) {\n super(message, opts);\n this.name = new.target.name;\n Object.setPrototypeOf(this, new.target.prototype);\n }\n}\n\n/** Thrown when invalid options are passed to a Familiar pool factory. */\nexport class FamiliarInvalidOptionsError extends FamiliarError {}\n\n/** Thrown when run() is called and the queue is full (`onFull='reject'`). */\nexport class FamiliarQueueFullError extends FamiliarError {\n /** The configured `maxQueue` value. */\n readonly maxQueue: number;\n\n constructor(maxQueue: number) {\n super(`Queue is full (maxQueue=${maxQueue})`);\n this.maxQueue = maxQueue;\n }\n}\n\n/** Thrown when the task function throws. The original error is available as `.cause`. */\nexport class FamiliarTaskError extends FamiliarError {}\n\n/** Thrown when a task or operation is rejected because the worker was terminated. */\nexport class FamiliarTerminatedError extends FamiliarError {\n constructor(message = 'Worker was terminated') {\n super(message);\n }\n}\n\n/** Thrown when a task exceeds its timeout or `drain()` times out. */\nexport class FamiliarTimeoutError extends FamiliarError {\n /** The configured timeout in milliseconds. */\n readonly timeoutMs: number;\n\n constructor(timeoutMs: number, operation = 'Task') {\n super(`${operation} timed out after ${timeoutMs}ms`);\n this.timeoutMs = timeoutMs;\n }\n}\n\n/** Thrown when the Worker API is unavailable or an unhandled error occurs in the worker thread. */\nexport class FamiliarRuntimeError extends FamiliarError {}\n","import { abortError, tapper } from '@vielzeug/arsenal';\nimport { unrefTimer } from './_timers.js';\nimport {\n FamiliarInvalidOptionsError,\n FamiliarQueueFullError,\n type FamiliarRuntimeError,\n FamiliarTerminatedError,\n FamiliarTimeoutError,\n} from './errors.js';\nimport type { DrainOptions, FamiliarTapEvent, WorkerStats, WorkerStatus } from './types.js';\n\nexport const MAX_CONCURRENCY = 512;\nexport const MAX_TIMEOUT = 2_147_483_647;\n\nexport function validatePriority(priority: number): number {\n if (!Number.isFinite(priority)) throw new FamiliarInvalidOptionsError('`priority` must be a finite number');\n return priority;\n}\n\nexport function validateTimeout(timeout: number | undefined, name = 'timeout'): number | undefined {\n if (timeout !== undefined && (!Number.isInteger(timeout) || timeout < 1 || timeout > MAX_TIMEOUT)) {\n throw new FamiliarInvalidOptionsError(`\\`${name}\\` must be an integer from 1 through ${MAX_TIMEOUT}`);\n }\n return timeout;\n}\n\nexport type PoolOptions = {\n defaultTimeout: number | undefined;\n maxQueue: number | undefined;\n onFull: 'reject' | 'wait';\n};\n\nexport type AcquireOptions = {\n priority: number;\n signal?: AbortSignal;\n};\n\n/**\n * A pool slot: tearable on disposal, with an optional channel for reporting\n * unhandled runtime errors. Pool factories wire `notify` to the core's tap so\n * slot owners can emit without holding a pool reference.\n */\nexport type PoolSlot = {\n notify?(error: FamiliarRuntimeError): void;\n terminate(): void;\n};\n\ntype IdleWaiter = {\n reject: (reason: unknown) => void;\n resolve: () => void;\n timer?: ReturnType<typeof setTimeout>;\n};\n\ntype CapacityWaiter = {\n cleanup(): void;\n priority: number;\n reject(reason: unknown): void;\n resolve(): void;\n sequence: number;\n};\n\ntype SlotWaiter<TSlot> = {\n cleanup(): void;\n priority: number;\n reject(reason: unknown): void;\n start(slot: TSlot): void;\n sequence: number;\n signal?: AbortSignal;\n};\n\nexport interface PoolCore<TSlot> {\n /**\n * Acquire a free slot and hand it to `fn`, which runs the acquired work.\n * `fn` is invoked synchronously both for an immediately free slot and when\n * a release hands the next waiter its slot, so dispatch never lags a\n * release by a microtask. Honors priority, FIFO order, abort, and `maxQueue`\n * admission; failures surface as a rejected promise. Without `fn`, resolves\n * with the slot instead.\n */\n acquire(options: AcquireOptions): Promise<TSlot>;\n acquire<R>(options: AcquireOptions, fn: (slot: TSlot) => R | Promise<R>): Promise<R>;\n readonly disposalSignal: AbortSignal;\n dispose(): void;\n readonly disposed: boolean;\n drain(options?: DrainOptions): Promise<void>;\n readonly drainPromise: Promise<void> | undefined;\n emitTap(event: FamiliarTapEvent): void;\n /** Return a slot to the pool, handing it to the highest-priority waiter if any. */\n release(slot: TSlot): void;\n settleIdle(): void;\n stats(): WorkerStats;\n status(): WorkerStatus;\n tap(handler: (event: FamiliarTapEvent) => void, options?: { readonly signal?: AbortSignal }): () => void;\n trackActive(delta: number): void;\n trackCompleted(): void;\n trackFailed(): void;\n}\n\n/**\n * The single slot scheduler shared by the result pool and the stream pool:\n * free-slot fast path, priority/FIFO waiter queue, `maxQueue` admission with\n * capacity waiters, idle/drain tracking, stats, disposal, and tap observation.\n * The two pools differ only in what they do with an acquired slot.\n */\nexport function createPoolCore<TSlot extends PoolSlot>(slots: readonly TSlot[], options: PoolOptions): PoolCore<TSlot> {\n const freeSlots = [...slots];\n const waiters: SlotWaiter<TSlot>[] = [];\n const idleWaiters: IdleWaiter[] = [];\n const capacityWaiters: CapacityWaiter[] = [];\n const tappers = tapper<FamiliarTapEvent>();\n const disposalController = new AbortController();\n let active = 0;\n let waiterSequence = 0;\n let capacitySequence = 0;\n let completed = 0;\n let failed = 0;\n let drainPromise: Promise<void> | undefined;\n let terminated = false;\n\n function isIdle(): boolean {\n return freeSlots.length === slots.length && waiters.length === 0;\n }\n\n function settleIdle(): void {\n if (!isIdle()) return;\n\n for (const waiter of idleWaiters.splice(0)) {\n if (waiter.timer) clearTimeout(waiter.timer);\n\n waiter.resolve();\n }\n }\n\n function waitForIdle(drainOptions: DrainOptions): Promise<void> {\n if (isIdle()) return Promise.resolve();\n\n return new Promise<void>((resolve, reject) => {\n const waiter: IdleWaiter = { reject, resolve };\n\n if (drainOptions.timeout !== undefined) {\n waiter.timer = setTimeout(() => {\n const index = idleWaiters.indexOf(waiter);\n\n if (index !== -1) idleWaiters.splice(index, 1);\n\n reject(new FamiliarTimeoutError(drainOptions.timeout!, 'Drain'));\n }, drainOptions.timeout);\n unrefTimer(waiter.timer);\n }\n\n idleWaiters.push(waiter);\n });\n }\n\n function releaseCapacity(): void {\n capacityWaiters.shift()?.resolve();\n }\n\n function rejectCapacity(reason: unknown): void {\n for (const waiter of capacityWaiters.splice(0)) waiter.reject(reason);\n }\n\n function waitForCapacity(signal: AbortSignal | undefined, priority: number): Promise<void> {\n if (signal?.aborted) return Promise.reject(abortError(signal));\n\n return new Promise<void>((resolve, reject) => {\n let settled = false;\n const waiter: CapacityWaiter = {\n cleanup() {\n signal?.removeEventListener('abort', onAbort);\n },\n priority,\n reject(reason) {\n if (settled) return;\n\n settled = true;\n waiter.cleanup();\n\n const index = capacityWaiters.indexOf(waiter);\n\n if (index !== -1) capacityWaiters.splice(index, 1);\n\n reject(reason);\n },\n resolve() {\n if (settled) return;\n\n settled = true;\n waiter.cleanup();\n resolve();\n },\n sequence: capacitySequence++,\n };\n const onAbort = () => waiter.reject(abortError(signal!));\n\n signal?.addEventListener('abort', onAbort, { once: true });\n capacityWaiters.push(waiter);\n capacityWaiters.sort((a, b) => b.priority - a.priority || a.sequence - b.sequence);\n });\n }\n\n function acquire<R>(acquireOptions: AcquireOptions, fn?: (slot: TSlot) => R | Promise<R>): Promise<R | TSlot> {\n const { priority, signal } = acquireOptions;\n\n if (signal?.aborted) return Promise.reject(abortError(signal));\n\n return (async () => {\n for (;;) {\n if (terminated) throw new FamiliarTerminatedError();\n\n if (drainPromise) throw new FamiliarTerminatedError('Worker is draining');\n\n if (options.maxQueue === undefined || waiters.length < options.maxQueue) {\n return admit(acquireOptions, (fn ?? ((slot) => slot)) as (slot: TSlot) => R | Promise<R>);\n }\n\n if (options.onFull === 'reject') throw new FamiliarQueueFullError(options.maxQueue);\n\n await waitForCapacity(signal, priority);\n\n if (signal?.aborted) {\n releaseCapacity();\n throw abortError(signal);\n }\n }\n })();\n }\n\n function admit<R>(acquireOptions: AcquireOptions, fn: (slot: TSlot) => R | Promise<R>): Promise<R> {\n const { priority, signal } = acquireOptions;\n\n const free = freeSlots.pop();\n\n if (free) {\n try {\n return Promise.resolve(fn(free));\n } catch (error) {\n // A synchronous throw must not strand the slot: idle would never settle.\n release(free);\n settleIdle();\n\n return Promise.reject(error);\n }\n }\n\n return new Promise<R>((resolve, reject) => {\n const waiter: SlotWaiter<TSlot> = {\n cleanup() {\n waiter.signal?.removeEventListener('abort', onAbort);\n },\n priority,\n reject(reason) {\n waiter.cleanup();\n\n const index = waiters.indexOf(waiter);\n\n if (index !== -1) {\n waiters.splice(index, 1);\n releaseCapacity();\n }\n\n reject(reason);\n settleIdle();\n },\n sequence: waiterSequence++,\n signal,\n start(slot) {\n waiter.cleanup();\n\n try {\n resolve(fn(slot));\n } catch (error) {\n release(slot);\n settleIdle();\n reject(error);\n }\n },\n };\n const onAbort = () => waiter.reject(abortError(waiter.signal!));\n\n waiter.signal?.addEventListener('abort', onAbort, { once: true });\n waiters.push(waiter);\n waiters.sort((a, b) => b.priority - a.priority || a.sequence - b.sequence);\n });\n }\n\n function release(slot: TSlot): void {\n const next = waiters.shift();\n\n if (next) {\n next.start(slot);\n releaseCapacity();\n } else {\n freeSlots.push(slot);\n }\n }\n\n function dispose(): void {\n if (terminated) return;\n\n terminated = true;\n disposalController.abort();\n\n for (const slot of slots) slot.terminate();\n\n for (const waiter of waiters.splice(0)) waiter.reject(new FamiliarTerminatedError());\n\n rejectCapacity(new FamiliarTerminatedError());\n settleIdle();\n tappers.emit({ type: 'dispose' });\n tappers.clear();\n }\n\n function drain(drainOptions: DrainOptions = {}): Promise<void> {\n if (terminated) return Promise.resolve();\n try {\n validateTimeout(drainOptions.timeout, 'drain.timeout');\n } catch (error) {\n return Promise.reject(error);\n }\n\n if (drainPromise) return drainPromise;\n\n rejectCapacity(new FamiliarTerminatedError('Worker is draining'));\n drainPromise = waitForIdle(drainOptions).then(\n () => dispose(),\n (error: unknown) => {\n dispose();\n throw error;\n },\n );\n\n return drainPromise;\n }\n\n return {\n acquire,\n disposalSignal: disposalController.signal,\n dispose,\n get disposed() {\n return terminated;\n },\n drain,\n get drainPromise() {\n return drainPromise;\n },\n emitTap(event) {\n tappers.emit(event);\n },\n release,\n settleIdle,\n stats() {\n return { active, completed, failed, queued: waiters.length + capacityWaiters.length };\n },\n status() {\n if (terminated) return 'terminated';\n\n return active === 0 ? 'idle' : 'running';\n },\n tap(handler, tapOptions) {\n if (terminated) return () => undefined;\n\n return tappers.tap(handler, tapOptions);\n },\n trackActive(delta: number) {\n active += delta;\n },\n trackCompleted() {\n completed += 1;\n },\n trackFailed() {\n failed += 1;\n },\n };\n}\n","import { abortError } from '@vielzeug/arsenal';\nimport { createPoolCore, type PoolCore, type PoolOptions, validatePriority, validateTimeout } from './_pool-core.js';\nimport { FamiliarRuntimeError, FamiliarTerminatedError } from './errors.js';\nimport type { RunOptions, SlotStrategy, WorkerPool } from './types.js';\n\nexport type { PoolOptions } from './_pool-core.js';\n\nexport function createPool<TInput, TOutput>(\n slots: readonly SlotStrategy<TInput, TOutput>[],\n options: PoolOptions,\n): WorkerPool<TInput, TOutput> {\n const core: PoolCore<SlotStrategy<TInput, TOutput>> = createPoolCore(slots, options);\n\n for (const slot of slots) slot.notify = (error) => core.emitTap({ error, type: 'worker-error' });\n\n function run(input: TInput, runOptions: RunOptions = {}): Promise<TOutput> {\n let priority: number;\n let timeout: number | undefined;\n let transferables: Transferable[];\n\n try {\n priority = validatePriority(runOptions.priority ?? 0);\n timeout = validateTimeout(runOptions.timeout) ?? options.defaultTimeout;\n transferables = [...(runOptions.transferables ?? [])];\n } catch (error) {\n return Promise.reject(error);\n }\n\n return core.acquire({ priority, signal: runOptions.signal }, (slot) => {\n core.trackActive(1);\n\n const onAbort = () => slot.cancel(abortError(runOptions.signal!));\n runOptions.signal?.addEventListener('abort', onAbort, { once: true });\n\n const finish = async (): Promise<TOutput> => {\n try {\n const value = await slot.run(input, transferables, timeout);\n\n core.trackCompleted();\n\n return value;\n } catch (error) {\n if (!runOptions.signal?.aborted && !(error instanceof FamiliarTerminatedError)) core.trackFailed();\n\n throw error;\n } finally {\n runOptions.signal?.removeEventListener('abort', onAbort);\n core.trackActive(-1);\n core.release(slot);\n core.settleIdle();\n }\n };\n\n return finish();\n });\n }\n\n return {\n get disposalSignal() {\n return core.disposalSignal;\n },\n dispose: core.dispose,\n get disposed() {\n return core.disposed;\n },\n drain: core.drain,\n run,\n get stats() {\n return core.stats();\n },\n get status() {\n return core.status();\n },\n tap: core.tap,\n [Symbol.asyncDispose]: () => core.drain({}),\n [Symbol.dispose]: core.dispose,\n };\n}\n\nexport type BatchOptions<TInput> = Pick<RunOptions, 'priority' | 'signal' | 'timeout'> & {\n getTransferables?: (input: TInput, index: number) => readonly Transferable[];\n};\n\n/** Run related tasks concurrently and yield their results in input order. */\nexport function runBatch<TInput, TOutput>(\n pool: WorkerPool<TInput, TOutput>,\n inputs: readonly TInput[],\n options: BatchOptions<TInput> = {},\n): AsyncIterable<TOutput> {\n let owner: object | undefined;\n\n const iterate = async function* (controller: AbortController): AsyncGenerator<TOutput> {\n const tasks: Promise<TOutput>[] = [];\n const onAbort = () => controller.abort(options.signal?.reason);\n\n if (options.signal?.aborted) controller.abort(options.signal.reason);\n else options.signal?.addEventListener('abort', onAbort, { once: true });\n\n try {\n for (const [index, input] of inputs.entries()) {\n const task = pool\n .run(input, {\n priority: options.priority,\n signal: controller.signal,\n timeout: options.timeout,\n transferables: options.getTransferables?.(input, index),\n })\n .catch((error: unknown) => {\n controller.abort(error);\n throw error;\n });\n\n void task.catch(() => undefined);\n tasks.push(task);\n }\n\n if (tasks.length === 0 && controller.signal.aborted) throw abortError(controller.signal);\n for (const task of tasks) {\n if (controller.signal.aborted) throw abortError(controller.signal);\n const value = await task;\n if (controller.signal.aborted) throw abortError(controller.signal);\n yield value;\n }\n } catch (error) {\n controller.abort(error);\n throw error;\n } finally {\n options.signal?.removeEventListener('abort', onAbort);\n controller.abort(new DOMException('Batch consumer stopped', 'AbortError'));\n await Promise.allSettled(tasks);\n }\n };\n\n return {\n [Symbol.asyncIterator]() {\n const token = {};\n const controller = new AbortController();\n let iterator: AsyncGenerator<TOutput> | undefined;\n const start = (): AsyncGenerator<TOutput> | undefined => {\n owner ??= token;\n if (owner !== token) return undefined;\n iterator ??= iterate(controller);\n return iterator;\n };\n\n return {\n next: () =>\n start()?.next() ?? Promise.reject(new FamiliarRuntimeError('Worker batches can only be consumed once')),\n return: async (value?: unknown) => {\n if (!owner || owner !== token) return { done: true, value: value as TOutput };\n controller.abort(new FamiliarTerminatedError('Batch consumer stopped'));\n return iterator?.return(value as TOutput) ?? { done: true, value: value as TOutput };\n },\n throw: async (error?: unknown) => {\n const active = start();\n if (!active) throw new FamiliarRuntimeError('Worker batches can only be consumed once');\n controller.abort(error);\n return active.throw(error);\n },\n };\n },\n };\n}\n","import { abortError } from '@vielzeug/arsenal';\nimport { createPoolCore, type PoolCore, type PoolOptions, validatePriority, validateTimeout } from './_pool-core.js';\nimport { FamiliarRuntimeError, FamiliarTerminatedError } from './errors.js';\nimport type { RunOptions, StreamWorkerPool } from './types.js';\n\nexport type StreamSlot<TInput, TChunk> = {\n cancel(reason: unknown): void;\n /** Wired by the pool factory to report unhandled worker runtime errors through `tap()`. */\n notify?(error: FamiliarRuntimeError): void;\n stream(input: TInput, options: RunOptions): { done: Promise<void>; iterable: AsyncIterable<TChunk> };\n terminate(): void;\n};\n\nexport function createStreamPool<TInput, TChunk>(\n slots: readonly StreamSlot<TInput, TChunk>[],\n options: PoolOptions,\n): StreamWorkerPool<TInput, TChunk> {\n const core: PoolCore<StreamSlot<TInput, TChunk>> = createPoolCore(slots, options);\n\n for (const slot of slots) slot.notify = (error) => core.emitTap({ error, type: 'worker-error' });\n\n function runStream(input: TInput, runOptions: RunOptions = {}): AsyncIterable<TChunk> {\n const priority = validatePriority(runOptions.priority ?? 0);\n const timeout = validateTimeout(runOptions.timeout) ?? options.defaultTimeout;\n const transferables = [...(runOptions.transferables ?? [])];\n let owner: object | undefined;\n\n const iterate = async function* (controller: AbortController): AsyncGenerator<TChunk> {\n const onAbort = () => controller.abort(runOptions.signal?.reason);\n let slot: StreamSlot<TInput, TChunk> | undefined;\n let onCancel: (() => void) | undefined;\n\n if (runOptions.signal?.aborted) controller.abort(runOptions.signal.reason);\n else runOptions.signal?.addEventListener('abort', onAbort, { once: true });\n\n try {\n const running = await core.acquire({ priority, signal: controller.signal }, (acquired) => {\n slot = acquired;\n core.trackActive(1);\n onCancel = () => slot?.cancel(abortError(controller.signal));\n controller.signal.addEventListener('abort', onCancel, { once: true });\n\n return acquired.stream(input, { priority, signal: controller.signal, timeout, transferables });\n });\n\n for await (const value of running.iterable) yield value;\n await running.done;\n core.trackCompleted();\n } catch (error) {\n if (slot && !controller.signal.aborted && !(error instanceof FamiliarTerminatedError)) core.trackFailed();\n throw error;\n } finally {\n runOptions.signal?.removeEventListener('abort', onAbort);\n\n if (slot) {\n if (onCancel) controller.signal.removeEventListener('abort', onCancel);\n\n core.trackActive(-1);\n core.release(slot);\n core.settleIdle();\n }\n }\n };\n\n return {\n [Symbol.asyncIterator]() {\n const token = {};\n const controller = new AbortController();\n let iterator: AsyncGenerator<TChunk> | undefined;\n const start = (): AsyncGenerator<TChunk> | undefined => {\n owner ??= token;\n if (owner !== token) return undefined;\n iterator ??= iterate(controller);\n return iterator;\n };\n\n return {\n next: () =>\n start()?.next() ?? Promise.reject(new FamiliarRuntimeError('Worker streams can only be consumed once')),\n return: async (value?: unknown) => {\n if (!owner || owner !== token) return { done: true, value: value as TChunk };\n controller.abort(new FamiliarTerminatedError('Stream consumer stopped'));\n return iterator?.return(value as TChunk) ?? { done: true, value: value as TChunk };\n },\n throw: async (error?: unknown) => {\n const active = start();\n if (!active) throw new FamiliarRuntimeError('Worker streams can only be consumed once');\n controller.abort(error);\n return active.throw(error);\n },\n };\n },\n };\n }\n\n return {\n get disposalSignal() {\n return core.disposalSignal;\n },\n dispose: core.dispose,\n get disposed() {\n return core.disposed;\n },\n drain: core.drain,\n runStream,\n get stats() {\n return core.stats();\n },\n get status() {\n return core.status();\n },\n tap: core.tap,\n [Symbol.asyncDispose]: () => core.drain({}),\n [Symbol.dispose]: core.dispose,\n };\n}\n","import { createPool } from './_pool.js';\nimport { MAX_CONCURRENCY, validateTimeout } from './_pool-core.js';\nimport { createStreamPool, type StreamSlot } from './_stream-pool.js';\nimport { unrefTimer } from './_timers.js';\nimport {\n FamiliarInvalidOptionsError,\n FamiliarRuntimeError,\n FamiliarTaskError,\n FamiliarTerminatedError,\n FamiliarTimeoutError,\n} from './errors.js';\nimport type { SerializedError, WorkerResponse } from './protocol.js';\nimport { PROTOCOL_VERSION } from './protocol.js';\nimport type { RunOptions, SlotStrategy, StreamWorkerPool, WorkerOptions, WorkerPool } from './types.js';\n\ntype ResolvedOptions = {\n concurrency: number;\n maxQueue: number | undefined;\n onFull: 'reject' | 'wait';\n timeout: number | undefined;\n};\n\ntype Pending<TOutput> = {\n emit?: (value: TOutput) => void;\n id: number;\n kind: 'run' | 'stream';\n reject: (reason: unknown) => void;\n resolve: (value: TOutput) => void;\n timer?: ReturnType<typeof setTimeout>;\n};\n\ntype RunningStream<TChunk> = {\n done: Promise<void>;\n iterable: AsyncIterable<TChunk>;\n};\n\nfunction resolveOptions(options: WorkerOptions = {}): ResolvedOptions {\n const { concurrency = 1, maxQueue, onFull = 'reject', timeout } = options;\n const resolvedConcurrency =\n concurrency === 'auto'\n ? Math.min(MAX_CONCURRENCY, Math.max(1, globalThis.navigator?.hardwareConcurrency ?? 1))\n : concurrency;\n\n if (!Number.isInteger(resolvedConcurrency) || resolvedConcurrency < 1 || resolvedConcurrency > MAX_CONCURRENCY) {\n throw new FamiliarInvalidOptionsError(`\\`concurrency\\` must be a positive integer ≤ ${MAX_CONCURRENCY} or \"auto\"`);\n }\n\n if (maxQueue !== undefined && (!Number.isInteger(maxQueue) || maxQueue < 1)) {\n throw new FamiliarInvalidOptionsError('`maxQueue` must be a positive integer');\n }\n\n if (onFull !== 'reject' && onFull !== 'wait') {\n throw new FamiliarInvalidOptionsError('`onFull` must be \"reject\" or \"wait\"');\n }\n\n validateTimeout(timeout);\n\n return { concurrency: resolvedConcurrency, maxQueue, onFull, timeout };\n}\n\nfunction isWorkerResponse<TOutput>(value: unknown): value is WorkerResponse<TOutput> {\n if (typeof value !== 'object' || value === null) return false;\n\n const response = value as Partial<WorkerResponse<TOutput>>;\n if (\n response.version !== PROTOCOL_VERSION ||\n typeof response.id !== 'number' ||\n !Number.isSafeInteger(response.id) ||\n response.id < 0\n )\n return false;\n\n if (response.kind === 'chunk' || response.kind === 'result') return 'value' in response;\n if (response.kind !== 'error' || typeof response.error !== 'object' || response.error === null) return false;\n\n return (\n (response.error.category === undefined || response.error.category === 'protocol') &&\n typeof response.error.message === 'string' &&\n typeof response.error.name === 'string' &&\n (response.error.stack === undefined || typeof response.error.stack === 'string')\n );\n}\n\nfunction responseError(error: SerializedError): FamiliarRuntimeError | FamiliarTaskError {\n const cause = new Error(error.message);\n\n cause.name = error.name;\n cause.stack = error.stack;\n\n return error.category === 'protocol'\n ? new FamiliarRuntimeError(error.message, { cause })\n : new FamiliarTaskError(error.message, { cause });\n}\n\nclass Slot<TInput, TOutput> implements SlotStrategy<TInput, TOutput>, StreamSlot<TInput, TOutput> {\n readonly #url: URL | string;\n #disposed = false;\n #pending: Pending<TOutput> | undefined;\n #taskId = 0;\n #worker: Worker | undefined;\n\n /** Wired by the pool factory to report unhandled worker runtime errors through `tap()`. */\n notify: ((error: FamiliarRuntimeError) => void) | undefined = undefined;\n\n constructor(url: URL | string) {\n this.#url = url;\n }\n\n cancel(reason: unknown): void {\n if (!this.#pending) return;\n this.#stopWorker();\n this.#settlePending('reject', reason);\n }\n\n run(input: TInput, transferables: Transferable[], timeout: number | undefined): Promise<TOutput> {\n return this.#dispatch(input, transferables, timeout, 'run') as Promise<TOutput>;\n }\n\n stream(input: TInput, options: RunOptions): RunningStream<TOutput> {\n const stop = () => this.cancel(new FamiliarTerminatedError('Stream consumer stopped'));\n const chunks: TOutput[] = [];\n const waiters: Array<(result: IteratorResult<TOutput>) => void> = [];\n let done = false;\n let error: unknown;\n const emit = (value: TOutput) => {\n const waiter = waiters.shift();\n\n if (waiter) waiter({ done: false, value });\n else chunks.push(value);\n };\n const finish = (reason?: unknown) => {\n done = true;\n error = reason;\n\n while (waiters.length > 0) {\n const waiter = waiters.shift()!;\n\n if (reason !== undefined) waiter(Promise.reject(reason) as never);\n else waiter({ done: true, value: undefined as never });\n }\n };\n const donePromise = this.#dispatch(input, [...(options.transferables ?? [])], options.timeout, 'stream', emit).then(\n () => finish(),\n (reason: unknown) => finish(reason),\n );\n\n return {\n done: donePromise,\n iterable: {\n [Symbol.asyncIterator]: () => ({\n async next(): Promise<IteratorResult<TOutput>> {\n if (chunks.length > 0) return { done: false, value: chunks.shift()! };\n\n if (error !== undefined) throw error;\n\n if (done) return { done: true, value: undefined as never };\n\n return new Promise<IteratorResult<TOutput>>((resolve, reject) => {\n waiters.push((result) => {\n if (result instanceof Promise) void result.then(resolve, reject);\n else resolve(result);\n });\n });\n },\n async return(): Promise<IteratorResult<TOutput>> {\n stop();\n\n return { done: true, value: undefined as never };\n },\n }),\n },\n };\n }\n\n terminate(): void {\n this.#disposed = true;\n this.#stopWorker();\n this.#settlePending('reject', new FamiliarTerminatedError());\n }\n\n #dispatch(\n input: TInput,\n transferables: Transferable[],\n timeout: number | undefined,\n kind: 'run' | 'stream',\n emit?: (value: TOutput) => void,\n ): Promise<TOutput> {\n if (this.#disposed) return Promise.reject(new FamiliarTerminatedError());\n\n if (this.#pending) return Promise.reject(new FamiliarRuntimeError('Worker slot is already busy'));\n\n try {\n const worker = this.#ensureWorker();\n const id = this.#taskId;\n this.#taskId = id === Number.MAX_SAFE_INTEGER ? 0 : id + 1;\n\n return new Promise<TOutput>((resolve, reject) => {\n const pending: Pending<TOutput> = { emit, id, kind, reject, resolve };\n\n this.#pending = pending;\n\n if (timeout !== undefined) {\n pending.timer = setTimeout(() => this.cancel(new FamiliarTimeoutError(timeout)), timeout);\n unrefTimer(pending.timer);\n }\n\n try {\n worker.postMessage({ id, input, kind, version: PROTOCOL_VERSION }, transferables);\n } catch (error) {\n this.cancel(new FamiliarRuntimeError('Failed to post message to worker', { cause: error }));\n }\n });\n } catch (error) {\n return Promise.reject(error);\n }\n }\n\n #ensureWorker(): Worker {\n if (this.#worker) return this.#worker;\n\n if (typeof Worker === 'undefined') throw new FamiliarRuntimeError('Worker API is unavailable in this runtime');\n\n try {\n const worker = new Worker(this.#url, { type: 'module' });\n\n worker.onmessage = (event: MessageEvent<unknown>) => {\n if (this.#worker === worker) this.#onMessage(event.data);\n };\n worker.onerror = (event) => this.#failWorker(worker, new FamiliarRuntimeError(event.message || 'Worker failed'));\n worker.onmessageerror = () =>\n this.#failWorker(worker, new FamiliarRuntimeError('Worker response could not be deserialized'));\n this.#worker = worker;\n\n return worker;\n } catch (error) {\n throw new FamiliarRuntimeError('Failed to create Worker', { cause: error });\n }\n }\n\n #stopWorker(): void {\n const worker = this.#worker;\n this.#worker = undefined;\n if (!worker) return;\n\n worker.onmessage = null;\n worker.onerror = null;\n worker.onmessageerror = null;\n worker.terminate();\n }\n\n #failWorker(worker: Worker, error: FamiliarRuntimeError): void {\n if (this.#worker !== worker) return;\n\n this.#stopWorker();\n this.#settlePending('reject', error);\n this.notify?.(error);\n }\n\n #onMessage(message: unknown): void {\n if (!this.#pending) return;\n\n if (\n !isWorkerResponse<TOutput>(message) ||\n message.id !== this.#pending.id ||\n (this.#pending.kind === 'run' && message.kind === 'chunk')\n ) {\n this.cancel(new FamiliarRuntimeError('Worker returned an incompatible protocol response'));\n\n return;\n }\n\n if (message.kind === 'chunk') {\n this.#pending.emit?.(message.value);\n\n return;\n }\n\n if (message.kind === 'error') {\n this.#settlePending('reject', responseError(message.error));\n\n return;\n }\n\n this.#settlePending('resolve', message.value);\n }\n\n #settlePending(kind: 'resolve' | 'reject', value: unknown): void {\n const pending = this.#pending;\n\n if (!pending) return;\n\n this.#pending = undefined;\n\n if (pending.timer) clearTimeout(pending.timer);\n\n if (kind === 'resolve') pending.resolve(value as TOutput);\n else pending.reject(value);\n }\n}\n\nfunction slots<TInput, TOutput>(url: URL | string, options: ResolvedOptions): Slot<TInput, TOutput>[] {\n const resolvedUrl = typeof url === 'string' ? url : url.href;\n return Array.from({ length: options.concurrency }, () => new Slot<TInput, TOutput>(resolvedUrl));\n}\n\n/** Create a pool backed by an ES module worker registered with exposeTask(). */\nexport function createWorker<TInput, TOutput>(\n url: URL | string,\n options: WorkerOptions = {},\n): WorkerPool<TInput, TOutput> {\n const resolved = resolveOptions(options);\n\n return createPool(slots<TInput, TOutput>(url, resolved), {\n defaultTimeout: resolved.timeout,\n maxQueue: resolved.maxQueue,\n onFull: resolved.onFull,\n });\n}\n\n/** Create a stream-only pool backed by an ES module worker registered with exposeStream(). */\nexport function createStreamWorker<TInput, TChunk>(\n url: URL | string,\n options: WorkerOptions = {},\n): StreamWorkerPool<TInput, TChunk> {\n const resolved = resolveOptions(options);\n\n return createStreamPool(slots<TInput, TChunk>(url, resolved), {\n defaultTimeout: resolved.timeout,\n maxQueue: resolved.maxQueue,\n onFull: resolved.onFull,\n });\n}\n"],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"familiar.js","names":["timer","message","opts","maxQueue","operation","timeoutMs","MAX_TIMEOUT","priority","timeout","name","freeSlots","slots","waiters","idleWaiters","capacityWaiters","tappers","tapper","disposalController","active","waiterSequence","capacitySequence","completed","failed","drainPromise","terminated","waiter","drainOptions","index","reject","reason","signal","abortError","settled","resolve","b","a","acquireOptions","options","fn","slot","free","error","next","event","handler","tapOptions","delta","core","transferables","runOptions","value","input","owner","tasks","controller","inputs","task","pool","token","iterator","running","acquired","resolvedConcurrency","concurrency","onFull","response","cause","#url","url","#pending","#stopWorker","#settlePending","#dispatch","chunks","done","result","#disposed","worker","#ensureWorker","id","#taskId","pending","#worker","#onMessage","#failWorker","kind","resolvedUrl","resolved"],"sources":["../src/_timers.ts","../src/errors.ts","../src/_pool-core.ts","../src/_pool.ts","../src/_stream-pool.ts","../src/worker.ts"],"sourcesContent":["/**\n * Node compatibility helper: `unref()`s a timer so a pending per-task timeout/watchdog does not\n * keep a Node event loop (e.g. a Worker polyfill) alive. Browsers return a plain number from\n * `setTimeout`/`setInterval`, so this is a no-op there.\n *\n * Not part of the public API surface.\n */\nexport function unrefTimer(timer: ReturnType<typeof setTimeout> | ReturnType<typeof setInterval>): void {\n if (typeof timer === 'object' && timer !== null && 'unref' in timer) {\n (timer as { unref(): void }).unref();\n }\n}\n","/** Base class for all familiar errors. Use `instanceof FamiliarError` to catch any familiar-originated error. */\nexport class FamiliarError extends Error {\n constructor(message: string, opts?: ErrorOptions) {\n super(message, opts);\n this.name = new.target.name;\n Object.setPrototypeOf(this, new.target.prototype);\n }\n}\n\n/** Thrown when invalid options are passed to a Familiar pool factory. */\nexport class FamiliarInvalidOptionsError extends FamiliarError {}\n\n/** Thrown when run() is called and the queue is full (`onFull='reject'`). */\nexport class FamiliarQueueFullError extends FamiliarError {\n /** The configured `maxQueue` value. */\n readonly maxQueue: number;\n\n constructor(maxQueue: number) {\n super(`Queue is full (maxQueue=${maxQueue})`);\n this.maxQueue = maxQueue;\n }\n}\n\n/** Thrown when the task function throws. The original error is available as `.cause`. */\nexport class FamiliarTaskError extends FamiliarError {}\n\n/** Thrown when a task or operation is rejected because the worker was terminated. */\nexport class FamiliarTerminatedError extends FamiliarError {\n constructor(message = 'Worker was terminated') {\n super(message);\n }\n}\n\n/** Thrown when a task exceeds its timeout or `drain()` times out. */\nexport class FamiliarTimeoutError extends FamiliarError {\n /** The configured timeout in milliseconds. */\n readonly timeoutMs: number;\n\n constructor(timeoutMs: number, operation = 'Task') {\n super(`${operation} timed out after ${timeoutMs}ms`);\n this.timeoutMs = timeoutMs;\n }\n}\n\n/** Thrown when the Worker API is unavailable or an unhandled error occurs in the worker thread. */\nexport class FamiliarRuntimeError extends FamiliarError {}\n","import { abortError, tapper } from '@vielzeug/arsenal';\nimport { unrefTimer } from './_timers.js';\nimport {\n FamiliarInvalidOptionsError,\n FamiliarQueueFullError,\n type FamiliarRuntimeError,\n FamiliarTerminatedError,\n FamiliarTimeoutError,\n} from './errors.js';\nimport type { DrainOptions, FamiliarTapEvent, WorkerStats, WorkerStatus } from './types.js';\n\nexport const MAX_CONCURRENCY = 512;\nexport const MAX_TIMEOUT = 2_147_483_647;\n\nexport function validatePriority(priority: number): number {\n if (!Number.isFinite(priority)) throw new FamiliarInvalidOptionsError('`priority` must be a finite number');\n return priority;\n}\n\nexport function validateTimeout(timeout: number | undefined, name = 'timeout'): number | undefined {\n if (timeout !== undefined && (!Number.isInteger(timeout) || timeout < 1 || timeout > MAX_TIMEOUT)) {\n throw new FamiliarInvalidOptionsError(`\\`${name}\\` must be an integer from 1 through ${MAX_TIMEOUT}`);\n }\n return timeout;\n}\n\nexport type PoolOptions = {\n defaultTimeout: number | undefined;\n maxQueue: number | undefined;\n onFull: 'reject' | 'wait';\n};\n\nexport type AcquireOptions = {\n priority: number;\n signal?: AbortSignal;\n};\n\n/**\n * A pool slot: tearable on disposal, with an optional channel for reporting\n * unhandled runtime errors. Pool factories wire `notify` to the core's tap so\n * slot owners can emit without holding a pool reference.\n */\nexport type PoolSlot = {\n notify?(error: FamiliarRuntimeError): void;\n terminate(): void;\n};\n\ntype IdleWaiter = {\n reject: (reason: unknown) => void;\n resolve: () => void;\n timer?: ReturnType<typeof setTimeout>;\n};\n\ntype CapacityWaiter = {\n cleanup(): void;\n priority: number;\n reject(reason: unknown): void;\n resolve(): void;\n sequence: number;\n};\n\ntype SlotWaiter<TSlot> = {\n cleanup(): void;\n priority: number;\n reject(reason: unknown): void;\n start(slot: TSlot): void;\n sequence: number;\n signal?: AbortSignal;\n};\n\nexport interface PoolCore<TSlot> {\n /**\n * Acquire a free slot and hand it to `fn`, which runs the acquired work.\n * `fn` is invoked synchronously both for an immediately free slot and when\n * a release hands the next waiter its slot, so dispatch never lags a\n * release by a microtask. Honors priority, FIFO order, abort, and `maxQueue`\n * admission; failures surface as a rejected promise. Without `fn`, resolves\n * with the slot instead.\n */\n acquire(options: AcquireOptions): Promise<TSlot>;\n acquire<R>(options: AcquireOptions, fn: (slot: TSlot) => R | Promise<R>): Promise<R>;\n readonly disposalSignal: AbortSignal;\n dispose(): void;\n readonly disposed: boolean;\n drain(options?: DrainOptions): Promise<void>;\n readonly drainPromise: Promise<void> | undefined;\n emitTap(event: FamiliarTapEvent): void;\n /** Return a slot to the pool, handing it to the highest-priority waiter if any. */\n release(slot: TSlot): void;\n settleIdle(): void;\n stats(): WorkerStats;\n status(): WorkerStatus;\n tap(handler: (event: FamiliarTapEvent) => void, options?: { readonly signal?: AbortSignal }): () => void;\n trackActive(delta: number): void;\n trackCompleted(): void;\n trackFailed(): void;\n}\n\n/**\n * The single slot scheduler shared by the result pool and the stream pool:\n * free-slot fast path, priority/FIFO waiter queue, `maxQueue` admission with\n * capacity waiters, idle/drain tracking, stats, disposal, and tap observation.\n * The two pools differ only in what they do with an acquired slot.\n */\nexport function createPoolCore<TSlot extends PoolSlot>(slots: readonly TSlot[], options: PoolOptions): PoolCore<TSlot> {\n const freeSlots = [...slots];\n const waiters: SlotWaiter<TSlot>[] = [];\n const idleWaiters: IdleWaiter[] = [];\n const capacityWaiters: CapacityWaiter[] = [];\n const tappers = tapper<FamiliarTapEvent>();\n const disposalController = new AbortController();\n let active = 0;\n let waiterSequence = 0;\n let capacitySequence = 0;\n let completed = 0;\n let failed = 0;\n let drainPromise: Promise<void> | undefined;\n let terminated = false;\n\n function isIdle(): boolean {\n return freeSlots.length === slots.length && waiters.length === 0;\n }\n\n function settleIdle(): void {\n if (!isIdle()) return;\n\n for (const waiter of idleWaiters.splice(0)) {\n if (waiter.timer) clearTimeout(waiter.timer);\n\n waiter.resolve();\n }\n }\n\n function waitForIdle(drainOptions: DrainOptions): Promise<void> {\n if (isIdle()) return Promise.resolve();\n\n return new Promise<void>((resolve, reject) => {\n const waiter: IdleWaiter = { reject, resolve };\n\n if (drainOptions.timeout !== undefined) {\n waiter.timer = setTimeout(() => {\n const index = idleWaiters.indexOf(waiter);\n\n if (index !== -1) idleWaiters.splice(index, 1);\n\n reject(new FamiliarTimeoutError(drainOptions.timeout!, 'Drain'));\n }, drainOptions.timeout);\n unrefTimer(waiter.timer);\n }\n\n idleWaiters.push(waiter);\n });\n }\n\n function releaseCapacity(): void {\n capacityWaiters.shift()?.resolve();\n }\n\n function rejectCapacity(reason: unknown): void {\n for (const waiter of capacityWaiters.splice(0)) waiter.reject(reason);\n }\n\n function waitForCapacity(signal: AbortSignal | undefined, priority: number): Promise<void> {\n if (signal?.aborted) return Promise.reject(abortError(signal));\n\n return new Promise<void>((resolve, reject) => {\n let settled = false;\n const waiter: CapacityWaiter = {\n cleanup() {\n signal?.removeEventListener('abort', onAbort);\n },\n priority,\n reject(reason) {\n if (settled) return;\n\n settled = true;\n waiter.cleanup();\n\n const index = capacityWaiters.indexOf(waiter);\n\n if (index !== -1) capacityWaiters.splice(index, 1);\n\n reject(reason);\n },\n resolve() {\n if (settled) return;\n\n settled = true;\n waiter.cleanup();\n resolve();\n },\n sequence: capacitySequence++,\n };\n const onAbort = () => waiter.reject(abortError(signal!));\n\n signal?.addEventListener('abort', onAbort, { once: true });\n capacityWaiters.push(waiter);\n capacityWaiters.sort((a, b) => b.priority - a.priority || a.sequence - b.sequence);\n });\n }\n\n function acquire<R>(acquireOptions: AcquireOptions, fn?: (slot: TSlot) => R | Promise<R>): Promise<R | TSlot> {\n const { priority, signal } = acquireOptions;\n\n if (signal?.aborted) return Promise.reject(abortError(signal));\n\n return (async () => {\n for (;;) {\n if (terminated) throw new FamiliarTerminatedError();\n\n if (drainPromise) throw new FamiliarTerminatedError('Worker is draining');\n\n if (options.maxQueue === undefined || waiters.length < options.maxQueue) {\n return admit(acquireOptions, (fn ?? ((slot) => slot)) as (slot: TSlot) => R | Promise<R>);\n }\n\n if (options.onFull === 'reject') throw new FamiliarQueueFullError(options.maxQueue);\n\n await waitForCapacity(signal, priority);\n\n if (signal?.aborted) {\n releaseCapacity();\n throw abortError(signal);\n }\n }\n })();\n }\n\n function admit<R>(acquireOptions: AcquireOptions, fn: (slot: TSlot) => R | Promise<R>): Promise<R> {\n const { priority, signal } = acquireOptions;\n\n const free = freeSlots.pop();\n\n if (free) {\n try {\n return Promise.resolve(fn(free));\n } catch (error) {\n // A synchronous throw must not strand the slot: idle would never settle.\n release(free);\n settleIdle();\n\n return Promise.reject(error);\n }\n }\n\n return new Promise<R>((resolve, reject) => {\n const waiter: SlotWaiter<TSlot> = {\n cleanup() {\n waiter.signal?.removeEventListener('abort', onAbort);\n },\n priority,\n reject(reason) {\n waiter.cleanup();\n\n const index = waiters.indexOf(waiter);\n\n if (index !== -1) {\n waiters.splice(index, 1);\n releaseCapacity();\n }\n\n reject(reason);\n settleIdle();\n },\n sequence: waiterSequence++,\n signal,\n start(slot) {\n waiter.cleanup();\n\n try {\n resolve(fn(slot));\n } catch (error) {\n release(slot);\n settleIdle();\n reject(error);\n }\n },\n };\n const onAbort = () => waiter.reject(abortError(waiter.signal!));\n\n waiter.signal?.addEventListener('abort', onAbort, { once: true });\n waiters.push(waiter);\n waiters.sort((a, b) => b.priority - a.priority || a.sequence - b.sequence);\n });\n }\n\n function release(slot: TSlot): void {\n const next = waiters.shift();\n\n if (next) {\n next.start(slot);\n releaseCapacity();\n } else {\n freeSlots.push(slot);\n }\n }\n\n function dispose(): void {\n if (terminated) return;\n\n terminated = true;\n disposalController.abort();\n\n for (const slot of slots) slot.terminate();\n\n for (const waiter of waiters.splice(0)) waiter.reject(new FamiliarTerminatedError());\n\n rejectCapacity(new FamiliarTerminatedError());\n settleIdle();\n tappers.emit({ type: 'dispose' });\n tappers.clear();\n }\n\n function drain(drainOptions: DrainOptions = {}): Promise<void> {\n if (terminated) return Promise.resolve();\n try {\n validateTimeout(drainOptions.timeout, 'drain.timeout');\n } catch (error) {\n return Promise.reject(error);\n }\n\n if (drainPromise) return drainPromise;\n\n rejectCapacity(new FamiliarTerminatedError('Worker is draining'));\n drainPromise = waitForIdle(drainOptions).then(\n () => dispose(),\n (error: unknown) => {\n dispose();\n throw error;\n },\n );\n\n return drainPromise;\n }\n\n return {\n acquire,\n disposalSignal: disposalController.signal,\n dispose,\n get disposed() {\n return terminated;\n },\n drain,\n get drainPromise() {\n return drainPromise;\n },\n emitTap(event) {\n tappers.emit(event);\n },\n release,\n settleIdle,\n stats() {\n return { active, completed, failed, queued: waiters.length + capacityWaiters.length };\n },\n status() {\n if (terminated) return 'terminated';\n\n return active === 0 ? 'idle' : 'running';\n },\n tap(handler, tapOptions) {\n if (terminated) return () => undefined;\n\n return tappers.tap(handler, tapOptions);\n },\n trackActive(delta: number) {\n active += delta;\n },\n trackCompleted() {\n completed += 1;\n },\n trackFailed() {\n failed += 1;\n },\n };\n}\n","import { abortError } from '@vielzeug/arsenal';\nimport { createPoolCore, type PoolCore, type PoolOptions, validatePriority, validateTimeout } from './_pool-core.js';\nimport { FamiliarRuntimeError, FamiliarTerminatedError } from './errors.js';\nimport type { RunOptions, SlotStrategy, WorkerPool } from './types.js';\n\nexport type { PoolOptions } from './_pool-core.js';\n\nexport function createPool<TInput, TOutput>(\n slots: readonly SlotStrategy<TInput, TOutput>[],\n options: PoolOptions,\n): WorkerPool<TInput, TOutput> {\n const core: PoolCore<SlotStrategy<TInput, TOutput>> = createPoolCore(slots, options);\n\n for (const slot of slots) slot.notify = (error) => core.emitTap({ error, type: 'worker-error' });\n\n function run(input: TInput, runOptions: RunOptions = {}): Promise<TOutput> {\n let priority: number;\n let timeout: number | undefined;\n let transferables: Transferable[];\n\n try {\n priority = validatePriority(runOptions.priority ?? 0);\n timeout = validateTimeout(runOptions.timeout) ?? options.defaultTimeout;\n transferables = [...(runOptions.transferables ?? [])];\n } catch (error) {\n return Promise.reject(error);\n }\n\n return core.acquire({ priority, signal: runOptions.signal }, (slot) => {\n core.trackActive(1);\n\n const onAbort = () => slot.cancel(abortError(runOptions.signal!));\n runOptions.signal?.addEventListener('abort', onAbort, { once: true });\n\n const finish = async (): Promise<TOutput> => {\n try {\n const value = await slot.run(input, transferables, timeout);\n\n core.trackCompleted();\n\n return value;\n } catch (error) {\n if (!runOptions.signal?.aborted && !(error instanceof FamiliarTerminatedError)) core.trackFailed();\n\n throw error;\n } finally {\n runOptions.signal?.removeEventListener('abort', onAbort);\n core.trackActive(-1);\n core.release(slot);\n core.settleIdle();\n }\n };\n\n return finish();\n });\n }\n\n return {\n get disposalSignal() {\n return core.disposalSignal;\n },\n dispose: core.dispose,\n get disposed() {\n return core.disposed;\n },\n drain: core.drain,\n run,\n get stats() {\n return core.stats();\n },\n get status() {\n return core.status();\n },\n tap: core.tap,\n [Symbol.asyncDispose]: () => core.drain({}),\n [Symbol.dispose]: core.dispose,\n };\n}\n\nexport type BatchOptions<TInput> = Pick<RunOptions, 'priority' | 'signal' | 'timeout'> & {\n getTransferables?: (input: TInput, index: number) => readonly Transferable[];\n};\n\n/** Run related tasks concurrently and yield their results in input order. */\nexport function runBatch<TInput, TOutput>(\n pool: WorkerPool<TInput, TOutput>,\n inputs: readonly TInput[],\n options: BatchOptions<TInput> = {},\n): AsyncIterable<TOutput> {\n let owner: object | undefined;\n\n const iterate = async function* (controller: AbortController): AsyncGenerator<TOutput> {\n const tasks: Promise<TOutput>[] = [];\n const onAbort = () => controller.abort(options.signal?.reason);\n\n if (options.signal?.aborted) controller.abort(options.signal.reason);\n else options.signal?.addEventListener('abort', onAbort, { once: true });\n\n try {\n for (const [index, input] of inputs.entries()) {\n const task = pool\n .run(input, {\n priority: options.priority,\n signal: controller.signal,\n timeout: options.timeout,\n transferables: options.getTransferables?.(input, index),\n })\n .catch((error: unknown) => {\n controller.abort(error);\n throw error;\n });\n\n void task.catch(() => undefined);\n tasks.push(task);\n }\n\n if (tasks.length === 0 && controller.signal.aborted) throw abortError(controller.signal);\n for (const task of tasks) {\n if (controller.signal.aborted) throw abortError(controller.signal);\n const value = await task;\n if (controller.signal.aborted) throw abortError(controller.signal);\n yield value;\n }\n } catch (error) {\n controller.abort(error);\n throw error;\n } finally {\n options.signal?.removeEventListener('abort', onAbort);\n controller.abort(new DOMException('Batch consumer stopped', 'AbortError'));\n await Promise.allSettled(tasks);\n }\n };\n\n return {\n [Symbol.asyncIterator]() {\n const token = {};\n const controller = new AbortController();\n let iterator: AsyncGenerator<TOutput> | undefined;\n const start = (): AsyncGenerator<TOutput> | undefined => {\n owner ??= token;\n if (owner !== token) return undefined;\n iterator ??= iterate(controller);\n return iterator;\n };\n\n return {\n next: () =>\n start()?.next() ?? Promise.reject(new FamiliarRuntimeError('Worker batches can only be consumed once')),\n return: async (value?: unknown) => {\n if (!owner || owner !== token) return { done: true, value: value as TOutput };\n controller.abort(new FamiliarTerminatedError('Batch consumer stopped'));\n return iterator?.return(value as TOutput) ?? { done: true, value: value as TOutput };\n },\n throw: async (error?: unknown) => {\n const active = start();\n if (!active) throw new FamiliarRuntimeError('Worker batches can only be consumed once');\n controller.abort(error);\n return active.throw(error);\n },\n };\n },\n };\n}\n","import { abortError } from '@vielzeug/arsenal';\nimport { createPoolCore, type PoolCore, type PoolOptions, validatePriority, validateTimeout } from './_pool-core.js';\nimport { FamiliarRuntimeError, FamiliarTerminatedError } from './errors.js';\nimport type { RunOptions, StreamWorkerPool } from './types.js';\n\nexport type StreamSlot<TInput, TChunk> = {\n cancel(reason: unknown): void;\n /** Wired by the pool factory to report unhandled worker runtime errors through `tap()`. */\n notify?(error: FamiliarRuntimeError): void;\n stream(input: TInput, options: RunOptions): { done: Promise<void>; iterable: AsyncIterable<TChunk> };\n terminate(): void;\n};\n\nexport function createStreamPool<TInput, TChunk>(\n slots: readonly StreamSlot<TInput, TChunk>[],\n options: PoolOptions,\n): StreamWorkerPool<TInput, TChunk> {\n const core: PoolCore<StreamSlot<TInput, TChunk>> = createPoolCore(slots, options);\n\n for (const slot of slots) slot.notify = (error) => core.emitTap({ error, type: 'worker-error' });\n\n function runStream(input: TInput, runOptions: RunOptions = {}): AsyncIterable<TChunk> {\n const priority = validatePriority(runOptions.priority ?? 0);\n const timeout = validateTimeout(runOptions.timeout) ?? options.defaultTimeout;\n const transferables = [...(runOptions.transferables ?? [])];\n let owner: object | undefined;\n\n const iterate = async function* (controller: AbortController): AsyncGenerator<TChunk> {\n const onAbort = () => controller.abort(runOptions.signal?.reason);\n let slot: StreamSlot<TInput, TChunk> | undefined;\n let onCancel: (() => void) | undefined;\n\n if (runOptions.signal?.aborted) controller.abort(runOptions.signal.reason);\n else runOptions.signal?.addEventListener('abort', onAbort, { once: true });\n\n try {\n const running = await core.acquire({ priority, signal: controller.signal }, (acquired) => {\n slot = acquired;\n core.trackActive(1);\n onCancel = () => slot?.cancel(abortError(controller.signal));\n controller.signal.addEventListener('abort', onCancel, { once: true });\n\n return acquired.stream(input, { priority, signal: controller.signal, timeout, transferables });\n });\n\n for await (const value of running.iterable) yield value;\n await running.done;\n core.trackCompleted();\n } catch (error) {\n if (slot && !controller.signal.aborted && !(error instanceof FamiliarTerminatedError)) core.trackFailed();\n throw error;\n } finally {\n runOptions.signal?.removeEventListener('abort', onAbort);\n\n if (slot) {\n if (onCancel) controller.signal.removeEventListener('abort', onCancel);\n\n core.trackActive(-1);\n core.release(slot);\n core.settleIdle();\n }\n }\n };\n\n return {\n [Symbol.asyncIterator]() {\n const token = {};\n const controller = new AbortController();\n let iterator: AsyncGenerator<TChunk> | undefined;\n const start = (): AsyncGenerator<TChunk> | undefined => {\n owner ??= token;\n if (owner !== token) return undefined;\n iterator ??= iterate(controller);\n return iterator;\n };\n\n return {\n next: () =>\n start()?.next() ?? Promise.reject(new FamiliarRuntimeError('Worker streams can only be consumed once')),\n return: async (value?: unknown) => {\n if (!owner || owner !== token) return { done: true, value: value as TChunk };\n controller.abort(new FamiliarTerminatedError('Stream consumer stopped'));\n return iterator?.return(value as TChunk) ?? { done: true, value: value as TChunk };\n },\n throw: async (error?: unknown) => {\n const active = start();\n if (!active) throw new FamiliarRuntimeError('Worker streams can only be consumed once');\n controller.abort(error);\n return active.throw(error);\n },\n };\n },\n };\n }\n\n return {\n get disposalSignal() {\n return core.disposalSignal;\n },\n dispose: core.dispose,\n get disposed() {\n return core.disposed;\n },\n drain: core.drain,\n runStream,\n get stats() {\n return core.stats();\n },\n get status() {\n return core.status();\n },\n tap: core.tap,\n [Symbol.asyncDispose]: () => core.drain({}),\n [Symbol.dispose]: core.dispose,\n };\n}\n","import { createPool } from './_pool.js';\nimport { MAX_CONCURRENCY, validateTimeout } from './_pool-core.js';\nimport { createStreamPool, type StreamSlot } from './_stream-pool.js';\nimport { unrefTimer } from './_timers.js';\nimport {\n FamiliarInvalidOptionsError,\n FamiliarRuntimeError,\n FamiliarTaskError,\n FamiliarTerminatedError,\n FamiliarTimeoutError,\n} from './errors.js';\nimport type { SerializedError, WorkerResponse } from './protocol.js';\nimport { PROTOCOL_VERSION } from './protocol.js';\nimport type { RunOptions, SlotStrategy, StreamWorkerPool, WorkerOptions, WorkerPool } from './types.js';\n\ntype ResolvedOptions = {\n concurrency: number;\n maxQueue: number | undefined;\n onFull: 'reject' | 'wait';\n timeout: number | undefined;\n};\n\ntype Pending<TOutput> = {\n emit?: (value: TOutput) => void;\n id: number;\n kind: 'run' | 'stream';\n reject: (reason: unknown) => void;\n resolve: (value: TOutput) => void;\n timer?: ReturnType<typeof setTimeout>;\n};\n\ntype RunningStream<TChunk> = {\n done: Promise<void>;\n iterable: AsyncIterable<TChunk>;\n};\n\nfunction resolveOptions(options: WorkerOptions = {}): ResolvedOptions {\n const { concurrency = 1, maxQueue, onFull = 'reject', timeout } = options;\n const resolvedConcurrency =\n concurrency === 'auto'\n ? Math.min(MAX_CONCURRENCY, Math.max(1, globalThis.navigator?.hardwareConcurrency ?? 1))\n : concurrency;\n\n if (!Number.isInteger(resolvedConcurrency) || resolvedConcurrency < 1 || resolvedConcurrency > MAX_CONCURRENCY) {\n throw new FamiliarInvalidOptionsError(`\\`concurrency\\` must be a positive integer ≤ ${MAX_CONCURRENCY} or \"auto\"`);\n }\n\n if (maxQueue !== undefined && (!Number.isInteger(maxQueue) || maxQueue < 1)) {\n throw new FamiliarInvalidOptionsError('`maxQueue` must be a positive integer');\n }\n\n if (onFull !== 'reject' && onFull !== 'wait') {\n throw new FamiliarInvalidOptionsError('`onFull` must be \"reject\" or \"wait\"');\n }\n\n validateTimeout(timeout);\n\n return { concurrency: resolvedConcurrency, maxQueue, onFull, timeout };\n}\n\nfunction isWorkerResponse<TOutput>(value: unknown): value is WorkerResponse<TOutput> {\n if (typeof value !== 'object' || value === null) return false;\n\n const response = value as Partial<WorkerResponse<TOutput>>;\n if (\n response.version !== PROTOCOL_VERSION ||\n typeof response.id !== 'number' ||\n !Number.isSafeInteger(response.id) ||\n response.id < 0\n )\n return false;\n\n if (response.kind === 'chunk' || response.kind === 'result') return 'value' in response;\n if (response.kind !== 'error' || typeof response.error !== 'object' || response.error === null) return false;\n\n return (\n (response.error.category === undefined || response.error.category === 'protocol') &&\n typeof response.error.message === 'string' &&\n typeof response.error.name === 'string' &&\n (response.error.stack === undefined || typeof response.error.stack === 'string')\n );\n}\n\nfunction responseError(error: SerializedError): FamiliarRuntimeError | FamiliarTaskError {\n const cause = new Error(error.message);\n\n cause.name = error.name;\n cause.stack = error.stack;\n\n return error.category === 'protocol'\n ? new FamiliarRuntimeError(error.message, { cause })\n : new FamiliarTaskError(error.message, { cause });\n}\n\nclass Slot<TInput, TOutput> implements SlotStrategy<TInput, TOutput>, StreamSlot<TInput, TOutput> {\n readonly #url: URL | string;\n #disposed = false;\n #pending: Pending<TOutput> | undefined;\n #taskId = 0;\n #worker: Worker | undefined;\n\n /** Wired by the pool factory to report unhandled worker runtime errors through `tap()`. */\n notify: ((error: FamiliarRuntimeError) => void) | undefined = undefined;\n\n constructor(url: URL | string) {\n this.#url = url;\n }\n\n cancel(reason: unknown): void {\n if (!this.#pending) return;\n this.#stopWorker();\n this.#settlePending('reject', reason);\n }\n\n run(input: TInput, transferables: Transferable[], timeout: number | undefined): Promise<TOutput> {\n return this.#dispatch(input, transferables, timeout, 'run') as Promise<TOutput>;\n }\n\n stream(input: TInput, options: RunOptions): RunningStream<TOutput> {\n const stop = () => this.cancel(new FamiliarTerminatedError('Stream consumer stopped'));\n const chunks: TOutput[] = [];\n const waiters: Array<(result: IteratorResult<TOutput>) => void> = [];\n let done = false;\n let error: unknown;\n const emit = (value: TOutput) => {\n const waiter = waiters.shift();\n\n if (waiter) waiter({ done: false, value });\n else chunks.push(value);\n };\n const finish = (reason?: unknown) => {\n done = true;\n error = reason;\n\n while (waiters.length > 0) {\n const waiter = waiters.shift()!;\n\n if (reason !== undefined) waiter(Promise.reject(reason) as never);\n else waiter({ done: true, value: undefined as never });\n }\n };\n const donePromise = this.#dispatch(input, [...(options.transferables ?? [])], options.timeout, 'stream', emit).then(\n () => finish(),\n (reason: unknown) => finish(reason),\n );\n\n return {\n done: donePromise,\n iterable: {\n [Symbol.asyncIterator]: () => ({\n async next(): Promise<IteratorResult<TOutput>> {\n if (chunks.length > 0) return { done: false, value: chunks.shift()! };\n\n if (error !== undefined) throw error;\n\n if (done) return { done: true, value: undefined as never };\n\n return new Promise<IteratorResult<TOutput>>((resolve, reject) => {\n waiters.push((result) => {\n if (result instanceof Promise) void result.then(resolve, reject);\n else resolve(result);\n });\n });\n },\n async return(): Promise<IteratorResult<TOutput>> {\n stop();\n\n return { done: true, value: undefined as never };\n },\n }),\n },\n };\n }\n\n terminate(): void {\n this.#disposed = true;\n this.#stopWorker();\n this.#settlePending('reject', new FamiliarTerminatedError());\n }\n\n #dispatch(\n input: TInput,\n transferables: Transferable[],\n timeout: number | undefined,\n kind: 'run' | 'stream',\n emit?: (value: TOutput) => void,\n ): Promise<TOutput> {\n if (this.#disposed) return Promise.reject(new FamiliarTerminatedError());\n\n if (this.#pending) return Promise.reject(new FamiliarRuntimeError('Worker slot is already busy'));\n\n try {\n const worker = this.#ensureWorker();\n const id = this.#taskId;\n this.#taskId = id === Number.MAX_SAFE_INTEGER ? 0 : id + 1;\n\n return new Promise<TOutput>((resolve, reject) => {\n const pending: Pending<TOutput> = { emit, id, kind, reject, resolve };\n\n this.#pending = pending;\n\n if (timeout !== undefined) {\n pending.timer = setTimeout(() => this.cancel(new FamiliarTimeoutError(timeout)), timeout);\n unrefTimer(pending.timer);\n }\n\n try {\n worker.postMessage({ id, input, kind, version: PROTOCOL_VERSION }, transferables);\n } catch (error) {\n this.cancel(new FamiliarRuntimeError('Failed to post message to worker', { cause: error }));\n }\n });\n } catch (error) {\n return Promise.reject(error);\n }\n }\n\n #ensureWorker(): Worker {\n if (this.#worker) return this.#worker;\n\n if (typeof Worker === 'undefined') throw new FamiliarRuntimeError('Worker API is unavailable in this runtime');\n\n try {\n const worker = new Worker(this.#url, { type: 'module' });\n\n worker.onmessage = (event: MessageEvent<unknown>) => {\n if (this.#worker === worker) this.#onMessage(event.data);\n };\n worker.onerror = (event) => this.#failWorker(worker, new FamiliarRuntimeError(event.message || 'Worker failed'));\n worker.onmessageerror = () =>\n this.#failWorker(worker, new FamiliarRuntimeError('Worker response could not be deserialized'));\n this.#worker = worker;\n\n return worker;\n } catch (error) {\n throw new FamiliarRuntimeError('Failed to create Worker', { cause: error });\n }\n }\n\n #stopWorker(): void {\n const worker = this.#worker;\n this.#worker = undefined;\n if (!worker) return;\n\n worker.onmessage = null;\n worker.onerror = null;\n worker.onmessageerror = null;\n worker.terminate();\n }\n\n #failWorker(worker: Worker, error: FamiliarRuntimeError): void {\n if (this.#worker !== worker) return;\n\n this.#stopWorker();\n this.#settlePending('reject', error);\n this.notify?.(error);\n }\n\n #onMessage(message: unknown): void {\n if (!this.#pending) return;\n\n if (\n !isWorkerResponse<TOutput>(message) ||\n message.id !== this.#pending.id ||\n (this.#pending.kind === 'run' && message.kind === 'chunk')\n ) {\n this.cancel(new FamiliarRuntimeError('Worker returned an incompatible protocol response'));\n\n return;\n }\n\n if (message.kind === 'chunk') {\n this.#pending.emit?.(message.value);\n\n return;\n }\n\n if (message.kind === 'error') {\n this.#settlePending('reject', responseError(message.error));\n\n return;\n }\n\n this.#settlePending('resolve', message.value);\n }\n\n #settlePending(kind: 'resolve' | 'reject', value: unknown): void {\n const pending = this.#pending;\n\n if (!pending) return;\n\n this.#pending = undefined;\n\n if (pending.timer) clearTimeout(pending.timer);\n\n if (kind === 'resolve') pending.resolve(value as TOutput);\n else pending.reject(value);\n }\n}\n\nfunction slots<TInput, TOutput>(url: URL | string, options: ResolvedOptions): Slot<TInput, TOutput>[] {\n const resolvedUrl = typeof url === 'string' ? url : url.href;\n return Array.from({ length: options.concurrency }, () => new Slot<TInput, TOutput>(resolvedUrl));\n}\n\n/** Create a pool backed by an ES module worker registered with exposeTask(). */\nexport function createWorker<TInput, TOutput>(\n url: URL | string,\n options: WorkerOptions = {},\n): WorkerPool<TInput, TOutput> {\n const resolved = resolveOptions(options);\n\n return createPool(slots<TInput, TOutput>(url, resolved), {\n defaultTimeout: resolved.timeout,\n maxQueue: resolved.maxQueue,\n onFull: resolved.onFull,\n });\n}\n\n/** Create a stream-only pool backed by an ES module worker registered with exposeStream(). */\nexport function createStreamWorker<TInput, TChunk>(\n url: URL | string,\n options: WorkerOptions = {},\n): StreamWorkerPool<TInput, TChunk> {\n const resolved = resolveOptions(options);\n\n return createStreamPool(slots<TInput, TChunk>(url, resolved), {\n defaultTimeout: resolved.timeout,\n maxQueue: resolved.maxQueue,\n onFull: resolved.onFull,\n });\n}\n"],"mappings":"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"}
|
package/dist/index.cjs
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./
|
|
1
|
+
Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./_pool.cjs"),t=require("./errors.cjs"),n=require("./worker.cjs");exports.FamiliarError=t.FamiliarError,exports.FamiliarInvalidOptionsError=t.FamiliarInvalidOptionsError,exports.FamiliarQueueFullError=t.FamiliarQueueFullError,exports.FamiliarRuntimeError=t.FamiliarRuntimeError,exports.FamiliarTaskError=t.FamiliarTaskError,exports.FamiliarTerminatedError=t.FamiliarTerminatedError,exports.FamiliarTimeoutError=t.FamiliarTimeoutError,exports.createStreamWorker=n.createStreamWorker,exports.createWorker=n.createWorker,exports.runBatch=e.runBatch;
|
package/dist/index.js
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import {
|
|
2
|
-
import {
|
|
1
|
+
import { runBatch as e } from "./_pool.js";
|
|
2
|
+
import { FamiliarError as t, FamiliarInvalidOptionsError as n, FamiliarQueueFullError as r, FamiliarRuntimeError as i, FamiliarTaskError as a, FamiliarTerminatedError as o, FamiliarTimeoutError as s } from "./errors.js";
|
|
3
3
|
import { createStreamWorker as c, createWorker as l } from "./worker.js";
|
|
4
|
-
export {
|
|
4
|
+
export { t as FamiliarError, n as FamiliarInvalidOptionsError, r as FamiliarQueueFullError, i as FamiliarRuntimeError, a as FamiliarTaskError, o as FamiliarTerminatedError, s as FamiliarTimeoutError, c as createStreamWorker, l as createWorker, e as runBatch };
|
package/dist/protocol.js
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
|
|
1
|
+
// src/protocol.ts
|
|
2
2
|
var e = 1;
|
|
3
3
|
function serializeError(e) {
|
|
4
4
|
let t = e instanceof Error ? e : Error(String(e));
|
|
@@ -73,7 +73,6 @@ function exposeStream(e) {
|
|
|
73
73
|
}
|
|
74
74
|
};
|
|
75
75
|
}
|
|
76
|
-
//#endregion
|
|
77
76
|
export { e as PROTOCOL_VERSION, exposeStream, exposeTask };
|
|
78
77
|
|
|
79
78
|
//# sourceMappingURL=protocol.js.map
|
package/dist/testing/testing.cjs
CHANGED
|
@@ -1,2 +1,2 @@
|
|
|
1
|
-
const e=require("../
|
|
1
|
+
const e=require("../_pool.cjs"),t=require("../_pool-core.cjs"),n=require("../errors.cjs");function createTestWorker(r,i={}){let{concurrency:a=1,maxQueue:o,onFull:s=`reject`,timeout:c}=i;if(!Number.isInteger(a)||a<1||a>512)throw new n.FamiliarInvalidOptionsError("`concurrency` must be a positive integer ≤ 512");if(o!==void 0&&(!Number.isInteger(o)||o<1))throw new n.FamiliarInvalidOptionsError("`maxQueue` must be a positive integer");if(s!==`reject`&&s!==`wait`)throw new n.FamiliarInvalidOptionsError('`onFull` must be "reject" or "wait"');t.validateTimeout(c);let l=[];function makeSlot(){let e,t=!1;return{cancel(t){e?.reject(t),e=void 0},run(i,a,o){if(t)return Promise.reject(new n.FamiliarTerminatedError);let s;try{s=structuredClone(i,{transfer:a})}catch(e){return Promise.reject(new n.FamiliarTaskError(`Failed to clone task input`,{cause:e}))}return new Promise((t,i)=>{let a=Symbol(`task`),c,settle=(t,n)=>{e?.token===a&&(e=void 0,c&&clearTimeout(c),t(n))},rejectTask=t=>{e?.token===a&&(e=void 0,c&&clearTimeout(c),l.push({input:s,reason:t,status:`rejected`}),i(t))};e={reject:rejectTask,token:a},o!==void 0&&(c=setTimeout(()=>rejectTask(new n.FamiliarTimeoutError(o)),o)),Promise.resolve().then(()=>r(s)).then(r=>{let i;try{i=structuredClone(r)}catch(e){rejectTask(new n.FamiliarTaskError(`Failed to clone task output`,{cause:e}));return}e?.token===a&&(l.push({input:s,status:`fulfilled`,value:i}),settle(t,i))},e=>{let t=e instanceof Error?e:Error(String(e));rejectTask(new n.FamiliarTaskError(t.message,{cause:t}))})})},terminate(){t=!0,e?.reject(new n.FamiliarTerminatedError),e=void 0}}}let u=e.createPool(Array.from({length:a},makeSlot),{defaultTimeout:c,maxQueue:o,onFull:s});return Object.defineProperty(u,"calls",{enumerable:!0,get:()=>l}),u}exports.FamiliarError=n.FamiliarError,exports.FamiliarInvalidOptionsError=n.FamiliarInvalidOptionsError,exports.FamiliarQueueFullError=n.FamiliarQueueFullError,exports.FamiliarRuntimeError=n.FamiliarRuntimeError,exports.FamiliarTaskError=n.FamiliarTaskError,exports.FamiliarTerminatedError=n.FamiliarTerminatedError,exports.FamiliarTimeoutError=n.FamiliarTimeoutError,exports.createTestWorker=createTestWorker;
|
|
2
2
|
//# sourceMappingURL=testing.cjs.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"testing.cjs","names":["FamiliarInvalidOptionsError","FamiliarTerminatedError","FamiliarTaskError","FamiliarTimeoutError","createPool","
|
|
1
|
+
{"version":3,"file":"testing.cjs","names":["FamiliarInvalidOptionsError","FamiliarTerminatedError","FamiliarTaskError","FamiliarTimeoutError","createPool","require__pool","require__pool_core","require_errors","options","concurrency","maxQueue","onFull","timeout","calls","current","terminated","reason","clonedInput","input","transferables","error","token","timer","fn","value","reject","timeoutMs","handler","clonedOutput","output","resolve","cause","pool"],"sources":["../../src/testing/testing.ts"],"sourcesContent":["import { createPool } from '../_pool.js';\nimport { MAX_CONCURRENCY, validateTimeout } from '../_pool-core.js';\nimport {\n FamiliarInvalidOptionsError,\n FamiliarTaskError,\n FamiliarTerminatedError,\n FamiliarTimeoutError,\n} from '../errors.js';\nimport type { SlotStrategy, WorkerOptions, WorkerPool } from '../types.js';\n\nexport type TestWorkerOptions = Omit<WorkerOptions, 'concurrency'> & { concurrency?: number };\n\nexport type TestWorkerCall<TInput, TOutput> =\n | { input: TInput; status: 'fulfilled'; value: TOutput }\n | { input: TInput; reason: unknown; status: 'rejected' };\n\nexport type TestWorkerHandle<TInput, TOutput> = WorkerPool<TInput, TOutput> & {\n readonly calls: ReadonlyArray<TestWorkerCall<TInput, TOutput>>;\n};\n\nexport function createTestWorker<TInput, TOutput>(\n handler: (input: TInput) => TOutput | Promise<TOutput>,\n options: TestWorkerOptions = {},\n): TestWorkerHandle<TInput, TOutput> {\n const { concurrency = 1, maxQueue, onFull = 'reject', timeout } = options;\n\n if (!Number.isInteger(concurrency) || concurrency < 1 || concurrency > MAX_CONCURRENCY) {\n throw new FamiliarInvalidOptionsError(`\\`concurrency\\` must be a positive integer ≤ ${MAX_CONCURRENCY}`);\n }\n\n if (maxQueue !== undefined && (!Number.isInteger(maxQueue) || maxQueue < 1)) {\n throw new FamiliarInvalidOptionsError('`maxQueue` must be a positive integer');\n }\n\n if (onFull !== 'reject' && onFull !== 'wait') {\n throw new FamiliarInvalidOptionsError('`onFull` must be \"reject\" or \"wait\"');\n }\n\n validateTimeout(timeout);\n\n const calls: TestWorkerCall<TInput, TOutput>[] = [];\n\n function makeSlot(): SlotStrategy<TInput, TOutput> {\n let current: { reject(reason: unknown): void; token: symbol } | undefined;\n let terminated = false;\n\n return {\n cancel(reason: unknown): void {\n current?.reject(reason);\n current = undefined;\n },\n run(input, transferables, timeoutMs): Promise<TOutput> {\n if (terminated) return Promise.reject(new FamiliarTerminatedError());\n\n let clonedInput: TInput;\n\n try {\n clonedInput = structuredClone(input, { transfer: transferables });\n } catch (error) {\n return Promise.reject(new FamiliarTaskError('Failed to clone task input', { cause: error }));\n }\n\n return new Promise<TOutput>((resolve, reject) => {\n const token = Symbol('task');\n let timer: ReturnType<typeof setTimeout> | undefined;\n const settle = (fn: (value: TOutput) => void, value: TOutput): void => {\n if (current?.token !== token) return;\n\n current = undefined;\n\n if (timer) clearTimeout(timer);\n\n fn(value);\n };\n const rejectTask = (reason: unknown): void => {\n if (current?.token !== token) return;\n\n current = undefined;\n\n if (timer) clearTimeout(timer);\n\n calls.push({ input: clonedInput, reason, status: 'rejected' });\n reject(reason);\n };\n\n current = { reject: rejectTask, token };\n\n if (timeoutMs !== undefined) {\n timer = setTimeout(() => rejectTask(new FamiliarTimeoutError(timeoutMs)), timeoutMs);\n }\n\n void Promise.resolve()\n .then(() => handler(clonedInput))\n .then(\n (output) => {\n let clonedOutput: TOutput;\n\n try {\n clonedOutput = structuredClone(output);\n } catch (error) {\n rejectTask(new FamiliarTaskError('Failed to clone task output', { cause: error }));\n\n return;\n }\n\n if (current?.token !== token) return;\n\n calls.push({ input: clonedInput, status: 'fulfilled', value: clonedOutput });\n settle(resolve, clonedOutput);\n },\n (error: unknown) => {\n const cause = error instanceof Error ? error : new Error(String(error));\n\n rejectTask(new FamiliarTaskError(cause.message, { cause }));\n },\n );\n });\n },\n terminate(): void {\n terminated = true;\n current?.reject(new FamiliarTerminatedError());\n current = undefined;\n },\n };\n }\n\n const pool = createPool(Array.from({ length: concurrency }, makeSlot), {\n defaultTimeout: timeout,\n maxQueue,\n onFull,\n });\n\n Object.defineProperty(pool, 'calls', {\n enumerable: true,\n get: () => calls as ReadonlyArray<TestWorkerCall<TInput, TOutput>>,\n });\n\n return pool as TestWorkerHandle<TInput, TOutput>;\n}\n\nexport {\n FamiliarError,\n FamiliarInvalidOptionsError,\n FamiliarQueueFullError,\n FamiliarRuntimeError,\n FamiliarTaskError,\n FamiliarTerminatedError,\n FamiliarTimeoutError,\n} from '../errors.js';\nexport type { WorkerPool } from '../types.js';\n"],"mappings":"A,0FAoBA,SAAgB,iBACd,EACA,EAA6B,CAAC,EACK,CACnC,GAAM,CAAE,cAAc,EAAG,WAAU,SAAS,SAAU,WAAYQ,EAElE,GAAI,CAAC,OAAO,UAAUC,CAAW,GAAKA,EAAc,GAAKA,EAAA,IACvD,MAAM,IAAIT,EAAAA,4BAA4B,gDAAiE,EAGzG,GAAIU,IAAa,IAAA,KAAc,CAAC,OAAO,UAAUA,CAAQ,GAAKA,EAAW,GACvE,MAAM,IAAIV,EAAAA,4BAA4B,uCAAuC,EAG/E,GAAIW,IAAW,UAAYA,IAAW,OACpC,MAAM,IAAIX,EAAAA,4BAA4B,qCAAqC,EAG7EM,EAAA,gBAAgBM,CAAO,EAEvB,IAAMC,EAA2C,CAAC,EAElD,SAAS,UAA0C,CACjD,IAAIC,EACAC,EAAa,GAEjB,MAAO,CACL,OAAO,EAAuB,CAC5BD,GAAS,OAAOE,CAAM,EACtB,EAAU,IAAA,EACZ,EACA,IAAI,EAAO,EAAe,EAA6B,CACrD,GAAID,EAAY,OAAO,QAAQ,OAAO,IAAId,EAAAA,uBAAyB,EAEnE,IAAIgB,EAEJ,GAAI,CACF,EAAc,gBAAgBC,EAAO,CAAE,SAAUC,CAAc,CAAC,CAClE,OAASC,EAAO,CACd,OAAO,QAAQ,OAAO,IAAIlB,EAAAA,kBAAkB,6BAA8B,CAAE,MAAOkB,CAAM,CAAC,CAAC,CAC7F,CAEA,OAAO,IAAI,SAAkB,EAAS,IAAW,CAC/C,IAAMC,EAAQ,OAAO,MAAM,EACvBC,EACE,QAAU,EAA8B,IAAyB,CACjER,GAAS,QAAUO,IAEvB,EAAU,IAAA,GAENC,GAAO,aAAaA,CAAK,EAE7BC,EAAGC,CAAK,EACV,EACM,WAAc,GAA0B,CACxCV,GAAS,QAAUO,IAEvB,EAAU,IAAA,GAENC,GAAO,aAAaA,CAAK,EAE7BT,EAAM,KAAK,CAAE,MAAOI,EAAa,SAAQ,OAAQ,UAAW,CAAC,EAC7DQ,EAAOT,CAAM,EACf,EAEA,EAAU,CAAE,OAAQ,WAAY,OAAM,EAElCU,IAAc,IAAA,KAChB,EAAQ,eAAiB,WAAW,IAAIvB,EAAAA,qBAAqBuB,CAAS,CAAC,EAAGA,CAAS,GAGrF,QAAa,QAAQ,CAAC,CACnB,SAAWC,EAAQV,CAAW,CAAC,CAAC,CAChC,KACE,GAAW,CACV,IAAIW,EAEJ,GAAI,CACF,EAAe,gBAAgBC,CAAM,CACvC,OAAST,EAAO,CACd,WAAW,IAAIlB,EAAAA,kBAAkB,8BAA+B,CAAE,MAAOkB,CAAM,CAAC,CAAC,EAEjF,MACF,CAEIN,GAAS,QAAUO,IAEvBR,EAAM,KAAK,CAAE,MAAOI,EAAa,OAAQ,YAAa,MAAOW,CAAa,CAAC,EAC3E,OAAOE,EAASF,CAAY,EAC9B,EACC,GAAmB,CAClB,IAAMG,EAAQX,aAAiB,MAAQA,EAAY,MAAM,OAAOA,CAAK,CAAC,EAEtE,WAAW,IAAIlB,EAAAA,kBAAkB6B,EAAM,QAAS,CAAE,OAAM,CAAC,CAAC,CAC5D,CACF,CACJ,CAAC,CACH,EACA,WAAkB,CAChB,EAAa,GACbjB,GAAS,OAAO,IAAIb,EAAAA,uBAAyB,EAC7C,EAAU,IAAA,EACZ,CACF,CACF,CAEA,IAAM+B,EAAO5B,EAAAA,WAAW,MAAM,KAAK,CAAE,OAAQK,CAAY,EAAG,QAAQ,EAAG,CACrE,eAAgBG,EAChB,WACA,QACF,CAAC,EAOD,OALA,OAAO,eAAeoB,EAAM,QAAS,CACnC,WAAY,GACZ,QAAWnB,CACb,CAAC,EAEMmB,CACT,C"}
|
package/dist/testing/testing.js
CHANGED
|
@@ -1,66 +1,66 @@
|
|
|
1
|
-
import {
|
|
2
|
-
import { validateTimeout as
|
|
3
|
-
import {
|
|
4
|
-
|
|
5
|
-
function createTestWorker(
|
|
6
|
-
let { concurrency:
|
|
7
|
-
if (!Number.isInteger(
|
|
8
|
-
if (l !== void 0 && (!Number.isInteger(l) || l < 1)) throw new
|
|
9
|
-
if (u !== "reject" && u !== "wait") throw new
|
|
10
|
-
|
|
1
|
+
import { createPool as e } from "../_pool.js";
|
|
2
|
+
import { validateTimeout as t } from "../_pool-core.js";
|
|
3
|
+
import { FamiliarError as n, FamiliarInvalidOptionsError as r, FamiliarQueueFullError as i, FamiliarRuntimeError as a, FamiliarTaskError as o, FamiliarTerminatedError as s, FamiliarTimeoutError as c } from "../errors.js";
|
|
4
|
+
// src/testing/testing.ts
|
|
5
|
+
function createTestWorker(n, i = {}) {
|
|
6
|
+
let { concurrency: a = 1, maxQueue: l, onFull: u = "reject", timeout: d } = i;
|
|
7
|
+
if (!Number.isInteger(a) || a < 1 || a > 512) throw new r("`concurrency` must be a positive integer ≤ 512");
|
|
8
|
+
if (l !== void 0 && (!Number.isInteger(l) || l < 1)) throw new r("`maxQueue` must be a positive integer");
|
|
9
|
+
if (u !== "reject" && u !== "wait") throw new r("`onFull` must be \"reject\" or \"wait\"");
|
|
10
|
+
t(d);
|
|
11
11
|
let f = [];
|
|
12
12
|
function makeSlot() {
|
|
13
|
-
let
|
|
13
|
+
let e, t = !1;
|
|
14
14
|
return {
|
|
15
|
-
cancel(
|
|
16
|
-
|
|
15
|
+
cancel(t) {
|
|
16
|
+
e?.reject(t), e = void 0;
|
|
17
17
|
},
|
|
18
|
-
run(r,
|
|
19
|
-
if (
|
|
18
|
+
run(r, i, a) {
|
|
19
|
+
if (t) return Promise.reject(new s());
|
|
20
20
|
let l;
|
|
21
21
|
try {
|
|
22
|
-
l = structuredClone(r, { transfer:
|
|
22
|
+
l = structuredClone(r, { transfer: i });
|
|
23
23
|
} catch (e) {
|
|
24
|
-
return Promise.reject(new
|
|
24
|
+
return Promise.reject(new o("Failed to clone task input", { cause: e }));
|
|
25
25
|
}
|
|
26
|
-
return new Promise((
|
|
27
|
-
let
|
|
28
|
-
|
|
29
|
-
}, rejectTask = (
|
|
30
|
-
|
|
26
|
+
return new Promise((t, r) => {
|
|
27
|
+
let i = Symbol("task"), s, settle = (t, n) => {
|
|
28
|
+
e?.token === i && (e = void 0, s && clearTimeout(s), t(n));
|
|
29
|
+
}, rejectTask = (t) => {
|
|
30
|
+
e?.token === i && (e = void 0, s && clearTimeout(s), f.push({
|
|
31
31
|
input: l,
|
|
32
|
-
reason:
|
|
32
|
+
reason: t,
|
|
33
33
|
status: "rejected"
|
|
34
|
-
}), r(
|
|
34
|
+
}), r(t));
|
|
35
35
|
};
|
|
36
|
-
|
|
36
|
+
e = {
|
|
37
37
|
reject: rejectTask,
|
|
38
|
-
token:
|
|
39
|
-
},
|
|
38
|
+
token: i
|
|
39
|
+
}, a !== void 0 && (s = setTimeout(() => rejectTask(new c(a)), a)), Promise.resolve().then(() => n(l)).then((n) => {
|
|
40
40
|
let r;
|
|
41
41
|
try {
|
|
42
|
-
r = structuredClone(
|
|
42
|
+
r = structuredClone(n);
|
|
43
43
|
} catch (e) {
|
|
44
|
-
rejectTask(new
|
|
44
|
+
rejectTask(new o("Failed to clone task output", { cause: e }));
|
|
45
45
|
return;
|
|
46
46
|
}
|
|
47
|
-
|
|
47
|
+
e?.token === i && (f.push({
|
|
48
48
|
input: l,
|
|
49
49
|
status: "fulfilled",
|
|
50
50
|
value: r
|
|
51
|
-
}), settle(
|
|
51
|
+
}), settle(t, r));
|
|
52
52
|
}, (e) => {
|
|
53
53
|
let t = e instanceof Error ? e : Error(String(e));
|
|
54
|
-
rejectTask(new
|
|
54
|
+
rejectTask(new o(t.message, { cause: t }));
|
|
55
55
|
});
|
|
56
56
|
});
|
|
57
57
|
},
|
|
58
58
|
terminate() {
|
|
59
|
-
|
|
59
|
+
t = !0, e?.reject(new s()), e = void 0;
|
|
60
60
|
}
|
|
61
61
|
};
|
|
62
62
|
}
|
|
63
|
-
let p =
|
|
63
|
+
let p = e(Array.from({ length: a }, makeSlot), {
|
|
64
64
|
defaultTimeout: d,
|
|
65
65
|
maxQueue: l,
|
|
66
66
|
onFull: u
|
|
@@ -70,7 +70,6 @@ function createTestWorker(e, n = {}) {
|
|
|
70
70
|
get: () => f
|
|
71
71
|
}), p;
|
|
72
72
|
}
|
|
73
|
-
|
|
74
|
-
export { e as FamiliarError, t as FamiliarInvalidOptionsError, n as FamiliarQueueFullError, r as FamiliarRuntimeError, i as FamiliarTaskError, a as FamiliarTerminatedError, o as FamiliarTimeoutError, createTestWorker };
|
|
73
|
+
export { n as FamiliarError, r as FamiliarInvalidOptionsError, i as FamiliarQueueFullError, a as FamiliarRuntimeError, o as FamiliarTaskError, s as FamiliarTerminatedError, c as FamiliarTimeoutError, createTestWorker };
|
|
75
74
|
|
|
76
75
|
//# sourceMappingURL=testing.js.map
|
package/dist/worker.cjs
CHANGED
|
@@ -1,2 +1,2 @@
|
|
|
1
|
-
const e=require("./
|
|
1
|
+
const e=require("./_pool.cjs"),t=require("./_pool-core.cjs"),n=require("./_stream-pool.cjs"),r=require("./_timers.cjs"),i=require("./errors.cjs");require("./protocol.cjs");function resolveOptions(e={}){let{concurrency:n=1,maxQueue:r,onFull:a=`reject`,timeout:o}=e,s=n===`auto`?Math.min(512,Math.max(1,globalThis.navigator?.hardwareConcurrency??1)):n;if(!Number.isInteger(s)||s<1||s>512)throw new i.FamiliarInvalidOptionsError('`concurrency` must be a positive integer ≤ 512 or "auto"');if(r!==void 0&&(!Number.isInteger(r)||r<1))throw new i.FamiliarInvalidOptionsError("`maxQueue` must be a positive integer");if(a!==`reject`&&a!==`wait`)throw new i.FamiliarInvalidOptionsError('`onFull` must be "reject" or "wait"');return t.validateTimeout(o),{concurrency:s,maxQueue:r,onFull:a,timeout:o}}function isWorkerResponse(e){if(typeof e!=`object`||!e)return!1;let t=e;return t.version!==1||typeof t.id!=`number`||!Number.isSafeInteger(t.id)||t.id<0?!1:t.kind===`chunk`||t.kind===`result`?`value`in t:t.kind!==`error`||typeof t.error!=`object`||t.error===null?!1:(t.error.category===void 0||t.error.category===`protocol`)&&typeof t.error.message==`string`&&typeof t.error.name==`string`&&(t.error.stack===void 0||typeof t.error.stack==`string`)}function responseError(e){let t=Error(e.message);return t.name=e.name,t.stack=e.stack,e.category===`protocol`?new i.FamiliarRuntimeError(e.message,{cause:t}):new i.FamiliarTaskError(e.message,{cause:t})}var Slot=class{#e;#t=!1;#n;#r=0;#i;notify=void 0;constructor(e){this.#e=e}cancel(e){this.#n&&(this.#s(),this.#u(`reject`,e))}run(e,t,n){return this.#a(e,t,n,`run`)}stream(e,t){let stop=()=>this.cancel(new i.FamiliarTerminatedError(`Stream consumer stopped`)),n=[],r=[],a=!1,o,emit=e=>{let t=r.shift();t?t({done:!1,value:e}):n.push(e)},finish=e=>{for(a=!0,o=e;r.length>0;)r.shift()(e===void 0?{done:!0,value:void 0}:Promise.reject(e))};return{done:this.#a(e,[...t.transferables??[]],t.timeout,`stream`,emit).then(()=>finish(),e=>finish(e)),iterable:{[Symbol.asyncIterator]:()=>({async next(){if(n.length>0)return{done:!1,value:n.shift()};if(o!==void 0)throw o;return a?{done:!0,value:void 0}:new Promise((e,t)=>{r.push(n=>{n instanceof Promise?n.then(e,t):e(n)})})},async return(){return stop(),{done:!0,value:void 0}}})}}}terminate(){this.#t=!0,this.#s(),this.#u(`reject`,new i.FamiliarTerminatedError)}#a(e,t,n,a,o){if(this.#t)return Promise.reject(new i.FamiliarTerminatedError);if(this.#n)return Promise.reject(new i.FamiliarRuntimeError(`Worker slot is already busy`));try{let s=this.#o(),c=this.#r;return this.#r=c===2**53-1?0:c+1,new Promise((l,u)=>{let d={emit:o,id:c,kind:a,reject:u,resolve:l};this.#n=d,n!==void 0&&(d.timer=setTimeout(()=>this.cancel(new i.FamiliarTimeoutError(n)),n),r.unrefTimer(d.timer));try{s.postMessage({id:c,input:e,kind:a,version:1},t)}catch(e){this.cancel(new i.FamiliarRuntimeError(`Failed to post message to worker`,{cause:e}))}})}catch(e){return Promise.reject(e)}}#o(){if(this.#i)return this.#i;if(typeof Worker>`u`)throw new i.FamiliarRuntimeError(`Worker API is unavailable in this runtime`);try{let e=new Worker(this.#e,{type:`module`});return e.onmessage=t=>{this.#i===e&&this.#l(t.data)},e.onerror=t=>this.#c(e,new i.FamiliarRuntimeError(t.message||`Worker failed`)),e.onmessageerror=()=>this.#c(e,new i.FamiliarRuntimeError(`Worker response could not be deserialized`)),this.#i=e,e}catch(e){throw new i.FamiliarRuntimeError(`Failed to create Worker`,{cause:e})}}#s(){let e=this.#i;this.#i=void 0,e&&(e.onmessage=null,e.onerror=null,e.onmessageerror=null,e.terminate())}#c(e,t){this.#i===e&&(this.#s(),this.#u(`reject`,t),this.notify?.(t))}#l(e){this.#n&&(!isWorkerResponse(e)||e.id!==this.#n.id||this.#n.kind===`run`&&e.kind===`chunk`?this.cancel(new i.FamiliarRuntimeError(`Worker returned an incompatible protocol response`)):e.kind===`chunk`?this.#n.emit?.(e.value):e.kind===`error`?this.#u(`reject`,responseError(e.error)):this.#u(`resolve`,e.value))}#u(e,t){let n=this.#n;n&&(this.#n=void 0,n.timer&&clearTimeout(n.timer),e===`resolve`?n.resolve(t):n.reject(t))}};function slots(e,t){let n=typeof e==`string`?e:e.href;return Array.from({length:t.concurrency},()=>new Slot(n))}function createWorker(t,n={}){let r=resolveOptions(n);return e.createPool(slots(t,r),{defaultTimeout:r.timeout,maxQueue:r.maxQueue,onFull:r.onFull})}function createStreamWorker(e,t={}){let r=resolveOptions(t);return n.createStreamPool(slots(e,r),{defaultTimeout:r.timeout,maxQueue:r.maxQueue,onFull:r.onFull})}exports.createStreamWorker=createStreamWorker,exports.createWorker=createWorker;
|
|
2
2
|
//# sourceMappingURL=worker.cjs.map
|
package/dist/worker.cjs.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"worker.cjs","names":["FamiliarInvalidOptionsError","FamiliarRuntimeError","FamiliarTaskError","FamiliarTerminatedError","FamiliarTimeoutError","createPool","createStreamPool","require__timers","require_errors","require__pool_core","require__pool","require__stream_pool","options","resolvedConcurrency","concurrency","maxQueue","onFull","timeout","value","response","cause","error","#url","url","#pending","#stopWorker","#settlePending","reason","#dispatch","input","transferables","chunks","waiters","done","waiter","result","resolve","reject","#disposed","worker","#ensureWorker","id","#taskId","pending","#worker","#onMessage","event","#failWorker","message","kind","resolvedUrl","resolved"],"sources":["../src/worker.ts"],"sourcesContent":["import { createPool } from './_pool.js';\nimport { MAX_CONCURRENCY, validateTimeout } from './_pool-core.js';\nimport { createStreamPool, type StreamSlot } from './_stream-pool.js';\nimport { unrefTimer } from './_timers.js';\nimport {\n FamiliarInvalidOptionsError,\n FamiliarRuntimeError,\n FamiliarTaskError,\n FamiliarTerminatedError,\n FamiliarTimeoutError,\n} from './errors.js';\nimport type { SerializedError, WorkerResponse } from './protocol.js';\nimport { PROTOCOL_VERSION } from './protocol.js';\nimport type { RunOptions, SlotStrategy, StreamWorkerPool, WorkerOptions, WorkerPool } from './types.js';\n\ntype ResolvedOptions = {\n concurrency: number;\n maxQueue: number | undefined;\n onFull: 'reject' | 'wait';\n timeout: number | undefined;\n};\n\ntype Pending<TOutput> = {\n emit?: (value: TOutput) => void;\n id: number;\n kind: 'run' | 'stream';\n reject: (reason: unknown) => void;\n resolve: (value: TOutput) => void;\n timer?: ReturnType<typeof setTimeout>;\n};\n\ntype RunningStream<TChunk> = {\n done: Promise<void>;\n iterable: AsyncIterable<TChunk>;\n};\n\nfunction resolveOptions(options: WorkerOptions = {}): ResolvedOptions {\n const { concurrency = 1, maxQueue, onFull = 'reject', timeout } = options;\n const resolvedConcurrency =\n concurrency === 'auto'\n ? Math.min(MAX_CONCURRENCY, Math.max(1, globalThis.navigator?.hardwareConcurrency ?? 1))\n : concurrency;\n\n if (!Number.isInteger(resolvedConcurrency) || resolvedConcurrency < 1 || resolvedConcurrency > MAX_CONCURRENCY) {\n throw new FamiliarInvalidOptionsError(`\\`concurrency\\` must be a positive integer ≤ ${MAX_CONCURRENCY} or \"auto\"`);\n }\n\n if (maxQueue !== undefined && (!Number.isInteger(maxQueue) || maxQueue < 1)) {\n throw new FamiliarInvalidOptionsError('`maxQueue` must be a positive integer');\n }\n\n if (onFull !== 'reject' && onFull !== 'wait') {\n throw new FamiliarInvalidOptionsError('`onFull` must be \"reject\" or \"wait\"');\n }\n\n validateTimeout(timeout);\n\n return { concurrency: resolvedConcurrency, maxQueue, onFull, timeout };\n}\n\nfunction isWorkerResponse<TOutput>(value: unknown): value is WorkerResponse<TOutput> {\n if (typeof value !== 'object' || value === null) return false;\n\n const response = value as Partial<WorkerResponse<TOutput>>;\n if (\n response.version !== PROTOCOL_VERSION ||\n typeof response.id !== 'number' ||\n !Number.isSafeInteger(response.id) ||\n response.id < 0\n )\n return false;\n\n if (response.kind === 'chunk' || response.kind === 'result') return 'value' in response;\n if (response.kind !== 'error' || typeof response.error !== 'object' || response.error === null) return false;\n\n return (\n (response.error.category === undefined || response.error.category === 'protocol') &&\n typeof response.error.message === 'string' &&\n typeof response.error.name === 'string' &&\n (response.error.stack === undefined || typeof response.error.stack === 'string')\n );\n}\n\nfunction responseError(error: SerializedError): FamiliarRuntimeError | FamiliarTaskError {\n const cause = new Error(error.message);\n\n cause.name = error.name;\n cause.stack = error.stack;\n\n return error.category === 'protocol'\n ? new FamiliarRuntimeError(error.message, { cause })\n : new FamiliarTaskError(error.message, { cause });\n}\n\nclass Slot<TInput, TOutput> implements SlotStrategy<TInput, TOutput>, StreamSlot<TInput, TOutput> {\n readonly #url: URL | string;\n #disposed = false;\n #pending: Pending<TOutput> | undefined;\n #taskId = 0;\n #worker: Worker | undefined;\n\n /** Wired by the pool factory to report unhandled worker runtime errors through `tap()`. */\n notify: ((error: FamiliarRuntimeError) => void) | undefined = undefined;\n\n constructor(url: URL | string) {\n this.#url = url;\n }\n\n cancel(reason: unknown): void {\n if (!this.#pending) return;\n this.#stopWorker();\n this.#settlePending('reject', reason);\n }\n\n run(input: TInput, transferables: Transferable[], timeout: number | undefined): Promise<TOutput> {\n return this.#dispatch(input, transferables, timeout, 'run') as Promise<TOutput>;\n }\n\n stream(input: TInput, options: RunOptions): RunningStream<TOutput> {\n const stop = () => this.cancel(new FamiliarTerminatedError('Stream consumer stopped'));\n const chunks: TOutput[] = [];\n const waiters: Array<(result: IteratorResult<TOutput>) => void> = [];\n let done = false;\n let error: unknown;\n const emit = (value: TOutput) => {\n const waiter = waiters.shift();\n\n if (waiter) waiter({ done: false, value });\n else chunks.push(value);\n };\n const finish = (reason?: unknown) => {\n done = true;\n error = reason;\n\n while (waiters.length > 0) {\n const waiter = waiters.shift()!;\n\n if (reason !== undefined) waiter(Promise.reject(reason) as never);\n else waiter({ done: true, value: undefined as never });\n }\n };\n const donePromise = this.#dispatch(input, [...(options.transferables ?? [])], options.timeout, 'stream', emit).then(\n () => finish(),\n (reason: unknown) => finish(reason),\n );\n\n return {\n done: donePromise,\n iterable: {\n [Symbol.asyncIterator]: () => ({\n async next(): Promise<IteratorResult<TOutput>> {\n if (chunks.length > 0) return { done: false, value: chunks.shift()! };\n\n if (error !== undefined) throw error;\n\n if (done) return { done: true, value: undefined as never };\n\n return new Promise<IteratorResult<TOutput>>((resolve, reject) => {\n waiters.push((result) => {\n if (result instanceof Promise) void result.then(resolve, reject);\n else resolve(result);\n });\n });\n },\n async return(): Promise<IteratorResult<TOutput>> {\n stop();\n\n return { done: true, value: undefined as never };\n },\n }),\n },\n };\n }\n\n terminate(): void {\n this.#disposed = true;\n this.#stopWorker();\n this.#settlePending('reject', new FamiliarTerminatedError());\n }\n\n #dispatch(\n input: TInput,\n transferables: Transferable[],\n timeout: number | undefined,\n kind: 'run' | 'stream',\n emit?: (value: TOutput) => void,\n ): Promise<TOutput> {\n if (this.#disposed) return Promise.reject(new FamiliarTerminatedError());\n\n if (this.#pending) return Promise.reject(new FamiliarRuntimeError('Worker slot is already busy'));\n\n try {\n const worker = this.#ensureWorker();\n const id = this.#taskId;\n this.#taskId = id === Number.MAX_SAFE_INTEGER ? 0 : id + 1;\n\n return new Promise<TOutput>((resolve, reject) => {\n const pending: Pending<TOutput> = { emit, id, kind, reject, resolve };\n\n this.#pending = pending;\n\n if (timeout !== undefined) {\n pending.timer = setTimeout(() => this.cancel(new FamiliarTimeoutError(timeout)), timeout);\n unrefTimer(pending.timer);\n }\n\n try {\n worker.postMessage({ id, input, kind, version: PROTOCOL_VERSION }, transferables);\n } catch (error) {\n this.cancel(new FamiliarRuntimeError('Failed to post message to worker', { cause: error }));\n }\n });\n } catch (error) {\n return Promise.reject(error);\n }\n }\n\n #ensureWorker(): Worker {\n if (this.#worker) return this.#worker;\n\n if (typeof Worker === 'undefined') throw new FamiliarRuntimeError('Worker API is unavailable in this runtime');\n\n try {\n const worker = new Worker(this.#url, { type: 'module' });\n\n worker.onmessage = (event: MessageEvent<unknown>) => {\n if (this.#worker === worker) this.#onMessage(event.data);\n };\n worker.onerror = (event) => this.#failWorker(worker, new FamiliarRuntimeError(event.message || 'Worker failed'));\n worker.onmessageerror = () =>\n this.#failWorker(worker, new FamiliarRuntimeError('Worker response could not be deserialized'));\n this.#worker = worker;\n\n return worker;\n } catch (error) {\n throw new FamiliarRuntimeError('Failed to create Worker', { cause: error });\n }\n }\n\n #stopWorker(): void {\n const worker = this.#worker;\n this.#worker = undefined;\n if (!worker) return;\n\n worker.onmessage = null;\n worker.onerror = null;\n worker.onmessageerror = null;\n worker.terminate();\n }\n\n #failWorker(worker: Worker, error: FamiliarRuntimeError): void {\n if (this.#worker !== worker) return;\n\n this.#stopWorker();\n this.#settlePending('reject', error);\n this.notify?.(error);\n }\n\n #onMessage(message: unknown): void {\n if (!this.#pending) return;\n\n if (\n !isWorkerResponse<TOutput>(message) ||\n message.id !== this.#pending.id ||\n (this.#pending.kind === 'run' && message.kind === 'chunk')\n ) {\n this.cancel(new FamiliarRuntimeError('Worker returned an incompatible protocol response'));\n\n return;\n }\n\n if (message.kind === 'chunk') {\n this.#pending.emit?.(message.value);\n\n return;\n }\n\n if (message.kind === 'error') {\n this.#settlePending('reject', responseError(message.error));\n\n return;\n }\n\n this.#settlePending('resolve', message.value);\n }\n\n #settlePending(kind: 'resolve' | 'reject', value: unknown): void {\n const pending = this.#pending;\n\n if (!pending) return;\n\n this.#pending = undefined;\n\n if (pending.timer) clearTimeout(pending.timer);\n\n if (kind === 'resolve') pending.resolve(value as TOutput);\n else pending.reject(value);\n }\n}\n\nfunction slots<TInput, TOutput>(url: URL | string, options: ResolvedOptions): Slot<TInput, TOutput>[] {\n const resolvedUrl = typeof url === 'string' ? url : url.href;\n return Array.from({ length: options.concurrency }, () => new Slot<TInput, TOutput>(resolvedUrl));\n}\n\n/** Create a pool backed by an ES module worker registered with exposeTask(). */\nexport function createWorker<TInput, TOutput>(\n url: URL | string,\n options: WorkerOptions = {},\n): WorkerPool<TInput, TOutput> {\n const resolved = resolveOptions(options);\n\n return createPool(slots<TInput, TOutput>(url, resolved), {\n defaultTimeout: resolved.timeout,\n maxQueue: resolved.maxQueue,\n onFull: resolved.onFull,\n });\n}\n\n/** Create a stream-only pool backed by an ES module worker registered with exposeStream(). */\nexport function createStreamWorker<TInput, TChunk>(\n url: URL | string,\n options: WorkerOptions = {},\n): StreamWorkerPool<TInput, TChunk> {\n const resolved = resolveOptions(options);\n\n return createStreamPool(slots<TInput, TChunk>(url, resolved), {\n defaultTimeout: resolved.timeout,\n maxQueue: resolved.maxQueue,\n onFull: resolved.onFull,\n });\n}\n"],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"worker.cjs","names":["FamiliarInvalidOptionsError","FamiliarRuntimeError","FamiliarTaskError","FamiliarTerminatedError","FamiliarTimeoutError","createPool","createStreamPool","require__pool","require__pool_core","require__stream_pool","require__timers","require_errors","options","resolvedConcurrency","concurrency","maxQueue","onFull","timeout","value","response","cause","error","#url","url","#pending","#stopWorker","#settlePending","reason","#dispatch","input","transferables","chunks","waiters","done","waiter","result","resolve","reject","#disposed","worker","#ensureWorker","id","#taskId","pending","#worker","#onMessage","event","#failWorker","message","kind","resolvedUrl","resolved"],"sources":["../src/worker.ts"],"sourcesContent":["import { createPool } from './_pool.js';\nimport { MAX_CONCURRENCY, validateTimeout } from './_pool-core.js';\nimport { createStreamPool, type StreamSlot } from './_stream-pool.js';\nimport { unrefTimer } from './_timers.js';\nimport {\n FamiliarInvalidOptionsError,\n FamiliarRuntimeError,\n FamiliarTaskError,\n FamiliarTerminatedError,\n FamiliarTimeoutError,\n} from './errors.js';\nimport type { SerializedError, WorkerResponse } from './protocol.js';\nimport { PROTOCOL_VERSION } from './protocol.js';\nimport type { RunOptions, SlotStrategy, StreamWorkerPool, WorkerOptions, WorkerPool } from './types.js';\n\ntype ResolvedOptions = {\n concurrency: number;\n maxQueue: number | undefined;\n onFull: 'reject' | 'wait';\n timeout: number | undefined;\n};\n\ntype Pending<TOutput> = {\n emit?: (value: TOutput) => void;\n id: number;\n kind: 'run' | 'stream';\n reject: (reason: unknown) => void;\n resolve: (value: TOutput) => void;\n timer?: ReturnType<typeof setTimeout>;\n};\n\ntype RunningStream<TChunk> = {\n done: Promise<void>;\n iterable: AsyncIterable<TChunk>;\n};\n\nfunction resolveOptions(options: WorkerOptions = {}): ResolvedOptions {\n const { concurrency = 1, maxQueue, onFull = 'reject', timeout } = options;\n const resolvedConcurrency =\n concurrency === 'auto'\n ? Math.min(MAX_CONCURRENCY, Math.max(1, globalThis.navigator?.hardwareConcurrency ?? 1))\n : concurrency;\n\n if (!Number.isInteger(resolvedConcurrency) || resolvedConcurrency < 1 || resolvedConcurrency > MAX_CONCURRENCY) {\n throw new FamiliarInvalidOptionsError(`\\`concurrency\\` must be a positive integer ≤ ${MAX_CONCURRENCY} or \"auto\"`);\n }\n\n if (maxQueue !== undefined && (!Number.isInteger(maxQueue) || maxQueue < 1)) {\n throw new FamiliarInvalidOptionsError('`maxQueue` must be a positive integer');\n }\n\n if (onFull !== 'reject' && onFull !== 'wait') {\n throw new FamiliarInvalidOptionsError('`onFull` must be \"reject\" or \"wait\"');\n }\n\n validateTimeout(timeout);\n\n return { concurrency: resolvedConcurrency, maxQueue, onFull, timeout };\n}\n\nfunction isWorkerResponse<TOutput>(value: unknown): value is WorkerResponse<TOutput> {\n if (typeof value !== 'object' || value === null) return false;\n\n const response = value as Partial<WorkerResponse<TOutput>>;\n if (\n response.version !== PROTOCOL_VERSION ||\n typeof response.id !== 'number' ||\n !Number.isSafeInteger(response.id) ||\n response.id < 0\n )\n return false;\n\n if (response.kind === 'chunk' || response.kind === 'result') return 'value' in response;\n if (response.kind !== 'error' || typeof response.error !== 'object' || response.error === null) return false;\n\n return (\n (response.error.category === undefined || response.error.category === 'protocol') &&\n typeof response.error.message === 'string' &&\n typeof response.error.name === 'string' &&\n (response.error.stack === undefined || typeof response.error.stack === 'string')\n );\n}\n\nfunction responseError(error: SerializedError): FamiliarRuntimeError | FamiliarTaskError {\n const cause = new Error(error.message);\n\n cause.name = error.name;\n cause.stack = error.stack;\n\n return error.category === 'protocol'\n ? new FamiliarRuntimeError(error.message, { cause })\n : new FamiliarTaskError(error.message, { cause });\n}\n\nclass Slot<TInput, TOutput> implements SlotStrategy<TInput, TOutput>, StreamSlot<TInput, TOutput> {\n readonly #url: URL | string;\n #disposed = false;\n #pending: Pending<TOutput> | undefined;\n #taskId = 0;\n #worker: Worker | undefined;\n\n /** Wired by the pool factory to report unhandled worker runtime errors through `tap()`. */\n notify: ((error: FamiliarRuntimeError) => void) | undefined = undefined;\n\n constructor(url: URL | string) {\n this.#url = url;\n }\n\n cancel(reason: unknown): void {\n if (!this.#pending) return;\n this.#stopWorker();\n this.#settlePending('reject', reason);\n }\n\n run(input: TInput, transferables: Transferable[], timeout: number | undefined): Promise<TOutput> {\n return this.#dispatch(input, transferables, timeout, 'run') as Promise<TOutput>;\n }\n\n stream(input: TInput, options: RunOptions): RunningStream<TOutput> {\n const stop = () => this.cancel(new FamiliarTerminatedError('Stream consumer stopped'));\n const chunks: TOutput[] = [];\n const waiters: Array<(result: IteratorResult<TOutput>) => void> = [];\n let done = false;\n let error: unknown;\n const emit = (value: TOutput) => {\n const waiter = waiters.shift();\n\n if (waiter) waiter({ done: false, value });\n else chunks.push(value);\n };\n const finish = (reason?: unknown) => {\n done = true;\n error = reason;\n\n while (waiters.length > 0) {\n const waiter = waiters.shift()!;\n\n if (reason !== undefined) waiter(Promise.reject(reason) as never);\n else waiter({ done: true, value: undefined as never });\n }\n };\n const donePromise = this.#dispatch(input, [...(options.transferables ?? [])], options.timeout, 'stream', emit).then(\n () => finish(),\n (reason: unknown) => finish(reason),\n );\n\n return {\n done: donePromise,\n iterable: {\n [Symbol.asyncIterator]: () => ({\n async next(): Promise<IteratorResult<TOutput>> {\n if (chunks.length > 0) return { done: false, value: chunks.shift()! };\n\n if (error !== undefined) throw error;\n\n if (done) return { done: true, value: undefined as never };\n\n return new Promise<IteratorResult<TOutput>>((resolve, reject) => {\n waiters.push((result) => {\n if (result instanceof Promise) void result.then(resolve, reject);\n else resolve(result);\n });\n });\n },\n async return(): Promise<IteratorResult<TOutput>> {\n stop();\n\n return { done: true, value: undefined as never };\n },\n }),\n },\n };\n }\n\n terminate(): void {\n this.#disposed = true;\n this.#stopWorker();\n this.#settlePending('reject', new FamiliarTerminatedError());\n }\n\n #dispatch(\n input: TInput,\n transferables: Transferable[],\n timeout: number | undefined,\n kind: 'run' | 'stream',\n emit?: (value: TOutput) => void,\n ): Promise<TOutput> {\n if (this.#disposed) return Promise.reject(new FamiliarTerminatedError());\n\n if (this.#pending) return Promise.reject(new FamiliarRuntimeError('Worker slot is already busy'));\n\n try {\n const worker = this.#ensureWorker();\n const id = this.#taskId;\n this.#taskId = id === Number.MAX_SAFE_INTEGER ? 0 : id + 1;\n\n return new Promise<TOutput>((resolve, reject) => {\n const pending: Pending<TOutput> = { emit, id, kind, reject, resolve };\n\n this.#pending = pending;\n\n if (timeout !== undefined) {\n pending.timer = setTimeout(() => this.cancel(new FamiliarTimeoutError(timeout)), timeout);\n unrefTimer(pending.timer);\n }\n\n try {\n worker.postMessage({ id, input, kind, version: PROTOCOL_VERSION }, transferables);\n } catch (error) {\n this.cancel(new FamiliarRuntimeError('Failed to post message to worker', { cause: error }));\n }\n });\n } catch (error) {\n return Promise.reject(error);\n }\n }\n\n #ensureWorker(): Worker {\n if (this.#worker) return this.#worker;\n\n if (typeof Worker === 'undefined') throw new FamiliarRuntimeError('Worker API is unavailable in this runtime');\n\n try {\n const worker = new Worker(this.#url, { type: 'module' });\n\n worker.onmessage = (event: MessageEvent<unknown>) => {\n if (this.#worker === worker) this.#onMessage(event.data);\n };\n worker.onerror = (event) => this.#failWorker(worker, new FamiliarRuntimeError(event.message || 'Worker failed'));\n worker.onmessageerror = () =>\n this.#failWorker(worker, new FamiliarRuntimeError('Worker response could not be deserialized'));\n this.#worker = worker;\n\n return worker;\n } catch (error) {\n throw new FamiliarRuntimeError('Failed to create Worker', { cause: error });\n }\n }\n\n #stopWorker(): void {\n const worker = this.#worker;\n this.#worker = undefined;\n if (!worker) return;\n\n worker.onmessage = null;\n worker.onerror = null;\n worker.onmessageerror = null;\n worker.terminate();\n }\n\n #failWorker(worker: Worker, error: FamiliarRuntimeError): void {\n if (this.#worker !== worker) return;\n\n this.#stopWorker();\n this.#settlePending('reject', error);\n this.notify?.(error);\n }\n\n #onMessage(message: unknown): void {\n if (!this.#pending) return;\n\n if (\n !isWorkerResponse<TOutput>(message) ||\n message.id !== this.#pending.id ||\n (this.#pending.kind === 'run' && message.kind === 'chunk')\n ) {\n this.cancel(new FamiliarRuntimeError('Worker returned an incompatible protocol response'));\n\n return;\n }\n\n if (message.kind === 'chunk') {\n this.#pending.emit?.(message.value);\n\n return;\n }\n\n if (message.kind === 'error') {\n this.#settlePending('reject', responseError(message.error));\n\n return;\n }\n\n this.#settlePending('resolve', message.value);\n }\n\n #settlePending(kind: 'resolve' | 'reject', value: unknown): void {\n const pending = this.#pending;\n\n if (!pending) return;\n\n this.#pending = undefined;\n\n if (pending.timer) clearTimeout(pending.timer);\n\n if (kind === 'resolve') pending.resolve(value as TOutput);\n else pending.reject(value);\n }\n}\n\nfunction slots<TInput, TOutput>(url: URL | string, options: ResolvedOptions): Slot<TInput, TOutput>[] {\n const resolvedUrl = typeof url === 'string' ? url : url.href;\n return Array.from({ length: options.concurrency }, () => new Slot<TInput, TOutput>(resolvedUrl));\n}\n\n/** Create a pool backed by an ES module worker registered with exposeTask(). */\nexport function createWorker<TInput, TOutput>(\n url: URL | string,\n options: WorkerOptions = {},\n): WorkerPool<TInput, TOutput> {\n const resolved = resolveOptions(options);\n\n return createPool(slots<TInput, TOutput>(url, resolved), {\n defaultTimeout: resolved.timeout,\n maxQueue: resolved.maxQueue,\n onFull: resolved.onFull,\n });\n}\n\n/** Create a stream-only pool backed by an ES module worker registered with exposeStream(). */\nexport function createStreamWorker<TInput, TChunk>(\n url: URL | string,\n options: WorkerOptions = {},\n): StreamWorkerPool<TInput, TChunk> {\n const resolved = resolveOptions(options);\n\n return createStreamPool(slots<TInput, TChunk>(url, resolved), {\n defaultTimeout: resolved.timeout,\n maxQueue: resolved.maxQueue,\n onFull: resolved.onFull,\n });\n}\n"],"mappings":"A,4KAoCA,SAAS,eAAe,EAAyB,CAAC,EAAoB,CACpE,GAAM,CAAE,cAAc,EAAG,WAAU,SAAS,SAAU,WAAYY,EAC5DC,EACJC,IAAgB,OACZ,KAAK,IAAA,IAAqB,KAAK,IAAI,EAAG,WAAW,WAAW,qBAAuB,CAAC,CAAC,EACrFA,EAEN,GAAI,CAAC,OAAO,UAAUD,CAAmB,GAAKA,EAAsB,GAAKA,EAAA,IACvE,MAAM,IAAIb,EAAAA,4BAA4B,0DAA2E,EAGnH,GAAIe,IAAa,IAAA,KAAc,CAAC,OAAO,UAAUA,CAAQ,GAAKA,EAAW,GACvE,MAAM,IAAIf,EAAAA,4BAA4B,uCAAuC,EAG/E,GAAIgB,IAAW,UAAYA,IAAW,OACpC,MAAM,IAAIhB,EAAAA,4BAA4B,qCAAqC,EAK7E,OAFAQ,EAAA,gBAAgBS,CAAO,EAEhB,CAAE,YAAaJ,EAAqB,WAAU,SAAQ,SAAQ,CACvE,CAEA,SAAS,iBAA0B,EAAkD,CACnF,GAAI,OAAOK,GAAU,WAAYA,EAAgB,MAAO,GAExD,IAAMC,EAAWD,EAYjB,OAVEC,EAAS,UAAA,GACT,OAAOA,EAAS,IAAO,UACvB,CAAC,OAAO,cAAcA,EAAS,EAAE,GACjCA,EAAS,GAAK,EAEP,GAELA,EAAS,OAAS,SAAWA,EAAS,OAAS,SAAiB,UAAWA,EAC3EA,EAAS,OAAS,SAAW,OAAOA,EAAS,OAAU,UAAYA,EAAS,QAAU,KAAa,IAGpGA,EAAS,MAAM,WAAa,IAAA,IAAaA,EAAS,MAAM,WAAa,aACtE,OAAOA,EAAS,MAAM,SAAY,UAClC,OAAOA,EAAS,MAAM,MAAS,WAC9BA,EAAS,MAAM,QAAU,IAAA,IAAa,OAAOA,EAAS,MAAM,OAAU,SAE3E,CAEA,SAAS,cAAc,EAAkE,CACvF,IAAMC,EAAY,MAAMC,EAAM,OAAO,EAKrC,MAHA,GAAM,KAAOA,EAAM,KACnB,EAAM,MAAQA,EAAM,MAEbA,EAAM,WAAa,WACtB,IAAIpB,EAAAA,qBAAqBoB,EAAM,QAAS,CAAE,OAAM,CAAC,EACjD,IAAInB,EAAAA,kBAAkBmB,EAAM,QAAS,CAAE,OAAM,CAAC,CACpD,CAEA,IAAM,KAAN,KAAkG,CAChG,GACA,GAAY,GACZ,GACA,GAAU,EACV,GAGA,OAA8D,IAAA,GAE9D,YAAY,EAAmB,CAC7B,KAAKC,GAAOC,CACd,CAEA,OAAO,EAAuB,CACvB,KAAKC,KACV,KAAKC,GAAY,EACjB,KAAKC,GAAe,SAAUC,CAAM,EACtC,CAEA,IAAI,EAAe,EAA+B,EAA+C,CAC/F,OAAO,KAAKC,GAAUC,EAAOC,EAAeb,EAAS,KAAK,CAC5D,CAEA,OAAO,EAAe,EAA6C,CACjE,IAAM,SAAa,KAAK,OAAO,IAAId,EAAAA,wBAAwB,yBAAyB,CAAC,EAC/E4B,EAAoB,CAAC,EACrBC,EAA4D,CAAC,EAC/DC,EAAO,GACPZ,EACE,KAAQ,GAAmB,CAC/B,IAAMa,EAASF,EAAQ,MAAM,EAEzBE,EAAQA,EAAO,CAAE,KAAM,GAAO,OAAM,CAAC,EACpCH,EAAO,KAAKb,CAAK,CACxB,EACM,OAAU,GAAqB,CAInC,IAHA,EAAO,GACP,EAAQS,EAEDK,EAAQ,OAAS,GACPA,EAAQ,MAGlB,CAAA,CADDL,IAAW,IAAA,GACH,CAAE,KAAM,GAAM,MAAO,IAAA,EAAmB,EADnB,QAAQ,OAAOA,CAAM,CACD,CAEzD,EAMA,MAAO,CACL,KANkB,KAAKC,GAAUC,EAAO,CAAC,GAAIjB,EAAQ,eAAiB,CAAC,CAAE,EAAGA,EAAQ,QAAS,SAAU,IAAI,CAAC,CAAC,SACvG,OAAO,EACZ,GAAoB,OAAOe,CAAM,CAI5B,EACN,SAAU,EACP,OAAO,oBAAuB,CAC7B,MAAM,MAAyC,CAC7C,GAAII,EAAO,OAAS,EAAG,MAAO,CAAE,KAAM,GAAO,MAAOA,EAAO,MAAM,CAAG,EAEpE,GAAIV,IAAU,IAAA,GAAW,MAAMA,EAI/B,OAFIY,EAAa,CAAE,KAAM,GAAM,MAAO,IAAA,EAAmB,EAElD,IAAI,SAAkC,EAAS,IAAW,CAC/DD,EAAQ,KAAM,GAAW,CACnBG,aAAkB,QAASA,EAAY,KAAKC,EAASC,CAAM,EAC1DD,EAAQD,CAAM,CACrB,CAAC,CACH,CAAC,CACH,EACA,MAAM,QAA2C,CAG/C,OAFA,KAAK,EAEE,CAAE,KAAM,GAAM,MAAO,IAAA,EAAmB,CACjD,CACF,EACF,CACF,CACF,CAEA,WAAkB,CAChB,KAAKG,GAAY,GACjB,KAAKb,GAAY,EACjB,KAAKC,GAAe,SAAU,IAAIvB,EAAAA,uBAAyB,CAC7D,CAEA,GACE,EACA,EACA,EACA,EACA,EACkB,CAClB,GAAI,KAAKmC,GAAW,OAAO,QAAQ,OAAO,IAAInC,EAAAA,uBAAyB,EAEvE,GAAI,KAAKqB,GAAU,OAAO,QAAQ,OAAO,IAAIvB,EAAAA,qBAAqB,6BAA6B,CAAC,EAEhG,GAAI,CACF,IAAMsC,EAAS,KAAKC,GAAc,EAC5BC,EAAK,KAAKC,GAGhB,MAFA,MAAKA,GAAUD,YAAiC,EAAIA,EAAK,EAElD,IAAI,SAAkB,EAAS,IAAW,CAC/C,IAAME,EAA4B,CAAE,OAAM,KAAI,OAAM,SAAQ,SAAQ,EAEpE,KAAKnB,GAAWmB,EAEZ1B,IAAY,IAAA,KACd,EAAQ,MAAQ,eAAiB,KAAK,OAAO,IAAIb,EAAAA,qBAAqBa,CAAO,CAAC,EAAGA,CAAO,EACxFP,EAAA,WAAWiC,EAAQ,KAAK,GAG1B,GAAI,CACFJ,EAAO,YAAY,CAAE,KAAI,QAAO,OAAM,QAAA,CAA0B,EAAGT,CAAa,CAClF,OAAST,EAAO,CACd,KAAK,OAAO,IAAIpB,EAAAA,qBAAqB,mCAAoC,CAAE,MAAOoB,CAAM,CAAC,CAAC,CAC5F,CACF,CAAC,CACH,OAASA,EAAO,CACd,OAAO,QAAQ,OAAOA,CAAK,CAC7B,CACF,CAEA,IAAwB,CACtB,GAAI,KAAKuB,GAAS,OAAO,KAAKA,GAE9B,GAAI,OAAO,OAAW,IAAa,MAAM,IAAI3C,EAAAA,qBAAqB,2CAA2C,EAE7G,GAAI,CACF,IAAMsC,EAAS,IAAI,OAAO,KAAKjB,GAAM,CAAE,KAAM,QAAS,CAAC,EAUvD,MARA,GAAO,UAAa,GAAiC,CAC/C,KAAKsB,KAAYL,GAAQ,KAAKM,GAAWC,EAAM,IAAI,CACzD,EACA,EAAO,QAAW,GAAU,KAAKC,GAAYR,EAAQ,IAAItC,EAAAA,qBAAqB6C,EAAM,SAAW,eAAe,CAAC,EAC/G,EAAO,mBACL,KAAKC,GAAYR,EAAQ,IAAItC,EAAAA,qBAAqB,2CAA2C,CAAC,EAChG,KAAK2C,GAAUL,EAERA,CACT,OAASlB,EAAO,CACd,MAAM,IAAIpB,EAAAA,qBAAqB,0BAA2B,CAAE,MAAOoB,CAAM,CAAC,CAC5E,CACF,CAEA,IAAoB,CAClB,IAAMkB,EAAS,KAAKK,GACpB,KAAKA,GAAU,IAAA,GACVL,IAEL,EAAO,UAAY,KACnB,EAAO,QAAU,KACjB,EAAO,eAAiB,KACxBA,EAAO,UAAU,EACnB,CAEA,GAAY,EAAgB,EAAmC,CACzD,KAAKK,KAAYL,IAErB,KAAKd,GAAY,EACjB,KAAKC,GAAe,SAAUL,CAAK,EACnC,KAAK,SAASA,CAAK,EACrB,CAEA,GAAW,EAAwB,CAC5B,KAAKG,KAGR,CAAC,iBAA0BwB,CAAO,GAClCA,EAAQ,KAAO,KAAKxB,GAAS,IAC5B,KAAKA,GAAS,OAAS,OAASwB,EAAQ,OAAS,QAElD,KAAK,OAAO,IAAI/C,EAAAA,qBAAqB,mDAAmD,CAAC,EAKvF+C,EAAQ,OAAS,QACnB,KAAKxB,GAAS,OAAOwB,EAAQ,KAAK,EAKhCA,EAAQ,OAAS,QACnB,KAAKtB,GAAe,SAAU,cAAcsB,EAAQ,KAAK,CAAC,EAK5D,KAAKtB,GAAe,UAAWsB,EAAQ,KAAK,EAC9C,CAEA,GAAe,EAA4B,EAAsB,CAC/D,IAAML,EAAU,KAAKnB,GAEhBmB,IAEL,KAAKnB,GAAW,IAAA,GAEZmB,EAAQ,OAAO,aAAaA,EAAQ,KAAK,EAEzCM,IAAS,UAAWN,EAAQ,QAAQzB,CAAgB,EACnDyB,EAAQ,OAAOzB,CAAK,EAC3B,CACF,EAEA,SAAS,MAAuB,EAAmB,EAAmD,CACpG,IAAMgC,EAAc,OAAO3B,GAAQ,SAAWA,EAAMA,EAAI,KACxD,OAAO,MAAM,KAAK,CAAE,OAAQX,EAAQ,WAAY,MAAS,IAAI,KAAsBsC,CAAW,CAAC,CACjG,CAGA,SAAgB,aACd,EACA,EAAyB,CAAC,EACG,CAC7B,IAAMC,EAAW,eAAevC,CAAO,EAEvC,OAAOP,EAAAA,WAAW,MAAuBkB,EAAK4B,CAAQ,EAAG,CACvD,eAAgBA,EAAS,QACzB,SAAUA,EAAS,SACnB,OAAQA,EAAS,MACnB,CAAC,CACH,CAGA,SAAgB,mBACd,EACA,EAAyB,CAAC,EACQ,CAClC,IAAMA,EAAW,eAAevC,CAAO,EAEvC,OAAON,EAAAA,iBAAiB,MAAsBiB,EAAK4B,CAAQ,EAAG,CAC5D,eAAgBA,EAAS,QACzB,SAAUA,EAAS,SACnB,OAAQA,EAAS,MACnB,CAAC,CACH,C"}
|