feat: Server-side API

.devcontainer/devcontainer-lock.json

@@ -0,0 +1,14 @@
+{
+  "features": {
+    "ghcr.io/devcontainers/features/node:2": {
+      "version": "2.0.0",
+      "resolved": "ghcr.io/devcontainers/features/node@sha256:fedd4c11f7adfb64283b578dddc7da906728daa25fa293351c9d913231acf12f",
+      "integrity": "sha256:fedd4c11f7adfb64283b578dddc7da906728daa25fa293351c9d913231acf12f"
+    },
+    "ghcr.io/tailscale/codespace/tailscale:1.0.8": {
+      "version": "1.0.8",
+      "resolved": "ghcr.io/tailscale/codespace/tailscale@sha256:fa5ce7ca298e7ab95842fef99e107a01b090b8ca8a687789220f3f3c887ccdb2",
+      "integrity": "sha256:fa5ce7ca298e7ab95842fef99e107a01b090b8ca8a687789220f3f3c887ccdb2"
+    }
+  }
+}

.devcontainer/devcontainer.json

@@ -9,7 +9,8 @@
 			"version": "lts",
 			"pnpmVersion": "latest",
 			"nvmVersion": "latest"
-		}
+		},
+		"ghcr.io/tailscale/codespace/tailscale:1.0.8": {}
 	},
 	"workspaceFolder": "/mogomogo",
 	"workspaceMount": "source=${localWorkspaceFolder},target=${containerWorkspaceFolder},type=bind,consistency=cached",
@@ -19,20 +20,20 @@
 			"extensions": [
 				"EditorConfig.EditorConfig@0.18.1",
 				"GitHub.vscode-github-actions@0.31.0",
-				"ms-vscode-remote.remote-containers@0.444.0",
-				"oxc.oxc-vscode@1.47.0",
-				"timonwong.shellcheck@0.38.6",
-				"TypeScriptTeam.native-preview@0.20260207.1",
-				"vitest.explorer@1.42.1"
+				"ms-vscode-remote.remote-containers@0.449.0",
+				"oxc.oxc-vscode@1.50.0",
+				"timonwong.shellcheck@0.39.2",
+				"TypeScriptTeam.native-preview@0.20260313.1",
+				"vitest.explorer@1.48.1"
 			],
 			"settings": {
 				"editor.defaultFormatter": "oxc.oxc-vscode",
+				"js/ts.experimental.useTsgo": true,
 				"json.schemaDownload.trustedDomains": {
 					"https://docs.renovatebot.com/": true
 				},
 				"oxc.configPath": ".oxfmtrc.json",
-				"oxc.typeAware": true,
-				"typescript.experimental.useTsgo": true
+				"oxc.typeAware": true
 			}
 		}
 	}

.env.example

@@ -5,3 +5,7 @@
 # Permissions:
 #   - Calls Write
 # CLOUDFLARE_CALLS_API_TOKEN=
+
+# Cloudflare SFU app
+CLOUDFLARE_SFU_APP_ID=
+CLOUDFLARE_SFU_APP_API_TOKEN=

.oxfmtrc.json

@@ -1,5 +1,9 @@
 {
 	"$schema": "./node_modules/oxfmt/configuration_schema.json",
+	"ignorePatterns": [
+		".devcontainer/devcontainer-lock.json",
+		"src/server/web-rtc-server-provider/provider/cf-realtime/api-client/schema.ts"
+	],
 	"useTabs": true,
 	"sortImports": {
 		"groups": [
@@ -12,5 +16,6 @@
 			"unknown"
 		],
 		"partitionByComment": true
-	}
+	},
+	"embeddedLanguageFormatting": "off"
 }

.oxlintrc.json

@@ -27,5 +27,5 @@
 		"builtin": true
 	},
 	"globals": {},
-	"ignorePatterns": []
+	"ignorePatterns": ["src/server/web-rtc-server-provider/provider/cf-realtime/api-client/schema.ts"]
 }

.vscode/tasks.json

@@ -43,9 +43,23 @@
 			"script": "test",
 			"problemMatcher": []
 		},
+		{
+			"label": "codegen:realtime-api",
+			"detail": "Generate types for the Realtime API schema",
+			"type": "npm",
+			"script": "codegen:realtime-api",
+			"problemMatcher": []
+		},
+		{
+			"label": "codegen:realtime-api:check",
+			"detail": "Check if generated types match existing types for the Realtime API schema",
+			"type": "npm",
+			"script": "codegen:realtime-api:check",
+			"problemMatcher": []
+		},
 		{
 			"label": "check",
-			"detail": "Run all checks: format, lint, typecheck, and tests without fixing",
+			"detail": "Run all checks: format, lint, typecheck, tests, and ensure generated codes are up to date without fixing",
 			"type": "npm",
 			"script": "check",
 			"problemMatcher": []

package.json

@@ -18,14 +18,19 @@
 		"typecheck": "tsgo --build",
 		"test": "vitest watch",
 		"test:run": "vitest run",
-		"check": "pnpm format:dry && pnpm lint && pnpm typecheck && pnpm test:run"
+		"codegen:realtime-api": "openapi-typescript https://developers.cloudflare.com/realtime/static/calls-api-2024-05-21.yaml --output ./src/server/web-rtc-server-provider/provider/cf-realtime/api-client/schema.ts",
+		"codegen:realtime-api:check": "pnpm codegen:realtime-api --check",
+		"check": "pnpm format:dry && pnpm lint && pnpm typecheck && pnpm test:run && pnpm codegen:realtime-api:check"
 	},
 	"dependencies": {
 		"cloudflare": "^6.0.0"
 	},
 	"devDependencies": {
+		"@hono/node-server": "^1.19.11",
 		"@types/node": "24 - 24.13",
-		"@typescript/native-preview": "7.0.0-dev.20260512.1",
+		"@typescript/native-preview": "7.0.0-dev.20260315.1",
+		"hono": "^4.12.7",
+		"openapi-typescript": "^7.13.0",
 		"oxfmt": "^0.49.0",
 		"oxlint": "^1.42.0",
 		"oxlint-tsgolint": "^0.22.0",