@salesforce/plugin-org 2.4.7 → 2.5.0

package/lib/commands/org/list/metadata-types.d.ts

@@ -0,0 +1,17 @@
+import { DescribeMetadataResult } from 'jsforce/api/metadata';
+import { SfCommand } from '@salesforce/sf-plugins-core';
+export declare class ListMetadataTypes extends SfCommand<DescribeMetadataResult> {
+    static readonly summary: string;
+    static readonly description: string;
+    static readonly examples: string[];
+    static readonly aliases: string[];
+    static readonly deprecateAliases = true;
+    static readonly flags: {
+        'api-version': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        loglevel: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        'target-org': import("@oclif/core/lib/interfaces").OptionFlag<import("@salesforce/core").Org, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        'output-file': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        'filter-known': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<DescribeMetadataResult>;
+}

package/lib/commands/org/list/metadata-types.js

@@ -0,0 +1,75 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ListMetadataTypes = void 0;
+/*
+ * Copyright (c) 2020, 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
+ */
+const fs = require("fs");
+const core_1 = require("@salesforce/core");
+const source_deploy_retrieve_1 = require("@salesforce/source-deploy-retrieve");
+const sf_plugins_core_1 = require("@salesforce/sf-plugins-core");
+core_1.Messages.importMessagesDirectory(__dirname);
+const messages = core_1.Messages.loadMessages('@salesforce/plugin-org', 'metadata-types');
+class ListMetadataTypes extends sf_plugins_core_1.SfCommand {
+    async run() {
+        const { flags } = await this.parse(ListMetadataTypes);
+        const connection = flags['target-org'].getConnection(flags['api-version']);
+        const describeResult = await connection.metadata.describe(flags['api-version']);
+        if (flags['filter-known']) {
+            this.debug('Filtering for only metadata types unregistered in the CLI');
+            const registry = new source_deploy_retrieve_1.RegistryAccess();
+            describeResult.metadataObjects = describeResult.metadataObjects.filter((md) => {
+                try {
+                    // An error is thrown when a type can't be found by name, and we want
+                    // the ones that can't be found.
+                    registry.getTypeByName(md.xmlName);
+                    return false;
+                }
+                catch (e) {
+                    return true;
+                }
+            });
+        }
+        if (flags['output-file']) {
+            await fs.promises.writeFile(flags['output-file'], JSON.stringify(describeResult, null, 2));
+            this.logSuccess(`Wrote result file to ${flags['output-file']}.`);
+        }
+        else {
+            this.styledJSON(describeResult);
+        }
+        return describeResult;
+    }
+}
+exports.ListMetadataTypes = ListMetadataTypes;
+ListMetadataTypes.summary = messages.getMessage('summary');
+ListMetadataTypes.description = messages.getMessage('description');
+ListMetadataTypes.examples = messages.getMessages('examples');
+ListMetadataTypes.aliases = ['force:mdapi:describemetadata'];
+ListMetadataTypes.deprecateAliases = true;
+ListMetadataTypes.flags = {
+    'api-version': sf_plugins_core_1.Flags.orgApiVersion({
+        aliases: ['apiversion', 'a'],
+        deprecateAliases: true,
+        summary: messages.getMessage('flags.api-version.summary'),
+    }),
+    loglevel: sf_plugins_core_1.loglevel,
+    'target-org': sf_plugins_core_1.requiredOrgFlagWithDeprecations,
+    'output-file': sf_plugins_core_1.Flags.file({
+        aliases: ['resultfile'],
+        deprecateAliases: true,
+        char: 'f',
+        summary: messages.getMessage('flags.output-file.summary'),
+        description: messages.getMessage('flags.output-file.description'),
+    }),
+    'filter-known': sf_plugins_core_1.Flags.boolean({
+        aliases: ['filterknown'],
+        deprecateAliases: true,
+        char: 'k',
+        summary: messages.getMessage('flags.filter-known.summary'),
+        hidden: true,
+    }),
+};
+//# sourceMappingURL=metadata-types.js.map

package/lib/commands/org/list/metadata-types.js.map

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

package/lib/commands/org/list/metadata.d.ts

@@ -0,0 +1,19 @@
+import { FileProperties } from 'jsforce/api/metadata';
+import { SfCommand } from '@salesforce/sf-plugins-core';
+export type ListMetadataCommandResult = FileProperties[];
+export declare class ListMetadata extends SfCommand<ListMetadataCommandResult> {
+    static readonly summary: string;
+    static readonly description: string;
+    static readonly examples: string[];
+    static readonly aliases: string[];
+    static readonly deprecateAliases = true;
+    static readonly flags: {
+        'api-version': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        loglevel: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        'target-org': import("@oclif/core/lib/interfaces").OptionFlag<import("@salesforce/core").Org, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        'output-file': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        'metadata-type': import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        folder: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+    };
+    run(): Promise<ListMetadataCommandResult>;
+}

package/lib/commands/org/list/metadata.js

@@ -0,0 +1,68 @@
+"use strict";
+/*
+ * Copyright (c) 2020, 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
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ListMetadata = void 0;
+const fs = require("fs");
+const core_1 = require("@salesforce/core");
+const sf_plugins_core_1 = require("@salesforce/sf-plugins-core");
+core_1.Messages.importMessagesDirectory(__dirname);
+const messages = core_1.Messages.loadMessages('@salesforce/plugin-org', 'list.metadata');
+class ListMetadata extends sf_plugins_core_1.SfCommand {
+    async run() {
+        const { flags } = await this.parse(ListMetadata);
+        const conn = flags['target-org'].getConnection(flags['api-version']);
+        const query = flags.folder
+            ? { type: flags['metadata-type'], folder: flags.folder }
+            : { type: flags['metadata-type'] };
+        const listResult = await conn.metadata.list(query, flags['api-version']);
+        if (flags['output-file']) {
+            fs.writeFileSync(flags['output-file'], JSON.stringify(listResult, null, 2));
+            this.logSuccess(`Wrote result file to ${flags['output-file']}.`);
+        }
+        else if (listResult?.length) {
+            this.styledJSON(listResult);
+        }
+        else {
+            this.warn(messages.getMessage('noMatchingMetadata', [flags['metadata-type'], conn.getUsername()]));
+        }
+        return listResult;
+    }
+}
+exports.ListMetadata = ListMetadata;
+ListMetadata.summary = messages.getMessage('summary');
+ListMetadata.description = messages.getMessage('description');
+ListMetadata.examples = messages.getMessages('examples');
+ListMetadata.aliases = ['force:mdapi:listmetadata'];
+ListMetadata.deprecateAliases = true;
+ListMetadata.flags = {
+    'api-version': sf_plugins_core_1.Flags.orgApiVersion({
+        aliases: ['apiversion', 'a'],
+        deprecateAliases: true,
+        summary: messages.getMessage('flags.api-version.summary'),
+    }),
+    loglevel: sf_plugins_core_1.loglevel,
+    'target-org': sf_plugins_core_1.requiredOrgFlagWithDeprecations,
+    'output-file': sf_plugins_core_1.Flags.file({
+        aliases: ['resultfile'],
+        deprecateAliases: true,
+        char: 'f',
+        summary: messages.getMessage('flags.output-file.summary'),
+    }),
+    'metadata-type': sf_plugins_core_1.Flags.string({
+        aliases: ['metadatatype'],
+        deprecateAliases: true,
+        char: 'm',
+        summary: messages.getMessage('flags.metadata-type.summary'),
+        required: true,
+    }),
+    folder: sf_plugins_core_1.Flags.string({
+        summary: messages.getMessage('flags.folder.summary'),
+        description: messages.getMessage('flags.folder.description'),
+    }),
+};
+//# sourceMappingURL=metadata.js.map

package/lib/commands/org/list/metadata.js.map

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

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

@@ -13,10 +13,13 @@ export declare class OrgOpenCommand extends SfCommand<OrgOpenOutput> {
         path: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
         'url-only': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
         loglevel: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        'source-file': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
     };
     private org;
+    private conn;
     run(): Promise<OrgOpenOutput>;
     private buildFrontdoorUrl;
+    private generateFileUrl;
 }
 export interface OrgOpenOutput {
     url: string;

package/lib/commands/org/open.js

@@ -7,10 +7,12 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.OrgOpenCommand = void 0;
+const path = require("path");
 const sf_plugins_core_1 = require("@salesforce/sf-plugins-core");
 const core_1 = require("@salesforce/core");
 const kit_1 = require("@salesforce/kit");
 const open = require("open");
+const source_deploy_retrieve_1 = require("@salesforce/source-deploy-retrieve");
 const utils_1 = require("../../shared/utils");
 core_1.Messages.importMessagesDirectory(__dirname);
 const messages = core_1.Messages.loadMessages('@salesforce/plugin-org', 'open');
@@ -19,14 +21,20 @@ class OrgOpenCommand extends sf_plugins_core_1.SfCommand {
     async run() {
         const { flags } = await this.parse(OrgOpenCommand);
         this.org = flags['target-org'];
-        const frontDoorUrl = await this.buildFrontdoorUrl(flags['api-version']);
-        const url = flags.path ? `${frontDoorUrl}&retURL=${flags.path}` : frontDoorUrl;
+        this.conn = this.org.getConnection(flags['api-version']);
+        let url = await this.buildFrontdoorUrl();
+        if (flags['source-file']) {
+            url += `&retURL=${await this.generateFileUrl(flags['source-file'])}`;
+        }
+        else if (flags.path) {
+            url += `&retURL=${flags.path}`;
+        }
         const orgId = this.org.getOrgId();
         // TODO: better typings in sfdx-core for orgs read from auth files
         const username = this.org.getUsername();
         const output = { orgId, url, username };
         const containerMode = new kit_1.Env().getBoolean('SFDX_CONTAINER_MODE');
-        // security warning only for --json OR --urlonly OR containerMode
+        // security warning only for --json OR --url-only OR containerMode
         if (flags['url-only'] || flags.json || containerMode) {
             this.warn(sharedMessages.getMessage('SecurityWarning'));
             this.log('');
@@ -70,20 +78,39 @@ class OrgOpenCommand extends sf_plugins_core_1.SfCommand {
         await (0, utils_1.openUrl)(url, openOptions);
         return output;
     }
-    async buildFrontdoorUrl(version) {
+    async buildFrontdoorUrl() {
         await this.org.refreshAuth(); // we need a live accessToken for the frontdoor url
-        const conn = this.org.getConnection(version);
-        const accessToken = conn.accessToken;
+        const accessToken = this.conn.accessToken;
         const instanceUrl = this.org.getField(core_1.Org.Fields.INSTANCE_URL);
         const instanceUrlClean = instanceUrl.replace(/\/$/, '');
         return `${instanceUrlClean}/secur/frontdoor.jsp?sid=${accessToken}`;
     }
+    async generateFileUrl(file) {
+        try {
+            const metadataResolver = new source_deploy_retrieve_1.MetadataResolver();
+            const components = metadataResolver.getComponentsFromPath(file);
+            const typeName = components[0]?.type?.name;
+            if (typeName === 'FlexiPage') {
+                const flexipage = await this.conn.singleRecordQuery(`SELECT id FROM flexipage WHERE DeveloperName='${path.basename(file, '.flexipage-meta.xml')}'`, { tooling: true });
+                return `/visualEditor/appBuilder.app?pageId=${flexipage.Id}`;
+            }
+            else if (typeName === 'ApexPage') {
+                return `/apex/${path.basename(file).replace('.page-meta.xml', '').replace('.page', '')}`;
+            }
+            else {
+                return 'lightning/setup/FlexiPageList/home';
+            }
+        }
+        catch (error) {
+            return 'lightning/setup/FlexiPageList/home';
+        }
+    }
 }
 exports.OrgOpenCommand = OrgOpenCommand;
 OrgOpenCommand.summary = messages.getMessage('summary');
 OrgOpenCommand.description = messages.getMessage('description');
 OrgOpenCommand.examples = messages.getMessages('examples');
-OrgOpenCommand.aliases = ['force:org:open'];
+OrgOpenCommand.aliases = ['force:org:open', 'force:source:open'];
 OrgOpenCommand.deprecateAliases = true;
 OrgOpenCommand.flags = {
     'target-org': sf_plugins_core_1.requiredOrgFlagWithDeprecations,
@@ -98,6 +125,7 @@ OrgOpenCommand.flags = {
         char: 'p',
         summary: messages.getMessage('flags.path.summary'),
         env: 'FORCE_OPEN_URL',
+        exclusive: ['source-file'],
         parse: (input) => Promise.resolve(encodeURIComponent(decodeURIComponent(input))),
     }),
     'url-only': sf_plugins_core_1.Flags.boolean({
@@ -107,5 +135,12 @@ OrgOpenCommand.flags = {
         deprecateAliases: true,
     }),
     loglevel: sf_plugins_core_1.loglevel,
+    'source-file': sf_plugins_core_1.Flags.file({
+        char: 'f',
+        aliases: ['sourcefile'],
+        exclusive: ['path'],
+        deprecateAliases: true,
+        summary: messages.getMessage('flags.source-file.summary'),
+    }),
 };
 //# sourceMappingURL=open.js.map

package/lib/commands/org/open.js.map

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

package/messages/list.metadata.md

@@ -0,0 +1,47 @@
+# description
+
+Use this command to identify individual components in your manifest file or if you want a high-level view of particular metadata types in your org. For example, you can use this command to return a list of names of all the CustomObject or Layout components in your org, then use this information in a retrieve command that returns a subset of these components.
+
+The username that you use to connect to the org must have the Modify All Data or Modify Metadata Through Metadata API Functions permission.
+
+# summary
+
+List the metadata components and properties of a specified type.
+
+# examples
+
+- List the CustomObject components, and their properties, in the org with alias "my-dev-org":
+
+  $ <%= config.bin %> <%= command.id %> --metadata-type CustomObject --target-org my-dev-org
+
+- List the CustomObject components in your default org, write the output to the specified file, and use API version 57.0:
+
+  $ <%= config.bin %> <%= command.id %> --metadata-type CustomObject --api-version 57.0 --output-file /path/to/outputfilename.txt
+
+- List the Dashboard components in your default org that are contained in the "folderSales" folder, write the output to the specified file, and use API version 57.0:
+
+  $ <%= config.bin %> <%= command.id %> --metadata-type Dashboard --folder folderSales --api-version 57.0 --output-file /path/to/outputfilename.txt
+
+# flags.api-version.summary
+
+API version to use; default is the most recent API version.
+
+# flags.output-file.summary
+
+Pathname of the file in which to write the results.
+
+# flags.metadata-type.summary
+
+Metadata type to be retrieved, such as CustomObject; metadata type names are case-sensitive.
+
+# flags.folder.summary
+
+Folder associated with the component; required for components that use folders; folder names are case-sensitive.
+
+# flags.folder.description
+
+Examples of metadata types that use folders are Dashboard, Document, EmailTemplate, and Report.
+
+# noMatchingMetadata
+
+No metadata found for type: %s in org: %s.

package/messages/metadata-types.md

@@ -0,0 +1,37 @@
+# description
+
+The information includes Apex classes and triggers, custom objects, custom fields on standard objects, tab sets that define an app, and many other metadata types. Use this information to identify the syntax needed for a <name> element in a manifest file (package.xml).
+
+The username that you use to connect to the org must have the Modify All Data or Modify Metadata Through Metadata API Functions permission.
+
+# summary
+
+Display details about the metadata types that are enabled for your org.
+
+# examples
+
+- Display information about all known and enabled metadata types in the org with alias "my-dev-org" using API version 57.0:
+
+  $ <%= config.bin %> <%= command.id %> --api-version 57.0 --target-org my-dev-org
+
+- Display only the metadata types that aren't yet supported by Salesforce CLI in your default org and write the results to the specified file:
+
+  $ <%= config.bin %> <%= command.id %> --output-file /path/to/outputfilename.txt --filter-known
+
+# flags.api-version.summary
+
+API version to use; default is the most recent API version.
+
+# flags.output-file.summary
+
+Pathname of the file in which to write the results.
+
+# flags.filter-known.summary
+
+Filter the known metadata types from the result to display only the types not yet fully supported by Salesforce CLI.
+
+filter metadata known by the CLI
+
+# flags.output-file.description
+
+Directing the output to a file makes it easier to extract relevant information for your package.xml manifest file. The default output destination is the terminal or command window console.

package/messages/open.md

@@ -6,6 +6,8 @@ Open your default scratch org, or another specified org, in a browser.
 
 To open a specific page, specify the portion of the URL after "https://MyDomainName.my.salesforce.com/" as the value for the --path flag. For example, specify "--path lightning" to open Lightning Experience, or specify "--path /apex/YourPage" to open a Visualforce page.
 
+Use the --source-file to open a Lightning Page from your local project in Lightning App Builder. Lightning page files have the suffix .flexipage-meta.xml, and are stored in the "flexipages" directory.
+
 To generate a URL but not launch it in your browser, specify --url-only.
 
 To open in a specific browser, use the --browser flag. Supported browsers are "chrome", "edge", and "firefox". If you don't specify --browser, the org opens in your default browser.
@@ -24,10 +26,18 @@ To open in a specific browser, use the --browser flag. Supported browsers are "c
 
   $ <%= config.bin %> <%= command.id %> --url-only --path lightning
 
+- Open a local Lightning page in your default org's Lightning App Builder:
+
+  $ <%= config.bin %> <%= command.id %> --source-path force-app/main/default/flexipages/Hello.flexipage-meta.xml
+
 # flags.browser.summary
 
 Browser where the org opens.
 
+# flags.source-file.summary
+
+Path to an ApexPage or FlexiPage to open in Lightning App Builder.
+
 # flags.path.summary
 
 Navigation URL path to open a specific page.

package/oclif.manifest.json

@@ -1,5 +1,5 @@
 {
-  "version": "2.4.7",
+  "version": "2.5.0",
   "commands": {
     "org:display": {
       "id": "org:display",
@@ -156,18 +156,20 @@
     "org:open": {
       "id": "org:open",
       "summary": "Open your default scratch org, or another specified org, in a browser.",
-      "description": "To open a specific page, specify the portion of the URL after \"https://MyDomainName.my.salesforce.com/\" as the value for the --path flag. For example, specify \"--path lightning\" to open Lightning Experience, or specify \"--path /apex/YourPage\" to open a Visualforce page.\n\nTo generate a URL but not launch it in your browser, specify --url-only.\n\nTo open in a specific browser, use the --browser flag. Supported browsers are \"chrome\", \"edge\", and \"firefox\". If you don't specify --browser, the org opens in your default browser.",
+      "description": "To open a specific page, specify the portion of the URL after \"https://MyDomainName.my.salesforce.com/\" as the value for the --path flag. For example, specify \"--path lightning\" to open Lightning Experience, or specify \"--path /apex/YourPage\" to open a Visualforce page.\n\nUse the --source-file to open a Lightning Page from your local project in Lightning App Builder. Lightning page files have the suffix .flexipage-meta.xml, and are stored in the \"flexipages\" directory.\n\nTo generate a URL but not launch it in your browser, specify --url-only.\n\nTo open in a specific browser, use the --browser flag. Supported browsers are \"chrome\", \"edge\", and \"firefox\". If you don't specify --browser, the org opens in your default browser.",
       "strict": true,
       "pluginName": "@salesforce/plugin-org",
       "pluginAlias": "@salesforce/plugin-org",
       "pluginType": "core",
       "aliases": [
-        "force:org:open"
+        "force:org:open",
+        "force:source:open"
       ],
       "examples": [
         "Open your default org in your default browser:\n$ <%= config.bin %> <%= command.id %>",
         "Open the org with alias MyTestOrg1 in the Firefox browser:\n$ <%= config.bin %> <%= command.id %> --target-org MyTestOrg1 --browser firefox",
-        "Display the navigation URL for the Lightning Experience page for your default org, but don't open the page in a browser:\n$ <%= config.bin %> <%= command.id %> --url-only --path lightning"
+        "Display the navigation URL for the Lightning Experience page for your default org, but don't open the page in a browser:\n$ <%= config.bin %> <%= command.id %> --url-only --path lightning",
+        "Open a local Lightning page in your default org's Lightning App Builder:\n$ <%= config.bin %> <%= command.id %> --source-path force-app/main/default/flexipages/Hello.flexipage-meta.xml"
       ],
       "deprecateAliases": true,
       "flags": {
@@ -224,6 +226,9 @@
           "char": "p",
           "summary": "Navigation URL path to open a specific page.",
           "multiple": false,
+          "exclusive": [
+            "source-file"
+          ],
           "deprecateAliases": true
         },
         "url-only": {
@@ -246,6 +251,20 @@
             "message": "The loglevel flag is no longer in use on this command. You may use it without error, but it will be ignored.\nSet the log level using the `SFDX_LOG_LEVEL` environment variable."
           },
           "deprecateAliases": true
+        },
+        "source-file": {
+          "name": "source-file",
+          "type": "option",
+          "char": "f",
+          "summary": "Path to an ApexPage or FlexiPage to open in Lightning App Builder.",
+          "multiple": false,
+          "exclusive": [
+            "path"
+          ],
+          "deprecateAliases": true,
+          "aliases": [
+            "sourcefile"
+          ]
         }
       },
       "args": {},
@@ -1076,6 +1095,190 @@
       "args": {},
       "hasDynamicHelp": true
     },
+    "org:list:metadata-types": {
+      "id": "org:list:metadata-types",
+      "summary": "Display details about the metadata types that are enabled for your org.",
+      "description": "The information includes Apex classes and triggers, custom objects, custom fields on standard objects, tab sets that define an app, and many other metadata types. Use this information to identify the syntax needed for a <name> element in a manifest file (package.xml).\n\nThe username that you use to connect to the org must have the Modify All Data or Modify Metadata Through Metadata API Functions permission.",
+      "strict": true,
+      "pluginName": "@salesforce/plugin-org",
+      "pluginAlias": "@salesforce/plugin-org",
+      "pluginType": "core",
+      "aliases": [
+        "force:mdapi:describemetadata"
+      ],
+      "examples": [
+        "Display information about all known and enabled metadata types in the org with alias \"my-dev-org\" using API version 57.0:\n$ <%= config.bin %> <%= command.id %> --api-version 57.0 --target-org my-dev-org",
+        "Display only the metadata types that aren't yet supported by Salesforce CLI in your default org and write the results to the specified file:\n$ <%= config.bin %> <%= command.id %> --output-file /path/to/outputfilename.txt --filter-known"
+      ],
+      "deprecateAliases": true,
+      "flags": {
+        "json": {
+          "name": "json",
+          "type": "boolean",
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "allowNo": false,
+          "deprecateAliases": true
+        },
+        "api-version": {
+          "name": "api-version",
+          "type": "option",
+          "summary": "API version to use; default is the most recent API version.",
+          "description": "Override the api version used for api requests made by this command",
+          "multiple": false,
+          "deprecateAliases": true,
+          "aliases": [
+            "apiversion",
+            "a"
+          ]
+        },
+        "loglevel": {
+          "name": "loglevel",
+          "type": "option",
+          "hidden": true,
+          "multiple": false,
+          "deprecated": {
+            "message": "The loglevel flag is no longer in use on this command. You may use it without error, but it will be ignored.\nSet the log level using the `SFDX_LOG_LEVEL` environment variable."
+          },
+          "deprecateAliases": true
+        },
+        "target-org": {
+          "name": "target-org",
+          "type": "option",
+          "char": "o",
+          "summary": "Username or alias of the target org.",
+          "required": true,
+          "multiple": false,
+          "deprecateAliases": true,
+          "aliases": [
+            "targetusername",
+            "u"
+          ]
+        },
+        "output-file": {
+          "name": "output-file",
+          "type": "option",
+          "char": "f",
+          "summary": "Pathname of the file in which to write the results.",
+          "description": "Directing the output to a file makes it easier to extract relevant information for your package.xml manifest file. The default output destination is the terminal or command window console.",
+          "multiple": false,
+          "deprecateAliases": true,
+          "aliases": [
+            "resultfile"
+          ]
+        },
+        "filter-known": {
+          "name": "filter-known",
+          "type": "boolean",
+          "char": "k",
+          "summary": "Filter the known metadata types from the result to display only the types not yet fully supported by Salesforce CLI.\n\nfilter metadata known by the CLI",
+          "hidden": true,
+          "allowNo": false,
+          "deprecateAliases": true,
+          "aliases": [
+            "filterknown"
+          ]
+        }
+      },
+      "args": {},
+      "hasDynamicHelp": true
+    },
+    "org:list:metadata": {
+      "id": "org:list:metadata",
+      "summary": "List the metadata components and properties of a specified type.",
+      "description": "Use this command to identify individual components in your manifest file or if you want a high-level view of particular metadata types in your org. For example, you can use this command to return a list of names of all the CustomObject or Layout components in your org, then use this information in a retrieve command that returns a subset of these components.\n\nThe username that you use to connect to the org must have the Modify All Data or Modify Metadata Through Metadata API Functions permission.",
+      "strict": true,
+      "pluginName": "@salesforce/plugin-org",
+      "pluginAlias": "@salesforce/plugin-org",
+      "pluginType": "core",
+      "aliases": [
+        "force:mdapi:listmetadata"
+      ],
+      "examples": [
+        "List the CustomObject components, and their properties, in the org with alias \"my-dev-org\":\n$ <%= config.bin %> <%= command.id %> --metadata-type CustomObject --target-org my-dev-org",
+        "List the CustomObject components in your default org, write the output to the specified file, and use API version 57.0:\n$ <%= config.bin %> <%= command.id %> --metadata-type CustomObject --api-version 57.0 --output-file /path/to/outputfilename.txt",
+        "List the Dashboard components in your default org that are contained in the \"folderSales\" folder, write the output to the specified file, and use API version 57.0:\n$ <%= config.bin %> <%= command.id %> --metadata-type Dashboard --folder folderSales --api-version 57.0 --output-file /path/to/outputfilename.txt"
+      ],
+      "deprecateAliases": true,
+      "flags": {
+        "json": {
+          "name": "json",
+          "type": "boolean",
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "allowNo": false,
+          "deprecateAliases": true
+        },
+        "api-version": {
+          "name": "api-version",
+          "type": "option",
+          "summary": "API version to use; default is the most recent API version.",
+          "description": "Override the api version used for api requests made by this command",
+          "multiple": false,
+          "deprecateAliases": true,
+          "aliases": [
+            "apiversion",
+            "a"
+          ]
+        },
+        "loglevel": {
+          "name": "loglevel",
+          "type": "option",
+          "hidden": true,
+          "multiple": false,
+          "deprecated": {
+            "message": "The loglevel flag is no longer in use on this command. You may use it without error, but it will be ignored.\nSet the log level using the `SFDX_LOG_LEVEL` environment variable."
+          },
+          "deprecateAliases": true
+        },
+        "target-org": {
+          "name": "target-org",
+          "type": "option",
+          "char": "o",
+          "summary": "Username or alias of the target org.",
+          "required": true,
+          "multiple": false,
+          "deprecateAliases": true,
+          "aliases": [
+            "targetusername",
+            "u"
+          ]
+        },
+        "output-file": {
+          "name": "output-file",
+          "type": "option",
+          "char": "f",
+          "summary": "Pathname of the file in which to write the results.",
+          "multiple": false,
+          "deprecateAliases": true,
+          "aliases": [
+            "resultfile"
+          ]
+        },
+        "metadata-type": {
+          "name": "metadata-type",
+          "type": "option",
+          "char": "m",
+          "summary": "Metadata type to be retrieved, such as CustomObject; metadata type names are case-sensitive.",
+          "required": true,
+          "multiple": false,
+          "deprecateAliases": true,
+          "aliases": [
+            "metadatatype"
+          ]
+        },
+        "folder": {
+          "name": "folder",
+          "type": "option",
+          "summary": "Folder associated with the component; required for components that use folders; folder names are case-sensitive.",
+          "description": "Examples of metadata types that use folders are Dashboard, Document, EmailTemplate, and Report.",
+          "multiple": false,
+          "deprecateAliases": true
+        }
+      },
+      "args": {},
+      "hasDynamicHelp": true
+    },
     "org:resume:sandbox": {
       "id": "org:resume:sandbox",
       "summary": "Check the status of a sandbox creation, and log in to it if it's ready.",

package/package.json

@@ -1,16 +1,17 @@
 {
     "name": "@salesforce/plugin-org",
     "description": "Commands to interact with Salesforce orgs",
-    "version": "2.4.7",
+    "version": "2.5.0",
     "author": "Salesforce",
     "main": "lib/index.js",
     "bugs": "https://github.com/forcedotcom/cli/issues",
     "dependencies": {
-        "@oclif/core": "^2.3.1",
+        "@oclif/core": "^2.6.3",
         "@salesforce/core": "^3.33.5",
         "@salesforce/kit": "^1.9.0",
         "@salesforce/sf-plugins-core": "^2.2.3",
-        "open": "8.4.2",
+        "@salesforce/source-deploy-retrieve": "^7.11.0",
+        "open": "^8.4.2",
         "tslib": "^2"
     },
     "devDependencies": {
@@ -19,6 +20,7 @@
         "@salesforce/dev-config": "^3.1.0",
         "@salesforce/dev-scripts": "^4.1.2",
         "@salesforce/plugin-command-reference": "^2.2.9",
+        "@salesforce/plugin-source": "^2.7.0",
         "@salesforce/prettier-config": "^0.0.2",
         "@salesforce/ts-sinon": "1.4.6",
         "@swc/core": "^1.3.37",
@@ -36,7 +38,7 @@
         "eslint-plugin-header": "^3.0.0",
         "eslint-plugin-import": "2.27.5",
         "eslint-plugin-jsdoc": "^40.0.1",
-        "eslint-plugin-sf-plugin": "^1.8.1",
+        "eslint-plugin-sf-plugin": "^1.13.0",
         "husky": "^7.0.4",
         "mocha": "^9.1.3",
         "moment": "^2.29.1",
@@ -74,7 +76,8 @@
         "devPlugins": [
             "@oclif/plugin-help",
             "@oclif/plugin-command-snapshot",
-            "@salesforce/plugin-command-reference"
+            "@salesforce/plugin-command-reference",
+            "@salesforce/plugin-source"
         ],
         "topics": {
             "org": {
@@ -86,6 +89,9 @@
                     "resume": {
                         "description": "Resume an org creation that was started asynchronously, timed out, or was interrupted."
                     },
+                    "list": {
+                        "description": "list metadata types that are relevant to the org"
+                    },
                     "delete": {
                         "description": "Delete scratch orgs, sandboxes, org shapes, and org snapshots."
                     }
@@ -115,7 +121,7 @@
         "prepack": "sf-prepack",
         "prepare": "sf-install",
         "test": "wireit",
-        "test:nuts": "nyc mocha \"./test/nut/*.nut.ts\" --slow 4500 --timeout 1200000",
+        "test:nuts": "nyc mocha \"./test/nut/*.nut.ts\" --slow 4500 --timeout 1200000 --parallel --jobs 20",
         "test:nuts:legacy": "nyc mocha \"./test/nut/legacy/*.nut.ts\" --slow 4500 --timeout 1200000 --parallel --jobs 10",
         "test:nuts:sandbox": "nyc mocha \"./test/**/*.sandboxNut.ts\" --slow 450000 --timeout 7200000 --parallel --jobs 10",
         "test:only": "wireit",
@@ -232,7 +238,7 @@
         }
     },
     "sfdx": {
-        "publicKeyUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-org/2.4.7.crt",
-        "signatureUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-org/2.4.7.sig"
+        "publicKeyUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-org/2.5.0.crt",
+        "signatureUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-org/2.5.0.sig"
     }
 }