crexperium-sdk 1.2.3 → 1.2.5

package/dist/client.d.ts

@@ -5,6 +5,7 @@ import { SDKConfig } from './config';
 import { EventsResource } from './resources/events';
 import { ContactsResource } from './resources/contacts';
 import { DealsResource } from './resources/deals';
+import { ExperimentsResource } from './resources/experiments';
 import { VisitorIdPlugin } from './plugins/visitor-id';
 import { DeviceInfoPlugin } from './plugins/device-info';
 import { SessionReplayPlugin } from './plugins/session-replay';
@@ -14,6 +15,7 @@ export declare class CRMClient {
     private _events;
     private _contacts;
     private _deals;
+    private _experiments;
     private plugins;
     private _visitorId?;
     private _deviceInfo?;
@@ -32,6 +34,10 @@ export declare class CRMClient {
      * Deals resource for managing deals
      */
     get deals(): DealsResource;
+    /**
+     * Experiments resource for A/B testing and feature flags
+     */
+    get experiments(): ExperimentsResource;
     /**
      * Visitor ID plugin (browser only)
      */

package/dist/index.d.ts

@@ -7,6 +7,7 @@ export { Config, SDKConfig } from './config';
 export { EventsResource } from './resources/events';
 export { ContactsResource } from './resources/contacts';
 export { DealsResource } from './resources/deals';
+export { ExperimentsResource } from './resources/experiments';
 export * from './types';
 export * from './errors';
 export { VisitorIdPlugin, Plugin } from './plugins/visitor-id';
@@ -15,4 +16,4 @@ export { AutoPageViewPlugin } from './plugins/auto-page-view';
 export { SessionReplayPlugin } from './plugins/session-replay';
 export { DeviceInfo, getDeviceInfo, detectDeviceType, detectBrowser, detectOS } from './utils/device';
 export { isLocalStorageAvailable, getLocalStorageItem, setLocalStorageItem, removeLocalStorageItem, generateUUID, } from './utils/storage';
-export declare const VERSION = "1.1.0";
+export declare const VERSION = "1.2.5";

package/dist/index.js

@@ -604,6 +604,82 @@ class DealsResource extends BaseResource {
     }
 }
 
+/**
+ * Experiments API Resource
+ * Handles A/B testing and feature flagging
+ */
+class ExperimentsResource extends BaseResource {
+    /**
+     * Get an experiment by ID or key
+     */
+    async get(experimentIdOrKey) {
+        return this.http.get(`/api/v1/experiments/${experimentIdOrKey}/`);
+    }
+    /**
+     * Get a variant assignment for a visitor
+     * This is the main SDK method for A/B testing
+     *
+     * @param experimentKey - The unique key of the experiment
+     * @param visitorId - The unique identifier for the visitor
+     * @param context - Optional context data (user agent, device, etc.)
+     * @returns The assigned variant with its payload
+     *
+     * @example
+     * ```typescript
+     * const assignment = await client.experiments.assign('checkout_button_test', {
+     *   visitor_id: 'visitor_123',
+     *   context: {
+     *     user_agent: navigator.userAgent,
+     *     device_type: 'desktop',
+     *     browser: 'chrome'
+     *   }
+     * });
+     *
+     * // Use the variant payload
+     * const buttonColor = assignment.variant.payload.button_color;
+     * ```
+     */
+    async assign(experimentKey, input) {
+        return this.http.post(`/api/v1/experiments/${experimentKey}/assign/`, input);
+    }
+    /**
+     * Track a conversion for a visitor in an experiment
+     * Call this when a visitor completes the desired action
+     *
+     * @param experimentKey - The unique key of the experiment
+     * @param input - Conversion data including visitor_id
+     *
+     * @example
+     * ```typescript
+     * await client.experiments.trackConversion('checkout_button_test', {
+     *   visitor_id: 'visitor_123',
+     *   event_name: 'purchase',
+     *   event_properties: {
+     *     amount: 99.99,
+     *     currency: 'USD'
+     *   }
+     * });
+     * ```
+     */
+    async trackConversion(experimentKey, input) {
+        await this.http.post(`/api/v1/experiments/${experimentKey}/convert/`, input);
+    }
+    /**
+     * Get a variant assignment and automatically track the exposure
+     * This combines assign() and exposure tracking in one call
+     *
+     * @param experimentKey - The unique key of the experiment
+     * @param input - Assignment data including visitor_id
+     * @returns The assigned variant with its payload
+     */
+    async getVariant(experimentKey, input) {
+        const assignment = await this.assign(experimentKey, input);
+        // Exposure is automatically tracked by the backend on assign
+        // but we return the assignment for client use
+        return assignment;
+    }
+}
+
 /**
  * Storage utilities for browser localStorage/cookies
  */
@@ -13219,18 +13295,13 @@ class SessionReplayPlugin {
      */
     async init() {
         try {
-            console.log('[SessionReplay] Initializing session replay...');
             // Start session on backend
             await this.startSession();
-            console.log('[SessionReplay] Session started on backend, sessionId:', this.session?.sessionId);
             // Start rrweb recording
-            console.log('[SessionReplay] Starting rrweb recording...');
             this.startRrwebRecording();
-            console.log('[SessionReplay] rrweb recording started');
             // IMPORTANT: Flush initial events (Type 4 Meta + Type 2 Full Snapshot) immediately
             // so the session is playable right away, don't wait for the 5s flush interval
             setTimeout(() => {
-                console.log('[SessionReplay] Performing initial flush of critical events...');
                 this.flush();
             }, 100); // Small delay to ensure rrweb events are captured
             // Intercept console methods
@@ -13305,17 +13376,9 @@ class SessionReplayPlugin {
         this.stopRecording = record({
             emit: (event) => {
                 // Debug: Log event types
-                if (event.type === 4) {
-                    console.log('[SessionReplay] Captured Meta event (type 4)');
-                }
-                else if (event.type === 2) {
-                    console.log('[SessionReplay] Captured Full Snapshot event (type 2)');
-                }
                 this.eventBuffer.push(event);
-                console.log(`[SessionReplay] Event buffered. Type: ${event.type}, Buffer size: ${this.eventBuffer.length}`);
                 // Auto-flush if buffer reaches max size
                 if (this.eventBuffer.length >= (this.config.buffering?.maxBufferSize || 100)) {
-                    console.log('[SessionReplay] Buffer full, flushing...');
                     this.flush();
                 }
             },
@@ -13657,16 +13720,12 @@ class SessionReplayPlugin {
      * Flush buffered events to backend
      */
     async flush() {
-        console.log(`[SessionReplay] flush() called. Session: ${!!this.session}, Event buffer: ${this.eventBuffer.length}, Telemetry buffer: ${this.telemetryBuffer.length}`);
         if (!this.session) {
-            console.warn('[SessionReplay] flush() skipped - no session yet!');
             return;
         }
         if (this.eventBuffer.length === 0 && this.telemetryBuffer.length === 0) {
-            console.log('[SessionReplay] flush() skipped - buffers empty');
             return;
         }
-        console.log(`[SessionReplay] Flushing ${this.eventBuffer.length} events to backend...`);
         const eventsToSend = [...this.eventBuffer];
         const telemetryToSend = [...this.telemetryBuffer];
         // Clear buffers
@@ -13786,6 +13845,7 @@ class CRMClient {
         this._events = new EventsResource(this.http);
         this._contacts = new ContactsResource(this.http);
         this._deals = new DealsResource(this.http);
+        this._experiments = new ExperimentsResource(this.http);
         // Initialize browser plugins if in browser
         if (isBrowser) {
             this.initBrowserPlugins();
@@ -13809,6 +13869,12 @@ class CRMClient {
     get deals() {
         return this._deals;
     }
+    /**
+     * Experiments resource for A/B testing and feature flags
+     */
+    get experiments() {
+        return this._experiments;
+    }
     /**
      * Visitor ID plugin (browser only)
      */
@@ -13872,7 +13938,7 @@ class CRMClient {
  */
 // Main client
 // Version
-const VERSION = '1.1.0';
+const VERSION = '1.2.5';
 
 exports.AuthenticationError = AuthenticationError;
 exports.AutoPageViewPlugin = AutoPageViewPlugin;
@@ -13883,6 +13949,7 @@ exports.ContactsResource = ContactsResource;
 exports.DealsResource = DealsResource;
 exports.DeviceInfoPlugin = DeviceInfoPlugin;
 exports.EventsResource = EventsResource;
+exports.ExperimentsResource = ExperimentsResource;
 exports.NetworkError = NetworkError;
 exports.RateLimitError = RateLimitError;
 exports.ResourceNotFoundError = ResourceNotFoundError;