@formo/analytics-react-native 0.1.0

package/lib/module/lib/wagmi/WagmiEventHandler.js

@@ -0,0 +1,439 @@
+/**
+ * WagmiEventHandler for React Native
+ *
+ * Handles wallet event tracking by hooking into Wagmi v2's config.subscribe()
+ * and TanStack Query's MutationCache.
+ */
+
+import { SignatureStatus, TransactionStatus } from "../../types/events";
+import { logger } from "../logger";
+
+// Interface for FormoAnalytics to avoid circular dependency
+
+export class WagmiEventHandler {
+  unsubscribers = [];
+  trackingState = {
+    isProcessing: false
+  };
+  processedMutations = new Set();
+  pendingStatusChanges = [];
+  constructor(formoAnalytics, wagmiConfig, queryClient) {
+    this.formo = formoAnalytics;
+    this.wagmiConfig = wagmiConfig;
+    this.queryClient = queryClient;
+    logger.info("WagmiEventHandler: Initializing Wagmi integration");
+    this.setupConnectionListeners();
+    if (this.queryClient) {
+      this.setupMutationTracking();
+    } else {
+      logger.warn("WagmiEventHandler: QueryClient not provided, signature and transaction events will not be tracked");
+    }
+  }
+
+  /**
+   * Set up listeners for wallet connection, disconnection, and chain changes
+   */
+  setupConnectionListeners() {
+    logger.info("WagmiEventHandler: Setting up connection listeners");
+
+    // Subscribe to status changes
+    const statusUnsubscribe = this.wagmiConfig.subscribe(state => state.status, (status, prevStatus) => {
+      this.handleStatusChange(status, prevStatus);
+    });
+    this.unsubscribers.push(statusUnsubscribe);
+
+    // Subscribe to chain ID changes
+    const chainIdUnsubscribe = this.wagmiConfig.subscribe(state => state.chainId, (chainId, prevChainId) => {
+      this.handleChainChange(chainId, prevChainId);
+    });
+    this.unsubscribers.push(chainIdUnsubscribe);
+    logger.info("WagmiEventHandler: Connection listeners set up successfully");
+  }
+
+  // Maximum pending status changes to prevent unbounded queue growth
+  static MAX_PENDING_STATUS_CHANGES = 10;
+
+  /**
+   * Handle status changes (connect/disconnect)
+   */
+  async handleStatusChange(status, prevStatus) {
+    if (this.trackingState.isProcessing) {
+      // Limit queue size to prevent unbounded growth during rapid status changes
+      if (this.pendingStatusChanges.length >= WagmiEventHandler.MAX_PENDING_STATUS_CHANGES) {
+        logger.warn("WagmiEventHandler: Pending status change queue full, dropping oldest");
+        this.pendingStatusChanges.shift();
+      }
+      // Queue status change to process after current one completes
+      this.pendingStatusChanges.push({
+        status,
+        prevStatus
+      });
+      logger.debug("WagmiEventHandler: Queuing status change for later processing");
+      return;
+    }
+    this.trackingState.isProcessing = true;
+    try {
+      // Process current status change
+      await this.processStatusChange(status, prevStatus);
+
+      // Process pending status changes iteratively (inline, no recursion)
+      while (this.pendingStatusChanges.length > 0) {
+        const pending = this.pendingStatusChanges.shift();
+        await this.processStatusChange(pending.status, pending.prevStatus);
+      }
+    } finally {
+      this.trackingState.isProcessing = false;
+    }
+  }
+
+  /**
+   * Process a single status change (extracted for iterative processing)
+   */
+  async processStatusChange(status, prevStatus) {
+    try {
+      const state = this.getState();
+      const address = this.getConnectedAddress(state);
+      const chainId = state.chainId;
+      logger.info("WagmiEventHandler: Status changed", {
+        status,
+        prevStatus,
+        address,
+        chainId
+      });
+
+      // Handle disconnect
+      if (status === "disconnected" && prevStatus === "connected") {
+        if (this.formo.isAutocaptureEnabled("disconnect")) {
+          await this.formo.disconnect({
+            chainId: this.trackingState.lastChainId,
+            address: this.trackingState.lastAddress
+          });
+        }
+        this.trackingState.lastAddress = undefined;
+        this.trackingState.lastChainId = undefined;
+      }
+
+      // Handle connect
+      if (status === "connected" && prevStatus !== "connected") {
+        if (address && chainId !== undefined) {
+          this.trackingState.lastAddress = address;
+          this.trackingState.lastChainId = chainId;
+          if (this.formo.isAutocaptureEnabled("connect")) {
+            const connectorName = this.getConnectorName(state);
+            const connectorId = this.getConnectorId(state);
+            await this.formo.connect({
+              chainId,
+              address
+            }, {
+              ...(connectorName && {
+                providerName: connectorName
+              }),
+              // Connector ID is typically the rdns for EIP-6963 wallets
+              ...(connectorId && {
+                rdns: connectorId
+              })
+            });
+          }
+        }
+      }
+      this.trackingState.lastStatus = status;
+    } catch (error) {
+      logger.error("WagmiEventHandler: Error handling status change:", error);
+    }
+  }
+
+  /**
+   * Handle chain ID changes
+   */
+  async handleChainChange(chainId, prevChainId) {
+    // Skip if no change, chainId is undefined, or this is initial connection (prevChainId undefined)
+    if (chainId === prevChainId || chainId === undefined || prevChainId === undefined) {
+      return;
+    }
+    const state = this.getState();
+    if (state.status !== "connected") {
+      return;
+    }
+    const address = this.getConnectedAddress(state);
+    if (!address) {
+      logger.warn("WagmiEventHandler: Chain changed but no address found");
+      return;
+    }
+    logger.info("WagmiEventHandler: Chain changed", {
+      chainId,
+      prevChainId,
+      address
+    });
+    this.trackingState.lastChainId = chainId;
+    if (this.formo.isAutocaptureEnabled("chain")) {
+      try {
+        await this.formo.chain({
+          chainId,
+          address
+        });
+      } catch (error) {
+        logger.error("WagmiEventHandler: Error tracking chain change:", error);
+      }
+    }
+  }
+
+  /**
+   * Set up mutation tracking for signatures and transactions
+   */
+  setupMutationTracking() {
+    if (!this.queryClient) {
+      return;
+    }
+    logger.info("WagmiEventHandler: Setting up mutation tracking");
+    const mutationCache = this.queryClient.getMutationCache();
+    const unsubscribe = mutationCache.subscribe(event => {
+      this.handleMutationEvent(event);
+    });
+    this.unsubscribers.push(unsubscribe);
+    logger.info("WagmiEventHandler: Mutation tracking set up successfully");
+  }
+
+  /**
+   * Handle mutation cache events
+   */
+  handleMutationEvent(event) {
+    if (event.type !== "updated") {
+      return;
+    }
+    const mutation = event.mutation;
+    const mutationKey = mutation.options.mutationKey;
+    if (!mutationKey || mutationKey.length === 0) {
+      return;
+    }
+    const mutationType = mutationKey[0];
+    const state = mutation.state;
+    const mutationStateKey = `${mutation.mutationId}:${state.status}`;
+    if (this.processedMutations.has(mutationStateKey)) {
+      return;
+    }
+    this.processedMutations.add(mutationStateKey);
+    logger.debug("WagmiEventHandler: Mutation event", {
+      mutationType,
+      mutationId: mutation.mutationId,
+      status: state.status
+    });
+    if (mutationType === "signMessage" || mutationType === "signTypedData") {
+      this.handleSignatureMutation(mutationType, mutation);
+    }
+    if (mutationType === "sendTransaction" || mutationType === "writeContract") {
+      this.handleTransactionMutation(mutationType, mutation);
+    }
+
+    // Cleanup old mutations
+    if (this.processedMutations.size > 1000) {
+      const entries = Array.from(this.processedMutations);
+      for (let i = 0; i < 500; i++) {
+        const entry = entries[i];
+        if (entry) {
+          this.processedMutations.delete(entry);
+        }
+      }
+    }
+  }
+
+  /**
+   * Handle signature mutations
+   */
+  handleSignatureMutation(mutationType, mutation) {
+    if (!this.formo.isAutocaptureEnabled("signature")) {
+      return;
+    }
+    const state = mutation.state;
+    const variables = state.variables || {};
+    const chainId = this.trackingState.lastChainId;
+    const address = this.trackingState.lastAddress;
+    if (!address) {
+      logger.warn("WagmiEventHandler: Signature event but no address available");
+      return;
+    }
+    if (!chainId || chainId === 0) {
+      logger.warn("WagmiEventHandler: Signature event but no valid chainId available");
+      return;
+    }
+    try {
+      let status;
+      let signatureHash;
+      if (state.status === "pending") {
+        status = SignatureStatus.REQUESTED;
+      } else if (state.status === "success") {
+        status = SignatureStatus.CONFIRMED;
+        signatureHash = state.data;
+      } else if (state.status === "error") {
+        status = SignatureStatus.REJECTED;
+      } else {
+        return;
+      }
+      let message;
+      if (mutationType === "signMessage") {
+        message = variables.message || "";
+      } else {
+        message = JSON.stringify(variables.message || variables.types || {});
+      }
+      logger.info("WagmiEventHandler: Tracking signature event", {
+        status,
+        mutationType,
+        address,
+        chainId
+      });
+      this.formo.signature({
+        status,
+        chainId,
+        address,
+        message,
+        ...(signatureHash && {
+          signatureHash
+        })
+      }).catch(error => {
+        logger.error("WagmiEventHandler: Error tracking signature:", error);
+      });
+    } catch (error) {
+      logger.error("WagmiEventHandler: Error handling signature mutation:", error);
+    }
+  }
+
+  /**
+   * Handle transaction mutations
+   */
+  handleTransactionMutation(mutationType, mutation) {
+    if (!this.formo.isAutocaptureEnabled("transaction")) {
+      return;
+    }
+    const state = mutation.state;
+    const variables = state.variables || {};
+    const chainId = this.trackingState.lastChainId || variables.chainId;
+    // Only use variables.account as fallback, not variables.address which is the contract address
+    const address = this.trackingState.lastAddress || variables.account;
+    if (!address) {
+      logger.warn("WagmiEventHandler: Transaction event but no address available");
+      return;
+    }
+    if (!chainId || chainId === 0) {
+      logger.warn("WagmiEventHandler: Transaction event but no valid chainId available");
+      return;
+    }
+    try {
+      let status;
+      let transactionHash;
+      if (state.status === "pending") {
+        status = TransactionStatus.STARTED;
+      } else if (state.status === "success") {
+        status = TransactionStatus.BROADCASTED;
+        transactionHash = state.data;
+      } else if (state.status === "error") {
+        status = TransactionStatus.REJECTED;
+      } else {
+        return;
+      }
+      const data = variables.data;
+      const to = variables.to || variables.address;
+      const value = variables.value?.toString();
+      logger.info("WagmiEventHandler: Tracking transaction event", {
+        status,
+        mutationType,
+        address,
+        chainId,
+        transactionHash
+      });
+      this.formo.transaction({
+        status,
+        chainId,
+        address,
+        ...(data && {
+          data
+        }),
+        ...(to && {
+          to
+        }),
+        ...(value && {
+          value
+        }),
+        ...(transactionHash && {
+          transactionHash
+        })
+      }).catch(error => {
+        logger.error("WagmiEventHandler: Error tracking transaction:", error);
+      });
+    } catch (error) {
+      logger.error("WagmiEventHandler: Error handling transaction mutation:", error);
+    }
+  }
+
+  /**
+   * Get current Wagmi state
+   */
+  getState() {
+    if (typeof this.wagmiConfig.getState === "function") {
+      return this.wagmiConfig.getState();
+    }
+    if (this.wagmiConfig.state) {
+      return this.wagmiConfig.state;
+    }
+    logger.warn("WagmiEventHandler: Unable to get state from config, returning default state");
+    return {
+      status: "disconnected",
+      connections: new Map(),
+      current: undefined,
+      chainId: undefined
+    };
+  }
+
+  /**
+   * Get connected address from state
+   */
+  getConnectedAddress(state) {
+    if (!state.current) {
+      return undefined;
+    }
+    const connection = state.connections.get(state.current);
+    if (!connection || connection.accounts.length === 0) {
+      return undefined;
+    }
+    return connection.accounts[0];
+  }
+
+  /**
+   * Get connector name from state
+   */
+  getConnectorName(state) {
+    if (!state.current) {
+      return undefined;
+    }
+    const connection = state.connections.get(state.current);
+    return connection?.connector.name;
+  }
+
+  /**
+   * Get connector ID from state (typically the rdns for EIP-6963 wallets)
+   */
+  getConnectorId(state) {
+    if (!state.current) {
+      return undefined;
+    }
+    const connection = state.connections.get(state.current);
+    return connection?.connector.id;
+  }
+
+  /**
+   * Clean up subscriptions
+   */
+  cleanup() {
+    logger.info("WagmiEventHandler: Cleaning up subscriptions");
+    for (const unsubscribe of this.unsubscribers) {
+      try {
+        unsubscribe();
+      } catch (error) {
+        logger.error("WagmiEventHandler: Error during cleanup:", error);
+      }
+    }
+    this.unsubscribers = [];
+    this.processedMutations.clear();
+    this.pendingStatusChanges = [];
+    logger.info("WagmiEventHandler: Cleanup complete");
+  }
+}
+//# sourceMappingURL=WagmiEventHandler.js.map

package/lib/module/lib/wagmi/WagmiEventHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["SignatureStatus","TransactionStatus","logger","WagmiEventHandler","unsubscribers","trackingState","isProcessing","processedMutations","Set","pendingStatusChanges","constructor","formoAnalytics","wagmiConfig","queryClient","formo","info","setupConnectionListeners","setupMutationTracking","warn","statusUnsubscribe","subscribe","state","status","prevStatus","handleStatusChange","push","chainIdUnsubscribe","chainId","prevChainId","handleChainChange","MAX_PENDING_STATUS_CHANGES","length","shift","debug","processStatusChange","pending","getState","address","getConnectedAddress","isAutocaptureEnabled","disconnect","lastChainId","lastAddress","undefined","connectorName","getConnectorName","connectorId","getConnectorId","connect","providerName","rdns","lastStatus","error","chain","mutationCache","getMutationCache","unsubscribe","event","handleMutationEvent","type","mutation","mutationKey","options","mutationType","mutationStateKey","mutationId","has","add","handleSignatureMutation","handleTransactionMutation","size","entries","Array","from","i","entry","delete","variables","signatureHash","REQUESTED","CONFIRMED","data","REJECTED","message","JSON","stringify","types","signature","catch","account","transactionHash","STARTED","BROADCASTED","to","value","toString","transaction","connections","Map","current","connection","get","accounts","connector","name","id","cleanup","clear"],"sourceRoot":"../../../../src","sources":["lib/wagmi/WagmiEventHandler.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/lib/wagmi/index.js

@@ -0,0 +1,3 @@
+export * from "./WagmiEventHandler";
+export * from "./types";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":[],"sourceRoot":"../../../../src","sources":["lib/wagmi/index.ts"],"mappings":"AAAA,cAAc,qBAAqB;AACnC,cAAc,SAAS","ignoreList":[]}

package/lib/module/lib/wagmi/types.js

@@ -0,0 +1,2 @@
+
+//# sourceMappingURL=types.js.map

package/lib/module/lib/wagmi/types.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sourceRoot":"../../../../src","sources":["lib/wagmi/types.ts"],"mappings":"","ignoreList":[]}

package/lib/module/types/base.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=base.js.map

package/lib/module/types/base.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sourceRoot":"../../../src","sources":["types/base.ts"],"mappings":"","ignoreList":[]}

package/lib/module/types/events.js

@@ -0,0 +1,17 @@
+//#region Specific Event Types
+
+export let SignatureStatus = /*#__PURE__*/function (SignatureStatus) {
+  SignatureStatus["REQUESTED"] = "requested";
+  SignatureStatus["REJECTED"] = "rejected";
+  SignatureStatus["CONFIRMED"] = "confirmed";
+  return SignatureStatus;
+}({});
+export let TransactionStatus = /*#__PURE__*/function (TransactionStatus) {
+  TransactionStatus["STARTED"] = "started";
+  TransactionStatus["REJECTED"] = "rejected";
+  TransactionStatus["BROADCASTED"] = "broadcasted";
+  TransactionStatus["CONFIRMED"] = "confirmed";
+  TransactionStatus["REVERTED"] = "reverted";
+  return TransactionStatus;
+}({});
+//# sourceMappingURL=events.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["SignatureStatus","TransactionStatus"],"sourceRoot":"../../../src","sources":["types/events.ts"],"mappings":"AAyCA;;AAsFA,WAAYA,eAAe,0BAAfA,eAAe;EAAfA,eAAe;EAAfA,eAAe;EAAfA,eAAe;EAAA,OAAfA,eAAe;AAAA;AAM3B,WAAYC,iBAAiB,0BAAjBA,iBAAiB;EAAjBA,iBAAiB;EAAjBA,iBAAiB;EAAjBA,iBAAiB;EAAjBA,iBAAiB;EAAjBA,iBAAiB;EAAA,OAAjBA,iBAAiB;AAAA","ignoreList":[]}

package/lib/module/types/index.js

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

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

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

package/lib/module/utils/address.js

@@ -0,0 +1,74 @@
+/**
+ * Address validation and checksum utilities
+ *
+ * Uses ethereum-cryptography for proper EIP-55 checksum computation
+ */
+
+import { keccak256 } from "ethereum-cryptography/keccak.js";
+import { utf8ToBytes } from "ethereum-cryptography/utils.js";
+
+/**
+ * Convert Uint8Array to hex string
+ */
+function toHex(bytes) {
+  return Array.from(bytes).map(b => b.toString(16).padStart(2, "0")).join("");
+}
+
+/**
+ * Check if a string is a valid Ethereum address
+ */
+export function isValidAddress(address) {
+  if (!address) return false;
+  if (typeof address !== "string") return false;
+
+  // Check if it matches basic hex address format
+  return /^0x[a-fA-F0-9]{40}$/.test(address);
+}
+
+/**
+ * Convert address to EIP-55 checksum format
+ *
+ * Uses keccak256 from ethereum-cryptography for correct checksumming
+ * See: https://eips.ethereum.org/EIPS/eip-55
+ */
+export function toChecksumAddress(address) {
+  if (!isValidAddress(address)) {
+    return address;
+  }
+  const lowercaseAddress = address.toLowerCase().replace("0x", "");
+  const hash = toHex(keccak256(utf8ToBytes(lowercaseAddress)));
+  let checksumAddress = "0x";
+  for (let i = 0; i < lowercaseAddress.length; i++) {
+    const char = lowercaseAddress[i];
+    if (char && parseInt(hash[i] || "0", 16) >= 8) {
+      checksumAddress += char.toUpperCase();
+    } else {
+      checksumAddress += char;
+    }
+  }
+  return checksumAddress;
+}
+
+/**
+ * Get valid address or null
+ */
+export function getValidAddress(address) {
+  if (!address) return null;
+  const trimmed = typeof address === "string" ? address.trim() : address;
+  if (!isValidAddress(trimmed)) return null;
+  return trimmed;
+}
+
+/**
+ * Blocked addresses that should not emit events
+ * (zero address, dead address)
+ */
+const BLOCKED_ADDRESSES = new Set(["0x0000000000000000000000000000000000000000", "0x000000000000000000000000000000000000dead"]);
+
+/**
+ * Check if address is in blocked list
+ */
+export function isBlockedAddress(address) {
+  return BLOCKED_ADDRESSES.has(address.toLowerCase());
+}
+//# sourceMappingURL=address.js.map

package/lib/module/utils/address.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["keccak256","utf8ToBytes","toHex","bytes","Array","from","map","b","toString","padStart","join","isValidAddress","address","test","toChecksumAddress","lowercaseAddress","toLowerCase","replace","hash","checksumAddress","i","length","char","parseInt","toUpperCase","getValidAddress","trimmed","trim","BLOCKED_ADDRESSES","Set","isBlockedAddress","has"],"sourceRoot":"../../../src","sources":["utils/address.ts"],"mappings":"AAAA;AACA;AACA;AACA;AACA;;AAEA,SAASA,SAAS,QAAQ,iCAAiC;AAC3D,SAASC,WAAW,QAAQ,gCAAgC;;AAE5D;AACA;AACA;AACA,SAASC,KAAKA,CAACC,KAAiB,EAAU;EACxC,OAAOC,KAAK,CAACC,IAAI,CAACF,KAAK,CAAC,CACrBG,GAAG,CAAEC,CAAC,IAAKA,CAAC,CAACC,QAAQ,CAAC,EAAE,CAAC,CAACC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAC3CC,IAAI,CAAC,EAAE,CAAC;AACb;;AAEA;AACA;AACA;AACA,OAAO,SAASC,cAAcA,CAACC,OAAe,EAAW;EACvD,IAAI,CAACA,OAAO,EAAE,OAAO,KAAK;EAC1B,IAAI,OAAOA,OAAO,KAAK,QAAQ,EAAE,OAAO,KAAK;;EAE7C;EACA,OAAO,qBAAqB,CAACC,IAAI,CAACD,OAAO,CAAC;AAC5C;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASE,iBAAiBA,CAACF,OAAe,EAAU;EACzD,IAAI,CAACD,cAAc,CAACC,OAAO,CAAC,EAAE;IAC5B,OAAOA,OAAO;EAChB;EAEA,MAAMG,gBAAgB,GAAGH,OAAO,CAACI,WAAW,CAAC,CAAC,CAACC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;EAChE,MAAMC,IAAI,GAAGhB,KAAK,CAACF,SAAS,CAACC,WAAW,CAACc,gBAAgB,CAAC,CAAC,CAAC;EAE5D,IAAII,eAAe,GAAG,IAAI;EAE1B,KAAK,IAAIC,CAAC,GAAG,CAAC,EAAEA,CAAC,GAAGL,gBAAgB,CAACM,MAAM,EAAED,CAAC,EAAE,EAAE;IAChD,MAAME,IAAI,GAAGP,gBAAgB,CAACK,CAAC,CAAC;IAChC,IAAIE,IAAI,IAAIC,QAAQ,CAACL,IAAI,CAACE,CAAC,CAAC,IAAI,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE;MAC7CD,eAAe,IAAIG,IAAI,CAACE,WAAW,CAAC,CAAC;IACvC,CAAC,MAAM;MACLL,eAAe,IAAIG,IAAI;IACzB;EACF;EAEA,OAAOH,eAAe;AACxB;;AAEA;AACA;AACA;AACA,OAAO,SAASM,eAAeA,CAC7Bb,OAAkC,EACnB;EACf,IAAI,CAACA,OAAO,EAAE,OAAO,IAAI;EACzB,MAAMc,OAAO,GAAG,OAAOd,OAAO,KAAK,QAAQ,GAAGA,OAAO,CAACe,IAAI,CAAC,CAAC,GAAGf,OAAO;EACtE,IAAI,CAACD,cAAc,CAACe,OAAO,CAAC,EAAE,OAAO,IAAI;EACzC,OAAOA,OAAO;AAChB;;AAEA;AACA;AACA;AACA;AACA,MAAME,iBAAiB,GAAG,IAAIC,GAAG,CAAS,CACxC,4CAA4C,EAC5C,4CAA4C,CAC7C,CAAC;;AAEF;AACA;AACA;AACA,OAAO,SAASC,gBAAgBA,CAAClB,OAAe,EAAW;EACzD,OAAOgB,iBAAiB,CAACG,GAAG,CAACnB,OAAO,CAACI,WAAW,CAAC,CAAC,CAAC;AACrD","ignoreList":[]}

package/lib/module/utils/hash.js

@@ -0,0 +1,24 @@
+import { sha256 } from "ethereum-cryptography/sha256";
+import { utf8ToBytes, bytesToHex } from "ethereum-cryptography/utils";
+
+/**
+ * Generate a SHA-256 hash for event deduplication
+ * Returns full 64 hex chars to match web SDK format
+ */
+export async function hash(input) {
+  const bytes = utf8ToBytes(input);
+  const hashBytes = sha256(bytes);
+  return bytesToHex(hashBytes);
+}
+
+/**
+ * Generate a UUID v4
+ */
+export function generateUUID() {
+  return "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, c => {
+    const r = Math.random() * 16 | 0;
+    const v = c === "x" ? r : r & 0x3 | 0x8;
+    return v.toString(16);
+  });
+}
+//# sourceMappingURL=hash.js.map

package/lib/module/utils/hash.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["sha256","utf8ToBytes","bytesToHex","hash","input","bytes","hashBytes","generateUUID","replace","c","r","Math","random","v","toString"],"sourceRoot":"../../../src","sources":["utils/hash.ts"],"mappings":"AAAA,SAASA,MAAM,QAAQ,8BAA8B;AACrD,SAASC,WAAW,EAAEC,UAAU,QAAQ,6BAA6B;;AAErE;AACA;AACA;AACA;AACA,OAAO,eAAeC,IAAIA,CAACC,KAAa,EAAmB;EACzD,MAAMC,KAAK,GAAGJ,WAAW,CAACG,KAAK,CAAC;EAChC,MAAME,SAAS,GAAGN,MAAM,CAACK,KAAK,CAAC;EAC/B,OAAOH,UAAU,CAACI,SAAS,CAAC;AAC9B;;AAEA;AACA;AACA;AACA,OAAO,SAASC,YAAYA,CAAA,EAAW;EACrC,OAAO,sCAAsC,CAACC,OAAO,CAAC,OAAO,EAAGC,CAAC,IAAK;IACpE,MAAMC,CAAC,GAAIC,IAAI,CAACC,MAAM,CAAC,CAAC,GAAG,EAAE,GAAI,CAAC;IAClC,MAAMC,CAAC,GAAGJ,CAAC,KAAK,GAAG,GAAGC,CAAC,GAAIA,CAAC,GAAG,GAAG,GAAI,GAAG;IACzC,OAAOG,CAAC,CAACC,QAAQ,CAAC,EAAE,CAAC;EACvB,CAAC,CAAC;AACJ","ignoreList":[]}