@aranova/tracking-react 1.17.0 → 1.19.0

package/dist/index.js

@@ -36,6 +36,7 @@ __export(src_exports, {
   ConsentBanner: () => import_client.ConsentBanner,
   DEFAULT_DECLINE_TTL_DAYS: () => DEFAULT_DECLINE_TTL_DAYS,
   DEFAULT_PHONE_COUNTRY: () => DEFAULT_PHONE_COUNTRY,
+  DEFAULT_VIDEO_CHECKPOINTS: () => import_client5.DEFAULT_VIDEO_CHECKPOINTS,
   EVENT_SEMANTICS: () => EVENT_SEMANTICS,
   GoogleAdsTracking: () => import_client.GoogleAdsTracking,
   LEAD_FORM_KINDS: () => LEAD_FORM_KINDS,
@@ -49,6 +50,8 @@ __export(src_exports, {
   SUPPORTED_CURRENCIES: () => SUPPORTED_CURRENCIES,
   TRACKING_PARAM_KEYS: () => TRACKING_PARAM_KEYS,
   TRACKING_RANGES: () => TRACKING_RANGES,
+  TrackedVideo: () => import_client5.TrackedVideo,
+  TrackedVideoStage: () => import_client5.TrackedVideoStage,
   bookableSlots: () => bookableSlots,
   buildBookingHandoffUrl: () => buildBookingHandoffUrl,
   captureTrackingParamsFromLocation: () => captureTrackingParamsFromLocation,
@@ -73,6 +76,7 @@ __export(src_exports, {
   getTrackingConfigRuntime: () => getTrackingConfigRuntime,
   groupBookingOptions: () => groupBookingOptions,
   leadFormPrimitiveSchemas: () => leadFormPrimitiveSchemas,
+  mergeVideoRanges: () => mergeVideoRanges,
   newBookingAttemptKey: () => newBookingAttemptKey,
   onConsentChange: () => onConsentChange,
   optIn: () => optIn,
@@ -82,6 +86,7 @@ __export(src_exports, {
   resetConsent: () => resetConsent,
   resolveConversionConfig: () => resolveConversionConfig,
   resolveTrackingConfigUrl: () => resolveTrackingConfigUrl,
+  roundVideoSeconds: () => roundVideoSeconds,
   saleCreateSchema: () => saleCreateSchema,
   saleItemSchema: () => saleItemSchema,
   saleServiceSchema: () => saleServiceSchema,
@@ -91,6 +96,9 @@ __export(src_exports, {
   shopToday: () => shopToday,
   slotFields: () => slotFields,
   stashUserData: () => stashUserData,
+  streamManifestUrl: () => import_client5.streamManifestUrl,
+  streamPosterUrl: () => import_client5.streamPosterUrl,
+  sumVideoRangesSeconds: () => sumVideoRangesSeconds,
   timeWindow: () => timeWindow,
   toE164: () => toE164,
   toMinor: () => toMinor,
@@ -104,6 +112,7 @@ __export(src_exports, {
   useGclid: () => import_client.useGclid,
   usePhoneConfig: () => import_client2.usePhoneConfig,
   usePhoneField: () => import_client2.usePhoneField,
+  useTrackedVideoConfig: () => import_client5.useTrackedVideoConfig,
   useTrackingParams: () => import_client.useTrackingParams
 });
 module.exports = __toCommonJS(src_exports);
@@ -331,7 +340,8 @@ var TRACKING_CAPABILITIES = [
   "form_capture",
   "phone_click_capture",
   "phone_fields",
-  "typed_form_submit"
+  "typed_form_submit",
+  "video_tracking"
 ];
 var CAPABILITY_DOM_ATTRIBUTE = "data-aranova-capability";
 var registered = /* @__PURE__ */ new Set();
@@ -872,8 +882,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(fallbackKey2, entry) {
+  const key = typeof entry.key === "string" && entry.key ? entry.key : fallbackKey2;
+  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;
@@ -924,7 +974,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) {
@@ -1170,6 +1221,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;
   }
@@ -1229,6 +1295,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 cacheKey2(url) {
@@ -1419,11 +1488,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
@@ -1436,6 +1505,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 = {};
@@ -1592,6 +1669,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();
     }
   }
@@ -1778,6 +1865,13 @@ var EVENT_SEMANTICS = {
     outcomeRole: "engagement",
     clientVisibility: "detailed"
   },
+  // Adds to the submit it names; counting it as a lead would double every lead.
+  form_details: {
+    label: "Form details added",
+    category: "lead",
+    outcomeRole: "engagement",
+    clientVisibility: "detailed"
+  },
   form_submit: {
     label: "Form submitted",
     category: "lead",
@@ -1807,6 +1901,18 @@ var EVENT_SEMANTICS = {
     category: "page",
     outcomeRole: "navigation",
     clientVisibility: "simple"
+  },
+  video_play: {
+    label: "Video played",
+    category: "engagement",
+    outcomeRole: "engagement",
+    clientVisibility: "simple"
+  },
+  video_progress: {
+    label: "Video watched",
+    category: "engagement",
+    outcomeRole: "engagement",
+    clientVisibility: "detailed"
   }
 };
 function getEventSemantics(eventName) {
@@ -1836,7 +1942,6 @@ var jsonValueSchema = z2.lazy(
   ])
 ).register(z2.globalRegistry, { id: "JsonSerializableValue" });
 var contractNameSchema = z2.string().check(z2.regex(/^[a-z][a-z0-9_]{0,47}(:[a-z0-9_-]{1,48})?$/));
-var contractName = contractNameSchema;
 var violationRole = z2.string().check(
   z2.maxLength(200),
   z2.regex(
@@ -1848,38 +1953,41 @@ var contractViolationSchema = z2.strictObject({
   role: z2.nullable(violationRole),
   rule: z2.string().check(z2.regex(/^[a-z][a-z_]{0,47}$/))
 });
+var formFieldSchema = z2.strictObject({
+  name: z2.string(),
+  type: z2.string(),
+  label: z2.nullable(z2.string()),
+  value: jsonValueSchema,
+  role: z2.optional(z2.nullable(contractNameSchema))
+});
+var formExtraSchema = z2.optional(
+  z2.nullable(
+    z2.array(
+      z2.strictObject({
+        key: z2.string().check(z2.maxLength(64)),
+        label: z2.string().check(z2.maxLength(200)),
+        value: jsonValueSchema
+      })
+    ).check(z2.maxLength(20))
+  )
+);
+var contractVersionSchema = z2.optional(z2.nullable(z2.int().check(z2.gte(1))));
+var contractHashSchema = z2.optional(z2.nullable(z2.string().check(z2.maxLength(64))));
+var formContractViolationsSchema = z2.optional(
+  z2.nullable(z2.array(contractViolationSchema).check(z2.maxLength(MAX_CONTRACT_VIOLATIONS)))
+);
 var formSubmitMetadataSchema = z2.strictObject({
   form: z2.strictObject({
     id: z2.string(),
     action: z2.nullable(z2.string()),
-    fields: z2.optional(
-      z2.array(
-        z2.strictObject({
-          name: z2.string(),
-          type: z2.string(),
-          label: z2.nullable(z2.string()),
-          value: jsonValueSchema,
-          role: z2.optional(z2.nullable(contractName))
-        })
-      )
-    ),
-    kind: z2.optional(z2.nullable(contractName)),
-    contract_version: z2.optional(z2.nullable(z2.int().check(z2.gte(1)))),
-    contract_hash: z2.optional(z2.nullable(z2.string().check(z2.maxLength(64)))),
-    extra: z2.optional(
-      z2.nullable(
-        z2.array(
-          z2.strictObject({
-            key: z2.string().check(z2.maxLength(64)),
-            label: z2.string().check(z2.maxLength(200)),
-            value: jsonValueSchema
-          })
-        ).check(z2.maxLength(20))
-      )
-    ),
-    contract_violations: z2.optional(
-      z2.nullable(z2.array(contractViolationSchema).check(z2.maxLength(MAX_CONTRACT_VIOLATIONS)))
-    )
+    fields: z2.optional(z2.array(formFieldSchema)),
+    kind: z2.optional(z2.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: z2.optional(z2.nullable(z2.uuidv4()))
   }),
   page: z2.strictObject({
     path: z2.string()
@@ -1887,6 +1995,36 @@ var formSubmitMetadataSchema = z2.strictObject({
 });
 var formSubmitConfigSchema = z2.strictObject({});
 
+// ../tracking-core/src/video-ranges.ts
+function roundVideoSeconds(value) {
+  if (!Number.isFinite(value) || value < 0) return 0;
+  return Math.round(value * 100) / 100;
+}
+function mergeVideoRanges(ranges, epsilonSeconds = 0.25) {
+  const valid = ranges.filter((r) => Number.isFinite(r.start_s) && Number.isFinite(r.end_s) && r.end_s > r.start_s).map((r) => ({
+    start_s: roundVideoSeconds(r.start_s),
+    end_s: roundVideoSeconds(r.end_s)
+  })).filter((r) => r.end_s - r.start_s >= 0.05).sort((a, b) => a.start_s - b.start_s || a.end_s - b.end_s);
+  if (valid.length === 0) return [];
+  const merged = [{ ...valid[0] }];
+  for (let i = 1; i < valid.length; i += 1) {
+    const cur = valid[i];
+    const last = merged[merged.length - 1];
+    if (cur.start_s <= last.end_s + epsilonSeconds) {
+      last.end_s = roundVideoSeconds(Math.max(last.end_s, cur.end_s));
+    } else {
+      merged.push({ ...cur });
+    }
+  }
+  return merged;
+}
+function sumVideoRangesSeconds(ranges, durationSeconds = 0) {
+  const merged = mergeVideoRanges(ranges);
+  const raw = merged.reduce((acc, r) => acc + Math.max(0, r.end_s - r.start_s), 0);
+  const clamped = durationSeconds > 0 ? Math.min(raw, durationSeconds) : raw;
+  return roundVideoSeconds(clamped);
+}
+
 // ../tracking-core/src/ingest-typed.ts
 var clientSettings = /* @__PURE__ */ new WeakMap();
 function typedClientSettings(client) {
@@ -2011,10 +2149,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" });
@@ -2046,7 +2184,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) {
@@ -2064,6 +2202,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" });
@@ -2668,7 +2807,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()
 });
@@ -2732,12 +2871,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),
@@ -2787,6 +2929,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({
@@ -2797,9 +2950,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),
@@ -2817,7 +2989,6 @@ var zSaleWritebackStatusSchema = z4.object({
     "out_of_window",
     "blocked"
   ]),
-  stale: z4._default(z4.boolean(), false),
   uncovered_service_ids: z4.array(z4.uuid()),
   uploads: zWritebackSaleUploadCounts
 });
@@ -2944,6 +3115,7 @@ function phoneField(name, raw, country, label = null) {
 var import_client2 = require("@aranova/tracking-react/client");
 var import_client3 = require("@aranova/tracking-react/client");
 var import_client4 = require("@aranova/tracking-react/client");
+var import_client5 = require("@aranova/tracking-react/client");
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   AdPlatformTracking,
@@ -2952,6 +3124,7 @@ var import_client4 = require("@aranova/tracking-react/client");
   ConsentBanner,
   DEFAULT_DECLINE_TTL_DAYS,
   DEFAULT_PHONE_COUNTRY,
+  DEFAULT_VIDEO_CHECKPOINTS,
   EVENT_SEMANTICS,
   GoogleAdsTracking,
   LEAD_FORM_KINDS,
@@ -2965,6 +3138,8 @@ var import_client4 = require("@aranova/tracking-react/client");
   SUPPORTED_CURRENCIES,
   TRACKING_PARAM_KEYS,
   TRACKING_RANGES,
+  TrackedVideo,
+  TrackedVideoStage,
   bookableSlots,
   buildBookingHandoffUrl,
   captureTrackingParamsFromLocation,
@@ -2989,6 +3164,7 @@ var import_client4 = require("@aranova/tracking-react/client");
   getTrackingConfigRuntime,
   groupBookingOptions,
   leadFormPrimitiveSchemas,
+  mergeVideoRanges,
   newBookingAttemptKey,
   onConsentChange,
   optIn,
@@ -2998,6 +3174,7 @@ var import_client4 = require("@aranova/tracking-react/client");
   resetConsent,
   resolveConversionConfig,
   resolveTrackingConfigUrl,
+  roundVideoSeconds,
   saleCreateSchema,
   saleItemSchema,
   saleServiceSchema,
@@ -3007,6 +3184,9 @@ var import_client4 = require("@aranova/tracking-react/client");
   shopToday,
   slotFields,
   stashUserData,
+  streamManifestUrl,
+  streamPosterUrl,
+  sumVideoRangesSeconds,
   timeWindow,
   toE164,
   toMinor,
@@ -3020,6 +3200,7 @@ var import_client4 = require("@aranova/tracking-react/client");
   useGclid,
   usePhoneConfig,
   usePhoneField,
+  useTrackedVideoConfig,
   useTrackingParams
 });
 //# sourceMappingURL=index.js.map