@happyvertical/smrt-web 0.57.41 → 0.57.42

package/AGENTS.md

@@ -63,6 +63,16 @@ module you are editing. This file keeps what holds in every module.
    smrt-sites pages. Consumers load the runtime only on surfaces that use live
    collections.
 
+## Internal engine lifecycle (#4508)
+
+TanStack DB and the Svelte binding share the 1.0 RC family; the query adapter
+is 1.5+. Keep their peer requirements aligned when updating dependencies.
+SMRT preserves `isPersisted.promise` through an adapter over `when('settled')`.
+Online handlers await explicit refetch; queued writes await synced-store
+confirmation instead. Hydration must await `writeUpsert` before dispatching a
+mutation. Owned collection cleanup includes dependents so active live queries
+are stopped before capability teardown.
+
 ## Conventions
 
 - **WebMCP definition mirror** — `WebMcpToolDefinition` textually mirrors the

package/agents/offline-outbox.md

@@ -42,8 +42,11 @@ which would orphan the optimistic row the outbox is keeping; sync-apply's
 strict-insert path preserves the client UUID, so replay reconciles the exact
 optimistic row. `wrapMutation` enqueues then returns `{ handled: true, result:
 envelope.data }`, and the factory suppresses the post-mutation refetch +
-`invalidateRelated()` (its `{ refetch: false }` path) so the optimistic row is
-not dropped by a refetch of a server list that has never seen the offline write.
+`invalidateRelated()`. The factory awaits `writeUpsert` / `writeDelete` to
+confirm queued rows in the synced store before settling the transaction; a
+mixed batch is confirmed locally if any member was handled. This keeps queued
+rows after optimistic state is removed, without fetching a server list that
+has never seen the offline write.
 
 **Idempotency / no duplicates.** Rows carry client-generated UUIDs and the
 endpoint is idempotent (`_insertOnly` create + no-op re-apply), so a batch that

package/dist/chunks/{src-CG_-RoZq.js → src-1YdIJK9X.js}

@@ -3431,6 +3431,11 @@ function projectChanges(changes) {
 		return projected;
 	});
 }
+function adaptTransaction(transaction) {
+	const promise = transaction.when("settled");
+	promise.catch(() => {});
+	return { isPersisted: { promise } };
+}
 function getBaseUpdatedAt(row) {
 	if (!row || typeof row !== "object") return void 0;
 	const record = row;
@@ -3577,7 +3582,7 @@ function createSmrtCollection(definition, options) {
 		retry,
 		queryFn: async () => unwrapListResult(await fetchers.list(), definition.name),
 		getKey: (row) => String(row[idField]),
-		onInsert: async ({ transaction }) => {
+		onInsert: async ({ transaction, collection: collection2 }) => {
 			let anyHandled = false;
 			for (const mutation of transaction.mutations) {
 				const modified = mutation.modified;
@@ -3593,10 +3598,14 @@ function createSmrtCollection(definition, options) {
 				mutationResults.set(envelope.key, outcome.result);
 				anyHandled = anyHandled || outcome.handled;
 			}
-			if (anyHandled) return { refetch: false };
+			if (anyHandled) {
+				await collection2.utils.writeUpsert(transaction.mutations.map((mutation) => mutation.modified));
+				return;
+			}
+			await collection2.utils.refetch();
 			invalidateRelated();
 		},
-		onUpdate: fetchers.update ? async ({ transaction }) => {
+		onUpdate: fetchers.update ? async ({ transaction, collection: collection2 }) => {
 			let anyHandled = false;
 			for (const mutation of transaction.mutations) {
 				const key = String(mutation.key);
@@ -3611,10 +3620,14 @@ function createSmrtCollection(definition, options) {
 				mutationResults.set(envelope.key, outcome.result);
 				anyHandled = anyHandled || outcome.handled;
 			}
-			if (anyHandled) return { refetch: false };
+			if (anyHandled) {
+				await collection2.utils.writeUpsert(transaction.mutations.map((mutation) => mutation.modified));
+				return;
+			}
+			await collection2.utils.refetch();
 			invalidateRelated();
 		} : void 0,
-		onDelete: fetchers.delete ? async ({ transaction }) => {
+		onDelete: fetchers.delete ? async ({ transaction, collection: collection2 }) => {
 			let anyHandled = false;
 			for (const mutation of transaction.mutations) {
 				const key = String(mutation.key);
@@ -3628,7 +3641,11 @@ function createSmrtCollection(definition, options) {
 				mutationResults.set(envelope.key, outcome.result);
 				anyHandled = anyHandled || outcome.handled;
 			}
-			if (anyHandled) return { refetch: false };
+			if (anyHandled) {
+				await collection2.utils.writeDelete(transaction.mutations.map((mutation) => String(mutation.key)));
+				return;
+			}
+			await collection2.utils.refetch();
 			invalidateRelated();
 		} : void 0
 	}));
@@ -3695,7 +3712,7 @@ function createSmrtCollection(definition, options) {
 		},
 		async cleanup() {
 			disposed = true;
-			await collection.cleanup();
+			await collection.cleanup({ dependents: true });
 			for (const capability of capabilities) try {
 				await capability.teardown?.(ctx);
 			} catch (error) {
@@ -3706,18 +3723,18 @@ function createSmrtCollection(definition, options) {
 			return subscribeWithListOrder(callback);
 		},
 		insert(row) {
-			return collection.insert(row);
+			return adaptTransaction(collection.insert(row));
 		},
 		update(key, changes) {
 			if (!fetchers.update) throw new Error(`${definition.name} has no update action`);
 			const { id: _id, ...safeChanges } = changes;
-			return collection.update(key, (draft) => {
+			return adaptTransaction(collection.update(key, (draft) => {
 				Object.assign(draft, safeChanges);
-			});
+			}));
 		},
 		delete(key) {
 			if (!fetchers.delete) throw new Error(`${definition.name} has no delete action`);
-			return collection.delete(key);
+			return adaptTransaction(collection.delete(key));
 		},
 		async action(action, args, route) {
 			if (!fetchers.custom) throw new Error(`${definition.name} has no custom action fetcher`);
@@ -3730,7 +3747,7 @@ function createSmrtCollection(definition, options) {
 	persistedMutationResults.set(handle, mutationResults);
 	mutationTargetHydrators.set(handle, async (row) => {
 		await collection.preload();
-		collection.utils.writeUpsert(row);
+		await collection.utils.writeUpsert(row);
 	});
 	engineCollections.set(handle, collection);
 	for (const capability of capabilities) try {
@@ -3743,4 +3760,4 @@ function createSmrtCollection(definition, options) {
 //#endregion
 export { wipeDurableStore as A, MAX_SMRT_WEB_DATA_QUERY_FACETS as B, getOutboxHandle as C, pruneDurableNamespace as D, listDurableNamespaces as E, classifySmrtWebDataSurfaceActionResult as F, MAX_SMRT_WEB_DATA_QUERY_ROWS as G, MAX_SMRT_WEB_DATA_QUERY_OFFSET as H, dataSurfaceActionCommandTransport as I, executeSmrtWebDataQuery as J, MAX_SMRT_WEB_DATA_QUERY_STRING_LENGTH as K, executeSmrtWebDataSurfaceAction as L, MAX_SMRT_WEB_DATA_SURFACE_ACTION_IDENTIFIER_LENGTH as M, MAX_SMRT_WEB_DATA_SURFACE_ACTION_JSON_DEPTH as N, durableStoreNamespace as O, MAX_SMRT_WEB_DATA_SURFACE_ACTION_RESULT_BYTES as P, normalizeSmrtWebDataSurfaceActionResult as R, persistDataSurface as S, offlineOutbox as T, MAX_SMRT_WEB_DATA_QUERY_PAGE_LIMIT as U, MAX_SMRT_WEB_DATA_QUERY_FACET_VALUES as V, MAX_SMRT_WEB_DATA_QUERY_RESULT_BYTES as W, runWrapMutation as X, normalizeSmrtWebDataQueryResult as Y, createSmrtWebEventSubscriber as _, createSmrtWebClient as a, DEFAULT_PERSIST_DEBOUNCE_MS as b, newLocalId as c, unwrapListResult as d, validateSmrtWebClient as f, createUpdateState as g, registerWebMcpTools as h, createSmrtCollection as i, MAX_SMRT_WEB_DATA_SURFACE_ACTION_CONTAINER_ITEMS as j, registerDurableResource as k, throwIfSmrtWebError as l, registerWebMcpBespokeTool as m, buildListQuery as n, getEngineCollection as o, registerViewIntent as p, MAX_SMRT_WEB_DATA_QUERY_WARNINGS as q, createDefinitionFetchers as r, invalidateSmrtWebCollections as s, SmrtWebRequestError as t, unwrapItemResult as u, liveInvalidation as v, offlineCommandQueue as w, persistCollection as x, createSmrtWebQuery as y, MAX_SMRT_WEB_DATA_QUERY_CONTAINER_ITEMS as z };
 
-//# sourceMappingURL=src-CG_-RoZq.js.map
+//# sourceMappingURL=src-1YdIJK9X.js.map