@aranova/tracking-next 0.16.2 → 0.17.1

package/dist/index.mjs

@@ -702,8 +702,8 @@ function thresholdMet(goal, eventType, metadata) {
       return typeof metadata.page_name === "string" && metadata.page_name === t.page_name;
     case "page_view":
     case "form_start":
+    case "phone_click":
       return true;
-    // no threshold — fire whenever the detector emits
     default:
       return false;
   }
@@ -1324,7 +1324,11 @@ var phoneClickMetadataSchema = z8.object({
   }).strict(),
   section: z8.string().nullable().optional()
 }).strict();
-var phoneClickConfigSchema = z8.object({}).strict();
+var phoneClickConfigSchema = z8.object({
+  autoCapture: z8.object({
+    selector: z8.string().optional()
+  }).strict().optional()
+}).strict();
 
 // ../tracking-core/src/events/scroll-depth.ts
 import { z as z9 } from "zod";
@@ -1825,6 +1829,99 @@ function attachCtaClickCapture(client, config) {
   };
 }
 
+// ../tracking-core/src/phone.ts
+import { AsYouType, parsePhoneNumberFromString } from "libphonenumber-js";
+var DEFAULT_PHONE_COUNTRY = "CA";
+function parsePhone(raw, country) {
+  const region = country ?? DEFAULT_PHONE_COUNTRY;
+  const parsed = parsePhoneNumberFromString(raw ?? "", region);
+  if (!parsed) {
+    return { e164: null, national: "", international: "", country: region, isValid: false };
+  }
+  const isValid = parsed.isValid();
+  return {
+    // E.164 is only surfaced for a *valid* number — a possible-but-invalid input
+    // (e.g. too few digits) still parses but must not be transmitted.
+    e164: isValid ? parsed.number : null,
+    national: parsed.formatNational(),
+    international: parsed.formatInternational(),
+    country: parsed.country ?? region,
+    isValid
+  };
+}
+function toE164(raw, country) {
+  return parsePhone(raw, country).e164;
+}
+function formatPhone(value, format = "national", country) {
+  const parsed = parsePhone(value, country);
+  if (typeof format === "function") return format(parsed);
+  switch (format) {
+    case "international":
+      return parsed.international || value;
+    case "e164":
+      return parsed.e164 ?? value;
+    case "national":
+    default:
+      return parsed.national || value;
+  }
+}
+function formatPhoneAsTyped(raw, country) {
+  return new AsYouType(country ?? DEFAULT_PHONE_COUNTRY).input(raw ?? "");
+}
+
+// ../tracking-core/src/triggers/phone-click-capture.ts
+var DEFAULT_TEL_SELECTOR = 'a[href^="tel:"]';
+function safeDecodeURIComponent(value) {
+  try {
+    return decodeURIComponent(value);
+  } catch {
+    return value;
+  }
+}
+function resolvePhoneNumber(el) {
+  const href = el instanceof HTMLAnchorElement ? el.href : el.getAttribute("href") ?? "";
+  const raw = safeDecodeURIComponent(href.replace(/^tel:/i, "").split(";")[0]).trim();
+  return toE164(raw) ?? raw;
+}
+function attachPhoneClickCapture(client, config) {
+  if (typeof window === "undefined" || typeof document === "undefined") {
+    return () => {
+    };
+  }
+  const autoCapture = config.autoCapture;
+  if (!autoCapture) {
+    return () => {
+    };
+  }
+  const selector = autoCapture.selector ?? DEFAULT_TEL_SELECTOR;
+  function onClick(event) {
+    const target = event.target;
+    if (!(target instanceof Element)) return;
+    let matched = null;
+    try {
+      matched = target.closest(selector);
+    } catch {
+      return;
+    }
+    if (matched === null) return;
+    const metadata = {
+      phone_number: resolvePhoneNumber(matched),
+      page: { path: window.location.pathname },
+      section: matched.getAttribute("data-aranova-section")
+    };
+    client.trackEvent({
+      eventType: "phone_click",
+      metadata,
+      pageUrl: window.location.href,
+      occurredAt: null
+    });
+  }
+  document.addEventListener("click", onClick, true);
+  return () => {
+    document.removeEventListener("click", onClick, true);
+  };
+}
+
 // ../tracking-core/src/resources/sales/errors.ts
 var AranovaApiError = class extends Error {
   constructor(message, options) {
@@ -2112,7 +2209,10 @@ var saleCreateSchema = z12.object({
   metadata: metadataSchema.nullable().optional(),
   customer_name: customerNameSchema.nullable().optional(),
   customer_phone: customerPhoneSchema.nullable().optional(),
-  customer_email: customerEmailSchema.nullable().optional()
+  customer_email: customerEmailSchema.nullable().optional(),
+  // CASL consent attestation: the customer agreed to receive SMS. Recorded
+  // with a timestamp server-side; every SMS send path gates on it.
+  sms_consent: z12.boolean().default(false)
 }).strict().superRefine((val, ctx) => refineServiceXor(val, ctx, { requireAmount: true }));
 var saleUpdateSchema = z12.object({
   description: z12.string().nullable().optional(),
@@ -2125,7 +2225,9 @@ var saleUpdateSchema = z12.object({
   metadata: metadataSchema.nullable().optional(),
   customer_name: customerNameSchema.nullable().optional(),
   customer_phone: customerPhoneSchema.nullable().optional(),
-  customer_email: customerEmailSchema.nullable().optional()
+  customer_email: customerEmailSchema.nullable().optional(),
+  // NOT NULL server-side: omit to leave unchanged (explicit null is rejected).
+  sms_consent: z12.boolean().optional()
 }).strict().superRefine((val, ctx) => refineServiceXor(val, ctx, { requireAmount: false }));
 var TRACKING_RANGES = ["24h", "7d", "30d"];
 var NAMED_RANGES = [
@@ -2147,46 +2249,6 @@ async function fetchServices(config) {
   return salesRequest(config, "GET", "/services");
 }
 
-// ../tracking-core/src/phone.ts
-import { AsYouType, parsePhoneNumberFromString } from "libphonenumber-js";
-var DEFAULT_PHONE_COUNTRY = "CA";
-function parsePhone(raw, country) {
-  const region = country ?? DEFAULT_PHONE_COUNTRY;
-  const parsed = parsePhoneNumberFromString(raw ?? "", region);
-  if (!parsed) {
-    return { e164: null, national: "", international: "", country: region, isValid: false };
-  }
-  const isValid = parsed.isValid();
-  return {
-    // E.164 is only surfaced for a *valid* number — a possible-but-invalid input
-    // (e.g. too few digits) still parses but must not be transmitted.
-    e164: isValid ? parsed.number : null,
-    national: parsed.formatNational(),
-    international: parsed.formatInternational(),
-    country: parsed.country ?? region,
-    isValid
-  };
-}
-function toE164(raw, country) {
-  return parsePhone(raw, country).e164;
-}
-function formatPhone(value, format = "national", country) {
-  const parsed = parsePhone(value, country);
-  if (typeof format === "function") return format(parsed);
-  switch (format) {
-    case "international":
-      return parsed.international || value;
-    case "e164":
-      return parsed.e164 ?? value;
-    case "national":
-    default:
-      return parsed.national || value;
-  }
-}
-function formatPhoneAsTyped(raw, country) {
-  return new AsYouType(country ?? DEFAULT_PHONE_COUNTRY).input(raw ?? "");
-}
-
 // ../tracking-core/src/phone-field.ts
 function phoneField(name, raw, country) {
   return { name, type: "phone", value: toE164(raw, country) };
@@ -2523,7 +2585,7 @@ function GoogleAdsTracking(props) {
 import { usePathname, useSearchParams } from "next/navigation";
 
 // package.json
-var version = "0.16.2";
+var version = "0.17.1";
 
 // src/factory.tsx
 import {
@@ -2839,6 +2901,10 @@ function createTracking(options) {
       if (ctaClick) {
         detachers.push(attachCtaClickCapture(detectorClient, ctaClick));
       }
+      const phoneClick = triggers.manual?.phone_click;
+      if (phoneClick) {
+        detachers.push(attachPhoneClickCapture(detectorClient, phoneClick));
+      }
       return () => {
         for (let i = detachers.length - 1; i >= 0; i--) {
           detachers[i]();