@signaldb/core 2.0.0-beta.4 → 2.0.0-beta.6

package/dist/.vite/manifest.json

@@ -1,6 +1,6 @@
 {
   "src/AsyncDataAdapter.ts": {
-    "file": "index.cjs13.js",
+    "file": "index.cjs14.js",
     "name": "AsyncDataAdapter",
     "src": "src/AsyncDataAdapter.ts",
     "imports": [
@@ -16,7 +16,7 @@
     ]
   },
   "src/AutoFetchDataAdapter.ts": {
-    "file": "index.cjs16.js",
+    "file": "index.cjs17.js",
     "name": "AutoFetchDataAdapter",
     "src": "src/AutoFetchDataAdapter.ts",
     "imports": [
@@ -40,7 +40,7 @@
     ]
   },
   "src/Collection/Observer.ts": {
-    "file": "index.cjs17.js",
+    "file": "index.cjs18.js",
     "name": "Collection/Observer",
     "src": "src/Collection/Observer.ts",
     "imports": [
@@ -64,7 +64,7 @@
     ]
   },
   "src/DefaultDataAdapter.ts": {
-    "file": "index.cjs12.js",
+    "file": "index.cjs13.js",
     "name": "DefaultDataAdapter",
     "src": "src/DefaultDataAdapter.ts",
     "imports": [
@@ -82,7 +82,7 @@
     ]
   },
   "src/WorkerDataAdapter.ts": {
-    "file": "index.cjs14.js",
+    "file": "index.cjs15.js",
     "name": "WorkerDataAdapter",
     "src": "src/WorkerDataAdapter.ts",
     "imports": [
@@ -92,7 +92,7 @@
     ]
   },
   "src/WorkerDataAdapterHost.ts": {
-    "file": "index.cjs15.js",
+    "file": "index.cjs16.js",
     "name": "WorkerDataAdapterHost",
     "src": "src/WorkerDataAdapterHost.ts",
     "imports": [
@@ -109,7 +109,7 @@
     ]
   },
   "src/createIndex.ts": {
-    "file": "index.cjs21.js",
+    "file": "index.cjs22.js",
     "name": "createIndex",
     "src": "src/createIndex.ts",
     "imports": [
@@ -120,7 +120,7 @@
     ]
   },
   "src/createIndexProvider.ts": {
-    "file": "index.cjs30.js",
+    "file": "index.cjs34.js",
     "name": "createIndexProvider",
     "src": "src/createIndexProvider.ts"
   },
@@ -135,7 +135,7 @@
     "src": "src/createStorageAdapter.ts"
   },
   "src/getIndexInfo.ts": {
-    "file": "index.cjs22.js",
+    "file": "index.cjs23.js",
     "name": "getIndexInfo",
     "src": "src/getIndexInfo.ts",
     "imports": [
@@ -158,6 +158,7 @@
       "src/utils/EventEmitter.ts",
       "src/utils/get.ts",
       "src/utils/serializeValue.ts",
+      "src/utils/reactiveOrAsync.ts",
       "src/DefaultDataAdapter.ts",
       "src/AsyncDataAdapter.ts",
       "src/WorkerDataAdapter.ts",
@@ -171,22 +172,22 @@
     "src": "src/utils/EventEmitter.ts"
   },
   "src/utils/batchOnNextTick.ts": {
-    "file": "index.cjs27.js",
+    "file": "index.cjs28.js",
     "name": "utils/batchOnNextTick",
     "src": "src/utils/batchOnNextTick.ts"
   },
   "src/utils/compact.ts": {
-    "file": "index.cjs28.js",
+    "file": "index.cjs29.js",
     "name": "utils/compact",
     "src": "src/utils/compact.ts"
   },
   "src/utils/createSignal.ts": {
-    "file": "index.cjs18.js",
+    "file": "index.cjs19.js",
     "name": "utils/createSignal",
     "src": "src/utils/createSignal.ts"
   },
   "src/utils/deepClone.ts": {
-    "file": "index.cjs19.js",
+    "file": "index.cjs20.js",
     "name": "utils/deepClone",
     "src": "src/utils/deepClone.ts"
   },
@@ -196,7 +197,7 @@
     "src": "src/utils/get.ts"
   },
   "src/utils/getMatchingKeys.ts": {
-    "file": "index.cjs26.js",
+    "file": "index.cjs27.js",
     "name": "utils/getMatchingKeys",
     "src": "src/utils/getMatchingKeys.ts",
     "imports": [
@@ -215,12 +216,12 @@
     "src": "src/utils/isEqual.ts"
   },
   "src/utils/isFieldExpression.ts": {
-    "file": "index.cjs33.js",
+    "file": "index.cjs32.js",
     "name": "utils/isFieldExpression",
     "src": "src/utils/isFieldExpression.ts"
   },
   "src/utils/match.ts": {
-    "file": "index.cjs23.js",
+    "file": "index.cjs24.js",
     "name": "utils/match",
     "src": "src/utils/match.ts"
   },
@@ -233,7 +234,7 @@
     ]
   },
   "src/utils/project.ts": {
-    "file": "index.cjs24.js",
+    "file": "index.cjs25.js",
     "name": "utils/project",
     "src": "src/utils/project.ts",
     "imports": [
@@ -242,7 +243,7 @@
     ]
   },
   "src/utils/queryId.ts": {
-    "file": "index.cjs20.js",
+    "file": "index.cjs21.js",
     "name": "utils/queryId",
     "src": "src/utils/queryId.ts"
   },
@@ -251,18 +252,23 @@
     "name": "utils/randomId",
     "src": "src/utils/randomId.ts"
   },
+  "src/utils/reactiveOrAsync.ts": {
+    "file": "index.cjs12.js",
+    "name": "utils/reactiveOrAsync",
+    "src": "src/utils/reactiveOrAsync.ts"
+  },
   "src/utils/serializeValue.ts": {
     "file": "index.cjs11.js",
     "name": "utils/serializeValue",
     "src": "src/utils/serializeValue.ts"
   },
   "src/utils/set.ts": {
-    "file": "index.cjs32.js",
+    "file": "index.cjs33.js",
     "name": "utils/set",
     "src": "src/utils/set.ts"
   },
   "src/utils/sortItems.ts": {
-    "file": "index.cjs25.js",
+    "file": "index.cjs26.js",
     "name": "utils/sortItems",
     "src": "src/utils/sortItems.ts",
     "imports": [
@@ -270,7 +276,7 @@
     ]
   },
   "src/utils/uniqueBy.ts": {
-    "file": "index.cjs29.js",
+    "file": "index.cjs30.js",
     "name": "utils/uniqueBy",
     "src": "src/utils/uniqueBy.ts"
   }

package/dist/Collection/Observer.d.ts

@@ -43,8 +43,10 @@ export default class Observer<T extends {
      */
     runChecks(getItems: () => Promise<T[]> | T[]): void;
     private checkItems;
+    private stopped;
     /**
      * Stops the observer by unbinding all events and cleaning up resources.
+     * Safe to call multiple times - will only unbind once.
      */
     stop(): void;
     /**

package/dist/Collection/index.d.ts

@@ -6,8 +6,8 @@ import type DataAdapter from '../DataAdapter';
 import type { QueryOptions } from '../DataAdapter';
 import type StorageAdapter from '../types/StorageAdapter';
 import Cursor from './Cursor';
-import type { BaseItem, FindOptions, Transform, TransformAll } from './types';
-export type { BaseItem, Transform, TransformAll, SortSpecifier, FieldSpecifier, FindOptions } from './types';
+import type { AsyncFindOptions, BaseItem, FindOptions, SyncFindOptions, Transform, TransformAll } from './types';
+export type { AnyFindOptions, AsyncFindOptions, BaseItem, Transform, TransformAll, SortSpecifier, FieldSpecifier, FindOptions, SyncFindOptions, } from './types';
 export type { CursorOptions } from './Cursor';
 export type { ObserveCallbacks } from './Observer';
 export { default as createIndex } from '../createIndex';
@@ -35,7 +35,7 @@ interface CollectionEvents<T extends BaseItem, E extends BaseItem = T, U = E> {
     'observer.created': <O extends QueryOptions<T>>(selector?: Selector<T>, options?: O) => void;
     'observer.disposed': <O extends QueryOptions<T>>(selector?: Selector<T>, options?: O) => void;
     'getItems': (selector: Selector<T> | undefined) => void;
-    'find': <O extends FindOptions<T, Async>, Async extends boolean>(selector: Selector<T> | undefined, options: O | undefined, cursor: Cursor<E, U, Async>) => void;
+    'find': <Async extends boolean, O extends FindOptions<T, Async>>(selector: Selector<T> | undefined, options: O | undefined, cursor: Cursor<E, U, Async>) => void;
     'findOne': <O extends QueryOptions<T>>(selector: Selector<T>, options: O | undefined, item: U | undefined) => void;
     'insert': (item: Omit<T, 'id'> & Partial<Pick<T, 'id'>>) => void;
     'updateOne': (selector: Selector<T>, modifier: Modifier<T>) => void;
@@ -45,8 +45,8 @@ interface CollectionEvents<T extends BaseItem, E extends BaseItem = T, U = E> {
     '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, Async>, Async extends boolean>(callstack: string, selector: Selector<T> | undefined, options: O | undefined, cursor: Cursor<E, U, Async>) => void;
-    '_debug.findOne': <O extends FindOptions<T, Async>, Async extends boolean>(callstack: string, selector: Selector<T>, options: O | undefined, item: U | undefined) => void;
+    '_debug.find': <Async extends boolean, O extends FindOptions<T, Async>>(callstack: string, selector: Selector<T> | undefined, options: O | undefined, cursor: Cursor<E, U, Async>) => void;
+    '_debug.findOne': <Async extends boolean, O extends FindOptions<T, Async>>(callstack: string, selector: Selector<T>, options: O | undefined, item: U | undefined) => void;
     '_debug.insert': (callstack: string, item: Omit<T, 'id'> & Partial<Pick<T, 'id'>>) => void;
     '_debug.updateOne': (callstack: string, selector: Selector<T>, modifier: Modifier<T>) => void;
     '_debug.updateMany': (callstack: string, selector: Selector<T>, modifier: Modifier<T>) => void;
@@ -200,23 +200,24 @@ export default class Collection<T extends BaseItem<I> = BaseItem, I = any, E ext
     /**
      * Finds multiple items in the collection based on a selector and optional options.
      * Returns a cursor for reactive data queries.
-     * @template O - The options type for the find operation.
      * @param [selector] - The criteria to select items.
      * @param [options] - Options for the find operation, such as limit and sort.
      * @returns A cursor to fetch and observe the matching items.
      */
-    find<Async extends boolean = false, O extends FindOptions<T, Async> = FindOptions<T, Async>>(selector?: Selector<T>, options?: O): Cursor<E, U, Async>;
+    find(selector?: Selector<T>, options?: SyncFindOptions<T>): Cursor<E, U, false>;
+    find(selector: Selector<T> | undefined, options: AsyncFindOptions<T>): Cursor<E, U, true>;
+    find(selector?: Selector<T>, options?: FindOptions<T, boolean>): Cursor<E, U, boolean>;
     /**
      * Finds a single item in the collection based on a selector and optional options.
      * ⚡️ this function is reactive!
      * Returns the found item or undefined if no item matches.
-     * @template Async - Whether to perform the operation asynchronously.
-     * @template O - The options type for the find operation.
      * @param selector - The criteria to select the item.
      * @param [options] - Options for the find operation, such as projection.
      * @returns The found item or `undefined`.
      */
-    findOne<Async extends boolean = false, O extends Omit<FindOptions<T, Async>, 'limit'> = Omit<FindOptions<T, Async>, 'limit'>>(selector: Selector<T>, options?: O): Async extends true ? Promise<U | undefined> : U | undefined;
+    findOne(selector: Selector<T>, options?: Omit<SyncFindOptions<T>, 'limit'>): U | undefined;
+    findOne(selector: Selector<T>, options: Omit<AsyncFindOptions<T>, 'limit'>): Promise<U | undefined>;
+    findOne(selector: Selector<T>, options?: Omit<FindOptions<T, boolean>, 'limit'>): Promise<U | undefined> | U | undefined;
     /**
      * Performs a batch operation, deferring index rebuilds and allowing multiple
      * modifications to be made atomically. Executes any post-batch callbacks afterwards.

package/dist/Collection/types.d.ts

@@ -19,3 +19,10 @@ export interface FindOptions<T extends BaseItem, Async extends boolean> extends
     /** pass `true` to execute the query asynchronously */
     async?: Async;
 }
+export type AsyncFindOptions<T extends BaseItem> = Omit<FindOptions<T, true>, 'async'> & {
+    async: true;
+};
+export type SyncFindOptions<T extends BaseItem> = Omit<FindOptions<T, false>, 'async'> & {
+    async?: false;
+};
+export type AnyFindOptions<T extends BaseItem> = AsyncFindOptions<T> | SyncFindOptions<T>;

package/dist/DefaultDataAdapter.d.ts

@@ -11,6 +11,7 @@ export default class DefaultDataAdapter implements DataAdapter {
     private items;
     private options;
     private storageAdapters;
+    private collections;
     private indices;
     private activeQueries;
     private queryEmitters;
@@ -29,5 +30,6 @@ export default class DefaultDataAdapter implements DataAdapter {
     private executeAndCacheQuery;
     private updateQueries;
     createCollectionBackend<T extends BaseItem<I>, I = any, E extends BaseItem = T, U = E>(collection: Collection<T, I, E, U>, indices: string[]): CollectionBackend<T, I>;
+    fetchItemsFromStorage<T extends BaseItem<I>, I = any, E extends BaseItem = T, U = E>(collection?: Collection<T, I, E, U>): Promise<void>;
 }
 export {};

package/dist/index.cjs.js

@@ -10,11 +10,12 @@ const randomId = require("./index.cjs8.js");
 const EventEmitter = require("./index.cjs9.js");
 const get = require("./index.cjs10.js");
 const serializeValue = require("./index.cjs11.js");
-const DefaultDataAdapter = require("./index.cjs12.js");
-const AsyncDataAdapter = require("./index.cjs13.js");
-const WorkerDataAdapter = require("./index.cjs14.js");
-const WorkerDataAdapterHost = require("./index.cjs15.js");
-const AutoFetchDataAdapter = require("./index.cjs16.js");
+const reactiveOrAsync = require("./index.cjs12.js");
+const DefaultDataAdapter = require("./index.cjs13.js");
+const AsyncDataAdapter = require("./index.cjs14.js");
+const WorkerDataAdapter = require("./index.cjs15.js");
+const WorkerDataAdapterHost = require("./index.cjs16.js");
+const AutoFetchDataAdapter = require("./index.cjs17.js");
 exports.Cursor = Cursor.default;
 exports.Collection = index.default;
 exports.createStorageAdapter = createStorageAdapter;
@@ -25,6 +26,8 @@ exports.randomId = randomId;
 exports.EventEmitter = EventEmitter;
 exports.get = get;
 exports.serializeValue = serializeValue;
+exports.reactiveOrAsync = reactiveOrAsync.default;
+exports.unwrap = reactiveOrAsync.unwrap;
 exports.DefaultDataAdapter = DefaultDataAdapter;
 exports.AsyncDataAdapter = AsyncDataAdapter;
 exports.WorkerDataAdapter = WorkerDataAdapter;