@liquidcommerce/elements-sdk 2.5.6-beta.2 → 2.5.6-beta.4

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

@@ -42,7 +42,6 @@ export declare class AuthService {
     private constructor();
     static getInstance(config: IAuthConfig): AuthService;
     authenticate(): Promise<boolean>;
-    private requestWithoutAuth;
     isTokenExpired(): boolean;
     private request;
     private buildUrl;

package/dist/types/core/telemetry/telemetry.interface.d.ts

@@ -55,8 +55,8 @@ export interface ITelemetryComponentContext {
 }
 export interface ITelemetryUserContext {
     deviceId: string;
-    sessionId?: string;
     isLocalStorageAvailable: boolean;
+    selectedAddress?: string;
 }
 export interface ITelemetryBrowserContext {
     userAgent: string;

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

@@ -4,6 +4,7 @@ export declare class TelemetryService {
     private eventQueue;
     private batchTimer;
     private readonly clientConfig;
+    private readonly store;
     private stats;
     private isShuttingDown;
     constructor();

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

@@ -66,7 +66,9 @@ export interface ILiquidCommerceElementsUIMethod {
     cartButton(containerId: string, showItemsCount?: boolean): void;
     floatingCartButton(showItemsCount?: boolean): void;
     cartSubtotal(elementId: string): void;
-    cartItemsCount(elementId: string): void;
+    cartItemsCount(elementId: string, options?: {
+        hideZero: boolean;
+    }): void;
 }
 export interface ILiquidCommerceElementsActions {
     product: IProductActions;

package/docs/CONFIGURATION.md

@@ -329,8 +329,16 @@ data-cart-button="below:#main-navigation"  <!-- Place below the target -->
 data-cart-button="below:main-navigation"   <!-- Also works without # prefix -->
 data-cart-button="replace:.old-cart"       <!-- Replace the target -->
 data-cart-button="inside:.header .nav"     <!-- Place inside the target (default) -->
+
+<!-- Floating cart button (no badge) -->
+data-cart-button=""                         <!-- Empty value = floating button -->
 ```
 
+**Smart Fallback Behavior:**
+- If the target element is not found, automatically falls back to floating cart button
+- If attribute is present but empty (`data-cart-button=""`), creates floating cart button without badge
+- Element IDs are automatically prefixed with `#` if needed (e.g., `header-cart` becomes `#header-cart`)
+
 #### `data-cart-badge-button`
 
 **Type:** `string`
@@ -351,8 +359,17 @@ data-cart-badge-button="above:.header .logo"      <!-- Place above the target --
 data-cart-badge-button="below:#main-navigation"  <!-- Place below the target -->
 data-cart-badge-button="replace:.old-cart"       <!-- Replace the target -->
 data-cart-badge-button="inside:.header .nav"     <!-- Place inside the target (default) -->
+
+<!-- Floating cart button with badge (default) -->
+data-cart-badge-button=""                   <!-- Empty value = floating button with badge -->
 ```
 
+**Smart Fallback Behavior:**
+- If the target element is not found, automatically falls back to floating cart button with badge
+- If attribute is present but empty (`data-cart-badge-button=""`), creates floating cart button with badge
+- Element IDs are automatically prefixed with `#` if needed
+- If neither `data-cart-button` nor `data-cart-badge-button` is provided, defaults to floating cart button with badge
+
 **Position Prefixes:**
 - `above:` - Place above the target element
 - `below:` - Place below the target element  
@@ -363,12 +380,14 @@ data-cart-badge-button="inside:.header .nav"     <!-- Place inside the target (d
 
 **Type:** flag (no value)
 
-Hide cart button completely.
+Hide cart button completely. Use this when you want to manage cart display manually via `client.actions.cart.openCart()`.
 
 ```html
 data-cart-button-hidden
 ```
 
+**Important:** When this attribute is present, the SDK will skip all cart button setup, including floating buttons. This takes precedence over `data-cart-button` and `data-cart-badge-button` attributes.
+
 ### Cart Button Examples
 
 **Simple cart button (no badge):**

package/package.json

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