@liquidcommerce/elements-sdk 2.7.36 → 2.7.38

package/dist/types/core/client/actions/client-checkout-action.service.d.ts

@@ -1,5 +1,5 @@
 import type { ICheckoutDetailsEventData } from '@/core/pubsub/interfaces/checkout.interface';
-import type { IAnonymousCheckoutAddProductParams, IAnonymousCheckoutAddProductResponse } from '@/interfaces/api/checkout.interface';
+import type { IAnonymousCheckoutAddProductParams, IAnonymousCheckoutAddProductResponse, ICheckoutMarketingPreferences } from '@/interfaces/api/checkout.interface';
 import type { IProductAvailabilityResponse } from '@/interfaces/api/product.interface';
 import type { BillingFieldName, CustomerFieldName, GiftFieldName } from '@/modules/checkout/constant';
 import { BaseActionService } from './base-action.service';
@@ -20,6 +20,8 @@ export interface ICheckoutActions {
     exitCheckout: () => void;
     setSavedPaymentMethod: (params: ISavedPaymentMethodInput) => void;
     clearSavedPaymentMethod: () => void;
+    setSavedMarketingPreferences: (preferences: Partial<ICheckoutMarketingPreferences>) => Promise<void>;
+    clearSavedMarketingPreferences: () => void;
     addProduct: (params: IAddProductParams[], openCheckout?: boolean) => Promise<void>;
     applyPromoCode: (promoCode: string) => Promise<void>;
     removePromoCode: () => Promise<void>;
@@ -28,7 +30,9 @@ export interface ICheckoutActions {
     toggleIsGift: (active?: boolean) => Promise<void>;
     toggleBillingSameAsShipping: (active?: boolean) => Promise<void>;
     toggleMarketingPreferences: (field: 'canEmail' | 'canSms', active: boolean) => Promise<void>;
-    updateCustomerInfo: (params: Record<CustomerFieldName, string>) => void;
+    updateCustomerInfo: (params: Record<CustomerFieldName, string>, options?: {
+        saveIfValid?: boolean;
+    }) => Promise<void>;
     updateBillingInfo: (params: Record<BillingFieldName, string>) => void;
     updateGiftInfo: (params: Record<GiftFieldName, string>) => void;
     getDetails: () => ICheckoutDetailsEventData;
@@ -59,6 +63,8 @@ export declare class ClientCheckoutActionService extends BaseActionService {
     private removeGiftCard;
     private toggleIsGift;
     private toggleBillingSameAsShipping;
+    private setSavedMarketingPreferences;
+    private clearSavedMarketingPreferences;
     private toggleMarketingPreferences;
     private updateCustomerInfo;
     private updateBillingInfo;

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

@@ -36,6 +36,7 @@ export interface ICheckoutStore {
     presale: ICheckoutPresale | null;
     isGift: boolean;
     marketingPreferences: ICheckoutMarketingPreferences;
+    appliedSavedMarketingPreferences: Partial<ICheckoutMarketingPreferences>;
     customerForm: ICheckoutCustomerFormStore;
     giftRecipientForm: ICheckoutGiftRecipientFormStore;
     paymentForm: ICheckoutPaymentFormStore;

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

@@ -1,13 +1,23 @@
 import { BaseCommand } from '@/core/command/base-command.service';
 import type { ICheckoutDetailsEventData } from '@/core/pubsub/interfaces/checkout.interface';
 import type { ICheckoutPaymentMethodStore } from '@/core/store/interfaces/checkout.interface';
-import type { ICheckoutBilling, ICheckoutCustomer, ICheckoutGiftRecipient, ICheckoutPrepare } from '@/interfaces/api/checkout.interface';
+import type { ICheckoutBilling, ICheckoutCustomer, ICheckoutGiftRecipient, ICheckoutMarketingPreferences, ICheckoutPrepare } 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 lastLoadParams;
     private paymentGeneration;
+    private savedMarketingPreferences;
+    private savedMarketingRevision;
+    private marketingNeedsPrepare;
+    private completingCheckout;
+    private savedMarketingError;
+    private marketingEdits;
+    private marketingQueue;
+    private readonly marketingFields;
+    private customerEditRevision;
+    private customerEditedGeneration;
     private confirmedPayment;
     assertPaymentReady(): void;
     retryLoadCheckout(): Promise<void>;
@@ -23,6 +33,17 @@ export declare class CheckoutCommands extends BaseCommand {
     loadCheckoutFromResponse(response: ICheckoutPrepare): void;
     toggleIsGift(active?: boolean): Promise<void>;
     toggleBillingSameAsShipping(active?: boolean): Promise<void>;
+    private loadedMarketingState;
+    private defaultMarketingPreferences;
+    private marketingForPrepare;
+    private confirmedSavedMarketing;
+    private queueMarketing;
+    setSavedMarketingPreferences(preferences: Partial<ICheckoutMarketingPreferences>): Promise<void>;
+    clearSavedMarketingPreferences(): void;
+    private recordSavedMarketing;
+    private assertMarketingRestored;
+    private canApplySavedMarketing;
+    private applySavedMarketingPreferences;
     toggleMarketingPreferences(fieldName: 'canEmail' | 'canSms', active?: boolean): Promise<boolean>;
     getPaymentSession(): Promise<void>;
     confirmPaymentSession(confirmationTokenId: string, setupIntentId: string): Promise<ICheckoutPaymentMethodStore>;
@@ -44,6 +65,9 @@ export declare class CheckoutCommands extends BaseCommand {
     updateFulfillmentTip(fulfillmentId: string, tipAmount: number): Promise<void>;
     removeFulfillmentTip(fulfillmentId: string): Promise<void>;
     clearCheckoutError(): Promise<void>;
+    markCustomerFormEdited(): void;
+    canPrefillCustomerForm(): boolean;
+    savePrefilledCustomerInfo(): Promise<void>;
     editCustomerForm(): Promise<void>;
     saveCustomerForm({ shippingAddressTwo, deliveryInstructions, customerData, }: {
         customerData: ICheckoutCustomer;
@@ -65,6 +89,7 @@ export declare class CheckoutCommands extends BaseCommand {
             setupIntentId: string;
         };
     }): Promise<void>;
+    private prepareMarketingForCompletion;
     checkoutComplete(): Promise<void>;
     private updateStoreFromCheckoutResponse;
     private syncFromItemUpdate;

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

@@ -10,6 +10,7 @@ export declare class CheckoutOrderSummaryComponent extends BaseComponent<null, I
     private toggleMarketingPreference;
     private handleEmailToggle;
     private handleSmsToggle;
+    private updateSavedMarketingPrompts;
     private marketingOptInsContainer;
     private hasOnDemandOrder;
     protected template(): HTMLElement[];

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

@@ -7,6 +7,7 @@ export declare class CheckoutPaymentComponent extends BaseComponent<ICheckoutSen
     private stripeHandlerElement;
     private saveButton;
     private errorMessageElement;
+    private walletInstructionsElement?;
     private billingFormData;
     private isValidBillingForm;
     private isBillingSameAsShipping;
@@ -21,6 +22,9 @@ export declare class CheckoutPaymentComponent extends BaseComponent<ICheckoutSen
     private handleBillingSameAsShippingChange;
     afterRender(): Promise<void>;
     private updateSaveButtonState;
+    private getSelectedWallet;
+    private getPaymentButtonText;
+    private updateWalletInstructions;
     private lastAnnouncedPaymentError;
     private updateErrorMessage;
     private showError;

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

@@ -18,6 +18,8 @@ export interface IStripeConfig {
     elementOptions?: Record<string, any>;
 }
 export interface IStripeFormStatus {
+    selectedPaymentType?: string;
+    hasPendingConfirmation?: boolean;
     isFormComplete: boolean;
     isProcessing: boolean;
     hasCompletedPayment: boolean;
@@ -31,6 +33,7 @@ export declare class CheckoutStripeFormComponent extends SafeHTMLElement {
     private _stripeElements;
     private _paymentElement;
     private _isProcessing;
+    private _selectedPaymentType;
     private _isFormComplete;
     private _hasUsedCurrentSession;
     private _pendingConfirmation;

package/dist/types/modules/checkout/customer-prefill.d.ts

@@ -0,0 +1,2 @@
+import type { ICheckoutCustomer } from '@/interfaces/api/checkout.interface';
+export declare function isValidCustomerPrefill(customer: ICheckoutCustomer, today?: Date): boolean;

package/dist/types/modules/product/components/product-retailers-popup.component.d.ts

@@ -7,5 +7,6 @@ export declare class ProductRetailersPopupComponent extends BaseComponent<IProdu
     get hostClasses(): string[];
     constructor();
     private getProductId;
+    private get fulfillmentLabelId();
     protected template(): HTMLElement[];
 }

package/docs/v1/api/actions/checkout-actions.md

@@ -264,7 +264,7 @@ await window.LiquidCommerce.elements.actions.checkout.toggleMarketingPreferences
 ### actions.checkout.updateCustomerInfo()
 
 ```typescript
-updateCustomerInfo(params: Record<CustomerFieldName, string>): void
+updateCustomerInfo(params: Record<CustomerFieldName, string>, options?: { saveIfValid?: boolean }): Promise<void>
 ```
 
 Pre-fill customer information.
@@ -525,3 +525,60 @@ Key events:
 - [Checkout Component Guide](../../guides/checkout-component.md)
 - [Checkout Events](../../guides/events.md#checkout-events)
 - [Cart Actions](./cart-actions.md)
+
+### Preparing complete account delivery details
+
+After `lce:actions.checkout_loaded`, call
+`await elements.actions.checkout.updateCustomerInfo(fields, { saveIfValid: true })`
+to validate and prepare complete account details, then show their editable summary.
+Supply names, email, a US phone number, and a real `birthDate` in `MM/DD/YYYY` format
+(age 21+, year 1930 or later). A shipping street must already be selected.
+Omitted apartment and delivery instructions retain their existing checkout values.
+Partial or invalid details stay in the form; backend validation failures reject the
+promise, show the checkout error, and keep details editable. The host should handle that rejection.
+
+The option skips gifts, saved forms, in-flight saves, and customer forms the shopper
+has edited during the current checkout. It does not overwrite those forms. Edits or
+address/checkout changes during preparation prevent a stale response from closing
+the form. Without the option, this action only prefills fields, as before.
+
+Apple Pay and Google Pay selection displays **Continue with Apple Pay** or
+**Continue with Google Pay**. This opens the wallet to save a payment method; the
+shopper still reviews and places the order afterward. It is not express checkout.
+
+After wallet cancellation, the same Continue action remains available. If authorization
+succeeded but saving the method failed, **Retry saving Apple Pay/Google Pay** reuses
+the existing authorization rather than opening the wallet again.
+
+### Saved account marketing preferences
+
+```ts
+setSavedMarketingPreferences(preferences: { canEmail?: boolean; canSms?: boolean }): Promise<void>
+clearSavedMarketingPreferences(): void
+```
+
+Call `actions.checkout.setSavedMarketingPreferences()` with known recorded account
+choices, including `false`, before checkout loads. Only boolean values are used;
+missing/null/unrecognized values remain unknown. The first checkout prepare uses
+saved values instead of tenant defaults. Each channel's prompt is hidden only
+after the server confirms that saved choice. Unknown channels retain their normal
+checkout prompts. The actions are available in both full and checkout-only clients.
+
+Calling the setter during an active checkout prepares untouched channels and
+preserves shopper checkbox edits. Backend failure rejects the promise, displays
+an error, and leaves prompts available; the host should catch the rejection.
+The same call can retry. Applying values does not call a subscription service.
+It supplies the account's recorded choices to this checkout.
+
+Saved choices persist across cart resets in the same SDK session. Call
+`clearSavedMarketingPreferences()` on sign-out, account change, and host cleanup.
+Clearing reveals the prompts and restores configured guest defaults. It invalidates
+stale responses while draining outstanding preference requests; checkout completion
+prepares the current choices before submitting the checkout token. A load already
+in progress still finishes and reconciles the current account's values. Bind a new
+account only to its own checkout; the host remains responsible for account/cart
+ownership and for reloading checkout when identity changes.
+
+Order completion waits for queued preference work. It cannot race a late saved
+opt-out or proceed with an unconfirmed saved choice. If applying a known choice
+fails, the shopper can retry or explicitly choose the visible channel preference.

package/docs/v1/api/typescript-types.md

@@ -422,3 +422,60 @@ type DeepPartial<T> = {
 - [Client API](./client.md) - Client initialization and usage
 - [Configuration Reference](./configuration.md) - Detailed config options
 - [Injection Methods](./injection-methods.md) - Component injection API
+
+### Preparing complete account delivery details
+
+After `lce:actions.checkout_loaded`, call
+`await elements.actions.checkout.updateCustomerInfo(fields, { saveIfValid: true })`
+to validate and prepare complete account details, then show their editable summary.
+Supply names, email, a US phone number, and a real `birthDate` in `MM/DD/YYYY` format
+(age 21+, year 1930 or later). A shipping street must already be selected.
+Omitted apartment and delivery instructions retain their existing checkout values.
+Partial or invalid details stay in the form; backend validation failures reject the
+promise, show the checkout error, and keep details editable. The host should handle that rejection.
+
+The option skips gifts, saved forms, in-flight saves, and customer forms the shopper
+has edited during the current checkout. It does not overwrite those forms. Edits or
+address/checkout changes during preparation prevent a stale response from closing
+the form. Without the option, this action only prefills fields, as before.
+
+Apple Pay and Google Pay selection displays **Continue with Apple Pay** or
+**Continue with Google Pay**. This opens the wallet to save a payment method; the
+shopper still reviews and places the order afterward. It is not express checkout.
+
+After wallet cancellation, the same Continue action remains available. If authorization
+succeeded but saving the method failed, **Retry saving Apple Pay/Google Pay** reuses
+the existing authorization rather than opening the wallet again.
+
+### Saved account marketing preferences
+
+```ts
+setSavedMarketingPreferences(preferences: { canEmail?: boolean; canSms?: boolean }): Promise<void>
+clearSavedMarketingPreferences(): void
+```
+
+Call `actions.checkout.setSavedMarketingPreferences()` with known recorded account
+choices, including `false`, before checkout loads. Only boolean values are used;
+missing/null/unrecognized values remain unknown. The first checkout prepare uses
+saved values instead of tenant defaults. Each channel's prompt is hidden only
+after the server confirms that saved choice. Unknown channels retain their normal
+checkout prompts. The actions are available in both full and checkout-only clients.
+
+Calling the setter during an active checkout prepares untouched channels and
+preserves shopper checkbox edits. Backend failure rejects the promise, displays
+an error, and leaves prompts available; the host should catch the rejection.
+The same call can retry. Applying values does not call a subscription service.
+It supplies the account's recorded choices to this checkout.
+
+Saved choices persist across cart resets in the same SDK session. Call
+`clearSavedMarketingPreferences()` on sign-out, account change, and host cleanup.
+Clearing reveals the prompts and restores configured guest defaults. It invalidates
+stale responses while draining outstanding preference requests; checkout completion
+prepares the current choices before submitting the checkout token. A load already
+in progress still finishes and reconciles the current account's values. Bind a new
+account only to its own checkout; the host remains responsible for account/cart
+ownership and for reloading checkout when identity changes.
+
+Order completion waits for queued preference work. It cannot race a late saved
+opt-out or proceed with an unconfirmed saved choice. If applying a known choice
+fails, the shopper can retry or explicitly choose the visible channel preference.

package/docs/v1/guides/accessibility.md

@@ -146,14 +146,14 @@ on render, and a live region recreated with its text already in place is not ann
 
 ### Headings
 
-The product element emits a level-1 title with its sections (`Size`, `About this product:`) at
-level 2, and an overlay supplies its own heading at the top of its content, because the page behind
-it is out of the accessibility tree while it is open.
+The product element emits a level-1 title, and every section caption below it sits at level 2 —
+`Size`, `Delivers to:`, `Shipping From:` and `About this product:` — so the whole element is
+reachable by heading navigation with no level skipped. An overlay supplies its own heading at the
+top of its content, because the page behind it is out of the accessibility tree while it is open.
 
-Captions that label a single value — the `Delivers to:` and `Shipping From:` lines — are **not**
-headings, so they do not turn up in a heading list as headings that head nothing. `Shipping From:`
-names the card it captions with `aria-labelledby`; `Delivers to:` is hidden from assistive
-technology because the control beside it already announces the address.
+A caption can do both jobs at once: `Shipping From:` is a heading *and* names the retailer card
+beneath it through `aria-labelledby`. Heading ids are scoped to the product, so each product
+element on a page labels its own sections.
 
 The checkout element has its own outline and is not covered by the above. Where any element's
 top-level heading sits in **your** page's outline is yours to place.
@@ -229,3 +229,20 @@ for (const region of document.querySelectorAll('[data-lce-live-region]')) {
 Checkout announces loading or initialization failure in a status region. If initialization fails, payment fields are withheld and a keyboard-operable **Retry checkout** button retries the same checkout. The button is disabled while loading.
 
 Save Payment Information remains disabled until checkout initializes. During payment save it stays busy until the server responds. Recoverable billing/prepare errors are announced while the mounted card fields and billing input remain available for correction and retry.
+
+### Wallet payment actions
+
+The payment action's accessible name matches its visible label, including the
+selected Apple Pay or Google Pay wallet and retry/processing states. Adjacent
+instructions explain whether the action opens the wallet or retries saving already
+authorized details. These actions save the payment method; order placement is a
+separate step.
+
+### Recorded marketing choices
+
+Checkout suppresses each email/SMS consent checkbox only after the corresponding
+recorded account choice is confirmed. Suppressed controls are hidden visually and
+from the accessibility tree; unknown choices retain their named, keyboard-operable
+checkboxes. Clearing account preferences reveals the controls and synchronizes
+`aria-checked` with the current guest defaults. A shopper's explicit checkbox edit
+keeps that channel visible when account data arrives later.

package/docs/v1/guides/checkout-component.md

@@ -668,3 +668,60 @@ checkout: {
 - [Actions API](../api/actions/checkout-actions.md) - Checkout actions reference
 - [Events](./events.md) - All available events
 - [Theming](./theming.md) - Customize appearance
+
+### Preparing complete account delivery details
+
+After `lce:actions.checkout_loaded`, call
+`await elements.actions.checkout.updateCustomerInfo(fields, { saveIfValid: true })`
+to validate and prepare complete account details, then show their editable summary.
+Supply names, email, a US phone number, and a real `birthDate` in `MM/DD/YYYY` format
+(age 21+, year 1930 or later). A shipping street must already be selected.
+Omitted apartment and delivery instructions retain their existing checkout values.
+Partial or invalid details stay in the form; backend validation failures reject the
+promise, show the checkout error, and keep details editable. The host should handle that rejection.
+
+The option skips gifts, saved forms, in-flight saves, and customer forms the shopper
+has edited during the current checkout. It does not overwrite those forms. Edits or
+address/checkout changes during preparation prevent a stale response from closing
+the form. Without the option, this action only prefills fields, as before.
+
+Apple Pay and Google Pay selection displays **Continue with Apple Pay** or
+**Continue with Google Pay**. This opens the wallet to save a payment method; the
+shopper still reviews and places the order afterward. It is not express checkout.
+
+After wallet cancellation, the same Continue action remains available. If authorization
+succeeded but saving the method failed, **Retry saving Apple Pay/Google Pay** reuses
+the existing authorization rather than opening the wallet again.
+
+### Saved account marketing preferences
+
+```ts
+setSavedMarketingPreferences(preferences: { canEmail?: boolean; canSms?: boolean }): Promise<void>
+clearSavedMarketingPreferences(): void
+```
+
+Call `actions.checkout.setSavedMarketingPreferences()` with known recorded account
+choices, including `false`, before checkout loads. Only boolean values are used;
+missing/null/unrecognized values remain unknown. The first checkout prepare uses
+saved values instead of tenant defaults. Each channel's prompt is hidden only
+after the server confirms that saved choice. Unknown channels retain their normal
+checkout prompts. The actions are available in both full and checkout-only clients.
+
+Calling the setter during an active checkout prepares untouched channels and
+preserves shopper checkbox edits. Backend failure rejects the promise, displays
+an error, and leaves prompts available; the host should catch the rejection.
+The same call can retry. Applying values does not call a subscription service.
+It supplies the account's recorded choices to this checkout.
+
+Saved choices persist across cart resets in the same SDK session. Call
+`clearSavedMarketingPreferences()` on sign-out, account change, and host cleanup.
+Clearing reveals the prompts and restores configured guest defaults. It invalidates
+stale responses while draining outstanding preference requests; checkout completion
+prepares the current choices before submitting the checkout token. A load already
+in progress still finishes and reconciles the current account's values. Bind a new
+account only to its own checkout; the host remains responsible for account/cart
+ownership and for reloading checkout when identity changes.
+
+Order completion waits for queued preference work. It cannot race a late saved
+opt-out or proceed with an unconfirmed saved choice. If applying a known choice
+fails, the shopper can retry or explicitly choose the visible channel preference.

package/package.json

@@ -3,7 +3,7 @@
   "description": "LiquidCommerce Elements SDK",
   "license": "UNLICENSED",
   "author": "LiquidCommerce Team",
-  "version": "2.7.36",
+  "version": "2.7.38",
   "homepage": "https://docs.liquidcommerce.co/elements-sdk",
   "repository": {
     "type": "git",
@@ -109,10 +109,10 @@
     "theming"
   ],
   "devDependencies": {
-    "@biomejs/biome": "^2.5.11",
-    "@commitlint/cli": "^21.2.2",
-    "@commitlint/config-conventional": "^21.2.2",
-    "@playwright/test": "1.60.0",
+    "@biomejs/biome": "^2.5.14",
+    "@commitlint/cli": "^21.2.3",
+    "@commitlint/config-conventional": "^21.2.3",
+    "@playwright/test": "1.63.0",
     "@rollup/plugin-alias": "^6.0.0",
     "@rollup/plugin-commonjs": "^29.0.3",
     "@rollup/plugin-json": "^6.1.0",
@@ -126,18 +126,18 @@
     "@semantic-release/npm": "^13.1.5",
     "@semantic-release/release-notes-generator": "^14.1.1",
     "@types/core-js": "^2.5.8",
-    "@types/node": "^26.4.0",
+    "@types/node": "^26.6.2",
     "conventional-changelog": "8.1.3",
     "husky": "^9.1.7",
-    "jsdom": "26.1.0",
+    "jsdom": "30.1.0",
     "process": "^0.11.10",
-    "rollup": "^4.63.1",
+    "rollup": "^4.63.4",
     "rollup-obfuscator": "^4.1.1",
     "rollup-plugin-typescript2": "^0.37.0",
     "semantic-release": "^25.0.9",
     "ts-node": "^10.9.2",
     "typescript": "6.0.3",
-    "vitest": "2.1.9"
+    "vitest": "5.0.1"
   },
   "engines": {
     "node": ">=22"