@salesforce/plugin-signups 1.0.0 → 1.1.2

package/CHANGELOG.md

@@ -2,14 +2,33 @@
 
 All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
 
-## 1.0.0 (2022-04-13)
+### [1.1.2](https://github.com/salesforcecli/plugin-signups/compare/v1.1.1...v1.1.2) (2022-05-20)
+
+### Bug Fixes
+
+- add prompt to examples ([dece28b](https://github.com/salesforcecli/plugin-signups/commit/dece28bd8db12ca48331df15b2b2b3e5e73905c3))
+- add prompt to examples ([475f621](https://github.com/salesforcecli/plugin-signups/commit/475f621f641e9947010ba1f9f355be4262f1e3fe))
+- add prompt to examples ([288e20a](https://github.com/salesforcecli/plugin-signups/commit/288e20a6247f1c1e6a0fd34e0b2ee2468c0198c9))
+
+### [1.1.1](https://github.com/salesforcecli/plugin-signups/compare/v1.1.0...v1.1.1) (2022-05-17)
+
+### Bug Fixes
+
+- remove "beta" state from Org Shape ([#35](https://github.com/salesforcecli/plugin-signups/issues/35)) ([ba96632](https://github.com/salesforcecli/plugin-signups/commit/ba966325e58d48aa3ccdfa9e2d3a7ead1a32e775))
+
+## 1.1.0 (2022-05-11)
 
 ### Features
 
+- get and list ([5e53f0e](https://github.com/salesforcecli/plugin-signups/commit/5e53f0ec74060ceea0e98cbc4cf0b898c458b37c))
 - multiple aliases, omit property if none ([2fc3781](https://github.com/salesforcecli/plugin-signups/commit/2fc3781aedbd886e21ba1221c9e0d38a80e5c4c5))
+- snapshots with nuts ([316131c](https://github.com/salesforcecli/plugin-signups/commit/316131cf617c40e7ba0b5c83ec3d5ffc653b6795))
 
 ### Bug Fixes
 
 - aliases might not exist ([aa18406](https://github.com/salesforcecli/plugin-signups/commit/aa18406fac59d8b317b5ca74cac83873d0257219))
 - exit delete command when no shapes are found ([274fb80](https://github.com/salesforcecli/plugin-signups/commit/274fb80a8288196e93b4888b53746ea7864519b8))
+- forgot to import msg dir ([123ee51](https://github.com/salesforcecli/plugin-signups/commit/123ee517ddbaded43f1bb363cd2a8ad5b7ee7ee7))
+- lastclonedby might be null ([b0009e2](https://github.com/salesforcecli/plugin-signups/commit/b0009e25aab781d50f1ff7d71c121ad2e26ef991))
 - look in all non-scratch orgs for ShapeRep ([36c804d](https://github.com/salesforcecli/plugin-signups/commit/36c804db25c49cf6bcf01ee50af60b28389a35a4))
+- null handling ([b95ba88](https://github.com/salesforcecli/plugin-signups/commit/b95ba88876603b99c6741cfe51807653a065d491))

package/README.md

@@ -81,6 +81,10 @@ sfdx plugins
 - [`sfdx force:org:shape:create [-u <string>] [--apiversion <string>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`](#sfdx-forceorgshapecreate--u-string---apiversion-string---json---loglevel-tracedebuginfowarnerrorfataltracedebuginfowarnerrorfatal)
 - [`sfdx force:org:shape:delete [-p] [-u <string>] [--apiversion <string>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`](#sfdx-forceorgshapedelete--p--u-string---apiversion-string---json---loglevel-tracedebuginfowarnerrorfataltracedebuginfowarnerrorfatal)
 - [`sfdx force:org:shape:list [--verbose] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`](#sfdx-forceorgshapelist---verbose---json---loglevel-tracedebuginfowarnerrorfataltracedebuginfowarnerrorfatal)
+- [`sfdx force:org:snapshot:create -o <string> -n <string> [-d <string>] [-v <string>] [--apiversion <string>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`](#sfdx-forceorgsnapshotcreate--o-string--n-string--d-string--v-string---apiversion-string---json---loglevel-tracedebuginfowarnerrorfataltracedebuginfowarnerrorfatal)
+- [`sfdx force:org:snapshot:delete -s <string> [-v <string>] [--apiversion <string>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`](#sfdx-forceorgsnapshotdelete--s-string--v-string---apiversion-string---json---loglevel-tracedebuginfowarnerrorfataltracedebuginfowarnerrorfatal)
+- [`sfdx force:org:snapshot:get -s <string> [-v <string>] [--apiversion <string>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`](#sfdx-forceorgsnapshotget--s-string--v-string---apiversion-string---json---loglevel-tracedebuginfowarnerrorfataltracedebuginfowarnerrorfatal)
+- [`sfdx force:org:snapshot:list [-v <string>] [--apiversion <string>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`](#sfdx-forceorgsnapshotlist--v-string---apiversion-string---json---loglevel-tracedebuginfowarnerrorfataltracedebuginfowarnerrorfatal)
 
 ## `sfdx force:org:shape:create [-u <string>] [--apiversion <string>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`
 
@@ -109,7 +113,7 @@ EXAMPLES
   $ sfdx force:org:shape:create -u me@my.org --json --loglevel debug
 ```
 
-_See code: [src/commands/force/org/shape/create.ts](https://github.com/salesforcecli/plugin-signups/blob/v1.0.0/src/commands/force/org/shape/create.ts)_
+_See code: [src/commands/force/org/shape/create.ts](https://github.com/salesforcecli/plugin-signups/blob/v1.1.1/src/commands/force/org/shape/create.ts)_
 
 ## `sfdx force:org:shape:delete [-p] [-u <string>] [--apiversion <string>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`
 
@@ -143,7 +147,7 @@ EXAMPLES
   $ sfdx force:org:shape:delete -u me@my.org -p --json > tmp/MyOrgShapeDelete.json
 ```
 
-_See code: [src/commands/force/org/shape/delete.ts](https://github.com/salesforcecli/plugin-signups/blob/v1.0.0/src/commands/force/org/shape/delete.ts)_
+_See code: [src/commands/force/org/shape/delete.ts](https://github.com/salesforcecli/plugin-signups/blob/v1.1.1/src/commands/force/org/shape/delete.ts)_
 
 ## `sfdx force:org:shape:list [--verbose] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`
 
@@ -172,6 +176,171 @@ EXAMPLES
   $ sfdx force:org:shape:list --json > tmp/MyOrgShapeList.json
 ```
 
-_See code: [src/commands/force/org/shape/list.ts](https://github.com/salesforcecli/plugin-signups/blob/v1.0.0/src/commands/force/org/shape/list.ts)_
+_See code: [src/commands/force/org/shape/list.ts](https://github.com/salesforcecli/plugin-signups/blob/v1.1.1/src/commands/force/org/shape/list.ts)_
+
+## `sfdx force:org:snapshot:create -o <string> -n <string> [-d <string>] [-v <string>] [--apiversion <string>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`
+
+create a snapshot of a scratch org
+
+```
+USAGE
+  $ sfdx force:org:snapshot:create -o <string> -n <string> [-d <string>] [-v <string>] [--apiversion <string>] [--json]
+    [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]
+
+FLAGS
+  -d, --description=<value>                                                         description of snapshot
+  -n, --snapshotname=<value>                                                        (required) unique name of snapshot
+  -o, --sourceorg=<value>                                                           (required) ID or locally
+                                                                                    authenticated username or alias of
+                                                                                    scratch org to snapshot
+  -v, --targetdevhubusername=<value>                                                username or alias for the dev hub
+                                                                                    org; overrides default dev hub org
+  --apiversion=<value>                                                              override the api version used for
+                                                                                    api requests made by this command
+  --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
+
+DESCRIPTION
+  create a snapshot of a scratch org
+
+  A snapshot is a point-in-time copy of a scratch org. The copy is stored in Salesforce and referenced by its unique
+  name in a scratch org definition file.
+
+  Use "sfdx force:org:snapshot:get" to get details, including status, about a snapshot creation request.
+
+  To create a scratch org from a snapshot, include the "snapshot" entry (instead of "edition") in the scratch org
+  definition file and set it to the name of the snapshot. Then use "sfdx force:org:create" to create the scratch org.
+
+EXAMPLES
+  Create a snapshot called "Dependencies" using the source scratch org ID:
+
+  $ sfdx force:org:snapshot:create --sourceorg 00Dxx0000000000 --snapshotname Dependencies --description 'Contains PackageA v1.1.0'
+
+  Create a snapshot called "NightlyBranch" using the source scratch org username:
+
+  $ sfdx force:org:snapshot:create -o myuser@myorg -n NightlyBranch -d 'Contains PkgA v2.1.0 and PkgB 3.3.0'
+```
+
+_See code: [src/commands/force/org/snapshot/create.ts](https://github.com/salesforcecli/plugin-signups/blob/v1.1.1/src/commands/force/org/snapshot/create.ts)_
+
+## `sfdx force:org:snapshot:delete -s <string> [-v <string>] [--apiversion <string>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`
+
+delete a scratch org snapshot
+
+```
+USAGE
+  $ sfdx force:org:snapshot:delete -s <string> [-v <string>] [--apiversion <string>] [--json] [--loglevel
+    trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]
+
+FLAGS
+  -s, --snapshot=<value>                                                            (required) name or ID of snapshot to
+                                                                                    delete
+  -v, --targetdevhubusername=<value>                                                username or alias for the dev hub
+                                                                                    org; overrides default dev hub org
+  --apiversion=<value>                                                              override the api version used for
+                                                                                    api requests made by this command
+  --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
+
+DESCRIPTION
+  delete a scratch org snapshot
+
+  Dev Hub admins can delete any snapshot, while users can delete only theirs unless a Dev Hub admin gives the user
+  Modify All permissions.
+
+EXAMPLES
+  Delete a snapshot from the default Dev Hub using the snapshot ID:
+
+  $ sfdx force:org:snapshot:delete --snapshot 0Oo...
+
+  Delete a snapshot from the specified Dev Hub using the snapshot name:
+
+  $ sfdx force:org:snapshot:delete -s BaseSnapshot -v SnapshotDevHub
+```
+
+_See code: [src/commands/force/org/snapshot/delete.ts](https://github.com/salesforcecli/plugin-signups/blob/v1.1.1/src/commands/force/org/snapshot/delete.ts)_
+
+## `sfdx force:org:snapshot:get -s <string> [-v <string>] [--apiversion <string>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`
+
+get details about a scratch org snapshot
+
+```
+USAGE
+  $ sfdx force:org:snapshot:get -s <string> [-v <string>] [--apiversion <string>] [--json] [--loglevel
+    trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]
+
+FLAGS
+  -s, --snapshot=<value>                                                            (required) name or ID of snapshot to
+                                                                                    retrieve
+  -v, --targetdevhubusername=<value>                                                username or alias for the dev hub
+                                                                                    org; overrides default dev hub org
+  --apiversion=<value>                                                              override the api version used for
+                                                                                    api requests made by this command
+  --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
+
+DESCRIPTION
+  get details about a scratch org snapshot
+
+  Snapshot creation can take a while. Use this command with the snapshot name or ID to check its creation status. Once
+  the status changes to Active, you can use the snapshot to create scratch orgs.
+
+  To create a snapshot, use the "sfdx force:org:snapshot:create" command. To retrieve a list of all snapshots, use "sfdx
+  force:org:snapshot:list".
+
+EXAMPLES
+  Get snapshot details using its ID:
+
+  $ sfdx force:org:snapshot:get --snapshot 0Oo...
+
+  Get snapshot details using its name:
+
+  $ sfdx force:org:snapshot:get -s Dependencies
+```
+
+_See code: [src/commands/force/org/snapshot/get.ts](https://github.com/salesforcecli/plugin-signups/blob/v1.1.1/src/commands/force/org/snapshot/get.ts)_
+
+## `sfdx force:org:snapshot:list [-v <string>] [--apiversion <string>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`
+
+list scratch org snapshots
+
+```
+USAGE
+  $ sfdx force:org:snapshot:list [-v <string>] [--apiversion <string>] [--json] [--loglevel
+    trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]
+
+FLAGS
+  -v, --targetdevhubusername=<value>                                                username or alias for the dev hub
+                                                                                    org; overrides default dev hub org
+  --apiversion=<value>                                                              override the api version used for
+                                                                                    api requests made by this command
+  --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
+
+DESCRIPTION
+  list scratch org snapshots
+
+  You can view all the snapshots in a Dev Hub that you have access to. If you’re an admin, you can see all snapshots
+  associated with the Dev Hub org. If you’re a user, you can see only your snapshots unless a Dev Hub admin gives you
+  View All permissions.
+
+  To create a snapshot, use the "sfdx force:org:snapshot:create" command. To get details about a snapshot request, use
+  "sfdx force:org:snapshot:get".
+
+EXAMPLES
+  List snapshots in the default Dev Hub:
+
+  $ sfdx force:org:snapshot:list
+
+  List snapshots in the Dev Hub with the specified username:
+
+  $ sfdx force:org:snapshot:list -v OtherDevHub@example.com
+```
+
+_See code: [src/commands/force/org/snapshot/list.ts](https://github.com/salesforcecli/plugin-signups/blob/v1.1.1/src/commands/force/org/snapshot/list.ts)_
 
 <!-- commandsstop -->

package/lib/commands/force/org/snapshot/create.d.ts

@@ -0,0 +1,9 @@
+import { SfdxCommand, FlagsConfig } from '@salesforce/command';
+import { OrgSnapshot } from '../../../../shared/snapshot';
+export declare class SnapshotGet extends SfdxCommand {
+    static readonly description: string;
+    static readonly examples: string[];
+    static readonly requiresDevhubUsername = true;
+    static readonly flagsConfig: FlagsConfig;
+    run(): Promise<OrgSnapshot>;
+}

package/lib/commands/force/org/snapshot/create.js

@@ -0,0 +1,65 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SnapshotGet = 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 os_1 = require("os");
+const command_1 = require("@salesforce/command");
+const core_1 = require("@salesforce/core");
+const snapshot_1 = require("../../../../shared/snapshot");
+core_1.Messages.importMessagesDirectory(__dirname);
+const messages = core_1.Messages.loadMessages('@salesforce/plugin-signups', 'snapshot.create');
+class SnapshotGet extends command_1.SfdxCommand {
+    async run() {
+        var _a, _b;
+        // sourceorg might be a username or alias, but we need an orgId
+        let sourceOrgId = this.flags.sourceorg;
+        if (!sourceOrgId.startsWith('00D')) {
+            const globalInfo = await core_1.GlobalInfo.create();
+            const username = (_a = globalInfo.aliases.getValue(sourceOrgId)) !== null && _a !== void 0 ? _a : sourceOrgId;
+            sourceOrgId = (_b = globalInfo.orgs.get(username)) === null || _b === void 0 ? void 0 : _b.orgId;
+        }
+        const createResponse = await this.hubOrg
+            .getConnection()
+            .sobject('OrgSnapshot')
+            .create({
+            SourceOrg: sourceOrgId,
+            Description: this.flags.description,
+            SnapshotName: this.flags.snapshotname,
+            Content: 'metadatadata',
+        });
+        const result = await (0, snapshot_1.queryByNameOrId)(this.hubOrg.getConnection(), createResponse.id);
+        if (!this.flags.json) {
+            (0, snapshot_1.printSingleRecordTable)(result);
+        }
+        return result;
+    }
+}
+exports.SnapshotGet = SnapshotGet;
+SnapshotGet.description = messages.getMessage('description');
+SnapshotGet.examples = messages.getMessage('examples').split(os_1.EOL);
+SnapshotGet.requiresDevhubUsername = true;
+SnapshotGet.flagsConfig = {
+    sourceorg: command_1.flags.string({
+        char: 'o',
+        description: messages.getMessage('flags.sourceorg'),
+        longDescription: messages.getMessage('flagsLong.sourceorg'),
+        required: true,
+    }),
+    snapshotname: command_1.flags.string({
+        char: 'n',
+        description: messages.getMessage('flags.snapshotname'),
+        longDescription: messages.getMessage('flagsLong.snapshotname'),
+        required: true,
+    }),
+    description: command_1.flags.string({
+        char: 'd',
+        description: messages.getMessage('flags.description'),
+        longDescription: messages.getMessage('flagsLong.description'),
+    }),
+};
+//# sourceMappingURL=create.js.map

package/lib/commands/force/org/snapshot/create.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.js","sourceRoot":"","sources":["../../../../../src/commands/force/org/snapshot/create.ts"],"names":[],"mappings":";;;AAAA;;;;;GAKG;AACH,2BAAyB;AACzB,iDAAsE;AACtE,2CAAwD;AACxD,0DAAmG;AAEnG,eAAQ,CAAC,uBAAuB,CAAC,SAAS,CAAC,CAAC;AAC5C,MAAM,QAAQ,GAAG,eAAQ,CAAC,YAAY,CAAC,4BAA4B,EAAE,iBAAiB,CAAC,CAAC;AAExF,MAAa,WAAY,SAAQ,qBAAW;IAyBnC,KAAK,CAAC,GAAG;;QACd,+DAA+D;QAC/D,IAAI,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,SAAmB,CAAC;QAEjD,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE;YAClC,MAAM,UAAU,GAAG,MAAM,iBAAU,CAAC,MAAM,EAAE,CAAC;YAC7C,MAAM,QAAQ,GAAG,MAAA,UAAU,CAAC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,mCAAI,WAAW,CAAC;YACzE,WAAW,GAAG,MAAA,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,0CAAE,KAAK,CAAC;SACpD;QAED,MAAM,cAAc,GAAG,MAAM,IAAI,CAAC,MAAM;aACrC,aAAa,EAAE;aACf,OAAO,CAAC,aAAa,CAAC;aACtB,MAAM,CAAC;YACN,SAAS,EAAE,WAAW;YACtB,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,WAAqB;YAC7C,YAAY,EAAE,IAAI,CAAC,KAAK,CAAC,YAAsB;YAC/C,OAAO,EAAE,cAAc;SACxB,CAAC,CAAC;QACL,MAAM,MAAM,GAAG,MAAM,IAAA,0BAAe,EAAC,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,EAAE,cAAc,CAAC,EAAE,CAAC,CAAC;QACrF,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE;YACpB,IAAA,iCAAsB,EAAC,MAAM,CAAC,CAAC;SAChC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;;AAjDH,kCAkDC;AAjDwB,uBAAW,GAAG,QAAQ,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;AACjD,oBAAQ,GAAG,QAAQ,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,KAAK,CAAC,QAAG,CAAC,CAAC;AACtD,kCAAsB,GAAG,IAAI,CAAC;AAE9B,uBAAW,GAAgB;IAChD,SAAS,EAAE,eAAK,CAAC,MAAM,CAAC;QACtB,IAAI,EAAE,GAAG;QACT,WAAW,EAAE,QAAQ,CAAC,UAAU,CAAC,iBAAiB,CAAC;QACnD,eAAe,EAAE,QAAQ,CAAC,UAAU,CAAC,qBAAqB,CAAC;QAC3D,QAAQ,EAAE,IAAI;KACf,CAAC;IACF,YAAY,EAAE,eAAK,CAAC,MAAM,CAAC;QACzB,IAAI,EAAE,GAAG;QACT,WAAW,EAAE,QAAQ,CAAC,UAAU,CAAC,oBAAoB,CAAC;QACtD,eAAe,EAAE,QAAQ,CAAC,UAAU,CAAC,wBAAwB,CAAC;QAC9D,QAAQ,EAAE,IAAI;KACf,CAAC;IACF,WAAW,EAAE,eAAK,CAAC,MAAM,CAAC;QACxB,IAAI,EAAE,GAAG;QACT,WAAW,EAAE,QAAQ,CAAC,UAAU,CAAC,mBAAmB,CAAC;QACrD,eAAe,EAAE,QAAQ,CAAC,UAAU,CAAC,uBAAuB,CAAC;KAC9D,CAAC;CACH,CAAC"}

package/lib/commands/force/org/snapshot/delete.d.ts

@@ -0,0 +1,9 @@
+import { SfdxCommand, FlagsConfig } from '@salesforce/command';
+import { SaveResult } from 'jsforce';
+export declare class SnapshotGet extends SfdxCommand {
+    static readonly description: string;
+    static readonly examples: string[];
+    static readonly requiresDevhubUsername = true;
+    static readonly flagsConfig: FlagsConfig;
+    run(): Promise<SaveResult>;
+}

package/lib/commands/force/org/snapshot/delete.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SnapshotGet = 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 os_1 = require("os");
+const command_1 = require("@salesforce/command");
+const core_1 = require("@salesforce/core");
+const snapshot_1 = require("../../../../shared/snapshot");
+core_1.Messages.importMessagesDirectory(__dirname);
+const messages = core_1.Messages.loadMessages('@salesforce/plugin-signups', 'snapshot.delete');
+// jsforce can return SaveError[] or never[]
+const isSaveError = (error) => error.message !== undefined;
+class SnapshotGet extends command_1.SfdxCommand {
+    async run() {
+        // resolve the query to an ID.  This also verifies the snapshot exists in the org
+        const result = await (0, snapshot_1.queryByNameOrId)(this.hubOrg.getConnection(), this.flags.snapshot);
+        const deleteResult = await this.hubOrg.getConnection().sobject('OrgSnapshot').delete(result.Id);
+        if (deleteResult.success) {
+            this.ux.log(messages.getMessage('success', [this.flags.snapshot]));
+            return deleteResult;
+        }
+        else if (deleteResult.errors) {
+            throw new Error(deleteResult.errors
+                .filter(isSaveError)
+                .map((error) => error.message)
+                .join(os_1.EOL));
+        }
+    }
+}
+exports.SnapshotGet = SnapshotGet;
+SnapshotGet.description = messages.getMessage('description');
+SnapshotGet.examples = messages.getMessage('examples').split(os_1.EOL);
+SnapshotGet.requiresDevhubUsername = true;
+SnapshotGet.flagsConfig = {
+    snapshot: command_1.flags.string({
+        char: 's',
+        description: messages.getMessage('flags.snapshot'),
+        longDescription: messages.getMessage('flagsLong.snapshot'),
+        required: true,
+    }),
+};
+//# sourceMappingURL=delete.js.map

package/lib/commands/force/org/snapshot/delete.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete.js","sourceRoot":"","sources":["../../../../../src/commands/force/org/snapshot/delete.ts"],"names":[],"mappings":";;;AAAA;;;;;GAKG;AACH,2BAAyB;AACzB,iDAAsE;AACtE,2CAA4C;AAE5C,0DAA8D;AAE9D,eAAQ,CAAC,uBAAuB,CAAC,SAAS,CAAC,CAAC;AAC5C,MAAM,QAAQ,GAAG,eAAQ,CAAC,YAAY,CAAC,4BAA4B,EAAE,iBAAiB,CAAC,CAAC;AAExF,4CAA4C;AAC5C,MAAM,WAAW,GAAG,CAAC,KAA0B,EAAsB,EAAE,CAAE,KAAmB,CAAC,OAAO,KAAK,SAAS,CAAC;AAEnH,MAAa,WAAY,SAAQ,qBAAW;IAcnC,KAAK,CAAC,GAAG;QACd,iFAAiF;QACjF,MAAM,MAAM,GAAG,MAAM,IAAA,0BAAe,EAAC,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QACvF,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAChG,IAAI,YAAY,CAAC,OAAO,EAAE;YACxB,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,UAAU,CAAC,SAAS,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,QAAkB,CAAC,CAAC,CAAC,CAAC;YAC7E,OAAO,YAAY,CAAC;SACrB;aAAM,IAAI,YAAY,CAAC,MAAM,EAAE;YAC9B,MAAM,IAAI,KAAK,CACb,YAAY,CAAC,MAAM;iBAChB,MAAM,CAAC,WAAW,CAAC;iBACnB,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC;iBAC7B,IAAI,CAAC,QAAG,CAAC,CACb,CAAC;SACH;IACH,CAAC;;AA7BH,kCA8BC;AA7BwB,uBAAW,GAAG,QAAQ,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;AACjD,oBAAQ,GAAG,QAAQ,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,KAAK,CAAC,QAAG,CAAC,CAAC;AACtD,kCAAsB,GAAG,IAAI,CAAC;AAE9B,uBAAW,GAAgB;IAChD,QAAQ,EAAE,eAAK,CAAC,MAAM,CAAC;QACrB,IAAI,EAAE,GAAG;QACT,WAAW,EAAE,QAAQ,CAAC,UAAU,CAAC,gBAAgB,CAAC;QAClD,eAAe,EAAE,QAAQ,CAAC,UAAU,CAAC,oBAAoB,CAAC;QAC1D,QAAQ,EAAE,IAAI;KACf,CAAC;CACH,CAAC"}

package/lib/commands/force/org/snapshot/get.d.ts

@@ -0,0 +1,9 @@
+import { SfdxCommand, FlagsConfig } from '@salesforce/command';
+import { OrgSnapshot } from '../../../../shared/snapshot';
+export declare class SnapshotGet extends SfdxCommand {
+    static readonly description: string;
+    static readonly examples: string[];
+    static readonly requiresDevhubUsername = true;
+    static readonly flagsConfig: FlagsConfig;
+    run(): Promise<OrgSnapshot>;
+}

package/lib/commands/force/org/snapshot/get.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SnapshotGet = 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 os_1 = require("os");
+const command_1 = require("@salesforce/command");
+const core_1 = require("@salesforce/core");
+const snapshot_1 = require("../../../../shared/snapshot");
+core_1.Messages.importMessagesDirectory(__dirname);
+const messages = core_1.Messages.loadMessages('@salesforce/plugin-signups', 'snapshot.get');
+class SnapshotGet extends command_1.SfdxCommand {
+    async run() {
+        const result = await (0, snapshot_1.queryByNameOrId)(this.hubOrg.getConnection(), this.flags.snapshot);
+        if (!this.flags.json) {
+            (0, snapshot_1.printSingleRecordTable)(result);
+        }
+        return result;
+    }
+}
+exports.SnapshotGet = SnapshotGet;
+SnapshotGet.description = messages.getMessage('description');
+SnapshotGet.examples = messages.getMessage('examples').split(os_1.EOL);
+SnapshotGet.requiresDevhubUsername = true;
+SnapshotGet.flagsConfig = {
+    snapshot: command_1.flags.string({
+        char: 's',
+        description: messages.getMessage('flags.snapshot'),
+        longDescription: messages.getMessage('flagsLong.snapshot'),
+        required: true,
+    }),
+};
+//# sourceMappingURL=get.js.map

package/lib/commands/force/org/snapshot/get.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get.js","sourceRoot":"","sources":["../../../../../src/commands/force/org/snapshot/get.ts"],"names":[],"mappings":";;;AAAA;;;;;GAKG;AACH,2BAAyB;AACzB,iDAAsE;AACtE,2CAA4C;AAC5C,0DAAmG;AAEnG,eAAQ,CAAC,uBAAuB,CAAC,SAAS,CAAC,CAAC;AAC5C,MAAM,QAAQ,GAAG,eAAQ,CAAC,YAAY,CAAC,4BAA4B,EAAE,cAAc,CAAC,CAAC;AAErF,MAAa,WAAY,SAAQ,qBAAW;IAcnC,KAAK,CAAC,GAAG;QACd,MAAM,MAAM,GAAG,MAAM,IAAA,0BAAe,EAAC,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QACvF,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE;YACpB,IAAA,iCAAsB,EAAC,MAAM,CAAC,CAAC;SAChC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;;AApBH,kCAqBC;AApBwB,uBAAW,GAAG,QAAQ,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;AACjD,oBAAQ,GAAG,QAAQ,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,KAAK,CAAC,QAAG,CAAC,CAAC;AACtD,kCAAsB,GAAG,IAAI,CAAC;AAE9B,uBAAW,GAAgB;IAChD,QAAQ,EAAE,eAAK,CAAC,MAAM,CAAC;QACrB,IAAI,EAAE,GAAG;QACT,WAAW,EAAE,QAAQ,CAAC,UAAU,CAAC,gBAAgB,CAAC;QAClD,eAAe,EAAE,QAAQ,CAAC,UAAU,CAAC,oBAAoB,CAAC;QAC1D,QAAQ,EAAE,IAAI;KACf,CAAC;CACH,CAAC"}

package/lib/commands/force/org/snapshot/list.d.ts

@@ -0,0 +1,8 @@
+import { SfdxCommand } from '@salesforce/command';
+import { OrgSnapshot } from '../../../../shared/snapshot';
+export declare class SnapshotGet extends SfdxCommand {
+    static readonly description: string;
+    static readonly examples: string[];
+    static readonly requiresDevhubUsername = true;
+    run(): Promise<OrgSnapshot[]>;
+}

package/lib/commands/force/org/snapshot/list.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SnapshotGet = 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 os_1 = require("os");
+const command_1 = require("@salesforce/command");
+const core_1 = require("@salesforce/core");
+const snapshot_1 = require("../../../../shared/snapshot");
+core_1.Messages.importMessagesDirectory(__dirname);
+const messages = core_1.Messages.loadMessages('@salesforce/plugin-signups', 'snapshot.list');
+class SnapshotGet extends command_1.SfdxCommand {
+    async run() {
+        const results = await (0, snapshot_1.queryAll)(this.hubOrg.getConnection());
+        if (!this.flags.json) {
+            (0, snapshot_1.printRecordTable)(results);
+        }
+        return results;
+    }
+}
+exports.SnapshotGet = SnapshotGet;
+SnapshotGet.description = messages.getMessage('description');
+SnapshotGet.examples = messages.getMessage('examples').split(os_1.EOL);
+SnapshotGet.requiresDevhubUsername = true;
+//# sourceMappingURL=list.js.map

package/lib/commands/force/org/snapshot/list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../../../../src/commands/force/org/snapshot/list.ts"],"names":[],"mappings":";;;AAAA;;;;;GAKG;AACH,2BAAyB;AACzB,iDAAkD;AAClD,2CAA4C;AAC5C,0DAAsF;AAEtF,eAAQ,CAAC,uBAAuB,CAAC,SAAS,CAAC,CAAC;AAC5C,MAAM,QAAQ,GAAG,eAAQ,CAAC,YAAY,CAAC,4BAA4B,EAAE,eAAe,CAAC,CAAC;AAEtF,MAAa,WAAY,SAAQ,qBAAW;IAKnC,KAAK,CAAC,GAAG;QACd,MAAM,OAAO,GAAG,MAAM,IAAA,mBAAQ,EAAC,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC,CAAC;QAC5D,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE;YACpB,IAAA,2BAAgB,EAAC,OAAO,CAAC,CAAC;SAC3B;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;;AAXH,kCAYC;AAXwB,uBAAW,GAAG,QAAQ,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;AACjD,oBAAQ,GAAG,QAAQ,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,KAAK,CAAC,QAAG,CAAC,CAAC;AACtD,kCAAsB,GAAG,IAAI,CAAC"}

package/lib/shared/snapshot.d.ts

@@ -0,0 +1,22 @@
+import { Connection } from '@salesforce/core';
+export interface OrgSnapshotRequest {
+    SourceOrg: string;
+    SnapshotName: string;
+    Description: string;
+    Content?: string;
+}
+export interface OrgSnapshot extends OrgSnapshotRequest {
+    Id: string;
+    Status: string;
+    LastClonedDate?: string;
+    LastClonedById?: string;
+    CreatedDate: string;
+    LastModifiedDate: string;
+    ExpirationDate?: string;
+    Error?: string;
+}
+export declare const ORG_SNAPSHOT_FIELDS: string[];
+export declare const queryAll: (conn: Connection) => Promise<OrgSnapshot[]>;
+export declare const queryByNameOrId: (conn: Connection, nameOrId: string) => Promise<OrgSnapshot>;
+export declare const printSingleRecordTable: (snapshotRecord: OrgSnapshot) => void;
+export declare const printRecordTable: (snapshotRecords: OrgSnapshot[]) => void;

package/lib/shared/snapshot.js

@@ -0,0 +1,119 @@
+"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.printRecordTable = exports.printSingleRecordTable = exports.queryByNameOrId = exports.queryAll = exports.ORG_SNAPSHOT_FIELDS = void 0;
+const core_1 = require("@oclif/core");
+const core_2 = require("@salesforce/core");
+const change_case_1 = require("change-case");
+core_2.Messages.importMessagesDirectory(__dirname);
+const messages = core_2.Messages.load('@salesforce/plugin-signups', 'snapshot', ['snapshotNotEnabled', 'noSnapshots']);
+exports.ORG_SNAPSHOT_FIELDS = [
+    'Id',
+    'SnapshotName',
+    'Description',
+    'Status',
+    'SourceOrg',
+    'CreatedDate',
+    'LastModifiedDate',
+    'ExpirationDate',
+    'LastClonedDate',
+    'LastClonedById',
+    'Error',
+];
+const dateTimeFormatter = (dateString) => dateString
+    ? new Date(dateString).toLocaleString(undefined, {
+        month: '2-digit',
+        year: 'numeric',
+        day: '2-digit',
+        hour: '2-digit',
+        minute: '2-digit',
+    })
+    : '';
+const rowDateTimeFormatter = (row, field) => dateTimeFormatter(row[field]);
+const ORG_SNAPSHOT_COLUMNS = {
+    Id: {},
+    SnapshotName: { header: 'Snapshot Name' },
+    Status: {},
+    SourceOrg: { header: 'Source Org Id' },
+    CreatedDate: {
+        header: 'Created Date',
+        get: (row) => rowDateTimeFormatter(row, 'CreatedDate'),
+    },
+    LastModifiedDate: {
+        header: 'Last Modified Date',
+        get: (row) => rowDateTimeFormatter(row, 'LastModifiedDate'),
+    },
+    ExpirationDate: {
+        header: 'Expiration Date',
+        get: (row) => (row.ExpirationDate ? new Date(row.ExpirationDate).toLocaleDateString() : ''),
+    },
+    LastClonedDate: {
+        header: 'Last Cloned Date',
+        get: (row) => rowDateTimeFormatter(row, 'LastClonedDate'),
+    },
+    LastClonedById: { header: 'Last Cloned By Id', get: (row) => { var _a; return (_a = row.LastClonedById) !== null && _a !== void 0 ? _a : ''; } },
+};
+const invalidTypeErrorHandler = (e) => {
+    if (e instanceof Error && e.name === 'INVALID_TYPE') {
+        e.message = messages.getMessage('snapshotNotEnabled');
+    }
+    throw e;
+};
+const queryAll = async (conn) => {
+    const query = `SELECT ${exports.ORG_SNAPSHOT_FIELDS.join(',')} FROM OrgSnapshot Order by CreatedDate`;
+    try {
+        const result = (await conn.query(query)).records;
+        return result;
+    }
+    catch (e) {
+        invalidTypeErrorHandler(e);
+    }
+};
+exports.queryAll = queryAll;
+const queryByNameOrId = async (conn, nameOrId) => {
+    const query = `SELECT ${exports.ORG_SNAPSHOT_FIELDS.join(',')} FROM OrgSnapshot WHERE ${nameOrId.startsWith('0Oo') ? 'Id' : 'SnapshotName'} = '${nameOrId}'`;
+    try {
+        const result = await conn.singleRecordQuery(query);
+        return result;
+    }
+    catch (e) {
+        if (e instanceof core_2.SfError && e.name === 'SingleRecordQuery_NoRecords') {
+            e.message = messages.getMessage('noSnapshots', [nameOrId]);
+        }
+        invalidTypeErrorHandler(e);
+    }
+};
+exports.queryByNameOrId = queryByNameOrId;
+const printSingleRecordTable = (snapshotRecord) => {
+    core_1.CliUx.ux.table(Object.entries(snapshotRecord)
+        .filter(([key]) => key !== 'attributes')
+        // remove empty error field
+        .filter(([key, value]) => key !== 'Error' || value)
+        .map(([key, value]) => ({
+        Name: (0, change_case_1.capitalCase)(key),
+        // format the datetime values
+        Value: ['LastModifiedDate', 'LastClonedDate', 'CreatedDate'].includes(key)
+            ? dateTimeFormatter(value)
+            : value,
+    }))
+        // null/undefined becomes empty string
+        .map((row) => (row.Value ? row : { ...row, Value: '' })), { Name: {}, Value: {} });
+};
+exports.printSingleRecordTable = printSingleRecordTable;
+const printRecordTable = (snapshotRecords) => {
+    if (snapshotRecords.length === 0) {
+        core_1.CliUx.ux.log('No snapshots found');
+        return;
+    }
+    core_1.CliUx.ux.table(
+    // snapshotRecords,
+    // without this, you encounter typing errors from CliUx.ux.table
+    snapshotRecords.map((s) => ({ ...s })), ORG_SNAPSHOT_COLUMNS, { title: `Org Snapshots [${snapshotRecords.length}]`, 'no-truncate': true });
+};
+exports.printRecordTable = printRecordTable;
+//# sourceMappingURL=snapshot.js.map

package/lib/shared/snapshot.js.map

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

package/messages/shape.create.json

@@ -7,8 +7,8 @@
   "create_shape_command_description": "Create a scratch org configuration (shape) based on the specified source org",
   "create_shape_command_description_long": "Create a scratch org configuration (shape) based on the specified source org.",
   "create_shape_command_help": [
-    "sfdx force:org:shape:create -u me@my.org",
-    "sfdx force:org:shape:create -u me@my.org --json --loglevel debug"
+    "$ sfdx force:org:shape:create -u me@my.org",
+    "$ sfdx force:org:shape:create -u me@my.org --json --loglevel debug"
   ],
   "create_shape_command_username": "a username or alias for the target org",
   "create_shape_command_username_long": "Username or alias of the previously authorized org from which you want to create an org shape.",

package/messages/shape.delete.json

@@ -14,12 +14,12 @@
   "humanSuccess": "Successfully deleted org shape for %s.",
   "noShapesHumanSuccess": "Can't delete org shape. No org shape found for org %s.",
   "help": [
-    "sfdx force:org:shape:delete -u me@my.org",
+    "$ sfdx force:org:shape:delete -u me@my.org",
 
-    "sfdx force:org:shape:delete -u MyOrgAlias -p",
+    "$ sfdx force:org:shape:delete -u MyOrgAlias -p",
 
-    "sfdx force:org:shape:delete -u me@my.org --json",
+    "$ sfdx force:org:shape:delete -u me@my.org --json",
 
-    "sfdx force:org:shape:delete -u me@my.org -p --json > tmp/MyOrgShapeDelete.json"
+    "$ sfdx force:org:shape:delete -u me@my.org -p --json > tmp/MyOrgShapeDelete.json"
   ]
 }

package/messages/shape.list.json

@@ -6,8 +6,8 @@
   "noOrgShapes": "No org shapes found.",
   "noAuthFound": "No authenticated orgs found.",
   "help": [
-    "sfdx force:org:shape:list",
-    "sfdx force:org:shape:list --json",
-    "sfdx force:org:shape:list --json > tmp/MyOrgShapeList.json"
+    "$ sfdx force:org:shape:list",
+    "$ sfdx force:org:shape:list --json",
+    "$ sfdx force:org:shape:list --json > tmp/MyOrgShapeList.json"
   ]
 }

package/messages/snapshot.create.json

@@ -0,0 +1,19 @@
+{
+  "description": "create a snapshot of a scratch org\nA snapshot is a point-in-time copy of a scratch org. The copy is stored in Salesforce and referenced by its unique name in a scratch org definition file.\n\nUse \"sfdx force:org:snapshot:get\" to get details, including status, about a snapshot creation request.\n\nTo create a scratch org from a snapshot, include the \"snapshot\" entry (instead of \"edition\") in the scratch org definition file and set it to the name of the snapshot. Then use \"sfdx force:org:create\" to create the scratch org.",
+  "examples": [
+    "Create a snapshot called \"Dependencies\" using the source scratch org ID:",
+    "$ sfdx force:org:snapshot:create --sourceorg 00Dxx0000000000 --snapshotname Dependencies --description 'Contains PackageA v1.1.0'",
+    "Create a snapshot called \"NightlyBranch\" using the source scratch org username:",
+    "$ sfdx force:org:snapshot:create -o myuser@myorg -n NightlyBranch -d 'Contains PkgA v2.1.0 and PkgB 3.3.0'"
+  ],
+  "flags": {
+    "snapshotname": "unique name of snapshot",
+    "description": "description of snapshot",
+    "sourceorg": "ID or locally authenticated username or alias of scratch org to snapshot" 
+  },
+  "flagsLong": {
+    "snapshotname": "The unique name of the snapshot. Use this name to create scratch orgs from the snapshot.",
+    "description": "A description of the snapshot. Use this description to document the contents of the snapshot.\nWe suggest that you include a reference point, such as a version control system tag or commit ID.'",
+    "sourceorg": "The org ID, or a locally authenticated username or alias, of the scratch org to snapshot."
+  }
+}

package/messages/snapshot.delete.json

@@ -0,0 +1,16 @@
+{
+  "description": "delete a scratch org snapshot\nDev Hub admins can delete any snapshot, while users can delete only theirs unless a Dev Hub admin gives the user Modify All permissions.",
+  "examples": [
+    "Delete a snapshot from the default Dev Hub using the snapshot ID:",
+    "$ sfdx force:org:snapshot:delete --snapshot 0Oo...", 
+    "Delete a snapshot from the specified Dev Hub using the snapshot name:",
+    "$ sfdx force:org:snapshot:delete -s BaseSnapshot -v SnapshotDevHub"
+  ],
+  "flags": {
+    "snapshot": "name or ID of snapshot to delete"
+  },
+  "flagsLong": {
+    "snapshot": "The name or ID (starts with 0Oo) of the snapshot to delete."
+  },
+  "success": "Successfully deleted snapshot %s."
+}

package/messages/snapshot.get.json

@@ -0,0 +1,15 @@
+{
+  "description": "get details about a scratch org snapshot\nSnapshot creation can take a while. Use this command with the snapshot name or ID to check its creation status. Once the status changes to Active, you can use the snapshot to create scratch orgs. \n\nTo create a snapshot, use the \"sfdx force:org:snapshot:create\" command. To retrieve a list of all snapshots, use \"sfdx force:org:snapshot:list\".",
+  "examples": [
+    "Get snapshot details using its ID:",
+    "$ sfdx force:org:snapshot:get --snapshot 0Oo...",
+    "Get snapshot details using its name:",
+    "$ sfdx force:org:snapshot:get -s Dependencies"
+  ],
+  "flags": {
+    "snapshot": "name or ID of snapshot to retrieve"
+  },
+  "flagsLong": {
+    "snapshot": "The name or ID (starts with 0Oo) of the snapshot to retrieve."
+  }
+}

package/messages/snapshot.json

@@ -0,0 +1,4 @@
+{
+  "noSnapshots": "No snapshot found with the given name or id: %s",
+  "snapshotNotEnabled": "Org snapshots aren’t enabled for your Dev Hub."
+}

package/messages/snapshot.list.json

@@ -0,0 +1,9 @@
+{
+  "description": "list scratch org snapshots\nYou can view all the snapshots in a Dev Hub that you have access to. If you’re an admin, you can see all snapshots associated with the Dev Hub org. If you’re a user, you can see only your snapshots unless a Dev Hub admin gives you View All permissions.\n\nTo create a snapshot, use the \"sfdx force:org:snapshot:create\" command. To get details about a snapshot request, use \"sfdx force:org:snapshot:get\".",
+  "examples": [
+    "List snapshots in the default Dev Hub:",
+    "$ sfdx force:org:snapshot:list", 
+    "List snapshots in the Dev Hub with the specified username:",
+    "$ sfdx force:org:snapshot:list -v OtherDevHub@example.com"
+  ] 
+}

package/oclif.manifest.json

@@ -1 +1 @@
-{"version":"1.0.0","commands":{"force:org:shape:create":{"id":"force:org:shape:create","description":"Create a scratch org configuration (shape) based on the specified source org","strict":true,"usage":"<%= command.id %> [-u <string>] [--apiversion <string>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]","pluginName":"@salesforce/plugin-signups","pluginAlias":"@salesforce/plugin-signups","pluginType":"core","aliases":[],"examples":["sfdx force:org:shape:create -u me@my.org","sfdx force:org:shape:create -u me@my.org --json --loglevel debug"],"flags":{"json":{"name":"json","type":"boolean","description":"format output as json","allowNo":false},"loglevel":{"name":"loglevel","type":"option","description":"logging level for this command invocation","required":false,"helpValue":"(trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL)","multiple":false,"options":["trace","debug","info","warn","error","fatal","TRACE","DEBUG","INFO","WARN","ERROR","FATAL"],"default":"warn"},"targetusername":{"name":"targetusername","type":"option","char":"u","description":"username or alias for the target org; overrides default target org","multiple":false},"apiversion":{"name":"apiversion","type":"option","description":"override the api version used for api requests made by this command","multiple":false}},"args":[],"requiresUsername":true},"force:org:shape:delete":{"id":"force:org:shape:delete","description":"Delete all org shapes for a target org","strict":true,"usage":"<%= command.id %> [-p] [-u <string>] [--apiversion <string>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]","pluginName":"@salesforce/plugin-signups","pluginAlias":"@salesforce/plugin-signups","pluginType":"core","aliases":[],"examples":["sfdx force:org:shape:delete -u me@my.org","sfdx force:org:shape:delete -u MyOrgAlias -p","sfdx force:org:shape:delete -u me@my.org --json","sfdx force:org:shape:delete -u me@my.org -p --json > tmp/MyOrgShapeDelete.json"],"flags":{"json":{"name":"json","type":"boolean","description":"format output as json","allowNo":false},"loglevel":{"name":"loglevel","type":"option","description":"logging level for this command invocation","required":false,"helpValue":"(trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL)","multiple":false,"options":["trace","debug","info","warn","error","fatal","TRACE","DEBUG","INFO","WARN","ERROR","FATAL"],"default":"warn"},"targetusername":{"name":"targetusername","type":"option","char":"u","description":"username or alias for the target org; overrides default target org","multiple":false},"apiversion":{"name":"apiversion","type":"option","description":"override the api version used for api requests made by this command","multiple":false},"noprompt":{"name":"noprompt","type":"boolean","char":"p","description":"do not prompt for confirmation","allowNo":false}},"args":[],"requiresUsername":true,"flagsConfig":{"noprompt":{"kind":"boolean","char":"p","description":"do not prompt for confirmation","allowNo":false,"type":"boolean"}}},"force:org:shape:list":{"id":"force:org:shape:list","description":"List all org shapes you’ve created","strict":true,"usage":"<%= command.id %> [--verbose] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]","pluginName":"@salesforce/plugin-signups","pluginAlias":"@salesforce/plugin-signups","pluginType":"core","aliases":[],"examples":["sfdx force:org:shape:list","sfdx force:org:shape:list --json","sfdx force:org:shape:list --json > tmp/MyOrgShapeList.json"],"flags":{"json":{"name":"json","type":"boolean","description":"format output as json","allowNo":false},"loglevel":{"name":"loglevel","type":"option","description":"logging level for this command invocation","required":false,"helpValue":"(trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL)","multiple":false,"options":["trace","debug","info","warn","error","fatal","TRACE","DEBUG","INFO","WARN","ERROR","FATAL"],"default":"warn"},"verbose":{"name":"verbose","type":"boolean","description":"list more information about each org shape","allowNo":false}},"args":[],"flagsConfig":{"verbose":{"description":"list more information about each org shape","type":"boolean","kind":"boolean","longDescription":"Emit additional command output to stdout.","allowNo":false}}}}}
+{"version":"1.1.2","commands":{"force:org:shape:create":{"id":"force:org:shape:create","description":"Create a scratch org configuration (shape) based on the specified source org","strict":true,"usage":"<%= command.id %> [-u <string>] [--apiversion <string>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]","pluginName":"@salesforce/plugin-signups","pluginAlias":"@salesforce/plugin-signups","pluginType":"core","aliases":[],"examples":["$ sfdx force:org:shape:create -u me@my.org","$ sfdx force:org:shape:create -u me@my.org --json --loglevel debug"],"flags":{"json":{"name":"json","type":"boolean","description":"format output as json","allowNo":false},"loglevel":{"name":"loglevel","type":"option","description":"logging level for this command invocation","required":false,"helpValue":"(trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL)","multiple":false,"options":["trace","debug","info","warn","error","fatal","TRACE","DEBUG","INFO","WARN","ERROR","FATAL"],"default":"warn"},"targetusername":{"name":"targetusername","type":"option","char":"u","description":"username or alias for the target org; overrides default target org","multiple":false},"apiversion":{"name":"apiversion","type":"option","description":"override the api version used for api requests made by this command","multiple":false}},"args":[],"requiresUsername":true},"force:org:shape:delete":{"id":"force:org:shape:delete","description":"Delete all org shapes for a target org","strict":true,"usage":"<%= command.id %> [-p] [-u <string>] [--apiversion <string>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]","pluginName":"@salesforce/plugin-signups","pluginAlias":"@salesforce/plugin-signups","pluginType":"core","aliases":[],"examples":["$ sfdx force:org:shape:delete -u me@my.org","$ sfdx force:org:shape:delete -u MyOrgAlias -p","$ sfdx force:org:shape:delete -u me@my.org --json","$ sfdx force:org:shape:delete -u me@my.org -p --json > tmp/MyOrgShapeDelete.json"],"flags":{"json":{"name":"json","type":"boolean","description":"format output as json","allowNo":false},"loglevel":{"name":"loglevel","type":"option","description":"logging level for this command invocation","required":false,"helpValue":"(trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL)","multiple":false,"options":["trace","debug","info","warn","error","fatal","TRACE","DEBUG","INFO","WARN","ERROR","FATAL"],"default":"warn"},"targetusername":{"name":"targetusername","type":"option","char":"u","description":"username or alias for the target org; overrides default target org","multiple":false},"apiversion":{"name":"apiversion","type":"option","description":"override the api version used for api requests made by this command","multiple":false},"noprompt":{"name":"noprompt","type":"boolean","char":"p","description":"do not prompt for confirmation","allowNo":false}},"args":[],"requiresUsername":true,"flagsConfig":{"noprompt":{"kind":"boolean","char":"p","description":"do not prompt for confirmation","allowNo":false,"type":"boolean"}}},"force:org:shape:list":{"id":"force:org:shape:list","description":"List all org shapes you’ve created","strict":true,"usage":"<%= command.id %> [--verbose] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]","pluginName":"@salesforce/plugin-signups","pluginAlias":"@salesforce/plugin-signups","pluginType":"core","aliases":[],"examples":["$ sfdx force:org:shape:list","$ sfdx force:org:shape:list --json","$ sfdx force:org:shape:list --json > tmp/MyOrgShapeList.json"],"flags":{"json":{"name":"json","type":"boolean","description":"format output as json","allowNo":false},"loglevel":{"name":"loglevel","type":"option","description":"logging level for this command invocation","required":false,"helpValue":"(trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL)","multiple":false,"options":["trace","debug","info","warn","error","fatal","TRACE","DEBUG","INFO","WARN","ERROR","FATAL"],"default":"warn"},"verbose":{"name":"verbose","type":"boolean","description":"list more information about each org shape","allowNo":false}},"args":[],"flagsConfig":{"verbose":{"description":"list more information about each org shape","type":"boolean","kind":"boolean","longDescription":"Emit additional command output to stdout.","allowNo":false}}},"force:org:snapshot:create":{"id":"force:org:snapshot:create","description":"create a snapshot of a scratch org\nA snapshot is a point-in-time copy of a scratch org. The copy is stored in Salesforce and referenced by its unique name in a scratch org definition file.\n\nUse \"sfdx force:org:snapshot:get\" to get details, including status, about a snapshot creation request.\n\nTo create a scratch org from a snapshot, include the \"snapshot\" entry (instead of \"edition\") in the scratch org definition file and set it to the name of the snapshot. Then use \"sfdx force:org:create\" to create the scratch org.","strict":true,"usage":"<%= command.id %> -o <string> -n <string> [-d <string>] [-v <string>] [--apiversion <string>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]","pluginName":"@salesforce/plugin-signups","pluginAlias":"@salesforce/plugin-signups","pluginType":"core","aliases":[],"examples":["Create a snapshot called \"Dependencies\" using the source scratch org ID:","$ sfdx force:org:snapshot:create --sourceorg 00Dxx0000000000 --snapshotname Dependencies --description 'Contains PackageA v1.1.0'","Create a snapshot called \"NightlyBranch\" using the source scratch org username:","$ sfdx force:org:snapshot:create -o myuser@myorg -n NightlyBranch -d 'Contains PkgA v2.1.0 and PkgB 3.3.0'"],"flags":{"json":{"name":"json","type":"boolean","description":"format output as json","allowNo":false},"loglevel":{"name":"loglevel","type":"option","description":"logging level for this command invocation","required":false,"helpValue":"(trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL)","multiple":false,"options":["trace","debug","info","warn","error","fatal","TRACE","DEBUG","INFO","WARN","ERROR","FATAL"],"default":"warn"},"targetdevhubusername":{"name":"targetdevhubusername","type":"option","char":"v","description":"username or alias for the dev hub org; overrides default dev hub org","multiple":false},"apiversion":{"name":"apiversion","type":"option","description":"override the api version used for api requests made by this command","multiple":false},"sourceorg":{"name":"sourceorg","type":"option","char":"o","description":"ID or locally authenticated username or alias of scratch org to snapshot","required":true,"multiple":false},"snapshotname":{"name":"snapshotname","type":"option","char":"n","description":"unique name of snapshot","required":true,"multiple":false},"description":{"name":"description","type":"option","char":"d","description":"description of snapshot","multiple":false}},"args":[],"requiresDevhubUsername":true,"flagsConfig":{"sourceorg":{"kind":"string","char":"o","description":"ID or locally authenticated username or alias of scratch org to snapshot","longDescription":"The org ID, or a locally authenticated username or alias, of the scratch org to snapshot.","required":true,"input":[],"multiple":false,"type":"option"},"snapshotname":{"kind":"string","char":"n","description":"unique name of snapshot","longDescription":"The unique name of the snapshot. Use this name to create scratch orgs from the snapshot.","required":true,"input":[],"multiple":false,"type":"option"},"description":{"kind":"string","char":"d","description":"description of snapshot","longDescription":"A description of the snapshot. Use this description to document the contents of the snapshot.\nWe suggest that you include a reference point, such as a version control system tag or commit ID.'","input":[],"multiple":false,"type":"option"}}},"force:org:snapshot:delete":{"id":"force:org:snapshot:delete","description":"delete a scratch org snapshot\nDev Hub admins can delete any snapshot, while users can delete only theirs unless a Dev Hub admin gives the user Modify All permissions.","strict":true,"usage":"<%= command.id %> -s <string> [-v <string>] [--apiversion <string>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]","pluginName":"@salesforce/plugin-signups","pluginAlias":"@salesforce/plugin-signups","pluginType":"core","aliases":[],"examples":["Delete a snapshot from the default Dev Hub using the snapshot ID:","$ sfdx force:org:snapshot:delete --snapshot 0Oo...","Delete a snapshot from the specified Dev Hub using the snapshot name:","$ sfdx force:org:snapshot:delete -s BaseSnapshot -v SnapshotDevHub"],"flags":{"json":{"name":"json","type":"boolean","description":"format output as json","allowNo":false},"loglevel":{"name":"loglevel","type":"option","description":"logging level for this command invocation","required":false,"helpValue":"(trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL)","multiple":false,"options":["trace","debug","info","warn","error","fatal","TRACE","DEBUG","INFO","WARN","ERROR","FATAL"],"default":"warn"},"targetdevhubusername":{"name":"targetdevhubusername","type":"option","char":"v","description":"username or alias for the dev hub org; overrides default dev hub org","multiple":false},"apiversion":{"name":"apiversion","type":"option","description":"override the api version used for api requests made by this command","multiple":false},"snapshot":{"name":"snapshot","type":"option","char":"s","description":"name or ID of snapshot to delete","required":true,"multiple":false}},"args":[],"requiresDevhubUsername":true,"flagsConfig":{"snapshot":{"kind":"string","char":"s","description":"name or ID of snapshot to delete","longDescription":"The name or ID (starts with 0Oo) of the snapshot to delete.","required":true,"input":[],"multiple":false,"type":"option"}}},"force:org:snapshot:get":{"id":"force:org:snapshot:get","description":"get details about a scratch org snapshot\nSnapshot creation can take a while. Use this command with the snapshot name or ID to check its creation status. Once the status changes to Active, you can use the snapshot to create scratch orgs. \n\nTo create a snapshot, use the \"sfdx force:org:snapshot:create\" command. To retrieve a list of all snapshots, use \"sfdx force:org:snapshot:list\".","strict":true,"usage":"<%= command.id %> -s <string> [-v <string>] [--apiversion <string>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]","pluginName":"@salesforce/plugin-signups","pluginAlias":"@salesforce/plugin-signups","pluginType":"core","aliases":[],"examples":["Get snapshot details using its ID:","$ sfdx force:org:snapshot:get --snapshot 0Oo...","Get snapshot details using its name:","$ sfdx force:org:snapshot:get -s Dependencies"],"flags":{"json":{"name":"json","type":"boolean","description":"format output as json","allowNo":false},"loglevel":{"name":"loglevel","type":"option","description":"logging level for this command invocation","required":false,"helpValue":"(trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL)","multiple":false,"options":["trace","debug","info","warn","error","fatal","TRACE","DEBUG","INFO","WARN","ERROR","FATAL"],"default":"warn"},"targetdevhubusername":{"name":"targetdevhubusername","type":"option","char":"v","description":"username or alias for the dev hub org; overrides default dev hub org","multiple":false},"apiversion":{"name":"apiversion","type":"option","description":"override the api version used for api requests made by this command","multiple":false},"snapshot":{"name":"snapshot","type":"option","char":"s","description":"name or ID of snapshot to retrieve","required":true,"multiple":false}},"args":[],"requiresDevhubUsername":true,"flagsConfig":{"snapshot":{"kind":"string","char":"s","description":"name or ID of snapshot to retrieve","longDescription":"The name or ID (starts with 0Oo) of the snapshot to retrieve.","required":true,"input":[],"multiple":false,"type":"option"}}},"force:org:snapshot:list":{"id":"force:org:snapshot:list","description":"list scratch org snapshots\nYou can view all the snapshots in a Dev Hub that you have access to. If you’re an admin, you can see all snapshots associated with the Dev Hub org. If you’re a user, you can see only your snapshots unless a Dev Hub admin gives you View All permissions.\n\nTo create a snapshot, use the \"sfdx force:org:snapshot:create\" command. To get details about a snapshot request, use \"sfdx force:org:snapshot:get\".","strict":true,"usage":"<%= command.id %> [-v <string>] [--apiversion <string>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]","pluginName":"@salesforce/plugin-signups","pluginAlias":"@salesforce/plugin-signups","pluginType":"core","aliases":[],"examples":["List snapshots in the default Dev Hub:","$ sfdx force:org:snapshot:list","List snapshots in the Dev Hub with the specified username:","$ sfdx force:org:snapshot:list -v OtherDevHub@example.com"],"flags":{"json":{"name":"json","type":"boolean","description":"format output as json","allowNo":false},"loglevel":{"name":"loglevel","type":"option","description":"logging level for this command invocation","required":false,"helpValue":"(trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL)","multiple":false,"options":["trace","debug","info","warn","error","fatal","TRACE","DEBUG","INFO","WARN","ERROR","FATAL"],"default":"warn"},"targetdevhubusername":{"name":"targetdevhubusername","type":"option","char":"v","description":"username or alias for the dev hub org; overrides default dev hub org","multiple":false},"apiversion":{"name":"apiversion","type":"option","description":"override the api version used for api requests made by this command","multiple":false}},"args":[],"requiresDevhubUsername":true}}}

package/package.json

@@ -1,19 +1,19 @@
 {
     "name": "@salesforce/plugin-signups",
     "description": "Commands to interact with org shapes",
-    "version": "1.0.0",
+    "version": "1.1.2",
     "author": "Salesforce",
     "main": "lib/index.js",
     "bugs": "https://github.com/forcedotcom/cli/issues",
     "dependencies": {
         "@oclif/core": "^1.6.3",
         "@salesforce/command": "^5.0.1",
-        "@salesforce/core": "^3.10.1",
+        "@salesforce/core": "^3.16.0",
         "chalk": "^4.1.2",
+        "change-case": "^4.1.2",
         "tslib": "^2"
     },
     "devDependencies": {
-        "oclif": "^2.6.1",
         "@oclif/plugin-command-snapshot": "^3.1.3",
         "@salesforce/cli-plugins-testkit": "^1.5.3",
         "@salesforce/dev-config": "^3.0.1",
@@ -22,10 +22,13 @@
         "@salesforce/prettier-config": "^0.0.2",
         "@salesforce/ts-sinon": "1.3.21",
         "@salesforce/ts-types": "^1.5.20",
+        "@types/chai-string": "^1.4.2",
+        "@types/shelljs": "^0.8.11",
         "@typescript-eslint/eslint-plugin": "^4.33.0",
         "@typescript-eslint/parser": "^4.32.0",
         "chai": "^4.3.4",
         "chai-as-promised": "7.1.1",
+        "chai-string": "^1.5.0",
         "cz-conventional-changelog": "^3.3.0",
         "eslint": "^7.32.0",
         "eslint-config-prettier": "^8.3.0",
@@ -40,12 +43,13 @@
         "lint-staged": "^11.2.0",
         "mocha": "^9.1.3",
         "nyc": "^15.1.0",
+        "oclif": "^2.6.1",
         "prettier": "^2.4.1",
         "pretty-quick": "^3.1.0",
-        "shx": "0.2.2",
+        "shx": "0.3.4",
         "sinon": "^11.1.1",
         "ts-node": "^10.2.1",
-        "typescript": "^4.1.3"
+        "typescript": "^4.6.4"
     },
     "config": {
         "commitizen": {
@@ -53,7 +57,7 @@
         }
     },
     "engines": {
-        "node": ">=12.0.0"
+        "node": ">=14.0.0"
     },
     "files": [
         "/lib",
@@ -83,7 +87,19 @@
                     "org": {
                         "subtopics": {
                             "shape": {
-                                "description": "manage org shape"
+                                "description": "manage org shape",
+                                "trailblazerCommunityLink": {
+                                    "url": "https://success.salesforce.com/_ui/core/chatter/groups/GroupProfilePage?g=0F93A0000009TPk",
+                                    "name": "Org Shape for Scratch Orgs"
+                                }
+                            },
+                            "snapshot": {
+                                "description": "manage org snapshots",
+                                "state": "closedPilot",
+                                "trailblazerCommunityLink": {
+                                    "url": "https://success.salesforce.com/_ui/core/chatter/groups/GroupProfilePage?g=0F93A00000020d5",
+                                    "name": "W19 Pilot: Scratch Org Snapshots"
+                                }
                             }
                         }
                     }
@@ -110,13 +126,14 @@
         "test:command-reference": "./bin/run commandreference:generate --erroronwarnings",
         "test:deprecation-policy": "./bin/run snapshot:compare",
         "test:nuts": "nyc mocha \"**/*.nut.ts\" --slow 4500 --timeout 600000 --parallel",
+        "test:nuts:snapshots": "nyc mocha \"test/nuts/snapshots.nut.ts\" --slow 4500 --timeout 600000 --parallel",
         "version": "oclif readme"
     },
     "publishConfig": {
         "access": "public"
     },
     "sfdx": {
-        "publicKeyUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-signups/1.0.0.crt",
-        "signatureUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-signups/1.0.0.sig"
+        "publicKeyUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-signups/1.1.2.crt",
+        "signatureUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-signups/1.1.2.sig"
     }
 }