init: claude
This commit is contained in:
Prad Nukala committed
1 parent
2def250609
commit
3b87993d60
150 files changed
+29191
No files matched your search
@@ -0,0 +1,84 @@
|
||||
# Tanstack-Db
|
||||
|
||||
Use this skill when working with TanStack DB for building reactive client stores with live queries, optimistic mutations, and blazing-fast query engines. Ideal for real-time applications, normalized data models, and fine-grained reactivity patterns.
|
||||
|
||||
## 📚 Sources
|
||||
|
||||
This skill combines knowledge from multiple sources:
|
||||
|
||||
- ✅ **Documentation**: https://tanstack.com/db/latest/docs/
|
||||
- Pages: 150
|
||||
- ✅ **GitHub Repository**: tanstack/db
|
||||
- Code Analysis: deep
|
||||
- Issues: 0
|
||||
|
||||
## ⚠️ Data Quality
|
||||
|
||||
**523 conflicts detected** between sources.
|
||||
|
||||
**Conflict Breakdown:**
|
||||
- missing_in_docs: 523
|
||||
|
||||
See `references/conflicts.md` for detailed conflict information.
|
||||
|
||||
## 🔧 API Reference
|
||||
|
||||
*Merged from documentation and code analysis*
|
||||
|
||||
|
||||
### 💻 Undocumented APIs
|
||||
|
||||
*Found in code but not in documentation (523 total)*
|
||||
|
||||
#### `AggregateFunctionNotInSelectError`
|
||||
|
||||
*Source: code*
|
||||
|
||||
---
|
||||
|
||||
#### `AggregateFunctionNotInSelectError.constructor`
|
||||
|
||||
*Source: code*
|
||||
|
||||
---
|
||||
|
||||
#### `AggregateNotSupportedError`
|
||||
|
||||
*Source: code*
|
||||
|
||||
---
|
||||
|
||||
#### `AggregateNotSupportedError.constructor`
|
||||
|
||||
*Source: code*
|
||||
|
||||
---
|
||||
|
||||
#### `AggregateNotSupportedError.super`
|
||||
|
||||
*Source: code*
|
||||
|
||||
---
|
||||
|
||||
|
||||
*See references/api/ for complete API documentation*
|
||||
|
||||
## 📖 Reference Documentation
|
||||
|
||||
Organized by source:
|
||||
|
||||
- [Documentation](references/documentation/)
|
||||
- [Github](references/github/)
|
||||
|
||||
## 💡 When to Use This Skill
|
||||
|
||||
Use this skill when you need to:
|
||||
- Understand how to use tanstack-db
|
||||
- Look up API documentation
|
||||
- Find usage examples
|
||||
- Check for known issues or recent changes
|
||||
- Review release history
|
||||
|
||||
---
|
||||
|
||||
*Generated by Skill Seeker's unified multi-source scraper*
|
||||
File diff suppressed because it is too large.
Load diff
@@ -0,0 +1,92 @@
|
||||
# Conflict Report
|
||||
|
||||
Found **523** conflicts between sources.
|
||||
|
||||
## Severity Breakdown
|
||||
|
||||
- 🔴 **High**: 0 (action required)
|
||||
- 🟡 **Medium**: 523 (review recommended)
|
||||
- 🟢 **Low**: 0 (informational)
|
||||
|
||||
## 🟡 Medium Severity
|
||||
|
||||
### isRelativeLink
|
||||
|
||||
API exists in code (scripts/verify-links.ts) but not found in documentation
|
||||
|
||||
### normalizePath
|
||||
|
||||
API exists in code (scripts/verify-links.ts) but not found in documentation
|
||||
|
||||
### fileExistsForLink
|
||||
|
||||
API exists in code (scripts/verify-links.ts) but not found in documentation
|
||||
|
||||
### findMarkdownLinks
|
||||
|
||||
API exists in code (scripts/verify-links.ts) but not found in documentation
|
||||
|
||||
### useLiveQuery
|
||||
|
||||
API exists in code (packages/react-db/src/useLiveQuery.ts) but not found in documentation
|
||||
|
||||
### handleToggle
|
||||
|
||||
API exists in code (packages/react-db/src/useLiveQuery.ts) but not found in documentation
|
||||
|
||||
### syncDataFromCollection
|
||||
|
||||
API exists in code (packages/angular-db/src/index.ts) but not found in documentation
|
||||
|
||||
### TrailBaseDBCollectionError
|
||||
|
||||
API exists in code (packages/trailbase-db-collection/src/errors.ts) but not found in documentation
|
||||
|
||||
### TrailBaseDBCollectionError.constructor
|
||||
|
||||
API exists in code (packages/trailbase-db-collection/src/errors.ts) but not found in documentation
|
||||
|
||||
### TrailBaseDBCollectionError.super
|
||||
|
||||
API exists in code (packages/trailbase-db-collection/src/errors.ts) but not found in documentation
|
||||
|
||||
### TimeoutWaitingForIdsError
|
||||
|
||||
API exists in code (packages/trailbase-db-collection/src/errors.ts) but not found in documentation
|
||||
|
||||
### TimeoutWaitingForIdsError.constructor
|
||||
|
||||
API exists in code (packages/trailbase-db-collection/src/errors.ts) but not found in documentation
|
||||
|
||||
### ExpectedInsertTypeError
|
||||
|
||||
API exists in code (packages/trailbase-db-collection/src/errors.ts) but not found in documentation
|
||||
|
||||
### ExpectedInsertTypeError.constructor
|
||||
|
||||
API exists in code (packages/trailbase-db-collection/src/errors.ts) but not found in documentation
|
||||
|
||||
### ExpectedUpdateTypeError
|
||||
|
||||
API exists in code (packages/trailbase-db-collection/src/errors.ts) but not found in documentation
|
||||
|
||||
### ExpectedUpdateTypeError.constructor
|
||||
|
||||
API exists in code (packages/trailbase-db-collection/src/errors.ts) but not found in documentation
|
||||
|
||||
### ExpectedDeleteTypeError
|
||||
|
||||
API exists in code (packages/trailbase-db-collection/src/errors.ts) but not found in documentation
|
||||
|
||||
### ExpectedDeleteTypeError.constructor
|
||||
|
||||
API exists in code (packages/trailbase-db-collection/src/errors.ts) but not found in documentation
|
||||
|
||||
### initialFetch
|
||||
|
||||
API exists in code (packages/rxdb-db-collection/src/rxdb.ts) but not found in documentation
|
||||
|
||||
### listen
|
||||
|
||||
API exists in code (packages/trailbase-db-collection/src/trailbase.ts) but not found in documentation
|
||||
|
||||
@@ -0,0 +1,4 @@
|
||||
# Documentation
|
||||
|
||||
Reference from official documentation.
|
||||
|
||||
@@ -0,0 +1,129 @@
|
||||
# Repository README
|
||||
|
||||
<div align="center">
|
||||
<img src="./media/header_db.png" >
|
||||
</div>
|
||||
|
||||
<br />
|
||||
|
||||
<div align="center">
|
||||
<a href="https://npmjs.com/package/@tanstack/db" target="\_parent">
|
||||
<img alt="" src="https://img.shields.io/npm/dm/@tanstack/db.svg" alt="npm downloads" />
|
||||
</a>
|
||||
<a href="https://github.com/TanStack/db" target="\_parent">
|
||||
<img alt="" src="https://img.shields.io/github/stars/TanStack/db.svg?style=social&label=Star" alt="GitHub stars" />
|
||||
</a>
|
||||
<a href="https://bundlejs.com/?q=%40tanstack%2Fdb&config=%7B%22esbuild%22%3A%7B%22external%22%3A%5B%22react%22%2C%22react-dom%22%5D%7D%7D&badge=" target="\_parent">
|
||||
<img alt="" src="https://deno.bundlejs.com/?q=@tanstack/db&config={%22esbuild%22:{%22external%22:[%22react%22,%22react-dom%22]}}&badge=detailed" alt="Bundle size" />
|
||||
</a>
|
||||
</div>
|
||||
|
||||
<div align="center">
|
||||
<a href="#status">
|
||||
<img src="https://img.shields.io/badge/status-beta-yellow" alt="Status - BETA">
|
||||
</a>
|
||||
<a href="https://bestofjs.org/projects/tanstack-db">
|
||||
<img alt="Best of JS" src="https://img.shields.io/endpoint?url=https://bestofjs-serverless.now.sh/api/project-badge?fullName=TanStack%2Fdb%26since=daily" alt="Best of JS"/>
|
||||
</a>
|
||||
<a href="https://twitter.com/tan_stack">
|
||||
<img src="https://img.shields.io/twitter/follow/tan_stack.svg?style=social" alt="Follow @TanStack"/>
|
||||
</a>
|
||||
</div>
|
||||
|
||||
<div align="center">
|
||||
|
||||
### [Become a Sponsor!](https://github.com/sponsors/tannerlinsley/)
|
||||
</div>
|
||||
|
||||
# TanStack DB
|
||||
|
||||
> Tanstack DB is currently in BETA. See [the release post](https://tanstack.com/blog/tanstack-db-0.1-the-embedded-client-database-for-tanstack-query) for more details.
|
||||
|
||||
A reactive client store that lets you build fast, sync‑driven apps with a backend‑agnostic real‑time data layer:
|
||||
|
||||
- Blazing‑fast query engine for sub‑millisecond live queries, joins & aggregates
|
||||
- Fine‑grained reactivity to minimize component re‑rendering
|
||||
- Robust transaction primitives for optimistic mutations with sync & lifecycle support
|
||||
- Normalized data model that keeps backends simple and consistent
|
||||
|
||||
<a href="https://tanstack.com/db" style="font-weight:bold" >Read the docs →</a>
|
||||
<br />
|
||||
|
||||
## Get Involved
|
||||
|
||||
- We welcome issues and pull requests!
|
||||
- Participate in [GitHub discussions](https://github.com/TanStack/db/discussions)
|
||||
- Chat with the community on [Discord](https://discord.com/invite/WrRKjPJ)
|
||||
- See [CONTRIBUTING.md](./CONTRIBUTING.md) for setup instructions
|
||||
|
||||
## Partners
|
||||
|
||||
<table align="center">
|
||||
<tr>
|
||||
<td>
|
||||
<a href="https://www.coderabbit.ai/?via=tanstack&dub_id=aCcEEdAOqqutX6OS" >
|
||||
<picture>
|
||||
<source media="(prefers-color-scheme: dark)" srcset="https://tanstack.com/assets/coderabbit-dark-CMcuvjEy.svg" height="40" />
|
||||
<source media="(prefers-color-scheme: light)" srcset="https://tanstack.com/assets/coderabbit-light-DVMJ2jHi.svg" height="40" />
|
||||
<img src="https://tanstack.com/assets/coderabbit-light-DVMJ2jHi.svg" height="40" alt="CodeRabbit" />
|
||||
</picture>
|
||||
</a>
|
||||
</td>
|
||||
<td>
|
||||
<a href="https://www.cloudflare.com?utm_source=tanstack">
|
||||
<picture>
|
||||
<source media="(prefers-color-scheme: dark)" srcset="https://tanstack.com/assets/cloudflare-white-DQDB7UaL.svg" height="60" />
|
||||
<source media="(prefers-color-scheme: light)" srcset="https://tanstack.com/assets/cloudflare-black-CPufaW0B.svg" height="60" />
|
||||
<img src="https://tanstack.com/assets/cloudflare-black-CPufaW0B.svg" height="60" alt="Cloudflare" />
|
||||
</picture>
|
||||
</a>
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>
|
||||
<a href="https://electric-sql.com">
|
||||
<picture>
|
||||
<source media="(prefers-color-scheme: dark)" srcset="https://tanstack.com/assets/electric-dark-Bfu2Vl2j.svg" height="60">
|
||||
<source media="(prefers-color-scheme: light)" srcset="https://tanstack.com/assets/electric-light-C-5MDda4.svg" height="60">
|
||||
<img src="https://raw.githubusercontent.com/electric-sql/meta/main/identity/ElectricSQL-logo.with-background.sm.png" height="60" alt="ElectricSQL logo"/>
|
||||
</picture>
|
||||
</a>
|
||||
</td>
|
||||
<td>
|
||||
<a href="https://www.prisma.io?utm_source=tanstack&via=tanstack">
|
||||
<picture>
|
||||
<source media="(prefers-color-scheme: dark)" srcset="https://tanstack.com/assets/prisma-dark-DwgDxLwn.svg" height="60">
|
||||
<source media="(prefers-color-scheme: light)" srcset="https://tanstack.com/assets/prisma-light-Cloa3Onm.svg" height="60">
|
||||
<img src="https://tanstack.com/assets/prisma-dark-DwgDxLwn.svg" height="60" alt="Prisma"/>
|
||||
</picture>
|
||||
</a>
|
||||
</td>
|
||||
</tr>
|
||||
</table>
|
||||
|
||||
<div align="center">
|
||||
<img src="./media/partner_logo.svg" alt="DB & you?" height="65">
|
||||
<p>
|
||||
We're looking for TanStack DB Partners to join our mission! Partner with us to push the boundaries of TanStack DB and build amazing things together.
|
||||
</p>
|
||||
<a href="mailto:partners@tanstack.com?subject=TanStack DB Partnership"><b>LET'S CHAT</b></a>
|
||||
</div>
|
||||
|
||||
## Explore the TanStack Ecosystem
|
||||
|
||||
- <a href="https://github.com/tanstack/config"><b>TanStack Config</b></a> – Tooling for JS/TS packages
|
||||
- <a href="https://github.com/tanstack/devtools"><b>TanStack DevTools</b></a> – Unified devtools panel
|
||||
- <a href="https://github.com/tanstack/form"><b>TanStack Form</b></a> – Type‑safe form state
|
||||
- <a href="https://github.com/tanstack/pacer"><b>TanStack Pacer</b></a> – Debouncing, throttling, batching <br/>
|
||||
- <a href="https://github.com/tanstack/query"><b>TanStack Query</b></a> – Async state & caching
|
||||
- <a href="https://github.com/tanstack/ranger"><b>TanStack Ranger</b></a> – Range & slider primitives
|
||||
- <a href="https://github.com/tanstack/router"><b>TanStack Router</b></a> – Type‑safe routing, caching & URL state
|
||||
- <a href="https://github.com/tanstack/router"><b>TanStack Start</b></a> – Full‑stack SSR & streaming
|
||||
- <a href="https://github.com/tanstack/store"><b>TanStack Store</b></a> – Reactive data store
|
||||
- <a href="https://github.com/tanstack/table"><b>TanStack Table</b></a> – Headless datagrids
|
||||
- <a href="https://github.com/tanstack/virtual"><b>TanStack Virtual</b></a> – Virtualized rendering
|
||||
|
||||
… and more at <a href="https://tanstack.com"><b>TanStack.com »</b></a>
|
||||
v>
|
||||
|
||||
<!-- Use the force, Luke -->
|
||||
@@ -0,0 +1,105 @@
|
||||
# GitHub Issues
|
||||
|
||||
32 recent issues.
|
||||
|
||||
## #544: Dependency Dashboard
|
||||
|
||||
**State**: open
|
||||
**URL**: https://github.com/TanStack/db/issues/544
|
||||
|
||||
## #58: Query builder needs a `union` method to combine similar collections into one
|
||||
|
||||
**State**: open
|
||||
**URL**: https://github.com/TanStack/db/issues/58
|
||||
|
||||
## #537: Make QueryCollection refetch() target exact query only
|
||||
|
||||
**State**: closed
|
||||
**Labels**: query-collection
|
||||
**URL**: https://github.com/TanStack/db/issues/537
|
||||
|
||||
## #182: add a `.findOne()` to query build to return the first item
|
||||
|
||||
**State**: closed
|
||||
**URL**: https://github.com/TanStack/db/issues/182
|
||||
|
||||
## #722: Local collection manual transaction does not work
|
||||
|
||||
**State**: open
|
||||
**URL**: https://github.com/TanStack/db/issues/722
|
||||
|
||||
## #288: Joins with a hierarchical projection (includes)
|
||||
|
||||
**State**: open
|
||||
**URL**: https://github.com/TanStack/db/issues/288
|
||||
|
||||
## #720: Aggregate inside expression (e.g. `coalesce(count(...), 0)`) throws `QueryCompilationError: Unknown expression type: agg`
|
||||
|
||||
**State**: open
|
||||
**URL**: https://github.com/TanStack/db/issues/720
|
||||
|
||||
## #652: Ability to create collections with parameterized query functions
|
||||
|
||||
**State**: open
|
||||
**URL**: https://github.com/TanStack/db/issues/652
|
||||
|
||||
## #706: writeDelete silently failing
|
||||
|
||||
**State**: closed
|
||||
**URL**: https://github.com/TanStack/db/issues/706
|
||||
|
||||
## #710: Missing/Moved RxDB Documentation
|
||||
|
||||
**State**: open
|
||||
**URL**: https://github.com/TanStack/db/issues/710
|
||||
|
||||
## #691: Prevent "LocalStorageCollectionError" when local-storage collections are imported on the server
|
||||
|
||||
**State**: closed
|
||||
**URL**: https://github.com/TanStack/db/issues/691
|
||||
|
||||
## #619: Deduplicate queries by `id`
|
||||
|
||||
**State**: open
|
||||
**URL**: https://github.com/TanStack/db/issues/619
|
||||
|
||||
## #545: Add SSR & RSC Support for @tanstack/react-db
|
||||
|
||||
**State**: open
|
||||
**URL**: https://github.com/TanStack/db/issues/545
|
||||
|
||||
## #692: Support suspense in React
|
||||
|
||||
**State**: open
|
||||
**URL**: https://github.com/TanStack/db/issues/692
|
||||
|
||||
## #689: Validate that only live query collections are passed to useLiveQuery
|
||||
|
||||
**State**: closed
|
||||
**URL**: https://github.com/TanStack/db/issues/689
|
||||
|
||||
## #690: useLiveQuery (react) triggers extra mount re-render when collection is already ready
|
||||
|
||||
**State**: open
|
||||
**URL**: https://github.com/TanStack/db/issues/690
|
||||
|
||||
## #677: live query with joins emits delete events on ready
|
||||
|
||||
**State**: open
|
||||
**URL**: https://github.com/TanStack/db/issues/677
|
||||
|
||||
## #685: leftJoin + where isUndefined on right field filters out relation but not the row
|
||||
|
||||
**State**: open
|
||||
**URL**: https://github.com/TanStack/db/issues/685
|
||||
|
||||
## #683: QueryCompilationError: Input for alias not found when subquery is optimized away
|
||||
|
||||
**State**: open
|
||||
**URL**: https://github.com/TanStack/db/issues/683
|
||||
|
||||
## #471: useLiveQuery returning stale results when querying local storage collection
|
||||
|
||||
**State**: open
|
||||
**URL**: https://github.com/TanStack/db/issues/471
|
||||
|
||||
@@ -0,0 +1,106 @@
|
||||
# Releases
|
||||
|
||||
## @tanstack/query-db-collection@0.2.37: @tanstack/query-db-collection@0.2.37
|
||||
|
||||
**Published**: 2025-10-27
|
||||
|
||||
### Patch Changes
|
||||
|
||||
- **Behavior change**: `utils.refetch()` now uses exact query key targeting (previously used prefix matching). This prevents unintended cascading refetches of related queries. For example, refetching `['todos', 'project-1']` will no longer trigger refetches of `['todos']` or `['todos', 'project-2']`. ([#552](https://github.com/TanStack/db/pull/552))
|
||||
|
||||
Additionally, `utils.refetch()` now bypasses `enabled: false` to support manual/imperative refetch patterns (matching TanS
|
||||
|
||||
## @tanstack/vue-db@0.0.69: @tanstack/vue-db@0.0.69
|
||||
|
||||
**Published**: 2025-10-24
|
||||
|
||||
### Patch Changes
|
||||
|
||||
- Updated dependencies \[[`970616b`](https://github.com/TanStack/db/commit/970616b6db723d1716eecd5076417de5d6e9a884)]:
|
||||
- @tanstack/db@0.4.14
|
||||
|
||||
|
||||
## @tanstack/trailbase-db-collection@0.1.36: @tanstack/trailbase-db-collection@0.1.36
|
||||
|
||||
**Published**: 2025-10-24
|
||||
|
||||
### Patch Changes
|
||||
|
||||
- Updated dependencies \[[`970616b`](https://github.com/TanStack/db/commit/970616b6db723d1716eecd5076417de5d6e9a884)]:
|
||||
- @tanstack/db@0.4.14
|
||||
|
||||
|
||||
## @tanstack/svelte-db@0.1.36: @tanstack/svelte-db@0.1.36
|
||||
|
||||
**Published**: 2025-10-24
|
||||
|
||||
### Patch Changes
|
||||
|
||||
- Updated dependencies \[[`970616b`](https://github.com/TanStack/db/commit/970616b6db723d1716eecd5076417de5d6e9a884)]:
|
||||
- @tanstack/db@0.4.14
|
||||
|
||||
|
||||
## @tanstack/solid-db@0.1.36: @tanstack/solid-db@0.1.36
|
||||
|
||||
**Published**: 2025-10-24
|
||||
|
||||
### Patch Changes
|
||||
|
||||
- Updated dependencies \[[`970616b`](https://github.com/TanStack/db/commit/970616b6db723d1716eecd5076417de5d6e9a884)]:
|
||||
- @tanstack/db@0.4.14
|
||||
|
||||
|
||||
## @tanstack/rxdb-db-collection@0.1.25: @tanstack/rxdb-db-collection@0.1.25
|
||||
|
||||
**Published**: 2025-10-24
|
||||
|
||||
### Patch Changes
|
||||
|
||||
- Updated dependencies \[[`970616b`](https://github.com/TanStack/db/commit/970616b6db723d1716eecd5076417de5d6e9a884)]:
|
||||
- @tanstack/db@0.4.14
|
||||
|
||||
|
||||
## @tanstack/react-db@0.1.36: @tanstack/react-db@0.1.36
|
||||
|
||||
**Published**: 2025-10-24
|
||||
|
||||
### Patch Changes
|
||||
|
||||
- Updated dependencies \[[`970616b`](https://github.com/TanStack/db/commit/970616b6db723d1716eecd5076417de5d6e9a884)]:
|
||||
- @tanstack/db@0.4.14
|
||||
|
||||
|
||||
## @tanstack/query-db-collection@0.2.36: @tanstack/query-db-collection@0.2.36
|
||||
|
||||
**Published**: 2025-10-24
|
||||
|
||||
### Patch Changes
|
||||
|
||||
- Updated dependencies \[[`970616b`](https://github.com/TanStack/db/commit/970616b6db723d1716eecd5076417de5d6e9a884)]:
|
||||
- @tanstack/db@0.4.14
|
||||
|
||||
|
||||
## @tanstack/electric-db-collection@0.1.38: @tanstack/electric-db-collection@0.1.38
|
||||
|
||||
**Published**: 2025-10-24
|
||||
|
||||
### Patch Changes
|
||||
|
||||
- Updated dependencies \[[`970616b`](https://github.com/TanStack/db/commit/970616b6db723d1716eecd5076417de5d6e9a884)]:
|
||||
- @tanstack/db@0.4.14
|
||||
|
||||
|
||||
## @tanstack/db@0.4.14: @tanstack/db@0.4.14
|
||||
|
||||
**Published**: 2025-10-24
|
||||
|
||||
### Patch Changes
|
||||
|
||||
- Fix collection cleanup to fire status:change event with 'cleaned-up' status ([#714](https://github.com/TanStack/db/pull/714))
|
||||
|
||||
Previously, when a collection was garbage collected, event handlers were removed before the status was changed to 'cleaned-up'. This prevented listeners from receiving the status:change event, breaking the collection factory pattern where collections listen for cleanup to remove themselves from a cache.
|
||||
|
||||
Now, the cleanup process:
|
||||
|
||||
1. C
|
||||
|
||||
Reference in new issue
Block a user