@sendoracloud/sdk-react-native 0.16.1 → 0.17.0

package/README.md

@@ -1,26 +1,44 @@
 # @sendoracloud/sdk-react-native
 
-Official React Native + Expo SDK for [SendoraCloud](https://sendoracloud.com). Works in Expo Go, managed dev clients, and bare React Native apps.
+Official React Native + Expo SDK for [SendoraCloud](https://sendoracloud.com).
 
 > 📖 **First time on React Native?** Read the [5-minute quickstart](https://sendoracloud.com/docs/quickstart-react-native) — it covers the Hermes CSPRNG polyfill, anonymous-first auth, push token receipts, and the demo end-to-end push send.
 
-## Install
+## Expo Go vs Dev Client — pick the right runner
+
+| Feature | Expo Go (SDK 53+) | Dev Client / EAS Build | Bare RN |
+| --- | --- | --- | --- |
+| Analytics (`track`, `screen`, `identify`) | ✅ | ✅ | ✅ |
+| Auth (`signUp`, `signIn`, MFA, passkeys) | ✅ | ✅ | ✅ |
+| Deep links (warm path) | ✅ | ✅ | ✅ |
+| Deferred deep links (fingerprint) | ✅ | ✅ | ✅ |
+| Deferred deep links (Play Install Referrer) | ❌ — needs `react-native-play-install-referrer` | ✅ | ✅ |
+| **Push token registration** (iOS APNs / FCM) | ❌ — Expo Go dropped remote push in SDK 53 | ✅ | ✅ |
+
+**If push notifications matter to you, you MUST move off Expo Go.** Plain Expo Go cannot receive remote push tokens since SDK 53 (Expo deprecated the shared APNs cert). Run a Dev Client instead:
 
 ```bash
-npx expo install @sendoracloud/sdk-react-native @react-native-async-storage/async-storage
-npm install react-native-get-random-values
+# One-time: build the dev client locally
+npx expo prebuild --clean
+npx expo run:ios       # or run:android
+# Day-to-day: just `npx expo start` — same DX as Expo Go
 ```
 
-`@react-native-async-storage/async-storage` is a required peer dependency — used to persist the anonymous device id across app restarts.
+Or use EAS Build for cloud builds. **Auth, analytics, deep links all work fine in plain Expo Go** — only push registration requires Dev Client.
 
-`react-native-get-random-values` is a required runtime polyfill — Hermes (and JavaScriptCore) doesn't expose `crypto.getRandomValues` reliably, and Sendora refuses to mint anonymous IDs from `Math.random`. Add this as the **first import** in your entry file (`index.js` or `index.tsx`):
+> 💡 If `registerPushToken` returns `null` or sign-up succeeds but the dashboard never shows your device token, you're almost certainly on Expo Go. Switch to a Dev Client.
 
-```ts
-// MUST be the first import in your entry file
-import "react-native-get-random-values";
+## Install
+
+```bash
+npx expo install @sendoracloud/sdk-react-native @react-native-async-storage/async-storage
 ```
 
-If you forget, `init()` throws with a paste-ready remediation block — it never fails silently.
+That's it. Since 0.17.0 the SDK bundles `react-native-get-random-values` as a hard dependency and auto-applies the polyfill at SDK load — no manual `import "react-native-get-random-values"` in your entry file required.
+
+`@react-native-async-storage/async-storage` is a required peer dependency used to persist the anonymous device id across app restarts.
+
+> **Upgrading from 0.16.x?** You can delete the `import "react-native-get-random-values";` line from your `index.js` / `index.tsx` entry file — it's now a no-op (the SDK side-effect-loads the polyfill itself). Leaving it in does no harm.
 
 ### Optional peers (deep links)
 

package/dist/index.cjs

@@ -42,6 +42,7 @@ __export(index_exports, {
   getPlayInstallReferrer: () => getPlayInstallReferrer
 });
 module.exports = __toCommonJS(index_exports);
+var import_react_native_get_random_values = require("react-native-get-random-values");
 
 // src/storage.ts
 var PREFIX = "sendora_";

package/dist/index.js

@@ -1,3 +1,6 @@
+// src/index.ts
+import "react-native-get-random-values";
+
 // src/storage.ts
 var PREFIX = "sendora_";
 var asyncStoragePromise = null;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@sendoracloud/sdk-react-native",
-  "version": "0.16.1",
-  "description": "Sendora Cloud React Native + Expo SDK — analytics, identity, push-token registration, auth, deep links (Branch / Firebase Dynamic Links parity). Expo Go compatible, no native modules beyond AsyncStorage.",
+  "version": "0.17.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",
   "module": "./dist/index.js",
@@ -27,6 +27,9 @@
     "tracking",
     "customer-engagement"
   ],
+  "dependencies": {
+    "react-native-get-random-values": "^1.11.0"
+  },
   "peerDependencies": {
     "@react-native-async-storage/async-storage": ">=1.17.0",
     "react-native": ">=0.70.0"