@seekora-ai/search-sdk 0.2.6 → 0.2.8

package/dist/index.d.ts

@@ -13,4 +13,5 @@ export { EventQueue, createEventQueue, getDefaultEventQueue, type QueuedEvent, t
 export * from './generated';
 export { AnalyticsV3Api, createAnalyticsV3Api, type AnalyticsV3ApiConfig, type GenericResponse, } from './analytics-v3-api';
 export type { AnalyticsV3BaseRequest, TimeSeriesPoint, SearchMetricsRequest, SearchMetrics, TopQueriesRequest, QueryMetric, ZeroResultQueriesRequest, ZeroResultQuery, ClickMetricsRequest, ClickMetrics, CTRByPositionRequest, PositionCTR, ConversionMetricsRequest, ConversionMetrics, RevenueAttributionRequest, RevenueAttribution, RecommendationMetricsRequest, RecommendationMetrics, RecommendationCTRRequest, RecommendationCTR, FunnelRequest, FunnelStepResult, FunnelData, JourneyEvent, AnalyticsV3EventPayload, } from './analytics-v3-types';
+export { SeekoraActionButtons, createActionButtons, type ActionButtonConfig, type ShareButtonConfig, type ActionButtonResult } from './ui-components';
 export { SeekoraClient as default } from './client';

package/dist/index.js

@@ -19,7 +19,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.default = exports.createAnalyticsV3Api = exports.AnalyticsV3Api = exports.getDefaultEventQueue = exports.createEventQueue = exports.EventQueue = exports.getDefaultContextCollector = exports.collectBrowserContext = exports.ContextCollector = exports.loadConfigFromEnv = exports.loadConfigFromFile = exports.loadConfig = exports.getLogLevelFromEnv = exports.createLogger = exports.Logger = exports.getEnvironment = exports.getBaseUrl = exports.ENVIRONMENTS = exports.SeekoraClient = void 0;
+exports.default = exports.createActionButtons = exports.SeekoraActionButtons = exports.createAnalyticsV3Api = exports.AnalyticsV3Api = exports.getDefaultEventQueue = exports.createEventQueue = exports.EventQueue = exports.getDefaultContextCollector = exports.collectBrowserContext = exports.ContextCollector = exports.loadConfigFromEnv = exports.loadConfigFromFile = exports.loadConfig = exports.getLogLevelFromEnv = exports.createLogger = exports.Logger = exports.getEnvironment = exports.getBaseUrl = exports.ENVIRONMENTS = exports.SeekoraClient = void 0;
 var client_1 = require("./client");
 Object.defineProperty(exports, "SeekoraClient", { enumerable: true, get: function () { return client_1.SeekoraClient; } });
 var config_1 = require("./config");
@@ -47,6 +47,19 @@ __exportStar(require("./generated"), exports);
 var analytics_v3_api_1 = require("./analytics-v3-api");
 Object.defineProperty(exports, "AnalyticsV3Api", { enumerable: true, get: function () { return analytics_v3_api_1.AnalyticsV3Api; } });
 Object.defineProperty(exports, "createAnalyticsV3Api", { enumerable: true, get: function () { return analytics_v3_api_1.createAnalyticsV3Api; } });
+// UI Components and Action Buttons
+var ui_components_1 = require("./ui-components");
+Object.defineProperty(exports, "SeekoraActionButtons", { enumerable: true, get: function () { return ui_components_1.SeekoraActionButtons; } });
+Object.defineProperty(exports, "createActionButtons", { enumerable: true, get: function () { return ui_components_1.createActionButtons; } });
+// React Components (optional, requires React as peer dependency)
+// React components (optional - requires React as peer dependency)
+// Uncomment when React is available:
+// export {
+//     SeekoraActionButtons as SeekoraActionButtonsReact,
+//     AddToCartButton,
+//     AddToWishlistButton,
+//     ShareButton
+// } from './react/ActionButtons';
 // Default export
 var client_2 = require("./client");
 Object.defineProperty(exports, "default", { enumerable: true, get: function () { return client_2.SeekoraClient; } });

package/dist/ui-components.d.ts

@@ -0,0 +1,74 @@
+/**
+ * UI Component Utilities for Seekora Search SDK
+ *
+ * Provides helper functions for creating action buttons that automatically track analytics
+ */
+import { SeekoraClient } from './client';
+import type { SearchContext } from './client';
+export interface ActionButtonConfig {
+    itemId: string;
+    position?: number;
+    searchContext?: SearchContext;
+    quantity?: number;
+    value?: number;
+    currency?: string;
+}
+export interface ShareButtonConfig extends ActionButtonConfig {
+    shareMethod?: string;
+}
+export interface ActionButtonResult {
+    success: boolean;
+    error?: any;
+}
+/**
+ * Create action button handlers that automatically track analytics
+ *
+ * @example
+ * ```typescript
+ * const actionButtons = createActionButtons(seekoraClient);
+ *
+ * const addToCartHandler = actionButtons.createAddToCartHandler({
+ *   itemId: 'product-123',
+ *   quantity: 1,
+ *   value: 29.99,
+ *   searchContext: searchResponse.context
+ * });
+ *
+ * button.addEventListener('click', addToCartHandler);
+ * ```
+ */
+export declare class SeekoraActionButtons {
+    private client;
+    constructor(client: SeekoraClient);
+    /**
+     * Create an Add to Cart button handler
+     * Tracks 'add_to_cart' conversion event
+     */
+    createAddToCartHandler(config: ActionButtonConfig): (event?: Event) => Promise<ActionButtonResult>;
+    /**
+     * Create an Add to Wishlist button handler
+     * Tracks 'wishlist' conversion event
+     */
+    createAddToWishlistHandler(config: ActionButtonConfig): (event?: Event) => Promise<ActionButtonResult>;
+    /**
+     * Create a Share button handler
+     * Tracks custom 'share' event
+     */
+    createShareHandler(config: ShareButtonConfig): (event?: Event) => Promise<ActionButtonResult>;
+    /**
+     * Attach action button handlers to DOM elements
+     * Automatically finds elements with data-seekora-action attribute
+     *
+     * @example
+     * ```html
+     * <button data-seekora-action="add_to_cart" data-seekora-item="product-123">
+     *   Add to Cart
+     * </button>
+     * ```
+     */
+    attachToDOM(searchContext?: SearchContext): void;
+}
+/**
+ * Factory function to create SeekoraActionButtons instance
+ */
+export declare function createActionButtons(client: SeekoraClient): SeekoraActionButtons;

package/dist/ui-components.js

@@ -0,0 +1,165 @@
+"use strict";
+/**
+ * UI Component Utilities for Seekora Search SDK
+ *
+ * Provides helper functions for creating action buttons that automatically track analytics
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SeekoraActionButtons = void 0;
+exports.createActionButtons = createActionButtons;
+/**
+ * Create action button handlers that automatically track analytics
+ *
+ * @example
+ * ```typescript
+ * const actionButtons = createActionButtons(seekoraClient);
+ *
+ * const addToCartHandler = actionButtons.createAddToCartHandler({
+ *   itemId: 'product-123',
+ *   quantity: 1,
+ *   value: 29.99,
+ *   searchContext: searchResponse.context
+ * });
+ *
+ * button.addEventListener('click', addToCartHandler);
+ * ```
+ */
+class SeekoraActionButtons {
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Create an Add to Cart button handler
+     * Tracks 'add_to_cart' conversion event
+     */
+    createAddToCartHandler(config) {
+        return async (event) => {
+            event?.preventDefault();
+            try {
+                await this.client.trackAddToCart({
+                    itemId: config.itemId,
+                    quantity: config.quantity,
+                    value: config.value,
+                    currency: config.currency,
+                    position: config.position,
+                    searchContext: config.searchContext
+                });
+                return { success: true };
+            }
+            catch (error) {
+                console.error('Failed to track add to cart', error);
+                return { success: false, error };
+            }
+        };
+    }
+    /**
+     * Create an Add to Wishlist button handler
+     * Tracks 'wishlist' conversion event
+     */
+    createAddToWishlistHandler(config) {
+        return async (event) => {
+            event?.preventDefault();
+            try {
+                await this.client.trackAddToWishlist({
+                    itemId: config.itemId,
+                    position: config.position,
+                    searchContext: config.searchContext
+                });
+                return { success: true };
+            }
+            catch (error) {
+                console.error('Failed to track add to wishlist', error);
+                return { success: false, error };
+            }
+        };
+    }
+    /**
+     * Create a Share button handler
+     * Tracks custom 'share' event
+     */
+    createShareHandler(config) {
+        return async (event) => {
+            event?.preventDefault();
+            try {
+                await this.client.trackShare({
+                    itemId: config.itemId,
+                    shareMethod: config.shareMethod,
+                    position: config.position,
+                    searchContext: config.searchContext
+                });
+                return { success: true };
+            }
+            catch (error) {
+                console.error('Failed to track share', error);
+                return { success: false, error };
+            }
+        };
+    }
+    /**
+     * Attach action button handlers to DOM elements
+     * Automatically finds elements with data-seekora-action attribute
+     *
+     * @example
+     * ```html
+     * <button data-seekora-action="add_to_cart" data-seekora-item="product-123">
+     *   Add to Cart
+     * </button>
+     * ```
+     */
+    attachToDOM(searchContext) {
+        const buttons = document.querySelectorAll('[data-seekora-action]');
+        buttons.forEach((button) => {
+            const action = button.getAttribute('data-seekora-action');
+            const itemId = button.getAttribute('data-seekora-item');
+            const position = parseInt(button.getAttribute('data-seekora-position') || '0', 10);
+            const quantity = parseInt(button.getAttribute('data-seekora-quantity') || '1', 10);
+            const value = parseFloat(button.getAttribute('data-seekora-value') || '0');
+            const currency = button.getAttribute('data-seekora-currency') || 'USD';
+            const shareMethod = button.getAttribute('data-seekora-share-method') || 'unknown';
+            if (!itemId) {
+                console.warn('Seekora action button missing data-seekora-item attribute', button);
+                return;
+            }
+            let handler = null;
+            switch (action) {
+                case 'add_to_cart':
+                    handler = this.createAddToCartHandler({
+                        itemId,
+                        position: position || undefined,
+                        quantity,
+                        value,
+                        currency,
+                        searchContext
+                    });
+                    break;
+                case 'add_to_wishlist':
+                    handler = this.createAddToWishlistHandler({
+                        itemId,
+                        position: position || undefined,
+                        searchContext
+                    });
+                    break;
+                case 'share':
+                    handler = this.createShareHandler({
+                        itemId,
+                        position: position || undefined,
+                        shareMethod,
+                        searchContext
+                    });
+                    break;
+                default:
+                    console.warn('Unknown Seekora action:', action);
+            }
+            if (handler) {
+                button.addEventListener('click', handler);
+            }
+        });
+    }
+}
+exports.SeekoraActionButtons = SeekoraActionButtons;
+/**
+ * Factory function to create SeekoraActionButtons instance
+ */
+function createActionButtons(client) {
+    return new SeekoraActionButtons(client);
+}

package/package.json

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

package/dist/src/cdn.d.ts

@@ -1,16 +0,0 @@
-/**
- * CDN Entry Point for Seekora Search SDK
- *
- * This file is used to create a browser-compatible bundle that can be
- * loaded via a <script> tag and accessed via a global variable.
- */
-import { SeekoraClient } from './client';
-import { ENVIRONMENTS, getBaseUrl, getEnvironment } from './config';
-import { Logger, createLogger, getLogLevelFromEnv } from './logger';
-import { loadConfig, loadConfigFromFile, loadConfigFromEnv } from './config-loader';
-export type { SeekoraClientConfig, SearchOptions, SearchResponse, SearchContext, ExtendedEventPayload } from './client';
-export type { SeekoraEnvironment, EnvironmentConfig } from './config';
-export type { LogLevel, LoggerConfig } from './logger';
-export type { FileConfig } from './config-loader';
-export { SeekoraClient, ENVIRONMENTS, getBaseUrl, getEnvironment, Logger, createLogger, getLogLevelFromEnv, loadConfig, loadConfigFromFile, loadConfigFromEnv, };
-export default SeekoraClient;

package/dist/src/cdn.js

@@ -1,26 +0,0 @@
-"use strict";
-/**
- * CDN Entry Point for Seekora Search SDK
- *
- * This file is used to create a browser-compatible bundle that can be
- * loaded via a <script> tag and accessed via a global variable.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.loadConfigFromEnv = exports.loadConfigFromFile = exports.loadConfig = exports.getLogLevelFromEnv = exports.createLogger = exports.Logger = exports.getEnvironment = exports.getBaseUrl = exports.ENVIRONMENTS = exports.SeekoraClient = void 0;
-// Import all exports
-const client_1 = require("./client");
-Object.defineProperty(exports, "SeekoraClient", { enumerable: true, get: function () { return client_1.SeekoraClient; } });
-const config_1 = require("./config");
-Object.defineProperty(exports, "ENVIRONMENTS", { enumerable: true, get: function () { return config_1.ENVIRONMENTS; } });
-Object.defineProperty(exports, "getBaseUrl", { enumerable: true, get: function () { return config_1.getBaseUrl; } });
-Object.defineProperty(exports, "getEnvironment", { enumerable: true, get: function () { return config_1.getEnvironment; } });
-const logger_1 = require("./logger");
-Object.defineProperty(exports, "Logger", { enumerable: true, get: function () { return logger_1.Logger; } });
-Object.defineProperty(exports, "createLogger", { enumerable: true, get: function () { return logger_1.createLogger; } });
-Object.defineProperty(exports, "getLogLevelFromEnv", { enumerable: true, get: function () { return logger_1.getLogLevelFromEnv; } });
-const config_loader_1 = require("./config-loader");
-Object.defineProperty(exports, "loadConfig", { enumerable: true, get: function () { return config_loader_1.loadConfig; } });
-Object.defineProperty(exports, "loadConfigFromFile", { enumerable: true, get: function () { return config_loader_1.loadConfigFromFile; } });
-Object.defineProperty(exports, "loadConfigFromEnv", { enumerable: true, get: function () { return config_loader_1.loadConfigFromEnv; } });
-// Default export
-exports.default = client_1.SeekoraClient;