Document how to use Node SDK with ESM + loader

[lforst]

Generally, this is blocked by open-telemetry/opentelemetry-js#4547 (comment)

After that is resolved we should document how to use the esm loader. It should be the following:

• Node <=18.18.2: node --experimental-loader=@sentry/node/hook app.js
• Node >=18.19.0: node --import=@sentry/node/register app.js

[lilouartz]

How do I combine this with tsx?

[lilouartz]

tsx --import=@sentry/node/register app/bin/server.ts

is giving error:

Package subpath './register' is not defined by "exports"

[lilouartz]

node --import=@sentry/node/import --import tsx app/bin/server.ts

gives

node:internal/modules/run_main:125
    triggerUncaughtException(
    ^
SyntaxError [Error]: Unexpected token (12:14)

[lilouartz]

node --import tsx --import=@sentry/node/import app/bin/server.ts

gives

node:internal/modules/run_main:125
    triggerUncaughtException(
    ^
TypeError [ERR_INVALID_URL_SCHEME]: The URL must be of scheme file

[mydea]

I believe that tsx just transpiles to CJS, so it should work to just follow these docs: https://docs.sentry.io/platforms/javascript/guides/node/install/commonjs/

and ensure to import & run Sentry.init() before importing anything else.
If that does not work for you, please open a new issue with as much details as possible about your app setup - thank you!

[lilouartz]

#12111