@lotics/app-sdk 0.81.0 → 0.81.1

package/dist/src/comments.js

@@ -18,9 +18,15 @@
  * signed-in member: `available` is false, lists stay empty, and a mutation
  * rejects. Check `available` before rendering a composer.
  *
- * Freshness mirrors `useQuery`: SWR-cached, revalidate on focus / reconnect, and
- * an explicit refetch after every mutation. There is no realtime push to apps,
- * so a thread updated by another viewer appears on the next focus / refetch.
+ * Freshness: SWR-cached, revalidate on focus / reconnect, and an explicit
+ * refetch after every mutation — so another viewer's comment appears on the
+ * next focus or `refetch()`, not on its own.
+ *
+ * This is the one read hook that does NOT keep itself current, and the reason
+ * is worth knowing rather than guessing: the realtime channel carries **record**
+ * changes, and a comment is its own entity that emits no record event. Your
+ * QUERIES do get pushed (`docs/data_fetching.md`) — do not read this as "apps
+ * have no realtime" and go build a poll.
  */
 import { useCallback } from "react";
 import useSWR from "swr";

package/docs/members_and_options.md

@@ -297,8 +297,11 @@ updateComment, deleteComment, refetch }`.
   member source: the `useMembers` roster (requires the member-access declaration above) or member
   cells in your own data. An unresolvable id should render a fallback (`CommentList` has an
   `unknownMember` label for exactly this).
-- **Freshness:** SWR-cached, revalidates on focus/reconnect; there is **no realtime push** to apps,
-  so another viewer's comment appears on the next focus or explicit `refetch()`.
+- **Freshness:** SWR-cached, revalidates on focus/reconnect, so another viewer's comment appears on
+  the next focus or explicit `refetch()` — not on its own. Comments are the one read that does not
+  keep itself current, and not because apps lack realtime: the channel carries **record** changes,
+  and a comment is its own entity that emits no record event. Your queries DO get pushed
+  ([data_fetching.md](./data_fetching.md)) — don't read this line as "no push" and build a poll.
 
 ### Counts
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lotics/app-sdk",
-  "version": "0.81.0",
+  "version": "0.81.1",
   "description": "Runtime SDK for Lotics custom-code apps \u2014 typed hooks, postMessage bridge, mount entry point",
   "type": "module",
   "exports": {