opentray 0.5.2 → 0.7.0

package/dist/client-C27qmRfr.d.mts

@@ -0,0 +1,102 @@
+import { ClientFrame, ClientRequestFrame, ExtensionEnvelope, Icon, Menu, RequestId, ServerFrame, SpaceOptions, SpaceRef, Tooltip, TrayBoundsResult, TrayEvent, TrayId, TrayOptions } from "@opentray/spec";
+
+//#region src/client.d.ts
+interface OpenTrayTransport {
+  request(frame: ClientRequestFrame): Promise<ServerFrame>;
+}
+type BrokerEventFrame = Extract<ServerFrame, {
+  type: "event" | "ext-event";
+}>;
+interface OpenTrayEventSource {
+  onEvent(listener: (frame: BrokerEventFrame) => void): () => void;
+}
+interface OpenTrayConnection extends OpenTrayTransport, OpenTrayEventSource {}
+interface OpenTrayClient {
+  createSpace(options: SpaceOptions): Promise<SpaceHandle>;
+  resolveDefaultSpace(): Promise<SpaceHandle>;
+  /** @deprecated Use `createSpace`. */
+  createSurface(options: SpaceOptions): Promise<SpaceHandle>;
+}
+interface SpaceHandle {
+  space: SpaceRef;
+  createTray(options: TrayOptions): Promise<TrayHandle>;
+}
+interface EventfulSpaceHandle extends Omit<SpaceHandle, "createTray"> {
+  createTray(options: TrayOptions): Promise<EventfulTrayHandle>;
+}
+/** @deprecated Use `SpaceHandle`. */
+type SurfaceHandle = SpaceHandle;
+interface TrayHandle {
+  space: SpaceRef;
+  trayId: TrayId;
+  getBounds(): Promise<TrayBoundsResult>;
+  setMenu(menu: Menu): Promise<void>;
+  setTooltip(tooltip: Tooltip): Promise<void>;
+  setIcon(icon: Icon): Promise<void>;
+  setTitle(title: string): 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;
+}
+interface OpenTrayEventfulClient extends Omit<OpenTrayClient, "createSpace" | "resolveDefaultSpace" | "createSurface"> {
+  createSpace(options: SpaceOptions): Promise<EventfulSpaceHandle>;
+  resolveDefaultSpace(): Promise<EventfulSpaceHandle>;
+  /** @deprecated Use `createSpace`. */
+  createSurface(options: SpaceOptions): Promise<EventfulSpaceHandle>;
+}
+declare function createClient(transport: OpenTrayConnection, options?: CreateClientOptions): OpenTrayEventfulClient;
+declare function createClient(transport: OpenTrayTransport, options?: CreateClientOptions): OpenTrayClient;
+declare function createSpaceHandle(transport: OpenTrayConnection, space: SpaceRef, nextRequestId?: () => RequestId): EventfulSpaceHandle;
+declare function createSpaceHandle(transport: OpenTrayTransport, space: SpaceRef, nextRequestId?: () => RequestId): SpaceHandle;
+/** @deprecated Use `createSpaceHandle`. */
+declare const createSurfaceHandle: typeof createSpaceHandle;
+declare function createTrayHandle(transport: OpenTrayConnection, space: SpaceRef, trayId: TrayId, nextRequestId?: () => RequestId): EventfulTrayHandle;
+declare function createTrayHandle(transport: OpenTrayTransport, space: SpaceRef, trayId: TrayId, nextRequestId?: () => RequestId): TrayHandle;
+//#endregion
+export { createTrayHandle as C, createSurfaceHandle as S, TrayExtensionMountSpec as _, ExtensionLoadOptions as a, createInitFrame as b, OpenTrayEventSource as c, SpaceHandle as d, SurfaceHandle as f, TrayExtensionContext as g, TrayExtension as h, EventfulTrayHandle as i, OpenTrayEventfulClient as l, TrayEventType as m, CreateClientOptions as n, OpenTrayClient as o, TrayEventByType as p, EventfulSpaceHandle as r, OpenTrayConnection as s, BrokerEventFrame as t, OpenTrayTransport as u, TrayHandle as v, createSpaceHandle as x, createClient as y };
+//# sourceMappingURL=client-C27qmRfr.d.mts.map

package/dist/client-C27qmRfr.d.mts.map

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

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { a as SpaceHandle, c as TrayExtensionContext, d as createClient, f as createInitFrame, h as createTrayHandle, i as OpenTrayTransport, l as TrayExtensionMountSpec, m as createSurfaceHandle, n as ExtensionLoadOptions, o as SurfaceHandle, p as createSpaceHandle, r as OpenTrayClient, s as TrayExtension, t as CreateClientOptions, u as TrayHandle } from "./client-DQn3DLZw.mjs";
+import { C as createTrayHandle, S as createSurfaceHandle, _ as TrayExtensionMountSpec, a as ExtensionLoadOptions, b as createInitFrame, c as OpenTrayEventSource, d as SpaceHandle, f as SurfaceHandle, g as TrayExtensionContext, h as TrayExtension, i as EventfulTrayHandle, l as OpenTrayEventfulClient, m as TrayEventType, n as CreateClientOptions, o as OpenTrayClient, p as TrayEventByType, r as EventfulSpaceHandle, s as OpenTrayConnection, t as BrokerEventFrame, u as OpenTrayTransport, v as TrayHandle, x as createSpaceHandle, y as createClient } from "./client-C27qmRfr.mjs";
 import { BrokerEndpointIdentity, BrokerEndpointIdentityOptions, PROTOCOL_VERSION, SpaceOptions, SpaceRef, TrayOptions, createBrokerEndpointIdentity, formatBrokerEndpointName, formatBrokerStateRoot, formatUnixSocketPath, formatWindowsPipeName, isSupportedProtocolVersion } from "@opentray/spec";
 
 //#region src/sdk.d.ts
@@ -13,11 +13,11 @@ interface BrokerConnectOptions {
 interface CreateTrayOptions extends BrokerConnectOptions {
   space?: SpaceRef;
 }
-declare const createSpace: (options: SpaceOptions, brokerOptions?: BrokerConnectOptions) => Promise<SpaceHandle>;
+declare const createSpace: (options: SpaceOptions, brokerOptions?: BrokerConnectOptions) => Promise<EventfulSpaceHandle>;
 /** @deprecated Use `createSpace`. */
 declare const createSurface: (options: SpaceOptions, brokerOptions?: BrokerConnectOptions) => Promise<SurfaceHandle>;
-declare const resolveDefaultSpace: (brokerOptions?: BrokerConnectOptions) => Promise<SpaceHandle>;
-declare const createTray: (options: TrayOptions, brokerOptions?: CreateTrayOptions) => Promise<TrayHandle>;
+declare const resolveDefaultSpace: (brokerOptions?: BrokerConnectOptions) => Promise<EventfulSpaceHandle>;
+declare const createTray: (options: TrayOptions, brokerOptions?: CreateTrayOptions) => Promise<EventfulTrayHandle>;
 //#endregion
-export { type BrokerConnectOptions, type BrokerEndpointIdentity, type BrokerEndpointIdentityOptions, type CreateClientOptions, type CreateTrayOptions, type ExtensionLoadOptions, type OpenTrayClient, type OpenTrayTransport, PROTOCOL_VERSION, type SpaceHandle, type SurfaceHandle, type TrayExtension, type TrayExtensionContext, type TrayExtensionMountSpec, type TrayHandle, createBrokerEndpointIdentity, createClient, createInitFrame, createSpace, createSpaceHandle, createSurface, createSurfaceHandle, createTray, createTrayHandle, formatBrokerEndpointName, formatBrokerStateRoot, formatUnixSocketPath, formatWindowsPipeName, isSupportedProtocolVersion, resolveDefaultSpace };
+export { type BrokerConnectOptions, type BrokerEndpointIdentity, type BrokerEndpointIdentityOptions, type BrokerEventFrame, type CreateClientOptions, type CreateTrayOptions, type EventfulSpaceHandle, type EventfulTrayHandle, type ExtensionLoadOptions, type OpenTrayClient, type OpenTrayConnection, type OpenTrayEventSource, type OpenTrayEventfulClient, type OpenTrayTransport, PROTOCOL_VERSION, type SpaceHandle, type SurfaceHandle, type TrayEventByType, type TrayEventType, type TrayExtension, type TrayExtensionContext, type TrayExtensionMountSpec, type TrayHandle, createBrokerEndpointIdentity, createClient, createInitFrame, createSpace, createSpaceHandle, createSurface, createSurfaceHandle, createTray, createTrayHandle, formatBrokerEndpointName, formatBrokerStateRoot, formatUnixSocketPath, formatWindowsPipeName, isSupportedProtocolVersion, resolveDefaultSpace };
 //# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/sdk.ts"],"mappings":";;;;UAKiB,oBAAA;EACf,QAAA;EACA,OAAA;EACA,cAAA;EACA,eAAA;EACA,aAAA;EACA,SAAA;AAAA;AAAA,UAGe,iBAAA,SAA0B,oBAAoB;EAC7D,KAAA,GAAQ,QAAA;AAAA;AAAA,cAGG,WAAA,GACX,OAAA,EAAS,YAAA,EACT,aAAA,GAAe,oBAAA,KACd,OAAA,CAAQ,WAAA;;cAME,aAAA,GACX,OAAA,EAAS,YAAA,EACT,aAAA,GAAe,oBAAA,KACd,OAAA,CAAQ,aAAA;AAAA,cAEE,mBAAA,GACX,aAAA,GAAe,oBAAA,KACd,OAAA,CAAQ,WAAA;AAAA,cAKE,UAAA,GACX,OAAA,EAAS,WAAA,EACT,aAAA,GAAe,iBAAA,KACd,OAAA,CAAQ,UAAA"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/sdk.ts"],"mappings":";;;;UAWiB,oBAAA;EACf,QAAA;EACA,OAAA;EACA,cAAA;EACA,eAAA;EACA,aAAA;EACA,SAAA;AAAA;AAAA,UAGe,iBAAA,SAA0B,oBAAoB;EAC7D,KAAA,GAAQ,QAAA;AAAA;AAAA,cAGG,WAAA,GACX,OAAA,EAAS,YAAA,EACT,aAAA,GAAe,oBAAA,KACd,OAAA,CAAQ,mBAAA;;cAME,aAAA,GACX,OAAA,EAAS,YAAA,EACT,aAAA,GAAe,oBAAA,KACd,OAAA,CAAQ,aAAA;AAAA,cAEE,mBAAA,GACX,aAAA,GAAe,oBAAA,KACd,OAAA,CAAQ,mBAAA;AAAA,cAKE,UAAA,GACX,OAAA,EAAS,WAAA,EACT,aAAA,GAAe,iBAAA,KACd,OAAA,CAAQ,kBAAA"}

package/dist/index.mjs

@@ -1,6 +1,267 @@
-import { a as createTrayHandle, i as createSurfaceHandle, n as createInitFrame, r as createSpaceHandle, t as createClient } from "./client-DzcHIH-f.mjs";
-import { t as connectLocalBroker } from "./local-broker-CEIHPBcK.mjs";
-import { PROTOCOL_VERSION, createBrokerEndpointIdentity, formatBrokerEndpointName, formatBrokerStateRoot, formatUnixSocketPath, formatWindowsPipeName, isSupportedProtocolVersion } from "@opentray/spec";
+import { t as connectLocalBroker } from "./local-broker-DOIkewF4.mjs";
+import { PROTOCOL_VERSION, PROTOCOL_VERSION as PROTOCOL_VERSION$1, createBrokerEndpointIdentity, formatBrokerEndpointName, formatBrokerStateRoot, formatUnixSocketPath, formatWindowsPipeName, isSupportedProtocolVersion } from "@opentray/spec";
+//#region src/client.ts
+const createInitFrame = (clientVersion) => ({
+	type: "init",
+	protocolVersion: PROTOCOL_VERSION$1,
+	clientVersion
+});
+function createClient(transport, options = {}) {
+	const nextRequestId = createRequestIdFactory(options.requestIdPrefix ?? "opentray");
+	return {
+		async createSpace(spaceOptions) {
+			const requestId = nextRequestId();
+			const space = expectResponse(await transport.request({
+				type: "create-space",
+				requestId,
+				...spaceOptions
+			}), requestId, "space-created").space;
+			return createSpaceHandle(transport, space, nextRequestId);
+		},
+		async resolveDefaultSpace() {
+			const requestId = nextRequestId();
+			const space = expectResponse(await transport.request({
+				type: "resolve-default-space",
+				requestId
+			}), requestId, "default-space").space;
+			return createSpaceHandle(transport, space, nextRequestId);
+		},
+		async createSurface(spaceOptions) {
+			return this.createSpace(spaceOptions);
+		}
+	};
+}
+function createSpaceHandle(transport, space, nextRequestId = createRequestIdFactory("opentray")) {
+	return {
+		space,
+		async createTray(options) {
+			const requestId = nextRequestId();
+			return createTrayHandle(transport, space, expectResponse(await transport.request({
+				type: "create-tray",
+				requestId,
+				space,
+				tray: options
+			}), requestId, "tray-created").trayId, nextRequestId);
+		}
+	};
+}
+/** @deprecated Use `createSpaceHandle`. */
+const createSurfaceHandle = createSpaceHandle;
+function createTrayHandle(transport, space, trayId, nextRequestId = createRequestIdFactory("opentray")) {
+	let nextMountOrdinal = 1;
+	const nextMountId = (extensionName) => {
+		const mountId = `${formatMountIdComponent(extensionName)}.${formatMountIdComponent(trayId)}.${nextMountOrdinal}`;
+		nextMountOrdinal += 1;
+		return mountId;
+	};
+	const handle = {
+		space,
+		trayId,
+		async getBounds() {
+			const requestId = nextRequestId();
+			return expectResponse(await transport.request({
+				type: "get-tray-bounds",
+				requestId,
+				spaceId: space.spaceId,
+				trayId
+			}), requestId, "tray-bounds").bounds;
+		},
+		async setMenu(menu) {
+			const requestId = nextRequestId();
+			expectResponse(await transport.request({
+				type: "set-tray-menu",
+				requestId,
+				spaceId: space.spaceId,
+				trayId,
+				menu
+			}), requestId, "ack");
+		},
+		async setTooltip(tooltip) {
+			const requestId = nextRequestId();
+			expectResponse(await transport.request({
+				type: "set-tray-tooltip",
+				requestId,
+				spaceId: space.spaceId,
+				trayId,
+				tooltip
+			}), requestId, "ack");
+		},
+		async setIcon(icon) {
+			const requestId = nextRequestId();
+			expectResponse(await transport.request({
+				type: "set-tray-icon",
+				requestId,
+				spaceId: space.spaceId,
+				trayId,
+				icon
+			}), requestId, "ack");
+		},
+		async setTitle(title) {
+			const requestId = nextRequestId();
+			expectResponse(await transport.request({
+				type: "set-tray-title",
+				requestId,
+				spaceId: space.spaceId,
+				trayId,
+				title
+			}), requestId, "ack");
+		},
+		async loadExtension(options) {
+			const requestId = nextRequestId();
+			expectResponse(await transport.request({
+				type: "load-ext",
+				requestId,
+				spaceId: space.spaceId,
+				name: options.name,
+				path: options.path,
+				...options.mountId === void 0 ? {} : { mountId: options.mountId }
+			}), requestId, "ack");
+		},
+		async commandExtension(ext, data) {
+			await this.requestExtension(ext, data);
+		},
+		async requestExtension(ext, data) {
+			const requestId = nextRequestId();
+			const response = await transport.request({
+				type: "ext-command",
+				requestId,
+				spaceId: space.spaceId,
+				trayId,
+				ext,
+				data
+			});
+			if (response.type === "ack") {
+				expectResponse(response, requestId, "ack");
+				return [];
+			}
+			return expectResponse(response, requestId, "ext-command-result").events;
+		},
+		extend(extension, options) {
+			const context = createTrayExtensionContext(handle, extension, options, nextMountId);
+			const capability = extension.extend(handle, context, options);
+			return Object.assign({}, handle, capability);
+		},
+		async destroy() {
+			const requestId = nextRequestId();
+			expectResponse(await transport.request({
+				type: "destroy-tray",
+				requestId,
+				spaceId: space.spaceId,
+				trayId
+			}), requestId, "ack");
+		}
+	};
+	if (!isOpenTrayEventSource(transport)) return handle;
+	return attachEventfulTrayHandle(handle, transport, nextMountId);
+}
+const attachEventfulTrayHandle = (handle, source, nextMountId) => {
+	const listen = (event, handler) => source.onEvent((frame) => {
+		if (frame.type !== "event" || frame.event.type !== event) return;
+		if (!isOwnedTrayEvent(frame.event, handle.space.spaceId, handle.trayId)) return;
+		handler(frame.event);
+	});
+	const eventful = {
+		...handle,
+		listenExtension(ext, handler) {
+			return source.onEvent((frame) => {
+				if (frame.type !== "ext-event" || frame.ext !== ext) return;
+				if (frame.spaceId !== handle.space.spaceId || frame.trayId !== handle.trayId) return;
+				handler({
+					scope: {
+						spaceId: frame.spaceId,
+						trayId: frame.trayId,
+						ext: frame.ext
+					},
+					data: frame.data
+				});
+			});
+		},
+		listen,
+		onMenuClick(handler) {
+			return listen("menuClick", handler);
+		},
+		onTrayClick(handler) {
+			return listen("trayClick", handler);
+		},
+		onTrayDoubleClick(handler) {
+			return listen("trayDoubleClick", handler);
+		},
+		extend(extension, options) {
+			const context = createTrayExtensionContext(eventful, extension, options, nextMountId);
+			const capability = extension.extend(eventful, context, options);
+			return Object.assign({}, eventful, capability);
+		}
+	};
+	return eventful;
+};
+const isOwnedTrayEvent = (event, spaceId, trayId) => event.type !== "ready" && event.spaceId === spaceId && event.trayId === trayId;
+const isOpenTrayEventSource = (transport) => "onEvent" in transport && typeof transport.onEvent === "function";
+const createTrayExtensionContext = (tray, extension, options, nextMountId) => {
+	const mount = extension.resolveMount?.(options) ?? {};
+	const name = mount.name ?? extension.name;
+	const path = mount.path ?? extension.path;
+	const mountId = mount.mountId ?? nextMountId(name);
+	let loadPromise;
+	const ensureLoaded = async () => {
+		if (loadPromise === void 0) loadPromise = tray.loadExtension({
+			name,
+			path,
+			mountId
+		}).catch((error) => {
+			loadPromise = void 0;
+			throw error;
+		});
+		await loadPromise;
+	};
+	return {
+		name,
+		path,
+		mountId,
+		ensureLoaded,
+		async command(data) {
+			await ensureLoaded();
+			await tray.commandExtension(mountId, data);
+		},
+		async request(data) {
+			await ensureLoaded();
+			return tray.requestExtension(mountId, data);
+		}
+	};
+};
+const formatMountIdComponent = (value) => {
+	const formatted = value.replaceAll(/[^a-zA-Z0-9._+-]/g, "_");
+	return formatted.length > 0 ? formatted : "ext";
+};
+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 "space-created":
+		case "default-space":
+		case "tray-created":
+		case "tray-bounds":
+		case "ack":
+		case "ext-command-result":
+		case "daemon-health": return frame.requestId;
+		case "error": return frame.requestId;
+		case "ready":
+		case "event":
+		case "ext-event": return;
+	}
+};
+//#endregion
 //#region src/sdk.ts
 const createSpace = async (options, brokerOptions = {}) => {
 	return createClient(await connectLocalBroker(brokerOptions)).createSpace(options);

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../src/sdk.ts"],"sourcesContent":["import type { SpaceOptions, SpaceRef, TrayOptions } from \"@opentray/spec\";\n\nimport { createClient, createSpaceHandle, type SpaceHandle, type SurfaceHandle, type TrayHandle } from \"./client\";\nimport { connectLocalBroker } from \"./local-broker\";\n\nexport interface BrokerConnectOptions {\n  endpoint?: string;\n  homeDir?: string;\n  packageVersion?: string;\n  protocolVersion?: number;\n  clientVersion?: string;\n  autoStart?: boolean;\n}\n\nexport interface CreateTrayOptions extends BrokerConnectOptions {\n  space?: SpaceRef;\n}\n\nexport const createSpace = async (\n  options: SpaceOptions,\n  brokerOptions: BrokerConnectOptions = {},\n): Promise<SpaceHandle> => {\n  const connection = await connectLocalBroker(brokerOptions);\n  return createClient(connection).createSpace(options);\n};\n\n/** @deprecated Use `createSpace`. */\nexport const createSurface = async (\n  options: SpaceOptions,\n  brokerOptions: BrokerConnectOptions = {},\n): Promise<SurfaceHandle> => createSpace(options, brokerOptions);\n\nexport const resolveDefaultSpace = async (\n  brokerOptions: BrokerConnectOptions = {},\n): Promise<SpaceHandle> => {\n  const connection = await connectLocalBroker(brokerOptions);\n  return createClient(connection).resolveDefaultSpace();\n};\n\nexport const createTray = async (\n  options: TrayOptions,\n  brokerOptions: CreateTrayOptions = {},\n): Promise<TrayHandle> => {\n  const { space, ...connectOptions } = brokerOptions;\n  const connection = await connectLocalBroker(connectOptions);\n  const spaceHandle = space ? createSpaceHandle(connection, space) : await createClient(connection).resolveDefaultSpace();\n  return spaceHandle.createTray(options);\n};\n"],"mappings":";;;;AAkBA,MAAa,cAAc,OACzB,SACA,gBAAsC,CAAC,MACd;CAEzB,OAAO,aAAa,MADK,mBAAmB,aAAa,CAC3B,EAAE,YAAY,OAAO;AACrD;;AAGA,MAAa,gBAAgB,OAC3B,SACA,gBAAsC,CAAC,MACZ,YAAY,SAAS,aAAa;AAE/D,MAAa,sBAAsB,OACjC,gBAAsC,CAAC,MACd;CAEzB,OAAO,aAAa,MADK,mBAAmB,aAAa,CAC3B,EAAE,oBAAoB;AACtD;AAEA,MAAa,aAAa,OACxB,SACA,gBAAmC,CAAC,MACZ;CACxB,MAAM,EAAE,OAAO,GAAG,mBAAmB;CACrC,MAAM,aAAa,MAAM,mBAAmB,cAAc;CAE1D,QADoB,QAAQ,kBAAkB,YAAY,KAAK,IAAI,MAAM,aAAa,UAAU,EAAE,oBAAoB,GACnG,WAAW,OAAO;AACvC"}
+{"version":3,"file":"index.mjs","names":["PROTOCOL_VERSION"],"sources":["../src/client.ts","../src/sdk.ts"],"sourcesContent":["import {\n  PROTOCOL_VERSION,\n  type ClientFrame,\n  type ClientRequestFrame,\n  type ExtensionEnvelope,\n  type Icon,\n  type Menu,\n  type RequestId,\n  type ServerFrame,\n  type SpaceOptions,\n  type SpaceRef,\n  type Tooltip,\n  type TrayBoundsResult,\n  type TrayEvent,\n  type TrayId,\n  type TrayOptions,\n} from \"@opentray/spec\";\n\nexport interface OpenTrayTransport {\n  request(frame: ClientRequestFrame): Promise<ServerFrame>;\n}\n\nexport type BrokerEventFrame = Extract<ServerFrame, { type: \"event\" | \"ext-event\" }>;\n\nexport interface OpenTrayEventSource {\n  onEvent(listener: (frame: BrokerEventFrame) => void): () => void;\n}\n\nexport interface OpenTrayConnection extends OpenTrayTransport, OpenTrayEventSource {}\n\nexport interface OpenTrayClient {\n  createSpace(options: SpaceOptions): Promise<SpaceHandle>;\n  resolveDefaultSpace(): Promise<SpaceHandle>;\n  /** @deprecated Use `createSpace`. */\n  createSurface(options: SpaceOptions): Promise<SpaceHandle>;\n}\n\nexport interface SpaceHandle {\n  space: SpaceRef;\n  createTray(options: TrayOptions): Promise<TrayHandle>;\n}\n\nexport interface EventfulSpaceHandle extends Omit<SpaceHandle, \"createTray\"> {\n  createTray(options: TrayOptions): Promise<EventfulTrayHandle>;\n}\n\n/** @deprecated Use `SpaceHandle`. */\nexport type SurfaceHandle = SpaceHandle;\n\nexport interface TrayHandle {\n  space: SpaceRef;\n  trayId: TrayId;\n  getBounds(): Promise<TrayBoundsResult>;\n  setMenu(menu: Menu): Promise<void>;\n  setTooltip(tooltip: Tooltip): Promise<void>;\n  setIcon(icon: Icon): Promise<void>;\n  setTitle(title: string): Promise<void>;\n  loadExtension(options: ExtensionLoadOptions): Promise<void>;\n  commandExtension(ext: string, data: unknown): Promise<void>;\n  requestExtension(ext: string, data: unknown): Promise<ExtensionEnvelope[]>;\n  extend<TCapability extends object, TOptions = undefined>(\n    extension: TrayExtension<TCapability, TOptions>,\n    options?: TOptions,\n  ): TrayHandle & TCapability;\n  destroy(): Promise<void>;\n}\n\nexport type TrayScopedEvent = Exclude<TrayEvent, { type: \"ready\" }>;\nexport type TrayEventType = TrayScopedEvent[\"type\"];\nexport type TrayEventByType<TEvent extends TrayEventType> = Extract<TrayScopedEvent, { type: TEvent }>;\n\nexport interface EventfulTrayHandle extends TrayHandle {\n  extend<TCapability extends object, TOptions = undefined>(\n    extension: TrayExtension<TCapability, TOptions>,\n    options?: TOptions,\n  ): EventfulTrayHandle & TCapability;\n  listenExtension<TData = unknown>(\n    ext: string,\n    handler: (event: ExtensionEnvelope<TData>) => void,\n  ): () => void;\n  listen<TEvent extends TrayEventType>(\n    event: TEvent,\n    handler: (event: TrayEventByType<TEvent>) => void,\n  ): () => void;\n  onMenuClick(handler: (event: TrayEventByType<\"menuClick\">) => void): () => void;\n  onTrayClick(handler: (event: TrayEventByType<\"trayClick\">) => void): () => void;\n  onTrayDoubleClick(handler: (event: TrayEventByType<\"trayDoubleClick\">) => void): () => void;\n}\n\nexport interface ExtensionLoadOptions {\n  name: string;\n  path: string;\n  mountId?: string;\n}\n\nexport interface TrayExtensionMountSpec {\n  name?: string;\n  path?: string;\n  mountId?: string;\n}\n\nexport interface TrayExtensionContext {\n  readonly name: string;\n  readonly path: string;\n  readonly mountId: string;\n  ensureLoaded(): Promise<void>;\n  command(data: unknown): Promise<void>;\n  request(data: unknown): Promise<ExtensionEnvelope[]>;\n}\n\nexport interface TrayExtension<TCapability extends object, TOptions = undefined> {\n  readonly name: string;\n  readonly path: string;\n  resolveMount?(options: TOptions | undefined): TrayExtensionMountSpec;\n  extend(tray: TrayHandle, context: TrayExtensionContext, options: TOptions | undefined): TCapability;\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 interface OpenTrayEventfulClient extends Omit<OpenTrayClient, \"createSpace\" | \"resolveDefaultSpace\" | \"createSurface\"> {\n  createSpace(options: SpaceOptions): Promise<EventfulSpaceHandle>;\n  resolveDefaultSpace(): Promise<EventfulSpaceHandle>;\n  /** @deprecated Use `createSpace`. */\n  createSurface(options: SpaceOptions): Promise<EventfulSpaceHandle>;\n}\n\nexport function createClient(\n  transport: OpenTrayConnection,\n  options?: CreateClientOptions,\n): OpenTrayEventfulClient;\nexport function createClient(transport: OpenTrayTransport, options?: CreateClientOptions): OpenTrayClient;\nexport function createClient(\n  transport: OpenTrayTransport,\n  options: CreateClientOptions = {},\n): OpenTrayClient | OpenTrayEventfulClient {\n  const nextRequestId = createRequestIdFactory(options.requestIdPrefix ?? \"opentray\");\n\n  return {\n    async createSpace(spaceOptions): Promise<SpaceHandle> {\n      const requestId = nextRequestId();\n      const response = await transport.request({\n        type: \"create-space\",\n        requestId,\n        ...spaceOptions,\n      });\n      const space = expectResponse(response, requestId, \"space-created\").space;\n      return createSpaceHandle(transport, space, nextRequestId);\n    },\n    async resolveDefaultSpace(): Promise<SpaceHandle> {\n      const requestId = nextRequestId();\n      const response = await transport.request({\n        type: \"resolve-default-space\",\n        requestId,\n      });\n      const space = expectResponse(response, requestId, \"default-space\").space;\n      return createSpaceHandle(transport, space, nextRequestId);\n    },\n    async createSurface(spaceOptions): Promise<SpaceHandle> {\n      return this.createSpace(spaceOptions);\n    },\n  };\n};\n\nexport function createSpaceHandle(\n  transport: OpenTrayConnection,\n  space: SpaceRef,\n  nextRequestId?: () => RequestId,\n): EventfulSpaceHandle;\nexport function createSpaceHandle(\n  transport: OpenTrayTransport,\n  space: SpaceRef,\n  nextRequestId?: () => RequestId,\n): SpaceHandle;\nexport function createSpaceHandle(\n  transport: OpenTrayTransport,\n  space: SpaceRef,\n  nextRequestId: () => RequestId = createRequestIdFactory(\"opentray\"),\n): SpaceHandle | EventfulSpaceHandle {\n  return {\n    space,\n    async createTray(options: TrayOptions): Promise<TrayHandle | EventfulTrayHandle> {\n      const requestId = nextRequestId();\n      const response = await transport.request({\n        type: \"create-tray\",\n        requestId,\n        space,\n        tray: options,\n      });\n      const frame = expectResponse(response, requestId, \"tray-created\");\n      return createTrayHandle(transport, space, frame.trayId, nextRequestId);\n    },\n  };\n}\n\n/** @deprecated Use `createSpaceHandle`. */\nexport const createSurfaceHandle = createSpaceHandle;\n\nexport function createTrayHandle(\n  transport: OpenTrayConnection,\n  space: SpaceRef,\n  trayId: TrayId,\n  nextRequestId?: () => RequestId,\n): EventfulTrayHandle;\nexport function createTrayHandle(\n  transport: OpenTrayTransport,\n  space: SpaceRef,\n  trayId: TrayId,\n  nextRequestId?: () => RequestId,\n): TrayHandle;\nexport function createTrayHandle(\n  transport: OpenTrayTransport,\n  space: SpaceRef,\n  trayId: TrayId,\n  nextRequestId: () => RequestId = createRequestIdFactory(\"opentray\"),\n): TrayHandle | EventfulTrayHandle {\n  let nextMountOrdinal = 1;\n  const nextMountId = (extensionName: string): string => {\n    const mountId = `${formatMountIdComponent(extensionName)}.${formatMountIdComponent(trayId)}.${nextMountOrdinal}`;\n    nextMountOrdinal += 1;\n    return mountId;\n  };\n  const handle: TrayHandle = {\n    space,\n    trayId,\n    async getBounds(): Promise<TrayBoundsResult> {\n      const requestId = nextRequestId();\n      const response = await transport.request({\n        type: \"get-tray-bounds\",\n        requestId,\n        spaceId: space.spaceId,\n        trayId,\n      });\n      return expectResponse(response, requestId, \"tray-bounds\").bounds;\n    },\n    async setMenu(menu: Menu): Promise<void> {\n      const requestId = nextRequestId();\n      const response = await transport.request({\n        type: \"set-tray-menu\",\n        requestId,\n        spaceId: space.spaceId,\n        trayId,\n        menu,\n      });\n      expectResponse(response, requestId, \"ack\");\n    },\n    async setTooltip(tooltip: Tooltip): Promise<void> {\n      const requestId = nextRequestId();\n      const response = await transport.request({\n        type: \"set-tray-tooltip\",\n        requestId,\n        spaceId: space.spaceId,\n        trayId,\n        tooltip,\n      });\n      expectResponse(response, requestId, \"ack\");\n    },\n    async setIcon(icon: Icon): Promise<void> {\n      const requestId = nextRequestId();\n      const response = await transport.request({\n        type: \"set-tray-icon\",\n        requestId,\n        spaceId: space.spaceId,\n        trayId,\n        icon,\n      });\n      expectResponse(response, requestId, \"ack\");\n    },\n    async setTitle(title: string): Promise<void> {\n      const requestId = nextRequestId();\n      const response = await transport.request({\n        type: \"set-tray-title\",\n        requestId,\n        spaceId: space.spaceId,\n        trayId,\n        title,\n      });\n      expectResponse(response, requestId, \"ack\");\n    },\n    async loadExtension(options): Promise<void> {\n      const requestId = nextRequestId();\n      const response = await transport.request({\n        type: \"load-ext\",\n        requestId,\n        spaceId: space.spaceId,\n        name: options.name,\n        path: options.path,\n        ...(options.mountId === undefined ? {} : { mountId: options.mountId }),\n      });\n      expectResponse(response, requestId, \"ack\");\n    },\n    async commandExtension(ext: string, data: unknown): Promise<void> {\n      await this.requestExtension(ext, data);\n    },\n    async requestExtension(ext: string, data: unknown): Promise<ExtensionEnvelope[]> {\n      const requestId = nextRequestId();\n      const response = await transport.request({\n        type: \"ext-command\",\n        requestId,\n        spaceId: space.spaceId,\n        trayId,\n        ext,\n        data,\n      });\n      if (response.type === \"ack\") {\n        expectResponse(response, requestId, \"ack\");\n        return [];\n      }\n      return expectResponse(response, requestId, \"ext-command-result\").events;\n    },\n    extend<TCapability extends object, TOptions = undefined>(\n      extension: TrayExtension<TCapability, TOptions>,\n      options?: TOptions,\n    ): TrayHandle & TCapability {\n      const context = createTrayExtensionContext(handle, extension, options, nextMountId);\n      const capability = extension.extend(handle, context, options);\n      return Object.assign({}, handle, capability);\n    },\n    async destroy(): Promise<void> {\n      const requestId = nextRequestId();\n      const response = await transport.request({\n        type: \"destroy-tray\",\n        requestId,\n        spaceId: space.spaceId,\n        trayId,\n      });\n      expectResponse(response, requestId, \"ack\");\n    },\n  };\n  if (!isOpenTrayEventSource(transport)) {\n    return handle;\n  }\n  return attachEventfulTrayHandle(handle, transport, nextMountId);\n}\n\nconst attachEventfulTrayHandle = (\n  handle: TrayHandle,\n  source: OpenTrayEventSource,\n  nextMountId: (extensionName: string) => string,\n): EventfulTrayHandle => {\n  const listen: EventfulTrayHandle[\"listen\"] = (event, handler) =>\n    source.onEvent((frame) => {\n      if (frame.type !== \"event\" || frame.event.type !== event) {\n        return;\n      }\n      if (!isOwnedTrayEvent(frame.event, handle.space.spaceId, handle.trayId)) {\n        return;\n      }\n      handler(frame.event as TrayEventByType<typeof event>);\n    });\n\n  const eventful: EventfulTrayHandle = {\n    ...handle,\n    listenExtension<TData = unknown>(ext: string, handler: (event: ExtensionEnvelope<TData>) => void) {\n      return source.onEvent((frame) => {\n        if (frame.type !== \"ext-event\" || frame.ext !== ext) {\n          return;\n        }\n        if (frame.spaceId !== handle.space.spaceId || frame.trayId !== handle.trayId) {\n          return;\n        }\n        handler({\n          scope: { spaceId: frame.spaceId, trayId: frame.trayId, ext: frame.ext },\n          data: frame.data as TData,\n        });\n      });\n    },\n    listen,\n    onMenuClick(handler) {\n      return listen(\"menuClick\", handler);\n    },\n    onTrayClick(handler) {\n      return listen(\"trayClick\", handler);\n    },\n    onTrayDoubleClick(handler) {\n      return listen(\"trayDoubleClick\", handler);\n    },\n    extend<TCapability extends object, TOptions = undefined>(\n      extension: TrayExtension<TCapability, TOptions>,\n      options?: TOptions,\n    ): EventfulTrayHandle & TCapability {\n      const context = createTrayExtensionContext(eventful, extension, options, nextMountId);\n      const capability = extension.extend(eventful, context, options);\n      return Object.assign({}, eventful, capability);\n    },\n  };\n  return eventful;\n};\n\nconst isOwnedTrayEvent = (event: TrayEvent, spaceId: string, trayId: string): event is TrayScopedEvent =>\n  event.type !== \"ready\" && event.spaceId === spaceId && event.trayId === trayId;\n\nconst isOpenTrayEventSource = (transport: OpenTrayTransport): transport is OpenTrayConnection =>\n  \"onEvent\" in transport && typeof transport.onEvent === \"function\";\n\nconst createTrayExtensionContext = <TCapability extends object, TOptions>(\n  tray: TrayHandle,\n  extension: TrayExtension<TCapability, TOptions>,\n  options: TOptions | undefined,\n  nextMountId: (extensionName: string) => string,\n): TrayExtensionContext => {\n  const mount = extension.resolveMount?.(options) ?? {};\n  const name = mount.name ?? extension.name;\n  const path = mount.path ?? extension.path;\n  const mountId = mount.mountId ?? nextMountId(name);\n  let loadPromise: Promise<void> | undefined;\n\n  const ensureLoaded = async (): Promise<void> => {\n    if (loadPromise === undefined) {\n      loadPromise = tray.loadExtension({ name, path, mountId }).catch((error: unknown) => {\n        loadPromise = undefined;\n        throw error;\n      });\n    }\n    await loadPromise;\n  };\n\n  return {\n    name,\n    path,\n    mountId,\n    ensureLoaded,\n    async command(data: unknown): Promise<void> {\n      await ensureLoaded();\n      await tray.commandExtension(mountId, data);\n    },\n    async request(data: unknown): Promise<ExtensionEnvelope[]> {\n      await ensureLoaded();\n      return tray.requestExtension(mountId, data);\n    },\n  };\n};\n\nconst formatMountIdComponent = (value: string): string => {\n  const formatted = value.replaceAll(/[^a-zA-Z0-9._+-]/g, \"_\");\n  return formatted.length > 0 ? formatted : \"ext\";\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 \"space-created\":\n    case \"default-space\":\n    case \"tray-created\":\n    case \"tray-bounds\":\n    case \"ack\":\n    case \"ext-command-result\":\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","import type { SpaceOptions, SpaceRef, TrayOptions } from \"@opentray/spec\";\n\nimport {\n  createClient,\n  createSpaceHandle,\n  type EventfulSpaceHandle,\n  type EventfulTrayHandle,\n  type SurfaceHandle,\n} from \"./client\";\nimport { connectLocalBroker } from \"./local-broker\";\n\nexport interface BrokerConnectOptions {\n  endpoint?: string;\n  homeDir?: string;\n  packageVersion?: string;\n  protocolVersion?: number;\n  clientVersion?: string;\n  autoStart?: boolean;\n}\n\nexport interface CreateTrayOptions extends BrokerConnectOptions {\n  space?: SpaceRef;\n}\n\nexport const createSpace = async (\n  options: SpaceOptions,\n  brokerOptions: BrokerConnectOptions = {},\n): Promise<EventfulSpaceHandle> => {\n  const connection = await connectLocalBroker(brokerOptions);\n  return createClient(connection).createSpace(options);\n};\n\n/** @deprecated Use `createSpace`. */\nexport const createSurface = async (\n  options: SpaceOptions,\n  brokerOptions: BrokerConnectOptions = {},\n): Promise<SurfaceHandle> => createSpace(options, brokerOptions);\n\nexport const resolveDefaultSpace = async (\n  brokerOptions: BrokerConnectOptions = {},\n): Promise<EventfulSpaceHandle> => {\n  const connection = await connectLocalBroker(brokerOptions);\n  return createClient(connection).resolveDefaultSpace();\n};\n\nexport const createTray = async (\n  options: TrayOptions,\n  brokerOptions: CreateTrayOptions = {},\n): Promise<EventfulTrayHandle> => {\n  const { space, ...connectOptions } = brokerOptions;\n  const connection = await connectLocalBroker(connectOptions);\n  const spaceHandle = space ? createSpaceHandle(connection, space) : await createClient(connection).resolveDefaultSpace();\n  return spaceHandle.createTray(options);\n};\n"],"mappings":"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"}

package/dist/{local-broker-CEIHPBcK.mjs → local-broker-DOIkewF4.mjs}

@@ -115,8 +115,14 @@ const findWorkspaceRoot = async (start) => {
 		current = parent;
 	}
 };
+const resolveDevBrokerBinaryPath = (workspaceRoot, platform = process.platform) => join(workspaceRoot, "target", "debug", platform === "win32" ? "opentray.exe" : "opentray");
+const terminateWorkspaceDevBrokerProcess = async (workspaceRoot, platform = process.platform) => {
+	if (platform !== "win32") return;
+	await terminateWindowsProcessByExecutable(resolveDevBrokerBinaryPath(workspaceRoot, platform));
+};
 const ensureDevBrokerBinary = async (workspaceRoot) => {
-	const binary = join(workspaceRoot, "target", "debug", process.platform === "win32" ? "opentray.exe" : "opentray");
+	const binary = resolveDevBrokerBinaryPath(workspaceRoot);
+	await terminateWorkspaceDevBrokerProcess(workspaceRoot);
 	await runCargoBuild(workspaceRoot);
 	return binary;
 };
@@ -146,6 +152,45 @@ const exists = async (path) => {
 		return false;
 	}
 };
+const terminateWindowsProcessByExecutable = (binary) => new Promise((resolve, reject) => {
+	const child = spawn("powershell.exe", [
+		"-NoProfile",
+		"-NonInteractive",
+		"-ExecutionPolicy",
+		"Bypass",
+		"-Command",
+		String.raw`
+$ErrorActionPreference = 'Stop'
+$target = [System.IO.Path]::GetFullPath(${powerShellString(binary)})
+$processes = @(Get-CimInstance Win32_Process -Filter "Name = 'opentray.exe'" | Where-Object {
+  $_.ExecutablePath -and ([System.IO.Path]::GetFullPath($_.ExecutablePath) -ieq $target)
+})
+foreach ($process in $processes) {
+  Stop-Process -Id $process.ProcessId -Force -ErrorAction Stop
+}
+foreach ($process in $processes) {
+  Wait-Process -Id $process.ProcessId -Timeout 5 -ErrorAction SilentlyContinue
+}
+`
+	], { stdio: [
+		"ignore",
+		"ignore",
+		"pipe"
+	] });
+	let stderr = "";
+	child.stderr?.on("data", (chunk) => {
+		stderr += String(chunk);
+	});
+	child.once("error", reject);
+	child.once("exit", (code) => {
+		if (code === 0) {
+			resolve();
+			return;
+		}
+		reject(/* @__PURE__ */ new Error(`failed to stop running dev broker before cargo build: ${stderr.trim() || code}`));
+	});
+});
+const powerShellString = (value) => `'${value.replace(/'/g, "''")}'`;
 const isNodeError$1 = (error) => error instanceof Error && "code" in error;
 //#endregion
 //#region src/daemon/lifecycle.ts
@@ -191,7 +236,7 @@ const startDaemon = async ({ paths, driver, lockTimeoutMs = 1e3 }) => {
 		const pid = await driver.spawnBroker(paths);
 		if (!Number.isInteger(pid) || pid <= 0) throw new Error("daemon broker process did not expose a valid pid");
 		await writeFile(paths.pidFile, `${pid}\n`, "utf8");
-		await waitForReadyFile(paths.readyFile);
+		await waitForReadyFile(paths.readyFile, driver, pid);
 		return {
 			status: "started",
 			pid,
@@ -264,12 +309,13 @@ const waitUntilStopped = async (driver, pid) => {
 		await sleep(50);
 	}
 };
-const waitForReadyFile = async (readyFile) => {
+const waitForReadyFile = async (readyFile, driver, pid) => {
 	for (let attempt = 0; attempt < 40; attempt += 1) try {
 		await readFile(readyFile, "utf8");
 		return;
 	} catch (error) {
 		if (!isNodeError(error) || error.code !== "ENOENT") throw error;
+		if (!await driver.isAlive(pid)) throw new Error(`daemon broker exited before readiness: pid=${pid}; readyFile=${readyFile}; set ${DAEMON_STDIO_ENV}=inherit to inspect broker stderr`);
 		await sleep(50);
 	}
 	throw new Error(`timed out waiting for daemon readiness: ${readyFile}`);
@@ -432,7 +478,7 @@ var LocalBrokerConnection = class {
 	dispatchLine(line) {
 		const parsed = parseServerFrame(line);
 		if (!parsed.ok || parsed.frame === void 0) {
-			this.rejectAll(new Error(parsed.error ?? "invalid server frame"));
+			this.rejectAll(/* @__PURE__ */ new Error(`${parsed.error ?? "invalid server frame"}: ${line}`));
 			return;
 		}
 		this.dispatchFrame(parsed.frame);
@@ -487,6 +533,7 @@ const responseRequestId = (frame) => {
 		case "tray-created":
 		case "tray-bounds":
 		case "ack":
+		case "ext-command-result":
 		case "daemon-health": return frame.requestId;
 		case "ready":
 		case "event":
@@ -501,4 +548,4 @@ const resolveCliEntrypoint = () => {
 //#endregion
 export { inspectDaemon as a, stopDaemon as c, createNodeDaemonDriver as i, resolveDaemonPaths as n, restartDaemon as o, readPackageVersion as r, startDaemon as s, connectLocalBroker as t };
 
-//# sourceMappingURL=local-broker-CEIHPBcK.mjs.map
+//# sourceMappingURL=local-broker-DOIkewF4.mjs.map