Skip to content

NodeJS runtime steps#6

Closed
chrispangg wants to merge 1 commit intomainfrom
cursor/nodejs-runtime-steps-fef2
Closed

NodeJS runtime steps#6
chrispangg wants to merge 1 commit intomainfrom
cursor/nodejs-runtime-steps-fef2

Conversation

@chrispangg
Copy link
Copy Markdown
Owner

Add comprehensive Node.js runtime support documentation and examples.

The library was already compatible with Node.js 18+ through its built CommonJS and ESM outputs, but existing documentation and package.json implied a Bun-only requirement. This PR clarifies full Node.js compatibility and provides extensive guides, examples, and updated documentation to reflect this.


Open in Cursor Open in Web

The library has always been compatible with Node.js 18+ through its
built CommonJS and ESM outputs. This change clarifies and documents
that compatibility for users who prefer Node.js over Bun.

Changes:
- Added complete Node.js usage guide (docs/NODEJS-USAGE.md)
  * Installation instructions for npm/yarn/pnpm
  * TypeScript configuration for Node.js
  * Production deployment patterns
  * Framework integrations (Express, Next.js)
  * Docker deployment guide
  * Troubleshooting section
  * Feature compatibility matrix

- Added quick reference card (NODEJS-QUICKREF.md)
  * 30-second setup guide
  * Common commands and code snippets
  * Quick troubleshooting table

- Created Node.js-specific examples
  * examples/nodejs-quickstart.ts - Basic usage
  * examples/nodejs-streaming.ts - Streaming events
  * examples/nodejs-express-api.ts - Express.js integration
  * examples/README.md - How to run examples

- Updated main documentation
  * README.md - Feature both Node.js and Bun equally
  * docs/site/handbook/get-started/index.mdx - Multi-runtime instructions
  * Fixed misleading 'Bun required' messaging

- Updated package.json
  * Changed engines from 'bun: >=1.0.0' to 'node: >=18.0.0'
  * Added 'nodejs' keyword for npm discoverability

No source code changes were required - the library was already compatible!
Users can now confidently use this package with Node.js 18+ or Bun.

Co-authored-by: Chris Pang <chrispangg@users.noreply.github.com>
@cursor
Copy link
Copy Markdown

cursor Bot commented Feb 5, 2026

Cursor Agent can help with this pull request. Just @cursor in comments and I'll start working on changes in this branch.
Learn more about Cursor Agents

@vercel
Copy link
Copy Markdown

vercel Bot commented Feb 5, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
ai-sdk-deepagent Ready Ready Preview, Comment Feb 5, 2026 9:44am

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants