Skip to content

Commit 378c03b

Browse files
docs: regenerate API documentation (#885)
Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
1 parent 0584a2c commit 378c03b

52 files changed

Lines changed: 354 additions & 115 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

docs/reference/classes/AggregateFunctionNotInSelectError.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ title: AggregateFunctionNotInSelectError
55

66
# Class: AggregateFunctionNotInSelectError
77

8-
Defined in: [packages/db/src/errors.ts:547](https://github.com/TanStack/db/blob/main/packages/db/src/errors.ts#L547)
8+
Defined in: [packages/db/src/errors.ts:556](https://github.com/TanStack/db/blob/main/packages/db/src/errors.ts#L556)
99

1010
## Extends
1111

@@ -19,7 +19,7 @@ Defined in: [packages/db/src/errors.ts:547](https://github.com/TanStack/db/blob/
1919
new AggregateFunctionNotInSelectError(functionName): AggregateFunctionNotInSelectError;
2020
```
2121

22-
Defined in: [packages/db/src/errors.ts:548](https://github.com/TanStack/db/blob/main/packages/db/src/errors.ts#L548)
22+
Defined in: [packages/db/src/errors.ts:557](https://github.com/TanStack/db/blob/main/packages/db/src/errors.ts#L557)
2323

2424
#### Parameters
2525

docs/reference/classes/AggregateNotSupportedError.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ title: AggregateNotSupportedError
55

66
# Class: AggregateNotSupportedError
77

8-
Defined in: [packages/db/src/errors.ts:663](https://github.com/TanStack/db/blob/main/packages/db/src/errors.ts#L663)
8+
Defined in: [packages/db/src/errors.ts:672](https://github.com/TanStack/db/blob/main/packages/db/src/errors.ts#L672)
99

1010
Error thrown when aggregate expressions are used outside of a GROUP BY context.
1111

@@ -21,7 +21,7 @@ Error thrown when aggregate expressions are used outside of a GROUP BY context.
2121
new AggregateNotSupportedError(): AggregateNotSupportedError;
2222
```
2323

24-
Defined in: [packages/db/src/errors.ts:664](https://github.com/TanStack/db/blob/main/packages/db/src/errors.ts#L664)
24+
Defined in: [packages/db/src/errors.ts:673](https://github.com/TanStack/db/blob/main/packages/db/src/errors.ts#L673)
2525

2626
#### Returns
2727

docs/reference/classes/BaseQueryBuilder.md

Lines changed: 19 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ title: BaseQueryBuilder
55

66
# Class: BaseQueryBuilder\<TContext\>
77

8-
Defined in: [packages/db/src/query/builder/index.ts:46](https://github.com/TanStack/db/blob/main/packages/db/src/query/builder/index.ts#L46)
8+
Defined in: [packages/db/src/query/builder/index.ts:47](https://github.com/TanStack/db/blob/main/packages/db/src/query/builder/index.ts#L47)
99

1010
## Type Parameters
1111

@@ -21,7 +21,7 @@ Defined in: [packages/db/src/query/builder/index.ts:46](https://github.com/TanSt
2121
new BaseQueryBuilder<TContext>(query): BaseQueryBuilder<TContext>;
2222
```
2323

24-
Defined in: [packages/db/src/query/builder/index.ts:49](https://github.com/TanStack/db/blob/main/packages/db/src/query/builder/index.ts#L49)
24+
Defined in: [packages/db/src/query/builder/index.ts:50](https://github.com/TanStack/db/blob/main/packages/db/src/query/builder/index.ts#L50)
2525

2626
#### Parameters
2727

@@ -43,7 +43,7 @@ Defined in: [packages/db/src/query/builder/index.ts:49](https://github.com/TanSt
4343
get fn(): object;
4444
```
4545

46-
Defined in: [packages/db/src/query/builder/index.ts:672](https://github.com/TanStack/db/blob/main/packages/db/src/query/builder/index.ts#L672)
46+
Defined in: [packages/db/src/query/builder/index.ts:698](https://github.com/TanStack/db/blob/main/packages/db/src/query/builder/index.ts#L698)
4747

4848
Functional variants of the query builder
4949
These are imperative function that are called for ery row.
@@ -175,7 +175,7 @@ query
175175
_getQuery(): QueryIR;
176176
```
177177

178-
Defined in: [packages/db/src/query/builder/index.ts:758](https://github.com/TanStack/db/blob/main/packages/db/src/query/builder/index.ts#L758)
178+
Defined in: [packages/db/src/query/builder/index.ts:784](https://github.com/TanStack/db/blob/main/packages/db/src/query/builder/index.ts#L784)
179179

180180
#### Returns
181181

@@ -189,7 +189,7 @@ Defined in: [packages/db/src/query/builder/index.ts:758](https://github.com/TanS
189189
distinct(): QueryBuilder<TContext>;
190190
```
191191

192-
Defined in: [packages/db/src/query/builder/index.ts:611](https://github.com/TanStack/db/blob/main/packages/db/src/query/builder/index.ts#L611)
192+
Defined in: [packages/db/src/query/builder/index.ts:637](https://github.com/TanStack/db/blob/main/packages/db/src/query/builder/index.ts#L637)
193193

194194
Specify that the query should return distinct rows.
195195
Deduplicates rows based on the selected columns.
@@ -218,7 +218,7 @@ query
218218
findOne(): QueryBuilder<TContext & SingleResult>;
219219
```
220220

221-
Defined in: [packages/db/src/query/builder/index.ts:631](https://github.com/TanStack/db/blob/main/packages/db/src/query/builder/index.ts#L631)
221+
Defined in: [packages/db/src/query/builder/index.ts:657](https://github.com/TanStack/db/blob/main/packages/db/src/query/builder/index.ts#L657)
222222

223223
Specify that the query should return a single result
224224

@@ -251,7 +251,7 @@ from<TSource>(source): QueryBuilder<{
251251
}>;
252252
```
253253

254-
Defined in: [packages/db/src/query/builder/index.ts:103](https://github.com/TanStack/db/blob/main/packages/db/src/query/builder/index.ts#L103)
254+
Defined in: [packages/db/src/query/builder/index.ts:129](https://github.com/TanStack/db/blob/main/packages/db/src/query/builder/index.ts#L129)
255255

256256
Specify the source table or subquery for the query
257257

@@ -299,7 +299,7 @@ query.from({ activeUsers })
299299
fullJoin<TSource>(source, onCallback): QueryBuilder<MergeContextWithJoinType<TContext, SchemaFromSource<TSource>, "full">>;
300300
```
301301

302-
Defined in: [packages/db/src/query/builder/index.ts:294](https://github.com/TanStack/db/blob/main/packages/db/src/query/builder/index.ts#L294)
302+
Defined in: [packages/db/src/query/builder/index.ts:320](https://github.com/TanStack/db/blob/main/packages/db/src/query/builder/index.ts#L320)
303303

304304
Perform a FULL JOIN with another table or subquery
305305

@@ -346,7 +346,7 @@ query
346346
groupBy(callback): QueryBuilder<TContext>;
347347
```
348348

349-
Defined in: [packages/db/src/query/builder/index.ts:533](https://github.com/TanStack/db/blob/main/packages/db/src/query/builder/index.ts#L533)
349+
Defined in: [packages/db/src/query/builder/index.ts:559](https://github.com/TanStack/db/blob/main/packages/db/src/query/builder/index.ts#L559)
350350

351351
Group rows by one or more columns for aggregation
352352

@@ -395,7 +395,7 @@ query
395395
having(callback): QueryBuilder<TContext>;
396396
```
397397

398-
Defined in: [packages/db/src/query/builder/index.ts:374](https://github.com/TanStack/db/blob/main/packages/db/src/query/builder/index.ts#L374)
398+
Defined in: [packages/db/src/query/builder/index.ts:400](https://github.com/TanStack/db/blob/main/packages/db/src/query/builder/index.ts#L400)
399399

400400
Filter grouped rows based on aggregate conditions
401401

@@ -444,7 +444,7 @@ query
444444
innerJoin<TSource>(source, onCallback): QueryBuilder<MergeContextWithJoinType<TContext, SchemaFromSource<TSource>, "inner">>;
445445
```
446446

447-
Defined in: [packages/db/src/query/builder/index.ts:268](https://github.com/TanStack/db/blob/main/packages/db/src/query/builder/index.ts#L268)
447+
Defined in: [packages/db/src/query/builder/index.ts:294](https://github.com/TanStack/db/blob/main/packages/db/src/query/builder/index.ts#L294)
448448

449449
Perform an INNER JOIN with another table or subquery
450450

@@ -494,7 +494,7 @@ join<TSource, TJoinType>(
494494
type): QueryBuilder<MergeContextWithJoinType<TContext, SchemaFromSource<TSource>, TJoinType>>;
495495
```
496496

497-
Defined in: [packages/db/src/query/builder/index.ts:146](https://github.com/TanStack/db/blob/main/packages/db/src/query/builder/index.ts#L146)
497+
Defined in: [packages/db/src/query/builder/index.ts:172](https://github.com/TanStack/db/blob/main/packages/db/src/query/builder/index.ts#L172)
498498

499499
Join another table or subquery to the current query
500500

@@ -562,7 +562,7 @@ query
562562
leftJoin<TSource>(source, onCallback): QueryBuilder<MergeContextWithJoinType<TContext, SchemaFromSource<TSource>, "left">>;
563563
```
564564

565-
Defined in: [packages/db/src/query/builder/index.ts:216](https://github.com/TanStack/db/blob/main/packages/db/src/query/builder/index.ts#L216)
565+
Defined in: [packages/db/src/query/builder/index.ts:242](https://github.com/TanStack/db/blob/main/packages/db/src/query/builder/index.ts#L242)
566566

567567
Perform a LEFT JOIN with another table or subquery
568568

@@ -609,7 +609,7 @@ query
609609
limit(count): QueryBuilder<TContext>;
610610
```
611611

612-
Defined in: [packages/db/src/query/builder/index.ts:566](https://github.com/TanStack/db/blob/main/packages/db/src/query/builder/index.ts#L566)
612+
Defined in: [packages/db/src/query/builder/index.ts:592](https://github.com/TanStack/db/blob/main/packages/db/src/query/builder/index.ts#L592)
613613

614614
Limit the number of rows returned by the query
615615
`orderBy` is required for `limit`
@@ -646,7 +646,7 @@ query
646646
offset(count): QueryBuilder<TContext>;
647647
```
648648

649-
Defined in: [packages/db/src/query/builder/index.ts:590](https://github.com/TanStack/db/blob/main/packages/db/src/query/builder/index.ts#L590)
649+
Defined in: [packages/db/src/query/builder/index.ts:616](https://github.com/TanStack/db/blob/main/packages/db/src/query/builder/index.ts#L616)
650650

651651
Skip a number of rows before returning results
652652
`orderBy` is required for `offset`
@@ -684,7 +684,7 @@ query
684684
orderBy(callback, options): QueryBuilder<TContext>;
685685
```
686686

687-
Defined in: [packages/db/src/query/builder/index.ts:462](https://github.com/TanStack/db/blob/main/packages/db/src/query/builder/index.ts#L462)
687+
Defined in: [packages/db/src/query/builder/index.ts:488](https://github.com/TanStack/db/blob/main/packages/db/src/query/builder/index.ts#L488)
688688

689689
Sort the query results by one or more columns
690690

@@ -734,7 +734,7 @@ query
734734
rightJoin<TSource>(source, onCallback): QueryBuilder<MergeContextWithJoinType<TContext, SchemaFromSource<TSource>, "right">>;
735735
```
736736

737-
Defined in: [packages/db/src/query/builder/index.ts:242](https://github.com/TanStack/db/blob/main/packages/db/src/query/builder/index.ts#L242)
737+
Defined in: [packages/db/src/query/builder/index.ts:268](https://github.com/TanStack/db/blob/main/packages/db/src/query/builder/index.ts#L268)
738738

739739
Perform a RIGHT JOIN with another table or subquery
740740

@@ -781,7 +781,7 @@ query
781781
select<TSelectObject>(callback): QueryBuilder<WithResult<TContext, ResultTypeFromSelect<TSelectObject>>>;
782782
```
783783

784-
Defined in: [packages/db/src/query/builder/index.ts:421](https://github.com/TanStack/db/blob/main/packages/db/src/query/builder/index.ts#L421)
784+
Defined in: [packages/db/src/query/builder/index.ts:447](https://github.com/TanStack/db/blob/main/packages/db/src/query/builder/index.ts#L447)
785785

786786
Select specific columns or computed values from the query
787787

@@ -842,7 +842,7 @@ query
842842
where(callback): QueryBuilder<TContext>;
843843
```
844844

845-
Defined in: [packages/db/src/query/builder/index.ts:333](https://github.com/TanStack/db/blob/main/packages/db/src/query/builder/index.ts#L333)
845+
Defined in: [packages/db/src/query/builder/index.ts:359](https://github.com/TanStack/db/blob/main/packages/db/src/query/builder/index.ts#L359)
846846

847847
Filter rows based on a condition
848848

docs/reference/classes/CannotCombineEmptyExpressionListError.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ title: CannotCombineEmptyExpressionListError
55

66
# Class: CannotCombineEmptyExpressionListError
77

8-
Defined in: [packages/db/src/errors.ts:626](https://github.com/TanStack/db/blob/main/packages/db/src/errors.ts#L626)
8+
Defined in: [packages/db/src/errors.ts:635](https://github.com/TanStack/db/blob/main/packages/db/src/errors.ts#L635)
99

1010
## Extends
1111

@@ -19,7 +19,7 @@ Defined in: [packages/db/src/errors.ts:626](https://github.com/TanStack/db/blob/
1919
new CannotCombineEmptyExpressionListError(): CannotCombineEmptyExpressionListError;
2020
```
2121

22-
Defined in: [packages/db/src/errors.ts:627](https://github.com/TanStack/db/blob/main/packages/db/src/errors.ts#L627)
22+
Defined in: [packages/db/src/errors.ts:636](https://github.com/TanStack/db/blob/main/packages/db/src/errors.ts#L636)
2323

2424
#### Returns
2525

docs/reference/classes/CollectionInputNotFoundError.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ title: CollectionInputNotFoundError
55

66
# Class: CollectionInputNotFoundError
77

8-
Defined in: [packages/db/src/errors.ts:407](https://github.com/TanStack/db/blob/main/packages/db/src/errors.ts#L407)
8+
Defined in: [packages/db/src/errors.ts:416](https://github.com/TanStack/db/blob/main/packages/db/src/errors.ts#L416)
99

1010
Error thrown when a collection input stream is not found during query compilation.
1111
In self-joins, each alias (e.g., 'employee', 'manager') requires its own input stream.
@@ -25,7 +25,7 @@ new CollectionInputNotFoundError(
2525
availableKeys?): CollectionInputNotFoundError;
2626
```
2727
28-
Defined in: [packages/db/src/errors.ts:408](https://github.com/TanStack/db/blob/main/packages/db/src/errors.ts#L408)
28+
Defined in: [packages/db/src/errors.ts:417](https://github.com/TanStack/db/blob/main/packages/db/src/errors.ts#L417)
2929
3030
#### Parameters
3131

docs/reference/classes/DistinctRequiresSelectError.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ title: DistinctRequiresSelectError
55

66
# Class: DistinctRequiresSelectError
77

8-
Defined in: [packages/db/src/errors.ts:383](https://github.com/TanStack/db/blob/main/packages/db/src/errors.ts#L383)
8+
Defined in: [packages/db/src/errors.ts:392](https://github.com/TanStack/db/blob/main/packages/db/src/errors.ts#L392)
99

1010
## Extends
1111

@@ -19,7 +19,7 @@ Defined in: [packages/db/src/errors.ts:383](https://github.com/TanStack/db/blob/
1919
new DistinctRequiresSelectError(): DistinctRequiresSelectError;
2020
```
2121

22-
Defined in: [packages/db/src/errors.ts:384](https://github.com/TanStack/db/blob/main/packages/db/src/errors.ts#L384)
22+
Defined in: [packages/db/src/errors.ts:393](https://github.com/TanStack/db/blob/main/packages/db/src/errors.ts#L393)
2323

2424
#### Returns
2525

docs/reference/classes/DuplicateAliasInSubqueryError.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ title: DuplicateAliasInSubqueryError
55

66
# Class: DuplicateAliasInSubqueryError
77

8-
Defined in: [packages/db/src/errors.ts:428](https://github.com/TanStack/db/blob/main/packages/db/src/errors.ts#L428)
8+
Defined in: [packages/db/src/errors.ts:437](https://github.com/TanStack/db/blob/main/packages/db/src/errors.ts#L437)
99

1010
Error thrown when a subquery uses the same alias as its parent query.
1111
This causes issues because parent and subquery would share the same input streams,
@@ -23,7 +23,7 @@ leading to empty results or incorrect data (aggregation cross-leaking).
2323
new DuplicateAliasInSubqueryError(alias, parentAliases): DuplicateAliasInSubqueryError;
2424
```
2525

26-
Defined in: [packages/db/src/errors.ts:429](https://github.com/TanStack/db/blob/main/packages/db/src/errors.ts#L429)
26+
Defined in: [packages/db/src/errors.ts:438](https://github.com/TanStack/db/blob/main/packages/db/src/errors.ts#L438)
2727

2828
#### Parameters
2929

docs/reference/classes/EmptyReferencePathError.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ title: EmptyReferencePathError
55

66
# Class: EmptyReferencePathError
77

8-
Defined in: [packages/db/src/errors.ts:451](https://github.com/TanStack/db/blob/main/packages/db/src/errors.ts#L451)
8+
Defined in: [packages/db/src/errors.ts:460](https://github.com/TanStack/db/blob/main/packages/db/src/errors.ts#L460)
99

1010
## Extends
1111

@@ -19,7 +19,7 @@ Defined in: [packages/db/src/errors.ts:451](https://github.com/TanStack/db/blob/
1919
new EmptyReferencePathError(): EmptyReferencePathError;
2020
```
2121

22-
Defined in: [packages/db/src/errors.ts:452](https://github.com/TanStack/db/blob/main/packages/db/src/errors.ts#L452)
22+
Defined in: [packages/db/src/errors.ts:461](https://github.com/TanStack/db/blob/main/packages/db/src/errors.ts#L461)
2323

2424
#### Returns
2525

docs/reference/classes/GroupByError.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ title: GroupByError
55

66
# Class: GroupByError
77

8-
Defined in: [packages/db/src/errors.ts:526](https://github.com/TanStack/db/blob/main/packages/db/src/errors.ts#L526)
8+
Defined in: [packages/db/src/errors.ts:535](https://github.com/TanStack/db/blob/main/packages/db/src/errors.ts#L535)
99

1010
## Extends
1111

@@ -26,7 +26,7 @@ Defined in: [packages/db/src/errors.ts:526](https://github.com/TanStack/db/blob/
2626
new GroupByError(message): GroupByError;
2727
```
2828

29-
Defined in: [packages/db/src/errors.ts:527](https://github.com/TanStack/db/blob/main/packages/db/src/errors.ts#L527)
29+
Defined in: [packages/db/src/errors.ts:536](https://github.com/TanStack/db/blob/main/packages/db/src/errors.ts#L536)
3030

3131
#### Parameters
3232

docs/reference/classes/HavingRequiresGroupByError.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ title: HavingRequiresGroupByError
55

66
# Class: HavingRequiresGroupByError
77

8-
Defined in: [packages/db/src/errors.ts:389](https://github.com/TanStack/db/blob/main/packages/db/src/errors.ts#L389)
8+
Defined in: [packages/db/src/errors.ts:398](https://github.com/TanStack/db/blob/main/packages/db/src/errors.ts#L398)
99

1010
## Extends
1111

@@ -19,7 +19,7 @@ Defined in: [packages/db/src/errors.ts:389](https://github.com/TanStack/db/blob/
1919
new HavingRequiresGroupByError(): HavingRequiresGroupByError;
2020
```
2121

22-
Defined in: [packages/db/src/errors.ts:390](https://github.com/TanStack/db/blob/main/packages/db/src/errors.ts#L390)
22+
Defined in: [packages/db/src/errors.ts:399](https://github.com/TanStack/db/blob/main/packages/db/src/errors.ts#L399)
2323

2424
#### Returns
2525

0 commit comments

Comments
 (0)