@player-devtools/client-flipper 0.13.1--canary.17.955

package/dist/cjs/index.cjs

@@ -0,0 +1,301 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// ../../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/client/flipper/src/index.ts
+var src_exports = {};
+__export(src_exports, {
+  FlipperServerTransport: () => FlipperServerTransport
+});
+module.exports = __toCommonJS(src_exports);
+
+// ../../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/client/flipper/src/transport.ts
+var import_flipper_server_client = require("flipper-server-client");
+var import_child_process = require("child_process");
+var net = __toESM(require("net"));
+var fs = __toESM(require("fs"));
+var os = __toESM(require("os"));
+var path = __toESM(require("path"));
+var import_ws = require("ws");
+if (typeof globalThis.WebSocket === "undefined") {
+  globalThis.WebSocket = import_ws.WebSocket;
+}
+var PLUGIN_API = "player-ui-devtools";
+function waitForPort(host, port, timeoutMs = 3e4) {
+  return new Promise((resolve, reject) => {
+    const deadline = Date.now() + timeoutMs;
+    const attempt = () => {
+      const socket = net.connect(port, host);
+      socket.once("connect", () => {
+        socket.destroy();
+        resolve();
+      });
+      socket.once("error", () => {
+        socket.destroy();
+        if (Date.now() >= deadline) {
+          reject(new Error(`Timed out waiting for ${host}:${port}`));
+        } else {
+          setTimeout(attempt, 500);
+        }
+      });
+    };
+    attempt();
+  });
+}
+var FlipperRefcount = class {
+  constructor() {
+    this.dir = path.join(os.tmpdir(), "player-devtools-mcp");
+    this.file = path.join(this.dir, "flipper-server.refcount");
+    this.lock = path.join(this.dir, "flipper-server.lock");
+  }
+  /** Acquire the cross-process lock, run `fn`, then release — even on throw. */
+  withLock(fn) {
+    fs.mkdirSync(this.dir, { recursive: true });
+    const deadline = Date.now() + 5e3;
+    for (; ; ) {
+      try {
+        fs.mkdirSync(this.lock);
+        break;
+      } catch (err) {
+        if (err.code !== "EEXIST") throw err;
+        if (Date.now() >= deadline) {
+          try {
+            fs.rmdirSync(this.lock);
+          } catch {
+          }
+        }
+      }
+    }
+    try {
+      return fn();
+    } finally {
+      try {
+        fs.rmdirSync(this.lock);
+      } catch {
+      }
+    }
+  }
+  read() {
+    try {
+      return JSON.parse(fs.readFileSync(this.file, "utf8"));
+    } catch {
+      return null;
+    }
+  }
+  write(state) {
+    fs.writeFileSync(this.file, JSON.stringify(state));
+  }
+  clear() {
+    try {
+      fs.unlinkSync(this.file);
+    } catch {
+    }
+  }
+  /** Is the recorded daemon PID still alive? */
+  isAlive(pid) {
+    try {
+      process.kill(pid, 0);
+      return true;
+    } catch {
+      return false;
+    }
+  }
+  /**
+   * Register interest in the daemon. Returns whether this caller is the one
+   * responsible for starting it (because no live daemon was recorded).
+   * `recordPid` is called with the started PID once the daemon is up.
+   */
+  acquire() {
+    return this.withLock(() => {
+      const state = this.read();
+      if (state && this.isAlive(state.pid)) {
+        this.write({ pid: state.pid, refs: state.refs + 1 });
+        return { shouldStart: false, commit: () => {
+        } };
+      }
+      return {
+        shouldStart: true,
+        commit: (pid) => this.withLock(() => this.write({ pid, refs: 1 }))
+      };
+    });
+  }
+  /**
+   * Drop this caller's interest. Returns the PID to kill if this was the last
+   * reference, otherwise null.
+   */
+  release() {
+    return this.withLock(() => {
+      const state = this.read();
+      if (!state) return null;
+      if (state.refs <= 1) {
+        this.clear();
+        return state.pid;
+      }
+      this.write({ pid: state.pid, refs: state.refs - 1 });
+      return null;
+    });
+  }
+};
+var FlipperServerTransport = class {
+  constructor(options = {}) {
+    this.options = options;
+    this.server = null;
+    this.refcount = new FlipperRefcount();
+    this.listeners = /* @__PURE__ */ new Set();
+    /**
+     * Client IDs that have sent at least one message through the devtools
+     * plugin — these are the clients we send outbound messages to.
+     */
+    this.activeClientIds = /* @__PURE__ */ new Set();
+    this.sendMessage = async (message) => {
+      if (!this.server) return;
+      const payload = {
+        method: "execute",
+        params: {
+          api: PLUGIN_API,
+          method: "message::flipper",
+          params: message
+        }
+      };
+      await Promise.all(
+        [...this.activeClientIds].map(
+          (clientId) => this.server.exec("client-request-response", clientId, payload).catch(
+            (err) => {
+              console.warn(
+                `[FlipperServerTransport] Failed to send to client ${clientId}:`,
+                err
+              );
+              this.activeClientIds.delete(clientId);
+            }
+          )
+        )
+      );
+    };
+    this.addListener = (callback) => {
+      this.listeners.add(callback);
+    };
+    this.removeListener = (callback) => {
+      this.listeners.delete(callback);
+    };
+  }
+  async connect() {
+    const host = this.options.host ?? "localhost";
+    const port = this.options.port ?? 52342;
+    const { shouldStart, commit } = this.refcount.acquire();
+    if (shouldStart) {
+      console.log("[FlipperServerTransport] Starting flipper-server...");
+      const serverScript = require.resolve("flipper-server/server.js");
+      const child = (0, import_child_process.spawn)(process.execPath, [serverScript, "--open=true"], {
+        stdio: "inherit",
+        detached: true
+      });
+      child.on("error", (err) => {
+        console.error(
+          "[FlipperServerTransport] flipper-server process error:",
+          err
+        );
+      });
+      child.unref();
+      await waitForPort(host, port);
+      commit(child.pid);
+      console.log("[FlipperServerTransport] flipper-server ready.");
+    } else {
+      await waitForPort(host, port);
+      console.log("[FlipperServerTransport] Attached to flipper-server.");
+    }
+    const { getAuthToken } = (
+      // eslint-disable-next-line @typescript-eslint/no-require-imports
+      require("flipper-server/lib/app-connectivity/certificate-exchange/certificate-utils")
+    );
+    let cachedToken = null;
+    try {
+      cachedToken = await getAuthToken();
+    } catch (err) {
+      console.warn("[FlipperServerTransport] Could not read auth token:", err);
+    }
+    this.server = await (0, import_flipper_server_client.createFlipperServer)(
+      host,
+      port,
+      () => cachedToken,
+      (state) => {
+        if (state === import_flipper_server_client.FlipperServerState.DISCONNECTED) {
+          console.warn("[FlipperServerTransport] Disconnected from server");
+        }
+      }
+    );
+    await this.server.connect();
+    this.server.on("client-connected", (info) => {
+      console.log(
+        "[FlipperServerTransport] client-connected:",
+        JSON.stringify(info)
+      );
+    });
+    this.server.on("client-disconnected", ({ id }) => {
+      console.log("[FlipperServerTransport] client-disconnected:", id);
+      this.activeClientIds.delete(id);
+    });
+    this.server.on("client-message", ({ id, message }) => {
+      let parsed;
+      try {
+        parsed = JSON.parse(message);
+      } catch {
+        return;
+      }
+      console.debug(
+        `[FlipperServerTransport] client-message from ${id}: method=${parsed.method} api=${parsed.params?.api} pluginMethod=${parsed.params?.method}`
+      );
+      if (parsed.method !== "execute" || parsed.params?.api !== PLUGIN_API || parsed.params?.method !== "message::plugin") {
+        return;
+      }
+      this.activeClientIds.add(id);
+      const payload = parsed.params.params;
+      for (const listener of this.listeners) {
+        listener(payload);
+      }
+    });
+  }
+  async close() {
+    this.listeners.clear();
+    this.activeClientIds.clear();
+    this.server?.close();
+    this.server = null;
+    const pidToKill = this.refcount.release();
+    if (pidToKill !== null) {
+      try {
+        process.kill(pidToKill);
+        console.log("[FlipperServerTransport] Shut down flipper-server.");
+      } catch {
+      }
+    }
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  FlipperServerTransport
+});
+//# sourceMappingURL=index.cjs.map

package/dist/cjs/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/client/flipper/src/index.ts","../../../../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/client/flipper/src/transport.ts"],"sourcesContent":["export { FlipperServerTransport } from \"./transport\";\n","import {\n  createFlipperServer,\n  FlipperServerState,\n  type FlipperServer,\n} from \"flipper-server-client\";\nimport { spawn } from \"child_process\";\nimport * as net from \"net\";\nimport * as fs from \"fs\";\nimport * as os from \"os\";\nimport * as path from \"path\";\nimport { WebSocket as WsWebSocket } from \"ws\";\nimport type {\n  CommunicationLayerMethods,\n  ExtensionSupportedEvents,\n  MessengerEvent,\n  TransactionMetadata,\n  Transport,\n} from \"@player-devtools/types\";\n\n// polyfill WebSocket for Node < 22\nif (typeof (globalThis as { WebSocket?: unknown }).WebSocket === \"undefined\") {\n  (globalThis as { WebSocket?: unknown }).WebSocket =\n    WsWebSocket as unknown as typeof WebSocket;\n}\n\ntype MessageCallback = (\n  message: TransactionMetadata & MessengerEvent<ExtensionSupportedEvents>,\n) => void;\n\nconst PLUGIN_API = \"player-ui-devtools\";\n\n/** Shape of a Flipper `client-message` payload after JSON.parse */\ntype FlipperExecuteMessage = {\n  method: \"execute\";\n  params: {\n    api: string;\n    method: string;\n    params?: unknown;\n  };\n};\n\n/**\n * Flipper headless transport\n *\n * Connects to a running `flipper-server` process and routes messages for the\n * \"flipper-plugin-player-ui-devtools\" plugin through to the Messenger layer.\n */\n/** Wait until a TCP port is accepting connections, polling every 500ms */\nfunction waitForPort(\n  host: string,\n  port: number,\n  timeoutMs = 30_000,\n): Promise<void> {\n  return new Promise((resolve, reject) => {\n    const deadline = Date.now() + timeoutMs;\n    const attempt = () => {\n      const socket = net.connect(port, host);\n      socket.once(\"connect\", () => {\n        socket.destroy();\n        resolve();\n      });\n      socket.once(\"error\", () => {\n        socket.destroy();\n        if (Date.now() >= deadline) {\n          reject(new Error(`Timed out waiting for ${host}:${port}`));\n        } else {\n          setTimeout(attempt, 500);\n        }\n      });\n    };\n    attempt();\n  });\n}\n\n/**\n * Cross-process refcount for the shared `flipper-server` daemon.\n *\n * Many MCP server processes (one per project/user registration) attach to a\n * single `flipper-server` on a fixed port. No in-process variable can\n * coordinate their lifecycles, so we track liveness in a small file guarded by\n * an atomic lock directory:\n *\n *   - The first attach starts the daemon and records its PID with `refs: 1`.\n *   - Each subsequent attach increments `refs`.\n *   - Each detach decrements `refs`; the last one out shuts the daemon down.\n *\n * The lock directory (`mkdir` is atomic across processes) serializes the\n * read-modify-write so concurrently-starting instances don't race.\n */\ntype RefcountFile = { pid: number; refs: number };\n\nclass FlipperRefcount {\n  private readonly dir = path.join(os.tmpdir(), \"player-devtools-mcp\");\n  private readonly file = path.join(this.dir, \"flipper-server.refcount\");\n  private readonly lock = path.join(this.dir, \"flipper-server.lock\");\n\n  /** Acquire the cross-process lock, run `fn`, then release — even on throw. */\n  private withLock<T>(fn: () => T): T {\n    fs.mkdirSync(this.dir, { recursive: true });\n    const deadline = Date.now() + 5_000;\n    // Spin on an atomic mkdir until we own the lock or time out.\n    for (;;) {\n      try {\n        fs.mkdirSync(this.lock);\n        break;\n      } catch (err) {\n        if ((err as NodeJS.ErrnoException).code !== \"EEXIST\") throw err;\n        if (Date.now() >= deadline) {\n          // Stale lock from a crashed process — reclaim it.\n          try {\n            fs.rmdirSync(this.lock);\n          } catch {\n            /* another instance won the reclaim; retry */\n          }\n        }\n      }\n    }\n    try {\n      return fn();\n    } finally {\n      try {\n        fs.rmdirSync(this.lock);\n      } catch {\n        /* already gone */\n      }\n    }\n  }\n\n  private read(): RefcountFile | null {\n    try {\n      return JSON.parse(fs.readFileSync(this.file, \"utf8\")) as RefcountFile;\n    } catch {\n      return null;\n    }\n  }\n\n  private write(state: RefcountFile): void {\n    fs.writeFileSync(this.file, JSON.stringify(state));\n  }\n\n  private clear(): void {\n    try {\n      fs.unlinkSync(this.file);\n    } catch {\n      /* already gone */\n    }\n  }\n\n  /** Is the recorded daemon PID still alive? */\n  private isAlive(pid: number): boolean {\n    try {\n      process.kill(pid, 0);\n      return true;\n    } catch {\n      return false;\n    }\n  }\n\n  /**\n   * Register interest in the daemon. Returns whether this caller is the one\n   * responsible for starting it (because no live daemon was recorded).\n   * `recordPid` is called with the started PID once the daemon is up.\n   */\n  acquire(): { shouldStart: boolean; commit: (pid: number) => void } {\n    return this.withLock(() => {\n      const state = this.read();\n      if (state && this.isAlive(state.pid)) {\n        this.write({ pid: state.pid, refs: state.refs + 1 });\n        return { shouldStart: false, commit: () => {} };\n      }\n      // No live daemon — this caller will start one and record its PID.\n      return {\n        shouldStart: true,\n        commit: (pid: number) =>\n          this.withLock(() => this.write({ pid, refs: 1 })),\n      };\n    });\n  }\n\n  /**\n   * Drop this caller's interest. Returns the PID to kill if this was the last\n   * reference, otherwise null.\n   */\n  release(): number | null {\n    return this.withLock(() => {\n      const state = this.read();\n      if (!state) return null;\n      if (state.refs <= 1) {\n        this.clear();\n        return state.pid;\n      }\n      this.write({ pid: state.pid, refs: state.refs - 1 });\n      return null;\n    });\n  }\n}\n\nexport class FlipperServerTransport implements Transport {\n  private server: FlipperServer | null = null;\n  private refcount = new FlipperRefcount();\n  private listeners = new Set<MessageCallback>();\n\n  /**\n   * Client IDs that have sent at least one message through the devtools\n   * plugin — these are the clients we send outbound messages to.\n   */\n  private activeClientIds = new Set<string>();\n\n  constructor(\n    private options: {\n      /** Flipper server host; defaults to \"localhost\" */\n      host?: string;\n      /** Flipper server WebSocket port; defaults to 52342 */\n      port?: number;\n    } = {},\n  ) {}\n\n  async connect(): Promise<void> {\n    const host = this.options.host ?? \"localhost\";\n    const port = this.options.port ?? 52342;\n\n    // Register interest in the shared daemon. The first instance to do so is\n    // told to start it; the rest just attach. The daemon outlives any single\n    // MCP process and is only torn down when the last instance detaches.\n    const { shouldStart, commit } = this.refcount.acquire();\n\n    if (shouldStart) {\n      console.log(\"[FlipperServerTransport] Starting flipper-server...\");\n      const serverScript = require.resolve(\"flipper-server/server.js\");\n      // Detached + unref'd: the daemon must survive this process exiting so\n      // other instances keep their connections. We never kill it directly —\n      // shutdown is driven by the refcount in close().\n      const child = spawn(process.execPath, [serverScript, \"--open=true\"], {\n        stdio: \"inherit\",\n        detached: true,\n      });\n      child.on(\"error\", (err: Error) => {\n        console.error(\n          \"[FlipperServerTransport] flipper-server process error:\",\n          err,\n        );\n      });\n      child.unref();\n      await waitForPort(host, port);\n      commit(child.pid!);\n      console.log(\"[FlipperServerTransport] flipper-server ready.\");\n    } else {\n      // Daemon already running (started by another instance) — wait for it to\n      // accept connections in case it's still coming up, then attach.\n      await waitForPort(host, port);\n      console.log(\"[FlipperServerTransport] Attached to flipper-server.\");\n    }\n\n    // Read the auth token the flipper-server wrote during startup\n    const { getAuthToken } =\n      // eslint-disable-next-line @typescript-eslint/no-require-imports\n      require(\"flipper-server/lib/app-connectivity/certificate-exchange/certificate-utils\") as {\n        getAuthToken: () => Promise<string>;\n      };\n\n    let cachedToken: string | null = null;\n    try {\n      cachedToken = await getAuthToken();\n    } catch (err) {\n      console.warn(\"[FlipperServerTransport] Could not read auth token:\", err);\n    }\n\n    this.server = await createFlipperServer(\n      host,\n      port,\n      () => cachedToken,\n      (state) => {\n        if (state === FlipperServerState.DISCONNECTED) {\n          console.warn(\"[FlipperServerTransport] Disconnected from server\");\n        }\n      },\n    );\n\n    await this.server.connect();\n\n    // Track client connects/disconnects\n    this.server.on(\"client-connected\", (info) => {\n      console.log(\n        \"[FlipperServerTransport] client-connected:\",\n        JSON.stringify(info),\n      );\n    });\n    this.server.on(\"client-disconnected\", ({ id }) => {\n      console.log(\"[FlipperServerTransport] client-disconnected:\", id);\n      this.activeClientIds.delete(id);\n    });\n\n    // Route inbound device messages to our Messenger listeners\n    this.server.on(\"client-message\", ({ id, message }) => {\n      let parsed: FlipperExecuteMessage;\n      try {\n        parsed = JSON.parse(message) as FlipperExecuteMessage;\n      } catch {\n        return;\n      }\n\n      console.debug(\n        `[FlipperServerTransport] client-message from ${id}: method=${parsed.method} api=${(parsed.params as { api?: string })?.api} pluginMethod=${(parsed.params as { method?: string })?.method}`,\n      );\n\n      if (\n        parsed.method !== \"execute\" ||\n        parsed.params?.api !== PLUGIN_API ||\n        parsed.params?.method !== \"message::plugin\"\n      ) {\n        return;\n      }\n\n      // This client is talking through the devtools plugin — remember it\n      this.activeClientIds.add(id);\n\n      const payload = parsed.params.params as TransactionMetadata &\n        MessengerEvent<ExtensionSupportedEvents>;\n\n      for (const listener of this.listeners) {\n        listener(payload);\n      }\n    });\n  }\n\n  sendMessage: CommunicationLayerMethods[\"sendMessage\"] = async (message) => {\n    if (!this.server) return;\n\n    const payload: FlipperExecuteMessage = {\n      method: \"execute\",\n      params: {\n        api: PLUGIN_API,\n        method: \"message::flipper\",\n        params: message,\n      },\n    };\n\n    await Promise.all(\n      [...this.activeClientIds].map((clientId) =>\n        this.server!.exec(\"client-request-response\", clientId, payload).catch(\n          (err) => {\n            console.warn(\n              `[FlipperServerTransport] Failed to send to client ${clientId}:`,\n              err,\n            );\n            // Remove dead client so we stop trying\n            this.activeClientIds.delete(clientId);\n          },\n        ),\n      ),\n    );\n  };\n\n  addListener: CommunicationLayerMethods[\"addListener\"] = (callback) => {\n    this.listeners.add(callback);\n  };\n\n  removeListener: CommunicationLayerMethods[\"removeListener\"] = (callback) => {\n    this.listeners.delete(callback);\n  };\n\n  async close(): Promise<void> {\n    this.listeners.clear();\n    this.activeClientIds.clear();\n    this.server?.close();\n    this.server = null;\n\n    // Drop our reference to the shared daemon. If we were the last user, the\n    // refcount hands back its PID and we shut it down; otherwise it keeps\n    // running for the remaining instances.\n    const pidToKill = this.refcount.release();\n    if (pidToKill !== null) {\n      try {\n        process.kill(pidToKill);\n        console.log(\"[FlipperServerTransport] Shut down flipper-server.\");\n      } catch {\n        /* already gone */\n      }\n    }\n  }\n}\n"],"mappings":"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","names":["WsWebSocket"]}

package/dist/index.legacy-esm.js

@@ -0,0 +1,274 @@
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
+  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
+}) : x)(function(x) {
+  if (typeof require !== "undefined") return require.apply(this, arguments);
+  throw Error('Dynamic require of "' + x + '" is not supported');
+});
+
+// ../../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/client/flipper/src/transport.ts
+import {
+  createFlipperServer,
+  FlipperServerState
+} from "flipper-server-client";
+import { spawn } from "child_process";
+import * as net from "net";
+import * as fs from "fs";
+import * as os from "os";
+import * as path from "path";
+import { WebSocket as WsWebSocket } from "ws";
+if (typeof globalThis.WebSocket === "undefined") {
+  globalThis.WebSocket = WsWebSocket;
+}
+var PLUGIN_API = "player-ui-devtools";
+function waitForPort(host, port, timeoutMs = 3e4) {
+  return new Promise((resolve, reject) => {
+    const deadline = Date.now() + timeoutMs;
+    const attempt = () => {
+      const socket = net.connect(port, host);
+      socket.once("connect", () => {
+        socket.destroy();
+        resolve();
+      });
+      socket.once("error", () => {
+        socket.destroy();
+        if (Date.now() >= deadline) {
+          reject(new Error(`Timed out waiting for ${host}:${port}`));
+        } else {
+          setTimeout(attempt, 500);
+        }
+      });
+    };
+    attempt();
+  });
+}
+var FlipperRefcount = class {
+  constructor() {
+    this.dir = path.join(os.tmpdir(), "player-devtools-mcp");
+    this.file = path.join(this.dir, "flipper-server.refcount");
+    this.lock = path.join(this.dir, "flipper-server.lock");
+  }
+  /** Acquire the cross-process lock, run `fn`, then release — even on throw. */
+  withLock(fn) {
+    fs.mkdirSync(this.dir, { recursive: true });
+    const deadline = Date.now() + 5e3;
+    for (; ; ) {
+      try {
+        fs.mkdirSync(this.lock);
+        break;
+      } catch (err) {
+        if (err.code !== "EEXIST") throw err;
+        if (Date.now() >= deadline) {
+          try {
+            fs.rmdirSync(this.lock);
+          } catch {
+          }
+        }
+      }
+    }
+    try {
+      return fn();
+    } finally {
+      try {
+        fs.rmdirSync(this.lock);
+      } catch {
+      }
+    }
+  }
+  read() {
+    try {
+      return JSON.parse(fs.readFileSync(this.file, "utf8"));
+    } catch {
+      return null;
+    }
+  }
+  write(state) {
+    fs.writeFileSync(this.file, JSON.stringify(state));
+  }
+  clear() {
+    try {
+      fs.unlinkSync(this.file);
+    } catch {
+    }
+  }
+  /** Is the recorded daemon PID still alive? */
+  isAlive(pid) {
+    try {
+      process.kill(pid, 0);
+      return true;
+    } catch {
+      return false;
+    }
+  }
+  /**
+   * Register interest in the daemon. Returns whether this caller is the one
+   * responsible for starting it (because no live daemon was recorded).
+   * `recordPid` is called with the started PID once the daemon is up.
+   */
+  acquire() {
+    return this.withLock(() => {
+      const state = this.read();
+      if (state && this.isAlive(state.pid)) {
+        this.write({ pid: state.pid, refs: state.refs + 1 });
+        return { shouldStart: false, commit: () => {
+        } };
+      }
+      return {
+        shouldStart: true,
+        commit: (pid) => this.withLock(() => this.write({ pid, refs: 1 }))
+      };
+    });
+  }
+  /**
+   * Drop this caller's interest. Returns the PID to kill if this was the last
+   * reference, otherwise null.
+   */
+  release() {
+    return this.withLock(() => {
+      const state = this.read();
+      if (!state) return null;
+      if (state.refs <= 1) {
+        this.clear();
+        return state.pid;
+      }
+      this.write({ pid: state.pid, refs: state.refs - 1 });
+      return null;
+    });
+  }
+};
+var FlipperServerTransport = class {
+  constructor(options = {}) {
+    this.options = options;
+    this.server = null;
+    this.refcount = new FlipperRefcount();
+    this.listeners = /* @__PURE__ */ new Set();
+    /**
+     * Client IDs that have sent at least one message through the devtools
+     * plugin — these are the clients we send outbound messages to.
+     */
+    this.activeClientIds = /* @__PURE__ */ new Set();
+    this.sendMessage = async (message) => {
+      if (!this.server) return;
+      const payload = {
+        method: "execute",
+        params: {
+          api: PLUGIN_API,
+          method: "message::flipper",
+          params: message
+        }
+      };
+      await Promise.all(
+        [...this.activeClientIds].map(
+          (clientId) => this.server.exec("client-request-response", clientId, payload).catch(
+            (err) => {
+              console.warn(
+                `[FlipperServerTransport] Failed to send to client ${clientId}:`,
+                err
+              );
+              this.activeClientIds.delete(clientId);
+            }
+          )
+        )
+      );
+    };
+    this.addListener = (callback) => {
+      this.listeners.add(callback);
+    };
+    this.removeListener = (callback) => {
+      this.listeners.delete(callback);
+    };
+  }
+  async connect() {
+    const host = this.options.host ?? "localhost";
+    const port = this.options.port ?? 52342;
+    const { shouldStart, commit } = this.refcount.acquire();
+    if (shouldStart) {
+      console.log("[FlipperServerTransport] Starting flipper-server...");
+      const serverScript = __require.resolve("flipper-server/server.js");
+      const child = spawn(process.execPath, [serverScript, "--open=true"], {
+        stdio: "inherit",
+        detached: true
+      });
+      child.on("error", (err) => {
+        console.error(
+          "[FlipperServerTransport] flipper-server process error:",
+          err
+        );
+      });
+      child.unref();
+      await waitForPort(host, port);
+      commit(child.pid);
+      console.log("[FlipperServerTransport] flipper-server ready.");
+    } else {
+      await waitForPort(host, port);
+      console.log("[FlipperServerTransport] Attached to flipper-server.");
+    }
+    const { getAuthToken } = (
+      // eslint-disable-next-line @typescript-eslint/no-require-imports
+      __require("flipper-server/lib/app-connectivity/certificate-exchange/certificate-utils")
+    );
+    let cachedToken = null;
+    try {
+      cachedToken = await getAuthToken();
+    } catch (err) {
+      console.warn("[FlipperServerTransport] Could not read auth token:", err);
+    }
+    this.server = await createFlipperServer(
+      host,
+      port,
+      () => cachedToken,
+      (state) => {
+        if (state === FlipperServerState.DISCONNECTED) {
+          console.warn("[FlipperServerTransport] Disconnected from server");
+        }
+      }
+    );
+    await this.server.connect();
+    this.server.on("client-connected", (info) => {
+      console.log(
+        "[FlipperServerTransport] client-connected:",
+        JSON.stringify(info)
+      );
+    });
+    this.server.on("client-disconnected", ({ id }) => {
+      console.log("[FlipperServerTransport] client-disconnected:", id);
+      this.activeClientIds.delete(id);
+    });
+    this.server.on("client-message", ({ id, message }) => {
+      let parsed;
+      try {
+        parsed = JSON.parse(message);
+      } catch {
+        return;
+      }
+      console.debug(
+        `[FlipperServerTransport] client-message from ${id}: method=${parsed.method} api=${parsed.params?.api} pluginMethod=${parsed.params?.method}`
+      );
+      if (parsed.method !== "execute" || parsed.params?.api !== PLUGIN_API || parsed.params?.method !== "message::plugin") {
+        return;
+      }
+      this.activeClientIds.add(id);
+      const payload = parsed.params.params;
+      for (const listener of this.listeners) {
+        listener(payload);
+      }
+    });
+  }
+  async close() {
+    this.listeners.clear();
+    this.activeClientIds.clear();
+    this.server?.close();
+    this.server = null;
+    const pidToKill = this.refcount.release();
+    if (pidToKill !== null) {
+      try {
+        process.kill(pidToKill);
+        console.log("[FlipperServerTransport] Shut down flipper-server.");
+      } catch {
+      }
+    }
+  }
+};
+export {
+  FlipperServerTransport
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs

@@ -0,0 +1,274 @@
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
+  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
+}) : x)(function(x) {
+  if (typeof require !== "undefined") return require.apply(this, arguments);
+  throw Error('Dynamic require of "' + x + '" is not supported');
+});
+
+// ../../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/client/flipper/src/transport.ts
+import {
+  createFlipperServer,
+  FlipperServerState
+} from "flipper-server-client";
+import { spawn } from "child_process";
+import * as net from "net";
+import * as fs from "fs";
+import * as os from "os";
+import * as path from "path";
+import { WebSocket as WsWebSocket } from "ws";
+if (typeof globalThis.WebSocket === "undefined") {
+  globalThis.WebSocket = WsWebSocket;
+}
+var PLUGIN_API = "player-ui-devtools";
+function waitForPort(host, port, timeoutMs = 3e4) {
+  return new Promise((resolve, reject) => {
+    const deadline = Date.now() + timeoutMs;
+    const attempt = () => {
+      const socket = net.connect(port, host);
+      socket.once("connect", () => {
+        socket.destroy();
+        resolve();
+      });
+      socket.once("error", () => {
+        socket.destroy();
+        if (Date.now() >= deadline) {
+          reject(new Error(`Timed out waiting for ${host}:${port}`));
+        } else {
+          setTimeout(attempt, 500);
+        }
+      });
+    };
+    attempt();
+  });
+}
+var FlipperRefcount = class {
+  constructor() {
+    this.dir = path.join(os.tmpdir(), "player-devtools-mcp");
+    this.file = path.join(this.dir, "flipper-server.refcount");
+    this.lock = path.join(this.dir, "flipper-server.lock");
+  }
+  /** Acquire the cross-process lock, run `fn`, then release — even on throw. */
+  withLock(fn) {
+    fs.mkdirSync(this.dir, { recursive: true });
+    const deadline = Date.now() + 5e3;
+    for (; ; ) {
+      try {
+        fs.mkdirSync(this.lock);
+        break;
+      } catch (err) {
+        if (err.code !== "EEXIST") throw err;
+        if (Date.now() >= deadline) {
+          try {
+            fs.rmdirSync(this.lock);
+          } catch {
+          }
+        }
+      }
+    }
+    try {
+      return fn();
+    } finally {
+      try {
+        fs.rmdirSync(this.lock);
+      } catch {
+      }
+    }
+  }
+  read() {
+    try {
+      return JSON.parse(fs.readFileSync(this.file, "utf8"));
+    } catch {
+      return null;
+    }
+  }
+  write(state) {
+    fs.writeFileSync(this.file, JSON.stringify(state));
+  }
+  clear() {
+    try {
+      fs.unlinkSync(this.file);
+    } catch {
+    }
+  }
+  /** Is the recorded daemon PID still alive? */
+  isAlive(pid) {
+    try {
+      process.kill(pid, 0);
+      return true;
+    } catch {
+      return false;
+    }
+  }
+  /**
+   * Register interest in the daemon. Returns whether this caller is the one
+   * responsible for starting it (because no live daemon was recorded).
+   * `recordPid` is called with the started PID once the daemon is up.
+   */
+  acquire() {
+    return this.withLock(() => {
+      const state = this.read();
+      if (state && this.isAlive(state.pid)) {
+        this.write({ pid: state.pid, refs: state.refs + 1 });
+        return { shouldStart: false, commit: () => {
+        } };
+      }
+      return {
+        shouldStart: true,
+        commit: (pid) => this.withLock(() => this.write({ pid, refs: 1 }))
+      };
+    });
+  }
+  /**
+   * Drop this caller's interest. Returns the PID to kill if this was the last
+   * reference, otherwise null.
+   */
+  release() {
+    return this.withLock(() => {
+      const state = this.read();
+      if (!state) return null;
+      if (state.refs <= 1) {
+        this.clear();
+        return state.pid;
+      }
+      this.write({ pid: state.pid, refs: state.refs - 1 });
+      return null;
+    });
+  }
+};
+var FlipperServerTransport = class {
+  constructor(options = {}) {
+    this.options = options;
+    this.server = null;
+    this.refcount = new FlipperRefcount();
+    this.listeners = /* @__PURE__ */ new Set();
+    /**
+     * Client IDs that have sent at least one message through the devtools
+     * plugin — these are the clients we send outbound messages to.
+     */
+    this.activeClientIds = /* @__PURE__ */ new Set();
+    this.sendMessage = async (message) => {
+      if (!this.server) return;
+      const payload = {
+        method: "execute",
+        params: {
+          api: PLUGIN_API,
+          method: "message::flipper",
+          params: message
+        }
+      };
+      await Promise.all(
+        [...this.activeClientIds].map(
+          (clientId) => this.server.exec("client-request-response", clientId, payload).catch(
+            (err) => {
+              console.warn(
+                `[FlipperServerTransport] Failed to send to client ${clientId}:`,
+                err
+              );
+              this.activeClientIds.delete(clientId);
+            }
+          )
+        )
+      );
+    };
+    this.addListener = (callback) => {
+      this.listeners.add(callback);
+    };
+    this.removeListener = (callback) => {
+      this.listeners.delete(callback);
+    };
+  }
+  async connect() {
+    const host = this.options.host ?? "localhost";
+    const port = this.options.port ?? 52342;
+    const { shouldStart, commit } = this.refcount.acquire();
+    if (shouldStart) {
+      console.log("[FlipperServerTransport] Starting flipper-server...");
+      const serverScript = __require.resolve("flipper-server/server.js");
+      const child = spawn(process.execPath, [serverScript, "--open=true"], {
+        stdio: "inherit",
+        detached: true
+      });
+      child.on("error", (err) => {
+        console.error(
+          "[FlipperServerTransport] flipper-server process error:",
+          err
+        );
+      });
+      child.unref();
+      await waitForPort(host, port);
+      commit(child.pid);
+      console.log("[FlipperServerTransport] flipper-server ready.");
+    } else {
+      await waitForPort(host, port);
+      console.log("[FlipperServerTransport] Attached to flipper-server.");
+    }
+    const { getAuthToken } = (
+      // eslint-disable-next-line @typescript-eslint/no-require-imports
+      __require("flipper-server/lib/app-connectivity/certificate-exchange/certificate-utils")
+    );
+    let cachedToken = null;
+    try {
+      cachedToken = await getAuthToken();
+    } catch (err) {
+      console.warn("[FlipperServerTransport] Could not read auth token:", err);
+    }
+    this.server = await createFlipperServer(
+      host,
+      port,
+      () => cachedToken,
+      (state) => {
+        if (state === FlipperServerState.DISCONNECTED) {
+          console.warn("[FlipperServerTransport] Disconnected from server");
+        }
+      }
+    );
+    await this.server.connect();
+    this.server.on("client-connected", (info) => {
+      console.log(
+        "[FlipperServerTransport] client-connected:",
+        JSON.stringify(info)
+      );
+    });
+    this.server.on("client-disconnected", ({ id }) => {
+      console.log("[FlipperServerTransport] client-disconnected:", id);
+      this.activeClientIds.delete(id);
+    });
+    this.server.on("client-message", ({ id, message }) => {
+      let parsed;
+      try {
+        parsed = JSON.parse(message);
+      } catch {
+        return;
+      }
+      console.debug(
+        `[FlipperServerTransport] client-message from ${id}: method=${parsed.method} api=${parsed.params?.api} pluginMethod=${parsed.params?.method}`
+      );
+      if (parsed.method !== "execute" || parsed.params?.api !== PLUGIN_API || parsed.params?.method !== "message::plugin") {
+        return;
+      }
+      this.activeClientIds.add(id);
+      const payload = parsed.params.params;
+      for (const listener of this.listeners) {
+        listener(payload);
+      }
+    });
+  }
+  async close() {
+    this.listeners.clear();
+    this.activeClientIds.clear();
+    this.server?.close();
+    this.server = null;
+    const pidToKill = this.refcount.release();
+    if (pidToKill !== null) {
+      try {
+        process.kill(pidToKill);
+        console.log("[FlipperServerTransport] Shut down flipper-server.");
+      } catch {
+      }
+    }
+  }
+};
+export {
+  FlipperServerTransport
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/client/flipper/src/transport.ts"],"sourcesContent":["import {\n  createFlipperServer,\n  FlipperServerState,\n  type FlipperServer,\n} from \"flipper-server-client\";\nimport { spawn } from \"child_process\";\nimport * as net from \"net\";\nimport * as fs from \"fs\";\nimport * as os from \"os\";\nimport * as path from \"path\";\nimport { WebSocket as WsWebSocket } from \"ws\";\nimport type {\n  CommunicationLayerMethods,\n  ExtensionSupportedEvents,\n  MessengerEvent,\n  TransactionMetadata,\n  Transport,\n} from \"@player-devtools/types\";\n\n// polyfill WebSocket for Node < 22\nif (typeof (globalThis as { WebSocket?: unknown }).WebSocket === \"undefined\") {\n  (globalThis as { WebSocket?: unknown }).WebSocket =\n    WsWebSocket as unknown as typeof WebSocket;\n}\n\ntype MessageCallback = (\n  message: TransactionMetadata & MessengerEvent<ExtensionSupportedEvents>,\n) => void;\n\nconst PLUGIN_API = \"player-ui-devtools\";\n\n/** Shape of a Flipper `client-message` payload after JSON.parse */\ntype FlipperExecuteMessage = {\n  method: \"execute\";\n  params: {\n    api: string;\n    method: string;\n    params?: unknown;\n  };\n};\n\n/**\n * Flipper headless transport\n *\n * Connects to a running `flipper-server` process and routes messages for the\n * \"flipper-plugin-player-ui-devtools\" plugin through to the Messenger layer.\n */\n/** Wait until a TCP port is accepting connections, polling every 500ms */\nfunction waitForPort(\n  host: string,\n  port: number,\n  timeoutMs = 30_000,\n): Promise<void> {\n  return new Promise((resolve, reject) => {\n    const deadline = Date.now() + timeoutMs;\n    const attempt = () => {\n      const socket = net.connect(port, host);\n      socket.once(\"connect\", () => {\n        socket.destroy();\n        resolve();\n      });\n      socket.once(\"error\", () => {\n        socket.destroy();\n        if (Date.now() >= deadline) {\n          reject(new Error(`Timed out waiting for ${host}:${port}`));\n        } else {\n          setTimeout(attempt, 500);\n        }\n      });\n    };\n    attempt();\n  });\n}\n\n/**\n * Cross-process refcount for the shared `flipper-server` daemon.\n *\n * Many MCP server processes (one per project/user registration) attach to a\n * single `flipper-server` on a fixed port. No in-process variable can\n * coordinate their lifecycles, so we track liveness in a small file guarded by\n * an atomic lock directory:\n *\n *   - The first attach starts the daemon and records its PID with `refs: 1`.\n *   - Each subsequent attach increments `refs`.\n *   - Each detach decrements `refs`; the last one out shuts the daemon down.\n *\n * The lock directory (`mkdir` is atomic across processes) serializes the\n * read-modify-write so concurrently-starting instances don't race.\n */\ntype RefcountFile = { pid: number; refs: number };\n\nclass FlipperRefcount {\n  private readonly dir = path.join(os.tmpdir(), \"player-devtools-mcp\");\n  private readonly file = path.join(this.dir, \"flipper-server.refcount\");\n  private readonly lock = path.join(this.dir, \"flipper-server.lock\");\n\n  /** Acquire the cross-process lock, run `fn`, then release — even on throw. */\n  private withLock<T>(fn: () => T): T {\n    fs.mkdirSync(this.dir, { recursive: true });\n    const deadline = Date.now() + 5_000;\n    // Spin on an atomic mkdir until we own the lock or time out.\n    for (;;) {\n      try {\n        fs.mkdirSync(this.lock);\n        break;\n      } catch (err) {\n        if ((err as NodeJS.ErrnoException).code !== \"EEXIST\") throw err;\n        if (Date.now() >= deadline) {\n          // Stale lock from a crashed process — reclaim it.\n          try {\n            fs.rmdirSync(this.lock);\n          } catch {\n            /* another instance won the reclaim; retry */\n          }\n        }\n      }\n    }\n    try {\n      return fn();\n    } finally {\n      try {\n        fs.rmdirSync(this.lock);\n      } catch {\n        /* already gone */\n      }\n    }\n  }\n\n  private read(): RefcountFile | null {\n    try {\n      return JSON.parse(fs.readFileSync(this.file, \"utf8\")) as RefcountFile;\n    } catch {\n      return null;\n    }\n  }\n\n  private write(state: RefcountFile): void {\n    fs.writeFileSync(this.file, JSON.stringify(state));\n  }\n\n  private clear(): void {\n    try {\n      fs.unlinkSync(this.file);\n    } catch {\n      /* already gone */\n    }\n  }\n\n  /** Is the recorded daemon PID still alive? */\n  private isAlive(pid: number): boolean {\n    try {\n      process.kill(pid, 0);\n      return true;\n    } catch {\n      return false;\n    }\n  }\n\n  /**\n   * Register interest in the daemon. Returns whether this caller is the one\n   * responsible for starting it (because no live daemon was recorded).\n   * `recordPid` is called with the started PID once the daemon is up.\n   */\n  acquire(): { shouldStart: boolean; commit: (pid: number) => void } {\n    return this.withLock(() => {\n      const state = this.read();\n      if (state && this.isAlive(state.pid)) {\n        this.write({ pid: state.pid, refs: state.refs + 1 });\n        return { shouldStart: false, commit: () => {} };\n      }\n      // No live daemon — this caller will start one and record its PID.\n      return {\n        shouldStart: true,\n        commit: (pid: number) =>\n          this.withLock(() => this.write({ pid, refs: 1 })),\n      };\n    });\n  }\n\n  /**\n   * Drop this caller's interest. Returns the PID to kill if this was the last\n   * reference, otherwise null.\n   */\n  release(): number | null {\n    return this.withLock(() => {\n      const state = this.read();\n      if (!state) return null;\n      if (state.refs <= 1) {\n        this.clear();\n        return state.pid;\n      }\n      this.write({ pid: state.pid, refs: state.refs - 1 });\n      return null;\n    });\n  }\n}\n\nexport class FlipperServerTransport implements Transport {\n  private server: FlipperServer | null = null;\n  private refcount = new FlipperRefcount();\n  private listeners = new Set<MessageCallback>();\n\n  /**\n   * Client IDs that have sent at least one message through the devtools\n   * plugin — these are the clients we send outbound messages to.\n   */\n  private activeClientIds = new Set<string>();\n\n  constructor(\n    private options: {\n      /** Flipper server host; defaults to \"localhost\" */\n      host?: string;\n      /** Flipper server WebSocket port; defaults to 52342 */\n      port?: number;\n    } = {},\n  ) {}\n\n  async connect(): Promise<void> {\n    const host = this.options.host ?? \"localhost\";\n    const port = this.options.port ?? 52342;\n\n    // Register interest in the shared daemon. The first instance to do so is\n    // told to start it; the rest just attach. The daemon outlives any single\n    // MCP process and is only torn down when the last instance detaches.\n    const { shouldStart, commit } = this.refcount.acquire();\n\n    if (shouldStart) {\n      console.log(\"[FlipperServerTransport] Starting flipper-server...\");\n      const serverScript = require.resolve(\"flipper-server/server.js\");\n      // Detached + unref'd: the daemon must survive this process exiting so\n      // other instances keep their connections. We never kill it directly —\n      // shutdown is driven by the refcount in close().\n      const child = spawn(process.execPath, [serverScript, \"--open=true\"], {\n        stdio: \"inherit\",\n        detached: true,\n      });\n      child.on(\"error\", (err: Error) => {\n        console.error(\n          \"[FlipperServerTransport] flipper-server process error:\",\n          err,\n        );\n      });\n      child.unref();\n      await waitForPort(host, port);\n      commit(child.pid!);\n      console.log(\"[FlipperServerTransport] flipper-server ready.\");\n    } else {\n      // Daemon already running (started by another instance) — wait for it to\n      // accept connections in case it's still coming up, then attach.\n      await waitForPort(host, port);\n      console.log(\"[FlipperServerTransport] Attached to flipper-server.\");\n    }\n\n    // Read the auth token the flipper-server wrote during startup\n    const { getAuthToken } =\n      // eslint-disable-next-line @typescript-eslint/no-require-imports\n      require(\"flipper-server/lib/app-connectivity/certificate-exchange/certificate-utils\") as {\n        getAuthToken: () => Promise<string>;\n      };\n\n    let cachedToken: string | null = null;\n    try {\n      cachedToken = await getAuthToken();\n    } catch (err) {\n      console.warn(\"[FlipperServerTransport] Could not read auth token:\", err);\n    }\n\n    this.server = await createFlipperServer(\n      host,\n      port,\n      () => cachedToken,\n      (state) => {\n        if (state === FlipperServerState.DISCONNECTED) {\n          console.warn(\"[FlipperServerTransport] Disconnected from server\");\n        }\n      },\n    );\n\n    await this.server.connect();\n\n    // Track client connects/disconnects\n    this.server.on(\"client-connected\", (info) => {\n      console.log(\n        \"[FlipperServerTransport] client-connected:\",\n        JSON.stringify(info),\n      );\n    });\n    this.server.on(\"client-disconnected\", ({ id }) => {\n      console.log(\"[FlipperServerTransport] client-disconnected:\", id);\n      this.activeClientIds.delete(id);\n    });\n\n    // Route inbound device messages to our Messenger listeners\n    this.server.on(\"client-message\", ({ id, message }) => {\n      let parsed: FlipperExecuteMessage;\n      try {\n        parsed = JSON.parse(message) as FlipperExecuteMessage;\n      } catch {\n        return;\n      }\n\n      console.debug(\n        `[FlipperServerTransport] client-message from ${id}: method=${parsed.method} api=${(parsed.params as { api?: string })?.api} pluginMethod=${(parsed.params as { method?: string })?.method}`,\n      );\n\n      if (\n        parsed.method !== \"execute\" ||\n        parsed.params?.api !== PLUGIN_API ||\n        parsed.params?.method !== \"message::plugin\"\n      ) {\n        return;\n      }\n\n      // This client is talking through the devtools plugin — remember it\n      this.activeClientIds.add(id);\n\n      const payload = parsed.params.params as TransactionMetadata &\n        MessengerEvent<ExtensionSupportedEvents>;\n\n      for (const listener of this.listeners) {\n        listener(payload);\n      }\n    });\n  }\n\n  sendMessage: CommunicationLayerMethods[\"sendMessage\"] = async (message) => {\n    if (!this.server) return;\n\n    const payload: FlipperExecuteMessage = {\n      method: \"execute\",\n      params: {\n        api: PLUGIN_API,\n        method: \"message::flipper\",\n        params: message,\n      },\n    };\n\n    await Promise.all(\n      [...this.activeClientIds].map((clientId) =>\n        this.server!.exec(\"client-request-response\", clientId, payload).catch(\n          (err) => {\n            console.warn(\n              `[FlipperServerTransport] Failed to send to client ${clientId}:`,\n              err,\n            );\n            // Remove dead client so we stop trying\n            this.activeClientIds.delete(clientId);\n          },\n        ),\n      ),\n    );\n  };\n\n  addListener: CommunicationLayerMethods[\"addListener\"] = (callback) => {\n    this.listeners.add(callback);\n  };\n\n  removeListener: CommunicationLayerMethods[\"removeListener\"] = (callback) => {\n    this.listeners.delete(callback);\n  };\n\n  async close(): Promise<void> {\n    this.listeners.clear();\n    this.activeClientIds.clear();\n    this.server?.close();\n    this.server = null;\n\n    // Drop our reference to the shared daemon. If we were the last user, the\n    // refcount hands back its PID and we shut it down; otherwise it keeps\n    // running for the remaining instances.\n    const pidToKill = this.refcount.release();\n    if (pidToKill !== null) {\n      try {\n        process.kill(pidToKill);\n        console.log(\"[FlipperServerTransport] Shut down flipper-server.\");\n      } catch {\n        /* already gone */\n      }\n    }\n  }\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,31 @@
+{
+  "sideEffects": false,
+  "files": [
+    "dist",
+    "src",
+    "types"
+  ],
+  "name": "@player-devtools/client-flipper",
+  "version": "0.13.1--canary.17.955",
+  "main": "dist/cjs/index.cjs",
+  "dependencies": {
+    "@player-devtools/types": "0.13.1--canary.17.955",
+    "@types/ws": "^8.0.0",
+    "flipper-server": "^0.273.0",
+    "flipper-server-client": "^0.273.0",
+    "ws": "^8.0.0",
+    "tslib": "^2.6.2"
+  },
+  "module": "dist/index.legacy-esm.js",
+  "types": "types/index.d.ts",
+  "exports": {
+    "./package.json": "./package.json",
+    "./dist/index.css": "./dist/index.css",
+    ".": {
+      "types": "./types/index.d.ts",
+      "import": "./dist/index.mjs",
+      "default": "./dist/cjs/index.cjs"
+    }
+  },
+  "peerDependencies": {}
+}

package/src/index.ts

@@ -0,0 +1 @@
+export { FlipperServerTransport } from "./transport";

package/src/transport.ts

@@ -0,0 +1,381 @@
+import {
+  createFlipperServer,
+  FlipperServerState,
+  type FlipperServer,
+} from "flipper-server-client";
+import { spawn } from "child_process";
+import * as net from "net";
+import * as fs from "fs";
+import * as os from "os";
+import * as path from "path";
+import { WebSocket as WsWebSocket } from "ws";
+import type {
+  CommunicationLayerMethods,
+  ExtensionSupportedEvents,
+  MessengerEvent,
+  TransactionMetadata,
+  Transport,
+} from "@player-devtools/types";
+
+// polyfill WebSocket for Node < 22
+if (typeof (globalThis as { WebSocket?: unknown }).WebSocket === "undefined") {
+  (globalThis as { WebSocket?: unknown }).WebSocket =
+    WsWebSocket as unknown as typeof WebSocket;
+}
+
+type MessageCallback = (
+  message: TransactionMetadata & MessengerEvent<ExtensionSupportedEvents>,
+) => void;
+
+const PLUGIN_API = "player-ui-devtools";
+
+/** Shape of a Flipper `client-message` payload after JSON.parse */
+type FlipperExecuteMessage = {
+  method: "execute";
+  params: {
+    api: string;
+    method: string;
+    params?: unknown;
+  };
+};
+
+/**
+ * Flipper headless transport
+ *
+ * Connects to a running `flipper-server` process and routes messages for the
+ * "flipper-plugin-player-ui-devtools" plugin through to the Messenger layer.
+ */
+/** Wait until a TCP port is accepting connections, polling every 500ms */
+function waitForPort(
+  host: string,
+  port: number,
+  timeoutMs = 30_000,
+): Promise<void> {
+  return new Promise((resolve, reject) => {
+    const deadline = Date.now() + timeoutMs;
+    const attempt = () => {
+      const socket = net.connect(port, host);
+      socket.once("connect", () => {
+        socket.destroy();
+        resolve();
+      });
+      socket.once("error", () => {
+        socket.destroy();
+        if (Date.now() >= deadline) {
+          reject(new Error(`Timed out waiting for ${host}:${port}`));
+        } else {
+          setTimeout(attempt, 500);
+        }
+      });
+    };
+    attempt();
+  });
+}
+
+/**
+ * Cross-process refcount for the shared `flipper-server` daemon.
+ *
+ * Many MCP server processes (one per project/user registration) attach to a
+ * single `flipper-server` on a fixed port. No in-process variable can
+ * coordinate their lifecycles, so we track liveness in a small file guarded by
+ * an atomic lock directory:
+ *
+ *   - The first attach starts the daemon and records its PID with `refs: 1`.
+ *   - Each subsequent attach increments `refs`.
+ *   - Each detach decrements `refs`; the last one out shuts the daemon down.
+ *
+ * The lock directory (`mkdir` is atomic across processes) serializes the
+ * read-modify-write so concurrently-starting instances don't race.
+ */
+type RefcountFile = { pid: number; refs: number };
+
+class FlipperRefcount {
+  private readonly dir = path.join(os.tmpdir(), "player-devtools-mcp");
+  private readonly file = path.join(this.dir, "flipper-server.refcount");
+  private readonly lock = path.join(this.dir, "flipper-server.lock");
+
+  /** Acquire the cross-process lock, run `fn`, then release — even on throw. */
+  private withLock<T>(fn: () => T): T {
+    fs.mkdirSync(this.dir, { recursive: true });
+    const deadline = Date.now() + 5_000;
+    // Spin on an atomic mkdir until we own the lock or time out.
+    for (;;) {
+      try {
+        fs.mkdirSync(this.lock);
+        break;
+      } catch (err) {
+        if ((err as NodeJS.ErrnoException).code !== "EEXIST") throw err;
+        if (Date.now() >= deadline) {
+          // Stale lock from a crashed process — reclaim it.
+          try {
+            fs.rmdirSync(this.lock);
+          } catch {
+            /* another instance won the reclaim; retry */
+          }
+        }
+      }
+    }
+    try {
+      return fn();
+    } finally {
+      try {
+        fs.rmdirSync(this.lock);
+      } catch {
+        /* already gone */
+      }
+    }
+  }
+
+  private read(): RefcountFile | null {
+    try {
+      return JSON.parse(fs.readFileSync(this.file, "utf8")) as RefcountFile;
+    } catch {
+      return null;
+    }
+  }
+
+  private write(state: RefcountFile): void {
+    fs.writeFileSync(this.file, JSON.stringify(state));
+  }
+
+  private clear(): void {
+    try {
+      fs.unlinkSync(this.file);
+    } catch {
+      /* already gone */
+    }
+  }
+
+  /** Is the recorded daemon PID still alive? */
+  private isAlive(pid: number): boolean {
+    try {
+      process.kill(pid, 0);
+      return true;
+    } catch {
+      return false;
+    }
+  }
+
+  /**
+   * Register interest in the daemon. Returns whether this caller is the one
+   * responsible for starting it (because no live daemon was recorded).
+   * `recordPid` is called with the started PID once the daemon is up.
+   */
+  acquire(): { shouldStart: boolean; commit: (pid: number) => void } {
+    return this.withLock(() => {
+      const state = this.read();
+      if (state && this.isAlive(state.pid)) {
+        this.write({ pid: state.pid, refs: state.refs + 1 });
+        return { shouldStart: false, commit: () => {} };
+      }
+      // No live daemon — this caller will start one and record its PID.
+      return {
+        shouldStart: true,
+        commit: (pid: number) =>
+          this.withLock(() => this.write({ pid, refs: 1 })),
+      };
+    });
+  }
+
+  /**
+   * Drop this caller's interest. Returns the PID to kill if this was the last
+   * reference, otherwise null.
+   */
+  release(): number | null {
+    return this.withLock(() => {
+      const state = this.read();
+      if (!state) return null;
+      if (state.refs <= 1) {
+        this.clear();
+        return state.pid;
+      }
+      this.write({ pid: state.pid, refs: state.refs - 1 });
+      return null;
+    });
+  }
+}
+
+export class FlipperServerTransport implements Transport {
+  private server: FlipperServer | null = null;
+  private refcount = new FlipperRefcount();
+  private listeners = new Set<MessageCallback>();
+
+  /**
+   * Client IDs that have sent at least one message through the devtools
+   * plugin — these are the clients we send outbound messages to.
+   */
+  private activeClientIds = new Set<string>();
+
+  constructor(
+    private options: {
+      /** Flipper server host; defaults to "localhost" */
+      host?: string;
+      /** Flipper server WebSocket port; defaults to 52342 */
+      port?: number;
+    } = {},
+  ) {}
+
+  async connect(): Promise<void> {
+    const host = this.options.host ?? "localhost";
+    const port = this.options.port ?? 52342;
+
+    // Register interest in the shared daemon. The first instance to do so is
+    // told to start it; the rest just attach. The daemon outlives any single
+    // MCP process and is only torn down when the last instance detaches.
+    const { shouldStart, commit } = this.refcount.acquire();
+
+    if (shouldStart) {
+      console.log("[FlipperServerTransport] Starting flipper-server...");
+      const serverScript = require.resolve("flipper-server/server.js");
+      // Detached + unref'd: the daemon must survive this process exiting so
+      // other instances keep their connections. We never kill it directly —
+      // shutdown is driven by the refcount in close().
+      const child = spawn(process.execPath, [serverScript, "--open=true"], {
+        stdio: "inherit",
+        detached: true,
+      });
+      child.on("error", (err: Error) => {
+        console.error(
+          "[FlipperServerTransport] flipper-server process error:",
+          err,
+        );
+      });
+      child.unref();
+      await waitForPort(host, port);
+      commit(child.pid!);
+      console.log("[FlipperServerTransport] flipper-server ready.");
+    } else {
+      // Daemon already running (started by another instance) — wait for it to
+      // accept connections in case it's still coming up, then attach.
+      await waitForPort(host, port);
+      console.log("[FlipperServerTransport] Attached to flipper-server.");
+    }
+
+    // Read the auth token the flipper-server wrote during startup
+    const { getAuthToken } =
+      // eslint-disable-next-line @typescript-eslint/no-require-imports
+      require("flipper-server/lib/app-connectivity/certificate-exchange/certificate-utils") as {
+        getAuthToken: () => Promise<string>;
+      };
+
+    let cachedToken: string | null = null;
+    try {
+      cachedToken = await getAuthToken();
+    } catch (err) {
+      console.warn("[FlipperServerTransport] Could not read auth token:", err);
+    }
+
+    this.server = await createFlipperServer(
+      host,
+      port,
+      () => cachedToken,
+      (state) => {
+        if (state === FlipperServerState.DISCONNECTED) {
+          console.warn("[FlipperServerTransport] Disconnected from server");
+        }
+      },
+    );
+
+    await this.server.connect();
+
+    // Track client connects/disconnects
+    this.server.on("client-connected", (info) => {
+      console.log(
+        "[FlipperServerTransport] client-connected:",
+        JSON.stringify(info),
+      );
+    });
+    this.server.on("client-disconnected", ({ id }) => {
+      console.log("[FlipperServerTransport] client-disconnected:", id);
+      this.activeClientIds.delete(id);
+    });
+
+    // Route inbound device messages to our Messenger listeners
+    this.server.on("client-message", ({ id, message }) => {
+      let parsed: FlipperExecuteMessage;
+      try {
+        parsed = JSON.parse(message) as FlipperExecuteMessage;
+      } catch {
+        return;
+      }
+
+      console.debug(
+        `[FlipperServerTransport] client-message from ${id}: method=${parsed.method} api=${(parsed.params as { api?: string })?.api} pluginMethod=${(parsed.params as { method?: string })?.method}`,
+      );
+
+      if (
+        parsed.method !== "execute" ||
+        parsed.params?.api !== PLUGIN_API ||
+        parsed.params?.method !== "message::plugin"
+      ) {
+        return;
+      }
+
+      // This client is talking through the devtools plugin — remember it
+      this.activeClientIds.add(id);
+
+      const payload = parsed.params.params as TransactionMetadata &
+        MessengerEvent<ExtensionSupportedEvents>;
+
+      for (const listener of this.listeners) {
+        listener(payload);
+      }
+    });
+  }
+
+  sendMessage: CommunicationLayerMethods["sendMessage"] = async (message) => {
+    if (!this.server) return;
+
+    const payload: FlipperExecuteMessage = {
+      method: "execute",
+      params: {
+        api: PLUGIN_API,
+        method: "message::flipper",
+        params: message,
+      },
+    };
+
+    await Promise.all(
+      [...this.activeClientIds].map((clientId) =>
+        this.server!.exec("client-request-response", clientId, payload).catch(
+          (err) => {
+            console.warn(
+              `[FlipperServerTransport] Failed to send to client ${clientId}:`,
+              err,
+            );
+            // Remove dead client so we stop trying
+            this.activeClientIds.delete(clientId);
+          },
+        ),
+      ),
+    );
+  };
+
+  addListener: CommunicationLayerMethods["addListener"] = (callback) => {
+    this.listeners.add(callback);
+  };
+
+  removeListener: CommunicationLayerMethods["removeListener"] = (callback) => {
+    this.listeners.delete(callback);
+  };
+
+  async close(): Promise<void> {
+    this.listeners.clear();
+    this.activeClientIds.clear();
+    this.server?.close();
+    this.server = null;
+
+    // Drop our reference to the shared daemon. If we were the last user, the
+    // refcount hands back its PID and we shut it down; otherwise it keeps
+    // running for the remaining instances.
+    const pidToKill = this.refcount.release();
+    if (pidToKill !== null) {
+      try {
+        process.kill(pidToKill);
+        console.log("[FlipperServerTransport] Shut down flipper-server.");
+      } catch {
+        /* already gone */
+      }
+    }
+  }
+}

package/types/index.d.ts

@@ -0,0 +1,2 @@
+export { FlipperServerTransport } from "./transport";
+//# sourceMappingURL=index.d.ts.map

package/types/transport.d.ts

@@ -0,0 +1,24 @@
+import type { CommunicationLayerMethods, Transport } from "@player-devtools/types";
+export declare class FlipperServerTransport implements Transport {
+    private options;
+    private server;
+    private refcount;
+    private listeners;
+    /**
+     * Client IDs that have sent at least one message through the devtools
+     * plugin — these are the clients we send outbound messages to.
+     */
+    private activeClientIds;
+    constructor(options?: {
+        /** Flipper server host; defaults to "localhost" */
+        host?: string;
+        /** Flipper server WebSocket port; defaults to 52342 */
+        port?: number;
+    });
+    connect(): Promise<void>;
+    sendMessage: CommunicationLayerMethods["sendMessage"];
+    addListener: CommunicationLayerMethods["addListener"];
+    removeListener: CommunicationLayerMethods["removeListener"];
+    close(): Promise<void>;
+}
+//# sourceMappingURL=transport.d.ts.map