@aranova/tracking-next 0.27.0 → 1.0.0

package/dist/sales.mjs

@@ -37,7 +37,7 @@ function normalizeEmail(raw) {
   return EMAIL_SHAPE.test(cleaned) ? cleaned : null;
 }
 function stashUserData(data, country) {
-  const email = normalizeEmail(data.email);
+  const email3 = normalizeEmail(data.email);
   let phoneNumber = null;
   if (typeof data.phone === "string" && data.phone.length > 0) {
     try {
@@ -47,17 +47,17 @@ function stashUserData(data, country) {
     }
   }
   stash = {
-    email: email ?? stash.email,
+    email: email3 ?? stash.email,
     phoneNumber: phoneNumber ?? stash.phoneNumber
   };
 }
 function applyUserDataForConversion(explicit, country) {
   if (typeof window === "undefined" || typeof window.gtag !== "function") return false;
-  let email = stash.email;
+  let email3 = stash.email;
   let phoneNumber = stash.phoneNumber;
   if (explicit) {
     const normalizedEmail = normalizeEmail(explicit.email);
-    if (normalizedEmail) email = normalizedEmail;
+    if (normalizedEmail) email3 = normalizedEmail;
     if (typeof explicit.phone === "string" && explicit.phone.length > 0) {
       try {
         phoneNumber = toE164(explicit.phone, country) ?? phoneNumber;
@@ -65,10 +65,10 @@ function applyUserDataForConversion(explicit, country) {
       }
     }
   }
-  if (email === null && phoneNumber === null) return false;
+  if (email3 === null && phoneNumber === null) return false;
   try {
     window.gtag("set", "user_data", {
-      ...email !== null ? { email } : {},
+      ...email3 !== null ? { email: email3 } : {},
       ...phoneNumber !== null ? { phone_number: phoneNumber } : {}
     });
     return true;
@@ -170,29 +170,6 @@ function fireConversionWithConsent(input, options) {
   }
 }
 
-// ../tracking-core/src/events/page-view.ts
-import { z } from "zod";
-var pageViewMetadataSchema = z.object({
-  page: z.object({
-    title: z.string().nullable(),
-    path: z.string(),
-    search: z.string(),
-    hash: z.string()
-  }).strict(),
-  referrer: z.string().nullable(),
-  // `.nullable().optional()` — absent (undefined) OR explicit null OR a
-  // real viewport object. Mirrors Pydantic's `_Viewport | None = None`
-  // on the backend side so the drift test stays clean.
-  viewport: z.object({
-    w: z.number(),
-    h: z.number()
-  }).strict().nullable().optional()
-}).strict();
-var pageViewConfigSchema = z.object({}).strict();
-
-// ../tracking-core/src/session.ts
-var SESSION_IDLE_MS = 30 * 60 * 1e3;
-
 // ../tracking-core/src/ingest.ts
 var API_KEY_HEADER = "X-Aranova-Api-Key";
 var SDK_VERSION_HEADER = "X-Aranova-Sdk-Version";
@@ -237,9 +214,9 @@ async function apiRequest(config, method, path, body, extraHeaders) {
     try {
       const parsed = await response.json();
       if (parsed && typeof parsed === "object") {
-        const record = parsed;
-        if (typeof record.detail === "string") detail = record.detail;
-        if (typeof record.code === "string") code = record.code;
+        const record3 = parsed;
+        if (typeof record3.detail === "string") detail = record3.detail;
+        if (typeof record3.code === "string") code = record3.code;
       }
     } catch {
     }
@@ -257,9 +234,9 @@ async function apiRequest(config, method, path, body, extraHeaders) {
 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;
+function formatDateInTz(iso3, timeZone, opts, locale) {
+  const date = new Date(iso3);
+  if (Number.isNaN(date.getTime())) return iso3;
   return new Intl.DateTimeFormat(locale, {
     year: "numeric",
     month: "short",
@@ -323,7 +300,7 @@ function fireRecordedConversions(firing, input, recorded, sale, currency) {
 }
 function createSalesClient(config) {
   if (config.firing) registerCapability("conversion_goals_manual");
-  async function record(input) {
+  async function record3(input) {
     const currency = input.currency ?? config.defaultCurrency;
     if (!currency) {
       throw new Error(
@@ -349,9 +326,9 @@ function createSalesClient(config) {
     return sale;
   }
   return {
-    record,
+    record: record3,
     // recordSale is the intent-revealing alias — same behavior, clearer call site.
-    recordSale: record,
+    recordSale: record3,
     trackConversion(key, options) {
       if (config.firing && "fireConversion" in config.firing) {
         if (options?.userData && getConsentState() !== "denied") stashUserData(options.userData);
@@ -470,115 +447,264 @@ function createSalesClient(config) {
 }
 
 // ../tracking-core/src/resources/sales/schema.ts
-import { z as z2 } from "zod";
-var SUPPORTED_CURRENCIES = ["USD", "CAD"];
-var TRACKING_ENVIRONMENTS = ["production", "development"];
-var currencySchema = z2.enum(SUPPORTED_CURRENCIES);
-var centsSchema = z2.number().int().nonnegative();
-var quantitySchema = z2.string().regex(/^\d+(\.\d{1,3})?$/);
-var metadataSchema = z2.record(z2.unknown());
-var saleItemSchema = z2.object({
-  external_item_id: z2.string().nullable().optional(),
-  name: z2.string().nullable().optional(),
-  category: z2.string().nullable().optional(),
-  quantity: quantitySchema,
-  unit_price_cents: centsSchema,
-  // Non-negativity validated on the wire — same contract as the other cents
-  // fields — and backstopped by the DB CHECK.
-  unit_cost_cents: centsSchema.nullable().optional()
-}).strict();
-var saleServiceSchema = z2.object({
-  service: z2.string(),
-  amount_cents: centsSchema
-}).strict();
-var customerNameSchema = z2.string().max(200);
-var customerPhoneSchema = z2.string().max(64);
-var customerEmailSchema = z2.string().max(320).email();
+import * as z2 from "zod/mini";
+
+// ../tracking-core/src/resources/sales/generated/zod.gen.ts
+import * as z from "zod/mini";
+var zErrorCode = z.enum([
+  "missing_credentials",
+  "invalid_api_key",
+  "not_authenticated",
+  "wrong_key_type",
+  "origin_missing",
+  "origin_not_allowed",
+  "capability_denied",
+  "session_required",
+  "operator_only",
+  "cross_tenant",
+  "business_id_required",
+  "bad_request",
+  "not_found",
+  "conflict",
+  "incompatible_payload",
+  "repeat_confirmation_required",
+  "idempotency_conflict",
+  "validation_error",
+  "unknown_service",
+  "invalid_sale_properties",
+  "invalid_cursor",
+  "rate_limited",
+  "internal_error"
+]);
+var zSaleItemEntitySchema = z.object({
+  category: z.nullable(z.string()),
+  external_item_id: z.nullable(z.string()),
+  id: z.uuid(),
+  name: z.nullable(z.string()),
+  quantity: z.string().check(z.regex(/^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$/)),
+  unit_cost_cents: z.nullable(z.int()),
+  unit_price_cents: z.int()
+});
+var zSaleItemInputSchema = z.strictObject({
+  category: z.nullish(z.string()),
+  external_item_id: z.nullish(z.string()),
+  name: z.nullish(z.string()),
+  quantity: z.string().check(z.regex(/^\d+(\.\d{1,3})?$/)),
+  unit_cost_cents: z.nullish(z.int().check(z.gte(0))),
+  unit_price_cents: z.int().check(z.gte(0))
+});
+var zSaleServiceEntitySchema = z.object({
+  amount_cents: z.int(),
+  id: z.uuid(),
+  mapped: z.nullable(z.boolean()),
+  service_id: z.uuid(),
+  service_key: z.string(),
+  service_label: z.string()
+});
+var zSaleServiceInputSchema = z.strictObject({
+  amount_cents: z.int().check(z.gte(0)),
+  service: z.string()
+});
+var zSmsAutomationState = z.enum([
+  "needs_check",
+  "failed",
+  "undelivered",
+  "blocked_opted_out",
+  "withheld",
+  "queued",
+  "sent",
+  "delivered",
+  "eligible",
+  "not_applicable"
+]);
+var zSmsWithheldReason = z.enum([
+  "automation_disabled",
+  "sms_disabled",
+  "no_phone",
+  "no_consent",
+  "no_customer_identity",
+  "missing_customer_name",
+  "placeholder_customer_name",
+  "opted_out",
+  "already_messaged",
+  "sender_not_ready",
+  "missing_review_url",
+  "no_handler",
+  "dispatch_already_recorded"
+]);
+var zSaleSmsStatusSchema = z.object({
+  can_send_now: z._default(z.boolean(), false),
+  last_message_at: z.nullable(z.iso.datetime({ offset: true })),
+  reason_detail: z.nullable(z.string()),
+  state: zSmsAutomationState,
+  suppressed_by_other_sale: z._default(z.boolean(), false),
+  withheld_reason: z.nullable(zSmsWithheldReason)
+});
+var zSupportedCurrency = z.enum(["USD", "CAD"]);
+var zTrackingEnvironment = z.enum(["production", "development"]);
+var zSaleCreateSchema = z.strictObject({
+  amount_total_cents: z.nullish(z.int().check(z.gte(0))),
+  currency: zSupportedCurrency,
+  customer_email: z.nullish(z.email().check(z.maxLength(320))),
+  customer_name: z.nullish(z.string().check(z.maxLength(200))),
+  customer_phone: z.nullish(z.string().check(z.maxLength(64))),
+  description: z.nullish(z.string()),
+  environment: z._default(z.optional(zTrackingEnvironment), "production"),
+  external_id: z.nullish(z.string()),
+  items: z.optional(z.array(zSaleItemInputSchema)),
+  metadata: z.nullish(z.record(z.string(), z.unknown())),
+  occurred_at: z.iso.datetime({ offset: true }),
+  service: z.nullish(z.string()),
+  services: z.nullish(z.array(zSaleServiceInputSchema)),
+  sms_consent: z.nullish(z.boolean())
+});
+var zValidationError = z.object({
+  ctx: z.optional(z.record(z.string(), z.unknown())),
+  input: z.optional(z.unknown()),
+  loc: z.array(z.union([z.string(), z.int()])),
+  msg: z.string(),
+  type: z.string()
+});
+var zHttpValidationError = z.object({
+  detail: z.optional(z.array(zValidationError))
+});
+var zValidationErrorItem = z.object({
+  loc: z.array(z.union([z.string(), z.int()])),
+  msg: z.string(),
+  type: z.string()
+});
+var zApiErrorSchema = z.object({
+  code: zErrorCode,
+  context: z._default(z.nullish(z.record(z.string(), z.unknown())), null),
+  detail: z.string(),
+  errors: z._default(z.nullish(z.array(zValidationErrorItem)), null),
+  request_id: z._default(z.nullish(z.string()), null)
+});
+var zWritebackEmailSource = z.enum(["NONE", "SALE", "CUSTOMER", "HARVESTED"]);
+var zWritebackEnrichmentStatus = z.enum(["NONE", "MATCHED", "AMBIGUOUS"]);
+var zWritebackSaleUploadCounts = z.object({
+  failed: z._default(z.int(), 0),
+  pending: z._default(z.int(), 0),
+  skipped: z._default(z.int(), 0),
+  submitted: z._default(z.int(), 0),
+  total: z._default(z.int(), 0),
+  uploaded: z._default(z.int(), 0)
+});
+var zSaleWritebackStatusSchema = z.object({
+  blocked_reason: z.nullable(z.string()),
+  can_dispatch: z._default(z.boolean(), false),
+  email_source: z.nullable(zWritebackEmailSource),
+  enrichment_status: z.nullable(zWritebackEnrichmentStatus),
+  gclid_attached: z._default(z.boolean(), false),
+  identifiers_sent: z.nullable(z.string()),
+  mapped_service_ids: z.array(z.uuid()),
+  matched_submit_count: z.nullable(z.int()),
+  needs_force: z._default(z.boolean(), false),
+  rollup: z.enum([
+    "failed",
+    "skipped",
+    "pending",
+    "submitted",
+    "uploaded",
+    "not_uploaded",
+    "out_of_window",
+    "blocked"
+  ]),
+  stale: z._default(z.boolean(), false),
+  uncovered_service_ids: z.array(z.uuid()),
+  uploads: zWritebackSaleUploadCounts
+});
+var zSaleEntitySchema = z.object({
+  amount_total_cents: z.int(),
+  business_id: z.uuid(),
+  business_name: z.nullable(z.string()),
+  created_at: z.iso.datetime({ offset: true }),
+  currency: z.string(),
+  customer_email: z.nullable(z.string()),
+  customer_name: z.nullable(z.string()),
+  customer_name_placeholder_confirmed: z._default(z.boolean(), false),
+  customer_name_placeholder_confirmed_at: z.nullable(z.iso.datetime({ offset: true })),
+  customer_phone: z.nullable(z.string()),
+  description: z.nullable(z.string()),
+  environment: zTrackingEnvironment,
+  external_id: z.nullable(z.string()),
+  id: z.uuid(),
+  items: z.array(zSaleItemEntitySchema),
+  metadata: z.nullable(z.record(z.string(), z.unknown())),
+  occurred_at: z.iso.datetime({ offset: true }),
+  service_id: z.nullable(z.uuid()),
+  service_key: z.nullable(z.string()),
+  service_label: z.nullable(z.string()),
+  services: z.array(zSaleServiceEntitySchema),
+  sms_automation: z.nullable(zSaleSmsStatusSchema),
+  sms_consent: z._default(z.boolean(), false),
+  sms_consent_granted_at: z.nullable(z.iso.datetime({ offset: true })),
+  updated_at: z.iso.datetime({ offset: true }),
+  writeback: z.nullable(zSaleWritebackStatusSchema)
+});
+
+// ../tracking-core/src/resources/sales/schema.ts
+var saleItemSchema = zSaleItemInputSchema;
+var saleServiceSchema = zSaleServiceInputSchema;
+var currencySchema = zSupportedCurrency;
+var SUPPORTED_CURRENCIES = currencySchema.options;
+var centsSchema = z2.int().check(z2.gte(0));
+var metadataSchema = z2.record(z2.string(), z2.unknown());
+var customerNameSchema = z2.string().check(z2.maxLength(200));
+var customerPhoneSchema = z2.string().check(z2.maxLength(64));
+var customerEmailSchema = z2.email().check(z2.maxLength(320));
+function addIssue(ctx, path, message) {
+  ctx.issues.push({ code: "custom", input: ctx.value, path, message });
+}
 function refineServiceXor(val, ctx, { requireAmount }) {
   if (val.services != null) {
     if (val.service != null) {
-      ctx.addIssue({
-        code: z2.ZodIssueCode.custom,
-        message: "pass either `service` or `services`, not both",
-        path: ["services"]
-      });
+      addIssue(ctx, ["services"], "pass either `service` or `services`, not both");
     }
     if (val.services.length === 0) {
-      ctx.addIssue({
-        code: z2.ZodIssueCode.custom,
-        message: "`services` must not be empty",
-        path: ["services"]
-      });
+      addIssue(ctx, ["services"], "`services` must not be empty");
     }
     const keys = val.services.map((s) => s.service);
     if (new Set(keys).size !== keys.length) {
-      ctx.addIssue({
-        code: z2.ZodIssueCode.custom,
-        message: "`services` must not list the same service more than once",
-        path: ["services"]
-      });
+      addIssue(ctx, ["services"], "`services` must not list the same service more than once");
     }
     if (val.amount_total_cents != null) {
       const sum = val.services.reduce((acc, s) => acc + s.amount_cents, 0);
       if (val.amount_total_cents !== sum) {
-        ctx.addIssue({
-          code: z2.ZodIssueCode.custom,
-          message: "amount_total_cents must equal the sum of the services amounts (omit it to derive it automatically)",
-          path: ["amount_total_cents"]
-        });
+        addIssue(
+          ctx,
+          ["amount_total_cents"],
+          "amount_total_cents must equal the sum of the services amounts (omit it to derive it automatically)"
+        );
       }
     }
   } else if (requireAmount && val.amount_total_cents == null) {
-    ctx.addIssue({
-      code: z2.ZodIssueCode.custom,
-      message: "amount_total_cents is required unless `services` is provided",
-      path: ["amount_total_cents"]
-    });
+    addIssue(
+      ctx,
+      ["amount_total_cents"],
+      "amount_total_cents is required unless `services` is provided"
+    );
   }
 }
-var saleCreateSchema = z2.object({
-  external_id: z2.string().nullable().optional(),
-  description: z2.string().nullable().optional(),
-  service: z2.string().nullable().optional(),
-  services: z2.array(saleServiceSchema).nullable().optional(),
-  currency: currencySchema,
-  // Optional only because the plural `services` form derives it from the sum
-  // (see refineServiceXor); the singular/serviceless path still requires it.
-  amount_total_cents: centsSchema.nullable().optional(),
-  occurred_at: z2.string().datetime(),
-  environment: z2.enum(TRACKING_ENVIRONMENTS).default("production"),
-  items: z2.array(saleItemSchema).default([]),
-  metadata: metadataSchema.nullable().optional(),
-  customer_name: customerNameSchema.nullable().optional(),
-  customer_phone: customerPhoneSchema.nullable().optional(),
-  customer_email: customerEmailSchema.nullable().optional(),
-  // CASL consent attestation: the customer agreed to receive SMS. Recorded
-  // with a timestamp server-side; every SMS send path gates on it.
-  //
-  // Tri-state: omit it (or send null) to let the server apply the business's
-  // configured default-opt-in policy, honouring a returning customer's
-  // remembered preference. Send an explicit boolean to assert consent state
-  // yourself — `false` records a deliberate opt-out.
-  sms_consent: z2.boolean().nullable().optional()
-}).strict().superRefine((val, ctx) => refineServiceXor(val, ctx, { requireAmount: true }));
-var saleUpdateSchema = z2.object({
-  description: z2.string().nullable().optional(),
-  service: z2.string().nullable().optional(),
-  services: z2.array(saleServiceSchema).nullable().optional(),
-  currency: currencySchema.optional(),
-  amount_total_cents: centsSchema.optional(),
-  occurred_at: z2.string().datetime().optional(),
-  items: z2.array(saleItemSchema).optional(),
-  metadata: metadataSchema.nullable().optional(),
-  customer_name: customerNameSchema.nullable().optional(),
+var saleCreateSchema = z2.extend(zSaleCreateSchema, { items: z2._default(z2.array(saleItemSchema), []) }).check((ctx) => refineServiceXor(ctx.value, ctx, { requireAmount: true }));
+var saleUpdateSchema = z2.strictObject({
+  description: z2.nullish(z2.string()),
+  service: z2.nullish(z2.string()),
+  services: z2.nullish(z2.array(saleServiceSchema)),
+  currency: z2.optional(currencySchema),
+  amount_total_cents: z2.optional(centsSchema),
+  occurred_at: z2.optional(z2.iso.datetime()),
+  items: z2.optional(z2.array(saleItemSchema)),
+  metadata: z2.nullish(metadataSchema),
+  customer_name: z2.nullish(customerNameSchema),
   // Re-attest when changing a filler-looking name; the server clears the
   // prior attestation whenever `customer_name` changes.
-  customer_name_placeholder_confirmed: z2.boolean().optional(),
-  customer_phone: customerPhoneSchema.nullable().optional(),
-  customer_email: customerEmailSchema.nullable().optional(),
+  customer_name_placeholder_confirmed: z2.optional(z2.boolean()),
+  customer_phone: z2.nullish(customerPhoneSchema),
+  customer_email: z2.nullish(customerEmailSchema),
   // NOT NULL server-side: omit to leave unchanged (explicit null is rejected).
-  sms_consent: z2.boolean().optional()
-}).strict().superRefine((val, ctx) => refineServiceXor(val, ctx, { requireAmount: false }));
+  sms_consent: z2.optional(z2.boolean())
+}).check((ctx) => refineServiceXor(ctx.value, ctx, { requireAmount: false }));
 var TRACKING_RANGES = ["24h", "7d", "30d"];
 var NAMED_RANGES = [
   "today",
@@ -604,6 +730,7 @@ export {
   SUPPORTED_CURRENCIES,
   TRACKING_RANGES,
   createSalesClient,
+  currencySchema,
   fetchServices,
   formatDateInTz,
   formatMoney,