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

package/dist/index28.cjs.js

@@ -56,7 +56,7 @@ var DefaultDataAdapter = class {
 			await this.fetchItemsFromStorage(collection);
 		}).catch((error) => {
 			if (!this.options.onError) {
-				console.error(`Error during data persistence operation in collection ${collection.name}`, error);
+				console.error(`Error during storage operation in collection ${collection.name}`, error);
 				return;
 			}
 			this.options.onError(collection.name, error instanceof Error ? error : new Error(error));
@@ -112,7 +112,8 @@ var DefaultDataAdapter = class {
 		const { sort, skip, limit, fields } = options || {};
 		const sorted = sort ? require_sortItems.default(items, sort) : items;
 		const skipped = skip ? sorted.slice(skip) : sorted;
-		return require_projectItems.default(limit ? skipped.slice(0, limit) : skipped, fields);
+		const limited = limit ? skipped.slice(0, limit) : skipped;
+		return require_projectItems.default(limited, fields);
 	}
 	flushQueuedQueryUpdates(collection) {
 		if (!this.queuedQueryUpdates.get(collection.name)) return;
@@ -204,7 +205,10 @@ var DefaultDataAdapter = class {
 					modified: [modifiedItem],
 					removed: []
 				});
-				return [modifiedItem];
+				return {
+					items: [modifiedItem],
+					previousItems: [item]
+				};
 			},
 			updateMany: async (selector, modifier) => {
 				const { $setOnInsert, ...restModifier } = modifier;
@@ -228,7 +232,10 @@ var DefaultDataAdapter = class {
 					modified: changedItems,
 					removed: []
 				});
-				return changedItems;
+				return {
+					items: changedItems,
+					previousItems: items
+				};
 			},
 			replaceOne: async (selector, replacement) => {
 				const item = this.getItem(collection, selector);
@@ -249,7 +256,10 @@ var DefaultDataAdapter = class {
 					modified: [modifiedItem],
 					removed: []
 				});
-				return [modifiedItem];
+				return {
+					items: [modifiedItem],
+					previousItems: [item]
+				};
 			},
 			removeOne: async (selector) => {
 				const item = this.getItem(collection, selector);

package/dist/index28.mjs

@@ -56,7 +56,7 @@ var DefaultDataAdapter = class {
 			await this.fetchItemsFromStorage(collection);
 		}).catch((error) => {
 			if (!this.options.onError) {
-				console.error(`Error during data persistence operation in collection ${collection.name}`, error);
+				console.error(`Error during storage operation in collection ${collection.name}`, error);
 				return;
 			}
 			this.options.onError(collection.name, error instanceof Error ? error : new Error(error));
@@ -112,7 +112,8 @@ var DefaultDataAdapter = class {
 		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);
+		const limited = limit ? skipped.slice(0, limit) : skipped;
+		return projectItems(limited, fields);
 	}
 	flushQueuedQueryUpdates(collection) {
 		if (!this.queuedQueryUpdates.get(collection.name)) return;
@@ -204,7 +205,10 @@ var DefaultDataAdapter = class {
 					modified: [modifiedItem],
 					removed: []
 				});
-				return [modifiedItem];
+				return {
+					items: [modifiedItem],
+					previousItems: [item]
+				};
 			},
 			updateMany: async (selector, modifier) => {
 				const { $setOnInsert, ...restModifier } = modifier;
@@ -228,7 +232,10 @@ var DefaultDataAdapter = class {
 					modified: changedItems,
 					removed: []
 				});
-				return changedItems;
+				return {
+					items: changedItems,
+					previousItems: items
+				};
 			},
 			replaceOne: async (selector, replacement) => {
 				const item = this.getItem(collection, selector);
@@ -249,7 +256,10 @@ var DefaultDataAdapter = class {
 					modified: [modifiedItem],
 					removed: []
 				});
-				return [modifiedItem];
+				return {
+					items: [modifiedItem],
+					previousItems: [item]
+				};
 			},
 			removeOne: async (selector) => {
 				const item = this.getItem(collection, selector);

package/dist/index29.cjs.js

@@ -9,6 +9,20 @@ const require_queryId = require("./index26.cjs.js");
 const require_DefaultDataAdapter = require("./index28.cjs.js");
 //#region src/Collection/index.ts
 /**
+* Splits what a backend returned from a write into the changed items and their previous state.
+* @param result - What the backend's write method returned.
+* @returns The changed items, and what each of them was before the write. An adapter that cannot
+* report the previous state yields an empty list, and the `'changed'` event omits its third
+* argument.
+*/
+function splitWriteResult(result) {
+	if (Array.isArray(result)) return {
+		items: result,
+		previousItems: []
+	};
+	return result;
+}
+/**
 * Represents a collection of data items with support for in-memory operations,
 * persistence, reactivity, and event-based notifications. The collection provides
 * CRUD operations, observer patterns, and batch operations.
@@ -153,7 +167,7 @@ var Collection = class Collection extends require_EventEmitter.default {
 	/**
 	* Checks whether the collection is currently performing a pull operation
 	* ⚡️ this function is reactive!
-	* (loading data from the persistence adapter).
+	* (loading data from storage).
 	* @returns A boolean indicating if the collection is in the process of pulling data.
 	*/
 	isPulling() {
@@ -162,7 +176,7 @@ var Collection = class Collection extends require_EventEmitter.default {
 	/**
 	* Checks whether the collection is currently performing a push operation
 	* ⚡️ this function is reactive!
-	* (saving data to the persistence adapter).
+	* (saving data to storage).
 	* @returns A boolean indicating if the collection is in the process of pushing data.
 	*/
 	isPushing() {
@@ -202,17 +216,16 @@ var Collection = class Collection extends require_EventEmitter.default {
 		this.fieldTracking = enable;
 	}
 	/**
-	* Resolves when the persistence adapter finished initializing
+	* Resolves when the storage adapter finished initializing
 	* and the collection is ready to be used.
 	* @returns A promise that resolves when the collection is ready.
 	* @example
 	* ```ts
-	* const collection = new Collection({
-	*   persistence: // ...
-	* })
-	* await collection.isReady()
+	* const collection = new Collection('items', dataAdapter)
+	* await collection.ready()
 	*
-	* collection.insert({ name: 'Item 1' })
+	* await collection.insert({ name: 'Item 1' })
+	* ```
 	*/
 	async ready() {
 		return this.backend.isReady();
@@ -281,7 +294,7 @@ var Collection = class Collection extends require_EventEmitter.default {
 		return this.queryListenersMap.get(id) ?? 0;
 	}
 	/**
-	* Disposes the collection, unregisters persistence adapters, clears memory, and
+	* Disposes the collection, unregisters storage adapters, clears memory, and
 	* cleans up all resources used by the collection.
 	* @returns A promise that resolves when the collection is disposed.
 	*/
@@ -480,7 +493,7 @@ var Collection = class Collection extends require_EventEmitter.default {
 			const item = await this.getItem(selector, { async: true });
 			if (item != null) this.emit("validate", require_modify.default(require_deepClone.default(item), restModifier));
 		}
-		const changes = await this.withPushState(() => this.backend.updateOne(selector, modifier));
+		const { items: changes, previousItems } = splitWriteResult(await this.withPushState(() => this.backend.updateOne(selector, modifier)));
 		if (changes.length === 0) {
 			if (!options?.upsert) return 0;
 			const newItem = require_modify.default({}, {
@@ -493,7 +506,7 @@ var Collection = class Collection extends require_EventEmitter.default {
 			await this.insert(newItem);
 			return 1;
 		}
-		changes.forEach((item) => this.emit("changed", item, restModifier));
+		changes.forEach((item, index) => this.emit("changed", item, restModifier, previousItems[index]));
 		this.emit("updateOne", selector, modifier);
 		this.executeInDebugMode((callstack) => this.emit("_debug.updateOne", callstack, selector, modifier));
 		return changes.length;
@@ -515,7 +528,7 @@ var Collection = class Collection extends require_EventEmitter.default {
 		if (this.listenerCount("validate") > 0) (await this.getItems(selector, { async: true })).forEach((item) => {
 			this.emit("validate", require_modify.default(require_deepClone.default(item), restModifier));
 		});
-		const changes = await this.withPushState(() => this.backend.updateMany(selector, modifier));
+		const { items: changes, previousItems } = splitWriteResult(await this.withPushState(() => this.backend.updateMany(selector, modifier)));
 		if (changes.length === 0) {
 			if (!options?.upsert) return 0;
 			const newItem = require_modify.default({}, {
@@ -528,8 +541,8 @@ var Collection = class Collection extends require_EventEmitter.default {
 			await this.insert(newItem);
 			return 1;
 		}
-		changes.forEach((item) => {
-			this.emit("changed", item, restModifier);
+		changes.forEach((item, index) => {
+			this.emit("changed", item, restModifier, previousItems[index]);
 		});
 		this.emit("updateMany", selector, modifier);
 		this.executeInDebugMode((callstack) => this.emit("_debug.updateMany", callstack, selector, modifier));
@@ -554,13 +567,13 @@ var Collection = class Collection extends require_EventEmitter.default {
 				...replacement
 			});
 		}
-		const changes = await this.withPushState(() => this.backend.replaceOne(selector, replacement));
+		const { items: changes, previousItems } = splitWriteResult(await this.withPushState(() => this.backend.replaceOne(selector, replacement)));
 		if (changes.length === 0) {
 			if (!options?.upsert) return 0;
 			await this.insert(replacement);
 			return 1;
 		}
-		changes.forEach((item) => this.emit("changed", item, replacement));
+		changes.forEach((item, index) => this.emit("changed", item, replacement, previousItems[index]));
 		this.emit("replaceOne", selector, replacement);
 		this.executeInDebugMode((callstack) => this.emit("_debug.replaceOne", callstack, selector, replacement));
 		return changes.length;

package/dist/index29.mjs

@@ -9,6 +9,20 @@ import queryId from "./index26.mjs";
 import DefaultDataAdapter from "./index28.mjs";
 //#region src/Collection/index.ts
 /**
+* Splits what a backend returned from a write into the changed items and their previous state.
+* @param result - What the backend's write method returned.
+* @returns The changed items, and what each of them was before the write. An adapter that cannot
+* report the previous state yields an empty list, and the `'changed'` event omits its third
+* argument.
+*/
+function splitWriteResult(result) {
+	if (Array.isArray(result)) return {
+		items: result,
+		previousItems: []
+	};
+	return result;
+}
+/**
 * Represents a collection of data items with support for in-memory operations,
 * persistence, reactivity, and event-based notifications. The collection provides
 * CRUD operations, observer patterns, and batch operations.
@@ -153,7 +167,7 @@ var Collection = class Collection extends EventEmitter {
 	/**
 	* Checks whether the collection is currently performing a pull operation
 	* ⚡️ this function is reactive!
-	* (loading data from the persistence adapter).
+	* (loading data from storage).
 	* @returns A boolean indicating if the collection is in the process of pulling data.
 	*/
 	isPulling() {
@@ -162,7 +176,7 @@ var Collection = class Collection extends EventEmitter {
 	/**
 	* Checks whether the collection is currently performing a push operation
 	* ⚡️ this function is reactive!
-	* (saving data to the persistence adapter).
+	* (saving data to storage).
 	* @returns A boolean indicating if the collection is in the process of pushing data.
 	*/
 	isPushing() {
@@ -202,17 +216,16 @@ var Collection = class Collection extends EventEmitter {
 		this.fieldTracking = enable;
 	}
 	/**
-	* Resolves when the persistence adapter finished initializing
+	* Resolves when the storage adapter finished initializing
 	* and the collection is ready to be used.
 	* @returns A promise that resolves when the collection is ready.
 	* @example
 	* ```ts
-	* const collection = new Collection({
-	*   persistence: // ...
-	* })
-	* await collection.isReady()
+	* const collection = new Collection('items', dataAdapter)
+	* await collection.ready()
 	*
-	* collection.insert({ name: 'Item 1' })
+	* await collection.insert({ name: 'Item 1' })
+	* ```
 	*/
 	async ready() {
 		return this.backend.isReady();
@@ -281,7 +294,7 @@ var Collection = class Collection extends EventEmitter {
 		return this.queryListenersMap.get(id) ?? 0;
 	}
 	/**
-	* Disposes the collection, unregisters persistence adapters, clears memory, and
+	* Disposes the collection, unregisters storage adapters, clears memory, and
 	* cleans up all resources used by the collection.
 	* @returns A promise that resolves when the collection is disposed.
 	*/
@@ -480,7 +493,7 @@ var Collection = class Collection extends EventEmitter {
 			const item = await this.getItem(selector, { async: true });
 			if (item != null) this.emit("validate", modify(deepClone(item), restModifier));
 		}
-		const changes = await this.withPushState(() => this.backend.updateOne(selector, modifier));
+		const { items: changes, previousItems } = splitWriteResult(await this.withPushState(() => this.backend.updateOne(selector, modifier)));
 		if (changes.length === 0) {
 			if (!options?.upsert) return 0;
 			const newItem = modify({}, {
@@ -493,7 +506,7 @@ var Collection = class Collection extends EventEmitter {
 			await this.insert(newItem);
 			return 1;
 		}
-		changes.forEach((item) => this.emit("changed", item, restModifier));
+		changes.forEach((item, index) => this.emit("changed", item, restModifier, previousItems[index]));
 		this.emit("updateOne", selector, modifier);
 		this.executeInDebugMode((callstack) => this.emit("_debug.updateOne", callstack, selector, modifier));
 		return changes.length;
@@ -515,7 +528,7 @@ var Collection = class Collection extends EventEmitter {
 		if (this.listenerCount("validate") > 0) (await this.getItems(selector, { async: true })).forEach((item) => {
 			this.emit("validate", modify(deepClone(item), restModifier));
 		});
-		const changes = await this.withPushState(() => this.backend.updateMany(selector, modifier));
+		const { items: changes, previousItems } = splitWriteResult(await this.withPushState(() => this.backend.updateMany(selector, modifier)));
 		if (changes.length === 0) {
 			if (!options?.upsert) return 0;
 			const newItem = modify({}, {
@@ -528,8 +541,8 @@ var Collection = class Collection extends EventEmitter {
 			await this.insert(newItem);
 			return 1;
 		}
-		changes.forEach((item) => {
-			this.emit("changed", item, restModifier);
+		changes.forEach((item, index) => {
+			this.emit("changed", item, restModifier, previousItems[index]);
 		});
 		this.emit("updateMany", selector, modifier);
 		this.executeInDebugMode((callstack) => this.emit("_debug.updateMany", callstack, selector, modifier));
@@ -554,13 +567,13 @@ var Collection = class Collection extends EventEmitter {
 				...replacement
 			});
 		}
-		const changes = await this.withPushState(() => this.backend.replaceOne(selector, replacement));
+		const { items: changes, previousItems } = splitWriteResult(await this.withPushState(() => this.backend.replaceOne(selector, replacement)));
 		if (changes.length === 0) {
 			if (!options?.upsert) return 0;
 			await this.insert(replacement);
 			return 1;
 		}
-		changes.forEach((item) => this.emit("changed", item, replacement));
+		changes.forEach((item, index) => this.emit("changed", item, replacement, previousItems[index]));
 		this.emit("replaceOne", selector, replacement);
 		this.executeInDebugMode((callstack) => this.emit("_debug.replaceOne", callstack, selector, replacement));
 		return changes.length;

package/dist/index33.cjs.js

@@ -1,53 +1,21 @@
-const require_getMatchingKeys = require("./index14.cjs.js");
-//#region src/utils/storageIndexQuery.ts
+//#region src/utils/compact.ts
 /**
-* Builds the index provider a data adapter uses to narrow a selector down through
-* a storage adapter's index.
-*
-* Every adapter that keeps its data in a `StorageAdapter` needs exactly this, and
-* each of them used to carry its own copy — three transcriptions of one set of
-* rules about null, `$exists`, inclusion and exclusion, which is how they drift
-* apart without anyone noticing. The index is keyed by `serializeValue(value)`,
-* which is what `getMatchingKeys` produces, so the two only agree while they stay
-* in one place.
-* @template T - The type of the items in the collection.
-* @template I - The type of the unique identifier for the items.
-* @param storage - The storage adapter holding the index.
-* @param field - The indexed field this provider answers for.
-* @returns A query function for `getIndexInfo`.
+* Checks if a value is truthy.
+* @template T - The type of the value.
+* @param value - The value to check.
+* @returns A boolean indicating if the value is truthy.
 */
-function storageIndexQuery(storage, field) {
-	return async (flatSelector) => {
-		if (!Object.hasOwnProperty.call(flatSelector, field)) return { matched: false };
-		const index = await storage.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)
-		} : require_getMatchingKeys.default(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 id of set) includedIds.push(id);
-		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 excludedIds = /* @__PURE__ */ new Set();
-			for (const key of keys.exclude) {
-				const idSet = index.get(key);
-				if (idSet) for (const id of idSet) excludedIds.add(id);
-			}
-			includedIds = includedIds.filter((id) => !excludedIds.has(id));
-		}
-		return {
-			matched: true,
-			ids: includedIds,
-			fields: [field],
-			keepSelector: filtersForNull
-		};
-	};
+function truthy(value) {
+	return !!value;
+}
+/**
+* Filters out falsy values (`false`, `''`, `0`, `null`, `undefined`) from an array.
+* @template T - The type of the elements in the array.
+* @param array - The array to filter.
+* @returns A new array containing only the truthy values from the input array.
+*/
+function compact(array) {
+	return array.filter(truthy);
 }
 //#endregion
-exports.default = storageIndexQuery;
+exports.default = compact;

package/dist/index33.mjs

@@ -1,53 +1,21 @@
-import getMatchingKeys from "./index14.mjs";
-//#region src/utils/storageIndexQuery.ts
+//#region src/utils/compact.ts
 /**
-* Builds the index provider a data adapter uses to narrow a selector down through
-* a storage adapter's index.
-*
-* Every adapter that keeps its data in a `StorageAdapter` needs exactly this, and
-* each of them used to carry its own copy — three transcriptions of one set of
-* rules about null, `$exists`, inclusion and exclusion, which is how they drift
-* apart without anyone noticing. The index is keyed by `serializeValue(value)`,
-* which is what `getMatchingKeys` produces, so the two only agree while they stay
-* in one place.
-* @template T - The type of the items in the collection.
-* @template I - The type of the unique identifier for the items.
-* @param storage - The storage adapter holding the index.
-* @param field - The indexed field this provider answers for.
-* @returns A query function for `getIndexInfo`.
+* Checks if a value is truthy.
+* @template T - The type of the value.
+* @param value - The value to check.
+* @returns A boolean indicating if the value is truthy.
 */
-function storageIndexQuery(storage, field) {
-	return async (flatSelector) => {
-		if (!Object.hasOwnProperty.call(flatSelector, field)) return { matched: false };
-		const index = await storage.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 id of set) includedIds.push(id);
-		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 excludedIds = /* @__PURE__ */ new Set();
-			for (const key of keys.exclude) {
-				const idSet = index.get(key);
-				if (idSet) for (const id of idSet) excludedIds.add(id);
-			}
-			includedIds = includedIds.filter((id) => !excludedIds.has(id));
-		}
-		return {
-			matched: true,
-			ids: includedIds,
-			fields: [field],
-			keepSelector: filtersForNull
-		};
-	};
+function truthy(value) {
+	return !!value;
+}
+/**
+* Filters out falsy values (`false`, `''`, `0`, `null`, `undefined`) from an array.
+* @template T - The type of the elements in the array.
+* @param array - The array to filter.
+* @returns A new array containing only the truthy values from the input array.
+*/
+function compact(array) {
+	return array.filter(truthy);
 }
 //#endregion
-export { storageIndexQuery as default };
+export { compact as default };