@aranova/tracking-react 0.11.0 → 0.12.0

package/dist/phone-utils-CVX7JmqB.d.mts

@@ -0,0 +1,343 @@
+import { z } from 'zod';
+import { CountryCode } from 'libphonenumber-js';
+
+/**
+ * JSON-serializable value accepted by `form_submit.fields[].value`.
+ *
+ * This intentionally excludes `undefined`, functions, symbols, `Date`
+ * instances, and non-finite numbers. Values are stored in PostgreSQL JSONB, so
+ * consumers should send only data that has a stable JSON representation.
+ */
+type JsonValue = string | number | boolean | null | JsonValue[] | {
+    [key: string]: JsonValue;
+};
+/**
+ * Metadata for a manually fired `form_submit` event.
+ *
+ * Register the event with `manual: { form_submit: {} }`, then call
+ * `trackEvent('form_submit', metadata)` from the host site's submit handler.
+ *
+ * `fields` is optional. If present, each field value must be JSON-serializable
+ * and should be explicitly allowlisted by the integration. Do not send names,
+ * emails, visitor phone numbers, addresses, payment data, medical details,
+ * passwords, file contents, or free-text messages.
+ *
+ * @example
+ * ```ts
+ * tracking.trackEvent('form_submit', {
+ *   form: {
+ *     id: 'lead-form',
+ *     action: '/api/lead',
+ *     fields: [
+ *       {
+ *         name: 'service_interest',
+ *         type: 'select',
+ *         label: 'Service interest',
+ *         value: 'teeth_whitening',
+ *       },
+ *     ],
+ *   },
+ *   page: { path: window.location.pathname },
+ * });
+ * ```
+ */
+declare const formSubmitMetadataSchema: z.ZodObject<{
+    form: z.ZodObject<{
+        id: z.ZodString;
+        action: z.ZodNullable<z.ZodString>;
+        fields: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            type: z.ZodString;
+            label: z.ZodNullable<z.ZodString>;
+            value: z.ZodType<JsonValue, z.ZodTypeDef, JsonValue>;
+        }, "strict", z.ZodTypeAny, {
+            value: JsonValue;
+            type: string;
+            name: string;
+            label: string | null;
+        }, {
+            value: JsonValue;
+            type: string;
+            name: string;
+            label: string | null;
+        }>, "many">>;
+    }, "strict", z.ZodTypeAny, {
+        id: string;
+        action: string | null;
+        fields?: {
+            value: JsonValue;
+            type: string;
+            name: string;
+            label: string | null;
+        }[] | undefined;
+    }, {
+        id: string;
+        action: string | null;
+        fields?: {
+            value: JsonValue;
+            type: string;
+            name: string;
+            label: string | null;
+        }[] | undefined;
+    }>;
+    page: z.ZodObject<{
+        path: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        path: string;
+    }, {
+        path: string;
+    }>;
+}, "strict", z.ZodTypeAny, {
+    form: {
+        id: string;
+        action: string | null;
+        fields?: {
+            value: JsonValue;
+            type: string;
+            name: string;
+            label: string | null;
+        }[] | undefined;
+    };
+    page: {
+        path: string;
+    };
+}, {
+    form: {
+        id: string;
+        action: string | null;
+        fields?: {
+            value: JsonValue;
+            type: string;
+            name: string;
+            label: string | null;
+        }[] | undefined;
+    };
+    page: {
+        path: string;
+    };
+}>;
+type FormSubmitMetadata = z.infer<typeof formSubmitMetadataSchema>;
+/**
+ * Registration config for `form_submit`.
+ *
+ * This event is manual-only and currently has no registration options. The
+ * empty object enables typed `trackEvent('form_submit', ...)` calls.
+ */
+declare const formSubmitConfigSchema: z.ZodObject<{}, "strict", z.ZodTypeAny, {}, {}>;
+type FormSubmitConfig = z.infer<typeof formSubmitConfigSchema>;
+
+/**
+ * How a phone number is shown in the UI. The transmitted value is always E.164
+ * and is deliberately NOT part of this — only the display format is configurable.
+ * A function form covers the long tail (`(parsed) => string`).
+ */
+type PhoneDisplayFormat = 'national' | 'international' | 'e164' | ((parsed: ParsedPhone) => string);
+interface ParsedPhone {
+    /** E.164 (`"+14165550199"`) or `null` when the input isn't a valid number. This is what gets transmitted. */
+    e164: string | null;
+    /** National display form (`"(416) 555-0199"`); empty string when unparseable. */
+    national: string;
+    /** International display form (`"+1 416 555 0199"`); empty string when unparseable. */
+    international: string;
+    /** ISO-3166 country resolved by libphonenumber, or `null`. */
+    country: CountryCode | null;
+    isValid: boolean;
+}
+/** Region assumed for numbers typed without a country code. */
+declare const DEFAULT_PHONE_COUNTRY: CountryCode;
+/** Parse a raw/display string into every representation at once (one parse → display + wire never drift). */
+declare function parsePhone(raw: string, country?: CountryCode): ParsedPhone;
+/** Normalize any raw/display value to E.164, or `null` if it isn't a valid number. */
+declare function toE164(raw: string, country?: CountryCode): string | null;
+/** Format a value for display. Defaults to `'national'`. Never affects the wire value. */
+declare function formatPhone(value: string, format?: PhoneDisplayFormat, country?: CountryCode): string;
+/** Live, incremental formatting for an `<input>` as the user types (`AsYouType`). */
+declare function formatPhoneAsTyped(raw: string, country?: CountryCode): string;
+
+/**
+ * Init-time phone config (`createTracking({ phone })`). The transmitted value is
+ * ALWAYS E.164 and is deliberately not configurable here — only display is.
+ */
+interface PhoneConfig {
+    /** Region assumed for numbers typed without a country code. Default `'CA'`. */
+    defaultCountry?: CountryCode;
+    /** How the input DISPLAYS to the user. Default `'national'`. Does not affect the wire. */
+    display?: PhoneDisplayFormat;
+}
+/** A single tracked form field destined for `form_submit.fields[]`. */
+interface TrackedField {
+    name: string;
+    type: string;
+    value: JsonValue;
+    label?: string | null;
+}
+/**
+ * Build a tracked field whose wire value is ALWAYS E.164. The client keeps its
+ * own display value for UI/email; this puts `+E.164` on the wire (or `null` when
+ * the input isn't a valid number).
+ */
+declare function phoneField(name: string, raw: string, country?: CountryCode): TrackedField;
+
+/**
+ * Visitor consent state stored by the SDK.
+ *
+ * - `pending`: the visitor has not accepted or declined yet.
+ * - `granted`: consent was accepted and Google Consent Mode is updated to granted.
+ * - `denied`: consent was declined and Google Consent Mode is updated to denied.
+ */
+type ConsentState = 'granted' | 'denied' | 'pending';
+/**
+ * Attribution parameters captured from the landing URL and persisted in cookies.
+ *
+ * Missing params are represented as `null` so payloads can be serialized
+ * directly without checking for `undefined`.
+ */
+interface TrackingParams {
+    /** Google Ads click id. */
+    gclid: string | null;
+    /** Meta/Facebook click id. */
+    fbclid: string | null;
+    /** UTM source, for example `google` or `newsletter`. */
+    utm_source: string | null;
+    /** UTM medium, for example `cpc` or `email`. */
+    utm_medium: string | null;
+    /** UTM campaign name. */
+    utm_campaign: string | null;
+    /** UTM paid-search term. */
+    utm_term: string | null;
+    /** UTM content/ad creative label. */
+    utm_content: string | null;
+}
+/**
+ * Runtime surface that installed the tracking SDK.
+ *
+ * Included in ingest payloads and heartbeat events so the dashboard can tell
+ * whether a site uses the Next, React, or script-tag integration.
+ */
+type TrackingInstallSurface = 'next' | 'react' | 'script';
+/**
+ * Deployment environment label for event tagging.
+ *
+ * Used to stamp tracking events with the deployment context so the dashboard
+ * can distinguish production traffic from dev test traffic. The backend
+ * enforces this via a Postgres enum, so values are strictly one of
+ * `'production'` or `'development'`.
+ */
+type TrackingEnvironment = 'production' | 'development';
+/**
+ * Labelled map of Google Ads tag IDs.
+ *
+ * ALL entries are loaded simultaneously via `gtag('config', ...)` — the keys
+ * are human-readable labels (e.g. `production`, `test`) and the values are
+ * Google Ads tag IDs (e.g. `AW-123456789`).
+ */
+type GtagEnvironmentMap = Record<string, string>;
+/**
+ * Runtime context attached to tracking sessions and events.
+ */
+interface TrackingClientContext {
+    /** Install surface that created the client. */
+    surface: TrackingInstallSurface;
+    /** Package version, when available. */
+    sdk_version: string | null;
+    /** Package name, for example `@aranova/tracking-react`. */
+    package_name: string | null;
+    /** Browser origin of the tracked site. */
+    site_origin: string | null;
+    /** Current document title at client creation time. */
+    page_title: string | null;
+    /** Browser document referrer at client creation time. */
+    referrer: string | null;
+    /**
+     * Deployment environment label, e.g. `'production'`, `'development'`.
+     *
+     * Always set — defaults to `'production'` when the consumer doesn't
+     * pass `environment` to the factory. Sending `null` would fail the
+     * backend's strict enum validation.
+     */
+    environment: TrackingEnvironment;
+    /** All active gtag IDs loaded on this page, keyed by label. */
+    active_gtag_ids: Record<string, string> | null;
+}
+/**
+ * Session payload sent to `POST /tracking/events`.
+ *
+ * The backend upserts this by `(business_id, session_id)` before inserting
+ * individual events.
+ */
+interface TrackingSessionUpsertPayload {
+    /** Rolling 30-minute client-side session id. */
+    session_id: string;
+    /** Persistent client-side visitor id. */
+    visitor_id: string | null;
+    gclid: string | null;
+    fbclid: string | null;
+    utm_source: string | null;
+    utm_medium: string | null;
+    utm_campaign: string | null;
+    utm_term: string | null;
+    utm_content: string | null;
+    first_page: string | null;
+    consent_state: Record<string, unknown> | null;
+    context: TrackingClientContext;
+}
+/**
+ * Event payload shape before batching into the ingest request.
+ */
+interface TrackingEventCreatePayload {
+    /** Session id that logically owns the event. */
+    session_id: string;
+    /** Registered event name, for example `page_view` or `form_submit`. */
+    event_type: string;
+    gclid: string | null;
+    fbclid: string | null;
+    /** Full page URL associated with the event, if known. */
+    page_url: string | null;
+    /** Event-specific metadata. Runtime shape depends on `event_type`. */
+    metadata: Record<string, unknown> | null;
+    context: TrackingClientContext;
+}
+/**
+ * Browser-script initialization config passed to `window.AranovaTracking.init()`.
+ */
+interface TrackingInitConfig {
+    /** Public tracking API key issued from the Aranova dashboard. */
+    apiKey?: string;
+    /** Tracking endpoint base URL, usually ending in `/tracking`. */
+    endpoint?: string;
+    /** Optional Google Ads tag id, for example `AW-123456789`. */
+    gtagId?: string;
+    /**
+     * Labelled map of Google Ads tag IDs. ALL are loaded simultaneously.
+     * When provided, `gtagId` is ignored.
+     */
+    gtagIds?: GtagEnvironmentMap;
+    /** Deployment environment label reported in session context. */
+    environment?: TrackingEnvironment;
+    /** Whether to capture attribution params from `window.location`. Defaults to true. */
+    autoCaptureTrackingParams?: boolean;
+    /** Whether the browser script should inject the default consent banner. */
+    renderConsentBanner?: boolean;
+    /** Attribution cookie max age in seconds. Defaults to 90 days. */
+    cookieMaxAgeSeconds?: number;
+    /** Override the install surface reported in payload context. */
+    surface?: TrackingInstallSurface;
+    /** Phone-field display + default-country config. Transmit is always E.164. */
+    phone?: PhoneConfig;
+}
+declare global {
+    interface Window {
+        gtag?: (...args: unknown[]) => void;
+        dataLayer?: unknown[];
+        AranovaTracking?: {
+            init: (config: TrackingInitConfig) => void;
+            captureTrackingParams: () => TrackingParams;
+            getTrackingParams: () => TrackingParams;
+            getConsentState: () => ConsentState;
+            setConsentState: (state: 'granted' | 'denied') => void;
+            trackEvent: (eventType: string, metadata: Record<string, unknown>) => void;
+        };
+    }
+}
+
+export { type ConsentState as C, DEFAULT_PHONE_COUNTRY as D, type FormSubmitConfig as F, type GtagEnvironmentMap as G, type JsonValue as J, type PhoneConfig as P, type TrackingInstallSurface as T, type TrackingEnvironment as a, type TrackingClientContext as b, type TrackingParams as c, type TrackingEventCreatePayload as d, type TrackingSessionUpsertPayload as e, type FormSubmitMetadata as f, type ParsedPhone as g, type PhoneDisplayFormat as h, type TrackedField as i, type TrackingInitConfig as j, formatPhone as k, formatPhoneAsTyped as l, phoneField as m, parsePhone as p, toE164 as t };

package/dist/phone-utils-CVX7JmqB.d.ts

@@ -0,0 +1,343 @@
+import { z } from 'zod';
+import { CountryCode } from 'libphonenumber-js';
+
+/**
+ * JSON-serializable value accepted by `form_submit.fields[].value`.
+ *
+ * This intentionally excludes `undefined`, functions, symbols, `Date`
+ * instances, and non-finite numbers. Values are stored in PostgreSQL JSONB, so
+ * consumers should send only data that has a stable JSON representation.
+ */
+type JsonValue = string | number | boolean | null | JsonValue[] | {
+    [key: string]: JsonValue;
+};
+/**
+ * Metadata for a manually fired `form_submit` event.
+ *
+ * Register the event with `manual: { form_submit: {} }`, then call
+ * `trackEvent('form_submit', metadata)` from the host site's submit handler.
+ *
+ * `fields` is optional. If present, each field value must be JSON-serializable
+ * and should be explicitly allowlisted by the integration. Do not send names,
+ * emails, visitor phone numbers, addresses, payment data, medical details,
+ * passwords, file contents, or free-text messages.
+ *
+ * @example
+ * ```ts
+ * tracking.trackEvent('form_submit', {
+ *   form: {
+ *     id: 'lead-form',
+ *     action: '/api/lead',
+ *     fields: [
+ *       {
+ *         name: 'service_interest',
+ *         type: 'select',
+ *         label: 'Service interest',
+ *         value: 'teeth_whitening',
+ *       },
+ *     ],
+ *   },
+ *   page: { path: window.location.pathname },
+ * });
+ * ```
+ */
+declare const formSubmitMetadataSchema: z.ZodObject<{
+    form: z.ZodObject<{
+        id: z.ZodString;
+        action: z.ZodNullable<z.ZodString>;
+        fields: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            type: z.ZodString;
+            label: z.ZodNullable<z.ZodString>;
+            value: z.ZodType<JsonValue, z.ZodTypeDef, JsonValue>;
+        }, "strict", z.ZodTypeAny, {
+            value: JsonValue;
+            type: string;
+            name: string;
+            label: string | null;
+        }, {
+            value: JsonValue;
+            type: string;
+            name: string;
+            label: string | null;
+        }>, "many">>;
+    }, "strict", z.ZodTypeAny, {
+        id: string;
+        action: string | null;
+        fields?: {
+            value: JsonValue;
+            type: string;
+            name: string;
+            label: string | null;
+        }[] | undefined;
+    }, {
+        id: string;
+        action: string | null;
+        fields?: {
+            value: JsonValue;
+            type: string;
+            name: string;
+            label: string | null;
+        }[] | undefined;
+    }>;
+    page: z.ZodObject<{
+        path: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        path: string;
+    }, {
+        path: string;
+    }>;
+}, "strict", z.ZodTypeAny, {
+    form: {
+        id: string;
+        action: string | null;
+        fields?: {
+            value: JsonValue;
+            type: string;
+            name: string;
+            label: string | null;
+        }[] | undefined;
+    };
+    page: {
+        path: string;
+    };
+}, {
+    form: {
+        id: string;
+        action: string | null;
+        fields?: {
+            value: JsonValue;
+            type: string;
+            name: string;
+            label: string | null;
+        }[] | undefined;
+    };
+    page: {
+        path: string;
+    };
+}>;
+type FormSubmitMetadata = z.infer<typeof formSubmitMetadataSchema>;
+/**
+ * Registration config for `form_submit`.
+ *
+ * This event is manual-only and currently has no registration options. The
+ * empty object enables typed `trackEvent('form_submit', ...)` calls.
+ */
+declare const formSubmitConfigSchema: z.ZodObject<{}, "strict", z.ZodTypeAny, {}, {}>;
+type FormSubmitConfig = z.infer<typeof formSubmitConfigSchema>;
+
+/**
+ * How a phone number is shown in the UI. The transmitted value is always E.164
+ * and is deliberately NOT part of this — only the display format is configurable.
+ * A function form covers the long tail (`(parsed) => string`).
+ */
+type PhoneDisplayFormat = 'national' | 'international' | 'e164' | ((parsed: ParsedPhone) => string);
+interface ParsedPhone {
+    /** E.164 (`"+14165550199"`) or `null` when the input isn't a valid number. This is what gets transmitted. */
+    e164: string | null;
+    /** National display form (`"(416) 555-0199"`); empty string when unparseable. */
+    national: string;
+    /** International display form (`"+1 416 555 0199"`); empty string when unparseable. */
+    international: string;
+    /** ISO-3166 country resolved by libphonenumber, or `null`. */
+    country: CountryCode | null;
+    isValid: boolean;
+}
+/** Region assumed for numbers typed without a country code. */
+declare const DEFAULT_PHONE_COUNTRY: CountryCode;
+/** Parse a raw/display string into every representation at once (one parse → display + wire never drift). */
+declare function parsePhone(raw: string, country?: CountryCode): ParsedPhone;
+/** Normalize any raw/display value to E.164, or `null` if it isn't a valid number. */
+declare function toE164(raw: string, country?: CountryCode): string | null;
+/** Format a value for display. Defaults to `'national'`. Never affects the wire value. */
+declare function formatPhone(value: string, format?: PhoneDisplayFormat, country?: CountryCode): string;
+/** Live, incremental formatting for an `<input>` as the user types (`AsYouType`). */
+declare function formatPhoneAsTyped(raw: string, country?: CountryCode): string;
+
+/**
+ * Init-time phone config (`createTracking({ phone })`). The transmitted value is
+ * ALWAYS E.164 and is deliberately not configurable here — only display is.
+ */
+interface PhoneConfig {
+    /** Region assumed for numbers typed without a country code. Default `'CA'`. */
+    defaultCountry?: CountryCode;
+    /** How the input DISPLAYS to the user. Default `'national'`. Does not affect the wire. */
+    display?: PhoneDisplayFormat;
+}
+/** A single tracked form field destined for `form_submit.fields[]`. */
+interface TrackedField {
+    name: string;
+    type: string;
+    value: JsonValue;
+    label?: string | null;
+}
+/**
+ * Build a tracked field whose wire value is ALWAYS E.164. The client keeps its
+ * own display value for UI/email; this puts `+E.164` on the wire (or `null` when
+ * the input isn't a valid number).
+ */
+declare function phoneField(name: string, raw: string, country?: CountryCode): TrackedField;
+
+/**
+ * Visitor consent state stored by the SDK.
+ *
+ * - `pending`: the visitor has not accepted or declined yet.
+ * - `granted`: consent was accepted and Google Consent Mode is updated to granted.
+ * - `denied`: consent was declined and Google Consent Mode is updated to denied.
+ */
+type ConsentState = 'granted' | 'denied' | 'pending';
+/**
+ * Attribution parameters captured from the landing URL and persisted in cookies.
+ *
+ * Missing params are represented as `null` so payloads can be serialized
+ * directly without checking for `undefined`.
+ */
+interface TrackingParams {
+    /** Google Ads click id. */
+    gclid: string | null;
+    /** Meta/Facebook click id. */
+    fbclid: string | null;
+    /** UTM source, for example `google` or `newsletter`. */
+    utm_source: string | null;
+    /** UTM medium, for example `cpc` or `email`. */
+    utm_medium: string | null;
+    /** UTM campaign name. */
+    utm_campaign: string | null;
+    /** UTM paid-search term. */
+    utm_term: string | null;
+    /** UTM content/ad creative label. */
+    utm_content: string | null;
+}
+/**
+ * Runtime surface that installed the tracking SDK.
+ *
+ * Included in ingest payloads and heartbeat events so the dashboard can tell
+ * whether a site uses the Next, React, or script-tag integration.
+ */
+type TrackingInstallSurface = 'next' | 'react' | 'script';
+/**
+ * Deployment environment label for event tagging.
+ *
+ * Used to stamp tracking events with the deployment context so the dashboard
+ * can distinguish production traffic from dev test traffic. The backend
+ * enforces this via a Postgres enum, so values are strictly one of
+ * `'production'` or `'development'`.
+ */
+type TrackingEnvironment = 'production' | 'development';
+/**
+ * Labelled map of Google Ads tag IDs.
+ *
+ * ALL entries are loaded simultaneously via `gtag('config', ...)` — the keys
+ * are human-readable labels (e.g. `production`, `test`) and the values are
+ * Google Ads tag IDs (e.g. `AW-123456789`).
+ */
+type GtagEnvironmentMap = Record<string, string>;
+/**
+ * Runtime context attached to tracking sessions and events.
+ */
+interface TrackingClientContext {
+    /** Install surface that created the client. */
+    surface: TrackingInstallSurface;
+    /** Package version, when available. */
+    sdk_version: string | null;
+    /** Package name, for example `@aranova/tracking-react`. */
+    package_name: string | null;
+    /** Browser origin of the tracked site. */
+    site_origin: string | null;
+    /** Current document title at client creation time. */
+    page_title: string | null;
+    /** Browser document referrer at client creation time. */
+    referrer: string | null;
+    /**
+     * Deployment environment label, e.g. `'production'`, `'development'`.
+     *
+     * Always set — defaults to `'production'` when the consumer doesn't
+     * pass `environment` to the factory. Sending `null` would fail the
+     * backend's strict enum validation.
+     */
+    environment: TrackingEnvironment;
+    /** All active gtag IDs loaded on this page, keyed by label. */
+    active_gtag_ids: Record<string, string> | null;
+}
+/**
+ * Session payload sent to `POST /tracking/events`.
+ *
+ * The backend upserts this by `(business_id, session_id)` before inserting
+ * individual events.
+ */
+interface TrackingSessionUpsertPayload {
+    /** Rolling 30-minute client-side session id. */
+    session_id: string;
+    /** Persistent client-side visitor id. */
+    visitor_id: string | null;
+    gclid: string | null;
+    fbclid: string | null;
+    utm_source: string | null;
+    utm_medium: string | null;
+    utm_campaign: string | null;
+    utm_term: string | null;
+    utm_content: string | null;
+    first_page: string | null;
+    consent_state: Record<string, unknown> | null;
+    context: TrackingClientContext;
+}
+/**
+ * Event payload shape before batching into the ingest request.
+ */
+interface TrackingEventCreatePayload {
+    /** Session id that logically owns the event. */
+    session_id: string;
+    /** Registered event name, for example `page_view` or `form_submit`. */
+    event_type: string;
+    gclid: string | null;
+    fbclid: string | null;
+    /** Full page URL associated with the event, if known. */
+    page_url: string | null;
+    /** Event-specific metadata. Runtime shape depends on `event_type`. */
+    metadata: Record<string, unknown> | null;
+    context: TrackingClientContext;
+}
+/**
+ * Browser-script initialization config passed to `window.AranovaTracking.init()`.
+ */
+interface TrackingInitConfig {
+    /** Public tracking API key issued from the Aranova dashboard. */
+    apiKey?: string;
+    /** Tracking endpoint base URL, usually ending in `/tracking`. */
+    endpoint?: string;
+    /** Optional Google Ads tag id, for example `AW-123456789`. */
+    gtagId?: string;
+    /**
+     * Labelled map of Google Ads tag IDs. ALL are loaded simultaneously.
+     * When provided, `gtagId` is ignored.
+     */
+    gtagIds?: GtagEnvironmentMap;
+    /** Deployment environment label reported in session context. */
+    environment?: TrackingEnvironment;
+    /** Whether to capture attribution params from `window.location`. Defaults to true. */
+    autoCaptureTrackingParams?: boolean;
+    /** Whether the browser script should inject the default consent banner. */
+    renderConsentBanner?: boolean;
+    /** Attribution cookie max age in seconds. Defaults to 90 days. */
+    cookieMaxAgeSeconds?: number;
+    /** Override the install surface reported in payload context. */
+    surface?: TrackingInstallSurface;
+    /** Phone-field display + default-country config. Transmit is always E.164. */
+    phone?: PhoneConfig;
+}
+declare global {
+    interface Window {
+        gtag?: (...args: unknown[]) => void;
+        dataLayer?: unknown[];
+        AranovaTracking?: {
+            init: (config: TrackingInitConfig) => void;
+            captureTrackingParams: () => TrackingParams;
+            getTrackingParams: () => TrackingParams;
+            getConsentState: () => ConsentState;
+            setConsentState: (state: 'granted' | 'denied') => void;
+            trackEvent: (eventType: string, metadata: Record<string, unknown>) => void;
+        };
+    }
+}
+
+export { type ConsentState as C, DEFAULT_PHONE_COUNTRY as D, type FormSubmitConfig as F, type GtagEnvironmentMap as G, type JsonValue as J, type PhoneConfig as P, type TrackingInstallSurface as T, type TrackingEnvironment as a, type TrackingClientContext as b, type TrackingParams as c, type TrackingEventCreatePayload as d, type TrackingSessionUpsertPayload as e, type FormSubmitMetadata as f, type ParsedPhone as g, type PhoneDisplayFormat as h, type TrackedField as i, type TrackingInitConfig as j, formatPhone as k, formatPhoneAsTyped as l, phoneField as m, parsePhone as p, toE164 as t };

package/dist/phone.d.mts

@@ -0,0 +1,3 @@
+export { D as DEFAULT_PHONE_COUNTRY, g as ParsedPhone, P as PhoneConfig, h as PhoneDisplayFormat, i as TrackedField, k as formatPhone, l as formatPhoneAsTyped, p as parsePhone, m as phoneField, t as toE164 } from './phone-utils-CVX7JmqB.mjs';
+export { CountryCode } from 'libphonenumber-js';
+import 'zod';

package/dist/phone.d.ts

@@ -0,0 +1,3 @@
+export { D as DEFAULT_PHONE_COUNTRY, g as ParsedPhone, P as PhoneConfig, h as PhoneDisplayFormat, i as TrackedField, k as formatPhone, l as formatPhoneAsTyped, p as parsePhone, m as phoneField, t as toE164 } from './phone-utils-CVX7JmqB.js';
+export { CountryCode } from 'libphonenumber-js';
+import 'zod';