@aranova/tracking-react 0.20.2 → 0.21.0

package/dist/{sales-DrH6dY5F.d.mts → sales-CBQJ2SBT.d.mts}

@@ -815,14 +815,11 @@ interface BusinessConfig {
     features: BusinessConfigFeatures;
 }
 
-/** Shared config for every sales HTTP helper. */
-interface SalesTransportConfig {
+/** Shared config for every awaited (non fire-and-forget) API helper. */
+interface ApiTransportConfig {
     /** Public (`aranv_pk_…`) or secret (`aranv_sk_…`) API key. */
     apiKey: string;
-    /**
-     * Base tracking endpoint, e.g. `https://aranovainternal-production.up.railway.app/tracking`.
-     * The `/sales` path is appended by the helpers.
-     */
+    /** Base tracking endpoint, e.g. `https://aranovainternal-production.up.railway.app/tracking`. */
     endpoint: string;
     /** Optional SDK identity headers (mirrors the event ingest client). */
     sdkVersion?: string;
@@ -831,11 +828,13 @@ interface SalesTransportConfig {
     environment?: string;
 }
 /**
- * Single awaited request used by every sales helper. Unlike the event queue,
- * this surfaces failures: any non-2xx rejects with an {@link AranovaApiError}.
- * Returns `undefined` for 204 No Content.
+ * Single awaited request. Unlike the event queue, this surfaces failures: any
+ * non-2xx rejects with an {@link AranovaApiError}. Returns `undefined` for 204.
  */
-declare function salesRequest<T>(config: SalesTransportConfig, method: string, path: string, body?: unknown): Promise<T>;
+declare function apiRequest<T>(config: ApiTransportConfig, method: string, path: string, body?: unknown, extraHeaders?: Record<string, string>): Promise<T>;
+
+type SalesTransportConfig = ApiTransportConfig;
+declare const salesRequest: typeof apiRequest;
 
 /** Config for {@link createSalesClient}. */
 interface SalesClientConfig extends SalesTransportConfig {
@@ -938,9 +937,11 @@ interface SalesClient<TService extends string = string, TConversion extends stri
 declare function createSalesClient<TService extends string = string, TConversion extends string = string>(config: SalesClientConfig): SalesClient<TService, TConversion>;
 
 /**
- * Error thrown by the sales client (`createSalesClient`) on a
- * non-2xx response. Unlike the fire-and-forget event queue (which swallows
- * failures), a sale is a transaction the caller must be able to react to.
+ * Thrown on a non-2xx from any awaited Aranova API call.
+ *
+ * Lives here rather than inside one resource because more than one resource
+ * needs it, and a duplicate class would be a genuine hazard: a name star-exported
+ * from two modules is silently dropped unless both resolve to the same binding.
  */
 declare class AranovaApiError extends Error {
     readonly status: number;
@@ -953,6 +954,13 @@ declare class AranovaApiError extends Error {
     });
 }
 
+/**
+ * Format an ISO timestamp in a specific IANA time zone (e.g. `America/Toronto`),
+ * so dashboards stop hand-rolling `Intl`. Defaults to a short date-time; pass
+ * `opts` to override fields. The `timeZone` is always forced to the argument.
+ */
+declare function formatDateInTz(iso: string, timeZone: string, opts?: Intl.DateTimeFormatOptions, locale?: string): string;
+
 /**
  * Convert a major amount (dollars `250.5`) to integer minor units (`25050`).
  *
@@ -969,12 +977,6 @@ declare function fromMinor(cents: number, currency: SupportedCurrency): number;
  * Uses the built-in `Intl.NumberFormat` — no extra dependency.
  */
 declare function formatMoney(cents: number, currency: SupportedCurrency, locale?: string): string;
-/**
- * Format an ISO timestamp in a specific IANA time zone (e.g. `America/Toronto`),
- * so dashboards stop hand-rolling `Intl`. Defaults to a short date-time; pass
- * `opts` to override fields. The `timeZone` is always forced to the argument.
- */
-declare function formatDateInTz(iso: string, timeZone: string, opts?: Intl.DateTimeFormatOptions, locale?: string): string;
 
 /** A business's active service, as returned by `GET /tracking/services`. */
 interface PublicServiceItem {

package/dist/{sales-DrH6dY5F.d.ts → sales-CBQJ2SBT.d.ts}

@@ -815,14 +815,11 @@ interface BusinessConfig {
     features: BusinessConfigFeatures;
 }
 
-/** Shared config for every sales HTTP helper. */
-interface SalesTransportConfig {
+/** Shared config for every awaited (non fire-and-forget) API helper. */
+interface ApiTransportConfig {
     /** Public (`aranv_pk_…`) or secret (`aranv_sk_…`) API key. */
     apiKey: string;
-    /**
-     * Base tracking endpoint, e.g. `https://aranovainternal-production.up.railway.app/tracking`.
-     * The `/sales` path is appended by the helpers.
-     */
+    /** Base tracking endpoint, e.g. `https://aranovainternal-production.up.railway.app/tracking`. */
     endpoint: string;
     /** Optional SDK identity headers (mirrors the event ingest client). */
     sdkVersion?: string;
@@ -831,11 +828,13 @@ interface SalesTransportConfig {
     environment?: string;
 }
 /**
- * Single awaited request used by every sales helper. Unlike the event queue,
- * this surfaces failures: any non-2xx rejects with an {@link AranovaApiError}.
- * Returns `undefined` for 204 No Content.
+ * Single awaited request. Unlike the event queue, this surfaces failures: any
+ * non-2xx rejects with an {@link AranovaApiError}. Returns `undefined` for 204.
  */
-declare function salesRequest<T>(config: SalesTransportConfig, method: string, path: string, body?: unknown): Promise<T>;
+declare function apiRequest<T>(config: ApiTransportConfig, method: string, path: string, body?: unknown, extraHeaders?: Record<string, string>): Promise<T>;
+
+type SalesTransportConfig = ApiTransportConfig;
+declare const salesRequest: typeof apiRequest;
 
 /** Config for {@link createSalesClient}. */
 interface SalesClientConfig extends SalesTransportConfig {
@@ -938,9 +937,11 @@ interface SalesClient<TService extends string = string, TConversion extends stri
 declare function createSalesClient<TService extends string = string, TConversion extends string = string>(config: SalesClientConfig): SalesClient<TService, TConversion>;
 
 /**
- * Error thrown by the sales client (`createSalesClient`) on a
- * non-2xx response. Unlike the fire-and-forget event queue (which swallows
- * failures), a sale is a transaction the caller must be able to react to.
+ * Thrown on a non-2xx from any awaited Aranova API call.
+ *
+ * Lives here rather than inside one resource because more than one resource
+ * needs it, and a duplicate class would be a genuine hazard: a name star-exported
+ * from two modules is silently dropped unless both resolve to the same binding.
  */
 declare class AranovaApiError extends Error {
     readonly status: number;
@@ -953,6 +954,13 @@ declare class AranovaApiError extends Error {
     });
 }
 
+/**
+ * Format an ISO timestamp in a specific IANA time zone (e.g. `America/Toronto`),
+ * so dashboards stop hand-rolling `Intl`. Defaults to a short date-time; pass
+ * `opts` to override fields. The `timeZone` is always forced to the argument.
+ */
+declare function formatDateInTz(iso: string, timeZone: string, opts?: Intl.DateTimeFormatOptions, locale?: string): string;
+
 /**
  * Convert a major amount (dollars `250.5`) to integer minor units (`25050`).
  *
@@ -969,12 +977,6 @@ declare function fromMinor(cents: number, currency: SupportedCurrency): number;
  * Uses the built-in `Intl.NumberFormat` — no extra dependency.
  */
 declare function formatMoney(cents: number, currency: SupportedCurrency, locale?: string): string;
-/**
- * Format an ISO timestamp in a specific IANA time zone (e.g. `America/Toronto`),
- * so dashboards stop hand-rolling `Intl`. Defaults to a short date-time; pass
- * `opts` to override fields. The `timeZone` is always forced to the argument.
- */
-declare function formatDateInTz(iso: string, timeZone: string, opts?: Intl.DateTimeFormatOptions, locale?: string): string;
 
 /** A business's active service, as returned by `GET /tracking/services`. */
 interface PublicServiceItem {

package/dist/sales.d.mts

@@ -1,3 +1,3 @@
-export { A as AranovaApiError, B as BusinessConfig, a as BusinessConfigFeatures, b as BusinessConfigService, c as CompareTo, f as CurrencyRevenue, g as CustomerCurrencyDelta, h as CustomerCurrencyTotal, i as CustomerGetOptions, j as CustomerGetResult, k as CustomerKpis, l as CustomerKpisDeltas, m as CustomerKpisPrevious, n as CustomerListPage, o as CustomerListQuery, p as CustomerProfile, q as CustomerSegment, r as CustomerSegmentCount, s as CustomerSortField, t as CustomerSummary, u as CustomerSummaryQuery, D as DistinctCustomersByCurrency, G as Granularity, N as NAMED_RANGES, v as NamedRange, P as PublicServiceItem, S as SUPPORTED_CURRENCIES, w as Sale, x as SaleCursorPage, y as SaleFilters, z as SaleInput, E as SaleItem, F as SaleItemInput, H as SaleKeysetSortField, I as SaleListPage, J as SaleListQuery, K as SaleListQueryV2, L as SaleService, M as SaleServiceInput, O as SaleSortField, Q as SaleSortOrder, R 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 formatDateInTz, af as formatMoney, ag as fromMinor, aj as saleCreateSchema, ak as saleItemSchema, al as saleServiceSchema, am as saleUpdateSchema, an as salesRequest, ap as toMinor } from './sales-DrH6dY5F.mjs';
+export { A as AranovaApiError, B as BusinessConfig, a as BusinessConfigFeatures, b as BusinessConfigService, c as CompareTo, f as CurrencyRevenue, g as CustomerCurrencyDelta, h as CustomerCurrencyTotal, i as CustomerGetOptions, j as CustomerGetResult, k as CustomerKpis, l as CustomerKpisDeltas, m as CustomerKpisPrevious, n as CustomerListPage, o as CustomerListQuery, p as CustomerProfile, q as CustomerSegment, r as CustomerSegmentCount, s as CustomerSortField, t as CustomerSummary, u as CustomerSummaryQuery, D as DistinctCustomersByCurrency, G as Granularity, N as NAMED_RANGES, v as NamedRange, P as PublicServiceItem, S as SUPPORTED_CURRENCIES, w as Sale, x as SaleCursorPage, y as SaleFilters, z as SaleInput, E as SaleItem, F as SaleItemInput, H as SaleKeysetSortField, I as SaleListPage, J as SaleListQuery, K as SaleListQueryV2, L as SaleService, M as SaleServiceInput, O as SaleSortField, Q as SaleSortOrder, R 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 formatDateInTz, af as formatMoney, ag as fromMinor, aj as saleCreateSchema, ak as saleItemSchema, al as saleServiceSchema, am as saleUpdateSchema, an as salesRequest, ap as toMinor } from './sales-CBQJ2SBT.mjs';
 import 'zod';
 import 'libphonenumber-js';

package/dist/sales.d.ts

@@ -1,3 +1,3 @@
-export { A as AranovaApiError, B as BusinessConfig, a as BusinessConfigFeatures, b as BusinessConfigService, c as CompareTo, f as CurrencyRevenue, g as CustomerCurrencyDelta, h as CustomerCurrencyTotal, i as CustomerGetOptions, j as CustomerGetResult, k as CustomerKpis, l as CustomerKpisDeltas, m as CustomerKpisPrevious, n as CustomerListPage, o as CustomerListQuery, p as CustomerProfile, q as CustomerSegment, r as CustomerSegmentCount, s as CustomerSortField, t as CustomerSummary, u as CustomerSummaryQuery, D as DistinctCustomersByCurrency, G as Granularity, N as NAMED_RANGES, v as NamedRange, P as PublicServiceItem, S as SUPPORTED_CURRENCIES, w as Sale, x as SaleCursorPage, y as SaleFilters, z as SaleInput, E as SaleItem, F as SaleItemInput, H as SaleKeysetSortField, I as SaleListPage, J as SaleListQuery, K as SaleListQueryV2, L as SaleService, M as SaleServiceInput, O as SaleSortField, Q as SaleSortOrder, R 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 formatDateInTz, af as formatMoney, ag as fromMinor, aj as saleCreateSchema, ak as saleItemSchema, al as saleServiceSchema, am as saleUpdateSchema, an as salesRequest, ap as toMinor } from './sales-DrH6dY5F.js';
+export { A as AranovaApiError, B as BusinessConfig, a as BusinessConfigFeatures, b as BusinessConfigService, c as CompareTo, f as CurrencyRevenue, g as CustomerCurrencyDelta, h as CustomerCurrencyTotal, i as CustomerGetOptions, j as CustomerGetResult, k as CustomerKpis, l as CustomerKpisDeltas, m as CustomerKpisPrevious, n as CustomerListPage, o as CustomerListQuery, p as CustomerProfile, q as CustomerSegment, r as CustomerSegmentCount, s as CustomerSortField, t as CustomerSummary, u as CustomerSummaryQuery, D as DistinctCustomersByCurrency, G as Granularity, N as NAMED_RANGES, v as NamedRange, P as PublicServiceItem, S as SUPPORTED_CURRENCIES, w as Sale, x as SaleCursorPage, y as SaleFilters, z as SaleInput, E as SaleItem, F as SaleItemInput, H as SaleKeysetSortField, I as SaleListPage, J as SaleListQuery, K as SaleListQueryV2, L as SaleService, M as SaleServiceInput, O as SaleSortField, Q as SaleSortOrder, R 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 formatDateInTz, af as formatMoney, ag as fromMinor, aj as saleCreateSchema, ak as saleItemSchema, al as saleServiceSchema, am as saleUpdateSchema, an as salesRequest, ap as toMinor } from './sales-CBQJ2SBT.js';
 import 'zod';
 import 'libphonenumber-js';

package/dist/sales.js

@@ -234,7 +234,7 @@ var SDK_PACKAGE_HEADER = "X-Aranova-Sdk-Package";
 var SDK_SURFACE_HEADER = "X-Aranova-Sdk-Surface";
 var SDK_ENVIRONMENT_HEADER = "X-Aranova-Sdk-Environment";
 
-// ../tracking-core/src/resources/sales/errors.ts
+// ../tracking-core/src/resources/http/errors.ts
 var AranovaApiError = class extends Error {
   constructor(message, options) {
     super(message);
@@ -245,7 +245,7 @@ var AranovaApiError = class extends Error {
   }
 };
 
-// ../tracking-core/src/resources/sales/transport.ts
+// ../tracking-core/src/resources/http/request.ts
 function identityHeaders(config) {
   const headers = { [API_KEY_HEADER]: config.apiKey };
   if (config.sdkVersion) headers[SDK_VERSION_HEADER] = config.sdkVersion;
@@ -257,8 +257,8 @@ function identityHeaders(config) {
 function joinUrl(endpoint, path) {
   return `${endpoint.replace(/\/$/, "")}${path}`;
 }
-async function salesRequest(config, method, path, body) {
-  const headers = identityHeaders(config);
+async function apiRequest(config, method, path, body, extraHeaders) {
+  const headers = { ...identityHeaders(config), ...extraHeaders };
   if (body !== void 0) headers["Content-Type"] = "application/json";
   const response = await fetch(joinUrl(config.endpoint, path), {
     method,
@@ -287,6 +287,24 @@ async function salesRequest(config, method, path, body) {
   return await response.json();
 }
 
+// ../tracking-core/src/resources/sales/transport.ts
+var salesRequest = apiRequest;
+
+// ../tracking-core/src/resources/intl/date.ts
+function formatDateInTz(iso, timeZone, opts, locale) {
+  const date = new Date(iso);
+  if (Number.isNaN(date.getTime())) return iso;
+  return new Intl.DateTimeFormat(locale, {
+    year: "numeric",
+    month: "short",
+    day: "2-digit",
+    hour: "2-digit",
+    minute: "2-digit",
+    ...opts,
+    timeZone
+  }).format(date);
+}
+
 // ../tracking-core/src/resources/sales/money.ts
 var MINOR_UNIT_EXPONENT = {
   USD: 2,
@@ -306,19 +324,6 @@ function formatMoney(cents, currency, locale) {
     fromMinor(cents, currency)
   );
 }
-function formatDateInTz(iso, timeZone, opts, locale) {
-  const date = new Date(iso);
-  if (Number.isNaN(date.getTime())) return iso;
-  return new Intl.DateTimeFormat(locale, {
-    year: "numeric",
-    month: "short",
-    day: "2-digit",
-    hour: "2-digit",
-    minute: "2-digit",
-    ...opts,
-    timeZone
-  }).format(date);
-}
 
 // ../tracking-core/src/resources/sales/client.ts
 function fireRecordedConversions(firing, input, recorded, sale, currency) {