@sendoracloud/sdk-react-native 0.18.0 → 0.18.2

package/dist/index.cjs

@@ -1889,6 +1889,86 @@ var SendoraSDK = class {
       }
     };
   }
+  /**
+   * Support namespace — in-app "Contact support" + post-resolution
+   * CSAT rating. Mirrors backend `/support/{tickets,csat}` SDK routes.
+   *
+   * Apps with an in-product help widget call:
+   *   const t = await SendoraCloud.support.createTicket({
+   *     subject, body, priority: "high",
+   *     email: currentUser.email, userId: currentUser.id,
+   *   });
+   *   // Surface t.portalUrl to the user so they can reply without
+   *   // signing into Sendora (signed-token access).
+   *
+   * After ticket resolution, prompt for a 1-5 rating + comment:
+   *   await SendoraCloud.support.submitCsat({
+   *     ticketId, rating: 5, comment: "Quick fix, thanks!",
+   *   });
+   */
+  get support() {
+    const self = this;
+    return {
+      createTicket: async (input) => {
+        if (!self.config) throw new Error("[sendoracloud] init() must complete before support.createTicket().");
+        const res = await post(
+          { apiUrl: self.config.apiUrl, publicKey: self.config.publicKey, debug: self.debug },
+          "/support/tickets",
+          input
+        );
+        if (!res || !res.ok) throw new Error(`[sendoracloud] support.createTicket failed (${res?.status ?? "network"})`);
+        const parsed = await res.json();
+        if (!parsed.success || !parsed.data) throw new Error("[sendoracloud] support.createTicket: bad response");
+        return parsed.data;
+      },
+      submitCsat: async (input) => {
+        if (!self.config) throw new Error("[sendoracloud] init() must complete before support.submitCsat().");
+        const res = await post(
+          { apiUrl: self.config.apiUrl, publicKey: self.config.publicKey, debug: self.debug },
+          "/support/csat",
+          input
+        );
+        if (!res || !res.ok) throw new Error(`[sendoracloud] support.submitCsat failed (${res?.status ?? "network"})`);
+        const parsed = await res.json();
+        if (!parsed.success || !parsed.data) throw new Error("[sendoracloud] support.submitCsat: bad response");
+        return parsed.data;
+      }
+    };
+  }
+  /**
+   * Knowledge-base search namespace. Mirrors backend `GET /kb/search`
+   * (API-key auth, results filtered to `status=published`). Returns
+   * an array of articles whose title matches the query (case-insensitive
+   * substring); empty array on no match.
+   *
+   * Typical in-app help-search use:
+   *   const hits = await SendoraCloud.kb.search({ query: "reset password" });
+   *   renderResults(hits);
+   *
+   * Limit defaults to 10 server-side; caller can request 1-50.
+   */
+  get kb() {
+    const self = this;
+    return {
+      search: async (input) => {
+        if (!self.config) throw new Error("[sendoracloud] init() must complete before kb.search().");
+        if (!input.query || input.query.trim().length === 0) return [];
+        const params = new URLSearchParams({ query: input.query });
+        if (input.limit) params.set("limit", String(input.limit));
+        const url = `${self.config.apiUrl}/api/v1/kb/search?${params.toString()}`;
+        const res = await fetch(url, {
+          method: "GET",
+          headers: { "x-api-key": self.config.publicKey }
+        });
+        if (!res.ok) throw new Error(`[sendoracloud] kb.search failed (${res.status})`);
+        const parsed = await res.json();
+        if (!parsed.success || !Array.isArray(parsed.data)) {
+          throw new Error("[sendoracloud] kb.search: bad response");
+        }
+        return parsed.data;
+      }
+    };
+  }
   /**
    * 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

@@ -808,6 +808,78 @@ declare class SendoraSDK {
             deepLinkPath?: string;
         } | null>;
     };
+    /**
+     * Support namespace — in-app "Contact support" + post-resolution
+     * CSAT rating. Mirrors backend `/support/{tickets,csat}` SDK routes.
+     *
+     * Apps with an in-product help widget call:
+     *   const t = await SendoraCloud.support.createTicket({
+     *     subject, body, priority: "high",
+     *     email: currentUser.email, userId: currentUser.id,
+     *   });
+     *   // Surface t.portalUrl to the user so they can reply without
+     *   // signing into Sendora (signed-token access).
+     *
+     * After ticket resolution, prompt for a 1-5 rating + comment:
+     *   await SendoraCloud.support.submitCsat({
+     *     ticketId, rating: 5, comment: "Quick fix, thanks!",
+     *   });
+     */
+    get support(): {
+        createTicket: (input: {
+            subject: string;
+            body: string;
+            priority?: "low" | "normal" | "high" | "urgent";
+            category?: string;
+            email?: string;
+            userId?: string;
+            metadata?: Record<string, unknown>;
+        }) => Promise<{
+            id: string;
+            subject: string;
+            status: string;
+            priority: string;
+            portalToken: string;
+            portalUrl: string;
+        }>;
+        submitCsat: (input: {
+            ticketId: string;
+            rating: 1 | 2 | 3 | 4 | 5;
+            comment?: string;
+        }) => Promise<{
+            id: string;
+            rating: number;
+            comment: string | null;
+        }>;
+    };
+    /**
+     * Knowledge-base search namespace. Mirrors backend `GET /kb/search`
+     * (API-key auth, results filtered to `status=published`). Returns
+     * an array of articles whose title matches the query (case-insensitive
+     * substring); empty array on no match.
+     *
+     * Typical in-app help-search use:
+     *   const hits = await SendoraCloud.kb.search({ query: "reset password" });
+     *   renderResults(hits);
+     *
+     * Limit defaults to 10 server-side; caller can request 1-50.
+     */
+    get kb(): {
+        search: (input: {
+            query: string;
+            limit?: number;
+        }) => Promise<Array<{
+            id: string;
+            title: string;
+            slug: string;
+            body: string;
+            categoryId: string | null;
+            status: string;
+            tags: string[] | null;
+            views: number;
+            helpfulCount: number;
+        }>>;
+    };
     /**
      * 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

@@ -808,6 +808,78 @@ declare class SendoraSDK {
             deepLinkPath?: string;
         } | null>;
     };
+    /**
+     * Support namespace — in-app "Contact support" + post-resolution
+     * CSAT rating. Mirrors backend `/support/{tickets,csat}` SDK routes.
+     *
+     * Apps with an in-product help widget call:
+     *   const t = await SendoraCloud.support.createTicket({
+     *     subject, body, priority: "high",
+     *     email: currentUser.email, userId: currentUser.id,
+     *   });
+     *   // Surface t.portalUrl to the user so they can reply without
+     *   // signing into Sendora (signed-token access).
+     *
+     * After ticket resolution, prompt for a 1-5 rating + comment:
+     *   await SendoraCloud.support.submitCsat({
+     *     ticketId, rating: 5, comment: "Quick fix, thanks!",
+     *   });
+     */
+    get support(): {
+        createTicket: (input: {
+            subject: string;
+            body: string;
+            priority?: "low" | "normal" | "high" | "urgent";
+            category?: string;
+            email?: string;
+            userId?: string;
+            metadata?: Record<string, unknown>;
+        }) => Promise<{
+            id: string;
+            subject: string;
+            status: string;
+            priority: string;
+            portalToken: string;
+            portalUrl: string;
+        }>;
+        submitCsat: (input: {
+            ticketId: string;
+            rating: 1 | 2 | 3 | 4 | 5;
+            comment?: string;
+        }) => Promise<{
+            id: string;
+            rating: number;
+            comment: string | null;
+        }>;
+    };
+    /**
+     * Knowledge-base search namespace. Mirrors backend `GET /kb/search`
+     * (API-key auth, results filtered to `status=published`). Returns
+     * an array of articles whose title matches the query (case-insensitive
+     * substring); empty array on no match.
+     *
+     * Typical in-app help-search use:
+     *   const hits = await SendoraCloud.kb.search({ query: "reset password" });
+     *   renderResults(hits);
+     *
+     * Limit defaults to 10 server-side; caller can request 1-50.
+     */
+    get kb(): {
+        search: (input: {
+            query: string;
+            limit?: number;
+        }) => Promise<Array<{
+            id: string;
+            title: string;
+            slug: string;
+            body: string;
+            categoryId: string | null;
+            status: string;
+            tags: string[] | null;
+            views: number;
+            helpfulCount: number;
+        }>>;
+    };
     /**
      * 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

@@ -1851,6 +1851,86 @@ var SendoraSDK = class {
       }
     };
   }
+  /**
+   * Support namespace — in-app "Contact support" + post-resolution
+   * CSAT rating. Mirrors backend `/support/{tickets,csat}` SDK routes.
+   *
+   * Apps with an in-product help widget call:
+   *   const t = await SendoraCloud.support.createTicket({
+   *     subject, body, priority: "high",
+   *     email: currentUser.email, userId: currentUser.id,
+   *   });
+   *   // Surface t.portalUrl to the user so they can reply without
+   *   // signing into Sendora (signed-token access).
+   *
+   * After ticket resolution, prompt for a 1-5 rating + comment:
+   *   await SendoraCloud.support.submitCsat({
+   *     ticketId, rating: 5, comment: "Quick fix, thanks!",
+   *   });
+   */
+  get support() {
+    const self = this;
+    return {
+      createTicket: async (input) => {
+        if (!self.config) throw new Error("[sendoracloud] init() must complete before support.createTicket().");
+        const res = await post(
+          { apiUrl: self.config.apiUrl, publicKey: self.config.publicKey, debug: self.debug },
+          "/support/tickets",
+          input
+        );
+        if (!res || !res.ok) throw new Error(`[sendoracloud] support.createTicket failed (${res?.status ?? "network"})`);
+        const parsed = await res.json();
+        if (!parsed.success || !parsed.data) throw new Error("[sendoracloud] support.createTicket: bad response");
+        return parsed.data;
+      },
+      submitCsat: async (input) => {
+        if (!self.config) throw new Error("[sendoracloud] init() must complete before support.submitCsat().");
+        const res = await post(
+          { apiUrl: self.config.apiUrl, publicKey: self.config.publicKey, debug: self.debug },
+          "/support/csat",
+          input
+        );
+        if (!res || !res.ok) throw new Error(`[sendoracloud] support.submitCsat failed (${res?.status ?? "network"})`);
+        const parsed = await res.json();
+        if (!parsed.success || !parsed.data) throw new Error("[sendoracloud] support.submitCsat: bad response");
+        return parsed.data;
+      }
+    };
+  }
+  /**
+   * Knowledge-base search namespace. Mirrors backend `GET /kb/search`
+   * (API-key auth, results filtered to `status=published`). Returns
+   * an array of articles whose title matches the query (case-insensitive
+   * substring); empty array on no match.
+   *
+   * Typical in-app help-search use:
+   *   const hits = await SendoraCloud.kb.search({ query: "reset password" });
+   *   renderResults(hits);
+   *
+   * Limit defaults to 10 server-side; caller can request 1-50.
+   */
+  get kb() {
+    const self = this;
+    return {
+      search: async (input) => {
+        if (!self.config) throw new Error("[sendoracloud] init() must complete before kb.search().");
+        if (!input.query || input.query.trim().length === 0) return [];
+        const params = new URLSearchParams({ query: input.query });
+        if (input.limit) params.set("limit", String(input.limit));
+        const url = `${self.config.apiUrl}/api/v1/kb/search?${params.toString()}`;
+        const res = await fetch(url, {
+          method: "GET",
+          headers: { "x-api-key": self.config.publicKey }
+        });
+        if (!res.ok) throw new Error(`[sendoracloud] kb.search failed (${res.status})`);
+        const parsed = await res.json();
+        if (!parsed.success || !Array.isArray(parsed.data)) {
+          throw new Error("[sendoracloud] kb.search: bad response");
+        }
+        return parsed.data;
+      }
+    };
+  }
   /**
    * 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.0",
+  "version": "0.18.2",
   "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",