@formo/analytics-react-native 0.1.0

package/lib/commonjs/utils/hash.js

@@ -0,0 +1,30 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.generateUUID = generateUUID;
+exports.hash = hash;
+var _sha = require("ethereum-cryptography/sha256");
+var _utils = require("ethereum-cryptography/utils");
+/**
+ * Generate a SHA-256 hash for event deduplication
+ * Returns full 64 hex chars to match web SDK format
+ */
+async function hash(input) {
+  const bytes = (0, _utils.utf8ToBytes)(input);
+  const hashBytes = (0, _sha.sha256)(bytes);
+  return (0, _utils.bytesToHex)(hashBytes);
+}
+
+/**
+ * Generate a UUID v4
+ */
+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/commonjs/utils/hash.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_sha","require","_utils","hash","input","bytes","utf8ToBytes","hashBytes","sha256","bytesToHex","generateUUID","replace","c","r","Math","random","v","toString"],"sourceRoot":"../../../src","sources":["utils/hash.ts"],"mappings":";;;;;;;AAAA,IAAAA,IAAA,GAAAC,OAAA;AACA,IAAAC,MAAA,GAAAD,OAAA;AAEA;AACA;AACA;AACA;AACO,eAAeE,IAAIA,CAACC,KAAa,EAAmB;EACzD,MAAMC,KAAK,GAAG,IAAAC,kBAAW,EAACF,KAAK,CAAC;EAChC,MAAMG,SAAS,GAAG,IAAAC,WAAM,EAACH,KAAK,CAAC;EAC/B,OAAO,IAAAI,iBAAU,EAACF,SAAS,CAAC;AAC9B;;AAEA;AACA;AACA;AACO,SAASG,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":[]}

package/lib/commonjs/utils/helpers.js

@@ -0,0 +1,116 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.clampNumber = clampNumber;
+exports.getActionDescriptor = getActionDescriptor;
+exports.isNetworkError = isNetworkError;
+exports.isUndefined = isUndefined;
+exports.mergeDeepRight = mergeDeepRight;
+exports.toSnakeCase = toSnakeCase;
+/**
+ * Clamp a number between min and max values
+ */
+function clampNumber(value, max, min) {
+  return Math.min(Math.max(value, min), max);
+}
+
+/**
+ * Check if value is undefined
+ */
+function isUndefined(value) {
+  return value === undefined;
+}
+
+/**
+ * Convert a camelCase/PascalCase string to snake_case
+ * Handles consecutive uppercase letters (acronyms) correctly:
+ * - "userID" -> "user_id"
+ * - "XMLParser" -> "xml_parser"
+ * - "getHTTPResponse" -> "get_http_response"
+ */
+function camelToSnake(str) {
+  return str
+  // Insert underscore before sequences of uppercase followed by lowercase (e.g., "XMLParser" -> "XML_Parser")
+  .replace(/([A-Z]+)([A-Z][a-z])/g, "$1_$2")
+  // Insert underscore before single uppercase preceded by lowercase (e.g., "userID" -> "user_ID")
+  .replace(/([a-z\d])([A-Z])/g, "$1_$2").toLowerCase();
+}
+
+/**
+ * Check if value is a plain object (not Date, Map, Set, RegExp, etc.)
+ */
+function isPlainObject(value) {
+  if (value === null || typeof value !== "object") {
+    return false;
+  }
+  const proto = Object.getPrototypeOf(value);
+  return proto === Object.prototype || proto === null;
+}
+
+/**
+ * Convert object keys to snake_case (recursively handles nested objects and arrays)
+ * Preserves Date, Map, Set, RegExp, and other built-in objects unchanged
+ */
+function toSnakeCase(obj) {
+  const result = {};
+  for (const [key, value] of Object.entries(obj)) {
+    const snakeKey = camelToSnake(key);
+    if (Array.isArray(value)) {
+      // Recursively convert plain objects inside arrays
+      result[snakeKey] = value.map(item => isPlainObject(item) ? toSnakeCase(item) : item);
+    } else if (isPlainObject(value)) {
+      result[snakeKey] = toSnakeCase(value);
+    } else {
+      // Preserve Date, Map, Set, RegExp, and other built-in objects unchanged
+      result[snakeKey] = value;
+    }
+  }
+  return result;
+}
+
+/**
+ * Deep merge two objects
+ */
+function mergeDeepRight(target, source) {
+  const output = {
+    ...target
+  };
+  for (const key in source) {
+    if (Object.prototype.hasOwnProperty.call(source, key)) {
+      const sourceValue = source[key];
+      const targetValue = output[key];
+      if (sourceValue !== null && typeof sourceValue === "object" && !Array.isArray(sourceValue) && targetValue !== null && typeof targetValue === "object" && !Array.isArray(targetValue)) {
+        output[key] = mergeDeepRight(targetValue, sourceValue);
+      } else if (sourceValue !== undefined) {
+        output[key] = sourceValue;
+      }
+    }
+  }
+  return output;
+}
+
+/**
+ * Get action descriptor for logging
+ */
+function getActionDescriptor(type, properties) {
+  if (type === "track" && properties?.event) {
+    return `track:${properties.event}`;
+  }
+  if (type === "screen" && properties?.name) {
+    return `screen:${properties.name}`;
+  }
+  return type;
+}
+
+/**
+ * Check if error is a network error
+ */
+function isNetworkError(error) {
+  if (!error) return false;
+  const message = error instanceof Error ? error.message : String(error);
+  const networkErrorMessages = ["Network request failed", "Failed to fetch", "Network Error", "timeout", "ETIMEDOUT", "ECONNREFUSED", "ENOTFOUND"];
+  return networkErrorMessages.some(msg => message.toLowerCase().includes(msg.toLowerCase()));
+}
+//# sourceMappingURL=helpers.js.map

package/lib/commonjs/utils/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["clampNumber","value","max","min","Math","isUndefined","undefined","camelToSnake","str","replace","toLowerCase","isPlainObject","proto","Object","getPrototypeOf","prototype","toSnakeCase","obj","result","key","entries","snakeKey","Array","isArray","map","item","mergeDeepRight","target","source","output","hasOwnProperty","call","sourceValue","targetValue","getActionDescriptor","type","properties","event","name","isNetworkError","error","message","Error","String","networkErrorMessages","some","msg","includes"],"sourceRoot":"../../../src","sources":["utils/helpers.ts"],"mappings":"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","ignoreList":[]}

package/lib/commonjs/utils/index.js

@@ -0,0 +1,61 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+var _address = require("./address");
+Object.keys(_address).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _address[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _address[key];
+    }
+  });
+});
+var _hash = require("./hash");
+Object.keys(_hash).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _hash[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _hash[key];
+    }
+  });
+});
+var _timestamp = require("./timestamp");
+Object.keys(_timestamp).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _timestamp[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _timestamp[key];
+    }
+  });
+});
+var _helpers = require("./helpers");
+Object.keys(_helpers).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _helpers[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _helpers[key];
+    }
+  });
+});
+var _trafficSource = require("./trafficSource");
+Object.keys(_trafficSource).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _trafficSource[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _trafficSource[key];
+    }
+  });
+});
+//# sourceMappingURL=index.js.map

package/lib/commonjs/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_address","require","Object","keys","forEach","key","exports","defineProperty","enumerable","get","_hash","_timestamp","_helpers","_trafficSource"],"sourceRoot":"../../../src","sources":["utils/index.ts"],"mappings":";;;;;AAAA,IAAAA,QAAA,GAAAC,OAAA;AAAAC,MAAA,CAAAC,IAAA,CAAAH,QAAA,EAAAI,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAA,GAAA,IAAAC,OAAA,IAAAA,OAAA,CAAAD,GAAA,MAAAL,QAAA,CAAAK,GAAA;EAAAH,MAAA,CAAAK,cAAA,CAAAD,OAAA,EAAAD,GAAA;IAAAG,UAAA;IAAAC,GAAA,WAAAA,CAAA;MAAA,OAAAT,QAAA,CAAAK,GAAA;IAAA;EAAA;AAAA;AACA,IAAAK,KAAA,GAAAT,OAAA;AAAAC,MAAA,CAAAC,IAAA,CAAAO,KAAA,EAAAN,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAA,GAAA,IAAAC,OAAA,IAAAA,OAAA,CAAAD,GAAA,MAAAK,KAAA,CAAAL,GAAA;EAAAH,MAAA,CAAAK,cAAA,CAAAD,OAAA,EAAAD,GAAA;IAAAG,UAAA;IAAAC,GAAA,WAAAA,CAAA;MAAA,OAAAC,KAAA,CAAAL,GAAA;IAAA;EAAA;AAAA;AACA,IAAAM,UAAA,GAAAV,OAAA;AAAAC,MAAA,CAAAC,IAAA,CAAAQ,UAAA,EAAAP,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAA,GAAA,IAAAC,OAAA,IAAAA,OAAA,CAAAD,GAAA,MAAAM,UAAA,CAAAN,GAAA;EAAAH,MAAA,CAAAK,cAAA,CAAAD,OAAA,EAAAD,GAAA;IAAAG,UAAA;IAAAC,GAAA,WAAAA,CAAA;MAAA,OAAAE,UAAA,CAAAN,GAAA;IAAA;EAAA;AAAA;AACA,IAAAO,QAAA,GAAAX,OAAA;AAAAC,MAAA,CAAAC,IAAA,CAAAS,QAAA,EAAAR,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAA,GAAA,IAAAC,OAAA,IAAAA,OAAA,CAAAD,GAAA,MAAAO,QAAA,CAAAP,GAAA;EAAAH,MAAA,CAAAK,cAAA,CAAAD,OAAA,EAAAD,GAAA;IAAAG,UAAA;IAAAC,GAAA,WAAAA,CAAA;MAAA,OAAAG,QAAA,CAAAP,GAAA;IAAA;EAAA;AAAA;AACA,IAAAQ,cAAA,GAAAZ,OAAA;AAAAC,MAAA,CAAAC,IAAA,CAAAU,cAAA,EAAAT,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAA,GAAA,IAAAC,OAAA,IAAAA,OAAA,CAAAD,GAAA,MAAAQ,cAAA,CAAAR,GAAA;EAAAH,MAAA,CAAAK,cAAA,CAAAD,OAAA,EAAAD,GAAA;IAAAG,UAAA;IAAAC,GAAA,WAAAA,CAAA;MAAA,OAAAI,cAAA,CAAAR,GAAA;IAAA;EAAA;AAAA","ignoreList":[]}

package/lib/commonjs/utils/timestamp.js

@@ -0,0 +1,34 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.getCurrentTimeFormatted = getCurrentTimeFormatted;
+exports.millisecondsToSecond = millisecondsToSecond;
+exports.toDateHourMinute = toDateHourMinute;
+/**
+ * Get current time in ISO format
+ */
+function getCurrentTimeFormatted() {
+  return new Date().toISOString();
+}
+
+/**
+ * Format date to YYYY-MM-DD HH:mm format for hashing
+ */
+function toDateHourMinute(date) {
+  const year = date.getFullYear();
+  const month = String(date.getMonth() + 1).padStart(2, "0");
+  const day = String(date.getDate()).padStart(2, "0");
+  const hours = String(date.getHours()).padStart(2, "0");
+  const minutes = String(date.getMinutes()).padStart(2, "0");
+  return `${year}-${month}-${day} ${hours}:${minutes}`;
+}
+
+/**
+ * Convert milliseconds to seconds
+ */
+function millisecondsToSecond(ms) {
+  return Math.floor(ms / 1000);
+}
+//# sourceMappingURL=timestamp.js.map

package/lib/commonjs/utils/timestamp.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["getCurrentTimeFormatted","Date","toISOString","toDateHourMinute","date","year","getFullYear","month","String","getMonth","padStart","day","getDate","hours","getHours","minutes","getMinutes","millisecondsToSecond","ms","Math","floor"],"sourceRoot":"../../../src","sources":["utils/timestamp.ts"],"mappings":";;;;;;;;AAAA;AACA;AACA;AACO,SAASA,uBAAuBA,CAAA,EAAW;EAChD,OAAO,IAAIC,IAAI,CAAC,CAAC,CAACC,WAAW,CAAC,CAAC;AACjC;;AAEA;AACA;AACA;AACO,SAASC,gBAAgBA,CAACC,IAAU,EAAU;EACnD,MAAMC,IAAI,GAAGD,IAAI,CAACE,WAAW,CAAC,CAAC;EAC/B,MAAMC,KAAK,GAAGC,MAAM,CAACJ,IAAI,CAACK,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAACC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC;EAC1D,MAAMC,GAAG,GAAGH,MAAM,CAACJ,IAAI,CAACQ,OAAO,CAAC,CAAC,CAAC,CAACF,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC;EACnD,MAAMG,KAAK,GAAGL,MAAM,CAACJ,IAAI,CAACU,QAAQ,CAAC,CAAC,CAAC,CAACJ,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC;EACtD,MAAMK,OAAO,GAAGP,MAAM,CAACJ,IAAI,CAACY,UAAU,CAAC,CAAC,CAAC,CAACN,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC;EAC1D,OAAO,GAAGL,IAAI,IAAIE,KAAK,IAAII,GAAG,IAAIE,KAAK,IAAIE,OAAO,EAAE;AACtD;;AAEA;AACA;AACA;AACO,SAASE,oBAAoBA,CAACC,EAAU,EAAU;EACvD,OAAOC,IAAI,CAACC,KAAK,CAACF,EAAE,GAAG,IAAI,CAAC;AAC9B","ignoreList":[]}

package/lib/commonjs/utils/trafficSource.js

@@ -0,0 +1,147 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.clearTrafficSource = clearTrafficSource;
+exports.getStoredTrafficSource = getStoredTrafficSource;
+exports.mergeWithStoredTrafficSource = mergeWithStoredTrafficSource;
+exports.parseTrafficSource = parseTrafficSource;
+exports.storeTrafficSource = storeTrafficSource;
+var _logger = require("../lib/logger");
+var _storage = require("../lib/storage");
+var _constants = require("../constants");
+/**
+ * Traffic Source Utilities
+ * Parse UTM parameters and referral information from URLs
+ */
+
+/**
+ * Parse UTM parameters and referral info from URL
+ * Supports both web URLs (https://) and deep link URLs (myapp://)
+ */
+function parseTrafficSource(url, customRefParams, pathPattern) {
+  try {
+    // Handle deep link URLs that may not have standard URL format
+    let urlObj;
+    try {
+      urlObj = new URL(url);
+    } catch {
+      // If URL parsing fails, try to extract query string manually
+      const queryStart = url.indexOf("?");
+      if (queryStart === -1) {
+        return {
+          referrer: url
+        };
+      }
+
+      // Create a fake URL for parsing query params
+      urlObj = new URL(`http://localhost${url.substring(queryStart)}`);
+    }
+    const params = urlObj.searchParams;
+    const trafficSource = {};
+
+    // Extract UTM parameters
+    if (params.has("utm_source")) trafficSource.utm_source = params.get("utm_source");
+    if (params.has("utm_medium")) trafficSource.utm_medium = params.get("utm_medium");
+    if (params.has("utm_campaign")) trafficSource.utm_campaign = params.get("utm_campaign");
+    if (params.has("utm_term")) trafficSource.utm_term = params.get("utm_term");
+    if (params.has("utm_content")) trafficSource.utm_content = params.get("utm_content");
+
+    // Extract referral codes (check common parameter names + custom ones, deduplicated)
+    const defaultRefParams = ["ref", "referral", "refcode", "referrer_code"];
+    const refParams = customRefParams ? [...new Set([...defaultRefParams, ...customRefParams])] : defaultRefParams;
+    for (const param of refParams) {
+      if (params.has(param)) {
+        trafficSource.ref = params.get(param);
+        break;
+      }
+    }
+
+    // Extract referral code from URL path if pathPattern is provided
+    if (pathPattern && !trafficSource.ref) {
+      try {
+        const pathRegex = new RegExp(pathPattern);
+        const pathname = urlObj.pathname;
+        const match = pathname.match(pathRegex);
+        if (match && match[1]) {
+          trafficSource.ref = match[1];
+        }
+      } catch (e) {
+        _logger.logger.error("Error parsing pathPattern for referral:", e);
+      }
+    }
+
+    // Store the full URL as referrer
+    trafficSource.referrer = url;
+    return trafficSource;
+  } catch (error) {
+    _logger.logger.error("Error parsing traffic source from URL:", error);
+    return {
+      referrer: url
+    };
+  }
+}
+
+/**
+ * Store traffic source in session storage
+ * Only stores if we have actual UTM or ref data
+ */
+function storeTrafficSource(trafficSource) {
+  try {
+    // Check if we have meaningful data to store (not just referrer)
+    const hasData = trafficSource.utm_source || trafficSource.utm_medium || trafficSource.utm_campaign || trafficSource.utm_term || trafficSource.utm_content || trafficSource.ref;
+    if (hasData || trafficSource.referrer) {
+      (0, _storage.storage)().set(_constants.SESSION_TRAFFIC_SOURCE_KEY, JSON.stringify(trafficSource));
+      _logger.logger.debug("Stored traffic source:", trafficSource);
+    }
+  } catch (error) {
+    _logger.logger.error("Error storing traffic source:", error);
+  }
+}
+
+/**
+ * Get stored traffic source from session
+ * Returns undefined if no traffic source is stored
+ */
+function getStoredTrafficSource() {
+  try {
+    const stored = (0, _storage.storage)().get(_constants.SESSION_TRAFFIC_SOURCE_KEY);
+    if (stored && typeof stored === "string") {
+      return JSON.parse(stored);
+    }
+  } catch (error) {
+    _logger.logger.debug("Failed to get stored traffic source:", error);
+  }
+  return undefined;
+}
+
+/**
+ * Clear stored traffic source from session
+ */
+function clearTrafficSource() {
+  try {
+    (0, _storage.storage)().remove(_constants.SESSION_TRAFFIC_SOURCE_KEY);
+    _logger.logger.debug("Cleared traffic source from session");
+  } catch (error) {
+    _logger.logger.error("Error clearing traffic source:", error);
+  }
+}
+
+/**
+ * Merge stored traffic source with current context
+ * Stored traffic source is used as fallback - current context takes priority
+ */
+function mergeWithStoredTrafficSource(context) {
+  const stored = getStoredTrafficSource();
+  if (!stored) {
+    return context || {};
+  }
+
+  // Merge: stored values as base, context values override
+  return {
+    ...stored,
+    ...(context || {})
+  };
+}
+//# sourceMappingURL=trafficSource.js.map

package/lib/commonjs/utils/trafficSource.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_logger","require","_storage","_constants","parseTrafficSource","url","customRefParams","pathPattern","urlObj","URL","queryStart","indexOf","referrer","substring","params","searchParams","trafficSource","has","utm_source","get","utm_medium","utm_campaign","utm_term","utm_content","defaultRefParams","refParams","Set","param","ref","pathRegex","RegExp","pathname","match","e","logger","error","storeTrafficSource","hasData","storage","set","SESSION_TRAFFIC_SOURCE_KEY","JSON","stringify","debug","getStoredTrafficSource","stored","parse","undefined","clearTrafficSource","remove","mergeWithStoredTrafficSource","context"],"sourceRoot":"../../../src","sources":["utils/trafficSource.ts"],"mappings":"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","ignoreList":[]}

package/lib/commonjs/version.js

@@ -0,0 +1,10 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.version = void 0;
+// This file is auto-generated by scripts/update-version.js during npm version
+// Do not edit manually - it will be overwritten
+const version = exports.version = '0.1.0';
+//# sourceMappingURL=version.js.map

package/lib/commonjs/version.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["version","exports"],"sourceRoot":"../../src","sources":["version.ts"],"mappings":";;;;;;AAAA;AACA;AACO,MAAMA,OAAO,GAAAC,OAAA,CAAAD,OAAA,GAAG,OAAO","ignoreList":[]}