@signaldb/core 1.1.0 → 1.2.0

package/dist/Collection/index.d.ts

@@ -100,6 +100,7 @@ export default class Collection<T extends BaseItem<I> = BaseItem, I = any, U = T
     private isDisposed;
     private postBatchCallbacks;
     private fieldTracking;
+    private persistenceReadyPromise;
     /**
      * Initializes a new instance of the `Collection` class with optional configuration.
      * Sets up memory, persistence, reactivity, and indices as specified in the options.
@@ -154,6 +155,20 @@ export default class Collection<T extends BaseItem<I> = BaseItem, I = any, U = T
      * @param enable - A boolean indicating whether to enable (`true`) or disable (`false`) field tracking.
      */
     setFieldTracking(enable: boolean): void;
+    /**
+     * Resolves when the persistence adapter finished initializing
+     * and the collection is ready to be used.
+     * @returns A promise that resolves when the collection is ready.
+     * @example
+     * ```ts
+     * const collection = new Collection({
+     *   persistence: // ...
+     * })
+     * await collection.isReady()
+     *
+     * collection.insert({ name: 'Item 1' })
+     */
+    isReady(): Promise<void>;
     private profile;
     private executeInDebugMode;
     private rebuildIndices;

package/dist/index.cjs.js

@@ -13,7 +13,10 @@ const modify = require("./index.cjs11.js");
 const randomId = require("./index.cjs12.js");
 const EventEmitter = require("./index.cjs13.js");
 const createIndex = require("./index.cjs14.js");
-devtools();
+/* istanbul ignore if -- @preserve */
+if (process.env.NODE_ENV !== "production") {
+  devtools();
+}
 exports.loadDeveloperTools = devtools;
 exports.Collection = index.default;
 exports.AutoFetchCollection = AutoFetchCollection;

package/dist/index.cjs3.js

@@ -69,6 +69,7 @@ const _Collection = class _Collection extends EventEmitter {
     __publicField(this, "isDisposed", false);
     __publicField(this, "postBatchCallbacks", /* @__PURE__ */ new Set());
     __publicField(this, "fieldTracking", false);
+    __publicField(this, "persistenceReadyPromise");
     _Collection.collections.push(this);
     this.name = (options == null ? void 0 : options.name) ?? `${this.constructor.name}-${randomId()}`;
     this.options = {
@@ -221,6 +222,12 @@ const _Collection = class _Collection extends EventEmitter {
         this.emit("persistence.error", error instanceof Error ? error : new Error(error));
       });
     }
+    this.persistenceReadyPromise = new Promise((resolve, reject) => {
+      if (!this.persistenceAdapter)
+        return resolve();
+      this.once("persistence.init", resolve);
+      this.once("persistence.error", reject);
+    });
     _Collection.onCreationCallbacks.forEach((callback) => callback(this));
   }
   static getCollections() {
@@ -295,6 +302,22 @@ const _Collection = class _Collection extends EventEmitter {
   setFieldTracking(enable) {
     this.fieldTracking = enable;
   }
+  /**
+   * Resolves when the persistence adapter finished initializing
+   * and the collection is ready to be used.
+   * @returns A promise that resolves when the collection is ready.
+   * @example
+   * ```ts
+   * const collection = new Collection({
+   *   persistence: // ...
+   * })
+   * await collection.isReady()
+   *
+   * collection.insert({ name: 'Item 1' })
+   */
+  async isReady() {
+    return this.persistenceReadyPromise;
+  }
   profile(fn, measureFunction) {
     if (!this.debugMode)
       return fn();
@@ -346,7 +369,8 @@ const _Collection = class _Collection extends EventEmitter {
     const indexInfo = this.getIndexInfo(selector);
     const items = indexInfo.matched ? indexInfo.positions.map((index2) => memory[index2]) : memory;
     const item = items.find((document) => match(document, selector));
-    const index = indexInfo.matched && indexInfo.positions.find((itemIndex) => memory[itemIndex] === item) || memory.findIndex((document) => document === item);
+    const foundInIndex = indexInfo.matched && indexInfo.positions.find((itemIndex) => memory[itemIndex] === item);
+    const index = foundInIndex || memory.findIndex((document) => document === item);
     if (item == null)
       return { item: null, index: -1 };
     if (index === -1)

package/dist/index.mjs

@@ -11,7 +11,10 @@ import { default as default10 } from "./index11.mjs";
 import { default as default11 } from "./index12.mjs";
 import { default as default12 } from "./index13.mjs";
 import { default as default13 } from "./index14.mjs";
-loadDeveloperTools();
+/* istanbul ignore if -- @preserve */
+if (process.env.NODE_ENV !== "production") {
+  loadDeveloperTools();
+}
 export {
   default3 as AutoFetchCollection,
   default2 as Collection,

package/dist/index3.mjs

@@ -68,6 +68,7 @@ const _Collection = class _Collection extends EventEmitter {
     __publicField(this, "isDisposed", false);
     __publicField(this, "postBatchCallbacks", /* @__PURE__ */ new Set());
     __publicField(this, "fieldTracking", false);
+    __publicField(this, "persistenceReadyPromise");
     _Collection.collections.push(this);
     this.name = (options == null ? void 0 : options.name) ?? `${this.constructor.name}-${randomId()}`;
     this.options = {
@@ -220,6 +221,12 @@ const _Collection = class _Collection extends EventEmitter {
         this.emit("persistence.error", error instanceof Error ? error : new Error(error));
       });
     }
+    this.persistenceReadyPromise = new Promise((resolve, reject) => {
+      if (!this.persistenceAdapter)
+        return resolve();
+      this.once("persistence.init", resolve);
+      this.once("persistence.error", reject);
+    });
     _Collection.onCreationCallbacks.forEach((callback) => callback(this));
   }
   static getCollections() {
@@ -294,6 +301,22 @@ const _Collection = class _Collection extends EventEmitter {
   setFieldTracking(enable) {
     this.fieldTracking = enable;
   }
+  /**
+   * Resolves when the persistence adapter finished initializing
+   * and the collection is ready to be used.
+   * @returns A promise that resolves when the collection is ready.
+   * @example
+   * ```ts
+   * const collection = new Collection({
+   *   persistence: // ...
+   * })
+   * await collection.isReady()
+   *
+   * collection.insert({ name: 'Item 1' })
+   */
+  async isReady() {
+    return this.persistenceReadyPromise;
+  }
   profile(fn, measureFunction) {
     if (!this.debugMode)
       return fn();
@@ -345,7 +368,8 @@ const _Collection = class _Collection extends EventEmitter {
     const indexInfo = this.getIndexInfo(selector);
     const items = indexInfo.matched ? indexInfo.positions.map((index2) => memory[index2]) : memory;
     const item = items.find((document) => match(document, selector));
-    const index = indexInfo.matched && indexInfo.positions.find((itemIndex) => memory[itemIndex] === item) || memory.findIndex((document) => document === item);
+    const foundInIndex = indexInfo.matched && indexInfo.positions.find((itemIndex) => memory[itemIndex] === item);
+    const index = foundInIndex || memory.findIndex((document) => document === item);
     if (item == null)
       return { item: null, index: -1 };
     if (index === -1)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@signaldb/core",
-  "version": "1.1.0",
+  "version": "1.2.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"