@cshah18/sdk 4.1.0 → 4.3.0

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

@@ -1,4 +1,4 @@
-import { ApiRequestOptions, ApiResponse, ApiClientConfig, ProductRewardData, ProductPrimaryGroupData, GroupJoinResponseData, GroupInviteResponseData, AuthStrategy, ShareChannel, Contact, CheckoutValidationData } from "./types";
+import { ApiRequestOptions, ApiResponse, ApiClientConfig, ProductRewardData, ProductPrimaryGroupData, GroupJoinResponseData, GroupInviteResponseData, AuthStrategy, ShareChannel, Contact, CheckoutValidationData, CheckoutConfirmData } from "./types";
 /**
  * HTTP client for communicating with CoBuy API
  *
@@ -158,5 +158,5 @@ export declare class ApiClient {
      * @param checkoutRef - The checkout reference ID from the prepare step
      * @returns Promise with success status
      */
-    confirmCheckout(groupId: string, checkoutRef: string): Promise<ApiResponse<void>>;
+    confirmCheckout(groupId: string, checkoutRef: string, data?: CheckoutConfirmData): Promise<ApiResponse<void>>;
 }

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

@@ -1,4 +1,4 @@
-import { CoBuySDK, CoBuyInitOptions, RenderWidgetOptions, ModalOptions, Contact, CheckoutValidationData } from "./types";
+import { CoBuySDK, CoBuyInitOptions, RenderWidgetOptions, ModalOptions, Contact, CheckoutValidationData, CheckoutConfirmData } from "./types";
 import { ApiClient } from "./api-client";
 import { AnalyticsClient } from "./analytics";
 import { SocketManager } from "./socket";
@@ -119,14 +119,31 @@ export declare class CoBuy implements CoBuySDK {
      *
      * @param groupId - The group ID to confirm checkout for
      * @param checkoutRef - The checkout reference ID from the prepare step
+    /**
+     * Confirm checkout for a group
+     * Should be called after validateCheckout to complete the checkout process.
+     *
+     * @param groupId The group ID to confirm checkout for
+     * @param checkoutRef The checkout reference from the prepare step
+     * @param data Optional order details (order_id, order_total, discount_applied, currency, payment_method, metadata)
      *
      * @example
      * ```typescript
      * // Confirm checkout for a group
      * await CoBuy.confirmCheckout('fae238ae-7468-47e9-9eec-b6d52fe3b012', 'chk_9a6d8750-ed60-4795-a207-2abe955e8509');
+     *
+     * // Confirm checkout with order details
+     * await CoBuy.confirmCheckout('fae238ae-7468-47e9-9eec-b6d52fe3b012', 'chk_9a6d8750-ed60-4795-a207-2abe955e8509', {
+     *   order_id: 'ORDER-1001',
+     *   order_total: 100.00,
+     *   discount_applied: 20.00,
+     *   currency: 'USD',
+     *   payment_method: 'card',
+     *   metadata: { coupon_code: 'WELCOME20', customer_id: 'cust_123' }
+     * });
      * ```
      */
-    confirmCheckout(groupId: string, checkoutRef: string): Promise<void>;
+    confirmCheckout(groupId: string, checkoutRef: string, data?: CheckoutConfirmData): Promise<void>;
     /**
      * Get the initialized API client instance
      */

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

@@ -161,6 +161,26 @@ export interface CheckoutValidationData {
     reward?: CheckoutValidationReward;
     message?: string;
 }
+/**
+ * Optional metadata for checkout confirmation
+ */
+export interface CheckoutConfirmMetadata {
+    coupon_code?: string;
+    customer_id?: string;
+    note?: string;
+    [key: string]: string | number | boolean | undefined;
+}
+/**
+ * Optional order details for checkout confirmation
+ */
+export interface CheckoutConfirmData {
+    order_id?: string;
+    order_total?: number;
+    discount_applied?: number;
+    currency?: string;
+    payment_method?: "cod" | "card" | string;
+    metadata?: CheckoutConfirmMetadata;
+}
 /**
  * Offline redemption information for fulfilled groups
  */
@@ -581,8 +601,9 @@ export interface CoBuySDK {
      * Finalizes the checkout and confirms the order
      * @param _groupId The group ID to confirm checkout for
      * @param _checkoutRef The checkout reference ID from the prepare step
+     * @param _data (optional) Additional order details (order_id, order_total, discount_applied, currency, payment_method, metadata)
      */
-    confirmCheckout(_groupId: string, _checkoutRef: string): Promise<void>;
+    confirmCheckout(_groupId: string, _checkoutRef: string, _data?: CheckoutConfirmData): Promise<void>;
     /**
      * Retrieve stored checkout reference for a product in this session
      * Returns both the storage key and value; key/value null if not found or storage unavailable

package/package.json

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