Skip to content

Migration Guide: v7 to v8

This guide helps you migrate your application from @tsed/logger v7 to v8.

Major Changes

Appenders and Layouts Changes

In v7, Appenders and Layouts were bundled with the main @tsed/logger package and automatically installed. In v8, this has changed:

  • Appenders and Layouts are no longer exported from the root of the package (except for ColoredLayout)
  • You must explicitly import the layouts you want to use
  • StdoutAppender and StdErrAppender have been moved to a separate package: @tsed/logger-std
  • PatternLayout has been moved to its own package: @tsed/logger-pattern-layout

Importing Layouts

typescript
// v7 (old)
import { JsonLayout } from "@tsed/logger";

// v8 (new)
import "@tsed/logger/layouts/JsonLayout.js";

Using StdoutAppender and StdErrAppender

First, install the new package:

bash
npm install @tsed/logger-std
# or
yarn add @tsed/logger-std

Then import and use it:

typescript
// v7 (old)
import { StdoutAppender, StdErrAppender } from "@tsed/logger";

// v8 (new)
import { StdoutAppender, StdErrAppender } from "@tsed/logger-std";

Using PatternLayout

First, install the new package:

bash
npm install @tsed/logger-pattern-layout
# or
yarn add @tsed/logger-pattern-layout

Then import and use it:

typescript
// v7 (old)
import { PatternLayout } from "@tsed/logger";

// v8 (new)
import { PatternLayout } from "@tsed/logger-pattern-layout";

Migration Steps

1. Update Dependencies

Update your package.json to use the latest version:

json
{
  "dependencies": {
    "@tsed/logger": "^8.0.0"
  }
}

Released under the MIT License.