opentray 0.1.0 → 0.2.0

package/README.md

@@ -24,3 +24,40 @@ Run a protocol-only example that creates a surface, creates a tray, dispatches a
 ```bash
 pnpm --filter opentray example:basic
 ```
+
+Run the human-visible daemon tray example:
+
+```bash
+pnpm --filter opentray example:daemon-tray
+```
+
+After installing from npm, use the published CLI smoke path instead of workspace scripts:
+
+```bash
+opentray smoke daemon-tray
+```
+
+This example starts or reuses the same-version daemon automatically, creates a real tray through the public SDK, and prints broker-routed menu events. Use manual lifecycle commands only for operator/debug control:
+
+```bash
+pnpm --filter opentray cli -- daemon start
+pnpm --filter opentray cli -- daemon stop
+pnpm --filter opentray cli -- daemon restart
+```
+
+The menu includes `WebView Commands` entries that call the `@opentray/ext-webview` facade. On macOS, `Show HTML` loads the platform WebView dynamic library and opens a real native WebView window through daemon-owned UI capability; `Navigate`, `Post Message`, `Evaluate JS`, and `Hide` operate on that window.
+
+First-stage platform packages are published for macOS, Linux, and Windows. macOS is the current human-visual acceptance path. Linux and Windows artifacts are present for package topology validation, but unsupported broker/WebView capability must fail explicitly rather than pretending a visible UI exists.
+
+For local native smoke before npm publish, stage the current platform artifacts first:
+
+```bash
+cargo build -p opentray-bin -p opentray-ext-webview
+bun run scripts/binaries/stage-local.ts --kind daemon --source target/debug/opentray
+bun run scripts/binaries/stage-local.ts --kind webview --source target/debug/libopentray_ext_webview.dylib
+OPENTRAY_EXAMPLE_WEBVIEW_SMOKE=1 pnpm --filter opentray cli -- smoke daemon-tray
+```
+
+The daemon exits automatically after 30 seconds with no connected clients. Set `OPENTRAY_DAEMON_IDLE_TIMEOUT_MS=0` to keep it alive during debugging, or provide another millisecond value for a custom idle release window.
+
+Current native icon support is `rgba`. `encoded` and `file` are typed protocol shapes, but the native `tray-icon` backend reports them as unsupported until decoding and file loading policy are implemented.

package/dist/cli.d.mts

@@ -0,0 +1,18 @@
+import { DaemonHealth } from "@opentray/spec";
+
+//#region src/cli.d.ts
+type CliCommand = {
+  type: "daemon";
+  action: "start" | "stop" | "restart" | "health";
+} | {
+  type: "smoke";
+  name: "daemon-tray";
+} | {
+  type: "help";
+};
+declare const parseCliCommand: (argv: string[]) => CliCommand;
+declare const runCli: (argv: string[]) => Promise<number>;
+declare const formatDaemonHealthOutput: (health: DaemonHealth) => string;
+//#endregion
+export { formatDaemonHealthOutput, parseCliCommand, runCli };
+//# sourceMappingURL=cli.d.mts.map

package/dist/cli.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.mts","names":[],"sources":["../src/cli.ts"],"mappings":";;;KAcK,UAAA;EACC,IAAA;EAAgB,MAAA;AAAA;EAChB,IAAA;EAAe,IAAA;AAAA;EACf,IAAA;AAAA;AAAA,cAEO,eAAA,GAAmB,IAAA,eAAiB,UAahD;AAAA,cAEY,MAAA,GAAgB,IAAA,eAAiB,OAAO;AAAA,cA+ExC,wBAAA,GAA4B,MAAoB,EAAZ,YAAY"}

package/dist/cli.mjs

@@ -0,0 +1,474 @@
+#!/usr/bin/env node
+import { t as createClient } from "./client-BfXT-Zz9.mjs";
+import { a as inspectDaemon, c as stopDaemon, i as createNodeDaemonDriver, n as resolveDaemonPaths, o as restartDaemon, r as readPackageVersion, s as startDaemon, t as connectLocalBroker } from "./local-broker-CXOpd9Z8.mjs";
+import { homedir } from "node:os";
+import { fileURLToPath } from "node:url";
+//#region src/smoke/daemon-tray.ts
+const menuLabels = new Map([
+	[1, "Primary Action"],
+	[3, "Checked Capability"],
+	[4, "Radio: Active"],
+	[5, "Radio: Passive"],
+	[6, "Nested Action"],
+	[7, "Nested Check"],
+	[8, "WebView: Show HTML"],
+	[9, "WebView: Navigate"],
+	[10, "WebView: Post Message"],
+	[11, "WebView: Evaluate"],
+	[12, "WebView: Hide"],
+	[99, "Quit Demo"]
+]);
+const runDaemonTraySmoke = async () => {
+	const connection = await connectLocalBroker();
+	const client = createClient(connection, { requestIdPrefix: "daemon-smoke" });
+	console.log(`connected: endpoint=${connection.endpoint} lease=${connection.leaseId}`);
+	const surface = await client.createSurface({
+		appId: "com.example.opentray.daemon-smoke",
+		title: "OpenTray Daemon Smoke",
+		default: true
+	});
+	console.log(`surface: ${JSON.stringify(surface.surface)}`);
+	const tray = await surface.createTray({
+		trayId: "daemon-smoke-status",
+		title: "OpenTray",
+		tooltip: {
+			title: "OpenTray",
+			description: "npm-installed daemon smoke with broker-routed menu events"
+		},
+		icon: createVisibleIcon(),
+		menu: { items: [
+			{
+				type: "item",
+				id: 1,
+				title: "Primary Action"
+			},
+			{
+				type: "item",
+				id: 2,
+				title: "Disabled Action",
+				enabled: false
+			},
+			{
+				type: "check",
+				id: 3,
+				title: "Checked Capability",
+				checked: true
+			},
+			{
+				type: "radio",
+				id: 4,
+				title: "Radio: Active",
+				group: 1,
+				checked: true
+			},
+			{
+				type: "radio",
+				id: 5,
+				title: "Radio: Passive",
+				group: 1
+			},
+			{ type: "separator" },
+			{
+				type: "submenu",
+				title: "Nested Actions",
+				items: [{
+					type: "item",
+					id: 6,
+					title: "Nested Action"
+				}, {
+					type: "check",
+					id: 7,
+					title: "Nested Check",
+					checked: false
+				}]
+			},
+			{
+				type: "submenu",
+				title: "WebView Commands",
+				items: [
+					{
+						type: "item",
+						id: 8,
+						title: "Show HTML"
+					},
+					{
+						type: "item",
+						id: 9,
+						title: "Navigate"
+					},
+					{
+						type: "item",
+						id: 10,
+						title: "Post Message"
+					},
+					{
+						type: "item",
+						id: 11,
+						title: "Evaluate JS"
+					},
+					{
+						type: "item",
+						id: 12,
+						title: "Hide"
+					}
+				]
+			},
+			{ type: "separator" },
+			{
+				type: "item",
+				id: 99,
+				title: "Quit Demo"
+			}
+		] }
+	});
+	console.log(`tray: ${tray.trayId}`);
+	await connection.request({
+		type: "load-ext",
+		requestId: "daemon-smoke-load-webview",
+		surfaceId: surface.surface.surfaceId,
+		name: "webview",
+		path: "@opentray/ext-webview"
+	});
+	console.log("webview extension requested through the generic load-ext path");
+	console.log("open the system tray item and choose any enabled menu item to see routed events");
+	let closed = false;
+	let messageCount = 0;
+	let evalCount = 0;
+	let exitTimer;
+	const shutdown = async () => {
+		if (closed) return;
+		closed = true;
+		if (exitTimer !== void 0) clearTimeout(exitTimer);
+		await connection.close();
+	};
+	const commandWebview = async (command) => {
+		await tray.commandExtension("webview", command);
+	};
+	const handleMenuClick = async (itemId) => {
+		if (itemId === 99) {
+			console.log("quit item routed; closing smoke connection");
+			await shutdown();
+			return;
+		}
+		if (itemId < 8 || itemId > 12) return;
+		switch (itemId) {
+			case 8:
+				await commandWebview({
+					type: "show",
+					html: createWebviewDemoHtml(),
+					width: 420,
+					height: 260,
+					fallbackRect: {
+						x: 0,
+						y: 0,
+						width: 1,
+						height: 1
+					}
+				});
+				console.log("webview command: show");
+				break;
+			case 9:
+				await commandWebview({
+					type: "navigate",
+					url: "https://example.com/opentray-status"
+				});
+				console.log("webview command: navigate");
+				break;
+			case 10:
+				messageCount += 1;
+				await commandWebview({
+					type: "postMessage",
+					payload: {
+						kind: "ping",
+						source: "opentray smoke daemon-tray",
+						count: messageCount,
+						sentAt: (/* @__PURE__ */ new Date()).toISOString()
+					}
+				});
+				console.log("webview command: postMessage");
+				break;
+			case 11:
+				evalCount += 1;
+				await commandWebview({
+					type: "evaluate",
+					js: createVisibleEvaluateScript(evalCount)
+				});
+				console.log("webview command: evaluate");
+				break;
+			case 12:
+				await commandWebview({ type: "hide" });
+				console.log("webview command: hide");
+				break;
+		}
+	};
+	connection.onEvent((frame) => {
+		console.log(`broker -> client ${JSON.stringify(frame)}`);
+		if (frame.type === "event" && frame.event.type === "menuClick") {
+			console.log(`menu click: ${menuLabels.get(frame.event.itemId) ?? frame.event.itemId}`);
+			handleMenuClick(frame.event.itemId);
+		}
+	});
+	const exitAfter = process.env.OPENTRAY_EXAMPLE_EXIT_AFTER_MS;
+	if (exitAfter !== void 0 && exitAfter.length > 0) {
+		const duration = Number.parseInt(exitAfter, 10);
+		if (Number.isInteger(duration) && duration > 0) exitTimer = setTimeout(() => {
+			shutdown();
+		}, duration);
+	}
+	const webviewSmoke = process.env.OPENTRAY_EXAMPLE_WEBVIEW_SMOKE;
+	try {
+		if (webviewSmoke === "show") await handleMenuClick(8);
+		else if (webviewSmoke === "1") {
+			if (exitTimer !== void 0) {
+				clearTimeout(exitTimer);
+				exitTimer = void 0;
+			}
+			for (const itemId of [
+				8,
+				10,
+				11,
+				9,
+				12
+			]) await handleMenuClick(itemId);
+			await sleep(300);
+			await shutdown();
+		}
+	} catch (error) {
+		await shutdown();
+		throw error;
+	}
+};
+function createVisibleIcon() {
+	const width = 32;
+	const height = 32;
+	const data = [];
+	for (let y = 0; y < height; y += 1) for (let x = 0; x < width; x += 1) {
+		const dx = x - 15.5;
+		const dy = y - 15.5;
+		const distance = Math.sqrt(dx * dx + dy * dy);
+		const inRing = distance >= 9 && distance <= 14;
+		const inCore = distance <= 5;
+		const inNeedle = Math.abs(dx + dy) <= 1.2 && x >= 9 && x <= 23 && y >= 9 && y <= 23;
+		if (inRing || inCore || inNeedle) data.push(inCore ? 255 : 24, inNeedle ? 240 : 132, inRing ? 72 : 96, 255);
+		else data.push(0, 0, 0, 0);
+	}
+	return {
+		type: "rgba",
+		width,
+		height,
+		data
+	};
+}
+function createWebviewDemoHtml() {
+	return `<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <title>OpenTray WebView</title>
+    <style>
+      :root {
+        color: #18220f;
+        background: #f6edd8;
+        font: 15px ui-rounded, "SF Pro Rounded", "Avenir Next", sans-serif;
+      }
+      body {
+        margin: 0;
+      }
+      main {
+        min-height: 100vh;
+        box-sizing: border-box;
+        padding: 22px;
+        background:
+          radial-gradient(circle at 84% 10%, rgba(34, 132, 96, 0.22), transparent 34%),
+          linear-gradient(135deg, #fff8e7 0%, #e9f0d8 100%);
+      }
+      h1 {
+        margin: 0 0 8px;
+        font-size: 24px;
+        letter-spacing: -0.04em;
+      }
+      p {
+        margin: 0 0 16px;
+        color: #526044;
+      }
+      section {
+        display: grid;
+        gap: 10px;
+      }
+      .card {
+        border: 1px solid rgba(24, 34, 15, 0.16);
+        border-radius: 14px;
+        padding: 12px;
+        background: rgba(255, 255, 255, 0.72);
+        box-shadow: 0 12px 30px rgba(56, 72, 36, 0.12);
+      }
+      .label {
+        margin-bottom: 5px;
+        color: #7b5b1d;
+        font-size: 12px;
+        font-weight: 700;
+        letter-spacing: 0.08em;
+        text-transform: uppercase;
+      }
+      code {
+        word-break: break-word;
+      }
+    </style>
+  </head>
+  <body>
+    <main>
+      <h1>OpenTray WebView</h1>
+      <p>Use the tray menu to mutate this native WebView through extension commands.</p>
+      <section>
+        <div class="card">
+          <div class="label">postMessage</div>
+          <code id="message-status">Waiting for WebView Commands -> Post Message</code>
+        </div>
+        <div class="card">
+          <div class="label">evaluate JS</div>
+          <code id="eval-status">Waiting for WebView Commands -> Evaluate JS</code>
+        </div>
+      </section>
+    </main>
+    <script>
+      window.addEventListener("message", (event) => {
+        const target = document.getElementById("message-status");
+        if (target) {
+          target.textContent = JSON.stringify(event.data, null, 2);
+        }
+      });
+    <\/script>
+  </body>
+</html>`;
+}
+function createVisibleEvaluateScript(count) {
+	return `(() => {
+    let target = document.getElementById("eval-status");
+    if (!target) {
+      const panel = document.createElement("div");
+      panel.style.cssText = "position:fixed;left:16px;right:16px;bottom:16px;z-index:2147483647;padding:12px;border-radius:12px;background:#fff8e7;color:#18220f;box-shadow:0 12px 30px rgba(0,0,0,.18);font:14px ui-rounded, sans-serif;";
+      panel.textContent = "OpenTray Evaluate JS: ";
+      target = document.createElement("code");
+      target.id = "eval-status";
+      panel.appendChild(target);
+      document.body.appendChild(panel);
+    }
+    if (target) {
+      target.textContent = "Evaluate JS updated the WebView, count=${count}, at " + new Date().toLocaleTimeString();
+    }
+    window.__OPENTRAY_DEMO__ = { evaluated: true, count: ${count} };
+  })();`;
+}
+function sleep(ms) {
+	return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//#endregion
+//#region src/cli.ts
+const packageJsonUrl = new URL("../package.json", import.meta.url);
+const parseCliCommand = (argv) => {
+	const [group, action] = argv;
+	if (group !== "daemon") {
+		if (group === "smoke" && action === "daemon-tray") return {
+			type: "smoke",
+			name: "daemon-tray"
+		};
+		return { type: "help" };
+	}
+	if (action === "start" || action === "stop" || action === "restart" || action === "health") return {
+		type: "daemon",
+		action
+	};
+	return { type: "help" };
+};
+const runCli = async (argv) => {
+	const command = parseCliCommand(argv);
+	const packageVersion = process.env.OPENTRAY_DAEMON_PACKAGE_VERSION ?? await readPackageVersion(packageJsonUrl);
+	const paths = resolveDaemonPaths({
+		homeDir: process.env.OPENTRAY_HOME ?? homedir(),
+		packageVersion
+	});
+	if (command.type === "help") {
+		printHelp();
+		return 1;
+	}
+	if (command.type === "smoke") {
+		await runDaemonTraySmoke();
+		return 0;
+	}
+	const driver = createNodeDaemonDriver(fileURLToPath(import.meta.url));
+	if (command.action === "start") {
+		const result = await startDaemon({
+			paths,
+			driver
+		});
+		console.log(`opentray daemon ${result.status}: pid=${result.pid} endpoint=${result.paths.endpoint}`);
+		return 0;
+	}
+	if (command.action === "stop") {
+		const result = await stopDaemon({
+			paths,
+			driver
+		});
+		console.log(result.status === "stopped" ? `opentray daemon stopped: pid=${result.pid}` : "opentray daemon not running");
+		return 0;
+	}
+	if (command.action === "restart") {
+		const result = await restartDaemon({
+			paths,
+			driver
+		});
+		console.log(`opentray daemon ${result.status}: pid=${result.pid} endpoint=${result.paths.endpoint}`);
+		return 0;
+	}
+	if (command.action === "health") {
+		if ((await inspectDaemon({
+			paths,
+			driver
+		})).status === "not-running") {
+			console.log("opentray daemon not running");
+			return 0;
+		}
+		const connection = await connectLocalBroker({
+			autoStart: false,
+			endpoint: paths.endpoint,
+			homeDir: paths.homeDir,
+			packageVersion
+		});
+		try {
+			const response = await connection.request({
+				type: "health",
+				requestId: "opentray-daemon-health"
+			});
+			if (response.type !== "daemon-health") throw new Error(`expected daemon-health response, received ${response.type}`);
+			console.log(formatDaemonHealthOutput(response.health));
+		} finally {
+			await connection.close();
+		}
+		return 0;
+	}
+	printHelp();
+	return 1;
+};
+const printHelp = () => {
+	console.error("Usage: opentray daemon <start|stop|restart|health>");
+	console.error("       opentray smoke daemon-tray");
+};
+const formatDaemonHealthOutput = (health) => {
+	const lines = [
+		"opentray daemon running",
+		`pid: ${health.pid}`,
+		`endpoint: ${health.endpoint}`,
+		`packageVersion: ${health.packageVersion}`,
+		`protocolVersion: ${health.protocolVersion}`,
+		`sessions: ${health.sessionCount}`
+	];
+	for (const session of health.sessions) lines.push(`- sessionId=${session.sessionId} initialized=${session.initialized} leaseId=${session.leaseId ?? "(pending)"}`);
+	return lines.join("\n");
+};
+if (process.argv[1] === fileURLToPath(import.meta.url)) runCli(process.argv.slice(2)).then((code) => {
+	process.exitCode = code;
+});
+//#endregion
+export { formatDaemonHealthOutput, parseCliCommand, runCli };
+
+//# sourceMappingURL=cli.mjs.map

package/dist/cli.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.mjs","names":[],"sources":["../src/smoke/daemon-tray.ts","../src/cli.ts"],"sourcesContent":["import type { Rect } from \"@opentray/spec\";\n\nimport { createClient } from \"../client\";\nimport { connectLocalBroker } from \"../local-broker\";\n\nconst menuLabels = new Map<number, string>([\n  [1, \"Primary Action\"],\n  [3, \"Checked Capability\"],\n  [4, \"Radio: Active\"],\n  [5, \"Radio: Passive\"],\n  [6, \"Nested Action\"],\n  [7, \"Nested Check\"],\n  [8, \"WebView: Show HTML\"],\n  [9, \"WebView: Navigate\"],\n  [10, \"WebView: Post Message\"],\n  [11, \"WebView: Evaluate\"],\n  [12, \"WebView: Hide\"],\n  [99, \"Quit Demo\"],\n]);\n\ninterface WebviewShowCommand {\n  type: \"show\";\n  html?: string;\n  url?: string;\n  width?: number;\n  height?: number;\n  fallbackRect?: Rect;\n}\n\nexport const runDaemonTraySmoke = async (): Promise<void> => {\n  const connection = await connectLocalBroker();\n  const client = createClient(connection, { requestIdPrefix: \"daemon-smoke\" });\n  console.log(`connected: endpoint=${connection.endpoint} lease=${connection.leaseId}`);\n\n  const surface = await client.createSurface({\n    appId: \"com.example.opentray.daemon-smoke\",\n    title: \"OpenTray Daemon Smoke\",\n    default: true,\n  });\n  console.log(`surface: ${JSON.stringify(surface.surface)}`);\n\n  const tray = await surface.createTray({\n    trayId: \"daemon-smoke-status\",\n    title: \"OpenTray\",\n    tooltip: {\n      title: \"OpenTray\",\n      description: \"npm-installed daemon smoke with broker-routed menu events\",\n    },\n    icon: createVisibleIcon(),\n    menu: {\n      items: [\n        { type: \"item\", id: 1, title: \"Primary Action\" },\n        { type: \"item\", id: 2, title: \"Disabled Action\", enabled: false },\n        { type: \"check\", id: 3, title: \"Checked Capability\", checked: true },\n        { type: \"radio\", id: 4, title: \"Radio: Active\", group: 1, checked: true },\n        { type: \"radio\", id: 5, title: \"Radio: Passive\", group: 1 },\n        { type: \"separator\" },\n        {\n          type: \"submenu\",\n          title: \"Nested Actions\",\n          items: [\n            { type: \"item\", id: 6, title: \"Nested Action\" },\n            { type: \"check\", id: 7, title: \"Nested Check\", checked: false },\n          ],\n        },\n        {\n          type: \"submenu\",\n          title: \"WebView Commands\",\n          items: [\n            { type: \"item\", id: 8, title: \"Show HTML\" },\n            { type: \"item\", id: 9, title: \"Navigate\" },\n            { type: \"item\", id: 10, title: \"Post Message\" },\n            { type: \"item\", id: 11, title: \"Evaluate JS\" },\n            { type: \"item\", id: 12, title: \"Hide\" },\n          ],\n        },\n        { type: \"separator\" },\n        { type: \"item\", id: 99, title: \"Quit Demo\" },\n      ],\n    },\n  });\n  console.log(`tray: ${tray.trayId}`);\n\n  await connection.request({\n    type: \"load-ext\",\n    requestId: \"daemon-smoke-load-webview\",\n    surfaceId: surface.surface.surfaceId,\n    name: \"webview\",\n    path: \"@opentray/ext-webview\",\n  });\n  console.log(\"webview extension requested through the generic load-ext path\");\n  console.log(\"open the system tray item and choose any enabled menu item to see routed events\");\n\n  let closed = false;\n  let messageCount = 0;\n  let evalCount = 0;\n  let exitTimer: NodeJS.Timeout | undefined;\n\n  const shutdown = async (): Promise<void> => {\n    if (closed) {\n      return;\n    }\n    closed = true;\n    if (exitTimer !== undefined) {\n      clearTimeout(exitTimer);\n    }\n    await connection.close();\n  };\n\n  const commandWebview = async (command: WebviewShowCommand | Record<string, unknown>): Promise<void> => {\n    await tray.commandExtension(\"webview\", command);\n  };\n\n  const handleMenuClick = async (itemId: number): Promise<void> => {\n    if (itemId === 99) {\n      console.log(\"quit item routed; closing smoke connection\");\n      await shutdown();\n      return;\n    }\n\n    if (itemId < 8 || itemId > 12) {\n      return;\n    }\n\n    switch (itemId) {\n      case 8:\n        await commandWebview({\n          type: \"show\",\n          html: createWebviewDemoHtml(),\n          width: 420,\n          height: 260,\n          fallbackRect: { x: 0, y: 0, width: 1, height: 1 },\n        });\n        console.log(\"webview command: show\");\n        break;\n      case 9:\n        await commandWebview({ type: \"navigate\", url: \"https://example.com/opentray-status\" });\n        console.log(\"webview command: navigate\");\n        break;\n      case 10:\n        messageCount += 1;\n        await commandWebview({\n          type: \"postMessage\",\n          payload: {\n            kind: \"ping\",\n            source: \"opentray smoke daemon-tray\",\n            count: messageCount,\n            sentAt: new Date().toISOString(),\n          },\n        });\n        console.log(\"webview command: postMessage\");\n        break;\n      case 11:\n        evalCount += 1;\n        await commandWebview({ type: \"evaluate\", js: createVisibleEvaluateScript(evalCount) });\n        console.log(\"webview command: evaluate\");\n        break;\n      case 12:\n        await commandWebview({ type: \"hide\" });\n        console.log(\"webview command: hide\");\n        break;\n    }\n  };\n\n  connection.onEvent((frame) => {\n    console.log(`broker -> client ${JSON.stringify(frame)}`);\n    if (frame.type === \"event\" && frame.event.type === \"menuClick\") {\n      console.log(`menu click: ${menuLabels.get(frame.event.itemId) ?? frame.event.itemId}`);\n      void handleMenuClick(frame.event.itemId);\n    }\n  });\n\n  const exitAfter = process.env.OPENTRAY_EXAMPLE_EXIT_AFTER_MS;\n  if (exitAfter !== undefined && exitAfter.length > 0) {\n    const duration = Number.parseInt(exitAfter, 10);\n    if (Number.isInteger(duration) && duration > 0) {\n      exitTimer = setTimeout(() => {\n        void shutdown();\n      }, duration);\n    }\n  }\n\n  const webviewSmoke = process.env.OPENTRAY_EXAMPLE_WEBVIEW_SMOKE;\n  try {\n    if (webviewSmoke === \"show\") {\n      await handleMenuClick(8);\n    } else if (webviewSmoke === \"1\") {\n      if (exitTimer !== undefined) {\n        clearTimeout(exitTimer);\n        exitTimer = undefined;\n      }\n      for (const itemId of [8, 10, 11, 9, 12]) {\n        await handleMenuClick(itemId);\n      }\n      await sleep(300);\n      await shutdown();\n    }\n  } catch (error) {\n    await shutdown();\n    throw error;\n  }\n};\n\nfunction createVisibleIcon(): { type: \"rgba\"; width: number; height: number; data: number[] } {\n  const width = 32;\n  const height = 32;\n  const data: number[] = [];\n\n  for (let y = 0; y < height; y += 1) {\n    for (let x = 0; x < width; x += 1) {\n      const dx = x - 15.5;\n      const dy = y - 15.5;\n      const distance = Math.sqrt(dx * dx + dy * dy);\n      const inRing = distance >= 9 && distance <= 14;\n      const inCore = distance <= 5;\n      const inNeedle = Math.abs(dx + dy) <= 1.2 && x >= 9 && x <= 23 && y >= 9 && y <= 23;\n\n      if (inRing || inCore || inNeedle) {\n        data.push(inCore ? 255 : 24, inNeedle ? 240 : 132, inRing ? 72 : 96, 255);\n      } else {\n        data.push(0, 0, 0, 0);\n      }\n    }\n  }\n\n  return { type: \"rgba\", width, height, data };\n}\n\nfunction createWebviewDemoHtml(): string {\n  return `<!doctype html>\n<html lang=\"en\">\n  <head>\n    <meta charset=\"utf-8\" />\n    <title>OpenTray WebView</title>\n    <style>\n      :root {\n        color: #18220f;\n        background: #f6edd8;\n        font: 15px ui-rounded, \"SF Pro Rounded\", \"Avenir Next\", sans-serif;\n      }\n      body {\n        margin: 0;\n      }\n      main {\n        min-height: 100vh;\n        box-sizing: border-box;\n        padding: 22px;\n        background:\n          radial-gradient(circle at 84% 10%, rgba(34, 132, 96, 0.22), transparent 34%),\n          linear-gradient(135deg, #fff8e7 0%, #e9f0d8 100%);\n      }\n      h1 {\n        margin: 0 0 8px;\n        font-size: 24px;\n        letter-spacing: -0.04em;\n      }\n      p {\n        margin: 0 0 16px;\n        color: #526044;\n      }\n      section {\n        display: grid;\n        gap: 10px;\n      }\n      .card {\n        border: 1px solid rgba(24, 34, 15, 0.16);\n        border-radius: 14px;\n        padding: 12px;\n        background: rgba(255, 255, 255, 0.72);\n        box-shadow: 0 12px 30px rgba(56, 72, 36, 0.12);\n      }\n      .label {\n        margin-bottom: 5px;\n        color: #7b5b1d;\n        font-size: 12px;\n        font-weight: 700;\n        letter-spacing: 0.08em;\n        text-transform: uppercase;\n      }\n      code {\n        word-break: break-word;\n      }\n    </style>\n  </head>\n  <body>\n    <main>\n      <h1>OpenTray WebView</h1>\n      <p>Use the tray menu to mutate this native WebView through extension commands.</p>\n      <section>\n        <div class=\"card\">\n          <div class=\"label\">postMessage</div>\n          <code id=\"message-status\">Waiting for WebView Commands -> Post Message</code>\n        </div>\n        <div class=\"card\">\n          <div class=\"label\">evaluate JS</div>\n          <code id=\"eval-status\">Waiting for WebView Commands -> Evaluate JS</code>\n        </div>\n      </section>\n    </main>\n    <script>\n      window.addEventListener(\"message\", (event) => {\n        const target = document.getElementById(\"message-status\");\n        if (target) {\n          target.textContent = JSON.stringify(event.data, null, 2);\n        }\n      });\n    </script>\n  </body>\n</html>`;\n}\n\nfunction createVisibleEvaluateScript(count: number): string {\n  return `(() => {\n    let target = document.getElementById(\"eval-status\");\n    if (!target) {\n      const panel = document.createElement(\"div\");\n      panel.style.cssText = \"position:fixed;left:16px;right:16px;bottom:16px;z-index:2147483647;padding:12px;border-radius:12px;background:#fff8e7;color:#18220f;box-shadow:0 12px 30px rgba(0,0,0,.18);font:14px ui-rounded, sans-serif;\";\n      panel.textContent = \"OpenTray Evaluate JS: \";\n      target = document.createElement(\"code\");\n      target.id = \"eval-status\";\n      panel.appendChild(target);\n      document.body.appendChild(panel);\n    }\n    if (target) {\n      target.textContent = \"Evaluate JS updated the WebView, count=${count}, at \" + new Date().toLocaleTimeString();\n    }\n    window.__OPENTRAY_DEMO__ = { evaluated: true, count: ${count} };\n  })();`;\n}\n\nfunction sleep(ms: number): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, ms));\n}\n","#!/usr/bin/env node\nimport { fileURLToPath } from \"node:url\";\nimport { homedir } from \"node:os\";\n\nimport type { DaemonHealth } from \"@opentray/spec\";\n\nimport { createNodeDaemonDriver, inspectDaemon, restartDaemon, startDaemon, stopDaemon } from \"./daemon/lifecycle\";\nimport { readPackageVersion } from \"./daemon/package-version\";\nimport { resolveDaemonPaths } from \"./daemon/paths\";\nimport { connectLocalBroker } from \"./local-broker\";\nimport { runDaemonTraySmoke } from \"./smoke/daemon-tray\";\n\nconst packageJsonUrl = new URL(\"../package.json\", import.meta.url);\n\ntype CliCommand =\n  | { type: \"daemon\"; action: \"start\" | \"stop\" | \"restart\" | \"health\" }\n  | { type: \"smoke\"; name: \"daemon-tray\" }\n  | { type: \"help\" };\n\nexport const parseCliCommand = (argv: string[]): CliCommand => {\n  const [group, action] = argv;\n  if (group !== \"daemon\") {\n    if (group === \"smoke\" && action === \"daemon-tray\") {\n      return { type: \"smoke\", name: \"daemon-tray\" };\n    }\n    return { type: \"help\" };\n  }\n  if (action === \"start\" || action === \"stop\" || action === \"restart\" || action === \"health\") {\n    return { type: \"daemon\", action };\n  }\n\n  return { type: \"help\" };\n};\n\nexport const runCli = async (argv: string[]): Promise<number> => {\n  const command = parseCliCommand(argv);\n  const packageVersion = process.env.OPENTRAY_DAEMON_PACKAGE_VERSION ?? (await readPackageVersion(packageJsonUrl));\n  const paths = resolveDaemonPaths({\n    homeDir: process.env.OPENTRAY_HOME ?? homedir(),\n    packageVersion,\n  });\n\n  if (command.type === \"help\") {\n    printHelp();\n    return 1;\n  }\n\n  if (command.type === \"smoke\") {\n    await runDaemonTraySmoke();\n    return 0;\n  }\n\n  const driver = createNodeDaemonDriver(fileURLToPath(import.meta.url));\n\n  if (command.action === \"start\") {\n    const result = await startDaemon({ paths, driver });\n    console.log(`opentray daemon ${result.status}: pid=${result.pid} endpoint=${result.paths.endpoint}`);\n    return 0;\n  }\n\n  if (command.action === \"stop\") {\n    const result = await stopDaemon({ paths, driver });\n    console.log(\n      result.status === \"stopped\"\n        ? `opentray daemon stopped: pid=${result.pid}`\n        : \"opentray daemon not running\",\n    );\n    return 0;\n  }\n\n  if (command.action === \"restart\") {\n    const result = await restartDaemon({ paths, driver });\n    console.log(`opentray daemon ${result.status}: pid=${result.pid} endpoint=${result.paths.endpoint}`);\n    return 0;\n  }\n\n  if (command.action === \"health\") {\n    const inspected = await inspectDaemon({ paths, driver });\n    if (inspected.status === \"not-running\") {\n      console.log(\"opentray daemon not running\");\n      return 0;\n    }\n\n    const connection = await connectLocalBroker({\n      autoStart: false,\n      endpoint: paths.endpoint,\n      homeDir: paths.homeDir,\n      packageVersion,\n    });\n    try {\n      const response = await connection.request({\n        type: \"health\",\n        requestId: \"opentray-daemon-health\",\n      });\n      if (response.type !== \"daemon-health\") {\n        throw new Error(`expected daemon-health response, received ${response.type}`);\n      }\n      console.log(formatDaemonHealthOutput(response.health));\n    } finally {\n      await connection.close();\n    }\n    return 0;\n  }\n\n  printHelp();\n  return 1;\n};\n\nconst printHelp = (): void => {\n  console.error(\"Usage: opentray daemon <start|stop|restart|health>\");\n  console.error(\"       opentray smoke daemon-tray\");\n};\n\nexport const formatDaemonHealthOutput = (health: DaemonHealth): string => {\n  const lines = [\n    \"opentray daemon running\",\n    `pid: ${health.pid}`,\n    `endpoint: ${health.endpoint}`,\n    `packageVersion: ${health.packageVersion}`,\n    `protocolVersion: ${health.protocolVersion}`,\n    `sessions: ${health.sessionCount}`,\n  ];\n\n  for (const session of health.sessions) {\n    lines.push(\n      `- sessionId=${session.sessionId} initialized=${session.initialized} leaseId=${session.leaseId ?? \"(pending)\"}`,\n    );\n  }\n\n  return lines.join(\"\\n\");\n};\n\nif (process.argv[1] === fileURLToPath(import.meta.url)) {\n  runCli(process.argv.slice(2)).then((code) => {\n    process.exitCode = code;\n  });\n}\n"],"mappings":"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"}

package/dist/client-BfXT-Zz9.mjs

@@ -0,0 +1,86 @@
+import { PROTOCOL_VERSION } from "@opentray/spec";
+//#region src/client.ts
+const createInitFrame = (clientVersion) => ({
+	type: "init",
+	protocolVersion: PROTOCOL_VERSION,
+	clientVersion
+});
+const createClient = (transport, options = {}) => {
+	const nextRequestId = createRequestIdFactory(options.requestIdPrefix ?? "opentray");
+	return { async createSurface(surfaceOptions) {
+		const requestId = nextRequestId();
+		const surface = expectResponse(await transport.request({
+			type: "create-surface",
+			requestId,
+			...surfaceOptions
+		}), requestId, "surface-created").surface;
+		return createSurfaceHandle(transport, surface, nextRequestId);
+	} };
+};
+const createSurfaceHandle = (transport, surface, nextRequestId = createRequestIdFactory("opentray")) => ({
+	surface,
+	async createTray(options) {
+		const requestId = nextRequestId();
+		return createTrayHandle(transport, surface, expectResponse(await transport.request({
+			type: "create-tray",
+			requestId,
+			surface,
+			tray: options
+		}), requestId, "tray-created").trayId, nextRequestId);
+	}
+});
+const createTrayHandle = (transport, surface, trayId, nextRequestId = createRequestIdFactory("opentray")) => ({
+	surface,
+	trayId,
+	async commandExtension(ext, data) {
+		const requestId = nextRequestId();
+		expectResponse(await transport.request({
+			type: "ext-command",
+			requestId,
+			surfaceId: surface.surfaceId,
+			trayId,
+			ext,
+			data
+		}), requestId, "ack");
+	},
+	async destroy() {
+		const requestId = nextRequestId();
+		expectResponse(await transport.request({
+			type: "destroy-tray",
+			requestId,
+			surfaceId: surface.surfaceId,
+			trayId
+		}), requestId, "ack");
+	}
+});
+const createRequestIdFactory = (prefix) => {
+	let next = 1;
+	return () => {
+		const requestId = `${prefix}-${next}`;
+		next += 1;
+		return requestId;
+	};
+};
+const expectResponse = (frame, requestId, type) => {
+	if (frame.type === "error") throw new Error(`${frame.code}: ${frame.message}`);
+	if (frame.type !== type) throw new Error(`expected ${type} for ${requestId}, received ${frame.type}`);
+	if (requestIdOf(frame) !== requestId) throw new Error(`expected response for ${requestId}, received ${requestIdOf(frame) ?? "none"}`);
+	return frame;
+};
+const requestIdOf = (frame) => {
+	switch (frame.type) {
+		case "surface-created":
+		case "default-surface":
+		case "tray-created":
+		case "ack":
+		case "daemon-health": return frame.requestId;
+		case "error": return frame.requestId;
+		case "ready":
+		case "event":
+		case "ext-event": return;
+	}
+};
+//#endregion
+export { createTrayHandle as i, createInitFrame as n, createSurfaceHandle as r, createClient as t };
+
+//# sourceMappingURL=client-BfXT-Zz9.mjs.map

package/dist/client-BfXT-Zz9.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-BfXT-Zz9.mjs","names":[],"sources":["../src/client.ts"],"sourcesContent":["import {\n  PROTOCOL_VERSION,\n  type ClientFrame,\n  type ClientRequestFrame,\n  type RequestId,\n  type ServerFrame,\n  type SurfaceOptions,\n  type SurfaceRef,\n  type TrayId,\n  type TrayOptions,\n} from \"@opentray/spec\";\n\nexport interface OpenTrayTransport {\n  request(frame: ClientRequestFrame): Promise<ServerFrame>;\n}\n\nexport interface OpenTrayClient {\n  createSurface(options: SurfaceOptions): Promise<SurfaceHandle>;\n}\n\nexport interface SurfaceHandle {\n  surface: SurfaceRef;\n  createTray(options: TrayOptions): Promise<TrayHandle>;\n}\n\nexport interface TrayHandle {\n  surface: SurfaceRef;\n  trayId: TrayId;\n  commandExtension(ext: string, data: unknown): Promise<void>;\n  destroy(): Promise<void>;\n}\n\nexport const createInitFrame = (clientVersion: string): ClientFrame => ({\n  type: \"init\",\n  protocolVersion: PROTOCOL_VERSION,\n  clientVersion,\n});\n\nexport interface CreateClientOptions {\n  requestIdPrefix?: string;\n}\n\nexport const createClient = (\n  transport: OpenTrayTransport,\n  options: CreateClientOptions = {},\n): OpenTrayClient => {\n  const nextRequestId = createRequestIdFactory(options.requestIdPrefix ?? \"opentray\");\n\n  return {\n    async createSurface(surfaceOptions): Promise<SurfaceHandle> {\n      const requestId = nextRequestId();\n      const response = await transport.request({\n        type: \"create-surface\",\n        requestId,\n        ...surfaceOptions,\n      });\n      const surface = expectResponse(response, requestId, \"surface-created\").surface;\n      return createSurfaceHandle(transport, surface, nextRequestId);\n    },\n  };\n};\n\nexport const createSurfaceHandle = (\n  transport: OpenTrayTransport,\n  surface: SurfaceRef,\n  nextRequestId: () => RequestId = createRequestIdFactory(\"opentray\"),\n): SurfaceHandle => ({\n  surface,\n  async createTray(options: TrayOptions): Promise<TrayHandle> {\n    const requestId = nextRequestId();\n    const response = await transport.request({\n      type: \"create-tray\",\n      requestId,\n      surface,\n      tray: options,\n    });\n    const frame = expectResponse(response, requestId, \"tray-created\");\n    return createTrayHandle(transport, surface, frame.trayId, nextRequestId);\n  },\n});\n\nexport const createTrayHandle = (\n  transport: OpenTrayTransport,\n  surface: SurfaceRef,\n  trayId: TrayId,\n  nextRequestId: () => RequestId = createRequestIdFactory(\"opentray\"),\n): TrayHandle => ({\n  surface,\n  trayId,\n  async commandExtension(ext: string, data: unknown): Promise<void> {\n    const requestId = nextRequestId();\n    const response = await transport.request({\n      type: \"ext-command\",\n      requestId,\n      surfaceId: surface.surfaceId,\n      trayId,\n      ext,\n      data,\n    });\n    expectResponse(response, requestId, \"ack\");\n  },\n  async destroy(): Promise<void> {\n    const requestId = nextRequestId();\n    const response = await transport.request({\n      type: \"destroy-tray\",\n      requestId,\n      surfaceId: surface.surfaceId,\n      trayId,\n    });\n    expectResponse(response, requestId, \"ack\");\n  },\n});\n\nconst createRequestIdFactory = (prefix: string): (() => RequestId) => {\n  let next = 1;\n  return () => {\n    const requestId = `${prefix}-${next}`;\n    next += 1;\n    return requestId;\n  };\n};\n\nconst expectResponse = <TType extends ServerFrame[\"type\"]>(\n  frame: ServerFrame,\n  requestId: RequestId,\n  type: TType,\n): Extract<ServerFrame, { type: TType }> => {\n  if (frame.type === \"error\") {\n    throw new Error(`${frame.code}: ${frame.message}`);\n  }\n  if (frame.type !== type) {\n    throw new Error(`expected ${type} for ${requestId}, received ${frame.type}`);\n  }\n  if (requestIdOf(frame) !== requestId) {\n    throw new Error(`expected response for ${requestId}, received ${requestIdOf(frame) ?? \"none\"}`);\n  }\n  return frame as Extract<ServerFrame, { type: TType }>;\n};\n\nconst requestIdOf = (frame: ServerFrame): RequestId | undefined => {\n  switch (frame.type) {\n    case \"surface-created\":\n    case \"default-surface\":\n    case \"tray-created\":\n    case \"ack\":\n    case \"daemon-health\":\n      return frame.requestId;\n    case \"error\":\n      return frame.requestId;\n    case \"ready\":\n    case \"event\":\n    case \"ext-event\":\n      return undefined;\n  }\n};\n"],"mappings":";;AAgCA,MAAa,mBAAmB,mBAAwC;CACtE,MAAM;CACN,iBAAiB;CACjB;AACF;AAMA,MAAa,gBACX,WACA,UAA+B,CAAC,MACb;CACnB,MAAM,gBAAgB,uBAAuB,QAAQ,mBAAmB,UAAU;CAElF,OAAO,EACL,MAAM,cAAc,gBAAwC;EAC1D,MAAM,YAAY,cAAc;EAMhC,MAAM,UAAU,eAAe,MALR,UAAU,QAAQ;GACvC,MAAM;GACN;GACA,GAAG;EACL,CAAC,GACwC,WAAW,iBAAiB,EAAE;EACvE,OAAO,oBAAoB,WAAW,SAAS,aAAa;CAC9D,EACF;AACF;AAEA,MAAa,uBACX,WACA,SACA,gBAAiC,uBAAuB,UAAU,OAC/C;CACnB;CACA,MAAM,WAAW,SAA2C;EAC1D,MAAM,YAAY,cAAc;EAQhC,OAAO,iBAAiB,WAAW,SADrB,eAAe,MANN,UAAU,QAAQ;GACvC,MAAM;GACN;GACA;GACA,MAAM;EACR,CAAC,GACsC,WAAW,cACF,EAAE,QAAQ,aAAa;CACzE;AACF;AAEA,MAAa,oBACX,WACA,SACA,QACA,gBAAiC,uBAAuB,UAAU,OAClD;CAChB;CACA;CACA,MAAM,iBAAiB,KAAa,MAA8B;EAChE,MAAM,YAAY,cAAc;EAShC,eAAe,MARQ,UAAU,QAAQ;GACvC,MAAM;GACN;GACA,WAAW,QAAQ;GACnB;GACA;GACA;EACF,CAAC,GACwB,WAAW,KAAK;CAC3C;CACA,MAAM,UAAyB;EAC7B,MAAM,YAAY,cAAc;EAOhC,eAAe,MANQ,UAAU,QAAQ;GACvC,MAAM;GACN;GACA,WAAW,QAAQ;GACnB;EACF,CAAC,GACwB,WAAW,KAAK;CAC3C;AACF;AAEA,MAAM,0BAA0B,WAAsC;CACpE,IAAI,OAAO;CACX,aAAa;EACX,MAAM,YAAY,GAAG,OAAO,GAAG;EAC/B,QAAQ;EACR,OAAO;CACT;AACF;AAEA,MAAM,kBACJ,OACA,WACA,SAC0C;CAC1C,IAAI,MAAM,SAAS,SACjB,MAAM,IAAI,MAAM,GAAG,MAAM,KAAK,IAAI,MAAM,SAAS;CAEnD,IAAI,MAAM,SAAS,MACjB,MAAM,IAAI,MAAM,YAAY,KAAK,OAAO,UAAU,aAAa,MAAM,MAAM;CAE7E,IAAI,YAAY,KAAK,MAAM,WACzB,MAAM,IAAI,MAAM,yBAAyB,UAAU,aAAa,YAAY,KAAK,KAAK,QAAQ;CAEhG,OAAO;AACT;AAEA,MAAM,eAAe,UAA8C;CACjE,QAAQ,MAAM,MAAd;EACE,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK,iBACH,OAAO,MAAM;EACf,KAAK,SACH,OAAO,MAAM;EACf,KAAK;EACL,KAAK;EACL,KAAK,aACH;CACJ;AACF"}