@liquidcommerce/elements-sdk 2.6.0-beta.129 → 2.6.0-beta.130

package/dist/ssr-stub.esm.js

@@ -115,6 +115,7 @@ const ELEMENTS_ACTIONS_EVENT = {
     CART_PRODUCT_ADD_FAILED: 'cart_product_add_failed',
     INTERNAL_CART_TO_CHECKOUT: 'internal_cart_to_checkout',
     CHECKOUT_LOADED: 'checkout_loaded',
+    CHECKOUT_DELIVERY_SELECTION_UPDATED: 'checkout_delivery_selection_updated',
     CHECKOUT_OPENED: 'checkout_opened',
     CHECKOUT_CLOSED: 'checkout_closed',
     CHECKOUT_FAILED: 'checkout_failed',
@@ -216,6 +217,7 @@ const COMPONENT_TYPE = {
     CHECKOUT_BUYER: 'checkout-buyer',
     CHECKOUT_BUYER_SUMMARY: 'checkout-buyer-summary',
     CHECKOUT_TIPS: 'checkout-tips',
+    CHECKOUT_DELIVERY_SCHEDULING: 'checkout-delivery-scheduling',
     CHECKOUT_PC_GC: 'checkout-pc-gc',
     CHECKOUT_ITEM: 'checkout-item',
     CHECKOUT_ITEM_QUANTITY: 'checkout-item-quantity',

package/dist/types/core/a11y/focus-manager.service.d.ts

@@ -1,5 +1,5 @@
 export declare const A11Y_PERSIST_ATTRIBUTE = "data-lce-a11y-persist";
-export type FocusScope = 'drawer' | 'product-drawer';
+export type FocusScope = 'drawer' | 'product-drawer' | 'delivery-scheduling';
 export declare class FocusManagerService {
     private readonly triggerStacks;
     private hiddenBackground;

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

@@ -1,5 +1,6 @@
 import type { ICheckoutDetailsEventData } from '@/core/pubsub/interfaces/checkout.interface';
 import type { IAnonymousCheckoutAddProductParams, IAnonymousCheckoutAddProductResponse, ICheckoutMarketingPreferences } from '@/interfaces/api/checkout.interface';
+import type { DeliverySlot } from '@/interfaces/api/delivery.interface';
 import type { IProductAvailabilityResponse } from '@/interfaces/api/product.interface';
 import type { BillingFieldName, CustomerFieldName, GiftFieldName } from '@/modules/checkout/constant';
 import { BaseActionService } from './base-action.service';
@@ -35,6 +36,8 @@ export interface ICheckoutActions {
     }) => Promise<void>;
     updateBillingInfo: (params: Record<BillingFieldName, string>) => void;
     updateGiftInfo: (params: Record<GiftFieldName, string>) => void;
+    loadDeliverySlots: (fulfillmentId: string) => Promise<DeliverySlot[]>;
+    chooseDeliverySlot: (fulfillmentId: string, slotId: string | null) => Promise<void>;
     getDetails: () => ICheckoutDetailsEventData;
     getProductAvailabilityByState: (identifiers: string[], state?: string) => Promise<IProductAvailabilityResponse>;
     addAnonymousProduct: (params: IAnonymousCheckoutAddProductParams) => Promise<IAnonymousCheckoutAddProductResponse>;
@@ -70,6 +73,8 @@ export declare class ClientCheckoutActionService extends BaseActionService {
     private updateCustomerInfo;
     private updateBillingInfo;
     private updateGiftInfo;
+    private loadDeliverySlots;
+    private chooseDeliverySlot;
     private getDetails;
     private addAnonymousProduct;
     private getProductAvailabilityByState;

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

@@ -1,4 +1,5 @@
 import type { ICheckoutAmounts, ICheckoutItem } from '@/interfaces/api/checkout.interface';
+import type { CheckoutDeliveryScheduling } from '@/interfaces/api/delivery.interface';
 export interface IBaseCheckoutEventData {
     token: string;
     cartId: string;
@@ -12,6 +13,7 @@ export interface IBaseCheckoutEventData {
     hasGiftCards: boolean;
     amounts: ICheckoutAmounts;
     itemCount: number;
+    deliveryScheduling: Record<string, CheckoutDeliveryScheduling>;
     items: Record<string, ICheckoutItem>;
 }
 export interface ICheckoutLoadedEventData extends IBaseCheckoutEventData {

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

@@ -1,6 +1,6 @@
 import type { IAddressActionEventData, IAddressFailedEventData } from '@/core/pubsub/interfaces/address.interface';
 import type { ICartFailedEventData, ICartItemAddedEventData, ICartItemEngravingUpdatedEventData, ICartItemQuantityChangedEventData, ICartItemRemovedEventData, ICartLoadedEventData, ICartProductAddEventData, ICartProductAddFailedEventData, ICartPromoCodeEventData, ICartPromoCodeFailedEventData, ICartShopRetailerEventData, ICartUpdatedEventData } from '@/core/pubsub/interfaces/cart.interface';
-import type { ICheckoutBillingInformationUpdatedEventData, ICheckoutCustomerInformationUpdatedEventData, ICheckoutDeliveryMethodUpdatedEventData, ICheckoutExpressCheckoutAvailabilityEventData, ICheckoutExpressCheckoutStartedEventData, ICheckoutFailedEventData, ICheckoutGiftCardEventData, ICheckoutGiftCardFailedEventData, ICheckoutGiftInformationUpdatedEventData, ICheckoutItemEngravingUpdatedEventData, ICheckoutItemQuantityChangedEventData, ICheckoutItemRemovedEventData, ICheckoutLoadedEventData, ICheckoutMarketingPreferencesToggleEventData, ICheckoutPaymentFormFailedEventData, ICheckoutProductAddEventData, ICheckoutProductAddFailedEventData, ICheckoutPromoCodeEventData, ICheckoutPromoCodeFailedEventData, ICheckoutSubmitCompletedEventData, ICheckoutSubmitFailedEventData, ICheckoutSubmitStartedEventData, ICheckoutTipUpdatedEventData, ICheckoutToggleEventData } from '@/core/pubsub/interfaces/checkout.interface';
+import type { ICheckoutBillingInformationUpdatedEventData, ICheckoutCustomerInformationUpdatedEventData, ICheckoutDeliveryMethodUpdatedEventData, ICheckoutDetailsEventData, ICheckoutExpressCheckoutAvailabilityEventData, ICheckoutExpressCheckoutStartedEventData, ICheckoutFailedEventData, ICheckoutGiftCardEventData, ICheckoutGiftCardFailedEventData, ICheckoutGiftInformationUpdatedEventData, ICheckoutItemEngravingUpdatedEventData, ICheckoutItemQuantityChangedEventData, ICheckoutItemRemovedEventData, ICheckoutLoadedEventData, ICheckoutMarketingPreferencesToggleEventData, ICheckoutPaymentFormFailedEventData, ICheckoutProductAddEventData, ICheckoutProductAddFailedEventData, ICheckoutPromoCodeEventData, ICheckoutPromoCodeFailedEventData, ICheckoutSubmitCompletedEventData, ICheckoutSubmitFailedEventData, ICheckoutSubmitStartedEventData, ICheckoutTipUpdatedEventData, ICheckoutToggleEventData } from '@/core/pubsub/interfaces/checkout.interface';
 import type { IProductAddToCartEventData, IProductFulfillmentChangedEventData, IProductFulfillmentTypeChangedEventData, IProductLoadedEventData, IProductQuantityChangedEventData, IProductSizeChangedEventData } from '@/core/pubsub/interfaces/product.interface';
 import { ELEMENTS_ACTIONS_EVENT } from '@/enums';
 export interface IElementsClientIsReadyEventData {
@@ -58,6 +58,7 @@ export interface IElementsActionsEventsMap {
     [ELEMENTS_ACTIONS_EVENT.CHECKOUT_OPENED]: boolean;
     [ELEMENTS_ACTIONS_EVENT.CHECKOUT_CLOSED]: boolean;
     [ELEMENTS_ACTIONS_EVENT.CHECKOUT_LOADED]: ICheckoutLoadedEventData;
+    [ELEMENTS_ACTIONS_EVENT.CHECKOUT_DELIVERY_SELECTION_UPDATED]: ICheckoutDetailsEventData;
     [ELEMENTS_ACTIONS_EVENT.CHECKOUT_FAILED]: ICheckoutFailedEventData;
     [ELEMENTS_ACTIONS_EVENT.CHECKOUT_IS_GIFT_TOGGLED]: ICheckoutToggleEventData;
     [ELEMENTS_ACTIONS_EVENT.CHECKOUT_BILLING_SAME_AS_SHIPPING_TOGGLED]: ICheckoutToggleEventData;

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

@@ -1,4 +1,5 @@
 import type { ICheckoutAmounts, ICheckoutBilling, ICheckoutCustomer, ICheckoutEvent, ICheckoutFulfillment, ICheckoutFulfillmentMethod, ICheckoutGiftCard, ICheckoutGiftRecipient, ICheckoutItem, ICheckoutMarketingPreferences, ICheckoutPaymentConfirm, ICheckoutPaymentSession, ICheckoutPresale, ICheckoutPromoCode, ICheckoutRetailer, ICheckoutShippingAddress } from '@/interfaces/api/checkout.interface';
+export type DeliveryWindowLapse = 'expired' | 'unavailable';
 export interface ICheckoutItemStore extends ICheckoutItem {
     loading: boolean;
     updating: boolean;
@@ -64,6 +65,8 @@ export interface ICheckoutStore {
     itemsQuantity: number;
     items: Record<string, ICheckoutItemStore>;
     fulfillments: Record<string, ICheckoutFulfillment>;
+    deliveryWindowLapses: Record<string, DeliveryWindowLapse>;
+    deliveryScheduleNotice: string | null;
     retailers: Record<string, ICheckoutRetailer>;
     amounts: ICheckoutAmounts;
     orderNumber: string | null;

package/dist/types/enums/core.enum.d.ts

@@ -34,6 +34,7 @@ export declare const ELEMENTS_ACTIONS_EVENT: {
     readonly CART_PRODUCT_ADD_FAILED: "cart_product_add_failed";
     readonly INTERNAL_CART_TO_CHECKOUT: "internal_cart_to_checkout";
     readonly CHECKOUT_LOADED: "checkout_loaded";
+    readonly CHECKOUT_DELIVERY_SELECTION_UPDATED: "checkout_delivery_selection_updated";
     readonly CHECKOUT_OPENED: "checkout_opened";
     readonly CHECKOUT_CLOSED: "checkout_closed";
     readonly CHECKOUT_FAILED: "checkout_failed";
@@ -135,6 +136,7 @@ export declare const COMPONENT_TYPE: {
     readonly CHECKOUT_BUYER: "checkout-buyer";
     readonly CHECKOUT_BUYER_SUMMARY: "checkout-buyer-summary";
     readonly CHECKOUT_TIPS: "checkout-tips";
+    readonly CHECKOUT_DELIVERY_SCHEDULING: "checkout-delivery-scheduling";
     readonly CHECKOUT_PC_GC: "checkout-pc-gc";
     readonly CHECKOUT_ITEM: "checkout-item";
     readonly CHECKOUT_ITEM_QUANTITY: "checkout-item-quantity";

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

@@ -6,5 +6,6 @@ import type { IAnalyticsActions, IElementsCheckoutActions, IElementsCheckoutClie
 import type { IInjectedComponent } from '@/interfaces/component.interface';
 import type { ILiquidCommerceElementsCheckoutClientConfig } from '@/interfaces/config.interface';
 import type { IInjectCheckoutParams, IInjectExpressCheckoutParams } from '@/interfaces/injection.interface';
+export type { CheckoutDeliveryScheduling, CheckoutDeliverySelection, DeliveryAvailability, DeliverySlot, } from './interfaces/api/delivery.interface';
 export type { DebugMode, ElementsEnv, IAnalyticsActions, IAnalyticsAddress, IAnalyticsAddressFailure, IAnalyticsAvailability, IAnalyticsFulfillmentAvailability, IAnalyticsItem, IAnalyticsItemList, IElementsCheckoutActions, IElementsCheckoutClient, IInjectCheckoutParams, IInjectExpressCheckoutParams, IInjectedComponent, ILiquidCommerceElementsCheckoutClientConfig, };
 export { DEBUG_MODE, ELEMENTS_ENV, ElementsCheckout };

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

@@ -1,6 +1,7 @@
 import type { CheckoutEventLevel, CheckoutEventType, FulfillmentType } from '@/enums';
 import type { IAddressAddress, IAddressCoordinates, ILocation } from '@/interfaces/api/address.interface';
 import type { ICart, ICartUpdateItem } from '@/interfaces/api/cart.interface';
+import type { CheckoutDeliveryScheduling, CheckoutDeliverySelection } from '@/interfaces/api/delivery.interface';
 import type { IProductPresale } from '@/interfaces/api/product.interface';
 export interface ICheckoutComplete {
     orderNumber: string;
@@ -80,6 +81,8 @@ export interface ICheckoutPrepareParams {
     giftOptions?: ICheckoutGiftRecipient;
     marketingPreferences?: ICheckoutMarketingPreferences;
     deliveryTips?: ICheckoutDeliveryTip[];
+    deliverySelections?: CheckoutDeliverySelection[];
+    deliverySlotsFulfillmentId?: string;
     deliveryInstructions?: ICheckoutDeliveryInstructions[];
     payment?: string;
     promoCode?: string;
@@ -135,7 +138,7 @@ export interface ICheckoutFulfillmentMethod {
     retailerId: string;
     reason: CheckoutFulfillmentUnavailableReason | null;
 }
-export type ICheckoutFulfillmentCarryOver = Omit<ICheckoutPrepareParams, 'cartId' | 'token' | 'deliveryTips' | 'deliveryInstructions'>;
+export type ICheckoutFulfillmentCarryOver = Omit<ICheckoutPrepareParams, 'cartId' | 'token' | 'deliveryTips' | 'deliveryInstructions' | 'deliverySelections' | 'deliverySlotsFulfillmentId'>;
 export interface ICheckoutFulfillmentParams {
     cartId: string;
     location: ILocation;
@@ -223,6 +226,7 @@ export interface ICheckoutItem {
     attributes: ICheckoutItemAttributes;
 }
 export interface ICheckoutFulfillment {
+    deliveryScheduling?: CheckoutDeliveryScheduling;
     id: string;
     deliveryInstructions: string;
     type: FulfillmentType;

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

@@ -0,0 +1,24 @@
+export interface DeliverySlot {
+    id: string;
+    start: string;
+    end: string;
+    cutoff: string;
+}
+export interface DeliveryAvailability {
+    status: 'available' | 'unavailable';
+    canDeliverNow: boolean;
+    canSchedule: boolean;
+    timezone: string | null;
+    nextSlot: DeliverySlot | null;
+    checkedAt: string;
+}
+export interface CheckoutDeliveryScheduling {
+    availability: DeliveryAvailability;
+    slots: DeliverySlot[];
+    selectedSlotId: string | null;
+    selectedSlot?: DeliverySlot | null;
+}
+export interface CheckoutDeliverySelection {
+    fulfillmentId: string;
+    slotId: string | null;
+}

package/dist/types/interfaces/api/index.d.ts

@@ -1,5 +1,6 @@
 export * from './address.interface';
 export * from './cart.interface';
 export * from './checkout.interface';
+export * from './delivery.interface';
 export * from './product.interface';
 export * from './product-list.interface';

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

@@ -3,6 +3,7 @@ import type { ICheckoutDetailsEventData } from '@/core/pubsub/interfaces/checkou
 import type { ICheckoutPaymentMethodStore } from '@/core/store/interfaces/checkout.interface';
 import type { FulfillmentType } from '@/enums';
 import type { CheckoutPaymentSessionType, ICheckoutBilling, ICheckoutCustomer, ICheckoutGiftRecipient, ICheckoutMarketingPreferences, ICheckoutPaymentSession, ICheckoutPrepare } from '@/interfaces/api/checkout.interface';
+import type { DeliverySlot } from '@/interfaces/api/delivery.interface';
 import type { AddItemParams } from '@/modules/cart/cart.commands';
 import type { PresaleExpiredReason } from '@/modules/checkout/components';
 import { type IExpressWalletBillingDetails } from '@/modules/checkout/express-wallet';
@@ -22,9 +23,31 @@ export declare class CheckoutCommands extends BaseCommand {
     private customerEditRevision;
     private customerEditedGeneration;
     private confirmedPayment;
+    private offeredDeliverySlots;
+    private offeredDeliveryAddress;
+    private savingDeliverySelection;
     private expressHandoff;
     private get requiresBirthDate();
     assertPaymentReady(): void;
+    private assertDeliveryScheduleReady;
+    private lapsedDeliveryWindowIds;
+    private clearLapsedDeliveryWindows;
+    private offeredSlots;
+    private findOfferedDeliverySlot;
+    loadDeliverySlots(fulfillmentId: string): Promise<DeliverySlot[]>;
+    chooseDeliverySlot(fulfillmentId: string, slotId: string | null): Promise<void>;
+    private completionError;
+    private dropDeliveryScheduling;
+    private forgetDeliveryWindow;
+    private assertDeliverySlotChoosable;
+    private responseFulfillments;
+    private findResponseFulfillment;
+    private withDeliverySlotDetails;
+    private responseFulfillmentIds;
+    private expiredDeliveryMarksWith;
+    private pruneExpiredDeliveryWindows;
+    private expireDeliveryWindows;
+    private prepareWithWindowRecovery;
     retryLoadCheckout(): Promise<void>;
     private paymentSessionRequest;
     constructor();

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

@@ -1,5 +1,6 @@
 import { BaseComponent } from '@/core/base-component.service';
 import type { ICheckoutComponent } from '@/interfaces/configs';
+import type { PlacedDeliveryWindow } from '@/utils/delivery-scheduling';
 export interface ICheckoutCompletedComponentParams {
     orderNumber: string;
     orderTotal: number;
@@ -9,6 +10,7 @@ export interface ICheckoutCompletedComponentParams {
     checkoutToken?: string;
     cartId?: string;
     isCompleted?: boolean;
+    deliveryWindows?: PlacedDeliveryWindow[];
 }
 export declare class CheckoutCompletedComponent extends BaseComponent<ICheckoutCompletedComponentParams, ICheckoutComponent> {
     get hostClasses(): string[];

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

@@ -0,0 +1,51 @@
+import { BaseComponent } from '@/core/base-component.service';
+import type { ICheckoutComponent } from '@/interfaces/configs';
+export declare class CheckoutDeliverySchedulingComponent extends BaseComponent<null, ICheckoutComponent> {
+    private draft;
+    private dialog;
+    private paintScheduled;
+    private error;
+    private pendingFocus;
+    private restoreTrigger;
+    private releaseFocusTrap;
+    private readonly focusManager;
+    private handledExpired;
+    private loadToken;
+    private announcedNotice;
+    private timesScroll;
+    constructor();
+    private get busy();
+    private get expiredIds();
+    protected afterRender(): void;
+    protected onStoreChanged(): boolean;
+    private update;
+    private paint;
+    private showDialog;
+    private settle;
+    private keepTimeInView;
+    protected disconnected(): void;
+    private endPicker;
+    private draftFulfillment;
+    private openForNewlyExpired;
+    private dayKey;
+    private todayKey;
+    private draftScheduling;
+    private openPicker;
+    private loadSlots;
+    private whenIdle;
+    private closePicker;
+    private saveDraft;
+    private createGroup;
+    private get schedulingAllowed();
+    private summaryText;
+    private radio;
+    private createDates;
+    private createTimes;
+    private createNotice;
+    private createLoading;
+    private createDialogShell;
+    private fillDialog;
+    private captureViewState;
+    private createRows;
+    protected template(): HTMLElement[];
+}

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

@@ -20,6 +20,7 @@ export declare class CheckoutExpressCheckoutComponent extends BaseComponent<IChe
     private hasAvailableWallets;
     private availableWallets;
     private hasSettledAvailability;
+    private scheduleReadyAtMount;
     private lastPublishedAvailability;
     get hostClasses(): string[];
     constructor();
@@ -28,6 +29,7 @@ export declare class CheckoutExpressCheckoutComponent extends BaseComponent<IChe
     private get isCompletingExpress();
     private get isButtonsOnly();
     private get isReadyForPayment();
+    private get isDeliveryScheduleReady();
     private get isGiftOrder();
     protected template(): HTMLElement[];
     protected afterRender(): void;

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

@@ -7,6 +7,8 @@ export declare class CheckoutItemComponent extends BaseComponent<ICheckoutItemCo
     get hostClasses(): string[];
     constructor();
     onStoreChanged(changes: IOnStoreChanged[]): boolean | undefined;
+    private deliveryExpectation;
+    private updateDeliveryExpectation;
     private updateEngravingElement;
     private setupMinimumPurchaseAlert;
     private updateTrashButtonState;

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

@@ -18,6 +18,8 @@ export declare class CheckoutPaymentComponent extends BaseComponent<ICheckoutSen
     get hostClasses(): string[];
     constructor();
     private getInjectedPaymentMethod;
+    private scheduleReady;
+    private deliveryPaymentReady;
     onStoreWatch(changes: IOnStoreChanged[]): void;
     private handleBillingSameAsShippingChange;
     afterRender(): Promise<void>;

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

@@ -6,6 +6,7 @@ export * from './checkout-completed.component';
 export * from './checkout-deliver-to.component';
 export * from './checkout-deliver-to-summary.component';
 export * from './checkout-delivery-method.component';
+export * from './checkout-delivery-scheduling.component';
 export * from './checkout-express-checkout.component';
 export * from './checkout-express-completion.component';
 export * from './checkout-gift-cards.component';

package/dist/types/ssr/stub.checkout.d.ts

@@ -5,3 +5,4 @@ export type { IAnalyticsActions, IElementsCheckoutActions, IElementsCheckoutClie
 export type { IInjectedComponent } from '../interfaces/component.interface';
 export type { ILiquidCommerceElementsCheckoutClientConfig } from '../interfaces/config.interface';
 export declare function ElementsCheckout(..._args: any[]): Promise<null>;
+export type { CheckoutDeliveryScheduling, CheckoutDeliverySelection, DeliveryAvailability, DeliverySlot, } from '../interfaces/api/delivery.interface';

package/dist/types/ssr/stub.d.ts

@@ -9,3 +9,4 @@ export type * from '../interfaces/configs';
 export type { IBuilderInjectElementParams, IInjectCheckoutBuilderParams, IInjectCheckoutParams, IInjectProductElement, IInjectProductListFiltersParams, IInjectProductListParams, IInjectProductListSearchParams, ProductListFilterType, } from '../interfaces/injection.interface';
 export declare function Elements(..._args: any[]): Promise<null>;
 export declare function ElementsBuilder(..._args: any[]): Promise<null>;
+export type { CheckoutDeliveryScheduling, CheckoutDeliverySelection, DeliveryAvailability, DeliverySlot, } from '../interfaces/api/delivery.interface';

package/dist/types/utils/delivery-scheduling.d.ts

@@ -0,0 +1,43 @@
+import type { ApiError } from '@/core/api/api-result';
+import type { DeliveryWindowLapse } from '@/core/store/interfaces/checkout.interface';
+import type { StoreService } from '@/core/store/store.service';
+import type { ICheckoutFulfillment, ICheckoutRetailer, ICheckoutShippingAddress } from '@/interfaces/api/checkout.interface';
+import type { CheckoutDeliveryScheduling, DeliverySlot } from '@/interfaces/api/delivery.interface';
+export declare const LAPSED_DELIVERY_WINDOW_CODES: readonly string[];
+export declare const DELIVERY_WINDOW_EXPIRED_MESSAGE = "Your delivery window has passed. Choose a new delivery time.";
+export declare const DELIVERY_WINDOW_UNAVAILABLE_MESSAGE = "Your delivery window is no longer available. Choose a new delivery time.";
+export declare const UNSUPPORTED_DELIVERY_SCHEDULING_CODES: readonly string[];
+export declare const DELIVERY_SELECTION_NOT_ACCEPTED_CODE = "delivery_selection_not_accepted";
+export declare const DELIVERY_SELECTION_NOT_ACCEPTED_MESSAGE = "We couldn't save that delivery time. Choose a delivery time again.";
+export declare const SAVED_DELIVERY_WINDOW_LABEL = "Scheduled delivery";
+export declare const DELIVERY_SCHEDULING_UNAVAILABLE_MESSAGE = "Scheduled delivery isn't available for this order right now. We'll deliver as soon as possible.";
+export declare function expiredDeliveryFulfillmentIds(store: Pick<StoreService, 'get'>): string[];
+export declare function deliveryWindowLapseOf(error: Pick<ApiError, 'errors'> | null | undefined): DeliveryWindowLapse;
+export type DeliveryWindowLapseText = 'message' | 'label';
+export declare function deliveryWindowLapseMessage(lapse: DeliveryWindowLapse | null | undefined, text?: DeliveryWindowLapseText): string;
+export declare function lapsedDeliveryWindowMessage(store: Pick<StoreService, 'get'>, fulfillmentId: string, text?: DeliveryWindowLapseText): string;
+export declare function withoutDeliveryWindow(fulfillment: ICheckoutFulfillment): ICheckoutFulfillment;
+export declare function isLapsedDeliveryWindowError(error: Pick<ApiError, 'errors'> | null | undefined): boolean;
+export declare function isNotAcceptedDeliverySelectionError(error: Pick<ApiError, 'errors'> | null | undefined): boolean;
+export declare function isUnsupportedDeliverySchedulingError(error: Pick<ApiError, 'errors'> | null | undefined): boolean;
+export declare function deliveryAddressKey(address: ICheckoutShippingAddress | null | undefined): string;
+export declare function isFutureDeliverySlot(slot: DeliverySlot | null | undefined, now?: number): boolean;
+export declare function selectedDeliverySlot(scheduling: CheckoutDeliveryScheduling | null | undefined): DeliverySlot | null;
+export declare function isLapsedSelectedDeliverySlot(scheduling: CheckoutDeliveryScheduling | null | undefined, now?: number): boolean;
+export declare function deliverySchedulesReady(fulfillments: Record<string, ICheckoutFulfillment>, now?: number, expired?: string[]): boolean;
+export declare function deliveryChoicesMade(fulfillments: Record<string, ICheckoutFulfillment>, expired?: string[]): boolean;
+export declare function hasDeliveryScheduling(fulfillments: Record<string, ICheckoutFulfillment> | null | undefined): boolean;
+export declare function deliverySchedulingAllowed(fulfillments: Record<string, ICheckoutFulfillment> | null | undefined): boolean;
+export declare function deliveryTimeZone(timezone: string | null | undefined): string;
+export declare function deliveryDateLabel(slot: DeliverySlot, timezone: string): string;
+export declare function deliveryTimeZoneName(timezone: string, style?: 'short' | 'long'): string;
+export declare function deliveryTimeLabel(slot: DeliverySlot, timezone: string): string;
+export declare function deliveryWindowLabel(slot: DeliverySlot, timezone: string): string;
+export declare function deliveryScheduledLabel(slot: DeliverySlot, timezone: string): string;
+export declare function deliveryCutoffLabel(slot: DeliverySlot, timezone: string): string;
+export interface PlacedDeliveryWindow {
+    retailerName: string | null;
+    label: string;
+}
+export declare function placedDeliveryWindows(fulfillments: Record<string, ICheckoutFulfillment> | null | undefined, retailers: Record<string, ICheckoutRetailer> | null | undefined): PlacedDeliveryWindow[];
+export declare function resolveDeliverySlot(scheduling: CheckoutDeliveryScheduling | undefined, advertised: DeliverySlot, now?: number): DeliverySlot | null;

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

@@ -405,6 +405,7 @@ console.log(`Is Gift: ${checkout.isGift}`);
 
 ```typescript
 interface ICheckoutDetailsEventData {
+  deliveryScheduling: Record<string, CheckoutDeliveryScheduling>; // keyed by fulfillment ID; empty without scheduled delivery
   token: string;
   cartId: string;
   isGift: boolean;
@@ -442,6 +443,45 @@ const availability = await window.LiquidCommerce.elements.actions.checkout
 | `identifiers` | string[] | Yes      | Array of product UPCs, SKUs, or IDs  |
 | `state`       | string   | No       | Two-letter state code (e.g., `'NY'`) |
 
+## Delivery scheduling actions
+
+Available on both `Elements()` and `ElementsCheckout()` when a checkout fulfillment carries `deliveryScheduling` (an AccelPay retailer with scheduled delivery turned on). Checkouts without it keep their usual behaviour, and `getDetails().deliveryScheduling` is an empty map.
+
+### `actions.checkout.loadDeliverySlots(fulfillmentId)`
+
+```typescript
+loadDeliverySlots(fulfillmentId: string): Promise<DeliverySlot[]>
+```
+
+Loads the full list of delivery windows for one fulfillment. Checkout prepare returns the list only on request, so outside this call `deliveryScheduling.slots` is empty and `availability.nextSlot` names the first window. The call sends the whole current checkout to prepare, plus `deliverySlotsFulfillmentId`, and resolves with the windows that can still be ordered. Each window's `cutoff` is the latest time to place the order for it ("Order by"). Show times in `availability.timezone`.
+
+### `actions.checkout.chooseDeliverySlot(fulfillmentId, slotId)`
+
+```typescript
+chooseDeliverySlot(fulfillmentId: string, slotId: string | null): Promise<void>
+```
+
+Saves a window from the last loaded list for one fulfillment, or `null` for as soon as possible (only when `availability.canDeliverNow` is true). The promise resolves after prepare accepts and echoes that exact selection. It rejects malformed arguments, unknown fulfillments, windows that were not offered, concurrent checkout updates, a checkout with more than one fulfillment group (only a checkout with one group can be scheduled) and server errors; a rejected save keeps the previously accepted choice, except after `delivery_selection_not_accepted` (below). Slot IDs come from the server; do not build them.
+
+`getDetails().deliveryScheduling[fulfillmentId]` returns the availability, the accepted `selectedSlotId` and `selectedSlot` (the accepted window's `start`, `end` and `cutoff`).
+
+```javascript
+const actions = client.actions.checkout;
+const [fulfillmentId] = Object.keys(actions.getDetails().deliveryScheduling);
+if (fulfillmentId) {
+  const slots = await actions.loadDeliverySlots(fulfillmentId);
+  if (slots.length) await actions.chooseDeliverySlot(fulfillmentId, slots[0].id);
+}
+```
+
+### Expired windows
+
+If a saved window's cutoff passes, or the store's hours or zone rules no longer allow it, before the order is placed, the server answers Place Order, or any other checkout update, with error code `delivery_window_expired` or `delivery_window_unavailable`. Both are recovered the same way; only the message differs ("Your delivery window has passed. Choose a new delivery time." or "Your delivery window is no longer available. Choose a new delivery time."). The SDK then clears the window, marks the fulfillment as needing a new choice, shows the message, opens the picker and blocks payment and Place Order until the shopper saves a new choice. An update that hit the error is sent once more without the window, so the shopper's change still applies. Customer, address, payment, tip and notes stay as they were. A custom UI recovers the same way: load the windows again and call `chooseDeliverySlot`.
+
+If prepare did not keep the window that was sent (error code `delivery_selection_not_accepted`, HTTP 409), the SDK drops the window it holds for that fulfillment so no later update sends it again. `chooseDeliverySlot` rejects with "We couldn't save that delivery time. Choose a delivery time again."; on any other update the window is recovered as an unavailable one.
+
+When scheduled delivery stops applying to the order (`delivery_scheduling_not_enabled`, `delivery_windows_unsupported`, `multiple_fulfillment_groups` or `delivery_scheduling_unsupported`), the SDK drops the saved window with a re-prepare, keeps the rest of checkout and shows "Scheduled delivery isn't available for this order right now. We'll deliver as soon as possible." The picker does not open; the response no longer carries `deliveryScheduling`, so the delivery time row goes away. Switching the delivery method never carries a window over to the new fulfillment.
+
 ## Use Cases
 
 ### Pre-fill for Logged-In Users

package/docs/v1/api/client.md

@@ -596,6 +596,8 @@ import type {
 } from '@liquidcommerce/elements-sdk';
 ```
 
+Both package entries, including their Node/SSR stubs, export `DeliverySlot`, `DeliveryAvailability`, `CheckoutDeliveryScheduling` and `CheckoutDeliverySelection`. Both clients expose `actions.checkout.loadDeliverySlots(fulfillmentId)` and `actions.checkout.chooseDeliverySlot(fulfillmentId, slotId)`.
+
 See [TypeScript Types](./typescript-types.md) for complete type reference.
 
 ## Best Practices

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

@@ -425,6 +425,7 @@ type ComponentType =
   | 'drawer' | 'input' | 'engraving-form' | 'engraving-view'
   | 'buttons-cart-open' | 'powered-by' | 'lce-element'
   | 'purchase-min-alert' | 'alert' | 'promo-code-ticker'
+  | 'checkout-delivery-scheduling' // Internal child of checkout
   // ...and additional internal component types
 ```
 
@@ -571,3 +572,39 @@ 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.
+
+## Delivery scheduling types
+
+The main and checkout-only entries, and their Node/SSR stubs, export these types.
+
+```typescript
+export interface DeliverySlot {
+  id: string; // server-issued, `<fulfillmentOptionId>:<window start, Unix seconds>`
+  start: string; // ISO-8601 UTC
+  end: string; // ISO-8601 UTC
+  cutoff: string; // ISO-8601 UTC, latest time to order for this window ("Order by")
+}
+
+export interface DeliveryAvailability {
+  status: 'available' | 'unavailable'; // available when the store can deliver now or offers windows
+  canDeliverNow: boolean;
+  canSchedule: boolean;
+  timezone: string | null; // store IANA time zone; null when the server has none (the SDK then shows UTC)
+  nextSlot: DeliverySlot | null;
+  checkedAt: string;
+}
+
+export interface CheckoutDeliveryScheduling {
+  availability: DeliveryAvailability;
+  slots: DeliverySlot[]; // only in answer to deliverySlotsFulfillmentId; empty otherwise
+  selectedSlotId: string | null; // null = as soon as possible / no window
+  selectedSlot?: DeliverySlot | null; // the accepted window with its real end and cutoff; null when none
+}
+
+export interface CheckoutDeliverySelection {
+  fulfillmentId: string;
+  slotId: string | null;
+}
+```
+
+`ICheckoutFulfillment.deliveryScheduling` is optional. `ICheckoutPrepareParams` takes `deliverySelections?: CheckoutDeliverySelection[]` and `deliverySlotsFulfillmentId?: string`. `actions.checkout` adds `loadDeliverySlots(fulfillmentId: string): Promise<DeliverySlot[]>` and `chooseDeliverySlot(fulfillmentId: string, slotId: string | null): Promise<void>` on both clients, and `ICheckoutDetailsEventData` adds `deliveryScheduling: Record<string, CheckoutDeliveryScheduling>`.

package/docs/v1/guides/accessibility.md

@@ -289,3 +289,7 @@ from the accessibility tree; unknown choices retain their named, keyboard-operab
 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.
+
+### Delivery date and arrival windows
+
+The delivery picker is a named native modal dialog opened from each delivery's Schedule delivery or Edit control. Dates and arrival windows are radio groups with one tab stop each and arrow-key selection; the date strip scrolls inside the dialog and unavailable dates are disabled. While windows load, the dialog is marked busy and shows a loading line; Cancel and Close stay available. Changes are drafts until Save; Cancel, Close and Escape discard them, and closing returns focus to the opening control. The dialog stays the same modal while it is open: a date or window change updates its contents in place, so it is not announced again. Save errors keep the dialog open and move focus to the error. Success is announced politely; errors and an expired or unavailable window are announced assertively, each with its own message. The time zone is named once above the windows ("Times in Eastern Time"); the first window's accessible name also carries its "Order by" time. The window list scrolls inside the dialog, and the chosen or focused window is kept in view as the picker opens, the date changes and arrow keys move.

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

@@ -286,6 +286,31 @@ console.log(checkoutData);
 // }
 ```
 
+### Load Delivery Slots
+
+Load the delivery windows for one fulfillment that has scheduled delivery. `getDetails().deliveryScheduling` is keyed by fulfillment ID:
+
+```javascript
+const actions = window.LiquidCommerce.elements.actions.checkout;
+const [fulfillmentId] = Object.keys(actions.getDetails().deliveryScheduling);
+
+const slots = await actions.loadDeliverySlots(fulfillmentId);
+// [{ id: 'option_1:1791475200', start: '2026-10-08T16:00:00.000Z', end: '2026-10-08T17:00:00.000Z', cutoff: '2026-10-08T15:00:00.000Z' }, ...]
+```
+
+### Choose Delivery Slot
+
+Save a window from the last loaded list, or `null` for as soon as possible:
+
+```javascript
+await window.LiquidCommerce.elements.actions.checkout.chooseDeliverySlot(fulfillmentId, slots[0].id);
+
+// As soon as possible (only when availability.canDeliverNow is true)
+await window.LiquidCommerce.elements.actions.checkout.chooseDeliverySlot(fulfillmentId, null);
+```
+
+The promise rejects when the window was not offered, the fulfillment is unknown or another checkout update is in flight. See the [checkout actions reference](../api/actions/checkout-actions.md#delivery-scheduling-actions).
+
 ## Events
 
 ### Checkout Lifecycle
@@ -384,6 +409,17 @@ window.addEventListener('lce:actions.checkout_delivery_method_updated', (event)
 });
 ```
 
+### Delivery Time
+
+Fires once after checkout accepts a delivery window or as soon as possible, from the built-in picker or from `chooseDeliverySlot`.
+
+```javascript
+window.addEventListener('lce:actions.checkout_delivery_selection_updated', (event) => {
+  const { deliveryScheduling } = event.detail.data;
+  console.log('Delivery windows by fulfillment:', deliveryScheduling);
+});
+```
+
 ### Tips
 
 ```javascript
@@ -868,3 +904,13 @@ 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.
+
+## Scheduled delivery
+
+When an AccelPay retailer has scheduled delivery turned on, checkout shows a **Delivery time** row for that delivery, between the delivery details and payment. It reads "As soon as possible" while the store can deliver now, or asks for a window when it cannot. The row's button reads **Schedule** while the row is on as soon as possible, **Edit** after a window is saved, and **Schedule delivery** when the shopper must choose a window. It opens a dialog that loads the windows for that delivery: date cards for today and the next 7 days, then arrival windows in the retailer's time zone, named once above the list ("Times in Eastern Time"). The window list scrolls inside the dialog and keeps the chosen window in view. The first window shows "Order by" with its cutoff, and **As soon as possible** sits next to it when the store can deliver now. Choices are drafts until **Save**; Cancel, Close and Escape discard them.
+
+The accepted window shows in the row and on the items in the order summary ("Scheduled for Thu, Oct 8, 1 PM – 2 PM ET"), and on the thank-you page as "Delivery time" with "Thu, Oct 8, 1 PM – 2 PM ET" (with more than one window, each line names its retailer). An ASAP order adds no line there. If the window's cutoff passes before the order is placed, the SDK clears it, shows "Your delivery window has passed. Choose a new delivery time.", reopens the picker and keeps Place Order disabled until a new choice is saved. If the store no longer offers the window, the same happens with "Your delivery window is no longer available. Choose a new delivery time." Everything else the shopper entered stays.
+
+A checkout with more than one fulfillment group cannot be scheduled: the row reads "As soon as possible" with no picker button, and no window is asked for. While a store that cannot deliver now has no accepted window, the express wallet buttons stay off, like the card form.
+
+Checkouts without scheduled delivery are unchanged. For a custom UI, see `actions.checkout.loadDeliverySlots` and `actions.checkout.chooseDeliverySlot` in the checkout actions reference, and the `checkout_delivery_selection_updated` event.

package/docs/v1/guides/events.md

@@ -502,7 +502,7 @@ window.addEventListener('lce:actions.cart_product_add_failed', (event) => {
 
 Fires when checkout data loads.
 
-**Data includes:** `cartId`, `amounts`, `itemCount`, `isGift`, `billingSameAsShipping`.
+**Data includes:** `cartId`, `amounts`, `itemCount`, `isGift`, `billingSameAsShipping`, `deliveryScheduling` (keyed by fulfillment ID).
 
 **Example**
 
@@ -967,6 +967,19 @@ window.addEventListener('lce:actions.checkout_product_add_failed', (event) => {
 });
 ```
 
+### `lce:actions.checkout_delivery_selection_updated`
+
+Emitted once after checkout prepare accepts a delivery window or ASAP choice, from the built-in picker or from `actions.checkout.chooseDeliverySlot`. Draft choices in the picker and failed saves do not emit it.
+
+**Data:** `ICheckoutDetailsEventData`, including `deliveryScheduling: Record<string, CheckoutDeliveryScheduling>` keyed by fulfillment ID, with each accepted `selectedSlotId` and `selectedSlot`.
+
+```javascript
+window.addEventListener('lce:actions.checkout_delivery_selection_updated', (event) => {
+  const scheduling = event.detail.data.deliveryScheduling;
+  console.log('Delivery windows:', scheduling);
+});
+```
+
 ## Form Events
 
 ### `lce:forms.customer`

package/package.json

@@ -3,7 +3,7 @@
   "description": "LiquidCommerce Elements SDK",
   "license": "UNLICENSED",
   "author": "LiquidCommerce Team",
-  "version": "2.6.0-beta.129",
+  "version": "2.6.0-beta.130",
   "homepage": "https://docs.liquidcommerce.co/elements-sdk",
   "repository": {
     "type": "git",