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

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';
 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/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,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

@@ -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.service.d.ts

@@ -36,9 +36,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/elements-base-client.d.ts

@@ -0,0 +1,49 @@
+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';
+import { TelemetryService } from '@/core/telemetry/telemetry.service';
+import { type ComponentType } from '@/enums';
+import type { IInjectedComponent, ILiquidCommerceElementsActions, IProcessInjectElementParams } from '@/interfaces/core.interface';
+import { ApiClientService } from '@/modules/api-client';
+import { ThemeProviderService } from '@/modules/theme-provider';
+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";

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

@@ -0,0 +1,6 @@
+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/enums/index.d.ts

@@ -1,2 +1,3 @@
 export * from './cloud.enum';
 export * from './core.enum';
+export * from './debug.enum';

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/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;

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

@@ -1,6 +1,6 @@
 import type { IAddressActions, ICartActions, ICheckoutActions, IProductActions } from '@/core/client/client-action.service';
 import type { IClientConfigs } from '@/core/client/client-config.service';
-import type { ComponentType, ElementsEnv } from '@/enums';
+import type { ComponentType, DebugMode, ElementsEnv } from '@/enums';
 import type { IAddressOptions } from '@/modules/address/address.interface';
 import type { IPromoTicker, UpdateAddressComponent, UpdateCartComponent, UpdateCheckoutComponent, UpdateComponentGlobalConfigs, UpdateProductComponent } from './configs';
 export type DeepPartial<T> = {
@@ -17,13 +17,18 @@ export interface IClientCustomThemeConfig {
     cart?: UpdateCartComponent;
     checkout?: UpdateCheckoutComponent;
 }
+export interface ILiquidCommerceElementsBuilderConfig {
+    env?: ElementsEnv;
+    promoTicker?: IPromoTicker[];
+    customTheme?: IClientCustomThemeConfig;
+    debugMode?: DebugMode;
+}
 export interface ILiquidCommerceElementsConfig {
     env?: ElementsEnv;
     promoTicker?: IPromoTicker[];
     customTheme?: IClientCustomThemeConfig;
     proxy?: IElementsProxyConfig;
-    isBuilder?: boolean;
-    enableDebugging?: boolean;
+    debugMode?: DebugMode;
 }
 export interface IInjectProductElement {
     containerId: string;
@@ -34,17 +39,10 @@ export interface IBuilderInjectElementParams {
     containerId: string;
     [key: string]: any;
 }
-export interface ILiquidCommerceElementsBuilderMethod {
-    updateComponentGlobalConfigs(configs: UpdateComponentGlobalConfigs): Promise<void>;
-    updateProductComponent(configs: UpdateProductComponent): Promise<void>;
-    updateAddressComponent(configs: UpdateAddressComponent): void;
-    updateCartComponent(configs: UpdateCartComponent): void;
-    updateCheckoutComponent(configs: UpdateCheckoutComponent): void;
-    injectElement(params: IBuilderInjectElementParams): Promise<void>;
-    injectProductElement(params: IInjectProductElement[]): Promise<void>;
-    injectAddressElement(containerId: string, options?: IAddressOptions): Promise<void>;
-    injectCartElement(containerId: string): Promise<void>;
-    injectCheckoutElement(containerId: string): Promise<void>;
+export interface IInjectedComponent {
+    getType(): ComponentType;
+    getElement(): HTMLElement;
+    rerender(): void;
 }
 export interface IProcessInjectElementParams {
     type: ComponentType;
@@ -64,13 +62,30 @@ export interface ILiquidCommerceElementsActions {
     cart: ICartActions;
     checkout: ICheckoutActions;
 }
+export interface ILiquidCommerceElementsBuilderClient {
+    updateComponentGlobalConfigs(configs: UpdateComponentGlobalConfigs): Promise<void>;
+    updateProductComponent(configs: UpdateProductComponent): Promise<void>;
+    updateAddressComponent(configs: UpdateAddressComponent): void;
+    updateCartComponent(configs: UpdateCartComponent): void;
+    updateCheckoutComponent(configs: UpdateCheckoutComponent): void;
+    injectElement(params: IBuilderInjectElementParams): Promise<IInjectedComponent | null>;
+    injectProductElement(params: IInjectProductElement[]): Promise<IInjectedComponent[]>;
+    injectAddressElement(containerId: string, options?: IAddressOptions): Promise<IInjectedComponent | null>;
+    injectCartElement(containerId: string): Promise<IInjectedComponent | null>;
+    injectCheckoutElement(containerId: string, options?: {
+        simulatePresale?: boolean;
+        presaleExpiresInMinutes?: number;
+    }): Promise<IInjectedComponent | null>;
+    actions: ILiquidCommerceElementsActions;
+}
 export interface ILiquidCommerceElementsClient {
-    builder: ILiquidCommerceElementsBuilderMethod;
-    injectProductElement(params: IInjectProductElement[]): Promise<void>;
-    injectAddressElement(containerId: string, options?: IAddressOptions): Promise<void>;
-    injectCartElement(containerId: string): Promise<void>;
-    injectCheckoutElement(containerId: string): Promise<void>;
+    injectProductElement(params: IInjectProductElement[]): Promise<IInjectedComponent[]>;
+    injectAddressElement(containerId: string, options?: IAddressOptions): Promise<IInjectedComponent | null>;
+    injectCartElement(containerId: string): Promise<IInjectedComponent | null>;
+    injectCheckoutElement(containerId: string): Promise<IInjectedComponent | null>;
     ui: ILiquidCommerceElementsUIMethod;
     actions: ILiquidCommerceElementsActions;
+    getInjectedComponents(): Map<string, IInjectedComponent>;
 }
 export type LiquidCommerceElementsClientConstructor = new (clientConfigs: IClientConfigs) => ILiquidCommerceElementsClient;
+export type LiquidCommerceElementsBuilderClientConstructor = new (clientConfigs: IClientConfigs) => ILiquidCommerceElementsBuilderClient;

package/dist/types/modules/address/address.command.d.ts

@@ -10,8 +10,6 @@ export declare class AddressCommands extends BaseCommand {
     getAddressDetails(addressId: string): Promise<IAddressDetailsResult>;
     setSelectedAddress(addressData: IAddressData): Promise<void>;
     setAddressManually(address: Omit<IAddress, 'id'>, coordinates: ICoords): Promise<void>;
-    clearSelectedAddress(): void;
-    private shouldResetCartForAddressChange;
-    private persistSessionData;
+    clearSelectedAddress(): Promise<void>;
     getDetails(): IAddressData | null;
 }

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

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

package/dist/types/modules/cart/cart.commands.d.ts

@@ -23,13 +23,13 @@ export declare class CartCommands extends BaseCommand {
     handleGoToCheckout(): Promise<void>;
     applyPromoCode(promoCode: string): Promise<void>;
     removePromoCode(): Promise<void>;
-    clearPromoCodeError(): Promise<void>;
     rerenderCart(): void;
     resetCart(): Promise<void>;
     getDetails(): IBaseCartEventData;
     private buildItemUpdate;
     private syncItemsFromApiResponse;
     private syncCartMetaFromApiResponse;
+    private syncRetailersFromApiResponse;
     private updateFulfillment;
     private addNewFulfillmentAndRetailer;
     private cleanupAfterItemRemoval;

package/dist/types/modules/cart/cart.component.d.ts

@@ -1,4 +1,4 @@
-import { BaseComponent, type IOnStoreChanged } from '@/core/base-component.service';
+import { BaseComponent } from '@/core/base-component.service';
 import type { ICartComponent } from '@/interfaces/configs';
 export interface ICartComponentParams {
     isIndependentComponent: boolean;
@@ -6,6 +6,5 @@ export interface ICartComponentParams {
 export declare class CartComponent extends BaseComponent<ICartComponentParams, ICartComponent> {
     get hostClasses(): string[];
     constructor();
-    onStoreWatch(changes: IOnStoreChanged[]): void;
     protected template(): HTMLElement[];
 }

package/dist/types/modules/cart/components/cart-footer.component.d.ts

@@ -16,5 +16,6 @@ export declare class CartFooterComponent extends BaseComponent<ICartFooterCompon
     private shouldDisableCheckout;
     private updateCheckoutButtonState;
     private updateSubtotalItemsCount;
+    private handleCheckout;
     protected template(): HTMLElement[];
 }

package/dist/types/modules/cart/components/cart-item.component.d.ts

@@ -1,4 +1,4 @@
-import { BaseComponent, type IOnStoreChanged } from '@/core/base-component.service';
+import { BaseComponent } from '@/core/base-component.service';
 export interface ICartItemComponentParams {
     itemId: string;
 }
@@ -6,10 +6,6 @@ export declare class CartItemComponent extends BaseComponent<ICartItemComponentP
     get hostClasses(): string[];
     get hostAttributes(): Record<string, string>;
     constructor();
-    private getItemId;
-    onStoreChanged(changes: IOnStoreChanged[]): boolean | undefined;
-    private handleEngravingElement;
-    private updateShippingTime;
+    private handleOpenEngravingForm;
     protected template(): HTMLElement[];
-    afterRender(): void;
 }

package/dist/types/modules/cart/components/index.d.ts

@@ -1,5 +1,7 @@
 export * from './cart-body.component';
 export * from './cart-footer.component';
+export * from './cart-fulfillment.component';
+export * from './cart-fulfillment.component';
 export * from './cart-header.component';
 export * from './cart-item.component';
 export * from './cart-item-quantity-price.component';