@signaldb/core 2.0.0-beta.1 → 2.0.0-beta.11

package/dist/.vite/manifest.json

@@ -1,77 +1,84 @@
 {
   "src/AsyncDataAdapter.ts": {
-    "file": "index.cjs13.js",
+    "file": "index29.cjs.js",
     "name": "AsyncDataAdapter",
     "src": "src/AsyncDataAdapter.ts",
+    "isDynamicEntry": true,
     "imports": [
+      "src/getIndexInfo.ts",
       "src/utils/deepClone.ts",
+      "src/utils/getMatchingKeys.ts",
+      "src/utils/isEqual.ts",
       "src/utils/match.ts",
       "src/utils/modify.ts",
+      "src/utils/project.ts",
       "src/utils/queryId.ts",
-      "src/utils/isEqual.ts",
-      "src/getIndexInfo.ts",
-      "src/utils/getMatchingKeys.ts",
-      "src/utils/sortItems.ts",
-      "src/utils/project.ts"
+      "src/utils/sortItems.ts"
     ]
   },
   "src/AutoFetchDataAdapter.ts": {
-    "file": "index.cjs16.js",
+    "file": "index34.cjs.js",
     "name": "AutoFetchDataAdapter",
     "src": "src/AutoFetchDataAdapter.ts",
+    "isDynamicEntry": true,
     "imports": [
+      "src/getIndexInfo.ts",
       "src/utils/deepClone.ts",
+      "src/utils/getMatchingKeys.ts",
+      "src/utils/isEqual.ts",
       "src/utils/match.ts",
       "src/utils/modify.ts",
+      "src/utils/project.ts",
       "src/utils/queryId.ts",
-      "src/utils/isEqual.ts",
-      "src/getIndexInfo.ts",
-      "src/utils/getMatchingKeys.ts",
-      "src/utils/sortItems.ts",
-      "src/utils/project.ts"
+      "src/utils/sortItems.ts"
     ]
   },
   "src/Collection/Cursor.ts": {
-    "file": "index.cjs2.js",
+    "file": "index5.cjs.js",
     "name": "Collection/Cursor",
     "src": "src/Collection/Cursor.ts",
+    "isDynamicEntry": true,
     "imports": [
       "src/Collection/Observer.ts"
     ]
   },
   "src/Collection/Observer.ts": {
-    "file": "index.cjs17.js",
+    "file": "index4.cjs.js",
     "name": "Collection/Observer",
     "src": "src/Collection/Observer.ts",
+    "isDynamicEntry": true,
     "imports": [
       "src/utils/isEqual.ts",
       "src/utils/uniqueBy.ts"
     ]
   },
   "src/Collection/index.ts": {
-    "file": "index.cjs3.js",
+    "file": "index25.cjs.js",
     "name": "Collection/index",
     "src": "src/Collection/index.ts",
+    "isDynamicEntry": true,
     "imports": [
+      "src/Collection/Cursor.ts",
+      "src/DefaultDataAdapter.ts",
+      "src/createIndex.ts",
       "src/utils/EventEmitter.ts",
       "src/utils/createSignal.ts",
-      "src/utils/randomId.ts",
-      "src/DefaultDataAdapter.ts",
-      "src/utils/modify.ts",
       "src/utils/deepClone.ts",
+      "src/utils/modify.ts",
       "src/utils/queryId.ts",
-      "src/Collection/Cursor.ts"
+      "src/utils/randomId.ts"
     ]
   },
   "src/DefaultDataAdapter.ts": {
-    "file": "index.cjs12.js",
+    "file": "index24.cjs.js",
     "name": "DefaultDataAdapter",
     "src": "src/DefaultDataAdapter.ts",
+    "isDynamicEntry": true,
     "imports": [
       "src/createIndex.ts",
       "src/getIndexInfo.ts",
-      "src/utils/deepClone.ts",
       "src/utils/EventEmitter.ts",
+      "src/utils/deepClone.ts",
       "src/utils/isEqual.ts",
       "src/utils/match.ts",
       "src/utils/modify.ts",
@@ -82,36 +89,39 @@
     ]
   },
   "src/WorkerDataAdapter.ts": {
-    "file": "index.cjs14.js",
+    "file": "index31.cjs.js",
     "name": "WorkerDataAdapter",
     "src": "src/WorkerDataAdapter.ts",
+    "isDynamicEntry": true,
     "imports": [
+      "src/utils/batchOnNextTick.ts",
       "src/utils/queryId.ts",
-      "src/utils/randomId.ts",
-      "src/utils/batchOnNextTick.ts"
+      "src/utils/randomId.ts"
     ]
   },
   "src/WorkerDataAdapterHost.ts": {
-    "file": "index.cjs15.js",
+    "file": "index33.cjs.js",
     "name": "WorkerDataAdapterHost",
     "src": "src/WorkerDataAdapterHost.ts",
+    "isDynamicEntry": true,
     "imports": [
+      "src/getIndexInfo.ts",
+      "src/utils/compact.ts",
       "src/utils/deepClone.ts",
+      "src/utils/getMatchingKeys.ts",
+      "src/utils/isEqual.ts",
       "src/utils/match.ts",
       "src/utils/modify.ts",
-      "src/utils/queryId.ts",
-      "src/utils/isEqual.ts",
-      "src/getIndexInfo.ts",
-      "src/utils/getMatchingKeys.ts",
-      "src/utils/sortItems.ts",
       "src/utils/project.ts",
-      "src/utils/compact.ts"
+      "src/utils/queryId.ts",
+      "src/utils/sortItems.ts"
     ]
   },
   "src/createIndex.ts": {
-    "file": "index.cjs21.js",
+    "file": "index14.cjs.js",
     "name": "createIndex",
     "src": "src/createIndex.ts",
+    "isDynamicEntry": true,
     "imports": [
       "src/createIndexProvider.ts",
       "src/utils/get.ts",
@@ -120,24 +130,28 @@
     ]
   },
   "src/createIndexProvider.ts": {
-    "file": "index.cjs30.js",
+    "file": "index9.cjs.js",
     "name": "createIndexProvider",
-    "src": "src/createIndexProvider.ts"
+    "src": "src/createIndexProvider.ts",
+    "isDynamicEntry": true
   },
   "src/createReactivityAdapter.ts": {
-    "file": "index.cjs5.js",
+    "file": "index27.cjs.js",
     "name": "createReactivityAdapter",
-    "src": "src/createReactivityAdapter.ts"
+    "src": "src/createReactivityAdapter.ts",
+    "isDynamicEntry": true
   },
   "src/createStorageAdapter.ts": {
-    "file": "index.cjs4.js",
+    "file": "index26.cjs.js",
     "name": "createStorageAdapter",
-    "src": "src/createStorageAdapter.ts"
+    "src": "src/createStorageAdapter.ts",
+    "isDynamicEntry": true
   },
   "src/getIndexInfo.ts": {
-    "file": "index.cjs22.js",
+    "file": "index16.cjs.js",
     "name": "getIndexInfo",
     "src": "src/getIndexInfo.ts",
+    "isDynamicEntry": true,
     "imports": [
       "src/utils/intersection.ts"
     ]
@@ -148,130 +162,156 @@
     "src": "src/index.ts",
     "isEntry": true,
     "imports": [
+      "src/AsyncDataAdapter.ts",
+      "src/AutoFetchDataAdapter.ts",
       "src/Collection/Cursor.ts",
       "src/Collection/index.ts",
-      "src/createStorageAdapter.ts",
+      "src/DefaultDataAdapter.ts",
+      "src/WorkerDataAdapter.ts",
+      "src/WorkerDataAdapterHost.ts",
       "src/createReactivityAdapter.ts",
+      "src/createStorageAdapter.ts",
+      "src/utils/EventEmitter.ts",
+      "src/utils/get.ts",
       "src/utils/isEqual.ts",
       "src/utils/modify.ts",
       "src/utils/randomId.ts",
-      "src/utils/EventEmitter.ts",
-      "src/utils/get.ts",
-      "src/utils/serializeValue.ts",
-      "src/DefaultDataAdapter.ts",
-      "src/AsyncDataAdapter.ts",
-      "src/WorkerDataAdapter.ts",
-      "src/WorkerDataAdapterHost.ts",
-      "src/AutoFetchDataAdapter.ts"
+      "src/utils/reactiveOrAsync.ts",
+      "src/utils/serializeValue.ts"
     ]
   },
   "src/utils/EventEmitter.ts": {
-    "file": "index.cjs9.js",
+    "file": "index6.cjs.js",
     "name": "utils/EventEmitter",
-    "src": "src/utils/EventEmitter.ts"
+    "src": "src/utils/EventEmitter.ts",
+    "isDynamicEntry": true
   },
   "src/utils/batchOnNextTick.ts": {
-    "file": "index.cjs27.js",
+    "file": "index30.cjs.js",
     "name": "utils/batchOnNextTick",
-    "src": "src/utils/batchOnNextTick.ts"
+    "src": "src/utils/batchOnNextTick.ts",
+    "isDynamicEntry": true
   },
   "src/utils/compact.ts": {
-    "file": "index.cjs28.js",
+    "file": "index32.cjs.js",
     "name": "utils/compact",
-    "src": "src/utils/compact.ts"
+    "src": "src/utils/compact.ts",
+    "isDynamicEntry": true
   },
   "src/utils/createSignal.ts": {
-    "file": "index.cjs18.js",
+    "file": "index7.cjs.js",
     "name": "utils/createSignal",
-    "src": "src/utils/createSignal.ts"
+    "src": "src/utils/createSignal.ts",
+    "isDynamicEntry": true
   },
   "src/utils/deepClone.ts": {
-    "file": "index.cjs19.js",
+    "file": "index17.cjs.js",
     "name": "utils/deepClone",
-    "src": "src/utils/deepClone.ts"
+    "src": "src/utils/deepClone.ts",
+    "isDynamicEntry": true
   },
   "src/utils/get.ts": {
-    "file": "index.cjs10.js",
+    "file": "index10.cjs.js",
     "name": "utils/get",
-    "src": "src/utils/get.ts"
+    "src": "src/utils/get.ts",
+    "isDynamicEntry": true
   },
   "src/utils/getMatchingKeys.ts": {
-    "file": "index.cjs26.js",
+    "file": "index13.cjs.js",
     "name": "utils/getMatchingKeys",
     "src": "src/utils/getMatchingKeys.ts",
+    "isDynamicEntry": true,
     "imports": [
       "src/utils/isFieldExpression.ts",
       "src/utils/serializeValue.ts"
     ]
   },
   "src/utils/intersection.ts": {
-    "file": "index.cjs31.js",
+    "file": "index15.cjs.js",
     "name": "utils/intersection",
-    "src": "src/utils/intersection.ts"
+    "src": "src/utils/intersection.ts",
+    "isDynamicEntry": true
   },
   "src/utils/isEqual.ts": {
-    "file": "index.cjs6.js",
+    "file": "index2.cjs.js",
     "name": "utils/isEqual",
-    "src": "src/utils/isEqual.ts"
+    "src": "src/utils/isEqual.ts",
+    "isDynamicEntry": true
   },
   "src/utils/isFieldExpression.ts": {
-    "file": "index.cjs33.js",
+    "file": "index11.cjs.js",
     "name": "utils/isFieldExpression",
-    "src": "src/utils/isFieldExpression.ts"
+    "src": "src/utils/isFieldExpression.ts",
+    "isDynamicEntry": true
   },
   "src/utils/match.ts": {
-    "file": "index.cjs23.js",
+    "file": "index18.cjs.js",
     "name": "utils/match",
-    "src": "src/utils/match.ts"
+    "src": "src/utils/match.ts",
+    "isDynamicEntry": true
   },
   "src/utils/modify.ts": {
-    "file": "index.cjs7.js",
+    "file": "index19.cjs.js",
     "name": "utils/modify",
     "src": "src/utils/modify.ts",
+    "isDynamicEntry": true,
     "imports": [
       "src/utils/deepClone.ts"
     ]
   },
   "src/utils/project.ts": {
-    "file": "index.cjs24.js",
+    "file": "index21.cjs.js",
     "name": "utils/project",
     "src": "src/utils/project.ts",
+    "isDynamicEntry": true,
     "imports": [
       "src/utils/get.ts",
       "src/utils/set.ts"
     ]
   },
   "src/utils/queryId.ts": {
-    "file": "index.cjs20.js",
+    "file": "index22.cjs.js",
     "name": "utils/queryId",
-    "src": "src/utils/queryId.ts"
+    "src": "src/utils/queryId.ts",
+    "isDynamicEntry": true
   },
   "src/utils/randomId.ts": {
-    "file": "index.cjs8.js",
+    "file": "index8.cjs.js",
     "name": "utils/randomId",
-    "src": "src/utils/randomId.ts"
+    "src": "src/utils/randomId.ts",
+    "isDynamicEntry": true
+  },
+  "src/utils/reactiveOrAsync.ts": {
+    "file": "index28.cjs.js",
+    "name": "utils/reactiveOrAsync",
+    "src": "src/utils/reactiveOrAsync.ts",
+    "isDynamicEntry": true
   },
   "src/utils/serializeValue.ts": {
-    "file": "index.cjs11.js",
+    "file": "index12.cjs.js",
     "name": "utils/serializeValue",
-    "src": "src/utils/serializeValue.ts"
+    "src": "src/utils/serializeValue.ts",
+    "isDynamicEntry": true
   },
   "src/utils/set.ts": {
-    "file": "index.cjs32.js",
+    "file": "index20.cjs.js",
     "name": "utils/set",
-    "src": "src/utils/set.ts"
+    "src": "src/utils/set.ts",
+    "isDynamicEntry": true
   },
   "src/utils/sortItems.ts": {
-    "file": "index.cjs25.js",
+    "file": "index23.cjs.js",
     "name": "utils/sortItems",
     "src": "src/utils/sortItems.ts",
+    "isDynamicEntry": true,
     "imports": [
       "src/utils/get.ts"
     ]
   },
   "src/utils/uniqueBy.ts": {
-    "file": "index.cjs29.js",
+    "file": "index3.cjs.js",
     "name": "utils/uniqueBy",
-    "src": "src/utils/uniqueBy.ts"
+    "src": "src/utils/uniqueBy.ts",
+    "isDynamicEntry": true
   }
 }

package/dist/AsyncDataAdapter.d.ts

@@ -1,8 +1,6 @@
-import type { BaseItem } from './Collection';
-import type Collection from './Collection';
-import type DataAdapter from './DataAdapter';
-import type { CollectionBackend } from './DataAdapter';
-import type StorageAdapter from './types/StorageAdapter';
+import { BaseItem, default as Collection } from './Collection';
+import { default as DataAdapter, CollectionBackend } from './DataAdapter';
+import { default as StorageAdapter } from './types/StorageAdapter';
 export interface AsyncDataAdapterOptions {
     /** Factory to obtain a StorageAdapter per collection name */
     storage: (name: string) => StorageAdapter<any, any>;
@@ -10,6 +8,30 @@ export interface AsyncDataAdapterOptions {
     id?: string;
     /** Optional error hook (mirrors WorkerDataAdapterHost) */
     onError?: (error: Error) => void;
+    /**
+     * How often a failing query is retried before it is published as `'error'`.
+     * A query that fails is otherwise a dead end for the rest of the session —
+     * cursors only requery on `'complete'`, so they keep serving their neutral
+     * empty value, which consumers cannot tell apart from "there is no data".
+     */
+    retry?: {
+        /** Total attempts including the first one. Default 3. */
+        attempts?: number;
+        /** Delay in ms before attempt N+1. Default 100 * 4 ** (attempt - 1). */
+        delay?: (attempt: number) => number;
+    };
+}
+/**
+ * Carries the context needed to act on a failed query. The bare storage error
+ * on its own does not say which collection or selector produced it, which made
+ * the default `console.error` hook close to useless.
+ */
+export declare class QueryError extends Error {
+    readonly collectionName: string;
+    readonly selector: unknown;
+    readonly options: unknown;
+    readonly attempts: number;
+    constructor(collectionName: string, selector: unknown, options: unknown, attempts: number, cause: unknown);
 }
 /**
  * AsyncDataAdapter
@@ -22,12 +44,14 @@ export default class AsyncDataAdapter implements DataAdapter {
     private options;
     private id;
     private onError;
+    private retryAttempts;
+    private retryDelay;
     private storageAdapters;
     private storageAdapterReady;
     private collectionIndices;
     private queries;
     constructor(options: AsyncDataAdapterOptions);
-    createCollectionBackend<T extends BaseItem<I>, I = any, U = T>(collection: Collection<T, I, U>, indices: string[]): CollectionBackend<T, I>;
+    createCollectionBackend<T extends BaseItem<I>, I = any, E extends BaseItem = T, U = E>(collection: Collection<T, I, E, U>, indices: string[]): CollectionBackend<T, I>;
     private setupStorage;
     private ensureStorageAdapter;
     /**
@@ -37,6 +61,19 @@ export default class AsyncDataAdapter implements DataAdapter {
      * @param options - query options
      */
     private fulfillQuery;
+    /**
+     * Executes a query, retrying transient failures before giving up. The state
+     * stays `'active'` across retries — consumers should see "still loading",
+     * not "failed", until we actually stop trying. Only the final failure is
+     * published as `'error'` and reported through `onError`; previously that
+     * error was swallowed entirely (`fulfillQuery` caught it internally, so the
+     * `.catch(this.onError)` on its call site was unreachable) and the query
+     * stayed dead for the rest of the session.
+     * @param collectionName - name of the collection
+     * @param selector - query selector
+     * @param options - query options
+     */
+    private runQuery;
     /**
      * Notify listeners about state changes and keep the cache updated
      * @param collectionName - name of the collection
@@ -52,7 +89,7 @@ export default class AsyncDataAdapter implements DataAdapter {
     /**
      * After mutations, recompute and push updates for affected active queries
      * @param collectionName - name of the collection
-     * @param changedItems - items that were inserted/updated/replaced/removed
+     * @param affectedItems - item states before and/or after the mutation
      */
     private checkQueryUpdates;
     private insert;

package/dist/AutoFetchDataAdapter.d.ts

@@ -1,9 +1,7 @@
-import type { BaseItem } from './Collection';
-import type Collection from './Collection';
-import type DataAdapter from './DataAdapter';
-import type { CollectionBackend } from './DataAdapter';
-import type StorageAdapter from './types/StorageAdapter';
-import type Selector from './types/Selector';
+import { BaseItem, default as Collection } from './Collection';
+import { default as DataAdapter, CollectionBackend } from './DataAdapter';
+import { default as StorageAdapter } from './types/StorageAdapter';
+import { default as Selector } from './types/Selector';
 /**
  * AutoFetchDataAdapterOptions
  *
@@ -71,7 +69,7 @@ export default class AutoFetchDataAdapter implements DataAdapter {
     private idRefCounts;
     private autoloadIds;
     constructor(options: AutoFetchDataAdapterOptions);
-    createCollectionBackend<T extends BaseItem<I>, I = any, U = T>(collection: Collection<T, I, U>, indices: string[]): CollectionBackend<T, I>;
+    createCollectionBackend<T extends BaseItem<I>, I = any, E extends BaseItem = T, U = E>(collection: Collection<T, I, E, U>, indices: string[]): CollectionBackend<T, I>;
     private forceRefetchAll;
     private fetchAndIngest;
     private purgeSelector;

package/dist/Collection/Cursor.d.ts

@@ -1,6 +1,6 @@
-import type ReactivityAdapter from '../types/ReactivityAdapter';
-import type { BaseItem, FindOptions, Transform } from './types';
-import type { ObserveCallbacks } from './Observer';
+import { default as ReactivityAdapter } from '../types/ReactivityAdapter';
+import { BaseItem, FindOptions, Transform } from './types';
+import { ObserveCallbacks } from './Observer';
 /**
  * Checks if the current scope is reactive, considering the provided reactivity adapter.
  * @param reactivity - The reactivity adapter or a boolean indicating whether reactivity is enabled.
@@ -15,7 +15,7 @@ export interface CursorOptions<T extends BaseItem, U = T, Async extends boolean
  * Represents a cursor for querying and observing a filtered, sorted, and transformed
  * subset of items from a collection. Supports reactivity and field tracking.
  * @template T - The type of the items in the collection.
- * @template U - The transformed item type after applying transformations (default is T).
+ * @template U - The transformed item type after applying transform (default is T).
  */
 export default class Cursor<T extends BaseItem, U = T, Async extends boolean = false> {
     private observer;
@@ -37,6 +37,7 @@ export default class Cursor<T extends BaseItem, U = T, Async extends boolean = f
      * @param options.limit - The maximum number of items to return in the result set.
      * @param options.reactive - A reactivity adapter to enable observing changes in the cursor's result set.
      * @param options.fieldTracking - A boolean to enable fine-grained field tracking for reactivity.
+     * @param options.transformAll - A function that will be able to solve the n+1 problem
      */
     constructor(getItems: Async extends true ? () => Promise<T[]> : () => T[], options?: CursorOptions<T, U, Async>);
     private addGetters;
@@ -102,7 +103,7 @@ export default class Cursor<T extends BaseItem, U = T, Async extends boolean = f
      * @param skipInitial - A boolean indicating whether to skip the initial notification of the current result set.
      * @returns A function to stop observing changes.
      */
-    observeChanges(callbacks: ObserveCallbacks<U>, skipInitial?: boolean): () => void;
+    observeChanges(callbacks: ObserveCallbacks<T>, skipInitial?: boolean): () => void;
     /**
      * Forces the cursor to re-evaluate its result set by re-fetching items
      * from the collection. This is useful when the underlying data or query

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;
     /**