@sendoracloud/sdk-react-native 1.2.0 → 1.4.0

package/dist/contact-widget.cjs

@@ -31,7 +31,9 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var contact_widget_exports = {};
 __export(contact_widget_exports, {
   ContactWidget: () => ContactWidget,
-  useContactWidget: () => useContactWidget
+  TicketHistory: () => TicketHistory,
+  useContactWidget: () => useContactWidget,
+  useTicketHistory: () => useTicketHistory
 });
 module.exports = __toCommonJS(contact_widget_exports);
 var React = __toESM(require("react"), 1);
@@ -45,6 +47,8 @@ function ContactWidget({
   theme = "auto",
   prefillName,
   prefillEmail,
+  prefillUserId,
+  lockEmail,
   onClose
 }) {
   const didFire = React.useRef(false);
@@ -55,6 +59,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,25 +109,114 @@ 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 };
 }
+function TicketHistory({
+  visible,
+  widgetId,
+  accessToken,
+  workerHost = "https://go.sendoracloud.com",
+  theme = "auto",
+  onClose
+}) {
+  const didFire = React.useRef(false);
+  React.useEffect(() => {
+    if (visible) didFire.current = false;
+  }, [visible]);
+  if (!widgetId || !accessToken) return null;
+  const params = new URLSearchParams({ widgetId, theme });
+  const uri = `${workerHost}/embed/tickets?${params.toString()}#access=${encodeURIComponent(accessToken)}`;
+  const handleClose = (result) => {
+    if (didFire.current) return;
+    didFire.current = true;
+    onClose(result);
+  };
+  const onNav = (req) => {
+    const url = req.url || "";
+    if (url.startsWith("sendora://close")) {
+      handleClose({ ticketId: "", portalUrl: null, submitted: false });
+      return false;
+    }
+    if (!url.startsWith("https://") && !url.startsWith("about:")) return false;
+    return true;
+  };
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+    import_react_native.Modal,
+    {
+      visible,
+      animationType: "slide",
+      presentationStyle: "pageSheet",
+      onRequestClose: () => handleClose({ ticketId: "", portalUrl: null, submitted: false }),
+      children: /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_react_native.View, { style: { flex: 1 }, children: /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+        import_react_native_webview.WebView,
+        {
+          source: { uri },
+          onShouldStartLoadWithRequest: onNav,
+          originWhitelist: ["https://*", "about:*", "sendora://*"],
+          setSupportMultipleWindows: false,
+          javaScriptEnabled: true,
+          domStorageEnabled: true,
+          allowsBackForwardNavigationGestures: false
+        }
+      ) })
+    }
+  );
+}
+function useTicketHistory(widgetId, getAccessToken, defaults) {
+  const [visible, setVisible] = React.useState(false);
+  const [token, setToken] = React.useState(null);
+  const open = React.useCallback(async () => {
+    const t = await getAccessToken();
+    if (!t) return;
+    setToken(t);
+    setVisible(true);
+  }, [getAccessToken]);
+  const close = React.useCallback(() => setVisible(false), []);
+  const View2 = React.useCallback(
+    () => /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+      TicketHistory,
+      {
+        widgetId,
+        visible,
+        accessToken: token,
+        workerHost: defaults?.workerHost,
+        theme: defaults?.theme,
+        onClose: () => setVisible(false)
+      }
+    ),
+    [widgetId, visible, token, defaults]
+  );
+  return { open, close, View: View2 };
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   ContactWidget,
-  useContactWidget
+  TicketHistory,
+  useContactWidget,
+  useTicketHistory
 });

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,12 +73,66 @@ 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;
     lastResult: ContactWidgetResult | null;
 };
+interface TicketHistoryProps {
+    /** Whether the modal sheet is visible. */
+    visible: boolean;
+    /** Widget UUID that scopes the org. */
+    widgetId: string;
+    /**
+     * Current SDK access token (from `SendoraCloud.auth.getAccessToken()`).
+     * Passed in the URL hash fragment so it never appears in server
+     * logs / referer headers. Embed scrubs the hash on load.
+     * The widget is no-op when this is null/empty.
+     */
+    accessToken: string | null | undefined;
+    workerHost?: string;
+    theme?: "auto" | "light" | "dark";
+    onClose: (result: ContactWidgetResult) => void;
+}
+declare function TicketHistory({ visible, widgetId, accessToken, workerHost, theme, onClose, }: TicketHistoryProps): React.ReactElement | null;
+/**
+ * Convenience hook for the ticket history view. Takes the SDK's
+ * `getAccessToken` helper (deferred — called lazily on open) so the
+ * host doesn't have to thread token state by hand.
+ *
+ *   import SendoraCloud from "@sendoracloud/sdk-react-native";
+ *   const history = useTicketHistory("widget-uuid", () => SendoraCloud.auth.getAccessToken());
+ *   <Button onPress={history.open} title="My tickets" />
+ *   <history.View />
+ */
+declare function useTicketHistory(widgetId: string, getAccessToken: () => Promise<string | null>, defaults?: {
+    workerHost?: string;
+    theme?: "auto" | "light" | "dark";
+}): {
+    open: () => void;
+    close: () => void;
+    View: () => React.ReactElement | null;
+};
 
-export { ContactWidget, type ContactWidgetProps, type ContactWidgetResult, useContactWidget };
+export { ContactWidget, type ContactWidgetProps, type ContactWidgetResult, TicketHistory, type TicketHistoryProps, useContactWidget, useTicketHistory };

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,12 +73,66 @@ 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;
     lastResult: ContactWidgetResult | null;
 };
+interface TicketHistoryProps {
+    /** Whether the modal sheet is visible. */
+    visible: boolean;
+    /** Widget UUID that scopes the org. */
+    widgetId: string;
+    /**
+     * Current SDK access token (from `SendoraCloud.auth.getAccessToken()`).
+     * Passed in the URL hash fragment so it never appears in server
+     * logs / referer headers. Embed scrubs the hash on load.
+     * The widget is no-op when this is null/empty.
+     */
+    accessToken: string | null | undefined;
+    workerHost?: string;
+    theme?: "auto" | "light" | "dark";
+    onClose: (result: ContactWidgetResult) => void;
+}
+declare function TicketHistory({ visible, widgetId, accessToken, workerHost, theme, onClose, }: TicketHistoryProps): React.ReactElement | null;
+/**
+ * Convenience hook for the ticket history view. Takes the SDK's
+ * `getAccessToken` helper (deferred — called lazily on open) so the
+ * host doesn't have to thread token state by hand.
+ *
+ *   import SendoraCloud from "@sendoracloud/sdk-react-native";
+ *   const history = useTicketHistory("widget-uuid", () => SendoraCloud.auth.getAccessToken());
+ *   <Button onPress={history.open} title="My tickets" />
+ *   <history.View />
+ */
+declare function useTicketHistory(widgetId: string, getAccessToken: () => Promise<string | null>, defaults?: {
+    workerHost?: string;
+    theme?: "auto" | "light" | "dark";
+}): {
+    open: () => void;
+    close: () => void;
+    View: () => React.ReactElement | null;
+};
 
-export { ContactWidget, type ContactWidgetProps, type ContactWidgetResult, useContactWidget };
+export { ContactWidget, type ContactWidgetProps, type ContactWidgetResult, TicketHistory, type TicketHistoryProps, useContactWidget, useTicketHistory };

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,24 +72,113 @@ 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 };
 }
+function TicketHistory({
+  visible,
+  widgetId,
+  accessToken,
+  workerHost = "https://go.sendoracloud.com",
+  theme = "auto",
+  onClose
+}) {
+  const didFire = React.useRef(false);
+  React.useEffect(() => {
+    if (visible) didFire.current = false;
+  }, [visible]);
+  if (!widgetId || !accessToken) return null;
+  const params = new URLSearchParams({ widgetId, theme });
+  const uri = `${workerHost}/embed/tickets?${params.toString()}#access=${encodeURIComponent(accessToken)}`;
+  const handleClose = (result) => {
+    if (didFire.current) return;
+    didFire.current = true;
+    onClose(result);
+  };
+  const onNav = (req) => {
+    const url = req.url || "";
+    if (url.startsWith("sendora://close")) {
+      handleClose({ ticketId: "", portalUrl: null, submitted: false });
+      return false;
+    }
+    if (!url.startsWith("https://") && !url.startsWith("about:")) return false;
+    return true;
+  };
+  return /* @__PURE__ */ jsx(
+    Modal,
+    {
+      visible,
+      animationType: "slide",
+      presentationStyle: "pageSheet",
+      onRequestClose: () => handleClose({ ticketId: "", portalUrl: null, submitted: false }),
+      children: /* @__PURE__ */ jsx(View, { style: { flex: 1 }, children: /* @__PURE__ */ jsx(
+        WebView,
+        {
+          source: { uri },
+          onShouldStartLoadWithRequest: onNav,
+          originWhitelist: ["https://*", "about:*", "sendora://*"],
+          setSupportMultipleWindows: false,
+          javaScriptEnabled: true,
+          domStorageEnabled: true,
+          allowsBackForwardNavigationGestures: false
+        }
+      ) })
+    }
+  );
+}
+function useTicketHistory(widgetId, getAccessToken, defaults) {
+  const [visible, setVisible] = React.useState(false);
+  const [token, setToken] = React.useState(null);
+  const open = React.useCallback(async () => {
+    const t = await getAccessToken();
+    if (!t) return;
+    setToken(t);
+    setVisible(true);
+  }, [getAccessToken]);
+  const close = React.useCallback(() => setVisible(false), []);
+  const View2 = React.useCallback(
+    () => /* @__PURE__ */ jsx(
+      TicketHistory,
+      {
+        widgetId,
+        visible,
+        accessToken: token,
+        workerHost: defaults?.workerHost,
+        theme: defaults?.theme,
+        onClose: () => setVisible(false)
+      }
+    ),
+    [widgetId, visible, token, defaults]
+  );
+  return { open, close, View: View2 };
+}
 export {
   ContactWidget,
-  useContactWidget
+  TicketHistory,
+  useContactWidget,
+  useTicketHistory
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sendoracloud/sdk-react-native",
-  "version": "1.2.0",
+  "version": "1.4.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",