@opentray/spec 0.5.0 → 0.7.0

package/README.md

@@ -4,27 +4,33 @@ Shared TypeScript protocol and contract package for OpenTray.
 
 ## Role
 
-- Define JSON-RPC payload shapes.
-- Define broker protocol version and endpoint identity helpers.
-- Define public `Space`, `Tray`, `Session`, and extension contract types.
-- Keep protocol types reusable by the `opentray` package and official extensions.
+- Define newline-delimited JSON protocol payload shapes.
+- Define protocol version and endpoint identity helpers.
+- Define public `App`, `Tray`, `Session`, icon projection, menu, tooltip, and extension contract types.
+- Keep protocol types reusable by `opentray` and official extensions.
 
-This package must stay platform-neutral and must not import native implementation packages.
+This package is platform-neutral and must not import native implementation packages.
 
-## Example
+## Tray Contract
 
-Run a protocol parser example that shows successful server-frame parsing and malformed-frame rejection:
-
-```bash
-pnpm --filter @opentray/spec example:parse
-```
-
-Endpoint identity is version-scoped during the current unstable broker stage:
+`TrayOptions` uses `id` as the tray atom identity. Visible tray text belongs to the unified `icon` field:
 
 ```ts
-import { createBrokerEndpointIdentity, formatUnixSocketPath } from "@opentray/spec";
-
-const identity = createBrokerEndpointIdentity({ packageVersion: "0.1.0" });
-console.log(formatUnixSocketPath("~", identity));
-// ~/.opentray/0.1.0/opentray-p1.sock
+import type { Icon, TrayOptions } from "@opentray/spec";
+
+const icon: Icon = {
+  type: "file",
+  path: "./status.png",
+  text: "Status",
+  "icon-only": { type: "file", path: "./status-small.png" },
+  "text-only": "Status",
+  "icon-text": { type: "file", path: "./status.png", text: "Status" },
+};
+
+const tray: TrayOptions = {
+  id: "com.example.status",
+  icon,
+};
 ```
+
+`Space`, `Surface`, `spaceId`, `create-space`, and top-level tray `title` are removed public vocabulary for v0.9.

package/dist/index.d.mts

@@ -1,13 +1,9 @@
 //#region src/index.d.ts
 type SessionId = string;
 type RequestId = string;
-type SpaceId = string;
+type AppId = string;
 type TrayId = string;
 type MenuItemId = number;
-/** @deprecated Use `SessionId`. */
-type LeaseId = SessionId;
-/** @deprecated Use `SpaceId`. */
-type SurfaceId = SpaceId;
 declare const PROTOCOL_VERSION = 1;
 declare const OPENTRAY_PROTOCOL_FAMILY = "opentray-protocol";
 declare const OPENTRAY_PROTOCOL_LINE_MAJOR = 1;
@@ -44,42 +40,59 @@ declare const formatProtocolDistTag: ({
   minor
 }: ProtocolDistTagOptions) => string;
 declare const parseProtocolDistTag: (tag: string) => ProtocolDistTag;
+/**
+ * Neutral caller label used when no usable caller identity can be derived.
+ * Keeps the broker honest instead of impersonating an unrelated application.
+ */
+declare const DEFAULT_CALLER_LABEL = "opentray";
+/**
+ * Maximum length of a sanitized caller label. Keeps socket paths, runtime
+ * directory names, and process titles within platform limits.
+ */
+declare const CALLER_LABEL_MAX_LENGTH = 48;
 interface BrokerEndpointIdentity {
   packageVersion: string;
   protocolVersion: number;
+  callerLabel: string;
 }
 interface BrokerEndpointIdentityOptions {
   packageVersion: string;
   protocolVersion?: number;
+  callerLabel?: string;
 }
+declare const sanitizeCallerLabel: (value: string | undefined) => string;
 declare const createBrokerEndpointIdentity: ({
   packageVersion,
-  protocolVersion
+  protocolVersion,
+  callerLabel
 }: BrokerEndpointIdentityOptions) => BrokerEndpointIdentity;
 declare const isSupportedProtocolVersion: (protocolVersion: number) => boolean;
 declare const formatBrokerEndpointName: (identity: BrokerEndpointIdentity) => string;
 declare const formatBrokerStateRoot: (homeDir: string, identity: BrokerEndpointIdentity) => string;
 declare const formatUnixSocketPath: (homeDir: string, identity: BrokerEndpointIdentity) => string;
 declare const formatWindowsPipeName: (identity: BrokerEndpointIdentity) => string;
-interface SpaceOptions {
-  id?: SpaceId;
-  title?: string;
+/**
+ * Human-readable process title for a broker pinned to a caller. Used by the SDK
+ * spawn path so task managers show the owning application, not a generic name.
+ */
+declare const formatBrokerProcessTitle: (identity: BrokerEndpointIdentity) => string;
+interface AppOptions {
+  id?: AppId;
+  name?: string;
   icon?: Icon;
   default?: boolean;
 }
-/** @deprecated Use `SpaceOptions`. */
-type SurfaceOptions = SpaceOptions;
-interface SpaceRef {
-  spaceId: SpaceId;
+interface AppRef {
+  appId: AppId;
+}
+interface AppIdentity {
+  appId: AppId;
+  appName: string;
 }
-/** @deprecated Use `SpaceRef`. */
-type SurfaceRef = SpaceRef;
 interface TrayOptions {
-  trayId?: TrayId;
-  appId?: string;
-  title?: string;
+  id: string;
   tooltip?: Tooltip;
-  icon: Icon;
+  icon?: Icon;
   menu?: Menu;
 }
 interface Tooltip {
@@ -117,7 +130,7 @@ type MenuItem = {
   enabled?: boolean;
   items: MenuItem[];
 };
-type Icon = {
+type IconImage = {
   type: "rgba";
   data: Uint8Array | number[];
   width: number;
@@ -129,6 +142,18 @@ type Icon = {
   type: "file";
   path: string;
 };
+type SimpleIcon = IconImage & {
+  text?: string;
+};
+type IconText = IconImage & {
+  text: string;
+};
+interface IconCandidates {
+  "icon-only"?: IconImage;
+  "text-only"?: string;
+  "icon-text"?: IconText;
+}
+type Icon = IconCandidates & Partial<SimpleIcon>;
 interface Rect {
   x: number;
   y: number;
@@ -144,29 +169,29 @@ interface TrayBoundsResult {
 type MouseButton = "left" | "right" | "middle";
 type TrayEvent = {
   type: "ready";
-  spaceId: SpaceId;
+  appId: AppId;
 } | {
   type: "menuClick";
-  spaceId: SpaceId;
+  appId: AppId;
   trayId: TrayId;
   itemId: MenuItemId;
 } | {
   type: "trayClick";
-  spaceId: SpaceId;
+  appId: AppId;
   trayId: TrayId;
   button: MouseButton;
   x: number;
   y: number;
 } | {
   type: "trayDoubleClick";
-  spaceId: SpaceId;
+  appId: AppId;
   trayId: TrayId;
   button: MouseButton;
   x: number;
   y: number;
 };
 interface ExtensionScope {
-  spaceId: SpaceId;
+  appId: AppId;
   trayId?: TrayId;
   ext: string;
 }
@@ -174,18 +199,21 @@ interface ExtensionEnvelope<TData = unknown> {
   scope: ExtensionScope;
   data: TData;
 }
-interface DaemonSessionHealth {
+interface RuntimeHostSessionHealth {
   sessionId: number;
-  internalLeaseId?: SessionId;
+  internalSessionId?: SessionId;
   initialized: boolean;
 }
-interface DaemonHealth {
+interface RuntimeHostHealth {
   pid: number;
   packageVersion: string;
   protocolVersion: number;
   endpoint: string;
+  appId: AppId;
+  appName: string;
+  callerLabel: string;
   sessionCount: number;
-  sessions: DaemonSessionHealth[];
+  sessions: RuntimeHostSessionHealth[];
 }
 type ClientFrame = {
   type: "init";
@@ -195,68 +223,62 @@ type ClientFrame = {
   type: "exit";
 };
 type ClientRequestFrame = ({
-  type: "create-space";
+  type: "create-app";
   requestId: RequestId;
-} & SpaceOptions) | {
-  type: "resolve-default-space";
+} & AppOptions) | {
+  type: "resolve-default-app";
   requestId: RequestId;
 } | {
   type: "create-tray";
   requestId: RequestId;
-  space: SpaceRef;
+  app: AppRef;
   tray: TrayOptions;
 } | {
   type: "destroy-tray";
   requestId: RequestId;
-  spaceId: SpaceId;
+  appId: AppId;
   trayId: TrayId;
 } | {
   type: "get-tray-bounds";
   requestId: RequestId;
-  spaceId: SpaceId;
+  appId: AppId;
   trayId: TrayId;
 } | {
   type: "set-tray-menu";
   requestId: RequestId;
-  spaceId: SpaceId;
+  appId: AppId;
   trayId: TrayId;
   menu: Menu;
 } | {
   type: "set-tray-icon";
   requestId: RequestId;
-  spaceId: SpaceId;
+  appId: AppId;
   trayId: TrayId;
   icon: Icon;
 } | {
   type: "set-tray-tooltip";
   requestId: RequestId;
-  spaceId: SpaceId;
+  appId: AppId;
   trayId: TrayId;
   tooltip: Tooltip;
-} | {
-  type: "set-tray-title";
-  requestId: RequestId;
-  spaceId: SpaceId;
-  trayId: TrayId;
-  title: string;
 } | {
   type: "load-ext";
   requestId: RequestId;
-  spaceId: SpaceId;
+  appId: AppId;
   name: string;
   path: string;
   mountId?: string;
 } | {
   type: "ext-command";
   requestId: RequestId;
-  spaceId: SpaceId;
+  appId: AppId;
   trayId: TrayId;
   ext: string;
   data: unknown;
 } | {
   type: "unload-ext";
   requestId: RequestId;
-  spaceId: SpaceId;
+  appId: AppId;
   name: string;
 } | {
   type: "health";
@@ -268,22 +290,22 @@ type ServerFrame = {
   brokerVersion: string;
   sessionId: SessionId;
 } | {
-  type: "space-created";
+  type: "app-created";
   requestId: RequestId;
-  space: SpaceRef;
+  app: AppRef;
 } | {
-  type: "default-space";
+  type: "default-app";
   requestId: RequestId;
-  space: SpaceRef;
+  app: AppRef;
 } | {
   type: "tray-created";
   requestId: RequestId;
-  spaceId: SpaceId;
+  appId: AppId;
   trayId: TrayId;
 } | {
   type: "tray-bounds";
   requestId: RequestId;
-  spaceId: SpaceId;
+  appId: AppId;
   trayId: TrayId;
   bounds: TrayBoundsResult;
 } | {
@@ -294,15 +316,15 @@ type ServerFrame = {
   requestId: RequestId;
   events: ExtensionEnvelope[];
 } | {
-  type: "daemon-health";
+  type: "runtime-host-health";
   requestId: RequestId;
-  health: DaemonHealth;
+  health: RuntimeHostHealth;
 } | {
   type: "event";
   event: TrayEvent;
 } | {
   type: "ext-event";
-  spaceId: SpaceId;
+  appId: AppId;
   trayId: TrayId;
   ext: string;
   data: unknown;
@@ -320,5 +342,5 @@ interface ParseResult<T> {
 declare const parseServerFrame: (line: string) => ParseResult<ServerFrame>;
 declare const isServerFrame: (value: unknown) => value is ServerFrame;
 //#endregion
-export { BrokerEndpointIdentity, BrokerEndpointIdentityOptions, ClientFrame, ClientRequestFrame, DaemonHealth, DaemonSessionHealth, ExtensionEnvelope, ExtensionScope, Icon, LeaseId, Menu, MenuItem, MenuItemId, MouseButton, OPENTRAY_PROTOCOL_FAMILY, OPENTRAY_PROTOCOL_LINE, OPENTRAY_PROTOCOL_LINE_MAJOR, OPENTRAY_PROTOCOL_LINE_MINOR, OpenTrayProtocolLine, PROTOCOL_VERSION, ParseResult, ProtocolDistTag, ProtocolDistTagOptions, ProtocolLineReleaseChannel, Rect, RequestId, ServerFrame, SessionId, SpaceId, SpaceOptions, SpaceRef, SurfaceId, SurfaceOptions, SurfaceRef, Tooltip, TrayBoundsKind, TrayBoundsResult, TrayEvent, TrayId, TrayOptions, compareOpenTrayProtocolLine, createBrokerEndpointIdentity, formatBrokerEndpointName, formatBrokerStateRoot, formatOpenTrayProtocolLine, formatProtocolDistTag, formatUnixSocketPath, formatWindowsPipeName, isOpenTrayProtocolLineCompatible, isProtocolLineReleaseChannel, isServerFrame, isSupportedProtocolVersion, parseProtocolDistTag, parseServerFrame, protocolLineReleaseChannels };
+export { AppId, AppIdentity, AppOptions, AppRef, BrokerEndpointIdentity, BrokerEndpointIdentityOptions, CALLER_LABEL_MAX_LENGTH, ClientFrame, ClientRequestFrame, DEFAULT_CALLER_LABEL, ExtensionEnvelope, ExtensionScope, Icon, IconCandidates, IconImage, IconText, Menu, MenuItem, MenuItemId, MouseButton, OPENTRAY_PROTOCOL_FAMILY, OPENTRAY_PROTOCOL_LINE, OPENTRAY_PROTOCOL_LINE_MAJOR, OPENTRAY_PROTOCOL_LINE_MINOR, OpenTrayProtocolLine, PROTOCOL_VERSION, ParseResult, ProtocolDistTag, ProtocolDistTagOptions, ProtocolLineReleaseChannel, Rect, RequestId, RuntimeHostHealth, RuntimeHostSessionHealth, ServerFrame, SessionId, SimpleIcon, Tooltip, TrayBoundsKind, TrayBoundsResult, TrayEvent, TrayId, TrayOptions, compareOpenTrayProtocolLine, createBrokerEndpointIdentity, formatBrokerEndpointName, formatBrokerProcessTitle, formatBrokerStateRoot, formatOpenTrayProtocolLine, formatProtocolDistTag, formatUnixSocketPath, formatWindowsPipeName, isOpenTrayProtocolLineCompatible, isProtocolLineReleaseChannel, isServerFrame, isSupportedProtocolVersion, parseProtocolDistTag, parseServerFrame, protocolLineReleaseChannels, sanitizeCallerLabel };
 //# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

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

package/dist/index.mjs

@@ -47,26 +47,54 @@ const parseProtocolDistTag = (tag) => {
 		minor
 	};
 };
-const createBrokerEndpointIdentity = ({ packageVersion, protocolVersion = 1 }) => {
+/**
+* Neutral caller label used when no usable caller identity can be derived.
+* Keeps the broker honest instead of impersonating an unrelated application.
+*/
+const DEFAULT_CALLER_LABEL = "opentray";
+/**
+* Maximum length of a sanitized caller label. Keeps socket paths, runtime
+* directory names, and process titles within platform limits.
+*/
+const CALLER_LABEL_MAX_LENGTH = 48;
+const callerLabelAllowedPattern = /[a-z0-9-]+/g;
+const sanitizeCallerLabel = (value) => {
+	if (value !== void 0 && typeof value !== "string") throw new Error(`callerLabel must be a string: ${String(value)}`);
+	const segments = (value ?? "").toLowerCase().match(callerLabelAllowedPattern);
+	if (segments === null || segments.length === 0) return DEFAULT_CALLER_LABEL;
+	const trimmed = segments.join("-").replace(/^-+|-+$/gu, "");
+	if (trimmed.length === 0) return DEFAULT_CALLER_LABEL;
+	return trimmed.slice(0, 48);
+};
+const createBrokerEndpointIdentity = ({ packageVersion, protocolVersion = 1, callerLabel }) => {
 	assertEndpointComponent(packageVersion, "packageVersion");
 	if (!Number.isInteger(protocolVersion) || protocolVersion <= 0) throw new Error(`protocolVersion must be a positive integer: ${protocolVersion}`);
 	return {
 		packageVersion,
-		protocolVersion
+		protocolVersion,
+		callerLabel: sanitizeCallerLabel(callerLabel)
 	};
 };
 const isSupportedProtocolVersion = (protocolVersion) => protocolVersion === 1;
 const formatBrokerEndpointName = (identity) => {
 	assertEndpointIdentity(identity);
-	return `opentray-${identity.packageVersion}-p${identity.protocolVersion}`;
+	return `opentray-${identity.packageVersion}-p${identity.protocolVersion}-${identity.callerLabel}`;
 };
 const formatBrokerStateRoot = (homeDir, identity) => {
 	assertEndpointIdentity(identity);
 	if (homeDir.length === 0) throw new Error("homeDir must not be empty");
-	return `${homeDir.replace(/[\\/]+$/u, "")}/.opentray/${identity.packageVersion}`;
+	return `${homeDir.replace(/[\\/]+$/u, "")}/.opentray/${identity.packageVersion}/${identity.callerLabel}`;
 };
 const formatUnixSocketPath = (homeDir, identity) => `${formatBrokerStateRoot(homeDir, identity)}/opentray-p${identity.protocolVersion}.sock`;
 const formatWindowsPipeName = (identity) => `\\\\.\\pipe\\${formatBrokerEndpointName(identity)}`;
+/**
+* Human-readable process title for a broker pinned to a caller. Used by the SDK
+* spawn path so task managers show the owning application, not a generic name.
+*/
+const formatBrokerProcessTitle = (identity) => {
+	assertEndpointIdentity(identity);
+	return `opentray · ${identity.callerLabel}`;
+};
 const endpointComponentPattern = /^[0-9A-Za-z._+-]+$/u;
 const assertOpenTrayProtocolLine = (line, name) => {
 	assertProtocolLineVersion(line.major, `${name}.major`);
@@ -109,15 +137,15 @@ const isServerFrame = (value) => {
 	if (!isRecord(value) || typeof value.type !== "string") return false;
 	switch (value.type) {
 		case "ready": return typeof value.protocolVersion === "number" && typeof value.brokerVersion === "string" && typeof value.sessionId === "string";
-		case "space-created": return typeof value.requestId === "string" && isRecord(value.space);
-		case "default-space": return typeof value.requestId === "string" && isRecord(value.space);
-		case "tray-created": return typeof value.requestId === "string" && typeof value.spaceId === "string" && typeof value.trayId === "string";
-		case "tray-bounds": return typeof value.requestId === "string" && typeof value.spaceId === "string" && typeof value.trayId === "string" && isTrayBoundsResult(value.bounds);
+		case "app-created": return typeof value.requestId === "string" && isRecord(value.app);
+		case "default-app": return typeof value.requestId === "string" && isRecord(value.app);
+		case "tray-created": return typeof value.requestId === "string" && typeof value.appId === "string" && typeof value.trayId === "string";
+		case "tray-bounds": return typeof value.requestId === "string" && typeof value.appId === "string" && typeof value.trayId === "string" && isTrayBoundsResult(value.bounds);
 		case "ack": return typeof value.requestId === "string";
 		case "ext-command-result": return typeof value.requestId === "string" && Array.isArray(value.events) && value.events.every(isExtensionEnvelope);
-		case "daemon-health": return typeof value.requestId === "string" && isDaemonHealth(value.health);
+		case "runtime-host-health": return typeof value.requestId === "string" && isRuntimeHostHealth(value.health);
 		case "event": return isTrayEvent(value.event);
-		case "ext-event": return typeof value.spaceId === "string" && typeof value.trayId === "string" && typeof value.ext === "string";
+		case "ext-event": return typeof value.appId === "string" && typeof value.trayId === "string" && typeof value.ext === "string";
 		case "error": return (value.requestId === void 0 || typeof value.requestId === "string") && typeof value.code === "string" && typeof value.message === "string";
 		default: return false;
 	}
@@ -125,27 +153,27 @@ const isServerFrame = (value) => {
 const isExtensionEnvelope = (value) => {
 	if (!isRecord(value) || !isRecord(value.scope)) return false;
 	const scope = value.scope;
-	return (typeof scope.spaceId === "string" || typeof scope.surfaceId === "string") && (scope.trayId === void 0 || typeof scope.trayId === "string") && typeof scope.ext === "string" && "data" in value;
+	return typeof scope.appId === "string" && (scope.trayId === void 0 || typeof scope.trayId === "string") && typeof scope.ext === "string" && "data" in value;
 };
-const isDaemonHealth = (value) => {
+const isRuntimeHostHealth = (value) => {
 	if (!isRecord(value)) return false;
-	return typeof value.pid === "number" && typeof value.packageVersion === "string" && typeof value.protocolVersion === "number" && typeof value.endpoint === "string" && typeof value.sessionCount === "number" && Array.isArray(value.sessions) && value.sessions.every(isDaemonSessionHealth);
+	return typeof value.pid === "number" && typeof value.packageVersion === "string" && typeof value.protocolVersion === "number" && typeof value.endpoint === "string" && typeof value.appId === "string" && typeof value.appName === "string" && typeof value.callerLabel === "string" && typeof value.sessionCount === "number" && Array.isArray(value.sessions) && value.sessions.every(isRuntimeHostSessionHealth);
 };
-const isDaemonSessionHealth = (value) => isRecord(value) && typeof value.sessionId === "number" && (value.internalLeaseId === void 0 || typeof value.internalLeaseId === "string") && typeof value.initialized === "boolean";
+const isRuntimeHostSessionHealth = (value) => isRecord(value) && typeof value.sessionId === "number" && (value.internalSessionId === void 0 || typeof value.internalSessionId === "string") && typeof value.initialized === "boolean";
 const isRect = (value) => isRecord(value) && typeof value.x === "number" && typeof value.y === "number" && typeof value.width === "number" && typeof value.height === "number";
 const isTrayBoundsResult = (value) => isRecord(value) && (value.kind === "native" || value.kind === "inferred" || value.kind === "unavailable") && typeof value.source === "string" && (value.rect === null || isRect(value.rect));
 const isTrayEvent = (value) => {
 	if (!isRecord(value) || typeof value.type !== "string") return false;
 	switch (value.type) {
-		case "ready": return typeof value.spaceId === "string";
-		case "menuClick": return typeof value.spaceId === "string" && typeof value.trayId === "string" && typeof value.itemId === "number";
+		case "ready": return typeof value.appId === "string";
+		case "menuClick": return typeof value.appId === "string" && typeof value.trayId === "string" && typeof value.itemId === "number";
 		case "trayClick":
-		case "trayDoubleClick": return typeof value.spaceId === "string" && typeof value.trayId === "string" && isMouseButton(value.button) && typeof value.x === "number" && typeof value.y === "number";
+		case "trayDoubleClick": return typeof value.appId === "string" && typeof value.trayId === "string" && isMouseButton(value.button) && typeof value.x === "number" && typeof value.y === "number";
 		default: return false;
 	}
 };
 const isMouseButton = (value) => value === "left" || value === "right" || value === "middle";
 //#endregion
-export { OPENTRAY_PROTOCOL_FAMILY, OPENTRAY_PROTOCOL_LINE, OPENTRAY_PROTOCOL_LINE_MAJOR, OPENTRAY_PROTOCOL_LINE_MINOR, PROTOCOL_VERSION, compareOpenTrayProtocolLine, createBrokerEndpointIdentity, formatBrokerEndpointName, formatBrokerStateRoot, formatOpenTrayProtocolLine, formatProtocolDistTag, formatUnixSocketPath, formatWindowsPipeName, isOpenTrayProtocolLineCompatible, isProtocolLineReleaseChannel, isServerFrame, isSupportedProtocolVersion, parseProtocolDistTag, parseServerFrame, protocolLineReleaseChannels };
+export { CALLER_LABEL_MAX_LENGTH, DEFAULT_CALLER_LABEL, OPENTRAY_PROTOCOL_FAMILY, OPENTRAY_PROTOCOL_LINE, OPENTRAY_PROTOCOL_LINE_MAJOR, OPENTRAY_PROTOCOL_LINE_MINOR, PROTOCOL_VERSION, compareOpenTrayProtocolLine, createBrokerEndpointIdentity, formatBrokerEndpointName, formatBrokerProcessTitle, formatBrokerStateRoot, formatOpenTrayProtocolLine, formatProtocolDistTag, formatUnixSocketPath, formatWindowsPipeName, isOpenTrayProtocolLineCompatible, isProtocolLineReleaseChannel, isServerFrame, isSupportedProtocolVersion, parseProtocolDistTag, parseServerFrame, protocolLineReleaseChannels, sanitizeCallerLabel };
 
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../src/index.ts"],"sourcesContent":["export type SessionId = string;\nexport type RequestId = string;\nexport type SpaceId = string;\nexport type TrayId = string;\nexport type MenuItemId = number;\n\n/** @deprecated Use `SessionId`. */\nexport type LeaseId = SessionId;\n/** @deprecated Use `SpaceId`. */\nexport type SurfaceId = SpaceId;\n\nexport const PROTOCOL_VERSION = 1;\nexport const OPENTRAY_PROTOCOL_FAMILY = \"opentray-protocol\";\nexport const OPENTRAY_PROTOCOL_LINE_MAJOR = 1;\nexport const OPENTRAY_PROTOCOL_LINE_MINOR = 1;\n\nexport const protocolLineReleaseChannels = [\"stable\", \"alpha\"] as const;\nexport type ProtocolLineReleaseChannel = (typeof protocolLineReleaseChannels)[number];\n\nexport interface OpenTrayProtocolLine {\n  family: typeof OPENTRAY_PROTOCOL_FAMILY;\n  major: number;\n  minor: number;\n}\n\nexport interface ProtocolDistTagOptions {\n  channel: ProtocolLineReleaseChannel;\n  major?: number;\n  minor?: number;\n}\n\nexport interface ProtocolDistTag {\n  channel: ProtocolLineReleaseChannel;\n  major: number;\n  minor: number;\n}\n\nexport const OPENTRAY_PROTOCOL_LINE: OpenTrayProtocolLine = {\n  family: OPENTRAY_PROTOCOL_FAMILY,\n  major: OPENTRAY_PROTOCOL_LINE_MAJOR,\n  minor: OPENTRAY_PROTOCOL_LINE_MINOR,\n};\n\n// Install-time protocol lines can advance by minor version while runtime authority stays numeric.\nexport const compareOpenTrayProtocolLine = (\n  left: OpenTrayProtocolLine,\n  right: OpenTrayProtocolLine,\n): number => {\n  assertOpenTrayProtocolLine(left, \"left\");\n  assertOpenTrayProtocolLine(right, \"right\");\n  if (left.major !== right.major) {\n    return left.major - right.major;\n  }\n  return left.minor - right.minor;\n};\n\nexport const isOpenTrayProtocolLineCompatible = (\n  supported: OpenTrayProtocolLine,\n  required: OpenTrayProtocolLine,\n): boolean => {\n  assertOpenTrayProtocolLine(supported, \"supported\");\n  assertOpenTrayProtocolLine(required, \"required\");\n  return supported.major === required.major && supported.minor >= required.minor;\n};\n\nexport const formatOpenTrayProtocolLine = ({\n  family,\n  major,\n  minor,\n}: OpenTrayProtocolLine = OPENTRAY_PROTOCOL_LINE): string => {\n  assertProtocolLineVersion(major, \"major\");\n  assertProtocolLineVersion(minor, \"minor\");\n  return `${family}/${major}.${minor}`;\n};\n\nexport const isProtocolLineReleaseChannel = (value: string): value is ProtocolLineReleaseChannel =>\n  protocolLineReleaseChannels.includes(value as ProtocolLineReleaseChannel);\n\nexport const formatProtocolDistTag = ({\n  channel,\n  major = OPENTRAY_PROTOCOL_LINE_MAJOR,\n  minor = OPENTRAY_PROTOCOL_LINE_MINOR,\n}: ProtocolDistTagOptions): string => {\n  assertProtocolLineReleaseChannel(channel);\n  assertProtocolLineVersion(major, \"major\");\n  assertProtocolLineVersion(minor, \"minor\");\n  return `${channel}-${major}-${minor}`;\n};\n\nexport const parseProtocolDistTag = (tag: string): ProtocolDistTag => {\n  const match = /^(?<channel>[a-z]+)-(?<major>\\d+)-(?<minor>\\d+)$/u.exec(tag);\n  const groups = match?.groups;\n  if (groups === undefined) {\n    throw new Error(`invalid OpenTray protocol dist-tag: ${tag}`);\n  }\n  const channel = groups.channel;\n  if (channel === undefined || !isProtocolLineReleaseChannel(channel)) {\n    throw new Error(`unsupported OpenTray protocol dist-tag channel: ${channel ?? \"\"}`);\n  }\n  const major = Number(groups.major);\n  const minor = Number(groups.minor);\n  assertProtocolLineVersion(major, \"major\");\n  assertProtocolLineVersion(minor, \"minor\");\n  return { channel, major, minor };\n};\n\nexport interface BrokerEndpointIdentity {\n  packageVersion: string;\n  protocolVersion: number;\n}\n\nexport interface BrokerEndpointIdentityOptions {\n  packageVersion: string;\n  protocolVersion?: number;\n}\n\nexport const createBrokerEndpointIdentity = ({\n  packageVersion,\n  protocolVersion = PROTOCOL_VERSION,\n}: BrokerEndpointIdentityOptions): BrokerEndpointIdentity => {\n  assertEndpointComponent(packageVersion, \"packageVersion\");\n  if (!Number.isInteger(protocolVersion) || protocolVersion <= 0) {\n    throw new Error(`protocolVersion must be a positive integer: ${protocolVersion}`);\n  }\n\n  return {\n    packageVersion,\n    protocolVersion,\n  };\n};\n\nexport const isSupportedProtocolVersion = (protocolVersion: number): boolean =>\n  protocolVersion === PROTOCOL_VERSION;\n\nexport const formatBrokerEndpointName = (identity: BrokerEndpointIdentity): string => {\n  assertEndpointIdentity(identity);\n  return `opentray-${identity.packageVersion}-p${identity.protocolVersion}`;\n};\n\nexport const formatBrokerStateRoot = (homeDir: string, identity: BrokerEndpointIdentity): string => {\n  assertEndpointIdentity(identity);\n  if (homeDir.length === 0) {\n    throw new Error(\"homeDir must not be empty\");\n  }\n\n  const normalizedHome = homeDir.replace(/[\\\\/]+$/u, \"\");\n  return `${normalizedHome}/.opentray/${identity.packageVersion}`;\n};\n\nexport const formatUnixSocketPath = (homeDir: string, identity: BrokerEndpointIdentity): string =>\n  `${formatBrokerStateRoot(homeDir, identity)}/opentray-p${identity.protocolVersion}.sock`;\n\nexport const formatWindowsPipeName = (identity: BrokerEndpointIdentity): string =>\n  `\\\\\\\\.\\\\pipe\\\\${formatBrokerEndpointName(identity)}`;\n\nconst endpointComponentPattern = /^[0-9A-Za-z._+-]+$/u;\n\nconst assertOpenTrayProtocolLine = (line: OpenTrayProtocolLine, name: string): void => {\n  assertProtocolLineVersion(line.major, `${name}.major`);\n  assertProtocolLineVersion(line.minor, `${name}.minor`);\n};\n\nconst assertProtocolLineReleaseChannel = (channel: string): void => {\n  if (!isProtocolLineReleaseChannel(channel)) {\n    throw new Error(`unsupported OpenTray protocol release channel: ${channel}`);\n  }\n};\n\nconst assertProtocolLineVersion = (value: number, name: string): void => {\n  if (!Number.isInteger(value) || value < 0) {\n    throw new Error(`protocol line ${name} must be a non-negative integer: ${value}`);\n  }\n};\n\nconst assertEndpointIdentity = (identity: BrokerEndpointIdentity): void => {\n  assertEndpointComponent(identity.packageVersion, \"packageVersion\");\n  if (!Number.isInteger(identity.protocolVersion) || identity.protocolVersion <= 0) {\n    throw new Error(`protocolVersion must be a positive integer: ${identity.protocolVersion}`);\n  }\n};\n\nconst assertEndpointComponent = (value: string, name: string): void => {\n  if (value.length === 0) {\n    throw new Error(`${name} must not be empty`);\n  }\n  if (!endpointComponentPattern.test(value)) {\n    throw new Error(`${name} contains invalid endpoint characters: ${value}`);\n  }\n};\n\nexport interface SpaceOptions {\n  id?: SpaceId;\n  title?: string;\n  icon?: Icon;\n  default?: boolean;\n}\n\n/** @deprecated Use `SpaceOptions`. */\nexport type SurfaceOptions = SpaceOptions;\n\nexport interface SpaceRef {\n  spaceId: SpaceId;\n}\n\n/** @deprecated Use `SpaceRef`. */\nexport type SurfaceRef = SpaceRef;\n\nexport interface TrayOptions {\n  trayId?: TrayId;\n  appId?: string;\n  title?: string;\n  tooltip?: Tooltip;\n  icon: Icon;\n  menu?: Menu;\n}\n\nexport interface Tooltip {\n  title: string;\n  description: string;\n}\n\nexport interface Menu {\n  items: MenuItem[];\n}\n\nexport type MenuItem =\n  | {\n      type: \"item\";\n      id: MenuItemId;\n      title: string;\n      primaryEvent?: boolean;\n      enabled?: boolean;\n      shortcut?: string;\n    }\n  | {\n      type: \"check\";\n      id: MenuItemId;\n      title: string;\n      enabled?: boolean;\n      checked?: boolean;\n    }\n  | {\n      type: \"radio\";\n      id: MenuItemId;\n      title: string;\n      enabled?: boolean;\n      checked?: boolean;\n      group: number;\n    }\n  | {\n      type: \"separator\";\n    }\n  | {\n      type: \"submenu\";\n      title: string;\n      enabled?: boolean;\n      items: MenuItem[];\n    };\n\nexport type Icon =\n  | { type: \"rgba\"; data: Uint8Array | number[]; width: number; height: number }\n  | { type: \"encoded\"; data: Uint8Array | number[] }\n  | { type: \"file\"; path: string };\n\nexport interface Rect {\n  x: number;\n  y: number;\n  width: number;\n  height: number;\n}\n\nexport type TrayBoundsKind = \"native\" | \"inferred\" | \"unavailable\";\n\nexport interface TrayBoundsResult {\n  kind: TrayBoundsKind;\n  source: string;\n  rect: Rect | null;\n}\n\nexport type MouseButton = \"left\" | \"right\" | \"middle\";\n\nexport type TrayEvent =\n  | { type: \"ready\"; spaceId: SpaceId }\n  | { type: \"menuClick\"; spaceId: SpaceId; trayId: TrayId; itemId: MenuItemId }\n  | { type: \"trayClick\"; spaceId: SpaceId; trayId: TrayId; button: MouseButton; x: number; y: number }\n  | { type: \"trayDoubleClick\"; spaceId: SpaceId; trayId: TrayId; button: MouseButton; x: number; y: number };\n\nexport interface ExtensionScope {\n  spaceId: SpaceId;\n  trayId?: TrayId;\n  ext: string;\n}\n\nexport interface ExtensionEnvelope<TData = unknown> {\n  scope: ExtensionScope;\n  data: TData;\n}\n\nexport interface DaemonSessionHealth {\n  sessionId: number;\n  internalLeaseId?: SessionId;\n  initialized: boolean;\n}\n\nexport interface DaemonHealth {\n  pid: number;\n  packageVersion: string;\n  protocolVersion: number;\n  endpoint: string;\n  sessionCount: number;\n  sessions: DaemonSessionHealth[];\n}\n\nexport type ClientFrame =\n  | { type: \"init\"; protocolVersion: number; clientVersion: string }\n  | ClientRequestFrame\n  | { type: \"exit\" };\n\nexport type ClientRequestFrame =\n  | ({ type: \"create-space\"; requestId: RequestId } & SpaceOptions)\n  | { type: \"resolve-default-space\"; requestId: RequestId }\n  | { type: \"create-tray\"; requestId: RequestId; space: SpaceRef; tray: TrayOptions }\n  | { type: \"destroy-tray\"; requestId: RequestId; spaceId: SpaceId; trayId: TrayId }\n  | { type: \"get-tray-bounds\"; requestId: RequestId; spaceId: SpaceId; trayId: TrayId }\n  | { type: \"set-tray-menu\"; requestId: RequestId; spaceId: SpaceId; trayId: TrayId; menu: Menu }\n  | { type: \"set-tray-icon\"; requestId: RequestId; spaceId: SpaceId; trayId: TrayId; icon: Icon }\n  | { type: \"set-tray-tooltip\"; requestId: RequestId; spaceId: SpaceId; trayId: TrayId; tooltip: Tooltip }\n  | { type: \"set-tray-title\"; requestId: RequestId; spaceId: SpaceId; trayId: TrayId; title: string }\n  | { type: \"load-ext\"; requestId: RequestId; spaceId: SpaceId; name: string; path: string; mountId?: string }\n  | { type: \"ext-command\"; requestId: RequestId; spaceId: SpaceId; trayId: TrayId; ext: string; data: unknown }\n  | { type: \"unload-ext\"; requestId: RequestId; spaceId: SpaceId; name: string }\n  | { type: \"health\"; requestId: RequestId };\n\nexport type ServerFrame =\n  | { type: \"ready\"; protocolVersion: number; brokerVersion: string; sessionId: SessionId }\n  | { type: \"space-created\"; requestId: RequestId; space: SpaceRef }\n  | { type: \"default-space\"; requestId: RequestId; space: SpaceRef }\n  | { type: \"tray-created\"; requestId: RequestId; spaceId: SpaceId; trayId: TrayId }\n  | { type: \"tray-bounds\"; requestId: RequestId; spaceId: SpaceId; trayId: TrayId; bounds: TrayBoundsResult }\n  | { type: \"ack\"; requestId: RequestId }\n  | { type: \"ext-command-result\"; requestId: RequestId; events: ExtensionEnvelope[] }\n  | { type: \"daemon-health\"; requestId: RequestId; health: DaemonHealth }\n  | { type: \"event\"; event: TrayEvent }\n  | { type: \"ext-event\"; spaceId: SpaceId; trayId: TrayId; ext: string; data: unknown }\n  | { type: \"error\"; requestId?: RequestId; code: string; message: string };\n\nexport interface ParseResult<T> {\n  ok: boolean;\n  frame?: T;\n  error?: string;\n}\n\nexport const parseServerFrame = (line: string): ParseResult<ServerFrame> => {\n  try {\n    const value: unknown = JSON.parse(line);\n    if (!isServerFrame(value)) {\n      return { ok: false, error: \"invalid server frame\" };\n    }\n    return { ok: true, frame: value };\n  } catch (error) {\n    return {\n      ok: false,\n      error: error instanceof Error ? error.message : \"unknown parse error\",\n    };\n  }\n};\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n  typeof value === \"object\" && value !== null && !Array.isArray(value);\n\nexport const isServerFrame = (value: unknown): value is ServerFrame => {\n  if (!isRecord(value) || typeof value.type !== \"string\") {\n    return false;\n  }\n\n  switch (value.type) {\n    case \"ready\":\n      return (\n        typeof value.protocolVersion === \"number\" &&\n        typeof value.brokerVersion === \"string\" &&\n        typeof value.sessionId === \"string\"\n      );\n    case \"space-created\":\n      return typeof value.requestId === \"string\" && isRecord(value.space);\n    case \"default-space\":\n      return typeof value.requestId === \"string\" && isRecord(value.space);\n    case \"tray-created\":\n      return (\n        typeof value.requestId === \"string\" &&\n        typeof value.spaceId === \"string\" &&\n        typeof value.trayId === \"string\"\n      );\n    case \"tray-bounds\":\n      return (\n        typeof value.requestId === \"string\" &&\n        typeof value.spaceId === \"string\" &&\n        typeof value.trayId === \"string\" &&\n        isTrayBoundsResult(value.bounds)\n      );\n    case \"ack\":\n      return typeof value.requestId === \"string\";\n    case \"ext-command-result\":\n      return typeof value.requestId === \"string\" && Array.isArray(value.events) && value.events.every(isExtensionEnvelope);\n    case \"daemon-health\":\n      return typeof value.requestId === \"string\" && isDaemonHealth(value.health);\n    case \"event\":\n      return isTrayEvent(value.event);\n    case \"ext-event\":\n      return (\n        typeof value.spaceId === \"string\" &&\n        typeof value.trayId === \"string\" &&\n        typeof value.ext === \"string\"\n      );\n    case \"error\":\n      return (\n        (value.requestId === undefined || typeof value.requestId === \"string\") &&\n        typeof value.code === \"string\" &&\n        typeof value.message === \"string\"\n      );\n    default:\n      return false;\n  }\n};\n\nconst isExtensionEnvelope = (value: unknown): value is ExtensionEnvelope => {\n  if (!isRecord(value) || !isRecord(value.scope)) {\n    return false;\n  }\n  const scope = value.scope as Record<string, unknown>;\n  return (\n    (typeof scope.spaceId === \"string\" || typeof scope.surfaceId === \"string\") &&\n    (scope.trayId === undefined || typeof scope.trayId === \"string\") &&\n    typeof scope.ext === \"string\" &&\n    \"data\" in value\n  );\n};\n\nconst isDaemonHealth = (value: unknown): value is DaemonHealth => {\n  if (!isRecord(value)) {\n    return false;\n  }\n\n  return (\n    typeof value.pid === \"number\" &&\n    typeof value.packageVersion === \"string\" &&\n    typeof value.protocolVersion === \"number\" &&\n    typeof value.endpoint === \"string\" &&\n    typeof value.sessionCount === \"number\" &&\n    Array.isArray(value.sessions) &&\n    value.sessions.every(isDaemonSessionHealth)\n  );\n};\n\nconst isDaemonSessionHealth = (value: unknown): value is DaemonSessionHealth =>\n  isRecord(value) &&\n  typeof value.sessionId === \"number\" &&\n  (value.internalLeaseId === undefined || typeof value.internalLeaseId === \"string\") &&\n  typeof value.initialized === \"boolean\";\n\nconst isRect = (value: unknown): value is Rect =>\n  isRecord(value) &&\n  typeof value.x === \"number\" &&\n  typeof value.y === \"number\" &&\n  typeof value.width === \"number\" &&\n  typeof value.height === \"number\";\n\nconst isTrayBoundsResult = (value: unknown): value is TrayBoundsResult =>\n  isRecord(value) &&\n  (value.kind === \"native\" || value.kind === \"inferred\" || value.kind === \"unavailable\") &&\n  typeof value.source === \"string\" &&\n  (value.rect === null || isRect(value.rect));\n\nconst isTrayEvent = (value: unknown): value is TrayEvent => {\n  if (!isRecord(value) || typeof value.type !== \"string\") {\n    return false;\n  }\n\n  switch (value.type) {\n    case \"ready\":\n      return typeof value.spaceId === \"string\";\n    case \"menuClick\":\n      return (\n        typeof value.spaceId === \"string\" &&\n        typeof value.trayId === \"string\" &&\n        typeof value.itemId === \"number\"\n      );\n    case \"trayClick\":\n    case \"trayDoubleClick\":\n      return (\n        typeof value.spaceId === \"string\" &&\n        typeof value.trayId === \"string\" &&\n        isMouseButton(value.button) &&\n        typeof value.x === \"number\" &&\n        typeof value.y === \"number\"\n      );\n    default:\n      return false;\n  }\n};\n\nconst isMouseButton = (value: unknown): value is MouseButton =>\n  value === \"left\" || value === \"right\" || value === \"middle\";\n"],"mappings":"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"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/index.ts"],"sourcesContent":["export type SessionId = string;\nexport type RequestId = string;\nexport type AppId = string;\nexport type TrayId = string;\nexport type MenuItemId = number;\n\nexport const PROTOCOL_VERSION = 1;\nexport const OPENTRAY_PROTOCOL_FAMILY = \"opentray-protocol\";\nexport const OPENTRAY_PROTOCOL_LINE_MAJOR = 1;\nexport const OPENTRAY_PROTOCOL_LINE_MINOR = 1;\n\nexport const protocolLineReleaseChannels = [\"stable\", \"alpha\"] as const;\nexport type ProtocolLineReleaseChannel =\n  (typeof protocolLineReleaseChannels)[number];\n\nexport interface OpenTrayProtocolLine {\n  family: typeof OPENTRAY_PROTOCOL_FAMILY;\n  major: number;\n  minor: number;\n}\n\nexport interface ProtocolDistTagOptions {\n  channel: ProtocolLineReleaseChannel;\n  major?: number;\n  minor?: number;\n}\n\nexport interface ProtocolDistTag {\n  channel: ProtocolLineReleaseChannel;\n  major: number;\n  minor: number;\n}\n\nexport const OPENTRAY_PROTOCOL_LINE: OpenTrayProtocolLine = {\n  family: OPENTRAY_PROTOCOL_FAMILY,\n  major: OPENTRAY_PROTOCOL_LINE_MAJOR,\n  minor: OPENTRAY_PROTOCOL_LINE_MINOR,\n};\n\n// Install-time protocol lines can advance by minor version while runtime authority stays numeric.\nexport const compareOpenTrayProtocolLine = (\n  left: OpenTrayProtocolLine,\n  right: OpenTrayProtocolLine\n): number => {\n  assertOpenTrayProtocolLine(left, \"left\");\n  assertOpenTrayProtocolLine(right, \"right\");\n  if (left.major !== right.major) {\n    return left.major - right.major;\n  }\n  return left.minor - right.minor;\n};\n\nexport const isOpenTrayProtocolLineCompatible = (\n  supported: OpenTrayProtocolLine,\n  required: OpenTrayProtocolLine\n): boolean => {\n  assertOpenTrayProtocolLine(supported, \"supported\");\n  assertOpenTrayProtocolLine(required, \"required\");\n  return (\n    supported.major === required.major && supported.minor >= required.minor\n  );\n};\n\nexport const formatOpenTrayProtocolLine = ({\n  family,\n  major,\n  minor,\n}: OpenTrayProtocolLine = OPENTRAY_PROTOCOL_LINE): string => {\n  assertProtocolLineVersion(major, \"major\");\n  assertProtocolLineVersion(minor, \"minor\");\n  return `${family}/${major}.${minor}`;\n};\n\nexport const isProtocolLineReleaseChannel = (\n  value: string\n): value is ProtocolLineReleaseChannel =>\n  protocolLineReleaseChannels.includes(value as ProtocolLineReleaseChannel);\n\nexport const formatProtocolDistTag = ({\n  channel,\n  major = OPENTRAY_PROTOCOL_LINE_MAJOR,\n  minor = OPENTRAY_PROTOCOL_LINE_MINOR,\n}: ProtocolDistTagOptions): string => {\n  assertProtocolLineReleaseChannel(channel);\n  assertProtocolLineVersion(major, \"major\");\n  assertProtocolLineVersion(minor, \"minor\");\n  return `${channel}-${major}-${minor}`;\n};\n\nexport const parseProtocolDistTag = (tag: string): ProtocolDistTag => {\n  const match = /^(?<channel>[a-z]+)-(?<major>\\d+)-(?<minor>\\d+)$/u.exec(tag);\n  const groups = match?.groups;\n  if (groups === undefined) {\n    throw new Error(`invalid OpenTray protocol dist-tag: ${tag}`);\n  }\n  const channel = groups.channel;\n  if (channel === undefined || !isProtocolLineReleaseChannel(channel)) {\n    throw new Error(\n      `unsupported OpenTray protocol dist-tag channel: ${channel ?? \"\"}`\n    );\n  }\n  const major = Number(groups.major);\n  const minor = Number(groups.minor);\n  assertProtocolLineVersion(major, \"major\");\n  assertProtocolLineVersion(minor, \"minor\");\n  return { channel, major, minor };\n};\n\n/**\n * Neutral caller label used when no usable caller identity can be derived.\n * Keeps the broker honest instead of impersonating an unrelated application.\n */\nexport const DEFAULT_CALLER_LABEL = \"opentray\";\n\n/**\n * Maximum length of a sanitized caller label. Keeps socket paths, runtime\n * directory names, and process titles within platform limits.\n */\nexport const CALLER_LABEL_MAX_LENGTH = 48;\n\nconst callerLabelAllowedPattern = /[a-z0-9-]+/g;\n\nexport interface BrokerEndpointIdentity {\n  packageVersion: string;\n  protocolVersion: number;\n  callerLabel: string;\n}\n\nexport interface BrokerEndpointIdentityOptions {\n  packageVersion: string;\n  protocolVersion?: number;\n  callerLabel?: string;\n}\n\nexport const sanitizeCallerLabel = (value: string | undefined): string => {\n  if (value !== undefined && typeof value !== \"string\") {\n    throw new Error(`callerLabel must be a string: ${String(value)}`);\n  }\n  const raw = value ?? \"\";\n  const lowered = raw.toLowerCase();\n  const segments = lowered.match(callerLabelAllowedPattern);\n  if (segments === null || segments.length === 0) {\n    return DEFAULT_CALLER_LABEL;\n  }\n  const joined = segments.join(\"-\");\n  const trimmed = joined.replace(/^-+|-+$/gu, \"\");\n  if (trimmed.length === 0) {\n    return DEFAULT_CALLER_LABEL;\n  }\n  return trimmed.slice(0, CALLER_LABEL_MAX_LENGTH);\n};\n\nexport const createBrokerEndpointIdentity = ({\n  packageVersion,\n  protocolVersion = PROTOCOL_VERSION,\n  callerLabel,\n}: BrokerEndpointIdentityOptions): BrokerEndpointIdentity => {\n  assertEndpointComponent(packageVersion, \"packageVersion\");\n  if (!Number.isInteger(protocolVersion) || protocolVersion <= 0) {\n    throw new Error(\n      `protocolVersion must be a positive integer: ${protocolVersion}`\n    );\n  }\n\n  return {\n    packageVersion,\n    protocolVersion,\n    callerLabel: sanitizeCallerLabel(callerLabel),\n  };\n};\n\nexport const isSupportedProtocolVersion = (protocolVersion: number): boolean =>\n  protocolVersion === PROTOCOL_VERSION;\n\nexport const formatBrokerEndpointName = (\n  identity: BrokerEndpointIdentity\n): string => {\n  assertEndpointIdentity(identity);\n  return `opentray-${identity.packageVersion}-p${identity.protocolVersion}-${identity.callerLabel}`;\n};\n\nexport const formatBrokerStateRoot = (\n  homeDir: string,\n  identity: BrokerEndpointIdentity\n): string => {\n  assertEndpointIdentity(identity);\n  if (homeDir.length === 0) {\n    throw new Error(\"homeDir must not be empty\");\n  }\n\n  const normalizedHome = homeDir.replace(/[\\\\/]+$/u, \"\");\n  return `${normalizedHome}/.opentray/${identity.packageVersion}/${identity.callerLabel}`;\n};\n\nexport const formatUnixSocketPath = (\n  homeDir: string,\n  identity: BrokerEndpointIdentity\n): string =>\n  `${formatBrokerStateRoot(homeDir, identity)}/opentray-p${\n    identity.protocolVersion\n  }.sock`;\n\nexport const formatWindowsPipeName = (\n  identity: BrokerEndpointIdentity\n): string => `\\\\\\\\.\\\\pipe\\\\${formatBrokerEndpointName(identity)}`;\n\n/**\n * Human-readable process title for a broker pinned to a caller. Used by the SDK\n * spawn path so task managers show the owning application, not a generic name.\n */\nexport const formatBrokerProcessTitle = (\n  identity: BrokerEndpointIdentity\n): string => {\n  assertEndpointIdentity(identity);\n  return `opentray · ${identity.callerLabel}`;\n};\n\nconst endpointComponentPattern = /^[0-9A-Za-z._+-]+$/u;\n\nconst assertOpenTrayProtocolLine = (\n  line: OpenTrayProtocolLine,\n  name: string\n): void => {\n  assertProtocolLineVersion(line.major, `${name}.major`);\n  assertProtocolLineVersion(line.minor, `${name}.minor`);\n};\n\nconst assertProtocolLineReleaseChannel = (channel: string): void => {\n  if (!isProtocolLineReleaseChannel(channel)) {\n    throw new Error(\n      `unsupported OpenTray protocol release channel: ${channel}`\n    );\n  }\n};\n\nconst assertProtocolLineVersion = (value: number, name: string): void => {\n  if (!Number.isInteger(value) || value < 0) {\n    throw new Error(\n      `protocol line ${name} must be a non-negative integer: ${value}`\n    );\n  }\n};\n\nconst assertEndpointIdentity = (identity: BrokerEndpointIdentity): void => {\n  assertEndpointComponent(identity.packageVersion, \"packageVersion\");\n  if (\n    !Number.isInteger(identity.protocolVersion) ||\n    identity.protocolVersion <= 0\n  ) {\n    throw new Error(\n      `protocolVersion must be a positive integer: ${identity.protocolVersion}`\n    );\n  }\n};\n\nconst assertEndpointComponent = (value: string, name: string): void => {\n  if (value.length === 0) {\n    throw new Error(`${name} must not be empty`);\n  }\n  if (!endpointComponentPattern.test(value)) {\n    throw new Error(`${name} contains invalid endpoint characters: ${value}`);\n  }\n};\n\nexport interface AppOptions {\n  id?: AppId;\n  name?: string;\n  icon?: Icon;\n  default?: boolean;\n}\n\nexport interface AppRef {\n  appId: AppId;\n}\n\nexport interface AppIdentity {\n  appId: AppId;\n  appName: string;\n}\n\nexport interface TrayOptions {\n  id: string;\n  tooltip?: Tooltip;\n  icon?: Icon;\n  menu?: Menu;\n}\n\nexport interface Tooltip {\n  title: string;\n  description: string;\n}\n\nexport interface Menu {\n  items: MenuItem[];\n}\n\nexport type MenuItem =\n  | {\n      type: \"item\";\n      id: MenuItemId;\n      title: string;\n      primaryEvent?: boolean;\n      enabled?: boolean;\n      shortcut?: string;\n    }\n  | {\n      type: \"check\";\n      id: MenuItemId;\n      title: string;\n      enabled?: boolean;\n      checked?: boolean;\n    }\n  | {\n      type: \"radio\";\n      id: MenuItemId;\n      title: string;\n      enabled?: boolean;\n      checked?: boolean;\n      group: number;\n    }\n  | {\n      type: \"separator\";\n    }\n  | {\n      type: \"submenu\";\n      title: string;\n      enabled?: boolean;\n      items: MenuItem[];\n    };\n\nexport type IconImage =\n  | { type: \"rgba\"; data: Uint8Array | number[]; width: number; height: number }\n  | { type: \"encoded\"; data: Uint8Array | number[] }\n  | { type: \"file\"; path: string };\n\nexport type SimpleIcon = IconImage & { text?: string };\n\nexport type IconText = IconImage & { text: string };\n\nexport interface IconCandidates {\n  \"icon-only\"?: IconImage;\n  \"text-only\"?: string;\n  \"icon-text\"?: IconText;\n}\n\nexport type Icon = IconCandidates & Partial<SimpleIcon>;\n\nexport interface Rect {\n  x: number;\n  y: number;\n  width: number;\n  height: number;\n}\n\nexport type TrayBoundsKind = \"native\" | \"inferred\" | \"unavailable\";\n\nexport interface TrayBoundsResult {\n  kind: TrayBoundsKind;\n  source: string;\n  rect: Rect | null;\n}\n\nexport type MouseButton = \"left\" | \"right\" | \"middle\";\n\nexport type TrayEvent =\n  | { type: \"ready\"; appId: AppId }\n  | { type: \"menuClick\"; appId: AppId; trayId: TrayId; itemId: MenuItemId }\n  | {\n      type: \"trayClick\";\n      appId: AppId;\n      trayId: TrayId;\n      button: MouseButton;\n      x: number;\n      y: number;\n    }\n  | {\n      type: \"trayDoubleClick\";\n      appId: AppId;\n      trayId: TrayId;\n      button: MouseButton;\n      x: number;\n      y: number;\n    };\n\nexport interface ExtensionScope {\n  appId: AppId;\n  trayId?: TrayId;\n  ext: string;\n}\n\nexport interface ExtensionEnvelope<TData = unknown> {\n  scope: ExtensionScope;\n  data: TData;\n}\n\nexport interface RuntimeHostSessionHealth {\n  sessionId: number;\n  internalSessionId?: SessionId;\n  initialized: boolean;\n}\n\nexport interface RuntimeHostHealth {\n  pid: number;\n  packageVersion: string;\n  protocolVersion: number;\n  endpoint: string;\n  appId: AppId;\n  appName: string;\n  callerLabel: string;\n  sessionCount: number;\n  sessions: RuntimeHostSessionHealth[];\n}\n\nexport type ClientFrame =\n  | { type: \"init\"; protocolVersion: number; clientVersion: string }\n  | ClientRequestFrame\n  | { type: \"exit\" };\n\nexport type ClientRequestFrame =\n  | ({ type: \"create-app\"; requestId: RequestId } & AppOptions)\n  | { type: \"resolve-default-app\"; requestId: RequestId }\n  | {\n      type: \"create-tray\";\n      requestId: RequestId;\n      app: AppRef;\n      tray: TrayOptions;\n    }\n  | { type: \"destroy-tray\"; requestId: RequestId; appId: AppId; trayId: TrayId }\n  | {\n      type: \"get-tray-bounds\";\n      requestId: RequestId;\n      appId: AppId;\n      trayId: TrayId;\n    }\n  | {\n      type: \"set-tray-menu\";\n      requestId: RequestId;\n      appId: AppId;\n      trayId: TrayId;\n      menu: Menu;\n    }\n  | {\n      type: \"set-tray-icon\";\n      requestId: RequestId;\n      appId: AppId;\n      trayId: TrayId;\n      icon: Icon;\n    }\n  | {\n      type: \"set-tray-tooltip\";\n      requestId: RequestId;\n      appId: AppId;\n      trayId: TrayId;\n      tooltip: Tooltip;\n    }\n  | {\n      type: \"load-ext\";\n      requestId: RequestId;\n      appId: AppId;\n      name: string;\n      path: string;\n      mountId?: string;\n    }\n  | {\n      type: \"ext-command\";\n      requestId: RequestId;\n      appId: AppId;\n      trayId: TrayId;\n      ext: string;\n      data: unknown;\n    }\n  | { type: \"unload-ext\"; requestId: RequestId; appId: AppId; name: string }\n  | { type: \"health\"; requestId: RequestId };\n\nexport type ServerFrame =\n  | {\n      type: \"ready\";\n      protocolVersion: number;\n      brokerVersion: string;\n      sessionId: SessionId;\n    }\n  | { type: \"app-created\"; requestId: RequestId; app: AppRef }\n  | { type: \"default-app\"; requestId: RequestId; app: AppRef }\n  | { type: \"tray-created\"; requestId: RequestId; appId: AppId; trayId: TrayId }\n  | {\n      type: \"tray-bounds\";\n      requestId: RequestId;\n      appId: AppId;\n      trayId: TrayId;\n      bounds: TrayBoundsResult;\n    }\n  | { type: \"ack\"; requestId: RequestId }\n  | {\n      type: \"ext-command-result\";\n      requestId: RequestId;\n      events: ExtensionEnvelope[];\n    }\n  | {\n      type: \"runtime-host-health\";\n      requestId: RequestId;\n      health: RuntimeHostHealth;\n    }\n  | { type: \"event\"; event: TrayEvent }\n  | {\n      type: \"ext-event\";\n      appId: AppId;\n      trayId: TrayId;\n      ext: string;\n      data: unknown;\n    }\n  | { type: \"error\"; requestId?: RequestId; code: string; message: string };\n\nexport interface ParseResult<T> {\n  ok: boolean;\n  frame?: T;\n  error?: string;\n}\n\nexport const parseServerFrame = (line: string): ParseResult<ServerFrame> => {\n  try {\n    const value: unknown = JSON.parse(line);\n    if (!isServerFrame(value)) {\n      return { ok: false, error: \"invalid server frame\" };\n    }\n    return { ok: true, frame: value };\n  } catch (error) {\n    return {\n      ok: false,\n      error: error instanceof Error ? error.message : \"unknown parse error\",\n    };\n  }\n};\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n  typeof value === \"object\" && value !== null && !Array.isArray(value);\n\nexport const isServerFrame = (value: unknown): value is ServerFrame => {\n  if (!isRecord(value) || typeof value.type !== \"string\") {\n    return false;\n  }\n\n  switch (value.type) {\n    case \"ready\":\n      return (\n        typeof value.protocolVersion === \"number\" &&\n        typeof value.brokerVersion === \"string\" &&\n        typeof value.sessionId === \"string\"\n      );\n    case \"app-created\":\n      return typeof value.requestId === \"string\" && isRecord(value.app);\n    case \"default-app\":\n      return typeof value.requestId === \"string\" && isRecord(value.app);\n    case \"tray-created\":\n      return (\n        typeof value.requestId === \"string\" &&\n        typeof value.appId === \"string\" &&\n        typeof value.trayId === \"string\"\n      );\n    case \"tray-bounds\":\n      return (\n        typeof value.requestId === \"string\" &&\n        typeof value.appId === \"string\" &&\n        typeof value.trayId === \"string\" &&\n        isTrayBoundsResult(value.bounds)\n      );\n    case \"ack\":\n      return typeof value.requestId === \"string\";\n    case \"ext-command-result\":\n      return (\n        typeof value.requestId === \"string\" &&\n        Array.isArray(value.events) &&\n        value.events.every(isExtensionEnvelope)\n      );\n    case \"runtime-host-health\":\n      return (\n        typeof value.requestId === \"string\" && isRuntimeHostHealth(value.health)\n      );\n    case \"event\":\n      return isTrayEvent(value.event);\n    case \"ext-event\":\n      return (\n        typeof value.appId === \"string\" &&\n        typeof value.trayId === \"string\" &&\n        typeof value.ext === \"string\"\n      );\n    case \"error\":\n      return (\n        (value.requestId === undefined ||\n          typeof value.requestId === \"string\") &&\n        typeof value.code === \"string\" &&\n        typeof value.message === \"string\"\n      );\n    default:\n      return false;\n  }\n};\n\nconst isExtensionEnvelope = (value: unknown): value is ExtensionEnvelope => {\n  if (!isRecord(value) || !isRecord(value.scope)) {\n    return false;\n  }\n  const scope = value.scope as Record<string, unknown>;\n  return (\n    typeof scope.appId === \"string\" &&\n    (scope.trayId === undefined || typeof scope.trayId === \"string\") &&\n    typeof scope.ext === \"string\" &&\n    \"data\" in value\n  );\n};\n\nconst isRuntimeHostHealth = (value: unknown): value is RuntimeHostHealth => {\n  if (!isRecord(value)) {\n    return false;\n  }\n\n  return (\n    typeof value.pid === \"number\" &&\n    typeof value.packageVersion === \"string\" &&\n    typeof value.protocolVersion === \"number\" &&\n    typeof value.endpoint === \"string\" &&\n    typeof value.appId === \"string\" &&\n    typeof value.appName === \"string\" &&\n    typeof value.callerLabel === \"string\" &&\n    typeof value.sessionCount === \"number\" &&\n    Array.isArray(value.sessions) &&\n    value.sessions.every(isRuntimeHostSessionHealth)\n  );\n};\n\nconst isRuntimeHostSessionHealth = (\n  value: unknown\n): value is RuntimeHostSessionHealth =>\n  isRecord(value) &&\n  typeof value.sessionId === \"number\" &&\n  (value.internalSessionId === undefined ||\n    typeof value.internalSessionId === \"string\") &&\n  typeof value.initialized === \"boolean\";\n\nconst isRect = (value: unknown): value is Rect =>\n  isRecord(value) &&\n  typeof value.x === \"number\" &&\n  typeof value.y === \"number\" &&\n  typeof value.width === \"number\" &&\n  typeof value.height === \"number\";\n\nconst isTrayBoundsResult = (value: unknown): value is TrayBoundsResult =>\n  isRecord(value) &&\n  (value.kind === \"native\" ||\n    value.kind === \"inferred\" ||\n    value.kind === \"unavailable\") &&\n  typeof value.source === \"string\" &&\n  (value.rect === null || isRect(value.rect));\n\nconst isTrayEvent = (value: unknown): value is TrayEvent => {\n  if (!isRecord(value) || typeof value.type !== \"string\") {\n    return false;\n  }\n\n  switch (value.type) {\n    case \"ready\":\n      return typeof value.appId === \"string\";\n    case \"menuClick\":\n      return (\n        typeof value.appId === \"string\" &&\n        typeof value.trayId === \"string\" &&\n        typeof value.itemId === \"number\"\n      );\n    case \"trayClick\":\n    case \"trayDoubleClick\":\n      return (\n        typeof value.appId === \"string\" &&\n        typeof value.trayId === \"string\" &&\n        isMouseButton(value.button) &&\n        typeof value.x === \"number\" &&\n        typeof value.y === \"number\"\n      );\n    default:\n      return false;\n  }\n};\n\nconst isMouseButton = (value: unknown): value is MouseButton =>\n  value === \"left\" || value === \"right\" || value === \"middle\";\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opentray/spec",
-  "version": "0.5.0",
+  "version": "0.7.0",
   "description": "Shared TypeScript protocol and contract types for OpenTray.",
   "type": "module",
   "license": "MIT",