@aranova/tracking-react 1.0.0 → 1.1.0

package/dist/index.mjs

@@ -226,6 +226,7 @@ var TRACKING_CAPABILITIES = [
   "consent_controls",
   "conversion_goals_auto",
   "conversion_goals_manual",
+  "cross_site_linker",
   "cta_click_capture",
   "form_capture",
   "phone_click_capture",
@@ -252,6 +253,9 @@ function readDomMarkers() {
   return found;
 }
 
+// ../tracking-core/src/cross-site-link.ts
+import * as z from "zod/mini";
+
 // ../tracking-core/src/tracking.ts
 var TRACKING_COOKIE_MAX_AGE_SECONDS = 7776e3;
 var TRACKING_PARAM_KEYS = [
@@ -496,6 +500,43 @@ function buildLandingPayloadFields(sessionId, override) {
   };
 }
 
+// ../tracking-core/src/cross-site-link.ts
+var LINK_PARAM = "_arv";
+var LINK_TOKEN_TTL_MS = 5 * 60 * 1e3;
+var FUTURE_SKEW_MS = 60 * 1e3;
+var CARRIED_KEYS = {
+  g: "gclid",
+  w: "wbraid",
+  gb: "gbraid",
+  f: "fbclid",
+  y: "ylpcid"
+};
+var CARRIED_ENTRIES = Object.entries(CARRIED_KEYS);
+var identifier = z.string().check(z.minLength(1), z.maxLength(128));
+var optionalIdentifier = z.optional(identifier);
+var linkTokenSchema = z.object({
+  v: identifier,
+  s: identifier,
+  // Epoch ms in base36.
+  t: z.string().check(z.regex(/^[0-9a-z]{1,12}$/)),
+  g: optionalIdentifier,
+  w: optionalIdentifier,
+  gb: optionalIdentifier,
+  f: optionalIdentifier,
+  fc: optionalIdentifier,
+  y: optionalIdentifier
+});
+function stripLinkParam(url) {
+  try {
+    const parsed = new URL(url, typeof window === "undefined" ? void 0 : window.location.href);
+    if (!parsed.searchParams.has(LINK_PARAM)) return url;
+    parsed.searchParams.delete(LINK_PARAM);
+    return parsed.href;
+  } catch {
+    return url;
+  }
+}
+
 // ../tracking-core/src/payloads.ts
 function createTrackingClientContext(surface, input = {}) {
   return {
@@ -535,6 +576,7 @@ function createTrackingSessionUpsertPayload(trackingParams, input, context) {
   };
 }
 function createTrackingEventCreatePayload(trackingParams, input, context) {
+  const pageUrl = input.pageUrl ?? (typeof window === "undefined" ? null : window.location.href);
   return {
     session_id: input.sessionId,
     event_type: input.eventType,
@@ -545,7 +587,7 @@ function createTrackingEventCreatePayload(trackingParams, input, context) {
     fbclid: trackingParams.fbclid,
     fbc: getFbcCookie(),
     fbp: getFbpCookie(),
-    page_url: input.pageUrl ?? (typeof window === "undefined" ? null : window.location.href),
+    page_url: pageUrl === null ? null : stripLinkParam(pageUrl),
     metadata: input.metadata ?? null,
     context
   };
@@ -657,7 +699,8 @@ function parseConversionConfig(raw) {
     gtag_ids: isStringMap(obj.gtag_ids) ? obj.gtag_ids : {},
     meta_pixel_ids: isStringMap(obj.meta_pixel_ids) ? obj.meta_pixel_ids : {},
     services,
-    goals
+    goals,
+    linked_hostnames: Array.isArray(obj.linked_hostnames) ? obj.linked_hostnames.filter((h) => typeof h === "string" && h.length > 0) : []
   };
 }
 var CACHE_PREFIX = "_aranova_cfg_";
@@ -741,6 +784,7 @@ function resolveConversionConfig(options) {
     getFiring: (key) => goalsByKey.get(key)?.firing ?? null,
     getGoal: (key) => goalsByKey.get(key) ?? null,
     listGoals: () => [...goalsByKey.values()],
+    linkedHostnames: () => current?.linked_hostnames ?? [],
     current: () => current,
     isReady: () => current !== null,
     onResolve: (listener) => {
@@ -948,7 +992,7 @@ function validateConfig(config, ref) {
 function pageViewSnapshot() {
   if (typeof window === "undefined" || typeof document === "undefined") return null;
   return {
-    href: window.location.href,
+    href: stripLinkParam(window.location.href),
     title: document.title || null,
     referrer: document.referrer || null
   };
@@ -1099,6 +1143,10 @@ var TrackingConfigRuntime = class {
   listGoals() {
     return this.current?.goals ?? [];
   }
+  /** Sibling hostnames for the linker — read from the cached object even while unconfirmed. */
+  linkedHostnames() {
+    return this.current?.linked_hostnames ?? [];
+  }
   async revalidateNow() {
     try {
       const headers = {};
@@ -1342,6 +1390,18 @@ var EVENT_SEMANTICS = {
     category: "engagement",
     outcomeRole: "engagement",
     clientVisibility: "simple"
+  },
+  site_link_click: {
+    label: "Left for sibling site",
+    category: "page",
+    outcomeRole: "navigation",
+    clientVisibility: "detailed"
+  },
+  site_link_arrival: {
+    label: "Arrived from sibling site",
+    category: "page",
+    outcomeRole: "navigation",
+    clientVisibility: "simple"
   }
 };
 function getEventSemantics(eventName) {
@@ -1583,11 +1643,11 @@ function createSalesClient(config) {
 }
 
 // ../tracking-core/src/resources/sales/schema.ts
-import * as z2 from "zod/mini";
+import * as z3 from "zod/mini";
 
 // ../tracking-core/src/resources/sales/generated/zod.gen.ts
-import * as z from "zod/mini";
-var zErrorCode = z.enum([
+import * as z2 from "zod/mini";
+var zErrorCode = z2.enum([
   "missing_credentials",
   "invalid_api_key",
   "not_authenticated",
@@ -1612,36 +1672,36 @@ var zErrorCode = z.enum([
   "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 zSaleItemEntitySchema = z2.object({
+  category: z2.nullable(z2.string()),
+  external_item_id: z2.nullable(z2.string()),
+  id: z2.uuid(),
+  name: z2.nullable(z2.string()),
+  quantity: z2.string().check(z2.regex(/^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$/)),
+  unit_cost_cents: z2.nullable(z2.int()),
+  unit_price_cents: z2.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 zSaleItemInputSchema = z2.strictObject({
+  category: z2.nullish(z2.string()),
+  external_item_id: z2.nullish(z2.string()),
+  name: z2.nullish(z2.string()),
+  quantity: z2.string().check(z2.regex(/^\d+(\.\d{1,3})?$/)),
+  unit_cost_cents: z2.nullish(z2.int().check(z2.gte(0))),
+  unit_price_cents: z2.int().check(z2.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 zSaleServiceEntitySchema = z2.object({
+  amount_cents: z2.int(),
+  id: z2.uuid(),
+  mapped: z2.nullable(z2.boolean()),
+  service_id: z2.uuid(),
+  service_key: z2.string(),
+  service_label: z2.string()
 });
-var zSaleServiceInputSchema = z.strictObject({
-  amount_cents: z.int().check(z.gte(0)),
-  service: z.string()
+var zSaleServiceInputSchema = z2.strictObject({
+  amount_cents: z2.int().check(z2.gte(0)),
+  service: z2.string()
 });
-var zSmsAutomationState = z.enum([
+var zSmsAutomationState = z2.enum([
   "needs_check",
   "failed",
   "undelivered",
@@ -1653,7 +1713,7 @@ var zSmsAutomationState = z.enum([
   "eligible",
   "not_applicable"
 ]);
-var zSmsWithheldReason = z.enum([
+var zSmsWithheldReason = z2.enum([
   "automation_disabled",
   "sms_disabled",
   "no_phone",
@@ -1666,77 +1726,82 @@ var zSmsWithheldReason = z.enum([
   "sender_not_ready",
   "missing_review_url",
   "no_handler",
-  "dispatch_already_recorded"
+  "dispatch_already_recorded",
+  "text_back_disabled",
+  "number_not_active",
+  "a2p_registration_required",
+  "alert_recipient_cannot_receive_sms",
+  "line_type_unresolved"
 ]);
-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()),
+var zSaleSmsStatusSchema = z2.object({
+  can_send_now: z2._default(z2.boolean(), false),
+  last_message_at: z2.nullable(z2.iso.datetime({ offset: true })),
+  reason_detail: z2.nullable(z2.string()),
   state: zSmsAutomationState,
-  suppressed_by_other_sale: z._default(z.boolean(), false),
-  withheld_reason: z.nullable(zSmsWithheldReason)
+  suppressed_by_other_sale: z2._default(z2.boolean(), false),
+  withheld_reason: z2.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))),
+var zSupportedCurrency = z2.enum(["USD", "CAD"]);
+var zTrackingEnvironment = z2.enum(["production", "development"]);
+var zSaleCreateSchema = z2.strictObject({
+  amount_total_cents: z2.nullish(z2.int().check(z2.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())
+  customer_email: z2.nullish(z2.email().check(z2.maxLength(320))),
+  customer_name: z2.nullish(z2.string().check(z2.maxLength(200))),
+  customer_phone: z2.nullish(z2.string().check(z2.maxLength(64))),
+  description: z2.nullish(z2.string()),
+  environment: z2._default(z2.optional(zTrackingEnvironment), "production"),
+  external_id: z2.nullish(z2.string()),
+  items: z2.optional(z2.array(zSaleItemInputSchema)),
+  metadata: z2.nullish(z2.record(z2.string(), z2.unknown())),
+  occurred_at: z2.iso.datetime({ offset: true }),
+  service: z2.nullish(z2.string()),
+  services: z2.nullish(z2.array(zSaleServiceInputSchema)),
+  sms_consent: z2.nullish(z2.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 zValidationError = z2.object({
+  ctx: z2.optional(z2.record(z2.string(), z2.unknown())),
+  input: z2.optional(z2.unknown()),
+  loc: z2.array(z2.union([z2.string(), z2.int()])),
+  msg: z2.string(),
+  type: z2.string()
 });
-var zHttpValidationError = z.object({
-  detail: z.optional(z.array(zValidationError))
+var zHttpValidationError = z2.object({
+  detail: z2.optional(z2.array(zValidationError))
 });
-var zValidationErrorItem = z.object({
-  loc: z.array(z.union([z.string(), z.int()])),
-  msg: z.string(),
-  type: z.string()
+var zValidationErrorItem = z2.object({
+  loc: z2.array(z2.union([z2.string(), z2.int()])),
+  msg: z2.string(),
+  type: z2.string()
 });
-var zApiErrorSchema = z.object({
+var zApiErrorSchema = z2.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)
+  context: z2._default(z2.nullish(z2.record(z2.string(), z2.unknown())), null),
+  detail: z2.string(),
+  errors: z2._default(z2.nullish(z2.array(zValidationErrorItem)), null),
+  request_id: z2._default(z2.nullish(z2.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 zWritebackEmailSource = z2.enum(["NONE", "SALE", "CUSTOMER", "HARVESTED"]);
+var zWritebackEnrichmentStatus = z2.enum(["NONE", "MATCHED", "AMBIGUOUS"]);
+var zWritebackSaleUploadCounts = z2.object({
+  failed: z2._default(z2.int(), 0),
+  pending: z2._default(z2.int(), 0),
+  skipped: z2._default(z2.int(), 0),
+  submitted: z2._default(z2.int(), 0),
+  total: z2._default(z2.int(), 0),
+  uploaded: z2._default(z2.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([
+var zSaleWritebackStatusSchema = z2.object({
+  blocked_reason: z2.nullable(z2.string()),
+  can_dispatch: z2._default(z2.boolean(), false),
+  email_source: z2.nullable(zWritebackEmailSource),
+  enrichment_status: z2.nullable(zWritebackEnrichmentStatus),
+  gclid_attached: z2._default(z2.boolean(), false),
+  identifiers_sent: z2.nullable(z2.string()),
+  mapped_service_ids: z2.array(z2.uuid()),
+  matched_submit_count: z2.nullable(z2.int()),
+  needs_force: z2._default(z2.boolean(), false),
+  rollup: z2.enum([
     "failed",
     "skipped",
     "pending",
@@ -1746,37 +1811,37 @@ var zSaleWritebackStatusSchema = z.object({
     "out_of_window",
     "blocked"
   ]),
-  stale: z._default(z.boolean(), false),
-  uncovered_service_ids: z.array(z.uuid()),
+  stale: z2._default(z2.boolean(), false),
+  uncovered_service_ids: z2.array(z2.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()),
+var zSaleEntitySchema = z2.object({
+  amount_total_cents: z2.int(),
+  business_id: z2.uuid(),
+  business_name: z2.nullable(z2.string()),
+  created_at: z2.iso.datetime({ offset: true }),
+  currency: z2.string(),
+  customer_email: z2.nullable(z2.string()),
+  customer_name: z2.nullable(z2.string()),
+  customer_name_placeholder_confirmed: z2._default(z2.boolean(), false),
+  customer_name_placeholder_confirmed_at: z2.nullable(z2.iso.datetime({ offset: true })),
+  customer_phone: z2.nullable(z2.string()),
+  description: z2.nullable(z2.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)
+  external_id: z2.nullable(z2.string()),
+  id: z2.uuid(),
+  items: z2.array(zSaleItemEntitySchema),
+  metadata: z2.nullable(z2.record(z2.string(), z2.unknown())),
+  occurred_at: z2.iso.datetime({ offset: true }),
+  service_id: z2.nullable(z2.uuid()),
+  service_key: z2.nullable(z2.string()),
+  service_label: z2.nullable(z2.string()),
+  services: z2.array(zSaleServiceEntitySchema),
+  sms_automation: z2.nullable(zSaleSmsStatusSchema),
+  sms_consent: z2._default(z2.boolean(), false),
+  sms_consent_granted_at: z2.nullable(z2.iso.datetime({ offset: true })),
+  updated_at: z2.iso.datetime({ offset: true }),
+  writeback: z2.nullable(zSaleWritebackStatusSchema)
 });
 
 // ../tracking-core/src/resources/sales/schema.ts
@@ -1784,11 +1849,11 @@ 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));
+var centsSchema = z3.int().check(z3.gte(0));
+var metadataSchema = z3.record(z3.string(), z3.unknown());
+var customerNameSchema = z3.string().check(z3.maxLength(200));
+var customerPhoneSchema = z3.string().check(z3.maxLength(64));
+var customerEmailSchema = z3.email().check(z3.maxLength(320));
 function addIssue(ctx, path, message) {
   ctx.issues.push({ code: "custom", input: ctx.value, path, message });
 }
@@ -1822,24 +1887,24 @@ function refineServiceXor(val, ctx, { requireAmount }) {
     );
   }
 }
-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),
+var saleCreateSchema = z3.extend(zSaleCreateSchema, { items: z3._default(z3.array(saleItemSchema), []) }).check((ctx) => refineServiceXor(ctx.value, ctx, { requireAmount: true }));
+var saleUpdateSchema = z3.strictObject({
+  description: z3.nullish(z3.string()),
+  service: z3.nullish(z3.string()),
+  services: z3.nullish(z3.array(saleServiceSchema)),
+  currency: z3.optional(currencySchema),
+  amount_total_cents: z3.optional(centsSchema),
+  occurred_at: z3.optional(z3.iso.datetime()),
+  items: z3.optional(z3.array(saleItemSchema)),
+  metadata: z3.nullish(metadataSchema),
+  customer_name: z3.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.optional(z2.boolean()),
-  customer_phone: z2.nullish(customerPhoneSchema),
-  customer_email: z2.nullish(customerEmailSchema),
+  customer_name_placeholder_confirmed: z3.optional(z3.boolean()),
+  customer_phone: z3.nullish(customerPhoneSchema),
+  customer_email: z3.nullish(customerEmailSchema),
   // NOT NULL server-side: omit to leave unchanged (explicit null is rejected).
-  sms_consent: z2.optional(z2.boolean())
+  sms_consent: z3.optional(z3.boolean())
 }).check((ctx) => refineServiceXor(ctx.value, ctx, { requireAmount: false }));
 var TRACKING_RANGES = ["24h", "7d", "30d"];
 var NAMED_RANGES = [