heroku 10.0.0-alpha.0 → 10.0.0-alpha.2

package/lib/commands/releases/output.js

@@ -33,5 +33,5 @@ Output.flags = {
     app: command_1.flags.app({ required: true }),
 };
 Output.args = {
-    release: core_1.Args.string(),
+    release: core_1.Args.string({ description: 'ID of the release. If omitted, we use the last release ID.' }),
 };

package/lib/commands/releases/rollback.js

@@ -10,8 +10,18 @@ class Rollback extends command_1.Command {
         const { flags, args } = await this.parse(Rollback);
         const { app } = flags;
         const release = await (0, releases_1.findByPreviousOrId)(this.heroku, app, args.release);
-        core_1.ux.action.start(`Rolling back ${color_1.default.magenta(app)} to ${color_1.default.green('v' + release.version)}`);
-        const { body: latest } = await this.heroku.post(`/apps/${app}/releases`, { body: { release: release.id } });
+        if (!release) {
+            core_1.ux.error(`No eligible release found for ${color_1.default.app(app)} to roll back to.`);
+        }
+        core_1.ux.action.start(`Rolling back ${color_1.default.app(app)} to ${color_1.default.green('v' + release.version)}`);
+        const { body: latest } = await this.heroku.post(`/apps/${app}/releases`, {
+            body: {
+                release: release.id,
+            },
+            headers: {
+                Accept: 'application/vnd.heroku+json; version=3.sdk',
+            },
+        });
         const streamUrl = latest.output_stream_url;
         core_1.ux.action.stop(`done, ${color_1.default.green('v' + latest.version)}`);
         core_1.ux.warn("Rollback affects code and config vars; it doesn't add or remove addons.");
@@ -37,12 +47,12 @@ Rollback.topic = 'releases';
 Rollback.hiddenAliases = ['rollback'];
 Rollback.description = `Roll back to a previous release.
 
-    If RELEASE is not specified, it will roll back one release.
+    If RELEASE is not specified, it will roll back to the last eligible release.
     `;
 Rollback.flags = {
     remote: command_1.flags.remote(),
     app: command_1.flags.app({ required: true }),
 };
 Rollback.args = {
-    release: core_1.Args.string(),
+    release: core_1.Args.string({ description: 'ID of the release. If omitted, we use the last eligible release.' }),
 };

package/lib/commands/sessions/destroy.js

@@ -14,5 +14,5 @@ class SessionsDestroy extends command_1.Command {
 exports.default = SessionsDestroy;
 SessionsDestroy.description = 'delete (logout) OAuth session by ID';
 SessionsDestroy.args = {
-    id: core_1.Args.string({ required: true }),
+    id: core_1.Args.string({ required: true, description: 'ID of the OAuth session' }),
 };

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

@@ -7,6 +7,7 @@ export default class Create extends Command {
         channel: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
         cidr: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
         'data-cidr': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        features: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
         generation: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
         'kpi-url': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
         'log-drain-url': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;

package/lib/commands/spaces/create.js

@@ -6,6 +6,7 @@ const core_1 = require("@oclif/core");
 const tsheredoc_1 = require("tsheredoc");
 const spaces_1 = require("../../lib/spaces/spaces");
 const completions_1 = require("../../lib/autocomplete/completions");
+const parsers_1 = require("../../lib/spaces/parsers");
 class Create extends command_1.Command {
     async run() {
         const { flags, args } = await this.parse(Create);
@@ -29,7 +30,7 @@ class Create extends command_1.Command {
                 channel_name: channel,
                 cidr,
                 data_cidr: dataCidr,
-                // features: splitCsv(features),
+                features: (0, parsers_1.splitCsv)(features),
                 generation,
                 kpi_url: kpiUrl,
                 log_drain_url: logDrainUrl,
@@ -65,13 +66,14 @@ Create.examples = [(0, tsheredoc_1.default) `
     CIDR:       10.0.0.0/16
     Data CIDR:  172.23.0.0/20
     State:      allocating
+    Generation: cedar
     Created at: 2016-01-06T03:23:13Z
   `];
 Create.flags = {
     channel: command_1.flags.string({ hidden: true }),
     cidr: command_1.flags.string({ description: 'RFC-1918 CIDR the space will use' }),
     'data-cidr': command_1.flags.string({ description: 'RFC-1918 CIDR used by Heroku Data resources for the space' }),
-    // features: flags.string({hidden: true, description: 'a list of features separated by commas'}),
+    features: command_1.flags.string({ hidden: true, description: 'a list of features separated by commas' }),
     generation: command_1.flags.string({ description: 'generation for space', default: 'cedar', options: ['cedar', 'fir'] }),
     'kpi-url': command_1.flags.string({ hidden: true, description: 'self-managed KPI endpoint to use' }),
     'log-drain-url': command_1.flags.string({ hidden: true, description: 'direct log drain url' }),

package/lib/commands/spaces/drains/set.js

@@ -25,5 +25,5 @@ Set.flags = {
     space: command_1.flags.string({ char: 's', description: 'space for which to set log drain', required: true }),
 };
 Set.args = {
-    url: core_1.Args.string({ required: true }),
+    url: core_1.Args.string({ required: true, description: 'URL to replace the log drain with' }),
 };

package/lib/commands/spaces/trusted-ips/add.js

@@ -9,15 +9,12 @@ class Add extends command_1.Command {
         const { flags, args } = await this.parse(Add);
         const { space } = flags;
         const url = `/spaces/${space}/inbound-ruleset`;
-        const options = {
-            headers: { Accept: 'application/vnd.heroku+json; version=3.dogwood' },
-        };
-        const { body: ruleset } = await this.heroku.get(url, options);
+        const { body: ruleset } = await this.heroku.get(url);
         if (!this.isUniqueRule(ruleset, args.source)) {
             throw new Error(`A rule already exists for ${args.source}.`);
         }
         ruleset.rules.push({ action: 'allow', source: args.source });
-        await this.heroku.put(url, Object.assign(Object.assign({}, options), { body: ruleset }));
+        await this.heroku.put(url, { body: ruleset });
         core_1.ux.log(`Added ${color_1.default.cyan.bold(args.source)} to trusted IP ranges on ${color_1.default.cyan.bold(space)}`);
         core_1.ux.warn('It may take a few moments for the changes to take effect.');
     }
@@ -39,5 +36,5 @@ Add.flags = {
     confirm: command_1.flags.string({ description: 'set to space name to bypass confirm prompt' }),
 };
 Add.args = {
-    source: core_1.Args.string({ required: true }),
+    source: core_1.Args.string({ required: true, description: 'IP address in CIDR notation' }),
 };

package/lib/commands/spaces/trusted-ips/index.js

@@ -10,9 +10,7 @@ class Index extends command_1.Command {
         if (!space) {
             throw new Error('Space name required.\nUSAGE: heroku trusted-ips my-space');
         }
-        const { body: rules } = await this.heroku.get(`/spaces/${space}/inbound-ruleset`, {
-            headers: { Accept: 'application/vnd.heroku+json; version=3.dogwood' },
-        });
+        const { body: rules } = await this.heroku.get(`/spaces/${space}/inbound-ruleset`);
         if (flags.json) {
             core_1.ux.log(JSON.stringify(rules, null, 2));
         }

package/lib/commands/spaces/trusted-ips/remove.js

@@ -10,8 +10,7 @@ class Remove extends command_1.Command {
         const { flags, args } = await this.parse(Remove);
         const space = flags.space;
         const url = `/spaces/${space}/inbound-ruleset`;
-        const opts = { headers: { Accept: 'application/vnd.heroku+json; version=3.dogwood' } };
-        const { body: rules } = await this.heroku.get(url, opts);
+        const { body: rules } = await this.heroku.get(url);
         if (((_a = rules.rules) === null || _a === void 0 ? void 0 : _a.length) === 0) {
             throw new Error('No IP ranges are configured. Nothing to do.');
         }
@@ -20,7 +19,7 @@ class Remove extends command_1.Command {
         if (((_d = rules.rules) === null || _d === void 0 ? void 0 : _d.length) === originalLength) {
             throw new Error(`No IP range matching ${args.source} was found.`);
         }
-        await this.heroku.put(url, Object.assign(Object.assign({}, opts), { body: rules }));
+        await this.heroku.put(url, { body: rules });
         core_1.ux.log(`Removed ${color_1.default.cyan.bold(args.source)} from trusted IP ranges on ${color_1.default.cyan.bold(space)}`);
         core_1.ux.warn('It may take a few moments for the changes to take effect.');
     }
@@ -40,5 +39,5 @@ Remove.flags = {
     confirm: command_1.flags.string({ description: 'set to space name to bypass confirm prompt' }),
 };
 Remove.args = {
-    source: core_1.Args.string({ required: true }),
+    source: core_1.Args.string({ required: true, description: 'IP address in CIDR notation' }),
 };

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

@@ -13,6 +13,5 @@ export default class Add extends Command {
         headers: import("@oclif/core/lib/interfaces/parser").Arg<string, Record<string, unknown>>;
     };
     static example: string;
-    private getTypeAndName;
     run(): Promise<void>;
 }

package/lib/commands/telemetry/add.js

@@ -5,24 +5,25 @@ const core_1 = require("@oclif/core");
 const tsheredoc_1 = require("tsheredoc");
 const util_1 = require("../../lib/telemetry/util");
 class Add extends command_1.Command {
-    constructor() {
-        super(...arguments);
-        this.getTypeAndName = function (app, space) {
-            if (app) {
-                return { type: 'app', name: app };
-            }
-            return { type: 'space', name: space };
-        };
-    }
     async run() {
         const { flags, args } = await this.parse(Add);
         const { app, space, signals, endpoint, transport } = flags;
         const { headers } = args;
-        const typeAndName = this.getTypeAndName(app, space);
+        let id;
+        if (app) {
+            const { body: herokuApp } = await this.heroku.get(`/apps/${app}`, {
+                headers: { Accept: 'application/vnd.heroku+json; version=3.sdk' },
+            });
+            id = herokuApp.id;
+        }
+        else {
+            const { body: herokuSpace } = await this.heroku.get(`/spaces/${space}`);
+            id = herokuSpace.id;
+        }
         const drainConfig = {
             owner: {
-                type: typeAndName.type,
-                id: typeAndName.name,
+                type: app ? 'app' : 'space',
+                id,
             },
             signals: (0, util_1.validateAndFormatSignals)(signals),
             exporter: {
@@ -31,24 +32,13 @@ class Add extends command_1.Command {
                 headers: JSON.parse(headers),
             },
         };
-        if (app) {
-            const { body: drain } = await this.heroku.post(`/apps/${app}/telemetry-drains`, {
-                body: drainConfig,
-                headers: {
-                    Accept: 'application/vnd.heroku+json; version=3.sdk',
-                },
-            });
-            core_1.ux.log(`successfully added drain ${drain.exporter.endpoint}`);
-        }
-        else if (space) {
-            const { body: drain } = await this.heroku.post(`/spaces/${space}/telemetry-drains`, {
-                body: drainConfig,
-                headers: {
-                    Accept: 'application/vnd.heroku+json; version=3.sdk',
-                },
-            });
-            core_1.ux.log(`successfully added drain ${drain.exporter.endpoint}`);
-        }
+        const { body: drain } = await this.heroku.post('/telemetry-drains', {
+            body: drainConfig,
+            headers: {
+                Accept: 'application/vnd.heroku+json; version=3.sdk',
+            },
+        });
+        core_1.ux.log(`successfully added drain ${drain.exporter.endpoint}`);
     }
 }
 exports.default = Add;
@@ -66,5 +56,5 @@ Add.args = {
 };
 Add.example = (0, tsheredoc_1.default)(`
     Add a telemetry drain to an app to collect logs and traces:
-    $ heroku telemetry:add --signals logs,traces --endpoint https://my-endpoint.com --transport http 'x-drain-example-team: API_KEY x-drain-example-dataset: METRICS_DATASET'
+    $ heroku telemetry:add --app myapp --signals logs,traces --endpoint https://my-endpoint.com --transport http '{"x-drain-example-team": "API_KEY", "x-drain-example-dataset": "METRICS_DATASET"}'
   `);

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

@@ -9,5 +9,5 @@ export default class Index extends Command {
     };
     static example: string;
     run(): Promise<void>;
-    protected display(telemetryDrains: TelemetryDrains, ownerType: 'App' | 'Space'): void;
+    protected display(telemetryDrains: TelemetryDrains, owner: string | undefined): void;
 }

package/lib/commands/telemetry/index.js

@@ -6,13 +6,14 @@ class Index extends command_1.Command {
     async run() {
         const { flags } = await this.parse(Index);
         const { app, space } = flags;
+        let drains = [];
         if (app) {
             const { body: appTelemetryDrains } = await this.heroku.get(`/apps/${app}/telemetry-drains`, {
                 headers: {
                     Accept: 'application/vnd.heroku+json; version=3.sdk',
                 },
             });
-            this.display(appTelemetryDrains, 'App');
+            drains = appTelemetryDrains;
         }
         else if (space) {
             const { body: spaceTelemetryDrains } = await this.heroku.get(`/spaces/${space}/telemetry-drains`, {
@@ -20,17 +21,22 @@ class Index extends command_1.Command {
                     Accept: 'application/vnd.heroku+json; version=3.sdk',
                 },
             });
-            this.display(spaceTelemetryDrains, 'Space');
+            drains = spaceTelemetryDrains;
         }
+        this.display(drains, app || space);
     }
-    display(telemetryDrains, ownerType) {
-        core_1.ux.styledHeader(`${ownerType} Telemetry Drains`);
-        core_1.ux.table(telemetryDrains, {
-            ID: { get: telemetryDrain => telemetryDrain.id },
-            Signals: { get: telemetryDrain => telemetryDrain.signals },
-            Endpoint: { get: telemetryDrain => telemetryDrain.exporter.endpoint },
-            [ownerType]: { get: telemetryDrain => telemetryDrain.owner.name },
-        });
+    display(telemetryDrains, owner) {
+        if (telemetryDrains.length === 0) {
+            core_1.ux.log(`There are no telemetry drains in ${owner}`);
+        }
+        else {
+            core_1.ux.styledHeader(`${owner} Telemetry Drains`);
+            core_1.ux.table(telemetryDrains, {
+                ID: { get: telemetryDrain => telemetryDrain.id },
+                Signals: { get: telemetryDrain => telemetryDrain.signals },
+                Endpoint: { get: telemetryDrain => telemetryDrain.exporter.endpoint },
+            });
+        }
     }
 }
 exports.default = Index;

package/lib/commands/telemetry/remove.js

@@ -15,8 +15,8 @@ class Remove extends command_1.Command {
       `));
         }
         if (telemetry_drain_id) {
-            const telemetryDrain = await this.removeDrain(telemetry_drain_id);
-            core_1.ux.action.start(`Removing telemetry drain ${telemetry_drain_id}, which was configured for ${telemetryDrain.owner.type} ${telemetryDrain.owner.name}`);
+            core_1.ux.action.start(`Removing telemetry drain ${telemetry_drain_id}`);
+            await this.removeDrain(telemetry_drain_id);
         }
         else if (app) {
             core_1.ux.action.start(`Removing all telemetry drains from app ${app}`);

package/lib/commands/webhooks/deliveries/info.js

@@ -38,5 +38,5 @@ DeliveriesInfo.flags = {
     pipeline: command_1.flags.pipeline({ char: 'p', description: 'pipeline on which to list', hidden: true }),
 };
 DeliveriesInfo.args = {
-    id: core_1.Args.string({ required: true }),
+    id: core_1.Args.string({ required: true, description: 'ID of the webhook event' }),
 };

package/lib/commands/webhooks/events/info.js

@@ -27,5 +27,5 @@ Info.flags = {
     pipeline: command_1.flags.pipeline({ char: 'p', description: 'pipeline on which to list', hidden: true }),
 };
 Info.args = {
-    id: core_1.Args.string({ required: true }),
+    id: core_1.Args.string({ required: true, description: 'ID of the webhook event' }),
 };

package/lib/commands/webhooks/info.js

@@ -27,5 +27,5 @@ WebhooksInfo.flags = {
     pipeline: command_1.flags.pipeline({ char: 'p', description: 'pipeline on which to list', hidden: true }),
 };
 WebhooksInfo.args = {
-    id: core_1.Args.string({ required: true }),
+    id: core_1.Args.string({ required: true, description: 'ID of the webhook' }),
 };

package/lib/commands/webhooks/update.js

@@ -37,5 +37,5 @@ WebhooksUpdate.flags = {
     url: command_1.flags.string({ char: 'u', description: 'URL for receiver', required: true }),
 };
 WebhooksUpdate.args = {
-    id: core_1.Args.string({ required: true }),
+    id: core_1.Args.string({ required: true, description: 'ID of the webhook' }),
 };

package/lib/hooks/plugins/preinstall/disclaimers.d.ts

@@ -0,0 +1,3 @@
+import { Hook } from '@oclif/core';
+declare const hook: Hook<'plugins:preinstall'>;
+export default hook;

package/lib/hooks/plugins/preinstall/disclaimers.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const hook = async function (options) {
+    const npmPackageNames = ['@heroku/plugin-ai', '@heroku-cli/plugin-ai'];
+    if (options.plugin.type !== 'npm' || !npmPackageNames.includes(options.plugin.name))
+        return;
+    core_1.ux.warn('\n\nThis pilot feature is a Beta Service. You may opt to try such Beta Service in your sole discretion. ' +
+        'Any use of the Beta Service is subject to the applicable Beta Services Terms provided at ' +
+        'https://www.salesforce.com/company/legal/customer-agreements/. While use of the pilot feature itself is free, ' +
+        'to the extent such use consumes a generally available Service, you may be charged for that consumption as set ' +
+        'forth in the Documentation. Your continued use of this pilot feature constitutes your acceptance of the foregoing.\n\n' +
+        'For clarity and without limitation, the various third-party machine learning and generative artificial intelligence ' +
+        '(AI) models and applications (each a “Platform”) integrated with the Beta Service are Non-SFDC Applications, ' +
+        'as that term is defined in the Beta Services Terms. Note that these third-party Platforms include features that use ' +
+        'generative AI technology. Due to the nature of generative AI, the output that a Platform generates may be ' +
+        'unpredictable, and may include inaccurate or harmful responses. Before using any generative AI output, Customer is ' +
+        'solely responsible for reviewing the output for accuracy, safety, and compliance with applicable laws and third-party ' +
+        'acceptable use policies. In addition, Customer’s use of each Platform may be subject to the Platform’s own terms and ' +
+        'conditions, compliance with which Customer is solely responsible.\n');
+    const response = await core_1.ux.prompt('Continue? (Y/N)');
+    if (response.toUpperCase() !== 'Y') {
+        core_1.ux.error('Canceled', { exit: 1 });
+    }
+};
+exports.default = hook;

package/lib/lib/releases/releases.js

@@ -4,7 +4,10 @@ exports.findByPreviousOrId = exports.findByLatestOrId = exports.getRelease = exp
 const findRelease = async function (heroku, app, search) {
     const { body: releases } = await heroku.request(`/apps/${app}/releases`, {
         partial: true,
-        headers: { Range: 'version ..; max=10, order=desc' },
+        headers: {
+            Range: 'version ..; max=10, order=desc',
+            Accept: 'application/vnd.heroku+json; version=3.sdk',
+        },
     });
     return search(releases);
 };
@@ -12,7 +15,11 @@ exports.findRelease = findRelease;
 const getRelease = async function (heroku, app, release) {
     let id = release.toLowerCase();
     id = id.startsWith('v') ? id.slice(1) : id;
-    const { body: releaseResponse } = await heroku.get(`/apps/${app}/releases/${id}`);
+    const { body: releaseResponse } = await heroku.get(`/apps/${app}/releases/${id}`, {
+        headers: {
+            Accept: 'application/vnd.heroku+json; version=3.sdk',
+        },
+    });
     return releaseResponse;
 };
 exports.getRelease = getRelease;
@@ -25,7 +32,7 @@ const findByLatestOrId = async function (heroku, app, release = 'current') {
 exports.findByLatestOrId = findByLatestOrId;
 const findByPreviousOrId = async function (heroku, app, release = 'previous') {
     if (release === 'previous') {
-        return (0, exports.findRelease)(heroku, app, releases => releases.filter(r => r.status === 'succeeded')[1]);
+        return (0, exports.findRelease)(heroku, app, releases => releases.filter(r => r.eligible_for_rollback)[1]);
     }
     return (0, exports.getRelease)(heroku, app, release);
 };

package/lib/lib/releases/status_helper.d.ts

@@ -1,5 +1,5 @@
 export declare const description: (release: {
     [k: string]: any;
     status?: string | undefined;
-}) => "" | "release command executing" | "release command failed";
-export declare const color: (s?: string) => "red" | "yellow" | "white";
+}) => "" | "release command executing" | "release command failed" | "release expired";
+export declare const color: (s?: string) => "red" | "yellow" | "gray" | "cyan";

package/lib/lib/releases/status_helper.js

@@ -7,6 +7,8 @@ const description = function (release) {
             return 'release command executing';
         case 'failed':
             return 'release command failed';
+        case 'expired':
+            return 'release expired';
         default:
             return '';
     }
@@ -18,8 +20,10 @@ const color = function (s) {
             return 'yellow';
         case 'failed':
             return 'red';
+        case 'expired':
+            return 'gray';
         default:
-            return 'white';
+            return 'cyan';
     }
 };
 exports.color = color;

package/lib/lib/run/log-displayer.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 const core_1 = require("@oclif/core");
+const color_1 = require("@heroku-cli/color");
 const colorize_1 = require("./colorize");
 const generation_1 = require("../apps/generation");
 const EventSource = require('@heroku/eventsource');
@@ -55,17 +56,20 @@ async function logDisplayer(heroku, options) {
     const requestBodyParameters = {
         source: options.source,
     };
-    if (firApp)
+    if (firApp) {
+        process.stderr.write(color_1.default.cyan.bold('Fetching logs...\n\n'));
         Object.assign(requestBodyParameters, {
             dyno: options.dyno,
             type: options.type,
         });
-    else
+    }
+    else {
         Object.assign(requestBodyParameters, {
             dyno: options.dyno || options.type,
             lines: options.lines,
             tail: options.tail,
         });
+    }
     let recreateLogSession = false;
     do {
         const { body: logSession } = await heroku.post(`/apps/${options.app}/log-sessions`, {

package/lib/lib/types/app_process_tier.d.ts

@@ -0,0 +1,4 @@
+import { App } from './fir';
+export interface AppProcessTier extends App {
+    process_tier: string;
+}

package/lib/lib/types/app_process_tier.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/lib/nls.d.ts

@@ -0,0 +1,8 @@
+import * as nlsValues from './package.nls.json';
+/**
+ * Non-localized strings util.
+ *
+ * @param key The key of the non-localized string to retrieve.
+ * @return string
+ */
+export declare function nls<T extends keyof typeof nlsValues>(key: T): typeof nlsValues[T];

package/lib/nls.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.nls = void 0;
+const nlsValues = require("./package.nls.json");
+/**
+ * Non-localized strings util.
+ *
+ * @param key The key of the non-localized string to retrieve.
+ * @return string
+ */
+function nls(key) {
+    return nlsValues[key];
+}
+exports.nls = nls;

package/lib/package.nls.json

@@ -0,0 +1,6 @@
+{
+    "pg:database:arg:description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::`",
+    "pg:database:arg:description:default:suffix": ". If omitted, we use DATABASE_URL.",
+    "pg:database:arg:description:arbitrary:suffix": ". If omitted, we use a random database attached to the app.",
+    "pg:database:arg:description:all-dbs:suffix": ". If omitted, we use all databases."
+}