heroku 9.0.0-alpha.1 → 9.0.0-alpha.2

package/lib/commands/members/set.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const command_1 = require("@heroku-cli/command");
+const completions_1 = require("@heroku-cli/command/lib/completions");
+const utils_1 = require("../../lib/members/utils");
+class MembersSet extends command_1.Command {
+    async run() {
+        const { flags, argv } = await this.parse(MembersSet);
+        const { role, team } = flags;
+        const email = argv[0];
+        await (0, utils_1.addMemberToTeam)(email, role, team, this.heroku, 'PATCH');
+    }
+}
+exports.default = MembersSet;
+MembersSet.topic = 'members';
+MembersSet.description = 'sets a members role in a team';
+MembersSet.strict = false;
+MembersSet.flags = {
+    role: command_1.flags.string({ char: 'r', required: true, description: 'member role (admin, collaborator, member, owner)', completion: completions_1.RoleCompletion }),
+    team: command_1.flags.team({ required: true }),
+};

package/lib/commands/notifications/index.d.ts

@@ -0,0 +1,13 @@
+import { Command } from '@heroku-cli/command';
+export default class NotificationsIndex extends Command {
+    static description: string;
+    static topic: string;
+    static flags: {
+        app: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        remote: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        all: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        read: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/lib/commands/notifications/index.js

@@ -0,0 +1,62 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const command_1 = require("@heroku-cli/command");
+const color_1 = require("@heroku-cli/color");
+const core_1 = require("@oclif/core");
+const time = require("../../lib/time");
+const wrap = require("word-wrap");
+function displayNotifications(notifications, app, readNotification) {
+    const read = readNotification ? 'Read' : 'Unread';
+    core_1.ux.styledHeader(app ? `${read} Notifications for ${color_1.default.app(app.name)}` : `${read} Notifications`);
+    for (const n of notifications) {
+        core_1.ux.log(color_1.default.yellow(`\n${n.title}\n`));
+        core_1.ux.log(wrap(`\n${color_1.default.dim(time.ago(new Date(n.created_at)))}\n${n.body}`, { width: 80 }));
+        for (const followup of n.followup) {
+            core_1.ux.log();
+            core_1.ux.log(wrap(`${color_1.default.gray.dim(time.ago(new Date(followup.created_at)))}\n${followup.body}`, { width: 80 }));
+        }
+    }
+}
+class NotificationsIndex extends command_1.Command {
+    async run() {
+        const { flags } = await this.parse(NotificationsIndex);
+        const appResponse = flags.app && !flags.all ? await this.heroku.get(`/apps/${flags.app}`) : null;
+        const app = appResponse === null || appResponse === void 0 ? void 0 : appResponse.body;
+        const notificationsResponse = await this.heroku.get('/user/notifications', { hostname: 'telex.heroku.com' });
+        let notifications = notificationsResponse.body;
+        if (app)
+            notifications = notifications.filter(n => n.target.id === app.id);
+        if (!flags.read) {
+            notifications = notifications.filter(n => !n.read);
+            await Promise.all(notifications.map(n => this.heroku.patch(`/user/notifications/${n.id}`, { hostname: 'telex.heroku.com', body: { read: true } })));
+        }
+        if (flags.json) {
+            core_1.ux.styledJSON(notifications);
+            return;
+        }
+        if (notifications.length === 0) {
+            if (flags.read) {
+                if (app)
+                    core_1.ux.log(`You have no notifications on ${color_1.default.green(app.name)}.\nRun heroku notifications --all to view notifications for all apps.`);
+                else
+                    core_1.ux.log('You have no notifications.');
+            }
+            else if (app)
+                core_1.ux.log(`No unread notifications on ${color_1.default.green(app.name)}.\nRun ${color_1.default.cmd('heroku notifications --all')} to view notifications for all apps.`);
+            else
+                core_1.ux.log(`No unread notifications.\nRun ${color_1.default.cmd('heroku notifications --read')} to view read notifications.`);
+        }
+        else
+            displayNotifications(notifications, app, flags.read);
+    }
+}
+exports.default = NotificationsIndex;
+NotificationsIndex.description = 'display notifications';
+NotificationsIndex.topic = 'notifications';
+NotificationsIndex.flags = {
+    app: command_1.flags.app({ required: false }),
+    remote: command_1.flags.remote(),
+    all: command_1.flags.boolean({ description: 'view all notifications (not just the ones for the current app)' }),
+    json: command_1.flags.boolean({ description: 'output in json format' }),
+    read: command_1.flags.boolean({ description: 'show notifications already read' }),
+};

package/lib/commands/orgs/index.d.ts

@@ -0,0 +1,11 @@
+import { Command } from '@heroku-cli/command';
+export default class OrgsIndex extends Command {
+    static topic: string;
+    static description: string;
+    static flags: {
+        json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        enterprise: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        teams: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/lib/commands/orgs/index.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const command_1 = require("@heroku-cli/command");
+const utils_1 = require("../../lib/orgs/utils");
+class OrgsIndex extends command_1.Command {
+    async run() {
+        const { flags } = await this.parse(OrgsIndex);
+        let { body: orgs } = await this.heroku.get('/teams');
+        if (flags.enterprise) {
+            orgs = orgs.filter(o => o.type === 'enterprise');
+        }
+        if (flags.json) {
+            (0, utils_1.printGroupsJSON)(orgs);
+        }
+        else {
+            (0, utils_1.printGroups)(orgs, { label: 'Teams' });
+        }
+    }
+}
+exports.default = OrgsIndex;
+OrgsIndex.topic = 'orgs';
+OrgsIndex.description = 'list the teams that you are a member of';
+OrgsIndex.flags = {
+    json: command_1.flags.boolean({ description: 'output in json format' }),
+    enterprise: command_1.flags.boolean({ description: 'filter by enterprise teams' }),
+    teams: command_1.flags.boolean({ description: 'filter by teams', hidden: true }),
+};

package/lib/commands/orgs/open.d.ts

@@ -0,0 +1,10 @@
+import { Command } from '@heroku-cli/command';
+export default class OrgsOpen extends Command {
+    static topic: string;
+    static description: string;
+    static flags: {
+        team: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+    };
+    static openUrl(url: string): Promise<void>;
+    run(): Promise<void>;
+}

package/lib/commands/orgs/open.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const command_1 = require("@heroku-cli/command");
+const open = require("open");
+const core_1 = require("@oclif/core");
+const color_1 = require("@heroku-cli/color");
+class OrgsOpen extends command_1.Command {
+    static async openUrl(url) {
+        core_1.ux.log(`Opening ${color_1.default.cyan(url)}...`);
+        await open(url);
+    }
+    async run() {
+        const { flags, argv, args } = await this.parse(OrgsOpen);
+        const team = flags.team;
+        const { body: org } = await this.heroku.get(`/teams/${team}`);
+        await OrgsOpen.openUrl(`https://dashboard.heroku.com/teams/${org.name}`);
+    }
+}
+exports.default = OrgsOpen;
+OrgsOpen.topic = 'orgs';
+OrgsOpen.description = 'open the team interface in a browser window';
+OrgsOpen.flags = {
+    team: command_1.flags.team({ required: true }),
+};

package/lib/commands/pg/backups/cancel.d.ts

@@ -0,0 +1,15 @@
+import { Command } from '@heroku-cli/command';
+import { BackupTransfer } from '../../../lib/pg/types';
+export default class Cancel extends Command {
+    static topic: string;
+    static description: string;
+    static flags: {
+        app: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        remote: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+    };
+    static args: {
+        backup_id: import("@oclif/core/lib/interfaces/parser").Arg<string | undefined, Record<string, unknown>>;
+    };
+    run(): Promise<void>;
+    protected sortByCreatedAtDesc(transfers: BackupTransfer[]): BackupTransfer[];
+}

package/lib/commands/pg/backups/cancel.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const command_1 = require("@heroku-cli/command");
+const core_1 = require("@oclif/core");
+const host_1 = require("../../../lib/pg/host");
+const backups_1 = require("../../../lib/pg/backups");
+class Cancel extends command_1.Command {
+    async run() {
+        const { flags, args } = await this.parse(Cancel);
+        const { app } = flags;
+        const { backup_id } = args;
+        const pgbackups = (0, backups_1.default)(app, this.heroku);
+        let transfer;
+        if (backup_id) {
+            const num = await pgbackups.num(backup_id);
+            if (!num) {
+                core_1.ux.error(`Invalid Backup: ${backup_id}`);
+            }
+            ({ body: transfer } = await this.heroku.get(`/client/v11/apps/${app}/transfers/${num}`, { hostname: (0, host_1.default)() }));
+        }
+        else {
+            const { body: transfers } = await this.heroku.get(`/client/v11/apps/${app}/transfers`, { hostname: (0, host_1.default)() });
+            transfer = this.sortByCreatedAtDesc(transfers).find(t => !t.finished_at);
+        }
+        if (transfer) {
+            core_1.ux.action.start(`Cancelling ${pgbackups.name(transfer)}`);
+            this.heroku.post(`/client/v11/apps/${app}/transfers/${transfer.uuid}/actions/cancel`, { hostname: (0, host_1.default)() });
+            core_1.ux.action.stop();
+        }
+        else {
+            core_1.ux.error('No active backups/transfers');
+        }
+    }
+    sortByCreatedAtDesc(transfers) {
+        return transfers.sort((a, b) => {
+            return new Date(a.created_at).getTime() - new Date(b.created_at).getTime();
+        });
+    }
+}
+exports.default = Cancel;
+Cancel.topic = 'pg';
+Cancel.description = 'cancel an in-progress backup or restore (default newest)';
+Cancel.flags = {
+    app: command_1.flags.app({ required: true }),
+    remote: command_1.flags.remote(),
+};
+Cancel.args = {
+    backup_id: core_1.Args.string(),
+};

package/lib/commands/pg/backups/capture.d.ts

@@ -0,0 +1,15 @@
+import { Command } from '@heroku-cli/command';
+export default class Capture extends Command {
+    static topic: string;
+    static description: string;
+    static flags: {
+        'wait-interval': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        verbose: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        app: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        remote: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+    };
+    static args: {
+        database: import("@oclif/core/lib/interfaces/parser").Arg<string | undefined, Record<string, unknown>>;
+    };
+    run(): Promise<void>;
+}

package/lib/commands/pg/backups/capture.js

@@ -0,0 +1,65 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const color_1 = require("@heroku-cli/color");
+const command_1 = require("@heroku-cli/command");
+const core_1 = require("@oclif/core");
+const backups_1 = require("../../../lib/pg/backups");
+const fetcher_1 = require("../../../lib/pg/fetcher");
+const host_1 = require("../../../lib/pg/host");
+const tsheredoc_1 = require("tsheredoc");
+class Capture extends command_1.Command {
+    async run() {
+        var _a;
+        const { flags, args } = await this.parse(Capture);
+        const { app, 'wait-interval': waitInterval, verbose } = flags;
+        const { database } = args;
+        const interval = Math.max(3, Number.parseInt(waitInterval || '3', 10));
+        const db = await (0, fetcher_1.getAddon)(this.heroku, app, database);
+        const pgBackupsApi = (0, backups_1.default)(app, this.heroku);
+        try {
+            const { body: dbInfo } = await this.heroku.get(`/client/v11/databases/${db.id}`, { hostname: (0, host_1.default)() });
+            const dbProtected = /On/.test(((_a = dbInfo.info.find(attribute => attribute.name === 'Continuous Protection')) === null || _a === void 0 ? void 0 : _a.values[0]) || '');
+            if (dbProtected) {
+                core_1.ux.warn('Continuous protection is already enabled for this database. Logical backups of large databases are likely to fail.');
+                core_1.ux.warn('See https://devcenter.heroku.com/articles/heroku-postgres-data-safety-and-continuous-protection#physical-backups-on-heroku-postgres.');
+            }
+        }
+        catch (error) {
+            const httpError = error;
+            if (httpError.statusCode !== 404)
+                throw httpError;
+            core_1.ux.error((0, tsheredoc_1.default) `
+          ${color_1.default.yellow(db.name)} is not yet provisioned.
+          Run ${color_1.default.cmd('heroku addons:wait')} to wait until the db is provisioned.
+        `, { exit: 1 });
+        }
+        core_1.ux.action.start(`Starting backup of ${color_1.default.yellow(db.name)}`);
+        const { body: backup } = await this.heroku.post(`/client/v11/databases/${db.id}/backups`, { hostname: (0, host_1.default)() });
+        core_1.ux.action.stop();
+        core_1.ux.log((0, tsheredoc_1.default) `
+
+      Use Ctrl-C at any time to stop monitoring progress; the backup will continue running.
+      Use ${color_1.default.cmd('heroku pg:backups:info')} to check progress.
+      Stop a running backup with ${color_1.default.cmd('heroku pg:backups:cancel')}.
+    `);
+        if (app !== db.app.name) {
+            core_1.ux.log((0, tsheredoc_1.default) `
+        HINT: You are running this command with a non-billing application.
+        Use ${color_1.default.cmd('heroku pg:backups -a ' + db.app.name)} to check the list of backups.
+      `);
+        }
+        await pgBackupsApi.wait(`Backing up ${color_1.default.green(backup.from_name)} to ${color_1.default.cyan(pgBackupsApi.name(backup))}`, backup.uuid, interval, verbose, db.app.name || app);
+    }
+}
+exports.default = Capture;
+Capture.topic = 'pg';
+Capture.description = 'capture a new backup';
+Capture.flags = {
+    'wait-interval': command_1.flags.string(),
+    verbose: command_1.flags.boolean({ char: 'v' }),
+    app: command_1.flags.app({ required: true }),
+    remote: command_1.flags.remote(),
+};
+Capture.args = {
+    database: core_1.Args.string(),
+};

package/lib/commands/pg/backups/delete.d.ts

@@ -0,0 +1,15 @@
+import { Command } from '@heroku-cli/command';
+export default class Delete extends Command {
+    static topic: string;
+    static description: string;
+    static flags: {
+        confirm: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        app: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        remote: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+    };
+    static args: {
+        backup_id: import("@oclif/core/lib/interfaces/parser").Arg<string, Record<string, unknown>>;
+    };
+    static examples: string[];
+    run(): Promise<void>;
+}

package/lib/commands/pg/backups/delete.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const color_1 = require("@heroku-cli/color");
+const command_1 = require("@heroku-cli/command");
+const core_1 = require("@oclif/core");
+const confirmCommand_1 = require("../../../lib/confirmCommand");
+const host_1 = require("../../../lib/pg/host");
+const backups_1 = require("../../../lib/pg/backups");
+class Delete extends command_1.Command {
+    async run() {
+        const { flags, args } = await this.parse(Delete);
+        const { app, confirm } = flags;
+        const { backup_id } = args;
+        const pgbackups = (0, backups_1.default)(app, this.heroku);
+        await (0, confirmCommand_1.default)(app, confirm);
+        core_1.ux.action.start(`Deleting backup ${color_1.default.cyan(backup_id)} on ${color_1.default.app(app)}`);
+        const num = await pgbackups.num(backup_id);
+        if (!num) {
+            throw new Error(`Invalid Backup: ${backup_id}`);
+        }
+        await this.heroku.delete(`/client/v11/apps/${app}/transfers/${num}`, { hostname: (0, host_1.default)() });
+        core_1.ux.action.stop();
+    }
+}
+exports.default = Delete;
+Delete.topic = 'pg';
+Delete.description = 'delete a backup';
+Delete.flags = {
+    confirm: command_1.flags.string({ char: 'c' }),
+    app: command_1.flags.app({ required: true }),
+    remote: command_1.flags.remote(),
+};
+Delete.args = {
+    backup_id: core_1.Args.string({ required: true }),
+};
+Delete.examples = [
+    '$ heroku pg:backup:delete --app APP_ID BACKUP_ID',
+];

package/lib/commands/pg/backups/download.d.ts

@@ -0,0 +1,14 @@
+import { Command } from '@heroku-cli/command';
+export default class Download extends Command {
+    static topic: string;
+    static description: string;
+    static flags: {
+        output: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        app: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        remote: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+    };
+    static args: {
+        backup_id: import("@oclif/core/lib/interfaces/parser").Arg<string | undefined, Record<string, unknown>>;
+    };
+    run(): Promise<void>;
+}

package/lib/commands/pg/backups/download.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const color_1 = require("@heroku-cli/color");
+const command_1 = require("@heroku-cli/command");
+const core_1 = require("@oclif/core");
+const host_1 = require("../../../lib/pg/host");
+const backups_1 = require("../../../lib/pg/backups");
+const lodash_1 = require("lodash");
+const download_1 = require("../../../lib/pg/download");
+const fs = require("fs-extra");
+function defaultFilename() {
+    let f = 'latest.dump';
+    if (!fs.existsSync(f))
+        return f;
+    let i = 1;
+    do
+        f = `latest.dump.${i++}`;
+    while (fs.existsSync(f));
+    return f;
+}
+class Download extends command_1.Command {
+    async run() {
+        const { flags, args } = await this.parse(Download);
+        const { backup_id } = args;
+        const { app } = flags;
+        const output = flags.output || defaultFilename();
+        let num;
+        core_1.ux.action.start(`Getting backup from ${color_1.default.magenta(app)}`);
+        if (backup_id) {
+            num = await (0, backups_1.default)(app, this.heroku).num(backup_id);
+            if (!num)
+                throw new Error(`Invalid Backup: ${backup_id}`);
+        }
+        else {
+            const { body: transfers } = await this.heroku.get(`/client/v11/apps/${app}/transfers`, { hostname: (0, host_1.default)() });
+            const lastBackup = (0, lodash_1.sortBy)(transfers.filter(t => t.succeeded && t.to_type === 'gof3r'), 'created_at')
+                .pop();
+            if (!lastBackup)
+                throw new Error(`No backups on ${color_1.default.magenta(app)}. Capture one with ${color_1.default.cyan.bold('heroku pg:backups:capture')}`);
+            num = lastBackup.num;
+        }
+        core_1.ux.action.status = `fetching url of #${num}`;
+        const { body: info } = await this.heroku.post(`/client/v11/apps/${app}/transfers/${num}/actions/public-url`, { hostname: (0, host_1.default)() });
+        core_1.ux.action.stop(`done, #${num}`);
+        await (0, download_1.default)(info.url, output, { progress: true });
+    }
+}
+exports.default = Download;
+Download.topic = 'pg';
+Download.description = 'downloads database backup';
+Download.flags = {
+    output: command_1.flags.string({ char: 'o', description: 'location to download to. Defaults to latest.dump' }),
+    app: command_1.flags.app({ required: true }),
+    remote: command_1.flags.remote(),
+};
+Download.args = {
+    backup_id: core_1.Args.string(),
+};

package/lib/commands/pg/backups/index.d.ts

@@ -0,0 +1,20 @@
+import { Command } from '@heroku-cli/command';
+export default class Index extends Command {
+    static topic: string;
+    static description: string;
+    static strict: boolean;
+    static flags: {
+        verbose: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        confirm: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        output: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        'wait-interval': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        at: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        quiet: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        app: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        remote: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+    };
+    run(): Promise<void>;
+    private displayBackups;
+    private displayRestores;
+    private displayCopies;
+}

package/lib/commands/pg/backups/index.js

@@ -0,0 +1,129 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const color_1 = require("@heroku-cli/color");
+const command_1 = require("@heroku-cli/command");
+const core_1 = require("@oclif/core");
+const backups_1 = require("../../../lib/pg/backups");
+const host_1 = require("../../../lib/pg/host");
+class Index extends command_1.Command {
+    async run() {
+        const { flags: { app } } = await this.parse(Index);
+        const { body: transfers } = await this.heroku.get(`/client/v11/apps/${app}/transfers`, { hostname: (0, host_1.default)() });
+        // NOTE that the sort order is descending
+        transfers.sort((transferA, transferB) => {
+            if (transferA.created_at > transferB.created_at) {
+                return -1;
+            }
+            if (transferB.created_at > transferA.created_at) {
+                return 1;
+            }
+            return 0;
+        });
+        this.displayBackups(transfers, app);
+        this.displayRestores(transfers, app);
+        this.displayCopies(transfers, app);
+    }
+    displayBackups(transfers, app) {
+        const backups = transfers.filter(backupTransfer => backupTransfer.from_type === 'pg_dump' && backupTransfer.to_type === 'gof3r');
+        const { name, status, filesize } = (0, backups_1.default)(app, this.heroku);
+        core_1.ux.styledHeader('Backups');
+        if (backups.length === 0) {
+            core_1.ux.log(`No backups. Capture one with ${color_1.default.cyan.bold('heroku pg:backups:capture')}`);
+        }
+        else {
+            core_1.ux.table(backups, {
+                ID: {
+                    get: (transfer) => color_1.default.cyan(name(transfer)),
+                },
+                'Created at': {
+                    get: (transfer) => transfer.created_at,
+                },
+                Status: {
+                    get: (transfer) => status(transfer),
+                },
+                Size: {
+                    get: (transfer) => filesize(transfer.processed_bytes),
+                },
+                Database: {
+                    get: (transfer) => color_1.default.green(transfer.from_name) || 'UNKNOWN',
+                },
+            });
+        }
+        core_1.ux.log();
+    }
+    displayRestores(transfers, app) {
+        const restores = transfers
+            .filter(t => t.from_type !== 'pg_dump' && t.to_type === 'pg_restore')
+            .slice(0, 10); // first 10 only
+        const { name, status, filesize } = (0, backups_1.default)(app, this.heroku);
+        core_1.ux.styledHeader('Restores');
+        if (restores.length === 0) {
+            core_1.ux.log(`No restores found. Use ${color_1.default.cyan.bold('heroku pg:backups:restore')} to restore a backup`);
+        }
+        else {
+            core_1.ux.table(restores, {
+                ID: {
+                    get: (transfer) => color_1.default.cyan(name(transfer)),
+                },
+                'Started at': {
+                    get: (transfer) => transfer.created_at,
+                },
+                Status: {
+                    get: (transfer) => status(transfer),
+                },
+                Size: {
+                    get: (transfer) => filesize(transfer.processed_bytes),
+                },
+                Database: {
+                    get: (transfer) => color_1.default.green(transfer.to_name) || 'UNKNOWN',
+                },
+            });
+        }
+        core_1.ux.log();
+    }
+    displayCopies(transfers, app) {
+        const { name, status, filesize } = (0, backups_1.default)(app, this.heroku);
+        const copies = transfers.filter(t => t.from_type === 'pg_dump' && t.to_type === 'pg_restore').slice(0, 10);
+        core_1.ux.styledHeader('Copies');
+        if (copies.length === 0) {
+            core_1.ux.log(`No copies found. Use ${color_1.default.cyan.bold('heroku pg:copy')} to copy a database to another`);
+        }
+        else {
+            core_1.ux.table(copies, {
+                ID: {
+                    get: (transfer) => color_1.default.cyan(name(transfer)),
+                },
+                'Started at': {
+                    get: (transfer) => transfer.created_at,
+                },
+                Status: {
+                    get: (transfer) => status(transfer),
+                },
+                Size: {
+                    get: (transfer) => filesize(transfer.processed_bytes),
+                },
+                From: {
+                    get: (transfer) => color_1.default.green(transfer.from_name) || 'UNKNOWN',
+                },
+                To: {
+                    get: (transfer) => color_1.default.green(transfer.to_name) || 'UNKNOWN',
+                },
+            });
+        }
+        core_1.ux.log();
+    }
+}
+exports.default = Index;
+Index.topic = 'pg';
+Index.description = 'list database backups';
+Index.strict = false;
+Index.flags = {
+    verbose: command_1.flags.boolean({ char: 'v', hidden: true }),
+    confirm: command_1.flags.string({ char: 'c', hidden: true }),
+    output: command_1.flags.string({ char: 'o', hidden: true }),
+    'wait-interval': command_1.flags.string({ hidden: true }),
+    at: command_1.flags.string({ hidden: true }),
+    quiet: command_1.flags.boolean({ char: 'q', hidden: true }),
+    app: command_1.flags.app({ required: true }),
+    remote: command_1.flags.remote(),
+};

package/lib/commands/pg/backups/info.d.ts

@@ -0,0 +1,17 @@
+import { Command } from '@heroku-cli/command';
+import type { BackupTransfer } from '../../../lib/pg/types';
+export default class Info extends Command {
+    static topic: string;
+    static description: string;
+    static flags: {
+        app: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        remote: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+    };
+    static args: {
+        backup_id: import("@oclif/core/lib/interfaces/parser").Arg<string | undefined, Record<string, unknown>>;
+    };
+    getBackup: (id: string | undefined, app: string) => Promise<BackupTransfer>;
+    displayBackup: (backup: BackupTransfer, app: string) => void;
+    displayLogs: (backup: BackupTransfer) => void;
+    run(): Promise<void>;
+}