@salesforce/core 3.7.1 → 3.7.5

package/lib/crypto/crypto.js

@@ -25,7 +25,7 @@ const AUTH_TAG_LENGTH = 32;
 const ENCRYPTED_CHARS = /[a-f0-9]/;
 const KEY_NAME = 'sfdx';
 const ACCOUNT = 'local';
-messages_1.Messages.importMessagesDirectory(path_1.join(__dirname));
+messages_1.Messages.importMessagesDirectory((0, path_1.join)(__dirname));
 const messages = messages_1.Messages.load('@salesforce/core', 'encryption', [
     'keychainPasswordCreationError',
     'invalidEncryptedFormatError',
@@ -34,7 +34,7 @@ const messages = messages_1.Messages.load('@salesforce/core', 'encryption', [
 ]);
 const makeSecureBuffer = (password) => {
     const newSb = new secureBuffer_1.SecureBuffer();
-    newSb.consume(Buffer.from(ts_types_1.ensure(password), 'utf8'));
+    newSb.consume(Buffer.from((0, ts_types_1.ensure)(password), 'utf8'));
     return newSb;
 };
 /**
@@ -56,7 +56,7 @@ const keychainPromises = {
                     if (err)
                         return reject(err);
                     cache_1.Cache.set(`${service}:${account}`, makeSecureBuffer(password));
-                    return resolve({ username: account, password: ts_types_1.ensure(password) });
+                    return resolve({ username: account, password: (0, ts_types_1.ensure)(password) });
                 });
             });
         }
@@ -64,7 +64,7 @@ const keychainPromises = {
             const pw = sb.value((buffer) => buffer.toString('utf8'));
             cache_1.Cache.set(`${service}:${account}`, makeSecureBuffer(pw));
             return new Promise((resolve) => {
-                return resolve({ username: account, password: ts_types_1.ensure(pw) });
+                return resolve({ username: account, password: (0, ts_types_1.ensure)(pw) });
             });
         }
     },
@@ -203,7 +203,7 @@ class Crypto extends kit_1.AsyncOptionalCreatable {
                 }
                 const key = crypto.randomBytes(Math.ceil(16)).toString('hex');
                 // Create a new password in the KeyChain.
-                await keychainPromises.setPassword(ts_types_1.ensure(this.options.keychain), KEY_NAME, ACCOUNT, key);
+                await keychainPromises.setPassword((0, ts_types_1.ensure)(this.options.keychain), KEY_NAME, ACCOUNT, key);
                 return this.init();
             }
             else {
@@ -213,7 +213,7 @@ class Crypto extends kit_1.AsyncOptionalCreatable {
     }
     async getKeyChain(platform) {
         if (!this.options.keychain) {
-            this.options.keychain = await keyChain_1.retrieveKeychain(platform);
+            this.options.keychain = await (0, keyChain_1.retrieveKeychain)(platform);
         }
         return this.options.keychain;
     }

package/lib/crypto/keyChainImpl.js

@@ -135,6 +135,7 @@ class KeychainAccess {
                 return await this.osImpl.onGetCommandClose(code, stdout, stderr, opts, fn);
             }
             catch (e) {
+                // @ts-ignore
                 if (e.retry) {
                     if (retryCount >= GET_PASSWORD_RETRY_COUNT) {
                         throw messages.createError('passwordRetryError', [GET_PASSWORD_RETRY_COUNT]);
@@ -315,7 +316,7 @@ const _darwinImpl = {
         }
     },
 };
-const secretFile = path.join(os_1.homedir(), global_1.Global.SFDX_STATE_FOLDER, 'key.json');
+const secretFile = path.join((0, os_1.homedir)(), global_1.Global.SFDX_STATE_FOLDER, 'key.json');
 var SecretField;
 (function (SecretField) {
     SecretField["SERVICE"] = "service";
@@ -341,9 +342,9 @@ async function _readFile() {
     // The file and access is validated before this method is called
     const fileContents = await fs_1.fs.readJsonMap(secretFile);
     return {
-        account: ts_types_1.ensureString(fileContents[SecretField.ACCOUNT]),
-        password: ts_types_1.asString(fileContents[SecretField.KEY]),
-        service: ts_types_1.ensureString(fileContents[SecretField.SERVICE]),
+        account: (0, ts_types_1.ensureString)(fileContents[SecretField.ACCOUNT]),
+        password: (0, ts_types_1.asString)(fileContents[SecretField.KEY]),
+        service: (0, ts_types_1.ensureString)(fileContents[SecretField.SERVICE]),
     };
 }
 // istanbul ignore next - getPassword/setPassword is always mocked out
@@ -405,7 +406,7 @@ class GenericKeychainAccess {
     }
     async isValidFileAccess(cb) {
         try {
-            const root = os_1.homedir();
+            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 cb(null);
         }

package/lib/crypto/secureBuffer.js

@@ -40,7 +40,7 @@ class SecureBuffer {
     value(cb) {
         if (cb) {
             const cipher = crypto.createDecipheriv(cipherName, this.key, this.iv);
-            const a = cipher.update(ts_types_1.ensure(this.secret));
+            const a = cipher.update((0, ts_types_1.ensure)(this.secret));
             const b = cipher.final();
             const c = Buffer.concat([a, b]);
             try {

package/lib/deviceOauthService.js

@@ -27,7 +27,7 @@ async function wait(ms = 1000) {
 }
 async function makeRequest(options) {
     const rawResponse = await new transport_1.default().httpRequest(options);
-    const response = kit_1.parseJsonMap(rawResponse.body);
+    const response = (0, kit_1.parseJsonMap)(rawResponse.body);
     if (response.error) {
         const err = new sfdxError_1.SfdxError('Request Failed.');
         err.data = Object.assign(response, { status: rawResponse.statusCode });
@@ -109,7 +109,7 @@ class DeviceOauthService extends kit_1.AsyncCreatable {
     }
     getLoginOptions(url) {
         const body = new url_1.URLSearchParams();
-        body.append('client_id', ts_types_1.ensureString(this.options.clientId));
+        body.append('client_id', (0, ts_types_1.ensureString)(this.options.clientId));
         body.append('response_type', DeviceOauthService.RESPONSE_TYPE);
         body.append('scope', DeviceOauthService.SCOPE);
         return {
@@ -121,7 +121,7 @@ class DeviceOauthService extends kit_1.AsyncCreatable {
     }
     getPollingOptions(url, code) {
         const body = new url_1.URLSearchParams();
-        body.append('client_id', ts_types_1.ensureString(this.options.clientId));
+        body.append('client_id', (0, ts_types_1.ensureString)(this.options.clientId));
         body.append('grant_type', DeviceOauthService.GRANT_TYPE);
         body.append('code', code);
         return {
@@ -132,7 +132,7 @@ class DeviceOauthService extends kit_1.AsyncCreatable {
         };
     }
     getDeviceFlowRequestUrl() {
-        return `${ts_types_1.ensureString(this.options.loginUrl)}/services/oauth2/token`;
+        return `${(0, ts_types_1.ensureString)(this.options.loginUrl)}/services/oauth2/token`;
     }
     async poll(httpRequest) {
         this.logger.debug(`polling for device approval (attempt ${this.pollingCount} of ${DeviceOauthService.POLLING_COUNT_MAX})`);
@@ -140,6 +140,7 @@ class DeviceOauthService extends kit_1.AsyncCreatable {
             return await makeRequest(httpRequest);
         }
         catch (e) {
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
             const err = e.data;
             if (err.error && err.status === 400 && err.error === 'authorization_pending') {
                 // do nothing because we're still waiting

package/lib/exported.d.ts

@@ -1,6 +1,6 @@
 export { OAuth2Config } from 'jsforce';
 export { ConfigFile } from './config/configFile';
-export { EnvironmentVariable, SUPPORTED_ENV_VARS } from './config/envVars';
+export { envVars, EnvironmentVariable, SUPPORTED_ENV_VARS, EnvVars } from './config/envVars';
 export { BaseConfigStore, ConfigContents, ConfigEntry, ConfigStore, ConfigValue } from './config/configStore';
 export { GlobalInfo, SfEntry, SfInfo, SfInfoKeys, SfOrg, SfOrgs, SfToken, SfTokens } from './globalInfo';
 export { DeviceOauthService, DeviceCodeResponse, DeviceCodePollingResponse } from './deviceOauthService';
@@ -17,7 +17,7 @@ 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 { Org } from './org/org';
+export { Org, SandboxProcessObject, StatusEvent, SandboxEvents, SandboxUserAuthResponse, SandboxUserAuthRequest, SandboxRequest, OrgTypes, ResultEvent, } from './org';
 export { OrgConfigProperties, ORG_CONFIG_ALLOWED_PROPERTIES } from './org/orgConfigProperties';
 export { PackageDir, NamedPackageDir, PackageDirDependency, SfdxProject, SfdxProjectJson } from './sfdxProject';
 export { SchemaPrinter } from './schema/printer';

package/lib/exported.js

@@ -16,14 +16,16 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.PermissionSetAssignment = exports.User = exports.REQUIRED_FIELDS = exports.DefaultUserFields = exports.MyDomainResolver = exports.StreamingClient = exports.CometClient = exports.PollingClient = exports.SfdxError = exports.SchemaValidator = exports.SchemaPrinter = exports.SfdxProjectJson = exports.SfdxProject = exports.ORG_CONFIG_ALLOWED_PROPERTIES = exports.OrgConfigProperties = exports.Org = exports.Messages = exports.Logger = exports.LoggerLevel = exports.getJwtAudienceUrl = exports.SfdcUrl = exports.WebOAuthServer = exports.Lifecycle = exports.Global = exports.Mode = exports.SFDX_HTTP_HEADERS = exports.Connection = exports.AuthRemover = exports.AuthInfo = exports.ConfigAggregator = exports.SFDX_ALLOWED_PROPERTIES = exports.SfdxPropertyKeys = exports.Config = exports.OrgUsersConfig = exports.DeviceOauthService = exports.SfInfoKeys = exports.GlobalInfo = exports.BaseConfigStore = exports.SUPPORTED_ENV_VARS = exports.EnvironmentVariable = exports.ConfigFile = void 0;
+exports.PermissionSetAssignment = exports.User = exports.REQUIRED_FIELDS = exports.DefaultUserFields = exports.MyDomainResolver = exports.StreamingClient = exports.CometClient = exports.PollingClient = exports.SfdxError = exports.SchemaValidator = exports.SchemaPrinter = exports.SfdxProjectJson = exports.SfdxProject = exports.ORG_CONFIG_ALLOWED_PROPERTIES = exports.OrgConfigProperties = exports.OrgTypes = exports.SandboxEvents = exports.Org = exports.Messages = exports.Logger = exports.LoggerLevel = exports.getJwtAudienceUrl = exports.SfdcUrl = exports.WebOAuthServer = exports.Lifecycle = exports.Global = exports.Mode = exports.SFDX_HTTP_HEADERS = exports.Connection = exports.AuthRemover = exports.AuthInfo = exports.ConfigAggregator = exports.SFDX_ALLOWED_PROPERTIES = exports.SfdxPropertyKeys = exports.Config = exports.OrgUsersConfig = exports.DeviceOauthService = exports.SfInfoKeys = exports.GlobalInfo = exports.BaseConfigStore = exports.EnvVars = exports.SUPPORTED_ENV_VARS = exports.EnvironmentVariable = exports.envVars = exports.ConfigFile = void 0;
 const messages_1 = require("./messages");
 messages_1.Messages.importMessagesDirectory(__dirname);
 var configFile_1 = require("./config/configFile");
 Object.defineProperty(exports, "ConfigFile", { enumerable: true, get: function () { return configFile_1.ConfigFile; } });
 var envVars_1 = require("./config/envVars");
+Object.defineProperty(exports, "envVars", { enumerable: true, get: function () { return envVars_1.envVars; } });
 Object.defineProperty(exports, "EnvironmentVariable", { enumerable: true, get: function () { return envVars_1.EnvironmentVariable; } });
 Object.defineProperty(exports, "SUPPORTED_ENV_VARS", { enumerable: true, get: function () { return envVars_1.SUPPORTED_ENV_VARS; } });
+Object.defineProperty(exports, "EnvVars", { enumerable: true, get: function () { return envVars_1.EnvVars; } });
 var configStore_1 = require("./config/configStore");
 Object.defineProperty(exports, "BaseConfigStore", { enumerable: true, get: function () { return configStore_1.BaseConfigStore; } });
 var globalInfo_1 = require("./globalInfo");
@@ -62,8 +64,10 @@ Object.defineProperty(exports, "LoggerLevel", { enumerable: true, get: function
 Object.defineProperty(exports, "Logger", { enumerable: true, get: function () { return logger_1.Logger; } });
 var messages_2 = require("./messages");
 Object.defineProperty(exports, "Messages", { enumerable: true, get: function () { return messages_2.Messages; } });
-var org_1 = require("./org/org");
+var org_1 = require("./org");
 Object.defineProperty(exports, "Org", { enumerable: true, get: function () { return org_1.Org; } });
+Object.defineProperty(exports, "SandboxEvents", { enumerable: true, get: function () { return org_1.SandboxEvents; } });
+Object.defineProperty(exports, "OrgTypes", { enumerable: true, get: function () { return org_1.OrgTypes; } });
 var orgConfigProperties_1 = require("./org/orgConfigProperties");
 Object.defineProperty(exports, "OrgConfigProperties", { enumerable: true, get: function () { return orgConfigProperties_1.OrgConfigProperties; } });
 Object.defineProperty(exports, "ORG_CONFIG_ALLOWED_PROPERTIES", { enumerable: true, get: function () { return orgConfigProperties_1.ORG_CONFIG_ALLOWED_PROPERTIES; } });

package/lib/globalInfo/globalInfoConfig.js

@@ -65,7 +65,7 @@ class GlobalInfo extends configFile_1.ConfigFile {
         return new aliasAccessor_1.AliasAccessor(this);
     }
     set(key, value) {
-        if (ts_types_1.isPlainObject(value)) {
+        if ((0, ts_types_1.isPlainObject)(value)) {
             value = this.timestamp(value);
         }
         super.set(key, value);

package/lib/globalInfo/sfdxDataHandler.js

@@ -37,7 +37,7 @@ class SfdxDataHandler {
         }
     }
     async merge(sfData = globalInfoConfig_1.GlobalInfo.emptyDataModel) {
-        let merged = globalInfoConfig_1.deepCopy(sfData);
+        let merged = (0, globalInfoConfig_1.deepCopy)(sfData);
         for (const handler of this.handlers) {
             merged = Object.assign(merged, await handler.merge(merged));
         }
@@ -45,7 +45,7 @@ class SfdxDataHandler {
         return merged;
     }
     setOriginal(data) {
-        this.original = globalInfoConfig_1.deepCopy(data);
+        this.original = (0, globalInfoConfig_1.deepCopy)(data);
     }
 }
 exports.SfdxDataHandler = SfdxDataHandler;
@@ -53,7 +53,7 @@ class BaseHandler {
     async merge(sfData = globalInfoConfig_1.GlobalInfo.emptyDataModel) {
         var _a, _b;
         const sfdxData = await this.migrate();
-        const merged = globalInfoConfig_1.deepCopy(sfData);
+        const merged = (0, globalInfoConfig_1.deepCopy)(sfData);
         // Only merge the key this handler is responsible for.
         const key = this.sfKey;
         const sfKeys = Object.keys((_a = sfData[key]) !== null && _a !== void 0 ? _a : {});
@@ -61,11 +61,11 @@ class BaseHandler {
         const commonKeys = sfKeys.filter((k) => sfdxKeys.includes(k));
         for (const k of commonKeys) {
             const [newer, older] = [sfData[key][k], sfdxData[key][k]].sort((a, b) => {
-                if (ts_types_1.isPlainObject(a) && ts_types_1.isPlainObject(b))
+                if ((0, ts_types_1.isPlainObject)(a) && (0, ts_types_1.isPlainObject)(b))
                     return new Date(a.timestamp) < new Date(b.timestamp) ? 1 : -1;
                 return 0;
             });
-            kit_1.set(merged, `${key}["${k}"]`, Object.assign({}, older, newer));
+            (0, kit_1.set)(merged, `${key}["${k}"]`, Object.assign({}, older, newer));
         }
         // Keys that exist in .sfdx but not .sf are added becase we assume
         // that this means the key was created using sfdx.
@@ -78,7 +78,7 @@ class BaseHandler {
         // assume that we should migrate any keys that exist in in .sfdx
         const unhandledSfdxKeys = sfdxKeys.filter((k) => !sfKeys.includes(k));
         for (const k of unhandledSfdxKeys) {
-            kit_1.set(merged, `${key}["${k}"]`, sfdxData[key][k]);
+            (0, kit_1.set)(merged, `${key}["${k}"]`, sfdxData[key][k]);
         }
         // Keys that exist in .sf but not .sfdx are deleted because we assume
         // that this means the key was deleted while using sfdx.
@@ -98,7 +98,7 @@ class AuthHandler extends BaseHandler {
     }
     async migrate() {
         const oldAuths = await this.listAllAuthorizations();
-        const newAuths = oldAuths.reduce((x, y) => Object.assign(x, { [ts_types_1.ensureString(y.username)]: y }), {});
+        const newAuths = oldAuths.reduce((x, y) => Object.assign(x, { [(0, ts_types_1.ensureString)(y.username)]: y }), {});
         return { [this.sfKey]: newAuths };
     }
     async write(latest, original) {
@@ -148,7 +148,7 @@ class AuthHandler extends BaseHandler {
         const filenames = await this.listAllAuthFiles();
         const auths = [];
         for (const filename of filenames) {
-            const username = path_1.basename(filename, path_1.extname(filename));
+            const username = (0, path_1.basename)(filename, (0, path_1.extname)(filename));
             const configFile = await this.createAuthFileConfig(username);
             const contents = configFile.getContents();
             const stat = await configFile.stat();
@@ -167,7 +167,7 @@ class AliasesHandler extends BaseHandler {
         this.sfKey = types_1.SfInfoKeys.ALIASES;
     }
     async migrate() {
-        const aliasesFilePath = path_1.join(global_1.Global.SFDX_DIR, AliasesHandler.SFDX_ALIASES_FILENAME);
+        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;
             return { [this.sfKey]: { ...sfdxAliases } };
@@ -179,7 +179,7 @@ class AliasesHandler extends BaseHandler {
     // AliasesHandler implements its own merge method because the structure of aliases is flat instead of nested by SfInfoKey types.
     async merge(sfData = globalInfoConfig_1.GlobalInfo.emptyDataModel) {
         const sfdxAliases = (await this.migrate())[types_1.SfInfoKeys.ALIASES];
-        const merged = globalInfoConfig_1.deepCopy(sfData);
+        const merged = (0, globalInfoConfig_1.deepCopy)(sfData);
         /* Overwrite `sf` aliases with `sfdx` aliases
          *  `sf` will always modify `sfdx` files but `sfdx` won't modify `sf` files
          *  because of this we can assume that any changes in `sfdx` files that aren't
@@ -208,7 +208,7 @@ class AliasesHandler extends BaseHandler {
         return merged;
     }
     async write(latest) {
-        const aliasesFilePath = path_1.join(global_1.Global.SFDX_DIR, AliasesHandler.SFDX_ALIASES_FILENAME);
+        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] });
     }
 }

package/lib/lifecycleEvents.d.ts

@@ -16,16 +16,29 @@ declare type callback = (data: any) => Promise<void>;
  *
  * // Deep in the deploy code, fire the event for all libraries and plugins to hear.
  * Lifecycle.getInstance().emit('deploy-metadata', metadataToBeDeployed);
+ *
+ * // if you don't need to await anything
+ * use `void Lifecycle.getInstance().emit('deploy-metadata', metadataToBeDeployed)` ;
  * ```
  */
 export declare class Lifecycle {
-    private debug;
     private readonly listeners;
+    static readonly telemetryEventName = "telemetry";
+    static readonly warningEventName = "warning";
+    private debug;
     private constructor();
+    /**
+     * return the package.json version of the sfdx-core library.
+     */
+    static staticVersion(): string;
     /**
      * Retrieve the singleton instance of this class so that all listeners and emitters can interact from any library or tool
      */
     static getInstance(): Lifecycle;
+    /**
+     * return the package.json version of the sfdx-core library.
+     */
+    version(): string;
     /**
      * Remove all listeners for a given event
      *
@@ -38,6 +51,18 @@ export declare class Lifecycle {
      * @param eventName The name of the event to get listeners of
      */
     getListeners(eventName: string): callback[];
+    /**
+     * Create a listener for the `telemetry` event
+     *
+     * @param cb The callback function to run when the event is emitted
+     */
+    onTelemetry(cb: (data: Record<string, unknown>) => Promise<void>): void;
+    /**
+     * Create a listener for the `warning` event
+     *
+     * @param cb The callback function to run when the event is emitted
+     */
+    onWarning(cb: (warning: string) => Promise<void>): void;
     /**
      * Create a new listener for a given event
      *
@@ -45,6 +70,18 @@ export declare class Lifecycle {
      * @param cb The callback function to run when the event is emitted
      */
     on<T = AnyJson>(eventName: string, cb: (data: T) => Promise<void>): void;
+    /**
+     * Emit a `telemetry` event, causing all callback functions to be run in the order they were registered
+     *
+     * @param data The data to emit
+     */
+    emitTelemetry(data: AnyJson): Promise<void>;
+    /**
+     * Emit a `warning` event, causing all callback functions to be run in the order they were registered
+     *
+     * @param data The warning (string) to emit
+     */
+    emitWarning(warning: string): Promise<void>;
     /**
      * Emit a given event, causing all callback functions to be run in the order they were registered
      *

package/lib/lifecycleEvents.js

@@ -8,6 +8,10 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Lifecycle = void 0;
 const Debug = require("debug");
+const semver_1 = require("semver");
+// needed for TS to not put everything inside /lib/src
+// @ts-ignore
+const pjson = require("../package.json");
 /**
  * An asynchronous event listener and emitter that follows the singleton pattern. The singleton pattern allows lifecycle
  * events to be emitted from deep within a library and still be consumed by any other library or tool. It allows other
@@ -24,12 +28,21 @@ const Debug = require("debug");
  *
  * // Deep in the deploy code, fire the event for all libraries and plugins to hear.
  * Lifecycle.getInstance().emit('deploy-metadata', metadataToBeDeployed);
+ *
+ * // if you don't need to await anything
+ * use `void Lifecycle.getInstance().emit('deploy-metadata', metadataToBeDeployed)` ;
  * ```
  */
 class Lifecycle {
-    constructor() {
+    constructor(listeners = {}) {
+        this.listeners = listeners;
         this.debug = Debug(`sfdx:${this.constructor.name}`);
-        this.listeners = {};
+    }
+    /**
+     * return the package.json version of the sfdx-core library.
+     */
+    static staticVersion() {
+        return pjson.version;
     }
     /**
      * Retrieve the singleton instance of this class so that all listeners and emitters can interact from any library or tool
@@ -52,10 +65,29 @@ class Lifecycle {
         //
         // Nothing should EVER be removed, even across major versions.
         if (!global.salesforceCoreLifecycle) {
+            // it's not been loaded yet (basic singleton pattern)
             global.salesforceCoreLifecycle = new Lifecycle();
         }
+        else if (
+        // an older version was loaded that should be replaced
+        (0, semver_1.compare)(global.salesforceCoreLifecycle.version(), Lifecycle.staticVersion()) === -1) {
+            const oldInstance = global.salesforceCoreLifecycle;
+            // use the newer version and transfer any listeners from the old version
+            // object spread keeps them from being references
+            global.salesforceCoreLifecycle = new Lifecycle({ ...oldInstance.listeners });
+            // clean up any listeners on the old version
+            Object.keys(oldInstance.listeners).map((eventName) => {
+                oldInstance.removeAllListeners(eventName);
+            });
+        }
         return global.salesforceCoreLifecycle;
     }
+    /**
+     * return the package.json version of the sfdx-core library.
+     */
+    version() {
+        return pjson.version;
+    }
     /**
      * Remove all listeners for a given event
      *
@@ -79,6 +111,22 @@ class Lifecycle {
             return [];
         }
     }
+    /**
+     * Create a listener for the `telemetry` event
+     *
+     * @param cb The callback function to run when the event is emitted
+     */
+    onTelemetry(cb) {
+        this.on(Lifecycle.telemetryEventName, cb);
+    }
+    /**
+     * Create a listener for the `warning` event
+     *
+     * @param cb The callback function to run when the event is emitted
+     */
+    onWarning(cb) {
+        this.on(Lifecycle.warningEventName, cb);
+    }
     /**
      * Create a new listener for a given event
      *
@@ -93,6 +141,27 @@ class Lifecycle {
         listeners.push(cb);
         this.listeners[eventName] = listeners;
     }
+    /**
+     * Emit a `telemetry` event, causing all callback functions to be run in the order they were registered
+     *
+     * @param data The data to emit
+     */
+    async emitTelemetry(data) {
+        return this.emit(Lifecycle.telemetryEventName, data);
+    }
+    /**
+     * Emit a `warning` event, causing all callback functions to be run in the order they were registered
+     *
+     * @param data The warning (string) to emit
+     */
+    async emitWarning(warning) {
+        // if there are no listeners, warnings should go to the node process so they're not lost
+        // this also preserves behavior in UT where there's a spy on process.emitWarning
+        if (this.getListeners(Lifecycle.warningEventName).length === 0) {
+            process.emitWarning(warning);
+        }
+        return this.emit(Lifecycle.warningEventName, warning);
+    }
     /**
      * Emit a given event, causing all callback functions to be run in the order they were registered
      *
@@ -112,4 +181,6 @@ class Lifecycle {
     }
 }
 exports.Lifecycle = Lifecycle;
+Lifecycle.telemetryEventName = 'telemetry';
+Lifecycle.warningEventName = 'warning';
 //# sourceMappingURL=lifecycleEvents.js.map

package/lib/logger.js

@@ -204,7 +204,7 @@ class Logger {
      */
     static getLevelByName(levelName) {
         levelName = levelName.toUpperCase();
-        if (!ts_types_1.isKeyOf(LoggerLevel, levelName)) {
+        if (!(0, ts_types_1.isKeyOf)(LoggerLevel, levelName)) {
             throw new sfdxError_1.SfdxError(`Invalid log level "${levelName}".`, 'UnrecognizedLoggerLevelNameError');
         }
         return LoggerLevel[levelName];
@@ -344,6 +344,7 @@ class Logger {
     /**
      * Gets the underlying Bunyan logger.
      */
+    // eslint-disable-next-line @typescript-eslint/explicit-module-boundary-types
     getBunyanLogger() {
         return this.bunyan;
     }
@@ -433,7 +434,7 @@ class Logger {
                     }
                     // close file streams, flush buffer to disk
                     // eslint-disable-next-line @typescript-eslint/unbound-method
-                    if (entry.type === 'file' && entry.stream && ts_types_1.isFunction(entry.stream.end)) {
+                    if (entry.type === 'file' && entry.stream && (0, ts_types_1.isFunction)(entry.stream.end)) {
                         entry.stream.end();
                     }
                 });
@@ -500,7 +501,7 @@ class Logger {
     debugCallback(cb) {
         if (this.getLevel() === LoggerLevel.DEBUG || process.env.DEBUG) {
             const result = cb();
-            if (ts_types_1.isArray(result)) {
+            if ((0, ts_types_1.isArray)(result)) {
                 this.bunyan.debug(this.applyFilters(LoggerLevel.DEBUG, ...result));
             }
             else {
@@ -561,18 +562,18 @@ class Logger {
                 stream: new stream_1.Writable({
                     write: (chunk, encoding, next) => {
                         try {
-                            const json = kit_1.parseJsonMap(chunk.toString());
-                            const logLevel = ts_types_1.ensureNumber(json.level);
+                            const json = (0, kit_1.parseJsonMap)(chunk.toString());
+                            const logLevel = (0, ts_types_1.ensureNumber)(json.level);
                             if (this.getLevel() <= logLevel) {
                                 let debuggerName = 'core';
-                                if (ts_types_1.isString(json.log)) {
+                                if ((0, ts_types_1.isString)(json.log)) {
                                     debuggerName = json.log;
                                     if (!debuggers[debuggerName]) {
                                         debuggers[debuggerName] = Debug(`${this.getName()}:${debuggerName}`);
                                     }
                                 }
                                 const level = LoggerLevel[logLevel];
-                                ts_types_1.ensure(debuggers[debuggerName])(`${level} ${json.msg}`);
+                                (0, ts_types_1.ensure)(debuggers[debuggerName])(`${level} ${json.msg}`);
                             }
                         }
                         catch (err) {
@@ -664,7 +665,7 @@ const FILTERED_KEYS = [
 // SFDX code and plugins should never show tokens or connect app information in the logs
 const _filter = (...args) => {
     return args.map((arg) => {
-        if (ts_types_1.isArray(arg)) {
+        if ((0, ts_types_1.isArray)(arg)) {
             return _filter(...arg);
         }
         if (arg) {
@@ -673,10 +674,10 @@ const _filter = (...args) => {
             if (arg instanceof Buffer) {
                 _arg = '<Buffer>';
             }
-            else if (ts_types_1.isObject(arg)) {
+            else if ((0, ts_types_1.isObject)(arg)) {
                 _arg = JSON.stringify(arg);
             }
-            else if (ts_types_1.isString(arg)) {
+            else if ((0, ts_types_1.isString)(arg)) {
                 _arg = arg;
             }
             else {
@@ -687,7 +688,7 @@ const _filter = (...args) => {
                 let expElement = key;
                 let expName = key;
                 // Filtered keys can be strings or objects containing regular expression components.
-                if (ts_types_1.isPlainObject(key)) {
+                if ((0, ts_types_1.isPlainObject)(key)) {
                     expElement = key.regex;
                     expName = key.name;
                 }
@@ -701,7 +702,7 @@ const _filter = (...args) => {
             });
             _arg = _arg.replace(/(00D\w{12,15})![.\w]*/, `<${HIDDEN}>`);
             // return an object if an object was logged; otherwise return the filtered string.
-            return ts_types_1.isObject(arg) ? kit_1.parseJson(_arg) : _arg;
+            return (0, ts_types_1.isObject)(arg) ? (0, kit_1.parseJson)(_arg) : _arg;
         }
         else {
             return arg;

package/lib/messages.js

@@ -67,16 +67,17 @@ const jsAndJsonLoader = (filePath, fileContents) => {
     let json;
     try {
         json = JSON.parse(fileContents);
-        if (!ts_types_1.isObject(json)) {
+        if (!(0, ts_types_1.isObject)(json)) {
             // Bubble up
             throw new Error(`Unexpected token. Found returned content type '${typeof json}'.`);
         }
     }
     catch (err) {
         // Provide a nicer error message for a common JSON parse error; Unexpected token
-        if (err.message.startsWith('Unexpected token')) {
-            const parseError = new Error(`Invalid JSON content in message file: ${filePath}\n${err.message}`);
-            parseError.name = err.name;
+        const error = err;
+        if (error.message.startsWith('Unexpected token')) {
+            const parseError = new Error(`Invalid JSON content in message file: ${filePath}\n${error.message}`);
+            parseError.name = error.name;
             throw parseError;
         }
         throw err;
@@ -275,7 +276,7 @@ class Messages {
         if (!packageName) {
             const errMessage = `Invalid or missing package.json file at '${moduleMessagesDirPath}'. If not using a package.json, pass in a packageName.`;
             try {
-                packageName = ts_types_1.asString(ts_types_1.ensureJsonMap(Messages.readFile(path.join(moduleMessagesDirPath, 'package.json'))).name);
+                packageName = (0, ts_types_1.asString)((0, ts_types_1.ensureJsonMap)(Messages.readFile(path.join(moduleMessagesDirPath, 'package.json'))).name);
                 if (!packageName) {
                     throw new kit_1.NamedError('MissingPackageName', errMessage);
                 }
@@ -446,7 +447,7 @@ class Messages {
         //     'myMessageError' -> `MyMessageError`
         //     'error.myMessage' -> `MyMessageError`
         //     'errors.myMessage' -> `MyMessageError`
-        const errName = `${kit_1.upperFirst(key.replace(/^errors*\./, ''))}${/Error$/.exec(key) ? '' : 'Error'}`;
+        const errName = `${(0, kit_1.upperFirst)(key.replace(/^errors*\./, ''))}${/Error$/.exec(key) ? '' : 'Error'}`;
         const errMessage = this.getMessage(key, tokens);
         let errActions;
         try {
@@ -464,7 +465,7 @@ class Messages {
             const parentKey = group[1];
             const childKey = group[2];
             const childObject = map.get(parentKey);
-            if (childObject && ts_types_1.isJsonMap(childObject)) {
+            if (childObject && (0, ts_types_1.isJsonMap)(childObject)) {
                 const childMap = new Map(Object.entries(childObject));
                 return this.getMessageWithMap(childKey, tokens, childMap);
             }
@@ -474,9 +475,9 @@ class Messages {
             throw new kit_1.NamedError('MissingMessageError', `Missing message ${this.bundleName}:${key} for locale ${Messages.getLocale()}.`);
         }
         const msg = map.get(key);
-        const messages = (ts_types_1.isArray(msg) ? msg : [msg]);
+        const messages = ((0, ts_types_1.isArray)(msg) ? msg : [msg]);
         return messages.map((message) => {
-            ts_types_1.ensureString(message);
+            (0, ts_types_1.ensureString)(message);
             return util.format(message, ...tokens);
         });
     }