@salesforce/core 4.3.11 → 5.0.1-v5-beta.0

package/lib/config/config.js

@@ -12,7 +12,7 @@ const fs = require("fs");
 const kit_1 = require("@salesforce/kit");
 const ts_types_1 = require("@salesforce/ts-types");
 const global_1 = require("../global");
-const logger_1 = require("../logger");
+const logger_1 = require("../logger/logger");
 const messages_1 = require("../messages");
 const sfdc_1 = require("../util/sfdc");
 const sfdcUrl_1 = require("../util/sfdcUrl");

package/lib/config/configFile.d.ts

@@ -1,6 +1,6 @@
 /// <reference types="node" />
 import { Stats as fsStats } from 'fs';
-import { Logger } from '../logger';
+import { Logger } from '../logger/logger';
 import { BaseConfigStore, ConfigContents } from './configStore';
 /**
  * Represents a json config file used to manage settings and state. Global config

package/lib/config/configFile.js

@@ -14,7 +14,7 @@ const path_1 = require("path");
 const ts_types_1 = require("@salesforce/ts-types");
 const kit_1 = require("@salesforce/kit");
 const global_1 = require("../global");
-const logger_1 = require("../logger");
+const logger_1 = require("../logger/logger");
 const sfError_1 = require("../sfError");
 const internal_1 = require("../util/internal");
 const configStore_1 = require("./configStore");

package/lib/crypto/crypto.js

@@ -13,7 +13,7 @@ const os = require("os");
 const path_1 = require("path");
 const ts_types_1 = require("@salesforce/ts-types");
 const kit_1 = require("@salesforce/kit");
-const logger_1 = require("../logger");
+const logger_1 = require("../logger/logger");
 const messages_1 = require("../messages");
 const cache_1 = require("../util/cache");
 const global_1 = require("../global");

package/lib/crypto/keyChain.js

@@ -8,7 +8,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.retrieveKeychain = void 0;
 const kit_1 = require("@salesforce/kit");
-const logger_1 = require("../logger");
+const logger_1 = require("../logger/logger");
 const messages_1 = require("../messages");
 const keyChainImpl_1 = require("./keyChainImpl");
 const messages = new messages_1.Messages('@salesforce/core', 'encryption', new Map([["invalidEncryptedFormatError", "The encrypted data is not properly formatted."], ["invalidEncryptedFormatError.actions", ["If attempting to create a scratch org then re-authorize. Otherwise create a new scratch org."]], ["authDecryptError", "Failed to decipher auth data. reason: %s."], ["unsupportedOperatingSystemError", "Unsupported Operating System: %s"], ["missingCredentialProgramError", "Unable to find required security software: %s"], ["credentialProgramAccessError", "Unable to execute security software: %s"], ["passwordRetryError", "Failed to get the password after %i retries."], ["passwordRequiredError", "A password is required."], ["keyChainServiceRequiredError", "Unable to get or set a keychain value without a service name."], ["keyChainAccountRequiredError", "Unable to get or set a keychain value without an account name."], ["keyChainUserCanceledError", "User canceled authentication."], ["keychainPasswordCreationError", "Failed to create a password in the keychain."], ["genericKeychainServiceError", "The service and account specified in %s do not match the version of the toolbelt."], ["genericKeychainServiceError.actions", ["Check your toolbelt version and re-auth."]], ["genericKeychainInvalidPermsError", "Invalid file permissions for secret file"], ["genericKeychainInvalidPermsError.actions", ["Ensure the file %s has the file permission octal value of %s."]], ["passwordNotFoundError", "Could not find password.\n%s"], ["passwordNotFoundError.actions", ["Ensure a valid password is returned with the following command: [%s]"]], ["setCredentialError", "Command failed with response:\n%s"], ["setCredentialError.actions", ["Determine why this command failed to set an encryption key for user %s: [%s]."]], ["macKeychainOutOfSync", "We\u2019ve encountered an error with the Mac keychain being out of sync with your `sfdx` credentials. To fix the problem, sync your credentials by authenticating into your org again using the auth commands."]]));

package/lib/deviceOauthService.js

@@ -13,7 +13,7 @@ const transport_1 = require("jsforce/lib/transport");
 const kit_1 = require("@salesforce/kit");
 const ts_types_1 = require("@salesforce/ts-types");
 const FormData = require("form-data");
-const logger_1 = require("./logger");
+const logger_1 = require("./logger/logger");
 const org_1 = require("./org");
 const sfError_1 = require("./sfError");
 const messages_1 = require("./messages");

package/lib/exported.d.ts

@@ -17,7 +17,7 @@ export { Lifecycle } from './lifecycleEvents';
 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 { Fields, FieldValue, LoggerLevel, LoggerLevelValue, LogLine, LoggerOptions, Logger } from './logger/logger';
 export { Messages, StructuredMessage } from './messages';
 export { Org, SandboxProcessObject, StatusEvent, SandboxEvents, SandboxUserAuthResponse, SandboxUserAuthRequest, SandboxRequest, ResumeSandboxRequest, OrgTypes, ResultEvent, ScratchOrgRequest, } from './org';
 export { OrgConfigProperties, ORG_CONFIG_ALLOWED_PROPERTIES } from './org/orgConfigProperties';

package/lib/exported.js

@@ -66,7 +66,7 @@ var sfdcUrl_1 = require("./util/sfdcUrl");
 Object.defineProperty(exports, "SfdcUrl", { enumerable: true, get: function () { return sfdcUrl_1.SfdcUrl; } });
 var getJwtAudienceUrl_1 = require("./util/getJwtAudienceUrl");
 Object.defineProperty(exports, "getJwtAudienceUrl", { enumerable: true, get: function () { return getJwtAudienceUrl_1.getJwtAudienceUrl; } });
-var logger_1 = require("./logger");
+var logger_1 = require("./logger/logger");
 Object.defineProperty(exports, "LoggerLevel", { enumerable: true, get: function () { return logger_1.LoggerLevel; } });
 Object.defineProperty(exports, "Logger", { enumerable: true, get: function () { return logger_1.Logger; } });
 var messages_2 = require("./messages");

package/lib/global.d.ts

@@ -48,10 +48,6 @@ export declare class Global {
      * The full system path to the preferred global state folder
      */
     static get DIR(): string;
-    /**
-     * The full system path to the global log file.
-     */
-    static readonly LOG_FILE_PATH: string;
     /**
      * Gets the current mode environment variable as a {@link Mode} instance.
      *

package/lib/global.js

@@ -101,10 +101,4 @@ Global.SF_STATE_FOLDER = '.sf';
  * The preferred global folder in which state is stored.
  */
 Global.STATE_FOLDER = Global.SFDX_STATE_FOLDER;
-/**
- * The full system path to the global log file.
- */
-// member ordering conflicts with the TS use-before-declaration error
-// eslint-disable-next-line @typescript-eslint/member-ordering
-Global.LOG_FILE_PATH = path.join(Global.SF_DIR, 'sf.log');
 //# sourceMappingURL=global.js.map

package/lib/lifecycleEvents.d.ts

@@ -25,7 +25,7 @@ export declare class Lifecycle {
     private readonly listeners;
     static readonly telemetryEventName = "telemetry";
     static readonly warningEventName = "warning";
-    private debug;
+    private logger?;
     private constructor();
     /**
      * return the package.json version of the sfdx-core library.

package/lib/lifecycleEvents.js

@@ -7,12 +7,12 @@
  */
 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
 // eslint-disable-next-line @typescript-eslint/ban-ts-comment
 // @ts-ignore
 const pjson = require("../package.json");
+const logger_1 = require("./logger/logger");
 /**
  * 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
@@ -37,7 +37,6 @@ const pjson = require("../package.json");
 class Lifecycle {
     constructor(listeners = {}) {
         this.listeners = listeners;
-        this.debug = Debug(`sfdx:${this.constructor.name}`);
     }
     /**
      * return the package.json version of the sfdx-core library.
@@ -138,7 +137,10 @@ class Lifecycle {
     on(eventName, cb) {
         const listeners = this.getListeners(eventName);
         if (listeners.length !== 0) {
-            this.debug(`${listeners.length + 1} lifecycle events with the name ${eventName} have now been registered. When this event is emitted all ${listeners.length + 1} listeners will fire.`);
+            if (!this.logger) {
+                this.logger = logger_1.Logger.childFromRoot('Lifecycle');
+            }
+            this.logger.debug(`${listeners.length + 1} lifecycle events with the name ${eventName} have now been registered. When this event is emitted all ${listeners.length + 1} listeners will fire.`);
         }
         listeners.push(cb);
         this.listeners[eventName] = listeners;
@@ -173,7 +175,10 @@ class Lifecycle {
     async emit(eventName, data) {
         const listeners = this.getListeners(eventName);
         if (listeners.length === 0 && eventName !== Lifecycle.warningEventName) {
-            this.debug(`A lifecycle event with the name ${eventName} does not exist. An event must be registered before it can be emitted.`);
+            if (!this.logger) {
+                this.logger = logger_1.Logger.childFromRoot('Lifecycle');
+            }
+            this.logger.debug(`A lifecycle event with the name ${eventName} does not exist. An event must be registered before it can be emitted.`);
         }
         else {
             for (const cb of listeners) {

package/lib/logger/cleanup.d.ts

@@ -0,0 +1,11 @@
+/**
+ * New logger (Summer 2023) changes how file rotation works.  Each day, the logger writes to a new file
+ * To get old files cleaned up, this can be called when a new root logger is instantiated
+ * based on CLEAN_ODDS, it could exit OR delete some old log files
+ *
+ * to start this without waiting, use void cleanup()
+ *
+ * accepts params to override the default behavior (used to cleanup huge log file during perf tests)
+ */
+export declare const cleanup: (maxMs?: number, force?: boolean) => Promise<void>;
+export declare const getOldLogFiles: (files: string[], maxMs?: number) => string[];

package/lib/logger/cleanup.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getOldLogFiles = exports.cleanup = void 0;
+/*
+ * Copyright (c) 2023, 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 fs = require("node:fs");
+const node_path_1 = require("node:path");
+const global_1 = require("../global");
+const logger_1 = require("./logger");
+/**
+ * the odds of running are 1 in CLEAN_ODDS
+ * ex: CLEAN_ODDS=100 implies 1 in 100
+ * ex: CLEAN_ODDS=100 implies 1 in 1 (run every time)
+ * */
+const CLEAN_ODDS = 100;
+const MAX_FILE_AGE_DAYS = 7;
+const MAX_FILE_AGE_MS = 1000 * 60 * 60 * 24 * MAX_FILE_AGE_DAYS;
+const shouldClean = Math.random() * CLEAN_ODDS > CLEAN_ODDS - 1;
+/**
+ * New logger (Summer 2023) changes how file rotation works.  Each day, the logger writes to a new file
+ * To get old files cleaned up, this can be called when a new root logger is instantiated
+ * based on CLEAN_ODDS, it could exit OR delete some old log files
+ *
+ * to start this without waiting, use void cleanup()
+ *
+ * accepts params to override the default behavior (used to cleanup huge log file during perf tests)
+ */
+const cleanup = async (maxMs = MAX_FILE_AGE_MS, force = false) => {
+    if (shouldClean || force) {
+        try {
+            const filesToConsider = await fs.promises // get the files in that dir
+                .readdir(global_1.Global.SF_DIR);
+            const filesToDelete = (0, exports.getOldLogFiles)(filesToConsider, maxMs);
+            await Promise.all(filesToDelete.map((f) => fs.promises.unlink((0, node_path_1.join)(global_1.Global.SF_DIR, f))));
+        }
+        catch (e) {
+            // we never, ever, ever throw since we're not awaiting this promise, so just log a warning
+            (await logger_1.Logger.child('cleanup')).warn('Failed to cleanup old log files', e);
+        }
+    }
+};
+exports.cleanup = cleanup;
+const getOldLogFiles = (files, maxMs = MAX_FILE_AGE_MS) => files
+    .filter((f) => f.endsWith('.log'))
+    // map of filename and the date sf-YYYY-MM-DD.log => YYYY-MM-DD
+    .map((f) => ({ file: f, date: f.match(/sf-(\d{4}-\d{2}-\d{2}).*\.log/)?.[1] }))
+    .filter(hasDate)
+    .map((f) => ({ file: f.file, date: new Date(f.date) }))
+    .filter((f) => f.date < new Date(Date.now() - maxMs))
+    .map((f) => f.file);
+exports.getOldLogFiles = getOldLogFiles;
+const hasDate = (f) => typeof f === 'object' && f !== null && 'date' in f && typeof f.date === 'string';
+//# sourceMappingURL=cleanup.js.map

package/lib/logger/filters.d.ts

@@ -0,0 +1,7 @@
+export declare const HIDDEN = "HIDDEN";
+/**
+ *
+ * @param args you *probably are passing this an object, but it can handle any type
+ * @returns
+ */
+export declare const filterSecrets: (...args: unknown[]) => unknown;

package/lib/logger/filters.js

@@ -0,0 +1,69 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.filterSecrets = exports.HIDDEN = void 0;
+/*
+ * Copyright (c) 2023, 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 ts_types_1 = require("@salesforce/ts-types");
+const sfdc_1 = require("../util/sfdc");
+exports.HIDDEN = 'HIDDEN';
+// Match all json attribute values case insensitive: ex. {" Access*^&(*()^* Token " : " 45143075913458901348905 \n\t" ...}
+const buildTokens = (expElement) => new RegExp(`(['"][^'"]*${expElement}[^'"]*['"]\\s*:\\s*)['"][^'"]*['"]`, 'gi');
+// Match all key value attribute case insensitive: ex. {" key\t"    : ' access_token  ' , " value " : "  dsafgasr431 " ....}
+const buildKeyRegex = (expElement) => RegExp(`(['"]\\s*key\\s*['"]\\s*:)\\s*['"]\\s*${expElement}\\s*['"]\\s*.\\s*['"]\\s*value\\s*['"]\\s*:\\s*['"]\\s*[^'"]*['"]`, 'gi');
+// This will redact values when the keys match certain patterns
+const FILTERED_KEYS = [
+    { name: 'sid' },
+    { name: 'Authorization' },
+    // Any json attribute that contains the words "refresh" and "token" will have the attribute/value hidden
+    { name: 'refresh_token', regex: 'refresh[^\'"]*token' },
+    { name: 'clientsecret' },
+];
+const FILTERED_KEYS_FOR_PROCESSING = FILTERED_KEYS.map((key) => ({
+    ...key,
+    regexTokens: buildTokens(key.regex ?? key.name),
+    hiddenAttrMessage: `"<${key.name} - ${exports.HIDDEN}>"`,
+    keyRegex: buildKeyRegex(key.regex ?? key.name),
+}));
+const compose = (...fns) => fns.reduce((prevFn, nextFn) => (value) => prevFn(nextFn(value)));
+const replacementFunctions = FILTERED_KEYS_FOR_PROCESSING.flatMap((key) => [
+    // two functions to run across each key
+    (input) => input.replace(key.regexTokens, `$1${key.hiddenAttrMessage}`),
+    (input) => input.replace(key.keyRegex, `$1${key.hiddenAttrMessage}`),
+]).concat([
+    // plus any "generalized" functions that are matching contents regardless of keys
+    // use these for secrets with known patterns
+    (input) => input
+        .replace(new RegExp(sfdc_1.accessTokenRegex, 'g'), '<REDACTED ACCESS TOKEN>')
+        .replace(new RegExp(sfdc_1.sfdxAuthUrlRegex, 'g'), '<REDACTED AUTH URL TOKEN>'),
+]);
+const fullReplacementChain = compose(...replacementFunctions);
+/**
+ *
+ * @param args you *probably are passing this an object, but it can handle any type
+ * @returns
+ */
+const filterSecrets = (...args) => args.map((arg) => {
+    if (!arg) {
+        return arg;
+    }
+    if ((0, ts_types_1.isArray)(arg)) {
+        return (0, exports.filterSecrets)(...arg);
+    }
+    // Normalize all objects into a string. This includes errors.
+    if (arg instanceof Buffer) {
+        return '<Buffer>';
+    }
+    if ((0, ts_types_1.isObject)(arg)) {
+        return JSON.parse(fullReplacementChain(JSON.stringify(arg)));
+    }
+    if ((0, ts_types_1.isString)(arg)) {
+        return fullReplacementChain(arg);
+    }
+    return '';
+});
+exports.filterSecrets = filterSecrets;
+//# sourceMappingURL=filters.js.map

package/lib/{logger.d.ts → logger/logger.d.ts}

@@ -1,20 +1,4 @@
-/// <reference types="node" />
-import { Writable } from 'stream';
-/**
- * A Bunyan `Serializer` function.
- *
- * @param input The input to be serialized.
- * **See** {@link https://github.com/forcedotcom/node-bunyan#serializers|Bunyan Serializers API}
- */
-export type Serializer = (input: unknown) => unknown;
-/**
- * A collection of named `Serializer`s.
- *
- * **See** {@link https://github.com/forcedotcom/node-bunyan#serializers|Bunyan Serializers API}
- */
-export interface Serializers {
-    [key: string]: Serializer;
-}
+import { Logger as PinoLogger } from 'pino';
 /**
  * The common set of `Logger` options.
  */
@@ -23,35 +7,21 @@ export interface LoggerOptions {
      * The logger name.
      */
     name: string;
-    /**
-     * The logger format type. Current options include LogFmt or JSON (default).
-     */
-    format?: LoggerFormat;
-    /**
-     * The logger's serializers.
-     */
-    serializers?: Serializers;
-    /**
-     * Whether or not to log source file, line, and function information.
-     */
-    src?: boolean;
     /**
      * The desired log level.
      */
     level?: LoggerLevelValue;
     /**
-     * A stream to write to.
+     * Create a logger with the fields set
      */
-    stream?: Writable;
-    /**
-     * An array of streams to write to.
-     */
-    streams?: LoggerStream[];
+    fields?: Fields;
+    /** log to memory instead of to a file.  Intended for Unit Testing */
+    useMemoryLogger?: boolean;
 }
 /**
  * Standard `Logger` levels.
  *
- * **See** {@link https://github.com/forcedotcom/node-bunyan#levels|Bunyan Levels}
+ * **See** {@link https://getpino.io/#/docs/api?id=logger-level |Logger Levels}
  */
 export declare enum LoggerLevel {
     TRACE = 10,
@@ -61,57 +31,18 @@ export declare enum LoggerLevel {
     ERROR = 50,
     FATAL = 60
 }
-/**
- * `Logger` format types.
- */
-export declare enum LoggerFormat {
-    JSON = 0,
-    LOGFMT = 1
-}
-/**
- * A Bunyan stream configuration.
- *
- * @see {@link https://github.com/forcedotcom/node-bunyan#streams|Bunyan Streams}
- */
-export interface LoggerStream {
-    [key: string]: any;
-    /**
-     * The type of stream -- may be inferred from other properties.
-     */
-    type?: string;
-    /**
-     * The desired log level for the stream.
-     */
-    level?: LoggerLevelValue;
-    /**
-     * The stream to write to.  Mutually exclusive with `path`.
-     */
-    stream?: Writable;
-    /**
-     * The name of the stream.
-     */
-    name?: string;
-    /**
-     * A log file path to write to.  Mutually exclusive with `stream`.
-     */
-    path?: string;
-}
 /**
  * Any numeric `Logger` level.
  */
 export type LoggerLevelValue = LoggerLevel | number;
 /**
- * A collection of named `FieldValue`s.
- *
- * **See** {@link https://github.com/forcedotcom/node-bunyan#log-record-fields|Bunyan Log Record Fields}
+ * An object
  */
-export interface Fields {
-    [key: string]: FieldValue;
-}
+export type Fields = Record<string, unknown>;
 /**
  * All possible field value types.
  */
-export type FieldValue = string | number | boolean;
+export type FieldValue = string | number | boolean | Fields;
 /**
  * Log line interface
  */
@@ -126,8 +57,8 @@ export interface LogLine {
     v: number;
 }
 /**
- * A logging abstraction powered by {@link https://github.com/forcedotcom/node-bunyan|Bunyan} that provides both a default
- * logger configuration that will log to `sfdx.log`, and a way to create custom loggers based on the same foundation.
+ * A logging abstraction powered by {@link https://github.com/pinojs/pino | Pino} that provides both a default
+ * logger configuration that will log to the default path, and a way to create custom loggers based on the same foundation.
  *
  * ```
  * // Gets the root sfdx logger
@@ -141,8 +72,17 @@ export interface LogLine {
  *
  * // Creates a child of a custom logger unaffiliated with the root logger with custom fields applied
  * const myCustomChildLogger = myCustomLogger.child('myCustomChild', {tag: 'value'});
+ *
+ * // get a raw pino logger from the root instance of Logger
+ * // you can use these to avoid constructing another Logger wrapper class and to get better type support
+ * const logger = Logger.getRawRootLogger().child({name: 'foo', otherProp: 'bar'});
+ * logger.info({some: 'stuff'}, 'a message');
+ *
+ *
+ * // get a raw pino logger from the current instance
+ * const childLogger = await Logger.child('myRootChild', {tag: 'value'});
+ * const logger = childLogger.getRawLogger();
  * ```
- * **See** https://github.com/forcedotcom/node-bunyan
  *
  * **See** https://developer.salesforce.com/docs/atlas.en-us.sfdx_setup.meta/sfdx_setup/sfdx_dev_cli_log_messages.htm
  */
@@ -161,25 +101,9 @@ export declare class Logger {
      * **See** {@link LoggerLevel}
      */
     static readonly LEVEL_NAMES: string[];
-    private static readonly lifecycle;
     private static rootLogger?;
-    /**
-     * The default rotation period for logs. Example '1d' will rotate logs daily (at midnight).
-     * See 'period' docs here: https://github.com/forcedotcom/node-bunyan#stream-type-rotating-file
-     */
-    readonly logRotationPeriod: string;
-    /**
-     * The number of backup rotated log files to keep.
-     * Example: '3' will have the base sf.log file, and the past 3 (period) log files.
-     * See 'count' docs here: https://github.com/forcedotcom/node-bunyan#stream-type-rotating-file
-     */
-    readonly logRotationCount: number;
-    /**
-     * Whether debug is enabled for this Logger.
-     */
-    debugEnabled: boolean;
-    private bunyan;
-    private readonly format;
+    private pinoLogger;
+    private memoryLogger?;
     /**
      * Constructs a new `Logger`.
      *
@@ -190,11 +114,13 @@ export declare class Logger {
      */
     constructor(optionsOrName: LoggerOptions | string);
     /**
-     * Gets the root logger with the default level, file stream, and DEBUG enabled.
+     *
+     * Gets the root logger.  It's a singleton
+     * See also getRawLogger if you don't need the root logger
      */
     static root(): Promise<Logger>;
     /**
-     * Gets the root logger with the default level, file stream, and DEBUG enabled.
+     * Gets the root logger.  It's a singleton
      */
     static getRoot(): Logger;
     /**
@@ -204,14 +130,14 @@ export declare class Logger {
      */
     static destroyRoot(): void;
     /**
-     * Create a child of the root logger, inheriting this instance's configuration such as `level`, `streams`, etc.
+     * Create a child of the root logger, inheriting this instance's configuration such as `level`, transports, etc.
      *
      * @param name The name of the child logger.
      * @param fields Additional fields included in all log lines.
      */
     static child(name: string, fields?: Fields): Promise<Logger>;
     /**
-     * Create a child of the root logger, inheriting this instance's configuration such as `level`, `streams`, etc.
+     * Create a child of the root logger, inheriting this instance's configuration such as `level`, transports, etc.
      *
      * @param name The name of the child logger.
      * @param fields Additional fields included in all log lines.
@@ -226,25 +152,10 @@ export declare class Logger {
      * @see {@Link LoggerLevel}
      */
     static getLevelByName(levelName: string): LoggerLevelValue;
-    /**
-     * Adds a stream.
-     *
-     * @param stream The stream configuration to add.
-     * @param defaultLevel The default level of the stream.
-     */
-    addStream(stream: LoggerStream, defaultLevel?: LoggerLevelValue): void;
-    /**
-     * Adds a file stream to this logger. Resolved or rejected upon completion of the addition.
-     *
-     * @param logFile The path to the log file.  If it doesn't exist it will be created.
-     */
-    addLogFileStream(logFile: string): Promise<void>;
-    /**
-     * Adds a file stream to this logger. Resolved or rejected upon completion of the addition.
-     *
-     * @param logFile The path to the log file.  If it doesn't exist it will be created.
-     */
-    addLogFileStreamSync(logFile: string): void;
+    /** get the bare (pino) logger instead of using the class hierarchy */
+    static getRawRootLogger(): PinoLogger;
+    /** get the bare (pino) logger instead of using the class hierarchy */
+    getRawLogger(): PinoLogger;
     /**
      * Gets the name of this logger.
      */
@@ -275,10 +186,6 @@ export declare class Logger {
      * ```
      */
     setLevel(level?: LoggerLevelValue): Logger;
-    /**
-     * Gets the underlying Bunyan logger.
-     */
-    getBunyanLogger(): any;
     /**
      * Compares the requested log level with the current log level.  Returns true if
      * the requested log level is greater than or equal to the current log level.
@@ -286,13 +193,6 @@ export declare class Logger {
      * @param level The requested log level to compare against the currently set log level.
      */
     shouldLog(level: LoggerLevelValue): boolean;
-    /**
-     * Use in-memory logging for this logger instance instead of any parent streams. Useful for testing.
-     * For convenience this object is returned.
-     *
-     * **WARNING: This cannot be undone for this logger instance.**
-     */
-    useMemoryLogging(): Logger;
     /**
      * Gets an array of log line objects. Each element is an object that corresponds to a log line.
      */
@@ -301,22 +201,10 @@ export declare class Logger {
      * Reads a text blob of all the log lines contained in memory or the log file.
      */
     readLogContentsAsText(): string;
-    /**
-     * Adds a filter to be applied to all logged messages.
-     *
-     * @param filter A function with signature `(...args: any[]) => any[]` that transforms log message arguments.
-     */
-    addFilter(filter: (...args: unknown[]) => unknown): void;
-    /**
-     * Close the logger, including any streams, and remove all listeners.
-     *
-     * @param fn A function with signature `(stream: LoggerStream) => void` to call for each stream with the stream as an arg.
-     */
-    close(fn?: (stream: LoggerStream) => void): void;
     /**
      * Create a child logger, typically to add a few log record fields. For convenience this object is returned.
      *
-     * @param name The name of the child logger that is emitted w/ log line as `log:<name>`.
+     * @param name The name of the child logger that is emitted w/ log line.  Will be prefixed with the parent logger name and `:`
      * @param fields Additional fields included in all log lines for the child logger.
      */
     child(name: string, fields?: Fields): Logger;
@@ -369,13 +257,4 @@ export declare class Logger {
      * @param args Any number of arguments to be logged.
      */
     fatal(...args: unknown[]): Logger;
-    /**
-     * Enables logging to stdout when the DEBUG environment variable is used. It uses the logger
-     * name as the debug name, so you can do DEBUG=<logger-name> to filter the results to your logger.
-     */
-    enableDEBUG(): void;
-    private applyFilters;
-    private uncaughtExceptionHandler;
-    private exitHandler;
-    private createLogFmtFormatterStream;
 }