@aranova/tracking-next 0.11.0 → 0.12.1

package/dist/index.mjs

@@ -10,24 +10,20 @@ function buildConsentPayload(state) {
   };
 }
 function getConsentState() {
-  if (typeof window === "undefined")
-    return "pending";
+  if (typeof window === "undefined") return "pending";
   const storedState = window.localStorage.getItem(CONSENT_STATE_KEY);
-  if (storedState === "granted" || storedState === "denied")
-    return storedState;
+  if (storedState === "granted" || storedState === "denied") return storedState;
   return "pending";
 }
 function setConsentState(state) {
-  if (typeof window === "undefined")
-    return;
+  if (typeof window === "undefined") return;
   window.localStorage.setItem(CONSENT_STATE_KEY, state);
   window.localStorage.setItem(CONSENT_TIMESTAMP_KEY, (/* @__PURE__ */ new Date()).toISOString());
   if (typeof window.gtag === "function")
     window.gtag("consent", "update", buildConsentPayload(state));
 }
 function resetConsent() {
-  if (typeof window === "undefined")
-    return;
+  if (typeof window === "undefined") return;
   window.localStorage.removeItem(CONSENT_STATE_KEY);
   window.localStorage.removeItem(CONSENT_TIMESTAMP_KEY);
 }
@@ -168,18 +164,15 @@ function getTrackingQueryValues(searchParams) {
   }, {});
 }
 function getCookieValueFromDocument(key) {
-  if (typeof document === "undefined")
-    return null;
+  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;
+  if (!match) return null;
   const [, rawValue = ""] = match.split("=");
   return normalizeTrackingCookieValue(decodeURIComponent(rawValue));
 }
 function setTrackingCookie(key, value, maxAgeSeconds = TRACKING_COOKIE_MAX_AGE_SECONDS) {
-  if (typeof document === "undefined")
-    return;
+  if (typeof document === "undefined") return;
   const encodedValue = encodeURIComponent(value);
   document.cookie = `${key}=${encodedValue}; Max-Age=${maxAgeSeconds}; Path=/; SameSite=Lax`;
 }
@@ -219,18 +212,15 @@ function writeLocalStorage(key, value) {
   }
 }
 function getVisitorId() {
-  if (typeof window === "undefined")
-    return safeUuid();
+  if (typeof window === "undefined") return safeUuid();
   const existing = readLocalStorage(VISITOR_STORAGE_KEY);
-  if (existing && existing.length > 0)
-    return existing;
+  if (existing && existing.length > 0) return existing;
   const fresh = safeUuid();
   writeLocalStorage(VISITOR_STORAGE_KEY, fresh);
   return fresh;
 }
 function getOrRotateSessionId(now = Date.now()) {
-  if (typeof window === "undefined")
-    return { id: safeUuid(), isNew: true };
+  if (typeof window === "undefined") return { id: safeUuid(), isNew: true };
   const raw = readLocalStorage(SESSION_STORAGE_KEY);
   if (raw) {
     try {
@@ -303,8 +293,7 @@ function setLastFiredUrl(url) {
   writeSessionStorage(LAST_FIRED_URL_STORAGE_KEY, url);
 }
 function buildPageViewMetadata(referrerOverride) {
-  if (typeof window === "undefined" || typeof document === "undefined")
-    return null;
+  if (typeof window === "undefined" || typeof document === "undefined") return null;
   return pageViewMetadataSchema.parse({
     page: {
       title: document.title || null,
@@ -317,8 +306,7 @@ function buildPageViewMetadata(referrerOverride) {
   });
 }
 function fireManualPageView(client) {
-  if (typeof window === "undefined")
-    return;
+  if (typeof window === "undefined") return;
   const currentHref = window.location.href;
   const previousFiredUrl = getLastFiredUrl();
   const internalReferrer = previousFiredUrl !== null && previousFiredUrl !== currentHref ? previousFiredUrl : null;
@@ -420,8 +408,7 @@ function buildContext(surface, sdkVersion, packageName, environment, activeGtagI
   };
 }
 function readTrackingParams() {
-  if (typeof window === "undefined")
-    return createEmptyTrackingParams();
+  if (typeof window === "undefined") return createEmptyTrackingParams();
   try {
     captureTrackingParamsFromLocation();
   } catch {
@@ -436,8 +423,7 @@ function consentSnapshot() {
   }
 }
 async function postWithFetch(url, body, apiKey, identity, keepalive) {
-  if (typeof fetch !== "function")
-    return;
+  if (typeof fetch !== "function") return;
   try {
     await fetch(url, {
       method: "POST",
@@ -497,8 +483,7 @@ function createTrackingClient(config) {
   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;
   function enqueueHeartbeat() {
     const metadata = buildHeartbeatMetadata(
       config.surface,
@@ -524,7 +509,13 @@ function createTrackingClient(config) {
     }
     sessionId = rotated.id;
     const params = readTrackingParams();
-    const context = buildContext(config.surface, sdkVersion, packageName, environment, activeGtagIds);
+    const context = buildContext(
+      config.surface,
+      sdkVersion,
+      packageName,
+      environment,
+      activeGtagIds
+    );
     return {
       session_id: sessionId,
       visitor_id: visitorId,
@@ -541,8 +532,7 @@ function createTrackingClient(config) {
     };
   }
   function scheduleFlush() {
-    if (flushTimer !== null || destroyed)
-      return;
+    if (flushTimer !== null || destroyed) return;
     flushTimer = setTimeout(() => {
       flushTimer = null;
       void flush();
@@ -555,8 +545,7 @@ function createTrackingClient(config) {
     }
   }
   async function flush() {
-    if (queue.length === 0)
-      return;
+    if (queue.length === 0) return;
     const events = queue.slice(0, HARD_MAX_BATCH);
     queue = queue.slice(events.length);
     clearScheduledFlush();
@@ -568,10 +557,8 @@ function createTrackingClient(config) {
     await postWithFetch(eventsUrl, serialized, config.apiKey, identityHeaders2, false);
   }
   function trackEvent(input) {
-    if (destroyed)
-      return;
-    if (!input || typeof input.eventType !== "string" || input.eventType.length === 0)
-      return;
+    if (destroyed) return;
+    if (!input || typeof input.eventType !== "string" || input.eventType.length === 0) return;
     const occurredAt = input.occurredAt instanceof Date ? input.occurredAt.toISOString() : typeof input.occurredAt === "string" ? input.occurredAt : (/* @__PURE__ */ new Date()).toISOString();
     queue.push({
       event_type: input.eventType,
@@ -586,8 +573,7 @@ function createTrackingClient(config) {
     }
   }
   function flushOnUnload() {
-    if (queue.length === 0)
-      return;
+    if (queue.length === 0) return;
     const events = queue.slice(0, HARD_MAX_BATCH);
     queue = queue.slice(events.length);
     clearScheduledFlush();
@@ -1127,21 +1113,40 @@ function createSalesClient(config) {
       return salesRequest(config, "POST", "/sales", body);
     },
     async list(query) {
-      const { cursor, limit, ...filters } = query ?? {};
+      const { cursor, limit, sort, order, want_total, ...filters } = query ?? {};
       return salesRequest(config, "POST", "/sales/query", {
         filters,
         ...limit !== void 0 ? { limit } : {},
-        ...cursor !== void 0 ? { cursor } : {}
+        ...cursor !== void 0 ? { cursor } : {},
+        ...sort !== void 0 ? { sort } : {},
+        ...order !== void 0 ? { order } : {},
+        ...want_total !== void 0 ? { want_total } : {}
       });
     },
     async summary(query) {
-      const { range, include_categories, include_deleted_services, top_n, ...filters } = query;
+      const {
+        range,
+        include_categories,
+        include_deleted_services,
+        top_n,
+        since,
+        until,
+        timezone,
+        granularity,
+        compare_to,
+        ...filters
+      } = query;
       return salesRequest(config, "POST", "/sales/summary", {
         filters,
-        range,
+        ...range !== void 0 ? { range } : {},
         ...include_categories !== void 0 ? { include_categories } : {},
         ...include_deleted_services !== void 0 ? { include_deleted_services } : {},
-        ...top_n !== void 0 ? { top_n } : {}
+        ...top_n !== void 0 ? { top_n } : {},
+        ...since !== void 0 ? { since } : {},
+        ...until !== void 0 ? { until } : {},
+        ...timezone !== void 0 ? { timezone } : {},
+        ...granularity !== void 0 ? { granularity } : {},
+        ...compare_to !== void 0 ? { compare_to } : {}
       });
     },
     async get(id) {
@@ -1152,15 +1157,53 @@ function createSalesClient(config) {
     },
     async delete(id) {
       await salesRequest(config, "DELETE", `/sales/${id}`);
+    },
+    customers: {
+      async list(query) {
+        const { segment, sort, order, cursor, limit, want_total, ...filters } = query ?? {};
+        return salesRequest(config, "POST", "/customers/query", {
+          filters,
+          ...segment !== void 0 ? { segment } : {},
+          ...sort !== void 0 ? { sort } : {},
+          ...order !== void 0 ? { order } : {},
+          ...cursor !== void 0 ? { cursor } : {},
+          ...limit !== void 0 ? { limit } : {},
+          ...want_total !== void 0 ? { want_total } : {}
+        });
+      },
+      async get(id, options) {
+        const params = new URLSearchParams();
+        if (options?.include_sales !== void 0)
+          params.set("include_sales", String(options.include_sales));
+        if (options?.limit !== void 0) params.set("limit", String(options.limit));
+        if (options?.cursor != null) params.set("cursor", options.cursor);
+        const qs = params.toString();
+        return salesRequest(
+          config,
+          "GET",
+          `/customers/${encodeURIComponent(id)}${qs ? `?${qs}` : ""}`
+        );
+      },
+      async summary(query) {
+        const { range, since, until, timezone, compare_to, ...filters } = query ?? {};
+        return salesRequest(config, "POST", "/customers/summary", {
+          filters,
+          ...range !== void 0 ? { range } : {},
+          ...since !== void 0 ? { since } : {},
+          ...until !== void 0 ? { until } : {},
+          ...timezone !== void 0 ? { timezone } : {},
+          ...compare_to !== void 0 ? { compare_to } : {}
+        });
+      }
+    },
+    business: {
+      async config() {
+        return salesRequest(config, "GET", "/business/config");
+      }
     }
   };
 }
 
-// ../tracking-core/src/resources/services.ts
-async function fetchServices(config) {
-  return salesRequest(config, "GET", "/services");
-}
-
 // ../tracking-core/src/resources/sales/money.ts
 var MINOR_UNIT_EXPONENT = {
   USD: 2,
@@ -1180,6 +1223,181 @@ function formatMoney(cents, currency, locale) {
     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"];
+var TRACKING_ENVIRONMENTS = ["production", "development"];
+var currencySchema = z11.enum(SUPPORTED_CURRENCIES);
+var centsSchema = z11.number().int().nonnegative();
+var quantitySchema = z11.string().regex(/^\d+(\.\d{1,3})?$/);
+var metadataSchema = z11.record(z11.unknown());
+var saleItemSchema = z11.object({
+  external_item_id: z11.string().nullable().optional(),
+  name: z11.string().nullable().optional(),
+  category: z11.string().nullable().optional(),
+  quantity: quantitySchema,
+  unit_price_cents: centsSchema,
+  // Non-negativity validated on the wire — same contract as the other cents
+  // fields — and backstopped by the DB CHECK.
+  unit_cost_cents: centsSchema.nullable().optional()
+}).strict();
+var saleServiceSchema = z11.object({
+  service: z11.string(),
+  amount_cents: centsSchema
+}).strict();
+var customerNameSchema = z11.string().max(200);
+var customerPhoneSchema = z11.string().max(64);
+var customerEmailSchema = z11.string().max(320).email();
+function refineServiceXor(val, ctx, { requireAmount }) {
+  if (val.services != null) {
+    if (val.service != null) {
+      ctx.addIssue({
+        code: z11.ZodIssueCode.custom,
+        message: "pass either `service` or `services`, not both",
+        path: ["services"]
+      });
+    }
+    if (val.services.length === 0) {
+      ctx.addIssue({
+        code: z11.ZodIssueCode.custom,
+        message: "`services` must not be empty",
+        path: ["services"]
+      });
+    }
+    const keys = val.services.map((s) => s.service);
+    if (new Set(keys).size !== keys.length) {
+      ctx.addIssue({
+        code: z11.ZodIssueCode.custom,
+        message: "`services` must not list the same service more than once",
+        path: ["services"]
+      });
+    }
+    if (val.amount_total_cents != null) {
+      const sum = val.services.reduce((acc, s) => acc + s.amount_cents, 0);
+      if (val.amount_total_cents !== sum) {
+        ctx.addIssue({
+          code: z11.ZodIssueCode.custom,
+          message: "amount_total_cents must equal the sum of the services amounts (omit it to derive it automatically)",
+          path: ["amount_total_cents"]
+        });
+      }
+    }
+  } else if (requireAmount && val.amount_total_cents == null) {
+    ctx.addIssue({
+      code: z11.ZodIssueCode.custom,
+      message: "amount_total_cents is required unless `services` is provided",
+      path: ["amount_total_cents"]
+    });
+  }
+}
+var saleCreateSchema = z11.object({
+  external_id: z11.string().nullable().optional(),
+  description: z11.string().nullable().optional(),
+  service: z11.string().nullable().optional(),
+  services: z11.array(saleServiceSchema).nullable().optional(),
+  currency: currencySchema,
+  // Optional only because the plural `services` form derives it from the sum
+  // (see refineServiceXor); the singular/serviceless path still requires it.
+  amount_total_cents: centsSchema.nullable().optional(),
+  occurred_at: z11.string().datetime(),
+  environment: z11.enum(TRACKING_ENVIRONMENTS).default("production"),
+  items: z11.array(saleItemSchema).default([]),
+  metadata: metadataSchema.nullable().optional(),
+  customer_name: customerNameSchema.nullable().optional(),
+  customer_phone: customerPhoneSchema.nullable().optional(),
+  customer_email: customerEmailSchema.nullable().optional()
+}).strict().superRefine((val, ctx) => refineServiceXor(val, ctx, { requireAmount: true }));
+var saleUpdateSchema = z11.object({
+  description: z11.string().nullable().optional(),
+  service: z11.string().nullable().optional(),
+  services: z11.array(saleServiceSchema).nullable().optional(),
+  currency: currencySchema.optional(),
+  amount_total_cents: centsSchema.optional(),
+  occurred_at: z11.string().datetime().optional(),
+  items: z11.array(saleItemSchema).optional(),
+  metadata: metadataSchema.nullable().optional(),
+  customer_name: customerNameSchema.nullable().optional(),
+  customer_phone: customerPhoneSchema.nullable().optional(),
+  customer_email: customerEmailSchema.nullable().optional()
+}).strict().superRefine((val, ctx) => refineServiceXor(val, ctx, { requireAmount: false }));
+var TRACKING_RANGES = ["24h", "7d", "30d"];
+var NAMED_RANGES = [
+  "today",
+  "yesterday",
+  "wtd",
+  "mtd",
+  "qtd",
+  "ytd",
+  "24h",
+  "7d",
+  "30d",
+  "90d",
+  "custom"
+];
+
+// ../tracking-core/src/resources/services.ts
+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) };
+}
 
 // src/ConsentBanner.tsx
 import { useEffect as useEffect2, useState as useState2 } from "react";
@@ -1448,19 +1666,108 @@ function GoogleAdsTracking(props) {
 import { usePathname, useSearchParams } from "next/navigation";
 
 // package.json
-var version = "0.11.0";
+var version = "0.12.1";
 
 // src/factory.tsx
+import { createContext as createContext2, useContext as useContext2, useEffect as useEffect3, useMemo as useMemo2, useRef } from "react";
+
+// ../tracking-core/src/phone-react.tsx
 import {
   createContext,
+  forwardRef,
+  useCallback as useCallback2,
   useContext,
-  useEffect as useEffect3,
   useMemo,
-  useRef
+  useState as useState3
 } from "react";
 import { jsx as jsx3 } from "react/jsx-runtime";
+var _phoneConfigContext;
+function phoneConfigContext() {
+  return _phoneConfigContext ?? (_phoneConfigContext = createContext(null));
+}
+function PhoneConfigProvider({
+  value,
+  children
+}) {
+  const Ctx = phoneConfigContext();
+  return /* @__PURE__ */ jsx3(Ctx.Provider, { value, children });
+}
+function usePhoneConfig() {
+  const ctx = useContext(phoneConfigContext());
+  return {
+    defaultCountry: ctx?.defaultCountry ?? DEFAULT_PHONE_COUNTRY,
+    display: ctx?.display ?? "national"
+  };
+}
+function usePhoneField(opts = {}) {
+  const cfg = usePhoneConfig();
+  const country = opts.country ?? cfg.defaultCountry;
+  const display = opts.display ?? cfg.display;
+  const { onValueChange } = opts;
+  const [value, setValue] = useState3(() => formatPhoneAsTyped(opts.defaultValue ?? "", country));
+  const [touched, setTouched] = useState3(false);
+  const parsed = useMemo(() => parsePhone(value, country), [value, country]);
+  const onChange = useCallback2(
+    (event) => {
+      const next = formatPhoneAsTyped(event.target.value, country);
+      setValue(next);
+      onValueChange?.(parsePhone(next, country).e164);
+    },
+    [country, onValueChange]
+  );
+  const onBlur = useCallback2(
+    (_event) => {
+      setTouched(true);
+      setValue((current) => {
+        const p = parsePhone(current, country);
+        return p.isValid ? formatPhone(current, display, country) : current;
+      });
+    },
+    [country, display]
+  );
+  const error = touched && value.length > 0 && !parsed.isValid ? "Enter a valid phone number" : null;
+  return {
+    value,
+    e164: parsed.e164,
+    isValid: parsed.isValid,
+    error,
+    parsed,
+    inputProps: { value, onChange, onBlur, type: "tel", inputMode: "tel", autoComplete: "tel" }
+  };
+}
+var PhoneField = forwardRef(function PhoneField2({ country, value, defaultValue, onChange, onE164Change, ...rest }, ref) {
+  const cfg = usePhoneConfig();
+  const resolvedCountry = country ?? cfg.defaultCountry;
+  const isControlled = value !== void 0;
+  const [internal, setInternal] = useState3(
+    () => formatPhoneAsTyped(defaultValue ?? "", resolvedCountry)
+  );
+  const handleChange = (event) => {
+    const formatted = formatPhoneAsTyped(event.target.value, resolvedCountry);
+    event.target.value = formatted;
+    onE164Change?.(parsePhone(formatted, resolvedCountry).e164);
+    if (!isControlled) setInternal(formatted);
+    onChange?.(event);
+  };
+  const shown = isControlled ? formatPhoneAsTyped(value, resolvedCountry) : internal;
+  return /* @__PURE__ */ jsx3(
+    "input",
+    {
+      ...rest,
+      ref,
+      type: "tel",
+      inputMode: "tel",
+      autoComplete: "tel",
+      value: shown,
+      onChange: handleChange
+    }
+  );
+});
+
+// src/factory.tsx
+import { jsx as jsx4 } from "react/jsx-runtime";
 function createTracking(options) {
-  const { apiKey, endpoint, triggers, environment, gtagIds, debug } = options;
+  const { apiKey, endpoint, triggers, environment, gtagIds, debug, phone } = options;
   if (!apiKey || !endpoint) {
     if (apiKey || endpoint) {
       console.warn(
@@ -1476,17 +1783,17 @@ function createTracking(options) {
       getVisitorId: () => ""
     };
     return {
-      TrackingProvider: ({ children }) => children,
+      TrackingProvider: ({ children }) => /* @__PURE__ */ jsx4(PhoneConfigProvider, { value: phone ?? null, children }),
       useTracking: () => noopClient
     };
   }
-  const TrackingContext = createContext(null);
+  const TrackingContext = createContext2(null);
   const specificPageVisitConfig = triggers.automatic.specific_page_visit ?? null;
   const timeOnSiteConfig = triggers.automatic.time_on_site ?? null;
   function TrackingProvider({ children }) {
     const pathname = usePathname();
     const searchParams = useSearchParams();
-    const client = useMemo(
+    const client = useMemo2(
       () => createTypedClient(
         getOrCreateTrackingClient({
           apiKey,
@@ -1645,10 +1952,10 @@ function createTracking(options) {
         }
       };
     }, []);
-    return /* @__PURE__ */ jsx3(TrackingContext.Provider, { value: client, children });
+    return /* @__PURE__ */ jsx4(TrackingContext.Provider, { value: client, children: /* @__PURE__ */ jsx4(PhoneConfigProvider, { value: phone ?? null, children }) });
   }
   function useTracking() {
-    const client = useContext(TrackingContext);
+    const client = useContext2(TrackingContext);
     if (client === null) {
       throw new Error(
         "useTracking must be called inside a <TrackingProvider> returned by createTracking()"
@@ -1661,8 +1968,13 @@ function createTracking(options) {
 export {
   AranovaApiError,
   ConsentBanner,
+  DEFAULT_PHONE_COUNTRY,
   GoogleAdsTracking,
+  NAMED_RANGES,
+  PhoneField,
+  SUPPORTED_CURRENCIES,
   TRACKING_PARAM_KEYS,
+  TRACKING_RANGES,
   captureTrackingParamsFromLocation,
   createSalesClient,
   createTracking,
@@ -1670,15 +1982,28 @@ export {
   createTrackingEventCreatePayload,
   createTrackingSessionUpsertPayload,
   fetchServices,
+  formatDateInTz,
   formatMoney,
+  formatPhone,
+  formatPhoneAsTyped,
   fromMinor,
   getConsentState,
+  parsePhone,
+  phoneField,
   resetConsent,
+  saleCreateSchema,
+  saleItemSchema,
+  saleServiceSchema,
+  saleUpdateSchema,
+  salesRequest,
   setConsentState,
+  toE164,
   toMinor,
   useConsent,
   useConsentState,
   useGclid,
+  usePhoneConfig,
+  usePhoneField,
   useTrackingParams
 };
 //# sourceMappingURL=index.mjs.map