goobs-frontend 0.8.4 → 0.8.6

package/package.json

@@ -1,6 +1,7 @@
 {
   "name": "goobs-frontend",
-  "version": "0.8.4",
+  "version": "0.8.6",
+  "type": "module",
   "description": "A comprehensive React-based UI library built on Material-UI, offering a wide range of customizable components including grids, typography, buttons, cards, forms, navigation, pricing tables, steppers, tooltips, accordions, and more. Designed for building responsive and consistent user interfaces with advanced features like form validation, theming, and code syntax highlighting.",
   "license": "MIT",
   "main": "./src/index.ts",
@@ -21,31 +22,32 @@
     "@emotion/cache": "^11.13.1",
     "@emotion/react": "^11.13.3",
     "@emotion/styled": "^11.13.0",
-    "@mui/icons-material": "^6.1.1",
-    "@mui/material": "^6.1.1",
-    "@types/lodash": "^4.17.9",
+    "@mui/icons-material": "^6.1.4",
+    "@mui/material": "^6.1.4",
+    "@types/lodash": "^4.17.12",
     "highlight.js": "^11.10.0",
-    "jotai": "^2.10.0",
+    "jotai": "^2.10.1",
     "lodash": "^4.17.21",
-    "next": "14.2.13",
-    "react-datepicker": "^7.4.0",
+    "next": "15.0.0",
+    "otplib": "^12.0.1",
+    "react-datepicker": "^7.5.0",
     "react-qr-code": "^2.0.15"
   },
   "devDependencies": {
-    "@next/eslint-plugin-next": "^14.2.13",
-    "@types/node": "^22.7.3",
-    "@types/react": "18.3.9",
-    "@types/react-dom": "^18.3.0",
-    "@typescript-eslint/eslint-plugin": "^8.7.0",
-    "@typescript-eslint/parser": "^8.7.0",
-    "eslint": "^9.11.1",
-    "eslint-config-next": "^14.2.13",
+    "@next/eslint-plugin-next": "^15.0.0",
+    "@types/node": "^22.7.8",
+    "@types/react": "18.3.11",
+    "@types/react-dom": "^18.3.1",
+    "@typescript-eslint/eslint-plugin": "^8.11.0",
+    "@typescript-eslint/parser": "^8.11.0",
+    "eslint": "^9.13.0",
+    "eslint-config-next": "^15.0.0",
     "eslint-config-prettier": "^9.1.0",
     "eslint-plugin-prettier": "^5.2.1",
     "prettier": "^3.3.3",
     "react": "^18.3.1",
     "react-dom": "^18.3.1",
-    "typescript": "^5.6.2"
+    "typescript": "^5.6.3"
   },
   "files": [
     "src"

package/src/components/Button/index.tsx

@@ -19,7 +19,6 @@ export interface CustomButtonProps extends ButtonProps {
 
 const CustomButton: React.FC<CustomButtonProps> = React.memo(
   props => {
-    console.log('[trace-button] CustomButton: Rendering component', { props })
     const {
       text,
       variant,
@@ -40,7 +39,6 @@ const CustomButton: React.FC<CustomButtonProps> = React.memo(
     const handleButtonClick = (
       event: React.MouseEvent<HTMLButtonElement>
     ): void => {
-      console.log('[trace-button] CustomButton: Button clicked')
       event.preventDefault()
       onClick?.(event)
     }
@@ -63,13 +61,6 @@ const CustomButton: React.FC<CustomButtonProps> = React.memo(
         })
       : null
 
-    console.log('[trace-button] CustomButton: Rendering button', {
-      variant,
-      style: buttonStyle,
-      disableButton,
-      isDisabled,
-    })
-
     const buttonContent = (
       <>
         {iconlocation === 'above' && IconComponent}
@@ -140,15 +131,9 @@ const CustomButton: React.FC<CustomButtonProps> = React.memo(
       prevProps.iconlocation === nextProps.iconlocation &&
       prevProps.fontlocation === nextProps.fontlocation
 
-    console.log('[trace-button] CustomButton: Props comparison', {
-      propsAreEqual,
-      prevProps: Object.keys(prevProps),
-      nextProps: Object.keys(nextProps),
-    })
     return propsAreEqual
   }
 )
 
 CustomButton.displayName = 'CustomButton'
-console.log('[trace-button] CustomButton: Component defined')
 export default CustomButton

package/src/components/Card/variants/product/index.tsx

@@ -1,3 +1,5 @@
+'use client'
+
 import React, { useState } from 'react'
 import { Box, Paper, BoxProps } from '@mui/material'
 import Typography from '../../../../components/Typography'

package/src/components/Card/variants/productsummary/index.tsx

@@ -1,3 +1,5 @@
+'use client'
+
 import React, { useState } from 'react'
 import { Box, Paper, Switch } from '@mui/material'
 import { CardProps } from '../../index'

package/src/components/CodeCopy/index.tsx

@@ -1,3 +1,5 @@
+'use client'
+
 import React, { useRef, useEffect } from 'react'
 import { Box } from '@mui/material'
 import CustomButton from '../../components/Button'

package/src/components/Content/Structure/qrcode/useQRCode.tsx

@@ -6,7 +6,7 @@ type ExtendedColumnConfig = Omit<columnconfig, 'component'> & {
   component?: columnconfig['component']
 }
 
-export interface ExtendedQRCodeProps extends Omit<QRCodeProps, 'sx'> {
+export interface ExtendedQRCodeProps extends QRCodeProps {
   columnconfig?: ExtendedColumnConfig
   cellconfig?: cellconfig
 }
@@ -21,9 +21,11 @@ const useQRCode = (grid: {
     index: number
   ): columnconfig => {
     const {
-      value,
+      username,
+      appName,
       size,
       title,
+      onSecretGenerated,
       columnconfig: itemColumnConfig,
       cellconfig,
       ...restProps
@@ -48,9 +50,11 @@ const useQRCode = (grid: {
       component: (
         <QRCodeComponent
           key={`qrcode-${index}`}
-          value={value}
+          username={username}
+          appName={appName}
           size={size}
           title={title}
+          onSecretGenerated={onSecretGenerated}
           {...restProps}
         />
       ),

package/src/components/Dropdown/index.tsx

@@ -1,4 +1,6 @@
-import React, { useState } from 'react'
+'use client'
+
+import React, { useState, useEffect } from 'react'
 import {
   Select,
   MenuItem,
@@ -6,9 +8,12 @@ import {
   InputLabel,
   SelectProps,
   FormHelperText,
-  Typography,
+  Box,
+  CircularProgress,
 } from '@mui/material'
 import { styled } from '@mui/material/styles'
+import { black, white } from '../../styles/palette'
+import Typography from '../Typography'
 
 export interface SimpleDropdownOption {
   value: string
@@ -38,37 +43,62 @@ export interface DropdownProps extends Omit<SelectProps, 'onChange'> {
   onFocus?: SelectProps['onFocus']
 }
 
+const StyledBox = styled(Box)(() => ({
+  position: 'relative',
+  width: '100%',
+  height: '50px',
+  marginTop: '5px',
+}))
+
 const StyledFormControl = styled(FormControl)<{
   backgroundcolor?: string
   outlinecolor?: string
-}>(({ theme, backgroundcolor, outlinecolor }) => ({
-  width: '100%',
+}>(({ outlinecolor }) => ({
+  position: 'absolute',
+  top: 0,
+  left: 0,
+  right: 0,
+  bottom: 0,
   '& .MuiOutlinedInput-root': {
-    backgroundColor: backgroundcolor || theme.palette.background.paper,
+    backgroundColor: white.main,
+    height: '45px',
     '& fieldset': {
-      borderColor: outlinecolor || theme.palette.primary.main,
+      borderColor: outlinecolor || black.main,
     },
     '&:hover fieldset': {
-      borderColor: outlinecolor || theme.palette.primary.main,
+      borderColor: outlinecolor || black.main,
     },
     '&.Mui-focused fieldset': {
-      borderColor: outlinecolor || theme.palette.primary.main,
+      borderColor: outlinecolor || black.main,
     },
   },
 }))
 
 const StyledInputLabel = styled(InputLabel)<{ shrunkfontcolor?: string }>(
-  ({ theme, shrunkfontcolor }) => ({
+  () => ({
+    color: black.main,
     '&.Mui-focused': {
-      color: shrunkfontcolor || theme.palette.primary.main,
+      color: black.main,
+    },
+    '&.MuiInputLabel-shrink': {
+      transform: 'translate(13px, -7px) scale(0.75)',
+      color: black.main,
     },
   })
 )
 
-const StyledMenuItem = styled(MenuItem)(({ theme }) => ({
+const StyledMenuItem = styled(MenuItem)(() => ({
   display: 'flex',
   flexDirection: 'column',
   alignItems: 'flex-start',
+  backgroundColor: white.main,
+}))
+
+const LoadingContainer = styled(Box)(() => ({
+  display: 'flex',
+  justifyContent: 'center',
+  alignItems: 'center',
+  height: '50px',
 }))
 
 const capitalizeFirstLetter = (string: string) => {
@@ -92,23 +122,33 @@ const Dropdown: React.FC<DropdownProps> = ({
   onFocus,
   ...rest
 }) => {
-  const [selectedValue, setSelectedValue] = useState(() => {
+  const [selectedValue, setSelectedValue] = useState<string>('')
+  const [isLoading, setIsLoading] = useState(true)
+
+  useEffect(() => {
     const defaultOption = options.find(option => option.value === defaultValue)
-    return defaultOption ? defaultOption.value : ''
-  })
+    setSelectedValue(defaultOption ? defaultOption.value : '')
+    setIsLoading(false)
+  }, [defaultValue, options])
 
   const handleChange: SelectProps['onChange'] = (event, child) => {
     const newValue = event.target.value as string
     setSelectedValue(newValue)
-    onChange?.(event, child)
+    if (onChange) {
+      onChange(event, child)
+    }
   }
 
   const handleBlur: SelectProps['onBlur'] = event => {
-    onBlur?.(event)
+    if (onBlur) {
+      onBlur(event)
+    }
   }
 
   const handleFocus: SelectProps['onFocus'] = event => {
-    onFocus?.(event)
+    if (onFocus) {
+      onFocus(event)
+    }
   }
 
   const renderMenuItem = (option: DropdownOption) => {
@@ -116,48 +156,107 @@ const Dropdown: React.FC<DropdownProps> = ({
     if (!('attribute1' in option)) {
       return (
         <MenuItem key={option.value} value={option.value}>
-          {label}
+          <Typography fontvariant="merriparagraph" text={label} />
         </MenuItem>
       )
     } else {
       return (
         <StyledMenuItem key={option.value} value={option.value}>
-          <Typography variant="body1">{label}</Typography>
-          <Typography variant="caption" color="textSecondary">
-            {option.attribute1}
-            {option.attribute2 && ` | ${option.attribute2}`}
-          </Typography>
+          <Typography fontvariant="merriparagraph" text={label} />
+          <Typography
+            fontvariant="merriparagraph"
+            text={`${option.attribute1}${option.attribute2 ? ` | ${option.attribute2}` : ''}`}
+            fontcolor="textSecondary"
+          />
         </StyledMenuItem>
       )
     }
   }
 
+  if (isLoading) {
+    return (
+      <LoadingContainer>
+        <CircularProgress size={24} />
+      </LoadingContainer>
+    )
+  }
+
   return (
-    <StyledFormControl
-      backgroundcolor={backgroundcolor}
-      outlinecolor={outlinecolor}
-      error={error}
-      required={required}
-    >
-      <StyledInputLabel id={`${name}-label`} shrunkfontcolor={shrunkfontcolor}>
-        {label}
-      </StyledInputLabel>
-      <Select
-        labelId={`${name}-label`}
-        value={selectedValue}
-        onChange={handleChange}
-        onBlur={handleBlur}
-        onFocus={handleFocus}
-        label={label}
-        sx={{ color: fontcolor }}
-        name={name}
-        aria-labelledby={`${name}-label`}
-        {...rest}
+    <StyledBox>
+      <StyledFormControl
+        backgroundcolor={backgroundcolor}
+        outlinecolor={outlinecolor}
+        error={error}
+        required={required}
+        fullWidth
       >
-        {options.map(renderMenuItem)}
-      </Select>
-      {helperText && <FormHelperText>{helperText}</FormHelperText>}
-    </StyledFormControl>
+        <StyledInputLabel
+          id={`${name}-label`}
+          shrunkfontcolor={shrunkfontcolor}
+        >
+          {label}
+        </StyledInputLabel>
+        <Select
+          labelId={`${name}-label`}
+          value={selectedValue}
+          onChange={handleChange}
+          onBlur={handleBlur}
+          onFocus={handleFocus}
+          label={label}
+          sx={{
+            color: fontcolor || black.main,
+            height: '45px',
+            backgroundColor: white.main,
+            '& .MuiSelect-select': {
+              paddingTop: '10px',
+              paddingBottom: '10px',
+            },
+            '& .MuiSvgIcon-root': {
+              color: black.main,
+            },
+            '& .MuiOutlinedInput-notchedOutline': {
+              borderColor: black.main,
+            },
+            '&:hover .MuiOutlinedInput-notchedOutline': {
+              borderColor: black.main,
+            },
+            '&.Mui-focused .MuiOutlinedInput-notchedOutline': {
+              borderColor: black.main,
+            },
+            '& .MuiInputBase-input': {
+              color: black.main,
+            },
+            '& .MuiInputBase-input::placeholder': {
+              color: black.main,
+              opacity: 1,
+            },
+            '& .MuiPaper-root': {
+              backgroundColor: white.main,
+            },
+            '& .MuiMenu-list': {
+              backgroundColor: white.main,
+            },
+          }}
+          MenuProps={{
+            PaperProps: {
+              sx: {
+                backgroundColor: white.main,
+              },
+            },
+          }}
+          name={name}
+          aria-labelledby={`${name}-label`}
+          {...rest}
+        >
+          {options.map(renderMenuItem)}
+        </Select>
+        {helperText && (
+          <FormHelperText>
+            <Typography fontvariant="merriparagraph" text={helperText} />
+          </FormHelperText>
+        )}
+      </StyledFormControl>
+    </StyledBox>
   )
 }
 

package/src/components/Grid/index.tsx

@@ -247,7 +247,9 @@ const CustomGrid: React.FC<CustomGridProps> = ({
                               : '100%',
                       }}
                     >
-                      {currentColumnConfig?.component || null}
+                      {React.isValidElement(currentColumnConfig?.component)
+                        ? currentColumnConfig?.component
+                        : null}
                     </Box>
                   </Grid2>
                 )

package/src/components/Icons/FavoriteIcon.tsx

@@ -1,3 +1,5 @@
+'use client'
+
 import React, { useState } from 'react'
 import { IconButton } from '@mui/material'
 import FavoriteIcon from '@mui/icons-material/Favorite'

package/src/components/Nav/HorizontalVariant/index.tsx

@@ -2,78 +2,43 @@
 import React, { useState, useEffect } from 'react'
 import { Box, Tabs, Tab } from '@mui/material'
 import { NavProps, SubNav, View } from '../index'
+import { usePathname } from 'next/navigation'
 
-/**
- * Represents the possible alignment options for the horizontal navigation.
- */
 type Alignment = 'left' | 'center' | 'right' | 'inherit' | 'justify'
 
-/**
- * Represents the structure of an active tab value.
- */
 export interface ActiveTabValue {
-  /** The unique identifier of the active tab. */
-  tabId: string
+  tabId: string | false
 }
 
-/**
- * Props for the HorizontalVariant component.
- */
 export interface HorizontalVariantProps {
-  /** An array of navigation items, sub-navigation items, or views. */
   items: (NavProps | SubNav | View)[]
-  /** The height of the navigation bar. Defaults to '80px'. */
   height?: string
-  /** The alignment of the navigation items. Defaults to 'left'. */
   alignment?: Alignment
-  /** A unique name for this navigation component. Used for state management. */
   navname?: string
 }
 
-/**
- * HorizontalVariant component that renders a horizontal navigation bar.
- * It supports dynamic tab management, routing, and custom click handlers.
- *
- * @param {HorizontalVariantProps} props - The props for the HorizontalVariant component.
- * @returns {JSX.Element} The rendered HorizontalVariant component.
- */
 function HorizontalVariant({
   items,
   height = '80px',
   alignment = 'left',
   navname = '',
 }: HorizontalVariantProps) {
-  /**
-   * State to keep track of active tab values for different navigation components.
-   */
   const [activeTabValues, setActiveTabValues] = useState<
     Record<string, ActiveTabValue>
   >({})
+  const pathname = usePathname()
 
-  /**
-   * Effect hook to initialize the active tab values when the component mounts.
-   */
   useEffect(() => {
-    if (!activeTabValues[navname]) {
-      const firstTab = items.find(item => 'orientation' in item) as
-        | NavProps
-        | undefined
-      if (firstTab && firstTab.title) {
-        setActiveTabValues(prev => ({
-          ...prev,
-          [navname]: { tabId: firstTab.title as string },
-        }))
-      }
-    }
-  }, [items, navname, activeTabValues])
+    const currentTab = items.find(
+      item => 'orientation' in item && item.route === pathname
+    ) as NavProps | undefined
+
+    setActiveTabValues(prev => ({
+      ...prev,
+      [navname]: { tabId: currentTab?.title || false },
+    }))
+  }, [items, navname, pathname])
 
-  /**
-   * Handles tab change events.
-   * Updates the active tab values in the state.
-   *
-   * @param {React.SyntheticEvent} event - The event object.
-   * @param {string} newValue - The new value of the selected tab.
-   */
   const handleTabChange = (event: React.SyntheticEvent, newValue: string) => {
     setActiveTabValues(prev => ({
       ...prev,
@@ -81,12 +46,6 @@ function HorizontalVariant({
     }))
   }
 
-  /**
-   * Handles click events on individual tabs.
-   * Supports different trigger types: route, onClick, and routeonhorizontal.
-   *
-   * @param {NavProps} tab - The tab object that was clicked.
-   */
   const handleTabClick = (tab: NavProps) => {
     if (tab.trigger === 'route') {
       if (tab.route) {
@@ -116,7 +75,7 @@ function HorizontalVariant({
       }}
     >
       <Tabs
-        value={activeTabValues[navname]?.tabId || ''}
+        value={activeTabValues[navname]?.tabId || false}
         onChange={handleTabChange}
         aria-label="nav tabs"
         sx={{
@@ -136,8 +95,8 @@ function HorizontalVariant({
             return (
               <Tab
                 key={tab.title}
-                value={tab.title}
-                label={tab.title}
+                value={tab.title || ''}
+                label={tab.title || ''}
                 onClick={() => handleTabClick(tab)}
                 sx={{
                   minHeight: 0,

package/src/components/PricingTable/index.tsx

@@ -1,6 +1,6 @@
 'use client'
-import React, { useState, useCallback, useMemo } from 'react'
-import { Box, Paper, SelectChangeEvent } from '@mui/material'
+import React, { useState, useCallback, useMemo, useEffect } from 'react'
+import { Box, Paper, SelectChangeEvent, CircularProgress } from '@mui/material'
 import InfoIcon from '@mui/icons-material/Info'
 import CheckCircleIcon from '@mui/icons-material/CheckCircle'
 import { Typography } from '../Typography'
@@ -72,17 +72,37 @@ export interface PricingProps {
 const PricingTable: React.FC<PricingProps> = props => {
   const router = useRouter()
   const [selectedPackageIndex, setSelectedPackageIndex] = useState(0)
+  const [selectedPackage, setSelectedPackage] = useState('')
+  const [isLoading, setIsLoading] = useState(true)
 
   const config = useMemo(() => {
     return { ...defaultConfig, ...props }
   }, [props])
 
+  useEffect(() => {
+    const timer = setTimeout(() => {
+      setIsLoading(false)
+    }, 100) // Simulating a 100ms loading time
+
+    return () => clearTimeout(timer)
+  }, [])
+
+  useEffect(() => {
+    if (
+      config.packagecolumns?.packagenames &&
+      config.packagecolumns.packagenames.length > 0
+    ) {
+      setSelectedPackage(config.packagecolumns.packagenames[0])
+    }
+  }, [config.packagecolumns?.packagenames])
+
   const handlePackageChange = useCallback(
     (event: SelectChangeEvent<unknown>) => {
       const newValue = event.target.value as string
       const newIndex =
         config.packagecolumns?.packagenames?.indexOf(newValue) ?? 0
       setSelectedPackageIndex(newIndex)
+      setSelectedPackage(newValue)
       console.log('Package selection changed to:', newValue)
     },
     [config.packagecolumns?.packagenames]
@@ -116,7 +136,7 @@ const PricingTable: React.FC<PricingProps> = props => {
               value: name,
               label: name,
             }))}
-            defaultValue={config.packagecolumns.packagenames?.[0] || ''}
+            defaultValue={selectedPackage}
             backgroundcolor={semiTransparentBlack.main}
             outlinecolor={black.main}
             fontcolor={black.main}
@@ -276,10 +296,46 @@ const PricingTable: React.FC<PricingProps> = props => {
     }
 
     return { headerColumnConfigs, featureColumnConfigs }
-  }, [config, selectedPackageIndex, router, handlePackageChange])
+  }, [
+    config,
+    selectedPackageIndex,
+    selectedPackage,
+    router,
+    handlePackageChange,
+  ])
 
   const { headerColumnConfigs, featureColumnConfigs } = renderColumnConfigs()
 
+  if (isLoading) {
+    return (
+      <CustomGrid
+        gridconfig={{
+          gridwidth: '100%',
+          alignment: 'center',
+        }}
+        columnconfig={[
+          {
+            row: 1,
+            column: 1,
+            alignment: 'center',
+            component: (
+              <Box
+                display="flex"
+                justifyContent="center"
+                alignItems="center"
+                height="350px"
+                width="100%"
+                overflow="auto"
+              >
+                <CircularProgress size={240} thickness={2} />
+              </Box>
+            ),
+          },
+        ]}
+      />
+    )
+  }
+
   return (
     <Paper
       elevation={1}

package/src/components/QRCode/index.tsx

@@ -2,52 +2,58 @@ import React, { useMemo } from 'react'
 import QRCode from 'react-qr-code'
 import { Box, Typography, Paper, Theme, CircularProgress } from '@mui/material'
 import { SxProps } from '@mui/system'
+import { authenticator } from 'otplib'
 
 /**
  * Props for the QRCodeComponent
  * @typedef {Object} QRCodeProps
- * @property {string} value - The value to be encoded in the QR code
+ * @property {string} username - The username for the MFA setup
+ * @property {string} appName - The name of the application for MFA
  * @property {number} [size] - The size of the QR code in pixels
  * @property {string} [title] - An optional title to display above the QR code
  * @property {SxProps<Theme>} [sx] - Custom styles to apply to the component
+ * @property {(secret: string) => void} [onSecretGenerated] - Callback function to receive the generated secret
  */
 export interface QRCodeProps {
-  value: string
+  username: string
+  appName: string
   size?: number
   title?: string
   sx?: SxProps<Theme>
+  onSecretGenerated?: (secret: string) => void
 }
 
 /**
- * A component that displays a QR code with Material-UI styling
+ * A component that displays a QR code for MFA setup with Material-UI styling
  * @param {QRCodeProps} props - The props for the component
  * @returns {React.ReactElement} The rendered QR code component
  */
 const QRCodeComponent: React.FC<QRCodeProps> = React.memo(
-  ({ value, size = 256, title, sx }) => {
-    // Validate the QR code value
-    const isValidValue = useMemo(() => {
-      if (!value) return false
-      try {
-        // Check if the value is a valid URL
-        new URL(value)
-        return true
-      } catch {
-        // If not a URL, check if it's a non-empty string
-        return typeof value === 'string' && value.trim().length > 0
+  ({ username, appName, size = 256, title, sx, onSecretGenerated }) => {
+    // Generate the secret and OTP auth URL
+    const { secret, otpAuth } = useMemo(() => {
+      const generatedSecret = authenticator.generateSecret()
+      const otpAuthUrl = authenticator.keyuri(
+        encodeURIComponent(username),
+        encodeURIComponent(appName),
+        generatedSecret
+      )
+      if (onSecretGenerated) {
+        onSecretGenerated(generatedSecret)
       }
-    }, [value])
+      return { secret: generatedSecret, otpAuth: otpAuthUrl }
+    }, [username, appName, onSecretGenerated])
 
     // Calculate responsive size
     const responsiveSize = useMemo(() => {
       return Math.min(size, window.innerWidth - 32) // 32px for padding
     }, [size])
 
-    if (!isValidValue) {
+    if (!otpAuth) {
       return (
         <Box sx={{ ...sx, p: 2 }} role="alert">
           <Typography color="error">
-            Error: Invalid or empty QR code value
+            Error: Failed to generate QR code
           </Typography>
         </Box>
       )
@@ -88,13 +94,16 @@ const QRCodeComponent: React.FC<QRCodeProps> = React.memo(
             }
           >
             <QRCode
-              value={value}
+              value={otpAuth}
               size={responsiveSize}
               style={{ height: 'auto', maxWidth: '100%', width: '100%' }}
-              aria-label={`QR Code for ${title || value}`}
+              aria-label={`QR Code for ${title || 'MFA Setup'}`}
             />
           </React.Suspense>
         </Box>
+        <Typography variant="body2" align="center" sx={{ mt: 2 }}>
+          Secret: {secret}
+        </Typography>
       </Paper>
     )
   }
@@ -103,3 +112,22 @@ const QRCodeComponent: React.FC<QRCodeProps> = React.memo(
 QRCodeComponent.displayName = 'QRCodeComponent'
 
 export default QRCodeComponent
+
+/**
+ * Verifies a MFA token against a secret.
+ *
+ * @param token - The token to verify.
+ * @param secret - The secret key to verify against.
+ * @returns A boolean indicating whether the token is valid.
+ * @throws Error if inputs are invalid.
+ */
+export function verifyMFAToken(token: string, secret: string): boolean {
+  if (!token || typeof token !== 'string') {
+    throw new Error('Invalid token')
+  }
+  if (!secret || typeof secret !== 'string') {
+    throw new Error('Invalid secret')
+  }
+
+  return authenticator.verify({ token, secret })
+}