dexie 4.3.0 → 4.4.1

package/README.md

@@ -12,7 +12,7 @@ But also:
 
 * Dexie.js is widely used by 100,000 of web sites, apps and other projects and supports all browsers, Electron for Desktop apps, Capacitor for iOS / Android apps and of course pure PWAs.
 * Dexie.js works around bugs in the IndexedDB implementations, giving a more stable user experience.
-* It's an easy step to [make it sync](https://dexie.org/#sync).
+* Need sync? [Dexie Cloud](https://dexie.org/cloud/) adds real-time sync, auth, and collaboration on top of Dexie.js — no backend needed.
 
 #### Hello World (vanilla JS)
 
@@ -213,11 +213,39 @@ This is a mix of methods from [WhereClause](https://dexie.org/docs/WhereClause/W
 
 ## Dexie Cloud
 
-[Dexie Cloud](https://dexie.org/cloud/) is a commercial offering that can be used as an add-on to Dexie.js. It syncs a Dexie database with a server and enables developers to build apps without having to care about backend or database layer else than the frontend code with Dexie.js as the sole database layer.
+[Dexie Cloud](https://dexie.org/cloud/) is the easiest way to add sync, authentication, and real-time collaboration to your Dexie app. You keep writing frontend code with Dexie.js — Dexie Cloud handles the rest.
 
-Source for a sample Dexie Cloud app: [Dexie Cloud To-do app](https://github.com/dexie/Dexie.js/tree/master/samples/dexie-cloud-todo-app)
+**What you get:**
+- 🔄 **Sync across devices** — changes propagate in real time, no polling needed
+- 🔐 **Authentication** — built-in user auth, no identity provider required
+- 🛡️ **Access control** — share data between users with fine-grained permissions
+- 📁 **File & blob storage** — store attachments alongside your structured data
+- ✈️ **Offline-first** — works fully offline, syncs when back online
 
-See the sample Dexie Cloud app in action: https://dexie.github.io/Dexie.js/dexie-cloud-todo-app/
+**Getting started is just a few lines:**
+
+```bash
+npm install dexie-cloud-addon
+```
+
+```ts
+import Dexie from 'dexie';
+import dexieCloud from 'dexie-cloud-addon';
+
+const db = new Dexie('MyDatabase', { addons: [dexieCloud] });
+db.version(1).stores({ items: '@id, title' });
+db.cloud.configure({ databaseUrl: 'https://<your-db>.dexie.cloud' });
+```
+
+That's it. Your existing Dexie app now syncs. Hosted cloud or self-hosted on your own infrastructure. 👋
+
+→ [Quickstart guide](https://dexie.org/cloud/docs/quickstart)
+
+**Sample app:**
+
+Source: [Dexie Cloud To-do app](https://github.com/dexie/Dexie.js/tree/master/samples/dexie-cloud-todo-app)
+
+Live demo: https://dexie.github.io/Dexie.js/dexie-cloud-todo-app/
 
 ## Samples
 

package/dist/dexie.d.ts

@@ -4,7 +4,7 @@
  *
  * By David Fahlander, david.fahlander@gmail.com
  *
- * Version 4.3.0, Sat Dec 20 2025
+ * Version 4.4.1, Wed Mar 25 2026
  *
  * https://dexie.org
  *
@@ -643,6 +643,7 @@ export interface DBCoreQueryRequest {
 	values?: boolean;
 	limit?: number;
 	query: DBCoreQuery;
+	direction?: "next" | "nextunique" | "prev" | "prevunique";
 	obsSet?: ObservabilitySet;
 }
 export interface DBCoreQueryResponse {
@@ -1119,6 +1120,7 @@ export interface DexieOptions {
 	};
 	chromeTransactionDurability?: ChromeTransactionDurability;
 	cache?: "immutable" | "cloned" | "disabled";
+	maxConnections?: number;
 }
 export interface DexieConstructor extends DexieExceptionClasses {
 	new (databaseName: string, options?: DexieOptions): Dexie;
@@ -1199,7 +1201,7 @@ export interface _Collection<T, TKey> extends Collection<T, TKey> {
 }
 // Besides being the only exported value, let Dexie also be
 // a namespace for types...
-export declare module Dexie {
+export declare namespace Dexie {
 	// The "Dexie.Promise" type.
 	type Promise<T = any> = PromiseExtended<T>; // Because many samples have been Dexie.Promise.
 	// The "Dexie.Table" interface. Same as named exported interface Table.

package/dist/dexie.js

@@ -4,7 +4,7 @@
  *
  * By David Fahlander, david.fahlander@gmail.com
  *
- * Version 4.3.0, Sat Dec 20 2025
+ * Version 4.4.1, Wed Mar 25 2026
  *
  * https://dexie.org
  *
@@ -228,12 +228,6 @@
           }
       return rv;
   }
-  function objectIsEmpty(o) {
-      for (var k in o)
-          if (hasOwn(o, k))
-              return false;
-      return true;
-  }
   var circularRefs = null;
   function deepClone(any) {
       circularRefs = new WeakMap();
@@ -1144,12 +1138,12 @@
       }
   }
 
-  var DEXIE_VERSION = '4.3.0';
+  var DEXIE_VERSION = '4.4.1';
   var maxString = String.fromCharCode(65535);
   var minKey = -Infinity;
   var INVALID_KEY_ARGUMENT = "Invalid key provided. Keys must be of type string, number, Date or Array<string | number | Date>.";
   var STRING_EXPECTED = "String expected.";
-  var connections = [];
+  var DEFAULT_MAX_CONNECTIONS = 1000;
   var DBNAMES_DB = '__dbnames';
   var READONLY = 'readonly';
   var READWRITE = 'readwrite';
@@ -1981,13 +1975,14 @@
           var _this = this;
           return this._read(function (trans) {
               var ctx = _this._ctx;
-              if (ctx.dir === 'next' && isPlainKeyRange(ctx, true) && ctx.limit > 0) {
+              if (isPlainKeyRange(ctx, true) && ctx.limit > 0) {
                   var valueMapper_1 = ctx.valueMapper;
                   var index = getIndexOrStore(ctx, ctx.table.core.schema);
                   return ctx.table.core.query({
                       trans: trans,
                       limit: ctx.limit,
                       values: true,
+                      direction: ctx.dir === 'prev' ? 'prev' : undefined,
                       query: {
                           index: index,
                           range: ctx.range
@@ -2112,13 +2107,14 @@
       };
       Collection.prototype.primaryKeys = function (cb) {
           var ctx = this._ctx;
-          if (ctx.dir === 'next' && isPlainKeyRange(ctx, true) && ctx.limit > 0) {
+          if (isPlainKeyRange(ctx, true) && ctx.limit > 0) {
               return this._read(function (trans) {
                   var index = getIndexOrStore(ctx, ctx.table.core.schema);
                   return ctx.table.core.query({
                       trans: trans,
                       values: false,
                       limit: ctx.limit,
+                      direction: ctx.dir === 'prev' ? 'prev' : undefined,
                       query: {
                           index: index,
                           range: ctx.range
@@ -3008,6 +3004,9 @@
   function createDBCore(db, IdbKeyRange, tmpTrans) {
       function extractSchema(db, trans) {
           var tables = arrayify(db.objectStoreNames);
+          var tempStore = tables.length > 0
+              ? trans.objectStore(tables[0])
+              : {};
           return {
               schema: {
                   name: db.name,
@@ -3052,10 +3051,11 @@
                       return result;
                   })
               },
-              hasGetAll: tables.length > 0 && ('getAll' in trans.objectStore(tables[0])) &&
+              hasGetAll: tables.length > 0 && ('getAll' in tempStore) &&
                   !(typeof navigator !== 'undefined' && /Safari/.test(navigator.userAgent) &&
                       !/(Chrome\/|Edge\/)/.test(navigator.userAgent) &&
-                      [].concat(navigator.userAgent.match(/Safari\/(\d*)/))[1] < 604)
+                      [].concat(navigator.userAgent.match(/Safari\/(\d*)/))[1] < 604),
+              hasIdb3Features: 'getAllRecords' in tempStore
           };
       }
       function makeIDBKeyRange(range) {
@@ -3226,11 +3226,13 @@
                   }, reject);
               });
           }
-          function query(hasGetAll) {
+          function query(hasGetAll, hasIdb3Features) {
               return function (request) {
                   return new Promise(function (resolve, reject) {
+                      var _a;
                       resolve = wrap(resolve);
                       var trans = request.trans, values = request.values, limit = request.limit, query = request.query;
+                      var direction = (_a = request.direction) !== null && _a !== void 0 ? _a : 'next';
                       var nonInfinitLimit = limit === Infinity ? undefined : limit;
                       var index = query.index, range = query.range;
                       var store = trans.objectStore(tableName);
@@ -3238,7 +3240,19 @@
                       var idbKeyRange = makeIDBKeyRange(range);
                       if (limit === 0)
                           return resolve({ result: [] });
-                      if (hasGetAll) {
+                      if (hasIdb3Features) {
+                          var options = {
+                              query: idbKeyRange,
+                              count: nonInfinitLimit,
+                              direction: direction
+                          };
+                          var req = values ?
+                              source.getAll(options) :
+                              source.getAllKeys(options);
+                          req.onsuccess = function (event) { return resolve({ result: event.target.result }); };
+                          req.onerror = eventRejectHandler(reject);
+                      }
+                      else if (hasGetAll && direction === 'next') {
                           var req = values ?
                               source.getAll(idbKeyRange, nonInfinitLimit) :
                               source.getAllKeys(idbKeyRange, nonInfinitLimit);
@@ -3248,10 +3262,10 @@
                       else {
                           var count_1 = 0;
                           var req_1 = values || !('openKeyCursor' in source) ?
-                              source.openCursor(idbKeyRange) :
-                              source.openKeyCursor(idbKeyRange);
+                              source.openCursor(idbKeyRange, direction) :
+                              source.openKeyCursor(idbKeyRange, direction);
                           var result_1 = [];
-                          req_1.onsuccess = function (event) {
+                          req_1.onsuccess = function () {
                               var cursor = req_1.result;
                               if (!cursor)
                                   return resolve({ result: result_1 });
@@ -3311,7 +3325,7 @@
                       req.onerror = eventRejectHandler(reject);
                   });
               },
-              query: query(hasGetAll),
+              query: query(hasGetAll, hasIdb3Features),
               openCursor: openCursor,
               count: function (_a) {
                   var query = _a.query, trans = _a.trans;
@@ -3327,7 +3341,7 @@
               }
           };
       }
-      var _a = extractSchema(db, tmpTrans), schema = _a.schema, hasGetAll = _a.hasGetAll;
+      var _a = extractSchema(db, tmpTrans), schema = _a.schema, hasGetAll = _a.hasGetAll, hasIdb3Features = _a.hasIdb3Features;
       var tables = schema.tables.map(function (tableSchema) { return createDbCoreTable(tableSchema); });
       var tableMap = {};
       tables.forEach(function (table) { return tableMap[table.name] = table; });
@@ -3779,6 +3793,63 @@
       });
   }
 
+  var connections = createConnectionsManager();
+  function createConnectionsManager() {
+      if (typeof FinalizationRegistry !== 'undefined' && typeof WeakRef !== 'undefined') {
+          var _refs_1 = new Set();
+          var _registry_1 = new FinalizationRegistry(function (ref) {
+              _refs_1.delete(ref);
+          });
+          var toArray = function () {
+              return Array.from(_refs_1)
+                  .map(function (ref) { return ref.deref(); })
+                  .filter(function (db) { return db !== undefined; });
+          };
+          var add = function (db) {
+              var ref = new WeakRef(db._novip);
+              _refs_1.add(ref);
+              _registry_1.register(db._novip, ref, ref);
+              if (_refs_1.size > db._options.maxConnections) {
+                  var oldestRef = _refs_1.values().next().value;
+                  _refs_1.delete(oldestRef);
+                  _registry_1.unregister(oldestRef);
+              }
+          };
+          var remove = function (db) {
+              if (!db)
+                  return;
+              var iterator = _refs_1.values();
+              var result = iterator.next();
+              while (!result.done) {
+                  var ref = result.value;
+                  if (ref.deref() === db._novip) {
+                      _refs_1.delete(ref);
+                      _registry_1.unregister(ref);
+                      return;
+                  }
+                  result = iterator.next();
+              }
+          };
+          return { toArray: toArray, add: add, remove: remove };
+      }
+      else {
+          var connections_1 = [];
+          var toArray = function () { return connections_1; };
+          var add = function (db) {
+              connections_1.push(db._novip);
+          };
+          var remove = function (db) {
+              if (!db)
+                  return;
+              var index = connections_1.indexOf(db._novip);
+              if (index !== -1) {
+                  connections_1.splice(index, 1);
+              }
+          };
+          return { toArray: toArray, add: add, remove: remove };
+      }
+  }
+
   function getDbNamesTable(indexedDB, IDBKeyRange) {
       var dbNamesDB = indexedDB["_dbNamesDB"];
       if (!dbNamesDB) {
@@ -4157,7 +4228,7 @@
                   }
                   catch (e) {
                   }
-              connections.push(db);
+              connections.add(db);
               idbdb.onversionchange = wrap(function (ev) {
                   state.vcFired = true;
                   db.on("versionchange").fire(ev);
@@ -5002,10 +5073,13 @@
       }, result);
       if (finalResult === result)
           return result;
-      finalResult.sort(function (a, b) {
+      var sorter = function (a, b) {
           return cmp(extractLowLevelIndex(a), extractLowLevelIndex(b)) ||
               cmp(extractPrimKey(a), extractPrimKey(b));
-      });
+      };
+      finalResult.sort(req.direction === 'prev' || req.direction === 'prevunique'
+          ? function (a, b) { return sorter(b, a); }
+          : sorter);
       if (req.limit && req.limit < Infinity) {
           if (finalResult.length > req.limit) {
               finalResult.length = req.limit;
@@ -5062,6 +5136,7 @@
   }
 
   function findCompatibleQuery(dbName, tableName, type, req) {
+      var _a;
       var tblCache = cache["idb://".concat(dbName, "/").concat(tableName)];
       if (!tblCache)
           return [];
@@ -5074,9 +5149,12 @@
           return [null, false, tblCache, null];
       switch (type) {
           case 'query':
+              var reqDirection_1 = (_a = req.direction) !== null && _a !== void 0 ? _a : 'next';
               var equalEntry = entries.find(function (entry) {
+                  var _a;
                   return entry.req.limit === req.limit &&
                       entry.req.values === req.values &&
+                      ((_a = entry.req.direction) !== null && _a !== void 0 ? _a : 'next') === reqDirection_1 &&
                       areRangesEqual(entry.req.query.range, req.query.range);
               });
               if (equalEntry)
@@ -5087,8 +5165,10 @@
                       entries,
                   ];
               var superEntry = entries.find(function (entry) {
+                  var _a;
                   var limit = 'limit' in entry.req ? entry.req.limit : Infinity;
                   return (limit >= req.limit &&
+                      ((_a = entry.req.direction) !== null && _a !== void 0 ? _a : 'next') === reqDirection_1 &&
                       (req.values ? entry.req.values : true) &&
                       isSuperRange(entry.req.query.range, req.query.range));
               });
@@ -5338,7 +5418,7 @@
           var deps = Dexie.dependencies;
           this._options = options = __assign({
               addons: Dexie.addons, autoOpen: true,
-              indexedDB: deps.indexedDB, IDBKeyRange: deps.IDBKeyRange, cache: 'cloned' }, options);
+              indexedDB: deps.indexedDB, IDBKeyRange: deps.IDBKeyRange, cache: 'cloned', maxConnections: DEFAULT_MAX_CONNECTIONS }, options);
           this._deps = {
               indexedDB: options.indexedDB,
               IDBKeyRange: options.IDBKeyRange
@@ -5432,7 +5512,7 @@
           this._createTransaction = function (mode, storeNames, dbschema, parentTransaction) { return new _this.Transaction(mode, storeNames, dbschema, _this._options.chromeTransactionDurability, parentTransaction); };
           this._fireOnBlocked = function (ev) {
               _this.on("blocked").fire(ev);
-              connections
+              connections.toArray()
                   .filter(function (c) { return c.name === _this.name && c !== _this && !c._state.vcFired; })
                   .map(function (c) { return c.on("versionchange").fire(ev); });
           };
@@ -5525,9 +5605,7 @@
       Dexie.prototype._close = function () {
           this.on.close.fire(new CustomEvent('close'));
           var state = this._state;
-          var idx = connections.indexOf(this);
-          if (idx >= 0)
-              connections.splice(idx, 1);
+          connections.remove(this);
           if (this.idbdb) {
               try {
                   this.idbdb.close();
@@ -5778,22 +5856,32 @@
                   signal: abortController.signal,
                   requery: doQuery,
                   querier: querier,
-                  trans: null
+                  trans: null,
               };
               var ret = execute(ctx);
+              if (!startedListening) {
+                  globalEvents(DEXIE_STORAGE_MUTATED_EVENT_NAME, mutationListener);
+                  startedListening = true;
+              }
               Promise.resolve(ret).then(function (result) {
                   hasValue = true;
                   currentValue = result;
                   if (closed || ctx.signal.aborted) {
                       return;
                   }
-                  accumMuts = {};
-                  currentObs = subscr;
-                  if (!objectIsEmpty(currentObs) && !startedListening) {
-                      globalEvents(DEXIE_STORAGE_MUTATED_EVENT_NAME, mutationListener);
-                      startedListening = true;
+                  if (shouldNotify()) {
+                      doQuery();
+                  }
+                  else {
+                      currentObs = subscr;
+                      if (shouldNotify()) {
+                          doQuery();
+                      }
+                      else {
+                          accumMuts = {};
+                          execInGlobalContext(function () { return !closed && observer.next && observer.next(result); });
+                      }
                   }
-                  execInGlobalContext(function () { return !closed && observer.next && observer.next(result); });
               }, function (err) {
                   hasValue = false;
                   if (!['DatabaseClosedError', 'AbortError'].includes(err === null || err === void 0 ? void 0 : err.name)) {
@@ -5889,7 +5977,9 @@
       getByKeyPath: getByKeyPath, setByKeyPath: setByKeyPath, delByKeyPath: delByKeyPath, shallowClone: shallowClone, deepClone: deepClone, getObjectDiff: getObjectDiff, cmp: cmp, asap: asap$1,
       minKey: minKey,
       addons: [],
-      connections: connections,
+      connections: {
+          get: connections.toArray
+      },
       errnames: errnames,
       dependencies: domDeps, cache: cache,
       semVer: DEXIE_VERSION, version: DEXIE_VERSION.split('.')
@@ -5953,8 +6043,8 @@
               if (debug)
                   console.debug('Dexie: handling persisted pagehide');
               bc === null || bc === void 0 ? void 0 : bc.close();
-              for (var _i = 0, connections_1 = connections; _i < connections_1.length; _i++) {
-                  var db = connections_1[_i];
+              for (var _i = 0, _a = connections.toArray(); _i < _a.length; _i++) {
+                  var db = _a[_i];
                   db.close({ disableAutoOpen: false });
               }
           }
@@ -5986,6 +6076,7 @@
 
   var namedExports = /*#__PURE__*/Object.freeze({
     __proto__: null,
+    DEFAULT_MAX_CONNECTIONS: DEFAULT_MAX_CONNECTIONS,
     Dexie: Dexie$1,
     Entity: Entity,
     PropModification: PropModification,