@liquidcommerce/elements-sdk 2.5.6-beta.1 → 2.5.6-beta.11

package/dist/types/modules/checkout/checkout.commands.d.ts

@@ -1,50 +1,52 @@
 import { BaseCommand } from '@/core/command/base-command.service';
-import type { ICheckoutItemStore, ICheckoutStripeFormStatusStore } from '@/core/store/interfaces/checkout.interface';
-import type { ICart, ICheckoutFulfillment, ICheckoutItem, ICheckoutPrepareResponse, ICheckoutRetailer } from '@/interfaces/cloud';
-import type { BillingFieldName, CustomerFieldName, GiftFieldName } from '@/modules/checkout/components/checkout.type';
-export declare function buildCheckoutItemStore(apiItem: ICheckoutItem, retailer: ICheckoutRetailer, fulfillment: ICheckoutFulfillment): ICheckoutItemStore;
+import type { ICheckoutBillingStore, ICheckoutCustomerStore, ICheckoutGiftRecipientStore, ICheckoutPaymentMethodStore } from '@/core/store/interfaces/checkout.interface';
 export declare class CheckoutCommands extends BaseCommand {
     private readonly uiCommands;
     private readonly commonCommands;
     constructor();
     static getInstance(): CheckoutCommands;
     loadCheckout(cartIdParam?: string): Promise<void>;
-    partialLoadCheckout(params?: {
-        cartId?: string;
-        response?: ICheckoutPrepareResponse;
-        cartResponse?: ICart;
-    }): Promise<void>;
     toggleIsGift(active?: boolean): Promise<void>;
     toggleBillingSameAsShipping(active?: boolean): Promise<void>;
-    toggleMarketingPreferences(fieldName: 'canEmail' | 'canSms', active?: boolean): void;
+    toggleMarketingPreferences(fieldName: 'canEmail' | 'canSms', active?: boolean): Promise<void>;
     getPaymentSession(): Promise<void>;
-    confirmPaymentSession(confirmationTokenId: string, setupIntentId: string): Promise<void>;
+    confirmPaymentSession(confirmationTokenId: string, setupIntentId: string): Promise<ICheckoutPaymentMethodStore | null>;
     applyPromoCode(code: string): Promise<void>;
-    clearPromoCodeError(): Promise<void>;
     removePromoCode(): Promise<void>;
+    clearPromoCodeError(): Promise<void>;
     applyGiftCard(code: string): Promise<void>;
-    clearGiftCardError(): Promise<void>;
     removeGiftCard(code: string): Promise<void>;
-    updateCustomerInfo(fieldName: CustomerFieldName, fieldValue: string): void;
-    updateBillingInfo(fieldName: BillingFieldName, fieldValue: string): void;
-    updateGiftInfo(fieldName: GiftFieldName, fieldValue: string): void;
-    private triggerAddShippingInfoEvent;
-    private validateAndUpdateFormStatus;
-    checkoutComplete(): Promise<void>;
-    startPreparingCheckoutSubmit(): Promise<void>;
+    clearGiftCardError(): Promise<void>;
     openPresaleExpiredDrawer(): void;
     rerenderCheckout(): void;
-    focusFirstInvalidField(): Promise<void>;
-    private buildItemUpdate;
     updateCheckoutItemQuantity(itemId: string, delta: number): Promise<void>;
     removeItemEngraving(productItemId: string): Promise<void>;
     removeItem(itemId: string, isNotStandAlone?: boolean): Promise<void>;
     updateTips(percentage: number): Promise<void>;
     updateFulfillmentTip(fulfillmentId: string, tipAmount: number): Promise<void>;
     removeFulfillmentTip(fulfillmentId: string): Promise<void>;
+    clearCheckoutError(): Promise<void>;
+    editCustomerForm(): Promise<void>;
+    saveCustomerForm({ shippingAddressTwo, deliveryInstructions, ...customerData }: ICheckoutCustomerStore & {
+        shippingAddressTwo: string;
+        deliveryInstructions: string;
+    }): Promise<void>;
+    editGiftRecipientForm(): Promise<void>;
+    saveGiftRecipientForm({ shippingAddressTwo, deliveryInstructions, ...giftRecipientData }: ICheckoutGiftRecipientStore & {
+        shippingAddressTwo: string;
+        deliveryInstructions: string;
+    }): Promise<void>;
+    editPaymentForm(): Promise<void>;
+    savePaymentForm({ billingFormData, paymentSession, }: {
+        billingFormData?: ICheckoutBillingStore;
+        paymentSession?: {
+            confirmationTokenId: string;
+            setupIntentId: string;
+        };
+    }): Promise<void>;
+    checkoutComplete(): Promise<void>;
     private updateStoreFromCheckoutResponse;
-    updateStripeFormStatus(status: Partial<ICheckoutStripeFormStatusStore>): Promise<void>;
-    removeCheckoutError(): Promise<void>;
-    updateDeliveryInstructions(instructions: string): Promise<void>;
+    private partialLoadCheckout;
     private dataForCheckoutPrepare;
+    private buildCheckoutItemStore;
 }

package/dist/types/modules/checkout/components/checkout-billing.component.d.ts

@@ -0,0 +1,14 @@
+import { BaseComponent } from '@/core/base-component.service';
+import type { ICheckoutBillingStore } from '@/core/store/interfaces/checkout.interface';
+import type { ICheckoutComponent } from '@/interfaces/configs';
+export interface ICheckoutBillingComponentParams {
+    isFormValid: (isValid: boolean, data: ICheckoutBillingStore) => void;
+}
+export declare class CheckoutBillingComponent extends BaseComponent<ICheckoutBillingComponentParams, ICheckoutComponent> {
+    private billingData;
+    get hostClasses(): string[];
+    constructor();
+    private billingSameAsShippingToggle;
+    private updateSaveButtonState;
+    protected template(): HTMLElement[];
+}

package/dist/types/modules/checkout/components/checkout-buyer-summary.component.d.ts

@@ -0,0 +1,7 @@
+import { BaseComponent } from '@/core/base-component.service';
+import type { ICheckoutComponent } from '@/interfaces/configs';
+export declare class CheckoutBuyerSummaryComponent extends BaseComponent<null, ICheckoutComponent> {
+    get hostClasses(): string[];
+    constructor();
+    protected template(): HTMLElement[];
+}

package/dist/types/modules/checkout/components/{checkout-information-section.component.d.ts → checkout-buyer.component.d.ts}

@@ -1,12 +1,12 @@
 import { BaseComponent, type IOnStoreChanged } from '@/core/base-component.service';
 import type { ICheckoutComponent } from '@/interfaces/configs';
-export interface ICheckoutInformationSectionComponentParams {
-    isIndependentComponent: boolean;
-}
-export declare class CheckoutInformationSectionComponent extends BaseComponent<ICheckoutInformationSectionComponentParams, ICheckoutComponent> {
+export declare class CheckoutBuyer extends BaseComponent<null, ICheckoutComponent> {
+    private customerData;
+    private saveButtonText;
+    private saveButton;
     get hostClasses(): string[];
     constructor();
     onStoreWatch(changes: IOnStoreChanged[]): void;
-    private handleBuyerInformationVisibility;
+    private updateSaveButtonState;
     protected template(): HTMLElement[];
 }

package/dist/types/modules/checkout/components/checkout-deliver-to-summary.component.d.ts

@@ -0,0 +1,7 @@
+import { BaseComponent } from '@/core/base-component.service';
+import type { ICheckoutComponent } from '@/interfaces/configs';
+export declare class CheckoutDeliverToSummaryComponent extends BaseComponent<null, ICheckoutComponent> {
+    get hostClasses(): string[];
+    constructor();
+    protected template(): HTMLElement[];
+}

package/dist/types/modules/checkout/components/checkout-deliver-to.component.d.ts

@@ -0,0 +1,13 @@
+import { BaseComponent, type IOnStoreChanged } from '@/core/base-component.service';
+import type { ICheckoutComponent } from '@/interfaces/configs';
+export declare class CheckoutDeliverToComponent extends BaseComponent<null, ICheckoutComponent> {
+    private customerData;
+    private giftData;
+    private saveButtonText;
+    private saveButton;
+    get hostClasses(): string[];
+    constructor();
+    onStoreWatch(changes: IOnStoreChanged[]): void;
+    private updateSaveButtonState;
+    protected template(): HTMLElement[];
+}

package/dist/types/modules/checkout/components/checkout-information.component.d.ts

@@ -0,0 +1,17 @@
+import { BaseComponent } from '@/core/base-component.service';
+import type { ICheckoutComponent } from '@/interfaces/configs';
+export interface ICheckoutInformationSectionComponentParams {
+    isIndependentComponent: boolean;
+}
+export declare class CheckoutInformationComponent extends BaseComponent<ICheckoutInformationSectionComponentParams, ICheckoutComponent> {
+    private deliveryToForm;
+    private deliverToSummary;
+    private buyerForm;
+    private buyerSummary;
+    private paymentForm;
+    private paymentSummary;
+    get hostClasses(): string[];
+    constructor();
+    onStoreWatch(): void;
+    protected template(): HTMLElement[];
+}

package/dist/types/modules/checkout/components/{checkout-summary-section.component.d.ts → checkout-order-summary.component.d.ts}

@@ -1,6 +1,6 @@
 import { BaseComponent, type IOnStoreChanged } from '@/core/base-component.service';
 import type { ICheckoutComponent } from '@/interfaces/configs';
-export declare class CheckoutSummarySectionComponent extends BaseComponent<null, ICheckoutComponent> {
+export declare class CheckoutOrderSummaryComponent extends BaseComponent<null, ICheckoutComponent> {
     get hostClasses(): string[];
     constructor();
     onStoreWatch(changes: IOnStoreChanged[]): void;

package/dist/types/modules/checkout/components/checkout-payment-summary.component.d.ts

@@ -0,0 +1,7 @@
+import { BaseComponent } from '@/core/base-component.service';
+import type { ICheckoutComponent } from '@/interfaces/configs';
+export declare class CheckoutPaymentSummaryComponent extends BaseComponent<null, ICheckoutComponent> {
+    get hostClasses(): string[];
+    constructor();
+    protected template(): HTMLElement[];
+}

package/dist/types/modules/checkout/components/checkout-payment.component.d.ts

@@ -0,0 +1,30 @@
+import { BaseComponent, type IOnStoreChanged } from '@/core/base-component.service';
+import type { ICheckoutComponent } from '@/interfaces/configs';
+export interface ICheckoutSendToFormComponentParams {
+    isIndependentComponent: boolean;
+}
+export declare class CheckoutPaymentComponent extends BaseComponent<ICheckoutSendToFormComponentParams, ICheckoutComponent> {
+    private stripeHandlerElement;
+    private betaNoticeElement;
+    private saveButton;
+    private errorMessageElement;
+    private billingFormData;
+    private isValidBillingForm;
+    private isBillingSameAsShipping;
+    private stripeFormStatus;
+    private savedCardInfo;
+    private showingStripeSummary;
+    private isSavingPayment;
+    get hostClasses(): string[];
+    constructor();
+    onStoreWatch(changes: IOnStoreChanged[]): void;
+    private handleBillingSameAsShippingChange;
+    afterRender(): Promise<void>;
+    private updateSaveButtonState;
+    private updateErrorMessage;
+    private showError;
+    protected template(): HTMLElement[];
+    private handleSaveButtonClick;
+    private validatePrerequisites;
+    disconnected(): void;
+}

package/dist/types/modules/checkout/components/{summary/checkout-place-order-button.component.d.ts → checkout-place-order-button.component.d.ts}

@@ -8,15 +8,11 @@ export declare class CheckoutPlaceOrderButtonComponent extends BaseComponent<nul
     constructor();
     afterRender(): void;
     disconnected(): void;
-    onStoreChanged(changes: IOnStoreChanged[]): boolean;
+    onStoreWatch(changes: IOnStoreChanged[]): void;
     private updateButtonState;
-    private determineErrorMessage;
     private clearErrorTimeout;
     private updateErrorDisplay;
     private determineButtonState;
-    private applyButtonState;
     private handlePlaceOrderClick;
-    private showPaymentError;
-    private handleCheckoutReadyForSubmit;
     protected template(): HTMLElement[];
 }

package/dist/types/modules/checkout/components/checkout-send-as-gift.component.d.ts

@@ -0,0 +1,7 @@
+import { BaseComponent } from '@/core/base-component.service';
+import type { ICheckoutComponent } from '@/interfaces/configs';
+export declare class CheckoutSendAsGiftComponent extends BaseComponent<null, ICheckoutComponent> {
+    get hostClasses(): string[];
+    constructor();
+    protected template(): HTMLElement[];
+}

package/dist/types/modules/checkout/components/{information/checkout-stripe-form.component.d.ts → checkout-stripe-form.component.d.ts}

@@ -17,9 +17,10 @@ export interface IStripeConfig {
     elementOptions?: Record<string, any>;
 }
 export interface IStripeFormStatus {
-    isComplete: boolean;
-    hasError: boolean;
+    isFormComplete: boolean;
     isProcessing: boolean;
+    hasCompletedPayment: boolean;
+    hasError: boolean;
     errorMessage: string | null;
 }
 export declare class CheckoutStripeFormComponent extends HTMLElement {
@@ -31,6 +32,7 @@ export declare class CheckoutStripeFormComponent extends HTMLElement {
     private _isFormComplete;
     private _hasUsedCurrentSession;
     private _stripeConfig;
+    private _sessionRefreshPromise;
     initialize({ data }: {
         data: {
             stripeConfig: IStripeConfig;
@@ -38,11 +40,11 @@ export declare class CheckoutStripeFormComponent extends HTMLElement {
     }): Promise<void>;
     private initializeStripe;
     private setupEventListeners;
-    private handleSubmitEvent;
     private handleRefreshSession;
     private handleSubmit;
     private requestSessionRefresh;
     private refreshPaymentSession;
+    private resetForm;
     private updateStripeFormStatus;
     private createConfirmationTokenId;
     disconnected(): Promise<void>;

package/dist/types/modules/checkout/components/checkout-stripe-handler.component.d.ts

@@ -0,0 +1,50 @@
+import { BaseComponent, type IOnStoreChanged } from '@/core/base-component.service';
+import type { ICheckoutComponent } from '@/interfaces/configs';
+import type { IStripeFormStatus } from '@/modules/checkout/components/checkout-stripe-form.component';
+export interface ICheckoutStripeHandlerCallbacks {
+    onStripeFormStatusChanged?: (status: IStripeFormStatus) => void;
+    onSavedCardInfoChanged?: (cardInfo: {
+        brand?: string;
+        last4?: string;
+    } | null) => void;
+    onEditModeVisibilityChanged?: (showingSummary: boolean) => void;
+    onPaymentSessionConfirmed?: (confirmationTokenId: string, setupIntentId: string) => Promise<void>;
+}
+export interface ICheckoutStripeHandlerComponentParams {
+    isIndependentComponent: boolean;
+    callbacks?: ICheckoutStripeHandlerCallbacks;
+}
+export declare class CheckoutStripeHandlerComponent extends BaseComponent<ICheckoutStripeHandlerComponentParams, ICheckoutComponent> {
+    private stripeFormElement;
+    private rootComponent;
+    private isCreatingStripeForm;
+    private stripeFormContainer;
+    private stripeSummaryContainer;
+    private callbacks;
+    private stripeFormStatus;
+    private isInEditMode;
+    private savedCardInfo;
+    private isChangingPayment;
+    get hostClasses(): string[];
+    constructor();
+    beforeConnected(): void;
+    onStoreWatch(changes: IOnStoreChanged[]): void;
+    private handleSavedCardChange;
+    private handleEditModeChange;
+    private updateDisplayState;
+    afterRender(): Promise<void>;
+    private setupStripeFormEventListeners;
+    private showStripeSummary;
+    private hideStripeSummary;
+    private showStripeForm;
+    private hideStripeForm;
+    private handleChangePayment;
+    protected template(): HTMLElement[];
+    submitStripeForm(): void;
+    getStripeFormStatus(): IStripeFormStatus;
+    private findRootComponent;
+    private removeExistingStripeForm;
+    private doStripeConfig;
+    private createAndMountStripeForm;
+    disconnected(): void;
+}

package/dist/types/modules/checkout/components/index.d.ts

@@ -1,20 +1,25 @@
+export * from './checkout-amounts.component';
+export * from './checkout-billing.component';
+export * from './checkout-buyer.component';
+export * from './checkout-buyer-summary.component';
+export * from './checkout-completed.component';
+export * from './checkout-deliver-to.component';
+export * from './checkout-deliver-to-summary.component';
+export * from './checkout-gift-cards.component';
 export * from './checkout-header.component';
-export * from './checkout-information-section.component';
+export * from './checkout-information.component';
+export * from './checkout-item.component';
+export * from './checkout-item-quantity.component';
+export * from './checkout-items.component';
+export * from './checkout-order-summary.component';
+export * from './checkout-payment.component';
+export * from './checkout-payment-summary.component';
+export * from './checkout-place-order-button.component';
 export * from './checkout-presale-countdown.component';
-export * from './checkout-summary-section.component';
-export * from './information/checkout-billing-form.component';
-export * from './information/checkout-buyer-information-form.component';
-export * from './information/checkout-delivery-information-form.component';
-export * from './information/checkout-payment-form.component';
-export * from './information/checkout-stripe-form.component';
-export * from './summary/checkout-amounts.component';
-export * from './summary/checkout-completed.component';
-export * from './summary/checkout-gift-cards.component';
-export * from './summary/checkout-item.component';
-export * from './summary/checkout-item-quantity.component';
-export * from './summary/checkout-items.component';
-export * from './summary/checkout-place-order-button.component';
-export * from './summary/checkout-presale-expired.component';
-export * from './summary/checkout-promo-code.component';
-export * from './summary/checkout-tips.component';
-export * from './summary/promo-pc-gc.component';
+export * from './checkout-presale-expired.component';
+export * from './checkout-promo-code.component';
+export * from './checkout-send-as-gift.component';
+export * from './checkout-stripe-form.component';
+export * from './checkout-stripe-handler.component';
+export * from './checkout-tips.component';
+export * from './promo-pc-gc.component';

package/dist/types/modules/checkout/constant.d.ts

@@ -13,7 +13,6 @@ export declare const giftFormFields: {
     readonly lastName: "lastName";
     readonly email: "email";
     readonly phone: "phone";
-    readonly birthDate: "birthDate";
     readonly addressTwo: "addressTwo";
     readonly message: "message";
 };

package/dist/types/modules/product/components/components.d.ts

@@ -1,7 +1,7 @@
 import type { IProductFulfillmentStore } from '@/core/store/interfaces/product.interface';
 import { type FulfillmentType } from '@/enums';
 import type { IProductSizeAttributes } from '@/interfaces/cloud';
-import { type RetailerStatus } from '@/modules/product/utils';
+import type { RetailerStatus } from '@/modules/product/utils/retailer-hours';
 export declare function renderPopupRetailerCard({ fulfillment, selectedFulfillmentType, isSelected, fulfillmentStatus, selectedSizeAttributes, }: {
     fulfillment: IProductFulfillmentStore;
     selectedFulfillmentType: FulfillmentType;

package/dist/types/modules/product/utils/helpers.d.ts

@@ -1,10 +1,3 @@
 import type { IProductFulfillmentStore } from '@/core/store/interfaces/product.interface';
 import { type FulfillmentType } from '@/enums';
-import type { IProductSize, IRetailer } from '@/interfaces/cloud';
-export declare const filterRetailersByFulfillmentType: ({ retailers, selectedSize, engravingLines, fulfillmentType, }: {
-    retailers: IRetailer[];
-    selectedSize: IProductSize | null;
-    engravingLines: string[];
-    fulfillmentType: FulfillmentType;
-}) => IRetailer[];
 export declare function fulfillmentAddress(address: IProductFulfillmentStore['retailerAddress'], selectedFulfillmentType: FulfillmentType): string;

package/dist/types/modules/ui-components/input/birthdate-input.component.d.ts

@@ -1,4 +1,4 @@
-import { BaseComponent, type IOnStoreChanged } from '@/core/base-component.service';
+import { BaseComponent } from '@/core/base-component.service';
 export interface IBirthdateValidation {
     required?: boolean;
     minYear?: number;
@@ -16,7 +16,6 @@ export interface IBirthdateInputComponentParams {
     label?: string;
     name: string;
     disabled?: boolean;
-    storePath?: string;
 }
 export declare class BirthdateInputComponent extends BaseComponent<IBirthdateInputComponentParams, null> {
     get hostClasses(): string[];
@@ -24,8 +23,7 @@ export declare class BirthdateInputComponent extends BaseComponent<IBirthdateInp
     private dayInput;
     private yearInput;
     private errorContainer;
-    constructor();
-    onStoreWatch(changes: IOnStoreChanged[]): void;
+    private validationTimeout;
     afterRender(): void;
     private populateInitialValue;
     private setupEventListeners;
@@ -34,6 +32,8 @@ export declare class BirthdateInputComponent extends BaseComponent<IBirthdateInp
     private formatYear;
     private handleNavigation;
     private handleChange;
+    private isFieldsComplete;
+    private scheduleValidation;
     private getFormattedValue;
     private validateDate;
     private calculateAge;

package/dist/types/modules/ui-components/input/input.component.d.ts

@@ -1,4 +1,4 @@
-import { BaseComponent, type IOnStoreChanged } from '@/core/base-component.service';
+import { BaseComponent } from '@/core/base-component.service';
 export interface IInputValidation {
     required?: boolean;
     min?: number;
@@ -19,21 +19,21 @@ export interface IInputComponentParams {
     name: string;
     autocomplete?: boolean;
     disabled?: boolean;
-    storePath?: string;
 }
 export declare class InputComponent extends BaseComponent<IInputComponentParams, null> {
     get hostClasses(): string[];
     private inputElement;
     private errorContainer;
-    constructor();
-    onStoreChanged(changes: IOnStoreChanged[]): boolean;
+    private validationTimeout;
     private handlePhoneKeydown;
     private formatPhoneNumber;
     private formatDate;
     private validateEmail;
     private validateTel;
     private validateDate;
+    private isFieldComplete;
     private validateInput;
+    private scheduleValidation;
     private showErrors;
     private clearErrors;
     getValue(): string;

package/docs/ACTIONS.md

@@ -24,15 +24,15 @@ const actions = window.elements.actions;
 // 1. Fire the action (simple, clean)
 await actions.cart.applyPromoCode('SAVE20');
 
-// 2. Listen for success/failure feedback via events  
+// 2. Listen for success/failure feedback via events
 window.addEventListener('lce:actions.cart_promo_code_applied', function(event) {
-  const { applied, discountAmount, newTotal } = event.detail.data;
+  const { discountAmount, newTotal } = event.detail.data;
   showSuccessMessage(`🎉 Promo applied! You saved $${discountAmount}!`);
   updateCartDisplay(newTotal);
 });
 
 window.addEventListener('lce:actions.cart_promo_code_failed', function(event) {
-  const { attempted, error } = event.detail.data;
+  const { error } = event.detail.data;
   showErrorMessage('Promo code could not be applied. Please try again.');
 });
 ```
@@ -262,26 +262,26 @@ All actions provide feedback through events. Here are all available success/fail
 'lce:actions.cart_product_add_failed'     // { identifiers: string[], error: string }
 
 // Promo code management
-'lce:actions.cart_promo_code_applied'     // { applied: true, discountAmount?: number, newTotal?: number }
-'lce:actions.cart_promo_code_removed'     // { applied: false }
-'lce:actions.cart_promo_code_failed'      // { attempted: true, error: string }
+'lce:actions.cart_promo_code_applied'     // { discountAmount?: number, newTotal?: number }
+'lce:actions.cart_promo_code_removed'     // { newTotal?: number }
+'lce:actions.cart_promo_code_failed'      // { error: string }
 ```
 
 ### **Checkout Action Events**
 ```javascript
-// Product management  
-'lce:actions.checkout_product_add_success'  // { itemsAdded: number, identifiers: string[] }
-'lce:actions.checkout_product_add_failed'   // { identifiers: string[], error: string }
+// Product management
+'lce:actions.checkout_product_add_success'  // { itemsAdded: number, identifiers: string[], isPresale?: boolean }
+'lce:actions.checkout_product_add_failed'   // { identifiers: string[], error: string, isPresale?: boolean }
 
 // Promo code management
-'lce:actions.checkout_promo_code_applied'   // { applied: true, discountAmount?: number, newTotal?: number }
-'lce:actions.checkout_promo_code_removed'   // { applied: false }
-'lce:actions.checkout_promo_code_failed'    // { attempted: true, error: string }
+'lce:actions.checkout_promo_code_applied'   // { discountAmount?: number, newTotal?: number }
+'lce:actions.checkout_promo_code_removed'   // { newTotal?: number }
+'lce:actions.checkout_promo_code_failed'    // { error: string }
 
 // Gift card management
-'lce:actions.checkout_gift_card_applied'    // { applied: true, newTotal?: number }
-'lce:actions.checkout_gift_card_removed'    // { applied: false }
-'lce:actions.checkout_gift_card_failed'     // { attempted: true, error: string }
+'lce:actions.checkout_gift_card_applied'    // { newTotal?: number }
+'lce:actions.checkout_gift_card_removed'    // { newTotal?: number }
+'lce:actions.checkout_gift_card_failed'     // { error: string }
 ```
 
 ### **Address Action Events** 
@@ -335,14 +335,14 @@ window.addEventListener('lce:actions.cart_product_add_success', function(event)
 ```javascript
 // ✅ Create reusable handlers
 const handlePromoSuccess = (event) => {
-  const { applied, discountAmount, newTotal } = event.detail.data;
+  const { discountAmount, newTotal } = event.detail.data;
   showSuccessMessage(`Discount applied! Saved: $${discountAmount}`);
   updatePriceDisplay(newTotal);
   trackPromoSuccess(discountAmount);
 };
 
 const handlePromoFailure = (event) => {
-  const { attempted, error } = event.detail.data;
+  const { error } = event.detail.data;
   showErrorMessage('Promo code could not be applied');
   trackPromoFailure();
 };
@@ -472,19 +472,19 @@ await actions.cart.applyPromoCode('WELCOME10');
 
 // Listen for success
 window.addEventListener('lce:actions.cart_promo_code_applied', function(event) {
-  const { applied, discountAmount, newTotal } = event.detail.data;
+  const { discountAmount, newTotal } = event.detail.data;
   showMessage(`Welcome discount applied! You saved $${discountAmount}!`);
   updateCartDisplay(newTotal);
-  
+
   // Track successful promo usage
   analytics.track('Promo Applied', { discount: discountAmount });
 });
 
 // Listen for failure and try fallback
 window.addEventListener('lce:actions.cart_promo_code_failed', function(event) {
-  const { attempted, error } = event.detail.data;
+  const { error } = event.detail.data;
   console.log('First promo failed, trying backup promo');
-  
+
   // Try another strategy
   actions.cart.applyPromoCode('FIRSTTIME');
 });
@@ -494,9 +494,9 @@ await actions.cart.removePromoCode();
 
 // Listen for removal confirmation
 window.addEventListener('lce:actions.cart_promo_code_removed', function(event) {
-  const { applied } = event.detail.data;
+  const { newTotal } = event.detail.data;
   showMessage("Previous promo removed. Applying better discount...");
-  
+
   // Apply better deal
   actions.cart.applyPromoCode('BETTER20');
 });
@@ -624,31 +624,31 @@ const customer = getCurrentCustomer();
 
 // Set up event listeners first
 window.addEventListener('lce:actions.checkout_promo_code_applied', function(event) {
-  const { applied, discountAmount, newTotal } = event.detail.data;
+  const { discountAmount, newTotal } = event.detail.data;
   showCheckoutSuccess(`Discount applied! You saved $${discountAmount}`);
   updateCheckoutTotal(newTotal);
-  
+
   // Track successful conversion optimization
   analytics.track('Checkout Discount Applied', { discount: discountAmount });
 });
 
 window.addEventListener('lce:actions.checkout_promo_code_failed', function(event) {
-  const { attempted, error } = event.detail.data;
+  const { error } = event.detail.data;
   console.log('Promo code failed:', error);
-  
+
   // Try fallback strategies or notify user
   showCheckoutError('Discount could not be applied');
 });
 
 // Apply gift card event listeners
 window.addEventListener('lce:actions.checkout_gift_card_applied', function(event) {
-  const { applied, newTotal } = event.detail.data;
+  const { newTotal } = event.detail.data;
   showCheckoutSuccess('Gift card applied to your order!');
   updateCheckoutTotal(newTotal);
 });
 
 window.addEventListener('lce:actions.checkout_gift_card_failed', function(event) {
-  const { attempted, error } = event.detail.data;
+  const { error } = event.detail.data;
   showCheckoutError('Gift card could not be applied. Please check and try again.');
 });