npm - @desklink/host - Versions diffs - 0.1.0 - Mend

@desklink/host 0.1.0

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.

Files changed (142) hide show

package/LICENSE +202 -0
package/NOTICE +44 -0
package/README.md +266 -0
package/bin/desklink-host.mjs +113 -0
package/dist/bridge.d.ts +57 -0
package/dist/bridge.d.ts.map +1 -0
package/dist/bridge.js +208 -0
package/dist/bridge.js.map +1 -0
package/dist/engineProcess.d.ts +82 -0
package/dist/engineProcess.d.ts.map +1 -0
package/dist/engineProcess.js +243 -0
package/dist/engineProcess.js.map +1 -0
package/dist/index.d.ts +12 -0
package/dist/index.d.ts.map +1 -0
package/dist/index.js +12 -0
package/dist/index.js.map +1 -0
package/dist/protocol.d.ts +169 -0
package/dist/protocol.d.ts.map +1 -0
package/dist/protocol.js +18 -0
package/dist/protocol.js.map +1 -0
package/dist/resolveEngine.d.ts +34 -0
package/dist/resolveEngine.d.ts.map +1 -0
package/dist/resolveEngine.js +103 -0
package/dist/resolveEngine.js.map +1 -0
package/docs/BOUNDARY.md +145 -0
package/docs/PROTOCOL.md +363 -0
package/engine/Cargo.lock +3077 -0
package/engine/Cargo.toml +37 -0
package/engine/build.rs +107 -0
package/engine/native/inputtino_shim.cpp +11 -0
package/engine/native/vpx_shim.c +184 -0
package/engine/native/wrapper.h +7 -0
package/engine/src/capture.rs +510 -0
package/engine/src/clipboard.rs +132 -0
package/engine/src/convert.rs +299 -0
package/engine/src/encoder.rs +204 -0
package/engine/src/input.rs +355 -0
package/engine/src/keymap.rs +338 -0
package/engine/src/main.rs +614 -0
package/engine/src/peer.rs +775 -0
package/engine/src/portal.rs +115 -0
package/engine/src/protocol.rs +331 -0
package/engine/src/session.rs +2159 -0
package/engine/src/x11.rs +244 -0
package/engine/vendor/inputtino/.clang-format +166 -0
package/engine/vendor/inputtino/.clang-tidy +30 -0
package/engine/vendor/inputtino/.dockerignore +11 -0
package/engine/vendor/inputtino/.github/workflows/mirror-repo.yml +14 -0
package/engine/vendor/inputtino/.github/workflows/python-lint-format-test-typecheck.yml +124 -0
package/engine/vendor/inputtino/.github/workflows/python-test-install.yaml +49 -0
package/engine/vendor/inputtino/.github/workflows/rust.yml +40 -0
package/engine/vendor/inputtino/CMakeLists.txt +187 -0
package/engine/vendor/inputtino/LICENSE +21 -0
package/engine/vendor/inputtino/README.md +110 -0
package/engine/vendor/inputtino/bindings/python/.devcontainer/Dockerfile +23 -0
package/engine/vendor/inputtino/bindings/python/.devcontainer/devcontainer.json +28 -0
package/engine/vendor/inputtino/bindings/python/.python-version +1 -0
package/engine/vendor/inputtino/bindings/python/CMakeLists.txt +23 -0
package/engine/vendor/inputtino/bindings/python/CPPLINT.cfg +2 -0
package/engine/vendor/inputtino/bindings/python/Makefile +49 -0
package/engine/vendor/inputtino/bindings/python/README.md +215 -0
package/engine/vendor/inputtino/bindings/python/pyproject.toml +178 -0
package/engine/vendor/inputtino/bindings/python/src/inputtino/__init__.py +43 -0
package/engine/vendor/inputtino/bindings/python/src/inputtino/_core.pyi +533 -0
package/engine/vendor/inputtino/bindings/python/src/inputtino/base.py +63 -0
package/engine/vendor/inputtino/bindings/python/src/inputtino/joypad.py +248 -0
package/engine/vendor/inputtino/bindings/python/src/inputtino/keyboard.py +256 -0
package/engine/vendor/inputtino/bindings/python/src/inputtino/mouse.py +106 -0
package/engine/vendor/inputtino/bindings/python/src/inputtino/pentablet.py +73 -0
package/engine/vendor/inputtino/bindings/python/src/inputtino/py.typed +0 -0
package/engine/vendor/inputtino/bindings/python/src/inputtino/touchscreen.py +61 -0
package/engine/vendor/inputtino/bindings/python/src/inputtino/trackpad.py +74 -0
package/engine/vendor/inputtino/bindings/python/src/main.cpp +217 -0
package/engine/vendor/inputtino/bindings/python/tests/__init__.py +0 -0
package/engine/vendor/inputtino/bindings/python/tests/helpers.py +3 -0
package/engine/vendor/inputtino/bindings/python/tests/test_base.py +60 -0
package/engine/vendor/inputtino/bindings/python/tests/test_inputtino.py +5 -0
package/engine/vendor/inputtino/bindings/python/tests/test_joypad.py +332 -0
package/engine/vendor/inputtino/bindings/python/tests/test_keyboard.py +164 -0
package/engine/vendor/inputtino/bindings/python/tests/test_mouse.py +185 -0
package/engine/vendor/inputtino/bindings/python/tests/test_pentablet.py +198 -0
package/engine/vendor/inputtino/bindings/python/tests/test_touchscreen.py +144 -0
package/engine/vendor/inputtino/bindings/python/tests/test_trackpad.py +146 -0
package/engine/vendor/inputtino/bindings/python/uv.lock +390 -0
package/engine/vendor/inputtino/bindings/rust/Cargo.toml +6 -0
package/engine/vendor/inputtino/bindings/rust/inputtino/.dockerignore +1 -0
package/engine/vendor/inputtino/bindings/rust/inputtino/Cargo.toml +18 -0
package/engine/vendor/inputtino/bindings/rust/inputtino/examples/keyboard.rs +33 -0
package/engine/vendor/inputtino/bindings/rust/inputtino/examples/mouse.rs +17 -0
package/engine/vendor/inputtino/bindings/rust/inputtino/src/common.rs +116 -0
package/engine/vendor/inputtino/bindings/rust/inputtino/src/error.rs +17 -0
package/engine/vendor/inputtino/bindings/rust/inputtino/src/joypad.rs +74 -0
package/engine/vendor/inputtino/bindings/rust/inputtino/src/joypad_nintendo.rs +135 -0
package/engine/vendor/inputtino/bindings/rust/inputtino/src/joypad_ps5.rs +280 -0
package/engine/vendor/inputtino/bindings/rust/inputtino/src/joypad_xbox.rs +134 -0
package/engine/vendor/inputtino/bindings/rust/inputtino/src/keyboard.rs +76 -0
package/engine/vendor/inputtino/bindings/rust/inputtino/src/lib.rs +32 -0
package/engine/vendor/inputtino/bindings/rust/inputtino/src/mouse.rs +178 -0
package/engine/vendor/inputtino/bindings/rust/inputtino/tests/common.rs +38 -0
package/engine/vendor/inputtino/bindings/rust/inputtino/tests/joypads.rs +150 -0
package/engine/vendor/inputtino/bindings/rust/inputtino/tests/keyboard.rs +73 -0
package/engine/vendor/inputtino/bindings/rust/inputtino/tests/mouse.rs +139 -0
package/engine/vendor/inputtino/bindings/rust/inputtino-sys/.dockerignore +1 -0
package/engine/vendor/inputtino/bindings/rust/inputtino-sys/Cargo.toml +12 -0
package/engine/vendor/inputtino/bindings/rust/inputtino-sys/build.rs +48 -0
package/engine/vendor/inputtino/bindings/rust/inputtino-sys/src/lib.rs +5 -0
package/engine/vendor/inputtino/bindings/rust/inputtino-sys/wrapper.h +1 -0
package/engine/vendor/inputtino/cmake/utils.cmake +9 -0
package/engine/vendor/inputtino/docker/Dockerfile +70 -0
package/engine/vendor/inputtino/include/inputtino/input.h +324 -0
package/engine/vendor/inputtino/include/inputtino/input.hpp +466 -0
package/engine/vendor/inputtino/include/inputtino/result.hpp +37 -0
package/engine/vendor/inputtino/share/pkgconfig/libinputtino.pc.in +17 -0
package/engine/vendor/inputtino/src/c-bindings/helpers.hpp +19 -0
package/engine/vendor/inputtino/src/c-bindings/joypad_ps5.cpp +115 -0
package/engine/vendor/inputtino/src/c-bindings/joypad_switch.cpp +63 -0
package/engine/vendor/inputtino/src/c-bindings/joypad_xone.cpp +62 -0
package/engine/vendor/inputtino/src/c-bindings/keyboard.cpp +42 -0
package/engine/vendor/inputtino/src/c-bindings/mouse.cpp +67 -0
package/engine/vendor/inputtino/src/c-bindings/pen_tablet.cpp +50 -0
package/engine/vendor/inputtino/src/c-bindings/touchscreen.cpp +43 -0
package/engine/vendor/inputtino/src/c-bindings/trackpad.cpp +49 -0
package/engine/vendor/inputtino/src/uhid/README.adoc +63 -0
package/engine/vendor/inputtino/src/uhid/include/crc32.hpp +38 -0
package/engine/vendor/inputtino/src/uhid/include/uhid/protected_types.hpp +36 -0
package/engine/vendor/inputtino/src/uhid/include/uhid/ps5.hpp +550 -0
package/engine/vendor/inputtino/src/uhid/include/uhid/uhid.hpp +168 -0
package/engine/vendor/inputtino/src/uhid/joypad_ps5.cpp +580 -0
package/engine/vendor/inputtino/src/uinput/include/inputtino/keyboard.hpp +84 -0
package/engine/vendor/inputtino/src/uinput/include/inputtino/protected_ps5_types.hpp +7 -0
package/engine/vendor/inputtino/src/uinput/include/inputtino/protected_types.hpp +110 -0
package/engine/vendor/inputtino/src/uinput/joypad_nintendo.cpp +190 -0
package/engine/vendor/inputtino/src/uinput/joypad_ps.cpp +203 -0
package/engine/vendor/inputtino/src/uinput/joypad_utils.hpp +246 -0
package/engine/vendor/inputtino/src/uinput/joypad_xbox.cpp +190 -0
package/engine/vendor/inputtino/src/uinput/keyboard.cpp +120 -0
package/engine/vendor/inputtino/src/uinput/mouse.cpp +199 -0
package/engine/vendor/inputtino/src/uinput/pentablet.cpp +162 -0
package/engine/vendor/inputtino/src/uinput/touchscreen.cpp +140 -0
package/engine/vendor/inputtino/src/uinput/trackpad.cpp +192 -0
package/examples/reference-client.html +428 -0
package/package.json +38 -0

package/examples/reference-client.html ADDED Viewed

@@ -0,0 +1,428 @@
+<!doctype html>
+<html lang="en">
+<head>
+<meta charset="utf-8" />
+<meta name="viewport" content="width=device-width,initial-scale=1,maximum-scale=1,user-scalable=no" />
+<title>desklink reference client</title>
+<!--
+  The smallest thing that shows a desktop in a browser.
+  It is served by `desklink-host bridge` and exists for two reasons: to prove the
+  engine is usable by a consumer that has no signaling channel of its own, and to
+  be the worked example that a third-party application can read instead of
+  reverse-engineering the protocol.
+  Everything it does is in the documented protocol: one WebSocket carrying the
+  engine's local control protocol, one RTCPeerConnection, one data channel for
+  pointer, keyboard and clipboard. There is no framework and no build step.
+-->
+<style>
+  :root { color-scheme: dark; }
+  * { box-sizing: border-box; }
+  html, body { margin: 0; height: 100%; background: #0e1013; color: #e8eaed;
+    font: 15px/1.4 system-ui, -apple-system, "Segoe UI", sans-serif; overflow: hidden; }
+  body { display: flex; flex-direction: column; }
+  header { flex: none; display: flex; align-items: center; gap: 10px; padding: 8px 12px;
+    background: #17191d; border-bottom: 1px solid #2a2d33; }
+  header b { font-size: 14px; font-weight: 600; }
+  #status { color: #9aa0a6; font-size: 13px; flex: 1; min-width: 0; overflow: hidden;
+    text-overflow: ellipsis; white-space: nowrap; }
+  button { font: inherit; color: inherit; background: #23262c; border: 1px solid #3a3f47;
+    border-radius: 9px; min-height: 38px; padding: 6px 12px; }
+  button:disabled { opacity: .45; }
+  #stage { position: relative; flex: 1; min-height: 0; overflow: hidden;
+    display: flex; align-items: center; justify-content: center; background: #000; }
+  video { display: none; max-width: 100%; max-height: 100%; touch-action: none; }
+  #overlay { position: absolute; inset: 0; display: flex; align-items: center;
+    justify-content: center; padding: 24px; text-align: center; color: #9aa0a6; }
+  #tools { flex: none; display: flex; gap: 6px; justify-content: center; padding: 8px;
+    background: #17191d; border-top: 1px solid #2a2d33; }
+  #remote-keyboard { position: absolute; width: 1px; height: 1px; opacity: .01; border: 0; }
+</style>
+</head>
+<body>
+<header>
+  <b>desklink</b>
+  <span id="status">Starting…</span>
+  <button id="reconnect" disabled>Reconnect</button>
+</header>
+<div id="stage">
+  <video id="video" autoplay muted playsinline></video>
+  <div id="overlay"></div>
+  <textarea id="remote-keyboard" aria-label="Remote keyboard"></textarea>
+</div>
+<nav id="tools">
+  <button id="keyboard">Keyboard</button>
+  <button id="copy" hidden>Copy from desktop</button>
+  <button id="paste" hidden>Paste to desktop</button>
+</nav>
+<script type="module">
+const params = new URLSearchParams(location.search);
+const token = params.get('token') ?? '';
+const socketUrl = `${location.protocol === 'https:' ? 'wss' : 'ws'}://${location.host}/desktop?token=${encodeURIComponent(token)}`;
+const video = document.getElementById('video');
+const overlay = document.getElementById('overlay');
+const status = document.getElementById('status');
+const reconnect = document.getElementById('reconnect');
+const keyboard = document.getElementById('remote-keyboard');
+const copy = document.getElementById('copy');
+const paste = document.getElementById('paste');
+let socket = null;
+let peer = null;
+let channel = null;
+let surface = { width: 0, height: 0 };
+let nextSeq = 0;
+let pending = new Map();
+let requestId = 0;
+let attempts = 0;
+const clipboardRequests = new Map();
+function say(text) { status.textContent = text; }
+function show(text) { overlay.style.display = 'flex'; overlay.textContent = text; }
+function hide() { overlay.style.display = 'none'; video.style.display = 'block'; }
+/** One request on the engine's local protocol, over the bridge. */
+function request(method, params) {
+  const id = ++requestId;
+  return new Promise((resolve, reject) => {
+    pending.set(id, { resolve, reject });
+    socket.send(JSON.stringify({ id, method, params: params ?? {} }));
+    setTimeout(() => {
+      if (pending.delete(id)) reject(new Error(`${method} timed out`));
+    }, 30_000);
+  });
+}
+/** One message on the session's control channel, sequenced for the engine. */
+function control(message) {
+  if (channel?.readyState !== 'open') return;
+  channel.send(JSON.stringify({ ...message, seq: ++nextSeq }));
+}
+function sendPointer(phase, x, y, button) {
+  control({ kind: 'pointer', phase, x, y, ...(button === undefined ? {} : { button }) });
+}
+/** Touch → encoded-surface coordinates, or null when the touch is off the picture. */
+function point(event) {
+  const rect = video.getBoundingClientRect();
+  if (surface.width === 0 || surface.height === 0) return null;
+  const scale = Math.min(rect.width / surface.width, rect.height / surface.height);
+  const drawn = { width: surface.width * scale, height: surface.height * scale };
+  const left = rect.left + (rect.width - drawn.width) / 2;
+  const top = rect.top + (rect.height - drawn.height) / 2;
+  const x = Math.floor((event.clientX - left) / scale);
+  const y = Math.floor((event.clientY - top) / scale);
+  if (x < 0 || y < 0 || x >= surface.width || y >= surface.height) return null;
+  return { x, y };
+}
+// One pointer, four outcomes: tap, drag, scroll, or a move that is nothing yet.
+// The slop threshold is what separates a tap from a drag on a touch screen.
+const SLOP = 6;
+let gesture = null;
+let pointers = 0;
+video.addEventListener('pointerdown', (event) => {
+  // Capture keeps a drag alive when the finger leaves the picture. A synthetic
+  // event has no real pointer behind it, so a refusal here is not fatal.
+  pointers += 1;
+  try { video.setPointerCapture(event.pointerId); } catch { /* no real pointer */ }
+  if (pointers > 1) {
+    // A second finger makes this a scroll gesture; release anything the drag
+    // already pressed, and never turn the lift into a click.
+    if (gesture?.dragging) {
+      sendPointer('up', gesture.current.x, gesture.current.y, 1);
+    }
+    gesture = null;
+    return;
+  }
+  const at = point(event);
+  if (at === null) return;
+  gesture = { startX: event.clientX, startY: event.clientY, at, current: at, dragging: false, pointerId: event.pointerId };
+  sendPointer('move', at.x, at.y);
+});
+video.addEventListener('pointermove', (event) => {
+  if (gesture === null || gesture.pointerId !== event.pointerId) return;
+  const moved = Math.hypot(event.clientX - gesture.startX, event.clientY - gesture.startY);
+  if (!gesture.dragging && moved > SLOP) {
+    sendPointer('down', gesture.at.x, gesture.at.y, 1);
+    gesture.dragging = true;
+  }
+  const at = point(event);
+  if (gesture.dragging && at !== null) {
+    sendPointer('move', at.x, at.y, 1);
+    gesture.current = at;
+  }
+});
+for (const name of ['pointerup', 'pointercancel']) {
+  video.addEventListener(name, (event) => {
+    pointers = Math.max(0, pointers - 1);
+    if (gesture === null || gesture.pointerId !== event.pointerId) return;
+    const at = point(event);
+    if (gesture.dragging) {
+      if (at !== null) sendPointer('up', at.x, at.y, 1);
+      else sendPointer('cancel', gesture.at.x, gesture.at.y);
+    } else if (name === 'pointerup' && at !== null) {
+      // A tap is a click at the touched point: press and release on the same
+      // coordinates, so the desktop sees the click where the user aimed.
+      sendPointer('down', at.x, at.y, 1);
+      sendPointer('up', at.x, at.y, 1);
+    }
+    gesture = null;
+  });
+}
+video.addEventListener('wheel', (event) => {
+  event.preventDefault();
+  control({ kind: 'wheel', dx: 0, dy: Math.sign(event.deltaY) });
+}, { passive: false });
+// The hidden editor owns the platform keyboard; the committed text and the
+// named keys are what the desktop receives.
+let composing = false;
+keyboard.addEventListener('compositionstart', () => { composing = true; });
+keyboard.addEventListener('compositionend', (event) => {
+  composing = false;
+  if (event.data) control({ kind: 'text', text: event.data });
+  keyboard.value = '';
+});
+keyboard.addEventListener('beforeinput', (event) => {
+  if (composing || event.isComposing) return;
+  if (event.inputType === 'insertText' && event.data) {
+    event.preventDefault();
+    control({ kind: 'text', text: event.data });
+  } else if (event.inputType === 'deleteContentBackward') {
+    event.preventDefault();
+    control({ kind: 'key', name: 'Backspace', down: true });
+    control({ kind: 'key', name: 'Backspace', down: false });
+  } else if (event.inputType === 'insertLineBreak') {
+    event.preventDefault();
+    control({ kind: 'key', name: 'Enter', down: true });
+    control({ kind: 'key', name: 'Enter', down: false });
+  }
+});
+const named = {
+  Enter: 'Enter', Backspace: 'Backspace', Tab: 'Tab', Escape: 'Escape',
+  ArrowLeft: 'ArrowLeft', ArrowRight: 'ArrowRight', ArrowUp: 'ArrowUp', ArrowDown: 'ArrowDown',
+  Delete: 'Delete', Home: 'Home', End: 'End', PageUp: 'PageUp', PageDown: 'PageDown',
+  Control: 'Control', Shift: 'Shift', Alt: 'Alt', Meta: 'Meta',
+};
+keyboard.addEventListener('keydown', (event) => {
+  const name = named[event.key];
+  if (composing || name === undefined) return;
+  event.preventDefault();
+  control({ kind: 'key', name, down: true });
+});
+keyboard.addEventListener('keyup', (event) => {
+  const name = named[event.key];
+  if (composing || name === undefined) return;
+  event.preventDefault();
+  control({ kind: 'key', name, down: false });
+});
+document.getElementById('keyboard').addEventListener('click', () => {
+  keyboard.value = '';
+  keyboard.focus();
+});
+copy.addEventListener('click', async () => {
+  const id = crypto.randomUUID();
+  const answer = new Promise((resolve) => clipboardRequests.set(id, resolve));
+  control({ kind: 'clipboard_read', request: id });
+  const reply = await Promise.race([answer, new Promise((r) => setTimeout(() => r({ error: 'the desktop did not answer' }), 5000))]);
+  clipboardRequests.delete(id);
+  if (reply.error) { say(`Copy failed: ${reply.error}`); return; }
+  await navigator.clipboard.writeText(reply.text ?? '');
+  say('Copied from the desktop');
+});
+paste.addEventListener('click', async () => {
+  // Read the local clipboard inside the user gesture: a browser clipboard read
+  // outside one is refused, so it cannot happen after an await.
+  let text = '';
+  try {
+    text = await navigator.clipboard.readText();
+  } catch {
+    say('The browser would not read the clipboard; type the text instead');
+    return;
+  }
+  const id = crypto.randomUUID();
+  control({ kind: 'clipboard_write', request: id, text });
+  say('Sent to the desktop clipboard');
+});
+let opening = false;
+async function start() {
+  if (opening) return;
+  opening = true;
+  reconnect.disabled = true;
+  copy.hidden = true;
+  paste.hidden = true;
+  video.srcObject = null;
+  show(attempts === 0 ? 'Connecting…' : 'Reconnecting…');
+  say('Connecting…');
+  try {
+    const capabilities = await request('capabilities');
+    const clipboardAvailable = capabilities.clipboard?.read === true && capabilities.clipboard?.write === true;
+    const session = await request('session.open', {
+      permissions: clipboardAvailable ? ['view', 'control', 'clipboard'] : ['view', 'control'],
+      max_fps: 30,
+    });
+    copy.hidden = !clipboardAvailable;
+    paste.hidden = !clipboardAvailable;
+    surface = session.geometry.encoded;
+    // Reference-client diagnostics: enough to see the session from the console
+    // without a debugger. Not part of the protocol.
+    window.__session = session;
+    window.__request = request;
+    const pc = new RTCPeerConnection({ iceServers: [] });
+    peer = pc;
+    // Exposed for the page's own diagnostics: the only trustworthy answer to
+    // "is it really decoding" is the decoder's frame count, not a track event.
+    window.__peer = pc;
+    // The ENGINE creates the control channel, because it is the offerer. A
+    // client that creates its own channel with the same label gets a second,
+    // unrelated stream: its requests reach the engine, and every reply the
+    // engine sends lands on a channel the client never read. Taking the offered
+    // channel is what makes the session two-way.
+    pc.ondatachannel = (event) => {
+      channel = event.channel;
+      channel.onmessage = (event2) => {
+        const reply = JSON.parse(event2.data);
+        (window.__replies ??= []).push(reply);
+        handleReply(reply);
+      };
+    };
+    const handleReply = (reply) => {
+      if (reply.kind === 'hello') { surface = reply.geometry.encoded; return; }
+      if (reply.kind === 'revoked') { show(`Access ended: ${reply.reason}`); teardown(); return; }
+      if (reply.kind === 'clipboard') { clipboardRequests.get(reply.request)?.({ text: reply.text, error: reply.error }); return; }
+      if (reply.kind === 'rejected') say(`Refused: ${reply.code}`);
+    };
+    pc.ontrack = (event) => {
+      video.srcObject = event.streams[0];
+      hide();
+      attempts = 0;
+      // "Live" means a frame actually rendered. A track arriving, or ICE
+      // connecting, is not the same thing and would be a lie on a broken codec.
+      const firstFrame = () => {
+        say(`Live · ${video.videoWidth}x${video.videoHeight}`);
+      };
+      if (typeof video.requestVideoFrameCallback === 'function') {
+        video.requestVideoFrameCallback(firstFrame);
+      } else {
+        video.addEventListener('loadeddata', firstFrame, { once: true });
+      }
+    };
+    pc.onicecandidate = (event) => {
+      if (event.candidate === null) return;
+      void request('session.candidate', {
+        session_id: session.sessionId,
+        candidate: event.candidate.candidate,
+        sdp_mid: event.candidate.sdpMid,
+        sdp_m_line_index: event.candidate.sdpMLineIndex,
+      }).catch(() => undefined);
+    };
+    pc.onconnectionstatechange = () => {
+      if (pc !== peer) return;
+      say(`Live · ${pc.connectionState}`);
+      if (pc.connectionState === 'failed') { show('The connection was lost.'); teardown(); }
+    };
+    // The engine is the offerer, so this side waits for the offer and answers.
+    const offer = await waitForOffer();
+    await pc.setRemoteDescription({ type: 'offer', sdp: offer });
+    const answer = await pc.createAnswer();
+    await pc.setLocalDescription(answer);
+    await request('session.description', {
+      session_id: session.sessionId,
+      description: { type: 'answer', sdp: answer.sdp },
+    });
+    reconnect.disabled = false;
+    void pc;
+  } catch (error) {
+    show(`Could not open the desktop. ${error instanceof Error ? error.message : error}`);
+    say('Failed');
+    teardown();
+    reconnect.disabled = false;
+  } finally {
+    opening = false;
+  }
+}
+/**
+ * The offer arrives as a notification, and it can land before `session.open`
+ * resolves or after: the engine creates it while the open is still in flight, so
+ * both orders happen in practice. Keeping the last offer means neither order
+ * hangs.
+ */
+let offerWaiter = null;
+let offerSdp = null;
+function waitForOffer() {
+  if (offerSdp !== null) {
+    const ready = offerSdp;
+    offerSdp = null;
+    return Promise.resolve(ready);
+  }
+  return new Promise((resolve) => { offerWaiter = resolve; });
+}
+function teardown(message) {
+  peer?.close();
+  peer = null;
+  channel = null;
+  video.srcObject = null;
+  copy.hidden = true;
+  paste.hidden = true;
+  // A dead session must leave a visible state behind: clearing the video and
+  // saying nothing leaves a black rectangle that looks like a broken desktop
+  // rather than a lost connection.
+  if (typeof message === 'string') show(message);
+}
+function connectSocket() {
+  socket = new WebSocket(socketUrl);
+  socket.onmessage = (event) => {
+    const message = JSON.parse(event.data);
+    if (message.id !== undefined) {
+      const waiting = pending.get(message.id);
+      if (waiting === undefined) return;
+      pending.delete(message.id);
+      if (message.error) waiting.reject(new Error(`${message.error.code}: ${message.error.message}`));
+      else waiting.resolve(message.result);
+      return;
+    }
+    if (message.event === 'session.description') {
+      const sdp = message.params.description.sdp;
+      if (offerWaiter !== null) {
+        const resolve = offerWaiter;
+        offerWaiter = null;
+        resolve(sdp);
+      } else {
+        offerSdp = sdp;
+      }
+    }
+  };
+  socket.onclose = () => {
+    say('Disconnected');
+    teardown('Disconnected from the desktop host. Reconnect to continue.');
+  };
+  socket.onerror = () => {
+    say('The desktop host is unreachable');
+    teardown('The desktop host is unreachable. Reconnect to try again.');
+  };
+}
+reconnect.addEventListener('click', () => {
+  attempts += 1;
+  teardown();
+  socket?.close();
+  connectSocket();
+  socket.addEventListener('open', () => void start(), { once: true });
+});
+connectSocket();
+socket.addEventListener('open', () => { show('Connecting…'); void start(); }, { once: true });
+</script>
+</body>
+</html>

package/package.json ADDED Viewed

@@ -0,0 +1,38 @@
+{
+    "name": "@desklink/host",
+    "version": "0.1.0",
+    "license": "Apache-2.0",
+    "description": "Per-user, on-demand desktop capture, encode and input engine with a versioned local control protocol",
+    "type": "module",
+    "main": "./dist/index.js",
+    "types": "./dist/index.d.ts",
+    "bin": {
+        "desklink-host": "./bin/desklink-host.mjs"
+    },
+    "files": [
+        "bin",
+        "dist",
+        "engine/native",
+        "engine/build.rs",
+        "engine/Cargo.toml",
+        "engine/Cargo.lock",
+        "engine/src",
+        "engine/vendor",
+        "docs",
+        "examples",
+        "NOTICE",
+        "README.md"
+    ],
+    "scripts": {
+        "build": "tsc --build"
+    },
+    "engines": {
+        "node": ">=22"
+    },
+    "dependencies": {
+        "ws": "^8.18.0"
+    },
+    "optionalDependencies": {
+        "@desklink/host-linux-x64-gnu": "0.1.0"
+    }
+}