@snf/qa-bot-core 0.2.36 → 0.2.37

package/dist/types/components/TurnstileWidget.d.ts

@@ -1,8 +1,9 @@
 import React from 'react';
+export type TurnstileWidgetFailureReason = 'widget_error' | 'token_expired' | 'script_load_failed' | 'api_unavailable' | 'user_cancelled';
 interface TurnstileWidgetProps {
     siteKey: string;
     onVerify: (token: string) => void;
-    onError?: () => void;
+    onError?: (reason: TurnstileWidgetFailureReason, errorCode?: string) => void;
     loginUrl?: string;
 }
 /**

package/dist/types/components/icons/BaseIcon.d.ts

@@ -1,9 +1,9 @@
-export default BaseIcon;
-declare function BaseIcon({ width, height, color, children, ...props }: {
-    [x: string]: any;
-    width?: number;
-    height?: number;
-    color?: string;
-    children: any;
-}): React.JSX.Element;
 import React from 'react';
+interface BaseIconProps extends React.SVGAttributes<SVGSVGElement> {
+    width?: number | string;
+    height?: number | string;
+    color?: string;
+    children?: React.ReactNode;
+}
+declare const BaseIcon: React.FC<BaseIconProps>;
+export default BaseIcon;

package/dist/types/components/icons/HomeIcon.d.ts

@@ -0,0 +1,3 @@
+import React from 'react';
+declare const HomeIcon: React.FC<React.SVGAttributes<SVGSVGElement>>;
+export default HomeIcon;

package/dist/types/components/icons/RefreshIcon.d.ts

@@ -1,3 +1,3 @@
-export default RefreshIcon;
-declare function RefreshIcon(props: any): React.JSX.Element;
 import React from 'react';
+declare const RefreshIcon: React.FC<React.SVGAttributes<SVGSVGElement>>;
+export default RefreshIcon;

package/dist/types/components/icons/UploadIcon.d.ts

@@ -1,3 +1,3 @@
-export default UploadIcon;
-declare function UploadIcon(props: any): React.JSX.Element;
 import React from 'react';
+declare const UploadIcon: React.FC<React.SVGAttributes<SVGSVGElement>>;
+export default UploadIcon;

package/dist/types/config.d.ts

@@ -2,7 +2,7 @@ import type { Settings, Flow } from 'react-chatbotify';
 /**
  * Analytics event types fired by qa-bot-core
  */
-export type QABotAnalyticsEventType = 'chatbot_open' | 'chatbot_close' | 'chatbot_new_chat' | 'chatbot_question_sent' | 'chatbot_answer_received' | 'chatbot_answer_error' | 'chatbot_rating_sent' | 'chatbot_login_prompt_shown' | 'chatbot_login_clicked' | 'chatbot_link_clicked' | 'chatbot_turnstile_shown' | 'chatbot_turnstile_completed' | 'chatbot_turnstile_error';
+export type QABotAnalyticsEventType = 'chatbot_open' | 'chatbot_close' | 'chatbot_new_chat' | 'chatbot_question_sent' | 'chatbot_answer_received' | 'chatbot_answer_error' | 'chatbot_rating_sent' | 'chatbot_login_prompt_shown' | 'chatbot_login_clicked' | 'chatbot_link_clicked' | 'chatbot_turnstile_shown' | 'chatbot_turnstile_completed' | 'chatbot_turnstile_error' | 'chatbot_turnstile_silent_failed';
 /**
  * Analytics event payload
  *
@@ -23,6 +23,10 @@ export type QABotAnalyticsEventType = 'chatbot_open' | 'chatbot_close' | 'chatbo
  * - chatbot_login_prompt_shown: (common fields only)
  * - chatbot_login_clicked: loginUrl
  * - chatbot_link_clicked: linkUrl, linkText
+ * - chatbot_turnstile_shown: queryId — visible challenge displayed to user
+ * - chatbot_turnstile_completed: queryId — user solved visible challenge
+ * - chatbot_turnstile_error: queryId, failureReason — visible challenge failed
+ * - chatbot_turnstile_silent_failed: failureReason — silent verification failed on page load
  */
 export interface QABotAnalyticsEvent {
     type: QABotAnalyticsEventType;
@@ -37,6 +41,8 @@ export interface QABotAnalyticsEvent {
     responseLength?: number;
     hasMetadata?: boolean;
     errorType?: string;
+    failureReason?: 'widget_error' | 'token_expired' | 'script_load_failed' | 'api_unavailable' | 'user_cancelled';
+    cloudflareErrorCode?: string;
     rating?: 'helpful' | 'not_helpful';
     messageCount?: number;
     durationMs?: number;

package/dist/types/hooks/useTurnstile.d.ts

@@ -14,6 +14,7 @@
  * `refresh-expired: auto` handles re-issuing before expiry.
  */
 export type TurnstileStatus = 'idle' | 'loading' | 'verified' | 'failed';
+export type TurnstileFailureReason = 'widget_error' | 'token_expired' | 'script_load_failed' | 'api_unavailable' | 'user_cancelled';
 export interface UseTurnstileResult {
     /** Current Turnstile token, or null if not yet verified / failed. */
     token: string | null;
@@ -22,8 +23,15 @@ export interface UseTurnstileResult {
     /** Reset the widget to generate a fresh token (call after each successful use). */
     reset: () => void;
 }
+interface TurnstileAnalyticsEvent {
+    type: 'chatbot_turnstile_silent_failed';
+    failureReason: TurnstileFailureReason;
+    cloudflareErrorCode?: string;
+}
 /**
  * @param siteKey  Cloudflare Turnstile site key.  Pass `undefined` or empty
  *                 string to disable (hook becomes a no-op).
+ * @param onEvent  Optional analytics callback for silent verification failures.
  */
-export declare function useTurnstile(siteKey: string | undefined): UseTurnstileResult;
+export declare function useTurnstile(siteKey: string | undefined, onEvent?: (event: TurnstileAnalyticsEvent) => void): UseTurnstileResult;
+export {};

package/dist/types/utils/flows/qa-flow.d.ts

@@ -16,8 +16,9 @@ export interface CreateQAFlowParams {
     sessionId: () => string | null;
     /** Function that returns whether we're currently resetting */
     isResetting?: () => boolean;
-    /** Whether the user is logged in (required) */
-    isLoggedIn: boolean;
+    /** Whether the user is logged in. `undefined` means "open access mode" —
+     *  treated as logged-in for gating purposes. */
+    isLoggedIn?: boolean;
     /** Allow Q&A without login (default: false) */
     allowAnonAccess?: boolean;
     /** Login URL to redirect to (optional) */
@@ -59,7 +60,7 @@ export declare const createQAFlow: ({ endpoint, ratingEndpoint, agentRatingEndpo
     };
 } | {
     qa_loop: {
-        message: (chatState: any) => Promise<"Thanks for the feedback!" | "One moment — verifying your session…" | "I apologize, but I'm having trouble processing your question. Please try again later.">;
+        message: (chatState: any) => Promise<"Thanks for the feedback!" | "One moment — verifying your session…" | "I apologize, but I'm having trouble processing your question. Please try again later." | undefined>;
         options: (chatState: any) => string[];
         renderMarkdown: string[];
         chatDisabled: boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@snf/qa-bot-core",
-  "version": "0.2.36",
+  "version": "0.2.37",
   "description": "A configurable chatbot setup for quick integration of RAG-powered Q&A and rating system",
   "main": "./dist/qa-bot-core.umd.cjs",
   "module": "./dist/qa-bot-core.js",
@@ -19,8 +19,8 @@
   ],
   "dependencies": {
     "@rcb-plugins/html-renderer": "^0.3.1",
-    "@rcb-plugins/markdown-renderer": "^0.3.1",
     "@rcb-plugins/input-validator": "^0.3.0",
+    "@rcb-plugins/markdown-renderer": "^0.3.1",
     "react-chatbotify": "^2.5.0",
     "uuid": "^11.1.0"
   },