@datacanva/react-native-tracker 0.1.1

package/LICENSE

@@ -0,0 +1,20 @@
+MIT License
+
+Copyright (c) 2026 Lively Impact Technology Limited
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,33 @@
+# @datacanva/react-native-tracker
+
+Datacanva web tracker API for react native.
+
+## Installation
+
+```sh
+npm install @datacanva/react-native-tracker
+```
+
+## Usage
+
+```js
+import { multiply } from "@datacanva/react-native-tracker";
+
+// ...
+
+const result = await multiply(3, 7);
+```
+
+## Contributing
+
+- [Development workflow](CONTRIBUTING.md#development-workflow)
+- [Sending a pull request](CONTRIBUTING.md#sending-a-pull-request)
+- [Code of conduct](CODE_OF_CONDUCT.md)
+
+## License
+
+MIT
+
+---
+
+Made with [create-react-native-library](https://github.com/callstack/react-native-builder-bob)

package/lib/module/getDeviceInfo.js

@@ -0,0 +1,26 @@
+"use strict";
+
+const getDeviceInfo = async exclude => {
+  try {
+    const entry = async (key, getter) => {
+      if (!exclude?.includes(key)) try {
+        return [key, `${await getter()}`];
+      } catch (e) {}
+      return ["", ""];
+    };
+    const {
+      default: DeviceInfo
+    } = await import("react-native-device-info");
+    const entries = await Promise.all([
+    // Identifiers
+    entry("mobile_unique_id", DeviceInfo.getUniqueId), entry("mobile_android_id", DeviceInfo.getAndroidId), entry("mobile_android_app_set_id", async () => (await DeviceInfo.getAppSetId()).id),
+    // Device/system info
+    entry("mobile_device_id", DeviceInfo.getDeviceId), entry("mobile_device_type", DeviceInfo.getDeviceType), entry("mobile_manufacturer", DeviceInfo.getManufacturer), entry("mobile_brand", DeviceInfo.getBrand), entry("mobile_model", DeviceInfo.getModel), entry("mobile_system_name", DeviceInfo.getSystemName), entry("mobile_system_version", DeviceInfo.getSystemVersion), entry("mobile_system_build_id", DeviceInfo.getBuildId), entry("mobile_is_emulator", DeviceInfo.isEmulator), entry("mobile_carrier", DeviceInfo.getCarrier),
+    // Application info
+    entry("mobile_app_bundle_id", DeviceInfo.getBundleId), entry("mobile_app_version", DeviceInfo.getVersion), entry("mobile_app_build_number", DeviceInfo.getBuildNumber), entry("mobile_app_readable_version", DeviceInfo.getReadableVersion), entry("mobile_app_installer_package", DeviceInfo.getInstallerPackageName), entry("mobile_app_instance_id", DeviceInfo.getInstanceId), entry("mobile_app_update_time", DeviceInfo.getLastUpdateTime)]);
+    return Object.fromEntries(entries.filter(e => e[0] && !exclude?.includes(e[0])));
+  } catch (e) {}
+  return {};
+};
+export default getDeviceInfo;
+//# sourceMappingURL=getDeviceInfo.js.map

package/lib/module/getDeviceInfo.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["getDeviceInfo","exclude","entry","key","getter","includes","e","default","DeviceInfo","entries","Promise","all","getUniqueId","getAndroidId","getAppSetId","id","getDeviceId","getDeviceType","getManufacturer","getBrand","getModel","getSystemName","getSystemVersion","getBuildId","isEmulator","getCarrier","getBundleId","getVersion","getBuildNumber","getReadableVersion","getInstallerPackageName","getInstanceId","getLastUpdateTime","Object","fromEntries","filter"],"sourceRoot":"..\\..\\src","sources":["getDeviceInfo.ts"],"mappings":";;AAEA,MAAMA,aAAa,GAAG,MAAOC,OAAkB,IAAK;EAClD,IAAI;IACF,MAAMC,KAAK,GAAG,MAAAA,CAAOC,GAAW,EAAEC,MAA4B,KAAK;MACjE,IAAI,CAACH,OAAO,EAAEI,QAAQ,CAACF,GAAG,CAAC,EACzB,IAAI;QACF,OAAO,CAACA,GAAG,EAAE,GAAG,MAAMC,MAAM,CAAC,CAAC,EAAE,CAAC;MACnC,CAAC,CAAC,OAAOE,CAAC,EAAE,CAAC;MACf,OAAO,CAAC,EAAE,EAAE,EAAE,CAAC;IACjB,CAAC;IAED,MAAM;MAAEC,OAAO,EAAEC;IAAW,CAAC,GAAG,MAAM,MAAM,CAAC,0BAA0B,CAAC;IACxE,MAAMC,OAAO,GAAG,MAAMC,OAAO,CAACC,GAAG,CAAC;IAChC;IACAT,KAAK,CAAC,kBAAkB,EAAEM,UAAU,CAACI,WAAW,CAAC,EACjDV,KAAK,CAAC,mBAAmB,EAAEM,UAAU,CAACK,YAAY,CAAC,EACnDX,KAAK,CACH,2BAA2B,EAC3B,YAAY,CAAC,MAAMM,UAAU,CAACM,WAAW,CAAC,CAAC,EAAEC,EAC/C,CAAC;IACD;IACAb,KAAK,CAAC,kBAAkB,EAAEM,UAAU,CAACQ,WAAW,CAAC,EACjDd,KAAK,CAAC,oBAAoB,EAAEM,UAAU,CAACS,aAAa,CAAC,EACrDf,KAAK,CAAC,qBAAqB,EAAEM,UAAU,CAACU,eAAe,CAAC,EACxDhB,KAAK,CAAC,cAAc,EAAEM,UAAU,CAACW,QAAQ,CAAC,EAC1CjB,KAAK,CAAC,cAAc,EAAEM,UAAU,CAACY,QAAQ,CAAC,EAC1ClB,KAAK,CAAC,oBAAoB,EAAEM,UAAU,CAACa,aAAa,CAAC,EACrDnB,KAAK,CAAC,uBAAuB,EAAEM,UAAU,CAACc,gBAAgB,CAAC,EAC3DpB,KAAK,CAAC,wBAAwB,EAAEM,UAAU,CAACe,UAAU,CAAC,EACtDrB,KAAK,CAAC,oBAAoB,EAAEM,UAAU,CAACgB,UAAU,CAAC,EAClDtB,KAAK,CAAC,gBAAgB,EAAEM,UAAU,CAACiB,UAAU,CAAC;IAC9C;IACAvB,KAAK,CAAC,sBAAsB,EAAEM,UAAU,CAACkB,WAAW,CAAC,EACrDxB,KAAK,CAAC,oBAAoB,EAAEM,UAAU,CAACmB,UAAU,CAAC,EAClDzB,KAAK,CAAC,yBAAyB,EAAEM,UAAU,CAACoB,cAAc,CAAC,EAC3D1B,KAAK,CAAC,6BAA6B,EAAEM,UAAU,CAACqB,kBAAkB,CAAC,EACnE3B,KAAK,CAAC,8BAA8B,EAAEM,UAAU,CAACsB,uBAAuB,CAAC,EACzE5B,KAAK,CAAC,wBAAwB,EAAEM,UAAU,CAACuB,aAAa,CAAC,EACzD7B,KAAK,CAAC,wBAAwB,EAAEM,UAAU,CAACwB,iBAAiB,CAAC,CAC9D,CAAC;IACF,OAAOC,MAAM,CAACC,WAAW,CACvBzB,OAAO,CAAC0B,MAAM,CAAC7B,CAAC,IAAIA,CAAC,CAAC,CAAC,CAAC,IAAI,CAACL,OAAO,EAAEI,QAAQ,CAACC,CAAC,CAAC,CAAC,CAAC,CAAC,CACtD,CAAC;EACH,CAAC,CAAC,OAAOA,CAAC,EAAE,CAAC;EACb,OAAO,CAAC,CAAC;AACX,CAAC;AAED,eAAeN,aAAa","ignoreList":[]}

package/lib/module/getLanguages.js

@@ -0,0 +1,17 @@
+"use strict";
+
+const getLanguages = async () => {
+  try {
+    const {
+      getLocales
+    } = await import("react-native-localize");
+    const locales = getLocales().map(e => e.languageTag);
+    return {
+      language: `${locales[0]}`,
+      languages: locales.join(",")
+    };
+  } catch (e) {}
+  return {};
+};
+export default getLanguages;
+//# sourceMappingURL=getLanguages.js.map

package/lib/module/getLanguages.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["getLanguages","getLocales","locales","map","e","languageTag","language","languages","join"],"sourceRoot":"..\\..\\src","sources":["getLanguages.ts"],"mappings":";;AAAA,MAAMA,YAAY,GAAG,MAAAA,CAAA,KAA6C;EAChE,IAAI;IACF,MAAM;MAAEC;IAAW,CAAC,GAAG,MAAM,MAAM,CAAC,uBAAuB,CAAC;IAC5D,MAAMC,OAAO,GAAGD,UAAU,CAAC,CAAC,CAACE,GAAG,CAACC,CAAC,IAAIA,CAAC,CAACC,WAAW,CAAC;IAEpD,OAAO;MACLC,QAAQ,EAAE,GAAGJ,OAAO,CAAC,CAAC,CAAC,EAAE;MACzBK,SAAS,EAAEL,OAAO,CAACM,IAAI,CAAC,GAAG;IAC7B,CAAC;EACH,CAAC,CAAC,OAAOJ,CAAC,EAAE,CAAC;EACb,OAAO,CAAC,CAAC;AACX,CAAC;AAED,eAAeJ,YAAY","ignoreList":[]}

package/lib/module/index.js

@@ -0,0 +1,5 @@
+"use strict";
+
+export { default as Tracker } from "./tracker.js";
+export { default as useAppStateTracker } from "./useAppStateTracker.js";
+//# sourceMappingURL=index.js.map

package/lib/module/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["default","Tracker","useAppStateTracker"],"sourceRoot":"..\\..\\src","sources":["index.ts"],"mappings":";;AAAA,SAASA,OAAO,IAAIC,OAAO,QAAQ,cAAW;AAC9C,SAASD,OAAO,IAAIE,kBAAkB,QAAQ,yBAAsB","ignoreList":[]}

package/lib/module/package.json

@@ -0,0 +1 @@
+{"type":"module"}

package/lib/module/tracker.js

@@ -0,0 +1,60 @@
+"use strict";
+
+import getDeviceInfo from "./getDeviceInfo.js";
+import getLanguages from "./getLanguages.js";
+export default class Tracker {
+  constructor(baseUrl, trackerId, options) {
+    this.baseUrl = baseUrl;
+    this.trackerId = trackerId;
+    this.options = options;
+    this.state = {
+      visitId: "",
+      visitDepth: 0,
+      prevUrl: "",
+      currentUrlStartTime: Date.now()
+    };
+    this.uuidSupplier = options?.uuidSupplier || (async () => {
+      try {
+        const {
+          default: uuid
+        } = await import("react-native-uuid");
+        return uuid.v4();
+      } catch (e) {
+        console.error(e);
+        return "";
+      }
+    });
+    this.uuidSupplier().then(e => this.state.visitId = e);
+  }
+  async getUrl(attributes) {
+    const queryString = new URLSearchParams({
+      r: Math.random().toString(36).substring(2),
+      visit_id: this.state.visitId,
+      visit_depth: `${this.state.visitDepth++}`,
+      ...(this.options?.defaultAttributes && this.options.defaultAttributes()),
+      ...(!this.options?.disableLanguages && (await getLanguages())),
+      ...(!this.options?.disableDeviceInfo && (await getDeviceInfo(this.options?.excludeDeviceInfo))),
+      ...attributes
+    }).toString();
+    return new URL(`tracker/${this.trackerId}/collect?${queryString}`, this.baseUrl).href;
+  }
+  async track(attributes) {
+    await fetch(await this.getUrl(attributes), {
+      credentials: "include"
+    });
+  }
+  async trackNavigation(currentRoutingKey) {
+    const now = Date.now();
+    const current_url = currentRoutingKey;
+    const previous_url = `${this.state.prevUrl}`;
+    const previous_url_duration_ms = `${now - this.state.currentUrlStartTime}`;
+    this.state.prevUrl = `${current_url}`;
+    this.state.currentUrlStartTime = now;
+    this.track({
+      current_url,
+      previous_url,
+      previous_url_duration_ms
+    });
+  }
+}
+//# sourceMappingURL=tracker.js.map

package/lib/module/tracker.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["getDeviceInfo","getLanguages","Tracker","constructor","baseUrl","trackerId","options","state","visitId","visitDepth","prevUrl","currentUrlStartTime","Date","now","uuidSupplier","default","uuid","v4","e","console","error","then","getUrl","attributes","queryString","URLSearchParams","r","Math","random","toString","substring","visit_id","visit_depth","defaultAttributes","disableLanguages","disableDeviceInfo","excludeDeviceInfo","URL","href","track","fetch","credentials","trackNavigation","currentRoutingKey","current_url","previous_url","previous_url_duration_ms"],"sourceRoot":"..\\..\\src","sources":["tracker.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/useAppStateTracker.js

@@ -0,0 +1,42 @@
+"use strict";
+
+import { useEffect, useRef } from "react";
+import { AppState } from "react-native";
+const useAppStateTracker = (tracker, options) => {
+  const mountedRef = useRef(false);
+  const appState = useRef(AppState.currentState);
+
+  // on mount
+  useEffect(() => {
+    if (!mountedRef.current) {
+      mountedRef.current = true;
+      tracker.track({
+        action: "land",
+        ...(options?.commonAttributes && options.commonAttributes()),
+        ...(options?.landingAttributes && options.landingAttributes())
+      });
+    }
+  }, []);
+
+  // subscribe to app state change event
+  useEffect(() => {
+    const subscription = AppState.addEventListener("change", nextAppState => {
+      if (appState.current !== "active" && nextAppState === "active") tracker.track({
+        action: "land",
+        ...(options?.commonAttributes && options.commonAttributes()),
+        ...(options?.landingAttributes && options.landingAttributes())
+      });
+      if (appState.current !== "background" && nextAppState === "background") tracker.track({
+        action: "leave",
+        ...(options?.commonAttributes && options.commonAttributes()),
+        ...(options?.leavingAttributes && options.leavingAttributes())
+      });
+      appState.current = nextAppState;
+    });
+    return () => {
+      subscription.remove();
+    };
+  }, []);
+};
+export default useAppStateTracker;
+//# sourceMappingURL=useAppStateTracker.js.map

package/lib/module/useAppStateTracker.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["useEffect","useRef","AppState","useAppStateTracker","tracker","options","mountedRef","appState","currentState","current","track","action","commonAttributes","landingAttributes","subscription","addEventListener","nextAppState","leavingAttributes","remove"],"sourceRoot":"..\\..\\src","sources":["useAppStateTracker.ts"],"mappings":";;AAAA,SAASA,SAAS,EAAEC,MAAM,QAAQ,OAAO;AACzC,SAASC,QAAQ,QAAQ,cAAc;AAGvC,MAAMC,kBAAkB,GAAGA,CACzBC,OAAgB,EAChBC,OAIC,KACE;EACH,MAAMC,UAAU,GAAGL,MAAM,CAAC,KAAK,CAAC;EAChC,MAAMM,QAAQ,GAAGN,MAAM,CAACC,QAAQ,CAACM,YAAY,CAAC;;EAE9C;EACAR,SAAS,CAAC,MAAM;IACd,IAAI,CAACM,UAAU,CAACG,OAAO,EAAE;MACvBH,UAAU,CAACG,OAAO,GAAG,IAAI;MAEzBL,OAAO,CAACM,KAAK,CAAC;QACZC,MAAM,EAAE,MAAM;QACd,IAAIN,OAAO,EAAEO,gBAAgB,IAAIP,OAAO,CAACO,gBAAgB,CAAC,CAAC,CAAC;QAC5D,IAAIP,OAAO,EAAEQ,iBAAiB,IAAIR,OAAO,CAACQ,iBAAiB,CAAC,CAAC;MAC/D,CAAC,CAAC;IACJ;EACF,CAAC,EAAE,EAAE,CAAC;;EAEN;EACAb,SAAS,CAAC,MAAM;IACd,MAAMc,YAAY,GAAGZ,QAAQ,CAACa,gBAAgB,CAAC,QAAQ,EAAEC,YAAY,IAAI;MACvE,IAAIT,QAAQ,CAACE,OAAO,KAAK,QAAQ,IAAIO,YAAY,KAAK,QAAQ,EAC5DZ,OAAO,CAACM,KAAK,CAAC;QACZC,MAAM,EAAE,MAAM;QACd,IAAIN,OAAO,EAAEO,gBAAgB,IAAIP,OAAO,CAACO,gBAAgB,CAAC,CAAC,CAAC;QAC5D,IAAIP,OAAO,EAAEQ,iBAAiB,IAAIR,OAAO,CAACQ,iBAAiB,CAAC,CAAC;MAC/D,CAAC,CAAC;MAEJ,IAAIN,QAAQ,CAACE,OAAO,KAAK,YAAY,IAAIO,YAAY,KAAK,YAAY,EACpEZ,OAAO,CAACM,KAAK,CAAC;QACZC,MAAM,EAAE,OAAO;QACf,IAAIN,OAAO,EAAEO,gBAAgB,IAAIP,OAAO,CAACO,gBAAgB,CAAC,CAAC,CAAC;QAC5D,IAAIP,OAAO,EAAEY,iBAAiB,IAAIZ,OAAO,CAACY,iBAAiB,CAAC,CAAC;MAC/D,CAAC,CAAC;MAEJV,QAAQ,CAACE,OAAO,GAAGO,YAAY;IACjC,CAAC,CAAC;IAEF,OAAO,MAAM;MACXF,YAAY,CAACI,MAAM,CAAC,CAAC;IACvB,CAAC;EACH,CAAC,EAAE,EAAE,CAAC;AACR,CAAC;AAED,eAAef,kBAAkB","ignoreList":[]}

package/lib/typescript/package.json

@@ -0,0 +1 @@
+{"type":"module"}

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

@@ -0,0 +1,5 @@
+declare const getDeviceInfo: (exclude?: string[]) => Promise<{
+    [k: string]: string;
+}>;
+export default getDeviceInfo;
+//# sourceMappingURL=getDeviceInfo.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getDeviceInfo.d.ts","sourceRoot":"","sources":["../../../src/getDeviceInfo.ts"],"names":[],"mappings":"AAEA,QAAA,MAAM,aAAa,GAAU,UAAU,MAAM,EAAE;;EA4C9C,CAAC;AAEF,eAAe,aAAa,CAAC"}

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

@@ -0,0 +1,3 @@
+declare const getLanguages: () => Promise<Record<string, string>>;
+export default getLanguages;
+//# sourceMappingURL=getLanguages.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getLanguages.d.ts","sourceRoot":"","sources":["../../../src/getLanguages.ts"],"names":[],"mappings":"AAAA,QAAA,MAAM,YAAY,QAAa,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAW5D,CAAC;AAEF,eAAe,YAAY,CAAC"}

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

@@ -0,0 +1,3 @@
+export { default as Tracker } from "./tracker";
+export { default as useAppStateTracker } from "./useAppStateTracker";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,MAAM,sBAAsB,CAAC"}

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

@@ -0,0 +1,26 @@
+type Options = {
+    defaultAttributes?: () => Record<string, string>;
+    disableLanguages?: boolean;
+    disableDeviceInfo?: boolean;
+    excludeDeviceInfo?: string[];
+    uuidSupplier?: () => Promise<string>;
+};
+type TrackerState = {
+    visitId: string;
+    visitDepth: number;
+    prevUrl: string;
+    currentUrlStartTime: number;
+};
+export default class Tracker {
+    private baseUrl;
+    private trackerId;
+    private options?;
+    state: TrackerState;
+    uuidSupplier: () => Promise<string>;
+    constructor(baseUrl: string, trackerId: string, options?: Options | undefined);
+    getUrl(attributes?: Record<string, string>): Promise<string>;
+    track(attributes?: Record<string, string>): Promise<void>;
+    trackNavigation(currentRoutingKey: string): Promise<void>;
+}
+export {};
+//# sourceMappingURL=tracker.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tracker.d.ts","sourceRoot":"","sources":["../../../src/tracker.ts"],"names":[],"mappings":"AAGA,KAAK,OAAO,GAAG;IACb,iBAAiB,CAAC,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjD,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,YAAY,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;CACtC,CAAC;AAEF,KAAK,YAAY,GAAG;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,mBAAmB,EAAE,MAAM,CAAC;CAC7B,CAAC;AAEF,MAAM,CAAC,OAAO,OAAO,OAAO;IAKxB,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,SAAS;IACjB,OAAO,CAAC,OAAO,CAAC;IANlB,KAAK,EAAE,YAAY,CAAC;IACpB,YAAY,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;gBAG1B,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,OAAO,YAAA;IAsBd,MAAM,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAiB1C,KAAK,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAIzC,eAAe,CAAC,iBAAiB,EAAE,MAAM;CAavD"}

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

@@ -0,0 +1,8 @@
+import type Tracker from "./tracker";
+declare const useAppStateTracker: (tracker: Tracker, options?: {
+    landingAttributes?: () => Record<string, string>;
+    leavingAttributes?: () => Record<string, string>;
+    commonAttributes?: () => Record<string, string>;
+}) => void;
+export default useAppStateTracker;
+//# sourceMappingURL=useAppStateTracker.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useAppStateTracker.d.ts","sourceRoot":"","sources":["../../../src/useAppStateTracker.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,OAAO,MAAM,WAAW,CAAC;AAErC,QAAA,MAAM,kBAAkB,GACtB,SAAS,OAAO,EAChB,UAAU;IACR,iBAAiB,CAAC,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjD,iBAAiB,CAAC,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjD,gBAAgB,CAAC,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjD,SA0CF,CAAC;AAEF,eAAe,kBAAkB,CAAC"}

package/package.json

@@ -0,0 +1,160 @@
+{
+  "name": "@datacanva/react-native-tracker",
+  "version": "0.1.1",
+  "description": "Datacanva web tracker API for react native.",
+  "main": "./lib/module/index.js",
+  "types": "./lib/typescript/src/index.d.ts",
+  "exports": {
+    ".": {
+      "source": "./src/index.ts",
+      "types": "./lib/typescript/src/index.d.ts",
+      "default": "./lib/module/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "src",
+    "lib",
+    "android",
+    "ios",
+    "cpp",
+    "*.podspec",
+    "react-native.config.js",
+    "!ios/build",
+    "!android/build",
+    "!android/gradle",
+    "!android/gradlew",
+    "!android/gradlew.bat",
+    "!android/local.properties",
+    "!**/__tests__",
+    "!**/__fixtures__",
+    "!**/__mocks__",
+    "!**/.*"
+  ],
+  "scripts": {
+    "example": "yarn workspace @datacanva/react-native-tracker-example",
+    "clean": "del-cli lib",
+    "prepare": "bob build",
+    "typecheck": "tsc",
+    "lint": "eslint \"**/*.{js,ts,tsx}\"",
+    "test": "jest",
+    "release": "release-it --only-version"
+  },
+  "keywords": [
+    "react-native",
+    "ios",
+    "android"
+  ],
+  "author": "datacanva <info@livelyimpact.com>",
+  "license": "MIT",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
+  },
+  "devDependencies": {
+    "@commitlint/config-conventional": "^19.8.1",
+    "@eslint/compat": "^1.3.2",
+    "@eslint/eslintrc": "^3.3.1",
+    "@eslint/js": "^9.35.0",
+    "@react-native/babel-preset": "0.83.0",
+    "@react-native/eslint-config": "0.83.0",
+    "@release-it/conventional-changelog": "^10.0.1",
+    "@types/jest": "^29.5.14",
+    "@types/react": "^19.1.12",
+    "commitlint": "^19.8.1",
+    "del-cli": "^6.0.0",
+    "eslint": "^9.35.0",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-prettier": "^5.5.4",
+    "jest": "^29.7.0",
+    "prettier": "^2.8.8",
+    "prettier-plugin-organize-imports": "^4.3.0",
+    "react": "19.2.0",
+    "react-native": "0.83.2",
+    "react-native-builder-bob": "^0.40.13",
+    "react-native-device-info": "^15.0.2",
+    "react-native-localize": "^3.7.0",
+    "react-native-uuid": "^2.0.3",
+    "release-it": "^19.0.4",
+    "turbo": "^2.5.6",
+    "typescript": "^5.9.2"
+  },
+  "peerDependencies": {
+    "react": "*",
+    "react-native": "*",
+    "react-native-device-info": "*",
+    "react-native-localize": "*",
+    "react-native-uuid": "*"
+  },
+  "peerDependenciesMeta": {
+    "react-native-device-info": {
+      "optional": true
+    },
+    "react-native-localize": {
+      "optional": true
+    },
+    "react-native-uuid": {
+      "optional": true
+    }
+  },
+  "workspaces": [
+    "example"
+  ],
+  "packageManager": "yarn@4.11.0",
+  "react-native-builder-bob": {
+    "source": "src",
+    "output": "lib",
+    "targets": [
+      [
+        "module",
+        {
+          "esm": true
+        }
+      ],
+      [
+        "typescript",
+        {
+          "project": "tsconfig.build.json"
+        }
+      ]
+    ]
+  },
+  "jest": {
+    "preset": "react-native",
+    "modulePathIgnorePatterns": [
+      "<rootDir>/example/node_modules",
+      "<rootDir>/lib/"
+    ]
+  },
+  "commitlint": {
+    "extends": [
+      "@commitlint/config-conventional"
+    ]
+  },
+  "release-it": {
+    "git": {
+      "commitMessage": "chore: release ${version}",
+      "tagName": "v${version}"
+    },
+    "npm": {
+      "publish": true
+    },
+    "plugins": {
+      "@release-it/conventional-changelog": {
+        "preset": {
+          "name": "angular"
+        }
+      }
+    }
+  },
+  "create-react-native-library": {
+    "type": "library",
+    "languages": "js",
+    "tools": [
+      "eslint",
+      "jest",
+      "release-it"
+    ],
+    "version": "0.57.2"
+  }
+}

package/src/getDeviceInfo.ts

@@ -0,0 +1,49 @@
+type V = string | number | boolean;
+
+const getDeviceInfo = async (exclude?: string[]) => {
+  try {
+    const entry = async (key: string, getter: () => Promise<V> | V) => {
+      if (!exclude?.includes(key))
+        try {
+          return [key, `${await getter()}`] as const;
+        } catch (e) {}
+      return ["", ""] as const;
+    };
+
+    const { default: DeviceInfo } = await import("react-native-device-info");
+    const entries = await Promise.all([
+      // Identifiers
+      entry("mobile_unique_id", DeviceInfo.getUniqueId),
+      entry("mobile_android_id", DeviceInfo.getAndroidId),
+      entry(
+        "mobile_android_app_set_id",
+        async () => (await DeviceInfo.getAppSetId()).id,
+      ),
+      // Device/system info
+      entry("mobile_device_id", DeviceInfo.getDeviceId),
+      entry("mobile_device_type", DeviceInfo.getDeviceType),
+      entry("mobile_manufacturer", DeviceInfo.getManufacturer),
+      entry("mobile_brand", DeviceInfo.getBrand),
+      entry("mobile_model", DeviceInfo.getModel),
+      entry("mobile_system_name", DeviceInfo.getSystemName),
+      entry("mobile_system_version", DeviceInfo.getSystemVersion),
+      entry("mobile_system_build_id", DeviceInfo.getBuildId),
+      entry("mobile_is_emulator", DeviceInfo.isEmulator),
+      entry("mobile_carrier", DeviceInfo.getCarrier),
+      // Application info
+      entry("mobile_app_bundle_id", DeviceInfo.getBundleId),
+      entry("mobile_app_version", DeviceInfo.getVersion),
+      entry("mobile_app_build_number", DeviceInfo.getBuildNumber),
+      entry("mobile_app_readable_version", DeviceInfo.getReadableVersion),
+      entry("mobile_app_installer_package", DeviceInfo.getInstallerPackageName),
+      entry("mobile_app_instance_id", DeviceInfo.getInstanceId),
+      entry("mobile_app_update_time", DeviceInfo.getLastUpdateTime),
+    ]);
+    return Object.fromEntries(
+      entries.filter(e => e[0] && !exclude?.includes(e[0])),
+    );
+  } catch (e) {}
+  return {};
+};
+
+export default getDeviceInfo;

package/src/getLanguages.ts

@@ -0,0 +1,14 @@
+const getLanguages = async (): Promise<Record<string, string>> => {
+  try {
+    const { getLocales } = await import("react-native-localize");
+    const locales = getLocales().map(e => e.languageTag);
+
+    return {
+      language: `${locales[0]}`,
+      languages: locales.join(","),
+    };
+  } catch (e) {}
+  return {};
+};
+
+export default getLanguages;

package/src/index.ts

@@ -0,0 +1,2 @@
+export { default as Tracker } from "./tracker";
+export { default as useAppStateTracker } from "./useAppStateTracker";

package/src/tracker.ts

@@ -0,0 +1,82 @@
+import getDeviceInfo from "./getDeviceInfo";
+import getLanguages from "./getLanguages";
+
+type Options = {
+  defaultAttributes?: () => Record<string, string>;
+  disableLanguages?: boolean;
+  disableDeviceInfo?: boolean;
+  excludeDeviceInfo?: string[];
+  uuidSupplier?: () => Promise<string>;
+};
+
+type TrackerState = {
+  visitId: string;
+  visitDepth: number;
+  prevUrl: string;
+  currentUrlStartTime: number;
+};
+
+export default class Tracker {
+  state: TrackerState;
+  uuidSupplier: () => Promise<string>;
+
+  constructor(
+    private baseUrl: string,
+    private trackerId: string,
+    private options?: Options,
+  ) {
+    this.state = {
+      visitId: "",
+      visitDepth: 0,
+      prevUrl: "",
+      currentUrlStartTime: Date.now(),
+    };
+    this.uuidSupplier =
+      options?.uuidSupplier ||
+      (async () => {
+        try {
+          const { default: uuid } = await import("react-native-uuid");
+          return uuid.v4();
+        } catch (e) {
+          console.error(e);
+          return "";
+        }
+      });
+    this.uuidSupplier().then(e => (this.state.visitId = e));
+  }
+
+  public async getUrl(attributes?: Record<string, string>) {
+    const queryString = new URLSearchParams({
+      r: Math.random().toString(36).substring(2),
+      visit_id: this.state.visitId,
+      visit_depth: `${this.state.visitDepth++}`,
+      ...(this.options?.defaultAttributes && this.options.defaultAttributes()),
+      ...(!this.options?.disableLanguages && (await getLanguages())),
+      ...(!this.options?.disableDeviceInfo &&
+        (await getDeviceInfo(this.options?.excludeDeviceInfo))),
+      ...attributes,
+    }).toString();
+    return new URL(
+      `tracker/${this.trackerId}/collect?${queryString}`,
+      this.baseUrl,
+    ).href;
+  }
+
+  public async track(attributes?: Record<string, string>) {
+    await fetch(await this.getUrl(attributes), { credentials: "include" });
+  }
+
+  public async trackNavigation(currentRoutingKey: string) {
+    const now = Date.now();
+    const current_url = currentRoutingKey;
+    const previous_url = `${this.state.prevUrl}`;
+    const previous_url_duration_ms = `${now - this.state.currentUrlStartTime}`;
+    this.state.prevUrl = `${current_url}`;
+    this.state.currentUrlStartTime = now;
+    this.track({
+      current_url,
+      previous_url,
+      previous_url_duration_ms,
+    });
+  }
+}

package/src/useAppStateTracker.ts

@@ -0,0 +1,55 @@
+import { useEffect, useRef } from "react";
+import { AppState } from "react-native";
+import type Tracker from "./tracker";
+
+const useAppStateTracker = (
+  tracker: Tracker,
+  options?: {
+    landingAttributes?: () => Record<string, string>;
+    leavingAttributes?: () => Record<string, string>;
+    commonAttributes?: () => Record<string, string>;
+  },
+) => {
+  const mountedRef = useRef(false);
+  const appState = useRef(AppState.currentState);
+
+  // on mount
+  useEffect(() => {
+    if (!mountedRef.current) {
+      mountedRef.current = true;
+
+      tracker.track({
+        action: "land",
+        ...(options?.commonAttributes && options.commonAttributes()),
+        ...(options?.landingAttributes && options.landingAttributes()),
+      });
+    }
+  }, []);
+
+  // subscribe to app state change event
+  useEffect(() => {
+    const subscription = AppState.addEventListener("change", nextAppState => {
+      if (appState.current !== "active" && nextAppState === "active")
+        tracker.track({
+          action: "land",
+          ...(options?.commonAttributes && options.commonAttributes()),
+          ...(options?.landingAttributes && options.landingAttributes()),
+        });
+
+      if (appState.current !== "background" && nextAppState === "background")
+        tracker.track({
+          action: "leave",
+          ...(options?.commonAttributes && options.commonAttributes()),
+          ...(options?.leavingAttributes && options.leavingAttributes()),
+        });
+
+      appState.current = nextAppState;
+    });
+
+    return () => {
+      subscription.remove();
+    };
+  }, []);
+};
+
+export default useAppStateTracker;