@truewatchtech/mobile-react-native-navigation 0.0.0-stage → 0.4.3

package/README.md

@@ -1,3 +1,77 @@
-# Temporary Holding Version
+# TrueWatch React Native Navigation plugin
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+This plugin tracks Wix `react-native-navigation` screen appearances as TrueWatch
+RUM Views and measures appearance loading.
+
+## Installation
+
+```sh
+yarn add @truewatchtech/react-native-mobile @truewatchtech/mobile-react-native-navigation
+```
+
+Keep your existing `react-native-navigation` dependency and its native setup.
+This plugin contains only JavaScript and types; it adds no native linking or
+build configuration.
+
+## View tracking
+
+Initialize the mobile SDK and RUM, then start tracking before displaying the
+navigation root:
+
+```ts
+import { Navigation } from 'react-native-navigation';
+import { FTRumReactNativeNavigationTracking } from '@truewatchtech/mobile-react-native-navigation';
+
+FTRumReactNativeNavigationTracking.startTracking();
+
+Navigation.events().registerAppLaunchedListener(() => {
+  // Register your screens, then display the root as usual.
+  void Navigation.setRoot({
+    root: { stack: { children: [{ component: { name: 'Home' } }] } },
+  });
+});
+
+// Before shutting down the SDK or disposing the navigation integration:
+FTRumReactNativeNavigationTracking.stopTracking();
+```
+
+`startTracking()` is idempotent. `stopTracking()` removes all registered global screen
+listeners and the AppState subscription. You can start tracking again; callbacks
+queued by an old registration cannot restart or stop the new registration's View.
+Starting after a screen is already visible only tracks subsequent appearance
+events, so start before `setRoot`.
+
+The plugin listens directly to `componentDidAppear` and `componentDidDisappear`,
+and to `componentWillAppear` when the navigation library exposes it. It works
+without patching `React.createElement` and also
+covers screens using the automatic JSX runtime. Only events with
+`componentType: 'Component'` are treated as screens. Top bar titles, backgrounds,
+and buttons are excluded. `componentName` becomes the View name and `componentId`
+identifies the screen instance.
+
+## Loading and lifecycle
+
+Loading is the monotonic elapsed time from `componentWillAppear` to
+`componentDidAppear`, reported in nanoseconds: 25.5 ms is 25,500,000 ns. This is the
+observed appearance interval, not the completion of asynchronous content loading.
+If the navigation library has no will-appear API, Views are collected without
+loading data. Missing starts and non-positive durations also omit loading data.
+Duplicate callbacks do not submit loading twice. Native closes automatic Views in
+the background; foreground recovery starts the current screen without replaying
+old loading data. A late disappearance from the previous screen cannot close a
+different active screen.
+
+Use one automatic navigation integration at a time. The SDK has one active View;
+when multiple screens are simultaneously visible, the latest accepted appearance
+owns it. This package does not need React Navigation or
+`@truewatchtech/mobile-react-navigation`.
+
+## Migration
+
+Replace the copied `example/src/FTRumReactNativeNavigationTracking.tsx` import
+with `@truewatchtech/mobile-react-native-navigation`, retaining the class name and
+methods. Remove the copied implementation so it cannot collect Views twice.
+
+## License
+
+Apache 2.0

package/lib/commonjs/FTRumReactNativeNavigationTracking.js

@@ -0,0 +1,85 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.FTRumReactNativeNavigationTracking = void 0;
+var _reactNativeNavigation = require("react-native-navigation");
+var _reactNativeMobile = require("@truewatchtech/react-native-mobile");
+function _defineProperty(e, r, t) { return (r = _toPropertyKey(r)) in e ? Object.defineProperty(e, r, { value: t, enumerable: !0, configurable: !0, writable: !0 }) : e[r] = t, e; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == typeof i ? i : i + ""; }
+function _toPrimitive(t, r) { if ("object" != typeof t || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != typeof i) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+/** Tracks screen events directly, including screens rendered with the JSX runtime. */
+class FTRumReactNativeNavigationTracking {
+  /** Call after RUM initialization and before displaying the navigation root. */
+  static startTracking() {
+    if (this.subscriptions.length) return;
+    const lifecycle = ++this.lifecycle;
+    const current = () => lifecycle === this.lifecycle;
+    this.tracker.start();
+    const events = _reactNativeNavigation.Navigation.events();
+    try {
+      // Older releases expose only did-appear/disappear. Without a start
+      // boundary, collect Views without reporting an appearance duration.
+      if (typeof events.registerComponentWillAppearListener === 'function') {
+        this.subscriptions.push(events.registerComponentWillAppearListener(event => {
+          if (!current() || event.componentType !== 'Component') return;
+          const key = event.componentId;
+          const existing = this.appearances.get(key);
+          // A duplicate will-appear must not replace the original loading start.
+          if (!existing || existing.order !== this.appearance) {
+            this.appearances.set(key, {
+              order: ++this.appearance
+            });
+          }
+          this.tracker.setCurrent({
+            key,
+            name: event.componentName
+          });
+          this.tracker.beginLoad(key);
+        }));
+      }
+      this.subscriptions.push(events.registerComponentDidAppearListener(event => {
+        var _appearance$order;
+        if (!current() || event.componentType !== 'Component') return;
+        const key = event.componentId;
+        const appearance = this.appearances.get(key);
+        if (appearance && appearance.order !== this.appearance) return;
+        const generation = this.tracker.show({
+          key,
+          name: event.componentName
+        });
+        this.appearances.set(key, {
+          order: (_appearance$order = appearance === null || appearance === void 0 ? void 0 : appearance.order) !== null && _appearance$order !== void 0 ? _appearance$order : ++this.appearance,
+          generation
+        });
+      }));
+      this.subscriptions.push(events.registerComponentDidDisappearListener(event => {
+        if (!current() || event.componentType !== 'Component') return;
+        const key = event.componentId;
+        const appearance = this.appearances.get(key);
+        if (!appearance) return;
+        // Retain the appearance's generation: foreground recovery owns a new one.
+        this.tracker.hide(key, appearance.generation);
+        this.appearances.delete(key);
+      }));
+    } catch (error) {
+      this.stopTracking();
+      throw error;
+    }
+  }
+  static stopTracking() {
+    ++this.lifecycle;
+    this.subscriptions.forEach(subscription => subscription.remove());
+    this.subscriptions = [];
+    this.appearances.clear();
+    this.tracker.stop();
+  }
+}
+exports.FTRumReactNativeNavigationTracking = FTRumReactNativeNavigationTracking;
+_defineProperty(FTRumReactNativeNavigationTracking, "tracker", new _reactNativeMobile.FTRumViewTracking());
+_defineProperty(FTRumReactNativeNavigationTracking, "subscriptions", []);
+_defineProperty(FTRumReactNativeNavigationTracking, "appearances", new Map());
+_defineProperty(FTRumReactNativeNavigationTracking, "appearance", 0);
+_defineProperty(FTRumReactNativeNavigationTracking, "lifecycle", 0);
+//# sourceMappingURL=FTRumReactNativeNavigationTracking.js.map

package/lib/commonjs/FTRumReactNativeNavigationTracking.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_reactNativeNavigation","require","_reactNativeMobile","_defineProperty","e","r","t","_toPropertyKey","Object","defineProperty","value","enumerable","configurable","writable","i","_toPrimitive","Symbol","toPrimitive","call","TypeError","String","Number","FTRumReactNativeNavigationTracking","startTracking","subscriptions","length","lifecycle","current","tracker","start","events","Navigation","registerComponentWillAppearListener","push","event","componentType","key","componentId","existing","appearances","get","order","appearance","set","setCurrent","name","componentName","beginLoad","registerComponentDidAppearListener","_appearance$order","generation","show","registerComponentDidDisappearListener","hide","delete","error","stopTracking","forEach","subscription","remove","clear","stop","exports","FTRumViewTracking","Map"],"sources":["FTRumReactNativeNavigationTracking.ts"],"sourcesContent":["import { Navigation } from 'react-native-navigation';\nimport { FTRumViewTracking } from '@truewatchtech/react-native-mobile';\n\ntype Appearance = { order: number; generation?: number };\n\n/** Tracks screen events directly, including screens rendered with the JSX runtime. */\nexport class FTRumReactNativeNavigationTracking {\n  private static tracker = new FTRumViewTracking();\n  private static subscriptions: { remove(): void }[] = [];\n  private static appearances = new Map<string, Appearance>();\n  private static appearance = 0;\n  private static lifecycle = 0;\n\n  /** Call after RUM initialization and before displaying the navigation root. */\n  static startTracking(): void {\n    if (this.subscriptions.length) return;\n    const lifecycle = ++this.lifecycle;\n    const current = (): boolean => lifecycle === this.lifecycle;\n    this.tracker.start();\n    const events = Navigation.events();\n    try {\n      // Older releases expose only did-appear/disappear. Without a start\n      // boundary, collect Views without reporting an appearance duration.\n      if (typeof events.registerComponentWillAppearListener === 'function') {\n        this.subscriptions.push(\n          events.registerComponentWillAppearListener((event) => {\n            if (!current() || event.componentType !== 'Component') return;\n            const key = event.componentId;\n            const existing = this.appearances.get(key);\n            // A duplicate will-appear must not replace the original loading start.\n            if (!existing || existing.order !== this.appearance) {\n              this.appearances.set(key, { order: ++this.appearance });\n            }\n            this.tracker.setCurrent({ key, name: event.componentName });\n            this.tracker.beginLoad(key);\n          })\n        );\n      }\n      this.subscriptions.push(\n        events.registerComponentDidAppearListener((event) => {\n          if (!current() || event.componentType !== 'Component') return;\n          const key = event.componentId;\n          const appearance = this.appearances.get(key);\n          if (appearance && appearance.order !== this.appearance) return;\n          const generation = this.tracker.show({\n            key,\n            name: event.componentName,\n          });\n          this.appearances.set(key, {\n            order: appearance?.order ?? ++this.appearance,\n            generation,\n          });\n        })\n      );\n      this.subscriptions.push(\n        events.registerComponentDidDisappearListener((event) => {\n          if (!current() || event.componentType !== 'Component') return;\n          const key = event.componentId;\n          const appearance = this.appearances.get(key);\n          if (!appearance) return;\n          // Retain the appearance's generation: foreground recovery owns a new one.\n          this.tracker.hide(key, appearance.generation);\n          this.appearances.delete(key);\n        })\n      );\n    } catch (error) {\n      this.stopTracking();\n      throw error;\n    }\n  }\n\n  static stopTracking(): void {\n    ++this.lifecycle;\n    this.subscriptions.forEach((subscription) => subscription.remove());\n    this.subscriptions = [];\n    this.appearances.clear();\n    this.tracker.stop();\n  }\n}\n"],"mappings":"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","ignoreList":[]}

package/lib/commonjs/index.js

@@ -0,0 +1,13 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+Object.defineProperty(exports, "FTRumReactNativeNavigationTracking", {
+  enumerable: true,
+  get: function () {
+    return _FTRumReactNativeNavigationTracking.FTRumReactNativeNavigationTracking;
+  }
+});
+var _FTRumReactNativeNavigationTracking = require("./FTRumReactNativeNavigationTracking");
+//# sourceMappingURL=index.js.map

package/lib/commonjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_FTRumReactNativeNavigationTracking","require"],"sources":["index.ts"],"sourcesContent":["export { FTRumReactNativeNavigationTracking } from './FTRumReactNativeNavigationTracking';\n"],"mappings":";;;;;;;;;;;AAAA,IAAAA,mCAAA,GAAAC,OAAA","ignoreList":[]}

package/lib/module/FTRumReactNativeNavigationTracking.js

@@ -0,0 +1,78 @@
+function _defineProperty(e, r, t) { return (r = _toPropertyKey(r)) in e ? Object.defineProperty(e, r, { value: t, enumerable: !0, configurable: !0, writable: !0 }) : e[r] = t, e; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == typeof i ? i : i + ""; }
+function _toPrimitive(t, r) { if ("object" != typeof t || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != typeof i) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+import { Navigation } from 'react-native-navigation';
+import { FTRumViewTracking } from '@truewatchtech/react-native-mobile';
+/** Tracks screen events directly, including screens rendered with the JSX runtime. */
+export class FTRumReactNativeNavigationTracking {
+  /** Call after RUM initialization and before displaying the navigation root. */
+  static startTracking() {
+    if (this.subscriptions.length) return;
+    const lifecycle = ++this.lifecycle;
+    const current = () => lifecycle === this.lifecycle;
+    this.tracker.start();
+    const events = Navigation.events();
+    try {
+      // Older releases expose only did-appear/disappear. Without a start
+      // boundary, collect Views without reporting an appearance duration.
+      if (typeof events.registerComponentWillAppearListener === 'function') {
+        this.subscriptions.push(events.registerComponentWillAppearListener(event => {
+          if (!current() || event.componentType !== 'Component') return;
+          const key = event.componentId;
+          const existing = this.appearances.get(key);
+          // A duplicate will-appear must not replace the original loading start.
+          if (!existing || existing.order !== this.appearance) {
+            this.appearances.set(key, {
+              order: ++this.appearance
+            });
+          }
+          this.tracker.setCurrent({
+            key,
+            name: event.componentName
+          });
+          this.tracker.beginLoad(key);
+        }));
+      }
+      this.subscriptions.push(events.registerComponentDidAppearListener(event => {
+        var _appearance$order;
+        if (!current() || event.componentType !== 'Component') return;
+        const key = event.componentId;
+        const appearance = this.appearances.get(key);
+        if (appearance && appearance.order !== this.appearance) return;
+        const generation = this.tracker.show({
+          key,
+          name: event.componentName
+        });
+        this.appearances.set(key, {
+          order: (_appearance$order = appearance === null || appearance === void 0 ? void 0 : appearance.order) !== null && _appearance$order !== void 0 ? _appearance$order : ++this.appearance,
+          generation
+        });
+      }));
+      this.subscriptions.push(events.registerComponentDidDisappearListener(event => {
+        if (!current() || event.componentType !== 'Component') return;
+        const key = event.componentId;
+        const appearance = this.appearances.get(key);
+        if (!appearance) return;
+        // Retain the appearance's generation: foreground recovery owns a new one.
+        this.tracker.hide(key, appearance.generation);
+        this.appearances.delete(key);
+      }));
+    } catch (error) {
+      this.stopTracking();
+      throw error;
+    }
+  }
+  static stopTracking() {
+    ++this.lifecycle;
+    this.subscriptions.forEach(subscription => subscription.remove());
+    this.subscriptions = [];
+    this.appearances.clear();
+    this.tracker.stop();
+  }
+}
+_defineProperty(FTRumReactNativeNavigationTracking, "tracker", new FTRumViewTracking());
+_defineProperty(FTRumReactNativeNavigationTracking, "subscriptions", []);
+_defineProperty(FTRumReactNativeNavigationTracking, "appearances", new Map());
+_defineProperty(FTRumReactNativeNavigationTracking, "appearance", 0);
+_defineProperty(FTRumReactNativeNavigationTracking, "lifecycle", 0);
+//# sourceMappingURL=FTRumReactNativeNavigationTracking.js.map

package/lib/module/FTRumReactNativeNavigationTracking.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["Navigation","FTRumViewTracking","FTRumReactNativeNavigationTracking","startTracking","subscriptions","length","lifecycle","current","tracker","start","events","registerComponentWillAppearListener","push","event","componentType","key","componentId","existing","appearances","get","order","appearance","set","setCurrent","name","componentName","beginLoad","registerComponentDidAppearListener","_appearance$order","generation","show","registerComponentDidDisappearListener","hide","delete","error","stopTracking","forEach","subscription","remove","clear","stop","_defineProperty","Map"],"sources":["FTRumReactNativeNavigationTracking.ts"],"sourcesContent":["import { Navigation } from 'react-native-navigation';\nimport { FTRumViewTracking } from '@truewatchtech/react-native-mobile';\n\ntype Appearance = { order: number; generation?: number };\n\n/** Tracks screen events directly, including screens rendered with the JSX runtime. */\nexport class FTRumReactNativeNavigationTracking {\n  private static tracker = new FTRumViewTracking();\n  private static subscriptions: { remove(): void }[] = [];\n  private static appearances = new Map<string, Appearance>();\n  private static appearance = 0;\n  private static lifecycle = 0;\n\n  /** Call after RUM initialization and before displaying the navigation root. */\n  static startTracking(): void {\n    if (this.subscriptions.length) return;\n    const lifecycle = ++this.lifecycle;\n    const current = (): boolean => lifecycle === this.lifecycle;\n    this.tracker.start();\n    const events = Navigation.events();\n    try {\n      // Older releases expose only did-appear/disappear. Without a start\n      // boundary, collect Views without reporting an appearance duration.\n      if (typeof events.registerComponentWillAppearListener === 'function') {\n        this.subscriptions.push(\n          events.registerComponentWillAppearListener((event) => {\n            if (!current() || event.componentType !== 'Component') return;\n            const key = event.componentId;\n            const existing = this.appearances.get(key);\n            // A duplicate will-appear must not replace the original loading start.\n            if (!existing || existing.order !== this.appearance) {\n              this.appearances.set(key, { order: ++this.appearance });\n            }\n            this.tracker.setCurrent({ key, name: event.componentName });\n            this.tracker.beginLoad(key);\n          })\n        );\n      }\n      this.subscriptions.push(\n        events.registerComponentDidAppearListener((event) => {\n          if (!current() || event.componentType !== 'Component') return;\n          const key = event.componentId;\n          const appearance = this.appearances.get(key);\n          if (appearance && appearance.order !== this.appearance) return;\n          const generation = this.tracker.show({\n            key,\n            name: event.componentName,\n          });\n          this.appearances.set(key, {\n            order: appearance?.order ?? ++this.appearance,\n            generation,\n          });\n        })\n      );\n      this.subscriptions.push(\n        events.registerComponentDidDisappearListener((event) => {\n          if (!current() || event.componentType !== 'Component') return;\n          const key = event.componentId;\n          const appearance = this.appearances.get(key);\n          if (!appearance) return;\n          // Retain the appearance's generation: foreground recovery owns a new one.\n          this.tracker.hide(key, appearance.generation);\n          this.appearances.delete(key);\n        })\n      );\n    } catch (error) {\n      this.stopTracking();\n      throw error;\n    }\n  }\n\n  static stopTracking(): void {\n    ++this.lifecycle;\n    this.subscriptions.forEach((subscription) => subscription.remove());\n    this.subscriptions = [];\n    this.appearances.clear();\n    this.tracker.stop();\n  }\n}\n"],"mappings":"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","ignoreList":[]}

package/lib/module/index.js

@@ -0,0 +1,2 @@
+export { FTRumReactNativeNavigationTracking } from './FTRumReactNativeNavigationTracking';
+//# sourceMappingURL=index.js.map

package/lib/module/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["FTRumReactNativeNavigationTracking"],"sources":["index.ts"],"sourcesContent":["export { FTRumReactNativeNavigationTracking } from './FTRumReactNativeNavigationTracking';\n"],"mappings":"AAAA,SAASA,kCAAkC,QAAQ,sCAAsC","ignoreList":[]}

package/lib/typescript/FTRumReactNativeNavigationTracking.d.ts

@@ -0,0 +1,11 @@
+/** Tracks screen events directly, including screens rendered with the JSX runtime. */
+export declare class FTRumReactNativeNavigationTracking {
+    private static tracker;
+    private static subscriptions;
+    private static appearances;
+    private static appearance;
+    private static lifecycle;
+    /** Call after RUM initialization and before displaying the navigation root. */
+    static startTracking(): void;
+    static stopTracking(): void;
+}

package/lib/typescript/index.d.ts

@@ -0,0 +1 @@
+export { FTRumReactNativeNavigationTracking } from './FTRumReactNativeNavigationTracking';

package/package.json

@@ -1,6 +1,64 @@
 {
   "name": "@truewatchtech/mobile-react-native-navigation",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.4.3",
+  "description": "Automatic TrueWatch RUM View tracking for react-native-navigation.",
+  "main": "lib/commonjs/index",
+  "module": "lib/module/index",
+  "types": "lib/typescript/index.d.ts",
+  "react-native": "src/index",
+  "source": "src/index",
+  "files": [
+    "src",
+    "lib",
+    "README.md",
+    "!**/__tests__",
+    "!**/__mocks__"
+  ],
+  "scripts": {
+    "lint": "yarn run -T eslint \"src/**/*.{ts,tsx}\" \"tests/**/*.ts\"",
+    "prepare": "yarn run -T bob build",
+    "prepack": "yarn run -T check-version && yarn prepare",
+    "test": "yarn run -T jest",
+    "typescript": "yarn run -T tsc --noEmit"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/TrueWatchTech/datakit-react-native.git"
+  },
+  "license": "Apache-2.0",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "peerDependencies": {
+    "@truewatchtech/react-native-mobile": "^0.4.3",
+    "react": ">=16.13.1",
+    "react-native": ">=0.63.4 <1.0",
+    "react-native-navigation": "^7.5.0"
+  },
+  "devDependencies": {
+    "react-native-navigation": "7.40.1"
+  },
+  "react-native-builder-bob": {
+    "source": "src",
+    "output": "lib",
+    "targets": [
+      "commonjs",
+      "module",
+      [
+        "typescript",
+        {
+          "tsc": "../../node_modules/.bin/tsc",
+          "project": "tsconfig.build.json"
+        }
+      ]
+    ]
+  },
+  "jest": {
+    "preset": "react-native",
+    "modulePathIgnorePatterns": [
+      "<rootDir>/lib/"
+    ]
+  },
+  "gitHead": "61ed39427761a210cbfe6b339e71296f952f9697"
 }

package/src/FTRumReactNativeNavigationTracking.ts

@@ -0,0 +1,79 @@
+import { Navigation } from 'react-native-navigation';
+import { FTRumViewTracking } from '@truewatchtech/react-native-mobile';
+
+type Appearance = { order: number; generation?: number };
+
+/** Tracks screen events directly, including screens rendered with the JSX runtime. */
+export class FTRumReactNativeNavigationTracking {
+  private static tracker = new FTRumViewTracking();
+  private static subscriptions: { remove(): void }[] = [];
+  private static appearances = new Map<string, Appearance>();
+  private static appearance = 0;
+  private static lifecycle = 0;
+
+  /** Call after RUM initialization and before displaying the navigation root. */
+  static startTracking(): void {
+    if (this.subscriptions.length) return;
+    const lifecycle = ++this.lifecycle;
+    const current = (): boolean => lifecycle === this.lifecycle;
+    this.tracker.start();
+    const events = Navigation.events();
+    try {
+      // Older releases expose only did-appear/disappear. Without a start
+      // boundary, collect Views without reporting an appearance duration.
+      if (typeof events.registerComponentWillAppearListener === 'function') {
+        this.subscriptions.push(
+          events.registerComponentWillAppearListener((event) => {
+            if (!current() || event.componentType !== 'Component') return;
+            const key = event.componentId;
+            const existing = this.appearances.get(key);
+            // A duplicate will-appear must not replace the original loading start.
+            if (!existing || existing.order !== this.appearance) {
+              this.appearances.set(key, { order: ++this.appearance });
+            }
+            this.tracker.setCurrent({ key, name: event.componentName });
+            this.tracker.beginLoad(key);
+          })
+        );
+      }
+      this.subscriptions.push(
+        events.registerComponentDidAppearListener((event) => {
+          if (!current() || event.componentType !== 'Component') return;
+          const key = event.componentId;
+          const appearance = this.appearances.get(key);
+          if (appearance && appearance.order !== this.appearance) return;
+          const generation = this.tracker.show({
+            key,
+            name: event.componentName,
+          });
+          this.appearances.set(key, {
+            order: appearance?.order ?? ++this.appearance,
+            generation,
+          });
+        })
+      );
+      this.subscriptions.push(
+        events.registerComponentDidDisappearListener((event) => {
+          if (!current() || event.componentType !== 'Component') return;
+          const key = event.componentId;
+          const appearance = this.appearances.get(key);
+          if (!appearance) return;
+          // Retain the appearance's generation: foreground recovery owns a new one.
+          this.tracker.hide(key, appearance.generation);
+          this.appearances.delete(key);
+        })
+      );
+    } catch (error) {
+      this.stopTracking();
+      throw error;
+    }
+  }
+
+  static stopTracking(): void {
+    ++this.lifecycle;
+    this.subscriptions.forEach((subscription) => subscription.remove());
+    this.subscriptions = [];
+    this.appearances.clear();
+    this.tracker.stop();
+  }
+}

package/src/index.ts

@@ -0,0 +1 @@
+export { FTRumReactNativeNavigationTracking } from './FTRumReactNativeNavigationTracking';