indexeddbshim 17.3.3 → 17.4.0

package/dist/indexeddbshim.js

@@ -1,4 +1,4 @@
-/*! indexeddbshim - v17.3.3 - 8/25/2026 */
+/*! indexeddbshim - v17.4.0 - 8/27/2026 */
 
 (function (factory) {
   typeof define === 'function' && define.amd ? define(factory) :
@@ -1754,6 +1754,7 @@
    *   sqlBusyTimeout: number,
    *   sqlTrace: () => void,
    *   sqlProfile: () => void,
+   *   sqlMemoryQuota: number,
    *   escapeNULForSQLiteStatements: boolean,
    *   createIndexes: boolean
    * }} ConfigValues
@@ -1910,7 +1911,7 @@
   'sqlProfile',
   // Callback not used by default
   // Defaults to true except in Node builds where we can preserve literal NUL with better-sqlite3
-  'escapeNULForSQLiteStatements', 'createIndexes'].forEach(function (prop) {
+  'escapeNULForSQLiteStatements', 'sqlMemoryQuota', 'createIndexes'].forEach(function (prop) {
     /** @type {(val: any) => void} */
     var validator;
     if (Array.isArray(prop)) {
@@ -2931,41 +2932,40 @@
    *   optional here and, in practice, always `undefined` today (the `case 4`/
    *   `case 7` branches below are effectively unreachable pending upstream
    *   support for surfacing a real error code).
-   * @param {Error & {code?: number}} webSQLErr
+   * @param {Error & {code?: number|string}} webSQLErr
    * @returns {(DOMException|Error) & {
-   *   sqlError: Error & {code?: number}
+   *   sqlError: Error & {code?: number|string}
    * }|QuotaExceededError}
    */
   function webSQLErrback(webSQLErr) {
     var name,
       message,
       useQuotaExceededError = false;
-    switch (webSQLErr.code) {
-      case 4:
-        {
-          // SQLError.QUOTA_ERR
-          name = 'QuotaExceededError';
-          message = 'The operation failed because there was not enough ' + 'remaining storage space, or the storage quota was reached ' + 'and the user declined to give more space to the database.';
-          if (typeof QuotaExceededError !== 'undefined') {
-            useQuotaExceededError = true;
-          }
-          break;
-        }
-      /*
-      // Should a WebSQL timeout treat as IndexedDB `TransactionInactiveError` or `UnknownError`?
-      case 7: { // SQLError.TIMEOUT_ERR
-          // All transaction errors abort later, so no need to mark inactive
-          name = 'TransactionInactiveError';
-          message = 'A request was placed against a transaction which is currently not active, or which is finished (Internal SQL Timeout).';
-          break;
+    if (webSQLErr.code === 4 || webSQLErr.code === 'SQLITE_FULL') {
+      // SQLError.QUOTA_ERR or better-sqlite3 SQLITE_FULL
+      name = 'QuotaExceededError';
+      message = 'The operation failed because there was not enough ' + 'remaining storage space, or the storage quota was reached ' + 'and the user declined to give more space to the database.';
+      if (typeof QuotaExceededError !== 'undefined') {
+        useQuotaExceededError = true;
       }
-      */
-      default:
-        {
-          name = 'UnknownError';
-          message = 'The operation failed for reasons unrelated to the database itself and not covered by any other errors.';
-          break;
+    } else {
+      switch (webSQLErr.code) {
+        /*
+        // Should a WebSQL timeout treat as IndexedDB `TransactionInactiveError` or `UnknownError`?
+        case 7: { // SQLError.TIMEOUT_ERR
+            // All transaction errors abort later, so no need to mark inactive
+            name = 'TransactionInactiveError';
+            message = 'A request was placed against a transaction which is currently not active, or which is finished (Internal SQL Timeout).';
+            break;
         }
+        */
+        default:
+          {
+            name = 'UnknownError';
+            message = 'The operation failed for reasons unrelated to the database itself and not covered by any other errors.';
+            break;
+          }
+      }
     }
     message += ' (' + webSQLErr.message + ')--(' + webSQLErr.code + ')';
     if (useQuotaExceededError) {
@@ -2974,7 +2974,7 @@
     var err =
     /**
      * @type {(Error | DOMException) & {
-     *   sqlError: Error & {code?: number}
+     *   sqlError: Error & {code?: number|string}
      * }}
      */
     createDOMException(name, message);
@@ -3541,6 +3541,32 @@
   }
 
   var _templateObject, _templateObject2;
+  /**
+   * @param {unknown[]} arr
+   * @param {number} index
+   * @param {unknown} val
+   * @returns {void}
+   */
+  var setArrayValue = function setArrayValue(arr, index, val) {
+    if (Reflect.has(Array.prototype, index)) {
+      Object.defineProperty(arr, index, {
+        value: val,
+        enumerable: true,
+        writable: true,
+        configurable: true
+      });
+    } else {
+      arr[index] = val;
+    }
+  };
+  /**
+   * @param {unknown[]} arr
+   * @param {unknown} val
+   * @returns {void}
+   */
+  var safePush = function safePush(arr, val) {
+    return setArrayValue(arr, arr.length, val);
+  };
 
   /**
    * @typedef {NodeJS.TypedArray|DataView} ArrayBufferView
@@ -3804,6 +3830,7 @@
        * @returns {string}
        */
       encode: function encode(key) {
+        /** @type {(string|null)[]} */
         var encoded = [];
         var _iterator = _createForOfIteratorHelper(key.entries()),
           _step;
@@ -3813,14 +3840,14 @@
               i = _step$value[0],
               item = _step$value[1];
             var encodedItem = _encode(item, true); // encode the array item
-            encoded[i] = encodedItem;
+            setArrayValue(encoded, i, encodedItem);
           }
         } catch (err) {
           _iterator.e(err);
         } finally {
           _iterator.f();
         }
-        encoded.push(keyTypeToEncodedChar.invalid + '-'); // append an extra item, so empty arrays sort correctly
+        safePush(encoded, keyTypeToEncodedChar.invalid + '-'); // append an extra item, so empty arrays sort correctly
         var encodedKey = JSON.stringify(encoded);
         if (CFG.escapeNULForSQLiteStatements === false) {
           encodedKey = encodedKey.replaceAll(String.raw(_templateObject || (_templateObject = _taggedTemplateLiteral(["\0"], ["\\u0000"]))), '\0');
@@ -3841,7 +3868,7 @@
         for (var i = 0; i < decoded.length; i++) {
           var item = decoded[i];
           var decodedItem = _decode(item, true); // decode the item
-          decoded[i] = decodedItem;
+          setArrayValue(decoded, i, decodedItem);
         }
         return decoded;
       }
@@ -4139,7 +4166,7 @@
           // May throw (from binary)
           var arr = /** @type {Array<any>} */input;
           var len = arr.length;
-          seen.push(input);
+          safePush(seen, input);
 
           /** @type {(KeyValueObject|Value)[]} */
           var keys = [];
@@ -4174,7 +4201,7 @@
                 }) || fullKeys && keys.every(function (k) {
                   return cmp(k, key) !== 0;
                 })) {
-                  keys.push(fullKeys ? key : key.value);
+                  safePush(keys, fullKeys ? key : key.value);
                 }
               } catch (err) {
                 if (!multiEntry) {
@@ -4334,7 +4361,7 @@
         if (key.failure) {
           return true;
         }
-        result.push(key.value);
+        safePush(result, key.value);
         return false;
       }) ? {
         failure: true
@@ -4395,11 +4422,21 @@
     identifiers.forEach(function (identifier) {
       var hop = Object.hasOwn(value, identifier);
       if (!hop) {
-        value[identifier] = {};
+        Object.defineProperty(value, identifier, {
+          value: {},
+          enumerable: true,
+          writable: true,
+          configurable: true
+        });
       }
       value = value[identifier];
     });
-    value[(/** @type {string} */last)] = key; // key is already a `keyValue` in our processing so no need to convert
+    Object.defineProperty(value, /** @type {string} */last, {
+      value: key,
+      enumerable: true,
+      writable: true,
+      configurable: true
+    }); // key is already a `keyValue` in our processing so no need to convert
   }
 
   /**
@@ -4477,6 +4514,7 @@
    * @returns {Key[]}
    */
   function findMultiEntryMatches(keyEntry, range) {
+    /** @type {unknown[]} */
     var matches = [];
     if (Array.isArray(keyEntry)) {
       var _iterator4 = _createForOfIteratorHelper(keyEntry),
@@ -4493,13 +4531,13 @@
             } else {
               var nested = findMultiEntryMatches(key, range);
               if (nested.length > 0) {
-                matches.push(key);
+                safePush(matches, key);
               }
               continue;
             }
           }
           if (isNullish(range) || isKeyInRange(key, range, true)) {
-            matches.push(key);
+            safePush(matches, key);
           }
         }
       } catch (err) {
@@ -4508,7 +4546,7 @@
         _iterator4.f();
       }
     } else if (isNullish(range) || isKeyInRange(keyEntry, range, true)) {
-      matches.push(keyEntry);
+      safePush(matches, keyEntry);
     }
     return matches;
   }
@@ -4530,12 +4568,13 @@
         }
       case 'array':
         {
+          /** @type {ValueType[]} */
           var array = [];
           var len = value.length;
           var index = 0;
           while (index < len) {
             var entry = convertKeyToValue(value[index]);
-            array[index] = entry;
+            setArrayValue(array, index, entry);
             index++;
           }
           return array;
@@ -5295,6 +5334,7 @@
   }
 
   var uniqueID = 0;
+  var activeTransactions = new Set();
   var listeners$1 = ['onabort', 'oncomplete', 'onerror'];
   var readonlyProperties$4 = ['objectStoreNames', 'mode', 'durability', 'db', 'error'];
 
@@ -5426,6 +5466,7 @@
       me.__mode = mode;
       me.__durability = durability;
       me.__db = db;
+      activeTransactions.add(me);
       me.__error = null;
       // @ts-expect-error Part of `ShimEventTarget`
       me.__setOptions({
@@ -5938,6 +5979,7 @@
           me.__errored = true;
           throw e;
         } finally {
+          activeTransactions.delete(me);
           me.__storeHandles = {};
         }
       }
@@ -6144,7 +6186,7 @@
       });
     }
     me.__active = false; // Setting here and in requestsFinished for https://github.com/w3c/IndexedDB/issues/87
-
+    activeTransactions.delete(me);
     if (err !== null) {
       me.__error = err;
     }
@@ -6365,7 +6407,7 @@
    * @returns {void}
    */
   IDBTransaction.__assertActive = function (tx) {
-    if (!tx || !tx.__active || tx.__committed) {
+    if (!tx || !tx.__active || !tx.__handlerActive || tx.__committed) {
       throw createDOMException('TransactionInactiveError', 'A request was placed against a transaction which is currently not active, or which is finished');
     }
   };
@@ -6392,6 +6434,9 @@
   Object.defineProperty(IDBTransaction, 'prototype', {
     writable: false
   });
+  /* eslint-enable unicorn/no-top-level-side-effects -- Would be good */
+
+  IDBTransaction.activeTransactions = activeTransactions;
 
   var TypesonPromise = /*#__PURE__*/_createClass(function TypesonPromise(e) {
     _classCallCheck(this, TypesonPromise);
@@ -7778,7 +7823,7 @@
         }
       }
     },
-    k = {
+    D = {
       map: {
         test: function test(e) {
           return "Map" === toStringTag(e);
@@ -7791,7 +7836,7 @@
         }
       }
     },
-    D = {
+    R = {
       nan: {
         test: function test(e) {
           return Number.isNaN(e);
@@ -8140,8 +8185,8 @@
         revive: function revive() {}
       }
     }],
-    ne = [D, M, L, F],
-    ce = [Z, Y, re, K, ne, O, z, U, _, B, I, h, N, C].concat("function" == typeof Map ? k : [], "function" == typeof Set ? H : [], "function" == typeof ArrayBuffer ? p : [], "function" == typeof Uint8Array ? X : [], "function" == typeof DataView ? w : [], "undefined" != typeof crypto ? v : [], "undefined" != typeof BigInt ? [m, d] : [], "undefined" != typeof DOMException ? A : [], "undefined" != typeof QuotaExceededError ? W : [], "undefined" != typeof WebTransportError ? te : [], "undefined" != typeof DOMRect ? x : [], "undefined" != typeof DOMPoint ? S : [], "undefined" != typeof DOMQuad ? P : [], "undefined" != typeof DOMMatrix ? T : [], "undefined" != typeof AudioData ? f : [], "undefined" != typeof EncodedAudioChunk ? E : [], "undefined" != typeof EncodedVideoChunk ? j : [], "undefined" != typeof VideoFrame ? ee : []);
+    ne = [R, M, L, F],
+    ce = [Z, Y, re, K, ne, O, z, U, _, B, I, h, N, C].concat("function" == typeof Map ? D : [], "function" == typeof Set ? H : [], "function" == typeof ArrayBuffer ? p : [], "function" == typeof Uint8Array ? X : [], "function" == typeof DataView ? w : [], "undefined" != typeof crypto ? v : [], "undefined" != typeof BigInt ? [m, d] : [], "undefined" != typeof DOMException ? A : [], "undefined" != typeof QuotaExceededError ? W : [], "undefined" != typeof WebTransportError ? te : [], "undefined" != typeof DOMRect ? x : [], "undefined" != typeof DOMPoint ? S : [], "undefined" != typeof DOMQuad ? P : [], "undefined" != typeof DOMMatrix ? T : [], "undefined" != typeof AudioData ? f : [], "undefined" != typeof EncodedAudioChunk ? E : [], "undefined" != typeof EncodedVideoChunk ? j : [], "undefined" != typeof VideoFrame ? ee : []);
   var ue = ce.concat({
       checkDataCloneException: {
         test: function test(e) {
@@ -8158,11 +8203,56 @@
           return false;
         }
       }
+    }),
+    ye = ue.concat({
+      checkSharedArrayBufferException: {
+        test: function test(e) {
+          if ("SharedArrayBuffer" === {}.toString.call(e).slice(8, -1)) throw new DOMException("The object cannot be cloned.", "DataCloneError");
+          return false;
+        }
+      }
     });
 
   // See: https://stackoverflow.com/questions/42170826/categories-for-rejection-by-the-structured-cloning-algorithm
 
-  var typeson = new Typeson().register(ue);
+  // Although typeson-registry already has a FileList type in its structured cloning presets,
+  //   we need to override it so it works with our tests
+
+  var specSet = ye.flatMap(function (preset) {
+    return Array.isArray(preset) ? preset : [preset];
+  }).find(function (preset) {
+    return preset && !Array.isArray(preset) && 'filelist' in preset;
+  });
+  var origFileList = specSet && !Array.isArray(specSet) && 'filelist' in specSet ? specSet.filelist : undefined;
+  var origTest = origFileList && _typeof(origFileList) === 'object' && 'test' in origFileList && typeof origFileList.test === 'function' ? origFileList.test : undefined;
+  var origRevive = origFileList && _typeof(origFileList) === 'object' && 'revive' in origFileList && typeof origFileList.revive === 'function' ? origFileList.revive : undefined;
+  var customFileList = origFileList ? _objectSpread2(_objectSpread2({}, origFileList), {}, {
+    /**
+     * @param {unknown} x
+     * @param {import('typeson').StateObject} state
+     * @returns {boolean}
+     */
+    test: function test(x, state) {
+      if (typeof FileList !== 'undefined') {
+        return x instanceof FileList;
+      }
+      return typeof origTest === 'function' ? origTest(x, state) : false;
+    },
+    /**
+     * @param {unknown} x
+     * @param {import('typeson').StateObject} state
+     * @returns {unknown}
+     */
+    revive: function revive(x, state) {
+      if (typeof FileList !== 'undefined') {
+        return Reflect.construct(FileList, [x]);
+      }
+      return typeof origRevive === 'function' ? origRevive(x, state) : undefined;
+    }
+  }) : undefined;
+  var typeson = new Typeson().register([ye, customFileList ? {
+    filelist: customFileList
+  } : {}]);
 
   /**
    * @param {(preset: import('typeson-registry').Preset) =>
@@ -8171,7 +8261,7 @@
    */
   function register(func) {
     // eslint-disable-next-line unicorn/no-top-level-assignment-in-function -- Should be one-time cache
-    typeson = new Typeson().register(func(ue));
+    typeson = new Typeson().register(func(ye));
   }
 
   /**
@@ -9470,7 +9560,7 @@
           tx.executeSql('INSERT INTO __sys__ VALUES (?,?,?,?,?)', [escapeSQLiteStatement(storeName), encodedKeyPath,
           // For why converting here, see comment and following
           //  discussion at:
-          //  https://github.com/axemclion/IndexedDBShim/issues/313#issuecomment-590086778
+          //  https://github.com/indexeddbshim/IndexedDBShim/issues/313#issuecomment-590086778
           Number(store.autoIncrement), '{}', 1], function () {
             delete store.__pendingCreate;
             delete store.__deleted;
@@ -11470,6 +11560,7 @@
     }
     var req = IDBOpenDBRequest.__createInstance();
     var calledDbCreateError = false;
+    var isRevertingSysdb = false;
     if (CFG.autoName && name === '') {
       // eslint-disable-next-line unicorn/no-top-level-assignment-in-function -- Necessary?
       name = 'autoNamedDatabase_' + nameCounter++;
@@ -11496,7 +11587,7 @@
      * @returns {boolean}
      */
     function dbCreateError(tx, err) {
-      if (calledDbCreateError) {
+      if (calledDbCreateError || isRevertingSysdb) {
         return false;
       }
       // Defensive cleanup: `pendingVersionChanges.set(name, ...)` (see
@@ -11560,36 +11651,46 @@
              */
             var sysdbFinishedCb = function sysdbFinishedCb(systx, err, cb) {
               if (err) {
-                try {
-                  systx.executeSql('ROLLBACK', [], cb, cb);
-                } catch (err) {
-                  // Browser may fail with expired transaction above so
-                  //     no choice but to manually revert
+                /**
+                 * @param {any} [errorToShow]
+                 * @returns {void}
+                 */
+                var manualRevert = function manualRevert(errorToShow) {
+                  /**
+                   * @param {string} [msg]
+                   * @throws {Error}
+                   * @returns {never}
+                   */
+                  function reportError(msg) {
+                    throw new Error('Unable to roll back upgrade transaction!' + (msg || ''));
+                  }
                   sysdb.transaction(function (systx) {
-                    /**
-                     *
-                     * @param {string} msg
-                     * @throws {Error}
-                     * @returns {never}
-                     */
-                    function reportError(msg) {
-                      throw new Error('Unable to roll back upgrade transaction!' + (msg || ''));
-                    }
-
                     // Attempt to revert
                     if (oldVersion === 0) {
-                      systx.executeSql('DELETE FROM dbVersions WHERE "name" = ?', [sqlSafeName], function () {
-                        // @ts-expect-error Force to work
-                        cb(reportError); // eslint-disable-line promise/no-callback-in-promise -- Convenient
-                      },
-                      // @ts-expect-error Force to work
-                      reportError);
+                      systx.executeSql('DELETE FROM dbVersions WHERE "name" = ?', [sqlSafeName]);
                     } else {
-                      systx.executeSql('UPDATE dbVersions SET "version" = ? WHERE "name" = ?', [oldVersion, sqlSafeName], cb,
-                      // @ts-expect-error Force to work
-                      reportError);
+                      systx.executeSql('UPDATE dbVersions SET "version" = ? WHERE "name" = ?', [oldVersion, sqlSafeName]);
                     }
+                  }, function (sqlErr) {
+                    isRevertingSysdb = false;
+                    cb(sqlErr); // eslint-disable-line promise/no-callback-in-promise -- Convenient
+                  }, function () {
+                    isRevertingSysdb = false;
+                    cb(errorToShow || reportError); // eslint-disable-line promise/no-callback-in-promise -- Convenient
+                  });
+                };
+                try {
+                  systx.executeSql('ROLLBACK', [], function () {
+                    cb(); // eslint-disable-line promise/no-callback-in-promise -- Convenient
+                  }, function (tx, sqlErr) {
+                    // Browser/Node may fail with expired transaction, so manually revert
+                    manualRevert(sqlErr);
+                    return false;
                   });
+                } catch (e) {
+                  // Browser may fail with expired transaction above so
+                  //     no choice but to manually revert
+                  manualRevert(e);
                 }
                 return;
               }
@@ -11690,6 +11791,7 @@
 
                 // eslint-disable-next-line camelcase -- Clear API
                 req.transaction.on__preabort = function () {
+                  isRevertingSysdb = true;
                   pendingVersionChanges.delete(name);
                   connection.__upgradeTransaction = null;
                   // We ensure any cache is deleted before any request error events fire and try to reopen
@@ -11707,6 +11809,7 @@
                   req.__result = undefined;
                   req.__done = false;
                   connection.close();
+                  isRevertingSysdb = true;
                   setTimeout(function () {
                     var err = createDOMException('AbortError', 'The upgrade transaction was aborted.');
                     sysdbFinishedCb(systx, err, function (reportError) {
@@ -11768,7 +11871,26 @@
               }
               sysdbFinishedCb = function sysdbFinishedCb(systx, err, cb) {
                 if (err) {
-                  rollback(err, cb);
+                  rollback(err,
+                  /**
+                   * @param {Error} [reportError]
+                   * @returns {void}
+                   */
+                  function (reportError) {
+                    sysdb.transaction(function (systx) {
+                      if (oldVersion === 0) {
+                        systx.executeSql('DELETE FROM dbVersions WHERE "name" = ?', [sqlSafeName]);
+                      } else {
+                        systx.executeSql('UPDATE dbVersions SET "version" = ? WHERE "name" = ?', [oldVersion, sqlSafeName]);
+                      }
+                    }, function (sqlErr) {
+                      isRevertingSysdb = false;
+                      cb(sqlErr); // eslint-disable-line promise/no-callback-in-promise -- Convenient
+                    }, function () {
+                      isRevertingSysdb = false;
+                      cb(reportError); // eslint-disable-line promise/no-callback-in-promise -- Convenient
+                    });
+                  });
                 } else {
                   commit(cb);
                 }
@@ -13881,7 +14003,7 @@
     // Ignore Node or other environments
     // Bad non-Chrome Android support
     /Android (?:2|3|4\.[0-3])/.test(navigator.userAgent) && !navigator.userAgent.includes('Chrome') ||
-    // Bad non-Safari iOS9 support (see <https://github.com/axemclion/IndexedDBShim/issues/252>)
+    // Bad non-Safari iOS9 support (see <https://github.com/indexeddbshim/IndexedDBShim/issues/252>)
     (!navigator.userAgent.includes('Safari') || navigator.userAgent.includes('Chrome')) &&
     // Exclude genuine Safari: https://stackoverflow.com/a/7768006/271577
     // Detect iOS: https://stackoverflow.com/questions/9038625/detect-if-device-is-ios/9039885#9039885
@@ -13891,8 +14013,8 @@
     if (!CFG.DEFAULT_DB_SIZE) {
       CFG.DEFAULT_DB_SIZE = (
       // Safari currently requires larger size: (We don't need a larger size for Node as node-websql doesn't use this info)
-      // https://github.com/axemclion/IndexedDBShim/issues/41
-      // https://github.com/axemclion/IndexedDBShim/issues/115
+      // https://github.com/indexeddbshim/IndexedDBShim/issues/41
+      // https://github.com/indexeddbshim/IndexedDBShim/issues/115
       typeof navigator !== 'undefined' &&
       // React Native
       navigator.userAgent && navigator.userAgent.includes('Safari') && !navigator.userAgent.includes('Chrome') ? 25 : 4) * 1024 * 1024;