@liquidcommerce/elements-sdk 2.6.5 → 2.6.6

package/dist/types/interfaces/api/checkout.interface.d.ts

@@ -0,0 +1,216 @@
+import type { CheckoutEventLevel, CheckoutEventType, FulfillmentType } from '@/enums';
+import type { IAddressAddress, IAddressCoordinates, ILocation } from '@/interfaces/api/address.interface';
+import type { ICart } from '@/interfaces/api/cart.interface';
+import type { IProductPresale } from '@/interfaces/api/product.interface';
+export interface ICheckoutComplete {
+    orderNumber: string;
+}
+export interface ICheckoutPaymentSession {
+    key: string;
+    secret: string;
+}
+export interface ICheckoutPaymentConfirmParams {
+    confirmationTokenId: string;
+    setupIntentId: string;
+}
+export interface ICheckoutPaymentConfirmCard {
+    brand: string;
+    expMonth: string;
+    expYear: string;
+    last4: string;
+}
+export interface ICheckoutPaymentConfirm {
+    id: string;
+    card: ICheckoutPaymentConfirmCard;
+}
+export interface ICheckoutCustomer {
+    email: string;
+    firstName: string;
+    lastName: string;
+    company: string;
+    phone: string;
+    birthDate: string;
+}
+export interface ICheckoutBilling {
+    firstName: string;
+    lastName: string;
+    email: string;
+    phone: string;
+    company: string;
+    one: string;
+    two: string;
+    city: string;
+    state: string;
+    zip: string;
+}
+export interface ICheckoutGiftRecipient {
+    firstName: string;
+    lastName: string;
+    email: string;
+    phone: string;
+    message: string;
+}
+export interface ICheckoutMarketingPreferences {
+    canEmail: boolean;
+    canSms: boolean;
+}
+export interface ICheckoutDeliveryTip {
+    fulfillmentId: string;
+    tip: number;
+}
+export interface ICheckoutDeliveryInstructions {
+    fulfillmentId: string;
+    instructions: string;
+}
+export interface ICheckoutPrepareParams {
+    cartId: string;
+    customer?: ICheckoutCustomer;
+    shippingAddressTwo?: string;
+    billingAddress?: ICheckoutBilling;
+    isGift?: boolean;
+    billingSameAsShipping?: boolean;
+    giftOptions?: ICheckoutGiftRecipient;
+    marketingPreferences?: ICheckoutMarketingPreferences;
+    deliveryTips?: ICheckoutDeliveryTip[];
+    deliveryInstructions?: ICheckoutDeliveryInstructions[];
+    payment?: string;
+    promoCode?: string;
+    giftCards?: string[];
+}
+export interface ICheckoutUpdateItem {
+    id?: string;
+    partNumber: string;
+    quantity: number;
+    fulfillmentId: string;
+    engravingLines?: string[];
+}
+export interface ICheckoutItemsUpdateParams {
+    cartId: string;
+    items: ICheckoutUpdateItem[];
+    location?: ILocation;
+}
+export interface ICheckoutItemsUpdateResponse {
+    cart: ICart;
+    checkout: ICheckoutPrepare;
+}
+export interface ICheckoutAmounts {
+    subtotal: number;
+    engraving: number;
+    service: number;
+    shipping: number;
+    delivery: number;
+    platform: number;
+    discounts: number;
+    giftCards: number;
+    tax: number;
+    tip: number;
+    total: number;
+}
+export interface ICheckoutPromoCode {
+    code: string;
+    discount: number;
+    freeDelivery: boolean;
+    freeServiceFee: boolean;
+    freeShipping: boolean;
+}
+export interface ICheckoutGiftCard {
+    code: string;
+    applied: number;
+}
+export interface ICheckoutShippingAddress {
+    formattedAddress: string;
+    address: IAddressAddress;
+    coordinates: IAddressCoordinates;
+}
+export interface ICheckoutItemEngraving {
+    isEngravable: boolean;
+    hasEngraving: boolean;
+    fee: number;
+    maxCharsPerLine: number;
+    maxLines: number;
+    location: string;
+    lines: string[];
+}
+export interface ICheckoutItemAttributes {
+    engraving: ICheckoutItemEngraving;
+    presale: IProductPresale;
+}
+export interface ICheckoutItem {
+    variantId: string;
+    cartItemId: string;
+    liquidId: string;
+    retailerId: string;
+    fulfillmentId: string;
+    salsifyPid?: string;
+    salsifyGrouping?: string;
+    name: string;
+    catPath: string;
+    volume: string;
+    uom: string;
+    proof: string;
+    abv: string;
+    containerType: string;
+    container: string;
+    size: string;
+    pack: boolean;
+    packDesc: string;
+    mainImage: string;
+    brand: string;
+    partNumber: string;
+    upc: string;
+    sku: string;
+    price: number;
+    unitPrice: number;
+    quantity: number;
+    tax: number;
+    unitTax: number;
+    bottleDeposits: number;
+    attributes: ICheckoutItemAttributes;
+}
+export interface ICheckoutFulfillment {
+    id: string;
+    deliveryInstructions: string;
+    type: FulfillmentType;
+    expectation: string;
+    engravingExpectation: string;
+    itemIds: string[];
+    doesAllowPromos: boolean;
+    doesAllowGiftCards: boolean;
+    amounts: ICheckoutAmounts;
+    itemsQuantity: number;
+}
+export interface ICheckoutRetailer {
+    id: string;
+    name: string;
+    fulfillments: Record<string, ICheckoutFulfillment>;
+    amounts: ICheckoutAmounts;
+}
+export interface ICheckoutPresale {
+    isLocked: boolean;
+    expiresAt: string;
+}
+export interface ICheckoutEvent {
+    type: CheckoutEventType;
+    message: string;
+    level: CheckoutEventLevel;
+}
+export interface ICheckoutPrepare {
+    token: string;
+    cartId: string;
+    customer: ICheckoutCustomer;
+    isGift: boolean;
+    billingSameAsShipping: boolean;
+    payment?: string;
+    giftOptions: ICheckoutGiftRecipient;
+    marketingPreferences: ICheckoutMarketingPreferences;
+    shippingAddress: ICheckoutShippingAddress;
+    billingAddress: ICheckoutBilling;
+    promoCode: ICheckoutPromoCode | null;
+    amounts: ICheckoutAmounts;
+    giftCards: ICheckoutGiftCard[];
+    presale: ICheckoutPresale | null;
+    itemsQuantity: number;
+    items: Record<string, ICheckoutItem>;
+    retailers: Record<string, ICheckoutRetailer>;
+    events: ICheckoutEvent[];
+}

package/dist/types/interfaces/api/product.interface.d.ts

@@ -34,7 +34,6 @@ export interface IProductSize {
     onDemandVariants: Record<string, IProductVariant>;
 }
 export interface IProductFulfillmentHourStatus {
-    text: string;
     isOpen: boolean;
     openTime: string;
     isClosed: boolean;
@@ -73,8 +72,8 @@ export interface IFulfillment {
     type: FulfillmentType;
     doesAllowGiftCards: boolean;
     doesAllowPromos: boolean;
-    expectationText: string;
-    engravingExpectationText: string;
+    expectation: string;
+    engravingExpectation: string;
     fee: number;
     timezone: string;
     hourStatus: IProductFulfillmentHourStatus;

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

@@ -28,6 +28,7 @@ export interface ILiquidCommerceElementsBaseConfig {
     promoTicker?: IPromoTicker[];
     customTheme?: IClientCustomThemeConfig;
     debugMode?: DebugMode;
+    checkoutUrl?: string;
 }
 export interface ILiquidCommerceElementsBuilderConfig extends ILiquidCommerceElementsBaseConfig {
 }
@@ -65,6 +66,11 @@ export interface IProcessInjectElementParams {
     containerId: string;
     identifier?: string;
     options?: IAddressOptions;
+    checkoutId?: string;
+}
+export interface IInjectCheckoutParams {
+    containerId: string;
+    checkoutId?: string;
 }
 export interface ILiquidCommerceElementsUIMethod {
     cartButton(containerId: string, showItemsCount?: boolean): void;
@@ -101,7 +107,7 @@ export interface ILiquidCommerceElementsClient {
     injectProductElement(params: IInjectProductElement[]): Promise<IInjectedComponent[]>;
     injectAddressElement(containerId: string, options?: IAddressOptions): Promise<IInjectedComponent | null>;
     injectCartElement(containerId: string): Promise<IInjectedComponent | null>;
-    injectCheckoutElement(containerId: string): Promise<IInjectedComponent | null>;
+    injectCheckoutElement(params: IInjectCheckoutParams): Promise<IInjectedComponent | null>;
     injectProductList(params: IInjectProductListParams): Promise<void>;
     ui: ILiquidCommerceElementsUIMethod;
     actions: ILiquidCommerceElementsActions;

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

@@ -8,17 +8,15 @@ export interface AddItemParams {
     identifier: string;
 }
 export declare class CartCommands extends BaseCommand {
-    private readonly uiCommands;
-    private readonly checkoutCommands;
-    private readonly commonCommands;
     constructor();
     static getInstance(): CartCommands;
     updateItemQuantity(itemId: string, delta: number): Promise<void>;
     removeItem(itemId: string, isNotStandAlone?: boolean): Promise<void>;
     updateItemEngraving(productItemId: string, engravingLines: string[]): Promise<void>;
     addItem(params: AddItemParams): Promise<void>;
-    addPresaleItem(params: AddItemParams): Promise<void>;
     handleGoToCheckout(): Promise<void>;
+    private trackBeginCheckout;
+    private resolveCheckoutRedirectUrl;
     applyPromoCode(promoCode: string): Promise<void>;
     removePromoCode(): Promise<void>;
     rerenderCart(): void;
@@ -31,4 +29,6 @@ export declare class CartCommands extends BaseCommand {
     private updateFulfillment;
     private addNewFulfillmentAndRetailer;
     private cleanupAfterItemRemoval;
+    private syncCartState;
+    private buildCartLoadedEventData;
 }

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

@@ -1,11 +1,18 @@
 import { BaseCommand } from '@/core/command/base-command.service';
-import type { ICheckoutBillingStore, ICheckoutCustomerStore, ICheckoutGiftRecipientStore, ICheckoutPaymentMethodStore } from '@/core/store/interfaces/checkout.interface';
+import type { ICheckoutDetailsEventData } from '@/core/pubsub/interfaces/checkout.interface';
+import type { ICheckoutPaymentMethodStore } from '@/core/store/interfaces/checkout.interface';
+import type { ICheckoutBilling, ICheckoutCustomer, ICheckoutGiftRecipient } from '@/interfaces/api/checkout.interface';
+import type { AddItemParams } from '@/modules/cart/cart.commands';
+import type { PresaleExpiredReason } from '@/modules/checkout/components';
 export declare class CheckoutCommands extends BaseCommand {
     private readonly uiCommands;
-    private readonly commonCommands;
     constructor();
     static getInstance(): CheckoutCommands;
-    loadCheckout(cartIdParam?: string): Promise<void>;
+    addPresaleItem(params: AddItemParams): Promise<void>;
+    loadCheckout(params: {
+        customCartId?: string;
+        isForPresale?: boolean;
+    }): Promise<void>;
     toggleIsGift(active?: boolean): Promise<void>;
     toggleBillingSameAsShipping(active?: boolean): Promise<void>;
     toggleMarketingPreferences(fieldName: 'canEmail' | 'canSms', active?: boolean): Promise<void>;
@@ -17,7 +24,7 @@ export declare class CheckoutCommands extends BaseCommand {
     applyGiftCard(code: string): Promise<void>;
     removeGiftCard(code: string): Promise<void>;
     clearGiftCardError(): Promise<void>;
-    openPresaleExpiredDrawer(): void;
+    openPresaleExpiredDrawer(reason?: PresaleExpiredReason): void;
     rerenderCheckout(): void;
     updateCheckoutItemQuantity(itemId: string, delta: number): Promise<void>;
     removeItemEngraving(productItemId: string): Promise<void>;
@@ -28,18 +35,18 @@ export declare class CheckoutCommands extends BaseCommand {
     clearCheckoutError(): Promise<void>;
     editCustomerForm(): Promise<void>;
     saveCustomerForm({ shippingAddressTwo, deliveryInstructions, customerData, }: {
-        customerData: ICheckoutCustomerStore;
+        customerData: ICheckoutCustomer;
         shippingAddressTwo: string;
         deliveryInstructions: string;
     }): Promise<void>;
     editGiftRecipientForm(): Promise<void>;
-    saveGiftRecipientForm({ shippingAddressTwo, deliveryInstructions, ...giftRecipientData }: ICheckoutGiftRecipientStore & {
+    saveGiftRecipientForm({ shippingAddressTwo, deliveryInstructions, ...giftRecipientData }: ICheckoutGiftRecipient & {
         shippingAddressTwo: string;
         deliveryInstructions: string;
     }): Promise<void>;
     editPaymentForm(): Promise<void>;
     savePaymentForm({ billingFormData, paymentSession, }: {
-        billingFormData?: ICheckoutBillingStore;
+        billingFormData?: ICheckoutBilling;
         paymentSession?: {
             confirmationTokenId: string;
             setupIntentId: string;
@@ -47,7 +54,9 @@ export declare class CheckoutCommands extends BaseCommand {
     }): Promise<void>;
     checkoutComplete(): Promise<void>;
     private updateStoreFromCheckoutResponse;
-    private partialLoadCheckout;
+    private syncFromItemUpdate;
+    private syncCheckoutState;
+    private refreshCheckout;
     private dataForCheckoutPrepare;
-    private buildCheckoutItemStore;
+    getDetails(): ICheckoutDetailsEventData;
 }

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

@@ -1,8 +1,8 @@
 import { BaseComponent } from '@/core/base-component.service';
-import type { ICheckoutBillingStore } from '@/core/store/interfaces/checkout.interface';
+import type { ICheckoutBilling } from '@/interfaces/api/checkout.interface';
 import type { ICheckoutComponent } from '@/interfaces/configs';
 export interface ICheckoutBillingComponentParams {
-    isFormValid: (isValid: boolean, data: ICheckoutBillingStore) => void;
+    isFormValid: (isValid: boolean, data: ICheckoutBilling) => void;
 }
 export declare class CheckoutBillingComponent extends BaseComponent<ICheckoutBillingComponentParams, ICheckoutComponent> {
     private billingData;

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

@@ -1,14 +1,15 @@
 import { BaseComponent, type IOnStoreChanged } from '@/core/base-component.service';
 import type { ICheckoutComponent } from '@/interfaces/configs';
 export declare class CheckoutItemsComponent extends BaseComponent<null, ICheckoutComponent> {
+    private togglerElement;
+    private togglerButton;
+    private togglerLabel;
+    private itemsList;
     get hostClasses(): string[];
     constructor();
     private createItemElement;
-    private getItemsListContainer;
-    private getTogglerLabel;
     private getCurrentItemsMap;
     private syncItemsWithStore;
-    private updateItemCount;
     onStoreChanged(changes: IOnStoreChanged[]): boolean | undefined;
     private handleToggle;
     private setupToggler;

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

@@ -1,8 +1,11 @@
 import { BaseComponent, type IOnStoreChanged } from '@/core/base-component.service';
 export declare class CheckoutPresaleCountdownComponent extends BaseComponent<null> {
+    private static readonly DEFAULT_PRESALE_DURATION_SECONDS;
+    private static readonly ONE_MINUTE_THRESHOLD_SECONDS;
+    private static readonly COUNTDOWN_UPDATE_INTERVAL_MS;
     private countdownInterval;
     private expiresAt;
-    private totalDuration;
+    private initialDurationSeconds;
     private rootElement;
     private scrollHandler;
     private scrollContainer;
@@ -11,16 +14,26 @@ export declare class CheckoutPresaleCountdownComponent extends BaseComponent<nul
     get hostClasses(): string[];
     constructor();
     onStoreChanged(changes: IOnStoreChanged[]): boolean;
+    private resetCountdownState;
     protected afterRender(): void;
     protected disconnected(): void;
     private setupDrawerScrollDetection;
+    private findScrollContainer;
+    private setScrolledState;
     private isScrollable;
     private cleanupScrollListener;
     private updateExpiresAt;
     private startCountdown;
     private stopCountdown;
     private updateCountdown;
+    private updateWarningState;
+    private updateTimerDisplay;
+    private updateProgressBar;
     private formatTime;
     private handleExpire;
     protected template(): HTMLElement;
+    private createTextContainer;
+    private createHeader;
+    private createSubtitle;
+    private createProgressBar;
 }

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

@@ -1,11 +1,17 @@
 import { BaseComponent } from '@/core/base-component.service';
 import type { ICheckoutComponent } from '@/interfaces/configs';
-export declare class CheckoutPresaleExpiredComponent extends BaseComponent<null, ICheckoutComponent> {
+export type PresaleExpiredReason = 'time_expired' | 'items_unavailable';
+export interface ICheckoutPresaleExpiredComponentParams {
+    reason: PresaleExpiredReason;
+}
+export declare class CheckoutPresaleExpiredComponent extends BaseComponent<ICheckoutPresaleExpiredComponentParams, ICheckoutComponent> {
     private autoCloseInterval;
     private autoCloseSeconds;
     private autoCloseElement;
     get hostClasses(): string[];
     get hostAttributes(): Record<string, string>;
+    private isItemsUnavailable;
+    private isTimeExpired;
     protected afterRender(): void;
     protected disconnected(): void;
     private handleExit;

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

@@ -6,8 +6,8 @@ export declare class CheckoutTipsComponent extends BaseComponent<null, ICheckout
     constructor();
     protected afterRender(): void;
     private getTipSelection;
-    private getOnDemandFulfillmentTipInfo;
-    private getFulfillmentTipInfoArray;
+    private getOnDemandFulfillments;
+    private getRetailerNameForFulfillment;
     private handlePercentageSelect;
     private handleFulfillmentTipInput;
     private removeTipFromFulfillment;

package/dist/types/modules/checkout/components/promo-pc-gc.component.d.ts

@@ -7,8 +7,6 @@ export declare class CheckoutPcGcComponent extends BaseComponent<null, ICheckout
     onStoreWatch(changes: IOnStoreChanged[]): void;
     private updateAppliedGiftCards;
     private createAppliedGiftCardElement;
-    private pcInputContainer;
-    private gcInputContainer;
     private inputContainer;
     private createErrorElement;
     protected template(): HTMLElement[];

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

@@ -8,6 +8,7 @@ export declare const customerFormFields: {
     readonly addressTwo: "addressTwo";
     readonly company: "company";
 };
+export type CustomerFieldName = (typeof customerFormFields)[keyof typeof customerFormFields];
 export declare const giftFormFields: {
     readonly firstName: "firstName";
     readonly lastName: "lastName";
@@ -16,6 +17,7 @@ export declare const giftFormFields: {
     readonly addressTwo: "addressTwo";
     readonly message: "message";
 };
+export type GiftFieldName = (typeof giftFormFields)[keyof typeof giftFormFields];
 export declare const billingFormFields: {
     readonly firstName: "firstName";
     readonly lastName: "lastName";
@@ -28,3 +30,4 @@ export declare const billingFormFields: {
     readonly state: "state";
     readonly zipCode: "zipCode";
 };
+export type BillingFieldName = (typeof billingFormFields)[keyof typeof billingFormFields];

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

@@ -7,6 +7,7 @@ import { type AddItemParams } from '@/modules/cart/cart.commands';
 export declare class ProductCommands extends BaseCommand {
     private readonly uiCommands;
     private readonly cartCommands;
+    private readonly checkoutCommands;
     constructor();
     static getInstance(): ProductCommands;
     createProductInstance(productId: string, firstTime?: boolean): Promise<void>;

package/dist/types/modules/product-list/product-list.commands.d.ts

@@ -5,6 +5,7 @@ import { type AddItemParams } from '@/modules/cart/cart.commands';
 export declare class ProductListCommands extends BaseCommand {
     private readonly uiCommands;
     private readonly cartCommands;
+    private readonly checkoutCommands;
     constructor();
     static getInstance(): ProductListCommands;
     getProductList(params: IProductSearchParams): Promise<IProductSearchResponse>;

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

@@ -15,6 +15,7 @@ export declare class EngravingFormComponent extends BaseComponent<IEngravingForm
     private addToCartButton;
     private fulfillmentId;
     private partNumber;
+    private isPresale;
     beforeConnected(): void;
     private calculateTotalPrice;
     private productInformationSection;

package/dist/types/utils/format.d.ts

@@ -1,7 +1,6 @@
 export declare function centToDollar(cent: number): number;
 export declare function formatCentToDollarText(cent: number, showZeroDecimals?: boolean): string;
 export declare function htmlStringToElement(htmlString: string): HTMLElement;
-export declare function format24TimeTo12(time24h: string): string;
 export declare function formatISODateToMMDDYYYY(isoDateString: string | null | undefined): string;
 export declare function capitalizeFirstLetter(text: string): string;
 export declare function splitCategoryPath(catPath?: string): {

package/docs/ACTIONS.md

@@ -26,8 +26,8 @@ await actions.cart.applyPromoCode('SAVE20');
 
 // 2. Listen for success/failure feedback via events
 window.addEventListener('lce:actions.cart_promo_code_applied', function(event) {
-  const { discountAmount, newTotal } = event.detail.data;
-  showSuccessMessage(`🎉 Promo applied! You saved $${discountAmount}!`);
+  const { discount, newTotal } = event.detail.data;
+  showSuccessMessage(`🎉 Promo applied! You saved $${discount}!`);
   updateCartDisplay(newTotal);
 });
 
@@ -262,7 +262,7 @@ 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'     // { discountAmount?: number, newTotal?: number }
+'lce:actions.cart_promo_code_applied'     // { discount?: number, newTotal?: number }
 'lce:actions.cart_promo_code_removed'     // { newTotal?: number }
 'lce:actions.cart_promo_code_failed'      // { error: string }
 ```
@@ -274,7 +274,7 @@ All actions provide feedback through events. Here are all available success/fail
 'lce:actions.checkout_product_add_failed'   // { identifiers: string[], error: string, isPresale?: boolean }
 
 // Promo code management
-'lce:actions.checkout_promo_code_applied'   // { discountAmount?: number, newTotal?: number }
+'lce:actions.checkout_promo_code_applied'   // { discount?: number, newTotal?: number }
 'lce:actions.checkout_promo_code_removed'   // { newTotal?: number }
 'lce:actions.checkout_promo_code_failed'    // { error: string }
 
@@ -335,10 +335,10 @@ window.addEventListener('lce:actions.cart_product_add_success', function(event)
 ```javascript
 // ✅ Create reusable handlers
 const handlePromoSuccess = (event) => {
-  const { discountAmount, newTotal } = event.detail.data;
-  showSuccessMessage(`Discount applied! Saved: $${discountAmount}`);
+  const { discount, newTotal } = event.detail.data;
+  showSuccessMessage(`Discount applied! Saved: $${discount}`);
   updatePriceDisplay(newTotal);
-  trackPromoSuccess(discountAmount);
+  trackPromoSuccess(discount);
 };
 
 const handlePromoFailure = (event) => {
@@ -472,12 +472,12 @@ await actions.cart.applyPromoCode('WELCOME10');
 
 // Listen for success
 window.addEventListener('lce:actions.cart_promo_code_applied', function(event) {
-  const { discountAmount, newTotal } = event.detail.data;
-  showMessage(`Welcome discount applied! You saved $${discountAmount}!`);
+  const { discount, newTotal } = event.detail.data;
+  showMessage(`Welcome discount applied! You saved $${discount}!`);
   updateCartDisplay(newTotal);
 
   // Track successful promo usage
-  analytics.track('Promo Applied', { discount: discountAmount });
+  analytics.track('Promo Applied', { discount: discount });
 });
 
 // Listen for failure and try fallback
@@ -624,12 +624,12 @@ const customer = getCurrentCustomer();
 
 // Set up event listeners first
 window.addEventListener('lce:actions.checkout_promo_code_applied', function(event) {
-  const { discountAmount, newTotal } = event.detail.data;
-  showCheckoutSuccess(`Discount applied! You saved $${discountAmount}`);
+  const { discount, newTotal } = event.detail.data;
+  showCheckoutSuccess(`Discount applied! You saved $${discount}`);
   updateCheckoutTotal(newTotal);
 
   // Track successful conversion optimization
-  analytics.track('Checkout Discount Applied', { discount: discountAmount });
+  analytics.track('Checkout Discount Applied', { discount: discount });
 });
 
 window.addEventListener('lce:actions.checkout_promo_code_failed', function(event) {

package/docs/EVENTS.md

@@ -470,7 +470,7 @@ These events fire when programmatic actions succeed or fail, giving you complete
 
 // Promo code feedback
 'lce:actions.cart_promo_code_applied' // → "Promo code worked - show success!"
-// Data: { discountAmount?: number, newTotal?: number }
+// Data: { discount?: number, newTotal?: number }
 
 'lce:actions.cart_promo_code_removed' // → "Promo code removed successfully"
 // Data: { newTotal?: number }
@@ -490,7 +490,7 @@ These events fire when programmatic actions succeed or fail, giving you complete
 
 // Promo code feedback
 'lce:actions.checkout_promo_code_applied' // → "Checkout discount applied!"
-// Data: { discountAmount?: number, newTotal?: number }
+// Data: { discount?: number, newTotal?: number }
 
 'lce:actions.checkout_promo_code_removed' // → "Checkout discount removed"
 // Data: { newTotal?: number }
@@ -519,11 +519,11 @@ await actions.cart.applyPromoCode('SECRET20');
 
 // Get feedback (secure)
 window.addEventListener('lce:actions.cart_promo_code_applied', function(event) {
-  const { discountAmount, newTotal } = event.detail.data;
+  const { discount, newTotal } = event.detail.data;
   // ✅ You get: discount amount, new total
   // 🚫 You DON'T get: 'SECRET20' (secure!)
 
-  showSuccessMessage(`🎉 Discount applied! You saved $${discountAmount}!`);
+  showSuccessMessage(`🎉 Discount applied! You saved $${discount}!`);
   updateCartTotal(newTotal);
 });
 ```
@@ -539,14 +539,14 @@ async function applyPromoCodeWithFeedback(code) {
   
   // Set up event listeners BEFORE firing action
   const successHandler = (event) => {
-    const { discountAmount, newTotal } = event.detail.data;
+    const { discount, newTotal } = event.detail.data;
     hideLoadingMessage();
-    showSuccessMessage(`🎉 Success! You saved $${discountAmount}!`);
+    showSuccessMessage(`🎉 Success! You saved $${discount}!`);
     updatePriceDisplay(newTotal);
 
     // Track successful promo usage
     analytics.track('Promo Applied', {
-      discount: discountAmount,
+      discount: discount,
       newTotal: newTotal
     });