@qontinui/ui-bridge-native 0.1.6 → 0.2.1

package/dist/index.d.mts

@@ -0,0 +1,89 @@
+export { A as ActionHandler, B as BridgeEvent, a as BridgeEventListener, b as BridgeEventType, C as ComponentAction, c as CustomAction, D as DiscoveredNativeElement, N as NativeActionRequest, d as NativeActionResponse, e as NativeBridgeSnapshot, f as NativeCapturedToast, g as NativeComponentAction, h as NativeCustomAction, i as NativeElementIdentifier, j as NativeElementRef, k as NativeElementState, l as NativeElementType, m as NativeFindRequest, n as NativeFindResponse, o as NativeLayout, p as NativeModalInfo, q as NativeRegistrationCoverage, r as NativeSnapshotEnricher, s as NativeSnapshotEnrichers, t as NativeSnapshotModalContext, u as NativeSnapshotToastContext, v as NativeSnapshotUndoContext, w as NativeStandardAction, x as NativeUIBridgeConfig, y as NativeUIBridgeFeatures, R as RegisteredNativeComponent, z as RegisteredNativeElement, W as WaitOptions, E as Workflow, F as WorkflowStep, G as WorkflowStepType } from './types-BwdPNpII.mjs';
+export { N as NativeRegistryConfig, a as NativeUIBridgeRegistry, R as RegisterComponentOptions, b as RegisterElementOptions, e as extractHandlerNames, g as getGlobalRegistry, r as resetGlobalRegistry, s as setGlobalRegistry } from './registry-KdUW_koV.mjs';
+export { buildTreePath, createNativeElementIdentifier, findAllByPattern, findElementByIdentifier, matchesIdentifier, parseTreePath } from './core/index.mjs';
+export { A as ActionRecord, C as CloudRelayClient, a as CloudRelayConfig, b as ComponentActionDef, c as ComponentActionRequest, d as ComponentActionResponse, D as DeclaredUndoState, M as ModalDetector, e as ModalPushInput, T as ToastCapture, f as ToastCaptureConfig, g as ToastRecordInput, h as ToastRecorderInput, U as UIBridgeNativeContextValue, i as UIBridgeNativeProvider, j as UIBridgeNativeProviderProps, k as UIBridgeProps, l as UndoTracker, m as UndoTrackerConfig, n as UseUIBridgeModalOptions, o as UseUIBridgeReturn, p as UseUIBridgeToastOptions, q as UseUIComponentOptions, r as UseUIComponentReturn, s as UseUIElementOptions, t as UseUIElementReturn, u as UseUIElementWithPropsReturn, v as useToastRecorder, w as useUIBridge, x as useUIBridgeModal, y as useUIBridgeNative, z as useUIBridgeNativeOptional, B as useUIBridgeNativeRequired, E as useUIBridgeRequired, F as useUIBridgeToast, G as useUIComponent, H as useUIComponentAction, I as useUIElement, J as useUIElementWithProps } from './useUIBridgeToast-BPIEbsEc.mjs';
+export { A as ActionExecutionOptions, C as ControlActionRequest, a as ControlActionResponse, b as ControlComponentActionRequest, c as ControlComponentActionResponse, N as NativeActionExecutor, P as PressActionParams, S as ScrollActionParams, d as SwipeActionParams, T as TypeActionParams, W as WaitResult } from './types-DjB0zJJH.mjs';
+export { DefaultNativeActionExecutor, createNativeActionExecutor } from './control/index.mjs';
+export { A as APIResponse, F as FillFormFieldInput, a as FillFormFieldResult, b as FillFormRequest, c as FillFormResponse, H as HTTPRequest, d as HTTPResponse, e as HandlerContext, f as HandlerFunction, J as JsonRpcBatchRequest, g as JsonRpcBatchResponse, h as JsonRpcEvent, i as JsonRpcRequest, j as JsonRpcResponse, N as NativeServerConfig, k as NativeServerHandlers, l as NativeUIBridgeServer, m as NavigationProvider, R as RequestHandler, n as RouteDefinition, o as RouteProvider, S as ScreenshotProvider, p as ServerAdapter, U as UI_BRIDGE_NATIVE_ROUTES, W as WebSocketConnection, q as WebSocketEventBridge, r as WebSocketMessageHandler, s as WebSocketServerAdapter, t as createNativeServer } from './http-server-D2U1k48d.mjs';
+export { NativeDesignHandlers, buildUpgradeResponse, computeAcceptKey, createDesignHandlers, createServerHandlers } from './server/index.mjs';
+export { E as ElementDesignData, a as ExtendedComputedStyles, F as FlattenedNativeStyle, N as NativeInteractionStateName, b as NativeStateStyles, P as PseudoElementStyles, R as ResponsiveSnapshot, S as StateStyles, c as StyleDiff } from './design-types-BHr6Q1FX.mjs';
+export { captureNativeResponsiveSnapshot, captureNativeStateVariations, getNativeElementDesignData, mapNativeStyleToExtended } from './design/index.mjs';
+export { UIBridgeInspector, UIBridgeInspectorProps } from './debug/index.mjs';
+import 'react/jsx-runtime';
+import 'react';
+
+/**
+ * Device Announcer — mDNS + Cloud registration for physical device discovery
+ *
+ * Announces the UI Bridge service on the local network via mDNS (when
+ * react-native-zeroconf is available) and optionally registers with the
+ * cloud relay backend.
+ */
+interface AnnouncerConfig {
+    /** Stable device identifier */
+    deviceId: string;
+    /** App bundle/package ID */
+    appId: string;
+    /** UI Bridge server port (default 8087) */
+    port?: number;
+    /** Cloud relay WebSocket URL for registration */
+    cloudRelayUrl?: string;
+    /** Auth token for cloud relay */
+    cloudToken?: string;
+    /** UI Bridge SDK version */
+    version?: string;
+}
+interface DeviceAnnouncerState {
+    mdnsActive: boolean;
+    cloudConnected: boolean;
+}
+/** Minimal interface for the react-native-zeroconf Zeroconf instance */
+interface ZeroconfService {
+    publishService(type: string, protocol: string, domain: string, name: string, port: number, txtRecord: Record<string, string>): void;
+    unpublishService(name: string): void;
+}
+/**
+ * Announces the UI Bridge server on the local network (mDNS) and optionally
+ * registers with the qontinui.io cloud relay for remote discovery.
+ */
+declare class DeviceAnnouncer {
+    private config;
+    private state;
+    private cloudWs;
+    private reconnectTimer;
+    private reconnectDelay;
+    private stopped;
+    /** Zeroconf instance, set when mDNS is successfully started */
+    private zeroconf;
+    /** Rotated pairing token for mDNS TXT records */
+    private pairingToken;
+    constructor(config: AnnouncerConfig);
+    /**
+     * Start mDNS advertisement.
+     *
+     * The consumer must pass the `Zeroconf` constructor (from `react-native-zeroconf`)
+     * explicitly; otherwise this is a no-op.
+     *
+     * Rationale: Metro's `require()` throws an uncatchable module-load error if the
+     * bundle doesn't include the named package. That error escapes async try/catch
+     * boundaries and crashes the app. We avoid it by never calling `require()`
+     * ourselves — the consumer imports the package when they know it's installed.
+     *
+     * @param ZeroconfCtor - constructor from `import Zeroconf from 'react-native-zeroconf'`
+     */
+    startMdnsAdvertise(ZeroconfCtor?: new () => ZeroconfService): Promise<void>;
+    /**
+     * Connect to the cloud relay WebSocket and send a device_register message.
+     *
+     * Reconnects automatically with exponential backoff (2 s → 60 s) if the
+     * connection drops.
+     */
+    connectCloudRelay(): Promise<void>;
+    /** Stop all advertising and registration. */
+    stop(): Promise<void>;
+    /** Return a copy of the current announcer state. */
+    getState(): DeviceAnnouncerState;
+    private scheduleReconnect;
+}
+
+export { type AnnouncerConfig, DeviceAnnouncer, type DeviceAnnouncerState };

package/dist/index.d.ts

@@ -1,31 +1,89 @@
+export { A as ActionHandler, B as BridgeEvent, a as BridgeEventListener, b as BridgeEventType, C as ComponentAction, c as CustomAction, D as DiscoveredNativeElement, N as NativeActionRequest, d as NativeActionResponse, e as NativeBridgeSnapshot, f as NativeCapturedToast, g as NativeComponentAction, h as NativeCustomAction, i as NativeElementIdentifier, j as NativeElementRef, k as NativeElementState, l as NativeElementType, m as NativeFindRequest, n as NativeFindResponse, o as NativeLayout, p as NativeModalInfo, q as NativeRegistrationCoverage, r as NativeSnapshotEnricher, s as NativeSnapshotEnrichers, t as NativeSnapshotModalContext, u as NativeSnapshotToastContext, v as NativeSnapshotUndoContext, w as NativeStandardAction, x as NativeUIBridgeConfig, y as NativeUIBridgeFeatures, R as RegisteredNativeComponent, z as RegisteredNativeElement, W as WaitOptions, E as Workflow, F as WorkflowStep, G as WorkflowStepType } from './types-BwdPNpII.js';
+export { N as NativeRegistryConfig, a as NativeUIBridgeRegistry, R as RegisterComponentOptions, b as RegisterElementOptions, e as extractHandlerNames, g as getGlobalRegistry, r as resetGlobalRegistry, s as setGlobalRegistry } from './registry-BxXaxmsT.js';
+export { buildTreePath, createNativeElementIdentifier, findAllByPattern, findElementByIdentifier, matchesIdentifier, parseTreePath } from './core/index.js';
+export { A as ActionRecord, C as CloudRelayClient, a as CloudRelayConfig, b as ComponentActionDef, c as ComponentActionRequest, d as ComponentActionResponse, D as DeclaredUndoState, M as ModalDetector, e as ModalPushInput, T as ToastCapture, f as ToastCaptureConfig, g as ToastRecordInput, h as ToastRecorderInput, U as UIBridgeNativeContextValue, i as UIBridgeNativeProvider, j as UIBridgeNativeProviderProps, k as UIBridgeProps, l as UndoTracker, m as UndoTrackerConfig, n as UseUIBridgeModalOptions, o as UseUIBridgeReturn, p as UseUIBridgeToastOptions, q as UseUIComponentOptions, r as UseUIComponentReturn, s as UseUIElementOptions, t as UseUIElementReturn, u as UseUIElementWithPropsReturn, v as useToastRecorder, w as useUIBridge, x as useUIBridgeModal, y as useUIBridgeNative, z as useUIBridgeNativeOptional, B as useUIBridgeNativeRequired, E as useUIBridgeRequired, F as useUIBridgeToast, G as useUIComponent, H as useUIComponentAction, I as useUIElement, J as useUIElementWithProps } from './useUIBridgeToast-DD13oF3k.js';
+export { A as ActionExecutionOptions, C as ControlActionRequest, a as ControlActionResponse, b as ControlComponentActionRequest, c as ControlComponentActionResponse, N as NativeActionExecutor, P as PressActionParams, S as ScrollActionParams, d as SwipeActionParams, T as TypeActionParams, W as WaitResult } from './types-DCEv5qb6.js';
+export { DefaultNativeActionExecutor, createNativeActionExecutor } from './control/index.js';
+export { A as APIResponse, F as FillFormFieldInput, a as FillFormFieldResult, b as FillFormRequest, c as FillFormResponse, H as HTTPRequest, d as HTTPResponse, e as HandlerContext, f as HandlerFunction, J as JsonRpcBatchRequest, g as JsonRpcBatchResponse, h as JsonRpcEvent, i as JsonRpcRequest, j as JsonRpcResponse, N as NativeServerConfig, k as NativeServerHandlers, l as NativeUIBridgeServer, m as NavigationProvider, R as RequestHandler, n as RouteDefinition, o as RouteProvider, S as ScreenshotProvider, p as ServerAdapter, U as UI_BRIDGE_NATIVE_ROUTES, W as WebSocketConnection, q as WebSocketEventBridge, r as WebSocketMessageHandler, s as WebSocketServerAdapter, t as createNativeServer } from './http-server-ck8clUsZ.js';
+export { NativeDesignHandlers, buildUpgradeResponse, computeAcceptKey, createDesignHandlers, createServerHandlers } from './server/index.js';
+export { E as ElementDesignData, a as ExtendedComputedStyles, F as FlattenedNativeStyle, N as NativeInteractionStateName, b as NativeStateStyles, P as PseudoElementStyles, R as ResponsiveSnapshot, S as StateStyles, c as StyleDiff } from './design-types-BHr6Q1FX.js';
+export { captureNativeResponsiveSnapshot, captureNativeStateVariations, getNativeElementDesignData, mapNativeStyleToExtended } from './design/index.js';
+export { UIBridgeInspector, UIBridgeInspectorProps } from './debug/index.js';
+import 'react/jsx-runtime';
+import 'react';
+
 /**
- * UI Bridge Native
+ * Device Announcer — mDNS + Cloud registration for physical device discovery
  *
- * UI Bridge framework for React Native applications.
- * Enables AI-driven UI automation and testing for mobile apps.
- *
- * @packageDocumentation
+ * Announces the UI Bridge service on the local network via mDNS (when
+ * react-native-zeroconf is available) and optionally registers with the
+ * cloud relay backend.
+ */
+interface AnnouncerConfig {
+    /** Stable device identifier */
+    deviceId: string;
+    /** App bundle/package ID */
+    appId: string;
+    /** UI Bridge server port (default 8087) */
+    port?: number;
+    /** Cloud relay WebSocket URL for registration */
+    cloudRelayUrl?: string;
+    /** Auth token for cloud relay */
+    cloudToken?: string;
+    /** UI Bridge SDK version */
+    version?: string;
+}
+interface DeviceAnnouncerState {
+    mdnsActive: boolean;
+    cloudConnected: boolean;
+}
+/** Minimal interface for the react-native-zeroconf Zeroconf instance */
+interface ZeroconfService {
+    publishService(type: string, protocol: string, domain: string, name: string, port: number, txtRecord: Record<string, string>): void;
+    unpublishService(name: string): void;
+}
+/**
+ * Announces the UI Bridge server on the local network (mDNS) and optionally
+ * registers with the qontinui.io cloud relay for remote discovery.
  */
-export { type NativeElementIdentifier, type NativeElementState, type NativeLayout, type NativeElementType, type NativeStandardAction, type NativeCustomAction, type RegisteredNativeElement, type RegisteredNativeComponent, type NativeComponentAction, type NativeActionRequest, type NativeActionResponse, type NativeBridgeSnapshot, type NativeUIBridgeFeatures, type NativeUIBridgeConfig, type NativeFindRequest, type NativeFindResponse, type DiscoveredNativeElement, type NativeElementRef, type Workflow, type WorkflowStep, type WorkflowStepType, type WaitOptions, type BridgeEvent, type BridgeEventType, type BridgeEventListener, type ActionHandler, type CustomAction, type ComponentAction, } from './core/types';
-export { NativeUIBridgeRegistry, extractHandlerNames, setGlobalRegistry, getGlobalRegistry, resetGlobalRegistry, type RegisterElementOptions, type RegisterComponentOptions, type NativeRegistryConfig, } from './core/registry';
-export { createNativeElementIdentifier, findElementByIdentifier, findAllByPattern, buildTreePath, parseTreePath, matchesIdentifier, } from './core/element-identifier';
-export { UIBridgeNativeProvider, useUIBridgeNative, useUIBridgeNativeOptional, useUIBridgeNativeRequired, type UIBridgeNativeContextValue, type UIBridgeNativeProviderProps, } from './react/UIBridgeNativeProvider';
-export { useUIElement, useUIElementWithProps, type UseUIElementOptions, type UseUIElementReturn, type UseUIElementWithPropsReturn, type UIBridgeProps, } from './react/useUIElement';
-export { useUIComponent, useUIComponentAction, type ComponentActionDef, type UseUIComponentOptions, type UseUIComponentReturn, } from './react/useUIComponent';
-export { useUIBridge, useUIBridgeRequired, type UseUIBridgeReturn, type ComponentActionRequest, type ComponentActionResponse, } from './react/useUIBridge';
-export { type ControlActionRequest, type ControlActionResponse, type ComponentActionRequest as ControlComponentActionRequest, type ComponentActionResponse as ControlComponentActionResponse, type WaitResult, type NativeActionExecutor, type ActionExecutionOptions, type TypeActionParams, type ScrollActionParams, type SwipeActionParams, type PressActionParams, } from './control/types';
-export { DefaultNativeActionExecutor, createNativeActionExecutor } from './control/action-executor';
-export { type NativeServerConfig, type RouteDefinition, type APIResponse, type HandlerContext, type HandlerFunction, type NativeServerHandlers, type NavigationProvider, type ScreenshotProvider, type RouteProvider, UI_BRIDGE_NATIVE_ROUTES, } from './server/types';
-export { createServerHandlers } from './server/handlers';
-export { NativeUIBridgeServer, createNativeServer, type HTTPRequest, type HTTPResponse, type RequestHandler, type ServerAdapter, type WebSocketServerAdapter, } from './server/http-server';
-export { buildUpgradeResponse, computeAcceptKey } from './server/ws-protocol';
-export { WebSocketConnection } from './server/ws-connection';
-export type { WebSocketMessageHandler } from './server/ws-connection';
-export { WebSocketEventBridge } from './server/ws-event-bridge';
-export type { JsonRpcRequest, JsonRpcResponse, JsonRpcEvent, JsonRpcBatchRequest, JsonRpcBatchResponse, } from './server/ws-types';
-export { type ExtendedComputedStyles, type StyleDiff, type StateStyles, type ElementDesignData, type PseudoElementStyles, type ResponsiveSnapshot, type FlattenedNativeStyle, type NativeStateStyles, type NativeInteractionStateName, } from './design/design-types';
-export { mapNativeStyleToExtended, getNativeElementDesignData, captureNativeStateVariations, captureNativeResponsiveSnapshot, } from './design/design-inspector-native';
-export { createDesignHandlers, type NativeDesignHandlers } from './server/design-handlers';
-export { UIBridgeInspector, type UIBridgeInspectorProps } from './debug/inspector';
-export * from './transport';
-//# sourceMappingURL=index.d.ts.map
+declare class DeviceAnnouncer {
+    private config;
+    private state;
+    private cloudWs;
+    private reconnectTimer;
+    private reconnectDelay;
+    private stopped;
+    /** Zeroconf instance, set when mDNS is successfully started */
+    private zeroconf;
+    /** Rotated pairing token for mDNS TXT records */
+    private pairingToken;
+    constructor(config: AnnouncerConfig);
+    /**
+     * Start mDNS advertisement.
+     *
+     * The consumer must pass the `Zeroconf` constructor (from `react-native-zeroconf`)
+     * explicitly; otherwise this is a no-op.
+     *
+     * Rationale: Metro's `require()` throws an uncatchable module-load error if the
+     * bundle doesn't include the named package. That error escapes async try/catch
+     * boundaries and crashes the app. We avoid it by never calling `require()`
+     * ourselves — the consumer imports the package when they know it's installed.
+     *
+     * @param ZeroconfCtor - constructor from `import Zeroconf from 'react-native-zeroconf'`
+     */
+    startMdnsAdvertise(ZeroconfCtor?: new () => ZeroconfService): Promise<void>;
+    /**
+     * Connect to the cloud relay WebSocket and send a device_register message.
+     *
+     * Reconnects automatically with exponential backoff (2 s → 60 s) if the
+     * connection drops.
+     */
+    connectCloudRelay(): Promise<void>;
+    /** Stop all advertising and registration. */
+    stop(): Promise<void>;
+    /** Return a copy of the current announcer state. */
+    getState(): DeviceAnnouncerState;
+    private scheduleReconnect;
+}
+
+export { type AnnouncerConfig, DeviceAnnouncer, type DeviceAnnouncerState };