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

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,47 @@
+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 stripeFormElement;
+    private rootComponent;
+    private isCreatingStripeForm;
+    private saveButton;
+    private errorMessageElement;
+    private stripeFormContainer;
+    private stripeSummaryContainer;
+    private billingFormData;
+    private isValidBillingForm;
+    private isBillingSameAsShipping;
+    private stripeFormStatus;
+    private isSavingPayment;
+    private isInEditMode;
+    private savedCardInfo;
+    private isChangingPayment;
+    get hostClasses(): string[];
+    constructor();
+    onStoreWatch(changes: IOnStoreChanged[]): void;
+    private handleSavingStateChange;
+    private handleBillingSameAsShippingChange;
+    private handleSavedCardChange;
+    private handleEditModeChange;
+    afterRender(): Promise<void>;
+    private setupStripeFormEventListeners;
+    private showStripeSummary;
+    private hideStripeSummary;
+    private showStripeForm;
+    private hideStripeForm;
+    private handleChangePayment;
+    private updateSaveButtonState;
+    private updateErrorMessage;
+    private showError;
+    protected template(): HTMLElement[];
+    private handleSaveButtonClick;
+    private validatePrerequisites;
+    private findRootComponent;
+    private removeExistingStripeForm;
+    private doStripeConfig;
+    private createAndMountStripeForm;
+    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/index.d.ts

@@ -1,20 +1,24 @@
+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-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/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.');
 });
 

package/docs/CONFIGURATION.md

@@ -329,8 +329,16 @@ data-cart-button="below:#main-navigation"  <!-- Place below the target -->
 data-cart-button="below:main-navigation"   <!-- Also works without # prefix -->
 data-cart-button="replace:.old-cart"       <!-- Replace the target -->
 data-cart-button="inside:.header .nav"     <!-- Place inside the target (default) -->
+
+<!-- Floating cart button (no badge) -->
+data-cart-button=""                         <!-- Empty value = floating button -->
 ```
 
+**Smart Fallback Behavior:**
+- If the target element is not found, automatically falls back to floating cart button
+- If attribute is present but empty (`data-cart-button=""`), creates floating cart button without badge
+- Element IDs are automatically prefixed with `#` if needed (e.g., `header-cart` becomes `#header-cart`)
+
 #### `data-cart-badge-button`
 
 **Type:** `string`
@@ -351,8 +359,17 @@ data-cart-badge-button="above:.header .logo"      <!-- Place above the target --
 data-cart-badge-button="below:#main-navigation"  <!-- Place below the target -->
 data-cart-badge-button="replace:.old-cart"       <!-- Replace the target -->
 data-cart-badge-button="inside:.header .nav"     <!-- Place inside the target (default) -->
+
+<!-- Floating cart button with badge (default) -->
+data-cart-badge-button=""                   <!-- Empty value = floating button with badge -->
 ```
 
+**Smart Fallback Behavior:**
+- If the target element is not found, automatically falls back to floating cart button with badge
+- If attribute is present but empty (`data-cart-badge-button=""`), creates floating cart button with badge
+- Element IDs are automatically prefixed with `#` if needed
+- If neither `data-cart-button` nor `data-cart-badge-button` is provided, defaults to floating cart button with badge
+
 **Position Prefixes:**
 - `above:` - Place above the target element
 - `below:` - Place below the target element  
@@ -363,12 +380,14 @@ data-cart-badge-button="inside:.header .nav"     <!-- Place inside the target (d
 
 **Type:** flag (no value)
 
-Hide cart button completely.
+Hide cart button completely. Use this when you want to manage cart display manually via `client.actions.cart.openCart()`.
 
 ```html
 data-cart-button-hidden
 ```
 
+**Important:** When this attribute is present, the SDK will skip all cart button setup, including floating buttons. This takes precedence over `data-cart-button` and `data-cart-badge-button` attributes.
+
 ### Cart Button Examples
 
 **Simple cart button (no badge):**