@liquidcommerce/elements-sdk 2.7.6 → 2.7.7

package/dist/types/auto-initialize/shared-utils.d.ts

@@ -1,12 +1,22 @@
+import type { IAddProductParams } from '@/core/client/actions/client-cart-action.service';
+import type { IAnonymousCheckoutAddProductItem } from '@/interfaces/api/checkout.interface';
 import type { IInjectedComponent } from '@/interfaces/component.interface';
 import type { ILiquidCommerceElementsDevelopmentConfig } from '@/interfaces/config.interface';
 import type { IInjectCheckoutParams } from '@/interfaces/injection.interface';
+export interface IQueryParamActions {
+    addProduct: (params: IAddProductParams[], open?: boolean) => Promise<void>;
+    applyPromoCode: (promoCode: string) => Promise<void>;
+}
 export declare const SHARED_ATTR: {
     readonly SCRIPT: {
         readonly MAIN: "data-liquid-commerce-elements";
         readonly TOKEN: "data-token";
         readonly ENV: "data-env";
         readonly DEBUG_MODE: "data-debug-mode";
+        readonly PRODUCT_PARAM: "data-product-param";
+        readonly PRODUCT_FULFILLMENT_TYPE_PARAM: "data-product-fulfillment-type-param";
+        readonly PRODUCT_QUANTITY_PARAM: "data-product-quantity-param";
+        readonly PROMO_CODE_PARAM: "data-promo-code-param";
         readonly CHECKOUT_PARAM: "data-checkout-param";
         readonly CHECKOUT_URL: "data-checkout-url";
     };
@@ -27,3 +37,9 @@ export declare function setupCheckout(script: HTMLScriptElement, injectFn: (para
     errorPrefix: string;
 }): Promise<void>;
 export declare function setupExitCheckoutHandlers(exitCheckoutFn: () => void): void;
+export declare function addProductViaQueryParam(actions: IQueryParamActions, script: HTMLScriptElement, errorPrefix: string): Promise<void>;
+export declare function extractAnonymousProductFromQueryParams(script: HTMLScriptElement, errorPrefix: string): {
+    item: IAnonymousCheckoutAddProductItem;
+    promoCode?: string;
+} | null;
+export declare function applyPromoCodeViaQueryParam(actions: IQueryParamActions, script: HTMLScriptElement, errorPrefix: string): Promise<void>;

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

@@ -1,5 +1,6 @@
 import type { IElementsCheckoutClient } from '@/interfaces/client.interface';
 import type { ILiquidCommerceElementsCheckoutClientConfig } from '@/interfaces/config.interface';
 import '@/modules/theme-provider/styles/register-styles';
+import '@/modules/address/styles/register-styles';
 import '@/modules/checkout/styles/register-styles';
 export declare function ElementsCheckout(apiKey: string, config: ILiquidCommerceElementsCheckoutClientConfig): Promise<IElementsCheckoutClient | null>;

package/dist/types/clients/helpers.d.ts

@@ -1,4 +1,5 @@
 import { type ComponentType } from '@/enums';
+export declare function normalizeProductListLists<T extends Record<string, any>>(data: T): T;
 export declare function deepMergeConfigs<T extends Record<string, any>>(target: T, source: Partial<T>, currentPath?: string): T;
 export declare const layoutFieldToComponentTypes: Map<string, ComponentType[]>;
 export declare function getComponentTypesForLayoutFields(parentPath: string, layoutFields: Record<string, any>): ComponentType[];

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

@@ -3,7 +3,7 @@ import type { AuthClientService } from '@/core/api/auth-client.service';
 import type { IPersistedStore, IPersistedStoreAction } from '@/core/store/interfaces/core.interface';
 import type { IAddressAutocompleteResult, IAddressDetailsResult, ILocation } from '@/interfaces/api/address.interface';
 import type { ICart, ICartUpdateParams } from '@/interfaces/api/cart.interface';
-import type { ICheckoutComplete, ICheckoutItemsUpdateParams, ICheckoutItemsUpdateResponse, ICheckoutPaymentConfirm, ICheckoutPaymentConfirmParams, ICheckoutPaymentSession, ICheckoutPrepare, ICheckoutPrepareParams } from '@/interfaces/api/checkout.interface';
+import type { IAnonymousCheckoutAddProductParams, IAnonymousCheckoutAddProductResponse, ICheckoutComplete, ICheckoutItemsUpdateParams, ICheckoutItemsUpdateResponse, ICheckoutPaymentConfirm, ICheckoutPaymentConfirmParams, ICheckoutPaymentSession, ICheckoutPrepare, ICheckoutPrepareParams } from '@/interfaces/api/checkout.interface';
 import type { IProductAvailabilityResponse } from '@/interfaces/api/product.interface';
 import type { IProductSearchParams, IProductSearchResponse } from '@/interfaces/api/product-list.interface';
 export declare class ApiClientService {
@@ -19,11 +19,13 @@ export declare class ApiClientService {
     getAddressDetails(id: string): Promise<ApiResult<IAddressDetailsResult>>;
     getProductsData(identifier: string[], location?: ILocation): Promise<ApiResult<IProductAvailabilityResponse>>;
     productListSearch(params: IProductSearchParams): Promise<ApiResult<IProductSearchResponse>>;
+    getProductAvailabilityByState(identifiers: string[], state?: string): Promise<ApiResult<IProductAvailabilityResponse>>;
     getCartData(id: string | null): Promise<ApiResult<ICart>>;
     updateCart(params: ICartUpdateParams): Promise<ApiResult<ICart>>;
     prepareCheckout(params: ICheckoutPrepareParams): Promise<ApiResult<ICheckoutPrepare>>;
     updateCheckoutItems(params: ICheckoutItemsUpdateParams): Promise<ApiResult<ICheckoutItemsUpdateResponse>>;
     getPaymentSession(cartId: string): Promise<ApiResult<ICheckoutPaymentSession>>;
     confirmPaymentSession(params: ICheckoutPaymentConfirmParams): Promise<ApiResult<ICheckoutPaymentConfirm>>;
+    addAnonymousProduct(params: IAnonymousCheckoutAddProductParams): Promise<ApiResult<IAnonymousCheckoutAddProductResponse>>;
     checkoutComplete(token: string): Promise<ApiResult<ICheckoutComplete>>;
 }

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

@@ -1,4 +1,6 @@
 import type { ICheckoutDetailsEventData } from '@/core/pubsub/interfaces/checkout.interface';
+import type { IAnonymousCheckoutAddProductParams, IAnonymousCheckoutAddProductResponse } 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';
 import type { IAddProductParams } from './client-cart-action.service';
@@ -19,6 +21,8 @@ export interface ICheckoutActions {
     updateBillingInfo: (params: Record<BillingFieldName, string>) => void;
     updateGiftInfo: (params: Record<GiftFieldName, string>) => void;
     getDetails: () => ICheckoutDetailsEventData;
+    getProductAvailabilityByState: (identifiers: string[], state?: string) => Promise<IProductAvailabilityResponse>;
+    addAnonymousProduct: (params: IAnonymousCheckoutAddProductParams) => Promise<IAnonymousCheckoutAddProductResponse>;
 }
 export declare class ClientCheckoutActionService extends BaseActionService {
     private readonly command;
@@ -47,4 +51,6 @@ export declare class ClientCheckoutActionService extends BaseActionService {
     private updateBillingInfo;
     private updateGiftInfo;
     private getDetails;
+    private addAnonymousProduct;
+    private getProductAvailabilityByState;
 }

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

@@ -1,7 +1,9 @@
 import type { IBaseProductEventData } from '@/core/pubsub/interfaces/product.interface';
+import type { IProductAvailabilityResponse } from '@/interfaces/api/product.interface';
 import { BaseActionService } from './base-action.service';
 export interface IProductActions {
     getDetails: (identifier: string) => IBaseProductEventData;
+    getProductAvailabilityByState: (identifiers: string[], state?: string) => Promise<IProductAvailabilityResponse>;
 }
 export declare class ClientProductActionService extends BaseActionService {
     private readonly command;
@@ -9,4 +11,5 @@ export declare class ClientProductActionService extends BaseActionService {
     static getInstance(): ClientProductActionService;
     get actions(): IProductActions;
     private getDetails;
+    private getProductAvailabilityByState;
 }

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

@@ -22,7 +22,9 @@ export interface IClientConfigs {
     paymentMethodId?: string;
     openShadowDom?: boolean;
     hasCustomApiUrl?: boolean;
+    mockMode: boolean;
     checkout: ILiquidCommerceElementsCheckoutConfig | null;
+    isCheckoutOnly: boolean;
 }
 export interface IClientConfigInput {
     env?: ElementsEnv;
@@ -35,8 +37,10 @@ export interface IClientConfigInput {
         customApiUrl?: string;
         paymentMethodId?: string;
         openShadowDom?: boolean;
+        mockMode?: boolean;
     };
     checkout?: ILiquidCommerceElementsCheckoutConfig;
+    isCheckoutOnly?: boolean;
 }
 export declare class ClientConfigService {
     private config;
@@ -49,6 +53,7 @@ export declare class ClientConfigService {
     isStaging(): boolean;
     isProduction(): boolean;
     isBuilder(): boolean;
+    isCheckoutOnly(): boolean;
     isDebuggingEnabled(): boolean;
     isDebugPanelEnabled(): boolean;
     debuggingDisabled(): boolean;

package/dist/types/index.d.ts

@@ -2,6 +2,8 @@ export * from './clients/builder';
 export * from './clients/main';
 export * from './core/sdk-error-handler';
 export * from './enums';
+export type { LiquidCommerceGlobal } from './global';
+export * from './interfaces/api';
 export * from './interfaces/client.interface';
 export * from './interfaces/component.interface';
 export * from './interfaces/config.interface';

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 } from '@/interfaces/api/cart.interface';
+import type { ICart, ICartUpdateItem } from '@/interfaces/api/cart.interface';
 import type { IProductPresale } from '@/interfaces/api/product.interface';
 export interface ICheckoutComplete {
     orderNumber: string;
@@ -94,6 +94,27 @@ export interface ICheckoutItemsUpdateResponse {
     cart: ICart;
     checkout: ICheckoutPrepare;
 }
+export interface IAnonymousCheckoutAddProductItem {
+    identifier: string;
+    fulfillmentType: FulfillmentType;
+    quantity: number;
+}
+export interface IAnonymousCheckoutAddProductParams {
+    items?: IAnonymousCheckoutAddProductItem[];
+    cartItems?: ICartUpdateItem[];
+    location: ILocation;
+    promoCode?: string;
+}
+export interface IAnonymousCheckoutUnavailableItem {
+    identifier: string;
+    productName: string | null;
+    fulfillmentType: FulfillmentType;
+    reason: 'product_not_available' | 'fulfillment_not_available';
+}
+export interface IAnonymousCheckoutAddProductResponse {
+    checkout: ICheckoutPrepare | null;
+    unavailableItems: IAnonymousCheckoutUnavailableItem[];
+}
 export interface ICheckoutAmounts {
     subtotal: number;
     engraving: number;

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

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

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

@@ -8,6 +8,12 @@ export interface IProductAvailabilityResponse {
     products: IProduct[];
     retailers: Record<string, IRetailer>;
 }
+export interface IProductPriceInfo {
+    currency: string;
+    minimum: number;
+    average: number;
+    maximum: number;
+}
 export interface IProductVariant {
     retailerId: string;
     shippingFulfillmentId: string;
@@ -64,7 +70,7 @@ export interface IProduct {
     type: string;
     subType: string;
     salsifyGrouping: string;
-    noAvailabilityPrice: number;
+    priceInfo: IProductPriceInfo | null;
     sizes: Record<string, IProductSize>;
 }
 export interface IFulfillment {

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

@@ -11,6 +11,7 @@ export interface ILiquidCommerceElementsDevelopmentConfig {
     customApiUrl?: string;
     paymentMethodId?: string;
     openShadowDom?: boolean;
+    mockMode?: boolean;
 }
 export interface IClientCustomThemeConfig {
     global?: UpdateComponentGlobalConfigs;
@@ -21,7 +22,7 @@ export interface IClientCustomThemeConfig {
     productList?: UpdateProductListComponent;
 }
 export interface ILiquidCommerceElementsCheckoutConfig {
-    pageUrl: string;
+    pageUrl?: string;
 }
 export interface ILiquidCommerceElementsBaseConfig {
     env?: ElementsEnv;
@@ -29,18 +30,12 @@ export interface ILiquidCommerceElementsBaseConfig {
     customTheme?: IClientCustomThemeConfig;
     debugMode?: DebugMode;
     checkout?: ILiquidCommerceElementsCheckoutConfig;
+    proxy?: IElementsProxyConfig;
+    development?: ILiquidCommerceElementsDevelopmentConfig;
 }
 export interface ILiquidCommerceElementsBuilderConfig extends ILiquidCommerceElementsBaseConfig {
 }
 export interface ILiquidCommerceElementsConfig extends ILiquidCommerceElementsBaseConfig {
-    proxy?: IElementsProxyConfig;
-    development?: ILiquidCommerceElementsDevelopmentConfig;
 }
-export interface ILiquidCommerceElementsCheckoutClientConfig {
-    env?: ElementsEnv;
-    customTheme?: IClientCustomThemeConfig;
-    debugMode?: DebugMode;
-    checkout?: ILiquidCommerceElementsCheckoutConfig;
-    proxy?: IElementsProxyConfig;
-    development?: ILiquidCommerceElementsDevelopmentConfig;
+export interface ILiquidCommerceElementsCheckoutClientConfig extends ILiquidCommerceElementsBaseConfig {
 }

package/dist/types/interfaces/configs/product-list.interface.d.ts

@@ -39,4 +39,9 @@ export interface IProductListComponent {
     theme: IProductListTheme;
     layout: IProductListLayout;
 }
-export type UpdateProductListComponent = DeepPartial<IProductListComponent>;
+export interface UpdateProductListComponent {
+    theme?: DeepPartial<IProductListTheme>;
+    layout?: {
+        lists?: Record<string, DeepPartial<IPLCList>>;
+    };
+}

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

@@ -1,7 +1,7 @@
 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 } from '@/interfaces/api/checkout.interface';
+import type { ICheckoutBilling, ICheckoutCustomer, ICheckoutGiftRecipient, 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 {
@@ -14,6 +14,7 @@ export declare class CheckoutCommands extends BaseCommand {
         cartId?: string;
         isForPresale?: boolean;
     }): Promise<void>;
+    loadCheckoutFromResponse(response: ICheckoutPrepare): void;
     toggleIsGift(active?: boolean): Promise<void>;
     toggleBillingSameAsShipping(active?: boolean): Promise<void>;
     toggleMarketingPreferences(fieldName: 'canEmail' | 'canSms', active?: boolean): Promise<void>;

package/dist/types/modules/theme-provider/theme-provider.service.d.ts

@@ -19,5 +19,4 @@ export declare class ThemeProviderService {
     getComponentConfig(componentType: ComponentType): ConfigsType | undefined;
     getStylesheet(componentType: ComponentType): GeneratedStylesheet[];
     private getBaseStylesheets;
-    private deepMerge;
 }

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

@@ -29,7 +29,7 @@ Use data attributes to configure the product list:
 ></script>
 
 <div
-  data-liquid-commerce-elements-products-list
+  data-liquid-commerce-elements-products-list="my-collection-slug"
   data-rows="3"
   data-columns="4"
   data-filters="price,brand,category"
@@ -38,7 +38,7 @@ Use data attributes to configure the product list:
 ```
 
 **Attributes:**
-- `data-liquid-commerce-elements-products-list`: Marks element as product list container
+- `data-liquid-commerce-elements-products-list`: Product list container; value is the collection slug
 - `data-rows`: Number of rows to display (default: 3)
 - `data-columns`: Number of columns (default: 4)
 - `data-filters`: Comma-separated filter types
@@ -52,14 +52,14 @@ Separate containers for search and filters:
 
 ```html
 <!-- Search container -->
-<div data-search-container></div>
+<div data-liquid-commerce-elements-products-list-search="my-collection-slug"></div>
 
 <!-- Filters container -->
-<div data-filters-container data-filters="price,brand,fulfillment"></div>
+<div data-liquid-commerce-elements-products-list-filters="my-collection-slug" data-filters="price,brand,fulfillment"></div>
 
 <!-- Product list -->
 <div
-  data-liquid-commerce-elements-products-list
+  data-liquid-commerce-elements-products-list="my-collection-slug"
   data-rows="4"
   data-columns="3"
   data-product-url="/products/{identifier}"
@@ -343,18 +343,18 @@ const client = await Elements('YOUR_API_KEY', {
   <h1>Whiskey Collection</h1>
   
   <!-- Search -->
-  <div data-search-container></div>
-  
+  <div data-liquid-commerce-elements-products-list-search="whiskey-collection"></div>
+
   <div class="catalog">
     <!-- Filters sidebar -->
     <aside>
-      <div data-filters-container data-filters="price,brand,size"></div>
+      <div data-liquid-commerce-elements-products-list-filters="whiskey-collection" data-filters="price,brand,size"></div>
     </aside>
-    
+
     <!-- Product grid -->
     <main>
       <div
-        data-liquid-commerce-elements-products-list
+        data-liquid-commerce-elements-products-list="whiskey-collection"
         data-rows="4"
         data-columns="3"
         data-product-url="/whiskey/{identifier}"

package/package.json

@@ -3,7 +3,7 @@
   "description": "LiquidCommerce Elements SDK",
   "license": "UNLICENSED",
   "author": "LiquidCommerce Team",
-  "version": "2.7.6",
+  "version": "2.7.7",
   "homepage": "https://docs.liquidcommerce.co/elements-sdk",
   "repository": {
     "type": "git",
@@ -81,9 +81,9 @@
     "embeddable commerce"
   ],
   "devDependencies": {
-    "@biomejs/biome": "^2.4.2",
-    "@commitlint/cli": "^20.4.1",
-    "@commitlint/config-conventional": "^20.4.1",
+    "@biomejs/biome": "^2.4.4",
+    "@commitlint/cli": "^20.4.2",
+    "@commitlint/config-conventional": "^20.4.2",
     "@rollup/plugin-alias": "^6.0.0",
     "@rollup/plugin-commonjs": "^29.0.0",
     "@rollup/plugin-json": "^6.1.0",
@@ -97,11 +97,11 @@
     "@semantic-release/npm": "^13.1.4",
     "@semantic-release/release-notes-generator": "^14.1.0",
     "@types/core-js": "^2.5.8",
-    "@types/node": "^25.2.3",
+    "@types/node": "^25.3.0",
     "conventional-changelog-cli": "^5.0.0",
     "husky": "^9.1.7",
     "process": "^0.11.10",
-    "rollup": "^4.57.1",
+    "rollup": "^4.59.0",
     "rollup-obfuscator": "^4.1.1",
     "rollup-plugin-typescript2": "^0.36.0",
     "semantic-release": "^25.0.3",