app-tutor-ai-consumer 1.29.2 → 1.31.0

package/CHANGELOG.md

@@ -1,3 +1,19 @@
+# [1.31.0](https://github.com/Hotmart-Org/app-tutor-ai-consumer/compare/v1.30.0...v1.31.0) (2025-09-22)
+
+### Features
+
+- add quick actions feature flag ([fa1826a](https://github.com/Hotmart-Org/app-tutor-ai-consumer/commit/fa1826afd4c2802322ff0277311126cbdb8caa78))
+
+# [1.30.0](https://github.com/Hotmart-Org/app-tutor-ai-consumer/compare/v1.29.2...v1.30.0) (2025-09-18)
+
+### Bug Fixes
+
+- pr issues ([09ad360](https://github.com/Hotmart-Org/app-tutor-ai-consumer/commit/09ad360449e1f3b06e329f4594b00d9c245faaaa))
+
+### Features
+
+- change datahub events to support product agent ([e6a91fb](https://github.com/Hotmart-Org/app-tutor-ai-consumer/commit/e6a91fbb7995e16d50909ab71018073f41901694))
+
 ## [1.29.2](https://github.com/Hotmart-Org/app-tutor-ai-consumer/compare/v1.29.1...v1.29.2) (2025-09-16)
 
 ### Bug Fixes

package/package.json

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

package/src/config/datahub/actions.ts

@@ -19,5 +19,6 @@ export const ActionNames = {
   CLICK_TUTOR_KNOW_MORE: `${DataHubActions.CLICK}_tutor_know_more`,
   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`
-} as const
+  CLOSE_TUTOR_ONBOARDING: `${DataHubActions.CLOSE}_tutor_onboarding`,
+  VIEW_PRODUCT_TUTOR: `${DataHubActions.VIEW}_product_tutor`
+}

package/src/config/datahub/constants.ts

@@ -24,7 +24,9 @@ export const Result = {
 export const ComponentNames = {
   BUTTON_LIKE_ANSWER: 'BUTTON_LIKE_ANSWER',
   BUTTON_DISLIKE_ANSWER: 'BUTTON_DISLIKE_ANSWER',
+  BUTTON_COPY_ANSWER: 'BUTTON_COPY_ANSWER',
   BUTTON_CLOSE_TUTOR_CHAT: 'BUTTON_CLOSE_TUTOR_CHAT',
+  BUTTON_VIEW_AGENT: 'BUTTON_VIEW_AGENT',
   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',
@@ -35,7 +37,9 @@ export const ComponentNames = {
 } as const
 
 export const ComponentSource = {
-  ACTION_BAR_STATUS: 'ACTION_BAR_STATUS'
+  ACTION_BAR_STATUS: 'ACTION_BAR_STATUS',
+  HOTMART_TUTOR: 'HOTMART_TUTOR',
+  PRODUCT_AGENT: 'PRODUCT_AGENT'
 } as const
 
 export const ArrivedFrom = {

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

@@ -0,0 +1,59 @@
+import { DataHubEntities } from '../entities'
+import type { ComponentNamesType, ComponentSourceType, DataHubEntityTypes } from '../types'
+
+import BaseSchema from './base-schema'
+import { ProductCategories } from './constants'
+import type { ProductCategoriesType } from './types'
+
+export type BaseViewSchemaConstructorArgs = {
+  componentName: ComponentNamesType
+  componentSource: ComponentSourceType
+  arrivedFrom?: string
+  entity?: DataHubEntityTypes
+  isLogged?: boolean
+  productType?: ProductCategoriesType
+}
+
+abstract class BaseViewSchema extends BaseSchema {
+  private arrivedFrom: string
+  private componentName: string
+  private componentSource: string
+  private productType: ProductCategoriesType
+
+  entity: DataHubEntityTypes
+  isLogged: boolean
+
+  constructor(args: BaseViewSchemaConstructorArgs) {
+    const {
+      componentName,
+      componentSource,
+      arrivedFrom = 'HOME_CLASS_CONSUMER',
+      entity = DataHubEntities.PRODUCT_CONSUME,
+      isLogged = true,
+      productType = ProductCategories.OnlineServices
+    } = args
+
+    super()
+
+    this.arrivedFrom = arrivedFrom
+    this.componentName = componentName
+    this.componentSource = componentSource
+    this.entity = entity
+    this.isLogged = isLogged
+    this.productType = productType
+  }
+
+  prepare(): Record<string, unknown> {
+    return {
+      ...super.prepare(),
+      arrivedFrom: this.arrivedFrom,
+      componentName: this.componentName,
+      componentSource: this.componentSource,
+      entity: this.entity,
+      isLogged: this.isLogged,
+      productType: this.productType
+    }
+  }
+}
+
+export default BaseViewSchema

package/src/config/datahub/schemas/tutor/click-hotmart-tutor.ts

@@ -1,9 +1,10 @@
 import { ActionNames } from '../../actions'
-import { ComponentNames, ScreenNames } from '../../constants'
+import { ComponentNames, ComponentSource, ScreenNames } from '../../constants'
 import { DataHubEntities } from '../../entities'
 import type {
   ActionNamesType,
   ComponentNamesType,
+  ComponentSourceType,
   DataHubEntityTypes,
   ScreenNamesType
 } from '../../types'
@@ -14,6 +15,7 @@ import type { ButtonReactionsType } from './types'
 
 class ClickHotmartTutor extends BaseSchema {
   private componentName: ComponentNamesType
+  private componentSource: ComponentSourceType
   private screenName: ScreenNamesType
   private messageId: string
   private hasAccess: boolean
@@ -26,22 +28,27 @@ class ClickHotmartTutor extends BaseSchema {
     reactionType,
     messageId,
     hasAccess = true,
-    isLogged = true
+    isLogged = true,
+    componentSource = ComponentSource.HOTMART_TUTOR
   }: {
     reactionType: ButtonReactionsType
     messageId: string
     hasAccess?: boolean
     isLogged?: boolean
+    componentSource?: ComponentSourceType
   }) {
     super()
 
     this.action = ActionNames.CLICK_HOTMART_TUTOR
     this.entity = DataHubEntities.HOME
 
-    this.componentName =
-      reactionType === ButtonReactions.LIKE
-        ? ComponentNames.BUTTON_LIKE_ANSWER
-        : ComponentNames.BUTTON_DISLIKE_ANSWER
+    this.componentName = {
+      [ButtonReactions.LIKE]: ComponentNames.BUTTON_LIKE_ANSWER,
+      [ButtonReactions.DISLIKE]: ComponentNames.BUTTON_DISLIKE_ANSWER,
+      [ButtonReactions.COPY]: ComponentNames.BUTTON_COPY_ANSWER
+    }[reactionType]
+
+    this.componentSource = componentSource
     this.screenName = ScreenNames.HOME_CONSUMER
     this.messageId = messageId
     this.hasAccess = hasAccess
@@ -52,6 +59,7 @@ class ClickHotmartTutor extends BaseSchema {
     return {
       ...super.prepare(),
       componentName: this.componentName,
+      componentSource: this.componentSource,
       screenName: this.screenName,
       messageId: this.messageId,
       hasAccess: this.hasAccess

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

@@ -1,4 +1,5 @@
 export const ButtonReactions = {
   LIKE: 'LIKE',
-  DISLIKE: 'DISLIKE'
+  DISLIKE: 'DISLIKE',
+  COPY: 'COPY'
 } as const

package/src/config/datahub/schemas/tutor/view-product-tutor.ts

@@ -0,0 +1,42 @@
+import { ActionNames } from '../../actions'
+import { ComponentNames, ComponentSource } from '../../constants'
+import type { ActionNamesType, ComponentNamesType, ComponentSourceType } from '../../types'
+import BaseViewSchema from '../base-view-schema'
+import type { ProductCategoriesType } from '../types'
+
+export type ViewProductTutorSchemaConstructorArgs = {
+  arrivedFrom?: string
+  componentName?: ComponentNamesType
+  componentSource?: ComponentSourceType
+  productType?: ProductCategoriesType
+}
+
+class ViewProductTutorSchema extends BaseViewSchema {
+  action: ActionNamesType
+
+  constructor(args?: ViewProductTutorSchemaConstructorArgs) {
+    const {
+      arrivedFrom,
+      productType,
+      componentName = ComponentNames.BUTTON_VIEW_AGENT,
+      componentSource = ComponentSource.HOTMART_TUTOR
+    } = args ?? {}
+
+    super({
+      arrivedFrom,
+      productType,
+      componentName,
+      componentSource
+    })
+
+    this.action = ActionNames.VIEW_PRODUCT_TUTOR
+  }
+
+  getDataHubEventData() {
+    return {
+      ...super.prepare()
+    }
+  }
+}
+
+export default ViewProductTutorSchema

package/src/config/datahub/types.ts

@@ -1,5 +1,12 @@
 import type { ActionNames } from './actions'
-import type { ComponentNames, Platform, Result, ScreenNames, System } from './constants'
+import type {
+  ComponentNames,
+  ComponentSource,
+  Platform,
+  Result,
+  ScreenNames,
+  System
+} from './constants'
 import type { DataHubEntities } from './entities'
 
 export type ActionNamesType = (typeof ActionNames)[keyof typeof ActionNames]
@@ -7,6 +14,7 @@ export type DataHubEntityTypes = (typeof DataHubEntities)[keyof typeof DataHubEn
 export type PlatformType = (typeof Platform)[keyof typeof Platform]
 export type SystemType = (typeof System)[keyof typeof System]
 export type ComponentNamesType = (typeof ComponentNames)[keyof typeof ComponentNames]
+export type ComponentSourceType = (typeof ComponentSource)[keyof typeof ComponentSource]
 export type ScreenNamesType = (typeof ScreenNames)[keyof typeof ScreenNames]
 export type ResultType = (typeof Result)[keyof typeof Result]
 

package/src/modules/messages/components/message-actions/message-actions.tsx

@@ -1,13 +1,14 @@
-import { type CSSProperties, useState } from 'react'
+import { type CSSProperties, useCallback, useState } from 'react'
 import clsx from 'clsx'
 import dayjs from 'dayjs'
 import { useTranslation } from 'react-i18next'
 
-import { DataHubService } from '@/src/config/datahub'
+import { ComponentSource, DataHubService } from '@/src/config/datahub'
 import type { ButtonReactionsType } from '@/src/config/datahub/schemas/tutor'
 import { ButtonReactions, ClickHotmartTutor } from '@/src/config/datahub/schemas/tutor'
 import { Button, Icon } from '@/src/lib/components'
 import { ToastUtils } from '@/src/lib/utils'
+import { useIsAgentParentAtomValue } from '@/src/modules/widget'
 import type { ParsedMessage } from '../../types'
 
 export type MessageActionsProps = {
@@ -21,6 +22,19 @@ function MessageActions({ message, className, showActions = false }: MessageActi
   const [copying, setCopying] = useState(false)
   const [copied, setCopied] = useState(false)
   const [reaction, setReaction] = useState<ButtonReactionsType | null>(null)
+  const isAgentMode = useIsAgentParentAtomValue()
+
+  const sendEvent = useCallback(
+    ({ reactionType }: { reactionType: ButtonReactionsType }) => {
+      const schema = new ClickHotmartTutor({
+        messageId: message.id,
+        reactionType,
+        componentSource: isAgentMode ? ComponentSource.PRODUCT_AGENT : undefined
+      })
+      DataHubService.sendEvent({ schema })
+    },
+    [isAgentMode, message.id]
+  )
 
   const copyToClipboard = (): void => {
     if (!message.text) return
@@ -32,6 +46,7 @@ function MessageActions({ message, className, showActions = false }: MessageActi
       .then(() => {
         setCopied(true)
         ToastUtils.dispatch({ message: t('general.buttons.copied') })
+        sendEvent({ reactionType: ButtonReactions.COPY })
       })
       .catch((err) => {
         const errorMessage = t('generic_error.title')
@@ -45,8 +60,7 @@ function MessageActions({ message, className, showActions = false }: MessageActi
   }
 
   const handleReaction = (reactionType: ButtonReactionsType = ButtonReactions.LIKE): void => {
-    const schema = new ClickHotmartTutor({ messageId: message.id, reactionType })
-    DataHubService.sendEvent({ schema })
+    sendEvent({ reactionType })
     setReaction(reactionType)
   }
 

package/src/modules/widget/components/chat-page/chat-page.tsx

@@ -10,6 +10,7 @@ import { getAllMessagesQuery, useSendTextMessage } from '@/src/modules/messages/
 import { useMessagesMaxCount } from '@/src/modules/messages/store'
 import { useGetProfile } from '@/src/modules/profile'
 import { TutorWidgetEvents } from '../../events'
+import { useSendViewTutorEvent } from '../../hooks/use-send-view-tutor-event'
 import {
   useWidgetLoadingAtom,
   useWidgetSettingsAtomValue,
@@ -47,6 +48,8 @@ function ChatPage() {
 
   const messagesQuery = useInfiniteQuery(messagesQueryConfig)
 
+  useSendViewTutorEvent()
+
   const handleSendMessage = () => {
     const text = chatInputRef.current?.value ?? ''
 

package/src/modules/widget/components/starter-page/starter-page.tsx

@@ -33,7 +33,7 @@ function WidgetStarterPage() {
   const isMobile = useMediaQuery({ maxSize: 'md' })
   const widgetLoading = useWidgetLoadingAtomValue()
   const hasSentInitialMessage = useRef(false)
-  const [newTutorWidgetFF] = useDecision('lex_new_tutor_widget')
+  const [tutorQuickActionsFF] = useDecision('lex_tutor_quick_actions')
   const [lexTutorInitialMessageFF] = useDecision('lex_tutor_new_widget_initial_message')
 
   useRefEventListener<HTMLTextAreaElement>({
@@ -155,7 +155,7 @@ function WidgetStarterPage() {
             />
           </div>
         </div>
-        {newTutorWidgetFF?.enabled && newTutorWidgetFF?.variables?.['show_quick_actions'] ? (
+        {tutorQuickActionsFF?.enabled ? (
           <QuickActionButtons
             className='grid-area-[b] my-4 flex flex-shrink-0 snap-x snap-mandatory gap-2 overflow-x-auto whitespace-nowrap [scrollbar-width:none] [&::-webkit-scrollbar]:hidden'
             isDarkTheme={isDarkTheme}

package/src/modules/widget/hooks/index.ts

@@ -1,3 +1,4 @@
 export * from './use-init-widget'
 export * from './use-listen-to-theme-change-event'
 export * from './use-listen-to-visibility-events'
+export * from './use-send-view-tutor-event'

package/src/modules/widget/hooks/use-send-view-tutor-event/index.ts

@@ -0,0 +1 @@
+export { default as useSendViewTutorEvent } from './use-send-view-tutor-event'

package/src/modules/widget/hooks/use-send-view-tutor-event/use-send-view-tutor-event.spec.tsx

@@ -0,0 +1,36 @@
+import { ComponentSource, DataHubService } from '@/src/config/datahub'
+import ViewProductTutorSchema from '@/src/config/datahub/schemas/tutor/view-product-tutor'
+import { renderHook } from '@/src/config/tests'
+import { useIsAgentParentAtomValue } from '../../store'
+
+import useSendViewTutorEvent from './use-send-view-tutor-event'
+
+vi.mock('../../store', () => ({ useIsAgentParentAtomValue: vi.fn() }))
+
+describe('useSendViewTutorEvent', () => {
+  const prepareHook = () => renderHook(useSendViewTutorEvent)
+
+  beforeEach(() => {
+    vi.mocked(useIsAgentParentAtomValue).mockReturnValue(true)
+  })
+
+  it('should send datahub event when product is of type agent', () => {
+    const schema = new ViewProductTutorSchema({ componentSource: ComponentSource.PRODUCT_AGENT })
+
+    vi.spyOn(DataHubService, 'sendEvent')
+
+    prepareHook()
+
+    expect(DataHubService.sendEvent).toHaveBeenNthCalledWith(1, { schema })
+  })
+
+  it('should not send datahub event when product is not of type agent', () => {
+    vi.mocked(useIsAgentParentAtomValue).mockReturnValue(false)
+
+    vi.spyOn(DataHubService, 'sendEvent')
+
+    prepareHook()
+
+    expect(DataHubService.sendEvent).not.toHaveBeenCalled()
+  })
+})

package/src/modules/widget/hooks/use-send-view-tutor-event/use-send-view-tutor-event.tsx

@@ -0,0 +1,20 @@
+import { useEffect, useRef } from 'react'
+
+import { ComponentSource, DataHubService } from '@/src/config/datahub'
+import ViewProductTutorSchema from '@/src/config/datahub/schemas/tutor/view-product-tutor'
+import { useIsAgentParentAtomValue } from '../../store'
+
+function useSendViewTutorEvent() {
+  const isAgentMode = useIsAgentParentAtomValue()
+  const sent = useRef(false)
+
+  useEffect(() => {
+    if (sent.current || !isAgentMode) return
+
+    const schema = new ViewProductTutorSchema({ componentSource: ComponentSource.PRODUCT_AGENT })
+    DataHubService.sendEvent({ schema })
+    sent.current = true
+  }, [isAgentMode])
+}
+
+export default useSendViewTutorEvent

package/src/modules/widget/store/index.ts

@@ -2,4 +2,5 @@ export * from './widget-container-intrinsic-height.atom'
 export * from './widget-loading.atom'
 export * from './widget-scrolling.atom'
 export * from './widget-settings.atom'
+export * from './widget-settings-config.atom'
 export * from './widget-tabs.atom'

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

@@ -0,0 +1,10 @@
+import { atom, useAtomValue } from 'jotai'
+
+import { widgetSettingsAtom } from './widget-settings.atom'
+
+export const widgetSettingsConfigAgentParentAtom = atom((get) => {
+  const settings = get(widgetSettingsAtom)
+  return settings?.config?.metadata?.parent === 'AGENT'
+})
+
+export const useIsAgentParentAtomValue = () => useAtomValue(widgetSettingsConfigAgentParentAtom)