@levi123/experiment 4.0.0-dev.0

package/dist/esm/types/experiments.d.ts

@@ -0,0 +1,82 @@
+import type { IExperimentWrapper } from '../components/experiment-wrapper';
+export interface Variant {
+    name: string;
+    weight?: number;
+    component?: any;
+    metadata?: Record<string, any>;
+}
+export interface ExperimentConfig {
+    experimentId: string;
+    variants: Variant[];
+    weights?: number[];
+    description?: string;
+    targeting?: TargetingConfig;
+    metadata?: Record<string, any>;
+}
+export interface TargetingConfig {
+    trafficPercentage?: number;
+    deviceType?: 'mobile' | 'desktop' | 'tablet';
+    country?: string;
+    userSegment?: string;
+    customRules?: Record<string, any>;
+}
+export interface TrackingEvent {
+    event: string;
+    experimentId: string;
+    variant: string;
+    timestamp: number;
+    sessionId?: string;
+    userId?: string;
+    [key: string]: any;
+}
+export interface ExperimentStatus {
+    experimentId?: string;
+    variant: string | null;
+    isInitialized: boolean;
+    sessionId: string;
+    userId: string;
+    config: ExperimentConfig | null;
+}
+export interface ExperimentWrapperConfigProps {
+    config: ExperimentConfig;
+    selectedVariant?: string;
+    trackingEndpoint?: string;
+    gaTracking?: boolean;
+    autoTrack?: boolean;
+    fallbackVariant?: string;
+    debug?: boolean;
+    loading?: boolean;
+    onTrack?: (event: string, data: TrackingEvent) => void;
+    onVariantAssigned?: (variant: string, experimentId: string) => void;
+    onError?: (error: string, experimentId?: string) => void;
+}
+export interface ExperimentWrapperProps extends ExperimentWrapperConfigProps {
+    children: React.ReactNode;
+}
+export interface ABTestHookResult {
+    variant: string | null;
+    isLoading: boolean;
+    error: Error | null;
+    experimentConfig: ExperimentConfig | null;
+    track: (event: string, data?: Record<string, any>) => void;
+    isVariant: (targetVariant: string) => boolean;
+    reassignVariant: () => void;
+    getStatus: () => ExperimentStatus;
+}
+export interface VariantAssignedEvent extends CustomEvent {
+    detail: {
+        experimentId: string;
+        variant: string;
+        timestamp: number;
+    };
+}
+export interface TrackEvent extends CustomEvent {
+    detail: TrackingEvent;
+}
+export interface ExperimentErrorEvent extends CustomEvent {
+    detail: {
+        error: string;
+        experimentId?: string;
+    };
+}
+export type GxExperimentWrapperElement = IExperimentWrapper;

package/dist/esm/types/index.d.ts

@@ -0,0 +1,2 @@
+export * from './devices';
+export * from './experiments';

package/dist/esm/utils/cookie.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Parse cookie string into key-value pairs
+ */
+export declare const parseCookies: (cookieString?: string) => Record<string, string>;
+/**
+ * Get cookie value (works on both client and server)
+ * @param key - Cookie name
+ * @param cookieString - Optional cookie string from server (e.g., from request headers)
+ */
+export declare const getCookie: (key: string, cookieString?: string) => string | null;
+/**
+ * Set cookie (client-side only)
+ * @param key - Cookie name
+ * @param value - Cookie value
+ * @param days - Number of days until expiration (default: 365)
+ */
+export declare const setCookie: (key: string, value: string, days?: number) => void;
+/**
+ * Remove cookie (client-side only)
+ */
+export declare const removeCookie: (key: string) => void;

package/dist/esm/utils/devices.d.ts

@@ -0,0 +1,2 @@
+import { IDeviceType } from '../types/devices';
+export declare const getDeviceType: (agent?: string) => IDeviceType;

package/dist/esm/utils/experiment-wrapper-helpers.d.ts

@@ -0,0 +1,21 @@
+import type { ExperimentWrapperConfigProps, TrackingEvent } from '../types';
+export interface ExperimentWrapperCallbacks {
+    onTrack?: (event: string, data: TrackingEvent) => void;
+    onVariantAssigned?: (variant: string, experimentId: string) => void;
+    onError?: (error: string, experimentId?: string) => void;
+}
+export interface ExperimentWrapperConfig extends Omit<ExperimentWrapperConfigProps, 'onTrack' | 'onVariantAssigned' | 'onError'> {
+    callbacks?: ExperimentWrapperCallbacks;
+}
+/**
+ * Sets all attributes on the gx-experiment-wrapper element
+ */
+export declare const setExperimentWrapperAttributes: (element: any, config: ExperimentWrapperConfig) => void;
+/**
+ * Sets up event listeners on the gx-experiment-wrapper element
+ */
+export declare const setupExperimentWrapperEventListeners: (element: any, callbacks?: ExperimentWrapperCallbacks) => (() => void);
+/**
+ * Complete setup function that configures both attributes and event listeners
+ */
+export declare const setupExperimentWrapper: (element: any, config: ExperimentWrapperConfig) => (() => void);

package/dist/esm/utils/index.d.ts

@@ -0,0 +1,6 @@
+export * from './cookie';
+export * from './devices';
+export * from './experiment-wrapper-helpers';
+export * from './session';
+export * from './storage';
+export * from './user';

package/dist/esm/utils/session.d.ts

@@ -0,0 +1 @@
+export declare const getOrCreateSessionId: () => string;

package/dist/esm/utils/storage.d.ts

@@ -0,0 +1,3 @@
+export declare const getLocalStorageItem: (key: string) => string | null;
+export declare const setLocalStorageItem: (key: string, value: string) => void;
+export declare const removeLocalStorageItem: (key: string) => void;

package/dist/esm/utils/user.d.ts

@@ -0,0 +1,2 @@
+export declare const getOrCreateUserId: () => string;
+export declare const hashUserId: (userId: string) => number;

package/dist/umd/components/experiment-wrapper.d.ts

@@ -0,0 +1,16 @@
+/**
+ * GxExperimentWrapper - Framework-Agnostic A/B Testing Web Component
+ *
+ * This is a comprehensive Web Component that contains ALL A/B testing logic,
+ * making it truly framework-agnostic. It can be used in React, Vue, Angular,
+ * Svelte, or vanilla JavaScript without any framework-specific dependencies.
+ */
+import type { ExperimentStatus } from '../types';
+export interface IExperimentWrapper extends HTMLElement {
+    getCurrentVariant(): string | null;
+    getExperimentStatus(): ExperimentStatus;
+    reassignVariant(): void;
+    isVariant(targetVariant: string): boolean;
+    trackEvent(event: string, data?: Record<string, any>): void;
+}
+export declare function registerExperimentWebComponent(): void;

package/dist/umd/components/index.d.ts

@@ -0,0 +1 @@
+export * from './experiment-wrapper';

package/dist/umd/constants/index.d.ts

@@ -0,0 +1,12 @@
+import type { ExperimentWrapperProps } from '../types';
+export declare const EXPERIMENT_STORAGE_KEYS: {
+    PREFIX: string;
+    SESSION_ID: string;
+    USER_ID: string;
+};
+export declare const EXPERIMENT_ATTRIBUTES: Record<keyof Omit<ExperimentWrapperProps, 'children'>, string>;
+export declare const EXPERIMENT_EVENTS: {
+    VARIANT_ASSIGNED: string;
+    TRACK: string;
+    ERROR: string;
+};

package/dist/umd/core/ab-testing.d.ts

@@ -0,0 +1,3 @@
+import type { ExperimentConfig } from '../types';
+export declare function getExperimentKey(experimentId: string): string;
+export declare function getVariant(config: ExperimentConfig, cookieString?: string): string;

package/dist/umd/core/index.d.ts

@@ -0,0 +1 @@
+export * from './ab-testing';

package/dist/umd/index.d.ts

@@ -0,0 +1,5 @@
+export * from './components';
+export * from './constants';
+export * from './core';
+export * from './types';
+export * from './utils';

package/dist/umd/index.js

@@ -0,0 +1 @@
+!function(e,t){"object"==typeof exports&&"undefined"!=typeof module?t(exports):"function"==typeof define&&define.amd?define(["exports"],t):t((e="undefined"!=typeof globalThis?globalThis:e||self).ReactFlow={})}(this,function(e){"use strict";const t={PREFIX:"gemx-ab-test:",SESSION_ID:"gemx-ab-session-id",USER_ID:"gemx-ab-user-id"},i={config:"config",trackingEndpoint:"tracking-endpoint",gaTracking:"ga-tracking",autoTrack:"auto-track",fallbackVariant:"fallback-variant",debug:"debug",loading:"loading",onTrack:"on-track",onVariantAssigned:"on-variant-assigned",onError:"on-error",selectedVariant:"selected-variant"},n={VARIANT_ASSIGNED:"variant-assigned",TRACK:"track",ERROR:"error"},r=()=>"undefined"!=typeof window,a=(e="")=>e.split(";").map(e=>e.trim()).filter(Boolean).reduce((e,t)=>{const[i,...n]=t.split("=");return i&&(e[i]=decodeURIComponent(n.join("="))),e},{}),o=(e,t)=>{if(r()){return a(document.cookie)[e]||null}if(t){return a(t)[e]||null}return null},s=(e,t,i=30)=>{if(!r())return;if(o(e))return;const n=new Date;n.setTime(n.getTime()+24*i*60*60*1e3),document.cookie=`${e}=${encodeURIComponent(t)}; expires=${n.toUTCString()}; path=/; SameSite=None; Secure`},l=e=>{r()&&(document.cookie=`${e}=; expires=Thu, 01 Jan 1970 00:00:00 UTC; path=/;`)};function d(e){return`${t.PREFIX}${e}`}function c(e,t){var i,n,r,a,l,c,u,p;const{experimentId:g,variants:m,weights:h}=e;if(!g||!m||0===m.length)return"control";const f=d(g);try{let e=o(f,t);if(!e){let t;t=h&&h.length===m.length?h:m.map(e=>void 0!==e.weight?e.weight:1/m.length);const o=t.reduce((e,t)=>e+t,0),d=Math.random()*o;let u=0;for(let o=0;o<m.length;o++)if(u+=t[o]||0,d<u){e=null!==(a=null!==(n=null===(i=m[o])||void 0===i?void 0:i.name)&&void 0!==n?n:null===(r=m[0])||void 0===r?void 0:r.name)&&void 0!==a?a:"control";break}e||(e=null!==(c=null===(l=m[0])||void 0===l?void 0:l.name)&&void 0!==c?c:"control"),s(f,e)}return e||(null===(u=m[0])||void 0===u?void 0:u.name)||"control"}catch(e){return(null===(p=m[0])||void 0===p?void 0:p.name)||"control"}}var u;e.IDeviceType=void 0,(u=e.IDeviceType||(e.IDeviceType={})).MOBILE="mobile",u.DESKTOP="desktop",u.TABLET="tablet";const p=t=>{const i=null!=t?t:navigator.userAgent;return/tablet|ipad|playbook|silk/i.test(i)?e.IDeviceType.TABLET:/mobile|iphone|ipod|android|blackberry|opera|mini|windows\sce|palm|smartphone|iemobile/i.test(i)?e.IDeviceType.MOBILE:e.IDeviceType.DESKTOP},g=(e,t)=>{var n,r,a,o;if(!e)return;const s=[];s.push([i.config,JSON.stringify(t.config)]),s.push([i.gaTracking,(null!==(n=t.gaTracking)&&void 0!==n&&n).toString()]),s.push([i.autoTrack,(null===(r=t.autoTrack)||void 0===r||r).toString()]),s.push([i.debug,(null!==(a=t.debug)&&void 0!==a&&a).toString()]),s.push([i.loading,(null!==(o=t.loading)&&void 0!==o&&o).toString()]),t.trackingEndpoint&&s.push([i.trackingEndpoint,t.trackingEndpoint]),t.fallbackVariant&&s.push([i.fallbackVariant,t.fallbackVariant]),t.selectedVariant&&s.push([i.selectedVariant,t.selectedVariant]),s.length>0&&requestAnimationFrame(()=>{s.forEach(([t,i])=>{e.setAttribute(t,i)})})},m=(e,t={})=>{if(!e)return()=>{};const i=new AbortController;return e.addEventListener(n.VARIANT_ASSIGNED,e=>{var i;const n=e,{variant:r,experimentId:a}=n.detail;console.log("🚀 ~ Experiment Wrapper: Variant assigned",{variant:r,experimentId:a}),null===(i=t.onVariantAssigned)||void 0===i||i.call(t,r,a)},{signal:i.signal}),e.addEventListener(n.TRACK,e=>{var i;const n=e;console.log("🚀 ~ Experiment Wrapper: Track event",n.detail),null===(i=t.onTrack)||void 0===i||i.call(t,n.detail.event,n.detail)},{signal:i.signal}),e.addEventListener(n.ERROR,e=>{var i;const n=e,{error:r,experimentId:a}=n.detail;console.log("🚀 ~ Experiment Wrapper: Error event",{error:r,experimentId:a}),null===(i=t.onError)||void 0===i||i.call(t,r,a)},{signal:i.signal}),()=>{i.abort()}},h=()=>{let e=sessionStorage.getItem(t.SESSION_ID);return e||(e="session_"+Date.now()+"_"+Math.random().toString(36).substr(2,9),sessionStorage.setItem(t.SESSION_ID,e)),e},f=()=>"undefined"!=typeof window&&void 0!==window.localStorage,v=()=>{let e=localStorage.getItem(t.USER_ID);return e||(e="user_"+Date.now()+"_"+Math.random().toString(36).substr(2,9),localStorage.setItem(t.USER_ID,e)),e},b=e=>{let t=0;for(let i=0;i<e.length;i++){t=(t<<5)-t+e.charCodeAt(i),t&=t}return Math.abs(t)};e.EXPERIMENT_ATTRIBUTES=i,e.EXPERIMENT_EVENTS=n,e.EXPERIMENT_STORAGE_KEYS=t,e.getCookie=o,e.getDeviceType=p,e.getExperimentKey=d,e.getLocalStorageItem=e=>{if(!f())return null;try{return window.localStorage.getItem(e)}catch(e){return null}},e.getOrCreateSessionId=h,e.getOrCreateUserId=v,e.getVariant=c,e.hashUserId=b,e.parseCookies=a,e.registerExperimentWebComponent=function(){if("undefined"!=typeof window){class e extends HTMLElement{static get observedAttributes(){return[i.config,i.trackingEndpoint,i.gaTracking,i.autoTrack,i.fallbackVariant,i.onTrack,i.onVariantAssigned,i.onError,i.selectedVariant,i.debug]}constructor(){super(),this.experimentConfig=null,this.currentVariant=null,this.isInitialized=!1,this.impressionTracked=!1,this.retryCount=0,this.maxRetries=3,this.initializationTimeout=null,this.attachShadow({mode:"open"}),this.sessionId=h(),this.userId=v()}connectedCallback(){this.initializeExperiment()}attributeChangedCallback(e,t,i){t!==i&&(this.initializationTimeout&&clearTimeout(this.initializationTimeout),this.initializationTimeout=window.setTimeout(()=>{this.initializeExperiment(),this.initializationTimeout=null},0))}initializeExperiment(){try{if(this.parseConfiguration(),!this.experimentConfig)return;if(this.isInitialized&&this.currentVariant)return;if(!this.shouldRunExperiment())return this.currentVariant=this.getFallbackVariant(),void this.render();this.currentVariant=this.getExperimentVariant(),this.isInitialized=!0,this.render(),this.isAutoTrackEnabled()&&this.trackImpression(),this.dispatchEvent(new CustomEvent(n.VARIANT_ASSIGNED,{detail:{experimentId:this.experimentConfig.experimentId,variant:this.currentVariant,timestamp:Date.now()},bubbles:!0})),this.isDebugEnabled()&&console.log("🚀 ~ GxExperimentWrapper ~ Experiment Initialized:",{experimentId:this.experimentConfig.experimentId,variant:this.currentVariant,config:this.experimentConfig})}catch(e){this.handleError(e)}}parseConfiguration(){const e=this.getAttribute(i.config);if(e)try{this.experimentConfig=JSON.parse(e)}catch(e){console.warn("Failed to parse config attribute:",e)}}shouldRunExperiment(){var e;const t=null===(e=this.experimentConfig)||void 0===e?void 0:e.targeting;if(!t)return!0;if(t.trafficPercentage&&t.trafficPercentage<100){if(b(this.userId)%100+1>t.trafficPercentage)return this.isDebugEnabled()&&console.log("🚀 ~ GxExperimentWrapper ~ User excluded from experiment due to traffic percentage"),!1}if(t.deviceType){if(p()!==t.deviceType)return this.isDebugEnabled()&&console.log("🚀 ~ GxExperimentWrapper ~ User excluded from experiment due to device type"),!1}return!0}getExperimentVariant(){if(!this.experimentConfig)return this.getFallbackVariant();const e=this.getAttribute(i.selectedVariant);if(e){const t=d(this.experimentConfig.experimentId);return s(t,e),e}return c(this.experimentConfig)}render(){const e=this.currentVariant||this.getFallbackVariant();console.log("🚀 ~ GxExperimentWrapper ~ render ~ variant:",e);const t=`\n        <style>\n          :host {\n            display: block;\n          }\n\n          /* Hide all variants by default */\n          ::slotted([data-variant]) {\n            display: none !important;\n          }\n\n          /* Show only the selected variant */\n          ::slotted([data-variant="${e}"]) {\n            display: block !important;\n          }\n\n          /* Fallback: if no data-variant specified, show all content */\n          ::slotted(:not([data-variant])) {\n            display: block !important;\n          }\n\n          /* Loading state */\n          :host([loading="true"]) {\n            opacity: 0.7;\n            pointer-events: none;\n          }\n\n          /* Error state */\n          :host([error="true"]) {\n            border: 2px solid #ef4444;\n            background-color: #fef2f2;\n            padding: 1rem;\n            border-radius: 0.5rem;\n          }\n\n          /* Debug styles */\n          :host([debug="true"]) {\n            border: 2px dashed #3b82f6;\n            position: relative;\n          }\n\n          :host([debug="true"])::before {\n            content: "🧪 " attr(experiment-id) " → " attr(variant);\n            position: absolute;\n            top: -1.5rem;\n            left: 0;\n            background: #3b82f6;\n            color: white;\n            padding: 0.25rem 0.5rem;\n            border-radius: 0.25rem;\n            font-size: 0.75rem;\n            font-family: monospace;\n            z-index: 1000;\n          }\n        </style>\n      `;this.shadowRoot.innerHTML=`${t}<slot></slot>`,this.isInitialized?this.removeAttribute(i.loading):this.setAttribute(i.loading,"")}trackImpression(){if(this.impressionTracked||!this.experimentConfig||!this.currentVariant)return;this.impressionTracked=!0;const e={event:"impression",experimentId:this.experimentConfig.experimentId,variant:this.currentVariant,timestamp:Date.now(),sessionId:this.sessionId,userId:this.userId,description:this.experimentConfig.description,userAgent:navigator.userAgent,referrer:document.referrer,url:window.location.href,deviceType:p()};this.track("impression",e)}trackEvent(e,t={}){if(!this.experimentConfig||!this.currentVariant)return;const i=Object.assign({event:e,experimentId:this.experimentConfig.experimentId,variant:this.currentVariant,timestamp:Date.now(),sessionId:this.sessionId,userId:this.userId},t);this.track(e,i)}track(e,t){this.dispatchEvent(new CustomEvent(n.TRACK,{detail:t,bubbles:!0})),this.isGATrackingEnabled()&&"function"==typeof window.gtag&&window.gtag("event",e,t);const r=this.getAttribute(i.trackingEndpoint);r&&fetch(r,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify(t)}).catch(e=>{console.warn("Failed to send tracking data:",e)}),this.isDebugEnabled()&&console.log("🚀 ~ GxExperimentWrapper ~ Tracked Event:",t)}handleError(e){var t,i;console.error("🚀 ~ GxExperimentWrapper ~ Experiment Error:",e),this.setAttribute("error",""),this.currentVariant=this.getFallbackVariant(),this.render(),this.dispatchEvent(new CustomEvent(n.ERROR,{detail:{error:e.message,experimentId:null===(t=this.experimentConfig)||void 0===t?void 0:t.experimentId},bubbles:!0})),this.retryCount<this.maxRetries&&(this.retryCount++,setTimeout(()=>{this.removeAttribute("error"),this.initializeExperiment()},1e3*this.retryCount)),"function"==typeof window.gtag&&window.gtag("event","exception",{description:e.message,fatal:!1,experiment_error:!0,experiment_id:(null===(i=this.experimentConfig)||void 0===i?void 0:i.experimentId)||"unknown"})}getFallbackVariant(){var e,t;return this.getAttribute(i.fallbackVariant)||(null===(t=null===(e=this.experimentConfig)||void 0===e?void 0:e.variants[0])||void 0===t?void 0:t.name)||"control"}isAutoTrackEnabled(){return"false"!==this.getAttribute(i.autoTrack)}isGATrackingEnabled(){return"true"===this.getAttribute(i.gaTracking)}isDebugEnabled(){return"true"===this.getAttribute(i.debug)}getCurrentVariant(){return this.currentVariant}getExperimentStatus(){var e;return{experimentId:null===(e=this.experimentConfig)||void 0===e?void 0:e.experimentId,variant:this.currentVariant,isInitialized:this.isInitialized,sessionId:this.sessionId,userId:this.userId,config:this.experimentConfig}}reassignVariant(){this.experimentConfig&&(l(`${t.PREFIX}${this.experimentConfig.experimentId}`),this.impressionTracked=!1,this.initializeExperiment())}isVariant(e){return this.currentVariant===e}}customElements.get("gx-experiment-wrapper")||customElements.define("gx-experiment-wrapper",e)}},e.removeCookie=l,e.removeLocalStorageItem=e=>{if(f())try{window.localStorage.removeItem(e)}catch(e){}},e.setCookie=s,e.setExperimentWrapperAttributes=g,e.setLocalStorageItem=(e,t)=>{if(f())try{window.localStorage.setItem(e,t)}catch(e){}},e.setupExperimentWrapper=(e,t)=>e?(g(e,t),m(e,t.callbacks)):()=>{},e.setupExperimentWrapperEventListeners=m});

package/dist/umd/tracking/tracker.d.ts

@@ -0,0 +1,12 @@
+interface TrackData {
+    event: string;
+    variant: string;
+    experimentId: string;
+    [key: string]: any;
+}
+export declare class Tracker {
+    private callback?;
+    constructor(callback?: (event: string, data: TrackData) => void);
+    trackEvent(event: string, data: TrackData): void;
+}
+export {};

package/dist/umd/types/devices.d.ts

@@ -0,0 +1,5 @@
+export declare enum IDeviceType {
+    MOBILE = "mobile",
+    DESKTOP = "desktop",
+    TABLET = "tablet"
+}

package/dist/umd/types/experiments.d.ts

@@ -0,0 +1,82 @@
+import type { IExperimentWrapper } from '../components/experiment-wrapper';
+export interface Variant {
+    name: string;
+    weight?: number;
+    component?: any;
+    metadata?: Record<string, any>;
+}
+export interface ExperimentConfig {
+    experimentId: string;
+    variants: Variant[];
+    weights?: number[];
+    description?: string;
+    targeting?: TargetingConfig;
+    metadata?: Record<string, any>;
+}
+export interface TargetingConfig {
+    trafficPercentage?: number;
+    deviceType?: 'mobile' | 'desktop' | 'tablet';
+    country?: string;
+    userSegment?: string;
+    customRules?: Record<string, any>;
+}
+export interface TrackingEvent {
+    event: string;
+    experimentId: string;
+    variant: string;
+    timestamp: number;
+    sessionId?: string;
+    userId?: string;
+    [key: string]: any;
+}
+export interface ExperimentStatus {
+    experimentId?: string;
+    variant: string | null;
+    isInitialized: boolean;
+    sessionId: string;
+    userId: string;
+    config: ExperimentConfig | null;
+}
+export interface ExperimentWrapperConfigProps {
+    config: ExperimentConfig;
+    selectedVariant?: string;
+    trackingEndpoint?: string;
+    gaTracking?: boolean;
+    autoTrack?: boolean;
+    fallbackVariant?: string;
+    debug?: boolean;
+    loading?: boolean;
+    onTrack?: (event: string, data: TrackingEvent) => void;
+    onVariantAssigned?: (variant: string, experimentId: string) => void;
+    onError?: (error: string, experimentId?: string) => void;
+}
+export interface ExperimentWrapperProps extends ExperimentWrapperConfigProps {
+    children: React.ReactNode;
+}
+export interface ABTestHookResult {
+    variant: string | null;
+    isLoading: boolean;
+    error: Error | null;
+    experimentConfig: ExperimentConfig | null;
+    track: (event: string, data?: Record<string, any>) => void;
+    isVariant: (targetVariant: string) => boolean;
+    reassignVariant: () => void;
+    getStatus: () => ExperimentStatus;
+}
+export interface VariantAssignedEvent extends CustomEvent {
+    detail: {
+        experimentId: string;
+        variant: string;
+        timestamp: number;
+    };
+}
+export interface TrackEvent extends CustomEvent {
+    detail: TrackingEvent;
+}
+export interface ExperimentErrorEvent extends CustomEvent {
+    detail: {
+        error: string;
+        experimentId?: string;
+    };
+}
+export type GxExperimentWrapperElement = IExperimentWrapper;

package/dist/umd/types/index.d.ts

@@ -0,0 +1,2 @@
+export * from './devices';
+export * from './experiments';

package/dist/umd/utils/cookie.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Parse cookie string into key-value pairs
+ */
+export declare const parseCookies: (cookieString?: string) => Record<string, string>;
+/**
+ * Get cookie value (works on both client and server)
+ * @param key - Cookie name
+ * @param cookieString - Optional cookie string from server (e.g., from request headers)
+ */
+export declare const getCookie: (key: string, cookieString?: string) => string | null;
+/**
+ * Set cookie (client-side only)
+ * @param key - Cookie name
+ * @param value - Cookie value
+ * @param days - Number of days until expiration (default: 365)
+ */
+export declare const setCookie: (key: string, value: string, days?: number) => void;
+/**
+ * Remove cookie (client-side only)
+ */
+export declare const removeCookie: (key: string) => void;

package/dist/umd/utils/devices.d.ts

@@ -0,0 +1,2 @@
+import { IDeviceType } from '../types/devices';
+export declare const getDeviceType: (agent?: string) => IDeviceType;

package/dist/umd/utils/experiment-wrapper-helpers.d.ts

@@ -0,0 +1,21 @@
+import type { ExperimentWrapperConfigProps, TrackingEvent } from '../types';
+export interface ExperimentWrapperCallbacks {
+    onTrack?: (event: string, data: TrackingEvent) => void;
+    onVariantAssigned?: (variant: string, experimentId: string) => void;
+    onError?: (error: string, experimentId?: string) => void;
+}
+export interface ExperimentWrapperConfig extends Omit<ExperimentWrapperConfigProps, 'onTrack' | 'onVariantAssigned' | 'onError'> {
+    callbacks?: ExperimentWrapperCallbacks;
+}
+/**
+ * Sets all attributes on the gx-experiment-wrapper element
+ */
+export declare const setExperimentWrapperAttributes: (element: any, config: ExperimentWrapperConfig) => void;
+/**
+ * Sets up event listeners on the gx-experiment-wrapper element
+ */
+export declare const setupExperimentWrapperEventListeners: (element: any, callbacks?: ExperimentWrapperCallbacks) => (() => void);
+/**
+ * Complete setup function that configures both attributes and event listeners
+ */
+export declare const setupExperimentWrapper: (element: any, config: ExperimentWrapperConfig) => (() => void);

package/dist/umd/utils/index.d.ts

@@ -0,0 +1,6 @@
+export * from './cookie';
+export * from './devices';
+export * from './experiment-wrapper-helpers';
+export * from './session';
+export * from './storage';
+export * from './user';

package/dist/umd/utils/session.d.ts

@@ -0,0 +1 @@
+export declare const getOrCreateSessionId: () => string;

package/dist/umd/utils/storage.d.ts

@@ -0,0 +1,3 @@
+export declare const getLocalStorageItem: (key: string) => string | null;
+export declare const setLocalStorageItem: (key: string, value: string) => void;
+export declare const removeLocalStorageItem: (key: string) => void;

package/dist/umd/utils/user.d.ts

@@ -0,0 +1,2 @@
+export declare const getOrCreateUserId: () => string;
+export declare const hashUserId: (userId: string) => number;

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "@levi123/experiment",
+  "version": "4.0.0-dev.0",
+  "description": "AB Testing Section Block Components for multiple frameworks with tracking",
+  "keywords": [
+    "ab-testing",
+    "web-components",
+    "react",
+    "vue",
+    "tracking"
+  ],
+  "license": "MIT",
+  "author": "gemx-dev",
+  "type": "module",
+  "source": "src/index.ts",
+  "scripts": {
+    "build": "rollup --config node:@levi123/rollup-config --environment NODE_ENV:production",
+    "clean": "rm -rf dist",
+    "dev": "echo 'Add dev script here'",
+    "format": "prettier --write \"**/*.{ts,tsx,md}\"",
+    "lint": "eslint \"src/**/*.{ts,tsx}\"",
+    "lint:all": "yarn lint && yarn lint:tsc",
+    "lint:tsc": "tsc --noEmit",
+    "post:publish": "node ../../scripts/convert-publish.js",
+    "pre:publish": "node ../../scripts/convert-publish.js -p",
+    "test": "jest --runInBand"
+  },
+  "dependencies": {
+    "tsup": "8.5.0"
+  },
+  "devDependencies": {
+    "eslint": "9.36.0",
+    "rollup": "3.29.5"
+  },
+  "peerDependencies": {
+    "react": ">=17",
+    "react-dom": ">=17"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "main": "dist/umd/index.js",
+  "files": [
+    "dist"
+  ],
+  "module": "dist/esm/index.js",
+  "types": "dist/esm/index.d.ts",
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "node": {
+        "types": "./dist/esm/index.d.ts",
+        "module": "./dist/esm/index.js",
+        "require": "./dist/umd/index.js",
+        "import": "./dist/esm/index.mjs"
+      },
+      "browser": {
+        "import": "./dist/esm/index.js",
+        "require": "./dist/umd/index.js"
+      },
+      "default": "./dist/esm/index.js"
+    }
+  }
+}