@getuserfeedback/react-native 5.3.4 → 5.4.0

package/dist/client.d.ts

@@ -1,6 +1,6 @@
 import type { AppEventExternalId, PublicCommandPayload } from "@getuserfeedback/protocol";
-import type { CapabilitiesInput, ConfigureOptions, EventOptions, EventProperties, GraphOperations, InitOptions } from "@getuserfeedback/sdk";
-export type { EventOptions, EventProperties, TrackOptions, } from "@getuserfeedback/sdk";
+import type { CapabilitiesInput, ConfigureOptions, EventOptions, EventProperties, GraphOperations, InitOptions, OpenRequestedCallback } from "@getuserfeedback/sdk";
+export type { EventOptions, EventProperties, OpenRequestedCallback, OpenRequestedEvent, TrackOptions, } from "@getuserfeedback/sdk";
 type IdentifyTraits = Record<string, unknown>;
 type OpenCommand = Extract<PublicCommandPayload, {
     kind: "open";
@@ -65,6 +65,22 @@ export interface Client {
     flow: (flowId: string) => FlowRun;
     /** Closes every open flow owned by this provider. */
     close: () => Promise<void>;
+    /**
+     * Subscribe to explicit SDK and client-side targeting open requests, or
+     * suppress them, for example when the user should not be interrupted.
+     * Prevention applies only to that presentation attempt; it does not create a
+     * public retry schedule.
+     *
+     * @example Suppress open requests while the user is busy
+     * ```ts
+     * client.onOpenRequested((event) => {
+     *   if (userIsBusy()) {
+     *     event.preventDefault();
+     *   }
+     * });
+     * ```
+     */
+    onOpenRequested: (callback: OpenRequestedCallback) => () => void;
     /** Resets widget state, authentication, and the current user identity. */
     reset: (options?: CommandOptions) => Promise<void>;
     /** Updates app navigation and environment context used by targeting. */

package/dist/core-webview-bridge-adapter.js

@@ -1,4 +1,4 @@
-import { CORE_HOST_BOOTSTRAP_GLOBAL_KEY, CORE_HOST_BOOTSTRAP_PROTOCOL_VERSION, CORE_HOST_BOOTSTRAP_READY_EVENT_NAME, CORE_HOST_BOOTSTRAP_REQUIRED_FRAGMENT, } from "@getuserfeedback/protocol/internal/core-host-bootstrap";
+import { CORE_HOST_BOOTSTRAP_GLOBAL_KEY, CORE_HOST_BOOTSTRAP_PROTOCOL_VERSION, CORE_HOST_BOOTSTRAP_READY_EVENT_NAME, CORE_HOST_BOOTSTRAP_REQUIRED_FRAGMENT, } from "@getuserfeedback/protocol/internal/core-host-bootstrap-v3";
 import { parseWebViewConnectionBridgeMessage, } from "./webview-connection-bridge-message.js";
 import { buildWebViewConnectionBridgeScript, } from "./webview-connection-bridge-script.js";
 import { buildWebViewConnectionHostMessageScript, serializeForJavaScript, } from "./webview-connection-host-message-script.js";

package/dist/native-provider-client-controller.d.ts

@@ -1,5 +1,6 @@
 import type { EventHandleInvalidated } from "@getuserfeedback/protocol/internal/core-handle-invalidation";
 import type { ConfigureOptions } from "@getuserfeedback/sdk";
+import { type OpenRequestDispatcher } from "@getuserfeedback/sdk/internal/open-request-dispatcher";
 export declare function createNativeProviderClientController(input: {
     instanceId: string;
     onError?: (error: Error) => void;
@@ -7,6 +8,7 @@ export declare function createNativeProviderClientController(input: {
     client: import("./client.js").Client;
     directSessionController: import("./native-direct-command-session-controller.js").NativeDirectCommandSessionController;
     getRuntimeConfiguration: () => ConfigureOptions;
+    observeOpenRequest: (payload: Parameters<OpenRequestDispatcher["dispatch"]>[0]) => ReturnType<OpenRequestDispatcher["dispatch"]>;
     dispose: () => void;
     onHandleInvalidated: (message: EventHandleInvalidated) => void;
     onSessionEnded: () => void;

package/dist/native-provider-client-controller.js

@@ -1,4 +1,5 @@
 import { parsePublicCommand } from "@getuserfeedback/protocol";
+import { createOpenRequestDispatcher, } from "@getuserfeedback/sdk/internal/open-request-dispatcher";
 import { createNativeProviderClient, parseRequiredString, } from "./native-provider-client.js";
 import { createNativeProviderCommandController } from "./native-provider-command-controller.js";
 import { createNativeProviderFlowRegistry } from "./native-provider-flow-registry.js";
@@ -14,6 +15,19 @@ export function createNativeProviderClientController(input) {
     const commands = createNativeProviderCommandController(input);
     const flows = createNativeProviderFlowRegistry(commands);
     const session = commands.directSessionController;
+    const openRequestDispatcher = createOpenRequestDispatcher();
+    const reportOpenRequestObserverError = (error) => {
+        var _a;
+        try {
+            (_a = input.onError) === null || _a === void 0 ? void 0 : _a.call(input, error instanceof Error ? error : new Error(String(error)));
+        }
+        catch (_b) {
+            // Error observers cannot become open-request authority.
+        }
+    };
+    const observeOpenRequest = (payload) => openRequestDispatcher.dispatch(payload, {
+        onListenerError: reportOpenRequestObserverError,
+    });
     const client = createNativeProviderClient({
         dispatchCommand: async (command, options) => {
             if (command.kind === "close" || command.kind === "reset") {
@@ -37,11 +51,13 @@ export function createNativeProviderClientController(input) {
         },
         flow: (flowId) => flows.flow(parseRequiredString("flowId", flowId)),
         instanceId: input.instanceId,
+        openRequestDispatcher,
     });
     return {
         client,
         directSessionController: session,
         getRuntimeConfiguration: () => (Object.assign({}, runtimeConfiguration)),
+        observeOpenRequest,
         dispose: () => {
             flows.reset();
             commands.dispose();

package/dist/native-provider-client.d.ts

@@ -1,4 +1,5 @@
 import type { PublicCommandPayload } from "@getuserfeedback/protocol";
+import { type OpenRequestDispatcher } from "@getuserfeedback/sdk/internal/open-request-dispatcher";
 import type { Client } from "./client.js";
 type NativeProviderClientCommand = Extract<PublicCommandPayload, {
     kind: "configure" | "identify" | "track" | "close" | "reset" | "updateHostContext" | "emitHostSignal";
@@ -8,7 +9,8 @@ type NativeProviderClientOptions = {
     dispatchCommand: (command: NativeProviderClientCommand, options?: NativeProviderCommandOptions) => Promise<void>;
     flow: Client["flow"];
     instanceId: string;
+    openRequestDispatcher?: OpenRequestDispatcher;
 };
 export declare const parseRequiredString: (name: string, value?: string) => string;
-export declare function createNativeProviderClient({ dispatchCommand, flow, instanceId, }: NativeProviderClientOptions): Client;
+export declare function createNativeProviderClient({ dispatchCommand, flow, instanceId, openRequestDispatcher, }: NativeProviderClientOptions): Client;
 export {};

package/dist/native-provider-client.js

@@ -1,5 +1,6 @@
 import { assertNoSegmentExternalIdsInValueArgument } from "@getuserfeedback/protocol/host";
 import { buildCustomerOccurrenceCommand } from "@getuserfeedback/sdk/internal/customer-occurrence-command";
+import { createOpenRequestDispatcher, } from "@getuserfeedback/sdk/internal/open-request-dispatcher";
 export const parseRequiredString = (name, value) => {
     const normalized = value === null || value === void 0 ? void 0 : value.trim();
     if (!normalized) {
@@ -34,7 +35,7 @@ const toIdentifyCommandPayload = (identifyInput, traitsOrOptions, options) => {
         options: options !== null && options !== void 0 ? options : traitsOrOptions,
     };
 };
-export function createNativeProviderClient({ dispatchCommand, flow, instanceId, }) {
+export function createNativeProviderClient({ dispatchCommand, flow, instanceId, openRequestDispatcher = createOpenRequestDispatcher(), }) {
     const track = (eventName, properties, options) => {
         return dispatchCommand(buildCustomerOccurrenceCommand({
             type: "track",
@@ -61,6 +62,7 @@ export function createNativeProviderClient({ dispatchCommand, flow, instanceId,
         },
         flow,
         close: () => dispatchCommand({ kind: "close" }),
+        onOpenRequested: openRequestDispatcher.subscribe,
         reset: (options) => dispatchCommand({ kind: "reset" }, options),
         updateHostContext: (context, options) => dispatchCommand({ kind: "updateHostContext", context }, options),
         emitHostSignal: (name, data, options) => dispatchCommand(Object.assign({ kind: "emitHostSignal", name: parseRequiredString("name", name) }, (data === undefined ? {} : { data })), options),

package/dist/native-provider.d.ts

@@ -1,6 +1,6 @@
 import { type ComponentType, type ReactElement, type ReactNode } from "react";
 import type { Client, ClientOptions } from "./client.js";
-export type { Client, ClientOptions, EventOptions, EventProperties, FlowRun, TrackOptions, } from "./client.js";
+export type { Client, ClientOptions, EventOptions, EventProperties, FlowRun, OpenRequestedCallback, OpenRequestedEvent, TrackOptions, } from "./client.js";
 export type { UseFlowContainerReturn } from "./flow-container.js";
 export { FlowContent, useFlowContainer } from "./flow-container.js";
 /**

package/dist/native-provider.js

@@ -146,6 +146,7 @@ export function GetUserFeedbackProvider({ children, clientOptions, instanceId: i
         onCommandSessionChange: handleCommandSessionChange,
         onError: reportError,
         onHandleInvalidated: handleHandleInvalidated,
+        observeOpenRequest: controller.observeOpenRequest,
         viewWebViewComponent: webViewComponent,
     }))));
 }

package/dist/native-runtime-endpoints.d.ts

@@ -5,4 +5,4 @@
  * docs/specs/2026-08-02-flow-interaction-model.md (Projection protocol and
  * rollout).
  */
-export declare const REACT_NATIVE_PINNED_CORE_URL: "https://cdn.getuserfeedback.com/widget/core/v3/core.html";
+export declare const REACT_NATIVE_PINNED_CORE_URL: "https://cdn.getuserfeedback.com/widget/core/v6/core.html";

package/dist/native-runtime-endpoints.js

@@ -5,4 +5,4 @@
  * docs/specs/2026-08-02-flow-interaction-model.md (Projection protocol and
  * rollout).
  */
-export const REACT_NATIVE_PINNED_CORE_URL = "https://cdn.getuserfeedback.com/widget/core/v3/core.html";
+export const REACT_NATIVE_PINNED_CORE_URL = "https://cdn.getuserfeedback.com/widget/core/v6/core.html";

package/dist/native-runtime-root.d.ts

@@ -1,6 +1,7 @@
 import type { CoreCommandEnvelope } from "@getuserfeedback/protocol";
 import type { EventHandleInvalidated } from "@getuserfeedback/protocol/internal/core-handle-invalidation";
 import type { ConfigureOptions, InitOptions } from "@getuserfeedback/sdk";
+import type { OpenRequestDispatcher } from "@getuserfeedback/sdk/internal/open-request-dispatcher";
 import { type ReactElement } from "react";
 import { type CoreWebViewHostProps } from "./core-webview-host.js";
 import { type NativeCoreCommandSession } from "./native-core-command-session.js";
@@ -15,6 +16,7 @@ export type NativeRuntimeRootProps = {
     onError?: (error: Error) => void;
     onHandleInvalidated?: (message: EventHandleInvalidated) => void;
     onInvalidMessage?: (error: Error, value: unknown) => void;
+    observeOpenRequest?: (payload: Parameters<OpenRequestDispatcher["dispatch"]>[0]) => ReturnType<OpenRequestDispatcher["dispatch"]>;
     onStartupTerminalError?: (error: Error) => void;
     startupCommandSettlementTimeoutMs?: number;
     attachViewProjection?: (projection: NativeViewProjection) => () => void;
@@ -34,6 +36,6 @@ type NativeProviderRuntimeProps = Omit<NativeRuntimeRootProps, "createStartupCom
     getRuntimeConfiguration?: () => ConfigureOptions;
     onCommandSessionChange?: (session: NativeDirectCommandSession | null) => void;
 };
-export declare function NativeRuntimeRoot({ attachViewProjection, coreUrl, coreWebViewComponent, createStartupCommand, onCommandSessionChange, onError, onHandleInvalidated, onInvalidMessage, onStartupTerminalError, startupCommandSettlementTimeoutMs, viewNativeViewComponent, viewWebViewComponent, }: NativeRuntimeRootProps): ReactElement;
+export declare function NativeRuntimeRoot({ attachViewProjection, coreUrl, coreWebViewComponent, createStartupCommand, onCommandSessionChange, onError, onHandleInvalidated, onInvalidMessage, observeOpenRequest, onStartupTerminalError, startupCommandSettlementTimeoutMs, viewNativeViewComponent, viewWebViewComponent, }: NativeRuntimeRootProps): ReactElement;
 export declare function NativeProviderRuntime({ directSessionController, getRuntimeConfiguration, initOptions, instanceId, onCommandSessionChange, onError, ...runtimeProps }: NativeProviderRuntimeProps): ReactElement;
 export {};

package/dist/native-runtime-root.js

@@ -20,7 +20,7 @@ import { createNativeViewRecordController, } from "./native-view-record-controll
 import { createProviderCommandEnvelope, REACT_NATIVE_CLIENT_META, } from "./provider-command-helpers.js";
 const DEFAULT_STARTUP_COMMAND_SETTLEMENT_TIMEOUT_MS = 30000;
 const getEmptyRuntimeConfiguration = () => ({});
-export function NativeRuntimeRoot({ attachViewProjection, coreUrl, coreWebViewComponent, createStartupCommand, onCommandSessionChange, onError, onHandleInvalidated, onInvalidMessage, onStartupTerminalError, startupCommandSettlementTimeoutMs = DEFAULT_STARTUP_COMMAND_SETTLEMENT_TIMEOUT_MS, viewNativeViewComponent, viewWebViewComponent, }) {
+export function NativeRuntimeRoot({ attachViewProjection, coreUrl, coreWebViewComponent, createStartupCommand, onCommandSessionChange, onError, onHandleInvalidated, onInvalidMessage, observeOpenRequest, onStartupTerminalError, startupCommandSettlementTimeoutMs = DEFAULT_STARTUP_COMMAND_SETTLEMENT_TIMEOUT_MS, viewNativeViewComponent, viewWebViewComponent, }) {
     const [coreHostRevision, setCoreHostRevision] = useState(0);
     const [session, setSession] = useState(null);
     const sessionRef = useRef(null);
@@ -34,6 +34,8 @@ export function NativeRuntimeRoot({ attachViewProjection, coreUrl, coreWebViewCo
     onHandleInvalidatedRef.current = onHandleInvalidated;
     const onInvalidMessageRef = useRef(onInvalidMessage);
     onInvalidMessageRef.current = onInvalidMessage;
+    const observeOpenRequestRef = useRef(observeOpenRequest);
+    observeOpenRequestRef.current = observeOpenRequest;
     const onStartupTerminalErrorRef = useRef(onStartupTerminalError);
     onStartupTerminalErrorRef.current = onStartupTerminalError;
     const createStartupCommandRef = useRef(createStartupCommand);
@@ -81,6 +83,7 @@ export function NativeRuntimeRoot({ attachViewProjection, coreUrl, coreWebViewCo
         const controller = createNativeViewRecordController({
             coreConnection,
             onError: reportError,
+            observeOpenRequest: (payload) => { var _a, _b; return (_b = (_a = observeOpenRequestRef.current) === null || _a === void 0 ? void 0 : _a.call(observeOpenRequestRef, payload)) !== null && _b !== void 0 ? _b : { allowed: true }; },
         });
         const commandChannelOwner = createNativeCoreCommandChannel({
             coreConnection,

package/dist/native-view-record-controller.d.ts

@@ -1,4 +1,5 @@
 import { type EventViewSize } from "@getuserfeedback/protocol/internal/view-host-control-messages";
+import type { OpenRequestDispatcher } from "@getuserfeedback/sdk/internal/open-request-dispatcher";
 import type { CoreWebViewHostConnection } from "./core-webview-host-controller.js";
 import type { ViewWebViewHostConnection } from "./view-webview-host-controller.js";
 type NativeViewSizeReport = Omit<EventViewSize, "gen" | "t" | "viewId">;
@@ -35,8 +36,10 @@ export type NativeViewRecordController = {
     getSnapshot(): readonly NativeViewRecord[];
     subscribe(listener: () => void): () => void;
 };
+type NativeOpenRequestObserver = (payload: Parameters<OpenRequestDispatcher["dispatch"]>[0]) => ReturnType<OpenRequestDispatcher["dispatch"]>;
 export declare function createNativeViewRecordController(input: {
     coreConnection: CoreWebViewHostConnection;
     onError: (error: Error) => void;
+    observeOpenRequest?: NativeOpenRequestObserver;
 }): NativeViewRecordController;
 export {};

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

@@ -1,6 +1,6 @@
-import { coreViewHostActionSchema, } from "@getuserfeedback/protocol/internal/core-view-host-actions";
+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, buildEventViewAllocationFailed, buildEventViewClosed, buildEventViewCloseFailed, buildEventViewPrerendered, } from "@getuserfeedback/protocol/internal/view-host-lifecycle-events";
+import { buildEventViewActivated, buildEventViewActivationDecided, buildEventViewAllocationFailed, buildEventViewClosed, buildEventViewCloseFailed, buildEventViewPrerendered, } from "@getuserfeedback/protocol/internal/view-host-lifecycle-events-v3";
 import { bindViewHostControlEnvelope, bindViewToCoreRelayEnvelope, parseCoreToViewRelayEnvelope, } from "@getuserfeedback/protocol/internal/view-relay-contract";
 import { createViewPreparationReadinessRegistry, createViewPreparationRegistry, } from "./view-orchestration-runtime.js";
 const createNativeViewReadinessRegistry = () => createViewPreparationReadinessRegistry();
@@ -157,6 +157,21 @@ export function createNativeViewRecordController(input) {
             failCoreConnection(error, "Native view close failure delivery failed");
         }
     };
+    const postViewActivationDecision = (action, allowed) => {
+        try {
+            input.coreConnection.transport.postMessage(buildEventViewActivationDecided({
+                gen: action.gen,
+                viewId: action.viewId,
+                activationAttemptId: action.activationAttemptId,
+                allowed,
+            }));
+            return true;
+        }
+        catch (error) {
+            failCoreConnection(error, "Native view activation decision delivery failed");
+            return false;
+        }
+    };
     const failAllocation = (entry, allocationError) => {
         const resourceErrors = [];
         const observerErrors = [];
@@ -255,7 +270,9 @@ export function createNativeViewRecordController(input) {
             failAllocation(entry, error);
         }
     };
+    // Governing contract: docs/specs/2026-08-29-sdk-open-request-interception.md.
     const handleActivate = (action) => {
+        var _a;
         const entry = entries.get(action.viewId);
         if (!entry ||
             entry.instanceId !== action.instanceId ||
@@ -263,6 +280,27 @@ export function createNativeViewRecordController(input) {
             failCoreConnection(new Error(`Unknown native projection binding ${action.viewId}`), "Unknown native projection binding");
             return;
         }
+        let allowed = true;
+        if (((_a = action.openRequest) === null || _a === void 0 ? void 0 : _a.flowId) && input.observeOpenRequest) {
+            const payload = Object.assign({ instanceId: action.instanceId, source: action.openRequest.source, flowId: action.openRequest.flowId }, (action.openRequest.source === "command"
+                ? {
+                    flowHandleId: action.openRequest.flowHandleId,
+                    hideCloseButton: action.openRequest.hideCloseButton,
+                }
+                : {}));
+            try {
+                allowed = input.observeOpenRequest(payload).allowed;
+            }
+            catch (error) {
+                reportError(error, "Native open request observer failed");
+            }
+        }
+        if (!postViewActivationDecision(action, allowed)) {
+            return;
+        }
+        if (!allowed) {
+            return;
+        }
         if (!entry.isActive) {
             entry.isActive = true;
             notify();

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@getuserfeedback/react-native",
-  "version": "5.3.4",
+  "version": "5.4.0",
   "description": "getuserfeedback React Native SDK",
   "keywords": [
     "getuserfeedback",
@@ -44,8 +44,8 @@
     "lint": "biome check ."
   },
   "dependencies": {
-    "@getuserfeedback/protocol": "^5.3.2",
-    "@getuserfeedback/sdk": "^0.16.1",
+    "@getuserfeedback/protocol": "^5.4.0",
+    "@getuserfeedback/sdk": "^0.16.2",
     "robot3": "^1.2.0"
   },
   "peerDependencies": {