@rsc-kit/mcp 0.28.0 → 0.29.0

package/guides/deployment.md

@@ -162,7 +162,7 @@ stacks on top of it.
 
 ## Streams and idle timeouts
 
-An `events()` route and the [`refreshOn`](/guides/sections#refreshing-on-a-change-from-outside)
+An `events()` route and the [`refreshOn`](/guides/live-data)
 stream hold a connection open and are quiet most of the time. Anything in
 front that closes a quiet connection - the server's idle timeout, a proxy's
 read timeout - would cut them, so each sends a keepalive line every **eight
@@ -189,7 +189,7 @@ one as another, so one leaking does not hand out the rest.
 | Variable | What it protects | Who needs it | Read by |
 | --- | --- | --- | --- |
 | `RSC_HOST_CALL_SECRET` | calls between the renderer and a Go or Laravel backend | an app with a backend - required | the renderer **and** the backend |
-| `RSC_SIGNING_SECRET` | the names a page hands a tab for [`refreshOn`](/guides/sections#refreshing-on-a-change-from-outside) | an app that uses `refreshOn` - required in production | the renderer |
+| `RSC_SIGNING_SECRET` | the names a page hands a tab for [`refreshOn`](/guides/live-data) | an app that uses `refreshOn` - required in production | the renderer |
 | `RSC_ACTION_ENCRYPTION_KEY` | values a server action sends through the browser, [across a deploy](#server-actions-across-a-deploy) | optional | the renderer, from the build |
 
 `bun create rsc-kit` and `rsc-kit init` generate the first two into `.env` for

package/guides/go.md

@@ -272,21 +272,52 @@ reg.Changed(ctx, "team:"+teamID+":repos")
 Every open tab showing the section refreshes it, the moment the webhook
 lands, with nothing polling. The registry answers `__rsc.changed` by holding
 the renderer's ask until a version moves - woken at once by a `Changed` in
-this process, checking the store every `rsckit.TagsPoll` (1s) for one made
+this process, checking the store every `rsckit.ChangedPoll` (1s) for one made
 by another instance.
 
-Versions live in a `TagStore`. The default is in memory, which is one
+Versions live in a `VersionStore`. The default is in memory, which is one
 instance; with more than one, a webhook lands on whichever instance the
 balancer picked, so give them all the same store:
 
 ```go
-// CREATE TABLE rsc_tags (name TEXT PRIMARY KEY, version BIGINT NOT NULL)
-reg.Names(&rsckit.SQLTags{DB: db, Placeholder: rsckit.Dollar})   // Postgres; nil Placeholder is "?"
+// CREATE TABLE rsc_versions (name TEXT PRIMARY KEY, version BIGINT NOT NULL)
+reg.Versions(&rsckit.SQLVersions{DB: db, Placeholder: rsckit.Dollar})   // Postgres; nil Placeholder is "?"
 ```
 
+To hear another instance's change at once instead of within the second - and
+stop reading the store while nothing changes - set `Notify` so each bump
+sends a `pg_notify`, and run a listener with `WakeOn`. The adapter depends on
+no driver, so the listener is yours; with pgx:
+
+```go
+reg.Versions(&rsckit.SQLVersions{DB: db, Placeholder: rsckit.Dollar, Notify: "rsc_versions"})
+
+reg.WakeOn(ctx, func(ctx context.Context, connected, wake func()) error {
+	conn, err := pool.Acquire(ctx)
+	if err != nil {
+		return err
+	}
+	defer conn.Release()
+	if _, err := conn.Exec(ctx, "LISTEN rsc_versions"); err != nil {
+		return err
+	}
+	connected()
+	for {
+		if _, err := conn.Conn().WaitForNotification(ctx); err != nil {
+			return err
+		}
+		wake()
+	}
+})
+```
+
+A listener that drops runs again with backoff, and the poll covers the gap.
+Through PgBouncer in transaction mode, connect the listener straight to
+Postgres. One instance needs none of this.
+
 Anything with a `Bump` and a `Versions` fits. Set `RSC_SIGNING_SECRET` for the renderer, the same on every instance:
 it signs the names a page hands the tab, and is not the host-call secret.
-Generating and rotating both: [Secrets](/hosts/deployment#secrets). [Sections](/guides/sections#refreshing-on-a-change-from-outside)
+Generating and rotating both: [Secrets](/hosts/deployment#secrets). [Sections](/guides/live-data)
 has the whole picture.
 
 ## Production

package/guides/index.json

@@ -124,6 +124,11 @@
     "title": "Laravel",
     "description": "React Server Components in front, a Laravel application behind them."
   },
+  {
+    "slug": "live-data",
+    "title": "Live data",
+    "description": "Keep what a page shows current as the data changes - refreshOn, events, polling."
+  },
   {
     "slug": "mcp",
     "title": "Working with an AI agent",

package/guides/laravel.md

@@ -368,7 +368,7 @@ that talks to its database.
 **Keeping versions in a table** (`RSC_VERSIONS=database`) is for when you
 want them in the database rather than the cache: pruned on a schedule with
 `rsc:prune-versions`, or written by something outside Laravel - a Go service,
-a worker in another language - through the [shared table](/guides/sections#the-table).
+a worker in another language - through the [shared table](/guides/live-data#the-table).
 Laravel still answers the renderer from it; nothing else changes.
 
 ```sh