@signaldb/core 1.7.2 → 1.8.1

package/dist/index2.mjs

@@ -1,261 +1,23 @@
-import sortItems from "./index15.mjs";
-import project from "./index16.mjs";
-import Observer from "./index17.mjs";
-function isInReactiveScope(reactivity) {
-  if (!reactivity)
-    return false;
-  if (!reactivity.isInScope)
-    return true;
-  return reactivity.isInScope();
+//#region src/utils/get.ts
+/**
+* Retrieves the value at a specified path within an object.
+* Supports dot and bracket notation for navigating nested properties.
+* @template T - The type of the object to retrieve the value from.
+* @param value - The object to navigate.
+* @param path - The path (dot or bracket notation) to the desired value.
+* @returns The value at the specified path, or `undefined` if the path does not exist.
+*/
+function get(value, path) {
+	const normalized = path.replaceAll(/\[(\w+)\]/g, ".$1");
+	if (normalized.includes("..") || normalized.startsWith(".") || normalized.endsWith(".")) return;
+	const segments = normalized.split(".");
+	let current = value;
+	for (const key of segments) {
+		if (current == null) return;
+		current = current[key];
+	}
+	if (current === void 0) return;
+	return current;
 }
-class Cursor {
-  observer;
-  getFilteredItems;
-  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.getFilteredItems = 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);
-  }
-  getItems() {
-    const items = this.getFilteredItems();
-    const { sort, skip, limit } = this.options;
-    const sorted = sort ? sortItems(items, sort) : items;
-    const skipped = skip ? sorted.slice(skip) : sorted;
-    const limited = limit ? skipped.slice(0, limit) : skipped;
-    const idExcluded = this.options.fields && this.options.fields.id === 0;
-    return limited.map((item) => {
-      if (!this.options.fields)
-        return item;
-      return {
-        ...idExcluded ? {} : { id: item.id },
-        ...project(item, this.options.fields)
-      };
-    });
-  }
-  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.
-   */
-  forEach(callback) {
-    const items = this.getItems();
-    this.depend({
-      addedBefore: true,
-      removed: true,
-      movedBefore: true,
-      ...this.options.fieldTracking ? {} : { changed: true }
-    });
-    items.forEach((item) => {
-      callback(this.transform(item));
-    });
-  }
-  /**
-   * 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 = [];
-    this.forEach((item) => {
-      results.push(callback(item));
-    });
-    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() {
-    const items = this.getItems();
-    this.depend({
-      added: true,
-      removed: true
-    });
-    return items.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 { get as default };

package/dist/index20.cjs.js

@@ -0,0 +1,45 @@
+//#region src/utils/isFieldExpression.ts
+var expressionKeys = new Set([
+	"$eq",
+	"$gt",
+	"$gte",
+	"$lt",
+	"$lte",
+	"$in",
+	"$nin",
+	"$ne",
+	"$exists",
+	"$not",
+	"$expr",
+	"$jsonSchema",
+	"$mod",
+	"$regex",
+	"$options",
+	"$text",
+	"$where",
+	"$all",
+	"$elemMatch",
+	"$size",
+	"$bitsAllClear",
+	"$bitsAllSet",
+	"$bitsAnyClear",
+	"$bitsAnySet"
+]);
+/**
+* Determines whether a given object is a valid field expression.
+* A field expression is an object containing query operators supported by MongoDB-style queries.
+* @template T - The type of the field expression.
+* @param expression - The object to test.
+* @returns A boolean indicating whether the object is a valid field expression.
+*   - `true` if the object contains only recognized query operators.
+*   - `false` otherwise.
+*/
+function isFieldExpression(expression) {
+	if (typeof expression !== "object" || expression == null) return false;
+	const keys = Object.keys(expression);
+	if (keys.length === 0) return false;
+	if (keys.some((key) => !expressionKeys.has(key))) return false;
+	return keys.every((key) => expressionKeys.has(key));
+}
+//#endregion
+exports.default = isFieldExpression;

package/dist/index20.mjs

@@ -1,16 +1,45 @@
-function serializeValue(value) {
-  if (value == null)
-    return null;
-  if (typeof value === "string")
-    return value;
-  if (typeof value === "number")
-    return value.toString();
-  if (typeof value === "boolean")
-    return value.toString();
-  if (value instanceof Date)
-    return value.toISOString();
-  return JSON.stringify(value);
+//#region src/utils/isFieldExpression.ts
+var expressionKeys = new Set([
+	"$eq",
+	"$gt",
+	"$gte",
+	"$lt",
+	"$lte",
+	"$in",
+	"$nin",
+	"$ne",
+	"$exists",
+	"$not",
+	"$expr",
+	"$jsonSchema",
+	"$mod",
+	"$regex",
+	"$options",
+	"$text",
+	"$where",
+	"$all",
+	"$elemMatch",
+	"$size",
+	"$bitsAllClear",
+	"$bitsAllSet",
+	"$bitsAnyClear",
+	"$bitsAnySet"
+]);
+/**
+* Determines whether a given object is a valid field expression.
+* A field expression is an object containing query operators supported by MongoDB-style queries.
+* @template T - The type of the field expression.
+* @param expression - The object to test.
+* @returns A boolean indicating whether the object is a valid field expression.
+*   - `true` if the object contains only recognized query operators.
+*   - `false` otherwise.
+*/
+function isFieldExpression(expression) {
+	if (typeof expression !== "object" || expression == null) return false;
+	const keys = Object.keys(expression);
+	if (keys.length === 0) return false;
+	if (keys.some((key) => !expressionKeys.has(key))) return false;
+	return keys.every((key) => expressionKeys.has(key));
 }
-export {
-  serializeValue as default
-};
+//#endregion
+export { isFieldExpression as default };

package/dist/index21.cjs.js

@@ -0,0 +1,45 @@
+const require_serializeValue = require("./index15.cjs.js");
+const require_isFieldExpression = require("./index20.cjs.js");
+//#region src/utils/getMatchingKeys.ts
+/**
+* Extracts the matching and excluded keys for a given field in a selector.
+* Supports serialized values and `$in`/`$nin` field expressions for optimization.
+* Returns `null` for include/exclude if the field cannot be optimized.
+* @template T - The type of the items in the selector.
+* @template I - The type of the unique identifier for the items.
+* @param field - The name of the field to extract matching keys for.
+* @param selector - The selector object containing query criteria.
+* @returns An object containing arrays of serialized included and excluded keys,
+*   or `null` if the field cannot be optimized.
+*/
+function getMatchingKeys(field, selector) {
+	const result = {
+		include: null,
+		exclude: null
+	};
+	const fieldSelector = selector[field];
+	if (fieldSelector instanceof RegExp) return result;
+	if (fieldSelector == null) return result;
+	if (require_isFieldExpression.default(fieldSelector)) {
+		if (fieldSelector.$ne != null) {
+			result.exclude = [require_serializeValue.default(fieldSelector.$ne)];
+			return result;
+		}
+		if (Array.isArray(fieldSelector.$in) && fieldSelector.$in.length > 0) {
+			result.include = fieldSelector.$in.map(require_serializeValue.default);
+			return result;
+		}
+		if (Array.isArray(fieldSelector.$nin) && fieldSelector.$nin.length > 0) {
+			result.exclude = fieldSelector.$nin.map(require_serializeValue.default);
+			return result;
+		}
+		return {
+			include: null,
+			exclude: null
+		};
+	}
+	result.include = [require_serializeValue.default(fieldSelector)];
+	return result;
+}
+//#endregion
+exports.default = getMatchingKeys;

package/dist/index21.mjs

@@ -1,27 +1,45 @@
-function createSignal(reactivityAdapter, initialValue, isEqual = Object.is) {
-  let value = initialValue;
-  const dependency = reactivityAdapter?.create();
-  const isInReactiveScope = () => {
-    if (!reactivityAdapter?.isInScope)
-      return true;
-    return reactivityAdapter.isInScope();
-  };
-  const signal = {
-    get() {
-      if (dependency && isInReactiveScope())
-        dependency.depend();
-      return value;
-    },
-    set(newValue) {
-      if (isEqual(value, newValue))
-        return;
-      value = newValue;
-      if (dependency)
-        dependency.notify();
-    }
-  };
-  return signal;
+import serializeValue from "./index15.mjs";
+import isFieldExpression from "./index20.mjs";
+//#region src/utils/getMatchingKeys.ts
+/**
+* Extracts the matching and excluded keys for a given field in a selector.
+* Supports serialized values and `$in`/`$nin` field expressions for optimization.
+* Returns `null` for include/exclude if the field cannot be optimized.
+* @template T - The type of the items in the selector.
+* @template I - The type of the unique identifier for the items.
+* @param field - The name of the field to extract matching keys for.
+* @param selector - The selector object containing query criteria.
+* @returns An object containing arrays of serialized included and excluded keys,
+*   or `null` if the field cannot be optimized.
+*/
+function getMatchingKeys(field, selector) {
+	const result = {
+		include: null,
+		exclude: null
+	};
+	const fieldSelector = selector[field];
+	if (fieldSelector instanceof RegExp) return result;
+	if (fieldSelector == null) return result;
+	if (isFieldExpression(fieldSelector)) {
+		if (fieldSelector.$ne != null) {
+			result.exclude = [serializeValue(fieldSelector.$ne)];
+			return result;
+		}
+		if (Array.isArray(fieldSelector.$in) && fieldSelector.$in.length > 0) {
+			result.include = fieldSelector.$in.map(serializeValue);
+			return result;
+		}
+		if (Array.isArray(fieldSelector.$nin) && fieldSelector.$nin.length > 0) {
+			result.exclude = fieldSelector.$nin.map(serializeValue);
+			return result;
+		}
+		return {
+			include: null,
+			exclude: null
+		};
+	}
+	result.include = [serializeValue(fieldSelector)];
+	return result;
 }
-export {
-  createSignal as default
-};
+//#endregion
+export { getMatchingKeys as default };

package/dist/index22.cjs.js

@@ -0,0 +1,69 @@
+const require_get = require("./index2.cjs.js");
+const require_serializeValue = require("./index15.cjs.js");
+const require_createIndexProvider = require("./index19.cjs.js");
+const require_getMatchingKeys = require("./index21.cjs.js");
+//#region src/Collection/createIndex.ts
+/**
+* creates an index for a specific field but uses an external map to store the index
+* @param field name of the field
+* @param index the external map to use for the index
+* @returns an index provider to pass to the `indices` option of the collection constructor
+*/
+function createExternalIndex(field, index) {
+	return require_createIndexProvider.default({
+		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)
+			} : require_getMatchingKeys.default(field, selector);
+			if (keys.include == null && keys.exclude == null) return { matched: false };
+			let includedPositions = [];
+			if (keys.include == null) for (const set of index.values()) for (const pos of set) includedPositions.push(pos);
+			else for (const key of keys.include) {
+				const posSet = index.get(key);
+				if (posSet) for (const pos of posSet) includedPositions.push(pos);
+			}
+			if (keys.exclude != null) {
+				const excludeSet = /* @__PURE__ */ new Set();
+				for (const key of keys.exclude) {
+					const posSet = index.get(key);
+					if (posSet) for (const pos of posSet) excludeSet.add(pos);
+				}
+				includedPositions = includedPositions.filter((pos) => !excludeSet.has(pos));
+			}
+			return {
+				matched: true,
+				positions: includedPositions,
+				fields: [field],
+				keepSelector: filteresForNull
+			};
+		},
+		rebuild() {}
+	});
+}
+/**
+* creates an index for a specific field
+* @param field name of the field
+* @returns an index provider to pass to the `indices` option of the collection constructor
+*/
+function createIndex(field) {
+	const index = /* @__PURE__ */ new Map();
+	return {
+		...createExternalIndex(field, index),
+		rebuild(items) {
+			index.clear();
+			items.forEach((item, i) => {
+				const value = require_serializeValue.default(require_get.default(item, field));
+				const current = index.get(value) || /* @__PURE__ */ new Set();
+				current.add(i);
+				index.set(value, current);
+			});
+		}
+	};
+}
+//#endregion
+exports.createExternalIndex = createExternalIndex;
+exports.default = createIndex;