@nexly/react-native 0.17.0 → 1.0.0

package/README.md

@@ -87,6 +87,10 @@ No scroll/click tracking (those are DOM-only); if you want tap analytics, send c
 
 `startEngagement()` is idempotent — calling it again stops the previous subscription first, so Fast Refresh or double-mounts cannot produce duplicate listeners.
 
+## Privacy mode (no device storage)
+
+Pass `privacyMode` to the provider (or `Nexly.init({ privacyMode: true })`) and Nexly never reads or writes `AsyncStorage` for its visitor / session identifiers. Events go out without client-side IDs; the Nexly collector derives a daily-rotating visit fingerprint server-side instead. Cross-day returning-visitor metrics are not available in this mode.
+
 ## Dashboard setup
 
 Enable Mobile apps in your app's Ingest settings in the

package/dist/engagement.d.ts

@@ -2,6 +2,7 @@ import { type IngestCredentials, type NexlyClient } from '@nexly/core';
 type EngagementCreds = {
     collectUrl: string;
     client?: NexlyClient;
+    privacyMode?: boolean;
 } & IngestCredentials;
 type StopFn = () => void;
 /**

package/dist/engagement.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"engagement.d.ts","sourceRoot":"","sources":["../src/engagement.ts"],"names":[],"mappings":"AACA,OAAO,EAAuB,KAAK,iBAAiB,EAAE,KAAK,WAAW,EAAE,MAAM,aAAa,CAAA;AAQ3F,KAAK,eAAe,GAAG;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,WAAW,CAAA;CAAE,GAAG,iBAAiB,CAAA;AAqBvF,KAAK,MAAM,GAAG,MAAM,IAAI,CAAA;AAExB;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,CAyCtE"}
+{"version":3,"file":"engagement.d.ts","sourceRoot":"","sources":["../src/engagement.ts"],"names":[],"mappings":"AACA,OAAO,EAAuB,KAAK,iBAAiB,EAAE,KAAK,WAAW,EAAE,MAAM,aAAa,CAAA;AAQ3F,KAAK,eAAe,GAAG;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAAC,WAAW,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,iBAAiB,CAAA;AAsB9G,KAAK,MAAM,GAAG,MAAM,IAAI,CAAA;AAExB;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,CAyCtE"}

package/dist/engagement.js

@@ -9,6 +9,7 @@ function send(creds, eventName, eventType, data, sessionContext) {
     const payload = buildCollectPayload({
         credentials: { appId: creds.appId, apiToken: creds.apiToken },
         client: creds.client,
+        privacyMode: creds.privacyMode,
         eventName,
         eventType,
         context: collectEventMeta(),
@@ -48,7 +49,7 @@ export function startEngagementTracking(creds) {
                 send(creds, 'session_ping', 'lifecycle', { active_seconds: activeSeconds });
             }
         }
-        if (next === 'active') {
+        if (next === 'active' && !creds.privacyMode) {
             void touchSession();
         }
     });

package/dist/nexly-provider.d.ts

@@ -13,13 +13,20 @@ export type NexlyProviderProps = {
      * Update it later with `client.setScreen(name)` or `client.screenview(name)`.
      */
     initialScreen?: string;
+    /**
+     * Privacy mode: never read or write `AsyncStorage` for visitor / session
+     * identifiers. The collector derives a daily-rotating visit fingerprint
+     * server-side instead.
+     * @default false
+     */
+    privacyMode?: boolean;
     children: ReactNode;
 };
 /**
  * Initializes the Nexly client asynchronously (AsyncStorage prewarm) and exposes it
  * via context. `useNexlyClient()` returns `null` until init completes or if credentials are missing.
  */
-export declare function NexlyProvider({ collectUrl, appId, ingestKey, autoEngagement, initialScreen, children, }: NexlyProviderProps): import("react/jsx-runtime").JSX.Element;
+export declare function NexlyProvider({ collectUrl, appId, ingestKey, autoEngagement, initialScreen, privacyMode, children, }: NexlyProviderProps): import("react/jsx-runtime").JSX.Element;
 /** Returns the configured {@link Nexly} client, or `null` if not yet ready / credentials missing. */
 export declare function useNexlyClient(): Nexly | null;
 //# sourceMappingURL=nexly-provider.d.ts.map

package/dist/nexly-provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"nexly-provider.d.ts","sourceRoot":"","sources":["../src/nexly-provider.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAkD,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AACtF,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAIlC,MAAM,MAAM,kBAAkB,GAAG;IAC/B,8EAA8E;IAC9E,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,KAAK,EAAE,MAAM,CAAA;IACb,8FAA8F;IAC9F,SAAS,EAAE,MAAM,CAAA;IACjB,4FAA4F;IAC5F,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,QAAQ,EAAE,SAAS,CAAA;CACpB,CAAA;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,EAC5B,UAAU,EACV,KAAK,EACL,SAAS,EACT,cAAsB,EACtB,aAAa,EACb,QAAQ,GACT,EAAE,kBAAkB,2CA6BpB;AAED,qGAAqG;AACrG,wBAAgB,cAAc,IAAI,KAAK,GAAG,IAAI,CAE7C"}
+{"version":3,"file":"nexly-provider.d.ts","sourceRoot":"","sources":["../src/nexly-provider.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAkD,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AACtF,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAIlC,MAAM,MAAM,kBAAkB,GAAG;IAC/B,8EAA8E;IAC9E,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,KAAK,EAAE,MAAM,CAAA;IACb,8FAA8F;IAC9F,SAAS,EAAE,MAAM,CAAA;IACjB,4FAA4F;IAC5F,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB;;;;;OAKG;IACH,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,QAAQ,EAAE,SAAS,CAAA;CACpB,CAAA;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,EAC5B,UAAU,EACV,KAAK,EACL,SAAS,EACT,cAAsB,EACtB,aAAa,EACb,WAAmB,EACnB,QAAQ,GACT,EAAE,kBAAkB,2CA6BpB;AAED,qGAAqG;AACrG,wBAAgB,cAAc,IAAI,KAAK,GAAG,IAAI,CAE7C"}

package/dist/nexly-provider.js

@@ -6,7 +6,7 @@ const NexlyClientContext = createContext(null);
  * Initializes the Nexly client asynchronously (AsyncStorage prewarm) and exposes it
  * via context. `useNexlyClient()` returns `null` until init completes or if credentials are missing.
  */
-export function NexlyProvider({ collectUrl, appId, ingestKey, autoEngagement = false, initialScreen, children, }) {
+export function NexlyProvider({ collectUrl, appId, ingestKey, autoEngagement = false, initialScreen, privacyMode = false, children, }) {
     const [client, setClient] = useState(null);
     useEffect(() => {
         const id = (appId ?? '').trim();
@@ -20,7 +20,7 @@ export function NexlyProvider({ collectUrl, appId, ingestKey, autoEngagement = f
             return;
         }
         let cancelled = false;
-        Nexly.init({ collectUrl, appId: id, key: k }).then((instance) => {
+        Nexly.init({ collectUrl, appId: id, key: k, privacyMode }).then((instance) => {
             if (cancelled)
                 return;
             if (initialScreen)
@@ -30,7 +30,7 @@ export function NexlyProvider({ collectUrl, appId, ingestKey, autoEngagement = f
         return () => {
             cancelled = true;
         };
-    }, [collectUrl, appId, ingestKey, initialScreen]);
+    }, [collectUrl, appId, ingestKey, initialScreen, privacyMode]);
     useEffect(() => {
         if (!autoEngagement || !client)
             return;

package/dist/nexly.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"nexly.d.ts","sourceRoot":"","sources":["../src/nexly.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAe,KAAK,SAAS,EAAE,MAAM,aAAa,CAAA;AAmBpE;;;;;;GAMG;AACH,qBAAa,KAAM,SAAQ,SAAS;IAClC,OAAO,CAAC,aAAa,CAAM;IAC3B,OAAO,CAAC,cAAc,CAA4B;IAElD;;;OAGG;WACU,IAAI,CAAC,OAAO,EAAE,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC;IASrD,+DAA+D;IAC/D,MAAM,CAAC,WAAW,IAAI,KAAK,GAAG,IAAI;gBAItB,IAAI,EAAE,SAAS;IAI3B,yEAAyE;IACzE,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAK7B,+DAA+D;IAC/D,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;cAKd,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO;cAIpD,mBAAmB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;cAI9C,qBAAqB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAI1D,cAAc,IAAI,MAAM;IAIjC;;;OAGG;IACH,eAAe,IAAI,MAAM,IAAI;CAe9B"}
+{"version":3,"file":"nexly.d.ts","sourceRoot":"","sources":["../src/nexly.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAe,KAAK,SAAS,EAAE,MAAM,aAAa,CAAA;AAmBpE;;;;;;GAMG;AACH,qBAAa,KAAM,SAAQ,SAAS;IAClC,OAAO,CAAC,aAAa,CAAM;IAC3B,OAAO,CAAC,cAAc,CAA4B;IAElD;;;OAGG;WACU,IAAI,CAAC,OAAO,EAAE,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC;IAYrD,+DAA+D;IAC/D,MAAM,CAAC,WAAW,IAAI,KAAK,GAAG,IAAI;gBAItB,IAAI,EAAE,SAAS;IAI3B,yEAAyE;IACzE,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAK7B,+DAA+D;IAC/D,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;cAKd,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO;cAIpD,mBAAmB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;cAI9C,qBAAqB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAI1D,cAAc,IAAI,MAAM;IAIjC;;;OAGG;IACH,eAAe,IAAI,MAAM,IAAI;CAgB9B"}

package/dist/nexly.js

@@ -32,7 +32,10 @@ export class Nexly extends NexlyBase {
     static async init(options) {
         const instance = new Nexly({ ...options, client: options.client ?? defaultClient() });
         Nexly.setInstance(instance);
-        if (instance.appId && instance.key) {
+        // Privacy mode skips ID prewarming entirely: AsyncStorage is never read
+        // or written, events go out without IDs and the collector derives a
+        // daily visit fingerprint server-side (privacy_mode is on the wire).
+        if (instance.appId && instance.key && !instance.privacyMode) {
             await prewarmIds();
         }
         return instance;
@@ -79,6 +82,7 @@ export class Nexly extends NexlyBase {
             appId: this.appId,
             apiToken: this.key,
             client: this.client,
+            privacyMode: this.privacyMode,
         });
         this.engagementStop = stop;
         return () => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nexly/react-native",
-  "version": "0.17.0",
+  "version": "1.0.0",
   "description": "React Native bindings for Nexly: fetch transport, AsyncStorage IDs, AppState engagement on top of @nexly/core",
   "license": "MIT",
   "keywords": [
@@ -43,7 +43,7 @@
     "react-native": ">=0.72.0"
   },
   "dependencies": {
-    "@nexly/core": "0.17.0"
+    "@nexly/core": "1.0.0"
   },
   "devDependencies": {
     "@react-native-async-storage/async-storage": "^2.1.2",