@vielzeug/familiar 26.10.14 → 26.10.16
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/_pool-core.cjs.map +1 -1
- package/dist/_pool-core.js +171 -1
- package/dist/_pool-core.js.map +1 -1
- package/dist/_pool.cjs.map +1 -1
- package/dist/_pool.js +111 -1
- package/dist/_pool.js.map +1 -1
- package/dist/_stream-pool.cjs.map +1 -1
- package/dist/_stream-pool.js +77 -1
- package/dist/_stream-pool.js.map +1 -1
- package/dist/_timers.cjs.map +1 -1
- package/dist/_timers.js +7 -1
- package/dist/_timers.js.map +1 -1
- package/dist/errors.cjs.map +1 -1
- package/dist/errors.js +23 -1
- package/dist/errors.js.map +1 -1
- package/dist/familiar.cjs +1 -1
- package/dist/familiar.cjs.map +1 -1
- package/dist/familiar.iife.js +1 -1
- package/dist/familiar.iife.js.map +1 -1
- package/dist/familiar.js +528 -1
- package/dist/familiar.js.map +1 -1
- package/dist/index.js +4 -1
- package/dist/protocol.cjs.map +1 -1
- package/dist/protocol.js +78 -1
- package/dist/protocol.js.map +1 -1
- package/dist/testing/testing.cjs.map +1 -1
- package/dist/testing/testing.js +75 -1
- package/dist/testing/testing.js.map +1 -1
- package/dist/testing.js +3 -1
- package/dist/worker.cjs +1 -1
- package/dist/worker.cjs.map +1 -1
- package/dist/worker.js +166 -1
- package/dist/worker.js.map +1 -1
- package/package.json +5 -5
package/dist/_stream-pool.js
CHANGED
|
@@ -1,2 +1,78 @@
|
|
|
1
|
-
import{FamiliarRuntimeError as e,FamiliarTerminatedError as t}from"./errors.js";
|
|
1
|
+
import { FamiliarRuntimeError as e, FamiliarTerminatedError as t } from "./errors.js";
|
|
2
|
+
import { createPoolCore as n, validatePriority as r, validateTimeout as i } from "./_pool-core.js";
|
|
3
|
+
import { abortError as a } from "@vielzeug/arsenal";
|
|
4
|
+
//#region src/_stream-pool.ts
|
|
5
|
+
function createStreamPool(o, s) {
|
|
6
|
+
let c = n(o, s);
|
|
7
|
+
for (let e of o) e.notify = (e) => c.emitTap({
|
|
8
|
+
error: e,
|
|
9
|
+
type: "worker-error"
|
|
10
|
+
});
|
|
11
|
+
function runStream(n, o = {}) {
|
|
12
|
+
let l = r(o.priority ?? 0), u = i(o.timeout) ?? s.defaultTimeout, d = [...o.transferables ?? []], f, iterate = async function* (e) {
|
|
13
|
+
let onAbort = () => e.abort(o.signal?.reason), r, onCancel;
|
|
14
|
+
o.signal?.aborted ? e.abort(o.signal.reason) : o.signal?.addEventListener("abort", onAbort, { once: !0 });
|
|
15
|
+
try {
|
|
16
|
+
let t = await c.acquire({
|
|
17
|
+
priority: l,
|
|
18
|
+
signal: e.signal
|
|
19
|
+
}, (t) => (r = t, c.trackActive(1), onCancel = () => r?.cancel(a(e.signal)), e.signal.addEventListener("abort", onCancel, { once: !0 }), t.stream(n, {
|
|
20
|
+
priority: l,
|
|
21
|
+
signal: e.signal,
|
|
22
|
+
timeout: u,
|
|
23
|
+
transferables: d
|
|
24
|
+
})));
|
|
25
|
+
for await (let e of t.iterable) yield e;
|
|
26
|
+
await t.done, c.trackCompleted();
|
|
27
|
+
} catch (n) {
|
|
28
|
+
throw r && !e.signal.aborted && !(n instanceof t) && c.trackFailed(), n;
|
|
29
|
+
} finally {
|
|
30
|
+
o.signal?.removeEventListener("abort", onAbort), r && (onCancel && e.signal.removeEventListener("abort", onCancel), c.trackActive(-1), c.release(r), c.settleIdle());
|
|
31
|
+
}
|
|
32
|
+
};
|
|
33
|
+
return { [Symbol.asyncIterator]() {
|
|
34
|
+
let n = {}, r = new AbortController(), i, start = () => {
|
|
35
|
+
if (f ??= n, f === n) return i ??= iterate(r), i;
|
|
36
|
+
};
|
|
37
|
+
return {
|
|
38
|
+
next: () => start()?.next() ?? Promise.reject(new e("Worker streams can only be consumed once")),
|
|
39
|
+
return: async (e) => !f || f !== n ? {
|
|
40
|
+
done: !0,
|
|
41
|
+
value: e
|
|
42
|
+
} : (r.abort(new t("Stream consumer stopped")), i?.return(e) ?? {
|
|
43
|
+
done: !0,
|
|
44
|
+
value: e
|
|
45
|
+
}),
|
|
46
|
+
throw: async (t) => {
|
|
47
|
+
let n = start();
|
|
48
|
+
if (!n) throw new e("Worker streams can only be consumed once");
|
|
49
|
+
return r.abort(t), n.throw(t);
|
|
50
|
+
}
|
|
51
|
+
};
|
|
52
|
+
} };
|
|
53
|
+
}
|
|
54
|
+
return {
|
|
55
|
+
get disposalSignal() {
|
|
56
|
+
return c.disposalSignal;
|
|
57
|
+
},
|
|
58
|
+
dispose: c.dispose,
|
|
59
|
+
get disposed() {
|
|
60
|
+
return c.disposed;
|
|
61
|
+
},
|
|
62
|
+
drain: c.drain,
|
|
63
|
+
runStream,
|
|
64
|
+
get stats() {
|
|
65
|
+
return c.stats();
|
|
66
|
+
},
|
|
67
|
+
get status() {
|
|
68
|
+
return c.status();
|
|
69
|
+
},
|
|
70
|
+
tap: c.tap,
|
|
71
|
+
[Symbol.asyncDispose]: () => c.drain({}),
|
|
72
|
+
[Symbol.dispose]: c.dispose
|
|
73
|
+
};
|
|
74
|
+
}
|
|
75
|
+
//#endregion
|
|
76
|
+
export { createStreamPool };
|
|
77
|
+
|
|
2
78
|
//# sourceMappingURL=_stream-pool.js.map
|
package/dist/_stream-pool.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"_stream-pool.js","names":[],"sources":["../src/_stream-pool.ts"],"sourcesContent":["import { abortError } from '@vielzeug/arsenal';\nimport { createPoolCore, type PoolCore, type PoolOptions, validatePriority, validateTimeout } from './_pool-core.js';\nimport { FamiliarRuntimeError, FamiliarTerminatedError } from './errors.js';\nimport type { RunOptions, StreamWorkerPool } from './types.js';\n\nexport type StreamSlot<TInput, TChunk> = {\n cancel(reason: unknown): void;\n /** Wired by the pool factory to report unhandled worker runtime errors through `tap()`. */\n notify?(error: FamiliarRuntimeError): void;\n stream(input: TInput, options: RunOptions): { done: Promise<void>; iterable: AsyncIterable<TChunk> };\n terminate(): void;\n};\n\nexport function createStreamPool<TInput, TChunk>(\n slots: readonly StreamSlot<TInput, TChunk>[],\n options: PoolOptions,\n): StreamWorkerPool<TInput, TChunk> {\n const core: PoolCore<StreamSlot<TInput, TChunk>> = createPoolCore(slots, options);\n\n for (const slot of slots) slot.notify = (error) => core.emitTap({ error, type: 'worker-error' });\n\n function runStream(input: TInput, runOptions: RunOptions = {}): AsyncIterable<TChunk> {\n const priority = validatePriority(runOptions.priority ?? 0);\n const timeout = validateTimeout(runOptions.timeout) ?? options.defaultTimeout;\n const transferables = [...(runOptions.transferables ?? [])];\n let owner: object | undefined;\n\n const iterate = async function* (controller: AbortController): AsyncGenerator<TChunk> {\n const onAbort = () => controller.abort(runOptions.signal?.reason);\n let slot: StreamSlot<TInput, TChunk> | undefined;\n let onCancel: (() => void) | undefined;\n\n if (runOptions.signal?.aborted) controller.abort(runOptions.signal.reason);\n else runOptions.signal?.addEventListener('abort', onAbort, { once: true });\n\n try {\n const running = await core.acquire({ priority, signal: controller.signal }, (acquired) => {\n slot = acquired;\n core.trackActive(1);\n onCancel = () => slot?.cancel(abortError(controller.signal));\n controller.signal.addEventListener('abort', onCancel, { once: true });\n\n return acquired.stream(input, { priority, signal: controller.signal, timeout, transferables });\n });\n\n for await (const value of running.iterable) yield value;\n await running.done;\n core.trackCompleted();\n } catch (error) {\n if (slot && !controller.signal.aborted && !(error instanceof FamiliarTerminatedError)) core.trackFailed();\n throw error;\n } finally {\n runOptions.signal?.removeEventListener('abort', onAbort);\n\n if (slot) {\n if (onCancel) controller.signal.removeEventListener('abort', onCancel);\n\n core.trackActive(-1);\n core.release(slot);\n core.settleIdle();\n }\n }\n };\n\n return {\n [Symbol.asyncIterator]() {\n const token = {};\n const controller = new AbortController();\n let iterator: AsyncGenerator<TChunk> | undefined;\n const start = (): AsyncGenerator<TChunk> | undefined => {\n owner ??= token;\n if (owner !== token) return undefined;\n iterator ??= iterate(controller);\n return iterator;\n };\n\n return {\n next: () =>\n start()?.next() ?? Promise.reject(new FamiliarRuntimeError('Worker streams can only be consumed once')),\n return: async (value?: unknown) => {\n if (!owner || owner !== token) return { done: true, value: value as TChunk };\n controller.abort(new FamiliarTerminatedError('Stream consumer stopped'));\n return iterator?.return(value as TChunk) ?? { done: true, value: value as TChunk };\n },\n throw: async (error?: unknown) => {\n const active = start();\n if (!active) throw new FamiliarRuntimeError('Worker streams can only be consumed once');\n controller.abort(error);\n return active.throw(error);\n },\n };\n },\n };\n }\n\n return {\n get disposalSignal() {\n return core.disposalSignal;\n },\n dispose: core.dispose,\n get disposed() {\n return core.disposed;\n },\n drain: core.drain,\n runStream,\n get stats() {\n return core.stats();\n },\n get status() {\n return core.status();\n },\n tap: core.tap,\n [Symbol.asyncDispose]: () => core.drain({}),\n [Symbol.dispose]: core.dispose,\n };\n}\n"],"mappings":"
|
|
1
|
+
{"version":3,"file":"_stream-pool.js","names":["core","createPoolCore","slots","options","slot","priority","validatePriority","runOptions","timeout","validateTimeout","transferables","owner","controller","running","acquired","abortError","input","value","error","FamiliarTerminatedError","token","iterator","FamiliarRuntimeError","active"],"sources":["../src/_stream-pool.ts"],"sourcesContent":["import { abortError } from '@vielzeug/arsenal';\nimport { createPoolCore, type PoolCore, type PoolOptions, validatePriority, validateTimeout } from './_pool-core.js';\nimport { FamiliarRuntimeError, FamiliarTerminatedError } from './errors.js';\nimport type { RunOptions, StreamWorkerPool } from './types.js';\n\nexport type StreamSlot<TInput, TChunk> = {\n cancel(reason: unknown): void;\n /** Wired by the pool factory to report unhandled worker runtime errors through `tap()`. */\n notify?(error: FamiliarRuntimeError): void;\n stream(input: TInput, options: RunOptions): { done: Promise<void>; iterable: AsyncIterable<TChunk> };\n terminate(): void;\n};\n\nexport function createStreamPool<TInput, TChunk>(\n slots: readonly StreamSlot<TInput, TChunk>[],\n options: PoolOptions,\n): StreamWorkerPool<TInput, TChunk> {\n const core: PoolCore<StreamSlot<TInput, TChunk>> = createPoolCore(slots, options);\n\n for (const slot of slots) slot.notify = (error) => core.emitTap({ error, type: 'worker-error' });\n\n function runStream(input: TInput, runOptions: RunOptions = {}): AsyncIterable<TChunk> {\n const priority = validatePriority(runOptions.priority ?? 0);\n const timeout = validateTimeout(runOptions.timeout) ?? options.defaultTimeout;\n const transferables = [...(runOptions.transferables ?? [])];\n let owner: object | undefined;\n\n const iterate = async function* (controller: AbortController): AsyncGenerator<TChunk> {\n const onAbort = () => controller.abort(runOptions.signal?.reason);\n let slot: StreamSlot<TInput, TChunk> | undefined;\n let onCancel: (() => void) | undefined;\n\n if (runOptions.signal?.aborted) controller.abort(runOptions.signal.reason);\n else runOptions.signal?.addEventListener('abort', onAbort, { once: true });\n\n try {\n const running = await core.acquire({ priority, signal: controller.signal }, (acquired) => {\n slot = acquired;\n core.trackActive(1);\n onCancel = () => slot?.cancel(abortError(controller.signal));\n controller.signal.addEventListener('abort', onCancel, { once: true });\n\n return acquired.stream(input, { priority, signal: controller.signal, timeout, transferables });\n });\n\n for await (const value of running.iterable) yield value;\n await running.done;\n core.trackCompleted();\n } catch (error) {\n if (slot && !controller.signal.aborted && !(error instanceof FamiliarTerminatedError)) core.trackFailed();\n throw error;\n } finally {\n runOptions.signal?.removeEventListener('abort', onAbort);\n\n if (slot) {\n if (onCancel) controller.signal.removeEventListener('abort', onCancel);\n\n core.trackActive(-1);\n core.release(slot);\n core.settleIdle();\n }\n }\n };\n\n return {\n [Symbol.asyncIterator]() {\n const token = {};\n const controller = new AbortController();\n let iterator: AsyncGenerator<TChunk> | undefined;\n const start = (): AsyncGenerator<TChunk> | undefined => {\n owner ??= token;\n if (owner !== token) return undefined;\n iterator ??= iterate(controller);\n return iterator;\n };\n\n return {\n next: () =>\n start()?.next() ?? Promise.reject(new FamiliarRuntimeError('Worker streams can only be consumed once')),\n return: async (value?: unknown) => {\n if (!owner || owner !== token) return { done: true, value: value as TChunk };\n controller.abort(new FamiliarTerminatedError('Stream consumer stopped'));\n return iterator?.return(value as TChunk) ?? { done: true, value: value as TChunk };\n },\n throw: async (error?: unknown) => {\n const active = start();\n if (!active) throw new FamiliarRuntimeError('Worker streams can only be consumed once');\n controller.abort(error);\n return active.throw(error);\n },\n };\n },\n };\n }\n\n return {\n get disposalSignal() {\n return core.disposalSignal;\n },\n dispose: core.dispose,\n get disposed() {\n return core.disposed;\n },\n drain: core.drain,\n runStream,\n get stats() {\n return core.stats();\n },\n get status() {\n return core.status();\n },\n tap: core.tap,\n [Symbol.asyncDispose]: () => core.drain({}),\n [Symbol.dispose]: core.dispose,\n };\n}\n"],"mappings":";;;;AAaA,SAAgB,iBACd,GACA,GACkC;CAClC,IAAMA,IAA6CC,EAAeC,GAAOC,CAAO;CAEhF,KAAK,IAAMC,KAAQF,GAAO,EAAK,UAAU,MAAUF,EAAK,QAAQ;EAAE;EAAO,MAAM;CAAe,CAAC;CAE/F,SAAS,UAAU,GAAe,IAAyB,CAAC,GAA0B;EACpF,IAAMK,IAAWC,EAAiBC,EAAW,YAAY,CAAC,GACpDC,IAAUC,EAAgBF,EAAW,OAAO,KAAKJ,EAAQ,gBACzDO,IAAgB,CAAC,GAAIH,EAAW,iBAAiB,CAAC,CAAE,GACtDI,GAEE,UAAU,iBAAiB,GAAqD;GACpF,IAAM,gBAAgBC,EAAW,MAAML,EAAW,QAAQ,MAAM,GAC5DH,GACA;GAEJ,AAAIG,EAAW,QAAQ,UAASK,EAAW,MAAML,EAAW,OAAO,MAAM,IACpEA,EAAW,QAAQ,iBAAiB,SAAS,SAAS,EAAE,MAAM,GAAK,CAAC;GAEzE,IAAI;IACF,IAAMM,IAAU,MAAMb,EAAK,QAAQ;KAAE;KAAU,QAAQY,EAAW;IAAO,IAAI,OAC3E,IAAOE,GACPd,EAAK,YAAY,CAAC,GAClB,iBAAiBI,GAAM,OAAOW,EAAWH,EAAW,MAAM,CAAC,GAC3DA,EAAW,OAAO,iBAAiB,SAAS,UAAU,EAAE,MAAM,GAAK,CAAC,GAE7DE,EAAS,OAAOE,GAAO;KAAE;KAAU,QAAQJ,EAAW;KAAQ;KAAS;IAAc,CAAC,EAC9F;IAED,WAAW,IAAMK,KAASJ,EAAQ,UAAU,MAAMI;IAElD,AADA,MAAMJ,EAAQ,MACdb,EAAK,eAAe;GACtB,SAASkB,GAAO;IAEd,MADId,KAAQ,CAACQ,EAAW,OAAO,WAAW,EAAEM,aAAiBC,MAA0BnB,EAAK,YAAY,GAClGkB;GACR,UAAU;IAGR,AAFAX,EAAW,QAAQ,oBAAoB,SAAS,OAAO,GAEnDH,MACE,YAAUQ,EAAW,OAAO,oBAAoB,SAAS,QAAQ,GAErEZ,EAAK,YAAY,EAAE,GACnBA,EAAK,QAAQI,CAAI,GACjBJ,EAAK,WAAW;GAEpB;EACF;EAEA,OAAO,EACL,CAAC,OAAO,iBAAiB;GACvB,IAAMoB,IAAQ,CAAC,GACTR,IAAa,IAAI,gBAAgB,GACnCS,GACE,cAAkD;IAEtD,IADA,MAAUD,GACNT,MAAUS,GAEd,OADA,MAAa,QAAQR,CAAU,GACxBS;GACT;GAEA,OAAO;IACL,YACE,MAAM,CAAC,EAAE,KAAK,KAAK,QAAQ,OAAO,IAAIC,EAAqB,0CAA0C,CAAC;IACxG,QAAQ,OAAO,MACT,CAACX,KAASA,MAAUS,IAAc;KAAE,MAAM;KAAa;IAAgB,KAC3ER,EAAW,MAAM,IAAIO,EAAwB,yBAAyB,CAAC,GAChEE,GAAU,OAAOJ,CAAe,KAAK;KAAE,MAAM;KAAa;IAAgB;IAEnF,OAAO,OAAO,MAAoB;KAChC,IAAMM,IAAS,MAAM;KACrB,IAAI,CAACA,GAAQ,MAAM,IAAID,EAAqB,0CAA0C;KAEtF,OADAV,EAAW,MAAMM,CAAK,GACfK,EAAO,MAAML,CAAK;IAC3B;GACF;EACF,EACF;CACF;CAEA,OAAO;EACL,IAAI,iBAAiB;GACnB,OAAOlB,EAAK;EACd;EACA,SAASA,EAAK;EACd,IAAI,WAAW;GACb,OAAOA,EAAK;EACd;EACA,OAAOA,EAAK;EACZ;EACA,IAAI,QAAQ;GACV,OAAOA,EAAK,MAAM;EACpB;EACA,IAAI,SAAS;GACX,OAAOA,EAAK,OAAO;EACrB;EACA,KAAKA,EAAK;GACT,OAAO,qBAAqBA,EAAK,MAAM,CAAC,CAAC;GACzC,OAAO,UAAUA,EAAK;CACzB;AACF"}
|
package/dist/_timers.cjs.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"_timers.cjs","names":[],"sources":["../src/_timers.ts"],"sourcesContent":["/**\n * Node compatibility helper: `unref()`s a timer so a pending per-task timeout/watchdog does not\n * keep a Node event loop (e.g. a Worker polyfill) alive. Browsers return a plain number from\n * `setTimeout`/`setInterval`, so this is a no-op there.\n *\n * Not part of the public API surface.\n */\nexport function unrefTimer(timer: ReturnType<typeof setTimeout> | ReturnType<typeof setInterval>): void {\n if (typeof timer === 'object' && timer !== null && 'unref' in timer) {\n (timer as { unref(): void }).unref();\n }\n}\n"],"mappings":"AAOA,SAAgB,WAAW,EAA6E,CAClG,
|
|
1
|
+
{"version":3,"file":"_timers.cjs","names":["timer"],"sources":["../src/_timers.ts"],"sourcesContent":["/**\n * Node compatibility helper: `unref()`s a timer so a pending per-task timeout/watchdog does not\n * keep a Node event loop (e.g. a Worker polyfill) alive. Browsers return a plain number from\n * `setTimeout`/`setInterval`, so this is a no-op there.\n *\n * Not part of the public API surface.\n */\nexport function unrefTimer(timer: ReturnType<typeof setTimeout> | ReturnType<typeof setInterval>): void {\n if (typeof timer === 'object' && timer !== null && 'unref' in timer) {\n (timer as { unref(): void }).unref();\n }\n}\n"],"mappings":"AAOA,SAAgB,WAAW,EAA6E,CAClG,OAAOA,GAAU,UAAYA,GAAkB,UAAWA,GAC5DA,EAA6B,MAAM,CAEvC,C"}
|
package/dist/_timers.js
CHANGED
|
@@ -1,2 +1,8 @@
|
|
|
1
|
-
|
|
1
|
+
//#region src/_timers.ts
|
|
2
|
+
function unrefTimer(e) {
|
|
3
|
+
typeof e == "object" && e && "unref" in e && e.unref();
|
|
4
|
+
}
|
|
5
|
+
//#endregion
|
|
6
|
+
export { unrefTimer };
|
|
7
|
+
|
|
2
8
|
//# sourceMappingURL=_timers.js.map
|
package/dist/_timers.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"_timers.js","names":[],"sources":["../src/_timers.ts"],"sourcesContent":["/**\n * Node compatibility helper: `unref()`s a timer so a pending per-task timeout/watchdog does not\n * keep a Node event loop (e.g. a Worker polyfill) alive. Browsers return a plain number from\n * `setTimeout`/`setInterval`, so this is a no-op there.\n *\n * Not part of the public API surface.\n */\nexport function unrefTimer(timer: ReturnType<typeof setTimeout> | ReturnType<typeof setInterval>): void {\n if (typeof timer === 'object' && timer !== null && 'unref' in timer) {\n (timer as { unref(): void }).unref();\n }\n}\n"],"mappings":"AAOA,SAAgB,WAAW,
|
|
1
|
+
{"version":3,"file":"_timers.js","names":["timer"],"sources":["../src/_timers.ts"],"sourcesContent":["/**\n * Node compatibility helper: `unref()`s a timer so a pending per-task timeout/watchdog does not\n * keep a Node event loop (e.g. a Worker polyfill) alive. Browsers return a plain number from\n * `setTimeout`/`setInterval`, so this is a no-op there.\n *\n * Not part of the public API surface.\n */\nexport function unrefTimer(timer: ReturnType<typeof setTimeout> | ReturnType<typeof setInterval>): void {\n if (typeof timer === 'object' && timer !== null && 'unref' in timer) {\n (timer as { unref(): void }).unref();\n }\n}\n"],"mappings":";AAOA,SAAgB,WAAW,GAA6E;CACtG,AAAI,OAAOA,KAAU,YAAYA,KAAkB,WAAWA,KAC5DA,EAA6B,MAAM;AAEvC"}
|
package/dist/errors.cjs.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"errors.cjs","names":[],"sources":["../src/errors.ts"],"sourcesContent":["/** Base class for all familiar errors. Use `instanceof FamiliarError` to catch any familiar-originated error. */\nexport class FamiliarError extends Error {\n constructor(message: string, opts?: ErrorOptions) {\n super(message, opts);\n this.name = new.target.name;\n Object.setPrototypeOf(this, new.target.prototype);\n }\n}\n\n/** Thrown when invalid options are passed to a Familiar pool factory. */\nexport class FamiliarInvalidOptionsError extends FamiliarError {}\n\n/** Thrown when run() is called and the queue is full (`onFull='reject'`). */\nexport class FamiliarQueueFullError extends FamiliarError {\n /** The configured `maxQueue` value. */\n readonly maxQueue: number;\n\n constructor(maxQueue: number) {\n super(`Queue is full (maxQueue=${maxQueue})`);\n this.maxQueue = maxQueue;\n }\n}\n\n/** Thrown when the task function throws. The original error is available as `.cause`. */\nexport class FamiliarTaskError extends FamiliarError {}\n\n/** Thrown when a task or operation is rejected because the worker was terminated. */\nexport class FamiliarTerminatedError extends FamiliarError {\n constructor(message = 'Worker was terminated') {\n super(message);\n }\n}\n\n/** Thrown when a task exceeds its timeout or `drain()` times out. */\nexport class FamiliarTimeoutError extends FamiliarError {\n /** The configured timeout in milliseconds. */\n readonly timeoutMs: number;\n\n constructor(timeoutMs: number, operation = 'Task') {\n super(`${operation} timed out after ${timeoutMs}ms`);\n this.timeoutMs = timeoutMs;\n }\n}\n\n/** Thrown when the Worker API is unavailable or an unhandled error occurs in the worker thread. */\nexport class FamiliarRuntimeError extends FamiliarError {}\n"],"mappings":"AACA,IAAa,cAAb,cAAmC,KAAM,CACvC,YAAY,EAAiB,EAAqB,CAChD,
|
|
1
|
+
{"version":3,"file":"errors.cjs","names":["message","opts","maxQueue","operation","timeoutMs"],"sources":["../src/errors.ts"],"sourcesContent":["/** Base class for all familiar errors. Use `instanceof FamiliarError` to catch any familiar-originated error. */\nexport class FamiliarError extends Error {\n constructor(message: string, opts?: ErrorOptions) {\n super(message, opts);\n this.name = new.target.name;\n Object.setPrototypeOf(this, new.target.prototype);\n }\n}\n\n/** Thrown when invalid options are passed to a Familiar pool factory. */\nexport class FamiliarInvalidOptionsError extends FamiliarError {}\n\n/** Thrown when run() is called and the queue is full (`onFull='reject'`). */\nexport class FamiliarQueueFullError extends FamiliarError {\n /** The configured `maxQueue` value. */\n readonly maxQueue: number;\n\n constructor(maxQueue: number) {\n super(`Queue is full (maxQueue=${maxQueue})`);\n this.maxQueue = maxQueue;\n }\n}\n\n/** Thrown when the task function throws. The original error is available as `.cause`. */\nexport class FamiliarTaskError extends FamiliarError {}\n\n/** Thrown when a task or operation is rejected because the worker was terminated. */\nexport class FamiliarTerminatedError extends FamiliarError {\n constructor(message = 'Worker was terminated') {\n super(message);\n }\n}\n\n/** Thrown when a task exceeds its timeout or `drain()` times out. */\nexport class FamiliarTimeoutError extends FamiliarError {\n /** The configured timeout in milliseconds. */\n readonly timeoutMs: number;\n\n constructor(timeoutMs: number, operation = 'Task') {\n super(`${operation} timed out after ${timeoutMs}ms`);\n this.timeoutMs = timeoutMs;\n }\n}\n\n/** Thrown when the Worker API is unavailable or an unhandled error occurs in the worker thread. */\nexport class FamiliarRuntimeError extends FamiliarError {}\n"],"mappings":"AACA,IAAa,cAAb,cAAmC,KAAM,CACvC,YAAY,EAAiB,EAAqB,CAChD,MAAMA,EAASC,CAAI,EACnB,KAAK,KAAO,WAAW,KACvB,OAAO,eAAe,KAAM,WAAW,SAAS,CAClD,CACF,EAGa,4BAAb,cAAiD,aAAc,CAAC,EAGnD,uBAAb,cAA4C,aAAc,CAExD,SAEA,YAAY,EAAkB,CAC5B,MAAM,2BAA2BC,EAAS,EAAE,EAC5C,KAAK,SAAWA,CAClB,CACF,EAGa,kBAAb,cAAuC,aAAc,CAAC,EAGzC,wBAAb,cAA6C,aAAc,CACzD,YAAY,EAAU,wBAAyB,CAC7C,MAAMF,CAAO,CACf,CACF,EAGa,qBAAb,cAA0C,aAAc,CAEtD,UAEA,YAAY,EAAmB,EAAY,OAAQ,CACjD,MAAM,GAAGG,EAAU,mBAAmBC,EAAU,GAAG,EACnD,KAAK,UAAYA,CACnB,CACF,EAGa,qBAAb,cAA0C,aAAc,CAAC,E"}
|
package/dist/errors.js
CHANGED
|
@@ -1,2 +1,24 @@
|
|
|
1
|
-
|
|
1
|
+
//#region src/errors.ts
|
|
2
|
+
var FamiliarError = class extends Error {
|
|
3
|
+
constructor(e, t) {
|
|
4
|
+
super(e, t), this.name = new.target.name, Object.setPrototypeOf(this, new.target.prototype);
|
|
5
|
+
}
|
|
6
|
+
}, FamiliarInvalidOptionsError = class extends FamiliarError {}, FamiliarQueueFullError = class extends FamiliarError {
|
|
7
|
+
maxQueue;
|
|
8
|
+
constructor(e) {
|
|
9
|
+
super(`Queue is full (maxQueue=${e})`), this.maxQueue = e;
|
|
10
|
+
}
|
|
11
|
+
}, FamiliarTaskError = class extends FamiliarError {}, FamiliarTerminatedError = class extends FamiliarError {
|
|
12
|
+
constructor(e = "Worker was terminated") {
|
|
13
|
+
super(e);
|
|
14
|
+
}
|
|
15
|
+
}, FamiliarTimeoutError = class extends FamiliarError {
|
|
16
|
+
timeoutMs;
|
|
17
|
+
constructor(e, t = "Task") {
|
|
18
|
+
super(`${t} timed out after ${e}ms`), this.timeoutMs = e;
|
|
19
|
+
}
|
|
20
|
+
}, FamiliarRuntimeError = class extends FamiliarError {};
|
|
21
|
+
//#endregion
|
|
22
|
+
export { FamiliarError, FamiliarInvalidOptionsError, FamiliarQueueFullError, FamiliarRuntimeError, FamiliarTaskError, FamiliarTerminatedError, FamiliarTimeoutError };
|
|
23
|
+
|
|
2
24
|
//# sourceMappingURL=errors.js.map
|
package/dist/errors.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"errors.js","names":[],"sources":["../src/errors.ts"],"sourcesContent":["/** Base class for all familiar errors. Use `instanceof FamiliarError` to catch any familiar-originated error. */\nexport class FamiliarError extends Error {\n constructor(message: string, opts?: ErrorOptions) {\n super(message, opts);\n this.name = new.target.name;\n Object.setPrototypeOf(this, new.target.prototype);\n }\n}\n\n/** Thrown when invalid options are passed to a Familiar pool factory. */\nexport class FamiliarInvalidOptionsError extends FamiliarError {}\n\n/** Thrown when run() is called and the queue is full (`onFull='reject'`). */\nexport class FamiliarQueueFullError extends FamiliarError {\n /** The configured `maxQueue` value. */\n readonly maxQueue: number;\n\n constructor(maxQueue: number) {\n super(`Queue is full (maxQueue=${maxQueue})`);\n this.maxQueue = maxQueue;\n }\n}\n\n/** Thrown when the task function throws. The original error is available as `.cause`. */\nexport class FamiliarTaskError extends FamiliarError {}\n\n/** Thrown when a task or operation is rejected because the worker was terminated. */\nexport class FamiliarTerminatedError extends FamiliarError {\n constructor(message = 'Worker was terminated') {\n super(message);\n }\n}\n\n/** Thrown when a task exceeds its timeout or `drain()` times out. */\nexport class FamiliarTimeoutError extends FamiliarError {\n /** The configured timeout in milliseconds. */\n readonly timeoutMs: number;\n\n constructor(timeoutMs: number, operation = 'Task') {\n super(`${operation} timed out after ${timeoutMs}ms`);\n this.timeoutMs = timeoutMs;\n }\n}\n\n/** Thrown when the Worker API is unavailable or an unhandled error occurs in the worker thread. */\nexport class FamiliarRuntimeError extends FamiliarError {}\n"],"mappings":"AACA,IAAa,
|
|
1
|
+
{"version":3,"file":"errors.js","names":["message","opts","maxQueue","operation","timeoutMs"],"sources":["../src/errors.ts"],"sourcesContent":["/** Base class for all familiar errors. Use `instanceof FamiliarError` to catch any familiar-originated error. */\nexport class FamiliarError extends Error {\n constructor(message: string, opts?: ErrorOptions) {\n super(message, opts);\n this.name = new.target.name;\n Object.setPrototypeOf(this, new.target.prototype);\n }\n}\n\n/** Thrown when invalid options are passed to a Familiar pool factory. */\nexport class FamiliarInvalidOptionsError extends FamiliarError {}\n\n/** Thrown when run() is called and the queue is full (`onFull='reject'`). */\nexport class FamiliarQueueFullError extends FamiliarError {\n /** The configured `maxQueue` value. */\n readonly maxQueue: number;\n\n constructor(maxQueue: number) {\n super(`Queue is full (maxQueue=${maxQueue})`);\n this.maxQueue = maxQueue;\n }\n}\n\n/** Thrown when the task function throws. The original error is available as `.cause`. */\nexport class FamiliarTaskError extends FamiliarError {}\n\n/** Thrown when a task or operation is rejected because the worker was terminated. */\nexport class FamiliarTerminatedError extends FamiliarError {\n constructor(message = 'Worker was terminated') {\n super(message);\n }\n}\n\n/** Thrown when a task exceeds its timeout or `drain()` times out. */\nexport class FamiliarTimeoutError extends FamiliarError {\n /** The configured timeout in milliseconds. */\n readonly timeoutMs: number;\n\n constructor(timeoutMs: number, operation = 'Task') {\n super(`${operation} timed out after ${timeoutMs}ms`);\n this.timeoutMs = timeoutMs;\n }\n}\n\n/** Thrown when the Worker API is unavailable or an unhandled error occurs in the worker thread. */\nexport class FamiliarRuntimeError extends FamiliarError {}\n"],"mappings":";AACA,IAAa,gBAAb,cAAmC,MAAM;CACvC,YAAY,GAAiB,GAAqB;EAGhD,AAFA,MAAMA,GAASC,CAAI,GACnB,KAAK,OAAO,WAAW,MACvB,OAAO,eAAe,MAAM,WAAW,SAAS;CAClD;AACF,GAGa,8BAAb,cAAiD,cAAc,CAAC,GAGnD,yBAAb,cAA4C,cAAc;CAExD;CAEA,YAAY,GAAkB;EAE5B,AADA,MAAM,2BAA2BC,EAAS,EAAE,GAC5C,KAAK,WAAWA;CAClB;AACF,GAGa,oBAAb,cAAuC,cAAc,CAAC,GAGzC,0BAAb,cAA6C,cAAc;CACzD,YAAY,IAAU,yBAAyB;EAC7C,MAAMF,CAAO;CACf;AACF,GAGa,uBAAb,cAA0C,cAAc;CAEtD;CAEA,YAAY,GAAmB,IAAY,QAAQ;EAEjD,AADA,MAAM,GAAGG,EAAU,mBAAmBC,EAAU,GAAG,GACnD,KAAK,YAAYA;CACnB;AACF,GAGa,uBAAb,cAA0C,cAAc,CAAC"}
|
package/dist/familiar.cjs
CHANGED
|
@@ -1,2 +1,2 @@
|
|
|
1
|
-
Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});let e=require("@vielzeug/arsenal");function unrefTimer(e){typeof e==`object`&&e&&`unref`in e&&e.unref()}var FamiliarError=class extends Error{constructor(e,t){super(e,t),this.name=new.target.name,Object.setPrototypeOf(this,new.target.prototype)}},FamiliarInvalidOptionsError=class extends FamiliarError{},FamiliarQueueFullError=class extends FamiliarError{maxQueue;constructor(e){super(`Queue is full (maxQueue=${e})`),this.maxQueue=e}},FamiliarTaskError=class extends FamiliarError{},FamiliarTerminatedError=class extends FamiliarError{constructor(e=`Worker was terminated`){super(e)}},FamiliarTimeoutError=class extends FamiliarError{timeoutMs;constructor(e,t=`Task`){super(`${t} timed out after ${e}ms`),this.timeoutMs=e}},FamiliarRuntimeError=class extends FamiliarError{},t=2147483647;function validatePriority(e){if(!Number.isFinite(e))throw new FamiliarInvalidOptionsError("`priority` must be a finite number");return e}function validateTimeout(e,n=`timeout`){if(e!==void 0&&(!Number.isInteger(e)||e<1||e>2147483647))throw new FamiliarInvalidOptionsError(`\`${n}\` must be an integer from 1 through ${t}`);return e}function createPoolCore(t,n){let r=[...t],i=[],a=[],o=[],s=(0,e.tapper)(),c=new AbortController,l=0,u=0,d=0,f=0,p=0,m,h=!1;function isIdle(){return r.length===t.length&&i.length===0}function settleIdle(){if(isIdle())for(let e of a.splice(0))e.timer&&clearTimeout(e.timer),e.resolve()}function waitForIdle(e){return isIdle()?Promise.resolve():new Promise((t,n)=>{let r={reject:n,resolve:t};e.timeout!==void 0&&(r.timer=setTimeout(()=>{let t=a.indexOf(r);t!==-1&&a.splice(t,1),n(new FamiliarTimeoutError(e.timeout,`Drain`))},e.timeout),unrefTimer(r.timer)),a.push(r)})}function releaseCapacity(){o.shift()?.resolve()}function rejectCapacity(e){for(let t of o.splice(0))t.reject(e)}function waitForCapacity(t,n){return t?.aborted?Promise.reject((0,e.abortError)(t)):new Promise((r,i)=>{let a=!1,s={cleanup(){t?.removeEventListener(`abort`,onAbort)},priority:n,reject(e){if(a)return;a=!0,s.cleanup();let t=o.indexOf(s);t!==-1&&o.splice(t,1),i(e)},resolve(){a||(a=!0,s.cleanup(),r())},sequence:d++},onAbort=()=>s.reject((0,e.abortError)(t));t?.addEventListener(`abort`,onAbort,{once:!0}),o.push(s),o.sort((e,t)=>t.priority-e.priority||e.sequence-t.sequence)})}function acquire(t,r){let{priority:a,signal:o}=t;return o?.aborted?Promise.reject((0,e.abortError)(o)):(async()=>{for(;;){if(h)throw new FamiliarTerminatedError;if(m)throw new FamiliarTerminatedError(`Worker is draining`);if(n.maxQueue===void 0||i.length<n.maxQueue)return admit(t,r??(e=>e));if(n.onFull===`reject`)throw new FamiliarQueueFullError(n.maxQueue);if(await waitForCapacity(o,a),o?.aborted)throw releaseCapacity(),(0,e.abortError)(o)}})()}function admit(t,n){let{priority:a,signal:o}=t,s=r.pop();if(s)try{return Promise.resolve(n(s))}catch(e){return release(s),settleIdle(),Promise.reject(e)}return new Promise((t,r)=>{let s={cleanup(){s.signal?.removeEventListener(`abort`,onAbort)},priority:a,reject(e){s.cleanup();let t=i.indexOf(s);t!==-1&&(i.splice(t,1),releaseCapacity()),r(e),settleIdle()},sequence:u++,signal:o,start(e){s.cleanup();try{t(n(e))}catch(t){release(e),settleIdle(),r(t)}}},onAbort=()=>s.reject((0,e.abortError)(s.signal));s.signal?.addEventListener(`abort`,onAbort,{once:!0}),i.push(s),i.sort((e,t)=>t.priority-e.priority||e.sequence-t.sequence)})}function release(e){let t=i.shift();t?(t.start(e),releaseCapacity()):r.push(e)}function dispose(){if(!h){h=!0,c.abort();for(let e of t)e.terminate();for(let e of i.splice(0))e.reject(new FamiliarTerminatedError);rejectCapacity(new FamiliarTerminatedError),settleIdle(),s.emit({type:`dispose`}),s.clear()}}function drain(e={}){if(h)return Promise.resolve();try{validateTimeout(e.timeout,`drain.timeout`)}catch(e){return Promise.reject(e)}return m||(rejectCapacity(new FamiliarTerminatedError(`Worker is draining`)),m=waitForIdle(e).then(()=>dispose(),e=>{throw dispose(),e}),m)}return{acquire,disposalSignal:c.signal,dispose,get disposed(){return h},drain,get drainPromise(){return m},emitTap(e){s.emit(e)},release,settleIdle,stats(){return{active:l,completed:f,failed:p,queued:i.length+o.length}},status(){return h?`terminated`:l===0?`idle`:`running`},tap(e,t){return h?()=>void 0:s.tap(e,t)},trackActive(e){l+=e},trackCompleted(){f+=1},trackFailed(){p+=1}}}function createPool(t,n){let r=createPoolCore(t,n);for(let e of t)e.notify=e=>r.emitTap({error:e,type:`worker-error`});function run(t,i={}){let a,o,s;try{a=validatePriority(i.priority??0),o=validateTimeout(i.timeout)??n.defaultTimeout,s=[...i.transferables??[]]}catch(e){return Promise.reject(e)}return r.acquire({priority:a,signal:i.signal},n=>{r.trackActive(1);let onAbort=()=>n.cancel((0,e.abortError)(i.signal));i.signal?.addEventListener(`abort`,onAbort,{once:!0});let finish=async()=>{try{let e=await n.run(t,s,o);return r.trackCompleted(),e}catch(e){throw!i.signal?.aborted&&!(e instanceof FamiliarTerminatedError)&&r.trackFailed(),e}finally{i.signal?.removeEventListener(`abort`,onAbort),r.trackActive(-1),r.release(n),r.settleIdle()}};return finish()})}return{get disposalSignal(){return r.disposalSignal},dispose:r.dispose,get disposed(){return r.disposed},drain:r.drain,run,get stats(){return r.stats()},get status(){return r.status()},tap:r.tap,[Symbol.asyncDispose]:()=>r.drain({}),[Symbol.dispose]:r.dispose}}function runBatch(t,n,r={}){let i,iterate=async function*(i){let a=[],onAbort=()=>i.abort(r.signal?.reason);r.signal?.aborted?i.abort(r.signal.reason):r.signal?.addEventListener(`abort`,onAbort,{once:!0});try{for(let[e,o]of n.entries()){let n=t.run(o,{priority:r.priority,signal:i.signal,timeout:r.timeout,transferables:r.getTransferables?.(o,e)}).catch(e=>{throw i.abort(e),e});n.catch(()=>void 0),a.push(n)}if(a.length===0&&i.signal.aborted)throw(0,e.abortError)(i.signal);for(let t of a){if(i.signal.aborted)throw(0,e.abortError)(i.signal);let n=await t;if(i.signal.aborted)throw(0,e.abortError)(i.signal);yield n}}catch(e){throw i.abort(e),e}finally{r.signal?.removeEventListener(`abort`,onAbort),i.abort(new DOMException(`Batch consumer stopped`,`AbortError`)),await Promise.allSettled(a)}};return{[Symbol.asyncIterator](){let e={},t=new AbortController,n,start=()=>{if(i??=e,i===e)return n??=iterate(t),n};return{next:()=>start()?.next()??Promise.reject(new FamiliarRuntimeError(`Worker batches can only be consumed once`)),return:async r=>!i||i!==e?{done:!0,value:r}:(t.abort(new FamiliarTerminatedError(`Batch consumer stopped`)),n?.return(r)??{done:!0,value:r}),throw:async e=>{let n=start();if(!n)throw new FamiliarRuntimeError(`Worker batches can only be consumed once`);return t.abort(e),n.throw(e)}}}}}function createStreamPool(t,n){let r=createPoolCore(t,n);for(let e of t)e.notify=e=>r.emitTap({error:e,type:`worker-error`});function runStream(t,i={}){let a=validatePriority(i.priority??0),o=validateTimeout(i.timeout)??n.defaultTimeout,s=[...i.transferables??[]],c,iterate=async function*(n){let onAbort=()=>n.abort(i.signal?.reason),c,onCancel;i.signal?.aborted?n.abort(i.signal.reason):i.signal?.addEventListener(`abort`,onAbort,{once:!0});try{let i=await r.acquire({priority:a,signal:n.signal},i=>(c=i,r.trackActive(1),onCancel=()=>c?.cancel((0,e.abortError)(n.signal)),n.signal.addEventListener(`abort`,onCancel,{once:!0}),i.stream(t,{priority:a,signal:n.signal,timeout:o,transferables:s})));for await(let e of i.iterable)yield e;await i.done,r.trackCompleted()}catch(e){throw c&&!n.signal.aborted&&!(e instanceof FamiliarTerminatedError)&&r.trackFailed(),e}finally{i.signal?.removeEventListener(`abort`,onAbort),c&&(onCancel&&n.signal.removeEventListener(`abort`,onCancel),r.trackActive(-1),r.release(c),r.settleIdle())}};return{[Symbol.asyncIterator](){let e={},t=new AbortController,n,start=()=>{if(c??=e,c===e)return n??=iterate(t),n};return{next:()=>start()?.next()??Promise.reject(new FamiliarRuntimeError(`Worker streams can only be consumed once`)),return:async r=>!c||c!==e?{done:!0,value:r}:(t.abort(new FamiliarTerminatedError(`Stream consumer stopped`)),n?.return(r)??{done:!0,value:r}),throw:async e=>{let n=start();if(!n)throw new FamiliarRuntimeError(`Worker streams can only be consumed once`);return t.abort(e),n.throw(e)}}}}}return{get disposalSignal(){return r.disposalSignal},dispose:r.dispose,get disposed(){return r.disposed},drain:r.drain,runStream,get stats(){return r.stats()},get status(){return r.status()},tap:r.tap,[Symbol.asyncDispose]:()=>r.drain({}),[Symbol.dispose]:r.dispose}}function resolveOptions(e={}){let{concurrency:t=1,maxQueue:n,onFull:r=`reject`,timeout:i}=e,a=t===`auto`?Math.min(512,Math.max(1,globalThis.navigator?.hardwareConcurrency??1)):t;if(!Number.isInteger(a)||a<1||a>512)throw new FamiliarInvalidOptionsError('`concurrency` must be a positive integer ≤ 512 or "auto"');if(n!==void 0&&(!Number.isInteger(n)||n<1))throw new FamiliarInvalidOptionsError("`maxQueue` must be a positive integer");if(r!==`reject`&&r!==`wait`)throw new FamiliarInvalidOptionsError('`onFull` must be "reject" or "wait"');return validateTimeout(i),{concurrency:a,maxQueue:n,onFull:r,timeout:i}}function isWorkerResponse(e){if(typeof e!=`object`||!e)return!1;let t=e;return t.version!==1||typeof t.id!=`number`||!Number.isSafeInteger(t.id)||t.id<0?!1:t.kind===`chunk`||t.kind===`result`?`value`in t:t.kind!==`error`||typeof t.error!=`object`||t.error===null?!1:(t.error.category===void 0||t.error.category===`protocol`)&&typeof t.error.message==`string`&&typeof t.error.name==`string`&&(t.error.stack===void 0||typeof t.error.stack==`string`)}function responseError(e){let t=Error(e.message);return t.name=e.name,t.stack=e.stack,e.category===`protocol`?new FamiliarRuntimeError(e.message,{cause:t}):new FamiliarTaskError(e.message,{cause:t})}var Slot=class{#e;#t=!1;#n;#r=0;#i;notify=void 0;constructor(e){this.#e=e}cancel(e){this.#n&&(this.#s(),this.#u(`reject`,e))}run(e,t,n){return this.#a(e,t,n,`run`)}stream(e,t){let stop=()=>this.cancel(new FamiliarTerminatedError(`Stream consumer stopped`)),n=[],r=[],i=!1,a,emit=e=>{let t=r.shift();t?t({done:!1,value:e}):n.push(e)},finish=e=>{for(i=!0,a=e;r.length>0;)r.shift()(e===void 0?{done:!0,value:void 0}:Promise.reject(e))};return{done:this.#a(e,[...t.transferables??[]],t.timeout,`stream`,emit).then(()=>finish(),e=>finish(e)),iterable:{[Symbol.asyncIterator]:()=>({async next(){if(n.length>0)return{done:!1,value:n.shift()};if(a!==void 0)throw a;return i?{done:!0,value:void 0}:new Promise((e,t)=>{r.push(n=>{n instanceof Promise?n.then(e,t):e(n)})})},async return(){return stop(),{done:!0,value:void 0}}})}}}terminate(){this.#t=!0,this.#s(),this.#u(`reject`,new FamiliarTerminatedError)}#a(e,t,n,r,i){if(this.#t)return Promise.reject(new FamiliarTerminatedError);if(this.#n)return Promise.reject(new FamiliarRuntimeError(`Worker slot is already busy`));try{let a=this.#o(),o=this.#r;return this.#r=o===2**53-1?0:o+1,new Promise((s,c)=>{let l={emit:i,id:o,kind:r,reject:c,resolve:s};this.#n=l,n!==void 0&&(l.timer=setTimeout(()=>this.cancel(new FamiliarTimeoutError(n)),n),unrefTimer(l.timer));try{a.postMessage({id:o,input:e,kind:r,version:1},t)}catch(e){this.cancel(new FamiliarRuntimeError(`Failed to post message to worker`,{cause:e}))}})}catch(e){return Promise.reject(e)}}#o(){if(this.#i)return this.#i;if(typeof Worker>`u`)throw new FamiliarRuntimeError(`Worker API is unavailable in this runtime`);try{let e=new Worker(this.#e,{type:`module`});return e.onmessage=t=>{this.#i===e&&this.#l(t.data)},e.onerror=t=>this.#c(e,new FamiliarRuntimeError(t.message||`Worker failed`)),e.onmessageerror=()=>this.#c(e,new FamiliarRuntimeError(`Worker response could not be deserialized`)),this.#i=e,e}catch(e){throw new FamiliarRuntimeError(`Failed to create Worker`,{cause:e})}}#s(){let e=this.#i;this.#i=void 0,e&&(e.onmessage=null,e.onerror=null,e.onmessageerror=null,e.terminate())}#c(e,t){this.#i===e&&(this.#s(),this.#u(`reject`,t),this.notify?.(t))}#l(e){if(this.#n){if(!isWorkerResponse(e)||e.id!==this.#n.id||this.#n.kind===`run`&&e.kind===`chunk`){this.cancel(new FamiliarRuntimeError(`Worker returned an incompatible protocol response`));return}if(e.kind===`chunk`){this.#n.emit?.(e.value);return}if(e.kind===`error`){this.#u(`reject`,responseError(e.error));return}this.#u(`resolve`,e.value)}}#u(e,t){let n=this.#n;n&&(this.#n=void 0,n.timer&&clearTimeout(n.timer),e===`resolve`?n.resolve(t):n.reject(t))}};function slots(e,t){let n=typeof e==`string`?e:e.href;return Array.from({length:t.concurrency},()=>new Slot(n))}function createWorker(e,t={}){let n=resolveOptions(t);return createPool(slots(e,n),{defaultTimeout:n.timeout,maxQueue:n.maxQueue,onFull:n.onFull})}function createStreamWorker(e,t={}){let n=resolveOptions(t);return createStreamPool(slots(e,n),{defaultTimeout:n.timeout,maxQueue:n.maxQueue,onFull:n.onFull})}exports.FamiliarError=FamiliarError,exports.FamiliarInvalidOptionsError=FamiliarInvalidOptionsError,exports.FamiliarQueueFullError=FamiliarQueueFullError,exports.FamiliarRuntimeError=FamiliarRuntimeError,exports.FamiliarTaskError=FamiliarTaskError,exports.FamiliarTerminatedError=FamiliarTerminatedError,exports.FamiliarTimeoutError=FamiliarTimeoutError,exports.createStreamWorker=createStreamWorker,exports.createWorker=createWorker,exports.runBatch=runBatch;
|
|
1
|
+
Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});let e=require("@vielzeug/arsenal");function unrefTimer(e){typeof e==`object`&&e&&`unref`in e&&e.unref()}var FamiliarError=class extends Error{constructor(e,t){super(e,t),this.name=new.target.name,Object.setPrototypeOf(this,new.target.prototype)}},FamiliarInvalidOptionsError=class extends FamiliarError{},FamiliarQueueFullError=class extends FamiliarError{maxQueue;constructor(e){super(`Queue is full (maxQueue=${e})`),this.maxQueue=e}},FamiliarTaskError=class extends FamiliarError{},FamiliarTerminatedError=class extends FamiliarError{constructor(e=`Worker was terminated`){super(e)}},FamiliarTimeoutError=class extends FamiliarError{timeoutMs;constructor(e,t=`Task`){super(`${t} timed out after ${e}ms`),this.timeoutMs=e}},FamiliarRuntimeError=class extends FamiliarError{},t=2147483647;function validatePriority(e){if(!Number.isFinite(e))throw new FamiliarInvalidOptionsError("`priority` must be a finite number");return e}function validateTimeout(e,n=`timeout`){if(e!==void 0&&(!Number.isInteger(e)||e<1||e>2147483647))throw new FamiliarInvalidOptionsError(`\`${n}\` must be an integer from 1 through ${t}`);return e}function createPoolCore(t,n){let r=[...t],i=[],a=[],o=[],s=(0,e.tapper)(),c=new AbortController,l=0,u=0,d=0,f=0,p=0,m,h=!1;function isIdle(){return r.length===t.length&&i.length===0}function settleIdle(){if(isIdle())for(let e of a.splice(0))e.timer&&clearTimeout(e.timer),e.resolve()}function waitForIdle(e){return isIdle()?Promise.resolve():new Promise((t,n)=>{let r={reject:n,resolve:t};e.timeout!==void 0&&(r.timer=setTimeout(()=>{let t=a.indexOf(r);t!==-1&&a.splice(t,1),n(new FamiliarTimeoutError(e.timeout,`Drain`))},e.timeout),unrefTimer(r.timer)),a.push(r)})}function releaseCapacity(){o.shift()?.resolve()}function rejectCapacity(e){for(let t of o.splice(0))t.reject(e)}function waitForCapacity(t,n){return t?.aborted?Promise.reject((0,e.abortError)(t)):new Promise((r,i)=>{let a=!1,s={cleanup(){t?.removeEventListener(`abort`,onAbort)},priority:n,reject(e){if(a)return;a=!0,s.cleanup();let t=o.indexOf(s);t!==-1&&o.splice(t,1),i(e)},resolve(){a||(a=!0,s.cleanup(),r())},sequence:d++},onAbort=()=>s.reject((0,e.abortError)(t));t?.addEventListener(`abort`,onAbort,{once:!0}),o.push(s),o.sort((e,t)=>t.priority-e.priority||e.sequence-t.sequence)})}function acquire(t,r){let{priority:a,signal:o}=t;return o?.aborted?Promise.reject((0,e.abortError)(o)):(async()=>{for(;;){if(h)throw new FamiliarTerminatedError;if(m)throw new FamiliarTerminatedError(`Worker is draining`);if(n.maxQueue===void 0||i.length<n.maxQueue)return admit(t,r??(e=>e));if(n.onFull===`reject`)throw new FamiliarQueueFullError(n.maxQueue);if(await waitForCapacity(o,a),o?.aborted)throw releaseCapacity(),(0,e.abortError)(o)}})()}function admit(t,n){let{priority:a,signal:o}=t,s=r.pop();if(s)try{return Promise.resolve(n(s))}catch(e){return release(s),settleIdle(),Promise.reject(e)}return new Promise((t,r)=>{let s={cleanup(){s.signal?.removeEventListener(`abort`,onAbort)},priority:a,reject(e){s.cleanup();let t=i.indexOf(s);t!==-1&&(i.splice(t,1),releaseCapacity()),r(e),settleIdle()},sequence:u++,signal:o,start(e){s.cleanup();try{t(n(e))}catch(t){release(e),settleIdle(),r(t)}}},onAbort=()=>s.reject((0,e.abortError)(s.signal));s.signal?.addEventListener(`abort`,onAbort,{once:!0}),i.push(s),i.sort((e,t)=>t.priority-e.priority||e.sequence-t.sequence)})}function release(e){let t=i.shift();t?(t.start(e),releaseCapacity()):r.push(e)}function dispose(){if(!h){h=!0,c.abort();for(let e of t)e.terminate();for(let e of i.splice(0))e.reject(new FamiliarTerminatedError);rejectCapacity(new FamiliarTerminatedError),settleIdle(),s.emit({type:`dispose`}),s.clear()}}function drain(e={}){if(h)return Promise.resolve();try{validateTimeout(e.timeout,`drain.timeout`)}catch(e){return Promise.reject(e)}return m||(rejectCapacity(new FamiliarTerminatedError(`Worker is draining`)),m=waitForIdle(e).then(()=>dispose(),e=>{throw dispose(),e}),m)}return{acquire,disposalSignal:c.signal,dispose,get disposed(){return h},drain,get drainPromise(){return m},emitTap(e){s.emit(e)},release,settleIdle,stats(){return{active:l,completed:f,failed:p,queued:i.length+o.length}},status(){return h?`terminated`:l===0?`idle`:`running`},tap(e,t){return h?()=>void 0:s.tap(e,t)},trackActive(e){l+=e},trackCompleted(){f+=1},trackFailed(){p+=1}}}function createPool(t,n){let r=createPoolCore(t,n);for(let e of t)e.notify=e=>r.emitTap({error:e,type:`worker-error`});function run(t,i={}){let a,o,s;try{a=validatePriority(i.priority??0),o=validateTimeout(i.timeout)??n.defaultTimeout,s=[...i.transferables??[]]}catch(e){return Promise.reject(e)}return r.acquire({priority:a,signal:i.signal},n=>{r.trackActive(1);let onAbort=()=>n.cancel((0,e.abortError)(i.signal));i.signal?.addEventListener(`abort`,onAbort,{once:!0});let finish=async()=>{try{let e=await n.run(t,s,o);return r.trackCompleted(),e}catch(e){throw!i.signal?.aborted&&!(e instanceof FamiliarTerminatedError)&&r.trackFailed(),e}finally{i.signal?.removeEventListener(`abort`,onAbort),r.trackActive(-1),r.release(n),r.settleIdle()}};return finish()})}return{get disposalSignal(){return r.disposalSignal},dispose:r.dispose,get disposed(){return r.disposed},drain:r.drain,run,get stats(){return r.stats()},get status(){return r.status()},tap:r.tap,[Symbol.asyncDispose]:()=>r.drain({}),[Symbol.dispose]:r.dispose}}function runBatch(t,n,r={}){let i,iterate=async function*(i){let a=[],onAbort=()=>i.abort(r.signal?.reason);r.signal?.aborted?i.abort(r.signal.reason):r.signal?.addEventListener(`abort`,onAbort,{once:!0});try{for(let[e,o]of n.entries()){let n=t.run(o,{priority:r.priority,signal:i.signal,timeout:r.timeout,transferables:r.getTransferables?.(o,e)}).catch(e=>{throw i.abort(e),e});n.catch(()=>void 0),a.push(n)}if(a.length===0&&i.signal.aborted)throw(0,e.abortError)(i.signal);for(let t of a){if(i.signal.aborted)throw(0,e.abortError)(i.signal);let n=await t;if(i.signal.aborted)throw(0,e.abortError)(i.signal);yield n}}catch(e){throw i.abort(e),e}finally{r.signal?.removeEventListener(`abort`,onAbort),i.abort(new DOMException(`Batch consumer stopped`,`AbortError`)),await Promise.allSettled(a)}};return{[Symbol.asyncIterator](){let e={},t=new AbortController,n,start=()=>{if(i??=e,i===e)return n??=iterate(t),n};return{next:()=>start()?.next()??Promise.reject(new FamiliarRuntimeError(`Worker batches can only be consumed once`)),return:async r=>!i||i!==e?{done:!0,value:r}:(t.abort(new FamiliarTerminatedError(`Batch consumer stopped`)),n?.return(r)??{done:!0,value:r}),throw:async e=>{let n=start();if(!n)throw new FamiliarRuntimeError(`Worker batches can only be consumed once`);return t.abort(e),n.throw(e)}}}}}function createStreamPool(t,n){let r=createPoolCore(t,n);for(let e of t)e.notify=e=>r.emitTap({error:e,type:`worker-error`});function runStream(t,i={}){let a=validatePriority(i.priority??0),o=validateTimeout(i.timeout)??n.defaultTimeout,s=[...i.transferables??[]],c,iterate=async function*(n){let onAbort=()=>n.abort(i.signal?.reason),c,onCancel;i.signal?.aborted?n.abort(i.signal.reason):i.signal?.addEventListener(`abort`,onAbort,{once:!0});try{let i=await r.acquire({priority:a,signal:n.signal},i=>(c=i,r.trackActive(1),onCancel=()=>c?.cancel((0,e.abortError)(n.signal)),n.signal.addEventListener(`abort`,onCancel,{once:!0}),i.stream(t,{priority:a,signal:n.signal,timeout:o,transferables:s})));for await(let e of i.iterable)yield e;await i.done,r.trackCompleted()}catch(e){throw c&&!n.signal.aborted&&!(e instanceof FamiliarTerminatedError)&&r.trackFailed(),e}finally{i.signal?.removeEventListener(`abort`,onAbort),c&&(onCancel&&n.signal.removeEventListener(`abort`,onCancel),r.trackActive(-1),r.release(c),r.settleIdle())}};return{[Symbol.asyncIterator](){let e={},t=new AbortController,n,start=()=>{if(c??=e,c===e)return n??=iterate(t),n};return{next:()=>start()?.next()??Promise.reject(new FamiliarRuntimeError(`Worker streams can only be consumed once`)),return:async r=>!c||c!==e?{done:!0,value:r}:(t.abort(new FamiliarTerminatedError(`Stream consumer stopped`)),n?.return(r)??{done:!0,value:r}),throw:async e=>{let n=start();if(!n)throw new FamiliarRuntimeError(`Worker streams can only be consumed once`);return t.abort(e),n.throw(e)}}}}}return{get disposalSignal(){return r.disposalSignal},dispose:r.dispose,get disposed(){return r.disposed},drain:r.drain,runStream,get stats(){return r.stats()},get status(){return r.status()},tap:r.tap,[Symbol.asyncDispose]:()=>r.drain({}),[Symbol.dispose]:r.dispose}}function resolveOptions(e={}){let{concurrency:t=1,maxQueue:n,onFull:r=`reject`,timeout:i}=e,a=t===`auto`?Math.min(512,Math.max(1,globalThis.navigator?.hardwareConcurrency??1)):t;if(!Number.isInteger(a)||a<1||a>512)throw new FamiliarInvalidOptionsError('`concurrency` must be a positive integer ≤ 512 or "auto"');if(n!==void 0&&(!Number.isInteger(n)||n<1))throw new FamiliarInvalidOptionsError("`maxQueue` must be a positive integer");if(r!==`reject`&&r!==`wait`)throw new FamiliarInvalidOptionsError('`onFull` must be "reject" or "wait"');return validateTimeout(i),{concurrency:a,maxQueue:n,onFull:r,timeout:i}}function isWorkerResponse(e){if(typeof e!=`object`||!e)return!1;let t=e;return t.version!==1||typeof t.id!=`number`||!Number.isSafeInteger(t.id)||t.id<0?!1:t.kind===`chunk`||t.kind===`result`?`value`in t:t.kind!==`error`||typeof t.error!=`object`||t.error===null?!1:(t.error.category===void 0||t.error.category===`protocol`)&&typeof t.error.message==`string`&&typeof t.error.name==`string`&&(t.error.stack===void 0||typeof t.error.stack==`string`)}function responseError(e){let t=Error(e.message);return t.name=e.name,t.stack=e.stack,e.category===`protocol`?new FamiliarRuntimeError(e.message,{cause:t}):new FamiliarTaskError(e.message,{cause:t})}var Slot=class{#e;#t=!1;#n;#r=0;#i;notify=void 0;constructor(e){this.#e=e}cancel(e){this.#n&&(this.#s(),this.#u(`reject`,e))}run(e,t,n){return this.#a(e,t,n,`run`)}stream(e,t){let stop=()=>this.cancel(new FamiliarTerminatedError(`Stream consumer stopped`)),n=[],r=[],i=!1,a,emit=e=>{let t=r.shift();t?t({done:!1,value:e}):n.push(e)},finish=e=>{for(i=!0,a=e;r.length>0;)r.shift()(e===void 0?{done:!0,value:void 0}:Promise.reject(e))};return{done:this.#a(e,[...t.transferables??[]],t.timeout,`stream`,emit).then(()=>finish(),e=>finish(e)),iterable:{[Symbol.asyncIterator]:()=>({async next(){if(n.length>0)return{done:!1,value:n.shift()};if(a!==void 0)throw a;return i?{done:!0,value:void 0}:new Promise((e,t)=>{r.push(n=>{n instanceof Promise?n.then(e,t):e(n)})})},async return(){return stop(),{done:!0,value:void 0}}})}}}terminate(){this.#t=!0,this.#s(),this.#u(`reject`,new FamiliarTerminatedError)}#a(e,t,n,r,i){if(this.#t)return Promise.reject(new FamiliarTerminatedError);if(this.#n)return Promise.reject(new FamiliarRuntimeError(`Worker slot is already busy`));try{let a=this.#o(),o=this.#r;return this.#r=o===2**53-1?0:o+1,new Promise((s,c)=>{let l={emit:i,id:o,kind:r,reject:c,resolve:s};this.#n=l,n!==void 0&&(l.timer=setTimeout(()=>this.cancel(new FamiliarTimeoutError(n)),n),unrefTimer(l.timer));try{a.postMessage({id:o,input:e,kind:r,version:1},t)}catch(e){this.cancel(new FamiliarRuntimeError(`Failed to post message to worker`,{cause:e}))}})}catch(e){return Promise.reject(e)}}#o(){if(this.#i)return this.#i;if(typeof Worker>`u`)throw new FamiliarRuntimeError(`Worker API is unavailable in this runtime`);try{let e=new Worker(this.#e,{type:`module`});return e.onmessage=t=>{this.#i===e&&this.#l(t.data)},e.onerror=t=>this.#c(e,new FamiliarRuntimeError(t.message||`Worker failed`)),e.onmessageerror=()=>this.#c(e,new FamiliarRuntimeError(`Worker response could not be deserialized`)),this.#i=e,e}catch(e){throw new FamiliarRuntimeError(`Failed to create Worker`,{cause:e})}}#s(){let e=this.#i;this.#i=void 0,e&&(e.onmessage=null,e.onerror=null,e.onmessageerror=null,e.terminate())}#c(e,t){this.#i===e&&(this.#s(),this.#u(`reject`,t),this.notify?.(t))}#l(e){this.#n&&(!isWorkerResponse(e)||e.id!==this.#n.id||this.#n.kind===`run`&&e.kind===`chunk`?this.cancel(new FamiliarRuntimeError(`Worker returned an incompatible protocol response`)):e.kind===`chunk`?this.#n.emit?.(e.value):e.kind===`error`?this.#u(`reject`,responseError(e.error)):this.#u(`resolve`,e.value))}#u(e,t){let n=this.#n;n&&(this.#n=void 0,n.timer&&clearTimeout(n.timer),e===`resolve`?n.resolve(t):n.reject(t))}};function slots(e,t){let n=typeof e==`string`?e:e.href;return Array.from({length:t.concurrency},()=>new Slot(n))}function createWorker(e,t={}){let n=resolveOptions(t);return createPool(slots(e,n),{defaultTimeout:n.timeout,maxQueue:n.maxQueue,onFull:n.onFull})}function createStreamWorker(e,t={}){let n=resolveOptions(t);return createStreamPool(slots(e,n),{defaultTimeout:n.timeout,maxQueue:n.maxQueue,onFull:n.onFull})}exports.FamiliarError=FamiliarError,exports.FamiliarInvalidOptionsError=FamiliarInvalidOptionsError,exports.FamiliarQueueFullError=FamiliarQueueFullError,exports.FamiliarRuntimeError=FamiliarRuntimeError,exports.FamiliarTaskError=FamiliarTaskError,exports.FamiliarTerminatedError=FamiliarTerminatedError,exports.FamiliarTimeoutError=FamiliarTimeoutError,exports.createStreamWorker=createStreamWorker,exports.createWorker=createWorker,exports.runBatch=runBatch;
|
|
2
2
|
//# sourceMappingURL=familiar.cjs.map
|
package/dist/familiar.cjs.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"familiar.cjs","names":[],"sources":["../src/_timers.ts","../src/errors.ts","../src/_pool-core.ts","../src/_pool.ts","../src/_stream-pool.ts","../src/worker.ts"],"sourcesContent":["/**\n * Node compatibility helper: `unref()`s a timer so a pending per-task timeout/watchdog does not\n * keep a Node event loop (e.g. a Worker polyfill) alive. Browsers return a plain number from\n * `setTimeout`/`setInterval`, so this is a no-op there.\n *\n * Not part of the public API surface.\n */\nexport function unrefTimer(timer: ReturnType<typeof setTimeout> | ReturnType<typeof setInterval>): void {\n if (typeof timer === 'object' && timer !== null && 'unref' in timer) {\n (timer as { unref(): void }).unref();\n }\n}\n","/** Base class for all familiar errors. Use `instanceof FamiliarError` to catch any familiar-originated error. */\nexport class FamiliarError extends Error {\n constructor(message: string, opts?: ErrorOptions) {\n super(message, opts);\n this.name = new.target.name;\n Object.setPrototypeOf(this, new.target.prototype);\n }\n}\n\n/** Thrown when invalid options are passed to a Familiar pool factory. */\nexport class FamiliarInvalidOptionsError extends FamiliarError {}\n\n/** Thrown when run() is called and the queue is full (`onFull='reject'`). */\nexport class FamiliarQueueFullError extends FamiliarError {\n /** The configured `maxQueue` value. */\n readonly maxQueue: number;\n\n constructor(maxQueue: number) {\n super(`Queue is full (maxQueue=${maxQueue})`);\n this.maxQueue = maxQueue;\n }\n}\n\n/** Thrown when the task function throws. The original error is available as `.cause`. */\nexport class FamiliarTaskError extends FamiliarError {}\n\n/** Thrown when a task or operation is rejected because the worker was terminated. */\nexport class FamiliarTerminatedError extends FamiliarError {\n constructor(message = 'Worker was terminated') {\n super(message);\n }\n}\n\n/** Thrown when a task exceeds its timeout or `drain()` times out. */\nexport class FamiliarTimeoutError extends FamiliarError {\n /** The configured timeout in milliseconds. */\n readonly timeoutMs: number;\n\n constructor(timeoutMs: number, operation = 'Task') {\n super(`${operation} timed out after ${timeoutMs}ms`);\n this.timeoutMs = timeoutMs;\n }\n}\n\n/** Thrown when the Worker API is unavailable or an unhandled error occurs in the worker thread. */\nexport class FamiliarRuntimeError extends FamiliarError {}\n","import { abortError, tapper } from '@vielzeug/arsenal';\nimport { unrefTimer } from './_timers.js';\nimport {\n FamiliarInvalidOptionsError,\n FamiliarQueueFullError,\n type FamiliarRuntimeError,\n FamiliarTerminatedError,\n FamiliarTimeoutError,\n} from './errors.js';\nimport type { DrainOptions, FamiliarTapEvent, WorkerStats, WorkerStatus } from './types.js';\n\nexport const MAX_CONCURRENCY = 512;\nexport const MAX_TIMEOUT = 2_147_483_647;\n\nexport function validatePriority(priority: number): number {\n if (!Number.isFinite(priority)) throw new FamiliarInvalidOptionsError('`priority` must be a finite number');\n return priority;\n}\n\nexport function validateTimeout(timeout: number | undefined, name = 'timeout'): number | undefined {\n if (timeout !== undefined && (!Number.isInteger(timeout) || timeout < 1 || timeout > MAX_TIMEOUT)) {\n throw new FamiliarInvalidOptionsError(`\\`${name}\\` must be an integer from 1 through ${MAX_TIMEOUT}`);\n }\n return timeout;\n}\n\nexport type PoolOptions = {\n defaultTimeout: number | undefined;\n maxQueue: number | undefined;\n onFull: 'reject' | 'wait';\n};\n\nexport type AcquireOptions = {\n priority: number;\n signal?: AbortSignal;\n};\n\n/**\n * A pool slot: tearable on disposal, with an optional channel for reporting\n * unhandled runtime errors. Pool factories wire `notify` to the core's tap so\n * slot owners can emit without holding a pool reference.\n */\nexport type PoolSlot = {\n notify?(error: FamiliarRuntimeError): void;\n terminate(): void;\n};\n\ntype IdleWaiter = {\n reject: (reason: unknown) => void;\n resolve: () => void;\n timer?: ReturnType<typeof setTimeout>;\n};\n\ntype CapacityWaiter = {\n cleanup(): void;\n priority: number;\n reject(reason: unknown): void;\n resolve(): void;\n sequence: number;\n};\n\ntype SlotWaiter<TSlot> = {\n cleanup(): void;\n priority: number;\n reject(reason: unknown): void;\n start(slot: TSlot): void;\n sequence: number;\n signal?: AbortSignal;\n};\n\nexport interface PoolCore<TSlot> {\n /**\n * Acquire a free slot and hand it to `fn`, which runs the acquired work.\n * `fn` is invoked synchronously both for an immediately free slot and when\n * a release hands the next waiter its slot, so dispatch never lags a\n * release by a microtask. Honors priority, FIFO order, abort, and `maxQueue`\n * admission; failures surface as a rejected promise. Without `fn`, resolves\n * with the slot instead.\n */\n acquire(options: AcquireOptions): Promise<TSlot>;\n acquire<R>(options: AcquireOptions, fn: (slot: TSlot) => R | Promise<R>): Promise<R>;\n readonly disposalSignal: AbortSignal;\n dispose(): void;\n readonly disposed: boolean;\n drain(options?: DrainOptions): Promise<void>;\n readonly drainPromise: Promise<void> | undefined;\n emitTap(event: FamiliarTapEvent): void;\n /** Return a slot to the pool, handing it to the highest-priority waiter if any. */\n release(slot: TSlot): void;\n settleIdle(): void;\n stats(): WorkerStats;\n status(): WorkerStatus;\n tap(handler: (event: FamiliarTapEvent) => void, options?: { readonly signal?: AbortSignal }): () => void;\n trackActive(delta: number): void;\n trackCompleted(): void;\n trackFailed(): void;\n}\n\n/**\n * The single slot scheduler shared by the result pool and the stream pool:\n * free-slot fast path, priority/FIFO waiter queue, `maxQueue` admission with\n * capacity waiters, idle/drain tracking, stats, disposal, and tap observation.\n * The two pools differ only in what they do with an acquired slot.\n */\nexport function createPoolCore<TSlot extends PoolSlot>(slots: readonly TSlot[], options: PoolOptions): PoolCore<TSlot> {\n const freeSlots = [...slots];\n const waiters: SlotWaiter<TSlot>[] = [];\n const idleWaiters: IdleWaiter[] = [];\n const capacityWaiters: CapacityWaiter[] = [];\n const tappers = tapper<FamiliarTapEvent>();\n const disposalController = new AbortController();\n let active = 0;\n let waiterSequence = 0;\n let capacitySequence = 0;\n let completed = 0;\n let failed = 0;\n let drainPromise: Promise<void> | undefined;\n let terminated = false;\n\n function isIdle(): boolean {\n return freeSlots.length === slots.length && waiters.length === 0;\n }\n\n function settleIdle(): void {\n if (!isIdle()) return;\n\n for (const waiter of idleWaiters.splice(0)) {\n if (waiter.timer) clearTimeout(waiter.timer);\n\n waiter.resolve();\n }\n }\n\n function waitForIdle(drainOptions: DrainOptions): Promise<void> {\n if (isIdle()) return Promise.resolve();\n\n return new Promise<void>((resolve, reject) => {\n const waiter: IdleWaiter = { reject, resolve };\n\n if (drainOptions.timeout !== undefined) {\n waiter.timer = setTimeout(() => {\n const index = idleWaiters.indexOf(waiter);\n\n if (index !== -1) idleWaiters.splice(index, 1);\n\n reject(new FamiliarTimeoutError(drainOptions.timeout!, 'Drain'));\n }, drainOptions.timeout);\n unrefTimer(waiter.timer);\n }\n\n idleWaiters.push(waiter);\n });\n }\n\n function releaseCapacity(): void {\n capacityWaiters.shift()?.resolve();\n }\n\n function rejectCapacity(reason: unknown): void {\n for (const waiter of capacityWaiters.splice(0)) waiter.reject(reason);\n }\n\n function waitForCapacity(signal: AbortSignal | undefined, priority: number): Promise<void> {\n if (signal?.aborted) return Promise.reject(abortError(signal));\n\n return new Promise<void>((resolve, reject) => {\n let settled = false;\n const waiter: CapacityWaiter = {\n cleanup() {\n signal?.removeEventListener('abort', onAbort);\n },\n priority,\n reject(reason) {\n if (settled) return;\n\n settled = true;\n waiter.cleanup();\n\n const index = capacityWaiters.indexOf(waiter);\n\n if (index !== -1) capacityWaiters.splice(index, 1);\n\n reject(reason);\n },\n resolve() {\n if (settled) return;\n\n settled = true;\n waiter.cleanup();\n resolve();\n },\n sequence: capacitySequence++,\n };\n const onAbort = () => waiter.reject(abortError(signal!));\n\n signal?.addEventListener('abort', onAbort, { once: true });\n capacityWaiters.push(waiter);\n capacityWaiters.sort((a, b) => b.priority - a.priority || a.sequence - b.sequence);\n });\n }\n\n function acquire<R>(acquireOptions: AcquireOptions, fn?: (slot: TSlot) => R | Promise<R>): Promise<R | TSlot> {\n const { priority, signal } = acquireOptions;\n\n if (signal?.aborted) return Promise.reject(abortError(signal));\n\n return (async () => {\n for (;;) {\n if (terminated) throw new FamiliarTerminatedError();\n\n if (drainPromise) throw new FamiliarTerminatedError('Worker is draining');\n\n if (options.maxQueue === undefined || waiters.length < options.maxQueue) {\n return admit(acquireOptions, (fn ?? ((slot) => slot)) as (slot: TSlot) => R | Promise<R>);\n }\n\n if (options.onFull === 'reject') throw new FamiliarQueueFullError(options.maxQueue);\n\n await waitForCapacity(signal, priority);\n\n if (signal?.aborted) {\n releaseCapacity();\n throw abortError(signal);\n }\n }\n })();\n }\n\n function admit<R>(acquireOptions: AcquireOptions, fn: (slot: TSlot) => R | Promise<R>): Promise<R> {\n const { priority, signal } = acquireOptions;\n\n const free = freeSlots.pop();\n\n if (free) {\n try {\n return Promise.resolve(fn(free));\n } catch (error) {\n // A synchronous throw must not strand the slot: idle would never settle.\n release(free);\n settleIdle();\n\n return Promise.reject(error);\n }\n }\n\n return new Promise<R>((resolve, reject) => {\n const waiter: SlotWaiter<TSlot> = {\n cleanup() {\n waiter.signal?.removeEventListener('abort', onAbort);\n },\n priority,\n reject(reason) {\n waiter.cleanup();\n\n const index = waiters.indexOf(waiter);\n\n if (index !== -1) {\n waiters.splice(index, 1);\n releaseCapacity();\n }\n\n reject(reason);\n settleIdle();\n },\n sequence: waiterSequence++,\n signal,\n start(slot) {\n waiter.cleanup();\n\n try {\n resolve(fn(slot));\n } catch (error) {\n release(slot);\n settleIdle();\n reject(error);\n }\n },\n };\n const onAbort = () => waiter.reject(abortError(waiter.signal!));\n\n waiter.signal?.addEventListener('abort', onAbort, { once: true });\n waiters.push(waiter);\n waiters.sort((a, b) => b.priority - a.priority || a.sequence - b.sequence);\n });\n }\n\n function release(slot: TSlot): void {\n const next = waiters.shift();\n\n if (next) {\n next.start(slot);\n releaseCapacity();\n } else {\n freeSlots.push(slot);\n }\n }\n\n function dispose(): void {\n if (terminated) return;\n\n terminated = true;\n disposalController.abort();\n\n for (const slot of slots) slot.terminate();\n\n for (const waiter of waiters.splice(0)) waiter.reject(new FamiliarTerminatedError());\n\n rejectCapacity(new FamiliarTerminatedError());\n settleIdle();\n tappers.emit({ type: 'dispose' });\n tappers.clear();\n }\n\n function drain(drainOptions: DrainOptions = {}): Promise<void> {\n if (terminated) return Promise.resolve();\n try {\n validateTimeout(drainOptions.timeout, 'drain.timeout');\n } catch (error) {\n return Promise.reject(error);\n }\n\n if (drainPromise) return drainPromise;\n\n rejectCapacity(new FamiliarTerminatedError('Worker is draining'));\n drainPromise = waitForIdle(drainOptions).then(\n () => dispose(),\n (error: unknown) => {\n dispose();\n throw error;\n },\n );\n\n return drainPromise;\n }\n\n return {\n acquire,\n disposalSignal: disposalController.signal,\n dispose,\n get disposed() {\n return terminated;\n },\n drain,\n get drainPromise() {\n return drainPromise;\n },\n emitTap(event) {\n tappers.emit(event);\n },\n release,\n settleIdle,\n stats() {\n return { active, completed, failed, queued: waiters.length + capacityWaiters.length };\n },\n status() {\n if (terminated) return 'terminated';\n\n return active === 0 ? 'idle' : 'running';\n },\n tap(handler, tapOptions) {\n if (terminated) return () => undefined;\n\n return tappers.tap(handler, tapOptions);\n },\n trackActive(delta: number) {\n active += delta;\n },\n trackCompleted() {\n completed += 1;\n },\n trackFailed() {\n failed += 1;\n },\n };\n}\n","import { abortError } from '@vielzeug/arsenal';\nimport { createPoolCore, type PoolCore, type PoolOptions, validatePriority, validateTimeout } from './_pool-core.js';\nimport { FamiliarRuntimeError, FamiliarTerminatedError } from './errors.js';\nimport type { RunOptions, SlotStrategy, WorkerPool } from './types.js';\n\nexport type { PoolOptions } from './_pool-core.js';\n\nexport function createPool<TInput, TOutput>(\n slots: readonly SlotStrategy<TInput, TOutput>[],\n options: PoolOptions,\n): WorkerPool<TInput, TOutput> {\n const core: PoolCore<SlotStrategy<TInput, TOutput>> = createPoolCore(slots, options);\n\n for (const slot of slots) slot.notify = (error) => core.emitTap({ error, type: 'worker-error' });\n\n function run(input: TInput, runOptions: RunOptions = {}): Promise<TOutput> {\n let priority: number;\n let timeout: number | undefined;\n let transferables: Transferable[];\n\n try {\n priority = validatePriority(runOptions.priority ?? 0);\n timeout = validateTimeout(runOptions.timeout) ?? options.defaultTimeout;\n transferables = [...(runOptions.transferables ?? [])];\n } catch (error) {\n return Promise.reject(error);\n }\n\n return core.acquire({ priority, signal: runOptions.signal }, (slot) => {\n core.trackActive(1);\n\n const onAbort = () => slot.cancel(abortError(runOptions.signal!));\n runOptions.signal?.addEventListener('abort', onAbort, { once: true });\n\n const finish = async (): Promise<TOutput> => {\n try {\n const value = await slot.run(input, transferables, timeout);\n\n core.trackCompleted();\n\n return value;\n } catch (error) {\n if (!runOptions.signal?.aborted && !(error instanceof FamiliarTerminatedError)) core.trackFailed();\n\n throw error;\n } finally {\n runOptions.signal?.removeEventListener('abort', onAbort);\n core.trackActive(-1);\n core.release(slot);\n core.settleIdle();\n }\n };\n\n return finish();\n });\n }\n\n return {\n get disposalSignal() {\n return core.disposalSignal;\n },\n dispose: core.dispose,\n get disposed() {\n return core.disposed;\n },\n drain: core.drain,\n run,\n get stats() {\n return core.stats();\n },\n get status() {\n return core.status();\n },\n tap: core.tap,\n [Symbol.asyncDispose]: () => core.drain({}),\n [Symbol.dispose]: core.dispose,\n };\n}\n\nexport type BatchOptions<TInput> = Pick<RunOptions, 'priority' | 'signal' | 'timeout'> & {\n getTransferables?: (input: TInput, index: number) => readonly Transferable[];\n};\n\n/** Run related tasks concurrently and yield their results in input order. */\nexport function runBatch<TInput, TOutput>(\n pool: WorkerPool<TInput, TOutput>,\n inputs: readonly TInput[],\n options: BatchOptions<TInput> = {},\n): AsyncIterable<TOutput> {\n let owner: object | undefined;\n\n const iterate = async function* (controller: AbortController): AsyncGenerator<TOutput> {\n const tasks: Promise<TOutput>[] = [];\n const onAbort = () => controller.abort(options.signal?.reason);\n\n if (options.signal?.aborted) controller.abort(options.signal.reason);\n else options.signal?.addEventListener('abort', onAbort, { once: true });\n\n try {\n for (const [index, input] of inputs.entries()) {\n const task = pool\n .run(input, {\n priority: options.priority,\n signal: controller.signal,\n timeout: options.timeout,\n transferables: options.getTransferables?.(input, index),\n })\n .catch((error: unknown) => {\n controller.abort(error);\n throw error;\n });\n\n void task.catch(() => undefined);\n tasks.push(task);\n }\n\n if (tasks.length === 0 && controller.signal.aborted) throw abortError(controller.signal);\n for (const task of tasks) {\n if (controller.signal.aborted) throw abortError(controller.signal);\n const value = await task;\n if (controller.signal.aborted) throw abortError(controller.signal);\n yield value;\n }\n } catch (error) {\n controller.abort(error);\n throw error;\n } finally {\n options.signal?.removeEventListener('abort', onAbort);\n controller.abort(new DOMException('Batch consumer stopped', 'AbortError'));\n await Promise.allSettled(tasks);\n }\n };\n\n return {\n [Symbol.asyncIterator]() {\n const token = {};\n const controller = new AbortController();\n let iterator: AsyncGenerator<TOutput> | undefined;\n const start = (): AsyncGenerator<TOutput> | undefined => {\n owner ??= token;\n if (owner !== token) return undefined;\n iterator ??= iterate(controller);\n return iterator;\n };\n\n return {\n next: () =>\n start()?.next() ?? Promise.reject(new FamiliarRuntimeError('Worker batches can only be consumed once')),\n return: async (value?: unknown) => {\n if (!owner || owner !== token) return { done: true, value: value as TOutput };\n controller.abort(new FamiliarTerminatedError('Batch consumer stopped'));\n return iterator?.return(value as TOutput) ?? { done: true, value: value as TOutput };\n },\n throw: async (error?: unknown) => {\n const active = start();\n if (!active) throw new FamiliarRuntimeError('Worker batches can only be consumed once');\n controller.abort(error);\n return active.throw(error);\n },\n };\n },\n };\n}\n","import { abortError } from '@vielzeug/arsenal';\nimport { createPoolCore, type PoolCore, type PoolOptions, validatePriority, validateTimeout } from './_pool-core.js';\nimport { FamiliarRuntimeError, FamiliarTerminatedError } from './errors.js';\nimport type { RunOptions, StreamWorkerPool } from './types.js';\n\nexport type StreamSlot<TInput, TChunk> = {\n cancel(reason: unknown): void;\n /** Wired by the pool factory to report unhandled worker runtime errors through `tap()`. */\n notify?(error: FamiliarRuntimeError): void;\n stream(input: TInput, options: RunOptions): { done: Promise<void>; iterable: AsyncIterable<TChunk> };\n terminate(): void;\n};\n\nexport function createStreamPool<TInput, TChunk>(\n slots: readonly StreamSlot<TInput, TChunk>[],\n options: PoolOptions,\n): StreamWorkerPool<TInput, TChunk> {\n const core: PoolCore<StreamSlot<TInput, TChunk>> = createPoolCore(slots, options);\n\n for (const slot of slots) slot.notify = (error) => core.emitTap({ error, type: 'worker-error' });\n\n function runStream(input: TInput, runOptions: RunOptions = {}): AsyncIterable<TChunk> {\n const priority = validatePriority(runOptions.priority ?? 0);\n const timeout = validateTimeout(runOptions.timeout) ?? options.defaultTimeout;\n const transferables = [...(runOptions.transferables ?? [])];\n let owner: object | undefined;\n\n const iterate = async function* (controller: AbortController): AsyncGenerator<TChunk> {\n const onAbort = () => controller.abort(runOptions.signal?.reason);\n let slot: StreamSlot<TInput, TChunk> | undefined;\n let onCancel: (() => void) | undefined;\n\n if (runOptions.signal?.aborted) controller.abort(runOptions.signal.reason);\n else runOptions.signal?.addEventListener('abort', onAbort, { once: true });\n\n try {\n const running = await core.acquire({ priority, signal: controller.signal }, (acquired) => {\n slot = acquired;\n core.trackActive(1);\n onCancel = () => slot?.cancel(abortError(controller.signal));\n controller.signal.addEventListener('abort', onCancel, { once: true });\n\n return acquired.stream(input, { priority, signal: controller.signal, timeout, transferables });\n });\n\n for await (const value of running.iterable) yield value;\n await running.done;\n core.trackCompleted();\n } catch (error) {\n if (slot && !controller.signal.aborted && !(error instanceof FamiliarTerminatedError)) core.trackFailed();\n throw error;\n } finally {\n runOptions.signal?.removeEventListener('abort', onAbort);\n\n if (slot) {\n if (onCancel) controller.signal.removeEventListener('abort', onCancel);\n\n core.trackActive(-1);\n core.release(slot);\n core.settleIdle();\n }\n }\n };\n\n return {\n [Symbol.asyncIterator]() {\n const token = {};\n const controller = new AbortController();\n let iterator: AsyncGenerator<TChunk> | undefined;\n const start = (): AsyncGenerator<TChunk> | undefined => {\n owner ??= token;\n if (owner !== token) return undefined;\n iterator ??= iterate(controller);\n return iterator;\n };\n\n return {\n next: () =>\n start()?.next() ?? Promise.reject(new FamiliarRuntimeError('Worker streams can only be consumed once')),\n return: async (value?: unknown) => {\n if (!owner || owner !== token) return { done: true, value: value as TChunk };\n controller.abort(new FamiliarTerminatedError('Stream consumer stopped'));\n return iterator?.return(value as TChunk) ?? { done: true, value: value as TChunk };\n },\n throw: async (error?: unknown) => {\n const active = start();\n if (!active) throw new FamiliarRuntimeError('Worker streams can only be consumed once');\n controller.abort(error);\n return active.throw(error);\n },\n };\n },\n };\n }\n\n return {\n get disposalSignal() {\n return core.disposalSignal;\n },\n dispose: core.dispose,\n get disposed() {\n return core.disposed;\n },\n drain: core.drain,\n runStream,\n get stats() {\n return core.stats();\n },\n get status() {\n return core.status();\n },\n tap: core.tap,\n [Symbol.asyncDispose]: () => core.drain({}),\n [Symbol.dispose]: core.dispose,\n };\n}\n","import { createPool } from './_pool.js';\nimport { MAX_CONCURRENCY, validateTimeout } from './_pool-core.js';\nimport { createStreamPool, type StreamSlot } from './_stream-pool.js';\nimport { unrefTimer } from './_timers.js';\nimport {\n FamiliarInvalidOptionsError,\n FamiliarRuntimeError,\n FamiliarTaskError,\n FamiliarTerminatedError,\n FamiliarTimeoutError,\n} from './errors.js';\nimport type { SerializedError, WorkerResponse } from './protocol.js';\nimport { PROTOCOL_VERSION } from './protocol.js';\nimport type { RunOptions, SlotStrategy, StreamWorkerPool, WorkerOptions, WorkerPool } from './types.js';\n\ntype ResolvedOptions = {\n concurrency: number;\n maxQueue: number | undefined;\n onFull: 'reject' | 'wait';\n timeout: number | undefined;\n};\n\ntype Pending<TOutput> = {\n emit?: (value: TOutput) => void;\n id: number;\n kind: 'run' | 'stream';\n reject: (reason: unknown) => void;\n resolve: (value: TOutput) => void;\n timer?: ReturnType<typeof setTimeout>;\n};\n\ntype RunningStream<TChunk> = {\n done: Promise<void>;\n iterable: AsyncIterable<TChunk>;\n};\n\nfunction resolveOptions(options: WorkerOptions = {}): ResolvedOptions {\n const { concurrency = 1, maxQueue, onFull = 'reject', timeout } = options;\n const resolvedConcurrency =\n concurrency === 'auto'\n ? Math.min(MAX_CONCURRENCY, Math.max(1, globalThis.navigator?.hardwareConcurrency ?? 1))\n : concurrency;\n\n if (!Number.isInteger(resolvedConcurrency) || resolvedConcurrency < 1 || resolvedConcurrency > MAX_CONCURRENCY) {\n throw new FamiliarInvalidOptionsError(`\\`concurrency\\` must be a positive integer ≤ ${MAX_CONCURRENCY} or \"auto\"`);\n }\n\n if (maxQueue !== undefined && (!Number.isInteger(maxQueue) || maxQueue < 1)) {\n throw new FamiliarInvalidOptionsError('`maxQueue` must be a positive integer');\n }\n\n if (onFull !== 'reject' && onFull !== 'wait') {\n throw new FamiliarInvalidOptionsError('`onFull` must be \"reject\" or \"wait\"');\n }\n\n validateTimeout(timeout);\n\n return { concurrency: resolvedConcurrency, maxQueue, onFull, timeout };\n}\n\nfunction isWorkerResponse<TOutput>(value: unknown): value is WorkerResponse<TOutput> {\n if (typeof value !== 'object' || value === null) return false;\n\n const response = value as Partial<WorkerResponse<TOutput>>;\n if (\n response.version !== PROTOCOL_VERSION ||\n typeof response.id !== 'number' ||\n !Number.isSafeInteger(response.id) ||\n response.id < 0\n )\n return false;\n\n if (response.kind === 'chunk' || response.kind === 'result') return 'value' in response;\n if (response.kind !== 'error' || typeof response.error !== 'object' || response.error === null) return false;\n\n return (\n (response.error.category === undefined || response.error.category === 'protocol') &&\n typeof response.error.message === 'string' &&\n typeof response.error.name === 'string' &&\n (response.error.stack === undefined || typeof response.error.stack === 'string')\n );\n}\n\nfunction responseError(error: SerializedError): FamiliarRuntimeError | FamiliarTaskError {\n const cause = new Error(error.message);\n\n cause.name = error.name;\n cause.stack = error.stack;\n\n return error.category === 'protocol'\n ? new FamiliarRuntimeError(error.message, { cause })\n : new FamiliarTaskError(error.message, { cause });\n}\n\nclass Slot<TInput, TOutput> implements SlotStrategy<TInput, TOutput>, StreamSlot<TInput, TOutput> {\n readonly #url: URL | string;\n #disposed = false;\n #pending: Pending<TOutput> | undefined;\n #taskId = 0;\n #worker: Worker | undefined;\n\n /** Wired by the pool factory to report unhandled worker runtime errors through `tap()`. */\n notify: ((error: FamiliarRuntimeError) => void) | undefined = undefined;\n\n constructor(url: URL | string) {\n this.#url = url;\n }\n\n cancel(reason: unknown): void {\n if (!this.#pending) return;\n this.#stopWorker();\n this.#settlePending('reject', reason);\n }\n\n run(input: TInput, transferables: Transferable[], timeout: number | undefined): Promise<TOutput> {\n return this.#dispatch(input, transferables, timeout, 'run') as Promise<TOutput>;\n }\n\n stream(input: TInput, options: RunOptions): RunningStream<TOutput> {\n const stop = () => this.cancel(new FamiliarTerminatedError('Stream consumer stopped'));\n const chunks: TOutput[] = [];\n const waiters: Array<(result: IteratorResult<TOutput>) => void> = [];\n let done = false;\n let error: unknown;\n const emit = (value: TOutput) => {\n const waiter = waiters.shift();\n\n if (waiter) waiter({ done: false, value });\n else chunks.push(value);\n };\n const finish = (reason?: unknown) => {\n done = true;\n error = reason;\n\n while (waiters.length > 0) {\n const waiter = waiters.shift()!;\n\n if (reason !== undefined) waiter(Promise.reject(reason) as never);\n else waiter({ done: true, value: undefined as never });\n }\n };\n const donePromise = this.#dispatch(input, [...(options.transferables ?? [])], options.timeout, 'stream', emit).then(\n () => finish(),\n (reason: unknown) => finish(reason),\n );\n\n return {\n done: donePromise,\n iterable: {\n [Symbol.asyncIterator]: () => ({\n async next(): Promise<IteratorResult<TOutput>> {\n if (chunks.length > 0) return { done: false, value: chunks.shift()! };\n\n if (error !== undefined) throw error;\n\n if (done) return { done: true, value: undefined as never };\n\n return new Promise<IteratorResult<TOutput>>((resolve, reject) => {\n waiters.push((result) => {\n if (result instanceof Promise) void result.then(resolve, reject);\n else resolve(result);\n });\n });\n },\n async return(): Promise<IteratorResult<TOutput>> {\n stop();\n\n return { done: true, value: undefined as never };\n },\n }),\n },\n };\n }\n\n terminate(): void {\n this.#disposed = true;\n this.#stopWorker();\n this.#settlePending('reject', new FamiliarTerminatedError());\n }\n\n #dispatch(\n input: TInput,\n transferables: Transferable[],\n timeout: number | undefined,\n kind: 'run' | 'stream',\n emit?: (value: TOutput) => void,\n ): Promise<TOutput> {\n if (this.#disposed) return Promise.reject(new FamiliarTerminatedError());\n\n if (this.#pending) return Promise.reject(new FamiliarRuntimeError('Worker slot is already busy'));\n\n try {\n const worker = this.#ensureWorker();\n const id = this.#taskId;\n this.#taskId = id === Number.MAX_SAFE_INTEGER ? 0 : id + 1;\n\n return new Promise<TOutput>((resolve, reject) => {\n const pending: Pending<TOutput> = { emit, id, kind, reject, resolve };\n\n this.#pending = pending;\n\n if (timeout !== undefined) {\n pending.timer = setTimeout(() => this.cancel(new FamiliarTimeoutError(timeout)), timeout);\n unrefTimer(pending.timer);\n }\n\n try {\n worker.postMessage({ id, input, kind, version: PROTOCOL_VERSION }, transferables);\n } catch (error) {\n this.cancel(new FamiliarRuntimeError('Failed to post message to worker', { cause: error }));\n }\n });\n } catch (error) {\n return Promise.reject(error);\n }\n }\n\n #ensureWorker(): Worker {\n if (this.#worker) return this.#worker;\n\n if (typeof Worker === 'undefined') throw new FamiliarRuntimeError('Worker API is unavailable in this runtime');\n\n try {\n const worker = new Worker(this.#url, { type: 'module' });\n\n worker.onmessage = (event: MessageEvent<unknown>) => {\n if (this.#worker === worker) this.#onMessage(event.data);\n };\n worker.onerror = (event) => this.#failWorker(worker, new FamiliarRuntimeError(event.message || 'Worker failed'));\n worker.onmessageerror = () =>\n this.#failWorker(worker, new FamiliarRuntimeError('Worker response could not be deserialized'));\n this.#worker = worker;\n\n return worker;\n } catch (error) {\n throw new FamiliarRuntimeError('Failed to create Worker', { cause: error });\n }\n }\n\n #stopWorker(): void {\n const worker = this.#worker;\n this.#worker = undefined;\n if (!worker) return;\n\n worker.onmessage = null;\n worker.onerror = null;\n worker.onmessageerror = null;\n worker.terminate();\n }\n\n #failWorker(worker: Worker, error: FamiliarRuntimeError): void {\n if (this.#worker !== worker) return;\n\n this.#stopWorker();\n this.#settlePending('reject', error);\n this.notify?.(error);\n }\n\n #onMessage(message: unknown): void {\n if (!this.#pending) return;\n\n if (\n !isWorkerResponse<TOutput>(message) ||\n message.id !== this.#pending.id ||\n (this.#pending.kind === 'run' && message.kind === 'chunk')\n ) {\n this.cancel(new FamiliarRuntimeError('Worker returned an incompatible protocol response'));\n\n return;\n }\n\n if (message.kind === 'chunk') {\n this.#pending.emit?.(message.value);\n\n return;\n }\n\n if (message.kind === 'error') {\n this.#settlePending('reject', responseError(message.error));\n\n return;\n }\n\n this.#settlePending('resolve', message.value);\n }\n\n #settlePending(kind: 'resolve' | 'reject', value: unknown): void {\n const pending = this.#pending;\n\n if (!pending) return;\n\n this.#pending = undefined;\n\n if (pending.timer) clearTimeout(pending.timer);\n\n if (kind === 'resolve') pending.resolve(value as TOutput);\n else pending.reject(value);\n }\n}\n\nfunction slots<TInput, TOutput>(url: URL | string, options: ResolvedOptions): Slot<TInput, TOutput>[] {\n const resolvedUrl = typeof url === 'string' ? url : url.href;\n return Array.from({ length: options.concurrency }, () => new Slot<TInput, TOutput>(resolvedUrl));\n}\n\n/** Create a pool backed by an ES module worker registered with exposeTask(). */\nexport function createWorker<TInput, TOutput>(\n url: URL | string,\n options: WorkerOptions = {},\n): WorkerPool<TInput, TOutput> {\n const resolved = resolveOptions(options);\n\n return createPool(slots<TInput, TOutput>(url, resolved), {\n defaultTimeout: resolved.timeout,\n maxQueue: resolved.maxQueue,\n onFull: resolved.onFull,\n });\n}\n\n/** Create a stream-only pool backed by an ES module worker registered with exposeStream(). */\nexport function createStreamWorker<TInput, TChunk>(\n url: URL | string,\n options: WorkerOptions = {},\n): StreamWorkerPool<TInput, TChunk> {\n const resolved = resolveOptions(options);\n\n return createStreamPool(slots<TInput, TChunk>(url, resolved), {\n defaultTimeout: resolved.timeout,\n maxQueue: resolved.maxQueue,\n onFull: resolved.onFull,\n });\n}\n"],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"familiar.cjs","names":["tapper","abortError","abortError","abortError","_vielzeug_arsenal","timer","message","opts","maxQueue","operation","timeoutMs","MAX_TIMEOUT","priority","timeout","name","freeSlots","slots","waiters","idleWaiters","capacityWaiters","tappers","disposalController","active","waiterSequence","capacitySequence","completed","failed","drainPromise","terminated","waiter","drainOptions","index","reject","reason","signal","settled","resolve","b","a","acquireOptions","options","fn","slot","free","error","next","event","handler","tapOptions","delta","core","transferables","runOptions","value","input","owner","tasks","controller","inputs","task","pool","token","iterator","running","acquired","resolvedConcurrency","concurrency","onFull","response","cause","#url","url","#pending","#stopWorker","#settlePending","#dispatch","chunks","done","result","#disposed","worker","#ensureWorker","id","#taskId","pending","#worker","#onMessage","#failWorker","kind","resolvedUrl","resolved"],"sources":["../src/_timers.ts","../src/errors.ts","../src/_pool-core.ts","../src/_pool.ts","../src/_stream-pool.ts","../src/worker.ts"],"sourcesContent":["/**\n * Node compatibility helper: `unref()`s a timer so a pending per-task timeout/watchdog does not\n * keep a Node event loop (e.g. a Worker polyfill) alive. Browsers return a plain number from\n * `setTimeout`/`setInterval`, so this is a no-op there.\n *\n * Not part of the public API surface.\n */\nexport function unrefTimer(timer: ReturnType<typeof setTimeout> | ReturnType<typeof setInterval>): void {\n if (typeof timer === 'object' && timer !== null && 'unref' in timer) {\n (timer as { unref(): void }).unref();\n }\n}\n","/** Base class for all familiar errors. Use `instanceof FamiliarError` to catch any familiar-originated error. */\nexport class FamiliarError extends Error {\n constructor(message: string, opts?: ErrorOptions) {\n super(message, opts);\n this.name = new.target.name;\n Object.setPrototypeOf(this, new.target.prototype);\n }\n}\n\n/** Thrown when invalid options are passed to a Familiar pool factory. */\nexport class FamiliarInvalidOptionsError extends FamiliarError {}\n\n/** Thrown when run() is called and the queue is full (`onFull='reject'`). */\nexport class FamiliarQueueFullError extends FamiliarError {\n /** The configured `maxQueue` value. */\n readonly maxQueue: number;\n\n constructor(maxQueue: number) {\n super(`Queue is full (maxQueue=${maxQueue})`);\n this.maxQueue = maxQueue;\n }\n}\n\n/** Thrown when the task function throws. The original error is available as `.cause`. */\nexport class FamiliarTaskError extends FamiliarError {}\n\n/** Thrown when a task or operation is rejected because the worker was terminated. */\nexport class FamiliarTerminatedError extends FamiliarError {\n constructor(message = 'Worker was terminated') {\n super(message);\n }\n}\n\n/** Thrown when a task exceeds its timeout or `drain()` times out. */\nexport class FamiliarTimeoutError extends FamiliarError {\n /** The configured timeout in milliseconds. */\n readonly timeoutMs: number;\n\n constructor(timeoutMs: number, operation = 'Task') {\n super(`${operation} timed out after ${timeoutMs}ms`);\n this.timeoutMs = timeoutMs;\n }\n}\n\n/** Thrown when the Worker API is unavailable or an unhandled error occurs in the worker thread. */\nexport class FamiliarRuntimeError extends FamiliarError {}\n","import { abortError, tapper } from '@vielzeug/arsenal';\nimport { unrefTimer } from './_timers.js';\nimport {\n FamiliarInvalidOptionsError,\n FamiliarQueueFullError,\n type FamiliarRuntimeError,\n FamiliarTerminatedError,\n FamiliarTimeoutError,\n} from './errors.js';\nimport type { DrainOptions, FamiliarTapEvent, WorkerStats, WorkerStatus } from './types.js';\n\nexport const MAX_CONCURRENCY = 512;\nexport const MAX_TIMEOUT = 2_147_483_647;\n\nexport function validatePriority(priority: number): number {\n if (!Number.isFinite(priority)) throw new FamiliarInvalidOptionsError('`priority` must be a finite number');\n return priority;\n}\n\nexport function validateTimeout(timeout: number | undefined, name = 'timeout'): number | undefined {\n if (timeout !== undefined && (!Number.isInteger(timeout) || timeout < 1 || timeout > MAX_TIMEOUT)) {\n throw new FamiliarInvalidOptionsError(`\\`${name}\\` must be an integer from 1 through ${MAX_TIMEOUT}`);\n }\n return timeout;\n}\n\nexport type PoolOptions = {\n defaultTimeout: number | undefined;\n maxQueue: number | undefined;\n onFull: 'reject' | 'wait';\n};\n\nexport type AcquireOptions = {\n priority: number;\n signal?: AbortSignal;\n};\n\n/**\n * A pool slot: tearable on disposal, with an optional channel for reporting\n * unhandled runtime errors. Pool factories wire `notify` to the core's tap so\n * slot owners can emit without holding a pool reference.\n */\nexport type PoolSlot = {\n notify?(error: FamiliarRuntimeError): void;\n terminate(): void;\n};\n\ntype IdleWaiter = {\n reject: (reason: unknown) => void;\n resolve: () => void;\n timer?: ReturnType<typeof setTimeout>;\n};\n\ntype CapacityWaiter = {\n cleanup(): void;\n priority: number;\n reject(reason: unknown): void;\n resolve(): void;\n sequence: number;\n};\n\ntype SlotWaiter<TSlot> = {\n cleanup(): void;\n priority: number;\n reject(reason: unknown): void;\n start(slot: TSlot): void;\n sequence: number;\n signal?: AbortSignal;\n};\n\nexport interface PoolCore<TSlot> {\n /**\n * Acquire a free slot and hand it to `fn`, which runs the acquired work.\n * `fn` is invoked synchronously both for an immediately free slot and when\n * a release hands the next waiter its slot, so dispatch never lags a\n * release by a microtask. Honors priority, FIFO order, abort, and `maxQueue`\n * admission; failures surface as a rejected promise. Without `fn`, resolves\n * with the slot instead.\n */\n acquire(options: AcquireOptions): Promise<TSlot>;\n acquire<R>(options: AcquireOptions, fn: (slot: TSlot) => R | Promise<R>): Promise<R>;\n readonly disposalSignal: AbortSignal;\n dispose(): void;\n readonly disposed: boolean;\n drain(options?: DrainOptions): Promise<void>;\n readonly drainPromise: Promise<void> | undefined;\n emitTap(event: FamiliarTapEvent): void;\n /** Return a slot to the pool, handing it to the highest-priority waiter if any. */\n release(slot: TSlot): void;\n settleIdle(): void;\n stats(): WorkerStats;\n status(): WorkerStatus;\n tap(handler: (event: FamiliarTapEvent) => void, options?: { readonly signal?: AbortSignal }): () => void;\n trackActive(delta: number): void;\n trackCompleted(): void;\n trackFailed(): void;\n}\n\n/**\n * The single slot scheduler shared by the result pool and the stream pool:\n * free-slot fast path, priority/FIFO waiter queue, `maxQueue` admission with\n * capacity waiters, idle/drain tracking, stats, disposal, and tap observation.\n * The two pools differ only in what they do with an acquired slot.\n */\nexport function createPoolCore<TSlot extends PoolSlot>(slots: readonly TSlot[], options: PoolOptions): PoolCore<TSlot> {\n const freeSlots = [...slots];\n const waiters: SlotWaiter<TSlot>[] = [];\n const idleWaiters: IdleWaiter[] = [];\n const capacityWaiters: CapacityWaiter[] = [];\n const tappers = tapper<FamiliarTapEvent>();\n const disposalController = new AbortController();\n let active = 0;\n let waiterSequence = 0;\n let capacitySequence = 0;\n let completed = 0;\n let failed = 0;\n let drainPromise: Promise<void> | undefined;\n let terminated = false;\n\n function isIdle(): boolean {\n return freeSlots.length === slots.length && waiters.length === 0;\n }\n\n function settleIdle(): void {\n if (!isIdle()) return;\n\n for (const waiter of idleWaiters.splice(0)) {\n if (waiter.timer) clearTimeout(waiter.timer);\n\n waiter.resolve();\n }\n }\n\n function waitForIdle(drainOptions: DrainOptions): Promise<void> {\n if (isIdle()) return Promise.resolve();\n\n return new Promise<void>((resolve, reject) => {\n const waiter: IdleWaiter = { reject, resolve };\n\n if (drainOptions.timeout !== undefined) {\n waiter.timer = setTimeout(() => {\n const index = idleWaiters.indexOf(waiter);\n\n if (index !== -1) idleWaiters.splice(index, 1);\n\n reject(new FamiliarTimeoutError(drainOptions.timeout!, 'Drain'));\n }, drainOptions.timeout);\n unrefTimer(waiter.timer);\n }\n\n idleWaiters.push(waiter);\n });\n }\n\n function releaseCapacity(): void {\n capacityWaiters.shift()?.resolve();\n }\n\n function rejectCapacity(reason: unknown): void {\n for (const waiter of capacityWaiters.splice(0)) waiter.reject(reason);\n }\n\n function waitForCapacity(signal: AbortSignal | undefined, priority: number): Promise<void> {\n if (signal?.aborted) return Promise.reject(abortError(signal));\n\n return new Promise<void>((resolve, reject) => {\n let settled = false;\n const waiter: CapacityWaiter = {\n cleanup() {\n signal?.removeEventListener('abort', onAbort);\n },\n priority,\n reject(reason) {\n if (settled) return;\n\n settled = true;\n waiter.cleanup();\n\n const index = capacityWaiters.indexOf(waiter);\n\n if (index !== -1) capacityWaiters.splice(index, 1);\n\n reject(reason);\n },\n resolve() {\n if (settled) return;\n\n settled = true;\n waiter.cleanup();\n resolve();\n },\n sequence: capacitySequence++,\n };\n const onAbort = () => waiter.reject(abortError(signal!));\n\n signal?.addEventListener('abort', onAbort, { once: true });\n capacityWaiters.push(waiter);\n capacityWaiters.sort((a, b) => b.priority - a.priority || a.sequence - b.sequence);\n });\n }\n\n function acquire<R>(acquireOptions: AcquireOptions, fn?: (slot: TSlot) => R | Promise<R>): Promise<R | TSlot> {\n const { priority, signal } = acquireOptions;\n\n if (signal?.aborted) return Promise.reject(abortError(signal));\n\n return (async () => {\n for (;;) {\n if (terminated) throw new FamiliarTerminatedError();\n\n if (drainPromise) throw new FamiliarTerminatedError('Worker is draining');\n\n if (options.maxQueue === undefined || waiters.length < options.maxQueue) {\n return admit(acquireOptions, (fn ?? ((slot) => slot)) as (slot: TSlot) => R | Promise<R>);\n }\n\n if (options.onFull === 'reject') throw new FamiliarQueueFullError(options.maxQueue);\n\n await waitForCapacity(signal, priority);\n\n if (signal?.aborted) {\n releaseCapacity();\n throw abortError(signal);\n }\n }\n })();\n }\n\n function admit<R>(acquireOptions: AcquireOptions, fn: (slot: TSlot) => R | Promise<R>): Promise<R> {\n const { priority, signal } = acquireOptions;\n\n const free = freeSlots.pop();\n\n if (free) {\n try {\n return Promise.resolve(fn(free));\n } catch (error) {\n // A synchronous throw must not strand the slot: idle would never settle.\n release(free);\n settleIdle();\n\n return Promise.reject(error);\n }\n }\n\n return new Promise<R>((resolve, reject) => {\n const waiter: SlotWaiter<TSlot> = {\n cleanup() {\n waiter.signal?.removeEventListener('abort', onAbort);\n },\n priority,\n reject(reason) {\n waiter.cleanup();\n\n const index = waiters.indexOf(waiter);\n\n if (index !== -1) {\n waiters.splice(index, 1);\n releaseCapacity();\n }\n\n reject(reason);\n settleIdle();\n },\n sequence: waiterSequence++,\n signal,\n start(slot) {\n waiter.cleanup();\n\n try {\n resolve(fn(slot));\n } catch (error) {\n release(slot);\n settleIdle();\n reject(error);\n }\n },\n };\n const onAbort = () => waiter.reject(abortError(waiter.signal!));\n\n waiter.signal?.addEventListener('abort', onAbort, { once: true });\n waiters.push(waiter);\n waiters.sort((a, b) => b.priority - a.priority || a.sequence - b.sequence);\n });\n }\n\n function release(slot: TSlot): void {\n const next = waiters.shift();\n\n if (next) {\n next.start(slot);\n releaseCapacity();\n } else {\n freeSlots.push(slot);\n }\n }\n\n function dispose(): void {\n if (terminated) return;\n\n terminated = true;\n disposalController.abort();\n\n for (const slot of slots) slot.terminate();\n\n for (const waiter of waiters.splice(0)) waiter.reject(new FamiliarTerminatedError());\n\n rejectCapacity(new FamiliarTerminatedError());\n settleIdle();\n tappers.emit({ type: 'dispose' });\n tappers.clear();\n }\n\n function drain(drainOptions: DrainOptions = {}): Promise<void> {\n if (terminated) return Promise.resolve();\n try {\n validateTimeout(drainOptions.timeout, 'drain.timeout');\n } catch (error) {\n return Promise.reject(error);\n }\n\n if (drainPromise) return drainPromise;\n\n rejectCapacity(new FamiliarTerminatedError('Worker is draining'));\n drainPromise = waitForIdle(drainOptions).then(\n () => dispose(),\n (error: unknown) => {\n dispose();\n throw error;\n },\n );\n\n return drainPromise;\n }\n\n return {\n acquire,\n disposalSignal: disposalController.signal,\n dispose,\n get disposed() {\n return terminated;\n },\n drain,\n get drainPromise() {\n return drainPromise;\n },\n emitTap(event) {\n tappers.emit(event);\n },\n release,\n settleIdle,\n stats() {\n return { active, completed, failed, queued: waiters.length + capacityWaiters.length };\n },\n status() {\n if (terminated) return 'terminated';\n\n return active === 0 ? 'idle' : 'running';\n },\n tap(handler, tapOptions) {\n if (terminated) return () => undefined;\n\n return tappers.tap(handler, tapOptions);\n },\n trackActive(delta: number) {\n active += delta;\n },\n trackCompleted() {\n completed += 1;\n },\n trackFailed() {\n failed += 1;\n },\n };\n}\n","import { abortError } from '@vielzeug/arsenal';\nimport { createPoolCore, type PoolCore, type PoolOptions, validatePriority, validateTimeout } from './_pool-core.js';\nimport { FamiliarRuntimeError, FamiliarTerminatedError } from './errors.js';\nimport type { RunOptions, SlotStrategy, WorkerPool } from './types.js';\n\nexport type { PoolOptions } from './_pool-core.js';\n\nexport function createPool<TInput, TOutput>(\n slots: readonly SlotStrategy<TInput, TOutput>[],\n options: PoolOptions,\n): WorkerPool<TInput, TOutput> {\n const core: PoolCore<SlotStrategy<TInput, TOutput>> = createPoolCore(slots, options);\n\n for (const slot of slots) slot.notify = (error) => core.emitTap({ error, type: 'worker-error' });\n\n function run(input: TInput, runOptions: RunOptions = {}): Promise<TOutput> {\n let priority: number;\n let timeout: number | undefined;\n let transferables: Transferable[];\n\n try {\n priority = validatePriority(runOptions.priority ?? 0);\n timeout = validateTimeout(runOptions.timeout) ?? options.defaultTimeout;\n transferables = [...(runOptions.transferables ?? [])];\n } catch (error) {\n return Promise.reject(error);\n }\n\n return core.acquire({ priority, signal: runOptions.signal }, (slot) => {\n core.trackActive(1);\n\n const onAbort = () => slot.cancel(abortError(runOptions.signal!));\n runOptions.signal?.addEventListener('abort', onAbort, { once: true });\n\n const finish = async (): Promise<TOutput> => {\n try {\n const value = await slot.run(input, transferables, timeout);\n\n core.trackCompleted();\n\n return value;\n } catch (error) {\n if (!runOptions.signal?.aborted && !(error instanceof FamiliarTerminatedError)) core.trackFailed();\n\n throw error;\n } finally {\n runOptions.signal?.removeEventListener('abort', onAbort);\n core.trackActive(-1);\n core.release(slot);\n core.settleIdle();\n }\n };\n\n return finish();\n });\n }\n\n return {\n get disposalSignal() {\n return core.disposalSignal;\n },\n dispose: core.dispose,\n get disposed() {\n return core.disposed;\n },\n drain: core.drain,\n run,\n get stats() {\n return core.stats();\n },\n get status() {\n return core.status();\n },\n tap: core.tap,\n [Symbol.asyncDispose]: () => core.drain({}),\n [Symbol.dispose]: core.dispose,\n };\n}\n\nexport type BatchOptions<TInput> = Pick<RunOptions, 'priority' | 'signal' | 'timeout'> & {\n getTransferables?: (input: TInput, index: number) => readonly Transferable[];\n};\n\n/** Run related tasks concurrently and yield their results in input order. */\nexport function runBatch<TInput, TOutput>(\n pool: WorkerPool<TInput, TOutput>,\n inputs: readonly TInput[],\n options: BatchOptions<TInput> = {},\n): AsyncIterable<TOutput> {\n let owner: object | undefined;\n\n const iterate = async function* (controller: AbortController): AsyncGenerator<TOutput> {\n const tasks: Promise<TOutput>[] = [];\n const onAbort = () => controller.abort(options.signal?.reason);\n\n if (options.signal?.aborted) controller.abort(options.signal.reason);\n else options.signal?.addEventListener('abort', onAbort, { once: true });\n\n try {\n for (const [index, input] of inputs.entries()) {\n const task = pool\n .run(input, {\n priority: options.priority,\n signal: controller.signal,\n timeout: options.timeout,\n transferables: options.getTransferables?.(input, index),\n })\n .catch((error: unknown) => {\n controller.abort(error);\n throw error;\n });\n\n void task.catch(() => undefined);\n tasks.push(task);\n }\n\n if (tasks.length === 0 && controller.signal.aborted) throw abortError(controller.signal);\n for (const task of tasks) {\n if (controller.signal.aborted) throw abortError(controller.signal);\n const value = await task;\n if (controller.signal.aborted) throw abortError(controller.signal);\n yield value;\n }\n } catch (error) {\n controller.abort(error);\n throw error;\n } finally {\n options.signal?.removeEventListener('abort', onAbort);\n controller.abort(new DOMException('Batch consumer stopped', 'AbortError'));\n await Promise.allSettled(tasks);\n }\n };\n\n return {\n [Symbol.asyncIterator]() {\n const token = {};\n const controller = new AbortController();\n let iterator: AsyncGenerator<TOutput> | undefined;\n const start = (): AsyncGenerator<TOutput> | undefined => {\n owner ??= token;\n if (owner !== token) return undefined;\n iterator ??= iterate(controller);\n return iterator;\n };\n\n return {\n next: () =>\n start()?.next() ?? Promise.reject(new FamiliarRuntimeError('Worker batches can only be consumed once')),\n return: async (value?: unknown) => {\n if (!owner || owner !== token) return { done: true, value: value as TOutput };\n controller.abort(new FamiliarTerminatedError('Batch consumer stopped'));\n return iterator?.return(value as TOutput) ?? { done: true, value: value as TOutput };\n },\n throw: async (error?: unknown) => {\n const active = start();\n if (!active) throw new FamiliarRuntimeError('Worker batches can only be consumed once');\n controller.abort(error);\n return active.throw(error);\n },\n };\n },\n };\n}\n","import { abortError } from '@vielzeug/arsenal';\nimport { createPoolCore, type PoolCore, type PoolOptions, validatePriority, validateTimeout } from './_pool-core.js';\nimport { FamiliarRuntimeError, FamiliarTerminatedError } from './errors.js';\nimport type { RunOptions, StreamWorkerPool } from './types.js';\n\nexport type StreamSlot<TInput, TChunk> = {\n cancel(reason: unknown): void;\n /** Wired by the pool factory to report unhandled worker runtime errors through `tap()`. */\n notify?(error: FamiliarRuntimeError): void;\n stream(input: TInput, options: RunOptions): { done: Promise<void>; iterable: AsyncIterable<TChunk> };\n terminate(): void;\n};\n\nexport function createStreamPool<TInput, TChunk>(\n slots: readonly StreamSlot<TInput, TChunk>[],\n options: PoolOptions,\n): StreamWorkerPool<TInput, TChunk> {\n const core: PoolCore<StreamSlot<TInput, TChunk>> = createPoolCore(slots, options);\n\n for (const slot of slots) slot.notify = (error) => core.emitTap({ error, type: 'worker-error' });\n\n function runStream(input: TInput, runOptions: RunOptions = {}): AsyncIterable<TChunk> {\n const priority = validatePriority(runOptions.priority ?? 0);\n const timeout = validateTimeout(runOptions.timeout) ?? options.defaultTimeout;\n const transferables = [...(runOptions.transferables ?? [])];\n let owner: object | undefined;\n\n const iterate = async function* (controller: AbortController): AsyncGenerator<TChunk> {\n const onAbort = () => controller.abort(runOptions.signal?.reason);\n let slot: StreamSlot<TInput, TChunk> | undefined;\n let onCancel: (() => void) | undefined;\n\n if (runOptions.signal?.aborted) controller.abort(runOptions.signal.reason);\n else runOptions.signal?.addEventListener('abort', onAbort, { once: true });\n\n try {\n const running = await core.acquire({ priority, signal: controller.signal }, (acquired) => {\n slot = acquired;\n core.trackActive(1);\n onCancel = () => slot?.cancel(abortError(controller.signal));\n controller.signal.addEventListener('abort', onCancel, { once: true });\n\n return acquired.stream(input, { priority, signal: controller.signal, timeout, transferables });\n });\n\n for await (const value of running.iterable) yield value;\n await running.done;\n core.trackCompleted();\n } catch (error) {\n if (slot && !controller.signal.aborted && !(error instanceof FamiliarTerminatedError)) core.trackFailed();\n throw error;\n } finally {\n runOptions.signal?.removeEventListener('abort', onAbort);\n\n if (slot) {\n if (onCancel) controller.signal.removeEventListener('abort', onCancel);\n\n core.trackActive(-1);\n core.release(slot);\n core.settleIdle();\n }\n }\n };\n\n return {\n [Symbol.asyncIterator]() {\n const token = {};\n const controller = new AbortController();\n let iterator: AsyncGenerator<TChunk> | undefined;\n const start = (): AsyncGenerator<TChunk> | undefined => {\n owner ??= token;\n if (owner !== token) return undefined;\n iterator ??= iterate(controller);\n return iterator;\n };\n\n return {\n next: () =>\n start()?.next() ?? Promise.reject(new FamiliarRuntimeError('Worker streams can only be consumed once')),\n return: async (value?: unknown) => {\n if (!owner || owner !== token) return { done: true, value: value as TChunk };\n controller.abort(new FamiliarTerminatedError('Stream consumer stopped'));\n return iterator?.return(value as TChunk) ?? { done: true, value: value as TChunk };\n },\n throw: async (error?: unknown) => {\n const active = start();\n if (!active) throw new FamiliarRuntimeError('Worker streams can only be consumed once');\n controller.abort(error);\n return active.throw(error);\n },\n };\n },\n };\n }\n\n return {\n get disposalSignal() {\n return core.disposalSignal;\n },\n dispose: core.dispose,\n get disposed() {\n return core.disposed;\n },\n drain: core.drain,\n runStream,\n get stats() {\n return core.stats();\n },\n get status() {\n return core.status();\n },\n tap: core.tap,\n [Symbol.asyncDispose]: () => core.drain({}),\n [Symbol.dispose]: core.dispose,\n };\n}\n","import { createPool } from './_pool.js';\nimport { MAX_CONCURRENCY, validateTimeout } from './_pool-core.js';\nimport { createStreamPool, type StreamSlot } from './_stream-pool.js';\nimport { unrefTimer } from './_timers.js';\nimport {\n FamiliarInvalidOptionsError,\n FamiliarRuntimeError,\n FamiliarTaskError,\n FamiliarTerminatedError,\n FamiliarTimeoutError,\n} from './errors.js';\nimport type { SerializedError, WorkerResponse } from './protocol.js';\nimport { PROTOCOL_VERSION } from './protocol.js';\nimport type { RunOptions, SlotStrategy, StreamWorkerPool, WorkerOptions, WorkerPool } from './types.js';\n\ntype ResolvedOptions = {\n concurrency: number;\n maxQueue: number | undefined;\n onFull: 'reject' | 'wait';\n timeout: number | undefined;\n};\n\ntype Pending<TOutput> = {\n emit?: (value: TOutput) => void;\n id: number;\n kind: 'run' | 'stream';\n reject: (reason: unknown) => void;\n resolve: (value: TOutput) => void;\n timer?: ReturnType<typeof setTimeout>;\n};\n\ntype RunningStream<TChunk> = {\n done: Promise<void>;\n iterable: AsyncIterable<TChunk>;\n};\n\nfunction resolveOptions(options: WorkerOptions = {}): ResolvedOptions {\n const { concurrency = 1, maxQueue, onFull = 'reject', timeout } = options;\n const resolvedConcurrency =\n concurrency === 'auto'\n ? Math.min(MAX_CONCURRENCY, Math.max(1, globalThis.navigator?.hardwareConcurrency ?? 1))\n : concurrency;\n\n if (!Number.isInteger(resolvedConcurrency) || resolvedConcurrency < 1 || resolvedConcurrency > MAX_CONCURRENCY) {\n throw new FamiliarInvalidOptionsError(`\\`concurrency\\` must be a positive integer ≤ ${MAX_CONCURRENCY} or \"auto\"`);\n }\n\n if (maxQueue !== undefined && (!Number.isInteger(maxQueue) || maxQueue < 1)) {\n throw new FamiliarInvalidOptionsError('`maxQueue` must be a positive integer');\n }\n\n if (onFull !== 'reject' && onFull !== 'wait') {\n throw new FamiliarInvalidOptionsError('`onFull` must be \"reject\" or \"wait\"');\n }\n\n validateTimeout(timeout);\n\n return { concurrency: resolvedConcurrency, maxQueue, onFull, timeout };\n}\n\nfunction isWorkerResponse<TOutput>(value: unknown): value is WorkerResponse<TOutput> {\n if (typeof value !== 'object' || value === null) return false;\n\n const response = value as Partial<WorkerResponse<TOutput>>;\n if (\n response.version !== PROTOCOL_VERSION ||\n typeof response.id !== 'number' ||\n !Number.isSafeInteger(response.id) ||\n response.id < 0\n )\n return false;\n\n if (response.kind === 'chunk' || response.kind === 'result') return 'value' in response;\n if (response.kind !== 'error' || typeof response.error !== 'object' || response.error === null) return false;\n\n return (\n (response.error.category === undefined || response.error.category === 'protocol') &&\n typeof response.error.message === 'string' &&\n typeof response.error.name === 'string' &&\n (response.error.stack === undefined || typeof response.error.stack === 'string')\n );\n}\n\nfunction responseError(error: SerializedError): FamiliarRuntimeError | FamiliarTaskError {\n const cause = new Error(error.message);\n\n cause.name = error.name;\n cause.stack = error.stack;\n\n return error.category === 'protocol'\n ? new FamiliarRuntimeError(error.message, { cause })\n : new FamiliarTaskError(error.message, { cause });\n}\n\nclass Slot<TInput, TOutput> implements SlotStrategy<TInput, TOutput>, StreamSlot<TInput, TOutput> {\n readonly #url: URL | string;\n #disposed = false;\n #pending: Pending<TOutput> | undefined;\n #taskId = 0;\n #worker: Worker | undefined;\n\n /** Wired by the pool factory to report unhandled worker runtime errors through `tap()`. */\n notify: ((error: FamiliarRuntimeError) => void) | undefined = undefined;\n\n constructor(url: URL | string) {\n this.#url = url;\n }\n\n cancel(reason: unknown): void {\n if (!this.#pending) return;\n this.#stopWorker();\n this.#settlePending('reject', reason);\n }\n\n run(input: TInput, transferables: Transferable[], timeout: number | undefined): Promise<TOutput> {\n return this.#dispatch(input, transferables, timeout, 'run') as Promise<TOutput>;\n }\n\n stream(input: TInput, options: RunOptions): RunningStream<TOutput> {\n const stop = () => this.cancel(new FamiliarTerminatedError('Stream consumer stopped'));\n const chunks: TOutput[] = [];\n const waiters: Array<(result: IteratorResult<TOutput>) => void> = [];\n let done = false;\n let error: unknown;\n const emit = (value: TOutput) => {\n const waiter = waiters.shift();\n\n if (waiter) waiter({ done: false, value });\n else chunks.push(value);\n };\n const finish = (reason?: unknown) => {\n done = true;\n error = reason;\n\n while (waiters.length > 0) {\n const waiter = waiters.shift()!;\n\n if (reason !== undefined) waiter(Promise.reject(reason) as never);\n else waiter({ done: true, value: undefined as never });\n }\n };\n const donePromise = this.#dispatch(input, [...(options.transferables ?? [])], options.timeout, 'stream', emit).then(\n () => finish(),\n (reason: unknown) => finish(reason),\n );\n\n return {\n done: donePromise,\n iterable: {\n [Symbol.asyncIterator]: () => ({\n async next(): Promise<IteratorResult<TOutput>> {\n if (chunks.length > 0) return { done: false, value: chunks.shift()! };\n\n if (error !== undefined) throw error;\n\n if (done) return { done: true, value: undefined as never };\n\n return new Promise<IteratorResult<TOutput>>((resolve, reject) => {\n waiters.push((result) => {\n if (result instanceof Promise) void result.then(resolve, reject);\n else resolve(result);\n });\n });\n },\n async return(): Promise<IteratorResult<TOutput>> {\n stop();\n\n return { done: true, value: undefined as never };\n },\n }),\n },\n };\n }\n\n terminate(): void {\n this.#disposed = true;\n this.#stopWorker();\n this.#settlePending('reject', new FamiliarTerminatedError());\n }\n\n #dispatch(\n input: TInput,\n transferables: Transferable[],\n timeout: number | undefined,\n kind: 'run' | 'stream',\n emit?: (value: TOutput) => void,\n ): Promise<TOutput> {\n if (this.#disposed) return Promise.reject(new FamiliarTerminatedError());\n\n if (this.#pending) return Promise.reject(new FamiliarRuntimeError('Worker slot is already busy'));\n\n try {\n const worker = this.#ensureWorker();\n const id = this.#taskId;\n this.#taskId = id === Number.MAX_SAFE_INTEGER ? 0 : id + 1;\n\n return new Promise<TOutput>((resolve, reject) => {\n const pending: Pending<TOutput> = { emit, id, kind, reject, resolve };\n\n this.#pending = pending;\n\n if (timeout !== undefined) {\n pending.timer = setTimeout(() => this.cancel(new FamiliarTimeoutError(timeout)), timeout);\n unrefTimer(pending.timer);\n }\n\n try {\n worker.postMessage({ id, input, kind, version: PROTOCOL_VERSION }, transferables);\n } catch (error) {\n this.cancel(new FamiliarRuntimeError('Failed to post message to worker', { cause: error }));\n }\n });\n } catch (error) {\n return Promise.reject(error);\n }\n }\n\n #ensureWorker(): Worker {\n if (this.#worker) return this.#worker;\n\n if (typeof Worker === 'undefined') throw new FamiliarRuntimeError('Worker API is unavailable in this runtime');\n\n try {\n const worker = new Worker(this.#url, { type: 'module' });\n\n worker.onmessage = (event: MessageEvent<unknown>) => {\n if (this.#worker === worker) this.#onMessage(event.data);\n };\n worker.onerror = (event) => this.#failWorker(worker, new FamiliarRuntimeError(event.message || 'Worker failed'));\n worker.onmessageerror = () =>\n this.#failWorker(worker, new FamiliarRuntimeError('Worker response could not be deserialized'));\n this.#worker = worker;\n\n return worker;\n } catch (error) {\n throw new FamiliarRuntimeError('Failed to create Worker', { cause: error });\n }\n }\n\n #stopWorker(): void {\n const worker = this.#worker;\n this.#worker = undefined;\n if (!worker) return;\n\n worker.onmessage = null;\n worker.onerror = null;\n worker.onmessageerror = null;\n worker.terminate();\n }\n\n #failWorker(worker: Worker, error: FamiliarRuntimeError): void {\n if (this.#worker !== worker) return;\n\n this.#stopWorker();\n this.#settlePending('reject', error);\n this.notify?.(error);\n }\n\n #onMessage(message: unknown): void {\n if (!this.#pending) return;\n\n if (\n !isWorkerResponse<TOutput>(message) ||\n message.id !== this.#pending.id ||\n (this.#pending.kind === 'run' && message.kind === 'chunk')\n ) {\n this.cancel(new FamiliarRuntimeError('Worker returned an incompatible protocol response'));\n\n return;\n }\n\n if (message.kind === 'chunk') {\n this.#pending.emit?.(message.value);\n\n return;\n }\n\n if (message.kind === 'error') {\n this.#settlePending('reject', responseError(message.error));\n\n return;\n }\n\n this.#settlePending('resolve', message.value);\n }\n\n #settlePending(kind: 'resolve' | 'reject', value: unknown): void {\n const pending = this.#pending;\n\n if (!pending) return;\n\n this.#pending = undefined;\n\n if (pending.timer) clearTimeout(pending.timer);\n\n if (kind === 'resolve') pending.resolve(value as TOutput);\n else pending.reject(value);\n }\n}\n\nfunction slots<TInput, TOutput>(url: URL | string, options: ResolvedOptions): Slot<TInput, TOutput>[] {\n const resolvedUrl = typeof url === 'string' ? url : url.href;\n return Array.from({ length: options.concurrency }, () => new Slot<TInput, TOutput>(resolvedUrl));\n}\n\n/** Create a pool backed by an ES module worker registered with exposeTask(). */\nexport function createWorker<TInput, TOutput>(\n url: URL | string,\n options: WorkerOptions = {},\n): WorkerPool<TInput, TOutput> {\n const resolved = resolveOptions(options);\n\n return createPool(slots<TInput, TOutput>(url, resolved), {\n defaultTimeout: resolved.timeout,\n maxQueue: resolved.maxQueue,\n onFull: resolved.onFull,\n });\n}\n\n/** Create a stream-only pool backed by an ES module worker registered with exposeStream(). */\nexport function createStreamWorker<TInput, TChunk>(\n url: URL | string,\n options: WorkerOptions = {},\n): StreamWorkerPool<TInput, TChunk> {\n const resolved = resolveOptions(options);\n\n return createStreamPool(slots<TInput, TChunk>(url, resolved), {\n defaultTimeout: resolved.timeout,\n maxQueue: resolved.maxQueue,\n onFull: resolved.onFull,\n });\n}\n"],"mappings":"A,sGAOA,SAAgB,WAAW,EAA6E,CAClG,OAAOK,GAAU,UAAYA,GAAkB,UAAWA,GAC5DA,EAA6B,MAAM,CAEvC,CCVA,IAAa,cAAb,cAAmC,KAAM,CACvC,YAAY,EAAiB,EAAqB,CAChD,MAAMC,EAASC,CAAI,EACnB,KAAK,KAAO,WAAW,KACvB,OAAO,eAAe,KAAM,WAAW,SAAS,CAClD,CACF,EAGa,4BAAb,cAAiD,aAAc,CAAC,EAGnD,uBAAb,cAA4C,aAAc,CAExD,SAEA,YAAY,EAAkB,CAC5B,MAAM,2BAA2BC,EAAS,EAAE,EAC5C,KAAK,SAAWA,CAClB,CACF,EAGa,kBAAb,cAAuC,aAAc,CAAC,EAGzC,wBAAb,cAA6C,aAAc,CACzD,YAAY,EAAU,wBAAyB,CAC7C,MAAMF,CAAO,CACf,CACF,EAGa,qBAAb,cAA0C,aAAc,CAEtD,UAEA,YAAY,EAAmB,EAAY,OAAQ,CACjD,MAAM,GAAGG,EAAU,mBAAmBC,EAAU,GAAG,EACnD,KAAK,UAAYA,CACnB,CACF,EAGa,qBAAb,cAA0C,aAAc,CAAC,ECjC5CC,EAAc,WAE3B,SAAgB,iBAAiB,EAA0B,CACzD,GAAI,CAAC,OAAO,SAASC,CAAQ,EAAG,MAAM,IAAI,4BAA4B,oCAAoC,EAC1G,OAAOA,CACT,CAEA,SAAgB,gBAAgB,EAA6B,EAAO,UAA+B,CACjG,GAAIC,IAAY,IAAA,KAAc,CAAC,OAAO,UAAUA,CAAO,GAAKA,EAAU,GAAKA,EAAA,YACzE,MAAM,IAAI,4BAA4B,KAAKC,EAAK,uCAAuCH,GAAa,EAEtG,OAAOE,CACT,CAgFA,SAAgB,eAAuC,EAAyB,EAAuC,CACrH,IAAME,EAAY,CAAC,GAAGC,CAAK,EACrBC,EAA+B,CAAC,EAChCC,EAA4B,CAAC,EAC7BC,EAAoC,CAAC,EACrCC,GAAA,EAAUpB,EAAAA,OAAAA,CAAyB,EACnCqB,EAAqB,IAAI,gBAC3BC,EAAS,EACTC,EAAiB,EACjBC,EAAmB,EACnBC,EAAY,EACZC,EAAS,EACTC,EACAC,EAAa,GAEjB,SAAS,QAAkB,CACzB,OAAOb,EAAU,SAAWC,EAAM,QAAUC,EAAQ,SAAW,CACjE,CAEA,SAAS,YAAmB,CAC1B,GAAK,OAAO,EAEZ,IAAK,IAAMY,KAAUX,EAAY,OAAO,CAAC,EACnCW,EAAO,OAAO,aAAaA,EAAO,KAAK,EAE3CA,EAAO,QAAQ,CAEnB,CAEA,SAAS,YAAY,EAA2C,CAG9D,OAFI,OAAO,EAAU,QAAQ,QAAQ,EAE9B,IAAI,SAAe,EAAS,IAAW,CAC5C,IAAMA,EAAqB,CAAE,SAAQ,SAAQ,EAEzCC,EAAa,UAAY,IAAA,KAC3B,EAAO,MAAQ,eAAiB,CAC9B,IAAMC,EAAQb,EAAY,QAAQW,CAAM,EAEpCE,IAAU,IAAIb,EAAY,OAAOa,EAAO,CAAC,EAE7CC,EAAO,IAAI,qBAAqBF,EAAa,QAAU,OAAO,CAAC,CACjE,EAAGA,EAAa,OAAO,EACvB,WAAWD,EAAO,KAAK,GAGzBX,EAAY,KAAKW,CAAM,CACzB,CAAC,CACH,CAEA,SAAS,iBAAwB,CAC/BV,EAAgB,MAAM,CAAC,EAAE,QAAQ,CACnC,CAEA,SAAS,eAAe,EAAuB,CAC7C,IAAK,IAAMU,KAAUV,EAAgB,OAAO,CAAC,EAAGU,EAAO,OAAOI,CAAM,CACtE,CAEA,SAAS,gBAAgB,EAAiC,EAAiC,CAGzF,OAFIC,GAAQ,QAAgB,QAAQ,QAAA,EAAOjC,EAAAA,WAAAA,CAAWiC,CAAM,CAAC,EAEtD,IAAI,SAAe,EAAS,IAAW,CAC5C,IAAIC,EAAU,GACRN,EAAyB,CAC7B,SAAU,CACRK,GAAQ,oBAAoB,QAAS,OAAO,CAC9C,EACA,WACA,OAAO,EAAQ,CACb,GAAIC,EAAS,OAEb,EAAU,GACVN,EAAO,QAAQ,EAEf,IAAME,EAAQZ,EAAgB,QAAQU,CAAM,EAExCE,IAAU,IAAIZ,EAAgB,OAAOY,EAAO,CAAC,EAEjDC,EAAOC,CAAM,CACf,EACA,SAAU,CACJE,IAEJ,EAAU,GACVN,EAAO,QAAQ,EACfO,EAAQ,EACV,EACA,SAAU,GACZ,EACM,YAAgBP,EAAO,QAAA,EAAO5B,EAAAA,WAAAA,CAAWiC,CAAO,CAAC,EAEvDA,GAAQ,iBAAiB,QAAS,QAAS,CAAE,KAAM,EAAK,CAAC,EACzDf,EAAgB,KAAKU,CAAM,EAC3BV,EAAgB,MAAM,EAAG,IAAMkB,EAAE,SAAWC,EAAE,UAAYA,EAAE,SAAWD,EAAE,QAAQ,CACnF,CAAC,CACH,CAEA,SAAS,QAAW,EAAgC,EAA0D,CAC5G,GAAM,CAAE,WAAU,UAAWE,EAI7B,OAFIL,GAAQ,QAAgB,QAAQ,QAAA,EAAOjC,EAAAA,WAAAA,CAAWiC,CAAM,CAAC,GAErD,SAAY,CAClB,OAAS,CACP,GAAIN,EAAY,MAAM,IAAI,wBAE1B,GAAID,EAAc,MAAM,IAAI,wBAAwB,oBAAoB,EAExE,GAAIa,EAAQ,WAAa,IAAA,IAAavB,EAAQ,OAASuB,EAAQ,SAC7D,OAAO,MAAMD,EAAiBE,IAAQ,GAASC,EAAyC,EAG1F,GAAIF,EAAQ,SAAW,SAAU,MAAM,IAAI,uBAAuBA,EAAQ,QAAQ,EAIlF,GAFA,MAAM,gBAAgBN,EAAQtB,CAAQ,EAElCsB,GAAQ,QAEV,MADA,gBAAgB,GAChB,EAAMjC,EAAAA,WAAAA,CAAWiC,CAAM,CAE3B,CACF,EAAA,CAAG,CACL,CAEA,SAAS,MAAS,EAAgC,EAAiD,CACjG,GAAM,CAAE,WAAU,UAAWK,EAEvBI,EAAO5B,EAAU,IAAI,EAE3B,GAAI4B,EACF,GAAI,CACF,OAAO,QAAQ,QAAQF,EAAGE,CAAI,CAAC,CACjC,OAASC,EAAO,CAKd,OAHA,QAAQD,CAAI,EACZ,WAAW,EAEJ,QAAQ,OAAOC,CAAK,CAC7B,CAGF,OAAO,IAAI,SAAY,EAAS,IAAW,CACzC,IAAMf,EAA4B,CAChC,SAAU,CACRA,EAAO,QAAQ,oBAAoB,QAAS,OAAO,CACrD,EACA,WACA,OAAO,EAAQ,CACbA,EAAO,QAAQ,EAEf,IAAME,EAAQd,EAAQ,QAAQY,CAAM,EAEhCE,IAAU,KACZd,EAAQ,OAAOc,EAAO,CAAC,EACvB,gBAAgB,GAGlBC,EAAOC,CAAM,EACb,WAAW,CACb,EACA,SAAU,IACV,SACA,MAAM,EAAM,CACVJ,EAAO,QAAQ,EAEf,GAAI,CACFO,EAAQK,EAAGC,CAAI,CAAC,CAClB,OAASE,EAAO,CACd,QAAQF,CAAI,EACZ,WAAW,EACXV,EAAOY,CAAK,CACd,CACF,CACF,EACM,YAAgBf,EAAO,QAAA,EAAO5B,EAAAA,WAAAA,CAAW4B,EAAO,MAAO,CAAC,EAE9DA,EAAO,QAAQ,iBAAiB,QAAS,QAAS,CAAE,KAAM,EAAK,CAAC,EAChEZ,EAAQ,KAAKY,CAAM,EACnBZ,EAAQ,MAAM,EAAG,IAAMoB,EAAE,SAAWC,EAAE,UAAYA,EAAE,SAAWD,EAAE,QAAQ,CAC3E,CAAC,CACH,CAEA,SAAS,QAAQ,EAAmB,CAClC,IAAMQ,EAAO5B,EAAQ,MAAM,EAEvB4B,GACFA,EAAK,MAAMH,CAAI,EACf,gBAAgB,GAEhB3B,EAAU,KAAK2B,CAAI,CAEvB,CAEA,SAAS,SAAgB,CACvB,GAAI,GAEJ,GAAa,GACbrB,EAAmB,MAAM,EAEzB,IAAK,IAAMqB,KAAQ1B,EAAO0B,EAAK,UAAU,EAEzC,IAAK,IAAMb,KAAUZ,EAAQ,OAAO,CAAC,EAAGY,EAAO,OAAO,IAAI,uBAAyB,EAEnF,eAAe,IAAI,uBAAyB,EAC5C,WAAW,EACXT,EAAQ,KAAK,CAAE,KAAM,SAAU,CAAC,EAChCA,EAAQ,MAAM,CAVD,CAWf,CAEA,SAAS,MAAM,EAA6B,CAAC,EAAkB,CAC7D,GAAIQ,EAAY,OAAO,QAAQ,QAAQ,EACvC,GAAI,CACF,gBAAgBE,EAAa,QAAS,eAAe,CACvD,OAASc,EAAO,CACd,OAAO,QAAQ,OAAOA,CAAK,CAC7B,CAaA,OAXIjB,IAEJ,eAAe,IAAI,wBAAwB,oBAAoB,CAAC,EAChE,EAAe,YAAYG,CAAY,CAAC,CAAC,SACjC,QAAQ,EACb,GAAmB,CAElB,MADA,QAAQ,EACFc,CACR,CACF,EAEOjB,EACT,CAEA,MAAO,CACL,QACA,eAAgBN,EAAmB,OACnC,QACA,IAAI,UAAW,CACb,OAAOO,CACT,EACA,MACA,IAAI,cAAe,CACjB,OAAOD,CACT,EACA,QAAQ,EAAO,CACbP,EAAQ,KAAK0B,CAAK,CACpB,EACA,QACA,WACA,OAAQ,CACN,MAAO,CAAE,SAAQ,YAAW,SAAQ,OAAQ7B,EAAQ,OAASE,EAAgB,MAAO,CACtF,EACA,QAAS,CAGP,OAFIS,EAAmB,aAEhBN,IAAW,EAAI,OAAS,SACjC,EACA,IAAI,EAAS,EAAY,CAGvB,OAFIM,MAAyB,IAAA,GAEtBR,EAAQ,IAAI2B,EAASC,CAAU,CACxC,EACA,YAAY,EAAe,CACzB,GAAUC,CACZ,EACA,gBAAiB,CACf,GAAa,CACf,EACA,aAAc,CACZ,GAAU,CACZ,CACF,CACF,CC/WA,SAAgB,WACd,EACA,EAC6B,CAC7B,IAAMC,EAAgD,eAAelC,EAAOwB,CAAO,EAEnF,IAAK,IAAME,KAAQ1B,EAAO,EAAK,OAAU,GAAUkC,EAAK,QAAQ,CAAE,QAAO,KAAM,cAAe,CAAC,EAE/F,SAAS,IAAI,EAAe,EAAyB,CAAC,EAAqB,CACzE,IAAItC,EACAC,EACAsC,EAEJ,GAAI,CACF,EAAW,iBAAiBC,EAAW,UAAY,CAAC,EACpD,EAAU,gBAAgBA,EAAW,OAAO,GAAKZ,EAAQ,eACzD,EAAgB,CAAC,GAAIY,EAAW,eAAiB,CAAC,CAAE,CACtD,OAASR,EAAO,CACd,OAAO,QAAQ,OAAOA,CAAK,CAC7B,CAEA,OAAOM,EAAK,QAAQ,CAAE,WAAU,OAAQE,EAAW,MAAO,EAAI,GAAS,CACrEF,EAAK,YAAY,CAAC,EAElB,IAAM,YAAgBR,EAAK,QAAA,EAAOxC,EAAAA,WAAAA,CAAWkD,EAAW,MAAO,CAAC,EAChEA,EAAW,QAAQ,iBAAiB,QAAS,QAAS,CAAE,KAAM,EAAK,CAAC,EAEpE,IAAM,OAAS,SAA8B,CAC3C,GAAI,CACF,IAAMC,EAAQ,MAAMX,EAAK,IAAIY,EAAOH,EAAetC,CAAO,EAI1D,OAFAqC,EAAK,eAAe,EAEbG,CACT,OAAST,EAAO,CAGd,KAFI,CAACQ,EAAW,QAAQ,SAAW,EAAER,aAAiB,0BAA0BM,EAAK,YAAY,EAE3FN,CACR,QAAU,CACRQ,EAAW,QAAQ,oBAAoB,QAAS,OAAO,EACvDF,EAAK,YAAY,EAAE,EACnBA,EAAK,QAAQR,CAAI,EACjBQ,EAAK,WAAW,CAClB,CACF,EAEA,OAAO,OAAO,CAChB,CAAC,CACH,CAEA,MAAO,CACL,IAAI,gBAAiB,CACnB,OAAOA,EAAK,cACd,EACA,QAASA,EAAK,QACd,IAAI,UAAW,CACb,OAAOA,EAAK,QACd,EACA,MAAOA,EAAK,MACZ,IACA,IAAI,OAAQ,CACV,OAAOA,EAAK,MAAM,CACpB,EACA,IAAI,QAAS,CACX,OAAOA,EAAK,OAAO,CACrB,EACA,IAAKA,EAAK,KACT,OAAO,kBAAqBA,EAAK,MAAM,CAAC,CAAC,GACzC,OAAO,SAAUA,EAAK,OACzB,CACF,CAOA,SAAgB,SACd,EACA,EACA,EAAgC,CAAC,EACT,CACxB,IAAIK,EAEE,QAAU,gBAAiB,EAAsD,CACrF,IAAMC,EAA4B,CAAC,EAC7B,YAAgBC,EAAW,MAAMjB,EAAQ,QAAQ,MAAM,EAEzDA,EAAQ,QAAQ,QAASiB,EAAW,MAAMjB,EAAQ,OAAO,MAAM,EAC9DA,EAAQ,QAAQ,iBAAiB,QAAS,QAAS,CAAE,KAAM,EAAK,CAAC,EAEtE,GAAI,CACF,IAAK,GAAM,CAACT,EAAOuB,KAAUI,EAAO,QAAQ,EAAG,CAC7C,IAAMC,EAAOC,EACV,IAAIN,EAAO,CACV,SAAUd,EAAQ,SAClB,OAAQiB,EAAW,OACnB,QAASjB,EAAQ,QACjB,cAAeA,EAAQ,mBAAmBc,EAAOvB,CAAK,CACxD,CAAC,CAAC,CACD,MAAO,GAAmB,CAEzB,MADA0B,EAAW,MAAMb,CAAK,EAChBA,CACR,CAAC,EAEHe,EAAU,UAAY,IAAA,EAAS,EAC/BH,EAAM,KAAKG,CAAI,CACjB,CAEA,GAAIH,EAAM,SAAW,GAAKC,EAAW,OAAO,QAAS,MAAA,EAAMvD,EAAAA,WAAAA,CAAWuD,EAAW,MAAM,EACvF,IAAK,IAAME,KAAQH,EAAO,CACxB,GAAIC,EAAW,OAAO,QAAS,MAAA,EAAMvD,EAAAA,WAAAA,CAAWuD,EAAW,MAAM,EACjE,IAAMJ,EAAQ,MAAMM,EACpB,GAAIF,EAAW,OAAO,QAAS,MAAA,EAAMvD,EAAAA,WAAAA,CAAWuD,EAAW,MAAM,EACjE,MAAMJ,CACR,CACF,OAAST,EAAO,CAEd,MADAa,EAAW,MAAMb,CAAK,EAChBA,CACR,QAAU,CACRJ,EAAQ,QAAQ,oBAAoB,QAAS,OAAO,EACpDiB,EAAW,MAAM,IAAI,aAAa,yBAA0B,YAAY,CAAC,EACzE,MAAM,QAAQ,WAAWD,CAAK,CAChC,CACF,EAEA,MAAO,CACL,CAAC,OAAO,gBAAiB,CACvB,IAAMK,EAAQ,CAAC,EACTJ,EAAa,IAAI,gBACnBK,EACE,UAAmD,CAEvD,GADA,IAAUD,EACNN,IAAUM,EAEd,MADA,KAAa,QAAQJ,CAAU,EACxBK,CACT,EAEA,MAAO,CACL,SACE,MAAM,CAAC,EAAE,KAAK,GAAK,QAAQ,OAAO,IAAI,qBAAqB,0CAA0C,CAAC,EACxG,OAAQ,KAAO,IACT,CAACP,GAASA,IAAUM,EAAc,CAAE,KAAM,GAAa,OAAiB,GAC5EJ,EAAW,MAAM,IAAI,wBAAwB,wBAAwB,CAAC,EAC/DK,GAAU,OAAOT,CAAgB,GAAK,CAAE,KAAM,GAAa,OAAiB,GAErF,MAAO,KAAO,IAAoB,CAChC,IAAM/B,EAAS,MAAM,EACrB,GAAI,CAACA,EAAQ,MAAM,IAAI,qBAAqB,0CAA0C,EAEtF,OADAmC,EAAW,MAAMb,CAAK,EACftB,EAAO,MAAMsB,CAAK,CAC3B,CACF,CACF,CACF,CACF,CCrJA,SAAgB,iBACd,EACA,EACkC,CAClC,IAAMM,EAA6C,eAAelC,EAAOwB,CAAO,EAEhF,IAAK,IAAME,KAAQ1B,EAAO,EAAK,OAAU,GAAUkC,EAAK,QAAQ,CAAE,QAAO,KAAM,cAAe,CAAC,EAE/F,SAAS,UAAU,EAAe,EAAyB,CAAC,EAA0B,CACpF,IAAMtC,EAAW,iBAAiBwC,EAAW,UAAY,CAAC,EACpDvC,EAAU,gBAAgBuC,EAAW,OAAO,GAAKZ,EAAQ,eACzDW,EAAgB,CAAC,GAAIC,EAAW,eAAiB,CAAC,CAAE,EACtDG,EAEE,QAAU,gBAAiB,EAAqD,CACpF,IAAM,YAAgBE,EAAW,MAAML,EAAW,QAAQ,MAAM,EAC5DV,EACA,SAEAU,EAAW,QAAQ,QAASK,EAAW,MAAML,EAAW,OAAO,MAAM,EACpEA,EAAW,QAAQ,iBAAiB,QAAS,QAAS,CAAE,KAAM,EAAK,CAAC,EAEzE,GAAI,CACF,IAAMW,EAAU,MAAMb,EAAK,QAAQ,CAAE,WAAU,OAAQO,EAAW,MAAO,EAAI,IAC3E,EAAOO,EACPd,EAAK,YAAY,CAAC,EAClB,aAAiBR,GAAM,QAAA,EAAOvC,EAAAA,WAAAA,CAAWsD,EAAW,MAAM,CAAC,EAC3DA,EAAW,OAAO,iBAAiB,QAAS,SAAU,CAAE,KAAM,EAAK,CAAC,EAE7DO,EAAS,OAAOV,EAAO,CAAE,WAAU,OAAQG,EAAW,OAAQ,UAAS,eAAc,CAAC,EAC9F,EAED,UAAW,IAAMJ,KAASU,EAAQ,SAAU,MAAMV,EAClD,MAAMU,EAAQ,KACdb,EAAK,eAAe,CACtB,OAASN,EAAO,CAEd,MADIF,GAAQ,CAACe,EAAW,OAAO,SAAW,EAAEb,aAAiB,0BAA0BM,EAAK,YAAY,EAClGN,CACR,QAAU,CACRQ,EAAW,QAAQ,oBAAoB,QAAS,OAAO,EAEnDV,IACE,UAAUe,EAAW,OAAO,oBAAoB,QAAS,QAAQ,EAErEP,EAAK,YAAY,EAAE,EACnBA,EAAK,QAAQR,CAAI,EACjBQ,EAAK,WAAW,EAEpB,CACF,EAEA,MAAO,CACL,CAAC,OAAO,gBAAiB,CACvB,IAAMW,EAAQ,CAAC,EACTJ,EAAa,IAAI,gBACnBK,EACE,UAAkD,CAEtD,GADA,IAAUD,EACNN,IAAUM,EAEd,MADA,KAAa,QAAQJ,CAAU,EACxBK,CACT,EAEA,MAAO,CACL,SACE,MAAM,CAAC,EAAE,KAAK,GAAK,QAAQ,OAAO,IAAI,qBAAqB,0CAA0C,CAAC,EACxG,OAAQ,KAAO,IACT,CAACP,GAASA,IAAUM,EAAc,CAAE,KAAM,GAAa,OAAgB,GAC3EJ,EAAW,MAAM,IAAI,wBAAwB,yBAAyB,CAAC,EAChEK,GAAU,OAAOT,CAAe,GAAK,CAAE,KAAM,GAAa,OAAgB,GAEnF,MAAO,KAAO,IAAoB,CAChC,IAAM/B,EAAS,MAAM,EACrB,GAAI,CAACA,EAAQ,MAAM,IAAI,qBAAqB,0CAA0C,EAEtF,OADAmC,EAAW,MAAMb,CAAK,EACftB,EAAO,MAAMsB,CAAK,CAC3B,CACF,CACF,CACF,CACF,CAEA,MAAO,CACL,IAAI,gBAAiB,CACnB,OAAOM,EAAK,cACd,EACA,QAASA,EAAK,QACd,IAAI,UAAW,CACb,OAAOA,EAAK,QACd,EACA,MAAOA,EAAK,MACZ,UACA,IAAI,OAAQ,CACV,OAAOA,EAAK,MAAM,CACpB,EACA,IAAI,QAAS,CACX,OAAOA,EAAK,OAAO,CACrB,EACA,IAAKA,EAAK,KACT,OAAO,kBAAqBA,EAAK,MAAM,CAAC,CAAC,GACzC,OAAO,SAAUA,EAAK,OACzB,CACF,CC/EA,SAAS,eAAe,EAAyB,CAAC,EAAoB,CACpE,GAAM,CAAE,cAAc,EAAG,WAAU,SAAS,SAAU,WAAYV,EAC5DyB,EACJC,IAAgB,OACZ,KAAK,IAAA,IAAqB,KAAK,IAAI,EAAG,WAAW,WAAW,qBAAuB,CAAC,CAAC,EACrFA,EAEN,GAAI,CAAC,OAAO,UAAUD,CAAmB,GAAKA,EAAsB,GAAKA,EAAA,IACvE,MAAM,IAAI,4BAA4B,0DAA2E,EAGnH,GAAIzD,IAAa,IAAA,KAAc,CAAC,OAAO,UAAUA,CAAQ,GAAKA,EAAW,GACvE,MAAM,IAAI,4BAA4B,uCAAuC,EAG/E,GAAI2D,IAAW,UAAYA,IAAW,OACpC,MAAM,IAAI,4BAA4B,qCAAqC,EAK7E,OAFA,gBAAgBtD,CAAO,EAEhB,CAAE,YAAaoD,EAAqB,WAAU,SAAQ,SAAQ,CACvE,CAEA,SAAS,iBAA0B,EAAkD,CACnF,GAAI,OAAOZ,GAAU,WAAYA,EAAgB,MAAO,GAExD,IAAMe,EAAWf,EAYjB,OAVEe,EAAS,UAAA,GACT,OAAOA,EAAS,IAAO,UACvB,CAAC,OAAO,cAAcA,EAAS,EAAE,GACjCA,EAAS,GAAK,EAEP,GAELA,EAAS,OAAS,SAAWA,EAAS,OAAS,SAAiB,UAAWA,EAC3EA,EAAS,OAAS,SAAW,OAAOA,EAAS,OAAU,UAAYA,EAAS,QAAU,KAAa,IAGpGA,EAAS,MAAM,WAAa,IAAA,IAAaA,EAAS,MAAM,WAAa,aACtE,OAAOA,EAAS,MAAM,SAAY,UAClC,OAAOA,EAAS,MAAM,MAAS,WAC9BA,EAAS,MAAM,QAAU,IAAA,IAAa,OAAOA,EAAS,MAAM,OAAU,SAE3E,CAEA,SAAS,cAAc,EAAkE,CACvF,IAAMC,EAAY,MAAMzB,EAAM,OAAO,EAKrC,MAHA,GAAM,KAAOA,EAAM,KACnB,EAAM,MAAQA,EAAM,MAEbA,EAAM,WAAa,WACtB,IAAI,qBAAqBA,EAAM,QAAS,CAAE,OAAM,CAAC,EACjD,IAAI,kBAAkBA,EAAM,QAAS,CAAE,OAAM,CAAC,CACpD,CAEA,IAAM,KAAN,KAAkG,CAChG,GACA,GAAY,GACZ,GACA,GAAU,EACV,GAGA,OAA8D,IAAA,GAE9D,YAAY,EAAmB,CAC7B,KAAK0B,GAAOC,CACd,CAEA,OAAO,EAAuB,CACvB,KAAKC,KACV,KAAKC,GAAY,EACjB,KAAKC,GAAe,SAAUzC,CAAM,EACtC,CAEA,IAAI,EAAe,EAA+B,EAA+C,CAC/F,OAAO,KAAK0C,GAAUrB,EAAOH,EAAetC,EAAS,KAAK,CAC5D,CAEA,OAAO,EAAe,EAA6C,CACjE,IAAM,SAAa,KAAK,OAAO,IAAI,wBAAwB,yBAAyB,CAAC,EAC/E+D,EAAoB,CAAC,EACrB3D,EAA4D,CAAC,EAC/D4D,EAAO,GACPjC,EACE,KAAQ,GAAmB,CAC/B,IAAMf,EAASZ,EAAQ,MAAM,EAEzBY,EAAQA,EAAO,CAAE,KAAM,GAAO,OAAM,CAAC,EACpC+C,EAAO,KAAKvB,CAAK,CACxB,EACM,OAAU,GAAqB,CAInC,IAHA,EAAO,GACP,EAAQpB,EAEDhB,EAAQ,OAAS,GACPA,EAAQ,MAGlB,CAAA,CADDgB,IAAW,IAAA,GACH,CAAE,KAAM,GAAM,MAAO,IAAA,EAAmB,EADnB,QAAQ,OAAOA,CAAM,CACD,CAEzD,EAMA,MAAO,CACL,KANkB,KAAK0C,GAAUrB,EAAO,CAAC,GAAId,EAAQ,eAAiB,CAAC,CAAE,EAAGA,EAAQ,QAAS,SAAU,IAAI,CAAC,CAAC,SACvG,OAAO,EACZ,GAAoB,OAAOP,CAAM,CAI5B,EACN,SAAU,EACP,OAAO,oBAAuB,CAC7B,MAAM,MAAyC,CAC7C,GAAI2C,EAAO,OAAS,EAAG,MAAO,CAAE,KAAM,GAAO,MAAOA,EAAO,MAAM,CAAG,EAEpE,GAAIhC,IAAU,IAAA,GAAW,MAAMA,EAI/B,OAFIiC,EAAa,CAAE,KAAM,GAAM,MAAO,IAAA,EAAmB,EAElD,IAAI,SAAkC,EAAS,IAAW,CAC/D5D,EAAQ,KAAM,GAAW,CACnB6D,aAAkB,QAASA,EAAY,KAAK1C,EAASJ,CAAM,EAC1DI,EAAQ0C,CAAM,CACrB,CAAC,CACH,CAAC,CACH,EACA,MAAM,QAA2C,CAG/C,OAFA,KAAK,EAEE,CAAE,KAAM,GAAM,MAAO,IAAA,EAAmB,CACjD,CACF,EACF,CACF,CACF,CAEA,WAAkB,CAChB,KAAKC,GAAY,GACjB,KAAKN,GAAY,EACjB,KAAKC,GAAe,SAAU,IAAI,uBAAyB,CAC7D,CAEA,GACE,EACA,EACA,EACA,EACA,EACkB,CAClB,GAAI,KAAKK,GAAW,OAAO,QAAQ,OAAO,IAAI,uBAAyB,EAEvE,GAAI,KAAKP,GAAU,OAAO,QAAQ,OAAO,IAAI,qBAAqB,6BAA6B,CAAC,EAEhG,GAAI,CACF,IAAMQ,EAAS,KAAKC,GAAc,EAC5BC,EAAK,KAAKC,GAGhB,MAFA,MAAKA,GAAUD,YAAiC,EAAIA,EAAK,EAElD,IAAI,SAAkB,EAAS,IAAW,CAC/C,IAAME,EAA4B,CAAE,OAAM,KAAI,OAAM,SAAQ,SAAQ,EAEpE,KAAKZ,GAAWY,EAEZvE,IAAY,IAAA,KACd,EAAQ,MAAQ,eAAiB,KAAK,OAAO,IAAI,qBAAqBA,CAAO,CAAC,EAAGA,CAAO,EACxF,WAAWuE,EAAQ,KAAK,GAG1B,GAAI,CACFJ,EAAO,YAAY,CAAE,KAAI,QAAO,OAAM,QAAA,CAA0B,EAAG7B,CAAa,CAClF,OAASP,EAAO,CACd,KAAK,OAAO,IAAI,qBAAqB,mCAAoC,CAAE,MAAOA,CAAM,CAAC,CAAC,CAC5F,CACF,CAAC,CACH,OAASA,EAAO,CACd,OAAO,QAAQ,OAAOA,CAAK,CAC7B,CACF,CAEA,IAAwB,CACtB,GAAI,KAAKyC,GAAS,OAAO,KAAKA,GAE9B,GAAI,OAAO,OAAW,IAAa,MAAM,IAAI,qBAAqB,2CAA2C,EAE7G,GAAI,CACF,IAAML,EAAS,IAAI,OAAO,KAAKV,GAAM,CAAE,KAAM,QAAS,CAAC,EAUvD,MARA,GAAO,UAAa,GAAiC,CAC/C,KAAKe,KAAYL,GAAQ,KAAKM,GAAWxC,EAAM,IAAI,CACzD,EACA,EAAO,QAAW,GAAU,KAAKyC,GAAYP,EAAQ,IAAI,qBAAqBlC,EAAM,SAAW,eAAe,CAAC,EAC/G,EAAO,mBACL,KAAKyC,GAAYP,EAAQ,IAAI,qBAAqB,2CAA2C,CAAC,EAChG,KAAKK,GAAUL,EAERA,CACT,OAASpC,EAAO,CACd,MAAM,IAAI,qBAAqB,0BAA2B,CAAE,MAAOA,CAAM,CAAC,CAC5E,CACF,CAEA,IAAoB,CAClB,IAAMoC,EAAS,KAAKK,GACpB,KAAKA,GAAU,IAAA,GACVL,IAEL,EAAO,UAAY,KACnB,EAAO,QAAU,KACjB,EAAO,eAAiB,KACxBA,EAAO,UAAU,EACnB,CAEA,GAAY,EAAgB,EAAmC,CACzD,KAAKK,KAAYL,IAErB,KAAKP,GAAY,EACjB,KAAKC,GAAe,SAAU9B,CAAK,EACnC,KAAK,SAASA,CAAK,EACrB,CAEA,GAAW,EAAwB,CAC5B,KAAK4B,KAGR,CAAC,iBAA0BlE,CAAO,GAClCA,EAAQ,KAAO,KAAKkE,GAAS,IAC5B,KAAKA,GAAS,OAAS,OAASlE,EAAQ,OAAS,QAElD,KAAK,OAAO,IAAI,qBAAqB,mDAAmD,CAAC,EAKvFA,EAAQ,OAAS,QACnB,KAAKkE,GAAS,OAAOlE,EAAQ,KAAK,EAKhCA,EAAQ,OAAS,QACnB,KAAKoE,GAAe,SAAU,cAAcpE,EAAQ,KAAK,CAAC,EAK5D,KAAKoE,GAAe,UAAWpE,EAAQ,KAAK,EAC9C,CAEA,GAAe,EAA4B,EAAsB,CAC/D,IAAM8E,EAAU,KAAKZ,GAEhBY,IAEL,KAAKZ,GAAW,IAAA,GAEZY,EAAQ,OAAO,aAAaA,EAAQ,KAAK,EAEzCI,IAAS,UAAWJ,EAAQ,QAAQ/B,CAAgB,EACnD+B,EAAQ,OAAO/B,CAAK,EAC3B,CACF,EAEA,SAAS,MAAuB,EAAmB,EAAmD,CACpG,IAAMoC,EAAc,OAAOlB,GAAQ,SAAWA,EAAMA,EAAI,KACxD,OAAO,MAAM,KAAK,CAAE,OAAQ/B,EAAQ,WAAY,MAAS,IAAI,KAAsBiD,CAAW,CAAC,CACjG,CAGA,SAAgB,aACd,EACA,EAAyB,CAAC,EACG,CAC7B,IAAMC,EAAW,eAAelD,CAAO,EAEvC,OAAO,WAAW,MAAuB+B,EAAKmB,CAAQ,EAAG,CACvD,eAAgBA,EAAS,QACzB,SAAUA,EAAS,SACnB,OAAQA,EAAS,MACnB,CAAC,CACH,CAGA,SAAgB,mBACd,EACA,EAAyB,CAAC,EACQ,CAClC,IAAMA,EAAW,eAAelD,CAAO,EAEvC,OAAO,iBAAiB,MAAsB+B,EAAKmB,CAAQ,EAAG,CAC5D,eAAgBA,EAAS,QACzB,SAAUA,EAAS,SACnB,OAAQA,EAAS,MACnB,CAAC,CACH,C"}
|
package/dist/familiar.iife.js
CHANGED
|
@@ -1,2 +1,2 @@
|
|
|
1
|
-
var Familiar=(function(e,t){Object.defineProperty(e,Symbol.toStringTag,{value:`Module`});function unrefTimer(e){typeof e==`object`&&e&&`unref`in e&&e.unref()}var FamiliarError=class extends Error{constructor(e,t){super(e,t),this.name=new.target.name,Object.setPrototypeOf(this,new.target.prototype)}},FamiliarInvalidOptionsError=class extends FamiliarError{},FamiliarQueueFullError=class extends FamiliarError{maxQueue;constructor(e){super(`Queue is full (maxQueue=${e})`),this.maxQueue=e}},FamiliarTaskError=class extends FamiliarError{},FamiliarTerminatedError=class extends FamiliarError{constructor(e=`Worker was terminated`){super(e)}},FamiliarTimeoutError=class extends FamiliarError{timeoutMs;constructor(e,t=`Task`){super(`${t} timed out after ${e}ms`),this.timeoutMs=e}},FamiliarRuntimeError=class extends FamiliarError{},n=2147483647;function validatePriority(e){if(!Number.isFinite(e))throw new FamiliarInvalidOptionsError("`priority` must be a finite number");return e}function validateTimeout(e,t=`timeout`){if(e!==void 0&&(!Number.isInteger(e)||e<1||e>2147483647))throw new FamiliarInvalidOptionsError(`\`${t}\` must be an integer from 1 through ${n}`);return e}function createPoolCore(e,n){let r=[...e],i=[],a=[],o=[],s=(0,t.tapper)(),c=new AbortController,l=0,u=0,d=0,f=0,p=0,m,h=!1;function isIdle(){return r.length===e.length&&i.length===0}function settleIdle(){if(isIdle())for(let e of a.splice(0))e.timer&&clearTimeout(e.timer),e.resolve()}function waitForIdle(e){return isIdle()?Promise.resolve():new Promise((t,n)=>{let r={reject:n,resolve:t};e.timeout!==void 0&&(r.timer=setTimeout(()=>{let t=a.indexOf(r);t!==-1&&a.splice(t,1),n(new FamiliarTimeoutError(e.timeout,`Drain`))},e.timeout),unrefTimer(r.timer)),a.push(r)})}function releaseCapacity(){o.shift()?.resolve()}function rejectCapacity(e){for(let t of o.splice(0))t.reject(e)}function waitForCapacity(e,n){return e?.aborted?Promise.reject((0,t.abortError)(e)):new Promise((r,i)=>{let a=!1,s={cleanup(){e?.removeEventListener(`abort`,onAbort)},priority:n,reject(e){if(a)return;a=!0,s.cleanup();let t=o.indexOf(s);t!==-1&&o.splice(t,1),i(e)},resolve(){a||(a=!0,s.cleanup(),r())},sequence:d++},onAbort=()=>s.reject((0,t.abortError)(e));e?.addEventListener(`abort`,onAbort,{once:!0}),o.push(s),o.sort((e,t)=>t.priority-e.priority||e.sequence-t.sequence)})}function acquire(e,r){let{priority:a,signal:o}=e;return o?.aborted?Promise.reject((0,t.abortError)(o)):(async()=>{for(;;){if(h)throw new FamiliarTerminatedError;if(m)throw new FamiliarTerminatedError(`Worker is draining`);if(n.maxQueue===void 0||i.length<n.maxQueue)return admit(e,r??(e=>e));if(n.onFull===`reject`)throw new FamiliarQueueFullError(n.maxQueue);if(await waitForCapacity(o,a),o?.aborted)throw releaseCapacity(),(0,t.abortError)(o)}})()}function admit(e,n){let{priority:a,signal:o}=e,s=r.pop();if(s)try{return Promise.resolve(n(s))}catch(e){return release(s),settleIdle(),Promise.reject(e)}return new Promise((e,r)=>{let s={cleanup(){s.signal?.removeEventListener(`abort`,onAbort)},priority:a,reject(e){s.cleanup();let t=i.indexOf(s);t!==-1&&(i.splice(t,1),releaseCapacity()),r(e),settleIdle()},sequence:u++,signal:o,start(t){s.cleanup();try{e(n(t))}catch(e){release(t),settleIdle(),r(e)}}},onAbort=()=>s.reject((0,t.abortError)(s.signal));s.signal?.addEventListener(`abort`,onAbort,{once:!0}),i.push(s),i.sort((e,t)=>t.priority-e.priority||e.sequence-t.sequence)})}function release(e){let t=i.shift();t?(t.start(e),releaseCapacity()):r.push(e)}function dispose(){if(!h){h=!0,c.abort();for(let t of e)t.terminate();for(let e of i.splice(0))e.reject(new FamiliarTerminatedError);rejectCapacity(new FamiliarTerminatedError),settleIdle(),s.emit({type:`dispose`}),s.clear()}}function drain(e={}){if(h)return Promise.resolve();try{validateTimeout(e.timeout,`drain.timeout`)}catch(e){return Promise.reject(e)}return m||(rejectCapacity(new FamiliarTerminatedError(`Worker is draining`)),m=waitForIdle(e).then(()=>dispose(),e=>{throw dispose(),e}),m)}return{acquire,disposalSignal:c.signal,dispose,get disposed(){return h},drain,get drainPromise(){return m},emitTap(e){s.emit(e)},release,settleIdle,stats(){return{active:l,completed:f,failed:p,queued:i.length+o.length}},status(){return h?`terminated`:l===0?`idle`:`running`},tap(e,t){return h?()=>void 0:s.tap(e,t)},trackActive(e){l+=e},trackCompleted(){f+=1},trackFailed(){p+=1}}}function createPool(e,n){let r=createPoolCore(e,n);for(let t of e)t.notify=e=>r.emitTap({error:e,type:`worker-error`});function run(e,i={}){let a,o,s;try{a=validatePriority(i.priority??0),o=validateTimeout(i.timeout)??n.defaultTimeout,s=[...i.transferables??[]]}catch(e){return Promise.reject(e)}return r.acquire({priority:a,signal:i.signal},n=>{r.trackActive(1);let onAbort=()=>n.cancel((0,t.abortError)(i.signal));i.signal?.addEventListener(`abort`,onAbort,{once:!0});let finish=async()=>{try{let t=await n.run(e,s,o);return r.trackCompleted(),t}catch(e){throw!i.signal?.aborted&&!(e instanceof FamiliarTerminatedError)&&r.trackFailed(),e}finally{i.signal?.removeEventListener(`abort`,onAbort),r.trackActive(-1),r.release(n),r.settleIdle()}};return finish()})}return{get disposalSignal(){return r.disposalSignal},dispose:r.dispose,get disposed(){return r.disposed},drain:r.drain,run,get stats(){return r.stats()},get status(){return r.status()},tap:r.tap,[Symbol.asyncDispose]:()=>r.drain({}),[Symbol.dispose]:r.dispose}}function runBatch(e,n,r={}){let i,iterate=async function*(i){let a=[],onAbort=()=>i.abort(r.signal?.reason);r.signal?.aborted?i.abort(r.signal.reason):r.signal?.addEventListener(`abort`,onAbort,{once:!0});try{for(let[t,o]of n.entries()){let n=e.run(o,{priority:r.priority,signal:i.signal,timeout:r.timeout,transferables:r.getTransferables?.(o,t)}).catch(e=>{throw i.abort(e),e});n.catch(()=>void 0),a.push(n)}if(a.length===0&&i.signal.aborted)throw(0,t.abortError)(i.signal);for(let e of a){if(i.signal.aborted)throw(0,t.abortError)(i.signal);let n=await e;if(i.signal.aborted)throw(0,t.abortError)(i.signal);yield n}}catch(e){throw i.abort(e),e}finally{r.signal?.removeEventListener(`abort`,onAbort),i.abort(new DOMException(`Batch consumer stopped`,`AbortError`)),await Promise.allSettled(a)}};return{[Symbol.asyncIterator](){let e={},t=new AbortController,n,start=()=>{if(i??=e,i===e)return n??=iterate(t),n};return{next:()=>start()?.next()??Promise.reject(new FamiliarRuntimeError(`Worker batches can only be consumed once`)),return:async r=>!i||i!==e?{done:!0,value:r}:(t.abort(new FamiliarTerminatedError(`Batch consumer stopped`)),n?.return(r)??{done:!0,value:r}),throw:async e=>{let n=start();if(!n)throw new FamiliarRuntimeError(`Worker batches can only be consumed once`);return t.abort(e),n.throw(e)}}}}}function createStreamPool(e,n){let r=createPoolCore(e,n);for(let t of e)t.notify=e=>r.emitTap({error:e,type:`worker-error`});function runStream(e,i={}){let a=validatePriority(i.priority??0),o=validateTimeout(i.timeout)??n.defaultTimeout,s=[...i.transferables??[]],c,iterate=async function*(n){let onAbort=()=>n.abort(i.signal?.reason),c,onCancel;i.signal?.aborted?n.abort(i.signal.reason):i.signal?.addEventListener(`abort`,onAbort,{once:!0});try{let i=await r.acquire({priority:a,signal:n.signal},i=>(c=i,r.trackActive(1),onCancel=()=>c?.cancel((0,t.abortError)(n.signal)),n.signal.addEventListener(`abort`,onCancel,{once:!0}),i.stream(e,{priority:a,signal:n.signal,timeout:o,transferables:s})));for await(let e of i.iterable)yield e;await i.done,r.trackCompleted()}catch(e){throw c&&!n.signal.aborted&&!(e instanceof FamiliarTerminatedError)&&r.trackFailed(),e}finally{i.signal?.removeEventListener(`abort`,onAbort),c&&(onCancel&&n.signal.removeEventListener(`abort`,onCancel),r.trackActive(-1),r.release(c),r.settleIdle())}};return{[Symbol.asyncIterator](){let e={},t=new AbortController,n,start=()=>{if(c??=e,c===e)return n??=iterate(t),n};return{next:()=>start()?.next()??Promise.reject(new FamiliarRuntimeError(`Worker streams can only be consumed once`)),return:async r=>!c||c!==e?{done:!0,value:r}:(t.abort(new FamiliarTerminatedError(`Stream consumer stopped`)),n?.return(r)??{done:!0,value:r}),throw:async e=>{let n=start();if(!n)throw new FamiliarRuntimeError(`Worker streams can only be consumed once`);return t.abort(e),n.throw(e)}}}}}return{get disposalSignal(){return r.disposalSignal},dispose:r.dispose,get disposed(){return r.disposed},drain:r.drain,runStream,get stats(){return r.stats()},get status(){return r.status()},tap:r.tap,[Symbol.asyncDispose]:()=>r.drain({}),[Symbol.dispose]:r.dispose}}function resolveOptions(e={}){let{concurrency:t=1,maxQueue:n,onFull:r=`reject`,timeout:i}=e,a=t===`auto`?Math.min(512,Math.max(1,globalThis.navigator?.hardwareConcurrency??1)):t;if(!Number.isInteger(a)||a<1||a>512)throw new FamiliarInvalidOptionsError('`concurrency` must be a positive integer ≤ 512 or "auto"');if(n!==void 0&&(!Number.isInteger(n)||n<1))throw new FamiliarInvalidOptionsError("`maxQueue` must be a positive integer");if(r!==`reject`&&r!==`wait`)throw new FamiliarInvalidOptionsError('`onFull` must be "reject" or "wait"');return validateTimeout(i),{concurrency:a,maxQueue:n,onFull:r,timeout:i}}function isWorkerResponse(e){if(typeof e!=`object`||!e)return!1;let t=e;return t.version!==1||typeof t.id!=`number`||!Number.isSafeInteger(t.id)||t.id<0?!1:t.kind===`chunk`||t.kind===`result`?`value`in t:t.kind!==`error`||typeof t.error!=`object`||t.error===null?!1:(t.error.category===void 0||t.error.category===`protocol`)&&typeof t.error.message==`string`&&typeof t.error.name==`string`&&(t.error.stack===void 0||typeof t.error.stack==`string`)}function responseError(e){let t=Error(e.message);return t.name=e.name,t.stack=e.stack,e.category===`protocol`?new FamiliarRuntimeError(e.message,{cause:t}):new FamiliarTaskError(e.message,{cause:t})}var Slot=class{#e;#t=!1;#n;#r=0;#i;notify=void 0;constructor(e){this.#e=e}cancel(e){this.#n&&(this.#s(),this.#u(`reject`,e))}run(e,t,n){return this.#a(e,t,n,`run`)}stream(e,t){let stop=()=>this.cancel(new FamiliarTerminatedError(`Stream consumer stopped`)),n=[],r=[],i=!1,a,emit=e=>{let t=r.shift();t?t({done:!1,value:e}):n.push(e)},finish=e=>{for(i=!0,a=e;r.length>0;)r.shift()(e===void 0?{done:!0,value:void 0}:Promise.reject(e))};return{done:this.#a(e,[...t.transferables??[]],t.timeout,`stream`,emit).then(()=>finish(),e=>finish(e)),iterable:{[Symbol.asyncIterator]:()=>({async next(){if(n.length>0)return{done:!1,value:n.shift()};if(a!==void 0)throw a;return i?{done:!0,value:void 0}:new Promise((e,t)=>{r.push(n=>{n instanceof Promise?n.then(e,t):e(n)})})},async return(){return stop(),{done:!0,value:void 0}}})}}}terminate(){this.#t=!0,this.#s(),this.#u(`reject`,new FamiliarTerminatedError)}#a(e,t,n,r,i){if(this.#t)return Promise.reject(new FamiliarTerminatedError);if(this.#n)return Promise.reject(new FamiliarRuntimeError(`Worker slot is already busy`));try{let a=this.#o(),o=this.#r;return this.#r=o===2**53-1?0:o+1,new Promise((s,c)=>{let l={emit:i,id:o,kind:r,reject:c,resolve:s};this.#n=l,n!==void 0&&(l.timer=setTimeout(()=>this.cancel(new FamiliarTimeoutError(n)),n),unrefTimer(l.timer));try{a.postMessage({id:o,input:e,kind:r,version:1},t)}catch(e){this.cancel(new FamiliarRuntimeError(`Failed to post message to worker`,{cause:e}))}})}catch(e){return Promise.reject(e)}}#o(){if(this.#i)return this.#i;if(typeof Worker>`u`)throw new FamiliarRuntimeError(`Worker API is unavailable in this runtime`);try{let e=new Worker(this.#e,{type:`module`});return e.onmessage=t=>{this.#i===e&&this.#l(t.data)},e.onerror=t=>this.#c(e,new FamiliarRuntimeError(t.message||`Worker failed`)),e.onmessageerror=()=>this.#c(e,new FamiliarRuntimeError(`Worker response could not be deserialized`)),this.#i=e,e}catch(e){throw new FamiliarRuntimeError(`Failed to create Worker`,{cause:e})}}#s(){let e=this.#i;this.#i=void 0,e&&(e.onmessage=null,e.onerror=null,e.onmessageerror=null,e.terminate())}#c(e,t){this.#i===e&&(this.#s(),this.#u(`reject`,t),this.notify?.(t))}#l(e){if(this.#n){if(!isWorkerResponse(e)||e.id!==this.#n.id||this.#n.kind===`run`&&e.kind===`chunk`){this.cancel(new FamiliarRuntimeError(`Worker returned an incompatible protocol response`));return}if(e.kind===`chunk`){this.#n.emit?.(e.value);return}if(e.kind===`error`){this.#u(`reject`,responseError(e.error));return}this.#u(`resolve`,e.value)}}#u(e,t){let n=this.#n;n&&(this.#n=void 0,n.timer&&clearTimeout(n.timer),e===`resolve`?n.resolve(t):n.reject(t))}};function slots(e,t){let n=typeof e==`string`?e:e.href;return Array.from({length:t.concurrency},()=>new Slot(n))}function createWorker(e,t={}){let n=resolveOptions(t);return createPool(slots(e,n),{defaultTimeout:n.timeout,maxQueue:n.maxQueue,onFull:n.onFull})}function createStreamWorker(e,t={}){let n=resolveOptions(t);return createStreamPool(slots(e,n),{defaultTimeout:n.timeout,maxQueue:n.maxQueue,onFull:n.onFull})}return e.FamiliarError=FamiliarError,e.FamiliarInvalidOptionsError=FamiliarInvalidOptionsError,e.FamiliarQueueFullError=FamiliarQueueFullError,e.FamiliarRuntimeError=FamiliarRuntimeError,e.FamiliarTaskError=FamiliarTaskError,e.FamiliarTerminatedError=FamiliarTerminatedError,e.FamiliarTimeoutError=FamiliarTimeoutError,e.createStreamWorker=createStreamWorker,e.createWorker=createWorker,e.runBatch=runBatch,e})({},Arsenal);
|
|
1
|
+
var Familiar=(function(e,t){Object.defineProperty(e,Symbol.toStringTag,{value:`Module`});function unrefTimer(e){typeof e==`object`&&e&&`unref`in e&&e.unref()}var FamiliarError=class extends Error{constructor(e,t){super(e,t),this.name=new.target.name,Object.setPrototypeOf(this,new.target.prototype)}},FamiliarInvalidOptionsError=class extends FamiliarError{},FamiliarQueueFullError=class extends FamiliarError{maxQueue;constructor(e){super(`Queue is full (maxQueue=${e})`),this.maxQueue=e}},FamiliarTaskError=class extends FamiliarError{},FamiliarTerminatedError=class extends FamiliarError{constructor(e=`Worker was terminated`){super(e)}},FamiliarTimeoutError=class extends FamiliarError{timeoutMs;constructor(e,t=`Task`){super(`${t} timed out after ${e}ms`),this.timeoutMs=e}},FamiliarRuntimeError=class extends FamiliarError{},n=2147483647;function validatePriority(e){if(!Number.isFinite(e))throw new FamiliarInvalidOptionsError("`priority` must be a finite number");return e}function validateTimeout(e,t=`timeout`){if(e!==void 0&&(!Number.isInteger(e)||e<1||e>2147483647))throw new FamiliarInvalidOptionsError(`\`${t}\` must be an integer from 1 through ${n}`);return e}function createPoolCore(e,n){let r=[...e],i=[],a=[],o=[],s=(0,t.tapper)(),c=new AbortController,l=0,u=0,d=0,f=0,p=0,m,h=!1;function isIdle(){return r.length===e.length&&i.length===0}function settleIdle(){if(isIdle())for(let e of a.splice(0))e.timer&&clearTimeout(e.timer),e.resolve()}function waitForIdle(e){return isIdle()?Promise.resolve():new Promise((t,n)=>{let r={reject:n,resolve:t};e.timeout!==void 0&&(r.timer=setTimeout(()=>{let t=a.indexOf(r);t!==-1&&a.splice(t,1),n(new FamiliarTimeoutError(e.timeout,`Drain`))},e.timeout),unrefTimer(r.timer)),a.push(r)})}function releaseCapacity(){o.shift()?.resolve()}function rejectCapacity(e){for(let t of o.splice(0))t.reject(e)}function waitForCapacity(e,n){return e?.aborted?Promise.reject((0,t.abortError)(e)):new Promise((r,i)=>{let a=!1,s={cleanup(){e?.removeEventListener(`abort`,onAbort)},priority:n,reject(e){if(a)return;a=!0,s.cleanup();let t=o.indexOf(s);t!==-1&&o.splice(t,1),i(e)},resolve(){a||(a=!0,s.cleanup(),r())},sequence:d++},onAbort=()=>s.reject((0,t.abortError)(e));e?.addEventListener(`abort`,onAbort,{once:!0}),o.push(s),o.sort((e,t)=>t.priority-e.priority||e.sequence-t.sequence)})}function acquire(e,r){let{priority:a,signal:o}=e;return o?.aborted?Promise.reject((0,t.abortError)(o)):(async()=>{for(;;){if(h)throw new FamiliarTerminatedError;if(m)throw new FamiliarTerminatedError(`Worker is draining`);if(n.maxQueue===void 0||i.length<n.maxQueue)return admit(e,r??(e=>e));if(n.onFull===`reject`)throw new FamiliarQueueFullError(n.maxQueue);if(await waitForCapacity(o,a),o?.aborted)throw releaseCapacity(),(0,t.abortError)(o)}})()}function admit(e,n){let{priority:a,signal:o}=e,s=r.pop();if(s)try{return Promise.resolve(n(s))}catch(e){return release(s),settleIdle(),Promise.reject(e)}return new Promise((e,r)=>{let s={cleanup(){s.signal?.removeEventListener(`abort`,onAbort)},priority:a,reject(e){s.cleanup();let t=i.indexOf(s);t!==-1&&(i.splice(t,1),releaseCapacity()),r(e),settleIdle()},sequence:u++,signal:o,start(t){s.cleanup();try{e(n(t))}catch(e){release(t),settleIdle(),r(e)}}},onAbort=()=>s.reject((0,t.abortError)(s.signal));s.signal?.addEventListener(`abort`,onAbort,{once:!0}),i.push(s),i.sort((e,t)=>t.priority-e.priority||e.sequence-t.sequence)})}function release(e){let t=i.shift();t?(t.start(e),releaseCapacity()):r.push(e)}function dispose(){if(!h){h=!0,c.abort();for(let t of e)t.terminate();for(let e of i.splice(0))e.reject(new FamiliarTerminatedError);rejectCapacity(new FamiliarTerminatedError),settleIdle(),s.emit({type:`dispose`}),s.clear()}}function drain(e={}){if(h)return Promise.resolve();try{validateTimeout(e.timeout,`drain.timeout`)}catch(e){return Promise.reject(e)}return m||(rejectCapacity(new FamiliarTerminatedError(`Worker is draining`)),m=waitForIdle(e).then(()=>dispose(),e=>{throw dispose(),e}),m)}return{acquire,disposalSignal:c.signal,dispose,get disposed(){return h},drain,get drainPromise(){return m},emitTap(e){s.emit(e)},release,settleIdle,stats(){return{active:l,completed:f,failed:p,queued:i.length+o.length}},status(){return h?`terminated`:l===0?`idle`:`running`},tap(e,t){return h?()=>void 0:s.tap(e,t)},trackActive(e){l+=e},trackCompleted(){f+=1},trackFailed(){p+=1}}}function createPool(e,n){let r=createPoolCore(e,n);for(let t of e)t.notify=e=>r.emitTap({error:e,type:`worker-error`});function run(e,i={}){let a,o,s;try{a=validatePriority(i.priority??0),o=validateTimeout(i.timeout)??n.defaultTimeout,s=[...i.transferables??[]]}catch(e){return Promise.reject(e)}return r.acquire({priority:a,signal:i.signal},n=>{r.trackActive(1);let onAbort=()=>n.cancel((0,t.abortError)(i.signal));i.signal?.addEventListener(`abort`,onAbort,{once:!0});let finish=async()=>{try{let t=await n.run(e,s,o);return r.trackCompleted(),t}catch(e){throw!i.signal?.aborted&&!(e instanceof FamiliarTerminatedError)&&r.trackFailed(),e}finally{i.signal?.removeEventListener(`abort`,onAbort),r.trackActive(-1),r.release(n),r.settleIdle()}};return finish()})}return{get disposalSignal(){return r.disposalSignal},dispose:r.dispose,get disposed(){return r.disposed},drain:r.drain,run,get stats(){return r.stats()},get status(){return r.status()},tap:r.tap,[Symbol.asyncDispose]:()=>r.drain({}),[Symbol.dispose]:r.dispose}}function runBatch(e,n,r={}){let i,iterate=async function*(i){let a=[],onAbort=()=>i.abort(r.signal?.reason);r.signal?.aborted?i.abort(r.signal.reason):r.signal?.addEventListener(`abort`,onAbort,{once:!0});try{for(let[t,o]of n.entries()){let n=e.run(o,{priority:r.priority,signal:i.signal,timeout:r.timeout,transferables:r.getTransferables?.(o,t)}).catch(e=>{throw i.abort(e),e});n.catch(()=>void 0),a.push(n)}if(a.length===0&&i.signal.aborted)throw(0,t.abortError)(i.signal);for(let e of a){if(i.signal.aborted)throw(0,t.abortError)(i.signal);let n=await e;if(i.signal.aborted)throw(0,t.abortError)(i.signal);yield n}}catch(e){throw i.abort(e),e}finally{r.signal?.removeEventListener(`abort`,onAbort),i.abort(new DOMException(`Batch consumer stopped`,`AbortError`)),await Promise.allSettled(a)}};return{[Symbol.asyncIterator](){let e={},t=new AbortController,n,start=()=>{if(i??=e,i===e)return n??=iterate(t),n};return{next:()=>start()?.next()??Promise.reject(new FamiliarRuntimeError(`Worker batches can only be consumed once`)),return:async r=>!i||i!==e?{done:!0,value:r}:(t.abort(new FamiliarTerminatedError(`Batch consumer stopped`)),n?.return(r)??{done:!0,value:r}),throw:async e=>{let n=start();if(!n)throw new FamiliarRuntimeError(`Worker batches can only be consumed once`);return t.abort(e),n.throw(e)}}}}}function createStreamPool(e,n){let r=createPoolCore(e,n);for(let t of e)t.notify=e=>r.emitTap({error:e,type:`worker-error`});function runStream(e,i={}){let a=validatePriority(i.priority??0),o=validateTimeout(i.timeout)??n.defaultTimeout,s=[...i.transferables??[]],c,iterate=async function*(n){let onAbort=()=>n.abort(i.signal?.reason),c,onCancel;i.signal?.aborted?n.abort(i.signal.reason):i.signal?.addEventListener(`abort`,onAbort,{once:!0});try{let i=await r.acquire({priority:a,signal:n.signal},i=>(c=i,r.trackActive(1),onCancel=()=>c?.cancel((0,t.abortError)(n.signal)),n.signal.addEventListener(`abort`,onCancel,{once:!0}),i.stream(e,{priority:a,signal:n.signal,timeout:o,transferables:s})));for await(let e of i.iterable)yield e;await i.done,r.trackCompleted()}catch(e){throw c&&!n.signal.aborted&&!(e instanceof FamiliarTerminatedError)&&r.trackFailed(),e}finally{i.signal?.removeEventListener(`abort`,onAbort),c&&(onCancel&&n.signal.removeEventListener(`abort`,onCancel),r.trackActive(-1),r.release(c),r.settleIdle())}};return{[Symbol.asyncIterator](){let e={},t=new AbortController,n,start=()=>{if(c??=e,c===e)return n??=iterate(t),n};return{next:()=>start()?.next()??Promise.reject(new FamiliarRuntimeError(`Worker streams can only be consumed once`)),return:async r=>!c||c!==e?{done:!0,value:r}:(t.abort(new FamiliarTerminatedError(`Stream consumer stopped`)),n?.return(r)??{done:!0,value:r}),throw:async e=>{let n=start();if(!n)throw new FamiliarRuntimeError(`Worker streams can only be consumed once`);return t.abort(e),n.throw(e)}}}}}return{get disposalSignal(){return r.disposalSignal},dispose:r.dispose,get disposed(){return r.disposed},drain:r.drain,runStream,get stats(){return r.stats()},get status(){return r.status()},tap:r.tap,[Symbol.asyncDispose]:()=>r.drain({}),[Symbol.dispose]:r.dispose}}function resolveOptions(e={}){let{concurrency:t=1,maxQueue:n,onFull:r=`reject`,timeout:i}=e,a=t===`auto`?Math.min(512,Math.max(1,globalThis.navigator?.hardwareConcurrency??1)):t;if(!Number.isInteger(a)||a<1||a>512)throw new FamiliarInvalidOptionsError('`concurrency` must be a positive integer ≤ 512 or "auto"');if(n!==void 0&&(!Number.isInteger(n)||n<1))throw new FamiliarInvalidOptionsError("`maxQueue` must be a positive integer");if(r!==`reject`&&r!==`wait`)throw new FamiliarInvalidOptionsError('`onFull` must be "reject" or "wait"');return validateTimeout(i),{concurrency:a,maxQueue:n,onFull:r,timeout:i}}function isWorkerResponse(e){if(typeof e!=`object`||!e)return!1;let t=e;return t.version!==1||typeof t.id!=`number`||!Number.isSafeInteger(t.id)||t.id<0?!1:t.kind===`chunk`||t.kind===`result`?`value`in t:t.kind!==`error`||typeof t.error!=`object`||t.error===null?!1:(t.error.category===void 0||t.error.category===`protocol`)&&typeof t.error.message==`string`&&typeof t.error.name==`string`&&(t.error.stack===void 0||typeof t.error.stack==`string`)}function responseError(e){let t=Error(e.message);return t.name=e.name,t.stack=e.stack,e.category===`protocol`?new FamiliarRuntimeError(e.message,{cause:t}):new FamiliarTaskError(e.message,{cause:t})}var Slot=class{#e;#t=!1;#n;#r=0;#i;notify=void 0;constructor(e){this.#e=e}cancel(e){this.#n&&(this.#s(),this.#u(`reject`,e))}run(e,t,n){return this.#a(e,t,n,`run`)}stream(e,t){let stop=()=>this.cancel(new FamiliarTerminatedError(`Stream consumer stopped`)),n=[],r=[],i=!1,a,emit=e=>{let t=r.shift();t?t({done:!1,value:e}):n.push(e)},finish=e=>{for(i=!0,a=e;r.length>0;)r.shift()(e===void 0?{done:!0,value:void 0}:Promise.reject(e))};return{done:this.#a(e,[...t.transferables??[]],t.timeout,`stream`,emit).then(()=>finish(),e=>finish(e)),iterable:{[Symbol.asyncIterator]:()=>({async next(){if(n.length>0)return{done:!1,value:n.shift()};if(a!==void 0)throw a;return i?{done:!0,value:void 0}:new Promise((e,t)=>{r.push(n=>{n instanceof Promise?n.then(e,t):e(n)})})},async return(){return stop(),{done:!0,value:void 0}}})}}}terminate(){this.#t=!0,this.#s(),this.#u(`reject`,new FamiliarTerminatedError)}#a(e,t,n,r,i){if(this.#t)return Promise.reject(new FamiliarTerminatedError);if(this.#n)return Promise.reject(new FamiliarRuntimeError(`Worker slot is already busy`));try{let a=this.#o(),o=this.#r;return this.#r=o===2**53-1?0:o+1,new Promise((s,c)=>{let l={emit:i,id:o,kind:r,reject:c,resolve:s};this.#n=l,n!==void 0&&(l.timer=setTimeout(()=>this.cancel(new FamiliarTimeoutError(n)),n),unrefTimer(l.timer));try{a.postMessage({id:o,input:e,kind:r,version:1},t)}catch(e){this.cancel(new FamiliarRuntimeError(`Failed to post message to worker`,{cause:e}))}})}catch(e){return Promise.reject(e)}}#o(){if(this.#i)return this.#i;if(typeof Worker>`u`)throw new FamiliarRuntimeError(`Worker API is unavailable in this runtime`);try{let e=new Worker(this.#e,{type:`module`});return e.onmessage=t=>{this.#i===e&&this.#l(t.data)},e.onerror=t=>this.#c(e,new FamiliarRuntimeError(t.message||`Worker failed`)),e.onmessageerror=()=>this.#c(e,new FamiliarRuntimeError(`Worker response could not be deserialized`)),this.#i=e,e}catch(e){throw new FamiliarRuntimeError(`Failed to create Worker`,{cause:e})}}#s(){let e=this.#i;this.#i=void 0,e&&(e.onmessage=null,e.onerror=null,e.onmessageerror=null,e.terminate())}#c(e,t){this.#i===e&&(this.#s(),this.#u(`reject`,t),this.notify?.(t))}#l(e){this.#n&&(!isWorkerResponse(e)||e.id!==this.#n.id||this.#n.kind===`run`&&e.kind===`chunk`?this.cancel(new FamiliarRuntimeError(`Worker returned an incompatible protocol response`)):e.kind===`chunk`?this.#n.emit?.(e.value):e.kind===`error`?this.#u(`reject`,responseError(e.error)):this.#u(`resolve`,e.value))}#u(e,t){let n=this.#n;n&&(this.#n=void 0,n.timer&&clearTimeout(n.timer),e===`resolve`?n.resolve(t):n.reject(t))}};function slots(e,t){let n=typeof e==`string`?e:e.href;return Array.from({length:t.concurrency},()=>new Slot(n))}function createWorker(e,t={}){let n=resolveOptions(t);return createPool(slots(e,n),{defaultTimeout:n.timeout,maxQueue:n.maxQueue,onFull:n.onFull})}function createStreamWorker(e,t={}){let n=resolveOptions(t);return createStreamPool(slots(e,n),{defaultTimeout:n.timeout,maxQueue:n.maxQueue,onFull:n.onFull})}return e.FamiliarError=FamiliarError,e.FamiliarInvalidOptionsError=FamiliarInvalidOptionsError,e.FamiliarQueueFullError=FamiliarQueueFullError,e.FamiliarRuntimeError=FamiliarRuntimeError,e.FamiliarTaskError=FamiliarTaskError,e.FamiliarTerminatedError=FamiliarTerminatedError,e.FamiliarTimeoutError=FamiliarTimeoutError,e.createStreamWorker=createStreamWorker,e.createWorker=createWorker,e.runBatch=runBatch,e})({},Arsenal);
|
|
2
2
|
//# sourceMappingURL=familiar.iife.js.map
|