@salesforce/core-bundle 8.14.0 → 8.15.0

package/lib/index.d.ts

@@ -3070,6 +3070,11 @@ declare module '@salesforce/core-bundle/org/org' {
   import { Connection } from '@salesforce/core-bundle/org/connection';
   import { AuthFields, AuthInfo } from '@salesforce/core-bundle/org/authInfo';
   import { ScratchOrgCreateOptions, ScratchOrgCreateResult } from '@salesforce/core-bundle/org/scratchOrgCreate';
+  export type XOR<T, U> = (T & {
+      [K in keyof U]?: never;
+  }) | (U & {
+      [K in keyof T]?: never;
+  });
   export type OrganizationInformation = {
       Name: string;
       InstanceName: string;
@@ -3124,6 +3129,7 @@ declare module '@salesforce/core-bundle/org/org' {
       Description?: string;
       ApexClassId?: string;
       EndDate?: string;
+      Features?: string[];
   };
   export type SandboxRequest = {
       SandboxName: string;
@@ -3133,6 +3139,7 @@ declare module '@salesforce/core-bundle/org/org' {
       Description?: string;
       ApexClassId?: string;
       ActivationUserGroupId?: string;
+      Features?: string[];
   };
   export type ResumeSandboxRequest = {
       SandboxName?: string;
@@ -3156,6 +3163,7 @@ declare module '@salesforce/core-bundle/org/org' {
       SourceId?: string;
       ActivationUserGroupId?: string;
       CopyArchivedActivities?: boolean;
+      Features?: string[];
   };
   export type ScratchOrgRequest = Omit<ScratchOrgCreateOptions, 'hubOrg'>;
   export type SandboxFields = {
@@ -3167,6 +3175,11 @@ declare module '@salesforce/core-bundle/org/org' {
       sandboxInfoId?: string;
       timestamp?: string;
   };
+  export type SandboxInfoQueryFields = XOR<{
+      name: string;
+  }, {
+      id: string;
+  }>;
   /**
    * Provides a way to manage a locally authenticated Org.
    *
@@ -3378,6 +3391,7 @@ declare module '@salesforce/core-bundle/org/org' {
        * @returns org information
        */
       retrieveOrganizationInformation(): Promise<OrganizationInformation>;
+      querySandboxInfo(by: SandboxInfoQueryFields): Promise<SandboxInfo>;
       /**
        * Some organization information is locally cached, such as if the org name or if it is a scratch org.
        * This method populates/updates the filesystem from information retrieved from the org.

package/lib/index.js

@@ -7821,7 +7821,9 @@ var require_logger = __commonJS({
         return {
           target: "pino-pretty",
           options: {
-            colorize: env.getBoolean("SF_LOG_COLORIZE") ?? true,
+            // NOTE: env.getBoolean() defaults to false if the env var is not set
+            // so it's important to use `||` instead of `??`
+            colorize: env.getBoolean("SF_LOG_COLORIZE") || true,
             destination: env.getBoolean("SF_LOG_STDERR") ? 2 : 1
           }
         };
@@ -12334,7 +12336,7 @@ var require_package2 = __commonJS({
   "package.json"(exports2, module2) {
     module2.exports = {
       name: "@salesforce/core-bundle",
-      version: "8.14.0",
+      version: "8.15.0",
       description: "Core libraries to interact with SFDX projects, orgs, and APIs.",
       main: "lib/index",
       types: "lib/index.d.ts",
@@ -107777,7 +107779,27 @@ var require_org = __commonJS({
       "SandboxOrganization",
       "SourceId",
       "Description",
-      "EndDate"
+      "EndDate",
+      "Features"
+    ];
+    var sandboxInfoFields = [
+      "Id",
+      "IsDeleted",
+      "CreatedDate",
+      "CreatedById",
+      "LastModifiedDate",
+      "LastModifiedById",
+      "SandboxName",
+      "LicenseType",
+      "TemplateId",
+      "HistoryDays",
+      "CopyChatter",
+      "AutoActivate",
+      "ApexClassId",
+      "Description",
+      "SourceId",
+      "ActivationUserGroupId",
+      "Features"
     ];
     var Org = class _Org extends kit_1.AsyncOptionalCreatable {
       status = _Org.Status.UNKNOWN;
@@ -108222,6 +108244,25 @@ var require_org = __commonJS({
       async retrieveOrganizationInformation() {
         return this.getConnection().singleRecordQuery("SELECT Name, InstanceName, IsSandbox, TrialExpirationDate, NamespacePrefix FROM Organization");
       }
+      async querySandboxInfo(by) {
+        if (by.id) {
+          if (!(0, sfdc_1.validateSalesforceId)(by.id)) {
+            throw new sfError_12.SfError(`Invalid Salesforce ID format: ${by.id}`, "InvalidSalesforceId");
+          }
+        }
+        const whereClause = by.id ? `Id='${by.id}'` : `SandboxName='${by.name}'`;
+        const soql = `SELECT ${sandboxInfoFields.join(",")} FROM SandboxInfo WHERE ${whereClause} ORDER BY CreatedDate DESC`;
+        const result = (await this.connection.tooling.query(soql)).records.filter((item) => !item.IsDeleted);
+        if (result.length === 0) {
+          throw new sfError_12.SfError(`No record found for ${soql}`, connection_12.SingleRecordQueryErrors.NoRecords);
+        }
+        if (result.length > 1) {
+          const err = new sfError_12.SfError("The query returned more than 1 record", connection_12.SingleRecordQueryErrors.MultipleRecords);
+          err.data = result;
+          throw err;
+        }
+        return result[0];
+      }
       /**
        * Some organization information is locally cached, such as if the org name or if it is a scratch org.
        * This method populates/updates the filesystem from information retrieved from the org.

package/package.json

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