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

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

@@ -0,0 +1,28 @@
+import { Command } from '@heroku-cli/command';
+import type { Plan } from '@heroku-cli/schema';
+export default class Upgrade extends Command {
+    static aliases: string[];
+    static topic: string;
+    static description: string;
+    static examples: 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>;
+    };
+    static args: {
+        addon: import("@oclif/core/lib/interfaces/parser").Arg<string, Record<string, unknown>>;
+        plan: import("@oclif/core/lib/interfaces/parser").Arg<string | undefined, Record<string, unknown>>;
+    };
+    private parsed;
+    run(): Promise<void>;
+    protected getAddonPartsFromArgs(args: {
+        addon: string;
+        plan: string | undefined;
+    }): {
+        plan: string;
+        addon: string;
+    };
+    protected buildNoPlanError(addon: string): string;
+    protected buildApiErrorMessage(errorMessage: string, ctx: Awaited<typeof this.parsed>): string;
+    protected getPlans(addonServiceName: string | undefined): Promise<Plan[]>;
+}

package/lib/commands/addons/upgrade.js

@@ -0,0 +1,145 @@
+"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");
+const resolve_1 = require("../../lib/addons/resolve");
+const api_client_1 = require("@heroku-cli/command/lib/api-client");
+class Upgrade extends command_1.Command {
+    constructor() {
+        super(...arguments);
+        this.parsed = this.parse(Upgrade);
+    }
+    async run() {
+        var _a, _b;
+        const ctx = await this.parsed;
+        const { flags: { app }, args } = ctx;
+        // called with just one argument in the form of `heroku addons:upgrade heroku-redis:hobby`
+        const { addon, plan } = this.getAddonPartsFromArgs(args);
+        let resolvedAddon;
+        try {
+            resolvedAddon = await (0, resolve_1.addonResolver)(this.heroku, app, addon);
+        }
+        catch (error) {
+            if (error instanceof api_client_1.HerokuAPIError && error.http.statusCode === 422 && error.body.id === 'multiple_matches') {
+                throw new Error(this.buildApiErrorMessage(error.http.body.message, ctx));
+            }
+            throw error;
+        }
+        const { name: addonServiceName } = resolvedAddon.addon_service;
+        const { name: appName } = resolvedAddon.app;
+        const { name: addonName, plan: resolvedAddonPlan } = resolvedAddon !== null && resolvedAddon !== void 0 ? resolvedAddon : {};
+        const updatedPlanName = `${addonServiceName}:${plan}`;
+        core_1.ux.action.start(`Changing ${color_1.default.magenta(addonName !== null && addonName !== void 0 ? addonName : '')} on ${color_1.default.cyan(appName !== null && appName !== void 0 ? appName : '')} from ${color_1.default.blue((_a = resolvedAddonPlan === null || resolvedAddonPlan === void 0 ? void 0 : resolvedAddonPlan.name) !== null && _a !== void 0 ? _a : '')} to ${color_1.default.blue(updatedPlanName)}`);
+        try {
+            const patchResult = await this.heroku.patch(`/apps/${appName}/addons/${addonName}`, {
+                body: { plan: { name: updatedPlanName } },
+                headers: {
+                    'Accept-Expansion': 'plan', 'X-Heroku-Legacy-Provider-Messages': 'true',
+                },
+            });
+            resolvedAddon = patchResult.body;
+        }
+        catch (error) {
+            let errorToThrow = error;
+            if (error instanceof api_client_1.HerokuAPIError) {
+                const { http } = error;
+                if (http.statusCode === 422 &&
+                    http.body.message &&
+                    http.body.message.startsWith('Couldn\'t find either the add-on')) {
+                    const plans = await this.getPlans(addonServiceName);
+                    errorToThrow = new Error(`${http.body.message}
+
+Here are the available plans for ${color_1.default.yellow(addonServiceName || '')}:
+${plans.map(plan => plan.name).join('\n')}\n\nSee more plan information with ${color_1.default.blue('heroku addons:plans ' + addonServiceName)}
+
+${color_1.default.cyan('https://devcenter.heroku.com/articles/managing-add-ons')}`);
+                }
+                core_1.ux.action.stop();
+                throw errorToThrow;
+            }
+        }
+        core_1.ux.action.stop(`done${((_b = resolvedAddon.plan) === null || _b === void 0 ? void 0 : _b.price) ? `, ${(0, util_1.formatPriceText)(resolvedAddon.plan.price)}` : ''}`);
+        if (resolvedAddon.provision_message) {
+            core_1.ux.log(resolvedAddon.provision_message);
+        }
+    }
+    getAddonPartsFromArgs(args) {
+        let { addon, plan } = args;
+        if (!plan && addon.includes(':')) {
+            ([addon, plan] = addon.split(':'));
+        }
+        if (!plan) {
+            throw new Error(this.buildNoPlanError(addon));
+        }
+        // ignore the service part of the plan since we can infer the service based on the add-on
+        if (plan.includes(':')) {
+            plan = plan.split(':')[1];
+        }
+        return { plan, addon };
+    }
+    buildNoPlanError(addon) {
+        return `Error: No plan specified.
+You need to specify a plan to move ${color_1.default.yellow(addon)} to.
+For example: ${color_1.default.blue('heroku addons:upgrade heroku-redis:premium-0')}
+${color_1.default.cyan('https://devcenter.heroku.com/articles/managing-add-ons')}`;
+    }
+    buildApiErrorMessage(errorMessage, ctx) {
+        const { flags: { app }, args: { addon, plan } } = ctx;
+        const example = errorMessage.split(', ')[2] || 'redis-triangular-1234';
+        return `${errorMessage}
+
+Multiple add-ons match ${color_1.default.yellow(addon)}${app ? ' on ' + app : ''}
+It is not clear which add-on's plan you are trying to change.
+
+Specify the add-on name instead of the name of the add-on service.
+For example, instead of: ${color_1.default.blue('heroku addons:upgrade ' + addon + ' ' + (plan || ''))}
+Run this: ${color_1.default.blue('heroku addons:upgrade ' + example + ' ' + addon + ':' + plan)}
+${app ? '' : 'Alternatively, specify an app to filter by with ' + color_1.default.blue('--app')}
+${color_1.default.cyan('https://devcenter.heroku.com/articles/managing-add-ons')}`;
+    }
+    async getPlans(addonServiceName) {
+        try {
+            const plansResponse = await this.heroku.get(`/addon-services/${addonServiceName}/plans`);
+            const { body: plans } = plansResponse;
+            plans.sort((a, b) => {
+                var _a, _b, _c, _d;
+                if (((_a = a === null || a === void 0 ? void 0 : a.price) === null || _a === void 0 ? void 0 : _a.cents) === ((_b = b === null || b === void 0 ? void 0 : b.price) === null || _b === void 0 ? void 0 : _b.cents)) {
+                    return 0;
+                }
+                if (!((_c = a === null || a === void 0 ? void 0 : a.price) === null || _c === void 0 ? void 0 : _c.cents) || !((_d = b === null || b === void 0 ? void 0 : b.price) === null || _d === void 0 ? void 0 : _d.cents) || a.price.cents > b.price.cents) {
+                    return 1;
+                }
+                if (a.price.cents < b.price.cents) {
+                    return -1;
+                }
+                return 0;
+            });
+            return plans;
+        }
+        catch (_a) {
+            return [];
+        }
+    }
+}
+exports.default = Upgrade;
+Upgrade.aliases = ['addons:downgrade'];
+Upgrade.topic = 'addons';
+Upgrade.description = `change add-on plan.
+  See available plans with \`heroku addons:plans SERVICE\`.
+
+  Note that \`heroku addons:upgrade\` and \`heroku addons:downgrade\` are the same.\
+  Either one can be used to change an add-on plan up or down.
+
+  https://devcenter.heroku.com/articles/managing-add-ons
+  `;
+Upgrade.examples = ['Upgrade an add-on by service name:\n$ heroku addons:upgrade heroku-redis:premium-2\n\nUpgrade a specific add-on:\n$ heroku addons:upgrade swimming-briskly-123 heroku-redis:premium-2'];
+Upgrade.flags = {
+    app: command_1.flags.app(),
+    remote: command_1.flags.remote(),
+};
+Upgrade.args = {
+    addon: core_1.Args.string({ required: true }),
+    plan: core_1.Args.string(),
+};

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

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

package/lib/commands/addons/wait.js

@@ -0,0 +1,70 @@
+"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 resolve_1 = require("../../lib/addons/resolve");
+const addons_wait_1 = require("../../lib/addons/addons_wait");
+const notify_1 = require("../../lib/notify");
+class Wait extends command_1.Command {
+    async run() {
+        const { flags, args } = await this.parse(Wait);
+        let addonsToWaitFor;
+        if (args.addon) {
+            addonsToWaitFor = [await (0, resolve_1.resolveAddon)(this.heroku, flags.app, args.addon)];
+        }
+        else if (flags.app) {
+            const { body: addons } = await this.heroku.get(`/apps/${flags.app}/addons`);
+            addonsToWaitFor = addons;
+        }
+        else {
+            const { body: addons } = await this.heroku.get('/addons');
+            addonsToWaitFor = addons;
+        }
+        addonsToWaitFor = addonsToWaitFor.filter((addon) => addon.state === 'provisioning' || addon.state === 'deprovisioning');
+        let interval = Number.parseInt(flags['wait-interval'] || '', 10);
+        if (!interval || interval < 0) {
+            interval = 5;
+        }
+        for (const addon of addonsToWaitFor) {
+            const startTime = new Date();
+            const addonName = addon.name || '';
+            if (addon.state === 'provisioning') {
+                let addonResponse;
+                try {
+                    addonResponse = await (0, addons_wait_1.waitForAddonProvisioning)(this.heroku, addon, interval);
+                }
+                catch (error) {
+                    (0, notify_1.default)(`heroku addons:wait ${addonName}`, 'Add-on failed to provision', false);
+                    throw error;
+                }
+                const configVars = (addonResponse.config_vars || []);
+                if (configVars.length > 0) {
+                    const decoratedConfigVars = configVars.map(c => color_1.default.green(c))
+                        .join(', ');
+                    core_1.ux.log(`Created ${color_1.default.yellow(addonName)} as ${decoratedConfigVars}`);
+                }
+                if (Date.now() - startTime.valueOf() >= 1000 * 5) {
+                    (0, notify_1.default)(`heroku addons:wait ${addonName}`, 'Add-on successfully provisioned');
+                }
+            }
+            else if (addon.state === 'deprovisioning') {
+                await (0, addons_wait_1.waitForAddonDeprovisioning)(this.heroku, addon, interval);
+                if (Date.now() - startTime.valueOf() >= 1000 * 5) {
+                    (0, notify_1.default)(`heroku addons:wait ${addonName}`, 'Add-on successfully deprovisioned');
+                }
+            }
+        }
+    }
+}
+exports.default = Wait;
+Wait.topic = 'addons';
+Wait.description = 'show provisioning status of the add-ons on the app';
+Wait.flags = {
+    'wait-interval': command_1.flags.string({ description: 'how frequently to poll in seconds' }),
+    app: command_1.flags.app(),
+    remote: command_1.flags.remote(),
+};
+Wait.args = {
+    addon: core_1.Args.string(),
+};

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

@@ -2,10 +2,10 @@ import { Command } from '@heroku-cli/command';
 import { Interfaces } from '@oclif/core';
 export default class Create extends Command {
     static description: string;
-    static aliases: string[];
+    static hiddenAliases: string[];
     static examples: string[];
     static args: {
-        apps: import("@oclif/core/lib/interfaces/parser").Arg<string | undefined, Record<string, unknown>>;
+        app: import("@oclif/core/lib/interfaces/parser").Arg<string | undefined, Record<string, unknown>>;
     };
     static flags: {
         app: Interfaces.OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;

package/lib/commands/apps/create.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-const js_yaml_1 = require("js-yaml");
+const yaml = require("js-yaml");
 const fs_extra_1 = require("fs-extra");
 const command_1 = require("@heroku-cli/command");
 const completions_1 = require("@heroku-cli/command/lib/completions");
@@ -115,7 +115,7 @@ async function runFromFlags(context, heroku, config) {
 }
 async function readManifest() {
     const buffer = await (0, fs_extra_1.readFile)('heroku.yml');
-    return (0, js_yaml_1.load)(buffer.toString(), { filename: 'heroku.yml' });
+    return yaml.load(buffer.toString(), { filename: 'heroku.yml' });
 }
 async function runFromManifest(context, heroku) {
     const { flags, args } = context;
@@ -147,7 +147,7 @@ class Create extends command_1.Command {
 }
 exports.default = Create;
 Create.description = 'creates a new app';
-Create.aliases = ['create'];
+Create.hiddenAliases = ['create'];
 Create.examples = [
     `$ heroku apps:create
 Creating app... done, stack is heroku-22
@@ -172,20 +172,27 @@ $ heroku apps:create example-staging --remote staging
 $ heroku apps:create --region eu`,
 ];
 Create.args = {
-    apps: core_1.Args.string({ description: 'name of app to create', required: false }),
+    app: core_1.Args.string({ description: 'name of app to create', required: false }),
 };
 Create.flags = {
     // `app` set to `flags.string` instead of `flags.app` to maintain original v5 functionality and avoid a default value from the git remote set when used without an app
     app: command_1.flags.string({ hidden: true }),
     addons: command_1.flags.string({ description: 'comma-delimited list of addons to install' }),
-    buildpack: command_1.flags.string({ char: 'b', description: 'buildpack url to use for this app', completion: completions_1.BuildpackCompletion }),
+    buildpack: command_1.flags.string({
+        char: 'b',
+        description: 'buildpack url to use for this app',
+        completion: completions_1.BuildpackCompletion,
+    }),
     manifest: command_1.flags.boolean({ char: 'm', description: 'use heroku.yml settings for this app', hidden: true }),
     'no-remote': command_1.flags.boolean({ char: 'n', description: 'do not create a git remote' }),
     remote: command_1.flags.remote({ description: 'the git remote to create, default "heroku"', default: 'heroku' }),
     stack: command_1.flags.string({ char: 's', description: 'the stack to create the app on', completion: completions_1.StackCompletion }),
     space: command_1.flags.string({ description: 'the private space to create the app in', completion: completions_1.SpaceCompletion }),
     region: command_1.flags.string({ description: 'specify region for the app to run in', completion: completions_1.RegionCompletion }),
-    'internal-routing': command_1.flags.boolean({ hidden: true, description: 'private space-only. create as an Internal Web App that is only routable in the local network.' }),
+    'internal-routing': command_1.flags.boolean({
+        hidden: true,
+        description: 'private space-only. create as an Internal Web App that is only routable in the local network.',
+    }),
     features: command_1.flags.string({ hidden: true }),
     kernel: command_1.flags.string({ hidden: true }),
     locked: command_1.flags.boolean({ hidden: true }),

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

@@ -2,9 +2,10 @@ import { Command } from '@heroku-cli/command';
 export default class Destroy extends Command {
     static description: string;
     static help: string;
-    static aliases: string[];
+    static hiddenAliases: 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>;
         confirm: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
     };
     static args: {

package/lib/commands/apps/destroy.js

@@ -4,7 +4,7 @@ const color_1 = require("@heroku-cli/color");
 const command_1 = require("@heroku-cli/command");
 const core_1 = require("@oclif/core");
 const lodash_1 = require("lodash");
-const confirm_app_1 = require("../../lib/apps/confirm-app");
+const confirmCommand_1 = require("../../lib/confirmCommand");
 const git = require("../../lib/ci/git");
 class Destroy extends command_1.Command {
     async run() {
@@ -14,7 +14,7 @@ class Destroy extends command_1.Command {
             throw new Error('No app specified.\nUSAGE: heroku apps:destroy APPNAME');
         // this appears to report errors if app not found
         await this.heroku.get(`/apps/${app}`);
-        await (0, confirm_app_1.default)(app, flags.confirm, `WARNING: This will delete ${color_1.default.app(app)} including all add-ons.`);
+        await (0, confirmCommand_1.default)(app, flags.confirm, `WARNING: This will delete ${color_1.default.app(app)} including all add-ons.`);
         core_1.ux.action.start(`Destroying ${color_1.default.app(app)} (including all add-ons)`);
         await this.heroku.delete(`/apps/${app}`);
         if (git.inGitRepo()) {
@@ -36,9 +36,10 @@ class Destroy extends command_1.Command {
 exports.default = Destroy;
 Destroy.description = 'permanently destroy an app';
 Destroy.help = 'This will also destroy all add-ons on the app.';
-Destroy.aliases = ['destroy', 'apps:delete'];
+Destroy.hiddenAliases = ['destroy', 'apps:delete'];
 Destroy.flags = {
     app: command_1.flags.app(),
+    remote: command_1.flags.remote(),
     confirm: command_1.flags.string({ char: 'c' }),
 };
 Destroy.args = {

package/lib/commands/apps/errors.d.ts

@@ -3,6 +3,7 @@ export default class Errors 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>;
         json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
         hours: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
         router: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;

package/lib/commands/apps/errors.js

@@ -112,6 +112,7 @@ exports.default = Errors;
 Errors.description = 'view app errors';
 Errors.flags = {
     app: command_1.flags.app({ required: true }),
+    remote: command_1.flags.remote(),
     json: command_1.flags.boolean({ description: 'output in json format' }),
     hours: command_1.flags.string({ description: 'number of hours to look back (default 24)', default: '24' }),
     router: command_1.flags.boolean({ description: 'show only router errors' }),

package/lib/commands/apps/favorites/add.d.ts

@@ -4,6 +4,7 @@ export default class Add extends Command {
     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>;
     };
     run(): Promise<void>;
 }

package/lib/commands/apps/favorites/add.js

@@ -34,4 +34,5 @@ Add.description = 'favorites an app';
 Add.topic = 'apps';
 Add.flags = {
     app: command_1.flags.app({ required: true }),
+    remote: command_1.flags.remote(),
 };

package/lib/commands/apps/favorites/remove.d.ts

@@ -4,6 +4,7 @@ export default class Remove extends Command {
     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>;
     };
     run(): Promise<void>;
 }

package/lib/commands/apps/favorites/remove.js

@@ -24,4 +24,5 @@ Remove.description = 'unfavorites an app';
 Remove.topic = 'apps';
 Remove.flags = {
     app: command_1.flags.app({ required: true }),
+    remote: command_1.flags.remote(),
 };

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

@@ -2,7 +2,7 @@ import { Command } from '@heroku-cli/command';
 export default class AppsIndex extends Command {
     static description: string;
     static topic: string;
-    static aliases: string[];
+    static hiddenAliases: string[];
     static examples: string[];
     static flags: {
         all: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;

package/lib/commands/apps/index.js

@@ -101,7 +101,7 @@ class AppsIndex extends command_1.Command {
 exports.default = AppsIndex;
 AppsIndex.description = 'list your apps';
 AppsIndex.topic = 'apps';
-AppsIndex.aliases = ['list', 'apps:list'];
+AppsIndex.hiddenAliases = ['list', 'apps:list'];
 AppsIndex.examples = [
     '$ heroku apps',
 ];

package/lib/commands/apps/info.d.ts

@@ -2,11 +2,12 @@ import { Command } from '@heroku-cli/command';
 export default class AppsInfo extends Command {
     static description: string;
     static topic: string;
-    static aliases: string[];
+    static hiddenAliases: string[];
     static examples: string[];
     static help: 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>;
         shell: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
         extended: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
         json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;

package/lib/commands/apps/info.js

@@ -12,9 +12,7 @@ function formatDate(date) {
 async function getInfo(app, client, extended) {
     const promises = [
         client.heroku.get(`/apps/${app}/addons`),
-        client.heroku.request(`/apps/${app}`, {
-            headers: { Accept: 'application/vnd.heroku+json; version=3.cedar-acm' },
-        }),
+        client.heroku.request(`/apps/${app}`),
         client.heroku.get(`/apps/${app}/dynos`).catch(() => ({ body: [] })),
         client.heroku.get(`/apps/${app}/collaborators`).catch(() => ({ body: [] })),
         client.heroku.get(`/apps/${app}/pipeline-couplings`).catch(() => ({ body: null })),
@@ -137,7 +135,7 @@ class AppsInfo extends command_1.Command {
 exports.default = AppsInfo;
 AppsInfo.description = 'show detailed app information';
 AppsInfo.topic = 'apps';
-AppsInfo.aliases = ['info'];
+AppsInfo.hiddenAliases = ['info'];
 AppsInfo.examples = [
     '$ heroku apps:info',
     '$ heroku apps:info --shell',
@@ -154,6 +152,7 @@ repo_size=5000000
 ...`;
 AppsInfo.flags = {
     app: command_1.flags.app(),
+    remote: command_1.flags.remote(),
     shell: command_1.flags.boolean({ char: 's', description: 'output more shell friendly key/value pairs' }),
     extended: command_1.flags.boolean({ char: 'x', hidden: true }),
     json: command_1.flags.boolean({ char: 'j', description: 'output in json format' }),

package/lib/commands/apps/join.d.ts

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

package/lib/commands/apps/join.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 AppsJoin extends command_1.Command {
+    async run() {
+        const { flags } = await this.parse(AppsJoin);
+        const { app } = flags;
+        core_1.ux.action.start(`Joining ${color_1.default.cyan(app)}`);
+        const { body: user } = await this.heroku.get('/account');
+        await this.heroku.post(`/teams/apps/${app}/collaborators`, {
+            body: { user: user.email },
+        });
+        core_1.ux.action.stop();
+    }
+}
+exports.default = AppsJoin;
+AppsJoin.topic = 'apps';
+AppsJoin.description = 'add yourself to a team app';
+AppsJoin.aliases = ['join'];
+AppsJoin.flags = {
+    app: command_1.flags.app({ required: true }),
+    remote: command_1.flags.remote({ char: 'r' }),
+};

package/lib/commands/apps/leave.d.ts

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

package/lib/commands/apps/leave.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 Leave extends command_1.Command {
+    async run() {
+        const { flags } = await this.parse(Leave);
+        const { app } = flags;
+        const request = await this.heroku.get('/account');
+        core_1.ux.action.start(`Leaving ${color_1.default.cyan(app)}`);
+        const { body: account } = request;
+        await this.heroku.delete(`/apps/${app}/collaborators/${encodeURIComponent(account.email)}`);
+        core_1.ux.action.stop();
+    }
+}
+exports.default = Leave;
+Leave.topic = 'apps';
+Leave.aliases = ['leave'];
+Leave.description = 'remove yourself from a team app';
+Leave.example = 'heroku apps:leave -a APP';
+Leave.flags = {
+    app: command_1.flags.app({ required: true }),
+    remote: command_1.flags.remote(),
+};

package/lib/commands/apps/lock.d.ts

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

package/lib/commands/apps/lock.js

@@ -0,0 +1,30 @@
+"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 AppsLock extends command_1.Command {
+    async run() {
+        var _a;
+        const { flags } = await this.parse(AppsLock);
+        const { app } = flags;
+        const { body: appResponse } = await this.heroku.get(`/teams/apps/${app}`);
+        const appName = (_a = appResponse.name) !== null && _a !== void 0 ? _a : app;
+        if (appResponse.locked) {
+            throw new Error(`Error: cannot lock ${color_1.default.cyan(appName)}.\nThis app is already locked.`);
+        }
+        core_1.ux.action.start(`Locking ${color_1.default.cyan(appName)}`);
+        await this.heroku.patch(`/teams/apps/${appName}`, {
+            body: { locked: true },
+        });
+        core_1.ux.action.stop();
+    }
+}
+exports.default = AppsLock;
+AppsLock.topic = 'apps';
+AppsLock.description = 'prevent team members from joining an app';
+AppsLock.aliases = ['lock'];
+AppsLock.flags = {
+    app: command_1.flags.app({ required: true }),
+    remote: command_1.flags.remote(),
+};

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

@@ -2,10 +2,11 @@ import { Command } from '@heroku-cli/command';
 export default class AppsOpen extends Command {
     static description: string;
     static topic: string;
-    static aliases: string[];
+    static hiddenAliases: string[];
     static examples: 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: {
         path: import("@oclif/core/lib/interfaces/parser").Arg<string | undefined, Record<string, unknown>>;

package/lib/commands/apps/open.js

@@ -16,13 +16,14 @@ class AppsOpen extends command_1.Command {
 exports.default = AppsOpen;
 AppsOpen.description = 'open the app in a web browser';
 AppsOpen.topic = 'apps';
-AppsOpen.aliases = ['open'];
+AppsOpen.hiddenAliases = ['open'];
 AppsOpen.examples = [
     '$ heroku open -a myapp',
     '$ heroku open -a myapp /foo',
 ];
 AppsOpen.flags = {
     app: command_1.flags.app({ required: true }),
+    remote: command_1.flags.remote(),
 };
 AppsOpen.args = {
     path: core_1.Args.string({ required: false }),