@connecttomahdi/rxdb 17.0.0-beta.17 → 17.1.0

package/dist/types/plugins/storage-denokv/index.d.ts

@@ -4,7 +4,7 @@ import { RxStorageInstanceDenoKV } from "./rx-storage-instance-denokv.ts";
 export declare class RxStorageDenoKV implements RxStorage<DenoKVStorageInternals<any>, DenoKVSettings> {
     settings: DenoKVSettings;
     name: string;
-    readonly rxdbVersion = "17.0.0-beta.17";
+    readonly rxdbVersion = "17.1.0";
     constructor(settings: DenoKVSettings);
     createStorageInstance<RxDocType>(params: RxStorageInstanceCreationParams<RxDocType, DenoKVSettings>): Promise<RxStorageInstanceDenoKV<RxDocType>>;
 }

package/dist/types/plugins/storage-dexie/rx-storage-dexie.d.ts

@@ -4,7 +4,7 @@ import { RxStorageInstanceDexie } from './rx-storage-instance-dexie.ts';
 export declare class RxStorageDexie implements RxStorage<DexieStorageInternals, DexieSettings> {
     settings: DexieSettings;
     name: string;
-    readonly rxdbVersion = "17.0.0-beta.17";
+    readonly rxdbVersion = "17.1.0";
     constructor(settings: DexieSettings);
     createStorageInstance<RxDocType>(params: RxStorageInstanceCreationParams<RxDocType, DexieSettings>): Promise<RxStorageInstanceDexie<RxDocType>>;
 }

package/dist/types/plugins/storage-localstorage/index.d.ts

@@ -4,7 +4,7 @@ export * from './localstorage-mock.ts';
 export declare class RxStorageLocalstorage implements RxStorage<LocalstorageStorageInternals, LocalstorageInstanceCreationOptions> {
     settings: LocalstorageStorageSettings;
     name: string;
-    readonly rxdbVersion = "17.0.0-beta.17";
+    readonly rxdbVersion = "17.1.0";
     constructor(settings: LocalstorageStorageSettings);
     createStorageInstance<RxDocType>(params: RxStorageInstanceCreationParams<RxDocType, LocalstorageInstanceCreationOptions>): Promise<RxStorageInstanceLocalstorage<RxDocType>>;
 }

package/dist/types/plugins/storage-memory/binary-search-bounds.d.ts

@@ -1,14 +1,25 @@
 /**
- * Everything in this file was copied and adapted from
- * @link https://github.com/mikolalysenko/binary-search-bounds
- *
- * We should use the original npm module instead when this bug is fixed:
- * @link https://github.com/mikolalysenko/binary-search-bounds/pull/14
+ * Optimized binary search functions for the memory storage.
+ * Based on https://github.com/mikolalysenko/binary-search-bounds
+ * but with performance improvements:
+ * - Removed unnecessary undefined checks for comparator
+ * - Inlined the norm() wrapper to avoid extra function calls
+ * - Added string-specialized variants to avoid temporary array allocations
  */
 type Compare<T> = ((a: T, b: T) => number | null | undefined);
-export declare function boundGE<T>(a: T[], y: T, c: Compare<T>, l?: any, h?: any): any;
-export declare function boundGT<T>(a: T[], y: T, c: Compare<T>, l?: any, h?: any): any;
-export declare function boundLT<T>(a: T[], y: T, c: Compare<T>, l?: any, h?: any): any;
-export declare function boundLE<T>(a: T[], y: T, c: Compare<T>, l?: any, h?: any): any;
-export declare function boundEQ<T>(a: T[], y: T, c: Compare<T>, l?: any, h?: any): any;
+export declare function boundGE<T>(a: T[], y: T, c: Compare<T>, lo?: any, hi?: any): number;
+export declare function boundGT<T>(a: T[], y: T, c: Compare<T>, lo?: any, hi?: any): number;
+export declare function boundLT<T>(a: T[], y: T, c: Compare<T>, lo?: any, hi?: any): number;
+export declare function boundLE<T>(a: T[], y: T, c: Compare<T>, lo?: any, hi?: any): number;
+export declare function boundEQ<T>(a: T[], y: T, c: Compare<T>, lo?: any, hi?: any): number;
+/**
+ * Specialized binary search functions that compare DocWithIndexString
+ * entries directly against an index string, avoiding temporary array allocations.
+ * Used in query() and count() hot paths.
+ */
+export declare function boundGEByIndexString<T extends [string, ...any[]]>(a: T[], indexString: string): number;
+export declare function boundGTByIndexString<T extends [string, ...any[]]>(a: T[], indexString: string): number;
+export declare function boundEQByIndexString<T extends [string, ...any[]]>(a: T[], indexString: string): number;
+export declare function boundLTByIndexString<T extends [string, ...any[]]>(a: T[], indexString: string): number;
+export declare function boundLEByIndexString<T extends [string, ...any[]]>(a: T[], indexString: string): number;
 export {};

package/dist/types/plugins/storage-memory/memory-helper.d.ts

@@ -11,9 +11,13 @@ export declare function putWriteRowToState<RxDocType>(docId: string, state: Memo
 /**
  * @hotPath
  * Efficiently inserts multiple documents into the state at once.
- * Instead of inserting one-by-one with Array.splice() (O(n) per insert),
- * this pre-computes all index entries, sorts them, and merges them into
- * the existing sorted arrays in a single pass (O(n log n + n + m)).
+ *
+ * Uses two strategies based on batch size:
+ * - For small batches (relative to existing index size), uses in-place
+ *   binary search + splice per document. This avoids allocating a new
+ *   full-size array and copying all elements, reducing GC pressure.
+ * - For large batches (or empty indexes), pre-computes all index entries,
+ *   sorts them, and merges into the existing sorted arrays in a single pass.
  */
 export declare function bulkInsertToState<RxDocType>(primaryPath: string, state: MemoryStorageInternals<RxDocType>, stateByIndex: MemoryStorageInternalsByIndex<RxDocType>[], docs: {
     document: RxDocumentData<RxDocType>;

package/dist/types/plugins/storage-memory/memory-types.d.ts

@@ -58,6 +58,11 @@ export type MemoryStorageInternals<RxDocType> = {
          */
         [indexName: string]: MemoryStorageInternalsByIndex<RxDocType>;
     };
+    /**
+     * Cached array of all MemoryStorageInternalsByIndex values.
+     * Avoids calling Object.values(byIndex) on every write operation.
+     */
+    byIndexArray: MemoryStorageInternalsByIndex<RxDocType>[];
     /**
      * We need these to do lazy writes.
      */

package/dist/types/plugins/storage-mongodb/mongodb-helper.d.ts

@@ -1,5 +1,5 @@
 import type { FilledMangoQuery, MangoQuerySelector, MangoQuerySortPart, RxDocumentData, RxJsonSchema } from '../../types/index.d.ts';
-import { Sort as MongoSort } from 'mongodb';
+import { Sort as MongoSort, MongoClient } from 'mongodb';
 import { MongoDBPreparedQuery, MongoQuerySelector } from './mongodb-types.ts';
 export declare const RX_STORAGE_NAME_MONGODB = "mongodb";
 export declare const MONGO_OPTIONS_DRIVER_INFO: {
@@ -20,3 +20,11 @@ export declare function swapMongoToRxDoc<RxDocType>(docData: any): RxDocumentDat
 export declare function swapRxDocToMongo<RxDocType>(docData: RxDocumentData<RxDocType>): any;
 export declare function swapToMongoSort<RxDocType>(sort: MangoQuerySortPart<RxDocType>[]): MongoSort;
 export declare function getMongoDBIndexName(index: string[]): string;
+export declare const MONGO_CLIENT_CACHE: Map<string, {
+    client: MongoClient;
+    refCount: number;
+    promise: Promise<MongoClient>;
+    closeTimeout?: ReturnType<typeof setTimeout>;
+}>;
+export declare function getMongoDBClient(connection: string): Promise<MongoClient>;
+export declare function closeMongoDBClient(connection: string): Promise<void>;

package/dist/types/plugins/storage-mongodb/rx-storage-instance-mongodb.d.ts

@@ -11,11 +11,11 @@ export declare class RxStorageInstanceMongoDB<RxDocType> implements RxStorageIns
     readonly internals: MongoDBStorageInternals;
     readonly options: Readonly<RxStorageMongoDBInstanceCreationOptions>;
     readonly settings: RxStorageMongoDBSettings;
+    readonly mongoClient: MongoClient;
     readonly primaryPath: StringKeys<RxDocumentData<RxDocType>>;
     readonly inMongoPrimaryPath: string;
     closed?: Promise<void>;
     private readonly changes$;
-    readonly mongoClient: MongoClient;
     readonly mongoDatabase: MongoDatabase;
     readonly mongoCollectionPromise: Promise<MongoCollection<RxDocumentData<RxDocType> | any>>;
     /**
@@ -32,7 +32,7 @@ export declare class RxStorageInstanceMongoDB<RxDocType> implements RxStorageIns
      * to RxDB
      */
     readonly mongoObjectIdCache: WeakMap<RxDocumentData<RxDocType>, ObjectId>;
-    constructor(storage: RxStorageMongoDB, databaseName: string, collectionName: string, schema: Readonly<RxJsonSchema<RxDocumentData<RxDocType>>>, internals: MongoDBStorageInternals, options: Readonly<RxStorageMongoDBInstanceCreationOptions>, settings: RxStorageMongoDBSettings);
+    constructor(storage: RxStorageMongoDB, databaseName: string, collectionName: string, schema: Readonly<RxJsonSchema<RxDocumentData<RxDocType>>>, internals: MongoDBStorageInternals, options: Readonly<RxStorageMongoDBInstanceCreationOptions>, settings: RxStorageMongoDBSettings, mongoClient: MongoClient);
     /**
      * Bulk writes on the mongodb storage.
      * Notice that MongoDB does not support cross-document transactions

package/dist/types/plugins/storage-mongodb/rx-storage-mongodb.d.ts

@@ -4,7 +4,7 @@ import { RxStorageInstanceMongoDB } from './rx-storage-instance-mongodb.ts';
 export declare class RxStorageMongoDB implements RxStorage<MongoDBStorageInternals, MongoDBSettings> {
     databaseSettings: MongoDBDatabaseSettings;
     name: string;
-    readonly rxdbVersion = "17.0.0-beta.17";
+    readonly rxdbVersion = "17.1.0";
     constructor(databaseSettings: MongoDBDatabaseSettings);
     createStorageInstance<RxDocType>(params: RxStorageInstanceCreationParams<RxDocType, MongoDBSettings>): Promise<RxStorageInstanceMongoDB<RxDocType>>;
 }

package/dist/types/plugins/storage-remote/rx-storage-remote.d.ts

@@ -4,7 +4,7 @@ import type { MessageFromRemote, RemoteMessageChannel, RxStorageRemoteInternals,
 export declare class RxStorageRemote implements RxStorage<RxStorageRemoteInternals, any> {
     readonly settings: RxStorageRemoteSettings;
     readonly name: string;
-    readonly rxdbVersion = "17.0.0-beta.17";
+    readonly rxdbVersion = "17.1.0";
     private seed;
     private lastRequestId;
     messageChannelIfOneMode?: Promise<RemoteMessageChannel>;

package/dist/types/plugins/storage-sqlite/index.d.ts

@@ -8,7 +8,7 @@ export * from './sqlite-basics-helpers.ts';
 export declare class RxStorageSQLiteTrial implements RxStorage<SQLiteInternals, SQLiteInstanceCreationOptions> {
     settings: SQLiteStorageSettings;
     name: string;
-    readonly rxdbVersion = "17.0.0-beta.17";
+    readonly rxdbVersion = "17.1.0";
     constructor(settings: SQLiteStorageSettings);
     createStorageInstance<RxDocType>(params: RxStorageInstanceCreationParams<RxDocType, SQLiteInstanceCreationOptions>): Promise<RxStorageInstanceSQLite<RxDocType>>;
 }

package/dist/types/plugins/test-utils/performance.d.ts

@@ -42,6 +42,42 @@ export type PerformanceTestConfig = {
      * @default true
      */
     log?: boolean;
+    /**
+     * If set, the database will be created with encryption
+     * and the schema will mark applicable fields as encrypted.
+     */
+    password?: any;
+    /**
+     * Whether to run the bulk find-by-ids test.
+     * @default true
+     */
+    testBulkFindByIds?: boolean;
+    /**
+     * Whether to run the serial find-by-id test.
+     * @default true
+     */
+    testSerialFindById?: boolean;
+    /**
+     * Whether to run the find-by-query test.
+     * @default true
+     */
+    testFindByQuery?: boolean;
+    /**
+     * Whether to run the find-by-query-parallel test.
+     * @default true
+     */
+    testFindByQueryParallel?: boolean;
+    /**
+     * Whether to run the count query test.
+     * @default true
+     */
+    testCount?: boolean;
+    /**
+     * Whether to run the property access test.
+     * Requires testFindByQuery to also be enabled.
+     * @default true
+     */
+    testPropertyAccess?: boolean;
 };
 export type PerformanceTestResult = {
     description: string;

package/dist/types/plugins/test-utils/test-util.d.ts

@@ -7,4 +7,21 @@ export declare function ensureCollectionsHaveEqualState<RxDocType>(c1: RxCollect
  * Waits until the collections have the equal state.
  */
 export declare function awaitCollectionsHaveEqualState<RxDocType>(c1: RxCollection<RxDocType>, c2: RxCollection<RxDocType>, logContext?: string, timeout?: number): Promise<void>;
+/**
+ * Deletes all locally stored IndexedDB databases.
+ * Noop if IndexedDB is not available (e.g. in Node.js)
+ * or if the .databases() method is not supported.
+ */
+export declare function clearAllLocalIndexedDB(): Promise<void>;
+/**
+ * Deletes all files and directories stored in the
+ * Origin Private File System (OPFS).
+ * Noop if OPFS is not available (e.g. in Node.js).
+ */
+export declare function clearAllLocalOPFS(maxRetries?: number, delayMs?: number): Promise<void>;
+/**
+ * Clears all localStorage data.
+ * Noop if localStorage is not available (e.g. in Node.js).
+ */
+export declare function clearAllLocalStorage(): Promise<void>;
 export declare function ensureReplicationHasNoErrors(replicationState: RxReplicationState<any, any>): void;

package/dist/types/plugins/utils/utils-object.d.ts

@@ -19,8 +19,9 @@ export declare function getFromObjectOrThrow<V>(obj: {
 export declare function flattenObject(ob: any): any;
 /**
  * does a flat copy on the objects,
- * is about 3 times faster than using deepClone
- * @link https://jsperf.com/object-rest-spread-vs-clone/2
+ * is about 3 times faster than using deepClone.
+ * Using the spread operator instead of Object.assign
+ * because V8 optimizes spread for plain objects (~4x faster).
  */
 export declare function flatClone<T>(obj: T | DeepReadonlyObject<T> | Readonly<T>): T;
 /**
@@ -48,7 +49,11 @@ declare function deepClone<T>(src: T | DeepReadonlyObject<T>): T;
 export declare const clone: typeof deepClone;
 /**
  * overwrites the getter with the actual value
- * Mostly used for caching stuff on the first run
+ * Mostly used for caching stuff on the first run.
+ *
+ * Using a value descriptor instead of a getter descriptor
+ * so that subsequent property accesses are direct value lookups
+ * instead of function calls, which is ~37% faster for reads.
  */
 export declare function overwriteGetterForCaching<ValueType = any>(obj: any, getterName: string, value: ValueType): ValueType;
 export declare function hasDeepProperty(obj: any, property: string): boolean;

package/dist/types/plugins/utils/utils-premium.d.ts

@@ -4,7 +4,5 @@ export declare const NON_PREMIUM_COLLECTION_LIMIT = 999;
  * Here we check if the premium flag has been set.
  * This code exists in the open source version of RxDB.
  * Yes you are allowed to fork the repo and just overwrite this function.
- * However you might better spend this time developing your real project
- * and supporting the RxDB efforts by buying premium.
  */
 export declare function hasPremiumFlag(): Promise<boolean>;

package/dist/types/plugins/utils/utils-rxdb-version.d.ts

@@ -1,4 +1,4 @@
 /**
  * This file is replaced in the 'npm run build:version' script.
  */
-export declare const RXDB_VERSION = "17.0.0-beta.17";
+export declare const RXDB_VERSION = "17.1.0";

package/dist/types/rx-database.d.ts

@@ -30,7 +30,7 @@ export declare class RxDatabaseBase<Internals, InstanceCreationOptions, Collecti
     readonly reactivity?: RxReactivityFactory<any> | undefined;
     readonly onClosed?: (() => void) | undefined;
     readonly idleQueue: IdleQueue;
-    readonly rxdbVersion = "17.0.0-beta.17";
+    readonly rxdbVersion = "17.1.0";
     /**
      * Contains all known non-closed storage instances
      * that belong to this database.

package/dist/types/rx-query-single-result.d.ts

@@ -11,7 +11,7 @@ export declare class RxQuerySingleResult<RxDocType> {
     readonly query: RxQueryBase<RxDocType, unknown>;
     readonly count: number;
     /**
-     * Time at which the current _result state was created.
+     * Unique identifier for this result state.
      * Used to determine if the result set has changed since X
      * so that we do not emit the same result multiple times on subscription.
      */

package/dist/types/rx-query.d.ts

@@ -21,7 +21,8 @@ export declare class RxQueryBase<RxDocType, RxQueryResult, OrmMethods = {}, Reac
     _creationTime: number;
     _lastEnsureEqual: number;
     uncached: boolean;
-    refCount$: BehaviorSubject<null>;
+    _refCount$: BehaviorSubject<null> | null;
+    get refCount$(): BehaviorSubject<null>;
     isFindOneByIdQuery: false | string | string[];
     /**
      * Contains the current result state
@@ -98,7 +99,7 @@ export declare class RxQueryBase<RxDocType, RxQueryResult, OrmMethods = {}, Reac
      * deletes all found documents
      * @return promise with deleted documents
      */
-    remove(): Promise<RxQueryResult>;
+    remove(throwIfMissing?: boolean): Promise<RxQueryResult>;
     incrementalRemove(): Promise<RxQueryResult>;
     /**
      * helper function to transform RxQueryBase to RxQuery type

package/dist/types/rx-storage-helper.d.ts

@@ -5,6 +5,21 @@ import type { BulkWriteRow, BulkWriteRowProcessed, CategorizeBulkWriteRowsOutput
 import { Observable } from 'rxjs';
 export declare const INTERNAL_STORAGE_NAME = "_rxdb_internal";
 export declare const RX_DATABASE_LOCAL_DOCS_STORAGE_NAME = "rxdatabase_storage_local";
+/**
+ * Context string used by RxCollection.bulkInsert().
+ * Documents written with this context are already cloned
+ * by fillObjectDataBeforeInsert(), so the wrapped storage
+ * can safely mutate them in place instead of cloning again.
+ */
+export declare const RX_COLLECTION_BULK_INSERT_CONTEXT = "rx-collection-bulk-insert";
+/**
+ * Register a bulkWrite context string as "mutable",
+ * meaning the caller guarantees that insert documents
+ * are already cloned and safe to mutate in place.
+ * This allows the wrapped storage to skip a redundant
+ * flatClone() call on the insert hot path.
+ */
+export declare function registerMutableWriteContext(context: string): void;
 export declare function getSingleDocument<RxDocType>(storageInstance: RxStorageInstance<RxDocType, any, any>, documentId: string): Promise<RxDocumentData<RxDocType> | undefined>;
 /**
  * Writes a single document,

package/eslint.config.mjs

@@ -51,7 +51,8 @@ export default [
             'docs-src/build/',
             'docs-src/docusaurus-lunr-search-main',
             'config/.mocharc.cjs',
-            'config/karma.webpack.conf.cjs'
+            'config/karma.webpack.conf.cjs',
+            '.chrome-profile-perf/'
         ]
     },
     ...compat.extends('eslint:recommended', 'plugin:@typescript-eslint/eslint-recommended', 'plugin:@typescript-eslint/recommended', 'plugin:@typescript-eslint/recommended-requiring-type-checking'),