Uploaded image for project: 'Node.js Driver'
  1. Node.js Driver
  2. NODE-4106

Investigate NODE-4105 - JSDoc comments get compiled into multi-line comments in BSON

    • Type: Icon: Task Task
    • Resolution: Done
    • Priority: Icon: Minor - P4 Minor - P4
    • None
    • Affects Version/s: None
    • Component/s: None
    • 1
    • Not Needed

      NODE-4105 Description

      What problem are you facing? 

      In the BSON package, some JSDoc comments in certain properties are compiled into the d.ts file as regular JS multi-line comments (starting with /*), which causes things like deprecation notices to not get correctly compiled and thus not show up in a Typescript-powered editor like VS Code.

      What driver and relevant dependency versions are you using?

      MongoDB 4.4.1

      BSON 4.6.1

      Steps to reproduce?

      An example of an incorrectly compiled comment can be found at ObjectId#generationTime, which should be marked as deprecated but it isn't because its JSDoc comment was compiled as a multi-line comment. I'm not sure what could've caused this as the comment is correctly typed in the TS file

            Assignee:
            bailey.pearson@mongodb.com Bailey Pearson
            Reporter:
            dbeng-pm-bot PM Bot
            Bailey Pearson
            Votes:
            0 Vote for this issue
            Watchers:
            1 Start watching this issue

              Created:
              Updated:
              Resolved: