@qontinui/ui-bridge-native 0.3.1 → 0.4.0

package/dist/toast/index.d.ts

@@ -0,0 +1,2 @@
+export { ToastCapture } from './toast-capture';
+//# sourceMappingURL=index.d.ts.map

package/dist/toast/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/toast/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/toast/toast-capture.d.ts

@@ -0,0 +1,27 @@
+import type { NativeCapturedToast, NativeSnapshotToastContext } from '../core/types';
+export interface ToastRecordInput {
+    id: string;
+    message: string;
+    level?: NativeCapturedToast['level'];
+    appearedAt?: number;
+}
+export interface ToastCaptureConfig {
+    maxRecent?: number;
+}
+/**
+ * Declarative toast/snackbar tracker. Components call recordToast/dismissToast
+ * directly — there is no DOM/tree scanner. The active map plus a fixed-size
+ * recent ring buffer feed the snapshot's toasts context.
+ */
+export declare class ToastCapture {
+    private active;
+    private recent;
+    private totalCaptured;
+    private maxRecent;
+    constructor(config?: ToastCaptureConfig);
+    recordToast(toast: ToastRecordInput): void;
+    dismissToast(id: string): void;
+    getSnapshotToastContext(): NativeSnapshotToastContext;
+    clear(): void;
+}
+//# sourceMappingURL=toast-capture.d.ts.map

package/dist/toast/toast-capture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toast-capture.d.ts","sourceRoot":"","sources":["../../src/toast/toast-capture.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,0BAA0B,EAAE,MAAM,eAAe,CAAC;AAErF,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,mBAAmB,CAAC,OAAO,CAAC,CAAC;IACrC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAID;;;;GAIG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAA0C;IACxD,OAAO,CAAC,MAAM,CAA6B;IAC3C,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,SAAS,CAAS;gBAEd,MAAM,GAAE,kBAAuB;IAI3C,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,IAAI;IAiB1C,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAmB9B,uBAAuB,IAAI,0BAA0B;IAarD,KAAK,IAAI,IAAI;CAKd"}

package/dist/transport/CloudRelayClient.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Cloud Relay Client — WebSocket tunnel from mobile device to backend
+ *
+ * Maintains a persistent WebSocket connection to the qontinui.io backend.
+ * Receives tunneled HTTP requests from runners, calls the local NativeUIBridgeServer,
+ * and sends responses back through the tunnel.
+ */
+import type { NativeUIBridgeServer } from '../server/http-server';
+export interface CloudRelayConfig {
+    /** WebSocket URL for the device bridge endpoint */
+    relayUrl: string;
+    /** Stable device identifier */
+    deviceId: string;
+    /** Authentication token */
+    authToken: string;
+    /** Reference to the local UI Bridge server for processing requests */
+    uiBridgeServer: NativeUIBridgeServer;
+}
+/**
+ * Manages a WebSocket tunnel from the mobile device to the qontinui.io backend.
+ *
+ * When a runner sends an HTTP request to a cloud device it is serialised as a
+ * `TunnelRequest` JSON frame by the backend and forwarded here. This client
+ * deserializes it, calls `NativeUIBridgeServer.handleRequest()` directly
+ * (avoiding loopback TCP overhead), and sends the `TunnelResponse` back.
+ */
+export declare class CloudRelayClient {
+    private ws;
+    private config;
+    private reconnectDelay;
+    private maxReconnectDelay;
+    private stopped;
+    private _isConnected;
+    private reconnectTimer;
+    constructor(config: CloudRelayConfig);
+    /** Whether the relay WebSocket is currently connected */
+    get isConnected(): boolean;
+    /** Connect to the relay and start processing tunneled requests. */
+    start(): void;
+    /** Disconnect and stop reconnecting. */
+    stop(): void;
+    private connect;
+    private onMessage;
+    /**
+     * Process a tunneled HTTP request by calling the local NativeUIBridgeServer
+     * directly (no loopback TCP involved).
+     */
+    private handleTunneledRequest;
+    private scheduleReconnect;
+}
+//# sourceMappingURL=CloudRelayClient.d.ts.map

package/dist/transport/CloudRelayClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CloudRelayClient.d.ts","sourceRoot":"","sources":["../../src/transport/CloudRelayClient.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAGlE,MAAM,WAAW,gBAAgB;IAC/B,mDAAmD;IACnD,QAAQ,EAAE,MAAM,CAAC;IACjB,+BAA+B;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,2BAA2B;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,sEAAsE;IACtE,cAAc,EAAE,oBAAoB,CAAC;CACtC;AAoBD;;;;;;;GAOG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,EAAE,CAA0B;IACpC,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,cAAc,CAA8B;IACpD,OAAO,CAAC,iBAAiB,CAA0B;IACnD,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,cAAc,CAA8C;gBAExD,MAAM,EAAE,gBAAgB;IAIpC,yDAAyD;IACzD,IAAI,WAAW,IAAI,OAAO,CAEzB;IAID,mEAAmE;IACnE,KAAK,IAAI,IAAI;IAKb,wCAAwC;IACxC,IAAI,IAAI,IAAI;IAkBZ,OAAO,CAAC,OAAO;YA8CD,SAAS;IAsCvB;;;OAGG;YACW,qBAAqB;IAuCnC,OAAO,CAAC,iBAAiB;CAY1B"}

package/dist/transport/DeviceAnnouncer.d.ts

@@ -0,0 +1,75 @@
+/**
+ * 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.
+ */
+export 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;
+}
+export 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 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 {};
+//# sourceMappingURL=DeviceAnnouncer.d.ts.map

package/dist/transport/DeviceAnnouncer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DeviceAnnouncer.d.ts","sourceRoot":"","sources":["../../src/transport/DeviceAnnouncer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,MAAM,WAAW,eAAe;IAC9B,+BAA+B;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,4BAA4B;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,2CAA2C;IAC3C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iDAAiD;IACjD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iCAAiC;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4BAA4B;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,OAAO,CAAC;IACpB,cAAc,EAAE,OAAO,CAAC;CACzB;AAED,wEAAwE;AACxE,UAAU,eAAe;IACvB,cAAc,CACZ,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAChC,IAAI,CAAC;IACR,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACtC;AAYD;;;GAGG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAA0E;IACxF,OAAO,CAAC,KAAK,CAGX;IACF,OAAO,CAAC,OAAO,CAA0B;IACzC,OAAO,CAAC,cAAc,CAA8C;IACpE,OAAO,CAAC,cAAc,CAA8B;IACpD,OAAO,CAAC,OAAO,CAAS;IACxB,+DAA+D;IAC/D,OAAO,CAAC,QAAQ,CAAgC;IAChD,iDAAiD;IACjD,OAAO,CAAC,YAAY,CAAS;gBAEjB,MAAM,EAAE,eAAe;IAOnC;;;;;;;;;;;;OAYG;IACG,kBAAkB,CAAC,YAAY,CAAC,EAAE,UAAU,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IA8BjF;;;;;OAKG;IACG,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC;IA4DxC,6CAA6C;IACvC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IA8B3B,oDAAoD;IACpD,QAAQ,IAAI,oBAAoB;IAMhC,OAAO,CAAC,iBAAiB;CAa1B"}

package/dist/transport/index.d.ts

@@ -0,0 +1,3 @@
+export { DeviceAnnouncer, type AnnouncerConfig, type DeviceAnnouncerState, } from './DeviceAnnouncer';
+export { CloudRelayClient, type CloudRelayConfig } from './CloudRelayClient';
+//# sourceMappingURL=index.d.ts.map

package/dist/transport/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/transport/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,KAAK,eAAe,EACpB,KAAK,oBAAoB,GAC1B,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,gBAAgB,EAAE,KAAK,gBAAgB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/transport/logger.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Minimal logger for the UI Bridge Native transport layer.
+ *
+ * Wraps console so callers go through a single controlled point. Log output
+ * can be suppressed globally by setting:
+ *
+ *   import { transportLogger } from './logger';
+ *   transportLogger.silent = true;
+ *
+ * In production builds you can also tree-shake the verbose log() calls by
+ * checking `__DEV__` in your Metro bundler config, but the silent flag is
+ * simpler and works without build-time configuration.
+ */
+export interface TransportLogger {
+    log(message: string, ...args: unknown[]): void;
+    warn(message: string, ...args: unknown[]): void;
+    error(message: string, ...args: unknown[]): void;
+    /** Set to true to suppress all log output (warn/error are always emitted). */
+    silent: boolean;
+}
+/** Shared logger instance for the transport layer. */
+export declare const transportLogger: TransportLogger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/transport/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/transport/logger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,MAAM,WAAW,eAAe;IAC9B,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAC/C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAChD,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IACjD,8EAA8E;IAC9E,MAAM,EAAE,OAAO,CAAC;CACjB;AAmBD,sDAAsD;AACtD,eAAO,MAAM,eAAe,iBAA0B,CAAC"}

package/dist/undo/index.d.ts

@@ -0,0 +1,3 @@
+export { UndoTracker } from './undo-tracker';
+export type { ActionRecord, DeclaredUndoState, UndoTrackerConfig } from './undo-tracker';
+//# sourceMappingURL=index.d.ts.map

package/dist/undo/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/undo/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,YAAY,EAAE,YAAY,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/undo/undo-tracker.d.ts

@@ -0,0 +1,59 @@
+import type { NativeSnapshotUndoContext } from '../core/types';
+/**
+ * A single bridge action recorded for undo correlation. Action-correlation
+ * only — RN has no DOM/execCommand probe, so we rely on developer
+ * declaration plus this rolling history of recent actions.
+ */
+export interface ActionRecord {
+    id: string;
+    type: string;
+    targetId?: string;
+    description?: string;
+    timestamp: number;
+    /** Default true — set false for actions that aren't reversible (e.g. navigation, network calls) */
+    reversible?: boolean;
+}
+/**
+ * Developer-declared undo/redo state. When set, this is authoritative and
+ * overrides any heuristic inference from action history.
+ */
+export interface DeclaredUndoState {
+    canUndo: boolean;
+    canRedo: boolean;
+    undoDescription?: string;
+    redoDescription?: string;
+    undoDepth?: number;
+    redoDepth?: number;
+}
+export interface UndoTrackerConfig {
+    maxHistory?: number;
+}
+/**
+ * Action-correlation undo tracker for React Native.
+ *
+ * Maintains a rolling buffer of recent actions and a developer-declared
+ * undo state slot. The declared state is authoritative when set; otherwise
+ * we infer `canUndo` from whether any reversible action has been recorded.
+ * `executeUndo`/`executeRedo` are placeholders pending an IPC path through
+ * ui-bridge-native to the runner's `/control/undo`.
+ */
+export declare class UndoTracker {
+    private readonly maxHistory;
+    private actions;
+    private declaredState;
+    constructor(config?: UndoTrackerConfig);
+    recordAction(record: ActionRecord): void;
+    setDeclaredState(state: DeclaredUndoState): void;
+    getActionHistory(): ActionRecord[];
+    getSnapshotUndoContext(): NativeSnapshotUndoContext;
+    executeUndo(): {
+        ok: boolean;
+        reason?: string;
+    };
+    executeRedo(): {
+        ok: boolean;
+        reason?: string;
+    };
+    clear(): void;
+}
+//# sourceMappingURL=undo-tracker.d.ts.map

package/dist/undo/undo-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"undo-tracker.d.ts","sourceRoot":"","sources":["../../src/undo/undo-tracker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,eAAe,CAAC;AAE/D;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,mGAAmG;IACnG,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAuBD;;;;;;;;GAQG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,OAAO,CAAsB;IACrC,OAAO,CAAC,aAAa,CAAkC;gBAE3C,MAAM,GAAE,iBAAsB;IAI1C,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI;IAOxC,gBAAgB,CAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI;IAIhD,gBAAgB,IAAI,YAAY,EAAE;IAIlC,sBAAsB,IAAI,yBAAyB;IAkCnD,WAAW,IAAI;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE;IAI/C,WAAW,IAAI;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE;IAI/C,KAAK,IAAI,IAAI;CAId"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qontinui/ui-bridge-native",
-  "version": "0.3.1",
+  "version": "0.4.0",
   "description": "UI Bridge Framework for React Native - Hooks and providers for UI observation and control in mobile apps",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -47,7 +47,7 @@
     "README.md"
   ],
   "scripts": {
-    "build": "tsup",
+    "build": "tsup && tsc -p tsconfig.build.json",
     "dev": "tsup --watch",
     "test": "vitest run",
     "typecheck": "tsc --noEmit",
@@ -55,7 +55,7 @@
     "format": "prettier --write \"src/**/*.{ts,tsx}\""
   },
   "peerDependencies": {
-    "@qontinui/ui-bridge": ">=0.3.0",
+    "@qontinui/ui-bridge": ">=0.4.0",
     "react": "^18.0.0 || ^19.0.0",
     "react-native": ">=0.70.0"
   },