@seekora-ai/search-sdk 0.2.12 → 0.2.13

package/dist/client.d.ts

@@ -78,6 +78,14 @@ export interface SeekoraClientConfig {
      * @default 0
      */
     impressionTrackingDelay?: number;
+    /**
+     * A/B test experiment ID to include in all analytics events
+     */
+    abTestId?: string;
+    /**
+     * A/B test variant to include in all analytics events
+     */
+    abVariant?: string;
     /**
      * Enable event deduplication (industry standard: Segment, Amplitude pattern)
      * When enabled, generates insert_id for backend deduplication
@@ -147,6 +155,10 @@ export interface ExtendedEventPayload extends DataTypesEventPayload {
     insert_id?: string;
     /** Conversion type for conversion events (add_to_cart, wishlist, purchase, etc.) */
     conversion_type?: string;
+    /** A/B test experiment ID */
+    ab_test_id?: string;
+    /** A/B test variant */
+    ab_variant?: string;
 }
 export interface SearchOptions {
     q: string;
@@ -330,6 +342,8 @@ export declare class SeekoraClient {
     private clientConfig;
     private enableDeduplication;
     private deduplicationWindow;
+    private abTestId?;
+    private abVariant?;
     constructor(config?: SeekoraClientConfig);
     /**
      * Search for documents
@@ -743,6 +757,18 @@ export declare class SeekoraClient {
         anonId: string;
         sessionId: string;
     };
+    /**
+     * Set A/B test experiment ID and variant for all subsequent analytics events.
+     * Call this when experiment assignments are fetched.
+     */
+    setAbTest(abTestId?: string, abVariant?: string): void;
+    /**
+     * Get current A/B test fields
+     */
+    getAbTest(): {
+        abTestId?: string;
+        abVariant?: string;
+    };
     /**
      * Get the event queue instance (if enabled)
      */

package/dist/client.js

@@ -42,6 +42,8 @@ class SeekoraClient {
         this.anonId = config.anonId || (0, utils_1.getOrCreateAnonId)();
         this.sessionId = config.sessionId || (0, utils_1.getOrCreateSessionId)();
         this.autoTrackSearch = config.autoTrackSearch || false;
+        this.abTestId = config.abTestId;
+        this.abVariant = config.abVariant;
         // Initialize context collection
         this.enableContextCollection = config.enableContextCollection !== false; // Default to true
         this.contextCollector = new context_collector_1.ContextCollector(config.contextCollector);
@@ -1235,6 +1237,13 @@ class SeekoraClient {
             payload.is_tablet = ctx.is_tablet ? 1 : 0;
             payload.is_touch_device = ctx.is_touch_device;
         }
+        // Inject A/B test fields from client config (event-level values take precedence)
+        if (this.abTestId && !payload.ab_test_id) {
+            payload.ab_test_id = this.abTestId;
+        }
+        if (this.abVariant && !payload.ab_variant) {
+            payload.ab_variant = this.abVariant;
+        }
         // Generate insert_id for deduplication (industry standard: Segment/Amplitude pattern)
         // Always enable for purchase events (revenue must be accurate)
         // Optional for other events based on config
@@ -1631,6 +1640,21 @@ class SeekoraClient {
             sessionId: this.sessionId,
         };
     }
+    /**
+     * Set A/B test experiment ID and variant for all subsequent analytics events.
+     * Call this when experiment assignments are fetched.
+     */
+    setAbTest(abTestId, abVariant) {
+        this.abTestId = abTestId;
+        this.abVariant = abVariant;
+        this.logger.verbose('A/B test fields updated', { abTestId, abVariant });
+    }
+    /**
+     * Get current A/B test fields
+     */
+    getAbTest() {
+        return { abTestId: this.abTestId, abVariant: this.abVariant };
+    }
     /**
      * Get the event queue instance (if enabled)
      */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@seekora-ai/search-sdk",
-  "version": "0.2.12",
+  "version": "0.2.13",
   "description": "Seekora Search SDK for JavaScript/TypeScript",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",