@runbandit/sdk 3.1.2 → 3.3.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) {
@@ -898,54 +916,6 @@ 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();
-  }
-  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 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 getOrCreateVisitorId(storage) {
-  if (!storage) return generateId();
-  try {
-    const stored = storage.getItem(VISITOR_ID_KEY);
-    if (stored) return stored;
-    const id = generateId();
-    storage.setItem(VISITOR_ID_KEY, id);
-    return id;
-  } catch {
-    return generateId();
-  }
-}
-function defaultSessionStorage() {
-  return typeof window !== "undefined" && window.localStorage ? window.localStorage : null;
-}
-
 // src/client.ts
 var BanditsRequestError = class extends Error {
   status;
@@ -979,7 +949,7 @@ var BanditsClient = class {
       ...config
     };
     this.sessionId = this.getOrCreateSessionId();
-    this.visitorId = getOrCreateVisitorId(defaultSessionStorage());
+    this.visitorId = config.visitorId ?? getOrCreateVisitorId(defaultSessionStorage());
     this.startBatchFlush();
   }
   async getAssignment(experimentId, userId = this.visitorId, context) {
@@ -1198,206 +1168,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";
@@ -1596,6 +1366,7 @@ export {
   BanditsRequestError,
   CONTENT_TYPE_BY_KIND,
   ContentType,
+  DECISIONS_COOKIE,
   DEFAULT_HALF_LIFE_MS,
   DEFAULT_SESSION_TTL_MS,
   DEFAULT_WINDOW_MS,
@@ -1626,6 +1397,7 @@ export {
   STOREFRONT_KINDS,
   SUGGESTED_SITE_EXPERIMENTS,
   SnapshotClient,
+  VISITOR_COOKIE,
   VISITOR_ID_KEY,
   appendEmailToken,
   buildSubdomainUrl,
@@ -1658,6 +1430,7 @@ export {
   normalizeSiteTarget,
   normalizeTreatmentWeights,
   parseAlternative,
+  parseDecisions,
   parsePanelMessage,
   parsePickerMessage,
   parseSiteContent,
@@ -1667,6 +1440,7 @@ export {
   pickStep,
   pickTreatment,
   platformById,
+  readCookie,
   renderEmail,
   renderEmailDocument,
   renderFromPlan,
@@ -1675,6 +1449,7 @@ export {
   rewriteEmailLinks,
   sampleCombination,
   sanitizeMetadata,
+  serializeDecisions,
   serializeTreatmentConfig,
   shouldRefreshPlan,
   targetMatchesPage,