@signaldb/core 1.5.3 → 1.6.0

package/dist/index.cjs20.js

@@ -1,87 +1,15 @@
 "use strict";
-var __defProp = Object.defineProperty;
-var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
-var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
-Object.defineProperties(exports, { __esModule: { value: true }, [Symbol.toStringTag]: { value: "Module" } });
-const index = require("./index.cjs2.js");
-const combinePersistenceAdapters = require("./index.cjs4.js");
-const createPersistenceAdapter = require("./index.cjs7.js");
-const createSignal = require("./index.cjs17.js");
-function createReplicationAdapter(options) {
-  return createPersistenceAdapter({
-    async register(onChange) {
-      if (!options.registerRemoteChange)
-        return;
-      await options.registerRemoteChange(onChange);
-    },
-    load: () => options.pull(),
-    save: (items, changes) => {
-      if (!options.push)
-        throw new Error("Pushing is not configured for this collection. Try to pass a `push` function to the collection options.");
-      return options.push(changes, items);
-    }
-  });
+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);
 }
-class ReplicatedCollection extends index.default {
-  /**
-   * Creates a new instance of the `ReplicatedCollection` class.
-   * Sets up the replication adapter, combining it with an optional persistence adapter, and
-   * initializes signals for tracking remote pull and push operations.
-   * @param options - The configuration options for the replicated collection.
-   * @param options.pull - A function to fetch data from the remote source.
-   * @param options.push - An optional function to send changes and items to the remote source.
-   * @param options.registerRemoteChange - An optional function to register a listener for remote changes.
-   * @param options.persistence - An optional persistence adapter to combine with replication.
-   * @param options.reactivity - A reactivity adapter for observing changes in the collection.
-   * @param options.transform - A transformation function to apply to items when retrieving them.
-   * @param options.indices - An array of index providers for optimized querying.
-   * @param options.enableDebugMode - A boolean to enable or disable debug mode.
-   */
-  constructor(options) {
-    const replicationAdapter = createReplicationAdapter({
-      registerRemoteChange: options.registerRemoteChange,
-      pull: async () => {
-        this.isPullingRemoteSignal.set(true);
-        try {
-          return await options.pull();
-        } finally {
-          this.isPullingRemoteSignal.set(false);
-        }
-      },
-      push: options.push ? async (changes, items) => {
-        if (!options.push)
-          throw new Error("Pushing is not configured for this collection. Try to pass a `push` function to the collection options.");
-        this.isPushingRemoteSignal.set(true);
-        try {
-          await options.push(changes, items);
-        } finally {
-          this.isPushingRemoteSignal.set(false);
-        }
-      } : void 0
-    });
-    const persistenceAdapter = (options == null ? void 0 : options.persistence) ? combinePersistenceAdapters.default(replicationAdapter, options.persistence) : replicationAdapter;
-    super({
-      ...options,
-      persistence: persistenceAdapter
-    });
-    __publicField(this, "isPullingRemoteSignal");
-    __publicField(this, "isPushingRemoteSignal");
-    this.isPullingRemoteSignal = createSignal(options.reactivity, false);
-    this.isPushingRemoteSignal = createSignal(options.reactivity, false);
-  }
-  /**
-   * Checks whether the collection is currently performing any loading operation,
-   * including pulling or pushing data from/to the remote source, or standard
-   * persistence adapter operations.
-   * ⚡️ this function is reactive!
-   * @returns A boolean indicating if the collection is currently loading or synchronizing.
-   */
-  isLoading() {
-    const isPullingRemote = this.isPullingRemoteSignal.get();
-    const isPushingRemote = this.isPushingRemoteSignal.get();
-    const isLoading = super.isLoading();
-    return isPullingRemote || isPushingRemote || isLoading;
-  }
-}
-exports.createReplicationAdapter = createReplicationAdapter;
-exports.default = ReplicatedCollection;
+module.exports = serializeValue;

package/dist/index.cjs21.js

@@ -1,10 +1,26 @@
 "use strict";
-const fastSort = require("fast-sort");
-const get = require("./index.cjs25.js");
-function sortItems(items, sortFields) {
-  return fastSort.sort(items).by(Object.entries(sortFields).map(([key, value]) => {
-    const order = value === 1 ? "asc" : "desc";
-    return { [order]: (i) => get(i, key) };
-  }));
+function createSignal(reactivityAdapter, initialValue, isEqual = Object.is) {
+  let value = initialValue;
+  const dependency = reactivityAdapter == null ? void 0 : reactivityAdapter.create();
+  const isInReactiveScope = () => {
+    if (!(reactivityAdapter == null ? void 0 : 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;
 }
-module.exports = sortItems;
+module.exports = createSignal;

package/dist/index.cjs22.js

@@ -1,27 +1,70 @@
 "use strict";
-const get = require("./index.cjs25.js");
-const set = require("./index.cjs27.js");
-function project(item, fields) {
-  const allFieldsDeactivated = Object.values(fields).every((value) => value === 0);
-  if (allFieldsDeactivated) {
-    const result2 = { ...item };
-    Object.keys(fields).forEach((key) => {
-      const fieldValue = get(item, key);
-      if (fieldValue === void 0)
-        return;
-      set(result2, key, void 0, true);
-    });
-    return result2;
-  }
-  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);
+Object.defineProperties(exports, { __esModule: { value: true }, [Symbol.toStringTag]: { value: "Module" } });
+const intersection = require("./index.cjs27.js");
+function getMergedIndexInfo(indexProviders, selector) {
+  return indexProviders.reduce((memo, indexProvider) => {
+    const info = indexProvider.query(selector);
+    if (!info.matched)
+      return memo;
+    const optimizedSelector = info.keepSelector ? memo.optimizedSelector : Object.fromEntries(Object.entries(memo.optimizedSelector).filter(([key]) => !info.fields.includes(key)));
+    return {
+      matched: true,
+      positions: [...new Set(memo.matched ? intersection(memo.positions, info.positions) : info.positions)],
+      optimizedSelector
+    };
+  }, {
+    matched: false,
+    positions: [],
+    optimizedSelector: { ...selector }
   });
-  return result;
 }
-module.exports = project;
+function getIndexInfo(indexProviders, selector) {
+  if (selector == null || Object.keys(selector).length <= 0) {
+    return { matched: false, positions: [], optimizedSelector: selector };
+  }
+  const { $and, $or, ...rest } = selector;
+  const flatInfo = getMergedIndexInfo(indexProviders, rest);
+  let { matched, positions } = flatInfo;
+  const newSelector = flatInfo.optimizedSelector;
+  if (Array.isArray($and)) {
+    const $andNew = [];
+    for (const sel of $and) {
+      const { matched: selMatched, positions: selPositions, optimizedSelector } = getIndexInfo(indexProviders, sel);
+      if (selMatched) {
+        positions = matched ? intersection(positions, selPositions) : selPositions;
+        matched = true;
+        if (Object.keys(optimizedSelector).length > 0) {
+          $andNew.push(optimizedSelector);
+        }
+      } else {
+        $andNew.push(sel);
+      }
+    }
+    if ($andNew.length > 0)
+      newSelector.$and = $andNew;
+  }
+  if (Array.isArray($or)) {
+    const $orNew = [];
+    for (const sel of $or) {
+      const { matched: selMatched, positions: selPositions, optimizedSelector } = getIndexInfo(indexProviders, sel);
+      if (selMatched) {
+        positions = [.../* @__PURE__ */ new Set([...positions, ...selPositions])];
+        matched = true;
+        if (Object.keys(optimizedSelector).length > 0) {
+          $orNew.push(optimizedSelector);
+        }
+      } else {
+        $orNew.push(sel);
+      }
+    }
+    if ($orNew.length > 0)
+      newSelector.$or = $orNew;
+  }
+  return {
+    matched,
+    positions: positions || [],
+    optimizedSelector: newSelector
+  };
+}
+exports.default = getIndexInfo;
+exports.getMergedIndexInfo = getMergedIndexInfo;

package/dist/index.cjs23.js

@@ -2,145 +2,86 @@
 var __defProp = Object.defineProperty;
 var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
 var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
-const isEqual = require("./index.cjs9.js");
-const uniqueBy = require("./index.cjs28.js");
-class Observer {
-  /**
-   * Creates a new instance of the `Observer` class.
-   * Sets up event bindings and initializes the callbacks for tracking changes in a collection.
-   * @param bindEvents - A function to bind external events to the observer. Must return a cleanup function to unbind those events.
-   */
-  constructor(bindEvents) {
-    __publicField(this, "previousItems", []);
-    __publicField(this, "callbacks");
-    __publicField(this, "unbindEvents");
-    this.callbacks = {
-      added: [],
-      addedBefore: [],
-      changed: [],
-      changedField: [],
-      movedBefore: [],
-      removed: []
-    };
-    this.unbindEvents = bindEvents();
-  }
-  call(event, ...args) {
-    this.callbacks[event].forEach(({ callback, options }) => {
-      if (!options.skipInitial || !options.isInitial) {
-        callback(...args);
-      }
-    });
-  }
-  hasCallbacks(events) {
-    return events.some((event) => this.callbacks[event].length > 0);
-  }
-  /**
-   * Determines if the observer has no active callbacks registered for any events.
-   * @returns A boolean indicating whether the observer is empty (i.e., no callbacks are registered).
-   */
-  isEmpty() {
-    return !this.hasCallbacks([
-      "added",
-      "addedBefore",
-      "changed",
-      "changedField",
-      "movedBefore",
-      "removed"
-    ]);
-  }
+Object.defineProperties(exports, { __esModule: { value: true }, [Symbol.toStringTag]: { value: "Module" } });
+const index = require("./index.cjs3.js");
+const combinePersistenceAdapters = require("./index.cjs5.js");
+const createPersistenceAdapter = require("./index.cjs8.js");
+const createSignal = require("./index.cjs21.js");
+function createReplicationAdapter(options) {
+  return createPersistenceAdapter({
+    async register(onChange) {
+      if (!options.registerRemoteChange)
+        return;
+      await options.registerRemoteChange(onChange);
+    },
+    load: () => options.pull(),
+    save: (items, changes) => {
+      if (!options.push)
+        throw new Error("Pushing is not configured for this collection. Try to pass a `push` function to the collection options.");
+      return options.push(changes, items);
+    }
+  });
+}
+class ReplicatedCollection extends index.default {
   /**
-   * Compares the previous state of items with the new state and triggers the appropriate callbacks
-   * for events such as added, removed, changed, or moved items.
-   * @param newItems - The new list of items to compare against the previous state.
+   * Creates a new instance of the `ReplicatedCollection` class.
+   * Sets up the replication adapter, combining it with an optional persistence adapter, and
+   * initializes signals for tracking remote pull and push operations.
+   * @param options - The configuration options for the replicated collection.
+   * @param options.pull - A function to fetch data from the remote source.
+   * @param options.push - An optional function to send changes and items to the remote source.
+   * @param options.registerRemoteChange - An optional function to register a listener for remote changes.
+   * @param options.persistence - An optional persistence adapter to combine with replication.
+   * @param options.reactivity - A reactivity adapter for observing changes in the collection.
+   * @param options.transform - A transformation function to apply to items when retrieving them.
+   * @param options.indices - An array of index providers for optimized querying.
+   * @param options.enableDebugMode - A boolean to enable or disable debug mode.
    */
-  runChecks(newItems) {
-    const oldItemsMap = new Map(this.previousItems.map((item, index) => [
-      item.id,
-      { item, index, beforeItem: this.previousItems[index + 1] || null }
-    ]));
-    const newItemsMap = new Map(newItems.map((item, index) => [
-      item.id,
-      { item, index, beforeItem: newItems[index + 1] || null }
-    ]));
-    if (this.hasCallbacks(["changed", "changedField", "movedBefore", "removed"])) {
-      oldItemsMap.forEach(({ item: oldItem, index, beforeItem: oldBeforeItem }) => {
-        var _a;
-        const newItem = newItemsMap.get(oldItem.id);
-        if (newItem) {
-          if (this.hasCallbacks(["changed", "changedField"]) && !isEqual(newItem.item, oldItem)) {
-            this.call("changed", newItem.item);
-            if (this.hasCallbacks(["changedField"])) {
-              const keys = uniqueBy([
-                ...Object.keys(newItem.item),
-                ...Object.keys(oldItem)
-              ], (value) => value);
-              keys.forEach((key) => {
-                if (isEqual(newItem.item[key], oldItem[key]))
-                  return;
-                this.call("changedField", newItem.item, key, oldItem[key], newItem.item[key]);
-              });
-            }
-          }
-          if (newItem.index !== index && ((_a = newItem.beforeItem) == null ? void 0 : _a.id) !== (oldBeforeItem == null ? void 0 : oldBeforeItem.id)) {
-            this.call("movedBefore", newItem.item, newItem.beforeItem);
-          }
-        } else {
-          this.call("removed", oldItem);
+  constructor(options) {
+    const replicationAdapter = createReplicationAdapter({
+      registerRemoteChange: options.registerRemoteChange,
+      pull: async () => {
+        this.isPullingRemoteSignal.set(true);
+        try {
+          return await options.pull();
+        } finally {
+          this.isPullingRemoteSignal.set(false);
         }
-      });
-    }
-    if (this.hasCallbacks(["added", "addedBefore"])) {
-      newItems.forEach((newItem, index) => {
-        const oldItem = oldItemsMap.get(newItem.id);
-        if (oldItem)
-          return;
-        this.call("added", newItem);
-        this.call("addedBefore", newItem, newItems[index + 1] || null);
-      });
-    }
-    this.previousItems = newItems;
-    Object.keys(this.callbacks).forEach((key) => {
-      const event = key;
-      const callbacks = this.callbacks[event];
-      this.callbacks[event] = callbacks.map((callback) => ({
-        ...callback,
-        options: {
-          ...callback.options,
-          isInitial: false
+      },
+      push: options.push ? async (changes, items) => {
+        if (!options.push)
+          throw new Error("Pushing is not configured for this collection. Try to pass a `push` function to the collection options.");
+        this.isPushingRemoteSignal.set(true);
+        try {
+          await options.push(changes, items);
+        } finally {
+          this.isPushingRemoteSignal.set(false);
         }
-      }));
+      } : void 0
     });
-  }
-  /**
-   * Stops the observer by unbinding all events and cleaning up resources.
-   */
-  stop() {
-    this.unbindEvents();
-  }
-  /**
-   * Registers callbacks for specific events to observe changes in the collection.
-   * @param callbacks - An object containing the callbacks for various events (e.g., 'added', 'removed').
-   * @param skipInitial - A boolean indicating whether to skip invoking the callbacks for the initial state of the collection.
-   */
-  addCallbacks(callbacks, skipInitial = false) {
-    Object.keys(callbacks).forEach((key) => {
-      const typedKey = key;
-      this.callbacks[typedKey].push({
-        callback: callbacks[typedKey],
-        options: { skipInitial, isInitial: true }
-      });
+    const persistenceAdapter = (options == null ? void 0 : options.persistence) ? combinePersistenceAdapters.default(replicationAdapter, options.persistence) : replicationAdapter;
+    super({
+      ...options,
+      persistence: persistenceAdapter
     });
+    __publicField(this, "isPullingRemoteSignal");
+    __publicField(this, "isPushingRemoteSignal");
+    this.isPullingRemoteSignal = createSignal(options.reactivity, false);
+    this.isPushingRemoteSignal = createSignal(options.reactivity, false);
   }
   /**
-   * Removes the specified callbacks for specific events, unregistering them from the observer.
-   * @param callbacks - An object containing the callbacks to be removed for various events.
+   * Checks whether the collection is currently performing any loading operation,
+   * including pulling or pushing data from/to the remote source, or standard
+   * persistence adapter operations.
+   * ⚡️ this function is reactive!
+   * @returns A boolean indicating if the collection is currently loading or synchronizing.
    */
-  removeCallbacks(callbacks) {
-    Object.keys(callbacks).forEach((key) => {
-      const typedKey = key;
-      const index = this.callbacks[typedKey].findIndex(({ callback }) => callback === callbacks[typedKey]);
-      this.callbacks[typedKey].splice(index, 1);
-    });
+  isLoading() {
+    const isPullingRemote = this.isPullingRemoteSignal.get();
+    const isPushingRemote = this.isPushingRemoteSignal.get();
+    const isLoading = super.isLoading();
+    return isPullingRemote || isPushingRemote || isLoading;
   }
 }
-module.exports = Observer;
+exports.createReplicationAdapter = createReplicationAdapter;
+exports.default = ReplicatedCollection;

package/dist/index.cjs24.js

@@ -1,7 +1,18 @@
 "use strict";
-function intersection(...arrays) {
-  if (arrays.length === 0)
-    return [];
-  return [...new Set(arrays.reduce((a, b) => a.filter((c) => b.includes(c))))];
+function get(value, path) {
+  const segments = path.split(/[.[\]]/g);
+  if (segments[0] === "")
+    segments.shift();
+  if (segments.at(-1) === "")
+    segments.pop();
+  let current = value;
+  for (const key of segments) {
+    if (current == null || key.trim() === "")
+      return;
+    current = current[key];
+  }
+  if (current === void 0)
+    return;
+  return current;
 }
-module.exports = intersection;
+module.exports = get;

package/dist/index.cjs25.js

@@ -1,18 +1,29 @@
 "use strict";
-function get(value, path) {
+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();
-  let current = value;
-  for (const key of segments) {
-    if (current == null || key.trim() === "")
-      return;
-    current = current[key];
-  }
-  if (current === void 0)
-    return;
-  return current;
+  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;
 }
-module.exports = get;
+module.exports = set;

package/dist/index.cjs26.js

@@ -1,29 +1,9 @@
 "use strict";
-const isFieldExpression = require("./index.cjs29.js");
-const serializeValue = require("./index.cjs16.js");
-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;
+function uniqueBy(array, fn) {
+  const set = /* @__PURE__ */ new Set();
+  return array.filter((element) => {
+    const value = typeof fn === "function" ? fn(element) : element[fn];
+    return !set.has(value) && set.add(value);
+  });
 }
-module.exports = getMatchingKeys;
+module.exports = uniqueBy;

package/dist/index.cjs27.js

@@ -1,29 +1,7 @@
 "use strict";
-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 intersection(...arrays) {
+  if (arrays.length === 0)
+    return [];
+  return [...new Set(arrays.reduce((a, b) => a.filter((c) => b.includes(c))))];
 }
-module.exports = set;
+module.exports = intersection;

package/dist/index.cjs28.js

@@ -1,9 +1,29 @@
 "use strict";
-function uniqueBy(array, fn) {
-  const set = /* @__PURE__ */ new Set();
-  return array.filter((element) => {
-    const value = typeof fn === "function" ? fn(element) : element[fn];
-    return !set.has(value) && set.add(value);
-  });
+const isFieldExpression = require("./index.cjs29.js");
+const serializeValue = require("./index.cjs20.js");
+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;
 }
-module.exports = uniqueBy;
+module.exports = getMatchingKeys;