@runbandit/sdk 3.3.0 → 3.5.0

package/dist/index.js

@@ -361,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) => {
@@ -377,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) {
@@ -420,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>
@@ -916,7 +916,369 @@ function platformById(id) {
   return SITE_PLATFORMS.find((platform) => platform.id === id);
 }
 
+// ../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"]
+  }
+];
+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 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 isDirectTouch(touch) {
+  return !touch.utmSource && !touch.utmMedium && !touch.utmCampaign && !touch.utmContent && !touch.trackingParam && !touch.referrerHost;
+}
+function safeUrl(raw) {
+  try {
+    return new URL(raw);
+  } catch {
+    return void 0;
+  }
+}
+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 klaviyoExchangeId = params.get("_kx");
+  if (klaviyoExchangeId)
+    touch.klaviyoExchangeId = klaviyoExchangeId;
+  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 ?? "",
+    touch.klaviyoExchangeId ?? ""
+  ]);
+}
+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 });
+}
+
+// ../shared/dist/trial-rule.js
+var TRIAL_RULES = ["served", "exposure"];
+function isTrialRule(value) {
+  return value === "served" || value === "exposure";
+}
+function trialRuleFor({ target, requested }) {
+  if (requested)
+    return requested;
+  return target ? "exposure" : "served";
+}
+function trialRuleOf(experiment) {
+  return experiment.trialOn ?? "served";
+}
+var TRIAL_RULE_COPY = {
+  served: "Counts a trial when served",
+  exposure: "Counts a trial when seen"
+};
+
 // 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) {
@@ -939,6 +1301,8 @@ var BanditsClient = class {
   namedEventQueue = [];
   sessionId;
   visitorId;
+  exposureQueue = [];
+  exposedIds = /* @__PURE__ */ new Set();
   flushTimer;
   constructor(config) {
     this.config = {
@@ -951,6 +1315,23 @@ var BanditsClient = class {
     this.sessionId = this.getOrCreateSessionId();
     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 = {
@@ -979,7 +1360,8 @@ var BanditsClient = class {
       experimentId,
       userId,
       config: assignment.treatment?.config || {},
-      funnelId: assignment.funnelId
+      funnelId: assignment.funnelId,
+      trialOn: assignment.trialOn
     };
   }
   trackNamedEvent(event, opts) {
@@ -990,6 +1372,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) {
@@ -1014,6 +1398,12 @@ var BanditsClient = class {
     }
   }
   async flush() {
+    const results = await Promise.allSettled([this.flushNamedEvents(), this.flushExposures()]);
+    for (const result of results) {
+      if (result.status === "rejected") throw result.reason;
+    }
+  }
+  async flushNamedEvents() {
     const namedEvents = [...this.namedEventQueue];
     this.namedEventQueue = [];
     if (namedEvents.length === 0) return;
@@ -1032,14 +1422,75 @@ var BanditsClient = class {
       throw error;
     }
   }
-  async identify(anonymousId, identifiedUserId, mergeReason) {
+  async flushExposures() {
+    const exposures = [...this.exposureQueue];
+    this.exposureQueue = [];
+    if (exposures.length === 0) return;
+    try {
+      await fetch(`${this.normalizeApiUrl()}/exposures`, {
+        method: "POST",
+        headers: {
+          "Authorization": `Bearer ${this.config.apiKey}`,
+          "Content-Type": "application/json"
+        },
+        body: JSON.stringify({ exposures }),
+        keepalive: true
+      });
+    } catch (error) {
+      this.exposureQueue.unshift(...exposures);
+      throw error;
+    }
+  }
+  exposed(assignmentId, opts) {
+    if (this.exposedIds.has(assignmentId)) return;
+    this.exposedIds.add(assignmentId);
+    this.exposureQueue.push({ assignmentId, exposedAt: Date.now() });
+    if (opts?.immediate || this.exposureQueue.length >= this.config.batchSize) {
+      this.flushExposures().catch(console.error);
+    }
+  }
+  observeExposure(assignmentId, element, opts) {
+    if (typeof IntersectionObserver === "undefined") return () => {
+    };
+    const threshold = opts?.threshold ?? 0.5;
+    const dwellMs = opts?.dwellMs ?? 1e3;
+    let dwell;
+    const stop = () => {
+      clearTimeout(dwell);
+      dwell = void 0;
+    };
+    const observer = new IntersectionObserver(
+      (entries) => {
+        const entry = entries[entries.length - 1];
+        if (!entry) return;
+        const coversViewport = entry.rootBounds != null && entry.intersectionRect.height >= threshold * entry.rootBounds.height;
+        if (entry.isIntersecting && (entry.intersectionRatio >= threshold || coversViewport)) {
+          dwell ??= setTimeout(() => {
+            this.exposed(assignmentId);
+            disconnect();
+          }, dwellMs);
+        } else {
+          stop();
+        }
+      },
+      { threshold: Array.from({ length: 21 }, (_, i) => i / 20) }
+    );
+    const disconnect = () => {
+      stop();
+      observer.disconnect();
+    };
+    observer.observe(element);
+    return disconnect;
+  }
+  async identify(anonymousId, identifiedUserId, mergeReason, options) {
     const response = await this.makeRequest(
       "/identify",
       "POST",
       {
         anonymousId,
         identifiedUserId,
-        mergeReason: mergeReason || "manual"
+        mergeReason: mergeReason || "manual",
+        ...options?.email ? { email: options.email } : {}
       }
     );
     if (!response.success) {
@@ -1053,6 +1504,7 @@ var BanditsClient = class {
     }
   }
   async trackFunnelReward(funnelId, userId, value) {
+    await this.flushExposures().catch(() => void 0);
     const response = await this.makeRequest(
       `/funnels/${funnelId}/reward`,
       "POST",
@@ -1360,10 +1812,14 @@ 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,
@@ -1375,10 +1831,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,
@@ -1397,15 +1860,23 @@ export {
   STOREFRONT_KINDS,
   SUGGESTED_SITE_EXPERIMENTS,
   SnapshotClient,
+  TRACKING_PARAM_SOURCES,
+  TRIAL_RULES,
+  TRIAL_RULE_COPY,
+  UNKNOWN_SOURCE_KEY,
+  UTM_PARAMS,
   VISITOR_COOKIE,
   VISITOR_ID_KEY,
   appendEmailToken,
+  arrivalFromTouch,
   buildSubdomainUrl,
   calculateConfidenceInterval,
+  channelOf,
   extractDocumentSlots,
   extractEmailLinks,
   extractSlotNames,
   extractSubdomain,
+  formatPayout,
   generateId,
   generateSubdomain,
   getContentTypeCategory,
@@ -1414,9 +1885,15 @@ export {
   goalMatchesPage,
   hashRecipient,
   impressionManifest,
+  isArrivalActive,
+  isCurrencyUnit,
+  isDirectTouch,
+  isPassThroughHost,
+  isPayoutUnit,
   isPlacement,
   isShopifyCdnUrl,
   isSlotBinding,
+  isTrialRule,
   isValidEmail,
   isValidSubdomain,
   kindOfPlacement,
@@ -1424,8 +1901,10 @@ export {
   mintEmailToken,
   moreExperimentsSentence,
   normalizeAlgorithm,
+  normalizeArrivalValue,
   normalizeConversionPath,
   normalizeFunnelGoal,
+  normalizeHost,
   normalizePosterior,
   normalizeSiteTarget,
   normalizeTreatmentWeights,
@@ -1435,6 +1914,7 @@ export {
   parsePickerMessage,
   parseSiteContent,
   parseTreatmentContent,
+  payoutUnitOfRewardBasis,
   pickArm,
   pickEnvelope,
   pickStep,
@@ -1446,13 +1926,20 @@ export {
   renderFromPlan,
   reportPlanImpressions,
   resolveForgetting,
+  rewardValue,
   rewriteEmailLinks,
   sampleCombination,
   sanitizeMetadata,
   serializeDecisions,
   serializeTreatmentConfig,
   shouldRefreshPlan,
+  shouldReportTouch,
+  sourceOf,
   targetMatchesPage,
+  touchFromPage,
+  touchSignature,
+  trialRuleFor,
+  trialRuleOf,
   uniformFor,
   validateTreatmentWeights,
   verifyEmailToken