@liquidcommerce/cloud-sdk 1.1.1 → 1.3.0

package/dist/types/core/payment-provider.service.d.ts

@@ -9,6 +9,7 @@ export declare class PaymentProviderService implements IPaymentProvider {
     private paymentElement;
     private readonly events;
     private readonly eventsErrorMsg;
+    private clientSecret;
     /**
      * Mounts the Stripe payment element to the specified container element on the page.
      *
@@ -23,16 +24,27 @@ export declare class PaymentProviderService implements IPaymentProvider {
     /**
      * Generate a payment token for a liquid payment.
      *
-     * This method generates a payment token using the Stripe API. The payment token represents the payment information provided by the user.
-     * The method first checks if the Stripe instance and the Stripe Elements instance have been initialized. If not, it returns an error indicating that the payment form has not been initialized.
+     * This method generates a payment token using the Stripe API. The payment token represents the payment
+     * information provided by the user. The method first checks if the Stripe instance and the Stripe Elements
+     * instance have been initialized. If not, it returns an error indicating that the payment form has not been
+     * initialized.
      *
-     * Next, the method submits the payment form using the `submit()` method of the Stripe Elements instance. If there is an error during the submission, it returns a validation error indicating the error message and code.
+     * Next, the method submits the payment form using the `submit()` method of the Stripe Elements instance.
+     * If there is an error during the submission, it returns a validation error indicating the error message
+     * and code.
      *
-     * After successful submission, the method creates a payment method using the `createPaymentMethod()` method of the Stripe instance, passing the Stripe Elements instance as a parameter. If there is an error during the creation of the payment method, it returns the appropriate error containing the error message, code, and parameter (if applicable).
+     * After successful submission, the method creates a payment method using the `createPaymentMethod()`
+     * method of the Stripe instance, passing the Stripe Elements instance as a parameter. If there is
+     * an error during the creation of the payment method, it returns the appropriate error containing
+     * the error message, code, and parameter (if applicable).
      *
-     * If the payment method is successfully created, the method returns the payment information in the form of an object containing the payment method's ID, type, and card details (if available), as well as the creation timestamp. The card details include the card brand, country, expiration month, expiration year, last 4 digits, and funding source.
+     * If the payment method is successfully created, the method returns the payment information in the form
+     * of an object containing the payment method's ID, type, and card details (if available), as well as the
+     * creation timestamp. The card details include the card brand, country, expiration month, expiration year,
+     * last 4 digits, and funding source.
      *
-     * If none of the above conditions are met, it returns an error indicating that the payment token generation has failed.
+     * If none of the above conditions are met, it returns an error indicating that the payment token generation
+     * has failed.
      *
      * @returns A Promise that resolves to either a LiquidPaymentToken object or a LiquidPaymentError object.
      *
@@ -49,7 +61,7 @@ export declare class PaymentProviderService implements IPaymentProvider {
      * - created (number): The timestamp indicating when the payment method was created.
      *
      * The LiquidPaymentError object has the following properties:
-     * - type (string): The type of the error (either 'client_error', 'validation_error', or 'api_error').
+     * - type (string): The type of the error (either 'client_error', 'validation_error', api_error, or 'confirm_error').
      * - message (string): The error message.
      * - code (string): The error code (if applicable).
      * - param (string): The error parameter (if applicable).
@@ -88,4 +100,25 @@ export declare class PaymentProviderService implements IPaymentProvider {
      * @return {StripePaymentElementOptions} - The mapped Stripe payment element options.
      */
     private mapElementOptions;
+    /**
+     * Unmounts the payment element from the DOM.
+     * Throws an error if the payment element has not been initialized.
+     *
+     * @return {void}
+     */
+    unmount(): void;
+    /**
+     * Collapses the payment element if it has been initialized.
+     * Throws an error if the payment element has not been initialized.
+     *
+     * @return {void}
+     */
+    collapse(): void;
+    /**
+     * Destroys the payment element if it has been initialized.
+     *
+     * @return {void} No return value.
+     * @throws {Error} Will throw an error if the payment element has not been initialized.
+     */
+    destroy(): void;
 }

package/dist/types/enums.d.ts

@@ -250,8 +250,11 @@ export declare enum CART_PARAM_ERROR_ENUM {
 export declare enum CART_EVENT_ENUM {
     OOS = "OutOfStock",
     ITEMS_NOT_ADDED = "ItemsNotAdded",
+    ITEMS_REQUESTED_NOT_ADDED = "ItemsRequestedNotAdded",
     ITEM_NOT_ENGRAVED = "ItemEngravingError",
     ADDRESS_CHANGE = "AddressChange",
+    LOCATION_AVAILABILITY = "LocationAvailability",
+    REMOVED_EXISTING_ITEMS = "RemovedExistingCartItems",
     RETAILER_MIN = "RetailerMinNotMet",
     NO_ITEMS_IN_CART = "NoItemsInCart",
     INVALID_ID = "InvalidId",

package/dist/types/interfaces/liquid-commerce-client.interface.d.ts

@@ -5,7 +5,7 @@ import type { ICart, ICartUpdateParams } from './cart.interface';
 import type { ICatalog, ICatalogParams } from './catalog.service.interface';
 import type { ICheckoutCompleteParams, ICheckoutCompleteResponse, ICheckoutPrepareParams, ICheckoutPrepareResponse } from './checkout.interface';
 import type { ILiquidPaymentConfig, ILiquidPaymentToken, IPaymentElementEventMap } from './payment.interface';
-import type { IPurgeResponse, IUser, IUserAddress, IUserAddressParams, IUserSessionParams } from './user.interface';
+import type { IPurgeResponse, IUser, IUserAddress, IUserAddressParams, IUserPayment, IUserPaymentAddParams, IUserPaymentUpdateParams, IUserSessionParams } from './user.interface';
 /**
  * Interface representing the LiquidCommerce client.
  * Provides access to methods related to addresses, catalogs, carts, and initialization.
@@ -344,6 +344,37 @@ export interface IUserMethod {
      * @see {@link IPurgeResponse} for the structure of the user data returned.
      */
     purge: (identifier: string) => Promise<IApiResponseWithData<IPurgeResponse>>;
+    /**
+     * Adds a new address for a user.
+     *
+     * @param {IUserAddressParams} params - The parameters for adding a new address.
+     * @returns {Promise<IApiResponseWithData<IUserAddress>>} A promise that resolves to the API response with the added address data.
+     *
+     * @example
+     * const liquidCommerce = await LiquidCommerce(apiKey, config);
+     *
+     * try {
+     *   const newAddress = await liquidCommerce.user.addAddress({
+     *     customerId: 'c1fbd454-a540-4f42-86e9-f87a98bf1812',
+     *     one: '100 Madison St',
+     *     city: 'New York',
+     *     state: 'NY',
+     *     zip: '10004',
+     *     type: 'shipping',
+     *     isDefault: true
+     *   });
+     *
+     *   console.log('Added address:', newAddress?.data);
+     * } catch (error) {
+     *   console.error('Failed to add address:', error);
+     * }
+     *
+     * @throws {Error} - Throws an error if the add address request fails or if authentication is unsuccessful.
+     *
+     * @see {@link IUserAddressParams} for the structure of the add address request parameters.
+     * @see {@link IUserAddress} for the structure of the user's address data returned.
+     */
+    addAddress: (params: IUserAddressParams) => Promise<IApiResponseWithData<IUserAddress>>;
     /**
      * Updates or creates a new address for a user.
      *
@@ -398,6 +429,86 @@ export interface IUserMethod {
      * @see {@link IPurgeResponse} for the structure of the user's purged data state.
      */
     purgeAddress: (addressId: string) => Promise<IApiResponseWithData<IPurgeResponse>>;
+    /**
+     * Adds a new payment method for a user.
+     *
+     * @param {IUserPaymentAddParams} params - The parameters for adding a new payment method.
+     * @returns {Promise<IApiResponseWithData<IUserPayment>>} A promise that resolves to the API response with the added payment method data.
+     *
+     * @example
+     * const liquidCommerce = await LiquidCommerce(apiKey, config);
+     *
+     * try {
+     *   const newPayment = await liquidCommerce.user.addPayment({
+     *     customerId: 'c1fbd454-a540-4f42-86e9-f87a98bf1812',
+     *     paymentMethodId: 'pm_1234567890abcdef',
+     *     isDefault: true
+     *   });
+     *
+     *   console.log('Added payment method:', newPayment?.data);
+     * } catch (error) {
+     *   console.error('Failed to add payment method:', error);
+     * }
+     *
+     * @throws {Error} - Throws an error if the add payment request fails or if authentication is unsuccessful.
+     *
+     * @see {@link IUserPaymentParams} for the structure of the add payment request parameters.
+     * @see {@link IUserPayment} for the structure of the user's payment method data returned.
+     */
+    addPayment: (params: IUserPaymentAddParams) => Promise<IApiResponseWithData<IUserPayment>>;
+    /**
+     * Updates a payment method for a user.
+     *
+     * @param {IUserPaymentUpdateParams} params - The parameters for updating a payment method.
+     * @returns {Promise<IApiResponseWithData<IUserPayment>>} A promise that resolves to the API response with the updated payment method data.
+     *
+     * @example
+     * const liquidCommerce = await LiquidCommerce(apiKey, config);
+     *
+     * try {
+     *   const updatedPayment = await liquidCommerce.user.updatePayment({
+     *     customerId: 'c1fbd454-a540-4f42-86e9-f87a98bf1812',
+     *     paymentMethodId: 'pm_1234567890abcdef',
+     *     isDefault: true
+     *   });
+     *
+     *   console.log('Updated payment method:', updatedPayment?.data);
+     * } catch (error) {
+     *   console.error('Failed to update payment method:', error);
+     * }
+     *
+     * @throws {Error} - Throws an error if the update payment request fails or if authentication is unsuccessful.
+     *
+     * @see {@link IUserPaymentUpdateParams} for the structure of the update payment request parameters.
+     * @see {@link IUserPayment} for the structure of the user's payment method data returned.
+     */
+    updatePayment: (params: IUserPaymentUpdateParams) => Promise<IApiResponseWithData<IUserPayment>>;
+    /**
+     * Purges a payment method for a user.
+     *
+     * @param {string} customerId - The ID of the customer.
+     * @param {string} paymentId - The ID of the payment method to purge.
+     * @returns {Promise<IApiResponseWithData<IPurgeResponse>>} A promise that resolves to the purge response.
+     *
+     * @example
+     * const liquidCommerce = await LiquidCommerce(apiKey, config);
+     *
+     * try {
+     *   const paymentPurgeResponse = await liquidCommerce.user.purgePayment(
+     *     'c1fbd454-a540-4f42-86e9-f87a98bf1812',
+     *     'pm_1234567890abcdef'
+     *   );
+     *
+     *   console.log('Payment method purge response:', paymentPurgeResponse?.data);
+     * } catch (error) {
+     *   console.error('Failed to purge payment method:', error);
+     * }
+     *
+     * @throws {Error} - Throws an error if the purge payment request fails or if authentication is unsuccessful.
+     *
+     * @see {@link IPurgeResponse} for the structure of the purge response data.
+     */
+    purgePayment: (customerId: string, paymentId: string) => Promise<IApiResponseWithData<IPurgeResponse>>;
 }
 export interface IPaymentMethod {
     /**
@@ -501,6 +612,60 @@ export interface IPaymentMethod {
      * @throws {Error} - Throws an error if the payment element has not been initialized.
      */
     unsubscribe<K extends keyof IPaymentElementEventMap>(eventType: K, handler?: (event: IPaymentElementEventMap[K]) => void): void;
+    /**
+     * Collapses the payment element if it has been initialized.
+     *
+     * @returns {void}
+     *
+     * @example
+     * const liquidCommerce = await LiquidCommerce(apiKey, config);
+     *
+     * try {
+     *   liquidCommerce.payment.collapse();
+     *   console.log('Payment element collapsed');
+     * } catch (error) {
+     *   console.error('Failed to collapse payment element:', error);
+     * }
+     *
+     * @throws {Error} - Throws an error if the payment element has not been initialized.
+     */
+    collapse(): void;
+    /**
+     * Unmounts the payment element from the DOM.
+     *
+     * @returns {void}
+     *
+     * @example
+     * const liquidCommerce = await LiquidCommerce(apiKey, config);
+     *
+     * try {
+     *   liquidCommerce.payment.unmount();
+     *   console.log('Payment element unmounted');
+     * } catch (error) {
+     *   console.error('Failed to unmount payment element:', error);
+     * }
+     *
+     * @throws {Error} - Throws an error if the payment element has not been initialized.
+     */
+    unmount(): void;
+    /**
+     * Destroys the payment element if it has been initialized.
+     *
+     * @returns {void}
+     *
+     * @example
+     * const liquidCommerce = await LiquidCommerce(apiKey, config);
+     *
+     * try {
+     *   liquidCommerce.payment.destroy();
+     *   console.log('Payment element destroyed');
+     * } catch (error) {
+     *   console.error('Failed to destroy payment element:', error);
+     * }
+     *
+     * @throws {Error} - Throws an error if the payment element has not been initialized.
+     */
+    destroy(): void;
 }
 export interface ICheckoutMethod {
     /**

package/dist/types/interfaces/payment.interface.d.ts

@@ -16,12 +16,12 @@ export interface ILiquidPaymentToken {
     id?: string;
     type?: string;
     card?: {
-        brand: string;
-        country: string;
-        expMonth: number;
-        expYear: number;
-        last4: string;
-        funding: string;
+        brand: string | null;
+        country: string | null;
+        expMonth: number | null;
+        expYear: number | null;
+        last4: string | null;
+        funding: string | null;
     };
     created?: number;
     error?: {
@@ -30,7 +30,7 @@ export interface ILiquidPaymentToken {
     };
 }
 export interface ILiquidPaymentError {
-    type: 'validation_error' | 'api_error' | 'client_error';
+    type: 'validation_error' | 'api_error' | 'client_error' | 'confirm_error';
     message: string;
     code?: string;
     param?: string;

package/dist/types/interfaces/user.interface.d.ts

@@ -17,16 +17,33 @@ export interface IUserAddress {
     updatedAt: Date;
     isDefault?: boolean;
 }
+export interface ISavedCard {
+    brand: string | null;
+    country: string | null;
+    expMonth: number | null;
+    expYear: number | null;
+    last4: string | null;
+    funding: string | null;
+}
+export interface IUserPayment {
+    id: string;
+    type: string;
+    isDefault: boolean;
+    card?: ISavedCard;
+}
 export interface IUser {
     id: string;
     email: string;
     firstName: string | null;
     lastName: string | null;
     phone: string | null;
+    company: string | null;
+    profileImage: string | null;
     birthDate: string | null;
     createdAt: Date;
     updatedAt: Date;
     addresses: IUserAddress[];
+    savedPayments: IUserPayment[];
     session: IUserSession;
 }
 export interface IUserSessionParams extends ICoreParams {
@@ -35,6 +52,8 @@ export interface IUserSessionParams extends ICoreParams {
     firstName?: string | null;
     lastName?: string | null;
     phone?: string | null;
+    company?: string | null;
+    profileImage?: string | null;
     birthDate?: string | null;
 }
 export interface IPurgeResponse {
@@ -48,6 +67,16 @@ export interface IUserAddressParams extends ICoreParams {
     city: string;
     state: string;
     zip: string;
-    isDefault?: boolean;
     type: ENUM_ADDRESS_TYPE;
+    isDefault?: boolean;
+}
+export interface IUserPaymentParams extends ICoreParams {
+    customerId: string;
+    paymentMethodId: string;
+}
+export interface IUserPaymentAddParams extends IUserPaymentParams {
+    isDefault?: boolean;
+}
+export interface IUserPaymentUpdateParams extends IUserPaymentParams {
+    isDefault: boolean;
 }

package/dist/types/liquid-commerce-client.d.ts

@@ -4,7 +4,7 @@ import type { ICatalog, ICatalogParams } from './interfaces/catalog.service.inte
 import type { ICheckoutCompleteParams, ICheckoutCompleteResponse, ICheckoutPrepareParams, ICheckoutPrepareResponse } from './interfaces/checkout.interface';
 import type { IAddressMethod, ICartMethod, ICatalogMethod, ICheckoutMethod, ILiquidCommerceClient, IPaymentMethod, IUserMethod } from './interfaces/liquid-commerce-client.interface';
 import type { ILiquidPaymentConfig, ILiquidPaymentToken, IPaymentElementEventMap } from './interfaces/payment.interface';
-import type { IPurgeResponse, IUser, IUserAddress, IUserAddressParams, IUserSessionParams } from './interfaces/user.interface';
+import type { IPurgeResponse, IUser, IUserAddress, IUserAddressParams, IUserPayment, IUserPaymentAddParams, IUserPaymentUpdateParams, IUserSessionParams } from './interfaces/user.interface';
 import type { IAddressAutocompleteParams, IAddressAutocompleteResult, IAddressDetailsParams, IAddressDetailsResult } from './services/address.service';
 import type { IAvailabilityParams, IAvailabilityResponse } from './services/catalog.service';
 import type { IApiResponseWithData, IApiResponseWithoutData, ILiquidCommerceConfig } from './types';
@@ -113,18 +113,28 @@ declare class LiquidCommerceClient implements ILiquidCommerceClient {
      *    Method for creating or updating a user session.
      * @property {function(identifier: string): Promise<IApiResponseWithData<IPurgeResponse>>} purge -
      *    Method for purging a user's data from the system.
+     * @property {function(params: IUserAddressParams): Promise<IApiResponseWithData<IUserAddress>>} addAddress -
+     *    Method for adding a new address for a user.
      * @property {function(params: IUserAddressParams): Promise<IApiResponseWithData<IUserAddress>>} updateAddress -
-     *    Method for updating or creating a user's address.
+     *    Method for updating an existing user's address.
      * @property {function(addressId: string): Promise<IApiResponseWithData<IPurgeResponse>>} purgeAddress -
      *    Method for purging a user's address.
+     * @property {function(params: IUserPaymentAddParams): Promise<IApiResponseWithData<IUserPayment>>} addPayment -
+     *    Method for adding a new payment method for a user.
+     * @property {function(params: IUserPaymentUpdateParams): Promise<IApiResponseWithData<IUserPayment>>} updatePayment -
+     *    Method for updating an existing payment method for a user.
+     * @property {function(customerId: string, paymentId: string): Promise<IApiResponseWithData<IPurgeResponse>>} purgePayment -
+     *    Method for purging a user's payment method.
      *
      * @see {@link IUserSessionParams} for the structure of the session request parameters.
-     * @see {@link IUserAddressParams} for the structure of the address update request parameters.
+     * @see {@link IUserAddressParams} for the structure of the address add/update request parameters.
+     * @see {@link IUserPaymentAddParams} for the structure of the payment add request parameters.
+     * @see {@link IUserPaymentUpdateParams} for the structure of the payment update request parameters.
      * @see {@link IUser} for the structure of the user data returned.
      * @see {@link IUserAddress} for the structure of the user's address data returned.
-     * @see {@link IPurgeResponse} for the structure of the user data returned.
-     *
-     * */
+     * @see {@link IUserPayment} for the structure of the user's payment method data returned.
+     * @see {@link IPurgeResponse} for the structure of the purge response data.
+     */
     user: IUserMethod;
     /**
      * Payment object that provides methods for payment-related operations.
@@ -143,6 +153,15 @@ declare class LiquidCommerceClient implements ILiquidCommerceClient {
      * @property {function(eventType: K, handler?: function): void} unsubscribe -
      *    Method for unsubscribing from payment element events.
      *
+     * @property {function(): void} collapse -
+     *    Method for collapsing the payment element if it's expanded.
+     *
+     * @property {function(): void} unmount -
+     *    Method for removing the payment element from the DOM.
+     *
+     * @property {function(): void} destroy -
+     *    Method for completely removing the payment element and cleaning up associated resources.
+     *
      * @see {@link ILiquidPaymentConfig} Represents the configuration for Liquid payment.
      * @see {@link ILiquidPaymentToken} Represents a payment token for liquid payments.
      * @see {@link ILiquidPaymentError} Represents an error that occurs during a liquid payment.
@@ -186,4 +205,4 @@ declare class LiquidCommerceClient implements ILiquidCommerceClient {
  */
 export declare function LiquidCommerce(apiKey: string, config: ILiquidCommerceConfig): Promise<LiquidCommerceClient>;
 export { LIQUID_COMMERCE_ENV };
-export type { IAddressAutocompleteParams, IAddressAutocompleteResult, IAddressDetailsParams, IAddressDetailsResult, IAddressMethod, IApiResponseWithData, IApiResponseWithoutData, IAvailabilityParams, IAvailabilityResponse, ICart, ICartMethod, ICartUpdateParams, ICatalog, ICatalogMethod, ICatalogParams, ICheckoutCompleteParams, ICheckoutCompleteResponse, ICheckoutMethod, ICheckoutPrepareParams, ICheckoutPrepareResponse, ILiquidCommerceClient, ILiquidCommerceConfig, ILiquidPaymentConfig, ILiquidPaymentToken, IPaymentElementEventMap, IPaymentMethod, IPurgeResponse, IUser, IUserAddress, IUserAddressParams, IUserMethod, IUserSessionParams, };
+export type { IAddressAutocompleteParams, IAddressAutocompleteResult, IAddressDetailsParams, IAddressDetailsResult, IAddressMethod, IApiResponseWithData, IApiResponseWithoutData, IAvailabilityParams, IAvailabilityResponse, ICart, ICartMethod, ICartUpdateParams, ICatalog, ICatalogMethod, ICatalogParams, ICheckoutCompleteParams, ICheckoutCompleteResponse, ICheckoutMethod, ICheckoutPrepareParams, ICheckoutPrepareResponse, ILiquidCommerceClient, ILiquidCommerceConfig, ILiquidPaymentConfig, ILiquidPaymentToken, IPaymentElementEventMap, IPaymentMethod, IPurgeResponse, IUser, IUserAddress, IUserAddressParams, IUserMethod, IUserPayment, IUserPaymentAddParams, IUserPaymentUpdateParams, IUserSessionParams, };

package/dist/types/services/payment.service.d.ts

@@ -36,4 +36,27 @@ export declare class PaymentService {
      * @return void
      */
     unsubscribe<K extends keyof IPaymentElementEventMap>(eventType: K, handler?: (event: IPaymentElementEventMap[K]) => void): void;
+    /**
+     * Collapses the payment element if it has been initialized.
+     * Throws an error if the payment element has not been initialized.
+     *
+     * @return {void}
+     * @throws {Error} Will throw an error if the payment element has not been initialized.
+     */
+    collapse: () => void;
+    /**
+     * Unmounts the payment element from the DOM.
+     * Throws an error if the payment element has not been initialized.
+     *
+     * @return {void}
+     * @throws {Error} Will throw an error if the payment element has not been initialized.
+     */
+    unmount: () => void;
+    /**
+     * Destroys the payment element if it has been initialized.
+     *
+     * @return {void} No return value.
+     * @throws {Error} Will throw an error if the payment element has not been initialized.
+     */
+    destroy: () => void;
 }

package/dist/types/services/user.service.d.ts

@@ -1,5 +1,5 @@
 import type { AuthenticatedService } from '../core';
-import type { IPurgeResponse, IUser, IUserAddress, IUserAddressParams, IUserSessionParams } from '../interfaces/user.interface';
+import type { IPurgeResponse, IUser, IUserAddress, IUserAddressParams, IUserPayment, IUserPaymentAddParams, IUserPaymentUpdateParams, IUserSessionParams } from '../interfaces/user.interface';
 import type { IApiResponseWithData } from '../types';
 /**
  * A class representing a user service.
@@ -24,6 +24,7 @@ export declare class UserService {
      * @throws {Error} If the purge request fails or if the identifier is not provided.
      */
     purge(identifier: string): Promise<IApiResponseWithData<IPurgeResponse>>;
+    addAddress(params: IUserAddressParams): Promise<IApiResponseWithData<IUserAddress>>;
     /**
      * Updates or creates a new address for a user.
      *
@@ -40,4 +41,33 @@ export declare class UserService {
      * @throws {Error} If the address purge request fails or if the address ID is not provided.
      */
     purgeAddress(addressId: string): Promise<IApiResponseWithData<IPurgeResponse>>;
+    /**
+     * Adds a new payment method for a user.
+     *
+     * @param {IUserPaymentParams} params - The parameters required to add a payment method.
+     * @param {string} params.customerId - The ID of the customer.
+     * @param {string} params.paymentMethodId - The ID of the payment method.
+     * @param {boolean} params.isDefault - Indicates whether the new payment method should be marked as default.
+     * @return {Promise<IApiResponseWithData<IUserPayment>>} - A promise that resolves to the response containing user payment information.
+     * @throws {Error} - Throws an error if required parameters are missing or if the request fails.
+     */
+    addPayment(params: IUserPaymentAddParams): Promise<IApiResponseWithData<IUserPayment>>;
+    /**
+     * Updates whether the default payment method for a user.
+     *
+     * @param {IUserPaymentParams} params - The payment parameters required to update payment. Must include `customerId`,
+     *  `paymentMethodId`, and a boolean `isDefault`.
+     * @returns {Promise<IApiResponseWithData<IUserPayment>>} - A promise that resolves to the API response containing
+     *  the updated payment information.
+     * @throws {Error} - Throws an error if required parameters are missing or the request fails.
+     */
+    updatePayment(params: IUserPaymentUpdateParams): Promise<IApiResponseWithData<IUserPayment>>;
+    /**
+     * Purges a payment record for a specified customer.
+     *
+     * @param {string} customerId - The ID of the customer whose payment record is to be purged.
+     * @param {string} paymentId - The ID of the payment record to be purged.
+     * @return {Promise<IApiResponseWithData<IPurgeResponse>>} A promise that resolves to the response of the purge request.
+     */
+    purgePayment(customerId: string, paymentId: string): Promise<IApiResponseWithData<IPurgeResponse>>;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@liquidcommerce/cloud-sdk",
-  "version": "1.1.1",
+  "version": "1.3.0",
   "description": "LiquidCommerce Cloud SDK",
   "main": "./dist/index.cjs",
   "module": "./dist/index.esm.js",