@formo/analytics-react-native 1.0.0 → 1.0.2

package/lib/typescript/module/FormoAnalyticsProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FormoAnalyticsProvider.d.ts","sourceRoot":"","sources":["../../../src/FormoAnalyticsProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAOZ,EAAE,EACH,MAAM,OAAO,CAAC;AAIf,OAAO,EAAE,2BAA2B,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAsBvE,eAAO,MAAM,qBAAqB,gCACc,CAAC;AAEjD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,sBAAsB,EAAE,EAAE,CAAC,2BAA2B,CAwBlE,CAAC;AAgMF,eAAO,MAAM,QAAQ,QAAO,eAmB3B,CAAC"}
+{"version":3,"file":"FormoAnalyticsProvider.d.ts","sourceRoot":"","sources":["../../../src/FormoAnalyticsProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAOZ,EAAE,EACH,MAAM,OAAO,CAAC;AAIf,OAAO,EAAE,2BAA2B,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAyBvE,eAAO,MAAM,qBAAqB,gCACc,CAAC;AAEjD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,sBAAsB,EAAE,EAAE,CAAC,2BAA2B,CAwBlE,CAAC;AAgMF,eAAO,MAAM,QAAQ,QAAO,eAmB3B,CAAC"}

package/lib/typescript/module/constants/events.d.ts

@@ -21,4 +21,27 @@ export type TEventChannel = Lowercase<EventChannel>;
 export declare const CHANNEL: TEventChannel;
 export declare const VERSION = "0";
 export declare const SESSION_TIMEOUT_MS: number;
+/**
+ * Reserved lifecycle and campaign event names, per the Segment spec that
+ * RudderStack, PostHog and Amplitude all adopted verbatim.
+ *
+ * These are ordinary `track` events on the wire — the names are what make them
+ * recognisable to downstream analytics, so they must match the spec exactly,
+ * including capitalisation and spacing.
+ *
+ * @see https://segment.com/docs/connections/spec/mobile/
+ */
+export declare const LIFECYCLE_EVENT: {
+    readonly APPLICATION_INSTALLED: "Application Installed";
+    readonly APPLICATION_UPDATED: "Application Updated";
+    readonly APPLICATION_OPENED: "Application Opened";
+    readonly APPLICATION_BACKGROUNDED: "Application Backgrounded";
+    readonly APPLICATION_FOREGROUNDED: "Application Foregrounded";
+    readonly APPLICATION_CRASHED: "Application Crashed";
+    readonly DEEP_LINK_OPENED: "Deep Link Opened";
+    readonly PUSH_NOTIFICATION_RECEIVED: "Push Notification Received";
+    readonly PUSH_NOTIFICATION_TAPPED: "Push Notification Tapped";
+    readonly PUSH_NOTIFICATION_BOUNCED: "Push Notification Bounced";
+};
+export type TLifecycleEvent = (typeof LIFECYCLE_EVENT)[keyof typeof LIFECYCLE_EVENT];
 //# sourceMappingURL=events.d.ts.map

package/lib/typescript/module/constants/events.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../../../src/constants/events.ts"],"names":[],"mappings":"AAAA,oBAAY,SAAS;IACnB,IAAI,SAAS;IACb,MAAM,WAAW;IACjB,QAAQ,aAAa;IACrB,MAAM,WAAW;IACjB,OAAO,YAAY;IACnB,UAAU,eAAe;IACzB,KAAK,UAAU;IACf,SAAS,cAAc;IACvB,WAAW,gBAAgB;IAC3B,KAAK,UAAU;CAChB;AAED,oBAAY,YAAY;IACtB,GAAG,QAAQ;IACX,MAAM,WAAW;IACjB,MAAM,WAAW;IACjB,MAAM,WAAW;CAClB;AAED,MAAM,MAAM,UAAU,GAAG,SAAS,CAAC,SAAS,CAAC,CAAC;AAC9C,MAAM,MAAM,aAAa,GAAG,SAAS,CAAC,YAAY,CAAC,CAAC;AAGpD,eAAO,MAAM,OAAO,EAAE,aAAwB,CAAC;AAC/C,eAAO,MAAM,OAAO,MAAM,CAAC;AAI3B,eAAO,MAAM,kBAAkB,QAAiB,CAAC"}
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../../../src/constants/events.ts"],"names":[],"mappings":"AAAA,oBAAY,SAAS;IACnB,IAAI,SAAS;IACb,MAAM,WAAW;IACjB,QAAQ,aAAa;IACrB,MAAM,WAAW;IACjB,OAAO,YAAY;IACnB,UAAU,eAAe;IACzB,KAAK,UAAU;IACf,SAAS,cAAc;IACvB,WAAW,gBAAgB;IAC3B,KAAK,UAAU;CAChB;AAED,oBAAY,YAAY;IACtB,GAAG,QAAQ;IACX,MAAM,WAAW;IACjB,MAAM,WAAW;IACjB,MAAM,WAAW;CAClB;AAED,MAAM,MAAM,UAAU,GAAG,SAAS,CAAC,SAAS,CAAC,CAAC;AAC9C,MAAM,MAAM,aAAa,GAAG,SAAS,CAAC,YAAY,CAAC,CAAC;AAGpD,eAAO,MAAM,OAAO,EAAE,aAAwB,CAAC;AAC/C,eAAO,MAAM,OAAO,MAAM,CAAC;AAQ3B,eAAO,MAAM,kBAAkB,QAAiB,CAAC;AAEjD;;;;;;;;;GASG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;CAWlB,CAAC;AAEX,MAAM,MAAM,eAAe,GACzB,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,OAAO,eAAe,CAAC,CAAC"}

package/lib/typescript/module/lib/crash/index.d.ts

@@ -0,0 +1,41 @@
+/**
+ * JavaScript crash reporting.
+ *
+ * Emits the Segment-spec `Application Crashed` event for unhandled JS errors by
+ * wrapping React Native's global error handler.
+ *
+ * Scope: JavaScript errors only. A native crash (a Swift/Kotlin exception, an
+ * OOM kill, a watchdog termination) never reaches the JS runtime, so it cannot
+ * be observed from here — that needs a native crash reporter.
+ */
+/** Interface for the analytics instance to avoid circular deps */
+interface IAnalyticsInstance {
+    track(event: string, properties?: Record<string, unknown>): Promise<void>;
+    flush(): Promise<void>;
+}
+export declare class CrashReporter {
+    private analytics;
+    private previousHandler;
+    private installedHandler;
+    private started;
+    constructor(analytics: IAnalyticsInstance);
+    /**
+     * Install the global error handler.
+     *
+     * The previous handler is always called afterwards — React Native's default
+     * handler is what shows the redbox in dev and terminates the app on a fatal
+     * error in production, and a customer's crash reporter (Sentry, Bugsnag) may
+     * also be in the chain. Swallowing it would break both.
+     */
+    start(): void;
+    private report;
+    /**
+     * Restore the previous handler.
+     *
+     * Only restores if ours is still the installed handler — if something else
+     * wrapped us afterwards, replacing the chain would unhook that too.
+     */
+    cleanup(): void;
+}
+export {};
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/module/lib/crash/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/lib/crash/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAaH,kEAAkE;AAClE,UAAU,kBAAkB;IAC1B,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1E,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAWD,qBAAa,aAAa;IACxB,OAAO,CAAC,SAAS,CAAqB;IACtC,OAAO,CAAC,eAAe,CAA2B;IAClD,OAAO,CAAC,gBAAgB,CAA2B;IACnD,OAAO,CAAC,OAAO,CAAS;gBAEZ,SAAS,EAAE,kBAAkB;IAIzC;;;;;;;OAOG;IACH,KAAK,IAAI,IAAI;IA4Cb,OAAO,CAAC,MAAM;IAqBd;;;;;OAKG;IACH,OAAO,IAAI,IAAI;CAkBhB"}

package/lib/typescript/module/lib/event/EventFactory.d.ts

@@ -20,15 +20,20 @@ import { IEventFactory } from "./types";
  */
 export declare function getSessionId(): string;
 /**
- * Build a representative User-Agent string from structured device info.
+ * Compose a screen view's `page_url` as `app://<bundle id>/<screen>`.
  *
- * The ingestion pipeline classifies device / os / browser purely from the
- * user_agent string; a mobile event with an empty UA is bucketed as "unknown".
- * Platforms without a native UA (e.g. Expo, where DeviceInfo.getUserAgent() is
- * unavailable) would otherwise report device=os=unknown. We synthesize a UA
- * containing the tokens the classifier keys off (iphone/ipad/android + version)
- * so mobile device and OS resolve correctly. Returns "" for unknown platforms.
+ * Well-formed on purpose: the bundle id occupies the authority slot and the
+ * screen the path, so a standard URL parser yields both without any
+ * mobile-specific handling — the same shape as `https://<host>/<path>`.
+ *
+ * @param bundleId Application bundle id, e.g. "com.acme.wallet". When empty the
+ *   authority is omitted (`app:///<screen>`), which still parses to a correct
+ *   path; the pipeline resolves origin from context in that case.
+ * @param name Screen name. Leading slashes are stripped so a router-style name
+ *   ("/tabs/leaderboard") does not produce a doubled separator.
  */
+export declare function buildScreenUrl(bundleId: string, name: string): string;
+export declare function resolveExpoDeviceType(deviceType: number | null | undefined, tabletEnumValue: number | null | undefined): "tablet" | "mobile";
 export declare function synthesizeUserAgent(info: {
     os_name: string;
     os_version: string;
@@ -41,6 +46,8 @@ export declare function synthesizeUserAgent(info: {
  */
 declare class EventFactory implements IEventFactory {
     private options?;
+    /** Memoised device/app identity — see getDeviceInfo(). */
+    private deviceInfoPromise?;
     constructor(options?: Options);
     /**
      * Get device timezone
@@ -66,7 +73,19 @@ declare class EventFactory implements IEventFactory {
      * Get device information
      * Supports both react-native-device-info (bare RN) and expo-device/expo-application (Expo Go)
      */
+    /**
+     * The app bundle id as it will appear in context.
+     *
+     * Must mirror generateContext's precedence: an explicitly configured
+     * `options.app.bundleId` overrides whatever the native modules report. Reading
+     * getDeviceInfo() alone would ignore that configuration and silently fall back
+     * to the authority-less URL form — and on React Native Web, where neither
+     * react-native-device-info nor expo-application resolves a bundle id, that is
+     * the ONLY value available.
+     */
+    private resolveAppBundleId;
     private getDeviceInfo;
+    private resolveDeviceInfo;
     /**
      * Generate context with mobile-specific metadata
      */

package/lib/typescript/module/lib/event/EventFactory.d.ts.map

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

package/lib/typescript/module/lib/lifecycle/index.d.ts

@@ -6,8 +6,15 @@
  * - Application Updated (version/build changed)
  * - Application Opened (every cold start + foreground return)
  * - Application Backgrounded (app goes to background)
+ * - Application Foregrounded (foreground return; opt-in, see AutocaptureOptions)
  *
  * Detection is JS-side using AsyncStorage (no native modules required).
+ *
+ * The remaining spec events live outside this manager because they are not
+ * AppState-driven: `Deep Link Opened` is emitted from the Linking hook in
+ * FormoAnalytics, `Application Crashed` from lib/crash, and the push
+ * notification events from explicit FormoAnalytics methods (the SDK cannot
+ * observe push delivery without a native module).
  */
 /** Interface for the analytics instance to avoid circular deps */
 interface IAnalyticsInstance {
@@ -18,6 +25,7 @@ export declare class AppLifecycleManager {
     private appStateSubscription;
     private lastAppState;
     private appVersionInfo;
+    private trackForegrounded;
     constructor(analytics: IAnalyticsInstance);
     /**
      * Initialize lifecycle tracking.
@@ -26,6 +34,8 @@ export declare class AppLifecycleManager {
     start(appOptions?: {
         version?: string;
         build?: string;
+    }, options?: {
+        trackForegrounded?: boolean;
     }): Promise<void>;
     /**
      * Compare stored version/build with current to detect install or update.

package/lib/typescript/module/lib/lifecycle/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/lib/lifecycle/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAWH,kEAAkE;AAClE,UAAU,kBAAkB;IAC1B,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3E;AAgDD,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,SAAS,CAAqB;IACtC,OAAO,CAAC,oBAAoB,CAAuC;IACnE,OAAO,CAAC,YAAY,CAAyC;IAC7D,OAAO,CAAC,cAAc,CAA8C;gBAExD,SAAS,EAAE,kBAAkB;IAIzC;;;OAGG;IACG,KAAK,CACT,UAAU,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAChD,OAAO,CAAC,IAAI,CAAC;IAiChB;;;;OAIG;YACW,qBAAqB;IAkDnC;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAkC5B;;OAEG;IACH,OAAO,IAAI,IAAI;CAOhB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/lib/lifecycle/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAYH,kEAAkE;AAClE,UAAU,kBAAkB;IAC1B,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3E;AAgDD,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,SAAS,CAAqB;IACtC,OAAO,CAAC,oBAAoB,CAAuC;IACnE,OAAO,CAAC,YAAY,CAAyC;IAC7D,OAAO,CAAC,cAAc,CAA8C;IACpE,OAAO,CAAC,iBAAiB,CAAS;gBAEtB,SAAS,EAAE,kBAAkB;IAIzC;;;OAGG;IACG,KAAK,CACT,UAAU,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,EACjD,OAAO,CAAC,EAAE;QAAE,iBAAiB,CAAC,EAAE,OAAO,CAAA;KAAE,GACxC,OAAO,CAAC,IAAI,CAAC;IAkChB;;;;OAIG;YACW,qBAAqB;IAkDnC;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAoD5B;;OAEG;IACH,OAAO,IAAI,IAAI;CAOhB"}

package/lib/typescript/module/types/base.d.ts

@@ -49,6 +49,9 @@ export interface IFormoAnalytics {
         rdns?: string;
     }, properties?: IFormoEventProperties, context?: IFormoEventContext, callback?: (...args: unknown[]) => void): Promise<void>;
     track(event: string, properties?: IFormoEventProperties, context?: IFormoEventContext, callback?: (...args: unknown[]) => void): Promise<void>;
+    pushNotificationReceived(properties?: IFormoEventProperties): Promise<void>;
+    pushNotificationTapped(properties?: IFormoEventProperties): Promise<void>;
+    pushNotificationBounced(properties?: IFormoEventProperties): Promise<void>;
     flush(): Promise<void>;
     setTrafficSourceFromUrl(url: string): void;
     optOutTracking(): void;
@@ -99,6 +102,43 @@ export interface AutocaptureOptions {
      * @default true
      */
     lifecycle?: boolean;
+    /**
+     * Emit `Application Foregrounded` on every background → active transition,
+     * in addition to the `Application Opened` (with `from_background: true`) that
+     * already fires there.
+     *
+     * Off by default because it doubles foreground event volume and adds no
+     * information: `Application Opened` with `from_background: true` already
+     * marks the same transition. Enable it if you consume the Segment spec's
+     * `Application Foregrounded` name directly — e.g. when migrating dashboards
+     * or destinations from Segment or RudderStack. Requires `lifecycle`.
+     * @default false
+     */
+    foregrounded?: boolean;
+    /**
+     * Track `Deep Link Opened` when the app is launched or resumed via a deep
+     * link or universal link, with the `url` property.
+     *
+     * Independent of `attribution.deeplinks`, which controls whether the link's
+     * UTM/referral parameters are parsed into event context. This option is only
+     * about emitting the event; the SDK still needs `attribution.deeplinks` to
+     * observe links at all.
+     * @default true
+     */
+    deepLinks?: boolean;
+    /**
+     * Track `Application Crashed` on unhandled JavaScript errors, with the error
+     * message, stack, and whether React Native considered it fatal.
+     *
+     * Off by default because enabling it installs a global error handler
+     * (`ErrorUtils.setGlobalHandler`). The previous handler is always invoked
+     * afterwards, so React Native's redbox and any crash reporter you already use
+     * keep working — but installing one implicitly on an SDK upgrade is a
+     * surprise, so it is opt-in. Covers JS errors only: native crashes need a
+     * native crash reporter.
+     * @default false
+     */
+    crashes?: boolean;
 }
 /**
  * Configuration options for attribution capture.

package/lib/typescript/module/types/base.d.ts.map

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

package/lib/typescript/module/version.d.ts

@@ -1,2 +1,2 @@
-export declare const version = "1.0.0";
+export declare const version = "1.0.2";
 //# sourceMappingURL=version.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@formo/analytics-react-native",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "Formo Analytics SDK for React Native - Track wallet events and user analytics in mobile dApps",
   "packageManager": "pnpm@11.1.1",
   "repository": {
@@ -99,24 +99,24 @@
     "ethereum-cryptography": "3.2.0"
   },
   "devDependencies": {
-    "@babel/preset-env": "^7.29.5",
-    "@babel/preset-react": "^7.28.5",
+    "@babel/preset-env": "^8.0.2",
+    "@babel/preset-react": "^8.0.1",
     "@babel/preset-typescript": "^7.28.5",
     "@react-native-async-storage/async-storage": "^1.21.0",
-    "@react-native/babel-preset": "^0.85.3",
+    "@react-native/babel-preset": "^0.86.0",
     "@types/jest": "^30.0.0",
     "@types/react": "^19.2.14",
     "@typescript-eslint/eslint-plugin": "^8.59.3",
     "@typescript-eslint/parser": "^8.59.3",
     "babel-jest": "^30.4.1",
     "eslint": "^10.3.0",
-    "expo-application": "^55.0.15",
-    "expo-device": "^55.0.17",
+    "expo-application": "^57.0.2",
+    "expo-device": "^57.0.1",
     "jest": "^30.4.1",
     "react": "^19.2.6",
-    "react-native": "^0.85.3",
+    "react-native": "^0.86.0",
     "react-native-builder-bob": "^0.41.0",
-    "react-native-device-info": "^14.0.0",
+    "react-native-device-info": "^15.0.2",
     "typescript": "^6.0.3",
     "typescript-eslint": "^8.59.3"
   },

package/src/FormoAnalytics.ts

@@ -14,6 +14,7 @@ import {
   CONSENT_OPT_OUT_KEY,
   TEventType,
 } from "./constants";
+import { LIFECYCLE_EVENT } from "./constants/events";
 import { initStorageManager, storage, AsyncStorageInterface } from "./lib/storage";
 import { EventManager, EventQueue, IEventManager } from "./lib/event";
 import { logger, Logger } from "./lib/logger";
@@ -25,6 +26,7 @@ import {
 import { FormoAnalyticsSession } from "./lib/session";
 import { WagmiEventHandler } from "./lib/wagmi";
 import { AppLifecycleManager } from "./lib/lifecycle";
+import { CrashReporter } from "./lib/crash";
 import {
   Address,
   ChainID,
@@ -42,12 +44,21 @@ import { parseTrafficSource, updateStoredTrafficSource } from "./utils/trafficSo
 import { captureInstallReferrer } from "./lib/installReferrer";
 import { Linking, EmitterSubscription } from "react-native";
 
+/**
+ * Autocapture behaviors that are OFF unless explicitly enabled, because
+ * turning them on by default would change how an existing app behaves after a
+ * routine SDK upgrade. See AutocaptureOptions for the reasoning per option.
+ */
+const OPT_IN_AUTOCAPTURE = new Set<string>(["foregrounded", "crashes"]);
+
 export class FormoAnalytics implements IFormoAnalytics {
   private session: FormoAnalyticsSession;
   private eventManager: IEventManager;
   private eventQueue: EventQueue;
   private wagmiHandler?: WagmiEventHandler;
   private lifecycleManager?: AppLifecycleManager;
+  private crashReporter?: CrashReporter;
+  private initialDeepLinkUrl?: string;
   private linkingSubscription?: EmitterSubscription;
 
   config: Config;
@@ -142,7 +153,16 @@ export class FormoAnalytics implements IFormoAnalytics {
     // is a fast native bridge call; the Android Play Install Referrer is a fast
     // one-shot native call (and no-ops instantly when the native module or the
     // platform isn't Android), so awaiting it does not meaningfully delay init.
-    if (analytics.isAttributionEnabled("deeplinks")) {
+    // Hook Linking if EITHER consumer needs it. The two flags control different
+    // things — attribution.deeplinks parses UTMs into context, autocapture
+    // .deepLinks emits Deep Link Opened — but both depend on observing the link
+    // in the first place. Gating the hook on attribution alone silently
+    // disabled the event for anyone who turned attribution off, with no
+    // indication that an unrelated setting was responsible.
+    if (
+      analytics.isAttributionEnabled("deeplinks") ||
+      analytics.isAutocaptureEnabled("deepLinks")
+    ) {
       try {
         await analytics.startDeepLinkCapture();
       } catch (error) {
@@ -166,12 +186,32 @@ export class FormoAnalytics implements IFormoAnalytics {
     if (analytics.isAutocaptureEnabled("lifecycle")) {
       try {
         analytics.lifecycleManager = new AppLifecycleManager(analytics);
-        await analytics.lifecycleManager.start(options?.app);
+        await analytics.lifecycleManager.start(options?.app, {
+          trackForegrounded: analytics.isAutocaptureEnabled("foregrounded"),
+        });
       } catch (error) {
         logger.error("FormoAnalytics: Failed to initialize lifecycle tracking", error);
       }
     }
 
+    // Emit Deep Link Opened for the launch URL AFTER lifecycle tracking, so it
+    // follows Application Opened as the Segment spec orders it.
+    try {
+      await analytics.trackInitialDeepLink();
+    } catch (error) {
+      logger.error("FormoAnalytics: Failed to track initial deep link", error);
+    }
+
+    // Opt-in: installs a global JS error handler (chained, never swallowing).
+    if (analytics.isAutocaptureEnabled("crashes")) {
+      try {
+        analytics.crashReporter = new CrashReporter(analytics);
+        analytics.crashReporter.start();
+      } catch (error) {
+        logger.error("FormoAnalytics: Failed to initialize crash tracking", error);
+      }
+    }
+
     // Call ready callback
     if (options?.ready) {
       options.ready(analytics);
@@ -188,17 +228,102 @@ export class FormoAnalytics implements IFormoAnalytics {
   private async startDeepLinkCapture(): Promise<void> {
     try {
       const url = await Linking.getInitialURL();
-      if (url) this.setTrafficSourceFromUrl(url);
+      if (url) {
+        if (this.isAttributionEnabled("deeplinks")) {
+          this.setTrafficSourceFromUrl(url);
+        }
+        // Held, not emitted: this runs before lifecycle tracking starts, and
+        // the Segment spec orders `Deep Link Opened` after `Application
+        // Opened`. Emitted by trackInitialDeepLink() once lifecycle has fired.
+        this.initialDeepLinkUrl = url;
+      }
     } catch (error) {
       logger.debug("FormoAnalytics: Linking.getInitialURL failed", error);
     }
 
     // Runtime deep links (foreground opens, universal links).
     this.linkingSubscription = Linking.addEventListener("url", (event) => {
-      if (event?.url) this.setTrafficSourceFromUrl(event.url);
+      if (!event?.url) return;
+      // Each behaviour checks its own flag: the hook may exist because only one
+      // of them is enabled.
+      if (this.isAttributionEnabled("deeplinks")) {
+        this.setTrafficSourceFromUrl(event.url);
+      }
+      void this.trackDeepLinkOpened(event.url);
     });
   }
 
+  /**
+   * Emit `Deep Link Opened` for the URL the app was launched with, if any.
+   * Separate from capture so it can be ordered after `Application Opened`.
+   */
+  private async trackInitialDeepLink(): Promise<void> {
+    const url = this.initialDeepLinkUrl;
+    this.initialDeepLinkUrl = undefined;
+    if (url) await this.trackDeepLinkOpened(url);
+  }
+
+  /**
+   * Emit the Segment-spec `Deep Link Opened` event.
+   *
+   * `provider` is deliberately omitted: the spec uses it to name the
+   * attribution provider that resolved the link (Branch, Adjust, …). The SDK
+   * reads the link straight from React Native's Linking API, so there is no
+   * provider to name, and emitting a placeholder would misreport the source.
+   */
+  private async trackDeepLinkOpened(url: string): Promise<void> {
+    if (!this.isAutocaptureEnabled("deepLinks")) return;
+    try {
+      await this.track(LIFECYCLE_EVENT.DEEP_LINK_OPENED, { url });
+    } catch (error) {
+      logger.error("FormoAnalytics: Error tracking Deep Link Opened", error);
+    }
+  }
+
+  /**
+   * Track that a push notification was delivered to the device.
+   *
+   * Push delivery cannot be observed without a native module, so the SDK
+   * cannot autocapture these — call this from your push handler
+   * (`@react-native-firebase/messaging`, `expo-notifications`, …).
+   *
+   * @param properties Segment's push spec suggests `campaign_id`, `campaign_name`,
+   *   `message_id`, `action` and `title`/`body`. Any properties are accepted.
+   *
+   * @example
+   * ```tsx
+   * messaging().onMessage(async (message) => {
+   *   await formo.pushNotificationReceived({ message_id: message.messageId });
+   * });
+   * ```
+   */
+  public async pushNotificationReceived(
+    properties?: IFormoEventProperties
+  ): Promise<void> {
+    await this.track(LIFECYCLE_EVENT.PUSH_NOTIFICATION_RECEIVED, properties);
+  }
+
+  /**
+   * Track that the user opened the app by tapping a push notification.
+   * See {@link pushNotificationReceived} for why this is not autocaptured.
+   */
+  public async pushNotificationTapped(
+    properties?: IFormoEventProperties
+  ): Promise<void> {
+    await this.track(LIFECYCLE_EVENT.PUSH_NOTIFICATION_TAPPED, properties);
+  }
+
+  /**
+   * Track that a push notification was not delivered — e.g. the OS suppressed
+   * it, or the device token was rejected.
+   * See {@link pushNotificationReceived} for why this is not autocaptured.
+   */
+  public async pushNotificationBounced(
+    properties?: IFormoEventProperties
+  ): Promise<void> {
+    await this.track(LIFECYCLE_EVENT.PUSH_NOTIFICATION_BOUNCED, properties);
+  }
+
   /**
    * Track a screen view (mobile equivalent of page view)
    */
@@ -272,6 +397,11 @@ export class FormoAnalytics implements IFormoAnalytics {
   public async cleanup(): Promise<void> {
     logger.info("FormoAnalytics: Cleaning up resources");
 
+    if (this.crashReporter) {
+      this.crashReporter.cleanup();
+      this.crashReporter = undefined;
+    }
+
     if (this.lifecycleManager) {
       this.lifecycleManager.cleanup();
       this.lifecycleManager = undefined;
@@ -631,6 +761,12 @@ export class FormoAnalytics implements IFormoAnalytics {
    * Applies only to event-generating behaviors (wallet events, lifecycle
    * events). Attribution is controlled separately via `options.attribution`
    * because it enriches events rather than generating them.
+   *
+   * Most behaviors are on unless explicitly disabled. The two in
+   * {@link OPT_IN_AUTOCAPTURE} invert that and require an explicit `true`,
+   * because switching them on by default would change existing apps on a
+   * version bump: `foregrounded` doubles foreground event volume, and
+   * `crashes` installs a global error handler.
    */
   public isAutocaptureEnabled(
     eventType:
@@ -640,13 +776,20 @@ export class FormoAnalytics implements IFormoAnalytics {
       | "transaction"
       | "chain"
       | "lifecycle"
+      | "foregrounded"
+      | "deepLinks"
+      | "crashes"
   ): boolean {
+    const isOptIn = OPT_IN_AUTOCAPTURE.has(eventType);
+
     if (this.options.autocapture === undefined) {
-      return true;
+      return !isOptIn;
     }
 
+    // `autocapture: true` means "the usual set", not "everything including the
+    // opt-in behaviors" — those still need naming individually.
     if (typeof this.options.autocapture === "boolean") {
-      return this.options.autocapture;
+      return this.options.autocapture && !isOptIn;
     }
 
     if (
@@ -654,10 +797,10 @@ export class FormoAnalytics implements IFormoAnalytics {
       typeof this.options.autocapture === "object"
     ) {
       const eventConfig = this.options.autocapture[eventType];
-      return eventConfig !== false;
+      return isOptIn ? eventConfig === true : eventConfig !== false;
     }
 
-    return true;
+    return !isOptIn;
   }
 
   /**

package/src/FormoAnalyticsProvider.tsx

@@ -25,6 +25,9 @@ const defaultContext: IFormoAnalytics = {
   transaction: () => Promise.resolve(),
   identify: () => Promise.resolve(),
   track: () => Promise.resolve(),
+  pushNotificationReceived: () => Promise.resolve(),
+  pushNotificationTapped: () => Promise.resolve(),
+  pushNotificationBounced: () => Promise.resolve(),
   flush: () => Promise.resolve(),
   setTrafficSourceFromUrl: () => {},
   optOutTracking: () => {},

package/src/constants/events.ts

@@ -25,6 +25,36 @@ export type TEventChannel = Lowercase<EventChannel>;
 export const CHANNEL: TEventChannel = "mobile";
 export const VERSION = "0";
 
-// Session inactivity timeout (30 min), matching the GA4/Segment default. A new
-// session_id is minted once the gap since the last tracked event exceeds this.
+// Session inactivity timeout (30 min), matching the GA4 default and Formo's own
+// web SDK. A new session_id is minted once the gap since the last tracked event
+// exceeds this. Note that mobile-first vendors run tighter: RudderStack and
+// Amplitude both default to 5 min on mobile (vs 30 on web) and rotate on
+// foreground rather than on inactivity. We keep 30 min so a user's mobile and
+// web sessions are directly comparable.
 export const SESSION_TIMEOUT_MS = 30 * 60 * 1000;
+
+/**
+ * Reserved lifecycle and campaign event names, per the Segment spec that
+ * RudderStack, PostHog and Amplitude all adopted verbatim.
+ *
+ * These are ordinary `track` events on the wire — the names are what make them
+ * recognisable to downstream analytics, so they must match the spec exactly,
+ * including capitalisation and spacing.
+ *
+ * @see https://segment.com/docs/connections/spec/mobile/
+ */
+export const LIFECYCLE_EVENT = {
+  APPLICATION_INSTALLED: "Application Installed",
+  APPLICATION_UPDATED: "Application Updated",
+  APPLICATION_OPENED: "Application Opened",
+  APPLICATION_BACKGROUNDED: "Application Backgrounded",
+  APPLICATION_FOREGROUNDED: "Application Foregrounded",
+  APPLICATION_CRASHED: "Application Crashed",
+  DEEP_LINK_OPENED: "Deep Link Opened",
+  PUSH_NOTIFICATION_RECEIVED: "Push Notification Received",
+  PUSH_NOTIFICATION_TAPPED: "Push Notification Tapped",
+  PUSH_NOTIFICATION_BOUNCED: "Push Notification Bounced",
+} as const;
+
+export type TLifecycleEvent =
+  (typeof LIFECYCLE_EVENT)[keyof typeof LIFECYCLE_EVENT];