dexie 4.2.1-rc.1 → 4.2.1

package/dist/dexie.d.ts

@@ -4,7 +4,7 @@
  *
  * By David Fahlander, david.fahlander@gmail.com
  *
- * Version 4.2.1-rc.1, Mon Aug 25 2025
+ * Version 4.2.1, Sat Oct 04 2025
  *
  * https://dexie.org
  *
@@ -588,6 +588,7 @@ export interface DBCorePutRequest {
 	values: readonly any[];
 	keys?: any[];
 	mutatedParts?: ObservabilitySet;
+	upsert?: boolean; // If true, will insert the object if it does not exist. If false, will only update existing objects using the 'updates' property.
 	criteria?: {
 		index: string | null;
 		range: DBCoreKeyRange;
@@ -764,6 +765,7 @@ export interface Table<T = any, TKey = any, TInsertType = T> {
 		value: any;
 		primKey: IndexableType;
 	}) => void | boolean)): PromiseExtended<number>;
+	upsert(key: TKey | T, changes: UpdateSpec<TInsertType>): PromiseExtended<boolean>;
 	put(item: TInsertType, key?: TKey): PromiseExtended<TKey>;
 	delete(key: TKey): PromiseExtended<void>;
 	clear(): PromiseExtended<void>;

package/dist/dexie.js

@@ -4,7 +4,7 @@
  *
  * By David Fahlander, david.fahlander@gmail.com
  *
- * Version 4.2.1-rc.1, Mon Aug 25 2025
+ * Version 4.2.1, Sat Oct 04 2025
  *
  * https://dexie.org
  *
@@ -1152,7 +1152,7 @@
         }
     }
 
-    var DEXIE_VERSION = '4.2.1-rc.1';
+    var DEXIE_VERSION = '4.2.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>.";
@@ -1284,6 +1284,76 @@
         })).then(function () { return res; });
     }
 
+    var PropModification =  (function () {
+        function PropModification(spec) {
+            this["@@propmod"] = spec;
+        }
+        PropModification.prototype.execute = function (value) {
+            var _a;
+            var spec = this["@@propmod"];
+            if (spec.add !== undefined) {
+                var term = spec.add;
+                if (isArray(term)) {
+                    return __spreadArray(__spreadArray([], (isArray(value) ? value : []), true), term, true).sort();
+                }
+                if (typeof term === 'number')
+                    return (Number(value) || 0) + term;
+                if (typeof term === 'bigint') {
+                    try {
+                        return BigInt(value) + term;
+                    }
+                    catch (_b) {
+                        return BigInt(0) + term;
+                    }
+                }
+                throw new TypeError("Invalid term ".concat(term));
+            }
+            if (spec.remove !== undefined) {
+                var subtrahend_1 = spec.remove;
+                if (isArray(subtrahend_1)) {
+                    return isArray(value) ? value.filter(function (item) { return !subtrahend_1.includes(item); }).sort() : [];
+                }
+                if (typeof subtrahend_1 === 'number')
+                    return Number(value) - subtrahend_1;
+                if (typeof subtrahend_1 === 'bigint') {
+                    try {
+                        return BigInt(value) - subtrahend_1;
+                    }
+                    catch (_c) {
+                        return BigInt(0) - subtrahend_1;
+                    }
+                }
+                throw new TypeError("Invalid subtrahend ".concat(subtrahend_1));
+            }
+            var prefixToReplace = (_a = spec.replacePrefix) === null || _a === void 0 ? void 0 : _a[0];
+            if (prefixToReplace && typeof value === 'string' && value.startsWith(prefixToReplace)) {
+                return spec.replacePrefix[1] + value.substring(prefixToReplace.length);
+            }
+            return value;
+        };
+        return PropModification;
+    }());
+
+    function applyUpdateSpec(obj, changes) {
+        var keyPaths = keys(changes);
+        var numKeys = keyPaths.length;
+        var anythingModified = false;
+        for (var i = 0; i < numKeys; ++i) {
+            var keyPath = keyPaths[i];
+            var value = changes[keyPath];
+            var origValue = getByKeyPath(obj, keyPath);
+            if (value instanceof PropModification) {
+                setByKeyPath(obj, keyPath, value.execute(origValue));
+                anythingModified = true;
+            }
+            else if (origValue !== value) {
+                setByKeyPath(obj, keyPath, value);
+                anythingModified = true;
+            }
+        }
+        return anythingModified;
+    }
+
     var Table =  (function () {
         function Table() {
         }
@@ -1480,6 +1550,26 @@
                 return lastResult;
             });
         };
+        Table.prototype.upsert = function (key, modifications) {
+            var _this = this;
+            var keyPath = this.schema.primKey.keyPath;
+            return this._trans('readwrite', function (trans) {
+                return _this.core.get({ trans: trans, key: key }).then(function (existing) {
+                    var obj = existing !== null && existing !== void 0 ? existing : {};
+                    applyUpdateSpec(obj, modifications);
+                    if (keyPath)
+                        setByKeyPath(obj, keyPath, key);
+                    return _this.core.mutate({
+                        trans: trans,
+                        type: 'put',
+                        values: [obj],
+                        keys: [key],
+                        upsert: true,
+                        updates: { keys: [key], changeSpecs: [modifications] }
+                    }).then(function (res) { return res.numFailures ? DexiePromise.reject(res.failures[0]) : !!existing; });
+                });
+            });
+        };
         Table.prototype.update = function (keyOrObject, modifications) {
             if (typeof keyOrObject === 'object' && !isArray(keyOrObject)) {
                 var key = getByKeyPath(keyOrObject, this.schema.primKey.keyPath);
@@ -1821,56 +1911,6 @@
         });
     }
 
-    var PropModification =  (function () {
-        function PropModification(spec) {
-            this["@@propmod"] = spec;
-        }
-        PropModification.prototype.execute = function (value) {
-            var _a;
-            var spec = this["@@propmod"];
-            if (spec.add !== undefined) {
-                var term = spec.add;
-                if (isArray(term)) {
-                    return __spreadArray(__spreadArray([], (isArray(value) ? value : []), true), term, true).sort();
-                }
-                if (typeof term === 'number')
-                    return (Number(value) || 0) + term;
-                if (typeof term === 'bigint') {
-                    try {
-                        return BigInt(value) + term;
-                    }
-                    catch (_b) {
-                        return BigInt(0) + term;
-                    }
-                }
-                throw new TypeError("Invalid term ".concat(term));
-            }
-            if (spec.remove !== undefined) {
-                var subtrahend_1 = spec.remove;
-                if (isArray(subtrahend_1)) {
-                    return isArray(value) ? value.filter(function (item) { return !subtrahend_1.includes(item); }).sort() : [];
-                }
-                if (typeof subtrahend_1 === 'number')
-                    return Number(value) - subtrahend_1;
-                if (typeof subtrahend_1 === 'bigint') {
-                    try {
-                        return BigInt(value) - subtrahend_1;
-                    }
-                    catch (_c) {
-                        return BigInt(0) - subtrahend_1;
-                    }
-                }
-                throw new TypeError("Invalid subtrahend ".concat(subtrahend_1));
-            }
-            var prefixToReplace = (_a = spec.replacePrefix) === null || _a === void 0 ? void 0 : _a[0];
-            if (prefixToReplace && typeof value === 'string' && value.startsWith(prefixToReplace)) {
-                return spec.replacePrefix[1] + value.substring(prefixToReplace.length);
-            }
-            return value;
-        };
-        return PropModification;
-    }());
-
     var Collection =  (function () {
         function Collection() {
         }
@@ -2137,25 +2177,7 @@
                     modifyer = changes;
                 }
                 else {
-                    var keyPaths = keys(changes);
-                    var numKeys = keyPaths.length;
-                    modifyer = function (item) {
-                        var anythingModified = false;
-                        for (var i = 0; i < numKeys; ++i) {
-                            var keyPath = keyPaths[i];
-                            var val = changes[keyPath];
-                            var origVal = getByKeyPath(item, keyPath);
-                            if (val instanceof PropModification) {
-                                setByKeyPath(item, keyPath, val.execute(origVal));
-                                anythingModified = true;
-                            }
-                            else if (origVal !== val) {
-                                setByKeyPath(item, keyPath, val);
-                                anythingModified = true;
-                            }
-                        }
-                        return anythingModified;
-                    };
+                    modifyer = function (item) { return applyUpdateSpec(item, changes); };
                 }
                 var coreTable = ctx.table.core;
                 var _a = coreTable.schema.primaryKey, outbound = _a.outbound, extractKey = _a.extractKey;