app-tutor-ai-consumer 1.22.3 → 1.24.0

package/CHANGELOG.md

@@ -1,3 +1,16 @@
+# [1.24.0](https://github.com/Hotmart-Org/app-tutor-ai-consumer/compare/v1.23.0...v1.24.0) (2025-08-11)
+
+### Features
+
+- add user actions on Tutor Datahub events ([e4281b1](https://github.com/Hotmart-Org/app-tutor-ai-consumer/commit/e4281b14a2b2158bfa6711a55cfaf926d2caa747))
+
+# [1.23.0](https://github.com/Hotmart-Org/app-tutor-ai-consumer/compare/v1.22.3...v1.23.0) (2025-08-11)
+
+### Features
+
+- add metadata properties to widget settings and component IDs to customize on agent page ([04c244d](https://github.com/Hotmart-Org/app-tutor-ai-consumer/commit/04c244dcb4170665f6a216ce69c119e358118ef5))
+- adding component id ([82b25ce](https://github.com/Hotmart-Org/app-tutor-ai-consumer/commit/82b25ce4a4974d3739dae09dc21928d5b3b78544))
+
 ## [1.22.3](https://github.com/Hotmart-Org/app-tutor-ai-consumer/compare/v1.22.2...v1.22.3) (2025-08-08)
 
 ## [1.22.2](https://github.com/Hotmart-Org/app-tutor-ai-consumer/compare/v1.22.1...v1.22.2) (2025-08-07)

package/package.json

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

package/src/config/datahub/actions.ts

@@ -12,5 +12,12 @@ export type DataHubActionTypes = (typeof DataHubActions)[keyof typeof DataHubAct
 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_PRODUCT_TUTOR: `${DataHubActions.TRY}_product_tutor`,
+  CLICK_TUTOR_BACK: `${DataHubActions.CLICK}_tutor_back`,
+  CLICK_TUTOR_HISTORY: `${DataHubActions.CLICK}_tutor_history`,
+  CLICK_TUTOR_INFO: `${DataHubActions.CLICK}_tutor_info`,
+  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

package/src/config/datahub/constants.ts

@@ -24,7 +24,14 @@ export const Result = {
 export const ComponentNames = {
   BUTTON_LIKE_ANSWER: 'BUTTON_LIKE_ANSWER',
   BUTTON_DISLIKE_ANSWER: 'BUTTON_DISLIKE_ANSWER',
-  BUTTON_CLOSE_TUTOR_CHAT: 'BUTTON_CLOSE_TUTOR_CHAT'
+  BUTTON_CLOSE_TUTOR_CHAT: 'BUTTON_CLOSE_TUTOR_CHAT',
+  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',
+  PRODUCT_CONSUME_CLICK_TUTOR_KNOW_MORE: 'product_consume_click_tutor_know_more',
+  PRODUCT_CONSUME_CLICK_TUTOR_ONBOARDING_START: 'product_consume_click_tutor_onboarding_start',
+  PRODUCT_CONSUME_CLICK_TUTOR_TEST_KNOWLEDGE: 'product_consume_click_tutor_test_knowledge',
+  PRODUCT_CONSUME_CLOSE_TUTOR_ONBOARDING: 'product_consume_close_tutor_onboarding'
 } as const
 
 export const ComponentSource = {

package/src/config/datahub/schemas/base-click-product-schema.ts

@@ -0,0 +1,51 @@
+import { ScreenNames } from '../constants'
+import { DataHubEntities } from '../entities'
+import type { ComponentNamesType, DataHubEntityTypes, ScreenNamesType } from '../types'
+
+import BaseProductSchema from './base-product-schema'
+import { ProductCategories } from './constants'
+import type { ProductCategoriesType } from './types'
+
+export type ConstructorArgs = {
+  componentName: ComponentNamesType
+  entity?: DataHubEntityTypes
+  isLogged?: boolean
+  screenName?: ScreenNamesType
+  productType?: ProductCategoriesType
+}
+
+abstract class BaseClickProductSchema extends BaseProductSchema {
+  protected componentName: ComponentNamesType
+  protected screenName: ScreenNamesType
+
+  entity: DataHubEntityTypes
+  isLogged: boolean
+
+  constructor(args: ConstructorArgs) {
+    const {
+      componentName,
+      entity = DataHubEntities.HOME,
+      isLogged = true,
+      screenName = ScreenNames.HOME_CONSUMER,
+      productType = ProductCategories.OnlineServices
+    } = args
+
+    super({ productType })
+
+    this.componentName = componentName
+    this.entity = entity
+    this.isLogged = isLogged
+    this.screenName = screenName
+  }
+
+  prepare() {
+    return {
+      ...super.prepare(),
+      componentName: this.componentName,
+      isLogged: this.isLogged,
+      screenName: this.screenName
+    }
+  }
+}
+
+export default BaseClickProductSchema

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

@@ -0,0 +1,52 @@
+import { DataHubStore } from '..'
+import { ScreenNames } from '../constants'
+import { DataHubEntities } from '../entities'
+import type { ComponentNamesType, DataHubEntityTypes, ScreenNamesType } from '../types'
+
+import BaseSchema from './base-schema'
+
+export type BaseCloseSchemaConstructorProps = {
+  componentName: ComponentNamesType
+  entity?: DataHubEntityTypes
+  isLogged?: boolean
+  screenName?: ScreenNamesType
+}
+
+abstract class BaseCloseSchema extends BaseSchema {
+  protected componentName: ComponentNamesType
+  protected screenName: ScreenNamesType
+
+  entity: DataHubEntityTypes
+  isLogged: boolean
+
+  constructor(args: BaseCloseSchemaConstructorProps) {
+    const {
+      componentName,
+      entity = DataHubEntities.HOME,
+      isLogged = true,
+      screenName = ScreenNames.HOME_CONSUMER
+    } = args
+
+    super()
+
+    this.componentName = componentName
+    this.entity = entity
+    this.isLogged = isLogged
+    this.screenName = screenName
+  }
+
+  prepare() {
+    return {
+      ...super.prepare(),
+      componentName: this.componentName,
+      connectionStatus: 'ONLINE',
+      entity: this.entity,
+      isLogged: this.isLogged,
+      productCategory: DataHubStore.product.category,
+      productId: DataHubStore.product.id,
+      screenName: this.screenName
+    }
+  }
+}
+
+export default BaseCloseSchema

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

@@ -0,0 +1,37 @@
+import { DataHubStore } from '..'
+
+import BaseSchema from './base-schema'
+import type { ProductCategoriesType } from './types'
+
+type ConstructorArgs = {
+  productType?: ProductCategoriesType
+}
+
+abstract class BaseProductSchema extends BaseSchema {
+  private productId: number
+  private productCategory: ProductCategoriesType
+  private connectionStatus: 'ONLINE' | 'OFFLINE'
+
+  constructor(
+    { productType = DataHubStore.product.category as ProductCategoriesType }: ConstructorArgs = {
+      productType: DataHubStore.product.category as ProductCategoriesType
+    }
+  ) {
+    super()
+
+    this.productId = DataHubStore.product.id
+    this.productCategory = productType
+    this.connectionStatus = 'ONLINE'
+  }
+
+  prepare() {
+    return {
+      ...super.prepare(),
+      productId: this.productId,
+      productCategory: this.productCategory,
+      connectionStatus: this.connectionStatus
+    }
+  }
+}
+
+export default BaseProductSchema

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

@@ -50,8 +50,6 @@ abstract class BaseSchema implements SchemaType, InitDataParams {
 
   prepare(): Record<string, unknown> {
     return {
-      action: this.action,
-      entity: this.entity,
       isLogged: this.isLogged,
       appVersion: this.appVersion,
       osVersion: this.osVersion,

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

@@ -8,3 +8,8 @@ export const UserRole = {
   ADMIN: 'ADMIN',
   CONSUMER: 'CONSUMER'
 } as const
+
+export const ProductCategories = {
+  OnlineServices: 'category.online_services.name',
+  Ebook: 'category.ebook.name'
+} as const

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

@@ -1,8 +1,6 @@
 import { chance } from '@/src/config/tests'
 import { DataHubStore } from '../../..'
-import { ActionNames } from '../../../actions'
 import { ComponentNames, ScreenNames } from '../../../constants'
-import { DataHubEntities } from '../../../entities'
 import { UserRole } from '../../constants'
 import ClickHotmartTutor from '../click-hotmart-tutor'
 import { ButtonReactions } from '../constants'
@@ -17,11 +15,9 @@ describe('ClickHotmartTutor', () => {
     }
 
     expect(new ClickHotmartTutor(event).getDataHubEventData()).toMatchObject({
-      action: ActionNames.CLICK_HOTMART_TUTOR,
       appVersion: '',
       clubVersion: 'MEMBERSHIP',
       componentName: ComponentNames.BUTTON_DISLIKE_ANSWER,
-      entity: DataHubEntities.HOME,
       hasAccess: event.hasAccess,
       isLogged: event.isLogged,
       membershipId: 'UNDEFINED',
@@ -58,11 +54,9 @@ describe('ClickHotmartTutor', () => {
     DataHubStore.initData(store)
 
     expect(new ClickHotmartTutor(event).getDataHubEventData()).toMatchObject({
-      action: ActionNames.CLICK_HOTMART_TUTOR,
       appVersion: '',
       clubVersion: 'MEMBERSHIP',
       componentName: ComponentNames.BUTTON_LIKE_ANSWER,
-      entity: DataHubEntities.HOME,
       hasAccess: event.hasAccess,
       isLogged: event.isLogged,
       membershipId: store.membershipId,

package/src/config/datahub/schemas/tutor/__tests__/click-tutor-back.spec.ts

@@ -0,0 +1,32 @@
+import { ActionNames } from '../../../actions'
+import { ComponentNames, ScreenNames } from '../../../constants'
+import { DataHubEntities } from '../../../entities'
+import { ProductCategories, UserRole } from '../..'
+import ClickTutorBackSchema from '../click-tutor-back'
+
+describe('ClickTutorBackSchema', () => {
+  it('should return the event correct data', () => {
+    expect(new ClickTutorBackSchema()).toMatchObject({
+      action: ActionNames.CLICK_TUTOR_BACK,
+      appVersion: '',
+      clubVersion: 'MEMBERSHIP',
+      componentName: ComponentNames.PRODUCT_CONSUME_CLICK_TUTOR_BACK,
+      entity: DataHubEntities.PRODUCT_CONSUME,
+      isLogged: true,
+      membershipId: 'UNDEFINED',
+      membershipSlug: 'UNDEFINED',
+      osVersion: '537.36',
+      platform: 'WEB',
+      platformDetail: 'WebKit',
+      screenName: ScreenNames.HOME_CONSUMER,
+      sessionId: 'UNDEFINED',
+      ucode: 'UNDEFINED',
+      url: 'http://localhost:3000/',
+      userId: 0,
+      userRole: UserRole.CONSUMER,
+      productId: 0,
+      productCategory: ProductCategories.OnlineServices,
+      connectionStatus: 'ONLINE'
+    })
+  })
+})

package/src/config/datahub/schemas/tutor/__tests__/click-tutor-history.spec.ts

@@ -0,0 +1,32 @@
+import { ActionNames } from '../../../actions'
+import { ComponentNames, ScreenNames } from '../../../constants'
+import { DataHubEntities } from '../../../entities'
+import { ProductCategories, UserRole } from '../../constants'
+import ClickTutorHistorySchema from '../click-tutor-history'
+
+describe('ClickTutorHistorySchema', () => {
+  it('should return the event correct data', () => {
+    expect(new ClickTutorHistorySchema()).toMatchObject({
+      action: ActionNames.CLICK_TUTOR_HISTORY,
+      appVersion: '',
+      clubVersion: 'MEMBERSHIP',
+      componentName: ComponentNames.PRODUCT_CONSUME_CLICK_TUTOR_HISTORY,
+      entity: DataHubEntities.PRODUCT_CONSUME,
+      isLogged: true,
+      membershipId: 'UNDEFINED',
+      membershipSlug: 'UNDEFINED',
+      osVersion: '537.36',
+      platform: 'WEB',
+      platformDetail: 'WebKit',
+      screenName: ScreenNames.HOME_CONSUMER,
+      sessionId: 'UNDEFINED',
+      ucode: 'UNDEFINED',
+      url: 'http://localhost:3000/',
+      userId: 0,
+      userRole: UserRole.CONSUMER,
+      productId: 0,
+      productCategory: ProductCategories.OnlineServices,
+      connectionStatus: 'ONLINE'
+    })
+  })
+})

package/src/config/datahub/schemas/tutor/__tests__/click-tutor-info.spec.ts

@@ -0,0 +1,32 @@
+import { ActionNames } from '../../../actions'
+import { ComponentNames, ScreenNames } from '../../../constants'
+import { DataHubEntities } from '../../../entities'
+import { ProductCategories, UserRole } from '../../constants'
+import ClickTutorInfoSchema from '../click-tutor-info'
+
+describe('ClickTutorInfoSchema', () => {
+  it('should return the event correct data', () => {
+    expect(new ClickTutorInfoSchema()).toMatchObject({
+      action: ActionNames.CLICK_TUTOR_INFO,
+      appVersion: '',
+      clubVersion: 'MEMBERSHIP',
+      componentName: ComponentNames.PRODUCT_CONSUME_CLICK_TUTOR_INFO,
+      entity: DataHubEntities.PRODUCT_CONSUME,
+      isLogged: true,
+      membershipId: 'UNDEFINED',
+      membershipSlug: 'UNDEFINED',
+      osVersion: '537.36',
+      platform: 'WEB',
+      platformDetail: 'WebKit',
+      screenName: ScreenNames.HOME_CONSUMER,
+      sessionId: 'UNDEFINED',
+      ucode: 'UNDEFINED',
+      url: 'http://localhost:3000/',
+      userId: 0,
+      userRole: UserRole.CONSUMER,
+      productId: 0,
+      productCategory: ProductCategories.OnlineServices,
+      connectionStatus: 'ONLINE'
+    })
+  })
+})

package/src/config/datahub/schemas/tutor/__tests__/click-tutor-know-more.spec.ts

@@ -0,0 +1,32 @@
+import { ActionNames } from '../../../actions'
+import { ComponentNames, ScreenNames } from '../../../constants'
+import { DataHubEntities } from '../../../entities'
+import { ProductCategories, UserRole } from '../../constants'
+import ClickTutorKnowMoreSchema from '../click-tutor-know-more'
+
+describe('ClickTutorKnowMoreSchema', () => {
+  it('should return the event correct data', () => {
+    expect(new ClickTutorKnowMoreSchema()).toMatchObject({
+      action: ActionNames.CLICK_TUTOR_KNOW_MORE,
+      appVersion: '',
+      clubVersion: 'MEMBERSHIP',
+      componentName: ComponentNames.PRODUCT_CONSUME_CLICK_TUTOR_KNOW_MORE,
+      entity: DataHubEntities.PRODUCT_CONSUME,
+      isLogged: true,
+      membershipId: 'UNDEFINED',
+      membershipSlug: 'UNDEFINED',
+      osVersion: '537.36',
+      platform: 'WEB',
+      platformDetail: 'WebKit',
+      screenName: ScreenNames.HOME_CONSUMER,
+      sessionId: 'UNDEFINED',
+      ucode: 'UNDEFINED',
+      url: 'http://localhost:3000/',
+      userId: 0,
+      userRole: UserRole.CONSUMER,
+      productId: 0,
+      productCategory: ProductCategories.OnlineServices,
+      connectionStatus: 'ONLINE'
+    })
+  })
+})

package/src/config/datahub/schemas/tutor/__tests__/click-tutor-onboarding-start.spec.ts

@@ -0,0 +1,32 @@
+import { ActionNames } from '../../../actions'
+import { ComponentNames, ScreenNames } from '../../../constants'
+import { DataHubEntities } from '../../../entities'
+import { ProductCategories, UserRole } from '../../constants'
+import ClickTutorOnboardingStartSchema from '../click-tutor-onboarding-start'
+
+describe('ClickTutorOnboardingStartSchema', () => {
+  it('should return the event correct data', () => {
+    expect(new ClickTutorOnboardingStartSchema()).toMatchObject({
+      action: ActionNames.CLICK_TUTOR_ONBOARDING_START,
+      appVersion: '',
+      clubVersion: 'MEMBERSHIP',
+      componentName: ComponentNames.PRODUCT_CONSUME_CLICK_TUTOR_ONBOARDING_START,
+      entity: DataHubEntities.PRODUCT_CONSUME,
+      isLogged: true,
+      membershipId: 'UNDEFINED',
+      membershipSlug: 'UNDEFINED',
+      osVersion: '537.36',
+      platform: 'WEB',
+      platformDetail: 'WebKit',
+      screenName: ScreenNames.HOME_CONSUMER,
+      sessionId: 'UNDEFINED',
+      ucode: 'UNDEFINED',
+      url: 'http://localhost:3000/',
+      userId: 0,
+      userRole: UserRole.CONSUMER,
+      productId: 0,
+      productCategory: ProductCategories.OnlineServices,
+      connectionStatus: 'ONLINE'
+    })
+  })
+})

package/src/config/datahub/schemas/tutor/__tests__/click-tutor-test-knowledge.spec.ts

@@ -0,0 +1,32 @@
+import { ActionNames } from '../../../actions'
+import { ComponentNames, ScreenNames } from '../../../constants'
+import { DataHubEntities } from '../../../entities'
+import { ProductCategories, UserRole } from '../../constants'
+import ClickTutorTestKnowledgeSchema from '../click-tutor-test-knowledge'
+
+describe('ClickTutorTestKnowledgeSchema', () => {
+  it('should return the event correct data', () => {
+    expect(new ClickTutorTestKnowledgeSchema()).toMatchObject({
+      action: ActionNames.CLICK_TUTOR_TEST_KNOWLEDGE,
+      appVersion: '',
+      clubVersion: 'MEMBERSHIP',
+      componentName: ComponentNames.PRODUCT_CONSUME_CLICK_TUTOR_TEST_KNOWLEDGE,
+      entity: DataHubEntities.PRODUCT_CONSUME,
+      isLogged: true,
+      membershipId: 'UNDEFINED',
+      membershipSlug: 'UNDEFINED',
+      osVersion: '537.36',
+      platform: 'WEB',
+      platformDetail: 'WebKit',
+      screenName: ScreenNames.HOME_CONSUMER,
+      sessionId: 'UNDEFINED',
+      ucode: 'UNDEFINED',
+      url: 'http://localhost:3000/',
+      userId: 0,
+      userRole: UserRole.CONSUMER,
+      productId: 0,
+      productCategory: ProductCategories.OnlineServices,
+      connectionStatus: 'ONLINE'
+    })
+  })
+})

package/src/config/datahub/schemas/tutor/__tests__/close-tutor-onboarding.spec.ts

@@ -0,0 +1,32 @@
+import { ActionNames } from '../../../actions'
+import { ComponentNames, ScreenNames } from '../../../constants'
+import { DataHubEntities } from '../../../entities'
+import { ProductCategories, UserRole } from '../../constants'
+import CloseTutorOnboardingSchema from '../close-tutor-onboarding'
+
+describe('CloseTutorOnboardingSchema', () => {
+  it('should return the event correct data', () => {
+    expect(new CloseTutorOnboardingSchema()).toMatchObject({
+      action: ActionNames.CLOSE_TUTOR_ONBOARDING,
+      appVersion: '',
+      clubVersion: 'MEMBERSHIP',
+      componentName: ComponentNames.PRODUCT_CONSUME_CLOSE_TUTOR_ONBOARDING,
+      entity: DataHubEntities.PRODUCT_CONSUME,
+      isLogged: true,
+      membershipId: 'UNDEFINED',
+      membershipSlug: 'UNDEFINED',
+      osVersion: '537.36',
+      platform: 'WEB',
+      platformDetail: 'WebKit',
+      screenName: ScreenNames.HOME_CONSUMER,
+      sessionId: 'UNDEFINED',
+      ucode: 'UNDEFINED',
+      url: 'http://localhost:3000/',
+      userId: 0,
+      userRole: UserRole.CONSUMER,
+      productId: 0,
+      productCategory: ProductCategories.OnlineServices,
+      connectionStatus: 'ONLINE'
+    })
+  })
+})

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

@@ -0,0 +1,26 @@
+import { ActionNames } from '../../actions'
+import { ComponentNames } from '../../constants'
+import { DataHubEntities } from '../../entities'
+import type { ActionNamesType } from '../../types'
+import BaseClickProductSchema from '../base-click-product-schema'
+
+class ClickTutorBackSchema extends BaseClickProductSchema {
+  action: ActionNamesType
+
+  constructor() {
+    super({
+      componentName: ComponentNames.PRODUCT_CONSUME_CLICK_TUTOR_BACK
+    })
+
+    this.action = ActionNames.CLICK_TUTOR_BACK
+    this.entity = DataHubEntities.PRODUCT_CONSUME
+  }
+
+  getDataHubEventData(): Record<string, unknown> {
+    return {
+      ...super.prepare()
+    }
+  }
+}
+
+export default ClickTutorBackSchema

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

@@ -0,0 +1,26 @@
+import { ActionNames } from '../../actions'
+import { ComponentNames } from '../../constants'
+import { DataHubEntities } from '../../entities'
+import type { ActionNamesType } from '../../types'
+import BaseClickProductSchema from '../base-click-product-schema'
+
+class ClickTutorHistorySchema extends BaseClickProductSchema {
+  action: ActionNamesType
+
+  constructor() {
+    super({
+      componentName: ComponentNames.PRODUCT_CONSUME_CLICK_TUTOR_HISTORY
+    })
+
+    this.action = ActionNames.CLICK_TUTOR_HISTORY
+    this.entity = DataHubEntities.PRODUCT_CONSUME
+  }
+
+  getDataHubEventData(): Record<string, unknown> {
+    return {
+      ...super.prepare()
+    }
+  }
+}
+
+export default ClickTutorHistorySchema

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

@@ -0,0 +1,26 @@
+import { ActionNames } from '../../actions'
+import { ComponentNames } from '../../constants'
+import { DataHubEntities } from '../../entities'
+import type { ActionNamesType } from '../../types'
+import BaseClickProductSchema from '../base-click-product-schema'
+
+class ClickTutorInfoSchema extends BaseClickProductSchema {
+  action: ActionNamesType
+
+  constructor() {
+    super({
+      componentName: ComponentNames.PRODUCT_CONSUME_CLICK_TUTOR_INFO
+    })
+
+    this.action = ActionNames.CLICK_TUTOR_INFO
+    this.entity = DataHubEntities.PRODUCT_CONSUME
+  }
+
+  getDataHubEventData(): Record<string, unknown> {
+    return {
+      ...super.prepare()
+    }
+  }
+}
+
+export default ClickTutorInfoSchema

package/src/config/datahub/schemas/tutor/click-tutor-know-more.ts

@@ -0,0 +1,26 @@
+import { ActionNames } from '../../actions'
+import { ComponentNames } from '../../constants'
+import { DataHubEntities } from '../../entities'
+import type { ActionNamesType } from '../../types'
+import BaseClickProductSchema from '../base-click-product-schema'
+
+class ClickTutorKnowMoreSchema extends BaseClickProductSchema {
+  action: ActionNamesType
+
+  constructor() {
+    super({
+      componentName: ComponentNames.PRODUCT_CONSUME_CLICK_TUTOR_KNOW_MORE
+    })
+
+    this.action = ActionNames.CLICK_TUTOR_KNOW_MORE
+    this.entity = DataHubEntities.PRODUCT_CONSUME
+  }
+
+  getDataHubEventData(): Record<string, unknown> {
+    return {
+      ...super.prepare()
+    }
+  }
+}
+
+export default ClickTutorKnowMoreSchema

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

@@ -2,9 +2,9 @@ import { ActionNames } from '../../actions'
 import { ComponentNames } from '../../constants'
 import { DataHubEntities } from '../../entities'
 import type { ActionNamesType } from '../../types'
-import BaseClickSchema from '../base-click-schema'
+import BaseClickProductSchema from '../base-click-product-schema'
 
-class ClickTutorMinimizeSchema extends BaseClickSchema {
+class ClickTutorMinimizeSchema extends BaseClickProductSchema {
   action: ActionNamesType
 
   constructor() {

package/src/config/datahub/schemas/tutor/click-tutor-onboarding-start.ts

@@ -0,0 +1,26 @@
+import { ActionNames } from '../../actions'
+import { ComponentNames } from '../../constants'
+import { DataHubEntities } from '../../entities'
+import type { ActionNamesType } from '../../types'
+import BaseClickProductSchema from '../base-click-product-schema'
+
+class ClickTutorOnboardingStartSchema extends BaseClickProductSchema {
+  action: ActionNamesType
+
+  constructor() {
+    super({
+      componentName: ComponentNames.PRODUCT_CONSUME_CLICK_TUTOR_ONBOARDING_START
+    })
+
+    this.action = ActionNames.CLICK_TUTOR_ONBOARDING_START
+    this.entity = DataHubEntities.PRODUCT_CONSUME
+  }
+
+  getDataHubEventData(): Record<string, unknown> {
+    return {
+      ...super.prepare()
+    }
+  }
+}
+
+export default ClickTutorOnboardingStartSchema

package/src/config/datahub/schemas/tutor/click-tutor-test-knowledge.ts

@@ -0,0 +1,26 @@
+import { ActionNames } from '../../actions'
+import { ComponentNames } from '../../constants'
+import { DataHubEntities } from '../../entities'
+import type { ActionNamesType } from '../../types'
+import BaseClickProductSchema from '../base-click-product-schema'
+
+class ClickTutorTestKnowledgeSchema extends BaseClickProductSchema {
+  action: ActionNamesType
+
+  constructor() {
+    super({
+      componentName: ComponentNames.PRODUCT_CONSUME_CLICK_TUTOR_TEST_KNOWLEDGE
+    })
+
+    this.action = ActionNames.CLICK_TUTOR_TEST_KNOWLEDGE
+    this.entity = DataHubEntities.PRODUCT_CONSUME
+  }
+
+  getDataHubEventData(): Record<string, unknown> {
+    return {
+      ...super.prepare()
+    }
+  }
+}
+
+export default ClickTutorTestKnowledgeSchema

package/src/config/datahub/schemas/tutor/close-tutor-onboarding.ts

@@ -0,0 +1,33 @@
+import { ActionNames } from '../../actions'
+import { ComponentNames, ScreenNames } from '../../constants'
+import { DataHubEntities } from '../../entities'
+import type { ActionNamesType } from '../../types'
+import BaseClickProductSchema from '../base-click-product-schema'
+
+class CloseTutorOnboardingSchema extends BaseClickProductSchema {
+  action: ActionNamesType
+
+  constructor(
+    { componentName, screenName, entity } = {
+      componentName: ComponentNames.PRODUCT_CONSUME_CLOSE_TUTOR_ONBOARDING,
+      screenName: ScreenNames.HOME_CONSUMER,
+      entity: DataHubEntities.PRODUCT_CONSUME
+    }
+  ) {
+    super({
+      componentName,
+      screenName,
+      entity
+    })
+
+    this.action = ActionNames.CLOSE_TUTOR_ONBOARDING
+  }
+
+  getDataHubEventData(): Record<string, unknown> {
+    return {
+      ...this.prepare()
+    }
+  }
+}
+
+export default CloseTutorOnboardingSchema

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

@@ -1,4 +1,11 @@
 export { default as ClickHotmartTutor } from './click-hotmart-tutor'
+export { default as ClickTutorBackSchema } from './click-tutor-back'
+export { default as ClickTutorHistorySchema } from './click-tutor-history'
+export { default as ClickTutorInfoSchema } from './click-tutor-info'
+export { default as ClickTutorKnowMoreSchema } from './click-tutor-know-more'
 export { default as ClickTutorMinimizeSchema } from './click-tutor-minimize'
+export { default as ClickTutorOnboardingStartSchema } from './click-tutor-onboarding-start'
+export { default as ClickTutorTestKnowledgeSchema } from './click-tutor-test-knowledge'
+export { default as CloseTutorOnboardingSchema } from './close-tutor-onboarding'
 export * from './constants'
 export * from './types'

package/src/config/datahub/schemas/types.ts

@@ -1,9 +1,11 @@
-import type { ClubVersion, UserRole } from './constants'
+import type { ClubVersion, ProductCategories, UserRole } from './constants'
 
 export type UserRoleType = (typeof UserRole)[keyof typeof UserRole]
 
 export type ClubVersionType = (typeof ClubVersion)[keyof typeof ClubVersion]
 
+export type ProductCategoriesType = (typeof ProductCategories)[keyof typeof ProductCategories]
+
 export type SchemaBasedProps = {
   membershipSlug?: string
   membershipId?: string

package/src/config/datahub/store.ts

@@ -2,6 +2,11 @@ import { UAParser } from 'ua-parser-js'
 
 import type { InitDataParams } from './types'
 
+const defaultProduct = {
+  id: 0,
+  category: 'unknown'
+}
+
 class DataHubStore {
   private instanceObj?: {
     userAgentParser: UAParser.IResult
@@ -14,13 +19,24 @@ class DataHubStore {
     userId: number
     membershipSlug: string
     membershipId: string
+    product: {
+      id: number
+      category: string
+    }
   }
 
   private get instance() {
     return this.instanceObj ?? this.resetData()
   }
 
-  initData({ ucode, membershipId, membershipSlug, sessionId, userId }: InitDataParams) {
+  initData({
+    ucode,
+    membershipId,
+    membershipSlug,
+    sessionId,
+    userId,
+    product = defaultProduct
+  }: InitDataParams) {
     this.instance.userAgentParser = UAParser(navigator.userAgent)
     this.instance.browserInfo = this.instance.userAgentParser.browser
     this.instance.deviceType =
@@ -32,6 +48,7 @@ class DataHubStore {
     this.instance.userId = userId || 0
     this.instance.membershipSlug = membershipSlug
     this.instance.membershipId = membershipId
+    this.instance.product = product
   }
 
   resetData() {
@@ -47,7 +64,8 @@ class DataHubStore {
       sessionId: 'UNDEFINED',
       userId: 0,
       membershipSlug: 'UNDEFINED',
-      membershipId: 'UNDEFINED'
+      membershipId: 'UNDEFINED',
+      product: defaultProduct
     }
 
     this.instanceObj = clearData
@@ -82,6 +100,10 @@ class DataHubStore {
   get membershipId() {
     return this.instance.membershipId
   }
+
+  get product() {
+    return this.instance.product
+  }
 }
 
 export default new DataHubStore()

package/src/config/datahub/types.ts

@@ -34,4 +34,8 @@ export type InitDataParams = {
   userId: number
   membershipSlug: string
   membershipId: string
+  product?: {
+    id: number
+    category: string
+  }
 }

package/src/config/tests/handlers.ts

@@ -10,6 +10,9 @@ export const handlers = [
   http.all('https://tracking-api.buildstaging.com/rest/track/event/json/sync', () => {
     return HttpResponse.json({ ok: true })
   }),
+  http.all('https://tracking-api.buildstaging.com/rest/track/event/json', () => {
+    return HttpResponse.json({ ok: true })
+  }),
   http.all('https://c3po-api-auth.buildstaging.com/v1/auth/sparkie', () => {
     return HttpResponse.json({ ok: true })
   }),

package/src/development-bootstrap.tsx

@@ -20,7 +20,7 @@ if (devMode) {
     container.setAttribute('id', rootId)
     container.setAttribute(
       'class',
-      'bg-ai-dark fixed bottom-5 right-5 w-[27rem] h-[min(43rem,calc(100vh-2.5rem))] max-h-[calc(100vh-2.5rem)] z-10 rounded-[0.625rem] border border-neutral-200 shadow-lg overflow-hidden flex flex-col'
+      'fixed bottom-5 right-5 w-[27rem] h-[min(43rem,calc(100vh-2.5rem))] max-h-[calc(100vh-2.5rem)] z-10 rounded-[0.625rem] border border-neutral-200 shadow-lg overflow-hidden flex flex-col'
     )
 
     // Theme setter

package/src/lib/components/horizontal-draggable-scroll/horizontal-draggable-scroll.tsx

@@ -42,6 +42,7 @@ function HorizontalDraggableScroll({ children, className }: HorizontalDraggableS
 
   return (
     <div
+      id='tutor-ai-consumer-horizontal-draggable-scroll'
       ref={containerRef}
       onMouseDown={handleMouseDown}
       onMouseMove={handleMouseMove}

package/src/lib/components/tooltip/styles.module.css

@@ -36,4 +36,4 @@
   top: 50%;
   left: 96%;
   transform: translateY(-50%) rotateZ(90deg);
-}
+}

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

@@ -71,7 +71,12 @@ function useSendTextMessage() {
               router: questionParam ? 'summary' : undefined,
               osVersion: browserInfo.version,
               platformDetail: browserInfo.name,
-              ucode: settings.user?.ucode
+              ucode: settings.user?.ucode,
+              agentProductId: settings.config?.metadata?.agentProductId,
+              agentName: settings.config?.metadata?.agentName,
+              courseName: settings.config?.metadata?.courseName,
+              source: settings.config?.metadata?.source,
+              prompt: settings.config?.metadata?.promptId
             },
             externalId: v4(),
             namespace: settings.namespace,

package/src/modules/widget/components/header/widget-header.tsx

@@ -3,7 +3,12 @@ import clsx from 'clsx'
 import { useTranslation } from 'react-i18next'
 
 import { DataHubService } from '@/src/config/datahub'
-import { ClickTutorMinimizeSchema } from '@/src/config/datahub/schemas/tutor'
+import {
+  ClickTutorBackSchema,
+  ClickTutorHistorySchema,
+  ClickTutorInfoSchema,
+  ClickTutorMinimizeSchema
+} from '@/src/config/datahub/schemas/tutor'
 import { Button, Icon, Tooltip } from '@/src/lib/components'
 import { useMediaQuery } from '@/src/lib/hooks'
 import { TutorWidgetEvents } from '../../events'
@@ -25,10 +30,12 @@ function WidgetHeaderActions({
 
   const handleClickArchive = () => {
     setTab('chat')
+    DataHubService.sendEvent({ schema: new ClickTutorHistorySchema() })
   }
 
   const handleClickInfo = () => {
     setTab('information')
+    DataHubService.sendEvent({ schema: new ClickTutorInfoSchema() })
   }
 
   const handleClickExpand = () => {
@@ -98,8 +105,15 @@ function WidgetHeader({
 
   const hasToShowActions = useMemo(() => Number(actionButtons?.length) > 0, [actionButtons?.length])
 
+  const handleGoBack = () => {
+    goBack()
+    DataHubService.sendEvent({ schema: new ClickTutorBackSchema() })
+  }
+
   return (
-    <div className='mb-4 mt-0.5 flex flex-col gap-2 text-neutral-900'>
+    <div
+      id='tutor-ai-consumer-widget-header'
+      className='mb-4 mt-0.5 flex flex-col gap-2 text-neutral-900'>
       <div className='flex justify-end'>
         <div className={styles.closeContainer}>
           <Button
@@ -119,7 +133,7 @@ function WidgetHeader({
         })}>
         {enabledButtons.includes('arrow-left') && (
           <div>
-            <Button aria-label='Arrow Left Icon' onClick={goBack}>
+            <Button aria-label='Arrow Left Icon' onClick={handleGoBack}>
               <Icon name='arrow-left' className='h-3.5 w-3.5' aria-hidden />
             </Button>
           </div>

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

@@ -23,7 +23,9 @@ function PageLayout({ asideChild, children, className }: PageLayoutProps) {
         {children}
       </div>
       {asideChild && (
-        <div className='grid-area-[aside] flex-shrink-0 border-t border-t-neutral-300 px-5 py-4'>
+        <div
+          id='tutor-ai-consumer-page-layout-aside'
+          className='grid-area-[aside] flex-shrink-0 border-t border-t-neutral-300 px-5 py-4'>
           {asideChild}
         </div>
       )}

package/src/modules/widget/components/quick-action-buttons/index.ts

@@ -0,0 +1,2 @@
+export * from './quick-action-buttons'
+export { default as QuickActionButtons } from './quick-action-buttons'

package/src/modules/widget/components/quick-action-buttons/quick-action-buttons.tsx

@@ -0,0 +1,74 @@
+import { useMemo } from 'react'
+import type { CSSProperties, MouseEventHandler } from 'react'
+import { useTranslation } from 'react-i18next'
+
+import { DataHubService } from '@/src/config/datahub'
+import {
+  ClickTutorKnowMoreSchema,
+  ClickTutorTestKnowledgeSchema
+} from '@/src/config/datahub/schemas/tutor'
+import { Button, HorizontalDraggableScroll } from '@/src/lib/components'
+
+export type QuickActionButtonsProps = {
+  send: (textContent?: string | null) => void
+  loading?: boolean
+  isDarkTheme?: boolean
+  className?: string
+}
+
+function QuickActionButtons({
+  send,
+  className,
+  loading = false,
+  isDarkTheme = false
+}: QuickActionButtonsProps) {
+  const { t } = useTranslation()
+  const actionButtonStyle = useMemo(
+    () =>
+      isDarkTheme
+        ? undefined
+        : ({
+            '--gradient-btn-hover-foreground': '#0d0d0d'
+          } as CSSProperties),
+    [isDarkTheme]
+  )
+
+  const handleAskQuestion: MouseEventHandler<HTMLButtonElement> = (e) => {
+    send(e?.currentTarget?.querySelector('span[data-label=text-content]')?.textContent)
+  }
+
+  const handleAskToKnowMore: MouseEventHandler<HTMLButtonElement> = (e) => {
+    handleAskQuestion(e)
+    DataHubService.sendEvent({ schema: new ClickTutorKnowMoreSchema() })
+  }
+
+  const handleAskToTestKnowledge: MouseEventHandler<HTMLButtonElement> = (e) => {
+    handleAskQuestion(e)
+    DataHubService.sendEvent({ schema: new ClickTutorTestKnowledgeSchema() })
+  }
+
+  return (
+    <HorizontalDraggableScroll className={className}>
+      <Button
+        variant='gradient-outline'
+        style={actionButtonStyle}
+        className='ml-5 shrink-0 text-sm'
+        onClick={handleAskToKnowMore}
+        loading={loading}>
+        <span>🤖 </span>
+        {t('starter_page.what_does_tutor_do')}
+      </Button>
+      <Button
+        variant='gradient-outline'
+        style={actionButtonStyle}
+        className='mr-5 shrink-0 text-sm'
+        onClick={handleAskToTestKnowledge}
+        loading={loading}>
+        <span>📝 </span>
+        {t('starter_page.test_me')}
+      </Button>
+    </HorizontalDraggableScroll>
+  )
+}
+
+export default QuickActionButtons

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

@@ -1,9 +1,7 @@
 import { useEffect, useMemo, useRef } from 'react'
 import { useQueryClient } from '@tanstack/react-query'
-import type { CSSProperties, MouseEventHandler } from 'react'
 import { useTranslation } from 'react-i18next'
 
-import { Button, HorizontalDraggableScroll } from '@/src/lib/components'
 import { useMediaQuery, useRefEventListener } from '@/src/lib/hooks'
 import { ChatInput, useChatInputValueAtom } from '@/src/modules/messages/components'
 import { getAllMessagesQuery, useSendTextMessage } from '@/src/modules/messages/hooks'
@@ -14,6 +12,7 @@ import { useWidgetSettingsAtom, useWidgetTabsAtom } from '../../store'
 import { GreetingsCard } from '../greetings-card'
 import { WidgetHeader } from '../header'
 import { PageLayout } from '../page-layout'
+import { QuickActionButtons } from '../quick-action-buttons'
 
 function WidgetStarterPage() {
   const { t } = useTranslation()
@@ -53,10 +52,6 @@ function WidgetStarterPage() {
     })
   }
 
-  const handleAskQuestion: MouseEventHandler<HTMLButtonElement> = (e) => {
-    sendText(e?.currentTarget?.querySelector('span[data-label=text-content]')?.textContent)
-  }
-
   const handleSend = () => {
     sendText(chatInputRef.current?.value)
   }
@@ -75,16 +70,6 @@ function WidgetStarterPage() {
     [conversationId, limit, profileId]
   )
 
-  const actionButtonStyle = useMemo(
-    () =>
-      isDarkTheme
-        ? undefined
-        : ({
-            '--gradient-btn-hover-foreground': '#0d0d0d'
-          } as CSSProperties),
-    [isDarkTheme]
-  )
-
   useEffect(() => {
     if (!conversationId || !profileId) return
 
@@ -113,30 +98,16 @@ function WidgetStarterPage() {
             <GreetingsCard
               author={settings?.user?.name?.split(' ')?.[0]}
               tutorName={name}
-              isDarkTheme={settings?.config?.theme === 'dark'}
+              isDarkTheme={isDarkTheme}
             />
           </div>
         </div>
-        <HorizontalDraggableScroll 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'>
-          <Button
-            variant='gradient-outline'
-            style={actionButtonStyle}
-            className='ml-5 shrink-0 text-sm'
-            onClick={handleAskQuestion}
-            loading={!isSparkieReady}>
-            <span>🤖 </span>
-            {t('starter_page.what_does_tutor_do')}
-          </Button>
-          <Button
-            variant='gradient-outline'
-            style={actionButtonStyle}
-            className='mr-5 shrink-0 text-sm'
-            onClick={handleAskQuestion}
-            loading={!isSparkieReady}>
-            <span>📝 </span>
-            {t('starter_page.test_me')}
-          </Button>
-        </HorizontalDraggableScroll>
+        <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}
+          send={sendText}
+          loading={!isSparkieReady}
+        />
       </div>
     </PageLayout>
   )

package/src/modules/widget/hooks/use-init-widget/use-init-widget.tsx

@@ -15,7 +15,11 @@ const init = async (settings: WidgetSettingProps) => {
       membershipId: settings.membershipId ?? '',
       membershipSlug: settings.membershipSlug ?? '',
       sessionId: settings.sessionId,
-      userId: Number(settings.userId)
+      userId: Number(settings.userId),
+      product: {
+        id: Number(settings.productId) || 0,
+        category: settings.productType ?? ''
+      }
     })
     TutorWidgetEvents['tutor-app-widget-loaded'].dispatch()
   } catch (error) {

package/src/types.ts

@@ -51,6 +51,14 @@ export type WidgetSettingProps = {
   classType?: ClassTypes
   config?: {
     theme?: Theme
+    metadata?: {
+      parent?: 'AGENT' | 'TUTOR'
+      agentProductId?: number
+      agentName?: string
+      courseName?: string
+      source?: string
+      promptId?: string
+    }
   }
 }