opentray 0.3.0 → 0.3.1

package/README.md

@@ -25,6 +25,28 @@ Run a protocol-only example that creates a space, creates a tray, dispatches an
 pnpm --filter opentray example:basic
 ```
 
+The top-level SDK now exposes the mainline broker-backed path directly:
+
+```ts
+import { createSpace, createTray, resolveDefaultSpace } from "opentray";
+
+const space = await createSpace({ id: "com.example.status", default: true });
+await space.createTray({
+  trayId: "status",
+  title: "Status",
+  icon: { type: "rgba", data: [0, 0, 0, 0], width: 1, height: 1 },
+});
+
+const defaultSpace = await resolveDefaultSpace();
+await createTray({
+  trayId: "secondary",
+  title: "Secondary",
+  icon: { type: "rgba", data: [0, 0, 0, 0], width: 1, height: 1 },
+}, { space: defaultSpace.space });
+```
+
+`createTray()` resolves the broker default space when no explicit target is provided. If you already know the target, pass `space: defaultSpace.space` in the second argument instead of relying on default-space lookup.
+
 Run the human-visible daemon tray example:
 
 ```bash

package/dist/cli.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { t as createClient } from "./client-BBJON7c4.mjs";
+import { t as createClient } from "./client-Db-tztnj.mjs";
 import { a as inspectDaemon, c as stopDaemon, i as createNodeDaemonDriver, n as resolveDaemonPaths, o as restartDaemon, r as readPackageVersion, s as startDaemon, t as connectLocalBroker } from "./local-broker-mQmeVLF5.mjs";
 import { homedir } from "node:os";
 import { fileURLToPath } from "node:url";

package/dist/{client-D-lSB3Rd.d.mts → client-C_zT7PEt.d.mts}

@@ -6,6 +6,7 @@ interface OpenTrayTransport {
 }
 interface OpenTrayClient {
   createSpace(options: SpaceOptions): Promise<SpaceHandle>;
+  resolveDefaultSpace(): Promise<SpaceHandle>;
   /** @deprecated Use `createSpace`. */
   createSurface(options: SpaceOptions): Promise<SpaceHandle>;
 }
@@ -32,4 +33,4 @@ declare const createSurfaceHandle: (transport: OpenTrayTransport, space: SpaceRe
 declare const createTrayHandle: (transport: OpenTrayTransport, space: SpaceRef, trayId: TrayId, nextRequestId?: () => RequestId) => TrayHandle;
 //#endregion
 export { SurfaceHandle as a, createInitFrame as c, createTrayHandle as d, SpaceHandle as i, createSpaceHandle as l, OpenTrayClient as n, TrayHandle as o, OpenTrayTransport as r, createClient as s, CreateClientOptions as t, createSurfaceHandle as u };
-//# sourceMappingURL=client-D-lSB3Rd.d.mts.map
+//# sourceMappingURL=client-C_zT7PEt.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client-C_zT7PEt.d.mts","names":[],"sources":["../src/client.ts"],"mappings":";;;UAYiB,iBAAA;EACf,OAAA,CAAQ,KAAA,EAAO,kBAAA,GAAqB,OAAA,CAAQ,WAAA;AAAA;AAAA,UAG7B,cAAA;EACf,WAAA,CAAY,OAAA,EAAS,YAAA,GAAe,OAAA,CAAQ,WAAA;EAC5C,mBAAA,IAAuB,OAAA,CAAQ,WAAA;EALa;EAO5C,aAAA,CAAc,OAAA,EAAS,YAAA,GAAe,OAAA,CAAQ,WAAA;AAAA;AAAA,UAG/B,WAAA;EACf,KAAA,EAAO,QAAA;EACP,UAAA,CAAW,OAAA,EAAS,WAAA,GAAc,OAAA,CAAQ,UAAA;AAAA;;KAIhC,aAAA,GAAgB,WAAW;AAAA,UAEtB,UAAA;EACf,KAAA,EAAO,QAAA;EACP,MAAA,EAAQ,MAAA;EACR,gBAAA,CAAiB,GAAA,UAAa,IAAA,YAAgB,OAAA;EAC9C,OAAA,IAAW,OAAA;AAAA;AAAA,cAGA,eAAA,GAAmB,aAAA,aAAwB,WAItD;AAAA,UAEe,mBAAA;EACf,eAAe;AAAA;AAAA,cAGJ,YAAA,GACX,SAAA,EAAW,iBAAA,EACX,OAAA,GAAS,mBAAA,KACR,cAAA;AAAA,cA6BU,iBAAA,GACX,SAAA,EAAW,iBAAA,EACX,KAAA,EAAO,QAAA,EACP,aAAA,SAAqB,SAAA,KACpB,WAAA;;cAgBU,mBAAA,GAAmB,SAAA,EAnBnB,iBAAA,EAAiB,KAAA,EACrB,QAAA,EAAQ,aAAA,SACM,SAAA,KACpB,WAAA;AAAA,cAkBU,gBAAA,GACX,SAAA,EAAW,iBAAA,EACX,KAAA,EAAO,QAAA,EACP,MAAA,EAAQ,MAAA,EACR,aAAA,SAAqB,SAAA,KACpB,UAAA"}

package/dist/{client-BBJON7c4.mjs → client-Db-tztnj.mjs}

@@ -17,6 +17,14 @@ const createClient = (transport, options = {}) => {
 			}), 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);
 		}
@@ -90,4 +98,4 @@ const requestIdOf = (frame) => {
 //#endregion
 export { createTrayHandle as a, createSurfaceHandle as i, createInitFrame as n, createSpaceHandle as r, createClient as t };
 
-//# sourceMappingURL=client-BBJON7c4.mjs.map
+//# sourceMappingURL=client-Db-tztnj.mjs.map

package/dist/client-Db-tztnj.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-Db-tztnj.mjs","names":[],"sources":["../src/client.ts"],"sourcesContent":["import {\n  PROTOCOL_VERSION,\n  type ClientFrame,\n  type ClientRequestFrame,\n  type RequestId,\n  type ServerFrame,\n  type SpaceOptions,\n  type SpaceRef,\n  type TrayId,\n  type TrayOptions,\n} from \"@opentray/spec\";\n\nexport interface OpenTrayTransport {\n  request(frame: ClientRequestFrame): Promise<ServerFrame>;\n}\n\nexport interface OpenTrayClient {\n  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\n/** @deprecated Use `SpaceHandle`. */\nexport type SurfaceHandle = SpaceHandle;\n\nexport interface TrayHandle {\n  space: SpaceRef;\n  trayId: TrayId;\n  commandExtension(ext: string, data: unknown): Promise<void>;\n  destroy(): Promise<void>;\n}\n\nexport const createInitFrame = (clientVersion: string): ClientFrame => ({\n  type: \"init\",\n  protocolVersion: PROTOCOL_VERSION,\n  clientVersion,\n});\n\nexport interface CreateClientOptions {\n  requestIdPrefix?: string;\n}\n\nexport const createClient = (\n  transport: OpenTrayTransport,\n  options: CreateClientOptions = {},\n): OpenTrayClient => {\n  const nextRequestId = createRequestIdFactory(options.requestIdPrefix ?? \"opentray\");\n\n  return {\n    async 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 const createSpaceHandle = (\n  transport: OpenTrayTransport,\n  space: SpaceRef,\n  nextRequestId: () => RequestId = createRequestIdFactory(\"opentray\"),\n): SpaceHandle => ({\n  space,\n  async createTray(options: TrayOptions): Promise<TrayHandle> {\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/** @deprecated Use `createSpaceHandle`. */\nexport const createSurfaceHandle = createSpaceHandle;\n\nexport const createTrayHandle = (\n  transport: OpenTrayTransport,\n  space: SpaceRef,\n  trayId: TrayId,\n  nextRequestId: () => RequestId = createRequestIdFactory(\"opentray\"),\n): TrayHandle => ({\n  space,\n  trayId,\n  async commandExtension(ext: string, data: unknown): Promise<void> {\n    const requestId = nextRequestId();\n    const response = await transport.request({\n      type: \"ext-command\",\n      requestId,\n      spaceId: space.spaceId,\n      trayId,\n      ext,\n      data,\n    });\n    expectResponse(response, requestId, \"ack\");\n  },\n  async destroy(): Promise<void> {\n    const requestId = nextRequestId();\n    const response = await transport.request({\n      type: \"destroy-tray\",\n      requestId,\n      spaceId: space.spaceId,\n      trayId,\n    });\n    expectResponse(response, requestId, \"ack\");\n  },\n});\n\nconst createRequestIdFactory = (prefix: string): (() => RequestId) => {\n  let next = 1;\n  return () => {\n    const requestId = `${prefix}-${next}`;\n    next += 1;\n    return requestId;\n  };\n};\n\nconst expectResponse = <TType extends ServerFrame[\"type\"]>(\n  frame: ServerFrame,\n  requestId: RequestId,\n  type: TType,\n): Extract<ServerFrame, { type: TType }> => {\n  if (frame.type === \"error\") {\n    throw new Error(`${frame.code}: ${frame.message}`);\n  }\n  if (frame.type !== type) {\n    throw new Error(`expected ${type} for ${requestId}, received ${frame.type}`);\n  }\n  if (requestIdOf(frame) !== requestId) {\n    throw new Error(`expected response for ${requestId}, received ${requestIdOf(frame) ?? \"none\"}`);\n  }\n  return frame as Extract<ServerFrame, { type: TType }>;\n};\n\nconst requestIdOf = (frame: ServerFrame): RequestId | undefined => {\n  switch (frame.type) {\n    case \"space-created\":\n    case \"default-space\":\n    case \"tray-created\":\n    case \"ack\":\n    case \"daemon-health\":\n      return frame.requestId;\n    case \"error\":\n      return frame.requestId;\n    case \"ready\":\n    case \"event\":\n    case \"ext-event\":\n      return undefined;\n  }\n};\n"],"mappings":";;AAsCA,MAAa,mBAAmB,mBAAwC;CACtE,MAAM;CACN,iBAAiB;CACjB;AACF;AAMA,MAAa,gBACX,WACA,UAA+B,CAAC,MACb;CACnB,MAAM,gBAAgB,uBAAuB,QAAQ,mBAAmB,UAAU;CAElF,OAAO;EACL,MAAM,YAAY,cAAoC;GACpD,MAAM,YAAY,cAAc;GAMhC,MAAM,QAAQ,eAAe,MALN,UAAU,QAAQ;IACvC,MAAM;IACN;IACA,GAAG;GACL,CAAC,GACsC,WAAW,eAAe,EAAE;GACnE,OAAO,kBAAkB,WAAW,OAAO,aAAa;EAC1D;EACA,MAAM,sBAA4C;GAChD,MAAM,YAAY,cAAc;GAKhC,MAAM,QAAQ,eAAe,MAJN,UAAU,QAAQ;IACvC,MAAM;IACN;GACF,CAAC,GACsC,WAAW,eAAe,EAAE;GACnE,OAAO,kBAAkB,WAAW,OAAO,aAAa;EAC1D;EACA,MAAM,cAAc,cAAoC;GACtD,OAAO,KAAK,YAAY,YAAY;EACtC;CACF;AACF;AAEA,MAAa,qBACX,WACA,OACA,gBAAiC,uBAAuB,UAAU,OACjD;CACjB;CACA,MAAM,WAAW,SAA2C;EAC1D,MAAM,YAAY,cAAc;EAQhC,OAAO,iBAAiB,WAAW,OADrB,eAAe,MANN,UAAU,QAAQ;GACvC,MAAM;GACN;GACA;GACA,MAAM;EACR,CAAC,GACsC,WAAW,cACJ,EAAE,QAAQ,aAAa;CACvE;AACF;;AAGA,MAAa,sBAAsB;AAEnC,MAAa,oBACX,WACA,OACA,QACA,gBAAiC,uBAAuB,UAAU,OAClD;CAChB;CACA;CACA,MAAM,iBAAiB,KAAa,MAA8B;EAChE,MAAM,YAAY,cAAc;EAShC,eAAe,MARQ,UAAU,QAAQ;GACvC,MAAM;GACN;GACA,SAAS,MAAM;GACf;GACA;GACA;EACF,CAAC,GACwB,WAAW,KAAK;CAC3C;CACA,MAAM,UAAyB;EAC7B,MAAM,YAAY,cAAc;EAOhC,eAAe,MANQ,UAAU,QAAQ;GACvC,MAAM;GACN;GACA,SAAS,MAAM;GACf;EACF,CAAC,GACwB,WAAW,KAAK;CAC3C;AACF;AAEA,MAAM,0BAA0B,WAAsC;CACpE,IAAI,OAAO;CACX,aAAa;EACX,MAAM,YAAY,GAAG,OAAO,GAAG;EAC/B,QAAQ;EACR,OAAO;CACT;AACF;AAEA,MAAM,kBACJ,OACA,WACA,SAC0C;CAC1C,IAAI,MAAM,SAAS,SACjB,MAAM,IAAI,MAAM,GAAG,MAAM,KAAK,IAAI,MAAM,SAAS;CAEnD,IAAI,MAAM,SAAS,MACjB,MAAM,IAAI,MAAM,YAAY,KAAK,OAAO,UAAU,aAAa,MAAM,MAAM;CAE7E,IAAI,YAAY,KAAK,MAAM,WACzB,MAAM,IAAI,MAAM,yBAAyB,UAAU,aAAa,YAAY,KAAK,KAAK,QAAQ;CAEhG,OAAO;AACT;AAEA,MAAM,eAAe,UAA8C;CACjE,QAAQ,MAAM,MAAd;EACE,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK,iBACH,OAAO,MAAM;EACf,KAAK,SACH,OAAO,MAAM;EACf,KAAK;EACL,KAAK;EACL,KAAK,aACH;CACJ;AACF"}

package/dist/index.d.mts

@@ -1,3 +1,23 @@
-import { a as SurfaceHandle, c as createInitFrame, d as createTrayHandle, i as SpaceHandle, l as createSpaceHandle, n as OpenTrayClient, o as TrayHandle, r as OpenTrayTransport, s as createClient, t as CreateClientOptions, u as createSurfaceHandle } from "./client-D-lSB3Rd.mjs";
-import { BrokerEndpointIdentity, BrokerEndpointIdentityOptions, PROTOCOL_VERSION, createBrokerEndpointIdentity, formatBrokerEndpointName, formatBrokerStateRoot, formatUnixSocketPath, formatWindowsPipeName, isSupportedProtocolVersion } from "@opentray/spec";
-export { type BrokerEndpointIdentity, type BrokerEndpointIdentityOptions, type CreateClientOptions, type OpenTrayClient, type OpenTrayTransport, PROTOCOL_VERSION, type SpaceHandle, type SurfaceHandle, type TrayHandle, createBrokerEndpointIdentity, createClient, createInitFrame, createSpaceHandle, createSurfaceHandle, createTrayHandle, formatBrokerEndpointName, formatBrokerStateRoot, formatUnixSocketPath, formatWindowsPipeName, isSupportedProtocolVersion };
+import { a as SurfaceHandle, c as createInitFrame, d as createTrayHandle, i as SpaceHandle, l as createSpaceHandle, n as OpenTrayClient, o as TrayHandle, r as OpenTrayTransport, s as createClient, t as CreateClientOptions, u as createSurfaceHandle } from "./client-C_zT7PEt.mjs";
+import { BrokerEndpointIdentity, BrokerEndpointIdentityOptions, PROTOCOL_VERSION, SpaceOptions, SpaceRef, TrayOptions, createBrokerEndpointIdentity, formatBrokerEndpointName, formatBrokerStateRoot, formatUnixSocketPath, formatWindowsPipeName, isSupportedProtocolVersion } from "@opentray/spec";
+
+//#region src/sdk.d.ts
+interface BrokerConnectOptions {
+  endpoint?: string;
+  homeDir?: string;
+  packageVersion?: string;
+  protocolVersion?: number;
+  clientVersion?: string;
+  autoStart?: boolean;
+}
+interface CreateTrayOptions extends BrokerConnectOptions {
+  space?: SpaceRef;
+}
+declare const createSpace: (options: SpaceOptions, brokerOptions?: BrokerConnectOptions) => Promise<SpaceHandle>;
+/** @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>;
+//#endregion
+export { type BrokerConnectOptions, type BrokerEndpointIdentity, type BrokerEndpointIdentityOptions, type CreateClientOptions, type CreateTrayOptions, type OpenTrayClient, type OpenTrayTransport, PROTOCOL_VERSION, type SpaceHandle, type SurfaceHandle, 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

@@ -0,0 +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"}

package/dist/index.mjs

@@ -1,3 +1,21 @@
-import { a as createTrayHandle, i as createSurfaceHandle, n as createInitFrame, r as createSpaceHandle, t as createClient } from "./client-BBJON7c4.mjs";
+import { a as createTrayHandle, i as createSurfaceHandle, n as createInitFrame, r as createSpaceHandle, t as createClient } from "./client-Db-tztnj.mjs";
+import { t as connectLocalBroker } from "./local-broker-mQmeVLF5.mjs";
 import { PROTOCOL_VERSION, createBrokerEndpointIdentity, formatBrokerEndpointName, formatBrokerStateRoot, formatUnixSocketPath, formatWindowsPipeName, isSupportedProtocolVersion } from "@opentray/spec";
-export { PROTOCOL_VERSION, createBrokerEndpointIdentity, createClient, createInitFrame, createSpaceHandle, createSurfaceHandle, createTrayHandle, formatBrokerEndpointName, formatBrokerStateRoot, formatUnixSocketPath, formatWindowsPipeName, isSupportedProtocolVersion };
+//#region src/sdk.ts
+const createSpace = async (options, brokerOptions = {}) => {
+	return createClient(await connectLocalBroker(brokerOptions)).createSpace(options);
+};
+/** @deprecated Use `createSpace`. */
+const createSurface = async (options, brokerOptions = {}) => createSpace(options, brokerOptions);
+const resolveDefaultSpace = async (brokerOptions = {}) => {
+	return createClient(await connectLocalBroker(brokerOptions)).resolveDefaultSpace();
+};
+const createTray = async (options, brokerOptions = {}) => {
+	const { space, ...connectOptions } = brokerOptions;
+	const connection = await connectLocalBroker(connectOptions);
+	return (space ? createSpaceHandle(connection, space) : await createClient(connection).resolveDefaultSpace()).createTray(options);
+};
+//#endregion
+export { PROTOCOL_VERSION, createBrokerEndpointIdentity, createClient, createInitFrame, createSpace, createSpaceHandle, createSurface, createSurfaceHandle, createTray, createTrayHandle, formatBrokerEndpointName, formatBrokerStateRoot, formatUnixSocketPath, formatWindowsPipeName, isSupportedProtocolVersion, resolveDefaultSpace };
+
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +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"}

package/dist/node.d.mts

@@ -1,4 +1,4 @@
-import { r as OpenTrayTransport } from "./client-D-lSB3Rd.mjs";
+import { r as OpenTrayTransport } from "./client-C_zT7PEt.mjs";
 import { BrokerEndpointIdentityOptions, ServerFrame } from "@opentray/spec";
 
 //#region src/daemon/paths.d.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opentray",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "Developer-facing OpenTray SDK and CLI package.",
   "type": "module",
   "license": "MIT",
@@ -36,12 +36,12 @@
     "vitest": "^4.1.7"
   },
   "optionalDependencies": {
-    "@opentray/darwin-arm64": "0.3.0",
-    "@opentray/darwin-x64": "0.3.0",
-    "@opentray/linux-arm64": "0.3.0",
-    "@opentray/linux-x64": "0.3.0",
-    "@opentray/windows-arm64": "0.3.0",
-    "@opentray/windows-x64": "0.3.0"
+    "@opentray/darwin-arm64": "0.3.1",
+    "@opentray/darwin-x64": "0.3.1",
+    "@opentray/linux-arm64": "0.3.1",
+    "@opentray/linux-x64": "0.3.1",
+    "@opentray/windows-arm64": "0.3.1",
+    "@opentray/windows-x64": "0.3.1"
   },
   "scripts": {
     "build": "tsdown src/index.ts src/node.ts src/cli.ts --format esm --dts",

package/dist/client-BBJON7c4.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"client-BBJON7c4.mjs","names":[],"sources":["../src/client.ts"],"sourcesContent":["import {\n  PROTOCOL_VERSION,\n  type ClientFrame,\n  type ClientRequestFrame,\n  type RequestId,\n  type ServerFrame,\n  type SpaceOptions,\n  type SpaceRef,\n  type TrayId,\n  type TrayOptions,\n} from \"@opentray/spec\";\n\nexport interface OpenTrayTransport {\n  request(frame: ClientRequestFrame): Promise<ServerFrame>;\n}\n\nexport interface OpenTrayClient {\n  createSpace(options: SpaceOptions): 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\n/** @deprecated Use `SpaceHandle`. */\nexport type SurfaceHandle = SpaceHandle;\n\nexport interface TrayHandle {\n  space: SpaceRef;\n  trayId: TrayId;\n  commandExtension(ext: string, data: unknown): Promise<void>;\n  destroy(): Promise<void>;\n}\n\nexport const createInitFrame = (clientVersion: string): ClientFrame => ({\n  type: \"init\",\n  protocolVersion: PROTOCOL_VERSION,\n  clientVersion,\n});\n\nexport interface CreateClientOptions {\n  requestIdPrefix?: string;\n}\n\nexport const createClient = (\n  transport: OpenTrayTransport,\n  options: CreateClientOptions = {},\n): OpenTrayClient => {\n  const nextRequestId = createRequestIdFactory(options.requestIdPrefix ?? \"opentray\");\n\n  return {\n    async 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 createSurface(spaceOptions): Promise<SpaceHandle> {\n      return this.createSpace(spaceOptions);\n    },\n  };\n};\n\nexport const createSpaceHandle = (\n  transport: OpenTrayTransport,\n  space: SpaceRef,\n  nextRequestId: () => RequestId = createRequestIdFactory(\"opentray\"),\n): SpaceHandle => ({\n  space,\n  async createTray(options: TrayOptions): Promise<TrayHandle> {\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/** @deprecated Use `createSpaceHandle`. */\nexport const createSurfaceHandle = createSpaceHandle;\n\nexport const createTrayHandle = (\n  transport: OpenTrayTransport,\n  space: SpaceRef,\n  trayId: TrayId,\n  nextRequestId: () => RequestId = createRequestIdFactory(\"opentray\"),\n): TrayHandle => ({\n  space,\n  trayId,\n  async commandExtension(ext: string, data: unknown): Promise<void> {\n    const requestId = nextRequestId();\n    const response = await transport.request({\n      type: \"ext-command\",\n      requestId,\n      spaceId: space.spaceId,\n      trayId,\n      ext,\n      data,\n    });\n    expectResponse(response, requestId, \"ack\");\n  },\n  async destroy(): Promise<void> {\n    const requestId = nextRequestId();\n    const response = await transport.request({\n      type: \"destroy-tray\",\n      requestId,\n      spaceId: space.spaceId,\n      trayId,\n    });\n    expectResponse(response, requestId, \"ack\");\n  },\n});\n\nconst createRequestIdFactory = (prefix: string): (() => RequestId) => {\n  let next = 1;\n  return () => {\n    const requestId = `${prefix}-${next}`;\n    next += 1;\n    return requestId;\n  };\n};\n\nconst expectResponse = <TType extends ServerFrame[\"type\"]>(\n  frame: ServerFrame,\n  requestId: RequestId,\n  type: TType,\n): Extract<ServerFrame, { type: TType }> => {\n  if (frame.type === \"error\") {\n    throw new Error(`${frame.code}: ${frame.message}`);\n  }\n  if (frame.type !== type) {\n    throw new Error(`expected ${type} for ${requestId}, received ${frame.type}`);\n  }\n  if (requestIdOf(frame) !== requestId) {\n    throw new Error(`expected response for ${requestId}, received ${requestIdOf(frame) ?? \"none\"}`);\n  }\n  return frame as Extract<ServerFrame, { type: TType }>;\n};\n\nconst requestIdOf = (frame: ServerFrame): RequestId | undefined => {\n  switch (frame.type) {\n    case \"space-created\":\n    case \"default-space\":\n    case \"tray-created\":\n    case \"ack\":\n    case \"daemon-health\":\n      return frame.requestId;\n    case \"error\":\n      return frame.requestId;\n    case \"ready\":\n    case \"event\":\n    case \"ext-event\":\n      return undefined;\n  }\n};\n"],"mappings":";;AAqCA,MAAa,mBAAmB,mBAAwC;CACtE,MAAM;CACN,iBAAiB;CACjB;AACF;AAMA,MAAa,gBACX,WACA,UAA+B,CAAC,MACb;CACnB,MAAM,gBAAgB,uBAAuB,QAAQ,mBAAmB,UAAU;CAElF,OAAO;EACL,MAAM,YAAY,cAAoC;GACpD,MAAM,YAAY,cAAc;GAMhC,MAAM,QAAQ,eAAe,MALN,UAAU,QAAQ;IACvC,MAAM;IACN;IACA,GAAG;GACL,CAAC,GACsC,WAAW,eAAe,EAAE;GACnE,OAAO,kBAAkB,WAAW,OAAO,aAAa;EAC1D;EACA,MAAM,cAAc,cAAoC;GACtD,OAAO,KAAK,YAAY,YAAY;EACtC;CACF;AACF;AAEA,MAAa,qBACX,WACA,OACA,gBAAiC,uBAAuB,UAAU,OACjD;CACjB;CACA,MAAM,WAAW,SAA2C;EAC1D,MAAM,YAAY,cAAc;EAQhC,OAAO,iBAAiB,WAAW,OADrB,eAAe,MANN,UAAU,QAAQ;GACvC,MAAM;GACN;GACA;GACA,MAAM;EACR,CAAC,GACsC,WAAW,cACJ,EAAE,QAAQ,aAAa;CACvE;AACF;;AAGA,MAAa,sBAAsB;AAEnC,MAAa,oBACX,WACA,OACA,QACA,gBAAiC,uBAAuB,UAAU,OAClD;CAChB;CACA;CACA,MAAM,iBAAiB,KAAa,MAA8B;EAChE,MAAM,YAAY,cAAc;EAShC,eAAe,MARQ,UAAU,QAAQ;GACvC,MAAM;GACN;GACA,SAAS,MAAM;GACf;GACA;GACA;EACF,CAAC,GACwB,WAAW,KAAK;CAC3C;CACA,MAAM,UAAyB;EAC7B,MAAM,YAAY,cAAc;EAOhC,eAAe,MANQ,UAAU,QAAQ;GACvC,MAAM;GACN;GACA,SAAS,MAAM;GACf;EACF,CAAC,GACwB,WAAW,KAAK;CAC3C;AACF;AAEA,MAAM,0BAA0B,WAAsC;CACpE,IAAI,OAAO;CACX,aAAa;EACX,MAAM,YAAY,GAAG,OAAO,GAAG;EAC/B,QAAQ;EACR,OAAO;CACT;AACF;AAEA,MAAM,kBACJ,OACA,WACA,SAC0C;CAC1C,IAAI,MAAM,SAAS,SACjB,MAAM,IAAI,MAAM,GAAG,MAAM,KAAK,IAAI,MAAM,SAAS;CAEnD,IAAI,MAAM,SAAS,MACjB,MAAM,IAAI,MAAM,YAAY,KAAK,OAAO,UAAU,aAAa,MAAM,MAAM;CAE7E,IAAI,YAAY,KAAK,MAAM,WACzB,MAAM,IAAI,MAAM,yBAAyB,UAAU,aAAa,YAAY,KAAK,KAAK,QAAQ;CAEhG,OAAO;AACT;AAEA,MAAM,eAAe,UAA8C;CACjE,QAAQ,MAAM,MAAd;EACE,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK,iBACH,OAAO,MAAM;EACf,KAAK,SACH,OAAO,MAAM;EACf,KAAK;EACL,KAAK;EACL,KAAK,aACH;CACJ;AACF"}

package/dist/client-D-lSB3Rd.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"client-D-lSB3Rd.d.mts","names":[],"sources":["../src/client.ts"],"mappings":";;;UAYiB,iBAAA;EACf,OAAA,CAAQ,KAAA,EAAO,kBAAA,GAAqB,OAAA,CAAQ,WAAA;AAAA;AAAA,UAG7B,cAAA;EACf,WAAA,CAAY,OAAA,EAAS,YAAA,GAAe,OAAA,CAAQ,WAAA;EAJ7B;EAMf,aAAA,CAAc,OAAA,EAAS,YAAA,GAAe,OAAA,CAAQ,WAAA;AAAA;AAAA,UAG/B,WAAA;EACf,KAAA,EAAO,QAAA;EACP,UAAA,CAAW,OAAA,EAAS,WAAA,GAAc,OAAA,CAAQ,UAAA;AAAA;;KAIhC,aAAA,GAAgB,WAAW;AAAA,UAEtB,UAAA;EACf,KAAA,EAAO,QAAA;EACP,MAAA,EAAQ,MAAA;EACR,gBAAA,CAAiB,GAAA,UAAa,IAAA,YAAgB,OAAA;EAC9C,OAAA,IAAW,OAAA;AAAA;AAAA,cAGA,eAAA,GAAmB,aAAA,aAAwB,WAItD;AAAA,UAEe,mBAAA;EACf,eAAe;AAAA;AAAA,cAGJ,YAAA,GACX,SAAA,EAAW,iBAAA,EACX,OAAA,GAAS,mBAAA,KACR,cAAA;AAAA,cAoBU,iBAAA,GACX,SAAA,EAAW,iBAAA,EACX,KAAA,EAAO,QAAA,EACP,aAAA,SAAqB,SAAA,KACpB,WAAA;;cAgBU,mBAAA,GAAmB,SAAA,EAnBnB,iBAAA,EAAiB,KAAA,EACrB,QAAA,EAAQ,aAAA,SACM,SAAA,KACpB,WAAA;AAAA,cAkBU,gBAAA,GACX,SAAA,EAAW,iBAAA,EACX,KAAA,EAAO,QAAA,EACP,MAAA,EAAQ,MAAA,EACR,aAAA,SAAqB,SAAA,KACpB,UAAA"}