@emit-vision/sdk-react-native 0.1.1 → 0.2.0

package/README.md

@@ -70,6 +70,48 @@ function SaveButton() {
 }
 ```
 
+## Consent
+
+Pass `consentRequired: true` to `initRN`, then record the user's choice:
+
+```tsx
+import { grantConsent, declineConsent } from "@emit-vision/sdk-react-native";
+
+<Button title="Accept" onPress={() => grantConsent()} />
+<Button title="Decline" onPress={() => declineConsent()} />
+```
+
+When you pass `asyncStorage` to `initRN`, the choice is saved through it, so a
+grant or a decline survives app restarts and the user isn't asked again.
+
+**Without `asyncStorage` (and without a `consentStorage`), the choice is kept
+in memory only and is forgotten when the app restarts.**
+
+To persist consent somewhere other than AsyncStorage, pass a `consentStorage`
+to `initRN`. It takes precedence over `asyncStorage` for consent. `getItem`
+must answer synchronously; writes may be async:
+
+```ts
+import type { ConsentStorage } from "@emit-vision/sdk-js";
+
+const consentStorage: ConsentStorage = {
+  getItem: (key) => cache.get(key) ?? null,
+  setItem: (key, value) => {
+    cache.set(key, value);
+    return persist(key, value);
+  },
+  removeItem: (key) => {
+    cache.delete(key);
+    return unpersist(key);
+  },
+};
+
+await initRN({ dsn, consentRequired: true, consentStorage });
+```
+
+See the [consent model](https://emitvision.com/docs/sdk-js#consent) for the
+states and what is sent in each.
+
 ## Notes
 
 - Page-view auto-capture is disabled — there is no DOM in React Native.

package/dist/index.d.ts

@@ -1,9 +1,10 @@
-import { EmitVisionOptions, captureEvent, captureError, identify, group, consent, flush, setContext, setTags } from '@emit-vision/sdk-js';
-export { CaptureOptions, EmitVisionOptions, EmitVisionUser, captureError, captureEvent, consent, flush, group, identify, setContext, setTags } from '@emit-vision/sdk-js';
+import { EmitVisionOptions, captureEvent, captureError, identify, group, consent, grantConsent, declineConsent, getConsentState, onConsentChange, flush, setContext, setTags } from '@emit-vision/sdk-js';
+export { CaptureOptions, ConsentState, EmitVisionOptions, EmitVisionUser, captureError, captureEvent, consent, declineConsent, flush, getConsentState, grantConsent, group, identify, onConsentChange, setContext, setTags } from '@emit-vision/sdk-js';
 
 type AsyncStorageLike = {
     getItem(key: string): Promise<string | null>;
     setItem(key: string, value: string): Promise<void>;
+    removeItem?(key: string): Promise<void>;
 };
 type NetInfoState = {
     isConnected: boolean | null;
@@ -39,6 +40,10 @@ type EmitVisionRNApi = {
     identify: typeof identify;
     group: typeof group;
     consent: typeof consent;
+    grantConsent: typeof grantConsent;
+    declineConsent: typeof declineConsent;
+    getConsentState: typeof getConsentState;
+    onConsentChange: typeof onConsentChange;
     flush: typeof flush;
     setContext: typeof setContext;
     setTags: typeof setTags;

package/dist/index.js

@@ -5,6 +5,10 @@ import {
   identify as identify2,
   group as group2,
   consent as consent2,
+  grantConsent as grantConsent2,
+  declineConsent as declineConsent2,
+  getConsentState as getConsentState2,
+  onConsentChange as onConsentChange2,
   flush as flush3,
   setContext as setContext2,
   setTags as setTags2
@@ -12,10 +16,34 @@ import {
 
 // src/client-rn.ts
 import {
+  consentStorageKey,
   init,
   flush,
   captureError
 } from "@emit-vision/sdk-js";
+
+// src/consent-storage.ts
+async function createConsentStorage(asyncStorage, key) {
+  const cache = /* @__PURE__ */ new Map();
+  try {
+    const stored = await asyncStorage.getItem(key);
+    if (stored) cache.set(key, stored);
+  } catch {
+  }
+  return {
+    getItem: (k) => cache.get(k) ?? null,
+    setItem: (k, v) => {
+      cache.set(k, v);
+      return asyncStorage.setItem(k, v);
+    },
+    removeItem: (k) => {
+      cache.delete(k);
+      return asyncStorage.removeItem?.(k);
+    }
+  };
+}
+
+// src/client-rn.ts
 var ANON_ID_KEY = "__ev_anon_id";
 async function getOrCreateAnonId(storage) {
   try {
@@ -31,9 +59,14 @@ async function getOrCreateAnonId(storage) {
 async function initRN(options) {
   const { asyncStorage, netInfo, appState, errorUtils, ...sdkOptions } = options;
   const sessionId = sdkOptions.sessionId ?? (asyncStorage ? await getOrCreateAnonId(asyncStorage) : void 0);
+  const consentStorage = sdkOptions.consentStorage ?? (asyncStorage ? await createConsentStorage(
+    asyncStorage,
+    consentStorageKey(sdkOptions.apiKey ?? "", sdkOptions.projectId)
+  ) : void 0);
   const client = init({
     ...sdkOptions,
     sessionId,
+    consentStorage,
     autoCapture: {
       ...sdkOptions.autoCapture,
       pageViews: false
@@ -89,6 +122,10 @@ import {
   identify,
   group,
   consent,
+  grantConsent,
+  declineConsent,
+  getConsentState,
+  onConsentChange,
   flush as flush2,
   setContext,
   setTags
@@ -99,6 +136,10 @@ var api = {
   identify,
   group,
   consent,
+  grantConsent,
+  declineConsent,
+  getConsentState,
+  onConsentChange,
   flush: flush2,
   setContext,
   setTags
@@ -110,10 +151,14 @@ export {
   captureError3 as captureError,
   captureEvent2 as captureEvent,
   consent2 as consent,
+  declineConsent2 as declineConsent,
   flush3 as flush,
+  getConsentState2 as getConsentState,
+  grantConsent2 as grantConsent,
   group2 as group,
   identify2 as identify,
   initRN,
+  onConsentChange2 as onConsentChange,
   setContext2 as setContext,
   setTags2 as setTags,
   useEmitVision

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@emit-vision/sdk-react-native",
-  "version": "0.1.1",
+  "version": "0.2.0",
   "description": "React Native SDK for emit-vision analytics and error tracking.",
   "private": false,
   "license": "MIT",
@@ -39,7 +39,7 @@
     }
   },
   "dependencies": {
-    "@emit-vision/sdk-js": "^0.4.3"
+    "@emit-vision/sdk-js": "^0.5.0"
   },
   "scripts": {
     "build": "tsup --config tsup.config.ts",