@liquidcommerce/elements-sdk 2.7.9 → 2.7.11

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

@@ -1,4 +1,5 @@
 import { type ComponentType } from '@/enums';
+export declare function applyConfigDefaults<T extends Record<string, any>>(data: T): T;
 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[]>;

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

@@ -86,6 +86,7 @@ export interface ICart {
 }
 export interface ICartItemEngraving {
     isEngravable: boolean;
+    isRequired: boolean;
     hasEngraving: boolean;
     fee: number;
     maxCharsPerLine: number;

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

@@ -146,6 +146,7 @@ export interface ICheckoutShippingAddress {
 }
 export interface ICheckoutItemEngraving {
     isEngravable: boolean;
+    isRequired: boolean;
     hasEngraving: boolean;
     fee: number;
     maxCharsPerLine: number;

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

@@ -98,6 +98,7 @@ export interface IProductSizeEngraving {
     maxCharsPerLine: number;
     fee: number;
     location: string;
+    isRequired: boolean;
 }
 export interface IProductSizeAttributes {
     presale: IProductPresale;

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

@@ -1,10 +1,12 @@
 import type { DeepPartial } from '@/interfaces/config.interface';
 export type FulfillmentDisplayType = 'carousel' | 'popup';
+export type DescriptionPosition = 'above' | 'below';
 export interface IProductLayout {
     showImages: boolean;
     showOnlyMainImage: boolean;
     showTitle: boolean;
     showDescription: boolean;
+    descriptionPosition: DescriptionPosition;
     showQuantityCounter: boolean;
     showOffHours: boolean;
     quantityCounterStyle: 'outlined' | 'ghost';

package/dist/types/modules/product/components/product-add-to-cart-section.component.d.ts

@@ -21,6 +21,7 @@ export declare class ProductAddToCartSectionComponent extends BaseComponent<IAdd
     private calculateTotalPrice;
     private createQuantityContainer;
     private getSizeAttributes;
+    private openEngravingForm;
     private isPresaleActive;
     private createAddToCartButton;
     protected template(): HTMLElement[] | string;

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

@@ -1,6 +1,7 @@
 import { BaseComponent } from '@/core/base-component.service';
 export interface IProductDescriptionComponentParams {
     productId: string;
+    hideTitle?: boolean;
 }
 export declare class ProductDescriptionComponent extends BaseComponent<IProductDescriptionComponentParams, null> {
     get hostClasses(): string[];

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

@@ -8,5 +8,6 @@ export declare class ProductOptionsComponent extends BaseComponent<IProductOptio
     constructor();
     private getProductId;
     onStoreWatch(changes: IOnStoreChanged[]): void;
-    protected template(): HTMLElement;
+    protected template(): HTMLElement | HTMLElement[];
+    private buildDescriptionElement;
 }

package/dist/types/modules/ui-components/engraving/engraving-view.component.d.ts

@@ -12,6 +12,7 @@ export declare class EngravingViewComponent extends BaseComponent<IEngravingView
     get hostClasses(): string[];
     private engravingQuantityFee;
     private engravingLines;
+    private isEngravingRequired;
     private handleEdit;
     private handleRemove;
     protected template(): HTMLElement | HTMLElement[] | string;

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

@@ -72,6 +72,25 @@ await window.LiquidCommerce.elements.actions.checkout.addProduct([
 ], true);  // Open checkout after adding
 ```
 
+### actions.checkout.addAnonymousProduct()
+
+```typescript
+addAnonymousProduct(
+  params: IAnonymousCheckoutAddProductParams
+): Promise<IAnonymousCheckoutAddProductResponse>
+```
+
+Add a product to checkout without requiring a cart session. Used for direct-to-checkout flows.
+
+```javascript
+const result = await window.LiquidCommerce.elements.actions.checkout
+  .addAnonymousProduct({
+    identifier: '00619947000020',
+    fulfillmentType: 'shipping',
+    quantity: 1
+  });
+```
+
 ## Promo & Gift Card Actions
 
 ### actions.checkout.applyPromoCode()
@@ -299,6 +318,27 @@ interface ICheckoutDetailsEventData {
 }
 ```
 
+### actions.checkout.getProductAvailabilityByState()
+
+```typescript
+getProductAvailabilityByState(
+  identifiers: string[],
+  state?: string
+): Promise<IProductAvailabilityResponse>
+```
+
+Check product availability across states from the checkout context.
+
+```javascript
+const availability = await window.LiquidCommerce.elements.actions.checkout
+  .getProductAvailabilityByState(['00619947000020'], 'CA');
+```
+
+| Parameter     | Type     | Required | Description                          |
+|---------------|----------|----------|--------------------------------------|
+| `identifiers` | string[] | Yes      | Array of product UPCs, SKUs, or IDs  |
+| `state`       | string   | No       | Two-letter state code (e.g., `'NY'`) |
+
 ## Use Cases
 
 ### Pre-fill for Logged-In Users

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

@@ -102,10 +102,53 @@ if (product1.price < product2.price) {
 }
 ```
 
+---
+
+## actions.product.getProductAvailabilityByState()
+
+Check product availability across states.
+
+### Signature
+
+```typescript
+getProductAvailabilityByState(
+  identifiers: string[],
+  state?: string
+): Promise<IProductAvailabilityResponse>
+```
+
+### Parameters
+
+| Parameter     | Type     | Required | Description                              |
+|---------------|----------|----------|------------------------------------------|
+| `identifiers` | string[] | Yes      | Array of product UPCs, SKUs, or IDs      |
+| `state`       | string   | No       | Two-letter state code (e.g., `'NY'`)     |
+
+### Example
+
+```javascript
+// Check availability in a specific state
+const availability = await window.LiquidCommerce.elements.actions.product
+  .getProductAvailabilityByState(['00619947000020', '08504405135'], 'CA');
+
+// Check availability in the user's current state (uses address if set)
+const availability = await window.LiquidCommerce.elements.actions.product
+  .getProductAvailabilityByState(['00619947000020']);
+```
+
+### Errors
+
+**Throws `SDKError` if:**
+- No identifiers provided or array is empty
+- API request fails
+
+---
+
 ## Notes
 
 - Product must be injected and loaded before calling `getDetails()`
-- Data is synchronous - returns immediately
+- `getDetails()` is synchronous - returns immediately
+- `getProductAvailabilityByState()` is async - returns a Promise
 - Prices are always in cents (divide by 100 for dollars)
 - Selected values reflect current user selection in the component
 

package/docs/v1/api/client.md

@@ -112,6 +112,7 @@ interface IClientCustomThemeConfig {
   address?: UpdateAddressComponent;
   cart?: UpdateCartComponent;
   checkout?: UpdateCheckoutComponent;
+  productList?: UpdateProductListComponent;
 }
 ```
 
@@ -260,6 +261,9 @@ interface ILiquidCommerceElementsClient {
 
   // Component management
   getInjectedComponents(): Map<string, IInjectedComponent>;
+
+  // Cleanup
+  destroy(): void;
 }
 ```
 
@@ -308,6 +312,15 @@ const productComponent = components.get('product-1');
 productComponent.getType();      // 'product'
 productComponent.getElement();   // <div id="product-1">...</div>
 productComponent.rerender();     // Force rerender
+productComponent.destroy();      // Remove from DOM and clean up
+```
+
+### destroy()
+
+Remove the client and all injected components, cleaning up event listeners and internal state.
+
+```javascript
+client.destroy();
 ```
 
 ## Error Handling