Add support for Bun

Author: jamescmartinez

.github/workflows/ci.yaml

@@ -33,3 +33,25 @@ jobs:
       - uses: codecov/codecov-action@v5
         with:
           token: ${{ secrets.CODECOV_TOKEN }}
+  bun-tests:
+    runs-on: ubuntu-latest
+    services:
+      postgres:
+        image: postgres
+        env:
+          POSTGRES_PASSWORD: postgres
+        ports:
+          - 5432:5432
+        options: >-
+          --health-cmd pg_isready
+          --health-interval 10s
+          --health-timeout 5s
+          --health-retries 5
+    steps:
+      - uses: actions/checkout@v6
+      - uses: actions/setup-node@v6
+        with:
+          node-version-file: package.json
+      - run: npm ci
+      - uses: oven-sh/setup-bun@v2
+      - run: bun run test

packages/docs/docs/cli.mdx

@@ -17,6 +17,10 @@ npm install -D @openworkflow/cli
 pnpm add -D @openworkflow/cli
 ```
 
+```bash bun
+bun add -D @openworkflow/cli
+```
+
 </CodeGroup>
 
 ## Commands
@@ -34,6 +38,10 @@ npx @openworkflow/cli init
 pnpx @openworkflow/cli init
 ```
 
+```bash bun
+bunx @openworkflow/cli init
+```
+
 </CodeGroup>
 
 This interactive command:
@@ -59,6 +67,10 @@ npx @openworkflow/cli worker start
 pnpx @openworkflow/cli worker start
 ```
 
+```bash bun
+bunx @openworkflow/cli worker start
+```
+
 </CodeGroup>
 
 Options:
@@ -77,6 +89,11 @@ npx @openworkflow/cli worker start --concurrency 4
 pnpx @openworkflow/cli worker start --concurrency 4
 ```
 
+```bash bun
+# Run with 4 concurrent workflows
+bunx @openworkflow/cli worker start --concurrency 4
+```
+
 </CodeGroup>
 
 The worker:
@@ -100,6 +117,10 @@ npx @openworkflow/cli dashboard
 pnpx @openworkflow/cli dashboard
 ```
 
+```bash bun
+bunx @openworkflow/cli dashboard
+```
+
 </CodeGroup>
 
 This launches the OpenWorkflow dashboard on `http://localhost:3000`. See
@@ -118,6 +139,10 @@ npx @openworkflow/cli doctor
 pnpx @openworkflow/cli doctor
 ```
 
+```bash bun
+bunx @openworkflow/cli doctor
+```
+
 </CodeGroup>
 
 This command checks:
@@ -164,6 +189,10 @@ npx @openworkflow/cli --version
 pnpx @openworkflow/cli --version
 ```
 
+```bash bun
+bunx @openworkflow/cli --version
+```
+
 </CodeGroup>
 
 ### `--help`
@@ -183,6 +212,12 @@ pnpx @openworkflow/cli worker --help
 pnpx @openworkflow/cli worker start --help
 ```
 
+```bash bun
+bunx @openworkflow/cli --help
+bunx @openworkflow/cli worker --help
+bunx @openworkflow/cli worker start --help
+```
+
 </CodeGroup>
 
 ## Environment Variables

packages/docs/docs/configuration.mdx

@@ -17,6 +17,10 @@ npm i openworkflow postgres
 pnpm add openworkflow postgres
 ```
 
+```bash bun
+bun add openworkflow postgres
+```
+
 </CodeGroup>
 
 ## Config File

packages/docs/docs/core-concepts.mdx

@@ -71,6 +71,10 @@ npx @openworkflow/cli worker start
 pnpx @openworkflow/cli worker start
 ```
 
+```bash bun
+bunx @openworkflow/cli worker start
+```
+
 </CodeGroup>
 
 ## How it Works

packages/docs/docs/dashboard.mdx

@@ -17,6 +17,10 @@ npx @openworkflow/cli dashboard
 pnpx @openworkflow/cli dashboard
 ```
 
+```bash bun
+bunx @openworkflow/cli dashboard
+```
+
 </CodeGroup>
 
 The dashboard starts on `http://localhost:3000`.

packages/docs/docs/migration-v6.mdx

@@ -36,6 +36,10 @@ npm uninstall @openworkflow/backend-postgres @openworkflow/backend-sqlite
 pnpm remove @openworkflow/backend-postgres @openworkflow/backend-sqlite
 ```
 
+```bash bun
+bun remove @openworkflow/backend-postgres @openworkflow/backend-sqlite
+```
+
 </CodeGroup>
 
 If you're using PostgreSQL, install the `postgres` driver directly:
@@ -49,6 +53,10 @@ npm install postgres
 pnpm add postgres
 ```
 
+```bash bun
+bun add postgres
+```
+
 </CodeGroup>
 
 Your `package.json` should now look like:
@@ -79,6 +87,10 @@ npx @openworkflow/cli init
 pnpx @openworkflow/cli init
 ```
 
+```bash bun
+bunx @openworkflow/cli init
+```
+
 </CodeGroup>
 
 The CLI now generates code with the new import paths automatically.

packages/docs/docs/namespaces.mdx

@@ -79,6 +79,15 @@ NAMESPACE=staging pnpm run worker
 NAMESPACE=production pnpm run worker
 ```
 
+```bash bun
+# Development
+NAMESPACE=development bun run worker
+# Staging
+NAMESPACE=staging bun run worker
+# Production
+NAMESPACE=production bun run worker
+```
+
 </CodeGroup>
 
 ### Multi-Tenancy

packages/docs/docs/postgres.mdx

@@ -20,6 +20,10 @@ npm i openworkflow postgres
 pnpm add openworkflow postgres
 ```
 
+```bash bun
+bun add openworkflow postgres
+```
+
 </CodeGroup>
 
 ## Setup

packages/docs/docs/production.mdx

@@ -45,6 +45,10 @@ npx @openworkflow/cli dashboard
 pnpx @openworkflow/cli dashboard
 ```
 
+```bash bun
+bunx @openworkflow/cli dashboard
+```
+
 </CodeGroup>
 
 - Review step attempts and errors for failed workflows

packages/docs/docs/quickstart.mdx

@@ -5,7 +5,7 @@ description: Get up and running with OpenWorkflow
 
 ## Prerequisites
 
-- Node.js
+- Node.js or Bun
 - PostgreSQL (and/or SQLite)
 
 ## 1. Install
@@ -21,6 +21,10 @@ npx @openworkflow/cli init
 pnpx @openworkflow/cli init
 ```
 
+```bash bun
+bunx @openworkflow/cli init
+```
+
 </CodeGroup>
 
 The CLI will help you set up OpenWorkflow, create your `openworkflow.config.ts`,
@@ -37,6 +41,10 @@ npx @openworkflow/cli worker start
 pnpx @openworkflow/cli worker start
 ```
 
+```bash bun
+bunx @openworkflow/cli worker start
+```
+
 </CodeGroup>
 
 This starts the worker using `openworkflow.config.{ts,js}` and auto-loads
@@ -59,6 +67,10 @@ pnpx tsx openworkflow/hello-world.run.ts
 node openworkflow/hello-world.run.js
 ```
 
+```bash bun
+bun openworkflow/hello-world.run.ts
+```
+
 </CodeGroup>
 
 This script runs the `helloWorld` workflow and waits for it to complete.
@@ -81,6 +93,10 @@ npx @openworkflow/cli dashboard
 pnpx @openworkflow/cli dashboard
 ```
 
+```bash bun
+bunx @openworkflow/cli dashboard
+```
+
 </CodeGroup>
 
 The dashboard provides a UI for monitoring workflow runs, viewing step details,