docs: fix timeout documentation and increase awaitTxId default to 15s

- Fix changeset to remove incorrect claim that TypeScript would error on
  old return patterns (types are generic/overridable, only runtime warns)
- Update awaitTxId default timeout from 5s to 15s for more reliable sync
- Fix documentation that incorrectly stated 30s default

Co-Authored-By: Claude Opus 4.5 <[email protected]>

Author: KyleAMathews

.changeset/deprecate-handler-return-values.md

@@ -1,18 +1,17 @@
 ---
-'@tanstack/db': major
-'@tanstack/electric-db-collection': major
-'@tanstack/query-db-collection': major
+'@tanstack/db': minor
+'@tanstack/electric-db-collection': minor
+'@tanstack/query-db-collection': minor
 ---
 
 **BREAKING (TypeScript only)**: Deprecate returning values from mutation handlers (`onInsert`, `onUpdate`, `onDelete`).
 
 **What's changed:**
 
-- Handler types now default to `Promise<void>` instead of `Promise<any>`
-- TypeScript will error on `return { refetch: false }` or `return { txid }`
-- Runtime still supports old return patterns for backward compatibility
+- Handler types now default to `Promise<void>` instead of `Promise<any>`, indicating the new expected pattern
+- Old return patterns (`return { refetch }`, `return { txid }`) still work at runtime with deprecation warnings
 - **Deprecation warnings** are now logged when handlers return values
-- Old patterns will be fully removed in v1.0 RC
+- Old patterns will be fully removed in v1.0
 
 **New pattern (explicit sync coordination):**
 

docs/collections/electric-collection.md

@@ -312,7 +312,7 @@ Wait for a specific transaction ID to be synchronized:
 // Wait for specific txid
 await todosCollection.utils.awaitTxId(12345)
 
-// With custom timeout (default is 30 seconds)
+// With custom timeout (default is 15 seconds)
 await todosCollection.utils.awaitTxId(12345, 10000)
 ```
 

packages/electric-db-collection/src/electric.ts

@@ -92,7 +92,7 @@ export type MatchFunction<T extends Row<unknown>> = (
  * - Void (no return value) - mutation completes without waiting
  *
  * The optional timeout property specifies how long to wait for the txid(s) in milliseconds.
- * If not specified, defaults to 5000ms.
+ * If not specified, defaults to 15000ms.
  */
 export type MatchingStrategy = {
   txid: Txid | Array<Txid>
@@ -662,12 +662,12 @@ export function electricCollectionOptions<T extends Row<unknown>>(
   /**
    * Wait for a specific transaction ID to be synced
    * @param txId The transaction ID to wait for as a number
-   * @param timeout Optional timeout in milliseconds (defaults to 5000ms)
+   * @param timeout Optional timeout in milliseconds (defaults to 15000ms)
    * @returns Promise that resolves when the txId is synced
    */
   const awaitTxId: AwaitTxIdFn = async (
     txId: Txid,
-    timeout: number = 5000,
+    timeout: number = 15000,
   ): Promise<boolean> => {
     debug(
       `${config.id ? `[${config.id}] ` : ``}awaitTxId called with txid %d`,
@@ -729,7 +729,7 @@ export function electricCollectionOptions<T extends Row<unknown>>(
   /**
    * Wait for a custom match function to find a matching message
    * @param matchFn Function that returns true when a message matches
-   * @param timeout Optional timeout in milliseconds (defaults to 5000ms)
+   * @param timeout Optional timeout in milliseconds (defaults to 15000ms)
    * @returns Promise that resolves when a matching message is found
    */
   const awaitMatch: AwaitMatchFn<any> = async (