@liquidcommerce/elements-sdk 2.7.12 → 2.7.14

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

@@ -3,6 +3,7 @@ import { LoggerFactory } from '@/core/logger/logger-factory';
 import { PubSubService } from '@/core/pubsub/pubsub.service';
 import { StoreService } from '@/core/store/store.service';
 import type { ILocation } from '@/interfaces/api/address.interface';
+import type { IProductSizeEngraving, IProductVariant } from '@/interfaces/api/product.interface';
 import { ThemeProviderService } from '@/modules/theme-provider/theme-provider.service';
 export declare abstract class BaseActionService {
     protected readonly pubSub: PubSubService;
@@ -12,4 +13,10 @@ export declare abstract class BaseActionService {
     protected readonly logger: ReturnType<typeof LoggerFactory.get>;
     constructor(loggerName: string);
     protected getLocation(): ILocation | undefined;
+    protected sanitizeEngravingInput(rawLines: string[] | undefined, identifier: string): string[] | undefined;
+    protected clampEngravingToSizeLimits(requestedLines: string[], sizeEngraving: IProductSizeEngraving | undefined, identifier: string): string[] | undefined;
+    protected findVariantForFulfillment(variants: (IProductVariant | undefined)[], wantsEngraving: boolean): {
+        variant: IProductVariant | null;
+        engravingDropped: boolean;
+    };
 }

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

@@ -5,6 +5,7 @@ export interface IAddProductParams {
     identifier: string;
     fulfillmentType: FulfillmentType;
     quantity: number;
+    engravingLines?: string[];
 }
 export interface ICartActions {
     openCart: () => void;

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

@@ -17,6 +17,7 @@ export interface IInjectProductListParams {
 export interface IInjectProductListSearchParams {
     containerId: string;
     slug: string;
+    filters?: ProductListFilterType[];
 }
 export interface IInjectProductListFiltersParams {
     containerId: string;

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

@@ -9,6 +9,9 @@ export declare class CheckoutItemQuantityComponent extends BaseComponent<IChecko
     get hostClasses(): string[];
     constructor();
     onStoreWatch(changes: IOnStoreChanged[]): void;
+    private getCheckoutItemStore;
+    private getCartItemStore;
+    private getProductStoreByLiquidId;
     private getAvailableQuantity;
     private calculateQuantityLimits;
     private updateButtonStates;

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

@@ -13,6 +13,7 @@ export declare class ProductCommands extends BaseCommand {
     createProductInstance(productId: string, firstTime?: boolean): Promise<void>;
     loadMultipleProducts(productIds: string[]): Promise<void>;
     loadProduct(productId: string, customProductData?: IProductAvailabilityResponse | null): Promise<void>;
+    cacheProductFromApiData(identifier: string, apiData: IProductAvailabilityResponse): void;
     selectSize(productId: string, sizeId: string): Promise<void>;
     selectFulfillment(productId: string, selectedFulfillmentId: string): Promise<void>;
     updateQuantity(productId: string, delta: number): Promise<void>;

package/dist/types/modules/product-list/components/card-components/product-button.d.ts

@@ -1,9 +1,11 @@
-export interface IAddToCartButtonParams {
+export interface IAddToCartButtonState {
     isPresale: boolean;
     hasAvailability: boolean;
-    state: string;
-    disabled?: boolean;
     hasAddress: boolean;
+    disabled?: boolean;
+}
+export interface IAddToCartButtonParams extends IAddToCartButtonState {
     onClick?: (e: MouseEvent) => void | Promise<void>;
 }
-export declare const createAddToCartButton: ({ isPresale, hasAvailability, state, disabled, hasAddress, onClick, }: IAddToCartButtonParams) => HTMLElement;
+export declare const applyAddToCartButtonState: (button: HTMLButtonElement, state: IAddToCartButtonState) => void;
+export declare const createAddToCartButton: ({ isPresale, hasAvailability, disabled, hasAddress, onClick, }: IAddToCartButtonParams) => HTMLButtonElement;

package/dist/types/modules/product-list/components/card-components/product-quantity-selector.d.ts

@@ -4,6 +4,7 @@ export interface IQuantitySelectorParams {
     minQuantity: number;
     maxQuantity: number;
     cardStyle: PLCCardStyle;
+    disabled?: boolean;
     onChange: (quantity: number) => void;
 }
-export declare const createQuantitySelector: ({ initialQuantity, minQuantity, maxQuantity, cardStyle, onChange }: IQuantitySelectorParams) => HTMLElement;
+export declare const createQuantitySelector: ({ initialQuantity, minQuantity, maxQuantity, cardStyle, disabled, onChange, }: IQuantitySelectorParams) => HTMLElement;

package/dist/types/modules/product-list/components/product-list-card.component.d.ts

@@ -16,9 +16,11 @@ export declare class ProductListCardComponent extends BaseComponent<IProductList
     constructor();
     private getListConfig;
     get hostClasses(): string[];
+    protected beforeConnected(): void;
     protected disconnected?(): void;
     onStoreWatch(changes: IOnStoreChanged[]): void;
     private getSelectedSize;
+    private getDisplayPrice;
     protected template(): HTMLElement[];
     private updatePriceDisplay;
     private updateFulfillmentText;

package/dist/types/modules/product-list/components/product-list-product-pre-cart.component.d.ts

@@ -17,7 +17,7 @@ export declare class ProductListProductPreCartComponent extends BaseComponent<IP
     private previousSelectedFulfillmentId;
     constructor();
     private getListConfig;
-    protected afterRender?(): void;
+    protected connected?(): void;
     private handleRetailersBack;
     private handleEngravingBack;
     private handleEngravingEdit;
@@ -30,6 +30,7 @@ export declare class ProductListProductPreCartComponent extends BaseComponent<IP
     private updatePersonalizeVisibility;
     private updateAddToCartButton;
     private getEngravingFee;
+    protected beforeConnected(): void;
     protected template(): HTMLElement[];
     private createAnimatedContentElement;
     private buildLayout;

package/dist/types/modules/product-list/components/product-list-search.component.d.ts

@@ -1,6 +1,8 @@
 import { BaseComponent } from '@/core/base-component.service';
+import type { ProductListFilterType } from '@/interfaces/injection.interface';
 export interface IProductListSearchParams {
     slug: string;
+    filters?: ProductListFilterType[];
 }
 export declare class ProductListSearchComponent extends BaseComponent<IProductListSearchParams> {
     private searchInput?;

package/dist/types/modules/product-list/product-list.component.d.ts

@@ -19,7 +19,8 @@ export declare class ProductListComponent extends BaseComponent<IProductListComp
     private unsubscribeFromState?;
     get hostClasses(): string[];
     constructor();
-    protected connected(): Promise<void>;
+    protected beforeConnected(): void;
+    protected afterRender(): void;
     disconnected(): void;
     private initializeComponent;
     private toProductArray;

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

@@ -81,9 +81,20 @@ interface IAddProductParams {
   identifier: string;      // Product UPC, SKU, or ID
   fulfillmentType: FulfillmentType;  // 'shipping' or 'onDemand'
   quantity: number;        // Number of items
+  engravingLines?: string[]; // Optional engraving (see below)
 }
 ```
 
+#### `engravingLines` (optional)
+
+Pre-fills an engraving for the added item. The SDK enforces the product's engraving rules and degrades silently rather than failing the call:
+
+- Non-string-array input is ignored (warning logged).
+- Blank/whitespace-only entries are stripped; an empty result is treated as no engraving.
+- If the product/size doesn't support engraving, lines are dropped.
+- Lines beyond `maxLines` are sliced off; any line longer than `maxCharsPerLine` is truncated.
+- If no engravable variant is available for the chosen fulfillment, lines are dropped and the item is still added.
+
 ### Example
 
 ```javascript
@@ -109,6 +120,16 @@ await window.LiquidCommerce.elements.actions.cart.addProduct([
     quantity: 1
   }
 ]);
+
+// Add a product with engraving
+await window.LiquidCommerce.elements.actions.cart.addProduct([
+  {
+    identifier: '00619947000020',
+    fulfillmentType: 'shipping',
+    quantity: 1,
+    engravingLines: ['Happy Birthday', 'Love, Sam']
+  }
+], true);
 ```
 
 ### Address Requirement

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

@@ -62,6 +62,8 @@ addProduct(params: IAddProductParams[], openCheckout?: boolean): Promise<void>
 
 Add products directly to checkout, bypassing the cart.
 
+`IAddProductParams.engravingLines?: string[]` — optional engraving. Same rules as [`actions.cart.addProduct()`](./cart-actions.md#actionscartaddproduct): invalid input is ignored, blanks stripped, lines clamped to the product's `maxLines` / `maxCharsPerLine`, and engraving is dropped (without failing) when the product, variant, or fulfillment doesn't support it.
+
 ```javascript
 await window.LiquidCommerce.elements.actions.checkout.addProduct([
   {
@@ -70,6 +72,16 @@ await window.LiquidCommerce.elements.actions.checkout.addProduct([
     quantity: 1
   }
 ], true);  // Open checkout after adding
+
+// With engraving
+await window.LiquidCommerce.elements.actions.checkout.addProduct([
+  {
+    identifier: '00619947000020',
+    fulfillmentType: 'shipping',
+    quantity: 1,
+    engravingLines: ['For Dad']
+  }
+], true);
 ```
 
 ### actions.checkout.addAnonymousProduct()

package/package.json

@@ -3,7 +3,7 @@
   "description": "LiquidCommerce Elements SDK",
   "license": "UNLICENSED",
   "author": "LiquidCommerce Team",
-  "version": "2.7.12",
+  "version": "2.7.14",
   "homepage": "https://docs.liquidcommerce.co/elements-sdk",
   "repository": {
     "type": "git",
@@ -77,9 +77,9 @@
     "embeddable commerce"
   ],
   "devDependencies": {
-    "@biomejs/biome": "^2.4.12",
-    "@commitlint/cli": "^20.5.0",
-    "@commitlint/config-conventional": "^20.5.0",
+    "@biomejs/biome": "^2.4.13",
+    "@commitlint/cli": "^20.5.3",
+    "@commitlint/config-conventional": "^20.5.3",
     "@rollup/plugin-alias": "^6.0.0",
     "@rollup/plugin-commonjs": "^29.0.2",
     "@rollup/plugin-json": "^6.1.0",
@@ -97,7 +97,7 @@
     "conventional-changelog": "^7.2.0",
     "husky": "^9.1.7",
     "process": "^0.11.10",
-    "rollup": "^4.60.1",
+    "rollup": "^4.60.2",
     "rollup-obfuscator": "^4.1.1",
     "rollup-plugin-typescript2": "^0.37.0",
     "semantic-release": "^25.0.3",