@cshah18/sdk 4.8.0 → 4.10.0

package/dist/cobuy-sdk.esm.js

@@ -1,23 +1,373 @@
+/**
+ * Base class for all CoBuy SDK errors
+ * Provides consistent error structure across the SDK
+ */
+class CoBuyError extends Error {
+    constructor(message, code, details) {
+        super(message);
+        this.name = this.constructor.name;
+        this.code = code;
+        this.details = details;
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+}
 /**
  * Thrown when the SDK is used before initialization
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   CoBuy.renderWidget({...});
+ * } catch (error) {
+ *   if (error instanceof CoBuyNotInitializedError) {
+ *     console.log('SDK not initialized, call CoBuy.init() first');
+ *   }
+ * }
+ * ```
  */
-class CoBuyNotInitializedError extends Error {
+class CoBuyNotInitializedError extends CoBuyError {
     constructor() {
-        super("CoBuy SDK has not been initialized. Call CoBuy.init(options) first.");
-        this.name = "CoBuyNotInitializedError";
+        super("CoBuy SDK is not initialized. Call CoBuy.init() before using the SDK.", "NOT_INITIALIZED");
         Object.setPrototypeOf(this, CoBuyNotInitializedError.prototype);
     }
 }
 /**
- * Thrown when invalid configuration is provided
+ * Thrown when invalid configuration is provided during initialization
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   CoBuy.init({
+ *     authMode: 'public'
+ *     // Missing merchantKey
+ *   });
+ * } catch (error) {
+ *   if (error instanceof CoBuyInvalidConfigError) {
+ *     console.log('Config validation failed:', error.message);
+ *   }
+ * }
+ * ```
  */
-class CoBuyInvalidConfigError extends Error {
-    constructor(message) {
-        super(`Invalid CoBuy configuration: ${message}`);
-        this.name = "CoBuyInvalidConfigError";
+class CoBuyInvalidConfigError extends CoBuyError {
+    constructor(message, details) {
+        super(`Invalid CoBuy configuration: ${message}`, "INVALID_CONFIG", details);
         Object.setPrototypeOf(this, CoBuyInvalidConfigError.prototype);
     }
 }
+/**
+ * Thrown when widget rendering fails
+ * This includes container resolution, DOM manipulation, or state errors
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await CoBuy.renderWidget({
+ *     productId: 'prod_123',
+ *     container: '#nonexistent'
+ *   });
+ * } catch (error) {
+ *   if (error instanceof CoBuyRenderError) {
+ *     console.log('Widget render failed:', error.message);
+ *   }
+ * }
+ * ```
+ */
+class CoBuyRenderError extends CoBuyError {
+    constructor(message, details) {
+        super(message, "RENDER_FAILED", details);
+        Object.setPrototypeOf(this, CoBuyRenderError.prototype);
+    }
+}
+/**
+ * Thrown when API communication fails
+ * This includes network errors, CORS issues, timeouts, and server errors
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await CoBuy.joinGroup('grp_123', {type: 'email', value: 'user@example.com'});
+ * } catch (error) {
+ *   if (error instanceof CoBuyApiError) {
+ *     console.log('API request failed:', error.code, error.message);
+ *     if (error.details?.statusCode === 429) {
+ *       console.log('Rate limited - retry later');
+ *     }
+ *   }
+ * }
+ * ```
+ */
+class CoBuyApiError extends CoBuyError {
+    constructor(message, code = "API_ERROR", details) {
+        super(message, code, details);
+        Object.setPrototypeOf(this, CoBuyApiError.prototype);
+    }
+}
+/**
+ * Thrown when input validation fails
+ * This includes invalid product IDs, container selectors, or option values
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await CoBuy.renderWidget({
+ *     productId: '', // Invalid: empty string
+ *     container: '#widget'
+ *   });
+ * } catch (error) {
+ *   if (error instanceof CoBuyValidationError) {
+ *     console.log('Invalid input:', error.message);
+ *   }
+ * }
+ * ```
+ */
+class CoBuyValidationError extends CoBuyError {
+    constructor(message, details) {
+        super(message, "VALIDATION_FAILED", details);
+        Object.setPrototypeOf(this, CoBuyValidationError.prototype);
+    }
+}
+
+/**
+ * Input validation helpers for SDK configuration and widget options
+ */
+/**
+ * Validate product ID format and constraints
+ *
+ * @param {string} productId - The product ID to validate
+ * @returns {boolean} True if product ID is valid, false otherwise
+ *
+ * @description
+ * Validates that a product ID meets the following criteria:
+ * - Must be a non-empty string
+ * - Maximum length of 200 characters
+ * - Cannot be only whitespace
+ *
+ * @example
+ * validateProductId("prod_123");        // ✅ true
+ * validateProductId("");                // ❌ false (empty)
+ * validateProductId("x".repeat(201));  // ❌ false (too long)
+ */
+function validateProductId(productId) {
+    if (!productId || typeof productId !== "string") {
+        return false;
+    }
+    // Prevent extremely long IDs
+    if (productId.length > 200) {
+        return false;
+    }
+    // Trim and check again
+    if (productId.trim().length === 0) {
+        return false;
+    }
+    return true;
+}
+/**
+ * Validate CSS color format
+ *
+ * @param {string} color - The color value to validate
+ * @returns {boolean} True if color is valid CSS format, false otherwise
+ *
+ * @description
+ * Validates that a color value is valid CSS format. Supports:
+ * - **Hex Colors**: #RGB, #RRGGBB, #RRGGBBAA
+ * - **RGB/RGBA**: rgb(255, 0, 0), rgba(255, 0, 0, 0.5)
+ * - **HSL/HSLA**: hsl(0, 100%, 50%), hsla(0, 100%, 50%, 0.5)
+ * - **Named Colors**: transparent, inherit, initial, unset
+ *
+ * @example
+ * validateColor("#4f46e5");        // ✅ true (hex)
+ * validateColor("#4f46e5cc");      // ✅ true (hex with alpha)
+ * validateColor("rgb(0, 0, 0)");   // ✅ true (rgb)
+ * validateColor("notacolor");      // ❌ false (invalid)
+ */
+function validateColor(color) {
+    if (!color || typeof color !== "string") {
+        return false;
+    }
+    const trimmedColor = color.trim();
+    // Hex color validation: #RGB, #RRGGBB, #RRGGBBAA
+    if (/^#([0-9A-F]{3}){1,2}([0-9A-F]{2})?$/i.test(trimmedColor)) {
+        return true;
+    }
+    // RGB/RGBA validation
+    if (/^rgba?\s*\(/i.test(trimmedColor)) {
+        return true;
+    }
+    // HSL/HSLA validation
+    if (/^hsla?\s*\(/i.test(trimmedColor)) {
+        return true;
+    }
+    // Named colors
+    const namedColors = ["transparent", "inherit", "initial", "unset"];
+    if (namedColors.includes(trimmedColor.toLowerCase())) {
+        return true;
+    }
+    return false;
+}
+/**
+ * Validate CSS border radius format
+ *
+ * @param {string} borderRadius - The border radius value to validate
+ * @returns {boolean} True if border radius is valid CSS format, false otherwise
+ *
+ * @description
+ * Validates that a border radius value is valid CSS format.
+ * Supports common CSS units: px, rem, em, %, ch, ex, vw, vh, vmin, vmax
+ *
+ * @example
+ * validateBorderRadius("8px");      // ✅ true
+ * validateBorderRadius("0.5rem");   // ✅ true
+ * validateBorderRadius("8");        // ✅ true (assumes pixels)
+ * validateBorderRadius("notsize");  // ❌ false
+ */
+function validateBorderRadius(borderRadius) {
+    if (!borderRadius || typeof borderRadius !== "string") {
+        return false;
+    }
+    const trimmedRadius = borderRadius.trim();
+    // Valid CSS size units
+    if (/^(\d+(\.\d+)?)(px|rem|em|%|ch|ex|vw|vh|vmin|vmax)$/i.test(trimmedRadius)) {
+        return true;
+    }
+    // Single number (assumes pixels)
+    if (/^\d+(\.\d+)?$/.test(trimmedRadius)) {
+        return true;
+    }
+    return false;
+}
+/**
+ * Validate CSS font family format
+ *
+ * @param {string} fontFamily - The font family value to validate
+ * @returns {boolean} True if font family is valid, false otherwise
+ *
+ * @description
+ * Validates that a font family value is suitable for use.
+ * - Must not be empty or whitespace-only
+ * - Maximum length of 500 characters
+ * - Can be single font or comma-separated list
+ *
+ * @example
+ * validateFontFamily("Inter, sans-serif");     // ✅ true
+ * validateFontFamily("'Courier New', monospace"); // ✅ true
+ * validateFontFamily("");                      // ❌ false (empty)
+ */
+function validateFontFamily(fontFamily) {
+    if (!fontFamily || typeof fontFamily !== "string") {
+        return false;
+    }
+    const trimmedFamily = fontFamily.trim();
+    // Ensure non-empty after trim
+    if (trimmedFamily.length === 0) {
+        return false;
+    }
+    // Max length check to prevent extremely long font lists
+    if (trimmedFamily.length > 500) {
+        return false;
+    }
+    return true;
+}
+/**
+ * Validate animation speed value
+ *
+ * @param {string} speed - The animation speed to validate
+ * @returns {boolean} True if speed is a valid animation speed value, false otherwise
+ *
+ * @description
+ * Validates that the animation speed is one of the predefined values.
+ * Valid values: "none", "fast", "normal", "slow"
+ *
+ * @example
+ * validateAnimationSpeed("normal");  // ✅ true
+ * validateAnimationSpeed("slow");    // ✅ true
+ * validateAnimationSpeed("fast");    // ✅ true (case-insensitive)
+ * validateAnimationSpeed("SLOW");    // ✅ true
+ * validateAnimationSpeed("instant"); // ❌ false (invalid value)
+ */
+function validateAnimationSpeed(speed) {
+    const validSpeeds = ["none", "fast", "normal", "slow"];
+    return validSpeeds.includes(speed.toLowerCase());
+}
+/**
+ * Validate animation style value
+ *
+ * @param {string} style - The animation style to validate
+ * @returns {boolean} True if style is a valid animation style value, false otherwise
+ *
+ * @description
+ * Validates that the animation style is one of the predefined values.
+ * Valid values: "none", "subtle", "smooth", "bouncy"
+ * - *none*: No animation
+ * - *subtle*: Fade only (no movement)
+ * - *smooth*: Fade + slide animation
+ * - *bouncy*: Spring-like bounce effect
+ *
+ * @example
+ * validateAnimationStyle("subtle");  // ✅ true
+ * validateAnimationStyle("SMOOTH");  // ✅ true (case-insensitive)
+ * validateAnimationStyle("bouncy");  // ✅ true
+ * validateAnimationStyle("custom");  // ❌ false (invalid)
+ */
+function validateAnimationStyle(style) {
+    const validStyles = ["none", "subtle", "smooth", "bouncy"];
+    return validStyles.includes(style.toLowerCase());
+}
+/**
+ * Validate merchant authentication key
+ *
+ * @param {string} merchantKey - The merchant key to validate
+ * @returns {boolean} True if merchant key is valid, false otherwise
+ *
+ * @description
+ * Validates that a merchant key is properly formatted for authentication.
+ * - Must be a non-empty string
+ * - Maximum length of 500 characters
+ * - Cannot be whitespace-only
+ *
+ * @example
+ * validateMerchantKey("pk_live_abc123xyz");     // ✅ true
+ * validateMerchantKey("");                      // ❌ false (empty)
+ * validateMerchantKey("   ");                   // ❌ false (whitespace)
+ */
+function validateMerchantKey(merchantKey) {
+    if (!merchantKey || typeof merchantKey !== "string") {
+        return false;
+    }
+    // Non-empty string, max 500 chars
+    if (merchantKey.trim().length === 0 || merchantKey.length > 500) {
+        return false;
+    }
+    return true;
+}
+/**
+ * Validate session authentication token
+ *
+ * @param {string | Function} token - Session token string or function
+ * @returns {boolean} True if token is valid, false otherwise
+ *
+ * @description
+ * Validates that a session token is either:
+ * - A non-empty string token, OR
+ * - A function that returns a string or Promise<string> for async token retrieval
+ *
+ * This allows both static tokens and dynamic token providers.
+ *
+ * @example
+ * validateSessionToken("token_abc123");                    // ✅ true
+ * validateSessionToken(() => "dynamic_token");            // ✅ true
+ * validateSessionToken(async () => await fetchToken());   // ✅ true
+ * validateSessionToken("");                                // ❌ false (empty string)
+ * validateSessionToken({} as any);                         // ❌ false (not function)
+ */
+function validateSessionToken(token) {
+    if (typeof token === "string") {
+        return token.trim().length > 0;
+    }
+    if (typeof token === "function") {
+        return true;
+    }
+    return false;
+}
 
 /**
  * Manages SDK configuration with validation and defaults
@@ -26,10 +376,28 @@ class ConfigManager {
     constructor() {
         this.config = null;
     }
+    /**
+     * Get API base URL override from environment (if provided)
+     * Supports both browser global and build-time env injection
+     */
+    static getApiBaseUrlOverride() {
+        var _a, _b;
+        const globalValue = globalThis
+            .COBUY_API_BASE_URL;
+        const envValue = (_b = (_a = globalThis.process) === null || _a === void 0 ? void 0 : _a.env) === null || _b === void 0 ? void 0 : _b.COBUY_API_BASE_URL;
+        const override = globalValue || envValue;
+        if (override && typeof override === "string") {
+            return override.trim();
+        }
+        return null;
+    }
     /**
      * Set and validate SDK configuration
+     *
+     * @throws {CoBuyInvalidConfigError} If authMode, merchantKey, or sessionToken validation fails
      */
     setConfig(options) {
+        var _a, _b, _c, _d, _e, _f;
         // Determine auth mode (default: public)
         const authMode = options.authMode || "public";
         // Validate authentication configuration based on mode
@@ -37,6 +405,10 @@ class ConfigManager {
             if (!options.merchantKey || typeof options.merchantKey !== "string") {
                 throw new CoBuyInvalidConfigError('authMode="public" requires a valid merchantKey string');
             }
+            // Validate merchant key format
+            if (!validateMerchantKey(options.merchantKey)) {
+                throw new CoBuyInvalidConfigError("Invalid merchantKey format. Must be a non-empty string (max 500 chars)");
+            }
         }
         else if (authMode === "token") {
             if (!options.sessionToken) {
@@ -45,18 +417,29 @@ class ConfigManager {
             if (typeof options.sessionToken !== "string" && typeof options.sessionToken !== "function") {
                 throw new CoBuyInvalidConfigError("sessionToken must be a string or function that returns a string/Promise<string>");
             }
+            // Validate session token format
+            if (!validateSessionToken(options.sessionToken)) {
+                throw new CoBuyInvalidConfigError("Invalid sessionToken format. Must be a non-empty string or valid function");
+            }
         }
         else {
             throw new CoBuyInvalidConfigError(`Invalid authMode: ${authMode}. Must be "public" or "token"`);
         }
         // Set environment with default
         const env = options.env || "production";
-        // Set API base URL based on environment (computed internally)
-        const apiBaseUrl = ConfigManager.DEFAULT_API_URLS[env];
+        // Set API base URL based on environment, allow env override
+        const envOverride = ConfigManager.getApiBaseUrlOverride();
+        const apiBaseUrl = envOverride || ConfigManager.DEFAULT_API_URLS[env];
         // Theme configuration
         const theme = options.theme || {};
         // Debug flag
         const debug = options.debug || false;
+        // Performance configuration with defaults
+        const performance = {
+            requestTimeout: (_b = (_a = options.performance) === null || _a === void 0 ? void 0 : _a.requestTimeout) !== null && _b !== void 0 ? _b : 30000, // Default: 30 seconds
+            maxRetries: (_d = (_c = options.performance) === null || _c === void 0 ? void 0 : _c.maxRetries) !== null && _d !== void 0 ? _d : 2, // Default: 2 retries
+            animationSpeed: (_f = (_e = options.performance) === null || _e === void 0 ? void 0 : _e.animationSpeed) !== null && _f !== void 0 ? _f : "normal", // Default: normal speed
+        };
         // Create and store internal config
         this.config = {
             authMode,
@@ -68,16 +451,17 @@ class ConfigManager {
             theme,
             debug,
             events: options.events,
+            performance,
         };
         return this.config;
     }
     /**
      * Get current configuration
-     * @throws CoBuyNotInitializedError if SDK has not been initialized
+     * @throws {CoBuyNotInitializedError} if SDK has not been initialized
      */
     getConfig() {
         if (!this.config) {
-            throw new Error("CoBuy SDK has not been initialized. Call CoBuy.init(options) first.");
+            throw new CoBuyNotInitializedError();
         }
         return this.config;
     }
@@ -172,28 +556,161 @@ const ANIMATION_STYLES = {
     bouncy: { easing: "cubic-bezier(0.68, -0.55, 0.265, 1.55)", transform: "translateY(12px)" }, // Spring
 };
 /**
- * Merge global theme with optional widget-specific overrides
- * Priority: widgetTheme > globalTheme > defaults
+ * Merge global theme with widget-specific theme overrides
+ *
+ * Combines multiple theme objects with priority: widgetTheme > globalTheme > defaults.
+ * Validates all color and style values, falling back to defaults if invalid.
+ *
+ * @param {CoBuyThemeOptions} [globalTheme={}] - Global theme to apply to all widgets
+ * @param {string} [globalTheme.primaryColor] - Primary brand color (validated as CSS color)
+ * @param {string} [globalTheme.secondaryColor] - Secondary brand color
+ * @param {string} [globalTheme.textColor] - Text color for widget
+ * @param {string} [globalTheme.borderRadius] - Border radius for widget elements (CSS size value)
+ * @param {string} [globalTheme.fontFamily] - Font family for widget text
+ * @param {"none" | "fast" | "normal" | "slow"} [globalTheme.animationSpeed] - Animation speed
+ * @param {"none" | "subtle" | "smooth" | "bouncy"} [globalTheme.animationStyle] - Animation style
+ *
+ * @param {CoBuyThemeOptions} [widgetTheme={}] - Widget-specific theme overrides (takes priority over global)
+ * @param {string} [widgetTheme.primaryColor] - Override primary color
+ * @param {string} [widgetTheme.secondaryColor] - Override secondary color
+ * @param {string} [widgetTheme.textColor] - Override text color
+ * @param {string} [widgetTheme.borderRadius] - Override border radius
+ * @param {string} [widgetTheme.fontFamily] - Override font family
+ * @param {"none" | "fast" | "normal" | "slow"} [widgetTheme.animationSpeed] - Override animation speed
+ * @param {"none" | "subtle" | "smooth" | "bouncy"} [widgetTheme.animationStyle] - Override animation style
+ *
+ * @returns {Required<CoBuyThemeOptions>} Merged theme with all properties defined
+ *
+ * @description
+ * All theme values are validated:
+ * - Colors are checked against valid CSS color formats
+ * - Border radius is validated as a CSS size value
+ * - Font family is validated as a non-empty string
+ * - Animation speeds and styles are checked against allowed values
+ * - Invalid values are logged and replaced with defaults
+ *
+ * @example
+ * ```typescript
+ * // Merge global and widget themes
+ * const theme = mergeTheme(
+ *   {
+ *     primaryColor: '#4f46e5',
+ *     fontFamily: 'Inter, sans-serif'
+ *   },
+ *   {
+ *     primaryColor: '#ff0000' // Override primary color for this widget
+ *   }
+ * );
+ * // Result: theme.primaryColor === '#ff0000'
+ *
+ * // With invalid color (falls back to default)
+ * const theme2 = mergeTheme(
+ *   { primaryColor: 'notacolor' },
+ *   {}
+ * );
+ * // Result: theme2.primaryColor === '#4f46e5' (default value)
+ * ```
  */
 function mergeTheme(globalTheme = {}, widgetTheme = {}) {
-    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p;
+    var _a, _b, _c, _d, _e, _f, _g;
+    const logger = new Logger(false);
+    // Helper to validate and fallback to default
+    const getValidColor = (value, fallback) => {
+        if (!value)
+            return fallback;
+        if (validateColor(value))
+            return value;
+        logger.warn(`Invalid color value: ${value}, using default: ${fallback}`);
+        return fallback;
+    };
+    const getValidBorderRadius = (value, fallback) => {
+        if (!value)
+            return fallback;
+        if (validateBorderRadius(value))
+            return value;
+        logger.warn(`Invalid border radius: ${value}, using default: ${fallback}`);
+        return fallback;
+    };
+    const getValidFontFamily = (value, fallback) => {
+        if (!value)
+            return fallback;
+        if (validateFontFamily(value))
+            return value;
+        logger.warn(`Invalid font family: ${value}, using default: ${fallback}`);
+        return fallback;
+    };
+    const getValidAnimationSpeed = (value, fallback) => {
+        if (!value)
+            return fallback;
+        if (validateAnimationSpeed(value))
+            return value;
+        logger.warn(`Invalid animation speed: ${value}, using default: ${fallback}`);
+        return fallback;
+    };
+    const getValidAnimationStyle = (value, fallback) => {
+        if (!value)
+            return fallback;
+        if (validateAnimationStyle(value))
+            return value;
+        logger.warn(`Invalid animation style: ${value}, using default: ${fallback}`);
+        return fallback;
+    };
     return {
-        primaryColor: (_b = (_a = widgetTheme.primaryColor) !== null && _a !== void 0 ? _a : globalTheme.primaryColor) !== null && _b !== void 0 ? _b : DEFAULT_THEME.primaryColor,
-        secondaryColor: (_d = (_c = widgetTheme.secondaryColor) !== null && _c !== void 0 ? _c : globalTheme.secondaryColor) !== null && _d !== void 0 ? _d : DEFAULT_THEME.secondaryColor,
-        textColor: (_f = (_e = widgetTheme.textColor) !== null && _e !== void 0 ? _e : globalTheme.textColor) !== null && _f !== void 0 ? _f : DEFAULT_THEME.textColor,
-        borderRadius: (_h = (_g = widgetTheme.borderRadius) !== null && _g !== void 0 ? _g : globalTheme.borderRadius) !== null && _h !== void 0 ? _h : DEFAULT_THEME.borderRadius,
-        fontFamily: (_k = (_j = widgetTheme.fontFamily) !== null && _j !== void 0 ? _j : globalTheme.fontFamily) !== null && _k !== void 0 ? _k : DEFAULT_THEME.fontFamily,
-        animationSpeed: (_m = (_l = widgetTheme.animationSpeed) !== null && _l !== void 0 ? _l : globalTheme.animationSpeed) !== null && _m !== void 0 ? _m : DEFAULT_THEME.animationSpeed,
-        animationStyle: (_p = (_o = widgetTheme.animationStyle) !== null && _o !== void 0 ? _o : globalTheme.animationStyle) !== null && _p !== void 0 ? _p : DEFAULT_THEME.animationStyle,
+        primaryColor: getValidColor((_a = widgetTheme.primaryColor) !== null && _a !== void 0 ? _a : globalTheme.primaryColor, DEFAULT_THEME.primaryColor),
+        secondaryColor: getValidColor((_b = widgetTheme.secondaryColor) !== null && _b !== void 0 ? _b : globalTheme.secondaryColor, DEFAULT_THEME.secondaryColor),
+        textColor: getValidColor((_c = widgetTheme.textColor) !== null && _c !== void 0 ? _c : globalTheme.textColor, DEFAULT_THEME.textColor),
+        borderRadius: getValidBorderRadius((_d = widgetTheme.borderRadius) !== null && _d !== void 0 ? _d : globalTheme.borderRadius, DEFAULT_THEME.borderRadius),
+        fontFamily: getValidFontFamily((_e = widgetTheme.fontFamily) !== null && _e !== void 0 ? _e : globalTheme.fontFamily, DEFAULT_THEME.fontFamily),
+        animationSpeed: getValidAnimationSpeed((_f = widgetTheme.animationSpeed) !== null && _f !== void 0 ? _f : globalTheme.animationSpeed, DEFAULT_THEME.animationSpeed),
+        animationStyle: getValidAnimationStyle((_g = widgetTheme.animationStyle) !== null && _g !== void 0 ? _g : globalTheme.animationStyle, DEFAULT_THEME.animationStyle),
     };
 }
 /**
- * Apply theme to widget container using scoped CSS custom properties
- * This approach ensures:
- * 1. Styles are isolated to this widget instance
- * 2. No conflicts with merchant's global styles
- * 3. Easy runtime theme updates
- * 4. Browser handles invalid values gracefully
+ * Apply theme to widget container using CSS custom properties
+ *
+ * Sets scoped CSS variables on the container element to apply theme colors,
+ * sizing, fonts, and animations. This approach isolates styles to the widget
+ * instance and prevents conflicts with merchant's global styles.
+ *
+ * @param {HTMLElement} container - The DOM element to apply theme to
+ * @param {Required<CoBuyThemeOptions>} theme - The theme configuration to apply
+ * @param {string} theme.primaryColor - Primary brand color (applied to --cobuy-primary-color)
+ * @param {string} theme.secondaryColor - Secondary color (applied to --cobuy-secondary-color)
+ * @param {string} theme.textColor - Text color (applied to --cobuy-text-color)
+ * @param {string} theme.borderRadius - Border radius (applied to --cobuy-border-radius)
+ * @param {string} theme.fontFamily - Font family (applied to --cobuy-font-family)
+ * @param {AnimationSpeed} theme.animationSpeed - Animation speed for transitions
+ * @param {AnimationStyle} theme.animationStyle - Animation style/easing
+ *
+ * @returns {void}
+ *
+ * @description
+ * Sets the following CSS custom properties on the container:
+ * - `--cobuy-primary-color`: Primary brand color
+ * - `--cobuy-secondary-color`: Secondary color
+ * - `--cobuy-text-color`: Text color
+ * - `--cobuy-border-radius`: Border radius value
+ * - `--cobuy-font-family`: Font family stack
+ * - `--cobuy-animation-duration`: Duration in milliseconds
+ * - `--cobuy-animation-easing`: CSS easing function
+ * - `--cobuy-animation-transform`: CSS transform for animations
+ *
+ * @example
+ * ```typescript
+ * const container = document.getElementById('cobuy-widget');
+ * const theme = {
+ *   primaryColor: '#4f46e5',
+ *   secondaryColor: '#6366f1',
+ *   textColor: '#111827',
+ *   borderRadius: '8px',
+ *   fontFamily: 'Inter, sans-serif',
+ *   animationSpeed: 'normal',
+ *   animationStyle: 'smooth'
+ * };
+ *
+ * applyTheme(container, theme);
+ * // Now all widget styles use the applied theme colors and animations
+ * ```
  */
 function applyTheme(container, theme) {
     // Apply color and style CSS variables
@@ -705,8 +1222,26 @@ class GroupListModal {
     createHeader() {
         const header = document.createElement("div");
         header.className = "cobuy-group-list-header";
+        // Create logo container
+        const logoContainer = document.createElement("div");
+        logoContainer.className = "cobuy-group-list-logo-container";
+        logoContainer.innerHTML = `
+      <svg width="140" height="42" viewBox="0 0 168 50" fill="none" xmlns="http://www.w3.org/2000/svg" class="cobuy-group-list-logo">
+        <path d="M3.72838 4.40626H47.9605V44.91H3.72838V4.40626Z" fill="#FF8A15"/>
+        <path d="M5.82983 0.35607C3.45722 1.19213 1.8077 2.75127 0.632695 5.28205L0 6.61523V43.0178L0.858657 44.7351C1.85289 46.7461 3.47982 48.3731 5.49089 49.3673L6.77887 50H44.7406L45.9833 49.4125C47.7684 48.5764 49.3728 47.1981 50.2088 45.7971C51.655 43.3793 51.6324 43.6957 51.6324 24.4663C51.6324 5.50801 51.655 5.77917 50.367 3.74551C49.531 2.41233 48.1074 1.10175 46.9324 0.559436L45.8704 0.0623187L26.4376 0.0171262C8.22503 -0.0280662 6.93705 -0.00546998 5.82983 0.35607ZM24.4265 8.53591C25.466 8.98783 27.0025 10.095 27.7482 10.9085C27.9741 11.1571 28.4939 12.0157 28.878 12.8292C29.5559 14.2302 29.6011 14.4335 29.6011 16.8965C29.6011 19.2013 29.5333 19.6307 29.0362 20.6249C28.3131 22.1388 26.528 23.8562 24.7655 24.7374C23.4097 25.4379 23.1837 25.4831 21.0145 25.4831C18.8453 25.4831 18.6193 25.4379 17.2861 24.7374C14.3034 23.2235 12.6087 21.0768 11.976 18.0037C11.5693 16.1056 11.7274 15.0436 12.6991 12.8292C13.6255 10.7051 16.3597 8.62629 18.9356 8.08398C20.3818 7.76764 23.2515 7.9936 24.4265 8.53591ZM37.9391 24.3307C39.4756 25.0989 40.6958 26.3869 41.5093 28.1042C42.0968 29.3922 42.1872 29.7538 42.0968 31.087C41.916 34.0245 40.3569 36.4197 37.8035 37.5721C35.9506 38.4081 34.0299 38.5437 32.1996 37.911C30.4371 37.3235 29.5107 36.6456 28.5842 35.3125C26.4602 32.2394 26.7313 28.6466 29.2847 25.8672C30.7535 24.2855 32.403 23.6528 34.9112 23.7206C36.4025 23.7658 37.0804 23.9239 37.9391 24.3307ZM18.0996 28.8951C19.5006 29.2567 21.2631 30.8836 21.9861 32.4879C22.4155 33.4144 22.551 34.1374 22.5736 35.3125C22.5962 39.2216 19.6361 41.9557 15.5914 41.7072C13.7611 41.5942 12.8121 41.1649 11.4563 39.8769C9.24186 37.7302 8.94811 33.7081 10.8462 31.2451C12.4053 29.1889 15.388 28.2172 18.0996 28.8951Z" fill="#0157AA"/>
+        <path d="M70.6584 13.8234C67.4271 14.6143 63.8795 17.4388 62.5238 20.3085C61.4165 22.6586 61.055 24.5114 61.1906 27.4038C61.3714 31.3355 62.5238 33.9115 65.2579 36.4875C69.2574 40.2158 75.1325 40.9841 80.307 38.4307C81.4142 37.8658 82.4536 37.1427 83.2671 36.3067C84.7133 34.8379 85.9561 32.7817 85.4815 32.6009C85.3234 32.5557 84.1936 32.149 82.996 31.697L80.8041 30.9288L80.1036 31.923C78.3185 34.499 74.8613 35.7418 71.8786 34.8831C69.4834 34.1826 68.105 32.985 67.0204 30.6802C66.4781 29.5504 66.4329 29.1889 66.4329 26.6129C66.4329 23.9691 66.4781 23.698 67.0656 22.5004C67.8565 20.8735 69.6868 19.1787 71.2459 18.6138C73.0762 17.9811 75.4036 18.0263 76.9854 18.7494C78.4089 19.4047 79.9003 20.8057 80.3296 21.9129C80.5104 22.3196 80.6459 22.6812 80.6911 22.7263C80.8041 22.8845 85.3008 20.896 85.3008 20.6927C85.3008 20.5571 84.9844 19.8566 84.5777 19.1109C83.2445 16.6028 80.0358 14.2754 77.1887 13.733C75.5392 13.4167 72.1272 13.4845 70.6584 13.8234Z" fill="#032341"/>
+        <path d="M107.897 26.7259V39.5153L114.405 39.4476C120.641 39.3798 120.935 39.3572 122.246 38.8375C124.212 38.0466 126.042 36.1485 126.562 34.4086C127.014 32.8269 126.901 30.7028 126.313 29.5504C125.771 28.4658 124.46 27.11 123.398 26.5677L122.517 26.1158L123.172 25.7316C123.534 25.5057 124.144 24.9634 124.528 24.534C127.285 21.3932 125.839 16.7157 121.477 14.6595C120.212 14.072 120.167 14.072 114.066 14.0042L107.897 13.9364V26.7259ZM119.105 18.6816C120.438 19.2917 121.003 20.1052 121.003 21.461C121.003 22.4326 120.89 22.7037 120.257 23.3364C119.286 24.3081 118.224 24.5792 115.309 24.5792H112.868V21.4158V18.2523H115.535C117.613 18.2523 118.382 18.3427 119.105 18.6816ZM119.263 28.8951C119.76 29.0307 120.506 29.4826 120.958 29.8893C121.703 30.5672 121.794 30.7706 121.794 31.7648C121.794 33.1884 121.342 34.0019 120.212 34.5894C119.421 34.9961 118.901 35.0639 116.145 35.0639L112.981 35.0865L112.913 31.8552L112.846 28.6466H115.625C117.162 28.6466 118.788 28.7595 119.263 28.8951Z" fill="#032341"/>
+        <path d="M93.2773 20.8509C92.622 21.0316 91.6729 21.3932 91.1758 21.6417C89.8426 22.3196 87.9445 24.3533 87.1989 25.8446C86.5888 27.11 86.5436 27.336 86.5436 30.1153C86.5436 32.9624 86.5662 33.098 87.2667 34.5894C89.6167 39.5153 95.6047 41.3456 100.711 38.6567C102.564 37.6851 103.852 36.3293 104.824 34.2956C105.479 32.9172 105.524 32.6687 105.524 30.2283C105.524 27.7879 105.479 27.5393 104.824 26.1384C102.722 21.7095 98.0451 19.5855 93.2773 20.8509ZM98.61 25.6413C99.8302 26.4095 100.598 27.7653 100.802 29.5504C101.073 31.9682 100.147 33.7985 98.1806 34.8153C97.1186 35.3576 96.7571 35.448 95.6273 35.3576C93.0739 35.1317 91.4696 33.5273 91.2436 30.9288C90.8143 26.3417 94.9494 23.3816 98.61 25.6413Z" fill="#032341"/>
+        <path d="M129.409 27.9009L129.476 35.0865L130.109 36.3745C131.329 38.8826 133.679 40.148 136.459 39.8317C138.131 39.6509 139.396 39.1312 140.503 38.137L141.339 37.4139V38.4533V39.4927H143.938H146.537V30.1153V20.7379H144.006H141.452L141.52 26.3191C141.611 32.3297 141.498 33.1206 140.526 34.2956C139.69 35.2673 138.741 35.6966 137.453 35.6966C136.549 35.6966 136.165 35.561 135.51 35.0413C135.058 34.6572 134.561 34.0245 134.402 33.5951C134.222 33.0754 134.131 30.861 134.131 26.7711L134.109 20.7379H131.713H129.341L129.409 27.9009Z" fill="#032341"/>
+        <path d="M148.322 21.235C148.435 21.5287 149 22.9297 149.587 24.3533C150.175 25.7768 150.852 27.449 151.078 28.0816C151.282 28.6917 152.389 31.4937 153.519 34.2956L155.575 39.3572L155.123 40.5096C154.875 41.1197 154.242 42.837 153.677 44.3057L152.683 46.9721L155.168 46.9043L157.654 46.8365L159.281 42.7692C160.863 38.9052 167.28 22.6811 167.754 21.348L168.003 20.7379H165.337H162.693L161.699 23.4946C159.575 29.5052 157.993 33.2788 157.835 32.8269C156.479 29.1889 154.603 24.0595 154.084 22.5908L153.428 20.7379H150.785H148.118L148.322 21.235Z" fill="#032341"/>
+      </svg>
+    `;
         const title = document.createElement("h2");
         title.textContent = "Active Groups";
+        const titleContainer = document.createElement("div");
+        titleContainer.className = "cobuy-group-list-title-container";
+        titleContainer.appendChild(logoContainer);
+        titleContainer.appendChild(title);
         const actions = document.createElement("div");
         actions.className = "cobuy-group-list-actions";
         const liveBox = this.createLiveBox();
@@ -738,9 +1273,9 @@ class GroupListModal {
       </svg>
     `;
         closeBtn.addEventListener("click", () => this.close());
-        header.appendChild(title);
+        actions.appendChild(closeBtn);
+        header.appendChild(titleContainer);
         header.appendChild(actions);
-        header.appendChild(closeBtn);
         return header;
     }
     createLiveBox() {
@@ -788,7 +1323,7 @@ class GroupListModal {
             el.style.opacity = disabled ? "0.5" : "1";
             el.style.cursor = disabled ? "not-allowed" : "pointer";
             el.setAttribute("aria-disabled", disabled ? "true" : "false");
-            if (typeof el.disabled !== "undefined") {
+            if (el.disabled !== undefined) {
                 el.disabled = disabled;
             }
         });
@@ -818,7 +1353,7 @@ class GroupListModal {
     createGroupCard(group) {
         const card = document.createElement("div");
         card.className = "cobuy-group-card";
-        card.setAttribute("data-group-id", group.name || group.groupId);
+        card.dataset.groupId = group.name || group.groupId;
         const header = document.createElement("div");
         header.className = "cobuy-group-card-header";
         const groupId = document.createElement("div");
@@ -975,7 +1510,7 @@ class GroupListModal {
 
       .cobuy-group-list-header {
         display: flex;
-        align-items: center;
+        align-items: flex-start;
         gap: 18px;
         margin-bottom: 26px;
         position: relative;
@@ -989,6 +1524,25 @@ class GroupListModal {
         margin: 0;
       }
 
+      .cobuy-group-list-title-container {
+        display: flex;
+        flex-direction: column;
+        align-items: flex-start;
+        gap: 12px;
+      }
+
+      .cobuy-group-list-logo-container {
+        display: flex;
+        align-items: center;
+        flex-shrink: 0;
+      }
+
+      .cobuy-group-list-logo {
+        height: 42px;
+        width: auto;
+        display: block;
+      }
+
       .cobuy-group-list-actions {
         margin-left: auto;
         margin-right: 48px;
@@ -1317,6 +1871,17 @@ class GroupListModal {
           padding-right: 0;
         }
 
+        .cobuy-group-list-title-container {
+          flex-direction: column;
+          align-items: flex-start;
+          gap: 12px;
+          width: 100%;
+        }
+
+        .cobuy-group-list-logo {
+          height: 36px;
+        }
+
         .cobuy-group-list-header h2 {
           font-size: 28px;
         }
@@ -1514,41 +2079,12 @@ function isRedemptionValid(expiryDate) {
     }
 }
 
-function styleInject(css, ref) {
-  if ( ref === void 0 ) ref = {};
-  var insertAt = ref.insertAt;
-
-  if (typeof document === 'undefined') { return; }
-
-  var head = document.head || document.getElementsByTagName('head')[0];
-  var style = document.createElement('style');
-  style.type = 'text/css';
-
-  if (insertAt === 'top') {
-    if (head.firstChild) {
-      head.insertBefore(style, head.firstChild);
-    } else {
-      head.appendChild(style);
-    }
-  } else {
-    head.appendChild(style);
-  }
-
-  if (style.styleSheet) {
-    style.styleSheet.cssText = css;
-  } else {
-    style.appendChild(document.createTextNode(css));
-  }
-}
-
-var css_248z = ".cb-lobby-modal-container{height:100%;left:0;position:fixed;top:0;width:100%;z-index:10000}.cb-lobby-modal-container *{box-sizing:border-box;margin:0;padding:0}.cb-lobby-modal-container body,.cb-lobby-modal-container html{font-family:Inter,sans-serif;height:100%;overflow-x:hidden;width:100%}.cb-lobby-main{backdrop-filter:blur(4px);background-color:color-mix(in oklab,#fff 5%,transparent);border-radius:50px;box-shadow:0 25px 50px -12px #00000040;padding:80px;position:relative;width:100%;z-index:1}.cb-lobby-bg{background-image:url(https://cobuy-dev.s3.af-south-1.amazonaws.com/public/sdk/cb-back-image.png);background-position:50%;background-repeat:no-repeat;background-size:cover;height:100vh;left:0;position:fixed;top:0;width:100vw;z-index:-1}.cb-lobby-main-wp{align-items:center;display:flex;justify-content:center;padding:40px 80px}.lobby-indicator{backdrop-filter:blur(8px);background:rgba(16,185,129,.1);border:1px solid rgba(16,185,129,.3);border-radius:24px;gap:8px;margin-bottom:16px;padding:8px 16px;width:fit-content}.lobby-indicator,.pulsing-dot{align-items:center;display:flex}.pulsing-dot{height:8px;justify-content:center;position:relative;width:8px}.pulsing-dot:after{animation:pulse 2s cubic-bezier(.4,0,.6,1) infinite}.pulsing-dot:after,.pulsing-dot:before{background:#10b981;border-radius:50%;content:\"\";height:100%;position:absolute;width:100%}@keyframes pulse{0%,to{opacity:1}50%{opacity:.5}}.indicator-text{color:#047857;font-size:11px;font-weight:800;letter-spacing:.5px;line-height:1;text-transform:uppercase}.lobby-status-section{display:flex;flex-direction:column;margin-bottom:24px}.lobby-status{background:#fff;border-radius:4px;color:#000;font-size:10px;font-weight:600;line-height:1.2;padding:6px 10px;text-transform:uppercase}.lobby-status.active{background:#155dfc;color:#fff}.lobby-status.complete{background:#10b981;color:#fff}.lobby-status-wp{align-items:center;display:flex;flex-wrap:wrap;gap:10px}.lobby-number{backdrop-filter:blur(3px);background:hsla(0,0%,100%,.2);border-radius:4px;box-shadow:0 25px 50px -12px #00000040;font-size:12px;font-weight:700;letter-spacing:1px;line-height:1.2;padding:5px 8px;text-transform:uppercase}.title-wp{margin-top:25px}.title-wp h2{font-size:60px;font-weight:900;line-height:1;margin-bottom:15px}.sub-title{-webkit-text-fill-color:transparent;animation:gradient-flow 4s linear infinite;background-clip:text;-webkit-background-clip:text;background-image:linear-gradient(90deg,#1e293b,#2563eb 25%,#1e293b 50%);background-size:200% auto;color:#1e293b;font-size:16px;font-weight:700;line-height:1.5;margin-bottom:0}@keyframes gradient-flow{0%{background-position:200% 0}to{background-position:-200% 0}}.sub-title.completed{-webkit-text-fill-color:unset;background-clip:unset;-webkit-background-clip:unset;background-image:none;color:#1e293b}.connected-section{backdrop-filter:blur(4px);background:hsla(0,0%,100%,.05);border:1px solid hsla(0,0%,100%,.1);border-radius:24px;box-shadow:0 1px 2px 0 rgba(0,0,0,.05);display:flex;flex-direction:column;gap:20px;margin-top:24px;padding:24px;transition:all .3s ease}.connected-section:hover{background:hsla(0,0%,100%,.1);box-shadow:0 2px 4px 0 rgba(0,0,0,.08)}.link-share-container{display:flex;flex-direction:column}.link-share-wrapper{align-items:center;display:flex;gap:12px;width:100%}.lobby-link-box{align-items:center;backdrop-filter:blur(8px);background-color:hsla(0,0%,100%,.4);border:1px solid hsla(0,0%,100%,.3);border-radius:14px;box-shadow:0 1px 2px 0 rgba(0,0,0,.05);display:flex;flex:1;gap:16px;justify-content:space-between;min-height:50px;padding:16px 20px;transition:all .2s ease}.lobby-link-box:hover{background-color:hsla(0,0%,100%,.5);box-shadow:0 2px 4px 0 rgba(0,0,0,.08)}.lobby-link-text{color:#71717a;font-size:10px;font-weight:700;letter-spacing:.6px;line-height:1.2;margin-bottom:6px;text-transform:uppercase}.copy-link-btn{align-items:center;background:transparent;border:none;border-radius:6px;color:#64748b;cursor:pointer;display:flex;flex-shrink:0;font-size:13px;font-weight:600;gap:6px;justify-content:center;padding:0;transition:all .2s ease;white-space:nowrap}.copy-link-btn:hover{color:#1e293b}.copy-link-btn .copy-text{display:none}.copy-link-btn svg{flex-shrink:0;height:18px;width:18px}@media (min-width:640px){.copy-link-btn .copy-text{display:inline}}.lobby-link-url{color:#1e293b;font-size:15px;font-weight:700;line-height:1.4;word-break:break-all}.link-box-container{flex:1;min-width:0}.share-btn{align-items:center;background:#1e293b;border:none;border-radius:14px;box-shadow:0 2px 4px 0 rgba(0,0,0,.1);color:#fff;cursor:pointer;display:flex;flex-shrink:0;font-size:15px;font-weight:600;gap:8px;height:50px;justify-content:center;min-width:auto;padding:35px 24px;transition:all .2s ease}.share-btn .share-text{color:#fff;display:inline;font-size:15px}.share-btn svg{color:#fff}@media (max-width:640px){.share-btn{font-size:14px;height:50px;padding:0 18px}.share-btn .share-text{color:#fff;display:inline}}.share-btn:hover{background:#0f172a;box-shadow:0 4px 8px 0 rgba(0,0,0,.15);transform:translateY(-1px)}.share-btn:active{transform:scale(.95)}.share-btn svg{flex-shrink:0;height:18px;width:18px}.lobby-offer-box{align-items:center;backdrop-filter:blur(8px);background-color:rgba(59,130,246,.063);border:1px solid rgba(59,130,246,.125);border-radius:1rem;display:flex;gap:30px;margin-top:30px;padding:15px 20px}.offer-box-icon{align-items:center;background:linear-gradient(135deg,#3b82f6,rgba(59,130,246,.867));border-radius:10px;box-shadow:0 10px 15px -3px rgba(59,130,246,.314);color:#fff;cursor:pointer;display:flex;height:56px;justify-content:center;padding:5px;width:56px}.offer-lock-status{align-items:center;display:flex;gap:6px;margin-bottom:2px}.offer-lock-status span{font-size:14px;font-weight:700;line-height:1}.offer-box-content h3{font-size:30px;font-weight:900;line-height:1.2}.cb-lobby-top{display:grid;gap:100px;grid-template-columns:7fr 5fr}.group-info{backdrop-filter:blur(8px);background-color:color-mix(in oklab,#fff 5%,transparent);border-radius:20px;box-shadow:0 10px 15px -3px #0000001a;padding:30px}.progress-header{align-items:center;display:flex;justify-content:space-between;margin-bottom:14px}.progress-header .title{align-items:center;color:#000;display:flex;font-size:14px;font-weight:900;justify-content:center;letter-spacing:.7px;position:relative}.progress-badge{background:#3b82f6;border-radius:999px;box-shadow:0 4px 6px -1px #0000001a,0 2px 4px -2px #0000001a;color:#fff;font-size:13px;font-weight:700;padding:6px 12px}.cb-lobby-modal-container .progress-bar{background:#fff;border-radius:999px;height:14px;overflow:hidden;width:100%}.cb-lobby-modal-container .progress-fill{animation:shimmer 2.7s linear infinite;background:#3b82f6;background-image:linear-gradient(120deg,hsla(0,0%,100%,.15) 25%,hsla(0,0%,100%,.45) 37%,hsla(0,0%,100%,.15) 63%);background-size:200% 100%;border-radius:999px;height:100%;position:relative;transition:width .6s ease;width:0}@keyframes shimmer{0%{background-position:-200% 0}to{background-position:200% 0}}.progress-labels{color:#474d56;display:flex;font-size:12px;justify-content:space-between;margin-top:8px}.team-card{margin-top:40px}.team-card .icon-box svg{width:16px}.team-card .team-header{align-items:center;display:flex;justify-content:space-between}.team-card .team-title{align-items:center;display:flex;font-size:14px;font-weight:600;gap:12px;letter-spacing:1px}.team-card .icon-box{align-items:center;background-color:#3b82f6;border-radius:.5rem;box-shadow:0 10px 15px -3px #3b82f64d;color:#fff;display:flex;font-size:18px;height:2rem;justify-content:center;width:2rem}.team-card .team-title span{color:#000;font-size:14px;font-weight:900;letter-spacing:.7px}.team-card .team-count{background-color:#3b82f6;border-radius:9999px;box-shadow:0 4px 6px -1px #0000001a,0 2px 4px -2px #0000001a;color:#fff;font-size:13px;font-weight:700;letter-spacing:.7px;padding:6px 12px}.team-card .team-members{align-items:center;display:flex;gap:14px;justify-content:center;margin-top:20px}.team-card .member{border:3px solid #fff;border-radius:50%;box-shadow:0 4px 12px #0000001a;font-size:22px;height:56px;position:relative;width:56px}.team-card .member,.team-card .member:after{align-items:center;color:#fff;display:flex;justify-content:center}.team-card .member:after{background:#3b82f6;background-image:url(https://cobuy-dev.s3.af-south-1.amazonaws.com/public/sdk/tick-mark-icon.svg);background-position:50%;background-repeat:no-repeat;background-size:75%;border:2px solid #fff;border-radius:50%;bottom:-4px;content:\"\";height:12px;padding:2px;position:absolute;right:-4px;width:12px}.team-card .member.blue{background:#2563eb}.team-card .member.purple{background:#9333ea}.team-card .member.pink{background:#ec4899}.team-card .member.orange{background:#f97316}.team-card .member.empty{background:#f8fafc;color:#9ca3af}.team-card .member.empty:after{display:none}.time-card{align-items:center;backdrop-filter:blur(8px);background:hsla(0,0%,100%,.2);border:1px solid hsla(0,0%,100%,.2);border-radius:20px;display:flex;gap:14px;margin-top:30px;padding:15px}.time-card .time-icon{align-items:center;background:#3b82f6;border-radius:14px;color:#fff;display:flex;flex-shrink:0;font-size:22px;height:48px;justify-content:center;width:48px}.time-card .time-content{display:flex;flex-direction:column}.time-card .time-label{color:#4b5563;font-size:12px;font-weight:600;letter-spacing:.6px}.time-card .time-value{color:#111827;font-size:22px;font-weight:900}.group-info-box{backdrop-filter:blur(8px);background:color-mix(in oklab,#fff 5%,transparent);border:1px solid color-mix(in oklab,#fff 20%,transparent);border-radius:1.5rem;box-shadow:0 10px 15px -3px #0000001a;padding:30px}.offer-lock-status svg{height:16px;width:16px}.cb-lobby-modal-container .offer-box-content .reward-text{background:unset;border:none;color:#000;font-size:14px;line-height:1;margin-top:4px}.progress-header .title:before{background:#3b82f6;border-radius:50%;content:\"\";display:inline-block;height:8px;margin-right:8px;position:relative;width:8px}.live-activity-wrapper{backdrop-filter:blur(8px);background-color:color-mix(in oklab,#fff 80%,transparent);border-radius:18px;box-shadow:0 30px 80px rgba(0,0,0,.15);padding:16px}.live-activity-header{display:flex;gap:10px;justify-content:space-between;margin-bottom:12px}.live-activity-header .title{align-items:center;color:#000;display:flex;font-size:14px;font-weight:600;font-weight:900;gap:8px;letter-spacing:.7px}.live-activity-header .dot{background:#3b82f6;border-radius:50%;height:8px;position:relative;width:8px}.live-activity-header .dot:after{animation:livePulse 1.6s ease-out infinite;background:rgba(59,130,246,.6);border-radius:50%;content:\"\";inset:0;position:absolute}@keyframes livePulse{0%{opacity:.8;transform:scale(1)}70%{opacity:0;transform:scale(2.4)}to{opacity:0}}.activity-stats{align-items:center;display:flex;gap:8px}.activity-stats-badge{background-color:rgba(59,130,246,.082);border-radius:999px;color:#3b82f6;font-size:12px;font-weight:500;line-height:1;padding:4px 10px}.activity-stats-badge.light{background-color:#f9f3f4;color:#45556c}.activity-list{height:104px;overflow:hidden;position:relative}.activity-card{align-items:center;background:linear-gradient(90deg,#fff,#f2f6ff);border:1px solid #dbeafe;border-radius:14px;display:flex;gap:10px;height:58px;inset:0;padding:12px 10px;position:absolute;transition:transform .6s cubic-bezier(.22,.61,.36,1),opacity .6s}.activity-card .text{font-size:14px}.activity-card .avatar{align-items:center;border-radius:50%;color:#fff;display:flex;flex:0 0 30px;height:30px;justify-content:center;width:30px}.activity-card .pink{background:linear-gradient(135deg,#ec4899,#f472b6)}.activity-card .purple{background:linear-gradient(135deg,#8b5cf6,#a78bfa)}.activity-card .blue{background:linear-gradient(135deg,#3b82f6,#60a5fa)}.activity-card .green{background:linear-gradient(135deg,#10b981,#34d399)}.activity-card .orange{background:linear-gradient(135deg,#f97316,#fb923c)}.activity-card .text p{color:#6b7280;font-size:12px;margin:2px 0 0}.activity-card .time{color:#94a3b8;font-size:10px;margin-left:auto}.lobby-activity-wp{backdrop-filter:blur(12px);background-color:hsla(0,0%,100%,.4);border:1px solid hsla(0,0%,100%,.2);border-radius:25px;box-shadow:0 1px 3px 0 #0000001a;margin-top:50px;padding:8px}.lobby-close-icon{align-items:center;background-color:color-mix(in oklab,#000 80%,transparent);border-radius:50%;color:#fff;cursor:pointer;display:flex;height:34px;justify-content:center;position:fixed;right:30px;top:30px;width:34px;z-index:99}.lobby-close-icon svg{height:20px;width:20px}@media screen and (max-width:1600px){.cb-lobby-main{border-radius:30px;padding:50px}.title-wp h2{font-size:48px;margin-bottom:12px}.sub-title{font-size:16px}.title-wp{margin-top:20px}.lobby-link-section{margin-top:30px}.offer-box-content h3{font-size:26px}.lobby-offer-box{gap:24px;padding:15px}.cb-lobby-top{gap:80px}.group-info-box{border-radius:20px;padding:22px}.team-card{margin-top:30px}.team-card .team-members{margin-top:12px}.lobby-activity-wp{margin-top:40px}.lobby-close-icon{height:30px;top:20px;width:30px}}@media screen and (max-width:1280px){.cb-lobby-main,.cb-lobby-main-wp{padding:40px}.title-wp h2{font-size:42px}.cb-lobby-top{gap:60px}}@media screen and (max-width:1120px){.title-wp h2{font-size:38px}}@media screen and (max-width:991px){.cb-lobby-top{gap:30px;grid-template-columns:1fr}.cb-lobby-main{border-radius:15px;padding:30px}.cb-lobby-main-wp{padding:30px}.lobby-close-icon{right:20px}.lobby-link-box{border-radius:10px}.share-btn{border-radius:8px}.offer-box-content h3{font-size:24px}.lobby-activity-wp,.lobby-offer-box,.time-card{border-radius:15px;margin-top:20px}.live-activity-wrapper{border-radius:10px}.group-info-box{border-radius:15px}}@media screen and (max-width:575px){.cb-lobby-main,.cb-lobby-main-wp{padding:20px}.title-wp h2{font-size:30px}.lobby-link-text{font-size:11px;margin-bottom:4px}.lobby-link-url{font-size:14px}.lobby-link-box{min-height:48px;padding:12px 16px}.link-share-wrapper{gap:10px}.share-btn{border-radius:8px;font-size:13px;height:48px;min-width:auto;padding:0 14px}.lobby-offer-box{padding:10px}.offer-box-content h3{font-size:20px}.offer-box-content .reward-text{font-size:13px}.group-info-box{padding:13px}.progress-header .title,.team-card .team-title span{font-size:13px}.team-card .member{height:40px;width:40px}.team-card .member:after{height:8px;width:8px}.team-card .team-members{gap:10px;margin-top:12px}.time-card{padding:13px}.team-card{margin-top:22px}.activity-card .text{font-size:12px}.activity-card .text p{font-size:11px}.live-activity-header .title{font-size:12px}.time-card .time-value{font-size:20px}}@media screen and (max-width:480px){.cb-lobby-main-wp{padding:20px 12px}.cb-lobby-main{padding:15px 12px}.lobby-status{font-size:9px}.lobby-number{font-size:10px}.title-wp h2{font-size:28px;margin-bottom:7px}.sub-title{font-size:14px}.lobby-link-section{gap:10px;margin-top:20px}.lobby-offer-box{gap:12px}.offer-box-icon{height:45px;width:45px}.offer-box-content .reward-text,.offer-lock-status span{font-size:12px}.cb-lobby-top{gap:20px}.lobby-close-icon{right:10px;top:10px}.live-activity-header{flex-direction:column;gap:5px}.activity-card{border-radius:9px;padding:6px}}.share-overlay{align-items:center;background:rgba(0,0,0,.45);display:flex;inset:0;justify-content:center;opacity:0;position:fixed;transition:.3s ease;visibility:hidden;z-index:999}.share-overlay.active{opacity:1;visibility:visible}.share-popup{background:#fff;border-radius:18px;max-height:90%;overflow:auto;padding:24px;position:relative;transform:translateY(30px);transition:.35s ease;width:420px}.share-overlay.active .share-popup{transform:translateY(0)}.share-popup .close-btn{align-items:center;background:#f3f4f6;border:none;border-radius:50%;cursor:pointer;display:flex;height:32px;justify-content:center;position:absolute;right:14px;top:14px;transition:.3s;width:32px}.share-popup .close-btn:hover{background:#eeecec}.share-popup h2{font-size:22px;font-weight:600;line-height:1;margin-bottom:10px}.share-popup .subtitle{color:#4a5565;font-size:14px;margin:6px 0 30px}.share-popup .share-grid{display:grid;gap:14px;grid-template-columns:repeat(2,1fr)}.share-popup .share-card{align-items:center;background:#f2f6f9;border-radius:14px;cursor:pointer;display:flex;flex-direction:column;padding:16px;position:relative;text-align:center;transition:.25s ease}.share-popup .share-card:hover{transform:translateY(-3px)}.share-popup .share-card .icon{align-items:center;background:#1877f2;border-radius:50%;color:#fff;display:flex;font-size:30px;height:50px;justify-content:center;margin-bottom:8px;text-align:center;width:50px}.share-popup .share-card span{font-size:13px;font-weight:500}.share-popup .share-card.whatsapp{background:#ecfdf5;border:2px solid #22c55e;color:#22c55e}.share-popup .share-card.whatsapp .icon{background:#22c55e}.share-popup .share-card .badge{background:#2563eb;border-radius:12px;color:#fff;font-size:11px;padding:4px 10px;position:absolute;right:10px;top:-8px}.share-popup .link-box{background:#fbf9fa;border:1px solid #ebe6e7;border-radius:14px;margin-top:18px;padding:14px}.share-popup .link-box label{color:#64748b;font-size:13px}.share-popup .link-row{display:flex;gap:8px;margin-top:6px}.share-popup .link-row input{background:transparent;border:none;color:#334155;flex:1;font-size:13px;letter-spacing:.8px;line-height:1.2;outline:none}.share-popup .link-row button{align-items:center;background:#fff;border:1px solid #ebe6e7;border-radius:10px;cursor:pointer;display:flex;height:35px;justify-content:center;padding:6px 8px;width:35px}.share-popup .success{color:#2563eb;display:block;font-size:12px;margin-top:6px;opacity:0;transition:opacity .3s}.share-popup .success.show{opacity:1}.share-popup .footer-text{color:#64748b;font-size:12px;margin-top:14px;text-align:center}.share-popup .share-card.twitter .icon{background:#000}.share-popup .share-card.facebook .icon{background:#1877f2}.share-popup .share-card.sms .icon{background:#059669}.share-popup .share-card.copied .icon{background:#2563eb}@keyframes entrance-fade-in{0%{opacity:0}to{opacity:1}}@keyframes entrance-scale-in{0%{opacity:0;transform:scale(.9) translateY(20px)}to{opacity:1;transform:scale(1) translateY(0)}}@keyframes entrance-text-fade-in{0%{opacity:0}to{opacity:1}}@keyframes exit-blur-scale{0%{filter:blur(0);opacity:1;transform:scale(1)}to{filter:blur(10px);opacity:0;transform:scale(1.1)}}@keyframes pulse-dot{0%,to{opacity:1}50%{opacity:.5}}.entrance-animation-overlay{align-items:center;animation:entrance-fade-in .8s ease-in-out forwards;background-color:#0f172a;color:#fff;display:flex;flex-direction:column;inset:0;justify-content:center;position:fixed;z-index:9999}.entrance-animation-overlay.exit{animation:exit-blur-scale .8s ease-in-out forwards}.entrance-content{align-items:center;animation:entrance-scale-in .5s ease-out .2s both;display:flex;flex-direction:column}.entrance-icon-box{align-items:center;background:#2563eb;border-radius:16px;box-shadow:0 10px 25px rgba(37,99,235,.2);display:flex;height:64px;justify-content:center;margin-bottom:24px;width:64px}.entrance-icon-box svg{color:#fff;height:32px;width:32px}.entrance-title{font-size:32px;font-weight:700;letter-spacing:-.5px;margin-bottom:12px}@media (min-width:768px){.entrance-title{font-size:48px}}.entrance-message{align-items:center;animation:entrance-text-fade-in .5s ease-out .5s both;color:#60a5fa;display:flex;font-size:18px;font-weight:500;gap:8px}.entrance-pulse-dot{animation:pulse-dot 1.5s ease-in-out infinite;background-color:#60a5fa;border-radius:50%;height:8px;width:8px}";
-styleInject(css_248z,{"insertAt":"bottom"});
-
+/// <reference lib="dom" />
 /**
  * LobbyModal - Renders and manages the group buying lobby modal
  */
 class LobbyModal {
-    constructor(data, callbacks, apiClient, analyticsClient, socketManager = null, debug = false) {
+    constructor(data, callbacks, apiClient, socketManager = null, debug = false) {
         this.modalElement = null;
         this.timerInterval = null;
         this.activityInterval = null;
@@ -1556,21 +2092,7 @@ class LobbyModal {
         this.socketListenerRegistered = false;
         this.currentGroupId = null;
         this.shareOverlay = null;
-        /**
-         * Unsubscribe from socket events - testing out flow will remove once we have conviction
-         */
-        // private unsubscribeFromSocketEvents(): void {
-        //   if (typeof window === "undefined" || !this.socketListenerRegistered) {
-        //     return;
-        //   }
-        //   window.removeEventListener("group:fulfilled", this.handleSocketGroupUpdate as EventListener);
-        //   window.removeEventListener(
-        //     "group:member:joined",
-        //     this.handleSocketGroupUpdate as EventListener,
-        //   );
-        //   window.removeEventListener("group:created", this.handleSocketGroupUpdate as EventListener);
-        //   this.socketListenerRegistered = false;
-        // }
+        this.keyboardHandler = null;
         /**
          * Handle socket group update events
          */
@@ -1661,7 +2183,6 @@ class LobbyModal {
         };
         this.logger = new Logger(debug);
         this.apiClient = apiClient;
-        this.analyticsClient = analyticsClient;
         this.socketManager = socketManager;
         // Log the group data being passed into the modal
         this.logger.info("LobbyModal initialized with group data", {
@@ -1708,7 +2229,7 @@ class LobbyModal {
     getTitleText(data) {
         var _a, _b;
         const remainingRaw = ((_a = data.totalMembers) !== null && _a !== void 0 ? _a : 0) - ((_b = data.currentMembers) !== null && _b !== void 0 ? _b : 0);
-        const remaining = remainingRaw > 0 ? remainingRaw : 0;
+        const remaining = Math.max(0, remainingRaw);
         const unlocked = !this.computeIsLocked(data);
         if (unlocked) {
             return {
@@ -1836,7 +2357,7 @@ class LobbyModal {
     createModalStructure() {
         const modal = document.createElement("div");
         modal.className = "cb-lobby-modal-container";
-        modal.setAttribute("data-product-id", this.data.productId);
+        modal.dataset.productId = this.data.productId;
         // Background
         const background = document.createElement("div");
         background.className = "cb-lobby-bg";
@@ -1922,11 +2443,46 @@ class LobbyModal {
         // New "You are in the lobby" indicator badge
         const lobbyIndicator = document.createElement("div");
         lobbyIndicator.className = "lobby-indicator";
+        // Create logo SVG
+        const logoSvg = document.createElementNS("http://www.w3.org/2000/svg", "svg");
+        logoSvg.setAttribute("viewBox", "0 0 155 46");
+        logoSvg.setAttribute("width", "145");
+        logoSvg.setAttribute("height", "34");
+        logoSvg.setAttribute("class", "lobby-indicator-logo");
+        const path1 = document.createElementNS("http://www.w3.org/2000/svg", "path");
+        path1.setAttribute("d", "M3.43011 4.05376H44.1237V41.3172H3.43011V4.05376Z");
+        path1.setAttribute("fill", "#FF8A15");
+        const path2 = document.createElementNS("http://www.w3.org/2000/svg", "path");
+        path2.setAttribute("d", "M5.36344 0.327584C3.18065 1.09676 1.66308 2.53117 0.582079 4.85949L0 6.08601V39.5763L0.789965 41.1563C1.70466 43.0065 3.20144 44.5032 5.05162 45.4179L6.23656 46H41.1613L42.3047 45.4595C43.947 44.6903 45.423 43.4222 46.1921 42.1333C47.5226 39.909 47.5018 40.2 47.5018 22.509C47.5018 5.06737 47.5226 5.31683 46.3377 3.44586C45.5685 2.21934 44.2588 1.01361 43.1778 0.514681L42.2007 0.0573332L24.3226 0.0157561C7.56703 -0.0258209 6.38208 -0.00503238 5.36344 0.327584ZM22.4724 7.85303C23.4287 8.26881 24.8423 9.28744 25.5283 10.0358C25.7362 10.2645 26.2144 11.0545 26.5678 11.8029C27.1914 13.0917 27.233 13.2788 27.233 15.5448C27.233 17.6652 27.1706 18.0602 26.7133 18.9749C26.048 20.3677 24.4057 21.9477 22.7842 22.7584C21.5369 23.4029 21.329 23.4444 19.3333 23.4444C17.3376 23.4444 17.1298 23.4029 15.9032 22.7584C13.1591 21.3656 11.6 19.3907 11.0179 16.5634C10.6437 14.8172 10.7893 13.8401 11.6832 11.8029C12.5355 9.84873 15.0509 7.93619 17.4208 7.43726C18.7513 7.14622 21.3914 7.35411 22.4724 7.85303ZM34.904 22.3842C36.3176 23.091 37.4402 24.276 38.1886 25.8559C38.7291 27.0409 38.8122 27.3735 38.7291 28.6C38.5627 31.3025 37.1283 33.5061 34.7792 34.5663C33.0746 35.3355 31.3075 35.4602 29.6237 34.8781C28.0022 34.3376 27.1498 33.714 26.2975 32.4875C24.3434 29.6602 24.5928 26.3548 26.9419 23.7978C28.2932 22.3426 29.8108 21.7606 32.1183 21.8229C33.4903 21.8645 34.114 22.01 34.904 22.3842ZM16.6516 26.5835C17.9405 26.9161 19.562 28.4129 20.2273 29.8889C20.6222 30.7412 20.747 31.4064 20.7678 32.4875C20.7885 36.0839 18.0652 38.5993 14.3441 38.3706C12.6602 38.2667 11.7871 37.8717 10.5398 36.6867C8.50251 34.7118 8.23226 31.0115 9.9785 28.7455C11.4129 26.8538 14.157 25.9599 16.6516 26.5835Z");
+        path2.setAttribute("fill", "#0157AA");
+        const path3 = document.createElementNS("http://www.w3.org/2000/svg", "path");
+        path3.setAttribute("d", "M65.0057 12.7176C62.033 13.4451 58.7692 16.0437 57.5219 18.6839C56.5032 20.8459 56.1706 22.5505 56.2953 25.2115C56.4617 28.8287 57.5219 31.1986 60.0373 33.5685C63.7169 36.9986 69.1219 37.7054 73.8825 35.3563C74.9011 34.8366 75.8574 34.1713 76.6058 33.4021C77.9362 32.0509 79.0796 30.1591 78.643 29.9928C78.4975 29.9512 77.4581 29.5771 76.3563 29.1613L74.3398 28.4545L73.6954 29.3692C72.0531 31.7391 68.8724 32.8824 66.1283 32.0925C63.9247 31.448 62.6566 30.3462 61.6588 28.2258C61.1599 27.1864 61.1183 26.8538 61.1183 24.4839C61.1183 22.0516 61.1599 21.8021 61.7004 20.7003C62.428 19.2036 64.1118 17.6444 65.5462 17.1247C67.2301 16.5426 69.3713 16.5842 70.8265 17.2495C72.1362 17.8523 73.5083 19.1412 73.9032 20.1598C74.0695 20.534 74.1943 20.8667 74.2359 20.9082C74.3398 21.0538 78.4767 19.2244 78.4767 19.0373C78.4767 18.9125 78.1857 18.2681 77.8115 17.5821C76.585 15.2745 73.633 13.1333 71.0136 12.6344C69.4961 12.3434 66.357 12.4057 65.0057 12.7176Z");
+        path3.setAttribute("fill", "#032341");
+        const path4 = document.createElementNS("http://www.w3.org/2000/svg", "path");
+        path4.setAttribute("d", "M99.2654 24.5878V36.3541L105.252 36.2918C110.99 36.2294 111.26 36.2086 112.466 35.7305C114.275 35.0029 115.959 33.2566 116.437 31.6559C116.852 30.2007 116.749 28.2466 116.208 27.1864C115.709 26.1885 114.503 24.9412 113.526 24.4423L112.716 24.0265L113.318 23.6731C113.651 23.4652 114.212 22.9663 114.566 22.5713C117.102 19.6817 115.771 15.3785 111.759 13.4867C110.595 12.9462 110.554 12.9462 104.941 12.8839L99.2654 12.8215V24.5878ZM109.576 17.1871C110.803 17.7484 111.323 18.4968 111.323 19.7441C111.323 20.638 111.219 20.8875 110.637 21.4695C109.743 22.3634 108.766 22.6129 106.084 22.6129H103.839V19.7025V16.7921H106.292C108.204 16.7921 108.911 16.8753 109.576 17.1871ZM109.722 26.5835C110.179 26.7082 110.865 27.124 111.281 27.4982C111.967 28.1219 112.05 28.309 112.05 29.2237C112.05 30.5333 111.635 31.2817 110.595 31.8222C109.868 32.1964 109.389 32.2588 106.853 32.2588L103.943 32.2796L103.88 29.3068L103.818 26.3548H106.375C107.789 26.3548 109.285 26.4588 109.722 26.5835Z");
+        path4.setAttribute("fill", "#032341");
+        const path5 = document.createElementNS("http://www.w3.org/2000/svg", "path");
+        path5.setAttribute("d", "M85.8151 19.1827C85.2122 19.349 84.3391 19.6816 83.8818 19.9103C82.6552 20.534 80.909 22.4049 80.223 23.777C79.6617 24.9411 79.6201 25.149 79.6201 27.706C79.6201 30.3254 79.6409 30.4501 80.2854 31.8222C82.4474 36.3541 87.9563 38.0379 92.6545 35.5641C94.3592 34.6702 95.5441 33.4229 96.438 31.5519C97.0409 30.2838 97.0825 30.0551 97.0825 27.81C97.0825 25.5648 97.0409 25.3361 96.438 24.0472C94.5047 19.9727 90.2015 18.0186 85.8151 19.1827ZM90.7212 23.5899C91.8438 24.2967 92.5506 25.544 92.7377 27.1863C92.9872 29.4107 92.1348 31.0946 90.3262 32.03C89.3492 32.529 89.0165 32.6121 87.9771 32.529C85.628 32.3211 84.152 30.8451 83.9441 28.4544C83.5492 24.2343 87.3535 21.511 90.7212 23.5899Z");
+        path5.setAttribute("fill", "#032341");
+        const path6 = document.createElementNS("http://www.w3.org/2000/svg", "path");
+        path6.setAttribute("d", "M119.056 25.6689L119.118 32.2796L119.7 33.4646C120.823 35.7721 122.985 36.9363 125.542 36.6452C127.08 36.4789 128.244 36.0008 129.263 35.0861L130.032 34.4209V35.3771V36.3334H132.423H134.814V27.7062V19.0789H132.485H130.136L130.199 24.2137C130.282 29.7434 130.178 30.471 129.284 31.552C128.515 32.446 127.642 32.8409 126.457 32.8409C125.625 32.8409 125.272 32.7162 124.669 32.2381C124.253 31.8847 123.796 31.3026 123.65 30.9076C123.484 30.4295 123.401 28.3922 123.401 24.6295L123.38 19.0789H121.176H118.994L119.056 25.6689Z");
+        path6.setAttribute("fill", "#032341");
+        const path7 = document.createElementNS("http://www.w3.org/2000/svg", "path");
+        path7.setAttribute("d", "M136.456 19.5361C136.56 19.8063 137.08 21.0952 137.62 22.4049C138.161 23.7146 138.784 25.2529 138.992 25.835C139.179 26.3963 140.198 28.9741 141.237 31.5519L143.129 36.2085L142.713 37.2687C142.485 37.83 141.902 39.4099 141.383 40.7612L140.468 43.2142L142.755 43.1519L145.042 43.0895L146.538 39.3476C147.994 35.7927 153.897 20.8666 154.334 19.64L154.563 19.0787H152.11H149.677L148.763 21.6149C146.809 27.1447 145.353 30.6164 145.208 30.2006C143.961 26.8537 142.235 22.1347 141.757 20.7834L141.154 19.0787H138.722H136.269L136.456 19.5361Z");
+        path7.setAttribute("fill", "#032341");
+        logoSvg.appendChild(path1);
+        logoSvg.appendChild(path2);
+        logoSvg.appendChild(path3);
+        logoSvg.appendChild(path4);
+        logoSvg.appendChild(path5);
+        logoSvg.appendChild(path6);
+        logoSvg.appendChild(path7);
         const pulsingDot = document.createElement("div");
         pulsingDot.className = "pulsing-dot";
         const indicatorText = document.createElement("span");
         indicatorText.className = "indicator-text";
         indicatorText.textContent = "YOU ARE IN THE LOBBY";
+        lobbyIndicator.appendChild(logoSvg);
         lobbyIndicator.appendChild(pulsingDot);
         lobbyIndicator.appendChild(indicatorText);
         // Status row with badge and group number
@@ -2636,7 +3192,6 @@ class LobbyModal {
             const dy = firstRects[i].top - lastRects[i].top;
             card.style.transition = "none";
             card.style.transform = `translate(${dx}px, ${dy}px)`;
-            card.offsetHeight; // Force reflow
             card.style.transition = "transform 300ms cubic-bezier(.22,.61,.36,1), opacity 600ms";
         });
         requestAnimationFrame(() => this.layoutActivityCards());
@@ -3004,11 +3559,74 @@ class LobbyModal {
             // Start timers and animations
             this.startTimer();
             this.startActivityAnimation();
-            // Track analytics
-            if (this.analyticsClient) ;
             this.logger.info(`Lobby modal opened for product: ${this.data.productId}`);
+            // Set up keyboard accessibility (focus trap, ESC to close)
+            this.setupKeyboardAccessibility();
         });
     }
+    /**
+     * Set up keyboard accessibility features: ESC to close and Tab focus trap
+     */
+    setupKeyboardAccessibility() {
+        if (!this.modalElement)
+            return;
+        // ESC key to close modal
+        this.keyboardHandler = (event) => {
+            if (event.key === "Escape" || event.key === "Esc") {
+                event.preventDefault();
+                this.close();
+                return;
+            }
+            // Tab focus trap: keep focus within modal
+            if (event.key === "Tab") {
+                const focusableElements = this.getFocusableElements();
+                if (focusableElements.length === 0)
+                    return;
+                const firstElement = focusableElements[0];
+                const lastElement = focusableElements[focusableElements.length - 1];
+                const activeElement = document.activeElement;
+                if (event.shiftKey) {
+                    // SHIFT+TAB pressed - move backwards
+                    if (activeElement === firstElement) {
+                        event.preventDefault();
+                        lastElement.focus();
+                    }
+                }
+                else if (activeElement === lastElement) {
+                    // TAB pressed - move forwards
+                    event.preventDefault();
+                    firstElement.focus();
+                }
+            }
+        };
+        document.addEventListener("keydown", this.keyboardHandler);
+        this.modalElement.setAttribute("role", "dialog");
+        this.modalElement.setAttribute("aria-modal", "true");
+        this.modalElement.setAttribute("aria-label", "Group lobby");
+    }
+    /**
+     * Get all focusable elements within the modal
+     */
+    getFocusableElements() {
+        if (!this.modalElement)
+            return [];
+        const focusableSelectors = [
+            "button",
+            "a[href]",
+            "input:not([disabled])",
+            "[tabindex]:not([tabindex='-1'])",
+        ];
+        return Array.from(this.modalElement.querySelectorAll(focusableSelectors.join(", ")));
+    }
+    /**
+     * Clean up keyboard event listeners
+     */
+    removeKeyboardAccessibility() {
+        if (this.keyboardHandler) {
+            document.removeEventListener("keydown", this.keyboardHandler);
+            this.keyboardHandler = null;
+        }
+    }
     /**
      * Close the modal
      */
@@ -3020,16 +3638,11 @@ class LobbyModal {
         // Stop timers and animations
         this.stopTimer();
         this.stopActivityAnimation();
-        // // Unsubscribe from socket events and group - testing out flow will remove once we have conviction
-        // this.unsubscribeFromSocketEvents();
-        // if (this.socketManager && this.currentGroupId) {
-        //   this.socketManager.unsubscribeFromGroup(this.currentGroupId);
-        // }
+        // Remove keyboard event listeners
+        this.removeKeyboardAccessibility();
         // Remove modal from DOM
         document.body.removeChild(this.modalElement);
         this.modalElement = null;
-        // Track analytics
-        if (this.analyticsClient) ;
         // Call callback
         if (this.callbacks.onClose) {
             this.callbacks.onClose();
@@ -3213,8 +3826,8 @@ class LobbyModal {
             "orange",
         ];
         const randomColor = colors[Math.floor(Math.random() * colors.length)];
-        let emoji = "👤";
-        let action = "joined the group";
+        let emoji;
+        let action;
         switch (eventType) {
             case "group:member:joined":
                 emoji = "👤";
@@ -3690,6 +4303,7 @@ class OfflineRedemptionModal {
 }
 
 /// <reference lib="dom" />
+let skeletonStylesInjected = false;
 /**
  * Widget state enumeration for tracking render lifecycle
  */
@@ -3703,10 +4317,15 @@ var WidgetState;
  * WidgetRoot handles rendering of the CoBuy widget into a DOM container
  */
 class WidgetRoot {
+    /**
+     * Get max retries from config (configurable via performance options)
+     */
+    get MAX_RETRIES() {
+        return this.config.performance.maxRetries;
+    }
     constructor(config, apiClient, analyticsClient = null) {
         this.state = WidgetState.LOADING;
         this.retryCount = 0;
-        this.MAX_RETRIES = 1;
         this.currentProductId = null;
         this.currentContainer = null;
         this.debouncedCTAClick = null;
@@ -3725,6 +4344,15 @@ class WidgetRoot {
         this.groupExpiryRefreshTriggered = false; // Track if expiry refresh already triggered for current group
         this.offlineRedemption = null;
         this.offlineRedemptionModal = null;
+        this.isRendering = false;
+        this.renderPromise = null;
+        this.liveRegionAnnouncer = null;
+        // Request deduplication for rapid re-renders
+        this.lastRenderedProductId = null;
+        this.lastRenderedContainer = null;
+        this.renderDebounceTimer = null;
+        this.pendingRenderOptions = null;
+        this.RENDER_DEBOUNCE_MS = 300; // 300ms debounce for rapid re-renders
         /** Handle backend fulfillment notifications */
         this.handleGroupFulfilledEvent = (event) => {
             const detail = event.detail;
@@ -3832,7 +4460,7 @@ class WidgetRoot {
                 }
                 else if (this.currentGroupData) {
                     // Check if data actually changed using participant count
-                    const currentParticipants = groupContainer.getAttribute("data-participants");
+                    const currentParticipants = groupContainer.dataset.participants;
                     const newParticipants = String(this.currentGroupData.participants_count || 0);
                     if (currentParticipants !== newParticipants) {
                         // Data changed, re-render
@@ -3840,7 +4468,7 @@ class WidgetRoot {
                         const groupEl = this.renderGroupInfo();
                         if (groupEl) {
                             // Store current participants for next diff
-                            groupContainer.setAttribute("data-participants", newParticipants);
+                            groupContainer.dataset.participants = newParticipants;
                             groupContainer.style.display = "";
                             groupContainer.appendChild(groupEl);
                         }
@@ -3851,6 +4479,10 @@ class WidgetRoot {
                     groupContainer.style.display = "none";
                 }
             }
+            else {
+                const selector = typeof options.groupContainer === "string" ? options.groupContainer : "<HTMLElement>";
+                this.logger.warn(`CoBuy: groupContainer not found for ${selector} - skipping update`);
+            }
         }
         if (options.rewardContainer) {
             const rewardContainer = this.resolveContainer(options.rewardContainer);
@@ -3869,6 +4501,10 @@ class WidgetRoot {
                     rewardContainer.style.display = "none";
                 }
             }
+            else {
+                const selector = typeof options.rewardContainer === "string" ? options.rewardContainer : "<HTMLElement>";
+                this.logger.warn(`CoBuy: rewardContainer not found for ${selector} - skipping update`);
+            }
         }
         // Main widget container should stay hidden if we have no data
         if (!this.currentGroupData && !this.groupFulfilled) {
@@ -3914,6 +4550,12 @@ class WidgetRoot {
                     groupContainer.appendChild(groupEl);
                 }
             }
+            else {
+                const selector = typeof this.currentOptions.groupContainer === "string"
+                    ? this.currentOptions.groupContainer
+                    : "<HTMLElement>";
+                this.logger.warn(`CoBuy: groupContainer not found for ${selector} - skipping fulfilled render`);
+            }
         }
         if (this.currentOptions.rewardContainer) {
             const rewardContainer = this.resolveContainer(this.currentOptions.rewardContainer);
@@ -3922,6 +4564,12 @@ class WidgetRoot {
                 rewardContainer.innerHTML = "";
                 rewardContainer.textContent = rewardText;
             }
+            else {
+                const selector = typeof this.currentOptions.rewardContainer === "string"
+                    ? this.currentOptions.rewardContainer
+                    : "<HTMLElement>";
+                this.logger.warn(`CoBuy: rewardContainer not found for ${selector} - skipping reward render`);
+            }
         }
     }
     /** Render group info element with progress and countdown */
@@ -3936,8 +4584,8 @@ class WidgetRoot {
         // Match static HTML structure: cobuy-progress container
         const root = document.createElement("div");
         root.className = "cobuy-progress";
-        root.setAttribute("data-current", String(participants));
-        root.setAttribute("data-target", String(max));
+        root.dataset.current = String(participants);
+        root.dataset.target = String(max);
         // Progress header with two spans
         const header = document.createElement("div");
         header.className = "progress-header";
@@ -3961,7 +4609,7 @@ class WidgetRoot {
         const expiry = Date.parse(data.expiry_at);
         this.updateTimer(progressText, expiry, remaining);
         const interval = window.setInterval(() => this.updateTimer(progressText, expiry, remaining), 1000);
-        progressText.setAttribute("data-timer-id", String(interval));
+        progressText.dataset.timerId = String(interval);
         root.appendChild(header);
         root.appendChild(progressBar);
         // Create footer with timer on left and View all Groups link on right
@@ -4135,7 +4783,7 @@ class WidgetRoot {
                     totalMembers: joinData.group.max_participants,
                     timeLeft: joinData.group.timeLeftSeconds,
                 };
-                const lobbyModal = new LobbyModal(lobbyData, {}, null, null, null, this.config.debug);
+                const lobbyModal = new LobbyModal(lobbyData, {}, null, null, this.config.debug);
                 lobbyModal.open(joinData.group.id);
             });
             // Set callback for viewing progress on already joined group
@@ -4152,7 +4800,7 @@ class WidgetRoot {
                     currentMembers: groupData.joined,
                     totalMembers: groupData.total,
                 };
-                const lobbyModal = new LobbyModal(lobbyData, {}, null, null, null, this.config.debug);
+                const lobbyModal = new LobbyModal(lobbyData, {}, null, null, this.config.debug);
                 lobbyModal.open(groupId);
             });
         }
@@ -4160,21 +4808,104 @@ class WidgetRoot {
     }
     /**
      * Render the widget into the specified container
+     *
+     * Asynchronous method that renders the collaborative buying widget.
+     * Automatically fetches product data, groups, and set up event listeners.
+     * Includes request deduplication to prevent redundant API calls from rapid re-renders
+     * (e.g., React component re-rendering).
+     *
+     * @param {RenderWidgetOptions} options - Widget rendering options
+     * @returns {Promise<void>} Rejects if rendering fails
+     *
+     * @throws {CoBuyRenderError} If container not found or rendering fails
+     * @throws {CoBuyValidationError} If productId validation fails
+     *
+     * @example
+     * ```typescript
+     * try {
+     *   const widget = new WidgetRoot(config, apiClient, analyticsClient);
+     *   await widget.render({
+     *     productId: 'prod_123',
+     *     container: '#widget-container'
+     *   });
+     * } catch (error) {
+     *   if (error instanceof CoBuyRenderError) {
+     *     console.error('Widget render failed:', error.message);
+     *   }
+     * }
+     * ```
      */
     async render(options) {
-        var _a, _b, _c, _d, _e;
+        // Request deduplication: Skip render if nothing changed
+        const resolvedContainer = this.resolveContainer(options.container);
+        const isDuplicate = this.lastRenderedProductId === options.productId &&
+            this.lastRenderedContainer === resolvedContainer;
+        if (isDuplicate) {
+            this.logger.debug(`[Dedup] Skipping duplicate render for productId=${options.productId}`);
+            return;
+        }
+        // Clear previous debounce timer if exists
+        if (this.renderDebounceTimer) {
+            clearTimeout(this.renderDebounceTimer);
+            this.renderDebounceTimer = null;
+        }
+        // Store pending options and debounce the actual render
+        this.pendingRenderOptions = options;
+        this.renderDebounceTimer = setTimeout(() => {
+            this.renderDebounceTimer = null;
+            if (this.pendingRenderOptions) {
+                const opts = this.pendingRenderOptions;
+                this.pendingRenderOptions = null;
+                void this.doQueuedRender(opts);
+            }
+        }, this.RENDER_DEBOUNCE_MS);
+    }
+    /**
+     * Queued render that handles concurrent render protection
+     */
+    async doQueuedRender(options) {
+        if (this.isRendering) {
+            this.logger.debug("Render already in progress, queuing request");
+            if (this.renderPromise) {
+                await this.renderPromise;
+            }
+            // After current render completes, try again with latest options
+            return this.doQueuedRender(options);
+        }
+        this.isRendering = true;
+        this.renderPromise = this.doRender(options);
+        try {
+            await this.renderPromise;
+            // Update deduplication tracking after successful render
+            const resolvedContainer = this.resolveContainer(options.container);
+            this.lastRenderedProductId = options.productId;
+            this.lastRenderedContainer = resolvedContainer;
+        }
+        finally {
+            this.isRendering = false;
+            this.renderPromise = null;
+        }
+    }
+    async doRender(options) {
+        var _a, _b, _c, _d, _e, _f;
         try {
             // Resolve container
             const container = this.resolveContainer(options.container);
             if (!container) {
                 const selector = typeof options.container === "string" ? options.container : "<HTMLElement>";
-                const errorMessage = `CoBuy: container not found for ${selector}`;
+                const errorMessage = `Container not found for selector: ${selector}`;
                 this.logger.error(errorMessage);
-                const error = new Error(errorMessage);
-                (_a = options.onError) === null || _a === void 0 ? void 0 : _a.call(options, error);
-                throw error;
+                (_a = options.onError) === null || _a === void 0 ? void 0 : _a.call(options, new Error(errorMessage));
+                throw new CoBuyRenderError(errorMessage, { selector });
             }
-            // Track current render context
+            // Validate product ID format
+            if (!validateProductId(options.productId)) {
+                const errorMessage = `Invalid productId format. Must be a non-empty string (max 200 chars): ${options.productId}`;
+                this.logger.error(errorMessage);
+                (_b = options.onError) === null || _b === void 0 ? void 0 : _b.call(options, new Error(errorMessage));
+                throw new CoBuyValidationError(errorMessage, { productId: options.productId });
+            }
+            // Track current render context
             this.currentOptions = options;
             this.currentProductId = options.productId;
             this.groupFulfilled = false;
@@ -4185,7 +4916,7 @@ class WidgetRoot {
             // Listen for realtime fulfillment updates once per page
             this.subscribeToSocketEvents();
             // Host safety + idempotency markers
-            container.setAttribute("data-cobuy-mounted", "true");
+            container.dataset.cobuyMounted = "true";
             container.style.maxWidth = "100%";
             container.style.width = "100%";
             container.style.boxSizing = "border-box";
@@ -4204,20 +4935,30 @@ class WidgetRoot {
             this.state = WidgetState.LOADING;
             this.retryCount = 0;
             // Emit loading event
-            (_c = (_b = this.events) === null || _b === void 0 ? void 0 : _b.onLoading) === null || _c === void 0 ? void 0 : _c.call(_b, options.productId);
+            (_d = (_c = this.events) === null || _c === void 0 ? void 0 : _c.onLoading) === null || _d === void 0 ? void 0 : _d.call(_c, options.productId);
             // Render skeleton loading state for widget
             this.renderSkeleton(container);
             // Render skeleton for group info in separate container if provided
             if (options.groupContainer) {
                 const groupContainer = this.resolveContainer(options.groupContainer);
-                if (groupContainer) {
+                if (!groupContainer) {
+                    const selector = typeof options.groupContainer === "string" ? options.groupContainer : "<HTMLElement>";
+                    const errorMessage = `CoBuy: groupContainer not found for ${selector}`;
+                    this.logger.warn(errorMessage);
+                }
+                else {
                     this.renderGroupSkeleton(groupContainer);
                 }
             }
             // Render skeleton for reward text in separate container if provided
             if (options.rewardContainer) {
                 const rewardContainer = this.resolveContainer(options.rewardContainer);
-                if (rewardContainer) {
+                if (!rewardContainer) {
+                    const selector = typeof options.rewardContainer === "string" ? options.rewardContainer : "<HTMLElement>";
+                    const errorMessage = `CoBuy: rewardContainer not found for ${selector}`;
+                    this.logger.warn(errorMessage);
+                }
+                else {
                     this.renderRewardSkeleton(rewardContainer);
                 }
             }
@@ -4230,6 +4971,13 @@ class WidgetRoot {
                 this.currentGroupData = groupData;
                 this.currentGroupId = (groupData === null || groupData === void 0 ? void 0 : groupData.id) || null;
                 this.currentRewardData = rewardData;
+                // Explicitly set state based on fetch result
+                if (rewardData) {
+                    this.state = WidgetState.LOADED;
+                }
+                else {
+                    this.state = WidgetState.ERROR;
+                }
                 console.log("group data for product ", options.productId, groupData === null || groupData === void 0 ? void 0 : groupData.offline_redemption, isValidOfflineRedemption(groupData === null || groupData === void 0 ? void 0 : groupData.offline_redemption));
                 // Extract offline_redemption from API response if available
                 if ((groupData === null || groupData === void 0 ? void 0 : groupData.offline_redemption) &&
@@ -4249,6 +4997,10 @@ class WidgetRoot {
             else {
                 this.state = WidgetState.LOADED;
             }
+            if (typeof document !== "undefined" && !document.body.contains(container)) {
+                this.logger.warn("Container removed from DOM, aborting render");
+                return;
+            }
             // Render group info in separate container if provided
             if (options.groupContainer) {
                 const groupContainer = this.resolveContainer(options.groupContainer);
@@ -4269,6 +5021,11 @@ class WidgetRoot {
                         groupContainer.style.display = "none";
                     }
                 }
+                else {
+                    // Warn if container was specified but not found
+                    const selector = typeof options.groupContainer === "string" ? options.groupContainer : "<HTMLElement>";
+                    this.logger.warn(`CoBuy: groupContainer not found for ${selector} - skipping group render`);
+                }
             }
             // Render reward text in separate container if provided and we have group data
             if (options.rewardContainer) {
@@ -4285,9 +5042,13 @@ class WidgetRoot {
                         rewardContainer.style.display = "none";
                     }
                 }
+                else {
+                    // Warn if container was specified but not found
+                    const selector = typeof options.rewardContainer === "string" ? options.rewardContainer : "<HTMLElement>";
+                    this.logger.warn(`CoBuy: rewardContainer not found for ${selector} - skipping reward render`);
+                }
             }
             // Render widget or error based on final state
-            // Note: state may be ERROR after fetchRewardWithRetry despite TypeScript's flow analysis
             if (this.state === WidgetState.ERROR) {
                 this.renderError(container);
             }
@@ -4305,7 +5066,7 @@ class WidgetRoot {
         catch (error) {
             this.logger.error("Failed to render widget", error);
             this.state = WidgetState.ERROR;
-            (_e = (_d = this.events) === null || _d === void 0 ? void 0 : _d.onError) === null || _e === void 0 ? void 0 : _e.call(_d, options.productId, error);
+            (_f = (_e = this.events) === null || _e === void 0 ? void 0 : _e.onError) === null || _f === void 0 ? void 0 : _f.call(_e, options.productId, error);
             if (options.onError) {
                 options.onError(error);
             }
@@ -4316,12 +5077,15 @@ class WidgetRoot {
     }
     /**
      * Fetch reward data with automatic retry on failure
+     *
+     * @param productId The product ID to fetch reward for
+     * @returns Promise with reward data on success, null on failure
+     * @internal State updates (LOADED/ERROR) are handled by the caller
      */
     async fetchRewardWithRetry(productId) {
         var _a, _b, _c, _d;
         try {
             const reward = await this.fetchReward(productId);
-            this.state = WidgetState.LOADED;
             this.logger.info("Reward data fetched successfully");
             (_b = (_a = this.events) === null || _a === void 0 ? void 0 : _a.onLoaded) === null || _b === void 0 ? void 0 : _b.call(_a, productId, reward);
             return reward;
@@ -4330,10 +5094,10 @@ class WidgetRoot {
             if (this.retryCount < this.MAX_RETRIES) {
                 this.retryCount++;
                 this.logger.info(`Retrying reward fetch (${this.retryCount}/${this.MAX_RETRIES})`, error);
-                // Immediate retry
+                // Immediate retry - don't set error state yet
                 return this.fetchRewardWithRetry(productId);
             }
-            this.state = WidgetState.ERROR;
+            // Final failure - caller will set ERROR state based on null return
             this.logger.error("Failed to fetch reward after retries", error);
             (_d = (_c = this.events) === null || _c === void 0 ? void 0 : _c.onError) === null || _d === void 0 ? void 0 : _d.call(_c, productId, error);
             return null;
@@ -4371,8 +5135,9 @@ class WidgetRoot {
      */
     renderSkeleton(container) {
         // Inject animations once
-        const shimmerStyle = document.createElement("style");
-        shimmerStyle.textContent = `
+        if (!skeletonStylesInjected && !document.querySelector("#cobuy-shimmer-style")) {
+            const shimmerStyle = document.createElement("style");
+            shimmerStyle.textContent = `
       @keyframes cobuy-shimmer {
         0% { background-position: -200px 0; }
         100% { background-position: calc(200px + 100%) 0; }
@@ -4395,10 +5160,12 @@ class WidgetRoot {
         background-size: 200px 100%;
       }
     `;
-        if (!document.querySelector("#cobuy-shimmer-style")) {
             shimmerStyle.id = "cobuy-shimmer-style";
             document.head.appendChild(shimmerStyle);
         }
+        if (!skeletonStylesInjected) {
+            skeletonStylesInjected = true;
+        }
         // Button placeholder only - reward text is rendered in a separate container
         const buttonPlaceholder = document.createElement("div");
         buttonPlaceholder.className = "cobuy-skeleton-button";
@@ -4414,6 +5181,8 @@ class WidgetRoot {
             "cobuy-fadeIn var(--cobuy-animation-duration, 300ms) var(--cobuy-animation-easing, ease-out) forwards 100ms";
         container.innerHTML = "";
         container.appendChild(buttonPlaceholder);
+        // Announce to screen readers that content is loading
+        this.announceToScreenReaders("Loading CoBuy offer");
     }
     /**
      * Render skeleton loading state for group info in separate container
@@ -4567,6 +5336,8 @@ class WidgetRoot {
         container.innerHTML = "";
         container.appendChild(message);
         container.appendChild(retryButton);
+        // Announce error to screen readers
+        this.announceToScreenReaders("Error: Unable to load CoBuy offer. Use the retry button to try again.");
     }
     /**
      * Handle retry button click - reset retry count and re-fetch
@@ -4586,12 +5357,9 @@ class WidgetRoot {
         this.renderSkeleton(this.currentContainer);
         const rewardData = await this.fetchRewardWithRetry(this.currentProductId);
         this.currentRewardData = rewardData;
-        // Render based on final state (state may be ERROR after fetchRewardWithRetry)
-        if (this.state === WidgetState.ERROR) {
-            this.renderError(this.currentContainer);
-        }
-        else {
-            // LOADED state
+        // Set state based on fetch result (LOADED if data exists, ERROR otherwise)
+        if (rewardData) {
+            this.state = WidgetState.LOADED;
             // Use default layout when retrying (we don't have the original options here),
             // but preserve existing structure by rendering in the standard order.
             this.createWidget(rewardData, this.currentContainer, {
@@ -4600,6 +5368,46 @@ class WidgetRoot {
                 layout: ["group", "reward", "cta"],
             });
         }
+        else {
+            this.state = WidgetState.ERROR;
+            this.renderError(this.currentContainer);
+        }
+    }
+    /**
+     * Get or create a live region announcer for screen reader announcements
+     */
+    getOrCreateLiveRegion() {
+        if (this.liveRegionAnnouncer) {
+            return this.liveRegionAnnouncer;
+        }
+        // Check if one already exists in the DOM
+        const existing = document.querySelector("#cobuy-live-region");
+        if (existing instanceof HTMLDivElement) {
+            this.liveRegionAnnouncer = existing;
+            return this.liveRegionAnnouncer;
+        }
+        // Create new live region
+        const announcer = document.createElement("div");
+        announcer.id = "cobuy-live-region";
+        announcer.setAttribute("aria-live", "polite");
+        announcer.setAttribute("aria-atomic", "true");
+        announcer.className = "sr-only";
+        // Screen reader only styles - hidden from visual viewport
+        announcer.style.position = "absolute";
+        announcer.style.left = "-10000px";
+        announcer.style.width = "1px";
+        announcer.style.height = "1px";
+        announcer.style.overflow = "hidden";
+        document.body.appendChild(announcer);
+        this.liveRegionAnnouncer = announcer;
+        return this.liveRegionAnnouncer;
+    }
+    /**
+     * Announce a message to screen readers via live region
+     */
+    announceToScreenReaders(message) {
+        const region = this.getOrCreateLiveRegion();
+        region.textContent = message;
     }
     createWidget(rewardData, container, options) {
         const isFulfilled = this.groupFulfilled;
@@ -4644,35 +5452,11 @@ class WidgetRoot {
         rewardLine.style.opacity = "0";
         rewardLine.style.animation =
             "cobuy-fadeIn var(--cobuy-animation-duration, 300ms) var(--cobuy-animation-easing, ease-out) forwards";
-        // if (isFulfilled) {
-        //   const rewardText = this.formatRewardText(activeReward);
-        //   rewardLine.textContent = rewardText
-        //     ? `Reward available: ${rewardText}`
-        //     : "Reward available for this group";
-        //   rewardLine.setAttribute(
-        //     "aria-label",
-        //     rewardText ? `Reward locked in: ${rewardText}` : "Reward available for this group",
-        //   );
-        //   rewardLine.title = rewardLine.textContent;
-        // } else if (activeReward) {
-        //   const rewardText = this.formatRewardText(activeReward);
-        //   rewardLine.textContent = rewardText
-        //     ? `Save up to ${rewardText} with CoBuy`
-        //     : "CoBuy reward available";
-        //   rewardLine.setAttribute("aria-label", `Eligible for CoBuy reward: ${rewardLine.textContent}`);
-        //   rewardLine.title = rewardLine.textContent;
-        // } else {
-        //   rewardLine.textContent = "CoBuy offer loading or unavailable";
-        //   rewardLine.setAttribute("aria-label", "CoBuy offer loading or unavailable");
-        //   rewardLine.title = "CoBuy offer loading or unavailable";
-        //   rewardLine.style.color = "#6b7280";
-        // }
         sections.reward = rewardLine;
         // Button - semantic button element with accessibility
         const button = document.createElement("button");
         button.type = "button";
         button.className = "cobuy-button";
-        button.textContent = isFulfilled ? "Continue to Checkout" : "CoBuy";
         button.setAttribute("aria-label", isFulfilled
             ? "Continue to checkout for this fulfilled group"
             : "Buy this product with CoBuy for group buying discounts");
@@ -4681,20 +5465,20 @@ class WidgetRoot {
         button.title = isFulfilled
             ? "Continue to checkout"
             : "Buy with CoBuy for discounts when others join";
-        button.style.padding = "10px 14px";
+        button.style.padding = "8px 12px";
         button.style.backgroundColor = isFulfilled
             ? "var(--cobuy-success-color, #10b981)"
             : "var(--cobuy-primary-color, #4f46e5)";
         button.style.color = "var(--cobuy-button-text-color, white)";
         button.style.border = "none";
         button.style.borderRadius = "var(--cobuy-border-radius, 6px)";
-        button.style.fontSize = "13px";
+        button.style.fontSize = "12px";
         button.style.fontWeight = "700";
         button.style.fontFamily =
             "var(--cobuy-font-family, Inter, system-ui, -apple-system, sans-serif)";
         button.style.cursor = "pointer";
         button.style.width = "100%";
-        button.style.minHeight = "var(--cobuy-cta-min-height, 44px)";
+        button.style.minHeight = "var(--cobuy-cta-min-height, 36px)";
         button.style.height = "auto";
         button.style.lineHeight = "1.4";
         button.style.wordWrap = "break-word";
@@ -4703,6 +5487,41 @@ class WidgetRoot {
         button.style.opacity = "0";
         button.style.animation =
             "cobuy-fadeIn var(--cobuy-animation-duration, 300ms) var(--cobuy-animation-easing, ease-out) forwards 100ms";
+        button.style.display = "flex";
+        button.style.alignItems = "center";
+        button.style.justifyContent = "center";
+        // Add logo or text based on state
+        if (isFulfilled) {
+            button.textContent = "Continue to Checkout";
+        }
+        else {
+            // Create SVG logo for CoBuy button
+            const svgNS = "http://www.w3.org/2000/svg";
+            const svg = document.createElementNS(svgNS, "svg");
+            svg.setAttribute("width", "81");
+            svg.setAttribute("height", "20");
+            svg.setAttribute("viewBox", "0 0 81 20");
+            svg.setAttribute("fill", "none");
+            svg.style.height = "auto";
+            svg.style.maxHeight = "18px";
+            svg.style.width = "auto";
+            // CoBuy text path
+            const textPath = document.createElementNS(svgNS, "path");
+            textPath.setAttribute("d", "M34.752 16.192C33.8987 16.192 33.1093 16.0373 32.384 15.728C31.6693 15.4187 31.04 14.9867 30.496 14.432C29.9627 13.8773 29.5467 13.2267 29.248 12.48C28.9493 11.7333 28.8 10.9173 28.8 10.032C28.8 9.14667 28.944 8.33067 29.232 7.584C29.5307 6.82667 29.9467 6.176 30.48 5.632C31.024 5.07733 31.6587 4.65067 32.384 4.352C33.1093 4.04267 33.8987 3.888 34.752 3.888C35.6053 3.888 36.368 4.032 37.04 4.32C37.7227 4.608 38.2987 4.992 38.768 5.472C39.2373 5.94133 39.5733 6.45867 39.776 7.024L37.824 7.936C37.6 7.33867 37.2213 6.848 36.688 6.464C36.1547 6.06933 35.5093 5.872 34.752 5.872C34.0053 5.872 33.344 6.048 32.768 6.4C32.2027 6.752 31.76 7.23733 31.44 7.856C31.1307 8.47467 30.976 9.2 30.976 10.032C30.976 10.864 31.1307 11.5947 31.44 12.224C31.76 12.8427 32.2027 13.328 32.768 13.68C33.344 14.032 34.0053 14.208 34.752 14.208C35.5093 14.208 36.1547 14.016 36.688 13.632C37.2213 13.2373 37.6 12.7413 37.824 12.144L39.776 13.056C39.5733 13.6213 39.2373 14.144 38.768 14.624C38.2987 15.0933 37.7227 15.472 37.04 15.76C36.368 16.048 35.6053 16.192 34.752 16.192ZM45.4664 16.192C44.613 16.192 43.8344 15.9947 43.1304 15.6C42.437 15.2053 41.8824 14.6667 41.4664 13.984C41.061 13.3013 40.8584 12.5227 40.8584 11.648C40.8584 10.7733 41.061 9.99467 41.4664 9.312C41.8824 8.62933 42.437 8.09067 43.1304 7.696C43.8237 7.30133 44.6024 7.104 45.4664 7.104C46.3197 7.104 47.093 7.30133 47.7864 7.696C48.4797 8.09067 49.029 8.62933 49.4344 9.312C49.8504 9.984 50.0584 10.7627 50.0584 11.648C50.0584 12.5227 49.8504 13.3013 49.4344 13.984C49.0184 14.6667 48.4637 15.2053 47.7704 15.6C47.077 15.9947 46.309 16.192 45.4664 16.192ZM45.4664 14.272C45.9357 14.272 46.3464 14.16 46.6984 13.936C47.061 13.712 47.3437 13.4027 47.5464 13.008C47.7597 12.6027 47.8664 12.1493 47.8664 11.648C47.8664 11.136 47.7597 10.688 47.5464 10.304C47.3437 9.90933 47.061 9.6 46.6984 9.376C46.3464 9.14133 45.9357 9.024 45.4664 9.024C44.9864 9.024 44.565 9.14133 44.2024 9.376C43.8397 9.6 43.5517 9.90933 43.3384 10.304C43.1357 10.688 43.0344 11.136 43.0344 11.648C43.0344 12.1493 43.1357 12.6027 43.3384 13.008C43.5517 13.4027 43.8397 13.712 44.2024 13.936C44.565 14.16 44.9864 14.272 45.4664 14.272ZM51.8239 16V4.08H56.8479C57.6372 4.08 58.3092 4.21867 58.8639 4.496C59.4292 4.76267 59.8612 5.14667 60.1599 5.648C60.4692 6.13867 60.6239 6.736 60.6239 7.44C60.6239 7.984 60.4745 8.496 60.1759 8.976C59.8879 9.44533 59.4239 9.83467 58.7839 10.144V9.136C59.3705 9.36 59.8345 9.63733 60.1759 9.968C60.5172 10.2987 60.7572 10.6667 60.8959 11.072C61.0345 11.4773 61.1039 11.904 61.1039 12.352C61.1039 13.4933 60.7252 14.3893 59.9679 15.04C59.2212 15.68 58.1812 16 56.8479 16H51.8239ZM53.9999 14.08H57.0719C57.6372 14.08 58.0852 13.9253 58.4159 13.616C58.7572 13.296 58.9279 12.8747 58.9279 12.352C58.9279 11.8293 58.7572 11.408 58.4159 11.088C58.0852 10.768 57.6372 10.608 57.0719 10.608H53.9999V14.08ZM53.9999 8.704H56.9599C57.4079 8.704 57.7652 8.576 58.0319 8.32C58.2985 8.05333 58.4319 7.712 58.4319 7.296C58.4319 6.88 58.2985 6.54933 58.0319 6.304C57.7652 6.05867 57.4079 5.936 56.9599 5.936H53.9999V8.704ZM65.8144 16.192C65.1424 16.192 64.5557 16.0427 64.0544 15.744C63.5637 15.4453 63.185 15.0293 62.9184 14.496C62.6624 13.9627 62.5344 13.3387 62.5344 12.624V7.296H64.6304V12.448C64.6304 12.8107 64.6997 13.1307 64.8384 13.408C64.9877 13.6747 65.1957 13.888 65.4624 14.048C65.7397 14.1973 66.049 14.272 66.3904 14.272C66.7317 14.272 67.0357 14.1973 67.3024 14.048C67.569 13.888 67.777 13.6693 67.9264 13.392C68.0757 13.1147 68.1504 12.784 68.1504 12.4V7.296H70.2464V16H68.2624V14.288L68.4384 14.592C68.2357 15.1253 67.8997 15.5253 67.4304 15.792C66.9717 16.0587 66.433 16.192 65.8144 16.192ZM73.2508 19.52C73.0161 19.52 72.7868 19.4987 72.5628 19.456C72.3388 19.424 72.1361 19.36 71.9548 19.264V17.52C72.0934 17.552 72.2588 17.584 72.4508 17.616C72.6534 17.648 72.8401 17.664 73.0108 17.664C73.4908 17.664 73.8374 17.552 74.0508 17.328C74.2748 17.1147 74.4721 16.8267 74.6428 16.464L75.2188 15.12L75.1868 16.88L71.3948 7.296H73.6508L76.3068 14.368H75.5068L78.1468 7.296H80.4188L76.6268 16.88C76.4028 17.4347 76.1308 17.9093 75.8108 18.304C75.4907 18.6987 75.1174 18.9973 74.6908 19.2C74.2748 19.4133 73.7948 19.52 73.2508 19.52Z");
+            textPath.setAttribute("fill", "white");
+            // Orange square background
+            const rect = document.createElementNS(svgNS, "path");
+            rect.setAttribute("d", "M1.51641 1.76251H19.5066V17.964H1.51641V1.76251Z");
+            rect.setAttribute("fill", "#FF8A15");
+            // Blue accent
+            const accent = document.createElementNS(svgNS, "path");
+            accent.setAttribute("d", "M2.37111 0.142428C1.40613 0.476852 0.735229 1.10051 0.25733 2.11282L0 2.64609V17.2071L0.349234 17.894C0.75361 18.6985 1.41532 19.3492 2.23326 19.7469L2.75711 20H18.1969L18.7024 19.765C19.4284 19.4306 20.081 18.8792 20.421 18.3188C21.0092 17.3517 21 17.4783 21 9.7865C21 2.20321 21.0092 2.31167 20.4853 1.4982C20.1453 0.964931 19.5663 0.440698 19.0884 0.223774L18.6564 0.0249275L10.7527 0.0068505C3.34529 -0.0112265 2.82144 -0.00218799 2.37111 0.142428ZM9.93479 3.41436C10.3575 3.59513 10.9825 4.03802 11.2858 4.36341C11.3777 4.46283 11.5891 4.80629 11.7453 5.13168C12.021 5.69206 12.0394 5.77341 12.0394 6.75861C12.0394 7.68053 12.0118 7.85226 11.8096 8.24996C11.5155 8.85554 10.7895 9.54246 10.0726 9.89496C9.52122 10.1752 9.42932 10.1932 8.54704 10.1932C7.66477 10.1932 7.57286 10.1752 7.03063 9.89496C5.8175 9.28938 5.12822 8.43073 4.87089 7.20149C4.70547 6.44226 4.7698 6.01745 5.16499 5.13168C5.54179 4.28206 6.65383 3.45052 7.70153 3.23359C8.28971 3.10705 9.45689 3.19744 9.93479 3.41436ZM15.4306 9.73227C16.0556 10.0396 16.5519 10.5548 16.8827 11.2417C17.1217 11.7569 17.1584 11.9015 17.1217 12.4348C17.0481 13.6098 16.414 14.5679 15.3755 15.0288C14.6219 15.3633 13.8407 15.4175 13.0963 15.1644C12.3794 14.9294 12.0026 14.6582 11.6258 14.125C10.7619 12.8957 10.8722 11.4586 11.9107 10.3469C12.5081 9.71419 13.179 9.46112 14.1991 9.48823C14.8057 9.50631 15.0814 9.56958 15.4306 9.73227ZM7.36148 11.558C7.93129 11.7027 8.64814 12.3534 8.94223 12.9952C9.11684 13.3657 9.17199 13.655 9.18118 14.125C9.19037 15.6886 7.98643 16.7823 6.34135 16.6829C5.59693 16.6377 5.21094 16.466 4.65952 15.9508C3.75886 15.0921 3.63939 13.4832 4.41138 12.498C5.04551 11.6755 6.25864 11.2869 7.36148 11.558Z");
+            accent.setAttribute("fill", "#0157AA");
+            svg.appendChild(rect);
+            svg.appendChild(accent);
+            svg.appendChild(textPath);
+            button.appendChild(svg);
+        }
         // Hover effect using opacity for better theme compatibility
         button.addEventListener("mouseenter", () => {
             button.style.opacity = "0.9";
@@ -4736,6 +5555,10 @@ class WidgetRoot {
         });
         container.innerHTML = "";
         container.appendChild(wrapper);
+        // Announce loaded widget to screen readers
+        const rewardText = rewardLine.textContent || "CoBuy offer";
+        const buttonText = button.getAttribute("aria-label") || "CoBuy action";
+        this.announceToScreenReaders(`${rewardText}. ${buttonText}`);
     }
     /**
      * Inject base layout styles for responsive widget rendering
@@ -4747,6 +5570,19 @@ class WidgetRoot {
         const style = document.createElement("style");
         style.id = "cobuy-widget-base-styles";
         style.textContent = `
+      /* Screen reader only - hide visually but keep available to AT */
+      .sr-only {
+        position: absolute;
+        width: 1px;
+        height: 1px;
+        padding: 0;
+        margin: -1px;
+        overflow: hidden;
+        clip: rect(0, 0, 0, 0);
+        white-space: nowrap;
+        border-width: 0;
+      }
+
       .cobuy-widget {
         display: grid;
         grid-template-columns: 1fr;
@@ -5167,12 +6003,35 @@ function buildApiUrl(baseUrl, endpoint, params, query) {
  */
 class ApiClient {
     constructor(config) {
+        var _a;
         this.traceId = null;
+        this.rewardCache = new Map();
+        this.REWARD_CACHE_TTL = 60000; // 1 minute
+        this.pendingRequests = new Map();
         this.baseUrl = config.baseUrl;
         this.authStrategy = config.authStrategy;
         this.sessionId = config.sessionId;
         this.logger = new Logger(config.debug || false);
         this.defaultTimeout = config.timeout || 30000; // 30 seconds default
+        this.maxRetries = (_a = config.maxRetries) !== null && _a !== void 0 ? _a : 2; // Default: 2 retries
+        this.botdScore = typeof config.botdScore === "number" ? config.botdScore : undefined;
+    }
+    /**
+     * Update the BotD (Bot Detection) score for fraud detection
+     *
+     * @param {number | undefined} score - The BotD score (0-100) or undefined to clear
+     * @returns {void}
+     *
+     * @description
+     * Sets the fraud detection score that will be included in API request headers.
+     * Used to improve fraud detection accuracy. Cleared if undefined is passed.
+     *
+     * @example
+     * CoBuy.getApiClient()?.setBotdScore(45); // Set BotD score
+     * CoBuy.getApiClient()?.setBotdScore(undefined); // Clear score
+     */
+    setBotdScore(score) {
+        this.botdScore = typeof score === "number" ? score : undefined;
     }
     /**
      * Generate a unique trace ID for request correlation
@@ -5195,13 +6054,51 @@ class ApiClient {
             error.statusCode === 504);
     }
     /**
-     * Make an HTTP request to the API with retry logic
+     * Make an authenticated HTTP request with automatic retry logic
+     *
+     * Low-level method for making requests to the API. Handles authentication headers,
+     * timeout management, error handling, and automatic retries for transient failures.
+     *
+     * @template T - The type of data returned on success
+     * @param {string} endpoint - The API endpoint path (e.g., '/products/12345/reward')
+     * @param {ApiRequestOptions} [options={}] - Request configuration options
+     * @param {"GET" | "POST" | "PUT" | "DELETE"} [options.method="GET"] - HTTP method
+     * @param {unknown} [options.body] - Request body (automatically JSON stringified)
+     * @param {Record<string, string>} [options.headers] - Additional headers to include
+     * @param {number} [options.timeout] - Request timeout in milliseconds
+     *
+     * @returns {Promise<ApiResponse<T>>} Response with success flag and data or error
+     *
+     * @description
+     * Request Features:
+     * - Automatic authentication header injection from auth strategy
+     * - Session tracking via X-CoBuy-Session header
+     * - Request correlation via trace ID (X-CoBuy-Trace header)
+     * - Configurable timeout (default 30 seconds)
+     * - Automatic retry on transient errors (timeout, 502, 503, 504)
+     * - Exponential backoff: 100ms, 200ms, 400ms
+     * - Auth token refresh on 401/403 responses
+     * - Full response body logging in debug mode
+     *
+     * @example
+     * ```typescript
+     * const client = CoBuy.getApiClient();
+     * const response = await client.request('/products/abc123/groups', {
+     *   method: 'GET',
+     *   timeout: 15000
+     * });
+     *
+     * if (response.success) {
+     *   console.log('Groups:', response.data);
+     * } else {
+     *   console.error('Error:', response.error?.message);
+     * }
+     * ```
      */
     async request(endpoint, options = {}) {
         var _a, _b;
-        const maxRetries = 2;
         let lastError = null;
-        for (let attempt = 0; attempt <= maxRetries; attempt++) {
+        for (let attempt = 0; attempt <= this.maxRetries; attempt++) {
             const result = await this.executeRequest(endpoint, options);
             // Success - return immediately
             if (result.success) {
@@ -5215,9 +6112,9 @@ class ApiClient {
             if (this.isRetryableError(result.error || {})) {
                 lastError = result;
                 // Don't retry on last attempt
-                if (attempt < maxRetries) {
+                if (attempt < this.maxRetries) {
                     const delay = Math.pow(2, attempt) * 100; // 100ms, 200ms, 400ms
-                    this.logger.info(`Retrying request (attempt ${attempt + 1}/${maxRetries}) after ${delay}ms`);
+                    this.logger.info(`Retrying request (attempt ${attempt + 1}/${this.maxRetries}) after ${delay}ms`);
                     await new Promise((resolve) => setTimeout(resolve, delay));
                     continue;
                 }
@@ -5237,21 +6134,33 @@ class ApiClient {
         const url = `${this.baseUrl}${endpoint}`;
         const method = options.method || "GET";
         const timeout = options.timeout || this.defaultTimeout;
+        if (typeof navigator !== "undefined" && navigator.onLine === false) {
+            this.logger.warn(`Offline detected: ${method} ${url}`);
+            return {
+                success: false,
+                error: {
+                    message: "No network connection. Check your internet connection and try again.",
+                    code: "OFFLINE",
+                },
+            };
+        }
         // Generate trace ID for this request
         this.traceId = this.generateTraceId();
         this.logger.info(`API Request: ${method} ${url} [trace: ${this.traceId}]`);
+        let timeoutId = null;
+        const controller = new AbortController();
         try {
             // Get auth headers from strategy
             const authHeaders = this.authStrategy.getHeaders();
-            const controller = new AbortController();
-            const timeoutId = setTimeout(() => controller.abort(), timeout);
+            timeoutId = setTimeout(() => controller.abort(), timeout);
             const response = await fetch(url, {
                 method,
-                headers: Object.assign(Object.assign({ "Content-Type": "application/json", "X-CoBuy-SDK-Version": "1.0.0", "X-CoBuy-Session": this.sessionId, "X-CoBuy-Trace": this.traceId }, authHeaders), options.headers),
+                headers: Object.assign(Object.assign(Object.assign({ "Content-Type": "application/json", "X-CoBuy-SDK-Version": "1.0.0", "X-CoBuy-Session": this.sessionId, "X-CoBuy-Trace": this.traceId }, (this.botdScore !== undefined
+                    ? { "X-CoBuy-BotD-Score": this.botdScore.toString() }
+                    : {})), authHeaders), options.headers),
                 body: options.body ? JSON.stringify(options.body) : undefined,
                 signal: controller.signal,
             });
-            clearTimeout(timeoutId);
             // Log server session header if present
             const serverSession = response.headers.get("X-CoBuy-Server-Session");
             if (serverSession) {
@@ -5263,9 +6172,55 @@ class ApiClient {
             if (rateLimit && rateLimitRemaining) {
                 this.logger.debug(`Rate limit: ${rateLimitRemaining}/${rateLimit}`);
             }
-            const responseData = await response.json();
+            let responseData = null;
+            const contentType = response.headers.get("content-type") || "";
+            const responseText = await response.text();
+            if (contentType.includes("application/json")) {
+                if (responseText) {
+                    try {
+                        responseData = JSON.parse(responseText);
+                    }
+                    catch (parseError) {
+                        this.logger.error("JSON parse error", parseError);
+                        return {
+                            success: false,
+                            error: {
+                                message: "Failed to parse API response",
+                                code: "PARSE_ERROR",
+                                statusCode: response.status,
+                            },
+                        };
+                    }
+                }
+            }
+            else if (responseText) {
+                this.logger.warn(`Non-JSON response received: ${responseText.substring(0, 100)}`);
+                return {
+                    success: false,
+                    error: {
+                        message: response.statusText || "Invalid response format",
+                        code: "INVALID_RESPONSE",
+                        statusCode: response.status,
+                    },
+                };
+            }
             if (!response.ok) {
                 this.logger.error(`API Error: ${response.status} ${response.statusText}`, responseData);
+                const responsePayload = responseData && typeof responseData === "object"
+                    ? responseData
+                    : {};
+                const responseCode = typeof responsePayload.code === "string" ? responsePayload.code : undefined;
+                const responseMessage = typeof responsePayload.message === "string" ? responsePayload.message : undefined;
+                if (response.status === 403 && responseCode === "FRAUD_DETECTED") {
+                    return {
+                        success: false,
+                        error: {
+                            message: responseMessage || response.statusText,
+                            code: responseCode,
+                            statusCode: response.status,
+                        },
+                    };
+                }
                 // Handle auth errors (401/403) with refresh attempt
                 if (response.status === 401 || response.status === 403) {
                     this.logger.warn("Auth error detected, attempting refresh");
@@ -5277,15 +6232,15 @@ class ApiClient {
                     }
                     else {
                         // Refresh failed, notify error handler
-                        const authError = new Error(responseData.message || `Authentication failed: ${response.statusText}`);
+                        const authError = new Error(responseMessage || `Authentication failed: ${response.statusText}`);
                         this.authStrategy.onAuthError(authError);
                     }
                 }
                 return {
                     success: false,
                     error: {
-                        message: responseData.message || response.statusText,
-                        code: responseData.code,
+                        message: responseMessage || response.statusText,
+                        code: responseCode,
                         statusCode: response.status,
                     },
                 };
@@ -5308,6 +6263,22 @@ class ApiClient {
                         },
                     };
                 }
+                // Detect CORS errors - TypeError with "Failed to fetch" is typically a CORS issue
+                if (error instanceof TypeError &&
+                    (error.message.includes("Failed to fetch") ||
+                        error.message.includes("CORS") ||
+                        error.message.includes("cors"))) {
+                    this.logger.error(`CORS Error: ${method} ${url}`, error);
+                    return {
+                        success: false,
+                        error: {
+                            message: "CORS policy prevented the request. Verify the API server is configured correctly and allows requests from this origin. " +
+                                "Troubleshooting: 1) Check API_BASE_URL is set to a valid endpoint, 2) Ensure server has Access-Control-Allow-Origin headers enabled, " +
+                                "3) Confirm the request method is in Access-Control-Allow-Methods",
+                            code: "CORS_ERROR",
+                        },
+                    };
+                }
                 this.logger.error(`API Error: ${method} ${url}`, error);
                 return {
                     success: false,
@@ -5325,6 +6296,11 @@ class ApiClient {
                 },
             };
         }
+        finally {
+            if (timeoutId) {
+                clearTimeout(timeoutId);
+            }
+        }
     }
     /**
      * Make a GET request
@@ -5357,14 +6333,30 @@ class ApiClient {
         return this.request(endpoint, Object.assign(Object.assign({}, options), { method: "DELETE" }));
     }
     /**
-     * Update the base URL
+     * Update the API base URL
+     *
+     * @param {string} baseUrl - The new base URL for API requests
+     * @returns {void}
+     *
+     * @example
+     * CoBuy.getApiClient()?.setBaseUrl('https://api-staging.cobuy.com');
      */
     setBaseUrl(baseUrl) {
         this.baseUrl = baseUrl;
         this.logger.info(`API Base URL updated: ${baseUrl}`);
     }
     /**
-     * Update the auth strategy
+     * Update the authentication strategy
+     *
+     * @param {AuthStrategy} authStrategy - The new auth strategy to use
+     * @returns {void}
+     *
+     * @description
+     * Allows switching between public key and token-based authentication at runtime.
+     *
+     * @example
+     * const newAuth = new TokenAuth("new_token");
+     * CoBuy.getApiClient()?.setAuthStrategy(newAuth);
      */
     setAuthStrategy(authStrategy) {
         this.authStrategy = authStrategy;
@@ -5372,19 +6364,41 @@ class ApiClient {
     }
     /**
      * Get the current session ID
+     *
+     * @returns {string} The current session ID used for API requests
+     *
+     * @example
+     * const sessionId = CoBuy.getApiClient()?.getSessionId();
+     * console.log('Current session:', sessionId);
      */
     getSessionId() {
         return this.sessionId;
     }
     /**
      * Update the session ID
+     *
+     * @param {string} sessionId - The new session ID for API requests
+     * @returns {void}
+     *
+     * @example
+     * CoBuy.getApiClient()?.setSessionId('new-session-uuid');
      */
     setSessionId(sessionId) {
         this.sessionId = sessionId;
         this.logger.info(`Session ID updated: ${sessionId}`);
     }
     /**
-     * Get the current trace ID
+     * Get the most recent request trace ID
+     *
+     * Useful for debugging and correlating client requests with server logs.
+     *
+     * @returns {string | null} The trace ID from the last request, or null if no requests made
+     *
+     * @example
+     * const traceId = CoBuy.getApiClient()?.getTraceId();
+     * if (traceId) {
+     *   console.log('Last request trace:', traceId); // Use for support tickets
+     * }
      */
     getTraceId() {
         return this.traceId;
@@ -5392,25 +6406,91 @@ class ApiClient {
     /**
      * Get product reward information
      *
-     * Retrieves reward data and eligibility for a specific product.
-     * This is a core method for SCRUM-247: Retrieve reward information.
+     * Retrieves discount and reward eligibility for a specific product.
+     * Results are cached for 1 minute to reduce API load.
+     *
+     * @param {string} productId - The product ID to fetch reward information for
+     * @returns {Promise<ApiResponse<ProductRewardData>>} Product reward and eligibility data
+     *
+     * @description
+     * Features:
+     * - Caches results for 60 seconds to reduce API calls
+     * - Deduplicates concurrent requests for the same product
+     * - Includes reward amount, eligibility status, and discount percentage
      *
-     * @param productId - The product ID to fetch reward information for
-     * @returns Promise with reward data including eligibility status
+     * @throws Does not throw; returns ApiResponse with error details on failure
+     *
+     * @example
+     * ```typescript
+     * const response = await client.getProductReward('prod_abc123');
+     * if (response.success) {
+     *   console.log('Discount:', response.data?.discount_percentage);
+     *   console.log('Eligible:', response.data?.eligible);
+     * }
+     * ```
      */
     async getProductReward(productId) {
+        if (!validateProductId(productId)) {
+            return {
+                success: false,
+                error: {
+                    message: "Invalid productId format. Must be a non-empty string (max 200 chars).",
+                    code: "INVALID_PRODUCT_ID",
+                },
+            };
+        }
+        const cached = this.rewardCache.get(productId);
+        if (cached && cached.expires > Date.now()) {
+            this.logger.info(`Using cached reward for product: ${productId}`);
+            return {
+                success: true,
+                data: cached.data,
+            };
+        }
+        const cacheKey = `reward:${productId}`;
+        const pending = this.pendingRequests.get(cacheKey);
+        if (pending) {
+            this.logger.info(`Deduplicating request for product: ${productId}`);
+            return pending;
+        }
+        const promise = this.fetchProductReward(productId).then((response) => {
+            if (response.success && response.data) {
+                this.rewardCache.set(productId, {
+                    data: response.data,
+                    expires: Date.now() + this.REWARD_CACHE_TTL,
+                });
+            }
+            return response;
+        });
+        this.pendingRequests.set(cacheKey, promise);
+        promise.then(() => this.pendingRequests.delete(cacheKey), () => this.pendingRequests.delete(cacheKey));
+        return promise;
+    }
+    /**
+     * Clear all cached product rewards
+     *
+     * Primarily used for testing or forcing fresh data from the server.
+     *
+     * @returns {void}
+     *
+     * @example
+     * CoBuy.getApiClient()?.clearRewardCache();
+     * // Next getProductReward call will fetch fresh data
+     */
+    clearRewardCache() {
+        this.rewardCache.clear();
+    }
+    async fetchProductReward(productId) {
         var _a;
         const endpoint = buildApiUrl("", API_ENDPOINTS.PRODUCT_REWARD, { productId });
         this.logger.info(`Fetching reward for product: ${productId}`);
         const response = await this.get(endpoint);
-        // Handle the nested response structure from backend
         if (response.success && ((_a = response.data) === null || _a === void 0 ? void 0 : _a.data)) {
             return {
                 success: true,
                 data: response.data.data,
             };
         }
-        // Return error response
         return {
             success: false,
             error: response.error || {
@@ -5420,10 +6500,42 @@ class ApiClient {
         };
     }
     /**
-     * Get primary group information for a product (participants, max, expiry)
+     * Get primary group information for a product
+     *
+     * Retrieves the primary group data including member count, capacity, and expiry time.
+     * Optionally creates a new group if none exists.
+     *
+     * @param {string} productId - The product ID to fetch primary group for
+     * @returns {Promise<ApiResponse<ProductPrimaryGroupData>>} Primary group data or error
+     *
+     * @description
+     * Returns group information including:
+     * - Current participant count
+     * - Maximum participants allowed
+     * - Group status (pending, active, fulfilled, expired)
+     * - Time remaining for group to close
+     * - Group ID for joining operations
+     *
+     * @example
+     * ```typescript
+     * const response = await client.getProductPrimaryGroup('prod_abc123');
+     * if (response.success) {
+     *   const group = response.data;
+     *   console.log(`${group.participants_count}/${group.max_participants} members`);
+     * }
+     * ```
      */
     async getProductPrimaryGroup(productId) {
         var _a;
+        if (!validateProductId(productId)) {
+            return {
+                success: false,
+                error: {
+                    message: "Invalid productId format. Must be a non-empty string (max 200 chars).",
+                    code: "INVALID_PRODUCT_ID",
+                },
+            };
+        }
         const endpoint = buildApiUrl("", API_ENDPOINTS.PRODUCT_PRIMARY_GROUP, { productId }, { allowAutoCreate: true });
         this.logger.info(`Fetching primary group for product: ${productId}`);
         const response = await this.get(endpoint);
@@ -5442,13 +6554,44 @@ class ApiClient {
         };
     }
     /**
-     * Get active groups for a product
+     * Get all active groups for a product
+     *
+     * Retrieves a list of currently active groups for a product, including
+     * member count, capacity, and whether the current user is a member.
+     *
+     * @param {string} productId - The product ID to fetch active groups for
+     * @returns {Promise<ApiResponse<{groups: Array}>>} List of active groups with member info
      *
-     * @param productId - The product ID to fetch active groups for
-     * @returns Promise with active groups list
+     * @description
+     * Each group includes:
+     * - Group ID and number
+     * - Current and max participant counts
+     * - Status (pending, active, fulfilled, expired)
+     * - Time remaining before group closes
+     * - Whether current user is a member
+     * - Discount and reward information
+     *
+     * @example
+     * ```typescript
+     * const response = await client.getProductActiveGroups('prod_abc123');
+     * if (response.success) {
+     *   response.data?.groups.forEach(group => {
+     *     console.log(`Group ${group.group_number}: ${group.participants_count}/${group.max_participants}`);
+     *   });
+     * }
+     * ```
      */
     async getProductActiveGroups(productId) {
         var _a;
+        if (!validateProductId(productId)) {
+            return {
+                success: false,
+                error: {
+                    message: "Invalid productId format. Must be a non-empty string (max 200 chars).",
+                    code: "INVALID_PRODUCT_ID",
+                },
+            };
+        }
         const endpoint = buildApiUrl("", API_ENDPOINTS.PRODUCT_ACTIVE_GROUPS, { productId });
         this.logger.info(`Fetching active groups for product: ${productId}`);
         const response = await this.get(endpoint);
@@ -5468,6 +6611,28 @@ class ApiClient {
     }
     /**
      * Create a new group for a product and join it
+     *
+     * Creates a brand new group for a product and immediately adds the current
+     * user as the first member. Useful when no existing groups meet the user's needs.
+     *
+     * @param {string} productId - The product ID to create a group for
+     * @returns {Promise<ApiResponse<GroupJoinResponseData>>} New group info and join status
+     *
+     * @description
+     * Returns:
+     * - New group ID and number
+     * - User's membership confirmation
+     * - Group details (capacity, status, etc.)
+     * - Discount values
+     *
+     * @example
+     * ```typescript
+     * const response = await client.createAndJoinGroup('prod_abc123');
+     * if (response.success) {
+     *   const groupId = response.data?.group?.id;
+     *   console.log('Created new group:', groupId);
+     * }
+     * ```
      */
     async createAndJoinGroup(productId) {
         var _a;
@@ -5491,11 +6656,41 @@ class ApiClient {
         };
     }
     /**
-     * Join a group
+     * Join an existing group
+     *
+     * Adds the current user to an existing group, optionally providing contact
+     * information (email or phone) to enrich the session.
      *
-     * @param groupId - The group ID to join
-     * @param contact - Optional contact information to enrich the session
-     * @returns Promise with join result
+     * @param {string} groupId - The group ID to join
+     * @param {Contact} [contact] - Optional contact information (email or phone)
+     * @param {"email" | "phone"} [contact.type] - Type of contact
+     * @param {string} [contact.value] - Email address or phone number
+     * @returns {Promise<ApiResponse<GroupJoinResponseData>>} Updated group info and join status
+     *
+     * @description
+     * Actions:
+     * - Adds user to group members
+     * - Records contact information if provided
+     * - Updates group status if member count reaches maximum
+     * - Returns updated group details and member count
+     *
+     * @example
+     * ```typescript
+     * // Join without contact
+     * const response = await client.joinGroup('grp_xyz789');
+     *
+     * // Join with email
+     * const response = await client.joinGroup('grp_xyz789', {
+     *   type: 'email',
+     *   value: 'user@example.com'
+     * });
+     *
+     * // Join with phone
+     * const response = await client.joinGroup('grp_xyz789', {
+     *   type: 'phone',
+     *   value: '+1234567890'
+     * });
+     * ```
      */
     async joinGroup(groupId, contact) {
         var _a;
@@ -5529,7 +6724,38 @@ class ApiClient {
         };
     }
     /**
-     * Send an invite/share event for a group
+     * Record a group share/invite event
+     *
+     * Tracks when a user shares or invites others to join a group via
+     * a specific channel (email, SMS, social, etc.). Helps analyze referral effectiveness.
+     *
+     * @param {string} groupId - The group ID being shared
+     * @param {ShareChannel} sharedVia - Channel used for sharing ("email", "sms", "whatsapp", "facebook", "twitter", "linkedin", "copy_link", "qr", "other")
+     * @returns {Promise<ApiResponse<GroupInviteResponseData>>} Invite tracking result
+     *
+     * @description
+     * Supported channels:
+     * - email: Email invitation
+     * - sms: SMS/text message
+     * - whatsapp: WhatsApp share
+     * - facebook: Facebook share
+     * - twitter: Twitter/X share
+     * - linkedin: LinkedIn share
+     * - copy_link: Direct link copy
+     * - qr: QR code scan
+     * - other: Other sharing method
+     *
+     * @example
+     * ```typescript
+     * // Track email share
+     * await client.inviteToGroup('grp_xyz789', 'email');
+     *
+     * // Track WhatsApp share
+     * await client.inviteToGroup('grp_xyz789', 'whatsapp');
+     *
+     * // Track copied link
+     * await client.inviteToGroup('grp_xyz789', 'copy_link');
+     * ```
      */
     async inviteToGroup(groupId, sharedVia) {
         const endpoint = buildApiUrl("", API_ENDPOINTS.GROUP_INVITE, { groupId });
@@ -5555,13 +6781,35 @@ class ApiClient {
     /**
      * Set or update contact information for the current session
      *
-     * Sends contact information (email or phone) to link with the current session.
-     * This allows merchants to identify a previously anonymous user.
-     * Backend will not overwrite existing stored contact.
-     * Safe to call multiple times (idempotent).
+     * Associates email or phone with the current session, allowing merchants
+     * to identify a previously anonymous user without requiring form submission.
+     *
+     * @param {Contact} contact - Contact information
+     * @param {"email" | "phone"} contact.type - Type of contact
+     * @param {string} contact.value - Email address or phone number
+     * @returns {Promise<ApiResponse<void>>} Success confirmation
+     *
+     * @description
+     * Features:
+     * - Idempotent: safe to call multiple times
+     * - Backend won't overwrite existing contact (if any)
+     * - Enables identifying returning customers
+     * - Enriches session data for analytics
+     *
+     * @example
+     * ```typescript
+     * // Set email
+     * await client.setContact({
+     *   type: 'email',
+     *   value: 'customer@example.com'
+     * });
      *
-     * @param contact - Contact information with type and value
-     * @returns Promise with success status
+     * // Set phone
+     * await client.setContact({
+     *   type: 'phone',
+     *   value: '+1-555-123-4567'
+     * });
+     * ```
      */
     async setContact(contact) {
         const endpoint = "/v1/sdk/session/contact";
@@ -5590,11 +6838,28 @@ class ApiClient {
      * Prepare checkout for a group
      *
      * Signals the backend that the user is proceeding to checkout for a specific group.
-     * This allows the backend to prepare order data, lock pricing, and track conversion.
-     * Returns a checkout reference to be used in subsequent validate and confirm calls.
+     * Reserves order capacity, locks pricing, prepares order data, and enables conversion tracking.
+     * Must be completed before validateCheckout and confirmCheckout.
+     *
+     * @param {string} groupId - The group ID to prepare checkout for
+     * @returns {Promise<ApiResponse<{checkout_ref: string}>>} Checkout reference for use in subsequent calls
      *
-     * @param groupId - The group ID to prepare checkout for
-     * @returns Promise with success status and checkout reference
+     * @description
+     * Actions performed:
+     * - Validates group status and user membership
+     * - Reserves a seat in the group
+     * - Locks product reward/pricing
+     * - Generates a unique checkout reference
+     * - Enables server-side conversion tracking
+     *
+     * @example
+     * ```typescript
+     * const response = await client.prepareCheckout('grp_xyz789');
+     * if (response.success) {
+     *   const checkoutRef = response.data?.checkout_ref;
+     *   // Store this reference for validateCheckout and confirmCheckout
+     * }
+     * ```
      */
     async prepareCheckout(groupId) {
         var _a, _b;
@@ -5622,11 +6887,31 @@ class ApiClient {
      * Validate checkout for a group
      *
      * Validates the checkout reference and confirms the order can proceed.
-     * This should be called after prepareCheckout to verify the checkout state.
+     * Verifies group status, user membership, and pricing consistency.
+     * Should be called after prepareCheckout and before confirmCheckout.
      *
-     * @param groupId - The group ID to validate checkout for
-     * @param checkoutRef - The checkout reference ID from the prepare step
-     * @returns Promise with success status
+     * @param {string} groupId - The group ID being checked out
+     * @param {string} checkoutRef - The checkout reference from prepareCheckout
+     * @returns {Promise<ApiResponse<CheckoutValidationData>>} Validation result with order details
+     *
+     * @description
+     * Validations performed:
+     * - Checkout reference is valid and not expired
+     * - User is still a valid group member
+     * - Group hasn't changed status since prepare
+     * - Pricing/reward data is consistent
+     * - Order can safely proceed
+     *
+     * @example
+     * ```typescript
+     * const validateResp = await client.validateCheckout('grp_xyz789', 'chk_abc123');
+     * if (validateResp.success) {
+     *   const order = validateResp.data;
+     *   console.log('Order total:', order.total);
+     *   console.log('Discount:', order.discount);
+     *   // Proceed to payment if validation passed
+     * }
+     * ```
      */
     async validateCheckout(groupId, checkoutRef) {
         var _a;
@@ -5653,12 +6938,52 @@ class ApiClient {
     /**
      * Confirm checkout for a group
      *
-     * Finalizes the checkout and confirms the order.
-     * This should be called after validateCheckout to complete the checkout process.
+     * Finalizes and confirms the order after validation.
+     * Marks the order as complete, applies discounts, records the transaction,
+     * and triggers post-purchase workflows.
+     * Should be called after validateCheckout to complete the checkout flow.
+     *
+     * @param {string} groupId - The group ID being checked out
+     * @param {string} checkoutRef - The checkout reference from prepareCheckout
+     * @param {CheckoutConfirmData} [data] - Optional order details
+     * @param {string} [data.order_id] - Merchant's order ID for this purchase
+     * @param {number} [data.order_total] - Order total amount
+     * @param {number} [data.discount_applied] - Discount amount applied
+     * @param {string} [data.currency] - Currency code (e.g., "USD")
+     * @param {string} [data.payment_method] - Payment method used (e.g., "card", "paypal")
+     * @param {boolean} [data.micrositeCheckout] - Whether this was via microsite checkout
+     * @param {Record<string, unknown>} [data.metadata] - Custom metadata to attach to order
+     * @returns {Promise<ApiResponse<void>>} Confirmation result
+     *
+     * @description
+     * Actions performed after confirmation:
+     * - Order is recorded in the system
+     * - Discount is applied to the order
+     * - Group fulfillment may be triggered if complete
+     * - Merchant order system is updated
+     * - Customer receives confirmation
+     * - Post-purchase emails/notifications sent
+     * - Analytics events recorded
      *
-     * @param groupId - The group ID to confirm checkout for
-     * @param checkoutRef - The checkout reference ID from the prepare step
-     * @returns Promise with success status
+     * @example
+     * ```typescript
+     * // Confirm with basic reference
+     * await client.confirmCheckout('grp_xyz789', 'chk_abc123');
+     *
+     * // Confirm with order details
+     * await client.confirmCheckout('grp_xyz789', 'chk_abc123', {
+     *   order_id: 'ORDER-9001',
+     *   order_total: 99.99,
+     *   discount_applied: 20.00,
+     *   currency: 'USD',
+     *   payment_method: 'card',
+     *   metadata: {
+     *     coupon_code: 'WELCOME20',
+     *     channel: 'widget',
+     *     loyalty_member: true
+     *   }
+     * });
+     * ```
      */
     async confirmCheckout(groupId, checkoutRef, data) {
         const endpoint = buildApiUrl("", API_ENDPOINTS.GROUP_CHECKOUT_CONFIRM, { groupId });
@@ -5737,9 +7062,13 @@ class AnalyticsClient {
     }
     /**
      * Send event to backend analytics endpoint using unified ApiClient
+     *
+     * @throws {CoBuyApiError} If API request fails
+     * @private
+     * @internal
      */
     async sendEvent(event) {
-        var _a, _b;
+        var _a, _b, _c, _d;
         if (!this.apiClient) {
             this.logger.warn("[Analytics] ApiClient not available, skipping event");
             return;
@@ -5750,14 +7079,21 @@ class AnalyticsClient {
                 body: event,
             });
             if (!response.success) {
-                throw new Error(((_a = response.error) === null || _a === void 0 ? void 0 : _a.message) || "Failed to send analytics event");
+                const error = new CoBuyApiError(((_a = response.error) === null || _a === void 0 ? void 0 : _a.message) || "Failed to send analytics event", ((_b = response.error) === null || _b === void 0 ? void 0 : _b.code) || "ANALYTICS_ERROR", {
+                    statusCode: (_c = response.error) === null || _c === void 0 ? void 0 : _c.statusCode,
+                    originalError: response.error,
+                });
+                throw error;
             }
-            this.logger.debug("[Analytics] Event recorded", { id: (_b = response.data) === null || _b === void 0 ? void 0 : _b.id });
+            this.logger.debug("[Analytics] Event recorded", { id: (_d = response.data) === null || _d === void 0 ? void 0 : _d.id });
         }
         catch (error) {
             this.logger.error("[Analytics] Failed to send event", error);
-            // Re-throw for caller to handle if needed
-            throw error;
+            // Wrap non-CoBuyApiError exceptions
+            if (error instanceof CoBuyApiError) {
+                throw error;
+            }
+            throw new CoBuyApiError(error instanceof Error ? error.message : "Unknown analytics error", "ANALYTICS_ERROR", { originalError: error });
         }
     }
     /**
@@ -8960,7 +10296,6 @@ class Socket extends Emitter {
             flags: Object.assign({ fromQueue: true }, this.flags),
         };
         args.push((err, ...responseArgs) => {
-            if (packet !== this._queue[0]) ;
             const hasError = err !== null;
             if (hasError) {
                 if (packet.tryCount > this._opts.retries) {
@@ -10103,16 +11438,825 @@ class SocketManager {
 }
 
 /**
- * SDK version constant
+ * Fingerprint BotD v2.0.0 - Copyright (c) FingerprintJS, Inc, 2025 (https://fingerprint.com)
+ * Licensed under the MIT (http://www.opensource.org/licenses/mit-license.php) license.
  */
-const SDK_VERSION = "1.0.0";
+
+var version = "2.0.0";
+
 /**
- * Main CoBuy SDK implementation
+ * Enum for types of bots.
+ * Specific types of bots come first, followed by automation technologies.
+ *
+ * @readonly
+ * @enum {string}
  */
-class CoBuy {
-    constructor() {
-        this.apiClient = null;
-        this.analyticsClient = null;
+const BotKind = {
+    // Object is used instead of Typescript enum to avoid emitting IIFE which might be affected by further tree-shaking.
+    // See example of compiled enums https://stackoverflow.com/q/47363996)
+    Awesomium: 'awesomium',
+    Cef: 'cef',
+    CefSharp: 'cefsharp',
+    CoachJS: 'coachjs',
+    Electron: 'electron',
+    FMiner: 'fminer',
+    Geb: 'geb',
+    NightmareJS: 'nightmarejs',
+    Phantomas: 'phantomas',
+    PhantomJS: 'phantomjs',
+    Rhino: 'rhino',
+    Selenium: 'selenium',
+    Sequentum: 'sequentum',
+    SlimerJS: 'slimerjs',
+    WebDriverIO: 'webdriverio',
+    WebDriver: 'webdriver',
+    HeadlessChrome: 'headless_chrome',
+    Unknown: 'unknown',
+};
+/**
+ * Bot detection error.
+ */
+class BotdError extends Error {
+    /**
+     * Creates a new BotdError.
+     *
+     * @class
+     */
+    constructor(state, message) {
+        super(message);
+        this.state = state;
+        this.name = 'BotdError';
+        Object.setPrototypeOf(this, BotdError.prototype);
+    }
+}
+
+function detect(components, detectors) {
+    const detections = {};
+    let finalDetection = {
+        bot: false,
+    };
+    for (const detectorName in detectors) {
+        const detector = detectors[detectorName];
+        const detectorRes = detector(components);
+        let detection = { bot: false };
+        if (typeof detectorRes === 'string') {
+            detection = { bot: true, botKind: detectorRes };
+        }
+        else if (detectorRes) {
+            detection = { bot: true, botKind: BotKind.Unknown };
+        }
+        detections[detectorName] = detection;
+        if (detection.bot) {
+            finalDetection = detection;
+        }
+    }
+    return [detections, finalDetection];
+}
+async function collect(sources) {
+    const components = {};
+    const sourcesKeys = Object.keys(sources);
+    await Promise.all(sourcesKeys.map(async (sourceKey) => {
+        const res = sources[sourceKey];
+        try {
+            components[sourceKey] = {
+                value: await res(),
+                state: 0 /* State.Success */,
+            };
+        }
+        catch (error) {
+            if (error instanceof BotdError) {
+                components[sourceKey] = {
+                    state: error.state,
+                    error: `${error.name}: ${error.message}`,
+                };
+            }
+            else {
+                components[sourceKey] = {
+                    state: -3 /* State.UnexpectedBehaviour */,
+                    error: error instanceof Error ? `${error.name}: ${error.message}` : String(error),
+                };
+            }
+        }
+    }));
+    return components;
+}
+
+function detectAppVersion({ appVersion }) {
+    if (appVersion.state !== 0 /* State.Success */)
+        return false;
+    if (/headless/i.test(appVersion.value))
+        return BotKind.HeadlessChrome;
+    if (/electron/i.test(appVersion.value))
+        return BotKind.Electron;
+    if (/slimerjs/i.test(appVersion.value))
+        return BotKind.SlimerJS;
+}
+
+function arrayIncludes(arr, value) {
+    return arr.indexOf(value) !== -1;
+}
+function strIncludes(str, value) {
+    return str.indexOf(value) !== -1;
+}
+function arrayFind(array, callback) {
+    if ('find' in array)
+        return array.find(callback);
+    for (let i = 0; i < array.length; i++) {
+        if (callback(array[i], i, array))
+            return array[i];
+    }
+    return undefined;
+}
+
+function getObjectProps(obj) {
+    return Object.getOwnPropertyNames(obj);
+}
+function includes(arr, ...keys) {
+    for (const key of keys) {
+        if (typeof key === 'string') {
+            if (arrayIncludes(arr, key))
+                return true;
+        }
+        else {
+            const match = arrayFind(arr, (value) => key.test(value));
+            if (match != null)
+                return true;
+        }
+    }
+    return false;
+}
+function countTruthy(values) {
+    return values.reduce((sum, value) => sum + (value ? 1 : 0), 0);
+}
+
+function detectDocumentAttributes({ documentElementKeys }) {
+    if (documentElementKeys.state !== 0 /* State.Success */)
+        return false;
+    if (includes(documentElementKeys.value, 'selenium', 'webdriver', 'driver')) {
+        return BotKind.Selenium;
+    }
+}
+
+function detectErrorTrace({ errorTrace }) {
+    if (errorTrace.state !== 0 /* State.Success */)
+        return false;
+    if (/PhantomJS/i.test(errorTrace.value))
+        return BotKind.PhantomJS;
+}
+
+function detectEvalLengthInconsistency({ evalLength, browserKind, browserEngineKind, }) {
+    if (evalLength.state !== 0 /* State.Success */ ||
+        browserKind.state !== 0 /* State.Success */ ||
+        browserEngineKind.state !== 0 /* State.Success */)
+        return;
+    const length = evalLength.value;
+    if (browserEngineKind.value === "unknown" /* BrowserEngineKind.Unknown */)
+        return false;
+    return ((length === 37 && !arrayIncludes(["webkit" /* BrowserEngineKind.Webkit */, "gecko" /* BrowserEngineKind.Gecko */], browserEngineKind.value)) ||
+        (length === 39 && !arrayIncludes(["internet_explorer" /* BrowserKind.IE */], browserKind.value)) ||
+        (length === 33 && !arrayIncludes(["chromium" /* BrowserEngineKind.Chromium */], browserEngineKind.value)));
+}
+
+function detectFunctionBind({ functionBind }) {
+    if (functionBind.state === -2 /* State.NotFunction */)
+        return BotKind.PhantomJS;
+}
+
+function detectLanguagesLengthInconsistency({ languages }) {
+    if (languages.state === 0 /* State.Success */ && languages.value.length === 0) {
+        return BotKind.HeadlessChrome;
+    }
+}
+
+function detectMimeTypesConsistent({ mimeTypesConsistent }) {
+    if (mimeTypesConsistent.state === 0 /* State.Success */ && !mimeTypesConsistent.value) {
+        return BotKind.Unknown;
+    }
+}
+
+function detectNotificationPermissions({ notificationPermissions, browserKind, }) {
+    if (browserKind.state !== 0 /* State.Success */ || browserKind.value !== "chrome" /* BrowserKind.Chrome */)
+        return false;
+    if (notificationPermissions.state === 0 /* State.Success */ && notificationPermissions.value) {
+        return BotKind.HeadlessChrome;
+    }
+}
+
+function detectPluginsArray({ pluginsArray }) {
+    if (pluginsArray.state === 0 /* State.Success */ && !pluginsArray.value)
+        return BotKind.HeadlessChrome;
+}
+
+function detectPluginsLengthInconsistency({ pluginsLength, android, browserKind, browserEngineKind, }) {
+    if (pluginsLength.state !== 0 /* State.Success */ ||
+        android.state !== 0 /* State.Success */ ||
+        browserKind.state !== 0 /* State.Success */ ||
+        browserEngineKind.state !== 0 /* State.Success */)
+        return;
+    if (browserKind.value !== "chrome" /* BrowserKind.Chrome */ ||
+        android.value ||
+        browserEngineKind.value !== "chromium" /* BrowserEngineKind.Chromium */)
+        return;
+    if (pluginsLength.value === 0)
+        return BotKind.HeadlessChrome;
+}
+
+function detectProcess({ process }) {
+    var _a;
+    if (process.state !== 0 /* State.Success */)
+        return false;
+    if (process.value.type === 'renderer' || ((_a = process.value.versions) === null || _a === void 0 ? void 0 : _a.electron) != null)
+        return BotKind.Electron;
+}
+
+function detectProductSub({ productSub, browserKind }) {
+    if (productSub.state !== 0 /* State.Success */ || browserKind.state !== 0 /* State.Success */)
+        return false;
+    if ((browserKind.value === "chrome" /* BrowserKind.Chrome */ ||
+        browserKind.value === "safari" /* BrowserKind.Safari */ ||
+        browserKind.value === "opera" /* BrowserKind.Opera */ ||
+        browserKind.value === "wechat" /* BrowserKind.WeChat */) &&
+        productSub.value !== '20030107')
+        return BotKind.Unknown;
+}
+
+function detectUserAgent({ userAgent }) {
+    if (userAgent.state !== 0 /* State.Success */)
+        return false;
+    if (/PhantomJS/i.test(userAgent.value))
+        return BotKind.PhantomJS;
+    if (/Headless/i.test(userAgent.value))
+        return BotKind.HeadlessChrome;
+    if (/Electron/i.test(userAgent.value))
+        return BotKind.Electron;
+    if (/slimerjs/i.test(userAgent.value))
+        return BotKind.SlimerJS;
+}
+
+function detectWebDriver({ webDriver }) {
+    if (webDriver.state === 0 /* State.Success */ && webDriver.value)
+        return BotKind.HeadlessChrome;
+}
+
+function detectWebGL({ webGL }) {
+    if (webGL.state === 0 /* State.Success */) {
+        const { vendor, renderer } = webGL.value;
+        if (vendor == 'Brian Paul' && renderer == 'Mesa OffScreen') {
+            return BotKind.HeadlessChrome;
+        }
+    }
+}
+
+function detectWindowExternal({ windowExternal }) {
+    if (windowExternal.state !== 0 /* State.Success */)
+        return false;
+    if (/Sequentum/i.test(windowExternal.value))
+        return BotKind.Sequentum;
+}
+
+function detectWindowSize({ windowSize, documentFocus }) {
+    if (windowSize.state !== 0 /* State.Success */ || documentFocus.state !== 0 /* State.Success */)
+        return false;
+    const { outerWidth, outerHeight } = windowSize.value;
+    // When a page is opened in a new tab without focusing it right away, the window outer size is 0x0
+    if (!documentFocus.value)
+        return;
+    if (outerWidth === 0 && outerHeight === 0)
+        return BotKind.HeadlessChrome;
+}
+
+function detectDistinctiveProperties({ distinctiveProps }) {
+    if (distinctiveProps.state !== 0 /* State.Success */)
+        return false;
+    const value = distinctiveProps.value;
+    let bot;
+    for (bot in value)
+        if (value[bot])
+            return bot;
+}
+
+// eslint-disable-next-line @typescript-eslint/explicit-module-boundary-types
+const detectors = {
+    detectAppVersion,
+    detectDocumentAttributes,
+    detectErrorTrace,
+    detectEvalLengthInconsistency,
+    detectFunctionBind,
+    detectLanguagesLengthInconsistency,
+    detectNotificationPermissions,
+    detectPluginsArray,
+    detectPluginsLengthInconsistency,
+    detectProcess,
+    detectUserAgent,
+    detectWebDriver,
+    detectWebGL,
+    detectWindowExternal,
+    detectWindowSize,
+    detectMimeTypesConsistent,
+    detectProductSub,
+    detectDistinctiveProperties,
+};
+
+function getAppVersion() {
+    const appVersion = navigator.appVersion;
+    if (appVersion == undefined) {
+        throw new BotdError(-1 /* State.Undefined */, 'navigator.appVersion is undefined');
+    }
+    return appVersion;
+}
+
+function getDocumentElementKeys() {
+    if (document.documentElement === undefined) {
+        throw new BotdError(-1 /* State.Undefined */, 'document.documentElement is undefined');
+    }
+    const { documentElement } = document;
+    if (typeof documentElement.getAttributeNames !== 'function') {
+        throw new BotdError(-2 /* State.NotFunction */, 'document.documentElement.getAttributeNames is not a function');
+    }
+    return documentElement.getAttributeNames();
+}
+
+function getErrorTrace() {
+    try {
+        // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+        // @ts-ignore
+        null[0]();
+    }
+    catch (error) {
+        if (error instanceof Error && error['stack'] != null) {
+            return error.stack.toString();
+        }
+    }
+    throw new BotdError(-3 /* State.UnexpectedBehaviour */, 'errorTrace signal unexpected behaviour');
+}
+
+function getEvalLength() {
+    return eval.toString().length;
+}
+
+function getFunctionBind() {
+    if (Function.prototype.bind === undefined) {
+        throw new BotdError(-2 /* State.NotFunction */, 'Function.prototype.bind is undefined');
+    }
+    return Function.prototype.bind.toString();
+}
+
+function getBrowserEngineKind() {
+    var _a, _b;
+    // Based on research in October 2020. Tested to detect Chromium 42-86.
+    const w = window;
+    const n = navigator;
+    if (countTruthy([
+        'webkitPersistentStorage' in n,
+        'webkitTemporaryStorage' in n,
+        n.vendor.indexOf('Google') === 0,
+        'webkitResolveLocalFileSystemURL' in w,
+        'BatteryManager' in w,
+        'webkitMediaStream' in w,
+        'webkitSpeechGrammar' in w,
+    ]) >= 5) {
+        return "chromium" /* BrowserEngineKind.Chromium */;
+    }
+    if (countTruthy([
+        'ApplePayError' in w,
+        'CSSPrimitiveValue' in w,
+        'Counter' in w,
+        n.vendor.indexOf('Apple') === 0,
+        'getStorageUpdates' in n,
+        'WebKitMediaKeys' in w,
+    ]) >= 4) {
+        return "webkit" /* BrowserEngineKind.Webkit */;
+    }
+    if (countTruthy([
+        'buildID' in navigator,
+        'MozAppearance' in ((_b = (_a = document.documentElement) === null || _a === void 0 ? void 0 : _a.style) !== null && _b !== void 0 ? _b : {}),
+        'onmozfullscreenchange' in w,
+        'mozInnerScreenX' in w,
+        'CSSMozDocumentRule' in w,
+        'CanvasCaptureMediaStream' in w,
+    ]) >= 4) {
+        return "gecko" /* BrowserEngineKind.Gecko */;
+    }
+    return "unknown" /* BrowserEngineKind.Unknown */;
+}
+function getBrowserKind() {
+    var _a;
+    const userAgent = (_a = navigator.userAgent) === null || _a === void 0 ? void 0 : _a.toLowerCase();
+    if (strIncludes(userAgent, 'edg/')) {
+        return "edge" /* BrowserKind.Edge */;
+    }
+    else if (strIncludes(userAgent, 'trident') || strIncludes(userAgent, 'msie')) {
+        return "internet_explorer" /* BrowserKind.IE */;
+    }
+    else if (strIncludes(userAgent, 'wechat')) {
+        return "wechat" /* BrowserKind.WeChat */;
+    }
+    else if (strIncludes(userAgent, 'firefox')) {
+        return "firefox" /* BrowserKind.Firefox */;
+    }
+    else if (strIncludes(userAgent, 'opera') || strIncludes(userAgent, 'opr')) {
+        return "opera" /* BrowserKind.Opera */;
+    }
+    else if (strIncludes(userAgent, 'chrome')) {
+        return "chrome" /* BrowserKind.Chrome */;
+    }
+    else if (strIncludes(userAgent, 'safari')) {
+        return "safari" /* BrowserKind.Safari */;
+    }
+    else {
+        return "unknown" /* BrowserKind.Unknown */;
+    }
+}
+// Source: https://github.com/fingerprintjs/fingerprintjs/blob/master/src/utils/browser.ts#L223
+function isAndroid() {
+    const browserEngineKind = getBrowserEngineKind();
+    const isItChromium = browserEngineKind === "chromium" /* BrowserEngineKind.Chromium */;
+    const isItGecko = browserEngineKind === "gecko" /* BrowserEngineKind.Gecko */;
+    const w = window;
+    const n = navigator;
+    const c = 'connection';
+    // Chrome removes all words "Android" from `navigator` when desktop version is requested
+    // Firefox keeps "Android" in `navigator.appVersion` when desktop version is requested
+    if (isItChromium) {
+        return (countTruthy([
+            !('SharedWorker' in w),
+            // `typechange` is deprecated, but it's still present on Android (tested on Chrome Mobile 117)
+            // Removal proposal https://bugs.chromium.org/p/chromium/issues/detail?id=699892
+            // Note: this expression returns true on ChromeOS, so additional detectors are required to avoid false-positives
+            n[c] && 'ontypechange' in n[c],
+            !('sinkId' in new Audio()),
+        ]) >= 2);
+    }
+    else if (isItGecko) {
+        return countTruthy(['onorientationchange' in w, 'orientation' in w, /android/i.test(n.appVersion)]) >= 2;
+    }
+    else {
+        // Only 2 browser engines are presented on Android.
+        // Actually, there is also Android 4.1 browser, but it's not worth detecting it at the moment.
+        return false;
+    }
+}
+function getDocumentFocus() {
+    if (document.hasFocus === undefined) {
+        return false;
+    }
+    return document.hasFocus();
+}
+function isChromium86OrNewer() {
+    // Checked in Chrome 85 vs Chrome 86 both on desktop and Android. Checked in macOS Chrome 128, Android Chrome 127.
+    const w = window;
+    return (countTruthy([
+        !('MediaSettingsRange' in w),
+        'RTCEncodedAudioFrame' in w,
+        '' + w.Intl === '[object Intl]',
+        '' + w.Reflect === '[object Reflect]',
+    ]) >= 3);
+}
+
+function getLanguages() {
+    const n = navigator;
+    const result = [];
+    const language = n.language || n.userLanguage || n.browserLanguage || n.systemLanguage;
+    if (language !== undefined) {
+        result.push([language]);
+    }
+    if (Array.isArray(n.languages)) {
+        const browserEngine = getBrowserEngineKind();
+        // Starting from Chromium 86, there is only a single value in `navigator.language` in Incognito mode:
+        // the value of `navigator.language`. Therefore, the value is ignored in this browser.
+        if (!(browserEngine === "chromium" /* BrowserEngineKind.Chromium */ && isChromium86OrNewer())) {
+            result.push(n.languages);
+        }
+    }
+    else if (typeof n.languages === 'string') {
+        const languages = n.languages;
+        if (languages) {
+            result.push(languages.split(','));
+        }
+    }
+    return result;
+}
+
+function areMimeTypesConsistent() {
+    if (navigator.mimeTypes === undefined) {
+        throw new BotdError(-1 /* State.Undefined */, 'navigator.mimeTypes is undefined');
+    }
+    const { mimeTypes } = navigator;
+    let isConsistent = Object.getPrototypeOf(mimeTypes) === MimeTypeArray.prototype;
+    for (let i = 0; i < mimeTypes.length; i++) {
+        isConsistent && (isConsistent = Object.getPrototypeOf(mimeTypes[i]) === MimeType.prototype);
+    }
+    return isConsistent;
+}
+
+async function getNotificationPermissions() {
+    if (window.Notification === undefined) {
+        throw new BotdError(-1 /* State.Undefined */, 'window.Notification is undefined');
+    }
+    if (navigator.permissions === undefined) {
+        throw new BotdError(-1 /* State.Undefined */, 'navigator.permissions is undefined');
+    }
+    const { permissions } = navigator;
+    if (typeof permissions.query !== 'function') {
+        throw new BotdError(-2 /* State.NotFunction */, 'navigator.permissions.query is not a function');
+    }
+    try {
+        const permissionStatus = await permissions.query({ name: 'notifications' });
+        return window.Notification.permission === 'denied' && permissionStatus.state === 'prompt';
+    }
+    catch (e) {
+        throw new BotdError(-3 /* State.UnexpectedBehaviour */, 'notificationPermissions signal unexpected behaviour');
+    }
+}
+
+function getPluginsArray() {
+    if (navigator.plugins === undefined) {
+        throw new BotdError(-1 /* State.Undefined */, 'navigator.plugins is undefined');
+    }
+    if (window.PluginArray === undefined) {
+        throw new BotdError(-1 /* State.Undefined */, 'window.PluginArray is undefined');
+    }
+    return navigator.plugins instanceof PluginArray;
+}
+
+function getPluginsLength() {
+    if (navigator.plugins === undefined) {
+        throw new BotdError(-1 /* State.Undefined */, 'navigator.plugins is undefined');
+    }
+    if (navigator.plugins.length === undefined) {
+        throw new BotdError(-3 /* State.UnexpectedBehaviour */, 'navigator.plugins.length is undefined');
+    }
+    return navigator.plugins.length;
+}
+
+function getProcess() {
+    const { process } = window;
+    const errorPrefix = 'window.process is';
+    if (process === undefined) {
+        throw new BotdError(-1 /* State.Undefined */, `${errorPrefix} undefined`);
+    }
+    if (process && typeof process !== 'object') {
+        throw new BotdError(-3 /* State.UnexpectedBehaviour */, `${errorPrefix} not an object`);
+    }
+    return process;
+}
+
+function getProductSub() {
+    const { productSub } = navigator;
+    if (productSub === undefined) {
+        throw new BotdError(-1 /* State.Undefined */, 'navigator.productSub is undefined');
+    }
+    return productSub;
+}
+
+function getRTT() {
+    if (navigator.connection === undefined) {
+        throw new BotdError(-1 /* State.Undefined */, 'navigator.connection is undefined');
+    }
+    if (navigator.connection.rtt === undefined) {
+        throw new BotdError(-1 /* State.Undefined */, 'navigator.connection.rtt is undefined');
+    }
+    return navigator.connection.rtt;
+}
+
+function getUserAgent() {
+    return navigator.userAgent;
+}
+
+function getWebDriver() {
+    if (navigator.webdriver == undefined) {
+        throw new BotdError(-1 /* State.Undefined */, 'navigator.webdriver is undefined');
+    }
+    return navigator.webdriver;
+}
+
+function getWebGL() {
+    const canvasElement = document.createElement('canvas');
+    if (typeof canvasElement.getContext !== 'function') {
+        throw new BotdError(-2 /* State.NotFunction */, 'HTMLCanvasElement.getContext is not a function');
+    }
+    const webGLContext = canvasElement.getContext('webgl');
+    if (webGLContext === null) {
+        throw new BotdError(-4 /* State.Null */, 'WebGLRenderingContext is null');
+    }
+    if (typeof webGLContext.getParameter !== 'function') {
+        throw new BotdError(-2 /* State.NotFunction */, 'WebGLRenderingContext.getParameter is not a function');
+    }
+    const vendor = webGLContext.getParameter(webGLContext.VENDOR);
+    const renderer = webGLContext.getParameter(webGLContext.RENDERER);
+    return { vendor: vendor, renderer: renderer };
+}
+
+function getWindowExternal() {
+    if (window.external === undefined) {
+        throw new BotdError(-1 /* State.Undefined */, 'window.external is undefined');
+    }
+    const { external } = window;
+    if (typeof external.toString !== 'function') {
+        throw new BotdError(-2 /* State.NotFunction */, 'window.external.toString is not a function');
+    }
+    return external.toString();
+}
+
+function getWindowSize() {
+    return {
+        outerWidth: window.outerWidth,
+        outerHeight: window.outerHeight,
+        innerWidth: window.innerWidth,
+        innerHeight: window.innerHeight,
+    };
+}
+
+function checkDistinctiveProperties() {
+    // The order in the following list matters, because specific types of bots come first, followed by automation technologies.
+    const distinctivePropsList = {
+        [BotKind.Awesomium]: {
+            window: ['awesomium'],
+        },
+        [BotKind.Cef]: {
+            window: ['RunPerfTest'],
+        },
+        [BotKind.CefSharp]: {
+            window: ['CefSharp'],
+        },
+        [BotKind.CoachJS]: {
+            window: ['emit'],
+        },
+        [BotKind.FMiner]: {
+            window: ['fmget_targets'],
+        },
+        [BotKind.Geb]: {
+            window: ['geb'],
+        },
+        [BotKind.NightmareJS]: {
+            window: ['__nightmare', 'nightmare'],
+        },
+        [BotKind.Phantomas]: {
+            window: ['__phantomas'],
+        },
+        [BotKind.PhantomJS]: {
+            window: ['callPhantom', '_phantom'],
+        },
+        [BotKind.Rhino]: {
+            window: ['spawn'],
+        },
+        [BotKind.Selenium]: {
+            window: ['_Selenium_IDE_Recorder', '_selenium', 'calledSelenium', /^([a-z]){3}_.*_(Array|Promise|Symbol)$/],
+            document: ['__selenium_evaluate', 'selenium-evaluate', '__selenium_unwrapped'],
+        },
+        [BotKind.WebDriverIO]: {
+            window: ['wdioElectron'],
+        },
+        [BotKind.WebDriver]: {
+            window: [
+                'webdriver',
+                '__webdriverFunc',
+                '__lastWatirAlert',
+                '__lastWatirConfirm',
+                '__lastWatirPrompt',
+                '_WEBDRIVER_ELEM_CACHE',
+                'ChromeDriverw',
+            ],
+            document: [
+                '__webdriver_script_fn',
+                '__driver_evaluate',
+                '__webdriver_evaluate',
+                '__fxdriver_evaluate',
+                '__driver_unwrapped',
+                '__webdriver_unwrapped',
+                '__fxdriver_unwrapped',
+                '__webdriver_script_fn',
+                '__webdriver_script_func',
+                '__webdriver_script_function',
+                '$cdc_asdjflasutopfhvcZLmcf',
+                '$cdc_asdjflasutopfhvcZLmcfl_',
+                '$chrome_asyncScriptInfo',
+                '__$webdriverAsyncExecutor',
+            ],
+        },
+        [BotKind.HeadlessChrome]: {
+            window: ['domAutomation', 'domAutomationController'],
+        },
+    };
+    let botName;
+    const result = {};
+    const windowProps = getObjectProps(window);
+    let documentProps = [];
+    if (window.document !== undefined)
+        documentProps = getObjectProps(window.document);
+    for (botName in distinctivePropsList) {
+        const props = distinctivePropsList[botName];
+        if (props !== undefined) {
+            const windowContains = props.window === undefined ? false : includes(windowProps, ...props.window);
+            const documentContains = props.document === undefined || !documentProps.length ? false : includes(documentProps, ...props.document);
+            result[botName] = windowContains || documentContains;
+        }
+    }
+    return result;
+}
+
+const sources = {
+    android: isAndroid,
+    browserKind: getBrowserKind,
+    browserEngineKind: getBrowserEngineKind,
+    documentFocus: getDocumentFocus,
+    userAgent: getUserAgent,
+    appVersion: getAppVersion,
+    rtt: getRTT,
+    windowSize: getWindowSize,
+    pluginsLength: getPluginsLength,
+    pluginsArray: getPluginsArray,
+    errorTrace: getErrorTrace,
+    productSub: getProductSub,
+    windowExternal: getWindowExternal,
+    mimeTypesConsistent: areMimeTypesConsistent,
+    evalLength: getEvalLength,
+    webGL: getWebGL,
+    webDriver: getWebDriver,
+    languages: getLanguages,
+    notificationPermissions: getNotificationPermissions,
+    documentElementKeys: getDocumentElementKeys,
+    functionBind: getFunctionBind,
+    process: getProcess,
+    distinctiveProps: checkDistinctiveProperties,
+};
+
+/**
+ * Class representing a bot detector.
+ *
+ * @class
+ * @implements {BotDetectorInterface}
+ */
+class BotDetector {
+    constructor() {
+        this.components = undefined;
+        this.detections = undefined;
+    }
+    getComponents() {
+        return this.components;
+    }
+    getDetections() {
+        return this.detections;
+    }
+    /**
+     * @inheritdoc
+     */
+    detect() {
+        if (this.components === undefined) {
+            throw new Error("BotDetector.detect can't be called before BotDetector.collect");
+        }
+        const [detections, finalDetection] = detect(this.components, detectors);
+        this.detections = detections;
+        return finalDetection;
+    }
+    /**
+     * @inheritdoc
+     */
+    async collect() {
+        this.components = await collect(sources);
+        return this.components;
+    }
+}
+
+/**
+ * Sends an unpersonalized AJAX request to collect installation statistics
+ */
+function monitor() {
+    // The FingerprintJS CDN (https://github.com/fingerprintjs/cdn) replaces `window.__fpjs_d_m` with `true`
+    if (window.__fpjs_d_m || Math.random() >= 0.001) {
+        return;
+    }
+    try {
+        const request = new XMLHttpRequest();
+        request.open('get', `https://m1.openfpcdn.io/botd/v${version}/npm-monitoring`, true);
+        request.send();
+    }
+    catch (error) {
+        // console.error is ok here because it's an unexpected error handler
+        // eslint-disable-next-line no-console
+        console.error(error);
+    }
+}
+async function load({ monitoring = true } = {}) {
+    if (monitoring) {
+        monitor();
+    }
+    const detector = new BotDetector();
+    await detector.collect();
+    return detector;
+}
+
+/**
+ * SDK version constant
+ */
+const SDK_VERSION = "1.0.0";
+/**
+ * Main CoBuy SDK implementation
+ */
+class CoBuy {
+    constructor() {
+        this.apiClient = null;
+        this.analyticsClient = null;
         this.sessionId = "";
         this.SESSION_STORAGE_KEY = "cobuy_sdk_session_id";
         this.CHECKOUT_REF_PREFIX = "cobuy_checkout_ref";
@@ -10219,6 +12363,49 @@ class CoBuy {
     getSessionId() {
         return this.sessionId;
     }
+    /**
+     * Initialize BotD detection and store score for API requests
+     */
+    async initializeBotd() {
+        if (typeof window === "undefined") {
+            return;
+        }
+        try {
+            const botd = await load();
+            const result = botd.detect();
+            const score = typeof result.score === "number" ? result.score : result.bot ? 1 : 0;
+            this.botdScore = score;
+            if (this.apiClient) {
+                this.apiClient.setBotdScore(score);
+            }
+            this.logger.debug(`[SDK] BotD initialized with score: ${score}`);
+        }
+        catch (error) {
+            this.logger.warn("[SDK] BotD initialization failed", error);
+        }
+    }
+    handleFraudError(error, context) {
+        var _a;
+        if (!error || error.code !== "FRAUD_DETECTED") {
+            return false;
+        }
+        try {
+            const config = this.configManager.getConfig();
+            if ((_a = config.events) === null || _a === void 0 ? void 0 : _a.onFraudDetected) {
+                config.events.onFraudDetected({
+                    code: error.code,
+                    message: error.message || "Request blocked by fraud detection",
+                    statusCode: error.statusCode,
+                    context,
+                });
+            }
+        }
+        catch (e) {
+            this.logger.warn("[SDK] Fraud handler failed", e);
+        }
+        this.logger.warn("[SDK] Fraud detected", { context, error });
+        return true;
+    }
     /**
      * Prepare checkout for a group if not already prepared
      * Checks localStorage to prevent duplicate calls for the same product/group/session
@@ -10246,6 +12433,9 @@ class CoBuy {
                 this.logger.info(`[SDK] Checkout prepared and stored for ${productId}:${groupId} - Ref: ${checkoutRef}`);
             }
             else {
+                if (this.handleFraudError(response.error, "prepareCheckout")) {
+                    return;
+                }
                 this.logger.error("[SDK] Failed to prepare checkout", response.error);
             }
         }
@@ -10254,7 +12444,49 @@ class CoBuy {
         }
     }
     /**
-     * Initialize the SDK with configuration
+     * Initialize the CoBuy SDK with configuration
+     *
+     * Must be called before rendering widgets or opening modals.
+     *
+     * @param {CoBuyInitOptions} options - SDK configuration options
+     * @param {"public" | "token"} options.authMode - Authentication mode (public key or session token)
+     * @param {string} [options.merchantKey] - Merchant public key (required for public mode)
+     * @param {string | (() => string | Promise<string>)} [options.sessionToken] - Session token (required for token mode)
+     * @param {"dev" | "prod"} [options.env] - Environment (dev or prod, defaults to prod)
+     * @param {boolean} [options.debug] - Enable debug logging
+     * @param {Object} [options.auth] - Optional auth callbacks (onAuthError, onTokenExpired)
+     * @param {Object} [options.events] - Optional event handlers (onGroupFulfilled, onGroupCreated, onGroupMemberJoined, onModalOpen, onModalClose)
+     * @param {Object} [options.customHeaders] - Optional custom headers to include in API requests
+     *
+     * @throws {Error} If required configuration is missing or invalid
+     *
+     * @example
+     * ```typescript
+     * // Initialize with public key authentication
+     * CoBuy.init({
+     *   authMode: 'public',
+     *   merchantKey: 'pk_live_abc123xyz',
+     *   env: 'prod',
+     *   debug: false
+     * });
+     *
+     * // Initialize with session token
+     * CoBuy.init({
+     *   authMode: 'token',
+     *   sessionToken: 'token_abc123xyz',
+     *   env: 'prod'
+     * });
+     *
+     * // Initialize with async token provider
+     * CoBuy.init({
+     *   authMode: 'token',
+     *   sessionToken: async () => {
+     *     const response = await fetch('/api/token');
+     *     return response.json().token;
+     *   },
+     *   env: 'prod'
+     * });
+     * ```
      */
     init(options) {
         var _a, _b, _c;
@@ -10288,7 +12520,14 @@ class CoBuy {
                 baseUrl: config.apiBaseUrl,
                 authStrategy,
                 sessionId: this.sessionId,
+                botdScore: this.botdScore,
                 debug: config.debug,
+                timeout: config.performance.requestTimeout,
+                maxRetries: config.performance.maxRetries,
+            });
+            // Initialize BotD detection in background (non-blocking)
+            this.initializeBotd().catch((error) => {
+                this.logger.warn("[SDK] BotD initialization error", error);
             });
             // Initialize Analytics client with the SDK's session ID
             this.analyticsClient = new AnalyticsClient(config.merchantKey || "token-mode", // Merchant key not used in token mode analytics
@@ -10354,37 +12593,131 @@ class CoBuy {
     }
     /**
      * Render the CoBuy widget into a DOM container
+     *
+     * Creates and renders a collaborative buying widget for a specific product.
+     * The widget displays group status, members, and allows users to join groups.
+     *
+     * @param {RenderWidgetOptions} options - Widget rendering options
+     * @param {string} options.productId - Product ID to render widget for (required)
+     * @param {string | HTMLElement} options.container - DOM selector or element to render into (required)
+     * @param {Object} [options.theme] - Optional theme configuration (colors, fonts, animations)
+     * @param {Function} [options.onGroupSelect] - Callback when user selects a group
+     * @param {Function} [options.onError] - Callback for rendering errors (optional, errors also throw)
+     *
+     * @returns {Promise<void>} Resolves when widget is rendered, rejects if rendering fails
+     *
+     * @throws {CoBuyNotInitializedError} If SDK not initialized before calling
+     * @throws {CoBuyRenderError} If container not found or rendering fails
+     * @throws {CoBuyValidationError} If productId validation fails
+     *
+     * @description
+     * Error Handling:
+     * - Synchronous errors (not initialized, missing productId) are thrown immediately
+     * - Asynchronous errors (network, container not found) cause Promise rejection
+     * - onError callback is called with error details (for backwards compatibility)
+     * - Always handle Promise rejection OR use try/catch for synchronous errors
+     *
+     * @example
+     * ```typescript
+     * // Option 1: Using try/catch (recommended)
+     * try {
+     *   await CoBuy.renderWidget({
+     *     productId: 'prod_abc123',
+     *     container: '#cobuy-widget-container'
+     *   });
+     * } catch (error) {
+     *   if (error instanceof CoBuyNotInitializedError) {
+     *     console.error('SDK not initialized');
+     *   } else if (error instanceof CoBuyRenderError) {
+     *     console.error('Widget render failed:', error.message);
+     *   }
+     * }
+     *
+     * // Option 2: Using .catch() (backwards compatible)
+     * CoBuy.renderWidget({
+     *   productId: 'prod_abc123',
+     *   container: '#widget'
+     * }).catch(error => {
+     *   console.error('Widget error:', error);
+     * });
+     *
+     * // Option 3: Using onError callback + error throwing
+     * CoBuy.renderWidget({
+     *   productId: 'prod_abc123',
+     *   container: '#widget',
+     *   onError: (error) => console.error('Async error:', error)
+     * }).catch(error => console.error('Promise rejected:', error));
+     * ```
      */
-    renderWidget(options) {
-        // Check if SDK is initialized
+    async renderWidget(options) {
+        var _a;
+        // Check if SDK is initialized - synchronous error
         if (!this.configManager.isInitialized()) {
             throw new CoBuyNotInitializedError();
         }
-        // Validate productId
+        // Validate productId - synchronous error
         if (!options.productId) {
             const errorMessage = "productId is required for renderWidget";
             this.logger.error(errorMessage);
-            if (options.onError) {
-                options.onError(new Error(errorMessage));
-            }
-            return;
+            const error = new Error(errorMessage);
+            (_a = options.onError) === null || _a === void 0 ? void 0 : _a.call(options, error);
+            throw error;
         }
         try {
             const config = this.configManager.getConfig();
             const widget = new WidgetRoot(config, this.apiClient, this.analyticsClient);
-            widget.render(options);
+            await widget.render(options);
             // Track widget instance so we can refresh it on important lifecycle events
             this.widgets.add(widget);
         }
         catch (error) {
             this.logger.error("Failed to render widget", error);
             if (options.onError) {
-                options.onError(error);
+                options.onError(error instanceof Error ? error : new Error(String(error)));
             }
+            throw error;
         }
     }
     /**
-     * Open modal for product details
+     * Open a lobby modal for a group
+     *
+     * Displays a modal with group details, members, progress, and actions.
+     * Only one modal is open at a time (others are automatically closed).
+     *
+     * @param {ModalOptions} options - Modal configuration
+     * @param {string} options.productId - Product ID for the modal
+     * @param {string} [options.groupId] - Group ID to display
+     * @param {number} [options.groupNumber] - Group number for display
+     * @param {string} [options.status] - Group status (e.g., 'pending', 'complete')
+     * @param {number} [options.progress] - Group progress percentage (0-100)
+     * @param {number} [options.currentMembers] - Current number of members
+     * @param {number} [options.totalMembers] - Total members needed
+     * @param {number} [options.timeLeft] - Seconds remaining before group closes
+     * @param {number} [options.discount] - Discount percentage
+     * @param {string} [options.groupLink] - Share link for the group
+     * @param {Array} [options.activities] - Group activity feed
+     * @param {boolean} [options.isLocked] - Whether group is locked
+     * @param {Function} [options.onOpen] - Callback when modal opens
+     * @param {Function} [options.onClose] - Callback when modal closes
+     * @param {Function} [options.onCopyLink] - Callback when share link is copied
+     * @param {Function} [options.onShare] - Callback when share action triggered
+     *
+     * @returns {void}
+     *
+     * @example
+     * ```typescript
+     * CoBuy.openModal({
+     *   productId: 'prod_abc123',
+     *   groupId: 'grp_xyz789',
+     *   status: 'pending',
+     *   progress: 75,
+     *   currentMembers: 3,
+     *   totalMembers: 4,
+     *   discount: 20,
+     *   onOpen: () => console.log('Modal opened'),
+     *   onClose: () => console.log('Modal closed')
+     * });
+     * ```
      */
     openModal(options) {
         var _a;
@@ -10439,7 +12772,7 @@ class CoBuy {
                 },
                 onCopyLink: options.onCopyLink,
                 onShare: options.onShare,
-            }, this.apiClient, this.analyticsClient, this.socketManager, config.debug);
+            }, this.apiClient, this.socketManager, config.debug);
             // Store in map for persistence
             this.modals.set(modalKey, modal);
             // Maintain backward compatibility
@@ -10471,7 +12804,17 @@ class CoBuy {
         }
     }
     /**
-     * Close the modal
+     * Close the currently open modal
+     *
+     * Closes and cleans up the active lobby modal if one is open.
+     * Safe to call even if no modal is currently open.
+     *
+     * @returns {void}
+     *
+     * @example
+     * ```typescript
+     * CoBuy.closeModal();
+     * ```
      */
     closeModal() {
         try {
@@ -10531,6 +12874,9 @@ class CoBuy {
                 this.logger.info(`Contact information set successfully (${contact.type})`);
             }
             else {
+                if (this.handleFraudError(response.error, "setContact")) {
+                    return;
+                }
                 this.logger.error("Failed to set contact information", response.error);
             }
         }
@@ -10569,6 +12915,9 @@ class CoBuy {
                 return response.data || null;
             }
             else {
+                if (this.handleFraudError(response.error, "validateCheckout")) {
+                    return null;
+                }
                 this.logger.error("Failed to validate checkout", response.error);
                 return null;
             }
@@ -10659,6 +13008,9 @@ class CoBuy {
                 await Promise.all(refreshPromises.map((p) => p.then(() => undefined).catch(() => undefined)));
             }
             else {
+                if (this.handleFraudError(response.error, "confirmCheckout")) {
+                    return;
+                }
                 this.logger.error("Failed to confirm checkout", response.error);
             }
         }
@@ -10668,30 +13020,91 @@ class CoBuy {
     }
     /**
      * Get the initialized API client instance
+     *
+     * Returns the API client used for making requests to the CoBuy backend.
+     * Useful for advanced integrations or direct API calls.
+     *
+     * @returns {ApiClient | null} The API client instance, or null if SDK not initialized
+     *
+     * @example
+     * ```typescript
+     * const apiClient = CoBuy.getApiClient();
+     * if (apiClient) {
+     *   const product = await apiClient.getProductReward('prod_abc123');
+     * }
+     * ```
      */
     getApiClient() {
         return this.apiClient;
     }
     /**
      * Get the initialized Analytics client instance
+     *
+     * Returns the analytics client used for tracking user interactions.
+     * Useful for advanced event tracking or integration with analytics systems.
+     *
+     * @returns {AnalyticsClient | null} The analytics client instance, or null if SDK not initialized
+     *
+     * @example
+     * ```typescript
+     * const analytics = CoBuy.getAnalyticsClient();
+     * if (analytics) {
+     *   await analytics.trackCustomEvent('user_action', { details: 'data' });
+     * }
+     * ```
      */
     getAnalyticsClient() {
         return this.analyticsClient;
     }
     /**
      * Get the initialized Socket manager instance
+     *
+     * Returns the socket manager used for real-time group updates.
+     * Only available in public authentication mode.
+     *
+     * @returns {SocketManager | null} The socket manager instance, or null if not initialized (token mode doesn't use sockets)
+     *
+     * @example
+     * ```typescript
+     * const socketManager = CoBuy.getSocketManager();
+     * if (socketManager) {
+     *   socketManager.bindHandlers({
+     *     onGroupCreated: (event) => console.log('New group:', event)
+     *   });
+     * }
+     * ```
      */
     getSocketManager() {
         return this.socketManager;
     }
     /**
-     * Get SDK version
+     * Get the SDK version
+     *
+     * Returns the current version of the CoBuy SDK.
+     *
+     * @returns {string} SDK version in semver format (e.g., "1.0.0")
+     *
+     * @example
+     * ```typescript
+     * console.log(`CoBuy SDK v${CoBuy.version}`);
+     * ```
      */
     get version() {
         return SDK_VERSION;
     }
     /**
-     * Clean up resources (sockets etc.) if needed by host app
+     * Destroy the SDK and clean up resources
+     *
+     * Closes websocket connections, unbinds event handlers, and releases resources.
+     * Call this when unloading the page or removing the SDK from use.
+     *
+     * @returns {void}
+     *
+     * @example
+     * ```typescript
+     * // When unmounting the SDK (e.g., React cleanup)
+     * CoBuy.destroy();
+     * ```
      */
     destroy() {
         try {
@@ -10707,17 +13120,19 @@ class CoBuy {
     }
 }
 
-// Create singleton instance
-const instance = new CoBuy();
-// Attach to window if in browser environment
-if (typeof window !== "undefined") {
-    if (window.CoBuy) {
-        console.warn("[CoBuy] Multiple SDK bundles detected. This may cause unexpected behavior.");
+// Create or reuse singleton instance
+const instance = (() => {
+    if (typeof window === "undefined") {
+        return new CoBuy();
     }
-    else {
-        window.CoBuy = instance;
+    if (window.CoBuy) {
+        console.warn("[CoBuy] Multiple SDK bundles detected. Reusing existing instance.");
+        return window.CoBuy;
     }
-}
+    const created = new CoBuy();
+    window.CoBuy = created;
+    return created;
+})();
 
 export { PublicKeyAuth, TokenAuth, instance as default };
 //# sourceMappingURL=cobuy-sdk.esm.js.map