heroku 9.0.0-dev.0 → 9.0.0

package/lib/commands/apps/errors.js

@@ -0,0 +1,120 @@
+"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 lodash_1 = require("lodash");
+const error_info_1 = require("../../lib/apps/error_info");
+const colorize = (level, s) => {
+    switch (level) {
+        case 'critical':
+            return color_1.default.red(s);
+        case 'warning':
+            return color_1.default.yellow(s);
+        case 'info':
+            return color_1.default.cyan(s);
+        default:
+            return s;
+    }
+};
+function buildErrorTable(errors, source) {
+    return Object.keys(errors).map(name => {
+        const count = errors[name];
+        const info = error_info_1.default.find(e => e.name === name);
+        if (info) {
+            return { name, count, source, level: info.level, title: info.title };
+        }
+        return { name, count, source, level: 'critical', title: 'unknown error' };
+    });
+}
+const sumErrors = (errors) => {
+    const summed = {};
+    Object.keys(errors.data).forEach(key => {
+        summed[key] = (0, lodash_1.sum)(errors.data[key]);
+    });
+    return summed;
+};
+class Errors extends command_1.Command {
+    async run() {
+        const { flags } = await this.parse(Errors);
+        const hours = Number.parseInt(flags.hours);
+        const NOW = new Date().toISOString();
+        const YESTERDAY = new Date(Date.now() - (hours * 60 * 60 * 1000)).toISOString();
+        const DATE_QUERY = `start_time=${YESTERDAY}&end_time=${NOW}&step=1h`;
+        async function getAllDynoErrors(types) {
+            const values = await Promise.all(types.map(dynoErrors));
+            const memo = {};
+            types.forEach((key, index) => {
+                memo[key] = values[index];
+            });
+            return memo;
+        }
+        const routerErrors = () => {
+            return this.heroku.get(`/apps/${flags.app}/router-metrics/errors?${DATE_QUERY}&process_type=web`, {
+                hostname: 'api.metrics.herokai.com',
+            }).then(({ body }) => sumErrors(body));
+        };
+        const dynoErrors = (type) => {
+            return this.heroku.get(`/apps/${flags.app}/formation/${type}/metrics/errors?${DATE_QUERY}`, {
+                hostname: 'api.metrics.herokai.com',
+            }).catch(error => {
+                const { http } = error;
+                // eslint-disable-next-line prefer-regex-literals
+                const match = new RegExp('^invalid process_type provided', 'i');
+                if (http && http.statusCode === 400 && http.body && http.body.message && match.test(http.body.message)) {
+                    return { body: { data: {} } };
+                }
+                throw error;
+            }).then(rsp => {
+                const { body } = rsp;
+                return sumErrors(body);
+            });
+        };
+        const { body: formation } = await this.heroku.get(`/apps/${flags.app}/formation`);
+        const types = formation.map((p) => p.type);
+        const showDyno = flags.dyno || !flags.router;
+        const showRouter = flags.router || !flags.dyno;
+        const noDynoEmpty = Promise.resolve({});
+        const noRouterEmpty = Promise.resolve({});
+        const [dyno, router] = await Promise.all([
+            showDyno ? getAllDynoErrors(types) : noDynoEmpty,
+            showRouter ? routerErrors() : noRouterEmpty,
+        ]);
+        const errors = {
+            dyno,
+            router,
+        };
+        if (flags.json) {
+            core_1.ux.styledJSON(errors);
+        }
+        else {
+            let t = buildErrorTable(errors.router, 'router');
+            for (const type of Object.keys(errors.dyno)) {
+                t = t.concat(buildErrorTable(dyno[type], type));
+            }
+            if (t.length === 0) {
+                core_1.ux.log(`No errors on ${color_1.default.app(flags.app)} in the last ${hours} hours`);
+            }
+            else {
+                core_1.ux.styledHeader(`Errors on ${color_1.default.app(flags.app)} in the last ${hours} hours`);
+                core_1.ux.table(t, {
+                    source: {},
+                    name: { get: ({ name, level }) => colorize(level, name) },
+                    level: { get: ({ level }) => colorize(level, level) },
+                    title: { header: 'Desc' },
+                    count: {},
+                });
+            }
+        }
+    }
+}
+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' }),
+    dyno: command_1.flags.boolean({ description: 'show only dyno errors' }),
+};

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

@@ -3,7 +3,8 @@ export default class Add extends Command {
     static description: string;
     static topic: string;
     static flags: {
-        app: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").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>;
     };
     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

@@ -3,7 +3,8 @@ export default class Remove extends Command {
     static description: string;
     static topic: string;
     static flags: {
-        app: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").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>;
     };
     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

@@ -0,0 +1,16 @@
+import { Command } from '@heroku-cli/command';
+export default class AppsIndex extends Command {
+    static description: string;
+    static topic: string;
+    static hiddenAliases: string[];
+    static examples: string[];
+    static flags: {
+        all: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        space: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        personal: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        'internal-routing': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        team: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+    };
+    run(): Promise<void>;
+}

package/lib/commands/apps/index.js

@@ -0,0 +1,119 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const command_1 = require("@heroku-cli/command");
+const _ = require("lodash");
+const color_1 = require("@heroku-cli/color");
+const completions_1 = require("@heroku-cli/command/lib/completions");
+function annotateAppName(app) {
+    let name = `${app.name}`;
+    if (app.locked && app.internal_routing) {
+        name = `${app.name} [internal/locked]`;
+    }
+    else if (app.locked) {
+        name = `${app.name} [locked]`;
+    }
+    else if (app.internal_routing) {
+        name = `${app.name} [internal]`;
+    }
+    return name;
+}
+function regionizeAppName(app) {
+    const name = annotateAppName(app);
+    if (app.region && app.region.name !== 'us') {
+        return `${name} (${color_1.default.green(app.region.name)})`;
+    }
+    return name;
+}
+function listApps(apps) {
+    apps.forEach((app) => core_1.ux.log(regionizeAppName(app)));
+}
+function print(apps, user, space, team) {
+    if (apps.length === 0) {
+        if (space)
+            core_1.ux.log(`There are no apps in space ${color_1.default.green(space)}.`);
+        else if (team)
+            core_1.ux.log(`There are no apps in team ${color_1.default.magenta(team)}.`);
+        else
+            core_1.ux.log('You have no apps.');
+    }
+    else if (space) {
+        core_1.ux.styledHeader(`Apps in space ${color_1.default.green(space)}`);
+        listApps(apps);
+    }
+    else if (team) {
+        core_1.ux.styledHeader(`Apps in team ${color_1.default.magenta(team)}`);
+        listApps(apps);
+    }
+    else {
+        apps = _.partition(apps, (app) => app.owner.email === user.email);
+        if (apps[0].length > 0) {
+            core_1.ux.styledHeader(`${color_1.default.cyan(user.email)} Apps`);
+            listApps(apps[0]);
+        }
+        const columns = {
+            name: { get: regionizeAppName },
+            email: { get: ({ owner }) => owner.email },
+        };
+        if (apps[1].length > 0) {
+            core_1.ux.styledHeader('Collaborated Apps');
+            core_1.ux.table(apps[1], columns, { 'no-header': true });
+        }
+    }
+}
+class AppsIndex extends command_1.Command {
+    async run() {
+        const { flags } = await this.parse(AppsIndex);
+        const teamIdentifier = flags.team;
+        let team = (!flags.personal && teamIdentifier) ? teamIdentifier : null;
+        const space = flags.space;
+        const internalRouting = flags['internal-routing'];
+        if (space) {
+            const teamResponse = await this.heroku.get(`/spaces/${space}`);
+            team = teamResponse.body.team.name;
+        }
+        let path = '/users/~/apps';
+        if (team)
+            path = `/teams/${team}/apps`;
+        else if (flags.all)
+            path = '/apps';
+        const [appsResponse, userResponse] = await Promise.all([
+            this.heroku.get(path),
+            this.heroku.get('/account'),
+        ]);
+        let apps = appsResponse.body;
+        const user = userResponse.body;
+        apps = _.sortBy(apps, 'name');
+        if (space) {
+            apps = apps.filter((a) => a.space && (a.space.name === space || a.space.id === space));
+        }
+        if (internalRouting) {
+            apps = apps.filter((a) => a.internal_routing);
+        }
+        if (flags.json) {
+            core_1.ux.styledJSON(apps);
+        }
+        else {
+            print(apps, user, space, team);
+        }
+    }
+}
+exports.default = AppsIndex;
+AppsIndex.description = 'list your apps';
+AppsIndex.topic = 'apps';
+AppsIndex.hiddenAliases = ['list', 'apps:list'];
+AppsIndex.examples = [
+    '$ heroku apps',
+];
+AppsIndex.flags = {
+    all: command_1.flags.boolean({ char: 'A', description: 'include apps in all teams' }),
+    json: command_1.flags.boolean({ char: 'j', description: 'output in json format' }),
+    space: command_1.flags.string({
+        char: 's',
+        description: 'filter by space',
+        completion: completions_1.SpaceCompletion,
+    }),
+    personal: command_1.flags.boolean({ char: 'p', description: 'list apps in personal account when a default team is set' }),
+    'internal-routing': command_1.flags.boolean({ char: 'i', description: 'filter to Internal Web Apps', hidden: true }),
+    team: command_1.flags.team(),
+};

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

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

package/lib/commands/apps/info.js

@@ -0,0 +1,162 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const command_1 = require("@heroku-cli/command");
+const util = require("util");
+const _ = require("lodash");
+const filesize_1 = require("filesize");
+const { countBy, snakeCase } = _;
+function formatDate(date) {
+    return date.toISOString();
+}
+async function getInfo(app, client, extended) {
+    const promises = [
+        client.heroku.get(`/apps/${app}/addons`),
+        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 })),
+    ];
+    if (extended) {
+        promises.push(client.heroku.get(`/apps/${app}?extended=true`));
+    }
+    const [{ body: addons }, { body: appWithMoreInfo }, { body: dynos }, { body: collaborators }, { body: pipelineCouplings }, appExtendedResponse,] = await Promise.all(promises);
+    const data = {
+        addons,
+        app: appWithMoreInfo,
+        dynos,
+        collaborators,
+        pipeline_coupling: pipelineCouplings,
+    };
+    if (appExtendedResponse) {
+        data.appExtended = appExtendedResponse.body;
+    }
+    if (extended) {
+        data.appExtended.acm = data.app.acm;
+        data.app = data.appExtended;
+        delete data.appExtended;
+    }
+    return data;
+}
+function print(info, addons, collaborators, extended) {
+    const data = {};
+    data.Addons = addons;
+    data.Collaborators = collaborators;
+    if (info.app.archived_at)
+        data['Archived At'] = formatDate(new Date(info.app.archived_at));
+    if (info.app.cron_finished_at)
+        data['Cron Finished At'] = formatDate(new Date(info.app.cron_finished_at));
+    if (info.app.cron_next_run)
+        data['Cron Next Run'] = formatDate(new Date(info.app.cron_next_run));
+    if (info.app.database_size)
+        data['Database Size'] = (0, filesize_1.filesize)(info.app.database_size, { standard: 'jedec', round: 0 });
+    if (info.app.create_status !== 'complete')
+        data['Create Status'] = info.app.create_status;
+    if (info.app.space)
+        data.Space = info.app.space.name;
+    if (info.app.space && info.app.internal_routing)
+        data['Internal Routing'] = info.app.internal_routing;
+    if (info.pipeline_coupling)
+        data.Pipeline = `${info.pipeline_coupling.pipeline.name} - ${info.pipeline_coupling.stage}`;
+    data['Auto Cert Mgmt'] = info.app.acm;
+    data['Git URL'] = info.app.git_url;
+    data['Web URL'] = info.app.web_url;
+    data['Repo Size'] = (0, filesize_1.filesize)(info.app.repo_size, { standard: 'jedec', round: 0 });
+    data['Slug Size'] = (0, filesize_1.filesize)(info.app.slug_size, { standard: 'jedec', round: 0 });
+    data.Owner = info.app.owner.email;
+    data.Region = info.app.region.name;
+    data.Dynos = countBy(info.dynos, 'type');
+    data.Stack = (function (app) {
+        let stack = info.app.stack.name;
+        if (app.stack.name !== app.build_stack.name) {
+            stack += ` (next build will use ${app.build_stack.name})`;
+        }
+        return stack;
+    })(info.app);
+    core_1.ux.styledHeader(info.app.name);
+    core_1.ux.styledObject(data);
+    if (extended) {
+        core_1.ux.log('\n\n--- Extended Information ---\n\n');
+        if (info.app.extended) {
+            core_1.ux.log(util.inspect(info.app.extended));
+        }
+    }
+}
+class AppsInfo extends command_1.Command {
+    async run() {
+        const { flags, args } = await this.parse(AppsInfo);
+        const app = args.app || flags.app;
+        if (!app)
+            throw new Error('No app specified.\nUSAGE: heroku apps:info --app my-app');
+        const info = await getInfo(app, this, flags.extended);
+        const addons = info.addons.map((a) => { var _a; return (_a = a.plan) === null || _a === void 0 ? void 0 : _a.name; }).sort();
+        const collaborators = info.collaborators.map((c) => c.user.email)
+            .filter((c) => c !== info.app.owner.email)
+            .sort();
+        function shell() {
+            function print(k, v) {
+                core_1.ux.log(`${snakeCase(k)}=${v}`);
+            }
+            print('auto_cert_mgmt', info.app.acm);
+            print('addons', addons);
+            print('collaborators', collaborators);
+            if (info.app.archived_at)
+                print('archived_at', formatDate(new Date(info.app.archived_at)));
+            if (info.app.cron_finished_at)
+                print('cron_finished_at', formatDate(new Date(info.app.cron_finished_at)));
+            if (info.app.cron_next_run)
+                print('cron_next_run', formatDate(new Date(info.app.cron_next_run)));
+            if (info.app.database_size)
+                print('database_size', (0, filesize_1.filesize)(info.app.database_size, { standard: 'jedec', round: 0 }));
+            if (info.app.create_status !== 'complete')
+                print('create_status', info.app.create_status);
+            if (info.pipeline_coupling)
+                print('pipeline', `${info.pipeline_coupling.pipeline.name}:${info.pipeline_coupling.stage}`);
+            print('git_url', info.app.git_url);
+            print('web_url', info.app.web_url);
+            print('repo_size', (0, filesize_1.filesize)(info.app.repo_size, { standard: 'jedec', round: 0 }));
+            print('slug_size', (0, filesize_1.filesize)(info.app.slug_size, { standard: 'jedec', round: 0 }));
+            print('owner', info.app.owner.email);
+            print('region', info.app.region.name);
+            print('dynos', util.inspect(countBy(info.dynos, 'type')));
+            print('stack', info.app.stack.name);
+        }
+        if (flags.shell) {
+            shell();
+        }
+        else if (flags.json) {
+            core_1.ux.styledJSON(info);
+        }
+        else {
+            print(info, addons, collaborators, flags.extended);
+        }
+    }
+}
+exports.default = AppsInfo;
+AppsInfo.description = 'show detailed app information';
+AppsInfo.topic = 'apps';
+AppsInfo.hiddenAliases = ['info'];
+AppsInfo.examples = [
+    '$ heroku apps:info',
+    '$ heroku apps:info --shell',
+];
+AppsInfo.help = `$ heroku apps:info
+=== example
+Git URL:   https://git.heroku.com/example.git
+Repo Size: 5M
+...
+
+$ heroku apps:info --shell
+git_url=https://git.heroku.com/example.git
+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' }),
+};
+AppsInfo.args = {
+    app: core_1.Args.string({ hidden: true }),
+};

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

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

package/lib/commands/apps/open.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const command_1 = require("@heroku-cli/command");
+const open = require("open");
+class AppsOpen extends command_1.Command {
+    async run() {
+        const { flags, args } = await this.parse(AppsOpen);
+        const appResponse = await this.heroku.get(`/apps/${flags.app}`);
+        const app = appResponse.body;
+        const path = args.path || '';
+        const url = new URL(path, app.web_url);
+        await open(url.toString());
+    }
+}
+exports.default = AppsOpen;
+AppsOpen.description = 'open the app in a web browser';
+AppsOpen.topic = 'apps';
+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 }),
+};

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

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