@formo/analytics 1.17.1 → 1.17.2

package/src/FormoAnalyticsProvider.tsx

@@ -0,0 +1,84 @@
+import { createContext, useContext, useEffect, useRef, useState } from "react";
+import { FormoAnalytics } from "./FormoAnalytics";
+import { initStorageManager, logger } from "./lib";
+import { FormoAnalyticsProviderProps, IFormoAnalytics } from "./types";
+
+const defaultContext: IFormoAnalytics = {
+  chain: () => Promise.resolve(),
+  page: () => Promise.resolve(),
+  reset: () => Promise.resolve(),
+  detect: () => Promise.resolve(),
+  connect: () => Promise.resolve(),
+  disconnect: () => Promise.resolve(),
+  signature: () => Promise.resolve(),
+  transaction: () => Promise.resolve(),
+  identify: () => Promise.resolve(),
+  track: () => Promise.resolve(),
+};
+
+export const FormoAnalyticsContext =
+  createContext<IFormoAnalytics>(defaultContext);
+
+export const FormoAnalyticsProvider = (props: FormoAnalyticsProviderProps) => {
+  const { writeKey, disabled = false, children } = props;
+
+  // Keep the app running without analytics if no Write Key is provided or disabled
+  if (!writeKey) {
+    console.error("FormoAnalyticsProvider: No Write Key provided");
+    return children;
+  }
+
+  if (disabled) {
+    console.warn("FormoAnalytics is disabled");
+    return children;
+  }
+
+  return <InitializedAnalytics {...props} />;
+};
+
+const InitializedAnalytics = ({
+  writeKey,
+  options,
+  children,
+}: FormoAnalyticsProviderProps) => {
+  const [sdk, setSdk] = useState<IFormoAnalytics>(defaultContext);
+  const initializedStartedRef = useRef(false);
+  initStorageManager(writeKey);
+
+  const initializeFormoAnalytics = async (writeKey: string, options: any) => {
+    try {
+      const sdkInstance = await FormoAnalytics.init(writeKey, options);
+      setSdk(sdkInstance);
+      console.log("FormoAnalytics SDK initialized successfully");
+    } catch (error) {
+      console.error("Failed to initialize FormoAnalytics SDK", error);
+    }
+  };
+
+  useEffect(() => {
+    const initialize = async () => {
+      if (initializedStartedRef.current) return;
+      initializedStartedRef.current = true;
+
+      await initializeFormoAnalytics(writeKey!, options);
+    };
+
+    initialize();
+  }, [writeKey, options]);
+
+  return (
+    <FormoAnalyticsContext.Provider value={sdk}>
+      {children}
+    </FormoAnalyticsContext.Provider>
+  );
+};
+
+export const useFormo = () => {
+  const context = useContext(FormoAnalyticsContext);
+
+  if (!context) {
+    logger.warn("useFormo called without a valid context");
+  }
+
+  return context; // Return undefined if SDK is not initialized, handle accordingly in consumer
+};

package/src/constants/base.ts

@@ -0,0 +1,6 @@
+export const SESSION_TRAFFIC_SOURCE_KEY = "traffic-source";
+export const SESSION_WALLET_DETECTED_KEY = "wallet-detected";
+export const SESSION_CURRENT_URL_KEY = "analytics-current-url";
+export const SESSION_USER_ID_KEY = "user-id";
+
+export const LOCAL_ANONYMOUS_ID_KEY = "anonymous-id";