@cshah18/sdk 2.0.0 → 3.0.1

package/dist/cobuy-sdk.esm.js

@@ -1305,6 +1305,21 @@ 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;
+        // }
         /**
          * Handle socket group update events
          */
@@ -2326,11 +2341,11 @@ class LobbyModal {
         // Stop timers and animations
         this.stopTimer();
         this.stopActivityAnimation();
-        // Unsubscribe from socket events and group
-        this.unsubscribeFromSocketEvents();
-        if (this.socketManager && this.currentGroupId) {
-            this.socketManager.unsubscribeFromGroup(this.currentGroupId);
-        }
+        // // 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 modal from DOM
         document.body.removeChild(this.modalElement);
         this.modalElement = null;
@@ -2445,18 +2460,6 @@ class LobbyModal {
         window.addEventListener("group:created", this.handleSocketGroupUpdate);
         this.socketListenerRegistered = true;
     }
-    /**
-     * Unsubscribe from socket events
-     */
-    unsubscribeFromSocketEvents() {
-        if (typeof window === "undefined" || !this.socketListenerRegistered) {
-            return;
-        }
-        window.removeEventListener("group:fulfilled", this.handleSocketGroupUpdate);
-        window.removeEventListener("group:member:joined", this.handleSocketGroupUpdate);
-        window.removeEventListener("group:created", this.handleSocketGroupUpdate);
-        this.socketListenerRegistered = false;
-    }
     /**
      * Create activity item from socket event data
      */
@@ -2582,6 +2585,7 @@ class WidgetRoot {
         this.groupListModal = null;
         this.lastGroupDataRefreshTime = 0;
         this.GROUP_REFRESH_DEBOUNCE = 1000; // 1 second min between refreshes
+        this.groupExpiryRefreshTriggered = false; // Track if expiry refresh already triggered for current group
         /** Handle backend fulfillment notifications */
         this.handleGroupFulfilledEvent = (event) => {
             const detail = event.detail;
@@ -2595,9 +2599,10 @@ class WidgetRoot {
         };
         /** Handle realtime group creation/join events by refreshing group UI */
         this.handleGroupUpdatedEvent = (event) => {
+            var _a;
             const detail = event.detail || {};
-            const productId = detail.productId;
-            const groupId = detail.groupId;
+            const productId = detail.product_id;
+            const groupId = (_a = detail.group) === null || _a === void 0 ? void 0 : _a.id;
             if (productId && this.currentProductId && productId !== this.currentProductId) {
                 return;
             }
@@ -2863,14 +2868,10 @@ class WidgetRoot {
         footer.style.display = "flex";
         footer.style.justifyContent = "flex-end";
         footer.style.alignItems = "center";
-        const viewAllLink = this.createInlineViewAllLink();
-        if (viewAllLink) {
-            footer.appendChild(viewAllLink);
-        }
         root.appendChild(footer);
         return root;
     }
-    /** Update countdown text */
+    /** Update countdown text and trigger refresh when group expires */
     updateTimer(el, expiryMs, remaining) {
         const now = Date.now();
         const diff = Math.max(0, Math.floor((expiryMs - now) / 1000));
@@ -2884,6 +2885,12 @@ class WidgetRoot {
         else {
             el.textContent = "✨ Discount activated!";
             el.classList.add("activated");
+            // Trigger group refresh only once when expiry is reached, regardless of modal state
+            if (!this.groupExpiryRefreshTriggered && diff <= 0) {
+                this.groupExpiryRefreshTriggered = true;
+                this.logger.info("[Expiry] Group expired, refreshing group data");
+                void this.refreshGroupDataFromRealtime();
+            }
         }
     }
     /** Build and attach the shared "View all Groups" link section */
@@ -2995,6 +3002,7 @@ class WidgetRoot {
             this.frozenReward = null;
             this.currentGroupId = null;
             this.currentRewardData = null;
+            this.groupExpiryRefreshTriggered = false; // Reset expiry refresh flag for new render
             // Listen for realtime fulfillment updates once per page
             this.subscribeToSocketEvents();
             // Host safety + idempotency markers
@@ -3409,7 +3417,6 @@ class WidgetRoot {
         }
     }
     createWidget(rewardData, container, options) {
-        var _a, _b;
         const isFulfilled = this.groupFulfilled;
         const activeReward = this.frozenReward || (rewardData === null || rewardData === void 0 ? void 0 : rewardData.reward) || null;
         const wrapper = document.createElement("div");
@@ -3459,7 +3466,7 @@ class WidgetRoot {
             rewardLine.setAttribute("aria-label", rewardText ? `Reward locked in: ${rewardText}` : "Reward available for this group");
             rewardLine.title = rewardLine.textContent;
         }
-        else if (((_a = rewardData === null || rewardData === void 0 ? void 0 : rewardData.eligibility) === null || _a === void 0 ? void 0 : _a.isEligible) && activeReward) {
+        else if (activeReward) {
             const rewardText = this.formatRewardText(activeReward);
             rewardLine.textContent = rewardText
                 ? `Save up to ${rewardText} with CoBuy`
@@ -3467,12 +3474,6 @@ class WidgetRoot {
             rewardLine.setAttribute("aria-label", `Eligible for CoBuy reward: ${rewardLine.textContent}`);
             rewardLine.title = rewardLine.textContent;
         }
-        else if (rewardData && !((_b = rewardData.eligibility) === null || _b === void 0 ? void 0 : _b.isEligible)) {
-            rewardLine.textContent = "Join with CoBuy to unlock rewards";
-            rewardLine.setAttribute("aria-label", "Join with CoBuy to unlock rewards");
-            rewardLine.title = "Join with CoBuy to unlock rewards";
-            rewardLine.style.color = "#6b7280";
-        }
         else {
             rewardLine.textContent = "CoBuy offer loading or unavailable";
             rewardLine.setAttribute("aria-label", "CoBuy offer loading or unavailable");
@@ -3876,7 +3877,6 @@ class WidgetRoot {
      * Format reward text for rendering in external container
      */
     formatRewardForContainer(rewardData) {
-        var _a;
         const reward = this.frozenReward || (rewardData === null || rewardData === void 0 ? void 0 : rewardData.reward);
         if (this.groupFulfilled) {
             const rewardText = this.formatRewardText(reward);
@@ -3886,12 +3886,7 @@ class WidgetRoot {
             return "Join with CoBuy to unlock rewards";
         }
         const rewardText = this.formatRewardText(reward);
-        if ((_a = rewardData === null || rewardData === void 0 ? void 0 : rewardData.eligibility) === null || _a === void 0 ? void 0 : _a.isEligible) {
-            return rewardText ? `Save up to ${rewardText} with CoBuy` : "CoBuy reward available";
-        }
-        else {
-            return "Join with CoBuy to unlock rewards";
-        }
+        return rewardText ? `Save up to ${rewardText} with CoBuy` : "CoBuy reward available";
     }
 }
 
@@ -3907,6 +3902,9 @@ const API_ENDPOINTS = {
     GROUP_CREATE_AND_JOIN: "/v1/sdk/groups/new/join",
     PRODUCT_ACTIVE_GROUPS: "/v1/sdk/products/:productId/groups/active",
     GROUP_INVITE: "/v1/sdk/groups/:groupId/invite",
+    GROUP_CHECKOUT_PREPARE: "/v1/sdk/groups/:groupId/checkout/prepare",
+    GROUP_CHECKOUT_VALIDATE: "/v1/sdk/groups/:groupId/checkout/validate",
+    GROUP_CHECKOUT_CONFIRM: "/v1/sdk/groups/:groupId/checkout/confirm",
 };
 /**
  * Build full API URL from base URL and endpoint path
@@ -4361,6 +4359,100 @@ 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.
+     *
+     * @param groupId - The group ID to prepare checkout for
+     * @returns Promise with success status and checkout reference
+     */
+    async prepareCheckout(groupId) {
+        var _a, _b;
+        const endpoint = buildApiUrl("", API_ENDPOINTS.GROUP_CHECKOUT_PREPARE, { groupId });
+        this.logger.info(`Preparing checkout for group: ${groupId}`);
+        const response = await this.post(endpoint);
+        if (response.success && ((_b = (_a = response.data) === null || _a === void 0 ? void 0 : _a.data) === null || _b === void 0 ? void 0 : _b.checkout_ref)) {
+            this.logger.info(`Checkout prepared successfully with ref: ${response.data.data.checkout_ref}`);
+            return {
+                success: true,
+                data: {
+                    checkout_ref: response.data.data.checkout_ref,
+                },
+            };
+        }
+        return {
+            success: false,
+            error: response.error || {
+                message: "Failed to prepare checkout",
+                code: "PREPARE_CHECKOUT_ERROR",
+            },
+        };
+    }
+    /**
+     * 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.
+     *
+     * @param groupId - The group ID to validate checkout for
+     * @param checkoutRef - The checkout reference ID from the prepare step
+     * @returns Promise with success status
+     */
+    async validateCheckout(groupId, checkoutRef) {
+        var _a;
+        const endpoint = buildApiUrl("", API_ENDPOINTS.GROUP_CHECKOUT_VALIDATE, { groupId });
+        this.logger.info(`Validating checkout for group: ${groupId}`);
+        const response = await this.post(endpoint, {
+            checkout_ref: checkoutRef,
+        });
+        if (response.success) {
+            this.logger.info("Checkout validated successfully");
+            return {
+                success: true,
+                data: (_a = response.data) === null || _a === void 0 ? void 0 : _a.data,
+            };
+        }
+        return {
+            success: false,
+            error: response.error || {
+                message: "Failed to validate checkout",
+                code: "VALIDATE_CHECKOUT_ERROR",
+            },
+        };
+    }
+    /**
+     * Confirm checkout for a group
+     *
+     * Finalizes the checkout and confirms the order.
+     * This should be called after validateCheckout to complete the checkout process.
+     *
+     * @param groupId - The group ID to confirm checkout for
+     * @param checkoutRef - The checkout reference ID from the prepare step
+     * @returns Promise with success status
+     */
+    async confirmCheckout(groupId, checkoutRef) {
+        const endpoint = buildApiUrl("", API_ENDPOINTS.GROUP_CHECKOUT_CONFIRM, { groupId });
+        this.logger.info(`Confirming checkout for group: ${groupId}`);
+        const response = await this.post(endpoint, {
+            checkout_ref: checkoutRef,
+        });
+        if (response.success) {
+            this.logger.info("Checkout confirmed successfully");
+            return {
+                success: true,
+            };
+        }
+        return {
+            success: false,
+            error: response.error || {
+                message: "Failed to confirm checkout",
+                code: "CONFIRM_CHECKOUT_ERROR",
+            },
+        };
+    }
 }
 
 /**
@@ -8755,6 +8847,7 @@ class CoBuy {
         this.analyticsClient = null;
         this.sessionId = "";
         this.SESSION_STORAGE_KEY = "cobuy_sdk_session_id";
+        this.CHECKOUT_REF_PREFIX = "cobuy_checkout_ref";
         this.lobbyModal = null;
         this.modals = new Map();
         this.socketManager = null;
@@ -8798,12 +8891,97 @@ class CoBuy {
         // Fallback for environments without crypto.randomUUID
         return `${Date.now()}-${Math.random().toString(36).substr(2, 9)}`;
     }
+    /**
+     * Store checkout reference for a product/group (session-level)
+     * Storage key format: cobuy_checkout_ref_<sessionId>_<productId>_<groupId>
+     */
+    storeCheckoutRef(productId, groupId, checkoutRef) {
+        if (typeof window === "undefined" || !window.localStorage) {
+            this.logger.warn("[SDK] localStorage not available, cannot store checkout reference");
+            return;
+        }
+        const storageKey = `${this.CHECKOUT_REF_PREFIX}_${this.sessionId}_${productId}_${groupId}`;
+        try {
+            window.localStorage.setItem(storageKey, checkoutRef);
+            this.logger.debug(`[SDK] Stored checkout reference: ${storageKey}`);
+        }
+        catch (e) {
+            this.logger.warn("[SDK] Could not store checkout reference to localStorage", e);
+        }
+    }
+    /**
+     * Retrieve checkout reference for a product/group (session-level)
+     * If groupId provided, try exact match first; otherwise fall back to any key for that product
+     * Returns both the matched storage key and the checkout reference value (or null if not found)
+     */
+    getCheckoutRef(productId, groupId) {
+        if (typeof window === "undefined" || !window.localStorage) {
+            return { key: null, checkoutRef: null, groupId: null };
+        }
+        const basePrefix = `${this.CHECKOUT_REF_PREFIX}_${this.sessionId}_${productId}`;
+        // Try exact match if groupId supplied
+        if (groupId) {
+            const exactKey = `${basePrefix}_${groupId}`;
+            const exactRef = window.localStorage.getItem(exactKey);
+            if (exactRef) {
+                this.logger.debug(`[SDK] Retrieved checkout reference: ${exactKey}`);
+                return { key: exactKey, checkoutRef: exactRef, groupId };
+            }
+        }
+        // Fallback: find any checkout ref for this product (ignore group)
+        for (let i = 0; i < window.localStorage.length; i++) {
+            const key = window.localStorage.key(i);
+            if (key && key.startsWith(basePrefix)) {
+                const ref = window.localStorage.getItem(key);
+                if (ref) {
+                    this.logger.debug(`[SDK] Retrieved checkout reference via prefix: ${key}`);
+                    const parsedGroupId = key.startsWith(`${basePrefix}_`) ? key.substring(basePrefix.length + 1) : null;
+                    return { key, checkoutRef: ref, groupId: parsedGroupId };
+                }
+            }
+        }
+        return { key: null, checkoutRef: null, groupId: null };
+    }
     /**
      * Get the current session ID (core SDK concept)
      */
     getSessionId() {
         return this.sessionId;
     }
+    /**
+     * Prepare checkout for a group if not already prepared
+     * Checks localStorage to prevent duplicate calls for the same product/group/session
+     */
+    async prepareCheckoutIfNotDone(productId, groupId) {
+        var _a;
+        // Check if checkout already prepared for this product/group (session)
+        const { checkoutRef: existingRef } = this.getCheckoutRef(productId, groupId);
+        if (existingRef) {
+            this.logger.debug(`[SDK] Checkout already prepared for product ${productId} (session), skipping`);
+            return;
+        }
+        if (!this.apiClient) {
+            this.logger.warn("[SDK] API client not available, cannot prepare checkout");
+            return;
+        }
+        try {
+            this.logger.info(`[SDK] Preparing checkout for product: ${productId}, group: ${groupId}`);
+            // Call prepareCheckout to get the checkout reference
+            const response = await this.apiClient.prepareCheckout(groupId);
+            if (response.success && ((_a = response.data) === null || _a === void 0 ? void 0 : _a.checkout_ref)) {
+                const checkoutRef = response.data.checkout_ref;
+                // Store the checkout reference for this specific product and group
+                this.storeCheckoutRef(productId, groupId, checkoutRef);
+                this.logger.info(`[SDK] Checkout prepared and stored for ${productId}:${groupId} - Ref: ${checkoutRef}`);
+            }
+            else {
+                this.logger.error("[SDK] Failed to prepare checkout", response.error);
+            }
+        }
+        catch (error) {
+            this.logger.error("[SDK] Error preparing checkout", error);
+        }
+    }
     /**
      * Initialize the SDK with configuration
      */
@@ -8864,6 +9042,21 @@ class CoBuy {
                         },
                         onGroupMemberJoined: (payload) => {
                             var _a;
+                            const group = payload.group;
+                            const productId = payload.product_id;
+                            const groupId = group === null || group === void 0 ? void 0 : group.id;
+                            const maxParticipants = group === null || group === void 0 ? void 0 : group.max_participants;
+                            const participantsCount = group === null || group === void 0 ? void 0 : group.participants_count;
+                            const status = group === null || group === void 0 ? void 0 : group.status;
+                            const isFulfilled = status === "fulfilled" ||
+                                (maxParticipants !== undefined &&
+                                    participantsCount !== undefined &&
+                                    participantsCount >= maxParticipants);
+                            if (isFulfilled && productId && groupId) {
+                                // Prepare checkout when group is fulfilled (if not already prepared)
+                                this.prepareCheckoutIfNotDone(productId, groupId);
+                            }
+                            // Emit user-defined callback if provided
                             if ((_a = config.events) === null || _a === void 0 ? void 0 : _a.onGroupMemberJoined) {
                                 config.events.onGroupMemberJoined(payload);
                             }
@@ -8972,6 +9165,17 @@ class CoBuy {
             this.lobbyModal = modal;
             // Open the modal
             modal.open(options.groupId);
+            // Prepare checkout if group is fulfilled
+            if (options.groupId) {
+                const isFulfilled = options.status === "complete" ||
+                    options.progress === 100 ||
+                    (options.currentMembers !== undefined &&
+                        options.totalMembers !== undefined &&
+                        options.currentMembers >= options.totalMembers);
+                if (isFulfilled) {
+                    this.prepareCheckoutIfNotDone(options.productId, options.groupId);
+                }
+            }
             // Call callback if provided
             if (options.onOpen) {
                 options.onOpen(options.productId);
@@ -9053,6 +9257,83 @@ class CoBuy {
             this.logger.error("Error setting contact information", error);
         }
     }
+    /**
+     * Validate checkout for a group
+     *
+     * Validates the checkout reference and confirms the order can proceed.
+     * Should be called after prepareCheckout to verify the checkout state.
+     *
+     * @param groupId - The group ID to validate checkout for
+     * @param checkoutRef - The checkout reference ID from the prepare step
+     *
+     * @example
+     * ```typescript
+     * // Validate checkout for a group
+     * await CoBuy.validateCheckout('fae238ae-7468-47e9-9eec-b6d52fe3b012', 'chk_9a6d8750-ed60-4795-a207-2abe955e8509');
+     * ```
+     */
+    async validateCheckout(groupId, checkoutRef) {
+        if (!this.configManager.isInitialized()) {
+            this.logger.warn("SDK not initialized, cannot validate checkout");
+            return null;
+        }
+        if (!this.apiClient) {
+            this.logger.error("API client not available");
+            return null;
+        }
+        try {
+            const response = await this.apiClient.validateCheckout(groupId, checkoutRef);
+            if (response.success) {
+                this.logger.info(`Checkout validated successfully for group: ${groupId}`);
+                return response.data || null;
+            }
+            else {
+                this.logger.error("Failed to validate checkout", response.error);
+                return null;
+            }
+        }
+        catch (error) {
+            this.logger.error("Error validating checkout", error);
+            return null;
+        }
+    }
+    /**
+     * Confirm checkout for a group
+     *
+     * Finalizes the checkout and confirms the order.
+     * Should be called after validateCheckout to complete the checkout process.
+     *
+     * @param groupId - The group ID to confirm checkout for
+     * @param checkoutRef - The checkout reference ID from the prepare step
+     *
+     * @example
+     * ```typescript
+     * // Confirm checkout for a group
+     * await CoBuy.confirmCheckout('fae238ae-7468-47e9-9eec-b6d52fe3b012', 'chk_9a6d8750-ed60-4795-a207-2abe955e8509');
+     * ```
+     */
+    async confirmCheckout(groupId, checkoutRef) {
+        if (!this.configManager.isInitialized()) {
+            this.logger.warn("SDK not initialized, cannot confirm checkout");
+            return;
+        }
+        if (!this.apiClient) {
+            this.logger.error("API client not available");
+            return;
+        }
+        try {
+            const response = await this.apiClient.confirmCheckout(groupId, checkoutRef);
+            if (response.success) {
+                this.logger.info(`Checkout confirmed successfully for group: ${groupId}`);
+            }
+            else {
+                this.logger.error("Failed to confirm checkout", response.error);
+            }
+        }
+        catch (error) {
+            this.logger.error("Error confirming checkout", error);
+        }
+    }
     /**
      * Get the initialized API client instance
      */