@signaldb/core 1.1.0 → 1.2.1

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.cjs2.js

@@ -1,26 +1,4 @@
 "use strict";
-var __create = Object.create;
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
-  // If the importer is in node compatibility mode or this is not an ESM
-  // file that has been converted to a CommonJS file using a Babel-
-  // compatible transform (i.e. "__esModule" has not been set), then set
-  // "default" to the CommonJS "module.exports" for node compatibility.
-  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
-  mod
-));
 const index = require("./index.cjs3.js");
 var _documentCurrentScript = typeof document !== "undefined" ? document.currentScript : null;
 const _interopNamespaceDefaultOnly = (e) => Object.freeze(Object.defineProperty({ __proto__: null, default: e }, Symbol.toStringTag, { value: "Module" }));
@@ -35,6 +13,7 @@ Please move @signaldb/devtools to development dependencies to disable it in prod
 
 
 `;
+const packageName = "@signaldb/devtools";
 function isNodeErrorWithCode(error) {
   return typeof error === "object" && error !== null && "code" in error && typeof error.code === "string";
 }
@@ -47,14 +26,17 @@ async function checkDevtoolsAvailability() {
   }
   if (isCommonJS()) {
     try {
-      require.resolve("@signaldb/devtools");
+      require.resolve(packageName);
       return true;
     } catch {
       return false;
     }
   }
   try {
-    await import("@signaldb/devtools");
+    await import(
+      /* @vite-ignore */
+      packageName
+    );
     return true;
   } catch (error) {
     if (!isNodeErrorWithCode(error) || error.code !== "MODULE_NOT_FOUND") {
@@ -65,7 +47,7 @@ async function checkDevtoolsAvailability() {
     const modulePackage = await Promise.resolve().then(() => /* @__PURE__ */ _interopNamespaceDefaultOnly(require("./index.cjs15.js")));
     const createRequireFunction = modulePackage.default.createRequire;
     const cjsRequire = createRequireFunction(typeof document === "undefined" ? require("url").pathToFileURL(__filename).href : _documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === "SCRIPT" && _documentCurrentScript.src || new URL("index.cjs2.js", document.baseURI).href);
-    cjsRequire.resolve("@signaldb/devtools");
+    cjsRequire.resolve(packageName);
     return true;
   } catch {
     return false;
@@ -77,7 +59,7 @@ async function checkAndImportDevtools() {
     return false;
   if (isCommonJS()) {
     try {
-      require("@signaldb/devtools");
+      require(packageName);
       return true;
     } catch (error) {
       if (isNodeErrorWithCode(error) && error.code === "MODULE_NOT_FOUND") {
@@ -87,7 +69,10 @@ async function checkAndImportDevtools() {
     }
   }
   try {
-    await import("@signaldb/devtools");
+    await import(
+      /* @vite-ignore */
+      packageName
+    );
     return true;
   } catch (error) {
     if (!isNodeErrorWithCode(error) || error.code !== "MODULE_NOT_FOUND") {
@@ -98,7 +83,7 @@ async function checkAndImportDevtools() {
     const modulePackage = await Promise.resolve().then(() => /* @__PURE__ */ _interopNamespaceDefaultOnly(require("./index.cjs15.js")));
     const createRequireFunction = modulePackage.default.createRequire;
     const cjsRequire = createRequireFunction(typeof document === "undefined" ? require("url").pathToFileURL(__filename).href : _documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === "SCRIPT" && _documentCurrentScript.src || new URL("index.cjs2.js", document.baseURI).href);
-    cjsRequire("@signaldb/devtools");
+    cjsRequire(packageName);
     return true;
   } catch (error) {
     if (isNodeErrorWithCode(error) && error.code === "MODULE_NOT_FOUND") {

package/dist/index.cjs28.js

@@ -2,22 +2,26 @@
 const isFieldExpression = require("./index.cjs29.js");
 const serializeValue = require("./index.cjs18.js");
 function getMatchingKeys(field, selector) {
-  if (selector[field] instanceof RegExp)
+  const fieldSelector = selector[field];
+  if (fieldSelector instanceof RegExp)
     return null;
-  if (selector[field] != null) {
-    if (isFieldExpression(selector[field])) {
-      const is$in = isFieldExpression(selector[field]) && Array.isArray(selector[field].$in) && selector[field].$in.length > 0;
+  if (fieldSelector != null) {
+    if (isFieldExpression(fieldSelector)) {
+      const is$in = isFieldExpression(fieldSelector) && Array.isArray(fieldSelector.$in) && fieldSelector.$in.length > 0;
       if (is$in) {
-        const optimizedSelector = { ...selector, [field]: { ...selector[field] } };
+        const optimizedSelector = {
+          ...selector,
+          [field]: { ...fieldSelector }
+        };
         delete optimizedSelector[field].$in;
         if (Object.keys(optimizedSelector[field]).length === 0) {
           delete optimizedSelector[field];
         }
-        return selector[field].$in.map(serializeValue);
+        return fieldSelector.$in.map(serializeValue);
       }
       return null;
     }
-    return [serializeValue(selector[field])];
+    return [serializeValue(fieldSelector)];
   }
   return null;
 }

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/index2.mjs

@@ -10,6 +10,7 @@ Please move @signaldb/devtools to development dependencies to disable it in prod
 
 
 `;
+const packageName = "@signaldb/devtools";
 function isNodeErrorWithCode(error) {
   return typeof error === "object" && error !== null && "code" in error && typeof error.code === "string";
 }
@@ -22,14 +23,17 @@ async function checkDevtoolsAvailability() {
   }
   if (isCommonJS()) {
     try {
-      require.resolve("@signaldb/devtools");
+      require.resolve(packageName);
       return true;
     } catch {
       return false;
     }
   }
   try {
-    await import("@signaldb/devtools");
+    await import(
+      /* @vite-ignore */
+      packageName
+    );
     return true;
   } catch (error) {
     if (!isNodeErrorWithCode(error) || error.code !== "MODULE_NOT_FOUND") {
@@ -40,7 +44,7 @@ async function checkDevtoolsAvailability() {
     const modulePackage = await import("./index15.mjs");
     const createRequireFunction = modulePackage.default.createRequire;
     const cjsRequire = createRequireFunction(import.meta.url);
-    cjsRequire.resolve("@signaldb/devtools");
+    cjsRequire.resolve(packageName);
     return true;
   } catch {
     return false;
@@ -52,7 +56,7 @@ async function checkAndImportDevtools() {
     return false;
   if (isCommonJS()) {
     try {
-      require("@signaldb/devtools");
+      require(packageName);
       return true;
     } catch (error) {
       if (isNodeErrorWithCode(error) && error.code === "MODULE_NOT_FOUND") {
@@ -62,7 +66,10 @@ async function checkAndImportDevtools() {
     }
   }
   try {
-    await import("@signaldb/devtools");
+    await import(
+      /* @vite-ignore */
+      packageName
+    );
     return true;
   } catch (error) {
     if (!isNodeErrorWithCode(error) || error.code !== "MODULE_NOT_FOUND") {
@@ -73,7 +80,7 @@ async function checkAndImportDevtools() {
     const modulePackage = await import("./index15.mjs");
     const createRequireFunction = modulePackage.default.createRequire;
     const cjsRequire = createRequireFunction(import.meta.url);
-    cjsRequire("@signaldb/devtools");
+    cjsRequire(packageName);
     return true;
   } catch (error) {
     if (isNodeErrorWithCode(error) && error.code === "MODULE_NOT_FOUND") {

package/dist/index28.mjs

@@ -1,22 +1,26 @@
 import isFieldExpression from "./index29.mjs";
 import serializeValue from "./index18.mjs";
 function getMatchingKeys(field, selector) {
-  if (selector[field] instanceof RegExp)
+  const fieldSelector = selector[field];
+  if (fieldSelector instanceof RegExp)
     return null;
-  if (selector[field] != null) {
-    if (isFieldExpression(selector[field])) {
-      const is$in = isFieldExpression(selector[field]) && Array.isArray(selector[field].$in) && selector[field].$in.length > 0;
+  if (fieldSelector != null) {
+    if (isFieldExpression(fieldSelector)) {
+      const is$in = isFieldExpression(fieldSelector) && Array.isArray(fieldSelector.$in) && fieldSelector.$in.length > 0;
       if (is$in) {
-        const optimizedSelector = { ...selector, [field]: { ...selector[field] } };
+        const optimizedSelector = {
+          ...selector,
+          [field]: { ...fieldSelector }
+        };
         delete optimizedSelector[field].$in;
         if (Object.keys(optimizedSelector[field]).length === 0) {
           delete optimizedSelector[field];
         }
-        return selector[field].$in.map(serializeValue);
+        return fieldSelector.$in.map(serializeValue);
       }
       return null;
     }
-    return [serializeValue(selector[field])];
+    return [serializeValue(fieldSelector)];
   }
   return null;
 }

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/dist/types/Selector.d.ts

@@ -29,10 +29,17 @@ export interface FieldExpression<T> {
     $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 FlatQuery<T> = {
-    [P in keyof T]?: Flatten<T[P]> | RegExp | FieldExpression<Flatten<T[P]>>;
-} & Record<string, any>;
+    [P in DotNotationKeys<T>]?: Flatten<Get<T, P>> | RegExp | FieldExpression<Flatten<Get<T, P>>>;
+};
 type Query<T> = FlatQuery<T> & {
     $or?: Query<T>[] | undefined;
     $and?: Query<T>[] | undefined;

package/package.json

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