Files
Alaister 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

135 lines
2.9 KiB
TypeScript

export interface IPv4DisabledReasonOptions {
isAws: boolean
isProjectActive: boolean
projectUpdateDisabled: boolean
canUpdateIPv4: boolean
ipv4Enabled: boolean
isHighAvailability: boolean
}
export const getIPv4DisabledReason = ({
isAws,
isProjectActive,
projectUpdateDisabled,
canUpdateIPv4,
ipv4Enabled,
isHighAvailability,
}: IPv4DisabledReasonOptions) => {
if (isHighAvailability) {
return 'Dedicated IPv4 address is unavailable on High Availability projects'
}
if (!isAws) {
return 'Dedicated IPv4 address is only available for AWS projects'
}
if (!isProjectActive) {
return 'Project must be active to update IPv4'
}
if (projectUpdateDisabled) {
return 'Project updates are currently disabled'
}
if (!canUpdateIPv4 && !ipv4Enabled) {
return 'You can only add IPv4 when your project network configuration is set to IPv6'
}
return undefined
}
export interface PitrDisabledReasonOptions {
isProjectActive: boolean
projectUpdateDisabled: boolean
hasHipaaAddon: boolean
sufficientPgVersion: boolean
isOrioleDbInAws: boolean
isHighAvailability: boolean
}
export const getPitrDisabledReason = ({
isProjectActive,
projectUpdateDisabled,
hasHipaaAddon,
sufficientPgVersion,
isOrioleDbInAws,
isHighAvailability,
}: PitrDisabledReasonOptions) => {
if (isHighAvailability) {
return 'Point in time recovery is unavailable on High Availability projects'
}
if (!isProjectActive) {
return 'Project must be active to update PITR'
}
if (projectUpdateDisabled) {
return 'Project updates are currently disabled'
}
if (hasHipaaAddon) {
return 'PITR cannot be changed with HIPAA enabled'
}
if (!sufficientPgVersion) {
return 'Your project is too old to enable PITR'
}
if (isOrioleDbInAws) {
return 'Point in time recovery is not supported with OrioleDB'
}
return undefined
}
export interface CustomDomainDisabledReasonOptions {
isProjectActive: boolean
projectUpdateDisabled: boolean
isHighAvailability: boolean
}
export const getCustomDomainDisabledReason = ({
isProjectActive,
projectUpdateDisabled,
isHighAvailability,
}: CustomDomainDisabledReasonOptions) => {
if (isHighAvailability) {
return 'Custom domain is unavailable on High Availability projects'
}
if (!isProjectActive) {
return 'Project must be active to update custom domain'
}
if (projectUpdateDisabled) {
return 'Project updates are currently disabled'
}
return undefined
}
export type PitrAlertState = 'hipaa' | 'legacy-project' | 'orioledb' | undefined
export const getPitrAlertState = ({
hasHipaaAddon,
sufficientPgVersion,
isOrioleDbInAws,
}: Pick<
PitrDisabledReasonOptions,
'hasHipaaAddon' | 'sufficientPgVersion' | 'isOrioleDbInAws'
>) => {
if (hasHipaaAddon) {
return 'hipaa'
}
if (!sufficientPgVersion) {
return 'legacy-project'
}
if (isOrioleDbInAws) {
return 'orioledb'
}
return undefined
}