@buoy-gg/external-sync 7.0.41 → 7.0.43

package/lib/module/useExternalSync.js

@@ -1,69 +1 @@
-"use strict";
-
-import { useAccountAccess } from "@buoy-gg/license";
-import { useEffect, useRef } from "react";
-import { attachDeviceSync } from "./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',
- * });
- * ```
- */
-export function useExternalSync({
-  tools,
-  socket,
-  deviceId,
-  enabled = true,
-  throttleMs = 200,
-  enableLogs = false
-}) {
-  const account = useAccountAccess();
-  const admitted = account.status === "admitted";
-  const toolsRef = 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 = 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(",");
-  useEffect(() => {
-    if (!socket || !deviceId || !enabled || !admitted) {
-      watchedRef.current.clear();
-      return;
-    }
-    return 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";import{useAccountAccess as p}from"@buoy-gg/license";import{useEffect as y,useRef as a}from"react";import{attachDeviceSync as w}from"./attachDeviceSync";export function useExternalSync({tools:t,socket:r,deviceId:c,enabled:e=true,throttleMs:n=200,enableLogs:u=false}){const i=p();const o=i.status==="admitted";const s=a(t);s.current=t;const f=a(new Map);const m=Object.keys(t).sort().join(",");y(()=>{if(!r||!c||!e||!o){f.current.clear();return}return w({socket:r,deviceId:c,getTools:()=>s.current,watched:f.current,throttleMs:n,enableLogs:u})},[r,c,e,o,n,u,m])}

package/lib/module/useExternalSyncSocket.js

@@ -1,235 +1 @@
-"use strict";
-
-import { watchBrokerAccess } from "./brokerAccess";
-import { useEffect, useRef, useState } from "react";
-import { io as socketIO } from "socket.io-client";
-import { getPlatformSpecificURL } from "./utils/platformUtils";
-import { getDefaultSocketURL } from "./utils/getDefaultSocketURL";
-import { log } from "./utils/logger";
-import { setSyncStatus } from "./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.
- */
-export 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.
- */
-export 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
- */
-export function useExternalSyncSocket({
-  deviceName,
-  socketURL,
-  persistentDeviceId,
-  extraDeviceInfo,
-  envVariables,
-  platform,
-  enableLogs = false
-}) {
-  const socketRef = useRef(null);
-  const [socket, setSocket] = useState(null);
-  const [isConnected, setIsConnected] = useState(false);
-  // Derived once per render; stable string, so effect deps stay quiet.
-  const resolvedSocketURL = socketURL ?? 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 = useRef(false);
-  const logPrefix = `[${deviceName}]`;
-  const onConnect = () => {
-    log(`${logPrefix} Socket connected successfully`, enableLogs);
-    hasLoggedConnectError.current = false;
-    setIsConnected(true);
-    setSyncStatus({
-      state: "connected",
-      lastError: null
-    });
-  };
-  const onDisconnect = reason => {
-    log(`${logPrefix} Socket disconnected. Reason: ${reason}`, enableLogs);
-    setIsConnected(false);
-    setSyncStatus({
-      state: "retrying"
-    });
-  };
-  const onConnectError = error => {
-    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. `;
-    log(`[buoy] desktop sync: can't reach ${currentSocketURL} (is Buoy Desktop running?). ` + `Retrying in the background. ${hint}(${error.message})`, enableLogs, "warn");
-  };
-  const onConnectTimeout = () => {
-    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).
-  useEffect(() => {
-    if (!persistentDeviceId) return;
-    const platformUrl = getPlatformSpecificURL(resolvedSocketURL, platform);
-    setSyncStatus({
-      targetURL: platformUrl,
-      state: "connecting",
-      lastError: null
-    });
-    log(`${logPrefix} Platform: ${platform}, using URL: ${platformUrl}`, enableLogs);
-    try {
-      if (globalSocketInstance && (currentSocketURL !== platformUrl || currentDeviceId !== persistentDeviceId || currentPlatform !== platform)) {
-        globalSocketInstance.disconnect();
-        globalSocketInstance = null;
-      }
-      if (!globalSocketInstance) {
-        log(`${logPrefix} Creating new socket instance to ${platformUrl}`, enableLogs);
-        globalSocketInstance = socketIO(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 {
-        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) {
-        log(`${logPrefix} Socket already connected on init`, enableLogs);
-      }
-      activeSocket.on("connect", onConnect);
-      activeSocket.on("disconnect", onDisconnect);
-      return () => {
-        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) {
-      log(`${logPrefix} Failed to initialize socket: ${error}`, enableLogs, "error");
-    }
-  }, [persistentDeviceId, resolvedSocketURL, platform]);
-
-  // Update socket query parameters when deviceName changes
-  useEffect(() => {
-    if (socketRef.current && socketRef.current.io.opts.query && persistentDeviceId) {
-      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) {
-      log(`${logPrefix} Manually connecting to socket server`, enableLogs);
-      socketRef.current.connect();
-    }
-  }
-  function disconnect() {
-    if (socketRef.current && socketRef.current.connected) {
-      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] = useState(null);
-  useEffect(() => {
-    if (!socket) return;
-    return watchBrokerAccess(socket, ready => {
-      setAdmittedSocket(ready ? socket : null);
-      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";import{watchBrokerAccess as w}from"./brokerAccess";import{useEffect as $,useRef as O,useState as g}from"react";import{io as M}from"socket.io-client";import{getPlatformSpecificURL as N}from"./utils/platformUtils";import{getDefaultSocketURL as V}from"./utils/getDefaultSocketURL";import{log as r}from"./utils/logger";import{setSyncStatus as f}from"./syncStatusStore";import{pinSocketTimers as q,realClearTimeout as j,realSetTimeout as J}from"./realNow";const b=typeof __DEV__!=="undefined"?__DEV__:false;let l=null;let m="";let v="";let x="";let _=0;let d=null;const z=2e3;const B=()=>`${Date.now().toString(36)}-${Math.random().toString(36).slice(2,10)}`;export function getInstanceId(){const o=globalThis;if(!o.__buoyInstanceId)o.__buoyInstanceId=B();return o.__buoyInstanceId}export function buildHandshakeQuery(o){const k=i=>i&&Object.fromEntries(Object.entries(i).filter(([S])=>!["BUOY_LICENSE_KEY","BUOY_KEY","EXPO_PUBLIC_BUOY_KEY","VITE_BUOY_KEY","REACT_APP_BUOY_KEY","licenseKey"].includes(S)));return{deviceName:o.deviceName,deviceId:o.persistentDeviceId,platform:o.platform,extraDeviceInfo:JSON.stringify(k(o.extraDeviceInfo)),envVariables:JSON.stringify(k(o.envVariables)),connectionNonce:B(),instanceId:getInstanceId()}}export function useExternalSyncSocket({deviceName:o,socketURL:k,persistentDeviceId:i,extraDeviceInfo:S,envVariables:Y,platform:u,enableLogs:n=false}){const s=O(null);const[a,A]=g(null);const[P,y]=g(false);const p=k??V();const E=O(false);const c=`[${o}]`;const U=()=>{r(`${c} Socket connected successfully`,n);E.current=false;y(true);f({state:"connected",lastError:null})};const I=e=>{r(`${c} Socket disconnected. Reason: ${e}`,n);y(false);f({state:"retrying"})};const C=e=>{f({state:"retrying",lastError:e.message});if(!b)return;if(E.current)return;E.current=true;const t=u==="android"&&/localhost|127\.0\.0\.1/.test(m)?`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. `;r(`[buoy] desktop sync: can't reach ${m} (is Buoy Desktop running?). Retrying in the background. ${t}(${e.message})`,n,"warn")};const h=()=>{r(`${c} Socket connection timeout`,n,"error")};$(()=>{if(!i)return;const e=N(p,u);f({targetURL:e,state:"connecting",lastError:null});r(`${c} Platform: ${u}, using URL: ${e}`,n);try{if(l&&(m!==e||v!==i||x!==u)){l.disconnect();l=null}if(!l){r(`${c} Creating new socket instance to ${e}`,n);l=M(e,{autoConnect:true,query:buildHandshakeQuery({deviceName:o,persistentDeviceId:i,platform:u,extraDeviceInfo:S,envVariables:Y}),reconnection:true,reconnectionAttempts:Infinity,reconnectionDelay:1e3,reconnectionDelayMax:5e3,transports:["websocket"]});q(l);m=e;v=i;x=u}else{r(`${c} Reusing existing socket instance to ${e}`,n)}s.current=l;const t=s.current;_++;if(d){j(d);d=null}A(t);t.on("connect_error",C);t.on("connect_timeout",h);y(t.connected);if(t.connected){r(`${c} Socket already connected on init`,n)}t.on("connect",U);t.on("disconnect",I);return()=>{r(`${c} Cleaning up socket event listeners`,n);t.off("connect",U);t.off("disconnect",I);t.off("connect_error",C);t.off("connect_timeout",h);_--;if(_===0){d=J(()=>{d=null;if(_>0||l!==t)return;r(`${c} No longer used; disconnecting`,n);t.disconnect();l=null;f({state:"idle",lastError:null})},z)}}}catch(t){r(`${c} Failed to initialize socket: ${t}`,n,"error")}},[i,p,u]);$(()=>{if(s.current&&s.current.io.opts.query&&i){r(`${c} Updating device name in socket connection`,n);s.current.io.opts.query={...s.current.io.opts.query,deviceName:o,deviceId:i,platform:u}}},[o,c,i,u,n]);function T(){if(s.current&&!s.current.connected){r(`${c} Manually connecting to socket server`,n);s.current.connect()}}function D(){if(s.current&&s.current.connected){r(`${c} Manually disconnecting from socket server`,n);s.current.disconnect()}}const[R,K]=g(null);$(()=>{if(!a)return;return w(a,e=>{K(e?a:null);f(e?{state:"connected",lastError:null}:{state:"retrying",lastError:"Update Buoy Desktop and sign in to enable desktop sync."})})},[a]);return{socket:R===a?a:null,connect:T,disconnect:D,isConnected:P&&R===a&&a!==null}}

package/lib/module/utils/getDefaultSocketURL.js

@@ -1,76 +1 @@
-"use strict";
-
-/**
- * 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. */
-export const 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.
- */
-export function hostFromScriptURL(scriptURL) {
-  return scriptURL?.match(HOST_RE)?.[1] ?? null;
-}
-
-/** Broker URL for a host, falling back to localhost when none is known. */
-export 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.
- */
-export function getMetroHost() {
-  try {
-    // The public route to the SourceCode TurboModule that
-    // react-native/Libraries/NativeModules/specs/NativeSourceCode wraps. Deep
-    // imports warn on RN 0.80+; react-native-web has no registry and falls
-    // through to null.
-    // eslint-disable-next-line @typescript-eslint/no-var-requires
-    const {
-      TurboModuleRegistry
-    } = require("react-native");
-    const NativeSourceCode = TurboModuleRegistry?.get?.("SourceCode");
-    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.
- */
-export function getDefaultSocketURL() {
-  return socketURLForHost(getMetroHost());
-}
+"use strict";export const DEFAULT_BROKER_PORT=42831;const r=/^https?:\/\/([^:/]+)/;export function hostFromScriptURL(t){return t?.match(r)?.[1]??null}export function socketURLForHost(t){return`http://${t??"localhost"}:${DEFAULT_BROKER_PORT}`}export 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}export function getDefaultSocketURL(){return socketURLForHost(getMetroHost())}

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

@@ -1,19 +1 @@
-"use strict";
-
-export const DEFAULT_BROKER_PORT = 42831;
-export function hostFromScriptURL(url) {
-  try {
-    return url && /^https?:/.test(url) ? new URL(url).hostname : null;
-  } catch {
-    return null;
-  }
-}
-export function socketURLForHost(host) {
-  return `http://${host ?? "localhost"}:${DEFAULT_BROKER_PORT}`;
-}
-export function getMetroHost() {
-  return null;
-}
-export function getDefaultSocketURL() {
-  return socketURLForHost(typeof location === "undefined" ? null : location.hostname);
-}
+"use strict";export const DEFAULT_BROKER_PORT=42831;export function hostFromScriptURL(t){try{return t&&/^https?:/.test(t)?new URL(t).hostname:null}catch{return null}}export function socketURLForHost(t){return`http://${t??"localhost"}:${DEFAULT_BROKER_PORT}`}export function getMetroHost(){return null}export function getDefaultSocketURL(){return socketURLForHost(typeof location==="undefined"?null:location.hostname)}

package/lib/module/utils/logger.js

@@ -1,20 +1 @@
-"use strict";
-
-/**
- * Helper function for controlled logging.
- * Only shows logs when enableLogs is true.
- * Always shows warnings and errors regardless of enableLogs setting.
- */
-export 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";export function log(o,c,r="log"){if(!c&&r==="log")return;switch(r){case"warn":console.warn(o);break;case"error":console.error(o);break;default:console.log(o)}}

package/lib/module/utils/platformUtils.js

@@ -1,45 +1 @@
-"use strict";
-
-/**
- * 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.
- */
-export 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;
-  }
-};
+"use strict";const e=()=>{try{const{Platform:t}=require("react-native");if(t.OS!=="android")return false;const n=t.constants?.Fingerprint??"";return/generic|emulator|goldfish|ranchu|sdk_gphone|vbox/i.test(n)}catch{return false}};export const getPlatformSpecificURL=(t,n)=>{try{const r=new URL(t);if(n==="android"&&(r.hostname==="localhost"||r.hostname==="127.0.0.1")&&e()){r.hostname="10.0.2.2";return r.toString()}return t}catch(r){console.warn("Error getting platform-specific URL:",r);return t}};

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

@@ -1,5 +1 @@
-"use strict";
-
-export function getPlatformSpecificURL(baseUrl, _platform) {
-  return baseUrl;
-}
+"use strict";export function getPlatformSpecificURL(t,r){return t}

package/lib/typescript/realNow.d.ts

@@ -0,0 +1,27 @@
+/**
+ * The device's real clock.
+ *
+ * @buoy-gg/clock can override the APP's clock (Date.now, new Date). Buoy's
+ * own bookkeeping must keep real time regardless: license expiry, sync
+ * throttles and request deadlines would otherwise lock tools or stall when
+ * someone travels a month ahead. The clock package publishes the real clock
+ * on `globalThis.__buoyRealNow`; without it, Date.now is already real.
+ */
+export declare function realNow(): number;
+/**
+ * setTimeout that a clock jump never fires early. @buoy-gg/clock tracks the
+ * app's timers so a jump ahead can run the ones that come due; Buoy's own
+ * deadlines and heartbeats must not be among them.
+ */
+export declare function realSetTimeout(callback: () => void, ms: number): ReturnType<typeof setTimeout>;
+export declare function realClearTimeout(handle: unknown): void;
+/** Run `fn` on the real clock (a no-op scope when @buoy-gg/clock is absent). */
+export declare function withRealClock<T>(fn: () => T): T;
+/**
+ * Keep a socket.io socket on real time: its Manager and engine get real
+ * timers (engine.io's heartbeat is a ping-timeout setTimeout a jump would
+ * fire) and the engine's clock-reading methods run in a real-clock scope. The
+ * engine is rebuilt on every reconnect, so `open` re-pins it.
+ */
+export declare function pinSocketTimers(socket: unknown): void;
+//# sourceMappingURL=realNow.d.ts.map

package/lib/typescript/syncStatusStore.d.ts

@@ -1,10 +1,3 @@
-/**
- * Module-level desktop-sync status, written by useExternalSyncSocket and
- * read by the floating menu's settings modal (via useSyncExternalStore).
- * Lives here rather than in core because only the socket hook knows the
- * platform-rewritten URL and every connection transition — including for
- * apps that call the hook directly instead of using zero-config sync.
- */
 export interface SyncStatus {
     /** Final (platform-rewritten) broker URL being dialed; null before init. */
     targetURL: string | null;

package/lib/web/index.mjs

@@ -1,2 +1 @@
-"use client";
-var S=process.env.NODE_ENV!=="production";typeof window<"u"&&typeof globalThis.global>"u"&&(globalThis.global=globalThis);import{useAccountAccess as me}from"@buoy-gg/license/web";import{useEffect as ve,useRef as ae}from"react";import{LicenseManager as I}from"@buoy-gg/license/web";function l(t,c,n="log"){if(!(!c&&n==="log"))switch(n){case"warn":console.warn(t);break;case"error":console.error(t);break;default:console.log(t)}}var q="__buoyFlushToolSync";function K(){let t=globalThis;return t[q]||(t[q]=new Set),t[q]}function V(t){K().add(t)}function W(t){K().delete(t)}function he(t){try{for(let c of K())try{c(t)}catch{}}catch{}}function j(t,c){let n=0,i=[t],h=new Set;for(;i.length>0;){if(n>c)return{over:!0,approxBytes:n};let o=i.pop();if(o==null)n+=4;else if(typeof o=="string")n+=o.length+2;else if(typeof o=="number")n+=8;else if(typeof o=="boolean")n+=5;else if(typeof o=="object"){if(h.has(o))continue;if(h.add(o),Array.isArray(o)){n+=2+o.length;for(let s=0;s<o.length;s++)i.push(o[s])}else{n+=2;for(let s in o)n+=s.length+4,i.push(o[s])}}else n+=4}return{over:n>c,approxBytes:n}}var re=1;var P="[ExternalSync]";function ie({socket:t,deviceId:c,getTools:n,watched:i,throttleMs:h=200,enableLogs:o=!1}){let s=!1,a=!1,p=0,g=()=>!s&&a&&t.connected&&I.hasAccountAccess(),m=new Map,k={},v={},w=e=>e==="All"||e===c,u=(e,r)=>{if(g())try{t.emit(e,r)}catch(y){l(`${P} Failed to emit "${e}": ${y}. Payload must be JSON-serializable.`,o,"error")}},M=new Set,x=e=>{if(!g())return;let r=n()[e];if(!r)return;k[e]=Date.now();let y;try{y=r.getSnapshot()}catch{return}let{over:T,approxBytes:$}=j(y,2097152);if(T){M.has(e)||(M.add(e),console.warn(`${P} "${e}" snapshot \u2248${($/1e6).toFixed(1)}MB exceeds the ${2097152/1e6}MB sync budget \u2014 dropped (dashboard will be stale for this tool). The adapter should ship a wire-form snapshot (summaries + on-demand detail).`));return}let Y={toolId:e,persistentDeviceId:c,timestamp:k[e],version:r.version,kind:"snapshot",payload:y};u("devtool-sync",Y)},A=e=>{if(v[e])return;let r=Date.now()-(k[e]??0);if(r>=h){x(e);return}v[e]=setTimeout(()=>{delete v[e],x(e)},h-r)},O=e=>{t.connected&&m.has(e)&&(v[e]&&(clearTimeout(v[e]),delete v[e]),x(e))};V(O);let D=new Map,C=(e,r)=>{if(!g())return;let y=n()[e];if(y){if(m.has(e)){if(D.get(e)===r)return;let T=m.get(e);m.set(e,y.subscribe(r==="stream"?()=>A(e):()=>{})),D.set(e,r),T?.(),l(`${P} "${e}" watch mode \u2192 ${r}`,o);return}m.set(e,y.subscribe(r==="stream"?()=>A(e):()=>{})),D.set(e,r),l(`${P} Watching "${e}" (${r})`,o)}},E=e=>{m.get(e)?.(),m.delete(e),D.delete(e),v[e]&&(clearTimeout(v[e]),delete v[e]),l(`${P} Stopped watching "${e}"`,o)},N=()=>{let e={persistentDeviceId:c,protocolVersion:1,tools:Object.entries(n()).map(([r,y])=>({toolId:r,version:y.version,actions:Object.keys(y.actions??{})}))};u("devtool-capabilities",e)},f=e=>{if(!(!g()||!w(e.targetDeviceId)))if(e.watching){let r=e.consolidated===!0&&e.stream===!1?"capture":"stream";i.set(e.toolId,r),C(e.toolId,r),r==="stream"&&x(e.toolId)}else i.delete(e.toolId),E(e.toolId)},d=e=>{!g()||!w(e.targetDeviceId)||x(e.toolId)},Q=async e=>{if(!g()||!w(e.targetDeviceId))return;let r=p,{requestId:y,toolId:T,action:$,params:Y}=e,b={requestId:y,toolId:T,action:$,persistentDeviceId:c,timestamp:Date.now(),ok:!1},ne=n()[T],oe=ne?.actions?.[$];if(!oe){b.error=ne?`Unknown action "${$}" on tool "${T}"`:`Unknown tool "${T}"`,u("devtool-action-result",b);return}try{b.result=await oe(Y),b.ok=!0}catch(U){b.error=U instanceof Error?U.message:String(U)}if(!(r!==p||!g())){if(b.ok){let{over:U,approxBytes:Se}=j(b.result,8388608);U&&(b.ok=!1,b.result=void 0,b.error=`Result \u2248${(Se/1e6).toFixed(1)}MB exceeds the ${8388608/1e6}MB sync budget. Narrow the request (e.g. includeValues:false, a limit, or a more specific action).`)}b.timestamp=Date.now(),u("devtool-action-result",b)}},B=()=>{p+=1;for(let r of[...m.keys()])E(r);i.clear();for(let r of Object.values(v))clearTimeout(r);let e=t;e.sendBuffer&&(e.sendBuffer=e.sendBuffer.filter(r=>!["devtool-sync","devtool-capabilities","devtool-action-result","device-license"].includes(String(r.data?.[0]))))},Z=()=>{let e=I.getState();t.emit("device-license",{tier:e.tier,isPro:e.isPro?"1":"0"}),N()},ee=e=>{a=e?.protocol===1&&e.ready===!0,g()?Z():B()},ye=I.subscribe(()=>{I.hasAccountAccess()?g()&&Z():(t.connected&&t.emit("device-license",{tier:"locked",isPro:"0"}),B())}),L=()=>{a=!1,t.emit("buoy:access:request")},te=()=>{a=!1,B()};t.on("buoy:access",ee);for(let[e,r]of i)n()[e]&&C(e,r);return t.on("connect",L),t.on("disconnect",te),t.on("devtool-watch",f),t.on("request-devtool-state",d),t.on("devtool-action",Q),t.connected&&L(),()=>{s=!0,ye(),t.off("buoy:access",ee),B(),W(O),t.off("connect",L),t.off("disconnect",te),t.off("devtool-watch",f),t.off("request-devtool-state",d),t.off("devtool-action",Q);for(let e of[...m.keys()])E(e)}}function be({tools:t,socket:c,deviceId:n,enabled:i=!0,throttleMs:h=200,enableLogs:o=!1}){let a=me().status==="admitted",p=ae(t);p.current=t;let g=ae(new Map),m=Object.keys(t).sort().join(",");ve(()=>{if(!c||!n||!i||!a){g.current.clear();return}return ie({socket:c,deviceId:n,getTools:()=>p.current,watched:g.current,throttleMs:h,enableLogs:o})},[c,n,i,a,h,o,m])}function le(t,c){let n=()=>c(!1),i=()=>{n(),t.emit("buoy:access:request")},h=o=>{let s=o;c(s?.protocol===1&&s?.ready===!0)};return t.on("connect",i),t.on("disconnect",n),t.on("buoy:access",h),n(),t.connected&&i(),()=>{t.off("connect",i),t.off("disconnect",n),t.off("buoy:access",h)}}import{useEffect as G,useRef as fe,useState as J}from"react";import{io as De}from"socket.io-client";function ue(t,c){return t}var xe=42831;function Te(t){return`http://${t??"localhost"}:42831`}function ke(){return null}function H(){return Te(typeof location>"u"?null:location.hostname)}var z={targetURL:null,state:"idle",lastError:null,since:0},X=new Set;function R(t){z={...z,...t,since:Date.now()},X.forEach(c=>c())}function we(){return z}function Re(t){return X.add(t),()=>{X.delete(t)}}var Ee=typeof S<"u"?S:!1,_=null,F="",de="",pe="",ge=()=>`${Date.now().toString(36)}-${Math.random().toString(36).slice(2,10)}`;function _e(){let t=globalThis;return t.__buoyInstanceId||(t.__buoyInstanceId=ge()),t.__buoyInstanceId}function Me(t){let c=n=>n&&Object.fromEntries(Object.entries(n).filter(([i])=>!["BUOY_LICENSE_KEY","BUOY_KEY","EXPO_PUBLIC_BUOY_KEY","VITE_BUOY_KEY","REACT_APP_BUOY_KEY","licenseKey"].includes(i)));return{deviceName:t.deviceName,deviceId:t.persistentDeviceId,platform:t.platform,extraDeviceInfo:JSON.stringify(c(t.extraDeviceInfo)),envVariables:JSON.stringify(c(t.envVariables)),connectionNonce:ge(),instanceId:_e()}}function Ae({deviceName:t,socketURL:c,persistentDeviceId:n,extraDeviceInfo:i,envVariables:h,platform:o,enableLogs:s=!1}){let a=fe(null),[p,g]=J(null),[m,k]=J(!1),v=c??H(),w=fe(!1),u=`[${t}]`,M=()=>{l(`${u} Socket connected successfully`,s),w.current=!1,k(!0),R({state:"connected",lastError:null})},x=f=>{l(`${u} Socket disconnected. Reason: ${f}`,s),k(!1),R({state:"retrying"})},A=f=>{if(R({state:"retrying",lastError:f.message}),!Ee||w.current)return;w.current=!0;let d=o==="android"&&/localhost|127\.0\.0\.1/.test(F)?"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. ";l(`[buoy] desktop sync: can't reach ${F} (is Buoy Desktop running?). Retrying in the background. ${d}(${f.message})`,s,"warn")},O=()=>{l(`${u} Socket connection timeout`,s,"error")};G(()=>{if(!n)return;let f=ue(v,o);R({targetURL:f,state:"connecting",lastError:null}),l(`${u} Platform: ${o}, using URL: ${f}`,s);try{_&&(F!==f||de!==n||pe!==o)&&(_.disconnect(),_=null),_?l(`${u} Reusing existing socket instance to ${f}`,s):(l(`${u} Creating new socket instance to ${f}`,s),_=De(f,{autoConnect:!0,query:Me({deviceName:t,persistentDeviceId:n,platform:o,extraDeviceInfo:i,envVariables:h}),reconnection:!0,reconnectionAttempts:1/0,reconnectionDelay:1e3,reconnectionDelayMax:5e3,transports:["websocket"]}),F=f,de=n,pe=o),a.current=_;let d=a.current;return g(d),d.on("connect_error",A),d.on("connect_timeout",O),k(d.connected),d.connected&&l(`${u} Socket already connected on init`,s),d.on("connect",M),d.on("disconnect",x),()=>{l(`${u} Cleaning up socket event listeners`,s),d.off("connect",M),d.off("disconnect",x),d.off("connect_error",A),d.off("connect_timeout",O)}}catch(d){l(`${u} Failed to initialize socket: ${d}`,s,"error")}},[n,v,o]),G(()=>{a.current&&a.current.io.opts.query&&n&&(l(`${u} Updating device name in socket connection`,s),a.current.io.opts.query={...a.current.io.opts.query,deviceName:t,deviceId:n,platform:o})},[t,u,n,o,s]);function D(){a.current&&!a.current.connected&&(l(`${u} Manually connecting to socket server`,s),a.current.connect())}function C(){a.current&&a.current.connected&&(l(`${u} Manually disconnecting from socket server`,s),a.current.disconnect())}let[E,N]=J(null);return G(()=>{if(p)return le(p,f=>{N(f?p:null),R(f?{state:"connected",lastError:null}:{state:"retrying",lastError:"Update Buoy Desktop and sign in to enable desktop sync."})})},[p]),{socket:E===p?p:null,connect:D,disconnect:C,isConnected:m&&E===p&&p!==null}}export{xe as DEFAULT_BROKER_PORT,re as SYNC_PROTOCOL_VERSION,he as flushToolSyncNow,H as getDefaultSocketURL,ke as getMetroHost,we as getSyncStatus,V as registerToolFlusher,R as setSyncStatus,Re as subscribeSyncStatus,W as unregisterToolFlusher,be as useExternalSync,Ae as useExternalSyncSocket};
+"use client";var ne=process.env.NODE_ENV!=="production";typeof window<"u"&&typeof globalThis.global>"u"&&(globalThis.global=globalThis);import{useAccountAccess as he}from"@buoy-gg/license/web";import{useEffect as ve,useRef as oe}from"react";import{LicenseManager as P}from"@buoy-gg/license/web";function p(e,o,n="log"){if(!(!o&&n==="log"))switch(n){case"warn":console.warn(e);break;case"error":console.error(e);break;default:console.log(e)}}var j="__buoyFlushToolSync";function K(){let e=globalThis;return e[j]||(e[j]=new Set),e[j]}function re(e){K().add(e)}function ce(e){K().delete(e)}function be(e){try{for(let o of K())try{o(e)}catch{}}catch{}}function se(e,o){let n=0,i=[e],l=new Set;for(;i.length>0;){if(n>o)return{over:true,approxBytes:n};let r=i.pop();if(r==null)n+=4;else if(typeof r=="string")n+=r.length+2;else if(typeof r=="number")n+=8;else if(typeof r=="boolean")n+=5;else if(typeof r=="object"){if(l.has(r))continue;if(l.add(r),Array.isArray(r)){n+=2+r.length;for(let c=0;c<r.length;c++)i.push(r[c])}else{n+=2;for(let c in r)n+=c.length+4,i.push(r[c])}}else n+=4}return{over:n>o,approxBytes:n}}var $e=1;function U(){let e=globalThis.__buoyRealNow;return typeof e=="function"?e():Date.now()}function ie(){return globalThis.__buoyRealTimers??globalThis}function ae(e,o){return ie().setTimeout(e,o)}function le(e){ie().clearTimeout(e)}function _e(e){let o=globalThis.__buoyWithRealClock;return typeof o=="function"?o(e):e()}var Ie=["_resetPingTimeout","_hasPingExpired"];function ke(e){let o=e?.io;if(!o||o.__buoyRealTimers)return;let n=l=>{if(l){l.setTimeoutFn=ae,l.clearTimeoutFn=le;for(let r of Ie){let c=l[r];if(typeof c!="function"||c.__buoyReal)continue;let a=function(...y){return _e(()=>c.apply(this,y))};a.__buoyReal=true,l[r]=a}}};n(o),n(o.engine);let i=o.open;typeof i=="function"&&(o.open=function(...l){let r=i.apply(this,l);return n(this?.engine),r}),o.__buoyRealTimers=true}var N="[ExternalSync]";function Se({socket:e,deviceId:o,getTools:n,watched:i,throttleMs:l=200,enableLogs:r=false}){let c=false,a=false,y=0,m=()=>!c&&a&&e.connected&&P.hasAccountAccess(),b=new Map,k={},h={},S=t=>t==="All"||t===o,f=(t,s)=>{if(m())try{e.emit(t,s)}catch(g){p(`${N} Failed to emit "${t}": ${g}. Payload must be JSON-serializable.`,r,"error")}},R=new Set,_=t=>{if(!m())return;let s=n()[t];if(!s)return;k[t]=U();let g;try{g=s.getSnapshot()}catch{return}let{over:I,approxBytes:B}=se(g,2097152);if(I){R.has(t)||(R.add(t),console.warn(`${N} "${t}" snapshot \u2248${(B/1e6).toFixed(1)}MB exceeds the ${2097152/1e6}MB sync budget \u2014 dropped (dashboard will be stale for this tool). The adapter should ship a wire-form snapshot (summaries + on-demand detail).`));return}let V={toolId:t,persistentDeviceId:o,timestamp:k[t],version:s.version,kind:"snapshot",payload:g};f("devtool-sync",V)},D=t=>{if(h[t])return;let s=U()-(k[t]??0);if(s>=l){_(t);return}h[t]=setTimeout(()=>{delete h[t],_(t)},l-s)},O=t=>{e.connected&&b.has(t)&&(h[t]&&(clearTimeout(h[t]),delete h[t]),_(t))};re(O);let w=new Map,L=(t,s)=>{if(!m())return;let g=n()[t];if(g){if(b.has(t)){if(w.get(t)===s)return;let I=b.get(t);b.set(t,g.subscribe(s==="stream"?()=>D(t):()=>{})),w.set(t,s),I?.(),p(`${N} "${t}" watch mode \u2192 ${s}`,r);return}b.set(t,g.subscribe(s==="stream"?()=>D(t):()=>{})),w.set(t,s),p(`${N} Watching "${t}" (${s})`,r)}},E=t=>{b.get(t)?.(),b.delete(t),w.delete(t),h[t]&&(clearTimeout(h[t]),delete h[t]),p(`${N} Stopped watching "${t}"`,r)},F=()=>{let t={persistentDeviceId:o,protocolVersion:1,tools:Object.entries(n()).map(([s,g])=>({toolId:s,version:g.version,actions:Object.keys(g.actions??{})}))};f("devtool-capabilities",t)},d=t=>{if(!(!m()||!S(t.targetDeviceId)))if(t.watching){let s=t.consolidated===true&&t.stream===false?"capture":"stream";i.set(t.toolId,s),L(t.toolId,s),s==="stream"&&_(t.toolId)}else i.delete(t.toolId),E(t.toolId)},u=t=>{!m()||!S(t.targetDeviceId)||_(t.toolId)},X=async t=>{if(!m()||!S(t.targetDeviceId))return;let s=y,{requestId:g,toolId:I,action:B,params:V}=t,v={requestId:g,toolId:I,action:B,persistentDeviceId:o,timestamp:U(),ok:false},ee=n()[I],te=ee?.actions?.[B];if(!te){v.error=ee?`Unknown action "${B}" on tool "${I}"`:`Unknown tool "${I}"`,f("devtool-action-result",v);return}try{v.result=await te(V),v.ok=true}catch(x){v.error=x instanceof Error?x.message:String(x)}if(!(s!==y||!m())){if(v.ok){let{over:x,approxBytes:me}=se(v.result,8388608);x&&(v.ok=false,v.result=void 0,v.error=`Result \u2248${(me/1e6).toFixed(1)}MB exceeds the ${8388608/1e6}MB sync budget. Narrow the request (e.g. includeValues:false, a limit, or a more specific action).`)}v.timestamp=U(),f("devtool-action-result",v)}},A=()=>{y+=1;for(let s of[...b.keys()])E(s);i.clear();for(let s of Object.values(h))clearTimeout(s);let t=e;t.sendBuffer&&(t.sendBuffer=t.sendBuffer.filter(s=>!["devtool-sync","devtool-capabilities","devtool-action-result","device-license"].includes(String(s.data?.[0]))))},G=()=>{let t=P.getState();e.emit("device-license",{tier:t.tier,isPro:t.isPro?"1":"0"}),F()},Q=t=>{a=t?.protocol===1&&t.ready===true,m()?G():A()},ge=P.subscribe(()=>{P.hasAccountAccess()?m()&&G():(e.connected&&e.emit("device-license",{tier:"locked",isPro:"0"}),A())}),Y=()=>{a=false,e.emit("buoy:access:request")},Z=()=>{a=false,A()};e.on("buoy:access",Q);for(let[t,s]of i)n()[t]&&L(t,s);return e.on("connect",Y),e.on("disconnect",Z),e.on("devtool-watch",d),e.on("request-devtool-state",u),e.on("devtool-action",X),e.connected&&Y(),()=>{c=true,ge(),e.off("buoy:access",Q),A(),ce(O),e.off("connect",Y),e.off("disconnect",Z),e.off("devtool-watch",d),e.off("request-devtool-state",u),e.off("devtool-action",X);for(let t of[...b.keys()])E(t)}}function Te({tools:e,socket:o,deviceId:n,enabled:i=true,throttleMs:l=200,enableLogs:r=false}){let c=he().status==="admitted",a=oe(e);a.current=e;let y=oe(new Map),m=Object.keys(e).sort().join(",");ve(()=>{if(!o||!n||!i||!c){y.current.clear();return}return Se({socket:o,deviceId:n,getTools:()=>a.current,watched:y.current,throttleMs:l,enableLogs:r})},[o,n,i,c,l,r,m])}function we(e,o){let n=()=>o(false),i=()=>{n(),e.emit("buoy:access:request")},l=r=>{let c=r;o(c?.protocol===1&&c?.ready===true)};return e.on("connect",i),e.on("disconnect",n),e.on("buoy:access",l),n(),e.connected&&i(),()=>{e.off("connect",i),e.off("disconnect",n),e.off("buoy:access",l)}}import{useEffect as J,useRef as ue,useState as W}from"react";import{io as Ee}from"socket.io-client";function Re(e,o){return e}var De=42831;function Oe(e){return`http://${e??"localhost"}:42831`}function Be(){return null}function fe(){return Oe(typeof location>"u"?null:location.hostname)}var z={targetURL:null,state:"idle",lastError:null,since:0},H=new Set;function T(e){z={...z,...e,since:U()},H.forEach(o=>o())}function xe(){return z}function Ue(e){return H.add(e),()=>{H.delete(e)}}var Ne=typeof ne<"u"?ne:false,$=null,q="",de="",pe="",C=0,M=null,Me=2e3,ye=()=>`${Date.now().toString(36)}-${Math.random().toString(36).slice(2,10)}`;function Le(){let e=globalThis;return e.__buoyInstanceId||(e.__buoyInstanceId=ye()),e.__buoyInstanceId}function Ae(e){let o=n=>n&&Object.fromEntries(Object.entries(n).filter(([i])=>!["BUOY_LICENSE_KEY","BUOY_KEY","EXPO_PUBLIC_BUOY_KEY","VITE_BUOY_KEY","REACT_APP_BUOY_KEY","licenseKey"].includes(i)));return{deviceName:e.deviceName,deviceId:e.persistentDeviceId,platform:e.platform,extraDeviceInfo:JSON.stringify(o(e.extraDeviceInfo)),envVariables:JSON.stringify(o(e.envVariables)),connectionNonce:ye(),instanceId:Le()}}function Pe({deviceName:e,socketURL:o,persistentDeviceId:n,extraDeviceInfo:i,envVariables:l,platform:r,enableLogs:c=false}){let a=ue(null),[y,m]=W(null),[b,k]=W(false),h=o??fe(),S=ue(false),f=`[${e}]`,R=()=>{p(`${f} Socket connected successfully`,c),S.current=false,k(true),T({state:"connected",lastError:null})},_=d=>{p(`${f} Socket disconnected. Reason: ${d}`,c),k(false),T({state:"retrying"})},D=d=>{if(T({state:"retrying",lastError:d.message}),!Ne||S.current)return;S.current=true;let u=r==="android"&&/localhost|127\.0\.0\.1/.test(q)?"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. ";p(`[buoy] desktop sync: can't reach ${q} (is Buoy Desktop running?). Retrying in the background. ${u}(${d.message})`,c,"warn")},O=()=>{p(`${f} Socket connection timeout`,c,"error")};J(()=>{if(!n)return;let d=Re(h,r);T({targetURL:d,state:"connecting",lastError:null}),p(`${f} Platform: ${r}, using URL: ${d}`,c);try{$&&(q!==d||de!==n||pe!==r)&&($.disconnect(),$=null),$?p(`${f} Reusing existing socket instance to ${d}`,c):(p(`${f} Creating new socket instance to ${d}`,c),$=Ee(d,{autoConnect:true,query:Ae({deviceName:e,persistentDeviceId:n,platform:r,extraDeviceInfo:i,envVariables:l}),reconnection:true,reconnectionAttempts:1/0,reconnectionDelay:1e3,reconnectionDelayMax:5e3,transports:["websocket"]}),ke($),q=d,de=n,pe=r),a.current=$;let u=a.current;return C++,M&&(le(M),M=null),m(u),u.on("connect_error",D),u.on("connect_timeout",O),k(u.connected),u.connected&&p(`${f} Socket already connected on init`,c),u.on("connect",R),u.on("disconnect",_),()=>{p(`${f} Cleaning up socket event listeners`,c),u.off("connect",R),u.off("disconnect",_),u.off("connect_error",D),u.off("connect_timeout",O),C--,C===0&&(M=ae(()=>{M=null,!(C>0||$!==u)&&(p(`${f} No longer used; disconnecting`,c),u.disconnect(),$=null,T({state:"idle",lastError:null}))},Me))}}catch(u){p(`${f} Failed to initialize socket: ${u}`,c,"error")}},[n,h,r]),J(()=>{a.current&&a.current.io.opts.query&&n&&(p(`${f} Updating device name in socket connection`,c),a.current.io.opts.query={...a.current.io.opts.query,deviceName:e,deviceId:n,platform:r})},[e,f,n,r,c]);function w(){a.current&&!a.current.connected&&(p(`${f} Manually connecting to socket server`,c),a.current.connect())}function L(){a.current&&a.current.connected&&(p(`${f} Manually disconnecting from socket server`,c),a.current.disconnect())}let[E,F]=W(null);return J(()=>{if(y)return we(y,d=>{F(d?y:null),T(d?{state:"connected",lastError:null}:{state:"retrying",lastError:"Update Buoy Desktop and sign in to enable desktop sync."})})},[y]),{socket:E===y?y:null,connect:w,disconnect:L,isConnected:b&&E===y&&y!==null}}export{De as DEFAULT_BROKER_PORT,$e as SYNC_PROTOCOL_VERSION,be as flushToolSyncNow,fe as getDefaultSocketURL,Be as getMetroHost,xe as getSyncStatus,re as registerToolFlusher,T as setSyncStatus,Ue as subscribeSyncStatus,ce as unregisterToolFlusher,Te as useExternalSync,Pe as useExternalSyncSocket};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@buoy-gg/external-sync",
-  "version": "7.0.41",
+  "version": "7.0.43",
   "description": "Generic device-to-desktop sync for Buoy dev tools",
   "main": "lib/commonjs/index.js",
   "module": "lib/module/index.js",
@@ -35,13 +35,10 @@
   "sideEffects": false,
   "dependencies": {
     "socket.io-client": "^4.8.1",
-    "@buoy-gg/license": "^7.0.41"
+    "@buoy-gg/license": "^7.0.43"
   },
   "peerDependencies": {
-    "react": "*",
-    "react-native": "*",
-    "react-native-web": "^0.21.0",
-    "react-dom": ">=18"
+    "react": "*"
   },
   "devDependencies": {
     "@types/react": "^19.1.0",

package/lib/typescript/attachDeviceSync.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"attachDeviceSync.d.ts","sourceRoot":"","sources":["../../src/attachDeviceSync.ts"],"names":[],"mappings":"AAQA,OAAO,EAQL,KAAK,eAAe,EACrB,MAAM,SAAS,CAAC;AAIjB,2DAA2D;AAC3D,MAAM,MAAM,UAAU,GAAG;IACvB,SAAS,EAAE,OAAO,CAAC;IACnB,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC;IACrD,EAAE,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,KAAK,OAAO,CAAC;IACnE,GAAG,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,KAAK,OAAO,CAAC;CACrE,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC;AAE7C,MAAM,MAAM,uBAAuB,GAAG;IACpC,MAAM,EAAE,UAAU,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IAChD;;;;OAIG;IACH,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAChC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB,CAAC;AAEF;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,EAC/B,MAAM,EACN,QAAQ,EACR,QAAQ,EACR,OAAO,EACP,UAAgB,EAChB,UAAkB,GACnB,EAAE,uBAAuB,GAAG,MAAM,IAAI,CAsStC"}

package/lib/typescript/brokerAccess.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"brokerAccess.d.ts","sourceRoot":"","sources":["../../src/brokerAccess.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,OAAO,CAAC;IACnB,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,GAAG,OAAO,CAAC;IAC/D,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,GAAG,OAAO,CAAC;IAChE,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;CAC9B;AACD,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GAC/B,MAAM,IAAI,CAoBZ"}

package/lib/typescript/crashFlush.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"crashFlush.d.ts","sourceRoot":"","sources":["../../src/crashFlush.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAIH,oEAAoE;AACpE,MAAM,MAAM,WAAW,GAAG,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;AAiBnD,gEAAgE;AAChE,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,CAE5D;AAED,8DAA8D;AAC9D,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,CAE9D;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAYrD"}

package/lib/typescript/emitBudget.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"emitBudget.d.ts","sourceRoot":"","sources":["../../src/emitBudget.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,mDAAmD;AACnD,eAAO,MAAM,uBAAuB,QAAkB,CAAC;AACvD,gFAAgF;AAChF,eAAO,MAAM,uBAAuB,QAAkB,CAAC;AAEvD,wBAAgB,cAAc,CAC5B,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,MAAM,GACZ;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CA2BxC"}

package/lib/typescript/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.tsx"],"names":[],"mappings":"AAGA,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAKhE,OAAO,EACL,mBAAmB,EACnB,YAAY,EACZ,mBAAmB,GACpB,MAAM,6BAA6B,CAAC;AAKrC,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAKhD,OAAO,EACL,aAAa,EACb,aAAa,EACb,mBAAmB,GACpB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAKpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAKhD,YAAY,EACV,eAAe,EACf,UAAU,EACV,cAAc,EACd,QAAQ,EACR,oBAAoB,EACpB,0BAA0B,EAC1B,yBAAyB,EACzB,kBAAkB,EAClB,oBAAoB,EACpB,0BAA0B,EAC1B,mBAAmB,EACnB,qBAAqB,EACrB,UAAU,GACX,MAAM,SAAS,CAAC"}

package/lib/typescript/syncStatusStore.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"syncStatusStore.d.ts","sourceRoot":"","sources":["../../src/syncStatusStore.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,UAAU;IACzB,4EAA4E;IAC5E,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,KAAK,EAAE,MAAM,GAAG,YAAY,GAAG,WAAW,GAAG,UAAU,CAAC;IACxD,oEAAoE;IACpE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,yCAAyC;IACzC,KAAK,EAAE,MAAM,CAAC;CACf;AAWD,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,IAAI,CAG9D;AAED,wBAAgB,aAAa,IAAI,UAAU,CAE1C;AAED,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAKpE"}

package/lib/typescript/types.d.ts.map

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

package/lib/typescript/useExternalSync.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"useExternalSync.d.ts","sourceRoot":"","sources":["../../src/useExternalSync.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAEpD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,eAAe,CAAC,EAC9B,KAAK,EACL,MAAM,EACN,QAAQ,EACR,OAAc,EACd,UAAgB,EAChB,UAAkB,GACnB,EAAE,oBAAoB,QA4BtB"}