Skip to content

docs(realtime): use table-scoped postgres channels - #43

Draft
tkkhq wants to merge 7 commits into
mainfrom
tkkhq/vol-1006-realtime-skill-docs
Draft

tkkhq wants to merge 7 commits into
mainfrom
tkkhq/vol-1006-realtime-skill-docs

Conversation

@tkkhq

@tkkhq tkkhq commented Sep 21, 2026

Copy link
Copy Markdown
Collaborator

Tracking

Why

  • current Hosting and SDK contracts scope each Postgres channel to one database, schema, and table
  • end-user subscriptions do not receive DELETE events, so active ordered views need bounded authoritative reconciliation
  • asynchronous setup and teardown must not leave stale rows, late state updates, or active clients

Summary

  • use one schema:table channel per table with an explicit databaseName
  • mark DELETE callbacks as service-key only and use immediate focus plus 30-second authoritative reconciliation for end-user views
  • coalesce INSERT and UPDATE events into confirming snapshots instead of applying event records to ordered, capped state
  • stop timers, ignore late work, and clean up React connect or subscribe failures before reporting them
  • execute the Markdown examples in a regression harness

Verification

  • node scripts/check-realtime-example.mjs

  • node scripts/check-skills.mjs

  • git diff --check

  • Prior CI

Copilot AI balanced review requested due to automatic review settings September 21, 2026 02:12

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

@tkkhq
tkkhq force-pushed the tkkhq/vol-1006-realtime-skill-docs branch from 3689be3 to 6fb2ec8 Compare September 22, 2026 23:04
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants