@aranova/tracking-react 0.24.1 → 0.26.0

package/dist/{sales-BwWnvl8L.d.mts → sales-1J-Z4AvL.d.ts}

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { a as ConversionConfigStore, c as TrackingConfigRuntime } from './tracking-config-runtime-BnUlS_Ae.js';
 import { CountryCode } from 'libphonenumber-js';
 
 /** Raw identifiers a caller may hand us (normalized before use). */
@@ -11,195 +12,6 @@ declare function stashUserData(data: ConversionUserData, country?: CountryCode):
 /** Drop everything (consent denial, tests). */
 declare function clearStashedUserData(): void;
 
-interface ServiceFiring {
-    send_to: string;
-    /** Action's configured default value (cents); the SDK fires it only when a sale has no amount. */
-    value_cents?: number | null;
-    currency?: string | null;
-}
-/** Serializable on-page trigger (owned by tracking-core/src/events/trigger-spec.ts). The shape
- * varies by `event_type`; only the parameter for that type is set. */
-interface ConfigTriggerSpec {
-    event_type: string;
-    threshold_percent?: number;
-    threshold_seconds?: number;
-    page_threshold?: number;
-    page_name?: string;
-}
-/** One unified conversion goal: a revenue `sale` or an on-page `event`. */
-interface ConversionGoal {
-    key: string;
-    label?: string;
-    kind: "sale" | "event";
-    /** Structured fire-when for event-goals; null for sales. */
-    trigger: ConfigTriggerSpec | null;
-    firing: ServiceFiring | null;
-}
-interface ConversionConfig {
-    schema_version: number;
-    config_version: number;
-    business_id?: string;
-    customer_id?: string | null;
-    environment?: string;
-    google_tracking_state: "active" | "disabled";
-    gtag_ids: Record<string, string>;
-    meta_pixel_ids: Record<string, string>;
-    /** LEGACY: sale-goals only (for pre-unified-goal readers). */
-    services: Array<{
-        key: string;
-        label?: string;
-        firing: ServiceFiring | null;
-    }>;
-    /** Unified goal list (sales + on-page events). Superset of `services`. */
-    goals: ConversionGoal[];
-}
-interface ConversionConfigStore {
-    /** Firing config for a goal/service key, or null when it doesn't fire on-site. */
-    getFiring(key: string): ServiceFiring | null;
-    /** The full goal for a key, or null when unknown. */
-    getGoal(key: string): ConversionGoal | null;
-    /** Every adopted goal (sales + events). */
-    listGoals(): ConversionGoal[];
-    /** The currently adopted config (baked / cached fallback until the fetch lands). */
-    current(): ConversionConfig | null;
-    /** True once a config is adopted (seeded synchronously from cache/baked, or fetched). */
-    isReady(): boolean;
-    /**
-     * Run `listener` when a config first becomes available — immediately if already
-     * ready, otherwise on the first adopt. Lets auto-fire replay automatic events that
-     * occurred before the async CDN fetch resolved. Returns an unsubscribe fn.
-     */
-    onResolve(listener: () => void): () => void;
-    /** Force a background revalidate against the CDN object. */
-    revalidate(): Promise<void>;
-}
-interface ResolveConversionConfigOptions {
-    /** Full URL of the per-business CDN object. */
-    cdnUrl: string;
-    /** Offline-correct fallback (e.g. the CLI-baked snapshot). */
-    baked?: ConversionConfig | null;
-    /** Injectable for tests / non-global-fetch runtimes. */
-    fetchImpl?: typeof fetch;
-}
-/**
- * Resolve the config with stale-while-revalidate: seed synchronously from the
- * sessionStorage cache (or the baked fallback), then conditionally re-fetch the CDN object
- * with `If-None-Match`. A fetched object is adopted only if its `config_version` is strictly
- * greater than what's cached, so a reordered edge copy can't downgrade fresher state.
- * Non-blocking and browser-only; a failed fetch leaves the seed in place.
- */
-declare function resolveConversionConfig(options: ResolveConversionConfigOptions): ConversionConfigStore;
-
-/**
- * Where a business's published tracking config lives.
- *
- * `businessId` + `environment` are the stable identity; the ORIGIN it is fetched
- * from is deployment-specific (production CDN vs. a local object store), which is
- * why `cdnBaseUrl` exists. Codegen bakes only the identity, so one committed
- * generated file works in every environment and only an env var changes.
- *
- * `cdnUrl` remains supported and WINS when present — every client repo generated
- * before `cdnBaseUrl` passes one, and those must keep working untouched.
- */
-interface TrackingConfigReference {
-    /**
-     * Fully-resolved object URL. Optional: omit it and pass `cdnBaseUrl` (or rely
-     * on the production default) to have it composed from the identity below.
-     */
-    cdnUrl?: string;
-    /**
-     * Origin (optionally with a path prefix) the config object is served from, e.g.
-     * `https://demos.aranova.io` in production or
-     * `http://localhost:9100/aranova-demos` against a local MinIO. Ignored when
-     * `cdnUrl` is set; blank or omitted falls back to {@link DEFAULT_CDN_BASE_URL}.
-     * `tracking-cli gen` wires this to an env var so retargeting is config, not code.
-     */
-    cdnBaseUrl?: string;
-    businessId: string;
-    environment: "production" | "test";
-}
-/**
- * The URL a reference resolves to. An explicit `cdnUrl` wins (back-compat);
- * otherwise compose from `cdnBaseUrl` (or the production default).
- *
- * A blank/whitespace `cdnBaseUrl` is treated as UNSET rather than composed: the
- * generated module reads it from an env var, and a var that is present-but-empty
- * (a stray `NEXT_PUBLIC_ARANOVA_CDN_BASE_URL=` line) would otherwise produce
- * `/tracking-config/...` — a same-origin request to the client's own site.
- */
-declare function resolveTrackingConfigUrl(ref: TrackingConfigReference): string;
-type RuntimeState = "unconfirmed" | "active" | "tombstone";
-interface QueuedConversion {
-    key: string;
-    value?: number | null;
-    currency?: string | null;
-    transactionId?: string | null;
-}
-type TrackingConfigConversionOptions = Omit<QueuedConversion, "key">;
-interface QueuedPageView {
-    href: string;
-    title: string | null;
-    referrer: string | null;
-}
-declare class TrackingConfigRuntime {
-    readonly ref: TrackingConfigReference;
-    private readonly fetchImpl;
-    /** Resolved config URL — see the constructor for why it is computed once. */
-    private readonly url;
-    private current;
-    private etag;
-    private stateValue;
-    private confirmedAt;
-    private authorityGeneration;
-    private inFlight;
-    private flushInFlight;
-    private flushRequested;
-    private retryTimer;
-    private started;
-    /** Consecutive failed authority attempts — drives the revalidate backoff. */
-    private authorityFailures;
-    /** Epoch ms before which `ensureAuthority` must not issue another request. */
-    private nextAuthorityAttemptAt;
-    private readonly conversionQueue;
-    private readonly automaticQueue;
-    private readonly pageQueue;
-    private readonly listeners;
-    constructor(ref: TrackingConfigReference, fetchImpl?: typeof fetch);
-    /** The URL this runtime actually fetches (composed or explicit). */
-    configUrl(): string;
-    /**
-     * Explicitly start authority resolution and Google-tag bootstrap.
-     *
-     * Idempotent so framework effects can call it after hydration without
-     * depending on constructor timing.
-     */
-    start(): void;
-    state(): RuntimeState;
-    config(): ConversionConfig | null;
-    __unsafeExpireAuthorityForTests(): void;
-    /** Queue depths — asserted by tests to pin the bound. */
-    __queueDepthsForTests(): {
-        conversions: number;
-        automatic: number;
-        pages: number;
-    };
-    subscribe(listener: () => void): () => void;
-    ensureAuthority(): Promise<boolean>;
-    revalidate(): Promise<void>;
-    private revalidateAuthority;
-    queuePageView(snapshot?: QueuedPageView | null): void;
-    fireConversion(key: string, options?: TrackingConfigConversionOptions): void;
-    queueAutomaticEvent(eventType: string, metadata: Record<string, unknown>, transactionPath: string, transactionScope: string): void;
-    listGoals(): ConversionGoal[];
-    private revalidateNow;
-    private expireAuthority;
-    private confirm;
-    private flush;
-    private scheduleRetry;
-    private flushNow;
-}
-declare function getTrackingConfigRuntime(ref: TrackingConfigReference, fetchImpl?: typeof fetch): TrackingConfigRuntime;
-
 /**
  * Sales / Conversions wire schemas — the client-side source of truth.
  *
@@ -582,6 +394,12 @@ interface Sale {
     updated_at: string;
     items: SaleItem[];
 }
+/**
+ * The offset page shape returned by the internal admin list, which this client
+ * never calls (`list()` is keyset and returns {@link SaleCursorPage}).
+ *
+ * @deprecated Unused by this client — no verb returns or accepts it. Kept for one release; removed in the next major.
+ */
 interface SaleListPage {
     items: Sale[];
     total: number;
@@ -594,9 +412,10 @@ interface SaleCursorPage {
     has_more?: boolean;
 }
 /**
- * Sortable columns on the secret-key (keyset) and admin (offset) list endpoints.
- * `business_name` only applies to the cross-business admin list — it sorts the
- * joined `businesses.name` column.
+ * Sortable columns on the internal admin (offset) list. `list()` is typed to
+ * {@link SaleKeysetSortField}, which omits `customer_name` and `business_name`.
+ *
+ * @deprecated Unused by this client — no verb returns or accepts it. Kept for one release; removed in the next major.
  */
 type SaleSortField = "occurred_at" | "created_at" | "amount_total_cents" | "customer_name" | "business_name";
 type SaleSortOrder = "asc" | "desc";
@@ -628,10 +447,13 @@ interface SaleFilters {
  * 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.
+ * Ordering is selectable via `sort`/`order` on {@link SaleListQueryV2}. A cursor
+ * encodes a position under the sort it was minted with, so replaying it under a
+ * different sort is rejected (422) — page with the sort you started with.
+ */
+/**
+ * @deprecated Superseded by {@link SaleListQueryV2}, which is what `list()` accepts.
+ * Its ordering note was also stale — `sort`/`order` are supported. Removed in the next major.
  */
 interface SaleListQuery extends SaleFilters {
     limit?: number;
@@ -649,6 +471,10 @@ interface SaleListQueryV2 extends SaleListQuery {
 declare const TRACKING_RANGES: readonly ["24h", "7d", "30d"];
 type TrackingOverviewRange = (typeof TRACKING_RANGES)[number];
 /** Query input for `SalesClient.summary()` — filters + range + options. */
+/**
+ * @deprecated The v1 summary query. `summary()` accepts {@link SaleSummaryQueryV2};
+ * the v1 endpoint no longer exists. Removed in the next major.
+ */
 interface SaleSummaryQuery extends SaleFilters {
     range: TrackingOverviewRange;
     /** Include the per-category line-item breakdown (extra join; default false). */
@@ -688,6 +514,10 @@ interface SalesTrendPoint {
     sale_count: number;
     revenue_cents: number;
 }
+/**
+ * @deprecated The v1 summary response. `summary()` returns {@link SaleSummaryV2};
+ * the v1 endpoint no longer exists. Removed in the next major.
+ */
 interface SaleSummary {
     range: TrackingOverviewRange;
     business_id: string | null;
@@ -860,6 +690,23 @@ interface BusinessConfigFeatures {
     comparisons: boolean;
     retention: boolean;
 }
+/** A built-in customer field a business can require on every sale. */
+type SaleBuiltinRequirableField = "customer_name" | "customer_phone" | "customer_email" | "description";
+/** v1 value types. `enum` is single-select over the property's `options`. */
+type SalePropertyType = "string" | "number" | "boolean" | "enum" | "date";
+interface SalePropertyOption {
+    key: string;
+    label: string;
+}
+/** One custom sale property as the sale form sees it: overrides applied, options
+ * already filtered to the business's enabled subset. */
+interface EffectiveSaleProperty {
+    key: string;
+    label: string;
+    type: SalePropertyType;
+    required: boolean;
+    options?: SalePropertyOption[] | null;
+}
 interface BusinessConfig {
     business_id: string;
     display_name: string;
@@ -869,6 +716,11 @@ interface BusinessConfig {
     default_phone_country: string | null;
     services: BusinessConfigService[];
     features: BusinessConfigFeatures;
+    builtin_required: SaleBuiltinRequirableField[];
+    properties: EffectiveSaleProperty[];
+    /** Whether the form should pre-tick the SMS consent box. A form default only —
+     * the per-sale `sms_consent` attestation is what every send path gates on. */
+    sms_consent_default_opt_in: boolean;
 }
 
 /** Shared config for every awaited (non fire-and-forget) API helper. */
@@ -937,10 +789,10 @@ interface SalesClient<TService extends string = string, TConversion extends stri
         occurred_at?: string;
     }): Promise<Sale>;
     /**
-     * Record a revenue sale — the intent-revealing alias of {@link record} in the unified-goal
-     * API. POSTs `/sales` and ALSO fires the on-site conversion when the sale-goal is
-     * WEBPAGE-mapped. Use this for anything with real revenue; use {@link trackConversion} for a
-     * non-revenue on-page event.
+     * Record a revenue sale — the intent-revealing alias of {@link record}. Identical
+     * behavior (same function reference): POSTs `/sales` and fires the on-site conversion
+     * when the sale-goal is WEBPAGE-mapped. Use either for real revenue; use
+     * {@link trackConversion} for a non-revenue on-page event.
      */
     recordSale(input: Omit<SaleInput, "currency" | "occurred_at" | "service" | "services"> & {
         service?: TService | null;
@@ -1046,4 +898,4 @@ interface PublicServiceItem {
  */
 declare function fetchServices(config: SalesTransportConfig): Promise<PublicServiceItem[]>;
 
-export { type SalesClient as $, AranovaApiError as A, type BusinessConfig as B, type ConversionConfig as C, type DistinctCustomersByCurrency as D, type SaleItem as E, type SaleItemInput as F, type Granularity as G, type SaleKeysetSortField as H, type SaleListPage as I, type SaleListQuery as J, type SaleListQueryV2 as K, type SaleService as L, type SaleServiceInput as M, NAMED_RANGES as N, type SaleSortField as O, type PublicServiceItem as P, type SaleSortOrder as Q, type SaleSummary as R, SUPPORTED_CURRENCIES as S, type TrackingConfigReference as T, type SaleSummaryPrevious as U, type SaleSummaryQuery as V, type SaleSummaryQueryV2 as W, type SaleSummaryV2 as X, type SaleUpdateInput as Y, type SalesBusinessClient as Z, type SalesCategoryBreakdown as _, type BusinessConfigFeatures as a, type SalesClientConfig as a0, type SalesCustomersClient as a1, type SalesServiceBreakdown as a2, type SalesTransportConfig as a3, type SalesTrendPoint as a4, type SummaryCurrencyDelta as a5, type SummaryDeltas as a6, type SummaryWindow as a7, type SupportedCurrency as a8, TRACKING_RANGES as a9, type TrackingOverviewRange as aa, clearStashedUserData as ab, createSalesClient as ac, fetchServices as ad, formatDateInTz as ae, formatMoney as af, fromMinor as ag, getTrackingConfigRuntime as ah, resolveConversionConfig as ai, resolveTrackingConfigUrl as aj, saleCreateSchema as ak, saleItemSchema as al, saleServiceSchema as am, saleUpdateSchema as an, salesRequest as ao, stashUserData as ap, toMinor as aq, type BusinessConfigService as b, type CompareTo as c, type ConversionConfigStore as d, type ConversionUserData as e, type CurrencyRevenue as f, type CustomerCurrencyDelta as g, type CustomerCurrencyTotal as h, type CustomerGetOptions as i, type CustomerGetResult as j, type CustomerKpis as k, type CustomerKpisDeltas as l, type CustomerKpisPrevious as m, type CustomerListPage as n, type CustomerListQuery as o, type CustomerProfile as p, type CustomerSegment as q, type CustomerSegmentCount as r, type CustomerSortField as s, type CustomerSummary as t, type CustomerSummaryQuery as u, type NamedRange as v, type Sale as w, type SaleCursorPage as x, type SaleFilters as y, type SaleInput as z };
+export { type SalesCategoryBreakdown as $, AranovaApiError as A, type BusinessConfig as B, type CompareTo as C, type DistinctCustomersByCurrency as D, type EffectiveSaleProperty as E, type SaleItemInput as F, type Granularity as G, type SaleKeysetSortField as H, type SaleListPage as I, type SaleListQuery as J, type SaleListQueryV2 as K, type SalePropertyOption as L, type SalePropertyType as M, NAMED_RANGES as N, type SaleService as O, type PublicServiceItem as P, type SaleServiceInput as Q, type SaleSortField as R, SUPPORTED_CURRENCIES as S, type SaleSortOrder as T, type SaleSummary as U, type SaleSummaryPrevious as V, type SaleSummaryQuery as W, type SaleSummaryQueryV2 as X, type SaleSummaryV2 as Y, type SaleUpdateInput as Z, type SalesBusinessClient as _, type BusinessConfigFeatures as a, type SalesClient as a0, type SalesClientConfig as a1, type SalesCustomersClient as a2, type SalesServiceBreakdown as a3, type SalesTransportConfig as a4, type SalesTrendPoint as a5, type SummaryCurrencyDelta as a6, type SummaryDeltas as a7, type SummaryWindow as a8, type SupportedCurrency as a9, TRACKING_RANGES as aa, type TrackingOverviewRange as ab, clearStashedUserData as ac, createSalesClient as ad, fetchServices as ae, formatDateInTz as af, formatMoney as ag, fromMinor as ah, saleCreateSchema as ai, saleItemSchema as aj, saleServiceSchema as ak, saleUpdateSchema as al, salesRequest as am, stashUserData as an, toMinor as ao, type BusinessConfigService as b, type ConversionUserData as c, type CurrencyRevenue as d, type CustomerCurrencyDelta as e, type CustomerCurrencyTotal as f, type CustomerGetOptions as g, type CustomerGetResult as h, type CustomerKpis as i, type CustomerKpisDeltas as j, type CustomerKpisPrevious as k, type CustomerListPage as l, type CustomerListQuery as m, type CustomerProfile as n, type CustomerSegment as o, type CustomerSegmentCount as p, type CustomerSortField as q, type CustomerSummary as r, type CustomerSummaryQuery as s, type NamedRange as t, type Sale as u, type SaleBuiltinRequirableField as v, type SaleCursorPage as w, type SaleFilters as x, type SaleInput as y, type SaleItem as z };

package/dist/{sales-BwWnvl8L.d.ts → sales-DzKvyVjY.d.mts}

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { a as ConversionConfigStore, c as TrackingConfigRuntime } from './tracking-config-runtime-BnUlS_Ae.mjs';
 import { CountryCode } from 'libphonenumber-js';
 
 /** Raw identifiers a caller may hand us (normalized before use). */
@@ -11,195 +12,6 @@ declare function stashUserData(data: ConversionUserData, country?: CountryCode):
 /** Drop everything (consent denial, tests). */
 declare function clearStashedUserData(): void;
 
-interface ServiceFiring {
-    send_to: string;
-    /** Action's configured default value (cents); the SDK fires it only when a sale has no amount. */
-    value_cents?: number | null;
-    currency?: string | null;
-}
-/** Serializable on-page trigger (owned by tracking-core/src/events/trigger-spec.ts). The shape
- * varies by `event_type`; only the parameter for that type is set. */
-interface ConfigTriggerSpec {
-    event_type: string;
-    threshold_percent?: number;
-    threshold_seconds?: number;
-    page_threshold?: number;
-    page_name?: string;
-}
-/** One unified conversion goal: a revenue `sale` or an on-page `event`. */
-interface ConversionGoal {
-    key: string;
-    label?: string;
-    kind: "sale" | "event";
-    /** Structured fire-when for event-goals; null for sales. */
-    trigger: ConfigTriggerSpec | null;
-    firing: ServiceFiring | null;
-}
-interface ConversionConfig {
-    schema_version: number;
-    config_version: number;
-    business_id?: string;
-    customer_id?: string | null;
-    environment?: string;
-    google_tracking_state: "active" | "disabled";
-    gtag_ids: Record<string, string>;
-    meta_pixel_ids: Record<string, string>;
-    /** LEGACY: sale-goals only (for pre-unified-goal readers). */
-    services: Array<{
-        key: string;
-        label?: string;
-        firing: ServiceFiring | null;
-    }>;
-    /** Unified goal list (sales + on-page events). Superset of `services`. */
-    goals: ConversionGoal[];
-}
-interface ConversionConfigStore {
-    /** Firing config for a goal/service key, or null when it doesn't fire on-site. */
-    getFiring(key: string): ServiceFiring | null;
-    /** The full goal for a key, or null when unknown. */
-    getGoal(key: string): ConversionGoal | null;
-    /** Every adopted goal (sales + events). */
-    listGoals(): ConversionGoal[];
-    /** The currently adopted config (baked / cached fallback until the fetch lands). */
-    current(): ConversionConfig | null;
-    /** True once a config is adopted (seeded synchronously from cache/baked, or fetched). */
-    isReady(): boolean;
-    /**
-     * Run `listener` when a config first becomes available — immediately if already
-     * ready, otherwise on the first adopt. Lets auto-fire replay automatic events that
-     * occurred before the async CDN fetch resolved. Returns an unsubscribe fn.
-     */
-    onResolve(listener: () => void): () => void;
-    /** Force a background revalidate against the CDN object. */
-    revalidate(): Promise<void>;
-}
-interface ResolveConversionConfigOptions {
-    /** Full URL of the per-business CDN object. */
-    cdnUrl: string;
-    /** Offline-correct fallback (e.g. the CLI-baked snapshot). */
-    baked?: ConversionConfig | null;
-    /** Injectable for tests / non-global-fetch runtimes. */
-    fetchImpl?: typeof fetch;
-}
-/**
- * Resolve the config with stale-while-revalidate: seed synchronously from the
- * sessionStorage cache (or the baked fallback), then conditionally re-fetch the CDN object
- * with `If-None-Match`. A fetched object is adopted only if its `config_version` is strictly
- * greater than what's cached, so a reordered edge copy can't downgrade fresher state.
- * Non-blocking and browser-only; a failed fetch leaves the seed in place.
- */
-declare function resolveConversionConfig(options: ResolveConversionConfigOptions): ConversionConfigStore;
-
-/**
- * Where a business's published tracking config lives.
- *
- * `businessId` + `environment` are the stable identity; the ORIGIN it is fetched
- * from is deployment-specific (production CDN vs. a local object store), which is
- * why `cdnBaseUrl` exists. Codegen bakes only the identity, so one committed
- * generated file works in every environment and only an env var changes.
- *
- * `cdnUrl` remains supported and WINS when present — every client repo generated
- * before `cdnBaseUrl` passes one, and those must keep working untouched.
- */
-interface TrackingConfigReference {
-    /**
-     * Fully-resolved object URL. Optional: omit it and pass `cdnBaseUrl` (or rely
-     * on the production default) to have it composed from the identity below.
-     */
-    cdnUrl?: string;
-    /**
-     * Origin (optionally with a path prefix) the config object is served from, e.g.
-     * `https://demos.aranova.io` in production or
-     * `http://localhost:9100/aranova-demos` against a local MinIO. Ignored when
-     * `cdnUrl` is set; blank or omitted falls back to {@link DEFAULT_CDN_BASE_URL}.
-     * `tracking-cli gen` wires this to an env var so retargeting is config, not code.
-     */
-    cdnBaseUrl?: string;
-    businessId: string;
-    environment: "production" | "test";
-}
-/**
- * The URL a reference resolves to. An explicit `cdnUrl` wins (back-compat);
- * otherwise compose from `cdnBaseUrl` (or the production default).
- *
- * A blank/whitespace `cdnBaseUrl` is treated as UNSET rather than composed: the
- * generated module reads it from an env var, and a var that is present-but-empty
- * (a stray `NEXT_PUBLIC_ARANOVA_CDN_BASE_URL=` line) would otherwise produce
- * `/tracking-config/...` — a same-origin request to the client's own site.
- */
-declare function resolveTrackingConfigUrl(ref: TrackingConfigReference): string;
-type RuntimeState = "unconfirmed" | "active" | "tombstone";
-interface QueuedConversion {
-    key: string;
-    value?: number | null;
-    currency?: string | null;
-    transactionId?: string | null;
-}
-type TrackingConfigConversionOptions = Omit<QueuedConversion, "key">;
-interface QueuedPageView {
-    href: string;
-    title: string | null;
-    referrer: string | null;
-}
-declare class TrackingConfigRuntime {
-    readonly ref: TrackingConfigReference;
-    private readonly fetchImpl;
-    /** Resolved config URL — see the constructor for why it is computed once. */
-    private readonly url;
-    private current;
-    private etag;
-    private stateValue;
-    private confirmedAt;
-    private authorityGeneration;
-    private inFlight;
-    private flushInFlight;
-    private flushRequested;
-    private retryTimer;
-    private started;
-    /** Consecutive failed authority attempts — drives the revalidate backoff. */
-    private authorityFailures;
-    /** Epoch ms before which `ensureAuthority` must not issue another request. */
-    private nextAuthorityAttemptAt;
-    private readonly conversionQueue;
-    private readonly automaticQueue;
-    private readonly pageQueue;
-    private readonly listeners;
-    constructor(ref: TrackingConfigReference, fetchImpl?: typeof fetch);
-    /** The URL this runtime actually fetches (composed or explicit). */
-    configUrl(): string;
-    /**
-     * Explicitly start authority resolution and Google-tag bootstrap.
-     *
-     * Idempotent so framework effects can call it after hydration without
-     * depending on constructor timing.
-     */
-    start(): void;
-    state(): RuntimeState;
-    config(): ConversionConfig | null;
-    __unsafeExpireAuthorityForTests(): void;
-    /** Queue depths — asserted by tests to pin the bound. */
-    __queueDepthsForTests(): {
-        conversions: number;
-        automatic: number;
-        pages: number;
-    };
-    subscribe(listener: () => void): () => void;
-    ensureAuthority(): Promise<boolean>;
-    revalidate(): Promise<void>;
-    private revalidateAuthority;
-    queuePageView(snapshot?: QueuedPageView | null): void;
-    fireConversion(key: string, options?: TrackingConfigConversionOptions): void;
-    queueAutomaticEvent(eventType: string, metadata: Record<string, unknown>, transactionPath: string, transactionScope: string): void;
-    listGoals(): ConversionGoal[];
-    private revalidateNow;
-    private expireAuthority;
-    private confirm;
-    private flush;
-    private scheduleRetry;
-    private flushNow;
-}
-declare function getTrackingConfigRuntime(ref: TrackingConfigReference, fetchImpl?: typeof fetch): TrackingConfigRuntime;
-
 /**
  * Sales / Conversions wire schemas — the client-side source of truth.
  *
@@ -582,6 +394,12 @@ interface Sale {
     updated_at: string;
     items: SaleItem[];
 }
+/**
+ * The offset page shape returned by the internal admin list, which this client
+ * never calls (`list()` is keyset and returns {@link SaleCursorPage}).
+ *
+ * @deprecated Unused by this client — no verb returns or accepts it. Kept for one release; removed in the next major.
+ */
 interface SaleListPage {
     items: Sale[];
     total: number;
@@ -594,9 +412,10 @@ interface SaleCursorPage {
     has_more?: boolean;
 }
 /**
- * Sortable columns on the secret-key (keyset) and admin (offset) list endpoints.
- * `business_name` only applies to the cross-business admin list — it sorts the
- * joined `businesses.name` column.
+ * Sortable columns on the internal admin (offset) list. `list()` is typed to
+ * {@link SaleKeysetSortField}, which omits `customer_name` and `business_name`.
+ *
+ * @deprecated Unused by this client — no verb returns or accepts it. Kept for one release; removed in the next major.
  */
 type SaleSortField = "occurred_at" | "created_at" | "amount_total_cents" | "customer_name" | "business_name";
 type SaleSortOrder = "asc" | "desc";
@@ -628,10 +447,13 @@ interface SaleFilters {
  * 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.
+ * Ordering is selectable via `sort`/`order` on {@link SaleListQueryV2}. A cursor
+ * encodes a position under the sort it was minted with, so replaying it under a
+ * different sort is rejected (422) — page with the sort you started with.
+ */
+/**
+ * @deprecated Superseded by {@link SaleListQueryV2}, which is what `list()` accepts.
+ * Its ordering note was also stale — `sort`/`order` are supported. Removed in the next major.
  */
 interface SaleListQuery extends SaleFilters {
     limit?: number;
@@ -649,6 +471,10 @@ interface SaleListQueryV2 extends SaleListQuery {
 declare const TRACKING_RANGES: readonly ["24h", "7d", "30d"];
 type TrackingOverviewRange = (typeof TRACKING_RANGES)[number];
 /** Query input for `SalesClient.summary()` — filters + range + options. */
+/**
+ * @deprecated The v1 summary query. `summary()` accepts {@link SaleSummaryQueryV2};
+ * the v1 endpoint no longer exists. Removed in the next major.
+ */
 interface SaleSummaryQuery extends SaleFilters {
     range: TrackingOverviewRange;
     /** Include the per-category line-item breakdown (extra join; default false). */
@@ -688,6 +514,10 @@ interface SalesTrendPoint {
     sale_count: number;
     revenue_cents: number;
 }
+/**
+ * @deprecated The v1 summary response. `summary()` returns {@link SaleSummaryV2};
+ * the v1 endpoint no longer exists. Removed in the next major.
+ */
 interface SaleSummary {
     range: TrackingOverviewRange;
     business_id: string | null;
@@ -860,6 +690,23 @@ interface BusinessConfigFeatures {
     comparisons: boolean;
     retention: boolean;
 }
+/** A built-in customer field a business can require on every sale. */
+type SaleBuiltinRequirableField = "customer_name" | "customer_phone" | "customer_email" | "description";
+/** v1 value types. `enum` is single-select over the property's `options`. */
+type SalePropertyType = "string" | "number" | "boolean" | "enum" | "date";
+interface SalePropertyOption {
+    key: string;
+    label: string;
+}
+/** One custom sale property as the sale form sees it: overrides applied, options
+ * already filtered to the business's enabled subset. */
+interface EffectiveSaleProperty {
+    key: string;
+    label: string;
+    type: SalePropertyType;
+    required: boolean;
+    options?: SalePropertyOption[] | null;
+}
 interface BusinessConfig {
     business_id: string;
     display_name: string;
@@ -869,6 +716,11 @@ interface BusinessConfig {
     default_phone_country: string | null;
     services: BusinessConfigService[];
     features: BusinessConfigFeatures;
+    builtin_required: SaleBuiltinRequirableField[];
+    properties: EffectiveSaleProperty[];
+    /** Whether the form should pre-tick the SMS consent box. A form default only —
+     * the per-sale `sms_consent` attestation is what every send path gates on. */
+    sms_consent_default_opt_in: boolean;
 }
 
 /** Shared config for every awaited (non fire-and-forget) API helper. */
@@ -937,10 +789,10 @@ interface SalesClient<TService extends string = string, TConversion extends stri
         occurred_at?: string;
     }): Promise<Sale>;
     /**
-     * Record a revenue sale — the intent-revealing alias of {@link record} in the unified-goal
-     * API. POSTs `/sales` and ALSO fires the on-site conversion when the sale-goal is
-     * WEBPAGE-mapped. Use this for anything with real revenue; use {@link trackConversion} for a
-     * non-revenue on-page event.
+     * Record a revenue sale — the intent-revealing alias of {@link record}. Identical
+     * behavior (same function reference): POSTs `/sales` and fires the on-site conversion
+     * when the sale-goal is WEBPAGE-mapped. Use either for real revenue; use
+     * {@link trackConversion} for a non-revenue on-page event.
      */
     recordSale(input: Omit<SaleInput, "currency" | "occurred_at" | "service" | "services"> & {
         service?: TService | null;
@@ -1046,4 +898,4 @@ interface PublicServiceItem {
  */
 declare function fetchServices(config: SalesTransportConfig): Promise<PublicServiceItem[]>;
 
-export { type SalesClient as $, AranovaApiError as A, type BusinessConfig as B, type ConversionConfig as C, type DistinctCustomersByCurrency as D, type SaleItem as E, type SaleItemInput as F, type Granularity as G, type SaleKeysetSortField as H, type SaleListPage as I, type SaleListQuery as J, type SaleListQueryV2 as K, type SaleService as L, type SaleServiceInput as M, NAMED_RANGES as N, type SaleSortField as O, type PublicServiceItem as P, type SaleSortOrder as Q, type SaleSummary as R, SUPPORTED_CURRENCIES as S, type TrackingConfigReference as T, type SaleSummaryPrevious as U, type SaleSummaryQuery as V, type SaleSummaryQueryV2 as W, type SaleSummaryV2 as X, type SaleUpdateInput as Y, type SalesBusinessClient as Z, type SalesCategoryBreakdown as _, type BusinessConfigFeatures as a, type SalesClientConfig as a0, type SalesCustomersClient as a1, type SalesServiceBreakdown as a2, type SalesTransportConfig as a3, type SalesTrendPoint as a4, type SummaryCurrencyDelta as a5, type SummaryDeltas as a6, type SummaryWindow as a7, type SupportedCurrency as a8, TRACKING_RANGES as a9, type TrackingOverviewRange as aa, clearStashedUserData as ab, createSalesClient as ac, fetchServices as ad, formatDateInTz as ae, formatMoney as af, fromMinor as ag, getTrackingConfigRuntime as ah, resolveConversionConfig as ai, resolveTrackingConfigUrl as aj, saleCreateSchema as ak, saleItemSchema as al, saleServiceSchema as am, saleUpdateSchema as an, salesRequest as ao, stashUserData as ap, toMinor as aq, type BusinessConfigService as b, type CompareTo as c, type ConversionConfigStore as d, type ConversionUserData as e, type CurrencyRevenue as f, type CustomerCurrencyDelta as g, type CustomerCurrencyTotal as h, type CustomerGetOptions as i, type CustomerGetResult as j, type CustomerKpis as k, type CustomerKpisDeltas as l, type CustomerKpisPrevious as m, type CustomerListPage as n, type CustomerListQuery as o, type CustomerProfile as p, type CustomerSegment as q, type CustomerSegmentCount as r, type CustomerSortField as s, type CustomerSummary as t, type CustomerSummaryQuery as u, type NamedRange as v, type Sale as w, type SaleCursorPage as x, type SaleFilters as y, type SaleInput as z };
+export { type SalesCategoryBreakdown as $, AranovaApiError as A, type BusinessConfig as B, type CompareTo as C, type DistinctCustomersByCurrency as D, type EffectiveSaleProperty as E, type SaleItemInput as F, type Granularity as G, type SaleKeysetSortField as H, type SaleListPage as I, type SaleListQuery as J, type SaleListQueryV2 as K, type SalePropertyOption as L, type SalePropertyType as M, NAMED_RANGES as N, type SaleService as O, type PublicServiceItem as P, type SaleServiceInput as Q, type SaleSortField as R, SUPPORTED_CURRENCIES as S, type SaleSortOrder as T, type SaleSummary as U, type SaleSummaryPrevious as V, type SaleSummaryQuery as W, type SaleSummaryQueryV2 as X, type SaleSummaryV2 as Y, type SaleUpdateInput as Z, type SalesBusinessClient as _, type BusinessConfigFeatures as a, type SalesClient as a0, type SalesClientConfig as a1, type SalesCustomersClient as a2, type SalesServiceBreakdown as a3, type SalesTransportConfig as a4, type SalesTrendPoint as a5, type SummaryCurrencyDelta as a6, type SummaryDeltas as a7, type SummaryWindow as a8, type SupportedCurrency as a9, TRACKING_RANGES as aa, type TrackingOverviewRange as ab, clearStashedUserData as ac, createSalesClient as ad, fetchServices as ae, formatDateInTz as af, formatMoney as ag, fromMinor as ah, saleCreateSchema as ai, saleItemSchema as aj, saleServiceSchema as ak, saleUpdateSchema as al, salesRequest as am, stashUserData as an, toMinor as ao, type BusinessConfigService as b, type ConversionUserData as c, type CurrencyRevenue as d, type CustomerCurrencyDelta as e, type CustomerCurrencyTotal as f, type CustomerGetOptions as g, type CustomerGetResult as h, type CustomerKpis as i, type CustomerKpisDeltas as j, type CustomerKpisPrevious as k, type CustomerListPage as l, type CustomerListQuery as m, type CustomerProfile as n, type CustomerSegment as o, type CustomerSegmentCount as p, type CustomerSortField as q, type CustomerSummary as r, type CustomerSummaryQuery as s, type NamedRange as t, type Sale as u, type SaleBuiltinRequirableField as v, type SaleCursorPage as w, type SaleFilters as x, type SaleInput as y, type SaleItem as z };