@getuserfeedback/react-native 2.0.25 → 3.0.2

package/README.md

@@ -52,6 +52,8 @@ export function App() {
 
 `GetUserFeedbackProvider` renders `WidgetHost` internally, auto-enqueues `init`, measures the React Native window for the hosted WebView viewport, shows the hosted WebView inside a native bottom sheet while a flow is loading or open, and resolves command promises when the WebView transport reports command settlement. Pass either `loaderUrl` or a custom WebView `source` so the hosted WebView has a loader runtime to execute commands. Use `onCommandError` to receive automatic setup failures from `init` or `configure`.
 
+Custom `source` documents must implement the current WebView transport contract. Provider-owned presentation is driven by `instance:view-host:snapshots-changed`; the legacy aggregate `instance:flow:state-changed:instance` event does not control the native sheet.
+
 `WidgetHost` remains exported for advanced hosts that need direct WebView control.
 
 The host message types are re-exported from `@getuserfeedback/protocol/webview-transport` through package-owned aliases so the React Native package stays aligned with the shared WebView transport contract.

package/dist/index.js

@@ -15,7 +15,7 @@ import { createContext, createElement, useCallback, useContext, useEffect, useMe
 import { useResolvedHostViewport } from "./host-viewport.js";
 import { toCommandSettlementError, toReactNativeOneShotCommand, } from "./provider-command-helpers.js";
 import { useProviderCommandTransport } from "./provider-command-transport.js";
-import { createProviderWidgetHostLifecycleController, HIDDEN_PROVIDER_WIDGET_HOST_VISIBILITY, toProviderWidgetHostSnapshot, } from "./provider-widget-host-lifecycle.js";
+import { createProviderWidgetHostLifecycleController, HIDDEN_PROVIDER_WIDGET_HOST_VISIBILITY, } from "./provider-widget-host-lifecycle.js";
 import { ProviderWidgetHostOverlay, toProviderWidgetHostStyle, toProviderWidgetSheetHostLayoutPlan, } from "./provider-widget-host-overlay.js";
 import { REACT_NATIVE_SDK_VERSION } from "./version.js";
 import { WidgetHost, } from "./widget-host.js";
@@ -226,7 +226,7 @@ export function GetUserFeedbackProvider({ autoInit = true, children, commandTime
     const flowRunsRef = useRef(new Map());
     const flowRunControllerOptionsRef = useRef(null);
     const widgetHostLifecycle = widgetHostLifecycleRef.current;
-    const { clearFlowHandleFromVisibility, getCurrentHostEpoch, isWidgetHostVisible: resolveIsWidgetHostVisible, markNotReady, markReady, replaceViewHostSnapshots, syncHostSourceKey, toHostSnapshotVisibility, toReadyVisibility, } = widgetHostLifecycle;
+    const { clearFlowHandleFromVisibility, getCurrentHostEpoch, isWidgetHostVisible: resolveIsWidgetHostVisible, markNotReady, markReady, replaceViewHostSnapshots, syncHostSourceKey, toReadyVisibility, } = widgetHostLifecycle;
     const createCommandTimeoutError = useCallback((requestId) => new CommandSettlementTimeoutError(requestId), []);
     const transport = useProviderCommandTransport({
         commandTimeoutMs,
@@ -437,7 +437,9 @@ export function GetUserFeedbackProvider({ autoInit = true, children, commandTime
             clearIdleFlowHandles();
             didReissueDeliveredCommands = reissueDeliveredPendingActionCommands();
         }
-        setWidgetHostVisibility((visibility) => toReadyVisibility(visibility, event));
+        setWidgetHostVisibility((visibility) => readyResult.didResetHostEpoch
+            ? HIDDEN_PROVIDER_WIDGET_HOST_VISIBILITY
+            : toReadyVisibility(visibility, event));
         enqueueStartupCommands({ force: readyResult.previousReady !== null });
         startPendingCommandTimeouts();
         return didReissueDeliveredCommands;
@@ -485,17 +487,6 @@ export function GetUserFeedbackProvider({ autoInit = true, children, commandTime
         }
         setWidgetHostVisibility((visibility) => clearFlowHandleFromVisibility(visibility, flowHandleId));
     }, [clearFlowHandleFromVisibility]);
-    const handleInstanceFlowStateChanged = useCallback((detail) => {
-        const snapshot = toProviderWidgetHostSnapshot(detail, instanceId);
-        if (!snapshot) {
-            return;
-        }
-        const visibility = toHostSnapshotVisibility(snapshot);
-        if (!visibility) {
-            return;
-        }
-        setWidgetHostVisibility(visibility);
-    }, [instanceId, toHostSnapshotVisibility]);
     const handleWebMessage = useCallback((message) => {
         if (message.kind === "hostEvent" &&
             message.event.name === "instance:handle:invalidated" &&
@@ -504,11 +495,10 @@ export function GetUserFeedbackProvider({ autoInit = true, children, commandTime
         }
         if (message.kind === "hostEvent" &&
             message.event.name === "instance:view-host:snapshots-changed") {
-            replaceViewHostSnapshots(message.event.detail, instanceId);
-        }
-        if (message.kind === "hostEvent" &&
-            message.event.name === "instance:flow:state-changed:instance") {
-            handleInstanceFlowStateChanged(message.event.detail);
+            const visibility = replaceViewHostSnapshots(message.event.detail, instanceId);
+            if (visibility) {
+                setWidgetHostVisibility(visibility);
+            }
         }
         if (message.kind === "hostEvent" &&
             message.event.name === "instance:command:settled") {
@@ -550,7 +540,6 @@ export function GetUserFeedbackProvider({ autoInit = true, children, commandTime
         getCurrentHostEpoch,
         getPendingCommand,
         handleFlowHandleInvalidated,
-        handleInstanceFlowStateChanged,
         instanceId,
         onWebMessage,
         replaceViewHostSnapshots,

package/dist/provider-widget-host-lifecycle.d.ts

@@ -14,25 +14,6 @@ export type ProviderWidgetHostVisibility = {
     transitionPolicy?: WidgetLayoutTransitionPolicy;
     transitionPolicySequence?: number;
 };
-type ProviderWidgetHostFlowState = {
-    height?: number;
-    flowHandleId?: string;
-    instanceId: string;
-    isLoading: boolean;
-    isOpen: boolean;
-    shouldRender?: boolean;
-    transitionPolicy?: WidgetLayoutTransitionPolicy;
-    width?: number;
-};
-type ProviderWidgetHostSnapshot = {
-    flowHandleId?: string;
-    height?: number;
-    isLoading: boolean;
-    isOpen: boolean;
-    shouldRender: boolean;
-    transitionPolicy?: WidgetLayoutTransitionPolicy;
-    width?: number;
-};
 export declare const HIDDEN_PROVIDER_WIDGET_HOST_VISIBILITY: ProviderWidgetHostVisibility;
 export type ProviderWidgetHostLifecycleController = {
     clearFlowHandleFromVisibility: (visibility: ProviderWidgetHostVisibility, flowHandleId: string) => ProviderWidgetHostVisibility;
@@ -52,14 +33,12 @@ export type ProviderWidgetHostLifecycleController = {
         didResetHostEpoch: boolean;
         previousReady: ProviderWidgetHostReadyState | null;
     };
-    replaceViewHostSnapshots: (detail: InstanceViewHostSnapshotsChangedDetail, instanceId: string) => boolean;
+    replaceViewHostSnapshots: (detail: InstanceViewHostSnapshotsChangedDetail, instanceId: string) => ProviderWidgetHostVisibility | null;
     syncHostSourceKey: (hostSourceKey: string) => boolean;
-    toHostSnapshotVisibility: (snapshot: ProviderWidgetHostSnapshot) => ProviderWidgetHostVisibility | null;
     toReadyVisibility: (visibility: ProviderWidgetHostVisibility, event: {
         readySequence: number;
         sourceKey: string;
     }) => ProviderWidgetHostVisibility;
 };
-export declare function toProviderWidgetHostSnapshot(detail: ProviderWidgetHostFlowState, instanceId: string): ProviderWidgetHostSnapshot | null;
 export declare function createProviderWidgetHostLifecycleController(initialHostSourceKey: string): ProviderWidgetHostLifecycleController;
 export {};

package/dist/provider-widget-host-lifecycle.js

@@ -1,25 +1,10 @@
-import { cloneViewHostSnapshots, resolveInstanceFlowStateShouldRender, } from "@getuserfeedback/protocol/host";
+import { areViewHostSnapshotsEqual, cloneViewHostSnapshots, } from "@getuserfeedback/protocol/host";
 export const HIDDEN_PROVIDER_WIDGET_HOST_VISIBILITY = {
     hostSourceVersion: null,
     isVisible: false,
     readySequence: null,
     sourceKey: null,
 };
-export function toProviderWidgetHostSnapshot(detail, instanceId) {
-    if (detail.instanceId !== instanceId) {
-        return null;
-    }
-    const snapshot = {
-        flowHandleId: detail.flowHandleId,
-        height: detail.height,
-        isLoading: detail.isLoading,
-        isOpen: detail.isOpen,
-        shouldRender: resolveInstanceFlowStateShouldRender(detail),
-        transitionPolicy: detail.transitionPolicy,
-        width: detail.width,
-    };
-    return snapshot;
-}
 export function createProviderWidgetHostLifecycleController(initialHostSourceKey) {
     let hostEpoch = 0;
     let hostSourceKey = initialHostSourceKey;
@@ -27,6 +12,27 @@ export function createProviderWidgetHostLifecycleController(initialHostSourceKey
     let lastReady = null;
     let transitionPolicySequence = 0;
     let viewHostSnapshots = [];
+    let selectedViewHostSnapshot;
+    const toVisibility = (snapshot) => {
+        if (lastReady === null) {
+            return null;
+        }
+        let nextTransitionPolicySequence;
+        if (snapshot.transitionPolicy !== undefined) {
+            transitionPolicySequence += 1;
+            nextTransitionPolicySequence = transitionPolicySequence;
+        }
+        return {
+            flowHeight: snapshot.height,
+            flowHandleId: snapshot.flowHandleId,
+            hostSourceVersion,
+            isVisible: snapshot.shouldRender,
+            readySequence: lastReady.readySequence,
+            sourceKey: lastReady.sourceKey,
+            transitionPolicy: snapshot.transitionPolicy,
+            transitionPolicySequence: nextTransitionPolicySequence,
+        };
+    };
     return {
         clearFlowHandleFromVisibility: (visibility, flowHandleId) => visibility.flowHandleId === flowHandleId
             ? Object.assign(Object.assign({}, visibility), { flowHandleId: undefined }) : visibility,
@@ -44,6 +50,7 @@ export function createProviderWidgetHostLifecycleController(initialHostSourceKey
             }
             lastReady = null;
             viewHostSnapshots = [];
+            selectedViewHostSnapshot = undefined;
             return { wasReady };
         },
         markReady: (event, { hasDeliveredPendingCommands }) => {
@@ -61,6 +68,7 @@ export function createProviderWidgetHostLifecycleController(initialHostSourceKey
             if (didResetHostEpoch) {
                 hostEpoch += 1;
                 viewHostSnapshots = [];
+                selectedViewHostSnapshot = undefined;
             }
             lastReady = Object.assign(Object.assign({}, event), { hostEpoch });
             return {
@@ -71,10 +79,22 @@ export function createProviderWidgetHostLifecycleController(initialHostSourceKey
         },
         replaceViewHostSnapshots: (detail, instanceId) => {
             if (detail.instanceId !== instanceId || lastReady === null) {
-                return false;
+                return null;
             }
             viewHostSnapshots = cloneViewHostSnapshots(detail.snapshots);
-            return true;
+            const nextSelectedSnapshot = viewHostSnapshots[0];
+            if (areViewHostSnapshotsEqual(selectedViewHostSnapshot, nextSelectedSnapshot)) {
+                return null;
+            }
+            selectedViewHostSnapshot = nextSelectedSnapshot;
+            if (!nextSelectedSnapshot) {
+                return toVisibility({
+                    isLoading: false,
+                    isOpen: false,
+                    shouldRender: false,
+                });
+            }
+            return toVisibility(Object.assign(Object.assign({}, nextSelectedSnapshot), { shouldRender: true }));
         },
         syncHostSourceKey: (nextHostSourceKey) => {
             if (hostSourceKey === nextHostSourceKey) {
@@ -84,28 +104,9 @@ export function createProviderWidgetHostLifecycleController(initialHostSourceKey
             hostSourceVersion += 1;
             lastReady = null;
             viewHostSnapshots = [];
+            selectedViewHostSnapshot = undefined;
             return true;
         },
-        toHostSnapshotVisibility: (snapshot) => {
-            if (lastReady === null) {
-                return null;
-            }
-            let nextTransitionPolicySequence;
-            if (snapshot.transitionPolicy !== undefined) {
-                transitionPolicySequence += 1;
-                nextTransitionPolicySequence = transitionPolicySequence;
-            }
-            return {
-                flowHeight: snapshot.height,
-                flowHandleId: snapshot.flowHandleId,
-                hostSourceVersion,
-                isVisible: snapshot.shouldRender,
-                readySequence: lastReady.readySequence,
-                sourceKey: lastReady.sourceKey,
-                transitionPolicy: snapshot.transitionPolicy,
-                transitionPolicySequence: nextTransitionPolicySequence,
-            };
-        },
         toReadyVisibility: (visibility, event) => {
             if (!visibility.isVisible ||
                 visibility.sourceKey !== event.sourceKey ||

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 : "2.0.25";
+export const REACT_NATIVE_SDK_VERSION = reactNativeSdkVersion.length > 0 ? reactNativeSdkVersion : "3.0.2";

package/dist/view-orchestration-runtime.js

@@ -0,0 +1,54 @@
+// ../view-orchestration/src/view-activation-machine.ts
+import { createMachine, interpret, state, transition } from "robot3";
+var VIEW_ACTIVATION_STATES = {
+  idle: true,
+  prerendering: true,
+  "activation-requested": true,
+  "prerendering-activation-requested": true,
+  prerendered: true,
+  active: true
+};
+function createViewActivationMachine() {
+  const states = {
+    idle: state(transition("startPrerender", "prerendering"), transition("requestActivation", "activation-requested")),
+    prerendering: state(transition("requestActivation", "prerendering-activation-requested"), transition("markPrerendered", "prerendered")),
+    "activation-requested": state(transition("startPrerender", "prerendering-activation-requested")),
+    "prerendering-activation-requested": state(transition("markPrerendered", "active")),
+    prerendered: state(transition("requestActivation", "active")),
+    active: state()
+  };
+  return createMachine(states, () => ({}));
+}
+function createViewActivationController() {
+  const machine = createViewActivationMachine();
+  const service = interpret(machine, () => {});
+  const getState = () => readViewActivationState(service.machine.current);
+  const send = (event) => {
+    service.send(event);
+  };
+  return {
+    getState,
+    startPrerender: () => {
+      send({ type: "startPrerender" });
+    },
+    requestActivation: () => {
+      send({ type: "requestActivation" });
+    },
+    markPrerendered: () => {
+      send({ type: "markPrerendered" });
+    }
+  };
+}
+function readViewActivationState(value) {
+  if (typeof value !== "string" || !(value in VIEW_ACTIVATION_STATES)) {
+    throw new Error(`Unknown view activation state: ${String(value)}`);
+  }
+  return value;
+}
+// src/view-orchestration-runtime.ts
+function createViewActivationController2() {
+  return createViewActivationController();
+}
+export {
+  createViewActivationController2 as createViewActivationController
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@getuserfeedback/react-native",
-  "version": "2.0.25",
+  "version": "3.0.2",
   "description": "getuserfeedback React Native SDK",
   "keywords": [
     "getuserfeedback",
@@ -34,18 +34,18 @@
   "scripts": {
     "prepack": "node scripts/prepack.cjs",
     "postpack": "node scripts/postpack.cjs",
-    "pack:verify": "node ../../scripts/pack-and-verify.cjs --expect-dependency @getuserfeedback/protocol:../protocol/package.json --expect-dependency @getuserfeedback/sdk:../sdk/package.json",
-    "publish:dry-run": "node ../../scripts/publish-package.cjs . --expect-dependency @getuserfeedback/protocol:../protocol/package.json --expect-dependency @getuserfeedback/sdk:../sdk/package.json -- --dry-run",
-    "publish:npm": "node ../../scripts/publish-package.cjs . --expect-dependency @getuserfeedback/protocol:../protocol/package.json --expect-dependency @getuserfeedback/sdk:../sdk/package.json",
+    "pack:verify": "bun scripts/verify-packed-runtime.ts",
+    "publish:dry-run": "node ../../scripts/publish-package.cjs . --verify-packed-runtime scripts/verify-packed-runtime.ts --expect-dependency @getuserfeedback/protocol:../protocol/package.json --expect-dependency @getuserfeedback/sdk:../sdk/package.json -- --dry-run",
+    "publish:npm": "node ../../scripts/publish-package.cjs . --verify-packed-runtime scripts/verify-packed-runtime.ts --expect-dependency @getuserfeedback/protocol:../protocol/package.json --expect-dependency @getuserfeedback/sdk:../sdk/package.json",
     "build": "bun scripts/build.ts",
-    "typecheck": "tsc -b tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit --tsBuildInfoFile tsconfig.typecheck.tsbuildinfo && tsc -p tsconfig-scripts.json",
     "test": "bun test --dots",
     "test:changed": "bun test --changed=${TEST_CHANGED_BASE:-HEAD} --pass-with-no-tests --dots",
     "lint": "biome check ."
   },
   "dependencies": {
-    "@getuserfeedback/protocol": "^3.3.2",
-    "@getuserfeedback/sdk": "^0.8.30",
+    "@getuserfeedback/protocol": "^3.4.2",
+    "@getuserfeedback/sdk": "^0.8.33",
     "robot3": "^1.2.0"
   },
   "peerDependencies": {