Eve library

@aphrodite/broadcaster

Other

Revision 1

On this page

Broadcaster service for Aphrodite platform - handles stream creation, management, and broadcaster operations

TypeScript package. Built with tsc/tsup; consumed by other workspaces.

Remote guest boundary#

When DATABASE_URL and REMOTE_GUEST_SIGNALING_BASE_URL are configured, the service exposes no-store host registration, invitation exchange, operation, evidence, and release routes under /api/v1/streams/:streamId/remote-guests. Host authority comes from the existing authenticated stream-owner boundary. The guest receives a scoped Guest credential after a one-use invitation exchange; it is not treated as a general broadcaster identity.

The HTTP server also owns the exact /live-media/:tenantId/:streamId/remote-guests/:operationId WebSocket upgrade. It rejects query strings, unknown origins, missing/malformed protocols, reused tickets, path/operation mismatches, binary or schema-invalid messages, and a third participant. The one-use signaling capability travels in Sec-WebSocket-Protocol, while the selected protocol returned to the browser is the public protocol name. SDP and ICE remain in the bounded in-process two-participant hub and are never written to PostgreSQL.

Production signaling is intentionally a single-node one-host/one-guest browser path. TURN, SFU/MCU, multi-party, screen-share, native clients, and distributed signaling availability are not claimed.

Scripts#

Command Definition
pnpm build tsup
pnpm dev tsx watch src/index.ts
pnpm start node dist/index.js
pnpm test vitest run
pnpm test:watch vitest
pnpm test:coverage vitest run --coverage
pnpm typecheck tsc --noEmit
pnpm lint eslint src/
pnpm lint:fix eslint src/ --fix
pnpm format prettier --write src/
pnpm format:check prettier --check src/
pnpm clean rimraf dist coverage

Layout#

  • src/

Working on this package#

The fastest local loop is via Nx:

bash
pnpm nx test aphrodite-broadcaster
pnpm nx lint aphrodite-broadcaster
pnpm nx build aphrodite-broadcaster

When Nx is unhappy (usually because another worktree has duplicate project names), bypass it with the underlying tools from this directory:

bash
npx tsc --noEmit
npx vitest run

See the root README for monorepo-wide conventions (catalog deps, commit format, git workflow). See the Contributor Guide for the full PR workflow.