sf-raven 1.0.0

package/README.md

@@ -0,0 +1,370 @@
+# sf-raven
+
+A plugin for the Salesforce CLI built by Tom Carman.
+
+[sf-raven](https://github.com/tomcarman/sf-raven) now replaces [sfdx-raven](https://github.com/tomcarman/sfdx-raven/).
+
+## Why a new plugin?
+
+[sfdx-raven](https://github.com/tomcarman/sfdx-raven/) was originally built in 2020, but the Salesforce CLI landscape has changed a lot since then. Rather than attempting to [migrate the original plugin from sfdx to sf](https://github.com/salesforcecli/cli/wiki/Migrate-Plugins-Built-for-sfdx), it felt cleaner to start a new project and leverage the new architecture and scaffolding tools that come with the new sf cli.
+
+## Improvements over sfdx-raven
+
+- Built on [sf not sfdx](https://developer.salesforce.com/docs/atlas.en-us.sfdx_setup.meta/sfdx_setup/sfdx_setup_move_to_sf_v2.htm).
+- Uses the latest version of [oclif](https://oclif.io/blog/2022/01/12/announcing-oclif-v2/).
+- Commands now follow the [sf command structure](https://github.com/salesforcecli/cli/wiki/Design-Guidelines#Command-Structure) guidelines - `<topic> <action> <resource | sub-action> [flags]`. For example:
+  - `info:fields` becomes `object display fields`
+  - `utils:event:listen` becomes `event subscribe`
+- Code now meets ESlint rules for TypeScript, including the Salesforce CLI Plugin custom rules.
+- The [Salesforce tooling / documentation](https://github.com/salesforcecli/cli/wiki/Code-Your-Plugin) for building custom plugins has matured a lot over the past couple years, which will make it easier to update the plugin going forward.
+
+More commands will be ported/added over time - see [Todo](#Todo).
+
+## Command Quick Reference
+
+Full details, usage, examples etc are further down, or can be accessed via `--help` on the commands.
+
+#### sf raven object display
+
+- [sf raven object display fields](#sf-raven-object-display-fields)
+  - Show field information for a given sObject.
+- [sf raven object display recordtypes](#sf-raven-object-display-recordtypes)
+  - Show RecordType information for a given sObject.
+
+#### sf raven event
+
+- [sf raven event subscribe](#sf-raven-event-subscribe)
+  - Subscribe to Platform Events.
+
+<!-- #### sfdx:raven:utils
+* [sfdx raven:utils:deploy:branch2org](#sfdx-ravenutilsdeploybranch2org)
+  * Deploy a git branch to an org
+* [sfdx raven:utils:diff](#sfdx-ravenutilsdiff)
+  * Diff individual metadata items (class, object etc) between orgs
+* [sfdx raven:utils:dashboarduser:update](#sfdx-ravenutilsdashboarduserupdate)
+  * Change the running user of Dashboards -->
+
+## Setup
+
+### Quick Install
+
+Assuming you already have the [SDFX CLI](https://developer.salesforce.com/docs/atlas.en-us.sfdx_setup.meta/sfdx_setup/sfdx_setup_install_cli.htm) installed, just run:
+
+`sf plugins install sf-raven`
+
+Note: You'll be prompted that this is not officially code-signed by Salesforce - like any custom plugin. You can just accept this when prompted, or alternatively you can [whitelist it](https://developer.salesforce.com/docs/atlas.en-us.sfdx_setup.meta/sfdx_setup/sfdx_setup_allowlist.htm)
+
+### Updating the plugin
+
+The plugin can be updated to the latest version using
+
+`sf plugins update`
+
+### Install from source
+
+1. Install the [SDFX CLI](https://developer.salesforce.com/docs/atlas.en-us.sfdx_setup.meta/sfdx_setup/sfdx_setup_install_cli.htm)
+2. Clone the repository: `git clone git@github.com:tomcarman/sf-raven.git`
+3. Install npm modules: `npm install`
+4. Link the plugin: `sfdx plugins:link .`
+
+## Compatibility
+
+- **macOS**
+  - Plugin has been built on macOS and will always run on macOS
+
+<!-- * **Windows**
+  * Work on Windows 10 1803+ (this is that latest build I have access to)
+  * Known Issues:
+    * Emoji will not work in cmd.exe / powershell - so you may seem some funny characters when running the plugin - this can be ignored. Emoji may work in Windows Terminal, but I have not managed to test yet
+    * I don't think 'diff' is available on windows cli, so `sfdx:raven:utils:diff` is not likely to work.
+
+* **Linux**
+  * Only tested on an Ubuntu installation on [WSL](https://docs.microsoft.com/en-us/windows/wsl/about), but should work. -->
+
+## Todo
+
+- Migrate remaining commands from [sfdx-raven](https://github.com/tomcarman/sfdx-raven/)
+  - sfdx raven:utils:deploy:branch2org
+  - sfdx raven:utils:diff
+  - sfdx raven:utils:dashboarduser:update - tbc
+- Audit Trail inspector
+  - Allow you to quickly search audit trail by username, metadata item, most recent 50 etc.
+- Get the sObject Type for a given Id
+- Get the picklist values for a given picklist
+- Clone a record
+
+## sf raven object display fields
+
+Show field information for a given sObject.
+
+```
+USAGE
+  $ sf object display fields -o <value> -s <value> [--json]
+
+FLAGS
+  -o, --target-org=<value>  (required) Login username or alias for the target org.
+  -s, --sobject=<value>     (required) The API name of the sObject that you want to view fields for.
+
+GLOBAL FLAGS
+  --json  Format output as json.
+
+DESCRIPTION
+  Show field information for a given sObject.
+
+  FieldDefinition metadata is queried for the given sObject. The field Labels, API names, and Type are displayed.
+
+EXAMPLES
+  $ sf object display fields --target-org dev --sobject Account
+
+  $ sf object display fields --target-org dev --sobject My_Custom_Object__c
+
+
+OUTPUT
+
+Name               Developer Name  Type
+────────────────── ─────────────── ─────────────────
+Account Number     AccountNumber   Text(40)
+Account Source     AccountSource   Picklist
+Annual Revenue     AnnualRevenue   Currency(18, 0)
+...
+```
+
+## sf raven object display recordtypes
+
+Show RecordType information for a given sObject.
+
+```
+USAGE
+  $ sf object display recordtypes -o <value> -s <value> [--json]
+
+FLAGS
+  -o, --target-org=<value>  (required) Login username or alias for the target org.
+  -s, --sobject=<value>     (required) The API name of the sObject that you want to view Record Types for.
+
+GLOBAL FLAGS
+  --json  Format output as json.
+
+DESCRIPTION
+  Show RecordType information for a given sObject.
+
+  RecordType metadata is queried for the given sObject. The RecordType Name, DeveloperName, and Id are displayed.
+
+EXAMPLES
+  $ sf object display recordtypes --target-org dev --sobject Account
+
+  $ sf object display recordtypes --target-org dev --sobject My_Custom_Object__c
+
+
+OUTPUT
+
+Name                Developer Name          Id
+─────────────────── ─────────────────────── ──────────────────
+Business Account    Business_Account        0124J000000XXXXABC
+Person Account      PersonAccount           0124J000000YYYYDEF
+...
+```
+
+## sf raven event subscribe
+
+Subscribe to Platform Events.
+
+```
+USAGE
+  $ sf event subscribe -o <value> -e <value> [--json] [-r <value>] [-t <value>]
+
+FLAGS
+  -e, --event=<value>       (required) The name of the Platform Event that you want to subscribe with '/event/' prefix eg. /event/My_Event__e.
+  -o, --target-org=<value>  (required) Login username or alias for the target org.
+  -r, --replayid=<value>    The replay id to replay events from eg. 21980378.
+  -t, --timeout=<value>     [default: 3] How long to subscribe for before timing out in minutes eg. 10. Default is 3 minutes.
+
+GLOBAL FLAGS
+  --json  Format output as json.
+
+DESCRIPTION
+  Subscribe to Platform Events.
+
+  Platform Events are printed to the terminal. An optional flag can be used to relay events from a given relayid. Defaut timeout is 3 minutes, but can be extended to 30 minutes.
+
+EXAMPLES
+  $ sf event subscribe --target-org dev --event /event/My_Event__e
+
+  $ sf event subscribe --target-org dev --event /event/My_Event__e --replayid 21980378
+
+  $ sf event subscribe --target-org dev --event /event/My_Event__e --timeout 10
+
+  $ sf event subscribe --target-org dev --event /event/My_Event__e --replayid 21980378 --timeout 10
+
+
+OUTPUT
+
+❯ 🔌 Connecting to org... done
+❯ 📡 Listening for events...
+
+{
+  "schema": "XdDXhymeO5NOxuhzFpgDJA",
+  "payload": {
+    "Some_Event_Field__c": "Hello World",
+    "CreatedDate": "2021-03-15T19:16:54.929Z",
+  },
+  "event": {
+    "replayId": 21980379
+  }
+}
+```
+
+<!-- ## sfdx raven:utils:deploy:branch2org
+
+Deploys a git branch to an org. Assumes you have git installed the neccessary access to the repo you are trying to clone (eg. you can run `git clone ...`), and that the branch is in a source-format sfdx project structure.
+
+```
+USAGE
+  $ sfdx raven:utils:deploy:branch2org
+
+OPTIONS
+  -u, --targetusername
+      (required) sets a username or alias for the target org that you wish to deploy to. overrides the default target org.
+
+  -r, --repository
+      (required) URL of the repo. It can either be an HTTPs URL (eg. 'https://github.com/user/some-repo.git') and you
+      will be prompted to enter a username and password, or an SSH URL (eg. 'git@github.com:user/some-repo.git')
+      which assumes you have SSH keys configured for this repo.
+
+  -b, --branch
+      (required) the branch you wish to deploy
+
+  -c, --checkonly
+      (optional) Validates the deployed metadata and runs all Apex tests, but prevents the
+      deployment from being saved to the org.
+
+  -h, --help
+      show CLI help
+
+  --json
+      format output as json
+
+  --loglevel              l
+      ogging level for this command invocation
+
+EXAMPLE
+  $ sfdx raven:utils:deploy:branch2org -r git@github.com:user/some-repo.git -b branchName -u orgName`
+  or
+  $ sfdx raven:utils:deploy:branch2org -r https://github.com/user/some-repo.git -b branchName -u orgName`
+
+
+OUTPUT
+
+❯ Cloning repo & checking out 'branchName'... done
+❯ Converting from source format to metadata format... done
+❯ Initiating deployment... done
+
+❯ The deployment has been requested with id: 0Af4K00000BHVuAXXX
+
+❯ Deployment InProgress (0/31) Processing Type: CustomObject
+❯ Deployment InProgress (21/31) Processing Type: CustomTab
+❯ Deployment InProgress (30/31) Processing Type: Profile
+❯ Deployment Succeeded
+
+❯ Link to deployment page in Salesforce:
+https://wise-hawk-22uzds-dev-ed.my.salesforce.com/lightning/setup/DeployStatus/page?address=%2Fchangemgmt%2FmonitorDeploymentsDetails.apexp%3FasyncId%3D0Af4K00000BHVuASAX
+```
+
+## sfdx raven:utils:diff
+
+Allows you to quickly compare metadata of files between two orgs. Intended to be used for quick compares of single
+(or possibly a few) files of the same metadata type, rather than a full org compare (there are better tools for
+that) The results are stored in a diff_{timestamp}.html file wherever you run the command from, and automatically
+opened in a browser.
+
+```
+USAGE
+  $ sfdx raven:utils:diff -s <string> -t <string> -o <string> -i <string> [--filename <string>] [-f <string>]
+  [--silent] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]
+
+OPTIONS
+  -f, --format=format
+      (optional) Format of the diff. Options are 'line' (inline diff) or 'side' (side-by-side diff). Defaults to 'line'
+
+  -i, --items=items
+      (required) The items you wish to compare eg. MyCoolClass or Account. Can be multiple items comma delimted eg.
+      MyClass,MyController or Account,Opportunity (but can only be of one 'type')
+
+  -o, --type=type
+      (required) The type of metadata you want to compare eg. ApexClass or CustomObject
+
+  -s, --source=source
+      (required) Alias / Username of the org you want to use as the SOURCE of the diff eg. projectDev
+
+  -t, --target=target
+      (required) Alias / Username of the org you want to use as the TARGET of the diff eg. projectQA
+
+  --filename=filename
+      (optional) The filename of the diff.html. Defaults to diff_{timestamp}.html
+
+  --json
+      format output as json
+
+  --loglevel=(trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL)
+      [default: warn] logging level for this command invocation
+
+  --silent
+      use this to not auto open browser with results
+
+EXAMPLES
+  $ sfdx raven:utils:diff --source dev_org --target qa_org --type CustomObject --items Account
+  $ sfdx raven:utils:diff --source dev_org --target qa_org --type CustomObject --items 'Account,Opportunity'
+  $ sfdx raven:utils:diff --source dev_org --target qa_org --type ApexClass --items MyClass
+  $ sfdx raven:utils:diff --source dev_org --target qa_org --type ApexClass --items 'MyClass,MyTestClass,MyController
+  $ sfdx  raven:utils:diff -s dev_org -t qa_org -o CustomObject -i 'Account'
+  $ sfdx  raven:utils:diff -s dev_org -t qa_org -o ApexClass -i 'MyClass'
+  $ sfdx  raven:utils:diff -s dev_org -t qa_org -o ApexClass -i 'MyClass' --silent
+
+OUTPUT
+
+❯ sfdx raven:utils:diff --source trailhead --target dev --type ApexClass --items 'HelloWorld'
+🗂️  Building package.xml... done
+⏬ Retrieving from trailhead... done
+⏬ Retrieving from dev... done
+📂 Unzipping metadata... done
+👨‍🍳 Preparing diff... done
+✨ Cleaning up... done
+🌐 Opening with diff2html in browser... done
+```
+<img width="795" alt="diff" src="https://user-images.githubusercontent.com/1554713/111902572-057edf80-8a36-11eb-8c45-56c09c290e89.png">
+
+
+## sfdx raven:utils:dashboarduser:update
+
+Updates the "Running User" of Dashboards from a given user, to an alternate given user. Useful for mass-updating Dashboards when a user is deactivated.
+
+You will have the following additional options when running -
+
+* A list of Dashboards that will be affected as part of the script will be displayed, with the option to abort if desired.
+* The final step to deploy the changes back to the org can be skipped when prompted, allowing for the manual deploy of the patched metadata files - this might be desirable when running against Production environments with strict deployment practices, or if you maintain Dashboard metadata in source control and want to commit the files.
+
+```
+USAGE
+  $ sfdx raven:utils:dashboarduser:update
+
+OPTIONS
+  -u, --targetusername
+      (required) sets a username or alias for the target org. overrides the default target org.
+
+  -f, --from
+      (required) the username of the user which is currently the 'running user' of the Dashboards eg. 'tom.carman@ecorp.com'
+
+  -t, --to.
+      (required) the username of the user which you want to make the new 'running user' of the Dashboards eg. 'james.moriarty@ecorp.com'
+
+  -h, --help
+      show CLI help
+
+  --json
+      format output as json
+
+  --loglevel
+      logging level for this command invocation
+
+EXAMPLE
+  $ sfdx raven:utils:dashboarduser:update -u ecorp-dev --from tom.carman@ecorp.com --to james.moriarty@ecorp.com`
+``` -->

package/lib/commands/event/subscribe.d.ts

@@ -0,0 +1,16 @@
+import { SfCommand } from '@salesforce/sf-plugins-core';
+export type EventSubscribeResult = {
+    status: string;
+};
+export default class EventSubscribe extends SfCommand<EventSubscribeResult> {
+    static readonly summary: string;
+    static readonly description: string;
+    static readonly examples: string[];
+    static readonly flags: {
+        'target-org': import("@oclif/core/lib/interfaces").OptionFlag<import("@salesforce/core").Org, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        event: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        replayid: import("@oclif/core/lib/interfaces").OptionFlag<number | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        timeout: import("@oclif/core/lib/interfaces").OptionFlag<number, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+    };
+    run(): Promise<EventSubscribeResult>;
+}

package/lib/commands/event/subscribe.js

@@ -0,0 +1,71 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const sf_plugins_core_1 = require("@salesforce/sf-plugins-core");
+const core_1 = require("@salesforce/core");
+const lib_1 = require("@salesforce/kit/lib");
+const emoji = require("node-emoji");
+core_1.Messages.importMessagesDirectory(__dirname);
+const messages = core_1.Messages.loadMessages('sf-raven', 'event.subscribe');
+class EventSubscribe extends sf_plugins_core_1.SfCommand {
+    async run() {
+        const { flags } = await this.parse(EventSubscribe);
+        const ux = new sf_plugins_core_1.Ux({ jsonEnabled: this.jsonEnabled() });
+        // Set up stream client and stream processor
+        ux.spinner.start(`${emoji.get('electric_plug')} Connecting to org`);
+        const streamProcessor = (message) => {
+            ux.log(JSON.stringify(message, null, 2) + '\n');
+            return {
+                completed: false,
+            };
+        };
+        const options = new core_1.StreamingClient.DefaultOptions(flags['target-org'], flags.event, streamProcessor);
+        if (flags.timeout != null) {
+            options.setSubscribeTimeout(lib_1.Duration.minutes(flags.timeout));
+        }
+        // Connect to the org
+        const asyncStatusClient = await core_1.StreamingClient.create(options);
+        await asyncStatusClient.handshake();
+        ux.spinner.stop();
+        // Set the relay id if one has been supplied
+        if (flags.replayid != null) {
+            ux.log(`${emoji.get('leftwards_arrow_with_hook')}  Replaying from ${flags.replayid}`);
+            asyncStatusClient.replay(flags.replayid);
+        }
+        // Start listening for events
+        ux.log(`${emoji.get('ear')} Listening for events...\n`);
+        await asyncStatusClient.subscribe(async () => {
+            // Nothing to do
+        });
+        return {
+            status: 'Exiting',
+        };
+    }
+}
+EventSubscribe.summary = messages.getMessage('summary');
+EventSubscribe.description = messages.getMessage('description');
+EventSubscribe.examples = messages.getMessages('examples');
+EventSubscribe.flags = {
+    'target-org': sf_plugins_core_1.Flags.requiredOrg({
+        summary: messages.getMessage('flags.target-org.summary'),
+        char: 'o',
+        required: true,
+    }),
+    event: sf_plugins_core_1.Flags.string({
+        summary: messages.getMessage('flags.event.summary'),
+        char: 'e',
+        required: true,
+    }),
+    replayid: sf_plugins_core_1.Flags.integer({
+        summary: messages.getMessage('flags.replayid.summary'),
+        char: 'r',
+    }),
+    timeout: sf_plugins_core_1.Flags.integer({
+        summary: messages.getMessage('flags.timeout.summary'),
+        char: 't',
+        min: 1,
+        max: 30,
+        default: 3,
+    }),
+};
+exports.default = EventSubscribe;
+//# sourceMappingURL=subscribe.js.map

package/lib/commands/event/subscribe.js.map

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

package/lib/commands/hello/world.d.ts

@@ -0,0 +1,14 @@
+import { SfCommand } from '@salesforce/sf-plugins-core';
+export type HelloWorldResult = {
+    name: string;
+    time: string;
+};
+export default class World extends SfCommand<HelloWorldResult> {
+    static readonly summary: string;
+    static readonly description: string;
+    static readonly examples: string[];
+    static readonly flags: {
+        name: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+    };
+    run(): Promise<HelloWorldResult>;
+}

package/lib/commands/hello/world.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const sf_plugins_core_1 = require("@salesforce/sf-plugins-core");
+const core_1 = require("@salesforce/core");
+core_1.Messages.importMessagesDirectory(__dirname);
+const messages = core_1.Messages.loadMessages('sf-raven', 'hello.world');
+class World extends sf_plugins_core_1.SfCommand {
+    async run() {
+        const { flags } = await this.parse(World);
+        const time = new Date().toDateString();
+        this.log(messages.getMessage('info.hello', [flags.name, time]));
+        return {
+            name: flags.name,
+            time,
+        };
+    }
+}
+World.summary = messages.getMessage('summary');
+World.description = messages.getMessage('description');
+World.examples = messages.getMessages('examples');
+World.flags = {
+    name: sf_plugins_core_1.Flags.string({
+        char: 'n',
+        summary: messages.getMessage('flags.name.summary'),
+        description: messages.getMessage('flags.name.description'),
+        default: 'World',
+    }),
+};
+exports.default = World;
+//# sourceMappingURL=world.js.map

package/lib/commands/hello/world.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"world.js","sourceRoot":"","sources":["../../../src/commands/hello/world.ts"],"names":[],"mappings":";;AAAA,iEAA+D;AAC/D,2CAA4C;AAE5C,eAAQ,CAAC,uBAAuB,CAAC,SAAS,CAAC,CAAC;AAC5C,MAAM,QAAQ,GAAG,eAAQ,CAAC,YAAY,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;AAOlE,MAAqB,KAAM,SAAQ,2BAA2B;IAcrD,KAAK,CAAC,GAAG;QACd,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC1C,MAAM,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC,YAAY,EAAE,CAAC;QACvC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,UAAU,CAAC,YAAY,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;QAChE,OAAO;YACL,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,IAAI;SACL,CAAC;IACJ,CAAC;;AArBsB,aAAO,GAAG,QAAQ,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;AACzC,iBAAW,GAAG,QAAQ,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;AACjD,cAAQ,GAAG,QAAQ,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;AAE5C,WAAK,GAAG;IAC7B,IAAI,EAAE,uBAAK,CAAC,MAAM,CAAC;QACjB,IAAI,EAAE,GAAG;QACT,OAAO,EAAE,QAAQ,CAAC,UAAU,CAAC,oBAAoB,CAAC;QAClD,WAAW,EAAE,QAAQ,CAAC,UAAU,CAAC,wBAAwB,CAAC;QAC1D,OAAO,EAAE,OAAO;KACjB,CAAC;CACH,CAAC;kBAZiB,KAAK"}

package/lib/commands/object/display/fields.d.ts

@@ -0,0 +1,14 @@
+import { SfCommand } from '@salesforce/sf-plugins-core';
+export type ObjectDisplayFieldsResult = {
+    result: object;
+};
+export default class ObjectDisplayFields extends SfCommand<ObjectDisplayFieldsResult> {
+    static readonly summary: string;
+    static readonly description: string;
+    static readonly examples: string[];
+    static readonly flags: {
+        'target-org': import("@oclif/core/lib/interfaces").OptionFlag<import("@salesforce/core").Org, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        sobject: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+    };
+    run(): Promise<ObjectDisplayFieldsResult>;
+}

package/lib/commands/object/display/fields.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const sf_plugins_core_1 = require("@salesforce/sf-plugins-core");
+const core_1 = require("@salesforce/core");
+core_1.Messages.importMessagesDirectory(__dirname);
+const messages = core_1.Messages.loadMessages('sf-raven', 'object.display.fields');
+class ObjectDisplayFields extends sf_plugins_core_1.SfCommand {
+    async run() {
+        this.spinner.start('Loading...');
+        const { flags } = await this.parse(ObjectDisplayFields);
+        const ux = new sf_plugins_core_1.Ux({ jsonEnabled: this.jsonEnabled() });
+        const org = flags['target-org'];
+        const conn = org.getConnection();
+        const query = `SELECT Label, QualifiedApiName, DataType FROM FieldDefinition WHERE EntityDefinition.QualifiedApiName = '${flags.sobject}' ORDER BY QualifiedApiName`;
+        const result = (await conn.query(query));
+        this.spinner.stop();
+        // Return table of fields
+        ux.table(result.records, {
+            label: {
+                header: 'Name',
+                get: (row) => row.Label,
+            },
+            qualifiedApiName: {
+                header: 'Developer Name',
+                get: (row) => row.QualifiedApiName,
+            },
+            dataType: {
+                header: 'Type',
+                get: (row) => row.DataType,
+            },
+        });
+        // Return url
+        ux.log(`\n${conn.instanceUrl}/lightning/setup/ObjectManager/${flags.sobject}/FieldsAndRelationships/view`);
+        // Return an object to be displayed with --json
+        return result;
+    }
+}
+ObjectDisplayFields.summary = messages.getMessage('summary');
+ObjectDisplayFields.description = messages.getMessage('description');
+ObjectDisplayFields.examples = messages.getMessages('examples');
+ObjectDisplayFields.flags = {
+    'target-org': sf_plugins_core_1.Flags.requiredOrg({
+        summary: messages.getMessage('flags.target-org.summary'),
+        char: 'o',
+        required: true,
+    }),
+    sobject: sf_plugins_core_1.Flags.string({
+        summary: messages.getMessage('flags.sobject.summary'),
+        char: 's',
+        required: true,
+    }),
+};
+exports.default = ObjectDisplayFields;
+//# sourceMappingURL=fields.js.map

package/lib/commands/object/display/fields.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fields.js","sourceRoot":"","sources":["../../../../src/commands/object/display/fields.ts"],"names":[],"mappings":";;AAAA,iEAAmE;AACnE,2CAA4C;AAE5C,eAAQ,CAAC,uBAAuB,CAAC,SAAS,CAAC,CAAC;AAC5C,MAAM,QAAQ,GAAG,eAAQ,CAAC,YAAY,CAAC,UAAU,EAAE,uBAAuB,CAAC,CAAC;AAM5E,MAAqB,mBAAoB,SAAQ,2BAAoC;IAkB5E,KAAK,CAAC,GAAG;QACd,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;QAgBjC,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC;QACxD,MAAM,EAAE,GAAG,IAAI,oBAAE,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;QAEvD,MAAM,GAAG,GAAG,KAAK,CAAC,YAAY,CAAC,CAAC;QAChC,MAAM,IAAI,GAAG,GAAG,CAAC,aAAa,EAAE,CAAC;QACjC,MAAM,KAAK,GAAG,4GAA4G,KAAK,CAAC,OAAO,6BAA6B,CAAC;QACrK,MAAM,MAAM,GAAG,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAgB,CAAC;QAExD,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;QAEpB,yBAAyB;QACzB,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE;YACvB,KAAK,EAAE;gBACL,MAAM,EAAE,MAAM;gBACd,GAAG,EAAE,CAAC,GAAW,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK;aAChC;YACD,gBAAgB,EAAE;gBAChB,MAAM,EAAE,gBAAgB;gBACxB,GAAG,EAAE,CAAC,GAAW,EAAE,EAAE,CAAC,GAAG,CAAC,gBAAgB;aAC3C;YACD,QAAQ,EAAE;gBACR,MAAM,EAAE,MAAM;gBACd,GAAG,EAAE,CAAC,GAAW,EAAE,EAAE,CAAC,GAAG,CAAC,QAAQ;aACnC;SACF,CAAC,CAAC;QAEH,aAAa;QACb,EAAE,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,WAAW,kCAAkC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC;QAE3G,+CAA+C;QAC/C,OAAO,MAA8C,CAAC;IACxD,CAAC;;AAjEsB,2BAAO,GAAG,QAAQ,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;AACzC,+BAAW,GAAG,QAAQ,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;AACjD,4BAAQ,GAAG,QAAQ,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;AAE5C,yBAAK,GAAG;IAC7B,YAAY,EAAE,uBAAK,CAAC,WAAW,CAAC;QAC9B,OAAO,EAAE,QAAQ,CAAC,UAAU,CAAC,0BAA0B,CAAC;QACxD,IAAI,EAAE,GAAG;QACT,QAAQ,EAAE,IAAI;KACf,CAAC;IACF,OAAO,EAAE,uBAAK,CAAC,MAAM,CAAC;QACpB,OAAO,EAAE,QAAQ,CAAC,UAAU,CAAC,uBAAuB,CAAC;QACrD,IAAI,EAAE,GAAG;QACT,QAAQ,EAAE,IAAI;KACf,CAAC;CACH,CAAC;kBAhBiB,mBAAmB"}

package/lib/commands/object/display/recordtypes.d.ts

@@ -0,0 +1,14 @@
+import { SfCommand } from '@salesforce/sf-plugins-core';
+export type ObjectDisplayRecordtypesResult = {
+    result: object;
+};
+export default class ObjectDisplayRecordtypes extends SfCommand<ObjectDisplayRecordtypesResult> {
+    static readonly summary: string;
+    static readonly description: string;
+    static readonly examples: string[];
+    static readonly flags: {
+        'target-org': import("@oclif/core/lib/interfaces").OptionFlag<import("@salesforce/core").Org, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        sobject: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+    };
+    run(): Promise<ObjectDisplayRecordtypesResult>;
+}

package/lib/commands/object/display/recordtypes.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const sf_plugins_core_1 = require("@salesforce/sf-plugins-core");
+const core_1 = require("@salesforce/core");
+core_1.Messages.importMessagesDirectory(__dirname);
+const messages = core_1.Messages.loadMessages('sf-raven', 'object.display.recordtypes');
+class ObjectDisplayRecordtypes extends sf_plugins_core_1.SfCommand {
+    async run() {
+        this.spinner.start('Loading...');
+        const { flags } = await this.parse(ObjectDisplayRecordtypes);
+        const ux = new sf_plugins_core_1.Ux({ jsonEnabled: this.jsonEnabled() });
+        const org = flags['target-org'];
+        const conn = org.getConnection();
+        const query = `SELECT Name, DeveloperName, Id FROM RecordType WHERE SObjectType = '${flags.sobject}'`;
+        const result = (await conn.query(query));
+        this.spinner.stop();
+        // Return table of fields
+        ux.table(result.records, {
+            label: {
+                header: 'Name',
+                get: (row) => row.Name,
+            },
+            qualifiedApiName: {
+                header: 'Developer Name',
+                get: (row) => row.DeveloperName,
+            },
+            dataType: {
+                header: 'Id',
+                get: (row) => row.Id,
+            },
+        });
+        // Return url
+        ux.log(`\n${conn.instanceUrl}/lightning/setup/ObjectManager/${flags.sobject}/RecordTypes/view`);
+        // Return an object to be displayed with --json
+        return result;
+    }
+}
+ObjectDisplayRecordtypes.summary = messages.getMessage('summary');
+ObjectDisplayRecordtypes.description = messages.getMessage('description');
+ObjectDisplayRecordtypes.examples = messages.getMessages('examples');
+ObjectDisplayRecordtypes.flags = {
+    'target-org': sf_plugins_core_1.Flags.requiredOrg({
+        summary: messages.getMessage('flags.target-org.summary'),
+        char: 'o',
+        required: true,
+    }),
+    sobject: sf_plugins_core_1.Flags.string({
+        summary: messages.getMessage('flags.sobject.summary'),
+        char: 's',
+        required: true,
+    }),
+};
+exports.default = ObjectDisplayRecordtypes;
+//# sourceMappingURL=recordtypes.js.map

package/lib/commands/object/display/recordtypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recordtypes.js","sourceRoot":"","sources":["../../../../src/commands/object/display/recordtypes.ts"],"names":[],"mappings":";;AAAA,iEAAmE;AACnE,2CAA4C;AAE5C,eAAQ,CAAC,uBAAuB,CAAC,SAAS,CAAC,CAAC;AAC5C,MAAM,QAAQ,GAAG,eAAQ,CAAC,YAAY,CAAC,UAAU,EAAE,4BAA4B,CAAC,CAAC;AAMjF,MAAqB,wBAAyB,SAAQ,2BAAyC;IAkBtF,KAAK,CAAC,GAAG;QACd,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;QAgBjC,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAC;QAC7D,MAAM,EAAE,GAAG,IAAI,oBAAE,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;QAEvD,MAAM,GAAG,GAAG,KAAK,CAAC,YAAY,CAAC,CAAC;QAChC,MAAM,IAAI,GAAG,GAAG,CAAC,aAAa,EAAE,CAAC;QACjC,MAAM,KAAK,GAAG,uEAAuE,KAAK,CAAC,OAAO,GAAG,CAAC;QAEtG,MAAM,MAAM,GAAG,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAgB,CAAC;QAExD,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;QAEpB,yBAAyB;QACzB,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE;YACvB,KAAK,EAAE;gBACL,MAAM,EAAE,MAAM;gBACd,GAAG,EAAE,CAAC,GAAW,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI;aAC/B;YACD,gBAAgB,EAAE;gBAChB,MAAM,EAAE,gBAAgB;gBACxB,GAAG,EAAE,CAAC,GAAW,EAAE,EAAE,CAAC,GAAG,CAAC,aAAa;aACxC;YACD,QAAQ,EAAE;gBACR,MAAM,EAAE,IAAI;gBACZ,GAAG,EAAE,CAAC,GAAW,EAAE,EAAE,CAAC,GAAG,CAAC,EAAE;aAC7B;SACF,CAAC,CAAC;QAEH,aAAa;QACb,EAAE,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,WAAW,kCAAkC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;QAEhG,+CAA+C;QAC/C,OAAO,MAAmD,CAAC;IAC7D,CAAC;;AAlEsB,gCAAO,GAAG,QAAQ,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;AACzC,oCAAW,GAAG,QAAQ,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;AACjD,iCAAQ,GAAG,QAAQ,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;AAE5C,8BAAK,GAAG;IAC7B,YAAY,EAAE,uBAAK,CAAC,WAAW,CAAC;QAC9B,OAAO,EAAE,QAAQ,CAAC,UAAU,CAAC,0BAA0B,CAAC;QACxD,IAAI,EAAE,GAAG;QACT,QAAQ,EAAE,IAAI;KACf,CAAC;IACF,OAAO,EAAE,uBAAK,CAAC,MAAM,CAAC;QACpB,OAAO,EAAE,QAAQ,CAAC,UAAU,CAAC,uBAAuB,CAAC;QACrD,IAAI,EAAE,GAAG;QACT,QAAQ,EAAE,IAAI;KACf,CAAC;CACH,CAAC;kBAhBiB,wBAAwB"}

package/lib/index.d.ts

@@ -0,0 +1,2 @@
+declare const _default: {};
+export = _default;

package/lib/index.js

@@ -0,0 +1,3 @@
+"use strict";
+module.exports = {};
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA,iBAAS,EAAE,CAAC"}

package/messages/event.subscribe.md

@@ -0,0 +1,30 @@
+# summary
+
+Subscribe to Platform Events.
+
+# description
+
+Platform Events are printed to the terminal. An optional flag can be used to relay events from a given relayid. Defaut timeout is 3 minutes, but can be extended to 30 minutes.
+
+# flags.target-org.summary
+
+Login username or alias for the target org.
+
+# flags.event.summary
+
+The name of the Platform Event that you want to subscribe with '/event/' prefix eg. /event/My_Event\_\_e.
+
+# flags.replayid.summary
+
+The replay id to replay events from eg. 21980378.
+
+# flags.timeout.summary
+
+How long to subscribe for before timing out in minutes eg. 10. Default is 3 minutes.
+
+# examples
+
+- <%= config.bin %> <%= command.id %> --target-org dev --event /event/My_Event\_\_e
+- <%= config.bin %> <%= command.id %> --target-org dev --event /event/My_Event\_\_e --replayid 21980378
+- <%= config.bin %> <%= command.id %> --target-org dev --event /event/My_Event\_\_e --timeout 10
+- <%= config.bin %> <%= command.id %> --target-org dev --event /event/My_Event\_\_e --replayid 21980378 --timeout 10

package/messages/hello.world.md

@@ -0,0 +1,29 @@
+# summary
+
+Say hello.
+
+# description
+
+Say hello either to the world or someone you know.
+
+# flags.name.summary
+
+The name of the person you'd like to say hello to.
+
+# flags.name.description
+
+This person can be anyone in the world!
+
+# examples
+
+- Say hello to the world:
+
+  <%= config.bin %> <%= command.id %>
+
+- Say hello to someone you know:
+
+  <%= config.bin %> <%= command.id %> --name Astro
+
+# info.hello
+
+Hello %s at %s.

package/messages/object.display.fields.md

@@ -0,0 +1,21 @@
+# summary
+
+Show field information for a given sObject.
+
+# description
+
+FieldDefinition metadata is queried for the given sObject. The field Labels, API names, and Type are displayed.
+
+# flags.target-org.summary
+
+Login username or alias for the target org.
+
+# flags.sobject.summary
+
+The API name of the sObject that you want to view fields for.
+
+# examples
+
+- <%= config.bin %> <%= command.id %> --target-org dev --sobject Account
+
+- <%= config.bin %> <%= command.id %> --target-org dev --sobject My_Custom_Object\_\_c

package/messages/object.display.recordtypes.md

@@ -0,0 +1,21 @@
+# summary
+
+Show RecordType information for a given sObject.
+
+# description
+
+RecordType metadata is queried for the given sObject. The RecordType Name, DeveloperName, and Id are displayed.
+
+# flags.target-org.summary
+
+Login username or alias for the target org.
+
+# flags.sobject.summary
+
+The API name of the sObject that you want to view Record Types for.
+
+# examples
+
+- <%= config.bin %> <%= command.id %> --target-org dev --sobject Account
+
+- <%= config.bin %> <%= command.id %> --target-org dev --sobject My_Custom_Object\_\_c

package/oclif.manifest.json

@@ -0,0 +1,178 @@
+{
+  "version": "1.0.0",
+  "commands": {
+    "event:subscribe": {
+      "id": "event:subscribe",
+      "summary": "Subscribe to Platform Events.",
+      "description": "Platform Events are printed to the terminal. An optional flag can be used to relay events from a given relayid. Defaut timeout is 3 minutes, but can be extended to 30 minutes.",
+      "strict": true,
+      "pluginName": "sf-raven",
+      "pluginAlias": "sf-raven",
+      "pluginType": "core",
+      "aliases": [],
+      "examples": [
+        "<%= config.bin %> <%= command.id %> --target-org dev --event /event/My_Event\\_\\_e",
+        "<%= config.bin %> <%= command.id %> --target-org dev --event /event/My_Event\\_\\_e --replayid 21980378",
+        "<%= config.bin %> <%= command.id %> --target-org dev --event /event/My_Event\\_\\_e --timeout 10",
+        "<%= config.bin %> <%= command.id %> --target-org dev --event /event/My_Event\\_\\_e --replayid 21980378 --timeout 10"
+      ],
+      "flags": {
+        "json": {
+          "name": "json",
+          "type": "boolean",
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "allowNo": false
+        },
+        "target-org": {
+          "name": "target-org",
+          "type": "option",
+          "char": "o",
+          "summary": "Login username or alias for the target org.",
+          "required": true,
+          "multiple": false
+        },
+        "event": {
+          "name": "event",
+          "type": "option",
+          "char": "e",
+          "summary": "The name of the Platform Event that you want to subscribe with '/event/' prefix eg. /event/My_Event\\_\\_e.",
+          "required": true,
+          "multiple": false
+        },
+        "replayid": {
+          "name": "replayid",
+          "type": "option",
+          "char": "r",
+          "summary": "The replay id to replay events from eg. 21980378.",
+          "multiple": false
+        },
+        "timeout": {
+          "name": "timeout",
+          "type": "option",
+          "char": "t",
+          "summary": "How long to subscribe for before timing out in minutes eg. 10. Default is 3 minutes.",
+          "multiple": false,
+          "default": 3
+        }
+      },
+      "args": {},
+      "hasDynamicHelp": true
+    },
+    "hello:world": {
+      "id": "hello:world",
+      "summary": "Say hello.",
+      "description": "Say hello either to the world or someone you know.",
+      "strict": true,
+      "pluginName": "sf-raven",
+      "pluginAlias": "sf-raven",
+      "pluginType": "core",
+      "aliases": [],
+      "examples": [
+        "Say hello to the world:\n<%= config.bin %> <%= command.id %>",
+        "Say hello to someone you know:\n<%= config.bin %> <%= command.id %> --name Astro"
+      ],
+      "flags": {
+        "json": {
+          "name": "json",
+          "type": "boolean",
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "allowNo": false
+        },
+        "name": {
+          "name": "name",
+          "type": "option",
+          "char": "n",
+          "summary": "The name of the person you'd like to say hello to.",
+          "description": "This person can be anyone in the world!",
+          "multiple": false,
+          "default": "World"
+        }
+      },
+      "args": {}
+    },
+    "object:display:fields": {
+      "id": "object:display:fields",
+      "summary": "Show field information for a given sObject.",
+      "description": "FieldDefinition metadata is queried for the given sObject. The field Labels, API names, and Type are displayed.",
+      "strict": true,
+      "pluginName": "sf-raven",
+      "pluginAlias": "sf-raven",
+      "pluginType": "core",
+      "aliases": [],
+      "examples": [
+        "<%= config.bin %> <%= command.id %> --target-org dev --sobject Account",
+        "<%= config.bin %> <%= command.id %> --target-org dev --sobject My_Custom_Object\\_\\_c"
+      ],
+      "flags": {
+        "json": {
+          "name": "json",
+          "type": "boolean",
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "allowNo": false
+        },
+        "target-org": {
+          "name": "target-org",
+          "type": "option",
+          "char": "o",
+          "summary": "Login username or alias for the target org.",
+          "required": true,
+          "multiple": false
+        },
+        "sobject": {
+          "name": "sobject",
+          "type": "option",
+          "char": "s",
+          "summary": "The API name of the sObject that you want to view fields for.",
+          "required": true,
+          "multiple": false
+        }
+      },
+      "args": {},
+      "hasDynamicHelp": true
+    },
+    "object:display:recordtypes": {
+      "id": "object:display:recordtypes",
+      "summary": "Show RecordType information for a given sObject.",
+      "description": "RecordType metadata is queried for the given sObject. The RecordType Name, DeveloperName, and Id are displayed.",
+      "strict": true,
+      "pluginName": "sf-raven",
+      "pluginAlias": "sf-raven",
+      "pluginType": "core",
+      "aliases": [],
+      "examples": [
+        "<%= config.bin %> <%= command.id %> --target-org dev --sobject Account",
+        "<%= config.bin %> <%= command.id %> --target-org dev --sobject My_Custom_Object\\_\\_c"
+      ],
+      "flags": {
+        "json": {
+          "name": "json",
+          "type": "boolean",
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "allowNo": false
+        },
+        "target-org": {
+          "name": "target-org",
+          "type": "option",
+          "char": "o",
+          "summary": "Login username or alias for the target org.",
+          "required": true,
+          "multiple": false
+        },
+        "sobject": {
+          "name": "sobject",
+          "type": "option",
+          "char": "s",
+          "summary": "The API name of the sObject that you want to view Record Types for.",
+          "required": true,
+          "multiple": false
+        }
+      },
+      "args": {},
+      "hasDynamicHelp": true
+    }
+  }
+}

package/package.json

@@ -0,0 +1,209 @@
+{
+  "name": "sf-raven",
+  "description": "A custom sf plugin built by @tomcarman",
+  "version": "1.0.0",
+  "dependencies": {
+    "@oclif/core": "^2.11.8",
+    "@salesforce/core": "^5.2.10",
+    "@salesforce/kit": "^3.0.8",
+    "@salesforce/sf-plugins-core": "^3.1.14",
+    "node-emoji": "^2.1.0",
+    "tslib": "^2"
+  },
+  "devDependencies": {
+    "@salesforce/cli-plugins-testkit": "^4.3.0",
+    "@salesforce/dev-config": "^4.0.1",
+    "@salesforce/dev-scripts": "^5.7.0",
+    "@salesforce/prettier-config": "^0.0.3",
+    "@salesforce/ts-sinon": "^1.4.14",
+    "@swc/core": "^1.3.19",
+    "@types/inquirer": "^9.0.3",
+    "@typescript-eslint/eslint-plugin": "^5.62.0",
+    "@typescript-eslint/parser": "^5.62.0",
+    "chai": "^4.3.6",
+    "eslint": "^8.50.0",
+    "eslint-config-prettier": "^8.5.0",
+    "eslint-config-salesforce": "^2.0.2",
+    "eslint-config-salesforce-typescript": "^1.1.2",
+    "eslint-plugin-import": "2.28.1",
+    "eslint-plugin-jsdoc": "^46.4.6",
+    "eslint-plugin-sf-plugin": "^1.16.2",
+    "husky": "^7.0.4",
+    "mocha": "^9.2.2",
+    "nyc": "^15.1.0",
+    "oclif": "^3.17.1",
+    "prettier": "^2.8.8",
+    "pretty-quick": "^3.1.3",
+    "shx": "0.3.4",
+    "sinon": "10.0.0",
+    "ts-node": "^10.9.1",
+    "typescript": "^5.1.6",
+    "wireit": "^0.10.0"
+  },
+  "engines": {
+    "node": ">=16.0.0"
+  },
+  "files": [
+    "/lib",
+    "/messages",
+    "/oclif.manifest.json"
+  ],
+  "keywords": [
+    "force",
+    "salesforce",
+    "sfdx",
+    "salesforcedx",
+    "sfdx-plugin",
+    "sf-plugin",
+    "sf"
+  ],
+  "license": "BSD-3-Clause",
+  "main": "lib/index.js",
+  "oclif": {
+    "commands": "./lib/commands",
+    "bin": "sf",
+    "topicSeparator": " ",
+    "devPlugins": [
+      "@oclif/plugin-help"
+    ],
+    "topics": {
+      "hello": {
+        "description": "Commands to say hello."
+      },
+      "object": {
+        "description": "description for object",
+        "subtopics": {
+          "display": {
+            "description": "description for object.display"
+          }
+        }
+      },
+      "event": {
+        "description": "description for event"
+      }
+    }
+  },
+  "scripts": {
+    "build": "wireit",
+    "clean": "sf-clean",
+    "clean-all": "sf-clean all",
+    "clean:lib": "shx rm -rf lib && shx rm -rf coverage && shx rm -rf .nyc_output && shx rm -f oclif.manifest.json",
+    "compile": "wireit",
+    "docs": "sf-docs",
+    "format": "wireit",
+    "lint": "wireit",
+    "postinstall": "yarn husky install",
+    "postpack": "shx rm -f oclif.manifest.json",
+    "prepack": "sf-prepack",
+    "test": "wireit",
+    "test:nuts": "nyc mocha \"**/*.nut.ts\" --slow 4500 --timeout 600000 --parallel",
+    "test:only": "wireit",
+    "version": "oclif readme"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "wireit": {
+    "build": {
+      "dependencies": [
+        "compile",
+        "lint"
+      ]
+    },
+    "compile": {
+      "command": "tsc -p . --pretty --incremental",
+      "files": [
+        "src/**/*.ts",
+        "**/tsconfig.json",
+        "messages/**"
+      ],
+      "output": [
+        "lib/**",
+        "*.tsbuildinfo"
+      ],
+      "clean": "if-file-deleted"
+    },
+    "format": {
+      "command": "prettier --write \"+(src|test|schemas)/**/*.+(ts|js|json)|command-snapshot.json\"",
+      "files": [
+        "src/**/*.ts",
+        "test/**/*.ts",
+        "schemas/**/*.json",
+        "command-snapshot.json",
+        ".prettier*"
+      ],
+      "output": []
+    },
+    "lint": {
+      "command": "eslint src test --color --cache --cache-location .eslintcache",
+      "files": [
+        "src/**/*.ts",
+        "test/**/*.ts",
+        "messages/**",
+        "**/.eslint*",
+        "**/tsconfig.json"
+      ],
+      "output": []
+    },
+    "test:compile": {
+      "command": "tsc -p \"./test\" --pretty",
+      "files": [
+        "test/**/*.ts",
+        "**/tsconfig.json"
+      ],
+      "output": []
+    },
+    "test": {
+      "dependencies": [
+        "test:compile",
+        "test:only",
+        "lint"
+      ]
+    },
+    "test:only": {
+      "command": "nyc mocha \"test/**/*.test.ts\"",
+      "env": {
+        "FORCE_COLOR": "2"
+      },
+      "files": [
+        "test/**/*.ts",
+        "src/**/*.ts",
+        "**/tsconfig.json",
+        ".mocha*",
+        "!*.nut.ts",
+        ".nycrc"
+      ],
+      "output": []
+    },
+    "test:command-reference": {
+      "command": "\"./bin/dev\" commandreference:generate --erroronwarnings",
+      "files": [
+        "src/**/*.ts",
+        "messages/**",
+        "package.json"
+      ],
+      "output": [
+        "tmp/root"
+      ]
+    },
+    "test:deprecation-policy": {
+      "command": "\"./bin/dev\" snapshot:compare",
+      "files": [
+        "src/**/*.ts"
+      ],
+      "output": [],
+      "dependencies": [
+        "compile"
+      ]
+    },
+    "test:json-schema": {
+      "command": "\"./bin/dev\" schema:compare",
+      "files": [
+        "src/**/*.ts",
+        "schemas"
+      ],
+      "output": []
+    }
+  },
+  "author": "@tomcarman"
+}