@getuserfeedback/react-native 5.12.0 → 5.14.1

package/dist/native-view-record-controller.js

@@ -1,3 +1,4 @@
+import { createWidgetLayoutTransitionSchedule, } from "@getuserfeedback/protocol/host";
 import { coreViewHostActionSchema, } from "@getuserfeedback/protocol/internal/core-view-host-actions-v3";
 import { actionRequestCloseViewSchema, actionViewConnectSchema, buildEventLayoutTransactionCommitted, buildEventViewSize, eventViewSizeSchema, } from "@getuserfeedback/protocol/internal/view-host-control-messages";
 import { buildEventViewActivated, buildEventViewActivationDecided, buildEventViewAllocationFailed, buildEventViewClosed, buildEventViewCloseFailed, buildEventViewPrerendered, } from "@getuserfeedback/protocol/internal/view-host-lifecycle-events-v3";
@@ -223,6 +224,8 @@ export function createNativeViewRecordController(input) {
         }
     };
     const handlePrerender = (action) => {
+        var _a;
+        var _b;
         const existing = entries.get(action.viewId);
         if (existing) {
             if (existing.generation !== action.gen ||
@@ -239,6 +242,9 @@ export function createNativeViewRecordController(input) {
         nextAllocationId += 1;
         const entry = {
             allocationId: nextAllocationId,
+            flowId: ((_a = action.openRequest) === null || _a === void 0 ? void 0 : _a.source) === "command"
+                ? ((_b = action.openRequest.flowId) !== null && _b !== void 0 ? _b : null)
+                : null,
             generation: action.gen,
             flowRunId: action.flowRunId,
             instanceId: action.instanceId,
@@ -272,7 +278,8 @@ export function createNativeViewRecordController(input) {
     };
     // Governing contract: docs/specs/2026-08-29-sdk-open-request-interception.md.
     const handleActivate = (action) => {
-        var _a;
+        var _a, _b;
+        var _c;
         const entry = entries.get(action.viewId);
         if (!entry ||
             entry.instanceId !== action.instanceId ||
@@ -302,6 +309,9 @@ export function createNativeViewRecordController(input) {
             return;
         }
         if (!entry.isActive) {
+            if (((_b = action.openRequest) === null || _b === void 0 ? void 0 : _b.source) === "command") {
+                entry.flowId = (_c = action.openRequest.flowId) !== null && _c !== void 0 ? _c : entry.flowId;
+            }
             entry.isActive = true;
             notify();
         }
@@ -487,6 +497,7 @@ export function createNativeViewRecordController(input) {
                 connection.transport.postMessage(buildEventLayoutTransactionCommitted({
                     gen: entry.generation,
                     layoutTransactionId,
+                    transitionSchedule: entry.size.transitionSchedule,
                     viewId,
                 }));
             }
@@ -580,7 +591,7 @@ export function createNativeViewRecordController(input) {
                 }
             };
             const handleMessage = (value) => {
-                var _a;
+                var _a, _b;
                 if (coreConnectionFailed ||
                     detached ||
                     disposed ||
@@ -594,8 +605,24 @@ export function createNativeViewRecordController(input) {
                         connected.data.viewId === viewId) {
                         const wasViewConnected = entry.isViewConnected;
                         entry.isViewConnected = true;
+                        const navigationAvailability = !wasViewConnected
+                            ? (_a = input.getBrowserNavigationAvailability) === null || _a === void 0 ? void 0 : _a.call(input)
+                            : undefined;
+                        if (navigationAvailability !== undefined) {
+                            try {
+                                connection.transport.postMessage({
+                                    gen: entry.generation,
+                                    payload: navigationAvailability,
+                                    t: "getuserfeedback:event:message",
+                                });
+                            }
+                            catch (error) {
+                                failCoreConnection(error, "Native navigation availability delivery failed");
+                                return;
+                            }
+                        }
                         if (entry.size === null &&
-                            ((_a = entry.retainedSize) === null || _a === void 0 ? void 0 : _a.connectionId) === connection.connectionId) {
+                            ((_b = entry.retainedSize) === null || _b === void 0 ? void 0 : _b.connectionId) === connection.connectionId) {
                             entry.size = entry.retainedSize.size;
                             const readySize = connectionReadiness.recordSize(entry.size);
                             if (readySize) {
@@ -646,13 +673,18 @@ export function createNativeViewRecordController(input) {
                     }
                     return;
                 }
-                const size = toViewSizeReport(parsed.data);
+                const layoutReportRevision = entry.layoutReportRevision + 1;
+                const size = toViewSizeReport(parsed.data, {
+                    layoutReportRevision,
+                    previousSize: entry.size,
+                    viewId,
+                });
                 entry.size = size;
                 entry.retainedSize = {
                     connectionId: connection.connectionId,
                     size,
                 };
-                entry.layoutReportRevision += 1;
+                entry.layoutReportRevision = layoutReportRevision;
                 const readySize = connectionReadiness.recordSize(size);
                 if (readySize) {
                     deliverReadiness(readySize);
@@ -747,6 +779,7 @@ export function createNativeViewRecordController(input) {
 function toRecord(entry) {
     return Object.freeze({
         allocationId: entry.allocationId,
+        flowId: entry.flowId,
         generation: entry.generation,
         isActive: entry.isActive,
         layoutReportRevision: entry.layoutReportRevision,
@@ -755,7 +788,17 @@ function toRecord(entry) {
         viewId: entry.viewId,
     });
 }
-function toViewSizeReport(event) {
+function toViewSizeReport(event, context) {
+    var _a;
+    const transitionSchedule = context.previousSize !== null &&
+        event.layoutTransactionId !== undefined &&
+        ((_a = event.transitionPolicy) === null || _a === void 0 ? void 0 : _a.kind) === "timed"
+        ? createWidgetLayoutTransitionSchedule({
+            nowEpochMs: Date.now(),
+            sequence: context.layoutReportRevision,
+            transactionId: `${context.viewId}:${event.layoutTransactionId}`,
+        })
+        : undefined;
     return {
         width: event.width,
         height: event.height,
@@ -765,5 +808,6 @@ function toViewSizeReport(event) {
         placement: event.placement,
         transitionPolicy: event.transitionPolicy,
         layoutTransactionId: event.layoutTransactionId,
+        transitionSchedule,
     };
 }

package/dist/use-flow.d.ts

@@ -0,0 +1,32 @@
+import type { OpenFlowOptions } from "./client.js";
+/** Options for the React Native `useFlow` hook. */
+export interface UseFlowOptions {
+    /** The flow/survey ID to control. */
+    flowId: string;
+    /** Prefetch the flow resources when the hook mounts. Default `false`. */
+    prefetchOnMount?: boolean;
+    /** When true, the flow does not show a close button. */
+    hideCloseButton?: boolean;
+}
+/** Per-open options for the React Native `useFlow` hook. */
+export type UseFlowOpenOptions = Pick<OpenFlowOptions, "metadata">;
+/** State and commands for one React Native on-demand flow. */
+export interface UseFlowReturn {
+    /** True when the flow has an active, measured projected view. */
+    readonly isOpen: boolean;
+    /** True while the runtime is preparing this flow for display. */
+    readonly isLoading: boolean;
+    /** Open the flow. */
+    readonly open: (options?: UseFlowOpenOptions) => Promise<void>;
+    /** Close the flow. */
+    readonly close: () => Promise<void>;
+    /** Prefetch the flow resources without opening it. */
+    readonly prefetch: () => Promise<void>;
+    /** Prerender the flow without opening it. */
+    readonly prerender: () => Promise<void>;
+}
+/**
+ * Controls one on-demand flow in the provider's native presentation surface.
+ * React Native custom containers remain provider-wide via `useFlowContainer()`.
+ */
+export declare function useFlow(options: UseFlowOptions): UseFlowReturn;

package/dist/use-flow.js

@@ -0,0 +1,50 @@
+import { useCallback, useContext, useEffect, useMemo, useSyncExternalStore, } from "react";
+import { NativeFlowContainerContext } from "./native-flow-container-context.js";
+const EMPTY_RECORDS = Object.freeze([]);
+const EMPTY_REGISTRY_RECORDS = Object.freeze([]);
+const subscribeNoop = () => () => { };
+const getEmptyRecords = () => EMPTY_RECORDS;
+const getEmptyRegistryRecords = () => EMPTY_REGISTRY_RECORDS;
+const getFlowRegistryRecord = (flowId, records) => records.find((record) => record.flowId === flowId);
+const deriveFlowState = (flowId, registryRecords, records) => {
+    const flow = getFlowRegistryRecord(flowId, registryRecords);
+    const isOpen = records.some((record) => record.flowId === flowId && record.isActive && record.size !== null);
+    const isLoading = !isOpen &&
+        ((flow === null || flow === void 0 ? void 0 : flow.isOpening) === true ||
+            records.some((record) => record.flowId === flowId && record.isActive && record.size === null));
+    return { isLoading, isOpen };
+};
+/**
+ * Controls one on-demand flow in the provider's native presentation surface.
+ * React Native custom containers remain provider-wide via `useFlowContainer()`.
+ */
+export function useFlow(options) {
+    var _a, _b, _c;
+    const context = useContext(NativeFlowContainerContext);
+    if (!context) {
+        throw new Error("useFlow must be used inside GetUserFeedbackProvider");
+    }
+    const flowRun = useMemo(() => context.client.flow(options.flowId), [context.client, options.flowId]);
+    const registryRecords = useSyncExternalStore(context.flowRegistry.subscribe, context.flowRegistry.getSnapshot, getEmptyRegistryRecords);
+    const projection = context.projection;
+    const viewRecords = useSyncExternalStore((_a = projection === null || projection === void 0 ? void 0 : projection.controller.subscribe) !== null && _a !== void 0 ? _a : subscribeNoop, (_b = projection === null || projection === void 0 ? void 0 : projection.controller.getSnapshot) !== null && _b !== void 0 ? _b : getEmptyRecords, (_c = projection === null || projection === void 0 ? void 0 : projection.controller.getSnapshot) !== null && _c !== void 0 ? _c : getEmptyRecords);
+    const state = useMemo(() => {
+        return deriveFlowState(flowRun.flowId, registryRecords, viewRecords);
+    }, [flowRun.flowId, registryRecords, viewRecords]);
+    const open = useCallback((openOptions) => flowRun.open({
+        hideCloseButton: options.hideCloseButton,
+        metadata: openOptions === null || openOptions === void 0 ? void 0 : openOptions.metadata,
+    }), [flowRun, options.hideCloseButton]);
+    const close = useCallback(() => flowRun.close(), [flowRun]);
+    const prefetch = useCallback(() => flowRun.prefetch(), [flowRun]);
+    const prerender = useCallback(() => flowRun.prerender({ hideCloseButton: options.hideCloseButton }), [flowRun, options.hideCloseButton]);
+    useEffect(() => {
+        if (options.prefetchOnMount) {
+            void prefetch().catch(() => { });
+        }
+    }, [options.prefetchOnMount, prefetch]);
+    return Object.assign(Object.assign({}, state), { open,
+        close,
+        prefetch,
+        prerender });
+}

package/dist/version.js

@@ -3,4 +3,4 @@ const reactNativeSdkVersion = typeof __GX_REACT_NATIVE_SDK_VERSION__ === "string
     : "";
 // Build scripts patch this fallback to the package version for published artifacts.
 // Source-linked workspace usage keeps the local fallback.
-export const REACT_NATIVE_SDK_VERSION = reactNativeSdkVersion.length > 0 ? reactNativeSdkVersion : "5.12.0";
+export const REACT_NATIVE_SDK_VERSION = reactNativeSdkVersion.length > 0 ? reactNativeSdkVersion : "5.14.1";

package/dist/view-webview-host.js

@@ -33,7 +33,7 @@ function ViewWebViewHostDocument({ generation, onConnected, onDisconnected, onAc
     const controller = controllerRef.current;
     const buildDocumentStartScript = useMemo(() => () => buildViewWebViewBridgeScript({ bridgeId, phase: "documentStart" }), [bridgeId]);
     const source = useMemo(() => toExternalViewSource({ bridgeId, srcdoc }), [bridgeId, srcdoc]);
-    return createElement((WebViewDocumentHost), {
+    return createElement(WebViewDocumentHost, {
         buildDocumentStartScript,
         controller,
         parseMessage: parseViewWebViewBridgeMessage,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@getuserfeedback/react-native",
-  "version": "5.12.0",
+  "version": "5.14.1",
   "description": "getuserfeedback React Native SDK",
   "keywords": [
     "getuserfeedback",
@@ -54,8 +54,8 @@
     "lint": "biome check ."
   },
   "dependencies": {
-    "@getuserfeedback/protocol": "^5.4.2",
-    "@getuserfeedback/sdk": "^0.18.0",
+    "@getuserfeedback/protocol": "^5.5.0",
+    "@getuserfeedback/sdk": "^0.19.0",
     "robot3": "^1.2.0"
   },
   "peerDependencies": {
@@ -64,6 +64,6 @@
     "react-native-webview": ">=13.0.0"
   },
   "devDependencies": {
-    "typescript": "^5.8.3"
+    "typescript": "^7.0.2"
   }
 }