@aranova/tracking-next 0.24.1 → 0.26.0

package/dist/{sales-D_BTsRuM.d.ts → sales-C3dIw4LW.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';
 import { A as ApiTransportConfig, a as apiRequest } from './request-Doq36Rt0.js';
 import './date-BHetnL7s.js';
@@ -13,195 +14,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.
  *
@@ -584,6 +396,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;
@@ -596,9 +414,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";
@@ -630,10 +449,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;
@@ -651,6 +473,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). */
@@ -690,6 +516,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;
@@ -862,6 +692,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;
@@ -871,6 +718,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;
 }
 
 type SalesTransportConfig = ApiTransportConfig;
@@ -921,10 +773,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;
@@ -1005,4 +857,4 @@ interface PublicServiceItem {
  */
 declare function fetchServices(config: SalesTransportConfig): Promise<PublicServiceItem[]>;
 
-export { type SalesClientConfig as $, type SaleItem as A, type BusinessConfig as B, type ConversionConfig as C, type DistinctCustomersByCurrency as D, type SaleItemInput as E, type SaleKeysetSortField as F, type Granularity as G, type SaleListPage as H, type SaleListQuery as I, type SaleListQueryV2 as J, type SaleService as K, type SaleServiceInput as L, type SaleSortField as M, NAMED_RANGES as N, type SaleSortOrder as O, type PublicServiceItem as P, type SaleSummary as Q, type SaleSummaryPrevious as R, SUPPORTED_CURRENCIES as S, type TrackingConfigReference as T, type SaleSummaryQuery as U, type SaleSummaryQueryV2 as V, type SaleSummaryV2 as W, type SaleUpdateInput as X, type SalesBusinessClient as Y, type SalesCategoryBreakdown as Z, type SalesClient as _, type BusinessConfigFeatures as a, type SalesCustomersClient as a0, type SalesServiceBreakdown as a1, type SalesTransportConfig as a2, type SalesTrendPoint as a3, type SummaryCurrencyDelta as a4, type SummaryDeltas as a5, type SummaryWindow as a6, type SupportedCurrency as a7, TRACKING_RANGES as a8, type TrackingOverviewRange as a9, clearStashedUserData as aa, createSalesClient as ab, fetchServices as ac, formatMoney as ad, fromMinor as ae, getTrackingConfigRuntime as af, resolveConversionConfig as ag, resolveTrackingConfigUrl 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 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 SalesClient as $, type SaleItemInput as A, type BusinessConfig as B, type CompareTo as C, type DistinctCustomersByCurrency as D, type EffectiveSaleProperty as E, type SaleKeysetSortField as F, type Granularity as G, type SaleListPage as H, type SaleListQuery as I, type SaleListQueryV2 as J, type SalePropertyOption as K, type SalePropertyType as L, type SaleService as M, NAMED_RANGES as N, type SaleServiceInput as O, type PublicServiceItem as P, type SaleSortField as Q, type SaleSortOrder as R, SUPPORTED_CURRENCIES as S, type SaleSummary 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, formatMoney as ae, fromMinor as af, saleCreateSchema as ag, saleItemSchema as ah, saleServiceSchema as ai, saleUpdateSchema as aj, salesRequest as ak, stashUserData as al, toMinor as am, 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-CmlzRq3u.d.mts → sales-f1iXwlaV.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';
 import { A as ApiTransportConfig, a as apiRequest } from './request-Doq36Rt0.mjs';
 import './date-BHetnL7s.mjs';
@@ -13,195 +14,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.
  *
@@ -584,6 +396,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;
@@ -596,9 +414,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";
@@ -630,10 +449,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;
@@ -651,6 +473,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). */
@@ -690,6 +516,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;
@@ -862,6 +692,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;
@@ -871,6 +718,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;
 }
 
 type SalesTransportConfig = ApiTransportConfig;
@@ -921,10 +773,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;
@@ -1005,4 +857,4 @@ interface PublicServiceItem {
  */
 declare function fetchServices(config: SalesTransportConfig): Promise<PublicServiceItem[]>;
 
-export { type SalesClientConfig as $, type SaleItem as A, type BusinessConfig as B, type ConversionConfig as C, type DistinctCustomersByCurrency as D, type SaleItemInput as E, type SaleKeysetSortField as F, type Granularity as G, type SaleListPage as H, type SaleListQuery as I, type SaleListQueryV2 as J, type SaleService as K, type SaleServiceInput as L, type SaleSortField as M, NAMED_RANGES as N, type SaleSortOrder as O, type PublicServiceItem as P, type SaleSummary as Q, type SaleSummaryPrevious as R, SUPPORTED_CURRENCIES as S, type TrackingConfigReference as T, type SaleSummaryQuery as U, type SaleSummaryQueryV2 as V, type SaleSummaryV2 as W, type SaleUpdateInput as X, type SalesBusinessClient as Y, type SalesCategoryBreakdown as Z, type SalesClient as _, type BusinessConfigFeatures as a, type SalesCustomersClient as a0, type SalesServiceBreakdown as a1, type SalesTransportConfig as a2, type SalesTrendPoint as a3, type SummaryCurrencyDelta as a4, type SummaryDeltas as a5, type SummaryWindow as a6, type SupportedCurrency as a7, TRACKING_RANGES as a8, type TrackingOverviewRange as a9, clearStashedUserData as aa, createSalesClient as ab, fetchServices as ac, formatMoney as ad, fromMinor as ae, getTrackingConfigRuntime as af, resolveConversionConfig as ag, resolveTrackingConfigUrl 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 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 SalesClient as $, type SaleItemInput as A, type BusinessConfig as B, type CompareTo as C, type DistinctCustomersByCurrency as D, type EffectiveSaleProperty as E, type SaleKeysetSortField as F, type Granularity as G, type SaleListPage as H, type SaleListQuery as I, type SaleListQueryV2 as J, type SalePropertyOption as K, type SalePropertyType as L, type SaleService as M, NAMED_RANGES as N, type SaleServiceInput as O, type PublicServiceItem as P, type SaleSortField as Q, type SaleSortOrder as R, SUPPORTED_CURRENCIES as S, type SaleSummary 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, formatMoney as ae, fromMinor as af, saleCreateSchema as ag, saleItemSchema as ah, saleServiceSchema as ai, saleUpdateSchema as aj, salesRequest as ak, stashUserData as al, toMinor as am, 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 };