@cshah18/sdk 4.12.0 → 4.13.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, CheckoutConfirmData } from "./types";
+import { ApiRequestOptions, ApiResponse, ApiClientConfig, ProductRewardData, ProductPrimaryGroupData, GroupJoinResponseData, GroupInviteResponseData, InviteResolveResponseData, AuthStrategy, ShareChannel, Contact, CheckoutValidationData, CheckoutConfirmData } from "./types";
 /**
  * HTTP client for communicating with CoBuy API
  *
@@ -367,6 +367,36 @@ export declare class ApiClient {
      * ```
      */
     inviteToGroup(groupId: string, sharedVia: ShareChannel): Promise<ApiResponse<GroupInviteResponseData>>;
+    /**
+     * Resolve an invite token to get product and group information
+     *
+     * Resolves an invite link token (e.g., from https://brand.cobuyza.co.za/i/QMeHD7ew)
+     * to get the associated product, group, and invite metadata.
+     *
+     * @param {string} inviteToken - The invite token from the URL
+     * @returns {Promise<ApiResponse<InviteResolveResponseData>>} Product and group information
+     *
+     * @description
+     * Features:
+     * - Resolves invite tokens to product/group details
+     * - Tracks invite click counts
+     * - Returns invite metadata (shared_via, click_count)
+     * - Used for invite link handling in applications
+     *
+     * @example
+     * ```typescript
+     * // Resolve invite token from URL
+     * const response = await client.resolveInvite('QMeHD7ew');
+     *
+     * if (response.success) {
+     *   const productId = response.data.product.id;
+     *   const groupId = response.data.group.id;
+     *   // Navigate to product page
+     *   window.location.href = `/product/${productId}`;
+     * }
+     * ```
+     */
+    resolveInvite(inviteToken: string): Promise<ApiResponse<InviteResolveResponseData>>;
     /**
      * Set or update contact information for the current session
      *

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

@@ -1,4 +1,4 @@
-import { CoBuySDK, CoBuyInitOptions, RenderWidgetOptions, ModalOptions, Contact, CheckoutValidationData, CheckoutConfirmData } from "./types";
+import { CoBuySDK, CoBuyInitOptions, RenderWidgetOptions, ModalOptions, Contact, CheckoutValidationData, CheckoutConfirmData, InviteResolveResponseData } from "./types";
 import { ApiClient } from "./api-client";
 import { AnalyticsClient } from "./analytics";
 import { SocketManager } from "./socket";
@@ -246,6 +246,32 @@ export declare class CoBuy implements CoBuySDK {
      * ```
      */
     setContact(contact: Contact): Promise<void>;
+    /**
+     * Resolve an invite token to get product and group information
+     *
+     * Resolves an invite link token (e.g., from https://brand.cobuyza.co.za/i/QMeHD7ew)
+     * to get the associated product, group, and invite metadata. Use this to handle
+     * invite links in your application routing.
+     *
+     * @param inviteToken - The invite token from the URL
+     * @returns Promise with invite resolution data or null if failed
+     *
+     * @example
+     * ```typescript
+     * // Extract token from URL path like /i/QMeHD7ew
+     * const pathParts = window.location.pathname.split('/i/');
+     * if (pathParts.length > 1) {
+     *   const inviteToken = pathParts[1];
+     *   const inviteData = await CoBuy.resolveInvite(inviteToken);
+     *
+     *   if (inviteData) {
+     *     // Navigate to product page
+     *     window.location.href = `/product/${inviteData.product.id}`;
+     *   }
+     * }
+     * ```
+     */
+    resolveInvite(inviteToken: string): Promise<InviteResolveResponseData | null>;
     /**
      * Validate checkout for a group
      *

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

@@ -11,6 +11,7 @@ export declare const API_ENDPOINTS: {
     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";
+    readonly INVITE_RESOLVE: "/v1/sdk/invite/resolve";
 };
 /**
  * Build full API URL from base URL and endpoint path

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

@@ -582,6 +582,41 @@ export interface GroupInviteResponseData {
     };
     [key: string]: unknown;
 }
+/**
+ * Invite resolution response data
+ */
+export interface InviteResolveResponseData {
+    product: {
+        id: string;
+        name: string;
+        images: string[];
+        price: number;
+        description: string;
+    };
+    creative: {
+        id: string;
+        name: string;
+        contact_required: boolean;
+    };
+    brand: {
+        id: string;
+        name: string;
+    };
+    group: {
+        id: string;
+        group_name: string;
+        description: string;
+        current_count: number;
+        required_count: number;
+        status: string;
+        auto_created: boolean;
+        expiry_at: string;
+    };
+    invite_metadata: {
+        shared_via: string;
+        click_count: number;
+    };
+}
 /**
  * Options for rendering the CoBuy widget
  */
@@ -672,6 +707,13 @@ export interface CoBuySDK {
      * @param _contact Contact information (email or phone)
      */
     setContact(_contact: Contact): Promise<void>;
+    /**
+     * Resolve an invite token to get product and group information
+     * Used to handle invite links like https://brand.cobuyza.co.za/i/{token}
+     * @param _inviteToken The invite token from the URL
+     * @returns Promise with invite resolution data including product, group, and metadata
+     */
+    resolveInvite(_inviteToken: string): Promise<InviteResolveResponseData | null>;
     /**
      * Validate checkout for a group
      * Validates the checkout reference and confirms the order can proceed

package/package.json

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