@qontinui/ui-bridge-native 0.6.13 → 0.6.14

package/dist/react/UIBridgeNativeProvider.d.ts

@@ -9,6 +9,7 @@ import { NativeUIBridgeRegistry } from '../core/registry';
 import type { NativeActionExecutor } from '../control/types';
 import { type ServerAdapter } from '../server/http-server';
 import type { RouteProvider, KeepAwakeProvider } from '../server/types';
+import { type ZeroconfConstructor } from '../transport/DeviceAnnouncer';
 import { type CloudRelayConfig } from '../transport/CloudRelayClient';
 import { ModalDetector } from '../modal/modal-detector';
 import { ToastCapture } from '../toast/toast-capture';
@@ -109,9 +110,24 @@ export interface UIBridgeNativeProviderProps {
     cloudRelayConfig?: Omit<CloudRelayConfig, 'uiBridgeServer'>;
     /**
      * Enable mDNS advertisement so that runners on the same LAN can discover this
-     * device automatically (requires react-native-zeroconf).
+     * device automatically. Advertises `_uibridge._tcp` only when `zeroconf` is
+     * also passed; without it the announcer logs that advertisement was skipped.
      */
     enableMdnsAnnounce?: boolean;
+    /**
+     * The `Zeroconf` constructor from `react-native-zeroconf`
+     * (`import Zeroconf from 'react-native-zeroconf'` → `zeroconf={Zeroconf}`),
+     * forwarded to `DeviceAnnouncer.startMdnsAdvertise`. The SDK never
+     * `require()`s that package itself — Metro raises an uncatchable module-load
+     * error when it is absent — so the host app, which knows it is installed,
+     * hands the constructor in. Omitted, mDNS advertisement is skipped.
+     *
+     * Must be a STABLE reference — the module-level import, never an inline
+     * wrapper — because it is a dependency of the transport effect: a new
+     * identity per render tears down and re-publishes the advertisement (and the
+     * cloud relay) on every render.
+     */
+    zeroconf?: ZeroconfConstructor;
     /**
      * Stable device identifier used for mDNS TXT records and cloud relay
      * registration.  Typically sourced from expo-device or a UUID stored in
@@ -119,7 +135,7 @@ export interface UIBridgeNativeProviderProps {
      */
     deviceId?: string;
 }
-export declare function UIBridgeNativeProvider({ children, features: featuresProp, config: configProp, onEvent, serverAdapter, navigationProvider, screenshotProvider, keepAwakeProvider, routeProvider, cloudRelayConfig, enableMdnsAnnounce, deviceId, }: UIBridgeNativeProviderProps): import("react/jsx-runtime").JSX.Element;
+export declare function UIBridgeNativeProvider({ children, features: featuresProp, config: configProp, onEvent, serverAdapter, navigationProvider, screenshotProvider, keepAwakeProvider, routeProvider, cloudRelayConfig, enableMdnsAnnounce, zeroconf, deviceId, }: UIBridgeNativeProviderProps): import("react/jsx-runtime").JSX.Element;
 /**
  * useUIBridgeNative hook
  *

package/dist/react/UIBridgeNativeProvider.d.ts.map

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

package/dist/react/index.js

@@ -4313,7 +4313,7 @@ function createServerHandlers(registry, executor, config) {
       };
       if (config?.appInfo) {
         response.uiBridge = {
-          version: "0.6.13",
+          version: "0.6.14",
           ...config.appInfo,
           capabilities: ["elements", "components", "actions", "design"],
           elementCount: stats.elements,
@@ -6236,7 +6236,26 @@ function describeErrorEvent(event) {
 }
 
 // src/transport/DeviceAnnouncer.ts
+function registeredServiceName(result, requested) {
+  if (result !== null && typeof result === "object") {
+    const name = result.name;
+    if (typeof name === "string" && name.length > 0) return name;
+  }
+  return requested;
+}
 var DEFAULT_PORT = 8087;
+async function releaseZeroconf(zeroconf, name) {
+  if (name !== null) {
+    try {
+      await zeroconf.unpublishService(name);
+    } catch {
+    }
+  }
+  try {
+    zeroconf.removeDeviceListeners?.();
+  } catch {
+  }
+}
 var RECONNECT_INITIAL_DELAY_MS = 2e3;
 var RECONNECT_MAX_DELAY_MS = 6e4;
 var DeviceAnnouncer = class {
@@ -6249,8 +6268,16 @@ var DeviceAnnouncer = class {
     this.reconnectTimer = null;
     this.reconnectDelay = RECONNECT_INITIAL_DELAY_MS;
     this.stopped = false;
-    /** Zeroconf instance, set when mDNS is successfully started */
+    /** Zeroconf instance, set when mDNS is started (cleared by `stop()`) */
     this.zeroconf = null;
+    /** The name the library registered — the only name this announcer may unpublish */
+    this.publishedName = null;
+    /**
+     * True while a publish is awaiting the library. A `stop()` that lands in that
+     * window leaves the cleanup to the publish path, which is the only side that
+     * will learn the registered name.
+     */
+    this.publishInFlight = false;
     this.config = config;
     this.pairingToken = generateHex(16);
   }
@@ -6275,19 +6302,38 @@ var DeviceAnnouncer = class {
       );
       return;
     }
+    if (this.stopped) return;
+    let zeroconf = null;
     try {
-      this.zeroconf = new ZeroconfCtor();
+      zeroconf = new ZeroconfCtor();
+      this.zeroconf = zeroconf;
       const port = this.config.port ?? DEFAULT_PORT;
       const serviceName = `UIBridge-${this.config.deviceId.slice(0, 8)}`;
-      this.zeroconf.publishService("_uibridge", "_tcp.", "local.", serviceName, port, {
-        device_id: this.config.deviceId,
-        app_id: this.config.appId,
-        version: this.config.version ?? "unknown",
-        pairing_token: this.pairingToken
-      });
+      this.publishInFlight = true;
+      let result;
+      try {
+        result = await zeroconf.publishService("_uibridge", "_tcp.", "local.", serviceName, port, {
+          device_id: this.config.deviceId,
+          app_id: this.config.appId,
+          version: this.config.version ?? "unknown",
+          pairing_token: this.pairingToken
+        });
+      } finally {
+        this.publishInFlight = false;
+      }
+      const registered = registeredServiceName(result, serviceName);
+      if (this.stopped) {
+        await releaseZeroconf(zeroconf, registered);
+        return;
+      }
+      this.publishedName = registered;
       this.state = { ...this.state, mdnsActive: true };
-      transportLogger.log(`[DeviceAnnouncer] mDNS: advertising "${serviceName}" on port ${port}`);
+      transportLogger.log(`[DeviceAnnouncer] mDNS: advertising "${registered}" on port ${port}`);
     } catch (err) {
+      if (this.stopped) {
+        if (zeroconf) await releaseZeroconf(zeroconf, null);
+        return;
+      }
       transportLogger.warn("[DeviceAnnouncer] mDNS start failed:", err);
     }
   }
@@ -6360,15 +6406,15 @@ var DeviceAnnouncer = class {
       clearTimeout(this.reconnectTimer);
       this.reconnectTimer = null;
     }
-    if (this.zeroconf) {
-      try {
-        const serviceName = `UIBridge-${this.config.deviceId.slice(0, 8)}`;
-        this.zeroconf.unpublishService(serviceName);
-      } catch {
-      }
-      this.zeroconf = null;
-    }
+    const zeroconf = this.zeroconf;
+    const publishedName = this.publishedName;
+    const inFlight = this.publishInFlight;
+    this.zeroconf = null;
+    this.publishedName = null;
     this.state = { ...this.state, mdnsActive: false };
+    if (zeroconf && !inFlight) {
+      await releaseZeroconf(zeroconf, publishedName);
+    }
     if (this.cloudWs) {
       this.cloudWs.onclose = null;
       this.cloudWs.close();
@@ -6784,6 +6830,7 @@ function UIBridgeNativeProvider({
   routeProvider,
   cloudRelayConfig,
   enableMdnsAnnounce,
+  zeroconf,
   deviceId
 }) {
   const features = useValueStable(featuresProp);
@@ -6957,7 +7004,7 @@ function UIBridgeNativeProvider({
             cloudToken: cloudRelayConfig?.authToken
           });
           announcerRef.current = announcer;
-          void announcer.startMdnsAdvertise().catch((err) => {
+          void announcer.startMdnsAdvertise(zeroconf).catch((err) => {
             console.warn("[ui-bridge-native] mDNS advertise failed:", err);
           });
         } catch (err) {
@@ -6998,6 +7045,7 @@ function UIBridgeNativeProvider({
     cloudRelayConfig?.relayUrl,
     cloudRelayConfig?.authToken,
     enableMdnsAnnounce,
+    zeroconf,
     deviceId
   ]);
   react.useEffect(() => {