@justair/justair-library 6.5.0 → 6.6.0

package/README.md

@@ -32,6 +32,28 @@ npm set //registry.npmjs.org/:_authToken=YOUR_ACCESS_TOKEN
 import { Monitors, Measurements, createLoggerInstance, Database } from '@justair/justair-library';
 ```
 
+## Logging
+
+The logger created by `createLoggerInstance` reads its threshold from the `LOG_LEVEL` environment
+variable, applied to both the console and Datadog transports. When `LOG_LEVEL` is unset it defaults
+to `info`, so `logger.debug(...)` calls are dropped in steady state and surface only when you opt in.
+
+Valid levels (Winston syslog): `emerg`, `alert`, `crit`, `error`, `warning`, `notice`, `info`,
+`debug`. An unset or unrecognized value falls back to `info` (a `warning` is logged for an invalid
+value rather than crashing the service).
+
+```bash
+# Locally: surface all debug output
+LOG_LEVEL=debug npm run dev
+
+# Deployed (Heroku): set the config var, then restart the dyno
+heroku config:set LOG_LEVEL=debug -a <app-name>
+
+# Cloud Run / GKE / Lambda: set LOG_LEVEL=debug in the service's environment, then redeploy
+```
+
+Unset `LOG_LEVEL` (or set it back to `info`) to return to normal volume.
+
 ## Constants
 
 The library exposes two entry points — one for Node.js services (models + constants) and one

package/dist/config/logger.d.ts

@@ -7,6 +7,13 @@ declare class CustomLogger {
     DATADOG_API_KEY: any;
     APPLICATION_NAME: any;
     logger: import("winston").Logger;
+    _resolveLogLevel(): {
+        level: string;
+        invalidValue?: undefined;
+    } | {
+        level: string;
+        invalidValue: string;
+    };
     _createLogger(): import("winston").Logger;
     getLogger(): import("winston").Logger;
     _getServiceMetadata(): {

package/dist/config/logger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/config/logger.js"],"names":[],"mappings":";AAGA;IACE;;;OAIC;IAHC,qBAAsC;IACtC,sBAAwC;IACxC,iCAAkC;IAGpC,0CA2BC;IAED,sCAEC;IAED;;;;;;;;;;;;;;MAgBC;IAED,uCAMC;IAED,sDAOC;IAED,uDAYC;IAED,wCAOC;IAED,4BAsCC;CACF"}
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/config/logger.js"],"names":[],"mappings":";AAGA;IACE;;;OAIC;IAHC,qBAAsC;IACtC,sBAAwC;IACxC,iCAAkC;IAKpC;;;;;;MASC;IAED,0CAuCC;IAED,sCAEC;IAED;;;;;;;;;;;;;;MAgBC;IAED,uCAMC;IAED,sDAOC;IAED,uDAYC;IAED,wCAOC;IAED,4BAsCC;CACF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@justair/justair-library",
-  "version": "6.5.0",
+  "version": "6.6.0",
   "description": "JustAir Internal Library",
   "main": "src/index.js",
   "type": "module",

package/src/config/logger.js

@@ -8,6 +8,19 @@ class CustomLogger {
     this.logger = this._createLogger();
   }
 
+  // Resolve the logger threshold from LOG_LEVEL. Falls back to 'info' (Winston's
+  // default) when unset or invalid so a typo can't crash every consuming service.
+  _resolveLogLevel() {
+    const requested = process.env.LOG_LEVEL;
+    if (!requested) {
+      return { level: 'info' };
+    }
+    if (Object.prototype.hasOwnProperty.call(config.syslog.levels, requested)) {
+      return { level: requested };
+    }
+    return { level: 'info', invalidValue: requested };
+  }
+
   _createLogger() {
     const httpTransportOptions = {
       host: 'http-intake.logs.us5.datadoghq.com',
@@ -15,7 +28,10 @@ class CustomLogger {
       ssl: true
     };
 
-  return createLogger({
+  const { level, invalidValue } = this._resolveLogLevel();
+
+  const logger = createLogger({
+      level,
       levels: config.syslog.levels,
       exitOnError: false,
       format: combine(
@@ -35,6 +51,15 @@ class CustomLogger {
           new transports.Http(httpTransportOptions)
       ]
   });
+
+  if (invalidValue) {
+      logger.warning('Ignoring invalid LOG_LEVEL, defaulting to info', {
+          invalidValue,
+          validLevels: Object.keys(config.syslog.levels)
+      });
+  }
+
+  return logger;
   }
 
   getLogger() {