CHANGELOG.md

@tanstack/react-db

0.1.76

Patch Changes

• Updated dependencies [eeb5321, 495abc2, a55e2bf, 41c0ea2]:
  • @tanstack/db@0.5.32

0.1.75

Patch Changes

• Add Intent agent skills (SKILL.md files) to guide AI coding agents. Include skills for core DB concepts, all 5 framework bindings, meta-framework integration, and offline transactions. Also add export * from '@tanstack/db' to angular-db for consistency with other framework packages. (#1330)

• fix(react-db): make getNextPageParam optional in useLiveInfiniteQuery (#1268)

• fix(react-db): handle rejected/stale setWindow promises in useLiveInfiniteQuery (#1269)

• Updated dependencies [bf1d078]:

  • @tanstack/db@0.5.31

0.1.74

Patch Changes

• Updated dependencies [e9d0fd8]:
  • @tanstack/db@0.5.30

0.1.73

Patch Changes

• Updated dependencies [77b815e, ac4ce67]:
  • @tanstack/db@0.5.29

0.1.72

Patch Changes

• Updated dependencies [46450e7]:
  • @tanstack/db@0.5.28

0.1.71

Patch Changes

• Updated dependencies [802550f, dc41d7d, 4ff3da5, 2223cd6]:
  • @tanstack/db@0.5.27

0.1.70

Patch Changes

• Fix useLiveInfiniteQuery peek-ahead detection for hasNextPage. The initial query now correctly requests pageSize + 1 items to detect whether additional pages exist, matching the behavior of subsequent page loads. (#1209)

  Fix async on-demand pagination by ensuring the graph callback fires at least once even when there is no pending graph work, so that loadMoreIfNeeded is triggered after setWindow() increases the limit.

• Updated dependencies [85c373e, 9184dcc, 83d5ac8]:

  • @tanstack/db@0.5.26

0.1.69

Patch Changes

• Updated dependencies [43c7c9d, 284ebcc]:
  • @tanstack/db@0.5.25

0.1.68

Patch Changes

• Updated dependencies [7099459]:
  • @tanstack/db@0.5.24

0.1.67

Patch Changes

• Updated dependencies [05130f2]:
  • @tanstack/db@0.5.23

0.1.66

Patch Changes

• Updated dependencies [f9b741e]:
  • @tanstack/db@0.5.22

0.1.65

Patch Changes

• Updated dependencies [6745ed0, 1b22e40, 7a2cacd, bdf9405]:
  • @tanstack/db@0.5.21

0.1.64

Patch Changes

• Updated dependencies []:
  • @tanstack/db@0.5.20

0.1.63

Patch Changes

• Updated dependencies [29033b8, 888ad6a]:
  • @tanstack/db@0.5.19

0.1.62

Patch Changes

• Updated dependencies [c1247e8]:
  • @tanstack/db@0.5.18

0.1.61

Patch Changes

• Improve runtime error message and documentation when useLiveSuspenseQuery receives undefined from query callback. (#860)

  Following TanStack Query's useSuspenseQuery design, useLiveSuspenseQuery intentionally does not support disabled queries (when callback returns undefined or null). This maintains the type guarantee that data is always T (not T | undefined), which is a core benefit of using Suspense.

  What changed:

  1. Improved runtime error message with clear guidance:

  useLiveSuspenseQuery does not support disabled queries (callback returned undefined/null).
  The Suspense pattern requires data to always be defined (T, not T | undefined).
  Solutions:
  1) Use conditional rendering - don't render the component until the condition is met.
  2) Use useLiveQuery instead, which supports disabled queries with the 'isEnabled' flag.
  

  2. Enhanced JSDoc documentation with detailed @remarks section explaining the design decision, showing both incorrect (❌) and correct (✅) patterns

  Why this matters:

  // ❌ This pattern doesn't work with Suspense queries:
  const { data } = useLiveSuspenseQuery(
    (q) => userId
      ? q.from({ users }).where(({ users }) => eq(users.id, userId)).findOne()
      : undefined,
    [userId]
  )
  
  // ✅ Instead, use conditional rendering:
  function UserProfile({ userId }: { userId: string }) {
    const { data } = useLiveSuspenseQuery(
      (q) => q.from({ users }).where(({ users }) => eq(users.id, userId)).findOne(),
      [userId]
    )
    return <div>{data.name}</div> // data is guaranteed non-undefined
  }
  
  function App({ userId }: { userId?: string }) {
    if (!userId) return <div>No user selected</div>
    return <UserProfile userId={userId} />
  }
  
  // ✅ Or use useLiveQuery for conditional queries:
  const { data, isEnabled } = useLiveQuery(
    (q) => userId
      ? q.from({ users }).where(({ users }) => eq(users.id, userId)).findOne()
      : undefined,
    [userId]
  )

  This aligns with TanStack Query's philosophy where Suspense queries prioritize type safety and proper component composition over flexibility.

• Updated dependencies [f795a67, d542667, 6503c09, b1cc4a7]:

  • @tanstack/db@0.5.17

0.1.60

Patch Changes

• Updated dependencies [41308b8]:
  • @tanstack/db@0.5.16

0.1.59

Patch Changes

• Updated dependencies [32ec4d8]:
  • @tanstack/db@0.5.15

0.1.58

Patch Changes

• Updated dependencies [26ed0aa]:
  • @tanstack/db@0.5.14

0.1.57

Patch Changes

• Updated dependencies [8ed7725, 01452bf]:
  • @tanstack/db@0.5.13

0.1.56

Patch Changes

• Updated dependencies [b3b1940, 09da081, 86ad40c]:
  • @tanstack/db@0.5.12

0.1.55

Patch Changes

• Fixed isReady to return true for disabled queries in useLiveQuery/injectLiveQuery across all framework packages. When a query function returns null or undefined (disabling the query), there's no async operation to wait for, so the hook should be considered "ready" immediately. (#886)

  Additionally, all frameworks now have proper TypeScript overloads that explicitly support returning undefined | null from query functions, making the disabled query pattern type-safe.

  This fixes the common pattern where users conditionally enable queries and don't want to show loading states when the query is disabled.

• Updated dependencies [c4b9399, a1a484e]:

  • @tanstack/db@0.5.11

0.1.54

Patch Changes

• Updated dependencies [1d19d22, b3e4e80]:
  • @tanstack/db@0.5.10

0.1.53

Patch Changes

• Updated dependencies [5f474f1]:
  • @tanstack/db@0.5.9

0.1.52

Patch Changes

• Updated dependencies [954c8fe, 51c73aa]:
  • @tanstack/db@0.5.8

0.1.51

Patch Changes

• Updated dependencies [295cb45]:
  • @tanstack/db@0.5.7

0.1.50

Patch Changes

• Updated dependencies [c8a2c16]:
  • @tanstack/db@0.5.6

0.1.49

Patch Changes

• Updated dependencies [077fc1a]:
  • @tanstack/db@0.5.5

0.1.48

Patch Changes

• Updated dependencies [acb3e4f, 464805d, 2c2e4db, 15c772f]:
  • @tanstack/db@0.5.4

0.1.47

Patch Changes

• Updated dependencies [846a830, 8e26dcf]:
  • @tanstack/db@0.5.3

0.1.46

Patch Changes

• Updated dependencies [99a3716]:
  • @tanstack/db@0.5.2

0.1.45

Patch Changes

• Updated dependencies [a83a818]:
  • @tanstack/db@0.5.1

0.1.44

Patch Changes

• Updated dependencies [243a35a, f9d11fc, 7aedf12, 28f81b5, 28f81b5, f6ac7ea, 01093a7]:
  • @tanstack/db@0.5.0

0.1.43

Patch Changes

• Updated dependencies [6c55e16, 7805afb, 1367756]:
  • @tanstack/db@0.4.20

0.1.42

Patch Changes

• Updated dependencies [75470a8]:
  • @tanstack/db@0.4.19

0.1.41

Patch Changes

• Add useLiveSuspenseQuery hook for React Suspense support (#697)

  Introduces a new useLiveSuspenseQuery hook that integrates with React Suspense and Error Boundaries, following TanStack Query's useSuspenseQuery pattern.

  Key features:

  • React 18+ compatible using the throw promise pattern
  • Type-safe API with guaranteed data (never undefined)
  • Automatic error handling via Error Boundaries
  • Reactive updates after initial load via useSyncExternalStore
  • Support for dependency-based re-suspension
  • Works with query functions, config objects, and pre-created collections

  Example usage:

  import { Suspense } from 'react'
  import { useLiveSuspenseQuery } from '@tanstack/react-db'
  
  function TodoList() {
    // Data is guaranteed to be defined - no isLoading needed
    const { data } = useLiveSuspenseQuery((q) =>
      q
        .from({ todos: todosCollection })
        .where(({ todos }) => eq(todos.completed, false)),
    )
  
    return (
      <ul>
        {data.map((todo) => (
          <li key={todo.id}>{todo.text}</li>
        ))}
      </ul>
    )
  }
  
  function App() {
    return (
      <Suspense fallback={<div>Loading...</div>}>
        <TodoList />
      </Suspense>
    )
  }

  Implementation details:

  • Throws promises when collection is loading (caught by Suspense)
  • Throws errors when collection fails (caught by Error Boundary)
  • Reuses promise across re-renders to prevent infinite loops
  • Detects dependency changes and creates new collection/promise
  • Same TypeScript overloads as useLiveQuery for consistency

  Documentation:

  • Comprehensive guide in live-queries.md covering usage patterns and when to use each hook
  • Comparison with useLiveQuery showing different approaches to loading/error states
  • Router loader pattern recommendation for React Router/TanStack Router users
  • Error handling examples with Suspense and Error Boundaries

  Resolves #692

0.1.40

Patch Changes

• Updated dependencies [f416231, b1b8299]:
  • @tanstack/db@0.4.18

0.1.39

Patch Changes

• Updated dependencies [49bcaa5]:
  • @tanstack/db@0.4.17

0.1.38

Patch Changes

• Add paced mutations with pluggable timing strategies (#704)

  Introduces a new paced mutations system that enables optimistic mutations with pluggable timing strategies. This provides fine-grained control over when and how mutations are persisted to the backend. Powered by TanStack Pacer.

  Key Design:

  • Debounce/Throttle: Only one pending transaction (collecting mutations) and one persisting transaction (writing to backend) at a time. Multiple rapid mutations automatically merge together.
  • Queue: Each mutation creates a separate transaction, guaranteed to run in the order they're made (FIFO by default, configurable to LIFO).

  Core Features:

  • Pluggable Strategy System: Choose from debounce, queue, or throttle strategies to control mutation timing
  • Auto-merging Mutations: Multiple rapid mutations on the same item automatically merge for efficiency (debounce/throttle only)
  • Transaction Management: Full transaction lifecycle tracking (pending → persisting → completed/failed)
  • React Hook: usePacedMutations for easy integration in React applications

  Available Strategies:

  • debounceStrategy: Wait for inactivity before persisting. Only final state is saved. (ideal for auto-save, search-as-you-type)
  • queueStrategy: Each mutation becomes a separate transaction, processed sequentially in order (defaults to FIFO, configurable to LIFO). All mutations are guaranteed to persist. (ideal for sequential workflows, rate-limited APIs)
  • throttleStrategy: Ensure minimum spacing between executions. Mutations between executions are merged. (ideal for analytics, progress updates)

  Example Usage:

  import { usePacedMutations, debounceStrategy } from '@tanstack/react-db'
  
  const mutate = usePacedMutations({
    mutationFn: async ({ transaction }) => {
      await api.save(transaction.mutations)
    },
    strategy: debounceStrategy({ wait: 500 }),
  })
  
  // Trigger a mutation
  const tx = mutate(() => {
    collection.update(id, (draft) => {
      draft.value = newValue
    })
  })
  
  // Optionally await persistence
  await tx.isPersisted.promise

• Updated dependencies [979a66f, f8a979b, cb25623]:

  • @tanstack/db@0.4.16

0.1.37

Patch Changes

• Updated dependencies [6738247]:
  • @tanstack/db@0.4.15

0.1.36

Patch Changes

• Updated dependencies [970616b]:
  • @tanstack/db@0.4.14

0.1.35

Patch Changes

• Updated dependencies [3c9526c]:
  • @tanstack/db@0.4.13

0.1.34

Patch Changes

• Updated dependencies [8b29841, 8187c6d]:
  • @tanstack/db@0.4.12

0.1.33

Patch Changes

• Add support for pre-created live query collections in useLiveInfiniteQuery, enabling router loader patterns where live queries can be created, preloaded, and passed to components. (#684)

• Updated dependencies [5566b26]:

  • @tanstack/db@0.4.11

0.1.32

Patch Changes

• Add useLiveInfiniteQuery hook for infinite scrolling with live updates. (#669)

  The new useLiveInfiniteQuery hook provides an infinite query pattern similar to TanStack Query's useInfiniteQuery, but with live updates from your local collection. It uses liveQueryCollection.utils.setWindow() internally to efficiently paginate through ordered data without recreating the query on each page fetch.

  Key features:

  • Automatic live updates as data changes in the collection
  • Efficient pagination using dynamic window adjustment
  • Peek-ahead mechanism to detect when more pages are available
  • Compatible with TanStack Query's infinite query API patterns

  Example usage:

  import { useLiveInfiniteQuery } from '@tanstack/react-db'
  
  function PostList() {
    const { data, pages, fetchNextPage, hasNextPage, isLoading } =
      useLiveInfiniteQuery(
        (q) =>
          q
            .from({ posts: postsCollection })
            .orderBy(({ posts }) => posts.createdAt, 'desc'),
        {
          pageSize: 20,
          getNextPageParam: (lastPage, allPages) =>
            lastPage.length === 20 ? allPages.length : undefined,
        },
      )
  
    if (isLoading) return <div>Loading...</div>
  
    return (
      <div>
        {pages.map((page, i) => (
          <div key={i}>
            {page.map((post) => (
              <PostCard key={post.id} post={post} />
            ))}
          </div>
        ))}
        {hasNextPage && (
          <button onClick={() => fetchNextPage()}>Load More</button>
        )}
      </div>
    )
  }

  Requirements:

  • Query must include .orderBy() for the window mechanism to work
  • Returns flattened data array and pages array for flexible rendering
  • Automatically detects new pages when data is synced to the collection

• Updated dependencies [63aa8ef, b0687ab]:

  • @tanstack/db@0.4.10

0.1.31

Patch Changes

• Updated dependencies [e52be92, 4a7c44a, ee61bb6]:
  • @tanstack/db@0.4.9

0.1.30

Patch Changes

• Refactored live queries to execute eagerly during sync. Live queries now materialize their results immediately as data arrives from source collections, even while those collections are still in a "loading" state, rather than waiting for all sources to be "ready" before executing. (#658)

• Updated dependencies [d9ae7b7, 44555b7]:

  • @tanstack/db@0.4.8

0.1.29

Patch Changes

• Updated dependencies [6692aad]:
  • @tanstack/db@0.4.7

0.1.28

Patch Changes

• Updated dependencies [dd6cdf7, c30a20b]:
  • @tanstack/db@0.4.6

0.1.27

Patch Changes

• Updated dependencies [7556fb6]:
  • @tanstack/db@0.4.5

0.1.26

Patch Changes

• Updated dependencies [56b870b, f623990, 5f43d5f, 05776f5, d27d32a]:
  • @tanstack/db@0.4.4

0.1.25

Patch Changes

• Updated dependencies [32f2212]:
  • @tanstack/db@0.4.3

0.1.24

Patch Changes

• Updated dependencies [51c6bc5, 248e2c6, ce7e2b2, 1b832ff]:
  • @tanstack/db@0.4.2

0.1.23

Patch Changes

• Updated dependencies [8cd0876]:
  • @tanstack/db@0.4.1

0.1.22

Patch Changes

• Let collection.subscribeChanges return a subscription object. Move all data loading code related to optimizations into that subscription object. (#564)

• Updated dependencies [2f87216, ac6250a, 2f87216]:

  • @tanstack/db@0.4.0

0.1.21

Patch Changes

• Expand useLiveQuery callback to support conditional queries and additional return types, enabling the ability to temporarily disable the query. (#535)

  New Features:

  • Callback can now return undefined or null to temporarily disable the query
  • Callback can return a pre-created Collection instance to use it directly
  • Callback can return a LiveQueryCollectionConfig object for advanced configuration
  • When disabled (returning undefined/null), the hook returns a specific idle state

  Usage Examples:

  // Conditional queries - disable when not ready
  const enabled = useState(false)
  const { data, state, isIdle } = useLiveQuery((q) => {
    if (!enabled) return undefined  // Disables the query
    return q.from({ users }).where(...)
  }, [enabled])
  
  /**
   * When disabled, returns:
   * {
   *   state: undefined,
   *   data: undefined,
   *   isIdle: true,
   *   ...
   * }
   */
  
  // Return pre-created Collection
  const { data } = useLiveQuery((q) => {
    if (usePrebuilt) return myCollection  // Use existing collection
    return q.from({ items }).select(...)
  }, [usePrebuilt])
  
  // Return LiveQueryCollectionConfig
  const { data } = useLiveQuery((q) => {
    return {
      query: q.from({ items }).select(...),
      id: `my-collection`,
    }
  })

• Updated dependencies [cacfca2]:

  • @tanstack/db@0.3.2

0.1.20

Patch Changes

• Updated dependencies [5f51f35]:
  • @tanstack/db@0.3.1

0.1.19

Patch Changes

• Updated dependencies [c557a14, b5c87f7]:
  • @tanstack/db@0.3.0

0.1.18

Patch Changes

• Updated dependencies [b03894d, 3968087]:
  • @tanstack/db@0.2.5

0.1.17

Patch Changes

• Updated dependencies [92febbf, b487430]:
  • @tanstack/db@0.2.4

0.1.16

Patch Changes

• Updated dependencies [b162556]:
  • @tanstack/db@0.2.3

0.1.15

Patch Changes

• Updated dependencies [33515c6]:
  • @tanstack/db@0.2.2

0.1.14

Patch Changes

• Updated dependencies [620ebea]:
  • @tanstack/db@0.2.1

0.1.13

Patch Changes

• Updated dependencies [08303e6, bafeaa1, 1814f8c, 31acdf2, e41ed7e, 51954d8]:
  • @tanstack/db@0.2.0

0.1.12

Patch Changes

• Updated dependencies [cc4c34a]:
  • @tanstack/db@0.1.12

0.1.11

Patch Changes

• Fixed a bug where a race condition could cause initial results not to be rendered when using useLiveQuery. (#485)

• Updated dependencies [b869f68]:

  • @tanstack/db@0.1.11

0.1.10

Patch Changes

• Updated dependencies [eb8fd18, e59a355, 074aab0, d469c39]:
  • @tanstack/db@0.1.10

0.1.9

Patch Changes

• Updated dependencies [d64b4a8]:
  • @tanstack/db@0.1.9

0.1.8

Patch Changes

• Updated dependencies [1c5e206, 4d20004, 968602e]:
  • @tanstack/db@0.1.8

0.1.7

Patch Changes

• Updated dependencies [48d0889, aecbcc3, a937f4c, 3d60fad, 79c95a3]:
  • @tanstack/db@0.1.7

0.1.6

Patch Changes

• Updated dependencies [ad33e9e]:
  • @tanstack/db@0.1.6

0.1.5

Patch Changes

• ensure that useLiveQuery returns a stable ref when there are no changes (#388)

• Updated dependencies [9a5a20c]:

  • @tanstack/db@0.1.5

0.1.4

Patch Changes

• Ensure that the ready status is correctly returned from a live query (#390)

• Updated dependencies [c90b4d8, 6c1c19c, 69a6d2d, 6250a92, 68538b4]:

  • @tanstack/db@0.1.4

0.1.3

Patch Changes

• Updated dependencies [0cb7699]:
  • @tanstack/db@0.1.3

0.1.2

Patch Changes

• Updated dependencies [bb5d50e, 97b595e]:
  • @tanstack/db@0.1.2

0.1.1

Patch Changes

• Updated dependencies [bc2f204, bda3f24]:
  • @tanstack/db@0.1.1

0.1.0

Minor Changes

• 0.1 release - first beta 🎉 (#332)

Patch Changes

• We have moved development of the differential dataflow implementation from @electric-sql/d2mini to a new @tanstack/db-ivm package inside the tanstack db monorepo to make development simpler. (#330)

• Updated dependencies [7d2f4be, f0eda36]:

  • @tanstack/db@0.1.0

0.0.33

Patch Changes

• Updated dependencies [6e8d7f6]:
  • @tanstack/db@0.0.33

0.0.32

Patch Changes

• Updated dependencies [e04bd12]:
  • @tanstack/db@0.0.32

0.0.31

Patch Changes

• Updated dependencies [3e9a36d]:
  • @tanstack/db@0.0.31

0.0.30

Patch Changes

• Updated dependencies [6bdde55]:
  • @tanstack/db@0.0.30

0.0.29

Patch Changes

• Updated dependencies [ced0657, dcfef51, 360b0df, 608be0c, 5260ee3]:
  • @tanstack/db@0.0.29

0.0.28

Patch Changes

• Updated dependencies [bb85522, e9e8e5e]:
  • @tanstack/db@0.0.28

0.0.27

Patch Changes

• Updated dependencies [bec8620]:
  • @tanstack/db@0.0.27

0.0.26

Patch Changes

• Add initial release of TrailBase collection for TanStack DB. TrailBase is a blazingly fast, open-source alternative to Firebase built on Rust, SQLite, and V8. It provides type-safe REST and realtime APIs with sub-millisecond latencies, integrated authentication, and flexible access control - all in a single executable. This collection type enables seamless integration with TrailBase backends for high-performance real-time applications. (#228)

• Updated dependencies [09c6995]:

  • @tanstack/db@0.0.26

0.0.25

Patch Changes

• Updated dependencies [1758eda, 20f810e]:
  • @tanstack/db@0.0.25

0.0.24

Patch Changes

• Updated dependencies [11215d9, fe42591, 665efe6]:
  • @tanstack/db@0.0.24

0.0.23

Patch Changes

• Updated dependencies [056609e]:
  • @tanstack/db@0.0.23

0.0.22

Patch Changes

• Updated dependencies [aeee9a1]:
  • @tanstack/db@0.0.22

0.0.21

Patch Changes

• Updated dependencies [8e23322]:
  • @tanstack/db@0.0.21

0.0.20

Patch Changes

• Updated dependencies [f13c11e]:
  • @tanstack/db@0.0.20

0.0.19

Patch Changes

• Updated dependencies [9f0b0c2]:
  • @tanstack/db@0.0.19

0.0.18

Patch Changes

• Improve jsdocs (#243)

• Updated dependencies [266bd29]:

  • @tanstack/db@0.0.18

0.0.17

Patch Changes

• Updated dependencies [7e63d76]:
  • @tanstack/db@0.0.17

0.0.16

Patch Changes

• add support for composable queries (#232)

• Updated dependencies [e478d53]:

  • @tanstack/db@0.0.16

0.0.15

Patch Changes

• Updated dependencies [f5cf44b, f5cf44b]:
  • @tanstack/db@0.0.15

0.0.14

Patch Changes

• Updated dependencies [74c140d]:
  • @tanstack/db@0.0.14

0.0.13

Patch Changes

• feat: implement Collection Lifecycle Management (#198)

  Adds automatic lifecycle management for collections to optimize resource usage.

  New Features:

  • Added startSync option (defaults to false, set to true to start syncing immediately)
  • Automatic garbage collection after gcTime (default 5 minutes) of inactivity
  • Collection status tracking: "idle" | "loading" | "ready" | "error" | "cleaned-up"
  • Manual preload() and cleanup() methods for lifecycle control

  Usage:

  const collection = createCollection({
    startSync: false, // Enable lazy loading
    gcTime: 300000, // Cleanup timeout (default: 5 minutes)
  })
  
  console.log(collection.status) // Current state
  await collection.preload() // Ensure ready
  await collection.cleanup() // Manual cleanup

• Add createOptimisticAction helper that replaces useOptimisticMutation (#210)

  An example of converting a useOptimisticMutation hook to createOptimisticAction. Now all optimistic & server mutation logic are consolidated.

  -import { useOptimisticMutation } from '@tanstack/react-db'
  +import { createOptimisticAction } from '@tanstack/react-db'
  +
  +// Create the `addTodo` action, passing in your `mutationFn` and `onMutate`.
  +const addTodo = createOptimisticAction<string>({
  +  onMutate: (text) => {
  +    // Instantly applies the local optimistic state.
  +    todoCollection.insert({
  +      id: uuid(),
  +      text,
  +      completed: false
  +    })
  +  },
  +  mutationFn: async (text) => {
  +    // Persist the todo to your backend
  +    const response = await fetch('/api/todos', {
  +      method: 'POST',
  +      body: JSON.stringify({ text, completed: false }),
  +    })
  +    return response.json()
  +  }
  +})
  
   const Todo = () => {
  -  // Create the `addTodo` mutator, passing in your `mutationFn`.
  -  const addTodo = useOptimisticMutation({ mutationFn })
  -
     const handleClick = () => {
  -    // Triggers the mutationFn
  -    addTodo.mutate(() =>
  -      // Instantly applies the local optimistic state.
  -      todoCollection.insert({
  -        id: uuid(),
  -        text: '🔥 Make app faster',
  -        completed: false
  -      })
  -    )
  +    // Triggers the onMutate and then the mutationFn
  +    addTodo('🔥 Make app faster')
     }
  
     return <Button onClick={ handleClick } />
   }

• Updated dependencies [945868e, 0f8a008, 57b5f5d]:

  • @tanstack/db@0.0.13

0.0.12

Patch Changes

• Updated dependencies [f6abe9b]:
  • @tanstack/db@0.0.12

0.0.11

Patch Changes

• Export ElectricCollectionUtils & allow passing generic to createTransaction (#179)

• Updated dependencies [66ed58b, c5489ff]:

  • @tanstack/db@0.0.11

0.0.10

Patch Changes

• Updated dependencies [38d4505]:
  • @tanstack/db@0.0.10

0.0.9

Patch Changes

• Updated dependencies [2ae0b09]:
  • @tanstack/db@0.0.9

0.0.8

Patch Changes

• A large refactor of the core Collection with: (#155)

  • a change to not use Store internally and emit fine grade changes with subscribeChanges and subscribeKeyChanges methods.
  • changes to the Collection api to be more Map like for reads, with get, has, size, entries, keys, and values.
  • renames config.getId to config.getKey for consistency with the Map like api.

• Updated dependencies [5c538cf, 9553366, b4602a0, 02adc81, 06d8ecc, c50cd51]:

  • @tanstack/db@0.0.8

0.0.7

Patch Changes

• Expose utilities on collection instances (#161)

  Implemented a utility exposure pattern for TanStack DB collections that allows utility functions to be passed as part of collection options and exposes them under a .utils namespace, with full TypeScript typing.

  • Refactored createCollection in packages/db/src/collection.ts to accept options with utilities directly
  • Added utils property to CollectionImpl
  • Added TypeScript types for utility functions and utility records
  • Changed Collection from a class to a type, updating all usages to use createCollection() instead
  • Updated Electric/Query implementations
  • Utilities are now ergonomically accessible under .utils
  • Full TypeScript typing is preserved for both collection data and utilities
  • API is clean and straightforward - users can call createCollection(optionsCreator(config)) directly
  • Zero-boilerplate TypeScript pattern that infers utility types automatically

• Updated dependencies [8b43ad3]:

  • @tanstack/db@0.0.7

0.0.6

Patch Changes

• Updated dependencies [856be72, 0455e27, 80fdac7]:
  • @tanstack/db@0.0.6

0.0.5

Patch Changes

• Collections must have a getId function & use an id for update/delete operators (#134)

• the keyBy query operator has been removed, keying withing the query pipeline is now automatic (#144)

• Updated dependencies [1fbb844, 338efc2, ee5d026, e7b036c, e4feb0c]:

  • @tanstack/db@0.0.5

0.0.4

Patch Changes

• Updated dependencies [8ce449e]:
  • @tanstack/db@0.0.4

0.0.3

Patch Changes

• Updated dependencies [b29420b]:
  • @tanstack/db@0.0.3

0.0.2

Patch Changes

• Fixed an issue with injecting the optimistic state removal into the reactive live query. (#78)

• Updated dependencies [4c82edb]:

  • @tanstack/db@0.0.2

0.0.3

Patch Changes

• Make transactions first class & move ownership of mutationFn from collections to transactions (#53)

• Updated dependencies [b42479c]:

  • @tanstack/db@0.0.3

0.0.2

Patch Changes

• make mutationFn optional for read-only collections (#12)

• Updated dependencies [9bb6e89, 8eb7e9b]:

  • @tanstack/db@0.0.2

0.0.1

Patch Changes

• feat: Initial release (#2)

• Updated dependencies [2d2dd77]:

  • @tanstack/db@0.0.1