@aranova/tracking-next 0.10.0 → 0.12.0

package/dist/index.js

@@ -32,7 +32,10 @@ var src_exports = {};
 __export(src_exports, {
   AranovaApiError: () => AranovaApiError,
   ConsentBanner: () => ConsentBanner,
+  DEFAULT_PHONE_COUNTRY: () => DEFAULT_PHONE_COUNTRY,
   GoogleAdsTracking: () => GoogleAdsTracking,
+  PhoneConfigContext: () => PhoneConfigContext,
+  PhoneField: () => PhoneField,
   TRACKING_PARAM_KEYS: () => TRACKING_PARAM_KEYS,
   captureTrackingParamsFromLocation: () => captureTrackingParamsFromLocation,
   createSalesClient: () => createSalesClient,
@@ -41,15 +44,23 @@ __export(src_exports, {
   createTrackingEventCreatePayload: () => createTrackingEventCreatePayload,
   createTrackingSessionUpsertPayload: () => createTrackingSessionUpsertPayload,
   fetchServices: () => fetchServices,
+  formatDateInTz: () => formatDateInTz,
   formatMoney: () => formatMoney,
+  formatPhone: () => formatPhone,
+  formatPhoneAsTyped: () => formatPhoneAsTyped,
   fromMinor: () => fromMinor,
   getConsentState: () => getConsentState,
+  parsePhone: () => parsePhone,
+  phoneField: () => phoneField,
   resetConsent: () => resetConsent,
   setConsentState: () => setConsentState,
+  toE164: () => toE164,
   toMinor: () => toMinor,
   useConsent: () => useConsent,
   useConsentState: () => useConsentState,
   useGclid: () => useGclid,
+  usePhoneConfig: () => usePhoneConfig,
+  usePhoneField: () => usePhoneField,
   useTrackingParams: () => useTrackingParams
 });
 module.exports = __toCommonJS(src_exports);
@@ -1183,21 +1194,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) {
@@ -1208,6 +1238,49 @@ 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");
+      }
     }
   };
 }
@@ -1236,6 +1309,64 @@ 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/phone.ts
+var import_libphonenumber_js = require("libphonenumber-js");
+var DEFAULT_PHONE_COUNTRY = "CA";
+function parsePhone(raw, country) {
+  const region = country ?? DEFAULT_PHONE_COUNTRY;
+  const parsed = (0, import_libphonenumber_js.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 import_libphonenumber_js.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
 var import_react2 = require("react");
@@ -1504,13 +1635,91 @@ function GoogleAdsTracking(props) {
 var import_navigation = require("next/navigation");
 
 // package.json
-var version = "0.10.0";
+var version = "0.12.0";
 
 // src/factory.tsx
+var import_react4 = require("react");
+
+// ../tracking-core/src/phone-react.tsx
 var import_react3 = require("react");
 var import_jsx_runtime3 = require("react/jsx-runtime");
+var PhoneConfigContext = (0, import_react3.createContext)(null);
+function usePhoneConfig() {
+  const ctx = (0, import_react3.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] = (0, import_react3.useState)(() => formatPhoneAsTyped(opts.defaultValue ?? "", country));
+  const [touched, setTouched] = (0, import_react3.useState)(false);
+  const parsed = (0, import_react3.useMemo)(() => parsePhone(value, country), [value, country]);
+  const onChange = (0, import_react3.useCallback)(
+    (event) => {
+      const next = formatPhoneAsTyped(event.target.value, country);
+      setValue(next);
+      onValueChange?.(parsePhone(next, country).e164);
+    },
+    [country, onValueChange]
+  );
+  const onBlur = (0, import_react3.useCallback)(
+    (_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 = (0, import_react3.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] = (0, import_react3.useState)(
+    () => 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__ */ (0, import_jsx_runtime3.jsx)(
+    "input",
+    {
+      ...rest,
+      ref,
+      type: "tel",
+      inputMode: "tel",
+      autoComplete: "tel",
+      value: shown,
+      onChange: handleChange
+    }
+  );
+});
+
+// src/factory.tsx
+var import_jsx_runtime4 = require("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(
@@ -1526,17 +1735,17 @@ function createTracking(options) {
       getVisitorId: () => ""
     };
     return {
-      TrackingProvider: ({ children }) => children,
+      TrackingProvider: ({ children }) => /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(PhoneConfigContext.Provider, { value: phone ?? null, children }),
       useTracking: () => noopClient
     };
   }
-  const TrackingContext = (0, import_react3.createContext)(null);
+  const TrackingContext = (0, import_react4.createContext)(null);
   const specificPageVisitConfig = triggers.automatic.specific_page_visit ?? null;
   const timeOnSiteConfig = triggers.automatic.time_on_site ?? null;
   function TrackingProvider({ children }) {
     const pathname = (0, import_navigation.usePathname)();
     const searchParams = (0, import_navigation.useSearchParams)();
-    const client = (0, import_react3.useMemo)(
+    const client = (0, import_react4.useMemo)(
       () => createTypedClient(
         getOrCreateTrackingClient({
           apiKey,
@@ -1554,7 +1763,7 @@ function createTracking(options) {
       ),
       []
     );
-    (0, import_react3.useEffect)(() => {
+    (0, import_react4.useEffect)(() => {
       const rawClient = getOrCreateTrackingClient({
         apiKey,
         endpoint,
@@ -1567,8 +1776,8 @@ function createTracking(options) {
       });
       fireManualPageView(rawClient);
     }, [pathname, searchParams]);
-    const firedPagesRef = (0, import_react3.useRef)(/* @__PURE__ */ new Set());
-    (0, import_react3.useEffect)(() => {
+    const firedPagesRef = (0, import_react4.useRef)(/* @__PURE__ */ new Set());
+    (0, import_react4.useEffect)(() => {
       if (!specificPageVisitConfig || pathname === null) return;
       const rawClient = getOrCreateTrackingClient({
         apiKey,
@@ -1593,7 +1802,7 @@ function createTracking(options) {
         });
       }
     }, [pathname]);
-    (0, import_react3.useEffect)(() => {
+    (0, import_react4.useEffect)(() => {
       const rawClient = getOrCreateTrackingClient({
         apiKey,
         endpoint,
@@ -1606,7 +1815,7 @@ function createTracking(options) {
       });
       return attachBfcacheRestore(rawClient);
     }, []);
-    (0, import_react3.useEffect)(() => {
+    (0, import_react4.useEffect)(() => {
       if (!timeOnSiteConfig) return;
       const rawClient = getOrCreateTrackingClient({
         apiKey,
@@ -1621,8 +1830,8 @@ function createTracking(options) {
       return attachTimeOnSite(rawClient, timeOnSiteConfig);
     }, []);
     const multiPageSessionConfig = triggers.automatic.multi_page_session ?? null;
-    const mpsLastPathRef = (0, import_react3.useRef)(null);
-    (0, import_react3.useEffect)(() => {
+    const mpsLastPathRef = (0, import_react4.useRef)(null);
+    (0, import_react4.useEffect)(() => {
       if (!multiPageSessionConfig || pathname === null) return;
       if (pathname === mpsLastPathRef.current) return;
       mpsLastPathRef.current = pathname;
@@ -1669,7 +1878,7 @@ function createTracking(options) {
       } catch {
       }
     }, [pathname]);
-    (0, import_react3.useEffect)(() => {
+    (0, import_react4.useEffect)(() => {
       const detachers = [];
       const rawClient = getOrCreateTrackingClient({
         apiKey,
@@ -1695,10 +1904,10 @@ function createTracking(options) {
         }
       };
     }, []);
-    return /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(TrackingContext.Provider, { value: client, children });
+    return /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(TrackingContext.Provider, { value: client, children: /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(PhoneConfigContext.Provider, { value: phone ?? null, children }) });
   }
   function useTracking() {
-    const client = (0, import_react3.useContext)(TrackingContext);
+    const client = (0, import_react4.useContext)(TrackingContext);
     if (client === null) {
       throw new Error(
         "useTracking must be called inside a <TrackingProvider> returned by createTracking()"
@@ -1712,7 +1921,10 @@ function createTracking(options) {
 0 && (module.exports = {
   AranovaApiError,
   ConsentBanner,
+  DEFAULT_PHONE_COUNTRY,
   GoogleAdsTracking,
+  PhoneConfigContext,
+  PhoneField,
   TRACKING_PARAM_KEYS,
   captureTrackingParamsFromLocation,
   createSalesClient,
@@ -1721,15 +1933,23 @@ function createTracking(options) {
   createTrackingEventCreatePayload,
   createTrackingSessionUpsertPayload,
   fetchServices,
+  formatDateInTz,
   formatMoney,
+  formatPhone,
+  formatPhoneAsTyped,
   fromMinor,
   getConsentState,
+  parsePhone,
+  phoneField,
   resetConsent,
   setConsentState,
+  toE164,
   toMinor,
   useConsent,
   useConsentState,
   useGclid,
+  usePhoneConfig,
+  usePhoneField,
   useTrackingParams
 });
 //# sourceMappingURL=index.js.map