@hachther/akilio-widget 0.6.1 → 0.6.5

package/dist/types.d.ts

@@ -1,4 +1,5 @@
 import type { ReactNode } from 'react';
+import type { AkilioResolvedCopy } from './lib/copy';
 export type AkilioMode = 'floating' | 'inline' | 'side-panel' | 'drawer' | 'hybrid';
 export type AkilioColorMode = 'light' | 'dark' | 'system';
 export type AkilioLocale = string;
@@ -9,6 +10,7 @@ export type AkilioWidgetBranding = 'akilio_required' | 'removable' | 'white_labe
 export type AkilioCommerceCapabilityType = 'product_search' | 'product_recommendation';
 export type AkilioCommerceEventType = 'search' | 'recommendation' | 'compare' | 'add_to_cart' | 'checkout' | 'purchase';
 export type AkilioCredentialsMode = 'omit' | 'same-origin' | 'include';
+export type StreamEventType = 'open' | 'close' | 'answer-complete' | 'question' | 'answer-start' | 'answer-delta' | 'error' | 'typing-cancel' | 'draft-change' | 'typing-start' | 'typing-complete' | 'reset' | 'ready';
 export type AkilioTokenProvider = () => string | null | undefined | Promise<string | null | undefined>;
 export interface AkilioIssuedWidgetToken {
     token: string;
@@ -36,21 +38,20 @@ export interface AkilioAuthConfig {
     onWidgetToken?: (token: AkilioIssuedWidgetToken) => void;
 }
 export interface AkilioThemeConfig {
-    primary?: string;
-    primaryDark?: string;
-    primaryForeground?: string;
-    accent?: string;
-    surface?: string;
-    text?: string;
-    muted?: string;
+    primary_color?: string;
+    primary_dark_color?: string;
+    primary_foreground_color?: string;
+    accent_color?: string;
+    surface_color?: string;
+    text_color?: string;
+    muted_color?: string;
     radius?: string;
-    launcherLabel?: string;
-    panelWidth?: number;
-    zIndex?: number;
-    logoUrl?: string;
-    brandName?: string;
-    colorMode?: AkilioColorMode;
-    [key: string]: unknown;
+    launcher_label?: string;
+    panel_width?: number;
+    z_index?: number;
+    logo_url?: string;
+    brand_name?: string;
+    color_mode?: AkilioColorMode;
 }
 export interface AkilioPageContext {
     url?: string;
@@ -188,6 +189,7 @@ export interface AkilioChatStreamHandlers {
     onStatus?: (stage: string, data: Record<string, unknown>) => void;
     onConversation?: (conversationId: string) => void;
     onDelta?: (delta: string) => void;
+    onFinish?: (finalResponse: AkilioChatResponse) => void;
 }
 export type AkilioPublicApiErrorCode = 'NOT_READY' | 'INVALID_QUESTION' | 'EMPTY_DRAFT' | 'BUSY' | 'TYPING_CANCELLED' | 'STREAM_FAILED' | 'RESET_FAILED';
 export interface AkilioDraftOptions {
@@ -297,6 +299,11 @@ export interface AkilioCopyOverrides {
     privacyRequired?: string;
     widgetUnavailable?: string;
     poweredBy?: string;
+    aiContentWarning?: string;
+    tourTitle?: string;
+    tourMessage?: string;
+    tourAction?: string;
+    tourDismiss?: string;
     privacyDefaultNotice?: string;
     switchToLightMode?: string;
     switchToDarkMode?: string;
@@ -315,8 +322,9 @@ export interface AkilioLauncherRenderProps {
 }
 export type AkilioLauncher = 'default' | 'hidden' | ((controls: AkilioLauncherRenderProps) => ReactNode);
 export type AkilioStyleIsolation = 'shadow' | 'scoped' | 'none';
+export type IntegrationType = 'shopify' | 'woocommerce' | 'wordpress' | 'prestashop' | 'magento' | 'wix' | 'webflow' | 'squarespace' | 'nextjs' | 'react' | 'vue' | 'angular' | 'vanilla' | 'unknown';
 export interface AkilioWidgetProps {
-    apiBaseUrl: string;
+    apiBaseUrl?: string;
     projectKey: string;
     locale?: AkilioLocale;
     mode?: AkilioMode;
@@ -338,7 +346,12 @@ export interface AkilioWidgetProps {
     /** Built-in launcher, no launcher, or a custom React launcher renderer. */
     launcher?: AkilioLauncher;
     persistOpenState?: boolean;
+    /** Show a one-time, dependency-free coachmark beside the default launcher. */
     enableTour?: boolean;
+    /** Delay before the automatic coachmark appears. Defaults to 3000ms. */
+    tourDelayMs?: number;
+    /** Change this value to show a revised coachmark again. Defaults to "v1". */
+    tourVersion?: string;
     enableLocalHistory?: boolean;
     enableServerHistorySync?: boolean;
     anonymousId?: string;
@@ -365,4 +378,41 @@ export interface AkilioWidgetProps {
     onMessage?: (message: AkilioChatMessage) => void;
     onProductClick?: (product: AkilioProduct, variant?: AkilioProductVariant) => void;
     onError?: (error: Error) => void;
+    integration?: IntegrationType;
+}
+export interface ChatPanelProps {
+    open: boolean;
+    isDesktop: boolean;
+    inline: boolean;
+    colorMode: 'light' | 'dark';
+    allowColorModeToggle: boolean;
+    widgetAvailable: boolean;
+    showBranding: boolean;
+    showPoweredBy: boolean;
+    copy: AkilioResolvedCopy;
+    locale: string;
+    messages: AkilioChatMessage[];
+    streamingMessage?: AkilioChatMessage | null;
+    loading: boolean;
+    loadingLabel?: string;
+    consentDecision: 'pending' | 'accepted' | 'rejected';
+    consentGranted: boolean;
+    requireConsent: boolean;
+    privacyNotice: string;
+    privacyNoticeUrl?: string;
+    onConsentDecision: (decision: 'pending' | 'accepted' | 'rejected') => void;
+    onClose: () => void;
+    onToggleColorMode: () => void;
+    onClear: () => void;
+    onSubmit: (query: string) => Promise<AkilioChatResponse>;
+    onDraftChange?: (draft: string, manual: boolean) => void;
+    onFeedback: (message: AkilioChatMessage, rating: AkilioFeedbackRating) => void;
+    onSuggestion: (suggestion: string) => void;
+    onProductClick: (message: AkilioChatMessage, product: AkilioProduct, variant?: AkilioProductVariant) => void;
+    primaryColor?: string;
 }
+export type IntegrationDetection = {
+    integration: IntegrationType;
+    confidence: 'high' | 'medium' | 'low';
+    signals: string[];
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hachther/akilio-widget",
-  "version": "0.6.1",
+  "version": "0.6.5",
   "description": "Embeddable React AI assistant widget for Akilio backend.",
   "license": "UNLICENSED",
   "type": "module",
@@ -32,12 +32,13 @@
   },
   "dependencies": {
     "clsx": "^2.1.1",
-    "driver.js": "^1.8.0",
     "react-markdown": "^10.1.0",
     "rehype-highlight": "^7.0.2",
+    "rehype-raw": "^7.0.0",
     "remark-gfm": "^4.0.1"
   },
   "devDependencies": {
+    "@testing-library/dom": "^10.4.1",
     "@testing-library/react": "^16.3.2",
     "@types/react": "^19.0.0",
     "@types/react-dom": "^19.0.0",