@liquidcommerce/elements-sdk 2.2.2 → 2.4.0

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

@@ -4,6 +4,11 @@ export interface IAuthConfig {
     env: ElementsEnv;
     baseUrl: string;
 }
+export interface IHttpRequestOptions {
+    headers?: Record<string, string>;
+    body?: any;
+    critical?: boolean;
+}
 export declare class AuthService {
     private readonly apiKey;
     private readonly baseUrl;
@@ -14,6 +19,7 @@ export declare class AuthService {
     private readonly httpClient;
     private readonly logger;
     private readonly clientConfig;
+    private readonly circuitBreaker;
     private constructor();
     static getInstance(config: IAuthConfig): AuthService;
     authenticate(): Promise<boolean>;
@@ -22,8 +28,8 @@ export declare class AuthService {
     private request;
     private buildUrl;
     private getProxyHeaders;
-    get<T = any>(path: string, headers?: Record<string, string>): Promise<T>;
-    post<T = any>(path: string, body?: any, headers?: Record<string, string>): Promise<T>;
-    put<T = any>(path: string, body?: any, headers?: Record<string, string>): Promise<T>;
-    delete<T = any>(path: string, headers?: Record<string, string>): Promise<T>;
+    get<T = any>(path: string, options?: IHttpRequestOptions): Promise<T>;
+    post<T = any>(path: string, options?: IHttpRequestOptions): Promise<T>;
+    put<T = any>(path: string, options?: IHttpRequestOptions): Promise<T>;
+    delete<T = any>(path: string, options?: IHttpRequestOptions): Promise<T>;
 }

package/dist/types/core/base-component.service.d.ts

@@ -2,6 +2,7 @@ import { ClientConfigService } from '@/core/client/client-config.service';
 import { LoggerFactory } from '@/core/logger/logger-factory';
 import { PubSubService } from '@/core/pubsub';
 import { type StorePaths, StoreService } from '@/core/store';
+import { TelemetryService } from '@/core/telemetry/telemetry.service';
 import type { ComponentType } from '@/enums';
 import type { ConfigsKeyType, ConfigsType } from '@/interfaces/configs';
 import { ThemeProviderService } from '@/modules/theme-provider';
@@ -30,6 +31,7 @@ export declare abstract class BaseComponent<TParams = Record<string, any>, TConf
     protected readonly pubSub: PubSubService;
     protected readonly logger: ReturnType<typeof LoggerFactory.get>;
     protected readonly clientConfig: ClientConfigService;
+    protected readonly telemetry: TelemetryService;
     private initialized;
     private isDestroyed;
     private renderScheduled;
@@ -65,6 +67,7 @@ export declare abstract class BaseComponent<TParams = Record<string, any>, TConf
     private render;
     private logRenderInfo;
     protected rerender(context?: string): void;
+    private captureComponentError;
     private updateHostClasses;
     addHostClasses(...classes: string[]): void;
     removeHostClasses(...classes: string[]): void;

package/dist/types/core/circuit-breaker.service.d.ts

@@ -0,0 +1,54 @@
+export declare enum CircuitBreakerState {
+    CLOSED = "CLOSED",
+    OPEN = "OPEN",
+    HALF_OPEN = "HALF_OPEN"
+}
+export interface ICircuitBreakerConfig {
+    failureThreshold: number;
+    recoveryTimeout: number;
+    halfOpenMaxCalls: number;
+    successThreshold: number;
+    timeout: number;
+    countClientErrorsAsFailures: boolean;
+}
+export interface ICircuitBreakerStats {
+    state: CircuitBreakerState;
+    failures: number;
+    successes: number;
+    totalCalls: number;
+    rejectedCalls: number;
+    lastFailureTime: number | null;
+    lastSuccessTime: number | null;
+    isHealthy: boolean;
+}
+export interface ICircuitBreakerExecuteOptions {
+    critical?: boolean;
+    fallback?: () => any | Promise<any>;
+}
+export declare class CircuitBreakerService {
+    private state;
+    private failures;
+    private successes;
+    private totalCalls;
+    private rejectedCalls;
+    private lastFailureTime;
+    private lastSuccessTime;
+    private halfOpenCallsInProgress;
+    private nextAttemptTime;
+    private readonly config;
+    private readonly logger;
+    constructor(config?: Partial<ICircuitBreakerConfig>);
+    static getInstance(config?: Partial<ICircuitBreakerConfig>): CircuitBreakerService;
+    execute<T>(fn: () => Promise<T>, context?: string, options?: ICircuitBreakerExecuteOptions): Promise<T>;
+    executeWithFallback<T>(fn: () => Promise<T>, fallback: () => T | Promise<T>, context?: string, critical?: boolean): Promise<T>;
+    getStats(): ICircuitBreakerStats;
+    reset(): void;
+    forceOpen(context?: string): void;
+    forceClose(context?: string): void;
+    private executeWithTimeout;
+    private onSuccess;
+    private onFailure;
+    private openCircuit;
+    private halfOpenCircuit;
+    private closeCircuit;
+}

package/dist/types/core/client/client-action.service.d.ts

@@ -9,18 +9,19 @@ export interface IProductActions {
 export interface IAddressActions {
     setAddressByPlacesId: (placesId: string) => Promise<void>;
     setAddressManually: (address: Omit<IAddress, 'id'>, coordinates: ICoords) => Promise<void>;
-    clear: () => void;
+    clear: () => Promise<void>;
     getDetails: () => IAddressData | null;
 }
+export interface IAddProductParams {
+    identifier: string;
+    fulfillmentType: FulfillmentType;
+    quantity: number;
+}
 export interface ICartActions {
     openCart: () => void;
     closeCart: () => void;
     toggleCart: () => void;
-    addProduct: (params: Array<{
-        identifier: string;
-        fulfillmentType: FulfillmentType;
-        quantity: number;
-    }>, openCart?: boolean) => Promise<void>;
+    addProduct: (params: IAddProductParams[], openCart?: boolean) => Promise<void>;
     applyPromoCode: (promoCode: string) => Promise<void>;
     removePromoCode: () => Promise<void>;
     resetCart: () => Promise<void>;
@@ -30,11 +31,7 @@ export interface ICheckoutActions {
     openCheckout: () => void;
     closeCheckout: () => void;
     toggleCheckout: () => void;
-    addProduct: (params: Array<{
-        identifier: string;
-        fulfillmentType: FulfillmentType;
-        quantity: number;
-    }>, openCheckout?: boolean) => Promise<void>;
+    addProduct: (params: IAddProductParams[], openCheckout?: boolean) => Promise<void>;
     applyPromoCode: (promoCode: string) => Promise<void>;
     removePromoCode: () => Promise<void>;
     applyGiftCard: (code: string) => Promise<void>;
@@ -54,8 +51,13 @@ export declare class ClientActionService {
     private readonly api;
     private readonly themeProvider;
     private readonly logger;
+    private pendingCartParams;
+    private pendingCartOpenFlag;
     constructor();
     static getInstance(): ClientActionService;
+    private setupAddressUpdateListener;
+    private retryPendingCartOperation;
+    private clearPendingCartOperation;
     private getLocation;
     private productActions;
     private addressActions;

package/dist/types/core/client/client-config.service.d.ts

@@ -1,4 +1,4 @@
-import { type ElementsEnv } from '@/enums';
+import { type DebugMode, type ElementsEnv } from '@/enums';
 import type { IPromoTicker } from '@/interfaces/configs';
 import type { IClientCustomThemeConfig, IElementsProxyConfig } from '@/interfaces/core.interface';
 export type DeviceType = 'desktop' | 'tablet' | 'mobile';
@@ -6,8 +6,9 @@ export interface IClientConfigs {
     apiKey: string;
     env: ElementsEnv;
     isBuilder: boolean;
-    enableDebugging: boolean;
+    debugMode: DebugMode;
     baseUrl: string;
+    partnerCode?: string;
     customTheme: IClientCustomThemeConfig | null;
     proxy: IElementsProxyConfig | null;
     deviceType: DeviceType;
@@ -20,7 +21,7 @@ export interface IClientConfigs {
 export interface IClientConfigInput {
     env?: ElementsEnv;
     isBuilder?: boolean;
-    enableDebugging?: boolean;
+    debugMode?: DebugMode;
     customTheme?: IClientCustomThemeConfig;
     proxy?: IElementsProxyConfig;
     promoTicker?: IPromoTicker[];
@@ -37,6 +38,7 @@ export declare class ClientConfigService {
     isProduction(): boolean;
     isBuilder(): boolean;
     isDebuggingEnabled(): boolean;
+    isDebugPanelEnabled(): boolean;
     debuggingDisabled(): boolean;
     hasCustomTheme(): boolean;
     isMobile(): boolean;

package/dist/types/core/command/common-command.service.d.ts

@@ -1,6 +1,7 @@
+import type { ICart } from '@/interfaces/cloud';
 import { BaseCommand } from './base-command.service';
 export declare class CommonCommands extends BaseCommand {
     static getInstance(): CommonCommands;
+    syncCartFromResponse(cartApi: ICart, publishEvent?: boolean): void;
     loadCart(): Promise<void>;
-    private persistSessionData;
 }

package/dist/types/core/debug-panel/debug-panel.service.d.ts

@@ -0,0 +1,43 @@
+export interface IDebugLogEntry {
+    id: string;
+    timestamp: number;
+    type: 'event' | 'gtm' | 'logger';
+    level: 'debug' | 'info' | 'warn' | 'error';
+    message: string;
+    data?: any;
+    context?: string;
+}
+export declare class DebugPanelService {
+    private panelElement;
+    private panelContainer;
+    private floatingButton;
+    private logContainer;
+    private logs;
+    private isVisible;
+    private showEvents;
+    private showGtmEvents;
+    private showLogs;
+    static getInstance(): DebugPanelService;
+    initialize(): void;
+    toggleVisibility(): void;
+    destroy(): void;
+    private interceptLoggerService;
+    private interceptLoggerInstance;
+    private interceptPubSubEvents;
+    private interceptGtmEvents;
+    private addLogEntry;
+    private renderLogs;
+    private clearLogs;
+    private createPanel;
+    private createPanelContent;
+    private createHeader;
+    private createToggles;
+    private createResizeHandle;
+    private setupShadowEventListeners;
+    private createFloatingButton;
+    private showPanelContent;
+    private hidePanelContent;
+    private createLogElement;
+    private formatJsonData;
+    private escapeHtml;
+}

package/dist/types/core/debug-panel/debug-panel.styles.d.ts

@@ -0,0 +1 @@
+export declare const DEBUG_PANEL_STYLES = "\n  :host {\n    position: fixed;\n    z-index: 2147483647;\n    display: block;\n  }\n\n  .panel {\n    position: relative;\n    background: rgba(15, 23, 42, 0.95);\n    backdrop-filter: blur(10px);\n    border: 1px solid rgba(148, 163, 184, 0.2);\n    border-radius: 12px;\n    box-shadow: 0 25px 50px -12px rgba(0, 0, 0, 0.25);\n    font-family: 'SF Mono', 'Monaco', 'Inconsolata', 'Roboto Mono', monospace;\n    font-size: 12px;\n    color: #e2e8f0;\n    display: flex;\n    flex-direction: column;\n    overflow: hidden;\n    user-select: none;\n    transition: all 0.2s ease;\n    width: 100%;\n    height: 100%;\n  }\n\n  .panel:hover {\n    border-color: rgba(148, 163, 184, 0.4);\n    box-shadow: 0 25px 50px -12px rgba(0, 0, 0, 0.4);\n  }\n\n  .header {\n    display: flex;\n    align-items: center;\n    justify-content: space-between;\n    padding: 12px 16px;\n    border-bottom: 1px solid rgba(148, 163, 184, 0.2);\n    background: rgba(30, 41, 59, 0.5);\n    cursor: move;\n  }\n\n  .icon {\n    font-size: 14px;\n    display: flex;\n    align-items: center;\n    justify-content: center;\n    min-width: 20px;\n  }\n\n  .title-container {\n    display: flex;\n    flex-direction: column;\n    gap: 2px;\n    flex: 1;\n    margin: 0 12px;\n  }\n\n  .title {\n    font-weight: 600;\n    color: #f1f5f9;\n    font-size: 13px;\n  }\n\n\n  .subtitle {\n    font-size: 10px;\n    color: #94a3b8;\n  }\n\n  .minimize {\n    background: none;\n    border: none;\n    color: #94a3b8;\n    font-size: 18px;\n    cursor: pointer;\n    padding: 4px;\n    border-radius: 4px;\n    transition: all 0.2s ease;\n    line-height: 1;\n    font-weight: bold;\n  }\n\n  .minimize:hover {\n    background: rgba(148, 163, 184, 0.1);\n    color: #cbd5e1;\n  }\n\n  .toggles {\n    display: flex;\n    gap: 12px;\n    padding: 8px 16px;\n    border-bottom: 1px solid rgba(148, 163, 184, 0.2);\n    background: rgba(30, 41, 59, 0.3);\n    align-items: center;\n  }\n\n  .toggle {\n    display: flex;\n    align-items: center;\n    gap: 6px;\n    cursor: pointer;\n    font-size: 11px;\n    color: #cbd5e1;\n    transition: color 0.2s ease;\n  }\n\n  .toggle:hover {\n    color: #f1f5f9;\n  }\n\n  .toggle input[type=\"checkbox\"] {\n    width: 12px;\n    height: 12px;\n    accent-color: #3b82f6;\n    cursor: pointer;\n  }\n\n  .clear-btn {\n    background: none;\n    border: none;\n    color: #ef4444;\n    font-size: 14px;\n    padding: 0;\n    cursor: pointer;\n    transition: all 0.2s ease;\n    margin-left: auto;\n    min-width: 20px;\n    height: 20px;\n    display: flex;\n    align-items: center;\n    justify-content: center;\n  }\n\n  .clear-btn:hover {\n    transform: scale(1.1);\n    color: #dc2626;\n  }\n\n  .logs {\n    flex: 1;\n    overflow-y: auto;\n    overflow-x: hidden;\n    padding: 8px;\n    background: rgba(15, 23, 42, 0.8);\n    min-height: 0;\n    max-height: 100%;\n  }\n\n  .log-entry {\n    display: flex;\n    align-items: flex-start;\n    gap: 8px;\n    padding: 8px 12px;\n    margin-bottom: 2px;\n    border-radius: 6px;\n    font-size: 11px;\n    line-height: 1.4;\n    transition: background-color 0.2s ease;\n    user-select: text;\n  }\n\n  .log-entry:hover {\n    background-color: rgba(148, 163, 184, 0.1);\n  }\n\n  /* Event type background colors */\n  .log-entry.event {\n    background: rgba(59, 130, 246, 0.1);\n  }\n\n  .log-entry.action {\n    background: rgba(16, 185, 129, 0.1);\n  }\n\n  .log-entry.gtm {\n    background: rgba(245, 158, 11, 0.1);\n  }\n\n  .log-entry.logger {\n    background: rgba(139, 92, 246, 0.1);\n  }\n\n\n  .log-meta {\n    display: flex;\n    flex-direction: column;\n    align-items: flex-start;\n    gap: 2px;\n    min-width: 50px;\n  }\n\n  .log-type {\n    font-weight: 600;\n    font-size: 9px;\n    padding: 2px 0;\n    border-radius: 3px;\n    white-space: nowrap;\n    text-align: center;\n    line-height: 1;\n    font-weight: bold;\n    letter-spacing: 0.5px;\n  }\n\n  .log-timestamp {\n    color: #64748b;\n    font-size: 9px;\n    white-space: nowrap;\n    line-height: 1;\n  }\n\n  .log-type.event {\n    background: rgba(59, 130, 246, 0.2);\n    color: #60a5fa;\n  }\n\n  .log-type.action {\n    color: #34d399;\n  }\n\n  .log-type.gtm {\n    color: #fbbf24;\n  }\n\n  .log-type.logger {\n    color: #a78bfa;\n  }\n\n  .log-message {\n    flex: 1;\n    word-break: break-word;\n    user-select: text;\n  }\n\n  .log-context {\n    color: #94a3b8;\n    font-size: 10px;\n    margin-top: 2px;\n    font-style: italic;\n  }\n\n  .log-data {\n    background: rgba(30, 41, 59, 0.6);\n    border: 1px solid rgba(148, 163, 184, 0.2);\n    border-radius: 4px;\n    padding: 8px;\n    margin-top: 6px;\n    font-size: 10px;\n    color: #cbd5e1;\n    max-height: 120px;\n    overflow-y: auto;\n    font-family: 'SF Mono', 'Monaco', 'Inconsolata', 'Roboto Mono', monospace;\n    user-select: text;\n  }\n\n  .log-data pre {\n    margin: 0;\n    white-space: pre-wrap;\n    word-break: break-word;\n  }\n\n  .resize-handle {\n    position: absolute;\n    bottom: 0;\n    right: 0;\n    width: 12px;\n    height: 12px;\n    background: linear-gradient(-45deg, transparent 30%, rgba(148, 163, 184, 0.3) 30%, rgba(148, 163, 184, 0.3) 70%, transparent 70%);\n    cursor: nw-resize;\n    border-radius: 0 0 12px 0;\n  }\n\n  .resize-handle:hover {\n    background: linear-gradient(-45deg, transparent 30%, rgba(148, 163, 184, 0.7) 30%, rgba(148, 163, 184, 0.7) 70%, transparent 70%);\n    transform: scale(1.1);\n  }\n\n  .resize-handle:active {\n    background: linear-gradient(-45deg, transparent 30%, rgba(148, 163, 184, 0.9) 30%, rgba(148, 163, 184, 0.9) 70%, transparent 70%);\n  }\n\n  /* Scrollbar styling */\n  .logs::-webkit-scrollbar {\n    width: 6px;\n  }\n\n  .logs::-webkit-scrollbar-track {\n    background: rgba(30, 41, 59, 0.3);\n    border-radius: 3px;\n  }\n\n  .logs::-webkit-scrollbar-thumb {\n    background: rgba(148, 163, 184, 0.3);\n    border-radius: 3px;\n  }\n\n  .logs::-webkit-scrollbar-thumb:hover {\n    background: rgba(148, 163, 184, 0.5);\n  }\n\n  .log-data::-webkit-scrollbar {\n    width: 4px;\n  }\n\n  .log-data::-webkit-scrollbar-track {\n    background: rgba(30, 41, 59, 0.3);\n    border-radius: 2px;\n  }\n\n  .log-data::-webkit-scrollbar-thumb {\n    background: rgba(148, 163, 184, 0.3);\n    border-radius: 2px;\n  }\n\n  .log-data::-webkit-scrollbar-thumb:hover {\n    background: rgba(148, 163, 184, 0.5);\n  }\n\n  /* Floating button styles */\n  .floating-btn {\n    position: absolute;\n    top: 20px;\n    left: 20px;\n    width: 40px;\n    height: 40px;\n    background: rgba(15, 23, 42, 0.95);\n    border: 1px solid rgba(148, 163, 184, 0.2);\n    border-radius: 50%;\n    display: none;\n    align-items: center;\n    justify-content: center;\n    cursor: pointer;\n    font-size: 18px;\n    user-select: none;\n    z-index: 1;\n  }\n\n  .floating-btn:hover {\n    background: rgba(30, 41, 59, 0.95);\n    border-color: rgba(148, 163, 184, 0.4);\n  }\n\n  /* Mobile Responsiveness */\n  @media (max-width: 768px) {\n    .panel {\n      font-size: 11px;\n      border-radius: 8px;\n    }\n\n    .header {\n      padding: 8px 12px;\n    }\n\n    .title {\n      font-size: 12px;\n    }\n\n    .subtitle {\n      font-size: 9px;\n    }\n\n    .toggles {\n      padding: 6px 12px;\n      gap: 8px;\n      flex-wrap: wrap;\n    }\n\n    .toggle {\n      font-size: 10px;\n    }\n\n    .toggle input[type=\"checkbox\"] {\n      width: 10px;\n      height: 10px;\n    }\n\n    .logs {\n      padding: 6px;\n    }\n\n    .log-entry {\n      padding: 6px 8px;\n      font-size: 10px;\n    }\n\n    .log-type {\n      font-size: 8px;\n    }\n\n    .log-timestamp {\n      font-size: 8px;\n    }\n\n    .log-data {\n      font-size: 9px;\n      padding: 6px;\n      max-height: 80px;\n    }\n\n    .floating-btn {\n      width: 36px;\n      height: 36px;\n      font-size: 16px;\n      top: 15px;\n      left: 15px;\n    }\n  }\n\n  @media (max-width: 480px) {\n    .panel {\n      font-size: 10px;\n      border-radius: 6px;\n    }\n\n    .header {\n      padding: 6px 10px;\n    }\n\n    .title {\n      font-size: 11px;\n    }\n\n    .subtitle {\n      font-size: 8px;\n    }\n\n    .toggles {\n      padding: 4px 10px;\n      gap: 6px;\n    }\n\n    .toggle {\n      font-size: 9px;\n    }\n\n    .logs {\n      padding: 4px;\n    }\n\n    .log-entry {\n      padding: 4px 6px;\n      font-size: 9px;\n      gap: 4px;\n    }\n\n    .log-meta {\n      min-width: 40px;\n    }\n\n    .log-type {\n      font-size: 7px;\n    }\n\n    .log-timestamp {\n      font-size: 7px;\n    }\n\n    .log-data {\n      font-size: 8px;\n      padding: 4px;\n      max-height: 60px;\n    }\n\n    .floating-btn {\n      width: 32px;\n      height: 32px;\n      font-size: 14px;\n      top: 10px;\n      left: 10px;\n    }\n  }\n";

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

@@ -1,17 +1,15 @@
 interface FingerprintData {
     screen: string;
-    webgl: string;
-    canvas: string;
     browser: string;
     timezone: string;
-    audio: string;
 }
 export declare class FingerPrintService {
     private readonly keyPrefix;
     private isLocalStorageAvailable;
+    private cachedFingerprint;
     static getInstance(): FingerPrintService;
     getId(partnerCode: string): Promise<string>;
-    getFingerprintData(): Promise<FingerprintData>;
+    getFingerprintData(): FingerprintData;
     isLocalStorageWebApiAvailable(): boolean;
     private _createComposedId;
     private _checkLocalStorageAvailability;
@@ -19,13 +17,10 @@ export declare class FingerPrintService {
     private _generateFingerprint;
     private _getScreen;
     private _getColorGamut;
-    private _getWebGL;
-    private _getCanvas;
     private _getBrowser;
     private _getBrowserEngine;
+    private _isWebView;
     private _getTimezone;
-    private _getAudioFingerprint;
-    private _hash;
-    private _simpleHash;
+    private _fastHash;
 }
 export {};

package/dist/types/core/google-tag-manager.service.d.ts

@@ -35,6 +35,7 @@ interface BaseItem {
     upc?: string;
     grouping_id?: string;
     product_id?: string;
+    item_size?: string;
 }
 interface PurchaseData {
     transaction_id: string;
@@ -83,11 +84,135 @@ export declare class GoogleTagManagerService {
         email?: string;
         birth_date?: string;
         customer_id?: string;
+    }, amounts?: {
+        subtotal?: number;
+        total_before_discounts?: number;
+        discounts?: number;
+        gift_cards?: number;
+        net_total?: number;
     }): void;
     addPaymentInfo(items: BaseItem[], paymentType?: string, coupon?: string): void;
-    addPaymentInfoWithoutItems(value: number, paymentType?: string, coupon?: string): void;
-    purchase(purchaseData: PurchaseData): void;
+    addPaymentInfoWithoutItems(value: number, paymentType?: string, coupon?: string, amounts?: {
+        subtotal?: number;
+        total_before_discounts?: number;
+        discounts?: number;
+        gift_cards?: number;
+        net_total?: number;
+    }): void;
+    purchase(purchaseData: PurchaseData & {
+        subtotal?: number;
+        total_before_discounts?: number;
+        discounts?: number;
+        gift_cards?: number;
+        net_total?: number;
+    }): void;
+    promoCodeAttempt(code: string): void;
+    promoCodeApplied(code: string, discountAmount?: number): void;
+    promoCodeFailed(code: string, reason?: string): void;
+    giftCardAttempt(code: string): void;
+    giftCardApplied(code: string, appliedAmount?: number): void;
+    giftCardFailed(code: string, reason?: string): void;
     increaseQuantity(item: BaseItem): void;
     decreaseQuantity(item: BaseItem): void;
+    addressUpdated(addressData: {
+        googlePlacesId: string;
+        formattedAddress: string;
+        address: {
+            one?: string;
+            two?: string;
+            city?: string;
+            state?: string;
+            zip?: string;
+            country?: string;
+        };
+        coordinates?: {
+            lat: number;
+            long: number;
+        };
+    }): void;
+    addressFailed(errorData: {
+        googlePlacesId?: string;
+        formattedAddress?: string;
+        address?: {
+            one?: string;
+            two?: string;
+            city?: string;
+            state?: string;
+            zip?: string;
+            country?: string;
+        };
+        error: string;
+    }): void;
+    productNoAvailability(productData: {
+        productId: string;
+        productName: string;
+        productBrand?: string;
+        productCategory?: string;
+        productCategory2?: string;
+        productCategory3?: string;
+        productType?: string;
+        productSubtype?: string;
+        productPrice?: number;
+        upc?: string;
+        groupingId?: string;
+        address?: {
+            one?: string;
+            two?: string;
+            city?: string;
+            state?: string;
+            zip?: string;
+            country?: string;
+        };
+        reason: string;
+    }): void;
+    productSizeNoAvailability(productData: {
+        productId: string;
+        productName: string;
+        productBrand?: string;
+        productCategory?: string;
+        productCategory2?: string;
+        productCategory3?: string;
+        productType?: string;
+        productSubtype?: string;
+        productPrice?: number;
+        sizeId: string;
+        sizeName?: string;
+        upc?: string;
+        groupingId?: string;
+        address?: {
+            one?: string;
+            two?: string;
+            city?: string;
+            state?: string;
+            zip?: string;
+            country?: string;
+        };
+        reason: string;
+    }): void;
+    productFulfillmentNoAvailability(productData: {
+        productId: string;
+        productName: string;
+        productBrand?: string;
+        productCategory?: string;
+        productCategory2?: string;
+        productCategory3?: string;
+        productType?: string;
+        productSubtype?: string;
+        productPrice?: number;
+        sizeId?: string;
+        sizeName?: string;
+        fulfillmentType: string;
+        upc?: string;
+        groupingId?: string;
+        address?: {
+            one?: string;
+            two?: string;
+            city?: string;
+            state?: string;
+            zip?: string;
+            country?: string;
+        };
+        reason: string;
+    }): void;
 }
 export {};

package/dist/types/core/logger/logger-factory.d.ts

@@ -1,8 +1,11 @@
+import type { TelemetryService } from '@/core/telemetry/telemetry.service';
 import { LoggerService } from './logger.service';
 export declare class LoggerFactory {
     private static instances;
     private static enableLoggingGlobally;
+    private static telemetryService;
     private static getInstances;
     static get(context: string): LoggerService;
     static setEnableLogging(enable: boolean): void;
+    static setTelemetryService(telemetry: TelemetryService): void;
 }

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

@@ -1,17 +1,20 @@
+import type { TelemetryService } from '@/core/telemetry/telemetry.service';
 export declare class LoggerService {
     private readonly prefix;
     private readonly colors;
     private readonly context;
     private enableLogging;
+    private telemetryService;
     private constructor();
     static getInstance(context: string): LoggerService;
     setEnableLogging(enable: boolean): void;
+    setTelemetryService(telemetry: TelemetryService): void;
     private getPrefix;
-    debug(...args: any[]): void;
-    log(...args: any[]): void;
-    info(...args: any[]): void;
-    warn(...args: any[]): void;
-    error(...args: any[]): void;
+    debug(message: string, data?: Record<string, any>): void;
+    info(message: string, data?: Record<string, any>): void;
+    warn(message: string, data?: Record<string, any>): void;
+    error(message: string, error?: Error | Record<string, any>): void;
     group(label: string, collapsed?: boolean): void;
     groupEnd(): void;
+    private sendToTelemetry;
 }

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

@@ -1,4 +1,4 @@
-import type { IAddressActionEventData, ICartFailedEventData, ICartItemAddedEventData, ICartItemEngravingUpdatedEventData, ICartItemQuantityChangedEventData, ICartItemRemovedEventData, ICartLoadedEventData, ICartProductAddEventData, ICartProductAddFailedEventData, ICartPromoCodeEventData, ICartPromoCodeFailedEventData, ICartUpdatedEventData, ICheckoutFailedEventData, ICheckoutFormUpdatedEventData, ICheckoutGiftCardEventData, ICheckoutGiftCardFailedEventData, ICheckoutItemEngravingUpdatedEventData, ICheckoutItemQuantityChangedEventData, ICheckoutItemRemovedEventData, ICheckoutLoadedEventData, ICheckoutMarketingPreferencesToggleEventData, ICheckoutProductAddEventData, ICheckoutProductAddFailedEventData, ICheckoutPromoCodeEventData, ICheckoutPromoCodeFailedEventData, ICheckoutSubmitCompletedEventData, ICheckoutSubmitFailedEventData, ICheckoutSubmitStartedEventData, ICheckoutTipUpdatedEventData, ICheckoutToggleEventData, IElementsClientIsReadyEventData, IProductAddToCartEventData, IProductEngravingUpdatedEventData, IProductFulfillmentChangedEventData, IProductFulfillmentTypeChangedEventData, IProductLoadedEventData, IProductQuantityChangedEventData, IProductSizeChangedEventData } from '@/core/pubsub';
+import type { IAddressActionEventData, ICartFailedEventData, ICartItemAddedEventData, ICartItemEngravingUpdatedEventData, ICartItemQuantityChangedEventData, ICartItemRemovedEventData, ICartLoadedEventData, ICartProductAddEventData, ICartProductAddFailedEventData, ICartPromoCodeEventData, ICartPromoCodeFailedEventData, ICartUpdatedEventData, ICheckoutFailedEventData, ICheckoutFormUpdatedEventData, ICheckoutGiftCardEventData, ICheckoutGiftCardFailedEventData, ICheckoutItemEngravingUpdatedEventData, ICheckoutItemQuantityChangedEventData, ICheckoutItemRemovedEventData, ICheckoutLoadedEventData, ICheckoutMarketingPreferencesToggleEventData, ICheckoutProductAddEventData, ICheckoutProductAddFailedEventData, ICheckoutPromoCodeEventData, ICheckoutPromoCodeFailedEventData, ICheckoutSubmitCompletedEventData, ICheckoutSubmitFailedEventData, ICheckoutSubmitStartedEventData, ICheckoutTipUpdatedEventData, ICheckoutToggleEventData, IElementsClientIsReadyEventData, IProductAddToCartEventData, IProductFulfillmentChangedEventData, IProductFulfillmentTypeChangedEventData, IProductLoadedEventData, IProductQuantityChangedEventData, IProductSizeChangedEventData } from '@/core/pubsub';
 import { ELEMENTS_ACTIONS_EVENT } from '@/enums';
 export interface IEventMetadata {
     eventId: string;
@@ -21,7 +21,6 @@ export interface IElementsActionsEventsMap {
     [ELEMENTS_ACTIONS_EVENT.PRODUCT_SIZE_CHANGED]: IProductSizeChangedEventData;
     [ELEMENTS_ACTIONS_EVENT.PRODUCT_FULFILLMENT_TYPE_CHANGED]: IProductFulfillmentTypeChangedEventData;
     [ELEMENTS_ACTIONS_EVENT.PRODUCT_FULFILLMENT_CHANGED]: IProductFulfillmentChangedEventData;
-    [ELEMENTS_ACTIONS_EVENT.PRODUCT_ENGRAVING_UPDATED]: IProductEngravingUpdatedEventData;
     [ELEMENTS_ACTIONS_EVENT.CART_CLOSED]: boolean;
     [ELEMENTS_ACTIONS_EVENT.CART_OPENED]: boolean;
     [ELEMENTS_ACTIONS_EVENT.CART_UPDATED]: ICartUpdatedEventData;
@@ -71,7 +70,7 @@ export interface IElementsActionsEventsMap {
 export type SpecificActionEvent = keyof IElementsActionsEventsMap;
 export interface IFormEventData {
     fieldName: string;
-    fieldValue: string;
+    fieldValue?: string;
 }
 export interface IElementsFormsEventsMap {
     customer: IFormEventData;

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

@@ -84,8 +84,3 @@ export interface IProductFulfillmentChangedEventData {
     previousFulfillmentId: string;
     previousFulfillmentType: FulfillmentType;
 }
-export interface IProductEngravingUpdatedEventData {
-    identifier: string;
-    engravingLines: string[];
-    previousEngravingLines: string[];
-}

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

@@ -75,7 +75,6 @@ export interface IRetailerStore {
 export interface ICartPromoCodeStore {
     code: string;
     discountAmount: number;
-    error: string | null;
 }
 export interface ICartStore {
     id: string | null;

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

@@ -25,7 +25,6 @@ export interface ICheckoutGiftRecipientStore {
     phone: string;
     birthDate: string;
     addressTwo: string | null;
-    company: string | null;
     message: string | null;
 }
 export interface ICheckoutCustomerStore {

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

@@ -1,4 +1,4 @@
-import type { IAddressStore, ICheckoutBillingStore, ICheckoutCustomerStore, ICheckoutItemStore, ICheckoutMarketingPreferencesStore, ICheckoutPaymentStore, ICheckoutStore, IProductSizeStore, IProductStore } from '@/core/store';
+import type { IAddressStore, ICartPromoCodeStore, ICheckoutBillingStore, ICheckoutCustomerStore, ICheckoutGiftRecipientStore, ICheckoutItemStore, ICheckoutMarketingPreferencesStore, ICheckoutPaymentStore, ICheckoutPromoCodeStore, ICheckoutReadyForSubmitStore, ICheckoutStore, ICheckoutStripeFormStatusStore, IProductSizeStore, IProductStore } from '@/core/store';
 import type { ComponentType } from '@/enums';
 import type { ICartItemStore, ICartStore, ICartTotalsStore, IRetailerFulfillmentStore, IRetailerStore } from './cart.interface';
 export interface IDrawerContentConfig {
@@ -23,7 +23,7 @@ export interface IPersistedStore {
     p: string;
     c: string;
 }
-export type StorePaths = keyof IGlobalStore | `products.${string}` | `products.${string}.${keyof IProductStore}` | `products.${string}.sizes.${string}` | `products.${string}.sizes.${string}.${keyof IProductSizeStore}` | `address.${keyof IAddressStore}` | `cart.${keyof ICartStore}` | `cart.items.${string}` | `cart.items.${string}.${keyof ICartItemStore}` | `cart.totals.${keyof ICartTotalsStore}` | `cart.retailers.${string}` | `cart.items.${string}.${keyof IRetailerStore}` | `cart.fulfillments.${string}` | `cart.fulfillments.${string}.${keyof IRetailerFulfillmentStore}` | `cart.promoCode.${keyof ICartStore['promoCode']}` | `ui.${keyof IUIStore}` | `ui.drawer.${keyof IDrawerStore}` | `checkout.${keyof ICheckoutStore}` | `checkout.customer.${keyof ICheckoutCustomerStore}` | `checkout.marketingPreferences.${keyof ICheckoutMarketingPreferencesStore}` | `checkout.payment.${keyof ICheckoutPaymentStore}` | `checkout.billing.${keyof ICheckoutBillingStore}` | `checkout.giftRecipient.${keyof ICheckoutStore['giftRecipient']}` | `checkout.giftCards.${string}` | `checkout.items.${string}` | `checkout.items.${string}.${keyof ICheckoutItemStore}` | `checkout.readyForSubmit.${keyof ICheckoutStore['readyForSubmit']}` | `checkout.onDemandFulfillmentTipInfo.${string}` | `checkout.readyForSubmit.${string}` | `checkout.stripeFormStatus.${keyof ICheckoutStore['stripeFormStatus']}`;
+export type StorePaths = keyof IGlobalStore | `products.${string}` | `products.${string}.${keyof IProductStore}` | `products.${string}.sizes.${string}` | `products.${string}.sizes.${string}.${keyof IProductSizeStore}` | `address.${keyof IAddressStore}` | `cart.${keyof ICartStore}` | `cart.items.${string}` | `cart.items.${string}.${keyof ICartItemStore}` | `cart.totals.${keyof ICartTotalsStore}` | `cart.retailers.${string}` | `cart.items.${string}.${keyof IRetailerStore}` | `cart.fulfillments.${string}` | `cart.fulfillments.${string}.${keyof IRetailerFulfillmentStore}` | `cart.promoCode.${keyof ICartPromoCodeStore}` | `ui.${keyof IUIStore}` | `ui.drawer.${keyof IDrawerStore}` | `checkout.${keyof ICheckoutStore}` | `checkout.customer.${keyof ICheckoutCustomerStore}` | `checkout.marketingPreferences.${keyof ICheckoutMarketingPreferencesStore}` | `checkout.payment.${keyof ICheckoutPaymentStore}` | `checkout.billing.${keyof ICheckoutBillingStore}` | `checkout.giftRecipient.${keyof ICheckoutGiftRecipientStore}` | `checkout.giftCards.${string}` | `checkout.promoCode.${keyof ICheckoutPromoCodeStore}` | `checkout.items.${string}` | `checkout.items.${string}.${keyof ICheckoutItemStore}` | `checkout.readyForSubmit.${keyof ICheckoutReadyForSubmitStore}` | `checkout.onDemandFulfillmentTipInfo.${string}` | `checkout.readyForSubmit.${string}` | `checkout.stripeFormStatus.${keyof ICheckoutStripeFormStatusStore}`;
 interface MiddlewareContext {
     action: string;
     payload: any;

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

@@ -74,7 +74,6 @@ export interface IProductStore {
     loading: boolean;
     updating: boolean;
     error: string | null;
-    engravingLines: string[];
     drawer: IProductDrawerStore;
     rerender: boolean;
     mainImage: string | null;

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

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

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

@@ -0,0 +1,80 @@
+import type { DeviceType } from '@/core/client/client-config.service';
+import type { ComponentType, ElementsEnv } from '@/enums';
+export type TelemetryLevel = 'debug' | 'log' | 'info' | 'warn' | 'error' | 'fatal';
+export interface ITelemetryConfig {
+    enabled: boolean;
+    endpoint: string;
+    batchSize: number;
+    batchInterval: number;
+    includeDebugLogs: boolean;
+    includeWarnings: boolean;
+    includeErrors: boolean;
+    maxQueueSize: number;
+}
+export interface ITelemetryEventOptions {
+    context?: string;
+    error?: Error;
+    component?: ITelemetryComponentContext;
+    data?: Record<string, any>;
+}
+export interface ITelemetryEvent {
+    eventId: string;
+    timestamp: number;
+    level: TelemetryLevel;
+    message: string;
+    context?: string;
+    error?: ITelemetryError;
+    component?: ITelemetryComponentContext;
+    data?: Record<string, any>;
+    metadata: {
+        sdk: ITelemetrySDKContext;
+        user: ITelemetryUserContext;
+        browser: ITelemetryBrowserContext;
+    };
+}
+export interface ITelemetryError {
+    name: string;
+    message: string;
+    stack?: string;
+    code?: string | number;
+    statusCode?: number;
+}
+export interface ITelemetrySDKContext {
+    version: string;
+    env: ElementsEnv;
+    isBuilder: boolean;
+    partnerCode?: string;
+}
+export interface ITelemetryComponentContext {
+    type: ComponentType;
+    tagName: string;
+    renderCount?: number;
+    renderTrigger?: string;
+    renderDuration?: number;
+    useShadowDom?: boolean;
+}
+export interface ITelemetryUserContext {
+    deviceId: string;
+    sessionId?: string;
+    isLocalStorageAvailable: boolean;
+}
+export interface ITelemetryBrowserContext {
+    userAgent: string;
+    deviceType: DeviceType;
+    url: string;
+    referrer?: string;
+    timezone?: string;
+}
+export interface ITelemetryBatchPayload {
+    batchId: string;
+    timestamp: number;
+    events: ITelemetryEvent[];
+}
+export interface ITelemetryStats {
+    totalEvents: number;
+    eventsByLevel: Record<TelemetryLevel, number>;
+    batchesSent: number;
+    failedBatches: number;
+    queuedEvents: number;
+    droppedEvents: number;
+}