Skip to content

armgit / macro

Public Imported from GitHub
0

Macro is a unified workspace for teams: email, chat, docs, tasks, agents, calls, and CRM — @-linked together with shared AI memory.

1.9 KB
Raw Blame

sync_router

What it is

Document sync routing library hosted by DSS at /sync/ws. Each authenticated WebSocket owns a router and its downstream connections; there is no separate service, Redis subscriber, or Pulumi stack.

Start here

  • src/domain/router.rs: document subscriptions, bounded queues, route epochs.
  • src/domain/ports.rs: socket delivery and downstream lifecycle contracts.
  • src/outbound/do_downstream.rs: scoped-token WebSocket dialing and frame pumps.
  • src/session.rs: socket-owned task tracking, cancellation, and local delivery adapter.

Scope

  • Owns routing and cancellation, not document state or authorization.
  • services/sync-service validates each document-scoped token and owns CRDT state.
  • Browser envelopes are generated from services/sync-service/bebop/schema.bop.

Checks

  • cargo test -p sync_router (no live external services required).
  • Session tests exercise real local downstream sockets, isolation, backpressure, cancellation, and byte budgets.
  • After dependency changes, regenerate and check cargo x deps.

Gotchas

  • Preserve inner chunk framing byte-for-byte. A full queue must close its route or socket and trigger resync; never drop a chunk and continue the stream.
  • Inbound messages are capped at one MiB; downstream queues share an eight MiB budget per session, retained through the write. Never increase count limits without checking the byte bound.
  • Select the Rustls provider explicitly in the downstream connector; workspace features enable both providers, so automatic selection panics on wss://.
  • Dropping a downstream route cancels its task, including pending dials/writes.
  • Every DSS replica handles only its own sockets. No distributed route ownership or singleton deployment is required.
  • Deploy the updated DSS before enabling PostHog sync-via-gateway. VITE_SYNC_VIA_GATEWAY=true opts local clients in.