@liquidcommerce/elements-sdk 2.6.0-beta.135 → 2.6.0-beta.137

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

@@ -1,4 +1,4 @@
-import type { ICartEvent, ICartFulfillment, ICartItemAttributes, ICartPromoCode, ICartRetailer } from '@/interfaces/api/cart.interface';
+import type { IAutomaticDiscount, ICartEvent, ICartFulfillment, ICartItemAttributes, ICartPromoCode, ICartRetailer } from '@/interfaces/api/cart.interface';
 export interface ICartItemStore {
     id: string;
     variantId: string;
@@ -47,6 +47,7 @@ export interface ICartStore {
     fulfillments: Record<string, ICartFulfillmentStore>;
     retailers: Record<string, ICartRetailerStore>;
     promoCode: ICartPromoCode | null;
+    automaticDiscounts: IAutomaticDiscount[];
     events: ICartEvent[];
     loading: boolean;
     error: string | null;

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

@@ -1,3 +1,4 @@
+import type { IAutomaticDiscount } from '@/interfaces/api/cart.interface';
 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' | 'required';
 export interface ICheckoutItemStore extends ICheckoutItem {
@@ -61,6 +62,7 @@ export interface ICheckoutStore {
     express: ICheckoutExpressStore;
     shippingAddress: ICheckoutShippingAddress;
     promoCode: ICheckoutPromoCode | null;
+    automaticDiscounts: IAutomaticDiscount[];
     giftCards: ICheckoutGiftCard[];
     itemsQuantity: number;
     items: Record<string, ICheckoutItemStore>;

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

@@ -77,6 +77,12 @@ export interface ICartEvent {
     message: string;
     level: CartEventLevel;
 }
+export interface IAutomaticDiscount {
+    code: string;
+    title: string;
+    target: 'products' | 'fulfillment';
+    discount: number;
+}
 export interface ICart {
     id: string;
     subtotal: number;
@@ -84,6 +90,7 @@ export interface ICart {
     items: Record<string, ICartItem>;
     retailers: Record<string, ICartRetailer>;
     promoCode: ICartPromoCode | null;
+    automaticDiscounts?: IAutomaticDiscount[];
     events: ICartEvent[];
 }
 export interface ICartItemEngraving {

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

@@ -1,6 +1,6 @@
 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 { IAutomaticDiscount, ICart, ICartUpdateItem } from '@/interfaces/api/cart.interface';
 import type { CheckoutDeliveryScheduling, CheckoutDeliverySelection, DeliveryAvailability } from '@/interfaces/api/delivery.interface';
 import type { IProductPresale } from '@/interfaces/api/product.interface';
 export interface ICheckoutComplete {
@@ -267,6 +267,7 @@ export interface ICheckoutPrepare {
     shippingAddress: ICheckoutShippingAddress;
     billingAddress: ICheckoutBilling;
     promoCode: ICheckoutPromoCode | null;
+    automaticDiscounts?: IAutomaticDiscount[];
     amounts: ICheckoutAmounts;
     giftCards: ICheckoutGiftCard[];
     presale: ICheckoutPresale | null;

package/dist/types/modules/cart/components/cart-footer.component.d.ts

@@ -7,6 +7,8 @@ export declare class CartFooterComponent extends BaseComponent<ICartFooterCompon
     get hostClasses(): string[];
     private subtotalText;
     private subtotalPrice;
+    private itemsPrice;
+    private automaticDiscountRows;
     private checkoutButton;
     constructor();
     onStoreWatch(changes: IOnStoreChanged[]): void;
@@ -15,6 +17,7 @@ export declare class CartFooterComponent extends BaseComponent<ICartFooterCompon
     private shouldDisableCheckout;
     private updateCheckoutButtonState;
     private updateSubtotalItemsCount;
+    private renderAutomaticDiscounts;
     private handleCheckout;
     protected template(): HTMLElement[];
 }

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

@@ -152,6 +152,7 @@ export declare class CheckoutCommands extends BaseCommand {
     checkoutComplete(options?: {
         expressPaymentIntentId?: string;
     }): Promise<void>;
+    private discountUpdates;
     private updateStoreFromCheckoutResponse;
     private getDeliveryMethodLocation;
     loadDeliveryMethods(): Promise<void>;

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

@@ -5,9 +5,12 @@ export declare class CheckoutDeliverToComponent extends BaseComponent<null, IChe
     private giftData;
     private saveButtonText;
     private saveButton;
+    private deliveryTimeFocusFrame;
     get hostClasses(): string[];
     constructor();
     onStoreWatch(changes: IOnStoreChanged[]): void;
+    private moveToDeliveryTime;
+    protected disconnected(): void;
     private get requiresBirthDate();
     private updateSaveButtonState;
     protected template(): HTMLElement[];

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

@@ -43,6 +43,8 @@ export declare class CheckoutDeliverySchedulingComponent extends BaseComponent<n
     private radio;
     private createDates;
     private createTimes;
+    private shownZone;
+    private createZoneNote;
     private createNotice;
     private createLoading;
     private createDialogShell;

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

@@ -39,14 +39,18 @@ export declare function selectedDeliverySlot(scheduling: CheckoutDeliverySchedul
 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 deliveryWindowNeededIds(fulfillments: Record<string, ICheckoutFulfillment> | null | undefined, expired?: string[], now?: number): string[];
 export declare function hasDeliveryScheduling(fulfillments: Record<string, ICheckoutFulfillment> | null | undefined): boolean;
 export declare function retailerOfFulfillment(retailers: Record<string, ICheckoutRetailer> | null | undefined, fulfillmentId: string): ICheckoutRetailer | undefined;
 export declare function deliveryWindowNeededMessage(store: Pick<StoreService, 'get'>, fulfillmentIds: string[]): string;
 export declare function hasSeveralDeliveryGroups(fulfillments: Record<string, ICheckoutFulfillment> | null | undefined): boolean;
-export declare function deliveryTimeZone(): string;
+export declare function deliveryTimeZone(storeTimeZone?: string | null): string;
+export declare function schedulingTimeZone(scheduling: CheckoutDeliveryScheduling | null | undefined): string;
 export declare function deliveryDateTimeFormat(timezone: string, options: Omit<Intl.DateTimeFormatOptions, 'timeZone'>): Intl.DateTimeFormat;
 export declare function deliveryTimeZoneName(timezone: string, style?: 'short' | 'long'): string;
+export declare function deliveryTimeZoneAbbreviation(instant: string, timezone: string): string;
 export declare function deliveryTimeLabel(slot: DeliverySlot, timezone: string): string;
+export declare function deliveryRangeLabel(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;

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

@@ -0,0 +1,2 @@
+import type { IAutomaticDiscount } from '@/interfaces/api/cart.interface';
+export declare function getPromoCodeSavings(discounts: number, promoCodeDiscount: number | undefined, automaticDiscounts: IAutomaticDiscount[]): number;

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

@@ -156,6 +156,15 @@ interface ICheckoutPrepare {
   items: Record<string /* cart item ID */, ICheckoutItem>;
   retailers: Record<string /* retailer ID */, ICheckoutRetailer>;
   events: ICheckoutEvent[];
+  automaticDiscounts?: IAutomaticDiscount[];
+}
+
+// A discount the store applied without a code being typed. Its savings are already in `amounts`.
+interface IAutomaticDiscount {
+  code: string;
+  title: string;
+  target: 'products' | 'fulfillment';
+  discount: number; // cents
 }
 ```
 

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

@@ -589,7 +589,7 @@ 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 shows times in the viewer's browser time zone, not this one
+  timezone: string | null; // store IANA time zone; null when the server has none. The SDK shows every delivery time in this zone, named ("EDT"); the viewer's zone only when it is null
   nextSlot: DeliverySlot | null; // null on a product fulfillment of a closed store: checkout gives the windows
   checkedAt: string;
 }

package/docs/v1/guides/accessibility.md

@@ -154,7 +154,7 @@ on render, and a live region recreated with its text already in place is not ann
   option names the retailer, the price, the timing, the delivery fee and — for same-day — the
   store address and whether it is currently closed. A closed store that schedules delivery leads
   with that instead ("Columbus Avenue Wines, closed now, schedule delivery"), followed by
-  "next arrival Thu, 1 PM – 2 PM" only when the server sends a next window; its card
+  "next arrival Thu 10/8, 1–2 PM EDT" only when the server sends a next window; its card
   stays enabled.
 - The California Proposition 65 warning on the product is a native `<details>` / `<summary>`
   disclosure: the summary is a button that exposes its expanded state, and `Enter` / `Space` toggle
@@ -295,4 +295,4 @@ 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. No time zone is shown above the windows; the ASAP window's accessible name is "As soon as possible", and 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.
+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. A line above the windows names their time zone, the store's ("Times in EDT"), and the window list's accessible name carries it ("Arrival window, times in EDT"); the ASAP window's accessible name is "As soon as possible", and 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. When the shopper saves the delivery details with the Save button and a delivery still needs a window, focus moves to that delivery's Schedule delivery control and its row scrolls into view, because the collapsing form would otherwise leave the shopper at payment, past the step that blocks it. Focus moves only from the Save button: a prefill through the actions API, or a shopper who has already moved focus elsewhere, is left alone.

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

@@ -907,13 +907,15 @@ 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 "ASAP" 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. Days and times are in the shopper's own time zone (the browser's), so "Today" is the shopper's today; no time zone is shown. The window list scrolls inside the dialog and keeps the chosen window in view. The first window shows "Order by" with its cutoff, and **ASAP** sits next to it when the store can deliver now (screen readers hear "As soon as possible"). Choices are drafts until **Save**; Cancel, Close and Escape discard them.
+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 "ASAP" 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. Days and times are in the store's time zone (`availability.timezone`), which for a local delivery is also the recipient's, so a shopper in another zone (a gift, say) reads the hour the delivery really comes. "Today" is the store's today, and a line above the windows names the zone ("Times in EDT"). Only when the server sends no zone are the browser's zone and its abbreviation used. The window list scrolls inside the dialog and keeps the chosen window in view. The first window shows "Order by" with its cutoff, and **ASAP** sits next to it when the store can deliver now (screen readers hear "As soon as possible"). 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, 1 PM – 2 PM"), and on the thank-you page as "Delivery time" with "Thu, 1 PM – 2 PM". 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.
+When the shopper saves the delivery details (and, in a gift order, the buyer's details are saved too) and a store still needs a window, focus moves to that row's **Schedule delivery** button and the row scrolls into view, so the shopper does not land on payment below it. A checkout where no store needs a window keeps the shopper where they are.
+
+The accepted window shows in the row and on the items in the order summary ("Scheduled for Thu 10/8, 1–2 PM EDT"), and on the thank-you page as "Delivery time" with "Thu 10/8, 1–2 PM EDT": the weekday, the month and day, the window and the zone abbreviation, which follows daylight saving time ("EST" in winter). 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 store that was added to the cart while closed cannot deliver now, so checkout asks for a window and offers no ASAP. If a store closes after the shopper chose ASAP, Place Order answers `delivery_window_required`: the SDK shows "The store cannot deliver now. Choose a delivery time.", opens the picker and keeps Place Order disabled until a window is saved.
 
-In a checkout with more than one fulfillment group (another store, or shipping), each same-day group with scheduled delivery gets its own **Delivery time** row and its own picker, which loads that group's windows. Its button reads **Schedule this store's delivery** (**Edit** after a window is saved), and the picker is named after the store ("Schedule delivery from Columbus Avenue Wines"). Every prepare sends each group's current choice, so saving one group keeps the other's window. A group whose store can deliver now stays on as soon as possible; a group whose store cannot needs its own window before payment and Place Order. When a window lapses, only that group's window is cleared and only its picker reopens: the SDK clears the window whose cutoff passed on the page, and for `delivery_window_required` marks the groups that have no window. When an error names its group (`fulfillmentId` on the error entry), only that group is cleared. A name that is not a scheduling group of this checkout counts as no name; when the error names no group and the SDK cannot place it, every saved window is cleared (a refused window save clears nothing and asks for another time). When the save of one store's window is refused because the window of another store lapsed, the SDK clears that other window and names its store: "Choose a delivery window for Columbus Avenue Wines before continuing." Until each store that cannot deliver now has a window, payment says which: "Choose a delivery window for Amsterdam Liquors before continuing." In an order with more than one fulfillment group, the thank-you page has one line per group, named after its store: the accepted window for a scheduled group ("Columbus Avenue Wines" with "Thu, 1 PM – 2 PM"), and the group's own expectation for the others ("Harbor Spirits" with "Ships in 3-5 days"). A scheduled group never shows the as-soon-as-possible expectation. While a store that cannot deliver now has no accepted window, the express wallet buttons stay off, like the card form. When checkout refuses a store that has scheduled delivery and also another delivery method (`multiple_fulfillment_options_per_store`, code 5516), the SDK shows the refusal as the checkout error and keeps the saved windows: "Scheduled delivery cannot be combined with another delivery method from the same store. Choose ASAP delivery, or use one delivery method for all items from this store." When that store is closed now, the text leaves out ASAP: "This store is closed now. Use one delivery method for all items from this store." When the refusal says whether the store is closed now (`closedNow` on the error entry), the SDK uses that. Otherwise, when Place Order is refused, the SDK reads the cart again and decides "closed now" from its `deliveryAvailability`, because a store can close after the last prepare. Place Order and the express wallet stay off until a prepare succeeds after a change to the cart or to a delivery choice.
+In a checkout with more than one fulfillment group (another store, or shipping), each same-day group with scheduled delivery gets its own **Delivery time** row and its own picker, which loads that group's windows. Its button reads **Schedule this store's delivery** (**Edit** after a window is saved), and the picker is named after the store ("Schedule delivery from Columbus Avenue Wines"). Every prepare sends each group's current choice, so saving one group keeps the other's window. A group whose store can deliver now stays on as soon as possible; a group whose store cannot needs its own window before payment and Place Order. When a window lapses, only that group's window is cleared and only its picker reopens: the SDK clears the window whose cutoff passed on the page, and for `delivery_window_required` marks the groups that have no window. When an error names its group (`fulfillmentId` on the error entry), only that group is cleared. A name that is not a scheduling group of this checkout counts as no name; when the error names no group and the SDK cannot place it, every saved window is cleared (a refused window save clears nothing and asks for another time). When the save of one store's window is refused because the window of another store lapsed, the SDK clears that other window and names its store: "Choose a delivery window for Columbus Avenue Wines before continuing." Until each store that cannot deliver now has a window, payment says which: "Choose a delivery window for Amsterdam Liquors before continuing." In an order with more than one fulfillment group, the thank-you page has one line per group, named after its store: the accepted window for a scheduled group ("Columbus Avenue Wines" with "Thu 10/8, 1–2 PM EDT"), and the group's own expectation for the others ("Harbor Spirits" with "Ships in 3-5 days"). A scheduled group never shows the as-soon-as-possible expectation. While a store that cannot deliver now has no accepted window, the express wallet buttons stay off, like the card form. When checkout refuses a store that has scheduled delivery and also another delivery method (`multiple_fulfillment_options_per_store`, code 5516), the SDK shows the refusal as the checkout error and keeps the saved windows: "Scheduled delivery cannot be combined with another delivery method from the same store. Choose ASAP delivery, or use one delivery method for all items from this store." When that store is closed now, the text leaves out ASAP: "This store is closed now. Use one delivery method for all items from this store." When the refusal says whether the store is closed now (`closedNow` on the error entry), the SDK uses that. Otherwise, when Place Order is refused, the SDK reads the cart again and decides "closed now" from its `deliveryAvailability`, because a store can close after the last prepare. Place Order and the express wallet stay off until a prepare succeeds after a change to the cart or to a delivery choice.
 
 In the delivery-method switch, a same-day method whose `deliveryAvailability` says the store cannot deliver now but can schedule shows "Schedule delivery" in place of its delivery estimate. Without `deliveryAvailability` the card shows the estimate as before.
 

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

@@ -482,7 +482,7 @@ await window.LiquidCommerce.elements.actions.address.setAddressManually(
 
 ## Buying when a retailer is closed
 
-A same-day retailer whose store schedules delivery can take orders while it is closed. Its fulfillment then carries `deliveryAvailability`. When that says the store cannot deliver now but can schedule (`status: 'available'`, `canSchedule: true`), the retailer card stays on and shows "Schedule delivery". The product page shows no time: the server sends `nextSlot: null` for a closed store, and checkout asks the shopper to choose a delivery window. Add to Cart stays on. Screen readers hear "Columbus Avenue Wines, closed now, schedule delivery" in place of "Currently closed". When the server does send a `nextSlot`, the card adds it on a second line, in the shopper's own time zone ("Schedule delivery", then "Thu, 1 PM – 2 PM") and screen readers hear "…, next arrival Thu, 1 PM – 2 PM". The SDK selects a retailer that can deliver now first, then one that schedules delivery, and goes to shipping only when neither is available.
+A same-day retailer whose store schedules delivery can take orders while it is closed. Its fulfillment then carries `deliveryAvailability`. When that says the store cannot deliver now but can schedule (`status: 'available'`, `canSchedule: true`), the retailer card stays on and shows "Schedule delivery". The product page shows no time: the server sends `nextSlot: null` for a closed store, and checkout asks the shopper to choose a delivery window. Add to Cart stays on. Screen readers hear "Columbus Avenue Wines, closed now, schedule delivery" in place of "Currently closed". When the server does send a `nextSlot`, the card adds it on a second line, in the store's time zone with its abbreviation ("Schedule delivery", then "Thu 10/8, 1–2 PM EDT") and screen readers hear "…, next arrival Thu 10/8, 1–2 PM EDT". The SDK selects a retailer that can deliver now first, then one that schedules delivery, and goes to shipping only when neither is available.
 
 A closed store without scheduled delivery is blocked as before. An unknown or unavailable `deliveryAvailability`, or a `nextSlot` whose order cutoff has passed, never turns purchase on.
 

package/package.json

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