app-tutor-ai-consumer 1.21.2 → 1.22.0

package/CHANGELOG.md

@@ -1,3 +1,10 @@
+# [1.22.0](https://github.com/Hotmart-Org/app-tutor-ai-consumer/compare/v1.21.2...v1.22.0) (2025-08-04)
+
+### Features
+
+- add button default ([e10c478](https://github.com/Hotmart-Org/app-tutor-ai-consumer/commit/e10c47844c68815df58a942250fef1fcd1d0f676))
+- add useInitSparkie ([f3dd5f9](https://github.com/Hotmart-Org/app-tutor-ai-consumer/commit/f3dd5f9d9542f755126e4fcc2af8e8a500703753))
+
 ## [1.21.2](https://github.com/Hotmart-Org/app-tutor-ai-consumer/compare/v1.21.1...v1.21.2) (2025-08-01)
 
 ## [1.21.1](https://github.com/Hotmart-Org/app-tutor-ai-consumer/compare/v1.21.0...v1.21.1) (2025-07-31)

package/config/vitest/__mocks__/animation-avatar.tsx

@@ -0,0 +1,3 @@
+vi.mock('@/src/modules/widget/components/avatar-animation', () => ({
+  AvatarAnimation: vi.fn(() => <div data-test='avatar-animation-icon'>AvatarAnimation</div>)
+}))

package/config/vitest/vitest.config.mts

@@ -13,6 +13,7 @@ export default defineConfig({
       './config/vitest/__mocks__/i18n.tsx',
       './config/vitest/__mocks__/sparkie.tsx',
       './config/vitest/__mocks__/icons.tsx',
+      './config/vitest/__mocks__/animation-avatar.tsx',
       './config/vitest/__mocks__/intersection-observer.ts',
       './config/vitest/polyfills/global.js'
     ],

package/package.json

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

package/src/config/styles/index.css

@@ -3,3 +3,29 @@
 @tailwind base;
 @tailwind components;
 @tailwind utilities;
+
+@layer components {
+  .shine-box {
+    background-color: var(--shb-bg-color, var(--hc-color-neutral-200));
+    background-size: 200% 100%;
+    background-image: linear-gradient(
+      90deg,
+      transparent 0%,
+      rgb(from var(--shb-shine-color, var(--hc-color-neutral-900)) r g b / 0.3) 50%,
+      transparent 100%
+    );
+    animation-name: slideShine;
+    animation-duration: 1s;
+    animation-timing-function: cubic-bezier(0.5, -0.5, 1, 1.5);
+    animation-iteration-count: infinite;
+  }
+
+  @keyframes slideShine {
+    0% {
+      background-position: 100% 0;
+    }
+    100% {
+      background-position: -100% 0;
+    }
+  }
+}

package/src/lib/components/button/button-default.tsx

@@ -0,0 +1,35 @@
+import clsx from 'clsx'
+import type { ButtonHTMLAttributes, PropsWithChildren } from 'react'
+
+export type ButtonDefaultProps = PropsWithChildren<
+  ButtonHTMLAttributes<HTMLButtonElement> & {
+    show?: boolean
+    loading?: boolean
+  }
+>
+
+function ButtonDefault({
+  loading,
+  className,
+  children,
+  show = true,
+  ...props
+}: ButtonDefaultProps) {
+  if (!show) return null
+
+  return (
+    <button
+      {...props}
+      className={clsx(
+        'rounded text-base font-medium outline-none focus-visible:ring-2 focus-visible:ring-blue-500',
+        className
+      )}
+      type={props.type ?? 'button'}
+      disabled={props.disabled || loading}
+      aria-busy={loading}>
+      {children}
+    </button>
+  )
+}
+
+export default ButtonDefault

package/src/lib/components/button/button.tsx

@@ -1,8 +1,11 @@
 import clsx from 'clsx'
-import type { ButtonHTMLAttributes, PropsWithChildren } from 'react'
+import type { PropsWithChildren } from 'react'
 
 import { Spinner } from '../spinner'
 
+import type { ButtonDefaultProps } from './button-default'
+import ButtonDefault from './button-default'
+
 import styles from './styles.module.css'
 
 function ButtonContent({
@@ -25,13 +28,9 @@ function ButtonContent({
   )
 }
 
-export type ButtonProps = PropsWithChildren<
-  ButtonHTMLAttributes<HTMLButtonElement> & {
-    variant?: 'brand' | 'secondary' | 'primary' | 'tertiary' | 'gradient-outline'
-    show?: boolean
-    loading?: boolean
-  }
->
+export type ButtonProps = ButtonDefaultProps & {
+  variant?: 'brand' | 'secondary' | 'primary' | 'tertiary' | 'gradient-outline'
+}
 
 function Button({
   children,
@@ -53,35 +52,28 @@ function Button({
   switch (variant) {
     case 'gradient-outline':
       return (
-        <button
-          className={clsx(
-            gridClasses,
-            defaultClasses,
-            'group relative inline-flex items-center justify-center overflow-hidden rounded-lg bg-gradient-to-br from-[var(--ai-color-gradient-primary)] to-[var(--ai-color-gradient-accent)] p-[1px] hover:text-neutral-1000 group-hover:from-[var(--ai-color-gradient-primary)] group-hover:to-[var(--ai-color-gradient-accent)]',
-            className
-          )}
+        <ButtonDefault
           {...props}
-          disabled={props.disabled || loading}
-          aria-busy={loading}>
+          loading={loading}
+          show={show}
+          className={clsx(
+            className,
+            'group relative inline-flex items-center justify-center overflow-hidden rounded-lg p-[1px]',
+            {
+              'bg-gradient-to-br from-[var(--ai-color-gradient-primary)] to-[var(--ai-color-gradient-accent)] hover:text-neutral-1000 group-hover:from-[var(--ai-color-gradient-primary)] group-hover:to-[var(--ai-color-gradient-accent)]':
+                !loading,
+              'shine-box cursor-not-allowed': loading
+            }
+          )}>
           <span
             data-label='text-content'
             className={clsx(
-              'relative flex-1 rounded-lg bg-neutral-100 px-5 py-2.5 text-neutral-1000 transition-all duration-75 ease-in group-hover:bg-transparent',
-              'flex flex-nowrap gap-2 [grid-area:stack]',
-              {
-                visible: !loading,
-                invisible: loading
-              }
+              'flex-1 rounded-lg bg-neutral-100 px-5 py-2.5 text-neutral-1000 transition-all duration-75 ease-in group-hover:bg-transparent',
+              'flex flex-nowrap'
             )}>
-            {children}
+            <span className={clsx({ 'opacity-20': loading })}>{children}</span>
           </span>
-          <Spinner
-            className={clsx('mx-auto my-auto h-[1em] w-[1em] text-current', '[grid-area:stack]', {
-              visible: loading,
-              invisible: !loading
-            })}
-          />
-        </button>
+        </ButtonDefault>
       )
     case 'primary':
       return (
@@ -152,7 +144,6 @@ function Button({
       return (
         <button
           className={clsx(
-            gridClasses,
             'rounded-full outline-none transition-colors duration-300 ease-in',
             {
               'cursor-pointer ring-primary-500 hover:bg-neutral-300 focus:bg-neutral-300 focus-visible:ring-2':

package/src/main/main.tsx

@@ -12,14 +12,14 @@ export type MainProps = {
 }
 
 function Main({ settings }: MainProps) {
-  const { completeSetup } = useInitWidget(settings)
+  useInitWidget(settings)
   useAppLang(settings.locale)
   useListenToThemeChangeEvent()
 
   return (
     <ErrorBoundary fallback={<GenericError />}>
       <GlobalProviders settings={settings}>
-        <WidgetContainer completeSetup={completeSetup} />
+        <WidgetContainer />
       </GlobalProviders>
     </ErrorBoundary>
   )

package/src/modules/messages/constants.ts

@@ -3,5 +3,7 @@ export const MSG_MAX_PAGES = 20
 
 export const MessagesEndpoints = {
   getAll: (conversationId: string) =>
+    `${process.env.API_CONVERSATION_URL}/v1/conversations/${conversationId}/messages`,
+  create: (conversationId: string) =>
     `${process.env.API_CONVERSATION_URL}/v1/conversations/${conversationId}/messages`
 }

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

@@ -1,7 +1,7 @@
 import { UAParser } from 'ua-parser-js'
 
 import { act, chance, renderHook, waitFor } from '@/src/config/tests'
-import { MessagesService } from '@/src/modules/messages'
+import { DirectMessagesService as MessagesService } from '@/src/modules/messages'
 import { useGetProfile } from '@/src/modules/profile'
 import * as Store from '@/src/modules/widget'
 import WidgetSettingPropsBuilder from '@/src/modules/widget/__tests__/widget-settings-props.builder'
@@ -57,40 +57,42 @@ describe('useSendTextMessage', () => {
     const txt = 'question::summary'
     const text = txt.replace('question::', '')
 
-    vi.spyOn(MessagesService, 'sendTextMessage')
+    vi.spyOn(MessagesService, 'create')
 
     const { result } = render()
 
     await waitFor(() => result.current.mutateAsync(txt))
 
-    expect(MessagesService.sendTextMessage).toHaveBeenCalledTimes(1)
-    expect(MessagesService.sendTextMessage).toHaveBeenNthCalledWith(1, {
-      content: {
-        type: 'text/plain',
-        text
-      },
+    expect(MessagesService.create).toHaveBeenCalledTimes(1)
+    expect(MessagesService.create).toHaveBeenNthCalledWith(1, {
       conversationId: defaultSettings.conversationId,
-      metadata: {
-        author: 'user',
-        contactId: defaultSettings.contactId,
-        context: {
-          language: defaultSettings.locale,
-          clubName: defaultSettings.clubName,
-          productName: defaultSettings.productName,
-          productId: defaultSettings.productId,
-          classHashId: defaultSettings.classHashId,
-          owner_id: defaultSettings.owner_id,
-          current_media_codes: defaultSettings.current_media_codes,
-          question: text,
-          router: text,
-          osVersion: UAParserMock.browser.version,
-          platformDetail: UAParserMock.browser.name,
-          ucode: defaultSettings.user?.ucode
+      message: {
+        content: {
+          type: 'text/plain',
+          text
         },
-        externalId: expect.any(String),
-        namespace: defaultSettings.namespace,
-        sessionId: defaultSettings.sessionId,
-        userId: String(getProfileMock.data.userId)
+        metadata: {
+          author: 'user',
+          contactId: defaultSettings.contactId,
+          context: {
+            language: defaultSettings.locale,
+            clubName: defaultSettings.clubName,
+            productName: defaultSettings.productName,
+            productId: defaultSettings.productId,
+            classHashId: defaultSettings.classHashId,
+            owner_id: defaultSettings.owner_id,
+            current_media_codes: defaultSettings.current_media_codes,
+            question: text,
+            router: text,
+            osVersion: UAParserMock.browser.version,
+            platformDetail: UAParserMock.browser.name,
+            ucode: defaultSettings.user?.ucode
+          },
+          externalId: expect.any(String),
+          namespace: defaultSettings.namespace,
+          sessionId: defaultSettings.sessionId,
+          userId: String(getProfileMock.data.userId)
+        }
       }
     })
   })

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

@@ -3,7 +3,7 @@ import { useMutation, useQueryClient } from '@tanstack/react-query'
 import { UAParser } from 'ua-parser-js'
 import { v4 } from 'uuid'
 
-import { MessagesService } from '@/src/modules/messages'
+import { DirectMessagesService as MessagesService } from '@/src/modules/messages'
 import { useGetProfile } from '@/src/modules/profile'
 import { useWidgetLoadingAtom, useWidgetSettingsAtomValue } from '@/src/modules/widget'
 import { MessagesEvents } from '../../events'
@@ -47,35 +47,37 @@ function useSendTextMessage() {
         questionParam = processedMessage
       }
 
-      return MessagesService.sendTextMessage({
-        content: {
-          type: 'text/plain',
-          text: processedMessage
-        },
+      return MessagesService.create({
         conversationId: settings?.conversationId,
-        metadata: {
-          author: 'user',
-          contactId: settings.contactId,
-          context: {
-            language: settings.locale,
-            clubName: settings.clubName,
-            productName: settings.productName,
-            productId: settings.productId,
-            productType: settings.productType,
-            classType: settings.classType,
-            classHashId: settings.classHashId,
-            owner_id: settings?.owner_id,
-            current_media_codes: settings?.current_media_codes,
-            question: questionParam,
-            router: questionParam ? 'summary' : undefined,
-            osVersion: browserInfo.version,
-            platformDetail: browserInfo.name,
-            ucode: settings.user?.ucode
+        message: {
+          content: {
+            type: 'text/plain',
+            text: processedMessage
           },
-          externalId: v4(),
-          namespace: settings.namespace,
-          sessionId: settings.sessionId,
-          userId
+          metadata: {
+            author: 'user',
+            contactId: settings.contactId,
+            context: {
+              language: settings.locale,
+              clubName: settings.clubName,
+              productName: settings.productName,
+              productId: settings.productId,
+              productType: settings.productType,
+              classType: settings.classType,
+              classHashId: settings.classHashId,
+              owner_id: settings?.owner_id,
+              current_media_codes: settings?.current_media_codes,
+              question: questionParam,
+              router: questionParam ? 'summary' : undefined,
+              osVersion: browserInfo.version,
+              platformDetail: browserInfo.name,
+              ucode: settings.user?.ucode
+            },
+            externalId: v4(),
+            namespace: settings.namespace,
+            sessionId: settings.sessionId,
+            userId
+          }
         }
       })
     },

package/src/modules/messages/index.ts

@@ -1,3 +1,4 @@
 export * from './constants'
 export { default as MessagesService } from './service'
+export { default as DirectMessagesService } from './service.direct'
 export * from './types'

package/src/modules/messages/service.direct.ts

@@ -0,0 +1,41 @@
+import type { Message } from '@hotmart/sparkie/dist/MessageService'
+
+import { api } from '@/src/config/request'
+
+import { MessagesEndpoints } from './constants'
+import type {
+  DirectMessagesServiceProps,
+  FetchMessagesResponse,
+  IMessageWithSenderData
+} from './types'
+
+class DirectMessagesService {
+  async getAll({ conversationId, before, limit }: DirectMessagesServiceProps['GetAll']) {
+    const { data: messages } = await api.get<IMessageWithSenderData[]>(
+      MessagesEndpoints.getAll(conversationId),
+      {
+        params: {
+          before,
+          limit
+        }
+      }
+    )
+
+    return {
+      messages,
+      hasMore: messages.length === limit
+    } as FetchMessagesResponse
+  }
+
+  async create({ conversationId, message }: DirectMessagesServiceProps['Create']) {
+    const { data } = await api.post<Message>(MessagesEndpoints.create(conversationId), {
+      ...message,
+      type: 'message',
+      channel: 'chat'
+    })
+
+    return data
+  }
+}
+
+export default new DirectMessagesService()

package/src/modules/messages/types.ts

@@ -1,4 +1,8 @@
-import type { Message as SparkieMsg, SenderData } from '@hotmart/sparkie/dist/MessageService'
+import type {
+  Message as SparkieMsg,
+  MessageContent,
+  SenderData
+} from '@hotmart/sparkie/dist/MessageService'
 
 export type IMessage = SparkieMsg & {
   metadata: {
@@ -80,3 +84,20 @@ export type FetchMessagesResponse = {
 export type SubmitQuestionEventDetail = {
   timestamp: number
 }
+
+export type DirectMessagesServiceProps = {
+  GetAll: {
+    conversationId: string
+    before: number
+    limit: number
+  }
+  Create: {
+    conversationId: string
+    message: {
+      content: MessageContent
+      threadId?: string
+      parentId?: string
+      metadata?: Record<string, unknown>
+    }
+  }
+}

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

@@ -0,0 +1 @@
+export * from './use-init-sparkie'

package/src/modules/sparkie/hooks/use-init-sparkie/index.ts

@@ -0,0 +1,2 @@
+export * from './use-init-sparkie'
+export { default as useInitSparkie } from './use-init-sparkie'

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

@@ -0,0 +1,39 @@
+import { useCallback, useEffect, useState } from 'react'
+
+import { useWidgetSettingsAtomValue } from '@/src/modules/widget'
+import { SparkieService } from '../..'
+
+function useInitSparkie() {
+  const [isSuccess, setIsSuccess] = useState(false)
+  const settings = useWidgetSettingsAtomValue()
+
+  const init = useCallback(async () => {
+    if (!settings?.hotmartToken) return
+
+    try {
+      await SparkieService.initSparkie({
+        token: settings?.hotmartToken,
+        skipPresenceSetup: true,
+        retryOptions: {
+          maxRetries: 5,
+          retryDelay: 2000,
+          backoffMultiplier: 1.5
+        }
+      })
+      await SparkieService.ensureInitialized()
+      setIsSuccess(true)
+    } catch {
+      setIsSuccess(false)
+      // TODO: Create Error PAGE and setTab
+      // setTab('information')
+    }
+  }, [settings?.hotmartToken])
+
+  useEffect(() => {
+    void init()
+  }, [init])
+
+  return isSuccess
+}
+
+export default useInitSparkie

package/src/modules/widget/components/container/container.tsx

@@ -1,24 +1,16 @@
-import { useEffect } from 'react'
-
 import { useSubscribeMessageReceivedEvent } from '@/src/modules/messages/hooks'
 import { useSubscribeThreadClosedEvent } from '@/src/modules/thread/hooks'
 import { useListenToVisibilityEvents } from '../../hooks'
 import { useWidgetTabsAtom } from '../../store'
 import { WIDGET_TABS } from '../constants'
 
-function WidgetContainer({ completeSetup = false }: { completeSetup?: boolean }) {
-  const [widgetTabs, setTab] = useWidgetTabsAtom()
+function WidgetContainer() {
+  const [widgetTabs] = useWidgetTabsAtom()
 
   useSubscribeMessageReceivedEvent()
   useSubscribeThreadClosedEvent()
   useListenToVisibilityEvents()
 
-  useEffect(() => {
-    if (completeSetup) {
-      setTab('starter')
-    }
-  }, [completeSetup, setTab])
-
   return (
     <div className='flex h-full flex-col items-center justify-stretch overflow-hidden'>
       {WIDGET_TABS[widgetTabs.currentTab]}

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

@@ -8,6 +8,10 @@ vi.mock('@/src/modules/messages/hooks', () => ({
   useSendTextMessage: vi.fn()
 }))
 
+vi.mock('@/src/modules/sparkie/hooks/use-init-sparkie', () => ({
+  useInitSparkie: vi.fn(() => true)
+}))
+
 describe('WidgetStarterPage', () => {
   const useSendTextMessageMock = { mutate: vi.fn() }
 

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

@@ -5,11 +5,13 @@ import type { MouseEventHandler } from 'react'
 import { useTranslation } from 'react-i18next'
 
 import { Button, HorizontalDraggableScroll } from '@/src/lib/components'
+import type { ValidIconNames } from '@/src/lib/components/icons/icon-names'
 import { useRefEventListener } from '@/src/lib/hooks'
 import { ChatInput, useChatInputValueAtom } from '@/src/modules/messages/components'
 import { getAllMessagesQuery, useSendTextMessage } from '@/src/modules/messages/hooks'
 import { useMessagesMaxCount } from '@/src/modules/messages/store'
 import { useGetProfile } from '@/src/modules/profile'
+import { useInitSparkie } from '@/src/modules/sparkie/hooks/use-init-sparkie'
 import { useWidgetSettingsAtom, useWidgetTabsAtom } from '../../store'
 import { GreetingsCard } from '../greetings-card'
 import { WidgetHeader } from '../header'
@@ -28,6 +30,7 @@ function WidgetStarterPage() {
   const limit = useMessagesMaxCount()
   const queryClient = useQueryClient()
   const name = settings?.tutorName ?? t('general.name')
+  const isSparkieReady = useInitSparkie()
 
   useRefEventListener<HTMLTextAreaElement>({
     config: {
@@ -74,9 +77,19 @@ function WidgetStarterPage() {
     [conversationId, limit, profileId]
   )
 
+  const headerBtns = useMemo(() => {
+    const btnList = ['info', 'close']
+
+    if (!isSparkieReady) return btnList
+
+    return btnList.concat(['archive'])
+  }, [isSparkieReady]) as ValidIconNames[]
+
   useEffect(() => {
+    if (!conversationId || !profileId) return
+
     void queryClient.prefetchInfiniteQuery(messagesQueryConfig)
-  }, [messagesQueryConfig, queryClient])
+  }, [conversationId, messagesQueryConfig, profileId, queryClient])
 
   return (
     <PageLayout
@@ -85,7 +98,7 @@ function WidgetStarterPage() {
           name='new-chat-msg-input'
           ref={chatInputRef}
           onSend={handleSend}
-          buttonDisabled={!chatInputValue.trim()}
+          buttonDisabled={!chatInputValue.trim() || !isSparkieReady}
         />
       }>
       <div className='grid-areas-[a_b] grid h-full grid-cols-1 grid-rows-[1fr_auto]'>
@@ -93,7 +106,7 @@ function WidgetStarterPage() {
           className={clsx('grid-area-[a] flex min-h-0 flex-col max-md:p-[1.125rem] md:p-5', {
             [styles.bg]: settings?.config?.theme === 'dark'
           })}>
-          <WidgetHeader enabledButtons={['archive', 'info', 'close']} tutorName={name} />
+          <WidgetHeader enabledButtons={headerBtns} tutorName={name} />
 
           <div className='my-auto'>
             <GreetingsCard
@@ -107,14 +120,16 @@ function WidgetStarterPage() {
           <Button
             variant='gradient-outline'
             className='shrink-0 snap-end text-sm'
-            onClick={handleAskQuestion}>
+            onClick={handleAskQuestion}
+            loading={!isSparkieReady}>
             <span>🤖 </span>
             {t('starter_page.what_does_tutor_do')}
           </Button>
           <Button
             variant='gradient-outline'
             className='shrink-0 snap-end text-sm'
-            onClick={handleAskQuestion}>
+            onClick={handleAskQuestion}
+            loading={!isSparkieReady}>
             <span>📝 </span>
             {t('starter_page.wanna_summary')}
           </Button>

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

@@ -3,7 +3,6 @@ import { useEffect, useState } from 'react'
 import { DataHubStore } from '@/src/config/datahub'
 import { initDayjs } from '@/src/config/dayjs'
 import { initAxios } from '@/src/config/request/api'
-import { SparkieService } from '@/src/modules/sparkie'
 import type { WidgetSettingProps } from '@/src/types'
 import { TutorWidgetEvents } from '../../events'
 
@@ -18,16 +17,6 @@ const init = async (settings: WidgetSettingProps) => {
       sessionId: settings.sessionId,
       userId: Number(settings.userId)
     })
-    await SparkieService.initSparkie({
-      token: settings?.hotmartToken,
-      skipPresenceSetup: true,
-      retryOptions: {
-        maxRetries: 5,
-        retryDelay: 2000,
-        backoffMultiplier: 1.5
-      }
-    })
-    await SparkieService.ensureInitialized()
     TutorWidgetEvents['tutor-app-widget-loaded'].dispatch()
   } catch (error) {
     console.error(error)

package/src/modules/widget/store/widget-tabs.atom.ts

@@ -8,8 +8,8 @@ export type WidgetTabsProps = {
 }
 
 const INITIAL_PROPS: WidgetTabsProps = {
-  currentTab: 'loading',
-  history: new Set(['loading'])
+  currentTab: 'starter',
+  history: new Set(['starter'])
 }
 
 export const widgetTabsAtom = atom<WidgetTabsProps>(INITIAL_PROPS)