@sessionsight/split-testing 1.0.0 → 1.0.1

package/dist/cache.d.ts

@@ -0,0 +1,11 @@
+import type { SplitTestConfigResponse, Assignment } from './types.js';
+export { getOrCreateVisitorId } from '@sessionsight/sdk-shared';
+interface CachedConfig {
+    data: SplitTestConfigResponse;
+    fetchedAt: number;
+}
+export declare function getCachedConfig(propertyId: string): CachedConfig | null;
+export declare function setCachedConfig(propertyId: string, data: SplitTestConfigResponse): void;
+export declare function getCachedAssignments(propertyId: string, visitorId: string): Record<string, Assignment> | null;
+export declare function setCachedAssignments(propertyId: string, visitorId: string, assignments: Record<string, Assignment>): void;
+export declare function clearCache(propertyId: string): void;

package/dist/client.d.ts

@@ -0,0 +1,40 @@
+import type { SplitTestConfig, GetOptions } from './types.js';
+export declare class SplitTestingClient {
+    private apiUrl;
+    private publicApiKey;
+    private propertyId;
+    private visitorId;
+    private attributes;
+    private bootstrap;
+    private antiFlicker;
+    private staleTTL;
+    private maxAge;
+    private onAssignment;
+    private config;
+    private assignments;
+    private initialized;
+    private antiFlickerStyle;
+    private flushTimer;
+    private pendingExposures;
+    constructor(config: SplitTestConfig);
+    init(): Promise<void>;
+    get(testKey: string, defaultValue: any, _options?: GetOptions): any;
+    trackConversion(goalId: string, options?: {
+        value?: number;
+        currency?: string;
+    }): void;
+    setAttributes(attrs: Record<string, string | number | boolean>): void;
+    getAssignments(): Record<string, number>;
+    refresh(): Promise<void>;
+    clearCache(): void;
+    destroy(): void;
+    private evaluateFromBootstrap;
+    private evaluateAssignments;
+    private fetchConfig;
+    private fetchConfigInBackground;
+    private trackExposure;
+    private flushExposures;
+    private sendBeacon;
+    private injectAntiFlicker;
+    private removeAntiFlicker;
+}

package/dist/hash.d.ts

@@ -0,0 +1,16 @@
+/**
+ * djb2 hash producing 0-9999 for fine-grained traffic allocation.
+ * Same algorithm family as the flag-evaluation service.
+ */
+export declare function splitTestHash(seed: string, visitorId: string): number;
+/**
+ * Given a hash bucket, traffic allocation, and variation weights,
+ * determine which variation the visitor gets.
+ */
+export declare function assignVariation(hashValue: number, trafficAllocation: number, variations: Array<{
+    key: string;
+    weight: number;
+}>): {
+    variationIndex: number;
+    inTest: boolean;
+};

package/dist/hash.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/iife.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/index.d.ts

@@ -0,0 +1,18 @@
+import { SplitTestingClient } from './client.js';
+import type { SplitTestConfig, GetOptions } from './types.js';
+export { SplitTestingClient };
+export type { SplitTestConfig, GetOptions, AssignedVariation, Assignment, SplitTestConfigResponse } from './types.js';
+declare const SplitTesting: {
+    init(config: SplitTestConfig): Promise<void>;
+    get(testKey: string, defaultValue: any, options?: GetOptions): any;
+    trackConversion(goalId: string, options?: {
+        value?: number;
+        currency?: string;
+    }): void;
+    setAttributes(attrs: Record<string, string | number | boolean>): void;
+    getAssignments(): Record<string, number>;
+    refresh(): Promise<void>;
+    clearCache(): void;
+    destroy(): void;
+};
+export default SplitTesting;

package/dist/index.js

@@ -0,0 +1,535 @@
+// src/hash.ts
+function splitTestHash(seed, visitorId) {
+  const str = `${seed}:${visitorId}`;
+  let hash = 5381;
+  for (let i = 0;i < str.length; i++) {
+    hash = (hash << 5) + hash + str.charCodeAt(i) >>> 0;
+  }
+  return hash % 1e4;
+}
+function assignVariation(hashValue, trafficAllocation, variations) {
+  const trafficThreshold = trafficAllocation * 100;
+  if (hashValue >= trafficThreshold) {
+    return { variationIndex: 0, inTest: false };
+  }
+  const totalWeight = variations.reduce((s, v) => s + v.weight, 0);
+  if (totalWeight === 0)
+    return { variationIndex: 0, inTest: true };
+  let cumulative = 0;
+  for (let i = 0;i < variations.length; i++) {
+    cumulative += variations[i].weight / totalWeight * trafficThreshold;
+    if (hashValue < cumulative) {
+      return { variationIndex: i, inTest: true };
+    }
+  }
+  return { variationIndex: variations.length - 1, inTest: true };
+}
+
+// ../sdk-shared/src/index.ts
+var DEFAULT_API_URL = "https://api.sessionsight.com";
+function normalizeApiUrl(url) {
+  const normalized = (url || DEFAULT_API_URL).replace(/\/$/, "");
+  if (normalized.startsWith("http://") && !normalized.startsWith("http://localhost")) {
+    console.warn("SessionSight: API URL uses http:// instead of https://. Data will be transmitted unencrypted.");
+  }
+  return normalized;
+}
+var VISITOR_STORAGE_KEY = "sessionsight_visitor_id";
+var VISITOR_COOKIE_NAME = "ss_vid";
+var VISITOR_COOKIE_MAX_AGE = 365 * 24 * 60 * 60;
+function readCookie(name) {
+  if (typeof document === "undefined")
+    return null;
+  try {
+    const escaped = name.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+    const match = document.cookie.match(new RegExp("(?:^|; )" + escaped + "=([^;]*)"));
+    return match ? decodeURIComponent(match[1]) : null;
+  } catch {
+    return null;
+  }
+}
+function setCookie(name, value, maxAge) {
+  if (typeof document === "undefined")
+    return;
+  try {
+    const secure = location.protocol === "https:" ? "; Secure" : "";
+    document.cookie = `${name}=${value}; path=/; max-age=${maxAge}; SameSite=Lax${secure}`;
+  } catch {}
+}
+function generateUUID() {
+  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);
+  });
+}
+var UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+function isValidUUID(id) {
+  return UUID_RE.test(id);
+}
+function hasLocalStorage() {
+  try {
+    const key = "__ss_test__";
+    localStorage.setItem(key, "1");
+    localStorage.removeItem(key);
+    return true;
+  } catch {
+    return false;
+  }
+}
+function shouldSuppressPersistentId() {
+  if (typeof navigator !== "undefined") {
+    if (navigator.globalPrivacyControl === true)
+      return true;
+    if (navigator.doNotTrack === "1")
+      return true;
+  }
+  return false;
+}
+function getOrCreateVisitorId(providedId) {
+  if (providedId)
+    return providedId;
+  if (shouldSuppressPersistentId()) {
+    return generateUUID();
+  }
+  const canStore = typeof window !== "undefined" && hasLocalStorage();
+  const cookieId = readCookie(VISITOR_COOKIE_NAME);
+  if (cookieId && isValidUUID(cookieId)) {
+    if (canStore)
+      localStorage.setItem(VISITOR_STORAGE_KEY, cookieId);
+    return cookieId;
+  }
+  if (canStore) {
+    const stored = localStorage.getItem(VISITOR_STORAGE_KEY);
+    if (stored && isValidUUID(stored)) {
+      setCookie(VISITOR_COOKIE_NAME, stored, VISITOR_COOKIE_MAX_AGE);
+      return stored;
+    }
+  }
+  const id = generateUUID();
+  if (canStore)
+    localStorage.setItem(VISITOR_STORAGE_KEY, id);
+  setCookie(VISITOR_COOKIE_NAME, id, VISITOR_COOKIE_MAX_AGE);
+  return id;
+}
+var registry = new Map;
+
+// src/cache.ts
+var CONFIG_PREFIX = "ss-split-config:";
+var ASSIGNMENTS_PREFIX = "ss-split-assignments:";
+function hasLocalStorage2() {
+  try {
+    const key = "__ss_test__";
+    localStorage.setItem(key, "1");
+    localStorage.removeItem(key);
+    return true;
+  } catch {
+    return false;
+  }
+}
+var canUseStorage = typeof window !== "undefined" && hasLocalStorage2();
+function getCachedConfig(propertyId) {
+  if (!canUseStorage)
+    return null;
+  try {
+    const raw = localStorage.getItem(CONFIG_PREFIX + propertyId);
+    if (!raw)
+      return null;
+    return JSON.parse(raw);
+  } catch {
+    return null;
+  }
+}
+function setCachedConfig(propertyId, data) {
+  if (!canUseStorage)
+    return;
+  try {
+    const cached = { data, fetchedAt: Date.now() };
+    localStorage.setItem(CONFIG_PREFIX + propertyId, JSON.stringify(cached));
+  } catch {}
+}
+function getCachedAssignments(propertyId, visitorId) {
+  if (!canUseStorage)
+    return null;
+  try {
+    const raw = localStorage.getItem(ASSIGNMENTS_PREFIX + propertyId + ":" + visitorId);
+    if (!raw)
+      return null;
+    return JSON.parse(raw);
+  } catch {
+    return null;
+  }
+}
+function setCachedAssignments(propertyId, visitorId, assignments) {
+  if (!canUseStorage)
+    return;
+  try {
+    localStorage.setItem(ASSIGNMENTS_PREFIX + propertyId + ":" + visitorId, JSON.stringify(assignments));
+  } catch {}
+}
+function clearCache(propertyId) {
+  if (!canUseStorage)
+    return;
+  try {
+    const keysToRemove = [];
+    for (let i = 0;i < localStorage.length; i++) {
+      const key = localStorage.key(i);
+      if (key && (key.startsWith(CONFIG_PREFIX + propertyId) || key.startsWith(ASSIGNMENTS_PREFIX + propertyId))) {
+        keysToRemove.push(key);
+      }
+    }
+    keysToRemove.forEach((k) => localStorage.removeItem(k));
+  } catch {}
+}
+
+// src/client.ts
+var FETCH_TIMEOUT_MS = 1e4;
+function fetchWithTimeout(url, options) {
+  const controller = new AbortController;
+  const timer = setTimeout(() => controller.abort(), FETCH_TIMEOUT_MS);
+  return fetch(url, { ...options, signal: controller.signal }).finally(() => clearTimeout(timer));
+}
+var DEFAULT_STALE_TTL = 0;
+var DEFAULT_MAX_AGE = 86400000;
+
+class SplitTestingClient {
+  apiUrl;
+  publicApiKey;
+  propertyId;
+  visitorId;
+  attributes;
+  bootstrap;
+  antiFlicker;
+  staleTTL;
+  maxAge;
+  onAssignment;
+  config = null;
+  assignments = {};
+  initialized = false;
+  antiFlickerStyle = null;
+  flushTimer = null;
+  pendingExposures = [];
+  constructor(config) {
+    this.publicApiKey = config.publicApiKey;
+    this.propertyId = config.propertyId;
+    this.apiUrl = normalizeApiUrl(config.apiUrl || "");
+    this.visitorId = getOrCreateVisitorId(config.visitorId);
+    this.attributes = config.attributes || {};
+    this.bootstrap = config.bootstrap || null;
+    this.antiFlicker = config.antiFlicker || false;
+    this.staleTTL = config.staleTTL ?? DEFAULT_STALE_TTL;
+    this.maxAge = config.maxAge ?? DEFAULT_MAX_AGE;
+    this.onAssignment = config.onAssignment || null;
+  }
+  async init() {
+    if (this.antiFlicker && typeof document !== "undefined") {
+      this.injectAntiFlicker();
+    }
+    try {
+      if (this.bootstrap) {
+        const cached = getCachedConfig(this.propertyId);
+        if (cached) {
+          this.config = cached.data;
+          this.evaluateFromBootstrap();
+          this.initialized = true;
+          this.fetchConfigInBackground();
+          return;
+        }
+        await this.fetchConfig();
+        this.evaluateFromBootstrap();
+        this.initialized = true;
+        return;
+      }
+      const cachedAssignments = getCachedAssignments(this.propertyId, this.visitorId);
+      if (cachedAssignments) {
+        this.assignments = cachedAssignments;
+      }
+      const cachedConfig = getCachedConfig(this.propertyId);
+      const now = Date.now();
+      if (cachedConfig) {
+        const age = now - cachedConfig.fetchedAt;
+        if (age < this.maxAge) {
+          this.config = cachedConfig.data;
+          this.evaluateAssignments();
+          this.initialized = true;
+          if (age >= this.staleTTL) {
+            this.fetchConfigInBackground();
+          }
+          return;
+        }
+      }
+      await this.fetchConfig();
+      this.evaluateAssignments();
+      this.initialized = true;
+    } finally {
+      this.removeAntiFlicker();
+    }
+  }
+  get(testKey, defaultValue, _options) {
+    if (!this.initialized) {
+      console.warn("[SessionSight SplitTesting] Not initialized. Call init() first.");
+      return defaultValue;
+    }
+    const assignment = this.assignments[testKey];
+    if (!assignment)
+      return defaultValue;
+    if (assignment.inTest) {
+      this.trackExposure(testKey, assignment.variationKey);
+    }
+    switch (assignment.type) {
+      case "id":
+        return assignment.variationKey;
+      case "text":
+        return assignment.value || defaultValue;
+      case "json":
+        try {
+          return JSON.parse(assignment.value);
+        } catch {
+          return defaultValue;
+        }
+      default:
+        return defaultValue;
+    }
+  }
+  trackConversion(goalId, options) {
+    if (!this.initialized)
+      return;
+    const body = {
+      propertyId: this.propertyId,
+      visitorId: this.visitorId,
+      goalId,
+      ...options?.value != null ? { value: options.value } : {},
+      ...options?.currency ? { currency: options.currency } : {}
+    };
+    this.sendBeacon(`${this.apiUrl}/v1/split-testing/convert`, body);
+  }
+  setAttributes(attrs) {
+    Object.assign(this.attributes, attrs);
+  }
+  getAssignments() {
+    const result = {};
+    for (const [key, assignment] of Object.entries(this.assignments)) {
+      result[key] = assignment.variationIndex;
+    }
+    return result;
+  }
+  async refresh() {
+    await this.fetchConfig();
+    this.evaluateAssignments();
+  }
+  clearCache() {
+    clearCache(this.propertyId);
+  }
+  destroy() {
+    if (this.flushTimer) {
+      clearTimeout(this.flushTimer);
+      this.flushTimer = null;
+    }
+    this.flushExposures();
+    this.removeAntiFlicker();
+    this.config = null;
+    this.assignments = {};
+    this.initialized = false;
+    this.pendingExposures = [];
+  }
+  evaluateFromBootstrap() {
+    if (!this.config || !this.bootstrap)
+      return;
+    for (const test of this.config.tests) {
+      const variationIndex = this.bootstrap[test.key];
+      if (variationIndex === undefined)
+        continue;
+      const variation = test.variations[variationIndex];
+      if (!variation)
+        continue;
+      this.assignments[test.key] = {
+        testKey: test.key,
+        variationIndex,
+        variationKey: variation.key,
+        value: variation.value,
+        type: test.type,
+        inTest: true
+      };
+      if (this.onAssignment) {
+        this.onAssignment(test.key, { key: variation.key, value: variation.value });
+      }
+    }
+    setCachedAssignments(this.propertyId, this.visitorId, this.assignments);
+  }
+  evaluateAssignments() {
+    if (!this.config)
+      return;
+    for (const test of this.config.tests) {
+      const hash = splitTestHash(test.hashSeed, this.visitorId);
+      const result = assignVariation(hash, test.trafficAllocation, test.variations);
+      const variation = test.variations[result.variationIndex];
+      if (!variation)
+        continue;
+      this.assignments[test.key] = {
+        testKey: test.key,
+        variationIndex: result.variationIndex,
+        variationKey: variation.key,
+        value: variation.value,
+        type: test.type,
+        inTest: result.inTest
+      };
+      if (this.onAssignment) {
+        this.onAssignment(test.key, { key: variation.key, value: variation.value });
+      }
+    }
+    setCachedAssignments(this.propertyId, this.visitorId, this.assignments);
+  }
+  async fetchConfig() {
+    try {
+      const url = `${this.apiUrl}/v1/split-testing/config?propertyId=${encodeURIComponent(this.propertyId)}`;
+      const res = await fetchWithTimeout(url, {
+        headers: { "x-api-key": this.publicApiKey }
+      });
+      if (!res.ok) {
+        console.warn(`[SessionSight SplitTesting] Failed to fetch config: ${res.status}`);
+        return;
+      }
+      const data = await res.json();
+      if (!data || !Array.isArray(data.tests)) {
+        console.warn("[SessionSight SplitTesting] Invalid config response");
+        return;
+      }
+      this.config = data;
+      setCachedConfig(this.propertyId, data);
+    } catch (err) {
+      console.warn("[SessionSight SplitTesting] Failed to fetch config:", err);
+    }
+  }
+  fetchConfigInBackground() {
+    this.fetchConfig().then(() => {
+      if (this.config) {
+        this.evaluateAssignments();
+      }
+    });
+  }
+  trackExposure(testKey, variationKey) {
+    if (this.pendingExposures.some((e) => e.splitTestKey === testKey))
+      return;
+    this.pendingExposures.push({
+      splitTestKey: testKey,
+      variationKey,
+      visitorId: this.visitorId,
+      timestamp: Date.now(),
+      attributes: this.attributes
+    });
+    if (this.pendingExposures.length === 1) {
+      this.flushTimer = setTimeout(() => this.flushExposures(), 1000);
+    }
+  }
+  flushExposures() {
+    if (this.pendingExposures.length === 0)
+      return;
+    const exposures = [...this.pendingExposures];
+    this.pendingExposures = [];
+    const body = {
+      propertyId: this.propertyId,
+      exposures
+    };
+    this.sendBeacon(`${this.apiUrl}/v1/split-testing/expose`, body);
+  }
+  sendBeacon(url, body) {
+    const json = JSON.stringify(body);
+    if (typeof navigator !== "undefined" && navigator.sendBeacon) {
+      const blob = new Blob([json], { type: "application/json" });
+      if (navigator.sendBeacon(url, blob))
+        return;
+    }
+    fetch(url, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        "x-api-key": this.publicApiKey
+      },
+      body: json,
+      keepalive: true
+    }).catch(() => {});
+  }
+  injectAntiFlicker() {
+    if (typeof document === "undefined")
+      return;
+    const style = document.createElement("style");
+    style.id = "ss-split-anti-flicker";
+    style.textContent = "[data-ss-split]{visibility:hidden!important}";
+    document.head.appendChild(style);
+    this.antiFlickerStyle = style;
+  }
+  removeAntiFlicker() {
+    if (this.antiFlickerStyle) {
+      this.antiFlickerStyle.remove();
+      this.antiFlickerStyle = null;
+    }
+  }
+}
+
+// src/index.ts
+var instance = null;
+var SplitTesting = {
+  async init(config) {
+    if (instance) {
+      console.warn("[SessionSight SplitTesting] Already initialized. Call destroy() first.");
+      return;
+    }
+    instance = new SplitTestingClient(config);
+    await instance.init();
+  },
+  get(testKey, defaultValue, options) {
+    if (!instance) {
+      console.warn("[SessionSight SplitTesting] Not initialized. Call init() first.");
+      return defaultValue;
+    }
+    return instance.get(testKey, defaultValue, options);
+  },
+  trackConversion(goalId, options) {
+    if (!instance) {
+      console.warn("[SessionSight SplitTesting] Not initialized. Call init() first.");
+      return;
+    }
+    instance.trackConversion(goalId, options);
+  },
+  setAttributes(attrs) {
+    if (!instance) {
+      console.warn("[SessionSight SplitTesting] Not initialized. Call init() first.");
+      return;
+    }
+    instance.setAttributes(attrs);
+  },
+  getAssignments() {
+    if (!instance) {
+      console.warn("[SessionSight SplitTesting] Not initialized. Call init() first.");
+      return {};
+    }
+    return instance.getAssignments();
+  },
+  async refresh() {
+    if (!instance) {
+      console.warn("[SessionSight SplitTesting] Not initialized. Call init() first.");
+      return;
+    }
+    await instance.refresh();
+  },
+  clearCache() {
+    if (!instance) {
+      console.warn("[SessionSight SplitTesting] Not initialized. Call init() first.");
+      return;
+    }
+    instance.clearCache();
+  },
+  destroy() {
+    if (instance) {
+      instance.destroy();
+      instance = null;
+    }
+  }
+};
+var src_default = SplitTesting;
+export {
+  src_default as default,
+  SplitTestingClient
+};

package/dist/sessionsight-split-testing.js

@@ -0,0 +1 @@
+(()=>{function D(z,w){let q=`${z}:${w}`,J=5381;for(let Z=0;Z<q.length;Z++)J=(J<<5)+J+q.charCodeAt(Z)>>>0;return J%1e4}function N(z,w,q){let J=w*100;if(z>=J)return{variationIndex:0,inTest:!1};let Z=q.reduce(($,U)=>$+U.weight,0);if(Z===0)return{variationIndex:0,inTest:!0};let L=0;for(let $=0;$<q.length;$++)if(L+=q[$].weight/Z*J,z<L)return{variationIndex:$,inTest:!0};return{variationIndex:q.length-1,inTest:!0}}function T(z){let w=(z||"https://api.sessionsight.com").replace(/\/$/,"");if(w.startsWith("http://")&&!w.startsWith("http://localhost"))console.warn("SessionSight: API URL uses http:// instead of https://. Data will be transmitted unencrypted.");return w}var S="sessionsight_visitor_id",j="ss_vid",C=31536000;function m(z){if(typeof document>"u")return null;try{let w=z.replace(/[.*+?^${}()|[\]\\]/g,"\\$&"),q=document.cookie.match(new RegExp("(?:^|; )"+w+"=([^;]*)"));return q?decodeURIComponent(q[1]):null}catch{return null}}function G(z,w,q){if(typeof document>"u")return;try{let J=location.protocol==="https:"?"; Secure":"";document.cookie=`${z}=${w}; path=/; max-age=${q}; SameSite=Lax${J}`}catch{}}function X(){if(typeof crypto<"u"&&crypto.randomUUID)return crypto.randomUUID();return"xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g,(z)=>{let w=Math.random()*16|0;return(z==="x"?w:w&3|8).toString(16)})}var A=/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;function M(z){return A.test(z)}function O(){try{return localStorage.setItem("__ss_test__","1"),localStorage.removeItem("__ss_test__"),!0}catch{return!1}}function k(){if(typeof navigator<"u"){if(navigator.globalPrivacyControl===!0)return!0;if(navigator.doNotTrack==="1")return!0}return!1}function H(z){if(z)return z;if(k())return X();let w=typeof window<"u"&&O(),q=m(j);if(q&&M(q)){if(w)localStorage.setItem(S,q);return q}if(w){let Z=localStorage.getItem(S);if(Z&&M(Z))return G(j,Z,C),Z}let J=X();if(w)localStorage.setItem(S,J);return G(j,J,C),J}var W="ss-split-config:",Y="ss-split-assignments:";function n(){try{return localStorage.setItem("__ss_test__","1"),localStorage.removeItem("__ss_test__"),!0}catch{return!1}}var B=typeof window<"u"&&n();function b(z){if(!B)return null;try{let w=localStorage.getItem(W+z);if(!w)return null;return JSON.parse(w)}catch{return null}}function F(z,w){if(!B)return;try{let q={data:w,fetchedAt:Date.now()};localStorage.setItem(W+z,JSON.stringify(q))}catch{}}function p(z,w){if(!B)return null;try{let q=localStorage.getItem(Y+z+":"+w);if(!q)return null;return JSON.parse(q)}catch{return null}}function x(z,w,q){if(!B)return;try{localStorage.setItem(Y+z+":"+w,JSON.stringify(q))}catch{}}function K(z){if(!B)return;try{let w=[];for(let q=0;q<localStorage.length;q++){let J=localStorage.key(q);if(J&&(J.startsWith(W+z)||J.startsWith(Y+z)))w.push(J)}w.forEach((q)=>localStorage.removeItem(q))}catch{}}var V=1e4;function f(z,w){let q=new AbortController,J=setTimeout(()=>q.abort(),V);return fetch(z,{...w,signal:q.signal}).finally(()=>clearTimeout(J))}var l=0,g=86400000;class P{apiUrl;publicApiKey;propertyId;visitorId;attributes;bootstrap;antiFlicker;staleTTL;maxAge;onAssignment;config=null;assignments={};initialized=!1;antiFlickerStyle=null;flushTimer=null;pendingExposures=[];constructor(z){this.publicApiKey=z.publicApiKey,this.propertyId=z.propertyId,this.apiUrl=T(z.apiUrl||""),this.visitorId=H(z.visitorId),this.attributes=z.attributes||{},this.bootstrap=z.bootstrap||null,this.antiFlicker=z.antiFlicker||!1,this.staleTTL=z.staleTTL??l,this.maxAge=z.maxAge??g,this.onAssignment=z.onAssignment||null}async init(){if(this.antiFlicker&&typeof document<"u")this.injectAntiFlicker();try{if(this.bootstrap){let J=b(this.propertyId);if(J){this.config=J.data,this.evaluateFromBootstrap(),this.initialized=!0,this.fetchConfigInBackground();return}await this.fetchConfig(),this.evaluateFromBootstrap(),this.initialized=!0;return}let z=p(this.propertyId,this.visitorId);if(z)this.assignments=z;let w=b(this.propertyId),q=Date.now();if(w){let J=q-w.fetchedAt;if(J<this.maxAge){if(this.config=w.data,this.evaluateAssignments(),this.initialized=!0,J>=this.staleTTL)this.fetchConfigInBackground();return}}await this.fetchConfig(),this.evaluateAssignments(),this.initialized=!0}finally{this.removeAntiFlicker()}}get(z,w,q){if(!this.initialized)return console.warn("[SessionSight SplitTesting] Not initialized. Call init() first."),w;let J=this.assignments[z];if(!J)return w;if(J.inTest)this.trackExposure(z,J.variationKey);switch(J.type){case"id":return J.variationKey;case"text":return J.value||w;case"json":try{return JSON.parse(J.value)}catch{return w}default:return w}}trackConversion(z,w){if(!this.initialized)return;let q={propertyId:this.propertyId,visitorId:this.visitorId,goalId:z,...w?.value!=null?{value:w.value}:{},...w?.currency?{currency:w.currency}:{}};this.sendBeacon(`${this.apiUrl}/v1/split-testing/convert`,q)}setAttributes(z){Object.assign(this.attributes,z)}getAssignments(){let z={};for(let[w,q]of Object.entries(this.assignments))z[w]=q.variationIndex;return z}async refresh(){await this.fetchConfig(),this.evaluateAssignments()}clearCache(){K(this.propertyId)}destroy(){if(this.flushTimer)clearTimeout(this.flushTimer),this.flushTimer=null;this.flushExposures(),this.removeAntiFlicker(),this.config=null,this.assignments={},this.initialized=!1,this.pendingExposures=[]}evaluateFromBootstrap(){if(!this.config||!this.bootstrap)return;for(let z of this.config.tests){let w=this.bootstrap[z.key];if(w===void 0)continue;let q=z.variations[w];if(!q)continue;if(this.assignments[z.key]={testKey:z.key,variationIndex:w,variationKey:q.key,value:q.value,type:z.type,inTest:!0},this.onAssignment)this.onAssignment(z.key,{key:q.key,value:q.value})}x(this.propertyId,this.visitorId,this.assignments)}evaluateAssignments(){if(!this.config)return;for(let z of this.config.tests){let w=D(z.hashSeed,this.visitorId),q=N(w,z.trafficAllocation,z.variations),J=z.variations[q.variationIndex];if(!J)continue;if(this.assignments[z.key]={testKey:z.key,variationIndex:q.variationIndex,variationKey:J.key,value:J.value,type:z.type,inTest:q.inTest},this.onAssignment)this.onAssignment(z.key,{key:J.key,value:J.value})}x(this.propertyId,this.visitorId,this.assignments)}async fetchConfig(){try{let z=`${this.apiUrl}/v1/split-testing/config?propertyId=${encodeURIComponent(this.propertyId)}`,w=await f(z,{headers:{"x-api-key":this.publicApiKey}});if(!w.ok){console.warn(`[SessionSight SplitTesting] Failed to fetch config: ${w.status}`);return}let q=await w.json();if(!q||!Array.isArray(q.tests)){console.warn("[SessionSight SplitTesting] Invalid config response");return}this.config=q,F(this.propertyId,q)}catch(z){console.warn("[SessionSight SplitTesting] Failed to fetch config:",z)}}fetchConfigInBackground(){this.fetchConfig().then(()=>{if(this.config)this.evaluateAssignments()})}trackExposure(z,w){if(this.pendingExposures.some((q)=>q.splitTestKey===z))return;if(this.pendingExposures.push({splitTestKey:z,variationKey:w,visitorId:this.visitorId,timestamp:Date.now(),attributes:this.attributes}),this.pendingExposures.length===1)this.flushTimer=setTimeout(()=>this.flushExposures(),1000)}flushExposures(){if(this.pendingExposures.length===0)return;let z=[...this.pendingExposures];this.pendingExposures=[];let w={propertyId:this.propertyId,exposures:z};this.sendBeacon(`${this.apiUrl}/v1/split-testing/expose`,w)}sendBeacon(z,w){let q=JSON.stringify(w);if(typeof navigator<"u"&&navigator.sendBeacon){let J=new Blob([q],{type:"application/json"});if(navigator.sendBeacon(z,J))return}fetch(z,{method:"POST",headers:{"Content-Type":"application/json","x-api-key":this.publicApiKey},body:q,keepalive:!0}).catch(()=>{})}injectAntiFlicker(){if(typeof document>"u")return;let z=document.createElement("style");z.id="ss-split-anti-flicker",z.textContent="[data-ss-split]{visibility:hidden!important}",document.head.appendChild(z),this.antiFlickerStyle=z}removeAntiFlicker(){if(this.antiFlickerStyle)this.antiFlickerStyle.remove(),this.antiFlickerStyle=null}}var Q=null,y={async init(z){if(Q){console.warn("[SessionSight SplitTesting] Already initialized. Call destroy() first.");return}Q=new P(z),await Q.init()},get(z,w,q){if(!Q)return console.warn("[SessionSight SplitTesting] Not initialized. Call init() first."),w;return Q.get(z,w,q)},trackConversion(z,w){if(!Q){console.warn("[SessionSight SplitTesting] Not initialized. Call init() first.");return}Q.trackConversion(z,w)},setAttributes(z){if(!Q){console.warn("[SessionSight SplitTesting] Not initialized. Call init() first.");return}Q.setAttributes(z)},getAssignments(){if(!Q)return console.warn("[SessionSight SplitTesting] Not initialized. Call init() first."),{};return Q.getAssignments()},async refresh(){if(!Q){console.warn("[SessionSight SplitTesting] Not initialized. Call init() first.");return}await Q.refresh()},clearCache(){if(!Q){console.warn("[SessionSight SplitTesting] Not initialized. Call init() first.");return}Q.clearCache()},destroy(){if(Q)Q.destroy(),Q=null}},R=y;window.SessionSightSplitTesting=R;})();

package/dist/types.d.ts

@@ -0,0 +1,44 @@
+export interface SplitTestConfig {
+    publicApiKey: string;
+    propertyId: string;
+    apiUrl?: string;
+    visitorId?: string;
+    attributes?: Record<string, string | number | boolean>;
+    bootstrap?: Record<string, number>;
+    antiFlicker?: boolean;
+    staleTTL?: number;
+    maxAge?: number;
+    onAssignment?: (testKey: string, variation: AssignedVariation) => void;
+}
+export interface AssignedVariation {
+    key: string;
+    value: string;
+}
+export interface SplitTestConfigEntry {
+    key: string;
+    id: string;
+    type: 'id' | 'text' | 'json';
+    status: string;
+    hashSeed: string;
+    trafficAllocation: number;
+    variations: Array<{
+        key: string;
+        weight: number;
+        value: string;
+    }>;
+}
+export interface SplitTestConfigResponse {
+    tests: SplitTestConfigEntry[];
+    ttl: number;
+}
+export interface Assignment {
+    testKey: string;
+    variationIndex: number;
+    variationKey: string;
+    value: string;
+    type: 'id' | 'text' | 'json';
+    inTest: boolean;
+}
+export interface GetOptions {
+    [key: string]: any;
+}