opentray 0.10.0 → 0.10.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opentray",
-  "version": "0.10.0",
+  "version": "0.10.3",
   "description": "Developer-facing OpenTray SDK and CLI package.",
   "type": "module",
   "license": "MIT",
@@ -13,10 +13,6 @@
       "types": "./dist/index.d.mts",
       "import": "./dist/index.mjs"
     },
-    "./node": {
-      "types": "./dist/node.d.mts",
-      "import": "./dist/node.mjs"
-    },
     "./package.json": "./package.json"
   },
   "bin": {
@@ -28,7 +24,7 @@
   ],
   "sideEffects": false,
   "dependencies": {
-    "@opentray/spec": "0.10.0"
+    "@opentray/spec": "0.10.3"
   },
   "devDependencies": {
     "tsdown": "^0.22.1",
@@ -36,22 +32,21 @@
     "vitest": "^4.1.7"
   },
   "optionalDependencies": {
-    "@opentray/darwin-arm64": "0.10.0",
-    "@opentray/darwin-x64": "0.10.0",
-    "@opentray/linux-arm64": "0.10.0",
-    "@opentray/linux-x64": "0.10.0",
-    "@opentray/windows-arm64": "0.10.0",
-    "@opentray/windows-x64": "0.10.0"
+    "@opentray/darwin-arm64": "0.10.3",
+    "@opentray/darwin-x64": "0.10.3",
+    "@opentray/linux-arm64": "0.10.3",
+    "@opentray/linux-x64": "0.10.3",
+    "@opentray/windows-arm64": "0.10.3",
+    "@opentray/windows-x64": "0.10.3"
   },
   "scripts": {
-    "build": "tsdown src/index.ts src/node.ts src/cli.ts --format esm --dts",
+    "build": "tsdown src/index.ts src/cli.ts --format esm --dts",
     "cli": "bun run src/cli.ts",
     "example:matrix": "bun run examples/example-matrix.ts",
     "example:basic": "bun run examples/basic-tray.ts",
     "example:first-app": "bun run examples/first-app.ts",
     "example:debug-runtime-lynx": "bun run examples/debug-runtime-lynx.ts",
     "example:debug-runtime-tray": "bun run examples/debug-runtime-tray.ts",
-    "example:visible-binding": "node examples/visible-binding-host.mjs",
     "example:mediaQuery": "bun run examples/media-query-panel.ts",
     "example:badge": "bun run examples/badge-panel.ts",
     "example:placement": "bun run examples/placement-panel.ts",

package/dist/native-runtime-Cn8BaffH.d.mts

@@ -1,136 +0,0 @@
-import { ClientFrame, ClientRequestFrame, ExtensionEnvelope, Icon, Menu, RequestId, ServerFrame, Tooltip, TrayBoundsResult, TrayEvent, TrayId, TrayOptions } from "@opentray/spec";
-
-//#region src/client.d.ts
-interface OpenTrayTransport {
-  request(frame: ClientRequestFrame): Promise<ServerFrame>;
-}
-type OpenTrayEventFrame = Extract<ServerFrame, {
-  type: "event" | "ext-event";
-}>;
-interface OpenTrayEventSource {
-  onEvent(listener: (frame: OpenTrayEventFrame) => void): () => void;
-}
-interface OpenTrayConnection extends OpenTrayTransport, OpenTrayEventSource {}
-interface OpenTrayClient {
-  createTray(options: TrayOptions): Promise<TrayHandle>;
-}
-interface OpenTrayEventfulClient extends OpenTrayClient {
-  createTray(options: TrayOptions): Promise<EventfulTrayHandle>;
-}
-interface TrayHandle {
-  trayId: TrayId;
-  getBounds(): Promise<TrayBoundsResult>;
-  setMenu(menu: Menu): Promise<void>;
-  setTooltip(tooltip: Tooltip): Promise<void>;
-  setIcon(icon: Icon): Promise<void>;
-  loadExtension(options: ExtensionLoadOptions): Promise<void>;
-  commandExtension(ext: string, data: unknown): Promise<void>;
-  requestExtension(ext: string, data: unknown): Promise<ExtensionEnvelope[]>;
-  extend<TCapability extends object, TOptions = undefined>(extension: TrayExtension<TCapability, TOptions>, options?: TOptions): TrayHandle & TCapability;
-  destroy(): Promise<void>;
-}
-type TrayScopedEvent = Exclude<TrayEvent, {
-  type: "ready";
-}>;
-type TrayEventType = TrayScopedEvent["type"];
-type TrayEventByType<TEvent extends TrayEventType> = Extract<TrayScopedEvent, {
-  type: TEvent;
-}>;
-interface EventfulTrayHandle extends TrayHandle {
-  extend<TCapability extends object, TOptions = undefined>(extension: TrayExtension<TCapability, TOptions>, options?: TOptions): EventfulTrayHandle & TCapability;
-  listenExtension<TData = unknown>(ext: string, handler: (event: ExtensionEnvelope<TData>) => void): () => void;
-  listen<TEvent extends TrayEventType>(event: TEvent, handler: (event: TrayEventByType<TEvent>) => void): () => void;
-  onMenuClick(handler: (event: TrayEventByType<"menuClick">) => void): () => void;
-  onTrayClick(handler: (event: TrayEventByType<"trayClick">) => void): () => void;
-  onTrayDoubleClick(handler: (event: TrayEventByType<"trayDoubleClick">) => void): () => void;
-}
-interface ExtensionLoadOptions {
-  name: string;
-  path: string;
-  mountId?: string;
-}
-interface TrayExtensionMountSpec {
-  name?: string;
-  path?: string;
-  mountId?: string;
-}
-interface TrayExtensionContext {
-  readonly name: string;
-  readonly path: string;
-  readonly mountId: string;
-  ensureLoaded(): Promise<void>;
-  command(data: unknown): Promise<void>;
-  request(data: unknown): Promise<ExtensionEnvelope[]>;
-}
-interface TrayExtension<TCapability extends object, TOptions = undefined> {
-  readonly name: string;
-  readonly path: string;
-  resolveMount?(options: TOptions | undefined): TrayExtensionMountSpec;
-  extend(tray: TrayHandle, context: TrayExtensionContext, options: TOptions | undefined): TCapability;
-}
-declare const createInitFrame: (clientVersion: string) => ClientFrame;
-interface CreateClientOptions {
-  requestIdPrefix?: string;
-}
-declare function createClient(transport: OpenTrayConnection, options?: CreateClientOptions): OpenTrayEventfulClient;
-declare function createClient(transport: OpenTrayTransport, options?: CreateClientOptions): OpenTrayClient;
-declare function createTrayHandle(transport: OpenTrayConnection, appId: string, trayId: TrayId, nextRequestId?: () => RequestId): EventfulTrayHandle;
-declare function createTrayHandle(transport: OpenTrayTransport, appId: string, trayId: TrayId, nextRequestId?: () => RequestId): TrayHandle;
-//#endregion
-//#region src/native-runtime.d.ts
-interface OpenTrayRuntimeBindingInfo {
-  readonly kind: string;
-  readonly protocolVersion: number;
-}
-interface OpenTrayRuntimeBinding {
-  runtimeBindingInfo(): OpenTrayRuntimeBindingInfo;
-  runVisibleRuntimeHost?(options?: OpenTrayVisibleRuntimeHostOptions): void;
-  createVisibleRuntime?(): OpenTrayVisibleRuntime;
-  createHeadlessRuntime?(packageVersion?: string, appId?: string, appName?: string): OpenTrayHeadlessRuntime;
-}
-interface OpenTrayVisibleRuntimeHostOptions {
-  readonly packageVersion?: string;
-  readonly appId?: string;
-  readonly appName?: string;
-  readonly autoExitAfterMs?: number;
-}
-interface OpenTrayRuntimeHost {
-  request(frameJson: string): string[] | Promise<string[]>;
-  close(): string[] | Promise<string[]>;
-}
-interface OpenTrayVisibleRuntime extends OpenTrayRuntimeHost {
-  pollEvents(): string[] | Promise<string[]>;
-}
-type OpenTrayHeadlessRuntime = OpenTrayRuntimeHost;
-interface RuntimeNativeTarget {
-  readonly packageName: string;
-  readonly bindingRelativePath: string;
-}
-interface ResolveRuntimeBindingOptions {
-  readonly platform?: string;
-  readonly arch?: string;
-  readonly resolvePackageJson?: (packageName: string) => string | undefined;
-  readonly nativeLoader?: (bindingPath: string) => unknown;
-}
-declare const resolveRuntimeNativeTarget: (platform?: string, arch?: string) => RuntimeNativeTarget;
-declare const resolveInstalledRuntimeBindingPath: ({
-  platform,
-  arch,
-  resolvePackageJson
-}?: ResolveRuntimeBindingOptions) => Promise<string>;
-declare const loadOpenTrayRuntimeBinding: (options?: ResolveRuntimeBindingOptions) => Promise<OpenTrayRuntimeBinding>;
-declare class MissingPlatformRuntimeBindingError extends Error {
-  readonly code = "OPENTRAY_MISSING_PLATFORM_RUNTIME_BINDING";
-  readonly platform: string;
-  readonly arch: string;
-  readonly packageName: string | undefined;
-  readonly bindingPath: string | undefined;
-  constructor(message: string, platform: string, arch: string, options?: {
-    readonly packageName?: string;
-    readonly bindingPath?: string;
-    readonly cause?: unknown;
-  });
-}
-//#endregion
-export { TrayHandle as C, createTrayHandle as E, TrayExtensionMountSpec as S, createInitFrame as T, OpenTrayTransport as _, ResolveRuntimeBindingOptions as a, TrayExtension as b, resolveInstalledRuntimeBindingPath as c, EventfulTrayHandle as d, ExtensionLoadOptions as f, OpenTrayEventSource as g, OpenTrayEventFrame as h, OpenTrayVisibleRuntimeHostOptions as i, resolveRuntimeNativeTarget as l, OpenTrayConnection as m, OpenTrayRuntimeBinding as n, RuntimeNativeTarget as o, OpenTrayClient as p, OpenTrayRuntimeBindingInfo as r, loadOpenTrayRuntimeBinding as s, MissingPlatformRuntimeBindingError as t, CreateClientOptions as u, TrayEventByType as v, createClient as w, TrayExtensionContext as x, TrayEventType as y };
-//# sourceMappingURL=native-runtime-Cn8BaffH.d.mts.map

package/dist/native-runtime-Cn8BaffH.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"native-runtime-Cn8BaffH.d.mts","names":[],"sources":["../src/client.ts","../src/native-runtime.ts"],"mappings":"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"}

package/dist/node.d.mts

@@ -1,70 +0,0 @@
-import { a as ResolveRuntimeBindingOptions, c as resolveInstalledRuntimeBindingPath, d as EventfulTrayHandle, i as OpenTrayVisibleRuntimeHostOptions, l as resolveRuntimeNativeTarget, m as OpenTrayConnection, n as OpenTrayRuntimeBinding, o as RuntimeNativeTarget, r as OpenTrayRuntimeBindingInfo, s as loadOpenTrayRuntimeBinding, t as MissingPlatformRuntimeBindingError } from "./native-runtime-Cn8BaffH.mjs";
-import { TrayOptions } from "@opentray/spec";
-
-//#region src/runtime-binding-transport.d.ts
-type RuntimeBindingTransportKind = "visible" | "headless";
-interface CreateRuntimeBindingTransportOptions {
-  readonly kind?: RuntimeBindingTransportKind;
-  readonly binding?: OpenTrayRuntimeBinding;
-  readonly packageVersion?: string;
-  readonly clientVersion?: string;
-  readonly protocolVersion?: number;
-  readonly appId?: string;
-  readonly appName?: string;
-}
-declare const createRuntimeBindingTransport: ({
-  binding,
-  packageVersion,
-  clientVersion,
-  protocolVersion,
-  appId,
-  appName,
-  kind
-}?: CreateRuntimeBindingTransportOptions) => Promise<OpenTrayConnection>;
-//#endregion
-//#region src/node-host.d.ts
-/** Options for resolving the native binding and running the visible host loop. */
-interface RunVisibleRuntimeHostOptions extends ResolveRuntimeBindingOptions, OpenTrayVisibleRuntimeHostOptions {}
-/** Run the visible native host loop on the caller-owned Node main thread. */
-declare const runVisibleRuntimeHost: ({
-  platform,
-  arch,
-  resolvePackageJson,
-  nativeLoader,
-  ...hostOptions
-}?: RunVisibleRuntimeHostOptions) => Promise<void>;
-//#endregion
-//#region src/node-app.d.ts
-interface RunTrayAppOptions {
-  /** Runtime package version used for host state partitioning and diagnostics. */
-  readonly packageVersion?: string;
-  /** Client version reported to the runtime host handshake. */
-  readonly clientVersion?: string;
-  /** Protocol version reported to the runtime host handshake. */
-  readonly protocolVersion?: number;
-  /** App identity for diagnostics and runtime isolation. */
-  readonly appId?: string;
-  /** Human-readable app identity for diagnostics. */
-  readonly appName?: string;
-  /** Optional finite runtime window for examples and smoke tests. */
-  readonly autoExitAfterMs?: number;
-  /** Delay before the worker callback runs, giving the visible host time to boot. */
-  readonly startupDelayMs?: number;
-}
-interface TrayAppContext {
-  /** Create a tray in the app worker while the helper owns the visible host loop. */
-  createTray(options: TrayOptions): Promise<EventfulTrayHandle>;
-}
-/**
- * First-app entrypoint executed inside the app worker.
- *
- * Keep the callback self-contained. Imports needed by the callback should be
- * dynamic imports inside the callback because the helper runs it in a worker.
- */
-type TrayAppMain = (context: TrayAppContext) => void | Promise<void>;
-/** Run a self-contained tray app without exposing host-thread choreography. */
-declare const runTrayApp: (main: TrayAppMain, options?: RunTrayAppOptions) => Promise<void>;
-declare const createTrayAppWorkerSource: () => string;
-//#endregion
-export { type CreateRuntimeBindingTransportOptions, MissingPlatformRuntimeBindingError, type OpenTrayRuntimeBinding, type OpenTrayRuntimeBindingInfo, type OpenTrayVisibleRuntimeHostOptions, type ResolveRuntimeBindingOptions, type RunTrayAppOptions, type RunVisibleRuntimeHostOptions, type RuntimeNativeTarget, type TrayAppContext, type TrayAppMain, createRuntimeBindingTransport, createTrayAppWorkerSource, loadOpenTrayRuntimeBinding, resolveInstalledRuntimeBindingPath, resolveRuntimeNativeTarget, runTrayApp, runVisibleRuntimeHost };
-//# sourceMappingURL=node.d.mts.map

package/dist/node.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"node.d.mts","names":[],"sources":["../src/runtime-binding-transport.ts","../src/node-host.ts","../src/node-app.ts"],"mappings":";;;;KAgBY,2BAAA;AAAA,UAEK,oCAAA;EAAA,SACN,IAAA,GAAO,2BAAA;EAAA,SACP,OAAA,GAAU,sBAAsB;EAAA,SAChC,cAAA;EAAA,SACA,aAAA;EAAA,SACA,eAAA;EAAA,SACA,KAAA;EAAA,SACA,OAAA;AAAA;AAAA,cAGE,6BAAA;EAAuC,OAAA;EAAA,cAAA;EAAA,aAAA;EAAA,eAAA;EAAA,KAAA;EAAA,OAAA;EAAA;AAAA,IAQjD,oCAAA,KAA4C,OAAA,CAAQ,kBAAA;;;;UC7BtC,4BAAA,SACP,4BAAA,EACN,iCAAiC;ADOrC;AAAA,cCJa,qBAAA;EAA+B,QAAA;EAAA,IAAA;EAAA,kBAAA;EAAA,YAAA;EAAA,GAAA;AAAA,IAMzC,4BAAA,KAAoC,OAAA;;;UCZtB,iBAAA;;WAEN,cAAA;EFQ4B;EAAA,SEN5B,aAAA;EFM4B;EAAA,SEJ5B,eAAA;EFMM;EAAA,SEJN,KAAA;;WAEA,OAAA;EFGA;EAAA,SEDA,eAAA;EFEA;EAAA,SEAA,cAAA;AAAA;AAAA,UAGM,cAAA;EFAN;EEET,UAAA,CAAW,OAAA,EAAS,WAAA,GAAc,OAAA,CAAQ,kBAAA;AAAA;;AFA1B;AAGlB;;;;KEMY,WAAA,IAAe,OAAA,EAAS,cAAA,YAA0B,OAAO;;cAgBxD,UAAA,GACX,IAAA,EAAM,WAAA,EACN,OAAA,GAAS,iBAAA,KACR,OAAA;AAAA,cA8CU,yBAAA"}

package/dist/node.mjs

@@ -1,116 +0,0 @@
-import { a as resolveRuntimeNativeTarget, i as resolveInstalledRuntimeBindingPath, n as MissingPlatformRuntimeBindingError, r as loadOpenTrayRuntimeBinding, t as createRuntimeBindingTransport } from "./runtime-binding-transport-UPunusBT.mjs";
-import { Worker } from "node:worker_threads";
-//#region src/node-host.ts
-/** Run the visible native host loop on the caller-owned Node main thread. */
-const runVisibleRuntimeHost = async ({ platform, arch, resolvePackageJson, nativeLoader, ...hostOptions } = {}) => {
-	const binding = await loadOpenTrayRuntimeBinding({
-		...platform === void 0 ? {} : { platform },
-		...arch === void 0 ? {} : { arch },
-		...resolvePackageJson === void 0 ? {} : { resolvePackageJson },
-		...nativeLoader === void 0 ? {} : { nativeLoader }
-	});
-	if (binding.runVisibleRuntimeHost === void 0) throw new Error("OpenTray runtime binding does not expose runVisibleRuntimeHost()");
-	binding.runVisibleRuntimeHost(hostOptions);
-};
-//#endregion
-//#region src/node-app.ts
-/** Run a self-contained tray app without exposing host-thread choreography. */
-const runTrayApp = async (main, options = {}) => {
-	if (typeof main !== "function") throw new TypeError("main must be a function");
-	const worker = new Worker(createTrayAppWorkerSource(), {
-		eval: true,
-		workerData: {
-			mainSource: main.toString(),
-			sdkUrl: resolveWorkerSdkUrl(),
-			runtimeOptions: {
-				...options.packageVersion === void 0 ? {} : { packageVersion: options.packageVersion },
-				...options.clientVersion === void 0 ? {} : { clientVersion: options.clientVersion },
-				...options.protocolVersion === void 0 ? {} : { protocolVersion: options.protocolVersion },
-				...options.appId === void 0 ? {} : { appId: options.appId },
-				...options.appName === void 0 ? {} : { appName: options.appName }
-			},
-			startupDelayMs: normalizeDelay(options.startupDelayMs)
-		}
-	});
-	await waitForWorkerOnline(worker);
-	worker.postMessage("start");
-	try {
-		await runVisibleRuntimeHost({
-			...options.packageVersion === void 0 ? {} : { packageVersion: options.packageVersion },
-			...options.appId === void 0 ? {} : { appId: options.appId },
-			...options.appName === void 0 ? {} : { appName: options.appName },
-			...options.autoExitAfterMs === void 0 ? {} : { autoExitAfterMs: options.autoExitAfterMs }
-		});
-	} finally {
-		await worker.terminate();
-	}
-};
-const createTrayAppWorkerSource = () => `
-  const { parentPort, workerData } = require("node:worker_threads");
-
-  const delay = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
-  const isStartMessage = (value) => value === "start";
-
-  if (parentPort === null) {
-    throw new Error("OpenTray tray app worker requires a parent port");
-  }
-
-  import(workerData.sdkUrl)
-    .then(({ createTray: rawCreateTray }) => {
-      const createTray = (options) =>
-        rawCreateTray(options, workerData.runtimeOptions);
-      const main = eval("(" + workerData.mainSource + ")");
-
-      parentPort.postMessage("online");
-      parentPort.once("message", async (message) => {
-        if (!isStartMessage(message)) {
-          return;
-        }
-        if (workerData.startupDelayMs > 0) {
-          await delay(workerData.startupDelayMs);
-        }
-        await main({ createTray });
-        parentPort.postMessage("done");
-      });
-    })
-    .catch((error) => {
-      throw error;
-    });
-`;
-const normalizeDelay = (value) => {
-	if (value === void 0) return 250;
-	if (!Number.isFinite(value) || value < 0) throw new Error(`startupDelayMs must be a non-negative number: ${value}`);
-	return value;
-};
-const resolveWorkerSdkUrl = () => import.meta.url.endsWith(".mjs") ? new URL("./sdk.mjs", import.meta.url).href : new URL("./sdk.ts", import.meta.url).href;
-const waitForWorkerOnline = async (worker) => new Promise((resolve, reject) => {
-	const onMessage = (value) => {
-		if (value === "online") {
-			cleanup();
-			resolve();
-			return;
-		}
-	};
-	const onError = (error) => {
-		cleanup();
-		reject(error);
-	};
-	const onExit = (code) => {
-		if (code !== 0) {
-			cleanup();
-			reject(/* @__PURE__ */ new Error(`tray app worker exited with code ${code}`));
-		}
-	};
-	const cleanup = () => {
-		worker.off("message", onMessage);
-		worker.off("error", onError);
-		worker.off("exit", onExit);
-	};
-	worker.on("message", onMessage);
-	worker.on("error", onError);
-	worker.on("exit", onExit);
-});
-//#endregion
-export { MissingPlatformRuntimeBindingError, createRuntimeBindingTransport, createTrayAppWorkerSource, loadOpenTrayRuntimeBinding, resolveInstalledRuntimeBindingPath, resolveRuntimeNativeTarget, runTrayApp, runVisibleRuntimeHost };
-
-//# sourceMappingURL=node.mjs.map

package/dist/node.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"node.mjs","names":[],"sources":["../src/node-host.ts","../src/node-app.ts"],"sourcesContent":["import {\n  loadOpenTrayRuntimeBinding,\n  type OpenTrayVisibleRuntimeHostOptions,\n  type ResolveRuntimeBindingOptions,\n} from \"./native-runtime\";\n\n/** Options for resolving the native binding and running the visible host loop. */\nexport interface RunVisibleRuntimeHostOptions\n  extends ResolveRuntimeBindingOptions,\n    OpenTrayVisibleRuntimeHostOptions {}\n\n/** Run the visible native host loop on the caller-owned Node main thread. */\nexport const runVisibleRuntimeHost = async ({\n  platform,\n  arch,\n  resolvePackageJson,\n  nativeLoader,\n  ...hostOptions\n}: RunVisibleRuntimeHostOptions = {}): Promise<void> => {\n  const binding = await loadOpenTrayRuntimeBinding({\n    ...(platform === undefined ? {} : { platform }),\n    ...(arch === undefined ? {} : { arch }),\n    ...(resolvePackageJson === undefined ? {} : { resolvePackageJson }),\n    ...(nativeLoader === undefined ? {} : { nativeLoader }),\n  });\n  if (binding.runVisibleRuntimeHost === undefined) {\n    throw new Error(\n      \"OpenTray runtime binding does not expose runVisibleRuntimeHost()\"\n    );\n  }\n  binding.runVisibleRuntimeHost(hostOptions);\n};\n\nexport {\n  MissingPlatformRuntimeBindingError,\n  resolveInstalledRuntimeBindingPath,\n  resolveRuntimeNativeTarget,\n  loadOpenTrayRuntimeBinding,\n  type OpenTrayRuntimeBinding,\n  type OpenTrayRuntimeBindingInfo,\n  type OpenTrayVisibleRuntimeHostOptions,\n  type ResolveRuntimeBindingOptions,\n  type RuntimeNativeTarget,\n} from \"./native-runtime\";\nexport {\n  createRuntimeBindingTransport,\n  type CreateRuntimeBindingTransportOptions,\n} from \"./runtime-binding-transport\";\n","import { Worker } from \"node:worker_threads\";\n\nimport type { EventfulTrayHandle } from \"./client\";\nimport type { TrayOptions } from \"@opentray/spec\";\nimport { runVisibleRuntimeHost } from \"./node-host\";\n\nexport interface RunTrayAppOptions {\n  /** Runtime package version used for host state partitioning and diagnostics. */\n  readonly packageVersion?: string;\n  /** Client version reported to the runtime host handshake. */\n  readonly clientVersion?: string;\n  /** Protocol version reported to the runtime host handshake. */\n  readonly protocolVersion?: number;\n  /** App identity for diagnostics and runtime isolation. */\n  readonly appId?: string;\n  /** Human-readable app identity for diagnostics. */\n  readonly appName?: string;\n  /** Optional finite runtime window for examples and smoke tests. */\n  readonly autoExitAfterMs?: number;\n  /** Delay before the worker callback runs, giving the visible host time to boot. */\n  readonly startupDelayMs?: number;\n}\n\nexport interface TrayAppContext {\n  /** Create a tray in the app worker while the helper owns the visible host loop. */\n  createTray(options: TrayOptions): Promise<EventfulTrayHandle>;\n}\n\n/**\n * First-app entrypoint executed inside the app worker.\n *\n * Keep the callback self-contained. Imports needed by the callback should be\n * dynamic imports inside the callback because the helper runs it in a worker.\n */\nexport type TrayAppMain = (context: TrayAppContext) => void | Promise<void>;\n\ninterface RunTrayAppWorkerData {\n  readonly mainSource: string;\n  readonly sdkUrl: string;\n  readonly runtimeOptions: {\n    readonly packageVersion?: string;\n    readonly clientVersion?: string;\n    readonly protocolVersion?: number;\n    readonly appId?: string;\n    readonly appName?: string;\n  };\n  readonly startupDelayMs: number;\n}\n\n/** Run a self-contained tray app without exposing host-thread choreography. */\nexport const runTrayApp = async (\n  main: TrayAppMain,\n  options: RunTrayAppOptions = {}\n): Promise<void> => {\n  if (typeof main !== \"function\") {\n    throw new TypeError(\"main must be a function\");\n  }\n\n  const worker = new Worker(createTrayAppWorkerSource(), {\n    eval: true,\n    workerData: {\n      mainSource: main.toString(),\n      sdkUrl: resolveWorkerSdkUrl(),\n      runtimeOptions: {\n        ...(options.packageVersion === undefined\n          ? {}\n          : { packageVersion: options.packageVersion }),\n        ...(options.clientVersion === undefined\n          ? {}\n          : { clientVersion: options.clientVersion }),\n        ...(options.protocolVersion === undefined\n          ? {}\n          : { protocolVersion: options.protocolVersion }),\n        ...(options.appId === undefined ? {} : { appId: options.appId }),\n        ...(options.appName === undefined ? {} : { appName: options.appName }),\n      },\n      startupDelayMs: normalizeDelay(options.startupDelayMs),\n    } satisfies RunTrayAppWorkerData,\n  });\n\n  await waitForWorkerOnline(worker);\n  worker.postMessage(\"start\");\n\n  try {\n    await runVisibleRuntimeHost({\n      ...(options.packageVersion === undefined\n        ? {}\n        : { packageVersion: options.packageVersion }),\n      ...(options.appId === undefined ? {} : { appId: options.appId }),\n      ...(options.appName === undefined ? {} : { appName: options.appName }),\n      ...(options.autoExitAfterMs === undefined\n        ? {}\n        : { autoExitAfterMs: options.autoExitAfterMs }),\n    });\n  } finally {\n    await worker.terminate();\n  }\n}\n\nexport const createTrayAppWorkerSource = (): string => `\n  const { parentPort, workerData } = require(\"node:worker_threads\");\n\n  const delay = (ms) => new Promise((resolve) => setTimeout(resolve, ms));\n  const isStartMessage = (value) => value === \"start\";\n\n  if (parentPort === null) {\n    throw new Error(\"OpenTray tray app worker requires a parent port\");\n  }\n\n  import(workerData.sdkUrl)\n    .then(({ createTray: rawCreateTray }) => {\n      const createTray = (options) =>\n        rawCreateTray(options, workerData.runtimeOptions);\n      const main = eval(\"(\" + workerData.mainSource + \")\");\n\n      parentPort.postMessage(\"online\");\n      parentPort.once(\"message\", async (message) => {\n        if (!isStartMessage(message)) {\n          return;\n        }\n        if (workerData.startupDelayMs > 0) {\n          await delay(workerData.startupDelayMs);\n        }\n        await main({ createTray });\n        parentPort.postMessage(\"done\");\n      });\n    })\n    .catch((error) => {\n      throw error;\n    });\n`;\n\nconst normalizeDelay = (value: number | undefined): number => {\n  if (value === undefined) {\n    return 250;\n  }\n  if (!Number.isFinite(value) || value < 0) {\n    throw new Error(`startupDelayMs must be a non-negative number: ${value}`);\n  }\n  return value;\n};\n\nconst resolveWorkerSdkUrl = (): string =>\n  import.meta.url.endsWith(\".mjs\")\n    ? new URL(\"./sdk.mjs\", import.meta.url).href\n    : new URL(\"./sdk.ts\", import.meta.url).href;\n\nconst waitForWorkerOnline = async (worker: Worker): Promise<void> =>\n  new Promise((resolve, reject) => {\n    const onMessage = (value: unknown): void => {\n      if (value === \"online\") {\n        cleanup();\n        resolve();\n        return;\n      }\n    };\n    const onError = (error: Error): void => {\n      cleanup();\n      reject(error);\n    };\n    const onExit = (code: number): void => {\n      if (code !== 0) {\n        cleanup();\n        reject(new Error(`tray app worker exited with code ${code}`));\n      }\n    };\n    const cleanup = (): void => {\n      worker.off(\"message\", onMessage);\n      worker.off(\"error\", onError);\n      worker.off(\"exit\", onExit);\n    };\n\n    worker.on(\"message\", onMessage);\n    worker.on(\"error\", onError);\n    worker.on(\"exit\", onExit);\n  });\n"],"mappings":"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"}

package/dist/runtime-binding-transport-UPunusBT.mjs

@@ -1,177 +0,0 @@
-import { createRequire } from "node:module";
-import { PROTOCOL_VERSION, parseServerFrame } from "@opentray/spec";
-import { dirname, join } from "node:path";
-import { constants } from "node:fs";
-import { access } from "node:fs/promises";
-//#region src/native-runtime.ts
-const requireFromSource = createRequire(import.meta.url);
-const runtimeBindingRelativePath = "runtime/opentray_runtime.node";
-const resolveRuntimeNativeTarget = (platform = process.platform, arch = process.arch) => {
-	return {
-		packageName: `@opentray/${platformToPackageOs(platform)}-${normalizeArch(arch)}`,
-		bindingRelativePath: runtimeBindingRelativePath
-	};
-};
-const resolveInstalledRuntimeBindingPath = async ({ platform = process.platform, arch = process.arch, resolvePackageJson = resolvePackageJsonFromSource } = {}) => {
-	const target = resolveRuntimeNativeTarget(platform, arch);
-	const packageJsonPath = resolvePackageJson(target.packageName);
-	if (packageJsonPath === void 0) throw new MissingPlatformRuntimeBindingError(`unable to resolve OpenTray runtime binding for ${platform}/${arch}; install ${target.packageName}`, platform, arch, { packageName: target.packageName });
-	const bindingPath = join(dirname(packageJsonPath), target.bindingRelativePath);
-	if (!await exists(bindingPath)) throw new MissingPlatformRuntimeBindingError(`OpenTray runtime package ${target.packageName} is installed but missing ${target.bindingRelativePath}`, platform, arch, {
-		packageName: target.packageName,
-		bindingPath
-	});
-	return bindingPath;
-};
-const loadOpenTrayRuntimeBinding = async (options = {}) => {
-	const bindingPath = await resolveInstalledRuntimeBindingPath(options);
-	const loaded = (options.nativeLoader ?? loadNativeModule)(bindingPath);
-	if (!isRuntimeBinding(loaded)) throw new MissingPlatformRuntimeBindingError(`OpenTray runtime binding ${bindingPath} does not expose runtimeBindingInfo()`, options.platform ?? process.platform, options.arch ?? process.arch, { bindingPath });
-	return loaded;
-};
-const loadNativeModule = (bindingPath) => requireFromSource(bindingPath);
-const isRuntimeBinding = (value) => {
-	if (typeof value !== "object" || value === null || !("runtimeBindingInfo" in value)) return false;
-	return typeof value.runtimeBindingInfo === "function";
-};
-const platformToPackageOs = (platform) => {
-	switch (platform) {
-		case "darwin":
-		case "linux": return platform;
-		case "win32": return "windows";
-		default: throw new MissingPlatformRuntimeBindingError(`unsupported OpenTray runtime platform: ${platform}`, platform, process.arch);
-	}
-};
-const normalizeArch = (arch) => {
-	switch (arch) {
-		case "arm64":
-		case "x64": return arch;
-		default: throw new MissingPlatformRuntimeBindingError(`unsupported OpenTray runtime architecture: ${arch}`, process.platform, arch);
-	}
-};
-const resolvePackageJsonFromSource = (packageName) => {
-	try {
-		return requireFromSource.resolve(`${packageName}/package.json`);
-	} catch (error) {
-		if (isNodeError(error) && error.code === "MODULE_NOT_FOUND") return;
-		throw error;
-	}
-};
-const exists = async (path) => {
-	try {
-		await access(path, constants.F_OK);
-		return true;
-	} catch {
-		return false;
-	}
-};
-const isNodeError = (error) => error instanceof Error && "code" in error;
-var MissingPlatformRuntimeBindingError = class extends Error {
-	code = "OPENTRAY_MISSING_PLATFORM_RUNTIME_BINDING";
-	platform;
-	arch;
-	packageName;
-	bindingPath;
-	constructor(message, platform, arch, options = {}) {
-		super(message, options.cause === void 0 ? void 0 : { cause: options.cause });
-		this.name = "MissingPlatformRuntimeBindingError";
-		this.platform = platform;
-		this.arch = arch;
-		this.packageName = options.packageName;
-		this.bindingPath = options.bindingPath;
-	}
-};
-//#endregion
-//#region src/runtime-binding-transport.ts
-const createRuntimeBindingTransport = async ({ binding, packageVersion = "0.0.0", clientVersion = packageVersion, protocolVersion = PROTOCOL_VERSION, appId, appName, kind = "visible" } = {}) => {
-	const resolvedBinding = binding ?? await loadOpenTrayRuntimeBinding();
-	const transport = new RuntimeBindingTransport(kind === "headless" ? createHeadlessRuntime(resolvedBinding, packageVersion, appId, appName) : createVisibleRuntime(resolvedBinding));
-	await transport.init(clientVersion, protocolVersion);
-	return transport;
-};
-const createVisibleRuntime = (binding) => {
-	if (binding.createVisibleRuntime === void 0) throw new Error("OpenTray runtime binding does not expose createVisibleRuntime()");
-	return binding.createVisibleRuntime();
-};
-const createHeadlessRuntime = (binding, packageVersion, appId, appName) => {
-	if (binding.createHeadlessRuntime === void 0) throw new Error("OpenTray runtime binding does not expose createHeadlessRuntime()");
-	return binding.createHeadlessRuntime(packageVersion, appId, appName);
-};
-var RuntimeBindingTransport = class {
-	listeners = /* @__PURE__ */ new Set();
-	runtime;
-	pollInterval;
-	constructor(runtime) {
-		this.runtime = runtime;
-		this.pollInterval = runtime.pollEvents === void 0 ? void 0 : setInterval(() => {
-			this.pollRuntimeEvents().catch(() => {});
-		}, 50);
-		this.pollInterval?.unref();
-	}
-	async init(clientVersion, protocolVersion) {
-		if ((await this.invoke({
-			type: "init",
-			protocolVersion,
-			clientVersion
-		})).find((frame) => frame.type === "ready") === void 0) throw new Error("OpenTray runtime binding did not return a ready frame");
-	}
-	async request(frame) {
-		const response = (await this.invoke(frame)).find((candidate) => responseRequestId(candidate) === frame.requestId);
-		if (response === void 0) throw new Error(`OpenTray runtime binding did not return response for requestId: ${frame.requestId}`);
-		return response;
-	}
-	onEvent(listener) {
-		this.listeners.add(listener);
-		return () => {
-			this.listeners.delete(listener);
-		};
-	}
-	async close() {
-		if (this.pollInterval !== void 0) clearInterval(this.pollInterval);
-		const frames = await this.parseFrames(await this.runtime.close());
-		this.dispatchEvents(frames);
-	}
-	async invoke(frame) {
-		const frames = await this.parseFrames(await this.runtime.request(JSON.stringify(frame)));
-		this.dispatchEvents(frames);
-		return frames;
-	}
-	async parseFrames(frameJson) {
-		return (await frameJson).map((raw) => {
-			const parsed = parseServerFrame(raw);
-			if (!parsed.ok || parsed.frame === void 0) throw new Error(`${parsed.error ?? "invalid server frame"}: ${raw}`);
-			return parsed.frame;
-		});
-	}
-	dispatchEvents(frames) {
-		for (const frame of frames) {
-			if (frame.type !== "event" && frame.type !== "ext-event") continue;
-			for (const listener of this.listeners) listener(frame);
-		}
-	}
-	async pollRuntimeEvents() {
-		const pollEvents = this.runtime.pollEvents;
-		if (pollEvents === void 0) return;
-		const frames = await this.parseFrames(await pollEvents.call(this.runtime));
-		this.dispatchEvents(frames);
-	}
-};
-const responseRequestId = (frame) => {
-	switch (frame.type) {
-		case "app-created":
-		case "default-app":
-		case "tray-created":
-		case "tray-bounds":
-		case "ack":
-		case "ext-command-result":
-		case "runtime-host-health": return frame.requestId;
-		case "ready":
-		case "event":
-		case "ext-event":
-		case "error": return;
-	}
-};
-//#endregion
-export { resolveRuntimeNativeTarget as a, resolveInstalledRuntimeBindingPath as i, MissingPlatformRuntimeBindingError as n, loadOpenTrayRuntimeBinding as r, createRuntimeBindingTransport as t };
-
-//# sourceMappingURL=runtime-binding-transport-UPunusBT.mjs.map

package/dist/runtime-binding-transport-UPunusBT.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"runtime-binding-transport-UPunusBT.mjs","names":["binding"],"sources":["../src/native-runtime.ts","../src/runtime-binding-transport.ts"],"sourcesContent":["import { access } from \"node:fs/promises\";\nimport { constants } from \"node:fs\";\nimport { createRequire } from \"node:module\";\nimport { dirname, join } from \"node:path\";\n\nconst requireFromSource = createRequire(import.meta.url);\n\nexport interface OpenTrayRuntimeBindingInfo {\n  readonly kind: string;\n  readonly protocolVersion: number;\n}\n\nexport interface OpenTrayRuntimeBinding {\n  runtimeBindingInfo(): OpenTrayRuntimeBindingInfo;\n  runVisibleRuntimeHost?(options?: OpenTrayVisibleRuntimeHostOptions): void;\n  createVisibleRuntime?(): OpenTrayVisibleRuntime;\n  createHeadlessRuntime?(\n    packageVersion?: string,\n    appId?: string,\n    appName?: string\n  ): OpenTrayHeadlessRuntime;\n}\n\nexport interface OpenTrayVisibleRuntimeHostOptions {\n  readonly packageVersion?: string;\n  readonly appId?: string;\n  readonly appName?: string;\n  readonly autoExitAfterMs?: number;\n}\n\nexport interface OpenTrayRuntimeHost {\n  request(frameJson: string): string[] | Promise<string[]>;\n  close(): string[] | Promise<string[]>;\n}\n\nexport interface OpenTrayVisibleRuntime extends OpenTrayRuntimeHost {\n  pollEvents(): string[] | Promise<string[]>;\n}\n\nexport type OpenTrayHeadlessRuntime = OpenTrayRuntimeHost;\n\nexport interface RuntimeNativeTarget {\n  readonly packageName: string;\n  readonly bindingRelativePath: string;\n}\n\nexport interface ResolveRuntimeBindingOptions {\n  readonly platform?: string;\n  readonly arch?: string;\n  readonly resolvePackageJson?: (packageName: string) => string | undefined;\n  readonly nativeLoader?: (bindingPath: string) => unknown;\n}\n\nexport const runtimeBindingRelativePath = \"runtime/opentray_runtime.node\";\n\nexport const resolveRuntimeNativeTarget = (\n  platform: string = process.platform,\n  arch: string = process.arch\n): RuntimeNativeTarget => {\n  const packageOs = platformToPackageOs(platform);\n  const nativeArch = normalizeArch(arch);\n  return {\n    packageName: `@opentray/${packageOs}-${nativeArch}`,\n    bindingRelativePath: runtimeBindingRelativePath,\n  };\n};\n\nexport const resolveInstalledRuntimeBindingPath = async ({\n  platform = process.platform,\n  arch = process.arch,\n  resolvePackageJson = resolvePackageJsonFromSource,\n}: ResolveRuntimeBindingOptions = {}): Promise<string> => {\n  const target = resolveRuntimeNativeTarget(platform, arch);\n  const packageJsonPath = resolvePackageJson(target.packageName);\n  if (packageJsonPath === undefined) {\n    throw new MissingPlatformRuntimeBindingError(\n      `unable to resolve OpenTray runtime binding for ${platform}/${arch}; install ${target.packageName}`,\n      platform,\n      arch,\n      { packageName: target.packageName }\n    );\n  }\n\n  const bindingPath = join(\n    dirname(packageJsonPath),\n    target.bindingRelativePath\n  );\n  if (!(await exists(bindingPath))) {\n    throw new MissingPlatformRuntimeBindingError(\n      `OpenTray runtime package ${target.packageName} is installed but missing ${target.bindingRelativePath}`,\n      platform,\n      arch,\n      {\n        packageName: target.packageName,\n        bindingPath,\n      }\n    );\n  }\n  return bindingPath;\n};\n\nexport const loadOpenTrayRuntimeBinding = async (\n  options: ResolveRuntimeBindingOptions = {}\n): Promise<OpenTrayRuntimeBinding> => {\n  const bindingPath = await resolveInstalledRuntimeBindingPath(options);\n  const loaded = (options.nativeLoader ?? loadNativeModule)(bindingPath);\n  if (!isRuntimeBinding(loaded)) {\n    throw new MissingPlatformRuntimeBindingError(\n      `OpenTray runtime binding ${bindingPath} does not expose runtimeBindingInfo()`,\n      options.platform ?? process.platform,\n      options.arch ?? process.arch,\n      { bindingPath }\n    );\n  }\n  return loaded;\n};\n\nconst loadNativeModule = (bindingPath: string): unknown =>\n  requireFromSource(bindingPath);\n\nconst isRuntimeBinding = (value: unknown): value is OpenTrayRuntimeBinding => {\n  if (\n    typeof value !== \"object\" ||\n    value === null ||\n    !(\"runtimeBindingInfo\" in value)\n  ) {\n    return false;\n  }\n  const binding = value as { runtimeBindingInfo?: unknown };\n  return typeof binding.runtimeBindingInfo === \"function\";\n};\n\nconst platformToPackageOs = (\n  platform: string\n): \"darwin\" | \"linux\" | \"windows\" => {\n  switch (platform) {\n    case \"darwin\":\n    case \"linux\":\n      return platform;\n    case \"win32\":\n      return \"windows\";\n    default:\n      throw new MissingPlatformRuntimeBindingError(\n        `unsupported OpenTray runtime platform: ${platform}`,\n        platform,\n        process.arch\n      );\n  }\n};\n\nconst normalizeArch = (arch: string): \"arm64\" | \"x64\" => {\n  switch (arch) {\n    case \"arm64\":\n    case \"x64\":\n      return arch;\n    default:\n      throw new MissingPlatformRuntimeBindingError(\n        `unsupported OpenTray runtime architecture: ${arch}`,\n        process.platform,\n        arch\n      );\n  }\n};\n\nconst resolvePackageJsonFromSource = (\n  packageName: string\n): string | undefined => {\n  try {\n    return requireFromSource.resolve(`${packageName}/package.json`);\n  } catch (error) {\n    if (isNodeError(error) && error.code === \"MODULE_NOT_FOUND\") {\n      return undefined;\n    }\n    throw error;\n  }\n};\n\nconst exists = async (path: string): Promise<boolean> => {\n  try {\n    await access(path, constants.F_OK);\n    return true;\n  } catch {\n    return false;\n  }\n};\n\nconst isNodeError = (error: unknown): error is NodeJS.ErrnoException =>\n  error instanceof Error && \"code\" in error;\n\nexport class MissingPlatformRuntimeBindingError extends Error {\n  readonly code = \"OPENTRAY_MISSING_PLATFORM_RUNTIME_BINDING\";\n  readonly platform: string;\n  readonly arch: string;\n  readonly packageName: string | undefined;\n  readonly bindingPath: string | undefined;\n\n  constructor(\n    message: string,\n    platform: string,\n    arch: string,\n    options: {\n      readonly packageName?: string;\n      readonly bindingPath?: string;\n      readonly cause?: unknown;\n    } = {}\n  ) {\n    super(\n      message,\n      options.cause === undefined ? undefined : { cause: options.cause }\n    );\n    this.name = \"MissingPlatformRuntimeBindingError\";\n    this.platform = platform;\n    this.arch = arch;\n    this.packageName = options.packageName;\n    this.bindingPath = options.bindingPath;\n  }\n}\n","import {\n  PROTOCOL_VERSION,\n  parseServerFrame,\n  type ClientRequestFrame,\n  type RequestId,\n  type ServerFrame,\n} from \"@opentray/spec\";\n\nimport type { OpenTrayConnection, OpenTrayEventFrame } from \"./client\";\nimport {\n  loadOpenTrayRuntimeBinding,\n  type OpenTrayRuntimeHost,\n  type OpenTrayRuntimeBinding,\n  type OpenTrayVisibleRuntime,\n} from \"./native-runtime\";\n\nexport type RuntimeBindingTransportKind = \"visible\" | \"headless\";\n\nexport interface CreateRuntimeBindingTransportOptions {\n  readonly kind?: RuntimeBindingTransportKind;\n  readonly binding?: OpenTrayRuntimeBinding;\n  readonly packageVersion?: string;\n  readonly clientVersion?: string;\n  readonly protocolVersion?: number;\n  readonly appId?: string;\n  readonly appName?: string;\n}\n\nexport const createRuntimeBindingTransport = async ({\n  binding,\n  packageVersion = \"0.0.0\",\n  clientVersion = packageVersion,\n  protocolVersion = PROTOCOL_VERSION,\n  appId,\n  appName,\n  kind = \"visible\",\n}: CreateRuntimeBindingTransportOptions = {}): Promise<OpenTrayConnection> => {\n  const resolvedBinding = binding ?? (await loadOpenTrayRuntimeBinding());\n  const runtime =\n    kind === \"headless\"\n      ? createHeadlessRuntime(resolvedBinding, packageVersion, appId, appName)\n      : createVisibleRuntime(resolvedBinding);\n  const transport = new RuntimeBindingTransport(runtime);\n  await transport.init(clientVersion, protocolVersion);\n  return transport;\n};\n\nconst createVisibleRuntime = (\n  binding: OpenTrayRuntimeBinding\n): OpenTrayVisibleRuntime => {\n  if (binding.createVisibleRuntime === undefined) {\n    throw new Error(\n      \"OpenTray runtime binding does not expose createVisibleRuntime()\"\n    );\n  }\n  return binding.createVisibleRuntime();\n};\n\nconst createHeadlessRuntime = (\n  binding: OpenTrayRuntimeBinding,\n  packageVersion: string,\n  appId: string | undefined,\n  appName: string | undefined\n): OpenTrayRuntimeHost => {\n  if (binding.createHeadlessRuntime === undefined) {\n    throw new Error(\n      \"OpenTray runtime binding does not expose createHeadlessRuntime()\"\n    );\n  }\n  return binding.createHeadlessRuntime(packageVersion, appId, appName);\n};\n\ntype RuntimeFrameInvoker = (frameJson: string) => string[] | Promise<string[]>;\n\ninterface RuntimeBindingHost extends OpenTrayRuntimeHost {\n  request: RuntimeFrameInvoker;\n  pollEvents?(): string[] | Promise<string[]>;\n}\n\nclass RuntimeBindingTransport implements OpenTrayConnection {\n  private readonly listeners = new Set<(frame: OpenTrayEventFrame) => void>();\n  private readonly runtime: RuntimeBindingHost;\n  private readonly pollInterval: NodeJS.Timeout | undefined;\n\n  constructor(runtime: RuntimeBindingHost) {\n    this.runtime = runtime;\n    this.pollInterval =\n      runtime.pollEvents === undefined\n        ? undefined\n        : setInterval(() => {\n            void this.pollRuntimeEvents().catch(() => {\n              // Polling is an event ingress path. Request and close failures still surface to callers.\n            });\n          }, 50);\n    this.pollInterval?.unref();\n  }\n\n  async init(clientVersion: string, protocolVersion: number): Promise<void> {\n    const frames = await this.invoke({\n      type: \"init\",\n      protocolVersion,\n      clientVersion,\n    });\n    const ready = frames.find(\n      (frame): frame is Extract<ServerFrame, { type: \"ready\" }> =>\n        frame.type === \"ready\"\n    );\n    if (ready === undefined) {\n      throw new Error(\"OpenTray runtime binding did not return a ready frame\");\n    }\n  }\n\n  async request(frame: ClientRequestFrame): Promise<ServerFrame> {\n    const frames = await this.invoke(frame);\n    const response = frames.find(\n      (candidate) => responseRequestId(candidate) === frame.requestId\n    );\n    if (response === undefined) {\n      throw new Error(\n        `OpenTray runtime binding did not return response for requestId: ${frame.requestId}`\n      );\n    }\n    return response;\n  }\n\n  onEvent(listener: (frame: OpenTrayEventFrame) => void): () => void {\n    this.listeners.add(listener);\n    return () => {\n      this.listeners.delete(listener);\n    };\n  }\n\n  async close(): Promise<void> {\n    if (this.pollInterval !== undefined) {\n      clearInterval(this.pollInterval);\n    }\n    const frames = await this.parseFrames(await this.runtime.close());\n    this.dispatchEvents(frames);\n  }\n\n  private async invoke(frame: object): Promise<ServerFrame[]> {\n    const frames = await this.parseFrames(\n      await this.runtime.request(JSON.stringify(frame))\n    );\n    this.dispatchEvents(frames);\n    return frames;\n  }\n\n  private async parseFrames(\n    frameJson: string[] | Promise<string[]>\n  ): Promise<ServerFrame[]> {\n    const rawFrames = await frameJson;\n    return rawFrames.map((raw) => {\n      const parsed = parseServerFrame(raw);\n      if (!parsed.ok || parsed.frame === undefined) {\n        throw new Error(`${parsed.error ?? \"invalid server frame\"}: ${raw}`);\n      }\n      return parsed.frame;\n    });\n  }\n\n  private dispatchEvents(frames: readonly ServerFrame[]): void {\n    for (const frame of frames) {\n      if (frame.type !== \"event\" && frame.type !== \"ext-event\") {\n        continue;\n      }\n      for (const listener of this.listeners) {\n        listener(frame);\n      }\n    }\n  }\n\n  private async pollRuntimeEvents(): Promise<void> {\n    const pollEvents = this.runtime.pollEvents;\n    if (pollEvents === undefined) {\n      return;\n    }\n    const frames = await this.parseFrames(await pollEvents.call(this.runtime));\n    this.dispatchEvents(frames);\n  }\n}\n\nconst responseRequestId = (frame: ServerFrame): RequestId | undefined => {\n  switch (frame.type) {\n    case \"app-created\":\n    case \"default-app\":\n    case \"tray-created\":\n    case \"tray-bounds\":\n    case \"ack\":\n    case \"ext-command-result\":\n    case \"runtime-host-health\":\n      return frame.requestId;\n    case \"ready\":\n    case \"event\":\n    case \"ext-event\":\n    case \"error\":\n      return undefined;\n  }\n};\n"],"mappings":";;;;;;AAKA,MAAM,oBAAoB,cAAc,OAAO,KAAK,GAAG;AAgDvD,MAAa,6BAA6B;AAE1C,MAAa,8BACX,WAAmB,QAAQ,UAC3B,OAAe,QAAQ,SACC;CAGxB,OAAO;EACL,aAAa,aAHG,oBAAoB,QAGF,EAAE,GAFnB,cAAc,IAEiB;EAChD,qBAAqB;CACvB;AACF;AAEA,MAAa,qCAAqC,OAAO,EACvD,WAAW,QAAQ,UACnB,OAAO,QAAQ,MACf,qBAAqB,iCACW,CAAC,MAAuB;CACxD,MAAM,SAAS,2BAA2B,UAAU,IAAI;CACxD,MAAM,kBAAkB,mBAAmB,OAAO,WAAW;CAC7D,IAAI,oBAAoB,KAAA,GACtB,MAAM,IAAI,mCACR,kDAAkD,SAAS,GAAG,KAAK,YAAY,OAAO,eACtF,UACA,MACA,EAAE,aAAa,OAAO,YAAY,CACpC;CAGF,MAAM,cAAc,KAClB,QAAQ,eAAe,GACvB,OAAO,mBACT;CACA,IAAI,CAAE,MAAM,OAAO,WAAW,GAC5B,MAAM,IAAI,mCACR,4BAA4B,OAAO,YAAY,4BAA4B,OAAO,uBAClF,UACA,MACA;EACE,aAAa,OAAO;EACpB;CACF,CACF;CAEF,OAAO;AACT;AAEA,MAAa,6BAA6B,OACxC,UAAwC,CAAC,MACL;CACpC,MAAM,cAAc,MAAM,mCAAmC,OAAO;CACpE,MAAM,UAAU,QAAQ,gBAAgB,kBAAkB,WAAW;CACrE,IAAI,CAAC,iBAAiB,MAAM,GAC1B,MAAM,IAAI,mCACR,4BAA4B,YAAY,wCACxC,QAAQ,YAAY,QAAQ,UAC5B,QAAQ,QAAQ,QAAQ,MACxB,EAAE,YAAY,CAChB;CAEF,OAAO;AACT;AAEA,MAAM,oBAAoB,gBACxB,kBAAkB,WAAW;AAE/B,MAAM,oBAAoB,UAAoD;CAC5E,IACE,OAAO,UAAU,YACjB,UAAU,QACV,EAAE,wBAAwB,QAE1B,OAAO;CAGT,OAAO,OAAOA,MAAQ,uBAAuB;AAC/C;AAEA,MAAM,uBACJ,aACmC;CACnC,QAAQ,UAAR;EACE,KAAK;EACL,KAAK,SACH,OAAO;EACT,KAAK,SACH,OAAO;EACT,SACE,MAAM,IAAI,mCACR,0CAA0C,YAC1C,UACA,QAAQ,IACV;CACJ;AACF;AAEA,MAAM,iBAAiB,SAAkC;CACvD,QAAQ,MAAR;EACE,KAAK;EACL,KAAK,OACH,OAAO;EACT,SACE,MAAM,IAAI,mCACR,8CAA8C,QAC9C,QAAQ,UACR,IACF;CACJ;AACF;AAEA,MAAM,gCACJ,gBACuB;CACvB,IAAI;EACF,OAAO,kBAAkB,QAAQ,GAAG,YAAY,cAAc;CAChE,SAAS,OAAO;EACd,IAAI,YAAY,KAAK,KAAK,MAAM,SAAS,oBACvC;EAEF,MAAM;CACR;AACF;AAEA,MAAM,SAAS,OAAO,SAAmC;CACvD,IAAI;EACF,MAAM,OAAO,MAAM,UAAU,IAAI;EACjC,OAAO;CACT,QAAQ;EACN,OAAO;CACT;AACF;AAEA,MAAM,eAAe,UACnB,iBAAiB,SAAS,UAAU;AAEtC,IAAa,qCAAb,cAAwD,MAAM;CAC5D,OAAgB;CAChB;CACA;CACA;CACA;CAEA,YACE,SACA,UACA,MACA,UAII,CAAC,GACL;EACA,MACE,SACA,QAAQ,UAAU,KAAA,IAAY,KAAA,IAAY,EAAE,OAAO,QAAQ,MAAM,CACnE;EACA,KAAK,OAAO;EACZ,KAAK,WAAW;EAChB,KAAK,OAAO;EACZ,KAAK,cAAc,QAAQ;EAC3B,KAAK,cAAc,QAAQ;CAC7B;AACF;;;AC5LA,MAAa,gCAAgC,OAAO,EAClD,SACA,iBAAiB,SACjB,gBAAgB,gBAChB,kBAAkB,kBAClB,OACA,SACA,OAAO,cACiC,CAAC,MAAmC;CAC5E,MAAM,kBAAkB,WAAY,MAAM,2BAA2B;CAKrE,MAAM,YAAY,IAAI,wBAHpB,SAAS,aACL,sBAAsB,iBAAiB,gBAAgB,OAAO,OAAO,IACrE,qBAAqB,eAAe,CACW;CACrD,MAAM,UAAU,KAAK,eAAe,eAAe;CACnD,OAAO;AACT;AAEA,MAAM,wBACJ,YAC2B;CAC3B,IAAI,QAAQ,yBAAyB,KAAA,GACnC,MAAM,IAAI,MACR,iEACF;CAEF,OAAO,QAAQ,qBAAqB;AACtC;AAEA,MAAM,yBACJ,SACA,gBACA,OACA,YACwB;CACxB,IAAI,QAAQ,0BAA0B,KAAA,GACpC,MAAM,IAAI,MACR,kEACF;CAEF,OAAO,QAAQ,sBAAsB,gBAAgB,OAAO,OAAO;AACrE;AASA,IAAM,0BAAN,MAA4D;CAC1D,4BAA6B,IAAI,IAAyC;CAC1E;CACA;CAEA,YAAY,SAA6B;EACvC,KAAK,UAAU;EACf,KAAK,eACH,QAAQ,eAAe,KAAA,IACnB,KAAA,IACA,kBAAkB;GAChB,KAAU,kBAAkB,EAAE,YAAY,CAE1C,CAAC;EACH,GAAG,EAAE;EACX,KAAK,cAAc,MAAM;CAC3B;CAEA,MAAM,KAAK,eAAuB,iBAAwC;EAUxE,KAJc,MALO,KAAK,OAAO;GAC/B,MAAM;GACN;GACA;EACF,CAAC,GACoB,MAClB,UACC,MAAM,SAAS,OAEX,MAAM,KAAA,GACZ,MAAM,IAAI,MAAM,uDAAuD;CAE3E;CAEA,MAAM,QAAQ,OAAiD;EAE7D,MAAM,YAAW,MADI,KAAK,OAAO,KAAK,GACd,MACrB,cAAc,kBAAkB,SAAS,MAAM,MAAM,SACxD;EACA,IAAI,aAAa,KAAA,GACf,MAAM,IAAI,MACR,mEAAmE,MAAM,WAC3E;EAEF,OAAO;CACT;CAEA,QAAQ,UAA2D;EACjE,KAAK,UAAU,IAAI,QAAQ;EAC3B,aAAa;GACX,KAAK,UAAU,OAAO,QAAQ;EAChC;CACF;CAEA,MAAM,QAAuB;EAC3B,IAAI,KAAK,iBAAiB,KAAA,GACxB,cAAc,KAAK,YAAY;EAEjC,MAAM,SAAS,MAAM,KAAK,YAAY,MAAM,KAAK,QAAQ,MAAM,CAAC;EAChE,KAAK,eAAe,MAAM;CAC5B;CAEA,MAAc,OAAO,OAAuC;EAC1D,MAAM,SAAS,MAAM,KAAK,YACxB,MAAM,KAAK,QAAQ,QAAQ,KAAK,UAAU,KAAK,CAAC,CAClD;EACA,KAAK,eAAe,MAAM;EAC1B,OAAO;CACT;CAEA,MAAc,YACZ,WACwB;EAExB,QAAO,MADiB,WACP,KAAK,QAAQ;GAC5B,MAAM,SAAS,iBAAiB,GAAG;GACnC,IAAI,CAAC,OAAO,MAAM,OAAO,UAAU,KAAA,GACjC,MAAM,IAAI,MAAM,GAAG,OAAO,SAAS,uBAAuB,IAAI,KAAK;GAErE,OAAO,OAAO;EAChB,CAAC;CACH;CAEA,eAAuB,QAAsC;EAC3D,KAAK,MAAM,SAAS,QAAQ;GAC1B,IAAI,MAAM,SAAS,WAAW,MAAM,SAAS,aAC3C;GAEF,KAAK,MAAM,YAAY,KAAK,WAC1B,SAAS,KAAK;EAElB;CACF;CAEA,MAAc,oBAAmC;EAC/C,MAAM,aAAa,KAAK,QAAQ;EAChC,IAAI,eAAe,KAAA,GACjB;EAEF,MAAM,SAAS,MAAM,KAAK,YAAY,MAAM,WAAW,KAAK,KAAK,OAAO,CAAC;EACzE,KAAK,eAAe,MAAM;CAC5B;AACF;AAEA,MAAM,qBAAqB,UAA8C;CACvE,QAAQ,MAAM,MAAd;EACE,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK,uBACH,OAAO,MAAM;EACf,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK,SACH;CACJ;AACF"}