Documentation
¶
Overview ¶
Package main implements example-api, a reference example of the ghsync zero-duplication consumer pattern. It is not a production service.
The mirror's public tables remain the only entity backing store. The process persists only its pkg/streamclient cursor and retains entity JSON only in a bounded recent-event ring used for SSE catch-up. Each subscriber also has a bounded queue. A subscriber that cannot keep up receives a resync advisory and is disconnected instead of backpressuring the single process tailer. Fresh snapshots are materialized only after enforcing 100k-entity/64MiB limits, with at most two materializations resident concurrently. A snapshot above either limit receives an explicit snapshot_limit_exceeded advisory; entities are never silently truncated. A deployment would connect with the ghsync_consumer-grade role described in db/CONTRACT.md, or another role with the same public-contract grants.
Source Files