Changelog

Version 1.2.6

• Release Date: 30/04/2026
• Hooks Version: 1.2.6
• Components Version: 1.2.4

1. fetchInitialPrompts — optional UnbxdShoppingAssistantWrapper prop (new).
2. startNewConversation — initialLoading during the request; returns Promise<string | null>.
3. Chat / AIMessage — pass index, allData, and data into row components; MessageComponentProps exported.
4. ERROR — handleError also emits ON_EVENT with type ERROR.

1. DataFetcher — avoids redundant fetchHistory and aligns getInitialPrompts with new vs restored conversations.
2. trackAnalytics — conversation_id fallback from storage; broader allowed action list (see docs).
3. Chat — safer scroll deps (conversation?.length); failed initial conversation clears initialLoading.
4. Docs (trackAnalytics payloads, clearImage); shopping-assistant-example Popup (ResponseChatComponents, analytics demo).

1. Extra ResponseChatComponents entries receive data, allData, index instead of spreading the API value as props.

Version 1.2.5

• Release Date: 16/02/2025
• Hooks Version: 1.2.5
• Components Version: 1.2.3

1. ResponseChatComponents (Chat): The Chat component now accepts a ResponseChatComponents prop — an object that maps response data to custom React components. Use it to override how the AI response is rendered: message (text), filters (filter chips), products (product list/carousel), and any other keys returned by the API. This allows a single, extensible way to customize all parts of an assistant message.

2. requestBody as a function (UnbxdShoppingAssistantWrapper): requestBody can now be a function in addition to an object. When passed as a function, it receives a request type and returns the body for that API call. Request types: "INITIAL_CONVERSATION" (start conversation), "CHAT" (send message), and "QUESTIONS" (fetch initial prompts). Use this to send different payloads per request (e.g. different pagetype or metadata for each call).

3. extraParams as a function (UnbxdShoppingAssistantWrapper): extraParams can now be passed as a function in addition to an object. When it is a function, it receives a type argument indicating the current request type (e.g. "INITIAL_CONVERSATION", "CHAT", "HISTORY", "QUESTIONS", "CONVERSATIONS"), so you can return different extra params per request.

1. Chat: Products and FiltersComponent props removed: The Chat component no longer accepts standalone Products or FiltersComponent props. Product and filter rendering are now configured via ResponseChatComponents — use ResponseChatComponents.products and ResponseChatComponents.filters to supply custom components. The default product carousel and filters are still used when ResponseChatComponents is not provided or when those keys are omitted.

1. Analytics default value: The default value for the analytics prop on UnbxdShoppingAssistantWrapper has been updated. Ensure you set analytics={true} explicitly if you rely on analytics tracking.

Version 1.2.4

• Release Date: 22/12/2025
• Hooks Version: 1.2.4
• Components Version: 1.2.2

1. Fixed Critical Security Vulnerabilities: Resolved critical Next.js security vulnerabilities ( https://nextjs.org/blog/security-update-2025-12-11 (opens in a new tab) ) to ensure a secure development environment.

Version 1.2.3

• Release Date: 21/11/2025
• Hooks Version: 1.2.3
• Components Version: 1.2.2

Performance optimizations focused on streamlining conversation initialization and reducing unnecessary API overhead for faster user experience.

1. Added convStorageName prop to customize conversation storage key names
2. Added visualAssistant flag enabling visual search with attachImage and clearImage functions, including automatic BASE64 image conversion.

Version 1.2.0

• Release Date: 13/08/2025
• Hooks Version: 1.2.0
• Components Version: 1.2.0

Performance optimizations focused on streamlining conversation initialization and reducing unnecessary API overhead for faster user experience.

1. Optimized Conversation Initialization: Streamlined the conversation startup process by removing redundant API calls that were triggering on every conversation start, significantly improving initial load times and reducing server overhead.

1. Faster Conversation Startup: Conversations now start more quickly with optimized initialization flow.
2. Reduced API Overhead: Eliminated unnecessary API requests during conversation initialization for better performance.
3. Enhanced User Experience: Smoother and more responsive conversation flow with reduced loading times.

Version 1.1.0

• Release Date: 12/08/2025
• Components Version: 1.1.0
• Hooks Version: 1.1.0

Major API improvements with better naming conventions, enhanced configuration options, and streamlined interface management for improved developer experience.

1. apiEndPoint Configuration: Added support for custom API endpoint configuration, allowing developers to specify different backend services and deployment environments.
2. getInitialPrompts Function: New function to fetch predefined conversation starters, enabling better user onboarding and engagement.
3. Enhanced Parameter Management: Improved parameter handling with uid now passed through extraParams for better organization.

Hook Method/Variables Renames:

1. storeConversationId → storageType: Renamed for clearer purpose - now specifies how conversations are stored (localStorage/sessionStorage).
2. Initialise → startNewConversation: More descriptive name that clearly indicates starting a fresh conversation session.
3. fetchAllConversations → getAllConversations: Consistent naming convention across all getter methods.
4. ask → askAgent: More specific name indicating interaction with the AI agent.
5. appLoading → initialLoading: Clearer distinction for initial app loading state vs other loading states.

Component Changes: 6. onSend → onSubmit: Renamed Input component prop to follow standard form conventions and improve clarity.

Parameter Changes: 7. uid Parameter Location: uid now needs to be passed inside extraParams object instead of as a direct parameter for better parameter organization.

1. resetChat Function: Removed from hook as startNewConversation can be used directly for the same functionality, reducing API complexity.
2. updateConversationId Function: Removed to simplify conversation management - use startNewConversation for new conversations.

1. Proper Interface Management: Enhanced TypeScript interfaces with better type safety and clearer property definitions.
2. Consistent API Naming: All methods now follow consistent naming patterns for better developer experience.
3. Simplified Conversation Flow: Streamlined conversation management by removing redundant functions.
4. Better Parameter Organization: Grouped related parameters into objects for cleaner API structure.

Initial Release

• Release Date: 29/07/2025
• Components Version: 1.0.0
• Hooks Version: 1.0.0

The first official release of the Shopping Assistant SDK, designed for seamless integration of AI-powered conversational shopping into React applications.

1. UnbxdShoppingAssistantWrapper: Context provider for managing conversation state and API communication.
2. useShoppingAssistant Hook: Core hook providing AI interactions, conversation management, and state handling.
3. Chat Component: Complete chat interface with user/AI message rendering, product recommendations, and interactive filters.
4. InputBar Component: Text input interface with customizable send button and Enter key support.
5. ResetChat Component: Conversation reset functionality with customizable reset interface.
6. AI-Powered Conversations: Natural language processing with contextual responses and multi-turn conversation support.
7. Product Integration: Seamless product recommendations and filter application through conversational queries.
8. TypeScript Support: Full TypeScript definitions for enhanced developer experience.
9. Customizable UI: Fully customizable components with support for custom styling and theming.
10. Storage Options: Configurable conversation persistence with localStorage or sessionStorage support.