@vielzeug/familiar 2.2.0 → 26.10.0

package/dist/protocol.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"protocol.cjs","names":[],"sources":["../src/protocol.ts"],"sourcesContent":["/** Current host-to-worker protocol version. */\nexport const PROTOCOL_VERSION = 1 as const;\n\nexport type SerializedError = {\n  message: string;\n  name: string;\n  stack?: string;\n};\n\nexport type WorkerRequest<TInput> =\n  | { id: number; input: TInput; kind: 'run'; version: typeof PROTOCOL_VERSION }\n  | { id: number; input: TInput; kind: 'stream'; version: typeof PROTOCOL_VERSION };\n\nexport type WorkerResponse<TOutput> =\n  | { id: number; kind: 'chunk'; value: TOutput; version: typeof PROTOCOL_VERSION }\n  | { error: SerializedError; id: number; kind: 'error'; version: typeof PROTOCOL_VERSION }\n  | { id: number; kind: 'result'; value: TOutput; version: typeof PROTOCOL_VERSION };\n\nexport type TaskHandler<TInput, TOutput> = (input: TInput) => TOutput | Promise<TOutput>;\n\nexport type StreamHandler<TInput, TChunk> = (input: TInput) => AsyncIterable<TChunk> | Promise<AsyncIterable<TChunk>>;\n\nfunction serializeError(error: unknown): SerializedError {\n  const value = error instanceof Error ? error : new Error(String(error));\n\n  return { message: value.message, name: value.name, stack: value.stack };\n}\n\nfunction isRequest(value: unknown): value is WorkerRequest<unknown> {\n  if (typeof value !== 'object' || value === null) return false;\n\n  const request = value as Partial<WorkerRequest<unknown>>;\n\n  return typeof request.id === 'number' && (request.kind === 'run' || request.kind === 'stream') && 'input' in request;\n}\n\nfunction post<TOutput>(message: WorkerResponse<TOutput>): void {\n  (self as unknown as { postMessage(data: WorkerResponse<TOutput>): void }).postMessage(message);\n}\n\nfunction postError(id: number, error: unknown): void {\n  post({ error: serializeError(error), id, kind: 'error', version: PROTOCOL_VERSION });\n}\n\n/** Register a module worker that handles one request and returns one result. */\nexport function exposeTask<TInput, TOutput>(handler: TaskHandler<TInput, TOutput>): void {\n  (self as unknown as { onmessage: (event: MessageEvent<unknown>) => void }).onmessage = async (event) => {\n    if (!isRequest(event.data) || event.data.version !== PROTOCOL_VERSION || event.data.kind !== 'run') return;\n\n    const { id, input } = event.data;\n\n    try {\n      const value = await handler(input as TInput);\n\n      post({ id, kind: 'result', value, version: PROTOCOL_VERSION });\n    } catch (error) {\n      postError(id, error);\n    }\n  };\n}\n\n/** Register a module worker that yields chunks for each request. */\nexport function exposeStream<TInput, TChunk>(handler: StreamHandler<TInput, TChunk>): void {\n  (self as unknown as { onmessage: (event: MessageEvent<unknown>) => void }).onmessage = async (event) => {\n    if (!isRequest(event.data) || event.data.version !== PROTOCOL_VERSION || event.data.kind !== 'stream') return;\n\n    const { id, input } = event.data;\n\n    try {\n      for await (const value of await handler(input as TInput)) {\n        post({ id, kind: 'chunk', value, version: PROTOCOL_VERSION });\n      }\n\n      post({ id, kind: 'result', value: undefined as never, version: PROTOCOL_VERSION });\n    } catch (error) {\n      postError(id, error);\n    }\n  };\n}\n"],"mappings":"mEACA,IAAa,EAAmB,EAqBhC,SAAS,EAAe,EAAiC,CACvD,IAAM,EAAQ,aAAiB,MAAQ,EAAY,MAAM,OAAO,CAAK,CAAC,EAEtE,MAAO,CAAE,QAAS,EAAM,QAAS,KAAM,EAAM,KAAM,MAAO,EAAM,KAAM,CACxE,CAEA,SAAS,EAAU,EAAiD,CAClE,GAAI,OAAO,GAAU,WAAY,EAAgB,MAAO,GAExD,IAAM,EAAU,EAEhB,OAAO,OAAO,EAAQ,IAAO,WAAa,EAAQ,OAAS,OAAS,EAAQ,OAAS,WAAa,UAAW,CAC/G,CAEA,SAAS,EAAc,EAAwC,CAC7D,KAA0E,YAAY,CAAO,CAC/F,CAEA,SAAS,EAAU,EAAY,EAAsB,CACnD,EAAK,CAAE,MAAO,EAAe,CAAK,EAAG,KAAI,KAAM,QAAS,QAAA,CAA0B,CAAC,CACrF,CAGA,SAAgB,EAA4B,EAA6C,CACvF,KAA2E,UAAY,KAAO,IAAU,CACtG,GAAI,CAAC,EAAU,EAAM,IAAI,GAAK,EAAM,KAAK,UAAA,GAAgC,EAAM,KAAK,OAAS,MAAO,OAEpG,GAAM,CAAE,KAAI,SAAU,EAAM,KAE5B,GAAI,CAGF,EAAK,CAAE,KAAI,KAAM,SAAU,MAAA,MAFP,EAAQ,CAAe,EAET,QAAA,CAA0B,CAAC,CAC/D,OAAS,EAAO,CACd,EAAU,EAAI,CAAK,CACrB,CACF,CACF,CAGA,SAAgB,EAA6B,EAA8C,CACzF,KAA2E,UAAY,KAAO,IAAU,CACtG,GAAI,CAAC,EAAU,EAAM,IAAI,GAAK,EAAM,KAAK,UAAA,GAAgC,EAAM,KAAK,OAAS,SAAU,OAEvG,GAAM,CAAE,KAAI,SAAU,EAAM,KAE5B,GAAI,CACF,UAAW,IAAM,KAAS,MAAM,EAAQ,CAAe,EACrD,EAAK,CAAE,KAAI,KAAM,QAAS,QAAO,QAAA,CAA0B,CAAC,EAG9D,EAAK,CAAE,KAAI,KAAM,SAAU,MAAO,IAAA,GAAoB,QAAA,CAA0B,CAAC,CACnF,OAAS,EAAO,CACd,EAAU,EAAI,CAAK,CACrB,CACF,CACF"}
+{"version":3,"file":"protocol.cjs","names":[],"sources":["../src/protocol.ts"],"sourcesContent":["/** Current host-to-worker protocol version. */\nexport const PROTOCOL_VERSION = 1 as const;\n\nexport type SerializedError = {\n  category?: 'protocol';\n  message: string;\n  name: string;\n  stack?: string;\n};\n\nexport type WorkerRequest<TInput> =\n  | { id: number; input: TInput; kind: 'run'; version: typeof PROTOCOL_VERSION }\n  | { id: number; input: TInput; kind: 'stream'; version: typeof PROTOCOL_VERSION };\n\nexport type WorkerResponse<TOutput> =\n  | { id: number; kind: 'chunk'; value: TOutput; version: typeof PROTOCOL_VERSION }\n  | { error: SerializedError; id: number; kind: 'error'; version: typeof PROTOCOL_VERSION }\n  | { id: number; kind: 'result'; value: TOutput; version: typeof PROTOCOL_VERSION };\n\nexport type TaskHandler<TInput, TOutput> = (input: TInput) => TOutput | Promise<TOutput>;\n\nexport type StreamHandler<TInput, TChunk> = (input: TInput) => AsyncIterable<TChunk> | Promise<AsyncIterable<TChunk>>;\n\nfunction serializeError(error: unknown): SerializedError {\n  const value = error instanceof Error ? error : new Error(String(error));\n\n  return { message: value.message, name: value.name, stack: value.stack };\n}\n\nfunction isRequest(value: unknown): value is WorkerRequest<unknown> {\n  if (typeof value !== 'object' || value === null) return false;\n\n  const request = value as Partial<WorkerRequest<unknown>>;\n\n  return (\n    request.version === PROTOCOL_VERSION &&\n    typeof request.id === 'number' &&\n    Number.isSafeInteger(request.id) &&\n    request.id >= 0 &&\n    (request.kind === 'run' || request.kind === 'stream') &&\n    'input' in request\n  );\n}\n\nfunction post<TOutput>(message: WorkerResponse<TOutput>): void {\n  (self as unknown as { postMessage(data: WorkerResponse<TOutput>): void }).postMessage(message);\n}\n\nfunction postError(id: number, error: unknown, category?: SerializedError['category']): void {\n  post({\n    error: { ...serializeError(error), ...(category && { category }) },\n    id,\n    kind: 'error',\n    version: PROTOCOL_VERSION,\n  });\n}\n\n/** Register a module worker that handles one request and returns one result. */\nexport function exposeTask<TInput, TOutput>(handler: TaskHandler<TInput, TOutput>): void {\n  (self as unknown as { onmessage: (event: MessageEvent<unknown>) => void }).onmessage = async (event) => {\n    if (!isRequest(event.data)) return;\n    if (event.data.kind !== 'run') {\n      postError(event.data.id, new Error('Worker is registered for tasks, not streams'), 'protocol');\n      return;\n    }\n\n    const { id, input } = event.data;\n\n    try {\n      const value = await handler(input as TInput);\n\n      post({ id, kind: 'result', value, version: PROTOCOL_VERSION });\n    } catch (error) {\n      postError(id, error);\n    }\n  };\n}\n\n/** Register a module worker that yields chunks for each request. */\nexport function exposeStream<TInput, TChunk>(handler: StreamHandler<TInput, TChunk>): void {\n  (self as unknown as { onmessage: (event: MessageEvent<unknown>) => void }).onmessage = async (event) => {\n    if (!isRequest(event.data)) return;\n    if (event.data.kind !== 'stream') {\n      postError(event.data.id, new Error('Worker is registered for streams, not tasks'), 'protocol');\n      return;\n    }\n\n    const { id, input } = event.data;\n\n    try {\n      for await (const value of await handler(input as TInput)) {\n        post({ id, kind: 'chunk', value, version: PROTOCOL_VERSION });\n      }\n\n      post({ id, kind: 'result', value: undefined as never, version: PROTOCOL_VERSION });\n    } catch (error) {\n      postError(id, error);\n    }\n  };\n}\n"],"mappings":"mEACA,IAAa,EAAmB,EAsBhC,SAAS,eAAe,EAAiC,CACvD,IAAM,EAAQ,aAAiB,MAAQ,EAAY,MAAM,OAAO,CAAK,CAAC,EAEtE,MAAO,CAAE,QAAS,EAAM,QAAS,KAAM,EAAM,KAAM,MAAO,EAAM,KAAM,CACxE,CAEA,SAAS,UAAU,EAAiD,CAClE,GAAI,OAAO,GAAU,WAAY,EAAgB,MAAO,GAExD,IAAM,EAAU,EAEhB,OACE,EAAQ,UAAA,GACR,OAAO,EAAQ,IAAO,UACtB,OAAO,cAAc,EAAQ,EAAE,GAC/B,EAAQ,IAAM,IACb,EAAQ,OAAS,OAAS,EAAQ,OAAS,WAC5C,UAAW,CAEf,CAEA,SAAS,KAAc,EAAwC,CAC7D,KAA0E,YAAY,CAAO,CAC/F,CAEA,SAAS,UAAU,EAAY,EAAgB,EAA8C,CAC3F,KAAK,CACH,MAAO,CAAE,GAAG,eAAe,CAAK,EAAG,GAAI,GAAY,CAAE,UAAS,CAAG,EACjE,KACA,KAAM,QACN,QAAA,CACF,CAAC,CACH,CAGA,SAAgB,WAA4B,EAA6C,CACvF,KAA2E,UAAY,KAAO,IAAU,CACtG,GAAI,CAAC,UAAU,EAAM,IAAI,EAAG,OAC5B,GAAI,EAAM,KAAK,OAAS,MAAO,CAC7B,UAAU,EAAM,KAAK,GAAQ,MAAM,6CAA6C,EAAG,UAAU,EAC7F,MACF,CAEA,GAAM,CAAE,KAAI,SAAU,EAAM,KAE5B,GAAI,CAGF,KAAK,CAAE,KAAI,KAAM,SAAU,MAAA,MAFP,EAAQ,CAAe,EAET,QAAA,CAA0B,CAAC,CAC/D,OAAS,EAAO,CACd,UAAU,EAAI,CAAK,CACrB,CACF,CACF,CAGA,SAAgB,aAA6B,EAA8C,CACzF,KAA2E,UAAY,KAAO,IAAU,CACtG,GAAI,CAAC,UAAU,EAAM,IAAI,EAAG,OAC5B,GAAI,EAAM,KAAK,OAAS,SAAU,CAChC,UAAU,EAAM,KAAK,GAAQ,MAAM,6CAA6C,EAAG,UAAU,EAC7F,MACF,CAEA,GAAM,CAAE,KAAI,SAAU,EAAM,KAE5B,GAAI,CACF,UAAW,IAAM,KAAS,MAAM,EAAQ,CAAe,EACrD,KAAK,CAAE,KAAI,KAAM,QAAS,QAAO,QAAA,CAA0B,CAAC,EAG9D,KAAK,CAAE,KAAI,KAAM,SAAU,MAAO,IAAA,GAAoB,QAAA,CAA0B,CAAC,CACnF,OAAS,EAAO,CACd,UAAU,EAAI,CAAK,CACrB,CACF,CACF"}

package/dist/protocol.d.ts

@@ -1,6 +1,7 @@
 /** Current host-to-worker protocol version. */
 export declare const PROTOCOL_VERSION: 1;
 export type SerializedError = {
+    category?: 'protocol';
     message: string;
     name: string;
     stack?: string;

package/dist/protocol.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C,eAAO,MAAM,gBAAgB,EAAG,CAAU,CAAC;AAE3C,MAAM,MAAM,eAAe,GAAG;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,aAAa,CAAC,MAAM,IAC5B;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,OAAO,gBAAgB,CAAA;CAAE,GAC5E;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,OAAO,gBAAgB,CAAA;CAAE,CAAC;AAEpF,MAAM,MAAM,cAAc,CAAC,OAAO,IAC9B;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,OAAO,gBAAgB,CAAA;CAAE,GAC/E;IAAE,KAAK,EAAE,eAAe,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,OAAO,gBAAgB,CAAA;CAAE,GACvF;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,OAAO,gBAAgB,CAAA;CAAE,CAAC;AAErF,MAAM,MAAM,WAAW,CAAC,MAAM,EAAE,OAAO,IAAI,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;AAEzF,MAAM,MAAM,aAAa,CAAC,MAAM,EAAE,MAAM,IAAI,CAAC,KAAK,EAAE,MAAM,KAAK,aAAa,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC;AAwBtH,gFAAgF;AAChF,wBAAgB,UAAU,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAcvF;AAED,oEAAoE;AACpE,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAgBzF"}
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C,eAAO,MAAM,gBAAgB,EAAG,CAAU,CAAC;AAE3C,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,CAAC,EAAE,UAAU,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,aAAa,CAAC,MAAM,IAC5B;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,OAAO,gBAAgB,CAAA;CAAE,GAC5E;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,OAAO,gBAAgB,CAAA;CAAE,CAAC;AAEpF,MAAM,MAAM,cAAc,CAAC,OAAO,IAC9B;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,OAAO,gBAAgB,CAAA;CAAE,GAC/E;IAAE,KAAK,EAAE,eAAe,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,OAAO,gBAAgB,CAAA;CAAE,GACvF;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,OAAO,gBAAgB,CAAA;CAAE,CAAC;AAErF,MAAM,MAAM,WAAW,CAAC,MAAM,EAAE,OAAO,IAAI,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;AAEzF,MAAM,MAAM,aAAa,CAAC,MAAM,EAAE,MAAM,IAAI,CAAC,KAAK,EAAE,MAAM,KAAK,aAAa,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC;AAoCtH,gFAAgF;AAChF,wBAAgB,UAAU,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAkBvF;AAED,oEAAoE;AACpE,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAoBzF"}

package/dist/protocol.js

@@ -1,68 +1,2 @@
-//#region src/protocol.ts
-var e = 1;
-function t(e) {
-	let t = e instanceof Error ? e : Error(String(e));
-	return {
-		message: t.message,
-		name: t.name,
-		stack: t.stack
-	};
-}
-function n(e) {
-	if (typeof e != "object" || !e) return !1;
-	let t = e;
-	return typeof t.id == "number" && (t.kind === "run" || t.kind === "stream") && "input" in t;
-}
-function r(e) {
-	self.postMessage(e);
-}
-function i(e, n) {
-	r({
-		error: t(n),
-		id: e,
-		kind: "error",
-		version: 1
-	});
-}
-function a(e) {
-	self.onmessage = async (t) => {
-		if (!n(t.data) || t.data.version !== 1 || t.data.kind !== "run") return;
-		let { id: a, input: o } = t.data;
-		try {
-			r({
-				id: a,
-				kind: "result",
-				value: await e(o),
-				version: 1
-			});
-		} catch (e) {
-			i(a, e);
-		}
-	};
-}
-function o(e) {
-	self.onmessage = async (t) => {
-		if (!n(t.data) || t.data.version !== 1 || t.data.kind !== "stream") return;
-		let { id: a, input: o } = t.data;
-		try {
-			for await (let t of await e(o)) r({
-				id: a,
-				kind: "chunk",
-				value: t,
-				version: 1
-			});
-			r({
-				id: a,
-				kind: "result",
-				value: void 0,
-				version: 1
-			});
-		} catch (e) {
-			i(a, e);
-		}
-	};
-}
-//#endregion
-export { e as PROTOCOL_VERSION, o as exposeStream, a as exposeTask };
-
+var e=1;function serializeError(e){let t=e instanceof Error?e:Error(String(e));return{message:t.message,name:t.name,stack:t.stack}}function isRequest(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&&(t.kind===`run`||t.kind===`stream`)&&`input`in t}function post(e){self.postMessage(e)}function postError(e,t,n){post({error:{...serializeError(t),...n&&{category:n}},id:e,kind:`error`,version:1})}function exposeTask(e){self.onmessage=async t=>{if(!isRequest(t.data))return;if(t.data.kind!==`run`){postError(t.data.id,Error(`Worker is registered for tasks, not streams`),`protocol`);return}let{id:n,input:r}=t.data;try{post({id:n,kind:`result`,value:await e(r),version:1})}catch(e){postError(n,e)}}}function exposeStream(e){self.onmessage=async t=>{if(!isRequest(t.data))return;if(t.data.kind!==`stream`){postError(t.data.id,Error(`Worker is registered for streams, not tasks`),`protocol`);return}let{id:n,input:r}=t.data;try{for await(let t of await e(r))post({id:n,kind:`chunk`,value:t,version:1});post({id:n,kind:`result`,value:void 0,version:1})}catch(e){postError(n,e)}}}export{e as PROTOCOL_VERSION,exposeStream,exposeTask};
 //# sourceMappingURL=protocol.js.map

package/dist/protocol.js.map

@@ -1 +1 @@
-{"version":3,"file":"protocol.js","names":[],"sources":["../src/protocol.ts"],"sourcesContent":["/** Current host-to-worker protocol version. */\nexport const PROTOCOL_VERSION = 1 as const;\n\nexport type SerializedError = {\n  message: string;\n  name: string;\n  stack?: string;\n};\n\nexport type WorkerRequest<TInput> =\n  | { id: number; input: TInput; kind: 'run'; version: typeof PROTOCOL_VERSION }\n  | { id: number; input: TInput; kind: 'stream'; version: typeof PROTOCOL_VERSION };\n\nexport type WorkerResponse<TOutput> =\n  | { id: number; kind: 'chunk'; value: TOutput; version: typeof PROTOCOL_VERSION }\n  | { error: SerializedError; id: number; kind: 'error'; version: typeof PROTOCOL_VERSION }\n  | { id: number; kind: 'result'; value: TOutput; version: typeof PROTOCOL_VERSION };\n\nexport type TaskHandler<TInput, TOutput> = (input: TInput) => TOutput | Promise<TOutput>;\n\nexport type StreamHandler<TInput, TChunk> = (input: TInput) => AsyncIterable<TChunk> | Promise<AsyncIterable<TChunk>>;\n\nfunction serializeError(error: unknown): SerializedError {\n  const value = error instanceof Error ? error : new Error(String(error));\n\n  return { message: value.message, name: value.name, stack: value.stack };\n}\n\nfunction isRequest(value: unknown): value is WorkerRequest<unknown> {\n  if (typeof value !== 'object' || value === null) return false;\n\n  const request = value as Partial<WorkerRequest<unknown>>;\n\n  return typeof request.id === 'number' && (request.kind === 'run' || request.kind === 'stream') && 'input' in request;\n}\n\nfunction post<TOutput>(message: WorkerResponse<TOutput>): void {\n  (self as unknown as { postMessage(data: WorkerResponse<TOutput>): void }).postMessage(message);\n}\n\nfunction postError(id: number, error: unknown): void {\n  post({ error: serializeError(error), id, kind: 'error', version: PROTOCOL_VERSION });\n}\n\n/** Register a module worker that handles one request and returns one result. */\nexport function exposeTask<TInput, TOutput>(handler: TaskHandler<TInput, TOutput>): void {\n  (self as unknown as { onmessage: (event: MessageEvent<unknown>) => void }).onmessage = async (event) => {\n    if (!isRequest(event.data) || event.data.version !== PROTOCOL_VERSION || event.data.kind !== 'run') return;\n\n    const { id, input } = event.data;\n\n    try {\n      const value = await handler(input as TInput);\n\n      post({ id, kind: 'result', value, version: PROTOCOL_VERSION });\n    } catch (error) {\n      postError(id, error);\n    }\n  };\n}\n\n/** Register a module worker that yields chunks for each request. */\nexport function exposeStream<TInput, TChunk>(handler: StreamHandler<TInput, TChunk>): void {\n  (self as unknown as { onmessage: (event: MessageEvent<unknown>) => void }).onmessage = async (event) => {\n    if (!isRequest(event.data) || event.data.version !== PROTOCOL_VERSION || event.data.kind !== 'stream') return;\n\n    const { id, input } = event.data;\n\n    try {\n      for await (const value of await handler(input as TInput)) {\n        post({ id, kind: 'chunk', value, version: PROTOCOL_VERSION });\n      }\n\n      post({ id, kind: 'result', value: undefined as never, version: PROTOCOL_VERSION });\n    } catch (error) {\n      postError(id, error);\n    }\n  };\n}\n"],"mappings":";AACA,IAAa,IAAmB;AAqBhC,SAAS,EAAe,GAAiC;CACvD,IAAM,IAAQ,aAAiB,QAAQ,IAAY,MAAM,OAAO,CAAK,CAAC;CAEtE,OAAO;EAAE,SAAS,EAAM;EAAS,MAAM,EAAM;EAAM,OAAO,EAAM;CAAM;AACxE;AAEA,SAAS,EAAU,GAAiD;CAClE,IAAI,OAAO,KAAU,aAAY,GAAgB,OAAO;CAExD,IAAM,IAAU;CAEhB,OAAO,OAAO,EAAQ,MAAO,aAAa,EAAQ,SAAS,SAAS,EAAQ,SAAS,aAAa,WAAW;AAC/G;AAEA,SAAS,EAAc,GAAwC;CAC7D,KAA0E,YAAY,CAAO;AAC/F;AAEA,SAAS,EAAU,GAAY,GAAsB;CACnD,EAAK;EAAE,OAAO,EAAe,CAAK;EAAG;EAAI,MAAM;EAAS,SAAA;CAA0B,CAAC;AACrF;AAGA,SAAgB,EAA4B,GAA6C;CACvF,KAA2E,YAAY,OAAO,MAAU;EACtG,IAAI,CAAC,EAAU,EAAM,IAAI,KAAK,EAAM,KAAK,YAAA,KAAgC,EAAM,KAAK,SAAS,OAAO;EAEpG,IAAM,EAAE,OAAI,aAAU,EAAM;EAE5B,IAAI;GAGF,EAAK;IAAE;IAAI,MAAM;IAAU,OAAA,MAFP,EAAQ,CAAe;IAET,SAAA;GAA0B,CAAC;EAC/D,SAAS,GAAO;GACd,EAAU,GAAI,CAAK;EACrB;CACF;AACF;AAGA,SAAgB,EAA6B,GAA8C;CACzF,KAA2E,YAAY,OAAO,MAAU;EACtG,IAAI,CAAC,EAAU,EAAM,IAAI,KAAK,EAAM,KAAK,YAAA,KAAgC,EAAM,KAAK,SAAS,UAAU;EAEvG,IAAM,EAAE,OAAI,aAAU,EAAM;EAE5B,IAAI;GACF,WAAW,IAAM,KAAS,MAAM,EAAQ,CAAe,GACrD,EAAK;IAAE;IAAI,MAAM;IAAS;IAAO,SAAA;GAA0B,CAAC;GAG9D,EAAK;IAAE;IAAI,MAAM;IAAU,OAAO,KAAA;IAAoB,SAAA;GAA0B,CAAC;EACnF,SAAS,GAAO;GACd,EAAU,GAAI,CAAK;EACrB;CACF;AACF"}
+{"version":3,"file":"protocol.js","names":[],"sources":["../src/protocol.ts"],"sourcesContent":["/** Current host-to-worker protocol version. */\nexport const PROTOCOL_VERSION = 1 as const;\n\nexport type SerializedError = {\n  category?: 'protocol';\n  message: string;\n  name: string;\n  stack?: string;\n};\n\nexport type WorkerRequest<TInput> =\n  | { id: number; input: TInput; kind: 'run'; version: typeof PROTOCOL_VERSION }\n  | { id: number; input: TInput; kind: 'stream'; version: typeof PROTOCOL_VERSION };\n\nexport type WorkerResponse<TOutput> =\n  | { id: number; kind: 'chunk'; value: TOutput; version: typeof PROTOCOL_VERSION }\n  | { error: SerializedError; id: number; kind: 'error'; version: typeof PROTOCOL_VERSION }\n  | { id: number; kind: 'result'; value: TOutput; version: typeof PROTOCOL_VERSION };\n\nexport type TaskHandler<TInput, TOutput> = (input: TInput) => TOutput | Promise<TOutput>;\n\nexport type StreamHandler<TInput, TChunk> = (input: TInput) => AsyncIterable<TChunk> | Promise<AsyncIterable<TChunk>>;\n\nfunction serializeError(error: unknown): SerializedError {\n  const value = error instanceof Error ? error : new Error(String(error));\n\n  return { message: value.message, name: value.name, stack: value.stack };\n}\n\nfunction isRequest(value: unknown): value is WorkerRequest<unknown> {\n  if (typeof value !== 'object' || value === null) return false;\n\n  const request = value as Partial<WorkerRequest<unknown>>;\n\n  return (\n    request.version === PROTOCOL_VERSION &&\n    typeof request.id === 'number' &&\n    Number.isSafeInteger(request.id) &&\n    request.id >= 0 &&\n    (request.kind === 'run' || request.kind === 'stream') &&\n    'input' in request\n  );\n}\n\nfunction post<TOutput>(message: WorkerResponse<TOutput>): void {\n  (self as unknown as { postMessage(data: WorkerResponse<TOutput>): void }).postMessage(message);\n}\n\nfunction postError(id: number, error: unknown, category?: SerializedError['category']): void {\n  post({\n    error: { ...serializeError(error), ...(category && { category }) },\n    id,\n    kind: 'error',\n    version: PROTOCOL_VERSION,\n  });\n}\n\n/** Register a module worker that handles one request and returns one result. */\nexport function exposeTask<TInput, TOutput>(handler: TaskHandler<TInput, TOutput>): void {\n  (self as unknown as { onmessage: (event: MessageEvent<unknown>) => void }).onmessage = async (event) => {\n    if (!isRequest(event.data)) return;\n    if (event.data.kind !== 'run') {\n      postError(event.data.id, new Error('Worker is registered for tasks, not streams'), 'protocol');\n      return;\n    }\n\n    const { id, input } = event.data;\n\n    try {\n      const value = await handler(input as TInput);\n\n      post({ id, kind: 'result', value, version: PROTOCOL_VERSION });\n    } catch (error) {\n      postError(id, error);\n    }\n  };\n}\n\n/** Register a module worker that yields chunks for each request. */\nexport function exposeStream<TInput, TChunk>(handler: StreamHandler<TInput, TChunk>): void {\n  (self as unknown as { onmessage: (event: MessageEvent<unknown>) => void }).onmessage = async (event) => {\n    if (!isRequest(event.data)) return;\n    if (event.data.kind !== 'stream') {\n      postError(event.data.id, new Error('Worker is registered for streams, not tasks'), 'protocol');\n      return;\n    }\n\n    const { id, input } = event.data;\n\n    try {\n      for await (const value of await handler(input as TInput)) {\n        post({ id, kind: 'chunk', value, version: PROTOCOL_VERSION });\n      }\n\n      post({ id, kind: 'result', value: undefined as never, version: PROTOCOL_VERSION });\n    } catch (error) {\n      postError(id, error);\n    }\n  };\n}\n"],"mappings":"AACA,IAAa,EAAmB,EAsBhC,SAAS,eAAe,EAAiC,CACvD,IAAM,EAAQ,aAAiB,MAAQ,EAAY,MAAM,OAAO,CAAK,CAAC,EAEtE,MAAO,CAAE,QAAS,EAAM,QAAS,KAAM,EAAM,KAAM,MAAO,EAAM,KAAM,CACxE,CAEA,SAAS,UAAU,EAAiD,CAClE,GAAI,OAAO,GAAU,WAAY,EAAgB,MAAO,GAExD,IAAM,EAAU,EAEhB,OACE,EAAQ,UAAA,GACR,OAAO,EAAQ,IAAO,UACtB,OAAO,cAAc,EAAQ,EAAE,GAC/B,EAAQ,IAAM,IACb,EAAQ,OAAS,OAAS,EAAQ,OAAS,WAC5C,UAAW,CAEf,CAEA,SAAS,KAAc,EAAwC,CAC7D,KAA0E,YAAY,CAAO,CAC/F,CAEA,SAAS,UAAU,EAAY,EAAgB,EAA8C,CAC3F,KAAK,CACH,MAAO,CAAE,GAAG,eAAe,CAAK,EAAG,GAAI,GAAY,CAAE,UAAS,CAAG,EACjE,KACA,KAAM,QACN,QAAA,CACF,CAAC,CACH,CAGA,SAAgB,WAA4B,EAA6C,CACvF,KAA2E,UAAY,KAAO,IAAU,CACtG,GAAI,CAAC,UAAU,EAAM,IAAI,EAAG,OAC5B,GAAI,EAAM,KAAK,OAAS,MAAO,CAC7B,UAAU,EAAM,KAAK,GAAQ,MAAM,6CAA6C,EAAG,UAAU,EAC7F,MACF,CAEA,GAAM,CAAE,KAAI,SAAU,EAAM,KAE5B,GAAI,CAGF,KAAK,CAAE,KAAI,KAAM,SAAU,MAAA,MAFP,EAAQ,CAAe,EAET,QAAA,CAA0B,CAAC,CAC/D,OAAS,EAAO,CACd,UAAU,EAAI,CAAK,CACrB,CACF,CACF,CAGA,SAAgB,aAA6B,EAA8C,CACzF,KAA2E,UAAY,KAAO,IAAU,CACtG,GAAI,CAAC,UAAU,EAAM,IAAI,EAAG,OAC5B,GAAI,EAAM,KAAK,OAAS,SAAU,CAChC,UAAU,EAAM,KAAK,GAAQ,MAAM,6CAA6C,EAAG,UAAU,EAC7F,MACF,CAEA,GAAM,CAAE,KAAI,SAAU,EAAM,KAE5B,GAAI,CACF,UAAW,IAAM,KAAS,MAAM,EAAQ,CAAe,EACrD,KAAK,CAAE,KAAI,KAAM,QAAS,QAAO,QAAA,CAA0B,CAAC,EAG9D,KAAK,CAAE,KAAI,KAAM,SAAU,MAAO,IAAA,GAAoB,QAAA,CAA0B,CAAC,CACnF,OAAS,EAAO,CACd,UAAU,EAAI,CAAK,CACrB,CACF,CACF"}

package/dist/testing/index.d.ts

@@ -1,2 +1,2 @@
-export * from './testing';
+export * from './testing.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/testing/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC"}

package/dist/testing/testing.cjs

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

package/dist/testing/testing.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"testing.cjs","names":[],"sources":["../../src/testing/testing.ts"],"sourcesContent":["import { createPool } from '../_pool';\nimport {\n  FamiliarInvalidOptionsError,\n  FamiliarTaskError,\n  FamiliarTerminatedError,\n  FamiliarTimeoutError,\n} from '../errors';\nimport type { SlotStrategy, WorkerOptions, WorkerPool } from '../types';\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) {\n    throw new FamiliarInvalidOptionsError('`concurrency` must be a positive integer');\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 (timeout !== undefined && (!Number.isFinite(timeout) || timeout <= 0)) {\n    throw new FamiliarInvalidOptionsError('`timeout` must be a finite number greater than 0');\n  }\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      prime: () => Promise.resolve(),\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';\nexport type { WorkerPool } from '../types';\n"],"mappings":"2DAmBA,SAAgB,EACd,EACA,EAA6B,CAAC,EACK,CACnC,GAAM,CAAE,cAAc,EAAG,WAAU,SAAS,SAAU,WAAY,EAElE,GAAI,CAAC,OAAO,UAAU,CAAW,GAAK,EAAc,EAClD,MAAM,IAAI,EAAA,4BAA4B,0CAA0C,EAGlF,GAAI,IAAa,IAAA,KAAc,CAAC,OAAO,UAAU,CAAQ,GAAK,EAAW,GACvE,MAAM,IAAI,EAAA,4BAA4B,uCAAuC,EAG/E,GAAI,IAAY,IAAA,KAAc,CAAC,OAAO,SAAS,CAAO,GAAK,GAAW,GACpE,MAAM,IAAI,EAAA,4BAA4B,kDAAkD,EAG1F,IAAM,EAA2C,CAAC,EAElD,SAAS,GAA0C,CACjD,IAAI,EACA,EAAa,GAEjB,MAAO,CACL,OAAO,EAAuB,CAC5B,GAAS,OAAO,CAAM,EACtB,EAAU,IAAA,EACZ,EACA,UAAa,QAAQ,QAAQ,EAC7B,IAAI,EAAO,EAAe,EAA6B,CACrD,GAAI,EAAY,OAAO,QAAQ,OAAO,IAAI,EAAA,uBAAyB,EAEnE,IAAI,EAEJ,GAAI,CACF,EAAc,gBAAgB,EAAO,CAAE,SAAU,CAAc,CAAC,CAClE,OAAS,EAAO,CACd,OAAO,QAAQ,OAAO,IAAI,EAAA,kBAAkB,6BAA8B,CAAE,MAAO,CAAM,CAAC,CAAC,CAC7F,CAEA,OAAO,IAAI,SAAkB,EAAS,IAAW,CAC/C,IAAM,EAAQ,OAAO,MAAM,EACvB,EACE,GAAU,EAA8B,IAAyB,CACjE,GAAS,QAAU,IAEvB,EAAU,IAAA,GAEN,GAAO,aAAa,CAAK,EAE7B,EAAG,CAAK,EACV,EACM,EAAc,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,EAAY,OAAM,EAElC,IAAc,IAAA,KAChB,EAAQ,eAAiB,EAAW,IAAI,EAAA,qBAAqB,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,EAAW,IAAI,EAAA,kBAAkB,8BAA+B,CAAE,MAAO,CAAM,CAAC,CAAC,EAEjF,MACF,CAEI,GAAS,QAAU,IAEvB,EAAM,KAAK,CAAE,MAAO,EAAa,OAAQ,YAAa,MAAO,CAAa,CAAC,EAC3E,EAAO,EAAS,CAAY,EAC9B,EACC,GAAmB,CAClB,IAAM,EAAQ,aAAiB,MAAQ,EAAY,MAAM,OAAO,CAAK,CAAC,EAEtE,EAAW,IAAI,EAAA,kBAAkB,EAAM,QAAS,CAAE,OAAM,CAAC,CAAC,CAC5D,CACF,CACJ,CAAC,CACH,EACA,WAAkB,CAChB,EAAa,GACb,GAAS,OAAO,IAAI,EAAA,uBAAyB,EAC7C,EAAU,IAAA,EACZ,CACF,CACF,CAEA,IAAM,EAAO,EAAA,WAAW,MAAM,KAAK,CAAE,OAAQ,CAAY,EAAG,CAAQ,EAAG,CACrE,cACA,eAAgB,EAChB,WACA,QACF,CAAC,EAOD,OALA,OAAO,eAAe,EAAM,QAAS,CACnC,WAAY,GACZ,QAAW,CACb,CAAC,EAEM,CACT"}
+{"version":3,"file":"testing.cjs","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":"0FAoBA,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,EAAA,4BAA4B,gDAAiE,EAGzG,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,EAG7E,EAAA,gBAAgB,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,EAAA,uBAAyB,EAEnE,IAAI,EAEJ,GAAI,CACF,EAAc,gBAAgB,EAAO,CAAE,SAAU,CAAc,CAAC,CAClE,OAAS,EAAO,CACd,OAAO,QAAQ,OAAO,IAAI,EAAA,kBAAkB,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,EAAA,qBAAqB,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,EAAA,kBAAkB,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,EAAA,kBAAkB,EAAM,QAAS,CAAE,OAAM,CAAC,CAAC,CAC5D,CACF,CACJ,CAAC,CACH,EACA,WAAkB,CAChB,EAAa,GACb,GAAS,OAAO,IAAI,EAAA,uBAAyB,EAC7C,EAAU,IAAA,EACZ,CACF,CACF,CAEA,IAAM,EAAO,EAAA,WAAW,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/testing.d.ts

@@ -1,5 +1,5 @@
-import type { WorkerOptions, WorkerPool } from '../types';
-export type TestWorkerOptions = Omit<WorkerOptions, 'concurrency' | 'onSlotError'> & {
+import type { WorkerOptions, WorkerPool } from '../types.js';
+export type TestWorkerOptions = Omit<WorkerOptions, 'concurrency'> & {
     concurrency?: number;
 };
 export type TestWorkerCall<TInput, TOutput> = {
@@ -15,6 +15,6 @@ export type TestWorkerHandle<TInput, TOutput> = WorkerPool<TInput, TOutput> & {
     readonly calls: ReadonlyArray<TestWorkerCall<TInput, TOutput>>;
 };
 export declare function createTestWorker<TInput, TOutput>(handler: (input: TInput) => TOutput | Promise<TOutput>, options?: TestWorkerOptions): TestWorkerHandle<TInput, TOutput>;
-export { FamiliarError, FamiliarInvalidOptionsError, FamiliarQueueFullError, FamiliarRuntimeError, FamiliarTaskError, FamiliarTerminatedError, FamiliarTimeoutError, } from '../errors';
-export type { WorkerPool } from '../types';
+export { FamiliarError, FamiliarInvalidOptionsError, FamiliarQueueFullError, FamiliarRuntimeError, FamiliarTaskError, FamiliarTerminatedError, FamiliarTimeoutError, } from '../errors.js';
+export type { WorkerPool } from '../types.js';
 //# sourceMappingURL=testing.d.ts.map

package/dist/testing/testing.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"testing.d.ts","sourceRoot":"","sources":["../../src/testing/testing.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAgB,aAAa,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAExE,MAAM,MAAM,iBAAiB,GAAG,IAAI,CAAC,aAAa,EAAE,aAAa,GAAG,aAAa,CAAC,GAAG;IAAE,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAE9G,MAAM,MAAM,cAAc,CAAC,MAAM,EAAE,OAAO,IACtC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,WAAW,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GACtD;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,UAAU,CAAA;CAAE,CAAC;AAE3D,MAAM,MAAM,gBAAgB,CAAC,MAAM,EAAE,OAAO,IAAI,UAAU,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IAC5E,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CAChE,CAAC;AAEF,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,OAAO,EAC9C,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,EACtD,OAAO,GAAE,iBAAsB,GAC9B,gBAAgB,CAAC,MAAM,EAAE,OAAO,CAAC,CAmHnC;AAED,OAAO,EACL,aAAa,EACb,2BAA2B,EAC3B,sBAAsB,EACtB,oBAAoB,EACpB,iBAAiB,EACjB,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,WAAW,CAAC;AACnB,YAAY,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC"}
+{"version":3,"file":"testing.d.ts","sourceRoot":"","sources":["../../src/testing/testing.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAgB,aAAa,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE3E,MAAM,MAAM,iBAAiB,GAAG,IAAI,CAAC,aAAa,EAAE,aAAa,CAAC,GAAG;IAAE,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAE9F,MAAM,MAAM,cAAc,CAAC,MAAM,EAAE,OAAO,IACtC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,WAAW,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GACtD;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,UAAU,CAAA;CAAE,CAAC;AAE3D,MAAM,MAAM,gBAAgB,CAAC,MAAM,EAAE,OAAO,IAAI,UAAU,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IAC5E,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CAChE,CAAC;AAEF,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,OAAO,EAC9C,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,EACtD,OAAO,GAAE,iBAAsB,GAC9B,gBAAgB,CAAC,MAAM,EAAE,OAAO,CAAC,CAmHnC;AAED,OAAO,EACL,aAAa,EACb,2BAA2B,EAC3B,sBAAsB,EACtB,oBAAoB,EACpB,iBAAiB,EACjB,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC"}

package/dist/testing/testing.js

@@ -1,76 +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 { createPool as s } from "../_pool.js";
-//#region src/testing/testing.ts
-function c(e, n = {}) {
-	let { concurrency: r = 1, maxQueue: c, onFull: l = "reject", timeout: u } = n;
-	if (!Number.isInteger(r) || r < 1) throw new t("`concurrency` must be a positive integer");
-	if (c !== void 0 && (!Number.isInteger(c) || c < 1)) throw new t("`maxQueue` must be a positive integer");
-	if (u !== void 0 && (!Number.isFinite(u) || u <= 0)) throw new t("`timeout` must be a finite number greater than 0");
-	let d = [];
-	function f() {
-		let t, n = !1;
-		return {
-			cancel(e) {
-				t?.reject(e), t = void 0;
-			},
-			prime: () => Promise.resolve(),
-			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));
-					}, f = (e) => {
-						t?.token === a && (t = void 0, s && clearTimeout(s), d.push({
-							input: l,
-							reason: e,
-							status: "rejected"
-						}), r(e));
-					};
-					t = {
-						reject: f,
-						token: a
-					}, c !== void 0 && (s = setTimeout(() => f(new o(c)), c)), Promise.resolve().then(() => e(l)).then((e) => {
-						let r;
-						try {
-							r = structuredClone(e);
-						} catch (e) {
-							f(new i("Failed to clone task output", { cause: e }));
-							return;
-						}
-						t?.token === a && (d.push({
-							input: l,
-							status: "fulfilled",
-							value: r
-						}), u(n, r));
-					}, (e) => {
-						let t = e instanceof Error ? e : Error(String(e));
-						f(new i(t.message, { cause: t }));
-					});
-				});
-			},
-			terminate() {
-				n = !0, t?.reject(new a()), t = void 0;
-			}
-		};
-	}
-	let p = s(Array.from({ length: r }, f), {
-		concurrency: r,
-		defaultTimeout: u,
-		maxQueue: c,
-		onFull: l
-	});
-	return Object.defineProperty(p, "calls", {
-		enumerable: !0,
-		get: () => d
-	}), p;
-}
-//#endregion
-export { e as FamiliarError, t as FamiliarInvalidOptionsError, n as FamiliarQueueFullError, r as FamiliarRuntimeError, i as FamiliarTaskError, a as FamiliarTerminatedError, o as FamiliarTimeoutError, c 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';\nimport {\n  FamiliarInvalidOptionsError,\n  FamiliarTaskError,\n  FamiliarTerminatedError,\n  FamiliarTimeoutError,\n} from '../errors';\nimport type { SlotStrategy, WorkerOptions, WorkerPool } from '../types';\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) {\n    throw new FamiliarInvalidOptionsError('`concurrency` must be a positive integer');\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 (timeout !== undefined && (!Number.isFinite(timeout) || timeout <= 0)) {\n    throw new FamiliarInvalidOptionsError('`timeout` must be a finite number greater than 0');\n  }\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      prime: () => Promise.resolve(),\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';\nexport type { WorkerPool } from '../types';\n"],"mappings":";;;AAmBA,SAAgB,EACd,GACA,IAA6B,CAAC,GACK;CACnC,IAAM,EAAE,iBAAc,GAAG,aAAU,YAAS,UAAU,eAAY;CAElE,IAAI,CAAC,OAAO,UAAU,CAAW,KAAK,IAAc,GAClD,MAAM,IAAI,EAA4B,0CAA0C;CAGlF,IAAI,MAAa,KAAA,MAAc,CAAC,OAAO,UAAU,CAAQ,KAAK,IAAW,IACvE,MAAM,IAAI,EAA4B,uCAAuC;CAG/E,IAAI,MAAY,KAAA,MAAc,CAAC,OAAO,SAAS,CAAO,KAAK,KAAW,IACpE,MAAM,IAAI,EAA4B,kDAAkD;CAG1F,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,aAAa,QAAQ,QAAQ;GAC7B,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

@@ -1,4 +1,4 @@
-import type { FamiliarRuntimeError } from './errors';
+import type { FamiliarRuntimeError } from './errors.js';
 export type WorkerStatus = 'idle' | 'running' | 'terminated';
 export type WorkerStats = {
     readonly active: number;
@@ -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;
@@ -26,7 +31,7 @@ export type RunOptions = {
     /** Per-operation timeout in milliseconds. Overrides WorkerOptions.timeout. */
     timeout?: number;
     /** Values transferred to the worker instead of structured-cloned. */
-    transferables?: Transferable[];
+    transferables?: readonly Transferable[];
 };
 export type DrainOptions = {
     /** Maximum time to wait before terminating remaining work. */
@@ -37,9 +42,15 @@ export interface PoolBase {
     dispose(): void;
     readonly disposed: boolean;
     drain(options?: DrainOptions): Promise<void>;
-    prime(): 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;
 }
@@ -49,20 +60,10 @@ export interface WorkerPool<TInput, TOutput> extends PoolBase {
 export interface StreamWorkerPool<TInput, TChunk> extends PoolBase {
     runStream(input: TInput, options?: RunOptions): AsyncIterable<TChunk>;
 }
-export type TaskGroup<TInput, TOutput> = {
-    abort(reason?: unknown): void;
-    drain(): Promise<PromiseSettledResult<TOutput>[]>;
-    readonly name: string | undefined;
-    readonly pending: number;
-    run(input: TInput, options?: Omit<RunOptions, 'signal'>): Promise<TOutput>;
-    readonly size: number;
-};
-export type TaskGroupOptions = {
-    signal?: AbortSignal;
-};
 export type SlotStrategy<TInput, TOutput> = {
     cancel(reason: unknown): void;
-    prime(): Promise<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":"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"}
+{"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.cjs"),r=require("./_stream-pool.cjs");require("./protocol.cjs");var i=512;function a(e={}){let{concurrency:n=1,maxQueue:r,onFull:a=`reject`,onSlotError:o,timeout:s}=e,c=n===`auto`?Math.max(1,globalThis.navigator?.hardwareConcurrency??1):n;if(!Number.isInteger(c)||c<1||c>i)throw new t.FamiliarInvalidOptionsError(`\`concurrency\` must be a positive integer ≤ ${i} or "auto"`);if(r!==void 0&&(!Number.isInteger(r)||r<1))throw new t.FamiliarInvalidOptionsError("`maxQueue` must be a positive integer");if(s!==void 0&&(!Number.isFinite(s)||s<=0))throw new t.FamiliarInvalidOptionsError("`timeout` must be a finite number greater than 0");return{concurrency:c,maxQueue:r,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`&&(t.kind===`chunk`||t.kind===`error`||t.kind===`result`)}function s(e){let n=Error(e.message);return n.name=e.name,n.stack=e.stack,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.#a?.terminate(),this.#a=void 0,this.#l(`reject`,e)}prime(){return this.#n||this.#s(),Promise.resolve()}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.cancel(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 new Promise((l,u)=>{let d={emit:o,id:c,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=e=>this.#c(e.data),e.onerror=e=>{let n=new t.FamiliarRuntimeError(e.message||`Worker failed`);this.#a=void 0,this.#e?.(n),this.#l(`reject`,n)},this.#a=e,e}catch(e){throw new t.FamiliarRuntimeError(`Failed to create Worker`,{cause:e})}}#c(e){if(this.#r){if(!o(e)||e.id!==this.#r.id){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.#l(`reject`,s(e.error));return}this.#l(`resolve`,e.value)}}#l(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){return Array.from({length:t.concurrency},()=>new c(e,t.onSlotError))}function u(e,t={}){let r=a(t);return n.createPool(l(e,r),{concurrency:r.concurrency,defaultTimeout:r.timeout,maxQueue:r.maxQueue,onFull:r.onFull})}function d(e,t={}){let n=a(t);return r.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.batch=n.batch,exports.createStreamWorker=d,exports.createTaskGroup=n.createTaskGroup,exports.createWorker=u;
+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":["#onSlotError","#url","#worker","#settlePending","#disposed","#ensureWorker","#dispatch","#pending","#taskId","#onMessage"],"sources":["../src/worker.ts"],"sourcesContent":["export { batch, createTaskGroup } from './_pool';\nexport {\n  FamiliarError,\n  FamiliarInvalidOptionsError,\n  FamiliarQueueFullError,\n  FamiliarRuntimeError,\n  FamiliarTaskError,\n  FamiliarTerminatedError,\n  FamiliarTimeoutError,\n} from './errors';\nexport type {\n  DrainOptions,\n  PoolBase,\n  RunOptions,\n  StreamWorkerPool,\n  TaskGroup,\n  TaskGroupOptions,\n  WorkerOptions,\n  WorkerPool,\n  WorkerStats,\n  WorkerStatus,\n} from './types';\n\nimport { createPool } from './_pool';\nimport { createStreamPool, type StreamSlot } from './_stream-pool';\nimport { unrefTimer } from './_timers';\nimport {\n  FamiliarInvalidOptionsError,\n  FamiliarRuntimeError,\n  FamiliarTaskError,\n  FamiliarTerminatedError,\n  FamiliarTimeoutError,\n} from './errors';\nimport type { SerializedError, WorkerResponse } from './protocol';\nimport { PROTOCOL_VERSION } from './protocol';\nimport type { RunOptions, SlotStrategy, StreamWorkerPool, WorkerOptions, WorkerPool } from './types';\n\nconst MAX_CONCURRENCY = 512;\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  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' ? Math.max(1, globalThis.navigator?.hardwareConcurrency ?? 1) : 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 (timeout !== undefined && (!Number.isFinite(timeout) || timeout <= 0)) {\n    throw new FamiliarInvalidOptionsError('`timeout` must be a finite number greater than 0');\n  }\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\n  return (\n    response.version === PROTOCOL_VERSION &&\n    typeof response.id === 'number' &&\n    (response.kind === 'chunk' || response.kind === 'error' || response.kind === 'result')\n  );\n}\n\nfunction taskError(error: SerializedError): FamiliarTaskError {\n  const cause = new Error(error.message);\n\n  cause.name = error.name;\n  cause.stack = error.stack;\n\n  return 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    this.#worker?.terminate();\n    this.#worker = undefined;\n    this.#settlePending('reject', reason);\n  }\n\n  prime(): Promise<void> {\n    if (!this.#disposed) this.#ensureWorker();\n\n    return Promise.resolve();\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.cancel(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\n      return new Promise<TOutput>((resolve, reject) => {\n        const pending: Pending<TOutput> = { emit, id, 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>) => this.#onMessage(event.data);\n      worker.onerror = (event) => {\n        const error = new FamiliarRuntimeError(event.message || 'Worker failed');\n\n        this.#worker = undefined;\n        this.#onSlotError?.(error);\n        this.#settlePending('reject', error);\n      };\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  #onMessage(message: unknown): void {\n    if (!this.#pending) return;\n\n    if (!isWorkerResponse<TOutput>(message) || message.id !== this.#pending.id) {\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', taskError(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  return Array.from({ length: options.concurrency }, () => new Slot<TInput, TOutput>(url, 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":"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"}

package/dist/worker.d.ts

@@ -1,11 +1,4 @@
-export { batch, createTaskGroup } from './_pool';
-export { FamiliarError, FamiliarInvalidOptionsError, FamiliarQueueFullError, FamiliarRuntimeError, FamiliarTaskError, FamiliarTerminatedError, FamiliarTimeoutError, } from './errors';
-export type { DrainOptions, PoolBase, RunOptions, StreamWorkerPool, TaskGroup, TaskGroupOptions, WorkerOptions, WorkerPool, WorkerStats, WorkerStatus, } from './types';
-import type { StreamWorkerPool, WorkerOptions, WorkerPool } from './types';
-export type RunningStream<TChunk> = {
-    done: Promise<void>;
-    iterable: AsyncIterable<TChunk>;
-};
+import type { StreamWorkerPool, WorkerOptions, WorkerPool } from './types.js';
 /** 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,OAAO,EAAE,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AACjD,OAAO,EACL,aAAa,EACb,2BAA2B,EAC3B,sBAAsB,EACtB,oBAAoB,EACpB,iBAAiB,EACjB,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,UAAU,CAAC;AAClB,YAAY,EACV,YAAY,EACZ,QAAQ,EACR,UAAU,EACV,gBAAgB,EAChB,SAAS,EACT,gBAAgB,EAChB,aAAa,EACb,UAAU,EACV,WAAW,EACX,YAAY,GACb,MAAM,SAAS,CAAC;AAcjB,OAAO,KAAK,EAA4B,gBAAgB,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAoBrG,MAAM,MAAM,aAAa,CAAC,MAAM,IAAI;IAClC,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACpB,QAAQ,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CACjC,CAAC;AA2OF,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"}