@liquidcommerce/elements-sdk 2.3.0 → 2.4.1

package/README.md

@@ -683,7 +683,8 @@ const actions = window.elements.actions;
 ```js
 // Get product details
 const product = actions.product.getDetails('product-123');
-console.log(product.productName, product.price, product.isAvailable);
+console.log(product.name, product.brand, product.region, product.variety);
+console.log(product.priceInfo, product.description, product.tastingNotes);
 ```
 
 ### Address Actions
@@ -784,7 +785,7 @@ await actions.cart.removePromoCode();
 
 // Get cart details
 const cart = actions.cart.getDetails();
-console.log(cart.total, cart.items.length);
+console.log(cart.itemCount, cart.amounts.total, cart.amounts.giftCardTotal);
 
 // Reset cart
 await actions.cart.resetCart();
@@ -856,12 +857,10 @@ window.addEventListener('lce:actions.checkout_gift_card_failed', function(event)
 
 // Get checkout details (safe, non-sensitive data only)
 const checkout = actions.checkout.getDetails();
-console.log('Total:', checkout.amounts.total);
-console.log('Items:', checkout.itemCount);
-console.log('Is gift:', checkout.isGift);
-console.log('Has age verification:', checkout.hasAgeVerify);
-console.log('Has promo code:', checkout.hasPromoCode);
-console.log('Has gift cards:', checkout.hasGiftCards);
+console.log(checkout.itemCount, checkout.amounts.total, checkout.isGift);
+console.log(checkout.hasAgeVerify, checkout.hasPromoCode, checkout.hasGiftCards);
+console.log(checkout.acceptedAccountCreation, checkout.billingSameAsShipping);
+console.log(checkout.marketingPreferences);
 
 // Configure checkout options
 await actions.checkout.toggleBillingSameAsShipping(true);
@@ -877,13 +876,14 @@ The SDK emits real-time events for all user interactions. Listen to these events
 ```js
 // Listen for specific events
 window.addEventListener('lce:actions.product_add_to_cart', function(event) {
-  const product = event.detail.data;
-  console.log('Added to cart:', product.productName);
+  const data = event.detail.data;
+  console.log('Added to cart:', data.identifier);
   
   // Your custom logic here
   analytics.track('Product Added', {
-    product: product.productName,
-    price: product.price
+    identifier: data.identifier,
+    quantity: data.quantity,
+    upc: data.upc
   });
 });
 
@@ -900,7 +900,7 @@ window.elements.onAllActions((data, metadata) => {
 ### Available Events
 
 #### Product Events
-- `lce:actions.product_loaded` - Product component loaded
+- `lce:actions.product_loaded` - Product component loaded with comprehensive product details (region, country, abv, proof, age, variety, vintage, descriptions, tasting notes)
 - `lce:actions.product_add_to_cart` - Item added to cart
 - `lce:actions.product_quantity_increase` - Quantity increased
 - `lce:actions.product_quantity_decrease` - Quantity decreased
@@ -908,6 +908,7 @@ window.elements.onAllActions((data, metadata) => {
 - `lce:actions.product_fulfillment_type_changed` - Delivery method changed
 
 #### Cart Events
+- `lce:actions.cart_loaded` - Cart data loaded with complete cart information (itemCount, all amounts including giftCardTotal, detailed item data)
 - `lce:actions.cart_opened` - Cart displayed
 - `lce:actions.cart_closed` - Cart hidden
 - `lce:actions.cart_updated` - Cart contents changed
@@ -916,6 +917,7 @@ window.elements.onAllActions((data, metadata) => {
 - `lce:actions.cart_reset` - Cart cleared
 
 #### Checkout Events
+- `lce:actions.checkout_loaded` - Checkout data loaded with comprehensive details (acceptedAccountCreation, hasSubstitutionPolicy, billingSameAsShipping, marketing preferences, detailed items)
 - `lce:actions.checkout_opened` - Checkout started
 - `lce:actions.checkout_closed` - Checkout abandoned
 - `lce:actions.checkout_submit_started` - Order submission began
@@ -928,7 +930,7 @@ window.elements.onAllActions((data, metadata) => {
 - `lce:actions.address_updated` - Address information changed
 - `lce:actions.address_cleared` - Address removed
 
-See [`docs/EVENTS.md`](docs/EVENTS.md) for complete event reference with implementation examples.
+See [`docs/EVENTS.md`](docs/EVENTS.md) for complete event reference with all available fields and implementation examples.
 
 ## 🎨 Themes & Customization
 
@@ -1376,11 +1378,12 @@ The SDK uses a centralized store for all state management. Access state data via
 ```js
 // Get current cart state
 const cart = await client.actions.cart.getDetails();
-console.log(cart.items, cart.subtotal, cart.itemCount);
+console.log(cart.itemCount, cart.amounts.total, cart.amounts.giftCardTotal);
 
 // Get current checkout state
 const checkout = await client.actions.checkout.getDetails();
-console.log(checkout.total, checkout.customerInfo, checkout.isGift);
+console.log(checkout.amounts.total, checkout.isGift, checkout.acceptedAccountCreation);
+console.log(checkout.billingSameAsShipping, checkout.marketingPreferences);
 
 // Get current address
 const address = await client.actions.address.getDetails();
@@ -1388,7 +1391,8 @@ console.log(address.formattedAddress, address.coordinates);
 
 // Get product details
 const product = await client.actions.product.getDetails('00619947000020');
-console.log(product.name, product.price, product.variants);
+console.log(product.name, product.region, product.variety, product.vintage);
+console.log(product.description, product.tastingNotes);
 ```
 
 **State is persistent:** Cart and address data persist across page reloads using localStorage.
@@ -1400,8 +1404,8 @@ All SDK interactions emit events through a centralized event system:
 ```js
 // Subscribe to specific event
 window.addEventListener('lce:actions.cart_updated', (event) => {
-  const cartData = event.detail.data;
-  console.log('Cart changed:', cartData);
+  const { previous, current } = event.detail.data;
+  console.log('Cart changed from', previous.amounts.total, 'to', current.amounts.total);
 });
 
 // Subscribe to all action events
@@ -2074,7 +2078,7 @@ await client.actions.cart.addProduct([...]);
 // ❌ Don't repeatedly fetch the same data
 async function showCartTotal() {
   const cart = await client.actions.cart.getDetails();
-  return cart.total;
+  return cart.amounts.total;
 }
 
 // ✅ Use UI helpers that auto-update
@@ -2084,7 +2088,7 @@ client.ui.cartItemsCount('cart-count-display');
 // Or cache and listen to updates
 let cachedCart = await client.actions.cart.getDetails();
 window.addEventListener('lce:actions.cart_updated', (event) => {
-  cachedCart = event.detail.data;
+  cachedCart = event.detail.data.current;
 });
 ```