@formo/analytics-react-native 0.1.0

package/lib/module/FormoAnalyticsProvider.js

@@ -0,0 +1,256 @@
+import React, { createContext, useContext, useEffect, useMemo, useRef, useState } from "react";
+import { FormoAnalytics } from "./FormoAnalytics";
+import { initStorageManager } from "./lib/storage";
+import { logger } from "./lib/logger";
+// Default context with no-op methods
+const defaultContext = {
+  chain: () => Promise.resolve(),
+  screen: () => Promise.resolve(),
+  reset: () => {},
+  cleanup: () => Promise.resolve(),
+  detect: () => Promise.resolve(),
+  connect: () => Promise.resolve(),
+  disconnect: () => Promise.resolve(),
+  signature: () => Promise.resolve(),
+  transaction: () => Promise.resolve(),
+  identify: () => Promise.resolve(),
+  track: () => Promise.resolve(),
+  setTrafficSourceFromUrl: () => {},
+  optOutTracking: () => {},
+  optInTracking: () => {},
+  hasOptedOutTracking: () => false
+};
+export const FormoAnalyticsContext = /*#__PURE__*/createContext(defaultContext);
+
+/**
+ * Formo Analytics Provider for React Native
+ *
+ * Wraps your app to provide analytics context
+ *
+ * @example
+ * ```tsx
+ * import AsyncStorage from '@react-native-async-storage/async-storage';
+ * import { FormoAnalyticsProvider } from '@formo/analytics-react-native';
+ *
+ * function App() {
+ *   return (
+ *     <FormoAnalyticsProvider
+ *       writeKey="your-write-key"
+ *       asyncStorage={AsyncStorage}
+ *       options={{ wagmi: { config, queryClient } }}
+ *     >
+ *       <YourApp />
+ *     </FormoAnalyticsProvider>
+ *   );
+ * }
+ * ```
+ */
+export const FormoAnalyticsProvider = props => {
+  const {
+    writeKey,
+    disabled = false,
+    children
+  } = props;
+  if (!writeKey) {
+    logger.error("FormoAnalyticsProvider: No Write Key provided");
+    return /*#__PURE__*/React.createElement(FormoAnalyticsContext.Provider, {
+      value: defaultContext
+    }, children);
+  }
+  if (disabled) {
+    logger.warn("FormoAnalytics is disabled");
+    return /*#__PURE__*/React.createElement(FormoAnalyticsContext.Provider, {
+      value: defaultContext
+    }, children);
+  }
+  return /*#__PURE__*/React.createElement(InitializedAnalytics, props);
+};
+const InitializedAnalytics = ({
+  writeKey,
+  options,
+  asyncStorage,
+  onReady,
+  onError,
+  children
+}) => {
+  const [sdk, setSdk] = useState(defaultContext);
+  const sdkRef = useRef(defaultContext);
+  const storageInitKeyRef = useRef(null);
+  const cleanupPromiseRef = useRef(Promise.resolve());
+  const initializationIdRef = useRef(0);
+
+  // Only initialize storage manager when writeKey changes, not on every render
+  if (storageInitKeyRef.current !== writeKey) {
+    initStorageManager(writeKey);
+    storageInitKeyRef.current = writeKey;
+  }
+
+  // Store callbacks and options in refs to avoid re-initialization when references change
+  // This fixes the issue where inline arrow functions cause repeated SDK init
+  const onReadyRef = useRef(onReady);
+  const onErrorRef = useRef(onError);
+  const optionsRef = useRef(options);
+
+  // Update refs when values change (without triggering effect)
+  useEffect(() => {
+    onReadyRef.current = onReady;
+  }, [onReady]);
+  useEffect(() => {
+    onErrorRef.current = onError;
+  }, [onError]);
+  useEffect(() => {
+    optionsRef.current = options;
+  }, [options]);
+
+  // Extract individual option values to avoid reference equality issues with options object
+  const tracking = options?.tracking;
+  const autocapture = options?.autocapture;
+  const apiHost = options?.apiHost;
+  const flushAt = options?.flushAt;
+  const flushInterval = options?.flushInterval;
+  const retryCount = options?.retryCount;
+  const maxQueueSize = options?.maxQueueSize;
+  const loggerOption = options?.logger;
+  const app = options?.app;
+  const hasReady = !!options?.ready;
+  const wagmiConfig = options?.wagmi?.config;
+  const wagmiQueryClient = options?.wagmi?.queryClient;
+
+  // Create stable key from serializable options
+  const optionsKey = useMemo(() => {
+    const serializableOptions = {
+      tracking,
+      autocapture,
+      apiHost,
+      flushAt,
+      flushInterval,
+      retryCount,
+      maxQueueSize,
+      logger: loggerOption,
+      app,
+      hasReady
+    };
+    try {
+      return JSON.stringify(serializableOptions);
+    } catch (error) {
+      logger.warn("Failed to serialize options, using timestamp", error);
+      return Date.now().toString();
+    }
+  }, [tracking, autocapture, apiHost, flushAt, flushInterval, retryCount, maxQueueSize, loggerOption, app, hasReady]);
+  useEffect(() => {
+    // Increment initialization ID to track which initialization is current
+    const currentInitId = ++initializationIdRef.current;
+    let isCleanedUp = false;
+    const initialize = async () => {
+      // Wait for any pending cleanup to complete before re-initializing
+      // This prevents race conditions between cleanup and init
+      await cleanupPromiseRef.current;
+
+      // Check if this initialization is still current after awaiting cleanup
+      if (currentInitId !== initializationIdRef.current || isCleanedUp) {
+        logger.debug("Skipping stale initialization");
+        return;
+      }
+
+      // Clean up existing SDK and await flush completion
+      if (sdkRef.current && sdkRef.current !== defaultContext) {
+        logger.log("Cleaning up existing FormoAnalytics SDK instance");
+        const cleanup = sdkRef.current.cleanup();
+        cleanupPromiseRef.current = cleanup;
+        await cleanup;
+        sdkRef.current = defaultContext;
+        setSdk(defaultContext);
+      }
+
+      // Check again after cleanup
+      if (currentInitId !== initializationIdRef.current || isCleanedUp) {
+        logger.debug("Skipping stale initialization after cleanup");
+        return;
+      }
+      try {
+        // Use optionsRef.current to ensure we have the latest options
+        const sdkInstance = await FormoAnalytics.init(writeKey, optionsRef.current, asyncStorage);
+
+        // Verify this initialization is still current
+        if (currentInitId !== initializationIdRef.current || isCleanedUp) {
+          logger.log("Initialization superseded, cleaning up new instance");
+          await sdkInstance.cleanup();
+          return;
+        }
+        setSdk(sdkInstance);
+        sdkRef.current = sdkInstance;
+        logger.log("Successfully initialized FormoAnalytics SDK");
+
+        // Call onReady callback using the ref (stable reference)
+        onReadyRef.current?.(sdkInstance);
+      } catch (error) {
+        if (currentInitId === initializationIdRef.current && !isCleanedUp) {
+          logger.error("Failed to initialize FormoAnalytics SDK", error);
+          // Call onError callback using the ref (stable reference)
+          onErrorRef.current?.(error instanceof Error ? error : new Error(String(error)));
+        }
+      }
+    };
+    initialize();
+    return () => {
+      isCleanedUp = true;
+      if (sdkRef.current && sdkRef.current !== defaultContext) {
+        logger.log("Cleaning up FormoAnalytics SDK instance");
+        // Store cleanup promise so next initialization can await it
+        const cleanup = sdkRef.current.cleanup().catch(error => {
+          logger.error("Error during SDK cleanup:", error);
+        });
+        cleanupPromiseRef.current = cleanup;
+        sdkRef.current = defaultContext;
+      }
+    };
+    // Note: onReady and onError are NOT in the dependency array
+    // They are accessed via refs to prevent re-initialization
+    // wagmiConfig and wagmiQueryClient are tracked separately since they're not serializable
+  }, [writeKey, optionsKey, asyncStorage, wagmiConfig, wagmiQueryClient]);
+  return /*#__PURE__*/React.createElement(FormoAnalyticsContext.Provider, {
+    value: sdk
+  }, children);
+};
+
+/**
+ * Hook to access Formo Analytics
+ *
+ * @example
+ * ```tsx
+ * import { useFormo } from '@formo/analytics-react-native';
+ *
+ * function MyScreen() {
+ *   const formo = useFormo();
+ *
+ *   useEffect(() => {
+ *     formo.screen('Home');
+ *   }, []);
+ *
+ *   const handleButtonPress = () => {
+ *     formo.track('Button Pressed', { buttonName: 'signup' });
+ *   };
+ *
+ *   return <Button onPress={handleButtonPress}>Sign Up</Button>;
+ * }
+ * ```
+ */
+// Track if the useFormo warning has been logged to avoid console spam
+let hasLoggedUseFormoWarning = false;
+export const useFormo = () => {
+  const context = useContext(FormoAnalyticsContext);
+
+  // Check if SDK has been initialized (context will be defaultContext before init completes)
+  // Only log the warning once to avoid flooding the console during async initialization
+  if (context === defaultContext && !hasLoggedUseFormoWarning) {
+    hasLoggedUseFormoWarning = true;
+    logger.warn("useFormo called before SDK initialization complete. " + "Ensure FormoAnalyticsProvider is mounted and writeKey is provided.");
+  }
+
+  // Reset the warning flag when SDK is initialized so it can warn again after a reset
+  if (context !== defaultContext) {
+    hasLoggedUseFormoWarning = false;
+  }
+  return context;
+};
+//# sourceMappingURL=FormoAnalyticsProvider.js.map

package/lib/module/FormoAnalyticsProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["React","createContext","useContext","useEffect","useMemo","useRef","useState","FormoAnalytics","initStorageManager","logger","defaultContext","chain","Promise","resolve","screen","reset","cleanup","detect","connect","disconnect","signature","transaction","identify","track","setTrafficSourceFromUrl","optOutTracking","optInTracking","hasOptedOutTracking","FormoAnalyticsContext","FormoAnalyticsProvider","props","writeKey","disabled","children","error","createElement","Provider","value","warn","InitializedAnalytics","options","asyncStorage","onReady","onError","sdk","setSdk","sdkRef","storageInitKeyRef","cleanupPromiseRef","initializationIdRef","current","onReadyRef","onErrorRef","optionsRef","tracking","autocapture","apiHost","flushAt","flushInterval","retryCount","maxQueueSize","loggerOption","app","hasReady","ready","wagmiConfig","wagmi","config","wagmiQueryClient","queryClient","optionsKey","serializableOptions","JSON","stringify","Date","now","toString","currentInitId","isCleanedUp","initialize","debug","log","sdkInstance","init","Error","String","catch","hasLoggedUseFormoWarning","useFormo","context"],"sourceRoot":"../../src","sources":["FormoAnalyticsProvider.tsx"],"mappings":"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","ignoreList":[]}

package/lib/module/constants/config.js

@@ -0,0 +1,62 @@
+export const EVENTS_API_ORIGIN = "https://events.formo.so";
+export const EVENTS_API_HOST = `${EVENTS_API_ORIGIN}/v0/raw_events`;
+export const EVENTS_API_REQUEST_HEADER = writeKey => ({
+  "Content-Type": "application/json",
+  Authorization: `Bearer ${writeKey}`
+});
+
+// Timezone to country mapping
+export const COUNTRY_LIST = {
+  // Africa
+  "Africa/Abidjan": "CI",
+  "Africa/Accra": "GH",
+  "Africa/Addis_Ababa": "ET",
+  "Africa/Algiers": "DZ",
+  "Africa/Cairo": "EG",
+  "Africa/Casablanca": "MA",
+  "Africa/Johannesburg": "ZA",
+  "Africa/Lagos": "NG",
+  "Africa/Nairobi": "KE",
+  // America
+  "America/Anchorage": "US",
+  "America/Argentina/Buenos_Aires": "AR",
+  "America/Bogota": "CO",
+  "America/Chicago": "US",
+  "America/Denver": "US",
+  "America/Los_Angeles": "US",
+  "America/Mexico_City": "MX",
+  "America/New_York": "US",
+  "America/Phoenix": "US",
+  "America/Sao_Paulo": "BR",
+  "America/Toronto": "CA",
+  "America/Vancouver": "CA",
+  // Asia
+  "Asia/Bangkok": "TH",
+  "Asia/Dubai": "AE",
+  "Asia/Ho_Chi_Minh": "VN",
+  "Asia/Hong_Kong": "HK",
+  "Asia/Jakarta": "ID",
+  "Asia/Kolkata": "IN",
+  "Asia/Manila": "PH",
+  "Asia/Seoul": "KR",
+  "Asia/Shanghai": "CN",
+  "Asia/Singapore": "SG",
+  "Asia/Taipei": "TW",
+  "Asia/Tokyo": "JP",
+  // Australia
+  "Australia/Melbourne": "AU",
+  "Australia/Sydney": "AU",
+  // Europe
+  "Europe/Amsterdam": "NL",
+  "Europe/Berlin": "DE",
+  "Europe/London": "GB",
+  "Europe/Madrid": "ES",
+  "Europe/Moscow": "RU",
+  "Europe/Paris": "FR",
+  "Europe/Rome": "IT",
+  "Europe/Zurich": "CH",
+  // Pacific
+  "Pacific/Auckland": "NZ",
+  "Pacific/Honolulu": "US"
+};
+//# sourceMappingURL=config.js.map

package/lib/module/constants/config.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["EVENTS_API_ORIGIN","EVENTS_API_HOST","EVENTS_API_REQUEST_HEADER","writeKey","Authorization","COUNTRY_LIST"],"sourceRoot":"../../../src","sources":["constants/config.ts"],"mappings":"AAAA,OAAO,MAAMA,iBAAiB,GAAG,yBAAyB;AAC1D,OAAO,MAAMC,eAAe,GAAG,GAAGD,iBAAiB,gBAAgB;AAEnE,OAAO,MAAME,yBAAyB,GAAIC,QAAgB,KAAM;EAC9D,cAAc,EAAE,kBAAkB;EAClCC,aAAa,EAAE,UAAUD,QAAQ;AACnC,CAAC,CAAC;;AAEF;AACA,OAAO,MAAME,YAAoC,GAAG;EAClD;EACA,gBAAgB,EAAE,IAAI;EACtB,cAAc,EAAE,IAAI;EACpB,oBAAoB,EAAE,IAAI;EAC1B,gBAAgB,EAAE,IAAI;EACtB,cAAc,EAAE,IAAI;EACpB,mBAAmB,EAAE,IAAI;EACzB,qBAAqB,EAAE,IAAI;EAC3B,cAAc,EAAE,IAAI;EACpB,gBAAgB,EAAE,IAAI;EACtB;EACA,mBAAmB,EAAE,IAAI;EACzB,gCAAgC,EAAE,IAAI;EACtC,gBAAgB,EAAE,IAAI;EACtB,iBAAiB,EAAE,IAAI;EACvB,gBAAgB,EAAE,IAAI;EACtB,qBAAqB,EAAE,IAAI;EAC3B,qBAAqB,EAAE,IAAI;EAC3B,kBAAkB,EAAE,IAAI;EACxB,iBAAiB,EAAE,IAAI;EACvB,mBAAmB,EAAE,IAAI;EACzB,iBAAiB,EAAE,IAAI;EACvB,mBAAmB,EAAE,IAAI;EACzB;EACA,cAAc,EAAE,IAAI;EACpB,YAAY,EAAE,IAAI;EAClB,kBAAkB,EAAE,IAAI;EACxB,gBAAgB,EAAE,IAAI;EACtB,cAAc,EAAE,IAAI;EACpB,cAAc,EAAE,IAAI;EACpB,aAAa,EAAE,IAAI;EACnB,YAAY,EAAE,IAAI;EAClB,eAAe,EAAE,IAAI;EACrB,gBAAgB,EAAE,IAAI;EACtB,aAAa,EAAE,IAAI;EACnB,YAAY,EAAE,IAAI;EAClB;EACA,qBAAqB,EAAE,IAAI;EAC3B,kBAAkB,EAAE,IAAI;EACxB;EACA,kBAAkB,EAAE,IAAI;EACxB,eAAe,EAAE,IAAI;EACrB,eAAe,EAAE,IAAI;EACrB,eAAe,EAAE,IAAI;EACrB,eAAe,EAAE,IAAI;EACrB,cAAc,EAAE,IAAI;EACpB,aAAa,EAAE,IAAI;EACnB,eAAe,EAAE,IAAI;EACrB;EACA,kBAAkB,EAAE,IAAI;EACxB,kBAAkB,EAAE;AACtB,CAAC","ignoreList":[]}

package/lib/module/constants/events.js

@@ -0,0 +1,24 @@
+export let EventType = /*#__PURE__*/function (EventType) {
+  EventType["PAGE"] = "page";
+  EventType["SCREEN"] = "screen";
+  EventType["IDENTIFY"] = "identify";
+  EventType["DETECT"] = "detect";
+  EventType["CONNECT"] = "connect";
+  EventType["DISCONNECT"] = "disconnect";
+  EventType["CHAIN"] = "chain";
+  EventType["SIGNATURE"] = "signature";
+  EventType["TRANSACTION"] = "transaction";
+  EventType["TRACK"] = "track";
+  return EventType;
+}({});
+export let EventChannel = /*#__PURE__*/function (EventChannel) {
+  EventChannel["WEB"] = "web";
+  EventChannel["MOBILE"] = "mobile";
+  EventChannel["SERVER"] = "server";
+  EventChannel["SOURCE"] = "source";
+  return EventChannel;
+}({});
+// React Native SDK uses mobile channel
+export const CHANNEL = "mobile";
+export const VERSION = "1";
+//# sourceMappingURL=events.js.map

package/lib/module/constants/events.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["EventType","EventChannel","CHANNEL","VERSION"],"sourceRoot":"../../../src","sources":["constants/events.ts"],"mappings":"AAAA,WAAYA,SAAS,0BAATA,SAAS;EAATA,SAAS;EAATA,SAAS;EAATA,SAAS;EAATA,SAAS;EAATA,SAAS;EAATA,SAAS;EAATA,SAAS;EAATA,SAAS;EAATA,SAAS;EAATA,SAAS;EAAA,OAATA,SAAS;AAAA;AAarB,WAAYC,YAAY,0BAAZA,YAAY;EAAZA,YAAY;EAAZA,YAAY;EAAZA,YAAY;EAAZA,YAAY;EAAA,OAAZA,YAAY;AAAA;AAUxB;AACA,OAAO,MAAMC,OAAsB,GAAG,QAAQ;AAC9C,OAAO,MAAMC,OAAO,GAAG,GAAG","ignoreList":[]}

package/lib/module/constants/index.js

@@ -0,0 +1,4 @@
+export * from "./events";
+export * from "./config";
+export * from "./storage";
+//# sourceMappingURL=index.js.map

package/lib/module/constants/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sourceRoot":"../../../src","sources":["constants/index.ts"],"mappings":"AAAA,cAAc,UAAU;AACxB,cAAc,UAAU;AACxB,cAAc,WAAW","ignoreList":[]}

package/lib/module/constants/storage.js

@@ -0,0 +1,17 @@
+// Storage keys for React Native SDK
+export const STORAGE_PREFIX = "formo_rn_";
+
+// Local storage keys (persistent)
+export const LOCAL_ANONYMOUS_ID_KEY = "anonymous_id";
+export const LOCAL_APP_VERSION_KEY = "app_version";
+export const LOCAL_APP_BUILD_KEY = "app_build";
+
+// Session storage keys (cleared on app restart)
+export const SESSION_USER_ID_KEY = "user_id";
+export const SESSION_TRAFFIC_SOURCE_KEY = "traffic_source";
+export const SESSION_WALLET_DETECTED_KEY = "wallet_detected";
+export const SESSION_WALLET_IDENTIFIED_KEY = "wallet_identified";
+
+// Consent keys
+export const CONSENT_OPT_OUT_KEY = "opt_out_tracking";
+//# sourceMappingURL=storage.js.map

package/lib/module/constants/storage.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["STORAGE_PREFIX","LOCAL_ANONYMOUS_ID_KEY","LOCAL_APP_VERSION_KEY","LOCAL_APP_BUILD_KEY","SESSION_USER_ID_KEY","SESSION_TRAFFIC_SOURCE_KEY","SESSION_WALLET_DETECTED_KEY","SESSION_WALLET_IDENTIFIED_KEY","CONSENT_OPT_OUT_KEY"],"sourceRoot":"../../../src","sources":["constants/storage.ts"],"mappings":"AAAA;AACA,OAAO,MAAMA,cAAc,GAAG,WAAW;;AAEzC;AACA,OAAO,MAAMC,sBAAsB,GAAG,cAAc;AACpD,OAAO,MAAMC,qBAAqB,GAAG,aAAa;AAClD,OAAO,MAAMC,mBAAmB,GAAG,WAAW;;AAE9C;AACA,OAAO,MAAMC,mBAAmB,GAAG,SAAS;AAC5C,OAAO,MAAMC,0BAA0B,GAAG,gBAAgB;AAC1D,OAAO,MAAMC,2BAA2B,GAAG,iBAAiB;AAC5D,OAAO,MAAMC,6BAA6B,GAAG,mBAAmB;;AAEhE;AACA,OAAO,MAAMC,mBAAmB,GAAG,kBAAkB","ignoreList":[]}

package/lib/module/index.js

@@ -0,0 +1,51 @@
+/**
+ * Formo Analytics SDK for React Native
+ *
+ * Track wallet events and user analytics in mobile dApps
+ *
+ * @example
+ * ```tsx
+ * import AsyncStorage from '@react-native-async-storage/async-storage';
+ * import { FormoAnalyticsProvider, useFormo } from '@formo/analytics-react-native';
+ *
+ * // Wrap your app with the provider
+ * function App() {
+ *   return (
+ *     <FormoAnalyticsProvider
+ *       writeKey="your-write-key"
+ *       asyncStorage={AsyncStorage}
+ *       options={{
+ *         wagmi: { config, queryClient },
+ *         app: { name: 'MyApp', version: '1.0.0' },
+ *       }}
+ *     >
+ *       <YourApp />
+ *     </FormoAnalyticsProvider>
+ *   );
+ * }
+ *
+ * // Use the hook in your components
+ * function MyScreen() {
+ *   const formo = useFormo();
+ *
+ *   useEffect(() => {
+ *     formo.screen('Home');
+ *   }, []);
+ *
+ *   return <View>...</View>;
+ * }
+ * ```
+ */
+
+// Main exports
+export { FormoAnalytics } from "./FormoAnalytics";
+export { FormoAnalyticsProvider, FormoAnalyticsContext, useFormo } from "./FormoAnalyticsProvider";
+
+// Types
+export * from "./types";
+
+// Event types for manual event tracking
+export { SignatureStatus, TransactionStatus } from "./types/events";
+
+// Storage types for custom storage implementations
+//# sourceMappingURL=index.js.map

package/lib/module/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["FormoAnalytics","FormoAnalyticsProvider","FormoAnalyticsContext","useFormo","SignatureStatus","TransactionStatus"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;AACA,SAASA,cAAc,QAAQ,kBAAkB;AACjD,SACEC,sBAAsB,EACtBC,qBAAqB,EACrBC,QAAQ,QACH,0BAA0B;;AAEjC;AACA,cAAc,SAAS;;AAEvB;AACA,SAASC,eAAe,EAAEC,iBAAiB,QAAQ,gBAAgB;;AAEnE","ignoreList":[]}

package/lib/module/lib/consent/index.js

@@ -0,0 +1,49 @@
+import { storage } from "../storage";
+import { logger } from "../logger";
+
+/**
+ * Get consent storage key
+ * Note: The storage adapter already prefixes keys with formo_rn_{writeKey}_
+ * so we just need a simple consent prefix here
+ */
+function getConsentKey(_writeKey, key) {
+  return `consent_${key}`;
+}
+
+/**
+ * Set a consent flag
+ */
+export function setConsentFlag(writeKey, key, value) {
+  try {
+    const consentKey = getConsentKey(writeKey, key);
+    storage().set(consentKey, value);
+  } catch (error) {
+    logger.error("Consent: Failed to set flag", error);
+  }
+}
+
+/**
+ * Get a consent flag
+ */
+export function getConsentFlag(writeKey, key) {
+  try {
+    const consentKey = getConsentKey(writeKey, key);
+    return storage().get(consentKey);
+  } catch (error) {
+    logger.error("Consent: Failed to get flag", error);
+    return null;
+  }
+}
+
+/**
+ * Remove a consent flag
+ */
+export function removeConsentFlag(writeKey, key) {
+  try {
+    const consentKey = getConsentKey(writeKey, key);
+    storage().remove(consentKey);
+  } catch (error) {
+    logger.error("Consent: Failed to remove flag", error);
+  }
+}
+//# sourceMappingURL=index.js.map

package/lib/module/lib/consent/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["storage","logger","getConsentKey","_writeKey","key","setConsentFlag","writeKey","value","consentKey","set","error","getConsentFlag","get","removeConsentFlag","remove"],"sourceRoot":"../../../../src","sources":["lib/consent/index.ts"],"mappings":"AAAA,SAASA,OAAO,QAAQ,YAAY;AACpC,SAASC,MAAM,QAAQ,WAAW;;AAElC;AACA;AACA;AACA;AACA;AACA,SAASC,aAAaA,CAACC,SAAiB,EAAEC,GAAW,EAAU;EAC7D,OAAO,WAAWA,GAAG,EAAE;AACzB;;AAEA;AACA;AACA;AACA,OAAO,SAASC,cAAcA,CAC5BC,QAAgB,EAChBF,GAAW,EACXG,KAAa,EACP;EACN,IAAI;IACF,MAAMC,UAAU,GAAGN,aAAa,CAACI,QAAQ,EAAEF,GAAG,CAAC;IAC/CJ,OAAO,CAAC,CAAC,CAACS,GAAG,CAACD,UAAU,EAAED,KAAK,CAAC;EAClC,CAAC,CAAC,OAAOG,KAAK,EAAE;IACdT,MAAM,CAACS,KAAK,CAAC,6BAA6B,EAAEA,KAAK,CAAC;EACpD;AACF;;AAEA;AACA;AACA;AACA,OAAO,SAASC,cAAcA,CAACL,QAAgB,EAAEF,GAAW,EAAiB;EAC3E,IAAI;IACF,MAAMI,UAAU,GAAGN,aAAa,CAACI,QAAQ,EAAEF,GAAG,CAAC;IAC/C,OAAOJ,OAAO,CAAC,CAAC,CAACY,GAAG,CAACJ,UAAU,CAAC;EAClC,CAAC,CAAC,OAAOE,KAAK,EAAE;IACdT,MAAM,CAACS,KAAK,CAAC,6BAA6B,EAAEA,KAAK,CAAC;IAClD,OAAO,IAAI;EACb;AACF;;AAEA;AACA;AACA;AACA,OAAO,SAASG,iBAAiBA,CAACP,QAAgB,EAAEF,GAAW,EAAQ;EACrE,IAAI;IACF,MAAMI,UAAU,GAAGN,aAAa,CAACI,QAAQ,EAAEF,GAAG,CAAC;IAC/CJ,OAAO,CAAC,CAAC,CAACc,MAAM,CAACN,UAAU,CAAC;EAC9B,CAAC,CAAC,OAAOE,KAAK,EAAE;IACdT,MAAM,CAACS,KAAK,CAAC,gCAAgC,EAAEA,KAAK,CAAC;EACvD;AACF","ignoreList":[]}