@sendoracloud/sdk-react-native 0.15.0 → 0.15.1

package/README.md

@@ -72,10 +72,50 @@ SendoraCloud.reset();
 | `track(event, props?)` | Fire a custom product event. |
 | `screen(name, props?)` | Track a screen view. |
 | `registerPushToken(reg)` | Register an APNs or FCM push token. |
+| `links.create(input)` | Mint a Sendora deep link from inside the app (Branch / Firebase parity). |
+| `links.handleUniversalLink(url)` | Resolve a warm-path Universal Link / App Link delivery. |
+| `links.matchDeferred({ installReferrer?, fingerprintHash? })` | Cold-launch deferred deep link match. |
+| `links.onLinkOpened(cb)` | Register a callback fired for both warm + deferred opens. |
 | `reset()` | Clear identity + rotate anonymous id. Call on logout. |
 | `getAnonymousId()` | Stable device id (persisted across restarts). |
 | `getUserId()` | Currently identified user id, or null. |
 
+### Deep links example (Pulse-style share button)
+
+```ts
+// In your share button handler — mints a Sendora short URL the user
+// can paste into iMessage / Slack / wherever. The link survives an
+// App Store / Play Store detour and reopens the article in your app.
+const { url } = await SendoraCloud.links.create({
+  title: article.title,
+  fallbackUrl: `https://yourapp.com/articles/${article.id}`,
+  iosDeepLinkPath: `/articles/${article.id}`,
+  androidDeepLinkPath: `/articles/${article.id}`,
+  ogTitle: article.title,
+  ogImageUrl: article.heroImage,
+  linkData: { articleId: article.id, sharedBy: currentUser.id },
+});
+Share.share({ message: url });
+
+// In your app root — fires once on every link open (warm or deferred):
+SendoraCloud.links.onLinkOpened((event) => {
+  const articleId = event.linkData.articleId as string | undefined;
+  if (articleId) navigateToArticle(articleId);
+});
+
+// Wire URL handlers — warm path (app already installed):
+import { Linking } from "react-native";
+Linking.addEventListener("url", ({ url }) => {
+  SendoraCloud.links.handleUniversalLink(url);
+});
+
+// Cold path (deferred deep link after install) — Android Play Install Referrer
+// preferred (100% accurate). iOS: ship a fingerprint hash if you have one.
+import { PlayInstallReferrer } from "react-native-play-install-referrer";
+const ref = await PlayInstallReferrer.getInstallReferrerInfo();
+await SendoraCloud.links.matchDeferred({ installReferrer: ref?.installReferrer });
+```
+
 ## Config
 
 ```ts
@@ -98,6 +138,10 @@ SendoraCloud.reset();
    */
   autoTrack?: boolean | { appOpen?: boolean; sessionStart?: boolean; appBackground?: boolean };
   sessionIdleMs?: number; // Idle threshold for session expiry. Default 30 min.
+  /** iOS bundle id — forwarded to backend on `links.create()` for the bundle-id gate. */
+  iosBundleId?: string;
+  /** Android package name — same purpose as iosBundleId. */
+  androidPackageName?: string;
 }
 ```
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sendoracloud/sdk-react-native",
-  "version": "0.15.0",
+  "version": "0.15.1",
   "description": "Sendora Cloud React Native + Expo SDK — analytics, identity, push-token registration, auth. Expo Go compatible, no native modules beyond AsyncStorage.",
   "type": "module",
   "main": "./dist/index.cjs",