app-tutor-ai-consumer 1.53.0 → 1.55.0

package/CHANGELOG.md

@@ -1,3 +1,19 @@
+# [1.55.0](https://github.com/Hotmart-Org/app-tutor-ai-consumer/compare/v1.54.0...v1.55.0) (2026-01-30)
+
+### Features
+
+- add concierge labels ([f845eb5](https://github.com/Hotmart-Org/app-tutor-ai-consumer/commit/f845eb5a3016d582ae9687f569764b14bca00d15))
+
+# [1.54.0](https://github.com/Hotmart-Org/app-tutor-ai-consumer/compare/v1.53.0...v1.54.0) (2026-01-28)
+
+### Bug Fixes
+
+- code review issues ([6d0a17a](https://github.com/Hotmart-Org/app-tutor-ai-consumer/commit/6d0a17a8874001b7d30d889152a432fbf5046467))
+
+### Features
+
+- add create thread datahub event ([3f8fa1e](https://github.com/Hotmart-Org/app-tutor-ai-consumer/commit/3f8fa1e5e98f9bef7201a7835a56252943a35122))
+
 # [1.53.0](https://github.com/Hotmart-Org/app-tutor-ai-consumer/compare/v1.52.1...v1.53.0) (2026-01-27)
 
 ### Features

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "app-tutor-ai-consumer",
-  "version": "1.53.0",
+  "version": "1.55.0",
   "main": "index.js",
   "scripts": {
     "dev": "rspack serve --env=development --config config/rspack/rspack.config.js",

package/src/config/datahub/actions.ts

@@ -23,5 +23,6 @@ export const ActionNames = {
   CLOSE_TUTOR_ONBOARDING: `${DataHubActions.CLOSE}_tutor_onboarding`,
   VIEW_PRODUCT_TUTOR: `${DataHubActions.VIEW}_product_tutor`,
   VIEW_ANSWER_MESSAGE: `${DataHubActions.VIEW}_answer_message`,
-  VIEW_CHAT: `${DataHubActions.VIEW}_chat`
+  VIEW_CHAT: `${DataHubActions.VIEW}_chat`,
+  TRY_CREATE_THREAD: `${DataHubActions.TRY}_create_thread`
 }

package/src/config/datahub/schemas/agent/tryCreateThreadSchema.ts

@@ -0,0 +1,60 @@
+import HttpCodes from '@/src/lib/utils/http-codes'
+import { ActionNames } from '../../actions'
+import { DataHubEntities } from '../../entities'
+import type { ActionNamesType, DataHubEntityTypes } from '../../types'
+import BaseTrySchema from '../base-try-schema'
+import { ProductCategories } from '../constants'
+
+type Result = 'SUCCESSFUL' | 'FAILURE'
+
+type ConstructorParams = {
+  title: string
+  componentName: string
+  conversationId: string
+  entity?: DataHubEntityTypes
+  result?: Result
+  statusCode?: number
+  failureDescription?: string
+}
+
+export class TryCreateThreadSchema extends BaseTrySchema {
+  action: ActionNamesType
+
+  private agent: 'HOTMART_TUTOR' | 'PRODUCT_AGENT'
+  private conversationId: string
+  private title: string
+
+  constructor({
+    title,
+    componentName,
+    conversationId,
+    entity = DataHubEntities.CONVERSATIONAL_AGENT,
+    result = 'SUCCESSFUL',
+    statusCode = HttpCodes.OK,
+    failureDescription = 'NOT_FAILURE_RESULT_EVENT'
+  }: ConstructorParams) {
+    super({
+      result,
+      componentName,
+      statusCode,
+      failureDescription,
+      componentSource: 'CONTENT_LESSON',
+      productType: ProductCategories.ConversationalAgent
+    })
+
+    this.entity = entity
+    this.action = ActionNames.TRY_CREATE_THREAD
+    this.agent = 'PRODUCT_AGENT'
+    this.conversationId = conversationId
+    this.title = title
+  }
+
+  getDataHubEventData(): Record<string, unknown> {
+    return {
+      ...super.prepare(),
+      agent: this.agent,
+      conversationId: this.conversationId,
+      title: this.title
+    }
+  }
+}

package/src/config/datahub/schemas/base-try-schema.ts

@@ -4,6 +4,7 @@ import { DataHubEntities } from '../entities'
 import type { DataHubEntityTypes, ResultType, ScreenNamesType } from '../types'
 
 import BaseProductSchema from './base-product-schema'
+import type { ProductCategoriesType } from './types'
 
 export type BaseTrySchemaConstructorArgs = {
   componentName: string
@@ -14,6 +15,7 @@ export type BaseTrySchemaConstructorArgs = {
   statusCode?: number
   failureDescription?: string
   screenName?: ScreenNamesType
+  productType?: ProductCategoriesType
 }
 
 abstract class BaseTrySchema extends BaseProductSchema {
@@ -31,6 +33,7 @@ abstract class BaseTrySchema extends BaseProductSchema {
     const {
       componentName,
       componentSource,
+      productType,
       entity = DataHubEntities.HOME,
       failureDescription = Result.FAILURE_DESCRIPTION,
       isLogged = true,
@@ -39,7 +42,7 @@ abstract class BaseTrySchema extends BaseProductSchema {
       screenName = ScreenNames.HOME_CONSUMER
     } = args
 
-    super()
+    super({ productType })
 
     this.componentName = componentName
     this.componentSource = componentSource

package/src/main/hooks/use-initial-store/use-initial-store.tsx

@@ -11,6 +11,7 @@ import type { WidgetTabsProps } from '@/src/modules/widget'
 import {
   widgetSettingsAtom,
   widgetSettingsConfigAgentParentAtom,
+  widgetSettingsConfigConciergeParentAtom,
   widgetTabsAtom
 } from '@/src/modules/widget'
 import type { WidgetSettingProps } from '@/src/types'
@@ -50,12 +51,18 @@ const useInitialStore = ({ settings }: UseInitialStoreProps) => {
     [settings?.config?.metadata?.parent]
   )
 
+  const isConciergeMode = useMemo(
+    () => settings?.config?.metadata?.parent === 'CONCIERGE',
+    [settings?.config?.metadata?.parent]
+  )
+
   useHydrateAtoms(
     [
       [widgetSettingsAtom, getDefaultSettings(settings)],
       [messagesMaxCountAtom, MSG_MAX_COUNT],
       [widgetTabsAtom, initialTab],
-      [widgetSettingsConfigAgentParentAtom, isAgentMode]
+      [widgetSettingsConfigAgentParentAtom, isAgentMode],
+      [widgetSettingsConfigConciergeParentAtom, isConciergeMode]
     ],
     { store }
   )

package/src/modules/messages/hooks/use-send-first-message/use-send-first-message.spec.tsx

@@ -1,6 +1,9 @@
+import { DataHubService } from '@/src/config/datahub'
+import { TryCreateThreadSchema } from '@/src/config/datahub/schemas/agent/tryCreateThreadSchema'
 import { renderHook } from '@/src/config/tests'
+import HttpCodes from '@/src/lib/utils/http-codes'
 import { useUpdateConversationTitle } from '@/src/modules/conversation/hooks/update-conversation-title'
-import { useWidgetSettingsAtomValue } from '@/src/modules/widget/store'
+import { useIsAgentParentAtomValue, useWidgetSettingsAtomValue } from '@/src/modules/widget/store'
 import { useMessagesCountAtomValue } from '../../store/messages-count.atom'
 import { useSendTextMessage } from '../use-send-text-message'
 
@@ -11,7 +14,8 @@ vi.mock('@/src/modules/conversation/hooks/update-conversation-title', () => ({
 }))
 
 vi.mock('@/src/modules/widget/store', () => ({
-  useWidgetSettingsAtomValue: vi.fn()
+  useWidgetSettingsAtomValue: vi.fn(),
+  useIsAgentParentAtomValue: vi.fn()
 }))
 
 vi.mock('../../store/messages-count.atom', () => ({
@@ -25,6 +29,19 @@ vi.mock('../use-send-text-message', () => ({
 describe('useSendFirstMessage', () => {
   const mockSendMessage = vi.fn()
   const mockUpdateTitle = vi.fn()
+  const mockMessage = { id: 'msg-1', content: 'Hello' }
+  const mockSettings = {
+    conversationId: 'conv-123',
+    productId: 'prod-456',
+    config: {
+      metadata: {
+        agentProductId: 'agent-prod-42',
+        agentName: 'Agent Name',
+        courseName: 'Course Name',
+        source: 'Source'
+      }
+    }
+  }
 
   beforeEach(() => {
     vi.clearAllMocks()
@@ -47,35 +64,55 @@ describe('useSendFirstMessage', () => {
     } as never)
 
     vi.mocked(useMessagesCountAtomValue).mockReturnValue(0)
+
+    vi.mocked(useIsAgentParentAtomValue).mockReturnValue(true)
   })
 
   describe('when sending first message', () => {
-    it('should send message and update conversation title', async () => {
-      vi.mocked(useWidgetSettingsAtomValue).mockReturnValue({
-        conversationId: 'conv-123',
-        productId: 'prod-456',
-        config: {
-          metadata: {
-            agentProductId: 'agent-prod-42',
-            agentName: 'Agent Name',
-            courseName: 'Course Name',
-            source: 'Source'
-          }
-        }
-      } as never)
-      const mockMessage = { id: 'msg-1', content: 'Hello' }
+    it('should not dispatch create thread event when in Tutor Mode', async () => {
+      vi.spyOn(DataHubService, 'sendEvent').mockImplementationOnce(() => null)
+      vi.mocked(useIsAgentParentAtomValue).mockReturnValue(false)
+      vi.mocked(useWidgetSettingsAtomValue).mockReturnValue(mockSettings as never)
       mockSendMessage.mockResolvedValue(mockMessage)
       mockUpdateTitle.mockResolvedValue({})
 
+      const expectedResult = {
+        conversationId: 'conv-123',
+        productId: 'agent-prod-42',
+        subject: 'Hello world'
+      }
+
       const { result } = renderHook(() => useSendFirstMessage())
 
-      await result.current.sendFirstMessage('Hello world')
+      await result.current.sendFirstMessage(expectedResult.subject)
 
-      expect(mockSendMessage).toHaveBeenCalledWith('Hello world', undefined)
-      expect(mockUpdateTitle).toHaveBeenCalledWith({
+      expect(DataHubService.sendEvent).not.toHaveBeenCalled()
+    })
+
+    it('should send message and update conversation title', async () => {
+      vi.spyOn(DataHubService, 'sendEvent').mockImplementation(() => null)
+      vi.mocked(useWidgetSettingsAtomValue).mockReturnValue(mockSettings as never)
+      mockSendMessage.mockResolvedValue(mockMessage)
+      mockUpdateTitle.mockResolvedValue({})
+
+      const expectedResult = {
         conversationId: 'conv-123',
         productId: 'agent-prod-42',
         subject: 'Hello world'
+      }
+
+      const { result } = renderHook(() => useSendFirstMessage())
+
+      await result.current.sendFirstMessage(expectedResult.subject)
+
+      expect(mockSendMessage).toHaveBeenCalledWith(expectedResult.subject, undefined)
+      expect(mockUpdateTitle).toHaveBeenCalledWith(expectedResult)
+      expect(DataHubService.sendEvent).toHaveBeenCalledExactlyOnceWith({
+        schema: new TryCreateThreadSchema({
+          title: expectedResult.subject,
+          componentName: 'AGENT_CREATE_THREAD',
+          conversationId: expectedResult.conversationId
+        })
       })
     })
   })
@@ -112,6 +149,7 @@ describe('useSendFirstMessage', () => {
 
   describe('error handling', () => {
     it('should throw error when send message fails', async () => {
+      vi.mocked(useWidgetSettingsAtomValue).mockReturnValue(mockSettings as never)
       vi.spyOn(console, 'error').mockImplementationOnce(() => {})
       const error = new Error('Send failed')
       mockSendMessage.mockRejectedValue(error)
@@ -119,6 +157,17 @@ describe('useSendFirstMessage', () => {
       const { result } = renderHook(() => useSendFirstMessage())
 
       await expect(result.current.sendFirstMessage('Hello')).rejects.toThrow('Send failed')
+
+      expect(DataHubService.sendEvent).toHaveBeenCalledExactlyOnceWith({
+        schema: new TryCreateThreadSchema({
+          title: mockMessage.content,
+          componentName: 'AGENT_CREATE_THREAD',
+          conversationId: mockSettings.conversationId,
+          result: 'FAILURE',
+          statusCode: HttpCodes.BAD_REQUEST,
+          failureDescription: 'Send failed'
+        })
+      })
     })
   })
 

package/src/modules/messages/hooks/use-send-first-message/use-send-first-message.tsx

@@ -2,8 +2,11 @@ import { useCallback } from 'react'
 import type { Message } from '@hotmart-org-ca/sparkie/dist/MessageService'
 import type { MutateOptions } from '@tanstack/react-query'
 
+import { DataHubService } from '@/src/config/datahub'
+import { TryCreateThreadSchema } from '@/src/config/datahub/schemas/agent/tryCreateThreadSchema'
+import HttpCodes from '@/src/lib/utils/http-codes'
 import { useUpdateConversationTitle } from '@/src/modules/conversation/hooks/update-conversation-title'
-import { useWidgetSettingsAtomValue } from '@/src/modules/widget/store'
+import { useIsAgentParentAtomValue, useWidgetSettingsAtomValue } from '@/src/modules/widget/store'
 import { useMessagesCountAtomValue } from '../../store/messages-count.atom'
 import { excerptMessage } from '../../utils'
 import { useSendTextMessage } from '../use-send-text-message'
@@ -13,10 +16,12 @@ function useSendFirstMessage() {
   const sendMessageMutation = useSendTextMessage()
   const updateTitleMutation = useUpdateConversationTitle()
   const settings = useWidgetSettingsAtomValue()
+  const isAgent = useIsAgentParentAtomValue()
 
   const sendFirstMessage = useCallback(
     async (message: string, options?: MutateOptions<Message, Error, string, void>) => {
       const isFirstMessage = messagesCount === 0
+      const subject = excerptMessage({ message })
 
       try {
         const messageResult = await sendMessageMutation.mutateAsync(message, options)
@@ -29,17 +34,46 @@ function useSendFirstMessage() {
           await updateTitleMutation.mutateAsync({
             conversationId: settings.conversationId,
             productId: settings?.config?.metadata?.agentProductId,
-            subject: excerptMessage({ message })
+            subject
+          })
+        }
+
+        if (isAgent) {
+          DataHubService.sendEvent({
+            schema: new TryCreateThreadSchema({
+              title: subject,
+              componentName: 'AGENT_CREATE_THREAD',
+              conversationId: settings?.conversationId || ''
+            })
           })
         }
 
         return messageResult
       } catch (error) {
-        console.error('Failed to send first message:', error)
+        if (isAgent) {
+          DataHubService.sendEvent({
+            schema: new TryCreateThreadSchema({
+              title: subject,
+              componentName: 'AGENT_CREATE_THREAD',
+              conversationId: settings?.conversationId || '',
+              result: 'FAILURE',
+              statusCode: HttpCodes.BAD_REQUEST,
+              failureDescription: error instanceof Error ? error?.message : String(error)
+            })
+          })
+        }
+
         throw error
       }
     },
-    [messagesCount, sendMessageMutation, updateTitleMutation, settings]
+    [
+      messagesCount,
+      sendMessageMutation,
+      settings?.conversationId,
+      settings?.config?.metadata?.agentProductId,
+      isAgent,
+      updateTitleMutation
+    ]
   )
 
   return {

package/src/modules/widget/components/greetings-card/greetings-card.tsx

@@ -3,7 +3,9 @@ import { useTranslation } from 'react-i18next'
 
 import { AiIconCircle } from '@/src/lib/components'
 import { useMembershipColor } from '../../hooks'
-import { useIsAgentParentAtomValue } from '../../store'
+import { useIsAgentParentAtomValue, useIsConciergeParentAtomValue } from '../../store'
+
+import { getGreetingsLabels } from './utils'
 
 export type GreetingsCardProps = {
   tutorName: string
@@ -13,8 +15,12 @@ export type GreetingsCardProps = {
 
 function GreetingsCard({ author, tutorName, isDarkTheme = false }: GreetingsCardProps) {
   const { t } = useTranslation()
-  const isAgentMode = useIsAgentParentAtomValue()
   const membershipColor = useMembershipColor()
+  const isAgentMode = useIsAgentParentAtomValue()
+  const isConciergeMode = useIsConciergeParentAtomValue()
+
+  const chatMode = isConciergeMode ? 'CONCIERGE' : isAgentMode ? 'AGENT' : 'TUTOR'
+  const labels = getGreetingsLabels(chatMode)
 
   return (
     <div className='flex flex-col items-center justify-center'>
@@ -28,19 +34,14 @@ function GreetingsCard({ author, tutorName, isDarkTheme = false }: GreetingsCard
               'text-white': isDarkTheme,
               'text-gray-900': !isDarkTheme
             })}>
-            {t('general.greetings.hello', { name: author })}
+            {t(labels.hello, { name: author })}
           </span>
           <h3
             className={clsx('text-xl font-bold', {
               'text-white': isDarkTheme,
               'text-gray-900': !isDarkTheme
             })}>
-            {t(
-              isAgentMode
-                ? 'general.greetings.agentFirstMessage'
-                : 'general.greetings.firstMessage',
-              { tutorName }
-            )}
+            {t(labels.firstMessage, { tutorName })}
           </h3>
         </div>
         <p
@@ -48,7 +49,7 @@ function GreetingsCard({ author, tutorName, isDarkTheme = false }: GreetingsCard
             'text-gray-400': isDarkTheme,
             'text-neutral-600': !isDarkTheme
           })}>
-          {t(isAgentMode ? 'general.greetings.agentDescription' : 'general.greetings.description')}
+          {t(labels.description)}
         </p>
       </div>
     </div>

package/src/modules/widget/components/greetings-card/types.ts

@@ -0,0 +1,7 @@
+export type WidgetMode = 'TUTOR' | 'AGENT' | 'CONCIERGE'
+
+export type GreetingsLabels = {
+  hello: string
+  firstMessage: string
+  description: string
+}

package/src/modules/widget/components/greetings-card/utils.ts

@@ -0,0 +1,25 @@
+import type { GreetingsLabels, WidgetMode } from './types'
+
+export const getGreetingsLabels = (mode: WidgetMode, isFirstTime = false): GreetingsLabels => {
+  const interaction = isFirstTime ? 'first_interaction' : 'other_interactions'
+
+  const greetingsMap = {
+    AGENT: {
+      hello: 'general.greetings.hello',
+      firstMessage: 'general.greetings.agentFirstMessage',
+      description: 'general.greetings.agentDescription'
+    },
+    CONCIERGE: {
+      hello: `concierge.welcome.${interaction}.hello`,
+      firstMessage: `concierge.welcome.${interaction}.title`,
+      description: 'concierge.welcome.description'
+    },
+    TUTOR: {
+      hello: 'general.greetings.hello',
+      firstMessage: 'general.greetings.firstMessage',
+      description: 'general.greetings.description'
+    }
+  }
+
+  return greetingsMap[mode]
+}

package/src/modules/widget/store/widget-settings-config.atom.ts

@@ -3,3 +3,8 @@ import { atom, useAtomValue } from 'jotai'
 export const widgetSettingsConfigAgentParentAtom = atom(false)
 
 export const useIsAgentParentAtomValue = () => useAtomValue(widgetSettingsConfigAgentParentAtom)
+
+export const widgetSettingsConfigConciergeParentAtom = atom(false)
+
+export const useIsConciergeParentAtomValue = () =>
+  useAtomValue(widgetSettingsConfigConciergeParentAtom)

package/src/types.ts

@@ -65,7 +65,7 @@ export type WidgetSettingProps = {
   config?: {
     theme?: Theme
     metadata?: {
-      parent?: 'AGENT' | 'TUTOR'
+      parent?: 'AGENT' | 'TUTOR' | 'CONCIERGE'
       agentProductId?: number
       agentName?: string
       courseName?: string