@liquidcommerce/elements-sdk 2.4.4 → 2.4.5

package/dist/types/core/store/store.service.d.ts

@@ -37,6 +37,7 @@ export declare class StoreService {
     private debouncedSave;
     forceSave(): void;
     persist(): Promise<void>;
+    clearLocalStorage(): void;
     private saveStore;
     private loadPersistedState;
     private loadFromDBPersistence;

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

@@ -14,6 +14,8 @@ export interface IProductLayout {
     addToCartButtonShowTotalPrice: boolean;
     buyNowButtonText: string;
     preSaleButtonText: string;
+    prioritizeEngraving: boolean;
+    noAvailabilityText: string;
 }
 export interface IProductTheme {
     backgroundColor: string;

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

@@ -12,6 +12,7 @@ export declare class ApiClientService {
     getAllConfigs(): Promise<IAllConfigs>;
     setPersistedStore(userDeviceId: string, data: IPersistedStore): Promise<void>;
     getPersistedStore(userDeviceId: string): Promise<IPersistedStore | null>;
+    deletePersistedStore(userDeviceId: string): Promise<void>;
     getProductsData(identifier: string[], location?: ILoc): Promise<IProductData | null>;
     getCartData(id: string | null): Promise<ICart>;
     updateCart(params: ICartUpdateParams & {

package/docs/ACTIONS.md

@@ -212,6 +212,33 @@ if (address) {
 actions.address.clear();
 ```
 
+**Complete Reset Behavior:**
+The `actions.address.clear()` action performs a comprehensive reset of the user's address and shopping session:
+
+**What gets cleared:**
+- ✅ **Address Data**: All saved address information (street, city, state, zip, coordinates, Places ID)
+- ✅ **Cart Contents**: Complete cart reset (removes all items, totals, promo codes, retailers)
+- ✅ **Local Storage**: Completely removes the localStorage entry and its value
+- ✅ **Database**: Deletes the persisted store from the server database
+- ✅ **Checkout State**: Resets any pending checkout information
+
+**Why the cart is reset:**
+When an address is cleared, the cart must be reset because:
+- Cart items have location-specific pricing and availability
+- Fulfillment options are tied to specific addresses  
+- Delivery fees and shipping costs depend on location
+- Without a valid address, cart operations would fail or show incorrect data
+
+**Events fired:**
+- `lce:actions.address_cleared` - Address successfully cleared
+- `lce:actions.cart_reset` - Cart successfully reset
+
+**Use cases:**
+- Guest checkout option (clear previous user's data)
+- Location change (start fresh with new address)
+- Privacy compliance (complete data removal)
+- Testing/development (reset to clean state)
+
 **Real Business Uses:**
 - **One-Click Address**: Let customers select from saved Google Places
 - **Custom Address Forms**: Build your own address input forms with full control

package/docs/TROUBLESHOOTING.md

@@ -2,6 +2,27 @@
 
 Common issues and solutions for the LiquidCommerce Elements SDK.
 
+## Address Management Issues
+
+### Address Clear Behavior
+
+**Question:** What happens when I call `actions.address.clear()`?
+
+**Answer:** The `actions.address.clear()` action performs a comprehensive reset:
+
+- ✅ **Address Data**: Removes all saved address information
+- ✅ **Cart Contents**: Completely resets the cart (removes all items, totals, promo codes)
+- ✅ **Local Storage**: Completely removes the localStorage entry and its value
+- ✅ **Database**: Deletes the persisted store from the server database
+- ✅ **Checkout State**: Resets any pending checkout information
+
+**Why does it reset the cart?**
+Cart items have location-specific pricing, availability, and fulfillment options. Without a valid address, cart operations would fail or show incorrect data. The reset ensures data integrity.
+
+**Events fired:**
+- `lce:actions.address_cleared` - Address successfully cleared
+- `lce:actions.cart_reset` - Cart successfully reset
+
 ## SDK Initialization Issues
 
 ### SDK Not Loading

package/package.json

@@ -3,7 +3,7 @@
   "description": "LiquidCommerce Elements SDK",
   "license": "UNLICENSED",
   "author": "LiquidCommerce Team",
-  "version": "2.4.4",
+  "version": "2.4.5",
   "homepage": "https://docs.liquidcommerce.co/elements-sdk",
   "repository": {
     "type": "git",