Migrate API to Bun/TypeScript with unified server

- Use Hono for internal routing
- Use hono/aws-lambda for AWS Lambda compatibility
- Rewrite middleware using Hono middleware pattern
- Run on /api/v2 in dev
- Build and pack with Bun
- Remove old build scripts and dependencies
- Update Makefile and GitHub Actions to use Bun

Author: mbklein

.github/workflows/test-node.yml

@@ -16,18 +16,14 @@ jobs:
       AWS_SECRET_ACCESS_KEY: ci
     steps:
       - uses: actions/checkout@v3
-      - uses: actions/setup-node@v3
-        with:
-          node-version: 24.x
-          cache: "npm"
-          cache-dependency-path: "api/package-lock.json"
-      - run: npm ci
+      - uses: oven-sh/setup-bun@v2
+      - run: bun install
       - name: Check code style
-        run: npm run lint && npm run prettier
+        run: bun run lint && bun run prettier
       - name: Run tests
-        run: npm run test:coverage
+        run: bun run test:coverage
       - name: Validate OpenAPI spec
-        run: npm run validate-spec
+        run: bun run validate-spec
   test-mcp:
     runs-on: ubuntu-latest
     defaults:

.husky/pre-commit

@@ -1,4 +1,4 @@
 #!/usr/bin/env sh
 . "$(dirname -- "$0")/_/husky.sh"
-cd api && npm run lint && npm run prettier && cd -
+cd api && bun run lint && bun run prettier && cd -
 cd chat/src && uv run ruff check . && cd -

.tool-versions

@@ -3,3 +3,4 @@ java        corretto-19.0.1.10.1
 aws-sam-cli 1.148.0
 python      3.12.2
 uv          0.9.5
+bun         1.3.14

Makefile

@@ -36,36 +36,19 @@ help:
 
 ./chat/dependencies/requirements.txt: ./chat/pyproject.toml
 	cd chat && uv export --format requirements-txt --no-hashes > dependencies/requirements.txt
-api: ./api/template.yaml ./api/src/package-lock.json $(wildcard ./api/src/**/*.js)
+api: ./api/template.yaml ./api/bun.lockb $(wildcard ./api/src/**/*.ts)
 chat: ./chat/template.yaml ./chat/dependencies/requirements.txt $(wildcard ./chat/src/**/*.py)
 av-download: ./av-download/template.yaml ./av-download/lambdas/package-lock.json $(wildcard ./av-download/lambdas/**/*.js)
 .aws-sam/build.toml: ./template.yaml api chat av-download
-	sed -Ei.orig 's/"dependencies"/"devDependencies"/' api/src/package.json
-	cp api/src/package-lock.json api/src/package-lock.json.orig
-	cd api/src && npm i --package-lock-only && cd -
-	for d in . api av-download chat docs ; do \
-		sed -Ei.orig 's/^(\s+)#\*\s/\1/' $$d/template.yaml; \
-	done
-
-	-sam build --cached --parallel
-
-	for d in . api av-download chat docs ; do \
-		mv $$d/template.yaml.orig $$d/template.yaml; \
-	done
-	mv api/src/package.json.orig api/src/package.json
-	mv api/src/package-lock.json.orig api/src/package-lock.json
+	@sed -Ei.orig 's/^(\s+)#\*\s/\1/' chat/template.yaml; \
+	sam build --cached --parallel
+	@mv chat/template.yaml.orig chat/template.yaml
 av-download/layers/ffmpeg/bin/ffmpeg:
 	mkdir -p av-download/layers/ffmpeg/bin ;\
 	curl -L https://johnvansickle.com/ffmpeg/releases/ffmpeg-release-amd64-static.tar.xz | \
 	tar -C av-download/layers/ffmpeg/bin -xJ --strip-components=1 --wildcards '*/ffmpeg' '*/ffprobe'
 deps-api:
-	cd api/src ;\
-	npm list >/dev/null 2>&1 ;\
-	src_deps=$$? ;\
-	cd .. ;\
-	npm list >/dev/null 2>&1 ;\
-	dev_deps=$$? ;\
-	test $$src_deps -eq 0 -a $$dev_deps -eq 0 || npm ci
+	bun install --cwd api
 deps-av-download:
 	cd av-download/lambdas ;\
 	npm list >/dev/null 2>&1 || npm ci
@@ -102,10 +85,9 @@ validate:
 	cfn-lint template.yaml **/template.yaml --ignore-checks E3510 W1028 W8001
 serve-http: deps-node
 	@printf '\033[0;31mWARNING: Serving only the local HTTP API. The chat websocket API is not available in local mode.\033[0m\n'
-	rm -rf .aws-sam
-	sam local start-api -t api/template.yaml --env-vars $$PWD/env.json --host 0.0.0.0 --log-file dc-api.log ${SERVE_PARAMS}
-serve-https: SERVE_PARAMS = --port 3002 --ssl-cert-file $$HOME/.dev_cert/dev.rdc.cert.pem --ssl-key-file $$HOME/.dev_cert/dev.rdc.key.pem
-serve-https: serve-http
+	bun run --cwd api -i dev
+serve-https:
+	PORT=3002 HOST=0.0.0.0 SSL_CERT=$$HOME/.dev_cert/dev.rdc.cert.pem SSL_KEY=$$HOME/.dev_cert/dev.rdc.key.pem make serve-http
 serve: serve-https
 start-with-step: deps-node env.json
 	export AWS_DEFAULT_REGION=us-east-1 ;\

api/.claude/settings.local.json

@@ -0,0 +1,8 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(bun run *)",
+      "Bash(bun test *)"
+    ]
+  }
+}

api/.mocharc.js

@@ -0,0 +1,2 @@
+build-apiFunction:
+	bun build --target node --outdir $(ARTIFACTS_DIR) --entry-naming [name].mjs --sourcemap=linked src/index.ts 

api/Makefile

@@ -0,0 +1,2 @@
+[test]
+include = ["test/**/*.test.ts"]