crexperium-sdk 1.2.4 → 1.2.6

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

@@ -18,7 +18,7 @@ class Config {
             this.apiToken = options.apiToken;
         }
         // Set defaults
-        this.baseUrl = options.baseUrl || 'https://crxperium.applikuapp.com';
+        this.baseUrl = options.baseUrl || 'https://budget-api-s366in24na-uc.a.run.app';
         this.timeout = options.timeout ?? 30000; // 30 seconds
         this.maxRetries = options.maxRetries ?? 3;
         this.retryDelay = options.retryDelay ?? 1000; // 1 second
@@ -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
  */
@@ -13769,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();
@@ -13792,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)
      */
@@ -13855,7 +13938,7 @@ class CRMClient {
  */
 // Main client
 // Version
-const VERSION = '1.1.0';
+const VERSION = '1.2.5';
 
 exports.AuthenticationError = AuthenticationError;
 exports.AutoPageViewPlugin = AutoPageViewPlugin;
@@ -13866,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;