@liquidcommerce/elements-sdk 2.7.8 → 2.7.10

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

@@ -4,5 +4,5 @@ import { DEBUG_MODE, ELEMENTS_ENV } from '@/enums';
 import type { IElementsCheckoutActions, IElementsCheckoutClient } from '@/interfaces/client.interface';
 import type { IInjectedComponent } from '@/interfaces/component.interface';
 import type { ILiquidCommerceElementsCheckoutClientConfig } from '@/interfaces/config.interface';
-export { DEBUG_MODE, ELEMENTS_ENV, ElementsCheckout };
 export type { DebugMode, ElementsEnv, IElementsCheckoutActions, IElementsCheckoutClient, IInjectedComponent, ILiquidCommerceElementsCheckoutClientConfig, };
+export { DEBUG_MODE, ELEMENTS_ENV, ElementsCheckout };

package/dist/types/index.checkout.umd.d.ts

@@ -1,4 +1,4 @@
 import type { IElementsCheckoutActions, IElementsCheckoutClient } from '@/interfaces/client.interface';
 import { ElementsCheckout } from './clients/checkout';
-export { ElementsCheckout };
 export type { IElementsCheckoutActions, IElementsCheckoutClient };
+export { ElementsCheckout };

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/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-list/components/product-list-product-pre-cart.component.d.ts

@@ -31,10 +31,13 @@ export declare class ProductListProductPreCartComponent extends BaseComponent<IP
     private updateAddToCartButton;
     private getEngravingFee;
     protected template(): HTMLElement[];
+    private createAnimatedContentElement;
+    private buildLayout;
     private createEngravingFormContent;
     private renderPreCartContent;
     private createDeliversToSectionWrapper;
     private createShippingFromSectionWrapper;
+    private createDescriptionSection;
     private createCartHeader;
     private createImageSection;
     private createPricePersonalizationSection;

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

@@ -31,7 +31,6 @@ export declare class ProductListComponent extends BaseComponent<IProductListComp
     private renderLoadingState;
     private renderProducts;
     private appendNewProducts;
-    private getResponsiveColumns;
     private setupInfiniteScroll;
     private createScrollSentinel;
     private updateSentinel;

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/README.md

@@ -108,7 +108,7 @@ Practical examples with working code:
   data-container-1="product"
   data-product-1="00619947000020"
   type="text/javascript"
-  src="https://assets-elements.liquidcommerce.us/all/elements.js"
+  src="https://elements.reservebar-worker.workers.dev/all/elements.js"
 ></script>
 
 <div id="product"></div>

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