@salesforce/plugin-packaging 2.19.9 → 2.20.0

package/lib/commands/package/bundle/version/create.js

@@ -0,0 +1,125 @@
+/*
+ * Copyright 2025, Salesforce, Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { Flags, loglevel, orgApiVersionFlagWithDeprecations, SfCommand } from '@salesforce/sf-plugins-core';
+import { PackageVersionEvents, BundleSObjects, PackageBundleVersion, } from '@salesforce/packaging';
+import { Messages, Lifecycle } from '@salesforce/core';
+import { camelCaseToTitleCase, Duration } from '@salesforce/kit';
+import { requiredHubFlag } from '../../../../utils/hubFlag.js';
+Messages.importMessagesDirectoryFromMetaUrl(import.meta.url);
+// TODO: Update messages
+const messages = Messages.loadMessages('@salesforce/plugin-packaging', 'bundle_version_create');
+export class PackageBundlesCreate extends SfCommand {
+    static hidden = true;
+    static state = 'beta';
+    static summary = messages.getMessage('summary');
+    static description = messages.getMessage('description');
+    static examples = messages.getMessages('examples');
+    static requiresProject = true;
+    static flags = {
+        loglevel,
+        bundle: Flags.string({
+            char: 'b',
+            summary: messages.getMessage('flags.bundle.summary'),
+            required: true,
+        }),
+        description: Flags.string({
+            char: 'd',
+            summary: messages.getMessage('flags.description.summary'),
+        }),
+        'definition-file': Flags.string({
+            char: 'p',
+            summary: messages.getMessage('flags.definition-file.summary'),
+            required: true,
+        }),
+        'target-dev-hub': requiredHubFlag,
+        'api-version': orgApiVersionFlagWithDeprecations,
+        wait: Flags.integer({
+            char: 'w',
+            summary: messages.getMessage('flags.wait.summary'),
+            default: 0,
+        }),
+        verbose: Flags.boolean({
+            summary: messages.getMessage('flags.verbose.summary'),
+        }),
+        'version-number': Flags.string({
+            char: 'n',
+            summary: messages.getMessage('flags.version-number.summary'),
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(PackageBundlesCreate);
+        // Parse version number if provided
+        let majorVersion = '';
+        let minorVersion = '';
+        if (flags['version-number']) {
+            const versionParts = flags['version-number'].split('.');
+            majorVersion = versionParts[0] || '';
+            minorVersion = versionParts[1] || '';
+        }
+        const options = {
+            connection: flags['target-dev-hub'].getConnection(flags['api-version']),
+            project: this.project,
+            PackageBundle: flags.bundle,
+            BundleVersionComponentsPath: flags['definition-file'],
+            Description: flags.description,
+            MajorVersion: majorVersion,
+            MinorVersion: minorVersion,
+            Ancestor: '',
+        };
+        Lifecycle.getInstance().on(PackageVersionEvents.create.progress, 
+        // no async methods
+        // eslint-disable-next-line @typescript-eslint/require-await
+        async (data) => {
+            if (data.RequestStatus !== BundleSObjects.PkgBundleVersionCreateReqStatus.success &&
+                data.RequestStatus !== BundleSObjects.PkgBundleVersionCreateReqStatus.error) {
+                const status = messages.getMessage('bundleVersionCreateWaitingStatus', [
+                    data.remainingWaitTime.minutes,
+                    data.RequestStatus,
+                ]);
+                if (flags.verbose) {
+                    this.log(status);
+                }
+                else {
+                    this.spinner.status = status;
+                }
+            }
+        });
+        const result = await PackageBundleVersion.create({
+            ...options,
+            ...(flags.wait && flags.wait > 0
+                ? { polling: { timeout: Duration.minutes(flags.wait), frequency: Duration.seconds(5) } }
+                : undefined),
+        });
+        const finalStatusMsg = messages.getMessage('bundleVersionCreateFinalStatus', [result.RequestStatus]);
+        if (flags.verbose) {
+            this.log(finalStatusMsg);
+        }
+        else {
+            this.spinner.stop(finalStatusMsg);
+        }
+        switch (result.RequestStatus) {
+            case BundleSObjects.PkgBundleVersionCreateReqStatus.error:
+                throw messages.createError('multipleErrors', [result.Error?.join('\n') ?? 'Unknown error']);
+            case BundleSObjects.PkgBundleVersionCreateReqStatus.success:
+                this.log(messages.getMessage('bundleVersionCreateSuccess', [result.Id]));
+                break;
+            default:
+                this.log(messages.getMessage('InProgress', [camelCaseToTitleCase(result.RequestStatus), result.Id]));
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=create.js.map

package/lib/commands/package/bundle/version/create.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.js","sourceRoot":"","sources":["../../../../../src/commands/package/bundle/version/create.ts"],"names":[],"mappings":"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"}

package/lib/commands/package/bundle/version/list.d.ts

@@ -0,0 +1,18 @@
+import { SfCommand } from '@salesforce/sf-plugins-core';
+import { BundleSObjects } from '@salesforce/packaging';
+export type PackageBundleVersionResults = BundleSObjects.BundleVersion[];
+export declare class PackageBundleVersionListCommand extends SfCommand<PackageBundleVersionResults> {
+    static readonly hidden = true;
+    static state: string;
+    static readonly summary: string;
+    static readonly description: string;
+    static readonly examples: string[];
+    static readonly flags: {
+        loglevel: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'target-dev-hub': import("@oclif/core/interfaces").OptionFlag<import("@salesforce/core").Org, import("@oclif/core/interfaces").CustomOptions>;
+        'api-version': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        verbose: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    private connection;
+    run(): Promise<PackageBundleVersionResults>;
+}

package/lib/commands/package/bundle/version/list.js

@@ -0,0 +1,75 @@
+/*
+ * Copyright 2025, Salesforce, Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { Flags, loglevel, orgApiVersionFlagWithDeprecations, SfCommand } from '@salesforce/sf-plugins-core';
+import { Messages } from '@salesforce/core';
+import { PackageBundleVersion } from '@salesforce/packaging';
+import chalk from 'chalk';
+import { requiredHubFlag } from '../../../../utils/hubFlag.js';
+Messages.importMessagesDirectoryFromMetaUrl(import.meta.url);
+const messages = Messages.loadMessages('@salesforce/plugin-packaging', 'bundle_version_list');
+export class PackageBundleVersionListCommand extends SfCommand {
+    static hidden = true;
+    static state = 'beta';
+    static summary = messages.getMessage('summary');
+    static description = messages.getMessage('description');
+    static examples = messages.getMessages('examples');
+    static flags = {
+        loglevel,
+        'target-dev-hub': requiredHubFlag,
+        'api-version': orgApiVersionFlagWithDeprecations,
+        verbose: Flags.boolean({
+            summary: messages.getMessage('flags.verbose.summary'),
+        }),
+    };
+    connection;
+    async run() {
+        const { flags } = await this.parse(PackageBundleVersionListCommand);
+        this.connection = flags['target-dev-hub'].getConnection(flags['api-version']);
+        const results = await PackageBundleVersion.list(this.connection);
+        if (results.length === 0) {
+            this.warn('No results found');
+        }
+        else {
+            const data = results.map((r) => ({
+                'Bundle Name': r.PackageBundle.BundleName,
+                'Bundle Id': r.PackageBundle.Id,
+                'Bundle Version Number': String(r.MajorVersion) + '.' + String(r.MinorVersion),
+                'Bundle Version Id': r.Id,
+                'Bundle Version Name': r.VersionName,
+                'Bundle Version Description': r.PackageBundle.Description,
+                ...(flags.verbose
+                    ? {
+                        'Ancestor Id': r.Ancestor?.Id,
+                        'Ancestor Name': r.Ancestor?.PackageBundle.BundleName,
+                        'Ancestor Version Name': r.Ancestor?.VersionName,
+                        'Ancestor Version': String(r.Ancestor?.MajorVersion) + '.' + String(r.Ancestor?.MinorVersion),
+                        'Created Date': r.CreatedDate,
+                        'Created By': r.CreatedById,
+                        'Last Modified Date': r.LastModifiedDate,
+                        'Last Modified By': r.LastModifiedById,
+                    }
+                    : {}),
+            }));
+            this.table({
+                data,
+                overflow: 'wrap',
+                title: chalk.blue(`Package Bundle Version List [${results.length}]`),
+            });
+        }
+        return results;
+    }
+}
+//# sourceMappingURL=list.js.map

package/lib/commands/package/bundle/version/list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../../../../src/commands/package/bundle/version/list.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,iCAAiC,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAC5G,OAAO,EAAc,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAkB,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7E,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAE/D,QAAQ,CAAC,kCAAkC,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC7D,MAAM,QAAQ,GAAG,QAAQ,CAAC,YAAY,CAAC,8BAA8B,EAAE,qBAAqB,CAAC,CAAC;AAI9F,MAAM,OAAO,+BAAgC,SAAQ,SAAsC;IAClF,MAAM,CAAU,MAAM,GAAG,IAAI,CAAC;IAC9B,MAAM,CAAC,KAAK,GAAG,MAAM,CAAC;IACtB,MAAM,CAAU,OAAO,GAAG,QAAQ,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;IACzD,MAAM,CAAU,WAAW,GAAG,QAAQ,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;IACjE,MAAM,CAAU,QAAQ,GAAG,QAAQ,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;IAC5D,MAAM,CAAU,KAAK,GAAG;QAC7B,QAAQ;QACR,gBAAgB,EAAE,eAAe;QACjC,aAAa,EAAE,iCAAiC;QAChD,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC;YACrB,OAAO,EAAE,QAAQ,CAAC,UAAU,CAAC,uBAAuB,CAAC;SACtD,CAAC;KACH,CAAC;IAEM,UAAU,CAAc;IAEzB,KAAK,CAAC,GAAG;QACd,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,+BAA+B,CAAC,CAAC;QACpE,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC,gBAAgB,CAAC,CAAC,aAAa,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC;QAC9E,MAAM,OAAO,GAAG,MAAM,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAEjE,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,IAAI,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;QAChC,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBAC/B,aAAa,EAAE,CAAC,CAAC,aAAa,CAAC,UAAU;gBACzC,WAAW,EAAE,CAAC,CAAC,aAAa,CAAC,EAAE;gBAC/B,uBAAuB,EAAE,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,GAAG,GAAG,GAAG,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC;gBAC9E,mBAAmB,EAAE,CAAC,CAAC,EAAE;gBACzB,qBAAqB,EAAE,CAAC,CAAC,WAAW;gBACpC,4BAA4B,EAAE,CAAC,CAAC,aAAa,CAAC,WAAW;gBACzD,GAAG,CAAC,KAAK,CAAC,OAAO;oBACf,CAAC,CAAC;wBACE,aAAa,EAAE,CAAC,CAAC,QAAQ,EAAE,EAAE;wBAC7B,eAAe,EAAE,CAAC,CAAC,QAAQ,EAAE,aAAa,CAAC,UAAU;wBACrD,uBAAuB,EAAE,CAAC,CAAC,QAAQ,EAAE,WAAW;wBAChD,kBAAkB,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,EAAE,YAAY,CAAC,GAAG,GAAG,GAAG,MAAM,CAAC,CAAC,CAAC,QAAQ,EAAE,YAAY,CAAC;wBAC7F,cAAc,EAAE,CAAC,CAAC,WAAW;wBAC7B,YAAY,EAAE,CAAC,CAAC,WAAW;wBAC3B,oBAAoB,EAAE,CAAC,CAAC,gBAAgB;wBACxC,kBAAkB,EAAE,CAAC,CAAC,gBAAgB;qBACvC;oBACH,CAAC,CAAC,EAAE,CAAC;aACR,CAAC,CAAC,CAAC;YAEJ,IAAI,CAAC,KAAK,CAAC;gBACT,IAAI;gBACJ,QAAQ,EAAE,MAAM;gBAChB,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,gCAAgC,OAAO,CAAC,MAAM,GAAG,CAAC;aACrE,CAAC,CAAC;QACL,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC"}

package/lib/commands/package/bundle/version/report.d.ts

@@ -0,0 +1,22 @@
+import { SfCommand } from '@salesforce/sf-plugins-core';
+import { BundleSObjects, PackagingSObjects } from '@salesforce/packaging';
+export type BundleVersionReportResult = BundleSObjects.BundleVersion & {
+    componentPackages: PackagingSObjects.SubscriberPackageVersion[];
+};
+export declare class PackageBundleVersionReportCommand extends SfCommand<BundleVersionReportResult> {
+    static readonly hidden = true;
+    static state: string;
+    static readonly summary: string;
+    static readonly examples: string[];
+    static readonly flags: {
+        loglevel: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'target-dev-hub': import("@oclif/core/interfaces").OptionFlag<import("@salesforce/core").Org, import("@oclif/core/interfaces").CustomOptions>;
+        'api-version': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'bundle-version': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        verbose: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<BundleVersionReportResult>;
+    private display;
+    private filterVerboseRecords;
+    private displayComponentPackages;
+}

package/lib/commands/package/bundle/version/report.js

@@ -0,0 +1,165 @@
+/*
+ * Copyright 2025, Salesforce, Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { Flags, loglevel, orgApiVersionFlagWithDeprecations, SfCommand } from '@salesforce/sf-plugins-core';
+import { Messages } from '@salesforce/core/messages';
+import { PackageBundleVersion } from '@salesforce/packaging';
+import chalk from 'chalk';
+import { requiredHubFlag } from '../../../../utils/hubFlag.js';
+Messages.importMessagesDirectoryFromMetaUrl(import.meta.url);
+const messages = Messages.loadMessages('@salesforce/plugin-packaging', 'bundle_version_report');
+export class PackageBundleVersionReportCommand extends SfCommand {
+    static hidden = true;
+    static state = 'beta';
+    static summary = messages.getMessage('summary');
+    static examples = messages.getMessages('examples');
+    static flags = {
+        loglevel,
+        'target-dev-hub': requiredHubFlag,
+        'api-version': orgApiVersionFlagWithDeprecations,
+        'bundle-version': Flags.string({
+            char: 'b',
+            summary: messages.getMessage('flags.bundle-version.summary'),
+            required: true,
+        }),
+        verbose: Flags.boolean({
+            summary: messages.getMessage('flags.verbose.summary'),
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(PackageBundleVersionReportCommand);
+        const connection = flags['target-dev-hub'].getConnection(flags['api-version']);
+        const results = await PackageBundleVersion.report(connection, flags['bundle-version']);
+        if (!results) {
+            throw new Error(`No bundle version found with ID: ${flags['bundle-version']}`);
+        }
+        this.display(results, flags.verbose);
+        const componentPackages = await PackageBundleVersion.getComponentPackages(connection, flags['bundle-version']);
+        this.displayComponentPackages(componentPackages);
+        return { ...results, componentPackages };
+    }
+    display(record, verbose) {
+        if (this.jsonEnabled()) {
+            return;
+        }
+        // transform the results into a table
+        const displayRecords = [
+            {
+                key: 'Bundle Name',
+                value: record.PackageBundle.BundleName,
+            },
+            {
+                key: 'Bundle ID',
+                value: record.PackageBundle.Id,
+            },
+            {
+                key: 'Version ID',
+                value: record.Id,
+            },
+            {
+                key: 'Version Name',
+                value: record.VersionName,
+            },
+            {
+                key: 'Major Version',
+                value: record.MajorVersion,
+            },
+            {
+                key: 'Minor Version',
+                value: record.MinorVersion,
+            },
+            {
+                key: 'Description',
+                value: record.PackageBundle.Description ?? 'N/A',
+            },
+            {
+                key: 'Released',
+                value: record.IsReleased ? 'Yes' : 'No',
+            },
+            {
+                key: 'Created Date',
+                value: record.CreatedDate,
+            },
+            {
+                key: 'Created By',
+                value: record.CreatedById,
+            },
+            {
+                key: 'Last Modified Date',
+                value: record.LastModifiedDate,
+            },
+            {
+                key: 'Last Modified By',
+                value: record.LastModifiedById,
+            },
+        ];
+        // Add ancestor information if available
+        if (record.Ancestor) {
+            displayRecords.push({
+                key: 'Ancestor ID',
+                value: record.Ancestor.Id,
+            }, {
+                key: 'Ancestor Version',
+                value: `${record.Ancestor.MajorVersion}.${record.Ancestor.MinorVersion}`,
+            }, {
+                key: 'Ancestor Bundle Name',
+                value: record.Ancestor.PackageBundle.BundleName,
+            });
+        }
+        else {
+            displayRecords.push({
+                key: 'Ancestor',
+                value: 'N/A',
+            });
+        }
+        // Add verbose information if requested
+        if (verbose) {
+            displayRecords.push({
+                key: 'Bundle Deleted',
+                value: record.PackageBundle.IsDeleted ? 'Yes' : 'No',
+            }, {
+                key: 'Bundle System Modstamp',
+                value: record.PackageBundle.SystemModstamp,
+            });
+        }
+        this.filterVerboseRecords(record, displayRecords, verbose);
+        this.table({ data: displayRecords, title: chalk.blue('Package Bundle Version') });
+    }
+    // eslint-disable-next-line class-methods-use-this
+    filterVerboseRecords(bundleRecord, displayRecords, verbose) {
+        if (!verbose) {
+            // Remove verbose fields for non-verbose output
+            const verboseKeys = ['Bundle Deleted', 'Bundle System Modstamp'];
+            displayRecords.splice(0, displayRecords.length, ...displayRecords.filter((displayRecord) => !verboseKeys.includes(displayRecord.key)));
+        }
+    }
+    displayComponentPackages(componentPackages) {
+        if (this.jsonEnabled()) {
+            return;
+        }
+        if (componentPackages.length === 0) {
+            this.log(chalk.yellow('No component packages found for this bundle version.'));
+            return;
+        }
+        const displayRecords = componentPackages.map((component) => ({
+            'Package Name': component.Name,
+            'Package Version Number': `${component.MajorVersion}.${component.MinorVersion}.${component.PatchVersion}.${component.BuildNumber}`,
+            'Package Version Id': component.Id,
+            'Package Id': component.SubscriberPackageId,
+        }));
+        this.table({ data: displayRecords, title: chalk.blue('Component Packages') });
+    }
+}
+//# sourceMappingURL=report.js.map

package/lib/commands/package/bundle/version/report.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.js","sourceRoot":"","sources":["../../../../../src/commands/package/bundle/version/report.ts"],"names":[],"mappings":"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"}

package/messages/bundle_create.md

@@ -0,0 +1,42 @@
+# summary
+
+Create a package bundle in the Dev Hub org.
+
+# description
+
+A package bundle is an artifact that contains one or more 2GP managed packages.
+A bundle can be listed on AppExchange, installed, or upgraded as a single artifact.
+
+# examples
+
+Create a package bundle in the Dev Hub org; uses the Dev Hub org with the username devhub@example.com:
+
+sf package bundle create --name "Your bundle name" --description "Your bundle description" --target-dev-hub devhub@example.com
+
+# flags.name.summary
+
+Name of the package bundle.
+
+# flags.description.summary
+
+Description of the package bundle.
+
+# flags.wait.summary
+
+Number of minutes to wait for the bundle creation to complete.
+
+# flags.verbose.summary
+
+Display extended bundle creation detail.
+
+# requestInProgress
+
+Creating bundle.
+
+# bundleCreateWaitingStatus
+
+%d minutes remaining until timeout. Create bundle status: %s
+
+# bundleCreateFinalStatus
+
+Create bundle status: %s

package/messages/bundle_install.md

@@ -0,0 +1,58 @@
+# summary
+
+Install a package bundle version in the target org.
+
+# description
+
+Install a specific version of a package bundle in the target org. During developer preview, bundles can be installed only in scratch orgs.
+
+# examples
+
+Install a package bundle version in a scratch org:
+
+sf package bundle install --bundle MyPkgBundle1@0.1 --target-org my-scratch-org --wait 10
+
+# flags.bundle.summary
+
+Package bundle version to install (format: BundleName@Version).
+
+# flags.target-org.summary
+
+Target org for the bundle installation.
+
+# flags.target-dev-hub.summary
+
+Username, alias, or org ID of the target dev hub org.
+
+# flags.wait.summary
+
+Number of minutes to wait for the installation to complete.
+
+# flags.verbose.summary
+
+Display extended installation detail.
+
+# requestInProgress
+
+Installing bundle.
+
+# bundleInstallWaitingStatus
+
+%d minutes remaining until timeout. Install status: %s
+
+# bundleInstallFinalStatus
+
+Install status: %s
+
+# bundleInstallSuccess
+
+Successfully installed bundle [%s]
+
+# bundleInstallError
+
+Encountered errors installing the bundle! %s
+
+# bundleInstallInProgress
+
+Bundle installation is currently %s. You can continue to query the status using
+sf package bundle install:report -i %s -o %s

package/messages/bundle_install_list.md

@@ -0,0 +1,69 @@
+# summary
+
+List package bundle installation requests.
+
+# description
+
+Shows the details of each request to install a package bundle version in the target org.
+
+All filter parameters are applied using the AND logical operator (not OR).
+
+To get information about a specific request, run "<%= config.bin %> package bundle install report" and supply the request ID.
+
+# flags.status.summary
+
+Status of the installation request, used to filter the list.
+
+# flags.verbose.summary
+
+Displays additional information at a slight performance cost, such as validation text for each package bundle install request.
+
+# flags.created-last-days.summary
+
+Number of days since the request was created, starting at 00:00:00 of first day to now. Use 0 for today.
+
+# examples
+
+- List all package bundle installation requests in your default Dev Hub org:
+
+  <%= config.bin %> <%= command.id %>
+
+- List package bundle installation requests from the last 3 days in the Dev Hub org with username devhub@example.com:
+
+  <%= config.bin %> <%= command.id %> --created-last-days 3 --target-dev-hub
+
+- List package bundle installation requests with status Error:
+
+  <%= config.bin %> <%= command.id %> --status Error
+
+- List package bundle installation requests with status Queued:
+
+  <%= config.bin %> <%= command.id %> --status Queued
+
+- List package bundle installation requests with status Success that were created today:
+
+  <%= config.bin %> <%= command.id %> --created-last-days 0 --status Success
+
+# id
+
+ID
+
+# status
+
+Status
+
+# package-bundle-version-id
+
+Package Bundle Version ID
+
+# development-organization
+
+Development Organization
+
+# created-by
+
+Created By
+
+# validation-error
+
+Validation Error

package/messages/bundle_install_report.md

@@ -0,0 +1,53 @@
+# summary
+
+Report on the status of a package bundle installation request.
+
+# description
+
+Use this command to check the status of a package bundle installation request. The command returns information about the request, including its current status and details about the package bundle version being installed.
+
+# examples
+
+- Report on a package bundle installation request:
+
+  <%= config.bin %> <%= command.id %> --package-install-request-id 0Ho0x0000000000000
+
+- Report on a package bundle installation request using an alias:
+
+  <%= config.bin %> force:package:bundle:install:report -i 0Ho0x0000000000000
+
+# flags.package-install-request-id.summary
+
+The ID of the package bundle installation request to report on.
+
+# id
+
+ID
+
+# status
+
+Status
+
+# package-bundle-version-id
+
+Package Bundle Version ID
+
+# development-organization
+
+Development Organization
+
+# validation-error
+
+Validation Error
+
+# created-date
+
+Created Date
+
+# created-by
+
+Created By
+
+# flags.verbose.summary
+
+Show verbose output.