chore(openapi): build script to setup ESM/CJS module exports + various fixes

[gfortaine]

1 PR to rule them all 😉 cc @schnerd @shun-shobon @ericlewis :

° Changelog

• bugfix to deal with spaces in paths

• fix: Add auth scheme

• enable support for CommonJS and ESModules in one package. The main features being :

  • replacing require("../package.json").version with a prebuild script

  • using tsc-multi to rewrite all import paths with .mjs extension

[gfortaine]

Related openai/openai-node#45

[ctjlewis]

Isomorphic __dirname is tricky but can be done, you have to make guarantees about the file structure but it can be achieved with a polyfill and added as a banner to Esbuild. See: https://github.com/tsmodule/tsmodule/blob/master/src/specification/shim.ts

Nice work on this also.

[schnerd]

Really liking this change overall. Left a few comments and still need to do some testing on the final package before proceeding, but overall this is looking promising.

[schnerd]

How is this different than @vercel/fetch? Would prefer not to use this fork if we can avoid it.

[gfortaine]

@vercel/fetch doesn't work with nodejs native fetch at the time of writing. A PR has been made : vercel/fetch#76

[schnerd]

This new typescript generator is also listed as "Experimental" – do you know what's experimental about it? I'm a little hesitant to fully switch our production SDK over to something that is still marked as experimental. Have other well-known projects started using this generator?

[gfortaine]

This new typescript generator is also listed as "Experimental" – do you know what's experimental about it? I'm a little hesitant to fully switch our production SDK over to something that is still marked as experimental. Have other well-known projects started using this generator?

• Node.js Datadog API Client

• HubSpot API NodeJS

• OneSignal NodeJS Client SDK

• PandaDoc Node client SDK

[gfortaine]

This new typescript generator is also listed as "Experimental" – do you know what's experimental about it? I'm a little hesitant to fully switch our production SDK over to something that is still marked as experimental. Have other well-known projects started using this generator?

By the way, we tried with typescript-fetch in the first place. However, it seems that there is a nasty bug when using oneOf

[logankilpatrick]

Now that we have the updated NodeSDK, I am going to close this PR. Please let me know if there's further discussion needed here and thanks for diving in on this originally!