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

package/dist/index6.cjs.js

@@ -0,0 +1,125 @@
+//#region src/utils/EventEmitter.ts
+/**
+* A strongly‑typed EventEmitter.
+*/
+var EventEmitter = class {
+	_maxListeners = 100;
+	/**
+	* We store a set of the listeners for each event.
+	*/
+	_listenerStore = /* @__PURE__ */ new Map();
+	setMaxListeners(max) {
+		this._maxListeners = max;
+		return this;
+	}
+	/**
+	* Subscribe to an event with a listener function.
+	* @param eventName The event name (key of E).
+	* @param listener  A function that receives the emitted arguments.
+	* @returns         The emitter instance (for chaining).
+	*/
+	on(eventName, listener) {
+		let listenersSet = this._listenerStore.get(eventName);
+		if (!listenersSet) {
+			listenersSet = /* @__PURE__ */ new Set();
+			this._listenerStore.set(eventName, listenersSet);
+		}
+		listenersSet.add(listener);
+		if (listenersSet.size > this._maxListeners) console.warn(`Possible EventEmitter memory leak detected. ${listenersSet.size} ${String(eventName)} listeners added. Use emitter.setMaxListeners() to increase limit.`);
+		return this;
+	}
+	/**
+	* Subscribe to an event with a listener function.
+	* @param eventName The event name (key of E).
+	* @param listener  A function that receives the emitted arguments.
+	* @returns         The emitter instance (for chaining).
+	*/
+	addListener(eventName, listener) {
+		return this.on(eventName, listener);
+	}
+	/**
+	* Subscribe to an event, handling it only once. Automatically removes
+	* the listener after it fires the first time.
+	* @param eventName The event name (key of E).
+	* @param listener  A function that receives the emitted arguments.
+	* @returns         The emitter instance (for chaining).
+	*/
+	once(eventName, listener) {
+		const onceWrapper = ((...args) => {
+			listener(...args);
+			this.off(eventName, onceWrapper);
+		});
+		return this.on(eventName, onceWrapper);
+	}
+	/**
+	* Unsubscribe a previously subscribed listener.
+	* @param eventName The event name (key of E).
+	* @param listener  The original function passed to `on` or `once`.
+	* @returns         The emitter instance (for chaining).
+	*/
+	off(eventName, listener) {
+		const listenersSet = this._listenerStore.get(eventName);
+		if (!listenersSet) return this;
+		listenersSet.delete(listener);
+		if (listenersSet.size === 0) this._listenerStore.delete(eventName);
+		return this;
+	}
+	/**
+	* Unsubscribe a previously subscribed listener.
+	* @param eventName The event name (key of E).
+	* @param listener  The original function passed to `on` or `once`.
+	* @returns         The emitter instance (for chaining).
+	*/
+	removeListener(eventName, listener) {
+		return this.off(eventName, listener);
+	}
+	/**
+	* Emit (dispatch) an event with a variable number of arguments.
+	* @param eventName The event name (key of E).
+	* @param args      The arguments to pass to subscribed listeners.
+	*/
+	emit(eventName, ...args) {
+		this.listeners(eventName).forEach((listener) => {
+			listener(...args);
+		});
+	}
+	/**
+	* Returns the array of listener functions currently registered for a given event.
+	* @param eventName The event name (key of E).
+	* @returns         An array of listener functions.
+	*/
+	listeners(eventName) {
+		const listenersSet = this._listenerStore.get(eventName);
+		if (!listenersSet) return [];
+		return [...listenersSet.values()];
+	}
+	/**
+	* Returns the number of listeners for a given event.
+	* @param eventName The event name (key of E).
+	* @returns         The number of listeners.
+	*/
+	listenerCount(eventName) {
+		const listenersSet = this._listenerStore.get(eventName);
+		return listenersSet ? listenersSet.size : 0;
+	}
+	/**
+	* Removes all listeners for a given event, or all events if none is specified.
+	* @param eventName Optional. If omitted, clears all events’ listeners.
+	* @returns         The emitter instance (for chaining).
+	*/
+	removeAllListeners(eventName) {
+		if (eventName === void 0) {
+			for (const [eventName_, listenersSet] of this._listenerStore.entries()) for (const listener of listenersSet.values()) this.off(eventName_, listener);
+			this._listenerStore.clear();
+		} else {
+			const listenersSet = this._listenerStore.get(eventName);
+			if (listenersSet) {
+				for (const listener of listenersSet.values()) this.off(eventName, listener);
+				this._listenerStore.delete(eventName);
+			}
+		}
+		return this;
+	}
+};
+//#endregion
+exports.default = EventEmitter;

package/dist/index6.mjs

@@ -1,30 +1,125 @@
-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;
-}
-export {
-  isEqual as default
+//#region src/utils/EventEmitter.ts
+/**
+* A strongly‑typed EventEmitter.
+*/
+var EventEmitter = class {
+	_maxListeners = 100;
+	/**
+	* We store a set of the listeners for each event.
+	*/
+	_listenerStore = /* @__PURE__ */ new Map();
+	setMaxListeners(max) {
+		this._maxListeners = max;
+		return this;
+	}
+	/**
+	* Subscribe to an event with a listener function.
+	* @param eventName The event name (key of E).
+	* @param listener  A function that receives the emitted arguments.
+	* @returns         The emitter instance (for chaining).
+	*/
+	on(eventName, listener) {
+		let listenersSet = this._listenerStore.get(eventName);
+		if (!listenersSet) {
+			listenersSet = /* @__PURE__ */ new Set();
+			this._listenerStore.set(eventName, listenersSet);
+		}
+		listenersSet.add(listener);
+		if (listenersSet.size > this._maxListeners) console.warn(`Possible EventEmitter memory leak detected. ${listenersSet.size} ${String(eventName)} listeners added. Use emitter.setMaxListeners() to increase limit.`);
+		return this;
+	}
+	/**
+	* Subscribe to an event with a listener function.
+	* @param eventName The event name (key of E).
+	* @param listener  A function that receives the emitted arguments.
+	* @returns         The emitter instance (for chaining).
+	*/
+	addListener(eventName, listener) {
+		return this.on(eventName, listener);
+	}
+	/**
+	* Subscribe to an event, handling it only once. Automatically removes
+	* the listener after it fires the first time.
+	* @param eventName The event name (key of E).
+	* @param listener  A function that receives the emitted arguments.
+	* @returns         The emitter instance (for chaining).
+	*/
+	once(eventName, listener) {
+		const onceWrapper = ((...args) => {
+			listener(...args);
+			this.off(eventName, onceWrapper);
+		});
+		return this.on(eventName, onceWrapper);
+	}
+	/**
+	* Unsubscribe a previously subscribed listener.
+	* @param eventName The event name (key of E).
+	* @param listener  The original function passed to `on` or `once`.
+	* @returns         The emitter instance (for chaining).
+	*/
+	off(eventName, listener) {
+		const listenersSet = this._listenerStore.get(eventName);
+		if (!listenersSet) return this;
+		listenersSet.delete(listener);
+		if (listenersSet.size === 0) this._listenerStore.delete(eventName);
+		return this;
+	}
+	/**
+	* Unsubscribe a previously subscribed listener.
+	* @param eventName The event name (key of E).
+	* @param listener  The original function passed to `on` or `once`.
+	* @returns         The emitter instance (for chaining).
+	*/
+	removeListener(eventName, listener) {
+		return this.off(eventName, listener);
+	}
+	/**
+	* Emit (dispatch) an event with a variable number of arguments.
+	* @param eventName The event name (key of E).
+	* @param args      The arguments to pass to subscribed listeners.
+	*/
+	emit(eventName, ...args) {
+		this.listeners(eventName).forEach((listener) => {
+			listener(...args);
+		});
+	}
+	/**
+	* Returns the array of listener functions currently registered for a given event.
+	* @param eventName The event name (key of E).
+	* @returns         An array of listener functions.
+	*/
+	listeners(eventName) {
+		const listenersSet = this._listenerStore.get(eventName);
+		if (!listenersSet) return [];
+		return [...listenersSet.values()];
+	}
+	/**
+	* Returns the number of listeners for a given event.
+	* @param eventName The event name (key of E).
+	* @returns         The number of listeners.
+	*/
+	listenerCount(eventName) {
+		const listenersSet = this._listenerStore.get(eventName);
+		return listenersSet ? listenersSet.size : 0;
+	}
+	/**
+	* Removes all listeners for a given event, or all events if none is specified.
+	* @param eventName Optional. If omitted, clears all events’ listeners.
+	* @returns         The emitter instance (for chaining).
+	*/
+	removeAllListeners(eventName) {
+		if (eventName === void 0) {
+			for (const [eventName_, listenersSet] of this._listenerStore.entries()) for (const listener of listenersSet.values()) this.off(eventName_, listener);
+			this._listenerStore.clear();
+		} else {
+			const listenersSet = this._listenerStore.get(eventName);
+			if (listenersSet) {
+				for (const listener of listenersSet.values()) this.off(eventName, listener);
+				this._listenerStore.delete(eventName);
+			}
+		}
+		return this;
+	}
 };
+//#endregion
+export { EventEmitter as default };

package/dist/index7.cjs.js

@@ -0,0 +1,33 @@
+//#region src/utils/createSignal.ts
+/**
+* Creates a reactive signal for managing state and triggering dependencies.
+* The signal holds a value and provides methods to get and set the value,
+* with optional equality checks and dependency tracking.
+* @template T - The type of the value held by the signal.
+* @param reactivityAdapter - An optional reactivity adapter for managing dependencies.
+* @param initialValue - The initial value of the signal.
+* @param isEqual - A custom equality function to determine if the new value is different
+*   from the current value (default is `Object.is`).
+* @returns A signal object with `get` and `set` methods to manage the value.
+*/
+function createSignal(reactivityAdapter, initialValue, isEqual = Object.is) {
+	let value = initialValue;
+	const dependency = reactivityAdapter?.create();
+	const isInReactiveScope = () => {
+		if (!reactivityAdapter?.isInScope) return true;
+		return reactivityAdapter.isInScope();
+	};
+	return {
+		get() {
+			if (dependency && isInReactiveScope()) dependency.depend();
+			return value;
+		},
+		set(newValue) {
+			if (isEqual(value, newValue)) return;
+			value = newValue;
+			if (dependency) dependency.notify();
+		}
+	};
+}
+//#endregion
+exports.default = createSignal;

package/dist/index7.mjs

@@ -1,13 +1,33 @@
-import { update } from "mingo";
-import deepClone from "./index19.mjs";
-function modify(item, modifier) {
-  const hasOperators = Object.keys(modifier).some((key) => key.startsWith("$"));
-  if (!hasOperators)
-    return modifier;
-  const clonedItem = deepClone(item);
-  update(clonedItem, modifier);
-  return clonedItem;
+//#region src/utils/createSignal.ts
+/**
+* Creates a reactive signal for managing state and triggering dependencies.
+* The signal holds a value and provides methods to get and set the value,
+* with optional equality checks and dependency tracking.
+* @template T - The type of the value held by the signal.
+* @param reactivityAdapter - An optional reactivity adapter for managing dependencies.
+* @param initialValue - The initial value of the signal.
+* @param isEqual - A custom equality function to determine if the new value is different
+*   from the current value (default is `Object.is`).
+* @returns A signal object with `get` and `set` methods to manage the value.
+*/
+function createSignal(reactivityAdapter, initialValue, isEqual = Object.is) {
+	let value = initialValue;
+	const dependency = reactivityAdapter?.create();
+	const isInReactiveScope = () => {
+		if (!reactivityAdapter?.isInScope) return true;
+		return reactivityAdapter.isInScope();
+	};
+	return {
+		get() {
+			if (dependency && isInReactiveScope()) dependency.depend();
+			return value;
+		},
+		set(newValue) {
+			if (isEqual(value, newValue)) return;
+			value = newValue;
+			if (dependency) dependency.notify();
+		}
+	};
 }
-export {
-  modify as default
-};
+//#endregion
+export { createSignal as default };

package/dist/index8.cjs.js

@@ -0,0 +1,12 @@
+//#region src/utils/randomId.ts
+/**
+* creates a random id
+* @returns a random string of 16 characters
+* @example
+* randomId() // '1234567890abcdef'
+*/
+function randomId() {
+	return Array.from({ length: 16 }, () => "abcdefghijklmnopqrstuvwxyz0123456789"[Math.floor(Math.random() * 36)]).join("");
+}
+//#endregion
+exports.default = randomId;

package/dist/index8.mjs

@@ -1,6 +1,12 @@
+//#region src/utils/randomId.ts
+/**
+* creates a random id
+* @returns a random string of 16 characters
+* @example
+* randomId() // '1234567890abcdef'
+*/
 function randomId() {
-  return Array.from({ length: 16 }, () => "abcdefghijklmnopqrstuvwxyz0123456789"[Math.floor(Math.random() * 36)]).join("");
+	return Array.from({ length: 16 }, () => "abcdefghijklmnopqrstuvwxyz0123456789"[Math.floor(Math.random() * 36)]).join("");
 }
-export {
-  randomId as default
-};
+//#endregion
+export { randomId as default };

package/dist/index9.cjs.js

@@ -0,0 +1,11 @@
+//#region src/createIndexProvider.ts
+/**
+* Creates an IndexProvider based on the given definition.
+* @param definition - The definition of the IndexProvider.
+* @returns The created IndexProvider.
+*/
+function createIndexProvider(definition) {
+	return definition;
+}
+//#endregion
+exports.default = createIndexProvider;

package/dist/index9.mjs

@@ -1,134 +1,11 @@
-class EventEmitter {
-  _maxListeners = 100;
-  /**
-   * We store a set of the listeners for each event.
-   */
-  _listenerStore = /* @__PURE__ */ new Map();
-  setMaxListeners(max) {
-    this._maxListeners = max;
-    return this;
-  }
-  /**
-   * Subscribe to an event with a listener function.
-   * @param eventName The event name (key of E).
-   * @param listener  A function that receives the emitted arguments.
-   * @returns         The emitter instance (for chaining).
-   */
-  on(eventName, listener) {
-    let listenersSet = this._listenerStore.get(eventName);
-    if (!listenersSet) {
-      listenersSet = /* @__PURE__ */ new Set();
-      this._listenerStore.set(eventName, listenersSet);
-    }
-    listenersSet.add(listener);
-    if (listenersSet.size > this._maxListeners) {
-      console.warn(`Possible EventEmitter memory leak detected. ${listenersSet.size} ${String(eventName)} listeners added. Use emitter.setMaxListeners() to increase limit.`);
-    }
-    return this;
-  }
-  /**
-   * Subscribe to an event with a listener function.
-   * @param eventName The event name (key of E).
-   * @param listener  A function that receives the emitted arguments.
-   * @returns         The emitter instance (for chaining).
-   */
-  addListener(eventName, listener) {
-    return this.on(eventName, listener);
-  }
-  /**
-   * Subscribe to an event, handling it only once. Automatically removes
-   * the listener after it fires the first time.
-   * @param eventName The event name (key of E).
-   * @param listener  A function that receives the emitted arguments.
-   * @returns         The emitter instance (for chaining).
-   */
-  once(eventName, listener) {
-    const onceWrapper = ((...args) => {
-      listener(...args);
-      this.off(eventName, onceWrapper);
-    });
-    return this.on(eventName, onceWrapper);
-  }
-  /**
-   * Unsubscribe a previously subscribed listener.
-   * @param eventName The event name (key of E).
-   * @param listener  The original function passed to `on` or `once`.
-   * @returns         The emitter instance (for chaining).
-   */
-  off(eventName, listener) {
-    const listenersSet = this._listenerStore.get(eventName);
-    if (!listenersSet)
-      return this;
-    listenersSet.delete(listener);
-    if (listenersSet.size === 0) {
-      this._listenerStore.delete(eventName);
-    }
-    return this;
-  }
-  /**
-   * Unsubscribe a previously subscribed listener.
-   * @param eventName The event name (key of E).
-   * @param listener  The original function passed to `on` or `once`.
-   * @returns         The emitter instance (for chaining).
-   */
-  removeListener(eventName, listener) {
-    return this.off(eventName, listener);
-  }
-  /**
-   * Emit (dispatch) an event with a variable number of arguments.
-   * @param eventName The event name (key of E).
-   * @param args      The arguments to pass to subscribed listeners.
-   */
-  emit(eventName, ...args) {
-    this.listeners(eventName).forEach((listener) => {
-      listener(...args);
-    });
-  }
-  /**
-   * Returns the array of listener functions currently registered for a given event.
-   * @param eventName The event name (key of E).
-   * @returns         An array of listener functions.
-   */
-  listeners(eventName) {
-    const listenersSet = this._listenerStore.get(eventName);
-    if (!listenersSet)
-      return [];
-    return [...listenersSet.values()];
-  }
-  /**
-   * Returns the number of listeners for a given event.
-   * @param eventName The event name (key of E).
-   * @returns         The number of listeners.
-   */
-  listenerCount(eventName) {
-    const listenersSet = this._listenerStore.get(eventName);
-    return listenersSet ? listenersSet.size : 0;
-  }
-  /**
-   * Removes all listeners for a given event, or all events if none is specified.
-   * @param eventName Optional. If omitted, clears all events’ listeners.
-   * @returns         The emitter instance (for chaining).
-   */
-  removeAllListeners(eventName) {
-    if (eventName === void 0) {
-      for (const [eventName_, listenersSet] of this._listenerStore.entries()) {
-        for (const listener of listenersSet.values()) {
-          this.off(eventName_, listener);
-        }
-      }
-      this._listenerStore.clear();
-    } else {
-      const listenersSet = this._listenerStore.get(eventName);
-      if (listenersSet) {
-        for (const listener of listenersSet.values()) {
-          this.off(eventName, listener);
-        }
-        this._listenerStore.delete(eventName);
-      }
-    }
-    return this;
-  }
+//#region src/createIndexProvider.ts
+/**
+* Creates an IndexProvider based on the given definition.
+* @param definition - The definition of the IndexProvider.
+* @returns The created IndexProvider.
+*/
+function createIndexProvider(definition) {
+	return definition;
 }
-export {
-  EventEmitter as default
-};
+//#endregion
+export { createIndexProvider as default };

package/dist/types/IndexProvider.d.ts

@@ -1,5 +1,5 @@
-import type { BaseItem } from '../Collection';
-import type { FlatSelector } from './Selector';
+import { BaseItem } from '../Collection';
+import { FlatSelector } from './Selector';
 export type IndexResult<IdType> = {
     ids: IdType[];
     fields: string[];

package/dist/types/Modifier.d.ts

@@ -1,4 +1,4 @@
-import type { DotNotation, GetType } from './Selector';
+import { DotNotation, GetType } from './Selector';
 type Dictionary<T> = Record<string, T>;
 type PartialMapTo<T, M> = Partial<Record<DotNotation<T>, M>> & Dictionary<M>;
 type OnlyElementsOfArrays<T> = T extends any[] ? Partial<T[0]> : never;

package/dist/types/ReactivityAdapter.d.ts

@@ -1,4 +1,4 @@
-import type Dependency from './Dependency';
+import { default as Dependency } from './Dependency';
 export default interface ReactivityAdapter<T extends Dependency = Dependency> {
     create(): T;
     onDispose?(callback: () => void, Dependency: T): void;

package/dist/utils/batchOnNextTick.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Groups multiple calls by key and flushes them on the next tick (macrotask).
+ * @param onFlush - Function that will be called with the key and all queued items when flushing.
+ * @returns An object with `enqueue` and `flush` methods.
+ * @example
+ *   const batcher = batchOnNextTick<string>(async (key, items) => {
+ *     // items is an array of { args, resolve, reject }
+ *     // do something once with all args...
+ *   })
+ *
+ *   batcher.enqueue("my-key", [arg1, arg2])
+ */
+export default function batchOnNextTick<TKey>(onFlush: (key: TKey, items: any[][]) => Promise<any[]>): {
+    enqueue: (key: TKey, args: any[]) => Promise<any>;
+    flush: (key: TKey) => Promise<void>;
+};

package/dist/utils/createSignal.d.ts

@@ -1,5 +1,5 @@
-import type ReactivityAdapter from '../types/ReactivityAdapter';
-import type Signal from '../types/Signal';
+import { default as ReactivityAdapter } from '../types/ReactivityAdapter';
+import { default as Signal } from '../types/Signal';
 /**
  * Creates a reactive signal for managing state and triggering dependencies.
  * The signal holds a value and provides methods to get and set the value,

package/dist/utils/deepClone.d.ts

@@ -4,7 +4,7 @@
  * @template T - The type of the value to clone.
  * @param value - The value to deep clone.
  * @returns A deep copy of the provided value.
- * @throws An error if the value is a function, as cloning functions is not supported.
+ * @throws {Error} An error if the value is a function, as cloning functions is not supported.
  */
 export declare function clone<T>(value: T): T;
 /**

package/dist/utils/getMatchingKeys.d.ts

@@ -1,5 +1,5 @@
-import type { BaseItem } from '../Collection/types';
-import type { FlatSelector } from '../types/Selector';
+import { BaseItem } from '../Collection/types';
+import { FlatSelector } from '../types/Selector';
 type KeyResult = {
     include: (string | null)[] | null;
     exclude: (string | null)[] | null;

package/dist/utils/isFieldExpression.d.ts

@@ -1,4 +1,4 @@
-import type { FieldExpression } from '../types/Selector';
+import { FieldExpression } from '../types/Selector';
 /**
  * Determines whether a given object is a valid field expression.
  * A field expression is an object containing query operators supported by MongoDB-style queries.

package/dist/utils/match.d.ts

@@ -1,4 +1,4 @@
-import type Selector from '../types/Selector';
+import { default as Selector } from '../types/Selector';
 type BaseItem = Record<string, any>;
 /**
  * Tests whether a given item matches a specified selector.

package/dist/utils/modify.d.ts

@@ -1,4 +1,4 @@
-import type Modifier from '../types/Modifier';
+import { default as Modifier } from '../types/Modifier';
 /**
  * Applies a modifier to an object and returns a new modified object.
  * @template T - The type of the object to be modified.

package/dist/utils/queryId.d.ts

@@ -1,5 +1,5 @@
-import type { QueryOptions } from '../DataAdapter';
-import type Selector from '../types/Selector';
+import { QueryOptions } from '../DataAdapter';
+import { default as Selector } from '../types/Selector';
 /**
  * Generates a unique identifier for a query based on its selector and options.
  * @param selector - The selector object.