@sendoracloud/sdk-react-native 0.18.7 → 0.18.9

package/dist/index.cjs

@@ -1646,6 +1646,13 @@ var SendoraSDK = class {
     this.debug = false;
     this.sessionId = "";
     this.autoTrackCleanup = null;
+    /**
+     * Lazy-allocated stable session id for chatbot conversations.
+     * Survives only the JS lifetime — chatbot multi-turn context lives
+     * server-side keyed on this id, so an app restart starts a fresh
+     * thread (matches web SDK's `chatbot.sessionId` cache).
+     */
+    this._chatbotSessionId = null;
   }
   /** Initialize the SDK. Must be awaited at app startup before identify/track. */
   async init(config) {
@@ -1823,7 +1830,7 @@ var SendoraSDK = class {
         throw new Error("[sendoracloud] push token metadata exceeds 4KB.");
       }
     }
-    const data = await post(
+    const res = await post(
       { apiUrl: this.config.apiUrl, publicKey: this.config.publicKey, debug: this.debug },
       "/api/v1/push/tokens",
       {
@@ -1836,6 +1843,11 @@ var SendoraSDK = class {
         metadata: reg.metadata ?? {}
       }
     );
+    if (!res || !res.ok) {
+      throw new Error(`[sendoracloud] push token registration failed (HTTP ${res?.status ?? "network"}).`);
+    }
+    const parsed = await res.json();
+    const data = parsed?.data;
     if (!data?.tokenId) {
       throw new Error("[sendoracloud] push token registered but server returned no tokenId \u2014 upgrade backend to >= s58.16.");
     }
@@ -2199,6 +2211,45 @@ var SendoraSDK = class {
       }
     };
   }
+  /**
+   * Chatbot namespace — RAG-backed AI chat over the org's knowledge
+   * base. Mirrors backend `/chatbot/message` SDK route + web SDK's
+   * `Chatbot` class.
+   *
+   * `sendMessage({ chatbotId, message })` returns the bot's reply
+   * plus citations (KB article IDs the answer was grounded in) and
+   * mode (`ai` when AI is enabled for the org, `canned` when the
+   * fallback fires). Pass a stable `sessionId` to preserve multi-turn
+   * context across calls; SDK auto-generates one per app session if
+   * omitted.
+   */
+  get chatbot() {
+    const self = this;
+    return {
+      sendMessage: async (input) => {
+        if (!self.config) throw new Error("[sendoracloud] init() must complete before chatbot.sendMessage().");
+        const body = {
+          chatbotId: input.chatbotId,
+          sessionId: input.sessionId ?? self.chatbotSessionId(),
+          message: input.message,
+          userId: input.userId ?? self.userId ?? void 0
+        };
+        const res = await post(
+          { apiUrl: self.config.apiUrl, publicKey: self.config.publicKey, debug: self.debug },
+          "/chatbot/message",
+          body
+        );
+        if (!res || !res.ok) throw new Error(`[sendoracloud] chatbot.sendMessage failed (${res?.status ?? "network"})`);
+        const parsed = await res.json();
+        if (!parsed.success || !parsed.data) throw new Error("[sendoracloud] chatbot.sendMessage: bad response");
+        return parsed.data;
+      }
+    };
+  }
+  chatbotSessionId() {
+    if (!this._chatbotSessionId) this._chatbotSessionId = `chat_${uuid().replace(/-/g, "").slice(0, 24)}`;
+    return this._chatbotSessionId;
+  }
   /**
    * Clear identity + rotate the anonymous id. Call on logout. Awaits
    * the AsyncStorage writes so a caller who kills the app immediately

package/dist/index.d.cts

@@ -1075,6 +1075,42 @@ declare class SendoraSDK {
             reason: string;
         }>>;
     };
+    /**
+     * Chatbot namespace — RAG-backed AI chat over the org's knowledge
+     * base. Mirrors backend `/chatbot/message` SDK route + web SDK's
+     * `Chatbot` class.
+     *
+     * `sendMessage({ chatbotId, message })` returns the bot's reply
+     * plus citations (KB article IDs the answer was grounded in) and
+     * mode (`ai` when AI is enabled for the org, `canned` when the
+     * fallback fires). Pass a stable `sessionId` to preserve multi-turn
+     * context across calls; SDK auto-generates one per app session if
+     * omitted.
+     */
+    get chatbot(): {
+        sendMessage: (input: {
+            chatbotId: string;
+            message: string;
+            sessionId?: string;
+            userId?: string;
+        }) => Promise<{
+            reply: string;
+            mode: "ai" | "canned" | string;
+            citations: Array<{
+                id: string;
+                title: string;
+                slug?: string;
+            }> | null;
+        }>;
+    };
+    /**
+     * Lazy-allocated stable session id for chatbot conversations.
+     * Survives only the JS lifetime — chatbot multi-turn context lives
+     * server-side keyed on this id, so an app restart starts a fresh
+     * thread (matches web SDK's `chatbot.sessionId` cache).
+     */
+    private _chatbotSessionId;
+    private chatbotSessionId;
     /**
      * Clear identity + rotate the anonymous id. Call on logout. Awaits
      * the AsyncStorage writes so a caller who kills the app immediately

package/dist/index.d.ts

@@ -1075,6 +1075,42 @@ declare class SendoraSDK {
             reason: string;
         }>>;
     };
+    /**
+     * Chatbot namespace — RAG-backed AI chat over the org's knowledge
+     * base. Mirrors backend `/chatbot/message` SDK route + web SDK's
+     * `Chatbot` class.
+     *
+     * `sendMessage({ chatbotId, message })` returns the bot's reply
+     * plus citations (KB article IDs the answer was grounded in) and
+     * mode (`ai` when AI is enabled for the org, `canned` when the
+     * fallback fires). Pass a stable `sessionId` to preserve multi-turn
+     * context across calls; SDK auto-generates one per app session if
+     * omitted.
+     */
+    get chatbot(): {
+        sendMessage: (input: {
+            chatbotId: string;
+            message: string;
+            sessionId?: string;
+            userId?: string;
+        }) => Promise<{
+            reply: string;
+            mode: "ai" | "canned" | string;
+            citations: Array<{
+                id: string;
+                title: string;
+                slug?: string;
+            }> | null;
+        }>;
+    };
+    /**
+     * Lazy-allocated stable session id for chatbot conversations.
+     * Survives only the JS lifetime — chatbot multi-turn context lives
+     * server-side keyed on this id, so an app restart starts a fresh
+     * thread (matches web SDK's `chatbot.sessionId` cache).
+     */
+    private _chatbotSessionId;
+    private chatbotSessionId;
     /**
      * Clear identity + rotate the anonymous id. Call on logout. Awaits
      * the AsyncStorage writes so a caller who kills the app immediately

package/dist/index.js

@@ -1608,6 +1608,13 @@ var SendoraSDK = class {
     this.debug = false;
     this.sessionId = "";
     this.autoTrackCleanup = null;
+    /**
+     * Lazy-allocated stable session id for chatbot conversations.
+     * Survives only the JS lifetime — chatbot multi-turn context lives
+     * server-side keyed on this id, so an app restart starts a fresh
+     * thread (matches web SDK's `chatbot.sessionId` cache).
+     */
+    this._chatbotSessionId = null;
   }
   /** Initialize the SDK. Must be awaited at app startup before identify/track. */
   async init(config) {
@@ -1785,7 +1792,7 @@ var SendoraSDK = class {
         throw new Error("[sendoracloud] push token metadata exceeds 4KB.");
       }
     }
-    const data = await post(
+    const res = await post(
       { apiUrl: this.config.apiUrl, publicKey: this.config.publicKey, debug: this.debug },
       "/api/v1/push/tokens",
       {
@@ -1798,6 +1805,11 @@ var SendoraSDK = class {
         metadata: reg.metadata ?? {}
       }
     );
+    if (!res || !res.ok) {
+      throw new Error(`[sendoracloud] push token registration failed (HTTP ${res?.status ?? "network"}).`);
+    }
+    const parsed = await res.json();
+    const data = parsed?.data;
     if (!data?.tokenId) {
       throw new Error("[sendoracloud] push token registered but server returned no tokenId \u2014 upgrade backend to >= s58.16.");
     }
@@ -2161,6 +2173,45 @@ var SendoraSDK = class {
       }
     };
   }
+  /**
+   * Chatbot namespace — RAG-backed AI chat over the org's knowledge
+   * base. Mirrors backend `/chatbot/message` SDK route + web SDK's
+   * `Chatbot` class.
+   *
+   * `sendMessage({ chatbotId, message })` returns the bot's reply
+   * plus citations (KB article IDs the answer was grounded in) and
+   * mode (`ai` when AI is enabled for the org, `canned` when the
+   * fallback fires). Pass a stable `sessionId` to preserve multi-turn
+   * context across calls; SDK auto-generates one per app session if
+   * omitted.
+   */
+  get chatbot() {
+    const self = this;
+    return {
+      sendMessage: async (input) => {
+        if (!self.config) throw new Error("[sendoracloud] init() must complete before chatbot.sendMessage().");
+        const body = {
+          chatbotId: input.chatbotId,
+          sessionId: input.sessionId ?? self.chatbotSessionId(),
+          message: input.message,
+          userId: input.userId ?? self.userId ?? void 0
+        };
+        const res = await post(
+          { apiUrl: self.config.apiUrl, publicKey: self.config.publicKey, debug: self.debug },
+          "/chatbot/message",
+          body
+        );
+        if (!res || !res.ok) throw new Error(`[sendoracloud] chatbot.sendMessage failed (${res?.status ?? "network"})`);
+        const parsed = await res.json();
+        if (!parsed.success || !parsed.data) throw new Error("[sendoracloud] chatbot.sendMessage: bad response");
+        return parsed.data;
+      }
+    };
+  }
+  chatbotSessionId() {
+    if (!this._chatbotSessionId) this._chatbotSessionId = `chat_${uuid().replace(/-/g, "").slice(0, 24)}`;
+    return this._chatbotSessionId;
+  }
   /**
    * Clear identity + rotate the anonymous id. Call on logout. Awaits
    * the AsyncStorage writes so a caller who kills the app immediately

package/package.json

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