@runbandit/sdk 3.1.3 → 3.4.0

package/dist/index.js

@@ -1,3 +1,21 @@
+import {
+  DECISIONS_COOKIE,
+  DEFAULT_SESSION_TTL_MS,
+  SESSION_CREATED_AT_KEY,
+  SESSION_ID_KEY,
+  SnapshotClient,
+  VISITOR_COOKIE,
+  VISITOR_ID_KEY,
+  defaultSessionStorage,
+  generateId,
+  getOrCreateSessionId,
+  getOrCreateVisitorId,
+  parseDecisions,
+  pickTreatment,
+  readCookie,
+  serializeDecisions
+} from "./chunk-BG5L4PBC.js";
+
 // ../shared/dist/types.js
 var ExperimentStatus;
 (function(ExperimentStatus2) {
@@ -343,7 +361,7 @@ function resolve(value, slots, missing) {
   }
   return resolved;
 }
-function extractDocumentSlots(document) {
+function extractDocumentSlots(document2) {
   const names = [];
   const seen = /* @__PURE__ */ new Set();
   const visit = (value) => {
@@ -359,9 +377,9 @@ function extractDocumentSlots(document) {
     else if (typeof value === "object" && value !== null)
       Object.values(value).forEach(visit);
   };
-  visit(document.subject);
-  visit(document.preheader);
-  document.blocks.forEach(visit);
+  visit(document2.subject);
+  visit(document2.preheader);
+  document2.blocks.forEach(visit);
   return names;
 }
 function renderBlock(block, slots, missing) {
@@ -402,13 +420,13 @@ function renderBlock(block, slots, missing) {
       return "";
   }
 }
-function renderEmailDocument(document, slots) {
+function renderEmailDocument(document2, slots) {
   const missingSlots = [];
-  const width = document.contentWidth ?? CONTENT_WIDTH;
-  const background = escapeHtml(document.backgroundColor ?? "#f4f4f5");
-  const subject = resolve(document.subject, slots, missingSlots);
-  const preheader = resolve(document.preheader, slots, missingSlots);
-  const body = document.blocks.map((block) => renderBlock(block, slots, missingSlots)).join("\n");
+  const width = document2.contentWidth ?? CONTENT_WIDTH;
+  const background = escapeHtml(document2.backgroundColor ?? "#f4f4f5");
+  const subject = resolve(document2.subject, slots, missingSlots);
+  const preheader = resolve(document2.preheader, slots, missingSlots);
+  const body = document2.blocks.map((block) => renderBlock(block, slots, missingSlots)).join("\n");
   const html = `<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
 <html xmlns="http://www.w3.org/1999/xhtml" xmlns:v="urn:schemas-microsoft-com:vml" xmlns:o="urn:schemas-microsoft-com:office:office">
 <head>
@@ -898,55 +916,347 @@ function platformById(id) {
   return SITE_PLATFORMS.find((platform) => platform.id === id);
 }
 
-// src/session.ts
-var SESSION_ID_KEY = "bandits_session_id";
-var SESSION_CREATED_AT_KEY = "bandits_session_created_at";
-var VISITOR_ID_KEY = "bandits_visitor_id";
-var DEFAULT_SESSION_TTL_MS = 864e5;
-function generateId() {
-  if (typeof crypto !== "undefined" && crypto.randomUUID) {
-    return crypto.randomUUID();
+// ../shared/dist/arrival.js
+var ARRIVAL_CHANNELS = ["ad", "email", "social", "search", "referral", "direct"];
+var ARRIVAL_TTL_MS = 30 * 24 * 60 * 60 * 1e3;
+var MAX_ARRIVAL_VALUE_LENGTH = 40;
+var MAX_REFERRER_HOST_LENGTH = 100;
+var MAX_RAW_TOUCH_VALUE_LENGTH = 200;
+var UTM_PARAMS = [
+  ["utmSource", "utm_source"],
+  ["utmMedium", "utm_medium"],
+  ["utmCampaign", "utm_campaign"],
+  ["utmContent", "utm_content"]
+];
+var TRACKING_PARAM_SOURCES = {
+  gclid: "google",
+  gbraid: "google",
+  wbraid: "google",
+  fbclid: "facebook",
+  ttclid: "tiktok",
+  msclkid: "bing",
+  li_fat_id: "linkedin",
+  twclid: "x",
+  epik: "pinterest",
+  sccid: "snapchat",
+  _kx: "klaviyo",
+  mc_eid: "mailchimp"
+};
+var CHANNEL_RULES = [
+  {
+    channel: "ad",
+    field: "medium",
+    values: [
+      "cpc",
+      "ppc",
+      "paid",
+      "paid-social",
+      "paidsocial",
+      "paid-search",
+      "paidsearch",
+      "display",
+      "cpm",
+      "cpv",
+      "cpa",
+      "banner",
+      "ad",
+      "ads",
+      "paid-media",
+      "retargeting",
+      "affiliate"
+    ]
+  },
+  { channel: "email", field: "medium", values: ["email", "e-mail", "newsletter", "sms"] },
+  { channel: "social", field: "medium", values: ["social", "social-media", "organic-social", "sm"] },
+  { channel: "search", field: "medium", values: ["organic", "organic-search", "seo"] },
+  { channel: "referral", field: "medium", values: ["referral", "partner"] },
+  {
+    channel: "ad",
+    field: "trackingParam",
+    values: ["gclid", "gbraid", "wbraid", "fbclid", "ttclid", "msclkid", "li_fat_id", "twclid", "epik", "sccid"]
+  },
+  { channel: "email", field: "trackingParam", values: ["_kx", "mc_eid"] },
+  {
+    channel: "email",
+    field: "source",
+    values: [
+      "klaviyo",
+      "mailchimp",
+      "sendgrid",
+      "hubspot",
+      "hs-email",
+      "braze",
+      "iterable",
+      "customer.io",
+      "customerio",
+      "customer-io",
+      "omnisend",
+      "email",
+      "newsletter"
+    ]
+  },
+  {
+    channel: "social",
+    field: "source",
+    values: [
+      "facebook",
+      "fb",
+      "instagram",
+      "ig",
+      "tiktok",
+      "twitter",
+      "x",
+      "linkedin",
+      "pinterest",
+      "reddit",
+      "youtube",
+      "snapchat",
+      "threads"
+    ]
+  },
+  { channel: "search", field: "source", values: ["google", "bing", "duckduckgo", "yahoo", "baidu", "yandex", "ecosia"] },
+  {
+    channel: "email",
+    field: "referrerHost",
+    values: ["mail.google.com", "outlook.live.com", "outlook.office.com", "outlook.office365.com", "mail.yahoo.com"]
+  },
+  {
+    channel: "social",
+    field: "referrerHost",
+    values: [
+      "facebook.com",
+      "fb.com",
+      "fb.me",
+      "instagram.com",
+      "t.co",
+      "twitter.com",
+      "x.com",
+      "linkedin.com",
+      "lnkd.in",
+      "pinterest.com",
+      "pin.it",
+      "reddit.com",
+      "youtube.com",
+      "youtu.be",
+      "tiktok.com",
+      "snapchat.com",
+      "threads.net"
+    ]
+  },
+  {
+    channel: "search",
+    field: "referrerHost",
+    values: ["google", "bing.com", "duckduckgo.com", "yahoo", "baidu.com", "yandex", "ecosia.org", "search.brave.com"]
   }
-  return "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, (c) => {
-    const r = Math.random() * 16 | 0;
-    return (c === "x" ? r : r & 3 | 8).toString(16);
-  });
+];
+function normalizeArrivalValue(raw) {
+  const value = raw?.trim().toLowerCase().replace(/[\s_]+/g, "-").slice(0, MAX_ARRIVAL_VALUE_LENGTH);
+  return value ? value : void 0;
+}
+function normalizeHost(raw) {
+  const host = raw?.trim().toLowerCase().replace(/^www\./, "").slice(0, MAX_REFERRER_HOST_LENGTH);
+  return host ? host : void 0;
+}
+function hostMatches(host, pattern) {
+  if (pattern.includes("."))
+    return host === pattern || host.endsWith(`.${pattern}`);
+  return host.split(".").slice(0, -1).includes(pattern);
+}
+var PASS_THROUGH_HOSTS = [
+  "checkout.stripe.com",
+  "stripe.com",
+  "paypal.com",
+  "shop.app",
+  "shopify.com",
+  "klarna.com",
+  "afterpay.com",
+  "affirm.com",
+  "accounts.google.com",
+  "appleid.apple.com",
+  "login.microsoftonline.com",
+  "login.live.com",
+  "auth0.com",
+  "clerk.accounts.dev",
+  "clerk.com",
+  "okta.com"
+];
+function isPassThroughHost(host) {
+  return PASS_THROUGH_HOSTS.some((pattern) => hostMatches(host, pattern));
 }
-function getOrCreateSessionId(options = {}) {
-  const { storage, now = () => Date.now(), ttlMs = DEFAULT_SESSION_TTL_MS } = options;
-  if (!storage) return generateId();
-  try {
-    const stored = storage.getItem(SESSION_ID_KEY);
-    const storedAt = storage.getItem(SESSION_CREATED_AT_KEY);
-    if (stored && storedAt) {
-      const age = now() - parseInt(storedAt, 10);
-      if (age < ttlMs) return stored;
-    }
-    const id = generateId();
-    storage.setItem(SESSION_ID_KEY, id);
-    storage.setItem(SESSION_CREATED_AT_KEY, String(now()));
-    return id;
-  } catch {
-    return generateId();
-  }
+function ruleMatches(rule, signals) {
+  const value = signals[rule.field];
+  if (!value)
+    return false;
+  if (rule.field === "referrerHost")
+    return rule.values.some((pattern) => hostMatches(value, pattern));
+  return rule.values.includes(value);
+}
+function channelOf(signals) {
+  const { trackingParam, ...arrival } = signals;
+  if (!trackingParam && Object.values(arrival).every((value) => !value))
+    return "direct";
+  const rule = CHANNEL_RULES.find((candidate) => ruleMatches(candidate, signals));
+  if (rule)
+    return rule.channel;
+  return arrival.referrerHost ? "referral" : void 0;
+}
+function arrivalReferrerHost(raw) {
+  const host = normalizeHost(raw);
+  return host && !isPassThroughHost(host) ? host : void 0;
+}
+function arrivalFromTouch(touch) {
+  const named = touch.trackingParam?.toLowerCase();
+  const trackingParam = named && Object.hasOwn(TRACKING_PARAM_SOURCES, named) ? named : void 0;
+  const fields = {
+    source: normalizeArrivalValue(touch.utmSource) ?? (trackingParam ? TRACKING_PARAM_SOURCES[trackingParam] : void 0),
+    medium: normalizeArrivalValue(touch.utmMedium),
+    campaign: normalizeArrivalValue(touch.utmCampaign),
+    content: normalizeArrivalValue(touch.utmContent),
+    referrerHost: arrivalReferrerHost(touch.referrerHost)
+  };
+  const present = Object.fromEntries(Object.entries(fields).filter(([, value]) => value !== void 0));
+  const channel = channelOf({ ...present, ...trackingParam ? { trackingParam } : {} });
+  return { ...present, ...channel ? { channel } : {} };
 }
-function getOrCreateVisitorId(storage) {
-  if (!storage) return generateId();
+function isDirectTouch(touch) {
+  return !touch.utmSource && !touch.utmMedium && !touch.utmCampaign && !touch.utmContent && !touch.trackingParam && !touch.referrerHost;
+}
+function safeUrl(raw) {
   try {
-    const stored = storage.getItem(VISITOR_ID_KEY);
-    if (stored) return stored;
-    const id = generateId();
-    storage.setItem(VISITOR_ID_KEY, id);
-    return id;
+    return new URL(raw);
   } catch {
-    return generateId();
+    return void 0;
   }
 }
-function defaultSessionStorage() {
-  return typeof window !== "undefined" && window.localStorage ? window.localStorage : null;
+function touchFromPage(page) {
+  const url = safeUrl(page.href);
+  if (!url)
+    return {};
+  const params = /* @__PURE__ */ new Map();
+  url.searchParams.forEach((value, key) => {
+    const name = key.toLowerCase();
+    const trimmed = value.trim();
+    if (trimmed && !params.has(name))
+      params.set(name, trimmed.slice(0, MAX_RAW_TOUCH_VALUE_LENGTH));
+  });
+  const touch = {};
+  for (const [field, param] of UTM_PARAMS) {
+    const value = params.get(param);
+    if (value)
+      touch[field] = value;
+  }
+  const trackingParam = Object.keys(TRACKING_PARAM_SOURCES).find((name) => params.has(name));
+  if (trackingParam)
+    touch.trackingParam = trackingParam;
+  const referrerHost = normalizeHost(safeUrl(page.referrer)?.hostname);
+  if (referrerHost && referrerHost !== normalizeHost(url.hostname))
+    touch.referrerHost = referrerHost;
+  return touch;
+}
+function touchSignature(touch) {
+  return JSON.stringify([
+    touch.utmSource ?? "",
+    touch.utmMedium ?? "",
+    touch.utmCampaign ?? "",
+    touch.utmContent ?? "",
+    touch.trackingParam ?? "",
+    touch.referrerHost ?? ""
+  ]);
+}
+function shouldReportTouch(touch, stored, sessionId, now) {
+  if (!stored)
+    return true;
+  if (isDirectTouch(touch))
+    return now - stored.at >= ARRIVAL_TTL_MS;
+  return stored.signature !== touchSignature(touch) || stored.sessionId !== sessionId;
+}
+function isArrivalActive(startedAt, at) {
+  return startedAt <= at && at - startedAt < ARRIVAL_TTL_MS;
+}
+var CHANNEL_LABELS = {
+  ad: "Ad",
+  email: "Email",
+  social: "Social",
+  search: "Search",
+  referral: "Referral",
+  direct: "Direct"
+};
+var UNKNOWN_SOURCE_KEY = "unknown";
+var titleCase = (value) => value.charAt(0).toUpperCase() + value.slice(1);
+function sourceOf(arrival) {
+  if (!arrival)
+    return { key: UNKNOWN_SOURCE_KEY, label: "Unknown" };
+  const channel = arrival.channel ? { channel: arrival.channel } : {};
+  if (arrival.source && arrival.campaign) {
+    return { key: `src:${arrival.source}|${arrival.campaign}`, label: `${titleCase(arrival.source)} \xB7 ${arrival.campaign}`, ...channel };
+  }
+  if (arrival.source)
+    return { key: `src:${arrival.source}`, label: titleCase(arrival.source), ...channel };
+  if (arrival.campaign)
+    return { key: `cmp:${arrival.campaign}`, label: arrival.campaign, ...channel };
+  if (arrival.referrerHost)
+    return { key: `ref:${arrival.referrerHost}`, label: arrival.referrerHost, ...channel };
+  if (arrival.channel)
+    return { key: `ch:${arrival.channel}`, label: CHANNEL_LABELS[arrival.channel], ...channel };
+  return { key: "ch:tagged", label: "Tagged" };
+}
+
+// ../shared/dist/payout-unit.js
+var PAYOUT_UNITS = ["count", "revenue", "margin"];
+var NEW_PAYOUT_UNIT = "count";
+function isPayoutUnit(value) {
+  return value === "count" || value === "revenue" || value === "margin";
+}
+function isCurrencyUnit(unit) {
+  return unit !== "count";
+}
+function rewardValue(unit, supplied) {
+  if (unit === "count")
+    return supplied === void 0 || supplied > 0 ? 1 : 0;
+  return supplied ?? 1;
+}
+function payoutUnitOfRewardBasis(rewardBasis) {
+  return rewardBasis === "revenue" || rewardBasis === "margin" ? rewardBasis : "count";
+}
+var PAYOUT_UNIT_COPY = {
+  count: {
+    label: "Count conversions",
+    hint: "Each conversion counts as 1. Use this when a conversion has no price, like a booked demo call.",
+    total: "Conversions",
+    perVisitor: "Conversions per visitor",
+    influence: "Influence on conversions"
+  },
+  revenue: {
+    label: "Order value",
+    hint: "Use the order value you send with each conversion.",
+    total: "Total payout",
+    perVisitor: "Revenue per visitor",
+    influence: "Influence on payout"
+  },
+  margin: {
+    label: "Contribution margin",
+    hint: "Revenue minus product and shipping cost, from orders sent to POST /api/orders. A below-cost order counts against its treatment.",
+    total: "Total margin",
+    perVisitor: "Margin per visitor",
+    influence: "Influence on margin"
+  }
+};
+var USD = new Intl.NumberFormat("en-US", { style: "currency", currency: "USD", minimumFractionDigits: 2, maximumFractionDigits: 2 });
+function formatPayout(unit, value) {
+  return isCurrencyUnit(unit) ? USD.format(value) : value.toLocaleString("en-US", { maximumFractionDigits: 2 });
 }
 
 // src/client.ts
+var ARRIVAL_KEY = "bandits_arrival";
+function readStoredArrival(storage) {
+  try {
+    const parsed = JSON.parse(storage?.getItem(ARRIVAL_KEY) ?? "null");
+    if (typeof parsed?.signature !== "string" || typeof parsed?.sessionId !== "string" || typeof parsed?.at !== "number") return null;
+    return parsed;
+  } catch {
+    return null;
+  }
+}
 var BanditsRequestError = class extends Error {
   status;
   constructor(message, status) {
@@ -979,8 +1289,25 @@ var BanditsClient = class {
       ...config
     };
     this.sessionId = this.getOrCreateSessionId();
-    this.visitorId = getOrCreateVisitorId(defaultSessionStorage());
+    this.visitorId = config.visitorId ?? getOrCreateVisitorId(defaultSessionStorage());
     this.startBatchFlush();
+    if (config.captureArrival !== false) void this.reportArrival();
+  }
+  async reportArrival() {
+    if (typeof location === "undefined" || typeof document === "undefined") return false;
+    const storage = defaultSessionStorage();
+    const touch = touchFromPage({ href: location.href, referrer: document.referrer });
+    const now = Date.now();
+    if (!shouldReportTouch(touch, readStoredArrival(storage), this.sessionId, now)) return false;
+    const response = await this.makeRequest("/arrivals", "POST", { userId: this.visitorId, touch });
+    if (!response.success) return false;
+    const stored = { signature: touchSignature(touch), sessionId: this.sessionId, at: now };
+    try {
+      storage?.setItem(ARRIVAL_KEY, JSON.stringify(stored));
+    } catch {
+      return true;
+    }
+    return true;
   }
   async getAssignment(experimentId, userId = this.visitorId, context) {
     const request = {
@@ -1020,6 +1347,8 @@ var BanditsClient = class {
       metadata: event.metadata,
       sessionId: this.sessionId
     };
+    if (event.cost !== void 0) request.cost = event.cost;
+    if (event.lineItems) request.lineItems = event.lineItems;
     if (opts?.userId) request.userId = opts.userId;
     if (opts?.assignmentId) request.assignmentId = opts.assignmentId;
     if (opts?.immediate) {
@@ -1198,206 +1527,6 @@ var BanditsClient = class {
   }
 };
 
-// src/snapshot-cache.ts
-var STORAGE_KEY = "bandits_snapshot";
-var REPORT_QUEUE_KEY = "bandits_pending_reports";
-var DECISIONS_KEY = "bandits_client_assignments";
-function pickTreatment(treatments, draw) {
-  if (treatments.length === 0) return null;
-  let cumulative = 0;
-  for (const treatment of treatments) {
-    cumulative += treatment.pct;
-    if (draw < cumulative) return treatment;
-  }
-  return treatments[treatments.length - 1];
-}
-var DEFAULT_ASSIGNMENT_TTL_SECONDS = 86400;
-function randomId() {
-  const chars = "abcdefghijklmnopqrstuvwxyz0123456789";
-  let id = "";
-  for (let i = 0; i < 24; i++) {
-    id += chars.charAt(Math.floor(Math.random() * chars.length));
-  }
-  return id;
-}
-var SnapshotClient = class {
-  config;
-  storage;
-  now;
-  fetchImpl;
-  snapshot = null;
-  queue = [];
-  sessionId;
-  inFlight = null;
-  constructor(config) {
-    this.config = config;
-    this.now = config.now ?? (() => Date.now());
-    this.fetchImpl = config.fetchImpl ?? ((...args) => fetch(...args));
-    this.storage = config.storage ?? (typeof window !== "undefined" && window.localStorage ? window.localStorage : null);
-    this.queue = this.readQueue();
-    this.sessionId = getOrCreateSessionId({
-      storage: this.storage ?? defaultSessionStorage(),
-      now: this.now,
-      ttlMs: config.sessionTtl
-    });
-    if (config.inlineSnapshot) {
-      this.snapshot = config.inlineSnapshot;
-      this.persistSnapshot(config.inlineSnapshot);
-    } else {
-      this.snapshot = this.readSnapshot();
-    }
-  }
-  getAssignmentSync(experimentId, userId) {
-    const snapshot = this.freshSnapshot();
-    if (!snapshot) return null;
-    const experiment = snapshot.experiments[experimentId];
-    if (!experiment || experiment.mode !== "snapshot") return null;
-    const key = `${experimentId}:${userId}`;
-    const decisions = this.readDecisions();
-    const stored = decisions[key];
-    if (stored && stored.expiresAt > this.now()) {
-      const held = experiment.treatments.find((t) => t.id === stored.treatmentId);
-      if (held) {
-        return {
-          clientAssignmentId: stored.clientAssignmentId,
-          experimentId,
-          treatmentId: held.id,
-          config: held.config
-        };
-      }
-    }
-    const treatment = pickTreatment(experiment.treatments, Math.random());
-    if (!treatment) return null;
-    const clientAssignmentId = randomId();
-    const ttlSeconds = experiment.assignmentTtl ?? DEFAULT_ASSIGNMENT_TTL_SECONDS;
-    decisions[key] = {
-      clientAssignmentId,
-      treatmentId: treatment.id,
-      expiresAt: this.now() + ttlSeconds * 1e3
-    };
-    this.writeDecisions(decisions);
-    this.queue.push({
-      clientAssignmentId,
-      experimentId,
-      treatmentId: treatment.id,
-      userId,
-      sessionId: this.sessionId
-    });
-    this.persistQueue();
-    return {
-      clientAssignmentId,
-      experimentId,
-      treatmentId: treatment.id,
-      config: treatment.config
-    };
-  }
-  async refresh() {
-    const response = await this.fetchImpl(`${this.config.apiUrl}/snapshot`, {
-      method: "GET",
-      headers: { "x-api-key": this.config.publishableKey }
-    });
-    if (!response.ok) return;
-    const snapshot = await response.json();
-    this.snapshot = snapshot;
-    this.persistSnapshot(snapshot);
-  }
-  async flush() {
-    if (this.inFlight) return this.inFlight;
-    this.inFlight = this.doFlush().finally(() => {
-      this.inFlight = null;
-    });
-    return this.inFlight;
-  }
-  async doFlush() {
-    if (this.queue.length === 0) return;
-    const reports = this.queue.slice(0, 1e3);
-    try {
-      const response = await this.fetchImpl(`${this.config.apiUrl}/assignments/report`, {
-        method: "POST",
-        headers: {
-          "content-type": "application/json",
-          "x-api-key": this.config.publishableKey
-        },
-        body: JSON.stringify({ reports }),
-        keepalive: true
-      });
-      if (!response.ok) return;
-    } catch {
-      return;
-    }
-    this.queue = this.queue.slice(reports.length);
-    this.persistQueue();
-  }
-  getSessionId() {
-    return this.sessionId;
-  }
-  pendingReportCount() {
-    return this.queue.length;
-  }
-  freshSnapshot() {
-    if (!this.snapshot) return null;
-    if (this.snapshot.ttl === 0) return null;
-    const ageMs = this.now() - this.snapshot.generatedAt;
-    if (ageMs > this.snapshot.ttl * 1e3) return null;
-    return this.snapshot;
-  }
-  readSnapshot() {
-    if (!this.storage) return null;
-    try {
-      const raw = this.storage.getItem(STORAGE_KEY);
-      return raw ? JSON.parse(raw) : null;
-    } catch {
-      return null;
-    }
-  }
-  persistSnapshot(snapshot) {
-    if (!this.storage) return;
-    try {
-      this.storage.setItem(STORAGE_KEY, JSON.stringify(snapshot));
-    } catch {
-    }
-  }
-  readQueue() {
-    if (!this.storage) return [];
-    try {
-      const raw = this.storage.getItem(REPORT_QUEUE_KEY);
-      return raw ? JSON.parse(raw) : [];
-    } catch {
-      return [];
-    }
-  }
-  readDecisions() {
-    if (!this.storage) return {};
-    try {
-      const raw = this.storage.getItem(DECISIONS_KEY);
-      if (!raw) return {};
-      const parsed = JSON.parse(raw);
-      const now = this.now();
-      const live = {};
-      for (const [k, d] of Object.entries(parsed)) {
-        if (d && d.expiresAt > now) live[k] = d;
-      }
-      return live;
-    } catch {
-      return {};
-    }
-  }
-  writeDecisions(decisions) {
-    if (!this.storage) return;
-    try {
-      this.storage.setItem(DECISIONS_KEY, JSON.stringify(decisions));
-    } catch {
-    }
-  }
-  persistQueue() {
-    if (!this.storage) return;
-    try {
-      this.storage.setItem(REPORT_QUEUE_KEY, JSON.stringify(this.queue));
-    } catch {
-    }
-  }
-};
-
 // src/email-links.ts
 var UNTRACKABLE_SCHEME = /^(mailto:|tel:|sms:|javascript:|data:|#)/i;
 var NOTRACK_ATTRIBUTE = "data-bandit-notrack";
@@ -1590,12 +1719,17 @@ async function batchKeyFor(campaignId, recipientIds) {
   return Array.from(new Uint8Array(digest).slice(0, 16)).map((b) => b.toString(16).padStart(2, "0")).join("");
 }
 export {
+  ARRIVAL_CHANNELS,
+  ARRIVAL_TTL_MS,
   BanditAlgorithm,
   BanditsClient as BanditClient,
   BanditsClient,
   BanditsRequestError,
+  CHANNEL_LABELS,
+  CHANNEL_RULES,
   CONTENT_TYPE_BY_KIND,
   ContentType,
+  DECISIONS_COOKIE,
   DEFAULT_HALF_LIFE_MS,
   DEFAULT_SESSION_TTL_MS,
   DEFAULT_WINDOW_MS,
@@ -1604,10 +1738,17 @@ export {
   ForgettingMode,
   FunnelStatus,
   MAX_ALTERNATIVES,
+  MAX_ARRIVAL_VALUE_LENGTH,
   MAX_IMAGE_URL_LENGTH,
   MAX_ORDERING_ITEMS,
+  MAX_RAW_TOUCH_VALUE_LENGTH,
+  MAX_REFERRER_HOST_LENGTH,
   MAX_TEXT_ALTERNATIVE_LENGTH,
   MIN_ORDERING_ITEMS,
+  NEW_PAYOUT_UNIT,
+  PASS_THROUGH_HOSTS,
+  PAYOUT_UNITS,
+  PAYOUT_UNIT_COPY,
   PICK_CHANNEL,
   PICK_MODES,
   PICK_PROTOCOL_VERSION,
@@ -1626,14 +1767,21 @@ export {
   STOREFRONT_KINDS,
   SUGGESTED_SITE_EXPERIMENTS,
   SnapshotClient,
+  TRACKING_PARAM_SOURCES,
+  UNKNOWN_SOURCE_KEY,
+  UTM_PARAMS,
+  VISITOR_COOKIE,
   VISITOR_ID_KEY,
   appendEmailToken,
+  arrivalFromTouch,
   buildSubdomainUrl,
   calculateConfidenceInterval,
+  channelOf,
   extractDocumentSlots,
   extractEmailLinks,
   extractSlotNames,
   extractSubdomain,
+  formatPayout,
   generateId,
   generateSubdomain,
   getContentTypeCategory,
@@ -1642,6 +1790,11 @@ export {
   goalMatchesPage,
   hashRecipient,
   impressionManifest,
+  isArrivalActive,
+  isCurrencyUnit,
+  isDirectTouch,
+  isPassThroughHost,
+  isPayoutUnit,
   isPlacement,
   isShopifyCdnUrl,
   isSlotBinding,
@@ -1652,32 +1805,43 @@ export {
   mintEmailToken,
   moreExperimentsSentence,
   normalizeAlgorithm,
+  normalizeArrivalValue,
   normalizeConversionPath,
   normalizeFunnelGoal,
+  normalizeHost,
   normalizePosterior,
   normalizeSiteTarget,
   normalizeTreatmentWeights,
   parseAlternative,
+  parseDecisions,
   parsePanelMessage,
   parsePickerMessage,
   parseSiteContent,
   parseTreatmentContent,
+  payoutUnitOfRewardBasis,
   pickArm,
   pickEnvelope,
   pickStep,
   pickTreatment,
   platformById,
+  readCookie,
   renderEmail,
   renderEmailDocument,
   renderFromPlan,
   reportPlanImpressions,
   resolveForgetting,
+  rewardValue,
   rewriteEmailLinks,
   sampleCombination,
   sanitizeMetadata,
+  serializeDecisions,
   serializeTreatmentConfig,
   shouldRefreshPlan,
+  shouldReportTouch,
+  sourceOf,
   targetMatchesPage,
+  touchFromPage,
+  touchSignature,
   uniformFor,
   validateTreatmentWeights,
   verifyEmailToken