@kirill.konshin/core 0.0.1

package/dist/workerUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workerUtils.js","sources":["../src/workerUtils.ts"],"sourcesContent":["const g = globalThis;\n\n// @see https://developer.mozilla.org/en-US/docs/Web/API/Web_Workers_API/Transferable_objects\nconst transferrable = [\n    g.ArrayBuffer,\n    g.MessagePort,\n    g.ReadableStream,\n    g.WritableStream,\n    g.TransformStream,\n    // WebTransportReceiveStream, // ReferenceError: WebTransportReceiveStream is not defined\n    // WebTransportSendStream, // ReferenceError: WebTransportReceiveStream is not defined\n    // AudioData, // TS2304: Cannot find name AudioData\n    g.ImageBitmap,\n    g.VideoFrame,\n    g.OffscreenCanvas,\n    g.RTCDataChannel,\n    g.MediaSourceHandle,\n    // MIDIAccess, // ReferenceError: MIDIAccess is not defined\n].filter(Boolean);\n\nexport function isTransferable(obj: any): boolean {\n    return transferrable.some((t) => obj instanceof t) ? obj : null;\n}\n\nexport function getTransferrable(data: any = {}): Transferable[] {\n    if (!data) return [];\n    return Object.values<any>(data)\n        .reduce((r, v) => {\n            return Array.isArray(v) ? [...r, ...v.map(isTransferable)] : [...r, isTransferable(v)];\n        }, [])\n        .filter(Boolean);\n}\n"],"names":[],"mappings":"AAAA,MAAM,IAAI;AAGV,MAAM,gBAAgB;AAAA,EAClB,EAAE;AAAA,EACF,EAAE;AAAA,EACF,EAAE;AAAA,EACF,EAAE;AAAA,EACF,EAAE;AAAA;AAAA;AAAA;AAAA,EAIF,EAAE;AAAA,EACF,EAAE;AAAA,EACF,EAAE;AAAA,EACF,EAAE;AAAA,EACF,EAAE;AAAA;AAEN,EAAE,OAAO,OAAO;AAET,SAAS,eAAe,KAAmB;AAC9C,SAAO,cAAc,KAAK,CAAC,MAAM,eAAe,CAAC,IAAI,MAAM;AAC/D;AAEO,SAAS,iBAAiB,OAAY,IAAoB;AAC7D,MAAI,CAAC,KAAM,QAAO,CAAA;AAClB,SAAO,OAAO,OAAY,IAAI,EACzB,OAAO,CAAC,GAAG,MAAM;AACd,WAAO,MAAM,QAAQ,CAAC,IAAI,CAAC,GAAG,GAAG,GAAG,EAAE,IAAI,cAAc,CAAC,IAAI,CAAC,GAAG,GAAG,eAAe,CAAC,CAAC;AAAA,EACzF,GAAG,CAAA,CAAE,EACJ,OAAO,OAAO;AACvB;"}

package/dist/wrpc.d.ts

@@ -0,0 +1,45 @@
+export type Responders = {
+    [key: string]: (arg?: any) => Generator<any> | AsyncGenerator<any> | Promise<any> | any;
+};
+export type Context = {
+    message: string;
+    id: string;
+    signalName?: string;
+    done?: boolean;
+    abort?: string;
+    error?: boolean;
+    ack?: boolean;
+    promise?: boolean;
+};
+export type Event = MessageEvent<{
+    ctx: Context;
+    payload: any | Error;
+}>;
+export type WorkerLike = {
+    postMessage: (payload: any, transferable: any[]) => void;
+    addEventListener: (event: string, listener: (e: any) => void, options?: {
+        signal?: AbortSignal;
+        once?: boolean;
+    }) => void;
+    removeEventListener: (event: string, listener: (e: any) => void) => void;
+} & any;
+export declare enum LogLevel {
+    disabled = 0,
+    error = 1,
+    lifecycle = 2,
+    detail = 3,
+    transport = 4
+}
+export declare function deriveController(signal?: AbortSignal): [AbortController, AbortSignal];
+export declare function rejectOnSignal(promise: Promise<any>, signal: AbortSignal): Promise<Event['data']>;
+export declare function wrpc({ debug, name, }?: {
+    debug?: LogLevel;
+    name?: string;
+}): {
+    createResponder: <T extends Responders>(worker: WorkerLike, responders: T) => {
+        responders: T;
+        stop: () => void;
+    };
+    createCaller: <T extends Responders>(worker: WorkerLike, responders: T) => T;
+};
+//# sourceMappingURL=wrpc.d.ts.map

package/dist/wrpc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wrpc.d.ts","sourceRoot":"","sources":["../src/wrpc.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,UAAU,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,CAAC,EAAE,GAAG,KAAK,SAAS,CAAC,GAAG,CAAC,GAAG,cAAc,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,GAAG,CAAA;CAAE,CAAC;AAErH,MAAM,MAAM,OAAO,GAAG;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,OAAO,CAAC,EAAE,OAAO,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,KAAK,GAAG,YAAY,CAAC;IAAE,GAAG,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,GAAG,GAAG,KAAK,CAAA;CAAE,CAAC,CAAC;AAEzE,MAAM,MAAM,UAAU,GAAG;IACrB,WAAW,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,YAAY,EAAE,GAAG,EAAE,KAAK,IAAI,CAAC;IACzD,gBAAgB,EAAE,CACd,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,CAAC,CAAC,EAAE,GAAG,KAAK,IAAI,EAC1B,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,KACjD,IAAI,CAAC;IACV,mBAAmB,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC,EAAE,GAAG,KAAK,IAAI,KAAK,IAAI,CAAC;CAC5E,GAAG,GAAG,CAAC;AAER,oBAAY,QAAQ;IAChB,QAAQ,IAAI;IACZ,KAAK,IAAI;IACT,SAAS,IAAI;IACb,MAAM,IAAI;IACV,SAAS,IAAI;CAChB;AAID,wBAAgB,gBAAgB,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,CAAC,eAAe,EAAE,WAAW,CAAC,CAGrF;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAOjG;AAID,wBAAgB,IAAI,CAAC,EACjB,KAAyB,EACzB,IAAiE,GACpE,GAAE;IACC,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;CACZ,GAAG;IACL,eAAe,EAAE,CAAC,CAAC,SAAS,UAAU,EAClC,MAAM,EAAE,UAAU,EAClB,UAAU,EAAE,CAAC,KACZ;QACD,UAAU,EAAE,CAAC,CAAC;QACd,IAAI,EAAE,MAAM,IAAI,CAAC;KACpB,CAAC;IACF,YAAY,EAAE,CAAC,CAAC,SAAS,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,CAAC,KAAK,CAAC,CAAC;CAChF,CAkTA"}

package/dist/wrpc.fixture.d.ts

@@ -0,0 +1,26 @@
+export declare const responder: {
+    responders: {
+        test: ({ buf, signal }?: {
+            signal?: AbortSignal;
+            buf?: ArrayBuffer;
+        }) => Generator<{
+            progress: number;
+            aborted?: boolean;
+        }, string, unknown>;
+        returnYield: () => Generator<1 | 3 | 2, any, unknown>;
+        bidirectional: (prefix?: any) => Generator<string, string, number>;
+        error: () => AsyncGenerator<never, never, unknown>;
+        promise: () => Promise<{
+            test: string;
+        }>;
+        promiseError: () => Promise<never>;
+        setTimeout: ({ timeout }?: {
+            timeout?: number;
+        }) => Promise<unknown>;
+        setInterval: ({ timeout }?: {
+            timeout?: number;
+        }) => AsyncGenerator<any, never, unknown>;
+    };
+    stop: () => void;
+};
+//# sourceMappingURL=wrpc.fixture.d.ts.map

package/dist/wrpc.fixture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wrpc.fixture.d.ts","sourceRoot":"","sources":["../src/wrpc.fixture.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,SAAS,EAAE;IACpB,UAAU,EAAE;QAGR,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,EAAE;YAAE,MAAM,CAAC,EAAE,WAAW,CAAC;YAAC,GAAG,CAAC,EAAE,WAAW,CAAA;SAAE,KAAK,SAAS,CAC9E;YACI,QAAQ,EAAE,MAAM,CAAC;YACjB,OAAO,CAAC,EAAE,OAAO,CAAC;SACrB,EACD,MAAM,EACN,OAAO,CACV,CAAC;QAEF,WAAW,EAAE,MAAM,SAAS,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;QACtD,aAAa,EAAE,CAAC,MAAM,CAAC,EAAE,GAAG,KAAK,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;QAEnE,KAAK,EAAE,MAAM,cAAc,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;QACnD,OAAO,EAAE,MAAM,OAAO,CAAC;YACnB,IAAI,EAAE,MAAM,CAAC;SAChB,CAAC,CAAC;QACH,YAAY,EAAE,MAAM,OAAO,CAAC,KAAK,CAAC,CAAC;QACnC,UAAU,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE;YAAE,OAAO,CAAC,EAAE,MAAM,CAAA;SAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;QACrE,WAAW,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE;YAAE,OAAO,CAAC,EAAE,MAAM,CAAA;SAAE,KAAK,cAAc,CAAC,GAAG,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;KAC5F,CAAC;IACF,IAAI,EAAE,MAAM,IAAI,CAAC;CAkDnB,CAAC"}

package/dist/wrpc.js

@@ -0,0 +1,241 @@
+import { getTransferrable } from "./workerUtils.js";
+var LogLevel = /* @__PURE__ */ ((LogLevel2) => {
+  LogLevel2[LogLevel2["disabled"] = 0] = "disabled";
+  LogLevel2[LogLevel2["error"] = 1] = "error";
+  LogLevel2[LogLevel2["lifecycle"] = 2] = "lifecycle";
+  LogLevel2[LogLevel2["detail"] = 3] = "detail";
+  LogLevel2[LogLevel2["transport"] = 4] = "transport";
+  return LogLevel2;
+})(LogLevel || {});
+function deriveController(signal) {
+  const controller = new AbortController();
+  return [controller, AbortSignal.any([controller.signal, signal].filter(Boolean))];
+}
+function rejectOnSignal(promise, signal) {
+  return Promise.race([
+    promise,
+    new Promise((resolve, reject) => {
+      signal.addEventListener("abort", () => reject("RaceAborted:" + signal.reason), { once: true, signal });
+    })
+  ]);
+}
+function wrpc({
+  debug = 0,
+  name = globalThis.importScripts ? "RESPONDER" : "CALLER"
+} = {}) {
+  function logger(type) {
+    return (level, ctx, ...args) => {
+      if (!debug || debug < level) return;
+      const { id, message, ...restCtx } = ctx || {};
+      console[type](name, message || "*", id || "*", ...args, restCtx);
+    };
+  }
+  const log = logger("log");
+  const logWarn = logger("warn");
+  const logError = logger("error");
+  function send(worker, ctx, payload) {
+    log(4, ctx, "SEND", payload, typeof payload);
+    worker.postMessage({ ctx, payload }, getTransferrable(payload));
+  }
+  function listen(worker, context, listener, signal, once = false) {
+    signal.addEventListener(
+      "abort",
+      () => logWarn(3, context, "LISTEN SIGNAL ABORT", signal.reason),
+      {
+        signal,
+        once: true
+      }
+    );
+    worker.addEventListener(
+      "message",
+      ({ data }) => {
+        log(4, context, "LISTEN EVENT", data);
+        if (!context || data?.ctx?.message === context.message && data.ctx?.id === context.id) listener(data);
+      },
+      { signal, once }
+    );
+  }
+  function waitFor(worker, ctx, condition = (data) => true, signal) {
+    const [waitController, waitSignal] = deriveController(signal);
+    return new Promise(
+      (res) => listen(
+        worker,
+        ctx,
+        (data) => {
+          if (!condition(data)) return;
+          waitController.abort("WaitFinished");
+          res(data);
+        },
+        waitSignal
+      )
+    );
+  }
+  function createResponder(worker, responders) {
+    const mainController = new AbortController();
+    worker.addEventListener("messageerror", (e) => logError(1, null, "MESSAGE ERROR", e), {
+      signal: mainController.signal
+    });
+    listen(
+      worker,
+      null,
+      async ({ ctx, payload = {} }) => {
+        if (!ctx || !ctx.message || !ctx.id || ctx.abort || ctx.ack) return;
+        try {
+          const responder = responders[ctx.message];
+          if (!responder) throw new Error("Unknown responder", { cause: ctx });
+          const [subController, subSignal] = deriveController(mainController.signal);
+          if (ctx.signalName) payload[ctx.signalName] = subSignal;
+          const iterator = responder(payload);
+          log(2, ctx, "START", iterator);
+          if (!iterator[Symbol.asyncIterator] && !iterator[Symbol.iterator]) {
+            send(worker, { ...ctx, promise: true }, await rejectOnSignal(iterator, subSignal));
+            log(3, ctx, "PROMISE RESOLVED");
+            return;
+          }
+          try {
+            listen(
+              worker,
+              ctx,
+              (data) => {
+                if (!data.ctx.abort) return;
+                subController.abort(data.ctx.abort);
+                logWarn(2, ctx, "GOT ABORT");
+              },
+              subSignal
+            );
+            let res;
+            let nextPayload = payload;
+            do {
+              res = await rejectOnSignal(iterator.next(nextPayload), subSignal);
+              send(worker, { ...ctx, done: res.done }, res.value);
+              if (res.done) {
+                subController.abort("Done");
+                break;
+              }
+              const nextData = await rejectOnSignal(
+                waitFor(worker, ctx, (data) => !!data.ctx.ack, subSignal),
+                subSignal
+              );
+              nextPayload = nextData.payload;
+              log(3, ctx, "LOOP ACK");
+            } while (!res.done && !subSignal.aborted);
+          } catch (e) {
+            if (!subSignal.aborted && !e.message.includes("RaceAborted")) {
+              logError(1, ctx, "LOOP ERROR", e);
+              send(worker, { ...ctx, error: true, done: true }, e);
+            }
+          } finally {
+            log(3, ctx, "LOOP DONE");
+          }
+        } catch (e) {
+          logError(1, ctx, "ERROR", e);
+          send(worker, { ...ctx, error: true, done: true }, e);
+        } finally {
+          log(3, ctx, "DONE");
+        }
+      },
+      mainController.signal
+    );
+    function stop() {
+      mainController.abort("Stop");
+    }
+    return { responders, stop };
+  }
+  function createCaller(worker, responders) {
+    worker.addEventListener("messageerror", (e) => logError(1, null, "MESSAGE ERROR", e));
+    return new Proxy(responders, {
+      get(target, prop, receiver) {
+        function gen(payload) {
+          const ctx = { message: prop.toString(), id: crypto.randomUUID() };
+          let signal = null;
+          if (payload && Object.is(payload, Object(payload))) {
+            for (const [key, value] of Object.entries(payload)) {
+              if (value instanceof AbortSignal) {
+                log(3, ctx, "FOUND SIGNAL", key);
+                ctx.signalName = key;
+                signal = value;
+                payload[key] = null;
+              }
+            }
+          }
+          const [mainController, mainSignal] = deriveController(signal);
+          const cancel = (notify, reason = "") => {
+            if (mainController.signal.aborted) return;
+            logWarn(2, ctx, "CANCEL", reason, notify);
+            if (reason) mainController.abort(reason);
+            if (notify) send(worker, { ...ctx, abort: reason });
+          };
+          const [promiseController, promiseSignal] = deriveController(mainSignal);
+          const promise = waitFor(
+            worker,
+            ctx,
+            (data) => !!data.ctx.promise || !!data.ctx.error,
+            promiseSignal
+          ).then(({ ctx: ctx2, payload: payload2 }) => {
+            if (ctx2.error) {
+              logError(1, ctx2, "PROMISE ERROR", payload2);
+              throw payload2;
+            }
+            log(2, ctx2, "PROMISE RESOLVED", payload2);
+            return payload2;
+          });
+          async function* generator() {
+            let done = false;
+            try {
+              mainSignal.addEventListener("abort", () => cancel(true, mainSignal.reason), {
+                once: true,
+                signal: mainSignal
+              });
+              log(3, ctx, "GENERATOR START");
+              promiseController.abort("GeneratorUsed");
+              do {
+                const data = await rejectOnSignal(
+                  waitFor(worker, ctx, void 0, mainSignal),
+                  mainSignal
+                );
+                const { ctx: ctxIn, payload: value } = data;
+                log(2, ctx, "EVENT", mainSignal.aborted, ctxIn, value);
+                if (ctxIn.promise) {
+                  logError(1, ctx, "ERROR", "Unexpected promise in generator", data);
+                  throw new Error("Unexpected promise in generator", { cause: data });
+                }
+                if (ctxIn.error) {
+                  logError(1, ctx, "ERROR", data);
+                  cancel(false, "Error");
+                  throw value;
+                }
+                if (ctxIn.done) {
+                  done = true;
+                  return value;
+                } else {
+                  const nextPayload = yield value;
+                  if (!mainSignal.aborted) send(worker, { ...ctx, ack: true }, nextPayload);
+                }
+              } while (!mainSignal.aborted);
+            } finally {
+              log(3, ctx, "DONE");
+              cancel(true, mainSignal.aborted ? mainSignal.reason : done ? "Done" : "Break");
+            }
+          }
+          const iterator = generator();
+          send(worker, ctx, payload);
+          iterator["then"] = promise.then.bind(promise);
+          iterator["catch"] = promise.catch.bind(promise);
+          iterator["finally"] = promise.finally.bind(promise);
+          return iterator;
+        }
+        Object.defineProperty(gen, "name", { value: prop.toString() });
+        target[prop] = gen;
+        return gen;
+      }
+    });
+  }
+  return { createResponder, createCaller };
+}
+export {
+  LogLevel,
+  deriveController,
+  rejectOnSignal,
+  wrpc
+};
+//# sourceMappingURL=wrpc.js.map

package/dist/wrpc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wrpc.js","sources":["../src/wrpc.ts"],"sourcesContent":["import { getTransferrable } from './workerUtils';\n\n// Types\n\nexport type Responders = { [key: string]: (arg?: any) => Generator<any> | AsyncGenerator<any> | Promise<any> | any };\n\nexport type Context = {\n    message: string;\n    id: string;\n    signalName?: string;\n    done?: boolean;\n    abort?: string;\n    error?: boolean;\n    ack?: boolean;\n    promise?: boolean;\n};\n\nexport type Event = MessageEvent<{ ctx: Context; payload: any | Error }>;\n\nexport type WorkerLike = {\n    postMessage: (payload: any, transferable: any[]) => void;\n    addEventListener: (\n        event: string,\n        listener: (e: any) => void,\n        options?: { signal?: AbortSignal; once?: boolean },\n    ) => void;\n    removeEventListener: (event: string, listener: (e: any) => void) => void;\n} & any;\n\nexport enum LogLevel {\n    disabled = 0,\n    error = 1,\n    lifecycle = 2,\n    detail = 3,\n    transport = 4,\n}\n\n// Helpers\n\nexport function deriveController(signal?: AbortSignal): [AbortController, AbortSignal] {\n    const controller = new AbortController();\n    return [controller, AbortSignal.any([controller.signal, signal].filter(Boolean) as AbortSignal[])];\n}\n\nexport function rejectOnSignal(promise: Promise<any>, signal: AbortSignal): Promise<Event['data']> {\n    return Promise.race([\n        promise,\n        new Promise((resolve, reject) => {\n            signal.addEventListener('abort', () => reject('RaceAborted:' + signal.reason), { once: true, signal });\n        }),\n    ]);\n}\n\n// Lib\n\nexport function wrpc({\n    debug = LogLevel.disabled,\n    name = (globalThis as any).importScripts ? 'RESPONDER' : 'CALLER',\n}: {\n    debug?: LogLevel;\n    name?: string;\n} = {}): {\n    createResponder: <T extends Responders>(\n        worker: WorkerLike,\n        responders: T,\n    ) => {\n        responders: T;\n        stop: () => void;\n    };\n    createCaller: <T extends Responders>(worker: WorkerLike, responders: T) => T;\n} {\n    // Logger\n\n    function logger(type: string) {\n        return (level: number, ctx: Context | null, ...args: any[]) => {\n            if (!debug || debug < level) return;\n            const { id, message, ...restCtx } = ctx || {};\n            console[type](name, message || '*', id || '*', ...args, restCtx);\n        };\n    }\n\n    const log = logger('log');\n    const logWarn = logger('warn');\n    const logError = logger('error');\n\n    // Service\n\n    function send(worker: WorkerLike, ctx: Context, payload?: any) {\n        log(LogLevel.transport, ctx, 'SEND', payload, typeof payload);\n        worker.postMessage({ ctx, payload }, getTransferrable(payload));\n    }\n\n    //TODO Listener error handling\n    function listen(\n        worker: WorkerLike,\n        context: Context | null,\n        listener: (event: Event['data']) => void,\n        signal: AbortSignal,\n        once: boolean = false,\n    ) {\n        signal.addEventListener(\n            'abort',\n            () => logWarn(LogLevel.detail, context, 'LISTEN SIGNAL ABORT', signal.reason),\n            {\n                signal,\n                once: true,\n            },\n        );\n        worker.addEventListener(\n            'message',\n            ({ data }: Event) => {\n                log(LogLevel.transport, context, 'LISTEN EVENT', data);\n                // no context = listen all, or matching context\n                if (!context || (data?.ctx?.message === context.message && data.ctx?.id === context.id)) listener(data);\n            },\n            { signal, once },\n        );\n    }\n\n    function waitFor(\n        worker: WorkerLike,\n        ctx: Context,\n        condition: (data: Event['data']) => boolean = (data) => true,\n        signal: AbortSignal,\n    ) {\n        const [waitController, waitSignal] = deriveController(signal);\n\n        return new Promise<Event['data']>((res) =>\n            listen(\n                worker,\n                ctx,\n                (data) => {\n                    if (!condition(data)) return;\n                    waitController.abort('WaitFinished');\n                    res(data);\n                },\n                waitSignal,\n            ),\n        );\n    }\n\n    // Responder\n\n    //TODO Name arg\n    function createResponder<T extends Responders>(\n        worker: WorkerLike,\n        responders: T,\n    ): {\n        responders: T;\n        stop: () => void;\n    } {\n        const mainController = new AbortController();\n\n        worker.addEventListener('messageerror', (e) => logError(LogLevel.error, null, 'MESSAGE ERROR', e), {\n            signal: mainController.signal,\n        });\n\n        listen(\n            worker,\n            null,\n            async ({ ctx, payload = {} }) => {\n                if (!ctx || !ctx.message || !ctx.id || ctx.abort || ctx.ack) return; // ignore invalid and service messages\n                try {\n                    const responder = responders[ctx.message];\n\n                    if (!responder) throw new Error('Unknown responder', { cause: ctx });\n\n                    const [subController, subSignal] = deriveController(mainController.signal);\n\n                    // always recover signal so that promises also can abort\n                    if (ctx.signalName) payload[ctx.signalName] = subSignal;\n\n                    const iterator = responder(payload); // no await!\n\n                    log(LogLevel.lifecycle, ctx, 'START', iterator);\n\n                    // PROMISE\n\n                    // https://stackoverflow.com/a/19660350/5125659 the only right way is to call function and see what it returned\n                    if (!iterator[Symbol.asyncIterator] && !iterator[Symbol.iterator]) {\n                        // Errors are caught in generic handler\n                        send(worker, { ...ctx, promise: true }, await rejectOnSignal(iterator, subSignal));\n                        log(LogLevel.detail, ctx, 'PROMISE RESOLVED');\n                        return;\n                    }\n\n                    // GENERATOR\n\n                    try {\n                        // Listen outside the loop to react immediately\n                        // Could be a wait for since abort is a one-off, but listeners are disposed by signal anyway, and we don't need to block the async thread\n                        listen(\n                            worker,\n                            ctx,\n                            (data) => {\n                                if (!data.ctx.abort) return;\n                                subController.abort(data.ctx.abort);\n                                logWarn(LogLevel.lifecycle, ctx, 'GOT ABORT');\n                            },\n                            subSignal,\n                        );\n\n                        let res: any;\n                        let nextPayload: any = payload; // does not matter, will be ignored anyway\n                        do {\n                            res = await rejectOnSignal(iterator.next(nextPayload), subSignal);\n\n                            send(worker, { ...ctx, done: res.done }, res.value);\n\n                            if (res.done) {\n                                subController.abort('Done');\n                                break;\n                            }\n\n                            const nextData = await rejectOnSignal(\n                                waitFor(worker, ctx, (data) => !!data.ctx.ack, subSignal),\n                                subSignal,\n                            );\n                            nextPayload = nextData.payload;\n\n                            log(LogLevel.detail, ctx, 'LOOP ACK');\n                        } while (!res.done && !subSignal.aborted);\n                    } catch (e) {\n                        if (!subSignal.aborted && !e.message.includes('RaceAborted')) {\n                            logError(LogLevel.error, ctx, 'LOOP ERROR', e);\n                            send(worker, { ...ctx, error: true, done: true }, e);\n                        }\n                    } finally {\n                        log(LogLevel.detail, ctx, 'LOOP DONE');\n                    }\n                } catch (e) {\n                    // Generator-specific error handling\n                    logError(LogLevel.error, ctx, 'ERROR', e);\n                    send(worker, { ...ctx, error: true, done: true }, e); // Generic error handling\n                } finally {\n                    log(LogLevel.detail, ctx, 'DONE');\n                }\n            },\n            mainController.signal,\n        );\n\n        function stop() {\n            mainController.abort('Stop');\n        }\n\n        return { responders, stop }; // responders needed for typing\n    }\n\n    // Caller\n\n    //TODO Name arg\n    function createCaller<T extends Responders>(worker: WorkerLike, responders: T): T {\n        worker.addEventListener('messageerror', (e) => logError(LogLevel.error, null, 'MESSAGE ERROR', e));\n\n        //TODO Stop\n\n        return new Proxy<T>(responders as any, {\n            get(target, prop, receiver) {\n                function gen(payload: any) {\n                    const ctx: Context = { message: prop.toString(), id: crypto.randomUUID() };\n\n                    let signal: AbortSignal = null as any;\n\n                    if (payload && Object.is(payload, Object(payload))) {\n                        for (const [key, value] of Object.entries(payload)) {\n                            if (value instanceof AbortSignal) {\n                                log(LogLevel.detail, ctx, 'FOUND SIGNAL', key);\n                                ctx.signalName = key;\n                                signal = value;\n                                payload[key] = null; // will be recovered in responder\n                            }\n                        }\n                    }\n\n                    const [mainController, mainSignal] = deriveController(signal);\n\n                    const cancel = (notify: boolean, reason: string = '') => {\n                        if (mainController.signal.aborted) return;\n                        logWarn(LogLevel.lifecycle, ctx, 'CANCEL', reason, notify);\n                        if (reason) mainController.abort(reason); // stop listening\n                        if (notify) send(worker, { ...ctx, abort: reason }); // worker will break & acknowledge, but it's not important\n                    };\n\n                    // Generator\n\n                    const [promiseController, promiseSignal] = deriveController(mainSignal);\n\n                    const promise = waitFor(\n                        worker,\n                        ctx,\n                        (data) => !!data.ctx.promise || !!data.ctx.error,\n                        promiseSignal,\n                    ).then(({ ctx, payload }) => {\n                        if (ctx.error) {\n                            logError(LogLevel.error, ctx, 'PROMISE ERROR', payload);\n                            throw payload;\n                        }\n                        log(LogLevel.lifecycle, ctx, 'PROMISE RESOLVED', payload);\n                        return payload;\n                    });\n\n                    async function* generator() {\n                        let done = false;\n                        try {\n                            // React immediately\n                            mainSignal.addEventListener('abort', () => cancel(true, mainSignal.reason), {\n                                once: true,\n                                signal: mainSignal,\n                            });\n\n                            log(LogLevel.detail, ctx, 'GENERATOR START');\n                            promiseController.abort('GeneratorUsed');\n\n                            do {\n                                const data = await rejectOnSignal(\n                                    waitFor(worker, ctx, undefined, mainSignal),\n                                    mainSignal,\n                                );\n\n                                const { ctx: ctxIn, payload: value } = data;\n\n                                log(LogLevel.lifecycle, ctx, 'EVENT', mainSignal.aborted, ctxIn, value);\n\n                                if (ctxIn.promise) {\n                                    //  && !ctxIn.error\n                                    // cancel(false, 'Resolved');\n                                    // return payloadIn;\n                                    logError(LogLevel.error, ctx, 'ERROR', 'Unexpected promise in generator', data);\n                                    throw new Error('Unexpected promise in generator', { cause: data });\n                                }\n\n                                if (ctxIn.error) {\n                                    logError(LogLevel.error, ctx, 'ERROR', data);\n                                    cancel(false, 'Error');\n                                    throw value;\n                                }\n\n                                if (ctxIn.done) {\n                                    done = true;\n                                    return value;\n                                } else {\n                                    const nextPayload = yield value;\n                                    if (!mainSignal.aborted) send(worker, { ...ctx, ack: true }, nextPayload);\n                                }\n                            } while (!mainSignal.aborted);\n                        } finally {\n                            // prevent further cycles in worker once main is closed/cancelled/aborted\n                            log(LogLevel.detail, ctx, 'DONE');\n                            cancel(true, mainSignal.aborted ? mainSignal.reason : done ? 'Done' : 'Break');\n                        }\n                    }\n\n                    const iterator = generator();\n\n                    send(worker, ctx, payload);\n\n                    // FIXME Nasty hack, return both iterator and promise\n                    // Consuming code will get both, but IDE should show only proper type\n                    // Consuming code will likely use only one except someone calls `for await ... of await` which is not useful in any case\n                    iterator['then'] = promise.then.bind(promise);\n                    iterator['catch'] = promise.catch.bind(promise);\n                    iterator['finally'] = promise.finally.bind(promise);\n                    return iterator;\n                }\n\n                //TODO mimic-function(gen, fn); but no access to original\n                Object.defineProperty(gen, 'name', { value: prop.toString() });\n\n                (target as any)[prop] = gen; // so that fn is visible after use, maybe not needed\n\n                return gen;\n            },\n        }) as T;\n    }\n\n    return { createResponder, createCaller };\n}\n"],"names":["LogLevel","ctx","payload"],"mappings":"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"}

package/dist/wrpc.test.d.ts

@@ -0,0 +1 @@
+//# sourceMappingURL=wrpc.test.d.ts.map

package/dist/wrpc.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wrpc.test.d.ts","sourceRoot":"","sources":["../src/wrpc.test.ts"],"names":[],"mappings":"AAAA,OAAO,oBAAoB,CAAC"}

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@kirill.konshin/core",
+  "description": "Utilities",
+  "version": "0.0.1",
+  "type": "module",
+  "scripts": {
+    "----- BUILD -----": "",
+    "clean": "rm -rf dist .tscache tsconfig.tsbuildinfo",
+    "build": "vite build",
+    "build:index": "cti create ./src",
+    "build:check-types": "attw --pack .",
+    "start": "yarn build --watch",
+    "wait": "wait-on ./dist/index.js",
+    "----- TEST -----": "",
+    "test": "vitest run --coverage",
+    "test:watch": "vitest watch --coverage",
+    "----- STORYBOOK -----": "",
+    "storybook:start": "storybook dev -p 6006",
+    "storybook:build": "storybook build"
+  },
+  "dependencies": {
+    "colors": "^1.4.0",
+    "file-saver": "^2.0.5",
+    "many-keys-map": "^3.0.3"
+  },
+  "devDependencies": {
+    "@kirill.konshin/utils-private": "*"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "author": "Kirill Konshin <kirill@konshin.org> (https://konshin.org)",
+  "license": "MIT",
+  "exports": {
+    ".": {
+      "import": {
+        "import": "./dist/index.js",
+        "types": "./dist/index.d.ts"
+      }
+    }
+  },
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "peerDependenciesMeta": {}
+}

package/src/cache.test.ts

@@ -0,0 +1,121 @@
+import { expect, describe, test, vi } from 'vitest';
+import { ANY, MaybePromise, memo, TransformerMap } from './cache';
+
+describe('memo', async () => {
+    test('simple', async () => {
+        const random = vi.fn(() => Math.random());
+        const memoized = memo(random);
+
+        const first = await memoized();
+        const second = await memoized();
+
+        expect(first.hit).toBeFalsy();
+        expect(second.hit).toBeTruthy();
+        expect(first.value).toBe(second.value);
+        expect(memoized.size()).toBe(1);
+
+        memoized.clear();
+        expect(memoized.size()).toBe(0);
+
+        const third = await memoized();
+        expect(third.hit).toBeFalsy();
+    });
+
+    test('with key', async () => {
+        const random = vi.fn((arg) => arg + Math.random().toString());
+        const memoized = memo(random);
+
+        const first = await memoized(1);
+        const second = await memoized(2);
+
+        expect(first.hit).toBeFalsy();
+        expect(second.hit).toBeFalsy();
+        expect(first.value).not.toBe(second.value);
+        expect(memoized.size()).toBe(2);
+
+        const first2 = await memoized(1);
+        const second2 = await memoized(2);
+
+        expect(first2.hit).toBeTruthy();
+        expect(first.value).toBe(first2.value);
+        expect(second2.hit).toBeTruthy();
+        expect(second.value).toBe(second2.value);
+
+        memoized.clear(1);
+        expect(memoized.size()).toBe(1);
+        memoized.clear(ANY);
+        expect(memoized.size()).toBe(0);
+    });
+});
+
+describe('TransformerMap', async () => {
+    test('simple', async () => {
+        const dispose = vi.fn();
+
+        class Cache extends TransformerMap<number, any> {
+            write(key, value, oldValue) {
+                value.cached = true;
+                value.read = 0;
+                return value;
+            }
+            read(value, key) {
+                value.read++;
+                return value;
+            }
+            dispose(value, key) {
+                dispose(value, key);
+            }
+        }
+
+        const cache = new Cache('test');
+
+        const obj = { a: 1 };
+
+        const x1 = await cache.memo(1, obj);
+        expect(x1).toStrictEqual({ a: 1, cached: true, read: 0 });
+
+        const x2 = await cache.memo(1, obj);
+        expect(x2).toStrictEqual({ a: 1, cached: true, read: 1 });
+
+        const x3 = await cache.memo(1, { a: 2 });
+        expect(x3).toStrictEqual({ a: 2, cached: true, read: 0 });
+        expect(cache.size).toEqual(1);
+        expect(dispose).toBeCalledTimes(1);
+        expect(dispose).toBeCalledWith({ a: 1, cached: true, read: 1 }, 1);
+
+        const x4 = await cache.memo(2, { a: 20 });
+
+        expect(x4).toStrictEqual({ a: 20, cached: true, read: 0 });
+        expect(cache.size).toEqual(2);
+        expect(dispose).toBeCalledTimes(1);
+    });
+
+    test('key transform', async () => {
+        const dispose = vi.fn();
+
+        class Cache extends TransformerMap<number, any> {
+            write(key, value, oldValue) {
+                return { key, read: 0 };
+            }
+            read(value, key) {
+                value.read++;
+                return value;
+            }
+            dispose(value, key) {
+                dispose(value, key);
+            }
+        }
+
+        const cache = new Cache('test');
+
+        const x1 = await cache.memo(1);
+        expect(x1).toStrictEqual({ key: 1, read: 0 });
+
+        const x2 = await cache.memo(1);
+        expect(x2).toStrictEqual({ key: 1, read: 1 });
+
+        cache.clear();
+        expect(dispose).toBeCalledTimes(1);
+        expect(dispose).toBeCalledWith({ key: 1, read: 1 }, 1);
+    });
+});