@vielzeug/familiar 26.10.14 → 26.10.16

package/dist/familiar.js

@@ -1,2 +1,529 @@
-import{abortError as e,tapper as t}from"@vielzeug/arsenal";function unrefTimer(e){typeof e==`object`&&e&&`unref`in e&&e.unref()}var FamiliarError=class extends Error{constructor(e,t){super(e,t),this.name=new.target.name,Object.setPrototypeOf(this,new.target.prototype)}},FamiliarInvalidOptionsError=class extends FamiliarError{},FamiliarQueueFullError=class extends FamiliarError{maxQueue;constructor(e){super(`Queue is full (maxQueue=${e})`),this.maxQueue=e}},FamiliarTaskError=class extends FamiliarError{},FamiliarTerminatedError=class extends FamiliarError{constructor(e=`Worker was terminated`){super(e)}},FamiliarTimeoutError=class extends FamiliarError{timeoutMs;constructor(e,t=`Task`){super(`${t} timed out after ${e}ms`),this.timeoutMs=e}},FamiliarRuntimeError=class extends FamiliarError{},n=2147483647;function validatePriority(e){if(!Number.isFinite(e))throw new FamiliarInvalidOptionsError("`priority` must be a finite number");return e}function validateTimeout(e,t=`timeout`){if(e!==void 0&&(!Number.isInteger(e)||e<1||e>2147483647))throw new FamiliarInvalidOptionsError(`\`${t}\` must be an integer from 1 through ${n}`);return e}function createPoolCore(n,r){let i=[...n],a=[],o=[],s=[],c=t(),l=new AbortController,u=0,d=0,f=0,p=0,m=0,h,g=!1;function isIdle(){return i.length===n.length&&a.length===0}function settleIdle(){if(isIdle())for(let e of o.splice(0))e.timer&&clearTimeout(e.timer),e.resolve()}function waitForIdle(e){return isIdle()?Promise.resolve():new Promise((t,n)=>{let r={reject:n,resolve:t};e.timeout!==void 0&&(r.timer=setTimeout(()=>{let t=o.indexOf(r);t!==-1&&o.splice(t,1),n(new FamiliarTimeoutError(e.timeout,`Drain`))},e.timeout),unrefTimer(r.timer)),o.push(r)})}function releaseCapacity(){s.shift()?.resolve()}function rejectCapacity(e){for(let t of s.splice(0))t.reject(e)}function waitForCapacity(t,n){return t?.aborted?Promise.reject(e(t)):new Promise((r,i)=>{let a=!1,o={cleanup(){t?.removeEventListener(`abort`,onAbort)},priority:n,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:f++},onAbort=()=>o.reject(e(t));t?.addEventListener(`abort`,onAbort,{once:!0}),s.push(o),s.sort((e,t)=>t.priority-e.priority||e.sequence-t.sequence)})}function acquire(t,n){let{priority:i,signal:o}=t;return o?.aborted?Promise.reject(e(o)):(async()=>{for(;;){if(g)throw new FamiliarTerminatedError;if(h)throw new FamiliarTerminatedError(`Worker is draining`);if(r.maxQueue===void 0||a.length<r.maxQueue)return admit(t,n??(e=>e));if(r.onFull===`reject`)throw new FamiliarQueueFullError(r.maxQueue);if(await waitForCapacity(o,i),o?.aborted)throw releaseCapacity(),e(o)}})()}function admit(t,n){let{priority:r,signal:o}=t,s=i.pop();if(s)try{return Promise.resolve(n(s))}catch(e){return release(s),settleIdle(),Promise.reject(e)}return new Promise((t,i)=>{let s={cleanup(){s.signal?.removeEventListener(`abort`,onAbort)},priority:r,reject(e){s.cleanup();let t=a.indexOf(s);t!==-1&&(a.splice(t,1),releaseCapacity()),i(e),settleIdle()},sequence:d++,signal:o,start(e){s.cleanup();try{t(n(e))}catch(t){release(e),settleIdle(),i(t)}}},onAbort=()=>s.reject(e(s.signal));s.signal?.addEventListener(`abort`,onAbort,{once:!0}),a.push(s),a.sort((e,t)=>t.priority-e.priority||e.sequence-t.sequence)})}function release(e){let t=a.shift();t?(t.start(e),releaseCapacity()):i.push(e)}function dispose(){if(!g){g=!0,l.abort();for(let e of n)e.terminate();for(let e of a.splice(0))e.reject(new FamiliarTerminatedError);rejectCapacity(new FamiliarTerminatedError),settleIdle(),c.emit({type:`dispose`}),c.clear()}}function drain(e={}){if(g)return Promise.resolve();try{validateTimeout(e.timeout,`drain.timeout`)}catch(e){return Promise.reject(e)}return h||(rejectCapacity(new FamiliarTerminatedError(`Worker is draining`)),h=waitForIdle(e).then(()=>dispose(),e=>{throw dispose(),e}),h)}return{acquire,disposalSignal:l.signal,dispose,get disposed(){return g},drain,get drainPromise(){return h},emitTap(e){c.emit(e)},release,settleIdle,stats(){return{active:u,completed:p,failed:m,queued:a.length+s.length}},status(){return g?`terminated`:u===0?`idle`:`running`},tap(e,t){return g?()=>void 0:c.tap(e,t)},trackActive(e){u+=e},trackCompleted(){p+=1},trackFailed(){m+=1}}}function createPool(t,n){let r=createPoolCore(t,n);for(let e of t)e.notify=e=>r.emitTap({error:e,type:`worker-error`});function run(t,i={}){let a,o,s;try{a=validatePriority(i.priority??0),o=validateTimeout(i.timeout)??n.defaultTimeout,s=[...i.transferables??[]]}catch(e){return Promise.reject(e)}return r.acquire({priority:a,signal:i.signal},n=>{r.trackActive(1);let onAbort=()=>n.cancel(e(i.signal));i.signal?.addEventListener(`abort`,onAbort,{once:!0});let finish=async()=>{try{let e=await n.run(t,s,o);return r.trackCompleted(),e}catch(e){throw!i.signal?.aborted&&!(e instanceof FamiliarTerminatedError)&&r.trackFailed(),e}finally{i.signal?.removeEventListener(`abort`,onAbort),r.trackActive(-1),r.release(n),r.settleIdle()}};return finish()})}return{get disposalSignal(){return r.disposalSignal},dispose:r.dispose,get disposed(){return r.disposed},drain:r.drain,run,get stats(){return r.stats()},get status(){return r.status()},tap:r.tap,[Symbol.asyncDispose]:()=>r.drain({}),[Symbol.dispose]:r.dispose}}function runBatch(t,n,r={}){let i,iterate=async function*(i){let a=[],onAbort=()=>i.abort(r.signal?.reason);r.signal?.aborted?i.abort(r.signal.reason):r.signal?.addEventListener(`abort`,onAbort,{once:!0});try{for(let[e,o]of n.entries()){let n=t.run(o,{priority:r.priority,signal:i.signal,timeout:r.timeout,transferables:r.getTransferables?.(o,e)}).catch(e=>{throw i.abort(e),e});n.catch(()=>void 0),a.push(n)}if(a.length===0&&i.signal.aborted)throw e(i.signal);for(let t of a){if(i.signal.aborted)throw e(i.signal);let n=await t;if(i.signal.aborted)throw e(i.signal);yield n}}catch(e){throw i.abort(e),e}finally{r.signal?.removeEventListener(`abort`,onAbort),i.abort(new DOMException(`Batch consumer stopped`,`AbortError`)),await Promise.allSettled(a)}};return{[Symbol.asyncIterator](){let e={},t=new AbortController,n,start=()=>{if(i??=e,i===e)return n??=iterate(t),n};return{next:()=>start()?.next()??Promise.reject(new FamiliarRuntimeError(`Worker batches can only be consumed once`)),return:async r=>!i||i!==e?{done:!0,value:r}:(t.abort(new FamiliarTerminatedError(`Batch consumer stopped`)),n?.return(r)??{done:!0,value:r}),throw:async e=>{let n=start();if(!n)throw new FamiliarRuntimeError(`Worker batches can only be consumed once`);return t.abort(e),n.throw(e)}}}}}function createStreamPool(t,n){let r=createPoolCore(t,n);for(let e of t)e.notify=e=>r.emitTap({error:e,type:`worker-error`});function runStream(t,i={}){let a=validatePriority(i.priority??0),o=validateTimeout(i.timeout)??n.defaultTimeout,s=[...i.transferables??[]],c,iterate=async function*(n){let onAbort=()=>n.abort(i.signal?.reason),c,onCancel;i.signal?.aborted?n.abort(i.signal.reason):i.signal?.addEventListener(`abort`,onAbort,{once:!0});try{let i=await r.acquire({priority:a,signal:n.signal},i=>(c=i,r.trackActive(1),onCancel=()=>c?.cancel(e(n.signal)),n.signal.addEventListener(`abort`,onCancel,{once:!0}),i.stream(t,{priority:a,signal:n.signal,timeout:o,transferables:s})));for await(let e of i.iterable)yield e;await i.done,r.trackCompleted()}catch(e){throw c&&!n.signal.aborted&&!(e instanceof FamiliarTerminatedError)&&r.trackFailed(),e}finally{i.signal?.removeEventListener(`abort`,onAbort),c&&(onCancel&&n.signal.removeEventListener(`abort`,onCancel),r.trackActive(-1),r.release(c),r.settleIdle())}};return{[Symbol.asyncIterator](){let e={},t=new AbortController,n,start=()=>{if(c??=e,c===e)return n??=iterate(t),n};return{next:()=>start()?.next()??Promise.reject(new FamiliarRuntimeError(`Worker streams can only be consumed once`)),return:async r=>!c||c!==e?{done:!0,value:r}:(t.abort(new FamiliarTerminatedError(`Stream consumer stopped`)),n?.return(r)??{done:!0,value:r}),throw:async e=>{let n=start();if(!n)throw new FamiliarRuntimeError(`Worker streams can only be consumed once`);return t.abort(e),n.throw(e)}}}}}return{get disposalSignal(){return r.disposalSignal},dispose:r.dispose,get disposed(){return r.disposed},drain:r.drain,runStream,get stats(){return r.stats()},get status(){return r.status()},tap:r.tap,[Symbol.asyncDispose]:()=>r.drain({}),[Symbol.dispose]:r.dispose}}function resolveOptions(e={}){let{concurrency:t=1,maxQueue:n,onFull:r=`reject`,timeout:i}=e,a=t===`auto`?Math.min(512,Math.max(1,globalThis.navigator?.hardwareConcurrency??1)):t;if(!Number.isInteger(a)||a<1||a>512)throw new FamiliarInvalidOptionsError('`concurrency` must be a positive integer ≤ 512 or "auto"');if(n!==void 0&&(!Number.isInteger(n)||n<1))throw new FamiliarInvalidOptionsError("`maxQueue` must be a positive integer");if(r!==`reject`&&r!==`wait`)throw new FamiliarInvalidOptionsError('`onFull` must be "reject" or "wait"');return validateTimeout(i),{concurrency:a,maxQueue:n,onFull:r,timeout:i}}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 FamiliarRuntimeError(e.message,{cause:t}):new 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 FamiliarTerminatedError(`Stream consumer stopped`)),n=[],r=[],i=!1,a,emit=e=>{let t=r.shift();t?t({done:!1,value:e}):n.push(e)},finish=e=>{for(i=!0,a=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(a!==void 0)throw a;return i?{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 FamiliarTerminatedError)}#a(e,t,n,r,i){if(this.#t)return Promise.reject(new FamiliarTerminatedError);if(this.#n)return Promise.reject(new FamiliarRuntimeError(`Worker slot is already busy`));try{let a=this.#o(),o=this.#r;return this.#r=o===2**53-1?0:o+1,new Promise((s,c)=>{let l={emit:i,id:o,kind:r,reject:c,resolve:s};this.#n=l,n!==void 0&&(l.timer=setTimeout(()=>this.cancel(new FamiliarTimeoutError(n)),n),unrefTimer(l.timer));try{a.postMessage({id:o,input:e,kind:r,version:1},t)}catch(e){this.cancel(new 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 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 FamiliarRuntimeError(t.message||`Worker failed`)),e.onmessageerror=()=>this.#c(e,new FamiliarRuntimeError(`Worker response could not be deserialized`)),this.#i=e,e}catch(e){throw new 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){if(this.#n){if(!isWorkerResponse(e)||e.id!==this.#n.id||this.#n.kind===`run`&&e.kind===`chunk`){this.cancel(new FamiliarRuntimeError(`Worker returned an incompatible protocol response`));return}if(e.kind===`chunk`){this.#n.emit?.(e.value);return}if(e.kind===`error`){this.#u(`reject`,responseError(e.error));return}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(e,t={}){let n=resolveOptions(t);return createPool(slots(e,n),{defaultTimeout:n.timeout,maxQueue:n.maxQueue,onFull:n.onFull})}function createStreamWorker(e,t={}){let n=resolveOptions(t);return createStreamPool(slots(e,n),{defaultTimeout:n.timeout,maxQueue:n.maxQueue,onFull:n.onFull})}export{FamiliarError,FamiliarInvalidOptionsError,FamiliarQueueFullError,FamiliarRuntimeError,FamiliarTaskError,FamiliarTerminatedError,FamiliarTimeoutError,createStreamWorker,createWorker,runBatch};
+import { abortError as e, tapper as t } from "@vielzeug/arsenal";
+//#region src/_timers.ts
+function unrefTimer(e) {
+	typeof e == "object" && e && "unref" in e && e.unref();
+}
+//#endregion
+//#region src/errors.ts
+var FamiliarError = class extends Error {
+	constructor(e, t) {
+		super(e, t), this.name = new.target.name, Object.setPrototypeOf(this, new.target.prototype);
+	}
+}, FamiliarInvalidOptionsError = class extends FamiliarError {}, FamiliarQueueFullError = class extends FamiliarError {
+	maxQueue;
+	constructor(e) {
+		super(`Queue is full (maxQueue=${e})`), this.maxQueue = e;
+	}
+}, FamiliarTaskError = class extends FamiliarError {}, FamiliarTerminatedError = class extends FamiliarError {
+	constructor(e = "Worker was terminated") {
+		super(e);
+	}
+}, FamiliarTimeoutError = class extends FamiliarError {
+	timeoutMs;
+	constructor(e, t = "Task") {
+		super(`${t} timed out after ${e}ms`), this.timeoutMs = e;
+	}
+}, FamiliarRuntimeError = class extends FamiliarError {}, n = 2147483647;
+function validatePriority(e) {
+	if (!Number.isFinite(e)) throw new FamiliarInvalidOptionsError("`priority` must be a finite number");
+	return e;
+}
+function validateTimeout(e, t = "timeout") {
+	if (e !== void 0 && (!Number.isInteger(e) || e < 1 || e > 2147483647)) throw new FamiliarInvalidOptionsError(`\`${t}\` must be an integer from 1 through ${n}`);
+	return e;
+}
+function createPoolCore(n, r) {
+	let i = [...n], a = [], o = [], s = [], c = t(), l = new AbortController(), u = 0, d = 0, f = 0, p = 0, m = 0, h, g = !1;
+	function isIdle() {
+		return i.length === n.length && a.length === 0;
+	}
+	function settleIdle() {
+		if (isIdle()) for (let e of o.splice(0)) e.timer && clearTimeout(e.timer), e.resolve();
+	}
+	function waitForIdle(e) {
+		return isIdle() ? Promise.resolve() : new Promise((t, n) => {
+			let r = {
+				reject: n,
+				resolve: t
+			};
+			e.timeout !== void 0 && (r.timer = setTimeout(() => {
+				let t = o.indexOf(r);
+				t !== -1 && o.splice(t, 1), n(new FamiliarTimeoutError(e.timeout, "Drain"));
+			}, e.timeout), unrefTimer(r.timer)), o.push(r);
+		});
+	}
+	function releaseCapacity() {
+		s.shift()?.resolve();
+	}
+	function rejectCapacity(e) {
+		for (let t of s.splice(0)) t.reject(e);
+	}
+	function waitForCapacity(t, n) {
+		return t?.aborted ? Promise.reject(e(t)) : new Promise((r, i) => {
+			let a = !1, o = {
+				cleanup() {
+					t?.removeEventListener("abort", onAbort);
+				},
+				priority: n,
+				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: f++
+			}, onAbort = () => o.reject(e(t));
+			t?.addEventListener("abort", onAbort, { once: !0 }), s.push(o), s.sort((e, t) => t.priority - e.priority || e.sequence - t.sequence);
+		});
+	}
+	function acquire(t, n) {
+		let { priority: i, signal: o } = t;
+		return o?.aborted ? Promise.reject(e(o)) : (async () => {
+			for (;;) {
+				if (g) throw new FamiliarTerminatedError();
+				if (h) throw new FamiliarTerminatedError("Worker is draining");
+				if (r.maxQueue === void 0 || a.length < r.maxQueue) return admit(t, n ?? ((e) => e));
+				if (r.onFull === "reject") throw new FamiliarQueueFullError(r.maxQueue);
+				if (await waitForCapacity(o, i), o?.aborted) throw releaseCapacity(), e(o);
+			}
+		})();
+	}
+	function admit(t, n) {
+		let { priority: r, signal: o } = t, s = i.pop();
+		if (s) try {
+			return Promise.resolve(n(s));
+		} catch (e) {
+			return release(s), settleIdle(), Promise.reject(e);
+		}
+		return new Promise((t, i) => {
+			let s = {
+				cleanup() {
+					s.signal?.removeEventListener("abort", onAbort);
+				},
+				priority: r,
+				reject(e) {
+					s.cleanup();
+					let t = a.indexOf(s);
+					t !== -1 && (a.splice(t, 1), releaseCapacity()), i(e), settleIdle();
+				},
+				sequence: d++,
+				signal: o,
+				start(e) {
+					s.cleanup();
+					try {
+						t(n(e));
+					} catch (t) {
+						release(e), settleIdle(), i(t);
+					}
+				}
+			}, onAbort = () => s.reject(e(s.signal));
+			s.signal?.addEventListener("abort", onAbort, { once: !0 }), a.push(s), a.sort((e, t) => t.priority - e.priority || e.sequence - t.sequence);
+		});
+	}
+	function release(e) {
+		let t = a.shift();
+		t ? (t.start(e), releaseCapacity()) : i.push(e);
+	}
+	function dispose() {
+		if (!g) {
+			g = !0, l.abort();
+			for (let e of n) e.terminate();
+			for (let e of a.splice(0)) e.reject(new FamiliarTerminatedError());
+			rejectCapacity(new FamiliarTerminatedError()), settleIdle(), c.emit({ type: "dispose" }), c.clear();
+		}
+	}
+	function drain(e = {}) {
+		if (g) return Promise.resolve();
+		try {
+			validateTimeout(e.timeout, "drain.timeout");
+		} catch (e) {
+			return Promise.reject(e);
+		}
+		return h || (rejectCapacity(new FamiliarTerminatedError("Worker is draining")), h = waitForIdle(e).then(() => dispose(), (e) => {
+			throw dispose(), e;
+		}), h);
+	}
+	return {
+		acquire,
+		disposalSignal: l.signal,
+		dispose,
+		get disposed() {
+			return g;
+		},
+		drain,
+		get drainPromise() {
+			return h;
+		},
+		emitTap(e) {
+			c.emit(e);
+		},
+		release,
+		settleIdle,
+		stats() {
+			return {
+				active: u,
+				completed: p,
+				failed: m,
+				queued: a.length + s.length
+			};
+		},
+		status() {
+			return g ? "terminated" : u === 0 ? "idle" : "running";
+		},
+		tap(e, t) {
+			return g ? () => void 0 : c.tap(e, t);
+		},
+		trackActive(e) {
+			u += e;
+		},
+		trackCompleted() {
+			p += 1;
+		},
+		trackFailed() {
+			m += 1;
+		}
+	};
+}
+//#endregion
+//#region src/_pool.ts
+function createPool(t, n) {
+	let r = createPoolCore(t, n);
+	for (let e of t) e.notify = (e) => r.emitTap({
+		error: e,
+		type: "worker-error"
+	});
+	function run(t, i = {}) {
+		let a, o, s;
+		try {
+			a = validatePriority(i.priority ?? 0), o = validateTimeout(i.timeout) ?? n.defaultTimeout, s = [...i.transferables ?? []];
+		} catch (e) {
+			return Promise.reject(e);
+		}
+		return r.acquire({
+			priority: a,
+			signal: i.signal
+		}, (n) => {
+			r.trackActive(1);
+			let onAbort = () => n.cancel(e(i.signal));
+			i.signal?.addEventListener("abort", onAbort, { once: !0 });
+			let finish = async () => {
+				try {
+					let e = await n.run(t, s, o);
+					return r.trackCompleted(), e;
+				} catch (e) {
+					throw !i.signal?.aborted && !(e instanceof FamiliarTerminatedError) && r.trackFailed(), e;
+				} finally {
+					i.signal?.removeEventListener("abort", onAbort), r.trackActive(-1), r.release(n), r.settleIdle();
+				}
+			};
+			return finish();
+		});
+	}
+	return {
+		get disposalSignal() {
+			return r.disposalSignal;
+		},
+		dispose: r.dispose,
+		get disposed() {
+			return r.disposed;
+		},
+		drain: r.drain,
+		run,
+		get stats() {
+			return r.stats();
+		},
+		get status() {
+			return r.status();
+		},
+		tap: r.tap,
+		[Symbol.asyncDispose]: () => r.drain({}),
+		[Symbol.dispose]: r.dispose
+	};
+}
+function runBatch(t, n, r = {}) {
+	let i, iterate = async function* (i) {
+		let a = [], onAbort = () => i.abort(r.signal?.reason);
+		r.signal?.aborted ? i.abort(r.signal.reason) : r.signal?.addEventListener("abort", onAbort, { once: !0 });
+		try {
+			for (let [e, o] of n.entries()) {
+				let n = t.run(o, {
+					priority: r.priority,
+					signal: i.signal,
+					timeout: r.timeout,
+					transferables: r.getTransferables?.(o, e)
+				}).catch((e) => {
+					throw i.abort(e), e;
+				});
+				n.catch(() => void 0), a.push(n);
+			}
+			if (a.length === 0 && i.signal.aborted) throw e(i.signal);
+			for (let t of a) {
+				if (i.signal.aborted) throw e(i.signal);
+				let n = await t;
+				if (i.signal.aborted) throw e(i.signal);
+				yield n;
+			}
+		} catch (e) {
+			throw i.abort(e), e;
+		} finally {
+			r.signal?.removeEventListener("abort", onAbort), i.abort(new DOMException("Batch consumer stopped", "AbortError")), await Promise.allSettled(a);
+		}
+	};
+	return { [Symbol.asyncIterator]() {
+		let e = {}, t = new AbortController(), n, start = () => {
+			if (i ??= e, i === e) return n ??= iterate(t), n;
+		};
+		return {
+			next: () => start()?.next() ?? Promise.reject(new FamiliarRuntimeError("Worker batches can only be consumed once")),
+			return: async (r) => !i || i !== e ? {
+				done: !0,
+				value: r
+			} : (t.abort(new FamiliarTerminatedError("Batch consumer stopped")), n?.return(r) ?? {
+				done: !0,
+				value: r
+			}),
+			throw: async (e) => {
+				let n = start();
+				if (!n) throw new FamiliarRuntimeError("Worker batches can only be consumed once");
+				return t.abort(e), n.throw(e);
+			}
+		};
+	} };
+}
+//#endregion
+//#region src/_stream-pool.ts
+function createStreamPool(t, n) {
+	let r = createPoolCore(t, n);
+	for (let e of t) e.notify = (e) => r.emitTap({
+		error: e,
+		type: "worker-error"
+	});
+	function runStream(t, i = {}) {
+		let a = validatePriority(i.priority ?? 0), o = validateTimeout(i.timeout) ?? n.defaultTimeout, s = [...i.transferables ?? []], c, iterate = async function* (n) {
+			let onAbort = () => n.abort(i.signal?.reason), c, onCancel;
+			i.signal?.aborted ? n.abort(i.signal.reason) : i.signal?.addEventListener("abort", onAbort, { once: !0 });
+			try {
+				let i = await r.acquire({
+					priority: a,
+					signal: n.signal
+				}, (i) => (c = i, r.trackActive(1), onCancel = () => c?.cancel(e(n.signal)), n.signal.addEventListener("abort", onCancel, { once: !0 }), i.stream(t, {
+					priority: a,
+					signal: n.signal,
+					timeout: o,
+					transferables: s
+				})));
+				for await (let e of i.iterable) yield e;
+				await i.done, r.trackCompleted();
+			} catch (e) {
+				throw c && !n.signal.aborted && !(e instanceof FamiliarTerminatedError) && r.trackFailed(), e;
+			} finally {
+				i.signal?.removeEventListener("abort", onAbort), c && (onCancel && n.signal.removeEventListener("abort", onCancel), r.trackActive(-1), r.release(c), r.settleIdle());
+			}
+		};
+		return { [Symbol.asyncIterator]() {
+			let e = {}, t = new AbortController(), n, start = () => {
+				if (c ??= e, c === e) return n ??= iterate(t), n;
+			};
+			return {
+				next: () => start()?.next() ?? Promise.reject(new FamiliarRuntimeError("Worker streams can only be consumed once")),
+				return: async (r) => !c || c !== e ? {
+					done: !0,
+					value: r
+				} : (t.abort(new FamiliarTerminatedError("Stream consumer stopped")), n?.return(r) ?? {
+					done: !0,
+					value: r
+				}),
+				throw: async (e) => {
+					let n = start();
+					if (!n) throw new FamiliarRuntimeError("Worker streams can only be consumed once");
+					return t.abort(e), n.throw(e);
+				}
+			};
+		} };
+	}
+	return {
+		get disposalSignal() {
+			return r.disposalSignal;
+		},
+		dispose: r.dispose,
+		get disposed() {
+			return r.disposed;
+		},
+		drain: r.drain,
+		runStream,
+		get stats() {
+			return r.stats();
+		},
+		get status() {
+			return r.status();
+		},
+		tap: r.tap,
+		[Symbol.asyncDispose]: () => r.drain({}),
+		[Symbol.dispose]: r.dispose
+	};
+}
+//#endregion
+//#region src/worker.ts
+function resolveOptions(e = {}) {
+	let { concurrency: t = 1, maxQueue: n, onFull: r = "reject", timeout: i } = e, a = t === "auto" ? Math.min(512, Math.max(1, globalThis.navigator?.hardwareConcurrency ?? 1)) : t;
+	if (!Number.isInteger(a) || a < 1 || a > 512) throw new FamiliarInvalidOptionsError("`concurrency` must be a positive integer ≤ 512 or \"auto\"");
+	if (n !== void 0 && (!Number.isInteger(n) || n < 1)) throw new FamiliarInvalidOptionsError("`maxQueue` must be a positive integer");
+	if (r !== "reject" && r !== "wait") throw new FamiliarInvalidOptionsError("`onFull` must be \"reject\" or \"wait\"");
+	return validateTimeout(i), {
+		concurrency: a,
+		maxQueue: n,
+		onFull: r,
+		timeout: i
+	};
+}
+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 FamiliarRuntimeError(e.message, { cause: t }) : new 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 FamiliarTerminatedError("Stream consumer stopped")), n = [], r = [], i = !1, a, emit = (e) => {
+			let t = r.shift();
+			t ? t({
+				done: !1,
+				value: e
+			}) : n.push(e);
+		}, finish = (e) => {
+			for (i = !0, a = 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 (a !== void 0) throw a;
+					return i ? {
+						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 FamiliarTerminatedError());
+	}
+	#a(e, t, n, r, i) {
+		if (this.#t) return Promise.reject(new FamiliarTerminatedError());
+		if (this.#n) return Promise.reject(new FamiliarRuntimeError("Worker slot is already busy"));
+		try {
+			let a = this.#o(), o = this.#r;
+			return this.#r = o === 2 ** 53 - 1 ? 0 : o + 1, new Promise((s, c) => {
+				let l = {
+					emit: i,
+					id: o,
+					kind: r,
+					reject: c,
+					resolve: s
+				};
+				this.#n = l, n !== void 0 && (l.timer = setTimeout(() => this.cancel(new FamiliarTimeoutError(n)), n), unrefTimer(l.timer));
+				try {
+					a.postMessage({
+						id: o,
+						input: e,
+						kind: r,
+						version: 1
+					}, t);
+				} catch (e) {
+					this.cancel(new 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 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 FamiliarRuntimeError(t.message || "Worker failed")), e.onmessageerror = () => this.#c(e, new FamiliarRuntimeError("Worker response could not be deserialized")), this.#i = e, e;
+		} catch (e) {
+			throw new 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 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(e, t = {}) {
+	let n = resolveOptions(t);
+	return createPool(slots(e, n), {
+		defaultTimeout: n.timeout,
+		maxQueue: n.maxQueue,
+		onFull: n.onFull
+	});
+}
+function createStreamWorker(e, t = {}) {
+	let n = resolveOptions(t);
+	return createStreamPool(slots(e, n), {
+		defaultTimeout: n.timeout,
+		maxQueue: n.maxQueue,
+		onFull: n.onFull
+	});
+}
+//#endregion
+export { FamiliarError, FamiliarInvalidOptionsError, FamiliarQueueFullError, FamiliarRuntimeError, FamiliarTaskError, FamiliarTerminatedError, FamiliarTimeoutError, createStreamWorker, createWorker, runBatch };
+
 //# sourceMappingURL=familiar.js.map