@tanstack/db 0.0.27 → 0.0.29

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (164) hide show
  1. package/dist/cjs/change-events.cjs +141 -0
  2. package/dist/cjs/change-events.cjs.map +1 -0
  3. package/dist/cjs/change-events.d.cts +49 -0
  4. package/dist/cjs/collection.cjs +234 -86
  5. package/dist/cjs/collection.cjs.map +1 -1
  6. package/dist/cjs/collection.d.cts +95 -20
  7. package/dist/cjs/errors.cjs +509 -1
  8. package/dist/cjs/errors.cjs.map +1 -1
  9. package/dist/cjs/errors.d.cts +225 -1
  10. package/dist/cjs/index.cjs +82 -3
  11. package/dist/cjs/index.cjs.map +1 -1
  12. package/dist/cjs/index.d.cts +5 -1
  13. package/dist/cjs/indexes/auto-index.cjs +64 -0
  14. package/dist/cjs/indexes/auto-index.cjs.map +1 -0
  15. package/dist/cjs/indexes/auto-index.d.cts +9 -0
  16. package/dist/cjs/indexes/base-index.cjs +46 -0
  17. package/dist/cjs/indexes/base-index.cjs.map +1 -0
  18. package/dist/cjs/indexes/base-index.d.cts +54 -0
  19. package/dist/cjs/indexes/index-options.d.cts +13 -0
  20. package/dist/cjs/indexes/lazy-index.cjs +193 -0
  21. package/dist/cjs/indexes/lazy-index.cjs.map +1 -0
  22. package/dist/cjs/indexes/lazy-index.d.cts +96 -0
  23. package/dist/cjs/indexes/ordered-index.cjs +227 -0
  24. package/dist/cjs/indexes/ordered-index.cjs.map +1 -0
  25. package/dist/cjs/indexes/ordered-index.d.cts +72 -0
  26. package/dist/cjs/local-storage.cjs +9 -15
  27. package/dist/cjs/local-storage.cjs.map +1 -1
  28. package/dist/cjs/query/builder/functions.cjs +11 -0
  29. package/dist/cjs/query/builder/functions.cjs.map +1 -1
  30. package/dist/cjs/query/builder/functions.d.cts +4 -0
  31. package/dist/cjs/query/builder/index.cjs +6 -7
  32. package/dist/cjs/query/builder/index.cjs.map +1 -1
  33. package/dist/cjs/query/builder/ref-proxy.cjs +37 -0
  34. package/dist/cjs/query/builder/ref-proxy.cjs.map +1 -1
  35. package/dist/cjs/query/builder/ref-proxy.d.cts +12 -0
  36. package/dist/cjs/query/compiler/evaluators.cjs +83 -58
  37. package/dist/cjs/query/compiler/evaluators.cjs.map +1 -1
  38. package/dist/cjs/query/compiler/evaluators.d.cts +8 -0
  39. package/dist/cjs/query/compiler/expressions.cjs +61 -0
  40. package/dist/cjs/query/compiler/expressions.cjs.map +1 -0
  41. package/dist/cjs/query/compiler/expressions.d.cts +25 -0
  42. package/dist/cjs/query/compiler/group-by.cjs +5 -10
  43. package/dist/cjs/query/compiler/group-by.cjs.map +1 -1
  44. package/dist/cjs/query/compiler/index.cjs +23 -17
  45. package/dist/cjs/query/compiler/index.cjs.map +1 -1
  46. package/dist/cjs/query/compiler/index.d.cts +12 -3
  47. package/dist/cjs/query/compiler/joins.cjs +61 -12
  48. package/dist/cjs/query/compiler/joins.cjs.map +1 -1
  49. package/dist/cjs/query/compiler/order-by.cjs +4 -34
  50. package/dist/cjs/query/compiler/order-by.cjs.map +1 -1
  51. package/dist/cjs/query/compiler/types.d.cts +2 -2
  52. package/dist/cjs/query/live-query-collection.cjs +54 -12
  53. package/dist/cjs/query/live-query-collection.cjs.map +1 -1
  54. package/dist/cjs/query/optimizer.cjs +45 -7
  55. package/dist/cjs/query/optimizer.cjs.map +1 -1
  56. package/dist/cjs/query/optimizer.d.cts +13 -3
  57. package/dist/cjs/transactions.cjs +5 -4
  58. package/dist/cjs/transactions.cjs.map +1 -1
  59. package/dist/cjs/types.d.cts +31 -0
  60. package/dist/cjs/utils/array-utils.cjs +18 -0
  61. package/dist/cjs/utils/array-utils.cjs.map +1 -0
  62. package/dist/cjs/utils/array-utils.d.cts +8 -0
  63. package/dist/cjs/utils/comparison.cjs +52 -0
  64. package/dist/cjs/utils/comparison.cjs.map +1 -0
  65. package/dist/cjs/utils/comparison.d.cts +11 -0
  66. package/dist/cjs/utils/index-optimization.cjs +270 -0
  67. package/dist/cjs/utils/index-optimization.cjs.map +1 -0
  68. package/dist/cjs/utils/index-optimization.d.cts +29 -0
  69. package/dist/esm/change-events.d.ts +49 -0
  70. package/dist/esm/change-events.js +141 -0
  71. package/dist/esm/change-events.js.map +1 -0
  72. package/dist/esm/collection.d.ts +95 -20
  73. package/dist/esm/collection.js +232 -84
  74. package/dist/esm/collection.js.map +1 -1
  75. package/dist/esm/errors.d.ts +225 -1
  76. package/dist/esm/errors.js +510 -2
  77. package/dist/esm/errors.js.map +1 -1
  78. package/dist/esm/index.d.ts +5 -1
  79. package/dist/esm/index.js +81 -2
  80. package/dist/esm/index.js.map +1 -1
  81. package/dist/esm/indexes/auto-index.d.ts +9 -0
  82. package/dist/esm/indexes/auto-index.js +64 -0
  83. package/dist/esm/indexes/auto-index.js.map +1 -0
  84. package/dist/esm/indexes/base-index.d.ts +54 -0
  85. package/dist/esm/indexes/base-index.js +46 -0
  86. package/dist/esm/indexes/base-index.js.map +1 -0
  87. package/dist/esm/indexes/index-options.d.ts +13 -0
  88. package/dist/esm/indexes/lazy-index.d.ts +96 -0
  89. package/dist/esm/indexes/lazy-index.js +193 -0
  90. package/dist/esm/indexes/lazy-index.js.map +1 -0
  91. package/dist/esm/indexes/ordered-index.d.ts +72 -0
  92. package/dist/esm/indexes/ordered-index.js +227 -0
  93. package/dist/esm/indexes/ordered-index.js.map +1 -0
  94. package/dist/esm/local-storage.js +9 -15
  95. package/dist/esm/local-storage.js.map +1 -1
  96. package/dist/esm/query/builder/functions.d.ts +4 -0
  97. package/dist/esm/query/builder/functions.js +11 -0
  98. package/dist/esm/query/builder/functions.js.map +1 -1
  99. package/dist/esm/query/builder/index.js +6 -7
  100. package/dist/esm/query/builder/index.js.map +1 -1
  101. package/dist/esm/query/builder/ref-proxy.d.ts +12 -0
  102. package/dist/esm/query/builder/ref-proxy.js +37 -0
  103. package/dist/esm/query/builder/ref-proxy.js.map +1 -1
  104. package/dist/esm/query/compiler/evaluators.d.ts +8 -0
  105. package/dist/esm/query/compiler/evaluators.js +84 -59
  106. package/dist/esm/query/compiler/evaluators.js.map +1 -1
  107. package/dist/esm/query/compiler/expressions.d.ts +25 -0
  108. package/dist/esm/query/compiler/expressions.js +61 -0
  109. package/dist/esm/query/compiler/expressions.js.map +1 -0
  110. package/dist/esm/query/compiler/group-by.js +5 -10
  111. package/dist/esm/query/compiler/group-by.js.map +1 -1
  112. package/dist/esm/query/compiler/index.d.ts +12 -3
  113. package/dist/esm/query/compiler/index.js +23 -17
  114. package/dist/esm/query/compiler/index.js.map +1 -1
  115. package/dist/esm/query/compiler/joins.js +61 -12
  116. package/dist/esm/query/compiler/joins.js.map +1 -1
  117. package/dist/esm/query/compiler/order-by.js +1 -31
  118. package/dist/esm/query/compiler/order-by.js.map +1 -1
  119. package/dist/esm/query/compiler/types.d.ts +2 -2
  120. package/dist/esm/query/live-query-collection.js +54 -12
  121. package/dist/esm/query/live-query-collection.js.map +1 -1
  122. package/dist/esm/query/optimizer.d.ts +13 -3
  123. package/dist/esm/query/optimizer.js +40 -2
  124. package/dist/esm/query/optimizer.js.map +1 -1
  125. package/dist/esm/transactions.js +5 -4
  126. package/dist/esm/transactions.js.map +1 -1
  127. package/dist/esm/types.d.ts +31 -0
  128. package/dist/esm/utils/array-utils.d.ts +8 -0
  129. package/dist/esm/utils/array-utils.js +18 -0
  130. package/dist/esm/utils/array-utils.js.map +1 -0
  131. package/dist/esm/utils/comparison.d.ts +11 -0
  132. package/dist/esm/utils/comparison.js +52 -0
  133. package/dist/esm/utils/comparison.js.map +1 -0
  134. package/dist/esm/utils/index-optimization.d.ts +29 -0
  135. package/dist/esm/utils/index-optimization.js +270 -0
  136. package/dist/esm/utils/index-optimization.js.map +1 -0
  137. package/package.json +1 -1
  138. package/src/change-events.ts +257 -0
  139. package/src/collection.ts +318 -105
  140. package/src/errors.ts +545 -1
  141. package/src/index.ts +7 -1
  142. package/src/indexes/auto-index.ts +108 -0
  143. package/src/indexes/base-index.ts +119 -0
  144. package/src/indexes/index-options.ts +42 -0
  145. package/src/indexes/lazy-index.ts +251 -0
  146. package/src/indexes/ordered-index.ts +305 -0
  147. package/src/local-storage.ts +16 -17
  148. package/src/query/builder/functions.ts +14 -0
  149. package/src/query/builder/index.ts +12 -7
  150. package/src/query/builder/ref-proxy.ts +65 -0
  151. package/src/query/compiler/evaluators.ts +114 -62
  152. package/src/query/compiler/expressions.ts +92 -0
  153. package/src/query/compiler/group-by.ts +10 -10
  154. package/src/query/compiler/index.ts +52 -22
  155. package/src/query/compiler/joins.ts +114 -15
  156. package/src/query/compiler/order-by.ts +1 -45
  157. package/src/query/compiler/types.ts +2 -2
  158. package/src/query/live-query-collection.ts +95 -15
  159. package/src/query/optimizer.ts +94 -5
  160. package/src/transactions.ts +10 -4
  161. package/src/types.ts +38 -0
  162. package/src/utils/array-utils.ts +28 -0
  163. package/src/utils/comparison.ts +79 -0
  164. package/src/utils/index-optimization.ts +546 -0
@@ -1,7 +1,12 @@
1
1
  import { SortedMap } from './SortedMap.cjs';
2
+ import { OrderedIndex } from './indexes/ordered-index.js';
3
+ import { IndexProxy } from './indexes/lazy-index.js';
2
4
  import { Transaction } from './transactions.cjs';
3
5
  import { StandardSchemaV1 } from '@standard-schema/spec';
4
- import { ChangeListener, ChangeMessage, CollectionConfig, CollectionStatus, Fn, InsertConfig, OperationConfig, OptimisticChangeMessage, ResolveInsertInput, ResolveType, Transaction as TransactionType, UtilsRecord } from './types.cjs';
6
+ import { SingleRowRefProxy } from './query/builder/ref-proxy.cjs';
7
+ import { ChangeListener, ChangeMessage, CollectionConfig, CollectionStatus, CurrentStateAsChangesOptions, Fn, InsertConfig, OperationConfig, OptimisticChangeMessage, ResolveInsertInput, ResolveType, SubscribeChangesOptions, Transaction as TransactionType, UtilsRecord } from './types.cjs';
8
+ import { IndexOptions } from './indexes/index-options.js';
9
+ import { BaseIndex, IndexResolver } from './indexes/base-index.js';
5
10
  export declare const collectionsStore: Map<string, CollectionImpl<any, any, any, StandardSchemaV1<unknown, unknown>, any>>;
6
11
  interface PendingSyncedTransaction<T extends object = Record<string, unknown>> {
7
12
  committed: boolean;
@@ -93,20 +98,6 @@ export interface Collection<T extends object = Record<string, unknown>, TKey ext
93
98
  export declare function createCollection<TExplicit = unknown, TKey extends string | number = string | number, TUtils extends UtilsRecord = {}, TSchema extends StandardSchemaV1 = StandardSchemaV1, TFallback extends object = Record<string, unknown>>(options: CollectionConfig<ResolveType<TExplicit, TSchema, TFallback>, TKey, TSchema, ResolveInsertInput<TExplicit, TSchema, TFallback>> & {
94
99
  utils?: TUtils;
95
100
  }): Collection<ResolveType<TExplicit, TSchema, TFallback>, TKey, TUtils, TSchema, ResolveInsertInput<TExplicit, TSchema, TFallback>>;
96
- /**
97
- * Custom error class for schema validation errors
98
- */
99
- export declare class SchemaValidationError extends Error {
100
- type: `insert` | `update`;
101
- issues: ReadonlyArray<{
102
- message: string;
103
- path?: ReadonlyArray<string | number | symbol>;
104
- }>;
105
- constructor(type: `insert` | `update`, issues: ReadonlyArray<{
106
- message: string;
107
- path?: ReadonlyArray<string | number | symbol>;
108
- }>, message?: string);
109
- }
110
101
  export declare class CollectionImpl<T extends object = Record<string, unknown>, TKey extends string | number = string | number, TUtils extends UtilsRecord = {}, TSchema extends StandardSchemaV1 = StandardSchemaV1, TInsertInput extends object = T> {
111
102
  config: CollectionConfig<T, TKey, TSchema, TInsertInput>;
112
103
  transactions: SortedMap<string, Transaction<any>>;
@@ -116,6 +107,10 @@ export declare class CollectionImpl<T extends object = Record<string, unknown>,
116
107
  optimisticUpserts: Map<TKey, T>;
117
108
  optimisticDeletes: Set<TKey>;
118
109
  private _size;
110
+ private lazyIndexes;
111
+ private resolvedIndexes;
112
+ private isIndexesResolved;
113
+ private indexCounter;
119
114
  private changeListeners;
120
115
  private changeKeyListeners;
121
116
  utils: Record<string, Fn>;
@@ -293,6 +288,56 @@ export declare class CollectionImpl<T extends object = Record<string, unknown>,
293
288
  private ensureStandardSchema;
294
289
  getKeyFromItem(item: T): TKey;
295
290
  generateGlobalKey(key: any, item: any): string;
291
+ /**
292
+ * Creates an index on a collection for faster queries.
293
+ * Indexes significantly improve query performance by allowing binary search
294
+ * and range queries instead of full scans.
295
+ *
296
+ * @template TResolver - The type of the index resolver (constructor or async loader)
297
+ * @param indexCallback - Function that extracts the indexed value from each item
298
+ * @param config - Configuration including index type and type-specific options
299
+ * @returns An index proxy that provides access to the index when ready
300
+ *
301
+ * @example
302
+ * // Create a default ordered index
303
+ * const ageIndex = collection.createIndex((row) => row.age)
304
+ *
305
+ * // Create a ordered index with custom options
306
+ * const ageIndex = collection.createIndex((row) => row.age, {
307
+ * indexType: OrderedIndex,
308
+ * options: { compareFn: customComparator },
309
+ * name: 'age_btree'
310
+ * })
311
+ *
312
+ * // Create an async-loaded index
313
+ * const textIndex = collection.createIndex((row) => row.content, {
314
+ * indexType: async () => {
315
+ * const { FullTextIndex } = await import('./indexes/fulltext.js')
316
+ * return FullTextIndex
317
+ * },
318
+ * options: { language: 'en' }
319
+ * })
320
+ */
321
+ createIndex<TResolver extends IndexResolver<TKey> = typeof OrderedIndex>(indexCallback: (row: SingleRowRefProxy<T>) => any, config?: IndexOptions<TResolver>): IndexProxy<TKey>;
322
+ /**
323
+ * Resolve all lazy indexes (called when collection first syncs)
324
+ * @private
325
+ */
326
+ private resolveAllIndexes;
327
+ /**
328
+ * Resolve a single index immediately
329
+ * @private
330
+ */
331
+ private resolveSingleIndex;
332
+ /**
333
+ * Get resolved indexes for query optimization
334
+ */
335
+ get indexes(): Map<number, BaseIndex<TKey>>;
336
+ /**
337
+ * Updates all indexes when the collection changes
338
+ * @private
339
+ */
340
+ private updateIndexes;
296
341
  private deepEqual;
297
342
  private validateData;
298
343
  /**
@@ -445,13 +490,27 @@ export declare class CollectionImpl<T extends object = Record<string, unknown>,
445
490
  toArrayWhenReady(): Promise<Array<T>>;
446
491
  /**
447
492
  * Returns the current state of the collection as an array of changes
493
+ * @param options - Options including optional where filter
448
494
  * @returns An array of changes
495
+ * @example
496
+ * // Get all items as changes
497
+ * const allChanges = collection.currentStateAsChanges()
498
+ *
499
+ * // Get only items matching a condition
500
+ * const activeChanges = collection.currentStateAsChanges({
501
+ * where: (row) => row.status === 'active'
502
+ * })
503
+ *
504
+ * // Get only items using a pre-compiled expression
505
+ * const activeChanges = collection.currentStateAsChanges({
506
+ * whereExpression: eq(row.status, 'active')
507
+ * })
449
508
  */
450
- currentStateAsChanges(): Array<ChangeMessage<T>>;
509
+ currentStateAsChanges(options?: CurrentStateAsChangesOptions<T>): Array<ChangeMessage<T>>;
451
510
  /**
452
511
  * Subscribe to changes in the collection
453
512
  * @param callback - Function called when items change
454
- * @param options.includeInitialState - If true, immediately calls callback with current data
513
+ * @param options - Subscription options including includeInitialState and where filter
455
514
  * @returns Unsubscribe function - Call this to stop listening for changes
456
515
  * @example
457
516
  * // Basic subscription
@@ -468,10 +527,26 @@ export declare class CollectionImpl<T extends object = Record<string, unknown>,
468
527
  * const unsubscribe = collection.subscribeChanges((changes) => {
469
528
  * updateUI(changes)
470
529
  * }, { includeInitialState: true })
530
+ *
531
+ * @example
532
+ * // Subscribe only to changes matching a condition
533
+ * const unsubscribe = collection.subscribeChanges((changes) => {
534
+ * updateUI(changes)
535
+ * }, {
536
+ * includeInitialState: true,
537
+ * where: (row) => row.status === 'active'
538
+ * })
539
+ *
540
+ * @example
541
+ * // Subscribe using a pre-compiled expression
542
+ * const unsubscribe = collection.subscribeChanges((changes) => {
543
+ * updateUI(changes)
544
+ * }, {
545
+ * includeInitialState: true,
546
+ * whereExpression: eq(row.status, 'active')
547
+ * })
471
548
  */
472
- subscribeChanges(callback: (changes: Array<ChangeMessage<T>>) => void, { includeInitialState }?: {
473
- includeInitialState?: boolean;
474
- }): () => void;
549
+ subscribeChanges(callback: (changes: Array<ChangeMessage<T>>) => void, options?: SubscribeChangesOptions<T>): () => void;
475
550
  /**
476
551
  * Subscribe to changes for a specific key
477
552
  */
@@ -1,10 +1,518 @@
1
1
  "use strict";
2
2
  Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
3
- class NonRetriableError extends Error {
3
+ class TanStackDBError extends Error {
4
+ constructor(message) {
5
+ super(message);
6
+ this.name = `TanStackDBError`;
7
+ }
8
+ }
9
+ class NonRetriableError extends TanStackDBError {
4
10
  constructor(message) {
5
11
  super(message);
6
12
  this.name = `NonRetriableError`;
7
13
  }
8
14
  }
15
+ class SchemaValidationError extends TanStackDBError {
16
+ constructor(type, issues, message) {
17
+ const defaultMessage = `${type === `insert` ? `Insert` : `Update`} validation failed: ${issues.map((issue) => `
18
+ - ${issue.message} - path: ${issue.path}`).join(``)}`;
19
+ super(message || defaultMessage);
20
+ this.name = `SchemaValidationError`;
21
+ this.type = type;
22
+ this.issues = issues;
23
+ }
24
+ }
25
+ class CollectionConfigurationError extends TanStackDBError {
26
+ constructor(message) {
27
+ super(message);
28
+ this.name = `CollectionConfigurationError`;
29
+ }
30
+ }
31
+ class CollectionRequiresConfigError extends CollectionConfigurationError {
32
+ constructor() {
33
+ super(`Collection requires a config`);
34
+ }
35
+ }
36
+ class CollectionRequiresSyncConfigError extends CollectionConfigurationError {
37
+ constructor() {
38
+ super(`Collection requires a sync config`);
39
+ }
40
+ }
41
+ class InvalidSchemaError extends CollectionConfigurationError {
42
+ constructor() {
43
+ super(`Schema must implement the standard-schema interface`);
44
+ }
45
+ }
46
+ class SchemaMustBeSynchronousError extends CollectionConfigurationError {
47
+ constructor() {
48
+ super(`Schema validation must be synchronous`);
49
+ }
50
+ }
51
+ class CollectionStateError extends TanStackDBError {
52
+ constructor(message) {
53
+ super(message);
54
+ this.name = `CollectionStateError`;
55
+ }
56
+ }
57
+ class CollectionInErrorStateError extends CollectionStateError {
58
+ constructor(operation, collectionId) {
59
+ super(
60
+ `Cannot perform ${operation} on collection "${collectionId}" - collection is in error state. Try calling cleanup() and restarting the collection.`
61
+ );
62
+ }
63
+ }
64
+ class InvalidCollectionStatusTransitionError extends CollectionStateError {
65
+ constructor(from, to, collectionId) {
66
+ super(
67
+ `Invalid collection status transition from "${from}" to "${to}" for collection "${collectionId}"`
68
+ );
69
+ }
70
+ }
71
+ class CollectionIsInErrorStateError extends CollectionStateError {
72
+ constructor() {
73
+ super(`Collection is in error state`);
74
+ }
75
+ }
76
+ class NegativeActiveSubscribersError extends CollectionStateError {
77
+ constructor() {
78
+ super(`Active subscribers count is negative - this should never happen`);
79
+ }
80
+ }
81
+ class CollectionOperationError extends TanStackDBError {
82
+ constructor(message) {
83
+ super(message);
84
+ this.name = `CollectionOperationError`;
85
+ }
86
+ }
87
+ class UndefinedKeyError extends CollectionOperationError {
88
+ constructor(item) {
89
+ super(
90
+ `An object was created without a defined key: ${JSON.stringify(item)}`
91
+ );
92
+ }
93
+ }
94
+ class DuplicateKeyError extends CollectionOperationError {
95
+ constructor(key) {
96
+ super(
97
+ `Cannot insert document with ID "${key}" because it already exists in the collection`
98
+ );
99
+ }
100
+ }
101
+ class DuplicateKeySyncError extends CollectionOperationError {
102
+ constructor(key, collectionId) {
103
+ super(
104
+ `Cannot insert document with key "${key}" from sync because it already exists in the collection "${collectionId}"`
105
+ );
106
+ }
107
+ }
108
+ class MissingUpdateArgumentError extends CollectionOperationError {
109
+ constructor() {
110
+ super(`The first argument to update is missing`);
111
+ }
112
+ }
113
+ class NoKeysPassedToUpdateError extends CollectionOperationError {
114
+ constructor() {
115
+ super(`No keys were passed to update`);
116
+ }
117
+ }
118
+ class UpdateKeyNotFoundError extends CollectionOperationError {
119
+ constructor(key) {
120
+ super(
121
+ `The key "${key}" was passed to update but an object for this key was not found in the collection`
122
+ );
123
+ }
124
+ }
125
+ class KeyUpdateNotAllowedError extends CollectionOperationError {
126
+ constructor(originalKey, newKey) {
127
+ super(
128
+ `Updating the key of an item is not allowed. Original key: "${originalKey}", Attempted new key: "${newKey}". Please delete the old item and create a new one if a key change is necessary.`
129
+ );
130
+ }
131
+ }
132
+ class NoKeysPassedToDeleteError extends CollectionOperationError {
133
+ constructor() {
134
+ super(`No keys were passed to delete`);
135
+ }
136
+ }
137
+ class DeleteKeyNotFoundError extends CollectionOperationError {
138
+ constructor(key) {
139
+ super(
140
+ `Collection.delete was called with key '${key}' but there is no item in the collection with this key`
141
+ );
142
+ }
143
+ }
144
+ class MissingHandlerError extends TanStackDBError {
145
+ constructor(message) {
146
+ super(message);
147
+ this.name = `MissingHandlerError`;
148
+ }
149
+ }
150
+ class MissingInsertHandlerError extends MissingHandlerError {
151
+ constructor() {
152
+ super(
153
+ `Collection.insert called directly (not within an explicit transaction) but no 'onInsert' handler is configured.`
154
+ );
155
+ }
156
+ }
157
+ class MissingUpdateHandlerError extends MissingHandlerError {
158
+ constructor() {
159
+ super(
160
+ `Collection.update called directly (not within an explicit transaction) but no 'onUpdate' handler is configured.`
161
+ );
162
+ }
163
+ }
164
+ class MissingDeleteHandlerError extends MissingHandlerError {
165
+ constructor() {
166
+ super(
167
+ `Collection.delete called directly (not within an explicit transaction) but no 'onDelete' handler is configured.`
168
+ );
169
+ }
170
+ }
171
+ class TransactionError extends TanStackDBError {
172
+ constructor(message) {
173
+ super(message);
174
+ this.name = `TransactionError`;
175
+ }
176
+ }
177
+ class MissingMutationFunctionError extends TransactionError {
178
+ constructor() {
179
+ super(`mutationFn is required when creating a transaction`);
180
+ }
181
+ }
182
+ class TransactionNotPendingMutateError extends TransactionError {
183
+ constructor() {
184
+ super(
185
+ `You can no longer call .mutate() as the transaction is no longer pending`
186
+ );
187
+ }
188
+ }
189
+ class TransactionAlreadyCompletedRollbackError extends TransactionError {
190
+ constructor() {
191
+ super(
192
+ `You can no longer call .rollback() as the transaction is already completed`
193
+ );
194
+ }
195
+ }
196
+ class TransactionNotPendingCommitError extends TransactionError {
197
+ constructor() {
198
+ super(
199
+ `You can no longer call .commit() as the transaction is no longer pending`
200
+ );
201
+ }
202
+ }
203
+ class NoPendingSyncTransactionWriteError extends TransactionError {
204
+ constructor() {
205
+ super(`No pending sync transaction to write to`);
206
+ }
207
+ }
208
+ class SyncTransactionAlreadyCommittedWriteError extends TransactionError {
209
+ constructor() {
210
+ super(
211
+ `The pending sync transaction is already committed, you can't still write to it.`
212
+ );
213
+ }
214
+ }
215
+ class NoPendingSyncTransactionCommitError extends TransactionError {
216
+ constructor() {
217
+ super(`No pending sync transaction to commit`);
218
+ }
219
+ }
220
+ class SyncTransactionAlreadyCommittedError extends TransactionError {
221
+ constructor() {
222
+ super(
223
+ `The pending sync transaction is already committed, you can't commit it again.`
224
+ );
225
+ }
226
+ }
227
+ class QueryBuilderError extends TanStackDBError {
228
+ constructor(message) {
229
+ super(message);
230
+ this.name = `QueryBuilderError`;
231
+ }
232
+ }
233
+ class OnlyOneSourceAllowedError extends QueryBuilderError {
234
+ constructor(context) {
235
+ super(`Only one source is allowed in the ${context}`);
236
+ }
237
+ }
238
+ class SubQueryMustHaveFromClauseError extends QueryBuilderError {
239
+ constructor(context) {
240
+ super(`A sub query passed to a ${context} must have a from clause itself`);
241
+ }
242
+ }
243
+ class InvalidSourceError extends QueryBuilderError {
244
+ constructor() {
245
+ super(`Invalid source`);
246
+ }
247
+ }
248
+ class JoinConditionMustBeEqualityError extends QueryBuilderError {
249
+ constructor() {
250
+ super(`Join condition must be an equality expression`);
251
+ }
252
+ }
253
+ class QueryMustHaveFromClauseError extends QueryBuilderError {
254
+ constructor() {
255
+ super(`Query must have a from clause`);
256
+ }
257
+ }
258
+ class QueryCompilationError extends TanStackDBError {
259
+ constructor(message) {
260
+ super(message);
261
+ this.name = `QueryCompilationError`;
262
+ }
263
+ }
264
+ class DistinctRequiresSelectError extends QueryCompilationError {
265
+ constructor() {
266
+ super(`DISTINCT requires a SELECT clause.`);
267
+ }
268
+ }
269
+ class HavingRequiresGroupByError extends QueryCompilationError {
270
+ constructor() {
271
+ super(`HAVING clause requires GROUP BY clause`);
272
+ }
273
+ }
274
+ class LimitOffsetRequireOrderByError extends QueryCompilationError {
275
+ constructor() {
276
+ super(
277
+ `LIMIT and OFFSET require an ORDER BY clause to ensure deterministic results`
278
+ );
279
+ }
280
+ }
281
+ class CollectionInputNotFoundError extends QueryCompilationError {
282
+ constructor(collectionId) {
283
+ super(`Input for collection "${collectionId}" not found in inputs map`);
284
+ }
285
+ }
286
+ class UnsupportedFromTypeError extends QueryCompilationError {
287
+ constructor(type) {
288
+ super(`Unsupported FROM type: ${type}`);
289
+ }
290
+ }
291
+ class UnknownExpressionTypeError extends QueryCompilationError {
292
+ constructor(type) {
293
+ super(`Unknown expression type: ${type}`);
294
+ }
295
+ }
296
+ class EmptyReferencePathError extends QueryCompilationError {
297
+ constructor() {
298
+ super(`Reference path cannot be empty`);
299
+ }
300
+ }
301
+ class UnknownFunctionError extends QueryCompilationError {
302
+ constructor(functionName) {
303
+ super(`Unknown function: ${functionName}`);
304
+ }
305
+ }
306
+ class JoinError extends TanStackDBError {
307
+ constructor(message) {
308
+ super(message);
309
+ this.name = `JoinError`;
310
+ }
311
+ }
312
+ class UnsupportedJoinTypeError extends JoinError {
313
+ constructor(joinType) {
314
+ super(`Unsupported join type: ${joinType}`);
315
+ }
316
+ }
317
+ class InvalidJoinConditionSameTableError extends JoinError {
318
+ constructor(tableAlias) {
319
+ super(
320
+ `Invalid join condition: both expressions refer to the same table "${tableAlias}"`
321
+ );
322
+ }
323
+ }
324
+ class InvalidJoinConditionTableMismatchError extends JoinError {
325
+ constructor(mainTableAlias, joinedTableAlias) {
326
+ super(
327
+ `Invalid join condition: expressions must reference table aliases "${mainTableAlias}" and "${joinedTableAlias}"`
328
+ );
329
+ }
330
+ }
331
+ class InvalidJoinConditionWrongTablesError extends JoinError {
332
+ constructor(leftTableAlias, rightTableAlias, mainTableAlias, joinedTableAlias) {
333
+ super(
334
+ `Invalid join condition: expressions reference tables "${leftTableAlias}" and "${rightTableAlias}" but join is between "${mainTableAlias}" and "${joinedTableAlias}"`
335
+ );
336
+ }
337
+ }
338
+ class UnsupportedJoinSourceTypeError extends JoinError {
339
+ constructor(type) {
340
+ super(`Unsupported join source type: ${type}`);
341
+ }
342
+ }
343
+ class GroupByError extends TanStackDBError {
344
+ constructor(message) {
345
+ super(message);
346
+ this.name = `GroupByError`;
347
+ }
348
+ }
349
+ class NonAggregateExpressionNotInGroupByError extends GroupByError {
350
+ constructor(alias) {
351
+ super(
352
+ `Non-aggregate expression '${alias}' in SELECT must also appear in GROUP BY clause`
353
+ );
354
+ }
355
+ }
356
+ class UnsupportedAggregateFunctionError extends GroupByError {
357
+ constructor(functionName) {
358
+ super(`Unsupported aggregate function: ${functionName}`);
359
+ }
360
+ }
361
+ class AggregateFunctionNotInSelectError extends GroupByError {
362
+ constructor(functionName) {
363
+ super(
364
+ `Aggregate function in HAVING clause must also be in SELECT clause: ${functionName}`
365
+ );
366
+ }
367
+ }
368
+ class UnknownHavingExpressionTypeError extends GroupByError {
369
+ constructor(type) {
370
+ super(`Unknown expression type in HAVING clause: ${type}`);
371
+ }
372
+ }
373
+ class StorageError extends TanStackDBError {
374
+ constructor(message) {
375
+ super(message);
376
+ this.name = `StorageError`;
377
+ }
378
+ }
379
+ class SerializationError extends StorageError {
380
+ constructor(operation, originalError) {
381
+ super(
382
+ `Cannot ${operation} item because it cannot be JSON serialized: ${originalError}`
383
+ );
384
+ }
385
+ }
386
+ class LocalStorageCollectionError extends StorageError {
387
+ constructor(message) {
388
+ super(message);
389
+ this.name = `LocalStorageCollectionError`;
390
+ }
391
+ }
392
+ class StorageKeyRequiredError extends LocalStorageCollectionError {
393
+ constructor() {
394
+ super(`[LocalStorageCollection] storageKey must be provided.`);
395
+ }
396
+ }
397
+ class NoStorageAvailableError extends LocalStorageCollectionError {
398
+ constructor() {
399
+ super(
400
+ `[LocalStorageCollection] No storage available. Please provide a storage option or ensure window.localStorage is available.`
401
+ );
402
+ }
403
+ }
404
+ class NoStorageEventApiError extends LocalStorageCollectionError {
405
+ constructor() {
406
+ super(
407
+ `[LocalStorageCollection] No storage event API available. Please provide a storageEventApi option or ensure window is available.`
408
+ );
409
+ }
410
+ }
411
+ class InvalidStorageDataFormatError extends LocalStorageCollectionError {
412
+ constructor(storageKey, key) {
413
+ super(
414
+ `[LocalStorageCollection] Invalid data format in storage key "${storageKey}" for key "${key}".`
415
+ );
416
+ }
417
+ }
418
+ class InvalidStorageObjectFormatError extends LocalStorageCollectionError {
419
+ constructor(storageKey) {
420
+ super(
421
+ `[LocalStorageCollection] Invalid data format in storage key "${storageKey}". Expected object format.`
422
+ );
423
+ }
424
+ }
425
+ class SyncCleanupError extends TanStackDBError {
426
+ constructor(collectionId, error) {
427
+ const message = error instanceof Error ? error.message : String(error);
428
+ super(
429
+ `Collection "${collectionId}" sync cleanup function threw an error: ${message}`
430
+ );
431
+ this.name = `SyncCleanupError`;
432
+ }
433
+ }
434
+ class QueryOptimizerError extends TanStackDBError {
435
+ constructor(message) {
436
+ super(message);
437
+ this.name = `QueryOptimizerError`;
438
+ }
439
+ }
440
+ class CannotCombineEmptyExpressionListError extends QueryOptimizerError {
441
+ constructor() {
442
+ super(`Cannot combine empty expression list`);
443
+ }
444
+ }
445
+ exports.AggregateFunctionNotInSelectError = AggregateFunctionNotInSelectError;
446
+ exports.CannotCombineEmptyExpressionListError = CannotCombineEmptyExpressionListError;
447
+ exports.CollectionConfigurationError = CollectionConfigurationError;
448
+ exports.CollectionInErrorStateError = CollectionInErrorStateError;
449
+ exports.CollectionInputNotFoundError = CollectionInputNotFoundError;
450
+ exports.CollectionIsInErrorStateError = CollectionIsInErrorStateError;
451
+ exports.CollectionOperationError = CollectionOperationError;
452
+ exports.CollectionRequiresConfigError = CollectionRequiresConfigError;
453
+ exports.CollectionRequiresSyncConfigError = CollectionRequiresSyncConfigError;
454
+ exports.CollectionStateError = CollectionStateError;
455
+ exports.DeleteKeyNotFoundError = DeleteKeyNotFoundError;
456
+ exports.DistinctRequiresSelectError = DistinctRequiresSelectError;
457
+ exports.DuplicateKeyError = DuplicateKeyError;
458
+ exports.DuplicateKeySyncError = DuplicateKeySyncError;
459
+ exports.EmptyReferencePathError = EmptyReferencePathError;
460
+ exports.GroupByError = GroupByError;
461
+ exports.HavingRequiresGroupByError = HavingRequiresGroupByError;
462
+ exports.InvalidCollectionStatusTransitionError = InvalidCollectionStatusTransitionError;
463
+ exports.InvalidJoinConditionSameTableError = InvalidJoinConditionSameTableError;
464
+ exports.InvalidJoinConditionTableMismatchError = InvalidJoinConditionTableMismatchError;
465
+ exports.InvalidJoinConditionWrongTablesError = InvalidJoinConditionWrongTablesError;
466
+ exports.InvalidSchemaError = InvalidSchemaError;
467
+ exports.InvalidSourceError = InvalidSourceError;
468
+ exports.InvalidStorageDataFormatError = InvalidStorageDataFormatError;
469
+ exports.InvalidStorageObjectFormatError = InvalidStorageObjectFormatError;
470
+ exports.JoinConditionMustBeEqualityError = JoinConditionMustBeEqualityError;
471
+ exports.JoinError = JoinError;
472
+ exports.KeyUpdateNotAllowedError = KeyUpdateNotAllowedError;
473
+ exports.LimitOffsetRequireOrderByError = LimitOffsetRequireOrderByError;
474
+ exports.LocalStorageCollectionError = LocalStorageCollectionError;
475
+ exports.MissingDeleteHandlerError = MissingDeleteHandlerError;
476
+ exports.MissingHandlerError = MissingHandlerError;
477
+ exports.MissingInsertHandlerError = MissingInsertHandlerError;
478
+ exports.MissingMutationFunctionError = MissingMutationFunctionError;
479
+ exports.MissingUpdateArgumentError = MissingUpdateArgumentError;
480
+ exports.MissingUpdateHandlerError = MissingUpdateHandlerError;
481
+ exports.NegativeActiveSubscribersError = NegativeActiveSubscribersError;
482
+ exports.NoKeysPassedToDeleteError = NoKeysPassedToDeleteError;
483
+ exports.NoKeysPassedToUpdateError = NoKeysPassedToUpdateError;
484
+ exports.NoPendingSyncTransactionCommitError = NoPendingSyncTransactionCommitError;
485
+ exports.NoPendingSyncTransactionWriteError = NoPendingSyncTransactionWriteError;
486
+ exports.NoStorageAvailableError = NoStorageAvailableError;
487
+ exports.NoStorageEventApiError = NoStorageEventApiError;
488
+ exports.NonAggregateExpressionNotInGroupByError = NonAggregateExpressionNotInGroupByError;
9
489
  exports.NonRetriableError = NonRetriableError;
490
+ exports.OnlyOneSourceAllowedError = OnlyOneSourceAllowedError;
491
+ exports.QueryBuilderError = QueryBuilderError;
492
+ exports.QueryCompilationError = QueryCompilationError;
493
+ exports.QueryMustHaveFromClauseError = QueryMustHaveFromClauseError;
494
+ exports.QueryOptimizerError = QueryOptimizerError;
495
+ exports.SchemaMustBeSynchronousError = SchemaMustBeSynchronousError;
496
+ exports.SchemaValidationError = SchemaValidationError;
497
+ exports.SerializationError = SerializationError;
498
+ exports.StorageError = StorageError;
499
+ exports.StorageKeyRequiredError = StorageKeyRequiredError;
500
+ exports.SubQueryMustHaveFromClauseError = SubQueryMustHaveFromClauseError;
501
+ exports.SyncCleanupError = SyncCleanupError;
502
+ exports.SyncTransactionAlreadyCommittedError = SyncTransactionAlreadyCommittedError;
503
+ exports.SyncTransactionAlreadyCommittedWriteError = SyncTransactionAlreadyCommittedWriteError;
504
+ exports.TanStackDBError = TanStackDBError;
505
+ exports.TransactionAlreadyCompletedRollbackError = TransactionAlreadyCompletedRollbackError;
506
+ exports.TransactionError = TransactionError;
507
+ exports.TransactionNotPendingCommitError = TransactionNotPendingCommitError;
508
+ exports.TransactionNotPendingMutateError = TransactionNotPendingMutateError;
509
+ exports.UndefinedKeyError = UndefinedKeyError;
510
+ exports.UnknownExpressionTypeError = UnknownExpressionTypeError;
511
+ exports.UnknownFunctionError = UnknownFunctionError;
512
+ exports.UnknownHavingExpressionTypeError = UnknownHavingExpressionTypeError;
513
+ exports.UnsupportedAggregateFunctionError = UnsupportedAggregateFunctionError;
514
+ exports.UnsupportedFromTypeError = UnsupportedFromTypeError;
515
+ exports.UnsupportedJoinSourceTypeError = UnsupportedJoinSourceTypeError;
516
+ exports.UnsupportedJoinTypeError = UnsupportedJoinTypeError;
517
+ exports.UpdateKeyNotFoundError = UpdateKeyNotFoundError;
10
518
  //# sourceMappingURL=errors.cjs.map