@sendoracloud/sdk-react-native 0.18.5 → 0.18.7

package/dist/index.cjs

@@ -2094,6 +2094,111 @@ var SendoraSDK = class {
       }
     };
   }
+  /**
+   * In-app messaging namespace — fetch active messages (modals,
+   * banners, slideouts, tooltips) targeted at this user + record
+   * impressions (shown / clicked / dismissed) so the dashboard's
+   * "shown N times" caps and CTR analytics work. Mirrors backend
+   * `/in-app-messages/{active,impressions}` SDK routes and the web
+   * SDK's `InAppMessaging` class.
+   *
+   * Typical use:
+   *   const msgs = await SendoraCloud.messages.fetchActive();
+   *   for (const m of msgs) renderMessage(m);
+   *   // when user sees it:
+   *   await SendoraCloud.messages.recordImpression({ messageId: m.id, action: "shown" });
+   *   // when user clicks CTA:
+   *   await SendoraCloud.messages.recordImpression({ messageId: m.id, action: "clicked" });
+   *
+   * `action` is a free-form string; "shown" / "clicked" / "dismissed"
+   * are the canonical set the dashboard graphs from.
+   */
+  get messages() {
+    const self = this;
+    return {
+      fetchActive: async () => {
+        if (!self.config) throw new Error("[sendoracloud] init() must complete before messages.fetchActive().");
+        const url = `${self.config.apiUrl}/api/v1/in-app-messages/active`;
+        const res = await fetch(url, {
+          method: "GET",
+          headers: { "x-api-key": self.config.publicKey }
+        });
+        if (!res.ok) throw new Error(`[sendoracloud] messages.fetchActive failed (${res.status})`);
+        const parsed = await res.json();
+        if (!parsed.success || !Array.isArray(parsed.data)) {
+          throw new Error("[sendoracloud] messages.fetchActive: bad response");
+        }
+        return parsed.data;
+      },
+      recordImpression: async (input) => {
+        if (!self.config) throw new Error("[sendoracloud] init() must complete before messages.recordImpression().");
+        const res = await post(
+          { apiUrl: self.config.apiUrl, publicKey: self.config.publicKey, debug: self.debug },
+          "/in-app-messages/impressions",
+          input
+        );
+        if (!res || !res.ok) throw new Error(`[sendoracloud] messages.recordImpression failed (${res?.status ?? "network"})`);
+      }
+    };
+  }
+  /**
+   * Feature-flags namespace — per-user evaluation against percentage
+   * rollouts + audience targeting. Mirrors backend
+   * `/feature-flags/{evaluate,evaluate-all}` SDK routes and the web
+   * SDK's `FeatureFlags` class.
+   *
+   * `evaluate(key)` returns the resolved value (boolean / string /
+   * number / variant payload) for a single flag — use when you only
+   * need one specific flag in a code path.
+   *
+   * `evaluateAll()` returns the full flag map in one round-trip —
+   * call once on app startup or screen mount, then read from the
+   * map locally. Avoids N+1.
+   *
+   * Both methods auto-thread `userId` (from `identify()`) when not
+   * passed. `entityId` is for entity-scoped flags (org / team /
+   * device-cohort); typically omitted in mobile apps.
+   */
+  get flags() {
+    const self = this;
+    return {
+      evaluate: async (input) => {
+        if (!self.config) throw new Error("[sendoracloud] init() must complete before flags.evaluate().");
+        const body = {
+          key: input.key,
+          userId: input.userId ?? self.userId ?? void 0,
+          entityId: input.entityId,
+          environment: input.environment
+        };
+        const res = await post(
+          { apiUrl: self.config.apiUrl, publicKey: self.config.publicKey, debug: self.debug },
+          "/feature-flags/evaluate",
+          body
+        );
+        if (!res || !res.ok) throw new Error(`[sendoracloud] flags.evaluate failed (${res?.status ?? "network"})`);
+        const parsed = await res.json();
+        if (!parsed.success || !parsed.data) throw new Error("[sendoracloud] flags.evaluate: bad response");
+        return parsed.data;
+      },
+      evaluateAll: async (input) => {
+        if (!self.config) throw new Error("[sendoracloud] init() must complete before flags.evaluateAll().");
+        const body = {
+          userId: input?.userId ?? self.userId ?? void 0,
+          entityId: input?.entityId,
+          environment: input?.environment
+        };
+        const res = await post(
+          { apiUrl: self.config.apiUrl, publicKey: self.config.publicKey, debug: self.debug },
+          "/feature-flags/evaluate-all",
+          body
+        );
+        if (!res || !res.ok) throw new Error(`[sendoracloud] flags.evaluateAll failed (${res?.status ?? "network"})`);
+        const parsed = await res.json();
+        if (!parsed.success || !parsed.data) throw new Error("[sendoracloud] flags.evaluateAll: 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

@@ -996,6 +996,85 @@ declare class SendoraSDK {
             submittedAt: string;
         }>;
     };
+    /**
+     * In-app messaging namespace — fetch active messages (modals,
+     * banners, slideouts, tooltips) targeted at this user + record
+     * impressions (shown / clicked / dismissed) so the dashboard's
+     * "shown N times" caps and CTR analytics work. Mirrors backend
+     * `/in-app-messages/{active,impressions}` SDK routes and the web
+     * SDK's `InAppMessaging` class.
+     *
+     * Typical use:
+     *   const msgs = await SendoraCloud.messages.fetchActive();
+     *   for (const m of msgs) renderMessage(m);
+     *   // when user sees it:
+     *   await SendoraCloud.messages.recordImpression({ messageId: m.id, action: "shown" });
+     *   // when user clicks CTA:
+     *   await SendoraCloud.messages.recordImpression({ messageId: m.id, action: "clicked" });
+     *
+     * `action` is a free-form string; "shown" / "clicked" / "dismissed"
+     * are the canonical set the dashboard graphs from.
+     */
+    get messages(): {
+        fetchActive: () => Promise<Array<{
+            id: string;
+            type: string;
+            title: string | null;
+            body: string;
+            ctaText: string | null;
+            ctaUrl: string | null;
+            imageUrl: string | null;
+            theme: string | null;
+            priority: number;
+            isActive: boolean;
+            [key: string]: unknown;
+        }>>;
+        recordImpression: (input: {
+            messageId: string;
+            action: string;
+            entityId?: string;
+        }) => Promise<void>;
+    };
+    /**
+     * Feature-flags namespace — per-user evaluation against percentage
+     * rollouts + audience targeting. Mirrors backend
+     * `/feature-flags/{evaluate,evaluate-all}` SDK routes and the web
+     * SDK's `FeatureFlags` class.
+     *
+     * `evaluate(key)` returns the resolved value (boolean / string /
+     * number / variant payload) for a single flag — use when you only
+     * need one specific flag in a code path.
+     *
+     * `evaluateAll()` returns the full flag map in one round-trip —
+     * call once on app startup or screen mount, then read from the
+     * map locally. Avoids N+1.
+     *
+     * Both methods auto-thread `userId` (from `identify()`) when not
+     * passed. `entityId` is for entity-scoped flags (org / team /
+     * device-cohort); typically omitted in mobile apps.
+     */
+    get flags(): {
+        evaluate: (input: {
+            key: string;
+            entityId?: string;
+            userId?: string;
+            environment?: string;
+        }) => Promise<{
+            key: string;
+            value: unknown;
+            variant: string | null;
+            reason: string;
+        }>;
+        evaluateAll: (input?: {
+            entityId?: string;
+            userId?: string;
+            environment?: string;
+        }) => Promise<Record<string, {
+            value: unknown;
+            variant: string | null;
+            reason: 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

@@ -996,6 +996,85 @@ declare class SendoraSDK {
             submittedAt: string;
         }>;
     };
+    /**
+     * In-app messaging namespace — fetch active messages (modals,
+     * banners, slideouts, tooltips) targeted at this user + record
+     * impressions (shown / clicked / dismissed) so the dashboard's
+     * "shown N times" caps and CTR analytics work. Mirrors backend
+     * `/in-app-messages/{active,impressions}` SDK routes and the web
+     * SDK's `InAppMessaging` class.
+     *
+     * Typical use:
+     *   const msgs = await SendoraCloud.messages.fetchActive();
+     *   for (const m of msgs) renderMessage(m);
+     *   // when user sees it:
+     *   await SendoraCloud.messages.recordImpression({ messageId: m.id, action: "shown" });
+     *   // when user clicks CTA:
+     *   await SendoraCloud.messages.recordImpression({ messageId: m.id, action: "clicked" });
+     *
+     * `action` is a free-form string; "shown" / "clicked" / "dismissed"
+     * are the canonical set the dashboard graphs from.
+     */
+    get messages(): {
+        fetchActive: () => Promise<Array<{
+            id: string;
+            type: string;
+            title: string | null;
+            body: string;
+            ctaText: string | null;
+            ctaUrl: string | null;
+            imageUrl: string | null;
+            theme: string | null;
+            priority: number;
+            isActive: boolean;
+            [key: string]: unknown;
+        }>>;
+        recordImpression: (input: {
+            messageId: string;
+            action: string;
+            entityId?: string;
+        }) => Promise<void>;
+    };
+    /**
+     * Feature-flags namespace — per-user evaluation against percentage
+     * rollouts + audience targeting. Mirrors backend
+     * `/feature-flags/{evaluate,evaluate-all}` SDK routes and the web
+     * SDK's `FeatureFlags` class.
+     *
+     * `evaluate(key)` returns the resolved value (boolean / string /
+     * number / variant payload) for a single flag — use when you only
+     * need one specific flag in a code path.
+     *
+     * `evaluateAll()` returns the full flag map in one round-trip —
+     * call once on app startup or screen mount, then read from the
+     * map locally. Avoids N+1.
+     *
+     * Both methods auto-thread `userId` (from `identify()`) when not
+     * passed. `entityId` is for entity-scoped flags (org / team /
+     * device-cohort); typically omitted in mobile apps.
+     */
+    get flags(): {
+        evaluate: (input: {
+            key: string;
+            entityId?: string;
+            userId?: string;
+            environment?: string;
+        }) => Promise<{
+            key: string;
+            value: unknown;
+            variant: string | null;
+            reason: string;
+        }>;
+        evaluateAll: (input?: {
+            entityId?: string;
+            userId?: string;
+            environment?: string;
+        }) => Promise<Record<string, {
+            value: unknown;
+            variant: string | null;
+            reason: 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

@@ -2056,6 +2056,111 @@ var SendoraSDK = class {
       }
     };
   }
+  /**
+   * In-app messaging namespace — fetch active messages (modals,
+   * banners, slideouts, tooltips) targeted at this user + record
+   * impressions (shown / clicked / dismissed) so the dashboard's
+   * "shown N times" caps and CTR analytics work. Mirrors backend
+   * `/in-app-messages/{active,impressions}` SDK routes and the web
+   * SDK's `InAppMessaging` class.
+   *
+   * Typical use:
+   *   const msgs = await SendoraCloud.messages.fetchActive();
+   *   for (const m of msgs) renderMessage(m);
+   *   // when user sees it:
+   *   await SendoraCloud.messages.recordImpression({ messageId: m.id, action: "shown" });
+   *   // when user clicks CTA:
+   *   await SendoraCloud.messages.recordImpression({ messageId: m.id, action: "clicked" });
+   *
+   * `action` is a free-form string; "shown" / "clicked" / "dismissed"
+   * are the canonical set the dashboard graphs from.
+   */
+  get messages() {
+    const self = this;
+    return {
+      fetchActive: async () => {
+        if (!self.config) throw new Error("[sendoracloud] init() must complete before messages.fetchActive().");
+        const url = `${self.config.apiUrl}/api/v1/in-app-messages/active`;
+        const res = await fetch(url, {
+          method: "GET",
+          headers: { "x-api-key": self.config.publicKey }
+        });
+        if (!res.ok) throw new Error(`[sendoracloud] messages.fetchActive failed (${res.status})`);
+        const parsed = await res.json();
+        if (!parsed.success || !Array.isArray(parsed.data)) {
+          throw new Error("[sendoracloud] messages.fetchActive: bad response");
+        }
+        return parsed.data;
+      },
+      recordImpression: async (input) => {
+        if (!self.config) throw new Error("[sendoracloud] init() must complete before messages.recordImpression().");
+        const res = await post(
+          { apiUrl: self.config.apiUrl, publicKey: self.config.publicKey, debug: self.debug },
+          "/in-app-messages/impressions",
+          input
+        );
+        if (!res || !res.ok) throw new Error(`[sendoracloud] messages.recordImpression failed (${res?.status ?? "network"})`);
+      }
+    };
+  }
+  /**
+   * Feature-flags namespace — per-user evaluation against percentage
+   * rollouts + audience targeting. Mirrors backend
+   * `/feature-flags/{evaluate,evaluate-all}` SDK routes and the web
+   * SDK's `FeatureFlags` class.
+   *
+   * `evaluate(key)` returns the resolved value (boolean / string /
+   * number / variant payload) for a single flag — use when you only
+   * need one specific flag in a code path.
+   *
+   * `evaluateAll()` returns the full flag map in one round-trip —
+   * call once on app startup or screen mount, then read from the
+   * map locally. Avoids N+1.
+   *
+   * Both methods auto-thread `userId` (from `identify()`) when not
+   * passed. `entityId` is for entity-scoped flags (org / team /
+   * device-cohort); typically omitted in mobile apps.
+   */
+  get flags() {
+    const self = this;
+    return {
+      evaluate: async (input) => {
+        if (!self.config) throw new Error("[sendoracloud] init() must complete before flags.evaluate().");
+        const body = {
+          key: input.key,
+          userId: input.userId ?? self.userId ?? void 0,
+          entityId: input.entityId,
+          environment: input.environment
+        };
+        const res = await post(
+          { apiUrl: self.config.apiUrl, publicKey: self.config.publicKey, debug: self.debug },
+          "/feature-flags/evaluate",
+          body
+        );
+        if (!res || !res.ok) throw new Error(`[sendoracloud] flags.evaluate failed (${res?.status ?? "network"})`);
+        const parsed = await res.json();
+        if (!parsed.success || !parsed.data) throw new Error("[sendoracloud] flags.evaluate: bad response");
+        return parsed.data;
+      },
+      evaluateAll: async (input) => {
+        if (!self.config) throw new Error("[sendoracloud] init() must complete before flags.evaluateAll().");
+        const body = {
+          userId: input?.userId ?? self.userId ?? void 0,
+          entityId: input?.entityId,
+          environment: input?.environment
+        };
+        const res = await post(
+          { apiUrl: self.config.apiUrl, publicKey: self.config.publicKey, debug: self.debug },
+          "/feature-flags/evaluate-all",
+          body
+        );
+        if (!res || !res.ok) throw new Error(`[sendoracloud] flags.evaluateAll failed (${res?.status ?? "network"})`);
+        const parsed = await res.json();
+        if (!parsed.success || !parsed.data) throw new Error("[sendoracloud] flags.evaluateAll: 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.5",
+  "version": "0.18.7",
   "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",