@signaldb/core 2.0.0-beta.0 → 2.0.0-beta.10

package/dist/index2.mjs

@@ -1,255 +1,33 @@
-import Observer from "./index17.mjs";
-function isInReactiveScope(reactivity) {
-  if (!reactivity)
-    return false;
-  if (!reactivity.isInScope)
-    return true;
-  return reactivity.isInScope();
+//#region src/utils/isEqual.ts
+/**
+* Compares two values for deep equality.
+* @param a - The first value to compare.
+* @param b - The second value to compare.
+* @returns - Returns `true` if the two values are deeply equal, otherwise `false`.
+* @example
+* isEqual({ a: 1 }, { a: 1 }); // true
+* isEqual([1, 2], [1, 2]);     // true
+* isEqual(new Date(0), new Date(0)); // true
+* isEqual(/abc/, /abc/);       // true
+* isEqual({ a: 1 }, { a: 2 }); // false
+* isEqual(null, null);         // true
+*/
+function isEqual(a, b) {
+	if (Object.is(a, b)) return true;
+	if (a instanceof RegExp && b instanceof RegExp) return a.toString() === b.toString();
+	if (a instanceof Date && b instanceof Date) return a.getTime() === b.getTime();
+	if (typeof a !== "object") return false;
+	if (typeof b !== "object") return false;
+	if (a === null) return false;
+	if (b === null) return false;
+	const aKeys = Object.keys(a);
+	const bKeys = Object.keys(b);
+	if (aKeys.length !== bKeys.length) return false;
+	for (const key of aKeys) {
+		if (!bKeys.includes(key)) return false;
+		if (!isEqual(a[key], b[key])) return false;
+	}
+	return true;
 }
-class Cursor {
-  observer;
-  getItems;
-  options;
-  onCleanupCallbacks = [];
-  /**
-   * Creates a new instance of the `Cursor` class.
-   * Provides utilities for querying, observing, and transforming items from a collection.
-   * @template T - The type of the items in the collection.
-   * @template U - The transformed item type after applying transformations (default is T).
-   * @param getItems - A function that retrieves the filtered list of items.
-   * @param options - Optional configuration for the cursor.
-   * @param options.transform - A transformation function to apply to each item when retrieving them.
-   * @param options.bindEvents - A function to bind reactivity events for the cursor, which should return a cleanup function.
-   * @param options.fields - A projection object defining which fields of the item should be included or excluded.
-   * @param options.sort - A sort specifier to determine the order of the items.
-   * @param options.skip - The number of items to skip from the beginning of the result set.
-   * @param options.limit - The maximum number of items to return in the result set.
-   * @param options.reactive - A reactivity adapter to enable observing changes in the cursor's result set.
-   * @param options.fieldTracking - A boolean to enable fine-grained field tracking for reactivity.
-   */
-  constructor(getItems, options) {
-    this.getItems = getItems;
-    this.options = options || {};
-  }
-  addGetters(item) {
-    if (!isInReactiveScope(this.options.reactive))
-      return item;
-    const depend = this.depend.bind(this);
-    return Object.entries(item).reduce((memo, [key, value]) => {
-      Object.defineProperty(memo, key, {
-        get() {
-          depend({
-            changedField: (notify) => (changedItem, changedFieldName) => {
-              if (changedFieldName !== key || changedItem.id !== item.id)
-                return;
-              notify();
-            }
-          });
-          return value;
-        },
-        enumerable: true,
-        configurable: true
-      });
-      return memo;
-    }, {});
-  }
-  transform(rawItem) {
-    const item = this.options.fieldTracking ? this.addGetters(rawItem) : rawItem;
-    if (!this.options.transform)
-      return item;
-    return this.options.transform(item);
-  }
-  depend(changeEvents) {
-    if (!this.options.reactive)
-      return;
-    if (!isInReactiveScope(this.options.reactive))
-      return;
-    const signal = this.options.reactive.create();
-    signal.depend();
-    const notify = () => signal.notify();
-    function buildNotifier(event) {
-      const eventHandler = changeEvents[event];
-      return (...args) => {
-        if (eventHandler === true) {
-          notify();
-          return;
-        }
-        if (typeof eventHandler !== "function")
-          return;
-        eventHandler(notify)(...args);
-      };
-    }
-    const stop = this.observeRawChanges({
-      added: buildNotifier("added"),
-      addedBefore: buildNotifier("addedBefore"),
-      changed: buildNotifier("changed"),
-      changedField: buildNotifier("changedField"),
-      movedBefore: buildNotifier("movedBefore"),
-      removed: buildNotifier("removed")
-    }, true);
-    if (this.options.reactive.onDispose) {
-      this.options.reactive.onDispose(() => stop(), signal);
-    }
-    this.onCleanup(stop);
-  }
-  ensureObserver() {
-    if (!this.observer) {
-      const observer = new Observer(() => {
-        const requery = () => {
-          observer.runChecks(this.getItems);
-        };
-        const cleanup = this.options.bindEvents && this.options.bindEvents(requery);
-        return () => {
-          if (cleanup)
-            cleanup();
-        };
-      });
-      this.onCleanup(() => observer.stop());
-      this.observer = observer;
-    }
-    return this.observer;
-  }
-  observeRawChanges(callbacks, skipInitial = false) {
-    const observer = this.ensureObserver();
-    observer.addCallbacks(callbacks, skipInitial);
-    observer.runChecks(this.getItems);
-    return () => {
-      observer.removeCallbacks(callbacks);
-      if (!observer.isEmpty())
-        return;
-      observer.stop();
-      this.observer = void 0;
-    };
-  }
-  /**
-   * Cleans up all resources associated with the cursor, such as reactive bindings
-   * and event listeners. This method should be called when the cursor is no longer needed
-   * to prevent memory leaks.
-   */
-  cleanup() {
-    this.onCleanupCallbacks.forEach((callback) => {
-      callback();
-    });
-    this.onCleanupCallbacks = [];
-  }
-  /**
-   * Registers a cleanup callback to be executed when the `cleanup` method is called.
-   * Useful for managing resources and ensuring proper cleanup of bindings or listeners.
-   * @param callback - A function to be executed during cleanup.
-   */
-  onCleanup(callback) {
-    this.onCleanupCallbacks.push(callback);
-  }
-  /**
-   * Iterates over each item in the cursor's result set, applying the provided callback
-   * function to each transformed item.
-   * ⚡️ this function is reactive!
-   * @param callback - A function to execute for each item in the result set.
-   * @param callback.item - The transformed item.
-   * @returns A promise that resolves when all items have been processed, or void if not in async mode.
-   */
-  forEach(callback) {
-    this.depend({
-      addedBefore: true,
-      removed: true,
-      movedBefore: true,
-      ...this.options.fieldTracking ? {} : { changed: true }
-    });
-    const executeForEach = (items) => {
-      items.forEach((item) => {
-        callback(this.transform(item));
-      });
-    };
-    const result = this.getItems();
-    if (result instanceof Promise) {
-      return result.then(executeForEach);
-    } else {
-      executeForEach(result);
-      return void 0;
-    }
-  }
-  /**
-   * Creates a new array populated with the results of applying the provided callback
-   * function to each transformed item in the cursor's result set.
-   * ⚡️ this function is reactive!
-   * @template V - The type of the items in the resulting array.
-   * @param callback - A function to execute for each item in the result set.
-   * @param callback.item - The transformed item.
-   * @returns An array of results after applying the callback to each item.
-   */
-  map(callback) {
-    const results = [];
-    const maybePromise = this.forEach((item) => {
-      results.push(callback(item));
-    });
-    if (maybePromise instanceof Promise) {
-      return maybePromise.then(() => results);
-    }
-    return results;
-  }
-  /**
-   * Fetches all transformed items from the cursor's result set as an array.
-   * Automatically applies filtering, sorting, and limiting as per the cursor's options.
-   * ⚡️ this function is reactive!
-   * @returns An array of transformed items in the result set.
-   */
-  fetch() {
-    return this.map((item) => item);
-  }
-  /**
-   * Counts the total number of items in the cursor's result set after applying
-   * filtering and other criteria.
-   * ⚡️ this function is reactive!
-   * @returns The total number of items in the result set.
-   */
-  count() {
-    this.depend({
-      added: true,
-      removed: true
-    });
-    const maybePromise = this.getItems();
-    return maybePromise instanceof Promise ? maybePromise.then((items) => items.length) : maybePromise.length;
-  }
-  /**
-   * Observes changes to the cursor's result set and triggers the specified callbacks
-   * when items are added, removed, or updated. Supports reactivity and transformation.
-   * @param callbacks - An object containing the callback functions to handle different change events.
-   * @param callbacks.added - Triggered when an item is added to the result set.
-   * @param callbacks.removed - Triggered when an item is removed from the result set.
-   * @param callbacks.changed - Triggered when an item in the result set is modified.
-   * @param callbacks.addedBefore - Triggered when an item is added before another item in the result set.
-   * @param callbacks.movedBefore - Triggered when an item is moved before another item in the result set.
-   * @param callbacks.changedField - Triggered when a specific field of an item changes.
-   * @param skipInitial - A boolean indicating whether to skip the initial notification of the current result set.
-   * @returns A function to stop observing changes.
-   */
-  observeChanges(callbacks, skipInitial = false) {
-    return this.observeRawChanges(Object.entries(callbacks).reduce((memo, [callbackName, callback]) => {
-      if (!callback)
-        return memo;
-      return {
-        ...memo,
-        [callbackName]: (item, before) => {
-          const transformedValue = this.transform(item);
-          const hasBeforeParameter = before !== void 0;
-          const transformedBeforeValue = hasBeforeParameter && before ? this.transform(before) : null;
-          return callback(transformedValue, ...hasBeforeParameter ? [transformedBeforeValue] : []);
-        }
-      };
-    }, {}), skipInitial);
-  }
-  /**
-   * Forces the cursor to re-evaluate its result set by re-fetching items
-   * from the collection. This is useful when the underlying data or query
-   * criteria have changed, and you want to ensure the cursor reflects the latest state.
-   */
-  requery() {
-    if (!this.observer)
-      return;
-    this.observer.runChecks(this.getItems);
-  }
-}
-export {
-  Cursor as default,
-  isInReactiveScope
-};
+//#endregion
+export { isEqual as default };

package/dist/index20.cjs.js

@@ -0,0 +1,37 @@
+//#region src/utils/set.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.
+*/
+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 = set;

package/dist/index20.mjs

@@ -1,105 +1,37 @@
-import createIndexProvider from "./index27.mjs";
-import get from "./index10.mjs";
-import getMatchingKeys from "./index26.mjs";
-import serializeValue from "./index11.mjs";
-function createIndex(field) {
-  const index = /* @__PURE__ */ new Map();
-  const ensureSet = (key) => {
-    let set = index.get(key);
-    if (!set) {
-      set = /* @__PURE__ */ new Set();
-      index.set(key, set);
-    }
-    return set;
-  };
-  return createIndexProvider({
-    query(selector) {
-      if (!Object.hasOwnProperty.call(selector, field)) {
-        return { matched: false };
-      }
-      const fieldSelector = selector[field];
-      const filteresForNull = fieldSelector == null || fieldSelector.$exists === false;
-      const keys = filteresForNull ? { include: null, exclude: [...index.keys()].filter((key) => key != null) } : getMatchingKeys(field, selector);
-      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 posSet = index.get(key);
-          if (posSet) {
-            for (const pos of posSet) {
-              includedIds.push(pos);
-            }
-          }
-        }
-      }
-      if (keys.exclude != null) {
-        const excludeIds = /* @__PURE__ */ new Set();
-        for (const key of keys.exclude) {
-          const posSet = index.get(key);
-          if (posSet) {
-            for (const pos of posSet) {
-              excludeIds.add(pos);
-            }
-          }
-        }
-        includedIds = includedIds.filter((pos) => !excludeIds.has(pos));
-      }
-      return {
-        matched: true,
-        ids: includedIds,
-        fields: [field],
-        keepSelector: filteresForNull
-      };
-    },
-    rebuild(items) {
-      index.clear();
-      items.forEach((item) => {
-        const value = serializeValue(get(item, field));
-        ensureSet(value).add(item.id);
-      });
-    },
-    // NEW: delta methods
-    insert(items) {
-      for (const item of items) {
-        const value = serializeValue(get(item, field));
-        ensureSet(value).add(item.id);
-      }
-    },
-    remove(items) {
-      for (const item of items) {
-        const value = serializeValue(get(item, field));
-        const set = index.get(value);
-        if (!set)
-          continue;
-        set.delete(item.id);
-        if (set.size === 0)
-          index.delete(value);
-      }
-    },
-    update(pairs) {
-      for (const { oldItem, newItem } of pairs) {
-        const oldValue = serializeValue(get(oldItem, field));
-        const newValue = serializeValue(get(newItem, field));
-        if (oldValue === newValue)
-          continue;
-        const oldSet = index.get(oldValue);
-        if (oldSet) {
-          oldSet.delete(oldItem.id);
-          if (oldSet.size === 0)
-            index.delete(oldValue);
-        }
-        ensureSet(newValue).add(newItem.id);
-      }
-    }
-  });
+//#region src/utils/set.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.
+*/
+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;
 }
-export {
-  createIndex as default
-};
+//#endregion
+export { set as default };

package/dist/index21.cjs.js

@@ -0,0 +1,35 @@
+const require_get = require("./index10.cjs.js");
+const require_set = require("./index20.cjs.js");
+//#region src/utils/project.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.
+*/
+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 = project;

package/dist/index21.mjs

@@ -1,129 +1,35 @@
-import intersection from "./index28.mjs";
-function getMergedIndexInfo(queryFunctions, selector) {
-  return queryFunctions.reduce((memoOrPromise, queryFunction) => {
-    const resultOrPromise = queryFunction(selector);
-    const processResult = (memo2, result) => {
-      if (!result.matched)
-        return memo2;
-      const optimizedSelector = result.keepSelector ? memo2.optimizedSelector : Object.fromEntries(Object.entries(memo2.optimizedSelector).filter(([key]) => !result.fields.includes(key)));
-      return {
-        matched: true,
-        ids: [...new Set(memo2.matched ? intersection(memo2.ids, result.ids) : result.ids)],
-        optimizedSelector
-      };
-    };
-    if (resultOrPromise instanceof Promise) {
-      return resultOrPromise.then(async (result) => {
-        const memo2 = memoOrPromise instanceof Promise ? await memoOrPromise : memoOrPromise;
-        return processResult(memo2, result);
-      });
-    }
-    const memo = memoOrPromise;
-    if (memo instanceof Promise)
-      throw new Error("Mixing async and sync index providers is not supported");
-    return processResult(memo, resultOrPromise);
-  }, {
-    matched: false,
-    ids: [],
-    optimizedSelector: { ...selector }
-  });
+import get from "./index10.mjs";
+import set from "./index20.mjs";
+//#region src/utils/project.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.
+*/
+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 optimizeLogicGate(queryFunctions, logicGate, idsCallback) {
-  return logicGate.reduce((memoOrPromise, sel) => {
-    const getSelector = (indexInfo) => {
-      const { matched: selMatched, ids: selIds, optimizedSelector: optimizedSelector2 } = indexInfo;
-      if (selMatched) {
-        idsCallback(true, selIds);
-        if (Object.keys(optimizedSelector2).length > 0) {
-          return optimizedSelector2;
-        }
-      } else {
-        idsCallback(false, []);
-        return sel;
-      }
-    };
-    const indexInfoOrPromise = getIndexInfo(queryFunctions, sel);
-    if (indexInfoOrPromise instanceof Promise) {
-      return indexInfoOrPromise.then(async (indexInfo) => {
-        const memo2 = memoOrPromise instanceof Promise ? await memoOrPromise : memoOrPromise;
-        const optimizedSelector2 = getSelector(indexInfo);
-        if (optimizedSelector2)
-          memo2.push(optimizedSelector2);
-        return memo2;
-      });
-    }
-    const memo = memoOrPromise;
-    if (memo instanceof Promise)
-      throw new Error("Mixing async and sync index providers is not supported");
-    const optimizedSelector = getSelector(indexInfoOrPromise);
-    if (optimizedSelector)
-      memo.push(optimizedSelector);
-    return memo;
-  }, []);
-}
-function getIndexInfo(queryFunctions, selector) {
-  if (selector == null || Object.keys(selector).length <= 0) {
-    return {
-      matched: false,
-      ids: [],
-      optimizedSelector: selector
-    };
-  }
-  const { $and, $or, ...rest } = selector;
-  const flatInfoOrPromise = getMergedIndexInfo(queryFunctions, rest);
-  const processFlatInfo = (flatInfo) => {
-    let { matched, ids } = flatInfo;
-    const newSelector = flatInfo.optimizedSelector;
-    const $andNewOrPromise = Array.isArray($and) ? optimizeLogicGate(queryFunctions, $and, (match, selIds) => {
-      if (!match)
-        return;
-      ids = matched ? intersection(ids, selIds) : selIds;
-      matched = true;
-    }) : void 0;
-    const process$and = ($andNew) => {
-      if ($andNew && $andNew.length > 0)
-        newSelector.$and = $andNew;
-      let hasNonIndexField = false;
-      const matchedBefore = matched;
-      const idsBefore = ids;
-      const process$or = ($orNew) => {
-        if ($orNew && $orNew.length > 0)
-          newSelector.$or = $orNew;
-        if (hasNonIndexField) {
-          newSelector.$or = $or;
-          matched = matchedBefore;
-          ids = idsBefore;
-        }
-        return {
-          matched,
-          ids: ids || [],
-          optimizedSelector: newSelector
-        };
-      };
-      const $orNewOrPromise = Array.isArray($or) ? optimizeLogicGate(queryFunctions, $or, (match, selIds) => {
-        if (match) {
-          ids = [.../* @__PURE__ */ new Set([...ids, ...selIds])];
-          matched = true;
-        } else {
-          hasNonIndexField = true;
-        }
-      }) : void 0;
-      if ($orNewOrPromise instanceof Promise) {
-        return $orNewOrPromise.then(($orNew) => process$or($orNew));
-      }
-      return process$or($orNewOrPromise);
-    };
-    if ($andNewOrPromise instanceof Promise) {
-      return $andNewOrPromise.then(($andNew) => process$and($andNew));
-    }
-    return process$and($andNewOrPromise);
-  };
-  if (flatInfoOrPromise instanceof Promise) {
-    return flatInfoOrPromise.then(processFlatInfo);
-  }
-  return processFlatInfo(flatInfoOrPromise);
-}
-export {
-  getIndexInfo as default,
-  getMergedIndexInfo
-};
+//#endregion
+export { project as default };