zeddemore-logger 2.3.1 → 2.3.3

package/.github/workflows/publish.yml

@@ -0,0 +1,31 @@
+name: Publish to npm
+
+on:
+  workflow_dispatch:
+  push:
+    tags:
+      - 'v[0-9]*.[0-9]*.[0-9]*'
+      - 'v[0-9]*.[0-9]*.[0-9]*-*'
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      id-token: write # Required for npm provenance tracking
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '24'
+          registry-url: 'https://registry.npmjs.org'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Publish package
+        run: npm publish --provenance --access public

package/README.md

@@ -1,3 +1,3 @@
-# zeddemore-logger
-
-Node.js logger using Morgan and Winston for thread and caller info tracking.
+# zeddemore-logger
+
+Node.js logger using Morgan and Winston for thread and caller info tracking.

package/lib/ZeddemoreLogger.js

@@ -750,8 +750,10 @@ class ZeddemoreLogger extends ZeddemoreBase {
     /**
      * Log server listening information
      * @param {Object} options
+     * @param {String} [options.address]
      * @param {String} [options.environment]
-     * @param {String} [options.listenHost]
+     * @param {String} [options.family]
+     * @param {String} [options.listenHost] - @deprecated Use options.address instead
      * @param {String} [options.instance]
      * @param {String} [options.name]
      * @param {number} [options.port]
@@ -760,20 +762,23 @@ class ZeddemoreLogger extends ZeddemoreBase {
      */
     #logServerListening = (options, logLevel = wll.INFO) => {
         const serverEnvironment = options.environment || this.serverEnvironment;
-        const serverHost = options.listenHost || defaults.listenHost;
+        const serverAddress = options.address || options.listenHost || defaults.address;
+        let serverFamily = options.family || null;
         const serverInstance = options.instance || this.serverInstance;
         const serverName = options.name || this.serverName;
         const serverPort = options.port || this.serverPort;
-        const usingIPv4 = true;
-        const usingIPv6 = _.isString(serverHost) && serverHost.includes(defaults.listenHostIPv6Sentinel);
-        const ipVs = _.compact([ (usingIPv4 ? 'IPv4' : null), (usingIPv6 ? chalk.red('IPv6') : null) ]).join('/');
+        if (_.isNull(serverFamily)) {
+            const usingIPv4 = true;
+            const usingIPv6 = _.isString(serverAddress) && serverAddress.includes(defaults.addressIPv6Sentinel);
+            serverFamily = _.compact([ (usingIPv4 ? 'IPv4' : null), (usingIPv6 ? chalk.red('IPv6') : null) ]).join('/');
+        }
         const msgParts = [ ];
         const serverParts = [ serverName ];
-        if (serverEnvironment) serverParts.push(serverEnvironment);
+        if (serverEnvironment) serverParts.push(chalk.bold(serverEnvironment));
         if (serverInstance) serverParts.push(serverInstance);
         msgParts.push(`[${ serverParts.join(':') }]`);
-        msgParts.push(`Node.js server listening on ${ serverHost }:${ chalk.bold(serverPort) }`);
-        msgParts.push(`(${ ipVs })`);
+        msgParts.push(`Node.js server listening on ${ serverAddress }:${ chalk.bold(serverPort) }`);
+        msgParts.push(`(${ serverFamily })`);
         this.log(logLevel)(msgParts.join(' '));
     }
 
@@ -867,7 +872,7 @@ class ZeddemoreLogger extends ZeddemoreBase {
      * @param {String} [options.morganFormat]
      * @returns {function(*, *, *): void}
      */
-    morganMiddleware = (options) => {
+    morganMiddleware = (options = { }) => {
         options = options || { };
         const colorize = _.isBoolean(options.colorize) ? options.colorize : this.colorize;
         const disableMorganLogging = _.isBoolean(options.disableMorganLogging) ? options.disableMorganLogging : !this.httpRequestLogging;

package/lib/defaults.js

@@ -1,4 +1,4 @@
-// Copyright (c) 2024-2025 by Beardon Services, Inc.
+// Copyright (c) 2024-2026 by Beardon Services, Inc.
 
 const enums = require('./enums');
 
@@ -6,14 +6,14 @@ const { hexColors: hc, logLevelTypes: llt, morganFormats: mf, morganFormatTokens
     winstonLogLevelNames: wlln, winstonTransports: wt } = enums;
 
 module.exports = {
+    address: '::',
+    addressIPv6Sentinel: ':',
     colorConsoleWhiteHex: hc.CONSOLE_WHITE,
     consoleDirExtensionMethodName: 'dirp',
     consoleDirExtensionColors: true,
     consoleDirExtensionDepth: null,
     consoleDirExtensionShowHidden: true,
     contentLengthDigits: 2,
-    listenHost: '::',
-    listenHostIPv6Sentinel: ':',
     liveMessage: 'live',
     logLevelType: llt.CONSOLE,
     morganFormat: mf.ZEDDEMORE,

package/lib/enums.js

@@ -1,250 +1,250 @@
-// Copyright (c) 2025-2026 by Beardon Services, Inc.
-
-function doesEnumInclude(set, value) {
-    for (const key in set) {
-        if (set[ key ] === value) return true;
-    }
-    return false;
-}
-
-const ansiColors = {
-    HTTP_CLIENT_ERROR: 33, // red
-    HTTP_INFORMATIONAL: 0, // white
-    HTTP_REDIRECTION: 36, // blue
-    HTTP_SERVER_ERROR: 31, // red
-    HTTP_SUCCESSFUL: 32, // green
-    LDAP_ERROR: 31, // red
-    LDAP_SUCCESSFUL: 32, // green
-    LOG_LEVEL_DEBUG: 34, // blue
-    LOG_LEVEL_ERROR: 31, // red
-    LOG_LEVEL_HTTP: 32, // green
-    LOG_LEVEL_INFO: 32, // green
-    LOG_LEVEL_SILLY: 35, // magenta
-    LOG_LEVEL_VERBOSE: 36, // cyan
-    LOG_LEVEL_WARNING: 33, // yellow
-};
-
-const chalkFormats = {
-    ANSI: 'ansi',
-    HEX: 'hex',
-    RGB: 'rgb',
-};
-
-const chalkLayers = {
-    BACKGROUND: 'bg',
-    FOREGROUND: 'fg',
-};
-
-const hexColors = {
-    BEARDON_RED: '#951A1D',
-    BLACK: '#000000',
-    CONSOLE_WHITE: '#ECECEC',
-    DB_DELETE: '#F22613',
-    DB_INSERT: '#00B16A',
-    DB_SELECT: '#1E90FF',
-    DB_TRUNCATE: '#750505',
-    DB_UPDATE: '#F9690E',
-    HTTP_CONNECT: '#FFFFFF',
-    HTTP_DELETE: '#EF968A',
-    HTTP_GET: '#67D193',
-    HTTP_HEAD: '#68D696',
-    HTTP_OPTIONS: '#E55AA8',
-    HTTP_PATCH: '#C0A8E1',
-    HTTP_POST: '#F4DA7A',
-    HTTP_PUT: '#74AEF6',
-    HTTP_TRACE: '#FFFFFF',
-    LDAP_ABANDON: '#922B21',
-    LDAP_ADD: '#F1C40F',
-    LDAP_BIND: '#2ECC71',
-    LDAP_COMPARE: '#A3E4D7',
-    LDAP_DELETE: '#E74C3C',
-    LDAP_EXTENDED: '#ECF0F1',
-    LDAP_MODIFY: '#F39C12',
-    LDAP_MODIFY_DN: '#9B59B6',
-    LDAP_SEARCH: '#1ABC9C',
-    LDAP_UNBIND: '#7F8C8D',
-    LIGHT_GRAY: '#777B7E',
-    PACKAGE_ANGULARJS: '#C04737',
-    PACKAGE_AXIOS: '#6200e1',
-    PACKAGE_EXPRESS: '#F7DF1E',
-    PACKAGE_HANDLEBARS: '#F0772B',
-    PACKAGE_JIMP: '#FF0000',
-    PACKAGE_MYSQL: '#00618A',
-    PACKAGE_NODE_JS: '#689F63',
-    PACKAGE_NODEMAILER: '#29ABE2',
-    PACKAGE_PASSPORT: '#51E492',
-    PACKAGE_PDFKIT: '#DB000D',
-    PACKAGE_POSTGRESQL: '#336791',
-    PACKAGE_REDIS: '#C23936',
-    PACKAGE_SEQUELIZE: '#00AFEF',
-    PACKAGE_ZEDDEMORE: '#E2B68F',
-};
-
-const httpStatusCodeGroups = {
-    INFORMATIONAL: 1,
-    SUCCESSFUL: 2,
-    REDIRECTION: 3,
-    CLIENT_ERROR: 4,
-    SERVER_ERROR: 5,
-};
-
-const httpMethods = {
-    GET: 'GET',
-    HEAD: 'HEAD',
-    POST: 'POST',
-    PUT: 'PUT',
-    DELETE: 'DELETE',
-    CONNECT: 'CONNECT',
-    OPTIONS: 'OPTIONS',
-    TRACE: 'TRACE',
-    PATCH: 'PATCH',
-};
-
-const httpRequestHeaders = {
-    ACCEPT_LANGUAGE: 'Accept-Language',
-    ALLOW: 'Allow',
-    APP_VERSION: 'App-Version',
-    AUTHORIZATION: 'Authorization',
-    BEARER_PREFIX: 'Bearer',
-    FORWARDED_FOR: 'X-Forwarded-For',
-    REQUEST_ID: 'X-Request-Id',
-    USER_AGENT: 'User-Agent',
-};
-
-const httpResponseHeaders = {
-    CONTENT_LENGTH: 'Content-Length',
-};
-
-const ldapOperations = {
-    ABANDON: 'ABANDON',
-    ADD: 'ADD',
-    BIND: 'BIND',
-    COMPARE: 'COMPARE',
-    DELETE: 'DEL',
-    EXTENDED: 'EXTENDED',
-    MODIFY: 'MODIFY',
-    MODIFY_DN: 'MODIFY_DN',
-    SEARCH: 'SEARCH',
-    UNBIND: 'UNBIND',
-};
-
-const ldapRequestOperationTypes = {
-    ABANDON: 'AbandonRequest',
-    ADD: 'AddRequest',
-    BIND: 'BindRequest',
-    COMPARE: 'CompareRequest',
-    DELETE: 'DeleteRequest',
-    EXTENDED: 'ExtendedRequest',
-    MODIFY: 'ModifyRequest',
-    MODIFY_DN: 'ModifyDnRequest',
-    SEARCH: 'SearchRequest',
-    UNBIND: 'UnbindRequest',
-};
-
-const logLevelTypes = {
-    CONSOLE: 'console',
-    EMAIL: 'email',
-};
-
-const morganFormats = {
-    COMBINED: 'combined',
-    COMMON: 'common',
-    DEV: 'dev',
-    SHORT: 'short',
-    TINY: 'tiny',
-    ZEDDEMORE: 'zeddemore', // added for `zeddemore-logger`
-};
-
-const morganFormatTokens = {
-    CONTENT_LENGTH_FORMAT: 'content-length-format', // added for `zeddemore-logger`
-    DATE: 'date', // :date[format]
-    DECODED_URL: 'decoded-url', // added for `zeddemore-logger`
-    HTTP_VERSION: 'http-version',
-    METHOD: 'method',
-    REFERRER: 'referrer',
-    REMOTE_ADDR: 'remote-addr',
-    REMOTE_USER: 'remote-user',
-    REQ: 'req', // :req[header]
-    RES: 'res', // :res[header]
-    RESPONSE_TIME: 'response-time', // :response-time[digits]
-    RESPONSE_TIME_FORMAT: 'response-time-format', // added for `zeddemore-logger`
-    STATUS: 'status',
-    STATUS_COLORED: 'status-colored', // added for `zeddemore-logger`
-    TOTAL_TIME: 'total-time', // :total-time[digits]
-    URL: 'url',
-    USER_AGENT: 'user-agent',
-};
-
-const winstonFormats = {
-    COLORIZE: 'colorize',
-    JSON: 'json',
-    METADATA: 'metadata',
-    PRETTY_PRINT: 'pretty_print',
-    SIMPLE: 'simple',
-    SPLAT: 'splat',
-    TIMESTAMP: 'timestamp',
-    ZEDDEMORE_INFO_MUTATION: 'zeddemore_info_mutation',
-    ZEDDEMORE_LABEL: 'zeddemore_label',
-    ZEDDEMORE_PRINTF: 'zeddemore_printf',
-    ZEDDEMORE_TIMESTAMP: 'zeddemore_timestamp',
-};
-
-const winstonLogLevelNames = {
-    ERROR: 'error',
-    WARNING: 'warn',
-    INFO: 'info',
-    HTTP: 'http',
-    LDAP: 'ldap',
-    VERBOSE: 'verbose',
-    DEBUG: 'debug',
-    SILLY: 'silly',
-};
-
-// using NPM logging levels
-const winstonLogLevels = {
-    ERROR: 0,
-    WARNING: 1,
-    INFO: 2,
-    HTTP: 3,
-    VERBOSE: 4,
-    DEBUG: 5,
-    SILLY: 6,
-};
-
-const winstonTransports = {
-    CONSOLE: 'console',
-    EMAIL: 'email',
-};
-
-const zeddemoreLogLevelCaptions = {
-    DEFAULT: 'Default',
-    ERROR: 'Error',
-    WARNING: 'Warning',
-    INFO: 'Info',
-    HTTP: 'HTTP',
-    VERBOSE: 'Verbose',
-    DEBUG: 'Debug',
-    SILLY: 'Silly',
-};
-
-module.exports = {
-    doesEnumInclude,
-    ansiColors,
-    chalkFormats,
-    chalkLayers,
-    hexColors,
-    httpStatusCodeGroups,
-    httpMethods,
-    httpRequestHeaders,
-    httpResponseHeaders,
-    ldapOperations,
-    ldapRequestOperationTypes,
-    logLevelTypes,
-    morganFormats,
-    morganFormatTokens,
-    winstonFormats,
-    winstonLogLevelNames,
-    winstonLogLevels,
-    winstonTransports,
-    zeddemoreLogLevelCaptions,
-};
+// Copyright (c) 2025-2026 by Beardon Services, Inc.
+
+function doesEnumInclude(set, value) {
+    for (const key in set) {
+        if (set[ key ] === value) return true;
+    }
+    return false;
+}
+
+const ansiColors = {
+    HTTP_CLIENT_ERROR: 33, // red
+    HTTP_INFORMATIONAL: 0, // white
+    HTTP_REDIRECTION: 36, // blue
+    HTTP_SERVER_ERROR: 31, // red
+    HTTP_SUCCESSFUL: 32, // green
+    LDAP_ERROR: 31, // red
+    LDAP_SUCCESSFUL: 32, // green
+    LOG_LEVEL_DEBUG: 34, // blue
+    LOG_LEVEL_ERROR: 31, // red
+    LOG_LEVEL_HTTP: 32, // green
+    LOG_LEVEL_INFO: 32, // green
+    LOG_LEVEL_SILLY: 35, // magenta
+    LOG_LEVEL_VERBOSE: 36, // cyan
+    LOG_LEVEL_WARNING: 33, // yellow
+};
+
+const chalkFormats = {
+    ANSI: 'ansi',
+    HEX: 'hex',
+    RGB: 'rgb',
+};
+
+const chalkLayers = {
+    BACKGROUND: 'bg',
+    FOREGROUND: 'fg',
+};
+
+const hexColors = {
+    BEARDON_RED: '#951A1D',
+    BLACK: '#000000',
+    CONSOLE_WHITE: '#ECECEC',
+    DB_DELETE: '#F22613',
+    DB_INSERT: '#00B16A',
+    DB_SELECT: '#1E90FF',
+    DB_TRUNCATE: '#750505',
+    DB_UPDATE: '#F9690E',
+    HTTP_CONNECT: '#FFFFFF',
+    HTTP_DELETE: '#EF968A',
+    HTTP_GET: '#67D193',
+    HTTP_HEAD: '#68D696',
+    HTTP_OPTIONS: '#E55AA8',
+    HTTP_PATCH: '#C0A8E1',
+    HTTP_POST: '#F4DA7A',
+    HTTP_PUT: '#74AEF6',
+    HTTP_TRACE: '#FFFFFF',
+    LDAP_ABANDON: '#922B21',
+    LDAP_ADD: '#F1C40F',
+    LDAP_BIND: '#2ECC71',
+    LDAP_COMPARE: '#A3E4D7',
+    LDAP_DELETE: '#E74C3C',
+    LDAP_EXTENDED: '#ECF0F1',
+    LDAP_MODIFY: '#F39C12',
+    LDAP_MODIFY_DN: '#9B59B6',
+    LDAP_SEARCH: '#1ABC9C',
+    LDAP_UNBIND: '#7F8C8D',
+    LIGHT_GRAY: '#777B7E',
+    PACKAGE_ANGULARJS: '#C04737',
+    PACKAGE_AXIOS: '#6200e1',
+    PACKAGE_EXPRESS: '#F7DF1E',
+    PACKAGE_HANDLEBARS: '#F0772B',
+    PACKAGE_JIMP: '#FF0000',
+    PACKAGE_MYSQL: '#00618A',
+    PACKAGE_NODE_JS: '#689F63',
+    PACKAGE_NODEMAILER: '#29ABE2',
+    PACKAGE_PASSPORT: '#51E492',
+    PACKAGE_PDFKIT: '#DB000D',
+    PACKAGE_POSTGRESQL: '#336791',
+    PACKAGE_REDIS: '#C23936',
+    PACKAGE_SEQUELIZE: '#00AFEF',
+    PACKAGE_ZEDDEMORE: '#E2B68F',
+};
+
+const httpStatusCodeGroups = {
+    INFORMATIONAL: 1,
+    SUCCESSFUL: 2,
+    REDIRECTION: 3,
+    CLIENT_ERROR: 4,
+    SERVER_ERROR: 5,
+};
+
+const httpMethods = {
+    GET: 'GET',
+    HEAD: 'HEAD',
+    POST: 'POST',
+    PUT: 'PUT',
+    DELETE: 'DELETE',
+    CONNECT: 'CONNECT',
+    OPTIONS: 'OPTIONS',
+    TRACE: 'TRACE',
+    PATCH: 'PATCH',
+};
+
+const httpRequestHeaders = {
+    ACCEPT_LANGUAGE: 'Accept-Language',
+    ALLOW: 'Allow',
+    APP_VERSION: 'App-Version',
+    AUTHORIZATION: 'Authorization',
+    BEARER_PREFIX: 'Bearer',
+    FORWARDED_FOR: 'X-Forwarded-For',
+    REQUEST_ID: 'X-Request-Id',
+    USER_AGENT: 'User-Agent',
+};
+
+const httpResponseHeaders = {
+    CONTENT_LENGTH: 'Content-Length',
+};
+
+const ldapOperations = {
+    ABANDON: 'ABANDON',
+    ADD: 'ADD',
+    BIND: 'BIND',
+    COMPARE: 'COMPARE',
+    DELETE: 'DEL',
+    EXTENDED: 'EXTENDED',
+    MODIFY: 'MODIFY',
+    MODIFY_DN: 'MODIFY_DN',
+    SEARCH: 'SEARCH',
+    UNBIND: 'UNBIND',
+};
+
+const ldapRequestOperationTypes = {
+    ABANDON: 'AbandonRequest',
+    ADD: 'AddRequest',
+    BIND: 'BindRequest',
+    COMPARE: 'CompareRequest',
+    DELETE: 'DeleteRequest',
+    EXTENDED: 'ExtendedRequest',
+    MODIFY: 'ModifyRequest',
+    MODIFY_DN: 'ModifyDnRequest',
+    SEARCH: 'SearchRequest',
+    UNBIND: 'UnbindRequest',
+};
+
+const logLevelTypes = {
+    CONSOLE: 'console',
+    EMAIL: 'email',
+};
+
+const morganFormats = {
+    COMBINED: 'combined',
+    COMMON: 'common',
+    DEV: 'dev',
+    SHORT: 'short',
+    TINY: 'tiny',
+    ZEDDEMORE: 'zeddemore', // added for `zeddemore-logger`
+};
+
+const morganFormatTokens = {
+    CONTENT_LENGTH_FORMAT: 'content-length-format', // added for `zeddemore-logger`
+    DATE: 'date', // :date[format]
+    DECODED_URL: 'decoded-url', // added for `zeddemore-logger`
+    HTTP_VERSION: 'http-version',
+    METHOD: 'method',
+    REFERRER: 'referrer',
+    REMOTE_ADDR: 'remote-addr',
+    REMOTE_USER: 'remote-user',
+    REQ: 'req', // :req[header]
+    RES: 'res', // :res[header]
+    RESPONSE_TIME: 'response-time', // :response-time[digits]
+    RESPONSE_TIME_FORMAT: 'response-time-format', // added for `zeddemore-logger`
+    STATUS: 'status',
+    STATUS_COLORED: 'status-colored', // added for `zeddemore-logger`
+    TOTAL_TIME: 'total-time', // :total-time[digits]
+    URL: 'url',
+    USER_AGENT: 'user-agent',
+};
+
+const winstonFormats = {
+    COLORIZE: 'colorize',
+    JSON: 'json',
+    METADATA: 'metadata',
+    PRETTY_PRINT: 'pretty_print',
+    SIMPLE: 'simple',
+    SPLAT: 'splat',
+    TIMESTAMP: 'timestamp',
+    ZEDDEMORE_INFO_MUTATION: 'zeddemore_info_mutation',
+    ZEDDEMORE_LABEL: 'zeddemore_label',
+    ZEDDEMORE_PRINTF: 'zeddemore_printf',
+    ZEDDEMORE_TIMESTAMP: 'zeddemore_timestamp',
+};
+
+const winstonLogLevelNames = {
+    ERROR: 'error',
+    WARNING: 'warn',
+    INFO: 'info',
+    HTTP: 'http',
+    LDAP: 'ldap',
+    VERBOSE: 'verbose',
+    DEBUG: 'debug',
+    SILLY: 'silly',
+};
+
+// using NPM logging levels
+const winstonLogLevels = {
+    ERROR: 0,
+    WARNING: 1,
+    INFO: 2,
+    HTTP: 3,
+    VERBOSE: 4,
+    DEBUG: 5,
+    SILLY: 6,
+};
+
+const winstonTransports = {
+    CONSOLE: 'console',
+    EMAIL: 'email',
+};
+
+const zeddemoreLogLevelCaptions = {
+    DEFAULT: 'Default',
+    ERROR: 'Error',
+    WARNING: 'Warning',
+    INFO: 'Info',
+    HTTP: 'HTTP',
+    VERBOSE: 'Verbose',
+    DEBUG: 'Debug',
+    SILLY: 'Silly',
+};
+
+module.exports = {
+    doesEnumInclude,
+    ansiColors,
+    chalkFormats,
+    chalkLayers,
+    hexColors,
+    httpStatusCodeGroups,
+    httpMethods,
+    httpRequestHeaders,
+    httpResponseHeaders,
+    ldapOperations,
+    ldapRequestOperationTypes,
+    logLevelTypes,
+    morganFormats,
+    morganFormatTokens,
+    winstonFormats,
+    winstonLogLevelNames,
+    winstonLogLevels,
+    winstonTransports,
+    zeddemoreLogLevelCaptions,
+};

package/lib/http.js

@@ -1,26 +1,26 @@
-// Copyright (c) 2026 by Beardon Services, Inc.
-
-const _ = require('lodash');
-
-function extractHttpStatusCode(message) {
-    if (!_.isString(message) || !message.length) return null;
-    // Regex breakdown:
-    // \b      : Word boundary (ensures we don't grab "12345")
-    // [1-5]   : Starts with 1 (Info), 2 (Success), 3 (Redirect), 4 (Client Error), or 5 (Server Error)
-    // [0-9]{2}: Followed by exactly two digits
-    // \b      : Ending word boundary
-    const match = message.match(/\b[1-5][0-9]{2}\b/);
-    return match ? +match[ 0 ] : null;
-}
-
-function extractHttpVerb(message) {
-    if (!_.isString(message) || !message.length) return null;
-    const splitMessage = message.split(' ');
-    if (splitMessage.length < 2) return null;
-    return message.split(' ')[ 0 ];
-}
-
-module.exports = {
-    extractHttpStatusCode,
-    extractHttpVerb,
-}
+// Copyright (c) 2026 by Beardon Services, Inc.
+
+const _ = require('lodash');
+
+function extractHttpStatusCode(message) {
+    if (!_.isString(message) || !message.length) return null;
+    // Regex breakdown:
+    // \b      : Word boundary (ensures we don't grab "12345")
+    // [1-5]   : Starts with 1 (Info), 2 (Success), 3 (Redirect), 4 (Client Error), or 5 (Server Error)
+    // [0-9]{2}: Followed by exactly two digits
+    // \b      : Ending word boundary
+    const match = message.match(/\b[1-5][0-9]{2}\b/);
+    return match ? +match[ 0 ] : null;
+}
+
+function extractHttpVerb(message) {
+    if (!_.isString(message) || !message.length) return null;
+    const splitMessage = message.split(' ');
+    if (splitMessage.length < 2) return null;
+    return message.split(' ')[ 0 ];
+}
+
+module.exports = {
+    extractHttpStatusCode,
+    extractHttpVerb,
+}

package/lib/request.js

@@ -1,68 +1,68 @@
-// Copyright (c) 2025-2026 by Beardon Services, Inc.
-
-const _ = require('lodash');
-
-const enums = require('./enums');
-const { parseIpAddress } = require('./ip_address');
-
-const { httpRequestHeaders: rqh } = enums;
-
-function extractToken(req) {
-    let token;
-    const authHeader = req.header(rqh.AUTHORIZATION);
-    if (authHeader && authHeader.startsWith(`${ rqh.BEARER_PREFIX } `)) {
-        token = req.header(rqh.AUTHORIZATION).split(' ')[ 1 ];
-    } else if (req.query && req.query.token) {
-        token = req.query.token;
-    }
-    return token;
-}
-
-function getRequestResponseTime(req, res) {
-    if (!req._startAt || !res._startAt) return null;
-    return (res._startAt[ 0 ] - req._startAt[ 0 ]) * 1e3 + (res._startAt[ 1 ] - req._startAt[ 1 ]) * 1e-6;
-}
-
-function isRequestOfMethod(req, method) {
-    const methods = Array.isArray(method) ? method : [ method ];
-    if (!req || !req.method || _.isEmpty(methods)) return false;
-    return methods.includes(req.method);
-}
-
-function parseRequest(req) {
-    if (!req) return { };
-    const body = req.body || { };
-    return {
-        acceptLanguage: parseRequestAcceptLanguage(req),
-        client: body.client || null,
-        clientVersion: body.applicationVersion || null,
-        ipAddress: parseRequestIpAddress(req),
-        sessionAge: body.uptime || 0,
-        sessionId: body.sessionId || null,
-        userAgent: parseRequestUserAgent(req),
-    };
-}
-
-function parseRequestAcceptLanguage(req) {
-    const body = req.body || { };
-    return body.language || req.header(rqh.ACCEPT_LANGUAGE);
-}
-
-function parseRequestIpAddress(req) {
-    const LOCALHOST_IPS = [ '127.0.0.1', '::1' ];
-    const body = req.body || { };
-    const requestIpAddress = parseIpAddress(body.ipAddress) || parseIpAddress(req.get(rqh.FORWARDED_FOR)) || parseIpAddress(req.socket.remoteAddress);
-    return LOCALHOST_IPS.includes(requestIpAddress) ? 'localhost' : requestIpAddress;
-}
-
-function parseRequestUserAgent(req) {
-    const body = req.body || { };
-    return body.agent || body.osVersion || req.get(rqh.USER_AGENT);
-}
-
-module.exports = {
-    extractToken,
-    getRequestResponseTime,
-    isRequestOfMethod,
-    parseRequest,
-};
+// Copyright (c) 2025-2026 by Beardon Services, Inc.
+
+const _ = require('lodash');
+
+const enums = require('./enums');
+const { parseIpAddress } = require('./ip_address');
+
+const { httpRequestHeaders: rqh } = enums;
+
+function extractToken(req) {
+    let token;
+    const authHeader = req.header(rqh.AUTHORIZATION);
+    if (authHeader && authHeader.startsWith(`${ rqh.BEARER_PREFIX } `)) {
+        token = req.header(rqh.AUTHORIZATION).split(' ')[ 1 ];
+    } else if (req.query && req.query.token) {
+        token = req.query.token;
+    }
+    return token;
+}
+
+function getRequestResponseTime(req, res) {
+    if (!req._startAt || !res._startAt) return null;
+    return (res._startAt[ 0 ] - req._startAt[ 0 ]) * 1e3 + (res._startAt[ 1 ] - req._startAt[ 1 ]) * 1e-6;
+}
+
+function isRequestOfMethod(req, method) {
+    const methods = Array.isArray(method) ? method : [ method ];
+    if (!req || !req.method || _.isEmpty(methods)) return false;
+    return methods.includes(req.method);
+}
+
+function parseRequest(req) {
+    if (!req) return { };
+    const body = req.body || { };
+    return {
+        acceptLanguage: parseRequestAcceptLanguage(req),
+        client: body.client || null,
+        clientVersion: body.applicationVersion || null,
+        ipAddress: parseRequestIpAddress(req),
+        sessionAge: body.uptime || 0,
+        sessionId: body.sessionId || null,
+        userAgent: parseRequestUserAgent(req),
+    };
+}
+
+function parseRequestAcceptLanguage(req) {
+    const body = req.body || { };
+    return body.language || req.header(rqh.ACCEPT_LANGUAGE);
+}
+
+function parseRequestIpAddress(req) {
+    const LOCALHOST_IPS = [ '127.0.0.1', '::1' ];
+    const body = req.body || { };
+    const requestIpAddress = parseIpAddress(body.ipAddress) || parseIpAddress(req.get(rqh.FORWARDED_FOR)) || parseIpAddress(req.socket.remoteAddress);
+    return LOCALHOST_IPS.includes(requestIpAddress) ? 'localhost' : requestIpAddress;
+}
+
+function parseRequestUserAgent(req) {
+    const body = req.body || { };
+    return body.agent || body.osVersion || req.get(rqh.USER_AGENT);
+}
+
+module.exports = {
+    extractToken,
+    getRequestResponseTime,
+    isRequestOfMethod,
+    parseRequest,
+};

package/lib/transports/WinstonEmailTransport.js

@@ -1,127 +1,127 @@
-// Copyright (c) 2026 by Beardon Services, Inc.
-
-const _ = require('lodash');
-const ansiHTML = require('ansi-html');
-const { createTransport } = require('nodemailer');
-const { hostname } = require('node:os');
-const { stripVTControlCharacters } = require('node:util');
-const Transport = require('winston-transport');
-
-/**
- * @class
- * @extends Transport
- */
-class WinstonEmailTransport extends Transport {
-
-    _messageOptions = { };
-    #useHtml = false;
-
-    /**
-     * @callback FilterFunction
-     * @param {Object} info
-     * @param {string} info.level
-     * @param {string} info.message
-     * @returns {boolean}
-     *
-     * @param {Object} [options={}] Options for this instance
-     * @param {Object} [options.transportOptions]
-     * @param {Object} [options.messageOptions]
-     * @param {string} [options.messageOptions.to]
-     * @param {string} [options.messageOptions.from]
-     * @param {string} [options.messageOptions.subject]
-     * @param {FilterFunction} [options.messageOptions.filter]
-     * @throws {Error} if options.messageOptions.to is empty or not set
-     */
-    constructor(options) {
-        options = options || { };
-        const { messageOptions = { }, transportOptions = { }, ...winstonOptions } = options;
-        super(winstonOptions);
-        if (!_.isString(messageOptions.to) || !messageOptions.to.length) {
-            throw new Error('WinstonEmailTransport requires \'to\' property');
-        }
-        /**
-         * @member {Object} _messageOptions
-         * @member {string} _messageOptions.to
-         * @member {string} _messageOptions.from
-         * @member {string} _messageOptions.subject
-         * @member {FilterFunction} _messageOptions.filter
-         * @private
-         */
-        this._messageOptions = {
-            ...messageOptions,
-            from: messageOptions.from ?? `winston@${ hostname() }`,
-            subject: messageOptions.subject ?? 'Winston Log',
-            filter: messageOptions.filter ?? (() => true),
-        };
-        this.name = 'WinstonEmailTransport';
-        /**
-         * @member {object}
-         * @private
-         */
-        this._transportOptions = transportOptions;
-        this.useHtml = winstonOptions.useHtml;
-    }
-
-    get useHtml() {
-        return this.#useHtml;
-    }
-
-    set useHtml(useHtml) {
-        if (_.isBoolean(useHtml)) this.#useHtml = useHtml;
-    }
-
-    /**
-     * Core logging method exposed to Winston
-     *
-     * @callback NextFunction
-     * @returns {void}
-     *
-     * @param {Object} info
-     * @param {string} info.level
-     * @param {string} info.message
-     * @param {NextFunction} callback
-     */
-    log(info, callback) {
-        try {
-            if (!this._messageOptions.filter(info)) {
-                setImmediate(callback);
-                return;
-            }
-            const { level, message, ...meta } = info;
-            const _level = stripVTControlCharacters(level);
-            const _message = stripVTControlCharacters(_.isObject(message) ? JSON.stringify(message) : message);
-            /** @type {Object.<string,*>} messageOptions */
-            const { filter, ...messageOptions } = { ...this._messageOptions }
-            const subject = messageOptions.subject.replace(/{{\s*level\s*}}/g, _level).replace(/{{\s*message\s*}}/g, `${ _message }`.split('\n')[ 0 ]);
-            const content = meta[ Symbol.for('message') ];
-            const html = ansiHTML(content);
-            const text = stripVTControlCharacters(content);
-            messageOptions.subject = subject;
-            if (this.useHtml) messageOptions.html = html;
-            messageOptions.text = text;
-            const transporter = createTransport(this._transportOptions);
-            transporter.sendMail(
-                messageOptions,
-                /**
-                 * @fires WinstonEmailTransport#error
-                 * @fires WinstonEmailTransport#logged
-                 * @param {?Error} err
-                 * @param {Object} info
-                 */
-                (err, info) => {
-                    setImmediate(callback);
-                    if (err) {
-                        this.emit('error', err);
-                    } else {
-                        this.emit('logged', info);
-                    }
-                }
-            );
-        } catch (e) {
-            console.error(e);
-            console.error('Email logging failed, moving on');
-        }
-    }
-}
-
-module.exports = WinstonEmailTransport;
+// Copyright (c) 2026 by Beardon Services, Inc.
+
+const _ = require('lodash');
+const ansiHTML = require('ansi-html');
+const { createTransport } = require('nodemailer');
+const { hostname } = require('node:os');
+const { stripVTControlCharacters } = require('node:util');
+const Transport = require('winston-transport');
+
+/**
+ * @class
+ * @extends Transport
+ */
+class WinstonEmailTransport extends Transport {
+
+    _messageOptions = { };
+    #useHtml = false;
+
+    /**
+     * @callback FilterFunction
+     * @param {Object} info
+     * @param {string} info.level
+     * @param {string} info.message
+     * @returns {boolean}
+     *
+     * @param {Object} [options={}] Options for this instance
+     * @param {Object} [options.transportOptions]
+     * @param {Object} [options.messageOptions]
+     * @param {string} [options.messageOptions.to]
+     * @param {string} [options.messageOptions.from]
+     * @param {string} [options.messageOptions.subject]
+     * @param {FilterFunction} [options.messageOptions.filter]
+     * @throws {Error} if options.messageOptions.to is empty or not set
+     */
+    constructor(options) {
+        options = options || { };
+        const { messageOptions = { }, transportOptions = { }, ...winstonOptions } = options;
+        super(winstonOptions);
+        if (!_.isString(messageOptions.to) || !messageOptions.to.length) {
+            throw new Error('WinstonEmailTransport requires \'to\' property');
+        }
+        /**
+         * @member {Object} _messageOptions
+         * @member {string} _messageOptions.to
+         * @member {string} _messageOptions.from
+         * @member {string} _messageOptions.subject
+         * @member {FilterFunction} _messageOptions.filter
+         * @private
+         */
+        this._messageOptions = {
+            ...messageOptions,
+            from: messageOptions.from ?? `winston@${ hostname() }`,
+            subject: messageOptions.subject ?? 'Winston Log',
+            filter: messageOptions.filter ?? (() => true),
+        };
+        this.name = 'WinstonEmailTransport';
+        /**
+         * @member {object}
+         * @private
+         */
+        this._transportOptions = transportOptions;
+        this.useHtml = winstonOptions.useHtml;
+    }
+
+    get useHtml() {
+        return this.#useHtml;
+    }
+
+    set useHtml(useHtml) {
+        if (_.isBoolean(useHtml)) this.#useHtml = useHtml;
+    }
+
+    /**
+     * Core logging method exposed to Winston
+     *
+     * @callback NextFunction
+     * @returns {void}
+     *
+     * @param {Object} info
+     * @param {string} info.level
+     * @param {string} info.message
+     * @param {NextFunction} callback
+     */
+    log(info, callback) {
+        try {
+            if (!this._messageOptions.filter(info)) {
+                setImmediate(callback);
+                return;
+            }
+            const { level, message, ...meta } = info;
+            const _level = stripVTControlCharacters(level);
+            const _message = stripVTControlCharacters(_.isObject(message) ? JSON.stringify(message) : message);
+            /** @type {Object.<string,*>} messageOptions */
+            const { filter, ...messageOptions } = { ...this._messageOptions }
+            const subject = messageOptions.subject.replace(/{{\s*level\s*}}/g, _level).replace(/{{\s*message\s*}}/g, `${ _message }`.split('\n')[ 0 ]);
+            const content = meta[ Symbol.for('message') ];
+            const html = ansiHTML(content);
+            const text = stripVTControlCharacters(content);
+            messageOptions.subject = subject;
+            if (this.useHtml) messageOptions.html = html;
+            messageOptions.text = text;
+            const transporter = createTransport(this._transportOptions);
+            transporter.sendMail(
+                messageOptions,
+                /**
+                 * @fires WinstonEmailTransport#error
+                 * @fires WinstonEmailTransport#logged
+                 * @param {?Error} err
+                 * @param {Object} info
+                 */
+                (err, info) => {
+                    setImmediate(callback);
+                    if (err) {
+                        this.emit('error', err);
+                    } else {
+                        this.emit('logged', info);
+                    }
+                }
+            );
+        } catch (e) {
+            console.error(e);
+            console.error('Email logging failed, moving on');
+        }
+    }
+}
+
+module.exports = WinstonEmailTransport;

package/lib/typedef.js

@@ -1,33 +1,33 @@
-/** @typedef {Object} app
- * @property {Object} locals
- * @property {ZeddemoreLoggerController|null} locals.logger
- */
-
-/**
- * @typedef {Object|null} Metadata
- * @property {String} [caller]
- * @property {String} [fullId]
- * @property {String} [id]
- * @property {String} [ip]
- * @property {String} [label]
- * @property {String} [prefix]
- * @property {Boolean} [raw]
- * @property {String} [subId]
- * @property {String} [target]
- * @property {String} [timestamp]
- * @property {String} [user]
- */
-
-/**
- * @typedef {Object|null} SequelizeModel
- * @property {Function} [create]
- * @property {Function} [findOne]
- */
-
-/**
- * @typedef {Object} user
- * @property {String} [ipAddress]
- * @property {String} [login]
- * @property {number|String} [logLevel]
- * @property {String} [username]
- */
+/** @typedef {Object} app
+ * @property {Object} locals
+ * @property {ZeddemoreLoggerController|null} locals.logger
+ */
+
+/**
+ * @typedef {Object|null} Metadata
+ * @property {String} [caller]
+ * @property {String} [fullId]
+ * @property {String} [id]
+ * @property {String} [ip]
+ * @property {String} [label]
+ * @property {String} [prefix]
+ * @property {Boolean} [raw]
+ * @property {String} [subId]
+ * @property {String} [target]
+ * @property {String} [timestamp]
+ * @property {String} [user]
+ */
+
+/**
+ * @typedef {Object|null} SequelizeModel
+ * @property {Function} [create]
+ * @property {Function} [findOne]
+ */
+
+/**
+ * @typedef {Object} user
+ * @property {String} [ipAddress]
+ * @property {String} [login]
+ * @property {number|String} [logLevel]
+ * @property {String} [username]
+ */

package/package.json

@@ -1,34 +1,41 @@
-{
-  "name": "zeddemore-logger",
-  "version": "2.3.1",
-  "description": "Node.js logger using Morgan and Winston for thread and caller info tracking",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/beardon/zeddemore-logger.git"
-  },
-  "keywords": [
-    "express",
-    "logger",
-    "morgan",
-    "winston"
-  ],
-  "author": "Aaron Bean <aaron.bean@beardon.com> (https://beardon.com)",
-  "license": "UNLICENSED",
-  "bugs": {
-    "url": "https://github.com/beardon/zeddemore-logger/issues"
-  },
-  "homepage": "https://github.com/beardon/zeddemore-logger#readme",
-  "main": "lib/zeddemore-logger.js",
-  "dependencies": {
-    "ansi-html": "^0.0.9",
-    "chalk": "^4.1.2",
-    "lodash": "^4.18.1",
-    "luxon": "^3.7.1",
-    "morgan": "^1.11.0",
-    "nodemailer": "^9.0.3",
-    "object-sizeof": "^2.6.5",
-    "uuid": "^11.1.1",
-    "winston": "^3.19.0",
-    "winston-transport": "^4.9.0"
-  }
-}
+{
+  "name": "zeddemore-logger",
+  "version": "2.3.3",
+  "publishConfig": {
+    "access": "public"
+  },
+  "description": "Node.js logger using Morgan and Winston for thread and caller info tracking",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/beardon/zeddemore-logger.git"
+  },
+  "keywords": [
+    "email",
+    "express",
+    "ldap",
+    "logger",
+    "morgan",
+    "nodejs",
+    "nodemailer",
+    "winston"
+  ],
+  "author": "Aaron Bean <aaron.bean@beardon.com> (https://beardon.com)",
+  "license": "UNLICENSED",
+  "bugs": {
+    "url": "https://github.com/beardon/zeddemore-logger/issues"
+  },
+  "homepage": "https://github.com/beardon/zeddemore-logger#readme",
+  "main": "lib/zeddemore-logger.js",
+  "dependencies": {
+    "ansi-html": "^0.0.9",
+    "chalk": "^4.1.2",
+    "lodash": "^4.18.1",
+    "luxon": "^3.7.1",
+    "morgan": "^1.11.0",
+    "nodemailer": "^9.0.3",
+    "object-sizeof": "^2.6.5",
+    "uuid": "^11.1.1",
+    "winston": "^3.19.0",
+    "winston-transport": "^4.9.0"
+  }
+}