@durable-streams/state 0.2.3 → 0.2.5

package/README.md

@@ -353,10 +353,12 @@ const db = createStreamDB({
         const txid = crypto.randomUUID()
 
         await stream.append(
-          schema.users.insert({
-            value: user,
-            headers: { txid },
-          })
+          JSON.stringify(
+            schema.users.insert({
+              value: user,
+              headers: { txid },
+            })
+          )
         )
 
         // Wait for confirmation
@@ -375,11 +377,13 @@ const db = createStreamDB({
         const current = await db.collections.users.get(id)
 
         await stream.append(
-          schema.users.update({
-            value: { ...current, ...updates },
-            oldValue: current,
-            headers: { txid },
-          })
+          JSON.stringify(
+            schema.users.update({
+              value: { ...current, ...updates },
+              oldValue: current,
+              headers: { txid },
+            })
+          )
         )
 
         await db.utils.awaitTxId(txid)
@@ -462,9 +466,11 @@ const schema = createStateSchema({
 
 // Set value
 await stream.append(
-  schema.config.insert({
-    value: { key: "theme", value: "dark" },
-  })
+  JSON.stringify(
+    schema.config.insert({
+      value: { key: "theme", value: "dark" },
+    })
+  )
 )
 
 // Query value reactively
@@ -489,13 +495,15 @@ const schema = createStateSchema({
 
 // Update presence
 await stream.append(
-  schema.presence.update({
-    value: {
-      userId: "kyle",
-      status: "online",
-      lastSeen: Date.now(),
-    },
-  })
+  JSON.stringify(
+    schema.presence.update({
+      value: {
+        userId: "kyle",
+        status: "online",
+        lastSeen: Date.now(),
+      },
+    })
+  )
 )
 
 // Query presence with TanStack DB

package/dist/index.cjs

@@ -461,12 +461,6 @@ function createStreamDB(options) {
 			startSync: true,
 			gcTime: 0
 		});
-		console.log(`[StreamDB] Created collection "${name}":`, {
-			type: typeof collection,
-			constructor: collection.constructor.name,
-			isCollection: collection instanceof Object,
-			hasSize: `size` in collection
-		});
 		collectionInstances[name] = collection;
 	}
 	let streamResponse = null;
@@ -482,21 +476,11 @@ function createStreamDB(options) {
 			live: true,
 			signal: abortController.signal
 		});
-		let batchCount = 0;
-		let lastBatchTime = Date.now();
 		streamResponse.subscribeJson((batch) => {
 			try {
-				batchCount++;
-				lastBatchTime = Date.now();
-				if (batch.items.length > 0) console.log(`[StreamDB] Processing batch #${batchCount}: ${batch.items.length} items, upToDate=${batch.upToDate}`);
 				for (const event of batch.items) if (isChangeEvent(event)) dispatcher.dispatchChange(event);
 				else if (isControlEvent(event)) dispatcher.dispatchControl(event);
-				if (batch.upToDate) {
-					console.log(`[StreamDB] Marking up-to-date after batch #${batchCount}`);
-					dispatcher.markUpToDate();
-					console.log(`[StreamDB] Successfully marked up-to-date`);
-				}
-				if (batch.items.length > 0) console.log(`[StreamDB] Successfully processed batch #${batchCount}`);
+				if (batch.upToDate) dispatcher.markUpToDate();
 			} catch (error) {
 				console.error(`[StreamDB] Error processing batch:`, error);
 				console.error(`[StreamDB] Failed batch:`, batch);
@@ -505,14 +489,6 @@ function createStreamDB(options) {
 			}
 			return Promise.resolve();
 		});
-		const healthCheck = setInterval(() => {
-			const timeSinceLastBatch = Date.now() - lastBatchTime;
-			console.log(`[StreamDB] Health: ${batchCount} batches processed, last batch ${(timeSinceLastBatch / 1e3).toFixed(1)}s ago`);
-		}, 15e3);
-		abortController.signal.addEventListener(`abort`, () => {
-			clearInterval(healthCheck);
-			console.log(`[StreamDB] Aborted - cleaning up health check`);
-		});
 	};
 	const dbMethods = {
 		stream,
@@ -526,13 +502,10 @@ function createStreamDB(options) {
 		},
 		utils: { awaitTxId: (txid, timeout) => dispatcher.awaitTxId(txid, timeout) }
 	};
-	console.log(`[StreamDB] Creating db object with collections:`, Object.keys(collectionInstances));
 	const db = {
 		collections: collectionInstances,
 		...dbMethods
 	};
-	console.log(`[StreamDB] db.collections:`, Object.keys(db.collections));
-	console.log(`[StreamDB] db.collections.events:`, db.collections.events);
 	if (actionsFactory) {
 		const actionDefs = actionsFactory({
 			db,

package/dist/index.js

@@ -437,12 +437,6 @@ function createStreamDB(options) {
 			startSync: true,
 			gcTime: 0
 		});
-		console.log(`[StreamDB] Created collection "${name}":`, {
-			type: typeof collection,
-			constructor: collection.constructor.name,
-			isCollection: collection instanceof Object,
-			hasSize: `size` in collection
-		});
 		collectionInstances[name] = collection;
 	}
 	let streamResponse = null;
@@ -458,21 +452,11 @@ function createStreamDB(options) {
 			live: true,
 			signal: abortController.signal
 		});
-		let batchCount = 0;
-		let lastBatchTime = Date.now();
 		streamResponse.subscribeJson((batch) => {
 			try {
-				batchCount++;
-				lastBatchTime = Date.now();
-				if (batch.items.length > 0) console.log(`[StreamDB] Processing batch #${batchCount}: ${batch.items.length} items, upToDate=${batch.upToDate}`);
 				for (const event of batch.items) if (isChangeEvent(event)) dispatcher.dispatchChange(event);
 				else if (isControlEvent(event)) dispatcher.dispatchControl(event);
-				if (batch.upToDate) {
-					console.log(`[StreamDB] Marking up-to-date after batch #${batchCount}`);
-					dispatcher.markUpToDate();
-					console.log(`[StreamDB] Successfully marked up-to-date`);
-				}
-				if (batch.items.length > 0) console.log(`[StreamDB] Successfully processed batch #${batchCount}`);
+				if (batch.upToDate) dispatcher.markUpToDate();
 			} catch (error) {
 				console.error(`[StreamDB] Error processing batch:`, error);
 				console.error(`[StreamDB] Failed batch:`, batch);
@@ -481,14 +465,6 @@ function createStreamDB(options) {
 			}
 			return Promise.resolve();
 		});
-		const healthCheck = setInterval(() => {
-			const timeSinceLastBatch = Date.now() - lastBatchTime;
-			console.log(`[StreamDB] Health: ${batchCount} batches processed, last batch ${(timeSinceLastBatch / 1e3).toFixed(1)}s ago`);
-		}, 15e3);
-		abortController.signal.addEventListener(`abort`, () => {
-			clearInterval(healthCheck);
-			console.log(`[StreamDB] Aborted - cleaning up health check`);
-		});
 	};
 	const dbMethods = {
 		stream,
@@ -502,13 +478,10 @@ function createStreamDB(options) {
 		},
 		utils: { awaitTxId: (txid, timeout) => dispatcher.awaitTxId(txid, timeout) }
 	};
-	console.log(`[StreamDB] Creating db object with collections:`, Object.keys(collectionInstances));
 	const db = {
 		collections: collectionInstances,
 		...dbMethods
 	};
-	console.log(`[StreamDB] db.collections:`, Object.keys(db.collections));
-	console.log(`[StreamDB] db.collections.events:`, db.collections.events);
 	if (actionsFactory) {
 		const actionDefs = actionsFactory({
 			db,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@durable-streams/state",
   "description": "State change event protocol for Durable Streams",
-  "version": "0.2.3",
+  "version": "0.2.5",
   "author": "Durable Stream contributors",
   "license": "Apache-2.0",
   "repository": {
@@ -59,7 +59,7 @@
     "@tanstack/db": "latest",
     "@tanstack/intent": "latest",
     "tsdown": "^0.9.0",
-    "@durable-streams/server": "0.2.3"
+    "@durable-streams/server": "0.3.1"
   },
   "engines": {
     "node": ">=18.0.0"

package/skills/stream-db/SKILL.md

@@ -77,22 +77,34 @@ const messages = db.collections.messages
 
 ### Reactive queries with TanStack DB
 
-StreamDB collections are TanStack DB collections. Use framework adapters for reactive queries:
+StreamDB collections are TanStack DB collections. Use framework adapters for reactive queries.
+
+**IMPORTANT**: `useLiveQuery` returns `{ data }`, NOT the array directly. Always destructure with a default:
 
 ```typescript
 import { useLiveQuery } from "@tanstack/react-db"
 import { eq } from "@durable-streams/state"
 
+// List query — destructure { data } with a default empty array
+function UserList() {
+  const { data: users = [] } = useLiveQuery((q) =>
+    q.from({ users: db.collections.users })
+  )
+
+  return users.map(u => <div key={u.id}>{u.name}</div>)
+}
+
+// Single item query — use findOne(), data is T | undefined
 function UserProfile({ userId }: { userId: string }) {
-  const userQuery = useLiveQuery((q) =>
+  const { data: user } = useLiveQuery((q) =>
     q
       .from({ users: db.collections.users })
       .where(({ users }) => eq(users.id, userId))
       .findOne()
   )
 
-  if (!userQuery.data) return null
-  return <div>{userQuery.data.name}</div>
+  if (!user) return null
+  return <div>{user.name}</div>
 }
 ```
 

package/src/stream-db.ts

@@ -790,13 +790,6 @@ export function createStreamDB<
       gcTime: 0,
     })
 
-    console.log(`[StreamDB] Created collection "${name}":`, {
-      type: typeof collection,
-      constructor: collection.constructor.name,
-      isCollection: collection instanceof Object,
-      hasSize: `size` in collection,
-    })
-
     collectionInstances[name] = collection
   }
 
@@ -818,22 +811,9 @@ export function createStreamDB<
       signal: abortController.signal,
     })
 
-    // Track batch processing for debugging
-    let batchCount = 0
-    let lastBatchTime = Date.now()
-
     // Process events as they come in
     streamResponse.subscribeJson((batch) => {
       try {
-        batchCount++
-        lastBatchTime = Date.now()
-
-        if (batch.items.length > 0) {
-          console.log(
-            `[StreamDB] Processing batch #${batchCount}: ${batch.items.length} items, upToDate=${batch.upToDate}`
-          )
-        }
-
         for (const event of batch.items) {
           if (isChangeEvent(event)) {
             dispatcher.dispatchChange(event)
@@ -844,15 +824,7 @@ export function createStreamDB<
 
         // Check batch-level up-to-date signal
         if (batch.upToDate) {
-          console.log(
-            `[StreamDB] Marking up-to-date after batch #${batchCount}`
-          )
           dispatcher.markUpToDate()
-          console.log(`[StreamDB] Successfully marked up-to-date`)
-        }
-
-        if (batch.items.length > 0) {
-          console.log(`[StreamDB] Successfully processed batch #${batchCount}`)
         }
       } catch (error) {
         console.error(`[StreamDB] Error processing batch:`, error)
@@ -865,20 +837,6 @@ export function createStreamDB<
       }
       return Promise.resolve()
     })
-
-    // Health check to detect silent stalls
-    const healthCheck = setInterval(() => {
-      const timeSinceLastBatch = Date.now() - lastBatchTime
-      console.log(
-        `[StreamDB] Health: ${batchCount} batches processed, last batch ${(timeSinceLastBatch / 1000).toFixed(1)}s ago`
-      )
-    }, 15000)
-
-    // Clean up health check on abort
-    abortController.signal.addEventListener(`abort`, () => {
-      clearInterval(healthCheck)
-      console.log(`[StreamDB] Aborted - cleaning up health check`)
-    })
   }
 
   // Build the StreamDB object with methods
@@ -900,16 +858,10 @@ export function createStreamDB<
   }
 
   // Combine collections with methods
-  console.log(
-    `[StreamDB] Creating db object with collections:`,
-    Object.keys(collectionInstances)
-  )
   const db = {
     collections: collectionInstances,
     ...dbMethods,
   } as unknown as StreamDB<TDef>
-  console.log(`[StreamDB] db.collections:`, Object.keys(db.collections))
-  console.log(`[StreamDB] db.collections.events:`, db.collections.events)
 
   // If actions factory is provided, wrap actions and return db with actions
   if (actionsFactory) {