@cshah18/sdk 4.14.0 → 4.16.0

package/dist/types/core/api-client.d.ts

@@ -1,4 +1,4 @@
-import { ApiRequestOptions, ApiResponse, ApiClientConfig, ProductRewardData, ProductContextData, ProductPrimaryGroupData, GroupJoinResponseData, GroupInviteResponseData, InviteResolveResponseData, AuthStrategy, ShareChannel, Contact, CheckoutValidationData, CheckoutConfirmData } from "./types";
+import { ApiRequestOptions, ApiResponse, ApiClientConfig, ProductRewardData, ProductContextData, ProductPrimaryGroupData, GroupJoinResponseData, GroupInviteResponseData, InviteResolveResponseData, AuthStrategy, ShareChannel, Contact, OfflineRedemption, LeaveGroupResponseData, RecoverOrJoinGroupResponseData, CheckoutValidationData, CheckoutConfirmData } from "./types";
 /**
  * HTTP client for communicating with CoBuy API
  *
@@ -446,6 +446,28 @@ export declare class ApiClient {
      * ```
      */
     setContact(contact: Contact): Promise<ApiResponse<void>>;
+    /**
+     * Leave an active group for the current SDK session.
+     */
+    leaveGroup(groupId: string, params?: {
+        leave_source?: "close_icon" | "browser_close" | "unknown";
+        leave_reason?: "voluntary_with_contact" | "voluntary_no_contact" | "unknown";
+    }): Promise<ApiResponse<LeaveGroupResponseData>>;
+    /**
+     * Fetch current session member's offline redemption codes for a group.
+     */
+    getGroupOfflineRedemption(groupId: string): Promise<ApiResponse<{
+        offline_redemption?: OfflineRedemption;
+    }>>;
+    recoverOrJoinGroup(productId: string, contact?: Contact): Promise<ApiResponse<RecoverOrJoinGroupResponseData>>;
+    /**
+     * Best-effort leave signal for unload/pagehide scenarios.
+     * Uses fetch keepalive so it can run while page is closing.
+     */
+    leaveGroupBestEffort(groupId: string, params?: {
+        leave_source?: "close_icon" | "browser_close" | "unknown";
+        leave_reason?: "voluntary_with_contact" | "voluntary_no_contact" | "unknown";
+    }): void;
     /**
      * Prepare checkout for a group
      *

package/dist/types/core/endpoints.d.ts

@@ -5,10 +5,13 @@ export declare const API_ENDPOINTS: {
     readonly PRODUCT_CONTEXT: "/v1/sdk/products/:productId/context";
     readonly PRODUCT_REWARD: "/v1/sdk/products/:productId/reward";
     readonly PRODUCT_PRIMARY_GROUP: "/v1/sdk/products/:productId/group/primary";
+    readonly PRODUCT_RECOVER_OR_JOIN_GROUP: "/v1/sdk/products/:productId/group/recover-or-join";
     readonly GROUP_JOIN: "/v1/sdk/groups/:groupId/join";
+    readonly GROUP_LEAVE: "/v1/sdk/groups/:groupId/leave";
     readonly GROUP_CREATE_AND_JOIN: "/v1/sdk/groups/new/join";
     readonly PRODUCT_ACTIVE_GROUPS: "/v1/sdk/products/:productId/groups/active";
     readonly GROUP_INVITE: "/v1/sdk/groups/:groupId/invite";
+    readonly GROUP_OFFLINE_REDEMPTION: "/v1/sdk/groups/:groupId/offline-redemption";
     readonly GROUP_CHECKOUT_PREPARE: "/v1/sdk/groups/:groupId/checkout/prepare";
     readonly GROUP_CHECKOUT_VALIDATE: "/v1/sdk/groups/:groupId/checkout/validate";
     readonly GROUP_CHECKOUT_CONFIRM: "/v1/sdk/groups/:groupId/checkout/confirm";

package/dist/types/core/socket.d.ts

@@ -1,7 +1,8 @@
-import { InternalConfig, GroupFulfilledEvent, GroupCreatedEvent, GroupMemberJoinedEvent } from "./types";
-export type SocketEventName = "group:member:joined" | "group:created" | "group:fulfilled";
+import { InternalConfig, GroupFulfilledEvent, GroupCreatedEvent, GroupMemberJoinedEvent, GroupMemberLeftEvent } from "./types";
+export type SocketEventName = "group:member:joined" | "group:member:left" | "group:created" | "group:fulfilled";
 export interface SocketHandlers {
     onGroupMemberJoined?: (payload: GroupMemberJoinedEvent) => void;
+    onGroupMemberLeft?: (payload: GroupMemberLeftEvent) => void;
     onGroupCreated?: (payload: GroupCreatedEvent) => void;
     onGroupFulfilled?: (payload: GroupFulfilledEvent) => void;
 }

package/dist/types/core/types.d.ts

@@ -305,6 +305,7 @@ export interface FulfilledGroup {
     campaign_id: string;
     campaign_name: string;
     campaign_status: string;
+    campaign_redemption_method?: "online" | "offline" | "both";
     participants_count: number;
     max_participants: number;
     status: string;
@@ -486,6 +487,10 @@ export interface ModalOptions {
      * Offline redemption data for fulfilled groups
      */
     offlineRedemption?: OfflineRedemption;
+    /**
+     * Campaign redemption method - controls which checkout options are shown
+     */
+    redemptionMethod?: "online" | "offline" | "both";
     /**
      * Optional callback when modal opens
      */
@@ -582,6 +587,7 @@ export interface ProductContextCampaignData {
     reward_value?: string | number | null;
     start_date?: string | null;
     end_date?: string | null;
+    redemption_method?: "online" | "offline" | "both" | null;
 }
 export interface ProductContextData {
     product_id: string;
@@ -613,6 +619,7 @@ export interface ProductPrimaryGroupData {
     campaign_id: string | null;
     campaign_name: string | null;
     campaign_status: string | null;
+    campaign_redemption_method?: "online" | "offline" | "both";
     participants_count: number;
     max_participants: number;
     status: string;
@@ -632,6 +639,7 @@ export interface GroupJoinResponseData {
         status: string;
         expiry_at: string;
         timeLeftSeconds: number;
+        campaign_redemption_method?: "online" | "offline" | "both";
     };
     membership: {
         id: string;
@@ -642,6 +650,37 @@ export interface GroupJoinResponseData {
     product_id: string;
     offline_redemption?: OfflineRedemption;
 }
+export interface LeaveGroupResponseData {
+    left: boolean;
+    session_id: string;
+    group: {
+        id: string;
+        group_name: string;
+        description: string | null;
+        campaign_creative_id: string | null;
+        campaign_creative_name: string | null;
+        campaign_id: string | null;
+        campaign_name: string | null;
+        campaign_status: string | null;
+        campaign_redemption_method?: "online" | "offline" | "both";
+        participants_count: number;
+        max_participants: number;
+        status: string;
+        expiry_at: string;
+        timeLeftSeconds: number;
+    };
+    product_id?: string;
+}
+export interface RecoverOrJoinGroupResponseData extends GroupJoinResponseData {
+    recovery: {
+        recovered: boolean;
+        matched_by: "session" | "contact" | "none";
+        outcome: "existing_active_membership" | "rejoined_previous_group" | "joined_next_available_group" | "created_new_group";
+        previous_group_id?: string;
+        joined_group_id: string;
+    };
+}
+export type GroupMemberLeftEvent = LeaveGroupResponseData;
 export type ShareChannel = "whatsapp" | "facebook" | "email" | "sms" | "copy_link" | "tiktok" | "x" | "other";
 export interface GroupInviteResponseData {
     invite_url?: string;

package/dist/types/ui/lobby/lobby-modal.d.ts

@@ -1,4 +1,5 @@
 import { ApiClient } from "../../core/api-client";
+import { AnalyticsClient } from "../../core/analytics";
 import { OfflineRedemption } from "../../core/types";
 import { SocketManager } from "../../core/socket";
 import "./styles/styles.css";
@@ -17,6 +18,7 @@ export interface LobbyModalData {
     activities?: ActivityItem[];
     isLocked?: boolean;
     offlineRedemption?: OfflineRedemption;
+    redemptionMethod?: "online" | "offline" | "both";
 }
 export interface ActivityItem {
     emoji: string;
@@ -31,6 +33,9 @@ export interface LobbyModalCallbacks {
     onCopyLink?: (link: string) => void;
     onShare?: () => void;
 }
+interface CloseOptions {
+    skipLeaveFlow?: boolean;
+}
 /**
  * LobbyModal - Renders and manages the group buying lobby modal
  */
@@ -38,6 +43,7 @@ export declare class LobbyModal {
     private readonly logger;
     private readonly socketManager;
     private readonly apiClient;
+    private readonly analyticsClient;
     private modalElement;
     private data;
     private readonly callbacks;
@@ -48,7 +54,36 @@ export declare class LobbyModal {
     private currentGroupId;
     private shareOverlay;
     private keyboardHandler;
-    constructor(data: LobbyModalData, callbacks: LobbyModalCallbacks, apiClient: ApiClient | null, socketManager?: SocketManager | null, debug?: boolean);
+    private leaveFlowInProgress;
+    private leaveSignalSent;
+    private hasContactProtection;
+    private initialContactPromptTimer;
+    private contactPromptOverlay;
+    private leaveLoaderOverlay;
+    private beforeUnloadHandler;
+    private pageHideHandler;
+    private visibilityChangeHandler;
+    private readonly CONTACT_PROTECTION_PREFIX;
+    private readonly LAST_LEFT_GROUP_PREFIX;
+    constructor(data: LobbyModalData, callbacks: LobbyModalCallbacks, apiClient: ApiClient | null, socketManager?: SocketManager | null, analyticsClient?: AnalyticsClient | null, debug?: boolean);
+    private getSessionId;
+    private getContactProtectionStorageKey;
+    private getLastLeftGroupStorageKey;
+    private readContactProtectionState;
+    private persistContactProtectionState;
+    private persistLastLeftGroup;
+    private clearInitialContactPromptTimer;
+    private clearContactPromptOverlay;
+    private showBlockingLoader;
+    private hideBlockingLoader;
+    private updateContactProtectionUI;
+    private showToastMessage;
+    private trackAnalyticsEvent;
+    private saveContactValue;
+    private openContactProtectionPrompt;
+    private openUnprotectedLeaveWarning;
+    private scheduleInitialContactPrompt;
+    private leaveGroupExplicitly;
     /**
      * Derive lock state from data so UI reflects completion
      */
@@ -103,6 +138,10 @@ export declare class LobbyModal {
      * Create link section (just the link box and share button, no wrapper)
      */
     private createLinkSection;
+    /**
+     * Create a standalone "Checkout Online" button for the link/share section
+     */
+    private createOnlineCheckoutButton;
     /**
      * Create offline redemption section
      */
@@ -251,10 +290,16 @@ export declare class LobbyModal {
      * Clean up keyboard event listeners
      */
     private removeKeyboardAccessibility;
+    private registerLifecycleLeaveHandlers;
+    private unregisterLifecycleLeaveHandlers;
+    private triggerBestEffortLeave;
+    private shouldRunLeaveFlow;
+    private inferContactType;
+    private runLeaveFlowAndClose;
     /**
      * Close the modal
      */
-    close(): void;
+    close(options?: CloseOptions): void;
     /**
      * Check if modal is open
      */
@@ -291,10 +336,16 @@ export declare class LobbyModal {
      * Subscribe to socket events
      */
     private subscribeToSocketEvents;
+    private unsubscribeFromSocketEvents;
     /**
      * Handle socket group update events
      */
     private readonly handleSocketGroupUpdate;
+    /**
+     * Fetch current user's offline redemption codes when group becomes fulfilled
+     * This ensures we show the current user's codes, not someone else's
+     */
+    private fetchCurrentUserOfflineCodesIfNeeded;
     /**
      * Create activity item from socket event data
      */
@@ -308,3 +359,4 @@ export declare class LobbyModal {
      */
     private updateTeamCard;
 }
+export {};

package/dist/types/ui/widget/widget-root.d.ts

@@ -30,6 +30,7 @@ export declare class WidgetRoot {
     private groupExpiryRefreshTriggered;
     private offlineRedemption;
     private offlineRedemptionModal;
+    private campaignRedemptionMethod;
     private isRendering;
     private renderPromise;
     private liveRegionAnnouncer;
@@ -38,11 +39,16 @@ export declare class WidgetRoot {
     private renderDebounceTimer;
     private pendingRenderOptions;
     private readonly RENDER_DEBOUNCE_MS;
+    private readonly LAST_LEFT_GROUP_PREFIX;
     /**
      * Get max retries from config (configurable via performance options)
      */
     private get MAX_RETRIES();
     constructor(config: InternalConfig, apiClient: ApiClient | null, analyticsClient?: AnalyticsClient | null);
+    private getRecoveryStorageKey;
+    private getStoredRecoveryGroupId;
+    private clearStoredRecoveryGroupId;
+    private showRecoveryToast;
     /** Subscribe once to backend socket events routed through the host page */
     private subscribeToSocketEvents;
     /** Handle backend fulfillment notifications */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cshah18/sdk",
-  "version": "4.14.0",
+  "version": "4.16.0",
   "description": "CoBuy Embedded SDK for browser JavaScript integration",
   "type": "module",
   "main": "dist/cobuy-sdk.umd.js",