winston - npm Package Versions

v3.2.1 / 2019-01-29

UNBOUND PROTOTYPE AD INFINITUM EDITION

• #[1579], (@indexzero) Fallback to the "root" instance always created by createLogger for level convenience methods (e.g. .info(), .silly()). (Fixes [#1577]).
• [#1539], (@indexzero) Assume message is the empty string when level-helper methods are invoked with no arguments (Fixed [#1501]).
• [#1583], (@kibertoad) Add typings for defaultMeta (Fixes [#1582])
• [#1586], (@kibertoad) Update dependencies.

v3.2.0 / 2019-01-26

SORRY IT TOO SO LONG EDITION

NOTE: this was our first release using Github Projects. See the 3.2.0 Release Project.

New Features!

• [#1471], (@kibertoad) Implement child loggers.
• [#1462], (@drazisil) Add handleRejection support.
  • [#1555], (@DABH) Add fixes from [#1355] to unhandled rejection handler.
• [#1418], (@mfrisbey) Precompile ES6 syntax before publishing to npm.
  • [#1533], (@kibertoad) Update to Babel 7.
• [#1562], (@indexzero) [fix] Better handling of new Error(string) throughout the pipeline(s). (Fixes [#1338], [#1486]).

Bug Fixes

• [#1355], (@DABH) Fix issues with ExceptionHandler (Fixes [#1289]).
• [#1463], (@SerayaEryn) Bubble transport warn events up to logger in addition to errors.
• [#1480], [#1503], (@SerayaEryn) File tailrolling fix.
• [#1483], (@soldair) Assign log levels to un-bound functions.
• [#1513], (@TilaTheHun0) Set maxListeners for Console transport.
• [#1521], (@jamesbechet) Fix Transform from readable-stream using CRA.
• [#1434], (@Kouzukii) Fixes logger.query function (regression from 3.0.0)
• [#1526], (@pixtron) Log file without .gz for tailable (Fixes [#1525]).
• [#1559], (@eubnara) Fix typo related to exitOnError.
• [#1556], (@adoyle-h) Support to create log directory if it doesn't exist for FileTransport.

New splat behavior

• [#1552], (@indexzero) Consistent handling of meta with (and without) interpolation in winston and logform.
• [#1499], (@DABH) Provide all of SPLAT to formats (Fixes [#1485]).
• [#1485], (@mpabst) Fixing off-by-one when using both meta and splat.

Previously splat would have added a meta property for any additional info[SPLAT] beyond the expected number of tokens.

As of logform@2.0.0, format.splat assumes additional splat paramters (aka "metas") are objects and merges enumerable properties into the info. e.g. BE ADVISED previous "metas" that were not objects will very likely lead to odd behavior. e.g.

const { createLogger, format, transports } = require('winston');
const { splat } = format;
const { MESSAGE, LEVEL, SPLAT } = require('triple-beam');

const logger = createLogger({
  format: format.combine(
    format.splat(),
    format.json()
  ),
  transports: [new transports.Console()]
});

// Expects two tokens, but four splat parameters provided.
logger.info(
  'Let us %s for %j',   // message
  'objects',           // used for %s
  { label: 'sure' },   // used for %j
  'lol', ['ok', 'why'] // Multiple additional meta values
);

// winston < 3.2.0 && logform@1.x behavior:
// Added "meta" property.
//
// { level: 'info',
//   message: 'Let us objects for {"label":"sure"}',
//   meta: ['lol', ['ok', 'why']],
//   [Symbol(level)]: 'info',
//   [Symbol(message)]: 'Let us %s for %j',
//   [Symbol(splat)]: [ 'objects', { label: 'sure' } ] }

// winston >= 3.2.0 && logform@2.x behavior: Enumerable properties
// assigned into `info`. Since **strings and Arrays only have NUMERIC
// enumerable properties we get this behavior!**
//
// { '0': 'ok',
//   '1': 'why',
//   '2': 'l',
//   level: 'info',
//   message: 'Let us objects for {"label":"sure"}',
//   [Symbol(level)]: 'info',
//   [Symbol(message)]: 'Let us %s for %j',
//   [Symbol(splat)]: [ 'objects', { label: 'sure' } ] }

Maintenance & Documentation

• Documentation Updates
  • [#1410], (@hakanostrom) Add docs reference to transport for Cloudant.
  • [#1467], (@SeryaEryn) Add fast-file-rotate transport to transport.md.
  • [#1488], (@adamcohen) Fix multi logger documentation.
  • [#1531], (@mapleeit) Add links to transports.
  • [#1548], (@ejmartin504) Fix README.md for awaiting logs.
  • [#1554], (@indexzero) Document the solution to [#1486] as by design.
  • Other small improvements: [#1509].
• Improved TypeScript support
  • [#1470], (@jd-carroll) Export all transport options (Fixes [#1469]).
  • [#1474], (@jd-carroll) Correct import to avoid conflict (Fixed [#1472]).
  • [#1546], (@alewiahmed) Add consoleWarnLevels field to the ConsoleTransportOptions interface type definition.
  • [#1557], (@negezor) Add missing child() method.
• Dependency management
  • [#1560], (@kibertoad) Update dependencies.
  • [#1512], (@SerayaEryn) Add node@11 and disallow failures on node@10.
  • [#1516], (@SerayaEryn) Update readable-stream to v3.0.6.
  • [#1534], (@kibertoad) Update @types/node, nyc, and through2.

v3.1.0 / 2018-08-22

RELEASES ON A PLANE EDITION

• Minor TypeScript fixes [#1362], [#1395], [#1440]
• Fix minor typos [#1359], [#1363], [#1372], [#1378], [#1390]
• [#1373], (@revik): Add consoleWarnLevels property to console transport options for console.warn browser support.
• [#1394], (@bzoz): Fix tests on Windows.
• [#1447], (@dboshardy): Support transport name option to override default names for built-in transports.
• [#1420], (@ledbit): Fix file rotation with tailing: true (Fixes [#1450], [#1194]).
• [#1352], (@lutovich): Add isLevelEnabled(string) & isXXXEnabled() to Logger class.
• Dependency management
  • Regenerate package-lock.json.
  • Upgrade to colors@^1.3.2 (Fixes [#1439]).
  • Upgrade to logform@^1.9.1.
  • Upgrade to diagnostics@^1.1.1.
  • Upgrade to @types/node@^10.9.3.
  • Upgrade to assume@^2.1.0.
  • Upgrade to hock@^1.3.3.
  • Upgrade to mocha@^5.2.0.
  • Upgrade to nyc@^13.0.1.
  • Upgrade to split2@^3.0.0.

v3.0.0 / 2018-06-12

GET IN THE CHOPPA EDITION

• [#1332], (@DABH): logger.debug is sent to stderr (Fixed [#1024])
• [#1328], (@ChrisAlderson): Logger level doesn't update transports level (Fixes [#1191]).
• [#1356], (@indexzero) Move splat functionality into logform. (Fixes [#1298]).
• [#1340], (@indexzero): Check log.length when evaluating "legacyness" of transports (Fixes [#1280]).
• [#1346], (@indexzero): Implement _final from Node.js streams. (Related to winston-transport#24, Fixes [#1250]).
• [#1347], (@indexzero): Wrap calls to format.transform with try / catch (Fixes [#1261]).
• [#1357], (@indexzero): Remove paddings as we have no use for it in the current API.
• [TODO]: REMAINS OPEN, NO PR (Fixes [#1289])
• Documentation
  • [#1301], (@westonpace) Cleaned up some of the documentation on colorize to address concerns in [#1095].
  • First pass at a heavy refactor of docs/transports.md.
• Dependency management
  • Regenerate package-lock.json.
  • Upgrade to logform@^1.9.0.

v3.0.0-rc6 / 2018-05-30

T-MINUS 6-DAY TO WINSTON@3 EDITION

• Document that we are pushing for a June 5th, 2018 release of winston@3.0.0
• [#1287], (@DABH) Added types for Typescript.
  • [#1335] Typescript: silent is boolean.
  • [#1323] Add level method to default logger.
• [#1286], (@ChrisAlderson) Migrate codebase to ES6
  • [#1324], (@ChrisAlderson) Fix regression introduced by ES6 migration for exception handling.
  • [#1333], (@ChrisAlderson) Fix removing all loggers from a container.
• [#1291], [#1294], [#1318], (@indexzero, @ChrisAlderson, @mempf) Improvements to File transport core functionality. Fixes [#1194].
• [#1311], (@ChrisAlderson) Add eol option to Stream transport.
• [#1297], (@ChrisAlderson) Move winston.config to triple-beam. Expose for backwards compatibility.
• [#1320], (@ChrisAlderson) Enhance tests to run on Windows.
• Internal project maintenance
  • Bump to winston-transport@4.0.0 which may cause incompatibilities if your custom transport does not explicitly require winston-transport itself.
  • [#1292], (@ChrisAlderson) Add node v10 to TravisCI build matrix.
  • [#1296], (@indexzero) Improve UPGRADE-3.0.md. Add Github Issue Template.
  • Remove "npm run report" in favor of reports being automatically generate.
  • Update logform, triple-beam, and winston-transport to latest.

Special thanks to our newest winston core team member – @ChrisAlderson for helping make winston@3.0.0 a reality next week!

v3.0.0-rc5 / 2018-04-20

UNOFFICIAL NATIONAL HOLIDAY EDITION

• [#1281] Use Buffer.alloc and Buffer.from instead of new Buffer.
• Better browser support
  • [#1142] Move common tailFile to a separate file
  • [#1279] Use feature detection to be safer for browser usage.
• MOAR Docs!
  • Document that we are pushing for a May 29th, 2018 release of winston@3.0.0
  • Add David Hyde as official contributor.
  • [#1278] Final Draft of Upgrade Guide in UPGRADE-3.0.md
  • Merge Roadmap from 3.0.0.md into CONTRIBUTING.md and other improvements to CONTRIBUTING.md
• Improve & expand examples
  • [#1175] Add more copy about printf formats based on issue feedback.
  • [#1134] Add sampleto document timestamps more clearly as an example.
  • [#1273] Add example using multiple formats.
  • [#1250] Add an example illustrating the "finish" event for AWS Lambda scenarios.
  • Use simple format to better show that humanReadableUnhandledException is now the default message format.
  • Add example to illustrate that example code from winston-transport README.md is correct.
• Update devDependencies
  • Bump assume to ^2.0.1.
  • Bump winston-compat to ^0.1.1.