@sendoracloud/sdk-react-native 0.15.0 → 0.16.0

package/examples/links-share.tsx

@@ -0,0 +1,99 @@
+/**
+ * Example: share-an-article row with prewarm cache.
+ *
+ * Shows how to mint a Sendora deep link with typed `linkData` and avoid
+ * the ActivityIndicator on share-tap by `prewarm`-ing during row mount.
+ *
+ * Copy this into your app under any name — it's not part of the SDK
+ * runtime, just a paste-ready recipe.
+ */
+
+import React, { useEffect, useRef } from "react";
+import { Pressable, Share, Text, View } from "react-native";
+import SendoraCloud, { LinkError } from "@sendoracloud/sdk-react-native";
+
+interface Article {
+  id: string;
+  title: string;
+  category: "tech" | "design" | "policy";
+  authorId: string;
+}
+
+interface ArticleLinkData extends Record<string, unknown> {
+  type: "article";
+  articleId: string;
+  category: Article["category"];
+  sharedBy: string;
+}
+
+export function ShareArticleRow({ article, currentUserId }: { article: Article; currentUserId: string }): React.ReactElement {
+  const prewarmKey = useRef(`article:${article.id}`);
+
+  // Background-mint on mount so the share-tap completes instantly.
+  useEffect(() => {
+    SendoraCloud.links.prewarm<ArticleLinkData>(
+      {
+        title: `Share article: ${article.title}`,
+        iosDeepLinkPath: `/articles/${article.id}`,
+        androidDeepLinkPath: `/articles/${article.id}`,
+        ogTitle: article.title,
+        linkData: {
+          type: "article",
+          articleId: article.id,
+          category: article.category,
+          sharedBy: currentUserId,
+        },
+      },
+      { key: prewarmKey.current },
+    );
+  }, [article.id, article.title, article.category, currentUserId]);
+
+  const onShare = async (): Promise<void> => {
+    try {
+      const link = await SendoraCloud.links.create<ArticleLinkData>(
+        {
+          title: `Share article: ${article.title}`,
+          iosDeepLinkPath: `/articles/${article.id}`,
+          androidDeepLinkPath: `/articles/${article.id}`,
+          ogTitle: article.title,
+          linkData: {
+            type: "article",
+            articleId: article.id,
+            category: article.category,
+            sharedBy: currentUserId,
+          },
+        },
+        { key: prewarmKey.current },
+      );
+      await Share.share({ message: link.url });
+    } catch (err) {
+      if (err instanceof LinkError) {
+        // Branch on typed code, not message string.
+        switch (err.code) {
+          case "BUNDLE_MISMATCH":
+            console.warn("Bundle id is not registered in Dashboard → Apps");
+            break;
+          case "PLAN_LIMIT":
+            console.warn("Project hit linksPerProject limit — upgrade plan");
+            break;
+          case "RATE_LIMITED":
+            console.warn("Too many shares too quickly; retry shortly");
+            break;
+          default:
+            console.warn(`Share failed: ${err.code} — ${err.message}`);
+        }
+      } else {
+        console.warn("Unexpected share failure", err);
+      }
+    }
+  };
+
+  return (
+    <View>
+      <Text>{article.title}</Text>
+      <Pressable onPress={onShare}>
+        <Text>Share</Text>
+      </Pressable>
+    </View>
+  );
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@sendoracloud/sdk-react-native",
-  "version": "0.15.0",
-  "description": "Sendora Cloud React Native + Expo SDK — analytics, identity, push-token registration, auth. Expo Go compatible, no native modules beyond AsyncStorage.",
+  "version": "0.16.0",
+  "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.",
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
@@ -15,6 +15,7 @@
   },
   "files": [
     "dist",
+    "examples",
     "README.md",
     "LICENSE"
   ],