@sxl-studio/bridge 1.2.0

package/README.md

@@ -0,0 +1,153 @@
+# SXL Studio Bridge
+
+Node.js process that connects **Cursor (or any MCP client)** and **HTTP clients** to the **SXL Studio Figma plugin** while a Remote Connect session is active in the plugin UI.
+
+## What it does
+
+1. **WebSocket** — plugin UI iframe connects here and forwards `remote-command` / results.
+2. **MCP (stdio)** — Cursor Agent calls tools (`export_variables`, `inspect_selection`, …); each tool maps to one plugin command.
+3. **HTTP** — same command queue for scripts and other tools.
+
+Official [Figma MCP](https://developers.figma.com/docs/figma-mcp-server/) does not run your plugin code. Use **both**: Figma MCP for file/design context; **this bridge** for SXL-specific operations (compositions, token export, mappings, etc.).
+
+### Figma MCP vs SXL Bridge (product split)
+
+Figma documents the hosted and desktop MCP in the Help Center: [Guide to the Figma MCP server](https://help.figma.com/hc/en-us/articles/32132100833559-Guide-to-the-Figma-MCP-server). **Remote** MCP is the default in their guidance; some client features (for example write-to-canvas flows in their compatibility matrix) are oriented toward **remote** MCP rather than a local-only server.
+
+| Need | Use |
+|------|-----|
+| Native file operations where Figma’s MCP tools are enough (context, many canvas writes, variables in supported flows) | **Official Figma MCP** (often remote `https://mcp.figma.com/mcp` per Figma docs) |
+| Plugin-only workflows: compositions, plugin token/Git APIs, whitelisted node helpers that run in **this** plugin | **SXL Studio Bridge** + plugin Remote Connect |
+
+Bridge forwards `commandType` + `payload` over WebSocket; **execution is always in the plugin** (whitelist + handlers). Adding an MCP tool in Bridge without the matching plugin handler will not work.
+
+### Version compatibility (npm Bridge ⟷ plugin)
+
+When you add or change remote commands:
+
+1. Implement the command in the **plugin** (`WHITELISTED_COMMANDS`, `remote/canvas/` or `remote/sxl/`, etc.).
+2. Register the matching MCP tool (and payload shape) in **Bridge** `src/tools/`.
+3. Bump **Bridge** semver (`package.json`) and document the minimum **plugin** build users need.
+
+| `@sxl-studio/bridge` (npm) | SXL Studio plugin |
+|---------------------------|-------------------|
+| `1.0.x` | Same-era plugin with base remote node tools (`create_frame`, `set_node_fill`, …) |
+| `1.1.x` | Plugin build that includes `set_node_fill_variable` and extended `create_frame` / `create_text` (`parentId`, Auto Layout–related optional fields) |
+| `1.2.x` | Plugin build that includes Remote module split (`dispatch/`, `canvas/`, `sxl/`), MCP `instructions`, base canvas tools (`create_rectangle`, `set_auto_layout`, `duplicate_subtree`, `create_component_instance`, `apply_documentation_payload`), plus **extended** Remote Connect canvas tools registered from `src/tools/figma-rc-extended.ts`. Bridge **1.2.0+** reads `package.json` for startup version, aligns **timeouts** with plugin `COMMAND_TIMEOUTS`, and validates **`POST /api/command`** bodies (`commandType` + object `payload`). |
+
+The plugin’s own `version` in `Plugin/package.json` may differ from marketing labels; treat **feature alignment** by changelog or release tag, not npm name alone.
+
+### Remote node API strategy
+
+New canvas automation is shipped as **small atomic** remote commands (variable-bound fills, optional `parentId`, Auto Layout fields) so Bridge and HTTP clients stay in sync with the whitelist. A single high-level command such as `generate_palette_documentation` remains a possible future optimization if you want fewer round-trips for one specific workflow.
+
+## Ports
+
+**One TCP port** (`BRIDGE_PORT`, default **`37830`** — avoids many apps that bind `3100` on macOS): plugin **WebSocket**, **HTTP REST** (`/api/*`), and **MCP Streamable HTTP** (`/mcp`) share it. Override with `BRIDGE_PORT=3100 npm start` if you need the legacy port (update plugin build + `mcp.json` to match).
+
+| On port `BRIDGE_PORT` | URL (default) |
+|----------------------|---------------|
+| Plugin UI | `ws://127.0.0.1:37830` |
+| REST | `http://127.0.0.1:37830/api/status`, `POST …/api/command`, … |
+| Cursor MCP | `http://127.0.0.1:37830/mcp` |
+
+### Cursor MCP (recommended)
+
+Same pattern as [Figma’s MCP URL](https://developers.figma.com/docs/figma-mcp-server/local-server-installation/): add **`http://127.0.0.1:37830/mcp`** (or `http://127.0.0.1:{BRIDGE_PORT}/mcp`). **Start Bridge first** (`cd Bridge && npm run build && npm start`, or from repo root `npm run bridge` after `npm run bridge:build`). Then enable Remote Connect in the SXL Studio plugin.
+
+Official **Figma MCP** (`http://127.0.0.1:3845/mcp`) reads design context from the file; it does **not** run SXL Studio plugin commands. For `create_frame`, `export_variables`, compositions, etc., use **this** Bridge MCP (or `POST /api/command`).
+
+## Run locally
+
+```bash
+cd Bridge
+npm install
+npm run build
+node dist/index.js
+```
+
+If you see **`EADDRINUSE`**, pick a free port: `BRIDGE_PORT=39999 npm start`, then use **`http://127.0.0.1:39999/mcp`** in Cursor and rebuild the plugin so `remoteBridge.ts` default matches (or keep defaults in sync via env in your workflow). Check listeners: `lsof -nP -iTCP:37830 -sTCP:LISTEN`.
+
+The repo **`.cursor/mcp.json`** points Cursor at **`http://127.0.0.1:37830/mcp`**. You must **run Bridge** before opening Agent chat. Optional: stdio spawn via `node scripts/run-sxl-bridge.mjs`. See `Plugin/docs/ru/60-remote-connect.md`.
+
+**MCP + stdout:** the Model Context Protocol uses **stdout** for JSON-RPC. Do not use `console.log` in this process (it corrupts the stream). Use **`console.error`** for diagnostics.
+
+## MCP configuration (Cursor)
+
+Example `.cursor/mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "sxl-studio": {
+      "command": "node",
+      "args": ["/absolute/path/to/repo/Bridge/dist/index.js"],
+      "env": {
+        "BRIDGE_PORT": "37830"
+      }
+    }
+  }
+}
+```
+
+## HTTP API examples
+
+Requires the plugin open in Figma, Remote Connect enabled, and bridge running.
+
+**Status** (JSON includes `mcpStreamableHttp` and `ports`; WebSocket and HTTP use the **same** port number)
+
+```bash
+curl -s http://127.0.0.1:37830/api/status
+```
+
+**Read token file (after you know `fileId` from MCP `list_token_files`)**
+
+```bash
+curl -s -X POST http://127.0.0.1:37830/api/command \
+  -H "Content-Type: application/json" \
+  -d '{"commandType":"get_token_file_content","payload":{"fileId":"tf_..."}}'
+```
+
+**Save token file**
+
+```bash
+curl -s -X POST http://127.0.0.1:37830/api/command \
+  -H "Content-Type: application/json" \
+  -d '{"commandType":"save_token_file","payload":{"fileId":"tf_...","content":"{}"}}'
+```
+
+**Export composition JSON from current selection**
+
+```bash
+curl -s -X POST http://127.0.0.1:37830/api/command \
+  -H "Content-Type: application/json" \
+  -d '{"commandType":"export_composition_json","payload":{}}'
+```
+
+Optional `payload.nodeId` selects a specific node instead of the first selected node.
+
+## MCP tools (summary)
+
+Registered in `src/mcp-server.ts` via `tools/*.ts`, including:
+
+- **Tokens:** `export_variables`, `reset_diff*`, `reapply_token_bindings`, `cross_file_sync_*`, `get_token_file_content`, `save_token_file`
+- **Composition:** `generate_composition`, `apply_composition`, `preview_composition`, `check_composition_linked`, `inspect_selection`, `export_composition_json`
+- **Data / nodes:** `apply_mapping`, `apply_all_mappings`, `count_apply_targets`, `generate_instances`, `apply_image`, direct node helpers in `data.ts` / `figma-nodes.ts` (including `set_node_fill_variable`, `create_rectangle`, `set_auto_layout`, `duplicate_subtree`, `create_component_instance`, `apply_documentation_payload`, extended `create_frame` / `create_text`)
+- **Git:** `git_pull`, `git_hard_pull`, `git_push`
+- **Diagnostics:** plugin status, selection, drift, Code Connect, etc.
+
+## Development
+
+```bash
+npm run test    # Vitest
+npm run build   # tsc → dist/
+npm run lint    # tsc --noEmit
+```
+
+## Publishing to npm
+
+See [docs/npm-publish.md](docs/npm-publish.md). The package ships only `dist/` and `README.md` (`files` in `package.json`). Example and monorepo-only scripts live under [examples/](examples/).
+
+## Examples (monorepo only)
+
+See [examples/README.md](examples/README.md) for how to write consumer scripts against `POST /api/command` without coupling the npm package to your design-system paths.

package/dist/bridge-version.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Single source of truth: Bridge/package.json (survives `npm version`).
+ */
+export declare function getBridgePackageVersion(): string;

package/dist/bridge-version.js

@@ -0,0 +1,18 @@
+/**
+ * Single source of truth: Bridge/package.json (survives `npm version`).
+ */
+import { readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+let cached = null;
+export function getBridgePackageVersion() {
+    if (cached !== null)
+        return cached;
+    const dir = dirname(fileURLToPath(import.meta.url));
+    const pkgPath = join(dir, "..", "package.json");
+    const raw = readFileSync(pkgPath, "utf8");
+    const v = JSON.parse(raw).version;
+    cached = typeof v === "string" && v.length > 0 ? v : "0.0.0";
+    return cached;
+}
+//# sourceMappingURL=bridge-version.js.map

package/dist/bridge-version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge-version.js","sourceRoot":"","sources":["../src/bridge-version.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,IAAI,MAAM,GAAkB,IAAI,CAAC;AAEjC,MAAM,UAAU,uBAAuB;IACrC,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,MAAM,CAAC;IACnC,MAAM,GAAG,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACpD,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,cAAc,CAAC,CAAC;IAChD,MAAM,GAAG,GAAG,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC1C,MAAM,CAAC,GAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAA0B,CAAC,OAAO,CAAC;IAC5D,MAAM,GAAG,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;IAC7D,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/command-http.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Shared parsing/validation for POST /api/command (REST fallback for MCP).
+ */
+export type ParsedHttpCommand = {
+    ok: true;
+    commandType: string;
+    payload: Record<string, unknown>;
+} | {
+    ok: false;
+    status: 400;
+    error: string;
+};
+export declare function parseHttpCommandBody(rawBody: string): ParsedHttpCommand;

package/dist/command-http.js

@@ -0,0 +1,29 @@
+/**
+ * Shared parsing/validation for POST /api/command (REST fallback for MCP).
+ */
+export function parseHttpCommandBody(rawBody) {
+    let parsed;
+    try {
+        parsed = JSON.parse(rawBody);
+    }
+    catch {
+        return { ok: false, status: 400, error: "Invalid JSON body" };
+    }
+    if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
+        return { ok: false, status: 400, error: "Body must be a JSON object" };
+    }
+    const obj = parsed;
+    const commandType = obj.commandType;
+    if (typeof commandType !== "string" || commandType.length === 0) {
+        return { ok: false, status: 400, error: "Missing or invalid 'commandType' field" };
+    }
+    const payload = obj.payload;
+    if (payload === undefined) {
+        return { ok: true, commandType, payload: {} };
+    }
+    if (typeof payload !== "object" || payload === null || Array.isArray(payload)) {
+        return { ok: false, status: 400, error: "Field 'payload' must be an object when provided" };
+    }
+    return { ok: true, commandType, payload: payload };
+}
+//# sourceMappingURL=command-http.js.map

package/dist/command-http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-http.js","sourceRoot":"","sources":["../src/command-http.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,MAAM,UAAU,oBAAoB,CAAC,OAAe;IAClD,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAY,CAAC;IAC1C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,mBAAmB,EAAE,CAAC;IAChE,CAAC;IAED,IAAI,MAAM,KAAK,IAAI,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3E,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,4BAA4B,EAAE,CAAC;IACzE,CAAC;IAED,MAAM,GAAG,GAAG,MAAiC,CAAC;IAC9C,MAAM,WAAW,GAAG,GAAG,CAAC,WAAW,CAAC;IACpC,IAAI,OAAO,WAAW,KAAK,QAAQ,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAChE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,wCAAwC,EAAE,CAAC;IACrF,CAAC;IAED,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC;IAC5B,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IAChD,CAAC;IACD,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QAC9E,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,iDAAiD,EAAE,CAAC;IAC9F,CAAC;IAED,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,OAAkC,EAAE,CAAC;AAChF,CAAC"}

package/dist/command-queue.d.ts

@@ -0,0 +1,29 @@
+/**
+ * CommandQueue — manages command lifecycle for the Bridge.
+ *
+ * Serial execution: one command at a time.
+ * Each command has a timeout. Results are resolved via promises.
+ */
+import type { CommandResult, CommandStatus } from "./types.js";
+/** Per-command client timeouts (must stay aligned with plugin `COMMAND_TIMEOUTS` where applicable). */
+export declare const BRIDGE_COMMAND_TIMEOUT_MS: Readonly<Record<string, number>>;
+type CommandSender = (command: {
+    commandId: string;
+    commandType: string;
+    payload: Record<string, unknown>;
+}) => boolean;
+export declare class CommandQueue {
+    private queue;
+    private current;
+    private sendCommand;
+    private timeoutHandle;
+    setSender(sender: CommandSender): void;
+    get queueLength(): number;
+    get currentCommand(): string | null;
+    execute(commandType: string, payload?: Record<string, unknown>): Promise<CommandResult>;
+    resolveCommand(commandId: string, status: CommandStatus, result?: unknown, error?: string, events?: unknown[], durationMs?: number): void;
+    cancelAll(): void;
+    private processNext;
+    private clearTimeout;
+}
+export {};

package/dist/command-queue.js

@@ -0,0 +1,168 @@
+/**
+ * CommandQueue — manages command lifecycle for the Bridge.
+ *
+ * Serial execution: one command at a time.
+ * Each command has a timeout. Results are resolved via promises.
+ */
+import { randomUUID } from "node:crypto";
+/** Per-command client timeouts (must stay aligned with plugin `COMMAND_TIMEOUTS` where applicable). */
+export const BRIDGE_COMMAND_TIMEOUT_MS = {
+    export_variables: 120_000,
+    git_pull: 180_000,
+    git_hard_pull: 180_000,
+    git_push: 180_000,
+    generate_composition: 60_000,
+    apply_composition: 30_000,
+    apply_all_mappings: 30_000,
+    export_composition_json: 60_000,
+    get_token_file_content: 30_000,
+    save_token_file: 30_000,
+    duplicate_subtree: 60_000,
+    apply_documentation_payload: 45_000,
+    generate_instances: 30_000,
+    reapply_token_bindings: 30_000,
+    reapply_compositions: 60_000,
+    cross_file_sync_fetch: 30_000,
+    cross_file_sync_apply: 30_000,
+    /** Aligned with Plugin `COMMAND_TIMEOUTS` (remote/types.ts) for canvas-heavy commands */
+    export_as_svg: 60_000,
+    list_available_fonts: 45_000,
+    boolean_operation: 30_000,
+    flatten_nodes: 30_000,
+    get_local_styles: 30_000,
+    list_components: 30_000,
+    find_nodes: 30_000,
+    get_page_structure: 30_000,
+    get_variables: 30_000,
+    import_component_by_key: 30_000,
+};
+const DEFAULT_TIMEOUT = 15_000;
+export class CommandQueue {
+    queue = [];
+    current = null;
+    sendCommand = null;
+    timeoutHandle = null;
+    setSender(sender) {
+        this.sendCommand = sender;
+    }
+    get queueLength() {
+        return this.queue.length;
+    }
+    get currentCommand() {
+        return this.current?.commandType ?? null;
+    }
+    async execute(commandType, payload = {}) {
+        const commandId = randomUUID();
+        const timeout = BRIDGE_COMMAND_TIMEOUT_MS[commandType] ?? DEFAULT_TIMEOUT;
+        return new Promise((resolve) => {
+            const command = {
+                commandId,
+                commandType,
+                payload,
+                status: "pending",
+                createdAt: Date.now(),
+                resolve,
+            };
+            this.queue.push(command);
+            this.processNext();
+            setTimeout(() => {
+                if (command.status === "pending" || command.status === "running") {
+                    command.status = "timeout";
+                    command.completedAt = Date.now();
+                    command.error = `Command "${commandType}" timed out after ${timeout}ms`;
+                    resolve({
+                        commandId,
+                        status: "timeout",
+                        error: command.error,
+                    });
+                    if (this.current?.commandId === commandId) {
+                        this.current = null;
+                        this.clearTimeout();
+                        this.processNext();
+                    }
+                }
+            }, timeout);
+        });
+    }
+    resolveCommand(commandId, status, result, error, events, durationMs) {
+        const target = this.current?.commandId === commandId
+            ? this.current
+            : this.queue.find((c) => c.commandId === commandId);
+        if (!target)
+            return;
+        target.status = status;
+        target.completedAt = Date.now();
+        target.result = result;
+        target.error = error;
+        target.events = events;
+        target.durationMs = durationMs;
+        target.resolve?.({
+            commandId,
+            status,
+            result,
+            error,
+            events,
+            durationMs,
+        });
+        if (this.current?.commandId === commandId) {
+            this.current = null;
+            this.clearTimeout();
+            this.processNext();
+        }
+    }
+    cancelAll() {
+        for (const cmd of this.queue) {
+            if (cmd.status === "pending") {
+                cmd.status = "cancelled";
+                cmd.resolve?.({ commandId: cmd.commandId, status: "cancelled", error: "Session disconnected" });
+            }
+        }
+        this.queue = [];
+        if (this.current && this.current.status === "running") {
+            this.current.status = "cancelled";
+            this.current.resolve?.({ commandId: this.current.commandId, status: "cancelled", error: "Session disconnected" });
+            this.current = null;
+        }
+        this.clearTimeout();
+    }
+    processNext() {
+        if (this.current)
+            return;
+        if (this.queue.length === 0)
+            return;
+        const next = this.queue.shift();
+        if (!next)
+            return;
+        if (next.status !== "pending") {
+            this.processNext();
+            return;
+        }
+        if (!this.sendCommand) {
+            next.status = "failed";
+            next.resolve?.({ commandId: next.commandId, status: "failed", error: "No plugin connected" });
+            this.processNext();
+            return;
+        }
+        const sent = this.sendCommand({
+            commandId: next.commandId,
+            commandType: next.commandType,
+            payload: next.payload,
+        });
+        if (!sent) {
+            next.status = "failed";
+            next.resolve?.({ commandId: next.commandId, status: "failed", error: "Failed to send to plugin" });
+            this.processNext();
+            return;
+        }
+        next.status = "running";
+        next.startedAt = Date.now();
+        this.current = next;
+    }
+    clearTimeout() {
+        if (this.timeoutHandle) {
+            clearTimeout(this.timeoutHandle);
+            this.timeoutHandle = null;
+        }
+    }
+}
+//# sourceMappingURL=command-queue.js.map

package/dist/command-queue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-queue.js","sourceRoot":"","sources":["../src/command-queue.ts"],"names":[],"mappings":"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"}

package/dist/http-api.d.ts

@@ -0,0 +1,8 @@
+/**
+ * HTTP REST API for Bridge server.
+ *
+ * Also serves MCP Streamable HTTP at GET|POST /mcp (recommended for Cursor — same pattern
+ * as Figma's official MCP: add server URL in Cursor settings).
+ */
+import type { BridgeWSServer } from "./ws-server.js";
+export declare function startHttpApi(bridgePort: number, wsServer: BridgeWSServer): Promise<void>;

package/dist/http-api.js

@@ -0,0 +1,146 @@
+/**
+ * HTTP REST API for Bridge server.
+ *
+ * Also serves MCP Streamable HTTP at GET|POST /mcp (recommended for Cursor — same pattern
+ * as Figma's official MCP: add server URL in Cursor settings).
+ */
+import { createServer } from "node:http";
+import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
+import { createBridgeMcpServer } from "./mcp-factory.js";
+import { parseHttpCommandBody } from "./command-http.js";
+function readBody(req) {
+    return new Promise((resolve, reject) => {
+        let body = "";
+        req.on("data", (chunk) => {
+            body += chunk.toString();
+        });
+        req.on("end", () => resolve(body));
+        req.on("error", reject);
+    });
+}
+function sendJson(res, status, data) {
+    res.writeHead(status, {
+        "Content-Type": "application/json",
+        "Access-Control-Allow-Origin": "*",
+        "Access-Control-Allow-Methods": "GET, POST, OPTIONS",
+        "Access-Control-Allow-Headers": "Content-Type, Accept, Authorization, Mcp-Session-Id, mcp-protocol-version",
+    });
+    res.end(JSON.stringify(data, null, 2));
+}
+function pathnameOnly(reqUrl) {
+    try {
+        return new URL(reqUrl || "/", "http://127.0.0.1").pathname;
+    }
+    catch {
+        return "/";
+    }
+}
+export async function startHttpApi(bridgePort, wsServer) {
+    const queue = wsServer.commandQueue;
+    const session = wsServer.session;
+    const mcpHttpServer = createBridgeMcpServer(queue);
+    const mcpTransport = new StreamableHTTPServerTransport({
+        sessionIdGenerator: undefined,
+        enableDnsRebindingProtection: true,
+    });
+    await mcpHttpServer.connect(mcpTransport);
+    /** WebSocket upgrades, REST `/api/*`, and MCP `/mcp` share this single port. */
+    const mcpUrl = `http://127.0.0.1:${bridgePort}/mcp`;
+    const server = createServer(async (req, res) => {
+        const pathname = pathnameOnly(req.url || "");
+        // CORS preflight (REST + MCP)
+        if (req.method === "OPTIONS") {
+            const reqHdr = req.headers["access-control-request-headers"];
+            res.writeHead(204, {
+                "Access-Control-Allow-Origin": "*",
+                "Access-Control-Allow-Methods": "GET, POST, OPTIONS",
+                "Access-Control-Allow-Headers": typeof reqHdr === "string" && reqHdr.length > 0
+                    ? reqHdr
+                    : "Content-Type, Accept, Authorization, Mcp-Session-Id, mcp-protocol-version",
+            });
+            res.end();
+            return;
+        }
+        try {
+            // MCP Streamable HTTP (Cursor, same idea as Figma MCP URL in docs)
+            if (pathname === "/mcp") {
+                let parsedBody = undefined;
+                if (req.method === "POST") {
+                    const raw = await readBody(req);
+                    if (raw.length > 0) {
+                        try {
+                            parsedBody = JSON.parse(raw);
+                        }
+                        catch {
+                            parsedBody = raw;
+                        }
+                    }
+                }
+                await mcpTransport.handleRequest(req, res, parsedBody);
+                return;
+            }
+            // GET /api/status
+            if (req.method === "GET" && pathname === "/api/status") {
+                const status = {
+                    ports: {
+                        websocket: bridgePort,
+                        http: bridgePort,
+                    },
+                    mcpStreamableHttp: mcpUrl,
+                    session: session.info,
+                    queueLength: queue.queueLength,
+                    currentCommand: queue.currentCommand,
+                };
+                sendJson(res, 200, status);
+                return;
+            }
+            // GET /api/session
+            if (req.method === "GET" && pathname === "/api/session") {
+                sendJson(res, 200, session.info);
+                return;
+            }
+            // POST /api/command
+            if (req.method === "POST" && pathname === "/api/command") {
+                if (!session.connected) {
+                    sendJson(res, 503, { error: "No plugin connected" });
+                    return;
+                }
+                const body = await readBody(req);
+                const parsed = parseHttpCommandBody(body);
+                if (!parsed.ok) {
+                    sendJson(res, parsed.status, { error: parsed.error });
+                    return;
+                }
+                const result = await queue.execute(parsed.commandType, parsed.payload);
+                sendJson(res, 200, result);
+                return;
+            }
+            // POST /api/disconnect
+            if (req.method === "POST" && pathname === "/api/disconnect") {
+                wsServer.disconnectPluginSocket(4003, "Disconnected via HTTP API");
+                sendJson(res, 200, { ok: true });
+                return;
+            }
+            sendJson(res, 404, { error: "Not found" });
+        }
+        catch (err) {
+            sendJson(res, 500, { error: String(err) });
+        }
+    });
+    wsServer.attachToHttpServer(server);
+    await new Promise((resolve, reject) => {
+        server.on("error", (err) => {
+            if (err.code === "EADDRINUSE") {
+                console.error(`[Bridge] Port ${bridgePort} already in use (WebSocket + HTTP + MCP share one port).`);
+                console.error(`[Bridge] Fix: quit the other process or set BRIDGE_PORT to a free port (e.g. 3110).`);
+                console.error(`[Bridge] macOS:  lsof -nP -iTCP:${bridgePort} -sTCP:LISTEN`);
+            }
+            reject(err);
+        });
+        server.listen(bridgePort, "127.0.0.1", () => {
+            console.error(`[Bridge] Listening on http://127.0.0.1:${bridgePort}  (REST /api/*, MCP /mcp, plugin ws://127.0.0.1:${bridgePort})`);
+            resolve();
+        });
+    });
+}
+//# sourceMappingURL=http-api.js.map

package/dist/http-api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-api.js","sourceRoot":"","sources":["../src/http-api.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+/**
+ * SXL Studio Bridge — Entry Point
+ *
+ * One TCP port (BRIDGE_PORT): WebSocket upgrades (plugin) + HTTP REST (/api/*) + MCP (/mcp).
+ * Plus MCP over stdio for Cursor when configured to spawn the process.
+ */
+export {};

package/dist/index.js

@@ -0,0 +1,35 @@
+#!/usr/bin/env node
+/**
+ * SXL Studio Bridge — Entry Point
+ *
+ * One TCP port (BRIDGE_PORT): WebSocket upgrades (plugin) + HTTP REST (/api/*) + MCP (/mcp).
+ * Plus MCP over stdio for Cursor when configured to spawn the process.
+ */
+import { getBridgePackageVersion } from "./bridge-version.js";
+import { BridgeWSServer } from "./ws-server.js";
+import { startMcpServer } from "./mcp-server.js";
+import { startHttpApi } from "./http-api.js";
+/** Default below avoids common clashes with other dev tools on 3100 (seen on some macOS setups). */
+const PORT = parseInt(process.env["BRIDGE_PORT"] || "37830", 10);
+async function main() {
+    console.error("=== SXL Studio Bridge ===");
+    console.error(`Version: ${getBridgePackageVersion()}`);
+    console.error(`Single port ${PORT}: ws://127.0.0.1:${PORT}  +  http://127.0.0.1:${PORT}/api/*  +  http://127.0.0.1:${PORT}/mcp`);
+    console.error("");
+    const wsServer = new BridgeWSServer();
+    await startHttpApi(PORT, wsServer);
+    await startMcpServer(wsServer.commandQueue);
+    // Graceful shutdown
+    const shutdown = () => {
+        console.error("\n[Bridge] Shutting down...");
+        wsServer.stop();
+        process.exit(0);
+    };
+    process.on("SIGINT", shutdown);
+    process.on("SIGTERM", shutdown);
+}
+main().catch((err) => {
+    console.error("[Bridge] Fatal error:", err);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;GAKG;AAEH,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C,oGAAoG;AACpG,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,OAAO,EAAE,EAAE,CAAC,CAAC;AAEjE,KAAK,UAAU,IAAI;IACjB,OAAO,CAAC,KAAK,CAAC,2BAA2B,CAAC,CAAC;IAC3C,OAAO,CAAC,KAAK,CAAC,YAAY,uBAAuB,EAAE,EAAE,CAAC,CAAC;IACvD,OAAO,CAAC,KAAK,CACX,eAAe,IAAI,oBAAoB,IAAI,yBAAyB,IAAI,+BAA+B,IAAI,MAAM,CAClH,CAAC;IACF,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAElB,MAAM,QAAQ,GAAG,IAAI,cAAc,EAAE,CAAC;IAEtC,MAAM,YAAY,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAEnC,MAAM,cAAc,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;IAE5C,oBAAoB;IACpB,MAAM,QAAQ,GAAG,GAAG,EAAE;QACpB,OAAO,CAAC,KAAK,CAAC,6BAA6B,CAAC,CAAC;QAC7C,QAAQ,CAAC,IAAI,EAAE,CAAC;QAChB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC;IAEF,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAC/B,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;AAClC,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,OAAO,CAAC,KAAK,CAAC,uBAAuB,EAAE,GAAG,CAAC,CAAC;IAC5C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}