@getuserfeedback/react-native 5.5.1 → 5.6.1

package/dist/client.d.ts

@@ -17,6 +17,10 @@ type HostContext = Extract<PublicCommandPayload, {
     kind: "updateHostContext";
 }>["context"];
 type CommandOptions = {
+    /**
+     * @deprecated Omit this option. The SDK owns command identity and transport
+     * correlation.
+     */
     idempotencyKey?: string;
 };
 /** A customer-defined action implemented by the React Native host app. */
@@ -24,11 +28,21 @@ export type NativeActionRegistration = Extract<ActionRegistration, {
     kind: "custom";
 }>;
 /** React Native provider initialization options. */
-export type ClientOptions = Omit<InitOptions, "capabilities" | "hostActions" | "hostCapabilities"> & {
+export type ClientOptions = Omit<InitOptions, "capabilities" | "clientMeta" | "hostActions" | "hostCapabilities" | "runtimeEndpoints"> & {
     /** Widget actions implemented by the current app version. */
     actions?: NativeActionRegistration[] | undefined;
     /** Capabilities supported by the current app version. */
     capabilities?: CapabilitiesInput | undefined;
+    /**
+     * @deprecated Omit this option. The provider stamps canonical React Native
+     * client metadata.
+     */
+    clientMeta?: InitOptions["clientMeta"];
+    /**
+     * @deprecated Internal runtime override. Application code should use the
+     * SDK's pinned runtime.
+     */
+    runtimeEndpoints?: InitOptions["runtimeEndpoints"];
 };
 /** Operations for one on-demand flow lifecycle. */
 export interface FlowRun {
@@ -49,6 +63,10 @@ export interface FlowRun {
  * @see https://getuserfeedback.com/docs/reference/react-native-sdk-reference
  */
 export interface Client {
+    /**
+     * @deprecated Runtime identity is SDK-owned. Do not persist or branch on this
+     * value.
+     */
     readonly instanceId: string;
     /**
      * Updates authentication, consent, and other client configuration.
@@ -89,8 +107,15 @@ export interface Client {
     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. */
+    /**
+     * Updates current-route and host-supplied targeting context. URL and page
+     * fields can enrich events and consent-gated telemetry; `env` and `storage`
+     * are local-targeting inputs only.
+     */
     updateHostContext: (context: HostContext, options?: CommandOptions) => Promise<void>;
-    /** Emits a named app signal into the widget runtime. */
+    /**
+     * Emits an ephemeral signal for local engagement targeting. This does not
+     * persist a customer occurrence; use `track()` or `screen()` for that.
+     */
     emitHostSignal: (name: string, data?: unknown, options?: CommandOptions) => Promise<void>;
 }

package/dist/native-provider.d.ts

@@ -23,7 +23,10 @@ export type GetUserFeedbackProviderProps = {
     children?: ReactNode;
     /** Public API key and initialization options for this client. */
     clientOptions: ClientOptions;
-    /** Stable instance identifier. Most apps should let the provider create one. */
+    /**
+     * @deprecated Omit this prop. The provider owns runtime identity and creates
+     * a stable identifier for its mounted lifetime.
+     */
     instanceId?: string;
     /** Receives runtime and command errors. */
     onError?: (error: Error) => void;

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@getuserfeedback/react-native",
-  "version": "5.5.1",
+  "version": "5.6.1",
   "description": "getuserfeedback React Native SDK",
   "keywords": [
     "getuserfeedback",