@aranova/tracking-next 0.21.0 → 0.22.2

package/dist/index.mjs

@@ -258,6 +258,43 @@ var aranovaConsent = (function () {
 `.trim();
 }
 
+// ../tracking-core/src/capabilities.ts
+var TRACKING_CAPABILITIES = [
+  "ad_tags_google",
+  "ad_tags_meta",
+  "base_tracking",
+  "blog_rendering",
+  "calendar_read",
+  "calendar_write",
+  "consent_controls",
+  "conversion_goals_auto",
+  "conversion_goals_manual",
+  "cta_click_capture",
+  "form_capture",
+  "phone_click_capture",
+  "phone_fields"
+];
+var CAPABILITY_DOM_ATTRIBUTE = "data-aranova-capability";
+var registered = /* @__PURE__ */ new Set();
+function registerCapability(capability) {
+  registered.add(capability);
+}
+function getRegisteredCapabilities() {
+  const all = new Set(registered);
+  for (const marker of readDomMarkers()) all.add(marker);
+  return Array.from(all).sort();
+}
+function readDomMarkers() {
+  if (typeof document === "undefined") return [];
+  const known = new Set(TRACKING_CAPABILITIES);
+  const found = [];
+  for (const node of document.querySelectorAll(`[${CAPABILITY_DOM_ATTRIBUTE}]`)) {
+    const value = node.getAttribute(CAPABILITY_DOM_ATTRIBUTE);
+    if (value && known.has(value)) found.push(value);
+  }
+  return found;
+}
+
 // ../tracking-core/src/tracking.ts
 var TRACKING_COOKIE_MAX_AGE_SECONDS = 7776e3;
 var TRACKING_PARAM_KEYS = [
@@ -602,7 +639,8 @@ function createTrackingClientContext(surface, input = {}) {
     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
+    active_gtag_ids: input.activeGtagIds ?? null,
+    capabilities: getRegisteredCapabilities()
   };
 }
 function createTrackingSessionUpsertPayload(trackingParams, input, context) {
@@ -1582,6 +1620,9 @@ function buildHeartbeatMetadata(surface, sdkVersion, packageName, triggers, gtag
 var DEFAULT_FLUSH_INTERVAL_MS = 2e3;
 var DEFAULT_MAX_QUEUE_SIZE = 10;
 var HARD_MAX_BATCH = 50;
+var MAX_RETRY_BACKOFF_MS = 6e4;
+var MAX_BUFFERED_EVENTS2 = 200;
+var RETRY_BUFFER_KEY_PREFIX = "aranova_tracking_pending_v1";
 var API_KEY_HEADER = "X-Aranova-Api-Key";
 var SDK_VERSION_HEADER = "X-Aranova-Sdk-Version";
 var SDK_PACKAGE_HEADER = "X-Aranova-Sdk-Package";
@@ -1596,7 +1637,10 @@ function buildContext(surface, sdkVersion, packageName, environment, activeGtagI
     page_title: typeof document === "undefined" ? null : document.title || null,
     referrer: typeof document === "undefined" ? null : document.referrer || null,
     environment,
-    active_gtag_ids: activeGtagIds
+    active_gtag_ids: activeGtagIds,
+    // Rebuilt per flush (this runs inside the payload builder), so a client
+    // constructed later on a deeper route still gets reported.
+    capabilities: getRegisteredCapabilities()
   };
 }
 function readTrackingParams() {
@@ -1621,9 +1665,9 @@ function consentSnapshot() {
   }
 }
 async function postWithFetch(url, body, apiKey, identity, keepalive) {
-  if (typeof fetch !== "function") return;
+  if (typeof fetch !== "function") return "drop";
   try {
-    await fetch(url, {
+    const response = await fetch(url, {
       method: "POST",
       headers: {
         "Content-Type": "application/json",
@@ -1639,8 +1683,48 @@ async function postWithFetch(url, body, apiKey, identity, keepalive) {
       credentials: "omit",
       mode: "cors"
     });
+    if (response.ok) return "ok";
+    if (response.status === 408 || response.status === 429 || response.status >= 500) {
+      return "retry";
+    }
+    return "drop";
+  } catch {
+    return "retry";
+  }
+}
+function retryBufferKey(apiKey, endpoint) {
+  return `${RETRY_BUFFER_KEY_PREFIX}:${apiKey}:${endpoint}`;
+}
+function readPendingBatches(key) {
+  if (typeof window === "undefined") return [];
+  try {
+    const raw = window.localStorage.getItem(key);
+    if (!raw) return [];
+    const parsed = JSON.parse(raw);
+    if (!Array.isArray(parsed)) return [];
+    return parsed.filter(
+      (entry) => typeof entry === "object" && entry !== null && "session" in entry && Array.isArray(entry.events)
+    );
   } catch {
+    return [];
+  }
+}
+function writePendingBatches(key, batches) {
+  if (typeof window === "undefined") return;
+  try {
+    if (batches.length === 0) window.localStorage.removeItem(key);
+    else window.localStorage.setItem(key, JSON.stringify(batches));
+  } catch {
+  }
+}
+function trimToBufferCap(batches) {
+  let total = batches.reduce((sum, batch) => sum + batch.events.length, 0);
+  const trimmed = batches.slice();
+  while (total > MAX_BUFFERED_EVENTS2 && trimmed.length > 1) {
+    const dropped = trimmed.shift();
+    total -= dropped ? dropped.events.length : 0;
   }
+  return trimmed;
 }
 var globalClient = null;
 var globalClientKey = null;
@@ -1697,6 +1781,10 @@ function createTrackingClient(config) {
   };
   let queue = [];
   let flushTimer = null;
+  const bufferKey = retryBufferKey(config.apiKey, endpointBase);
+  let pending = readPendingBatches(bufferKey);
+  let flushChain = Promise.resolve();
+  let retryAttempt = 0;
   let firstPage = null;
   let initialParams = createEmptyTrackingParams();
   let destroyed = false;
@@ -1733,6 +1821,9 @@ function createTrackingClient(config) {
   if (initialSession.isNew) {
     enqueueHeartbeat();
   }
+  if (pending.length > 0) {
+    scheduleFlush();
+  }
   function buildSessionPayload() {
     const rotated = getOrRotateSessionId();
     if (rotated.isNew && rotated.id !== sessionId) {
@@ -1771,12 +1862,12 @@ function createTrackingClient(config) {
       context
     };
   }
-  function scheduleFlush() {
+  function scheduleFlush(delayMs = flushIntervalMs) {
     if (flushTimer !== null || destroyed) return;
     flushTimer = setTimeout(() => {
       flushTimer = null;
       void flush();
-    }, flushIntervalMs);
+    }, delayMs);
   }
   function clearScheduledFlush() {
     if (flushTimer !== null) {
@@ -1784,17 +1875,50 @@ function createTrackingClient(config) {
       flushTimer = null;
     }
   }
-  async function flush() {
+  function bufferQueued() {
     if (queue.length === 0) return;
     const events = queue.slice(0, HARD_MAX_BATCH);
     queue = queue.slice(events.length);
+    pending = trimToBufferCap([...pending, { session: buildSessionPayload(), events }]);
+    writePendingBatches(bufferKey, pending);
+  }
+  function flush() {
+    flushChain = flushChain.then(runFlush).catch(() => {
+    });
+    return flushChain;
+  }
+  async function runFlush() {
+    if (destroyed) return;
     clearScheduledFlush();
-    const body = {
-      session: buildSessionPayload(),
-      events
-    };
-    const serialized = JSON.stringify(body);
-    await postWithFetch(eventsUrl, serialized, config.apiKey, identityHeaders2, false);
+    bufferQueued();
+    if (pending.length === 0) return;
+    try {
+      while (pending.length > 0) {
+        const batch = pending[0];
+        const body = { session: batch.session, events: batch.events };
+        const outcome = await postWithFetch(
+          eventsUrl,
+          JSON.stringify(body),
+          config.apiKey,
+          identityHeaders2,
+          false
+        );
+        if (outcome === "retry") {
+          retryAttempt += 1;
+          return;
+        }
+        pending = pending.slice(1);
+        writePendingBatches(bufferKey, pending);
+        retryAttempt = 0;
+      }
+    } finally {
+      if (pending.length > 0) {
+        const backoff = Math.min(flushIntervalMs * 2 ** retryAttempt, MAX_RETRY_BACKOFF_MS);
+        scheduleFlush(backoff);
+      } else if (queue.length > 0) {
+        scheduleFlush();
+      }
+    }
   }
   function trackEvent(input) {
     if (destroyed) return;
@@ -1820,16 +1944,14 @@ function createTrackingClient(config) {
     }
   }
   function flushOnUnload() {
-    if (queue.length === 0) return;
-    const events = queue.slice(0, HARD_MAX_BATCH);
-    queue = queue.slice(events.length);
+    bufferQueued();
     clearScheduledFlush();
-    const body = {
-      session: buildSessionPayload(),
-      events
-    };
-    const serialized = JSON.stringify(body);
-    void postWithFetch(eventsUrl, serialized, config.apiKey, identityHeaders2, true);
+    if (pending.length === 0) return;
+    const batch = pending[0];
+    pending = pending.slice(1);
+    writePendingBatches(bufferKey, pending);
+    const body = { session: batch.session, events: batch.events };
+    void postWithFetch(eventsUrl, JSON.stringify(body), config.apiKey, identityHeaders2, true);
   }
   if (typeof window !== "undefined") {
     window.addEventListener("pagehide", flushOnUnload);
@@ -2189,8 +2311,9 @@ function getEventDefinition(name) {
 }
 
 // ../tracking-core/src/ingest-typed.ts
-function createTypedClient(raw, _registry, options = {}) {
+function createTypedClient(raw, registry, options = {}) {
   const debug = options.debug ?? false;
+  if (registry.manual?.form_submit) registerCapability("form_capture");
   return {
     trackEvent(eventType, metadata, opts) {
       if (debug) {
@@ -2597,6 +2720,7 @@ function attachCtaClickCapture(client, config) {
     return () => {
     };
   }
+  registerCapability("cta_click_capture");
   const selector = autoCapture.selector ?? DEFAULT_CTA_SELECTOR;
   function onClick(event) {
     const target = event.target;
@@ -2653,6 +2777,7 @@ function attachPhoneClickCapture(client, config) {
     return () => {
     };
   }
+  registerCapability("phone_click_capture");
   const selector = autoCapture.selector ?? DEFAULT_TEL_SELECTOR;
   function onClick(event) {
     const target = event.target;
@@ -2769,6 +2894,7 @@ function fireRecordedConversions(firing, input, recorded, sale, currency) {
   }
 }
 function createSalesClient(config) {
+  if (config.firing) registerCapability("conversion_goals_manual");
   async function record(input) {
     const currency = input.currency ?? config.defaultCurrency;
     if (!currency) {
@@ -3012,6 +3138,9 @@ var saleUpdateSchema = z12.object({
   items: z12.array(saleItemSchema).optional(),
   metadata: metadataSchema.nullable().optional(),
   customer_name: customerNameSchema.nullable().optional(),
+  // Re-attest when changing a filler-looking name; the server clears the
+  // prior attestation whenever `customer_name` changes.
+  customer_name_placeholder_confirmed: z12.boolean().optional(),
   customer_phone: customerPhoneSchema.nullable().optional(),
   customer_email: customerEmailSchema.nullable().optional(),
   // NOT NULL server-side: omit to leave unchanged (explicit null is rejected).
@@ -3068,6 +3197,7 @@ var DEFAULT_CHOICE2 = {
   expiresAt: null
 };
 function useCookiePreferences(options) {
+  registerCapability("consent_controls");
   const [choice, setChoice] = useState(DEFAULT_CHOICE2);
   const ttlDays = options?.declineTtlDays;
   useEffect(() => {
@@ -3335,6 +3465,8 @@ function AdPlatformTracking({
   }, [trackingConfigKey, standalonePageView]);
   const gtagAll = trackingConfig ? [] : gtagIds ? Object.values(gtagIds).filter((id) => id != null) : gtagId ? [gtagId] : [];
   const metaAll = metaPixelIds ? Object.values(metaPixelIds).filter((id) => id != null) : metaPixelId ? [metaPixelId] : [];
+  if (trackingConfig || gtagAll.length > 0) registerCapability("ad_tags_google");
+  if (metaAll.length > 0) registerCapability("ad_tags_meta");
   const gtagLoaderId = gtagAll[0];
   const gtagInitScript = gtagAll.length === 1 ? createGtagInitScript(gtagAll[0]) : createGtagInitScriptMulti(gtagAll);
   const metaInitScript = metaAll.length === 1 ? createMetaPixelInitScript(metaAll[0]) : createMetaPixelInitScriptMulti(metaAll);
@@ -3383,7 +3515,7 @@ function GoogleAdsTracking(props) {
 import { usePathname, useSearchParams } from "next/navigation";
 
 // package.json
-var version = "0.21.0";
+var version = "0.22.2";
 
 // src/factory.tsx
 import {
@@ -3425,6 +3557,7 @@ function usePhoneConfig() {
   };
 }
 function usePhoneField(opts = {}) {
+  registerCapability("phone_fields");
   const cfg = usePhoneConfig();
   const country = opts.country ?? cfg.defaultCountry;
   const display = opts.display ?? cfg.display;
@@ -3511,6 +3644,8 @@ function createTracking(options) {
     conversionConfig,
     trackingConfig
   } = options;
+  registerCapability("base_tracking");
+  if (trackingConfig) registerCapability("conversion_goals_auto");
   if (!apiKey || !endpoint) {
     if (apiKey || endpoint) {
       console.warn(
@@ -3752,6 +3887,7 @@ function withBusiness(config, path) {
   return `${path}${separator}business_id=${encodeURIComponent(config.businessId)}`;
 }
 function createCalendarReadClient(config) {
+  registerCapability("calendar_read");
   return {
     async listCalendars() {
       return calendarRequest(config, "GET", withBusiness(config, "/calendars"));