react-native-netmera 2.0.1 → 2.1.0-alpha02

package/lib/typescript/src/NetmeraAnalyticProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NetmeraAnalyticProvider.d.ts","sourceRoot":"","sources":["../../../src/NetmeraAnalyticProvider.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAsC,MAAM,OAAO,CAAC;AAU3D,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B;;;;;;;;;;;OAWG;IACH,aAAa,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;CACtC;AAQD;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,EACtC,QAAQ,EACR,aAAa,GACd,EAAE,4BAA4B,2CAwE9B"}

package/lib/typescript/src/autotracking/NetmeraNavigationState.d.ts

@@ -0,0 +1,3 @@
+export declare function getCurrentScreen(): string | null;
+export declare function setCurrentScreen(name: string): void;
+//# sourceMappingURL=NetmeraNavigationState.d.ts.map

package/lib/typescript/src/autotracking/NetmeraNavigationState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NetmeraNavigationState.d.ts","sourceRoot":"","sources":["../../../../src/autotracking/NetmeraNavigationState.ts"],"names":[],"mappings":"AAMA,wBAAgB,gBAAgB,IAAI,MAAM,GAAG,IAAI,CAEhD;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAEnD"}

package/lib/typescript/src/autotracking/useNavigationTracking.d.ts

@@ -0,0 +1,13 @@
+import React from 'react';
+/**
+ * Subscribes to React Navigation screen changes and keeps NetmeraNavigationState
+ * up to date. Resolves the navigation container ref via two paths:
+ *
+ * - New Arch (Fabric): auto-detected through the fiber tree via viewRef.
+ * - Old Arch (Paper):  caller passes navigationRef prop explicitly.
+ *
+ * Silently no-ops if neither path yields a valid ref.
+ * Respects the isScreenFlowEnabled flag — screen changes are ignored when disabled.
+ */
+export declare function useNavigationTracking(viewRef: React.RefObject<any>, navigationRef: React.RefObject<any> | undefined, enabled: boolean, screenLogEnabled: boolean): void;
+//# sourceMappingURL=useNavigationTracking.d.ts.map

package/lib/typescript/src/autotracking/useNavigationTracking.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useNavigationTracking.d.ts","sourceRoot":"","sources":["../../../../src/autotracking/useNavigationTracking.ts"],"names":[],"mappings":"AAIA,OAAO,KAA4B,MAAM,OAAO,CAAC;AAkCjD;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,EAC7B,aAAa,EAAE,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,SAAS,EAC/C,OAAO,EAAE,OAAO,EAChB,gBAAgB,EAAE,OAAO,GACxB,IAAI,CA4EN"}

package/lib/typescript/src/autotracking/useTapTracking.d.ts

@@ -0,0 +1,6 @@
+import type { GestureResponderEvent } from 'react-native';
+export declare function useTapTracking(enabled: boolean, shouldCollectValues: boolean): {
+    onTouchStart: (e: GestureResponderEvent) => void;
+    onTouchEnd: (e: GestureResponderEvent) => void;
+};
+//# sourceMappingURL=useTapTracking.d.ts.map

package/lib/typescript/src/autotracking/useTapTracking.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTapTracking.d.ts","sourceRoot":"","sources":["../../../../src/autotracking/useTapTracking.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AA6J1D,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,mBAAmB,EAAE,OAAO;sBA6BtC,qBAAqB;oBAoBvB,qBAAqB;EAwFzD"}

package/lib/typescript/src/index.d.ts

@@ -38,5 +38,7 @@ import { NetmeraProduct } from './events/commerce/NetmeraProduct';
 import { NetmeraEventContentComment } from './events/media/NetmeraEventContentComment';
 import { NetmeraEventContentRate } from './events/media/NetmeraEventContentRate';
 import { NetmeraEventContentView } from './events/media/NetmeraEventContentView';
-export { Netmera, NetmeraCouponObject, NetmeraUser, NetmeraPushObject, NetmeraPushType, NetmeraPushAction, NetmeraPushActionType, NetmeraCarouselObject, NetmeraInteractiveAction, NetmeraInboxFilter, NMInboxStatus, NMInboxStatusCountFilter, NetmeraCategory, NetmeraCategoryFilter, NMCategoryPreference, NotificationPermissionStatus, NetmeraLineItem, NetmeraProduct, NetmeraUserProfile, NetmeraProfileAttribute, NetmeraProfileAttributeCollection, Gender, MaritalStatus, NetmeraEvent, NetmeraEventBannerOpen, NetmeraEventBatteryLevel, NetmeraEventCategoryView, NetmeraEventInAppPurchase, NetmeraEventLogin, NetmeraEventRegister, NetmeraEventScreenView, NetmeraEventSearch, NetmeraEventShare, NetmeraEventCartAddProduct, NetmeraEventCartRemoveProduct, NetmeraEventCartView, NetmeraEventOrderCancel, NetmeraEventProductComment, NetmeraEventProductRate, NetmeraEventProductView, NetmeraEventPurchase, NetmeraEventWishList, NetmeraEventContentComment, NetmeraEventContentRate, NetmeraEventContentView, };
+import { NetmeraAnalyticProvider } from './NetmeraAnalyticProvider';
+import type { NetmeraAnalyticProviderProps } from './NetmeraAnalyticProvider';
+export { Netmera, NetmeraCouponObject, NetmeraUser, NetmeraPushObject, NetmeraPushType, NetmeraPushAction, NetmeraPushActionType, NetmeraCarouselObject, NetmeraInteractiveAction, NetmeraInboxFilter, NMInboxStatus, NMInboxStatusCountFilter, NetmeraCategory, NetmeraCategoryFilter, NMCategoryPreference, NotificationPermissionStatus, NetmeraLineItem, NetmeraProduct, NetmeraUserProfile, NetmeraProfileAttribute, NetmeraProfileAttributeCollection, Gender, MaritalStatus, NetmeraEvent, NetmeraEventBannerOpen, NetmeraEventBatteryLevel, NetmeraEventCategoryView, NetmeraEventInAppPurchase, NetmeraEventLogin, NetmeraEventRegister, NetmeraEventScreenView, NetmeraEventSearch, NetmeraEventShare, NetmeraEventCartAddProduct, NetmeraEventCartRemoveProduct, NetmeraEventCartView, NetmeraEventOrderCancel, NetmeraEventProductComment, NetmeraEventProductRate, NetmeraEventProductView, NetmeraEventPurchase, NetmeraEventWishList, NetmeraEventContentComment, NetmeraEventContentRate, NetmeraEventContentView, NetmeraAnalyticProvider, type NetmeraAnalyticProviderProps, };
 //# sourceMappingURL=index.d.ts.map

package/lib/typescript/src/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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-netmera",
-  "version": "2.0.1",
+  "version": "2.1.0-alpha02",
   "description": "Netmera React Native SDK",
   "source": "./src/index.ts",
   "main": "./lib/module/index.js",

package/src/Netmera.ts

@@ -3,6 +3,7 @@
  */
 
 import { AppRegistry, DeviceEventEmitter } from 'react-native';
+import { getCurrentScreen } from './autotracking/NetmeraNavigationState';
 import NetmeraEvent from './events/NetmeraEvent';
 import NetmeraUser from './models/NetmeraUser';
 import NetmeraInboxFilter from './models/NetmeraInboxFilter';
@@ -391,4 +392,19 @@ export default class Netmera {
   static async getWhatsAppPermission(): Promise<boolean> {
     return RNNetmera.getWhatsAppPermission();
   }
+
+  /**
+   * Manually log a user action for components that don't fire standard
+   * onPress/onValueChange events (e.g. third-party dropdowns, custom pickers).
+   *
+   *   Netmera.trackAction('category-selector|Electronics')
+   *
+   * @param path  Identifier or structured path describing the action.
+   *              Use `|` to separate segments (e.g. `component|value`).
+   */
+  static trackAction(path: string): void {
+    const screen = getCurrentScreen();
+    const entry = screen ? `${screen}|${path}` : path;
+    RNNetmera.trackAction(entry);
+  }
 }

package/src/NetmeraAnalyticProvider.tsx

@@ -0,0 +1,124 @@
+/*
+ * Copyright (c) 2026 Netmera Research.
+ */
+
+import React, { useEffect, useRef, useState } from 'react';
+import {
+  NativeEventEmitter,
+  NativeModules,
+  StyleSheet,
+  View,
+} from 'react-native';
+import { useNavigationTracking } from './autotracking/useNavigationTracking';
+import { useTapTracking } from './autotracking/useTapTracking';
+
+export interface NetmeraAnalyticProviderProps {
+  children: React.ReactNode;
+  /**
+   * Required on Old Architecture (newArchEnabled=false). Pass your NavigationContainer
+   * ref so the provider can subscribe to screen changes.
+   *
+   * On New Architecture the provider detects the navigation context automatically
+   * through the fiber tree — this prop is not needed.
+   *
+   *   const navRef = useRef(null);
+   *   <NetmeraAnalyticProvider navigationRef={navRef}>
+   *     <NavigationContainer ref={navRef}>…</NavigationContainer>
+   *   </NetmeraAnalyticProvider>
+   */
+  navigationRef?: React.RefObject<any>;
+}
+
+type AutoTrackConfig = {
+  isScreenFlowEnabled: boolean;
+  isInputActionEnabled: boolean;
+  shouldCollectValues: boolean;
+};
+
+/**
+ * Wraps your app to enable automatic screen tracking and tap tracking.
+ *
+ *   <NetmeraAnalyticProvider>
+ *     <NavigationContainer>…</NavigationContainer>
+ *   </NetmeraAnalyticProvider>
+ */
+export function NetmeraAnalyticProvider({
+  children,
+  navigationRef,
+}: NetmeraAnalyticProviderProps) {
+  const viewRef = useRef<any>(null);
+  const [config, setConfig] = useState<AutoTrackConfig | null>(null);
+  const appliedConfigRef = useRef<AutoTrackConfig | null>(null);
+
+  const applyConfig = (cfg: AutoTrackConfig) => {
+    const prev = appliedConfigRef.current;
+    if (
+      prev?.isScreenFlowEnabled === cfg.isScreenFlowEnabled &&
+      prev?.isInputActionEnabled === cfg.isInputActionEnabled &&
+      prev?.shouldCollectValues === cfg.shouldCollectValues
+    )
+      return;
+    appliedConfigRef.current = cfg;
+    setConfig(cfg);
+    console.log(
+      '[NMAutotrack] screen tracking ',
+      cfg.isScreenFlowEnabled ? 'enabled' : 'disabled'
+    );
+    console.log(
+      '[NMAutotrack] input action tracking ',
+      cfg.isInputActionEnabled ? 'enabled' : 'disabled'
+    );
+  };
+
+  useEffect(() => {
+    NativeModules.RNNetmera?.getAutoTrackConfig?.()
+      ?.then((cfg: AutoTrackConfig | null) => {
+        if (cfg) applyConfig(cfg);
+      })
+      ?.catch((_err: unknown) => {});
+  }, []);
+
+  useEffect(() => {
+    const emitter = new NativeEventEmitter(
+      NativeModules.RNNetmeraRCTEventEmitter
+    );
+    const subscription = emitter.addListener(
+      'onAutoTrackConfigUpdate',
+      (cfg: AutoTrackConfig) => {
+        if (cfg) applyConfig(cfg);
+      }
+    );
+    return () => subscription.remove();
+  }, []);
+
+  const screenFlowEnabled = config?.isScreenFlowEnabled ?? false;
+  const inputActionEnabled = config?.isInputActionEnabled ?? false;
+  const shouldCollectValues = config?.shouldCollectValues ?? false;
+
+  const navigationEnabled = screenFlowEnabled || inputActionEnabled;
+  useNavigationTracking(
+    viewRef,
+    navigationRef,
+    navigationEnabled,
+    screenFlowEnabled
+  );
+  const { onTouchStart, onTouchEnd } = useTapTracking(
+    inputActionEnabled,
+    shouldCollectValues
+  );
+
+  return (
+    <View
+      ref={navigationEnabled ? viewRef : undefined}
+      style={styles.container}
+      onTouchStart={onTouchStart}
+      onTouchEnd={onTouchEnd}
+    >
+      {children}
+    </View>
+  );
+}
+
+const styles = StyleSheet.create({
+  container: { flex: 1 },
+});

package/src/autotracking/NetmeraNavigationState.ts

@@ -0,0 +1,13 @@
+/*
+ * Copyright (c) 2026 Netmera Research.
+ */
+
+let currentScreen: string | null = null;
+
+export function getCurrentScreen(): string | null {
+  return currentScreen;
+}
+
+export function setCurrentScreen(name: string): void {
+  currentScreen = name;
+}

package/src/autotracking/useNavigationTracking.ts

@@ -0,0 +1,130 @@
+/*
+ * Copyright (c) 2026 Netmera Research.
+ */
+
+import React, { useEffect, useRef } from 'react';
+import { setCurrentScreen } from './NetmeraNavigationState';
+import { RNNetmera } from '../utils/RNNetmera';
+
+// ContextProvider fiber tag — stable React internal constant since React 16.
+const CONTEXT_PROVIDER_TAG = 10;
+const NAV_SEARCH_DEPTH = 25;
+
+// Duck-type check: React Navigation v5/v6/v7 all expose this surface on the container ref.
+function isNavContainerRef(value: any): boolean {
+  return (
+    value != null &&
+    typeof value.addListener === 'function' &&
+    typeof value.getCurrentRoute === 'function' &&
+    typeof value.isReady === 'function'
+  );
+}
+
+// DFS through child fibers to find NavigationContainerRefContext.Provider.
+// Siblings walk at the same depth — they sit at the same level in the tree.
+function findNavContainerRef(fiber: any, depth = 0): any {
+  if (!fiber || depth > NAV_SEARCH_DEPTH) return null;
+  if (
+    fiber.tag === CONTEXT_PROVIDER_TAG &&
+    isNavContainerRef(fiber.memoizedProps?.value)
+  ) {
+    return fiber.memoizedProps.value;
+  }
+  return (
+    findNavContainerRef(fiber.child, depth + 1) ??
+    findNavContainerRef(fiber.sibling, depth)
+  );
+}
+
+/**
+ * Subscribes to React Navigation screen changes and keeps NetmeraNavigationState
+ * up to date. Resolves the navigation container ref via two paths:
+ *
+ * - New Arch (Fabric): auto-detected through the fiber tree via viewRef.
+ * - Old Arch (Paper):  caller passes navigationRef prop explicitly.
+ *
+ * Silently no-ops if neither path yields a valid ref.
+ * Respects the isScreenFlowEnabled flag — screen changes are ignored when disabled.
+ */
+export function useNavigationTracking(
+  viewRef: React.RefObject<any>,
+  navigationRef: React.RefObject<any> | undefined,
+  enabled: boolean,
+  screenLogEnabled: boolean
+): void {
+  // React 18: capture own fiber during render via ReactCurrentOwner.
+  // React 19 removed ReactCurrentOwner — this silently yields null, which is fine
+  // because the Fabric path (viewRef.__internalInstanceHandle) covers React 19.
+  const screenLogEnabledRef = useRef(screenLogEnabled);
+
+  useEffect(() => {
+    screenLogEnabledRef.current = screenLogEnabled;
+  }, [screenLogEnabled]);
+
+  const selfFiberRef = useRef<any>(null);
+  if (selfFiberRef.current === null) {
+    try {
+      const R = React as any;
+      selfFiberRef.current =
+        R.__SECRET_INTERNALS_DO_NOT_USE_OR_YOU_WILL_BE_FIRED?.ReactCurrentOwner
+          ?.current ?? null;
+    } catch (_) {}
+  }
+
+  useEffect(() => {
+    if (!enabled) return;
+    let navRef: any = null;
+
+    // Path 1 — New Arch: ReactNativeElement exposes its fiber via __internalInstanceHandle.
+    // Guard with 'child' in candidate to confirm it's a fiber, not another host object.
+    const candidate = viewRef.current?.__internalInstanceHandle;
+    const viewFiber: any =
+      candidate != null && 'child' in candidate
+        ? candidate
+        : (selfFiberRef.current?.child ?? null);
+
+    if (viewFiber) {
+      navRef = findNavContainerRef(viewFiber);
+    }
+
+    // Path 2 — Old Arch: use the ref passed explicitly via prop.
+    if (!navRef && isNavContainerRef(navigationRef?.current)) {
+      navRef = navigationRef!.current;
+    }
+
+    if (!navRef) return;
+
+    const handleChange = () => {
+      try {
+        const route = navRef.getCurrentRoute();
+        if (route?.name) {
+          setCurrentScreen(route.name);
+          if (screenLogEnabledRef.current) {
+            RNNetmera.trackView(route.name);
+          }
+        }
+      } catch (_) {}
+    };
+
+    const unsubState = navRef.addListener('state', handleChange);
+
+    // NavigationContainer's effects run before ours (child-first), so 'ready' has
+    // already fired. isReady() captures the initial screen synchronously; the 'ready'
+    // listener is a safety net for async startup (deferred auth, deep links, etc.).
+    let unsubReady: (() => void) | undefined;
+    if (navRef.isReady()) {
+      handleChange();
+    } else {
+      unsubReady = navRef.addListener('ready', () => {
+        handleChange();
+        unsubReady?.();
+        unsubReady = undefined;
+      });
+    }
+
+    return () => {
+      unsubState?.();
+      unsubReady?.();
+    };
+  }, [enabled]); // eslint-disable-line react-hooks/exhaustive-deps
+}

package/src/autotracking/useTapTracking.ts

@@ -0,0 +1,300 @@
+/*
+ * Copyright (c) 2026 Netmera Research.
+ */
+
+import { useCallback, useEffect, useRef } from 'react';
+import type { GestureResponderEvent } from 'react-native';
+import { getCurrentScreen } from './NetmeraNavigationState';
+import { RNNetmera } from '../utils/RNNetmera';
+
+const MAX_FIBER_DEPTH = 20;
+const MAX_TEXT_DEPTH = 5;
+const TAP_THRESHOLD = 10; // px — above this distance the gesture is a scroll, not a tap
+
+// ── Fiber predicates ──────────────────────────────────────────────────────────
+
+// Skip onStartShouldSetResponder — it matches ScrollViews, which are not interactive targets.
+function isInteractive(props: any): boolean {
+  return !!(props?.onPress || props?.onClick || props?.onValueChange);
+}
+
+// Switch has onValueChange + boolean value, but no onPress/onClick.
+function isSwitch(props: any): boolean {
+  return (
+    !!props?.onValueChange &&
+    typeof props?.value === 'boolean' &&
+    !(props?.onPress || props?.onClick)
+  );
+}
+
+// SelectDropdown and similar pickers expose onSelect on an ancestor fiber.
+// Tapping them only opens the picker UI — the real select event fires separately.
+function isInsideSelectionControl(fiber: any): boolean {
+  let node: any = fiber?.return;
+  for (let d = 0; d < 5 && node; d++, node = node.return) {
+    if (node?.memoizedProps?.onSelect != null) return true;
+  }
+  return false;
+}
+
+// ── Identifier resolution ─────────────────────────────────────────────────────
+
+function textFromChildren(children: any, depth = 0): string | undefined {
+  if (depth > MAX_TEXT_DEPTH) return undefined;
+  if (typeof children === 'string') {
+    const t = children.trim();
+    return t.length > 0 ? t : undefined;
+  }
+  if (typeof children === 'number') return String(children);
+  if (Array.isArray(children)) {
+    for (const child of children) {
+      const t = textFromChildren(child, depth + 1);
+      if (t) return t;
+    }
+    return undefined;
+  }
+  if (children != null && typeof children === 'object' && 'props' in children) {
+    return textFromChildren((children as any).props?.children, depth + 1);
+  }
+  return undefined;
+}
+
+// Priority: accessibilityLabel → testID → placeholder (TextInput) → first child text.
+function resolveIdentifier(props: any): string | undefined {
+  if (!props) return undefined;
+  if (
+    typeof props.accessibilityLabel === 'string' &&
+    props.accessibilityLabel.trim()
+  ) {
+    return props.accessibilityLabel.trim();
+  }
+  if (typeof props.testID === 'string' && props.testID.trim()) {
+    return props.testID.trim();
+  }
+  if (typeof props.placeholder === 'string' && props.placeholder.trim()) {
+    return props.placeholder.trim();
+  }
+  return textFromChildren(props.children);
+}
+
+// ── List index resolution ─────────────────────────────────────────────────────
+
+type ListIndex =
+  | { type: 'flatlist'; index: number }
+  | { type: 'sectionlist'; sectionIndex: number; itemIndex: number };
+
+function resolveListIndex(startFiber: any): ListIndex | undefined {
+  let fiber: any = startFiber;
+  for (let d = 0; d < MAX_FIBER_DEPTH && fiber; d++, fiber = fiber.return) {
+    const p = fiber.memoizedProps;
+    if (
+      typeof p?.index !== 'number' ||
+      typeof p?.cellKey !== 'string' ||
+      typeof p?.onUnmount !== 'function'
+    )
+      continue;
+
+    const cellKey: string = p.cellKey;
+
+    // Prefer stateNode.props.index over memoizedProps.index: both current and alternate
+    // fibers share the same class instance, and React writes nextProps to instance.props
+    // during reconciliation — so stateNode.props is always current even when _targetInst
+    // resolves to the stale alternate fiber (common on iOS after a commit).
+    const flatIndex: number =
+      typeof fiber.stateNode?.props?.index === 'number'
+        ? fiber.stateNode.props.index
+        : p.index;
+
+    // `sections` Array prop is only present on SectionList; VirtualizedList uses `data`.
+    let sections: any[] | undefined;
+    let up: any = fiber.return;
+    for (let i = 0; i < 15 && up; i++, up = up.return) {
+      const upProps = up.stateNode?.props ?? up.memoizedProps;
+      if (Array.isArray(upProps?.sections)) {
+        sections = upProps.sections;
+        break;
+      }
+    }
+
+    if (sections) {
+      if (cellKey.endsWith(':header') || cellKey.endsWith(':footer'))
+        return undefined;
+
+      // Mirrors VirtualizedSectionList._getItem offset arithmetic:
+      //   flatIndex 0       → section 0 header
+      //   flatIndex 1..n    → section 0 items  (itemIndex = flatIndex - 1)
+      //   flatIndex n+1     → section 0 footer
+      //   flatIndex n+2     → section 1 header …
+      let idx = flatIndex - 1;
+      for (let si = 0; si < sections.length; si++) {
+        const count = sections[si].data?.length ?? 0;
+        if (idx === -1 || idx === count) return undefined;
+        if (idx < count)
+          return { type: 'sectionlist', sectionIndex: si, itemIndex: idx };
+        idx -= count + 2;
+      }
+      return undefined;
+    }
+
+    return { type: 'flatlist', index: flatIndex };
+  }
+  return undefined;
+}
+
+// ── Log path ──────────────────────────────────────────────────────────────────
+
+function buildPath(
+  screen: string | null,
+  listType: string | null,
+  identifier: string,
+  indexSuffix: string,
+  value?: boolean
+): string {
+  const base = listType
+    ? `${screen}|${listType}|${identifier}`
+    : `${screen}|${identifier}`;
+  return value !== undefined
+    ? `${base}|${value}${indexSuffix}`
+    : `${base}${indexSuffix}`;
+}
+
+// ── Hook ──────────────────────────────────────────────────────────────────────
+
+export function useTapTracking(enabled: boolean, shouldCollectValues: boolean) {
+  const enabledRef = useRef(enabled);
+  const shouldCollectValuesRef = useRef(shouldCollectValues);
+  const touchStartRef = useRef<{
+    x: number;
+    y: number;
+    switchValue?: boolean;
+  } | null>(null);
+  const lastScreenRef = useRef<string | null | undefined>(undefined);
+
+  // Tracks the last logged value per Switch identifier so we can compute the new
+  // state as !lastLogged without re-reading the fiber. memoizedProps.value is
+  // unreliable across taps because React's current/alternate swap can expose a
+  // stale alternate fiber via _targetInst after any commit.
+  const switchLastLoggedRef = useRef<Map<string, boolean>>(new Map());
+
+  useEffect(() => {
+    enabledRef.current = enabled;
+    if (!enabled) {
+      touchStartRef.current = null;
+      lastScreenRef.current = undefined;
+      switchLastLoggedRef.current.clear();
+    }
+  }, [enabled]);
+
+  useEffect(() => {
+    shouldCollectValuesRef.current = shouldCollectValues;
+  }, [shouldCollectValues]);
+
+  const onTouchStart = useCallback((e: GestureResponderEvent) => {
+    if (!enabledRef.current) return;
+    let switchValue: boolean | undefined;
+    try {
+      let fiber: any = (e as any)._targetInst;
+      for (let d = 0; d < MAX_FIBER_DEPTH && fiber; d++, fiber = fiber.return) {
+        if (isSwitch(fiber.memoizedProps)) {
+          // Capture the committed value before any event fires — reliable first-tap baseline.
+          switchValue = fiber.memoizedProps.value;
+          break;
+        }
+      }
+    } catch (_) {}
+    touchStartRef.current = {
+      x: e.nativeEvent.pageX,
+      y: e.nativeEvent.pageY,
+      switchValue,
+    };
+  }, []);
+
+  const onTouchEnd = useCallback((e: GestureResponderEvent) => {
+    if (!enabledRef.current) return;
+    const start = touchStartRef.current;
+    if (start) {
+      const dx = Math.abs(e.nativeEvent.pageX - start.x);
+      const dy = Math.abs(e.nativeEvent.pageY - start.y);
+      if (dx > TAP_THRESHOLD || dy > TAP_THRESHOLD) return;
+    }
+
+    try {
+      let node: any = (e as any)._targetInst;
+      if (!node) return;
+
+      // Pass 1: walk up to find the first interactive ancestor.
+      // e.g. tapping a <Text> inside a <Pressable> yields the Pressable.
+      let interactiveNode: any = null;
+      let depth = 0;
+      while (node && depth < MAX_FIBER_DEPTH) {
+        if (isInteractive(node.memoizedProps)) {
+          interactiveNode = node;
+          break;
+        }
+        node = node.return;
+        depth++;
+      }
+      if (!interactiveNode) return;
+
+      // Pass 2: resolve identifier from the interactive fiber and up to 2 ancestors.
+      // The look-ahead handles TouchableOpacity, where the inner Animated.View fiber
+      // (where Pass 1 stops) may carry the accessibilityLabel from the parent TO.
+      let identifierNode: any = interactiveNode;
+      let identifier: string | undefined;
+      for (let i = 0; i < 3 && identifierNode; i++) {
+        identifier = resolveIdentifier(identifierNode.memoizedProps);
+        if (identifier) break;
+        identifierNode = identifierNode.return;
+      }
+
+      if (!identifier) return;
+
+      const isSwitchNode = isSwitch(interactiveNode.memoizedProps);
+      if (!isSwitchNode && isInsideSelectionControl(interactiveNode)) return;
+
+      const screen = getCurrentScreen();
+      if (screen !== lastScreenRef.current) {
+        switchLastLoggedRef.current.clear();
+        lastScreenRef.current = screen;
+      }
+
+      const listIndex = shouldCollectValuesRef.current
+        ? resolveListIndex(interactiveNode)
+        : undefined;
+      const listType = listIndex
+        ? listIndex.type === 'sectionlist'
+          ? 'SectionList'
+          : 'FlatList'
+        : null;
+      const indexSuffix = listIndex
+        ? listIndex.type === 'sectionlist'
+          ? `|section:${listIndex.sectionIndex},index:${listIndex.itemIndex}`
+          : `|index:${listIndex.index}`
+        : '';
+
+      if (isSwitchNode) {
+        const lastLogged = switchLastLoggedRef.current.get(identifier);
+        let newValue: boolean;
+        if (lastLogged !== undefined) {
+          newValue = !lastLogged;
+        } else {
+          const preTapValue = touchStartRef.current?.switchValue;
+          newValue =
+            preTapValue !== undefined
+              ? !preTapValue
+              : !interactiveNode.memoizedProps.value;
+        }
+        switchLastLoggedRef.current.set(identifier, newValue);
+        const switchPath = buildPath(screen, listType, identifier, indexSuffix, newValue);
+        RNNetmera.trackAction(switchPath);
+      } else {
+        const tapPath = buildPath(screen, listType, identifier, indexSuffix);
+        RNNetmera.trackAction(tapPath);
+      }
+    } catch (_) {
+      // Fiber tree is a private React API — fail silently.
+    }
+  }, []);
+
+  return { onTouchStart, onTouchEnd };
+}