@aranova/tracking-react 1.17.0 → 1.19.0

package/dist/sales.js

@@ -283,7 +283,6 @@ var jsonValueSchema = z.lazy(
   ])
 ).register(z.globalRegistry, { id: "JsonSerializableValue" });
 var contractNameSchema = z.string().check(z.regex(/^[a-z][a-z0-9_]{0,47}(:[a-z0-9_-]{1,48})?$/));
-var contractName = contractNameSchema;
 var violationRole = z.string().check(
   z.maxLength(200),
   z.regex(
@@ -295,38 +294,41 @@ var contractViolationSchema = z.strictObject({
   role: z.nullable(violationRole),
   rule: z.string().check(z.regex(/^[a-z][a-z_]{0,47}$/))
 });
+var formFieldSchema = z.strictObject({
+  name: z.string(),
+  type: z.string(),
+  label: z.nullable(z.string()),
+  value: jsonValueSchema,
+  role: z.optional(z.nullable(contractNameSchema))
+});
+var formExtraSchema = z.optional(
+  z.nullable(
+    z.array(
+      z.strictObject({
+        key: z.string().check(z.maxLength(64)),
+        label: z.string().check(z.maxLength(200)),
+        value: jsonValueSchema
+      })
+    ).check(z.maxLength(20))
+  )
+);
+var contractVersionSchema = z.optional(z.nullable(z.int().check(z.gte(1))));
+var contractHashSchema = z.optional(z.nullable(z.string().check(z.maxLength(64))));
+var formContractViolationsSchema = z.optional(
+  z.nullable(z.array(contractViolationSchema).check(z.maxLength(MAX_CONTRACT_VIOLATIONS)))
+);
 var formSubmitMetadataSchema = z.strictObject({
   form: z.strictObject({
     id: z.string(),
     action: z.nullable(z.string()),
-    fields: z.optional(
-      z.array(
-        z.strictObject({
-          name: z.string(),
-          type: z.string(),
-          label: z.nullable(z.string()),
-          value: jsonValueSchema,
-          role: z.optional(z.nullable(contractName))
-        })
-      )
-    ),
-    kind: z.optional(z.nullable(contractName)),
-    contract_version: z.optional(z.nullable(z.int().check(z.gte(1)))),
-    contract_hash: z.optional(z.nullable(z.string().check(z.maxLength(64)))),
-    extra: z.optional(
-      z.nullable(
-        z.array(
-          z.strictObject({
-            key: z.string().check(z.maxLength(64)),
-            label: z.string().check(z.maxLength(200)),
-            value: jsonValueSchema
-          })
-        ).check(z.maxLength(20))
-      )
-    ),
-    contract_violations: z.optional(
-      z.nullable(z.array(contractViolationSchema).check(z.maxLength(MAX_CONTRACT_VIOLATIONS)))
-    )
+    fields: z.optional(z.array(formFieldSchema)),
+    kind: z.optional(z.nullable(contractNameSchema)),
+    contract_version: contractVersionSchema,
+    contract_hash: contractHashSchema,
+    extra: formExtraSchema,
+    contract_violations: formContractViolationsSchema,
+    // Minted per submit; a later `form_details` names it to add answers to this lead.
+    submission_id: z.optional(z.nullable(z.uuidv4()))
   }),
   page: z.strictObject({
     path: z.string()
@@ -698,8 +700,48 @@ function parseTrigger(value) {
   if (typeof t.threshold_seconds === "number") spec.threshold_seconds = t.threshold_seconds;
   if (typeof t.page_threshold === "number") spec.page_threshold = t.page_threshold;
   if (typeof t.page_name === "string") spec.page_name = t.page_name;
+  if (t.metric === "percent" || t.metric === "seconds") spec.metric = t.metric;
+  if (typeof t.threshold === "number") spec.threshold = t.threshold;
+  if (typeof t.video_id === "string" || t.video_id === null) spec.video_id = t.video_id;
   return spec;
 }
+function parseVideoEntry(fallbackKey, entry) {
+  const key = typeof entry.key === "string" && entry.key ? entry.key : fallbackKey;
+  if (!key) return null;
+  const host = typeof entry.host === "string" ? entry.host : "";
+  const title = typeof entry.title === "string" && entry.title ? entry.title : key;
+  const sourcesRaw = isRecord(entry.sources) ? entry.sources : null;
+  const desktop = sourcesRaw && typeof sourcesRaw.desktop === "string" ? sourcesRaw.desktop : typeof entry.desktop_uid === "string" ? entry.desktop_uid : "";
+  if (!host || !desktop) return null;
+  const mobile = sourcesRaw && typeof sourcesRaw.mobile === "string" ? sourcesRaw.mobile : typeof entry.mobile_uid === "string" ? entry.mobile_uid : null;
+  const posterTime = typeof entry.poster_time === "number" ? entry.poster_time : typeof entry.poster_time_s === "number" ? entry.poster_time_s : 4;
+  return {
+    key,
+    title,
+    host,
+    sources: { desktop, mobile },
+    poster_time: posterTime,
+    duration_s: typeof entry.duration_s === "number" ? entry.duration_s : null
+  };
+}
+function parseVideos(value) {
+  const out = {};
+  if (Array.isArray(value)) {
+    for (const item of value) {
+      if (!isRecord(item)) continue;
+      const parsed = parseVideoEntry("", item);
+      if (parsed) out[parsed.key] = parsed;
+    }
+    return out;
+  }
+  if (!isRecord(value)) return out;
+  for (const [key, entry] of Object.entries(value)) {
+    if (!isRecord(entry)) continue;
+    const parsed = parseVideoEntry(key, entry);
+    if (parsed) out[parsed.key] = parsed;
+  }
+  return out;
+}
 function parseConversionConfig(raw) {
   if (!raw || typeof raw !== "object") return null;
   const obj = raw;
@@ -750,7 +792,8 @@ function parseConversionConfig(raw) {
     goals,
     linked_hostnames: Array.isArray(obj.linked_hostnames) ? obj.linked_hostnames.filter((h) => typeof h === "string" && h.length > 0) : [],
     integrations: parseIntegrations(obj.integrations),
-    lead_forms: parseLeadForms(obj.lead_forms)
+    lead_forms: parseLeadForms(obj.lead_forms),
+    videos: parseVideos(obj.videos)
   };
 }
 function parseLeadForms(value) {
@@ -900,6 +943,21 @@ function automaticThresholdMet(goal, eventType, metadata) {
     case "form_start":
     case "phone_click":
       return true;
+    case "video_play":
+      return trigger.video_id == null || hasStringField(metadata, "video_id") && metadata.video_id === trigger.video_id;
+    case "video_progress": {
+      if (trigger.video_id != null && (!hasStringField(metadata, "video_id") || metadata.video_id !== trigger.video_id)) {
+        return false;
+      }
+      if (typeof trigger.threshold !== "number") return false;
+      if (trigger.metric === "seconds") {
+        return hasNumberField(metadata, "watched_s") && metadata.watched_s >= trigger.threshold;
+      }
+      if (trigger.metric === "percent") {
+        return hasNumberField(metadata, "max_percent") && metadata.max_percent >= trigger.threshold || hasNumberField(metadata, "watched_percent") && metadata.watched_percent >= trigger.threshold;
+      }
+      return false;
+    }
     default:
       return false;
   }
@@ -959,6 +1017,9 @@ var RETRY_BASE_MS = 5e3;
 var RETRY_MAX_MS = 5 * 6e4;
 var runtimes = /* @__PURE__ */ new Map();
 var configuredIds = /* @__PURE__ */ new Set();
+var EMPTY_GOALS = [];
+var EMPTY_STRINGS = [];
+var EMPTY_VIDEOS = {};
 var scriptLoad = null;
 var jsInitialized = false;
 function cacheKey(url) {
@@ -1149,11 +1210,11 @@ var TrackingConfigRuntime = class {
     void this.flush();
   }
   listGoals() {
-    return this.current?.goals ?? [];
+    return this.current?.goals ?? EMPTY_GOALS;
   }
   /** Sibling hostnames for the linker — read from the cached object even while unconfirmed. */
   linkedHostnames() {
-    return this.current?.linked_hostnames ?? [];
+    return this.current?.linked_hostnames ?? EMPTY_STRINGS;
   }
   /**
    * Integration blocks, from the cached object even while unconfirmed: the booking fallback
@@ -1166,6 +1227,14 @@ var TrackingConfigRuntime = class {
   leadForms() {
     return this.current?.lead_forms ?? null;
   }
+  /** Configured Cloudflare Stream tracked videos for this site. */
+  videos() {
+    return this.current?.videos ?? EMPTY_VIDEOS;
+  }
+  /** Look up one configured Cloudflare Stream tracked video by key. */
+  getVideo(key) {
+    return this.current?.videos?.[key] ?? null;
+  }
   async revalidateNow() {
     try {
       const headers = {};
@@ -1322,6 +1391,16 @@ var TrackingConfigRuntime = class {
         this.scheduleRetry();
         return;
       }
+      if (outcome === "fired" && typeof window !== "undefined" && typeof window.fbq === "function") {
+        try {
+          window.fbq("trackCustom", item.key, {
+            ...value != null ? { value } : {},
+            ...currency ? { currency } : {},
+            ...item.transactionId ? { transaction_id: item.transactionId } : {}
+          });
+        } catch {
+        }
+      }
       this.conversionQueue.shift();
     }
   }
@@ -1340,10 +1419,10 @@ var KNOWN_ROLES = new Set(LEAD_FORM_ROLES);
 var ROLE_ORDER = new Map(LEAD_FORM_ROLES.map((role, index) => [role, index]));
 var ADD_ON = /^add_on:[a-z0-9_-]{1,48}$/;
 var CONTRACT_NAME = /^[a-z][a-z0-9_]{0,47}(:[a-z0-9_-]{1,48})?$/;
-function judgeLeadForm(kind, formId, fields, contracts, settings) {
+function judgeLeadForm(kind, formId, fields, contracts, settings, { partial = false } = {}) {
   const generated = contracts?.contracts[kind];
   const live = liveContract(settings.trackingConfig, kind);
-  const violations = check(live === void 0 ? generated : fromLive(live), fields);
+  const violations = check(live === void 0 ? generated : fromLive(live), fields, partial);
   const liveHash = live === void 0 ? void 0 : live?.contract_hash ?? null;
   if (contracts && (liveHash !== void 0 && (generated?.hash ?? null) !== liveHash || contracts.registryVersion !== LEAD_FORM_REGISTRY_VERSION)) {
     violations.push({ role: null, rule: "contract_behind" });
@@ -1375,7 +1454,7 @@ function fromLive(live) {
     options: Object.fromEntries(live.options.map((o) => [o.role, o.options.map((x) => x.key)]))
   };
 }
-function check(contract, fields) {
+function check(contract, fields, partial) {
   const answered = new Map(fields);
   const violations = [];
   for (const [role, value] of fields) {
@@ -1393,6 +1472,7 @@ function check(contract, fields) {
       violations.push({ role, rule: "unknown_option" });
     }
   }
+  if (partial) return violations;
   for (const { role, requiredWhen } of contract?.requires ?? []) {
     const owing = requiredWhen === null || optionKeys(answered.get(requiredWhen.role)).some((key) => requiredWhen.anyOf.includes(key));
     if (owing && !answered.has(role)) violations.push({ role, rule: "missing_required" });
@@ -1992,7 +2072,7 @@ var zSaleItemEntitySchema = z4.object({
   external_item_id: z4.nullable(z4.string()),
   id: z4.uuid(),
   name: z4.nullable(z4.string()),
-  quantity: z4.string().check(z4.regex(/^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$/)),
+  quantity: z4.string(),
   unit_cost_cents: z4.nullable(z4.int()),
   unit_price_cents: z4.int()
 });
@@ -2056,12 +2136,15 @@ var zSmsWithheldReason = z4.enum([
   "test_or_bot_session",
   "invalid_phone",
   "recently_texted",
+  "owner_not_alerted",
+  "no_new_details",
   "do_not_contact",
   "do_not_text_tag",
   "missing_value",
   "us_texting_pending",
   "us_texting_rejected",
-  "texts_paused"
+  "texts_paused",
+  "outside_nanp"
 ]);
 var zSaleSmsStatusSchema = z4.object({
   can_send_now: z4._default(z4.boolean(), false),
@@ -2111,6 +2194,17 @@ var zApiErrorSchema = z4.object({
   errors: z4._default(z4.nullish(z4.array(zValidationErrorItem)), null),
   request_id: z4._default(z4.nullish(z4.string()), null)
 });
+var zWritebackCorrectionAction = z4.enum(["retry", "restate_now"]);
+var zWritebackCorrectionState = z4.enum([
+  "queued",
+  "sent",
+  "restated",
+  "failed",
+  "limit_reached",
+  "voided",
+  "date_changed",
+  "dry_run_ok"
+]);
 var zWritebackEmailSource = z4.enum(["NONE", "SALE", "CUSTOMER", "HARVESTED"]);
 var zWritebackEnrichmentStatus = z4.enum(["NONE", "MATCHED", "AMBIGUOUS"]);
 var zWritebackSaleUploadCounts = z4.object({
@@ -2121,9 +2215,28 @@ var zWritebackSaleUploadCounts = z4.object({
   total: z4._default(z4.int(), 0),
   uploaded: z4._default(z4.int(), 0)
 });
+var zWritebackValueDrift = z4.enum(["none", "open", "failed"]);
+var zWritebackCorrectionSchema = z4.object({
+  action: z4.nullable(zWritebackCorrectionAction),
+  can_restate: z4._default(z4.boolean(), false),
+  drift: zWritebackValueDrift,
+  error_message: z4.nullable(z4.string()),
+  google_currency: z4.string(),
+  google_value_cents: z4.int(),
+  restated_at: z4.nullable(z4.iso.datetime({ offset: true })),
+  restated_from_cents: z4.nullable(z4.int()),
+  restatement_limit: z4.int(),
+  restatements_used: z4.int(),
+  sale_currency: z4.string(),
+  sale_value_cents: z4.int(),
+  sends_at: z4.nullable(z4.iso.datetime({ offset: true })),
+  state: zWritebackCorrectionState,
+  upload_id: z4.uuid()
+});
 var zSaleWritebackStatusSchema = z4.object({
   blocked_reason: z4.nullable(z4.string()),
   can_dispatch: z4._default(z4.boolean(), false),
+  correction: z4.nullable(zWritebackCorrectionSchema),
   email_source: z4.nullable(zWritebackEmailSource),
   enrichment_status: z4.nullable(zWritebackEnrichmentStatus),
   gclid_attached: z4._default(z4.boolean(), false),
@@ -2141,7 +2254,6 @@ var zSaleWritebackStatusSchema = z4.object({
     "out_of_window",
     "blocked"
   ]),
-  stale: z4._default(z4.boolean(), false),
   uncovered_service_ids: z4.array(z4.uuid()),
   uploads: zWritebackSaleUploadCounts
 });