@drip-apex/sdk 0.1.0 → 0.2.0

package/src/delivery-timing.test.ts

@@ -0,0 +1,104 @@
+import { afterEach, describe, expect, it, vi } from "vitest";
+import { collectDeliveryTiming } from "./delivery-timing";
+
+describe("delivery timing", () => {
+  afterEach(() => vi.restoreAllMocks());
+
+  it("collects snippet, external bundle, transfer, and SDK-ready timing", () => {
+    vi.spyOn(performance, "getEntriesByType").mockImplementation((type) => {
+      if (type === "navigation") return [{ startTime: 0 }] as PerformanceEntry[];
+      if (type === "resource") return [
+        {
+          name: "https://events.drip-apex.com/s/shop_123.js",
+          startTime: 25,
+          responseEnd: 75,
+          duration: 50,
+          encodedBodySize: 12_345,
+          transferSize: 12_645,
+        },
+        {
+          name: "https://events.drip-apex.com/sdk/1.2.3/drip.live.js",
+          startTime: 80,
+          responseEnd: 200,
+          duration: 120,
+          encodedBodySize: 45_678,
+          transferSize: 45_978,
+        },
+      ] as PerformanceEntry[];
+      return [];
+    });
+    vi.spyOn(performance, "timeOrigin", "get").mockReturnValue(1_000);
+
+    expect(collectDeliveryTiming(1_250, "https://events.drip-apex.com/sdk/1.2.3/drip.live.js"))
+      .toEqual({
+        snippet_fetch_ms: 50,
+        snippet_transfer_size: 12_645,
+        sdk_bundle_fetch_ms: 120,
+        sdk_bundle_transfer_size: 45_978,
+        time_to_sdk_ready_ms: 250,
+      });
+  });
+
+  it("preserves a zero transfer size for browser-cache hits", () => {
+    vi.spyOn(performance, "getEntriesByType").mockImplementation((type) => (
+      type === "resource" ? [{
+        name: "https://events.drip-apex.com/sdk/1.2.3/drip.live.js",
+        startTime: 10,
+        responseEnd: 20,
+        encodedBodySize: 45_678,
+        transferSize: 0,
+      }] as PerformanceEntry[] : []
+    ));
+
+    expect(collectDeliveryTiming(undefined).sdk_bundle_transfer_size).toBe(0);
+  });
+
+  it("falls back to encoded body size only when transfer size is unavailable", () => {
+    vi.spyOn(performance, "getEntriesByType").mockImplementation((type) => (
+      type === "resource" ? [{
+        name: "https://events.drip-apex.com/s/shop_123.js",
+        startTime: 10,
+        responseEnd: 20,
+        encodedBodySize: 5_000,
+      }] as PerformanceEntry[] : []
+    ));
+
+    expect(collectDeliveryTiming(undefined).snippet_transfer_size).toBe(5_000);
+  });
+
+  it("uses zero bundle timing for an inlined SDK", () => {
+    vi.spyOn(performance, "getEntriesByType").mockImplementation((type) => (
+      type === "resource" ? [{
+        name: "https://events.drip-apex.com/s/shop_123.js",
+        startTime: 10,
+        responseEnd: 30,
+        encodedBodySize: 5_000,
+        transferSize: 5_300,
+      }] as PerformanceEntry[] : []
+    ));
+
+    expect(collectDeliveryTiming(undefined)).toMatchObject({
+      sdk_bundle_fetch_ms: 0,
+      sdk_bundle_transfer_size: 0,
+    });
+  });
+
+  it("adds navigation startTime to the performance time origin", () => {
+    vi.spyOn(performance, "getEntriesByType").mockImplementation((type) => (
+      type === "navigation" ? [{ startTime: 50 }] as PerformanceEntry[] : []
+    ));
+    vi.spyOn(performance, "timeOrigin", "get").mockReturnValue(1_000);
+
+    expect(collectDeliveryTiming(1_250).time_to_sdk_ready_ms).toBe(200);
+  });
+
+  it("drops negative and implausibly large SDK-ready deltas", () => {
+    vi.spyOn(performance, "getEntriesByType").mockImplementation((type) => (
+      type === "navigation" ? [{ startTime: 0 }] as PerformanceEntry[] : []
+    ));
+    vi.spyOn(performance, "timeOrigin", "get").mockReturnValue(1_000);
+
+    expect(collectDeliveryTiming(999)).not.toHaveProperty("time_to_sdk_ready_ms");
+    expect(collectDeliveryTiming(301_001)).not.toHaveProperty("time_to_sdk_ready_ms");
+  });
+});

package/src/delivery-timing.ts

@@ -0,0 +1,89 @@
+import { navigationEntry, roundPerformance } from "./performance";
+
+export type DeliveryTiming = {
+  snippet_fetch_ms: number;
+  snippet_transfer_size: number;
+  sdk_bundle_fetch_ms: number;
+  sdk_bundle_transfer_size: number;
+  time_to_sdk_ready_ms?: number;
+};
+
+function duration(entry: PerformanceResourceTiming): number {
+  const value = Number.isFinite(entry.responseEnd) && Number.isFinite(entry.startTime)
+    ? entry.responseEnd - entry.startTime
+    : entry.duration;
+  return Number.isFinite(value) ? roundPerformance(Math.max(0, value)) : 0;
+}
+
+function transferSize(entry: PerformanceResourceTiming): number {
+  const size = entry.transferSize === undefined ? entry.encodedBodySize : entry.transferSize;
+  return Number.isFinite(size) ? Math.max(0, Math.round(size)) : 0;
+}
+
+function pathname(value: string): string {
+  try {
+    return new URL(value, typeof location !== "undefined" ? location.href : "https://apex.invalid").pathname;
+  } catch {
+    return value.split(/[?#]/, 1)[0] ?? "";
+  }
+}
+
+function navigationStartEpoch(navigation?: PerformanceNavigationTiming): number | null {
+  const startTime = navigation && Number.isFinite(navigation.startTime) && navigation.startTime >= 0
+    ? navigation.startTime
+    : 0;
+  let origin = performance.timeOrigin;
+  try { if (!(origin > 0)) origin = performance.timing?.navigationStart; } catch {}
+  if (!(origin > 0) && typeof performance.now === "function") origin = Date.now() - performance.now();
+  return Number.isFinite(origin) && origin > 0 ? origin + startTime : null;
+}
+
+function timeToSdkReady(sdkInitStartedAt: number | undefined, navigationStart: number | null): number | undefined {
+  if (navigationStart === null || !Number.isFinite(sdkInitStartedAt)) return undefined;
+  const delta = sdkInitStartedAt! - navigationStart;
+  if (!Number.isFinite(delta) || delta < 0 || delta > 5 * 60_000) return undefined;
+  return roundPerformance(delta);
+}
+
+export function collectDeliveryTiming(
+  sdkInitStartedAt: number | undefined,
+  sdkScriptSrc?: string,
+): DeliveryTiming {
+  const empty: DeliveryTiming = {
+    snippet_fetch_ms: 0,
+    snippet_transfer_size: 0,
+    sdk_bundle_fetch_ms: 0,
+    sdk_bundle_transfer_size: 0,
+  };
+  if (typeof performance === "undefined") return empty;
+
+  try {
+    const resources = (performance.getEntriesByType?.("resource") ?? []) as PerformanceResourceTiming[];
+    const navigation = navigationEntry();
+    const scriptPath = sdkScriptSrc ? pathname(sdkScriptSrc) : "";
+    let snippet: PerformanceResourceTiming | undefined;
+    let bundle: PerformanceResourceTiming | undefined;
+    for (const entry of resources) {
+      const entryPath = pathname(entry.name);
+      if (/^\/s\/[^/]+\.js$/i.test(entryPath)) {
+        if (!snippet || entry.startTime > snippet.startTime) snippet = entry;
+      } else if (
+        /\/sdk\/[^/]+\/drip\.(?:live|debug|heatmap)\.js$/i.test(entryPath)
+        || Boolean(scriptPath && entryPath === scriptPath && /\/drip\.[^/]+\.js$/i.test(entryPath))
+      ) {
+        if (!bundle || entry.startTime > bundle.startTime) bundle = entry;
+      }
+    }
+    const navigationStart = navigationStartEpoch(navigation);
+    const readyTiming = timeToSdkReady(sdkInitStartedAt, navigationStart);
+    return {
+      snippet_fetch_ms: snippet ? duration(snippet) : 0,
+      snippet_transfer_size: snippet ? transferSize(snippet) : 0,
+      sdk_bundle_fetch_ms: bundle ? duration(bundle) : 0,
+      sdk_bundle_transfer_size: bundle ? transferSize(bundle) : 0,
+      ...(readyTiming === undefined ? {} : { time_to_sdk_ready_ms: readyTiming }),
+    };
+  } catch {
+    return empty;
+  }
+}

package/src/early-interaction-capture.test.ts

@@ -0,0 +1,451 @@
+/** @vitest-environment jsdom */
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+import {
+  clearEarlyInteractions,
+  drainBootstrapEarlyInteractions,
+  drainEarlyInteractions,
+  EARLY_INTERACTION_STORAGE_KEY,
+  EARLY_INTERACTION_TTL_MS,
+  installEarlyInteractionCapture,
+  type EarlyInteractionEntry,
+} from "./early-interaction-capture";
+import type { Experiment } from "./types";
+
+// Hermeticity: weekday tests pin the most recent UTC Monday at 12:00 instead
+// of a literal calendar date.
+const RECENT_MONDAY_NOON = (() => {
+  const d = new Date();
+  d.setUTCDate(d.getUTCDate() - ((d.getUTCDay() + 6) % 7));
+  d.setUTCHours(12, 0, 0, 0);
+  return d;
+})();
+
+const experiment = {
+  id: "exp-1",
+  name: "CTA",
+  status: "running",
+  assignmentEpoch: 3,
+  variations: [{ id: "var-1", weight: 1, mutations: [] }],
+  goals: [{ id: "goal-1", type: "click", selector: ".buy" }],
+} as Experiment;
+
+function install(overrides: Partial<Parameters<typeof installEarlyInteractionCapture>[0]> = {}) {
+  installEarlyInteractionCapture({ experiments: [experiment], assignments: [{ experimentId: "exp-1", variationId: "var-1", assignmentEpoch: 3 }], configRevision: 7, pageUrl: "https://shop.test/products/one", ...overrides });
+}
+
+beforeEach(() => {
+  vi.useFakeTimers();
+  vi.setSystemTime(2_000);
+  localStorage.clear();
+  sessionStorage.clear();
+  document.cookie = "drip_consent=; Max-Age=0; Path=/";
+  document.body.innerHTML = '<a class="buy" data-sku="sku-1" href="#next">Buy</a><form class="buy" data-sku="sku-form"></form>';
+  globalThis.__dripHasConsent = undefined;
+  globalThis.__dripEarlyInteractions = undefined;
+  globalThis.__dripEarlyQ = undefined;
+  delete (globalThis as any).OnetrustActiveGroups;
+  delete (globalThis as any).Cookiebot;
+});
+
+afterEach(() => {
+  globalThis.__dripEarlyInteractions?.stop();
+  clearEarlyInteractions();
+  vi.useRealTimers();
+});
+
+describe("early interaction capture", () => {
+  it("drains bootstrap interactions once with their original timestamps", () => {
+    const target = document.querySelector("a.buy")!;
+    globalThis.__dripEarlyQ = [
+      { kind: "click", target, timestamp: 1234, id: 1, pageUrl: "https://shop.test/products/one", consentAllowed: true },
+      { kind: "click", target, timestamp: 1234, id: 1, pageUrl: "https://shop.test/products/one", consentAllowed: true },
+    ];
+    const consume = vi.fn();
+    const input = {
+      assignments: [{ experimentId: "exp-1", variationId: "var-1", assignmentEpoch: 3 }],
+      experiments: [experiment],
+      consume,
+    };
+    drainBootstrapEarlyInteractions(input);
+    drainBootstrapEarlyInteractions(input);
+    expect(consume).toHaveBeenCalledOnce();
+    expect(consume).toHaveBeenCalledWith("goal-1", expect.objectContaining({ variationId: "var-1" }), 1234, "click", "https://shop.test/products/one");
+  });
+
+  it("discards expired and future-dated bootstrap interactions", () => {
+    const target = document.querySelector("a.buy")!;
+    globalThis.__dripEarlyQ = [
+      { kind: "click", target, timestamp: 1_000, id: 1, pageUrl: "https://shop.test/expired", consentAllowed: true },
+      { kind: "click", target, timestamp: 1_000 + EARLY_INTERACTION_TTL_MS + 2, id: 2, pageUrl: "https://shop.test/future", consentAllowed: true },
+    ];
+    const consume = vi.fn();
+    drainBootstrapEarlyInteractions({
+      assignments: [{ experimentId: "exp-1", variationId: "var-1", assignmentEpoch: 3 }],
+      experiments: [experiment],
+      now: 1_000 + EARLY_INTERACTION_TTL_MS + 1,
+      consume,
+    });
+    expect(consume).not.toHaveBeenCalled();
+  });
+
+  it("discards bootstrap interactions when tracking consent is blocked", () => {
+    globalThis.__dripHasConsent = false;
+    globalThis.__dripEarlyQ = [{ kind: "click", target: document.querySelector("a.buy")!, timestamp: 1234, id: 1, pageUrl: "https://shop.test/products/one", consentAllowed: true }];
+    const consume = vi.fn();
+    drainBootstrapEarlyInteractions({ assignments: [{ experimentId: "exp-1", variationId: "var-1", assignmentEpoch: 3 }], experiments: [experiment], requireConsent: true, consume });
+    expect(consume).not.toHaveBeenCalled();
+    globalThis.__dripHasConsent = true;
+    drainBootstrapEarlyInteractions({ assignments: [{ experimentId: "exp-1", variationId: "var-1", assignmentEpoch: 3 }], experiments: [experiment], requireConsent: true, consume });
+    expect(consume).not.toHaveBeenCalled();
+  });
+
+  it("discards interactions captured before consent was allowed", () => {
+    globalThis.__dripHasConsent = true;
+    globalThis.__dripEarlyQ = [{ kind: "click", target: document.querySelector("a.buy")!, timestamp: 1234, id: 1, pageUrl: "https://shop.test/products/one", consentAllowed: false }];
+    const consume = vi.fn();
+    drainBootstrapEarlyInteractions({ assignments: [{ experimentId: "exp-1", variationId: "var-1", assignmentEpoch: 3 }], experiments: [experiment], requireConsent: true, consume });
+    expect(consume).not.toHaveBeenCalled();
+  });
+
+  it("tears down bootstrap listeners on the first drain and makes SPA rewires inert", () => {
+    const stop = vi.fn();
+    globalThis.__dripEarlyStop = stop;
+    globalThis.__dripEarlyQ = [{ kind: "click", target: document.querySelector("a.buy")!, timestamp: 1234, id: 1, pageUrl: "https://shop.test/products/one", consentAllowed: true }];
+    const consume = vi.fn();
+    const input = { assignments: [{ experimentId: "exp-1", variationId: "var-1", assignmentEpoch: 3 }], experiments: [experiment], consume };
+    drainBootstrapEarlyInteractions(input);
+    drainBootstrapEarlyInteractions(input);
+    expect(stop).toHaveBeenCalledOnce();
+    expect(consume).toHaveBeenCalledOnce();
+  });
+
+  it("uses the click-time URL for bootstrap goal matching", () => {
+    const urlExperiment = { ...experiment, goals: [{ id: "goal-1", type: "click", selector: ".buy", urlPattern: "/products/" }] } as Experiment;
+    globalThis.__dripEarlyQ = [{ kind: "click", target: document.querySelector("a.buy")!, timestamp: 1234, id: 1, pageUrl: "https://shop.test/products/original", consentAllowed: true }];
+    history.replaceState({}, "", "/collections/current");
+    const consume = vi.fn();
+    drainBootstrapEarlyInteractions({ assignments: [{ experimentId: "exp-1", variationId: "var-1", assignmentEpoch: 3 }], experiments: [urlExperiment], consume });
+    expect(consume).toHaveBeenCalledOnce();
+  });
+
+  it("uses the click-time URL for Page-scoped bootstrap goals", () => {
+    const pageExperiment = {
+      ...experiment,
+      targeting: { pageRules: [{ id: "page-products", includeRules: [{ type: "simple", pattern: "shop.test/products/*" }] }] },
+      goals: [{ id: "goal-1", type: "click", selector: ".buy", pageId: "page-products" }],
+    } as Experiment;
+    globalThis.__dripEarlyQ = [{ kind: "click", target: document.querySelector("a.buy")!, timestamp: 1234, id: 1, pageUrl: "https://shop.test/products/original", consentAllowed: true }];
+    history.replaceState({}, "", "/collections/current");
+    const consume = vi.fn();
+    drainBootstrapEarlyInteractions({ assignments: [{ experimentId: "exp-1", variationId: "var-1", assignmentEpoch: 3 }], experiments: [pageExperiment], activePageIds: new Set(), consume });
+    expect(consume).toHaveBeenCalledOnce();
+  });
+
+  it("does not pair a bootstrap click and submit from different forms", () => {
+    document.body.innerHTML = '<form id="one"><button class="buy">One</button></form><form id="two" class="buy"></form>';
+    globalThis.__dripEarlyQ = [
+      { kind: "click", target: document.querySelector("button")!, timestamp: 1000, id: 1, pageUrl: "https://shop.test/cart", consentAllowed: true },
+      { kind: "submit", target: document.querySelector("#two")!, timestamp: 1100, id: 2, pageUrl: "https://shop.test/cart", consentAllowed: true },
+    ];
+    const consume = vi.fn();
+    drainBootstrapEarlyInteractions({ assignments: [{ experimentId: "exp-1", variationId: "var-1", assignmentEpoch: 3 }], experiments: [experiment], consume });
+    expect(consume).toHaveBeenCalledTimes(2);
+  });
+
+  it("drains a bootstrap submit through its external form-associated button", () => {
+    document.body.innerHTML = '<form id="buy"></form><button class="external-buy" type="submit" form="buy">Buy</button>';
+    const submitExperiment = {
+      ...experiment,
+      goals: [{ id: "goal-submit", type: "submit", selector: ".external-buy" }],
+    } as Experiment;
+    globalThis.__dripEarlyQ = [{
+      kind: "submit",
+      target: document.querySelector("form")!,
+      timestamp: 1234,
+      id: 1,
+      pageUrl: "https://shop.test/products/one",
+      consentAllowed: true,
+    }];
+    const consume = vi.fn();
+    drainBootstrapEarlyInteractions({
+      assignments: [{ experimentId: "exp-1", variationId: "var-1", assignmentEpoch: 3 }],
+      experiments: [submitExperiment],
+      consume,
+    });
+    expect(consume).toHaveBeenCalledWith("goal-submit", expect.anything(), 1234, "submit", "https://shop.test/products/one");
+  });
+
+  it("pairs a bootstrap click and submit through an external form-associated button", () => {
+    document.body.innerHTML = '<form id="buy"></form><button class="external-buy" type="submit" form="buy">Buy</button>';
+    const pairedExperiment = { ...experiment, goals: [{ id: "goal-1", type: "click", selector: ".external-buy" }] } as Experiment;
+    globalThis.__dripEarlyQ = [
+      { kind: "click", target: document.querySelector("button")!, timestamp: 1000, id: 1, pageUrl: "https://shop.test/cart", consentAllowed: true },
+      { kind: "submit", target: document.querySelector("form")!, timestamp: 1100, id: 2, pageUrl: "https://shop.test/cart", consentAllowed: true },
+    ];
+    const consume = vi.fn();
+    drainBootstrapEarlyInteractions({ assignments: [{ experimentId: "exp-1", variationId: "var-1", assignmentEpoch: 3 }], experiments: [pairedExperiment], consume, now: 1200 });
+    expect(consume).toHaveBeenCalledOnce();
+  });
+
+  it("does not retain deny-before-attach interactions when consent is granted later", () => {
+    globalThis.__dripHasConsent = false;
+    install({ requireConsent: true });
+    document.querySelector(".buy")!.dispatchEvent(new MouseEvent("click", { bubbles: true }));
+    globalThis.__dripHasConsent = true;
+    const consumed: EarlyInteractionEntry[] = [];
+    drainEarlyInteractions({ experiments: [experiment], configRevision: 7, sessionId: "missing", consume: (entry) => consumed.push(entry) });
+    expect(consumed).toEqual([]);
+    expect(localStorage.getItem(EARLY_INTERACTION_STORAGE_KEY)).toBeNull();
+  });
+
+  it("writes through before navigation and drains on the next page", () => {
+    install();
+    document.querySelector("a.buy")!.dispatchEvent(new MouseEvent("click", { bubbles: true }));
+    const sessionId = sessionStorage.getItem("drip_sid")!;
+    const queued = localStorage.getItem(EARLY_INTERACTION_STORAGE_KEY)!;
+    expect(JSON.parse(queued)).toHaveLength(1);
+    globalThis.__dripEarlyInteractions?.stop();
+    globalThis.__dripEarlyInteractions = undefined;
+    const consumed: EarlyInteractionEntry[] = [];
+    drainEarlyInteractions({ experiments: [experiment], configRevision: 7, sessionId, consume: (entry) => consumed.push(entry) });
+    expect(consumed).toMatchObject([{ goalId: "goal-1", kind: "click", pageUrl: "https://shop.test/products/one", data: { early_interaction: true } }]);
+    expect(localStorage.getItem(EARLY_INTERACTION_STORAGE_KEY)).toBeNull();
+  });
+
+  it("captures qualifying form submissions", () => {
+    install({ storageMode: "sessionStorage" });
+    document.querySelector("form")!.dispatchEvent(new Event("submit", { bubbles: true, cancelable: true }));
+    const entries = JSON.parse(sessionStorage.getItem(EARLY_INTERACTION_STORAGE_KEY)!);
+    expect(entries).toMatchObject([{ goalId: "goal-1", kind: "submit", data: { early_interaction: true } }]);
+  });
+
+  it("pairs durable click and submit capture through an external form-associated button", () => {
+    document.body.innerHTML = '<form id="buy"></form><button class="buy" type="button" form="buy">Buy</button>';
+    install();
+    document.querySelector("button")!.dispatchEvent(new MouseEvent("click", { bubbles: true }));
+    document.querySelector("form")!.dispatchEvent(new SubmitEvent("submit", { bubbles: true, cancelable: true, submitter: document.querySelector("button")! }));
+    expect(JSON.parse(localStorage.getItem(EARLY_INTERACTION_STORAGE_KEY)!)).toHaveLength(1);
+  });
+
+  it("captures a scoped click only when its Page is active", () => {
+    const scoped = {
+      ...experiment,
+      targeting: {
+        pageRules: [{
+          id: "page-products",
+          includeRules: [{ type: "simple", pattern: "shop.test/products/*" }],
+        }],
+      },
+      goals: [{
+        id: "goal-1",
+        type: "click",
+        selector: ".buy",
+        pageId: "page-products",
+      }],
+    } as Experiment;
+    install({ experiments: [scoped] });
+    document.querySelector("a.buy")!.dispatchEvent(new MouseEvent("click", { bubbles: true }));
+    expect(JSON.parse(localStorage.getItem(EARLY_INTERACTION_STORAGE_KEY)!)).toHaveLength(1);
+
+    clearEarlyInteractions();
+    install({ experiments: [scoped], pageUrl: "https://shop.test/collections/sale" });
+    document.querySelector("a.buy")!.dispatchEvent(new MouseEvent("click", { bubbles: true }));
+    expect(JSON.parse(localStorage.getItem(EARLY_INTERACTION_STORAGE_KEY)!)).toEqual([]);
+  });
+
+  it("builds normalized targeting attributes for scoped early clicks", () => {
+    const goalOnly = { ...experiment, targeting: { pageRules: [{ id: "page-products", includeRules: [{ type: "simple", pattern: "/products/*" }] }] }, goalPageRules: [{ id: "page-cart", includeRules: [{ type: "simple", pattern: "/cart" }] }], goals: [{ id: "goal-1", type: "click", selector: ".buy", pageId: "page-cart" }] } as Experiment;
+    install({ experiments: [goalOnly], pageUrl: "https://shop.test/cart" });
+    document.querySelector("a.buy")!.dispatchEvent(new MouseEvent("click", { bubbles: true }));
+    expect(JSON.parse(localStorage.getItem(EARLY_INTERACTION_STORAGE_KEY)!)).toHaveLength(1);
+    clearEarlyInteractions();
+
+    const scoped = {
+      ...experiment,
+      targeting: {
+        pageRules: [{
+          id: "page-mobile",
+          includeRules: [{ type: "simple", pattern: "shop.test/products/*" }],
+          advancedCondition: {
+            code: 'return attributes["device.type"] === "mobile";',
+          },
+        }],
+      },
+      goals: [{
+        id: "goal-1",
+        type: "click",
+        selector: ".buy",
+        pageId: "page-mobile",
+      }],
+    } as Experiment;
+    install({ experiments: [scoped], attributes: { device: "Mobile" } });
+
+    document.querySelector("a.buy")!.dispatchEvent(new MouseEvent("click", { bubbles: true }));
+
+    expect(JSON.parse(localStorage.getItem(EARLY_INTERACTION_STORAGE_KEY)!)).toHaveLength(1);
+  });
+
+  it("honors urlPattern for an unscoped fallback click goal", () => {
+    const urlScoped = {
+      ...experiment,
+      goals: [{
+        id: "goal-1",
+        type: "click",
+        selector: ".buy",
+        urlPattern: "/products/",
+      }],
+    } as Experiment;
+    install({ experiments: [urlScoped], pageUrl: "https://shop.test/collections/sale" });
+    document.querySelector("a.buy")!.dispatchEvent(new MouseEvent("click", { bubbles: true }));
+    expect(JSON.parse(localStorage.getItem(EARLY_INTERACTION_STORAGE_KEY)!)).toEqual([]);
+  });
+
+  it.each([
+    ["expired TTL", { timestamp: Date.now() - EARLY_INTERACTION_TTL_MS - 1 }],
+    ["future timestamp", { timestamp: Date.now() + 10_000 }],
+    ["session mismatch", { sessionId: "other-session" }],
+    ["config mismatch", { configRevision: 8 }],
+  ])("discards %s entries", (_name, patch) => {
+    const entry: EarlyInteractionEntry = {
+      goalId: "goal-1", experimentId: "exp-1", variationId: "var-1", assignmentEpoch: 3, kind: "click", data: {}, timestamp: Date.now(),
+      sessionId: "session-1", pageUrl: "https://shop.test/previous", configRevision: 7, ...patch,
+    };
+    localStorage.setItem(EARLY_INTERACTION_STORAGE_KEY, JSON.stringify([entry]));
+    const consume = vi.fn();
+    drainEarlyInteractions({ experiments: [experiment], configRevision: 7, sessionId: "session-1", consume });
+    expect(consume).not.toHaveBeenCalled();
+  });
+
+  it("clears queued memory and persistence on consent withdrawal", () => {
+    globalThis.__dripHasConsent = true;
+    install({ requireConsent: true });
+    document.querySelector(".buy")!.dispatchEvent(new MouseEvent("click", { bubbles: true }));
+    globalThis.__dripHasConsent = false;
+    window.dispatchEvent(new Event("CookiebotOnDecline"));
+    expect(globalThis.__dripEarlyInteractions?.entries).toEqual([]);
+    expect(localStorage.getItem(EARLY_INTERACTION_STORAGE_KEY)).toBeNull();
+  });
+
+  it("installs no listeners and clears the queue for an opted-out visitor", () => {
+    localStorage.setItem("drip_optout", "1");
+    localStorage.setItem(EARLY_INTERACTION_STORAGE_KEY, "[{}]");
+    install();
+    document.querySelector("a.buy")!.dispatchEvent(new MouseEvent("click", { bubbles: true }));
+    expect(globalThis.__dripEarlyInteractions).toBeUndefined();
+    expect(localStorage.getItem(EARLY_INTERACTION_STORAGE_KEY)).toBeNull();
+  });
+
+  it("preserves a prior queue while consent is unknown and arms after native consent arrives", () => {
+    const prior = { goalId: "goal-1", experimentId: "exp-1", variationId: "var-1", assignmentEpoch: 3, kind: "click", data: {}, timestamp: Date.now(), sessionId: "sid", pageUrl: "https://shop.test/pdp", configRevision: 7 };
+    localStorage.setItem(EARLY_INTERACTION_STORAGE_KEY, JSON.stringify([prior]));
+    install({ requireConsent: true, consentModeEnabled: true, consentProvider: "custom", consentGetter: "missingConsent.value" });
+    expect(JSON.parse(localStorage.getItem(EARLY_INTERACTION_STORAGE_KEY)!)).toEqual([prior]);
+    (globalThis as any).missingConsent = { value: true };
+    window.dispatchEvent(new Event("OneTrustGroupsUpdated"));
+    document.querySelector("a.buy")!.dispatchEvent(new MouseEvent("click", { bubbles: true }));
+    expect(JSON.parse(localStorage.getItem(EARLY_INTERACTION_STORAGE_KEY)!)).toHaveLength(2);
+  });
+
+  it("uses native CMP consent synchronously on the first visit", () => {
+    (globalThis as any).Cookiebot = { consent: { statistics: true } };
+    install({ requireConsent: true, consentModeEnabled: true, consentProvider: "cookiebot", consentRequiredGroup: "statistics" });
+    document.querySelector("a.buy")!.dispatchEvent(new MouseEvent("click", { bubbles: true }));
+    expect(JSON.parse(localStorage.getItem(EARLY_INTERACTION_STORAGE_KEY)!)).toHaveLength(1);
+  });
+
+  it("refuses and clears a drain after explicit consent denial", () => {
+    install();
+    document.querySelector("a.buy")!.dispatchEvent(new MouseEvent("click", { bubbles: true }));
+    globalThis.__dripHasConsent = false;
+    const consume = vi.fn();
+    drainEarlyInteractions({ experiments: [experiment], configRevision: 7, sessionId: sessionStorage.getItem("drip_sid")!, requireConsent: true, consume });
+    expect(consume).not.toHaveBeenCalled();
+    expect(localStorage.getItem(EARLY_INTERACTION_STORAGE_KEY)).toBeNull();
+  });
+
+  it("stamps and drains the originating assignment without a destination assignment", () => {
+    install();
+    document.querySelector("a.buy")!.dispatchEvent(new MouseEvent("click", { bubbles: true }));
+    const consume = vi.fn();
+    drainEarlyInteractions({ experiments: [experiment], configRevision: 7, sessionId: sessionStorage.getItem("drip_sid")!, consume });
+    expect(consume).toHaveBeenCalledWith(expect.objectContaining({ experimentId: "exp-1", variationId: "var-1", assignmentEpoch: 3, pageUrl: "https://shop.test/products/one" }));
+  });
+
+  it("does not capture selector matches for an unassigned experiment", () => {
+    install({ assignments: [] });
+    document.querySelector("a.buy")!.dispatchEvent(new MouseEvent("click", { bubbles: true }));
+    expect(JSON.parse(localStorage.getItem(EARLY_INTERACTION_STORAGE_KEY)!)).toEqual([]);
+  });
+
+  it("keeps excluded weekdays dark during early capture and drain", () => {
+    vi.useFakeTimers();
+    vi.setSystemTime(new Date(RECENT_MONDAY_NOON));
+    const scheduled = {
+      ...experiment,
+      weekdaySchedule: { excludedDays: ["monday"], timezone: "UTC" },
+    } as Experiment;
+    const monday = Date.now();
+    install({ experiments: [scheduled], now: monday });
+    document.querySelector("a.buy")!.dispatchEvent(new MouseEvent("click", { bubbles: true }));
+    expect(JSON.parse(localStorage.getItem(EARLY_INTERACTION_STORAGE_KEY)!)).toEqual([]);
+
+    clearEarlyInteractions();
+    install({ experiments: [scheduled], now: monday, forcedExperimentIds: ["exp-1"] });
+    document.querySelector("a.buy")!.dispatchEvent(new MouseEvent("click", { bubbles: true }));
+    const sessionId = sessionStorage.getItem("drip_sid")!;
+    const queued = localStorage.getItem(EARLY_INTERACTION_STORAGE_KEY)!;
+    expect(JSON.parse(queued)).toHaveLength(1);
+
+    const consume = vi.fn();
+    drainEarlyInteractions({
+      experiments: [scheduled],
+      configRevision: 7,
+      sessionId,
+      now: monday,
+      consume,
+    });
+    expect(consume).not.toHaveBeenCalled();
+
+    localStorage.setItem(EARLY_INTERACTION_STORAGE_KEY, queued);
+    drainEarlyInteractions({
+      experiments: [scheduled],
+      configRevision: 7,
+      sessionId,
+      now: monday,
+      forcedExperimentIds: ["exp-1"],
+      consume,
+    });
+    expect(consume).toHaveBeenCalledTimes(1);
+  });
+
+  it("deduplicates paired click and submit events for one form action", () => {
+    document.body.innerHTML = '<form class="buy"><button class="buy" type="submit">Buy</button></form>';
+    install();
+    document.querySelector("button")!.dispatchEvent(new MouseEvent("click", { bubbles: true }));
+    document.querySelector("form")!.dispatchEvent(new Event("submit", { bubbles: true, cancelable: true }));
+    expect(JSON.parse(localStorage.getItem(EARLY_INTERACTION_STORAGE_KEY)!)).toHaveLength(1);
+  });
+
+  it("does not deduplicate persisted click and submit events from different forms", () => {
+    document.body.innerHTML = '<form id="one"><button class="buy" type="submit">One</button></form><form id="two" class="buy"></form>';
+    install();
+    document.querySelector("button")!.dispatchEvent(new MouseEvent("click", { bubbles: true }));
+    document.querySelector("#two")!.dispatchEvent(new Event("submit", { bubbles: true, cancelable: true }));
+    expect(JSON.parse(localStorage.getItem(EARLY_INTERACTION_STORAGE_KEY)!)).toHaveLength(2);
+  });
+
+  it("captures explicit submit goals", () => {
+    const submitExperiment = { ...experiment, goals: [{ id: "submit-goal", type: "submit", selector: "form.buy" }] } as Experiment;
+    install({ experiments: [submitExperiment] });
+    document.querySelector("form")!.dispatchEvent(new Event("submit", { bubbles: true, cancelable: true }));
+    expect(JSON.parse(localStorage.getItem(EARLY_INTERACTION_STORAGE_KEY)!)).toMatchObject([{ goalId: "submit-goal", kind: "submit" }]);
+  });
+
+  it("shares the tracker's session identity for cookie queue storage", () => {
+    sessionStorage.setItem("drip_sid", "tracker-cookie-session");
+    install({ storageMode: "cookie" });
+    document.querySelector("a.buy")!.dispatchEvent(new MouseEvent("click", { bubbles: true }));
+    expect(decodeURIComponent(document.cookie)).toContain('"sessionId":"tracker-cookie-session"');
+  });
+
+});