heroku 9.0.0-dev.0 → 9.1.0-beta.0

package/README.md

@@ -36,15 +36,15 @@ For other issues, [submit a support ticket](https://help.heroku.com/).
 * [`heroku access`](docs/access.md) - manage user access to apps
 * [`heroku addons`](docs/addons.md) - tools and services for developing, extending, and operating your app
 * [`heroku apps`](docs/apps.md) - manage apps on Heroku
-* [`heroku auth`](docs/auth.md) - check 2fa status
+* [`heroku auth`](docs/auth.md) - manage authentication for your Heroku account
 * [`heroku authorizations`](docs/authorizations.md) - OAuth authorizations
 * [`heroku autocomplete`](docs/autocomplete.md) - display autocomplete installation instructions
 * [`heroku buildpacks`](docs/buildpacks.md) - scripts used to compile apps
-* [`heroku certs`](docs/certs.md) - a topic for the ssl plugin
+* [`heroku certs`](docs/certs.md) - SSL certificates
 * [`heroku ci`](docs/ci.md) - test runner for Heroku Pipelines
 * [`heroku clients`](docs/clients.md) - OAuth clients on the platform
 * [`heroku config`](docs/config.md) - environment variables of apps
-* [`heroku container`](docs/container.md) - Use containers to build and deploy Heroku apps
+* [`heroku container`](docs/container.md) - deploy your Docker-based app to Heroku
 * [`heroku domains`](docs/domains.md) - custom domains for apps
 * [`heroku drains`](docs/drains.md) - forward logs to syslog or HTTPS
 * [`heroku features`](docs/features.md) - add/remove app features
@@ -62,14 +62,13 @@ For other issues, [submit a support ticket](https://help.heroku.com/).
 * [`heroku pipelines`](docs/pipelines.md) - manage pipelines
 * [`heroku plugins`](docs/plugins.md) - List installed plugins.
 * [`heroku ps`](docs/ps.md) - Client tools for Heroku Exec
-* [`heroku psql`](docs/psql.md) - open a psql shell to the database
 * [`heroku redis`](docs/redis.md) - manage heroku redis instances
 * [`heroku regions`](docs/regions.md) - list available regions for deployment
 * [`heroku releases`](docs/releases.md) - display the releases for an app
 * [`heroku reviewapps`](docs/reviewapps.md) - manage reviewapps in pipelines
 * [`heroku run`](docs/run.md) - run a one-off process inside a Heroku dyno
 * [`heroku sessions`](docs/sessions.md) - OAuth sessions
-* [`heroku spaces`](docs/spaces.md) - manage heroku private spaces
+* [`heroku spaces`](docs/spaces.md) - list available spaces
 * [`heroku status`](docs/status.md) - display current status of the Heroku platform
 * [`heroku teams`](docs/teams.md) - manage teams
 * [`heroku update`](docs/update.md) - update the Heroku CLI
@@ -85,17 +84,14 @@ This project is built with [lerna](https://lerna.js.org/). The core plugins are
 
 After cloning the repo
 1. Run `yarn` to install dependencies
-2. Run `yarn lerna bootstrap` set up Lerna and link the packages together
-    - This repo currently uses an older version of Lerna. We recommend using the version specified in the package.json instead of a newer version that you may have installed globally.
+2. Run `yarn build` to build the CLI. This will need to be re-run any time you make changes and want to test them locally.
 
 To execute Heroku CLI commands locally, use `./bin/run <command>`. For example, to run the `heroku apps` command with your local code, run `./bin/run apps` from the root directory.
 
 Testing
 =======
 
-Run all tests with `yarn lerna run test`.
-
-Run one test, in this case plugin-certs-v5, with `yarn lerna run --scope @heroku-cli/plugin-certs-v5 test`.
+Run all tests with `yarn test`.
 
 ## Debugging
 
@@ -103,7 +99,6 @@ Using WebStorm (from Jetbrains / IntelliJ), you can run/debug an individual test
 
 - Create a new run/debug configuration
 - Select the 'Mocha' type
-- Set the working directory to the directory of the package you are using.  (i.e. ~/Heroku/Repos/cli/packages/certs-v5)
 
 Releasing
 =========

package/lib/commands/access/add.d.ts

@@ -0,0 +1,14 @@
+import { Command } from '@heroku-cli/command';
+export default class AccessAdd extends Command {
+    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>;
+        permissions: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+    };
+    static examples: string[];
+    static args: {
+        email: import("@oclif/core/lib/interfaces/parser").Arg<string, Record<string, unknown>>;
+    };
+    run(): Promise<void>;
+}

package/lib/commands/access/add.js

@@ -0,0 +1,55 @@
+"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 teamUtils_1 = require("../../lib/teamUtils");
+const _ = require("lodash");
+class AccessAdd extends command_1.Command {
+    async run() {
+        var _a, _b;
+        const { flags, args } = await this.parse(AccessAdd);
+        const { email } = args;
+        const { app: appName, permissions } = flags;
+        const { body: appInfo } = await this.heroku.get(`/apps/${appName}`);
+        let output = `Adding ${color_1.default.cyan(email)} access to the app ${color_1.default.magenta(appName)}`;
+        let teamFeatures = [];
+        if ((0, teamUtils_1.isTeamApp)((_a = appInfo === null || appInfo === void 0 ? void 0 : appInfo.owner) === null || _a === void 0 ? void 0 : _a.email)) {
+            const teamName = (0, teamUtils_1.getOwner)((_b = appInfo === null || appInfo === void 0 ? void 0 : appInfo.owner) === null || _b === void 0 ? void 0 : _b.email);
+            const teamFeaturesRequest = await this.heroku.get(`/teams/${teamName}/features`);
+            teamFeatures = teamFeaturesRequest.body;
+        }
+        if (teamFeatures.some(feature => feature.name === 'org-access-controls')) {
+            if (!permissions)
+                this.error('Missing argument: permissions', { exit: 1 });
+            const permissionsArray = permissions ? permissions.split(',') : [];
+            permissionsArray.push('view');
+            const permissionsArraySorted = _.uniq(permissionsArray.sort());
+            output += ` with ${color_1.default.green(permissionsArraySorted.join(', '))} permissions`;
+            core_1.ux.action.start(output);
+            await this.heroku.post(`/teams/apps/${appName}/collaborators`, {
+                body: { user: email, permissions: permissionsArraySorted },
+            });
+            core_1.ux.action.stop();
+        }
+        else {
+            core_1.ux.action.start(output);
+            await this.heroku.post(`/apps/${appName}/collaborators`, { body: { user: email } });
+            core_1.ux.action.stop();
+        }
+    }
+}
+exports.default = AccessAdd;
+AccessAdd.description = 'add new users to your app';
+AccessAdd.flags = {
+    app: command_1.flags.app({ required: true }),
+    remote: command_1.flags.remote({ char: 'r' }),
+    permissions: command_1.flags.string({ char: 'p', description: 'list of permissions comma separated' }),
+};
+AccessAdd.examples = [
+    '$ heroku access:add user@email.com --app APP # add a collaborator to your app',
+    '$ heroku access:add user@email.com --app APP --permissions deploy,manage,operate # permissions must be comma separated',
+];
+AccessAdd.args = {
+    email: core_1.Args.string({ required: true }),
+};

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

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

package/lib/commands/access/index.js

@@ -0,0 +1,86 @@
+"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 _ = require("lodash");
+const teamUtils_1 = require("../../lib/teamUtils");
+function printJSON(collaborators) {
+    core_1.ux.log(JSON.stringify(collaborators, null, 2));
+}
+function buildTableColumns(showPermissions) {
+    const baseColumns = {
+        email: {
+            get: ({ email }) => color_1.default.cyan(email),
+        },
+        role: {
+            get: ({ role }) => color_1.default.green(role),
+        },
+    };
+    if (showPermissions) {
+        return Object.assign(Object.assign({}, baseColumns), { permissions: {} });
+    }
+    return baseColumns;
+}
+function printAccess(app, collaborators) {
+    var _a;
+    const showPermissions = (0, teamUtils_1.isTeamApp)((_a = app.owner) === null || _a === void 0 ? void 0 : _a.email);
+    collaborators = _.chain(collaborators)
+        .sortBy(c => c.email || c.user.email)
+        .reject(c => /herokumanager\.com$/.test(c.user.email))
+        .map(collab => {
+        const email = collab.user.email;
+        const role = collab.role;
+        const data = { email: email, role: role || 'collaborator' };
+        if (showPermissions) {
+            data.permissions = _.map(_.sortBy(collab.permissions, 'name'), 'name').join(', ');
+        }
+        return data;
+    })
+        .value();
+    const tableColumns = buildTableColumns(showPermissions);
+    core_1.ux.table(collaborators, tableColumns);
+}
+function buildCollaboratorsArray(collaboratorsRaw, admins) {
+    const collaboratorsNoAdmins = _.reject(collaboratorsRaw, { role: 'admin' });
+    return _.union(collaboratorsNoAdmins, admins);
+}
+class AccessIndex extends command_1.Command {
+    async run() {
+        var _a, _b;
+        const { flags, argv, args } = await this.parse(AccessIndex);
+        const { app: appName, json } = flags;
+        const { body: app } = await this.heroku.get(`/apps/${appName}`);
+        let { body: collaborators } = await this.heroku.get(`/apps/${appName}/collaborators`);
+        if ((0, teamUtils_1.isTeamApp)((_a = app.owner) === null || _a === void 0 ? void 0 : _a.email)) {
+            const teamName = (0, teamUtils_1.getOwner)((_b = app.owner) === null || _b === void 0 ? void 0 : _b.email);
+            try {
+                const { body: members } = await this.heroku.get(`/teams/${teamName}/members`);
+                let admins = members.filter(member => member.role === 'admin');
+                const { body: adminPermissions } = await this.heroku.get('/teams/permissions');
+                admins = _.forEach(admins, function (admin) {
+                    admin.user = { email: admin.email };
+                    admin.permissions = adminPermissions;
+                    return admin;
+                });
+                collaborators = buildCollaboratorsArray(collaborators, admins);
+            }
+            catch (error) {
+                if (error.statusCode !== 403)
+                    throw error;
+            }
+        }
+        if (json)
+            printJSON(collaborators);
+        else
+            printAccess(app, collaborators);
+    }
+}
+exports.default = AccessIndex;
+AccessIndex.description = 'list who has access to an app';
+AccessIndex.topic = 'access';
+AccessIndex.flags = {
+    app: command_1.flags.app({ required: true }),
+    remote: command_1.flags.remote({ char: 'r' }),
+    json: command_1.flags.boolean({ description: 'output in json format' }),
+};

package/lib/commands/access/remove.d.ts

@@ -0,0 +1,12 @@
+import { Command } from '@heroku-cli/command';
+export default class AccessRemove extends Command {
+    static description: string;
+    static example: string;
+    static topic: 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 strict: boolean;
+    run(): Promise<void>;
+}

package/lib/commands/access/remove.js

@@ -0,0 +1,25 @@
+"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");
+class AccessRemove extends command_1.Command {
+    async run() {
+        const { flags, argv } = await this.parse(AccessRemove);
+        const { app } = flags;
+        const email = argv[0];
+        const appName = app;
+        core_1.ux.action.start(`Removing ${color_1.default.cyan(email)} access from the app ${color_1.default.magenta(appName)}`);
+        await this.heroku.delete(`/apps/${appName}/collaborators/${email}`);
+        core_1.ux.action.stop();
+    }
+}
+exports.default = AccessRemove;
+AccessRemove.description = 'remove users from a team app';
+AccessRemove.example = '$ heroku access:remove user@email.com --app APP';
+AccessRemove.topic = 'access';
+AccessRemove.flags = {
+    app: command_1.flags.app({ required: true }),
+    remote: command_1.flags.remote({ char: 'r' }),
+};
+AccessRemove.strict = false;

package/lib/commands/access/update.d.ts

@@ -0,0 +1,14 @@
+import { Command } from '@heroku-cli/command';
+export default class Update extends Command {
+    static topic: string;
+    static description: string;
+    static flags: {
+        permissions: import("@oclif/core/lib/interfaces").OptionFlag<string, 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: {
+        email: import("@oclif/core/lib/interfaces/parser").Arg<string, Record<string, unknown>>;
+    };
+    run(): Promise<void>;
+}

package/lib/commands/access/update.js

@@ -0,0 +1,39 @@
+"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 teamUtils_1 = require("../../lib/teamUtils");
+class Update extends command_1.Command {
+    async run() {
+        var _a;
+        const { flags, args } = await this.parse(Update);
+        const appName = flags.app;
+        let permissions = flags.permissions.split(',');
+        const { body: appInfo } = await this.heroku.get(`/apps/${appName}`);
+        if (!(0, teamUtils_1.isTeamApp)((_a = appInfo === null || appInfo === void 0 ? void 0 : appInfo.owner) === null || _a === void 0 ? void 0 : _a.email))
+            this.error(`Error: cannot update permissions. The app ${color_1.default.cyan(appName)} is not owned by a team`);
+        permissions.push('view');
+        permissions = Array.from(new Set(permissions.sort()));
+        core_1.ux.action.start(`Updating ${args.email} in application ${color_1.default.cyan(appName)} with ${permissions} permissions`);
+        await this.heroku.patch(`/teams/apps/${appName}/collaborators/${args.email}`, {
+            body: { permissions: permissions },
+        });
+        core_1.ux.action.stop();
+    }
+}
+exports.default = Update;
+Update.topic = 'access';
+Update.description = 'update existing collaborators on an team app';
+Update.flags = {
+    permissions: command_1.flags.string({
+        char: 'p',
+        description: 'comma-delimited list of permissions to update (deploy,manage,operate)',
+        required: true,
+    }),
+    app: command_1.flags.app({ required: true }),
+    remote: command_1.flags.remote(),
+};
+Update.args = {
+    email: core_1.Args.string({ required: true }),
+};

package/lib/commands/addons/attach.d.ts

@@ -0,0 +1,16 @@
+import { Command } from '@heroku-cli/command';
+export default class Attach extends Command {
+    static topic: string;
+    static description: string;
+    static flags: {
+        as: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        credential: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        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: {
+        addon_name: import("@oclif/core/lib/interfaces/parser").Arg<string, Record<string, unknown>>;
+    };
+    run(): Promise<void>;
+}

package/lib/commands/addons/attach.js

@@ -0,0 +1,51 @@
+"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 util_1 = require("../../lib/addons/util");
+class Attach extends command_1.Command {
+    async run() {
+        const { flags, args } = await this.parse(Attach);
+        const { app, credential, as, confirm } = flags;
+        const { body: addon } = await this.heroku.get(`/addons/${encodeURIComponent(args.addon_name)}`);
+        const createAttachment = async (confirmed) => {
+            let namespace;
+            if (credential && credential !== 'default') {
+                namespace = 'credential:' + credential;
+            }
+            const body = {
+                name: as, app: { name: app }, addon: { name: addon.name }, confirm: confirmed, namespace,
+            };
+            core_1.ux.action.start(`Attaching ${credential ? color_1.default.yellow(credential) + ' of ' : ''}${color_1.default.yellow(addon.name || '')}${as ? ' as ' + color_1.default.cyan(as) : ''} to ${color_1.default.magenta(app)}`);
+            const { body: attachments } = await this.heroku.post('/addon-attachments', { body });
+            core_1.ux.action.stop();
+            return attachments;
+        };
+        if (credential && credential !== 'default') {
+            const { body: credentialConfig } = await this.heroku.get(`/addons/${addon.name}/config/credential:${encodeURIComponent(credential)}`);
+            if (credentialConfig.length === 0) {
+                throw new Error(`Could not find credential ${credential} for database ${addon.name}`);
+            }
+        }
+        const attachment = await (0, util_1.trapConfirmationRequired)(app, confirm, (confirmed) => createAttachment(confirmed));
+        core_1.ux.action.start(`Setting ${color_1.default.cyan(attachment.name || '')} config vars and restarting ${color_1.default.magenta(app)}`);
+        const { body: releases } = await this.heroku.get(`/apps/${app}/releases`, {
+            partial: true, headers: { Range: 'version ..; max=1, order=desc' },
+        });
+        core_1.ux.action.stop(`done, v${releases[0].version}`);
+    }
+}
+exports.default = Attach;
+Attach.topic = 'addons';
+Attach.description = 'attach an existing add-on resource to an app';
+Attach.flags = {
+    as: command_1.flags.string({ description: 'name for add-on attachment' }),
+    credential: command_1.flags.string({ description: 'credential name for scoped access to Heroku Postgres' }),
+    confirm: command_1.flags.string({ description: 'overwrite existing add-on attachment with same name' }),
+    app: command_1.flags.app({ required: true }),
+    remote: command_1.flags.remote(),
+};
+Attach.args = {
+    addon_name: core_1.Args.string({ required: true }),
+};

package/lib/commands/addons/create.d.ts

@@ -0,0 +1,20 @@
+import { Command } from '@heroku-cli/command';
+export default class Create extends Command {
+    static topic: string;
+    static description: string;
+    static example: string;
+    static strict: boolean;
+    static hiddenAliases: string[];
+    static flags: {
+        name: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        as: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        confirm: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        wait: 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: {
+        'service:plan': import("@oclif/core/lib/interfaces/parser").Arg<string, Record<string, unknown>>;
+    };
+    run(): Promise<void>;
+}

package/lib/commands/addons/create.js

@@ -0,0 +1,96 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+const color_1 = require("@heroku-cli/color");
+const command_1 = require("@heroku-cli/command");
+const core_1 = require("@oclif/core");
+const notify_1 = require("../../lib/notify");
+const create_addon_1 = require("../../lib/addons/create_addon");
+const tsheredoc_1 = require("tsheredoc");
+function parseConfig(args) {
+    const config = {};
+    while (args.length > 0) {
+        let key = args.shift();
+        if (!key.startsWith('--'))
+            throw new Error(`Unexpected argument ${key}`);
+        key = key.replace(/^--/, '');
+        let val;
+        if (key.includes('=')) {
+            [key, ...val] = key.split('=');
+            val = val.join('=');
+            if (val === 'true') {
+                val = true;
+            }
+            config[key] = val;
+        }
+        else {
+            val = args.shift();
+            if (!val) {
+                config[key] = true;
+            }
+            else if (val.startsWith('--')) {
+                config[key] = true;
+                args.unshift(val);
+            }
+            else {
+                config[key] = val;
+            }
+        }
+    }
+    return config;
+}
+class Create extends command_1.Command {
+    async run() {
+        var _a;
+        const _b = await this.parse(Create), { flags, args } = _b, restParse = tslib_1.__rest(_b, ["flags", "args"]);
+        const { app, name, as, wait, confirm } = flags;
+        const servicePlan = args['service:plan'];
+        const argv = restParse.argv
+            // oclif duplicates specified args in argv
+            .filter(arg => arg !== servicePlan);
+        const config = parseConfig(argv);
+        let addon;
+        try {
+            addon = await (0, create_addon_1.default)(this.heroku, app, servicePlan, confirm, wait, { config, name, as });
+            if (wait) {
+                (0, notify_1.default)(`heroku addons:create ${addon.name}`, 'Add-on successfully provisioned');
+            }
+        }
+        catch (error) {
+            if (wait) {
+                (0, notify_1.default)(`heroku addons:create ${servicePlan}`, 'Add-on failed to provision', false);
+            }
+            throw error;
+        }
+        await this.config.runHook('recache', { type: 'addon', app, addon });
+        // eslint-disable-next-line no-unsafe-optional-chaining
+        core_1.ux.log(`Use ${color_1.default.cyan.bold('heroku addons:docs ' + ((_a = addon === null || addon === void 0 ? void 0 : addon.addon_service) === null || _a === void 0 ? void 0 : _a.name) || '')} to view documentation`);
+    }
+}
+exports.default = Create;
+Create.topic = 'addons';
+Create.description = (0, tsheredoc_1.default) `
+  Create a new add-on resource.
+
+  In order to add additional config items, please place them at the end of the command after a double-dash (--).
+  `;
+Create.example = (0, tsheredoc_1.default) `
+  Create an add-on resource:
+  $heroku addons:create heroku-redis --app my-app
+
+  Create an add-on resource with additional config items:
+  $heroku addons:create heroku-postgresql:standard-0 --app my-app -- --fork DATABASE
+  `;
+Create.strict = false;
+Create.hiddenAliases = ['addons:add'];
+Create.flags = {
+    name: command_1.flags.string({ description: 'name for the add-on resource' }),
+    as: command_1.flags.string({ description: 'name for the initial add-on attachment' }),
+    confirm: command_1.flags.string({ description: 'overwrite existing config vars or existing add-on attachments' }),
+    wait: command_1.flags.boolean({ description: 'watch add-on creation status and exit when complete' }),
+    app: command_1.flags.app({ required: true }),
+    remote: command_1.flags.remote(),
+};
+Create.args = {
+    'service:plan': core_1.Args.string({ required: true }),
+};

package/lib/commands/addons/destroy.d.ts

@@ -0,0 +1,19 @@
+import { Command } from '@heroku-cli/command';
+export default class Destroy extends Command {
+    static topic: string;
+    static description: string;
+    static strict: boolean;
+    static examples: string[];
+    static hiddenAliases: string[];
+    static flags: {
+        force: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        confirm: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        wait: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        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>;
+    };
+    static args: {
+        addonName: import("@oclif/core/lib/interfaces/parser").Arg<string, Record<string, unknown>>;
+    };
+    run(): Promise<void>;
+}

package/lib/commands/addons/destroy.js

@@ -0,0 +1,61 @@
+"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 notify_1 = require("../../lib/notify");
+const confirmCommand_1 = require("../../lib/confirmCommand");
+const destroy_addon_1 = require("../../lib/addons/destroy_addon");
+const resolve_1 = require("../../lib/addons/resolve");
+const lodash_1 = require("lodash");
+class Destroy extends command_1.Command {
+    async run() {
+        var _a, _b;
+        const { flags, argv } = await this.parse(Destroy);
+        const { app, wait, confirm } = flags;
+        const force = flags.force || process.env.HEROKU_FORCE === '1';
+        const addons = await Promise.all(argv.map(name => (0, resolve_1.resolveAddon)(this.heroku, app, name)));
+        for (const addon of addons) {
+            // prevent deletion of add-on when context.app is set but the addon is attached to a different app
+            const addonApp = (_a = addon.app) === null || _a === void 0 ? void 0 : _a.name;
+            if (app && addonApp !== app) {
+                throw new Error(`${color_1.default.yellow((_b = addon.name) !== null && _b !== void 0 ? _b : '')} is on ${color_1.default.magenta(addonApp !== null && addonApp !== void 0 ? addonApp : '')} not ${color_1.default.magenta(app)}`);
+            }
+        }
+        for (const addonApps of Object.entries((0, lodash_1.groupBy)(addons, 'app.name'))) {
+            const currentAddons = addonApps[1];
+            const appName = addonApps[0];
+            await (0, confirmCommand_1.default)(appName, confirm);
+            for (const addon of currentAddons) {
+                try {
+                    await (0, destroy_addon_1.default)(this.heroku, addon, force, wait);
+                    if (wait) {
+                        (0, notify_1.default)(`heroku addons:destroy ${addon.name}`, 'Add-on successfully deprovisioned');
+                    }
+                }
+                catch (error) {
+                    if (wait) {
+                        (0, notify_1.default)(`heroku addons:destroy ${addon.name}`, 'Add-on failed to deprovision', false);
+                    }
+                    throw error;
+                }
+            }
+        }
+    }
+}
+exports.default = Destroy;
+Destroy.topic = 'addons';
+Destroy.description = 'permanently destroy an add-on resource';
+Destroy.strict = false;
+Destroy.examples = ['addons:destroy [ADDON]... [flags]'];
+Destroy.hiddenAliases = ['addons:remove'];
+Destroy.flags = {
+    force: command_1.flags.boolean({ char: 'f', description: 'allow destruction even if connected to other apps' }),
+    confirm: command_1.flags.string({ char: 'c' }),
+    wait: command_1.flags.boolean({ description: 'watch add-on destruction status and exit when complete' }),
+    app: command_1.flags.app(),
+    remote: command_1.flags.remote(),
+};
+Destroy.args = {
+    addonName: core_1.Args.string({ required: true }),
+};

package/lib/commands/addons/detach.d.ts

@@ -0,0 +1,13 @@
+import { Command } from '@heroku-cli/command';
+export default class Detach 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: {
+        attachment_name: import("@oclif/core/lib/interfaces/parser").Arg<string, Record<string, unknown>>;
+    };
+    run(): Promise<void>;
+}

package/lib/commands/addons/detach.js

@@ -0,0 +1,31 @@
+"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");
+class Detach extends command_1.Command {
+    async run() {
+        var _a, _b;
+        const { flags, args } = await this.parse(Detach);
+        const app = flags.app;
+        const { body: attachment } = await this.heroku.get(`/apps/${app}/addon-attachments/${args.attachment_name}`);
+        core_1.ux.action.start(`Detaching ${color_1.default.cyan(attachment.name || '')} to ${color_1.default.yellow(((_a = attachment.addon) === null || _a === void 0 ? void 0 : _a.name) || '')} from ${color_1.default.magenta(app)}`);
+        await this.heroku.delete(`/addon-attachments/${attachment.id}`);
+        core_1.ux.action.stop();
+        core_1.ux.action.start(`Unsetting ${color_1.default.cyan(attachment.name || '')} config vars and restarting ${color_1.default.magenta(app)}`);
+        const { body: releases } = await this.heroku.get(`/apps/${app}/releases`, {
+            partial: true, headers: { Range: 'version ..; max=1, order=desc' },
+        });
+        core_1.ux.action.stop(`done, v${((_b = releases[0]) === null || _b === void 0 ? void 0 : _b.version) || ''}`);
+    }
+}
+exports.default = Detach;
+Detach.topic = 'addons';
+Detach.description = 'detach an existing add-on resource from an app';
+Detach.flags = {
+    app: command_1.flags.app({ required: true }),
+    remote: command_1.flags.remote(),
+};
+Detach.args = {
+    attachment_name: core_1.Args.string({ required: true }),
+};