wrinkle

Simple console and file logging utility.

[2.0.0] - 2025-10-19

Changed

• Updated internal #safelySet() logic to better support object types (e.g., utilInspectConfig).
• object options are now shallow-merged with defaults instead of fully replaced.
• Improved runtime type validation for all config options.

Potential Breaking Changes

• Where you previously had to use JSON.stringify(object), this may no longer work as expected

Install

npm install wrinkle --save
// or with yarn
yarn add wrinkle

Usage

const Wrinkle = require('wrinkle');

const logger = new Wrinkle({ toFile: true, logLevel: 'debug' });

logger.debug('Entered spinCogs().');
logger.info('All cogs started successfully.');
logger.warn('Something is smoldering, somewhere. . .');
logger.error('The flames, oh the flames!');

// no longer need to use json.stringify, objects will be viewable by default
logger.debug('cog', { rotations: 9372, screeches: 1941 });

Full Setup

Make a file (logger.js or otherwise) in the directory of your choosing. Export the wrinkle logger.

const Wrinkle = require('wrinkle'); // or with mjs: import Wrinkle from 'wrinkle';
const logger = new Wrinkle({
  toFile: true,
  logLevel: process.env.LOG_LEVEL,
  fileDateTimeFormat: 'LL-dd-yyyy_H-m',
  maxLogFileSizeBytes: 5000,
});

module.exports = logger;

Import it where needed

const logger = require('<pathToLogger>/logger');

// do logging
logger.debug('Res body logging middleware says:,', body);

Other Usage

// ...

// will create the write stream, if the stream has ended.
logger.create();

// destroy the write stream
logger.destroy();

// end the write stream
logger.end();

Configuration

| Name | Default | Description | | --------------------- | --------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- | | logLevel | production: 'error', development: 'debug' | Logs this level and 'up.' One of: 'debug', 'info', 'warn', 'error'. | | toFile | boolean | Whether or not to write logs to a file. | | logDir | ./logs | Log directory location. | | fileDateTimeFormat | LL-dd-yyyy (daily) | Uses date-fns format(). | | logDateTimeFormat | LL-dd-yyyy HH:mm:ss.SS (02-03-2023 01:07:33.49) | Uses date-fns format(). | | maxLogFileSizeBytes | No max size | Max log file size in bytes. e.g. 5000000 (5mb) | | unsafeMode | boolean | True if you would like to set a log directory location 'above' the current directory. | | extension | .log | Change the file extension. | | maxLogFileAge | null | <num>:<timeType> One of: 'month|months', 'week|weeks', 'day|days', 'hour|hours', 'minute|minutes', 'second|seconds. e.g. '1:day' or '2:weeks' |