@debales/ai 1.0.1-canary.0

package/dist/browser/browser.d.ts

@@ -0,0 +1,9 @@
+interface ChatbotConfig {
+    botId: string;
+    containerId?: string;
+}
+declare function initDebalesChatbot(config: ChatbotConfig): {
+    container: HTMLElement;
+    unmount: () => void;
+} | undefined;
+export { initDebalesChatbot };

package/dist/browser/components/ChatbotComponent.d.ts

@@ -0,0 +1,17 @@
+import { ChatBoxProps } from '../types';
+declare global {
+    interface Window {
+        triggerGokwikCustomCheckout?: () => void;
+        shiprocketCheckoutEvents?: {
+            buyCart?: () => void;
+        };
+        openRzpCheckout?: () => void;
+        Thinkific?: {
+            current_user?: {
+                full_name: string;
+                email: string;
+            };
+        };
+    }
+}
+export declare const ChatbotComponent: ({ botId }: ChatBoxProps) => import("react/jsx-runtime").JSX.Element | null;

package/dist/browser/components/common/AddBulkItemsButton.d.ts

@@ -0,0 +1 @@
+export declare const AddBulkItemsButton: import('styled-components/dist/types').IStyledComponentBase<"web", import('styled-components').FastOmit<import('react').DetailedHTMLProps<import('react').ButtonHTMLAttributes<HTMLButtonElement>, HTMLButtonElement>, never>> & string;

package/dist/browser/components/common/Button.d.ts

@@ -0,0 +1,2 @@
+export declare const Button: import('styled-components/dist/types').IStyledComponentBase<"web", import('styled-components').FastOmit<import('react').DetailedHTMLProps<import('react').ButtonHTMLAttributes<HTMLButtonElement>, HTMLButtonElement>, never>> & string;
+export declare const GradientButton: import('styled-components/dist/types').IStyledComponentBase<"web", import('styled-components').FastOmit<import('react').DetailedHTMLProps<import('react').ButtonHTMLAttributes<HTMLButtonElement>, HTMLButtonElement>, never>> & string;

package/dist/browser/components/common/CheckoutButton.d.ts

@@ -0,0 +1 @@
+export declare const CheckoutButton: import('styled-components/dist/types').IStyledComponentBase<"web", import('styled-components').FastOmit<import('react').DetailedHTMLProps<import('react').AnchorHTMLAttributes<HTMLAnchorElement>, HTMLAnchorElement>, never>> & string;

package/dist/browser/components/common/CollectionSlider.d.ts

@@ -0,0 +1,11 @@
+import { default as React } from 'react';
+import { Message, UiData } from '../../types';
+interface CollectionSliderProps {
+    message: Message;
+    botId: string;
+    uidata: UiData;
+    onSendMessage: (message: string) => Promise<void>;
+    loading: boolean;
+}
+declare const CollectionSlider: React.FC<CollectionSliderProps>;
+export default CollectionSlider;

package/dist/browser/components/common/DiscountModel.d.ts

@@ -0,0 +1,8 @@
+import { UiData } from '../../types';
+interface DiscountModalProps {
+    discount: string;
+    uiData: UiData;
+    onClose: () => void;
+}
+export declare const DiscountModal: ({ discount, uiData, onClose, }: DiscountModalProps) => import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/browser/components/common/DiscountPanel.d.ts

@@ -0,0 +1,8 @@
+import { UiData } from '../../types';
+interface DiscountPanelProps {
+    discount: string;
+    uiData: UiData;
+    onClose: () => void;
+}
+export declare const DiscountPanel: ({ discount, uiData, onClose, }: DiscountPanelProps) => import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/browser/components/common/DownArrow.d.ts

@@ -0,0 +1,5 @@
+export default function DownArrow({ fill, width, height, }: {
+    fill?: string;
+    width?: number;
+    height?: number;
+}): import("react/jsx-runtime").JSX.Element;

package/dist/browser/components/common/DynamicSuggestedQuestion.d.ts

@@ -0,0 +1,15 @@
+import { default as React } from 'react';
+import { UiData } from '../../types';
+interface AnimatedSuggestionProps {
+    messages: {
+        question: string;
+        isHighlighted: boolean;
+    }[];
+    botId?: string;
+    uiData?: UiData;
+    isHighlighted?: boolean;
+    onClick?: (message: string) => void;
+    onClose?: () => void;
+}
+declare const AnimatedSuggestion: React.FC<AnimatedSuggestionProps>;
+export default AnimatedSuggestion;

package/dist/browser/components/common/ExitModal.d.ts

@@ -0,0 +1,7 @@
+import { default as React } from 'react';
+interface ExitModalProps {
+    setShowExitModal: (show: boolean) => void;
+    handleCloseChatbot: (userRating: number | null) => void;
+}
+declare const ExitModal: React.FC<ExitModalProps>;
+export default ExitModal;

package/dist/browser/components/common/Input.d.ts

@@ -0,0 +1,11 @@
+import { default as React, InputHTMLAttributes } from 'react';
+export interface FormError {
+    field: "name" | "email" | "phone";
+    message: string;
+}
+interface InputProps extends InputHTMLAttributes<HTMLInputElement> {
+    label: string;
+    FieldError: FormError | null;
+}
+declare const Input: React.FC<InputProps>;
+export default Input;

package/dist/browser/components/common/LoadingAnimation.d.ts

@@ -0,0 +1,7 @@
+import { default as React } from 'react';
+interface LoadingAnimationProps {
+    loading: boolean;
+    loadingPhrases?: string[];
+}
+declare const LoadingAnimation: React.FC<LoadingAnimationProps>;
+export default LoadingAnimation;

package/dist/browser/components/common/NormalizePrice.d.ts

@@ -0,0 +1,13 @@
+import { ShopifyStoreMeta } from '../../types';
+/**
+ * Normalizes a price string based on whether it's running in a Shopify context
+ * @param price - The price string to normalize
+ * @param storeMetaData - The store meta data
+ * @returns Formatted price string in the appropriate currency format
+ */
+export declare const normalizePrice: (price: string, storeMetaData: ShopifyStoreMeta | null) => string;
+export declare function formatSizeAndCurrency(sizeString: string, storeMetaData: ShopifyStoreMeta | null): string;
+export declare const extractNumericPrice: (price: string) => number;
+export declare const getMetaUrl: (storeUrl: string) => string;
+export declare const getShopifyStoreMeta: (storeUrl: string) => Promise<ShopifyStoreMeta>;
+export declare const formatPrice: (price: number, currency: string) => string;

package/dist/browser/components/common/PhoneInput.d.ts

@@ -0,0 +1,12 @@
+import { default as React } from 'react';
+import { FormError } from './Input';
+interface PhoneInputProps {
+    label: string;
+    name: string;
+    FieldError: FormError | null;
+    onChange?: (value: string) => void;
+    "data-cy"?: string;
+    countryCode?: string;
+}
+declare const PhoneInput: React.FC<PhoneInputProps>;
+export default PhoneInput;

package/dist/browser/components/common/ProductSlider.d.ts

@@ -0,0 +1,16 @@
+import { default as React } from 'react';
+import { EcommercePlatform, Message, Product, ShopifyStoreMeta, UiData } from '../../types';
+interface ProductSliderProps {
+    message: Message;
+    botId: string;
+    uidata: UiData;
+    onSendMessage: (message: string) => Promise<void>;
+    loading: boolean;
+    storeMetaData: ShopifyStoreMeta | null;
+    platform: EcommercePlatform;
+    setShowVariantModel: (show: boolean) => void;
+    setSelectedProduct: (product: Product) => void;
+    setCartVersion: React.Dispatch<React.SetStateAction<number>>;
+}
+declare const ProductSlider: React.FC<ProductSliderProps>;
+export default ProductSlider;

package/dist/browser/components/common/SelectLanguage.d.ts

@@ -0,0 +1,7 @@
+import { default as React } from 'react';
+interface Props {
+    selectedLanguage: string;
+    setSelectedLanguage: React.Dispatch<React.SetStateAction<string>>;
+}
+declare const LanguageSelector: ({ selectedLanguage, setSelectedLanguage }: Props) => import("react/jsx-runtime").JSX.Element;
+export default LanguageSelector;

package/dist/browser/components/common/SuggestedQuestion.d.ts

@@ -0,0 +1,19 @@
+import { default as React } from 'react';
+import { UiData } from '../../types';
+declare const SuggestionCard: import('styled-components/dist/types').IStyledComponentBase<"web", import('styled-components/dist/types').Substitute<React.DetailedHTMLProps<React.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, {
+    isHighlighted: boolean;
+    $botId: string;
+}>> & string;
+declare const CloseSuggestion: import('styled-components/dist/types').IStyledComponentBase<"web", import('styled-components').FastOmit<React.DetailedHTMLProps<React.ButtonHTMLAttributes<HTMLButtonElement>, HTMLButtonElement>, never>> & string;
+interface Props {
+    value: string;
+    onClick: React.MouseEventHandler<HTMLDivElement>;
+    index: number;
+    isHighlighted: boolean;
+    uiData: UiData;
+    botId: string;
+    onClose?: () => void;
+}
+declare function Suggestion({ value, onClick, index, isHighlighted, uiData, botId, onClose, }: Props): import("react/jsx-runtime").JSX.Element;
+export default Suggestion;
+export { CloseSuggestion, SuggestionCard };

package/dist/browser/components/common/UserInfoModel.d.ts

@@ -0,0 +1,15 @@
+import { default as React } from 'react';
+import { Product, SuggestedQuestionAnswer, UiData } from '../../types';
+interface Props {
+    uidata: UiData;
+    botName?: string;
+    botId: string;
+    botNameColor: string | undefined;
+    showModel: boolean;
+    setShowModel: React.Dispatch<React.SetStateAction<boolean>>;
+    selectedSuggestedQuestionAnswer: SuggestedQuestionAnswer | null;
+    sendMessage: (message: string, answer?: string, products?: Product[]) => Promise<void>;
+    inChat?: boolean;
+}
+export declare const UserInfoModel: ({ uidata, botId, showModel, setShowModel, selectedSuggestedQuestionAnswer, sendMessage, botNameColor, inChat, }: Props) => import("react/jsx-runtime").JSX.Element | null;
+export {};

package/dist/browser/components/common/VariantSelectionModel.d.ts

@@ -0,0 +1,18 @@
+import { default as React } from 'react';
+import { Product, UiData } from '../../types';
+interface Variant {
+    id: string;
+    title: string;
+    options: string[];
+    available: boolean;
+    price: string;
+}
+interface Props {
+    uidata: UiData;
+    product: Product | null;
+    showModel: boolean;
+    setShowModel: React.Dispatch<React.SetStateAction<boolean>>;
+    onVariantSelect: (variant: Variant) => void;
+}
+export declare const VariantSelectionModel: ({ uidata, product, showModel, setShowModel, onVariantSelect, }: Props) => import("react/jsx-runtime").JSX.Element | null;
+export {};

package/dist/browser/components/common/loading-dots.d.ts

@@ -0,0 +1,4 @@
+declare const LoadingDots: ({ color }: {
+    color: string;
+}) => import("react/jsx-runtime").JSX.Element;
+export default LoadingDots;

package/dist/browser/components/common/pop-up.d.ts

@@ -0,0 +1,2 @@
+declare function Popup(): import("react/jsx-runtime").JSX.Element | null;
+export default Popup;

package/dist/browser/components/common/shadowWrapper.d.ts

@@ -0,0 +1,10 @@
+import { default as React } from 'react';
+import { ShadowDOMRef } from '../../types';
+interface ShadowDOMWrapperProps {
+    children: React.ReactNode;
+    globalStyles?: string;
+    containerStyles?: React.CSSProperties;
+    onReady?: (shadowRoot: ShadowRoot, container: HTMLElement) => void;
+}
+export declare const ShadowDOMWrapper: React.ForwardRefExoticComponent<ShadowDOMWrapperProps & React.RefAttributes<ShadowDOMRef>>;
+export {};

package/dist/browser/components/footer/ChatInputBox.d.ts

@@ -0,0 +1,7 @@
+import { UiData } from '../../types';
+export default function ChatInputBox({ uiData, onSendMessage, disabled, inputState, }: {
+    uiData: UiData;
+    onSendMessage: (message: string) => Promise<void>;
+    disabled: boolean;
+    inputState: boolean;
+}): import("react/jsx-runtime").JSX.Element;

package/dist/browser/components/icons/index.d.ts

@@ -0,0 +1,19 @@
+import { default as React } from 'react';
+import { UiData } from '../../types';
+export declare const LeftArrow: (props: React.SVGProps<SVGSVGElement> & {
+    uiData: UiData;
+}) => import("react/jsx-runtime").JSX.Element;
+export declare const RightArrow: (props: React.SVGProps<SVGSVGElement> & {
+    uiData: UiData;
+}) => import("react/jsx-runtime").JSX.Element;
+export declare const CartIcon: (props: React.SVGProps<SVGSVGElement>) => import("react/jsx-runtime").JSX.Element;
+export declare const LinkIcon: () => import("react/jsx-runtime").JSX.Element;
+export declare const ActiveIcon: () => import("react/jsx-runtime").JSX.Element;
+export declare const SmileyIcon: () => import("react/jsx-runtime").JSX.Element;
+export declare const InfoIcon: () => import("react/jsx-runtime").JSX.Element;
+export declare const SupportIcon: (props: React.SVGProps<SVGSVGElement> & {
+    color?: string | undefined;
+}) => import("react/jsx-runtime").JSX.Element;
+export declare const CloseIcon: (props: React.SVGProps<SVGSVGElement> & {
+    botNameColor?: string | undefined;
+}) => import("react/jsx-runtime").JSX.Element;

package/dist/browser/constants/dom.d.ts

@@ -0,0 +1,2 @@
+export declare const SHADOW_ROOT_HOST_ID = "debales-ai-assistant";
+export declare const SHADOW_ROOT_CONTAINER_ID = "debales-chatbot-container";

package/dist/browser/constants/events.d.ts

@@ -0,0 +1,29 @@
+export declare const DEBALES_TRACKING_EVENTS: {
+    readonly OPEN_STATE_CHANGE: "open_state_change";
+    readonly CHAT_BUTTON_CLICKED: "Chat button clicked";
+    readonly USER_FORM_FILLED: "User form filled";
+    readonly ADD_BULK_ITEM: "Add bulk item";
+    readonly USER_FORM_CLOSE: "user_form_close";
+    readonly CHECKOUT_CLICKED: "Checkout Clicked";
+    readonly ADD_TO_CART_CLICKED: "add to cart clicked";
+    readonly SUGGESTED_QUESTION_CLICKED: "Suggested Question Clicked";
+    readonly INITIAL_LEADING_QUERY_SUGGESTED_QUESTION_CLICKED: "Initial Leading Query Suggested Question Clicked";
+    readonly LEADING_QUERY_CLICKED: "Leading Query Clicked";
+    readonly COLLECTION_VIDEO_CLICKED: "Collection Video Clicked";
+    readonly COLLECTION_IMAGE_CLICKED: "Collection Image Clicked";
+    readonly VIEW_PRODUCT_CLICKED: "view product clicked";
+    readonly PRODUCT_VIDEO_CLICKED: "Product Video Clicked";
+    readonly PRODUCT_IMAGE_CLICKED: "Product Image Clicked";
+    readonly SHOW_SIMILAR_CLICKED: "show similar clicked";
+    readonly CHAT_MESSAGE_SENT: "chat_message_sent";
+    readonly CHAT_MESSAGE_TYPED: "chat_message_typed";
+    readonly CHAT_MESSAGE_ERROR: "chat_message_error";
+    readonly CHAT_MESSAGE_TYPING_STARTED: "chat_message_typing_started";
+    readonly CHAT_MESSAGE_TYPING_ENDED: "chat_message_typing_ended";
+    readonly DISCOUNT_VIEWED: "discount_viewed";
+};
+export declare const DEBALES_CUSTOM_EVENTS: {
+    readonly USER_FORM_SUBMITTED: "user_form_submitted";
+    readonly OPEN_STATE_CHANGE: "open_state_change";
+    readonly USER_FORM_CLOSE: "user_form_close";
+};

package/dist/browser/constants/index.d.ts

@@ -0,0 +1,6 @@
+export declare const isProduction = false;
+declare const API_BASE_URL: string;
+declare const ENABLE_MIXPANEL = true;
+declare const MIXPANEL_TOKENS: Record<string, string>;
+declare const POSTHOG_KEY: string;
+export { API_BASE_URL, ENABLE_MIXPANEL, MIXPANEL_TOKENS, POSTHOG_KEY };

package/dist/browser/context/CartContext.d.ts

@@ -0,0 +1,3 @@
+import { CartContextValue } from '../types/cart';
+export declare const CartContext: import('react').Context<CartContextValue | null>;
+export declare const useCart: () => CartContextValue;

package/dist/browser/context/ShadowDomContext.d.ts

@@ -0,0 +1,3 @@
+import { ShadowDOMRef } from '../types';
+export declare const ShadowDOMContext: import('react').Context<ShadowDOMRef>;
+export declare const useShadowDOM: () => ShadowDOMRef;

package/dist/browser/index.d.ts

@@ -0,0 +1,3 @@
+import { ChatBoxProps } from './types';
+declare function Chatbot(props: ChatBoxProps): import("react/jsx-runtime").JSX.Element;
+export default Chatbot;

package/dist/browser/lib/debalesAnalytics.d.ts

@@ -0,0 +1,37 @@
+interface AnalyticsConfig {
+    projectName: string;
+    localStorageKey?: string;
+    debug?: boolean;
+    testing?: () => boolean;
+}
+type TrackPayload = {
+    distinctId: string;
+    anonId: string;
+    projectName: string;
+    eventName: string;
+    operatingSystem?: string;
+    browser?: string;
+    browserVersion?: string;
+    osVersion?: string;
+    currentUrl: string;
+    chatId: string;
+    properties?: Record<string, any> | undefined;
+};
+type IdentifyPayload = {
+    distinctId: string;
+    anonId: string[];
+    projectName: string;
+    email: string;
+    name?: string;
+    phone?: string;
+    properties?: Record<string, any> | undefined;
+};
+interface DebalesAnalyticsPublicAPI {
+    init(config: AnalyticsConfig): void;
+    identify(uniqueId: string, userProperties?: IdentifyPayload["properties"]): Promise<void>;
+    track(eventName: string, eventProperties?: TrackPayload["properties"]): void;
+    getDistinctId(): string;
+    getAnonId(): string;
+}
+declare const debalesAnalytic: DebalesAnalyticsPublicAPI;
+export default debalesAnalytic;

package/dist/browser/lib/debalesGlobalObject.d.ts

@@ -0,0 +1,2 @@
+declare const initGlobalChat: (projectId: string) => void;
+export { initGlobalChat };

package/dist/browser/lib/platformDetection.d.ts

@@ -0,0 +1,4 @@
+import { EcommercePlatform } from '../types/index';
+export declare class PlatformDetector {
+    static detect(): EcommercePlatform;
+}

package/dist/browser/lib/platfromValidator.d.ts

@@ -0,0 +1,2 @@
+import { CartPlatformAdapter } from '../types/cart';
+export declare const createPlatformValidator: <T extends CartPlatformAdapter>(adapter: T) => T;

package/dist/browser/lib/urlHelper.d.ts

@@ -0,0 +1,18 @@
+interface UTMParams {
+    source?: string;
+    medium?: string;
+    campaign?: string;
+    term?: string;
+    content?: string;
+    sessionId?: string;
+    messageId?: string;
+}
+export declare const addUtmParams: (url: string | URL, params?: UTMParams) => string;
+export declare function parseURL(url: string): {
+    isValid: true;
+    url: URL;
+} | {
+    isValid: false;
+    error: string;
+};
+export {};

package/dist/browser/lib/util.d.ts

@@ -0,0 +1,63 @@
+import { DefaultTheme } from 'styled-components';
+import { Message, SuggestedQuestionAnswer, UiData } from '../types';
+export declare const getTheme: (data: UiData) => DefaultTheme;
+export declare function getSessionId(): string;
+export declare function getMessageId(): string | null;
+export declare function setSessionId(sessionId: string): void;
+export declare function getIsFormClosedByUser(): boolean;
+export declare function setIsFormClosedByUser(value: boolean): void;
+export declare function getUserInfo(): {
+    name?: string;
+    email: string;
+    phone?: string;
+} | null;
+export declare function setUserInfo(userInfo: {
+    name?: string;
+    email?: string;
+    phone?: string;
+}): void;
+export declare function scrollToBottom(containerRef: React.RefObject<HTMLElement>): void;
+export declare function getCurrentPath(): string;
+export declare function isTestingUser(): boolean;
+/**
+ * Gets suggested questions for the current path from an array of SuggestedQuestionAnswer objects
+ *
+ * @param {SuggestedQuestionAnswer[]} questions - Array of all suggested questions
+ * @returns {SuggestedQuestionAnswer[]} - Filtered questions for the current path
+ */
+export declare function getQuestionsForCurrentPath(questions: SuggestedQuestionAnswer[]): SuggestedQuestionAnswer[];
+export declare const asyncWait: (ms: number) => Promise<unknown>;
+interface trackCheckoutOptions {
+    projectName: string;
+    /**
+     * conversationId should be combination of sessionId and projectName
+     * @example conversationId = sessionId + projectName
+     */
+    conversationId: string;
+    cartValue: number;
+    /**
+     * createdAt should in a ISO format
+     */
+    createdAt?: string;
+    /**
+     * updatedAt should in a ISO format
+     */
+    updatedAt?: string;
+    userName?: string;
+    userPhone?: string;
+    userEmail?: string;
+    anonymousUserId?: string;
+    distinctId?: string;
+}
+export declare const trackCheckout: (options: trackCheckoutOptions) => Promise<boolean>;
+export declare const initializeMixpanel: (projectName: string) => import('mixpanel-browser').OverridedMixpanel | null;
+export declare const trackEventMixpanel: (eventName: string, data: Record<string, any>) => Promise<void>;
+export declare const getMixpanelDistintId: (botId: string) => any;
+export declare function restructureData(data: any): Message;
+export declare const generateUniqueId: () => string | null;
+export declare const clearanonymousUserId: () => void;
+export declare function splitMessageIntoParagraphs(markdownText: string): string[];
+export declare const isAthflex: (botId: string) => botId is "athflex" | "athflex-2";
+export declare const isGaiabay: (botId: string) => boolean;
+export declare const splitQuestionsIntoGroups: (questions: SuggestedQuestionAnswer[]) => (SuggestedQuestionAnswer | SuggestedQuestionAnswer[])[];
+export {};

package/dist/browser/main.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/browser/provider/CartProvider.d.ts

@@ -0,0 +1,8 @@
+import { CartPlatformAdapter } from '../types/cart';
+interface CartProviderProps {
+    adapter: CartPlatformAdapter;
+    children: React.ReactNode;
+    autoFetch?: boolean;
+}
+export declare const CartProvider: React.FC<CartProviderProps>;
+export {};

package/dist/browser/provider/index.d.ts

@@ -0,0 +1,5 @@
+declare function Provider(props: {
+    children: React.ReactNode;
+    botId: string;
+}): import("react/jsx-runtime").JSX.Element;
+export default Provider;

package/dist/browser/types/cart.d.ts

@@ -0,0 +1,49 @@
+import { EcommercePlatform, Product } from '.';
+export interface CartItem {
+    id: number;
+    quantity: number;
+    properties?: Record<string, string>;
+    title: string;
+    price: number;
+    variant_id: number;
+}
+export interface CartState {
+    items: CartItem[];
+    total: number;
+    itemCount: number;
+    currency: string;
+    token: string;
+}
+export interface CartPlatformAdapter {
+    readonly platform: EcommercePlatform;
+    isSupported(): boolean;
+    fetchCart(): Promise<CartOperationResult<CartState>>;
+    addToCart(variantId: string, quantity?: number, properties?: Record<string, string>): Promise<CartOperationResult<void>>;
+    removeFromCart(itemId: number): Promise<CartOperationResult<void>>;
+    updateQuantity(cartItem: CartItem): Promise<CartOperationResult<void>>;
+    clearCart(): Promise<CartOperationResult<void>>;
+    generateCartUrl(domain: string): string;
+    generateProductUrl(domain: string, product: Product): string;
+    addCartAttributes(attributes?: Record<string, string>): Promise<CartOperationResult<void>>;
+}
+export type CartOperationResult<T> = {
+    success: true;
+    data: T;
+    message?: string;
+} | {
+    success: false;
+    error: string;
+};
+export interface CartContextValue {
+    isLoading: boolean;
+    error: string | null;
+    cart: CartState | null;
+    fetchCart: () => Promise<void>;
+    addToCart: (variantId: string, quantity?: number, properties?: Record<string, string>) => Promise<CartOperationResult<void>>;
+    removeFromCart: (itemId: number) => Promise<CartOperationResult<void>>;
+    updateQuantity: (cartItem: CartItem) => Promise<CartOperationResult<void>>;
+    clearCart: () => Promise<CartOperationResult<void>>;
+    generateCartUrl: (domain: string) => string;
+    generateProductUrl: (domain: string, product: Product) => string;
+    addCartAttributes: (attributes?: Record<string, string>) => Promise<CartOperationResult<void>>;
+}