sporades 0.9.29 → 0.9.30

package/CHANGES.md

@@ -1,26 +1,17 @@
 # Changes
 
-## Unreleased - 2026-09-23
+## Unreleased - 2026-09-24
 
-Changes since v0.9.28.
+Changes since v0.9.29.
 
 ### 🐛 Bug Fixes
 
-- Evict only on an unanswered ping and document the heartbeat (66f964e0).
-- Ping idle WebSockets so proxy idle timeouts do not strand pages (7ee9c7f8).
-- Start no freshclam after retained-updater cleanup once shutdown began (0185fc01).
-- Close ClamAV refresh shutdown race and recover crashed clamd (6c23b686).
-- Start degraded on stale ClamAV signatures and allow 26h freshness (79dd3ece).
-- Own ClamAV signature refresh in the Capsule runtime (17193be4).
-
-### 🧪 Tests
-
-- Buffer raw WebSocket frames across TCP chunks (e07288dd).
-- Describe the ClamAV freshness gate without a fixed age (b180ac1a).
+- Refresh only live queries that read a written table (6942754d).
+- Detect Promise combinators from call sites, not formatted stacks (a55a4fd3).
 
 ### 📦 Packaging
 
-- Regenerate runtime artifacts for the WebSocket heartbeat (d0b1193b).
+- Regenerate runtime artifacts for scoped live query refresh (14235222).
 
 ## v0.9.11 - 2026-09-02
 
@@ -123,3 +114,4 @@ generated artifacts, and documentation.
 
 
 
+

package/bin/sporades-host-helper.js

@@ -26881,6 +26881,17 @@ function logPayloadMaxBytes(config = {}) {
   return config.logs?.payloadMaxBytes ?? config.logging?.payloadMaxBytes ?? 4096;
 }
 
+// src/live-query-invalidation.ts
+var { AsyncLocalStorage } = process.getBuiltinModule("node:async_hooks");
+var liveQueryTablesTracked = Symbol.for("sporades.database.liveQueryTablesTracked");
+var liveQueryReads = new AsyncLocalStorage();
+var quotedIdentifier = String.raw`(?:\[([^\]]+)\]|"([^"]+)")`;
+var readTablePattern = new RegExp(String.raw`\b(?:FROM|JOIN)\s+${quotedIdentifier}`, "gi");
+var writeTablePattern = new RegExp(
+  String.raw`^\s*(?:INSERT(?:\s+OR\s+\w+)?\s+INTO|REPLACE\s+INTO|UPDATE(?:\s+OR\s+\w+)?|DELETE\s+FROM)\s+${quotedIdentifier}`,
+  "i"
+);
+
 // src/auth-admission.ts
 var AUTH_REQUIREMENTS = Symbol.for("sporades.auth.requirements");
 var ACCESS_KEY_SCOPE_LIMIT = 1024;
@@ -42989,7 +43000,7 @@ var MutationExecutionStorage = process.getBuiltinModule("node:async_hooks").Asyn
 var mutationExecution = new MutationExecutionStorage();
 
 // src/cli/cli-version.ts
-var CLI_VERSION = "0.9.29";
+var CLI_VERSION = "0.9.30";
 
 // src/cli/schedule-inspection-envelope.ts
 var SCHEDULE_DIAGNOSTIC_FIELDS = /* @__PURE__ */ new Set([

package/bin/sporades.js

@@ -91674,7 +91674,26 @@ var promiseHookStop;
 var compositionRootCandidates = [];
 var thenableWrapperRoots = /* @__PURE__ */ new WeakSet();
 var promiseCombinatorKinds = /* @__PURE__ */ new WeakMap();
+var promiseCombinatorNames = /* @__PURE__ */ new Set(["all", "allSettled", "any", "race"]);
 var compositionRootClearQueued = false;
+function promiseCombinatorOnStack() {
+  const prepareStackTrace = Error.prepareStackTrace;
+  let callSites;
+  Error.prepareStackTrace = (_error, sites) => sites;
+  try {
+    callSites = new Error().stack;
+  } finally {
+    Error.prepareStackTrace = prepareStackTrace;
+  }
+  if (!Array.isArray(callSites)) return void 0;
+  for (const site of callSites) {
+    if (site.isAsync?.()) continue;
+    const name2 = site.getFunctionName();
+    const type = site.getTypeName();
+    if (name2 && promiseCombinatorNames.has(name2) && (type === "Promise" || type === "Function")) return name2;
+  }
+  return void 0;
+}
 function retainCompositionRootCandidate(promise) {
   compositionRootCandidates.push(promise);
   if (compositionRootClearQueued) return;
@@ -91690,11 +91709,11 @@ function installPromiseHook() {
     init(promise, parent) {
       if (parent) promiseParents.set(promise, parent);
       else retainCompositionRootCandidate(promise);
-      const match = parent && (new Error().stack ?? "").match(/at (?:Promise|Function)\.(all|allSettled|any|race)\b/);
-      if (parent && match) {
+      const combinator = parent ? promiseCombinatorOnStack() : void 0;
+      if (parent && combinator) {
         const root = [...compositionRootCandidates].reverse().find((candidate) => !thenableWrapperRoots.has(candidate));
         if (root) {
-          promiseCombinatorKinds.set(root, match[1]);
+          promiseCombinatorKinds.set(root, combinator);
           const inputs = promiseCombinatorInputs.get(root) ?? /* @__PURE__ */ new Set();
           inputs.add(parent);
           promiseCombinatorInputs.set(root, inputs);
@@ -91769,25 +91788,23 @@ function promiseCompositionRootCandidate() {
   const wrapper = compositionRootCandidates.at(-1);
   if (!wrapper) return void 0;
   thenableWrapperRoots.add(wrapper);
-  const stack = new Error().stack ?? "";
-  const match = stack.match(/at (?:Promise|Function)\.(all|allSettled|any|race)\b/);
-  if (!match) return void 0;
+  const combinator = promiseCombinatorOnStack();
+  if (!combinator) return void 0;
   for (let index = compositionRootCandidates.length - 2; index >= 0; index -= 1) {
     const candidate = compositionRootCandidates[index];
     if (!thenableWrapperRoots.has(candidate)) {
-      promiseCombinatorKinds.set(candidate, match[1]);
+      promiseCombinatorKinds.set(candidate, combinator);
       return candidate;
     }
   }
-  promiseCombinatorKinds.set(wrapper, match[1]);
+  promiseCombinatorKinds.set(wrapper, combinator);
   return wrapper;
 }
 function promiseCombinatorKind(promise) {
   return promiseCombinatorKinds.get(promise);
 }
 function enclosingPromiseCombinatorRoot() {
-  const stack = new Error().stack ?? "";
-  if (!/at (?:Promise|Function)\.(?:all|allSettled|any|race)\b/.test(stack)) return void 0;
+  if (!promiseCombinatorOnStack()) return void 0;
   for (let index = compositionRootCandidates.length - 1; index >= 0; index -= 1) {
     const candidate = compositionRootCandidates[index];
     if (!settledPromises.has(candidate)) return candidate;
@@ -114132,6 +114149,53 @@ function createEmailEventEndpoints(mailConfig, serverEnv, subscription) {
   return endpoints;
 }
 
+// src/live-query-invalidation.ts
+var { AsyncLocalStorage } = process.getBuiltinModule("node:async_hooks");
+var liveQueryTablesTracked = Symbol.for("sporades.database.liveQueryTablesTracked");
+var LIVE_QUERY_ANY_TABLE = "*";
+var liveQueryReads = new AsyncLocalStorage();
+var dirtyTables = /* @__PURE__ */ new Set();
+var quotedIdentifier = String.raw`(?:\[([^\]]+)\]|"([^"]+)")`;
+var readTablePattern = new RegExp(String.raw`\b(?:FROM|JOIN)\s+${quotedIdentifier}`, "gi");
+var writeTablePattern = new RegExp(
+  String.raw`^\s*(?:INSERT(?:\s+OR\s+\w+)?\s+INTO|REPLACE\s+INTO|UPDATE(?:\s+OR\s+\w+)?|DELETE\s+FROM)\s+${quotedIdentifier}`,
+  "i"
+);
+var nonWritingStatementPattern = /^\s*(?:BEGIN|COMMIT|END|ROLLBACK|SAVEPOINT|RELEASE|PRAGMA|SELECT)\b/i;
+function trackLiveQueryReads(tables, run2) {
+  return liveQueryReads.run(tables, run2);
+}
+function recordLiveQueryStatementRead(sql2) {
+  const tables = liveQueryReads.getStore();
+  if (!tables) return;
+  let identified = false;
+  for (const match of String(sql2).matchAll(readTablePattern)) {
+    tables.add(match[1] ?? match[2]);
+    identified = true;
+  }
+  if (!identified) tables.add(LIVE_QUERY_ANY_TABLE);
+}
+function recordLiveQueryTableRead(table) {
+  liveQueryReads.getStore()?.add(table);
+}
+function recordLiveQueryStatementWrite(sql2, result) {
+  if (result && typeof result === "object" && "changes" in result && Number(result.changes) === 0) return;
+  const text2 = String(sql2);
+  if (nonWritingStatementPattern.test(text2)) return;
+  const match = writeTablePattern.exec(text2);
+  dirtyTables.add(match ? match[1] ?? match[2] : LIVE_QUERY_ANY_TABLE);
+}
+function takeLiveQueryDirtyTables() {
+  const taken = dirtyTables;
+  dirtyTables = /* @__PURE__ */ new Set();
+  return taken;
+}
+function liveQueryNeedsRefresh(readTables, dirty) {
+  if (!readTables || dirty.has(LIVE_QUERY_ANY_TABLE)) return true;
+  for (const table of readTables) if (dirty.has(table)) return true;
+  return false;
+}
+
 // src/service-users-runtime.ts
 var SERVICE_USER_DISPLAY_NAME_BYTES = 160;
 function serviceUserError(code, message, hint) {
@@ -115097,8 +115161,8 @@ function chainSchemaOperation(previous, operation) {
 var nodeCryptoModule4 = process.getBuiltinModule("node:crypto");
 var nodeFsModule = process.getBuiltinModule("node:fs");
 function createConnectionTransactionGate() {
-  const AsyncLocalStorage = process.getBuiltinModule("node:async_hooks").AsyncLocalStorage;
-  const transactionOwnership = new AsyncLocalStorage();
+  const AsyncLocalStorage2 = process.getBuiltinModule("node:async_hooks").AsyncLocalStorage;
+  const transactionOwnership = new AsyncLocalStorage2();
   const transactionOwner = Object.freeze({});
   let transactionTail = Promise.resolve();
   let transactionActive = false;
@@ -116449,18 +116513,28 @@ async function createSqliteDatabaseAdapter(databasePath, options = {}) {
     };
     return {
       exec(sql2) {
-        return run2(() => useConnection(() => connection.exec(sql2)));
+        return run2(() => useConnection(() => {
+          const result = connection.exec(sql2);
+          recordLiveQueryStatementWrite(sql2);
+          return result;
+        }));
       },
       prepare(sql2) {
         return {
           all(...params) {
+            recordLiveQueryStatementRead(sql2);
             return run2(() => useConnection(() => connection.prepare(sql2).all(...params)));
           },
           get(...params) {
+            recordLiveQueryStatementRead(sql2);
             return run2(() => useConnection(() => connection.prepare(sql2).get(...params)));
           },
           run(...params) {
-            return run2(() => useConnection(() => connection.prepare(sql2).run(...params)));
+            return run2(() => useConnection(() => {
+              const result = connection.prepare(sql2).run(...params);
+              recordLiveQueryStatementWrite(sql2, result);
+              return result;
+            }));
           },
           columns() {
             return run2(() => useConnection(() => connection.prepare(sql2).columns()));
@@ -116473,6 +116547,9 @@ async function createSqliteDatabaseAdapter(databasePath, options = {}) {
     ...createSharedDatabaseAdapterMethods(dialect),
     ...createOperations(connectionGate.runOperation),
     engine: "sqlite",
+    // Every statement on the shared and dedicated connections reports its tables, so live
+    // query refreshes can be scoped to the tables a write changed.
+    [liveQueryTablesTracked]: true,
     // Outer resources must be able to open one independent durable SQLite
     // connection. This runtime-owned marker propagates through transaction
     // adapters; callers cannot opt an in-memory or read-only adapter in.
@@ -116492,8 +116569,30 @@ async function createSqliteDatabaseAdapter(databasePath, options = {}) {
         let begun = false;
         let commitIssued = false;
         const operations = {
-          exec: (sql2) => dedicated.exec(sql2),
-          prepare: (sql2) => dedicated.prepare(sql2)
+          exec: (sql2) => {
+            const result = dedicated.exec(sql2);
+            recordLiveQueryStatementWrite(sql2);
+            return result;
+          },
+          prepare: (sql2) => {
+            const statement = dedicated.prepare(sql2);
+            return Object.assign(Object.create(statement), {
+              all: (...params) => {
+                recordLiveQueryStatementRead(sql2);
+                return statement.all(...params);
+              },
+              get: (...params) => {
+                recordLiveQueryStatementRead(sql2);
+                return statement.get(...params);
+              },
+              run: (...params) => {
+                const result = statement.run(...params);
+                recordLiveQueryStatementWrite(sql2, result);
+                return result;
+              },
+              columns: () => statement.columns()
+            });
+          }
         };
         const transaction = createTransactionScopedAdapter(adapter, operations, adapter, "transaction");
         try {
@@ -123214,9 +123313,11 @@ function createWebSocketHub(getDatabase, trustedRefresh = null, options = {}) {
     subscription.generation = generation;
     try {
       const database = getDatabase();
-      const result = await runQuery(database, client.session.auth, subscription.name, subscription.args, {
+      const readTables = /* @__PURE__ */ new Set();
+      const result = await trackLiveQueryReads(readTables, () => runQuery(database, client.session.auth, subscription.name, subscription.args, {
         sessionToken: client.session.token
-      });
+      }));
+      if (subscription.generation === generation) subscription.readTables = result?.error || readTables.has(LIVE_QUERY_ANY_TABLE) ? null : readTables;
       const data2 = subscription.style === "direct" ? result.data ?? result.rows : { rows: result.data ?? result.rows };
       if (client.subscriptions.get(subscription.id) !== subscription || subscription.generation !== generation) return;
       sendJson(client, {
@@ -123228,6 +123329,7 @@ function createWebSocketHub(getDatabase, trustedRefresh = null, options = {}) {
       });
     } catch (error) {
       if (client.subscriptions.get(subscription.id) !== subscription || subscription.generation !== generation) return;
+      subscription.readTables = null;
       try {
         onError(error);
       } catch {
@@ -123235,8 +123337,11 @@ function createWebSocketHub(getDatabase, trustedRefresh = null, options = {}) {
     }
   }
   function refreshQueries() {
+    const dirty = takeLiveQueryDirtyTables();
+    const scoped = getDatabase()?.adapter?.[liveQueryTablesTracked] === true;
     for (const subscribedClient of clients) {
       for (const subscription of subscribedClient.subscriptions.values()) {
+        if (scoped && !liveQueryNeedsRefresh(subscription.readTables, dirty)) continue;
         void sendQueryResult(
           subscribedClient,
           subscription,
@@ -123515,6 +123620,7 @@ async function runQuery(database, auth, queryName, rawArgs = [], options = {}) {
       }
       if (args.length > 0) return { rows: null, data: null, error: invalidQueryArgumentsError() };
       const cacheKey = `${table.name}:${context.auth.userId}`;
+      recordLiveQueryTableRead(table.name);
       if (!database.rowCache.has(cacheKey)) {
         const columns = ["id", "createdAt", "updatedAt", ...table.fields.map((field) => field.name)];
         const ownerScoped = table.fields.some((field) => field.name === "ownerId");
@@ -131249,7 +131355,7 @@ jobs:
 }
 
 // src/cli/cli-version.ts
-var CLI_VERSION = "0.9.29";
+var CLI_VERSION = "0.9.30";
 
 // src/cli/sporades.ts
 var SUPPORTED_TEMPLATES = new Set(CLIENT_TEMPLATES);

package/dist/cli/cli-version.d.ts

@@ -1,2 +1,2 @@
-export declare const CLI_VERSION = "0.9.29";
+export declare const CLI_VERSION = "0.9.30";
 //# sourceMappingURL=cli-version.d.ts.map

package/dist/cli/cli-version.js

@@ -1,3 +1,3 @@
 // Generated by `npm run build` from package.json. Do not edit by hand.
-export const CLI_VERSION = "0.9.29";
+export const CLI_VERSION = "0.9.30";
 //# sourceMappingURL=cli-version.js.map

package/dist/database-runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"database-runtime.d.ts","sourceRoot":"","sources":["../src/database-runtime.ts"],"names":[],"mappings":"AAmKA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAyBxC,KAAK,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AACvC,KAAK,aAAa,GAAG,WAAW,CAAC;AACjC,KAAK,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;AAgGrD,wBAAgB,gCAAgC,CAAC,KAAK,EAAE,GAAG,EAAE,KAAK,CAAC,EAAE,GAAG,WAOvE;AA+DD,wBAAsB,4BAA4B,CAAC,YAAY,EAAE,GAAG,EAAE,SAAS,GAAE,UAAe,EAAE,MAAM,GAAE,aAAkB,GAAG,OAAO,CAAC,WAAW,CAAC,CAqBlJ;AAED,wBAAsB,8BAA8B,CAAC,YAAY,EAAE,GAAG,EAAE,SAAS,GAAE,UAAe,EAAE,MAAM,GAAE,aAAkB,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAS3J;AAkBD,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,WAAW,GAAG,WAAW,CAyBpE;AA2BD,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,WAAW,GAAG,WAAW,CAa1E;AAMD,wBAAgB,sBAAsB,gBAMrC;AAED,wBAAgB,wBAAwB,gBAgBvC;AAED,wBAAgB,sBAAsB,gBASrC;AAGD,wBAAgB,qBAAqB,gBAoCpC;AAED,wBAAgB,uBAAuB,gBAmDtC;AAaD,wBAAgB,kCAAkC,CAAC,OAAO,EAAE,WAAW,GAAG,WAAW,CAunCpF;AAED,wBAAsB,2BAA2B,CAAC,YAAY,EAAE,QAAQ,EAAE,OAAO,GAAE,WAAgB,wBA4KlG;AAED,wBAAsB,6BAA6B,CAAC,OAAO,EAAE;IAAE,GAAG,EAAE,GAAG,CAAC;CAAE,wBA2YzE;AAID,wBAAsB,wBAAwB,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,CAAC,EAAE,WAAW;;eAsG9D,MAAM;;;;;;GAwIpB;AA8MD,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,GAAE,GAAG,EAAO,UA2E/D;AAMD,wBAAsB,2BAA2B,CAAC,OAAO,EAAE;IAAE,GAAG,EAAE,GAAG,CAAC;IAAC,SAAS,EAAE,GAAG,CAAC;CAAE;;;;wBAiF1D,CAAC,kBAAkB,EAAE,WAAW,KAAK,GAAG,YAAW;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE;6BA8BtE,CAAC,OAAO,EAAE,WAAW,KAAK,GAAG;;cAtFlD,MAAM;iBAUH,MAAM;uBAGA,CAAC,MAAM,GAAG,SAAS,CAAC,EAAE;uBAQtB,SAAS,EAAE;uBAGX,MAAM,EAAE;;;GAuG9B;AA4VD,wBAAgB,cAAc,CAAC,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,WAAW,EAAE,SAAS,MAAa,OAM7F;AAyED,wBAAsB,kBAAkB,CAAC,QAAQ,EAAE;IAAE,OAAO,EAAE,GAAG,CAAC;IAAC,MAAM,EAAE,GAAG,CAAC;CAAE,gBAEhF;AAED,wBAAsB,YAAY,CAAC,QAAQ,EAAE;IAAE,OAAO,EAAE,GAAG,CAAC;IAAC,MAAM,EAAE,GAAG,CAAC;CAAE,gBAE1E;AAED,wBAAsB,gBAAgB,CAAC,QAAQ,EAAE;IAAE,OAAO,EAAE,GAAG,CAAC;IAAC,MAAM,EAAE,GAAG,CAAC;CAAE,EAAE,GAAG,EAAE,GAAG,gBAExF;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,GAAG,YAuE1C;AAED,wBAAgB,eAAe,CAAC,UAAU,EAAE,GAAG,UAE9C"}
+{"version":3,"file":"database-runtime.d.ts","sourceRoot":"","sources":["../src/database-runtime.ts"],"names":[],"mappings":"AAoKA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAyBxC,KAAK,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AACvC,KAAK,aAAa,GAAG,WAAW,CAAC;AACjC,KAAK,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;AAgGrD,wBAAgB,gCAAgC,CAAC,KAAK,EAAE,GAAG,EAAE,KAAK,CAAC,EAAE,GAAG,WAOvE;AA+DD,wBAAsB,4BAA4B,CAAC,YAAY,EAAE,GAAG,EAAE,SAAS,GAAE,UAAe,EAAE,MAAM,GAAE,aAAkB,GAAG,OAAO,CAAC,WAAW,CAAC,CAqBlJ;AAED,wBAAsB,8BAA8B,CAAC,YAAY,EAAE,GAAG,EAAE,SAAS,GAAE,UAAe,EAAE,MAAM,GAAE,aAAkB,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAS3J;AAkBD,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,WAAW,GAAG,WAAW,CAyBpE;AA2BD,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,WAAW,GAAG,WAAW,CAa1E;AAMD,wBAAgB,sBAAsB,gBAMrC;AAED,wBAAgB,wBAAwB,gBAgBvC;AAED,wBAAgB,sBAAsB,gBASrC;AAGD,wBAAgB,qBAAqB,gBAoCpC;AAED,wBAAgB,uBAAuB,gBAmDtC;AAaD,wBAAgB,kCAAkC,CAAC,OAAO,EAAE,WAAW,GAAG,WAAW,CAunCpF;AAED,wBAAsB,2BAA2B,CAAC,YAAY,EAAE,QAAQ,EAAE,OAAO,GAAE,WAAgB,wBAyMlG;AAED,wBAAsB,6BAA6B,CAAC,OAAO,EAAE;IAAE,GAAG,EAAE,GAAG,CAAC;CAAE,wBA2YzE;AAID,wBAAsB,wBAAwB,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,CAAC,EAAE,WAAW;;eAsG9D,MAAM;;;;;;GAwIpB;AA8MD,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,GAAE,GAAG,EAAO,UA2E/D;AAMD,wBAAsB,2BAA2B,CAAC,OAAO,EAAE;IAAE,GAAG,EAAE,GAAG,CAAC;IAAC,SAAS,EAAE,GAAG,CAAC;CAAE;;;;wBAiF1D,CAAC,kBAAkB,EAAE,WAAW,KAAK,GAAG,YAAW;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE;6BA8BtE,CAAC,OAAO,EAAE,WAAW,KAAK,GAAG;;cAtFlD,MAAM;iBAUH,MAAM;uBAGA,CAAC,MAAM,GAAG,SAAS,CAAC,EAAE;uBAQtB,SAAS,EAAE;uBAGX,MAAM,EAAE;;;GAuG9B;AA4VD,wBAAgB,cAAc,CAAC,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,WAAW,EAAE,SAAS,MAAa,OAM7F;AAyED,wBAAsB,kBAAkB,CAAC,QAAQ,EAAE;IAAE,OAAO,EAAE,GAAG,CAAC;IAAC,MAAM,EAAE,GAAG,CAAC;CAAE,gBAEhF;AAED,wBAAsB,YAAY,CAAC,QAAQ,EAAE;IAAE,OAAO,EAAE,GAAG,CAAC;IAAC,MAAM,EAAE,GAAG,CAAC;CAAE,gBAE1E;AAED,wBAAsB,gBAAgB,CAAC,QAAQ,EAAE;IAAE,OAAO,EAAE,GAAG,CAAC;IAAC,MAAM,EAAE,GAAG,CAAC;CAAE,EAAE,GAAG,EAAE,GAAG,gBAExF;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,GAAG,YAuE1C;AAED,wBAAgB,eAAe,CAAC,UAAU,EAAE,GAAG,UAE9C"}

package/dist/database-runtime.js

@@ -1,5 +1,6 @@
 import { acquirePostgresResourceBootstrapLock, resourceError } from "./resource-runtime.js";
 import { notificationIntentSchemas } from "./notification-intent-runtime.js";
+import { liveQueryTablesTracked, recordLiveQueryStatementRead, recordLiveQueryStatementWrite } from "./live-query-invalidation.js";
 // The Capsule runtime's Database adapters and dialect: the three engines, the seam they answer, the
 // one shared method set every behavioural call goes through, and the app-schema DDL that method set
 // emits. Batch 9 of the migration ADR-0041 records, and the last domain to leave
@@ -1382,18 +1383,28 @@ export async function createSqliteDatabaseAdapter(databasePath, options = {}) {
         };
         return {
             exec(sql) {
-                return run(() => useConnection(() => connection.exec(sql)));
+                return run(() => useConnection(() => {
+                    const result = connection.exec(sql);
+                    recordLiveQueryStatementWrite(sql);
+                    return result;
+                }));
             },
             prepare(sql) {
                 return {
                     all(...params) {
+                        recordLiveQueryStatementRead(sql);
                         return run(() => useConnection(() => connection.prepare(sql).all(...params)));
                     },
                     get(...params) {
+                        recordLiveQueryStatementRead(sql);
                         return run(() => useConnection(() => connection.prepare(sql).get(...params)));
                     },
                     run(...params) {
-                        return run(() => useConnection(() => connection.prepare(sql).run(...params)));
+                        return run(() => useConnection(() => {
+                            const result = connection.prepare(sql).run(...params);
+                            recordLiveQueryStatementWrite(sql, result);
+                            return result;
+                        }));
                     },
                     columns() {
                         return run(() => useConnection(() => connection.prepare(sql).columns()));
@@ -1408,6 +1419,9 @@ export async function createSqliteDatabaseAdapter(databasePath, options = {}) {
         ...createSharedDatabaseAdapterMethods(dialect),
         ...createOperations(connectionGate.runOperation),
         engine: "sqlite",
+        // Every statement on the shared and dedicated connections reports its tables, so live
+        // query refreshes can be scoped to the tables a write changed.
+        [liveQueryTablesTracked]: true,
         // Outer resources must be able to open one independent durable SQLite
         // connection. This runtime-owned marker propagates through transaction
         // adapters; callers cannot opt an in-memory or read-only adapter in.
@@ -1432,8 +1446,24 @@ export async function createSqliteDatabaseAdapter(databasePath, options = {}) {
                 let begun = false;
                 let commitIssued = false;
                 const operations = {
-                    exec: (sql) => dedicated.exec(sql),
-                    prepare: (sql) => dedicated.prepare(sql),
+                    exec: (sql) => {
+                        const result = dedicated.exec(sql);
+                        recordLiveQueryStatementWrite(sql);
+                        return result;
+                    },
+                    prepare: (sql) => {
+                        const statement = dedicated.prepare(sql);
+                        return Object.assign(Object.create(statement), {
+                            all: (...params) => { recordLiveQueryStatementRead(sql); return statement.all(...params); },
+                            get: (...params) => { recordLiveQueryStatementRead(sql); return statement.get(...params); },
+                            run: (...params) => {
+                                const result = statement.run(...params);
+                                recordLiveQueryStatementWrite(sql, result);
+                                return result;
+                            },
+                            columns: () => statement.columns(),
+                        });
+                    },
                 };
                 const transaction = createTransactionScopedAdapter(adapter, operations, adapter, "transaction");
                 try {