@sendoracloud/sdk-react-native 1.2.0 → 1.3.0

package/dist/contact-widget.cjs

@@ -45,6 +45,8 @@ function ContactWidget({
   theme = "auto",
   prefillName,
   prefillEmail,
+  prefillUserId,
+  lockEmail,
   onClose
 }) {
   const didFire = React.useRef(false);
@@ -55,6 +57,8 @@ function ContactWidget({
   const params = new URLSearchParams({ widgetId, theme });
   if (prefillName) params.set("prefillName", prefillName);
   if (prefillEmail) params.set("prefillEmail", prefillEmail);
+  if (prefillUserId) params.set("prefillUserId", prefillUserId);
+  if (lockEmail && prefillEmail) params.set("lockEmail", "1");
   const uri = `${workerHost}/embed/contact?${params.toString()}`;
   const handleClose = (result) => {
     if (didFire.current) return;
@@ -103,20 +107,30 @@ function useContactWidget(widgetId, defaults) {
   const [lastResult, setLastResult] = React.useState(null);
   const open = React.useCallback(() => setVisible(true), []);
   const close = React.useCallback(() => setVisible(false), []);
+  const sdkUser = defaults?.user ?? null;
+  const resolvedName = defaults?.prefillName ?? sdkUser?.name ?? void 0;
+  const resolvedEmail = defaults?.prefillEmail ?? sdkUser?.email ?? void 0;
+  const resolvedUserId = defaults?.prefillUserId ?? sdkUser?.id ?? void 0;
+  const resolvedLockEmail = defaults?.lockEmail ?? (sdkUser != null && sdkUser.email != null && sdkUser.emailVerified && !sdkUser.isAnonymous);
   const View2 = React.useCallback(
     () => /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
       ContactWidget,
       {
-        ...defaults,
+        workerHost: defaults?.workerHost,
+        theme: defaults?.theme,
         widgetId,
         visible,
+        prefillName: resolvedName,
+        prefillEmail: resolvedEmail,
+        prefillUserId: resolvedUserId,
+        lockEmail: resolvedLockEmail,
         onClose: (r) => {
           setLastResult(r);
           setVisible(false);
         }
       }
     ),
-    [defaults, widgetId, visible]
+    [defaults, widgetId, visible, resolvedName, resolvedEmail, resolvedUserId, resolvedLockEmail]
   );
   return { open, close, View: View2, lastResult };
 }

package/dist/contact-widget.d.cts

@@ -44,6 +44,20 @@ interface ContactWidgetProps {
     prefillName?: string;
     /** Pre-fill email field for signed-in users. */
     prefillEmail?: string;
+    /**
+     * Wave 68 — stitch the ticket to the same profile as analytics
+     * events. Pass the signed-in user's id (anon or identified). Hint
+     * only, not an auth boundary — backend stores it without verifying
+     * because the WebView is in customer-app code.
+     */
+    prefillUserId?: string;
+    /**
+     * When true (and `prefillEmail` is set) the email field is hidden +
+     * read-only. Use for identified users so the agent inbox can trust
+     * the email field came from the customer's verified account, not
+     * free text.
+     */
+    lockEmail?: boolean;
     /**
      * Fired when the user closes the sheet — either after a successful
      * submit (`submitted = true`) or via the close button
@@ -51,7 +65,7 @@ interface ContactWidgetProps {
      */
     onClose: (result: ContactWidgetResult) => void;
 }
-declare function ContactWidget({ visible, widgetId, workerHost, theme, prefillName, prefillEmail, onClose, }: ContactWidgetProps): React.ReactElement | null;
+declare function ContactWidget({ visible, widgetId, workerHost, theme, prefillName, prefillEmail, prefillUserId, lockEmail, onClose, }: ContactWidgetProps): React.ReactElement | null;
 /**
  * Helper hook so the host doesn't have to wire visibility state by
  * hand.
@@ -59,8 +73,27 @@ declare function ContactWidget({ visible, widgetId, workerHost, theme, prefillNa
  *   const contact = useContactWidget("widget-uuid");
  *   <Button onPress={contact.open} title="Contact us" />
  *   <contact.View />
+ *
+ * Auto-resolves identity from the SDK when the host passes the
+ * current `AuthUser` via the `user` default. Identified users get the
+ * locked-email mode + userId attached automatically. Anonymous SDK
+ * rows get the userId attached without locking. No user = standard
+ * form.
+ *
+ *   import SendoraCloud from "@sendoracloud/sdk-react-native";
+ *   const user = SendoraCloud.auth.getCurrentUser();
+ *   const contact = useContactWidget("widget-uuid", { user });
  */
-declare function useContactWidget(widgetId: string, defaults?: Omit<ContactWidgetProps, "visible" | "widgetId" | "onClose">): {
+declare function useContactWidget(widgetId: string, defaults?: Omit<ContactWidgetProps, "visible" | "widgetId" | "onClose"> & {
+    /** Pass `SendoraCloud.auth.getCurrentUser()` here to auto-stitch identity. */
+    user?: {
+        id: string;
+        email: string | null;
+        emailVerified: boolean;
+        name: string | null;
+        isAnonymous: boolean;
+    } | null;
+}): {
     open: () => void;
     close: () => void;
     View: () => React.ReactElement | null;

package/dist/contact-widget.d.ts

@@ -44,6 +44,20 @@ interface ContactWidgetProps {
     prefillName?: string;
     /** Pre-fill email field for signed-in users. */
     prefillEmail?: string;
+    /**
+     * Wave 68 — stitch the ticket to the same profile as analytics
+     * events. Pass the signed-in user's id (anon or identified). Hint
+     * only, not an auth boundary — backend stores it without verifying
+     * because the WebView is in customer-app code.
+     */
+    prefillUserId?: string;
+    /**
+     * When true (and `prefillEmail` is set) the email field is hidden +
+     * read-only. Use for identified users so the agent inbox can trust
+     * the email field came from the customer's verified account, not
+     * free text.
+     */
+    lockEmail?: boolean;
     /**
      * Fired when the user closes the sheet — either after a successful
      * submit (`submitted = true`) or via the close button
@@ -51,7 +65,7 @@ interface ContactWidgetProps {
      */
     onClose: (result: ContactWidgetResult) => void;
 }
-declare function ContactWidget({ visible, widgetId, workerHost, theme, prefillName, prefillEmail, onClose, }: ContactWidgetProps): React.ReactElement | null;
+declare function ContactWidget({ visible, widgetId, workerHost, theme, prefillName, prefillEmail, prefillUserId, lockEmail, onClose, }: ContactWidgetProps): React.ReactElement | null;
 /**
  * Helper hook so the host doesn't have to wire visibility state by
  * hand.
@@ -59,8 +73,27 @@ declare function ContactWidget({ visible, widgetId, workerHost, theme, prefillNa
  *   const contact = useContactWidget("widget-uuid");
  *   <Button onPress={contact.open} title="Contact us" />
  *   <contact.View />
+ *
+ * Auto-resolves identity from the SDK when the host passes the
+ * current `AuthUser` via the `user` default. Identified users get the
+ * locked-email mode + userId attached automatically. Anonymous SDK
+ * rows get the userId attached without locking. No user = standard
+ * form.
+ *
+ *   import SendoraCloud from "@sendoracloud/sdk-react-native";
+ *   const user = SendoraCloud.auth.getCurrentUser();
+ *   const contact = useContactWidget("widget-uuid", { user });
  */
-declare function useContactWidget(widgetId: string, defaults?: Omit<ContactWidgetProps, "visible" | "widgetId" | "onClose">): {
+declare function useContactWidget(widgetId: string, defaults?: Omit<ContactWidgetProps, "visible" | "widgetId" | "onClose"> & {
+    /** Pass `SendoraCloud.auth.getCurrentUser()` here to auto-stitch identity. */
+    user?: {
+        id: string;
+        email: string | null;
+        emailVerified: boolean;
+        name: string | null;
+        isAnonymous: boolean;
+    } | null;
+}): {
     open: () => void;
     close: () => void;
     View: () => React.ReactElement | null;

package/dist/contact-widget.js

@@ -10,6 +10,8 @@ function ContactWidget({
   theme = "auto",
   prefillName,
   prefillEmail,
+  prefillUserId,
+  lockEmail,
   onClose
 }) {
   const didFire = React.useRef(false);
@@ -20,6 +22,8 @@ function ContactWidget({
   const params = new URLSearchParams({ widgetId, theme });
   if (prefillName) params.set("prefillName", prefillName);
   if (prefillEmail) params.set("prefillEmail", prefillEmail);
+  if (prefillUserId) params.set("prefillUserId", prefillUserId);
+  if (lockEmail && prefillEmail) params.set("lockEmail", "1");
   const uri = `${workerHost}/embed/contact?${params.toString()}`;
   const handleClose = (result) => {
     if (didFire.current) return;
@@ -68,20 +72,30 @@ function useContactWidget(widgetId, defaults) {
   const [lastResult, setLastResult] = React.useState(null);
   const open = React.useCallback(() => setVisible(true), []);
   const close = React.useCallback(() => setVisible(false), []);
+  const sdkUser = defaults?.user ?? null;
+  const resolvedName = defaults?.prefillName ?? sdkUser?.name ?? void 0;
+  const resolvedEmail = defaults?.prefillEmail ?? sdkUser?.email ?? void 0;
+  const resolvedUserId = defaults?.prefillUserId ?? sdkUser?.id ?? void 0;
+  const resolvedLockEmail = defaults?.lockEmail ?? (sdkUser != null && sdkUser.email != null && sdkUser.emailVerified && !sdkUser.isAnonymous);
   const View2 = React.useCallback(
     () => /* @__PURE__ */ jsx(
       ContactWidget,
       {
-        ...defaults,
+        workerHost: defaults?.workerHost,
+        theme: defaults?.theme,
         widgetId,
         visible,
+        prefillName: resolvedName,
+        prefillEmail: resolvedEmail,
+        prefillUserId: resolvedUserId,
+        lockEmail: resolvedLockEmail,
         onClose: (r) => {
           setLastResult(r);
           setVisible(false);
         }
       }
     ),
-    [defaults, widgetId, visible]
+    [defaults, widgetId, visible, resolvedName, resolvedEmail, resolvedUserId, resolvedLockEmail]
   );
   return { open, close, View: View2, lastResult };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sendoracloud/sdk-react-native",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "description": "Sendora Cloud React Native + Expo SDK — analytics, identity, push-token registration, auth, deep links (Branch / Firebase Dynamic Links parity). Auth + analytics + deep links work in Expo Go; push token registration requires a Dev Client (EAS Build or `npx expo prebuild`).",
   "type": "module",
   "main": "./dist/index.cjs",