@huskel/sdk 0.3.2 → 0.4.0

package/dist/index.d.mts

@@ -90,6 +90,15 @@ declare class HuskelAPI {
     ingest(product: Product): Promise<IngestResponse>;
     ingestBatch(products: Product[]): Promise<IngestResponse>;
     search(query: string, limit?: number): Promise<SearchResponse>;
+    searchVector(query: string, limit?: number): Promise<SearchResponse>;
+    searchAutocomplete(query: string, limit?: number): Promise<SearchResponse>;
+    chat(query: string, history?: Array<{
+        role: 'user' | 'assistant';
+        content: string;
+    }>): Promise<{
+        answer: string;
+        sources: any[];
+    }>;
 }
 
 declare class HuskelClient {
@@ -100,6 +109,10 @@ declare class HuskelClient {
     private onlineHandler;
     private shopperId?;
     private sessionId;
+    private static INGEST_CACHE_KEY;
+    private static INGEST_CACHE_TTL;
+    private loadIngestedCache;
+    private saveIngestedCache;
     constructor(config: HuskelConfig);
     setShopperId(id: string | undefined): void;
     getShopperId(): string | undefined;
@@ -158,9 +171,33 @@ declare function useIngest(): UseIngestReturn;
  */
 declare function usePageIngest(product: RawProductInput | null | undefined): void;
 
+interface ChatMessage {
+    role: 'user' | 'assistant';
+    content: string;
+}
+interface ChatSource {
+    id?: string;
+    name: string;
+    price?: string;
+    currency?: string;
+    category?: string;
+    url?: string;
+    image?: string;
+}
+interface UseChatReturn {
+    messages: ChatMessage[];
+    sources: ChatSource[];
+    loading: boolean;
+    error: string | null;
+    send: (query: string) => Promise<void>;
+    reset: () => void;
+}
+declare function useChat(): UseChatReturn;
+
 interface SearchBarProps {
     placeholder?: string;
     limit?: number;
+    /** Debounce in ms — default 80 for near-instant feel */
     debounceMs?: number;
     onSelect?: (result: SearchResult) => void;
     className?: string;
@@ -174,13 +211,40 @@ interface SparkleProps {
     productName: string;
     limit?: number;
     onResult?: (results: SearchResult[]) => void;
+    /** Override the backdrop colour (any CSS colour/gradient) */
+    backdropColor?: string;
+    /** Override backdrop blur — e.g. "8px" or 8 */
+    backdropBlur?: string | number;
+    /** Extra classes on the trigger button */
+    className?: string;
+    /** Called when user clicks a result — return false to prevent default navigation */
+    onNavigate?: (result: SearchResult) => boolean | void;
+}
+declare function Sparkle({ productName, limit, onResult, backdropColor, backdropBlur, className, onNavigate }: SparkleProps): react_jsx_runtime.JSX.Element;
+
+interface ChatWidgetProps {
+    placeholder?: string;
+    title?: string;
+    className?: string;
+    /** Called when user clicks a product link */
+    onSelectSource?: (source: ChatSource) => void;
+}
+declare function ChatWidget({ placeholder, title, className, onSelectSource }: ChatWidgetProps): react_jsx_runtime.JSX.Element;
+
+interface AIChatButtonProps {
+    label?: string;
+    title?: string;
+    placeholder?: string;
+    backdropColor?: string;
+    backdropBlur?: string | number;
     className?: string;
+    onSelectSource?: (source: ChatSource) => void;
 }
-declare function Sparkle({ productName, limit, onResult, className }: SparkleProps): react_jsx_runtime.JSX.Element;
+declare function AIChatButton({ label, title, placeholder, backdropColor, backdropBlur, className, onSelectSource, }: AIChatButtonProps): 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 { HuskelAPI, HuskelClient, type HuskelConfig, type HuskelError, HuskelProvider, type IngestResponse, type Product, type RawProductInput, SearchBar, type SearchRequest, type SearchResponse, type SearchResult, Sparkle, getHuskelClient, initHuskel, useHuskel, useIngest, usePageIngest, useSearch };
+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 };

package/dist/index.d.ts

@@ -90,6 +90,15 @@ declare class HuskelAPI {
     ingest(product: Product): Promise<IngestResponse>;
     ingestBatch(products: Product[]): Promise<IngestResponse>;
     search(query: string, limit?: number): Promise<SearchResponse>;
+    searchVector(query: string, limit?: number): Promise<SearchResponse>;
+    searchAutocomplete(query: string, limit?: number): Promise<SearchResponse>;
+    chat(query: string, history?: Array<{
+        role: 'user' | 'assistant';
+        content: string;
+    }>): Promise<{
+        answer: string;
+        sources: any[];
+    }>;
 }
 
 declare class HuskelClient {
@@ -100,6 +109,10 @@ declare class HuskelClient {
     private onlineHandler;
     private shopperId?;
     private sessionId;
+    private static INGEST_CACHE_KEY;
+    private static INGEST_CACHE_TTL;
+    private loadIngestedCache;
+    private saveIngestedCache;
     constructor(config: HuskelConfig);
     setShopperId(id: string | undefined): void;
     getShopperId(): string | undefined;
@@ -158,9 +171,33 @@ declare function useIngest(): UseIngestReturn;
  */
 declare function usePageIngest(product: RawProductInput | null | undefined): void;
 
+interface ChatMessage {
+    role: 'user' | 'assistant';
+    content: string;
+}
+interface ChatSource {
+    id?: string;
+    name: string;
+    price?: string;
+    currency?: string;
+    category?: string;
+    url?: string;
+    image?: string;
+}
+interface UseChatReturn {
+    messages: ChatMessage[];
+    sources: ChatSource[];
+    loading: boolean;
+    error: string | null;
+    send: (query: string) => Promise<void>;
+    reset: () => void;
+}
+declare function useChat(): UseChatReturn;
+
 interface SearchBarProps {
     placeholder?: string;
     limit?: number;
+    /** Debounce in ms — default 80 for near-instant feel */
     debounceMs?: number;
     onSelect?: (result: SearchResult) => void;
     className?: string;
@@ -174,13 +211,40 @@ interface SparkleProps {
     productName: string;
     limit?: number;
     onResult?: (results: SearchResult[]) => void;
+    /** Override the backdrop colour (any CSS colour/gradient) */
+    backdropColor?: string;
+    /** Override backdrop blur — e.g. "8px" or 8 */
+    backdropBlur?: string | number;
+    /** Extra classes on the trigger button */
+    className?: string;
+    /** Called when user clicks a result — return false to prevent default navigation */
+    onNavigate?: (result: SearchResult) => boolean | void;
+}
+declare function Sparkle({ productName, limit, onResult, backdropColor, backdropBlur, className, onNavigate }: SparkleProps): react_jsx_runtime.JSX.Element;
+
+interface ChatWidgetProps {
+    placeholder?: string;
+    title?: string;
+    className?: string;
+    /** Called when user clicks a product link */
+    onSelectSource?: (source: ChatSource) => void;
+}
+declare function ChatWidget({ placeholder, title, className, onSelectSource }: ChatWidgetProps): react_jsx_runtime.JSX.Element;
+
+interface AIChatButtonProps {
+    label?: string;
+    title?: string;
+    placeholder?: string;
+    backdropColor?: string;
+    backdropBlur?: string | number;
     className?: string;
+    onSelectSource?: (source: ChatSource) => void;
 }
-declare function Sparkle({ productName, limit, onResult, className }: SparkleProps): react_jsx_runtime.JSX.Element;
+declare function AIChatButton({ label, title, placeholder, backdropColor, backdropBlur, className, onSelectSource, }: AIChatButtonProps): 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 { HuskelAPI, HuskelClient, type HuskelConfig, type HuskelError, HuskelProvider, type IngestResponse, type Product, type RawProductInput, SearchBar, type SearchRequest, type SearchResponse, type SearchResult, Sparkle, getHuskelClient, initHuskel, useHuskel, useIngest, usePageIngest, useSearch };
+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 };