[DO NOT MERGE] Code snippet execution (Node.js)

[alexcasalboni]

About the changes

This is an experiment to evaluate the idea of extracting major code snippets into independent files and run them as a test suite.

I tried an alternative approach with runme, but unfortunately it has too many markdown compatibility issues with Fern and I had to give up the idea of automatically identifying code snippets from the Markdown files. Besides the Fern incompatibility, the other major issue with the runme approach was that most snippets require some setup (like importing libraries), so we'd end up with too many weird hacks.

This is why I went for the "extract all the snippets into executable files" approach.

Pros:

• Easier to integrate setup sections
• Easier to target specific SDK versions over time (just a dependency in package.json for Node)
• Easier to inject environment variables (a simple .env file) - although many snippets will need to be updated

Cons:

• There's no automatic discovery - we need to extract every snippet into a new file and then reference it with a <Code> block
• No built-in runner - we need to define ad-hoc test suites for each language/framework

Important files

• new "sdks/examples/node" folder with a few Node.js SDK code snippets (with its own package.json to address a specific SDK version), plus a simple Vite test suite to run each file as a standalone test
• new GitHub Action that runs the Node.js test suite as part of CI

Discussion points

This is not as low-effort as I thought initially:

• extracting each individual snippet into its own file (or into a sequence of snippets) requires quite a bit of work
• each programming language will require its own test suite, with different conventions, etc.
• in CI, we should run all these different test suites
• there are many other snippets that are not SDK-specific, so we might want to move the "examples" folder somewhere else, with only language-specific sub-folders, so that it's easier to run everything in CI

Feel free to take a look, run the existing Vite test suite locally, and close the PR if you think this is not worth it :)

[github-actions]

🌿 Preview your docs: https://unleash-preview-6417cf60-ad64-4b87-abd2-42b6b871e37b.docs.buildwithfern.com

[github-actions]

🌿 Preview your docs: https://unleash-preview-0b07b41b-d0a8-43fd-8128-fdb06c794887.docs.buildwithfern.com

[github-actions]

🌿 Preview your docs: https://unleash-preview-928fc474-2076-40dd-988b-210b8f5de6f0.docs.buildwithfern.com