dankopayk

danpayk

one_eye_jackei

@payk/nestjs-winston

    for (var p in m) if (!exports.hasOwnProperty(p)) exports[p] = m[p];

Object.defineProperty(exports, "__esModule", { value: true });

__export(require("./winston.constants"));

  "description": "Winston for Nest has never been this easy",

"author": "Dan Shapir <danshapir89@gmail.com>",

    "lint": "tslint --project tsconfig.json",

    "test-juint": "mocha --opts .mocharc --reporter mocha-junit-reporter",

    "@nestjs/platform-express": "^6.6.7",

    "@nestjs/platform-express": "^6.7.2",

    "@nestjs/common": "^5.0.0 || ^6.6.0",

  "homepage": "https://github.com/pay-k/nestjs-winston#readme",

    "url": "git+https://github.com/pay-k/nestjs-winston.git"

    "url": "https://github.com/pay-k/nestjs-winston/issues"

Winston for <a href="https://github.com/nestjs/nest">NestJS</a> has never been this easy!

This package not only wraps winston into a Nest Module like other packages, it also creates a Nest LoggerService, so you can keep using the default NestJS logger, which enjoying winston.

But that's not all, it also takes those great things from the NestJS Logger. It adds the context into the winston meta (so it can later be search and indexed in your ELK/Datadog).

Another great feature is the winston formatter add to the class that in local mode allows easy and readable logs to the console.

Import `WinstonModule` and use the `forRoot()` method to configure it. This method accepts the same options object as [`createLogger()`](https://github.com/winstonjs/winston#usage) function from the winston package:

import { WinstonModule } from 'nest-winston';

> **Caveats**: because the way Nest works, you can't inject dependencies exported from the root module itself (using `exports`). If you use `forRootAsync()` and need to inject a service, that service must be either imported using the `imports` options or exported from a [global module](https://docs.nestjs.com/modules#global-modules).

Maybe you need to asynchronously pass your module options, for example when you need a configuration service. In such case, use the `forRootAsync()` method, returning an options object from the `useFactory` method:

The factory might be async, can inject dependencies with `inject` option and import other modules using the `imports` option.

## Use as the main Nest Logger (preferred way)

If you want to use winston logger across the whole app, including bootstrapping and error handling, use the following:

import { WINSTON_MODULE_NEST_PROVIDER } from '@payk/nestjs-winston';

  const app = await NestFactory.create(AppModule);

  app.useLogger(app.get(WINSTON_MODULE_NEST_PROVIDER));

import { WinstonLogger } from '@payk/nestjs-winston';

  private readonly logger = new Logger(ClassName.name);

  private readonly logger = new WinstonLogger(ClassName.name);

`WinstonModule` is a global module, it will be available in all you feature modules.

A provider will then be exposed to allow easy injection.

import { Controller, Inject, Logger } from '@nestjs/common';

import { WINSTON_MODULE_PROVIDER } from '@payk/nestjs-winston';

  constructor(@Inject(WINSTON_MODULE_PROVIDER) private readonly logger: Logger) { }

  // To send metadata we need to pass the message inside an object

  // since the nestjs logger doesn't support meta by default

  this.logger.log({ message: 'Your message here', { meta: 'data', goes: 'here'}, moreMeta});

  // If we just want a message, it can be passed as it

  this.logger.log('Only a message if no metadata is needed')

To allow a better visibility a unique formatter is provided

import { winstonConsoleFormat } from '@payk/nestjs-winston';

  defaultMeta: { service: 'user-service' },

                winston.format.timestamp(),

                winston.format.colorize({ all: true }),

		export * from './winston.module';
		export * from './winston.constants';
		export * from './winston.format';
		export * from './winston.logger';

		{
		"name": "@payk/nestjs-winston",
		"version": "1.1.6",
		"version": "1.2.0",
		"license": "MIT",
		@@ -31,11 +31,11 @@ "description": "Winston for Nest has never been this easy",
		"devDependencies": {
		"@nestjs/common": "^6.6.7",
		"@nestjs/core": "^6.6.7",
		"@nestjs/platform-express": "^6.6.7",
		"@nestjs/testing": "^6.6.7",
		"@types/chai": "^4.2.2",
		"@nestjs/common": "^6.7.2",
		"@nestjs/core": "^6.7.2",
		"@nestjs/platform-express": "^6.7.2",
		"@nestjs/testing": "^6.7.2",
		"@types/chai": "^4.2.3",
		"@types/mocha": "^5.2.7",
		"mocha-junit-reporter": "^1.23.1",
		"chai": "^4.2.0",
		"mocha": "^6.2.0",
		"mocha-junit-reporter": "^1.23.1",
		"reflect-metadata": "^0.1.13",
		@@ -45,3 +45,3 @@ "rimraf": "^3.0.0",
		"source-map-support": "^0.5.13",
		"ts-node": "^8.3.0",
		"ts-node": "^8.4.1",
		"tslint": "^5.20.0",
		@@ -48,0 +48,0 @@ "typescript": "^3.6.3"

		@@ -88,32 +88,9 @@ <h1 align="center">
		```typescript
		import { WinstonLogger } from '@payk/nestjs-winston';

		export class ClassName {
		private readonly logger = new Logger(ClassName.name);
		private readonly logger = new WinstonLogger(ClassName.name);
		}
		```

		## Injection usage

		`WinstonModule` is a global module, it will be available in all you feature modules.
		A provider will then be exposed to allow easy injection.

		```typescript
		import { Controller, Inject, Logger } from '@nestjs/common';
		import { WINSTON_MODULE_PROVIDER } from '@payk/nestjs-winston';

		@Controller('cats')
		export class CatsController {
		constructor(@Inject(WINSTON_MODULE_PROVIDER) private readonly logger: Logger) { }
		}

		@Get()
		public getCats() {
		// To send metadata we need to pass the message inside an object
		// since the nestjs logger doesn't support meta by default
		let moreMeta = 3333;
		this.logger.log({ message: 'Your message here', { meta: 'data', goes: 'here'}, moreMeta});

		// If we just want a message, it can be passed as it
		this.logger.log('Only a message if no metadata is needed')
		}
		```
		## Nest Winston Formatter
		@@ -120,0 +97,0 @@ To allow a better visibility a unique formatter is provided

Improved metrics

Worsened metrics

		@@ -9,1 +9,2 @@ "use strict";
		__export(require("./winston.format"));
		__export(require("./winston.logger"));