nestjs-swagger name attribute bug: https://github.com/nestjs/swagger/issues/2951

broken-output.json

{
  "schemas": {
    "LaneProvisioningTokenDto": {
        "type": "object",
        "properties": {
          "token": {
            "type": "string"
          },
          "lane": {
            "allOf": [
              {
                "$ref": "#/components/schemas/NestedLaneDto"
              }
            ]
          }
        },
        "required": [
          "token",
          "lane"
        ]
      }
  }
}

dto.ts

import { ApiProperty } from '@nestjs/swagger';
import { Type } from 'class-transformer';

export class NestedLaneDto {
  @ApiProperty({ type: String })
  id: string;

  @ApiProperty({ type: String, nullable: true })
  name: string | null;
}

export class LaneProvisioningTokenDto {
  @ApiProperty({ type: String })
  token: string;

  // NOTE: The presence of the `name` attribute changes the generated output, 
  //   despite the value being the same as the property name (e.g., the default)
  @ApiProperty({ type: NestedLaneDto, name: 'lane' })
  @Type(() => NestedLaneDto)
  lane: NestedLaneDto;
}

output-without-name-attribute.json

{
  "schemas": {
    "LaneProvisioningTokenDto": {
        "type": "object",
        "properties": {
          "token": {
            "type": "string"
          },
          "lane": {
            "$ref": "#/components/schemas/NestedLaneDto"
          }
        },
        "required": [
          "token",
          "lane"
        ]
      }
  }
}