@qontinui/ui-bridge-native 0.3.0 → 0.3.1

package/dist/{registry-KdUW_koV.d.mts → registry-B5JadBN9.d.mts}

@@ -1,4 +1,4 @@
-import { a as BridgeEventListener, s as NativeSnapshotEnrichers, r as NativeSnapshotEnricher, j as NativeElementRef, l as NativeElementType, w as NativeStandardAction, h as NativeCustomAction, z as RegisteredNativeElement, k as NativeElementState, R as RegisteredNativeComponent, E as Workflow, b as BridgeEventType, e as NativeBridgeSnapshot, q as NativeRegistrationCoverage } from './types-BwdPNpII.mjs';
+import { a as BridgeEventListener, H as NativeAppInfo, I as NativeRouteProviderLike, s as NativeSnapshotEnrichers, r as NativeSnapshotEnricher, j as NativeElementRef, l as NativeElementType, w as NativeStandardAction, h as NativeCustomAction, z as RegisteredNativeElement, k as NativeElementState, R as RegisteredNativeComponent, E as Workflow, b as BridgeEventType, e as NativeBridgeSnapshot, q as NativeRegistrationCoverage } from './types-CGVut7mc.mjs';
 
 /**
  * Native Element and Component Registry
@@ -69,6 +69,29 @@ declare class NativeUIBridgeRegistry {
     private config;
     private enrichers;
     private snapshotExtras;
+    /**
+     * App identification metadata (appId/appName/appType/framework). Set via
+     * `setAppInfo` — typically wired in the server constructor from the
+     * `NativeUIBridgeConfig` the host passes to `UIBridgeNativeProvider`.
+     *
+     * When set, `createSnapshot` includes it on the resulting snapshot so
+     * agents can identify the app from snapshot bytes alone (parity with the
+     * `uiBridge` block on the `health` response). Snapshots created before
+     * this is wired simply omit the field.
+     */
+    private appInfo;
+    /**
+     * Optional route provider. When set, `createSnapshot` reads
+     * `currentRoute`/`segments` from it whenever the caller does not pass an
+     * explicit `routeInfo` argument. This lets the default `getSnapshot` HTTP
+     * handler — which has no direct reference to the `NativeUIBridgeServer`
+     * instance — still emit a populated `currentRoute` field.
+     *
+     * Wired by `NativeUIBridgeServer.setRouteProvider`, which forwards the
+     * provider into the registry alongside the per-handler overrides it
+     * already installs.
+     */
+    private routeProvider;
     /**
      * Sticky flag: flips `true` the first time any element is registered and
      * stays `true` even after elements are unregistered. Lets agents distinguish
@@ -77,6 +100,23 @@ declare class NativeUIBridgeRegistry {
      */
     private everHadRegistrations;
     constructor(config?: NativeRegistryConfig);
+    /**
+     * Set the app identification metadata returned alongside snapshots.
+     * Idempotent — re-calling with the same shape is a no-op.
+     * Pass `null` (or omit a previous call) to clear.
+     */
+    setAppInfo(info: NativeAppInfo | null | undefined): void;
+    /** Read-only accessor for the registered app info, if any. */
+    getAppInfo(): NativeAppInfo | null;
+    /**
+     * Set a route provider whose `getCurrentRoute`/`getSegments` are read by
+     * `createSnapshot` when no explicit `routeInfo` argument is supplied.
+     *
+     * Call with `null` to detach (e.g. when the host swaps providers on HMR).
+     */
+    setRouteProvider(provider: NativeRouteProviderLike | null | undefined): void;
+    /** Read-only accessor for the registered route provider, if any. */
+    getRouteProvider(): NativeRouteProviderLike | null;
     /**
      * Register/replace canonical enrichers (modal/toast/undo). HMR-safe — calling
      * with a partial set merges into existing slots instead of clobbering them.
@@ -207,7 +247,14 @@ declare class NativeUIBridgeRegistry {
      */
     emit(type: BridgeEventType, data: unknown): void;
     /**
-     * Create a snapshot of the current state
+     * Create a snapshot of the current state.
+     *
+     * Route resolution: `routeInfo` wins when provided. Otherwise — and this
+     * is the path the default `getSnapshot` HTTP handler takes — we fall back
+     * to the registered `routeProvider`. This means callers that never wire a
+     * server-level override (the bare-server / cloud-relay path) still get a
+     * populated `currentRoute` field as long as `setRouteProvider` was called
+     * on the registry.
      */
     createSnapshot(routeInfo?: {
         currentRoute?: string | null;

package/dist/{registry-BxXaxmsT.d.ts → registry-pAUpQq2O.d.ts}

@@ -1,4 +1,4 @@
-import { a as BridgeEventListener, s as NativeSnapshotEnrichers, r as NativeSnapshotEnricher, j as NativeElementRef, l as NativeElementType, w as NativeStandardAction, h as NativeCustomAction, z as RegisteredNativeElement, k as NativeElementState, R as RegisteredNativeComponent, E as Workflow, b as BridgeEventType, e as NativeBridgeSnapshot, q as NativeRegistrationCoverage } from './types-BwdPNpII.js';
+import { a as BridgeEventListener, H as NativeAppInfo, I as NativeRouteProviderLike, s as NativeSnapshotEnrichers, r as NativeSnapshotEnricher, j as NativeElementRef, l as NativeElementType, w as NativeStandardAction, h as NativeCustomAction, z as RegisteredNativeElement, k as NativeElementState, R as RegisteredNativeComponent, E as Workflow, b as BridgeEventType, e as NativeBridgeSnapshot, q as NativeRegistrationCoverage } from './types-CGVut7mc.js';
 
 /**
  * Native Element and Component Registry
@@ -69,6 +69,29 @@ declare class NativeUIBridgeRegistry {
     private config;
     private enrichers;
     private snapshotExtras;
+    /**
+     * App identification metadata (appId/appName/appType/framework). Set via
+     * `setAppInfo` — typically wired in the server constructor from the
+     * `NativeUIBridgeConfig` the host passes to `UIBridgeNativeProvider`.
+     *
+     * When set, `createSnapshot` includes it on the resulting snapshot so
+     * agents can identify the app from snapshot bytes alone (parity with the
+     * `uiBridge` block on the `health` response). Snapshots created before
+     * this is wired simply omit the field.
+     */
+    private appInfo;
+    /**
+     * Optional route provider. When set, `createSnapshot` reads
+     * `currentRoute`/`segments` from it whenever the caller does not pass an
+     * explicit `routeInfo` argument. This lets the default `getSnapshot` HTTP
+     * handler — which has no direct reference to the `NativeUIBridgeServer`
+     * instance — still emit a populated `currentRoute` field.
+     *
+     * Wired by `NativeUIBridgeServer.setRouteProvider`, which forwards the
+     * provider into the registry alongside the per-handler overrides it
+     * already installs.
+     */
+    private routeProvider;
     /**
      * Sticky flag: flips `true` the first time any element is registered and
      * stays `true` even after elements are unregistered. Lets agents distinguish
@@ -77,6 +100,23 @@ declare class NativeUIBridgeRegistry {
      */
     private everHadRegistrations;
     constructor(config?: NativeRegistryConfig);
+    /**
+     * Set the app identification metadata returned alongside snapshots.
+     * Idempotent — re-calling with the same shape is a no-op.
+     * Pass `null` (or omit a previous call) to clear.
+     */
+    setAppInfo(info: NativeAppInfo | null | undefined): void;
+    /** Read-only accessor for the registered app info, if any. */
+    getAppInfo(): NativeAppInfo | null;
+    /**
+     * Set a route provider whose `getCurrentRoute`/`getSegments` are read by
+     * `createSnapshot` when no explicit `routeInfo` argument is supplied.
+     *
+     * Call with `null` to detach (e.g. when the host swaps providers on HMR).
+     */
+    setRouteProvider(provider: NativeRouteProviderLike | null | undefined): void;
+    /** Read-only accessor for the registered route provider, if any. */
+    getRouteProvider(): NativeRouteProviderLike | null;
     /**
      * Register/replace canonical enrichers (modal/toast/undo). HMR-safe — calling
      * with a partial set merges into existing slots instead of clobbering them.
@@ -207,7 +247,14 @@ declare class NativeUIBridgeRegistry {
      */
     emit(type: BridgeEventType, data: unknown): void;
     /**
-     * Create a snapshot of the current state
+     * Create a snapshot of the current state.
+     *
+     * Route resolution: `routeInfo` wins when provided. Otherwise — and this
+     * is the path the default `getSnapshot` HTTP handler takes — we fall back
+     * to the registered `routeProvider`. This means callers that never wire a
+     * server-level override (the bare-server / cloud-relay path) still get a
+     * populated `currentRoute` field as long as `setRouteProvider` was called
+     * on the registry.
      */
     createSnapshot(routeInfo?: {
         currentRoute?: string | null;

package/dist/server/index.d.mts

@@ -1,9 +1,64 @@
-import { k as NativeServerHandlers, e as HandlerContext, A as APIResponse } from '../http-server-D2U1k48d.mjs';
-export { D as DismissModalResponse, F as FillFormFieldInput, a as FillFormFieldResult, b as FillFormRequest, c as FillFormResponse, H as HTTPRequest, d as HTTPResponse, f as HandlerFunction, J as JsonRpcBatchRequest, g as JsonRpcBatchResponse, u as JsonRpcClientMessage, h as JsonRpcEvent, i as JsonRpcRequest, j as JsonRpcResponse, v as JsonRpcServerMessage, w as JsonRpcSubscribe, x as JsonRpcUnsubscribe, N as NativeServerConfig, l as NativeUIBridgeServer, m as NavigationProvider, P as PushModalRequest, y as PushModalResponse, 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, z as isBatchRequest, B as isSubscribe, C as isUnsubscribe } from '../http-server-D2U1k48d.mjs';
-import { a as NativeUIBridgeRegistry } from '../registry-KdUW_koV.mjs';
-import { N as NativeActionExecutor } from '../types-DjB0zJJH.mjs';
+import { C as ConsoleErrorEntry, u as NetworkRequestEntry, k as NativeServerHandlers, e as HandlerContext, A as APIResponse } from '../http-server--550eD1F.mjs';
+export { v as ConsoleErrorsResponse, D as DismissModalResponse, F as FillFormFieldInput, a as FillFormFieldResult, b as FillFormRequest, c as FillFormResponse, H as HTTPRequest, d as HTTPResponse, f as HandlerFunction, J as JsonRpcBatchRequest, g as JsonRpcBatchResponse, w as JsonRpcClientMessage, h as JsonRpcEvent, i as JsonRpcRequest, j as JsonRpcResponse, x as JsonRpcServerMessage, y as JsonRpcSubscribe, z as JsonRpcUnsubscribe, N as NativeServerConfig, l as NativeUIBridgeServer, m as NavigationProvider, B as NetworkRequestsResponse, P as PushModalRequest, E as PushModalResponse, R as RequestHandler, n as RouteDefinition, o as RouteProvider, S as ScreenshotProvider, p as ServerAdapter, T as TapAtRequest, G as TapAtResponse, U as UI_BRIDGE_NATIVE_ROUTES, W as WebSocketConnection, q as WebSocketEventBridge, r as WebSocketMessageHandler, s as WebSocketServerAdapter, t as createNativeServer, I as isBatchRequest, K as isSubscribe, L as isUnsubscribe } from '../http-server--550eD1F.mjs';
+import { a as NativeUIBridgeRegistry } from '../registry-B5JadBN9.mjs';
+import { N as NativeActionExecutor } from '../types-B0XA4vOF.mjs';
 import { E as ElementDesignData, S as StateStyles, R as ResponsiveSnapshot } from '../design-types-BHr6Q1FX.mjs';
-import '../types-BwdPNpII.mjs';
+import '../types-CGVut7mc.mjs';
+
+/**
+ * UI Bridge Native — observability ring buffers.
+ *
+ * Two small last-N buffers backing the `/control/console-errors` and
+ * `/sdk/network-requests` endpoints. Each buffer monkey-patches the relevant
+ * global on `install()` and restores the original on `uninstall()`, so they
+ * can be installed/torn-down with the server's lifecycle.
+ *
+ * Both buffers are gated behind `features.testHooks` by the caller (see
+ * NativeUIBridgeServer). Production builds default to `testHooks: false`,
+ * so these patches never run on real users' devices.
+ *
+ * Implementation notes:
+ *   - Buffers default to capacity 100 entries and drop oldest on overflow.
+ *   - Patches are idempotent: `install()` is a no-op when already installed;
+ *     `uninstall()` is a no-op when not installed.
+ *   - Patches only restore the *original* function captured at install time;
+ *     if other code wraps `console.error` / `fetch` between install and
+ *     uninstall, those wrappers will be lost. Acceptable for test hooks.
+ */
+
+declare class ConsoleErrorBuffer {
+    private buffer;
+    private installed;
+    private originalError?;
+    private originalWarn?;
+    constructor(capacity?: number);
+    install(): void;
+    uninstall(): void;
+    entries(opts?: {
+        since?: number;
+        limit?: number;
+    }): ConsoleErrorEntry[];
+    size(): number;
+    clear(): void;
+    isInstalled(): boolean;
+}
+declare class NetworkRequestBuffer {
+    private buffer;
+    private installed;
+    private originalFetch?;
+    private originalXhrOpen?;
+    private originalXhrSend?;
+    constructor(capacity?: number);
+    install(): void;
+    uninstall(): void;
+    entries(opts?: {
+        since?: number;
+        limit?: number;
+    }): NetworkRequestEntry[];
+    size(): number;
+    clear(): void;
+    isInstalled(): boolean;
+}
 
 /**
  * UI Bridge Native Server Handlers
@@ -21,6 +76,10 @@ declare function createServerHandlers(registry: NativeUIBridgeRegistry, executor
         appType: string;
         framework?: string;
     };
+    /** Optional console-error ring buffer powering `GET /control/console-errors`. */
+    consoleErrorBuffer?: ConsoleErrorBuffer;
+    /** Optional network-request ring buffer powering `GET /sdk/network-requests`. */
+    networkRequestBuffer?: NetworkRequestBuffer;
 }): NativeServerHandlers;
 
 /**
@@ -116,4 +175,4 @@ interface NativeDesignHandlers {
  */
 declare function createDesignHandlers(registry: NativeUIBridgeRegistry): NativeDesignHandlers;
 
-export { APIResponse, type DecodeResult, type DecodedFrame, HandlerContext, type NativeDesignHandlers, NativeServerHandlers, OPCODE_BINARY, OPCODE_CLOSE, OPCODE_CONTINUATION, OPCODE_PING, OPCODE_PONG, OPCODE_TEXT, buildUpgradeResponse, computeAcceptKey, createDesignHandlers, createServerHandlers, decodeFrames, decodeTextPayload, encodeCloseFrame, encodePingFrame, encodePongFrame, encodeTextFrame };
+export { APIResponse, ConsoleErrorBuffer, ConsoleErrorEntry, type DecodeResult, type DecodedFrame, HandlerContext, type NativeDesignHandlers, NativeServerHandlers, NetworkRequestBuffer, NetworkRequestEntry, OPCODE_BINARY, OPCODE_CLOSE, OPCODE_CONTINUATION, OPCODE_PING, OPCODE_PONG, OPCODE_TEXT, buildUpgradeResponse, computeAcceptKey, createDesignHandlers, createServerHandlers, decodeFrames, decodeTextPayload, encodeCloseFrame, encodePingFrame, encodePongFrame, encodeTextFrame };

package/dist/server/index.d.ts

@@ -1,9 +1,64 @@
-import { k as NativeServerHandlers, e as HandlerContext, A as APIResponse } from '../http-server-ck8clUsZ.js';
-export { D as DismissModalResponse, F as FillFormFieldInput, a as FillFormFieldResult, b as FillFormRequest, c as FillFormResponse, H as HTTPRequest, d as HTTPResponse, f as HandlerFunction, J as JsonRpcBatchRequest, g as JsonRpcBatchResponse, u as JsonRpcClientMessage, h as JsonRpcEvent, i as JsonRpcRequest, j as JsonRpcResponse, v as JsonRpcServerMessage, w as JsonRpcSubscribe, x as JsonRpcUnsubscribe, N as NativeServerConfig, l as NativeUIBridgeServer, m as NavigationProvider, P as PushModalRequest, y as PushModalResponse, 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, z as isBatchRequest, B as isSubscribe, C as isUnsubscribe } from '../http-server-ck8clUsZ.js';
-import { a as NativeUIBridgeRegistry } from '../registry-BxXaxmsT.js';
-import { N as NativeActionExecutor } from '../types-DCEv5qb6.js';
+import { C as ConsoleErrorEntry, u as NetworkRequestEntry, k as NativeServerHandlers, e as HandlerContext, A as APIResponse } from '../http-server-C9NaNBEP.js';
+export { v as ConsoleErrorsResponse, D as DismissModalResponse, F as FillFormFieldInput, a as FillFormFieldResult, b as FillFormRequest, c as FillFormResponse, H as HTTPRequest, d as HTTPResponse, f as HandlerFunction, J as JsonRpcBatchRequest, g as JsonRpcBatchResponse, w as JsonRpcClientMessage, h as JsonRpcEvent, i as JsonRpcRequest, j as JsonRpcResponse, x as JsonRpcServerMessage, y as JsonRpcSubscribe, z as JsonRpcUnsubscribe, N as NativeServerConfig, l as NativeUIBridgeServer, m as NavigationProvider, B as NetworkRequestsResponse, P as PushModalRequest, E as PushModalResponse, R as RequestHandler, n as RouteDefinition, o as RouteProvider, S as ScreenshotProvider, p as ServerAdapter, T as TapAtRequest, G as TapAtResponse, U as UI_BRIDGE_NATIVE_ROUTES, W as WebSocketConnection, q as WebSocketEventBridge, r as WebSocketMessageHandler, s as WebSocketServerAdapter, t as createNativeServer, I as isBatchRequest, K as isSubscribe, L as isUnsubscribe } from '../http-server-C9NaNBEP.js';
+import { a as NativeUIBridgeRegistry } from '../registry-pAUpQq2O.js';
+import { N as NativeActionExecutor } from '../types-CjEKTDYT.js';
 import { E as ElementDesignData, S as StateStyles, R as ResponsiveSnapshot } from '../design-types-BHr6Q1FX.js';
-import '../types-BwdPNpII.js';
+import '../types-CGVut7mc.js';
+
+/**
+ * UI Bridge Native — observability ring buffers.
+ *
+ * Two small last-N buffers backing the `/control/console-errors` and
+ * `/sdk/network-requests` endpoints. Each buffer monkey-patches the relevant
+ * global on `install()` and restores the original on `uninstall()`, so they
+ * can be installed/torn-down with the server's lifecycle.
+ *
+ * Both buffers are gated behind `features.testHooks` by the caller (see
+ * NativeUIBridgeServer). Production builds default to `testHooks: false`,
+ * so these patches never run on real users' devices.
+ *
+ * Implementation notes:
+ *   - Buffers default to capacity 100 entries and drop oldest on overflow.
+ *   - Patches are idempotent: `install()` is a no-op when already installed;
+ *     `uninstall()` is a no-op when not installed.
+ *   - Patches only restore the *original* function captured at install time;
+ *     if other code wraps `console.error` / `fetch` between install and
+ *     uninstall, those wrappers will be lost. Acceptable for test hooks.
+ */
+
+declare class ConsoleErrorBuffer {
+    private buffer;
+    private installed;
+    private originalError?;
+    private originalWarn?;
+    constructor(capacity?: number);
+    install(): void;
+    uninstall(): void;
+    entries(opts?: {
+        since?: number;
+        limit?: number;
+    }): ConsoleErrorEntry[];
+    size(): number;
+    clear(): void;
+    isInstalled(): boolean;
+}
+declare class NetworkRequestBuffer {
+    private buffer;
+    private installed;
+    private originalFetch?;
+    private originalXhrOpen?;
+    private originalXhrSend?;
+    constructor(capacity?: number);
+    install(): void;
+    uninstall(): void;
+    entries(opts?: {
+        since?: number;
+        limit?: number;
+    }): NetworkRequestEntry[];
+    size(): number;
+    clear(): void;
+    isInstalled(): boolean;
+}
 
 /**
  * UI Bridge Native Server Handlers
@@ -21,6 +76,10 @@ declare function createServerHandlers(registry: NativeUIBridgeRegistry, executor
         appType: string;
         framework?: string;
     };
+    /** Optional console-error ring buffer powering `GET /control/console-errors`. */
+    consoleErrorBuffer?: ConsoleErrorBuffer;
+    /** Optional network-request ring buffer powering `GET /sdk/network-requests`. */
+    networkRequestBuffer?: NetworkRequestBuffer;
 }): NativeServerHandlers;
 
 /**
@@ -116,4 +175,4 @@ interface NativeDesignHandlers {
  */
 declare function createDesignHandlers(registry: NativeUIBridgeRegistry): NativeDesignHandlers;
 
-export { APIResponse, type DecodeResult, type DecodedFrame, HandlerContext, type NativeDesignHandlers, NativeServerHandlers, OPCODE_BINARY, OPCODE_CLOSE, OPCODE_CONTINUATION, OPCODE_PING, OPCODE_PONG, OPCODE_TEXT, buildUpgradeResponse, computeAcceptKey, createDesignHandlers, createServerHandlers, decodeFrames, decodeTextPayload, encodeCloseFrame, encodePingFrame, encodePongFrame, encodeTextFrame };
+export { APIResponse, ConsoleErrorBuffer, ConsoleErrorEntry, type DecodeResult, type DecodedFrame, HandlerContext, type NativeDesignHandlers, NativeServerHandlers, NetworkRequestBuffer, NetworkRequestEntry, OPCODE_BINARY, OPCODE_CLOSE, OPCODE_CONTINUATION, OPCODE_PING, OPCODE_PONG, OPCODE_TEXT, buildUpgradeResponse, computeAcceptKey, createDesignHandlers, createServerHandlers, decodeFrames, decodeTextPayload, encodeCloseFrame, encodePingFrame, encodePongFrame, encodeTextFrame };