Neverending Programming Mistakes


    1.0.12 • Public • Published


    A JSON-based serializer for @node-ts/bus that deserializes into strong types. This is a preferred alternative to the default serializer that does not support this.


    Install this package and its dependencies

    npm i reflect-metadata class-transformer @node-ts/bus-class-serializer

    Configure your bus to use the serializer:

    import { ClassSerializer } from '@node-ts/bus-class-serializer'
    await Bus
      .withSerializer(new ClassSerializer())

    Note This package relies on class transformer that requires reflect-metadata to be installed and called at the start of your application before any other imports. Please follow their guides on how to configure your app and contracts to serialize correctly.


    Consider the following message:

    class Update extends Command {
      constructor (
        readonly date: Date
      ) {}

    When serialized/deserialized this will become a plain object with no date functions on the property:

    const receivedMessage = JSON.parse(JSON.stringify(new Update(new Date())))
    receivedMessage.getDate() // Error - getDate is undefined

    Although we could manually fix and assign the date in the handle, this is tedious and adds unecessary code. Instead messages should be holistically deserialized to strong type at the boundaries of the system.

    Using this serializer, a minor change to the contract is made:

    class Update extends Command {
      @Type(() => Date) readonly date: Date
      constructor (
        date: Date
      ) { = date

    When this is deserialized, the date should be an actual Date:

    const serializer = new ClassSerializer()
    const receivedMessage = serializer.deserialize(serializer.serialize(new Update(new Date())), Update)
    receivedMessage.getDate() // Success - a date value


    npm i @node-ts/bus-class-serializer

    DownloadsWeekly Downloads






    Unpacked Size

    10.4 kB

    Total Files


    Last publish


    • adenhertog