@unbound-app/debugger-protocol 0.1.0 → 0.4.0

package/dist/controller.d.mts

@@ -1,8 +1,15 @@
-import { o as EvalResult } from "./index-DA_F_n3N.mjs";
+import { l as PluginPushResult, o as EvalResult } from "./index-CMW4XGZB.mjs";
+import { AddonManifest } from "@unbound-app/types";
 //#region src/controller.d.ts
+type PluginPush = {
+  addonId: string;
+  bundle: string;
+  manifest: AddonManifest;
+};
 declare class ControllerClient {
   private ws;
   private readonly pending;
+  private readonly pendingPushes;
   private deviceConnected;
   private closed;
   private readonly url;
@@ -20,6 +27,13 @@ declare class ControllerClient {
    * @returns The device's {@link EvalResult}.
    */
   evaluate(code: string): Promise<EvalResult>;
+  /**
+   * @description Pushes a freshly built plugin to the device via the bridge and resolves with the
+   * device's reload outcome. Fails fast if the socket isn't open or the bridge doesn't answer in time.
+   * @param push The addon id plus the built bundle and manifest to swap in.
+   * @returns The device's {@link PluginPushResult}.
+   */
+  pushPlugin(push: PluginPush): Promise<PluginPushResult>;
   private onMessage;
   private onClose;
 }

package/dist/controller.mjs

@@ -7,6 +7,7 @@ const RECONNECT_DELAY_MS = 1e3;
 var ControllerClient = class {
 	ws = null;
 	pending = /* @__PURE__ */ new Map();
+	pendingPushes = /* @__PURE__ */ new Map();
 	deviceConnected = false;
 	closed = false;
 	url;
@@ -35,7 +36,17 @@ var ControllerClient = class {
 				logs: entry.logs
 			});
 		}
+		for (const [id, entry] of this.pendingPushes) {
+			clearTimeout(entry.timer);
+			entry.resolve({
+				type: "plugin-push-result",
+				id,
+				ok: false,
+				error: "Debugger client shut down."
+			});
+		}
 		this.pending.clear();
+		this.pendingPushes.clear();
 	}
 	/** @description Whether a device is currently connected to the bridge. */
 	get isDeviceConnected() {
@@ -82,6 +93,44 @@ var ControllerClient = class {
 			}));
 		});
 	}
+	/**
+	* @description Pushes a freshly built plugin to the device via the bridge and resolves with the
+	* device's reload outcome. Fails fast if the socket isn't open or the bridge doesn't answer in time.
+	* @param push The addon id plus the built bundle and manifest to swap in.
+	* @returns The device's {@link PluginPushResult}.
+	*/
+	pushPlugin(push) {
+		const id = crypto.randomUUID();
+		return new Promise((resolve) => {
+			if (this.ws?.readyState !== WebSocket.OPEN) {
+				resolve({
+					type: "plugin-push-result",
+					id,
+					ok: false,
+					error: "Not connected to the debugger bridge."
+				});
+				return;
+			}
+			const timer = setTimeout(() => {
+				this.pendingPushes.delete(id);
+				resolve({
+					type: "plugin-push-result",
+					id,
+					ok: false,
+					error: `Plugin push timed out after ${EVAL_TIMEOUT_MS}ms.`
+				});
+			}, EVAL_TIMEOUT_MS);
+			this.pendingPushes.set(id, {
+				resolve,
+				timer
+			});
+			this.ws.send(serializeMessage({
+				type: "plugin-push",
+				id,
+				...push
+			}));
+		});
+	}
 	onMessage(raw) {
 		const message = parseMessage(raw);
 		if (!message) return;
@@ -102,6 +151,14 @@ var ControllerClient = class {
 				...message,
 				logs: entry.logs
 			});
+			return;
+		}
+		if (message.type === "plugin-push-result") {
+			const entry = this.pendingPushes.get(message.id);
+			if (!entry) return;
+			clearTimeout(entry.timer);
+			this.pendingPushes.delete(message.id);
+			entry.resolve(message);
 		}
 	}
 	onClose() {

package/dist/{index-DA_F_n3N.d.mts → index-CMW4XGZB.d.mts}

@@ -1,14 +1,16 @@
+import { AddonManifest } from "@unbound-app/types";
 //#region src/index.d.ts
 /**
  * The wire protocol shared by the bridge, the on-device debugger, and any controller (the terminal
  * REPL or an MCP client). Everything crossing a socket is a JSON-encoded {@link BridgeMessage}.
  *
  * Two planes travel over the single device socket:
- *   - control: a controller issues an {@link EvalRequest}; the device answers with the matching
- *     {@link EvalResult} (correlated by `id`).
+ *   - control: a controller issues an {@link EvalRequest} or {@link PluginPushRequest}; the device
+ *     answers with the matching {@link EvalResult} / {@link PluginPushResult} (correlated by `id`).
  *   - telemetry: the device streams {@link LogMessage}s, broadcast to every controller.
  *
- * Device-safe and dependency-free so it can be bundled into the React Native client.
+ * Device-safe and dependency-free at runtime (the manifest type is import-erased) so it can be
+ * bundled into the React Native client.
  */
 /** A request to evaluate code on the device, sent controller → bridge → device. */
 interface EvalRequest {
@@ -34,6 +36,27 @@ interface EvalResult {
    */
   logs?: LogMessage[];
 }
+/**
+ * A request to hot-reload a plugin on the device, sent controller → bridge → device. Carries the
+ * freshly built bundle and manifest so the device swaps them in without a re-fetch.
+ */
+interface PluginPushRequest {
+  type: 'plugin-push';
+  /** Correlation id echoed back on the matching {@link PluginPushResult}. */
+  id: string;
+  addonId: string;
+  bundle: string;
+  manifest: AddonManifest;
+}
+/** The outcome of a {@link PluginPushRequest}, sent device → bridge → the one waiting controller. */
+interface PluginPushResult {
+  type: 'plugin-push-result';
+  /** The `id` of the {@link PluginPushRequest} this answers. */
+  id: string;
+  ok: boolean;
+  /** Present when `!ok`; the reload failure, inspected. */
+  error?: string;
+}
 /** A `console.*` / `nativeLoggingHook` line, streamed device → bridge → all controllers. */
 interface LogMessage {
   type: 'log';
@@ -47,7 +70,7 @@ interface DeviceStatus {
   connected: boolean;
 }
 /** Every framed message on the wire. */
-type BridgeMessage = EvalRequest | EvalResult | LogMessage | DeviceStatus;
+type BridgeMessage = EvalRequest | EvalResult | PluginPushRequest | PluginPushResult | LogMessage | DeviceStatus;
 /** The default port the bridge listens on and controllers dial. */
 declare const DEFAULT_BRIDGE_PORT = 9090;
 /** The query marker a controller appends to its URL so the bridge routes it as a controller, not a device. */
@@ -72,4 +95,4 @@ declare const _default: {
   serializeMessage: typeof serializeMessage;
 };
 //#endregion
-export { EvalRequest as a, _default as c, DeviceStatus as i, parseMessage as l, CONTROLLER_ENDPOINT_MARKER as n, EvalResult as o, DEFAULT_BRIDGE_PORT as r, LogMessage as s, BridgeMessage as t, serializeMessage as u };
+export { EvalRequest as a, PluginPushRequest as c, parseMessage as d, serializeMessage as f, DeviceStatus as i, PluginPushResult as l, CONTROLLER_ENDPOINT_MARKER as n, EvalResult as o, DEFAULT_BRIDGE_PORT as r, LogMessage as s, BridgeMessage as t, _default as u };

package/dist/index.d.mts

@@ -1,2 +1,2 @@
-import { a as EvalRequest, c as _default, i as DeviceStatus, l as parseMessage, n as CONTROLLER_ENDPOINT_MARKER, o as EvalResult, r as DEFAULT_BRIDGE_PORT, s as LogMessage, t as BridgeMessage, u as serializeMessage } from "./index-DA_F_n3N.mjs";
-export { BridgeMessage, CONTROLLER_ENDPOINT_MARKER, DEFAULT_BRIDGE_PORT, DeviceStatus, EvalRequest, EvalResult, LogMessage, _default as default, parseMessage, serializeMessage };
+import { a as EvalRequest, c as PluginPushRequest, d as parseMessage, f as serializeMessage, i as DeviceStatus, l as PluginPushResult, n as CONTROLLER_ENDPOINT_MARKER, o as EvalResult, r as DEFAULT_BRIDGE_PORT, s as LogMessage, t as BridgeMessage, u as _default } from "./index-CMW4XGZB.mjs";
+export { BridgeMessage, CONTROLLER_ENDPOINT_MARKER, DEFAULT_BRIDGE_PORT, DeviceStatus, EvalRequest, EvalResult, LogMessage, PluginPushRequest, PluginPushResult, _default as default, parseMessage, serializeMessage };

package/dist/index.mjs

@@ -6,6 +6,8 @@ const CONTROLLER_ENDPOINT_MARKER = "mcp";
 const MESSAGE_TYPES = /* @__PURE__ */ new Set([
 	"eval",
 	"eval-result",
+	"plugin-push",
+	"plugin-push-result",
 	"log",
 	"device-status"
 ]);

package/package.json

@@ -1,12 +1,17 @@
 {
 	"name": "@unbound-app/debugger-protocol",
-	"version": "0.1.0",
+	"version": "0.4.0",
 	"description": "The wire protocol and controller client shared by the debugger bridge, the on-device client, and the CLI.",
 	"author": {
 		"name": "Mario P.",
 		"email": "contact@marioparaschiv.com",
 		"url": "https://github.com/marioparaschiv"
 	},
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/marioparaschiv/unbound.git",
+		"directory": "packages/debugger-protocol"
+	},
 	"files": [
 		"dist"
 	],
@@ -30,11 +35,9 @@
 		"build": "tsdown"
 	},
 	"dependencies": {
+		"@unbound-app/types": "0.4.0",
 		"zod": "^4.0.0"
 	},
-	"devDependencies": {
-		"tsdown": "^0.22.9"
-	},
 	"peerDependencies": {
 		"typescript": "^5.9.3"
 	}