@trylight/app 0.3.8 → 0.3.9

package/README.md

@@ -60,8 +60,10 @@ every `POLL_MS` while the tab is visible, at once on focus and reconnect. The
 route answers from `light_changes` with the tables changed since the cursor
 (looking `CHANGES_OVERLAP` behind it, for transactions that committed after
 the last poll read) and the next cursor; never rows. Each changed table's
-queries are invalidated by its key (except a table this tab is writing: the
-write's own refetch follows it), and the route loaders reloaded. `light_changes`' `created_at` index is made
+queries are invalidated: those under its key, and those that list its table in
+`meta.tables` (a query that reads several tables, e.g. a server function's
+join), except a table this tab is writing (the write's own refetch follows
+it); the route loaders are reloaded. `light_changes`' `created_at` index is made
 after every migrate (`src/db/audit.ts`). The poll is one `ChangeFeed`; a pushed
 transport can replace it.
 

package/dist/auth/lookup.d.ts

@@ -1,7 +1,7 @@
 import type { AuthContext } from "./context.js";
 import { type PlazaSession } from "./plaza.js";
 /** The cookie holding this app's own session. Nothing of the platform's is read here. */
-export { SESSION_COOKIE } from "../platform/contract.js";
+export { APP_SESSION_COOKIE as SESSION_COOKIE } from "../brand.generated.js";
 /**
  * How often a session asks the platform whether it still stands. Someone removed from
  * the org is signed out of the app within this long; their chat stops at once,

package/dist/auth/lookup.js

@@ -1,7 +1,7 @@
 import { createHash, randomBytes } from "node:crypto";
 import { checkPlazaSession, revokePlazaSession } from "./plaza.js";
 /** The cookie holding this app's own session. Nothing of the platform's is read here. */
-export { SESSION_COOKIE } from "../platform/contract.js";
+export { APP_SESSION_COOKIE as SESSION_COOKIE } from "../brand.generated.js";
 /**
  * How often a session asks the platform whether it still stands. Someone removed from
  * the org is signed out of the app within this long; their chat stops at once,

package/dist/brand.generated.d.ts

@@ -1,2 +1,4 @@
 /** The platform app's origins, current domain first. */
 export declare const APP_ORIGINS: readonly string[];
+/** The cookie holding an app's own session. */
+export declare const APP_SESSION_COOKIE = "mii_session";

package/dist/brand.generated.js

@@ -1,3 +1,5 @@
 // Generated from config/brand.json by scripts/write-brand.ts. Do not edit.
 /** The platform app's origins, current domain first. */
 export const APP_ORIGINS = ["https://trylight.ai", "https://plaza.miis.run"];
+/** The cookie holding an app's own session. */
+export const APP_SESSION_COOKIE = "mii_session";

package/dist/client.d.ts

@@ -2,6 +2,14 @@ import { type QueryKey } from "@tanstack/react-query";
 import type { Contracts } from "./invoke/server.js";
 import { EntityError, type ListOptions, type NewRow, type Patch, type Row } from "./entities.js";
 import type { Entity } from "./schema.js";
+declare module "@tanstack/react-query" {
+    interface Register {
+        /** `tables`: the tables a query reads when it isn't keyed under one (a server function's join); a write to any refetches it. */
+        queryMeta: {
+            tables: readonly Entity[];
+        };
+    }
+}
 export { EntityError, LIST_LIMIT, type ListOptions, type NewRow, type Sort, type Patch, type Row, type Where } from "./entities.js";
 export type { FieldSource, FieldSources } from "./schema.js";
 export { siteOf } from "./schema.js";
@@ -68,7 +76,8 @@ declare function tableClient<T extends Entity>(entity: T): {
     /**
      * The query key everything this table caches sits under. A page's own
      * query over the table (a server function's totals) keyed under it is
-     * refetched after every write too.
+     * refetched after every write too; one over several tables names them in
+     * `meta.tables` instead.
      */
     key: string[];
     list: (options?: ListOptions<Row<T>>) => Promise<Row<T>[]>;

package/dist/client.js

@@ -13,6 +13,7 @@ import { z } from "zod/v4";
 import { ENTITIES_PATH } from "./platform/contract.js";
 import { EntityError, LIST_LIMIT, tableQueryKey } from "./entities.js";
 import { fetchThroughRestart } from "./platform/restart.js";
+import { reads } from "./platform/live-data.js";
 export { EntityError, LIST_LIMIT } from "./entities.js";
 export { siteOf } from "./schema.js";
 export { imageSrc } from "./images.js";
@@ -124,8 +125,9 @@ function putBack(client, id, before) {
 }
 /** One entity table's rows: plain calls, and TanStack Query hooks over them. */
 function tableClient(entity) {
-    const base = `${ENTITIES_PATH}/${getTableName(entity)}`;
-    const all = tableQueryKey(getTableName(entity));
+    const table = getTableName(entity);
+    const base = `${ENTITIES_PATH}/${table}`;
+    const all = tableQueryKey(table);
     const keys = {
         all,
         list: (options) => [...all, "list", options],
@@ -168,7 +170,7 @@ function tableClient(entity) {
         const client = useQueryClient();
         const refetch = async () => {
             if (client.isMutating({ mutationKey: keys.write }) === 1)
-                await client.invalidateQueries({ queryKey: keys.all });
+                await client.invalidateQueries({ predicate: (query) => reads(query, table) });
         };
         return (_data, error) => {
             if (error === null)
@@ -180,7 +182,8 @@ function tableClient(entity) {
         /**
          * The query key everything this table caches sits under. A page's own
          * query over the table (a server function's totals) keyed under it is
-         * refetched after every write too.
+         * refetched after every write too; one over several tables names them in
+         * `meta.tables` instead.
          */
         key: keys.all,
         list,

package/dist/platform/contract.d.ts

@@ -31,7 +31,6 @@ export declare const CHAT_FEATURES_HEADER = "X-Mii-Chat-Features";
 export declare const STARTING_HEADER = "x-mii-app-starting";
 /** Every TanStack query the SDK owns sits under this key. */
 export declare const QUERY_ROOT = "light";
-export declare const SESSION_COOKIE = "mii_session";
 export declare const STORAGE_KEYS: {
     /** sessionStorage: the build this tab already reloaded for after a missing chunk, so a second miss on it can't loop. */
     chunkRetryBuildId: string;

package/dist/platform/contract.js

@@ -2,7 +2,7 @@
 // apps and the platform's pane depend on every value here: rename freely, never
 // change a value without both sides moving.
 const NAMESPACE = "light";
-/** The platform's former name: the pane protocol, the session cookie and two routes still carry it. */
+/** The platform's former name: the pane protocol and two routes still carry it. */
 const LEGACY_NAMESPACE = "mii";
 export const ENTITIES_PATH = `/api/${NAMESPACE}/entities`;
 export const CHANGES_PATH = `${ENTITIES_PATH}/_changes`;
@@ -34,7 +34,6 @@ export const CHAT_FEATURES_HEADER = "X-Mii-Chat-Features";
 export const STARTING_HEADER = `x-${LEGACY_NAMESPACE}-app-starting`;
 /** Every TanStack query the SDK owns sits under this key. */
 export const QUERY_ROOT = NAMESPACE;
-export const SESSION_COOKIE = `${LEGACY_NAMESPACE}_session`;
 export const STORAGE_KEYS = {
     /** sessionStorage: the build this tab already reloaded for after a missing chunk, so a second miss on it can't loop. */
     chunkRetryBuildId: `${NAMESPACE}:chunk-retry-build-id`,

package/dist/platform/live-data.d.ts

@@ -1,4 +1,4 @@
-import { type QueryClient } from "@tanstack/react-query";
+import { type Query, type QueryClient } from "@tanstack/react-query";
 import { z } from "zod/v4";
 declare const changes: z.ZodObject<{
     cursor: z.ZodString;
@@ -20,9 +20,12 @@ export type ChangeFeed = (onChanged: (tables: string[]) => void) => () => void;
 export declare function pollChanges(queries: QueryClient, fetchChanges: (since: string | null) => Promise<Poll>): ChangeFeed;
 export declare function fetchChanges(since: string | null): Promise<Poll>;
 /**
- * Each changed table's on-screen queries refetch, and the route loaders. A
- * table this tab is writing is left to its write, whose own refetch follows
- * it (client.ts's settle) and brings these changes too.
+ * Each changed table's on-screen queries refetch, in one go: those keyed under
+ * it, and those that read it among others and say so in `meta.tables`. A table
+ * this tab is writing is left to its write, whose own refetch follows it
+ * (client.ts's settle) and brings these changes too.
  */
 export declare function refreshTables(queries: QueryClient, tables: string[]): void;
+/** Whether a query shows `table`'s rows: keyed under it, or listing it in `meta.tables` (typed in client.ts). */
+export declare function reads(query: Query, table: string): boolean;
 export {};

package/dist/platform/live-data.js

@@ -4,7 +4,8 @@
 // of a change is a ChangeFeed; today a poll of `_changes` that TanStack Query
 // itself runs (refetchInterval while the tab is visible, at once on focus and
 // reconnect), later a pushed one (SSE) behind the same type.
-import { QueryObserver } from "@tanstack/react-query";
+import { QueryObserver, partialMatchKey } from "@tanstack/react-query";
+import { getTableName } from "drizzle-orm";
 import { z } from "zod/v4";
 import { EntityError, tableQueryKey } from "../entities.js";
 import { CHANGES_PATH, QUERY_ROOT } from "./contract.js";
@@ -73,14 +74,18 @@ export async function fetchChanges(since) {
     return changes.parse(await response.json());
 }
 /**
- * Each changed table's on-screen queries refetch, and the route loaders. A
- * table this tab is writing is left to its write, whose own refetch follows
- * it (client.ts's settle) and brings these changes too.
+ * Each changed table's on-screen queries refetch, in one go: those keyed under
+ * it, and those that read it among others and say so in `meta.tables`. A table
+ * this tab is writing is left to its write, whose own refetch follows it
+ * (client.ts's settle) and brings these changes too.
  */
 export function refreshTables(queries, tables) {
-    for (const table of tables) {
-        const key = tableQueryKey(table);
-        if (queries.isMutating({ mutationKey: [...key, "write"] }) === 0)
-            void queries.invalidateQueries({ queryKey: key });
-    }
+    const quiet = tables.filter((table) => queries.isMutating({ mutationKey: [...tableQueryKey(table), "write"] }) === 0);
+    if (quiet.length > 0)
+        void queries.invalidateQueries({ predicate: (query) => quiet.some((table) => reads(query, table)) });
+}
+/** Whether a query shows `table`'s rows: keyed under it, or listing it in `meta.tables` (typed in client.ts). */
+export function reads(query, table) {
+    // eslint-disable-next-line no-restricted-syntax -- TanStack's meta is optional: most queries name no tables
+    return partialMatchKey(query.queryKey, tableQueryKey(table)) || query.meta?.tables.some((entity) => getTableName(entity) === table) === true;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trylight/app",
-  "version": "0.3.8",
+  "version": "0.3.9",
   "description": "The Light SDK every v2 org app depends on: entities (Drizzle tables with a typed client), sign-in, contracts and in-app chat.",
   "license": "UNLICENSED",
   "type": "module",
@@ -12,6 +12,7 @@
     "url": "https://github.com/shubh9/mii.git",
     "directory": "packages/app-sdk"
   },
+  "packageManager": "pnpm@11.0.9",
   "files": [
     "dist",
     "bin"
@@ -41,6 +42,15 @@
       "default": "./dist/vite.js"
     }
   },
+  "scripts": {
+    "build": "rm -rf dist && tsc -p tsconfig.build.json",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src test --max-warnings 0",
+    "test": "node --test --import tsx \"test/**/*.test.ts\"",
+    "check": "tsx scripts/write-brand.ts --check && pnpm run typecheck && pnpm run lint && pnpm run test && pnpm run build",
+    "prepack": "pnpm run build",
+    "brand": "tsx scripts/write-brand.ts"
+  },
   "peerDependencies": {
     "@tanstack/react-query": ">=5.69",
     "@tanstack/react-router": ">=1.170",
@@ -74,13 +84,5 @@
     "typescript-eslint": "^8.70.1",
     "vite": "^8.2.0",
     "zod": "^4.6.5"
-  },
-  "scripts": {
-    "build": "rm -rf dist && tsc -p tsconfig.build.json",
-    "typecheck": "tsc --noEmit",
-    "lint": "eslint src test --max-warnings 0",
-    "test": "node --test --import tsx \"test/**/*.test.ts\"",
-    "check": "tsx scripts/write-brand.ts --check && pnpm run typecheck && pnpm run lint && pnpm run test && pnpm run build",
-    "brand": "tsx scripts/write-brand.ts"
   }
-}
+}