Files
Alaister YoungandAlaister Young 0ddf2006d3 [FE-4337] feat(studio): block pause, restore, and add-ons on High Availability projects (#49990)
Studio-side guard for Multigres (`high_availability`) projects,
mirroring the platform API guard from supabase/platform#37527. Pause,
restore/PITR, and add-on affordances now show a clear "unavailable on
High Availability projects" state instead of failing with a 400 after
the click.

<img width="1195" height="632" alt="Screenshot 2026-09-04 at 2 03 11 PM"
src="https://github.com/user-attachments/assets/718c09f2-d92b-49dc-90ed-5d9ff810b03d"
/>

**Added:**
- Pause project button is disabled on HA projects with a tooltip
- Scheduled backups tab short-circuits to an HA empty state (matches the
existing PITR tab). Per-row Restore buttons are also disabled with a
tooltip as defense in depth, since BackupItem is reusable
- Restore to new project shows an HA admonition ahead of the permission
/ PG15 / physical-backup checks
- Add-ons page shows a page-level HA notice, all three rows are locked
with a tooltip, and the side panels are not mounted on HA so
`?panel=pitr|ipv4|customDomain` deep links are inert
- Component tests for `PauseProjectButton` and `BackupItem`, plus unit
tests for the new `isHighAvailability` branch in `Addons.utils.ts`

**Changed:**
- Add-ons rows are now consistent: the IPv4 row uses the same padlock
tooltip as PITR and custom domain instead of a tooltip on the badge.
Same disabled-reason strings as before, just surfaced via the padlock on
non-HA projects too
- `BackupItem` tooltip text extracted into a `getTooltipText()` function
(mirrors `PauseProjectButton`)
- `HighAvailabilityDisabledSectionNotice` accepts a `className`

Detection reuses the existing `useIsHighAvailability()` hook, which the
rest of Studio already treats as the Multigres signal.

## To test

Use an HA project (`project.high_availability === true`) and a normal
project.

HA project:
- Settings > General: "Pause project" is disabled, tooltip reads
"Pausing is unavailable on High Availability projects"
- Database > Backups > Scheduled backups: HA empty state, no "No backups
yet" / daily backup copy
- Database > Backups > Restore to new project: HA admonition, no restore
controls
- Settings > Add-ons: notice at the top, padlock on all three rows with
per-row tooltip, clicking rows does nothing, and `?panel=pitr` /
`?panel=ipv4` / `?panel=customDomain` open nothing

Normal project (regression):
- No "High Availability" strings on any of the above pages
- Pause button enabled (or disabled only for its usual reasons, e.g.
paid plan)
- Add-on rows open their side panels on click and via `?panel=pitr`
- Scheduled backups tab shows its normal list / empty state


<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->

## Summary by CodeRabbit

- **Features**
- High Availability projects now clearly indicate when scheduled
backups, backup restoration, project pausing, IPv4, PITR, and custom
domains are unavailable.
- Added explanatory notices, disabled controls, and tooltips throughout
affected settings and backup screens.
- Restore-to-new-project workflows now provide guidance to contact
support when unavailable.

- **Bug Fixes**
- Improved consistency of availability messaging across High
Availability project settings and database backup actions.

<!-- end of auto-generated comment: release notes by coderabbit.ai -->

Co-authored-by: Alaister Young <10985857+alaister@users.noreply.github.com>
2026-09-04 17:08:01 +08:00

145 lines
4.9 KiB
TypeScript

import { useParams } from 'common'
import dayjs from 'dayjs'
import { Clock } from 'lucide-react'
import { useRouter } from 'next/router'
import { useState } from 'react'
import { toast } from 'sonner'
import { Admonition } from 'ui-patterns/Admonition'
import ConfirmationModal from 'ui-patterns/Dialogs/ConfirmationModal'
import { TimestampInfo } from 'ui-patterns/TimestampInfo'
import { BackupItem } from './BackupItem'
import { BackupsEmpty } from './BackupsEmpty'
import { BackupsStorageAlert } from './BackupsStorageAlert'
import Panel from '@/components/ui/Panel'
import { UpgradeToPro } from '@/components/ui/UpgradeToPro'
import { useBackupRestoreMutation } from '@/data/database/backup-restore-mutation'
import { DatabaseBackup, useBackupsQuery } from '@/data/database/backups-query'
import { useSetProjectStatus } from '@/data/projects/project-detail-query'
import { useCheckEntitlements } from '@/hooks/misc/useCheckEntitlements'
import { useIsHighAvailability, useSelectedProjectQuery } from '@/hooks/misc/useSelectedProject'
import { PROJECT_STATUS } from '@/lib/constants'
export const BackupsList = () => {
const router = useRouter()
const { ref: projectRef } = useParams()
const [selectedBackup, setSelectedBackup] = useState<DatabaseBackup>()
const { hasAccess: hasAccessToBackups } = useCheckEntitlements('backup.retention_days')
const { setProjectStatus } = useSetProjectStatus()
const { data: selectedProject } = useSelectedProjectQuery()
const isHealthy = selectedProject?.status === PROJECT_STATUS.ACTIVE_HEALTHY
const isHighAvailability = useIsHighAvailability()
const { data: backups } = useBackupsQuery({ projectRef })
const {
mutate: restoreFromBackup,
isPending: isRestoring,
isSuccess: isSuccessBackup,
} = useBackupRestoreMutation({
onSuccess: () => {
if (projectRef) {
setTimeout(() => {
setProjectStatus({ ref: projectRef, status: PROJECT_STATUS.RESTORING })
toast.success(
`Restoring database back to ${dayjs(selectedBackup?.inserted_at).format(
'DD MMM YYYY HH:mm:ss'
)}`
)
router.push(`/project/${projectRef}`)
}, 3000)
}
},
})
const sortedBackups = (backups?.backups ?? []).sort(
(a, b) => new Date(b.inserted_at).valueOf() - new Date(a.inserted_at).valueOf()
)
const isPitrEnabled = backups?.pitr_enabled
if (!hasAccessToBackups) {
return (
<UpgradeToPro
addon="pitr"
source="backups"
featureProposition="have up to 7 days of scheduled backups"
icon={<Clock size={20} />}
primaryText="Free Plan does not include project backups."
secondaryText="Upgrade to the Pro Plan for up to 7 days of scheduled backups."
buttonText="Upgrade"
/>
)
}
if (isPitrEnabled) return null
return (
<>
<div className="space-y-6">
{sortedBackups.length === 0 ? (
<BackupsEmpty />
) : (
<>
<BackupsStorageAlert />
<Panel>
{sortedBackups?.map((x, i: number) => {
return (
<BackupItem
key={x.id}
backup={x}
index={i}
isHealthy={isHealthy}
isHighAvailability={isHighAvailability}
onSelectBackup={() => setSelectedBackup(x)}
/>
)
})}
</Panel>
</>
)}
</div>
<ConfirmationModal
size="small"
confirmLabel="Restore"
confirmLabelLoading="Restoring..."
variant="warning"
visible={selectedBackup !== undefined}
title="Restore from backup"
loading={isRestoring || isSuccessBackup}
onCancel={() => setSelectedBackup(undefined)}
onConfirm={() => {
if (projectRef === undefined) return console.error('Project ref required')
if (selectedBackup === undefined) return console.error('Backup required')
restoreFromBackup({ ref: projectRef, backup: selectedBackup })
}}
>
<div className="space-y-3">
{!!selectedBackup && (
<p className="text-sm">
This will restore your database to the backup made on{' '}
<TimestampInfo
displayAs="utc"
utcTimestamp={selectedBackup.inserted_at}
labelFormat="DD MMM YYYY HH:mm:ss (ZZ)"
className="text-sm!"
/>
</p>
)}
<Admonition
showIcon={false}
type="warning"
title="This action cannot be undone"
description={
<ul className="list-disc list-inside">
<li>Your project will be offline during restoration</li>
<li>Any new data since this backup will be lost</li>
</ul>
}
/>
</div>
</ConfirmationModal>
</>
)
}