@vielzeug/familiar 2.2.0 → 3.0.0

package/README.md

@@ -1,13 +1,13 @@
 # @vielzeug/familiar
 
-> Typed module-worker pools with cancellation, priority scheduling, streaming, and test utilities.
-
-`@vielzeug/familiar` runs typed work in ES module workers. Worker modules keep imports, source maps, and normal file boundaries intact.
+> Web Worker pool with tasks, timeouts, cancellation
 
 ## Installation
 
 ```sh
 pnpm add @vielzeug/familiar
+npm install @vielzeug/familiar
+yarn add @vielzeug/familiar
 ```
 
 ## Quick Start
@@ -35,20 +35,13 @@ try {
 }
 ```
 
-## Exports
-
-- `createWorker()` creates a task pool backed by modules registered with `exposeTask()`.
-- `createStreamWorker()` creates a stream-only pool backed by modules registered with `exposeStream()`.
-- `batch()` and `createTaskGroup()` compose task-pool work without widening every pool handle.
-- `createTestWorker()` provides structured-clone, timeout, cancellation, and error-wrapping parity for task-pool tests.
-- `dispose()` stops work immediately; `drain()` waits for active work before teardown.
-
 ## Documentation
 
 - [Overview](https://vielzeug.dev/familiar/)
 - [Usage Guide](https://vielzeug.dev/familiar/usage)
 - [API Reference](https://vielzeug.dev/familiar/api)
 - [Examples](https://vielzeug.dev/familiar/examples)
+- [Migration Guide](https://vielzeug.dev/familiar/migration)
 
 ## License
 

package/dist/_dev.cjs

@@ -0,0 +1,2 @@
+function e(e){}exports.warn=e;
+//# sourceMappingURL=_dev.cjs.map

package/dist/_dev.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"_dev.cjs","names":[],"sources":["../src/_dev.ts"],"sourcesContent":["const isDev = !(globalThis as { __FAMILIAR_PROD__?: boolean }).__FAMILIAR_PROD__;\n\n/** @internal */\nexport function warn(msg: string): void {\n  if (isDev) console.warn(`[@vielzeug/familiar] ${msg}`);\n}\n\n/** @internal — Run fn only in dev builds. Use when dev-only logic goes beyond a single warn() / error() call. */\nexport function devOnly(fn: () => void): void {\n  if (isDev) fn();\n}\n"],"mappings":"AAGA,SAAgB,EAAK,EAAmB,CAExC"}

package/dist/_dev.js

@@ -0,0 +1,6 @@
+//#region src/_dev.ts
+function e(e) {}
+//#endregion
+export { e as warn };
+
+//# sourceMappingURL=_dev.js.map

package/dist/_dev.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_dev.js","names":[],"sources":["../src/_dev.ts"],"sourcesContent":["const isDev = !(globalThis as { __FAMILIAR_PROD__?: boolean }).__FAMILIAR_PROD__;\n\n/** @internal */\nexport function warn(msg: string): void {\n  if (isDev) console.warn(`[@vielzeug/familiar] ${msg}`);\n}\n\n/** @internal — Run fn only in dev builds. Use when dev-only logic goes beyond a single warn() / error() call. */\nexport function devOnly(fn: () => void): void {\n  if (isDev) fn();\n}\n"],"mappings":";AAGA,SAAgB,EAAK,GAAmB,CAExC"}

package/dist/_pool-core.cjs

@@ -1,2 +1,2 @@
-const e=require("./_timers.cjs"),t=require("./errors.cjs");let n=require("@vielzeug/arsenal/async");function r(r){let i=new AbortController,a=[],o=[],s=0,c=0,l=0,u,d=!1;function f(){if(r.isIdle())for(let e of a.splice(0))e.timer&&clearTimeout(e.timer),e.resolve()}function p(n){return r.isIdle()?Promise.resolve():new Promise((r,i)=>{let o={reject:i,resolve:r};n.timeout!==void 0&&(o.timer=setTimeout(()=>{let e=a.indexOf(o);e!==-1&&a.splice(e,1),i(new t.FamiliarTimeoutError(n.timeout))},n.timeout),e.unrefTimer(o.timer)),a.push(o)})}function m(){o.shift()?.resolve()}function h(e){for(let t of o.splice(0))t.reject(e)}function g(e){return e?.aborted?Promise.reject((0,n.abortError)(e)):new Promise((t,r)=>{let i=!1,a={cleanup(){e?.removeEventListener(`abort`,s)},reject(e){if(i)return;i=!0,a.cleanup();let t=o.indexOf(a);t!==-1&&o.splice(t,1),r(e)},resolve(){i||(i=!0,a.cleanup(),t())}},s=()=>a.reject((0,n.abortError)(e));e?.addEventListener(`abort`,s,{once:!0}),o.push(a)})}function _(){d||(d=!0,i.abort(),r.onDispose(),h(new t.FamiliarTerminatedError),f())}function v(e){return d?Promise.resolve():u||(r.onDrainStart(),h(new t.FamiliarTerminatedError(`Worker is draining`)),u=p(e).then(()=>_(),e=>{throw _(),e}),u)}function y(e){return Promise.all(e.map(e=>e.prime())).then(()=>void 0)}function b(e){s+=e}function x(){c+=1}function S(){l+=1}function C(e){return{active:s,completed:c,failed:l,queued:e}}function w(){return d?`terminated`:s===0?`idle`:`running`}return{disposalSignal:i.signal,dispose:_,get disposed(){return d},drain:v,get drainPromise(){return u},isIdle:r.isIdle,prime:y,rejectCapacity:h,releaseCapacity:m,settleIdle:f,stats:C,status:w,trackActive:b,trackCompleted:x,trackFailed:S,waitForCapacity:g,waitForIdle:p}}exports.createPoolCore=r;
+const e=require("./_timers.cjs"),t=require("./errors.cjs");let n=require("@vielzeug/arsenal");var r=2147483647;function i(e){if(!Number.isFinite(e))throw new t.FamiliarInvalidOptionsError("`priority` must be a finite number");return e}function a(e,n=`timeout`){if(e!==void 0&&(!Number.isInteger(e)||e<1||e>2147483647))throw new t.FamiliarInvalidOptionsError(`\`${n}\` must be an integer from 1 through ${r}`);return e}function o(r){let i=new AbortController,o=[],s=[],c=0,l=0,u=0,d=0,f,p=!1;function m(){if(r.isIdle())for(let e of o.splice(0))e.timer&&clearTimeout(e.timer),e.resolve()}function h(n){return r.isIdle()?Promise.resolve():new Promise((r,i)=>{let a={reject:i,resolve:r};n.timeout!==void 0&&(a.timer=setTimeout(()=>{let e=o.indexOf(a);e!==-1&&o.splice(e,1),i(new t.FamiliarTimeoutError(n.timeout,`Drain`))},n.timeout),e.unrefTimer(a.timer)),o.push(a)})}function g(){s.shift()?.resolve()}function _(e){for(let t of s.splice(0))t.reject(e)}function v(e,t){return e?.aborted?Promise.reject((0,n.abortError)(e)):new Promise((r,i)=>{let a=!1,o={cleanup(){e?.removeEventListener(`abort`,c)},priority:t,reject(e){if(a)return;a=!0,o.cleanup();let t=s.indexOf(o);t!==-1&&s.splice(t,1),i(e)},resolve(){a||(a=!0,o.cleanup(),r())},sequence:l++},c=()=>o.reject((0,n.abortError)(e));e?.addEventListener(`abort`,c,{once:!0}),s.push(o),s.sort((e,t)=>t.priority-e.priority||e.sequence-t.sequence)})}function y(){p||(p=!0,i.abort(),r.onDispose(),_(new t.FamiliarTerminatedError),m())}function b(e={}){if(p)return Promise.resolve();try{a(e.timeout,`drain.timeout`)}catch(e){return Promise.reject(e)}return f||(r.onDrainStart(),_(new t.FamiliarTerminatedError(`Worker is draining`)),f=h(e).then(()=>y(),e=>{throw y(),e}),f)}function x(e){c+=e}function S(){u+=1}function C(){d+=1}function w(e){return{active:c,completed:u,failed:d,queued:e+s.length}}function T(){return p?`terminated`:c===0?`idle`:`running`}return{disposalSignal:i.signal,dispose:y,get disposed(){return p},drain:b,get drainPromise(){return f},isIdle:r.isIdle,rejectCapacity:_,releaseCapacity:g,settleIdle:m,stats:w,status:T,trackActive:x,trackCompleted:S,trackFailed:C,waitForCapacity:v,waitForIdle:h}}exports.MAX_TIMEOUT=r,exports.createPoolCore=o,exports.validatePriority=i,exports.validateTimeout=a;
 //# sourceMappingURL=_pool-core.cjs.map

package/dist/_pool-core.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"_pool-core.cjs","names":[],"sources":["../src/_pool-core.ts"],"sourcesContent":["import { abortError } from '@vielzeug/arsenal/async';\nimport { unrefTimer } from './_timers';\nimport { FamiliarTerminatedError, FamiliarTimeoutError } from './errors';\nimport type { DrainOptions, WorkerStats, WorkerStatus } from './types';\n\nexport type PoolOptions = {\n  concurrency: number;\n  defaultTimeout: number | undefined;\n  maxQueue: number | undefined;\n  onFull: 'reject' | 'wait';\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  reject(reason: unknown): void;\n  resolve(): void;\n};\n\nexport interface PoolCore {\n  readonly disposalSignal: AbortSignal;\n  dispose(): void;\n  readonly disposed: boolean;\n  drain(options: DrainOptions): Promise<void>;\n  readonly drainPromise: Promise<void> | undefined;\n  isIdle(): boolean;\n  prime(slots: readonly { prime(): Promise<void> }[]): Promise<void>;\n  rejectCapacity(reason: unknown): void;\n  releaseCapacity(): void;\n  settleIdle(): void;\n  stats(queued: number): WorkerStats;\n  status(): WorkerStatus;\n  trackActive(delta: number): void;\n  trackCompleted(): void;\n  trackFailed(): void;\n  waitForCapacity(signal: AbortSignal | undefined): Promise<void>;\n  waitForIdle(options: DrainOptions): Promise<void>;\n}\n\n/**\n * Shared disposal controller, idle/capacity waiters, drain, and stats tracking\n * used by both the single-result pool (`_pool.ts`) and the stream pool\n * (`_stream-pool.ts`). Each pool provides its own `isIdle` predicate and\n * `onDispose`/`onDrainStart` hooks to flush pool-specific pending work.\n */\nexport function createPoolCore(options: {\n  isIdle: () => boolean;\n  onDispose: () => void;\n  onDrainStart: () => void;\n}): PoolCore {\n  const disposalController = new AbortController();\n  const idleWaiters: IdleWaiter[] = [];\n  const capacityWaiters: CapacityWaiter[] = [];\n  let active = 0;\n  let completed = 0;\n  let failed = 0;\n  let drainPromise: Promise<void> | undefined;\n  let terminated = false;\n\n  function settleIdle(): void {\n    if (!options.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 (options.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!));\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): 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        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      };\n      const onAbort = () => waiter.reject(abortError(signal!));\n\n      signal?.addEventListener('abort', onAbort, { once: true });\n      capacityWaiters.push(waiter);\n    });\n  }\n\n  function dispose(): void {\n    if (terminated) return;\n\n    terminated = true;\n    disposalController.abort();\n    options.onDispose();\n    rejectCapacity(new FamiliarTerminatedError());\n    settleIdle();\n  }\n\n  function drain(drainOptions: DrainOptions): Promise<void> {\n    if (terminated) return Promise.resolve();\n\n    if (drainPromise) return drainPromise;\n\n    options.onDrainStart();\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  function prime(slots: readonly { prime(): Promise<void> }[]): Promise<void> {\n    return Promise.all(slots.map((slot) => slot.prime())).then(() => undefined);\n  }\n\n  function trackActive(delta: number): void {\n    active += delta;\n  }\n\n  function trackCompleted(): void {\n    completed += 1;\n  }\n\n  function trackFailed(): void {\n    failed += 1;\n  }\n\n  function stats(queued: number): WorkerStats {\n    return { active, completed, failed, queued };\n  }\n\n  function status(): WorkerStatus {\n    if (terminated) return 'terminated';\n\n    return active === 0 ? 'idle' : 'running';\n  }\n\n  return {\n    disposalSignal: disposalController.signal,\n    dispose,\n    get disposed() {\n      return terminated;\n    },\n    drain,\n    get drainPromise() {\n      return drainPromise;\n    },\n    isIdle: options.isIdle,\n    prime,\n    rejectCapacity,\n    releaseCapacity,\n    settleIdle,\n    stats,\n    status,\n    trackActive,\n    trackCompleted,\n    trackFailed,\n    waitForCapacity,\n    waitForIdle,\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"_pool-core.cjs","names":[],"sources":["../src/_pool-core.ts"],"sourcesContent":["import { abortError } from '@vielzeug/arsenal';\nimport { unrefTimer } from './_timers.js';\nimport { FamiliarInvalidOptionsError, FamiliarTerminatedError, FamiliarTimeoutError } from './errors.js';\nimport type { DrainOptions, 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  concurrency: number;\n  defaultTimeout: number | undefined;\n  maxQueue: number | undefined;\n  onFull: 'reject' | 'wait';\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\nexport interface PoolCore {\n  readonly disposalSignal: AbortSignal;\n  dispose(): void;\n  readonly disposed: boolean;\n  drain(options?: DrainOptions): Promise<void>;\n  readonly drainPromise: Promise<void> | undefined;\n  isIdle(): boolean;\n  rejectCapacity(reason: unknown): void;\n  releaseCapacity(): void;\n  settleIdle(): void;\n  stats(queued: number): WorkerStats;\n  status(): WorkerStatus;\n  trackActive(delta: number): void;\n  trackCompleted(): void;\n  trackFailed(): void;\n  waitForCapacity(signal: AbortSignal | undefined, priority: number): Promise<void>;\n  waitForIdle(options: DrainOptions): Promise<void>;\n}\n\n/**\n * Shared disposal controller, idle/capacity waiters, drain, and stats tracking\n * used by both the single-result pool (`_pool.ts`) and the stream pool\n * (`_stream-pool.ts`). Each pool provides its own `isIdle` predicate and\n * `onDispose`/`onDrainStart` hooks to flush pool-specific pending work.\n */\nexport function createPoolCore(options: {\n  isIdle: () => boolean;\n  onDispose: () => void;\n  onDrainStart: () => void;\n}): PoolCore {\n  const disposalController = new AbortController();\n  const idleWaiters: IdleWaiter[] = [];\n  const capacityWaiters: CapacityWaiter[] = [];\n  let active = 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 settleIdle(): void {\n    if (!options.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 (options.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 dispose(): void {\n    if (terminated) return;\n\n    terminated = true;\n    disposalController.abort();\n    options.onDispose();\n    rejectCapacity(new FamiliarTerminatedError());\n    settleIdle();\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    options.onDrainStart();\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  function trackActive(delta: number): void {\n    active += delta;\n  }\n\n  function trackCompleted(): void {\n    completed += 1;\n  }\n\n  function trackFailed(): void {\n    failed += 1;\n  }\n\n  function stats(queued: number): WorkerStats {\n    return { active, completed, failed, queued: queued + capacityWaiters.length };\n  }\n\n  function status(): WorkerStatus {\n    if (terminated) return 'terminated';\n\n    return active === 0 ? 'idle' : 'running';\n  }\n\n  return {\n    disposalSignal: disposalController.signal,\n    dispose,\n    get disposed() {\n      return terminated;\n    },\n    drain,\n    get drainPromise() {\n      return drainPromise;\n    },\n    isIdle: options.isIdle,\n    rejectCapacity,\n    releaseCapacity,\n    settleIdle,\n    stats,\n    status,\n    trackActive,\n    trackCompleted,\n    trackFailed,\n    waitForCapacity,\n    waitForIdle,\n  };\n}\n"],"mappings":"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"}

package/dist/_pool-core.d.ts

@@ -1,4 +1,8 @@
-import type { DrainOptions, WorkerStats, WorkerStatus } from './types';
+import type { DrainOptions, WorkerStats, WorkerStatus } from './types.js';
+export declare const MAX_CONCURRENCY = 512;
+export declare const MAX_TIMEOUT = 2147483647;
+export declare function validatePriority(priority: number): number;
+export declare function validateTimeout(timeout: number | undefined, name?: string): number | undefined;
 export type PoolOptions = {
     concurrency: number;
     defaultTimeout: number | undefined;
@@ -9,12 +13,9 @@ export interface PoolCore {
     readonly disposalSignal: AbortSignal;
     dispose(): void;
     readonly disposed: boolean;
-    drain(options: DrainOptions): Promise<void>;
+    drain(options?: DrainOptions): Promise<void>;
     readonly drainPromise: Promise<void> | undefined;
     isIdle(): boolean;
-    prime(slots: readonly {
-        prime(): Promise<void>;
-    }[]): Promise<void>;
     rejectCapacity(reason: unknown): void;
     releaseCapacity(): void;
     settleIdle(): void;
@@ -23,7 +24,7 @@ export interface PoolCore {
     trackActive(delta: number): void;
     trackCompleted(): void;
     trackFailed(): void;
-    waitForCapacity(signal: AbortSignal | undefined): Promise<void>;
+    waitForCapacity(signal: AbortSignal | undefined, priority: number): Promise<void>;
     waitForIdle(options: DrainOptions): Promise<void>;
 }
 /**

package/dist/_pool-core.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"_pool-core.d.ts","sourceRoot":"","sources":["../src/_pool-core.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvE,MAAM,MAAM,WAAW,GAAG;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,MAAM,EAAE,QAAQ,GAAG,MAAM,CAAC;CAC3B,CAAC;AAcF,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,cAAc,EAAE,WAAW,CAAC;IACrC,OAAO,IAAI,IAAI,CAAC;IAChB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC;IACjD,MAAM,IAAI,OAAO,CAAC;IAClB,KAAK,CAAC,KAAK,EAAE,SAAS;QAAE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;KAAE,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnE,cAAc,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;IACtC,eAAe,IAAI,IAAI,CAAC;IACxB,UAAU,IAAI,IAAI,CAAC;IACnB,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,CAAC;IACnC,MAAM,IAAI,YAAY,CAAC;IACvB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,cAAc,IAAI,IAAI,CAAC;IACvB,WAAW,IAAI,IAAI,CAAC;IACpB,eAAe,CAAC,MAAM,EAAE,WAAW,GAAG,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChE,WAAW,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnD;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE;IACtC,MAAM,EAAE,MAAM,OAAO,CAAC;IACtB,SAAS,EAAE,MAAM,IAAI,CAAC;IACtB,YAAY,EAAE,MAAM,IAAI,CAAC;CAC1B,GAAG,QAAQ,CAkKX"}
+{"version":3,"file":"_pool-core.d.ts","sourceRoot":"","sources":["../src/_pool-core.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1E,eAAO,MAAM,eAAe,MAAM,CAAC;AACnC,eAAO,MAAM,WAAW,aAAgB,CAAC;AAEzC,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGzD;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,SAAY,GAAG,MAAM,GAAG,SAAS,CAKjG;AAED,MAAM,MAAM,WAAW,GAAG;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,MAAM,EAAE,QAAQ,GAAG,MAAM,CAAC;CAC3B,CAAC;AAgBF,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,cAAc,EAAE,WAAW,CAAC;IACrC,OAAO,IAAI,IAAI,CAAC;IAChB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,KAAK,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7C,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC;IACjD,MAAM,IAAI,OAAO,CAAC;IAClB,cAAc,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;IACtC,eAAe,IAAI,IAAI,CAAC;IACxB,UAAU,IAAI,IAAI,CAAC;IACnB,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,CAAC;IACnC,MAAM,IAAI,YAAY,CAAC;IACvB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,cAAc,IAAI,IAAI,CAAC;IACvB,WAAW,IAAI,IAAI,CAAC;IACpB,eAAe,CAAC,MAAM,EAAE,WAAW,GAAG,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClF,WAAW,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnD;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE;IACtC,MAAM,EAAE,MAAM,OAAO,CAAC;IACtB,SAAS,EAAE,MAAM,IAAI,CAAC;IACtB,YAAY,EAAE,MAAM,IAAI,CAAC;CAC1B,GAAG,QAAQ,CAsKX"}

package/dist/_pool-core.js

@@ -1,105 +1,118 @@
 import { unrefTimer as e } from "./_timers.js";
-import { FamiliarTerminatedError as t, FamiliarTimeoutError as n } from "./errors.js";
-import { abortError as r } from "@vielzeug/arsenal/async";
+import { FamiliarInvalidOptionsError as t, FamiliarTerminatedError as n, FamiliarTimeoutError as r } from "./errors.js";
+import { abortError as i } from "@vielzeug/arsenal";
 //#region src/_pool-core.ts
-function i(i) {
-	let a = new AbortController(), o = [], s = [], c = 0, l = 0, u = 0, d, f = !1;
-	function p() {
-		if (i.isIdle()) for (let e of o.splice(0)) e.timer && clearTimeout(e.timer), e.resolve();
+var a = 2147483647;
+function o(e) {
+	if (!Number.isFinite(e)) throw new t("`priority` must be a finite number");
+	return e;
+}
+function s(e, n = "timeout") {
+	if (e !== void 0 && (!Number.isInteger(e) || e < 1 || e > 2147483647)) throw new t(`\`${n}\` must be an integer from 1 through ${a}`);
+	return e;
+}
+function c(t) {
+	let a = new AbortController(), o = [], c = [], l = 0, u = 0, d = 0, f = 0, p, m = !1;
+	function h() {
+		if (t.isIdle()) for (let e of o.splice(0)) e.timer && clearTimeout(e.timer), e.resolve();
 	}
-	function m(t) {
-		return i.isIdle() ? Promise.resolve() : new Promise((r, i) => {
+	function g(n) {
+		return t.isIdle() ? Promise.resolve() : new Promise((t, i) => {
 			let a = {
 				reject: i,
-				resolve: r
+				resolve: t
 			};
-			t.timeout !== void 0 && (a.timer = setTimeout(() => {
+			n.timeout !== void 0 && (a.timer = setTimeout(() => {
 				let e = o.indexOf(a);
-				e !== -1 && o.splice(e, 1), i(new n(t.timeout));
-			}, t.timeout), e(a.timer)), o.push(a);
+				e !== -1 && o.splice(e, 1), i(new r(n.timeout, "Drain"));
+			}, n.timeout), e(a.timer)), o.push(a);
 		});
 	}
-	function h() {
-		s.shift()?.resolve();
+	function _() {
+		c.shift()?.resolve();
 	}
-	function g(e) {
-		for (let t of s.splice(0)) t.reject(e);
+	function v(e) {
+		for (let t of c.splice(0)) t.reject(e);
 	}
-	function _(e) {
-		return e?.aborted ? Promise.reject(r(e)) : new Promise((t, n) => {
-			let i = !1, a = {
+	function y(e, t) {
+		return e?.aborted ? Promise.reject(i(e)) : new Promise((n, r) => {
+			let a = !1, o = {
 				cleanup() {
-					e?.removeEventListener("abort", o);
+					e?.removeEventListener("abort", s);
 				},
+				priority: t,
 				reject(e) {
-					if (i) return;
-					i = !0, a.cleanup();
-					let t = s.indexOf(a);
-					t !== -1 && s.splice(t, 1), n(e);
+					if (a) return;
+					a = !0, o.cleanup();
+					let t = c.indexOf(o);
+					t !== -1 && c.splice(t, 1), r(e);
 				},
 				resolve() {
-					i || (i = !0, a.cleanup(), t());
-				}
-			}, o = () => a.reject(r(e));
-			e?.addEventListener("abort", o, { once: !0 }), s.push(a);
+					a || (a = !0, o.cleanup(), n());
+				},
+				sequence: u++
+			}, s = () => o.reject(i(e));
+			e?.addEventListener("abort", s, { once: !0 }), c.push(o), c.sort((e, t) => t.priority - e.priority || e.sequence - t.sequence);
 		});
 	}
-	function v() {
-		f || (f = !0, a.abort(), i.onDispose(), g(new t()), p());
-	}
-	function y(e) {
-		return f ? Promise.resolve() : d || (i.onDrainStart(), g(new t("Worker is draining")), d = m(e).then(() => v(), (e) => {
-			throw v(), e;
-		}), d);
+	function b() {
+		m || (m = !0, a.abort(), t.onDispose(), v(new n()), h());
 	}
-	function b(e) {
-		return Promise.all(e.map((e) => e.prime())).then(() => void 0);
+	function x(e = {}) {
+		if (m) return Promise.resolve();
+		try {
+			s(e.timeout, "drain.timeout");
+		} catch (e) {
+			return Promise.reject(e);
+		}
+		return p || (t.onDrainStart(), v(new n("Worker is draining")), p = g(e).then(() => b(), (e) => {
+			throw b(), e;
+		}), p);
 	}
-	function x(e) {
-		c += e;
-	}
-	function S() {
-		l += 1;
+	function S(e) {
+		l += e;
 	}
 	function C() {
-		u += 1;
+		d += 1;
+	}
+	function w() {
+		f += 1;
 	}
-	function w(e) {
+	function T(e) {
 		return {
-			active: c,
-			completed: l,
-			failed: u,
-			queued: e
+			active: l,
+			completed: d,
+			failed: f,
+			queued: e + c.length
 		};
 	}
-	function T() {
-		return f ? "terminated" : c === 0 ? "idle" : "running";
+	function E() {
+		return m ? "terminated" : l === 0 ? "idle" : "running";
 	}
 	return {
 		disposalSignal: a.signal,
-		dispose: v,
+		dispose: b,
 		get disposed() {
-			return f;
+			return m;
 		},
-		drain: y,
+		drain: x,
 		get drainPromise() {
-			return d;
+			return p;
 		},
-		isIdle: i.isIdle,
-		prime: b,
-		rejectCapacity: g,
-		releaseCapacity: h,
-		settleIdle: p,
-		stats: w,
-		status: T,
-		trackActive: x,
-		trackCompleted: S,
-		trackFailed: C,
-		waitForCapacity: _,
-		waitForIdle: m
+		isIdle: t.isIdle,
+		rejectCapacity: v,
+		releaseCapacity: _,
+		settleIdle: h,
+		stats: T,
+		status: E,
+		trackActive: S,
+		trackCompleted: C,
+		trackFailed: w,
+		waitForCapacity: y,
+		waitForIdle: g
 	};
 }
 //#endregion
-export { i as createPoolCore };
+export { a as MAX_TIMEOUT, c as createPoolCore, o as validatePriority, s as validateTimeout };
 
 //# sourceMappingURL=_pool-core.js.map

package/dist/_pool-core.js.map

@@ -1 +1 @@
-{"version":3,"file":"_pool-core.js","names":[],"sources":["../src/_pool-core.ts"],"sourcesContent":["import { abortError } from '@vielzeug/arsenal/async';\nimport { unrefTimer } from './_timers';\nimport { FamiliarTerminatedError, FamiliarTimeoutError } from './errors';\nimport type { DrainOptions, WorkerStats, WorkerStatus } from './types';\n\nexport type PoolOptions = {\n  concurrency: number;\n  defaultTimeout: number | undefined;\n  maxQueue: number | undefined;\n  onFull: 'reject' | 'wait';\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  reject(reason: unknown): void;\n  resolve(): void;\n};\n\nexport interface PoolCore {\n  readonly disposalSignal: AbortSignal;\n  dispose(): void;\n  readonly disposed: boolean;\n  drain(options: DrainOptions): Promise<void>;\n  readonly drainPromise: Promise<void> | undefined;\n  isIdle(): boolean;\n  prime(slots: readonly { prime(): Promise<void> }[]): Promise<void>;\n  rejectCapacity(reason: unknown): void;\n  releaseCapacity(): void;\n  settleIdle(): void;\n  stats(queued: number): WorkerStats;\n  status(): WorkerStatus;\n  trackActive(delta: number): void;\n  trackCompleted(): void;\n  trackFailed(): void;\n  waitForCapacity(signal: AbortSignal | undefined): Promise<void>;\n  waitForIdle(options: DrainOptions): Promise<void>;\n}\n\n/**\n * Shared disposal controller, idle/capacity waiters, drain, and stats tracking\n * used by both the single-result pool (`_pool.ts`) and the stream pool\n * (`_stream-pool.ts`). Each pool provides its own `isIdle` predicate and\n * `onDispose`/`onDrainStart` hooks to flush pool-specific pending work.\n */\nexport function createPoolCore(options: {\n  isIdle: () => boolean;\n  onDispose: () => void;\n  onDrainStart: () => void;\n}): PoolCore {\n  const disposalController = new AbortController();\n  const idleWaiters: IdleWaiter[] = [];\n  const capacityWaiters: CapacityWaiter[] = [];\n  let active = 0;\n  let completed = 0;\n  let failed = 0;\n  let drainPromise: Promise<void> | undefined;\n  let terminated = false;\n\n  function settleIdle(): void {\n    if (!options.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 (options.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!));\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): 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        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      };\n      const onAbort = () => waiter.reject(abortError(signal!));\n\n      signal?.addEventListener('abort', onAbort, { once: true });\n      capacityWaiters.push(waiter);\n    });\n  }\n\n  function dispose(): void {\n    if (terminated) return;\n\n    terminated = true;\n    disposalController.abort();\n    options.onDispose();\n    rejectCapacity(new FamiliarTerminatedError());\n    settleIdle();\n  }\n\n  function drain(drainOptions: DrainOptions): Promise<void> {\n    if (terminated) return Promise.resolve();\n\n    if (drainPromise) return drainPromise;\n\n    options.onDrainStart();\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  function prime(slots: readonly { prime(): Promise<void> }[]): Promise<void> {\n    return Promise.all(slots.map((slot) => slot.prime())).then(() => undefined);\n  }\n\n  function trackActive(delta: number): void {\n    active += delta;\n  }\n\n  function trackCompleted(): void {\n    completed += 1;\n  }\n\n  function trackFailed(): void {\n    failed += 1;\n  }\n\n  function stats(queued: number): WorkerStats {\n    return { active, completed, failed, queued };\n  }\n\n  function status(): WorkerStatus {\n    if (terminated) return 'terminated';\n\n    return active === 0 ? 'idle' : 'running';\n  }\n\n  return {\n    disposalSignal: disposalController.signal,\n    dispose,\n    get disposed() {\n      return terminated;\n    },\n    drain,\n    get drainPromise() {\n      return drainPromise;\n    },\n    isIdle: options.isIdle,\n    prime,\n    rejectCapacity,\n    releaseCapacity,\n    settleIdle,\n    stats,\n    status,\n    trackActive,\n    trackCompleted,\n    trackFailed,\n    waitForCapacity,\n    waitForIdle,\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"_pool-core.js","names":[],"sources":["../src/_pool-core.ts"],"sourcesContent":["import { abortError } from '@vielzeug/arsenal';\nimport { unrefTimer } from './_timers.js';\nimport { FamiliarInvalidOptionsError, FamiliarTerminatedError, FamiliarTimeoutError } from './errors.js';\nimport type { DrainOptions, 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  concurrency: number;\n  defaultTimeout: number | undefined;\n  maxQueue: number | undefined;\n  onFull: 'reject' | 'wait';\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\nexport interface PoolCore {\n  readonly disposalSignal: AbortSignal;\n  dispose(): void;\n  readonly disposed: boolean;\n  drain(options?: DrainOptions): Promise<void>;\n  readonly drainPromise: Promise<void> | undefined;\n  isIdle(): boolean;\n  rejectCapacity(reason: unknown): void;\n  releaseCapacity(): void;\n  settleIdle(): void;\n  stats(queued: number): WorkerStats;\n  status(): WorkerStatus;\n  trackActive(delta: number): void;\n  trackCompleted(): void;\n  trackFailed(): void;\n  waitForCapacity(signal: AbortSignal | undefined, priority: number): Promise<void>;\n  waitForIdle(options: DrainOptions): Promise<void>;\n}\n\n/**\n * Shared disposal controller, idle/capacity waiters, drain, and stats tracking\n * used by both the single-result pool (`_pool.ts`) and the stream pool\n * (`_stream-pool.ts`). Each pool provides its own `isIdle` predicate and\n * `onDispose`/`onDrainStart` hooks to flush pool-specific pending work.\n */\nexport function createPoolCore(options: {\n  isIdle: () => boolean;\n  onDispose: () => void;\n  onDrainStart: () => void;\n}): PoolCore {\n  const disposalController = new AbortController();\n  const idleWaiters: IdleWaiter[] = [];\n  const capacityWaiters: CapacityWaiter[] = [];\n  let active = 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 settleIdle(): void {\n    if (!options.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 (options.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 dispose(): void {\n    if (terminated) return;\n\n    terminated = true;\n    disposalController.abort();\n    options.onDispose();\n    rejectCapacity(new FamiliarTerminatedError());\n    settleIdle();\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    options.onDrainStart();\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  function trackActive(delta: number): void {\n    active += delta;\n  }\n\n  function trackCompleted(): void {\n    completed += 1;\n  }\n\n  function trackFailed(): void {\n    failed += 1;\n  }\n\n  function stats(queued: number): WorkerStats {\n    return { active, completed, failed, queued: queued + capacityWaiters.length };\n  }\n\n  function status(): WorkerStatus {\n    if (terminated) return 'terminated';\n\n    return active === 0 ? 'idle' : 'running';\n  }\n\n  return {\n    disposalSignal: disposalController.signal,\n    dispose,\n    get disposed() {\n      return terminated;\n    },\n    drain,\n    get drainPromise() {\n      return drainPromise;\n    },\n    isIdle: options.isIdle,\n    rejectCapacity,\n    releaseCapacity,\n    settleIdle,\n    stats,\n    status,\n    trackActive,\n    trackCompleted,\n    trackFailed,\n    waitForCapacity,\n    waitForIdle,\n  };\n}\n"],"mappings":"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"}

package/dist/_pool.cjs

@@ -1,2 +1,2 @@
-const e=require("./errors.cjs"),t=require("./_pool-core.cjs"),n=require("./_queue.cjs");let r=require("@vielzeug/arsenal/async");function i(i,a){let o=[...i],s=new n.TaskQueue,c=!1,l=t.createPoolCore({isIdle:()=>o.length===i.length&&s.size===0,onDispose(){for(let e of i)e.terminate();for(;s.size>0;){let t=s.shift();if(!t)break;t.cleanupAbort?.(),t.reject(new e.FamiliarTerminatedError)}},onDrainStart(){}});function u(){for(;s.size>0;){let e=s.shift();if(!e)break;if(e.signal?.aborted){e.cleanupAbort?.(),e.reject((0,r.abortError)(e.signal)),l.releaseCapacity();continue}return e}l.settleIdle()}function d(){if(!(c||l.disposed)){for(c=!0;!l.disposed&&o.length>0&&s.size>0;){let i=u();if(!i)break;let s=i,c=o.pop(),f=s.timeout??a.defaultTimeout;l.trackActive(1),l.releaseCapacity();let p=()=>c.cancel((0,r.abortError)(s.signal));s.cleanupAbort=()=>{s.signal?.removeEventListener(`abort`,p),s.cleanupAbort=void 0},s.signal?.addEventListener(`abort`,p,{once:!0}),c.run(s.input,s.transferables,f).then(e=>t(e),e=>n(e));function t(e){s.cleanupAbort?.(),o.push(c),l.trackActive(-1),l.trackCompleted(),s.resolve(e),d(),l.settleIdle()}function n(t){s.cleanupAbort?.(),o.push(c),l.trackActive(-1),!(t instanceof e.FamiliarTerminatedError)&&t instanceof Error&&t.name!==`AbortError`&&l.trackFailed(),s.reject(t),d(),l.settleIdle()}}c=!1}}async function f(t,n={}){let{priority:i=0,signal:o,timeout:c,transferables:u=[]}=n;if(l.disposed)throw new e.FamiliarTerminatedError;if(l.drainPromise)throw new e.FamiliarTerminatedError(`Worker is draining`);if(o?.aborted)throw(0,r.abortError)(o);for(;a.onFull===`wait`&&a.maxQueue!==void 0&&s.size>=a.maxQueue;){if(await l.waitForCapacity(o),l.disposed)throw new e.FamiliarTerminatedError;if(l.drainPromise)throw new e.FamiliarTerminatedError(`Worker is draining`);if(o?.aborted)throw(0,r.abortError)(o)}let f,p,m=new Promise((e,t)=>{f=e,p=t}),h={input:t,priority:i,reject:p,resolve:f,signal:o,timeout:c,transferables:u};if(!s.enqueue(h,a.onFull===`wait`?void 0:a.maxQueue))throw new e.FamiliarQueueFullError(a.maxQueue);if(o){let e=()=>{s.remove(h)&&(h.cleanupAbort?.(),p((0,r.abortError)(o)),l.releaseCapacity(),l.settleIdle())};h.cleanupAbort=()=>{o.removeEventListener(`abort`,e),h.cleanupAbort=void 0},o.addEventListener(`abort`,e,{once:!0})}return d(),m}return{get disposalSignal(){return l.disposalSignal},dispose:l.dispose,get disposed(){return l.disposed},drain:l.drain,async prime(){await l.prime(i)},run:f,get stats(){return l.stats(s.size)},get status(){return l.status()},[Symbol.asyncDispose]:()=>l.drain({}),[Symbol.dispose]:l.dispose}}async function*a(e,t,n={}){let r=new AbortController,i=()=>r.abort(n.signal?.reason);n.signal?.addEventListener(`abort`,i,{once:!0});let a=t.map(t=>e.run(t,{...n,signal:r.signal}));try{for(let e of a)yield await e}catch(e){throw r.abort(e),await Promise.allSettled(a),e}finally{n.signal?.removeEventListener(`abort`,i),r.abort(),await Promise.allSettled(a)}}function o(e,t=void 0,n={}){let r=new AbortController,i=new Set,a=0;return n.signal?.addEventListener(`abort`,()=>r.abort(n.signal?.reason),{once:!0}),{abort(e){r.abort(e)},async drain(){return Promise.allSettled([...i])},get name(){return t},get pending(){return i.size},run(t,n={}){let o=e.run(t,{...n,signal:r.signal});return a+=1,i.add(o),o.finally(()=>i.delete(o)),o},get size(){return a}}}exports.batch=a,exports.createPool=i,exports.createTaskGroup=o;
+const e=require("./errors.cjs"),t=require("./_pool-core.cjs"),n=require("./_queue.cjs");let r=require("@vielzeug/arsenal");function i(i,a){let o=[...i],s=new n.TaskQueue,c=!1,l=t.createPoolCore({isIdle:()=>o.length===i.length&&s.size===0,onDispose(){for(let e of i)e.terminate();for(;s.size>0;){let t=s.shift();if(!t)break;t.cleanupAbort?.(),t.reject(new e.FamiliarTerminatedError)}},onDrainStart(){}});function u(){for(;s.size>0;){let e=s.shift();if(!e)break;if(e.signal?.aborted){e.cleanupAbort?.(),e.reject((0,r.abortError)(e.signal)),l.releaseCapacity();continue}return e}l.settleIdle()}function d(){if(!(c||l.disposed)){for(c=!0;!l.disposed&&o.length>0&&s.size>0;){let i=u();if(!i)break;let s=i,c=o.pop(),f=s.timeout??a.defaultTimeout;l.trackActive(1),l.releaseCapacity();let p=()=>{s.aborted=!0,c.cancel((0,r.abortError)(s.signal))};s.cleanupAbort=()=>{s.signal?.removeEventListener(`abort`,p),s.cleanupAbort=void 0},s.signal?.addEventListener(`abort`,p,{once:!0}),c.run(s.input,s.transferables,f).then(e=>t(e),e=>n(e));function t(e){s.cleanupAbort?.(),o.push(c),l.trackActive(-1),l.trackCompleted(),s.resolve(e),d(),l.settleIdle()}function n(t){s.cleanupAbort?.(),o.push(c),l.trackActive(-1),!s.aborted&&!(t instanceof e.FamiliarTerminatedError)&&l.trackFailed(),s.reject(t),d(),l.settleIdle()}}c=!1}}async function f(n,i={}){let{signal:o}=i,c=t.validatePriority(i.priority??0),u=t.validateTimeout(i.timeout),f=[...i.transferables??[]];if(l.disposed)throw new e.FamiliarTerminatedError;if(l.drainPromise)throw new e.FamiliarTerminatedError(`Worker is draining`);if(o?.aborted)throw(0,r.abortError)(o);for(;a.onFull===`wait`&&a.maxQueue!==void 0&&s.size>=a.maxQueue;){if(await l.waitForCapacity(o,c),l.disposed)throw new e.FamiliarTerminatedError;if(l.drainPromise)throw new e.FamiliarTerminatedError(`Worker is draining`);if(o?.aborted)throw l.releaseCapacity(),(0,r.abortError)(o)}let p,m,h=new Promise((e,t)=>{p=e,m=t}),g={input:n,priority:c,reject:m,resolve:p,signal:o,timeout:u,transferables:f};if(!s.enqueue(g,a.onFull===`wait`?void 0:a.maxQueue))throw new e.FamiliarQueueFullError(a.maxQueue);if(o){let e=()=>{s.remove(g)&&(g.cleanupAbort?.(),m((0,r.abortError)(o)),l.releaseCapacity(),l.settleIdle())};g.cleanupAbort=()=>{o.removeEventListener(`abort`,e),g.cleanupAbort=void 0},o.addEventListener(`abort`,e,{once:!0})}return d(),h}return{get disposalSignal(){return l.disposalSignal},dispose:l.dispose,get disposed(){return l.disposed},drain:l.drain,run:f,get stats(){return l.stats(s.size)},get status(){return l.status()},[Symbol.asyncDispose]:()=>l.drain({}),[Symbol.dispose]:l.dispose}}function a(t,n,i={}){let a,o=async function*(e){let a=[],o=()=>e.abort(i.signal?.reason);i.signal?.aborted?e.abort(i.signal.reason):i.signal?.addEventListener(`abort`,o,{once:!0});try{for(let[r,o]of n.entries()){let n=t.run(o,{priority:i.priority,signal:e.signal,timeout:i.timeout,transferables:i.getTransferables?.(o,r)}).catch(t=>{throw e.abort(t),t});n.catch(()=>void 0),a.push(n)}if(a.length===0&&e.signal.aborted)throw(0,r.abortError)(e.signal);for(let t of a){if(e.signal.aborted)throw(0,r.abortError)(e.signal);let n=await t;if(e.signal.aborted)throw(0,r.abortError)(e.signal);yield n}}catch(t){throw e.abort(t),t}finally{i.signal?.removeEventListener(`abort`,o),e.abort(new DOMException(`Batch consumer stopped`,`AbortError`)),await Promise.allSettled(a)}};return{[Symbol.asyncIterator](){let t={},n=new AbortController,r,i=()=>{if(a??=t,a===t)return r??=o(n),r};return{next:()=>i()?.next()??Promise.reject(new e.FamiliarRuntimeError(`Worker batches can only be consumed once`)),return:async i=>!a||a!==t?{done:!0,value:i}:(n.abort(new e.FamiliarTerminatedError(`Batch consumer stopped`)),r?.return(i)??{done:!0,value:i}),throw:async t=>{let r=i();if(!r)throw new e.FamiliarRuntimeError(`Worker batches can only be consumed once`);return n.abort(t),r.throw(t)}}}}}exports.createPool=i,exports.runBatch=a;
 //# sourceMappingURL=_pool.cjs.map

package/dist/_pool.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"_pool.cjs","names":[],"sources":["../src/_pool.ts"],"sourcesContent":["import { abortError } from '@vielzeug/arsenal/async';\nimport { createPoolCore, type PoolCore, type PoolOptions } from './_pool-core';\nimport { type QueueItem, TaskQueue } from './_queue';\nimport { FamiliarQueueFullError, FamiliarTerminatedError } from './errors';\nimport type { RunOptions, SlotStrategy, TaskGroup, TaskGroupOptions, WorkerPool } from './types';\n\nexport type { PoolOptions } from './_pool-core';\n\nexport function createPool<TInput, TOutput>(\n  slots: SlotStrategy<TInput, TOutput>[],\n  options: PoolOptions,\n): WorkerPool<TInput, TOutput> {\n  const freeSlots = [...slots];\n  const queue = new TaskQueue<TInput, TOutput>();\n  let draining = false;\n\n  const isIdle = (): boolean => freeSlots.length === slots.length && queue.size === 0;\n\n  const core: PoolCore = createPoolCore({\n    isIdle,\n    onDispose() {\n      for (const slot of slots) slot.terminate();\n\n      while (queue.size > 0) {\n        const item = queue.shift();\n\n        if (!item) break;\n\n        item.cleanupAbort?.();\n        item.reject(new FamiliarTerminatedError());\n      }\n    },\n    onDrainStart() {\n      // No pending waiters to reject for the queue-based pool; capacity waiters\n      // are rejected by the core's drain().\n    },\n  });\n\n  function nextItem(): QueueItem<TInput, TOutput> | undefined {\n    while (queue.size > 0) {\n      const item = queue.shift();\n\n      if (!item) break;\n\n      if (item.signal?.aborted) {\n        item.cleanupAbort?.();\n        item.reject(abortError(item.signal));\n        core.releaseCapacity();\n        continue;\n      }\n\n      return item;\n    }\n\n    core.settleIdle();\n\n    return undefined;\n  }\n\n  function drainQueue(): void {\n    if (draining || core.disposed) return;\n\n    draining = true;\n\n    while (!core.disposed && freeSlots.length > 0 && queue.size > 0) {\n      const next = nextItem();\n\n      if (!next) break;\n\n      const item = next;\n      const slot = freeSlots.pop()!;\n      const timeout = item.timeout ?? options.defaultTimeout;\n\n      core.trackActive(1);\n      core.releaseCapacity();\n\n      const onAbort = () => slot.cancel(abortError(item.signal!));\n\n      item.cleanupAbort = () => {\n        item.signal?.removeEventListener('abort', onAbort);\n        item.cleanupAbort = undefined;\n      };\n      item.signal?.addEventListener('abort', onAbort, { once: true });\n\n      slot.run(item.input, item.transferables, timeout).then(\n        (value) => finish(value),\n        (error: unknown) => fail(error),\n      );\n\n      function finish(value: TOutput): void {\n        item.cleanupAbort?.();\n        freeSlots.push(slot);\n        core.trackActive(-1);\n        core.trackCompleted();\n        item.resolve(value);\n        drainQueue();\n        core.settleIdle();\n      }\n\n      function fail(error: unknown): void {\n        item.cleanupAbort?.();\n        freeSlots.push(slot);\n        core.trackActive(-1);\n\n        if (!(error instanceof FamiliarTerminatedError) && error instanceof Error && error.name !== 'AbortError')\n          core.trackFailed();\n\n        item.reject(error);\n        drainQueue();\n        core.settleIdle();\n      }\n    }\n\n    draining = false;\n  }\n\n  async function run(input: TInput, runOptions: RunOptions = {}): Promise<TOutput> {\n    const { priority = 0, signal, timeout, transferables = [] } = runOptions;\n\n    if (core.disposed) throw new FamiliarTerminatedError();\n\n    if (core.drainPromise) throw new FamiliarTerminatedError('Worker is draining');\n\n    if (signal?.aborted) throw abortError(signal);\n\n    while (options.onFull === 'wait' && options.maxQueue !== undefined && queue.size >= options.maxQueue) {\n      await core.waitForCapacity(signal);\n\n      if (core.disposed) throw new FamiliarTerminatedError();\n\n      if (core.drainPromise) throw new FamiliarTerminatedError('Worker is draining');\n\n      if (signal?.aborted) throw abortError(signal);\n    }\n\n    let resolve!: (value: TOutput) => void;\n    let reject!: (reason: unknown) => void;\n    const promise = new Promise<TOutput>((res, rej) => {\n      resolve = res;\n      reject = rej;\n    });\n    const item: QueueItem<TInput, TOutput> = { input, priority, reject, resolve, signal, timeout, transferables };\n\n    if (!queue.enqueue(item, options.onFull === 'wait' ? undefined : options.maxQueue)) {\n      throw new FamiliarQueueFullError(options.maxQueue!);\n    }\n\n    if (signal) {\n      const onAbort = () => {\n        if (!queue.remove(item)) return;\n\n        item.cleanupAbort?.();\n        reject(abortError(signal));\n        core.releaseCapacity();\n        core.settleIdle();\n      };\n\n      item.cleanupAbort = () => {\n        signal.removeEventListener('abort', onAbort);\n        item.cleanupAbort = undefined;\n      };\n      signal.addEventListener('abort', onAbort, { once: true });\n    }\n\n    drainQueue();\n\n    return promise;\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    async prime(): Promise<void> {\n      await core.prime(slots);\n    },\n    run,\n    get stats() {\n      return core.stats(queue.size);\n    },\n    get status() {\n      return core.status();\n    },\n    [Symbol.asyncDispose]: () => core.drain({}),\n    [Symbol.dispose]: core.dispose,\n  };\n}\n\nexport async function* batch<TInput, TOutput>(\n  pool: WorkerPool<TInput, TOutput>,\n  inputs: readonly TInput[],\n  options: RunOptions = {},\n): AsyncIterable<TOutput> {\n  const controller = new AbortController();\n  const onAbort = () => controller.abort(options.signal?.reason);\n\n  options.signal?.addEventListener('abort', onAbort, { once: true });\n\n  const tasks = inputs.map((input) => pool.run(input, { ...options, signal: controller.signal }));\n\n  try {\n    for (const task of tasks) yield await task;\n  } catch (error) {\n    controller.abort(error);\n    await Promise.allSettled(tasks);\n    throw error;\n  } finally {\n    options.signal?.removeEventListener('abort', onAbort);\n    controller.abort();\n    await Promise.allSettled(tasks);\n  }\n}\n\nexport function createTaskGroup<TInput, TOutput>(\n  pool: WorkerPool<TInput, TOutput>,\n  name: string | undefined = undefined,\n  options: TaskGroupOptions = {},\n): TaskGroup<TInput, TOutput> {\n  const controller = new AbortController();\n  const tasks = new Set<Promise<TOutput>>();\n  let size = 0;\n  const onAbort = () => controller.abort(options.signal?.reason);\n\n  options.signal?.addEventListener('abort', onAbort, { once: true });\n\n  return {\n    abort(reason?: unknown): void {\n      controller.abort(reason);\n    },\n    async drain(): Promise<PromiseSettledResult<TOutput>[]> {\n      return Promise.allSettled([...tasks]);\n    },\n    get name() {\n      return name;\n    },\n    get pending() {\n      return tasks.size;\n    },\n    run(input, runOptions = {}): Promise<TOutput> {\n      const task = pool.run(input, { ...runOptions, signal: controller.signal });\n\n      size += 1;\n      tasks.add(task);\n      void task.finally(() => tasks.delete(task));\n\n      return task;\n    },\n    get size() {\n      return size;\n    },\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"_pool.cjs","names":[],"sources":["../src/_pool.ts"],"sourcesContent":["import { abortError } from '@vielzeug/arsenal';\nimport { createPoolCore, type PoolCore, type PoolOptions, validatePriority, validateTimeout } from './_pool-core.js';\nimport { type QueueItem, TaskQueue } from './_queue.js';\nimport { FamiliarQueueFullError, 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: SlotStrategy<TInput, TOutput>[],\n  options: PoolOptions,\n): WorkerPool<TInput, TOutput> {\n  const freeSlots = [...slots];\n  const queue = new TaskQueue<TInput, TOutput>();\n  let draining = false;\n\n  const isIdle = (): boolean => freeSlots.length === slots.length && queue.size === 0;\n\n  const core: PoolCore = createPoolCore({\n    isIdle,\n    onDispose() {\n      for (const slot of slots) slot.terminate();\n\n      while (queue.size > 0) {\n        const item = queue.shift();\n\n        if (!item) break;\n\n        item.cleanupAbort?.();\n        item.reject(new FamiliarTerminatedError());\n      }\n    },\n    onDrainStart() {\n      // No pending waiters to reject for the queue-based pool; capacity waiters\n      // are rejected by the core's drain().\n    },\n  });\n\n  function nextItem(): QueueItem<TInput, TOutput> | undefined {\n    while (queue.size > 0) {\n      const item = queue.shift();\n\n      if (!item) break;\n\n      if (item.signal?.aborted) {\n        item.cleanupAbort?.();\n        item.reject(abortError(item.signal));\n        core.releaseCapacity();\n        continue;\n      }\n\n      return item;\n    }\n\n    core.settleIdle();\n\n    return undefined;\n  }\n\n  function drainQueue(): void {\n    if (draining || core.disposed) return;\n\n    draining = true;\n\n    while (!core.disposed && freeSlots.length > 0 && queue.size > 0) {\n      const next = nextItem();\n\n      if (!next) break;\n\n      const item = next;\n      const slot = freeSlots.pop()!;\n      const timeout = item.timeout ?? options.defaultTimeout;\n\n      core.trackActive(1);\n      core.releaseCapacity();\n\n      const onAbort = () => {\n        item.aborted = true;\n        slot.cancel(abortError(item.signal!));\n      };\n\n      item.cleanupAbort = () => {\n        item.signal?.removeEventListener('abort', onAbort);\n        item.cleanupAbort = undefined;\n      };\n      item.signal?.addEventListener('abort', onAbort, { once: true });\n\n      slot.run(item.input, item.transferables, timeout).then(\n        (value) => finish(value),\n        (error: unknown) => fail(error),\n      );\n\n      function finish(value: TOutput): void {\n        item.cleanupAbort?.();\n        freeSlots.push(slot);\n        core.trackActive(-1);\n        core.trackCompleted();\n        item.resolve(value);\n        drainQueue();\n        core.settleIdle();\n      }\n\n      function fail(error: unknown): void {\n        item.cleanupAbort?.();\n        freeSlots.push(slot);\n        core.trackActive(-1);\n\n        if (!item.aborted && !(error instanceof FamiliarTerminatedError)) core.trackFailed();\n\n        item.reject(error);\n        drainQueue();\n        core.settleIdle();\n      }\n    }\n\n    draining = false;\n  }\n\n  async function run(input: TInput, runOptions: RunOptions = {}): Promise<TOutput> {\n    const { signal } = runOptions;\n    const priority = validatePriority(runOptions.priority ?? 0);\n    const timeout = validateTimeout(runOptions.timeout);\n    const transferables = [...(runOptions.transferables ?? [])];\n\n    if (core.disposed) throw new FamiliarTerminatedError();\n\n    if (core.drainPromise) throw new FamiliarTerminatedError('Worker is draining');\n\n    if (signal?.aborted) throw abortError(signal);\n\n    while (options.onFull === 'wait' && options.maxQueue !== undefined && queue.size >= options.maxQueue) {\n      await core.waitForCapacity(signal, priority);\n\n      if (core.disposed) throw new FamiliarTerminatedError();\n\n      if (core.drainPromise) throw new FamiliarTerminatedError('Worker is draining');\n\n      if (signal?.aborted) {\n        core.releaseCapacity();\n        throw abortError(signal);\n      }\n    }\n\n    let resolve!: (value: TOutput) => void;\n    let reject!: (reason: unknown) => void;\n    const promise = new Promise<TOutput>((res, rej) => {\n      resolve = res;\n      reject = rej;\n    });\n    const item: QueueItem<TInput, TOutput> = { input, priority, reject, resolve, signal, timeout, transferables };\n\n    if (!queue.enqueue(item, options.onFull === 'wait' ? undefined : options.maxQueue)) {\n      throw new FamiliarQueueFullError(options.maxQueue!);\n    }\n\n    if (signal) {\n      const onAbort = () => {\n        if (!queue.remove(item)) return;\n\n        item.cleanupAbort?.();\n        reject(abortError(signal));\n        core.releaseCapacity();\n        core.settleIdle();\n      };\n\n      item.cleanupAbort = () => {\n        signal.removeEventListener('abort', onAbort);\n        item.cleanupAbort = undefined;\n      };\n      signal.addEventListener('abort', onAbort, { once: true });\n    }\n\n    drainQueue();\n\n    return promise;\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(queue.size);\n    },\n    get status() {\n      return core.status();\n    },\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"],"mappings":"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"}

package/dist/_pool.d.ts

@@ -1,7 +1,10 @@
-import { type PoolOptions } from './_pool-core';
-import type { RunOptions, SlotStrategy, TaskGroup, TaskGroupOptions, WorkerPool } from './types';
-export type { PoolOptions } from './_pool-core';
+import { type PoolOptions } from './_pool-core.js';
+import type { RunOptions, SlotStrategy, WorkerPool } from './types.js';
+export type { PoolOptions } from './_pool-core.js';
 export declare function createPool<TInput, TOutput>(slots: SlotStrategy<TInput, TOutput>[], options: PoolOptions): WorkerPool<TInput, TOutput>;
-export declare function batch<TInput, TOutput>(pool: WorkerPool<TInput, TOutput>, inputs: readonly TInput[], options?: RunOptions): AsyncIterable<TOutput>;
-export declare function createTaskGroup<TInput, TOutput>(pool: WorkerPool<TInput, TOutput>, name?: string | undefined, options?: TaskGroupOptions): TaskGroup<TInput, TOutput>;
+export type BatchOptions<TInput> = Pick<RunOptions, 'priority' | 'signal' | 'timeout'> & {
+    getTransferables?: (input: TInput, index: number) => readonly Transferable[];
+};
+/** Run related tasks concurrently and yield their results in input order. */
+export declare function runBatch<TInput, TOutput>(pool: WorkerPool<TInput, TOutput>, inputs: readonly TInput[], options?: BatchOptions<TInput>): AsyncIterable<TOutput>;
 //# sourceMappingURL=_pool.d.ts.map

package/dist/_pool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"_pool.d.ts","sourceRoot":"","sources":["../src/_pool.ts"],"names":[],"mappings":"AACA,OAAO,EAAiC,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAG/E,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,SAAS,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAEjG,YAAY,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD,wBAAgB,UAAU,CAAC,MAAM,EAAE,OAAO,EACxC,KAAK,EAAE,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EACtC,OAAO,EAAE,WAAW,GACnB,UAAU,CAAC,MAAM,EAAE,OAAO,CAAC,CAoL7B;AAED,wBAAuB,KAAK,CAAC,MAAM,EAAE,OAAO,EAC1C,IAAI,EAAE,UAAU,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,MAAM,EAAE,SAAS,MAAM,EAAE,EACzB,OAAO,GAAE,UAAe,GACvB,aAAa,CAAC,OAAO,CAAC,CAmBxB;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,OAAO,EAC7C,IAAI,EAAE,UAAU,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,IAAI,GAAE,MAAM,GAAG,SAAqB,EACpC,OAAO,GAAE,gBAAqB,GAC7B,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,CAkC5B"}
+{"version":3,"file":"_pool.d.ts","sourceRoot":"","sources":["../src/_pool.ts"],"names":[],"mappings":"AACA,OAAO,EAAiC,KAAK,WAAW,EAAqC,MAAM,iBAAiB,CAAC;AAGrH,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAEvE,YAAY,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEnD,wBAAgB,UAAU,CAAC,MAAM,EAAE,OAAO,EACxC,KAAK,EAAE,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EACtC,OAAO,EAAE,WAAW,GACnB,UAAU,CAAC,MAAM,EAAE,OAAO,CAAC,CAyL7B;AAED,MAAM,MAAM,YAAY,CAAC,MAAM,IAAI,IAAI,CAAC,UAAU,EAAE,UAAU,GAAG,QAAQ,GAAG,SAAS,CAAC,GAAG;IACvF,gBAAgB,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,SAAS,YAAY,EAAE,CAAC;CAC9E,CAAC;AAEF,6EAA6E;AAC7E,wBAAgB,QAAQ,CAAC,MAAM,EAAE,OAAO,EACtC,IAAI,EAAE,UAAU,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,MAAM,EAAE,SAAS,MAAM,EAAE,EACzB,OAAO,GAAE,YAAY,CAAC,MAAM,CAAM,GACjC,aAAa,CAAC,OAAO,CAAC,CA0ExB"}