@buoy-gg/external-sync 7.0.40 → 7.0.42

package/lib/commonjs/types.js

@@ -1,97 +1 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.SYNC_PROTOCOL_VERSION = void 0;
-// ============================================================
-// DEVTOOL SYNC PROTOCOL (v1)
-//
-// Topology: device is a Socket.IO client; the desktop app hosts
-// the server (broker) and one or more dashboard UIs. The server
-// routes messages between dashboards and devices.
-//
-// Device -> server/dashboard events:
-//   "devtool-capabilities"  DeviceCapabilitiesMessage
-//   "devtool-sync"          DevToolSyncMessage
-//   "devtool-action-result" DevToolActionResultMessage
-//
-// Dashboard/server -> device events:
-//   "devtool-watch"         DevToolWatchMessage
-//   "request-devtool-state" DevToolRequestMessage
-//   "devtool-action"        DevToolActionMessage
-//
-// Backpressure contract: the device sends nothing for a tool until
-// it receives `devtool-watch {watching: true}` for it. The SERVER is
-// responsible for consolidating watch state across dashboards (and
-// for sending `watching: false` when the last watching dashboard
-// closes a panel or disconnects). The device just obeys.
-// ============================================================
-
-/** Version of the envelope/event contract itself (not tool payloads). */
-const SYNC_PROTOCOL_VERSION = exports.SYNC_PROTOCOL_VERSION = 1;
-
-/** What a sync payload represents. "events"/"diff" reserved for future use. */
-
-// ============================================================
-// TOOL ADAPTER
-// ============================================================
-
-/** A remote-invocable action. Thrown errors are reported back to the dashboard. */
-
-/**
- * The contract each dev tool implements to become remotely syncable.
- * Works with BaseEventStore or any pattern exposing subscribe + getSnapshot.
- *
- * Payloads (snapshots and action results) must be JSON-serializable —
- * no functions, circular references, or class instances.
- */
-
-// ============================================================
-// DEVICE -> DASHBOARD MESSAGES
-// ============================================================
-
-/** Announces available tools + actions on connect and when tools change. */
-
-/** Carries a tool's state to the dashboard. */
-
-/** Response to a `devtool-action` request. */
-
-// ============================================================
-// DASHBOARD -> DEVICE MESSAGES
-// ============================================================
-
-/**
- * Server-consolidated signal that a tool gained/lost its audience.
- *
- * `watching` arms CAPTURE: the device subscribes to the tool, which is what
- * makes its store start recording. `stream` decides whether the device also
- * PUSHES a snapshot on every change (throttled), which is the expensive half —
- * it serializes the whole payload on the JS thread ~5x/sec.
- *
- * Those are separate because their audiences are: a dashboard renders every
- * snapshot, so it wants both. A request/response client (MCP) reads on demand
- * via `request-devtool-state` and would throw the stream away — but it still
- * needs the device to be RECORDING between its reads, or it only ever sees an
- * empty list and concludes the app made no requests.
- */
-
-/** Explicit request for a tool's current state (works even while unwatched). */
-
-/** Invokes a registered action on the device. */
-
-// ============================================================
-// HOOK PROPS
-// ============================================================
-
-// ============================================================
-// PLATFORM
-// ============================================================
-
-/**
- * Valid platform operating systems that can be used with React Native
- */
-
-// ============================================================
-// SOCKET HOOK PROPS
-// ============================================================
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.SYNC_PROTOCOL_VERSION=void 0;const SYNC_PROTOCOL_VERSION=exports.SYNC_PROTOCOL_VERSION=1;

package/lib/commonjs/useExternalSync.js

@@ -1,73 +1 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.useExternalSync = useExternalSync;
-var _license = require("@buoy-gg/license");
-var _react = require("react");
-var _attachDeviceSync = require("./attachDeviceSync");
-/**
- * Device-side sync bridge: syncs any number of dev tools to the desktop
- * dashboard and executes actions invoked remotely.
- *
- * Backpressure: a tool's adapter is only subscribed while a dashboard is
- * watching it (`devtool-watch`), so unwatched tools cost nothing. The server
- * re-sends current watch state whenever it receives `devtool-capabilities`,
- * which the device announces on every (re)connect.
- *
- * Usage:
- * ```ts
- * useExternalSync({
- *   tools: {
- *     storage: {
- *       version: 1,
- *       getSnapshot: () => storageEventStore.getEvents(),
- *       subscribe: (cb) => storageEventStore.subscribeToEvents(cb),
- *       actions: {
- *         clearEvents: () => storageEventStore.clearEvents(),
- *       },
- *     },
- *   },
- *   socket,
- *   deviceId: 'my-device-id',
- * });
- * ```
- */
-function useExternalSync({
-  tools,
-  socket,
-  deviceId,
-  enabled = true,
-  throttleMs = 200,
-  enableLogs = false
-}) {
-  const account = (0, _license.useAccountAccess)();
-  const admitted = account.status === "admitted";
-  const toolsRef = (0, _react.useRef)(tools);
-  toolsRef.current = tools;
-
-  // Watch state persists across effect re-runs (e.g. when tools are
-  // added/removed) so an already-watched tool stays subscribed.
-  const watchedRef = (0, _react.useRef)(new Map());
-
-  // Re-run the effect only when tools are added/removed, not on every
-  // object-reference change.
-  const toolIdsKey = Object.keys(tools).sort().join(",");
-  (0, _react.useEffect)(() => {
-    if (!socket || !deviceId || !enabled || !admitted) {
-      watchedRef.current.clear();
-      return;
-    }
-    return (0, _attachDeviceSync.attachDeviceSync)({
-      socket,
-      deviceId,
-      getTools: () => toolsRef.current,
-      watched: watchedRef.current,
-      throttleMs,
-      enableLogs
-    });
-    // toolIdsKey stands in for `tools` (see comment above its definition).
-    // eslint-disable-next-line react-hooks/exhaustive-deps
-  }, [socket, deviceId, enabled, admitted, throttleMs, enableLogs, toolIdsKey]);
-}
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.useExternalSync=useExternalSync;var _license=require("@buoy-gg/license");var _react=require("react");var _attachDeviceSync=require("./attachDeviceSync");function useExternalSync({tools:e,socket:t,deviceId:c,enabled:r=true,throttleMs:n=200,enableLogs:u=false}){const o=(0,_license.useAccountAccess)();const s=o.status==="admitted";const a=(0,_react.useRef)(e);a.current=e;const i=(0,_react.useRef)(new Map);const f=Object.keys(e).sort().join(",");(0,_react.useEffect)(()=>{if(!t||!c||!r||!s){i.current.clear();return}return(0,_attachDeviceSync.attachDeviceSync)({socket:t,deviceId:c,getTools:()=>a.current,watched:i.current,throttleMs:n,enableLogs:u})},[t,c,r,s,n,u,f])}

package/lib/commonjs/useExternalSyncSocket.js

@@ -1,241 +1 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.buildHandshakeQuery = buildHandshakeQuery;
-exports.getInstanceId = getInstanceId;
-exports.useExternalSyncSocket = useExternalSyncSocket;
-var _brokerAccess = require("./brokerAccess");
-var _react = require("react");
-var _socket = require("socket.io-client");
-var _platformUtils = require("./utils/platformUtils");
-var _getDefaultSocketURL = require("./utils/getDefaultSocketURL");
-var _logger = require("./utils/logger");
-var _syncStatusStore = require("./syncStatusStore");
-// True only in development. Guarded so it doesn't throw in environments
-// (web/electron bundles) where __DEV__ may be undefined.
-const isDev = typeof __DEV__ !== "undefined" ? __DEV__ : false;
-
-/**
- * Singleton socket instance that persists across component renders.
- * Multiple components share the same socket connection.
- */
-let globalSocketInstance = null;
-let currentSocketURL = "";
-let currentDeviceId = "";
-let currentPlatform = "";
-
-/**
- * Identifies a single socket INSTANCE. Sent in the handshake query and reused
- * for the life of the instance, so it survives socket.io reconnects but
- * changes whenever we create a brand-new socket (remount / Fast Refresh /
- * URL change). The dashboard uses this to tell a flapping connection that's
- * merely reconnecting (stable nonce) from an app that keeps recreating its
- * socket (changing nonce).
- */
-const makeConnectionNonce = () => `${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 10)}`;
-
-/**
- * Identifies this JS RUNTIME, not this socket. Held on globalThis so every
- * socket the runtime opens (Fast Refresh, remounts, a double-mounted dev
- * tools layer) carries the same value, while a second app that pinned the
- * same deviceId carries a different one. That difference is the only way
- * the broker can tell "one device, many sockets" from "many devices, one
- * id" — it flags the latter as a collision in the device list.
- */
-function getInstanceId() {
-  const g = globalThis;
-  if (!g.__buoyInstanceId) g.__buoyInstanceId = makeConnectionNonce();
-  return g.__buoyInstanceId;
-}
-/**
- * The socket.io handshake query — the ONE place the device says who it is.
- * `connectionNonce` is fresh per socket instance; `instanceId` is fixed per
- * runtime (see above). Pure, so the shape is unit-tested.
- */
-function buildHandshakeQuery(identity) {
-  const withoutAccountKey = values => values && Object.fromEntries(Object.entries(values).filter(([key]) => !["BUOY_LICENSE_KEY", "BUOY_KEY", "EXPO_PUBLIC_BUOY_KEY", "VITE_BUOY_KEY", "REACT_APP_BUOY_KEY", "licenseKey"].includes(key)));
-  return {
-    deviceName: identity.deviceName,
-    deviceId: identity.persistentDeviceId,
-    platform: identity.platform,
-    extraDeviceInfo: JSON.stringify(withoutAccountKey(identity.extraDeviceInfo)),
-    envVariables: JSON.stringify(withoutAccountKey(identity.envVariables)),
-    connectionNonce: makeConnectionNonce(),
-    instanceId: getInstanceId()
-  };
-}
-
-/**
- * Hook that manages a Socket.IO connection for device-to-dashboard communication.
- *
- * Features:
- * - Singleton pattern for socket connection
- * - Platform-specific URL handling (Android emulator -> 10.0.2.2)
- * - Connection state tracking
- */
-function useExternalSyncSocket({
-  deviceName,
-  socketURL,
-  persistentDeviceId,
-  extraDeviceInfo,
-  envVariables,
-  platform,
-  enableLogs = false
-}) {
-  const socketRef = (0, _react.useRef)(null);
-  const [socket, setSocket] = (0, _react.useState)(null);
-  const [isConnected, setIsConnected] = (0, _react.useState)(false);
-  // Derived once per render; stable string, so effect deps stay quiet.
-  const resolvedSocketURL = socketURL ?? (0, _getDefaultSocketURL.getDefaultSocketURL)();
-  // Tracks whether we've already logged a connection error for the current
-  // outage, so the reconnection backoff doesn't spam an error on every retry.
-  const hasLoggedConnectError = (0, _react.useRef)(false);
-  const logPrefix = `[${deviceName}]`;
-  const onConnect = () => {
-    (0, _logger.log)(`${logPrefix} Socket connected successfully`, enableLogs);
-    hasLoggedConnectError.current = false;
-    setIsConnected(true);
-    (0, _syncStatusStore.setSyncStatus)({
-      state: "connected",
-      lastError: null
-    });
-  };
-  const onDisconnect = reason => {
-    (0, _logger.log)(`${logPrefix} Socket disconnected. Reason: ${reason}`, enableLogs);
-    setIsConnected(false);
-    (0, _syncStatusStore.setSyncStatus)({
-      state: "retrying"
-    });
-  };
-  const onConnectError = error => {
-    (0, _syncStatusStore.setSyncStatus)({
-      state: "retrying",
-      lastError: error.message
-    });
-    // Never surface this in production builds.
-    if (!isDev) return;
-    // Reconnection retries indefinitely; only log the first failure of an
-    // outage to avoid flooding the console until the server comes back up.
-    if (hasLoggedConnectError.current) return;
-    hasLoggedConnectError.current = true;
-    // A localhost target on an Android device means a USB (adb reverse)
-    // setup — name the exact command instead of the generic hint.
-    const hint = platform === "android" && /localhost|127\.0\.0\.1/.test(currentSocketURL) ? `If this device is connected over USB, run: adb reverse tcp:42831 tcp:42831. ` : `If it's running on another machine or port, pass socketURL via the externalSync prop. `;
-    (0, _logger.log)(`[buoy] desktop sync: can't reach ${currentSocketURL} (is Buoy Desktop running?). ` + `Retrying in the background. ${hint}(${error.message})`, enableLogs, "warn");
-  };
-  const onConnectTimeout = () => {
-    (0, _logger.log)(`${logPrefix} Socket connection timeout`, enableLogs, "error");
-  };
-
-  // Reuse the transport, but reattach listeners after every effect setup
-  // (including React Strict Mode replay and Fast Refresh).
-  (0, _react.useEffect)(() => {
-    if (!persistentDeviceId) return;
-    const platformUrl = (0, _platformUtils.getPlatformSpecificURL)(resolvedSocketURL, platform);
-    (0, _syncStatusStore.setSyncStatus)({
-      targetURL: platformUrl,
-      state: "connecting",
-      lastError: null
-    });
-    (0, _logger.log)(`${logPrefix} Platform: ${platform}, using URL: ${platformUrl}`, enableLogs);
-    try {
-      if (globalSocketInstance && (currentSocketURL !== platformUrl || currentDeviceId !== persistentDeviceId || currentPlatform !== platform)) {
-        globalSocketInstance.disconnect();
-        globalSocketInstance = null;
-      }
-      if (!globalSocketInstance) {
-        (0, _logger.log)(`${logPrefix} Creating new socket instance to ${platformUrl}`, enableLogs);
-        globalSocketInstance = (0, _socket.io)(platformUrl, {
-          autoConnect: true,
-          query: buildHandshakeQuery({
-            deviceName,
-            persistentDeviceId,
-            platform,
-            extraDeviceInfo,
-            envVariables
-          }),
-          reconnection: true,
-          reconnectionAttempts: Infinity,
-          reconnectionDelay: 1000,
-          reconnectionDelayMax: 5000,
-          transports: ["websocket"]
-        });
-        currentSocketURL = platformUrl;
-        currentDeviceId = persistentDeviceId;
-        currentPlatform = platform;
-      } else {
-        (0, _logger.log)(`${logPrefix} Reusing existing socket instance to ${platformUrl}`, enableLogs);
-      }
-      socketRef.current = globalSocketInstance;
-      const activeSocket = socketRef.current;
-      setSocket(activeSocket);
-      activeSocket.on("connect_error", onConnectError);
-      activeSocket.on("connect_timeout", onConnectTimeout);
-      setIsConnected(activeSocket.connected);
-      if (activeSocket.connected) {
-        (0, _logger.log)(`${logPrefix} Socket already connected on init`, enableLogs);
-      }
-      activeSocket.on("connect", onConnect);
-      activeSocket.on("disconnect", onDisconnect);
-      return () => {
-        (0, _logger.log)(`${logPrefix} Cleaning up socket event listeners`, enableLogs);
-        activeSocket.off("connect", onConnect);
-        activeSocket.off("disconnect", onDisconnect);
-        activeSocket.off("connect_error", onConnectError);
-        activeSocket.off("connect_timeout", onConnectTimeout);
-      };
-    } catch (error) {
-      (0, _logger.log)(`${logPrefix} Failed to initialize socket: ${error}`, enableLogs, "error");
-    }
-  }, [persistentDeviceId, resolvedSocketURL, platform]);
-
-  // Update socket query parameters when deviceName changes
-  (0, _react.useEffect)(() => {
-    if (socketRef.current && socketRef.current.io.opts.query && persistentDeviceId) {
-      (0, _logger.log)(`${logPrefix} Updating device name in socket connection`, enableLogs);
-      socketRef.current.io.opts.query = {
-        ...socketRef.current.io.opts.query,
-        deviceName,
-        deviceId: persistentDeviceId,
-        platform
-      };
-    }
-  }, [deviceName, logPrefix, persistentDeviceId, platform, enableLogs]);
-  function connect() {
-    if (socketRef.current && !socketRef.current.connected) {
-      (0, _logger.log)(`${logPrefix} Manually connecting to socket server`, enableLogs);
-      socketRef.current.connect();
-    }
-  }
-  function disconnect() {
-    if (socketRef.current && socketRef.current.connected) {
-      (0, _logger.log)(`${logPrefix} Manually disconnecting from socket server`, enableLogs);
-      socketRef.current.disconnect();
-    }
-  }
-
-  // A connected transport is not permission to sync. Legacy desktop brokers
-  // never send this announcement, so updated SDKs withhold tools from them.
-  const [admittedSocket, setAdmittedSocket] = (0, _react.useState)(null);
-  (0, _react.useEffect)(() => {
-    if (!socket) return;
-    return (0, _brokerAccess.watchBrokerAccess)(socket, ready => {
-      setAdmittedSocket(ready ? socket : null);
-      (0, _syncStatusStore.setSyncStatus)(ready ? {
-        state: "connected",
-        lastError: null
-      } : {
-        state: "retrying",
-        lastError: "Update Buoy Desktop and sign in to enable desktop sync."
-      });
-    });
-  }, [socket]);
-  return {
-    socket: admittedSocket === socket ? socket : null,
-    connect,
-    disconnect,
-    isConnected: isConnected && admittedSocket === socket && socket !== null
-  };
-}
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.buildHandshakeQuery=buildHandshakeQuery;exports.getInstanceId=getInstanceId;exports.useExternalSyncSocket=useExternalSyncSocket;var _brokerAccess=require("./brokerAccess");var _react=require("react");var _socket=require("socket.io-client");var _platformUtils=require("./utils/platformUtils");var _getDefaultSocketURL=require("./utils/getDefaultSocketURL");var _logger=require("./utils/logger");var _syncStatusStore=require("./syncStatusStore");var _realNow=require("./realNow");const isDev=typeof __DEV__!=="undefined"?__DEV__:false;let globalSocketInstance=null;let currentSocketURL="";let currentDeviceId="";let currentPlatform="";let socketUsers=0;let releaseTimer=null;const RELEASE_GRACE_MS=2e3;const makeConnectionNonce=()=>`${Date.now().toString(36)}-${Math.random().toString(36).slice(2,10)}`;function getInstanceId(){const c=globalThis;if(!c.__buoyInstanceId)c.__buoyInstanceId=makeConnectionNonce();return c.__buoyInstanceId}function buildHandshakeQuery(c){const l=s=>s&&Object.fromEntries(Object.entries(s).filter(([a])=>!["BUOY_LICENSE_KEY","BUOY_KEY","EXPO_PUBLIC_BUOY_KEY","VITE_BUOY_KEY","REACT_APP_BUOY_KEY","licenseKey"].includes(a)));return{deviceName:c.deviceName,deviceId:c.persistentDeviceId,platform:c.platform,extraDeviceInfo:JSON.stringify(l(c.extraDeviceInfo)),envVariables:JSON.stringify(l(c.envVariables)),connectionNonce:makeConnectionNonce(),instanceId:getInstanceId()}}function useExternalSyncSocket({deviceName:c,socketURL:l,persistentDeviceId:s,extraDeviceInfo:a,envVariables:$,platform:u,enableLogs:t=false}){const r=(0,_react.useRef)(null);const[i,U]=(0,_react.useState)(null);const[v,f]=(0,_react.useState)(false);const S=l??(0,_getDefaultSocketURL.getDefaultSocketURL)();const d=(0,_react.useRef)(false);const o=`[${c}]`;const k=()=>{(0,_logger.log)(`${o} Socket connected successfully`,t);d.current=false;f(true);(0,_syncStatusStore.setSyncStatus)({state:"connected",lastError:null})};const g=n=>{(0,_logger.log)(`${o} Socket disconnected. Reason: ${n}`,t);f(false);(0,_syncStatusStore.setSyncStatus)({state:"retrying"})};const _=n=>{(0,_syncStatusStore.setSyncStatus)({state:"retrying",lastError:n.message});if(!isDev)return;if(d.current)return;d.current=true;const e=u==="android"&&/localhost|127\.0\.0\.1/.test(currentSocketURL)?`If this device is connected over USB, run: adb reverse tcp:42831 tcp:42831. `:`If it's running on another machine or port, pass socketURL via the externalSync prop. `;(0,_logger.log)(`[buoy] desktop sync: can't reach ${currentSocketURL} (is Buoy Desktop running?). Retrying in the background. ${e}(${n.message})`,t,"warn")};const y=()=>{(0,_logger.log)(`${o} Socket connection timeout`,t,"error")};(0,_react.useEffect)(()=>{if(!s)return;const n=(0,_platformUtils.getPlatformSpecificURL)(S,u);(0,_syncStatusStore.setSyncStatus)({targetURL:n,state:"connecting",lastError:null});(0,_logger.log)(`${o} Platform: ${u}, using URL: ${n}`,t);try{if(globalSocketInstance&&(currentSocketURL!==n||currentDeviceId!==s||currentPlatform!==u)){globalSocketInstance.disconnect();globalSocketInstance=null}if(!globalSocketInstance){(0,_logger.log)(`${o} Creating new socket instance to ${n}`,t);globalSocketInstance=(0,_socket.io)(n,{autoConnect:true,query:buildHandshakeQuery({deviceName:c,persistentDeviceId:s,platform:u,extraDeviceInfo:a,envVariables:$}),reconnection:true,reconnectionAttempts:Infinity,reconnectionDelay:1e3,reconnectionDelayMax:5e3,transports:["websocket"]});(0,_realNow.pinSocketTimers)(globalSocketInstance);currentSocketURL=n;currentDeviceId=s;currentPlatform=u}else{(0,_logger.log)(`${o} Reusing existing socket instance to ${n}`,t)}r.current=globalSocketInstance;const e=r.current;socketUsers++;if(releaseTimer){(0,_realNow.realClearTimeout)(releaseTimer);releaseTimer=null}U(e);e.on("connect_error",_);e.on("connect_timeout",y);f(e.connected);if(e.connected){(0,_logger.log)(`${o} Socket already connected on init`,t)}e.on("connect",k);e.on("disconnect",g);return()=>{(0,_logger.log)(`${o} Cleaning up socket event listeners`,t);e.off("connect",k);e.off("disconnect",g);e.off("connect_error",_);e.off("connect_timeout",y);socketUsers--;if(socketUsers===0){releaseTimer=(0,_realNow.realSetTimeout)(()=>{releaseTimer=null;if(socketUsers>0||globalSocketInstance!==e)return;(0,_logger.log)(`${o} No longer used; disconnecting`,t);e.disconnect();globalSocketInstance=null;(0,_syncStatusStore.setSyncStatus)({state:"idle",lastError:null})},RELEASE_GRACE_MS)}}}catch(e){(0,_logger.log)(`${o} Failed to initialize socket: ${e}`,t,"error")}},[s,S,u]);(0,_react.useEffect)(()=>{if(r.current&&r.current.io.opts.query&&s){(0,_logger.log)(`${o} Updating device name in socket connection`,t);r.current.io.opts.query={...r.current.io.opts.query,deviceName:c,deviceId:s,platform:u}}},[c,o,s,u,t]);function m(){if(r.current&&!r.current.connected){(0,_logger.log)(`${o} Manually connecting to socket server`,t);r.current.connect()}}function I(){if(r.current&&r.current.connected){(0,_logger.log)(`${o} Manually disconnecting from socket server`,t);r.current.disconnect()}}const[E,R]=(0,_react.useState)(null);(0,_react.useEffect)(()=>{if(!i)return;return(0,_brokerAccess.watchBrokerAccess)(i,n=>{R(n?i:null);(0,_syncStatusStore.setSyncStatus)(n?{state:"connected",lastError:null}:{state:"retrying",lastError:"Update Buoy Desktop and sign in to enable desktop sync."})})},[i]);return{socket:E===i?i:null,connect:m,disconnect:I,isConnected:v&&E===i&&i!==null}}

package/lib/commonjs/utils/getDefaultSocketURL.js

@@ -1,80 +1 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.DEFAULT_BROKER_PORT = void 0;
-exports.getDefaultSocketURL = getDefaultSocketURL;
-exports.getMetroHost = getMetroHost;
-exports.hostFromScriptURL = hostFromScriptURL;
-exports.socketURLForHost = socketURLForHost;
-/**
- * Default broker-URL derivation. Kept in its own module (and never imported
- * from types.ts) because the deep react-native require below must not reach
- * non-Metro bundles — the desktop app imports this package's types only.
- */
-
-/** Port Buoy Desktop's broker listens on. */
-const DEFAULT_BROKER_PORT = exports.DEFAULT_BROKER_PORT = 42831;
-const HOST_RE = /^https?:\/\/([^:/]+)/;
-
-/**
- * Host out of a bundle's scriptURL, or null when there isn't one.
- *
- * Release bundles are loaded from disk (`file:///.../main.jsbundle`), so this
- * returns null and callers fall back to localhost — correct for simulators,
- * emulators, and Android over USB (`adb reverse tcp:42831 tcp:42831`). A
- * physical iOS device in a release build has no derivable host at all and
- * must be given an explicit socketURL.
- */
-function hostFromScriptURL(scriptURL) {
-  return scriptURL?.match(HOST_RE)?.[1] ?? null;
-}
-
-/** Broker URL for a host, falling back to localhost when none is known. */
-function socketURLForHost(host) {
-  return `http://${host ?? "localhost"}:${DEFAULT_BROKER_PORT}`;
-}
-
-/**
- * Host of the Metro dev server that served this bundle — the machine most
- * likely running Buoy Desktop. On a physical device this is the computer's
- * LAN IP, where "localhost" would be the phone itself.
- *
- * scriptURL is the only source that works everywhere we've tested:
- * NativeModules.SourceCode.scriptURL is undefined on bridgeless, and
- * expo-constants hostUri/experienceUrl/linkingUri are all undefined in
- * Expo dev-client builds. Returns null on web or if RN internals move.
- */
-function getMetroHost() {
-  try {
-    // Requires stay lexically inside try{} so Metro treats them as optional;
-    // react-native-web has neither path and falls through to null.
-    const NativeSourceCode =
-    // eslint-disable-next-line @typescript-eslint/no-var-requires
-    require("react-native/Libraries/NativeModules/specs/NativeSourceCode").default;
-    const host = hostFromScriptURL(NativeSourceCode?.getConstants?.().scriptURL);
-    if (host) return host;
-  } catch {
-    // web / RN internals moved — try the old-architecture module
-  }
-  try {
-    const {
-      NativeModules
-    } = require("react-native");
-    const host = hostFromScriptURL(NativeModules?.SourceCode?.getConstants?.().scriptURL ?? NativeModules?.SourceCode?.scriptURL);
-    if (host) return host;
-  } catch {
-    // not React Native
-  }
-  return null;
-}
-
-/**
- * Default Buoy Desktop broker URL: the Metro host (falling back to
- * localhost) on port 42831. Android-emulator 10.0.2.2 rewriting is applied
- * later by getPlatformSpecificURL, so localhost still works there.
- */
-function getDefaultSocketURL() {
-  return socketURLForHost(getMetroHost());
-}
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.DEFAULT_BROKER_PORT=void 0;exports.getDefaultSocketURL=getDefaultSocketURL;exports.getMetroHost=getMetroHost;exports.hostFromScriptURL=hostFromScriptURL;exports.socketURLForHost=socketURLForHost;const DEFAULT_BROKER_PORT=exports.DEFAULT_BROKER_PORT=42831;const HOST_RE=/^https?:\/\/([^:/]+)/;function hostFromScriptURL(t){return t?.match(HOST_RE)?.[1]??null}function socketURLForHost(t){return`http://${t??"localhost"}:${DEFAULT_BROKER_PORT}`}function getMetroHost(){try{const{TurboModuleRegistry:t}=require("react-native");const e=t?.get?.("SourceCode");const o=hostFromScriptURL(e?.getConstants?.().scriptURL);if(o)return o}catch{}try{const{NativeModules:t}=require("react-native");const e=hostFromScriptURL(t?.SourceCode?.getConstants?.().scriptURL??t?.SourceCode?.scriptURL);if(e)return e}catch{}return null}function getDefaultSocketURL(){return socketURLForHost(getMetroHost())}

package/lib/commonjs/utils/getDefaultSocketURL.web.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.DEFAULT_BROKER_PORT=void 0;exports.getDefaultSocketURL=getDefaultSocketURL;exports.getMetroHost=getMetroHost;exports.hostFromScriptURL=hostFromScriptURL;exports.socketURLForHost=socketURLForHost;const DEFAULT_BROKER_PORT=exports.DEFAULT_BROKER_PORT=42831;function hostFromScriptURL(t){try{return t&&/^https?:/.test(t)?new URL(t).hostname:null}catch{return null}}function socketURLForHost(t){return`http://${t??"localhost"}:${DEFAULT_BROKER_PORT}`}function getMetroHost(){return null}function getDefaultSocketURL(){return socketURLForHost(typeof location==="undefined"?null:location.hostname)}

package/lib/commonjs/utils/logger.js

@@ -1,24 +1 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.log = log;
-/**
- * Helper function for controlled logging.
- * Only shows logs when enableLogs is true.
- * Always shows warnings and errors regardless of enableLogs setting.
- */
-function log(message, enableLogs, type = "log") {
-  if (!enableLogs && type === "log") return;
-  switch (type) {
-    case "warn":
-      console.warn(message);
-      break;
-    case "error":
-      console.error(message);
-      break;
-    default:
-      console.log(message);
-  }
-}
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.log=log;function log(o,e,r="log"){if(!e&&r==="log")return;switch(r){case"warn":console.warn(o);break;case"error":console.error(o);break;default:console.log(o)}}

package/lib/commonjs/utils/platformUtils.js

@@ -1,50 +1 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.getPlatformSpecificURL = void 0;
-/**
- * True only on an actual Android EMULATOR, detected via the build fingerprint
- * (same heuristic react-native-device-info uses), with no native dependency.
- * Physical devices must NOT get the 10.0.2.2 rewrite: over USB (`adb reverse`)
- * the Metro-derived host is "localhost", and rewriting it to the
- * emulator-only 10.0.2.2 alias breaks the connection — keeping localhost lets
- * `adb reverse tcp:42831 tcp:42831` forward it to the dev machine.
- *
- * The react-native require stays lexically inside try{} (Metro optional-dep
- * rule) and this module is never imported from types.ts, so non-Metro
- * bundles (the desktop app) are unaffected.
- */
-const isAndroidEmulator = () => {
-  try {
-    const {
-      Platform
-    } = require("react-native");
-    if (Platform.OS !== "android") return false;
-    const fingerprint = Platform.constants?.Fingerprint ?? "";
-    return /generic|emulator|goldfish|ranchu|sdk_gphone|vbox/i.test(fingerprint);
-  } catch {
-    return false;
-  }
-};
-
-/**
- * Get platform-specific URL for socket connection.
- * On the Android emulator (only), replaces localhost with 10.0.2.2 —
- * the emulator's alias for the host machine's loopback.
- */
-const getPlatformSpecificURL = (baseUrl, platform) => {
-  try {
-    const url = new URL(baseUrl);
-    if (platform === "android" && (url.hostname === "localhost" || url.hostname === "127.0.0.1") && isAndroidEmulator()) {
-      url.hostname = "10.0.2.2";
-      return url.toString();
-    }
-    return baseUrl;
-  } catch (e) {
-    console.warn("Error getting platform-specific URL:", e);
-    return baseUrl;
-  }
-};
-exports.getPlatformSpecificURL = getPlatformSpecificURL;
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.getPlatformSpecificURL=void 0;const isAndroidEmulator=()=>{try{const{Platform:t}=require("react-native");if(t.OS!=="android")return false;const e=t.constants?.Fingerprint??"";return/generic|emulator|goldfish|ranchu|sdk_gphone|vbox/i.test(e)}catch{return false}};const getPlatformSpecificURL=(t,e)=>{try{const r=new URL(t);if(e==="android"&&(r.hostname==="localhost"||r.hostname==="127.0.0.1")&&isAndroidEmulator()){r.hostname="10.0.2.2";return r.toString()}return t}catch(r){console.warn("Error getting platform-specific URL:",r);return t}};exports.getPlatformSpecificURL=getPlatformSpecificURL;

package/lib/commonjs/utils/platformUtils.web.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.getPlatformSpecificURL=getPlatformSpecificURL;function getPlatformSpecificURL(e,t){return e}