@huskel/sdk 0.4.2 → 0.4.6

package/dist/index.d.ts

@@ -49,11 +49,36 @@ interface RawProductInput {
     tags?: string[];
     specs?: Record<string, string>;
 }
+interface CartItem {
+    id: string;
+    cart_id: string;
+    external_id?: string;
+    product_url: string;
+    name: string;
+    price: string;
+    price_numeric: number;
+    currency: string;
+    image: string;
+    brand: string;
+    category: string;
+    quantity: number;
+}
+interface CartPayload {
+    cart_id: string;
+    shopper_id: string;
+    site_id: string;
+    status: string;
+    items: CartItem[];
+    total: number;
+    currency: string;
+    item_count: number;
+}
 interface HuskelConfig {
     siteId?: string;
     apiUrl?: string;
     apiToken?: string;
     shopperId?: string;
+    onCheckout?: (cart: CartPayload) => void;
 }
 interface SearchRequest {
     query: string;
@@ -78,6 +103,13 @@ interface HuskelError {
     status: number;
     message: string;
 }
+interface HuskelTheme {
+    primaryColor?: string;
+    backgroundColor?: string;
+    textColor?: string;
+    fontFamily?: string;
+    borderRadius?: string;
+}
 
 declare class HuskelAPI {
     private apiUrl;
@@ -98,7 +130,14 @@ declare class HuskelAPI {
     }>): Promise<{
         answer: string;
         sources: any[];
+        checkout?: CartPayload;
+        action?: any;
     }>;
+    private buildHeaders;
+    getCart(): Promise<CartPayload>;
+    clearCart(): Promise<CartPayload>;
+    checkoutCart(): Promise<CartPayload>;
+    getCheckoutConfig(): Promise<any>;
 }
 
 declare class HuskelClient {
@@ -109,11 +148,13 @@ declare class HuskelClient {
     private onlineHandler;
     private shopperId?;
     private sessionId;
+    onCheckout?: (cart: CartPayload) => void;
     private static INGEST_CACHE_KEY;
     private static INGEST_CACHE_TTL;
     private loadIngestedCache;
     private saveIngestedCache;
     constructor(config: HuskelConfig);
+    reRegister(): void;
     setShopperId(id: string | undefined): void;
     getShopperId(): string | undefined;
     getSessionId(): string;
@@ -189,27 +230,28 @@ interface UseChatReturn {
     sources: ChatSource[];
     loading: boolean;
     error: string | null;
-    send: (query: string) => Promise<void>;
+    send: (query: string, displayQuery?: string) => Promise<void>;
     reset: () => void;
 }
 declare function useChat(): UseChatReturn;
 
+declare function useCart(): {
+    cart: CartPayload | null;
+    loading: boolean;
+    fetchCart: () => Promise<void>;
+};
+
 interface SearchBarProps {
     placeholder?: string;
     limit?: number;
-    /** Debounce in ms — default 80 for near-instant feel */
+    /** Debounce in ms — default 300 for smooth type-ahead */
     debounceMs?: number;
     onSelect?: (result: SearchResult) => void;
     className?: string;
     inputClassName?: string;
     dropdownClassName?: string;
     renderResult?: (result: SearchResult) => React.ReactNode;
-    theme?: {
-        primaryColor?: string;
-        backgroundColor?: string;
-        textColor?: string;
-        fontFamily?: string;
-    };
+    theme?: HuskelTheme;
     classNames?: {
         root?: string;
         input?: string;
@@ -231,20 +273,16 @@ interface SparkleProps {
     className?: string;
     /** Called when user clicks a result — return false to prevent default navigation */
     onNavigate?: (result: SearchResult) => boolean | void;
-    theme?: {
-        primaryColor?: string;
-        backgroundColor?: string;
-        textColor?: string;
-        fontFamily?: string;
-    };
+    theme?: HuskelTheme;
     classNames?: {
         button?: string;
         backdrop?: string;
         card?: string;
         item?: string;
     };
+    product?: Product;
 }
-declare function Sparkle({ productName, limit, onResult, backdropColor, backdropBlur, className, onNavigate, theme, classNames, }: SparkleProps): react_jsx_runtime.JSX.Element;
+declare function Sparkle({ productName, limit, onResult, backdropColor, backdropBlur, className, onNavigate, theme, classNames, product, }: SparkleProps): react_jsx_runtime.JSX.Element;
 
 interface ChatWidgetProps {
     title?: string;
@@ -253,12 +291,7 @@ interface ChatWidgetProps {
     emptyStateSuggestions?: string;
     defaultCurrency?: string;
     className?: string;
-    theme?: {
-        primaryColor?: string;
-        backgroundColor?: string;
-        textColor?: string;
-        fontFamily?: string;
-    };
+    theme?: HuskelTheme;
     classNames?: {
         root?: string;
         header?: string;
@@ -279,12 +312,7 @@ interface AIChatButtonProps {
     onSelectSource?: (source: ChatSource) => void;
     defaultCurrency?: string;
     chips?: string[];
-    theme?: {
-        primaryColor?: string;
-        backgroundColor?: string;
-        textColor?: string;
-        fontFamily?: string;
-    };
+    theme?: HuskelTheme;
     classNames?: {
         button?: string;
         overlay?: string;
@@ -295,9 +323,19 @@ interface AIChatButtonProps {
 }
 declare function AIChatButton({ label, title, placeholder, backdropColor, backdropBlur, className, onSelectSource, defaultCurrency, chips, theme, classNames, }: AIChatButtonProps): react_jsx_runtime.JSX.Element;
 
+declare function CartBadge({ className }: {
+    className?: string;
+}): react_jsx_runtime.JSX.Element | null;
+
+declare function CartDrawer({ trigger, className, theme }: {
+    trigger?: React.ReactNode;
+    className?: string;
+    theme?: 'light' | 'dark' | HuskelTheme;
+}): react_jsx_runtime.JSX.Element;
+
 interface HuskelProviderProps extends HuskelConfig {
     children: React.ReactNode;
 }
 declare function HuskelProvider({ siteId, apiUrl, apiToken, shopperId, children }: HuskelProviderProps): react_jsx_runtime.JSX.Element;
 
-export { AIChatButton, type ChatMessage, type ChatSource, ChatWidget, HuskelAPI, HuskelClient, type HuskelConfig, type HuskelError, HuskelProvider, type IngestResponse, type Product, type RawProductInput, SearchBar, type SearchRequest, type SearchResponse, type SearchResult, Sparkle, getHuskelClient, initHuskel, useChat, useHuskel, useIngest, usePageIngest, useSearch };
+export { AIChatButton, CartBadge, CartDrawer, type ChatMessage, type ChatSource, ChatWidget, HuskelAPI, HuskelClient, type HuskelConfig, type HuskelError, HuskelProvider, type IngestResponse, type Product, type RawProductInput, SearchBar, type SearchRequest, type SearchResponse, type SearchResult, Sparkle, getHuskelClient, initHuskel, useCart, useChat, useHuskel, useIngest, usePageIngest, useSearch };