@attryio/react-native 0.1.1 → 0.1.4

package/README.md

@@ -10,13 +10,31 @@ const attry = await createAttryReactNative({
   apiKey: "attry_live_..."
 });
 
-await attry.track("paywall_viewed", {
+await attry.initiatePurchase({
   properties: {
-    plan: "pro"
+    productId: "pro_monthly",
+    placement: "paywall"
   }
 });
 
-await attry.revenue("subscription_started", 1999, "USD", "pro_monthly");
+await attry.purchase({
+  value: 31.42,
+  currency: "USD",
+  productId: "pro_monthly",
+  transactionId: "txn_123"
+});
 ```
 
 The SDK auto-tracks first SDK install, app opens, sessions, foreground/background transitions, deep link opens, Apple AdServices tokens on iOS, and Google Play Install Referrer on Android when the native modules are available.
+
+## Standard events
+
+Attry accepts custom event names, but these standard names are reserved for dashboard reporting:
+
+- Lifecycle: `install`, `open`, `session_started`, `session_ended`, `app_foreground`, `app_background`, `deep_link_opened`
+- Revenue: `purchase`
+- Commerce/content: `initiate_purchase`
+
+`identify()` is a convenience method that attaches a known user ID to later events; it is not sent as a standard event. Any other product action can still be sent with `track("your_event_name", { properties })`.
+
+Purchase events must include `value` or `amountMinor` plus `currency`. Attry stores them as stable minor-unit revenue fields so dashboard revenue is not guessed from arbitrary properties.

package/dist/index.d.ts

@@ -53,11 +53,11 @@ export interface ReactNativeAttryConfig extends Omit<AttryConfig, "platform" | "
 }
 export { parseAttryUrl };
 export declare function createAttryReactNative(config: ReactNativeAttryConfig): Promise<Attry>;
-export declare function collectReactNativeContext(rn?: ReactNativeLike | undefined, configuredContext?: AttryConfig["context"]): Promise<AttryContext>;
+export declare function collectReactNativeContext(rn?: ReactNativeLike, configuredContext?: AttryConfig["context"]): Promise<AttryContext>;
 export declare function attachReactNativeLifecycleTracking(client: Attry, rn: ReactNativeLike | undefined, storage: AttryStorage | undefined, options: {
     appId: string;
     sessionTimeoutMs?: number;
 }): Promise<void>;
-export declare function attachDeepLinkTracking(client: Attry, rn?: ReactNativeLike | undefined): Promise<void>;
-export declare function collectInstallAttribution(client: Attry, rn?: ReactNativeLike | undefined): Promise<void>;
+export declare function attachDeepLinkTracking(client: Attry, rn?: ReactNativeLike): Promise<void>;
+export declare function collectInstallAttribution(client: Attry, rn?: ReactNativeLike): Promise<void>;
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -1,13 +1,13 @@
-import { Attry, MemoryStorage, parseAttryUrl } from "@attryio/sdk-core";
+import { Attry, ATTRY_EVENTS, MemoryStorage, parseAttryUrl } from "@attryio/sdk-core";
 const SDK_NAME = "attry-react-native";
-const SDK_VERSION = "0.1.0";
+const SDK_VERSION = "0.1.4";
 export { parseAttryUrl };
 export async function createAttryReactNative(config) {
-    const rn = getReactNative();
+    const rn = await loadReactNative();
     const platform = rn?.Platform?.OS === "ios" || rn?.Platform?.OS === "android"
         ? rn.Platform.OS
         : "unknown";
-    const storage = config.storage ?? createAsyncStorageAdapter() ?? new MemoryStorage();
+    const storage = config.storage ?? (await createAsyncStorageAdapter()) ?? new MemoryStorage();
     const context = await collectReactNativeContext(rn, config.context);
     const client = await new Attry({
         ...config,
@@ -29,18 +29,19 @@ export async function createAttryReactNative(config) {
     }
     return client;
 }
-export async function collectReactNativeContext(rn = getReactNative(), configuredContext = {}) {
-    const modules = rn?.NativeModules;
+export async function collectReactNativeContext(rn, configuredContext = {}) {
+    const native = rn ?? (await loadReactNative());
+    const modules = native?.NativeModules;
     const deviceInfo = modules?.RNDeviceInfo;
     const expoConstants = modules?.ExpoConstants ?? modules?.ExponentConstants;
     const platformConstants = modules?.PlatformConstants;
     const settings = modules?.SettingsManager;
-    const screen = rn?.Dimensions?.get?.("screen");
+    const screen = native?.Dimensions?.get?.("screen");
     const locale = configuredContext?.locale ??
         readNestedString(settings?.settings, ["AppleLocale"]) ??
         readFirstString(readNestedUnknown(settings?.settings, ["AppleLanguages"])) ??
         readNestedString(deviceInfo, ["deviceLocale"]) ??
-        rn?.I18nManager?.localeIdentifier;
+        native?.I18nManager?.localeIdentifier;
     return compactContext({
         sdkName: SDK_NAME,
         sdkVersion: SDK_VERSION,
@@ -74,10 +75,12 @@ export async function collectReactNativeContext(rn = getReactNative(), configure
             (await readMaybeString(deviceInfo?.getBuildNumber)) ??
             readNestedString(expoConstants, ["expoConfig", "ios", "buildNumber"]) ??
             readNestedString(expoConstants, ["expoConfig", "android", "versionCode"]),
-        osVersion: rn?.Platform?.Version ? String(rn.Platform.Version) : undefined,
+        osVersion: native?.Platform?.Version
+            ? String(native.Platform.Version)
+            : undefined,
         systemName: configuredContext?.systemName ??
             (await readMaybeString(deviceInfo?.systemName)) ??
-            (rn?.Platform?.OS ? String(rn.Platform.OS) : undefined),
+            (native?.Platform?.OS ? String(native.Platform.OS) : undefined),
         deviceModel: configuredContext?.deviceModel ??
             (await readMaybeString(deviceInfo?.model)) ??
             (await readMaybeString(deviceInfo?.getModel)) ??
@@ -124,13 +127,14 @@ export async function collectReactNativeContext(rn = getReactNative(), configure
         ...configuredContext
     });
 }
-export async function attachReactNativeLifecycleTracking(client, rn = getReactNative(), storage = new MemoryStorage(), options) {
+export async function attachReactNativeLifecycleTracking(client, rn, storage = new MemoryStorage(), options) {
+    const native = rn ?? (await loadReactNative());
     const installKey = `attry.${options.appId}.install_tracked`;
     const sessionStartedAt = Date.now();
     const sessionId = `ses_${sessionStartedAt.toString(36)}`;
     if (!(await storage.getItem(installKey))) {
         await storage.setItem(installKey, new Date().toISOString());
-        await client.track("install", {
+        await client.track(ATTRY_EVENTS.INSTALL, {
             properties: {
                 auto: true,
                 firstSdkOpen: true
@@ -140,16 +144,16 @@ export async function attachReactNativeLifecycleTracking(client, rn = getReactNa
             }
         });
     }
-    await client.track("app_open", {
+    await client.track(ATTRY_EVENTS.OPEN, {
         properties: {
             auto: true,
-            appState: rn?.AppState?.currentState ?? "active"
+            appState: native?.AppState?.currentState ?? "active"
         },
         context: {
             sessionId
         }
     });
-    await client.track("session_started", {
+    await client.track(ATTRY_EVENTS.SESSION_STARTED, {
         properties: {
             auto: true
         },
@@ -157,15 +161,15 @@ export async function attachReactNativeLifecycleTracking(client, rn = getReactNa
             sessionId
         }
     });
-    let active = rn?.AppState?.currentState !== "background";
+    let active = native?.AppState?.currentState !== "background";
     let lastActiveAt = sessionStartedAt;
     const sessionTimeoutMs = options.sessionTimeoutMs ?? 30 * 60 * 1000;
-    rn?.AppState?.addEventListener?.("change", (state) => {
+    native?.AppState?.addEventListener?.("change", (state) => {
         const now = Date.now();
         if (state === "active" && !active) {
             active = true;
             lastActiveAt = now;
-            void client.track("app_foreground", {
+            void client.track(ATTRY_EVENTS.APP_FOREGROUND, {
                 properties: {
                     auto: true
                 },
@@ -178,7 +182,7 @@ export async function attachReactNativeLifecycleTracking(client, rn = getReactNa
         if ((state === "background" || state === "inactive") && active) {
             active = false;
             const durationMs = Math.max(0, now - lastActiveAt);
-            void client.track("app_background", {
+            void client.track(ATTRY_EVENTS.APP_BACKGROUND, {
                 properties: {
                     auto: true,
                     durationMs
@@ -188,7 +192,7 @@ export async function attachReactNativeLifecycleTracking(client, rn = getReactNa
                 }
             });
             if (durationMs >= sessionTimeoutMs || state === "background") {
-                void client.track("session_ended", {
+                void client.track(ATTRY_EVENTS.SESSION_ENDED, {
                     properties: {
                         auto: true,
                         durationMs: Math.max(0, now - sessionStartedAt)
@@ -202,18 +206,20 @@ export async function attachReactNativeLifecycleTracking(client, rn = getReactNa
         }
     });
 }
-export async function attachDeepLinkTracking(client, rn = getReactNative()) {
-    const initialUrl = await rn?.Linking?.getInitialURL?.();
+export async function attachDeepLinkTracking(client, rn) {
+    const native = rn ?? (await loadReactNative());
+    const initialUrl = await native?.Linking?.getInitialURL?.();
     if (initialUrl) {
-        await trackDeepLinkOpen(client, initialUrl, "initial_url", rn);
+        await trackDeepLinkOpen(client, initialUrl, "initial_url", native);
     }
-    rn?.Linking?.addEventListener?.("url", ({ url }) => {
-        void trackDeepLinkOpen(client, url, "linking_event", rn);
+    native?.Linking?.addEventListener?.("url", ({ url }) => {
+        void trackDeepLinkOpen(client, url, "linking_event", native);
     });
 }
-export async function collectInstallAttribution(client, rn = getReactNative()) {
-    if (rn?.Platform?.OS === "ios") {
-        const token = await rn.NativeModules?.AttryAppleAds?.attributionToken?.();
+export async function collectInstallAttribution(client, rn) {
+    const native = rn ?? (await loadReactNative());
+    if (native?.Platform?.OS === "ios") {
+        const token = await native.NativeModules?.AttryAppleAds?.attributionToken?.();
         if (token) {
             const response = await client.submitAppleAdsToken(token);
             await client.track("apple_ads_token_collected", {
@@ -225,8 +231,8 @@ export async function collectInstallAttribution(client, rn = getReactNative()) {
         }
         return;
     }
-    if (rn?.Platform?.OS === "android") {
-        const payload = await rn.NativeModules?.AttryInstallReferrer?.getInstallReferrer?.();
+    if (native?.Platform?.OS === "android") {
+        const payload = await native.NativeModules?.AttryInstallReferrer?.getInstallReferrer?.();
         if (payload?.installReferrer) {
             const response = await client.resolveInstall({
                 installReferrer: payload.installReferrer
@@ -242,10 +248,11 @@ export async function collectInstallAttribution(client, rn = getReactNative()) {
         }
     }
 }
-async function trackDeepLinkOpen(client, url, openType, rn = getReactNative()) {
+async function trackDeepLinkOpen(client, url, openType, rn) {
+    const native = rn ?? (await loadReactNative());
     const parsed = parseAttryUrl(url);
-    const openedFromUniversalLink = rn?.Platform?.OS === "ios";
-    const openedFromAndroidAppLink = rn?.Platform?.OS === "android";
+    const openedFromUniversalLink = native?.Platform?.OS === "ios";
+    const openedFromAndroidAppLink = native?.Platform?.OS === "android";
     const resolved = await client.resolveDeepLink({
         url,
         openedFromUniversalLink,
@@ -261,7 +268,7 @@ async function trackDeepLinkOpen(client, url, openType, rn = getReactNative()) {
             openedFromAndroidAppLink
         });
     }
-    await client.track("deep_link_opened", {
+    await client.track(ATTRY_EVENTS.DEEP_LINK_OPENED, {
         properties: {
             openType,
             url: parsed.url,
@@ -341,19 +348,18 @@ function safeTimezone() {
         return undefined;
     }
 }
-function getReactNative() {
+async function loadReactNative() {
     try {
-        const dynamicRequire = eval("require");
-        return dynamicRequire("react-native");
+        return (await import("react-native"));
     }
     catch {
         return undefined;
     }
 }
-function createAsyncStorageAdapter() {
+async function createAsyncStorageAdapter() {
     try {
-        const dynamicRequire = eval("require");
-        const asyncStorage = dynamicRequire("@react-native-async-storage/async-storage").default;
+        const asyncStorageModule = (await import("@react-native-async-storage/async-storage"));
+        const asyncStorage = asyncStorageModule.default;
         return asyncStorage;
     }
     catch {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@attryio/react-native",
-  "version": "0.1.1",
+  "version": "0.1.4",
   "private": false,
   "license": "Apache-2.0",
   "type": "module",
@@ -29,7 +29,8 @@
     "access": "public"
   },
   "dependencies": {
-    "@attryio/sdk-core": "0.1.1"
+    "@attryio/sdk-core": "0.1.3",
+    "@react-native-async-storage/async-storage": "^2.2.0"
   },
   "peerDependencies": {
     "react-native": ">=0.72"