@signaldb/core 2.0.0-beta.2 → 2.0.0-beta.21

package/dist/.vite/manifest.json

@@ -1,117 +1,143 @@
 {
   "src/AsyncDataAdapter.ts": {
-    "file": "index.cjs13.js",
+    "file": "index34.cjs.js",
     "name": "AsyncDataAdapter",
     "src": "src/AsyncDataAdapter.ts",
+    "isDynamicEntry": true,
     "imports": [
+      "src/getIndexInfo.ts",
       "src/utils/deepClone.ts",
+      "src/utils/idIndexQuery.ts",
+      "src/utils/incrementalQueryUpdate.ts",
+      "src/utils/isEqual.ts",
       "src/utils/match.ts",
       "src/utils/modify.ts",
+      "src/utils/projectItems.ts",
+      "src/utils/queryDelta.ts",
       "src/utils/queryId.ts",
-      "src/utils/isEqual.ts",
-      "src/getIndexInfo.ts",
-      "src/utils/getMatchingKeys.ts",
       "src/utils/sortItems.ts",
-      "src/utils/project.ts"
+      "src/utils/storageIndexQuery.ts"
     ]
   },
   "src/AutoFetchDataAdapter.ts": {
-    "file": "index.cjs16.js",
+    "file": "index39.cjs.js",
     "name": "AutoFetchDataAdapter",
     "src": "src/AutoFetchDataAdapter.ts",
+    "isDynamicEntry": true,
     "imports": [
+      "src/getIndexInfo.ts",
       "src/utils/deepClone.ts",
+      "src/utils/idIndexQuery.ts",
+      "src/utils/isEqual.ts",
       "src/utils/match.ts",
       "src/utils/modify.ts",
+      "src/utils/project.ts",
       "src/utils/queryId.ts",
-      "src/utils/isEqual.ts",
-      "src/getIndexInfo.ts",
-      "src/utils/getMatchingKeys.ts",
       "src/utils/sortItems.ts",
-      "src/utils/project.ts"
+      "src/utils/storageIndexQuery.ts"
     ]
   },
   "src/Collection/Cursor.ts": {
-    "file": "index.cjs2.js",
+    "file": "index6.cjs.js",
     "name": "Collection/Cursor",
     "src": "src/Collection/Cursor.ts",
+    "isDynamicEntry": true,
     "imports": [
       "src/Collection/Observer.ts"
     ]
   },
   "src/Collection/Observer.ts": {
-    "file": "index.cjs17.js",
+    "file": "index5.cjs.js",
     "name": "Collection/Observer",
     "src": "src/Collection/Observer.ts",
+    "isDynamicEntry": true,
     "imports": [
       "src/utils/isEqual.ts",
+      "src/utils/queryDelta.ts",
       "src/utils/uniqueBy.ts"
     ]
   },
   "src/Collection/index.ts": {
-    "file": "index.cjs3.js",
+    "file": "index29.cjs.js",
     "name": "Collection/index",
     "src": "src/Collection/index.ts",
+    "isDynamicEntry": true,
     "imports": [
+      "src/Collection/Cursor.ts",
+      "src/DefaultDataAdapter.ts",
+      "src/createIndex.ts",
       "src/utils/EventEmitter.ts",
       "src/utils/createSignal.ts",
-      "src/utils/randomId.ts",
-      "src/DefaultDataAdapter.ts",
-      "src/utils/modify.ts",
       "src/utils/deepClone.ts",
+      "src/utils/modify.ts",
       "src/utils/queryId.ts",
-      "src/Collection/Cursor.ts"
+      "src/utils/randomId.ts"
     ]
   },
   "src/DefaultDataAdapter.ts": {
-    "file": "index.cjs12.js",
+    "file": "index28.cjs.js",
     "name": "DefaultDataAdapter",
     "src": "src/DefaultDataAdapter.ts",
+    "isDynamicEntry": true,
     "imports": [
       "src/createIndex.ts",
       "src/getIndexInfo.ts",
-      "src/utils/deepClone.ts",
       "src/utils/EventEmitter.ts",
+      "src/utils/deepClone.ts",
+      "src/utils/idIndexQuery.ts",
+      "src/utils/incrementalQueryUpdate.ts",
       "src/utils/isEqual.ts",
       "src/utils/match.ts",
       "src/utils/modify.ts",
-      "src/utils/project.ts",
+      "src/utils/projectItems.ts",
+      "src/utils/queryDelta.ts",
       "src/utils/queryId.ts",
       "src/utils/serializeValue.ts",
       "src/utils/sortItems.ts"
     ]
   },
   "src/WorkerDataAdapter.ts": {
-    "file": "index.cjs14.js",
+    "file": "index36.cjs.js",
     "name": "WorkerDataAdapter",
     "src": "src/WorkerDataAdapter.ts",
+    "isDynamicEntry": true,
     "imports": [
+      "src/utils/batchOnNextTick.ts",
+      "src/utils/deepClone.ts",
+      "src/utils/incrementalQueryUpdate.ts",
+      "src/utils/match.ts",
+      "src/utils/modify.ts",
+      "src/utils/queryDelta.ts",
       "src/utils/queryId.ts",
-      "src/utils/randomId.ts",
-      "src/utils/batchOnNextTick.ts"
+      "src/utils/randomId.ts"
     ]
   },
   "src/WorkerDataAdapterHost.ts": {
-    "file": "index.cjs15.js",
+    "file": "index38.cjs.js",
     "name": "WorkerDataAdapterHost",
     "src": "src/WorkerDataAdapterHost.ts",
+    "isDynamicEntry": true,
     "imports": [
+      "src/getIndexInfo.ts",
+      "src/utils/compact.ts",
       "src/utils/deepClone.ts",
+      "src/utils/idIndexQuery.ts",
+      "src/utils/incrementalQueryUpdate.ts",
+      "src/utils/isEqual.ts",
       "src/utils/match.ts",
       "src/utils/modify.ts",
+      "src/utils/projectItems.ts",
+      "src/utils/queryDelta.ts",
       "src/utils/queryId.ts",
-      "src/utils/isEqual.ts",
-      "src/getIndexInfo.ts",
-      "src/utils/getMatchingKeys.ts",
       "src/utils/sortItems.ts",
-      "src/utils/project.ts",
-      "src/utils/compact.ts"
+      "src/utils/storageIndexQuery.ts"
     ]
   },
   "src/createIndex.ts": {
-    "file": "index.cjs21.js",
+    "file": "index15.cjs.js",
     "name": "createIndex",
     "src": "src/createIndex.ts",
+    "isDynamicEntry": true,
     "imports": [
       "src/createIndexProvider.ts",
       "src/utils/get.ts",
@@ -120,24 +146,28 @@
     ]
   },
   "src/createIndexProvider.ts": {
-    "file": "index.cjs33.js",
+    "file": "index10.cjs.js",
     "name": "createIndexProvider",
-    "src": "src/createIndexProvider.ts"
+    "src": "src/createIndexProvider.ts",
+    "isDynamicEntry": true
   },
   "src/createReactivityAdapter.ts": {
-    "file": "index.cjs5.js",
+    "file": "index31.cjs.js",
     "name": "createReactivityAdapter",
-    "src": "src/createReactivityAdapter.ts"
+    "src": "src/createReactivityAdapter.ts",
+    "isDynamicEntry": true
   },
   "src/createStorageAdapter.ts": {
-    "file": "index.cjs4.js",
+    "file": "index30.cjs.js",
     "name": "createStorageAdapter",
-    "src": "src/createStorageAdapter.ts"
+    "src": "src/createStorageAdapter.ts",
+    "isDynamicEntry": true
   },
   "src/getIndexInfo.ts": {
-    "file": "index.cjs22.js",
+    "file": "index17.cjs.js",
     "name": "getIndexInfo",
     "src": "src/getIndexInfo.ts",
+    "isDynamicEntry": true,
     "imports": [
       "src/utils/intersection.ts"
     ]
@@ -148,130 +178,203 @@
     "src": "src/index.ts",
     "isEntry": true,
     "imports": [
+      "src/AsyncDataAdapter.ts",
+      "src/AutoFetchDataAdapter.ts",
       "src/Collection/Cursor.ts",
       "src/Collection/index.ts",
-      "src/createStorageAdapter.ts",
+      "src/DefaultDataAdapter.ts",
+      "src/WorkerDataAdapter.ts",
+      "src/WorkerDataAdapterHost.ts",
       "src/createReactivityAdapter.ts",
+      "src/createStorageAdapter.ts",
+      "src/utils/EventEmitter.ts",
+      "src/utils/get.ts",
       "src/utils/isEqual.ts",
       "src/utils/modify.ts",
       "src/utils/randomId.ts",
-      "src/utils/EventEmitter.ts",
-      "src/utils/get.ts",
-      "src/utils/serializeValue.ts",
-      "src/DefaultDataAdapter.ts",
-      "src/AsyncDataAdapter.ts",
-      "src/WorkerDataAdapter.ts",
-      "src/WorkerDataAdapterHost.ts",
-      "src/AutoFetchDataAdapter.ts"
+      "src/utils/reactiveOrAsync.ts",
+      "src/utils/serializeValue.ts"
     ]
   },
   "src/utils/EventEmitter.ts": {
-    "file": "index.cjs9.js",
+    "file": "index7.cjs.js",
     "name": "utils/EventEmitter",
-    "src": "src/utils/EventEmitter.ts"
+    "src": "src/utils/EventEmitter.ts",
+    "isDynamicEntry": true
   },
   "src/utils/batchOnNextTick.ts": {
-    "file": "index.cjs27.js",
+    "file": "index35.cjs.js",
     "name": "utils/batchOnNextTick",
-    "src": "src/utils/batchOnNextTick.ts"
+    "src": "src/utils/batchOnNextTick.ts",
+    "isDynamicEntry": true
   },
   "src/utils/compact.ts": {
-    "file": "index.cjs28.js",
+    "file": "index37.cjs.js",
     "name": "utils/compact",
-    "src": "src/utils/compact.ts"
+    "src": "src/utils/compact.ts",
+    "isDynamicEntry": true
   },
   "src/utils/createSignal.ts": {
-    "file": "index.cjs18.js",
+    "file": "index8.cjs.js",
     "name": "utils/createSignal",
-    "src": "src/utils/createSignal.ts"
+    "src": "src/utils/createSignal.ts",
+    "isDynamicEntry": true
   },
   "src/utils/deepClone.ts": {
-    "file": "index.cjs19.js",
+    "file": "index18.cjs.js",
     "name": "utils/deepClone",
-    "src": "src/utils/deepClone.ts"
+    "src": "src/utils/deepClone.ts",
+    "isDynamicEntry": true
   },
   "src/utils/get.ts": {
-    "file": "index.cjs10.js",
+    "file": "index11.cjs.js",
     "name": "utils/get",
-    "src": "src/utils/get.ts"
+    "src": "src/utils/get.ts",
+    "isDynamicEntry": true
   },
   "src/utils/getMatchingKeys.ts": {
-    "file": "index.cjs26.js",
+    "file": "index14.cjs.js",
     "name": "utils/getMatchingKeys",
     "src": "src/utils/getMatchingKeys.ts",
+    "isDynamicEntry": true,
     "imports": [
       "src/utils/isFieldExpression.ts",
       "src/utils/serializeValue.ts"
     ]
   },
+  "src/utils/idIndexQuery.ts": {
+    "file": "index27.cjs.js",
+    "name": "utils/idIndexQuery",
+    "src": "src/utils/idIndexQuery.ts",
+    "isDynamicEntry": true,
+    "imports": [
+      "src/utils/isFieldExpression.ts"
+    ]
+  },
+  "src/utils/incrementalQueryUpdate.ts": {
+    "file": "index25.cjs.js",
+    "name": "utils/incrementalQueryUpdate",
+    "src": "src/utils/incrementalQueryUpdate.ts",
+    "isDynamicEntry": true,
+    "imports": [
+      "src/utils/match.ts",
+      "src/utils/projectItems.ts",
+      "src/utils/sortItems.ts"
+    ]
+  },
   "src/utils/intersection.ts": {
-    "file": "index.cjs29.js",
+    "file": "index16.cjs.js",
     "name": "utils/intersection",
-    "src": "src/utils/intersection.ts"
+    "src": "src/utils/intersection.ts",
+    "isDynamicEntry": true
   },
   "src/utils/isEqual.ts": {
-    "file": "index.cjs6.js",
+    "file": "index2.cjs.js",
     "name": "utils/isEqual",
-    "src": "src/utils/isEqual.ts"
+    "src": "src/utils/isEqual.ts",
+    "isDynamicEntry": true
   },
   "src/utils/isFieldExpression.ts": {
-    "file": "index.cjs30.js",
+    "file": "index12.cjs.js",
     "name": "utils/isFieldExpression",
-    "src": "src/utils/isFieldExpression.ts"
+    "src": "src/utils/isFieldExpression.ts",
+    "isDynamicEntry": true
   },
   "src/utils/match.ts": {
-    "file": "index.cjs23.js",
+    "file": "index19.cjs.js",
     "name": "utils/match",
-    "src": "src/utils/match.ts"
+    "src": "src/utils/match.ts",
+    "isDynamicEntry": true
   },
   "src/utils/modify.ts": {
-    "file": "index.cjs7.js",
+    "file": "index20.cjs.js",
     "name": "utils/modify",
     "src": "src/utils/modify.ts",
+    "isDynamicEntry": true,
     "imports": [
       "src/utils/deepClone.ts"
     ]
   },
   "src/utils/project.ts": {
-    "file": "index.cjs24.js",
+    "file": "index22.cjs.js",
     "name": "utils/project",
     "src": "src/utils/project.ts",
+    "isDynamicEntry": true,
     "imports": [
       "src/utils/get.ts",
       "src/utils/set.ts"
     ]
   },
+  "src/utils/projectItems.ts": {
+    "file": "index23.cjs.js",
+    "name": "utils/projectItems",
+    "src": "src/utils/projectItems.ts",
+    "isDynamicEntry": true,
+    "imports": [
+      "src/utils/project.ts"
+    ]
+  },
+  "src/utils/queryDelta.ts": {
+    "file": "index4.cjs.js",
+    "name": "utils/queryDelta",
+    "src": "src/utils/queryDelta.ts",
+    "isDynamicEntry": true,
+    "imports": [
+      "src/utils/isEqual.ts"
+    ]
+  },
   "src/utils/queryId.ts": {
-    "file": "index.cjs20.js",
+    "file": "index26.cjs.js",
     "name": "utils/queryId",
-    "src": "src/utils/queryId.ts"
+    "src": "src/utils/queryId.ts",
+    "isDynamicEntry": true
   },
   "src/utils/randomId.ts": {
-    "file": "index.cjs8.js",
+    "file": "index9.cjs.js",
     "name": "utils/randomId",
-    "src": "src/utils/randomId.ts"
+    "src": "src/utils/randomId.ts",
+    "isDynamicEntry": true
+  },
+  "src/utils/reactiveOrAsync.ts": {
+    "file": "index32.cjs.js",
+    "name": "utils/reactiveOrAsync",
+    "src": "src/utils/reactiveOrAsync.ts",
+    "isDynamicEntry": true
   },
   "src/utils/serializeValue.ts": {
-    "file": "index.cjs11.js",
+    "file": "index13.cjs.js",
     "name": "utils/serializeValue",
-    "src": "src/utils/serializeValue.ts"
+    "src": "src/utils/serializeValue.ts",
+    "isDynamicEntry": true
   },
   "src/utils/set.ts": {
-    "file": "index.cjs31.js",
+    "file": "index21.cjs.js",
     "name": "utils/set",
-    "src": "src/utils/set.ts"
+    "src": "src/utils/set.ts",
+    "isDynamicEntry": true
   },
   "src/utils/sortItems.ts": {
-    "file": "index.cjs25.js",
+    "file": "index24.cjs.js",
     "name": "utils/sortItems",
     "src": "src/utils/sortItems.ts",
+    "isDynamicEntry": true,
     "imports": [
       "src/utils/get.ts"
     ]
   },
+  "src/utils/storageIndexQuery.ts": {
+    "file": "index33.cjs.js",
+    "name": "utils/storageIndexQuery",
+    "src": "src/utils/storageIndexQuery.ts",
+    "isDynamicEntry": true,
+    "imports": [
+      "src/utils/getMatchingKeys.ts"
+    ]
+  },
   "src/utils/uniqueBy.ts": {
-    "file": "index.cjs32.js",
+    "file": "index3.cjs.js",
     "name": "utils/uniqueBy",
-    "src": "src/utils/uniqueBy.ts"
+    "src": "src/utils/uniqueBy.ts",
+    "isDynamicEntry": true
   }
 }

package/dist/AsyncDataAdapter.d.ts

@@ -1,8 +1,6 @@
-import type { BaseItem } from './Collection';
-import type Collection from './Collection';
-import type DataAdapter from './DataAdapter';
-import type { CollectionBackend } from './DataAdapter';
-import type StorageAdapter from './types/StorageAdapter';
+import { BaseItem, default as Collection } from './Collection';
+import { default as DataAdapter, CollectionBackend } from './DataAdapter';
+import { default as StorageAdapter } from './types/StorageAdapter';
 export interface AsyncDataAdapterOptions {
     /** Factory to obtain a StorageAdapter per collection name */
     storage: (name: string) => StorageAdapter<any, any>;
@@ -10,6 +8,30 @@ export interface AsyncDataAdapterOptions {
     id?: string;
     /** Optional error hook (mirrors WorkerDataAdapterHost) */
     onError?: (error: Error) => void;
+    /**
+     * How often a failing query is retried before it is published as `'error'`.
+     * A query that fails is otherwise a dead end for the rest of the session —
+     * cursors only requery on `'complete'`, so they keep serving their neutral
+     * empty value, which consumers cannot tell apart from "there is no data".
+     */
+    retry?: {
+        /** Total attempts including the first one. Default 3. */
+        attempts?: number;
+        /** Delay in ms before attempt N+1. Default 100 * 4 ** (attempt - 1). */
+        delay?: (attempt: number) => number;
+    };
+}
+/**
+ * Carries the context needed to act on a failed query. The bare storage error
+ * on its own does not say which collection or selector produced it, which made
+ * the default `console.error` hook close to useless.
+ */
+export declare class QueryError extends Error {
+    readonly collectionName: string;
+    readonly selector: unknown;
+    readonly options: unknown;
+    readonly attempts: number;
+    constructor(collectionName: string, selector: unknown, options: unknown, attempts: number, cause: unknown);
 }
 /**
  * AsyncDataAdapter
@@ -22,6 +44,8 @@ export default class AsyncDataAdapter implements DataAdapter {
     private options;
     private id;
     private onError;
+    private retryAttempts;
+    private retryDelay;
     private storageAdapters;
     private storageAdapterReady;
     private collectionIndices;
@@ -37,22 +61,44 @@ export default class AsyncDataAdapter implements DataAdapter {
      * @param options - query options
      */
     private fulfillQuery;
+    /**
+     * Executes a query, retrying transient failures before giving up. The state
+     * stays `'active'` across retries — consumers should see "still loading",
+     * not "failed", until we actually stop trying. Only the final failure is
+     * published as `'error'` and reported through `onError`; previously that
+     * error was swallowed entirely (`fulfillQuery` caught it internally, so the
+     * `.catch(this.onError)` on its call site was unreachable) and the query
+     * stayed dead for the rest of the session.
+     * @param collectionName - name of the collection
+     * @param selector - query selector
+     * @param options - query options
+     */
+    private runQuery;
     /**
      * Notify listeners about state changes and keep the cache updated
      * @param collectionName - name of the collection
      * @param qid - query id
      * @param state - new state
      * @param error - error if state is 'error', null otherwise
+     * @param delta - what changed about the result, when that is known
      */
     private publishState;
     private publishResult;
+    private queryItemIds;
     private getIndexInfo;
     private queryItems;
     private executeQuery;
     /**
-     * After mutations, recompute and push updates for affected active queries
+     * After mutations, bring every affected active query up to date.
+     *
+     * A query whose previous result is enough to answer the change is brought up to date from that
+     * result alone — no round trip to the storage, and no detour through `'active'`, because there is
+     * no window in which the query is stale. Only a query the change cannot be reasoned about
+     * locally — a window onto a larger set, or one that has never been answered — goes back to the
+     * store, and that one gets the same retry and reporting behaviour a freshly registered query
+     * gets: a refresh that fails silently leaves exactly the same dead cursor.
      * @param collectionName - name of the collection
-     * @param changedItems - items that were inserted/updated/replaced/removed
+     * @param changes - the items the write created, updated or removed
      */
     private checkQueryUpdates;
     private insert;

package/dist/AutoFetchDataAdapter.d.ts

@@ -1,9 +1,7 @@
-import type { BaseItem } from './Collection';
-import type Collection from './Collection';
-import type DataAdapter from './DataAdapter';
-import type { CollectionBackend } from './DataAdapter';
-import type StorageAdapter from './types/StorageAdapter';
-import type Selector from './types/Selector';
+import { BaseItem, default as Collection } from './Collection';
+import { default as DataAdapter, CollectionBackend } from './DataAdapter';
+import { default as StorageAdapter } from './types/StorageAdapter';
+import { default as Selector } from './types/Selector';
 /**
  * AutoFetchDataAdapterOptions
  *

package/dist/Collection/Cursor.d.ts

@@ -1,15 +1,33 @@
-import type ReactivityAdapter from '../types/ReactivityAdapter';
-import type { BaseItem, FindOptions, Transform } from './types';
-import type { ObserveCallbacks } from './Observer';
+import { default as ReactivityAdapter } from '../types/ReactivityAdapter';
+import { QueryDelta } from '../utils/queryDelta';
+import { BaseItem, FindOptions, Transform } from './types';
+import { ObserveCallbacks } from './Observer';
 /**
  * Checks if the current scope is reactive, considering the provided reactivity adapter.
  * @param reactivity - The reactivity adapter or a boolean indicating whether reactivity is enabled.
  * @returns A boolean indicating if the current scope is reactive.
  */
 export declare function isInReactiveScope(reactivity: ReactivityAdapter | undefined | false): boolean;
+/**
+ * Reports whether the query a cursor stands for has produced an outcome yet.
+ * Supplied by the collection, which owns the query registration; a cursor
+ * built without one simply never reports itself as loading.
+ */
+export interface QueryStateAccessor {
+    /**
+     * Whether the query has settled — completed or failed — at least once
+     * since it was registered.
+     */
+    hasSettled: () => boolean;
+    /**
+     * Subscribes to the query settling. Returns a cleanup function.
+     */
+    onSettled: (callback: () => void) => () => void;
+}
 export interface CursorOptions<T extends BaseItem, U = T, Async extends boolean = false> extends FindOptions<T, Async> {
     transform?: Transform<T, U>;
-    bindEvents?: (requery: () => void) => () => void;
+    bindEvents?: (requery: () => void, applyDelta: (delta: QueryDelta<T>) => void) => () => void;
+    queryState?: QueryStateAccessor;
 }
 /**
  * Represents a cursor for querying and observing a filtered, sorted, and transformed
@@ -90,6 +108,31 @@ export default class Cursor<T extends BaseItem, U = T, Async extends boolean = f
      * @returns The total number of items in the result set.
      */
     count(): Async extends true ? Promise<number> : number;
+    /**
+     * Whether this cursor's query has yet to deliver a first result.
+     * ⚡️ this function is reactive!
+     *
+     * An asynchronous data adapter answers a newly registered query only after a
+     * round trip, and serves a neutral empty result until it does — which a
+     * consumer cannot otherwise tell apart from "there is nothing to show". This
+     * is that distinction, per query rather than per collection, so one screen
+     * waiting on its own data says nothing about any other query.
+     *
+     * Follows the usual `isLoading`/`isFetching` split: it reports "no result
+     * yet", not "an execution is in flight". A write that re-runs an
+     * already-settled query drives it through `'active'` again while this stays
+     * `false`, so a list does not fall back to a loading state every time one of
+     * its rows changes.
+     *
+     * A query that fails counts as settled — the `query.error` event on the
+     * collection is what surfaces the failure, and a loading state that never
+     * ends is the worse answer. Reading this registers the query if nothing else
+     * has, so it cannot wait on something nobody asked for. It is always `false`
+     * for an `{ async: true }` cursor, whose `fetch()` awaits the real result
+     * anyway, and for a data adapter that answers synchronously.
+     * @returns A boolean indicating whether the first result is still pending.
+     */
+    isLoading(): boolean;
     /**
      * Observes changes to the cursor's result set and triggers the specified callbacks
      * when items are added, removed, or updated. Supports reactivity and transformation.
@@ -110,4 +153,13 @@ export default class Cursor<T extends BaseItem, U = T, Async extends boolean = f
      * criteria have changed, and you want to ensure the cursor reflects the latest state.
      */
     requery(): void;
+    /**
+     * Brings the cursor up to date from a description of what changed, rather than by re-running the
+     * query and comparing the result with the previous one.
+     *
+     * Falls back to `requery` when the delta does not fit the result the cursor currently holds, so
+     * a caller never has to decide which of the two is safe.
+     * @param delta - The change to apply.
+     */
+    applyDelta(delta: QueryDelta<T>): void;
 }