@constructor-io/constructorio-ui-pia 2.2.0 → 2.2.1

package/lib/cjs/components/CioPia/CioPia.js

@@ -29,7 +29,7 @@ function CioPia(props) {
         suggestedQuestionsParameters,
         formatImageUrl: formatters === null || formatters === void 0 ? void 0 : formatters.formatImageUrl,
     });
-    const { currentQuestion, displayedQuestions, conversationHistory, currentAnswer, currentItems, isLoading, error, handleSubmitQuestion, resetState, } = (0, useConversation_1.default)({ pia, itemId, isConversation });
+    const { currentQuestion, displayedQuestions, conversationHistory, currentAnswer, currentItems, isLoading, error, handleSubmitQuestion, resetState, } = (0, useConversation_1.default)({ pia, itemId, isConversation, callbacks });
     const renderProps = {
         items: currentItems,
         isLoading,

package/lib/cjs/hooks/useConversation.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 const react_1 = require("react");
-function useConversation({ pia, itemId, isConversation, }) {
+function useConversation({ pia, itemId, isConversation, callbacks, }) {
     var _a, _b, _c, _d;
     const { suggestedQuestions, answers } = pia;
     const { getAnswer } = answers;
@@ -11,6 +11,8 @@ function useConversation({ pia, itemId, isConversation, }) {
     const entryIdRef = (0, react_1.useRef)(0);
     const prevAnswerValueRef = (0, react_1.useRef)((_a = answers.data) === null || _a === void 0 ? void 0 : _a.value);
     const handleSubmitQuestion = (0, react_1.useCallback)((question) => {
+        var _a;
+        (_a = callbacks === null || callbacks === void 0 ? void 0 : callbacks.onQuestionSubmit) === null || _a === void 0 ? void 0 : _a.call(callbacks, question);
         setCurrentQuestion(question);
         getAnswer(question);
         if (isConversation) {
@@ -18,7 +20,7 @@ function useConversation({ pia, itemId, isConversation, }) {
             const id = entryIdRef.current;
             setConversationHistory((prev) => [...prev, { id, question, answer: '' }]);
         }
-    }, [getAnswer, isConversation]);
+    }, [getAnswer, isConversation, callbacks]);
     const resetState = (0, react_1.useCallback)(() => {
         setCurrentQuestion('');
         setDisplayedQuestions(suggestedQuestions.data);

package/lib/cjs/version.js

@@ -1,3 +1,3 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.default = '2.2.0';
+exports.default = '2.2.1';

package/lib/mjs/components/CioPia/CioPia.js

@@ -26,7 +26,7 @@ export default function CioPia(props) {
         suggestedQuestionsParameters,
         formatImageUrl: formatters?.formatImageUrl,
     });
-    const { currentQuestion, displayedQuestions, conversationHistory, currentAnswer, currentItems, isLoading, error, handleSubmitQuestion, resetState, } = useConversation({ pia, itemId, isConversation });
+    const { currentQuestion, displayedQuestions, conversationHistory, currentAnswer, currentItems, isLoading, error, handleSubmitQuestion, resetState, } = useConversation({ pia, itemId, isConversation, callbacks });
     const renderProps = {
         items: currentItems,
         isLoading,

package/lib/mjs/hooks/useConversation.js

@@ -1,5 +1,5 @@
 import { useCallback, useEffect, useRef, useState } from 'react';
-export default function useConversation({ pia, itemId, isConversation, }) {
+export default function useConversation({ pia, itemId, isConversation, callbacks, }) {
     const { suggestedQuestions, answers } = pia;
     const { getAnswer } = answers;
     const [currentQuestion, setCurrentQuestion] = useState('');
@@ -8,6 +8,7 @@ export default function useConversation({ pia, itemId, isConversation, }) {
     const entryIdRef = useRef(0);
     const prevAnswerValueRef = useRef(answers.data?.value);
     const handleSubmitQuestion = useCallback((question) => {
+        callbacks?.onQuestionSubmit?.(question);
         setCurrentQuestion(question);
         getAnswer(question);
         if (isConversation) {
@@ -15,7 +16,7 @@ export default function useConversation({ pia, itemId, isConversation, }) {
             const id = entryIdRef.current;
             setConversationHistory((prev) => [...prev, { id, question, answer: '' }]);
         }
-    }, [getAnswer, isConversation]);
+    }, [getAnswer, isConversation, callbacks]);
     const resetState = useCallback(() => {
         setCurrentQuestion('');
         setDisplayedQuestions(suggestedQuestions.data);

package/lib/mjs/version.js

@@ -1 +1 @@
-export default '2.2.0';
+export default '2.2.1';

package/lib/types/components/CioPia/CioPia.d.ts

@@ -10,6 +10,18 @@ export interface CioPiaProps extends IncludeRenderProps<CioPiaRenderProps>, Incl
     variationId?: string;
     cioClient?: MockConstructorIOClient;
     displayConfigs?: CioPiaDisplayConfigs;
+    /**
+     * Callback handlers for user interactions:
+     *
+     * `onQuestionSubmit: (question: string) => void`
+     * Called when a question is submitted (via Enter key, Send button, or suggested question click).
+     *
+     * `onProductCardClick: (item: Item) => void`
+     * Called when a product card in the carousel is clicked.
+     *
+     * `onFeedback: (type: 'up' | 'down') => void`
+     * Called when the user submits positive or negative feedback on an answer.
+     */
     callbacks?: Callbacks;
     /** Define formatter functions outside the component or memoize to avoid unnecessary re-renders. */
     formatters?: Formatters;

package/lib/types/hooks/useConversation.d.ts

@@ -1,9 +1,10 @@
-import { ConversationEntry, Question, Item } from '../types';
+import { Callbacks, ConversationEntry, Question, Item } from '../types';
 import { UseCioPiaReturn } from './useCioPia';
 export interface UseConversationProps {
     pia: UseCioPiaReturn;
     itemId: string;
     isConversation: boolean;
+    callbacks?: Callbacks;
 }
 export interface UseConversationReturn {
     currentQuestion: string;
@@ -16,4 +17,4 @@ export interface UseConversationReturn {
     handleSubmitQuestion: (question: string) => void;
     resetState: () => void;
 }
-export default function useConversation({ pia, itemId, isConversation, }: UseConversationProps): UseConversationReturn;
+export default function useConversation({ pia, itemId, isConversation, callbacks, }: UseConversationProps): UseConversationReturn;

package/lib/types/types.d.ts

@@ -52,7 +52,11 @@ export type Translations = {
     'Ask about this product'?: string;
 };
 export interface Callbacks {
+    /** Called when a question is submitted (via Enter key, Send button, or suggested question click). */
+    onQuestionSubmit?: (question: string) => void;
+    /** Called when a product card in the carousel is clicked. */
     onProductCardClick?: (item: Item) => void;
+    /** Called when the user submits positive or negative feedback on an answer. */
     onFeedback?: (type: FeedbackType) => void;
 }
 /** Formatter functions for transforming data before display. */

package/lib/types/version.d.ts

@@ -1,2 +1,2 @@
-declare const _default: "2.2.0";
+declare const _default: "2.2.1";
 export default _default;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@constructor-io/constructorio-ui-pia",
-  "version": "2.2.0",
+  "version": "2.2.1",
   "description": "Constructor.io AI Product Insights Agent UI library for web applications",
   "author": "Constructor.io Corporation",
   "license": "MIT",