@liquidcommerce/elements-sdk 2.2.0-beta.4 → 2.2.0-beta.41

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

@@ -1,5 +1,4 @@
-import type { ICheckoutItemStore } from '@/core/store';
-import type { ICheckoutTotalAmounts } from '@/interfaces/cloud';
+import type { ICartItemAttributes, ICheckoutTotalAmounts } from '@/interfaces/cloud';
 export interface IBaseCheckoutEventData {
     cartId: string;
 }
@@ -67,18 +66,59 @@ export interface ICheckoutGiftCardFailedEventData {
 export interface ICheckoutProductAddEventData {
     itemsAdded: number;
     identifiers: string[];
+    isPresale?: boolean;
 }
 export interface ICheckoutProductAddFailedEventData {
     identifiers: string[];
     error: string;
+    isPresale?: boolean;
 }
-export interface ICheckoutDetails {
+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;
-    amounts: ICheckoutTotalAmounts;
-    items: Record<string, Omit<ICheckoutItemStore, 'attributes'>>;
-    isGift: boolean;
+    acceptedAccountCreation: boolean;
     hasAgeVerify: boolean;
+    hasSubstitutionPolicy: boolean;
+    isGift: boolean;
+    billingSameAsShipping: boolean;
+    marketingPreferences: {
+        canEmail: boolean;
+        canSms: boolean;
+    };
     hasPromoCode: boolean;
     hasGiftCards: boolean;
+    amounts: ICheckoutTotalAmounts;
     itemCount: number;
+    items: Record<string, ICheckoutItemEventData>;
 }

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

@@ -1,4 +1,7 @@
-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 } from '@/core/pubsub/interfaces/address.interface';
+import type { ICartFailedEventData, ICartItemAddedEventData, ICartItemEngravingUpdatedEventData, ICartItemQuantityChangedEventData, ICartItemRemovedEventData, ICartLoadedEventData, ICartProductAddEventData, ICartProductAddFailedEventData, ICartPromoCodeEventData, ICartPromoCodeFailedEventData, ICartUpdatedEventData } from '@/core/pubsub/interfaces/cart.interface';
+import type { ICheckoutFailedEventData, ICheckoutFormUpdatedEventData, ICheckoutGiftCardEventData, ICheckoutGiftCardFailedEventData, ICheckoutItemEngravingUpdatedEventData, ICheckoutItemQuantityChangedEventData, ICheckoutItemRemovedEventData, ICheckoutLoadedEventData, ICheckoutMarketingPreferencesToggleEventData, ICheckoutProductAddEventData, ICheckoutProductAddFailedEventData, ICheckoutPromoCodeEventData, ICheckoutPromoCodeFailedEventData, ICheckoutSubmitCompletedEventData, ICheckoutSubmitFailedEventData, ICheckoutSubmitStartedEventData, ICheckoutTipUpdatedEventData, ICheckoutToggleEventData } from '@/core/pubsub/interfaces/checkout.interface';
+import type { IElementsClientIsReadyEventData, IProductAddToCartEventData, IProductFulfillmentChangedEventData, IProductFulfillmentTypeChangedEventData, IProductLoadedEventData, IProductQuantityChangedEventData, IProductSizeChangedEventData } from '@/core/pubsub/interfaces/product.interface';
 import { ELEMENTS_ACTIONS_EVENT } from '@/enums';
 export interface IEventMetadata {
     eventId: string;
@@ -21,7 +24,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 +73,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

@@ -9,6 +9,8 @@ export interface IElementsClientIsReadyEventData {
 export interface IBaseProductFulfillmentEventData {
     price: number;
     partNumber: string;
+    stock: number;
+    isEngravable: boolean;
     fulfillmentId: string;
     fulfillmentType: FulfillmentType;
     modalities: FulfillmentType[];
@@ -17,6 +19,23 @@ export interface IBaseProductFulfillmentEventData {
     retailerAddress: (IAddress & ICoords) | null;
     retailerTimezone: string;
 }
+export interface IBaseProductSizeAttributesEventData {
+    engraving?: {
+        status: boolean;
+        maxLines: number;
+        maxCharsPerLine: number;
+        fee: number;
+        location: string;
+    };
+    presale?: {
+        canPurchaseOn: null | string;
+        estimatedShipBy: null | string;
+        isActive: boolean;
+        language: string;
+        presaleLimit: number;
+        price: number;
+    };
+}
 export interface IBaseProductSizeEventData {
     id: string;
     upc: string;
@@ -29,17 +48,40 @@ export interface IBaseProductSizeEventData {
     image: string;
     uom: string;
     volume: string;
+    attributes: IBaseProductSizeAttributesEventData;
     shippingFulfillments: Record<string, IBaseProductFulfillmentEventData>;
     onDemandFulfillments: Record<string, IBaseProductFulfillmentEventData>;
 }
 export interface IBaseProductEventData {
     identifier: string;
+    selectedSizeId: string | null;
+    selectedFulfillmentId: string | null;
+    selectedFulfillmentType: FulfillmentType;
     id: string;
     name: string;
     brand: string;
-    category: string;
     catPath: string;
+    category: string;
     classification: string;
+    type: string;
+    salsifyGrouping: string;
+    subType: string;
+    mainImage: string | null;
+    images: string[];
+    region: string;
+    country: string;
+    material: string;
+    abv: string;
+    proof: string;
+    age: string;
+    color: string;
+    flavor: string;
+    variety: string;
+    appellation: string;
+    vintage: string;
+    description: string;
+    htmlDescription: string;
+    tastingNotes: string;
     priceInfo: {
         min: number;
         max: number;
@@ -84,8 +126,3 @@ export interface IProductFulfillmentChangedEventData {
     previousFulfillmentId: string;
     previousFulfillmentType: FulfillmentType;
 }
-export interface IProductEngravingUpdatedEventData {
-    identifier: string;
-    engravingLines: string[];
-    previousEngravingLines: string[];
-}

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

@@ -1,6 +1,7 @@
-import type { IElementsActionsEventsMap, IElementsFormsEventsMap, SpecificActionEvent, SpecificFormEvent } from '@/core/pubsub/interfaces';
+import type { IElementsActionsEventsMap, IElementsFormsEventsMap, SpecificActionEvent, SpecificFormEvent } from '@/core/pubsub/interfaces/core.interface';
 export declare class PubSubService {
     private readonly logger;
+    private clientReadyEvent;
     constructor();
     private readonly eventPrefix;
     static getInstance(): PubSubService;
@@ -8,5 +9,5 @@ export declare class PubSubService {
     publishForm<K extends SpecificFormEvent>(eventType: K, data: IElementsFormsEventsMap[K]): void;
     private publishSpecific;
     private dispatchNativeEvents;
-    private generateEventId;
+    private setupClientReadyBuffering;
 }

package/dist/types/core/sdk-error-handler.d.ts

@@ -0,0 +1 @@
+export declare function isSDKError(error: Error | any, source?: string | null): boolean;

package/dist/types/core/singleton-manager.service.d.ts

@@ -1,12 +1,12 @@
 import type { IClientConfigs } from '@/core/client/client-config.service';
-import type { LiquidCommerceElementsClientConstructor } from '@/interfaces/core.interface';
+import type { LiquidCommerceElementsBuilderClientConstructor, LiquidCommerceElementsClientConstructor } from '@/interfaces/core.interface';
 export declare class SingletonManager {
     private static instances;
     private static clientConstructor;
     private static getInstances;
     private constructor();
-    static setClientConstructor(lceConstructor: LiquidCommerceElementsClientConstructor): void;
-    static getClientConstructor(): LiquidCommerceElementsClientConstructor | null;
+    static setClientConstructor(lceConstructor: LiquidCommerceElementsClientConstructor | LiquidCommerceElementsBuilderClientConstructor): void;
+    static getClientConstructor(): LiquidCommerceElementsClientConstructor | LiquidCommerceElementsBuilderClientConstructor | null;
     static getClassInstance<T>(className: string, instanceCreator: () => T): T;
     static getClient<T>(clientConfigs: IClientConfigs): Promise<T>;
 }

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

@@ -36,6 +36,7 @@ export interface ICartTotalsStore {
     total: number;
     shippingFee: number;
     platformFee: number;
+    giftCardTotal: number;
     engravingFee: number;
     deliveryFee: number;
     discounts: number;
@@ -75,7 +76,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,6 +1,8 @@
-import type { IAddressStore, ICheckoutBillingStore, ICheckoutCustomerStore, ICheckoutItemStore, ICheckoutMarketingPreferencesStore, ICheckoutPaymentStore, ICheckoutStore, IProductSizeStore, IProductStore } from '@/core/store';
+import type { IAddressStore } from '@/core/store/interfaces/address.interface';
+import type { ICheckoutBillingStore, ICheckoutCustomerStore, ICheckoutGiftRecipientStore, ICheckoutItemStore, ICheckoutMarketingPreferencesStore, ICheckoutPaymentStore, ICheckoutPromoCodeStore, ICheckoutReadyForSubmitStore, ICheckoutStore, ICheckoutStripeFormStatusStore } from '@/core/store/interfaces/checkout.interface';
+import type { IProductSizeStore, IProductStore } from '@/core/store/interfaces/product.interface';
 import type { ComponentType } from '@/enums';
-import type { ICartItemStore, ICartStore, ICartTotalsStore, IRetailerFulfillmentStore, IRetailerStore } from './cart.interface';
+import type { ICartItemStore, ICartPromoCodeStore, ICartStore, ICartTotalsStore, IRetailerFulfillmentStore, IRetailerStore } from './cart.interface';
 export interface IDrawerContentConfig {
     type: ComponentType;
     data?: Record<string, any>;
@@ -23,7 +25,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

@@ -49,20 +49,33 @@ export interface IProductStore {
     id: string;
     name: string;
     brand: string;
-    category: string;
     catPath: string;
+    category: string;
     classification: string;
     type: string;
-    subType: string;
     salsifyGrouping: string;
+    subType: string;
+    mainImage: string | null;
+    images: string[];
+    region: string;
+    country: string;
+    material: string;
+    abv: string;
+    proof: string;
+    age: string;
+    color: string;
+    flavor: string;
+    variety: string;
+    appellation: string;
+    vintage: string;
+    description: string;
+    htmlDescription: string;
+    tastingNotes: string;
     priceInfo?: {
         min: number;
         max: number;
         avg: number;
     };
-    description: string;
-    htmlDescription: string;
-    images: string[];
     quantity: number;
     sizes: Record<string, IProductSizeStore>;
     productHasAvailability: boolean;
@@ -74,8 +87,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.constant.d.ts

@@ -1,4 +1,8 @@
-import type { IAddressStore, ICartStore, ICheckoutStore, IGlobalStore, IProductStore, IUIStore } from '@/core/store/interfaces';
+import type { IAddressStore } from '@/core/store/interfaces/address.interface';
+import type { ICartStore } from '@/core/store/interfaces/cart.interface';
+import type { ICheckoutStore } from '@/core/store/interfaces/checkout.interface';
+import type { IGlobalStore, IUIStore } from '@/core/store/interfaces/core.interface';
+import type { IProductStore } from '@/core/store/interfaces/product.interface';
 export declare const LOCAL_STORAGE_PREFIX = "liquid_elements";
 export declare const initialProductState: IProductStore;
 export declare const initialCartState: ICartStore;

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

@@ -1,5 +1,6 @@
 import type { IOnStoreChanged } from '@/core/base-component.service';
-import type { IGlobalStore, IPersistedStore, IProductStore, StorePaths } from '@/core/store/interfaces';
+import type { IGlobalStore, IPersistedStore, StorePaths } from '@/core/store/interfaces/core.interface';
+import type { IProductStore } from '@/core/store/interfaces/product.interface';
 export declare class StoreService {
     private state;
     private listeners;
@@ -36,9 +37,10 @@ export declare class StoreService {
     private notifyListeners;
     private debouncedSave;
     forceSave(): void;
+    persist(): Promise<void>;
+    clearLocalStorage(): void;
     private saveStore;
     private loadPersistedState;
     private loadFromDBPersistence;
-    private addBeforeUnloadHandler;
     private getAddressDataFromId;
 }

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;
+}

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

@@ -0,0 +1,27 @@
+import type { ITelemetryEventOptions, TelemetryLevel } from './telemetry.interface';
+export declare class TelemetryService {
+    private config;
+    private eventQueue;
+    private batchTimer;
+    private readonly clientConfig;
+    private stats;
+    private isShuttingDown;
+    constructor();
+    static getInstance(): TelemetryService;
+    isEnabled(): boolean;
+    captureEvent(level: TelemetryLevel, message: string, options?: ITelemetryEventOptions): void;
+    private buildErrorContext;
+    private buildSDKContext;
+    private buildUserContext;
+    private buildBrowserContext;
+    private shouldCapture;
+    private addToQueue;
+    private startBatchTimer;
+    private flushQueue;
+    private createBatch;
+    private sendBatch;
+    private sendBatchViaXHR;
+    private truncateStackTrace;
+    private handleInternalError;
+    private shutdown;
+}

package/dist/types/core/utils.d.ts

@@ -21,7 +21,3 @@ export interface ICustomResponse {
 export declare function fetchAdapter(fetchFunc: FetchFunction): HttpClient;
 export declare const xhrFetch: HttpClient;
 export declare function getFetchImplementation(): HttpClient;
-export declare function objectValues<T>(obj: Record<string, T>): T[];
-export declare function objectEntries<T>(obj: Record<string, T>): Array<[string, T]>;
-export declare function arrayFind<T>(array: T[], predicate: (item: T, index: number, array: T[]) => boolean): T | undefined;
-export declare function arrayFindIndex<T>(array: T[], predicate: (item: T, index: number, array: T[]) => boolean): number;

package/dist/types/elements-base-client.d.ts

@@ -0,0 +1,49 @@
+import { ApiClientService } from '@/core/api-client.service';
+import { AuthService } from '@/core/auth.service';
+import { ClientActionService } from '@/core/client/client-action.service';
+import { ClientConfigService, type IClientConfigs } from '@/core/client/client-config.service';
+import { CommandService } from '@/core/command/command.service';
+import { DebugPanelService } from '@/core/debug-panel/debug-panel.service';
+import { FingerPrintService } from '@/core/fingerprint.service';
+import { GoogleTagManagerService } from '@/core/google-tag-manager.service';
+import { LoggerFactory } from '@/core/logger/logger-factory';
+import { StoreService } from '@/core/store/store.service';
+import { TelemetryService } from '@/core/telemetry/telemetry.service';
+import { type ComponentType } from '@/enums';
+import type { IInjectedComponent, ILiquidCommerceElementsActions, IProcessInjectElementParams } from '@/interfaces/core.interface';
+import { ThemeProviderService } from '@/modules/theme-provider/theme-provider.service';
+export declare abstract class ElementsBaseClient {
+    protected readonly authService: AuthService;
+    protected readonly clientConfig: ClientConfigService;
+    protected readonly store: StoreService;
+    protected readonly commands: CommandService;
+    protected readonly apiClient: ApiClientService;
+    protected readonly themeProvider: ThemeProviderService;
+    protected readonly fingerPrintService: FingerPrintService;
+    protected readonly googleTagManager: GoogleTagManagerService;
+    protected readonly clientAction: ClientActionService;
+    protected readonly telemetry: TelemetryService;
+    protected readonly debugPanel: DebugPanelService;
+    protected readonly logger: ReturnType<typeof LoggerFactory.get>;
+    protected clientPrepared: boolean;
+    protected componentFactoryInitialized: boolean;
+    protected cartDrawerCreated: boolean;
+    protected gtmInitialized: boolean;
+    protected injectedComponents: Map<string, IInjectedComponent>;
+    constructor(clientConfigs: IClientConfigs);
+    prepare(): Promise<void>;
+    private prepareEssentialServices;
+    private deferHeavyInitialization;
+    private initializeHeavyServices;
+    get actions(): ILiquidCommerceElementsActions;
+    protected processInjectElement(params: IProcessInjectElementParams): Promise<IInjectedComponent | null>;
+    protected ensureCartDrawerExists(): void;
+    protected ensureAllComponentsRegistered(): void;
+    protected createInjectedComponentWrapper(containerId: string, type: ComponentType, element: HTMLElement): IInjectedComponent;
+    protected rerenderInjectedComponentsByType(type: ComponentType): void;
+    protected isElementsEnabled(): boolean;
+    protected injectDisabledElementsError(containerId: string, componentName: ComponentType): void;
+    private registerEssentialComponents;
+    protected registerComponents(): void;
+    protected registerAllComponents(): void;
+}

package/dist/types/elements-builder-client.d.ts

@@ -0,0 +1,2 @@
+import type { ILiquidCommerceElementsBuilderClient, ILiquidCommerceElementsBuilderConfig } from '@/interfaces/core.interface';
+export declare function ElementsBuilder(apiKey: string, config: ILiquidCommerceElementsBuilderConfig): Promise<ILiquidCommerceElementsBuilderClient | null>;

package/dist/types/elements-client-helper.d.ts

@@ -1 +1,4 @@
+import { type ComponentType } from '@/enums';
 export declare function deepMergeConfigs<T extends Record<string, any>>(target: T, source: Partial<T>): T;
+export declare const layoutFieldToComponentTypes: Map<string, ComponentType[]>;
+export declare function getComponentTypesForLayoutFields(parentPath: string, layoutFields: Record<string, any>): ComponentType[];

package/dist/types/enums/core.enum.d.ts

@@ -14,7 +14,6 @@ export declare const ELEMENTS_ACTIONS_EVENT: {
     readonly PRODUCT_SIZE_CHANGED: "product_size_changed";
     readonly PRODUCT_FULFILLMENT_TYPE_CHANGED: "product_fulfillment_type_changed";
     readonly PRODUCT_FULFILLMENT_CHANGED: "product_fulfillment_changed";
-    readonly PRODUCT_ENGRAVING_UPDATED: "product_engraving_updated";
     readonly CART_LOADED: "cart_loaded";
     readonly CART_CLOSED: "cart_closed";
     readonly CART_OPENED: "cart_opened";
@@ -94,6 +93,9 @@ export declare const COMPONENT_TYPE: {
     readonly PRODUCT_ADD_TO_CART_SECTION: "product-add-to-cart-section";
     readonly PRODUCT_DRAWER: "product-drawer";
     readonly PRODUCT_LOADING: "product-loading";
+    readonly PRODUCT_LIST: "product-list";
+    readonly PRODUCT_LIST_CARD: "product-list-card";
+    readonly PRODUCT_LIST_FILTERS: "product-list-filters";
     readonly CART: "cart";
     readonly CART_RETAILER: "cart-retailer";
     readonly CART_ITEM: "cart-item";
@@ -132,3 +134,9 @@ export declare const FULFILLMENT_TYPE: {
     readonly SHIPPING: "shipping";
 };
 export type FulfillmentType = (typeof FULFILLMENT_TYPE)[keyof typeof FULFILLMENT_TYPE];
+export declare const DEBUG_MODE: {
+    readonly NONE: "none";
+    readonly CONSOLE: "console";
+    readonly PANEL: "panel";
+};
+export type DebugMode = (typeof DEBUG_MODE)[keyof typeof DEBUG_MODE];

package/dist/types/index.d.ts

@@ -1,3 +1,4 @@
+export * from './elements-builder-client';
 export * from './elements-client';
 export * from './enums';
 export * from './interfaces/configs';

package/dist/types/index.umd.d.ts

@@ -1,2 +1,2 @@
-import { Elements } from './index';
-export { Elements };
+import { Elements, ElementsBuilder } from './index';
+export { Elements, ElementsBuilder };

package/dist/types/interfaces/cloud/catalog.interface.d.ts

@@ -0,0 +1,43 @@
+import type { IProduct } from '@/interfaces/cloud/product.interface';
+import type { ILocBase } from './address.interface';
+import type { IRetailer } from './retailer.interface';
+export declare enum ENUM_NAVIGATION_ORDER_DIRECTION_TYPE {
+    ASC = "asc",
+    DESC = "desc"
+}
+export declare enum ENUM_ORDER_BY {
+    PRICE = "price"
+}
+export interface ICatalogParams extends ILocBase {
+    search?: string;
+    pageToken?: string;
+    entity?: string;
+    page?: number;
+    perPage?: number;
+    visitorId?: string;
+    retailers?: string[];
+    orderBy?: ENUM_ORDER_BY;
+    orderDirection?: ENUM_NAVIGATION_ORDER_DIRECTION_TYPE;
+    filters?: Array<Record<any, any>>;
+}
+export interface ICatalog {
+    retailers?: IRetailer[];
+    products?: IProduct[];
+    navigation?: INavigationSchema;
+}
+export interface ICursorSchema {
+    nextPageToken: string;
+    previousPageToken: string;
+}
+export interface INavigationSchema {
+    id: string;
+    correctedQuery: string;
+    attributionToken: string;
+    currentPage: number;
+    totalPages: number;
+    totalCount: number;
+    availableOrderBy: ENUM_ORDER_BY[];
+    availableOrderDirection: ENUM_NAVIGATION_ORDER_DIRECTION_TYPE[];
+    cursor: ICursorSchema;
+    filters: any[];
+}

package/dist/types/interfaces/cloud/index.d.ts

@@ -1,5 +1,6 @@
 export * from './address.interface';
 export * from './cart.interface';
+export * from './catalog.interface';
 export * from './checkout.interface';
 export * from './core.interface';
 export * from './product.interface';

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

@@ -153,4 +153,6 @@ export interface IProductPresale {
     estimatedShipBy: null | string;
     isActive: boolean;
     language: string;
+    presaleLimit: number;
+    price: number;
 }

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

@@ -18,6 +18,7 @@ export interface ICheckoutLayout {
     drawerHeaderText: string;
     placeOrderButtonText: string;
     placeOrderButtonShowRequiredFields: boolean;
+    checkoutCompleted: ICheckoutCompleted;
 }
 export interface ICheckoutCompleted {
     customLogo: string;
@@ -25,7 +26,6 @@ export interface ICheckoutCompleted {
 }
 export interface ICheckoutTheme {
     backgroundColor: string;
-    checkoutCompleted: ICheckoutCompleted;
 }
 export interface ICheckoutComponent {
     theme: ICheckoutTheme;

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;