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

package/dist/index20.mjs

@@ -1,37 +1,23 @@
-//#region src/utils/set.ts
+import deepClone from "./index18.mjs";
+import { update } from "mingo";
+//#region src/utils/modify.ts
 /**
-* Sets a value at a specified path within an object. Creates nested structures
-* (arrays or objects) as needed to set the value at the correct location. Supports
-* deleting the key if the value is `undefined` and the `deleteIfUndefined` flag is set to `true`.
-* @template T - The type of the object to modify.
-* @template K - The type of the value to set.
-* @param object - The object to modify. The object is mutated directly.
-* @param path - The path (dot or bracket notation) where the value should be set.
-* @param value - The value to set at the specified path.
-* @param deleteIfUndefined - A boolean indicating whether to delete the key if the value is `undefined` (default: `false`).
-* @returns The modified object.
+* Applies a modifier to an object and returns a new modified object.
+* @template T - The type of the object to be modified.
+* @param item - The object to be modified.
+* @param modifier - The modifier to apply. This can be any transformation logic.
+* @returns - Returns a new object with the modifications applied.
+* @example
+* const item = { a: 1, b: 2 }
+* const modifier = { $set: { b: 3, c: 4 } }
+* const result = modify(item, modifier)
+* // result: { a: 1, b: 3, c: 4 }
 */
-function set(object, path, value, deleteIfUndefined = false) {
-	if (object == null) return object;
-	const segments = path.split(/[.[\]]/g);
-	if (segments[0] === "") segments.shift();
-	if (segments.at(-1) === "") segments.pop();
-	const apply = (node) => {
-		if (segments.length > 1) {
-			const key = segments.shift();
-			const nextIsNumber = !Number.isNaN(Number.parseInt(segments[0], 10));
-			if (node[key] === void 0) node[key] = nextIsNumber ? [] : {};
-			apply(node[key]);
-		} else {
-			if (deleteIfUndefined && value === void 0) {
-				delete node[segments[0]];
-				return;
-			}
-			node[segments[0]] = value;
-		}
-	};
-	apply(object);
-	return object;
+function modify(item, modifier) {
+	if (!Object.keys(modifier).some((key) => key.startsWith("$"))) return modifier;
+	const clonedItem = deepClone(item);
+	update(clonedItem, modifier);
+	return clonedItem;
 }
 //#endregion
-export { set as default };
+export { modify as default };

package/dist/index21.cjs.js

@@ -1,35 +1,37 @@
-const require_get = require("./index10.cjs.js");
-const require_set = require("./index20.cjs.js");
-//#region src/utils/project.ts
+//#region src/utils/set.ts
 /**
-* Projects the fields of an object based on a specified fields configuration.
-* Supports inclusion (`1`) and exclusion (`0`) of specific fields. Creates a new object
-* with the desired fields included or excluded, based on the configuration.
-* @template T - The type of the object being projected.
-* @param item - The original object to project fields from.
-* @param fields - An object defining the fields to include (`1`) or exclude (`0`).
-*   - Keys are the field names, and values are either `1` (include) or `0` (exclude).
-* @returns A new object with the specified fields included or excluded.
-*   - If all fields are set to `0`, the excluded fields are removed from the result.
-*   - If fields are set to `1`, only the included fields are retained.
+* Sets a value at a specified path within an object. Creates nested structures
+* (arrays or objects) as needed to set the value at the correct location. Supports
+* deleting the key if the value is `undefined` and the `deleteIfUndefined` flag is set to `true`.
+* @template T - The type of the object to modify.
+* @template K - The type of the value to set.
+* @param object - The object to modify. The object is mutated directly.
+* @param path - The path (dot or bracket notation) where the value should be set.
+* @param value - The value to set at the specified path.
+* @param deleteIfUndefined - A boolean indicating whether to delete the key if the value is `undefined` (default: `false`).
+* @returns The modified object.
 */
-function project(item, fields) {
-	if (Object.values(fields).every((value) => value === 0)) {
-		const result = { ...item };
-		Object.keys(fields).forEach((key) => {
-			if (require_get.default(item, key) === void 0) return;
-			require_set.default(result, key, void 0, true);
-		});
-		return result;
-	}
-	const result = {};
-	Object.entries(fields).forEach(([key, value]) => {
-		const fieldValue = require_get.default(item, key);
-		if (fieldValue === void 0) return;
-		if (fieldValue == null && value !== 1) return;
-		require_set.default(result, key, value === 1 ? fieldValue : void 0);
-	});
-	return result;
+function set(object, path, value, deleteIfUndefined = false) {
+	if (object == null) return object;
+	const segments = path.split(/[.[\]]/g);
+	if (segments[0] === "") segments.shift();
+	if (segments.at(-1) === "") segments.pop();
+	const apply = (node) => {
+		if (segments.length > 1) {
+			const key = segments.shift();
+			const nextIsNumber = !Number.isNaN(Number.parseInt(segments[0], 10));
+			if (node[key] === void 0) node[key] = nextIsNumber ? [] : {};
+			apply(node[key]);
+		} else {
+			if (deleteIfUndefined && value === void 0) {
+				delete node[segments[0]];
+				return;
+			}
+			node[segments[0]] = value;
+		}
+	};
+	apply(object);
+	return object;
 }
 //#endregion
-exports.default = project;
+exports.default = set;

package/dist/index21.mjs

@@ -1,35 +1,37 @@
-import get from "./index10.mjs";
-import set from "./index20.mjs";
-//#region src/utils/project.ts
+//#region src/utils/set.ts
 /**
-* Projects the fields of an object based on a specified fields configuration.
-* Supports inclusion (`1`) and exclusion (`0`) of specific fields. Creates a new object
-* with the desired fields included or excluded, based on the configuration.
-* @template T - The type of the object being projected.
-* @param item - The original object to project fields from.
-* @param fields - An object defining the fields to include (`1`) or exclude (`0`).
-*   - Keys are the field names, and values are either `1` (include) or `0` (exclude).
-* @returns A new object with the specified fields included or excluded.
-*   - If all fields are set to `0`, the excluded fields are removed from the result.
-*   - If fields are set to `1`, only the included fields are retained.
+* Sets a value at a specified path within an object. Creates nested structures
+* (arrays or objects) as needed to set the value at the correct location. Supports
+* deleting the key if the value is `undefined` and the `deleteIfUndefined` flag is set to `true`.
+* @template T - The type of the object to modify.
+* @template K - The type of the value to set.
+* @param object - The object to modify. The object is mutated directly.
+* @param path - The path (dot or bracket notation) where the value should be set.
+* @param value - The value to set at the specified path.
+* @param deleteIfUndefined - A boolean indicating whether to delete the key if the value is `undefined` (default: `false`).
+* @returns The modified object.
 */
-function project(item, fields) {
-	if (Object.values(fields).every((value) => value === 0)) {
-		const result = { ...item };
-		Object.keys(fields).forEach((key) => {
-			if (get(item, key) === void 0) return;
-			set(result, key, void 0, true);
-		});
-		return result;
-	}
-	const result = {};
-	Object.entries(fields).forEach(([key, value]) => {
-		const fieldValue = get(item, key);
-		if (fieldValue === void 0) return;
-		if (fieldValue == null && value !== 1) return;
-		set(result, key, value === 1 ? fieldValue : void 0);
-	});
-	return result;
+function set(object, path, value, deleteIfUndefined = false) {
+	if (object == null) return object;
+	const segments = path.split(/[.[\]]/g);
+	if (segments[0] === "") segments.shift();
+	if (segments.at(-1) === "") segments.pop();
+	const apply = (node) => {
+		if (segments.length > 1) {
+			const key = segments.shift();
+			const nextIsNumber = !Number.isNaN(Number.parseInt(segments[0], 10));
+			if (node[key] === void 0) node[key] = nextIsNumber ? [] : {};
+			apply(node[key]);
+		} else {
+			if (deleteIfUndefined && value === void 0) {
+				delete node[segments[0]];
+				return;
+			}
+			node[segments[0]] = value;
+		}
+	};
+	apply(object);
+	return object;
 }
 //#endregion
-export { project as default };
+export { set as default };

package/dist/index22.cjs.js

@@ -1,25 +1,35 @@
-//#region src/utils/queryId.ts
+const require_get = require("./index11.cjs.js");
+const require_set = require("./index21.cjs.js");
+//#region src/utils/project.ts
 /**
-* Returns true when `options` is effectively "empty" for the purpose of queryId generation.
-* Treats `undefined`/`null` as empty, and only considers plain objects with zero own enumerable keys as empty.
-* Arrays and non-object values are not considered empty.
-* @param options - Query options to test.
-* @returns `true` if `options` is `null`/`undefined` or a plain object with no own keys; otherwise `false`.
+* Projects the fields of an object based on a specified fields configuration.
+* Supports inclusion (`1`) and exclusion (`0`) of specific fields. Creates a new object
+* with the desired fields included or excluded, based on the configuration.
+* @template T - The type of the object being projected.
+* @param item - The original object to project fields from.
+* @param fields - An object defining the fields to include (`1`) or exclude (`0`).
+*   - Keys are the field names, and values are either `1` (include) or `0` (exclude).
+* @returns A new object with the specified fields included or excluded.
+*   - If all fields are set to `0`, the excluded fields are removed from the result.
+*   - If fields are set to `1`, only the included fields are retained.
 */
-function isEmptyOptions(options) {
-	if (options == null) return true;
-	if (typeof options !== "object") return false;
-	if (Array.isArray(options)) return false;
-	return Object.keys(options).length === 0;
-}
-/**
-* Generates a unique identifier for a query based on its selector and options.
-* @param selector - The selector object.
-* @param options - The query options object (optional).
-* @returns A unique identifier string for the query.
-*/
-function queryId(selector, options) {
-	return `${JSON.stringify(selector)}:${isEmptyOptions(options) ? -1 : JSON.stringify(options)}`;
+function project(item, fields) {
+	if (Object.values(fields).every((value) => value === 0)) {
+		const result = { ...item };
+		Object.keys(fields).forEach((key) => {
+			if (require_get.default(item, key) === void 0) return;
+			require_set.default(result, key, void 0, true);
+		});
+		return result;
+	}
+	const result = {};
+	Object.entries(fields).forEach(([key, value]) => {
+		const fieldValue = require_get.default(item, key);
+		if (fieldValue === void 0) return;
+		if (fieldValue == null && value !== 1) return;
+		require_set.default(result, key, value === 1 ? fieldValue : void 0);
+	});
+	return result;
 }
 //#endregion
-exports.default = queryId;
+exports.default = project;

package/dist/index22.mjs

@@ -1,25 +1,35 @@
-//#region src/utils/queryId.ts
+import get from "./index11.mjs";
+import set from "./index21.mjs";
+//#region src/utils/project.ts
 /**
-* Returns true when `options` is effectively "empty" for the purpose of queryId generation.
-* Treats `undefined`/`null` as empty, and only considers plain objects with zero own enumerable keys as empty.
-* Arrays and non-object values are not considered empty.
-* @param options - Query options to test.
-* @returns `true` if `options` is `null`/`undefined` or a plain object with no own keys; otherwise `false`.
+* Projects the fields of an object based on a specified fields configuration.
+* Supports inclusion (`1`) and exclusion (`0`) of specific fields. Creates a new object
+* with the desired fields included or excluded, based on the configuration.
+* @template T - The type of the object being projected.
+* @param item - The original object to project fields from.
+* @param fields - An object defining the fields to include (`1`) or exclude (`0`).
+*   - Keys are the field names, and values are either `1` (include) or `0` (exclude).
+* @returns A new object with the specified fields included or excluded.
+*   - If all fields are set to `0`, the excluded fields are removed from the result.
+*   - If fields are set to `1`, only the included fields are retained.
 */
-function isEmptyOptions(options) {
-	if (options == null) return true;
-	if (typeof options !== "object") return false;
-	if (Array.isArray(options)) return false;
-	return Object.keys(options).length === 0;
-}
-/**
-* Generates a unique identifier for a query based on its selector and options.
-* @param selector - The selector object.
-* @param options - The query options object (optional).
-* @returns A unique identifier string for the query.
-*/
-function queryId(selector, options) {
-	return `${JSON.stringify(selector)}:${isEmptyOptions(options) ? -1 : JSON.stringify(options)}`;
+function project(item, fields) {
+	if (Object.values(fields).every((value) => value === 0)) {
+		const result = { ...item };
+		Object.keys(fields).forEach((key) => {
+			if (get(item, key) === void 0) return;
+			set(result, key, void 0, true);
+		});
+		return result;
+	}
+	const result = {};
+	Object.entries(fields).forEach(([key, value]) => {
+		const fieldValue = get(item, key);
+		if (fieldValue === void 0) return;
+		if (fieldValue == null && value !== 1) return;
+		set(result, key, value === 1 ? fieldValue : void 0);
+	});
+	return result;
 }
 //#endregion
-export { queryId as default };
+export { project as default };

package/dist/index23.cjs.js

@@ -1,19 +1,21 @@
-const require_get = require("./index10.cjs.js");
-let fast_sort = require("fast-sort");
-//#region src/utils/sortItems.ts
+const require_project = require("./index22.cjs.js");
+//#region src/utils/projectItems.ts
 /**
-* Sorts an array of items based on multiple fields and their specified sort order.
-* Uses the `fast-sort` library for efficient sorting.
-* @template T - The type of the items in the array.
-* @param items - The array of items to be sorted.
-* @param sortFields - An object defining the sort order for each field.
-*   - Keys are the field names, and values are either `1` (ascending) or `-1` (descending).
-* @returns A new array of items sorted based on the specified fields and their order.
+* Applies a query's field projection to a list of items, keeping the primary key unless the
+* projection excludes it outright. Returns the items untouched when there is no projection, so a
+* caller does not have to check for one first.
+* @template T - The type of the items.
+* @param items - The items to project.
+* @param fields - The projection, or `undefined` for none.
+* @returns The projected items.
 */
-function sortItems(items, sortFields) {
-	return (0, fast_sort.sort)(items).by(Object.entries(sortFields).map(([key, value]) => {
-		return { [value === 1 ? "asc" : "desc"]: (i) => require_get.default(i, key) };
+function projectItems(items, fields) {
+	if (!fields) return items;
+	const idExcluded = fields.id === 0;
+	return items.map((item) => ({
+		...idExcluded ? {} : { id: item.id },
+		...require_project.default(item, fields)
 	}));
 }
 //#endregion
-exports.default = sortItems;
+exports.default = projectItems;

package/dist/index23.mjs

@@ -1,19 +1,21 @@
-import get from "./index10.mjs";
-import { sort } from "fast-sort";
-//#region src/utils/sortItems.ts
+import project from "./index22.mjs";
+//#region src/utils/projectItems.ts
 /**
-* Sorts an array of items based on multiple fields and their specified sort order.
-* Uses the `fast-sort` library for efficient sorting.
-* @template T - The type of the items in the array.
-* @param items - The array of items to be sorted.
-* @param sortFields - An object defining the sort order for each field.
-*   - Keys are the field names, and values are either `1` (ascending) or `-1` (descending).
-* @returns A new array of items sorted based on the specified fields and their order.
+* Applies a query's field projection to a list of items, keeping the primary key unless the
+* projection excludes it outright. Returns the items untouched when there is no projection, so a
+* caller does not have to check for one first.
+* @template T - The type of the items.
+* @param items - The items to project.
+* @param fields - The projection, or `undefined` for none.
+* @returns The projected items.
 */
-function sortItems(items, sortFields) {
-	return sort(items).by(Object.entries(sortFields).map(([key, value]) => {
-		return { [value === 1 ? "asc" : "desc"]: (i) => get(i, key) };
+function projectItems(items, fields) {
+	if (!fields) return items;
+	const idExcluded = fields.id === 0;
+	return items.map((item) => ({
+		...idExcluded ? {} : { id: item.id },
+		...project(item, fields)
 	}));
 }
 //#endregion
-export { sortItems as default };
+export { projectItems as default };