app-tutor-ai-consumer 1.31.1 → 1.32.1

package/.github/CODEOWNERS

@@ -1 +1 @@
-* @Hotmart-Org/learning-experience @gabrielsouza-hotmart @gustavolima-hotmart @luaschwertner-hotmart @tarsysfonseca-hotmart
+* @luaschwertner-hotmart @gabrielsouza-hotmart @gustavolima-hotmart @giuseppeagostini-hotmart @Hotmart-Org/learning-experience

package/CHANGELOG.md

@@ -1,3 +1,11 @@
+## [1.32.1](https://github.com/Hotmart-Org/app-tutor-ai-consumer/compare/v1.32.0...v1.32.1) (2025-10-06)
+
+# [1.32.0](https://github.com/Hotmart-Org/app-tutor-ai-consumer/compare/v1.31.1...v1.32.0) (2025-10-03)
+
+### Features
+
+- add messages datahub events ([5d271e5](https://github.com/Hotmart-Org/app-tutor-ai-consumer/commit/5d271e594162e665d0b10fba17b26b8b92f09325))
+
 ## [1.31.1](https://github.com/Hotmart-Org/app-tutor-ai-consumer/compare/v1.31.0...v1.31.1) (2025-10-01)
 
 ### Bug Fixes

package/package.json

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

package/src/config/datahub/actions.ts

@@ -13,6 +13,7 @@ export const ActionNames = {
   CLICK_HOTMART_TUTOR: `${DataHubActions.CLICK}_hotmart_tutor`,
   CLICK_TUTOR_MINIMIZE: `${DataHubActions.CLICK}_tutor_minimize`,
   TRY_PRODUCT_TUTOR: `${DataHubActions.TRY}_product_tutor`,
+  TRY_SEND_TUTOR_MESSAGE: `${DataHubActions.TRY}_send_tutor_message`,
   CLICK_TUTOR_BACK: `${DataHubActions.CLICK}_tutor_back`,
   CLICK_TUTOR_HISTORY: `${DataHubActions.CLICK}_tutor_history`,
   CLICK_TUTOR_INFO: `${DataHubActions.CLICK}_tutor_info`,
@@ -20,5 +21,6 @@ export const ActionNames = {
   CLICK_TUTOR_ONBOARDING_START: `${DataHubActions.CLICK}_tutor_onboarding_start`,
   CLICK_TUTOR_TEST_KNOWLEDGE: `${DataHubActions.CLICK}_tutor_test_knowledge`,
   CLOSE_TUTOR_ONBOARDING: `${DataHubActions.CLOSE}_tutor_onboarding`,
-  VIEW_PRODUCT_TUTOR: `${DataHubActions.VIEW}_product_tutor`
+  VIEW_PRODUCT_TUTOR: `${DataHubActions.VIEW}_product_tutor`,
+  VIEW_TUTOR_ANSWER_MESSAGE: `${DataHubActions.VIEW}_tutor_answer_message`
 }

package/src/config/datahub/constants.ts

@@ -27,6 +27,8 @@ export const ComponentNames = {
   BUTTON_COPY_ANSWER: 'BUTTON_COPY_ANSWER',
   BUTTON_CLOSE_TUTOR_CHAT: 'BUTTON_CLOSE_TUTOR_CHAT',
   BUTTON_VIEW_AGENT: 'BUTTON_VIEW_AGENT',
+  BUTTON_SEND_MESSAGE: 'BUTTON_SEND_MESSAGE',
+  VIEW_ANSWER: 'VIEW_ANSWER',
   PRODUCT_CONSUME_CLICK_TUTOR_BACK: 'product_consume_click_tutor_back',
   PRODUCT_CONSUME_CLICK_TUTOR_HISTORY: 'product_consume_click_tutor_history',
   PRODUCT_CONSUME_CLICK_TUTOR_INFO: 'product_consume_click_tutor_info',

package/src/config/datahub/schemas/tutor/__tests__/try-send-tutor-message.spec.ts

@@ -0,0 +1,38 @@
+import { chance } from '@/src/config/tests'
+import { HttpCodes } from '@/src/lib/utils'
+import { ComponentNames, ComponentSource } from '../../../constants'
+import { DataHubEntities } from '../../../entities'
+import TrySendTutorMessage from '../try-send-tutor-message'
+
+describe('TrySendTutorMessage', () => {
+  it('should send the event with the correct structure', () => {
+    const event = {
+      questionType: 'TEXT',
+      questionId: chance.guid()
+    }
+
+    expect(new TrySendTutorMessage(event).getDataHubEventData()).toMatchObject({
+      appVersion: '',
+      clubVersion: 'MEMBERSHIP',
+      componentName: ComponentNames.BUTTON_SEND_MESSAGE,
+      componentSource: ComponentSource.HOTMART_TUTOR,
+      entity: DataHubEntities.PRODUCT_CONSUME,
+      failureDescription: 'NOT_FAILURE_RESULT_EVENT',
+      isLogged: true,
+      membershipId: 'UNDEFINED',
+      membershipSlug: 'UNDEFINED',
+      osVersion: '537.36',
+      platform: 'WEB',
+      platformDetail: 'WebKit',
+      questionId: event.questionId,
+      questionType: event.questionType,
+      result: 'SUCCESSFUL',
+      sessionId: 'UNDEFINED',
+      statusCode: HttpCodes.OK,
+      ucode: 'UNDEFINED',
+      url: 'http://localhost:3000/',
+      userId: 0,
+      userRole: 'CONSUMER'
+    })
+  })
+})

package/src/config/datahub/schemas/tutor/__tests__/view-tutor-answer-message.spec.ts

@@ -0,0 +1,39 @@
+import { chance } from '@/src/config/tests'
+import { ComponentNames, ComponentSource } from '../../../constants'
+import { DataHubEntities } from '../../../entities'
+import { UserRole } from '../../constants'
+import ViewTutorAnswerMessage from '../view-tutor-answer-message'
+
+describe('ViewTutorAnswerMessage', () => {
+  it('should send the event with the correct structure', () => {
+    const event = {
+      messageType: 'TEXT',
+      messageId: chance.guid(),
+      correlationId: chance.guid()
+    }
+
+    expect(new ViewTutorAnswerMessage(event).getDataHubEventData()).toMatchObject({
+      appVersion: '',
+      arrivedFrom: 'HOME_CLASS_CONSUMER',
+      clubVersion: 'MEMBERSHIP',
+      componentName: ComponentNames.VIEW_ANSWER,
+      componentSource: ComponentSource.HOTMART_TUTOR,
+      correlationId: event.correlationId,
+      entity: DataHubEntities.PRODUCT_CONSUME,
+      isLogged: true,
+      membershipId: 'UNDEFINED',
+      membershipSlug: 'UNDEFINED',
+      messageId: event.messageId,
+      messageType: event.messageType,
+      osVersion: '537.36',
+      platform: 'WEB',
+      platformDetail: 'WebKit',
+      productType: 'category.online_services.name',
+      sessionId: 'UNDEFINED',
+      ucode: 'UNDEFINED',
+      url: 'http://localhost:3000/',
+      userId: 0,
+      userRole: UserRole.CONSUMER
+    })
+  })
+})

package/src/config/datahub/schemas/tutor/index.ts

@@ -8,4 +8,6 @@ export { default as ClickTutorOnboardingStartSchema } from './click-tutor-onboar
 export { default as ClickTutorTestKnowledgeSchema } from './click-tutor-test-knowledge'
 export { default as CloseTutorOnboardingSchema } from './close-tutor-onboarding'
 export * from './constants'
+export { default as TrySendTutorMessageSchema } from './try-send-tutor-message'
 export * from './types'
+export { default as ViewTutorAnswerMessageSchema } from './view-tutor-answer-message'

package/src/config/datahub/schemas/tutor/try-send-tutor-message.ts

@@ -0,0 +1,55 @@
+import { HttpCodes } from '@/src/lib/utils'
+import { ActionNames } from '../../actions'
+import { ComponentNames, ComponentSource } from '../../constants'
+import { DataHubEntities } from '../../entities'
+import type { DataHubEntityTypes } from '../../types'
+import type { ActionNamesType } from '../../types'
+import type { BaseTrySchemaConstructorArgs } from '../base-try-schema'
+import BaseTrySchema from '../base-try-schema'
+
+export type TrySendTutorMessageConstructorArgs = Partial<BaseTrySchemaConstructorArgs> & {
+  questionType?: string
+  questionId?: string
+}
+
+class TrySendTutorMessageSchema extends BaseTrySchema {
+  action: ActionNamesType
+  entity: DataHubEntityTypes
+  questionType: string
+  questionId: string
+
+  constructor(args?: TrySendTutorMessageConstructorArgs) {
+    const {
+      questionType = 'TEXT',
+      questionId = '',
+      componentSource = ComponentSource.HOTMART_TUTOR,
+      componentName = ComponentNames.BUTTON_SEND_MESSAGE,
+      failureDescription = 'NOT_FAILURE_RESULT_EVENT',
+      result = 'SUCCESSFUL',
+      statusCode = HttpCodes.OK
+    } = args ?? {}
+
+    super({
+      componentName,
+      componentSource,
+      failureDescription,
+      result,
+      statusCode
+    })
+
+    this.action = ActionNames.TRY_SEND_TUTOR_MESSAGE
+    this.entity = DataHubEntities.PRODUCT_CONSUME
+    this.questionType = questionType
+    this.questionId = questionId
+  }
+
+  getDataHubEventData(): Record<string, unknown> {
+    return {
+      ...this.prepare(),
+      questionType: this.questionType,
+      questionId: this.questionId
+    }
+  }
+}
+
+export default TrySendTutorMessageSchema

package/src/config/datahub/schemas/tutor/view-tutor-answer-message.ts

@@ -0,0 +1,58 @@
+import { ActionNames } from '../../actions'
+import { ComponentNames, ComponentSource } from '../../constants'
+import type { ActionNamesType } from '../../types'
+import type { BaseViewSchemaConstructorArgs } from '../base-view-schema'
+import BaseViewSchema from '../base-view-schema'
+
+export type ViewTutorAnswerMessageConstructorArgs = Partial<BaseViewSchemaConstructorArgs> & {
+  messageType?: string
+  messageId?: string
+  correlationId?: string
+}
+
+class ViewTutorAnswerMessageSchema extends BaseViewSchema {
+  private messageType?: string
+  private messageId?: string
+  private correlationId?: string
+
+  action: ActionNamesType
+
+  constructor(args?: ViewTutorAnswerMessageConstructorArgs) {
+    const {
+      messageType = 'TEXT',
+      messageId,
+      correlationId,
+      arrivedFrom,
+      entity,
+      isLogged,
+      productType,
+      componentName = ComponentNames.VIEW_ANSWER,
+      componentSource = ComponentSource.HOTMART_TUTOR
+    } = args ?? {}
+
+    super({
+      arrivedFrom,
+      entity,
+      isLogged,
+      productType,
+      componentName,
+      componentSource
+    })
+
+    this.action = ActionNames.VIEW_TUTOR_ANSWER_MESSAGE
+    this.messageType = messageType
+    this.messageId = messageId
+    this.correlationId = correlationId
+  }
+
+  getDataHubEventData(): Record<string, unknown> {
+    return {
+      ...super.prepare(),
+      messageType: this.messageType,
+      messageId: this.messageId,
+      correlationId: this.correlationId
+    }
+  }
+}
+
+export default ViewTutorAnswerMessageSchema

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

@@ -1,5 +1,6 @@
 import { UAParser } from 'ua-parser-js'
 
+import { DataHubService } from '@/src/config/datahub'
 import { act, chance, renderHook, waitFor } from '@/src/config/tests'
 import { APP_VERSION, PLATFORM } from '@/src/lib/utils'
 import { DirectMessagesService as MessagesService } from '@/src/modules/messages'
@@ -14,6 +15,12 @@ vi.mock('@/src/modules/profile', () => ({
   useGetProfile: vi.fn()
 }))
 
+vi.mock('@/src/modules/widget', () => ({
+  useWidgetSettingsAtomValue: vi.fn(),
+  useWidgetLoadingAtom: vi.fn(() => [false, vi.fn()]),
+  useIsAgentParentAtomValue: vi.fn(() => false)
+}))
+
 vi.mock('ua-parser-js', () => ({ UAParser: vi.fn() }))
 
 describe('useSendTextMessage', () => {
@@ -24,7 +31,10 @@ describe('useSendTextMessage', () => {
     .withOwner_id(chance.guid())
     .withCurrent_media_codes(chance.profession())
     .withUser({ id: chance.guid(), ucode: chance.guid() })
-  const UAParserMock = { browser: { version: chance.android_id(), name: chance.name_prefix() } }
+  const UAParserMock = {
+    browser: { version: chance.android_id(), name: chance.name_prefix() },
+    device: { type: 'desktop', vendor: 'test', model: 'test' }
+  }
 
   const render = () => renderHook(useSendTextMessage)
 
@@ -32,6 +42,7 @@ describe('useSendTextMessage', () => {
     vi.mocked(useGetProfile).mockReturnValue(getProfileMock as never)
     vi.spyOn(Store, 'useWidgetSettingsAtomValue').mockReturnValue(defaultSettings)
     vi.mocked(UAParser).mockReturnValue(UAParserMock as never)
+    vi.mocked(Store.useIsAgentParentAtomValue).mockReturnValue(false)
   })
 
   it('should throw when conversationId is not defined', async () => {
@@ -54,6 +65,23 @@ describe('useSendTextMessage', () => {
     expect(result.current.isSuccess).toBeTruthy()
   })
 
+  it('should send DataHub event on successful message send', async () => {
+    const mockResponse = { id: chance.guid() }
+    vi.spyOn(MessagesService, 'create').mockResolvedValue(mockResponse as never)
+    vi.spyOn(DataHubService, 'sendEvent')
+
+    const { result } = render()
+
+    await waitFor(() => result.current.mutateAsync(message))
+
+    expect(DataHubService.sendEvent).toHaveBeenCalledWith({
+      schema: expect.objectContaining({
+        questionId: mockResponse.id,
+        questionType: 'TEXT'
+      })
+    })
+  })
+
   it('should be properly able to handle question::<text> messages', async () => {
     const txt = 'question::summary'
     const text = txt.replace('question::', '')

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

@@ -3,10 +3,16 @@ import { useMutation, useQueryClient } from '@tanstack/react-query'
 import { UAParser } from 'ua-parser-js'
 import { v4 } from 'uuid'
 
-import { APP_VERSION, PLATFORM } from '@/src/lib/utils'
+import { ComponentSource, DataHubService } from '@/src/config/datahub'
+import { TrySendTutorMessageSchema } from '@/src/config/datahub/schemas/tutor'
+import { APP_VERSION, HttpCodes, PLATFORM } from '@/src/lib/utils'
 import { DirectMessagesService as MessagesService } from '@/src/modules/messages'
 import { useGetProfile } from '@/src/modules/profile'
-import { useWidgetLoadingAtom, useWidgetSettingsAtomValue } from '@/src/modules/widget'
+import {
+  useIsAgentParentAtomValue,
+  useWidgetLoadingAtom,
+  useWidgetSettingsAtomValue
+} from '@/src/modules/widget'
 import { MessagesEvents } from '../../events'
 import { useMessagesMaxCount } from '../../store'
 import { setMessagesCache } from '../../utils'
@@ -18,6 +24,7 @@ function useSendTextMessage() {
   const [, setWidgetLoading] = useWidgetLoadingAtom()
   const queryClient = useQueryClient()
   const limit = useMessagesMaxCount()
+  const isAgentMode = useIsAgentParentAtomValue()
 
   const userId = useMemo(() => profileQuery.data?.userId?.toString(), [profileQuery.data?.userId])
   const profileId = useMemo(() => profileQuery.data?.id?.toString(), [profileQuery.data?.id])
@@ -108,6 +115,27 @@ function useSendTextMessage() {
     },
     onSuccess(data) {
       setMessagesCache({ queryKey: messagesQueryConfig.queryKey, queryClient, data })()
+
+      DataHubService.sendEvent({
+        schema: new TrySendTutorMessageSchema({
+          questionId: data.id,
+          componentSource: isAgentMode
+            ? ComponentSource.PRODUCT_AGENT
+            : ComponentSource.HOTMART_TUTOR
+        })
+      })
+    },
+    onError(error) {
+      DataHubService.sendEvent({
+        schema: new TrySendTutorMessageSchema({
+          statusCode: HttpCodes.BAD_REQUEST,
+          result: 'FAILURE',
+          failureDescription: error.message,
+          componentSource: isAgentMode
+            ? ComponentSource.PRODUCT_AGENT
+            : ComponentSource.HOTMART_TUTOR
+        })
+      })
     }
   })
 }

package/src/modules/messages/hooks/use-subscribe-message-received-event/use-subscribe-message-received-event.tsx

@@ -3,10 +3,16 @@ import type { InfiniteData } from '@tanstack/react-query'
 import { useQueryClient } from '@tanstack/react-query'
 import { produce } from 'immer'
 
+import { ComponentSource, DataHubService } from '@/src/config/datahub'
+import { ViewTutorAnswerMessageSchema } from '@/src/config/datahub/schemas/tutor'
 import { useUpdateCursor } from '@/src/modules/cursor/hooks'
 import { useGetProfile } from '@/src/modules/profile'
 import { SparkieService } from '@/src/modules/sparkie'
-import { useWidgetLoadingAtom, useWidgetSettingsAtom } from '@/src/modules/widget'
+import {
+  useIsAgentParentAtomValue,
+  useWidgetLoadingAtom,
+  useWidgetSettingsAtom
+} from '@/src/modules/widget'
 import { useMessagesMaxCount, useUnreadMessagesSetAtom } from '../../store'
 import type { FetchMessagesResponse, IMessageWithSenderData } from '../../types'
 import { getAllMessagesQuery } from '../use-infinite-get-messages'
@@ -19,6 +25,7 @@ const useSubscribeMessageReceivedEvent = () => {
   const queryClient = useQueryClient()
   const useUpdateCursorMutation = useUpdateCursor()
   const limit = useMessagesMaxCount()
+  const isAgentMode = useIsAgentParentAtomValue()
 
   const conversationId = useMemo(() => String(settings?.conversationId), [settings?.conversationId])
   const profileId = useMemo(() => String(profileQuery?.data?.id), [profileQuery?.data?.id])
@@ -59,6 +66,16 @@ const useSubscribeMessageReceivedEvent = () => {
       const isMine = data.contactId === profileId
 
       if (!isMine) {
+        DataHubService.sendEvent({
+          schema: new ViewTutorAnswerMessageSchema({
+            correlationId: data.metadata.correlationId,
+            messageId: data.id,
+            componentSource: isAgentMode
+              ? ComponentSource.PRODUCT_AGENT
+              : ComponentSource.HOTMART_TUTOR
+          })
+        })
+
         addUnreadMessagesToSet({ itemId: data.id })
         setTimeout(() => setWidgetLoading(false), 100)
       } else {
@@ -69,6 +86,7 @@ const useSubscribeMessageReceivedEvent = () => {
     [
       addUnreadMessagesToSet,
       conversationId,
+      isAgentMode,
       messagesQueryConfig.queryKey,
       profileId,
       queryClient,