@vielzeug/familiar 3.0.0 → 26.10.1

package/dist/testing/testing.js

@@ -1,77 +1,2 @@
-import { FamiliarError as e, FamiliarInvalidOptionsError as t, FamiliarQueueFullError as n, FamiliarRuntimeError as r, FamiliarTaskError as i, FamiliarTerminatedError as a, FamiliarTimeoutError as o } from "../errors.js";
-import { validateTimeout as s } from "../_pool-core.js";
-import { createPool as c } from "../_pool.js";
-//#region src/testing/testing.ts
-function l(e, n = {}) {
-	let { concurrency: r = 1, maxQueue: l, onFull: u = "reject", timeout: d } = n;
-	if (!Number.isInteger(r) || r < 1 || r > 512) throw new t("`concurrency` must be a positive integer ≤ 512");
-	if (l !== void 0 && (!Number.isInteger(l) || l < 1)) throw new t("`maxQueue` must be a positive integer");
-	if (u !== "reject" && u !== "wait") throw new t("`onFull` must be \"reject\" or \"wait\"");
-	s(d);
-	let f = [];
-	function p() {
-		let t, n = !1;
-		return {
-			cancel(e) {
-				t?.reject(e), t = void 0;
-			},
-			run(r, s, c) {
-				if (n) return Promise.reject(new a());
-				let l;
-				try {
-					l = structuredClone(r, { transfer: s });
-				} catch (e) {
-					return Promise.reject(new i("Failed to clone task input", { cause: e }));
-				}
-				return new Promise((n, r) => {
-					let a = Symbol("task"), s, u = (e, n) => {
-						t?.token === a && (t = void 0, s && clearTimeout(s), e(n));
-					}, d = (e) => {
-						t?.token === a && (t = void 0, s && clearTimeout(s), f.push({
-							input: l,
-							reason: e,
-							status: "rejected"
-						}), r(e));
-					};
-					t = {
-						reject: d,
-						token: a
-					}, c !== void 0 && (s = setTimeout(() => d(new o(c)), c)), Promise.resolve().then(() => e(l)).then((e) => {
-						let r;
-						try {
-							r = structuredClone(e);
-						} catch (e) {
-							d(new i("Failed to clone task output", { cause: e }));
-							return;
-						}
-						t?.token === a && (f.push({
-							input: l,
-							status: "fulfilled",
-							value: r
-						}), u(n, r));
-					}, (e) => {
-						let t = e instanceof Error ? e : Error(String(e));
-						d(new i(t.message, { cause: t }));
-					});
-				});
-			},
-			terminate() {
-				n = !0, t?.reject(new a()), t = void 0;
-			}
-		};
-	}
-	let m = c(Array.from({ length: r }, p), {
-		concurrency: r,
-		defaultTimeout: d,
-		maxQueue: l,
-		onFull: u
-	});
-	return Object.defineProperty(m, "calls", {
-		enumerable: !0,
-		get: () => f
-	}), m;
-}
-//#endregion
-export { e as FamiliarError, t as FamiliarInvalidOptionsError, n as FamiliarQueueFullError, r as FamiliarRuntimeError, i as FamiliarTaskError, a as FamiliarTerminatedError, o as FamiliarTimeoutError, l as createTestWorker };
-
+import{FamiliarError as e,FamiliarInvalidOptionsError as t,FamiliarQueueFullError as n,FamiliarRuntimeError as r,FamiliarTaskError as i,FamiliarTerminatedError as a,FamiliarTimeoutError as o}from"../errors.js";import{validateTimeout as s}from"../_pool-core.js";import{createPool as c}from"../_pool.js";function createTestWorker(e,n={}){let{concurrency:r=1,maxQueue:l,onFull:u=`reject`,timeout:d}=n;if(!Number.isInteger(r)||r<1||r>512)throw new t("`concurrency` must be a positive integer ≤ 512");if(l!==void 0&&(!Number.isInteger(l)||l<1))throw new t("`maxQueue` must be a positive integer");if(u!==`reject`&&u!==`wait`)throw new t('`onFull` must be "reject" or "wait"');s(d);let f=[];function makeSlot(){let t,n=!1;return{cancel(e){t?.reject(e),t=void 0},run(r,s,c){if(n)return Promise.reject(new a);let l;try{l=structuredClone(r,{transfer:s})}catch(e){return Promise.reject(new i(`Failed to clone task input`,{cause:e}))}return new Promise((n,r)=>{let a=Symbol(`task`),s,settle=(e,n)=>{t?.token===a&&(t=void 0,s&&clearTimeout(s),e(n))},rejectTask=e=>{t?.token===a&&(t=void 0,s&&clearTimeout(s),f.push({input:l,reason:e,status:`rejected`}),r(e))};t={reject:rejectTask,token:a},c!==void 0&&(s=setTimeout(()=>rejectTask(new o(c)),c)),Promise.resolve().then(()=>e(l)).then(e=>{let r;try{r=structuredClone(e)}catch(e){rejectTask(new i(`Failed to clone task output`,{cause:e}));return}t?.token===a&&(f.push({input:l,status:`fulfilled`,value:r}),settle(n,r))},e=>{let t=e instanceof Error?e:Error(String(e));rejectTask(new i(t.message,{cause:t}))})})},terminate(){n=!0,t?.reject(new a),t=void 0}}}let p=c(Array.from({length:r},makeSlot),{defaultTimeout:d,maxQueue:l,onFull:u});return Object.defineProperty(p,"calls",{enumerable:!0,get:()=>f}),p}export{e as FamiliarError,t as FamiliarInvalidOptionsError,n as FamiliarQueueFullError,r as FamiliarRuntimeError,i as FamiliarTaskError,a as FamiliarTerminatedError,o as FamiliarTimeoutError,createTestWorker};
 //# sourceMappingURL=testing.js.map

package/dist/testing/testing.js.map

@@ -1 +1 @@
-{"version":3,"file":"testing.js","names":[],"sources":["../../src/testing/testing.ts"],"sourcesContent":["import { createPool } from '../_pool.js';\nimport { MAX_CONCURRENCY, validateTimeout } from '../_pool-core.js';\nimport {\n  FamiliarInvalidOptionsError,\n  FamiliarTaskError,\n  FamiliarTerminatedError,\n  FamiliarTimeoutError,\n} from '../errors.js';\nimport type { SlotStrategy, WorkerOptions, WorkerPool } from '../types.js';\n\nexport type TestWorkerOptions = Omit<WorkerOptions, 'concurrency' | 'onSlotError'> & { concurrency?: number };\n\nexport type TestWorkerCall<TInput, TOutput> =\n  | { input: TInput; status: 'fulfilled'; value: TOutput }\n  | { input: TInput; reason: unknown; status: 'rejected' };\n\nexport type TestWorkerHandle<TInput, TOutput> = WorkerPool<TInput, TOutput> & {\n  readonly calls: ReadonlyArray<TestWorkerCall<TInput, TOutput>>;\n};\n\nexport function createTestWorker<TInput, TOutput>(\n  handler: (input: TInput) => TOutput | Promise<TOutput>,\n  options: TestWorkerOptions = {},\n): TestWorkerHandle<TInput, TOutput> {\n  const { concurrency = 1, maxQueue, onFull = 'reject', timeout } = options;\n\n  if (!Number.isInteger(concurrency) || concurrency < 1 || concurrency > MAX_CONCURRENCY) {\n    throw new FamiliarInvalidOptionsError(`\\`concurrency\\` must be a positive integer ≤ ${MAX_CONCURRENCY}`);\n  }\n\n  if (maxQueue !== undefined && (!Number.isInteger(maxQueue) || maxQueue < 1)) {\n    throw new FamiliarInvalidOptionsError('`maxQueue` must be a positive integer');\n  }\n\n  if (onFull !== 'reject' && onFull !== 'wait') {\n    throw new FamiliarInvalidOptionsError('`onFull` must be \"reject\" or \"wait\"');\n  }\n\n  validateTimeout(timeout);\n\n  const calls: TestWorkerCall<TInput, TOutput>[] = [];\n\n  function makeSlot(): SlotStrategy<TInput, TOutput> {\n    let current: { reject(reason: unknown): void; token: symbol } | undefined;\n    let terminated = false;\n\n    return {\n      cancel(reason: unknown): void {\n        current?.reject(reason);\n        current = undefined;\n      },\n      run(input, transferables, timeoutMs): Promise<TOutput> {\n        if (terminated) return Promise.reject(new FamiliarTerminatedError());\n\n        let clonedInput: TInput;\n\n        try {\n          clonedInput = structuredClone(input, { transfer: transferables });\n        } catch (error) {\n          return Promise.reject(new FamiliarTaskError('Failed to clone task input', { cause: error }));\n        }\n\n        return new Promise<TOutput>((resolve, reject) => {\n          const token = Symbol('task');\n          let timer: ReturnType<typeof setTimeout> | undefined;\n          const settle = (fn: (value: TOutput) => void, value: TOutput): void => {\n            if (current?.token !== token) return;\n\n            current = undefined;\n\n            if (timer) clearTimeout(timer);\n\n            fn(value);\n          };\n          const rejectTask = (reason: unknown): void => {\n            if (current?.token !== token) return;\n\n            current = undefined;\n\n            if (timer) clearTimeout(timer);\n\n            calls.push({ input: clonedInput, reason, status: 'rejected' });\n            reject(reason);\n          };\n\n          current = { reject: rejectTask, token };\n\n          if (timeoutMs !== undefined) {\n            timer = setTimeout(() => rejectTask(new FamiliarTimeoutError(timeoutMs)), timeoutMs);\n          }\n\n          void Promise.resolve()\n            .then(() => handler(clonedInput))\n            .then(\n              (output) => {\n                let clonedOutput: TOutput;\n\n                try {\n                  clonedOutput = structuredClone(output);\n                } catch (error) {\n                  rejectTask(new FamiliarTaskError('Failed to clone task output', { cause: error }));\n\n                  return;\n                }\n\n                if (current?.token !== token) return;\n\n                calls.push({ input: clonedInput, status: 'fulfilled', value: clonedOutput });\n                settle(resolve, clonedOutput);\n              },\n              (error: unknown) => {\n                const cause = error instanceof Error ? error : new Error(String(error));\n\n                rejectTask(new FamiliarTaskError(cause.message, { cause }));\n              },\n            );\n        });\n      },\n      terminate(): void {\n        terminated = true;\n        current?.reject(new FamiliarTerminatedError());\n        current = undefined;\n      },\n    };\n  }\n\n  const pool = createPool(Array.from({ length: concurrency }, makeSlot), {\n    concurrency,\n    defaultTimeout: timeout,\n    maxQueue,\n    onFull,\n  });\n\n  Object.defineProperty(pool, 'calls', {\n    enumerable: true,\n    get: () => calls as ReadonlyArray<TestWorkerCall<TInput, TOutput>>,\n  });\n\n  return pool as TestWorkerHandle<TInput, TOutput>;\n}\n\nexport {\n  FamiliarError,\n  FamiliarInvalidOptionsError,\n  FamiliarQueueFullError,\n  FamiliarRuntimeError,\n  FamiliarTaskError,\n  FamiliarTerminatedError,\n  FamiliarTimeoutError,\n} from '../errors.js';\nexport type { WorkerPool } from '../types.js';\n"],"mappings":";;;;AAoBA,SAAgB,EACd,GACA,IAA6B,CAAC,GACK;CACnC,IAAM,EAAE,iBAAc,GAAG,aAAU,YAAS,UAAU,eAAY;CAElE,IAAI,CAAC,OAAO,UAAU,CAAW,KAAK,IAAc,KAAK,IAAA,KACvD,MAAM,IAAI,EAA4B,gDAAiE;CAGzG,IAAI,MAAa,KAAA,MAAc,CAAC,OAAO,UAAU,CAAQ,KAAK,IAAW,IACvE,MAAM,IAAI,EAA4B,uCAAuC;CAG/E,IAAI,MAAW,YAAY,MAAW,QACpC,MAAM,IAAI,EAA4B,yCAAqC;CAG7E,EAAgB,CAAO;CAEvB,IAAM,IAA2C,CAAC;CAElD,SAAS,IAA0C;EACjD,IAAI,GACA,IAAa;EAEjB,OAAO;GACL,OAAO,GAAuB;IAE5B,AADA,GAAS,OAAO,CAAM,GACtB,IAAU,KAAA;GACZ;GACA,IAAI,GAAO,GAAe,GAA6B;IACrD,IAAI,GAAY,OAAO,QAAQ,OAAO,IAAI,EAAwB,CAAC;IAEnE,IAAI;IAEJ,IAAI;KACF,IAAc,gBAAgB,GAAO,EAAE,UAAU,EAAc,CAAC;IAClE,SAAS,GAAO;KACd,OAAO,QAAQ,OAAO,IAAI,EAAkB,8BAA8B,EAAE,OAAO,EAAM,CAAC,CAAC;IAC7F;IAEA,OAAO,IAAI,SAAkB,GAAS,MAAW;KAC/C,IAAM,IAAQ,OAAO,MAAM,GACvB,GACE,KAAU,GAA8B,MAAyB;MACjE,GAAS,UAAU,MAEvB,IAAU,KAAA,GAEN,KAAO,aAAa,CAAK,GAE7B,EAAG,CAAK;KACV,GACM,KAAc,MAA0B;MACxC,GAAS,UAAU,MAEvB,IAAU,KAAA,GAEN,KAAO,aAAa,CAAK,GAE7B,EAAM,KAAK;OAAE,OAAO;OAAa;OAAQ,QAAQ;MAAW,CAAC,GAC7D,EAAO,CAAM;KACf;KAQA,AANA,IAAU;MAAE,QAAQ;MAAY;KAAM,GAElC,MAAc,KAAA,MAChB,IAAQ,iBAAiB,EAAW,IAAI,EAAqB,CAAS,CAAC,GAAG,CAAS,IAGrF,QAAa,QAAQ,CAAC,CACnB,WAAW,EAAQ,CAAW,CAAC,CAAC,CAChC,MACE,MAAW;MACV,IAAI;MAEJ,IAAI;OACF,IAAe,gBAAgB,CAAM;MACvC,SAAS,GAAO;OACd,EAAW,IAAI,EAAkB,+BAA+B,EAAE,OAAO,EAAM,CAAC,CAAC;OAEjF;MACF;MAEI,GAAS,UAAU,MAEvB,EAAM,KAAK;OAAE,OAAO;OAAa,QAAQ;OAAa,OAAO;MAAa,CAAC,GAC3E,EAAO,GAAS,CAAY;KAC9B,IACC,MAAmB;MAClB,IAAM,IAAQ,aAAiB,QAAQ,IAAY,MAAM,OAAO,CAAK,CAAC;MAEtE,EAAW,IAAI,EAAkB,EAAM,SAAS,EAAE,SAAM,CAAC,CAAC;KAC5D,CACF;IACJ,CAAC;GACH;GACA,YAAkB;IAGhB,AAFA,IAAa,IACb,GAAS,OAAO,IAAI,EAAwB,CAAC,GAC7C,IAAU,KAAA;GACZ;EACF;CACF;CAEA,IAAM,IAAO,EAAW,MAAM,KAAK,EAAE,QAAQ,EAAY,GAAG,CAAQ,GAAG;EACrE;EACA,gBAAgB;EAChB;EACA;CACF,CAAC;CAOD,OALA,OAAO,eAAe,GAAM,SAAS;EACnC,YAAY;EACZ,WAAW;CACb,CAAC,GAEM;AACT"}
+{"version":3,"file":"testing.js","names":[],"sources":["../../src/testing/testing.ts"],"sourcesContent":["import { createPool } from '../_pool.js';\nimport { MAX_CONCURRENCY, validateTimeout } from '../_pool-core.js';\nimport {\n  FamiliarInvalidOptionsError,\n  FamiliarTaskError,\n  FamiliarTerminatedError,\n  FamiliarTimeoutError,\n} from '../errors.js';\nimport type { SlotStrategy, WorkerOptions, WorkerPool } from '../types.js';\n\nexport type TestWorkerOptions = Omit<WorkerOptions, 'concurrency'> & { concurrency?: number };\n\nexport type TestWorkerCall<TInput, TOutput> =\n  | { input: TInput; status: 'fulfilled'; value: TOutput }\n  | { input: TInput; reason: unknown; status: 'rejected' };\n\nexport type TestWorkerHandle<TInput, TOutput> = WorkerPool<TInput, TOutput> & {\n  readonly calls: ReadonlyArray<TestWorkerCall<TInput, TOutput>>;\n};\n\nexport function createTestWorker<TInput, TOutput>(\n  handler: (input: TInput) => TOutput | Promise<TOutput>,\n  options: TestWorkerOptions = {},\n): TestWorkerHandle<TInput, TOutput> {\n  const { concurrency = 1, maxQueue, onFull = 'reject', timeout } = options;\n\n  if (!Number.isInteger(concurrency) || concurrency < 1 || concurrency > MAX_CONCURRENCY) {\n    throw new FamiliarInvalidOptionsError(`\\`concurrency\\` must be a positive integer ≤ ${MAX_CONCURRENCY}`);\n  }\n\n  if (maxQueue !== undefined && (!Number.isInteger(maxQueue) || maxQueue < 1)) {\n    throw new FamiliarInvalidOptionsError('`maxQueue` must be a positive integer');\n  }\n\n  if (onFull !== 'reject' && onFull !== 'wait') {\n    throw new FamiliarInvalidOptionsError('`onFull` must be \"reject\" or \"wait\"');\n  }\n\n  validateTimeout(timeout);\n\n  const calls: TestWorkerCall<TInput, TOutput>[] = [];\n\n  function makeSlot(): SlotStrategy<TInput, TOutput> {\n    let current: { reject(reason: unknown): void; token: symbol } | undefined;\n    let terminated = false;\n\n    return {\n      cancel(reason: unknown): void {\n        current?.reject(reason);\n        current = undefined;\n      },\n      run(input, transferables, timeoutMs): Promise<TOutput> {\n        if (terminated) return Promise.reject(new FamiliarTerminatedError());\n\n        let clonedInput: TInput;\n\n        try {\n          clonedInput = structuredClone(input, { transfer: transferables });\n        } catch (error) {\n          return Promise.reject(new FamiliarTaskError('Failed to clone task input', { cause: error }));\n        }\n\n        return new Promise<TOutput>((resolve, reject) => {\n          const token = Symbol('task');\n          let timer: ReturnType<typeof setTimeout> | undefined;\n          const settle = (fn: (value: TOutput) => void, value: TOutput): void => {\n            if (current?.token !== token) return;\n\n            current = undefined;\n\n            if (timer) clearTimeout(timer);\n\n            fn(value);\n          };\n          const rejectTask = (reason: unknown): void => {\n            if (current?.token !== token) return;\n\n            current = undefined;\n\n            if (timer) clearTimeout(timer);\n\n            calls.push({ input: clonedInput, reason, status: 'rejected' });\n            reject(reason);\n          };\n\n          current = { reject: rejectTask, token };\n\n          if (timeoutMs !== undefined) {\n            timer = setTimeout(() => rejectTask(new FamiliarTimeoutError(timeoutMs)), timeoutMs);\n          }\n\n          void Promise.resolve()\n            .then(() => handler(clonedInput))\n            .then(\n              (output) => {\n                let clonedOutput: TOutput;\n\n                try {\n                  clonedOutput = structuredClone(output);\n                } catch (error) {\n                  rejectTask(new FamiliarTaskError('Failed to clone task output', { cause: error }));\n\n                  return;\n                }\n\n                if (current?.token !== token) return;\n\n                calls.push({ input: clonedInput, status: 'fulfilled', value: clonedOutput });\n                settle(resolve, clonedOutput);\n              },\n              (error: unknown) => {\n                const cause = error instanceof Error ? error : new Error(String(error));\n\n                rejectTask(new FamiliarTaskError(cause.message, { cause }));\n              },\n            );\n        });\n      },\n      terminate(): void {\n        terminated = true;\n        current?.reject(new FamiliarTerminatedError());\n        current = undefined;\n      },\n    };\n  }\n\n  const pool = createPool(Array.from({ length: concurrency }, makeSlot), {\n    defaultTimeout: timeout,\n    maxQueue,\n    onFull,\n  });\n\n  Object.defineProperty(pool, 'calls', {\n    enumerable: true,\n    get: () => calls as ReadonlyArray<TestWorkerCall<TInput, TOutput>>,\n  });\n\n  return pool as TestWorkerHandle<TInput, TOutput>;\n}\n\nexport {\n  FamiliarError,\n  FamiliarInvalidOptionsError,\n  FamiliarQueueFullError,\n  FamiliarRuntimeError,\n  FamiliarTaskError,\n  FamiliarTerminatedError,\n  FamiliarTimeoutError,\n} from '../errors.js';\nexport type { WorkerPool } from '../types.js';\n"],"mappings":"8SAoBA,SAAgB,iBACd,EACA,EAA6B,CAAC,EACK,CACnC,GAAM,CAAE,cAAc,EAAG,WAAU,SAAS,SAAU,WAAY,EAElE,GAAI,CAAC,OAAO,UAAU,CAAW,GAAK,EAAc,GAAK,EAAA,IACvD,MAAM,IAAI,EAA4B,gDAAiE,EAGzG,GAAI,IAAa,IAAA,KAAc,CAAC,OAAO,UAAU,CAAQ,GAAK,EAAW,GACvE,MAAM,IAAI,EAA4B,uCAAuC,EAG/E,GAAI,IAAW,UAAY,IAAW,OACpC,MAAM,IAAI,EAA4B,qCAAqC,EAG7E,EAAgB,CAAO,EAEvB,IAAM,EAA2C,CAAC,EAElD,SAAS,UAA0C,CACjD,IAAI,EACA,EAAa,GAEjB,MAAO,CACL,OAAO,EAAuB,CAC5B,GAAS,OAAO,CAAM,EACtB,EAAU,IAAA,EACZ,EACA,IAAI,EAAO,EAAe,EAA6B,CACrD,GAAI,EAAY,OAAO,QAAQ,OAAO,IAAI,CAAyB,EAEnE,IAAI,EAEJ,GAAI,CACF,EAAc,gBAAgB,EAAO,CAAE,SAAU,CAAc,CAAC,CAClE,OAAS,EAAO,CACd,OAAO,QAAQ,OAAO,IAAI,EAAkB,6BAA8B,CAAE,MAAO,CAAM,CAAC,CAAC,CAC7F,CAEA,OAAO,IAAI,SAAkB,EAAS,IAAW,CAC/C,IAAM,EAAQ,OAAO,MAAM,EACvB,EACE,QAAU,EAA8B,IAAyB,CACjE,GAAS,QAAU,IAEvB,EAAU,IAAA,GAEN,GAAO,aAAa,CAAK,EAE7B,EAAG,CAAK,EACV,EACM,WAAc,GAA0B,CACxC,GAAS,QAAU,IAEvB,EAAU,IAAA,GAEN,GAAO,aAAa,CAAK,EAE7B,EAAM,KAAK,CAAE,MAAO,EAAa,SAAQ,OAAQ,UAAW,CAAC,EAC7D,EAAO,CAAM,EACf,EAEA,EAAU,CAAE,OAAQ,WAAY,OAAM,EAElC,IAAc,IAAA,KAChB,EAAQ,eAAiB,WAAW,IAAI,EAAqB,CAAS,CAAC,EAAG,CAAS,GAGrF,QAAa,QAAQ,CAAC,CACnB,SAAW,EAAQ,CAAW,CAAC,CAAC,CAChC,KACE,GAAW,CACV,IAAI,EAEJ,GAAI,CACF,EAAe,gBAAgB,CAAM,CACvC,OAAS,EAAO,CACd,WAAW,IAAI,EAAkB,8BAA+B,CAAE,MAAO,CAAM,CAAC,CAAC,EAEjF,MACF,CAEI,GAAS,QAAU,IAEvB,EAAM,KAAK,CAAE,MAAO,EAAa,OAAQ,YAAa,MAAO,CAAa,CAAC,EAC3E,OAAO,EAAS,CAAY,EAC9B,EACC,GAAmB,CAClB,IAAM,EAAQ,aAAiB,MAAQ,EAAY,MAAM,OAAO,CAAK,CAAC,EAEtE,WAAW,IAAI,EAAkB,EAAM,QAAS,CAAE,OAAM,CAAC,CAAC,CAC5D,CACF,CACJ,CAAC,CACH,EACA,WAAkB,CAChB,EAAa,GACb,GAAS,OAAO,IAAI,CAAyB,EAC7C,EAAU,IAAA,EACZ,CACF,CACF,CAEA,IAAM,EAAO,EAAW,MAAM,KAAK,CAAE,OAAQ,CAAY,EAAG,QAAQ,EAAG,CACrE,eAAgB,EAChB,WACA,QACF,CAAC,EAOD,OALA,OAAO,eAAe,EAAM,QAAS,CACnC,WAAY,GACZ,QAAW,CACb,CAAC,EAEM,CACT"}

package/dist/testing.js

@@ -1,3 +1 @@
-import { FamiliarError as e, FamiliarInvalidOptionsError as t, FamiliarQueueFullError as n, FamiliarRuntimeError as r, FamiliarTaskError as i, FamiliarTerminatedError as a, FamiliarTimeoutError as o } from "./errors.js";
-import { createTestWorker as s } from "./testing/testing.js";
-export { e as FamiliarError, t as FamiliarInvalidOptionsError, n as FamiliarQueueFullError, r as FamiliarRuntimeError, i as FamiliarTaskError, a as FamiliarTerminatedError, o as FamiliarTimeoutError, s as createTestWorker };
+import{FamiliarError as e,FamiliarInvalidOptionsError as t,FamiliarQueueFullError as n,FamiliarRuntimeError as r,FamiliarTaskError as i,FamiliarTerminatedError as a,FamiliarTimeoutError as o}from"./errors.js";import{createTestWorker as s}from"./testing/testing.js";export{e as FamiliarError,t as FamiliarInvalidOptionsError,n as FamiliarQueueFullError,r as FamiliarRuntimeError,i as FamiliarTaskError,a as FamiliarTerminatedError,o as FamiliarTimeoutError,s as createTestWorker};

package/dist/types.d.ts

@@ -13,11 +13,16 @@ export type WorkerOptions = {
     maxQueue?: number;
     /** Reject new work or wait for queue capacity. Default: 'reject'. */
     onFull?: 'reject' | 'wait';
-    /** Called after an unhandled worker runtime error. The failed slot is replaced lazily. */
-    onSlotError?: (error: FamiliarRuntimeError) => void;
     /** Default timeout in milliseconds. Timed-out work terminates and replaces its worker slot. */
     timeout?: number;
 };
+/** Observation event delivered to `pool.tap()` handlers. */
+export type FamiliarTapEvent = {
+    readonly error: FamiliarRuntimeError;
+    readonly type: 'worker-error';
+} | {
+    readonly type: 'dispose';
+};
 export type RunOptions = {
     /** Higher values run before lower values. Equal values run FIFO. Default: 0. */
     priority?: number;
@@ -39,6 +44,13 @@ export interface PoolBase {
     drain(options?: DrainOptions): Promise<void>;
     readonly stats: WorkerStats;
     readonly status: WorkerStatus;
+    /**
+     * Observe runtime events without affecting pool behavior.
+     * Handler errors are swallowed. Returns an unsubscribe function.
+     */
+    tap(handler: (event: FamiliarTapEvent) => void, options?: {
+        readonly signal?: AbortSignal;
+    }): () => void;
     [Symbol.asyncDispose](): Promise<void>;
     [Symbol.dispose](): void;
 }
@@ -50,6 +62,8 @@ export interface StreamWorkerPool<TInput, TChunk> extends PoolBase {
 }
 export type SlotStrategy<TInput, TOutput> = {
     cancel(reason: unknown): void;
+    /** Wired by the pool factory to report unhandled worker runtime errors through `tap()`. */
+    notify?(error: FamiliarRuntimeError): void;
     run(input: TInput, transferables: Transferable[], timeout: number | undefined): Promise<TOutput>;
     terminate(): void;
 };

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAExD,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,SAAS,GAAG,YAAY,CAAC;AAE7D,MAAM,MAAM,WAAW,GAAG;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,4FAA4F;IAC5F,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC9B,qDAAqD;IACrD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qEAAqE;IACrE,MAAM,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAC;IAC3B,0FAA0F;IAC1F,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,oBAAoB,KAAK,IAAI,CAAC;IACpD,+FAA+F;IAC/F,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,gFAAgF;IAChF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2DAA2D;IAC3D,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,8EAA8E;IAC9E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qEAAqE;IACrE,aAAa,CAAC,EAAE,SAAS,YAAY,EAAE,CAAC;CACzC,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,8DAA8D;IAC9D,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,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,KAAK,EAAE,WAAW,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC;CAC1B;AAED,MAAM,WAAW,UAAU,CAAC,MAAM,EAAE,OAAO,CAAE,SAAQ,QAAQ;IAC3D,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC5D;AAED,MAAM,WAAW,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAE,SAAQ,QAAQ;IAChE,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;CACvE;AAED,MAAM,MAAM,YAAY,CAAC,MAAM,EAAE,OAAO,IAAI;IAC1C,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;IAC9B,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,YAAY,EAAE,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACjG,SAAS,IAAI,IAAI,CAAC;CACnB,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/worker.cjs

@@ -1,2 +1,2 @@
-const e=require("./_timers.cjs"),t=require("./errors.cjs"),n=require("./_pool-core.cjs"),r=require("./_pool.cjs");require("./_dev.cjs");const i=require("./_stream-pool.cjs");require("./protocol.cjs");function a(e={}){let{concurrency:r=1,maxQueue:i,onFull:a=`reject`,onSlotError:o,timeout:s}=e,c=r===`auto`?Math.min(512,Math.max(1,globalThis.navigator?.hardwareConcurrency??1)):r;if(!Number.isInteger(c)||c<1||c>512)throw new t.FamiliarInvalidOptionsError('`concurrency` must be a positive integer ≤ 512 or "auto"');if(i!==void 0&&(!Number.isInteger(i)||i<1))throw new t.FamiliarInvalidOptionsError("`maxQueue` must be a positive integer");if(a!==`reject`&&a!==`wait`)throw new t.FamiliarInvalidOptionsError('`onFull` must be "reject" or "wait"');return n.validateTimeout(s),{concurrency:c,maxQueue:i,onFull:a,onSlotError:o,timeout:s}}function o(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 s(e){let n=Error(e.message);return n.name=e.name,n.stack=e.stack,e.category===`protocol`?new t.FamiliarRuntimeError(e.message,{cause:n}):new t.FamiliarTaskError(e.message,{cause:n})}var c=class{#e;#t;#n=!1;#r;#i=0;#a;constructor(e,t){this.#t=e,this.#e=t}cancel(e){this.#r&&(this.#c(),this.#d(`reject`,e))}run(e,t,n){return this.#o(e,t,n,`run`)}stream(e,n){let r=()=>this.cancel(new t.FamiliarTerminatedError(`Stream consumer stopped`)),i=[],a=[],o=!1,s,c=e=>{let t=a.shift();t?t({done:!1,value:e}):i.push(e)},l=e=>{for(o=!0,s=e;a.length>0;)a.shift()(e===void 0?{done:!0,value:void 0}:Promise.reject(e))};return{done:this.#o(e,[...n.transferables??[]],n.timeout,`stream`,c).then(()=>l(),e=>l(e)),iterable:{[Symbol.asyncIterator]:()=>({async next(){if(i.length>0)return{done:!1,value:i.shift()};if(s!==void 0)throw s;return o?{done:!0,value:void 0}:new Promise((e,t)=>{a.push(n=>{n instanceof Promise?n.then(e,t):e(n)})})},async return(){return r(),{done:!0,value:void 0}}})}}}terminate(){this.#n=!0,this.#c(),this.#d(`reject`,new t.FamiliarTerminatedError)}#o(n,r,i,a,o){if(this.#n)return Promise.reject(new t.FamiliarTerminatedError);if(this.#r)return Promise.reject(new t.FamiliarRuntimeError(`Worker slot is already busy`));try{let s=this.#s(),c=this.#i;return this.#i=c===2**53-1?0:c+1,new Promise((l,u)=>{let d={emit:o,id:c,kind:a,reject:u,resolve:l};this.#r=d,i!==void 0&&(d.timer=setTimeout(()=>this.cancel(new t.FamiliarTimeoutError(i)),i),e.unrefTimer(d.timer));try{s.postMessage({id:c,input:n,kind:a,version:1},r)}catch(e){this.cancel(new t.FamiliarRuntimeError(`Failed to post message to worker`,{cause:e}))}})}catch(e){return Promise.reject(e)}}#s(){if(this.#a)return this.#a;if(typeof Worker>`u`)throw new t.FamiliarRuntimeError(`Worker API is unavailable in this runtime`);try{let e=new Worker(this.#t,{type:`module`});return e.onmessage=t=>{this.#a===e&&this.#u(t.data)},e.onerror=n=>this.#l(e,new t.FamiliarRuntimeError(n.message||`Worker failed`)),e.onmessageerror=()=>this.#l(e,new t.FamiliarRuntimeError(`Worker response could not be deserialized`)),this.#a=e,e}catch(e){throw new t.FamiliarRuntimeError(`Failed to create Worker`,{cause:e})}}#c(){let e=this.#a;this.#a=void 0,e&&(e.onmessage=null,e.onerror=null,e.onmessageerror=null,e.terminate())}#l(e,t){if(this.#a===e){this.#c(),this.#d(`reject`,t);try{this.#e?.(t)}catch{}}}#u(e){if(this.#r){if(!o(e)||e.id!==this.#r.id||this.#r.kind===`run`&&e.kind===`chunk`){this.cancel(new t.FamiliarRuntimeError(`Worker returned an incompatible protocol response`));return}if(e.kind===`chunk`){this.#r.emit?.(e.value);return}if(e.kind===`error`){this.#d(`reject`,s(e.error));return}this.#d(`resolve`,e.value)}}#d(e,t){let n=this.#r;n&&(this.#r=void 0,n.timer&&clearTimeout(n.timer),e===`resolve`?n.resolve(t):n.reject(t))}};function l(e,t){let n=typeof e==`string`?e:e.href;return Array.from({length:t.concurrency},()=>new c(n,t.onSlotError))}function u(e,t={}){let n=a(t);return r.createPool(l(e,n),{concurrency:n.concurrency,defaultTimeout:n.timeout,maxQueue:n.maxQueue,onFull:n.onFull})}function d(e,t={}){let n=a(t);return i.createStreamPool(l(e,n),{concurrency:n.concurrency,defaultTimeout:n.timeout,maxQueue:n.maxQueue,onFull:n.onFull})}exports.FamiliarError=t.FamiliarError,exports.FamiliarInvalidOptionsError=t.FamiliarInvalidOptionsError,exports.FamiliarQueueFullError=t.FamiliarQueueFullError,exports.FamiliarRuntimeError=t.FamiliarRuntimeError,exports.FamiliarTaskError=t.FamiliarTaskError,exports.FamiliarTerminatedError=t.FamiliarTerminatedError,exports.FamiliarTimeoutError=t.FamiliarTimeoutError,exports.createStreamWorker=d,exports.createWorker=u,exports.runBatch=r.runBatch;
+const e=require("./_timers.cjs"),t=require("./errors.cjs"),n=require("./_pool-core.cjs"),r=require("./_pool.cjs"),i=require("./_stream-pool.cjs");require("./protocol.cjs");function resolveOptions(e={}){let{concurrency:r=1,maxQueue:i,onFull:a=`reject`,timeout:o}=e,s=r===`auto`?Math.min(512,Math.max(1,globalThis.navigator?.hardwareConcurrency??1)):r;if(!Number.isInteger(s)||s<1||s>512)throw new t.FamiliarInvalidOptionsError('`concurrency` must be a positive integer ≤ 512 or "auto"');if(i!==void 0&&(!Number.isInteger(i)||i<1))throw new t.FamiliarInvalidOptionsError("`maxQueue` must be a positive integer");if(a!==`reject`&&a!==`wait`)throw new t.FamiliarInvalidOptionsError('`onFull` must be "reject" or "wait"');return n.validateTimeout(o),{concurrency:s,maxQueue:i,onFull:a,timeout:o}}function isWorkerResponse(e){if(typeof e!=`object`||!e)return!1;let t=e;return t.version!==1||typeof t.id!=`number`||!Number.isSafeInteger(t.id)||t.id<0?!1:t.kind===`chunk`||t.kind===`result`?`value`in t:t.kind!==`error`||typeof t.error!=`object`||t.error===null?!1:(t.error.category===void 0||t.error.category===`protocol`)&&typeof t.error.message==`string`&&typeof t.error.name==`string`&&(t.error.stack===void 0||typeof t.error.stack==`string`)}function responseError(e){let n=Error(e.message);return n.name=e.name,n.stack=e.stack,e.category===`protocol`?new t.FamiliarRuntimeError(e.message,{cause:n}):new t.FamiliarTaskError(e.message,{cause:n})}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,n){let stop=()=>this.cancel(new t.FamiliarTerminatedError(`Stream consumer stopped`)),r=[],i=[],a=!1,o,emit=e=>{let t=i.shift();t?t({done:!1,value:e}):r.push(e)},finish=e=>{for(a=!0,o=e;i.length>0;)i.shift()(e===void 0?{done:!0,value:void 0}:Promise.reject(e))};return{done:this.#a(e,[...n.transferables??[]],n.timeout,`stream`,emit).then(()=>finish(),e=>finish(e)),iterable:{[Symbol.asyncIterator]:()=>({async next(){if(r.length>0)return{done:!1,value:r.shift()};if(o!==void 0)throw o;return a?{done:!0,value:void 0}:new Promise((e,t)=>{i.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 t.FamiliarTerminatedError)}#a(n,r,i,a,o){if(this.#t)return Promise.reject(new t.FamiliarTerminatedError);if(this.#n)return Promise.reject(new t.FamiliarRuntimeError(`Worker slot is already busy`));try{let s=this.#o(),c=this.#r;return this.#r=c===2**53-1?0:c+1,new Promise((l,u)=>{let d={emit:o,id:c,kind:a,reject:u,resolve:l};this.#n=d,i!==void 0&&(d.timer=setTimeout(()=>this.cancel(new t.FamiliarTimeoutError(i)),i),e.unrefTimer(d.timer));try{s.postMessage({id:c,input:n,kind:a,version:1},r)}catch(e){this.cancel(new t.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 t.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=n=>this.#c(e,new t.FamiliarRuntimeError(n.message||`Worker failed`)),e.onmessageerror=()=>this.#c(e,new t.FamiliarRuntimeError(`Worker response could not be deserialized`)),this.#i=e,e}catch(e){throw new t.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 t.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 r.createPool(slots(e,n),{defaultTimeout:n.timeout,maxQueue:n.maxQueue,onFull:n.onFull})}function createStreamWorker(e,t={}){let n=resolveOptions(t);return i.createStreamPool(slots(e,n),{defaultTimeout:n.timeout,maxQueue:n.maxQueue,onFull:n.onFull})}exports.createStreamWorker=createStreamWorker,exports.createWorker=createWorker;
 //# sourceMappingURL=worker.cjs.map

package/dist/worker.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"worker.cjs","names":[],"sources":["../src/worker.ts"],"sourcesContent":["export type { BatchOptions } from './_pool.js';\nexport { runBatch } from './_pool.js';\nexport {\n  FamiliarError,\n  FamiliarInvalidOptionsError,\n  FamiliarQueueFullError,\n  FamiliarRuntimeError,\n  FamiliarTaskError,\n  FamiliarTerminatedError,\n  FamiliarTimeoutError,\n} from './errors.js';\nexport type {\n  DrainOptions,\n  PoolBase,\n  RunOptions,\n  StreamWorkerPool,\n  WorkerOptions,\n  WorkerPool,\n  WorkerStats,\n  WorkerStatus,\n} from './types.js';\n\nimport { warn } from './_dev.js';\nimport { createPool } from './_pool.js';\nimport { MAX_CONCURRENCY, validateTimeout } from './_pool-core.js';\nimport { createStreamPool, type StreamSlot } from './_stream-pool.js';\nimport { unrefTimer } from './_timers.js';\nimport {\n  FamiliarInvalidOptionsError,\n  FamiliarRuntimeError,\n  FamiliarTaskError,\n  FamiliarTerminatedError,\n  FamiliarTimeoutError,\n} from './errors.js';\nimport type { SerializedError, WorkerResponse } from './protocol.js';\nimport { PROTOCOL_VERSION } from './protocol.js';\nimport type { RunOptions, SlotStrategy, StreamWorkerPool, WorkerOptions, WorkerPool } from './types.js';\n\ntype ResolvedOptions = {\n  concurrency: number;\n  maxQueue: number | undefined;\n  onFull: 'reject' | 'wait';\n  onSlotError: WorkerOptions['onSlotError'];\n  timeout: number | undefined;\n};\n\ntype Pending<TOutput> = {\n  emit?: (value: TOutput) => void;\n  id: number;\n  kind: 'run' | 'stream';\n  reject: (reason: unknown) => void;\n  resolve: (value: TOutput) => void;\n  timer?: ReturnType<typeof setTimeout>;\n};\n\nexport type RunningStream<TChunk> = {\n  done: Promise<void>;\n  iterable: AsyncIterable<TChunk>;\n};\n\nfunction resolveOptions(options: WorkerOptions = {}): ResolvedOptions {\n  const { concurrency = 1, maxQueue, onFull = 'reject', onSlotError, timeout } = options;\n  const resolvedConcurrency =\n    concurrency === 'auto'\n      ? Math.min(MAX_CONCURRENCY, Math.max(1, globalThis.navigator?.hardwareConcurrency ?? 1))\n      : concurrency;\n\n  if (!Number.isInteger(resolvedConcurrency) || resolvedConcurrency < 1 || resolvedConcurrency > MAX_CONCURRENCY) {\n    throw new FamiliarInvalidOptionsError(`\\`concurrency\\` must be a positive integer ≤ ${MAX_CONCURRENCY} or \"auto\"`);\n  }\n\n  if (maxQueue !== undefined && (!Number.isInteger(maxQueue) || maxQueue < 1)) {\n    throw new FamiliarInvalidOptionsError('`maxQueue` must be a positive integer');\n  }\n\n  if (onFull !== 'reject' && onFull !== 'wait') {\n    throw new FamiliarInvalidOptionsError('`onFull` must be \"reject\" or \"wait\"');\n  }\n\n  validateTimeout(timeout);\n\n  return { concurrency: resolvedConcurrency, maxQueue, onFull, onSlotError, timeout };\n}\n\nfunction isWorkerResponse<TOutput>(value: unknown): value is WorkerResponse<TOutput> {\n  if (typeof value !== 'object' || value === null) return false;\n\n  const response = value as Partial<WorkerResponse<TOutput>>;\n  if (\n    response.version !== PROTOCOL_VERSION ||\n    typeof response.id !== 'number' ||\n    !Number.isSafeInteger(response.id) ||\n    response.id < 0\n  )\n    return false;\n\n  if (response.kind === 'chunk' || response.kind === 'result') return 'value' in response;\n  if (response.kind !== 'error' || typeof response.error !== 'object' || response.error === null) return false;\n\n  return (\n    (response.error.category === undefined || response.error.category === 'protocol') &&\n    typeof response.error.message === 'string' &&\n    typeof response.error.name === 'string' &&\n    (response.error.stack === undefined || typeof response.error.stack === 'string')\n  );\n}\n\nfunction responseError(error: SerializedError): FamiliarRuntimeError | FamiliarTaskError {\n  const cause = new Error(error.message);\n\n  cause.name = error.name;\n  cause.stack = error.stack;\n\n  return error.category === 'protocol'\n    ? new FamiliarRuntimeError(error.message, { cause })\n    : new FamiliarTaskError(error.message, { cause });\n}\n\nclass Slot<TInput, TOutput> implements SlotStrategy<TInput, TOutput>, StreamSlot<TInput, TOutput> {\n  readonly #onSlotError: WorkerOptions['onSlotError'];\n  readonly #url: URL | string;\n  #disposed = false;\n  #pending: Pending<TOutput> | undefined;\n  #taskId = 0;\n  #worker: Worker | undefined;\n\n  constructor(url: URL | string, onSlotError: WorkerOptions['onSlotError']) {\n    this.#url = url;\n    this.#onSlotError = onSlotError;\n  }\n\n  cancel(reason: unknown): void {\n    if (!this.#pending) return;\n    this.#stopWorker();\n    this.#settlePending('reject', reason);\n  }\n\n  run(input: TInput, transferables: Transferable[], timeout: number | undefined): Promise<TOutput> {\n    return this.#dispatch(input, transferables, timeout, 'run') as Promise<TOutput>;\n  }\n\n  stream(input: TInput, options: RunOptions): RunningStream<TOutput> {\n    const stop = () => this.cancel(new FamiliarTerminatedError('Stream consumer stopped'));\n    const chunks: TOutput[] = [];\n    const waiters: Array<(result: IteratorResult<TOutput>) => void> = [];\n    let done = false;\n    let error: unknown;\n    const emit = (value: TOutput) => {\n      const waiter = waiters.shift();\n\n      if (waiter) waiter({ done: false, value });\n      else chunks.push(value);\n    };\n    const finish = (reason?: unknown) => {\n      done = true;\n      error = reason;\n\n      while (waiters.length > 0) {\n        const waiter = waiters.shift()!;\n\n        if (reason !== undefined) waiter(Promise.reject(reason) as never);\n        else waiter({ done: true, value: undefined as never });\n      }\n    };\n    const donePromise = this.#dispatch(input, [...(options.transferables ?? [])], options.timeout, 'stream', emit).then(\n      () => finish(),\n      (reason: unknown) => finish(reason),\n    );\n\n    return {\n      done: donePromise,\n      iterable: {\n        [Symbol.asyncIterator]: () => ({\n          async next(): Promise<IteratorResult<TOutput>> {\n            if (chunks.length > 0) return { done: false, value: chunks.shift()! };\n\n            if (error !== undefined) throw error;\n\n            if (done) return { done: true, value: undefined as never };\n\n            return new Promise<IteratorResult<TOutput>>((resolve, reject) => {\n              waiters.push((result) => {\n                if (result instanceof Promise) void result.then(resolve, reject);\n                else resolve(result);\n              });\n            });\n          },\n          async return(): Promise<IteratorResult<TOutput>> {\n            stop();\n\n            return { done: true, value: undefined as never };\n          },\n        }),\n      },\n    };\n  }\n\n  terminate(): void {\n    this.#disposed = true;\n    this.#stopWorker();\n    this.#settlePending('reject', new FamiliarTerminatedError());\n  }\n\n  #dispatch(\n    input: TInput,\n    transferables: Transferable[],\n    timeout: number | undefined,\n    kind: 'run' | 'stream',\n    emit?: (value: TOutput) => void,\n  ): Promise<TOutput> {\n    if (this.#disposed) return Promise.reject(new FamiliarTerminatedError());\n\n    if (this.#pending) return Promise.reject(new FamiliarRuntimeError('Worker slot is already busy'));\n\n    try {\n      const worker = this.#ensureWorker();\n      const id = this.#taskId;\n      this.#taskId = id === Number.MAX_SAFE_INTEGER ? 0 : id + 1;\n\n      return new Promise<TOutput>((resolve, reject) => {\n        const pending: Pending<TOutput> = { emit, id, kind, reject, resolve };\n\n        this.#pending = pending;\n\n        if (timeout !== undefined) {\n          pending.timer = setTimeout(() => this.cancel(new FamiliarTimeoutError(timeout)), timeout);\n          unrefTimer(pending.timer);\n        }\n\n        try {\n          worker.postMessage({ id, input, kind, version: PROTOCOL_VERSION }, transferables);\n        } catch (error) {\n          this.cancel(new FamiliarRuntimeError('Failed to post message to worker', { cause: error }));\n        }\n      });\n    } catch (error) {\n      return Promise.reject(error);\n    }\n  }\n\n  #ensureWorker(): Worker {\n    if (this.#worker) return this.#worker;\n\n    if (typeof Worker === 'undefined') throw new FamiliarRuntimeError('Worker API is unavailable in this runtime');\n\n    try {\n      const worker = new Worker(this.#url, { type: 'module' });\n\n      worker.onmessage = (event: MessageEvent<unknown>) => {\n        if (this.#worker === worker) this.#onMessage(event.data);\n      };\n      worker.onerror = (event) => this.#failWorker(worker, new FamiliarRuntimeError(event.message || 'Worker failed'));\n      worker.onmessageerror = () =>\n        this.#failWorker(worker, new FamiliarRuntimeError('Worker response could not be deserialized'));\n      this.#worker = worker;\n\n      return worker;\n    } catch (error) {\n      throw new FamiliarRuntimeError('Failed to create Worker', { cause: error });\n    }\n  }\n\n  #stopWorker(): void {\n    const worker = this.#worker;\n    this.#worker = undefined;\n    if (!worker) return;\n\n    worker.onmessage = null;\n    worker.onerror = null;\n    worker.onmessageerror = null;\n    worker.terminate();\n  }\n\n  #failWorker(worker: Worker, error: FamiliarRuntimeError): void {\n    if (this.#worker !== worker) return;\n\n    this.#stopWorker();\n    this.#settlePending('reject', error);\n\n    try {\n      this.#onSlotError?.(error);\n    } catch {\n      warn('onSlotError callback failed; Familiar continued replacing the failed worker slot.');\n    }\n  }\n\n  #onMessage(message: unknown): void {\n    if (!this.#pending) return;\n\n    if (\n      !isWorkerResponse<TOutput>(message) ||\n      message.id !== this.#pending.id ||\n      (this.#pending.kind === 'run' && message.kind === 'chunk')\n    ) {\n      this.cancel(new FamiliarRuntimeError('Worker returned an incompatible protocol response'));\n\n      return;\n    }\n\n    if (message.kind === 'chunk') {\n      this.#pending.emit?.(message.value);\n\n      return;\n    }\n\n    if (message.kind === 'error') {\n      this.#settlePending('reject', responseError(message.error));\n\n      return;\n    }\n\n    this.#settlePending('resolve', message.value);\n  }\n\n  #settlePending(kind: 'resolve' | 'reject', value: unknown): void {\n    const pending = this.#pending;\n\n    if (!pending) return;\n\n    this.#pending = undefined;\n\n    if (pending.timer) clearTimeout(pending.timer);\n\n    if (kind === 'resolve') pending.resolve(value as TOutput);\n    else pending.reject(value);\n  }\n}\n\nfunction slots<TInput, TOutput>(url: URL | string, options: ResolvedOptions): Slot<TInput, TOutput>[] {\n  const resolvedUrl = typeof url === 'string' ? url : url.href;\n  return Array.from({ length: options.concurrency }, () => new Slot<TInput, TOutput>(resolvedUrl, options.onSlotError));\n}\n\n/** Create a pool backed by an ES module worker registered with exposeTask(). */\nexport function createWorker<TInput, TOutput>(\n  url: URL | string,\n  options: WorkerOptions = {},\n): WorkerPool<TInput, TOutput> {\n  const resolved = resolveOptions(options);\n\n  return createPool(slots<TInput, TOutput>(url, resolved), {\n    concurrency: resolved.concurrency,\n    defaultTimeout: resolved.timeout,\n    maxQueue: resolved.maxQueue,\n    onFull: resolved.onFull,\n  });\n}\n\n/** Create a stream-only pool backed by an ES module worker registered with exposeStream(). */\nexport function createStreamWorker<TInput, TChunk>(\n  url: URL | string,\n  options: WorkerOptions = {},\n): StreamWorkerPool<TInput, TChunk> {\n  const resolved = resolveOptions(options);\n\n  return createStreamPool(slots<TInput, TChunk>(url, resolved), {\n    concurrency: resolved.concurrency,\n    defaultTimeout: resolved.timeout,\n    maxQueue: resolved.maxQueue,\n    onFull: resolved.onFull,\n  });\n}\n"],"mappings":"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"}
+{"version":3,"file":"worker.cjs","names":[],"sources":["../src/worker.ts"],"sourcesContent":["import { createPool } from './_pool.js';\nimport { MAX_CONCURRENCY, validateTimeout } from './_pool-core.js';\nimport { createStreamPool, type StreamSlot } from './_stream-pool.js';\nimport { unrefTimer } from './_timers.js';\nimport {\n  FamiliarInvalidOptionsError,\n  FamiliarRuntimeError,\n  FamiliarTaskError,\n  FamiliarTerminatedError,\n  FamiliarTimeoutError,\n} from './errors.js';\nimport type { SerializedError, WorkerResponse } from './protocol.js';\nimport { PROTOCOL_VERSION } from './protocol.js';\nimport type { RunOptions, SlotStrategy, StreamWorkerPool, WorkerOptions, WorkerPool } from './types.js';\n\ntype ResolvedOptions = {\n  concurrency: number;\n  maxQueue: number | undefined;\n  onFull: 'reject' | 'wait';\n  timeout: number | undefined;\n};\n\ntype Pending<TOutput> = {\n  emit?: (value: TOutput) => void;\n  id: number;\n  kind: 'run' | 'stream';\n  reject: (reason: unknown) => void;\n  resolve: (value: TOutput) => void;\n  timer?: ReturnType<typeof setTimeout>;\n};\n\ntype RunningStream<TChunk> = {\n  done: Promise<void>;\n  iterable: AsyncIterable<TChunk>;\n};\n\nfunction resolveOptions(options: WorkerOptions = {}): ResolvedOptions {\n  const { concurrency = 1, maxQueue, onFull = 'reject', timeout } = options;\n  const resolvedConcurrency =\n    concurrency === 'auto'\n      ? Math.min(MAX_CONCURRENCY, Math.max(1, globalThis.navigator?.hardwareConcurrency ?? 1))\n      : concurrency;\n\n  if (!Number.isInteger(resolvedConcurrency) || resolvedConcurrency < 1 || resolvedConcurrency > MAX_CONCURRENCY) {\n    throw new FamiliarInvalidOptionsError(`\\`concurrency\\` must be a positive integer ≤ ${MAX_CONCURRENCY} or \"auto\"`);\n  }\n\n  if (maxQueue !== undefined && (!Number.isInteger(maxQueue) || maxQueue < 1)) {\n    throw new FamiliarInvalidOptionsError('`maxQueue` must be a positive integer');\n  }\n\n  if (onFull !== 'reject' && onFull !== 'wait') {\n    throw new FamiliarInvalidOptionsError('`onFull` must be \"reject\" or \"wait\"');\n  }\n\n  validateTimeout(timeout);\n\n  return { concurrency: resolvedConcurrency, maxQueue, onFull, timeout };\n}\n\nfunction isWorkerResponse<TOutput>(value: unknown): value is WorkerResponse<TOutput> {\n  if (typeof value !== 'object' || value === null) return false;\n\n  const response = value as Partial<WorkerResponse<TOutput>>;\n  if (\n    response.version !== PROTOCOL_VERSION ||\n    typeof response.id !== 'number' ||\n    !Number.isSafeInteger(response.id) ||\n    response.id < 0\n  )\n    return false;\n\n  if (response.kind === 'chunk' || response.kind === 'result') return 'value' in response;\n  if (response.kind !== 'error' || typeof response.error !== 'object' || response.error === null) return false;\n\n  return (\n    (response.error.category === undefined || response.error.category === 'protocol') &&\n    typeof response.error.message === 'string' &&\n    typeof response.error.name === 'string' &&\n    (response.error.stack === undefined || typeof response.error.stack === 'string')\n  );\n}\n\nfunction responseError(error: SerializedError): FamiliarRuntimeError | FamiliarTaskError {\n  const cause = new Error(error.message);\n\n  cause.name = error.name;\n  cause.stack = error.stack;\n\n  return error.category === 'protocol'\n    ? new FamiliarRuntimeError(error.message, { cause })\n    : new FamiliarTaskError(error.message, { cause });\n}\n\nclass Slot<TInput, TOutput> implements SlotStrategy<TInput, TOutput>, StreamSlot<TInput, TOutput> {\n  readonly #url: URL | string;\n  #disposed = false;\n  #pending: Pending<TOutput> | undefined;\n  #taskId = 0;\n  #worker: Worker | undefined;\n\n  /** Wired by the pool factory to report unhandled worker runtime errors through `tap()`. */\n  notify: ((error: FamiliarRuntimeError) => void) | undefined = undefined;\n\n  constructor(url: URL | string) {\n    this.#url = url;\n  }\n\n  cancel(reason: unknown): void {\n    if (!this.#pending) return;\n    this.#stopWorker();\n    this.#settlePending('reject', reason);\n  }\n\n  run(input: TInput, transferables: Transferable[], timeout: number | undefined): Promise<TOutput> {\n    return this.#dispatch(input, transferables, timeout, 'run') as Promise<TOutput>;\n  }\n\n  stream(input: TInput, options: RunOptions): RunningStream<TOutput> {\n    const stop = () => this.cancel(new FamiliarTerminatedError('Stream consumer stopped'));\n    const chunks: TOutput[] = [];\n    const waiters: Array<(result: IteratorResult<TOutput>) => void> = [];\n    let done = false;\n    let error: unknown;\n    const emit = (value: TOutput) => {\n      const waiter = waiters.shift();\n\n      if (waiter) waiter({ done: false, value });\n      else chunks.push(value);\n    };\n    const finish = (reason?: unknown) => {\n      done = true;\n      error = reason;\n\n      while (waiters.length > 0) {\n        const waiter = waiters.shift()!;\n\n        if (reason !== undefined) waiter(Promise.reject(reason) as never);\n        else waiter({ done: true, value: undefined as never });\n      }\n    };\n    const donePromise = this.#dispatch(input, [...(options.transferables ?? [])], options.timeout, 'stream', emit).then(\n      () => finish(),\n      (reason: unknown) => finish(reason),\n    );\n\n    return {\n      done: donePromise,\n      iterable: {\n        [Symbol.asyncIterator]: () => ({\n          async next(): Promise<IteratorResult<TOutput>> {\n            if (chunks.length > 0) return { done: false, value: chunks.shift()! };\n\n            if (error !== undefined) throw error;\n\n            if (done) return { done: true, value: undefined as never };\n\n            return new Promise<IteratorResult<TOutput>>((resolve, reject) => {\n              waiters.push((result) => {\n                if (result instanceof Promise) void result.then(resolve, reject);\n                else resolve(result);\n              });\n            });\n          },\n          async return(): Promise<IteratorResult<TOutput>> {\n            stop();\n\n            return { done: true, value: undefined as never };\n          },\n        }),\n      },\n    };\n  }\n\n  terminate(): void {\n    this.#disposed = true;\n    this.#stopWorker();\n    this.#settlePending('reject', new FamiliarTerminatedError());\n  }\n\n  #dispatch(\n    input: TInput,\n    transferables: Transferable[],\n    timeout: number | undefined,\n    kind: 'run' | 'stream',\n    emit?: (value: TOutput) => void,\n  ): Promise<TOutput> {\n    if (this.#disposed) return Promise.reject(new FamiliarTerminatedError());\n\n    if (this.#pending) return Promise.reject(new FamiliarRuntimeError('Worker slot is already busy'));\n\n    try {\n      const worker = this.#ensureWorker();\n      const id = this.#taskId;\n      this.#taskId = id === Number.MAX_SAFE_INTEGER ? 0 : id + 1;\n\n      return new Promise<TOutput>((resolve, reject) => {\n        const pending: Pending<TOutput> = { emit, id, kind, reject, resolve };\n\n        this.#pending = pending;\n\n        if (timeout !== undefined) {\n          pending.timer = setTimeout(() => this.cancel(new FamiliarTimeoutError(timeout)), timeout);\n          unrefTimer(pending.timer);\n        }\n\n        try {\n          worker.postMessage({ id, input, kind, version: PROTOCOL_VERSION }, transferables);\n        } catch (error) {\n          this.cancel(new FamiliarRuntimeError('Failed to post message to worker', { cause: error }));\n        }\n      });\n    } catch (error) {\n      return Promise.reject(error);\n    }\n  }\n\n  #ensureWorker(): Worker {\n    if (this.#worker) return this.#worker;\n\n    if (typeof Worker === 'undefined') throw new FamiliarRuntimeError('Worker API is unavailable in this runtime');\n\n    try {\n      const worker = new Worker(this.#url, { type: 'module' });\n\n      worker.onmessage = (event: MessageEvent<unknown>) => {\n        if (this.#worker === worker) this.#onMessage(event.data);\n      };\n      worker.onerror = (event) => this.#failWorker(worker, new FamiliarRuntimeError(event.message || 'Worker failed'));\n      worker.onmessageerror = () =>\n        this.#failWorker(worker, new FamiliarRuntimeError('Worker response could not be deserialized'));\n      this.#worker = worker;\n\n      return worker;\n    } catch (error) {\n      throw new FamiliarRuntimeError('Failed to create Worker', { cause: error });\n    }\n  }\n\n  #stopWorker(): void {\n    const worker = this.#worker;\n    this.#worker = undefined;\n    if (!worker) return;\n\n    worker.onmessage = null;\n    worker.onerror = null;\n    worker.onmessageerror = null;\n    worker.terminate();\n  }\n\n  #failWorker(worker: Worker, error: FamiliarRuntimeError): void {\n    if (this.#worker !== worker) return;\n\n    this.#stopWorker();\n    this.#settlePending('reject', error);\n    this.notify?.(error);\n  }\n\n  #onMessage(message: unknown): void {\n    if (!this.#pending) return;\n\n    if (\n      !isWorkerResponse<TOutput>(message) ||\n      message.id !== this.#pending.id ||\n      (this.#pending.kind === 'run' && message.kind === 'chunk')\n    ) {\n      this.cancel(new FamiliarRuntimeError('Worker returned an incompatible protocol response'));\n\n      return;\n    }\n\n    if (message.kind === 'chunk') {\n      this.#pending.emit?.(message.value);\n\n      return;\n    }\n\n    if (message.kind === 'error') {\n      this.#settlePending('reject', responseError(message.error));\n\n      return;\n    }\n\n    this.#settlePending('resolve', message.value);\n  }\n\n  #settlePending(kind: 'resolve' | 'reject', value: unknown): void {\n    const pending = this.#pending;\n\n    if (!pending) return;\n\n    this.#pending = undefined;\n\n    if (pending.timer) clearTimeout(pending.timer);\n\n    if (kind === 'resolve') pending.resolve(value as TOutput);\n    else pending.reject(value);\n  }\n}\n\nfunction slots<TInput, TOutput>(url: URL | string, options: ResolvedOptions): Slot<TInput, TOutput>[] {\n  const resolvedUrl = typeof url === 'string' ? url : url.href;\n  return Array.from({ length: options.concurrency }, () => new Slot<TInput, TOutput>(resolvedUrl));\n}\n\n/** Create a pool backed by an ES module worker registered with exposeTask(). */\nexport function createWorker<TInput, TOutput>(\n  url: URL | string,\n  options: WorkerOptions = {},\n): WorkerPool<TInput, TOutput> {\n  const resolved = resolveOptions(options);\n\n  return createPool(slots<TInput, TOutput>(url, resolved), {\n    defaultTimeout: resolved.timeout,\n    maxQueue: resolved.maxQueue,\n    onFull: resolved.onFull,\n  });\n}\n\n/** Create a stream-only pool backed by an ES module worker registered with exposeStream(). */\nexport function createStreamWorker<TInput, TChunk>(\n  url: URL | string,\n  options: WorkerOptions = {},\n): StreamWorkerPool<TInput, TChunk> {\n  const resolved = resolveOptions(options);\n\n  return createStreamPool(slots<TInput, TChunk>(url, resolved), {\n    defaultTimeout: resolved.timeout,\n    maxQueue: resolved.maxQueue,\n    onFull: resolved.onFull,\n  });\n}\n"],"mappings":"4KAoCA,SAAS,eAAe,EAAyB,CAAC,EAAoB,CACpE,GAAM,CAAE,cAAc,EAAG,WAAU,SAAS,SAAU,WAAY,EAC5D,EACJ,IAAgB,OACZ,KAAK,IAAA,IAAqB,KAAK,IAAI,EAAG,WAAW,WAAW,qBAAuB,CAAC,CAAC,EACrF,EAEN,GAAI,CAAC,OAAO,UAAU,CAAmB,GAAK,EAAsB,GAAK,EAAA,IACvE,MAAM,IAAI,EAAA,4BAA4B,0DAA2E,EAGnH,GAAI,IAAa,IAAA,KAAc,CAAC,OAAO,UAAU,CAAQ,GAAK,EAAW,GACvE,MAAM,IAAI,EAAA,4BAA4B,uCAAuC,EAG/E,GAAI,IAAW,UAAY,IAAW,OACpC,MAAM,IAAI,EAAA,4BAA4B,qCAAqC,EAK7E,OAFA,EAAA,gBAAgB,CAAO,EAEhB,CAAE,YAAa,EAAqB,WAAU,SAAQ,SAAQ,CACvE,CAEA,SAAS,iBAA0B,EAAkD,CACnF,GAAI,OAAO,GAAU,WAAY,EAAgB,MAAO,GAExD,IAAM,EAAW,EAYjB,OAVE,EAAS,UAAA,GACT,OAAO,EAAS,IAAO,UACvB,CAAC,OAAO,cAAc,EAAS,EAAE,GACjC,EAAS,GAAK,EAEP,GAEL,EAAS,OAAS,SAAW,EAAS,OAAS,SAAiB,UAAW,EAC3E,EAAS,OAAS,SAAW,OAAO,EAAS,OAAU,UAAY,EAAS,QAAU,KAAa,IAGpG,EAAS,MAAM,WAAa,IAAA,IAAa,EAAS,MAAM,WAAa,aACtE,OAAO,EAAS,MAAM,SAAY,UAClC,OAAO,EAAS,MAAM,MAAS,WAC9B,EAAS,MAAM,QAAU,IAAA,IAAa,OAAO,EAAS,MAAM,OAAU,SAE3E,CAEA,SAAS,cAAc,EAAkE,CACvF,IAAM,EAAY,MAAM,EAAM,OAAO,EAKrC,MAHA,GAAM,KAAO,EAAM,KACnB,EAAM,MAAQ,EAAM,MAEb,EAAM,WAAa,WACtB,IAAI,EAAA,qBAAqB,EAAM,QAAS,CAAE,OAAM,CAAC,EACjD,IAAI,EAAA,kBAAkB,EAAM,QAAS,CAAE,OAAM,CAAC,CACpD,CAEA,IAAM,KAAN,KAAkG,CAChG,GACA,GAAY,GACZ,GACA,GAAU,EACV,GAGA,OAA8D,IAAA,GAE9D,YAAY,EAAmB,CAC7B,KAAK,GAAO,CACd,CAEA,OAAO,EAAuB,CACvB,KAAK,KACV,KAAK,GAAY,EACjB,KAAK,GAAe,SAAU,CAAM,EACtC,CAEA,IAAI,EAAe,EAA+B,EAA+C,CAC/F,OAAO,KAAK,GAAU,EAAO,EAAe,EAAS,KAAK,CAC5D,CAEA,OAAO,EAAe,EAA6C,CACjE,IAAM,SAAa,KAAK,OAAO,IAAI,EAAA,wBAAwB,yBAAyB,CAAC,EAC/E,EAAoB,CAAC,EACrB,EAA4D,CAAC,EAC/D,EAAO,GACP,EACE,KAAQ,GAAmB,CAC/B,IAAM,EAAS,EAAQ,MAAM,EAEzB,EAAQ,EAAO,CAAE,KAAM,GAAO,OAAM,CAAC,EACpC,EAAO,KAAK,CAAK,CACxB,EACM,OAAU,GAAqB,CAInC,IAHA,EAAO,GACP,EAAQ,EAED,EAAQ,OAAS,GACP,EAAQ,MAGlB,CAAA,CADD,IAAW,IAAA,GACH,CAAE,KAAM,GAAM,MAAO,IAAA,EAAmB,EADnB,QAAQ,OAAO,CAAM,CACD,CAEzD,EAMA,MAAO,CACL,KANkB,KAAK,GAAU,EAAO,CAAC,GAAI,EAAQ,eAAiB,CAAC,CAAE,EAAG,EAAQ,QAAS,SAAU,IAAI,CAAC,CAAC,SACvG,OAAO,EACZ,GAAoB,OAAO,CAAM,CAI5B,EACN,SAAU,EACP,OAAO,oBAAuB,CAC7B,MAAM,MAAyC,CAC7C,GAAI,EAAO,OAAS,EAAG,MAAO,CAAE,KAAM,GAAO,MAAO,EAAO,MAAM,CAAG,EAEpE,GAAI,IAAU,IAAA,GAAW,MAAM,EAI/B,OAFI,EAAa,CAAE,KAAM,GAAM,MAAO,IAAA,EAAmB,EAElD,IAAI,SAAkC,EAAS,IAAW,CAC/D,EAAQ,KAAM,GAAW,CACnB,aAAkB,QAAS,EAAY,KAAK,EAAS,CAAM,EAC1D,EAAQ,CAAM,CACrB,CAAC,CACH,CAAC,CACH,EACA,MAAM,QAA2C,CAG/C,OAFA,KAAK,EAEE,CAAE,KAAM,GAAM,MAAO,IAAA,EAAmB,CACjD,CACF,EACF,CACF,CACF,CAEA,WAAkB,CAChB,KAAK,GAAY,GACjB,KAAK,GAAY,EACjB,KAAK,GAAe,SAAU,IAAI,EAAA,uBAAyB,CAC7D,CAEA,GACE,EACA,EACA,EACA,EACA,EACkB,CAClB,GAAI,KAAK,GAAW,OAAO,QAAQ,OAAO,IAAI,EAAA,uBAAyB,EAEvE,GAAI,KAAK,GAAU,OAAO,QAAQ,OAAO,IAAI,EAAA,qBAAqB,6BAA6B,CAAC,EAEhG,GAAI,CACF,IAAM,EAAS,KAAK,GAAc,EAC5B,EAAK,KAAK,GAGhB,MAFA,MAAK,GAAU,YAAiC,EAAI,EAAK,EAElD,IAAI,SAAkB,EAAS,IAAW,CAC/C,IAAM,EAA4B,CAAE,OAAM,KAAI,OAAM,SAAQ,SAAQ,EAEpE,KAAK,GAAW,EAEZ,IAAY,IAAA,KACd,EAAQ,MAAQ,eAAiB,KAAK,OAAO,IAAI,EAAA,qBAAqB,CAAO,CAAC,EAAG,CAAO,EACxF,EAAA,WAAW,EAAQ,KAAK,GAG1B,GAAI,CACF,EAAO,YAAY,CAAE,KAAI,QAAO,OAAM,QAAA,CAA0B,EAAG,CAAa,CAClF,OAAS,EAAO,CACd,KAAK,OAAO,IAAI,EAAA,qBAAqB,mCAAoC,CAAE,MAAO,CAAM,CAAC,CAAC,CAC5F,CACF,CAAC,CACH,OAAS,EAAO,CACd,OAAO,QAAQ,OAAO,CAAK,CAC7B,CACF,CAEA,IAAwB,CACtB,GAAI,KAAK,GAAS,OAAO,KAAK,GAE9B,GAAI,OAAO,OAAW,IAAa,MAAM,IAAI,EAAA,qBAAqB,2CAA2C,EAE7G,GAAI,CACF,IAAM,EAAS,IAAI,OAAO,KAAK,GAAM,CAAE,KAAM,QAAS,CAAC,EAUvD,MARA,GAAO,UAAa,GAAiC,CAC/C,KAAK,KAAY,GAAQ,KAAK,GAAW,EAAM,IAAI,CACzD,EACA,EAAO,QAAW,GAAU,KAAK,GAAY,EAAQ,IAAI,EAAA,qBAAqB,EAAM,SAAW,eAAe,CAAC,EAC/G,EAAO,mBACL,KAAK,GAAY,EAAQ,IAAI,EAAA,qBAAqB,2CAA2C,CAAC,EAChG,KAAK,GAAU,EAER,CACT,OAAS,EAAO,CACd,MAAM,IAAI,EAAA,qBAAqB,0BAA2B,CAAE,MAAO,CAAM,CAAC,CAC5E,CACF,CAEA,IAAoB,CAClB,IAAM,EAAS,KAAK,GACpB,KAAK,GAAU,IAAA,GACV,IAEL,EAAO,UAAY,KACnB,EAAO,QAAU,KACjB,EAAO,eAAiB,KACxB,EAAO,UAAU,EACnB,CAEA,GAAY,EAAgB,EAAmC,CACzD,KAAK,KAAY,IAErB,KAAK,GAAY,EACjB,KAAK,GAAe,SAAU,CAAK,EACnC,KAAK,SAAS,CAAK,EACrB,CAEA,GAAW,EAAwB,CAC5B,QAAK,GAEV,IACE,CAAC,iBAA0B,CAAO,GAClC,EAAQ,KAAO,KAAK,GAAS,IAC5B,KAAK,GAAS,OAAS,OAAS,EAAQ,OAAS,QAClD,CACA,KAAK,OAAO,IAAI,EAAA,qBAAqB,mDAAmD,CAAC,EAEzF,MACF,CAEA,GAAI,EAAQ,OAAS,QAAS,CAC5B,KAAK,GAAS,OAAO,EAAQ,KAAK,EAElC,MACF,CAEA,GAAI,EAAQ,OAAS,QAAS,CAC5B,KAAK,GAAe,SAAU,cAAc,EAAQ,KAAK,CAAC,EAE1D,MACF,CAEA,KAAK,GAAe,UAAW,EAAQ,KAAK,CAd5C,CAeF,CAEA,GAAe,EAA4B,EAAsB,CAC/D,IAAM,EAAU,KAAK,GAEhB,IAEL,KAAK,GAAW,IAAA,GAEZ,EAAQ,OAAO,aAAa,EAAQ,KAAK,EAEzC,IAAS,UAAW,EAAQ,QAAQ,CAAgB,EACnD,EAAQ,OAAO,CAAK,EAC3B,CACF,EAEA,SAAS,MAAuB,EAAmB,EAAmD,CACpG,IAAM,EAAc,OAAO,GAAQ,SAAW,EAAM,EAAI,KACxD,OAAO,MAAM,KAAK,CAAE,OAAQ,EAAQ,WAAY,MAAS,IAAI,KAAsB,CAAW,CAAC,CACjG,CAGA,SAAgB,aACd,EACA,EAAyB,CAAC,EACG,CAC7B,IAAM,EAAW,eAAe,CAAO,EAEvC,OAAO,EAAA,WAAW,MAAuB,EAAK,CAAQ,EAAG,CACvD,eAAgB,EAAS,QACzB,SAAU,EAAS,SACnB,OAAQ,EAAS,MACnB,CAAC,CACH,CAGA,SAAgB,mBACd,EACA,EAAyB,CAAC,EACQ,CAClC,IAAM,EAAW,eAAe,CAAO,EAEvC,OAAO,EAAA,iBAAiB,MAAsB,EAAK,CAAQ,EAAG,CAC5D,eAAgB,EAAS,QACzB,SAAU,EAAS,SACnB,OAAQ,EAAS,MACnB,CAAC,CACH"}

package/dist/worker.d.ts

@@ -1,12 +1,4 @@
-export type { BatchOptions } from './_pool.js';
-export { runBatch } from './_pool.js';
-export { FamiliarError, FamiliarInvalidOptionsError, FamiliarQueueFullError, FamiliarRuntimeError, FamiliarTaskError, FamiliarTerminatedError, FamiliarTimeoutError, } from './errors.js';
-export type { DrainOptions, PoolBase, RunOptions, StreamWorkerPool, WorkerOptions, WorkerPool, WorkerStats, WorkerStatus, } from './types.js';
 import type { StreamWorkerPool, WorkerOptions, WorkerPool } from './types.js';
-export type RunningStream<TChunk> = {
-    done: Promise<void>;
-    iterable: AsyncIterable<TChunk>;
-};
 /** Create a pool backed by an ES module worker registered with exposeTask(). */
 export declare function createWorker<TInput, TOutput>(url: URL | string, options?: WorkerOptions): WorkerPool<TInput, TOutput>;
 /** Create a stream-only pool backed by an ES module worker registered with exposeStream(). */

package/dist/worker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../src/worker.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EACL,aAAa,EACb,2BAA2B,EAC3B,sBAAsB,EACtB,oBAAoB,EACpB,iBAAiB,EACjB,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,YAAY,EACZ,QAAQ,EACR,UAAU,EACV,gBAAgB,EAChB,aAAa,EACb,UAAU,EACV,WAAW,EACX,YAAY,GACb,MAAM,YAAY,CAAC;AAgBpB,OAAO,KAAK,EAA4B,gBAAgB,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAmBxG,MAAM,MAAM,aAAa,CAAC,MAAM,IAAI;IAClC,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACpB,QAAQ,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CACjC,CAAC;AAmRF,gFAAgF;AAChF,wBAAgB,YAAY,CAAC,MAAM,EAAE,OAAO,EAC1C,GAAG,EAAE,GAAG,GAAG,MAAM,EACjB,OAAO,GAAE,aAAkB,GAC1B,UAAU,CAAC,MAAM,EAAE,OAAO,CAAC,CAS7B;AAED,8FAA8F;AAC9F,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAC/C,GAAG,EAAE,GAAG,GAAG,MAAM,EACjB,OAAO,GAAE,aAAkB,GAC1B,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,CASlC"}
+{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../src/worker.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAA4B,gBAAgB,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAoSxG,gFAAgF;AAChF,wBAAgB,YAAY,CAAC,MAAM,EAAE,OAAO,EAC1C,GAAG,EAAE,GAAG,GAAG,MAAM,EACjB,OAAO,GAAE,aAAkB,GAC1B,UAAU,CAAC,MAAM,EAAE,OAAO,CAAC,CAQ7B;AAED,8FAA8F;AAC9F,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAC/C,GAAG,EAAE,GAAG,GAAG,MAAM,EACjB,OAAO,GAAE,aAAkB,GAC1B,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,CAQlC"}

package/dist/worker.js

@@ -1,190 +1,2 @@
-import { unrefTimer as e } from "./_timers.js";
-import { FamiliarError as t, FamiliarInvalidOptionsError as n, FamiliarQueueFullError as r, FamiliarRuntimeError as i, FamiliarTaskError as a, FamiliarTerminatedError as o, FamiliarTimeoutError as s } from "./errors.js";
-import { validateTimeout as c } from "./_pool-core.js";
-import { createPool as l, runBatch as u } from "./_pool.js";
-import "./_dev.js";
-import { createStreamPool as d } from "./_stream-pool.js";
-import "./protocol.js";
-//#region src/worker.ts
-function f(e = {}) {
-	let { concurrency: t = 1, maxQueue: r, onFull: i = "reject", onSlotError: a, timeout: o } = e, s = t === "auto" ? Math.min(512, Math.max(1, globalThis.navigator?.hardwareConcurrency ?? 1)) : t;
-	if (!Number.isInteger(s) || s < 1 || s > 512) throw new n("`concurrency` must be a positive integer ≤ 512 or \"auto\"");
-	if (r !== void 0 && (!Number.isInteger(r) || r < 1)) throw new n("`maxQueue` must be a positive integer");
-	if (i !== "reject" && i !== "wait") throw new n("`onFull` must be \"reject\" or \"wait\"");
-	return c(o), {
-		concurrency: s,
-		maxQueue: r,
-		onFull: i,
-		onSlotError: a,
-		timeout: o
-	};
-}
-function p(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 m(e) {
-	let t = Error(e.message);
-	return t.name = e.name, t.stack = e.stack, e.category === "protocol" ? new i(e.message, { cause: t }) : new a(e.message, { cause: t });
-}
-var h = class {
-	#e;
-	#t;
-	#n = !1;
-	#r;
-	#i = 0;
-	#a;
-	constructor(e, t) {
-		this.#t = e, this.#e = t;
-	}
-	cancel(e) {
-		this.#r && (this.#c(), this.#d("reject", e));
-	}
-	run(e, t, n) {
-		return this.#o(e, t, n, "run");
-	}
-	stream(e, t) {
-		let n = () => this.cancel(new o("Stream consumer stopped")), r = [], i = [], a = !1, s, c = (e) => {
-			let t = i.shift();
-			t ? t({
-				done: !1,
-				value: e
-			}) : r.push(e);
-		}, l = (e) => {
-			for (a = !0, s = e; i.length > 0;) i.shift()(e === void 0 ? {
-				done: !0,
-				value: void 0
-			} : Promise.reject(e));
-		};
-		return {
-			done: this.#o(e, [...t.transferables ?? []], t.timeout, "stream", c).then(() => l(), (e) => l(e)),
-			iterable: { [Symbol.asyncIterator]: () => ({
-				async next() {
-					if (r.length > 0) return {
-						done: !1,
-						value: r.shift()
-					};
-					if (s !== void 0) throw s;
-					return a ? {
-						done: !0,
-						value: void 0
-					} : new Promise((e, t) => {
-						i.push((n) => {
-							n instanceof Promise ? n.then(e, t) : e(n);
-						});
-					});
-				},
-				async return() {
-					return n(), {
-						done: !0,
-						value: void 0
-					};
-				}
-			}) }
-		};
-	}
-	terminate() {
-		this.#n = !0, this.#c(), this.#d("reject", new o());
-	}
-	#o(t, n, r, a, c) {
-		if (this.#n) return Promise.reject(new o());
-		if (this.#r) return Promise.reject(new i("Worker slot is already busy"));
-		try {
-			let o = this.#s(), l = this.#i;
-			return this.#i = l === 2 ** 53 - 1 ? 0 : l + 1, new Promise((u, d) => {
-				let f = {
-					emit: c,
-					id: l,
-					kind: a,
-					reject: d,
-					resolve: u
-				};
-				this.#r = f, r !== void 0 && (f.timer = setTimeout(() => this.cancel(new s(r)), r), e(f.timer));
-				try {
-					o.postMessage({
-						id: l,
-						input: t,
-						kind: a,
-						version: 1
-					}, n);
-				} catch (e) {
-					this.cancel(new i("Failed to post message to worker", { cause: e }));
-				}
-			});
-		} catch (e) {
-			return Promise.reject(e);
-		}
-	}
-	#s() {
-		if (this.#a) return this.#a;
-		if (typeof Worker > "u") throw new i("Worker API is unavailable in this runtime");
-		try {
-			let e = new Worker(this.#t, { type: "module" });
-			return e.onmessage = (t) => {
-				this.#a === e && this.#u(t.data);
-			}, e.onerror = (t) => this.#l(e, new i(t.message || "Worker failed")), e.onmessageerror = () => this.#l(e, new i("Worker response could not be deserialized")), this.#a = e, e;
-		} catch (e) {
-			throw new i("Failed to create Worker", { cause: e });
-		}
-	}
-	#c() {
-		let e = this.#a;
-		this.#a = void 0, e && (e.onmessage = null, e.onerror = null, e.onmessageerror = null, e.terminate());
-	}
-	#l(e, t) {
-		if (this.#a === e) {
-			this.#c(), this.#d("reject", t);
-			try {
-				this.#e?.(t);
-			} catch {}
-		}
-	}
-	#u(e) {
-		if (this.#r) {
-			if (!p(e) || e.id !== this.#r.id || this.#r.kind === "run" && e.kind === "chunk") {
-				this.cancel(new i("Worker returned an incompatible protocol response"));
-				return;
-			}
-			if (e.kind === "chunk") {
-				this.#r.emit?.(e.value);
-				return;
-			}
-			if (e.kind === "error") {
-				this.#d("reject", m(e.error));
-				return;
-			}
-			this.#d("resolve", e.value);
-		}
-	}
-	#d(e, t) {
-		let n = this.#r;
-		n && (this.#r = void 0, n.timer && clearTimeout(n.timer), e === "resolve" ? n.resolve(t) : n.reject(t));
-	}
-};
-function g(e, t) {
-	let n = typeof e == "string" ? e : e.href;
-	return Array.from({ length: t.concurrency }, () => new h(n, t.onSlotError));
-}
-function _(e, t = {}) {
-	let n = f(t);
-	return l(g(e, n), {
-		concurrency: n.concurrency,
-		defaultTimeout: n.timeout,
-		maxQueue: n.maxQueue,
-		onFull: n.onFull
-	});
-}
-function v(e, t = {}) {
-	let n = f(t);
-	return d(g(e, n), {
-		concurrency: n.concurrency,
-		defaultTimeout: n.timeout,
-		maxQueue: n.maxQueue,
-		onFull: n.onFull
-	});
-}
-//#endregion
-export { t as FamiliarError, n as FamiliarInvalidOptionsError, r as FamiliarQueueFullError, i as FamiliarRuntimeError, a as FamiliarTaskError, o as FamiliarTerminatedError, s as FamiliarTimeoutError, v as createStreamWorker, _ as createWorker, u as runBatch };
-
+import{unrefTimer as e}from"./_timers.js";import{FamiliarInvalidOptionsError as t,FamiliarRuntimeError as n,FamiliarTaskError as r,FamiliarTerminatedError as i,FamiliarTimeoutError as a}from"./errors.js";import{validateTimeout as o}from"./_pool-core.js";import{createPool as s}from"./_pool.js";import{createStreamPool as c}from"./_stream-pool.js";import"./protocol.js";function resolveOptions(e={}){let{concurrency:n=1,maxQueue:r,onFull:i=`reject`,timeout:a}=e,s=n===`auto`?Math.min(512,Math.max(1,globalThis.navigator?.hardwareConcurrency??1)):n;if(!Number.isInteger(s)||s<1||s>512)throw new t('`concurrency` must be a positive integer ≤ 512 or "auto"');if(r!==void 0&&(!Number.isInteger(r)||r<1))throw new t("`maxQueue` must be a positive integer");if(i!==`reject`&&i!==`wait`)throw new t('`onFull` must be "reject" or "wait"');return o(a),{concurrency:s,maxQueue:r,onFull:i,timeout:a}}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 n(e.message,{cause:t}):new r(e.message,{cause:t})}var Slot=class{#e;#t=!1;#n;#r=0;#i;notify=void 0;constructor(e){this.#e=e}cancel(e){this.#n&&(this.#s(),this.#u(`reject`,e))}run(e,t,n){return this.#a(e,t,n,`run`)}stream(e,t){let stop=()=>this.cancel(new i(`Stream consumer stopped`)),n=[],r=[],a=!1,o,emit=e=>{let t=r.shift();t?t({done:!1,value:e}):n.push(e)},finish=e=>{for(a=!0,o=e;r.length>0;)r.shift()(e===void 0?{done:!0,value:void 0}:Promise.reject(e))};return{done:this.#a(e,[...t.transferables??[]],t.timeout,`stream`,emit).then(()=>finish(),e=>finish(e)),iterable:{[Symbol.asyncIterator]:()=>({async next(){if(n.length>0)return{done:!1,value:n.shift()};if(o!==void 0)throw o;return a?{done:!0,value:void 0}:new Promise((e,t)=>{r.push(n=>{n instanceof Promise?n.then(e,t):e(n)})})},async return(){return stop(),{done:!0,value:void 0}}})}}}terminate(){this.#t=!0,this.#s(),this.#u(`reject`,new i)}#a(t,r,o,s,c){if(this.#t)return Promise.reject(new i);if(this.#n)return Promise.reject(new n(`Worker slot is already busy`));try{let i=this.#o(),l=this.#r;return this.#r=l===2**53-1?0:l+1,new Promise((u,d)=>{let f={emit:c,id:l,kind:s,reject:d,resolve:u};this.#n=f,o!==void 0&&(f.timer=setTimeout(()=>this.cancel(new a(o)),o),e(f.timer));try{i.postMessage({id:l,input:t,kind:s,version:1},r)}catch(e){this.cancel(new n(`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 n(`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 n(t.message||`Worker failed`)),e.onmessageerror=()=>this.#c(e,new n(`Worker response could not be deserialized`)),this.#i=e,e}catch(e){throw new n(`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 n(`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 s(slots(e,n),{defaultTimeout:n.timeout,maxQueue:n.maxQueue,onFull:n.onFull})}function createStreamWorker(e,t={}){let n=resolveOptions(t);return c(slots(e,n),{defaultTimeout:n.timeout,maxQueue:n.maxQueue,onFull:n.onFull})}export{createStreamWorker,createWorker};
 //# sourceMappingURL=worker.js.map

package/dist/worker.js.map

@@ -1 +1 @@
-{"version":3,"file":"worker.js","names":[],"sources":["../src/worker.ts"],"sourcesContent":["export type { BatchOptions } from './_pool.js';\nexport { runBatch } from './_pool.js';\nexport {\n  FamiliarError,\n  FamiliarInvalidOptionsError,\n  FamiliarQueueFullError,\n  FamiliarRuntimeError,\n  FamiliarTaskError,\n  FamiliarTerminatedError,\n  FamiliarTimeoutError,\n} from './errors.js';\nexport type {\n  DrainOptions,\n  PoolBase,\n  RunOptions,\n  StreamWorkerPool,\n  WorkerOptions,\n  WorkerPool,\n  WorkerStats,\n  WorkerStatus,\n} from './types.js';\n\nimport { warn } from './_dev.js';\nimport { createPool } from './_pool.js';\nimport { MAX_CONCURRENCY, validateTimeout } from './_pool-core.js';\nimport { createStreamPool, type StreamSlot } from './_stream-pool.js';\nimport { unrefTimer } from './_timers.js';\nimport {\n  FamiliarInvalidOptionsError,\n  FamiliarRuntimeError,\n  FamiliarTaskError,\n  FamiliarTerminatedError,\n  FamiliarTimeoutError,\n} from './errors.js';\nimport type { SerializedError, WorkerResponse } from './protocol.js';\nimport { PROTOCOL_VERSION } from './protocol.js';\nimport type { RunOptions, SlotStrategy, StreamWorkerPool, WorkerOptions, WorkerPool } from './types.js';\n\ntype ResolvedOptions = {\n  concurrency: number;\n  maxQueue: number | undefined;\n  onFull: 'reject' | 'wait';\n  onSlotError: WorkerOptions['onSlotError'];\n  timeout: number | undefined;\n};\n\ntype Pending<TOutput> = {\n  emit?: (value: TOutput) => void;\n  id: number;\n  kind: 'run' | 'stream';\n  reject: (reason: unknown) => void;\n  resolve: (value: TOutput) => void;\n  timer?: ReturnType<typeof setTimeout>;\n};\n\nexport type RunningStream<TChunk> = {\n  done: Promise<void>;\n  iterable: AsyncIterable<TChunk>;\n};\n\nfunction resolveOptions(options: WorkerOptions = {}): ResolvedOptions {\n  const { concurrency = 1, maxQueue, onFull = 'reject', onSlotError, timeout } = options;\n  const resolvedConcurrency =\n    concurrency === 'auto'\n      ? Math.min(MAX_CONCURRENCY, Math.max(1, globalThis.navigator?.hardwareConcurrency ?? 1))\n      : concurrency;\n\n  if (!Number.isInteger(resolvedConcurrency) || resolvedConcurrency < 1 || resolvedConcurrency > MAX_CONCURRENCY) {\n    throw new FamiliarInvalidOptionsError(`\\`concurrency\\` must be a positive integer ≤ ${MAX_CONCURRENCY} or \"auto\"`);\n  }\n\n  if (maxQueue !== undefined && (!Number.isInteger(maxQueue) || maxQueue < 1)) {\n    throw new FamiliarInvalidOptionsError('`maxQueue` must be a positive integer');\n  }\n\n  if (onFull !== 'reject' && onFull !== 'wait') {\n    throw new FamiliarInvalidOptionsError('`onFull` must be \"reject\" or \"wait\"');\n  }\n\n  validateTimeout(timeout);\n\n  return { concurrency: resolvedConcurrency, maxQueue, onFull, onSlotError, timeout };\n}\n\nfunction isWorkerResponse<TOutput>(value: unknown): value is WorkerResponse<TOutput> {\n  if (typeof value !== 'object' || value === null) return false;\n\n  const response = value as Partial<WorkerResponse<TOutput>>;\n  if (\n    response.version !== PROTOCOL_VERSION ||\n    typeof response.id !== 'number' ||\n    !Number.isSafeInteger(response.id) ||\n    response.id < 0\n  )\n    return false;\n\n  if (response.kind === 'chunk' || response.kind === 'result') return 'value' in response;\n  if (response.kind !== 'error' || typeof response.error !== 'object' || response.error === null) return false;\n\n  return (\n    (response.error.category === undefined || response.error.category === 'protocol') &&\n    typeof response.error.message === 'string' &&\n    typeof response.error.name === 'string' &&\n    (response.error.stack === undefined || typeof response.error.stack === 'string')\n  );\n}\n\nfunction responseError(error: SerializedError): FamiliarRuntimeError | FamiliarTaskError {\n  const cause = new Error(error.message);\n\n  cause.name = error.name;\n  cause.stack = error.stack;\n\n  return error.category === 'protocol'\n    ? new FamiliarRuntimeError(error.message, { cause })\n    : new FamiliarTaskError(error.message, { cause });\n}\n\nclass Slot<TInput, TOutput> implements SlotStrategy<TInput, TOutput>, StreamSlot<TInput, TOutput> {\n  readonly #onSlotError: WorkerOptions['onSlotError'];\n  readonly #url: URL | string;\n  #disposed = false;\n  #pending: Pending<TOutput> | undefined;\n  #taskId = 0;\n  #worker: Worker | undefined;\n\n  constructor(url: URL | string, onSlotError: WorkerOptions['onSlotError']) {\n    this.#url = url;\n    this.#onSlotError = onSlotError;\n  }\n\n  cancel(reason: unknown): void {\n    if (!this.#pending) return;\n    this.#stopWorker();\n    this.#settlePending('reject', reason);\n  }\n\n  run(input: TInput, transferables: Transferable[], timeout: number | undefined): Promise<TOutput> {\n    return this.#dispatch(input, transferables, timeout, 'run') as Promise<TOutput>;\n  }\n\n  stream(input: TInput, options: RunOptions): RunningStream<TOutput> {\n    const stop = () => this.cancel(new FamiliarTerminatedError('Stream consumer stopped'));\n    const chunks: TOutput[] = [];\n    const waiters: Array<(result: IteratorResult<TOutput>) => void> = [];\n    let done = false;\n    let error: unknown;\n    const emit = (value: TOutput) => {\n      const waiter = waiters.shift();\n\n      if (waiter) waiter({ done: false, value });\n      else chunks.push(value);\n    };\n    const finish = (reason?: unknown) => {\n      done = true;\n      error = reason;\n\n      while (waiters.length > 0) {\n        const waiter = waiters.shift()!;\n\n        if (reason !== undefined) waiter(Promise.reject(reason) as never);\n        else waiter({ done: true, value: undefined as never });\n      }\n    };\n    const donePromise = this.#dispatch(input, [...(options.transferables ?? [])], options.timeout, 'stream', emit).then(\n      () => finish(),\n      (reason: unknown) => finish(reason),\n    );\n\n    return {\n      done: donePromise,\n      iterable: {\n        [Symbol.asyncIterator]: () => ({\n          async next(): Promise<IteratorResult<TOutput>> {\n            if (chunks.length > 0) return { done: false, value: chunks.shift()! };\n\n            if (error !== undefined) throw error;\n\n            if (done) return { done: true, value: undefined as never };\n\n            return new Promise<IteratorResult<TOutput>>((resolve, reject) => {\n              waiters.push((result) => {\n                if (result instanceof Promise) void result.then(resolve, reject);\n                else resolve(result);\n              });\n            });\n          },\n          async return(): Promise<IteratorResult<TOutput>> {\n            stop();\n\n            return { done: true, value: undefined as never };\n          },\n        }),\n      },\n    };\n  }\n\n  terminate(): void {\n    this.#disposed = true;\n    this.#stopWorker();\n    this.#settlePending('reject', new FamiliarTerminatedError());\n  }\n\n  #dispatch(\n    input: TInput,\n    transferables: Transferable[],\n    timeout: number | undefined,\n    kind: 'run' | 'stream',\n    emit?: (value: TOutput) => void,\n  ): Promise<TOutput> {\n    if (this.#disposed) return Promise.reject(new FamiliarTerminatedError());\n\n    if (this.#pending) return Promise.reject(new FamiliarRuntimeError('Worker slot is already busy'));\n\n    try {\n      const worker = this.#ensureWorker();\n      const id = this.#taskId;\n      this.#taskId = id === Number.MAX_SAFE_INTEGER ? 0 : id + 1;\n\n      return new Promise<TOutput>((resolve, reject) => {\n        const pending: Pending<TOutput> = { emit, id, kind, reject, resolve };\n\n        this.#pending = pending;\n\n        if (timeout !== undefined) {\n          pending.timer = setTimeout(() => this.cancel(new FamiliarTimeoutError(timeout)), timeout);\n          unrefTimer(pending.timer);\n        }\n\n        try {\n          worker.postMessage({ id, input, kind, version: PROTOCOL_VERSION }, transferables);\n        } catch (error) {\n          this.cancel(new FamiliarRuntimeError('Failed to post message to worker', { cause: error }));\n        }\n      });\n    } catch (error) {\n      return Promise.reject(error);\n    }\n  }\n\n  #ensureWorker(): Worker {\n    if (this.#worker) return this.#worker;\n\n    if (typeof Worker === 'undefined') throw new FamiliarRuntimeError('Worker API is unavailable in this runtime');\n\n    try {\n      const worker = new Worker(this.#url, { type: 'module' });\n\n      worker.onmessage = (event: MessageEvent<unknown>) => {\n        if (this.#worker === worker) this.#onMessage(event.data);\n      };\n      worker.onerror = (event) => this.#failWorker(worker, new FamiliarRuntimeError(event.message || 'Worker failed'));\n      worker.onmessageerror = () =>\n        this.#failWorker(worker, new FamiliarRuntimeError('Worker response could not be deserialized'));\n      this.#worker = worker;\n\n      return worker;\n    } catch (error) {\n      throw new FamiliarRuntimeError('Failed to create Worker', { cause: error });\n    }\n  }\n\n  #stopWorker(): void {\n    const worker = this.#worker;\n    this.#worker = undefined;\n    if (!worker) return;\n\n    worker.onmessage = null;\n    worker.onerror = null;\n    worker.onmessageerror = null;\n    worker.terminate();\n  }\n\n  #failWorker(worker: Worker, error: FamiliarRuntimeError): void {\n    if (this.#worker !== worker) return;\n\n    this.#stopWorker();\n    this.#settlePending('reject', error);\n\n    try {\n      this.#onSlotError?.(error);\n    } catch {\n      warn('onSlotError callback failed; Familiar continued replacing the failed worker slot.');\n    }\n  }\n\n  #onMessage(message: unknown): void {\n    if (!this.#pending) return;\n\n    if (\n      !isWorkerResponse<TOutput>(message) ||\n      message.id !== this.#pending.id ||\n      (this.#pending.kind === 'run' && message.kind === 'chunk')\n    ) {\n      this.cancel(new FamiliarRuntimeError('Worker returned an incompatible protocol response'));\n\n      return;\n    }\n\n    if (message.kind === 'chunk') {\n      this.#pending.emit?.(message.value);\n\n      return;\n    }\n\n    if (message.kind === 'error') {\n      this.#settlePending('reject', responseError(message.error));\n\n      return;\n    }\n\n    this.#settlePending('resolve', message.value);\n  }\n\n  #settlePending(kind: 'resolve' | 'reject', value: unknown): void {\n    const pending = this.#pending;\n\n    if (!pending) return;\n\n    this.#pending = undefined;\n\n    if (pending.timer) clearTimeout(pending.timer);\n\n    if (kind === 'resolve') pending.resolve(value as TOutput);\n    else pending.reject(value);\n  }\n}\n\nfunction slots<TInput, TOutput>(url: URL | string, options: ResolvedOptions): Slot<TInput, TOutput>[] {\n  const resolvedUrl = typeof url === 'string' ? url : url.href;\n  return Array.from({ length: options.concurrency }, () => new Slot<TInput, TOutput>(resolvedUrl, options.onSlotError));\n}\n\n/** Create a pool backed by an ES module worker registered with exposeTask(). */\nexport function createWorker<TInput, TOutput>(\n  url: URL | string,\n  options: WorkerOptions = {},\n): WorkerPool<TInput, TOutput> {\n  const resolved = resolveOptions(options);\n\n  return createPool(slots<TInput, TOutput>(url, resolved), {\n    concurrency: resolved.concurrency,\n    defaultTimeout: resolved.timeout,\n    maxQueue: resolved.maxQueue,\n    onFull: resolved.onFull,\n  });\n}\n\n/** Create a stream-only pool backed by an ES module worker registered with exposeStream(). */\nexport function createStreamWorker<TInput, TChunk>(\n  url: URL | string,\n  options: WorkerOptions = {},\n): StreamWorkerPool<TInput, TChunk> {\n  const resolved = resolveOptions(options);\n\n  return createStreamPool(slots<TInput, TChunk>(url, resolved), {\n    concurrency: resolved.concurrency,\n    defaultTimeout: resolved.timeout,\n    maxQueue: resolved.maxQueue,\n    onFull: resolved.onFull,\n  });\n}\n"],"mappings":";;;;;;;;AA4DA,SAAS,EAAe,IAAyB,CAAC,GAAoB;CACpE,IAAM,EAAE,iBAAc,GAAG,aAAU,YAAS,UAAU,gBAAa,eAAY,GACzE,IACJ,MAAgB,SACZ,KAAK,IAAA,KAAqB,KAAK,IAAI,GAAG,WAAW,WAAW,uBAAuB,CAAC,CAAC,IACrF;CAEN,IAAI,CAAC,OAAO,UAAU,CAAmB,KAAK,IAAsB,KAAK,IAAA,KACvE,MAAM,IAAI,EAA4B,4DAA2E;CAGnH,IAAI,MAAa,KAAA,MAAc,CAAC,OAAO,UAAU,CAAQ,KAAK,IAAW,IACvE,MAAM,IAAI,EAA4B,uCAAuC;CAG/E,IAAI,MAAW,YAAY,MAAW,QACpC,MAAM,IAAI,EAA4B,yCAAqC;CAK7E,OAFA,EAAgB,CAAO,GAEhB;EAAE,aAAa;EAAqB;EAAU;EAAQ;EAAa;CAAQ;AACpF;AAEA,SAAS,EAA0B,GAAkD;CACnF,IAAI,OAAO,KAAU,aAAY,GAAgB,OAAO;CAExD,IAAM,IAAW;CAYjB,OAVE,EAAS,YAAA,KACT,OAAO,EAAS,MAAO,YACvB,CAAC,OAAO,cAAc,EAAS,EAAE,KACjC,EAAS,KAAK,IAEP,KAEL,EAAS,SAAS,WAAW,EAAS,SAAS,WAAiB,WAAW,IAC3E,EAAS,SAAS,WAAW,OAAO,EAAS,SAAU,YAAY,EAAS,UAAU,OAAa,MAGpG,EAAS,MAAM,aAAa,KAAA,KAAa,EAAS,MAAM,aAAa,eACtE,OAAO,EAAS,MAAM,WAAY,YAClC,OAAO,EAAS,MAAM,QAAS,aAC9B,EAAS,MAAM,UAAU,KAAA,KAAa,OAAO,EAAS,MAAM,SAAU;AAE3E;AAEA,SAAS,EAAc,GAAkE;CACvF,IAAM,IAAY,MAAM,EAAM,OAAO;CAKrC,OAHA,EAAM,OAAO,EAAM,MACnB,EAAM,QAAQ,EAAM,OAEb,EAAM,aAAa,aACtB,IAAI,EAAqB,EAAM,SAAS,EAAE,SAAM,CAAC,IACjD,IAAI,EAAkB,EAAM,SAAS,EAAE,SAAM,CAAC;AACpD;AAEA,IAAM,IAAN,MAAkG;CAChG;CACA;CACA,KAAY;CACZ;CACA,KAAU;CACV;CAEA,YAAY,GAAmB,GAA2C;EAExE,AADA,KAAK,KAAO,GACZ,KAAK,KAAe;CACtB;CAEA,OAAO,GAAuB;EACvB,KAAK,OACV,KAAK,GAAY,GACjB,KAAK,GAAe,UAAU,CAAM;CACtC;CAEA,IAAI,GAAe,GAA+B,GAA+C;EAC/F,OAAO,KAAK,GAAU,GAAO,GAAe,GAAS,KAAK;CAC5D;CAEA,OAAO,GAAe,GAA6C;EACjE,IAAM,UAAa,KAAK,OAAO,IAAI,EAAwB,yBAAyB,CAAC,GAC/E,IAAoB,CAAC,GACrB,IAA4D,CAAC,GAC/D,IAAO,IACP,GACE,KAAQ,MAAmB;GAC/B,IAAM,IAAS,EAAQ,MAAM;GAE7B,AAAI,IAAQ,EAAO;IAAE,MAAM;IAAO;GAAM,CAAC,IACpC,EAAO,KAAK,CAAK;EACxB,GACM,KAAU,MAAqB;GAInC,KAHA,IAAO,IACP,IAAQ,GAED,EAAQ,SAAS,IAGtB,AAFe,EAAQ,MAGlB,CAAA,CADD,MAAW,KAAA,IACH;IAAE,MAAM;IAAM,OAAO,KAAA;GAAmB,IADnB,QAAQ,OAAO,CAAM,CACD;EAEzD;EAMA,OAAO;GACL,MANkB,KAAK,GAAU,GAAO,CAAC,GAAI,EAAQ,iBAAiB,CAAC,CAAE,GAAG,EAAQ,SAAS,UAAU,CAAI,CAAC,CAAC,WACvG,EAAO,IACZ,MAAoB,EAAO,CAAM,CAI5B;GACN,UAAU,GACP,OAAO,uBAAuB;IAC7B,MAAM,OAAyC;KAC7C,IAAI,EAAO,SAAS,GAAG,OAAO;MAAE,MAAM;MAAO,OAAO,EAAO,MAAM;KAAG;KAEpE,IAAI,MAAU,KAAA,GAAW,MAAM;KAI/B,OAFI,IAAa;MAAE,MAAM;MAAM,OAAO,KAAA;KAAmB,IAElD,IAAI,SAAkC,GAAS,MAAW;MAC/D,EAAQ,MAAM,MAAW;OACvB,AAAI,aAAkB,UAAS,EAAY,KAAK,GAAS,CAAM,IAC1D,EAAQ,CAAM;MACrB,CAAC;KACH,CAAC;IACH;IACA,MAAM,SAA2C;KAG/C,OAFA,EAAK,GAEE;MAAE,MAAM;MAAM,OAAO,KAAA;KAAmB;IACjD;GACF,GACF;EACF;CACF;CAEA,YAAkB;EAGhB,AAFA,KAAK,KAAY,IACjB,KAAK,GAAY,GACjB,KAAK,GAAe,UAAU,IAAI,EAAwB,CAAC;CAC7D;CAEA,GACE,GACA,GACA,GACA,GACA,GACkB;EAClB,IAAI,KAAK,IAAW,OAAO,QAAQ,OAAO,IAAI,EAAwB,CAAC;EAEvE,IAAI,KAAK,IAAU,OAAO,QAAQ,OAAO,IAAI,EAAqB,6BAA6B,CAAC;EAEhG,IAAI;GACF,IAAM,IAAS,KAAK,GAAc,GAC5B,IAAK,KAAK;GAGhB,OAFA,KAAK,KAAU,oBAAiC,IAAI,IAAK,GAElD,IAAI,SAAkB,GAAS,MAAW;IAC/C,IAAM,IAA4B;KAAE;KAAM;KAAI;KAAM;KAAQ;IAAQ;IAIpE,AAFA,KAAK,KAAW,GAEZ,MAAY,KAAA,MACd,EAAQ,QAAQ,iBAAiB,KAAK,OAAO,IAAI,EAAqB,CAAO,CAAC,GAAG,CAAO,GACxF,EAAW,EAAQ,KAAK;IAG1B,IAAI;KACF,EAAO,YAAY;MAAE;MAAI;MAAO;MAAM,SAAA;KAA0B,GAAG,CAAa;IAClF,SAAS,GAAO;KACd,KAAK,OAAO,IAAI,EAAqB,oCAAoC,EAAE,OAAO,EAAM,CAAC,CAAC;IAC5F;GACF,CAAC;EACH,SAAS,GAAO;GACd,OAAO,QAAQ,OAAO,CAAK;EAC7B;CACF;CAEA,KAAwB;EACtB,IAAI,KAAK,IAAS,OAAO,KAAK;EAE9B,IAAI,OAAO,SAAW,KAAa,MAAM,IAAI,EAAqB,2CAA2C;EAE7G,IAAI;GACF,IAAM,IAAS,IAAI,OAAO,KAAK,IAAM,EAAE,MAAM,SAAS,CAAC;GAUvD,OARA,EAAO,aAAa,MAAiC;IACnD,AAAI,KAAK,OAAY,KAAQ,KAAK,GAAW,EAAM,IAAI;GACzD,GACA,EAAO,WAAW,MAAU,KAAK,GAAY,GAAQ,IAAI,EAAqB,EAAM,WAAW,eAAe,CAAC,GAC/G,EAAO,uBACL,KAAK,GAAY,GAAQ,IAAI,EAAqB,2CAA2C,CAAC,GAChG,KAAK,KAAU,GAER;EACT,SAAS,GAAO;GACd,MAAM,IAAI,EAAqB,2BAA2B,EAAE,OAAO,EAAM,CAAC;EAC5E;CACF;CAEA,KAAoB;EAClB,IAAM,IAAS,KAAK;EACpB,KAAK,KAAU,KAAA,GACV,MAEL,EAAO,YAAY,MACnB,EAAO,UAAU,MACjB,EAAO,iBAAiB,MACxB,EAAO,UAAU;CACnB;CAEA,GAAY,GAAgB,GAAmC;EACzD,SAAK,OAAY,GAGrB;GADA,KAAK,GAAY,GACjB,KAAK,GAAe,UAAU,CAAK;GAEnC,IAAI;IACF,KAAK,KAAe,CAAK;GAC3B,QAAQ,CAER;EANmC;CAOrC;CAEA,GAAW,GAAwB;EAC5B,SAAK,IAEV;OACE,CAAC,EAA0B,CAAO,KAClC,EAAQ,OAAO,KAAK,GAAS,MAC5B,KAAK,GAAS,SAAS,SAAS,EAAQ,SAAS,SAClD;IACA,KAAK,OAAO,IAAI,EAAqB,mDAAmD,CAAC;IAEzF;GACF;GAEA,IAAI,EAAQ,SAAS,SAAS;IAC5B,KAAK,GAAS,OAAO,EAAQ,KAAK;IAElC;GACF;GAEA,IAAI,EAAQ,SAAS,SAAS;IAC5B,KAAK,GAAe,UAAU,EAAc,EAAQ,KAAK,CAAC;IAE1D;GACF;GAEA,KAAK,GAAe,WAAW,EAAQ,KAAK;EAd5C;CAeF;CAEA,GAAe,GAA4B,GAAsB;EAC/D,IAAM,IAAU,KAAK;EAEhB,MAEL,KAAK,KAAW,KAAA,GAEZ,EAAQ,SAAO,aAAa,EAAQ,KAAK,GAEzC,MAAS,YAAW,EAAQ,QAAQ,CAAgB,IACnD,EAAQ,OAAO,CAAK;CAC3B;AACF;AAEA,SAAS,EAAuB,GAAmB,GAAmD;CACpG,IAAM,IAAc,OAAO,KAAQ,WAAW,IAAM,EAAI;CACxD,OAAO,MAAM,KAAK,EAAE,QAAQ,EAAQ,YAAY,SAAS,IAAI,EAAsB,GAAa,EAAQ,WAAW,CAAC;AACtH;AAGA,SAAgB,EACd,GACA,IAAyB,CAAC,GACG;CAC7B,IAAM,IAAW,EAAe,CAAO;CAEvC,OAAO,EAAW,EAAuB,GAAK,CAAQ,GAAG;EACvD,aAAa,EAAS;EACtB,gBAAgB,EAAS;EACzB,UAAU,EAAS;EACnB,QAAQ,EAAS;CACnB,CAAC;AACH;AAGA,SAAgB,EACd,GACA,IAAyB,CAAC,GACQ;CAClC,IAAM,IAAW,EAAe,CAAO;CAEvC,OAAO,EAAiB,EAAsB,GAAK,CAAQ,GAAG;EAC5D,aAAa,EAAS;EACtB,gBAAgB,EAAS;EACzB,UAAU,EAAS;EACnB,QAAQ,EAAS;CACnB,CAAC;AACH"}
+{"version":3,"file":"worker.js","names":[],"sources":["../src/worker.ts"],"sourcesContent":["import { createPool } from './_pool.js';\nimport { MAX_CONCURRENCY, validateTimeout } from './_pool-core.js';\nimport { createStreamPool, type StreamSlot } from './_stream-pool.js';\nimport { unrefTimer } from './_timers.js';\nimport {\n  FamiliarInvalidOptionsError,\n  FamiliarRuntimeError,\n  FamiliarTaskError,\n  FamiliarTerminatedError,\n  FamiliarTimeoutError,\n} from './errors.js';\nimport type { SerializedError, WorkerResponse } from './protocol.js';\nimport { PROTOCOL_VERSION } from './protocol.js';\nimport type { RunOptions, SlotStrategy, StreamWorkerPool, WorkerOptions, WorkerPool } from './types.js';\n\ntype ResolvedOptions = {\n  concurrency: number;\n  maxQueue: number | undefined;\n  onFull: 'reject' | 'wait';\n  timeout: number | undefined;\n};\n\ntype Pending<TOutput> = {\n  emit?: (value: TOutput) => void;\n  id: number;\n  kind: 'run' | 'stream';\n  reject: (reason: unknown) => void;\n  resolve: (value: TOutput) => void;\n  timer?: ReturnType<typeof setTimeout>;\n};\n\ntype RunningStream<TChunk> = {\n  done: Promise<void>;\n  iterable: AsyncIterable<TChunk>;\n};\n\nfunction resolveOptions(options: WorkerOptions = {}): ResolvedOptions {\n  const { concurrency = 1, maxQueue, onFull = 'reject', timeout } = options;\n  const resolvedConcurrency =\n    concurrency === 'auto'\n      ? Math.min(MAX_CONCURRENCY, Math.max(1, globalThis.navigator?.hardwareConcurrency ?? 1))\n      : concurrency;\n\n  if (!Number.isInteger(resolvedConcurrency) || resolvedConcurrency < 1 || resolvedConcurrency > MAX_CONCURRENCY) {\n    throw new FamiliarInvalidOptionsError(`\\`concurrency\\` must be a positive integer ≤ ${MAX_CONCURRENCY} or \"auto\"`);\n  }\n\n  if (maxQueue !== undefined && (!Number.isInteger(maxQueue) || maxQueue < 1)) {\n    throw new FamiliarInvalidOptionsError('`maxQueue` must be a positive integer');\n  }\n\n  if (onFull !== 'reject' && onFull !== 'wait') {\n    throw new FamiliarInvalidOptionsError('`onFull` must be \"reject\" or \"wait\"');\n  }\n\n  validateTimeout(timeout);\n\n  return { concurrency: resolvedConcurrency, maxQueue, onFull, timeout };\n}\n\nfunction isWorkerResponse<TOutput>(value: unknown): value is WorkerResponse<TOutput> {\n  if (typeof value !== 'object' || value === null) return false;\n\n  const response = value as Partial<WorkerResponse<TOutput>>;\n  if (\n    response.version !== PROTOCOL_VERSION ||\n    typeof response.id !== 'number' ||\n    !Number.isSafeInteger(response.id) ||\n    response.id < 0\n  )\n    return false;\n\n  if (response.kind === 'chunk' || response.kind === 'result') return 'value' in response;\n  if (response.kind !== 'error' || typeof response.error !== 'object' || response.error === null) return false;\n\n  return (\n    (response.error.category === undefined || response.error.category === 'protocol') &&\n    typeof response.error.message === 'string' &&\n    typeof response.error.name === 'string' &&\n    (response.error.stack === undefined || typeof response.error.stack === 'string')\n  );\n}\n\nfunction responseError(error: SerializedError): FamiliarRuntimeError | FamiliarTaskError {\n  const cause = new Error(error.message);\n\n  cause.name = error.name;\n  cause.stack = error.stack;\n\n  return error.category === 'protocol'\n    ? new FamiliarRuntimeError(error.message, { cause })\n    : new FamiliarTaskError(error.message, { cause });\n}\n\nclass Slot<TInput, TOutput> implements SlotStrategy<TInput, TOutput>, StreamSlot<TInput, TOutput> {\n  readonly #url: URL | string;\n  #disposed = false;\n  #pending: Pending<TOutput> | undefined;\n  #taskId = 0;\n  #worker: Worker | undefined;\n\n  /** Wired by the pool factory to report unhandled worker runtime errors through `tap()`. */\n  notify: ((error: FamiliarRuntimeError) => void) | undefined = undefined;\n\n  constructor(url: URL | string) {\n    this.#url = url;\n  }\n\n  cancel(reason: unknown): void {\n    if (!this.#pending) return;\n    this.#stopWorker();\n    this.#settlePending('reject', reason);\n  }\n\n  run(input: TInput, transferables: Transferable[], timeout: number | undefined): Promise<TOutput> {\n    return this.#dispatch(input, transferables, timeout, 'run') as Promise<TOutput>;\n  }\n\n  stream(input: TInput, options: RunOptions): RunningStream<TOutput> {\n    const stop = () => this.cancel(new FamiliarTerminatedError('Stream consumer stopped'));\n    const chunks: TOutput[] = [];\n    const waiters: Array<(result: IteratorResult<TOutput>) => void> = [];\n    let done = false;\n    let error: unknown;\n    const emit = (value: TOutput) => {\n      const waiter = waiters.shift();\n\n      if (waiter) waiter({ done: false, value });\n      else chunks.push(value);\n    };\n    const finish = (reason?: unknown) => {\n      done = true;\n      error = reason;\n\n      while (waiters.length > 0) {\n        const waiter = waiters.shift()!;\n\n        if (reason !== undefined) waiter(Promise.reject(reason) as never);\n        else waiter({ done: true, value: undefined as never });\n      }\n    };\n    const donePromise = this.#dispatch(input, [...(options.transferables ?? [])], options.timeout, 'stream', emit).then(\n      () => finish(),\n      (reason: unknown) => finish(reason),\n    );\n\n    return {\n      done: donePromise,\n      iterable: {\n        [Symbol.asyncIterator]: () => ({\n          async next(): Promise<IteratorResult<TOutput>> {\n            if (chunks.length > 0) return { done: false, value: chunks.shift()! };\n\n            if (error !== undefined) throw error;\n\n            if (done) return { done: true, value: undefined as never };\n\n            return new Promise<IteratorResult<TOutput>>((resolve, reject) => {\n              waiters.push((result) => {\n                if (result instanceof Promise) void result.then(resolve, reject);\n                else resolve(result);\n              });\n            });\n          },\n          async return(): Promise<IteratorResult<TOutput>> {\n            stop();\n\n            return { done: true, value: undefined as never };\n          },\n        }),\n      },\n    };\n  }\n\n  terminate(): void {\n    this.#disposed = true;\n    this.#stopWorker();\n    this.#settlePending('reject', new FamiliarTerminatedError());\n  }\n\n  #dispatch(\n    input: TInput,\n    transferables: Transferable[],\n    timeout: number | undefined,\n    kind: 'run' | 'stream',\n    emit?: (value: TOutput) => void,\n  ): Promise<TOutput> {\n    if (this.#disposed) return Promise.reject(new FamiliarTerminatedError());\n\n    if (this.#pending) return Promise.reject(new FamiliarRuntimeError('Worker slot is already busy'));\n\n    try {\n      const worker = this.#ensureWorker();\n      const id = this.#taskId;\n      this.#taskId = id === Number.MAX_SAFE_INTEGER ? 0 : id + 1;\n\n      return new Promise<TOutput>((resolve, reject) => {\n        const pending: Pending<TOutput> = { emit, id, kind, reject, resolve };\n\n        this.#pending = pending;\n\n        if (timeout !== undefined) {\n          pending.timer = setTimeout(() => this.cancel(new FamiliarTimeoutError(timeout)), timeout);\n          unrefTimer(pending.timer);\n        }\n\n        try {\n          worker.postMessage({ id, input, kind, version: PROTOCOL_VERSION }, transferables);\n        } catch (error) {\n          this.cancel(new FamiliarRuntimeError('Failed to post message to worker', { cause: error }));\n        }\n      });\n    } catch (error) {\n      return Promise.reject(error);\n    }\n  }\n\n  #ensureWorker(): Worker {\n    if (this.#worker) return this.#worker;\n\n    if (typeof Worker === 'undefined') throw new FamiliarRuntimeError('Worker API is unavailable in this runtime');\n\n    try {\n      const worker = new Worker(this.#url, { type: 'module' });\n\n      worker.onmessage = (event: MessageEvent<unknown>) => {\n        if (this.#worker === worker) this.#onMessage(event.data);\n      };\n      worker.onerror = (event) => this.#failWorker(worker, new FamiliarRuntimeError(event.message || 'Worker failed'));\n      worker.onmessageerror = () =>\n        this.#failWorker(worker, new FamiliarRuntimeError('Worker response could not be deserialized'));\n      this.#worker = worker;\n\n      return worker;\n    } catch (error) {\n      throw new FamiliarRuntimeError('Failed to create Worker', { cause: error });\n    }\n  }\n\n  #stopWorker(): void {\n    const worker = this.#worker;\n    this.#worker = undefined;\n    if (!worker) return;\n\n    worker.onmessage = null;\n    worker.onerror = null;\n    worker.onmessageerror = null;\n    worker.terminate();\n  }\n\n  #failWorker(worker: Worker, error: FamiliarRuntimeError): void {\n    if (this.#worker !== worker) return;\n\n    this.#stopWorker();\n    this.#settlePending('reject', error);\n    this.notify?.(error);\n  }\n\n  #onMessage(message: unknown): void {\n    if (!this.#pending) return;\n\n    if (\n      !isWorkerResponse<TOutput>(message) ||\n      message.id !== this.#pending.id ||\n      (this.#pending.kind === 'run' && message.kind === 'chunk')\n    ) {\n      this.cancel(new FamiliarRuntimeError('Worker returned an incompatible protocol response'));\n\n      return;\n    }\n\n    if (message.kind === 'chunk') {\n      this.#pending.emit?.(message.value);\n\n      return;\n    }\n\n    if (message.kind === 'error') {\n      this.#settlePending('reject', responseError(message.error));\n\n      return;\n    }\n\n    this.#settlePending('resolve', message.value);\n  }\n\n  #settlePending(kind: 'resolve' | 'reject', value: unknown): void {\n    const pending = this.#pending;\n\n    if (!pending) return;\n\n    this.#pending = undefined;\n\n    if (pending.timer) clearTimeout(pending.timer);\n\n    if (kind === 'resolve') pending.resolve(value as TOutput);\n    else pending.reject(value);\n  }\n}\n\nfunction slots<TInput, TOutput>(url: URL | string, options: ResolvedOptions): Slot<TInput, TOutput>[] {\n  const resolvedUrl = typeof url === 'string' ? url : url.href;\n  return Array.from({ length: options.concurrency }, () => new Slot<TInput, TOutput>(resolvedUrl));\n}\n\n/** Create a pool backed by an ES module worker registered with exposeTask(). */\nexport function createWorker<TInput, TOutput>(\n  url: URL | string,\n  options: WorkerOptions = {},\n): WorkerPool<TInput, TOutput> {\n  const resolved = resolveOptions(options);\n\n  return createPool(slots<TInput, TOutput>(url, resolved), {\n    defaultTimeout: resolved.timeout,\n    maxQueue: resolved.maxQueue,\n    onFull: resolved.onFull,\n  });\n}\n\n/** Create a stream-only pool backed by an ES module worker registered with exposeStream(). */\nexport function createStreamWorker<TInput, TChunk>(\n  url: URL | string,\n  options: WorkerOptions = {},\n): StreamWorkerPool<TInput, TChunk> {\n  const resolved = resolveOptions(options);\n\n  return createStreamPool(slots<TInput, TChunk>(url, resolved), {\n    defaultTimeout: resolved.timeout,\n    maxQueue: resolved.maxQueue,\n    onFull: resolved.onFull,\n  });\n}\n"],"mappings":"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"}