fix(javascript): keep comments and jsdoc in build

[shortcuts]

🧭 What and Why

🎟 JIRA Ticket: https://algolia.atlassian.net/browse/APIC-400

Changes included:

Comments and JSDoc were removed in the build, which makes the autocompletion poorer.

Comments

This was just an option to change in the tsconfig.json. There's a huge impact on the size of the common package, but types needs to be checked due to many duplicates, so it's fine in the meantime.

JSDoc

TS Playground for reproduction

At build time, methods returned in an object loses JSDoc, but does not when inlined in the object. I've went with this solution for now as it's the one if the smallest footprint but alternatives are:

• Keeping this solution until a fix on the TS side
• Using classes, which would change (forever, as we don't want to break everything multiple times) the usage of our client
  • I don't see the need as this solution work, but if you have arguments please share them

Opened an issue on TypeScript: microsoft/TypeScript#48495

🧪 Test

CI :D

[netlify]

✅ Deploy Preview for api-clients-automation canceled.

Name	Link
🔨 Latest commit	54fe8d0
🔍 Latest deploy log	https://app.netlify.com/sites/api-clients-automation/deploys/62456a244293390008f88ddd

[algolia-bot]

✗ The generated branch has been deleted.

If the PR has been merged, you can check the generated code on the generated/main branch.

[Haroenv]

looks good, This PR should possibly be linked from an issue on typescript mentioning that the comments get removed even though they shouldn't?

[eunjae-lee]

I think it makes sense. But as Haroen mentioned, do you have a link to the GH issue in TS? It'd be good to tag the issue in this PR, so that we can have a reference to update it in the future when TS rolls out the fix.

[shortcuts]

This PR should possibly be linked from an issue on typescript mentioning that the comments get removed even though they shouldn't?

do you have a link to the GH issue in TS?

I did not had time to open the GH issue yet, will check their open ones and open it if it does not exists

[shortcuts]

I've created an issue @eunjae-lee @Haroenv microsoft/TypeScript#48495

If you have changes to propose to it, lmk!