@aranova/tracking-react 1.18.0 → 1.19.0

package/dist/index.mjs

@@ -233,7 +233,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();
@@ -774,8 +775,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;
@@ -826,7 +867,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) {
@@ -1072,6 +1114,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;
   }
@@ -1131,6 +1188,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) {
@@ -1321,11 +1381,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
@@ -1338,6 +1398,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 = {};
@@ -1494,6 +1562,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();
     }
   }
@@ -1716,6 +1794,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) {
@@ -1798,6 +1888,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) {
@@ -2580,7 +2700,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()
 });
@@ -2702,6 +2822,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({
@@ -2712,9 +2843,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),
@@ -2732,7 +2882,6 @@ var zSaleWritebackStatusSchema = z4.object({
     "out_of_window",
     "blocked"
   ]),
-  stale: z4._default(z4.boolean(), false),
   uncovered_service_ids: z4.array(z4.uuid()),
   uploads: zWritebackSaleUploadCounts
 });
@@ -2869,6 +3018,14 @@ import {
   useBookingSubmit
 } from "@aranova/tracking-react/client";
 import { createLeadFormSubmit } from "@aranova/tracking-react/client";
+import {
+  DEFAULT_VIDEO_CHECKPOINTS,
+  streamManifestUrl,
+  streamPosterUrl,
+  TrackedVideo,
+  TrackedVideoStage,
+  useTrackedVideoConfig
+} from "@aranova/tracking-react/client";
 export {
   AdPlatformTracking,
   AranovaApiError,
@@ -2876,6 +3033,7 @@ export {
   ConsentBanner,
   DEFAULT_DECLINE_TTL_DAYS,
   DEFAULT_PHONE_COUNTRY,
+  DEFAULT_VIDEO_CHECKPOINTS,
   EVENT_SEMANTICS,
   GoogleAdsTracking,
   LEAD_FORM_KINDS,
@@ -2889,6 +3047,8 @@ export {
   SUPPORTED_CURRENCIES,
   TRACKING_PARAM_KEYS,
   TRACKING_RANGES,
+  TrackedVideo,
+  TrackedVideoStage,
   bookableSlots,
   buildBookingHandoffUrl,
   captureTrackingParamsFromLocation,
@@ -2913,6 +3073,7 @@ export {
   getTrackingConfigRuntime,
   groupBookingOptions,
   leadFormPrimitiveSchemas,
+  mergeVideoRanges,
   newBookingAttemptKey,
   onConsentChange,
   optIn,
@@ -2922,6 +3083,7 @@ export {
   resetConsent,
   resolveConversionConfig,
   resolveTrackingConfigUrl,
+  roundVideoSeconds,
   saleCreateSchema,
   saleItemSchema,
   saleServiceSchema,
@@ -2931,6 +3093,9 @@ export {
   shopToday,
   slotFields,
   stashUserData,
+  streamManifestUrl,
+  streamPosterUrl,
+  sumVideoRangesSeconds,
   timeWindow,
   toE164,
   toMinor,
@@ -2944,6 +3109,7 @@ export {
   useGclid,
   usePhoneConfig,
   usePhoneField,
+  useTrackedVideoConfig,
   useTrackingParams
 };
 //# sourceMappingURL=index.mjs.map