T/packaging distribution/w 18762471/package bundle list command

command-snapshot.json

@@ -55,6 +55,22 @@
     "flags": ["api-version", "flags-dir", "json", "loglevel", "package-id", "target-org"],
     "plugin": "@salesforce/plugin-packaging"
   },
+  {
+    "alias": ["force:bundle:create"],
+    "command": "package:bundles:create",
+    "flagAliases": ["apiversion", "target-hub-org", "targetdevhubusername"],
+    "flagChars": ["d", "n", "v"],
+    "flags": ["api-version", "description", "flags-dir", "json", "loglevel", "name", "target-dev-hub"],
+    "plugin": "@salesforce/plugin-packaging"
+  },
+  {
+    "alias": ["force:bundle:list"],
+    "command": "package:bundles:list",
+    "flagAliases": ["apiversion", "target-hub-org", "targetdevhubusername"],
+    "flagChars": ["v"],
+    "flags": ["api-version", "flags-dir", "json", "loglevel", "target-dev-hub", "verbose"],
+    "plugin": "@salesforce/plugin-packaging"
+  },
   {
     "alias": ["force:package:convert"],
     "command": "package:convert",

messages/bundle_create.md

@@ -0,0 +1,24 @@
+# summary
+
+Create a bundle.
+
+# description
+
+First, use this command to create a bunle. Then create a bundle version.
+
+Your --name value must be unique within your namespace.
+
+Run '<%= config.bin %> bundle list to list all bundles in the Dev Hub org.
+
+# examples
+
+- Default Use Case
+  <%= config.bin %> <%= command.id %> --name <bundle_name> --description "<bundle_description>" --target-dev-hub <dev_hub_alias>`
+
+# flags.name.summary
+
+Name of the bundle to create.
+
+# flags.description.summary
+
+Description of the bundle

messages/bundle_list.md

@@ -0,0 +1,61 @@
+# summary
+
+List all bundles in the Dev Hub org.
+
+# description
+
+You can view the namespace, IDs, and other details for each bundle.
+
+# examples
+
+- List all bundles in the specified Dev Hub org:
+
+  <%= config.bin %> <%= command.id %> --target-dev-hub devhub@example.com
+
+- List all bundles details in the specified Dev Hub org, and show extended details about each bundle:
+
+  <%= config.bin %> <%= command.id %> --target-dev-hub devhub@example.com --verbose
+
+# namespace
+
+Namespace Prefix
+
+# name
+
+Name
+
+# id
+
+Id
+
+# bundle-id
+
+Subscriber bundle Id
+
+# alias
+
+Alias
+
+# description
+
+Description
+
+# flags.verbose.summary
+
+Display extended bundle detail.
+
+# convertedFrombundleId
+
+Converted From bundle Id
+
+# isOrgDependent
+
+Org-Dependent Unlocked bundle
+
+# error-notification-username
+
+Error Notification Username
+
+# createdBy
+
+Created By

schemas/package-bundles-create.json

@@ -0,0 +1,16 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$ref": "#/definitions/BundleCreate",
+  "definitions": {
+    "BundleCreate": {
+      "type": "object",
+      "properties": {
+        "Id": {
+          "type": "string"
+        }
+      },
+      "required": ["Id"],
+      "additionalProperties": false
+    }
+  }
+}

schemas/package-bundles-list.json

@@ -0,0 +1,58 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$ref": "#/definitions/BundleListCommandResults",
+  "definitions": {
+    "BundleListCommandResults": {
+      "type": "array",
+      "items": {
+        "$ref": "#/definitions/BundleListCommandResult"
+      }
+    },
+    "BundleListCommandResult": {
+      "$ref": "#/definitions/BundleSObjects.Bundle"
+    },
+    "BundleSObjects.Bundle": {
+      "type": "object",
+      "properties": {
+        "BundleName": {
+          "type": "string"
+        },
+        "Description": {
+          "type": "string"
+        },
+        "Id": {
+          "type": "string"
+        },
+        "IsDeleted": {
+          "type": "boolean"
+        },
+        "CreatedDate": {
+          "type": "string"
+        },
+        "CreatedById": {
+          "type": "string"
+        },
+        "LastModifiedDate": {
+          "type": "string"
+        },
+        "LastModifiedById": {
+          "type": "string"
+        },
+        "SystemModstamp": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "BundleName",
+        "Id",
+        "IsDeleted",
+        "CreatedDate",
+        "CreatedById",
+        "LastModifiedDate",
+        "LastModifiedById",
+        "SystemModstamp"
+      ],
+      "additionalProperties": false
+    }
+  }
+}

src/commands/package/bundles/create.ts

@@ -0,0 +1,57 @@
+/*
+ * Copyright (c) 2025, salesforce.com, inc.
+ * All rights reserved.
+ * Licensed under the BSD 3-Clause license.
+ * For full license text, see LICENSE.txt file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */
+
+import { Flags, loglevel, orgApiVersionFlagWithDeprecations, SfCommand } from '@salesforce/sf-plugins-core';
+import { BundleCreateOptions, PackageBundle } from '@salesforce/packaging';
+import { Messages } from '@salesforce/core';
+import { requiredHubFlag } from '../../../utils/hubFlag.js';
+
+Messages.importMessagesDirectoryFromMetaUrl(import.meta.url);
+const messages = Messages.loadMessages('@salesforce/plugin-packaging', 'bundle_create');
+export type BundleCreate = { Id: string };
+
+export class PackageBundlesCreate extends SfCommand<BundleCreate> {
+  public static readonly summary = messages.getMessage('summary');
+  public static readonly description = messages.getMessage('description');
+  public static readonly examples = messages.getMessages('examples');
+  public static readonly aliases = ['force:bundle:create'];
+  public static readonly requiresProject = true;
+  public static readonly flags = {
+    loglevel,
+    name: Flags.string({
+      char: 'n',
+      summary: messages.getMessage('flags.name.summary'),
+      required: true,
+    }),
+    description: Flags.string({
+      char: 'd',
+      summary: messages.getMessage('flags.description.summary'),
+    }),
+    'target-dev-hub': requiredHubFlag,
+    'api-version': orgApiVersionFlagWithDeprecations,
+  };
+
+  public async run(): Promise<BundleCreate> {
+    const { flags } = await this.parse(PackageBundlesCreate);
+
+    const options: BundleCreateOptions = {
+      Description: flags.description ?? '',
+      BundleName: flags.name,
+    };
+    this.spinner.start(`Creating Bundle with name ${options.BundleName}`);
+    const result = await PackageBundle.create(
+      flags['target-dev-hub'].getConnection(flags['api-version']),
+      this.project!,
+      options
+    );
+
+    this.spinner.stop();
+    this.table({ data: [{ name: 'Bundle Id', value: result.Id }], title: 'Ids' });
+
+    return result;
+  }
+}

src/commands/package/bundles/list.ts

@@ -0,0 +1,63 @@
+/*
+ * Copyright (c) 2023, salesforce.com, inc.
+ * All rights reserved.
+ * Licensed under the BSD 3-Clause license.
+ * For full license text, see LICENSE.txt file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */
+
+import { Flags, loglevel, orgApiVersionFlagWithDeprecations, SfCommand } from '@salesforce/sf-plugins-core';
+import { Messages } from '@salesforce/core/messages';
+import { PackageBundle, BundleSObjects } from '@salesforce/packaging';
+import chalk from 'chalk';
+import { requiredHubFlag } from '../../../utils/hubFlag.js';
+
+// This is a near copy of the package list command, but with the package bundle class and messages.
+// If you are looking to copy this command, mabye make an abstract class for the commands that are similar.(please)
+Messages.importMessagesDirectoryFromMetaUrl(import.meta.url);
+const messages = Messages.loadMessages('@salesforce/plugin-packaging', 'bundle_list');
+
+export type BundleListCommandResult = BundleSObjects.Bundle;
+export type BundleListCommandResults = BundleListCommandResult[];
+
+export class BundleListCommand extends SfCommand<BundleListCommandResults> {
+  public static readonly summary = messages.getMessage('summary');
+  public static readonly description = messages.getMessage('description');
+  public static readonly examples = messages.getMessages('examples');
+  public static readonly deprecateAliases = true;
+  public static readonly aliases = ['force:bundle:list'];
+  public static readonly flags = {
+    loglevel,
+    'target-dev-hub': requiredHubFlag,
+    'api-version': orgApiVersionFlagWithDeprecations,
+    verbose: Flags.boolean({
+      summary: messages.getMessage('flags.verbose.summary'),
+    }),
+  };
+
+  public async run(): Promise<BundleListCommandResults> {
+    const { flags } = await this.parse(BundleListCommand);
+    const connection = flags['target-dev-hub'].getConnection(flags['api-version']);
+    const results = await PackageBundle.list(connection);
+    this.displayResults(results, flags.verbose);
+    return results;
+  }
+
+  private displayResults(results: BundleListCommandResults, verbose = false): void {
+    const data = results.map((r) => ({
+      'Bundle Name': r.BundleName,
+      Id: r.Id,
+      Description: r.Description,
+      ...(verbose
+        ? {
+            'Created Date': r.CreatedDate,
+            'Created By': r.CreatedById,
+            'Last Modified Date': r.LastModifiedDate,
+            'Last Modified By': r.LastModifiedById,
+            'System Modstamp': r.SystemModstamp,
+            'Is Deleted': r.IsDeleted,
+          }
+        : {}),
+    }));
+    this.table({ data, title: chalk.blue(`Package Bundles [${results.length}]`) });
+  }
+}

test/commands/bundle/bundleCreate.test.ts

@@ -0,0 +1,72 @@
+/*
+ * Copyright (c) 2025, salesforce.com, inc.
+ * All rights reserved.
+ * Licensed under the BSD 3-Clause license.
+ * For full license text, see LICENSE.txt file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */
+import { Config } from '@oclif/core';
+import { TestContext, MockTestOrgData } from '@salesforce/core/testSetup';
+import * as sinon from 'sinon';
+import { expect } from 'chai';
+import { BundleCreateOptions, PackageBundle } from '@salesforce/packaging';
+import { stubSfCommandUx } from '@salesforce/sf-plugins-core';
+import { Connection, SfProject } from '@salesforce/core';
+import { PackageBundlesCreate } from '../../../src/commands/package/bundles/create.js';
+
+describe('force:bundle:create - tests', () => {
+  const $$ = new TestContext();
+  const testOrg = new MockTestOrgData();
+  let sfCommandStubs: ReturnType<typeof stubSfCommandUx>;
+  let createStub: sinon.SinonStub<[Connection, SfProject, BundleCreateOptions], Promise<{ Id: string }>>;
+  const config = new Config({ root: import.meta.url });
+
+  beforeEach(async () => {
+    await $$.stubAuths(testOrg);
+    await config.load();
+    sfCommandStubs = stubSfCommandUx($$.SANDBOX);
+
+    createStub = $$.SANDBOX.stub(PackageBundle, 'create');
+  });
+
+  afterEach(() => {
+    $$.restore();
+  });
+
+  it('should create a bundle', async () => {
+    const bundleName = 'dummyPackageId';
+    const cmd = new PackageBundlesCreate(['-v', testOrg.username, '--name', bundleName], config);
+
+    createStub.resolves({ Id: 'test-id' });
+
+    await cmd.run();
+
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access
+    expect(sfCommandStubs.table.calledOnce).to.be.true;
+  });
+
+  it('should throw error when name flag is missing', async () => {
+    const cmd = new PackageBundlesCreate(['-v', testOrg.username], config);
+
+    createStub.resolves({ Id: 'test-id' });
+
+    try {
+      await cmd.run();
+      expect.fail('Expected error was not thrown');
+    } catch (error) {
+      expect((error as Error).message).to.include('Missing required flag name');
+    }
+  });
+
+  it('should throw error when test org flag is missing', async () => {
+    const cmd = new PackageBundlesCreate(['--name', 'dummyPackageId'], config);
+
+    createStub.resolves({ Id: 'test-id' });
+
+    try {
+      await cmd.run();
+      expect.fail('Expected error was not thrown');
+    } catch (error) {
+      expect((error as Error).message).to.include('No default dev hub found');
+    }
+  });
+});