naro-cli 0.20.0 → 0.21.0

package/README.md

@@ -211,6 +211,13 @@ naro storage mv naro://docs/a.pdf naro://docs/old/a.pdf         Inside one bucke
 naro storage rm naro://avatars/u1/old.png [--recursive]   (asks first)
 naro storage rm naro://avatars/u1/ --recursive   Everything under u1/; written u1, an object u1 too
 
+naro realtime [status]             Naro Realtime: on or not, published tables, connections now
+naro realtime enable               Turn Realtime on: the project's hub, bound to its backend
+naro realtime tables [list]        The tables whose Data API writes reach subscribers
+naro realtime tables add <table>…  Publish tables' changes (within about 10 seconds)
+naro realtime tables remove <table>… [--yes]
+                                   Stop publishing tables' changes (asks first)
+
 naro promote <deployment-id> [--to <environment>]   Publish a build to production, or to an environment (0.20.0); says rebuild or reupload first, then asks
 naro rollback [deployment-id]      Back to the previous production build
 ```
@@ -846,6 +853,60 @@ An `--update-check` you give replaces the default: without
 
 ## Release notes
 
+### 0.21.0
+
+0.20.0 went out on 2026-10-26 without these.
+
+- `naro realtime` turns on Naro Realtime for the project and chooses the
+  tables whose changes reach subscribers (Realtime 3-2d). Five commands:
+  `naro realtime [status]`, `naro realtime enable`,
+  `naro realtime tables [list]`, `naro realtime tables add <table>…` and
+  `naro realtime tables remove <table>… [--yes]`.
+  - `naro realtime` prints `Realtime: on (public channels: off)`, the
+    published tables (`Published tables: messages, gone (dropped)`, or
+    `Published tables: none — naro realtime tables add <table>`) and
+    `Connections now: 12 · channels 30 · presences 8`. When the hub does not
+    answer it says
+    `Connections now: not known — the backend is off or not ready, or the hub did not answer`.
+    Before Realtime is on it prints `Realtime: not enabled` and
+    ``Run `naro realtime enable` to turn it on (the project's backend must be on first).``
+  - `naro realtime enable` needs the backend on, and is safe to run again: it
+    picks up an upload that stopped. It prints
+    `✅ Realtime is on. Publish a table with naro realtime tables add <table>.`
+    and the state. An upload that does not answer within 2 minutes stops
+    with `TIMEOUT`
+    ``Turning Realtime on did not answer within 2 minutes. `naro realtime` shows where it got to, and `naro realtime enable` again picks up where it stopped.``
+  - `naro realtime tables add messages rooms` sends one request a table, in
+    order, and stops at the first refusal (`404 TABLE_NOT_FOUND`
+    `Table nope was not found.`): the tables before it stay published. Each
+    prints `✅ messages now publishes its changes (within about 10 seconds).`
+    and the control plane's warnings as `⚠ <warning>` — for a table with no
+    select policy,
+    `⚠ messages has no select policy: only service-key connections receive its changes.`
+    The command ends with
+    `⚠ Changes made through the Data API are published; writes your app makes with env.DB are not.`
+    once.
+  - `naro realtime tables remove` asks once for all the tables —
+    `Stop publishing messages, rooms? Subscribers stop receiving their changes within about 10 seconds.`
+    — and with `--json` or without a terminal only `--yes` answers it
+    (`CONFIRMATION_REQUIRED`). A table that is not published stops it with
+    `404 TABLE_NOT_PUBLISHED` `Table nope does not publish its changes.`
+  - A table name no URL can carry fails before its request with
+    `INVALID_PATH` `The table name is not valid.`, and a command with no
+    table with `VALIDATION_FAILED` and its usage line.
+- Until Naro Realtime is switched on for the control plane, `naro realtime enable`,
+  `tables add` and `tables remove` answer `503 REALTIME_DISABLED`
+  `Naro Realtime is not enabled on this control plane yet.` (`naro realtime`
+  still prints `Realtime: not enabled`). The tables commands on a project
+  whose Realtime is not on answer `409 REALTIME_NOT_ENABLED`
+  ``Realtime is not enabled for this project. Run `naro realtime enable` first.``
+- There is no command that turns Realtime alone off yet:
+  `naro backend disable` stops it with the rest of the backend.
+- It goes out with naro-js 0.6.0, whose `naro.channel()` is the client side
+  of Realtime (row changes, broadcast and presence, as supabase-js's
+  `channel()`). naro-js 0.6.0 is also the first published version with
+  Storage's `move()` and `copy()` (3-1i).
+
 ### 0.20.0
 
 0.19.1 went out on 2026-10-24 without these.