@salesforce/core 2.36.4 → 2.37.0

package/CHANGELOG.md

@@ -2,6 +2,16 @@
 
 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.
 
+## [2.37.0](https://github.com/forcedotcom/sfdx-core/compare/v2.36.4...v2.37.0) (2022-05-03)
+
+### Features
+
+- new cloneSandbox method ([69073dd](https://github.com/forcedotcom/sfdx-core/commit/69073dd71ee7372d13c86aaf052c798a4bea5176))
+
+### Bug Fixes
+
+- use tooling api ([c32f19d](https://github.com/forcedotcom/sfdx-core/commit/c32f19d8de6a953f8390fd853d3be023db01d890))
+
 ### [2.36.4](https://github.com/forcedotcom/sfdx-core/compare/v2.36.3...v2.36.4) (2022-04-28)
 
 ### Bug Fixes

package/lib/org.d.ts

@@ -105,6 +105,17 @@ export declare class Org extends AsyncCreatable<Org.Options> {
         wait?: Duration;
         interval?: Duration;
     }): Promise<SandboxProcessObject>;
+    /**
+     *
+     * @param sandboxReq SandboxRequest options to create the sandbox with
+     * @param sandboxName
+     * @param options Wait: The amount of time to wait before timing out, defaults to 0, Interval: The time interval between polling defaults to 30 seconds
+     * @returns {SandboxProcessObject} the newly created sandbox process object
+     */
+    cloneSandbox(sandboxReq: SandboxRequest, sandboxName: string, options: {
+        wait?: Duration;
+        interval?: Duration;
+    }): Promise<SandboxProcessObject>;
     /**
      * Creates a scratchOrg
      * 'this' needs to be a valid dev-hub
@@ -358,6 +369,12 @@ export declare class Org extends AsyncCreatable<Org.Options> {
      * @private
      */
     private querySandboxProcess;
+    /**
+     *
+     * @param sandboxNameIn
+     * @returns sandboxInfoId
+     */
+    private querySandboxInfoIdBySandboxName;
     /**
      * determines if the sandbox has successfully been created
      *

package/lib/org.js

@@ -100,6 +100,18 @@ class Org extends kit_1.AsyncCreatable {
             pollInterval,
         });
     }
+    /**
+     *
+     * @param sandboxReq SandboxRequest options to create the sandbox with
+     * @param sandboxName
+     * @param options Wait: The amount of time to wait before timing out, defaults to 0, Interval: The time interval between polling defaults to 30 seconds
+     * @returns {SandboxProcessObject} the newly created sandbox process object
+     */
+    async cloneSandbox(sandboxReq, sandboxName, options) {
+        sandboxReq.SourceId = await this.querySandboxInfoIdBySandboxName(sandboxName);
+        this.logger.debug('Clone sandbox sourceId %s', sandboxReq.SourceId);
+        return this.createSandbox(sandboxReq, options);
+    }
     /**
      * Creates a scratchOrg
      * 'this' needs to be a valid dev-hub
@@ -861,6 +873,27 @@ class Org extends kit_1.AsyncCreatable {
             tooling: true,
         });
     }
+    /**
+     *
+     * @param sandboxNameIn
+     * @returns sandboxInfoId
+     */
+    async querySandboxInfoIdBySandboxName(sandboxNameIn) {
+        var _a;
+        this.logger.debug('QuerySandboxInfoIdBySandboxName called with SandboxName: %s ', sandboxNameIn);
+        const queryStr = `SELECT Id, SandboxName FROM SandboxInfo WHERE SandboxName='${sandboxNameIn}'`;
+        const queryResult = await this.connection.tooling.query(queryStr);
+        this.logger.debug('Return from calling queryToolingApi: %s ', JSON.stringify(queryResult));
+        if (((_a = queryResult === null || queryResult === void 0 ? void 0 : queryResult.records) === null || _a === void 0 ? void 0 : _a.length) === 1) {
+            return (queryResult === null || queryResult === void 0 ? void 0 : queryResult.records[0]).Id;
+        }
+        else if (queryResult.records && queryResult.records.length > 1) {
+            throw sfdxError_1.SfdxError.create('@salesforce/core', 'org', 'MultiSandboxInfoNotFoundBySandboxName', [sandboxNameIn]);
+        }
+        else {
+            throw sfdxError_1.SfdxError.create('@salesforce/core', 'org', 'SandboxInfoNotFoundBySandboxName', [sandboxNameIn]);
+        }
+    }
     /**
      * determines if the sandbox has successfully been created
      *

package/messages/org.json

@@ -11,5 +11,7 @@
   "MissingAuthUsername": "The sandbox %s does not have an authorized username.",
   "OrgPollingTimeout": "Sandbox status is %s; timed out waiting for completion.",
   "SandboxProcessNotFoundBySandboxName": "We can't find a SandboxProcess with the SandboxName %s.",
-  "MultiSandboxProcessNotFoundBySandboxName": "We found more than one SandboxProcess with the SandboxName %s."
+  "SandboxInfoNotFoundBySandboxName": "We can't find a SandboxInfo with the SandboxName %s.",
+  "MultiSandboxProcessNotFoundBySandboxName": "We found more than one SandboxProcess with the SandboxName %s.",
+  "MultiSandboxInfoNotFoundBySandboxName": "We found more than one SandboxInfo with the SandboxName %s."
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@salesforce/core",
-  "version": "2.36.4",
+  "version": "2.37.0",
   "description": "Core libraries to interact with SFDX projects, orgs, and APIs.",
   "main": "lib/exported",
   "types": "lib/exported.d.ts",