@aranova/tracking-next 0.25.0 → 0.26.0

package/dist/{sales-Xs375f6t.d.mts → sales-f1iXwlaV.d.mts}

@@ -396,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;
@@ -408,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";
@@ -442,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;
@@ -463,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). */
@@ -502,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;
@@ -674,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;
@@ -683,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;
@@ -733,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;
@@ -817,4 +857,4 @@ interface PublicServiceItem {
  */
 declare function fetchServices(config: SalesTransportConfig): Promise<PublicServiceItem[]>;
 
-export { type SalesTransportConfig as $, type SaleKeysetSortField as A, type BusinessConfig as B, type CompareTo as C, type DistinctCustomersByCurrency as D, type SaleListPage as E, type SaleListQuery as F, type Granularity as G, type SaleListQueryV2 as H, type SaleService as I, type SaleServiceInput as J, type SaleSortField as K, type SaleSortOrder as L, type SaleSummary as M, NAMED_RANGES as N, type SaleSummaryPrevious as O, type PublicServiceItem as P, type SaleSummaryQuery as Q, type SaleSummaryQueryV2 as R, SUPPORTED_CURRENCIES as S, type SaleSummaryV2 as T, type SaleUpdateInput as U, type SalesBusinessClient as V, type SalesCategoryBreakdown as W, type SalesClient as X, type SalesClientConfig as Y, type SalesCustomersClient as Z, type SalesServiceBreakdown as _, type BusinessConfigFeatures as a, type SalesTrendPoint as a0, type SummaryCurrencyDelta as a1, type SummaryDeltas as a2, type SummaryWindow as a3, type SupportedCurrency as a4, TRACKING_RANGES as a5, type TrackingOverviewRange as a6, clearStashedUserData as a7, createSalesClient as a8, fetchServices as a9, formatMoney as aa, fromMinor as ab, saleCreateSchema as ac, saleItemSchema as ad, saleServiceSchema as ae, saleUpdateSchema as af, salesRequest as ag, stashUserData as ah, toMinor as ai, 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 SaleCursorPage as v, type SaleFilters as w, type SaleInput as x, type SaleItem as y, type SaleItemInput 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.d.mts

@@ -1,4 +1,4 @@
-export { B as BusinessConfig, a as BusinessConfigFeatures, b as BusinessConfigService, C as CompareTo, d as CurrencyRevenue, e as CustomerCurrencyDelta, f as CustomerCurrencyTotal, g as CustomerGetOptions, h as CustomerGetResult, i as CustomerKpis, j as CustomerKpisDeltas, k as CustomerKpisPrevious, l as CustomerListPage, m as CustomerListQuery, n as CustomerProfile, o as CustomerSegment, p as CustomerSegmentCount, q as CustomerSortField, r as CustomerSummary, s as CustomerSummaryQuery, D as DistinctCustomersByCurrency, G as Granularity, N as NAMED_RANGES, t as NamedRange, P as PublicServiceItem, S as SUPPORTED_CURRENCIES, u as Sale, v as SaleCursorPage, w as SaleFilters, x as SaleInput, y as SaleItem, z as SaleItemInput, A as SaleKeysetSortField, E as SaleListPage, F as SaleListQuery, H as SaleListQueryV2, I as SaleService, J as SaleServiceInput, K as SaleSortField, L as SaleSortOrder, M as SaleSummary, O as SaleSummaryPrevious, Q as SaleSummaryQuery, R as SaleSummaryQueryV2, T as SaleSummaryV2, U as SaleUpdateInput, V as SalesBusinessClient, W as SalesCategoryBreakdown, X as SalesClient, Y as SalesClientConfig, Z as SalesCustomersClient, _ as SalesServiceBreakdown, $ as SalesTransportConfig, a0 as SalesTrendPoint, a1 as SummaryCurrencyDelta, a2 as SummaryDeltas, a3 as SummaryWindow, a4 as SupportedCurrency, a5 as TRACKING_RANGES, a6 as TrackingOverviewRange, a8 as createSalesClient, a9 as fetchServices, aa as formatMoney, ab as fromMinor, ac as saleCreateSchema, ad as saleItemSchema, ae as saleServiceSchema, af as saleUpdateSchema, ag as salesRequest, ai as toMinor } from './sales-Xs375f6t.mjs';
+export { B as BusinessConfig, a as BusinessConfigFeatures, b as BusinessConfigService, C as CompareTo, d as CurrencyRevenue, e as CustomerCurrencyDelta, f as CustomerCurrencyTotal, g as CustomerGetOptions, h as CustomerGetResult, i as CustomerKpis, j as CustomerKpisDeltas, k as CustomerKpisPrevious, l as CustomerListPage, m as CustomerListQuery, n as CustomerProfile, o as CustomerSegment, p as CustomerSegmentCount, q as CustomerSortField, r as CustomerSummary, s as CustomerSummaryQuery, D as DistinctCustomersByCurrency, E as EffectiveSaleProperty, G as Granularity, N as NAMED_RANGES, t as NamedRange, P as PublicServiceItem, S as SUPPORTED_CURRENCIES, u as Sale, v as SaleBuiltinRequirableField, w as SaleCursorPage, x as SaleFilters, y as SaleInput, z as SaleItem, A as SaleItemInput, F as SaleKeysetSortField, H as SaleListPage, I as SaleListQuery, J as SaleListQueryV2, K as SalePropertyOption, L as SalePropertyType, M as SaleService, O as SaleServiceInput, Q as SaleSortField, R as SaleSortOrder, T as SaleSummary, U as SaleSummaryPrevious, V as SaleSummaryQuery, W as SaleSummaryQueryV2, X as SaleSummaryV2, Y as SaleUpdateInput, Z as SalesBusinessClient, _ as SalesCategoryBreakdown, $ as SalesClient, a0 as SalesClientConfig, a1 as SalesCustomersClient, a2 as SalesServiceBreakdown, a3 as SalesTransportConfig, a4 as SalesTrendPoint, a5 as SummaryCurrencyDelta, a6 as SummaryDeltas, a7 as SummaryWindow, a8 as SupportedCurrency, a9 as TRACKING_RANGES, aa as TrackingOverviewRange, ac as createSalesClient, ad as fetchServices, ae as formatMoney, af as fromMinor, ag as saleCreateSchema, ah as saleItemSchema, ai as saleServiceSchema, aj as saleUpdateSchema, ak as salesRequest, am as toMinor } from './sales-f1iXwlaV.mjs';
 export { A as AranovaApiError, f as formatDateInTz } from './date-BHetnL7s.mjs';
 import 'zod';
 import './tracking-config-runtime-BnUlS_Ae.mjs';

package/dist/sales.d.ts

@@ -1,4 +1,4 @@
-export { B as BusinessConfig, a as BusinessConfigFeatures, b as BusinessConfigService, C as CompareTo, d as CurrencyRevenue, e as CustomerCurrencyDelta, f as CustomerCurrencyTotal, g as CustomerGetOptions, h as CustomerGetResult, i as CustomerKpis, j as CustomerKpisDeltas, k as CustomerKpisPrevious, l as CustomerListPage, m as CustomerListQuery, n as CustomerProfile, o as CustomerSegment, p as CustomerSegmentCount, q as CustomerSortField, r as CustomerSummary, s as CustomerSummaryQuery, D as DistinctCustomersByCurrency, G as Granularity, N as NAMED_RANGES, t as NamedRange, P as PublicServiceItem, S as SUPPORTED_CURRENCIES, u as Sale, v as SaleCursorPage, w as SaleFilters, x as SaleInput, y as SaleItem, z as SaleItemInput, A as SaleKeysetSortField, E as SaleListPage, F as SaleListQuery, H as SaleListQueryV2, I as SaleService, J as SaleServiceInput, K as SaleSortField, L as SaleSortOrder, M as SaleSummary, O as SaleSummaryPrevious, Q as SaleSummaryQuery, R as SaleSummaryQueryV2, T as SaleSummaryV2, U as SaleUpdateInput, V as SalesBusinessClient, W as SalesCategoryBreakdown, X as SalesClient, Y as SalesClientConfig, Z as SalesCustomersClient, _ as SalesServiceBreakdown, $ as SalesTransportConfig, a0 as SalesTrendPoint, a1 as SummaryCurrencyDelta, a2 as SummaryDeltas, a3 as SummaryWindow, a4 as SupportedCurrency, a5 as TRACKING_RANGES, a6 as TrackingOverviewRange, a8 as createSalesClient, a9 as fetchServices, aa as formatMoney, ab as fromMinor, ac as saleCreateSchema, ad as saleItemSchema, ae as saleServiceSchema, af as saleUpdateSchema, ag as salesRequest, ai as toMinor } from './sales-Bv1tihaB.js';
+export { B as BusinessConfig, a as BusinessConfigFeatures, b as BusinessConfigService, C as CompareTo, d as CurrencyRevenue, e as CustomerCurrencyDelta, f as CustomerCurrencyTotal, g as CustomerGetOptions, h as CustomerGetResult, i as CustomerKpis, j as CustomerKpisDeltas, k as CustomerKpisPrevious, l as CustomerListPage, m as CustomerListQuery, n as CustomerProfile, o as CustomerSegment, p as CustomerSegmentCount, q as CustomerSortField, r as CustomerSummary, s as CustomerSummaryQuery, D as DistinctCustomersByCurrency, E as EffectiveSaleProperty, G as Granularity, N as NAMED_RANGES, t as NamedRange, P as PublicServiceItem, S as SUPPORTED_CURRENCIES, u as Sale, v as SaleBuiltinRequirableField, w as SaleCursorPage, x as SaleFilters, y as SaleInput, z as SaleItem, A as SaleItemInput, F as SaleKeysetSortField, H as SaleListPage, I as SaleListQuery, J as SaleListQueryV2, K as SalePropertyOption, L as SalePropertyType, M as SaleService, O as SaleServiceInput, Q as SaleSortField, R as SaleSortOrder, T as SaleSummary, U as SaleSummaryPrevious, V as SaleSummaryQuery, W as SaleSummaryQueryV2, X as SaleSummaryV2, Y as SaleUpdateInput, Z as SalesBusinessClient, _ as SalesCategoryBreakdown, $ as SalesClient, a0 as SalesClientConfig, a1 as SalesCustomersClient, a2 as SalesServiceBreakdown, a3 as SalesTransportConfig, a4 as SalesTrendPoint, a5 as SummaryCurrencyDelta, a6 as SummaryDeltas, a7 as SummaryWindow, a8 as SupportedCurrency, a9 as TRACKING_RANGES, aa as TrackingOverviewRange, ac as createSalesClient, ad as fetchServices, ae as formatMoney, af as fromMinor, ag as saleCreateSchema, ah as saleItemSchema, ai as saleServiceSchema, aj as saleUpdateSchema, ak as salesRequest, am as toMinor } from './sales-C3dIw4LW.js';
 export { A as AranovaApiError, f as formatDateInTz } from './date-BHetnL7s.js';
 import 'zod';
 import './tracking-config-runtime-BnUlS_Ae.js';