@aranova/tracking-react 0.8.0 → 0.9.0

package/dist/index.d.mts

@@ -1464,6 +1464,9 @@ declare const saleCreateSchema: z.ZodObject<{
         unit_cost_cents?: number | null | undefined;
     }>, "many">>;
     metadata: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    customer_name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    customer_phone: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    customer_email: z.ZodOptional<z.ZodNullable<z.ZodString>>;
 }, "strict", z.ZodTypeAny, {
     currency: "USD" | "CAD";
     amount_total_cents: number;
@@ -1481,6 +1484,9 @@ declare const saleCreateSchema: z.ZodObject<{
     external_id?: string | null | undefined;
     description?: string | null | undefined;
     service?: string | null | undefined;
+    customer_name?: string | null | undefined;
+    customer_phone?: string | null | undefined;
+    customer_email?: string | null | undefined;
 }, {
     currency: "USD" | "CAD";
     amount_total_cents: number;
@@ -1498,6 +1504,9 @@ declare const saleCreateSchema: z.ZodObject<{
         category?: string | null | undefined;
         unit_cost_cents?: number | null | undefined;
     }[] | undefined;
+    customer_name?: string | null | undefined;
+    customer_phone?: string | null | undefined;
+    customer_email?: string | null | undefined;
 }>;
 declare const saleUpdateSchema: z.ZodObject<{
     description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -1528,6 +1537,9 @@ declare const saleUpdateSchema: z.ZodObject<{
         unit_cost_cents?: number | null | undefined;
     }>, "many">>;
     metadata: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    customer_name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    customer_phone: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    customer_email: z.ZodOptional<z.ZodNullable<z.ZodString>>;
 }, "strict", z.ZodTypeAny, {
     metadata?: Record<string, unknown> | null | undefined;
     description?: string | null | undefined;
@@ -1543,6 +1555,9 @@ declare const saleUpdateSchema: z.ZodObject<{
         category?: string | null | undefined;
         unit_cost_cents?: number | null | undefined;
     }[] | undefined;
+    customer_name?: string | null | undefined;
+    customer_phone?: string | null | undefined;
+    customer_email?: string | null | undefined;
 }, {
     metadata?: Record<string, unknown> | null | undefined;
     description?: string | null | undefined;
@@ -1558,6 +1573,9 @@ declare const saleUpdateSchema: z.ZodObject<{
         category?: string | null | undefined;
         unit_cost_cents?: number | null | undefined;
     }[] | undefined;
+    customer_name?: string | null | undefined;
+    customer_phone?: string | null | undefined;
+    customer_email?: string | null | undefined;
 }>;
 type SaleItemInput = z.input<typeof saleItemSchema>;
 type SaleInput = z.input<typeof saleCreateSchema>;
@@ -1585,6 +1603,9 @@ interface Sale {
     occurred_at: string;
     environment: (typeof TRACKING_ENVIRONMENTS)[number];
     metadata: Record<string, unknown> | null;
+    customer_name: string | null;
+    customer_phone: string | null;
+    customer_email: string | null;
     created_at: string;
     updated_at: string;
     items: SaleItem[];
@@ -1597,13 +1618,38 @@ interface SaleCursorPage {
     items: Sale[];
     next_cursor: string | null;
 }
-interface SaleListQuery {
+/**
+ * Comprehensive filter shape mirrored from the backend's `SaleQueryFilters`.
+ *
+ * `search` runs case-insensitively across `customer_name`, `customer_phone`,
+ * `customer_email`, `description`, and `external_id` — the human-facing
+ * columns. `service_id` is the resolved per-business service UUID (different
+ * from the create-time `service` *key*).
+ */
+interface SaleFilters {
     business_id?: string;
     external_id?: string;
+    service_id?: string;
     currency?: SupportedCurrency;
     environment?: (typeof TRACKING_ENVIRONMENTS)[number];
     since?: string;
     until?: string;
+    min_amount_cents?: number;
+    max_amount_cents?: number;
+    search?: string;
+}
+/**
+ * Full query input for `SalesClient.list()` — filters + pagination.
+ *
+ * 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.
+ */
+interface SaleListQuery extends SaleFilters {
     limit?: number;
     cursor?: string | null;
 }

package/dist/index.d.ts

@@ -1464,6 +1464,9 @@ declare const saleCreateSchema: z.ZodObject<{
         unit_cost_cents?: number | null | undefined;
     }>, "many">>;
     metadata: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    customer_name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    customer_phone: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    customer_email: z.ZodOptional<z.ZodNullable<z.ZodString>>;
 }, "strict", z.ZodTypeAny, {
     currency: "USD" | "CAD";
     amount_total_cents: number;
@@ -1481,6 +1484,9 @@ declare const saleCreateSchema: z.ZodObject<{
     external_id?: string | null | undefined;
     description?: string | null | undefined;
     service?: string | null | undefined;
+    customer_name?: string | null | undefined;
+    customer_phone?: string | null | undefined;
+    customer_email?: string | null | undefined;
 }, {
     currency: "USD" | "CAD";
     amount_total_cents: number;
@@ -1498,6 +1504,9 @@ declare const saleCreateSchema: z.ZodObject<{
         category?: string | null | undefined;
         unit_cost_cents?: number | null | undefined;
     }[] | undefined;
+    customer_name?: string | null | undefined;
+    customer_phone?: string | null | undefined;
+    customer_email?: string | null | undefined;
 }>;
 declare const saleUpdateSchema: z.ZodObject<{
     description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -1528,6 +1537,9 @@ declare const saleUpdateSchema: z.ZodObject<{
         unit_cost_cents?: number | null | undefined;
     }>, "many">>;
     metadata: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    customer_name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    customer_phone: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    customer_email: z.ZodOptional<z.ZodNullable<z.ZodString>>;
 }, "strict", z.ZodTypeAny, {
     metadata?: Record<string, unknown> | null | undefined;
     description?: string | null | undefined;
@@ -1543,6 +1555,9 @@ declare const saleUpdateSchema: z.ZodObject<{
         category?: string | null | undefined;
         unit_cost_cents?: number | null | undefined;
     }[] | undefined;
+    customer_name?: string | null | undefined;
+    customer_phone?: string | null | undefined;
+    customer_email?: string | null | undefined;
 }, {
     metadata?: Record<string, unknown> | null | undefined;
     description?: string | null | undefined;
@@ -1558,6 +1573,9 @@ declare const saleUpdateSchema: z.ZodObject<{
         category?: string | null | undefined;
         unit_cost_cents?: number | null | undefined;
     }[] | undefined;
+    customer_name?: string | null | undefined;
+    customer_phone?: string | null | undefined;
+    customer_email?: string | null | undefined;
 }>;
 type SaleItemInput = z.input<typeof saleItemSchema>;
 type SaleInput = z.input<typeof saleCreateSchema>;
@@ -1585,6 +1603,9 @@ interface Sale {
     occurred_at: string;
     environment: (typeof TRACKING_ENVIRONMENTS)[number];
     metadata: Record<string, unknown> | null;
+    customer_name: string | null;
+    customer_phone: string | null;
+    customer_email: string | null;
     created_at: string;
     updated_at: string;
     items: SaleItem[];
@@ -1597,13 +1618,38 @@ interface SaleCursorPage {
     items: Sale[];
     next_cursor: string | null;
 }
-interface SaleListQuery {
+/**
+ * Comprehensive filter shape mirrored from the backend's `SaleQueryFilters`.
+ *
+ * `search` runs case-insensitively across `customer_name`, `customer_phone`,
+ * `customer_email`, `description`, and `external_id` — the human-facing
+ * columns. `service_id` is the resolved per-business service UUID (different
+ * from the create-time `service` *key*).
+ */
+interface SaleFilters {
     business_id?: string;
     external_id?: string;
+    service_id?: string;
     currency?: SupportedCurrency;
     environment?: (typeof TRACKING_ENVIRONMENTS)[number];
     since?: string;
     until?: string;
+    min_amount_cents?: number;
+    max_amount_cents?: number;
+    search?: string;
+}
+/**
+ * Full query input for `SalesClient.list()` — filters + pagination.
+ *
+ * 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.
+ */
+interface SaleListQuery extends SaleFilters {
     limit?: number;
     cursor?: string | null;
 }

package/dist/index.js

@@ -1510,7 +1510,7 @@ function useConsentState() {
 var import_react4 = require("react");
 
 // package.json
-var version = "0.8.0";
+var version = "0.9.0";
 
 // src/factory.tsx
 var import_jsx_runtime2 = require("react/jsx-runtime");