feat: adding pg:upgrade:wait command

[nilamuthu]

Work item

This PR creates the pg:upgrade:wait command.

Please refer to this doc for more information related to pg:upgrade:wait.

Testing

Check out this branch and run yarn && yarn build

1. Run ./bin/run pg:upgrade:prepare on a Standard-Tier leader DB and then pg:upgrade:wait to see it prepare

nmuthu@nmuthu-ltm8kcc cli % ./bin/run pg:upgrade:prepare HEROKU_POSTGRESQL_PUCE_URL -a pg-upgrade-test-app
 ›   Warning: Destructive action
 ›   This command prepares the upgrade for postgresql-flat-28316 to the latest supported Postgres version and schedules to upgrade it during the next available maintenance window.
 ›

To proceed, type pg-upgrade-test-app or re-run this command with --confirm pg-upgrade-test-app: pg-upgrade-test-app
Preparing upgrade on postgresql-flat-28316... done
Your database is scheduled for upgrade during your next available maintenance window.
Run heroku pg:upgrade:wait to track its status.
You can also run this upgrade manually before the maintenance window with heroku pg:upgrade:run. Note: You can only run the upgrade after it's fully prepared, which can take up to a day.

nmuthu@nmuthu-ltm8kcc cli % ./bin/run pg:upgrade:wait HEROKU_POSTGRESQL_PUCE_URL -a pg-upgrade-test-app
Waiting for database postgresql-flat-28316... ⡿ preparing service for upgrade

2. Run ./bin/run pg:upgrade:run on a Standard-Tier leader DB with an upgrade prepared and then pg:upgrade:wait to see it run

Screen.Recording.2025-04-08.at.10.57.36.AM.mov

3. Run ./bin/run pg:upgrade:wait after starting an upgrade on essential db

nmuthu@nmuthu-ltm8kcc cli % ./bin/run pg:upgrade:wait HEROKU_POSTGRESQL_PURPLE_URL -a pg-upgrade-test-app
Waiting for database postgresql-flat-11475... ⣟ version upgrade: provisioning

5. Run ./bin/run pg:upgrade:wait with no database argument

nmuthu@nmuthu-ltm8kcc cli % ./bin/run pg:upgrade:wait -a pg-upgrade-test-app
 ›   Error: You must provide a database. Run `--help` for more information on the command.

6. pg:upgrade:wait when upgrade has been scheduled (shouldn't wait)

nmuthu@nmuthu-ltm8kcc cli % ./bin/run pg:upgrade:wait HEROKU_POSTGRESQL_PUCE_URL -a pg-upgrade-test-app
Waiting for database postgresql-flat-11475... upgrade is scheduled on 2025-04-17 20:30:00 UTC. You could also run the upgrade immediately using the pg:upgrade:run.

7.heroku help pg:upgrade:wait

nmuthu@nmuthu-ltm8kcc cli % ./bin/run help pg:upgrade:wait
provides the status of an upgrade and blocks it until the operation is complete

USAGE
  $ heroku pg:upgrade:wait [DATABASE] -a <value> [--wait-interval <value>] [--no-notify] [-r <value>]

ARGUMENTS
  DATABASE  config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with
            `APP_NAME::`

FLAGS
  -a, --app=<value>        (required) app to run command against
  -r, --remote=<value>     git remote of app to use
  --no-notify              do not show OS notification
  --wait-interval=<value>  how frequently to poll in seconds (to avoid rate limiting)

DESCRIPTION
  provides the status of an upgrade and blocks it until the operation is complete

[justinwilaby]

Some very minor changes recommended. Overall, it looks good! Thank you!

[justinwilaby]

Great work! LGTM