@liquidcommerce/elements-sdk 2.6.0-beta.11 → 2.6.0-beta.111

package/dist/types/core/api/auth-client.service.d.ts

@@ -1,4 +1,6 @@
+import { type ApiResult } from '@/core/api/api-result';
 import type { ElementsEnv } from '@/enums';
+import type { IAllConfigs } from '@/interfaces/configs/global.interface';
 export interface IAuthConfig {
     apiKey: string;
     env: ElementsEnv;
@@ -9,34 +11,56 @@ export interface IHttpRequestOptions {
     body?: any;
 }
 export interface IAuth {
-    token: string;
-    exp: number;
-    type: 'ACCESS_TOKEN';
-}
-export interface IApiResponseBase {
-    message: string;
+    accessToken: string;
+    expiration: number;
 }
 export interface IApiResponse<T> {
     message: string;
     data: T;
 }
+export interface IApiErrorDetail {
+    field?: string;
+    message: string;
+    code?: string;
+}
+export interface IApiError {
+    statusCode: number;
+    message: string;
+    errors: IApiErrorDetail[];
+}
+export interface IAuthWithConfigs {
+    auth: IAuth;
+    configs: IAllConfigs;
+}
 export declare class AuthClientService {
+    private static readonly TOKEN_EXPIRATION_BUFFER_MS;
     private readonly apiKey;
     private readonly baseUrl;
     private readonly env;
-    private accessToken;
-    private tokenExpiration;
-    private isAuthenticating;
     private readonly httpClient;
     private readonly logger;
     private readonly clientConfig;
+    private accessToken;
+    private tokenExpiration;
+    private refreshPromise;
     private constructor();
     static getInstance(config: IAuthConfig): AuthClientService;
-    authenticate(): Promise<boolean>;
-    isTokenExpired(): boolean;
+    authenticateAndGetConfigs(): Promise<{
+        success: boolean;
+        configs?: IAllConfigs;
+    }>;
+    refreshToken(): Promise<boolean>;
+    get<TData = unknown>(path: string, options?: IHttpRequestOptions): Promise<ApiResult<TData>>;
+    post<TData = unknown>(path: string, options?: IHttpRequestOptions): Promise<ApiResult<TData>>;
+    private performTokenRefresh;
     private request;
+    private handleSuccessResponse;
+    private handleAuthError;
+    private handleErrorResponse;
+    private isTokenExpired;
+    private clearToken;
     private buildUrl;
+    private buildHeaders;
     private getProxyHeaders;
-    get<T = any>(path: string, options?: IHttpRequestOptions): Promise<T>;
-    post<T = any>(path: string, options?: IHttpRequestOptions): Promise<T>;
+    private isAccessTokenError;
 }

package/dist/types/core/api/http-client.service.d.ts

@@ -21,24 +21,16 @@ export interface IRequestOptions {
 export interface IHttpRequestConfig {
     url: string;
     options: IHttpClientOptions;
-    retryConfig?: {
-        maxRetries: number;
-        retryDelay: number;
-        shouldRetry?: (error: any, response?: ICustomResponse) => boolean;
-    };
 }
 export declare class HttpClientService {
     private readonly fetchImpl;
     private readonly logger;
     constructor();
     request(config: IHttpRequestConfig): Promise<ICustomResponse>;
-    private defaultShouldRetry;
     private logFailedResponse;
     private logNetworkError;
     private diagnosePossibleCauses;
     private enhanceError;
-    private sanitizeHeaders;
-    private delay;
     private getFetchImplementation;
     private fetchAdapter;
     private xhrFetch;

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

@@ -1,3 +1,4 @@
+import { AnnouncerService } from '@/core/a11y';
 import { ClientConfigService } from '@/core/client/client-config.service';
 import { LoggerFactory } from '@/core/logger/logger-factory';
 import { PubSubService } from '@/core/pubsub/pubsub.service';
@@ -7,6 +8,7 @@ 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/theme-provider.service';
+import { SafeHTMLElement } from '@/utils/dom-compat';
 import { CommandService } from './command/command.service';
 export interface IBaseComponentConfig {
     type: ComponentType;
@@ -25,7 +27,7 @@ export interface IOnStoreChanged {
     value: any;
     oldValue: any;
 }
-export declare abstract class BaseComponent<TParams = Record<string, any>, TConfig = ConfigsType> extends HTMLElement {
+export declare abstract class BaseComponent<TParams = Record<string, any>, TConfig = ConfigsType> extends SafeHTMLElement {
     protected readonly store: StoreService;
     protected readonly commands: CommandService;
     protected readonly themeProvider: ThemeProviderService;
@@ -33,6 +35,7 @@ export declare abstract class BaseComponent<TParams = Record<string, any>, TConf
     protected readonly logger: ReturnType<typeof LoggerFactory.get>;
     protected readonly clientConfig: ClientConfigService;
     protected readonly telemetry: TelemetryService;
+    protected readonly announcer: AnnouncerService;
     private initialized;
     private isDestroyed;
     private renderScheduled;

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

@@ -0,0 +1,22 @@
+import { ApiClientService } from '@/core/api/api-client.service';
+import { LoggerFactory } from '@/core/logger/logger-factory';
+import { PubSubService } from '@/core/pubsub/pubsub.service';
+import { StoreService } from '@/core/store/store.service';
+import type { ILocation } from '@/interfaces/api/address.interface';
+import type { IProductSizeEngraving, IProductVariant } from '@/interfaces/api/product.interface';
+import { ThemeProviderService } from '@/modules/theme-provider/theme-provider.service';
+export declare abstract class BaseActionService {
+    protected readonly pubSub: PubSubService;
+    protected readonly store: StoreService;
+    protected readonly api: ApiClientService;
+    protected readonly themeProvider: ThemeProviderService;
+    protected readonly logger: ReturnType<typeof LoggerFactory.get>;
+    constructor(loggerName: string);
+    protected getLocation(): ILocation | undefined;
+    protected sanitizeEngravingInput(rawLines: string[] | undefined, identifier: string): string[] | undefined;
+    protected clampEngravingToSizeLimits(requestedLines: string[], sizeEngraving: IProductSizeEngraving | undefined, identifier: string): string[] | undefined;
+    protected findVariantForFulfillment(variants: (IProductVariant | undefined)[], wantsEngraving: boolean): {
+        variant: IProductVariant | null;
+        engravingDropped: boolean;
+    };
+}

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

@@ -0,0 +1,18 @@
+import type { IAddressAddress, IAddressCoordinates, IAddressData } from '@/interfaces/api/address.interface';
+import { BaseActionService } from './base-action.service';
+export interface IAddressActions {
+    setAddressByPlacesId: (placesId: string) => Promise<void>;
+    setAddressManually: (address: IAddressAddress, coordinates: IAddressCoordinates) => Promise<void>;
+    clear: () => Promise<void>;
+    getDetails: () => IAddressData | null;
+}
+export declare class ClientAddressActionService extends BaseActionService {
+    private readonly command;
+    constructor();
+    static getInstance(): ClientAddressActionService;
+    get actions(): IAddressActions;
+    private setAddressByPlacesId;
+    private setAddressManually;
+    private clear;
+    private getDetails;
+}

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

@@ -0,0 +1,38 @@
+import type { IBaseCartEventData } from '@/core/pubsub/interfaces/cart.interface';
+import { type FulfillmentType } from '@/enums';
+import { BaseActionService } from './base-action.service';
+export interface IAddProductParams {
+    identifier: string;
+    fulfillmentType: FulfillmentType;
+    quantity: number;
+    engravingLines?: string[];
+}
+export interface ICartActions {
+    openCart: () => void;
+    closeCart: () => void;
+    toggleCart: () => void;
+    addProduct: (params: IAddProductParams[], openCart?: boolean) => Promise<void>;
+    applyPromoCode: (promoCode: string) => Promise<void>;
+    removePromoCode: () => Promise<void>;
+    resetCart: () => Promise<void>;
+    getDetails: () => IBaseCartEventData;
+}
+export declare class ClientCartActionService extends BaseActionService {
+    private readonly command;
+    private pendingCartParams;
+    private pendingCartOpenFlag;
+    constructor();
+    static getInstance(): ClientCartActionService;
+    get actions(): ICartActions;
+    private setupAddressUpdateListener;
+    private retryPendingCartOperation;
+    private clearPendingCartOperation;
+    private openCart;
+    private closeCart;
+    private toggleCart;
+    private addProduct;
+    private applyPromoCode;
+    private removePromoCode;
+    private resetCart;
+    private getDetails;
+}

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

@@ -0,0 +1,69 @@
+import type { ICheckoutDetailsEventData } from '@/core/pubsub/interfaces/checkout.interface';
+import type { IAnonymousCheckoutAddProductParams, IAnonymousCheckoutAddProductResponse } from '@/interfaces/api/checkout.interface';
+import type { IProductAvailabilityResponse } from '@/interfaces/api/product.interface';
+import type { BillingFieldName, CustomerFieldName, GiftFieldName } from '@/modules/checkout/constant';
+import { BaseActionService } from './base-action.service';
+import type { IAddProductParams } from './client-cart-action.service';
+export interface ISavedPaymentMethodInput {
+    id: string;
+    card: {
+        brand: string;
+        last4: string;
+        expMonth?: string | number;
+        expYear?: string | number;
+    };
+}
+export interface ICheckoutActions {
+    openCheckout: () => void;
+    closeCheckout: () => void;
+    toggleCheckout: () => void;
+    exitCheckout: () => void;
+    setSavedPaymentMethod: (params: ISavedPaymentMethodInput) => void;
+    clearSavedPaymentMethod: () => void;
+    addProduct: (params: IAddProductParams[], openCheckout?: boolean) => Promise<void>;
+    applyPromoCode: (promoCode: string) => Promise<void>;
+    removePromoCode: () => Promise<void>;
+    applyGiftCard: (code: string) => Promise<void>;
+    removeGiftCard: (code: string) => Promise<void>;
+    toggleIsGift: (active?: boolean) => Promise<void>;
+    toggleBillingSameAsShipping: (active?: boolean) => Promise<void>;
+    toggleMarketingPreferences: (field: 'canEmail' | 'canSms', active: boolean) => Promise<void>;
+    updateCustomerInfo: (params: Record<CustomerFieldName, string>) => void;
+    updateBillingInfo: (params: Record<BillingFieldName, string>) => void;
+    updateGiftInfo: (params: Record<GiftFieldName, string>) => void;
+    getDetails: () => ICheckoutDetailsEventData;
+    getProductAvailabilityByState: (identifiers: string[], state?: string) => Promise<IProductAvailabilityResponse>;
+    addAnonymousProduct: (params: IAnonymousCheckoutAddProductParams) => Promise<IAnonymousCheckoutAddProductResponse>;
+}
+export declare class ClientCheckoutActionService extends BaseActionService {
+    private readonly command;
+    private readonly allowedCustomerFields;
+    private readonly allowedBillingFields;
+    private readonly allowedGiftFields;
+    private cartActionsAddProduct;
+    constructor();
+    static getInstance(): ClientCheckoutActionService;
+    setCartActionsAddProduct(addProductFn: (params: IAddProductParams[]) => Promise<void>): void;
+    get actions(): ICheckoutActions;
+    private normalizeCheckoutFieldValue;
+    private openCheckout;
+    private closeCheckout;
+    private toggleCheckout;
+    private exitCheckout;
+    private setSavedPaymentMethod;
+    private clearSavedPaymentMethod;
+    private addProduct;
+    private applyPromoCode;
+    private removePromoCode;
+    private applyGiftCard;
+    private removeGiftCard;
+    private toggleIsGift;
+    private toggleBillingSameAsShipping;
+    private toggleMarketingPreferences;
+    private updateCustomerInfo;
+    private updateBillingInfo;
+    private updateGiftInfo;
+    private getDetails;
+    private addAnonymousProduct;
+    private getProductAvailabilityByState;
+}

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

@@ -0,0 +1,15 @@
+import type { IBaseProductEventData } from '@/core/pubsub/interfaces/product.interface';
+import type { IProductAvailabilityResponse } from '@/interfaces/api/product.interface';
+import { BaseActionService } from './base-action.service';
+export interface IProductActions {
+    getDetails: (identifier: string) => IBaseProductEventData;
+    getProductAvailabilityByState: (identifiers: string[], state?: string) => Promise<IProductAvailabilityResponse>;
+}
+export declare class ClientProductActionService extends BaseActionService {
+    private readonly command;
+    constructor();
+    static getInstance(): ClientProductActionService;
+    get actions(): IProductActions;
+    private getDetails;
+    private getProductAvailabilityByState;
+}

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

@@ -1,78 +1,10 @@
-import type { IBaseCartEventData } from '@/core/pubsub/interfaces/cart.interface';
-import type { ICheckoutDetailsEventData } from '@/core/pubsub/interfaces/checkout.interface';
-import type { IBaseProductEventData } from '@/core/pubsub/interfaces/product.interface';
-import { type FulfillmentType } from '@/enums';
-import type { IAddressAddress, IAddressCoordinates, IAddressData } from '@/interfaces/api/address.interface';
-import type { BillingFieldName, CustomerFieldName, GiftFieldName } from '@/modules/checkout/components/checkout.type';
-export interface IAddProductParams {
-    identifier: string;
-    fulfillmentType: FulfillmentType;
-    quantity: number;
-}
-export interface IAddressActions {
-    setAddressByPlacesId: (placesId: string) => Promise<void>;
-    setAddressManually: (address: IAddressAddress, coordinates: IAddressCoordinates) => Promise<void>;
-    clear: () => Promise<void>;
-    getDetails: () => IAddressData | null;
-}
-export interface ICartActions {
-    openCart: () => void;
-    closeCart: () => void;
-    toggleCart: () => void;
-    addProduct: (params: IAddProductParams[], openCart?: boolean) => Promise<void>;
-    applyPromoCode: (promoCode: string) => Promise<void>;
-    removePromoCode: () => Promise<void>;
-    resetCart: () => Promise<void>;
-    getDetails: () => IBaseCartEventData;
-}
-export interface ICheckoutActions {
-    openCheckout: () => void;
-    closeCheckout: () => void;
-    toggleCheckout: () => void;
-    addProduct: (params: IAddProductParams[], openCheckout?: boolean) => Promise<void>;
-    addPresaleProduct: (params: IAddProductParams) => Promise<void>;
-    applyPromoCode: (promoCode: string) => Promise<void>;
-    removePromoCode: () => Promise<void>;
-    applyGiftCard: (code: string) => Promise<void>;
-    removeGiftCard: (code: string) => Promise<void>;
-    toggleIsGift: (active?: boolean) => Promise<void>;
-    toggleBillingSameAsShipping: (active?: boolean) => Promise<void>;
-    toggleMarketingPreferences: (field: 'canEmail' | 'canSms', active: boolean) => Promise<void>;
-    updateCustomerInfo: (params: Record<CustomerFieldName, string>) => void;
-    updateBillingInfo: (params: Record<BillingFieldName, string>) => void;
-    updateGiftInfo: (params: Record<GiftFieldName, string>) => void;
-    getDetails: () => ICheckoutDetailsEventData;
-}
-export interface IProductActions {
-    getDetails: (identifier: string) => IBaseProductEventData;
-}
+import type { ILiquidCommerceElementsActions } from '@/interfaces/client.interface';
 export declare class ClientActionService {
-    private readonly pubSub;
-    private readonly command;
-    private readonly store;
-    private readonly api;
-    private readonly themeProvider;
-    private readonly logger;
-    private readonly allowedCustomerFields;
-    private readonly allowedBillingFields;
-    private readonly allowedGiftFields;
-    private pendingCartParams;
-    private pendingCartOpenFlag;
+    private readonly productActionService;
+    private readonly addressActionService;
+    private readonly cartActionService;
+    private readonly checkoutActionService;
     constructor();
     static getInstance(): ClientActionService;
-    private setupAddressUpdateListener;
-    private retryPendingCartOperation;
-    private clearPendingCartOperation;
-    private getLocation;
-    private normalizeCheckoutFieldValue;
-    private productActions;
-    private addressActions;
-    private cartActions;
-    private checkoutActions;
-    actions: {
-        product: IProductActions;
-        address: IAddressActions;
-        cart: ICartActions;
-        checkout: ICheckoutActions;
-    };
+    get actions(): ILiquidCommerceElementsActions;
 }

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

@@ -1,6 +1,6 @@
 import { type DebugMode, type ElementsEnv } from '@/enums';
+import type { IClientCustomThemeConfig, IElementsProxyConfig, ILiquidCommerceElementsCheckoutConfig } from '@/interfaces/config.interface';
 import type { IPromoTicker } from '@/interfaces/configs';
-import type { IClientCustomThemeConfig, IElementsProxyConfig } from '@/interfaces/core.interface';
 export type DeviceType = 'desktop' | 'tablet' | 'mobile';
 export interface IClientConfigs {
     apiKey: string;
@@ -19,9 +19,11 @@ export interface IClientConfigs {
     version?: string;
     clientPrepared: boolean;
     promoTicker: IPromoTicker[] | null;
-    paymentMethodId?: string;
     openShadowDom?: boolean;
     hasCustomApiUrl?: boolean;
+    mockMode: boolean;
+    checkout: ILiquidCommerceElementsCheckoutConfig | null;
+    isCheckoutOnly: boolean;
 }
 export interface IClientConfigInput {
     env?: ElementsEnv;
@@ -32,9 +34,11 @@ export interface IClientConfigInput {
     promoTicker?: IPromoTicker[];
     development?: {
         customApiUrl?: string;
-        paymentMethodId?: string;
         openShadowDom?: boolean;
+        mockMode?: boolean;
     };
+    checkout?: ILiquidCommerceElementsCheckoutConfig;
+    isCheckoutOnly?: boolean;
 }
 export declare class ClientConfigService {
     private config;
@@ -43,16 +47,15 @@ export declare class ClientConfigService {
     getConfigs(): IClientConfigs;
     get<K extends keyof IClientConfigs>(key: K): IClientConfigs[K];
     set<K extends keyof IClientConfigs>(key: K, value: IClientConfigs[K]): void;
-    isDevelopment(): boolean;
     isStaging(): boolean;
     isProduction(): boolean;
     isBuilder(): boolean;
+    isCheckoutOnly(): boolean;
     isDebuggingEnabled(): boolean;
     isDebugPanelEnabled(): boolean;
     debuggingDisabled(): boolean;
     hasCustomTheme(): boolean;
     isMobile(): boolean;
-    isLocalStorageAvailable(): boolean;
     getProxyConfig(): IElementsProxyConfig | null;
     private validateInputs;
     private buildConfiguration;

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

@@ -1 +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    flex: 1;\n    margin: 0 12px;\n  }\n  \n  .title-container > *:not(:first-child) {\n    margin-top: 2px;\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    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  .toggles > *:not(:last-child) {\n    margin-right: 12px;\n  }\n\n  .toggle {\n    display: flex;\n    align-items: center;\n    cursor: pointer;\n    font-size: 11px;\n    color: #cbd5e1;\n    transition: color 0.2s ease;\n  }\n  \n  .toggle > *:not(:last-child) {\n    margin-right: 6px;\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    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 > *:not(:last-child) {\n    margin-right: 8px;\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    min-width: 50px;\n  }\n  \n  .log-meta > *:not(:first-child) {\n    margin-top: 2px;\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      flex-wrap: wrap;\n    }\n    \n    .toggles > *:not(:last-child) {\n      margin-right: 8px;\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    }\n    \n    .toggles > *:not(:first-child) {\n      margin-right: 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    }\n    \n    .log-entry > *:not(:first-child) {\n      margin-top: 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";
+export declare const DEBUG_PANEL_STYLES = "\n  :host {\n    position: fixed;\n    z-index: 2147483647;\n    display: block;\n    letter-spacing: normal;\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    flex: 1;\n    margin: 0 12px;\n  }\n\n  .title-container > *:not(:first-child) {\n    margin-top: 2px;\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    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  .toggles > *:not(:last-child) {\n    margin-right: 12px;\n  }\n\n  .toggle {\n    display: flex;\n    align-items: center;\n    cursor: pointer;\n    font-size: 11px;\n    color: #cbd5e1;\n    transition: color 0.2s ease;\n  }\n\n  .toggle > *:not(:last-child) {\n    margin-right: 6px;\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    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 > *:not(:last-child) {\n    margin-right: 8px;\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    min-width: 50px;\n  }\n\n  .log-meta > *:not(:first-child) {\n    margin-top: 2px;\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      flex-wrap: wrap;\n    }\n\n    .toggles > *:not(:last-child) {\n      margin-right: 8px;\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    }\n\n    .toggles > *:not(:first-child) {\n      margin-right: 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    }\n\n    .log-entry > *:not(:first-child) {\n      margin-top: 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/google-tag-manager.service.d.ts

@@ -33,6 +33,7 @@ interface BaseItem {
     quantity?: number;
     item_type?: string;
     item_subtype?: string;
+    item_image?: string;
     upc?: string;
     grouping_id?: string;
     product_id?: string;
@@ -62,6 +63,7 @@ export declare class GoogleTagManagerService {
     private readonly clientConfigService;
     constructor();
     static getInstance(): GoogleTagManagerService;
+    private isGTMEnabledEnvironment;
     private waitForDOMReady;
     private isGTMAlreadyLoaded;
     private isContainerLoaded;
@@ -93,7 +95,7 @@ export declare class GoogleTagManagerService {
         net_total?: number;
     }): void;
     promoCodeAttempt(code: string): void;
-    promoCodeApplied(code: string, discountAmount?: number): void;
+    promoCodeApplied(code: string, discount?: number): void;
     promoCodeFailed(code: string, reason?: string): void;
     giftCardAttempt(code: string): void;
     giftCardApplied(code: string, appliedAmount?: number): void;

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

@@ -13,6 +13,6 @@ export declare class LoggerService {
     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;
+    error(message: string, errorOrData?: Error | Record<string, any>): void;
     private sendToTelemetry;
 }

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

@@ -5,3 +5,6 @@ export interface IAddressActionEventData {
     address: IAddressAddress;
     coordinates: IAddressCoordinates;
 }
+export interface IAddressFailedEventData extends IAddressActionEventData {
+    error: string;
+}

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

@@ -50,7 +50,7 @@ export interface ICartItemEngravingUpdatedEventData {
 }
 export interface ICartPromoCodeEventData {
     cartId: string;
-    discountAmount?: number;
+    discount?: number;
     newSubtotal?: number;
 }
 export interface ICartPromoCodeFailedEventData {

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

@@ -1,25 +1,56 @@
-import type { ICartItemAttributes } from '@/interfaces/api/cart.interface';
-import type { ICheckoutTotalAmounts } from '@/interfaces/cloud';
+import type { ICheckoutAmounts, ICheckoutItem } from '@/interfaces/api/checkout.interface';
 export interface IBaseCheckoutEventData {
+    token: string;
     cartId: string;
+    isGift: boolean;
+    billingSameAsShipping: boolean;
+    marketingPreferences: {
+        canEmail: boolean;
+        canSms: boolean;
+    };
+    hasPromoCode: boolean;
+    hasGiftCards: boolean;
+    amounts: ICheckoutAmounts;
+    itemCount: number;
+    items: Record<string, ICheckoutItem>;
 }
 export interface ICheckoutLoadedEventData extends IBaseCheckoutEventData {
 }
+export interface ICheckoutDetailsEventData extends IBaseCheckoutEventData {
+}
+export interface ICheckoutCustomerInformationUpdatedEventData {
+    cartId: string;
+}
+export interface ICheckoutGiftInformationUpdatedEventData {
+    cartId: string;
+}
+export interface ICheckoutBillingInformationUpdatedEventData {
+    cartId: string;
+}
 export interface ICheckoutTipUpdatedEventData {
+    cartId: string;
     deliveryTips: Array<{
-        fulfillmentId?: string;
-        tipAmount?: number;
+        fulfillmentId: string;
+        tip: number;
+    }>;
+    previousDeliveryTips: Array<{
+        fulfillmentId: string;
+        tip: number;
     }>;
 }
 export interface ICheckoutFailedEventData {
     message: string;
 }
 export interface ICheckoutToggleEventData {
+    cartId: string;
     isActive: boolean;
+    previousIsActive: boolean;
 }
 export interface ICheckoutMarketingPreferencesToggleEventData {
+    cartId: string;
     fieldName: 'canEmail' | 'canSms';
     isActive: boolean;
+    previousIsActive: boolean;
 }
 export interface ICheckoutSubmitStartedEventData {
     started: boolean;
@@ -49,7 +80,7 @@ export interface ICheckoutItemEngravingUpdatedEventData {
 }
 export interface ICheckoutPromoCodeEventData {
     cartId: string;
-    discountAmount?: number;
+    discount?: number;
     newTotal?: number;
 }
 export interface ICheckoutPromoCodeFailedEventData {
@@ -76,49 +107,3 @@ export interface ICheckoutProductAddFailedEventData {
     error: string;
     isPresale?: boolean;
 }
-export interface ICheckoutItemEventData {
-    liquidId: string;
-    variantId: string;
-    cartItemId: string;
-    retailerId: string;
-    fulfillmentId: string;
-    salsifyGrouping: string;
-    name: string;
-    catPath: string;
-    volume: string;
-    uom: string;
-    proof: string;
-    abv: string;
-    containerType: string;
-    container: string;
-    size: string;
-    pack: boolean;
-    packDesc: string;
-    mainImage: string;
-    brand: string;
-    partNumber: string;
-    upc: string;
-    sku: string;
-    price: number;
-    unitPrice: number;
-    quantity: number;
-    unitTax: number;
-    bottleDeposits: number;
-    attributes: ICartItemAttributes;
-    retailerName: string;
-    expectationDetail: string;
-}
-export interface ICheckoutDetailsEventData {
-    cartId: string;
-    isGift: boolean;
-    billingSameAsShipping: boolean;
-    marketingPreferences: {
-        canEmail: boolean;
-        canSms: boolean;
-    };
-    hasPromoCode: boolean;
-    hasGiftCards: boolean;
-    amounts: ICheckoutTotalAmounts;
-    itemCount: number;
-    items: Record<string, ICheckoutItemEventData>;
-}