class-transformer

NOTE: This version fixes a security vulnerability allowing denial of service attacks with a specially crafted request payload. Please update as soon as possible.

Breaking Changes

Exported functions has been renamed Some of the exported functions has been renamed to better reflect what they are doing.

• classToPlain -> instanceToPlain
• plainToClass -> plainToInstance
• classToClass -> instanceToInstance

Fixed

• prevent unhandled error in plaintToclass when union-type member is undefined
• fixed a scenario when a specially crafted JS object would be parsed to Array

Changed

• various dev-dependencies updated

Breaking Changes

See the breaking changes from 0.3.2 release. It was accidentally released as patch version.

Added

• add option to ignore unset properties
• group information is exposed in the @Transform handler
• transformation options are exposed in the @Transform handler

Fixed

• fixed TypeError when discriminator.subTypes is not defined

Changed

• various dev-dependencies has been updated

Breaking Changes

Signature change for @Transform decorator From this version the @Transform decorator receives the transformation parameters in a a wrapper object. You need to destructure the values you are interested in.

Old way:

@Transform((value, obj, type) => /* Do some stuff with value here. */)

New way with wrapper object:

@Transform(({ value, key, obj, type }) => /* Do some stuff with value here. */)

Added

• exposeDefaultValues option has been added, when enabled properties will use their default values when no value is present for the property
• the name of the currently transformed parameter is exposed in the @Transform decorator

Fixed

• fixed an issue with transforming Map (#319)
• fixed an issue with sourcemap generation (#472)

Changed

• various internal refactors
• various changes to the project tooling
• various dev-dependencies has been updated

Added

• table of content added to readme

Changed

• moved from Mocha to Jest
• added Prettier for code formatting
• added Eslint for linting
• updated CI configuration
• removed some unused dev dependencies
• updated dependencies to latest version

Fixed

• circular dependency fixed
• dev dependencies removed from package.json before publishing (no more security warnings)
• transformer order is deterministic now (#231)
• fix prototype pollution issue (#367)
• various fixes in documentation

build: bump version to 0.2.3

build: bump version to 0.2.2

docs: add changelog for 0.2.1

build: bump verstion to 0.2.0

Fixed

• improve MetadataStorage perf by changing from Arrays to ES6 Maps by @sheiidan
• fixed getAncestor issue with unknown nested properties by @247GradLabs

Fixed

• objects with null prototype are converted properly now
• objects with unknown non primitive properties are converted properly now
• corrected a typo in the README.md
• fixed the deserialize example in the README.md

Added

• added TransformClassToPlain and TransformClassToClass decorators

Added

• renamed library from constructor-utils to class-transformer
• completely renamed most of names
• renamed all main methods: plainToConstructor now is plainToClass and constructorToPlain is classToPlain, etc.
• plainToConstructorArray method removed - now plainToClass handles it
• @Skip() decorator renamed to @Exclude()
• added @Expose decorator
• added lot of new options: groups, versioning, custom names, etc.
• methods and getters that should be exposed must be decorated with @Expose decorator
• added excludedPrefix to class transform options that allows exclude properties that start with one of the given prefix