crexperium-sdk 1.2.4 → 1.2.5

package/dist/index.mjs

@@ -602,6 +602,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
  */
@@ -13767,6 +13843,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();
@@ -13790,6 +13867,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)
      */
@@ -13853,7 +13936,7 @@ class CRMClient {
  */
 // Main client
 // Version
-const VERSION = '1.1.0';
+const VERSION = '1.2.5';
 
-export { AuthenticationError, AutoPageViewPlugin, CRMClient, CRMError, Config, ConsoleLevel, ContactsResource, DealsResource, DeviceInfoPlugin, EventsResource, NetworkError, RateLimitError, ResourceNotFoundError, ServerError, SessionEventType, SessionReplayPlugin, VERSION, ValidationError, VisitorIdPlugin, detectBrowser, detectDeviceType, detectOS, generateUUID, getDeviceInfo, getLocalStorageItem, isLocalStorageAvailable, removeLocalStorageItem, setLocalStorageItem };
+export { AuthenticationError, AutoPageViewPlugin, CRMClient, CRMError, Config, ConsoleLevel, ContactsResource, DealsResource, DeviceInfoPlugin, EventsResource, ExperimentsResource, NetworkError, RateLimitError, ResourceNotFoundError, ServerError, SessionEventType, SessionReplayPlugin, VERSION, ValidationError, VisitorIdPlugin, detectBrowser, detectDeviceType, detectOS, generateUUID, getDeviceInfo, getLocalStorageItem, isLocalStorageAvailable, removeLocalStorageItem, setLocalStorageItem };
 //# sourceMappingURL=index.mjs.map