TanStack DB 0.0.6版本发布：更强大的实时查询与数据变更处理

TanStack DB是一个现代化的JavaScript数据库解决方案，旨在为前端开发者提供简单、高效的数据管理能力。它支持实时查询、乐观更新等特性，非常适合构建响应式Web应用。最新发布的0.0.6版本带来了几项重要改进，显著提升了开发体验和功能灵活性。

实时查询功能的增强

新版本对实时查询功能进行了两项重要改进，使得数据筛选和转换更加灵活和强大。

首先是where子句现在支持回调函数形式。开发者可以传入一个接收行数据作为参数的回调函数，利用完整的JavaScript能力进行数据筛选。这意味着不再局限于简单的字段比较，可以实现任意复杂的过滤逻辑。

// 使用回调函数进行复杂过滤
const filteredData = collection.liveQuery({
  where: (row) => {
    return row.age > 18 && row.name.startsWith('A');
  }
});

其次是select子句同样支持了回调函数形式。这个改进允许开发者在返回数据前对每一行进行任意转换和处理，不再局限于简单的字段选择。

// 使用回调函数转换返回数据
const transformedData = collection.liveQuery({
  select: (row) => ({
    fullName: `${row.firstName} ${row.lastName}`,
    agePlus10: row.age + 10
  })
});

这两项改进大大增强了实时查询的表达能力，使得开发者可以更灵活地处理数据，而无需在查询后额外编写数据处理代码。

数据变更处理的新模式

0.0.6版本引入了一种更直观的数据变更处理模式，简化了插入、更新和删除操作的实现方式。

现在，开发者可以直接在集合配置中定义onInsert、onUpdate和onDelete处理器。当调用collection.insert()、.update()或.delete()方法时，如果没有显式的事务环境（即不在useOptimisticMutation中），库会自动创建一个单操作事务并调用相应的处理器来持久化变更。

const posts = new Collection({
  // ...其他配置
  onInsert: async (newPost) => {
    // 持久化逻辑
    return { refetch: true }; // 可选：控制是否重新获取数据
  },
  onUpdate: async (updatedPost) => {
    // 持久化逻辑
    return { refetch: false };
  },
  onDelete: async (postId) => {
    // 持久化逻辑
    return { refetch: true };
  }
});

对于使用ElectricSQL的场景，处理器需要返回包含事务ID的对象，集合会自动等待该事务同步完成后再解析变更，确保数据一致性。

const electricPosts = new Collection({
  // ...其他配置
  onInsert: async (newPost) => {
    const result = await electricDB.insert(...);
    return { txid: result.txid }; // 必须返回事务ID
  }
});

这一改进使得常见的数据变更场景代码更加简洁直观，同时保留了useOptimisticMutation用于处理复杂事务的能力。

迁移建议与最佳实践

对于现有项目迁移到0.0.6版本，建议开发者：

1. 将简单的单集合操作从useOptimisticMutation迁移到直接调用集合方法并配置相应的处理器
2. 保留复杂的事务逻辑继续使用useOptimisticMutation
3. 利用新的实时查询回调功能简化数据处理逻辑
4. 对于ElectricSQL项目，确保所有处理器都返回正确的事务ID

新版本通过这些改进，使得TanStack DB在保持强大功能的同时，API更加简洁直观，进一步提升了开发体验和应用性能。