@signaldb/core 2.0.0-beta.13 → 2.0.0-beta.14

package/dist/index32.mjs

@@ -1,311 +1,479 @@
-import randomId from "./index8.mjs";
-import deepClone from "./index17.mjs";
-import match from "./index18.mjs";
-import modify from "./index19.mjs";
-import queryId from "./index22.mjs";
-import batchOnNextTick from "./index30.mjs";
-import applyQueryOptions from "./index31.mjs";
-//#region src/WorkerDataAdapter.ts
-var WorkerDataAdapter = class {
-	worker;
+import isEqual from "./index2.mjs";
+import { callWithDelta, diffQueryResults, isEmptyQueryDelta } from "./index4.mjs";
+import getMatchingKeys from "./index14.mjs";
+import getIndexInfo from "./index17.mjs";
+import deepClone from "./index18.mjs";
+import match from "./index19.mjs";
+import modify from "./index20.mjs";
+import projectItems from "./index23.mjs";
+import sortItems from "./index24.mjs";
+import incrementalQueryUpdate from "./index25.mjs";
+import queryId from "./index26.mjs";
+//#region src/AsyncDataAdapter.ts
+/**
+* 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.
+*/
+var QueryError = class extends Error {
+	collectionName;
+	selector;
 	options;
-	id;
-	isDisposed = false;
-	workerReady;
-	log = () => {};
-	collectionReady = /* @__PURE__ */ new Map();
-	batchExecutionHelpers = /* @__PURE__ */ new Map();
-	queries = {};
-	pendingWrites = /* @__PURE__ */ new Map();
-	pendingWriteSeq = 0;
-	constructor(worker, options) {
-		this.worker = worker;
+	attempts;
+	constructor(collectionName, selector, options, attempts, cause) {
+		const reason = cause instanceof Error ? cause.message : String(cause);
+		super(`Query on "${collectionName}" failed after ${attempts} attempt(s): ${reason}`);
+		this.name = "QueryError";
+		this.collectionName = collectionName;
+		this.selector = selector;
 		this.options = options;
-		this.id = this.options.id || "default-worker-data-adapter";
-		if (this.options.log) this.log = this.options.log;
-		this.workerReady = new Promise((resolve, reject) => {
-			const timeoutId = setTimeout(() => {
-				reject(/* @__PURE__ */ new Error("WorkerDataAdapter initialization timed out"));
-			}, 5e3);
-			const handleMessage = (event) => {
-				const { type, workerId } = event.data;
-				if (workerId !== this.id) return;
-				if (type === "ready") {
-					resolve();
-					clearTimeout(timeoutId);
-					this.worker.removeEventListener("message", handleMessage);
-				}
-			};
-			this.worker.addEventListener("message", handleMessage);
-		});
+		this.attempts = attempts;
+		this.cause = cause;
 	}
-	async exec(method, collectionName, ...args) {
-		await this.workerReady;
-		if (method !== "isReady") {
-			const collectionReady = this.collectionReady.get(collectionName);
-			if (!collectionReady) throw new Error(`Collection "${collectionName}" is not registered in WorkerDataAdapter`);
-			await collectionReady;
-		}
-		if (this.isDisposed) throw new Error("WorkerDataAdapter is disposed");
-		return new Promise((resolve, reject) => {
-			const messageId = randomId();
-			const handleMessage = (event) => {
-				const { id, workerId, type, data, error } = event.data;
-				if (workerId !== this.id) return;
-				if (type !== "response") return;
-				if (id !== messageId) return;
-				this.log(method, "result", data ?? error);
-				if (error) reject(error);
-				else resolve(data);
-				this.worker.removeEventListener("message", handleMessage);
-			};
-			this.worker.addEventListener("message", handleMessage);
-			this.worker.postMessage({
-				id: messageId,
-				workerId: this.id,
-				method,
-				args: [collectionName, ...args]
-			});
+};
+/**
+* Turns the item states a write produced into the upsert/delete split a query update needs.
+*
+* The two lists are not symmetric: an item that is still there after the write is described by its
+* new state, while an item that is gone — removed, or given a new id — is described by the id it
+* used to have and nothing else. Mixing the states from before and after a write into one list
+* loses exactly that distinction.
+* @template T - The type of the items.
+* @param previousItems - The items as they were before the write.
+* @param modifiedItems - The items as they are after it.
+* @returns The changeset describing the write.
+*/
+function toChangeset(previousItems, modifiedItems) {
+	const modifiedIds = new Set(modifiedItems.map((item) => item.id));
+	return {
+		upserts: modifiedItems,
+		deletes: previousItems.map((item) => item.id).filter((id) => !modifiedIds.has(id))
+	};
+}
+var DEFAULT_RETRY_ATTEMPTS = 3;
+var defaultRetryDelay = (attempt) => 100 * 4 ** (attempt - 1);
+var wait = (ms) => new Promise((resolve) => {
+	setTimeout(resolve, ms);
+});
+/**
+* AsyncDataAdapter
+* Combines WorkerDataAdapter + WorkerDataAdapterHost into a single, transport-free adapter.
+* - Keeps the DataAdapter/CollectionBackend surface identical to the Worker version.
+* - Executes queries and mutations directly against the provided StorageAdapter.
+* - Preserves index-aware query optimization and push-style query updates to listeners.
+*/
+var AsyncDataAdapter = class {
+	options;
+	id;
+	onError;
+	retryAttempts;
+	retryDelay;
+	storageAdapters = /* @__PURE__ */ new Map();
+	storageAdapterReady = /* @__PURE__ */ new Map();
+	collectionIndices = /* @__PURE__ */ new Map();
+	queries = /* @__PURE__ */ new Map();
+	constructor(options) {
+		this.options = options;
+		this.id = options.id || "async-data-adapter";
+		this.onError = options.onError ?? ((error) => {
+			console.error(error);
 		});
+		this.retryAttempts = Math.max(1, options.retry?.attempts ?? DEFAULT_RETRY_ATTEMPTS);
+		this.retryDelay = options.retry?.delay ?? defaultRetryDelay;
 	}
-	observableItems(collectionName) {
-		const byId = /* @__PURE__ */ new Map();
-		this.queries[collectionName]?.forEach((query) => {
-			this.mergePendingWrites(collectionName, query.items).forEach((item) => {
-				byId.set(item.id, item);
+	createCollectionBackend(collection, indices) {
+		this.collectionIndices.set(collection.name, indices);
+		this.queries.set(collection.name, /* @__PURE__ */ new Map());
+		this.ensureStorageAdapter(collection.name);
+		const ready = (async () => {
+			try {
+				await this.setupStorage(collection.name, indices);
+			} catch (error) {
+				this.onError(error);
+				throw error;
+			}
+		})();
+		this.storageAdapterReady.set(collection.name, ready);
+		const registerQuery = (selector, options) => {
+			const qid = queryId(selector, options);
+			const registry = this.queries.get(collection.name);
+			if (!registry) throw new Error(`Collection ${collection.name} not initialized!`);
+			registry.set(qid, {
+				selector,
+				options,
+				items: [],
+				listeners: /* @__PURE__ */ new Set(),
+				...registry.get(qid),
+				state: "active",
+				error: null
 			});
-		});
-		return [...byId.values()];
-	}
-	mergePendingWrites(collectionName, items) {
-		const pending = this.pendingWrites.get(collectionName);
-		if (!pending || pending.size === 0) return items;
-		const merged = new Map(items.map((item) => [item.id, item]));
-		[...pending.entries()].sort(([a], [b]) => a - b).forEach(([, write]) => {
-			write.upserts.forEach((item, id) => merged.set(id, item));
-			write.deletes.forEach((id) => merged.delete(id));
-		});
-		return [...merged.values()];
-	}
-	/**
-	* Registers a write's effect locally and notifies every active query it
-	* touches, then returns a function that drops it again once the write
-	* settles.
-	* @param collectionName - The collection the write targets.
-	* @param upserts - Items inserted or updated by the write.
-	* @param deletes - Ids removed by the write.
-	* @returns A function that drops the pending write and re-notifies.
-	*/
-	applyPendingWrite(collectionName, upserts, deletes) {
-		if (upserts.length === 0 && deletes.length === 0) return () => {};
-		const seq = this.pendingWriteSeq += 1;
-		const pending = this.pendingWrites.get(collectionName) ?? /* @__PURE__ */ new Map();
-		pending.set(seq, {
-			upserts: new Map(upserts.map((item) => [item.id, item])),
-			deletes: new Set(deletes)
-		});
-		this.pendingWrites.set(collectionName, pending);
-		const affectedIds = new Set([...upserts.map((item) => item.id), ...deletes]);
-		this.notifyAffectedQueries(collectionName, upserts, affectedIds);
-		return () => {
-			const current = this.pendingWrites.get(collectionName);
-			if (!current) return;
-			current.delete(seq);
-			if (current.size === 0) this.pendingWrites.delete(collectionName);
-			this.notifyAffectedQueries(collectionName, upserts, affectedIds);
+			this.fulfillQuery(collection.name, selector, options).catch(this.onError);
 		};
-	}
-	notifyAffectedQueries(collectionName, upserts, affectedIds) {
-		this.queries[collectionName]?.forEach((query) => {
-			const wasHolding = query.items.some((item) => affectedIds.has(item.id));
-			const nowMatches = upserts.some((item) => query.selector != null && match(item, query.selector));
-			if (!wasHolding && !nowMatches) return;
-			query.stateChangeCallbacks.forEach((callback) => callback(query.state));
-		});
-	}
-	matchObservableItems(collectionName, selector, onlyFirst) {
-		if (selector == null) return [];
-		const matches = this.observableItems(collectionName).filter((item) => match(item, selector));
-		return onlyFirst ? matches.slice(0, 1) : matches;
-	}
-	resolveUpdate(collectionName, selector, modifier, onlyFirst) {
-		const { $setOnInsert, ...restModifier } = modifier;
-		const upserts = [];
-		const deletes = [];
-		this.matchObservableItems(collectionName, selector, onlyFirst).forEach((item) => {
-			const modifiedItem = modify(deepClone(item), restModifier);
-			upserts.push(modifiedItem);
-			if (modifiedItem.id !== item.id) deletes.push(item.id);
-		});
-		return {
-			upserts,
-			deletes
+		const unregisterQuery = (selector, options) => {
+			const qid = queryId(selector, options);
+			this.queries.get(collection.name)?.delete(qid);
 		};
-	}
-	resolveRemoval(collectionName, selector, onlyFirst) {
-		return this.matchObservableItems(collectionName, selector, onlyFirst).map((item) => item.id);
-	}
-	resolveReplacement(item, replacement) {
-		const modifiedItem = {
-			...replacement,
-			id: replacement.id ?? item.id
+		const getQueryState = (selector, options) => {
+			return (this.queries.get(collection.name)?.get(queryId(selector, options)))?.state ?? "active";
 		};
-		return {
-			upserts: [modifiedItem],
-			deletes: modifiedItem.id === item.id ? [] : [item.id]
+		const getQueryError = (selector, options) => {
+			return (this.queries.get(collection.name)?.get(queryId(selector, options)))?.error ?? null;
 		};
-	}
-	async withPendingWrite(collectionName, delta, run) {
-		const dropPendingWrite = this.applyPendingWrite(collectionName, delta.upserts, delta.deletes);
-		try {
-			return await run();
-		} finally {
-			dropPendingWrite();
-		}
-	}
-	enqueueBatched(collectionName, method, args) {
-		const helper = this.batchExecutionHelpers.get(collectionName);
-		if (!helper) throw new Error(`Collection "${collectionName}" is not registered in WorkerDataAdapter`);
-		return helper.enqueue(method, args);
-	}
-	updateQuery(collectionName, query, update) {
-		const id = queryId(query.selector, query.options);
-		const collectionQueries = this.queries[collectionName];
-		if (!collectionQueries) return;
-		const existing = collectionQueries.get(id);
-		const newState = {
-			selector: query.selector,
-			options: query.options,
-			state: "active",
-			error: null,
-			items: [],
-			stateChangeCallbacks: [],
-			eventHandler: existing?.eventHandler,
-			...existing,
-			...update
+		const getQueryResult = (selector, options) => {
+			return (this.queries.get(collection.name)?.get(queryId(selector, options)))?.items ?? [];
+		};
+		const retryQuery = (selector, options) => {
+			const qid = queryId(selector, options);
+			if (!this.queries.get(collection.name)?.get(qid)) return;
+			this.publishState(collection.name, qid, "active", null);
+			this.runQuery(collection.name, selector, options);
+		};
+		const onQueryStateChange = (selector, options, callback) => {
+			const qid = queryId(selector, options);
+			const registry = this.queries.get(collection.name);
+			if (!registry) throw new Error(`Collection ${collection.name} not initialized!`);
+			if (!registry.has(qid)) registry.set(qid, {
+				selector,
+				options,
+				state: "active",
+				error: null,
+				items: [],
+				listeners: /* @__PURE__ */ new Set()
+			});
+			registry.get(qid)?.listeners.add(callback);
+			if (registry.get(qid)?.state === "error") retryQuery(selector, options);
+			return () => registry.get(qid)?.listeners.delete(callback);
 		};
-		collectionQueries.set(id, newState);
-		this.queries[collectionName] = collectionQueries;
-	}
-	createCollectionBackend(collection, indices) {
-		this.queries[collection.name] = /* @__PURE__ */ new Map();
-		this.exec("registerCollection", collection.name, indices);
-		this.collectionReady.set(collection.name, this.exec("isReady", collection.name));
-		this.batchExecutionHelpers.set(collection.name, batchOnNextTick(async (method, args) => this.exec(method, collection.name, args)));
 		return {
 			insert: async (item) => {
-				return this.withPendingWrite(collection.name, {
-					upserts: [item],
-					deletes: []
-				}, () => this.enqueueBatched(collection.name, "insert", [item]));
+				await ready;
+				return await this.insert(collection.name, item);
 			},
 			updateOne: async (selector, modifier) => {
-				return this.withPendingWrite(collection.name, this.resolveUpdate(collection.name, selector, modifier, true), () => this.enqueueBatched(collection.name, "updateOne", [selector, modifier]));
+				await ready;
+				return this.updateOne(collection.name, selector, modifier);
 			},
 			updateMany: async (selector, modifier) => {
-				return this.withPendingWrite(collection.name, this.resolveUpdate(collection.name, selector, modifier, false), () => this.enqueueBatched(collection.name, "updateMany", [selector, modifier]));
+				await ready;
+				return this.updateMany(collection.name, selector, modifier);
 			},
 			replaceOne: async (selector, replacement) => {
-				const [item] = this.matchObservableItems(collection.name, selector, true);
-				return this.withPendingWrite(collection.name, item == null ? {
-					upserts: [],
-					deletes: []
-				} : this.resolveReplacement(item, replacement), () => this.enqueueBatched(collection.name, "replaceOne", [selector, replacement]));
+				await ready;
+				return this.replaceOne(collection.name, selector, replacement);
 			},
 			removeOne: async (selector) => {
-				return this.withPendingWrite(collection.name, {
-					upserts: [],
-					deletes: this.resolveRemoval(collection.name, selector, true)
-				}, () => this.enqueueBatched(collection.name, "removeOne", [selector]));
+				await ready;
+				return this.removeOne(collection.name, selector);
 			},
 			removeMany: async (selector) => {
-				return this.withPendingWrite(collection.name, {
-					upserts: [],
-					deletes: this.resolveRemoval(collection.name, selector, false)
-				}, () => this.enqueueBatched(collection.name, "removeMany", [selector]));
-			},
-			registerQuery: (selector, options) => {
-				this.updateQuery(collection.name, {
-					selector,
-					options
-				}, {
-					state: "active",
-					error: null,
-					items: []
-				});
-				this.exec("registerQuery", collection.name, selector, options);
-				const handler = (event) => {
-					const { type, data, workerId, error } = event.data;
-					if (type !== "queryUpdate") return;
-					if (data == null) return;
-					const { collectionName, selector: responseSelector, options: responseOptions, state, items } = data;
-					if (workerId !== this.id) return;
-					if (collectionName !== collection.name) return;
-					if (queryId(responseSelector, responseOptions) !== queryId(selector, options)) return;
-					this.log("queryUpdate", responseSelector, responseOptions, state, data ?? error);
-					this.updateQuery(collection.name, {
-						selector: responseSelector,
-						options: responseOptions
-					}, {
-						state,
-						error,
-						items
-					});
-					const query = this.queries[collection.name]?.get(queryId(selector, options));
-					if (!query) return;
-					query.stateChangeCallbacks.forEach((callback) => callback(state));
-				};
-				this.worker.addEventListener("message", handler);
-				this.updateQuery(collection.name, {
-					selector,
-					options
-				}, { eventHandler: handler });
-			},
-			unregisterQuery: (selector, options) => {
-				const qid = queryId(selector, options);
-				const query = this.queries[collection.name]?.get(qid);
-				if (query?.eventHandler) this.worker.removeEventListener("message", query.eventHandler);
-				this.queries[collection.name]?.delete(qid);
-				this.exec("unregisterQuery", collection.name, selector, options);
+				await ready;
+				return this.removeMany(collection.name, selector);
 			},
-			getQueryState: (selector, options) => {
-				return (this.queries[collection.name]?.get(queryId(selector, options)))?.state || "active";
+			registerQuery,
+			unregisterQuery,
+			retryQuery,
+			getQueryState,
+			getQueryError,
+			getQueryResult,
+			onQueryStateChange,
+			executeQuery: async (selector, options) => {
+				await ready;
+				return this.executeQuery(collection.name, selector, options);
 			},
-			getQueryError: (selector, options) => {
-				return (this.queries[collection.name]?.get(queryId(selector, options)))?.error || null;
-			},
-			getQueryResult: (selector, options) => {
-				const query = this.queries[collection.name]?.get(queryId(selector, options));
-				if (!query) return [];
-				const pending = this.pendingWrites.get(collection.name);
-				if (!pending || pending.size === 0) return query.items;
-				return applyQueryOptions(this.mergePendingWrites(collection.name, query.items), selector, options);
-			},
-			onQueryStateChange: (selector, options, callback) => {
-				this.updateQuery(collection.name, {
-					selector,
-					options
-				}, { stateChangeCallbacks: [...this.queries[collection.name]?.get(queryId(selector, options))?.stateChangeCallbacks || [], callback] });
-				return () => {
-					const currentCallbacks = this.queries[collection.name]?.get(queryId(selector, options))?.stateChangeCallbacks;
-					if (!currentCallbacks) return;
-					this.updateQuery(collection.name, {
-						selector,
-						options
-					}, { stateChangeCallbacks: currentCallbacks.filter((existingCallback) => existingCallback !== callback) });
-				};
-			},
-			executeQuery: (selector, options) => this.exec("executeQuery", collection.name, selector, options),
 			dispose: async () => {
-				await this.exec("unregisterCollection", collection.name);
-				this.isDisposed = true;
-				this.worker.terminate?.();
+				this.storageAdapters.delete(collection.name);
+				this.queries.delete(collection.name);
+				this.collectionIndices.delete(collection.name);
+				this.storageAdapterReady.delete(collection.name);
 			},
 			isReady: async () => {
-				await this.exec("isReady", collection.name);
+				await ready;
 			}
 		};
 	}
+	async setupStorage(collectionName, indices) {
+		const storage = this.storageAdapters.get(collectionName);
+		if (!storage) throw new Error(`No persistence adapter for collection ${collectionName}`);
+		await storage.setup();
+		await Promise.all(indices.map((index) => storage.createIndex(index)));
+	}
+	ensureStorageAdapter(name) {
+		if (this.storageAdapters.has(name)) return;
+		const adapter = this.options.storage(name);
+		if (!adapter) return;
+		this.storageAdapters.set(name, adapter);
+	}
+	/**
+	* Compute and publish the result for a specific query
+	* @param collectionName - name of the collection
+	* @param selector - query selector
+	* @param options - query options
+	*/
+	async fulfillQuery(collectionName, selector, options) {
+		const qid = queryId(selector, options);
+		const registry = this.queries.get(collectionName);
+		if (!registry) throw new Error(`Collection ${collectionName} not initialized!`);
+		if (!registry.get(qid)) return;
+		this.publishState(collectionName, qid, "active", null);
+		await this.runQuery(collectionName, selector, options);
+	}
+	/**
+	* 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
+	*/
+	async runQuery(collectionName, selector, options) {
+		const qid = queryId(selector, options);
+		let lastError;
+		for (let attempt = 1; attempt <= this.retryAttempts; attempt += 1) {
+			if (!this.queries.get(collectionName)?.has(qid)) return;
+			try {
+				const items = await this.executeQuery(collectionName, selector, options);
+				const rec = this.queries.get(collectionName)?.get(qid);
+				const delta = rec?.answered ? diffQueryResults(rec.items, items) : void 0;
+				this.publishResult(collectionName, qid, items);
+				this.publishState(collectionName, qid, "complete", null, delta);
+				return;
+			} catch (error) {
+				lastError = error;
+				if (attempt < this.retryAttempts) await wait(this.retryDelay(attempt));
+			}
+		}
+		const queryError = new QueryError(collectionName, selector, options, this.retryAttempts, lastError);
+		this.publishState(collectionName, qid, "error", queryError);
+		this.onError(queryError);
+	}
+	/**
+	* 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
+	*/
+	publishState(collectionName, qid, state, error, delta) {
+		const rec = this.queries.get(collectionName)?.get(qid);
+		if (!rec) return;
+		rec.state = state;
+		rec.error = error;
+		const subscribers = [...rec.listeners];
+		for (const callback of subscribers) try {
+			callWithDelta(callback, state, delta);
+		} catch (error_) {
+			this.onError(error_);
+		}
+	}
+	publishResult(collectionName, qid, items) {
+		const rec = this.queries.get(collectionName)?.get(qid);
+		if (!rec) return;
+		rec.items = items;
+		rec.itemIds = void 0;
+		rec.answered = true;
+	}
+	queryItemIds(rec) {
+		if (!rec.itemIds) rec.itemIds = new Set(rec.items.map((item) => item.id));
+		return rec.itemIds;
+	}
+	async getIndexInfo(collectionName, selector) {
+		const storageAdapter = this.storageAdapters.get(collectionName);
+		if (!storageAdapter) throw new Error(`No persistence adapter for collection ${collectionName}`);
+		if (selector != null && Object.keys(selector).length === 1 && "id" in selector && typeof selector.id !== "object") return {
+			matched: true,
+			ids: [selector.id].filter(Boolean),
+			optimizedSelector: {}
+		};
+		if (selector == null) return {
+			matched: false,
+			ids: [],
+			optimizedSelector: {}
+		};
+		return getIndexInfo((this.collectionIndices.get(collectionName) ?? []).map((field) => async (flatSelector) => {
+			if (!Object.hasOwnProperty.call(flatSelector, field)) return { matched: false };
+			const index = await storageAdapter.readIndex(field);
+			const fieldSelector = flatSelector[field];
+			const filtersForNull = fieldSelector == null || fieldSelector.$exists === false;
+			const keys = filtersForNull ? {
+				include: null,
+				exclude: [...index.keys()].filter((key) => key != null)
+			} : getMatchingKeys(field, flatSelector);
+			if (keys.include == null && keys.exclude == null) return { matched: false };
+			let includedIds = [];
+			if (keys.include == null) for (const set of index.values()) for (const pos of set) includedIds.push(pos);
+			else for (const key of keys.include) {
+				const idSet = index.get(key);
+				if (idSet) for (const id of idSet) includedIds.push(id);
+			}
+			if (keys.exclude != null) {
+				const excludeIds = /* @__PURE__ */ new Set();
+				for (const key of keys.exclude) {
+					const idSet = index.get(key);
+					if (idSet) for (const id of idSet) excludeIds.add(id);
+				}
+				includedIds = includedIds.filter((pos) => !excludeIds.has(pos));
+			}
+			return {
+				matched: true,
+				ids: includedIds,
+				fields: [field],
+				keepSelector: filtersForNull
+			};
+		}), selector);
+	}
+	async queryItems(collectionName, selector) {
+		const storage = this.storageAdapters.get(collectionName);
+		if (!storage) throw new Error(`No persistence adapter for collection ${collectionName}`);
+		const index = await this.getIndexInfo(collectionName, selector);
+		const matchItems = (item) => {
+			if (index.optimizedSelector == null) return true;
+			if (Object.keys(index.optimizedSelector).length <= 0) return true;
+			return match(item, index.optimizedSelector);
+		};
+		if (index.matched) {
+			const items = await storage.readIds(index.ids);
+			if (isEqual(index.optimizedSelector, {})) return items;
+			return items.filter(matchItems);
+		} else {
+			const allItems = await storage.readAll();
+			if (isEqual(selector, {})) return allItems;
+			return allItems.filter(matchItems);
+		}
+	}
+	async executeQuery(collectionName, selector, options) {
+		const items = await this.queryItems(collectionName, selector || {});
+		const { sort, skip, limit, fields } = options || {};
+		const sorted = sort ? sortItems(items, sort) : items;
+		const skipped = skip ? sorted.slice(skip) : sorted;
+		return projectItems(limit ? skipped.slice(0, limit) : skipped, fields);
+	}
+	/**
+	* 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 changes - the items the write created, updated or removed
+	*/
+	async checkQueryUpdates(collectionName, changes) {
+		const registry = this.queries.get(collectionName);
+		if (!registry) throw new Error(`Collection ${collectionName} not initialized!`);
+		if (registry.size === 0) return;
+		if (changes.upserts.length === 0 && changes.deletes.length === 0) return;
+		const affected = [...registry.values()].filter((rec) => {
+			const ids = this.queryItemIds(rec);
+			if (changes.deletes.some((id) => ids.has(id))) return true;
+			return changes.upserts.some((item) => ids.has(item.id) || match(item, rec.selector));
+		});
+		if (affected.length === 0) return;
+		const needsReExecution = [];
+		for (const rec of affected) {
+			const { selector, options } = rec;
+			const incremental = rec.answered ? incrementalQueryUpdate(rec.items, selector, options, changes) : null;
+			if (incremental == null) {
+				needsReExecution.push(rec);
+				continue;
+			}
+			const qid = queryId(selector, options);
+			const delta = diffQueryResults(rec.items, incremental);
+			if (isEmptyQueryDelta(delta)) continue;
+			this.publishResult(collectionName, qid, incremental);
+			this.publishState(collectionName, qid, "complete", null, delta);
+		}
+		for (const { selector, options } of needsReExecution) this.publishState(collectionName, queryId(selector, options), "active", null);
+		await Promise.all(needsReExecution.map(({ selector, options }) => this.runQuery(collectionName, selector, options)));
+	}
+	async insert(collectionName, newItem) {
+		const storage = this.storageAdapters.get(collectionName);
+		if (!storage) throw new Error(`No persistence adapter for collection ${collectionName}`);
+		if ((await storage.readIds([newItem.id])).length > 0) throw new Error(`Item with id ${String(newItem.id)} already exists`);
+		await storage.insert([newItem]);
+		await this.checkQueryUpdates(collectionName, {
+			upserts: [newItem],
+			deletes: []
+		});
+		return newItem;
+	}
+	async updateOne(collectionName, selector, modifier) {
+		const storage = this.storageAdapters.get(collectionName);
+		if (!storage) throw new Error(`No persistence adapter for collection ${collectionName}`);
+		const [item] = await this.executeQuery(collectionName, selector, { limit: 1 });
+		const { $setOnInsert, ...rest } = modifier;
+		if (item == null) return [];
+		const modified = modify(deepClone(item), rest);
+		if (item.id !== modified.id) {
+			if ((await storage.readIds([modified.id])).length > 0) throw new Error(`Item with id ${String(modified.id)} already exists`);
+		}
+		await storage.replace([modified]);
+		await this.checkQueryUpdates(collectionName, toChangeset([item], [modified]));
+		return [modified];
+	}
+	async updateMany(collectionName, selector, modifier) {
+		const storage = this.storageAdapters.get(collectionName);
+		if (!storage) throw new Error(`No persistence adapter for collection ${collectionName}`);
+		const items = await this.executeQuery(collectionName, selector);
+		if (items.length === 0) return [];
+		const { $setOnInsert, ...rest } = modifier;
+		const changed = await Promise.all(items.map(async (item) => {
+			const modified = modify(deepClone(item), rest);
+			if (item.id !== modified.id) {
+				if ((await storage.readIds([modified.id])).length > 0) throw new Error(`Item with id ${String(modified.id)} already exists`);
+			}
+			return modified;
+		}));
+		await storage.replace(changed);
+		await this.checkQueryUpdates(collectionName, toChangeset(items, changed));
+		return changed;
+	}
+	async replaceOne(collectionName, selector, replacement) {
+		const storage = this.storageAdapters.get(collectionName);
+		if (!storage) throw new Error(`No persistence adapter for collection ${collectionName}`);
+		const [item] = await this.executeQuery(collectionName, selector, { limit: 1 });
+		if (item == null) return [];
+		const modified = {
+			...replacement,
+			id: replacement.id ?? item.id
+		};
+		if (item.id !== modified.id) {
+			if ((await storage.readIds([modified.id])).length > 0) throw new Error(`Item with id ${String(modified.id)} already exists`);
+		}
+		await storage.replace([modified]);
+		await this.checkQueryUpdates(collectionName, toChangeset([item], [modified]));
+		return [modified];
+	}
+	async removeOne(collectionName, selector) {
+		const storage = this.storageAdapters.get(collectionName);
+		if (!storage) throw new Error(`No persistence adapter for collection ${collectionName}`);
+		const [item] = await this.executeQuery(collectionName, selector, { limit: 1 });
+		if (item == null) return [];
+		await storage.remove([item]);
+		await this.checkQueryUpdates(collectionName, {
+			upserts: [],
+			deletes: [item.id]
+		});
+		return [item];
+	}
+	async removeMany(collectionName, selector) {
+		const storage = this.storageAdapters.get(collectionName);
+		if (!storage) throw new Error(`No persistence adapter for collection ${collectionName}`);
+		const items = await this.executeQuery(collectionName, selector);
+		if (items.length === 0) return [];
+		await storage.remove(items);
+		await this.checkQueryUpdates(collectionName, {
+			upserts: [],
+			deletes: items.map((item) => item.id)
+		});
+		return items;
+	}
 };
 //#endregion
-export { WorkerDataAdapter as default };
+export { AsyncDataAdapter as default };