@aranova/tracking-react 0.12.0 → 0.12.1

package/dist/index.d.mts

@@ -1,9 +1,10 @@
 import * as react from 'react';
 import { ReactNode, CSSProperties, InputHTMLAttributes, ChangeEvent, FocusEvent } from 'react';
-import { C as ConsentState, T as TrackingInstallSurface, a as TrackingEnvironment, b as TrackingClientContext, c as TrackingParams, d as TrackingEventCreatePayload, e as TrackingSessionUpsertPayload, F as FormSubmitConfig, f as FormSubmitMetadata, G as GtagEnvironmentMap, P as PhoneConfig, g as ParsedPhone, h as PhoneDisplayFormat } from './phone-utils-CVX7JmqB.mjs';
-export { D as DEFAULT_PHONE_COUNTRY, J as JsonValue, i as TrackedField, j as TrackingInitConfig, k as formatPhone, l as formatPhoneAsTyped, p as parsePhone, m as phoneField, t as toE164 } from './phone-utils-CVX7JmqB.mjs';
+import { C as ConsentState, T as TrackingInstallSurface, a as TrackingEnvironment, b as TrackingClientContext, c as TrackingParams, d as TrackingEventCreatePayload, e as TrackingSessionUpsertPayload, F as FormSubmitConfig, f as FormSubmitMetadata, G as GtagEnvironmentMap, P as PhoneConfig, g as ParsedPhone, h as PhoneDisplayFormat } from './phone-utils-DXAki8pO.mjs';
+export { D as DEFAULT_PHONE_COUNTRY, J as JsonValue, i as TrackedField, j as TrackingInitConfig, k as formSubmitConfigSchema, l as formSubmitMetadataSchema, m as formatPhone, n as formatPhoneAsTyped, o as jsonValueSchema, p as parsePhone, q as phoneField, t as toE164 } from './phone-utils-DXAki8pO.mjs';
 import * as src from 'src';
 import { z } from 'zod';
+export { AranovaApiError, BusinessConfig, BusinessConfigFeatures, BusinessConfigService, CompareTo, CurrencyRevenue, CustomerCurrencyDelta, CustomerCurrencyTotal, CustomerGetOptions, CustomerGetResult, CustomerKpis, CustomerKpisDeltas, CustomerKpisPrevious, CustomerListPage, CustomerListQuery, CustomerProfile, CustomerSegment, CustomerSegmentCount, CustomerSortField, CustomerSummary, CustomerSummaryQuery, DistinctCustomersByCurrency, Granularity, NAMED_RANGES, NamedRange, PublicServiceItem, SUPPORTED_CURRENCIES, Sale, SaleCursorPage, SaleFilters, SaleInput, SaleItem, SaleItemInput, SaleKeysetSortField, SaleListPage, SaleListQuery, SaleListQueryV2, SaleService, SaleServiceInput, SaleSortField, SaleSortOrder, SaleSummary, SaleSummaryPrevious, SaleSummaryQuery, SaleSummaryQueryV2, SaleSummaryV2, SaleUpdateInput, SalesBusinessClient, SalesCategoryBreakdown, SalesClient, SalesClientConfig, SalesCustomersClient, SalesServiceBreakdown, SalesTransportConfig, SalesTrendPoint, SummaryCurrencyDelta, SummaryDeltas, SummaryWindow, SupportedCurrency, TRACKING_RANGES, TrackingOverviewRange, createSalesClient, fetchServices, formatDateInTz, formatMoney, fromMinor, saleCreateSchema, saleItemSchema, saleServiceSchema, saleUpdateSchema, salesRequest, toMinor } from './sales.mjs';
 import { CountryCode } from 'libphonenumber-js';
 export { CountryCode } from 'libphonenumber-js';
 
@@ -60,11 +61,11 @@ interface ConsentBannerProps {
     onAccept?: () => void;
     onDecline?: () => void;
     /** Where the banner docks. Default: `"bottom"`. */
-    position?: 'top' | 'bottom';
+    position?: "top" | "bottom";
     /**
      * Visual theme. `"auto"` follows `prefers-color-scheme`. Default: `"light"`.
      */
-    theme?: 'light' | 'dark' | 'auto';
+    theme?: "light" | "dark" | "auto";
     /** Class added to the outer wrapper for additional styling hooks. */
     className?: string;
     /** Inline style overrides applied to the outer wrapper after the defaults. */
@@ -75,7 +76,7 @@ declare function ConsentBanner({ message, title, acceptLabel, declineLabel, poli
 /**
  * Google Consent Mode value sent to `gtag('consent', 'update', ...)`.
  */
-type GtagConsentValue = 'granted' | 'denied';
+type GtagConsentValue = "granted" | "denied";
 /**
  * Read the persisted visitor consent state from localStorage.
  *
@@ -192,6 +193,19 @@ type CtaClickMetadata = z.infer<typeof ctaClickMetadataSchema>;
 declare const ctaClickConfigSchema: z.ZodObject<{}, "strict", z.ZodTypeAny, {}, {}>;
 type CtaClickConfig = z.infer<typeof ctaClickConfigSchema>;
 
+/**
+ * Registered trigger names reported by the SDK heartbeat.
+ */
+declare const sdkHeartbeatTriggersSchema: z.ZodObject<{
+    automatic: z.ZodArray<z.ZodString, "many">;
+    manual: z.ZodArray<z.ZodString, "many">;
+}, "strict", z.ZodTypeAny, {
+    automatic: string[];
+    manual: string[];
+}, {
+    automatic: string[];
+    manual: string[];
+}>;
 /**
  * Metadata for the SDK-internal `sdk_heartbeat` event.
  *
@@ -494,6 +508,7 @@ type ScrollDepthConfig = z.infer<typeof scrollDepthConfigSchema>;
  */
 declare const SPECIFIC_PAGE_NAMES: readonly ["contact_page", "about_page", "services_page", "booking_page", "location_page", "pricing_page", "faq_page", "testimonials_page"];
 type SpecificPageName = (typeof SPECIFIC_PAGE_NAMES)[number];
+declare const specificPageNameSchema: z.ZodEnum<["contact_page", "about_page", "services_page", "booking_page", "location_page", "pricing_page", "faq_page", "testimonials_page"]>;
 /**
  * Metadata for the automatic `specific_page_visit` event.
  *
@@ -590,6 +605,7 @@ declare const timeOnSiteConfigSchema: z.ZodObject<{
 }>;
 type TimeOnSiteConfig = z.infer<typeof timeOnSiteConfigSchema>;
 
+type EventKind = "automatic" | "manual";
 declare const EVENT_REGISTRY: {
     readonly page_view: {
         readonly kind: "automatic";
@@ -1016,13 +1032,13 @@ type EventName = keyof typeof EVENT_REGISTRY;
  * Automatic events are not accepted by the typed `trackEvent()` API.
  */
 type AutomaticEventName = {
-    [K in EventName]: (typeof EVENT_REGISTRY)[K]['kind'] extends 'automatic' ? K : never;
+    [K in EventName]: (typeof EVENT_REGISTRY)[K]["kind"] extends "automatic" ? K : never;
 }[EventName];
 /**
  * Event names that consumer code can fire manually after registering them.
  */
 type ManualEventName = {
-    [K in EventName]: (typeof EVENT_REGISTRY)[K]['kind'] extends 'manual' ? K : never;
+    [K in EventName]: (typeof EVENT_REGISTRY)[K]["kind"] extends "manual" ? K : never;
 }[EventName];
 type MetadataByName = {
     page_view: PageViewMetadata;
@@ -1061,6 +1077,14 @@ type EventMetadata<K extends EventName> = MetadataByName[K];
  * Trigger registration config type for a specific tracking event.
  */
 type EventConfig<K extends EventName> = ConfigByName[K];
+/**
+ * Runtime list of automatic event names.
+ */
+declare const ALL_AUTOMATIC_EVENT_NAMES: readonly AutomaticEventName[];
+/**
+ * Runtime list of manual event names.
+ */
+declare const ALL_MANUAL_EVENT_NAMES: readonly ManualEventName[];
 /**
  * Trigger registry passed to `createTracking({ triggers })`.
  *
@@ -1088,18 +1112,18 @@ type EventConfig<K extends EventName> = ConfigByName[K];
  */
 type TriggerRegistryConfig = {
     automatic: {
-        page_view: EventConfig<'page_view'>;
+        page_view: EventConfig<"page_view">;
     } & Partial<{
-        time_on_site: EventConfig<'time_on_site'>;
-        specific_page_visit: EventConfig<'specific_page_visit'>;
-        scroll_depth: EventConfig<'scroll_depth'>;
-        multi_page_session: EventConfig<'multi_page_session'>;
-        form_start: EventConfig<'form_start'>;
+        time_on_site: EventConfig<"time_on_site">;
+        specific_page_visit: EventConfig<"specific_page_visit">;
+        scroll_depth: EventConfig<"scroll_depth">;
+        multi_page_session: EventConfig<"multi_page_session">;
+        form_start: EventConfig<"form_start">;
     }>;
     manual?: Partial<{
-        form_submit: EventConfig<'form_submit'>;
-        phone_click: EventConfig<'phone_click'>;
-        cta_click: EventConfig<'cta_click'>;
+        form_submit: EventConfig<"form_submit">;
+        phone_click: EventConfig<"phone_click">;
+        cta_click: EventConfig<"cta_click">;
     }>;
 };
 /**
@@ -1108,11 +1132,25 @@ type TriggerRegistryConfig = {
  * Used by `TypedTrackingClient` so `trackEvent()` only accepts events the
  * consumer explicitly enabled.
  */
-type RegisteredManualEvents<TRegistry extends TriggerRegistryConfig> = Extract<keyof NonNullable<TRegistry['manual']>, ManualEventName>;
+type RegisteredManualEvents<TRegistry extends TriggerRegistryConfig> = Extract<keyof NonNullable<TRegistry["manual"]>, ManualEventName>;
 /**
  * Automatic event names registered in a concrete trigger registry.
  */
-type RegisteredAutomaticEvents<TRegistry extends TriggerRegistryConfig> = Extract<keyof TRegistry['automatic'], AutomaticEventName>;
+type RegisteredAutomaticEvents<TRegistry extends TriggerRegistryConfig> = Extract<keyof TRegistry["automatic"], AutomaticEventName>;
+/**
+ * Discriminated union of valid manual tracking calls for a registry.
+ */
+type TrackableEvent<TRegistry extends TriggerRegistryConfig> = {
+    [K in RegisteredManualEvents<TRegistry>]: {
+        eventType: K;
+        metadata: EventMetadata<K>;
+    };
+}[RegisteredManualEvents<TRegistry>];
+declare function getEventDefinition(name: EventName): {
+    kind: EventKind;
+    metadataSchema: z.ZodTypeAny;
+    configSchema: z.ZodTypeAny;
+};
 
 /**
  * Input accepted by the low-level stringly-typed client.
@@ -1190,775 +1228,6 @@ interface TypedTrackingClient<TRegistry extends TriggerRegistryConfig> {
     getVisitorId(): string;
 }
 
-/**
- * Sales / Conversions wire schemas — the client-side source of truth.
- *
- * `saleCreateSchema` is mirrored by `SaleCreateSchema` in
- * `apps/api/src/schemas/tracking_sales.py` and enforced by the backend drift
- * test (the `resources` section of `events.schema.json`). Keep them in lockstep.
- *
- * Money is **integer minor units (cents)**; `quantity` is a decimal string;
- * `currency` is the required `SupportedCurrency` enum.
- */
-declare const SUPPORTED_CURRENCIES: readonly ["USD", "CAD"];
-type SupportedCurrency = (typeof SUPPORTED_CURRENCIES)[number];
-declare const TRACKING_ENVIRONMENTS: readonly ["production", "development"];
-declare const saleItemSchema: z.ZodObject<{
-    external_item_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    category: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    quantity: z.ZodString;
-    unit_price_cents: z.ZodNumber;
-    unit_cost_cents: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
-}, "strict", z.ZodTypeAny, {
-    quantity: string;
-    unit_price_cents: number;
-    name?: string | null | undefined;
-    external_item_id?: string | null | undefined;
-    category?: string | null | undefined;
-    unit_cost_cents?: number | null | undefined;
-}, {
-    quantity: string;
-    unit_price_cents: number;
-    name?: string | null | undefined;
-    external_item_id?: string | null | undefined;
-    category?: string | null | undefined;
-    unit_cost_cents?: number | null | undefined;
-}>;
-declare const saleServiceSchema: z.ZodObject<{
-    service: z.ZodString;
-    amount_cents: z.ZodNumber;
-}, "strict", z.ZodTypeAny, {
-    service: string;
-    amount_cents: number;
-}, {
-    service: string;
-    amount_cents: number;
-}>;
-declare const saleCreateSchema: z.ZodEffects<z.ZodObject<{
-    external_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    service: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    services: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
-        service: z.ZodString;
-        amount_cents: z.ZodNumber;
-    }, "strict", z.ZodTypeAny, {
-        service: string;
-        amount_cents: number;
-    }, {
-        service: string;
-        amount_cents: number;
-    }>, "many">>>;
-    currency: z.ZodEnum<["USD", "CAD"]>;
-    amount_total_cents: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
-    occurred_at: z.ZodString;
-    environment: z.ZodDefault<z.ZodEnum<["production", "development"]>>;
-    items: z.ZodDefault<z.ZodArray<z.ZodObject<{
-        external_item_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-        name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-        category: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-        quantity: z.ZodString;
-        unit_price_cents: z.ZodNumber;
-        unit_cost_cents: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
-    }, "strict", z.ZodTypeAny, {
-        quantity: string;
-        unit_price_cents: number;
-        name?: string | null | undefined;
-        external_item_id?: string | null | undefined;
-        category?: string | null | undefined;
-        unit_cost_cents?: number | null | undefined;
-    }, {
-        quantity: string;
-        unit_price_cents: number;
-        name?: string | null | undefined;
-        external_item_id?: string | null | undefined;
-        category?: string | null | undefined;
-        unit_cost_cents?: number | null | undefined;
-    }>, "many">>;
-    metadata: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
-    customer_name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    customer_phone: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    customer_email: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-}, "strict", z.ZodTypeAny, {
-    currency: "USD" | "CAD";
-    occurred_at: string;
-    environment: "production" | "development";
-    items: {
-        quantity: string;
-        unit_price_cents: number;
-        name?: string | null | undefined;
-        external_item_id?: string | null | undefined;
-        category?: string | null | undefined;
-        unit_cost_cents?: number | null | undefined;
-    }[];
-    metadata?: Record<string, unknown> | null | undefined;
-    service?: string | null | undefined;
-    services?: {
-        service: string;
-        amount_cents: number;
-    }[] | null | undefined;
-    amount_total_cents?: number | null | undefined;
-    external_id?: string | null | undefined;
-    description?: string | null | undefined;
-    customer_name?: string | null | undefined;
-    customer_phone?: string | null | undefined;
-    customer_email?: string | null | undefined;
-}, {
-    currency: "USD" | "CAD";
-    occurred_at: string;
-    metadata?: Record<string, unknown> | null | undefined;
-    service?: string | null | undefined;
-    services?: {
-        service: string;
-        amount_cents: number;
-    }[] | null | undefined;
-    amount_total_cents?: number | null | undefined;
-    external_id?: string | null | undefined;
-    description?: string | null | undefined;
-    environment?: "production" | "development" | undefined;
-    items?: {
-        quantity: string;
-        unit_price_cents: number;
-        name?: string | null | undefined;
-        external_item_id?: string | null | undefined;
-        category?: string | null | undefined;
-        unit_cost_cents?: number | null | undefined;
-    }[] | undefined;
-    customer_name?: string | null | undefined;
-    customer_phone?: string | null | undefined;
-    customer_email?: string | null | undefined;
-}>, {
-    currency: "USD" | "CAD";
-    occurred_at: string;
-    environment: "production" | "development";
-    items: {
-        quantity: string;
-        unit_price_cents: number;
-        name?: string | null | undefined;
-        external_item_id?: string | null | undefined;
-        category?: string | null | undefined;
-        unit_cost_cents?: number | null | undefined;
-    }[];
-    metadata?: Record<string, unknown> | null | undefined;
-    service?: string | null | undefined;
-    services?: {
-        service: string;
-        amount_cents: number;
-    }[] | null | undefined;
-    amount_total_cents?: number | null | undefined;
-    external_id?: string | null | undefined;
-    description?: string | null | undefined;
-    customer_name?: string | null | undefined;
-    customer_phone?: string | null | undefined;
-    customer_email?: string | null | undefined;
-}, {
-    currency: "USD" | "CAD";
-    occurred_at: string;
-    metadata?: Record<string, unknown> | null | undefined;
-    service?: string | null | undefined;
-    services?: {
-        service: string;
-        amount_cents: number;
-    }[] | null | undefined;
-    amount_total_cents?: number | null | undefined;
-    external_id?: string | null | undefined;
-    description?: string | null | undefined;
-    environment?: "production" | "development" | undefined;
-    items?: {
-        quantity: string;
-        unit_price_cents: number;
-        name?: string | null | undefined;
-        external_item_id?: string | null | undefined;
-        category?: string | null | undefined;
-        unit_cost_cents?: number | null | undefined;
-    }[] | undefined;
-    customer_name?: string | null | undefined;
-    customer_phone?: string | null | undefined;
-    customer_email?: string | null | undefined;
-}>;
-declare const saleUpdateSchema: z.ZodEffects<z.ZodObject<{
-    description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    service: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    services: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
-        service: z.ZodString;
-        amount_cents: z.ZodNumber;
-    }, "strict", z.ZodTypeAny, {
-        service: string;
-        amount_cents: number;
-    }, {
-        service: string;
-        amount_cents: number;
-    }>, "many">>>;
-    currency: z.ZodOptional<z.ZodEnum<["USD", "CAD"]>>;
-    amount_total_cents: z.ZodOptional<z.ZodNumber>;
-    occurred_at: z.ZodOptional<z.ZodString>;
-    items: z.ZodOptional<z.ZodArray<z.ZodObject<{
-        external_item_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-        name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-        category: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-        quantity: z.ZodString;
-        unit_price_cents: z.ZodNumber;
-        unit_cost_cents: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
-    }, "strict", z.ZodTypeAny, {
-        quantity: string;
-        unit_price_cents: number;
-        name?: string | null | undefined;
-        external_item_id?: string | null | undefined;
-        category?: string | null | undefined;
-        unit_cost_cents?: number | null | undefined;
-    }, {
-        quantity: string;
-        unit_price_cents: number;
-        name?: string | null | undefined;
-        external_item_id?: string | null | undefined;
-        category?: string | null | undefined;
-        unit_cost_cents?: number | null | undefined;
-    }>, "many">>;
-    metadata: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
-    customer_name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    customer_phone: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    customer_email: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-}, "strict", z.ZodTypeAny, {
-    metadata?: Record<string, unknown> | null | undefined;
-    service?: string | null | undefined;
-    services?: {
-        service: string;
-        amount_cents: number;
-    }[] | null | undefined;
-    amount_total_cents?: number | undefined;
-    description?: string | null | undefined;
-    currency?: "USD" | "CAD" | undefined;
-    occurred_at?: string | undefined;
-    items?: {
-        quantity: string;
-        unit_price_cents: number;
-        name?: string | null | undefined;
-        external_item_id?: string | null | undefined;
-        category?: string | null | undefined;
-        unit_cost_cents?: number | null | undefined;
-    }[] | undefined;
-    customer_name?: string | null | undefined;
-    customer_phone?: string | null | undefined;
-    customer_email?: string | null | undefined;
-}, {
-    metadata?: Record<string, unknown> | null | undefined;
-    service?: string | null | undefined;
-    services?: {
-        service: string;
-        amount_cents: number;
-    }[] | null | undefined;
-    amount_total_cents?: number | undefined;
-    description?: string | null | undefined;
-    currency?: "USD" | "CAD" | undefined;
-    occurred_at?: string | undefined;
-    items?: {
-        quantity: string;
-        unit_price_cents: number;
-        name?: string | null | undefined;
-        external_item_id?: string | null | undefined;
-        category?: string | null | undefined;
-        unit_cost_cents?: number | null | undefined;
-    }[] | undefined;
-    customer_name?: string | null | undefined;
-    customer_phone?: string | null | undefined;
-    customer_email?: string | null | undefined;
-}>, {
-    metadata?: Record<string, unknown> | null | undefined;
-    service?: string | null | undefined;
-    services?: {
-        service: string;
-        amount_cents: number;
-    }[] | null | undefined;
-    amount_total_cents?: number | undefined;
-    description?: string | null | undefined;
-    currency?: "USD" | "CAD" | undefined;
-    occurred_at?: string | undefined;
-    items?: {
-        quantity: string;
-        unit_price_cents: number;
-        name?: string | null | undefined;
-        external_item_id?: string | null | undefined;
-        category?: string | null | undefined;
-        unit_cost_cents?: number | null | undefined;
-    }[] | undefined;
-    customer_name?: string | null | undefined;
-    customer_phone?: string | null | undefined;
-    customer_email?: string | null | undefined;
-}, {
-    metadata?: Record<string, unknown> | null | undefined;
-    service?: string | null | undefined;
-    services?: {
-        service: string;
-        amount_cents: number;
-    }[] | null | undefined;
-    amount_total_cents?: number | undefined;
-    description?: string | null | undefined;
-    currency?: "USD" | "CAD" | undefined;
-    occurred_at?: string | undefined;
-    items?: {
-        quantity: string;
-        unit_price_cents: number;
-        name?: string | null | undefined;
-        external_item_id?: string | null | undefined;
-        category?: string | null | undefined;
-        unit_cost_cents?: number | null | undefined;
-    }[] | undefined;
-    customer_name?: string | null | undefined;
-    customer_phone?: string | null | undefined;
-    customer_email?: string | null | undefined;
-}>;
-type SaleItemInput = z.input<typeof saleItemSchema>;
-type SaleServiceInput = z.input<typeof saleServiceSchema>;
-type SaleInput = z.input<typeof saleCreateSchema>;
-type SaleUpdateInput = z.input<typeof saleUpdateSchema>;
-interface SaleItem {
-    id: string;
-    external_item_id: string | null;
-    name: string | null;
-    category: string | null;
-    quantity: string;
-    unit_price_cents: number;
-    unit_cost_cents: number | null;
-}
-interface SaleService {
-    id: string;
-    service_id: string;
-    service_key: string;
-    service_label: string;
-    amount_cents: number;
-}
-interface Sale {
-    id: string;
-    business_id: string;
-    business_name?: string | null;
-    external_id: string | null;
-    currency: SupportedCurrency;
-    amount_total_cents: number;
-    description: string | null;
-    service_id: string | null;
-    service_key?: string | null;
-    service_label?: string | null;
-    services: SaleService[];
-    occurred_at: string;
-    environment: (typeof TRACKING_ENVIRONMENTS)[number];
-    metadata: Record<string, unknown> | null;
-    customer_name: string | null;
-    customer_phone: string | null;
-    customer_email: string | null;
-    created_at: string;
-    updated_at: string;
-    items: SaleItem[];
-}
-interface SaleListPage {
-    items: Sale[];
-    total: number;
-}
-interface SaleCursorPage {
-    items: Sale[];
-    next_cursor: string | null;
-    /** Populated only when `want_total` was requested (a single indexed COUNT). */
-    total_count?: number;
-    has_more?: boolean;
-}
-type SaleSortOrder = 'asc' | 'desc';
-/**
- * Comprehensive filter shape mirrored from the backend's `SaleQueryFilters`.
- *
- * `search` runs case-insensitively across `customer_name`, `customer_phone`,
- * `customer_email`, `description`, and `external_id` — the human-facing
- * columns. `service_id` is the resolved per-business service UUID (different
- * from the create-time `service` *key*).
- */
-interface SaleFilters {
-    business_id?: string;
-    external_id?: string;
-    service_id?: string;
-    /** E.164 phone — the canonical customer key; filters sales for one customer. */
-    customer_phone?: string;
-    currency?: SupportedCurrency;
-    environment?: (typeof TRACKING_ENVIRONMENTS)[number];
-    since?: string;
-    until?: string;
-    min_amount_cents?: number;
-    max_amount_cents?: number;
-    search?: string;
-}
-/**
- * Full query input for `SalesClient.list()` — filters + pagination.
- *
- * Pagination is **keyset (cursor)**: `next_cursor` returned by one page is
- * passed back as `cursor` on the next. `null` / undefined cursor = first page.
- *
- * Ordering on this endpoint is fixed at **`occurred_at DESC, id DESC`** — the
- * cursor encodes a position in that index, so a different sort would
- * invalidate cursors mid-pagination. For ad-hoc sorted reads use the
- * dashboard admin endpoint, which is offset-paginated.
- */
-interface SaleListQuery extends SaleFilters {
-    limit?: number;
-    cursor?: string | null;
-}
-/** Keyset-safe sort columns (NOT-NULL, indexed). */
-type SaleKeysetSortField = 'occurred_at' | 'created_at' | 'amount_total_cents';
-/** v2 list query — adds server sort + opt-in total. */
-interface SaleListQueryV2 extends SaleListQuery {
-    sort?: SaleKeysetSortField;
-    order?: SaleSortOrder;
-    /** Opt-in: a single indexed COUNT over the filtered set. */
-    want_total?: boolean;
-}
-declare const TRACKING_RANGES: readonly ["24h", "7d", "30d"];
-type TrackingOverviewRange = (typeof TRACKING_RANGES)[number];
-/** Query input for `SalesClient.summary()` — filters + range + options. */
-interface SaleSummaryQuery extends SaleFilters {
-    range: TrackingOverviewRange;
-    /** Include the per-category line-item breakdown (extra join; default false). */
-    include_categories?: boolean;
-    /** Surface soft-deleted services individually (flagged "(deleted)") instead of
-     * rolling them into a single "Deleted services" bucket. Default false. */
-    include_deleted_services?: boolean;
-    /** Cap on the by-service / by-category rows (1–50, default 10). */
-    top_n?: number;
-}
-interface CurrencyRevenue {
-    currency: SupportedCurrency;
-    sale_count: number;
-    revenue_cents: number;
-    average_order_value_cents: number;
-}
-interface SalesServiceBreakdown {
-    service_id: string | null;
-    service_key: string | null;
-    /** "Unassigned" when the sale has no service. */
-    service_label: string | null;
-    currency: SupportedCurrency;
-    sale_count: number;
-    revenue_cents: number;
-}
-interface SalesCategoryBreakdown {
-    category: string | null;
-    currency: SupportedCurrency;
-    /** sum(unit_price_cents * quantity) — advisory, not authoritative. */
-    revenue_cents: number;
-    /** Decimal string. */
-    quantity: string;
-}
-interface SalesTrendPoint {
-    bucket_start: string;
-    currency: SupportedCurrency;
-    sale_count: number;
-    revenue_cents: number;
-}
-interface SaleSummary {
-    range: TrackingOverviewRange;
-    business_id: string | null;
-    metrics: {
-        sale_count: number;
-        distinct_customers: number;
-        by_currency: CurrencyRevenue[];
-    };
-    by_service: SalesServiceBreakdown[];
-    by_currency: CurrencyRevenue[];
-    by_category: SalesCategoryBreakdown[];
-    series: SalesTrendPoint[];
-}
-declare const NAMED_RANGES: readonly ["today", "yesterday", "wtd", "mtd", "qtd", "ytd", "24h", "7d", "30d", "90d", "custom"];
-/** Superset of `TrackingOverviewRange` (`24h`/`7d`/`30d` stay valid). */
-type NamedRange = (typeof NAMED_RANGES)[number];
-type Granularity = 'hour' | 'day' | 'week' | 'month' | 'auto';
-type CompareTo = 'previous_period' | 'previous_year' | 'none';
-interface DistinctCustomersByCurrency {
-    currency: SupportedCurrency;
-    distinct_customers: number;
-}
-interface SummaryWindow {
-    since: string;
-    until: string;
-}
-interface SummaryCurrencyDelta {
-    currency: SupportedCurrency;
-    revenue_cents_delta: number;
-    /** Ratio (0.12 = +12%); null when previous revenue was 0. */
-    revenue_pct_delta: number | null;
-    sale_count_delta: number;
-}
-interface SummaryDeltas {
-    by_currency: SummaryCurrencyDelta[];
-    sale_count_delta: number;
-    distinct_customers_delta: number;
-}
-interface SaleSummaryPrevious {
-    window: SummaryWindow;
-    metrics: SaleSummaryV2['metrics'];
-    by_currency: CurrencyRevenue[];
-    series: SalesTrendPoint[];
-}
-/** Query input for `SalesClient.summary()` v2 — widened range + tz/compare options. */
-interface SaleSummaryQueryV2 extends SaleFilters {
-    range?: NamedRange;
-    /** Required when `range === 'custom'`. */
-    since?: string;
-    until?: string;
-    /** IANA tz, e.g. `America/Toronto`. Default = business tz. */
-    timezone?: string;
-    granularity?: Granularity;
-    compare_to?: CompareTo;
-    include_categories?: boolean;
-    include_deleted_services?: boolean;
-    top_n?: number;
-}
-/** Superset of `SaleSummary` (assignable to it). */
-interface SaleSummaryV2 extends Omit<SaleSummary, 'range' | 'metrics'> {
-    range: NamedRange;
-    metrics: SaleSummary['metrics'] & {
-        distinct_customers_by_currency: DistinctCustomersByCurrency[];
-    };
-    timezone: string | null;
-    window: SummaryWindow | null;
-    granularity: string | null;
-    previous: SaleSummaryPrevious | null;
-    deltas: SummaryDeltas | null;
-}
-type CustomerSegment = 'new' | 'returning' | 'repeat' | 'lapsed';
-type CustomerSortField = 'total_spent' | 'last_purchase' | 'purchases' | 'first_purchase';
-interface CustomerCurrencyTotal {
-    currency: SupportedCurrency;
-    revenue_cents: number;
-    sale_count: number;
-    average_order_value_cents: number;
-}
-interface CustomerSummary {
-    /** The E.164 phone — the canonical customer id. */
-    customer_id: string;
-    display_name: string | null;
-    email: string | null;
-    phone: string;
-    first_purchase_at: string;
-    last_purchase_at: string;
-    purchase_count: number;
-    segment: CustomerSegment;
-    totals: CustomerCurrencyTotal[];
-}
-type CustomerProfile = CustomerSummary;
-interface CustomerListQuery extends Omit<SaleFilters, 'external_id'> {
-    segment?: CustomerSegment;
-    sort?: CustomerSortField;
-    order?: SaleSortOrder;
-    cursor?: string | null;
-    limit?: number;
-    want_total?: boolean;
-}
-interface CustomerListPage {
-    items: CustomerSummary[];
-    next_cursor: string | null;
-    total_count: number | null;
-}
-interface CustomerGetOptions {
-    include_sales?: boolean;
-    limit?: number;
-    cursor?: string | null;
-}
-interface CustomerGetResult {
-    customer: CustomerProfile;
-    /** Present only when `include_sales: true` (and a business-scoped key). */
-    sales?: SaleCursorPage | null;
-}
-interface CustomerSummaryQuery extends SaleFilters {
-    range?: NamedRange;
-    since?: string;
-    until?: string;
-    timezone?: string;
-    compare_to?: CompareTo;
-}
-interface CustomerSegmentCount {
-    segment: CustomerSegment;
-    count: number;
-}
-interface CustomerCurrencyDelta {
-    currency: SupportedCurrency;
-    revenue_cents_delta: number;
-    /** Ratio (0.12 = +12%); null when previous revenue was 0. */
-    revenue_pct_delta: number | null;
-}
-interface CustomerKpisDeltas {
-    total_customers_delta: number;
-    new_customers_delta: number;
-    returning_customers_delta: number;
-    repeat_rate_delta: number;
-    ltv_by_currency: CustomerCurrencyDelta[];
-}
-interface CustomerKpisPrevious {
-    window_since: string;
-    window_until: string;
-    total_customers: number;
-    new_customers: number;
-    returning_customers: number;
-    repeat_rate: number;
-    ltv_by_currency: CustomerCurrencyTotal[];
-}
-interface CustomerKpis {
-    range: NamedRange;
-    timezone: string;
-    window_since: string;
-    window_until: string;
-    total_customers: number;
-    new_customers: number;
-    returning_customers: number;
-    repeat_rate: number;
-    by_segment: CustomerSegmentCount[];
-    ltv_by_currency: CustomerCurrencyTotal[];
-    /** Present only when `compare_to` is set. */
-    previous?: CustomerKpisPrevious | null;
-    deltas?: CustomerKpisDeltas | null;
-}
-interface BusinessConfigService {
-    key: string;
-    label: string;
-    archived: boolean;
-}
-interface BusinessConfigFeatures {
-    customers: boolean;
-    comparisons: boolean;
-    retention: boolean;
-}
-interface BusinessConfig {
-    business_id: string;
-    display_name: string;
-    timezone: string;
-    primary_currency: SupportedCurrency;
-    currencies: SupportedCurrency[];
-    default_phone_country: string | null;
-    services: BusinessConfigService[];
-    features: BusinessConfigFeatures;
-}
-
-/** Shared config for every sales HTTP helper. */
-interface SalesTransportConfig {
-    /** Public (`aranv_pk_…`) or secret (`aranv_sk_…`) API key. */
-    apiKey: string;
-    /**
-     * Base tracking endpoint, e.g. `https://aranovainternal-production.up.railway.app/tracking`.
-     * The `/sales` path is appended by the helpers.
-     */
-    endpoint: string;
-    /** Optional SDK identity headers (mirrors the event ingest client). */
-    sdkVersion?: string;
-    packageName?: string;
-    surface?: string;
-    environment?: string;
-}
-
-/** Config for {@link createSalesClient}. */
-interface SalesClientConfig extends SalesTransportConfig {
-    /** Applied when an individual `record()` call omits `currency`. */
-    defaultCurrency?: SupportedCurrency;
-}
-/** Phone-keyed customer rollups (sk-only; a public key gets a `403`). */
-interface SalesCustomersClient {
-    list(query?: CustomerListQuery): Promise<CustomerListPage>;
-    /** `id` is the customer's E.164 phone. */
-    get(id: string, options?: CustomerGetOptions): Promise<CustomerGetResult>;
-    summary(query?: CustomerSummaryQuery): Promise<CustomerKpis>;
-}
-/** Business config (low-sensitivity — accepts a public or secret key). */
-interface SalesBusinessClient {
-    config(): Promise<BusinessConfig>;
-}
-/**
- * One isomorphic sales client — what a key may *do* is enforced by the backend,
- * not by hiding methods. A **public** key (`aranv_pk_…`) may `record` (the
- * backend rejects reads/CRUD from it with a `403`); a **secret** key
- * (`aranv_sk_…`), used **server-side only**, gets full read/list/update/delete.
- * Never ship a secret key in a browser bundle.
- *
- * Generic over the service-key union `TService`: bind the type emitted by
- * `@aranova/tracking-cli gen` for compile-time-checked `service` values.
- */
-interface SalesClient<TService extends string = string> {
-    record(input: Omit<SaleInput, 'currency' | 'occurred_at' | 'service' | 'services'> & {
-        service?: TService | null;
-        services?: Array<{
-            service: TService;
-            amount_cents: number;
-        }>;
-        currency?: SupportedCurrency;
-        occurred_at?: string;
-    }): Promise<Sale>;
-    /** Keyset list with optional server sort + opt-in `total_count`. */
-    list(query?: SaleListQueryV2): Promise<SaleCursorPage>;
-    /**
-     * Currency-grouped aggregations for the key's business. Additive v2 options:
-     * calendar/custom ranges, IANA `timezone`, `granularity`, and `compare_to`.
-     * Legacy `24h/7d/30d` keep their exact prior numbers. Secret key only.
-     */
-    summary(query: SaleSummaryQueryV2): Promise<SaleSummaryV2>;
-    get(id: string): Promise<Sale>;
-    update(id: string, patch: Omit<SaleUpdateInput, 'service' | 'services'> & {
-        service?: TService | null;
-        services?: Array<{
-            service: TService;
-            amount_cents: number;
-        }>;
-    }): Promise<Sale>;
-    delete(id: string): Promise<void>;
-    /** Phone-keyed customer rollups (sk-only). */
-    customers: SalesCustomersClient;
-    /** Business config (pk or sk). */
-    business: SalesBusinessClient;
-}
-declare function createSalesClient<TService extends string = string>(config: SalesClientConfig): SalesClient<TService>;
-
-/** A business's active service, as returned by `GET /tracking/services`. */
-interface PublicServiceItem {
-    key: string;
-    label: string;
-}
-/**
- * Fetch the caller's business's active service taxonomy. Accepts a public or
- * secret key (the taxonomy is low-sensitivity category names). Powers the
- * `@aranova/tracking-cli gen` codegen.
- */
-declare function fetchServices(config: SalesTransportConfig): Promise<PublicServiceItem[]>;
-
-/**
- * Convert a major amount (dollars `250.5`) to integer minor units (`25050`).
- *
- * Convenience only — the wire is always integer cents. Uses float multiply +
- * `Math.round`, so values that aren't exactly representable in binary float
- * (e.g. `1.005`) can round to the neighbouring cent. If you already hold an
- * exact cents integer, pass it straight through and skip this helper.
- */
-declare function toMinor(amount: number, currency: SupportedCurrency): number;
-/** Convert integer minor units (`25050`) to a major amount (`250.5`). */
-declare function fromMinor(cents: number, currency: SupportedCurrency): number;
-/**
- * Format integer minor units as a localized currency string (e.g. `"$250.50"`).
- * Uses the built-in `Intl.NumberFormat` — no extra dependency.
- */
-declare function formatMoney(cents: number, currency: SupportedCurrency, locale?: string): string;
-/**
- * Format an ISO timestamp in a specific IANA time zone (e.g. `America/Toronto`),
- * so dashboards stop hand-rolling `Intl`. Defaults to a short date-time; pass
- * `opts` to override fields. The `timeZone` is always forced to the argument.
- */
-declare function formatDateInTz(iso: string, timeZone: string, opts?: Intl.DateTimeFormatOptions, locale?: string): string;
-
-/**
- * Error thrown by the sales client (`createSalesClient`) on a
- * non-2xx response. Unlike the fire-and-forget event queue (which swallows
- * failures), a sale is a transaction the caller must be able to react to.
- */
-declare class AranovaApiError extends Error {
-    readonly status: number;
-    readonly code: string | undefined;
-    readonly requestId: string | undefined;
-    constructor(message: string, options: {
-        status: number;
-        code?: string;
-        requestId?: string;
-    });
-}
-
 /**
  * Props for the Google Ads tracking component.
  *
@@ -2110,16 +1379,6 @@ interface CreateTrackingResult<TRegistry extends TriggerRegistryConfig> {
 }
 declare function createTracking<TRegistry extends TriggerRegistryConfig>(options: CreateTrackingOptions<TRegistry>): CreateTrackingResult<TRegistry>;
 
-/** Carries `createTracking({ phone })` config to `usePhoneField`. Separate from the
- *  tracking client context so `useTracking()`'s type is untouched.
- *
- *  Caveat: this module is bundled into BOTH `@aranova/tracking-react` and
- *  `@aranova/tracking-next`, so each package has its own context instance at
- *  runtime. Within one installed package the provider + hook share it (correct);
- *  mixing `createTracking` from one package with `usePhoneField` from the other
- *  won't share config (the hook falls back to the `CA`/`national` defaults). Use a
- *  single tracking package per app. */
-declare const PhoneConfigContext: react.Context<PhoneConfig | null>;
 /** Resolve the effective phone config (provider value or built-in defaults). */
 declare function usePhoneConfig(): {
     defaultCountry: CountryCode;
@@ -2138,9 +1397,9 @@ interface PhoneInputProps {
     value: string;
     onChange: (event: ChangeEvent<HTMLInputElement>) => void;
     onBlur: (event: FocusEvent<HTMLInputElement>) => void;
-    type: 'tel';
-    inputMode: 'tel';
-    autoComplete: 'tel';
+    type: "tel";
+    inputMode: "tel";
+    autoComplete: "tel";
 }
 interface PhoneFieldApi {
     /** Display value for the `<input>` (live `AsYouType` while typing). */
@@ -2156,7 +1415,7 @@ interface PhoneFieldApi {
 }
 /** Headless phone field — the client owns the markup. */
 declare function usePhoneField(opts?: UsePhoneFieldOptions): PhoneFieldApi;
-interface PhoneFieldProps extends Omit<InputHTMLAttributes<HTMLInputElement>, 'type' | 'value' | 'onChange'> {
+interface PhoneFieldProps extends Omit<InputHTMLAttributes<HTMLInputElement>, "type" | "value" | "onChange"> {
     country?: CountryCode;
     /** Controlled display value. */
     value?: string;
@@ -2177,4 +1436,4 @@ interface PhoneFieldProps extends Omit<InputHTMLAttributes<HTMLInputElement>, 't
  */
 declare const PhoneField: react.ForwardRefExoticComponent<PhoneFieldProps & react.RefAttributes<HTMLInputElement>>;
 
-export { AranovaApiError, type AutomaticEventName, type BusinessConfig, type BusinessConfigFeatures, type BusinessConfigService, type CompareTo, ConsentBanner, type ConsentBannerProps, ConsentState, type CreateTrackingOptions, type CreateTrackingResult, type CtaClickConfig, type CtaClickMetadata, type CurrencyRevenue, type CustomerCurrencyDelta, type CustomerCurrencyTotal, type CustomerGetOptions, type CustomerGetResult, type CustomerKpis, type CustomerKpisDeltas, type CustomerKpisPrevious, type CustomerListPage, type CustomerListQuery, type CustomerProfile, type CustomerSegment, type CustomerSegmentCount, type CustomerSortField, type CustomerSummary, type CustomerSummaryQuery, type DistinctCustomersByCurrency, type EventConfig, type EventMetadata, type EventName, type FormStartConfig, type FormStartMetadata, FormSubmitConfig, FormSubmitMetadata, GoogleAdsTracking, type GoogleAdsTrackingProps, type Granularity, type ManualEventName, type MultiPageSessionConfig, type MultiPageSessionMetadata, type NamedRange, type PageViewConfig, type PageViewMetadata, ParsedPhone, type PhoneClickConfig, type PhoneClickMetadata, PhoneConfig, PhoneConfigContext, PhoneDisplayFormat, PhoneField, type PhoneFieldApi, type PhoneFieldProps, type PhoneInputProps, type PublicServiceItem, type RegisteredAutomaticEvents, type RegisteredManualEvents, type Sale, type SaleCursorPage, type SaleInput, type SaleItem, type SaleItemInput, type SaleKeysetSortField, type SaleListPage, type SaleListQuery, type SaleListQueryV2, type SaleService, type SaleServiceInput, type SaleSortOrder, type SaleSummary, type SaleSummaryPrevious, type SaleSummaryQuery, type SaleSummaryQueryV2, type SaleSummaryV2, type SaleUpdateInput, type SalesBusinessClient, type SalesCategoryBreakdown, type SalesClient, type SalesClientConfig, type SalesCustomersClient, type SalesServiceBreakdown, type SalesTransportConfig, type SalesTrendPoint, type ScrollDepthConfig, type ScrollDepthMetadata, type SpecificPageName, type SpecificPageVisitConfig, type SpecificPageVisitMetadata, type SummaryCurrencyDelta, type SummaryDeltas, type SummaryWindow, type SupportedCurrency, TRACKING_PARAM_KEYS, type TimeOnSiteConfig, type TimeOnSiteMetadata, type TrackingClient, TrackingClientContext, TrackingEventCreatePayload, TrackingInstallSurface, type TrackingOverviewRange, TrackingParams, type TrackingProviderProps, TrackingSessionUpsertPayload, type TriggerRegistryConfig, type TypedTrackEventOptions, type TypedTrackingClient, type UseConsentResult, type UsePhoneFieldOptions, captureTrackingParamsFromLocation, createSalesClient, createTracking, createTrackingClientContext, createTrackingEventCreatePayload, createTrackingSessionUpsertPayload, fetchServices, formatDateInTz, formatMoney, fromMinor, getConsentState, resetConsent, setConsentState, toMinor, useConsent, useConsentState, useGclid, usePhoneConfig, usePhoneField, useTrackingParams };
+export { ALL_AUTOMATIC_EVENT_NAMES, ALL_MANUAL_EVENT_NAMES, type AutomaticEventName, ConsentBanner, type ConsentBannerProps, ConsentState, type CreateTrackingOptions, type CreateTrackingResult, type CtaClickConfig, type CtaClickMetadata, EVENT_REGISTRY, type EventConfig, type EventKind, type EventMetadata, type EventName, type FormStartConfig, type FormStartMetadata, FormSubmitConfig, FormSubmitMetadata, GoogleAdsTracking, type GoogleAdsTrackingProps, type ManualEventName, type MultiPageSessionConfig, type MultiPageSessionMetadata, type PageViewConfig, type PageViewMetadata, ParsedPhone, type PhoneClickConfig, type PhoneClickMetadata, PhoneConfig, PhoneDisplayFormat, PhoneField, type PhoneFieldApi, type PhoneFieldProps, type PhoneInputProps, type RegisteredAutomaticEvents, type RegisteredManualEvents, SPECIFIC_PAGE_NAMES, type ScrollDepthConfig, type ScrollDepthMetadata, type SdkHeartbeatConfig, type SdkHeartbeatMetadata, type SpecificPageName, type SpecificPageVisitConfig, type SpecificPageVisitMetadata, TRACKING_PARAM_KEYS, type TimeOnSiteConfig, type TimeOnSiteMetadata, type TrackableEvent, type TrackingClient, TrackingClientContext, TrackingEventCreatePayload, TrackingInstallSurface, TrackingParams, type TrackingProviderProps, TrackingSessionUpsertPayload, type TriggerRegistryConfig, type TypedTrackEventOptions, type TypedTrackingClient, type UseConsentResult, type UsePhoneFieldOptions, captureTrackingParamsFromLocation, createTracking, createTrackingClientContext, createTrackingEventCreatePayload, createTrackingSessionUpsertPayload, ctaClickConfigSchema, ctaClickMetadataSchema, formStartConfigSchema, formStartMetadataSchema, getConsentState, getEventDefinition, multiPageSessionConfigSchema, multiPageSessionMetadataSchema, pageViewConfigSchema, pageViewMetadataSchema, phoneClickConfigSchema, phoneClickMetadataSchema, resetConsent, scrollDepthConfigSchema, scrollDepthMetadataSchema, sdkHeartbeatConfigSchema, sdkHeartbeatMetadataSchema, sdkHeartbeatTriggersSchema, setConsentState, specificPageNameSchema, specificPageVisitConfigSchema, specificPageVisitMetadataSchema, timeOnSiteConfigSchema, timeOnSiteMetadataSchema, useConsent, useConsentState, useGclid, usePhoneConfig, usePhoneField, useTrackingParams };