@tanstack/db 0.5.10 → 0.5.12

package/src/query/ir.ts

@@ -2,9 +2,9 @@
 This is the intermediate representation of the query.
 */
 
-import type { CompareOptions } from "./builder/types"
-import type { Collection, CollectionImpl } from "../collection/index.js"
-import type { NamespacedRow } from "../types"
+import type { CompareOptions } from './builder/types'
+import type { Collection, CollectionImpl } from '../collection/index.js'
+import type { NamespacedRow } from '../types'
 
 export interface QueryIR {
   from: From
@@ -73,7 +73,7 @@ export class CollectionRef extends BaseExpression {
   public type = `collectionRef` as const
   constructor(
     public collection: CollectionImpl,
-    public alias: string
+    public alias: string,
   ) {
     super()
   }
@@ -83,7 +83,7 @@ export class QueryRef extends BaseExpression {
   public type = `queryRef` as const
   constructor(
     public query: QueryIR,
-    public alias: string
+    public alias: string,
   ) {
     super()
   }
@@ -92,7 +92,7 @@ export class QueryRef extends BaseExpression {
 export class PropRef<T = any> extends BaseExpression<T> {
   public type = `ref` as const
   constructor(
-    public path: Array<string> // path to the property in the collection, with the alias as the first element
+    public path: Array<string>, // path to the property in the collection, with the alias as the first element
   ) {
     super()
   }
@@ -101,7 +101,7 @@ export class PropRef<T = any> extends BaseExpression<T> {
 export class Value<T = any> extends BaseExpression<T> {
   public type = `val` as const
   constructor(
-    public value: T // any js value
+    public value: T, // any js value
   ) {
     super()
   }
@@ -111,7 +111,7 @@ export class Func<T = any> extends BaseExpression<T> {
   public type = `func` as const
   constructor(
     public name: string, // such as eq, gt, lt, upper, lower, etc.
-    public args: Array<BasicExpression>
+    public args: Array<BasicExpression>,
   ) {
     super()
   }
@@ -126,7 +126,7 @@ export class Aggregate<T = any> extends BaseExpression<T> {
   public type = `agg` as const
   constructor(
     public name: string, // such as count, avg, sum, min, max, etc.
-    public args: Array<BasicExpression>
+    public args: Array<BasicExpression>,
   ) {
     super()
   }
@@ -163,7 +163,7 @@ export function getWhereExpression(where: Where): BasicExpression<boolean> {
  * HAVING clauses can contain aggregates, unlike regular WHERE clauses
  */
 export function getHavingExpression(
-  having: Having
+  having: Having,
 ): BasicExpression | Aggregate {
   return typeof having === `object` && `expression` in having
     ? having.expression
@@ -185,14 +185,14 @@ export function isResidualWhere(where: Where): boolean {
  * Create a residual Where clause from an expression
  */
 export function createResidualWhere(
-  expression: BasicExpression<boolean>
+  expression: BasicExpression<boolean>,
 ): Where {
   return { expression, residual: true }
 }
 
 function getRefFromAlias(
   query: QueryIR,
-  alias: string
+  alias: string,
 ): CollectionRef | QueryRef | void {
   if (query.from.alias === alias) {
     return query.from
@@ -213,7 +213,7 @@ function getRefFromAlias(
 export function followRef(
   query: QueryIR,
   ref: PropRef<any>,
-  collection: Collection
+  collection: Collection,
 ): { collection: Collection; path: Array<string> } | void {
   if (ref.path.length === 0) {
     return

package/src/query/live/collection-config-builder.ts

@@ -1,22 +1,22 @@
-import { D2, output } from "@tanstack/db-ivm"
-import { compileQuery } from "../compiler/index.js"
-import { buildQuery, getQueryIR } from "../builder/index.js"
+import { D2, output } from '@tanstack/db-ivm'
+import { compileQuery } from '../compiler/index.js'
+import { buildQuery, getQueryIR } from '../builder/index.js'
 import {
   MissingAliasInputsError,
   SetWindowRequiresOrderByError,
-} from "../../errors.js"
-import { transactionScopedScheduler } from "../../scheduler.js"
-import { getActiveTransaction } from "../../transactions.js"
-import { CollectionSubscriber } from "./collection-subscriber.js"
-import { getCollectionBuilder } from "./collection-registry.js"
-import { LIVE_QUERY_INTERNAL } from "./internal.js"
-import type { LiveQueryInternalUtils } from "./internal.js"
-import type { WindowOptions } from "../compiler/index.js"
-import type { SchedulerContextId } from "../../scheduler.js"
-import type { CollectionSubscription } from "../../collection/subscription.js"
-import type { RootStreamBuilder } from "@tanstack/db-ivm"
-import type { OrderByOptimizationInfo } from "../compiler/order-by.js"
-import type { Collection } from "../../collection/index.js"
+} from '../../errors.js'
+import { transactionScopedScheduler } from '../../scheduler.js'
+import { getActiveTransaction } from '../../transactions.js'
+import { CollectionSubscriber } from './collection-subscriber.js'
+import { getCollectionBuilder } from './collection-registry.js'
+import { LIVE_QUERY_INTERNAL } from './internal.js'
+import type { LiveQueryInternalUtils } from './internal.js'
+import type { WindowOptions } from '../compiler/index.js'
+import type { SchedulerContextId } from '../../scheduler.js'
+import type { CollectionSubscription } from '../../collection/subscription.js'
+import type { RootStreamBuilder } from '@tanstack/db-ivm'
+import type { OrderByOptimizationInfo } from '../compiler/order-by.js'
+import type { Collection } from '../../collection/index.js'
 import type {
   CollectionConfigSingleRowOption,
   KeyedStream,
@@ -24,17 +24,17 @@ import type {
   StringCollationConfig,
   SyncConfig,
   UtilsRecord,
-} from "../../types.js"
-import type { Context, GetResult } from "../builder/types.js"
-import type { BasicExpression, QueryIR } from "../ir.js"
-import type { LazyCollectionCallbacks } from "../compiler/joins.js"
+} from '../../types.js'
+import type { Context, GetResult } from '../builder/types.js'
+import type { BasicExpression, QueryIR } from '../ir.js'
+import type { LazyCollectionCallbacks } from '../compiler/joins.js'
 import type {
   Changes,
   FullSyncState,
   LiveQueryCollectionConfig,
   SyncState,
-} from "./types.js"
-import type { AllCollectionEvents } from "../../collection/events.js"
+} from './types.js'
+import type { AllCollectionEvents } from '../../collection/events.js'
 
 export type LiveQueryCollectionUtils = UtilsRecord & {
   getRunCount: () => number
@@ -146,7 +146,7 @@ export class CollectionConfigBuilder<
   optimizableOrderByCollections: Record<string, OrderByOptimizationInfo> = {}
 
   constructor(
-    private readonly config: LiveQueryCollectionConfig<TContext, TResult>
+    private readonly config: LiveQueryCollectionConfig<TContext, TResult>,
   ) {
     // Generate a unique ID if not provided
     this.id = config.id || `live-query-${++liveQueryCollectionCounter}`
@@ -252,7 +252,7 @@ export class CollectionConfigBuilder<
               unsubscribe()
               resolve()
             }
-          }
+          },
         )
       })
     }
@@ -318,7 +318,7 @@ export class CollectionConfigBuilder<
     // Should only be called when sync is active
     if (!this.currentSyncConfig || !this.currentSyncState) {
       throw new Error(
-        `maybeRunGraph called without active sync session. This should not happen.`
+        `maybeRunGraph called without active sync session. This should not happen.`,
       )
     }
 
@@ -380,7 +380,7 @@ export class CollectionConfigBuilder<
       jobId?: unknown
       alias?: string
       dependencies?: Array<CollectionConfigBuilder<any, any>>
-    }
+    },
   ) {
     const contextId = options?.contextId ?? getActiveTransaction()?.id
     // Use the builder instance as the job ID for deduplication. This is memory-safe
@@ -422,7 +422,7 @@ export class CollectionConfigBuilder<
 
     if (!this.currentSyncConfig || !this.currentSyncState) {
       throw new Error(
-        `scheduleGraphRun called without active sync session. This should not happen.`
+        `scheduleGraphRun called without active sync session. This should not happen.`,
       )
     }
 
@@ -479,7 +479,7 @@ export class CollectionConfigBuilder<
    */
   private executeGraphRun(
     contextId?: SchedulerContextId,
-    pendingParam?: PendingGraphRun
+    pendingParam?: PendingGraphRun,
   ): void {
     // Get pending state: either from parameter (no context) or from map (with context)
     // Remove from map BEFORE checking sync state to prevent leaking entries when sync ends
@@ -554,7 +554,7 @@ export class CollectionConfigBuilder<
     // Extend the pipeline such that it applies the incoming changes to the collection
     const fullSyncState = this.extendPipelineWithChangeProcessing(
       config,
-      syncState
+      syncState,
     )
     this.currentSyncState = fullSyncState
 
@@ -563,12 +563,12 @@ export class CollectionConfigBuilder<
     this.unsubscribeFromSchedulerClears = transactionScopedScheduler.onClear(
       (contextId) => {
         this.clearPendingGraphRun(contextId)
-      }
+      },
     )
 
     const loadSubsetDataCallbacks = this.subscribeToAllCollections(
       config,
-      fullSyncState
+      fullSyncState,
     )
 
     this.maybeRunGraphFn = () => this.scheduleGraphRun(loadSubsetDataCallbacks)
@@ -603,7 +603,7 @@ export class CollectionConfigBuilder<
       // Clear subscription references to prevent memory leaks
       // Note: Individual subscriptions are already unsubscribed via unsubscribeCallbacks
       Object.keys(this.subscriptions).forEach(
-        (key) => delete this.subscriptions[key]
+        (key) => delete this.subscriptions[key],
       )
       this.compiledAliasToCollectionId = {}
 
@@ -623,7 +623,7 @@ export class CollectionConfigBuilder<
       Object.keys(this.collectionByAlias).map((alias) => [
         alias,
         this.graphCache!.newInput<any>(),
-      ])
+      ]),
     )
 
     const compilation = compileQuery(
@@ -636,7 +636,7 @@ export class CollectionConfigBuilder<
       this.optimizableOrderByCollections,
       (windowFn: (options: WindowOptions) => void) => {
         this.windowFn = windowFn
-      }
+      },
     )
 
     this.pipelineCache = compilation.pipeline
@@ -647,7 +647,7 @@ export class CollectionConfigBuilder<
     // This should never happen since all aliases come from user declarations,
     // but catch it early if the assumption is violated in the future.
     const missingAliases = Object.keys(this.compiledAliasToCollectionId).filter(
-      (alias) => !Object.hasOwn(this.inputsCache!, alias)
+      (alias) => !Object.hasOwn(this.inputsCache!, alias),
     )
     if (missingAliases.length > 0) {
       throw new MissingAliasInputsError(missingAliases)
@@ -667,7 +667,7 @@ export class CollectionConfigBuilder<
 
   private extendPipelineWithChangeProcessing(
     config: SyncMethods<TResult>,
-    syncState: SyncState
+    syncState: SyncState,
   ): FullSyncState {
     const { begin, commit } = config
     const { graph, inputs, pipeline } = this.maybeCompileBasePipeline()
@@ -681,11 +681,11 @@ export class CollectionConfigBuilder<
         messages
           .reduce(
             accumulateChanges<TResult>,
-            new Map<unknown, Changes<TResult>>()
+            new Map<unknown, Changes<TResult>>(),
           )
           .forEach(this.applyChanges.bind(this, config))
         commit()
-      })
+      }),
     )
 
     graph.finalize()
@@ -706,7 +706,7 @@ export class CollectionConfigBuilder<
       value: TResult
       orderByIndex: string | undefined
     },
-    key: unknown
+    key: unknown,
   ) {
     const { write, collection } = config
     const { deletes, inserts, value, orderByIndex } = changes
@@ -745,7 +745,7 @@ export class CollectionConfigBuilder<
       })
     } else {
       throw new Error(
-        `Could not apply changes: ${JSON.stringify(changes)}. This should never happen.`
+        `Could not apply changes: ${JSON.stringify(changes)}. This should never happen.`,
       )
     }
   }
@@ -756,14 +756,14 @@ export class CollectionConfigBuilder<
   private handleSourceStatusChange(
     config: SyncMethods<TResult>,
     collectionId: string,
-    event: AllCollectionEvents[`status:change`]
+    event: AllCollectionEvents[`status:change`],
   ) {
     const { status } = event
 
     // Handle error state - any source collection in error puts live query in error
     if (status === `error`) {
       this.transitionToError(
-        `Source collection '${collectionId}' entered error state`
+        `Source collection '${collectionId}' entered error state`,
       )
       return
     }
@@ -773,7 +773,7 @@ export class CollectionConfigBuilder<
     if (status === `cleaned-up`) {
       this.transitionToError(
         `Source collection '${collectionId}' was manually cleaned up while live query '${this.id}' depends on it. ` +
-          `Live queries prevent automatic GC, so this was likely a manual cleanup() call.`
+          `Live queries prevent automatic GC, so this was likely a manual cleanup() call.`,
       )
       return
     }
@@ -814,7 +814,7 @@ export class CollectionConfigBuilder<
 
   private allCollectionsReady() {
     return Object.values(this.collections).every((collection) =>
-      collection.isReady()
+      collection.isReady(),
     )
   }
 
@@ -825,14 +825,14 @@ export class CollectionConfigBuilder<
    */
   private subscribeToAllCollections(
     config: SyncMethods<TResult>,
-    syncState: FullSyncState
+    syncState: FullSyncState,
   ) {
     // Use compiled aliases as the source of truth - these include all aliases from the query
     // including those from subqueries, which may not be in collectionByAlias
     const compiledAliases = Object.entries(this.compiledAliasToCollectionId)
     if (compiledAliases.length === 0) {
       throw new Error(
-        `Compiler returned no alias metadata for query '${this.id}'. This should not happen; please report.`
+        `Compiler returned no alias metadata for query '${this.id}'. This should not happen; please report.`,
       )
     }
 
@@ -857,7 +857,7 @@ export class CollectionConfigBuilder<
         alias,
         collectionId,
         collection,
-        this
+        this,
       )
 
       // Subscribe to status changes for status flow
@@ -874,7 +874,7 @@ export class CollectionConfigBuilder<
       // Create a callback for loading more data if needed (used by OrderBy optimization)
       const loadMore = collectionSubscriber.loadMoreIfNeeded.bind(
         collectionSubscriber,
-        subscription
+        subscription,
       )
 
       return loadMore
@@ -900,7 +900,7 @@ export class CollectionConfigBuilder<
 }
 
 function buildQueryFromConfig<TContext extends Context>(
-  config: LiveQueryCollectionConfig<any, any>
+  config: LiveQueryCollectionConfig<any, any>,
 ) {
   // Build the query using the provided query builder function or instance
   if (typeof config.query === `function`) {
@@ -910,7 +910,7 @@ function buildQueryFromConfig<TContext extends Context>(
 }
 
 function createOrderByComparator<T extends object>(
-  orderByIndices: WeakMap<object, string>
+  orderByIndices: WeakMap<object, string>,
 ) {
   return (val1: T, val2: T): number => {
     // Use the orderBy index stored in the WeakMap
@@ -939,7 +939,7 @@ function createOrderByComparator<T extends object>(
  * Maps collections by their ID (not alias) as expected by the compiler
  */
 function extractCollectionsFromQuery(
-  query: any
+  query: any,
 ): Record<string, Collection<any, any, any>> {
   const collections: Record<string, any> = {}
 
@@ -991,7 +991,7 @@ function extractCollectionFromSource(query: any): Collection<any, any, any> {
   }
 
   throw new Error(
-    `Failed to extract collection. Invalid FROM clause: ${JSON.stringify(query)}`
+    `Failed to extract collection. Invalid FROM clause: ${JSON.stringify(query)}`,
   )
 }
 
@@ -1059,7 +1059,7 @@ function accumulateChanges<T>(
   [[key, tupleData], multiplicity]: [
     [unknown, [any, string | undefined]],
     number,
-  ]
+  ],
 ) {
   // All queries now consistently return [value, orderByIndex] format
   // where orderByIndex is undefined for queries without ORDER BY

package/src/query/live/collection-registry.ts

@@ -1,6 +1,6 @@
-import { LIVE_QUERY_INTERNAL } from "./internal.js"
-import type { Collection } from "../../collection/index.js"
-import type { CollectionConfigBuilder } from "./collection-config-builder.js"
+import { LIVE_QUERY_INTERNAL } from './internal.js'
+import type { Collection } from '../../collection/index.js'
+import type { CollectionConfigBuilder } from './collection-config-builder.js'
 
 const collectionBuilderRegistry = new WeakMap<
   Collection<any, any, any>,
@@ -14,7 +14,7 @@ const collectionBuilderRegistry = new WeakMap<
  * @returns The attached builder, or `undefined` if none exists
  */
 export function getBuilderFromConfig(
-  config: object
+  config: object,
 ): CollectionConfigBuilder<any, any> | undefined {
   return (config as any).utils?.[LIVE_QUERY_INTERNAL]?.getBuilder?.()
 }
@@ -29,7 +29,7 @@ export function getBuilderFromConfig(
  */
 export function registerCollectionBuilder(
   collection: Collection<any, any, any>,
-  builder: CollectionConfigBuilder<any, any>
+  builder: CollectionConfigBuilder<any, any>,
 ): void {
   collectionBuilderRegistry.set(collection, builder)
 }
@@ -42,7 +42,7 @@ export function registerCollectionBuilder(
  * @returns The registered builder, or `undefined` if none exists
  */
 export function getCollectionBuilder(
-  collection: Collection<any, any, any>
+  collection: Collection<any, any, any>,
 ): CollectionConfigBuilder<any, any> | undefined {
   return collectionBuilderRegistry.get(collection)
 }