apps/
HTTP server
Authenticated HTTP API for scenes, rooms, invites, files, and private library items.
Routes live under /scenes, /library, and /room, all behind authentication,
plus health and account endpoints. Rooms also issue the presence tickets the browser
uses to open its WebSocket connection. Shared room checks live in the route utils;
the write path itself lives in backend-common.
What it owns
- Scene CRUD and guest import
- Room CRUD, presence tickets, files, and scene patching
- Room invitations, join codes, and member management
- Private library item CRUD
Files
File list and purposes from the folder README.
| File | Purpose |
|---|---|
src/app.ts | Route mounting and middleware wiring. |
src/middleware.ts | Request authentication. |
src/invitationRateLimit.ts | Invite request rate limits. |
src/routes/scenes.ts | Scene routes. |
src/routes/rooms.ts | Room routes. |
src/routes/roomInvites.ts | Invite, join-code, and member management routes. |
src/routes/roomRouteUtils.ts | Shared room authorization, join-code, and rate-limit helpers. |
src/routes/library.ts | Library routes. |
src/routes/guestImport.ts | Guest import routes. |
src/services/ | Reserved folder holding only its README for now. |
Dependencies
| Library | Version range | Why it is used here |
|---|---|---|
| CORS | 2.8.5 | Enables cross-origin requests from the web app. |
| Express | ^5.2.1 | HTTP server behind the scenes, rooms, and library APIs. |
| Zod | ^4.6.4 | Validates guest-import payloads. |
Development and tooling (4)
| Library | Version range | Why it is used here |
|---|---|---|
| @types/cors | 2.8.19 | Type declarations for CORS. |
| @types/express | ^5.0.6 | Type declarations for Express. |
| @types/node | 26.4.1 | Type declarations for Node.js built-ins. |
| tsx | ^4.23.13 | Runs and watches TypeScript sources for development and tests. |
Dependencies as of commit b0026d9.
Internal packages used
Laying out http-server folder…
BrowserAPIRealtimeCacheDatabaseShareddurableephemeral
Talks to
Sources: apps/http-server/README.md, apps/http-server/src/README.md, apps/http-server/src/routes/README.md, apps/http-server/src/routes/scenes.ts, apps/http-server/src/routes/rooms.ts, apps/http-server/src/routes/roomInvites.ts (documented at commit b0026d9)