@signaldb/core 1.2.3 → 1.3.0

package/dist/index4.mjs

@@ -1,174 +1,69 @@
-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);
-import ReplicatedCollection from "./index22.mjs";
-import createSignal from "./index19.mjs";
-class AutoFetchCollection extends ReplicatedCollection {
-  /**
-   * @param options {Object} - Options for the collection.
-   * @param options.fetchQueryItems {Function} - A function that fetches items from the server. It takes the selector as an argument and returns a promise that resolves to an object with an `items` property.
-   * @param options.purgeDelay {Number} - The delay in milliseconds before purging an item from the cache.
-   */
-  constructor(options) {
-    var _a;
-    let triggerRemoteChange;
-    super({
-      ...options,
-      pull: () => Promise.resolve({
-        items: [...this.itemsCache.values()].reduce((memo, items) => {
-          const newItems = [...memo];
-          items.forEach((item) => {
-            const index = newItems.findIndex((i) => i.id === item.id);
-            if (index === -1) {
-              newItems.push(item);
-              return;
-            }
-            newItems[index] = this.mergeItems(newItems[index], item);
-          });
-          return newItems;
-        }, [])
-      }),
-      registerRemoteChange: async (onChange) => {
-        triggerRemoteChange = onChange;
+import createPersistenceAdapter from "./index7.mjs";
+function createTemporaryFallbackExecutor(firstResolvingPromiseFunction, secondResolvingPromiseFunction, options) {
+  const cacheTimeout = options == null ? void 0 : options.cacheTimeout;
+  let isResolved = false;
+  let resolvedValue = null;
+  let timeout = null;
+  let secondaryPromise = null;
+  return (...args) => {
+    if (secondaryPromise == null) {
+      if (timeout) {
+        clearTimeout(timeout);
+        timeout = null;
       }
-    });
-    __publicField(this, "activeObservers", /* @__PURE__ */ new Map());
-    __publicField(this, "observerTimeouts", /* @__PURE__ */ new Map());
-    __publicField(this, "purgeDelay");
-    __publicField(this, "idQueryCache", /* @__PURE__ */ new Map());
-    __publicField(this, "itemsCache", /* @__PURE__ */ new Map());
-    __publicField(this, "fetchQueryItems");
-    __publicField(this, "triggerReload", null);
-    __publicField(this, "reactivityAdapter", null);
-    __publicField(this, "loadingSignals", /* @__PURE__ */ new Map());
-    __publicField(this, "isFetchingSignal");
-    __publicField(this, "mergeItems");
-    this.mergeItems = options.mergeItems ?? ((itemA, itemB) => ({ ...itemA, ...itemB }));
-    this.purgeDelay = options.purgeDelay ?? 1e4;
-    this.isFetchingSignal = createSignal((_a = options.reactivity) == null ? void 0 : _a.create(), false);
-    if (!triggerRemoteChange)
-      throw new Error("No triggerRemoteChange method found. Looks like your persistence adapter was not registered");
-    this.triggerReload = triggerRemoteChange;
-    this.reactivityAdapter = options.reactivity ?? null;
-    this.fetchQueryItems = options.fetchQueryItems;
-    this.on("observer.created", (selector) => this.handleObserverCreation(selector ?? {}));
-    this.on("observer.disposed", (selector) => setTimeout(() => this.handleObserverDisposal(selector ?? {}), 100));
-    if (options.registerRemoteChange) {
-      void options.registerRemoteChange(() => this.forceRefetch());
-    }
-  }
-  /**
-   * Registers a query manually that items should be fetched for it
-   * @param selector {Object} Selector of the query
-   */
-  registerQuery(selector) {
-    this.handleObserverCreation(selector);
-  }
-  /**
-   * Unregisters a query manually that items are not fetched anymore for it
-   * @param selector {Object} Selector of the query
-   */
-  unregisterQuery(selector) {
-    this.handleObserverDisposal(selector);
-  }
-  getKeyForSelector(selector) {
-    return JSON.stringify(selector);
-  }
-  async forceRefetch() {
-    return Promise.all([...this.activeObservers.values()].map(({ selector }) => this.fetchSelector(selector))).then(() => {
-    });
-  }
-  fetchSelector(selector) {
-    this.isFetchingSignal.set(true);
-    return this.fetchQueryItems(selector).then((response) => {
-      if (!response.items)
-        throw new Error("AutoFetchCollection currently only works with a full item response");
-      this.itemsCache.set(this.getKeyForSelector(selector), response.items);
-      response.items.forEach((item) => {
-        const queries = this.idQueryCache.get(item.id) ?? [];
-        queries.push(selector);
-        this.idQueryCache.set(item.id, queries);
-      });
-      this.setLoading(selector, true);
-      this.once("persistence.received", () => {
-        this.setLoading(selector, false);
-      });
-      if (!this.triggerReload)
-        throw new Error("No triggerReload method found. Looks like your persistence adapter was not registered");
-      void this.triggerReload();
-    }).catch((error) => {
-      this.emit("persistence.error", error);
-    }).finally(() => {
-      this.isFetchingSignal.set(false);
-    });
-  }
-  handleObserverCreation(selector) {
-    var _a;
-    const activeObservers = ((_a = this.activeObservers.get(this.getKeyForSelector(selector))) == null ? void 0 : _a.count) ?? 0;
-    this.activeObservers.set(this.getKeyForSelector(selector), {
-      selector,
-      count: activeObservers + 1
-    });
-    const timeout = this.observerTimeouts.get(this.getKeyForSelector(selector));
-    if (timeout)
-      clearTimeout(timeout);
-    if (activeObservers === 0)
-      void this.fetchSelector(selector);
-  }
-  handleObserverDisposal(selector) {
-    var _a;
-    const currentObservers = ((_a = this.activeObservers.get(this.getKeyForSelector(selector))) == null ? void 0 : _a.count) ?? 0;
-    const activeObservers = currentObservers - 1;
-    if (activeObservers > 0) {
-      this.activeObservers.set(this.getKeyForSelector(selector), {
-        selector,
-        count: activeObservers
+      secondaryPromise = secondResolvingPromiseFunction(...args).then((result) => {
+        {
+          timeout = setTimeout(() => {
+            isResolved = false;
+            resolvedValue = null;
+            secondaryPromise = null;
+          }, cacheTimeout);
+        }
+        isResolved = true;
+        resolvedValue = result;
+        if (options == null ? void 0 : options.onResolve)
+          options.onResolve(resolvedValue);
+        return result;
       });
-      return;
+    } else if (isResolved) {
+      return secondaryPromise;
     }
-    const timeout = this.observerTimeouts.get(this.getKeyForSelector(selector));
-    if (timeout)
-      clearTimeout(timeout);
-    const removeObserver = () => {
-      this.activeObservers.delete(this.getKeyForSelector(selector));
-      this.itemsCache.delete(this.getKeyForSelector(selector));
-      if (!this.triggerReload)
-        throw new Error("No triggerReload method found. Looks like your persistence adapter was not registered");
-      void this.triggerReload();
-    };
-    if (this.purgeDelay === 0) {
-      removeObserver();
-      return;
-    }
-    this.observerTimeouts.set(this.getKeyForSelector(selector), setTimeout(removeObserver, this.purgeDelay));
-  }
-  ensureSignal(selector) {
-    if (!this.reactivityAdapter)
-      throw new Error("No reactivity adapter found");
-    if (!this.loadingSignals.has(this.getKeyForSelector(selector))) {
-      this.loadingSignals.set(this.getKeyForSelector(selector), createSignal(this.reactivityAdapter.create(), false));
+    return firstResolvingPromiseFunction(...args);
+  };
+}
+function combinePersistenceAdapters(slowAdapter, fastAdapter) {
+  let handleChange = null;
+  const readExecutor = createTemporaryFallbackExecutor(() => fastAdapter.load(), () => slowAdapter.load(), {
+    cacheTimeout: 100,
+    onResolve: (result) => {
+      var _a, _b, _c;
+      if (handleChange)
+        void handleChange();
+      void fastAdapter.save(result.items || [], {
+        added: ((_a = result.changes) == null ? void 0 : _a.added) || [],
+        modified: ((_b = result.changes) == null ? void 0 : _b.modified) || [],
+        removed: ((_c = result.changes) == null ? void 0 : _c.removed) || []
+      });
     }
-    return this.loadingSignals.get(this.getKeyForSelector(selector));
-  }
-  setLoading(selector, value) {
-    const signal = this.ensureSignal(selector);
-    signal.set(value);
-  }
-  /**
-   * Indicates wether a query is currently been loaded
-   * ⚡️ this function is reactive!
-   * @param selector {Object} Selector of the query
-   * @returns The loading state
-   */
-  isLoading(selector) {
-    const isPushing = this.isPushing();
-    if (!selector) {
-      return this.isFetchingSignal.get() || isPushing;
+  });
+  return createPersistenceAdapter({
+    async register(onChange) {
+      handleChange = onChange;
+      await Promise.all([slowAdapter.register(onChange), fastAdapter.register(onChange)]);
+    },
+    async load() {
+      const promise = readExecutor();
+      return promise;
+    },
+    async save(items, changes) {
+      await Promise.all([
+        fastAdapter.save(items, changes),
+        slowAdapter.save(items, changes)
+      ]);
     }
-    const signal = this.ensureSignal(selector);
-    return signal.get() || isPushing;
-  }
+  });
 }
 export {
-  AutoFetchCollection as default
+  createTemporaryFallbackExecutor,
+  combinePersistenceAdapters as default
 };

package/dist/index5.mjs

@@ -1,69 +1,6 @@
-import createPersistenceAdapter from "./index8.mjs";
-function createTemporaryFallbackExecutor(firstResolvingPromiseFunction, secondResolvingPromiseFunction, options) {
-  const cacheTimeout = options == null ? void 0 : options.cacheTimeout;
-  let isResolved = false;
-  let resolvedValue = null;
-  let timeout = null;
-  let secondaryPromise = null;
-  return (...args) => {
-    if (secondaryPromise == null) {
-      if (timeout) {
-        clearTimeout(timeout);
-        timeout = null;
-      }
-      secondaryPromise = secondResolvingPromiseFunction(...args).then((result) => {
-        {
-          timeout = setTimeout(() => {
-            isResolved = false;
-            resolvedValue = null;
-            secondaryPromise = null;
-          }, cacheTimeout);
-        }
-        isResolved = true;
-        resolvedValue = result;
-        if (options == null ? void 0 : options.onResolve)
-          options.onResolve(resolvedValue);
-        return result;
-      });
-    } else if (isResolved) {
-      return secondaryPromise;
-    }
-    return firstResolvingPromiseFunction(...args);
-  };
-}
-function combinePersistenceAdapters(slowAdapter, fastAdapter) {
-  let handleChange = null;
-  const readExecutor = createTemporaryFallbackExecutor(() => fastAdapter.load(), () => slowAdapter.load(), {
-    cacheTimeout: 100,
-    onResolve: (result) => {
-      var _a, _b, _c;
-      if (handleChange)
-        void handleChange();
-      void fastAdapter.save(result.items || [], {
-        added: ((_a = result.changes) == null ? void 0 : _a.added) || [],
-        modified: ((_b = result.changes) == null ? void 0 : _b.modified) || [],
-        removed: ((_c = result.changes) == null ? void 0 : _c.removed) || []
-      });
-    }
-  });
-  return createPersistenceAdapter({
-    async register(onChange) {
-      handleChange = onChange;
-      await Promise.all([slowAdapter.register(onChange), fastAdapter.register(onChange)]);
-    },
-    async load() {
-      const promise = readExecutor();
-      return promise;
-    },
-    async save(items, changes) {
-      await Promise.all([
-        fastAdapter.save(items, changes),
-        slowAdapter.save(items, changes)
-      ]);
-    }
-  });
+function createIndexProvider(definition) {
+  return definition;
 }
 export {
-  createTemporaryFallbackExecutor,
-  combinePersistenceAdapters as default
+  createIndexProvider as default
 };

package/dist/index6.mjs

@@ -1,6 +1,6 @@
-function createIndexProvider(definition) {
+function createMemoryAdapter(definition) {
   return definition;
 }
 export {
-  createIndexProvider as default
+  createMemoryAdapter as default
 };

package/dist/index7.mjs

@@ -1,6 +1,6 @@
-function createMemoryAdapter(definition) {
+function createPersistenceAdapter(definition) {
   return definition;
 }
 export {
-  createMemoryAdapter as default
+  createPersistenceAdapter as default
 };

package/dist/index8.mjs

@@ -1,6 +1,6 @@
-function createPersistenceAdapter(definition) {
+function createReactivityAdapter(definition) {
   return definition;
 }
 export {
-  createPersistenceAdapter as default
+  createReactivityAdapter as default
 };

package/dist/index9.mjs

@@ -1,6 +1,30 @@
-function createReactivityAdapter(definition) {
-  return definition;
+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 {
-  createReactivityAdapter as default
+  isEqual as default
 };

package/dist/types/Selector.d.ts

@@ -1,54 +1,52 @@
 export interface FieldExpression<T> {
-    $eq?: T | undefined;
-    $gt?: T | undefined;
-    $gte?: T | undefined;
-    $lt?: T | undefined;
-    $lte?: T | undefined;
+    $eq?: T;
+    $gt?: T;
+    $gte?: T;
+    $lt?: T;
+    $lte?: T;
     $in?: T[] | undefined;
-    $nin?: T[] | undefined;
-    $ne?: T | undefined;
-    $exists?: boolean | undefined;
-    $not?: FieldExpression<T> | undefined;
-    $expr?: FieldExpression<T> | undefined;
+    $nin?: T[];
+    $ne?: T;
+    $exists?: boolean;
+    $not?: FieldExpression<T>;
+    $expr?: FieldExpression<T>;
     $jsonSchema?: any;
-    $mod?: number[] | undefined;
-    $regex?: RegExp | string | undefined;
-    $options?: string | undefined;
+    $mod?: number[];
+    $regex?: RegExp | string;
+    $options?: string;
     $text?: {
         $search: string;
-        $language?: string | undefined;
-        $caseSensitive?: boolean | undefined;
-        $diacriticSensitive?: boolean | undefined;
-    } | undefined;
-    $where?: string | ((item: T) => boolean) | undefined;
-    $all?: T[] | undefined;
-    $elemMatch?: T extends object ? Query<T> : FieldExpression<T> | undefined;
-    $size?: number | undefined;
+        $language?: string;
+        $caseSensitive?: boolean;
+        $diacriticSensitive?: boolean;
+    };
+    $where?: string | ((item: T) => boolean);
+    $all?: T[];
+    $elemMatch?: T extends object ? Query<T> : FieldExpression<T>;
+    $size?: number;
     $bitsAllClear?: any;
     $bitsAllSet?: any;
     $bitsAnyClear?: any;
     $bitsAnySet?: any;
 }
-type IsObject<T> = T extends object ? (T extends Array<any> ? false : true) : false;
-type DotNotationKeys<T> = {
-    [K in keyof T & (string | number)]: T[K] extends Array<infer U> ? `${K}` | `${K}.$` | `${K}.${DotNotationKeys<U>}` : IsObject<T[K]> extends true ? `${K}` | `${K}.${DotNotationKeys<T[K]>}` : `${K}`;
-}[keyof T & (string | number)];
-type Split<S extends string, Delimiter extends string> = S extends `${infer Head}${Delimiter}${infer Tail}` ? [Head, ...Split<Tail, Delimiter>] : [S];
-type GetTypeByParts<T, Parts extends readonly string[]> = Parts extends [infer Head, ...infer Tail] ? Head extends keyof T ? GetTypeByParts<T[Head], Extract<Tail, string[]>> : Head extends '$' ? T extends Array<infer U> ? GetTypeByParts<U, Extract<Tail, string[]>> : never : never : T;
-type Get<T, Path extends string> = GetTypeByParts<T, Split<Path, '.'>>;
-type Flatten<T> = T extends any[] ? T[0] : T;
+type DotNotation<T> = {
+    [K in keyof T & string]: T[K] extends Array<infer U> ? `${K}` | `${K}.$` | `${K}.${DotNotation<U>}` : T[K] extends object ? `${K}` | `${K}.${DotNotation<T[K]>}` : `${K}`;
+}[keyof T & string];
+type GetType<T, P extends string> = P extends `${infer H}.${infer R}` ? H extends keyof T ? T[H] extends Array<infer U> ? GetType<U, R> : GetType<T[H], R> : H extends '$' ? T extends Array<infer U> ? GetType<U, R> : never : never : P extends keyof T ? T[P] : never;
 type FlatQuery<T> = {
-    [P in DotNotationKeys<T>]?: Flatten<Get<T, P>> | RegExp | FieldExpression<Flatten<Get<T, P>>>;
+    [P in DotNotation<T>]?: FlatQueryValue<T, P>;
 };
+type FieldValue<U> = U extends string ? string | RegExp | FieldExpression<string> : U | FieldExpression<U>;
+type FlatQueryValue<T, P extends string> = GetType<T, P> extends never ? never : GetType<T, P> extends Array<infer U> ? FieldValue<U> | FieldValue<U[]> : FieldValue<GetType<T, P>>;
 type Query<T> = FlatQuery<T> & {
-    $or?: Query<T>[] | undefined;
-    $and?: Query<T>[] | undefined;
-    $nor?: Query<T>[] | undefined;
+    $or?: Query<T>[];
+    $and?: Query<T>[];
+    $nor?: Query<T>[];
 };
-export type FlatSelector<T extends Record<string, any> = Record<string, any>> = FlatQuery<T> & {
+export type FlatSelector<T extends Record<string, any>> = FlatQuery<T> & {
     $or?: never;
     $and?: never;
     $nor?: never;
 };
-type Selector<T extends Record<string, any> = Record<string, any>> = Query<T>;
+type Selector<T extends Record<string, any>> = Query<T>;
 export default Selector;

package/dist/utils/getMatchingKeys.d.ts

@@ -1,14 +1,19 @@
 import type { BaseItem } from '../Collection/types';
 import type { FlatSelector } from '../types/Selector';
+type KeyResult = {
+    include: string[] | null;
+    exclude: string[] | null;
+};
 /**
- * Extracts the matching keys for a given field in a selector.
- * Supports serialized values and `$in` field expressions for optimization.
- * Returns `null` if the field cannot be optimized.
+ * 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 array of serialized matching keys for the field, or `null` if the field
- *   cannot be optimized (e.g., if it's a `RegExp` or non-optimizable field expression).
+ * @returns An object containing arrays of serialized included and excluded keys,
+ *   or `null` if the field cannot be optimized.
  */
-export default function getMatchingKeys<T extends BaseItem<I> = BaseItem, I = any>(field: string, selector: FlatSelector<T>): string[] | null;
+export default function getMatchingKeys<T extends BaseItem<I> = BaseItem, I = any>(field: string, selector: FlatSelector<T>): KeyResult;
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@signaldb/core",
-  "version": "1.2.3",
+  "version": "1.3.0",
   "description": "SignalDB is a client-side database that provides a simple MongoDB-like interface to the data with first-class typescript support to achieve an optimistic UI. Data persistence can be achieved by using storage providers that store the data through a JSON interface to places such as localStorage.",
   "scripts": {
     "build": "rimraf dist && vite build"

package/dist/devtools.d.ts

@@ -1,4 +0,0 @@
-/**
- * Loads the devtools in production mode and logs a warning if in production.
- */
-export default function loadDeveloperTools(): void;

package/dist/index.cjs30.js

@@ -1,29 +0,0 @@
-"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;
-}
-module.exports = set;

package/dist/index.cjs31.js

@@ -1,9 +0,0 @@
-"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);
-  });
-}
-module.exports = uniqueBy;

package/dist/index30.mjs

@@ -1,30 +0,0 @@
-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 {
-  set as default
-};

package/dist/index31.mjs

@@ -1,10 +0,0 @@
-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);
-  });
-}
-export {
-  uniqueBy as default
-};