@signaldb/core 1.4.0 → 1.5.1

package/dist/Collection/index.d.ts

@@ -44,6 +44,7 @@ interface CollectionEvents<T extends BaseItem, U = T> {
     'replaceOne': (selector: Selector<T>, item: Omit<T, 'id'> & Partial<Pick<T, 'id'>>) => void;
     'removeOne': (selector: Selector<T>) => void;
     'removeMany': (selector: Selector<T>) => void;
+    'validate': (item: T) => void;
     '_debug.getItems': (callstack: string, selector: Selector<T> | undefined, measuredTime: number) => void;
     '_debug.find': <O extends FindOptions<T>>(callstack: string, selector: Selector<T> | undefined, options: O | undefined, cursor: Cursor<T, U>) => void;
     '_debug.findOne': <O extends FindOptions<T>>(callstack: string, selector: Selector<T>, options: O | undefined, item: U | undefined) => void;

package/dist/index.cjs17.js

@@ -1,9 +1,15 @@
 "use strict";
-function createSignal(dependency, initialValue, isEqual = Object.is) {
+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)
+      if (dependency && isInReactiveScope())
         dependency.depend();
       return value;
     },

package/dist/index.cjs2.js

@@ -54,7 +54,6 @@ const _Collection = class _Collection extends EventEmitter {
    * @param options.fieldTracking - A boolean to enable or disable field tracking by default.
    */
   constructor(options) {
-    var _a, _b;
     super();
     __publicField(this, "name");
     __publicField(this, "options");
@@ -83,8 +82,8 @@ const _Collection = class _Collection extends EventEmitter {
       ...this.options.indices || []
     ];
     this.rebuildIndices();
-    this.isPullingSignal = createSignal((_a = this.options.reactivity) == null ? void 0 : _a.create(), !!(options == null ? void 0 : options.persistence));
-    this.isPushingSignal = createSignal((_b = this.options.reactivity) == null ? void 0 : _b.create(), false);
+    this.isPullingSignal = createSignal(this.options.reactivity, !!(options == null ? void 0 : options.persistence));
+    this.isPushingSignal = createSignal(this.options.reactivity, false);
     this.on("persistence.pullStarted", () => {
       this.isPullingSignal.set(true);
     });
@@ -530,6 +529,7 @@ const _Collection = class _Collection extends EventEmitter {
     if (!item)
       throw new Error("Invalid item");
     const newItem = { id: randomId(), ...item };
+    this.emit("validate", newItem);
     if (this.idIndex.has(serializeValue(newItem.id)))
       throw new Error("Item with same id already exists");
     this.memory().push(newItem);
@@ -600,6 +600,7 @@ const _Collection = class _Collection extends EventEmitter {
       if (item.id !== modifiedItem.id && this.getItemAndIndex({ id: modifiedItem.id }).item != null) {
         throw new Error("Item with same id already exists");
       }
+      this.emit("validate", modifiedItem);
       this.memory().splice(index, 1, modifiedItem);
       this.rebuildIndices();
       this.emit("changed", modifiedItem, restModifier);
@@ -649,6 +650,7 @@ const _Collection = class _Collection extends EventEmitter {
       if (item.id !== modifiedItem.id && this.getItemAndIndex({ id: modifiedItem.id }).item != null) {
         throw new Error(`Item with same id '${modifiedItem.id}' already exists`);
       }
+      this.emit("validate", modifiedItem);
       return {
         item: modifiedItem,
         index
@@ -692,6 +694,7 @@ const _Collection = class _Collection extends EventEmitter {
         throw new Error("Item with same id already exists");
       }
       const modifiedItem = { id: item.id, ...replacement };
+      this.emit("validate", modifiedItem);
       this.memory().splice(index, 1, modifiedItem);
       this.rebuildIndices();
       this.emit("changed", modifiedItem, replacement);

package/dist/index.cjs20.js

@@ -38,7 +38,6 @@ class ReplicatedCollection extends index.default {
    * @param options.enableDebugMode - A boolean to enable or disable debug mode.
    */
   constructor(options) {
-    var _a, _b;
     const replicationAdapter = createReplicationAdapter({
       registerRemoteChange: options.registerRemoteChange,
       pull: async () => {
@@ -67,8 +66,8 @@ class ReplicatedCollection extends index.default {
     });
     __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);
+    this.isPullingRemoteSignal = createSignal(options.reactivity, false);
+    this.isPushingRemoteSignal = createSignal(options.reactivity, false);
   }
   /**
    * Checks whether the collection is currently performing any loading operation,

package/dist/index.cjs3.js

@@ -11,7 +11,6 @@ class AutoFetchCollection extends ReplicatedCollection.default {
    * @param options.purgeDelay {Number} - The delay in milliseconds before purging an item from the cache.
    */
   constructor(options) {
-    var _a;
     let triggerRemoteChange;
     super({
       ...options,
@@ -46,7 +45,7 @@ class AutoFetchCollection extends ReplicatedCollection.default {
     __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);
+    this.isFetchingSignal = createSignal(options.reactivity, false);
     if (!triggerRemoteChange)
       throw new Error("No triggerRemoteChange method found. Looks like your persistence adapter was not registered");
     this.triggerReload = triggerRemoteChange;
@@ -147,7 +146,7 @@ class AutoFetchCollection extends ReplicatedCollection.default {
     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));
+      this.loadingSignals.set(this.getKeyForSelector(selector), createSignal(this.reactivityAdapter, false));
     }
     return this.loadingSignals.get(this.getKeyForSelector(selector));
   }

package/dist/index.d.ts

@@ -3,7 +3,7 @@ export type { default as MemoryAdapter } from './types/MemoryAdapter';
 export type { default as PersistenceAdapter, Changeset, LoadResponse, } from './types/PersistenceAdapter';
 export type { default as Selector } from './types/Selector';
 export type { default as Modifier } from './types/Modifier';
-export type { BaseItem, ObserveCallbacks, CursorOptions, Transform, SortSpecifier, FieldSpecifier, FindOptions, } from './Collection';
+export type { BaseItem, ObserveCallbacks, CursorOptions, Transform, SortSpecifier, FieldSpecifier, FindOptions, CollectionOptions, } from './Collection';
 export { default as Collection, createIndex } from './Collection';
 export { default as AutoFetchCollection } from './AutoFetchCollection';
 export { default as combinePersistenceAdapters } from './persistence/combinePersistenceAdapters';

package/dist/index17.mjs

@@ -1,8 +1,14 @@
-function createSignal(dependency, initialValue, isEqual = Object.is) {
+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)
+      if (dependency && isInReactiveScope())
         dependency.depend();
       return value;
     },

package/dist/index2.mjs

@@ -53,7 +53,6 @@ const _Collection = class _Collection extends EventEmitter {
    * @param options.fieldTracking - A boolean to enable or disable field tracking by default.
    */
   constructor(options) {
-    var _a, _b;
     super();
     __publicField(this, "name");
     __publicField(this, "options");
@@ -82,8 +81,8 @@ const _Collection = class _Collection extends EventEmitter {
       ...this.options.indices || []
     ];
     this.rebuildIndices();
-    this.isPullingSignal = createSignal((_a = this.options.reactivity) == null ? void 0 : _a.create(), !!(options == null ? void 0 : options.persistence));
-    this.isPushingSignal = createSignal((_b = this.options.reactivity) == null ? void 0 : _b.create(), false);
+    this.isPullingSignal = createSignal(this.options.reactivity, !!(options == null ? void 0 : options.persistence));
+    this.isPushingSignal = createSignal(this.options.reactivity, false);
     this.on("persistence.pullStarted", () => {
       this.isPullingSignal.set(true);
     });
@@ -529,6 +528,7 @@ const _Collection = class _Collection extends EventEmitter {
     if (!item)
       throw new Error("Invalid item");
     const newItem = { id: randomId(), ...item };
+    this.emit("validate", newItem);
     if (this.idIndex.has(serializeValue(newItem.id)))
       throw new Error("Item with same id already exists");
     this.memory().push(newItem);
@@ -599,6 +599,7 @@ const _Collection = class _Collection extends EventEmitter {
       if (item.id !== modifiedItem.id && this.getItemAndIndex({ id: modifiedItem.id }).item != null) {
         throw new Error("Item with same id already exists");
       }
+      this.emit("validate", modifiedItem);
       this.memory().splice(index, 1, modifiedItem);
       this.rebuildIndices();
       this.emit("changed", modifiedItem, restModifier);
@@ -648,6 +649,7 @@ const _Collection = class _Collection extends EventEmitter {
       if (item.id !== modifiedItem.id && this.getItemAndIndex({ id: modifiedItem.id }).item != null) {
         throw new Error(`Item with same id '${modifiedItem.id}' already exists`);
       }
+      this.emit("validate", modifiedItem);
       return {
         item: modifiedItem,
         index
@@ -691,6 +693,7 @@ const _Collection = class _Collection extends EventEmitter {
         throw new Error("Item with same id already exists");
       }
       const modifiedItem = { id: item.id, ...replacement };
+      this.emit("validate", modifiedItem);
       this.memory().splice(index, 1, modifiedItem);
       this.rebuildIndices();
       this.emit("changed", modifiedItem, replacement);

package/dist/index20.mjs

@@ -36,7 +36,6 @@ class ReplicatedCollection extends Collection {
    * @param options.enableDebugMode - A boolean to enable or disable debug mode.
    */
   constructor(options) {
-    var _a, _b;
     const replicationAdapter = createReplicationAdapter({
       registerRemoteChange: options.registerRemoteChange,
       pull: async () => {
@@ -65,8 +64,8 @@ class ReplicatedCollection extends Collection {
     });
     __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);
+    this.isPullingRemoteSignal = createSignal(options.reactivity, false);
+    this.isPushingRemoteSignal = createSignal(options.reactivity, false);
   }
   /**
    * Checks whether the collection is currently performing any loading operation,

package/dist/index3.mjs

@@ -10,7 +10,6 @@ class AutoFetchCollection extends ReplicatedCollection {
    * @param options.purgeDelay {Number} - The delay in milliseconds before purging an item from the cache.
    */
   constructor(options) {
-    var _a;
     let triggerRemoteChange;
     super({
       ...options,
@@ -45,7 +44,7 @@ class AutoFetchCollection extends ReplicatedCollection {
     __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);
+    this.isFetchingSignal = createSignal(options.reactivity, false);
     if (!triggerRemoteChange)
       throw new Error("No triggerRemoteChange method found. Looks like your persistence adapter was not registered");
     this.triggerReload = triggerRemoteChange;
@@ -146,7 +145,7 @@ class AutoFetchCollection extends ReplicatedCollection {
     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));
+      this.loadingSignals.set(this.getKeyForSelector(selector), createSignal(this.reactivityAdapter, false));
     }
     return this.loadingSignals.get(this.getKeyForSelector(selector));
   }

package/dist/utils/createSignal.d.ts

@@ -1,14 +1,14 @@
-import type Dependency from '../types/Dependency';
+import type ReactivityAdapter from '../types/ReactivityAdapter';
 import type 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,
  * with optional equality checks and dependency tracking.
  * @template T - The type of the value held by the signal.
- * @param dependency - An optional dependency object for tracking and notifying reactivity.
+ * @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.
  */
-export default function createSignal<T>(dependency: Dependency | undefined, initialValue: T, isEqual?: (a: T, b: T) => boolean): Signal<T>;
+export default function createSignal<T>(reactivityAdapter: ReactivityAdapter | undefined, initialValue: T, isEqual?: (a: T, b: T) => boolean): Signal<T>;

package/package.json

@@ -1,9 +1,10 @@
 {
   "name": "@signaldb/core",
-  "version": "1.4.0",
+  "version": "1.5.1",
   "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"
+    "build": "rimraf dist && vite build",
+    "test": "vitest"
   },
   "repository": {
     "type": "git",
@@ -54,5 +55,8 @@
   "dependencies": {
     "fast-sort": "^3.4.1",
     "mingo": "^6.5.1"
+  },
+  "devDependencies": {
+    "zod": "^3.24.2"
   }
 }