@qontinui/ui-bridge-native 0.6.8 → 0.6.10

package/dist/index.js

@@ -28,7 +28,7 @@ function inferActions(type) {
     case "pressable":
       return [...baseActions, "click", "press", "longPress", "doubleTap"];
     case "input":
-      return [...baseActions, "click", "press", "type", "clear"];
+      return [...baseActions, "click", "press", "type", "setValue", "clear"];
     case "text":
       return [...baseActions, "click", "press", "longPress"];
     case "view":
@@ -987,9 +987,10 @@ var DefaultNativeActionExecutor = class {
         requestId: request.requestId,
         durationMs: successTime - startTime
       });
+      const fresh = this.registry.getElement(registered.id) ?? registered;
       return {
         success: true,
-        elementState: registered.getState(),
+        elementState: fresh.getState(),
         result,
         durationMs: successTime - startTime,
         timestamp: successTime,
@@ -1042,6 +1043,8 @@ var DefaultNativeActionExecutor = class {
         return this.performDoubleTap(props);
       case "type":
         return this.performType(element, props, params);
+      case "setValue":
+        return this.performSetValue(element, props, params);
       case "clear":
         return this.performClear(element, props);
       case "focus":
@@ -1134,6 +1137,38 @@ var DefaultNativeActionExecutor = class {
       this.registry.updateElementState(element.id, { value: params.text });
     }
   }
+  /**
+   * Perform setValue action.
+   *
+   * Web/runner UI Bridge parity: `setValue` replaces the input's value
+   * atomically in a single call (no per-character keystroke simulation),
+   * mirroring the web bridge's `setValue` semantics. On native there is no
+   * DOM value to assign, so we drive the controlled-input handler
+   * (`onChangeText`, falling back to `onChange`) with the full string. The
+   * registry's `state.value` is then synced so a subsequent GET on the
+   * element reflects the new value.
+   *
+   * Unlike `type`, this does not append to existing content and ignores
+   * `delay` — it is the deterministic "set the field to exactly this" action.
+   */
+  async performSetValue(element, props, params) {
+    const next = typeof params?.text === "string" ? params.text : typeof params?.value === "string" ? params.value : void 0;
+    if (typeof next !== "string") {
+      throw new Error('setValue action requires a string "text" (or "value") parameter');
+    }
+    if (typeof props.onChangeText === "function") {
+      props.onChangeText(next);
+    } else if (typeof props.onChange === "function") {
+      props.onChange({
+        nativeEvent: { text: next }
+      });
+    } else {
+      throw new Error("No text change handler found on element");
+    }
+    if (element) {
+      this.registry.updateElementState(element.id, { value: next });
+    }
+  }
   /**
    * Perform clear action
    */
@@ -2126,6 +2161,13 @@ function matchElementsByText(registry, text, opts) {
   scored.sort((a, b) => a.rank - b.rank);
   return scored.map((s) => s.element);
 }
+function resolveElementState(element) {
+  const state = element.getState();
+  if (element.type === "input" && state.value === void 0 && typeof element.props?.value === "string") {
+    return { ...state, value: element.props.value };
+  }
+  return state;
+}
 async function executeWorkflowStep(step, registry, executor) {
   const startTime = Date.now();
   try {
@@ -2362,7 +2404,7 @@ function createServerHandlers(registry, executor, config) {
           type: element.type,
           label: element.label,
           identifier: element.getIdentifier(),
-          state: element.getState(),
+          state: resolveElementState(element),
           actions: element.actions,
           customActions: element.customActions ? Object.keys(element.customActions) : void 0,
           registeredHandlers: handlers.length > 0 ? handlers : void 0,
@@ -2376,18 +2418,19 @@ function createServerHandlers(registry, executor, config) {
       if (!element) {
         return error2(`Element not found: ${id}`, "ELEMENT_NOT_FOUND");
       }
-      return success2({ state: element.getState() });
+      return success2({ state: resolveElementState(element) });
     },
     executeAction: async (ctx) => {
-      const { id } = ctx.params;
-      const body = ctx.body;
-      if (!body?.action) {
+      const rawBody = ctx.body ?? {};
+      const envelope = rawBody.request && typeof rawBody.request === "object" ? rawBody.request : rawBody;
+      const id = ctx.params.id ?? rawBody.id ?? "";
+      if (!envelope?.action) {
         return error2("Action is required", "INVALID_REQUEST");
       }
       const response = await executor.executeAction(id, {
-        action: body.action,
-        params: body.params,
-        waitOptions: body.waitOptions
+        action: envelope.action,
+        params: envelope.params,
+        waitOptions: envelope.waitOptions
       });
       if (!response.success) {
         return error2(response.error || "Action failed", "ACTION_FAILED");
@@ -2899,7 +2942,8 @@ function createServerHandlers(registry, executor, config) {
         return success2({
           entries: [],
           count: 0,
-          bufferSize: 0
+          bufferSize: 0,
+          installed: false
         });
       }
       const entries = buf.entries({
@@ -2909,7 +2953,8 @@ function createServerHandlers(registry, executor, config) {
       return success2({
         entries,
         count: entries.length,
-        bufferSize: buf.size()
+        bufferSize: buf.size(),
+        installed: buf.isInstalled()
       });
     },
     getNetworkRequests: async (ctx) => {
@@ -2920,7 +2965,8 @@ function createServerHandlers(registry, executor, config) {
         return success2({
           entries: [],
           count: 0,
-          bufferSize: 0
+          bufferSize: 0,
+          installed: false
         });
       }
       const entries = buf.entries({
@@ -2930,7 +2976,8 @@ function createServerHandlers(registry, executor, config) {
       return success2({
         entries,
         count: entries.length,
-        bufferSize: buf.size()
+        bufferSize: buf.size(),
+        installed: buf.isInstalled()
       });
     },
     // Test hooks — modal stack manipulation
@@ -3022,7 +3069,7 @@ function createServerHandlers(registry, executor, config) {
       };
       if (config?.appInfo) {
         response.uiBridge = {
-          version: "0.3.0",
+          version: "0.6.10",
           ...config.appInfo,
           capabilities: ["elements", "components", "actions", "design"],
           elementCount: stats.elements,
@@ -3349,7 +3396,10 @@ var WS_ROUTES = [
   // same handler at both paths to keep agents portable across platforms.
   { pattern: "ai/find", handler: "find", httpMethods: ["POST"] },
   { pattern: "control/snapshot", handler: "getSnapshot", httpMethods: ["GET"] },
-  { pattern: "control/discover", handler: "getSnapshot" },
+  // Discovery alias — web/runner parity with `POST /control/discover` (a
+  // legacy alias for snapshot/find). Mounted on HTTP (GET+POST) so mobile
+  // doesn't 404 where web returns 200; delegates to the snapshot handler.
+  { pattern: "control/discover", handler: "getSnapshot", httpMethods: ["GET", "POST"] },
   // Page health — accepts both GET and POST so the canonical skill invocation
   // (`POST .../control/page-health` with an empty body) and ad-hoc curls both
   // work without a body-shape gotcha.
@@ -3443,19 +3493,26 @@ var WS_ROUTES = [
     httpMethods: ["POST"],
     requiresTestHooks: true
   },
-  // Observability — last-N console errors + network requests. testHooks-gated
-  // because patching `console.error` / `fetch` is invasive in production.
+  // Observability — last-N console errors + network requests.
+  //
+  // Always mounted (not testHooks-gated) so they return a schema-valid 200
+  // on every build instead of a 404 that agents can't distinguish from a
+  // missing route. The INVASIVE part — monkey-patching `console.error` /
+  // `fetch` / `XMLHttpRequest` — stays gated behind `testHooks` (see
+  // NativeUIBridgeServer.start → buffer.install()). When the patches aren't
+  // installed the handlers report `installed: false` + empty entries, so
+  // production builds expose the contract without observing real users'
+  // console/network traffic. Set `features.testHooks` (typically on
+  // `__DEV__`) to populate the buffers with live data.
   {
     pattern: "control/console-errors",
     handler: "getConsoleErrors",
-    httpMethods: ["GET"],
-    requiresTestHooks: true
+    httpMethods: ["GET"]
   },
   {
     pattern: "sdk/network-requests",
     handler: "getNetworkRequests",
-    httpMethods: ["GET"],
-    requiresTestHooks: true
+    httpMethods: ["GET"]
   }
 ];
 var HANDLER_DESCRIPTIONS = {
@@ -3502,8 +3559,8 @@ var HANDLER_DESCRIPTIONS = {
   typeInto: "App-agnostic: type into the input matching a label: body { label, text, clear?, visibleOnly? }. (selector form is web-only)",
   readValue: "STUB \u2014 selector-based; NOT_SUPPORTED on native (no DOM). Use /control/element/:id/state to read a value.",
   findByText: "App-agnostic: list elements matching free-text (no press): body { text, visibleOnly? }",
-  getConsoleErrors: "TEST HOOK \u2014 last-N console.error/console.warn entries; ?since=<ms>&limit=<n>",
-  getNetworkRequests: "TEST HOOK \u2014 last-N fetch/XHR entries with status + duration; ?since=<ms>&limit=<n>",
+  getConsoleErrors: "Last-N console.error/console.warn entries; ?since=<ms>&limit=<n>. `installed:false` when capture is off (no testHooks) \u2014 entries empty but schema-valid.",
+  getNetworkRequests: "Last-N fetch/XHR entries with status + duration; ?since=<ms>&limit=<n>. `installed:false` when capture is off (no testHooks) \u2014 entries empty but schema-valid.",
   pushModal: "TEST HOOK \u2014 push a modal onto the snapshot.modalStack via the registry ModalDetector",
   dismissModal: "TEST HOOK \u2014 dismiss a modal by id from the snapshot.modalStack via the registry ModalDetector",
   keepAwake: "TEST HOOK \u2014 keep the device screen awake via the injected keepAwakeProvider: body { enabled: boolean, durationMs?: number }"
@@ -5674,7 +5731,8 @@ function useUIElement(options) {
     parentPath,
     style,
     stateStyles: stateStylesProp,
-    handlers: handlersProp
+    handlers: handlersProp,
+    value: valueProp
   } = options;
   const treePath = parentPath ? `${parentPath}/${id}` : id;
   const bridgeProps = react.useMemo(
@@ -5700,9 +5758,12 @@ function useUIElement(options) {
     });
     registeredRef.current = true;
     registeredIdRef.current = id;
+    if (typeof valueProp === "string") {
+      bridge.registry.updateElementState(id, { value: valueProp });
+    }
     setRegistered(true);
     scheduleDeadButtonWarning(bridge, id, type);
-  }, [bridge, id, type, label, actions, customActions, treePath, style, stateStylesProp]);
+  }, [bridge, id, type, label, actions, customActions, treePath, style, stateStylesProp, valueProp]);
   const unregister = react.useCallback(() => {
     if (!bridge || !registeredRef.current) return;
     bridge.registry.unregisterElement(registeredIdRef.current ?? id);
@@ -5832,6 +5893,13 @@ function useUIElement(options) {
       }
     };
   }, [bridge, registered, id, handlersProp]);
+  react.useEffect(() => {
+    if (!bridge || !registered) return;
+    if (typeof valueProp !== "string") return;
+    const current = bridge.registry.getElement(id)?.getState().value;
+    if (current === valueProp) return;
+    bridge.registry.updateElementState(id, { value: valueProp });
+  }, [bridge, registered, id, valueProp]);
   react.useCallback(
     (props) => {
       propsRef.current = { ...propsRef.current, ...props };
@@ -6223,6 +6291,11 @@ var UI_BRIDGE_NATIVE_ROUTES = {
     path: "/ui-bridge/control/snapshot",
     description: "Get full bridge snapshot"
   },
+  DISCOVER: {
+    method: "GET",
+    path: "/ui-bridge/control/discover",
+    description: "Discover elements (alias for snapshot; web/runner parity)"
+  },
   PAGE_HEALTH: {
     method: "POST",
     path: "/ui-bridge/control/page-health",
@@ -6350,6 +6423,18 @@ var UI_BRIDGE_NATIVE_ROUTES = {
     path: "/ui-bridge/control/modal/dismiss/:id",
     description: "Dismiss a modal by id (testHooks)"
   },
+  // Observability — last-N ring buffers (always mounted; `installed:false`
+  // when the console/network patches are off, i.e. no testHooks).
+  CONSOLE_ERRORS: {
+    method: "GET",
+    path: "/ui-bridge/control/console-errors",
+    description: "Last-N captured console.error/console.warn entries"
+  },
+  NETWORK_REQUESTS: {
+    method: "GET",
+    path: "/ui-bridge/sdk/network-requests",
+    description: "Last-N captured fetch/XHR requests with status + duration"
+  },
   // Health
   HEALTH: {
     method: "GET",
@@ -6556,6 +6641,46 @@ function decodeTextPayload(payload) {
   return new TextDecoder().decode(payload);
 }
 
+// src/server/bind-retry.ts
+function isAddrInUseError(err) {
+  const message = err instanceof Error ? err.message : typeof err === "string" ? err : String(err);
+  const code = err?.code;
+  return message.includes("EADDRINUSE") || message.toLowerCase().includes("address already in use") || code === "EADDRINUSE";
+}
+var defaultSleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+async function bindWithRetry(attempt, options = {}) {
+  const {
+    minTotalMs = 3e4,
+    initialDelayMs = 500,
+    maxDelayMs = 5e3,
+    backoffFactor = 2,
+    logger = console,
+    sleep: sleep2 = defaultSleep,
+    now = Date.now
+  } = options;
+  const startedAt = now();
+  let delay = initialDelayMs;
+  let attemptIndex = 0;
+  for (; ; ) {
+    try {
+      await attempt(attemptIndex);
+      return;
+    } catch (err) {
+      const elapsed = now() - startedAt;
+      const budgetExhausted = elapsed + delay >= minTotalMs;
+      if (!isAddrInUseError(err) || budgetExhausted) {
+        throw err;
+      }
+      logger.warn(
+        `[ui-bridge-native] bind failed with EADDRINUSE (attempt ${attemptIndex + 1}); retrying in ${delay}ms (elapsed ${elapsed}ms / budget ${minTotalMs === Infinity ? "\u221E" : minTotalMs}ms)`
+      );
+      await sleep2(delay);
+      delay = Math.min(delay * backoffFactor, maxDelayMs);
+      attemptIndex += 1;
+    }
+  }
+}
+
 // src/server/ws-connection.ts
 var WebSocketConnection = class {
   constructor(id, socket, onMessage, onClose) {
@@ -7137,6 +7262,7 @@ exports.UI_BRIDGE_NATIVE_ROUTES = UI_BRIDGE_NATIVE_ROUTES;
 exports.UndoTracker = UndoTracker;
 exports.WebSocketConnection = WebSocketConnection;
 exports.WebSocketEventBridge = WebSocketEventBridge;
+exports.bindWithRetry = bindWithRetry;
 exports.buildTreePath = buildTreePath;
 exports.buildUpgradeResponse = buildUpgradeResponse;
 exports.captureNativeResponsiveSnapshot = captureNativeResponsiveSnapshot;
@@ -7152,6 +7278,7 @@ exports.findAllByPattern = findAllByPattern;
 exports.findElementByIdentifier = findElementByIdentifier;
 exports.getGlobalRegistry = getGlobalRegistry;
 exports.getNativeElementDesignData = getNativeElementDesignData;
+exports.isAddrInUseError = isAddrInUseError;
 exports.mapNativeStyleToExtended = mapNativeStyleToExtended;
 exports.matchesIdentifier = matchesIdentifier;
 exports.parseTreePath = parseTreePath;