@lotics/app-sdk 0.88.0 → 0.88.2

package/dist/src/comments.d.ts

@@ -87,8 +87,11 @@ export interface CommentCountsState {
     refetch: () => void;
 }
 export interface UseCommentCountsArgs {
-    /** The table whose per-record comment counts to read. */
-    table_id: string;
+    /** The table whose per-record comment counts to read. Read it off a row
+     *  (`__source_table_id`) rather than pasting a `tbl_` id — a copy of the app
+     *  runs over other tables. `undefined` (no row on screen yet) sends no
+     *  request and answers `{}`. */
+    table_id: string | undefined;
 }
 /**
  * Per-record comment counts for a whole table, as `{ record_id: count }` — for
@@ -96,7 +99,7 @@ export interface UseCommentCountsArgs {
  * server-side `GROUP BY`. App-authority like {@link useComments}.
  *
  * ```tsx
- * const { counts } = useCommentCounts({ table_id });
+ * const { counts } = useCommentCounts({ table_id: rows[0]?.__source_table_id });
  * // counts[row.__source_record_id] ?? 0
  * ```
  */

package/dist/src/comments.js

@@ -170,7 +170,7 @@ export function useComments(args) {
  * server-side `GROUP BY`. App-authority like {@link useComments}.
  *
  * ```tsx
- * const { counts } = useCommentCounts({ table_id });
+ * const { counts } = useCommentCounts({ table_id: rows[0]?.__source_table_id });
  * // counts[row.__source_record_id] ?? 0
  * ```
  */
@@ -178,7 +178,7 @@ export function useCommentCounts(args) {
     const { table_id } = args;
     const { memberId, commentsEnabled, resolved } = useAppContext();
     const available = memberId != null && commentsEnabled;
-    const swr = useSWR(available ? ["app-comment-counts", table_id] : null, () => rpc("comments.counts", { table_id }), { shouldRetryOnError: false });
+    const swr = useSWR(available && table_id !== undefined ? ["app-comment-counts", table_id] : null, () => rpc("comments.counts", { table_id }), { shouldRetryOnError: false });
     const refetch = useCallback(() => {
         void swr.mutate();
     }, [swr]);

package/docs/members_and_options.md

@@ -309,7 +309,9 @@ updateComment, deleteComment, refetch }`.
 `useCommentCounts({ table_id })` → `{ counts, loading, error, available, refetch }` where `counts`
 is `{ record_id: count }` for the whole table — row badges without shipping any comment content
 (one server-side aggregate). Same gate and authority as `useComments`. `table_id` is the source
-table's id — the same id the app's queries are declared over.
+table's id: read it off a row of the query that renders the badges (`rows[0]?.__source_table_id`)
+rather than pasting a `tbl_` id, which a copy of the app cannot carry. Pass `undefined` while no
+row is on screen — no request is sent and `counts` is `{}`.
 
 ## Pairing with `@lotics/ui`
 

package/docs/queries.md

@@ -538,7 +538,10 @@ Negation-shaped inner operators (`has_none_of`, `not_equals`, `is_none_of`,
 "any record matches the negation".
 
 Traversals are **source-layer only** (rejected on derived columns — push them into
-`from_table.filter`). Two access classes:
+`from_table.filter`). Each hop reaches the linked rows by primary key from the ids in the link
+cell. Under an OR beside column conditions a traversal runs once per row and takes the column
+conditions off their indexes with it; give it a `union` arm of its own when the other arms must
+stay index-served. Two access classes:
 
 - **Self-scoped** — inner operator `is_current_member` / `is_not_current_member`: tests only
   the viewer's own membership on the linked row, leaks nothing, and is exempt from the linked

package/package.json

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