@tanstack/db 0.5.11 → 0.5.13

package/src/collection/sync.ts

@@ -7,22 +7,23 @@ import {
   SyncCleanupError,
   SyncTransactionAlreadyCommittedError,
   SyncTransactionAlreadyCommittedWriteError,
-} from "../errors"
-import { deepEquals } from "../utils"
-import { LIVE_QUERY_INTERNAL } from "../query/live/internal.js"
-import type { StandardSchemaV1 } from "@standard-schema/spec"
+} from '../errors'
+import { deepEquals } from '../utils'
+import { LIVE_QUERY_INTERNAL } from '../query/live/internal.js'
+import type { StandardSchemaV1 } from '@standard-schema/spec'
 import type {
-  ChangeMessage,
+  ChangeMessageOrDeleteKeyMessage,
   CleanupFn,
   CollectionConfig,
   LoadSubsetOptions,
+  OptimisticChangeMessage,
   SyncConfigRes,
-} from "../types"
-import type { CollectionImpl } from "./index.js"
-import type { CollectionStateManager } from "./state"
-import type { CollectionLifecycleManager } from "./lifecycle"
-import type { CollectionEventsManager } from "./events.js"
-import type { LiveQueryCollectionUtils } from "../query/live/collection-config-builder.js"
+} from '../types'
+import type { CollectionImpl } from './index.js'
+import type { CollectionStateManager } from './state'
+import type { CollectionLifecycleManager } from './lifecycle'
+import type { CollectionEventsManager } from './events.js'
+import type { LiveQueryCollectionUtils } from '../query/live/collection-config-builder.js'
 
 export class CollectionSyncManager<
   TOutput extends object = Record<string, unknown>,
@@ -94,7 +95,12 @@ export class CollectionSyncManager<
               deletedKeys: new Set(),
             })
           },
-          write: (messageWithoutKey: Omit<ChangeMessage<TOutput>, `key`>) => {
+          write: (
+            messageWithOptionalKey: ChangeMessageOrDeleteKeyMessage<
+              TOutput,
+              TKey
+            >,
+          ) => {
             const pendingTransaction =
               this.state.pendingSyncedTransactions[
                 this.state.pendingSyncedTransactions.length - 1
@@ -105,12 +111,18 @@ export class CollectionSyncManager<
             if (pendingTransaction.committed) {
               throw new SyncTransactionAlreadyCommittedWriteError()
             }
-            const key = this.config.getKey(messageWithoutKey.value)
 
-            let messageType = messageWithoutKey.type
+            let key: TKey | undefined = undefined
+            if (`key` in messageWithOptionalKey) {
+              key = messageWithOptionalKey.key
+            } else {
+              key = this.config.getKey(messageWithOptionalKey.value)
+            }
+
+            let messageType = messageWithOptionalKey.type
 
             // Check if an item with this key already exists when inserting
-            if (messageWithoutKey.type === `insert`) {
+            if (messageWithOptionalKey.type === `insert`) {
               const insertingIntoExistingSynced = this.state.syncedData.has(key)
               const hasPendingDeleteForKey =
                 pendingTransaction.deletedKeys.has(key)
@@ -124,7 +136,7 @@ export class CollectionSyncManager<
                 const existingValue = this.state.syncedData.get(key)
                 if (
                   existingValue !== undefined &&
-                  deepEquals(existingValue, messageWithoutKey.value)
+                  deepEquals(existingValue, messageWithOptionalKey.value)
                 ) {
                   // The "insert" is an echo of a value we already have locally.
                   // Treat it as an update so we preserve optimistic intent without
@@ -142,11 +154,11 @@ export class CollectionSyncManager<
               }
             }
 
-            const message: ChangeMessage<TOutput> = {
-              ...messageWithoutKey,
+            const message = {
+              ...messageWithOptionalKey,
               type: messageType,
               key,
-            }
+            } as OptimisticChangeMessage<TOutput, TKey>
             pendingTransaction.operations.push(message)
 
             if (messageType === `delete`) {
@@ -202,7 +214,7 @@ export class CollectionSyncManager<
               deletes: new Set(this.state.optimisticDeletes),
             }
           },
-        })
+        }),
       )
 
       // Store cleanup function if provided
@@ -218,7 +230,7 @@ export class CollectionSyncManager<
       if (this.syncMode === `on-demand` && !this.syncLoadSubsetFn) {
         throw new CollectionConfigurationError(
           `Collection "${this.id}" is configured with syncMode "on-demand" but the sync function did not return a loadSubset handler. ` +
-            `Either provide a loadSubset handler or use syncMode "eager".`
+            `Either provide a loadSubset handler or use syncMode "eager".`,
         )
       }
     } catch (error) {
@@ -242,7 +254,7 @@ export class CollectionSyncManager<
         `${this.id ? `[${this.id}] ` : ``}Calling .preload() on a collection with syncMode "on-demand" is a no-op. ` +
           `In on-demand mode, data is only loaded when queries request it. ` +
           `Instead, create a live query and call .preload() on that to load the specific data you need. ` +
-          `See https://tanstack.com/blog/tanstack-db-0.5-query-driven-sync for more details.`
+          `See https://tanstack.com/blog/tanstack-db-0.5-query-driven-sync for more details.`,
       )
     }
 

package/src/duplicate-instance-check.ts

@@ -1,4 +1,4 @@
-import { DuplicateDbInstanceError } from "./errors"
+import { DuplicateDbInstanceError } from './errors'
 
 /**
  * Check if we're in a browser top-level window (not a worker, SSR, or iframe).

package/src/errors.ts

@@ -28,7 +28,7 @@ export class SchemaValidationError extends TanStackDBError {
       message: string
       path?: ReadonlyArray<string | number | symbol>
     }>,
-    message?: string
+    message?: string,
   ) {
     const defaultMessage = `${type === `insert` ? `Insert` : `Update`} validation failed: ${issues
       .map((issue) => `\n- ${issue.message} - path: ${issue.path}`)
@@ -61,7 +61,7 @@ export class DuplicateDbInstanceError extends TanStackDBError {
         `3. Clear node_modules and lockfile, then reinstall\n\n` +
         `To temporarily disable this check (not recommended):\n` +
         `Set environment variable: TANSTACK_DB_DISABLE_DUP_CHECK=1\n\n` +
-        `See: https://tanstack.com/db/latest/docs/troubleshooting#duplicate-instances`
+        `See: https://tanstack.com/db/latest/docs/troubleshooting#duplicate-instances`,
     )
     this.name = `DuplicateDbInstanceError`
   }
@@ -110,7 +110,7 @@ export class CollectionStateError extends TanStackDBError {
 export class CollectionInErrorStateError extends CollectionStateError {
   constructor(operation: string, collectionId: string) {
     super(
-      `Cannot perform ${operation} on collection "${collectionId}" - collection is in error state. Try calling cleanup() and restarting the collection.`
+      `Cannot perform ${operation} on collection "${collectionId}" - collection is in error state. Try calling cleanup() and restarting the collection.`,
     )
   }
 }
@@ -118,7 +118,7 @@ export class CollectionInErrorStateError extends CollectionStateError {
 export class InvalidCollectionStatusTransitionError extends CollectionStateError {
   constructor(from: string, to: string, collectionId: string) {
     super(
-      `Invalid collection status transition from "${from}" to "${to}" for collection "${collectionId}"`
+      `Invalid collection status transition from "${from}" to "${to}" for collection "${collectionId}"`,
     )
   }
 }
@@ -146,7 +146,16 @@ export class CollectionOperationError extends TanStackDBError {
 export class UndefinedKeyError extends CollectionOperationError {
   constructor(item: any) {
     super(
-      `An object was created without a defined key: ${JSON.stringify(item)}`
+      `An object was created without a defined key: ${JSON.stringify(item)}`,
+    )
+  }
+}
+
+export class InvalidKeyError extends CollectionOperationError {
+  constructor(key: unknown, item: unknown) {
+    const keyType = key === null ? `null` : typeof key
+    super(
+      `getKey returned an invalid key type. Expected string or number, but got ${keyType}: ${JSON.stringify(key)}. Item: ${JSON.stringify(item)}`,
     )
   }
 }
@@ -154,7 +163,7 @@ export class UndefinedKeyError extends CollectionOperationError {
 export class DuplicateKeyError extends CollectionOperationError {
   constructor(key: string | number) {
     super(
-      `Cannot insert document with ID "${key}" because it already exists in the collection`
+      `Cannot insert document with ID "${key}" because it already exists in the collection`,
     )
   }
 }
@@ -163,7 +172,7 @@ export class DuplicateKeySyncError extends CollectionOperationError {
   constructor(
     key: string | number,
     collectionId: string,
-    options?: { hasCustomGetKey?: boolean; hasJoins?: boolean }
+    options?: { hasCustomGetKey?: boolean; hasJoins?: boolean },
   ) {
     const baseMessage = `Cannot insert document with key "${key}" from sync because it already exists in the collection "${collectionId}"`
 
@@ -175,7 +184,7 @@ export class DuplicateKeySyncError extends CollectionOperationError {
           `Joined queries can produce multiple rows with the same key when relationships are not 1:1. ` +
           `Consider: (1) using a composite key in your getKey function (e.g., \`\${item.key1}-\${item.key2}\`), ` +
           `(2) ensuring your join produces unique rows per key, or (3) removing the custom getKey ` +
-          `to use the default composite key behavior.`
+          `to use the default composite key behavior.`,
       )
     } else {
       super(baseMessage)
@@ -198,7 +207,7 @@ export class NoKeysPassedToUpdateError extends CollectionOperationError {
 export class UpdateKeyNotFoundError extends CollectionOperationError {
   constructor(key: string | number) {
     super(
-      `The key "${key}" was passed to update but an object for this key was not found in the collection`
+      `The key "${key}" was passed to update but an object for this key was not found in the collection`,
     )
   }
 }
@@ -206,7 +215,7 @@ export class UpdateKeyNotFoundError extends CollectionOperationError {
 export class KeyUpdateNotAllowedError extends CollectionOperationError {
   constructor(originalKey: string | number, newKey: string | number) {
     super(
-      `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.`
+      `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.`,
     )
   }
 }
@@ -220,7 +229,7 @@ export class NoKeysPassedToDeleteError extends CollectionOperationError {
 export class DeleteKeyNotFoundError extends CollectionOperationError {
   constructor(key: string | number) {
     super(
-      `Collection.delete was called with key '${key}' but there is no item in the collection with this key`
+      `Collection.delete was called with key '${key}' but there is no item in the collection with this key`,
     )
   }
 }
@@ -236,7 +245,7 @@ export class MissingHandlerError extends TanStackDBError {
 export class MissingInsertHandlerError extends MissingHandlerError {
   constructor() {
     super(
-      `Collection.insert called directly (not within an explicit transaction) but no 'onInsert' handler is configured.`
+      `Collection.insert called directly (not within an explicit transaction) but no 'onInsert' handler is configured.`,
     )
   }
 }
@@ -244,7 +253,7 @@ export class MissingInsertHandlerError extends MissingHandlerError {
 export class MissingUpdateHandlerError extends MissingHandlerError {
   constructor() {
     super(
-      `Collection.update called directly (not within an explicit transaction) but no 'onUpdate' handler is configured.`
+      `Collection.update called directly (not within an explicit transaction) but no 'onUpdate' handler is configured.`,
     )
   }
 }
@@ -252,7 +261,7 @@ export class MissingUpdateHandlerError extends MissingHandlerError {
 export class MissingDeleteHandlerError extends MissingHandlerError {
   constructor() {
     super(
-      `Collection.delete called directly (not within an explicit transaction) but no 'onDelete' handler is configured.`
+      `Collection.delete called directly (not within an explicit transaction) but no 'onDelete' handler is configured.`,
     )
   }
 }
@@ -274,7 +283,7 @@ export class MissingMutationFunctionError extends TransactionError {
 export class OnMutateMustBeSynchronousError extends TransactionError {
   constructor() {
     super(
-      `onMutate must be synchronous and cannot return a promise. Remove async/await or returned promises from onMutate.`
+      `onMutate must be synchronous and cannot return a promise. Remove async/await or returned promises from onMutate.`,
     )
     this.name = `OnMutateMustBeSynchronousError`
   }
@@ -283,7 +292,7 @@ export class OnMutateMustBeSynchronousError extends TransactionError {
 export class TransactionNotPendingMutateError extends TransactionError {
   constructor() {
     super(
-      `You can no longer call .mutate() as the transaction is no longer pending`
+      `You can no longer call .mutate() as the transaction is no longer pending`,
     )
   }
 }
@@ -291,7 +300,7 @@ export class TransactionNotPendingMutateError extends TransactionError {
 export class TransactionAlreadyCompletedRollbackError extends TransactionError {
   constructor() {
     super(
-      `You can no longer call .rollback() as the transaction is already completed`
+      `You can no longer call .rollback() as the transaction is already completed`,
     )
   }
 }
@@ -299,7 +308,7 @@ export class TransactionAlreadyCompletedRollbackError extends TransactionError {
 export class TransactionNotPendingCommitError extends TransactionError {
   constructor() {
     super(
-      `You can no longer call .commit() as the transaction is no longer pending`
+      `You can no longer call .commit() as the transaction is no longer pending`,
     )
   }
 }
@@ -313,7 +322,7 @@ export class NoPendingSyncTransactionWriteError extends TransactionError {
 export class SyncTransactionAlreadyCommittedWriteError extends TransactionError {
   constructor() {
     super(
-      `The pending sync transaction is already committed, you can't still write to it.`
+      `The pending sync transaction is already committed, you can't still write to it.`,
     )
   }
 }
@@ -327,7 +336,7 @@ export class NoPendingSyncTransactionCommitError extends TransactionError {
 export class SyncTransactionAlreadyCommittedError extends TransactionError {
   constructor() {
     super(
-      `The pending sync transaction is already committed, you can't commit it again.`
+      `The pending sync transaction is already committed, you can't commit it again.`,
     )
   }
 }
@@ -355,7 +364,7 @@ export class SubQueryMustHaveFromClauseError extends QueryBuilderError {
 export class InvalidSourceError extends QueryBuilderError {
   constructor(alias: string) {
     super(
-      `Invalid source for live query: The value provided for alias "${alias}" is not a Collection or subquery. Live queries only accept Collection instances or subqueries. Please ensure you're passing a valid Collection or QueryBuilder, not a plain array or other data type.`
+      `Invalid source for live query: The value provided for alias "${alias}" is not a Collection or subquery. Live queries only accept Collection instances or subqueries. Please ensure you're passing a valid Collection or QueryBuilder, not a plain array or other data type.`,
     )
   }
 }
@@ -364,7 +373,7 @@ export class InvalidSourceTypeError extends QueryBuilderError {
   constructor(context: string, type: string) {
     super(
       `Invalid source for ${context}: Expected an object with a single key-value pair like { alias: collection }. ` +
-        `For example: .from({ todos: todosCollection }). Got: ${type}`
+        `For example: .from({ todos: todosCollection }). Got: ${type}`,
     )
   }
 }
@@ -404,7 +413,7 @@ export class HavingRequiresGroupByError extends QueryCompilationError {
 export class LimitOffsetRequireOrderByError extends QueryCompilationError {
   constructor() {
     super(
-      `LIMIT and OFFSET require an ORDER BY clause to ensure deterministic results`
+      `LIMIT and OFFSET require an ORDER BY clause to ensure deterministic results`,
     )
   }
 }
@@ -417,7 +426,7 @@ export class CollectionInputNotFoundError extends QueryCompilationError {
   constructor(
     alias: string,
     collectionId?: string,
-    availableKeys?: Array<string>
+    availableKeys?: Array<string>,
   ) {
     const details = collectionId
       ? `alias "${alias}" (collection "${collectionId}")`
@@ -440,7 +449,7 @@ export class DuplicateAliasInSubqueryError extends QueryCompilationError {
       `Subquery uses alias "${alias}" which is already used in the parent query. ` +
         `Each alias must be unique across parent and subquery contexts. ` +
         `Parent query aliases: ${parentAliases.join(`, `)}. ` +
-        `Please rename "${alias}" in either the parent query or subquery to avoid conflicts.`
+        `Please rename "${alias}" in either the parent query or subquery to avoid conflicts.`,
     )
   }
 }
@@ -492,7 +501,7 @@ export class UnsupportedJoinTypeError extends JoinError {
 export class InvalidJoinConditionSameSourceError extends JoinError {
   constructor(sourceAlias: string) {
     super(
-      `Invalid join condition: both expressions refer to the same source "${sourceAlias}"`
+      `Invalid join condition: both expressions refer to the same source "${sourceAlias}"`,
     )
   }
 }
@@ -506,7 +515,7 @@ export class InvalidJoinConditionSourceMismatchError extends JoinError {
 export class InvalidJoinConditionLeftSourceError extends JoinError {
   constructor(sourceAlias: string) {
     super(
-      `Invalid join condition: left expression refers to an unavailable source "${sourceAlias}"`
+      `Invalid join condition: left expression refers to an unavailable source "${sourceAlias}"`,
     )
   }
 }
@@ -514,7 +523,7 @@ export class InvalidJoinConditionLeftSourceError extends JoinError {
 export class InvalidJoinConditionRightSourceError extends JoinError {
   constructor(sourceAlias: string) {
     super(
-      `Invalid join condition: right expression does not refer to the joined source "${sourceAlias}"`
+      `Invalid join condition: right expression does not refer to the joined source "${sourceAlias}"`,
     )
   }
 }
@@ -542,7 +551,7 @@ export class GroupByError extends TanStackDBError {
 export class NonAggregateExpressionNotInGroupByError extends GroupByError {
   constructor(alias: string) {
     super(
-      `Non-aggregate expression '${alias}' in SELECT must also appear in GROUP BY clause`
+      `Non-aggregate expression '${alias}' in SELECT must also appear in GROUP BY clause`,
     )
   }
 }
@@ -556,7 +565,7 @@ export class UnsupportedAggregateFunctionError extends GroupByError {
 export class AggregateFunctionNotInSelectError extends GroupByError {
   constructor(functionName: string) {
     super(
-      `Aggregate function in HAVING clause must also be in SELECT clause: ${functionName}`
+      `Aggregate function in HAVING clause must also be in SELECT clause: ${functionName}`,
     )
   }
 }
@@ -578,7 +587,7 @@ export class StorageError extends TanStackDBError {
 export class SerializationError extends StorageError {
   constructor(operation: string, originalError: string) {
     super(
-      `Cannot ${operation} item because it cannot be JSON serialized: ${originalError}`
+      `Cannot ${operation} item because it cannot be JSON serialized: ${originalError}`,
     )
   }
 }
@@ -600,7 +609,7 @@ export class StorageKeyRequiredError extends LocalStorageCollectionError {
 export class InvalidStorageDataFormatError extends LocalStorageCollectionError {
   constructor(storageKey: string, key: string) {
     super(
-      `[LocalStorageCollection] Invalid data format in storage key "${storageKey}" for key "${key}".`
+      `[LocalStorageCollection] Invalid data format in storage key "${storageKey}" for key "${key}".`,
     )
   }
 }
@@ -608,7 +617,7 @@ export class InvalidStorageDataFormatError extends LocalStorageCollectionError {
 export class InvalidStorageObjectFormatError extends LocalStorageCollectionError {
   constructor(storageKey: string) {
     super(
-      `[LocalStorageCollection] Invalid data format in storage key "${storageKey}". Expected object format.`
+      `[LocalStorageCollection] Invalid data format in storage key "${storageKey}". Expected object format.`,
     )
   }
 }
@@ -618,7 +627,7 @@ export class SyncCleanupError extends TanStackDBError {
   constructor(collectionId: string, error: Error | string) {
     const message = error instanceof Error ? error.message : String(error)
     super(
-      `Collection "${collectionId}" sync cleanup function threw an error: ${message}`
+      `Collection "${collectionId}" sync cleanup function threw an error: ${message}`,
     )
     this.name = `SyncCleanupError`
   }
@@ -644,7 +653,7 @@ export class CannotCombineEmptyExpressionListError extends QueryOptimizerError {
 export class WhereClauseConversionError extends QueryOptimizerError {
   constructor(collectionId: string, alias: string) {
     super(
-      `Failed to convert WHERE clause to collection filter for collection '${collectionId}' alias '${alias}'. This indicates a bug in the query optimization logic.`
+      `Failed to convert WHERE clause to collection filter for collection '${collectionId}' alias '${alias}'. This indicates a bug in the query optimization logic.`,
     )
   }
 }
@@ -658,10 +667,10 @@ export class SubscriptionNotFoundError extends QueryCompilationError {
     resolvedAlias: string,
     originalAlias: string,
     collectionId: string,
-    availableAliases: Array<string>
+    availableAliases: Array<string>,
   ) {
     super(
-      `Internal error: subscription for alias '${resolvedAlias}' (remapped from '${originalAlias}', collection '${collectionId}') is missing in join pipeline. Available aliases: ${availableAliases.join(`, `)}. This indicates a bug in alias tracking.`
+      `Internal error: subscription for alias '${resolvedAlias}' (remapped from '${originalAlias}', collection '${collectionId}') is missing in join pipeline. Available aliases: ${availableAliases.join(`, `)}. This indicates a bug in alias tracking.`,
     )
   }
 }
@@ -672,7 +681,7 @@ export class SubscriptionNotFoundError extends QueryCompilationError {
 export class AggregateNotSupportedError extends QueryCompilationError {
   constructor() {
     super(
-      `Aggregate expressions are not supported in this context. Use GROUP BY clause for aggregates.`
+      `Aggregate expressions are not supported in this context. Use GROUP BY clause for aggregates.`,
     )
   }
 }
@@ -685,7 +694,7 @@ export class MissingAliasInputsError extends QueryCompilationError {
   constructor(missingAliases: Array<string>) {
     super(
       `Internal error: compiler returned aliases without inputs: ${missingAliases.join(`, `)}. ` +
-        `This indicates a bug in query compilation. Please report this issue.`
+        `This indicates a bug in query compilation. Please report this issue.`,
     )
   }
 }
@@ -697,7 +706,7 @@ export class SetWindowRequiresOrderByError extends QueryCompilationError {
   constructor() {
     super(
       `setWindow() can only be called on collections with an ORDER BY clause. ` +
-        `Add .orderBy() to your query to enable window movement.`
+        `Add .orderBy() to your query to enable window movement.`,
     )
   }
 }

package/src/event-emitter.ts

@@ -16,7 +16,7 @@ export class EventEmitter<TEvents extends Record<string, any>> {
    */
   on<T extends keyof TEvents>(
     event: T,
-    callback: (event: TEvents[T]) => void
+    callback: (event: TEvents[T]) => void,
   ): () => void {
     if (!this.listeners.has(event)) {
       this.listeners.set(event, new Set())
@@ -36,7 +36,7 @@ export class EventEmitter<TEvents extends Record<string, any>> {
    */
   once<T extends keyof TEvents>(
     event: T,
-    callback: (event: TEvents[T]) => void
+    callback: (event: TEvents[T]) => void,
   ): () => void {
     const unsubscribe = this.on(event, (eventPayload) => {
       callback(eventPayload)
@@ -52,7 +52,7 @@ export class EventEmitter<TEvents extends Record<string, any>> {
    */
   off<T extends keyof TEvents>(
     event: T,
-    callback: (event: TEvents[T]) => void
+    callback: (event: TEvents[T]) => void,
   ): void {
     this.listeners.get(event)?.delete(callback as (event: any) => void)
   }
@@ -65,7 +65,7 @@ export class EventEmitter<TEvents extends Record<string, any>> {
    */
   waitFor<T extends keyof TEvents>(
     event: T,
-    timeout?: number
+    timeout?: number,
   ): Promise<TEvents[T]> {
     return new Promise((resolve, reject) => {
       let timeoutId: NodeJS.Timeout | undefined
@@ -95,7 +95,7 @@ export class EventEmitter<TEvents extends Record<string, any>> {
    */
   protected emitInner<T extends keyof TEvents>(
     event: T,
-    eventPayload: TEvents[T]
+    eventPayload: TEvents[T],
   ): void {
     this.listeners.get(event)?.forEach((listener) => {
       try {

package/src/index.ts

@@ -1,32 +1,32 @@
 // Re-export all public APIs
 // Re-export IR types under their own namespace
 // because custom collections need access to the IR types
-import * as IR from "./query/ir.js"
+import * as IR from './query/ir.js'
 
-export * from "./collection/index.js"
-export * from "./SortedMap"
-export * from "./transactions"
-export * from "./types"
-export * from "./proxy"
-export * from "./query/index.js"
-export * from "./optimistic-action"
-export * from "./local-only"
-export * from "./local-storage"
-export * from "./errors"
-export { deepEquals } from "./utils"
-export * from "./paced-mutations"
-export * from "./strategies/index.js"
+export * from './collection/index.js'
+export * from './SortedMap'
+export * from './transactions'
+export * from './types'
+export * from './proxy'
+export * from './query/index.js'
+export * from './optimistic-action'
+export * from './local-only'
+export * from './local-storage'
+export * from './errors'
+export { deepEquals } from './utils'
+export * from './paced-mutations'
+export * from './strategies/index.js'
 
 // Index system exports
-export * from "./indexes/base-index.js"
-export * from "./indexes/btree-index.js"
-export * from "./indexes/lazy-index.js"
-export { type IndexOptions } from "./indexes/index-options.js"
+export * from './indexes/base-index.js'
+export * from './indexes/btree-index.js'
+export * from './indexes/lazy-index.js'
+export { type IndexOptions } from './indexes/index-options.js'
 
 // Expression helpers
-export * from "./query/expression-helpers.js"
+export * from './query/expression-helpers.js'
 
 // Re-export some stuff explicitly to ensure the type & value is exported
-export type { Collection } from "./collection/index.js"
+export type { Collection } from './collection/index.js'
 export { IR }
-export { operators, type OperatorName } from "./query/builder/functions.js"
+export { operators, type OperatorName } from './query/builder/functions.js'

package/src/indexes/auto-index.ts

@@ -1,8 +1,8 @@
-import { DEFAULT_COMPARE_OPTIONS } from "../utils"
-import { BTreeIndex } from "./btree-index"
-import type { CompareOptions } from "../query/builder/types"
-import type { BasicExpression } from "../query/ir"
-import type { CollectionImpl } from "../collection/index.js"
+import { DEFAULT_COMPARE_OPTIONS } from '../utils'
+import { BTreeIndex } from './btree-index'
+import type { CompareOptions } from '../query/builder/types'
+import type { BasicExpression } from '../query/ir'
+import type { CollectionImpl } from '../collection/index.js'
 
 export interface AutoIndexConfig {
   autoIndex?: `off` | `eager`
@@ -25,7 +25,7 @@ export function ensureIndexForField<
   fieldPath: Array<string>,
   collection: CollectionImpl<T, TKey, any, any, any>,
   compareOptions?: CompareOptions,
-  compareFn?: (a: any, b: any) => number
+  compareFn?: (a: any, b: any) => number,
 ) {
   if (!shouldAutoIndex(collection)) {
     return
@@ -39,7 +39,7 @@ export function ensureIndexForField<
   // Check if we already have an index for this field
   const existingIndex = Array.from(collection.indexes.values()).find(
     (index) =>
-      index.matchesField(fieldPath) && index.matchesCompareOptions(compareOpts)
+      index.matchesField(fieldPath) && index.matchesCompareOptions(compareOpts),
   )
 
   if (existingIndex) {
@@ -62,12 +62,12 @@ export function ensureIndexForField<
         name: `auto:${fieldPath.join(`.`)}`,
         indexType: BTreeIndex,
         options: compareFn ? { compareFn, compareOptions: compareOpts } : {},
-      }
+      },
     )
   } catch (error) {
     console.warn(
       `${collection.id ? `[${collection.id}] ` : ``}Failed to create auto-index for field path "${fieldPath.join(`.`)}":`,
-      error
+      error,
     )
   }
 }
@@ -80,7 +80,7 @@ export function ensureIndexForExpression<
   TKey extends string | number,
 >(
   expression: BasicExpression,
-  collection: CollectionImpl<T, TKey, any, any, any>
+  collection: CollectionImpl<T, TKey, any, any, any>,
 ): void {
   if (!shouldAutoIndex(collection)) {
     return
@@ -98,7 +98,7 @@ export function ensureIndexForExpression<
  * Extracts all indexable expressions from a where expression
  */
 function extractIndexableExpressions(
-  expression: BasicExpression
+  expression: BasicExpression,
 ): Array<{ fieldName: string; fieldPath: Array<string> }> {
   const results: Array<{ fieldName: string; fieldPath: Array<string> }> = []