File Explorer

1"use strict";2/*3 * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.4 * SPDX-License-Identifier: Apache-2.0.5 */6Object.defineProperty(exports, "__esModule", { value: true });7exports.logTrace = exports.logDebug = exports.logInfo = exports.logWarn = exports.logError = exports.logFatal = exports.setLogLevel = exports.LogLevel = exports.SocketDomain = exports.SocketType = exports.TlsVersion = void 0;8/**9 *10 * A module containing a grab bag of support for core network I/O functionality, including sockets, TLS, DNS, logging,11 * error handling, streams, and connection -> thread mapping.12 *13 * Categories include:14 * - Network: socket configuration15 * - TLS: tls configuration16 * - Logging: logging controls and configuration17 * - IO: everything else18 *19 * @packageDocumentation20 * @module io21 */22/**23 * TLS Version24 *25 * @category TLS26 */27var TlsVersion;28(function (TlsVersion) {29    TlsVersion[TlsVersion["SSLv3"] = 0] = "SSLv3";30    TlsVersion[TlsVersion["TLSv1"] = 1] = "TLSv1";31    TlsVersion[TlsVersion["TLSv1_1"] = 2] = "TLSv1_1";32    TlsVersion[TlsVersion["TLSv1_2"] = 3] = "TLSv1_2";33    TlsVersion[TlsVersion["TLSv1_3"] = 4] = "TLSv1_3";34    TlsVersion[TlsVersion["Default"] = 128] = "Default";35})(TlsVersion = exports.TlsVersion || (exports.TlsVersion = {}));36/**37 * @category Network38 */39var SocketType;40(function (SocketType) {41    /**42     * A streaming socket sends reliable messages over a two-way connection.43     * This means TCP when used with {@link SocketDomain.IPV4}/{@link SocketDomain.IPV6},44     * and Unix domain sockets when used with {@link SocketDomain.LOCAL }45      */46    SocketType[SocketType["STREAM"] = 0] = "STREAM";47    /**48     * A datagram socket is connectionless and sends unreliable messages.49     * This means UDP when used with {@link SocketDomain.IPV4}/{@link SocketDomain.IPV6}.50     * {@link SocketDomain.LOCAL} is not compatible with {@link DGRAM}51     */52    SocketType[SocketType["DGRAM"] = 1] = "DGRAM";53})(SocketType = exports.SocketType || (exports.SocketType = {}));54/**55 * @category Network56 */57var SocketDomain;58(function (SocketDomain) {59    /** IPv4 sockets */60    SocketDomain[SocketDomain["IPV4"] = 0] = "IPV4";61    /** IPv6 sockets */62    SocketDomain[SocketDomain["IPV6"] = 1] = "IPV6";63    /** UNIX domain socket/Windows named pipes */64    SocketDomain[SocketDomain["LOCAL"] = 2] = "LOCAL";65})(SocketDomain = exports.SocketDomain || (exports.SocketDomain = {}));66/**67 * The amount of detail that will be logged68 * @category Logging69 */70var LogLevel;71(function (LogLevel) {72    /** No logging whatsoever. */73    LogLevel[LogLevel["NONE"] = 0] = "NONE";74    /** Only fatals. In practice, this will not do much, as the process will log and then crash (intentionally) if a fatal condition occurs */75    LogLevel[LogLevel["FATAL"] = 1] = "FATAL";76    /** Only errors */77    LogLevel[LogLevel["ERROR"] = 2] = "ERROR";78    /** Only warnings and errors */79    LogLevel[LogLevel["WARN"] = 3] = "WARN";80    /** Information about connection/stream creation/destruction events */81    LogLevel[LogLevel["INFO"] = 4] = "INFO";82    /** Enough information to debug the chain of events a given network connection encounters */83    LogLevel[LogLevel["DEBUG"] = 5] = "DEBUG";84    /** Everything. Only use this if you really need to know EVERY single call */85    LogLevel[LogLevel["TRACE"] = 6] = "TRACE";86})(LogLevel = exports.LogLevel || (exports.LogLevel = {}));87let logLevel = LogLevel.NONE;88/**89 * Sets the amount of detail that will be logged90 * @param level - maximum level of logging detail.  Log invocations at a higher level of detail will be ignored.91 *92 * @category Logging93 */94function setLogLevel(level) {95    logLevel = level;96}97exports.setLogLevel = setLogLevel;98/*99 * The logging API is exported to library-internal, but stays private beyond the package boundary, so the following API100 * decisions are not binding.101 */102function logFatal(subject, logLine) {103    if (logLevel < LogLevel.FATAL) {104        return;105    }106    let currentTime = new Date().toISOString();107    console.log(`[FATAL] [${currentTime}] [${subject}] - ${logLine}`);108}109exports.logFatal = logFatal;110function logError(subject, logLine) {111    if (logLevel < LogLevel.ERROR) {112        return;113    }114    let currentTime = new Date().toISOString();115    console.log(`[ERROR] [${currentTime}] [${subject}] - ${logLine}`);116}117exports.logError = logError;118function logWarn(subject, logLine) {119    if (logLevel < LogLevel.WARN) {120        return;121    }122    let currentTime = new Date().toISOString();123    console.log(`[WARN] [${currentTime}] [${subject}] - ${logLine}`);124}125exports.logWarn = logWarn;126function logInfo(subject, logLine) {127    if (logLevel < LogLevel.INFO) {128        return;129    }130    let currentTime = new Date().toISOString();131    console.log(`[INFO] [${currentTime}] [${subject}] - ${logLine}`);132}133exports.logInfo = logInfo;134function logDebug(subject, logLine) {135    if (logLevel < LogLevel.DEBUG) {136        return;137    }138    let currentTime = new Date().toISOString();139    console.log(`[DEBUG] [${currentTime}] [${subject}] - ${logLine}`);140}141exports.logDebug = logDebug;142function logTrace(subject, logLine) {143    if (logLevel < LogLevel.TRACE) {144        return;145    }146    let currentTime = new Date().toISOString();147    console.log(`[TRACE] [${currentTime}] [${subject}] - ${logLine}`);148}149exports.logTrace = logTrace;150//# sourceMappingURL=io.js.map