@cshah18/sdk 3.0.0 → 3.0.1

package/dist/cobuy-sdk.umd.js

@@ -1308,6 +1308,21 @@ var CoBuySDK = (function (exports) {
             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
              */
@@ -2329,11 +2344,11 @@ var CoBuySDK = (function (exports) {
             // 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;
@@ -2448,18 +2463,6 @@ var CoBuySDK = (function (exports) {
             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
          */
@@ -2585,9 +2588,9 @@ var CoBuySDK = (function (exports) {
             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) => {
-                console.log("CHIRAG");
                 const detail = event.detail;
                 if (!detail || !detail.productId) {
                     return;
@@ -2599,9 +2602,10 @@ var CoBuySDK = (function (exports) {
             };
             /** 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;
                 }
@@ -2867,14 +2871,10 @@ var CoBuySDK = (function (exports) {
             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));
@@ -2888,6 +2888,12 @@ var CoBuySDK = (function (exports) {
             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 */
@@ -2999,6 +3005,7 @@ var CoBuySDK = (function (exports) {
                 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
@@ -3413,7 +3420,6 @@ var CoBuySDK = (function (exports) {
             }
         }
         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");
@@ -3463,7 +3469,7 @@ var CoBuySDK = (function (exports) {
                 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`
@@ -3471,12 +3477,6 @@ var CoBuySDK = (function (exports) {
                 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");
@@ -3880,7 +3880,6 @@ var CoBuySDK = (function (exports) {
          * 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);
@@ -3890,12 +3889,7 @@ var CoBuySDK = (function (exports) {
                 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";
         }
     }
 
@@ -3911,6 +3905,9 @@ var CoBuySDK = (function (exports) {
         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
@@ -4365,6 +4362,100 @@ var CoBuySDK = (function (exports) {
                 },
             };
         }
+        /**
+         * 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",
+                },
+            };
+        }
     }
 
     /**
@@ -8759,6 +8850,7 @@ var CoBuySDK = (function (exports) {
             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;
@@ -8802,12 +8894,97 @@ var CoBuySDK = (function (exports) {
             // 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
          */
@@ -8868,6 +9045,21 @@ var CoBuySDK = (function (exports) {
                             },
                             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);
                                 }
@@ -8976,6 +9168,17 @@ var CoBuySDK = (function (exports) {
                 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);
@@ -9057,6 +9260,83 @@ var CoBuySDK = (function (exports) {
                 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
          */