@onting/selenium-webdriver-message-port 0.0.0-0 → 0.1.0-main.202606020948.0ed3d01

package/README.md

@@ -4,10 +4,113 @@
 
 ## Background
 
+[`MessagePort`](https://developer.mozilla.org/en-US/docs/Web/API/MessagePort) is the JavaScript standard communication channel. We are bringing `MessagePort` to [`selenium-webdriver`](https://npmjs.com/package/selenium-webdriver) by leveraging `executeScript` calls.
+
+This enables libraries that use `MessagePort` to function across the host and the browser, such as [`message-port-rpc`](https://npmjs.com/package/message-port-rpc).
+
 ## How to use
 
+In the webpage:
+
+```html
+<script>
+  import { messagePort } from 'https://cdn.jsdelivr.net/npm/@onting/selenium-webdriver-message-port/dist/browser.js';
+
+  messagePort.addEventListener('message', ({ data }) => {
+    // Will print "Hello from host!"
+    console.log(data);
+  });
+
+  // start() will uncork events sent from the host side.
+  messagePort.start();
+
+  messagePort.postMessage('Hello from browser!');
+</script>
+```
+
+In the host:
+
+```js
+import { setup } from '@onting/selenium-webdriver-message-port/host';
+
+const { messagePort, poll } = setup(webDriver);
+
+messagePort.addEventListener('message', ({ data }) => {
+  // Will print "Hello from browser!"
+  console.log(data);
+});
+
+// start() will uncork events sent from the browser side.
+messagePort.start();
+
+messagePort.postMessage('Hello from host!');
+
+// poll() will receive pending messages posted from the browser.
+await poll();
+```
+
 ## Behaviors
 
+### What can I do with `MessagePort`?
+
+`MessagePort` is an asynchronous bidirectional communication channel between two discrete JavaScript VMs.
+
+[`message-port-rpc`](https://npmjs.com/package/message-port-rpc) leverage `MessagePort` and turn any functions into remoting functions (RPC). Client calling the RPC function will have the arguments passed to the server via `MessagePort`. And the server returning the RPC function will have the return value pass to the client.
+
+<details>
+<summary>Click to see the sample code</summary>
+
+```html
+<script>
+  import { messagePort } from 'https://cdn.jsdelivr.net/npm/@onting/selenium-webdriver-message-port/dist/browser.js';
+  import { messagePortRPC } from 'https://esm.sh/message-port-rpc';
+
+  messagePortRPC(messagePort, message => console.log(message));
+</script>
+```
+
+```ts
+import { setup } from '@onting/selenium-webdriver-message-port/host';
+import { messagePortRPC } from 'https://esm.sh/message-port-rpc';
+
+const { messagePort, poll } = setup(webDriver);
+
+const log = messagePortRPC(messagePort);
+
+await log('Hello from host!');
+```
+</details>
+
+### What transferables are supported?
+
+We currently support transferring `MessagePort` only.
+
+### Why are my tests lingering?
+
+At the end of the test, call `messagePort.close()` to shut down. If you have transferred additional `MessagePort`, also call `close()` on them.
+
+### Why am I not receiving messages on host side?
+
+Call `poll()` when your host code is idle. The `poll()` call will retrieve all pending messages from the browser via `executeScript()` and send it to the port on the host side.
+
+Similar to `executeScript()`, special considerations must be made while calling `poll()`. WebDriver is single-threaded, all commands are processed serially. You should not call `poll()` while other WebDriver commands are being processed.
+
+### Why am I not receiving the first few messages?
+
+Call `MessagePort.start()` only after all `MessagePort.addEventListener()` are registered. The `start()` will uncork the `MessagePort` and messages will flow through.
+
+If event listeners are not registered before `start()`, messages sent before the registration will be lost.
+
+### Why `undefined` values are not being sent?
+
+`executeScript()` modifies the value being passed, similar to how `JSON.parse` and `JSON.stringify` works.
+
+Consider using `JSON.stringify` or [structured clone algorithm](https://www.npmjs.com/search?q=structured%20clone%20algorithm) to preserve values that are not safe to pass across the WebDriver serialization context.
+
+### Do you support [WebDriver BiDi Protocol](https://w3c.github.io/webdriver-bidi/)?
+
+We do not support the new [WebDriver BiDi Protocol](https://w3c.github.io/webdriver-bidi/) yet but this is on our road map. Using BiDi could simplify some userland code.
+
 ## Contributions
 
 Like us? [Star](https://github.com/teamonting/selenium-webdriver-message-port/stargazers) us.

package/dist/browser.d.ts

@@ -0,0 +1,3 @@
+declare const messagePort: MessagePort;
+
+export { messagePort };

package/dist/browser.js

@@ -0,0 +1,61 @@
+import {
+  ROOT_MESSAGE_PORT,
+  marshal,
+  unmarshal,
+  v7_default
+} from "./chunk-2MTLTUOY.js";
+
+// src/browser/index.ts
+var portMap = /* @__PURE__ */ new Map();
+var queue = [];
+function flushAll() {
+  return Object.freeze(queue.splice(0));
+}
+function createMessagePort(portId) {
+  if (portMap.has(portId)) {
+    throw new Error(`MessagePort with id "${portId}" is already registered, cannot register again`);
+  }
+  const { port1, port2 } = new MessageChannel();
+  registerMessagePort(port1, portId);
+  return port2;
+}
+function registerMessagePort(port, portId) {
+  if (portMap.has(portId)) {
+    throw new Error(`MessagePort with id "${portId}" is already registered, cannot register again`);
+  }
+  portMap.set(portId, port);
+  port.addEventListener("message", ({ data, ports }) => {
+    const transferPortIds = ports.map((port2) => {
+      const id = v7_default();
+      registerMessagePort(port2, id);
+      return id;
+    });
+    queue.push(
+      Object.freeze({
+        data: marshal(data, ports),
+        portId,
+        transferPortIds
+      })
+    );
+  });
+  port.start();
+}
+function sendToBrowser(message) {
+  const { data, portId, transferPortIds } = message;
+  const port = portMap.get(portId);
+  if (!port) {
+    console.warn(`Host should not send to unbound port "${portId}"`);
+    return;
+  }
+  const transfer = transferPortIds.map((transferPortId) => createMessagePort(transferPortId));
+  port.postMessage(unmarshal(data, transfer), transfer);
+}
+globalThis.__seleniumWebDriverMessagePortFacility = Object.freeze({
+  flushAll,
+  sendToBrowser
+});
+var messagePort = createMessagePort(ROOT_MESSAGE_PORT);
+export {
+  messagePort
+};
+//# sourceMappingURL=browser.js.map

package/dist/browser.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/browser/index.ts"],"sourcesContent":["/// <reference types=\"../env.d.ts\" />\n\nimport { v7 } from 'uuid';\nimport { ROOT_MESSAGE_PORT } from '../constant.ts';\nimport { marshal, unmarshal } from '../marshal.ts';\nimport type { MessagePortFacility, SerializedMessage } from '../types.js';\n\nconst portMap = new Map<string, MessagePort>();\nconst queue: SerializedMessage[] = [];\n\nfunction flushAll(): readonly SerializedMessage[] {\n  return Object.freeze(queue.splice(0));\n}\n\nfunction createMessagePort(portId: string): MessagePort {\n  if (portMap.has(portId)) {\n    throw new Error(`MessagePort with id \"${portId}\" is already registered, cannot register again`);\n  }\n\n  const { port1, port2 } = new MessageChannel();\n\n  registerMessagePort(port1, portId);\n\n  return port2;\n}\n\nfunction registerMessagePort(port: MessagePort, portId: string): void {\n  if (portMap.has(portId)) {\n    throw new Error(`MessagePort with id \"${portId}\" is already registered, cannot register again`);\n  }\n\n  portMap.set(portId, port);\n\n  port.addEventListener('message', ({ data, ports }) => {\n    // Because MessagePort will detach on send, thus, postMessage() cannot transfer the same MessagePort twice.\n    // We don't need to check if the port already have an ID or not.\n    // MessagePort cannot be sent twice, thus it must be new.\n    // Otherwise postMessage() would have already fail and should never reach this code block.\n\n    const transferPortIds = ports.map(port => {\n      const id = v7();\n\n      registerMessagePort(port, id);\n\n      return id;\n    });\n\n    queue.push(\n      Object.freeze({\n        data: marshal(data, ports),\n        portId,\n        transferPortIds\n      })\n    );\n  });\n\n  port.start();\n}\n\nfunction sendToBrowser(message: SerializedMessage): void {\n  const { data, portId, transferPortIds } = message;\n\n  const port = portMap.get(portId);\n\n  if (!port) {\n    console.warn(`Host should not send to unbound port \"${portId}\"`);\n\n    return;\n  }\n\n  // postMessage() will neuter MessagePort after sent, thus, every port received must be new transfer.\n  const transfer = transferPortIds.map(transferPortId => createMessagePort(transferPortId));\n\n  port.postMessage(unmarshal(data, transfer), transfer);\n}\n\nglobalThis.__seleniumWebDriverMessagePortFacility = Object.freeze({\n  flushAll,\n  sendToBrowser\n} satisfies MessagePortFacility);\n\nconst messagePort = createMessagePort(ROOT_MESSAGE_PORT);\n\nexport { messagePort };\n"],"mappings":";;;;;;;;AAOA,IAAM,UAAU,oBAAI,IAAyB;AAC7C,IAAM,QAA6B,CAAC;AAEpC,SAAS,WAAyC;AAChD,SAAO,OAAO,OAAO,MAAM,OAAO,CAAC,CAAC;AACtC;AAEA,SAAS,kBAAkB,QAA6B;AACtD,MAAI,QAAQ,IAAI,MAAM,GAAG;AACvB,UAAM,IAAI,MAAM,wBAAwB,MAAM,gDAAgD;AAAA,EAChG;AAEA,QAAM,EAAE,OAAO,MAAM,IAAI,IAAI,eAAe;AAE5C,sBAAoB,OAAO,MAAM;AAEjC,SAAO;AACT;AAEA,SAAS,oBAAoB,MAAmB,QAAsB;AACpE,MAAI,QAAQ,IAAI,MAAM,GAAG;AACvB,UAAM,IAAI,MAAM,wBAAwB,MAAM,gDAAgD;AAAA,EAChG;AAEA,UAAQ,IAAI,QAAQ,IAAI;AAExB,OAAK,iBAAiB,WAAW,CAAC,EAAE,MAAM,MAAM,MAAM;AAMpD,UAAM,kBAAkB,MAAM,IAAI,CAAAA,UAAQ;AACxC,YAAM,KAAK,WAAG;AAEd,0BAAoBA,OAAM,EAAE;AAE5B,aAAO;AAAA,IACT,CAAC;AAED,UAAM;AAAA,MACJ,OAAO,OAAO;AAAA,QACZ,MAAM,QAAQ,MAAM,KAAK;AAAA,QACzB;AAAA,QACA;AAAA,MACF,CAAC;AAAA,IACH;AAAA,EACF,CAAC;AAED,OAAK,MAAM;AACb;AAEA,SAAS,cAAc,SAAkC;AACvD,QAAM,EAAE,MAAM,QAAQ,gBAAgB,IAAI;AAE1C,QAAM,OAAO,QAAQ,IAAI,MAAM;AAE/B,MAAI,CAAC,MAAM;AACT,YAAQ,KAAK,yCAAyC,MAAM,GAAG;AAE/D;AAAA,EACF;AAGA,QAAM,WAAW,gBAAgB,IAAI,oBAAkB,kBAAkB,cAAc,CAAC;AAExF,OAAK,YAAY,UAAU,MAAM,QAAQ,GAAG,QAAQ;AACtD;AAEA,WAAW,yCAAyC,OAAO,OAAO;AAAA,EAChE;AAAA,EACA;AACF,CAA+B;AAE/B,IAAM,cAAc,kBAAkB,iBAAiB;","names":["port"]}

package/dist/chunk-2MTLTUOY.js

@@ -0,0 +1,174 @@
+// ../../node_modules/uuid/dist-node/rng.js
+var rnds8 = new Uint8Array(16);
+function rng() {
+  return crypto.getRandomValues(rnds8);
+}
+
+// ../../node_modules/uuid/dist-node/stringify.js
+var byteToHex = [];
+for (let i = 0; i < 256; ++i) {
+  byteToHex.push((i + 256).toString(16).slice(1));
+}
+function unsafeStringify(arr, offset = 0) {
+  return (byteToHex[arr[offset + 0]] + byteToHex[arr[offset + 1]] + byteToHex[arr[offset + 2]] + byteToHex[arr[offset + 3]] + "-" + byteToHex[arr[offset + 4]] + byteToHex[arr[offset + 5]] + "-" + byteToHex[arr[offset + 6]] + byteToHex[arr[offset + 7]] + "-" + byteToHex[arr[offset + 8]] + byteToHex[arr[offset + 9]] + "-" + byteToHex[arr[offset + 10]] + byteToHex[arr[offset + 11]] + byteToHex[arr[offset + 12]] + byteToHex[arr[offset + 13]] + byteToHex[arr[offset + 14]] + byteToHex[arr[offset + 15]]).toLowerCase();
+}
+
+// ../../node_modules/uuid/dist-node/v7.js
+var _state = {};
+function v7(options, buf, offset) {
+  let bytes;
+  if (options) {
+    bytes = v7Bytes(options.random ?? options.rng?.() ?? rng(), options.msecs, options.seq, buf, offset);
+  } else {
+    const now = Date.now();
+    const rnds = rng();
+    updateV7State(_state, now, rnds);
+    bytes = v7Bytes(rnds, _state.msecs, _state.seq, buf, offset);
+  }
+  return buf ?? unsafeStringify(bytes);
+}
+function updateV7State(state, now, rnds) {
+  state.msecs ??= -Infinity;
+  state.seq ??= 0;
+  if (now > state.msecs) {
+    state.seq = rnds[6] << 23 | rnds[7] << 16 | rnds[8] << 8 | rnds[9];
+    state.msecs = now;
+  } else {
+    state.seq = state.seq + 1 | 0;
+    if (state.seq === 0) {
+      state.msecs++;
+    }
+  }
+  return state;
+}
+function v7Bytes(rnds, msecs, seq, buf, offset = 0) {
+  if (rnds.length < 16) {
+    throw new Error("Random bytes length must be >= 16");
+  }
+  if (!buf) {
+    buf = new Uint8Array(16);
+    offset = 0;
+  } else {
+    if (offset < 0 || offset + 16 > buf.length) {
+      throw new RangeError(`UUID byte range ${offset}:${offset + 15} is out of buffer bounds`);
+    }
+  }
+  msecs ??= Date.now();
+  seq ??= rnds[6] * 127 << 24 | rnds[7] << 16 | rnds[8] << 8 | rnds[9];
+  buf[offset++] = msecs / 1099511627776 & 255;
+  buf[offset++] = msecs / 4294967296 & 255;
+  buf[offset++] = msecs / 16777216 & 255;
+  buf[offset++] = msecs / 65536 & 255;
+  buf[offset++] = msecs / 256 & 255;
+  buf[offset++] = msecs & 255;
+  buf[offset++] = 112 | seq >>> 28 & 15;
+  buf[offset++] = seq >>> 20 & 255;
+  buf[offset++] = 128 | seq >>> 14 & 63;
+  buf[offset++] = seq >>> 6 & 255;
+  buf[offset++] = seq << 2 & 255 | rnds[10] & 3;
+  buf[offset++] = rnds[11];
+  buf[offset++] = rnds[12];
+  buf[offset++] = rnds[13];
+  buf[offset++] = rnds[14];
+  buf[offset++] = rnds[15];
+  return buf;
+}
+var v7_default = v7;
+
+// src/constant.ts
+var ROOT_MESSAGE_PORT = "00000000-0000-0000-0000-000000000000";
+
+// ../../node_modules/workthru/dist/workthru.mjs
+function workthru_(target, transformer, walked) {
+  if (Array.isArray(target)) {
+    if (walked.has(target)) {
+      return walked.get(target);
+    }
+    let nextArray = transformer(target);
+    if (nextArray !== target) {
+      walked.set(target, nextArray);
+      return nextArray;
+    }
+    walked.set(target, target);
+    for (const index in target) {
+      const value = target[index];
+      const nextValue = workthru_(value, transformer, walked);
+      if (nextValue !== value) {
+        if (nextArray === target) {
+          nextArray = [...target];
+        }
+        nextArray[index] = nextValue;
+      }
+    }
+    walked.set(target, nextArray);
+    return nextArray;
+  }
+  if (typeof target === "object" && target !== null) {
+    if (walked.has(target)) {
+      return walked.get(target);
+    }
+    const prototype = Object.getPrototypeOf(target);
+    if (prototype === null || prototype === Object.prototype) {
+      const nextTarget = transformer(target);
+      if (nextTarget !== target) {
+        walked.set(target, nextTarget);
+        return nextTarget;
+      }
+      walked.set(target, target);
+      const entries = Object.entries(target);
+      let nextMap = void 0;
+      for (const [key, value] of entries) {
+        const nextValue = workthru_(value, transformer, walked);
+        if (nextValue !== value) {
+          if (!nextMap) {
+            nextMap = new Map(entries);
+          }
+          nextMap.set(key, nextValue);
+        }
+      }
+      const nextObject = nextMap ? Object.fromEntries(nextMap.entries()) : target;
+      walked.set(target, nextObject);
+      return nextObject;
+    }
+  }
+  return transformer(target);
+}
+function workthru(target, transformer) {
+  return workthru_(target, transformer, /* @__PURE__ */ new Map());
+}
+var workthru_default = workthru;
+
+// src/marshal.ts
+var MESSAGE_PORT = "@@__SELENIUM_WEBDRIVER_MESSAGE_PORT__@@";
+function marshal(target, transferable) {
+  return workthru_default(target, (value) => {
+    if (value instanceof MessagePort) {
+      const index = transferable.indexOf(value);
+      if (index === -1) {
+        throw new Error("Cannot marshal MessagePort: it must be included in the transfer list");
+      }
+      return [MESSAGE_PORT, index];
+    }
+    return value;
+  });
+}
+function unmarshal(target, transferable) {
+  return workthru_default(target, (value) => {
+    if (Array.isArray(value) && value[0] === MESSAGE_PORT) {
+      const index = value[1];
+      if (typeof index !== "number" || !Number.isInteger(index) || index < 0 || index >= transferable.length) {
+        throw new Error(`Cannot unmarshal MessagePort: invalid transfer index ${String(index)}`);
+      }
+      return transferable[index];
+    }
+    return value;
+  });
+}
+
+export {
+  v7_default,
+  ROOT_MESSAGE_PORT,
+  marshal,
+  unmarshal
+};
+//# sourceMappingURL=chunk-2MTLTUOY.js.map

package/dist/chunk-2MTLTUOY.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../node_modules/uuid/dist-node/rng.js","../../../node_modules/uuid/dist-node/stringify.js","../../../node_modules/uuid/dist-node/v7.js","../src/constant.ts","../../../node_modules/workthru/src/workthru.ts","../src/marshal.ts"],"sourcesContent":["const rnds8 = new Uint8Array(16);\nexport default function rng() {\n    return crypto.getRandomValues(rnds8);\n}\n","import validate from './validate.js';\nconst byteToHex = [];\nfor (let i = 0; i < 256; ++i) {\n    byteToHex.push((i + 0x100).toString(16).slice(1));\n}\nexport function unsafeStringify(arr, offset = 0) {\n    return (byteToHex[arr[offset + 0]] +\n        byteToHex[arr[offset + 1]] +\n        byteToHex[arr[offset + 2]] +\n        byteToHex[arr[offset + 3]] +\n        '-' +\n        byteToHex[arr[offset + 4]] +\n        byteToHex[arr[offset + 5]] +\n        '-' +\n        byteToHex[arr[offset + 6]] +\n        byteToHex[arr[offset + 7]] +\n        '-' +\n        byteToHex[arr[offset + 8]] +\n        byteToHex[arr[offset + 9]] +\n        '-' +\n        byteToHex[arr[offset + 10]] +\n        byteToHex[arr[offset + 11]] +\n        byteToHex[arr[offset + 12]] +\n        byteToHex[arr[offset + 13]] +\n        byteToHex[arr[offset + 14]] +\n        byteToHex[arr[offset + 15]]).toLowerCase();\n}\nfunction stringify(arr, offset = 0) {\n    const uuid = unsafeStringify(arr, offset);\n    if (!validate(uuid)) {\n        throw TypeError('Stringified UUID is invalid');\n    }\n    return uuid;\n}\nexport default stringify;\n","import rng from './rng.js';\nimport { unsafeStringify } from './stringify.js';\nconst _state = {};\nfunction v7(options, buf, offset) {\n    let bytes;\n    if (options) {\n        bytes = v7Bytes(options.random ?? options.rng?.() ?? rng(), options.msecs, options.seq, buf, offset);\n    }\n    else {\n        const now = Date.now();\n        const rnds = rng();\n        updateV7State(_state, now, rnds);\n        bytes = v7Bytes(rnds, _state.msecs, _state.seq, buf, offset);\n    }\n    return buf ?? unsafeStringify(bytes);\n}\nexport function updateV7State(state, now, rnds) {\n    state.msecs ??= -Infinity;\n    state.seq ??= 0;\n    if (now > state.msecs) {\n        state.seq = (rnds[6] << 23) | (rnds[7] << 16) | (rnds[8] << 8) | rnds[9];\n        state.msecs = now;\n    }\n    else {\n        state.seq = (state.seq + 1) | 0;\n        if (state.seq === 0) {\n            state.msecs++;\n        }\n    }\n    return state;\n}\nfunction v7Bytes(rnds, msecs, seq, buf, offset = 0) {\n    if (rnds.length < 16) {\n        throw new Error('Random bytes length must be >= 16');\n    }\n    if (!buf) {\n        buf = new Uint8Array(16);\n        offset = 0;\n    }\n    else {\n        if (offset < 0 || offset + 16 > buf.length) {\n            throw new RangeError(`UUID byte range ${offset}:${offset + 15} is out of buffer bounds`);\n        }\n    }\n    msecs ??= Date.now();\n    seq ??= ((rnds[6] * 0x7f) << 24) | (rnds[7] << 16) | (rnds[8] << 8) | rnds[9];\n    buf[offset++] = (msecs / 0x10000000000) & 0xff;\n    buf[offset++] = (msecs / 0x100000000) & 0xff;\n    buf[offset++] = (msecs / 0x1000000) & 0xff;\n    buf[offset++] = (msecs / 0x10000) & 0xff;\n    buf[offset++] = (msecs / 0x100) & 0xff;\n    buf[offset++] = msecs & 0xff;\n    buf[offset++] = 0x70 | ((seq >>> 28) & 0x0f);\n    buf[offset++] = (seq >>> 20) & 0xff;\n    buf[offset++] = 0x80 | ((seq >>> 14) & 0x3f);\n    buf[offset++] = (seq >>> 6) & 0xff;\n    buf[offset++] = ((seq << 2) & 0xff) | (rnds[10] & 0x03);\n    buf[offset++] = rnds[11];\n    buf[offset++] = rnds[12];\n    buf[offset++] = rnds[13];\n    buf[offset++] = rnds[14];\n    buf[offset++] = rnds[15];\n    return buf;\n}\nexport default v7;\n","const ROOT_MESSAGE_PORT = '00000000-0000-0000-0000-000000000000';\n\nexport { ROOT_MESSAGE_PORT };\n","/**\n * Internal recursive helper for {@link workthru}.\n *\n * For arrays and plain objects, calls transformer first. If transformer returns the same reference,\n * recursively walks children and rebuilds the container only when a child changes (structural sharing).\n * Class instances, primitives, functions, and null are passed directly to transformer without recursion.\n *\n * The `walked` map tracks already-visited nodes to handle circular references and avoid duplicate work.\n *\n * @param target - Value to transform.\n * @param transformer - Called on every visited value; return the original value to recurse into children.\n * @param walked - Cycle-detection map from original value to its transformed counterpart.\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nfunction workthru_(target: any, transformer: (value: any) => any, walked: Map<any, any>): any {\n  if (Array.isArray(target)) {\n    if (walked.has(target)) {\n      return walked.get(target);\n    }\n\n    let nextArray = transformer(target);\n\n    if (nextArray !== target) {\n      walked.set(target, nextArray);\n\n      return nextArray;\n    }\n\n    walked.set(target, target);\n\n    // for-in loop can handle sparse array.\n    for (const index in target) {\n      const value = target[index];\n      const nextValue = workthru_(value, transformer, walked);\n\n      if (nextValue !== value) {\n        if (nextArray === target) {\n          nextArray = [...target];\n        }\n\n        nextArray[index] = nextValue;\n      }\n    }\n\n    walked.set(target, nextArray);\n\n    return nextArray;\n  }\n\n  if (typeof target === 'object' && target !== null) {\n    if (walked.has(target)) {\n      return walked.get(target);\n    }\n\n    const prototype = Object.getPrototypeOf(target);\n\n    if (prototype === null || prototype === Object.prototype) {\n      const nextTarget = transformer(target);\n\n      if (nextTarget !== target) {\n        walked.set(target, nextTarget);\n\n        return nextTarget;\n      }\n\n      walked.set(target, target);\n\n      const entries = Object.entries(target);\n      let nextMap = undefined;\n\n      for (const [key, value] of entries) {\n        const nextValue = workthru_(value, transformer, walked);\n\n        if (nextValue !== value) {\n          if (!nextMap) {\n            nextMap = new Map(entries);\n          }\n\n          nextMap.set(key, nextValue);\n        }\n      }\n\n      const nextObject = nextMap ? Object.fromEntries(nextMap.entries()) : target;\n\n      walked.set(target, nextObject);\n\n      return nextObject;\n    }\n  }\n\n  return transformer(target);\n}\n\n/**\n * Recursively walks the input in a depth-first search manner and transforms value as needed.\n *\n * Every traversed value will be passed to the `transformer` function.\n *\n * - If the `transformer` return the original value, the traversal for this branch will be continued\n * - If the `transformer` return a new value, the traversal for this branch will be ended\n *\n * The following data types are supported:\n *\n * - boolean, number, string\n * - array will be transformed on itself and every of the element\n * - plain object will be transformed on itself and every of its member value\n *\n * Notes:\n *\n * - Values with unsupported will be kept as-is;\n * - Values that are not transformed will be kept as-is\n *\n * @param target - The value to be worked through\n * @param transformer - The function to transform the value\n * @returns - The transformed value if the input has been transformed, otherwise, return the original value\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nfunction workthru(target: any, transformer: (value: any) => any): any {\n  return workthru_(target, transformer, new Map());\n}\n\nexport default workthru;\n","import { workthru } from 'workthru';\n\nconst MESSAGE_PORT = '@@__SELENIUM_WEBDRIVER_MESSAGE_PORT__@@';\n\n/**\n * Marshals the data and mask `MessagePort` into ['@@__SELENIUM_WEBDRIVER_MESSAGE_PORT__@@', 1].\n *\n * MessagePort cannot be sent directly across WebDriver.executeScript.\n *\n * We are walking the postMessage(data) and turning MessagePort into ['@@__SELENIUM_WEBDRIVER_MESSAGE_PORT__@@', 1].\n *\n * The second argument is the index of the MessagePort as they appear in Transferable[].\n *\n * @param target\n * @param transferable\n * @returns\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nfunction marshal(target: any, transferable: readonly Transferable[]): any {\n  return workthru(target, value => {\n    if (value instanceof MessagePort) {\n      const index = transferable.indexOf(value);\n\n      if (index === -1) {\n        throw new Error('Cannot marshal MessagePort: it must be included in the transfer list');\n      }\n\n      return [MESSAGE_PORT, index] as const;\n    }\n\n    return value;\n  });\n}\n\n/**\n * Unmarshals the data and unmask ['@@__SELENIUM_WEBDRIVER_MESSAGE_PORT__@@', 1] into `MessagePort`.\n *\n * MessagePort cannot be sent directly across WebDriver.executeScript.\n *\n * We are walking the postMessage(data) and turning MessagePort into ['@@__SELENIUM_WEBDRIVER_MESSAGE_PORT__@@', 1].\n *\n * The second argument is the index of the MessagePort as they appear in Transferable[].\n *\n * @param target\n * @param transferable\n * @returns\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nfunction unmarshal(target: any, transferable: readonly Transferable[]): any {\n  return workthru(target, value => {\n    if (Array.isArray(value) && value[0] === MESSAGE_PORT) {\n      const index = value[1];\n\n      if (typeof index !== 'number' || !Number.isInteger(index) || index < 0 || index >= transferable.length) {\n        throw new Error(`Cannot unmarshal MessagePort: invalid transfer index ${String(index)}`);\n      }\n\n      return transferable[index];\n    }\n\n    return value;\n  });\n}\n\nexport { marshal, unmarshal };\n"],"mappings":"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","names":[]}

package/dist/host.d.ts

@@ -0,0 +1,8 @@
+import { WebDriver } from 'selenium-webdriver';
+
+declare function setup(webDriver: WebDriver): {
+    messagePort: MessagePort;
+    poll(): Promise<void>;
+};
+
+export { setup };

package/dist/host.js

@@ -0,0 +1,105 @@
+import {
+  ROOT_MESSAGE_PORT,
+  marshal,
+  unmarshal,
+  v7_default
+} from "./chunk-2MTLTUOY.js";
+
+// src/host/createSequencer.ts
+function createSequencer() {
+  const backlog = [];
+  let isBusy = false;
+  async function kickoff() {
+    if (isBusy) {
+      return;
+    }
+    isBusy = true;
+    try {
+      let fn;
+      while (fn = backlog.shift()) {
+        await fn();
+      }
+    } finally {
+      isBusy = false;
+    }
+  }
+  return (fn) => new Promise((resolve, reject) => {
+    backlog.push(async () => {
+      try {
+        resolve(await fn());
+      } catch (error) {
+        reject(error);
+      }
+    });
+    kickoff();
+  });
+}
+var createSequencer_default = createSequencer;
+
+// src/host/setup.ts
+function setup(webDriver) {
+  const portMap = /* @__PURE__ */ new Map();
+  const executeScriptSequencer = createSequencer_default();
+  const createMessagePort = (id) => {
+    if (portMap.has(id)) {
+      throw new Error(`MessagePort with id "${id}" is already registered, cannot register again`);
+    }
+    const { port1, port2 } = new MessageChannel();
+    registerMessagePort(port1, id);
+    return port2;
+  };
+  const registerMessagePort = (port, portId) => {
+    if (portMap.has(portId)) {
+      throw new Error(`MessagePort with id "${portId}" is already registered, cannot register again`);
+    }
+    portMap.set(portId, port);
+    port.addEventListener("message", ({ data, ports }) => {
+      void executeScriptSequencer(async () => {
+        await webDriver.executeScript(
+          (message) => {
+            if (!globalThis.__seleniumWebDriverMessagePortFacility) {
+              throw new Error("The page does not have harness installed, cannot send message");
+            }
+            globalThis.__seleniumWebDriverMessagePortFacility.sendToBrowser(message);
+          },
+          {
+            data: marshal(data, ports),
+            portId,
+            transferPortIds: ports.map((port2) => {
+              const id = v7_default();
+              registerMessagePort(port2, id);
+              return id;
+            })
+          }
+        );
+      }).catch((error) => console.error(error));
+    });
+    port.start();
+  };
+  const poll = async () => {
+    const entries = await webDriver.executeScript(() => {
+      if (!globalThis.__seleniumWebDriverMessagePortFacility) {
+        throw new Error("The page does not have harness installed");
+      }
+      return globalThis.__seleniumWebDriverMessagePortFacility.flushAll();
+    });
+    for (const { data, portId, transferPortIds } of entries) {
+      const port = portMap.get(portId);
+      if (!port) {
+        console.warn(`Browser should not send to unbound port "${portId}"`);
+        continue;
+      }
+      const transfer = transferPortIds.map((transferPortId) => createMessagePort(transferPortId));
+      port.postMessage(unmarshal(data, transfer), transfer);
+    }
+  };
+  return Object.freeze({
+    messagePort: createMessagePort(ROOT_MESSAGE_PORT),
+    poll
+  });
+}
+var setup_default = setup;
+export {
+  setup_default as setup
+};
+//# sourceMappingURL=host.js.map

package/dist/host.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/host/createSequencer.ts","../src/host/setup.ts"],"sourcesContent":["type Fn<T = unknown> = () => Promise<T>;\n\n// We could use `p-queue` and set `{ concurrency: 1 }` but it has too many features and too big.\n\n/**\n * Creates a sequencer which sequence function calls with concurrency of 1.\n *\n * @returns A function, when called, will queue the passing function into the sequencer.\n */\nfunction createSequencer(): <T>(fn: Fn<T>) => Promise<T> {\n  const backlog: Fn<void>[] = [];\n  let isBusy = false;\n\n  async function kickoff() {\n    if (isBusy) {\n      return;\n    }\n\n    isBusy = true;\n\n    try {\n      let fn: Fn<void> | undefined;\n\n      while ((fn = backlog.shift())) {\n        await fn();\n      }\n    } finally {\n      isBusy = false;\n    }\n  }\n\n  return <T>(fn: Fn<T>): Promise<T> =>\n    new Promise<T>((resolve, reject) => {\n      backlog.push(async () => {\n        try {\n          resolve(await fn());\n        } catch (error) {\n          reject(error);\n        }\n      });\n\n      kickoff();\n    });\n}\n\nexport default createSequencer;\n","/// <reference types=\"../env.d.ts\" />\n\nimport type { WebDriver } from 'selenium-webdriver';\nimport { v7 } from 'uuid';\nimport { ROOT_MESSAGE_PORT } from '../constant.ts';\nimport { marshal, unmarshal } from '../marshal.ts';\nimport type { SerializedMessage } from '../types.ts';\nimport createSequencer from './createSequencer.ts';\n\nfunction setup(webDriver: WebDriver): {\n  messagePort: MessagePort;\n  poll(): Promise<void>;\n} {\n  const portMap = new Map<string, MessagePort>();\n\n  // `executeScript()` calls (and all calls) are not queued in `selenium-webdriver`, they are HTTP POST in parallel.\n  // Thus, multiple `executeScript()` calls could be processed in random order.\n  // Thus, `MessagePort` could be used before they are transferred.\n  // We need to sequence all `executeScript()` calls.\n  const executeScriptSequencer = createSequencer();\n\n  const createMessagePort = (id: string): MessagePort => {\n    if (portMap.has(id)) {\n      throw new Error(`MessagePort with id \"${id}\" is already registered, cannot register again`);\n    }\n\n    const { port1, port2 } = new MessageChannel();\n\n    registerMessagePort(port1, id);\n\n    return port2;\n  };\n\n  const registerMessagePort = (port: MessagePort, portId: string): void => {\n    if (portMap.has(portId)) {\n      throw new Error(`MessagePort with id \"${portId}\" is already registered, cannot register again`);\n    }\n\n    portMap.set(portId, port);\n\n    port.addEventListener('message', ({ data, ports }) => {\n      void executeScriptSequencer(async () => {\n        await webDriver.executeScript<void>(\n          (message: SerializedMessage) => {\n            if (!globalThis.__seleniumWebDriverMessagePortFacility) {\n              throw new Error('The page does not have harness installed, cannot send message');\n            }\n\n            globalThis.__seleniumWebDriverMessagePortFacility.sendToBrowser(message);\n          },\n          {\n            data: marshal(data, ports),\n            portId,\n            transferPortIds: ports.map(port => {\n              // Because MessagePort will be neutered on transfer, thus, postMessage() cannot transfer the same MessagePort twice.\n              // We don't need to check if the port already have an ID or not, it must be new.\n              // Otherwise postMessage() would have already fail and should never reach this code block.\n              const id = v7();\n\n              registerMessagePort(port, id);\n\n              return id;\n            })\n          } satisfies SerializedMessage\n        );\n      }).catch(error => console.error(error));\n    });\n\n    port.start();\n  };\n\n  const poll = async () => {\n    const entries = await webDriver.executeScript<SerializedMessage[]>(() => {\n      if (!globalThis.__seleniumWebDriverMessagePortFacility) {\n        throw new Error('The page does not have harness installed');\n      }\n\n      return globalThis.__seleniumWebDriverMessagePortFacility.flushAll();\n    });\n\n    for (const { data, portId, transferPortIds } of entries) {\n      const port = portMap.get(portId);\n\n      if (!port) {\n        console.warn(`Browser should not send to unbound port \"${portId}\"`);\n\n        continue;\n      }\n\n      // postMessage() will neuter MessagePort after sent, thus, every port received must be new transfer.\n      const transfer = transferPortIds.map(transferPortId => createMessagePort(transferPortId));\n\n      port.postMessage(unmarshal(data, transfer), transfer);\n    }\n  };\n\n  return Object.freeze({\n    messagePort: createMessagePort(ROOT_MESSAGE_PORT),\n    poll\n  });\n}\n\nexport default setup;\n"],"mappings":";;;;;;;;AASA,SAAS,kBAAgD;AACvD,QAAM,UAAsB,CAAC;AAC7B,MAAI,SAAS;AAEb,iBAAe,UAAU;AACvB,QAAI,QAAQ;AACV;AAAA,IACF;AAEA,aAAS;AAET,QAAI;AACF,UAAI;AAEJ,aAAQ,KAAK,QAAQ,MAAM,GAAI;AAC7B,cAAM,GAAG;AAAA,MACX;AAAA,IACF,UAAE;AACA,eAAS;AAAA,IACX;AAAA,EACF;AAEA,SAAO,CAAI,OACT,IAAI,QAAW,CAAC,SAAS,WAAW;AAClC,YAAQ,KAAK,YAAY;AACvB,UAAI;AACF,gBAAQ,MAAM,GAAG,CAAC;AAAA,MACpB,SAAS,OAAO;AACd,eAAO,KAAK;AAAA,MACd;AAAA,IACF,CAAC;AAED,YAAQ;AAAA,EACV,CAAC;AACL;AAEA,IAAO,0BAAQ;;;ACpCf,SAAS,MAAM,WAGb;AACA,QAAM,UAAU,oBAAI,IAAyB;AAM7C,QAAM,yBAAyB,wBAAgB;AAE/C,QAAM,oBAAoB,CAAC,OAA4B;AACrD,QAAI,QAAQ,IAAI,EAAE,GAAG;AACnB,YAAM,IAAI,MAAM,wBAAwB,EAAE,gDAAgD;AAAA,IAC5F;AAEA,UAAM,EAAE,OAAO,MAAM,IAAI,IAAI,eAAe;AAE5C,wBAAoB,OAAO,EAAE;AAE7B,WAAO;AAAA,EACT;AAEA,QAAM,sBAAsB,CAAC,MAAmB,WAAyB;AACvE,QAAI,QAAQ,IAAI,MAAM,GAAG;AACvB,YAAM,IAAI,MAAM,wBAAwB,MAAM,gDAAgD;AAAA,IAChG;AAEA,YAAQ,IAAI,QAAQ,IAAI;AAExB,SAAK,iBAAiB,WAAW,CAAC,EAAE,MAAM,MAAM,MAAM;AACpD,WAAK,uBAAuB,YAAY;AACtC,cAAM,UAAU;AAAA,UACd,CAAC,YAA+B;AAC9B,gBAAI,CAAC,WAAW,wCAAwC;AACtD,oBAAM,IAAI,MAAM,+DAA+D;AAAA,YACjF;AAEA,uBAAW,uCAAuC,cAAc,OAAO;AAAA,UACzE;AAAA,UACA;AAAA,YACE,MAAM,QAAQ,MAAM,KAAK;AAAA,YACzB;AAAA,YACA,iBAAiB,MAAM,IAAI,CAAAA,UAAQ;AAIjC,oBAAM,KAAK,WAAG;AAEd,kCAAoBA,OAAM,EAAE;AAE5B,qBAAO;AAAA,YACT,CAAC;AAAA,UACH;AAAA,QACF;AAAA,MACF,CAAC,EAAE,MAAM,WAAS,QAAQ,MAAM,KAAK,CAAC;AAAA,IACxC,CAAC;AAED,SAAK,MAAM;AAAA,EACb;AAEA,QAAM,OAAO,YAAY;AACvB,UAAM,UAAU,MAAM,UAAU,cAAmC,MAAM;AACvE,UAAI,CAAC,WAAW,wCAAwC;AACtD,cAAM,IAAI,MAAM,0CAA0C;AAAA,MAC5D;AAEA,aAAO,WAAW,uCAAuC,SAAS;AAAA,IACpE,CAAC;AAED,eAAW,EAAE,MAAM,QAAQ,gBAAgB,KAAK,SAAS;AACvD,YAAM,OAAO,QAAQ,IAAI,MAAM;AAE/B,UAAI,CAAC,MAAM;AACT,gBAAQ,KAAK,4CAA4C,MAAM,GAAG;AAElE;AAAA,MACF;AAGA,YAAM,WAAW,gBAAgB,IAAI,oBAAkB,kBAAkB,cAAc,CAAC;AAExF,WAAK,YAAY,UAAU,MAAM,QAAQ,GAAG,QAAQ;AAAA,IACtD;AAAA,EACF;AAEA,SAAO,OAAO,OAAO;AAAA,IACnB,aAAa,kBAAkB,iBAAiB;AAAA,IAChD;AAAA,EACF,CAAC;AACH;AAEA,IAAO,gBAAQ;","names":["port"]}

package/dist/index.js

@@ -0,0 +1 @@
+//# sourceMappingURL=index.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@onting/selenium-webdriver-message-port",
-  "version": "0.0.0-0",
+  "version": "0.1.0-main.202606020948.0ed3d01",
   "description": "MessagePort for passing bidirectional messages between WebDriver host and browser",
   "homepage": "https://github.com/teamonting/selenium-webdriver-message-port#readme",
   "publishConfig": {
@@ -15,20 +15,23 @@
   },
   "license": "MIT",
   "author": "",
+  "type": "module",
+  "main": "./dist/index.js",
+  "typings": "./dist/index.d.ts",
   "exports": {
     ".": {
-      "import": {
-        "types": "./dist/selenium-webdriver-message-port.d.mts",
-        "default": "./dist/selenium-webdriver-message-port.mjs"
-      },
-      "require": {
-        "types": "./dist/selenium-webdriver-message-port.d.ts",
-        "default": "./dist/selenium-webdriver-message-port.js"
-      }
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./browser": {
+      "types": "./dist/browser.d.ts",
+      "default": "./dist/browser.js"
+    },
+    "./host": {
+      "types": "./dist/host.d.ts",
+      "default": "./dist/host.js"
     }
   },
-  "main": "./dist/selenium-webdriver-message-port.js",
-  "typings": "./dist/selenium-webdriver-message-port.d.ts",
   "files": [
     "./*.js",
     "./CHANGELOG.md",
@@ -59,6 +62,7 @@
     "@tsconfig/recommended": "^1.0.13",
     "@tsconfig/strictest": "^2.0.8",
     "@types/node": "^25.9.1",
+    "@types/selenium-webdriver": "^4.35.6",
     "escape-string-regexp": "^4.0.0",
     "expect": "^30.4.1",
     "publint": "^0.3.21",
@@ -67,5 +71,10 @@
   },
   "localPeerDependencies": {
     "@onting/test-harness": "0.0.0-0"
+  },
+  "dependencies": {
+    "@onting/selenium-webdriver-message-port": "^0.1.0-main.202606020948.0ed3d01",
+    "uuid": "^14.0.0",
+    "workthru": "^0.1.0"
   }
 }

package/dist/selenium-webdriver-message-port.d.ts

@@ -1,2 +0,0 @@
-
-export {  }

package/dist/selenium-webdriver-message-port.js

@@ -1,19 +0,0 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-
-// src/index.ts
-var src_exports = {};
-module.exports = __toCommonJS(src_exports);
-//# sourceMappingURL=selenium-webdriver-message-port.js.map

package/dist/selenium-webdriver-message-port.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["export {};\n"],"mappings":";;;;;;;;;;;;;;;;AAAA;AAAA;","names":[]}

package/dist/selenium-webdriver-message-port.mjs

@@ -1 +0,0 @@
-//# sourceMappingURL=selenium-webdriver-message-port.mjs.map