@aranova/tracking-react 0.12.2 → 0.14.0

package/dist/index.mjs

@@ -7,6 +7,13 @@ import { useCallback, useEffect, useState } from "react";
 // ../tracking-core/src/consent.ts
 var CONSENT_STATE_KEY = "consent_state";
 var CONSENT_TIMESTAMP_KEY = "consent_timestamp";
+var grantedListeners = /* @__PURE__ */ new Set();
+function onConsentGranted(listener) {
+  grantedListeners.add(listener);
+  return () => {
+    grantedListeners.delete(listener);
+  };
+}
 function buildConsentPayload(state) {
   return {
     ad_storage: state,
@@ -17,21 +24,40 @@ function buildConsentPayload(state) {
 }
 function getConsentState() {
   if (typeof window === "undefined") return "pending";
-  const storedState = window.localStorage.getItem(CONSENT_STATE_KEY);
-  if (storedState === "granted" || storedState === "denied") return storedState;
+  try {
+    const storedState = window.localStorage.getItem(CONSENT_STATE_KEY);
+    if (storedState === "granted" || storedState === "denied") return storedState;
+  } catch {
+  }
   return "pending";
 }
 function setConsentState(state) {
   if (typeof window === "undefined") return;
-  window.localStorage.setItem(CONSENT_STATE_KEY, state);
-  window.localStorage.setItem(CONSENT_TIMESTAMP_KEY, (/* @__PURE__ */ new Date()).toISOString());
+  try {
+    window.localStorage.setItem(CONSENT_STATE_KEY, state);
+    window.localStorage.setItem(CONSENT_TIMESTAMP_KEY, (/* @__PURE__ */ new Date()).toISOString());
+  } catch {
+  }
   if (typeof window.gtag === "function")
     window.gtag("consent", "update", buildConsentPayload(state));
+  if (typeof window.fbq === "function")
+    window.fbq("consent", state === "granted" ? "grant" : "revoke");
+  if (state === "granted") {
+    for (const listener of grantedListeners) {
+      try {
+        listener();
+      } catch {
+      }
+    }
+  }
 }
 function resetConsent() {
   if (typeof window === "undefined") return;
-  window.localStorage.removeItem(CONSENT_STATE_KEY);
-  window.localStorage.removeItem(CONSENT_TIMESTAMP_KEY);
+  try {
+    window.localStorage.removeItem(CONSENT_STATE_KEY);
+    window.localStorage.removeItem(CONSENT_TIMESTAMP_KEY);
+  } catch {
+  }
 }
 function restoreStoredConsent() {
   const consentState = getConsentState();
@@ -39,45 +65,106 @@ function restoreStoredConsent() {
   return consentState;
 }
 
-// ../tracking-core/src/payloads.ts
-function createTrackingClientContext(surface, input = {}) {
+// ../tracking-core/src/tracking.ts
+var TRACKING_COOKIE_MAX_AGE_SECONDS = 7776e3;
+var TRACKING_PARAM_KEYS = [
+  "gclid",
+  "fbclid",
+  "utm_source",
+  "utm_medium",
+  "utm_campaign",
+  "utm_term",
+  "utm_content"
+];
+function createEmptyTrackingParams() {
   return {
-    surface,
-    sdk_version: input.sdkVersion ?? null,
-    package_name: input.packageName ?? null,
-    site_origin: input.siteOrigin ?? (typeof window === "undefined" ? null : window.location.origin),
-    page_title: input.pageTitle ?? (typeof document === "undefined" ? null : document.title || null),
-    referrer: input.referrer ?? (typeof document === "undefined" ? null : document.referrer || null),
-    environment: input.environment ?? "production",
-    active_gtag_ids: input.activeGtagIds ?? null
+    gclid: null,
+    fbclid: null,
+    utm_source: null,
+    utm_medium: null,
+    utm_campaign: null,
+    utm_term: null,
+    utm_content: null
   };
 }
-function createTrackingSessionUpsertPayload(trackingParams, input, context) {
-  return {
-    session_id: input.sessionId,
-    visitor_id: input.visitorId ?? null,
-    gclid: trackingParams.gclid,
-    fbclid: trackingParams.fbclid,
-    utm_source: trackingParams.utm_source,
-    utm_medium: trackingParams.utm_medium,
-    utm_campaign: trackingParams.utm_campaign,
-    utm_term: trackingParams.utm_term,
-    utm_content: trackingParams.utm_content,
-    first_page: input.firstPage ?? null,
-    consent_state: input.consentState ?? null,
-    context
-  };
+function normalizeTrackingCookieValue(value) {
+  return typeof value === "string" && value.length > 0 ? value : null;
 }
-function createTrackingEventCreatePayload(trackingParams, input, context) {
-  return {
-    session_id: input.sessionId,
-    event_type: input.eventType,
-    gclid: trackingParams.gclid,
-    fbclid: trackingParams.fbclid,
-    page_url: input.pageUrl ?? (typeof window === "undefined" ? null : window.location.href),
-    metadata: input.metadata ?? null,
-    context
-  };
+function getTrackingParamsFromCookieReader(readCookie) {
+  return TRACKING_PARAM_KEYS.reduce((params, key) => {
+    params[key] = normalizeTrackingCookieValue(readCookie(key));
+    return params;
+  }, createEmptyTrackingParams());
+}
+function getTrackingQueryValues(searchParams) {
+  return TRACKING_PARAM_KEYS.reduce((params, key) => {
+    const value = searchParams.get(key);
+    if (typeof value === "string" && value.trim().length > 0) {
+      params[key] = value;
+    }
+    return params;
+  }, {});
+}
+var FALLBACK_STORAGE_PREFIX = "_aranova_track_";
+function fallbackKey(name) {
+  return `${FALLBACK_STORAGE_PREFIX}${name}`;
+}
+function persistCookieValue(name, value, maxAgeSeconds = TRACKING_COOKIE_MAX_AGE_SECONDS) {
+  const encoded = encodeURIComponent(value);
+  if (typeof document !== "undefined") {
+    try {
+      document.cookie = `${name}=${encoded}; Max-Age=${maxAgeSeconds}; Path=/; SameSite=Lax`;
+    } catch {
+    }
+  }
+  if (typeof window !== "undefined") {
+    try {
+      window.localStorage.setItem(fallbackKey(name), encoded);
+    } catch {
+    }
+  }
+}
+function readCookieValue(name) {
+  if (typeof document !== "undefined") {
+    const cookies = document.cookie ? document.cookie.split("; ") : [];
+    const match = cookies.find((cookie) => cookie.startsWith(`${name}=`));
+    if (match) {
+      const [, rawValue = ""] = match.split("=");
+      return normalizeTrackingCookieValue(decodeURIComponent(rawValue));
+    }
+  }
+  if (typeof window !== "undefined") {
+    try {
+      const stored = window.localStorage.getItem(fallbackKey(name));
+      if (stored) return normalizeTrackingCookieValue(decodeURIComponent(stored));
+    } catch {
+    }
+  }
+  return null;
+}
+function getCookieValueFromDocument(key) {
+  return readCookieValue(key);
+}
+function setTrackingCookie(key, value, maxAgeSeconds = TRACKING_COOKIE_MAX_AGE_SECONDS) {
+  persistCookieValue(key, value, maxAgeSeconds);
+}
+function mergeTrackingParams(primary, fallback) {
+  return TRACKING_PARAM_KEYS.reduce((merged, key) => {
+    merged[key] = primary[key] ?? fallback[key];
+    return merged;
+  }, createEmptyTrackingParams());
+}
+function persistTrackingParamsFromSearchParams(searchParams, maxAgeSeconds = TRACKING_COOKIE_MAX_AGE_SECONDS) {
+  const trackingValues = getTrackingQueryValues(searchParams);
+  Object.entries(trackingValues).forEach(([key, value]) => {
+    setTrackingCookie(key, value, maxAgeSeconds);
+  });
+  return trackingValues;
+}
+function captureTrackingParamsFromLocation(url = typeof window === "undefined" ? "" : window.location.href, maxAgeSeconds = TRACKING_COOKIE_MAX_AGE_SECONDS) {
+  const resolvedUrl = typeof window === "undefined" ? new URL(url || "https://example.invalid") : new URL(url, window.location.origin);
+  persistTrackingParamsFromSearchParams(resolvedUrl.searchParams, maxAgeSeconds);
+  return getTrackingParamsFromCookieReader(getCookieValueFromDocument);
 }
 
 // ../tracking-core/src/gtag.ts
@@ -98,6 +185,24 @@ function ensureGtagFunction() {
   };
   return window.gtag;
 }
+var SEND_TO_RE = /^AW-[A-Za-z0-9]+\/[A-Za-z0-9_-]+$/;
+function isValidSendTo(sendTo) {
+  return SEND_TO_RE.test(sendTo);
+}
+function fireGtagConversion(input) {
+  if (typeof window === "undefined" || typeof window.gtag !== "function") return false;
+  if (!isValidSendTo(input.sendTo)) return false;
+  const params = { send_to: input.sendTo };
+  if (input.value != null) params.value = input.value;
+  if (input.currency) params.currency = input.currency;
+  if (input.transactionId) params.transaction_id = input.transactionId;
+  try {
+    window.gtag("event", "conversion", params);
+    return true;
+  } catch {
+    return false;
+  }
+}
 function applyDefaultConsentState() {
   const gtag = ensureGtagFunction();
   gtag("consent", "default", {
@@ -150,70 +255,441 @@ function bootstrapMultipleGtags(gtagIds) {
   restoreStoredConsent();
 }
 
-// ../tracking-core/src/tracking.ts
-var TRACKING_COOKIE_MAX_AGE_SECONDS = 7776e3;
-var TRACKING_PARAM_KEYS = [
-  "gclid",
-  "fbclid",
-  "utm_source",
-  "utm_medium",
-  "utm_campaign",
-  "utm_term",
-  "utm_content"
-];
-function createEmptyTrackingParams() {
+// ../tracking-core/src/fbq.ts
+var FB_EVENTS_SCRIPT_HOST = "https://connect.facebook.net/en_US/fbevents.js";
+var FBC_COOKIE = "_fbc";
+var FBP_COOKIE = "_fbp";
+var META_PIXEL_ID_PATTERN = /^\d{15,16}$/;
+function isValidMetaPixelId(id) {
+  return META_PIXEL_ID_PATTERN.test(id);
+}
+function computeFbSubdomainIndex(hostname) {
+  const labels = hostname.split(".").filter(Boolean);
+  return Math.max(0, labels.length - 1);
+}
+function buildFbc(fbclid, now, hostname) {
+  const host = hostname ?? (typeof window === "undefined" ? "" : window.location.hostname);
+  return `fb.${computeFbSubdomainIndex(host)}.${now}.${fbclid}`;
+}
+function getFbcCookie() {
+  return readCookieValue(FBC_COOKIE);
+}
+function getFbpCookie() {
+  return readCookieValue(FBP_COOKIE);
+}
+function readFbclidFromUrl() {
+  if (typeof window === "undefined") return null;
+  try {
+    const value = new URL(window.location.href).searchParams.get("fbclid");
+    return value && value.trim().length > 0 ? value : null;
+  } catch {
+    return null;
+  }
+}
+function captureFbc(now = typeof Date === "undefined" ? 0 : Date.now()) {
+  if (typeof window === "undefined") return;
+  if (getFbcCookie()) return;
+  const fbclid = readFbclidFromUrl() ?? readCookieValue("fbclid");
+  if (!fbclid) return;
+  persistCookieValue(FBC_COOKIE, buildFbc(fbclid, now), TRACKING_COOKIE_MAX_AGE_SECONDS);
+}
+function getScriptMarker2(id) {
+  return `aranova-${id}`;
+}
+function ensureFbqFunction() {
+  const w = window;
+  if (typeof w.fbq === "function") return w.fbq;
+  const fbq = function(...args) {
+    if (fbq.callMethod) fbq.callMethod.apply(fbq, args);
+    else fbq.queue.push(args);
+  };
+  fbq.push = fbq;
+  fbq.loaded = true;
+  fbq.version = "2.0";
+  fbq.queue = [];
+  w.fbq = fbq;
+  if (!w._fbq) w._fbq = fbq;
+  return fbq;
+}
+function applyDefaultMetaConsentState() {
+  ensureFbqFunction()("consent", "revoke");
+}
+function loadFbeventsScript() {
+  if (typeof document === "undefined") return;
+  const marker = getScriptMarker2("fbq-loader");
+  const existing = document.querySelector(
+    `script[${TRACKING_SCRIPT_ATTRIBUTE}="${marker}"]`
+  );
+  if (existing) return;
+  const script = document.createElement("script");
+  script.async = true;
+  script.src = FB_EVENTS_SCRIPT_HOST;
+  script.setAttribute(TRACKING_SCRIPT_ATTRIBUTE, marker);
+  document.head.append(script);
+}
+function initializeMetaPixel(pixelId) {
+  const fbq = ensureFbqFunction();
+  fbq("init", pixelId);
+  fbq("track", "PageView");
+}
+function restoreMetaConsentState() {
+  if (typeof window === "undefined") return;
+  const state = getConsentState();
+  if (state === "granted") window.fbq?.("consent", "grant");
+  else if (state === "denied") window.fbq?.("consent", "revoke");
+}
+function bootstrapMetaPixel(pixelId) {
+  if (typeof window === "undefined" || typeof document === "undefined") return;
+  if (!isValidMetaPixelId(pixelId)) return;
+  applyDefaultMetaConsentState();
+  loadFbeventsScript();
+  initializeMetaPixel(pixelId);
+  restoreMetaConsentState();
+  captureFbc();
+}
+function bootstrapMultiplePixels(pixelIds) {
+  if (typeof window === "undefined" || typeof document === "undefined") return;
+  const ids = Object.values(pixelIds).filter(
+    (id) => typeof id === "string" && isValidMetaPixelId(id)
+  );
+  if (ids.length === 0) return;
+  applyDefaultMetaConsentState();
+  loadFbeventsScript();
+  const fbq = ensureFbqFunction();
+  for (const id of ids) {
+    fbq("init", id);
+  }
+  fbq("track", "PageView");
+  restoreMetaConsentState();
+  captureFbc();
+}
+
+// ../tracking-core/src/payloads.ts
+function createTrackingClientContext(surface, input = {}) {
   return {
-    gclid: null,
-    fbclid: null,
-    utm_source: null,
-    utm_medium: null,
-    utm_campaign: null,
-    utm_term: null,
-    utm_content: null
+    surface,
+    sdk_version: input.sdkVersion ?? null,
+    package_name: input.packageName ?? null,
+    site_origin: input.siteOrigin ?? (typeof window === "undefined" ? null : window.location.origin),
+    page_title: input.pageTitle ?? (typeof document === "undefined" ? null : document.title || null),
+    referrer: input.referrer ?? (typeof document === "undefined" ? null : document.referrer || null),
+    environment: input.environment ?? "production",
+    active_gtag_ids: input.activeGtagIds ?? null
   };
 }
-function normalizeTrackingCookieValue(value) {
-  return typeof value === "string" && value.length > 0 ? value : null;
+function createTrackingSessionUpsertPayload(trackingParams, input, context) {
+  return {
+    session_id: input.sessionId,
+    visitor_id: input.visitorId ?? null,
+    gclid: trackingParams.gclid,
+    fbclid: trackingParams.fbclid,
+    fbc: getFbcCookie(),
+    fbp: getFbpCookie(),
+    utm_source: trackingParams.utm_source,
+    utm_medium: trackingParams.utm_medium,
+    utm_campaign: trackingParams.utm_campaign,
+    utm_term: trackingParams.utm_term,
+    utm_content: trackingParams.utm_content,
+    first_page: input.firstPage ?? null,
+    consent_state: input.consentState ?? null,
+    context
+  };
 }
-function getTrackingParamsFromCookieReader(readCookie) {
-  return TRACKING_PARAM_KEYS.reduce((params, key) => {
-    params[key] = normalizeTrackingCookieValue(readCookie(key));
-    return params;
-  }, createEmptyTrackingParams());
+function createTrackingEventCreatePayload(trackingParams, input, context) {
+  return {
+    session_id: input.sessionId,
+    event_type: input.eventType,
+    gclid: trackingParams.gclid,
+    fbclid: trackingParams.fbclid,
+    fbc: getFbcCookie(),
+    fbp: getFbpCookie(),
+    page_url: input.pageUrl ?? (typeof window === "undefined" ? null : window.location.href),
+    metadata: input.metadata ?? null,
+    context
+  };
 }
-function getTrackingQueryValues(searchParams) {
-  return TRACKING_PARAM_KEYS.reduce((params, key) => {
-    const value = searchParams.get(key);
-    if (typeof value === "string" && value.trim().length > 0) {
-      params[key] = value;
-    }
-    return params;
-  }, {});
+
+// ../tracking-core/src/resources/conversion-firing.ts
+var DEDUP_PREFIX = "_aranova_conv_";
+var MAX_PENDING = 100;
+var pendingQueue = [];
+function dedupKey(input) {
+  return `${DEDUP_PREFIX}${input.transactionId ?? ""}:${input.sendTo}`;
+}
+function alreadyFired(input) {
+  if (!input.transactionId || typeof window === "undefined") return false;
+  try {
+    return window.sessionStorage.getItem(dedupKey(input)) !== null;
+  } catch {
+    return false;
+  }
 }
-function getCookieValueFromDocument(key) {
-  if (typeof document === "undefined") return null;
-  const cookies = document.cookie ? document.cookie.split("; ") : [];
-  const match = cookies.find((cookie) => cookie.startsWith(`${key}=`));
-  if (!match) return null;
-  const [, rawValue = ""] = match.split("=");
-  return normalizeTrackingCookieValue(decodeURIComponent(rawValue));
+function markFired(input) {
+  if (!input.transactionId || typeof window === "undefined") return;
+  try {
+    window.sessionStorage.setItem(dedupKey(input), "1");
+  } catch {
+  }
 }
-function setTrackingCookie(key, value, maxAgeSeconds = TRACKING_COOKIE_MAX_AGE_SECONDS) {
-  if (typeof document === "undefined") return;
-  const encodedValue = encodeURIComponent(value);
-  document.cookie = `${key}=${encodedValue}; Max-Age=${maxAgeSeconds}; Path=/; SameSite=Lax`;
+function fireOnce(input) {
+  if (alreadyFired(input)) return;
+  if (fireGtagConversion(input)) markFired(input);
 }
-function persistTrackingParamsFromSearchParams(searchParams, maxAgeSeconds = TRACKING_COOKIE_MAX_AGE_SECONDS) {
-  const trackingValues = getTrackingQueryValues(searchParams);
-  Object.entries(trackingValues).forEach(([key, value]) => {
-    setTrackingCookie(key, value, maxAgeSeconds);
+function fireConversionWithConsent(input) {
+  const state = getConsentState();
+  if (state === "denied") return;
+  if (state === "pending") {
+    if (pendingQueue.length >= MAX_PENDING) pendingQueue.shift();
+    pendingQueue.push(input);
+    return;
+  }
+  fireOnce(input);
+}
+function flushPendingConversions() {
+  if (getConsentState() !== "granted") return;
+  while (pendingQueue.length > 0) {
+    const input = pendingQueue.shift();
+    if (input) fireOnce(input);
+  }
+}
+if (typeof window !== "undefined") onConsentGranted(flushPendingConversions);
+
+// ../tracking-core/src/resources/conversion-config.ts
+function isStringMap(value) {
+  return typeof value === "object" && value !== null && Object.values(value).every((v) => typeof v === "string");
+}
+function parseFiring(value) {
+  if (!value || typeof value !== "object") return null;
+  const f = value;
+  if (typeof f.send_to !== "string") return null;
+  return {
+    send_to: f.send_to,
+    value_cents: typeof f.value_cents === "number" ? f.value_cents : null,
+    currency: typeof f.currency === "string" ? f.currency : null
+  };
+}
+function parseTrigger(value) {
+  if (!value || typeof value !== "object") return null;
+  const t = value;
+  if (typeof t.event_type !== "string") return null;
+  const spec = { event_type: t.event_type };
+  if (typeof t.threshold_percent === "number") spec.threshold_percent = t.threshold_percent;
+  if (typeof t.threshold_seconds === "number") spec.threshold_seconds = t.threshold_seconds;
+  if (typeof t.page_threshold === "number") spec.page_threshold = t.page_threshold;
+  if (typeof t.page_name === "string") spec.page_name = t.page_name;
+  return spec;
+}
+function parseConversionConfig(raw) {
+  if (!raw || typeof raw !== "object") return null;
+  const obj = raw;
+  const servicesRaw = Array.isArray(obj.services) ? obj.services : [];
+  const services = servicesRaw.flatMap((entry) => {
+    if (!entry || typeof entry !== "object") return [];
+    const s = entry;
+    if (typeof s.key !== "string") return [];
+    return [
+      {
+        key: s.key,
+        label: typeof s.label === "string" ? s.label : void 0,
+        firing: parseFiring(s.firing)
+      }
+    ];
   });
-  return trackingValues;
+  const goalsRaw = Array.isArray(obj.goals) ? obj.goals : null;
+  const goals = goalsRaw ? goalsRaw.flatMap((entry) => {
+    if (!entry || typeof entry !== "object") return [];
+    const g = entry;
+    if (typeof g.key !== "string") return [];
+    return [
+      {
+        key: g.key,
+        label: typeof g.label === "string" ? g.label : void 0,
+        kind: g.kind === "event" ? "event" : "sale",
+        trigger: parseTrigger(g.trigger),
+        firing: parseFiring(g.firing)
+      }
+    ];
+  }) : services.map((s) => ({
+    key: s.key,
+    label: s.label,
+    kind: "sale",
+    trigger: null,
+    firing: s.firing
+  }));
+  return {
+    schema_version: typeof obj.schema_version === "number" ? obj.schema_version : 1,
+    config_version: typeof obj.config_version === "number" ? obj.config_version : 0,
+    business_id: typeof obj.business_id === "string" ? obj.business_id : void 0,
+    customer_id: typeof obj.customer_id === "string" ? obj.customer_id : null,
+    environment: typeof obj.environment === "string" ? obj.environment : void 0,
+    gtag_ids: isStringMap(obj.gtag_ids) ? obj.gtag_ids : {},
+    meta_pixel_ids: isStringMap(obj.meta_pixel_ids) ? obj.meta_pixel_ids : {},
+    services,
+    goals
+  };
 }
-function captureTrackingParamsFromLocation(url = typeof window === "undefined" ? "" : window.location.href, maxAgeSeconds = TRACKING_COOKIE_MAX_AGE_SECONDS) {
-  const resolvedUrl = typeof window === "undefined" ? new URL(url || "https://example.invalid") : new URL(url, window.location.origin);
-  persistTrackingParamsFromSearchParams(resolvedUrl.searchParams, maxAgeSeconds);
-  return getTrackingParamsFromCookieReader(getCookieValueFromDocument);
+var CACHE_PREFIX = "_aranova_cfg_";
+function cacheKey(url) {
+  return `${CACHE_PREFIX}${url}`;
+}
+function readCache(url) {
+  if (typeof window === "undefined") return null;
+  try {
+    const raw = window.sessionStorage.getItem(cacheKey(url));
+    if (!raw) return null;
+    const parsed = JSON.parse(raw);
+    const config = parseConversionConfig(parsed.config);
+    if (!config) return null;
+    return {
+      etag: typeof parsed.etag === "string" ? parsed.etag : null,
+      config
+    };
+  } catch {
+    return null;
+  }
+}
+function writeCache(url, entry) {
+  if (typeof window === "undefined") return;
+  try {
+    window.sessionStorage.setItem(cacheKey(url), JSON.stringify(entry));
+  } catch {
+  }
+}
+function resolveConversionConfig(options) {
+  const cached = readCache(options.cdnUrl);
+  let current = cached?.config ?? options.baked ?? null;
+  let etag = cached?.etag ?? null;
+  const goalsByKey = /* @__PURE__ */ new Map();
+  function rebuildIndex() {
+    goalsByKey.clear();
+    for (const goal of current?.goals ?? []) {
+      goalsByKey.set(goal.key, goal);
+    }
+  }
+  function adopt(next, nextEtag) {
+    if (!next) return;
+    if (current && next.config_version <= current.config_version) return;
+    current = next;
+    etag = nextEtag;
+    rebuildIndex();
+    writeCache(options.cdnUrl, { etag, config: next });
+  }
+  async function revalidate() {
+    if (typeof window === "undefined") return;
+    try {
+      const doFetch = options.fetchImpl ?? globalThis.fetch;
+      if (!doFetch) return;
+      const headers = {};
+      if (etag) headers["If-None-Match"] = etag;
+      const response = await doFetch(options.cdnUrl, {
+        method: "GET",
+        headers
+      });
+      if (response.status === 304 || !response.ok) return;
+      adopt(parseConversionConfig(await response.json()), response.headers.get("ETag"));
+    } catch {
+    }
+  }
+  rebuildIndex();
+  void revalidate();
+  return {
+    getFiring: (key) => goalsByKey.get(key)?.firing ?? null,
+    getGoal: (key) => goalsByKey.get(key) ?? null,
+    listGoals: () => [...goalsByKey.values()],
+    current: () => current,
+    revalidate
+  };
+}
+
+// ../tracking-core/src/resources/sales/money.ts
+var MINOR_UNIT_EXPONENT = {
+  USD: 2,
+  CAD: 2
+};
+function exponentFor(currency) {
+  return MINOR_UNIT_EXPONENT[currency] ?? 2;
+}
+function toMinor(amount, currency) {
+  return Math.round(amount * 10 ** exponentFor(currency));
+}
+function fromMinor(cents, currency) {
+  return cents / 10 ** exponentFor(currency);
+}
+function formatMoney(cents, currency, locale) {
+  return new Intl.NumberFormat(locale, { style: "currency", currency }).format(
+    fromMinor(cents, currency)
+  );
+}
+function formatDateInTz(iso, timeZone, opts, locale) {
+  const date = new Date(iso);
+  if (Number.isNaN(date.getTime())) return iso;
+  return new Intl.DateTimeFormat(locale, {
+    year: "numeric",
+    month: "short",
+    day: "2-digit",
+    hour: "2-digit",
+    minute: "2-digit",
+    ...opts,
+    timeZone
+  }).format(date);
+}
+
+// ../tracking-core/src/resources/conversion-autofire.ts
+function thresholdMet(goal, eventType, metadata) {
+  const t = goal.trigger;
+  if (!t || t.event_type !== eventType) return false;
+  switch (eventType) {
+    case "scroll_depth":
+      return typeof metadata.depth_percent === "number" && t.threshold_percent != null && metadata.depth_percent >= t.threshold_percent;
+    case "time_on_site":
+      return typeof metadata.duration_ms === "number" && t.threshold_seconds != null && metadata.duration_ms >= t.threshold_seconds * 1e3;
+    case "multi_page_session":
+      return typeof metadata.page_count === "number" && t.page_threshold != null && metadata.page_count >= t.page_threshold;
+    case "specific_page_visit":
+      return typeof metadata.page_name === "string" && metadata.page_name === t.page_name;
+    case "page_view":
+    case "form_start":
+      return true;
+    // no threshold — fire whenever the detector emits
+    default:
+      return false;
+  }
+}
+function currentPath() {
+  return typeof window === "undefined" ? "" : window.location.pathname;
+}
+function createConversionAutoFire(store) {
+  return {
+    onAutomaticEvent(eventType, metadata) {
+      for (const goal of store.listGoals()) {
+        if (goal.kind !== "event" || !goal.firing) continue;
+        if (!thresholdMet(goal, eventType, metadata)) continue;
+        const firing = goal.firing;
+        const cents = firing.value_cents ?? null;
+        const currency = firing.currency ?? null;
+        fireConversionWithConsent({
+          sendTo: firing.send_to,
+          value: cents != null && currency ? fromMinor(cents, currency) : null,
+          currency,
+          // Page-scoped txn id → fire once per (goal, path) per session; engagement conversions
+          // shouldn't re-fire as the visitor scrolls back and forth or re-enters a page.
+          transactionId: `auto:${goal.key}:${currentPath()}`
+        });
+      }
+    }
+  };
+}
+function withConversionAutoFire(client, autoFire) {
+  return {
+    ...client,
+    trackEvent: (input) => {
+      client.trackEvent(input);
+      try {
+        autoFire.onAutomaticEvent(input.eventType, input.metadata ?? {});
+      } catch {
+      }
+    }
+  };
 }
 
 // ../tracking-core/src/session.ts
@@ -544,11 +1020,22 @@ function createTrackingClient(config) {
   let queue = [];
   let flushTimer = null;
   let firstPage = null;
+  let initialParams = createEmptyTrackingParams();
   let destroyed = false;
   const visitorId = getVisitorId();
   const initialSession = getOrRotateSessionId();
   let sessionId = initialSession.id;
-  if (typeof window !== "undefined") firstPage = window.location.href;
+  if (typeof window !== "undefined") {
+    firstPage = window.location.href;
+    try {
+      initialParams = captureTrackingParamsFromLocation();
+    } catch {
+    }
+    try {
+      captureFbc();
+    } catch {
+    }
+  }
   function enqueueHeartbeat() {
     const metadata = buildHeartbeatMetadata(
       config.surface,
@@ -573,7 +1060,7 @@ function createTrackingClient(config) {
       enqueueHeartbeat();
     }
     sessionId = rotated.id;
-    const params = readTrackingParams();
+    const params = mergeTrackingParams(readTrackingParams(), initialParams);
     const context = buildContext(
       config.surface,
       sdkVersion,
@@ -586,6 +1073,8 @@ function createTrackingClient(config) {
       visitor_id: visitorId,
       gclid: params.gclid,
       fbclid: params.fbclid,
+      fbc: getFbcCookie(),
+      fbp: getFbpCookie(),
       utm_source: params.utm_source,
       utm_medium: params.utm_medium,
       utm_campaign: params.utm_campaign,
@@ -1022,7 +1511,7 @@ function attachScrollDepth(client, config) {
   }
   const thresholds = new Set(config.thresholds);
   let firedForPath = /* @__PURE__ */ new Set();
-  let currentPath = window.location.pathname;
+  let currentPath2 = window.location.pathname;
   let rafId = null;
   function getScrollPercent() {
     const doc = document.documentElement;
@@ -1041,7 +1530,7 @@ function attachScrollDepth(client, config) {
           eventType: "scroll_depth",
           metadata: {
             depth_percent: threshold,
-            page: { path: currentPath }
+            page: { path: currentPath2 }
           },
           pageUrl: window.location.href,
           occurredAt: null
@@ -1058,8 +1547,8 @@ function attachScrollDepth(client, config) {
   }
   function resetIfPathChanged() {
     const newPath = window.location.pathname;
-    if (newPath === currentPath) return;
-    currentPath = newPath;
+    if (newPath === currentPath2) return;
+    currentPath2 = newPath;
     firedForPath = /* @__PURE__ */ new Set();
     setTimeout(checkThresholds, 0);
   }
@@ -1135,13 +1624,13 @@ function attachMultiPageSession(client, config) {
     return storage.getItem(FIRED_KEY) === "1";
   }
   function check() {
-    const currentPath = window.location.pathname;
-    if (currentPath === lastCheckedPath) return;
-    lastCheckedPath = currentPath;
+    const currentPath2 = window.location.pathname;
+    if (currentPath2 === lastCheckedPath) return;
+    lastCheckedPath = currentPath2;
     resetIfSessionChanged();
     if (hasFired()) return;
     const paths = getDistinctPaths();
-    paths.add(currentPath);
+    paths.add(currentPath2);
     saveDistinctPaths(paths);
     if (paths.size >= pageThreshold) {
       storage.setItem(FIRED_KEY, "1");
@@ -1185,7 +1674,7 @@ function attachFormStart(client, config) {
   }
   const selector = config.selector ?? "form";
   let firedForms = /* @__PURE__ */ new Set();
-  let currentPath = window.location.pathname;
+  let currentPath2 = window.location.pathname;
   function getFormKey(form) {
     if (form.id) return `id:${form.id}`;
     const explicitAction = form.getAttribute("action");
@@ -1216,8 +1705,8 @@ function attachFormStart(client, config) {
   }
   function resetIfPathChanged() {
     const newPath = window.location.pathname;
-    if (newPath === currentPath) return;
-    currentPath = newPath;
+    if (newPath === currentPath2) return;
+    currentPath2 = newPath;
     firedForms = /* @__PURE__ */ new Set();
   }
   const originalPushState = history.pushState.bind(history);
@@ -1296,21 +1785,64 @@ async function salesRequest(config, method, path, body) {
 }
 
 // ../tracking-core/src/resources/sales/client.ts
+function fireRecordedConversions(firing, input, recorded, sale, currency) {
+  if (!firing) return;
+  const txnBase = input.external_id ?? sale.id;
+  for (const item of recorded) {
+    if (!item.service) continue;
+    const config = firing.getFiring(item.service);
+    if (!config) continue;
+    const cents = item.amount_cents ?? config.value_cents ?? null;
+    fireConversionWithConsent({
+      sendTo: config.send_to,
+      value: cents != null ? fromMinor(cents, currency) : null,
+      currency: config.currency ?? currency,
+      transactionId: `${txnBase}:${item.service}`
+    });
+  }
+}
 function createSalesClient(config) {
-  return {
-    async record(input) {
-      const currency = input.currency ?? config.defaultCurrency;
-      if (!currency) {
-        throw new Error(
-          "record: `currency` is required (pass it on the sale or set config.defaultCurrency)"
-        );
+  async function record(input) {
+    const currency = input.currency ?? config.defaultCurrency;
+    if (!currency) {
+      throw new Error(
+        "record: `currency` is required (pass it on the sale or set config.defaultCurrency)"
+      );
+    }
+    const body = {
+      ...input,
+      currency,
+      occurred_at: input.occurred_at ?? (/* @__PURE__ */ new Date()).toISOString()
+    };
+    const sale = await salesRequest(config, "POST", "/sales", body);
+    const recorded = input.services?.length ? input.services.map((s) => ({
+      service: s.service,
+      amount_cents: s.amount_cents
+    })) : [
+      {
+        service: input.service,
+        amount_cents: input.amount_total_cents ?? null
       }
-      const body = {
-        ...input,
+    ];
+    fireRecordedConversions(config.firing, input, recorded, sale, currency);
+    return sale;
+  }
+  return {
+    record,
+    // recordSale is the intent-revealing alias — same behavior, clearer call site.
+    recordSale: record,
+    trackConversion(key, options) {
+      const firing = config.firing?.getFiring(key);
+      if (!firing) return;
+      const currency = firing.currency ?? options?.currency ?? config.defaultCurrency ?? null;
+      const cents = firing.value_cents ?? null;
+      const value = options?.value ?? (cents != null && currency ? fromMinor(cents, currency) : null);
+      fireConversionWithConsent({
+        sendTo: firing.send_to,
+        value,
         currency,
-        occurred_at: input.occurred_at ?? (/* @__PURE__ */ new Date()).toISOString()
-      };
-      return salesRequest(config, "POST", "/sales", body);
+        transactionId: options?.transactionId ?? null
+      });
     },
     async list(query) {
       const { cursor, limit, sort, order, want_total, ...filters } = query ?? {};
@@ -1404,39 +1936,6 @@ function createSalesClient(config) {
   };
 }
 
-// ../tracking-core/src/resources/sales/money.ts
-var MINOR_UNIT_EXPONENT = {
-  USD: 2,
-  CAD: 2
-};
-function exponentFor(currency) {
-  return MINOR_UNIT_EXPONENT[currency] ?? 2;
-}
-function toMinor(amount, currency) {
-  return Math.round(amount * 10 ** exponentFor(currency));
-}
-function fromMinor(cents, currency) {
-  return cents / 10 ** exponentFor(currency);
-}
-function formatMoney(cents, currency, locale) {
-  return new Intl.NumberFormat(locale, { style: "currency", currency }).format(
-    fromMinor(cents, currency)
-  );
-}
-function formatDateInTz(iso, timeZone, opts, locale) {
-  const date = new Date(iso);
-  if (Number.isNaN(date.getTime())) return iso;
-  return new Intl.DateTimeFormat(locale, {
-    year: "numeric",
-    month: "short",
-    day: "2-digit",
-    hour: "2-digit",
-    minute: "2-digit",
-    ...opts,
-    timeZone
-  }).format(date);
-}
-
 // ../tracking-core/src/resources/sales/schema.ts
 import { z as z11 } from "zod";
 var SUPPORTED_CURRENCIES = ["USD", "CAD"];
@@ -1835,11 +2334,19 @@ var ANIMATION_KEYFRAMES = `
 }
 `;
 
-// src/GoogleAdsTracking.tsx
+// src/AdPlatformTracking.tsx
 import { useEffect as useEffect3, useMemo } from "react";
-function GoogleAdsTracking(props) {
-  const { gtagId, gtagIds } = props;
+function AdPlatformTracking({
+  gtagId,
+  gtagIds,
+  metaPixelId,
+  metaPixelIds
+}) {
   const gtagIdsKey = useMemo(() => gtagIds ? JSON.stringify(gtagIds) : "", [gtagIds]);
+  const metaPixelIdsKey = useMemo(
+    () => metaPixelIds ? JSON.stringify(metaPixelIds) : "",
+    [metaPixelIds]
+  );
   useEffect3(() => {
     if (gtagIds && Object.keys(gtagIds).length > 0) {
       bootstrapMultipleGtags(gtagIds);
@@ -1847,14 +2354,36 @@ function GoogleAdsTracking(props) {
       bootstrapGoogleAdsTracking(gtagId);
     }
   }, [gtagId, gtagIdsKey]);
+  useEffect3(() => {
+    if (metaPixelIds && Object.keys(metaPixelIds).length > 0) {
+      bootstrapMultiplePixels(metaPixelIds);
+    } else if (metaPixelId) {
+      bootstrapMetaPixel(metaPixelId);
+    }
+  }, [metaPixelId, metaPixelIdsKey]);
+  return null;
+}
+
+// src/GoogleAdsTracking.tsx
+import { useEffect as useEffect4, useMemo as useMemo2 } from "react";
+function GoogleAdsTracking(props) {
+  const { gtagId, gtagIds } = props;
+  const gtagIdsKey = useMemo2(() => gtagIds ? JSON.stringify(gtagIds) : "", [gtagIds]);
+  useEffect4(() => {
+    if (gtagIds && Object.keys(gtagIds).length > 0) {
+      bootstrapMultipleGtags(gtagIds);
+    } else if (gtagId) {
+      bootstrapGoogleAdsTracking(gtagId);
+    }
+  }, [gtagId, gtagIdsKey]);
   return null;
 }
 
 // src/factory.tsx
-import { createContext as createContext2, useContext as useContext2, useEffect as useEffect4, useMemo as useMemo3 } from "react";
+import { createContext as createContext2, useContext as useContext2, useEffect as useEffect5, useMemo as useMemo4 } from "react";
 
 // package.json
-var version = "0.12.2";
+var version = "0.14.0";
 
 // ../tracking-core/src/phone-react.tsx
 import {
@@ -1862,7 +2391,7 @@ import {
   forwardRef,
   useCallback as useCallback2,
   useContext,
-  useMemo as useMemo2,
+  useMemo as useMemo3,
   useState as useState3
 } from "react";
 import { jsx as jsx2 } from "react/jsx-runtime";
@@ -1891,7 +2420,7 @@ function usePhoneField(opts = {}) {
   const { onValueChange } = opts;
   const [value, setValue] = useState3(() => formatPhoneAsTyped(opts.defaultValue ?? "", country));
   const [touched, setTouched] = useState3(false);
-  const parsed = useMemo2(() => parsePhone(value, country), [value, country]);
+  const parsed = useMemo3(() => parsePhone(value, country), [value, country]);
   const onChange = useCallback2(
     (event) => {
       const next = formatPhoneAsTyped(event.target.value, country);
@@ -1960,7 +2489,7 @@ var NOOP_CLIENT = {
   getVisitorId: () => ""
 };
 function createTracking(options) {
-  const { apiKey, endpoint, triggers, environment, debug, phone } = options;
+  const { apiKey, endpoint, triggers, environment, debug, phone, conversionConfig } = options;
   if (!apiKey || !endpoint) {
     if (apiKey || endpoint) {
       console.warn(
@@ -1976,11 +2505,17 @@ function createTracking(options) {
     };
   }
   const TrackingContext = createContext2(null);
-  function TrackingProvider({ gtagId, gtagIds, children }) {
+  function TrackingProvider({
+    gtagId,
+    gtagIds,
+    metaPixelId,
+    metaPixelIds,
+    children
+  }) {
     const resolvedGtagIds = gtagIds ? Object.fromEntries(
       Object.entries(gtagIds).filter((e) => e[1] != null)
     ) : gtagId ? { default: gtagId } : void 0;
-    const client = useMemo3(
+    const client = useMemo4(
       () => createTypedClient(
         getOrCreateTrackingClient({
           apiKey,
@@ -1998,15 +2533,26 @@ function createTracking(options) {
       ),
       []
     );
-    const gtagIdsKey = useMemo3(() => gtagIds ? JSON.stringify(gtagIds) : "", [gtagIds]);
-    useEffect4(() => {
+    const gtagIdsKey = useMemo4(() => gtagIds ? JSON.stringify(gtagIds) : "", [gtagIds]);
+    useEffect5(() => {
       if (gtagIds && Object.keys(gtagIds).length > 0) {
         bootstrapMultipleGtags(gtagIds);
       } else if (gtagId) {
         bootstrapGoogleAdsTracking(gtagId);
       }
     }, [gtagId, gtagIdsKey]);
-    useEffect4(() => {
+    const metaPixelIdsKey = useMemo4(
+      () => metaPixelIds ? JSON.stringify(metaPixelIds) : "",
+      [metaPixelIds]
+    );
+    useEffect5(() => {
+      if (metaPixelIds && Object.keys(metaPixelIds).length > 0) {
+        bootstrapMultiplePixels(metaPixelIds);
+      } else if (metaPixelId) {
+        bootstrapMetaPixel(metaPixelId);
+      }
+    }, [metaPixelId, metaPixelIdsKey]);
+    useEffect5(() => {
       const detachers = [];
       const rawClient = getOrCreateTrackingClient({
         apiKey,
@@ -2018,27 +2564,32 @@ function createTracking(options) {
         activeGtagIds: resolvedGtagIds,
         debug
       });
-      detachers.push(attachAutoPageView(rawClient));
-      detachers.push(attachBfcacheRestore(rawClient));
+      const conversionStore = conversionConfig ? resolveConversionConfig({
+        cdnUrl: conversionConfig.cdnUrl,
+        baked: conversionConfig.baked
+      }) : null;
+      const detectorClient = conversionStore ? withConversionAutoFire(rawClient, createConversionAutoFire(conversionStore)) : rawClient;
+      detachers.push(attachAutoPageView(detectorClient));
+      detachers.push(attachBfcacheRestore(detectorClient));
       const timeOnSite = triggers.automatic.time_on_site;
       if (timeOnSite) {
-        detachers.push(attachTimeOnSite(rawClient, timeOnSite));
+        detachers.push(attachTimeOnSite(detectorClient, timeOnSite));
       }
       const specificPageVisit = triggers.automatic.specific_page_visit;
       if (specificPageVisit) {
-        detachers.push(attachSpecificPageVisit(rawClient, specificPageVisit));
+        detachers.push(attachSpecificPageVisit(detectorClient, specificPageVisit));
       }
       const scrollDepth = triggers.automatic.scroll_depth;
       if (scrollDepth) {
-        detachers.push(attachScrollDepth(rawClient, scrollDepth));
+        detachers.push(attachScrollDepth(detectorClient, scrollDepth));
       }
       const multiPageSession = triggers.automatic.multi_page_session;
       if (multiPageSession) {
-        detachers.push(attachMultiPageSession(rawClient, multiPageSession));
+        detachers.push(attachMultiPageSession(detectorClient, multiPageSession));
       }
       const formStart = triggers.automatic.form_start;
       if (formStart) {
-        detachers.push(attachFormStart(rawClient, formStart));
+        detachers.push(attachFormStart(detectorClient, formStart));
       }
       return () => {
         for (let i = detachers.length - 1; i >= 0; i--) {
@@ -2060,6 +2611,7 @@ function createTracking(options) {
   return { TrackingProvider, useTracking };
 }
 export {
+  AdPlatformTracking,
   AranovaApiError,
   ConsentBanner,
   DEFAULT_PHONE_COUNTRY,
@@ -2085,6 +2637,7 @@ export {
   parsePhone,
   phoneField,
   resetConsent,
+  resolveConversionConfig,
   saleCreateSchema,
   saleItemSchema,
   saleServiceSchema,