@qontinui/ui-bridge-native 0.3.0 → 0.3.1

package/dist/{types-DjB0zJJH.d.mts → types-B0XA4vOF.d.mts}

@@ -1,4 +1,4 @@
-import { W as WaitOptions, N as NativeActionRequest, d as NativeActionResponse, m as NativeFindRequest, n as NativeFindResponse, k as NativeElementState } from './types-BwdPNpII.mjs';
+import { W as WaitOptions, N as NativeActionRequest, d as NativeActionResponse, m as NativeFindRequest, n as NativeFindResponse, k as NativeElementState } from './types-CGVut7mc.mjs';
 
 /**
  * UI Bridge Native Control Types

package/dist/{types-BwdPNpII.d.mts → types-CGVut7mc.d.mts}

@@ -285,6 +285,18 @@ interface NativeRegistrationCoverage {
     everHadRegistrations: boolean;
     byRoute: Record<string, number>;
 }
+/**
+ * Application info reported alongside snapshots/health responses.
+ *
+ * Re-export of the `appInfo` shape used in `NativeUIBridgeConfig` so
+ * snapshot consumers can type-narrow without importing the config.
+ */
+interface NativeAppInfo {
+    appId: string;
+    appName: string;
+    appType: 'web' | 'desktop' | 'mobile' | 'other';
+    framework?: string;
+}
 /**
  * Snapshot of the entire native UI bridge state
  */
@@ -335,6 +347,18 @@ interface NativeBridgeSnapshot {
      * interactive controls but did not register them with the bridge.
      */
     registration?: NativeRegistrationCoverage;
+    /**
+     * Application info — appId, appName, appType, framework.
+     *
+     * Populated when the host wired `config.appInfo` on the server (e.g. via
+     * `UIBridgeNativeProvider`'s `config.appInfo` prop). Mirrors the `uiBridge`
+     * block returned by the `health` endpoint so agents can identify the app
+     * from a snapshot alone — useful for the cloud relay path where the
+     * bridge URL is opaque.
+     *
+     * Empty (undefined) when the host did not configure appInfo.
+     */
+    appInfo?: NativeAppInfo;
 }
 /** A single detected modal-like surface (modal, sheet, drawer, popover, alert) */
 interface NativeModalInfo {
@@ -441,6 +465,24 @@ type NativeSnapshotEnricher = (ctx: {
     elements: RegisteredNativeElement[];
     currentRoute: string | null;
 }) => Record<string, unknown>;
+/**
+ * Minimal route-provider shape consumed by `NativeUIBridgeRegistry.createSnapshot`.
+ *
+ * Intentionally a structural subset of `RouteProvider` (defined in `server/types`)
+ * so `core/registry` stays free of server-layer imports. The full `RouteProvider`
+ * (which adds `subscribe`) widens this interface; both can be passed to
+ * `registry.setRouteProvider(...)` interchangeably.
+ *
+ * The registry uses this fallback when `createSnapshot` is called WITHOUT an
+ * explicit `routeInfo` argument — the canonical case is the default
+ * `getSnapshot` HTTP handler, which has no direct reference to the
+ * `NativeUIBridgeServer` instance and therefore couldn't read the route
+ * before this hook existed.
+ */
+interface NativeRouteProviderLike {
+    getCurrentRoute: () => string | null;
+    getSegments?: () => string[];
+}
 /**
  * UI Bridge Native feature flags
  */
@@ -522,4 +564,4 @@ interface NativeFindResponse {
     timestamp: number;
 }
 
-export type { ActionHandler as A, BridgeEvent as B, ComponentAction as C, DiscoveredNativeElement as D, Workflow as E, WorkflowStep as F, WorkflowStepType as G, NativeModalDetectorLike as H, NativeActionRequest as N, RegisteredNativeComponent as R, WaitOptions as W, BridgeEventListener as a, BridgeEventType as b, CustomAction as c, NativeActionResponse as d, NativeBridgeSnapshot as e, NativeCapturedToast as f, NativeComponentAction as g, NativeCustomAction as h, NativeElementIdentifier as i, NativeElementRef as j, NativeElementState as k, NativeElementType as l, NativeFindRequest as m, NativeFindResponse as n, NativeLayout as o, NativeModalInfo as p, NativeRegistrationCoverage as q, NativeSnapshotEnricher as r, NativeSnapshotEnrichers as s, NativeSnapshotModalContext as t, NativeSnapshotToastContext as u, NativeSnapshotUndoContext as v, NativeStandardAction as w, NativeUIBridgeConfig as x, NativeUIBridgeFeatures as y, RegisteredNativeElement as z };
+export type { ActionHandler as A, BridgeEvent as B, ComponentAction as C, DiscoveredNativeElement as D, Workflow as E, WorkflowStep as F, WorkflowStepType as G, NativeAppInfo as H, NativeRouteProviderLike as I, NativeModalDetectorLike as J, NativeActionRequest as N, RegisteredNativeComponent as R, WaitOptions as W, BridgeEventListener as a, BridgeEventType as b, CustomAction as c, NativeActionResponse as d, NativeBridgeSnapshot as e, NativeCapturedToast as f, NativeComponentAction as g, NativeCustomAction as h, NativeElementIdentifier as i, NativeElementRef as j, NativeElementState as k, NativeElementType as l, NativeFindRequest as m, NativeFindResponse as n, NativeLayout as o, NativeModalInfo as p, NativeRegistrationCoverage as q, NativeSnapshotEnricher as r, NativeSnapshotEnrichers as s, NativeSnapshotModalContext as t, NativeSnapshotToastContext as u, NativeSnapshotUndoContext as v, NativeStandardAction as w, NativeUIBridgeConfig as x, NativeUIBridgeFeatures as y, RegisteredNativeElement as z };

package/dist/{types-BwdPNpII.d.ts → types-CGVut7mc.d.ts}

@@ -285,6 +285,18 @@ interface NativeRegistrationCoverage {
     everHadRegistrations: boolean;
     byRoute: Record<string, number>;
 }
+/**
+ * Application info reported alongside snapshots/health responses.
+ *
+ * Re-export of the `appInfo` shape used in `NativeUIBridgeConfig` so
+ * snapshot consumers can type-narrow without importing the config.
+ */
+interface NativeAppInfo {
+    appId: string;
+    appName: string;
+    appType: 'web' | 'desktop' | 'mobile' | 'other';
+    framework?: string;
+}
 /**
  * Snapshot of the entire native UI bridge state
  */
@@ -335,6 +347,18 @@ interface NativeBridgeSnapshot {
      * interactive controls but did not register them with the bridge.
      */
     registration?: NativeRegistrationCoverage;
+    /**
+     * Application info — appId, appName, appType, framework.
+     *
+     * Populated when the host wired `config.appInfo` on the server (e.g. via
+     * `UIBridgeNativeProvider`'s `config.appInfo` prop). Mirrors the `uiBridge`
+     * block returned by the `health` endpoint so agents can identify the app
+     * from a snapshot alone — useful for the cloud relay path where the
+     * bridge URL is opaque.
+     *
+     * Empty (undefined) when the host did not configure appInfo.
+     */
+    appInfo?: NativeAppInfo;
 }
 /** A single detected modal-like surface (modal, sheet, drawer, popover, alert) */
 interface NativeModalInfo {
@@ -441,6 +465,24 @@ type NativeSnapshotEnricher = (ctx: {
     elements: RegisteredNativeElement[];
     currentRoute: string | null;
 }) => Record<string, unknown>;
+/**
+ * Minimal route-provider shape consumed by `NativeUIBridgeRegistry.createSnapshot`.
+ *
+ * Intentionally a structural subset of `RouteProvider` (defined in `server/types`)
+ * so `core/registry` stays free of server-layer imports. The full `RouteProvider`
+ * (which adds `subscribe`) widens this interface; both can be passed to
+ * `registry.setRouteProvider(...)` interchangeably.
+ *
+ * The registry uses this fallback when `createSnapshot` is called WITHOUT an
+ * explicit `routeInfo` argument — the canonical case is the default
+ * `getSnapshot` HTTP handler, which has no direct reference to the
+ * `NativeUIBridgeServer` instance and therefore couldn't read the route
+ * before this hook existed.
+ */
+interface NativeRouteProviderLike {
+    getCurrentRoute: () => string | null;
+    getSegments?: () => string[];
+}
 /**
  * UI Bridge Native feature flags
  */
@@ -522,4 +564,4 @@ interface NativeFindResponse {
     timestamp: number;
 }
 
-export type { ActionHandler as A, BridgeEvent as B, ComponentAction as C, DiscoveredNativeElement as D, Workflow as E, WorkflowStep as F, WorkflowStepType as G, NativeModalDetectorLike as H, NativeActionRequest as N, RegisteredNativeComponent as R, WaitOptions as W, BridgeEventListener as a, BridgeEventType as b, CustomAction as c, NativeActionResponse as d, NativeBridgeSnapshot as e, NativeCapturedToast as f, NativeComponentAction as g, NativeCustomAction as h, NativeElementIdentifier as i, NativeElementRef as j, NativeElementState as k, NativeElementType as l, NativeFindRequest as m, NativeFindResponse as n, NativeLayout as o, NativeModalInfo as p, NativeRegistrationCoverage as q, NativeSnapshotEnricher as r, NativeSnapshotEnrichers as s, NativeSnapshotModalContext as t, NativeSnapshotToastContext as u, NativeSnapshotUndoContext as v, NativeStandardAction as w, NativeUIBridgeConfig as x, NativeUIBridgeFeatures as y, RegisteredNativeElement as z };
+export type { ActionHandler as A, BridgeEvent as B, ComponentAction as C, DiscoveredNativeElement as D, Workflow as E, WorkflowStep as F, WorkflowStepType as G, NativeAppInfo as H, NativeRouteProviderLike as I, NativeModalDetectorLike as J, NativeActionRequest as N, RegisteredNativeComponent as R, WaitOptions as W, BridgeEventListener as a, BridgeEventType as b, CustomAction as c, NativeActionResponse as d, NativeBridgeSnapshot as e, NativeCapturedToast as f, NativeComponentAction as g, NativeCustomAction as h, NativeElementIdentifier as i, NativeElementRef as j, NativeElementState as k, NativeElementType as l, NativeFindRequest as m, NativeFindResponse as n, NativeLayout as o, NativeModalInfo as p, NativeRegistrationCoverage as q, NativeSnapshotEnricher as r, NativeSnapshotEnrichers as s, NativeSnapshotModalContext as t, NativeSnapshotToastContext as u, NativeSnapshotUndoContext as v, NativeStandardAction as w, NativeUIBridgeConfig as x, NativeUIBridgeFeatures as y, RegisteredNativeElement as z };

package/dist/{types-DCEv5qb6.d.ts → types-CjEKTDYT.d.ts}

@@ -1,4 +1,4 @@
-import { W as WaitOptions, N as NativeActionRequest, d as NativeActionResponse, m as NativeFindRequest, n as NativeFindResponse, k as NativeElementState } from './types-BwdPNpII.js';
+import { W as WaitOptions, N as NativeActionRequest, d as NativeActionResponse, m as NativeFindRequest, n as NativeFindResponse, k as NativeElementState } from './types-CGVut7mc.js';
 
 /**
  * UI Bridge Native Control Types

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qontinui/ui-bridge-native",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "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",