@sendoracloud/sdk-react-native 0.18.1 → 0.18.3

package/dist/index.cjs

@@ -1935,6 +1935,91 @@ var SendoraSDK = class {
       }
     };
   }
+  /**
+   * 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;
+      }
+    };
+  }
+  /**
+   * Consent namespace — GDPR/CCPA right-to-record + right-to-erasure
+   * helpers. Mirrors backend `/consent/record` + `/consent/deletion-request`.
+   *
+   * Cookie banner / opt-in checkbox handler:
+   *   await SendoraCloud.consent.record({
+   *     purpose: "marketing",
+   *     granted: true,
+   *     email: currentUser.email,
+   *     source: "banner",
+   *   });
+   *
+   * "Delete my account" handler:
+   *   await SendoraCloud.consent.requestDeletion({
+   *     email: currentUser.email,
+   *     userId: currentUser.id,
+   *     reason: textarea.value,
+   *   });
+   *
+   * Backend enqueues a 7-day soft-delete; retention cron hard-deletes
+   * after the grace window. Records are kept forever as legal evidence.
+   */
+  get consent() {
+    const self = this;
+    return {
+      record: async (input) => {
+        if (!self.config) throw new Error("[sendoracloud] init() must complete before consent.record().");
+        const res = await post(
+          { apiUrl: self.config.apiUrl, publicKey: self.config.publicKey, debug: self.debug },
+          "/consent/record",
+          input
+        );
+        if (!res || !res.ok) throw new Error(`[sendoracloud] consent.record failed (${res?.status ?? "network"})`);
+        const parsed = await res.json();
+        if (!parsed.success || !parsed.data) throw new Error("[sendoracloud] consent.record: bad response");
+        return parsed.data;
+      },
+      requestDeletion: async (input) => {
+        if (!self.config) throw new Error("[sendoracloud] init() must complete before consent.requestDeletion().");
+        const res = await post(
+          { apiUrl: self.config.apiUrl, publicKey: self.config.publicKey, debug: self.debug },
+          "/consent/deletion-request",
+          input
+        );
+        if (!res || !res.ok) throw new Error(`[sendoracloud] consent.requestDeletion failed (${res?.status ?? "network"})`);
+        const parsed = await res.json();
+        if (!parsed.success || !parsed.data) throw new Error("[sendoracloud] consent.requestDeletion: 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

@@ -852,6 +852,88 @@ declare class SendoraSDK {
             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;
+        }>>;
+    };
+    /**
+     * Consent namespace — GDPR/CCPA right-to-record + right-to-erasure
+     * helpers. Mirrors backend `/consent/record` + `/consent/deletion-request`.
+     *
+     * Cookie banner / opt-in checkbox handler:
+     *   await SendoraCloud.consent.record({
+     *     purpose: "marketing",
+     *     granted: true,
+     *     email: currentUser.email,
+     *     source: "banner",
+     *   });
+     *
+     * "Delete my account" handler:
+     *   await SendoraCloud.consent.requestDeletion({
+     *     email: currentUser.email,
+     *     userId: currentUser.id,
+     *     reason: textarea.value,
+     *   });
+     *
+     * Backend enqueues a 7-day soft-delete; retention cron hard-deletes
+     * after the grace window. Records are kept forever as legal evidence.
+     */
+    get consent(): {
+        record: (input: {
+            purpose: "marketing" | "analytics" | "functional" | "necessary";
+            granted: boolean;
+            entityId?: string;
+            userId?: string;
+            email?: string;
+            source?: string;
+            ipHash?: string;
+        }) => Promise<{
+            id: string;
+            purpose: string;
+            granted: boolean;
+            email: string | null;
+            userId: string | null;
+            source: string | null;
+            createdAt: string;
+        }>;
+        requestDeletion: (input: {
+            entityId?: string;
+            userId?: string;
+            email?: string;
+            reason?: string;
+        }) => Promise<{
+            id: string;
+            email: string | null;
+            userId: string | null;
+            status: string;
+            reason: string | null;
+            createdAt: string;
+        }>;
+    };
     /**
      * 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

@@ -852,6 +852,88 @@ declare class SendoraSDK {
             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;
+        }>>;
+    };
+    /**
+     * Consent namespace — GDPR/CCPA right-to-record + right-to-erasure
+     * helpers. Mirrors backend `/consent/record` + `/consent/deletion-request`.
+     *
+     * Cookie banner / opt-in checkbox handler:
+     *   await SendoraCloud.consent.record({
+     *     purpose: "marketing",
+     *     granted: true,
+     *     email: currentUser.email,
+     *     source: "banner",
+     *   });
+     *
+     * "Delete my account" handler:
+     *   await SendoraCloud.consent.requestDeletion({
+     *     email: currentUser.email,
+     *     userId: currentUser.id,
+     *     reason: textarea.value,
+     *   });
+     *
+     * Backend enqueues a 7-day soft-delete; retention cron hard-deletes
+     * after the grace window. Records are kept forever as legal evidence.
+     */
+    get consent(): {
+        record: (input: {
+            purpose: "marketing" | "analytics" | "functional" | "necessary";
+            granted: boolean;
+            entityId?: string;
+            userId?: string;
+            email?: string;
+            source?: string;
+            ipHash?: string;
+        }) => Promise<{
+            id: string;
+            purpose: string;
+            granted: boolean;
+            email: string | null;
+            userId: string | null;
+            source: string | null;
+            createdAt: string;
+        }>;
+        requestDeletion: (input: {
+            entityId?: string;
+            userId?: string;
+            email?: string;
+            reason?: string;
+        }) => Promise<{
+            id: string;
+            email: string | null;
+            userId: string | null;
+            status: string;
+            reason: string | null;
+            createdAt: string;
+        }>;
+    };
     /**
      * 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

@@ -1897,6 +1897,91 @@ var SendoraSDK = class {
       }
     };
   }
+  /**
+   * 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;
+      }
+    };
+  }
+  /**
+   * Consent namespace — GDPR/CCPA right-to-record + right-to-erasure
+   * helpers. Mirrors backend `/consent/record` + `/consent/deletion-request`.
+   *
+   * Cookie banner / opt-in checkbox handler:
+   *   await SendoraCloud.consent.record({
+   *     purpose: "marketing",
+   *     granted: true,
+   *     email: currentUser.email,
+   *     source: "banner",
+   *   });
+   *
+   * "Delete my account" handler:
+   *   await SendoraCloud.consent.requestDeletion({
+   *     email: currentUser.email,
+   *     userId: currentUser.id,
+   *     reason: textarea.value,
+   *   });
+   *
+   * Backend enqueues a 7-day soft-delete; retention cron hard-deletes
+   * after the grace window. Records are kept forever as legal evidence.
+   */
+  get consent() {
+    const self = this;
+    return {
+      record: async (input) => {
+        if (!self.config) throw new Error("[sendoracloud] init() must complete before consent.record().");
+        const res = await post(
+          { apiUrl: self.config.apiUrl, publicKey: self.config.publicKey, debug: self.debug },
+          "/consent/record",
+          input
+        );
+        if (!res || !res.ok) throw new Error(`[sendoracloud] consent.record failed (${res?.status ?? "network"})`);
+        const parsed = await res.json();
+        if (!parsed.success || !parsed.data) throw new Error("[sendoracloud] consent.record: bad response");
+        return parsed.data;
+      },
+      requestDeletion: async (input) => {
+        if (!self.config) throw new Error("[sendoracloud] init() must complete before consent.requestDeletion().");
+        const res = await post(
+          { apiUrl: self.config.apiUrl, publicKey: self.config.publicKey, debug: self.debug },
+          "/consent/deletion-request",
+          input
+        );
+        if (!res || !res.ok) throw new Error(`[sendoracloud] consent.requestDeletion failed (${res?.status ?? "network"})`);
+        const parsed = await res.json();
+        if (!parsed.success || !parsed.data) throw new Error("[sendoracloud] consent.requestDeletion: 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.1",
+  "version": "0.18.3",
   "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",