@buoy-gg/external-sync 6.0.1 → 7.0.1

package/lib/commonjs/index.js

@@ -3,12 +3,48 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
+Object.defineProperty(exports, "DEFAULT_BROKER_PORT", {
+  enumerable: true,
+  get: function () {
+    return _getDefaultSocketURL.DEFAULT_BROKER_PORT;
+  }
+});
 Object.defineProperty(exports, "SYNC_PROTOCOL_VERSION", {
   enumerable: true,
   get: function () {
     return _types.SYNC_PROTOCOL_VERSION;
   }
 });
+Object.defineProperty(exports, "getDefaultSocketURL", {
+  enumerable: true,
+  get: function () {
+    return _getDefaultSocketURL.getDefaultSocketURL;
+  }
+});
+Object.defineProperty(exports, "getMetroHost", {
+  enumerable: true,
+  get: function () {
+    return _getDefaultSocketURL.getMetroHost;
+  }
+});
+Object.defineProperty(exports, "getSyncStatus", {
+  enumerable: true,
+  get: function () {
+    return _syncStatusStore.getSyncStatus;
+  }
+});
+Object.defineProperty(exports, "setSyncStatus", {
+  enumerable: true,
+  get: function () {
+    return _syncStatusStore.setSyncStatus;
+  }
+});
+Object.defineProperty(exports, "subscribeSyncStatus", {
+  enumerable: true,
+  get: function () {
+    return _syncStatusStore.subscribeSyncStatus;
+  }
+});
 Object.defineProperty(exports, "useExternalSync", {
   enumerable: true,
   get: function () {
@@ -23,4 +59,6 @@ Object.defineProperty(exports, "useExternalSyncSocket", {
 });
 var _useExternalSync = require("./useExternalSync");
 var _useExternalSyncSocket = require("./useExternalSyncSocket");
+var _getDefaultSocketURL = require("./utils/getDefaultSocketURL");
+var _syncStatusStore = require("./syncStatusStore");
 var _types = require("./types");

package/lib/commonjs/syncStatusStore.js

@@ -0,0 +1,40 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.getSyncStatus = getSyncStatus;
+exports.setSyncStatus = setSyncStatus;
+exports.subscribeSyncStatus = subscribeSyncStatus;
+/**
+ * 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.
+ */
+
+let status = {
+  targetURL: null,
+  state: "idle",
+  lastError: null,
+  since: 0
+};
+const listeners = new Set();
+function setSyncStatus(patch) {
+  status = {
+    ...status,
+    ...patch,
+    since: Date.now()
+  };
+  listeners.forEach(listener => listener());
+}
+function getSyncStatus() {
+  return status;
+}
+function subscribeSyncStatus(listener) {
+  listeners.add(listener);
+  return () => {
+    listeners.delete(listener);
+  };
+}

package/lib/commonjs/useExternalSyncSocket.js

@@ -7,7 +7,9 @@ exports.useExternalSyncSocket = useExternalSyncSocket;
 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;
@@ -50,6 +52,8 @@ function useExternalSyncSocket({
   const [socket, setSocket] = (0, _react.useState)(null);
   const [isConnected, setIsConnected] = (0, _react.useState)(false);
   const initialized = (0, _react.useRef)(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);
@@ -58,19 +62,33 @@ function useExternalSyncSocket({
     (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;
-    (0, _logger.log)(`${logPrefix} Socket connection error: ${error.message}. Retrying in the background until the dashboard is available.`, enableLogs, "warn");
+    // 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");
@@ -81,8 +99,13 @@ function useExternalSyncSocket({
     if (!persistentDeviceId) return;
     if (initialized.current) return;
     initialized.current = true;
-    const platformUrl = (0, _platformUtils.getPlatformSpecificURL)(socketURL, platform);
+    const platformUrl = (0, _platformUtils.getPlatformSpecificURL)(resolvedSocketURL, platform);
     currentSocketURL = platformUrl;
+    (0, _syncStatusStore.setSyncStatus)({
+      targetURL: platformUrl,
+      state: "connecting",
+      lastError: null
+    });
     (0, _logger.log)(`${logPrefix} Platform: ${platform}, using URL: ${platformUrl}`, enableLogs);
     try {
       if (!globalSocketInstance) {
@@ -145,12 +168,17 @@ function useExternalSyncSocket({
 
   // Update socket URL when socketURL changes
   (0, _react.useEffect)(() => {
-    const platformUrl = (0, _platformUtils.getPlatformSpecificURL)(socketURL, platform);
+    const platformUrl = (0, _platformUtils.getPlatformSpecificURL)(resolvedSocketURL, platform);
     if (socketRef.current && currentSocketURL !== platformUrl && persistentDeviceId) {
       (0, _logger.log)(`${logPrefix} Socket URL changed from ${currentSocketURL} to ${platformUrl}`, enableLogs);
       try {
         socketRef.current.disconnect();
         currentSocketURL = platformUrl;
+        (0, _syncStatusStore.setSyncStatus)({
+          targetURL: platformUrl,
+          state: "connecting",
+          lastError: null
+        });
         (0, _logger.log)(`${logPrefix} Creating new socket connection to ${platformUrl}`, enableLogs);
         globalSocketInstance = (0, _socket.io)(platformUrl, {
           autoConnect: true,
@@ -174,7 +202,7 @@ function useExternalSyncSocket({
         (0, _logger.log)(`${logPrefix} Failed to update socket connection: ${error}`, enableLogs, "error");
       }
     }
-  }, [socketURL, deviceName, logPrefix, persistentDeviceId, platform, enableLogs]);
+  }, [resolvedSocketURL, deviceName, logPrefix, persistentDeviceId, platform, enableLogs]);
   function connect() {
     if (socketRef.current && !socketRef.current.connected) {
       (0, _logger.log)(`${logPrefix} Manually connecting to socket server`, enableLogs);

package/lib/commonjs/utils/getDefaultSocketURL.js

@@ -0,0 +1,62 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.DEFAULT_BROKER_PORT = void 0;
+exports.getDefaultSocketURL = getDefaultSocketURL;
+exports.getMetroHost = getMetroHost;
+/**
+ * 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 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 scriptURL = NativeSourceCode?.getConstants?.().scriptURL;
+    const match = scriptURL?.match(HOST_RE);
+    if (match) return match[1];
+  } catch {
+    // web / RN internals moved — try the old-architecture module
+  }
+  try {
+    const {
+      NativeModules
+    } = require("react-native");
+    const scriptURL = NativeModules?.SourceCode?.getConstants?.().scriptURL ?? NativeModules?.SourceCode?.scriptURL;
+    const match = scriptURL?.match(HOST_RE);
+    if (match) return match[1];
+  } 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 `http://${getMetroHost() ?? "localhost"}:${DEFAULT_BROKER_PORT}`;
+}

package/lib/commonjs/utils/platformUtils.js

@@ -4,14 +4,40 @@ 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 Android emulator, replaces localhost with 10.0.2.2.
+ * 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")) {
+    if (platform === "android" && (url.hostname === "localhost" || url.hostname === "127.0.0.1") && isAndroidEmulator()) {
       url.hostname = "10.0.2.2";
       return url.toString();
     }

package/lib/module/index.js

@@ -6,6 +6,15 @@
 export { useExternalSync } from "./useExternalSync";
 export { useExternalSyncSocket } from "./useExternalSyncSocket";
 
+// ============================================================
+// BROKER URL DERIVATION
+// ============================================================
+export { getDefaultSocketURL, getMetroHost, DEFAULT_BROKER_PORT } from "./utils/getDefaultSocketURL";
+
+// ============================================================
+// SYNC STATUS (read by the floating menu's settings modal)
+// ============================================================
+export { getSyncStatus, setSyncStatus, subscribeSyncStatus } from "./syncStatusStore";
 // ============================================================
 // PROTOCOL
 // ============================================================

package/lib/module/syncStatusStore.js

@@ -0,0 +1,34 @@
+"use strict";
+
+/**
+ * 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.
+ */
+
+let status = {
+  targetURL: null,
+  state: "idle",
+  lastError: null,
+  since: 0
+};
+const listeners = new Set();
+export function setSyncStatus(patch) {
+  status = {
+    ...status,
+    ...patch,
+    since: Date.now()
+  };
+  listeners.forEach(listener => listener());
+}
+export function getSyncStatus() {
+  return status;
+}
+export function subscribeSyncStatus(listener) {
+  listeners.add(listener);
+  return () => {
+    listeners.delete(listener);
+  };
+}

package/lib/module/useExternalSyncSocket.js

@@ -3,7 +3,9 @@
 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;
@@ -46,6 +48,8 @@ export function useExternalSyncSocket({
   const [socket, setSocket] = useState(null);
   const [isConnected, setIsConnected] = useState(false);
   const initialized = useRef(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);
@@ -54,19 +58,33 @@ export function useExternalSyncSocket({
     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;
-    log(`${logPrefix} Socket connection error: ${error.message}. Retrying in the background until the dashboard is available.`, enableLogs, "warn");
+    // 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");
@@ -77,8 +95,13 @@ export function useExternalSyncSocket({
     if (!persistentDeviceId) return;
     if (initialized.current) return;
     initialized.current = true;
-    const platformUrl = getPlatformSpecificURL(socketURL, platform);
+    const platformUrl = getPlatformSpecificURL(resolvedSocketURL, platform);
     currentSocketURL = platformUrl;
+    setSyncStatus({
+      targetURL: platformUrl,
+      state: "connecting",
+      lastError: null
+    });
     log(`${logPrefix} Platform: ${platform}, using URL: ${platformUrl}`, enableLogs);
     try {
       if (!globalSocketInstance) {
@@ -141,12 +164,17 @@ export function useExternalSyncSocket({
 
   // Update socket URL when socketURL changes
   useEffect(() => {
-    const platformUrl = getPlatformSpecificURL(socketURL, platform);
+    const platformUrl = getPlatformSpecificURL(resolvedSocketURL, platform);
     if (socketRef.current && currentSocketURL !== platformUrl && persistentDeviceId) {
       log(`${logPrefix} Socket URL changed from ${currentSocketURL} to ${platformUrl}`, enableLogs);
       try {
         socketRef.current.disconnect();
         currentSocketURL = platformUrl;
+        setSyncStatus({
+          targetURL: platformUrl,
+          state: "connecting",
+          lastError: null
+        });
         log(`${logPrefix} Creating new socket connection to ${platformUrl}`, enableLogs);
         globalSocketInstance = socketIO(platformUrl, {
           autoConnect: true,
@@ -170,7 +198,7 @@ export function useExternalSyncSocket({
         log(`${logPrefix} Failed to update socket connection: ${error}`, enableLogs, "error");
       }
     }
-  }, [socketURL, deviceName, logPrefix, persistentDeviceId, platform, enableLogs]);
+  }, [resolvedSocketURL, deviceName, logPrefix, persistentDeviceId, platform, enableLogs]);
   function connect() {
     if (socketRef.current && !socketRef.current.connected) {
       log(`${logPrefix} Manually connecting to socket server`, enableLogs);

package/lib/module/utils/getDefaultSocketURL.js

@@ -0,0 +1,56 @@
+"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 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 {
+    // 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 scriptURL = NativeSourceCode?.getConstants?.().scriptURL;
+    const match = scriptURL?.match(HOST_RE);
+    if (match) return match[1];
+  } catch {
+    // web / RN internals moved — try the old-architecture module
+  }
+  try {
+    const {
+      NativeModules
+    } = require("react-native");
+    const scriptURL = NativeModules?.SourceCode?.getConstants?.().scriptURL ?? NativeModules?.SourceCode?.scriptURL;
+    const match = scriptURL?.match(HOST_RE);
+    if (match) return match[1];
+  } 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 `http://${getMetroHost() ?? "localhost"}:${DEFAULT_BROKER_PORT}`;
+}

package/lib/module/utils/platformUtils.js

@@ -1,13 +1,39 @@
 "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 Android emulator, replaces localhost with 10.0.2.2.
+ * 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")) {
+    if (platform === "android" && (url.hostname === "localhost" || url.hostname === "127.0.0.1") && isAndroidEmulator()) {
       url.hostname = "10.0.2.2";
       return url.toString();
     }

package/lib/typescript/index.d.ts

@@ -1,5 +1,8 @@
 export { useExternalSync } from "./useExternalSync";
 export { useExternalSyncSocket } from "./useExternalSyncSocket";
+export { getDefaultSocketURL, getMetroHost, DEFAULT_BROKER_PORT, } from "./utils/getDefaultSocketURL";
+export { getSyncStatus, setSyncStatus, subscribeSyncStatus, } from "./syncStatusStore";
+export type { SyncStatus } from "./syncStatusStore";
 export { SYNC_PROTOCOL_VERSION } from "./types";
 export type { ToolSyncAdapter, ToolAction, ToolCapability, SyncKind, UseExternalSyncProps, UseExternalSyncSocketProps, DeviceCapabilitiesMessage, DevToolSyncMessage, DevToolActionMessage, DevToolActionResultMessage, DevToolWatchMessage, DevToolRequestMessage, PlatformOS, } from "./types";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"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,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"}
+{"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,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

@@ -0,0 +1,20 @@
+/**
+ * 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;
+    state: "idle" | "connecting" | "connected" | "retrying";
+    /** Message of the most recent connect error; cleared on connect. */
+    lastError: string | null;
+    /** Epoch ms of the last state change. */
+    since: number;
+}
+export declare function setSyncStatus(patch: Partial<SyncStatus>): void;
+export declare function getSyncStatus(): SyncStatus;
+export declare function subscribeSyncStatus(listener: () => void): () => void;
+//# sourceMappingURL=syncStatusStore.d.ts.map

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

@@ -0,0 +1 @@
+{"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

@@ -103,7 +103,14 @@ export interface UseExternalSyncProps {
 export type PlatformOS = "ios" | "android" | "web" | "windows" | "macos" | "native" | "tv" | "tvos" | "visionos" | "maccatalyst";
 export interface UseExternalSyncSocketProps {
     deviceName: string;
-    socketURL: string;
+    /**
+     * Broker URL to dial. @default derived from Metro's scriptURL host
+     * (the machine that served the bundle — Buoy Desktop's machine) on port
+     * 42831, so physical devices work zero-config (Android over USB: run
+     * `adb reverse tcp:42831 tcp:42831`). Pass explicitly for tunnels or a
+     * broker on another machine.
+     */
+    socketURL?: string;
     persistentDeviceId: string | null;
     extraDeviceInfo?: Record<string, string>;
     envVariables?: Record<string, string>;

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AA0B/C,yEAAyE;AACzE,eAAO,MAAM,qBAAqB,IAAI,CAAC;AAEvC,+EAA+E;AAC/E,MAAM,MAAM,QAAQ,GAAG,UAAU,CAAC;AAMlC,mFAAmF;AACnF,MAAM,MAAM,UAAU,GAAG,CAAC,MAAM,EAAE,OAAO,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;AAEzE;;;;;;GAMG;AACH,MAAM,WAAW,eAAe;IAC9B,sEAAsE;IACtE,OAAO,EAAE,MAAM,CAAC;IAChB,oFAAoF;IACpF,WAAW,EAAE,MAAM,OAAO,CAAC;IAC3B;;;;OAIG;IACH,SAAS,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,MAAM,IAAI,CAAC;IAChD,sDAAsD;IACtD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;CACtC;AAMD,4EAA4E;AAC5E,MAAM,WAAW,yBAAyB;IACxC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,eAAe,EAAE,MAAM,CAAC;IACxB,KAAK,EAAE,cAAc,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,+CAA+C;AAC/C,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,kBAAkB,EAAE,MAAM,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,sDAAsD;IACtD,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,QAAQ,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,8CAA8C;AAC9C,MAAM,WAAW,0BAA0B;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,kBAAkB,EAAE,MAAM,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,EAAE,EAAE,OAAO,CAAC;IACZ,uEAAuE;IACvE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,2BAA2B;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAMD,uEAAuE;AACvE,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,gFAAgF;AAChF,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,iDAAiD;AACjD,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAMD,MAAM,WAAW,oBAAoB;IACnC,yEAAyE;IACzE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IACvC,8DAA8D;IAC9D,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,oCAAoC;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,yCAAyC;IACzC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qBAAqB;IACrB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAMD;;GAEG;AACH,MAAM,MAAM,UAAU,GAClB,KAAK,GACL,SAAS,GACT,KAAK,GACL,SAAS,GACT,OAAO,GACP,QAAQ,GACR,IAAI,GACJ,MAAM,GACN,UAAU,GACV,aAAa,CAAC;AAMlB,MAAM,WAAW,0BAA0B;IACzC,UAAU,EAAE,MAAM,CAAC;IACnB;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,QAAQ,EAAE,UAAU,CAAC;IACrB,qBAAqB;IACrB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB"}

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

@@ -1 +1 @@
-{"version":3,"file":"useExternalSyncSocket.d.ts","sourceRoot":"","sources":["../../src/useExternalSyncSocket.ts"],"names":[],"mappings":"AACA,OAAO,EAAkB,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAI1D,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,SAAS,CAAC;AA0B1D;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,EACpC,UAAU,EACV,SAAS,EACT,kBAAkB,EAClB,eAAe,EACf,YAAY,EACZ,QAAQ,EACR,UAAkB,GACnB,EAAE,0BAA0B;;;;;EAsN5B"}
+{"version":3,"file":"useExternalSyncSocket.d.ts","sourceRoot":"","sources":["../../src/useExternalSyncSocket.ts"],"names":[],"mappings":"AACA,OAAO,EAAkB,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAM1D,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,SAAS,CAAC;AA0B1D;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,EACpC,UAAU,EACV,SAAS,EACT,kBAAkB,EAClB,eAAe,EACf,YAAY,EACZ,QAAQ,EACR,UAAkB,GACnB,EAAE,0BAA0B;;;;;EA4O5B"}

package/lib/typescript/utils/getDefaultSocketURL.d.ts

@@ -0,0 +1,25 @@
+/**
+ * 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 declare const DEFAULT_BROKER_PORT = 42831;
+/**
+ * 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 declare function getMetroHost(): string | 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 declare function getDefaultSocketURL(): string;
+//# sourceMappingURL=getDefaultSocketURL.d.ts.map

package/lib/typescript/utils/getDefaultSocketURL.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getDefaultSocketURL.d.ts","sourceRoot":"","sources":["../../../src/utils/getDefaultSocketURL.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,6CAA6C;AAC7C,eAAO,MAAM,mBAAmB,QAAQ,CAAC;AAIzC;;;;;;;;;GASG;AACH,wBAAgB,YAAY,IAAI,MAAM,GAAG,IAAI,CAyB5C;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C"}

package/lib/typescript/utils/platformUtils.d.ts

@@ -1,7 +1,8 @@
 import type { PlatformOS } from "../types";
 /**
  * Get platform-specific URL for socket connection.
- * On Android emulator, replaces localhost with 10.0.2.2.
+ * On the Android emulator (only), replaces localhost with 10.0.2.2 —
+ * the emulator's alias for the host machine's loopback.
  */
 export declare const getPlatformSpecificURL: (baseUrl: string, platform: PlatformOS) => string;
 //# sourceMappingURL=platformUtils.d.ts.map

package/lib/typescript/utils/platformUtils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"platformUtils.d.ts","sourceRoot":"","sources":["../../../src/utils/platformUtils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAE3C;;;GAGG;AACH,eAAO,MAAM,sBAAsB,GACjC,SAAS,MAAM,EACf,UAAU,UAAU,KACnB,MAiBF,CAAC"}
+{"version":3,"file":"platformUtils.d.ts","sourceRoot":"","sources":["../../../src/utils/platformUtils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AA4B3C;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,GACjC,SAAS,MAAM,EACf,UAAU,UAAU,KACnB,MAkBF,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@buoy-gg/external-sync",
-  "version": "6.0.1",
+  "version": "7.0.1",
   "description": "Generic device-to-desktop sync for Buoy dev tools",
   "main": "lib/commonjs/index.js",
   "module": "lib/module/index.js",
@@ -25,16 +25,16 @@
     "lib"
   ],
   "sideEffects": false,
-  "dependencies": {},
+  "dependencies": {
+    "socket.io-client": "^4.8.1"
+  },
   "peerDependencies": {
     "react": "*",
-    "react-native": "*",
-    "socket.io-client": ">=4.0.0"
+    "react-native": "*"
   },
   "devDependencies": {
     "@types/react": "^19.1.0",
     "@types/react-native": "^0.73.0",
-    "socket.io-client": "^4.8.1",
     "typescript": "~5.8.3"
   },
   "react-native-builder-bob": {
@@ -58,13 +58,12 @@
   },
   "repository": {
     "type": "git",
-    "url": "https://github.com/LovesWorking/react-native-buoy.git",
-    "directory": "packages/external-sync"
+    "url": "https://github.com/Buoy-gg/buoy.git"
   },
   "bugs": {
     "url": "https://github.com/LovesWorking/react-native-buoy/issues"
   },
-  "homepage": "https://github.com/LovesWorking/react-native-buoy/tree/main/packages/external-sync#readme",
+  "homepage": "https://buoy.gg",
   "publishConfig": {
     "access": "public",
     "tag": "latest"