v0.0.2: query bundles, defineEntity alias, new docs and tutorial

Author: doeixd

CHANGELOG.md

@@ -5,6 +5,20 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.0.2] - 2026-06-03
+
+### Added
+
+- `defineEntity()` object-form alias for `entity()` — named fields for larger schemas
+- `DbQueryBundle`, `DbQueryBundleContext`, `DbQueryBundleStage` exports for composable query pipelines
+- `EntityCache` and `SelectedEntityCache` type exports for optimistic cache integration
+- New docs: `tutorial.md`, `requests.md`, `actions-live-views.md`
+
+### Changed
+
+- Expanded query bundle infrastructure in `db.ts` and `react.ts`
+- Query collection adapter improvements
+
 ## [0.0.1] - 2026-06-02
 
 ### Added
@@ -24,4 +38,5 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - SSR hydration with confirmed-state snapshots
 - Testing utilities: memory DBs, fixtures, mocks, render helpers
 
+[0.0.2]: https://github.com/doeixd/tanstackstart-db/releases/tag/v0.0.2
 [0.0.1]: https://github.com/doeixd/tanstackstart-db/releases/tag/v0.0.1

README.md

@@ -727,11 +727,12 @@ expect(data.post.title).toBe("Hello");
 @doeixd/tanstackstart-db/sync-collection
 ```
 
-Optional peer dependencies are only needed for the entrypoints you use:
+Peer dependency requirements by entrypoint:
 
 - `@tanstack/query-core` and `@tanstack/query-db-collection` for
   `query-collection`
-- `@tanstack/react-router` and `react` for `react`
+- `react` and `@tanstack/react-router` for the root package and `react`
+- `react-dom` for `testing`
 
 ## Development
 

docs/README.md

@@ -6,30 +6,36 @@ files in this folder are the deep-dives.
 
 ## Topics
 
-| Document                                                             | What it covers                                                                                               |
-| -------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------ |
-| [`design.md`](./design.md)                                           | Positioning, "not Fate", relationship to TanStack DB, escape hatches, the rationale for the API choices.     |
-| [`views.md`](./views.md)                                             | Defining views, field selection, nested relationship projections, deep-freeze, view-aware query specs.       |
-| [`relationships.md`](./relationships.md)                             | `api.one` / `api.many` declarations, generated helpers, foldable joins, post-execute materialization.        |
-| [`pagination.md`](./pagination.md)                                   | `createInfiniteQuery`, the `null` / `undefined` terminator, the React hooks, route integration, SSR warming. |
-| [`authorization.md`](./authorization.md)                             | The `authorize` hook, `DbAuthError`, shared gates, ordering relative to optimistic / run.                    |
-| [`optimistic-conflict-offline.md`](./optimistic-conflict-offline.md) | Optimistic overlays, rollback, `DbConflictError`, `DbOfflineError`, recovery patterns.                       |
-| [`action-aliases.md`](./action-aliases.md)                           | `.with(...)`, `.extend(...)`, route-level aliasing, `actionName` preservation, generated CRUD auto-affects.  |
-| [`query-keys.md`](./query-keys.md)                                   | The default key shape, explicit keys, view bindings, React resource cache dedup, action-side invalidation.   |
-| [`devtools.md`](./devtools.md)                                       | Deferred to v0.2. Placeholder with the design intent and the open questions.                                 |
+| Document                                                             | What it covers                                                                                                |
+| -------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------- |
+| [`tutorial.md`](./tutorial.md)                                       | A progressive refactor from a normal posts route with a like button into schema-backed DB routes and actions. |
+| [`design.md`](./design.md)                                           | Positioning, "not Fate", relationship to TanStack DB, escape hatches, the rationale for the API choices.      |
+| [`views.md`](./views.md)                                             | Defining views, field selection, nested relationship projections, deep-freeze, view-aware query specs.        |
+| [`requests.md`](./requests.md)                                       | Query specs, route data contracts, request keys, cache modes, collection lifetime, SSR, and hydration.        |
+| [`relationships.md`](./relationships.md)                             | `api.one` / `api.many` declarations, generated helpers, foldable joins, post-execute materialization.         |
+| [`pagination.md`](./pagination.md)                                   | `createInfiniteQuery`, the `null` / `undefined` terminator, the React hooks, route integration, SSR warming.  |
+| [`authorization.md`](./authorization.md)                             | The `authorize` hook, `DbAuthError`, shared gates, ordering relative to optimistic / run.                     |
+| [`optimistic-conflict-offline.md`](./optimistic-conflict-offline.md) | Optimistic overlays, rollback, `DbConflictError`, `DbOfflineError`, recovery patterns.                        |
+| [`action-aliases.md`](./action-aliases.md)                           | `.with(...)`, `.extend(...)`, route-level aliasing, `actionName` preservation, generated CRUD auto-affects.   |
+| [`query-keys.md`](./query-keys.md)                                   | The default key shape, explicit keys, view bindings, React resource cache dedup, action-side invalidation.    |
+| [`actions-live-views.md`](./actions-live-views.md)                   | Project-native equivalents for actions, optimistic writes, live queries, pagination, and view composition.    |
+| [`devtools.md`](./devtools.md)                                       | Deferred to v0.2. Placeholder with the design intent and the open questions.                                  |
 
 ## Reading order
 
 If you are new to the package, the suggested reading order is:
 
 1. `design.md` — the positioning and the rationale for the API.
-2. `views.md` — the view contract is the first thing most users touch.
-3. `relationships.md` — the schema declaration that views depend on.
-4. `query-keys.md` — how the runtime identifies a query.
-5. `pagination.md` — only if you need infinite queries.
-6. `action-aliases.md` — the action chain and route-level aliasing.
-7. `authorization.md` — the per-action gate.
-8. `optimistic-conflict-offline.md` — the failure modes and recovery.
+2. `tutorial.md` — the practical adoption path from a normal route.
+3. `views.md` — the view contract is the first thing most users touch.
+4. `requests.md` — how reads, route data, and hydration work.
+5. `relationships.md` — the schema declaration that views depend on.
+6. `query-keys.md` — how the runtime identifies a query.
+7. `pagination.md` — only if you need infinite queries.
+8. `action-aliases.md` — the action chain and route-level aliasing.
+9. `authorization.md` — the per-action gate.
+10. `optimistic-conflict-offline.md` — the failure modes and recovery.
+11. `actions-live-views.md` — a cross-topic map of common app patterns.
 
 The Devtools document is a placeholder; the rest of the package is the
 v0.1 surface.