@liquidcommerce/elements-sdk 2.6.0-beta.126 → 2.6.0-beta.128

package/dist/types/core/client/client-config.service.d.ts

@@ -23,6 +23,7 @@ export interface IClientConfigs {
     openShadowDom?: boolean;
     hasCustomApiUrl?: boolean;
     mockMode: boolean;
+    enableExpressCheckout: boolean;
     checkout: ILiquidCommerceElementsCheckoutConfig | null;
     isCheckoutOnly: boolean;
 }
@@ -38,6 +39,7 @@ export interface IClientConfigInput {
         customApiUrl?: string;
         openShadowDom?: boolean;
         mockMode?: boolean;
+        enableExpressCheckout?: boolean;
     };
     checkout?: ILiquidCommerceElementsCheckoutConfig;
     isCheckoutOnly?: boolean;

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

@@ -14,6 +14,7 @@ export interface ILiquidCommerceElementsDevelopmentConfig {
     customApiUrl?: string;
     openShadowDom?: boolean;
     mockMode?: boolean;
+    enableExpressCheckout?: boolean;
 }
 export interface IClientCustomThemeConfig {
     global?: UpdateComponentGlobalConfigs;

package/docs/v1/api/client.md

@@ -73,6 +73,9 @@ Injects only the Apple Pay and Google Pay wallet buttons, anywhere on the page,
 the checkout UI. Confirming the wallet sheet places the order outright — the wallet's contact and
 billing details are sent to the checkout, so the shopper never fills a checkout form.
 
+Express checkout is off by default: pass `development.enableExpressCheckout: true` in the client config to show it. Without it this
+method renders nothing and resolves to `null`.
+
 ```typescript
 injectExpressCheckout(params: IInjectExpressCheckoutParams): Promise<IInjectedComponent | null>
 ```

package/docs/v1/api/configuration.md

@@ -563,6 +563,7 @@ interface ILiquidCommerceElementsDevelopmentConfig {
   customApiUrl?: string;
   openShadowDom?: boolean;
   mockMode?: boolean;
+  enableExpressCheckout?: boolean;
 }
 ```
 
@@ -571,6 +572,9 @@ interface ILiquidCommerceElementsDevelopmentConfig {
 | `customApiUrl` | `string` | Custom API URL for local or custom backend testing |
 | `openShadowDom` | `boolean` | Use an OPEN (inspectable) Shadow DOM instead of the default closed mode, for debugging. Shadow DOM is always attached; forced off in production (default: `false`) |
 | `mockMode` | `boolean` | Enable mock mode to receive mock data from the API; sends an `X-Liquid-Api-Mock-Mode` header with all requests (default: `false`) |
+| `enableExpressCheckout` | `boolean` | Show the Apple Pay / Google Pay express checkout and the checkout's delivery-method switch (same-day vs shipping) — the express block and delivery-method section in the checkout element, and `injectExpressCheckoutElement()` / `injectExpressCheckout()`, which otherwise render nothing and resolve to `null`. Honoured in every environment, production included (default: `false`) |
+
+> **Temporary:** this flag exists only while express checkout and the delivery-method switch are being verified. Once they are confirmed, the flag will be removed and both will always be on.
 
 > To pre-select a payment method and skip the card form (in any environment), use [`actions.checkout.setSavedPaymentMethod`](./actions/checkout-actions.md#actionscheckoutsetsavedpaymentmethod) instead.
 

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

@@ -158,6 +158,7 @@ interface ILiquidCommerceElementsDevelopmentConfig {
   customApiUrl?: string;
   openShadowDom?: boolean;
   mockMode?: boolean;  // when true, sends an 'X-Liquid-Api-Mock-Mode' header to receive mock data
+  enableExpressCheckout?: boolean;  // show express checkout and the delivery-method switch; off by default, honoured in production
 }
 ```
 

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

@@ -373,7 +373,9 @@ window.addEventListener('lce:actions.checkout_item_quantity_decrease', (event) =
 
 ### Delivery Method
 
-Fires when the shopper switches a single-item checkout between same-day delivery and shipping.
+Fires when the shopper switches a single-item checkout between same-day delivery and shipping. The
+switch is shown only with `development.enableExpressCheckout: true`, the same opt-in as express
+checkout.
 
 ```javascript
 window.addEventListener('lce:actions.checkout_delivery_method_updated', (event) => {
@@ -563,7 +565,12 @@ Apple Pay and Google Pay are offered as express checkout buttons at the top of t
 the gift toggle. Tapping one collects the shopper's contact and billing details from the wallet and
 places the order without them completing the checkout forms.
 
-Express checkout is offered to every shopper whose platform can show a wallet. Each wallet is
+Express checkout is off by default: pass `development.enableExpressCheckout: true` in the client config to show it. Without it the checkout element renders
+no express block, and the injection methods below render nothing and resolve to `null`.
+
+> **Temporary:** this flag exists only while express checkout and the delivery-method switch are being verified. Once they are confirmed, the flag will be removed and both will always be on.
+
+Once enabled, express checkout is offered to every shopper whose platform can show a wallet. Each wallet is
 requested with Stripe's `always` policy, so the button renders wherever the device supports it rather
 than only where Stripe judges it good for conversion. The block hides itself entirely — heading,
 buttons and divider — in four cases: the device or browser offers no wallet, the order is a

package/docs/v1/guides/events.md

@@ -709,7 +709,8 @@ window.addEventListener('lce:actions.checkout_item_engraving_updated', (event) =
 ### `lce:actions.checkout_delivery_method_updated`
 
 Fires when the shopper moves a single-item checkout between same-day delivery and shipping. The order
-is re-priced, so the totals change with it.
+is re-priced, so the totals change with it. The switch is shown only with
+`development.enableExpressCheckout: true`.
 
 **Data includes:** `cartId`, `fulfillmentType`, `previousFulfillmentType`, `fulfillmentId`.
 

package/package.json

@@ -3,7 +3,7 @@
   "description": "LiquidCommerce Elements SDK",
   "license": "UNLICENSED",
   "author": "LiquidCommerce Team",
-  "version": "2.6.0-beta.126",
+  "version": "2.6.0-beta.128",
   "homepage": "https://docs.liquidcommerce.co/elements-sdk",
   "repository": {
     "type": "git",
@@ -112,7 +112,7 @@
     "@biomejs/biome": "^2.5.15",
     "@commitlint/cli": "^21.2.3",
     "@commitlint/config-conventional": "^21.2.3",
-    "@playwright/test": "1.63.0",
+    "@playwright/test": "1.64.0",
     "@rollup/plugin-alias": "^6.0.0",
     "@rollup/plugin-commonjs": "^29.0.3",
     "@rollup/plugin-json": "^6.1.0",
@@ -126,12 +126,12 @@
     "@semantic-release/npm": "^13.2.0",
     "@semantic-release/release-notes-generator": "^14.1.1",
     "@types/core-js": "^2.5.8",
-    "@types/node": "^26.6.4",
+    "@types/node": "^26.6.5",
     "conventional-changelog": "8.1.3",
     "husky": "^9.1.7",
     "jsdom": "30.1.2",
     "process": "^0.11.10",
-    "rollup": "^4.64.0",
+    "rollup": "^4.64.5",
     "rollup-obfuscator": "^4.1.1",
     "rollup-plugin-typescript2": "^0.37.0",
     "semantic-release": "^25.0.9",