@signaldb/core 1.2.3 → 1.3.0

package/dist/index.cjs20.js

@@ -3,262 +3,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);
 Object.defineProperties(exports, { __esModule: { value: true }, [Symbol.toStringTag]: { value: "Module" } });
-const sortItems = require("./index.cjs23.js");
-const project = require("./index.cjs24.js");
-const Observer = require("./index.cjs25.js");
-function isInReactiveScope(reactivity) {
-  if (!reactivity)
-    return false;
-  if (!reactivity.isInScope)
-    return true;
-  return reactivity.isInScope();
+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);
+    }
+  });
 }
-class Cursor {
+class ReplicatedCollection extends index.default {
   /**
-   * 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.
+   * 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(getItems, options) {
-    __publicField(this, "observer");
-    __publicField(this, "getFilteredItems");
-    __publicField(this, "options");
-    __publicField(this, "onCleanupCallbacks", []);
-    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;
+  constructor(options) {
+    var _a, _b;
+    const replicationAdapter = createReplicationAdapter({
+      registerRemoteChange: options.registerRemoteChange,
+      pull: async () => {
+        this.isPullingRemoteSignal.set(true);
+        try {
+          return await options.pull();
+        } finally {
+          this.isPullingRemoteSignal.set(false);
         }
-        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 }
+      },
+      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
     });
-    items.forEach((item) => {
-      callback(this.transform(item));
+    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((_a = options.reactivity) == null ? void 0 : _a.create(), false);
+    this.isPushingRemoteSignal = createSignal((_b = options.reactivity) == null ? void 0 : _b.create(), false);
   }
   /**
-   * Creates a new array populated with the results of applying the provided callback
-   * function to each transformed item in the cursor's result set.
+   * 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!
-   * @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.
+   * @returns A boolean indicating if the collection is currently loading or synchronizing.
    */
-  requery() {
-    if (!this.observer)
-      return;
-    this.observer.runChecks(this.getItems());
+  isLoading() {
+    const isPullingRemote = this.isPullingRemoteSignal.get();
+    const isPushingRemote = this.isPushingRemoteSignal.get();
+    const isLoading = super.isLoading();
+    return isPullingRemote || isPushingRemote || isLoading;
   }
 }
-exports.default = Cursor;
-exports.isInReactiveScope = isInReactiveScope;
+exports.createReplicationAdapter = createReplicationAdapter;
+exports.default = ReplicatedCollection;

package/dist/index.cjs21.js

@@ -1,70 +1,10 @@
 "use strict";
-Object.defineProperties(exports, { __esModule: { value: true }, [Symbol.toStringTag]: { value: "Module" } });
-const intersection = require("./index.cjs26.js");
-function getMergedIndexInfo(indexProviders, selector) {
-  return indexProviders.reduce((memo, indexProvider) => {
-    const info = indexProvider.query(selector);
-    if (!info.matched)
-      return memo;
-    const 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 }
-  });
+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 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;
+module.exports = sortItems;

package/dist/index.cjs22.js

@@ -1,88 +1,27 @@
 "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.cjs3.js");
-const combinePersistenceAdapters = require("./index.cjs5.js");
-const createPersistenceAdapter = require("./index.cjs8.js");
-const createSignal = require("./index.cjs19.js");
-function createReplicationAdapter(options) {
-  return createPersistenceAdapter({
-    async register(onChange) {
-      if (!options.registerRemoteChange)
+const get = require("./index.cjs25.js");
+const set = require("./index.cjs28.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;
-      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 {
-  /**
-   * 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) {
-    var _a, _b;
-    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
+      set(result2, key, void 0, true);
     });
-    __publicField(this, "isPullingRemoteSignal");
-    __publicField(this, "isPushingRemoteSignal");
-    this.isPullingRemoteSignal = createSignal((_a = options.reactivity) == null ? void 0 : _a.create(), false);
-    this.isPushingRemoteSignal = createSignal((_b = options.reactivity) == null ? void 0 : _b.create(), 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;
+    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);
+  });
+  return result;
 }
-exports.createReplicationAdapter = createReplicationAdapter;
-exports.default = ReplicatedCollection;
+module.exports = project;