@salesforce/core 3.7.7 → 3.8.0

package/CHANGELOG.md

@@ -2,6 +2,24 @@
 
 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.
 
+## [3.8.0](https://github.com/forcedotcom/sfdx-core/compare/v3.7.9...v3.8.0) (2022-03-09)
+
+### Features
+
+- add handle side effect function to authinfo ([64c78e7](https://github.com/forcedotcom/sfdx-core/commit/64c78e74bc5e1cfb748fd2d64e4b1e8fc1062bf6))
+
+### [3.7.9](https://github.com/forcedotcom/sfdx-core/compare/v3.7.8...v3.7.9) (2022-03-04)
+
+### Bug Fixes
+
+- error literal to match the error thrown ([#533](https://github.com/forcedotcom/sfdx-core/issues/533)) ([b91ce5c](https://github.com/forcedotcom/sfdx-core/commit/b91ce5c329c9b2b88fb4b0ad028aee5f6d5b6e77))
+
+### [3.7.8](https://github.com/forcedotcom/sfdx-core/compare/v3.7.7...v3.7.8) (2022-03-03)
+
+### Bug Fixes
+
+- add create warning and info convenience functions ([#526](https://github.com/forcedotcom/sfdx-core/issues/526)) ([e3428b3](https://github.com/forcedotcom/sfdx-core/commit/e3428b35e00b9cee3c90153ed6ce08b352535ff7))
+
 ### [3.7.7](https://github.com/forcedotcom/sfdx-core/compare/v3.7.6...v3.7.7) (2022-03-01)
 
 ### [3.7.6](https://github.com/forcedotcom/sfdx-core/compare/v4.0.0...v3.7.6) (2022-02-28)

package/lib/config/config.d.ts

@@ -56,12 +56,14 @@ export declare enum SfdxPropertyKeys {
      * Username associated with the default dev hub org.
      *
      * @deprecated Replaced by OrgConfigProperties.TARGET_DEV_HUB in v3 {@link https://github.com/forcedotcom/sfdx-core/blob/v3/MIGRATING_V2-V3.md#config}
+     * will remain in v3 for the foreseeable future so that `sfdx-core` can map between `sf` and `sfdx` config values
      */
     DEFAULT_DEV_HUB_USERNAME = "defaultdevhubusername",
     /**
      * Username associate with the default org.
      *
      * @deprecated Replaced by OrgConfigProperties.TARGET_ORG in v3 {@link https://github.com/forcedotcom/sfdx-core/blob/v3/MIGRATING_V2-V3.md#config}
+     * will remain in v3 for the foreseeable future so that `sfdx-core` can map between `sf` and `sfdx` config values
      */
     DEFAULT_USERNAME = "defaultusername",
     /**

package/lib/config/config.js

@@ -8,13 +8,14 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Config = exports.SfProperty = exports.SFDX_ALLOWED_PROPERTIES = exports.SfdxPropertyKeys = void 0;
 const path_1 = require("path");
+const fs = require("fs");
 const kit_1 = require("@salesforce/kit");
 const ts_types_1 = require("@salesforce/ts-types");
+const mkdirp = require("mkdirp");
 const global_1 = require("../global");
 const logger_1 = require("../logger");
 const messages_1 = require("../messages");
 const sfdc_1 = require("../util/sfdc");
-const fs_1 = require("../util/fs");
 const sfdcUrl_1 = require("../util/sfdcUrl");
 const orgConfigProperties_1 = require("../org/orgConfigProperties");
 const configFile_1 = require("./configFile");
@@ -49,12 +50,14 @@ var SfdxPropertyKeys;
      * Username associated with the default dev hub org.
      *
      * @deprecated Replaced by OrgConfigProperties.TARGET_DEV_HUB in v3 {@link https://github.com/forcedotcom/sfdx-core/blob/v3/MIGRATING_V2-V3.md#config}
+     * will remain in v3 for the foreseeable future so that `sfdx-core` can map between `sf` and `sfdx` config values
      */
     SfdxPropertyKeys["DEFAULT_DEV_HUB_USERNAME"] = "defaultdevhubusername";
     /**
      * Username associate with the default org.
      *
      * @deprecated Replaced by OrgConfigProperties.TARGET_ORG in v3 {@link https://github.com/forcedotcom/sfdx-core/blob/v3/MIGRATING_V2-V3.md#config}
+     * will remain in v3 for the foreseeable future so that `sfdx-core` can map between `sf` and `sfdx` config values
      */
     SfdxPropertyKeys["DEFAULT_USERNAME"] = "defaultusername";
     /**
@@ -115,12 +118,14 @@ exports.SFDX_ALLOWED_PROPERTIES = [
         },
     },
     {
+        // will remain in v3 for the foreseeable future so that `sfdx-core` can map between `sf` and `sfdx` config values
         key: SfdxPropertyKeys.DEFAULT_DEV_HUB_USERNAME,
         newKey: orgConfigProperties_1.OrgConfigProperties.TARGET_DEV_HUB,
         deprecated: true,
         description: messages.getMessage('defaultDevHubUsername'),
     },
     {
+        // will remain in v3 for the foreseeable future so that `sfdx-core` can map between `sf` and `sfdx` config values
         key: SfdxPropertyKeys.DEFAULT_USERNAME,
         newKey: orgConfigProperties_1.OrgConfigProperties.TARGET_ORG,
         deprecated: true,
@@ -446,7 +451,7 @@ class SfdxConfig {
     }
     readSync() {
         try {
-            const contents = fs_1.fs.readJsonMapSync(this.getSfdxPath());
+            const contents = (0, kit_1.parseJsonMap)(fs.readFileSync(this.getSfdxPath(), 'utf8'));
             return this.normalize(contents, 'toNew');
         }
         catch (error) {
@@ -457,9 +462,9 @@ class SfdxConfig {
     async writeSync(config = this.config.toObject()) {
         try {
             const sfdxPath = this.getSfdxPath();
-            await fs_1.fs.mkdirp((0, path_1.dirname)(sfdxPath));
+            await mkdirp((0, path_1.dirname)(sfdxPath));
             const mapped = this.normalize(config, 'toOld');
-            await fs_1.fs.writeJson(sfdxPath, mapped);
+            await fs.promises.writeFile(sfdxPath, JSON.stringify(mapped, null, 2));
         }
         catch (error) {
             /* Do nothing */

package/lib/config/configFile.js

@@ -7,14 +7,16 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ConfigFile = void 0;
+const fs = require("fs");
 const fs_1 = require("fs");
 const os_1 = require("os");
 const path_1 = require("path");
 const ts_types_1 = require("@salesforce/ts-types");
+const kit_1 = require("@salesforce/kit");
+const mkdirp = require("mkdirp");
 const global_1 = require("../global");
 const logger_1 = require("../logger");
 const sfError_1 = require("../sfError");
-const fs_2 = require("../util/fs");
 const internal_1 = require("../util/internal");
 const configStore_1 = require("./configStore");
 /**
@@ -107,7 +109,7 @@ class ConfigFile extends configStore_1.BaseConfigStore {
      */
     async access(perm) {
         try {
-            await fs_2.fs.access(this.getPath(), perm);
+            await fs.promises.access(this.getPath(), perm);
             return true;
         }
         catch (err) {
@@ -124,7 +126,7 @@ class ConfigFile extends configStore_1.BaseConfigStore {
      */
     accessSync(perm) {
         try {
-            fs_2.fs.accessSync(this.getPath(), perm);
+            fs.accessSync(this.getPath(), perm);
             return true;
         }
         catch (err) {
@@ -146,7 +148,7 @@ class ConfigFile extends configStore_1.BaseConfigStore {
             // internally and updated persistently via write().
             if (!this.hasRead || force) {
                 this.logger.info(`Reading config file: ${this.getPath()}`);
-                const obj = await fs_2.fs.readJsonMap(this.getPath());
+                const obj = (0, kit_1.parseJsonMap)(await fs.promises.readFile(this.getPath(), 'utf8'));
                 this.setContentsFromObject(obj);
             }
             return this.getContents();
@@ -181,7 +183,7 @@ class ConfigFile extends configStore_1.BaseConfigStore {
             // internally and updated persistently via write().
             if (!this.hasRead || force) {
                 this.logger.info(`Reading config file: ${this.getPath()}`);
-                const obj = fs_2.fs.readJsonMapSync(this.getPath());
+                const obj = (0, kit_1.parseJsonMap)(fs.readFileSync(this.getPath(), 'utf8'));
                 this.setContentsFromObject(obj);
             }
             return this.getContents();
@@ -211,9 +213,9 @@ class ConfigFile extends configStore_1.BaseConfigStore {
         if (newContents) {
             this.setContents(newContents);
         }
-        await fs_2.fs.mkdirp((0, path_1.dirname)(this.getPath()));
+        await mkdirp((0, path_1.dirname)(this.getPath()));
         this.logger.info(`Writing to config file: ${this.getPath()}`);
-        await fs_2.fs.writeJson(this.getPath(), this.toObject());
+        await fs.promises.writeFile(this.getPath(), JSON.stringify(this.toObject(), null, 2));
         return this.getContents();
     }
     /**
@@ -226,9 +228,9 @@ class ConfigFile extends configStore_1.BaseConfigStore {
         if ((0, ts_types_1.isPlainObject)(newContents)) {
             this.setContents(newContents);
         }
-        fs_2.fs.mkdirpSync((0, path_1.dirname)(this.getPath()));
+        mkdirp.sync((0, path_1.dirname)(this.getPath()));
         this.logger.info(`Writing to config file: ${this.getPath()}`);
-        fs_2.fs.writeJsonSync(this.getPath(), this.toObject());
+        fs.writeFileSync(this.getPath(), JSON.stringify(this.toObject(), null, 2));
         return this.getContents();
     }
     /**
@@ -249,7 +251,7 @@ class ConfigFile extends configStore_1.BaseConfigStore {
      * {@link fs.stat}
      */
     async stat() {
-        return fs_2.fs.stat(this.getPath());
+        return fs.promises.stat(this.getPath());
     }
     /**
      * Get the stats of the file. Returns the stats of the file.
@@ -257,7 +259,7 @@ class ConfigFile extends configStore_1.BaseConfigStore {
      * {@link fs.stat}
      */
     statSync() {
-        return fs_2.fs.statSync(this.getPath());
+        return fs.statSync(this.getPath());
     }
     /**
      * Delete the config file if it exists.
@@ -268,7 +270,7 @@ class ConfigFile extends configStore_1.BaseConfigStore {
     async unlink() {
         const exists = await this.exists();
         if (exists) {
-            return await fs_2.fs.unlink(this.getPath());
+            return await fs.promises.unlink(this.getPath());
         }
         throw new sfError_1.SfError(`Target file doesn't exist. path: ${this.getPath()}`, 'TargetFileNotFound');
     }
@@ -281,7 +283,7 @@ class ConfigFile extends configStore_1.BaseConfigStore {
     unlinkSync() {
         const exists = this.existsSync();
         if (exists) {
-            return fs_2.fs.unlinkSync(this.getPath());
+            return fs.unlinkSync(this.getPath());
         }
         throw new sfError_1.SfError(`Target file doesn't exist. path: ${this.getPath()}`, 'TargetFileNotFound');
     }

package/lib/config/keychainConfig.js

@@ -8,7 +8,8 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.KeychainConfig = void 0;
 const path_1 = require("path");
-const fs_1 = require("../util/fs");
+const fs = require("fs");
+const mkdirp = require("mkdirp");
 const configFile_1 = require("./configFile");
 /**
  * Represent a key chain config backed by a json file.
@@ -34,8 +35,8 @@ class KeychainConfig extends configFile_1.ConfigFile {
         if (newContents != null) {
             this.setContents(newContents);
         }
-        await fs_1.fs.mkdirp((0, path_1.dirname)(this.getPath()));
-        await fs_1.fs.writeFile(this.getPath(), JSON.stringify(this.getContents(), null, 4), { mode: '600' });
+        await mkdirp((0, path_1.dirname)(this.getPath()));
+        await fs.promises.writeFile(this.getPath(), JSON.stringify(this.getContents(), null, 4), { mode: '600' });
         return this.getContents();
     }
 }

package/lib/crypto/keyChainImpl.js

@@ -9,12 +9,14 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.keyChainImpl = exports.GenericWindowsKeychainAccess = exports.GenericUnixKeychainAccess = exports.GenericKeychainAccess = exports.KeychainAccess = void 0;
 const childProcess = require("child_process");
 const nodeFs = require("fs");
+const fs = require("fs");
 const os = require("os");
-const path = require("path");
 const os_1 = require("os");
+const path = require("path");
 const ts_types_1 = require("@salesforce/ts-types");
+const kit_1 = require("@salesforce/kit");
+const mkdirp = require("mkdirp");
 const global_1 = require("../global");
-const fs_1 = require("../util/fs");
 const messages_1 = require("../messages");
 messages_1.Messages.importMessagesDirectory(__dirname);
 const messages = messages_1.Messages.load('@salesforce/core', 'encryption', [
@@ -329,8 +331,8 @@ async function _writeFile(opts, fn) {
             [SecretField.KEY]: opts.password,
             [SecretField.SERVICE]: opts.service,
         };
-        await fs_1.fs.mkdirp(path.dirname(secretFile));
-        await fs_1.fs.writeFile(secretFile, JSON.stringify(contents, null, 4), { mode: '600' });
+        await mkdirp(path.dirname(secretFile));
+        await fs.promises.writeFile(secretFile, JSON.stringify(contents, null, 4), { mode: '600' });
         fn(null, contents);
     }
     catch (err) {
@@ -339,7 +341,7 @@ async function _writeFile(opts, fn) {
 }
 async function _readFile() {
     // The file and access is validated before this method is called
-    const fileContents = await fs_1.fs.readJsonMap(secretFile);
+    const fileContents = (0, kit_1.parseJsonMap)(await fs.promises.readFile(secretFile, 'utf8'));
     return {
         account: (0, ts_types_1.ensureString)(fileContents[SecretField.ACCOUNT]),
         password: (0, ts_types_1.asString)(fileContents[SecretField.KEY]),
@@ -406,7 +408,7 @@ class GenericKeychainAccess {
     async isValidFileAccess(cb) {
         try {
             const root = (0, os_1.homedir)();
-            await fs_1.fs.access(path.join(root, global_1.Global.SFDX_STATE_FOLDER), fs_1.fs.constants.R_OK | fs_1.fs.constants.X_OK | fs_1.fs.constants.W_OK);
+            await fs.promises.access(path.join(root, global_1.Global.SFDX_STATE_FOLDER), fs.constants.R_OK | fs.constants.X_OK | fs.constants.W_OK);
             await cb(null);
         }
         catch (err) {
@@ -426,7 +428,7 @@ class GenericUnixKeychainAccess extends GenericKeychainAccess {
                 await cb(err);
             }
             else {
-                const stats = await fs_1.fs.stat(secretFile);
+                const stats = await fs.promises.stat(secretFile);
                 const octalModeStr = (stats.mode & 0o777).toString(8);
                 const EXPECTED_OCTAL_PERM_VALUE = '600';
                 if (octalModeStr === EXPECTED_OCTAL_PERM_VALUE) {
@@ -451,7 +453,7 @@ class GenericWindowsKeychainAccess extends GenericKeychainAccess {
             }
             else {
                 try {
-                    await fs_1.fs.access(secretFile, fs_1.fs.constants.R_OK | fs_1.fs.constants.W_OK);
+                    await fs.promises.access(secretFile, fs.constants.R_OK | fs.constants.W_OK);
                     await cb(null);
                 }
                 catch (e) {

package/lib/exported.d.ts

@@ -7,7 +7,7 @@ export { DeviceOauthService, DeviceCodeResponse, DeviceCodePollingResponse } fro
 export { OrgUsersConfig } from './config/orgUsersConfig';
 export { ConfigPropertyMeta, ConfigPropertyMetaInput, Config, SfdxPropertyKeys, SFDX_ALLOWED_PROPERTIES, } from './config/config';
 export { ConfigInfo, ConfigAggregator } from './config/configAggregator';
-export { AuthFields, AuthInfo, OrgAuthorization } from './org/authInfo';
+export { AuthFields, AuthInfo, AuthSideEffects, OrgAuthorization } from './org/authInfo';
 export { AuthRemover } from './org/authRemover';
 export { Connection, SFDX_HTTP_HEADERS } from './org/connection';
 export { Mode, Global } from './global';
@@ -16,7 +16,7 @@ export { WebOAuthServer } from './webOAuthServer';
 export { SfdcUrl } from './util/sfdcUrl';
 export { getJwtAudienceUrl } from './util/getJwtAudienceUrl';
 export { Fields, FieldValue, LoggerLevel, LoggerLevelValue, LogLine, LoggerOptions, LoggerStream, Logger, } from './logger';
-export { Messages } from './messages';
+export { Messages, StructuredMessage } from './messages';
 export { Org, SandboxProcessObject, StatusEvent, SandboxEvents, SandboxUserAuthResponse, SandboxUserAuthRequest, SandboxRequest, OrgTypes, ResultEvent, ScratchOrgRequest, } from './org';
 export { OrgConfigProperties, ORG_CONFIG_ALLOWED_PROPERTIES } from './org/orgConfigProperties';
 export { PackageDir, NamedPackageDir, PackageDirDependency, SfProject, SfProjectJson, SfdxProject, SfdxProjectJson, } from './sfProject';
@@ -30,6 +30,5 @@ export { DefaultUserFields, REQUIRED_FIELDS, User, UserFields } from './org/user
 export { PermissionSetAssignment, PermissionSetAssignmentFields } from './org/permissionSetAssignment';
 export { ScratchOrgCreateOptions, ScratchOrgCreateResult, scratchOrgCreate } from './org/scratchOrgCreate';
 export { ScratchOrgInfo } from './org/scratchOrgInfoApi';
-export * from './util/fs';
 export * from './util/sfdc';
 export * from './util/sfdcUrl';

package/lib/exported.js

@@ -99,7 +99,6 @@ Object.defineProperty(exports, "PermissionSetAssignment", { enumerable: true, ge
 var scratchOrgCreate_1 = require("./org/scratchOrgCreate");
 Object.defineProperty(exports, "scratchOrgCreate", { enumerable: true, get: function () { return scratchOrgCreate_1.scratchOrgCreate; } });
 // Utility sub-modules
-__exportStar(require("./util/fs"), exports);
 __exportStar(require("./util/sfdc"), exports);
 __exportStar(require("./util/sfdcUrl"), exports);
 //# sourceMappingURL=exported.js.map

package/lib/global.js

@@ -10,7 +10,7 @@ exports.Global = exports.Mode = void 0;
 const os = require("os");
 const path = require("path");
 const kit_1 = require("@salesforce/kit");
-const fs_1 = require("./util/fs");
+const mkdirp = require("mkdirp");
 /**
  * Represents an environment mode.  Supports `production`, `development`, `demo`, and `test`
  * with the default mode being `production`.
@@ -46,7 +46,7 @@ class Global {
      */
     static async createDir(dirPath) {
         dirPath = dirPath ? path.join(Global.SFDX_DIR, dirPath) : Global.SFDX_DIR;
-        await fs_1.fs.mkdirp(dirPath, fs_1.fs.DEFAULT_USER_DIR_MODE);
+        await mkdirp(dirPath, '700');
     }
 }
 exports.Global = Global;

package/lib/globalInfo/sfdxDataHandler.d.ts

@@ -1,5 +1,5 @@
 import { ConfigFile } from '../config/configFile';
-import { SfOrgs, SfOrg, SfInfo, SfInfoKeys } from './types';
+import { SfInfo, SfInfoKeys, SfOrg, SfOrgs } from './types';
 interface Handler<T extends SfInfoKeys> {
     sfKey: T;
     merge: (sfData: SfInfo) => Promise<Partial<SfInfo>>;

package/lib/globalInfo/sfdxDataHandler.js

@@ -8,10 +8,10 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AliasesHandler = exports.AuthHandler = exports.SfdxDataHandler = void 0;
 const path_1 = require("path");
+const fs = require("fs");
 const kit_1 = require("@salesforce/kit");
 const ts_types_1 = require("@salesforce/ts-types");
 const global_1 = require("../global");
-const fs_1 = require("../util/fs");
 const configFile_1 = require("../config/configFile");
 const globalInfoConfig_1 = require("./globalInfoConfig");
 const types_1 = require("./types");
@@ -141,7 +141,7 @@ class AuthHandler extends BaseHandler {
         return config;
     }
     async listAllAuthFiles() {
-        const globalFiles = await fs_1.fs.readdir(global_1.Global.SFDX_DIR);
+        const globalFiles = await fs.promises.readdir(global_1.Global.SFDX_DIR);
         return globalFiles.filter((file) => file.match(AuthHandler.authFilenameFilterRegEx));
     }
     async listAllAuthorizations() {
@@ -169,7 +169,8 @@ class AliasesHandler extends BaseHandler {
     async migrate() {
         const aliasesFilePath = (0, path_1.join)(global_1.Global.SFDX_DIR, AliasesHandler.SFDX_ALIASES_FILENAME);
         try {
-            const sfdxAliases = (await fs_1.fs.readJson(aliasesFilePath)).orgs;
+            const x = await fs.promises.readFile(aliasesFilePath, 'utf8');
+            const sfdxAliases = (0, kit_1.parseJson)(x).orgs;
             return { [this.sfKey]: { ...sfdxAliases } };
         }
         catch (e) {
@@ -209,7 +210,7 @@ class AliasesHandler extends BaseHandler {
     }
     async write(latest) {
         const aliasesFilePath = (0, path_1.join)(global_1.Global.SFDX_DIR, AliasesHandler.SFDX_ALIASES_FILENAME);
-        fs_1.fs.writeJson(aliasesFilePath, { orgs: latest[types_1.SfInfoKeys.ALIASES] });
+        await fs.promises.writeFile(aliasesFilePath, JSON.stringify({ orgs: latest[types_1.SfInfoKeys.ALIASES] }, null, 2));
     }
 }
 exports.AliasesHandler = AliasesHandler;

package/lib/logger.js

@@ -11,14 +11,16 @@ const events_1 = require("events");
 const os = require("os");
 const path = require("path");
 const stream_1 = require("stream");
+const fs = require("fs");
+// eslint-disable-next-line @typescript-eslint/ban-ts-comment
 // @ts-ignore
 const Bunyan = require("@salesforce/bunyan");
 const kit_1 = require("@salesforce/kit");
 const ts_types_1 = require("@salesforce/ts-types");
 const Debug = require("debug");
+const mkdirp = require("mkdirp");
 const global_1 = require("./global");
 const sfError_1 = require("./sfError");
-const fs_1 = require("./util/fs");
 /**
  * Standard `Logger` levels.
  *
@@ -228,19 +230,19 @@ class Logger {
     async addLogFileStream(logFile) {
         try {
             // Check if we have write access to the log file (i.e., we created it already)
-            await fs_1.fs.access(logFile, fs_1.fs.constants.W_OK);
+            await fs.promises.access(logFile, fs.constants.W_OK);
         }
         catch (err1) {
             try {
-                await fs_1.fs.mkdirp(path.dirname(logFile), {
-                    mode: fs_1.fs.DEFAULT_USER_DIR_MODE,
+                await mkdirp(path.dirname(logFile), {
+                    mode: '700',
                 });
             }
             catch (err2) {
                 // noop; directory exists already
             }
             try {
-                await fs_1.fs.writeFile(logFile, '', { mode: fs_1.fs.DEFAULT_USER_FILE_MODE });
+                await fs.promises.writeFile(logFile, '', { mode: '600' });
             }
             catch (err3) {
                 throw sfError_1.SfError.wrap(err3);
@@ -268,19 +270,19 @@ class Logger {
     addLogFileStreamSync(logFile) {
         try {
             // Check if we have write access to the log file (i.e., we created it already)
-            fs_1.fs.accessSync(logFile, fs_1.fs.constants.W_OK);
+            fs.accessSync(logFile, fs.constants.W_OK);
         }
         catch (err1) {
             try {
-                fs_1.fs.mkdirpSync(path.dirname(logFile), {
-                    mode: fs_1.fs.DEFAULT_USER_DIR_MODE,
+                mkdirp.sync(path.dirname(logFile), {
+                    mode: '700',
                 });
             }
             catch (err2) {
                 // noop; directory exists already
             }
             try {
-                fs_1.fs.writeFileSync(logFile, '', { mode: fs_1.fs.DEFAULT_USER_FILE_MODE });
+                fs.writeFileSync(logFile, '', { mode: '600' });
             }
             catch (err3) {
                 throw sfError_1.SfError.wrap(err3);
@@ -400,7 +402,7 @@ class Logger {
             // eslint-disable-next-line @typescript-eslint/no-explicit-any
             this.bunyan.streams.forEach(async (stream) => {
                 if (stream.type === 'file') {
-                    content += await fs_1.fs.readFile(stream.path, 'utf8');
+                    content += await fs.promises.readFile(stream.path, 'utf8');
                 }
             });
             return content;

package/lib/messages.d.ts

@@ -1,6 +1,11 @@
 import { AnyJson } from '@salesforce/ts-types';
 import { SfError } from './sfError';
 export declare type Tokens = Array<string | boolean | number | null | undefined>;
+export declare type StructuredMessage = {
+    message: string;
+    name: string;
+    actions?: string[];
+};
 /**
  * A loader function to return messages.
  *
@@ -244,9 +249,43 @@ export declare class Messages<T extends string> {
      * @param key The key of the error message.
      * @param tokens The error message tokens.
      * @param actionTokens The action messages tokens.
-     * @param exitCodeOrCause The exit code which will be used by SfdxCommand or he underlying error that caused this error to be raised.
+     * @param exitCodeOrCause The exit code which will be used by SfdxCommand or the underlying error that caused this error to be raised.
      * @param cause The underlying error that caused this error to be raised.
      */
     createError(key: T, tokens?: Tokens, actionTokens?: Tokens, exitCodeOrCause?: number | Error, cause?: Error): SfError;
+    /**
+     * Convenience method to create warning using message labels.
+     *
+     * `warning.name` will be the upper-cased key, remove prefixed `warning.` and will always end in Warning.
+     * `warning.actions` will be loaded using `${key}.actions` if available.
+     *
+     * @param key The key of the warning message.
+     * @param tokens The warning message tokens.
+     * @param actionTokens The action messages tokens.
+     */
+    createWarning(key: T, tokens?: Tokens, actionTokens?: Tokens): StructuredMessage;
+    /**
+     * Convenience method to create info using message labels.
+     *
+     * `info.name` will be the upper-cased key, remove prefixed `info.` and will always end in Info.
+     * `info.actions` will be loaded using `${key}.actions` if available.
+     *
+     * @param key The key of the warning message.
+     * @param tokens The warning message tokens.
+     * @param actionTokens The action messages tokens.
+     */
+    createInfo(key: T, tokens?: Tokens, actionTokens?: Tokens): StructuredMessage;
+    /**
+     * Formats message contents given a message type, key, tokens and actions tokens
+     *
+     * `<type>.name` will be the upper-cased key, remove prefixed `<type>.` and will always end in 'Error | Warning | Info.
+     * `<type>.actions` will be loaded using `${key}.actions` if available.
+     *
+     * @param type The type of the message set must 'error' | 'warning' | 'info'.
+     * @param key The key of the warning message.
+     * @param tokens The warning message tokens.
+     * @param actionTokens The action messages tokens.
+     */
+    private formatMessageContents;
     private getMessageWithMap;
 }

package/lib/messages.js

@@ -438,25 +438,68 @@ class Messages {
      * @param key The key of the error message.
      * @param tokens The error message tokens.
      * @param actionTokens The action messages tokens.
-     * @param exitCodeOrCause The exit code which will be used by SfdxCommand or he underlying error that caused this error to be raised.
+     * @param exitCodeOrCause The exit code which will be used by SfdxCommand or the underlying error that caused this error to be raised.
      * @param cause The underlying error that caused this error to be raised.
      */
     createError(key, tokens = [], actionTokens = [], exitCodeOrCause, cause) {
+        const structuredMessage = this.formatMessageContents('error', key, tokens, actionTokens);
+        return new sfError_1.SfError(structuredMessage.message, structuredMessage.name, structuredMessage.actions, exitCodeOrCause, cause);
+    }
+    /**
+     * Convenience method to create warning using message labels.
+     *
+     * `warning.name` will be the upper-cased key, remove prefixed `warning.` and will always end in Warning.
+     * `warning.actions` will be loaded using `${key}.actions` if available.
+     *
+     * @param key The key of the warning message.
+     * @param tokens The warning message tokens.
+     * @param actionTokens The action messages tokens.
+     */
+    createWarning(key, tokens = [], actionTokens = []) {
+        return this.formatMessageContents('warning', key, tokens, actionTokens);
+    }
+    /**
+     * Convenience method to create info using message labels.
+     *
+     * `info.name` will be the upper-cased key, remove prefixed `info.` and will always end in Info.
+     * `info.actions` will be loaded using `${key}.actions` if available.
+     *
+     * @param key The key of the warning message.
+     * @param tokens The warning message tokens.
+     * @param actionTokens The action messages tokens.
+     */
+    createInfo(key, tokens = [], actionTokens = []) {
+        return this.formatMessageContents('info', key, tokens, actionTokens);
+    }
+    /**
+     * Formats message contents given a message type, key, tokens and actions tokens
+     *
+     * `<type>.name` will be the upper-cased key, remove prefixed `<type>.` and will always end in 'Error | Warning | Info.
+     * `<type>.actions` will be loaded using `${key}.actions` if available.
+     *
+     * @param type The type of the message set must 'error' | 'warning' | 'info'.
+     * @param key The key of the warning message.
+     * @param tokens The warning message tokens.
+     * @param actionTokens The action messages tokens.
+     */
+    formatMessageContents(type, key, tokens = [], actionTokens = []) {
+        const label = (0, kit_1.upperFirst)(type);
+        const labelRegExp = new RegExp(`${label}$`);
+        const searchValue = type === 'error' ? /^error.*\./ : new RegExp(`^${type}.`);
         // Convert key to name:
-        //     'myMessage' -> `MyMessageError`
+        //     'myMessage' -> `MyMessageWarning`
         //     'myMessageError' -> `MyMessageError`
-        //     'error.myMessage' -> `MyMessageError`
-        //     'errors.myMessage' -> `MyMessageError`
-        const errName = `${(0, kit_1.upperFirst)(key.replace(/^errors*\./, ''))}${/Error$/.exec(key) ? '' : 'Error'}`;
-        const errMessage = this.getMessage(key, tokens);
-        let errActions;
+        //     'warning.myMessage' -> `MyMessageWarning`
+        const name = `${(0, kit_1.upperFirst)(key.replace(searchValue, ''))}${labelRegExp.exec(key) ? '' : label}`;
+        const message = this.getMessage(key, tokens);
+        let actions;
         try {
-            errActions = this.getMessageWithMap(`${key}.actions`, actionTokens, this.messages);
+            actions = this.getMessageWithMap(`${key}.actions`, actionTokens, this.messages);
         }
         catch (e) {
             /* just ignore if actions aren't found */
         }
-        return new sfError_1.SfError(errMessage, errName, errActions, exitCodeOrCause, cause);
+        return { message, name, actions };
     }
     getMessageWithMap(key, tokens = [], map) {
         // Allow nested keys for better grouping

package/lib/org/authInfo.d.ts

@@ -59,6 +59,11 @@ export interface AccessTokenOptions {
     loginUrl?: string;
     instanceUrl?: string;
 }
+export declare type AuthSideEffects = {
+    alias: string;
+    setDefault: boolean;
+    setDefaultDevHub: boolean;
+};
 /**
  * A function to update a refresh token when the access token is expired.
  */
@@ -225,6 +230,14 @@ export declare class AuthInfo extends AsyncOptionalCreatable<AuthInfo.Options> {
      * **See** [SFDX Authorization](https://developer.salesforce.com/docs/atlas.en-us.sfdx_cli_reference.meta/sfdx_cli_reference/cli_reference_force_auth.htm#cli_reference_force_auth)
      */
     getSfdxAuthUrl(): string;
+    /**
+     * Convenience function to handle typical side effects encountered when dealing with an AuthInfo.
+     * Given the values supplied in parameter sideEffects, this functions will set auth alias, default auth
+     * and default dev hub.
+     *
+     * @param sideEffects - instance of AuthSideEffects
+     */
+    handleAliasAndDefaultSettings(sideEffects: AuthSideEffects): Promise<void>;
     /**
      * Set the target-env (default) or the target-dev-hub to the alias if
      * it exists otherwise to the username. Method will try to set the local