The Postgres development platform. Supabase gives you a dedicated Postgres database to build your web, mobile, and AI applications.
TypeScript aialternativeauthdatabasedenoembeddingsexamplefirebasenextjsoauth2pgvectorpostgispostgrespostgresqlpostgrestrealtimesupabasevectorswebsockets
import { ExternalLinkIcon } from 'lucide-react'
import { useTheme } from 'next-themes'
import Image from 'next/image'
import { useState } from 'react'
import { cn, HoverCard, HoverCardContent, HoverCardTrigger, InfoIcon } from 'ui'
import { ShimmeringLoader } from 'ui-patterns/ShimmeringLoader'
import { getErrorCodeInfo } from './ErrorCodeTooltip.utils'
import { SIDEBAR_KEYS } from '@/components/layouts/ProjectLayout/LayoutSidebar/LayoutSidebarProvider'
import { AiAssistantDropdown } from '@/components/ui/AiAssistantDropdown'
import { useErrorCodesQuery } from '@/data/content-api/docs-error-codes-query'
import { Service } from '@/data/graphql/graphql'
import { BASE_PATH } from '@/lib/constants'
import { useAiAssistantStateSnapshot } from '@/state/ai-assistant-state'
import { useSidebarManagerSnapshot } from '@/state/sidebar-manager-state'
interface ErrorCodeTooltipProps {
errorCode: string
service?: Service
children: React.ReactNode
}
export const ErrorCodeTooltip = ({ errorCode, service, children }: ErrorCodeTooltipProps) => {
const [isOpen, setIsOpen] = useState(false)
const { resolvedTheme } = useTheme()
const snap = useAiAssistantStateSnapshot()
const { openSidebar } = useSidebarManagerSnapshot()
const { definition, docsUrl: sharedDocsUrl } = getErrorCodeInfo(errorCode, service)
const { data, isPending } = useErrorCodesQuery(
{ code: errorCode, service },
{ enabled: isOpen && !definition }
)
const errors = data?.errors?.nodes?.filter((e) => !!e.message) ?? []
const description = definition?.description ?? errors[0]?.message
const docsUrl = sharedDocsUrl
const buildPrompt = () => {
const servicePart = service ? ` in Supabase ${service}` : ''
const descriptionPart = description ? `\n\nError description: ${description}` : ''
return `I'm encountering error code \`${errorCode}\`${servicePart}.${descriptionPart}\n\nCan you explain what this error means and suggest steps to fix it?`
}
const handleOpenAssistant = () => {
openSidebar(SIDEBAR_KEYS.AI_ASSISTANT)
snap.newChat({
name: `Fix error ${errorCode}`,
initialMessage: buildPrompt(),
})
}
return (
<HoverCard open={isOpen} onOpenChange={setIsOpen} openDelay={200} closeDelay={100}>
<HoverCardTrigger asChild>
<span className="inline-flex items-center gap-1 cursor-default">
{children}
<InfoIcon hideBackground className="w-3.5 h-3.5 shrink-0 fill-foreground-muted" />
</span>
</HoverCardTrigger>
<HoverCardContent side="top" align="center" className="w-[360px] p-0 overflow-hidden">
<div className="flex flex-col">
<div className="px-4 pt-3 pb-2.5 border-b border-border">
<p className="font-mono text-xs uppercase text-foreground-light truncate max-w-[40ch]">
{errorCode}
</p>
</div>
<div className="px-4 py-3 space-y-2">
{isPending && !definition ? (
<div className="space-y-1.5">
<ShimmeringLoader className="w-full" />
<ShimmeringLoader className="w-4/5" />
<ShimmeringLoader className="w-3/5" />
</div>
) : !description ? (
<p className="text-sm text-foreground-lighter">
No description available for this error code.
</p>
) : (
<p className="text-sm text-foreground leading-relaxed">{description}</p>
)}
</div>
<div
className={cn(
'border-t border-border px-4 py-2.5 flex items-center',
docsUrl ? 'justify-between' : 'justify-end'
)}
>
{docsUrl && (
<div className="flex items-center gap-1.5">
<Image
src={
resolvedTheme?.includes('dark')
? `${BASE_PATH}/img/supabase-dark.svg`
: `${BASE_PATH}/img/supabase-light.svg`
}
alt="Supabase"
height={14}
width={72}
/>
<span className="font-mono text-[11px] font-semibold text-primary tracking-wide">
DOCS
</span>
</div>
)}
<AiAssistantDropdown
showExternalAI
label="Fix with AI"
buildPrompt={buildPrompt}
onOpenAssistant={handleOpenAssistant}
telemetrySource="error_code"
copyLabel="Copy Markdown"
additionalDropdownItems={[
{
label: 'Go to Docs',
icon: <ExternalLinkIcon size={14} />,
href: docsUrl,
},
]}
/>
</div>
</div>
</HoverCardContent>
</HoverCard>
)
}