@gethopp/figma-mcp-bridge 0.0.1

package/dist/bridge.d.ts

@@ -0,0 +1,16 @@
+import type { IncomingMessage } from "node:http";
+import type { Duplex } from "node:stream";
+import type { BridgeResponse } from "./types.js";
+export declare class Bridge {
+    private wss;
+    private conn;
+    private pending;
+    private counter;
+    constructor();
+    handleUpgrade(request: IncomingMessage, socket: Duplex, head: Buffer): void;
+    private handleConnection;
+    send(requestType: string, nodeIds?: string[]): Promise<BridgeResponse>;
+    sendWithParams(requestType: string, nodeIds?: string[], params?: Record<string, unknown>): Promise<BridgeResponse>;
+    private nextId;
+    close(): void;
+}

package/dist/bridge.js

@@ -0,0 +1,103 @@
+import { WebSocketServer, WebSocket } from "ws";
+export class Bridge {
+    wss;
+    conn = null;
+    pending = new Map();
+    counter = 0;
+    constructor() {
+        this.wss = new WebSocketServer({ noServer: true });
+    }
+    handleUpgrade(request, socket, head) {
+        this.wss.handleUpgrade(request, socket, head, (ws) => {
+            this.handleConnection(ws);
+        });
+    }
+    handleConnection(ws) {
+        // Replace existing connection (same behavior as Go version)
+        if (this.conn) {
+            this.conn.close();
+        }
+        this.conn = ws;
+        ws.on("message", (data) => {
+            try {
+                const resp = JSON.parse(data.toString());
+                const pending = this.pending.get(resp.requestId);
+                if (pending) {
+                    clearTimeout(pending.timeout);
+                    this.pending.delete(resp.requestId);
+                    pending.resolve(resp);
+                }
+            }
+            catch {
+                console.error("Invalid response from plugin");
+            }
+        });
+        ws.on("close", () => {
+            if (this.conn === ws) {
+                this.conn = null;
+            }
+        });
+        ws.on("error", (err) => {
+            console.error("WebSocket error:", err.message);
+            if (this.conn === ws) {
+                this.conn = null;
+            }
+        });
+    }
+    send(requestType, nodeIds) {
+        return this.sendWithParams(requestType, nodeIds);
+    }
+    sendWithParams(requestType, nodeIds, params) {
+        return new Promise((resolve, reject) => {
+            if (!this.conn || this.conn.readyState !== WebSocket.OPEN) {
+                reject(new Error("Plugin not connected"));
+                return;
+            }
+            const requestId = this.nextId();
+            const request = {
+                type: requestType,
+                requestId,
+            };
+            if (nodeIds && nodeIds.length > 0) {
+                request.nodeIds = nodeIds;
+            }
+            if (params && Object.keys(params).length > 0) {
+                request.params = params;
+            }
+            const timeout = setTimeout(() => {
+                this.pending.delete(requestId);
+                reject(new Error("Request timed out"));
+            }, 30_000);
+            this.pending.set(requestId, { resolve, reject, timeout });
+            this.conn.send(JSON.stringify(request), (err) => {
+                if (err) {
+                    clearTimeout(timeout);
+                    this.pending.delete(requestId);
+                    reject(err);
+                }
+            });
+        });
+    }
+    nextId() {
+        this.counter++;
+        const now = new Date();
+        const hh = String(now.getHours()).padStart(2, "0");
+        const mm = String(now.getMinutes()).padStart(2, "0");
+        const ss = String(now.getSeconds()).padStart(2, "0");
+        return `req-${hh}${mm}${ss}-${this.counter}`;
+    }
+    close() {
+        // Reject all pending requests
+        for (const [id, { reject, timeout }] of this.pending) {
+            clearTimeout(timeout);
+            reject(new Error("Bridge closed"));
+        }
+        this.pending.clear();
+        if (this.conn) {
+            this.conn.close();
+            this.conn = null;
+        }
+        this.wss.close();
+    }
+}
+//# sourceMappingURL=bridge.js.map

package/dist/bridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge.js","sourceRoot":"","sources":["../src/bridge.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AAWhD,MAAM,OAAO,MAAM;IACT,GAAG,CAAkB;IACrB,IAAI,GAAqB,IAAI,CAAC;IAC9B,OAAO,GAAG,IAAI,GAAG,EAA0B,CAAC;IAC5C,OAAO,GAAG,CAAC,CAAC;IAEpB;QACE,IAAI,CAAC,GAAG,GAAG,IAAI,eAAe,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IACrD,CAAC;IAED,aAAa,CAAC,OAAwB,EAAE,MAAc,EAAE,IAAY;QAClE,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,EAAE;YACnD,IAAI,CAAC,gBAAgB,CAAC,EAAE,CAAC,CAAC;QAC5B,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,gBAAgB,CAAC,EAAa;QACpC,4DAA4D;QAC5D,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;QACpB,CAAC;QACD,IAAI,CAAC,IAAI,GAAG,EAAE,CAAC;QAEf,EAAE,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,EAAE;YACxB,IAAI,CAAC;gBACH,MAAM,IAAI,GAAmB,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;gBACzD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;gBACjD,IAAI,OAAO,EAAE,CAAC;oBACZ,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;oBAC9B,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;oBACpC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;gBACxB,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,CAAC,KAAK,CAAC,8BAA8B,CAAC,CAAC;YAChD,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;YAClB,IAAI,IAAI,CAAC,IAAI,KAAK,EAAE,EAAE,CAAC;gBACrB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;YACnB,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;YACrB,OAAO,CAAC,KAAK,CAAC,kBAAkB,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;YAC/C,IAAI,IAAI,CAAC,IAAI,KAAK,EAAE,EAAE,CAAC;gBACrB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;YACnB,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAED,IAAI,CAAC,WAAmB,EAAE,OAAkB;QAC1C,OAAO,IAAI,CAAC,cAAc,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IACnD,CAAC;IAED,cAAc,CACZ,WAAmB,EACnB,OAAkB,EAClB,MAAgC;QAEhC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,UAAU,KAAK,SAAS,CAAC,IAAI,EAAE,CAAC;gBAC1D,MAAM,CAAC,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC,CAAC;gBAC1C,OAAO;YACT,CAAC;YAED,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;YAChC,MAAM,OAAO,GAAkB;gBAC7B,IAAI,EAAE,WAAW;gBACjB,SAAS;aACV,CAAC;YACF,IAAI,OAAO,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAClC,OAAO,CAAC,OAAO,GAAG,OAAO,CAAC;YAC5B,CAAC;YACD,IAAI,MAAM,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC7C,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC;YAC1B,CAAC;YAED,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE;gBAC9B,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;gBAC/B,MAAM,CAAC,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC,CAAC;YACzC,CAAC,EAAE,MAAM,CAAC,CAAC;YAEX,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;YAE1D,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE;gBAC9C,IAAI,GAAG,EAAE,CAAC;oBACR,YAAY,CAAC,OAAO,CAAC,CAAC;oBACtB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;oBAC/B,MAAM,CAAC,GAAG,CAAC,CAAC;gBACd,CAAC;YACH,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,MAAM;QACZ,IAAI,CAAC,OAAO,EAAE,CAAC;QACf,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,EAAE,GAAG,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QACnD,MAAM,EAAE,GAAG,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QACrD,MAAM,EAAE,GAAG,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QACrD,OAAO,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;IAC/C,CAAC;IAED,KAAK;QACH,8BAA8B;QAC9B,KAAK,MAAM,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACrD,YAAY,CAAC,OAAO,CAAC,CAAC;YACtB,MAAM,CAAC,IAAI,KAAK,CAAC,eAAe,CAAC,CAAC,CAAC;QACrC,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QAErB,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;YAClB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACnB,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC;IACnB,CAAC;CACF"}

package/dist/election.d.ts

@@ -0,0 +1,20 @@
+import type { Node } from "./node.js";
+/**
+ * Election handles leader detection and role transitions.
+ *
+ * On start it attempts to become leader (by binding the port).
+ * If the port is taken and a healthy leader is found, it becomes a follower.
+ * A periodic ticker monitors the leader and triggers takeover if it dies.
+ */
+export declare class Election {
+    private port;
+    private node;
+    private interval;
+    private leaderUrl;
+    constructor(port: number, node: Node);
+    start(): Promise<void>;
+    stop(): void;
+    private checkAndUpdateRole;
+    private determineRole;
+    private pingLeader;
+}

package/dist/election.js

@@ -0,0 +1,85 @@
+import { Role } from "./types.js";
+/**
+ * Election handles leader detection and role transitions.
+ *
+ * On start it attempts to become leader (by binding the port).
+ * If the port is taken and a healthy leader is found, it becomes a follower.
+ * A periodic ticker monitors the leader and triggers takeover if it dies.
+ */
+export class Election {
+    port;
+    node;
+    interval = null;
+    leaderUrl;
+    constructor(port, node) {
+        this.port = port;
+        this.node = node;
+        this.leaderUrl = `http://localhost:${port}`;
+    }
+    async start() {
+        // Determine initial role
+        await this.determineRole();
+        // Continuous monitoring with random jitter (3-5 s)
+        const jitter = 3_000 + Math.random() * 2_000;
+        this.interval = setInterval(() => {
+            this.checkAndUpdateRole().catch((err) => {
+                console.error("Election check error:", err);
+            });
+        }, jitter);
+    }
+    stop() {
+        if (this.interval) {
+            clearInterval(this.interval);
+            this.interval = null;
+        }
+    }
+    async checkAndUpdateRole() {
+        switch (this.node.role) {
+            case Role.Follower: {
+                const alive = await this.pingLeader();
+                if (!alive) {
+                    console.error("Leader not responding, attempting takeover...");
+                    try {
+                        await this.node.becomeLeader();
+                    }
+                    catch (err) {
+                        console.error("Failed to become leader:", err);
+                    }
+                }
+                break;
+            }
+            case Role.Leader:
+                // Nothing to do — we are the leader
+                break;
+            case Role.Unknown:
+                await this.determineRole();
+                break;
+        }
+    }
+    async determineRole() {
+        // Try to become leader first
+        try {
+            await this.node.becomeLeader();
+            return;
+        }
+        catch {
+            // Port likely in use — check if there's a valid leader
+        }
+        if (await this.pingLeader()) {
+            this.node.becomeFollower();
+        }
+        // If ping fails too, next tick will retry
+    }
+    async pingLeader() {
+        try {
+            const response = await fetch(`${this.leaderUrl}/ping`, {
+                signal: AbortSignal.timeout(2_000),
+            });
+            return response.ok;
+        }
+        catch {
+            return false;
+        }
+    }
+}
+//# sourceMappingURL=election.js.map

package/dist/election.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"election.js","sourceRoot":"","sources":["../src/election.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAElC;;;;;;GAMG;AACH,MAAM,OAAO,QAAQ;IAKT;IACA;IALF,QAAQ,GAA0C,IAAI,CAAC;IACvD,SAAS,CAAS;IAE1B,YACU,IAAY,EACZ,IAAU;QADV,SAAI,GAAJ,IAAI,CAAQ;QACZ,SAAI,GAAJ,IAAI,CAAM;QAElB,IAAI,CAAC,SAAS,GAAG,oBAAoB,IAAI,EAAE,CAAC;IAC9C,CAAC;IAED,KAAK,CAAC,KAAK;QACT,yBAAyB;QACzB,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;QAE3B,mDAAmD;QACnD,MAAM,MAAM,GAAG,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,KAAK,CAAC;QAC7C,IAAI,CAAC,QAAQ,GAAG,WAAW,CAAC,GAAG,EAAE;YAC/B,IAAI,CAAC,kBAAkB,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;gBACtC,OAAO,CAAC,KAAK,CAAC,uBAAuB,EAAE,GAAG,CAAC,CAAC;YAC9C,CAAC,CAAC,CAAC;QACL,CAAC,EAAE,MAAM,CAAC,CAAC;IACb,CAAC;IAED,IAAI;QACF,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAC7B,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACvB,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,kBAAkB;QAC9B,QAAQ,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YACvB,KAAK,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;gBACnB,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC;gBACtC,IAAI,CAAC,KAAK,EAAE,CAAC;oBACX,OAAO,CAAC,KAAK,CAAC,+CAA+C,CAAC,CAAC;oBAC/D,IAAI,CAAC;wBACH,MAAM,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;oBACjC,CAAC;oBAAC,OAAO,GAAG,EAAE,CAAC;wBACb,OAAO,CAAC,KAAK,CAAC,0BAA0B,EAAE,GAAG,CAAC,CAAC;oBACjD,CAAC;gBACH,CAAC;gBACD,MAAM;YACR,CAAC;YACD,KAAK,IAAI,CAAC,MAAM;gBACd,oCAAoC;gBACpC,MAAM;YACR,KAAK,IAAI,CAAC,OAAO;gBACf,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;gBAC3B,MAAM;QACV,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,aAAa;QACzB,6BAA6B;QAC7B,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;YAC/B,OAAO;QACT,CAAC;QAAC,MAAM,CAAC;YACP,uDAAuD;QACzD,CAAC;QAED,IAAI,MAAM,IAAI,CAAC,UAAU,EAAE,EAAE,CAAC;YAC5B,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC;QAC7B,CAAC;QACD,0CAA0C;IAC5C,CAAC;IAEO,KAAK,CAAC,UAAU;QACtB,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,OAAO,EAAE;gBACrD,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,KAAK,CAAC;aACnC,CAAC,CAAC;YACH,OAAO,QAAQ,CAAC,EAAE,CAAC;QACrB,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;CACF"}

package/dist/follower.d.ts

@@ -0,0 +1,11 @@
+import type { BridgeResponse } from "./types.js";
+/**
+ * Follower proxies MCP tool calls to the leader via HTTP /rpc.
+ */
+export declare class Follower {
+    private leaderUrl;
+    constructor(leaderUrl: string);
+    send(requestType: string, nodeIds?: string[]): Promise<BridgeResponse>;
+    sendWithParams(requestType: string, nodeIds?: string[], params?: Record<string, unknown>): Promise<BridgeResponse>;
+    ping(): Promise<boolean>;
+}

package/dist/follower.js

@@ -0,0 +1,49 @@
+/**
+ * Follower proxies MCP tool calls to the leader via HTTP /rpc.
+ */
+export class Follower {
+    leaderUrl;
+    constructor(leaderUrl) {
+        this.leaderUrl = leaderUrl;
+    }
+    send(requestType, nodeIds) {
+        return this.sendWithParams(requestType, nodeIds);
+    }
+    async sendWithParams(requestType, nodeIds, params) {
+        const rpcReq = { tool: requestType };
+        if (nodeIds && nodeIds.length > 0)
+            rpcReq.nodeIds = nodeIds;
+        if (params && Object.keys(params).length > 0)
+            rpcReq.params = params;
+        const response = await fetch(`${this.leaderUrl}/rpc`, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify(rpcReq),
+            signal: AbortSignal.timeout(35_000),
+        });
+        if (!response.ok) {
+            throw new Error(`Leader returned status ${response.status}`);
+        }
+        const rpcResp = (await response.json());
+        if (rpcResp.error) {
+            throw new Error(rpcResp.error);
+        }
+        return {
+            type: requestType,
+            requestId: "",
+            data: rpcResp.data,
+        };
+    }
+    async ping() {
+        try {
+            const response = await fetch(`${this.leaderUrl}/ping`, {
+                signal: AbortSignal.timeout(2_000),
+            });
+            return response.ok;
+        }
+        catch {
+            return false;
+        }
+    }
+}
+//# sourceMappingURL=follower.js.map

package/dist/follower.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"follower.js","sourceRoot":"","sources":["../src/follower.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,OAAO,QAAQ;IACC;IAApB,YAAoB,SAAiB;QAAjB,cAAS,GAAT,SAAS,CAAQ;IAAG,CAAC;IAEzC,IAAI,CACF,WAAmB,EACnB,OAAkB;QAElB,OAAO,IAAI,CAAC,cAAc,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IACnD,CAAC;IAED,KAAK,CAAC,cAAc,CAClB,WAAmB,EACnB,OAAkB,EAClB,MAAgC;QAEhC,MAAM,MAAM,GAAe,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;QACjD,IAAI,OAAO,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;YAAE,MAAM,CAAC,OAAO,GAAG,OAAO,CAAC;QAC5D,IAAI,MAAM,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,GAAG,CAAC;YAAE,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC;QAErE,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,MAAM,EAAE;YACpD,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC;YAC5B,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC;SACpC,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,0BAA0B,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;QAC/D,CAAC;QAED,MAAM,OAAO,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAgB,CAAC;QAEvD,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;YAClB,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACjC,CAAC;QAED,OAAO;YACL,IAAI,EAAE,WAAW;YACjB,SAAS,EAAE,EAAE;YACb,IAAI,EAAE,OAAO,CAAC,IAAI;SACnB,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,IAAI;QACR,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,OAAO,EAAE;gBACrD,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,KAAK,CAAC;aACnC,CAAC,CAAC;YACH,OAAO,QAAQ,CAAC,EAAE,CAAC;QACrB,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,35 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { Node } from "./node.js";
+import { Election } from "./election.js";
+import { registerTools } from "./tools.js";
+const PORT = 1994;
+async function main() {
+    const node = new Node(PORT);
+    const election = new Election(PORT, node);
+    await election.start();
+    // Graceful shutdown
+    const shutdown = () => {
+        console.error("Shutting down...");
+        election.stop();
+        node.stop();
+        process.exit(0);
+    };
+    process.on("SIGINT", shutdown);
+    process.on("SIGTERM", shutdown);
+    // Create MCP server (stdio transport)
+    const server = new McpServer({
+        name: "figma-bridge",
+        version: "0.1.0",
+    });
+    registerTools(server, node);
+    console.error(`Starting MCP server (role: ${node.roleName})`);
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch((err) => {
+    console.error("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":";AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C,MAAM,IAAI,GAAG,IAAI,CAAC;AAElB,KAAK,UAAU,IAAI;IACjB,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5B,MAAM,QAAQ,GAAG,IAAI,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC1C,MAAM,QAAQ,CAAC,KAAK,EAAE,CAAC;IAEvB,oBAAoB;IACpB,MAAM,QAAQ,GAAG,GAAG,EAAE;QACpB,OAAO,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;QAClC,QAAQ,CAAC,IAAI,EAAE,CAAC;QAChB,IAAI,CAAC,IAAI,EAAE,CAAC;QACZ,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;IAEhC,sCAAsC;IACtC,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,cAAc;QACpB,OAAO,EAAE,OAAO;KACjB,CAAC,CAAC;IAEH,aAAa,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAE5B,OAAO,CAAC,KAAK,CAAC,8BAA8B,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC;IAE9D,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,GAAG,CAAC,CAAC;IACnC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/leader.d.ts

@@ -0,0 +1,18 @@
+import { Bridge } from "./bridge.js";
+/**
+ * Leader owns the WebSocket bridge to Figma and exposes HTTP endpoints for followers.
+ * Endpoints:
+ *   /ws   — WebSocket upgrade for the Figma plugin
+ *   /ping — Health check
+ *   /rpc  — JSON RPC for follower tool calls
+ */
+export declare class Leader {
+    private port;
+    private bridge;
+    private server;
+    constructor(port: number);
+    getBridge(): Bridge;
+    start(): Promise<void>;
+    private handleRPC;
+    stop(): void;
+}

package/dist/leader.js

@@ -0,0 +1,89 @@
+import http from "node:http";
+import { Bridge } from "./bridge.js";
+/**
+ * Leader owns the WebSocket bridge to Figma and exposes HTTP endpoints for followers.
+ * Endpoints:
+ *   /ws   — WebSocket upgrade for the Figma plugin
+ *   /ping — Health check
+ *   /rpc  — JSON RPC for follower tool calls
+ */
+export class Leader {
+    port;
+    bridge;
+    server = null;
+    constructor(port) {
+        this.port = port;
+        this.bridge = new Bridge();
+    }
+    getBridge() {
+        return this.bridge;
+    }
+    start() {
+        return new Promise((resolve, reject) => {
+            const server = http.createServer((req, res) => {
+                if (req.url === "/ping" && req.method === "GET") {
+                    res.writeHead(200, { "Content-Type": "application/json" });
+                    res.end(JSON.stringify({ status: "ok", version: "0.1.0" }));
+                    return;
+                }
+                if (req.url === "/rpc" && req.method === "POST") {
+                    this.handleRPC(req, res);
+                    return;
+                }
+                res.writeHead(404);
+                res.end("Not found");
+            });
+            server.on("upgrade", (req, socket, head) => {
+                if (req.url === "/ws") {
+                    this.bridge.handleUpgrade(req, socket, head);
+                }
+                else {
+                    socket.destroy();
+                }
+            });
+            // Fail fast if port is already in use
+            server.once("error", (err) => {
+                reject(err.code === "EADDRINUSE"
+                    ? new Error(`Port ${this.port} already in use`)
+                    : err);
+            });
+            server.listen(this.port, () => {
+                this.server = server;
+                console.error(`Leader listening on :${this.port}`);
+                resolve();
+            });
+        });
+    }
+    handleRPC(req, res) {
+        let body = "";
+        req.on("data", (chunk) => {
+            body += chunk.toString();
+        });
+        req.on("end", async () => {
+            try {
+                const rpcReq = JSON.parse(body);
+                const resp = await this.bridge.sendWithParams(rpcReq.tool, rpcReq.nodeIds, rpcReq.params);
+                const rpcResp = resp.error
+                    ? { error: resp.error }
+                    : { data: resp.data };
+                res.writeHead(200, { "Content-Type": "application/json" });
+                res.end(JSON.stringify(rpcResp));
+            }
+            catch (err) {
+                const rpcResp = {
+                    error: err instanceof Error ? err.message : String(err),
+                };
+                res.writeHead(200, { "Content-Type": "application/json" });
+                res.end(JSON.stringify(rpcResp));
+            }
+        });
+    }
+    stop() {
+        this.bridge.close();
+        if (this.server) {
+            this.server.close();
+            this.server = null;
+        }
+    }
+}
+//# sourceMappingURL=leader.js.map

package/dist/leader.js.map

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

package/dist/node.d.ts

@@ -0,0 +1,20 @@
+import { Role } from "./types.js";
+import type { BridgeResponse } from "./types.js";
+/**
+ * Node is the dynamic handler that switches between leader and follower roles.
+ * It routes MCP tool calls to the appropriate backend based on its current role.
+ */
+export declare class Node {
+    private port;
+    private _role;
+    private leader;
+    private follower;
+    constructor(port: number);
+    get role(): Role;
+    get roleName(): string;
+    send(requestType: string, nodeIds?: string[]): Promise<BridgeResponse>;
+    sendWithParams(requestType: string, nodeIds?: string[], params?: Record<string, unknown>): Promise<BridgeResponse>;
+    becomeLeader(): Promise<void>;
+    becomeFollower(): void;
+    stop(): void;
+}

package/dist/node.js

@@ -0,0 +1,68 @@
+import { Leader } from "./leader.js";
+import { Follower } from "./follower.js";
+import { Role } from "./types.js";
+/**
+ * Node is the dynamic handler that switches between leader and follower roles.
+ * It routes MCP tool calls to the appropriate backend based on its current role.
+ */
+export class Node {
+    port;
+    _role = Role.Unknown;
+    leader = null;
+    follower;
+    constructor(port) {
+        this.port = port;
+        this.follower = new Follower(`http://localhost:${port}`);
+    }
+    get role() {
+        return this._role;
+    }
+    get roleName() {
+        switch (this._role) {
+            case Role.Leader:
+                return "LEADER";
+            case Role.Follower:
+                return "FOLLOWER";
+            default:
+                return "UNKNOWN";
+        }
+    }
+    send(requestType, nodeIds) {
+        return this.sendWithParams(requestType, nodeIds);
+    }
+    sendWithParams(requestType, nodeIds, params) {
+        if (this._role === Role.Leader && this.leader) {
+            return this.leader
+                .getBridge()
+                .sendWithParams(requestType, nodeIds, params);
+        }
+        return this.follower.sendWithParams(requestType, nodeIds, params);
+    }
+    async becomeLeader() {
+        if (this._role === Role.Leader)
+            return;
+        const leader = new Leader(this.port);
+        await leader.start();
+        this.leader = leader;
+        this._role = Role.Leader;
+        console.error("Became LEADER");
+    }
+    becomeFollower() {
+        if (this._role === Role.Follower)
+            return;
+        if (this.leader) {
+            this.leader.stop();
+            this.leader = null;
+        }
+        this._role = Role.Follower;
+        console.error("Became FOLLOWER");
+    }
+    stop() {
+        if (this.leader) {
+            this.leader.stop();
+            this.leader = null;
+        }
+        this._role = Role.Unknown;
+    }
+}
+//# sourceMappingURL=node.js.map

package/dist/node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.js","sourceRoot":"","sources":["../src/node.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAGlC;;;GAGG;AACH,MAAM,OAAO,IAAI;IAKK;IAJZ,KAAK,GAAS,IAAI,CAAC,OAAO,CAAC;IAC3B,MAAM,GAAkB,IAAI,CAAC;IAC7B,QAAQ,CAAW;IAE3B,YAAoB,IAAY;QAAZ,SAAI,GAAJ,IAAI,CAAQ;QAC9B,IAAI,CAAC,QAAQ,GAAG,IAAI,QAAQ,CAAC,oBAAoB,IAAI,EAAE,CAAC,CAAC;IAC3D,CAAC;IAED,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED,IAAI,QAAQ;QACV,QAAQ,IAAI,CAAC,KAAK,EAAE,CAAC;YACnB,KAAK,IAAI,CAAC,MAAM;gBACd,OAAO,QAAQ,CAAC;YAClB,KAAK,IAAI,CAAC,QAAQ;gBAChB,OAAO,UAAU,CAAC;YACpB;gBACE,OAAO,SAAS,CAAC;QACrB,CAAC;IACH,CAAC;IAED,IAAI,CACF,WAAmB,EACnB,OAAkB;QAElB,OAAO,IAAI,CAAC,cAAc,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IACnD,CAAC;IAED,cAAc,CACZ,WAAmB,EACnB,OAAkB,EAClB,MAAgC;QAEhC,IAAI,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAC9C,OAAO,IAAI,CAAC,MAAM;iBACf,SAAS,EAAE;iBACX,cAAc,CAAC,WAAW,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;QAClD,CAAC;QACD,OAAO,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC,WAAW,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;IACpE,CAAC;IAED,KAAK,CAAC,YAAY;QAChB,IAAI,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,MAAM;YAAE,OAAO;QAEvC,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrC,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;QAErB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC;QACzB,OAAO,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;IACjC,CAAC;IAED,cAAc;QACZ,IAAI,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,QAAQ;YAAE,OAAO;QAEzC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;YACnB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACrB,CAAC;QAED,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC3B,OAAO,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;IACnC,CAAC;IAED,IAAI;QACF,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;YACnB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACrB,CAAC;QACD,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC;IAC5B,CAAC;CACF"}

package/dist/tools.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { Node } from "./node.js";
+export declare function registerTools(server: McpServer, node: Node): void;

package/dist/tools.js

@@ -0,0 +1,80 @@
+import { z } from "zod";
+export function registerTools(server, node) {
+    server.tool("get_document", "Get the current Figma page document tree", async () => {
+        return renderResponse(() => node.send("get_document"));
+    });
+    server.tool("get_selection", "Get the currently selected nodes in Figma", async () => {
+        return renderResponse(() => node.send("get_selection"));
+    });
+    server.tool("get_node", "Get a specific Figma node by ID", { nodeId: z.string().describe("The node ID to fetch") }, async ({ nodeId }) => {
+        return renderResponse(() => node.send("get_node", [nodeId]));
+    });
+    server.tool("get_styles", "Get all local styles in the document", async () => {
+        return renderResponse(() => node.send("get_styles"));
+    });
+    server.tool("get_metadata", "Get metadata about the current Figma document including file name, pages, and current page info", async () => {
+        return renderResponse(() => node.send("get_metadata"));
+    });
+    server.tool("get_design_context", "Get the design context for the current selection or page. Returns a summarized tree structure optimized for understanding the current design context.", {
+        depth: z
+            .number()
+            .optional()
+            .describe("How many levels deep to traverse the node tree (default 2)"),
+    }, async ({ depth }) => {
+        const params = {};
+        if (depth !== undefined && depth > 0) {
+            params.depth = depth;
+        }
+        return renderResponse(() => node.sendWithParams("get_design_context", undefined, params));
+    });
+    server.tool("get_variable_defs", "Get all local variable definitions including variable collections, modes, and variable values. Variables are Figma's system for design tokens (colors, numbers, strings, booleans).", async () => {
+        return renderResponse(() => node.send("get_variable_defs"));
+    });
+    server.tool("get_screenshot", "Export a screenshot of the selected nodes or specific nodes by ID. Returns base64-encoded image data.", {
+        nodeIds: z
+            .array(z.string())
+            .optional()
+            .describe("Optional list of node IDs to export — if empty, exports the current selection"),
+        format: z
+            .string()
+            .optional()
+            .describe("Export format: PNG (default) or SVG or JPG or PDF"),
+        scale: z
+            .number()
+            .optional()
+            .describe("Export scale for raster formats (default 2)"),
+    }, async ({ nodeIds, format, scale }) => {
+        const params = {};
+        if (format)
+            params.format = format;
+        if (scale !== undefined && scale > 0)
+            params.scale = scale;
+        return renderResponse(() => node.sendWithParams("get_screenshot", nodeIds, params));
+    });
+}
+async function renderResponse(fn) {
+    try {
+        const resp = await fn();
+        if (resp.error) {
+            return {
+                content: [{ type: "text", text: resp.error }],
+                isError: true,
+            };
+        }
+        return {
+            content: [{ type: "text", text: JSON.stringify(resp.data) }],
+        };
+    }
+    catch (err) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: err instanceof Error ? err.message : String(err),
+                },
+            ],
+            isError: true,
+        };
+    }
+}
+//# sourceMappingURL=tools.js.map

package/dist/tools.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,26 @@
+export interface BridgeRequest {
+    type: string;
+    requestId: string;
+    nodeIds?: string[];
+    params?: Record<string, unknown>;
+}
+export interface BridgeResponse {
+    type: string;
+    requestId: string;
+    data?: unknown;
+    error?: string;
+}
+export interface RPCRequest {
+    tool: string;
+    nodeIds?: string[];
+    params?: Record<string, unknown>;
+}
+export interface RPCResponse {
+    data?: unknown;
+    error?: string;
+}
+export declare enum Role {
+    Unknown = 0,
+    Leader = 1,
+    Follower = 2
+}

package/dist/types.js

@@ -0,0 +1,7 @@
+export var Role;
+(function (Role) {
+    Role[Role["Unknown"] = 0] = "Unknown";
+    Role[Role["Leader"] = 1] = "Leader";
+    Role[Role["Follower"] = 2] = "Follower";
+})(Role || (Role = {}));
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAyBA,MAAM,CAAN,IAAY,IAIX;AAJD,WAAY,IAAI;IACd,qCAAW,CAAA;IACX,mCAAU,CAAA;IACV,uCAAY,CAAA;AACd,CAAC,EAJW,IAAI,KAAJ,IAAI,QAIf"}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@gethopp/figma-mcp-bridge",
+  "version": "0.0.1",
+  "description": "MCP server that bridges Figma plugin data to AI tools without hitting API rate limits",
+  "type": "module",
+  "bin": {
+    "figma-mcp-bridge": "dist/index.js"
+  },
+  "main": "dist/index.js",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "bun run build"
+  },
+  "keywords": [
+    "figma",
+    "mcp",
+    "model-context-protocol",
+    "ai",
+    "design"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/gethopp/figma-mcp-bridge.git",
+    "directory": "server"
+  },
+  "homepage": "https://github.com/gethopp/figma-mcp-bridge#readme",
+  "bugs": {
+    "url": "https://github.com/gethopp/figma-mcp-bridge/issues"
+  },
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.26.0",
+    "ws": "^8.18.0",
+    "zod": "^3.24.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "@types/ws": "^8.5.0",
+    "typescript": "^5.6.0"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  }
+}