indexeddbshim 17.7.0 → 18.0.0

package/dist/indexeddbshim.js

@@ -1,4 +1,4 @@
-/*! indexeddbshim - v17.7.0 - 9/2/2026 */
+/*! indexeddbshim - v18.0.0 - 9/3/2026 */
 
 (function (factory) {
   typeof define === 'function' && define.amd ? define(factory) :
@@ -2111,6 +2111,28 @@
     return str.replaceAll('^', '^^');
   }
 
+  /**
+   * Minimal replacement for `path.join(base, name)` covering our only use case:
+   *   `name` is always a bare file name (no separators and no `.`/`..`), and
+   *   `base` is a directory path expected to be absolute and normalized (an
+   *   empty string means the current working directory). Unlike `path.join`,
+   *   this performs no `.`/`..` resolution. It reuses the separator style of
+   *   `base` (backslash only when `base` uses backslashes and no forward
+   *   slashes, i.e. a Windows path), otherwise `/`; Node's `fs`, SQLite, and
+   *   `websql-configurable` accept either separator on Windows regardless.
+   *   Avoiding `node:path` keeps browser bundles free of a path polyfill.
+   * @param {string} base
+   * @param {string} name
+   * @returns {string}
+   */
+  function joinPath(base, name) {
+    if (!base) {
+      return name;
+    }
+    var sep = base.includes('\\') && !base.includes('/') ? '\\' : '/';
+    return base.replace(/[\/\\]+$/, '') + sep + name;
+  }
+
   /**
    * @typedef {Function} AnyClass
    */
@@ -2854,7 +2876,7 @@
 
   /**
    * @typedef {{
-   *   message: string|DOMString
+   *   message: string
    * }} ErrorLike
    */
 
@@ -5345,7 +5367,7 @@
   /**
    * @typedef {{
    *   op: SQLCallback,
-   *   args: ObjectArray,
+   *   args: any[],
    *   req: import('./IDBRequest.js').IDBRequestFull|null
    * }} RequestInfo
    */
@@ -5397,17 +5419,17 @@
    *   __pushToQueue: (
    *     request: import('./IDBRequest.js').IDBRequestFull|null,
    *     callback: SQLCallback,
-   *     args?: ObjectArray
+   *     args?: any[]
    *   ) => void,
    *   __assertActive: () => void,
    *   commit: () => void,
    *   __addNonRequestToTransactionQueue: (
    *     callback: SQLCallback,
-   *     args?: ObjectArray
+   *     args?: any[]
    *   ) => void
    *   __addToTransactionQueue: (
    *     callback: SQLCallback,
-   *     args: ObjectArray|undefined,
+   *     args: any[]|undefined,
    *     source: import('./IDBDatabase.js').IDBDatabaseFull|
    *       import('./IDBObjectStore.js').IDBObjectStoreFull|
    *       import('./IDBIndex.js').IDBIndexFull|
@@ -6045,7 +6067,7 @@
   /**
    * @typedef {(
    *   tx: import('websql-configurable/lib/websql/WebSQLTransaction.js').default,
-   *   args: ObjectArray,
+   *   args: any[],
    *   success: (result?: any, req?: import('./IDBRequest.js').IDBRequestFull) => void,
    *   error: (
    *     tx: import('websql-configurable/lib/websql/WebSQLTransaction.js').default|Error|DOMException,
@@ -6058,7 +6080,7 @@
   /**
    * Adds a callback function to the transaction queue.
    * @param {SQLCallback} callback
-   * @param {ObjectArray} args
+   * @param {any[]} args
    * @param {import('./IDBDatabase.js').IDBDatabaseFull|
    *   import('./IDBObjectStore.js').IDBObjectStoreFull|
    *   import('./IDBIndex.js').IDBIndexFull} source
@@ -6075,7 +6097,7 @@
    * Adds a callback function to the transaction queue without generating a
    *   request.
    * @param {SQLCallback} callback
-   * @param {ObjectArray} args
+   * @param {any[]} args
    * @this {IDBTransactionFull}
    * @returns {void}
    */
@@ -6087,7 +6109,7 @@
    * Adds an IDBRequest to the transaction queue.
    * @param {import('./IDBRequest.js').IDBRequestFull|null} request
    * @param {SQLCallback} callback
-   * @param {ObjectArray} args
+   * @param {any[]} args
    * @this {IDBTransactionFull}
    * @returns {void}
    */
@@ -10589,216 +10611,6 @@
     writable: false
   });
 
-  // Copyright Joyent, Inc. and other Node contributors.
-  //
-  // Permission is hereby granted, free of charge, to any person obtaining a
-  // copy of this software and associated documentation files (the
-  // "Software"), to deal in the Software without restriction, including
-  // without limitation the rights to use, copy, modify, merge, publish,
-  // distribute, sublicense, and/or sell copies of the Software, and to permit
-  // persons to whom the Software is furnished to do so, subject to the
-  // following conditions:
-  //
-  // The above copyright notice and this permission notice shall be included
-  // in all copies or substantial portions of the Software.
-  //
-  // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
-  // OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
-  // MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN
-  // NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
-  // DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
-  // OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE
-  // USE OR OTHER DEALINGS IN THE SOFTWARE.
-
-  // resolves . and .. elements in a path array with directory names there
-  // must be no slashes, empty elements, or device names (c:\) in the array
-  // (so also no leading and trailing slashes - it does not distinguish
-  // relative and absolute paths)
-  function normalizeArray(parts, allowAboveRoot) {
-    // if the path tries to go above the root, `up` ends up > 0
-    var up = 0;
-    for (var i = parts.length - 1; i >= 0; i--) {
-      var last = parts[i];
-      if (last === '.') {
-        parts.splice(i, 1);
-      } else if (last === '..') {
-        parts.splice(i, 1);
-        up++;
-      } else if (up) {
-        parts.splice(i, 1);
-        up--;
-      }
-    }
-
-    // if the path is allowed to go above the root, restore leading ..s
-    if (allowAboveRoot) {
-      for (; up--; up) {
-        parts.unshift('..');
-      }
-    }
-    return parts;
-  }
-
-  // Split a filename into [root, dir, basename, ext], unix version
-  // 'root' is just a slash, or nothing.
-  var splitPathRe = /^(\/?|)([\s\S]*?)((?:\.{1,2}|[^\/]+?|)(\.[^.\/]*|))(?:[\/]*)$/;
-  var splitPath = function splitPath(filename) {
-    return splitPathRe.exec(filename).slice(1);
-  };
-
-  // path.resolve([from ...], to)
-  // posix version
-  function resolve() {
-    var resolvedPath = '',
-      resolvedAbsolute = false;
-    for (var i = arguments.length - 1; i >= -1 && !resolvedAbsolute; i--) {
-      var path = i >= 0 ? arguments[i] : '/';
-
-      // Skip empty and invalid entries
-      if (typeof path !== 'string') {
-        throw new TypeError('Arguments to path.resolve must be strings');
-      } else if (!path) {
-        continue;
-      }
-      resolvedPath = path + '/' + resolvedPath;
-      resolvedAbsolute = path.charAt(0) === '/';
-    }
-
-    // At this point the path should be resolved to a full absolute path, but
-    // handle relative paths to be safe (might happen when process.cwd() fails)
-
-    // Normalize the path
-    resolvedPath = normalizeArray(filter(resolvedPath.split('/'), function (p) {
-      return !!p;
-    }), !resolvedAbsolute).join('/');
-    return (resolvedAbsolute ? '/' : '') + resolvedPath || '.';
-  }
-
-  // path.normalize(path)
-  // posix version
-  function normalize(path) {
-    var isPathAbsolute = isAbsolute(path),
-      trailingSlash = substr(path, -1) === '/';
-
-    // Normalize the path
-    path = normalizeArray(filter(path.split('/'), function (p) {
-      return !!p;
-    }), !isPathAbsolute).join('/');
-    if (!path && !isPathAbsolute) {
-      path = '.';
-    }
-    if (path && trailingSlash) {
-      path += '/';
-    }
-    return (isPathAbsolute ? '/' : '') + path;
-  }
-
-  // posix version
-  function isAbsolute(path) {
-    return path.charAt(0) === '/';
-  }
-
-  // posix version
-  function join() {
-    var paths = Array.prototype.slice.call(arguments, 0);
-    return normalize(filter(paths, function (p, index) {
-      if (typeof p !== 'string') {
-        throw new TypeError('Arguments to path.join must be strings');
-      }
-      return p;
-    }).join('/'));
-  }
-
-  // path.relative(from, to)
-  // posix version
-  function relative(from, to) {
-    from = resolve(from).substr(1);
-    to = resolve(to).substr(1);
-    function trim(arr) {
-      var start = 0;
-      for (; start < arr.length; start++) {
-        if (arr[start] !== '') break;
-      }
-      var end = arr.length - 1;
-      for (; end >= 0; end--) {
-        if (arr[end] !== '') break;
-      }
-      if (start > end) return [];
-      return arr.slice(start, end - start + 1);
-    }
-    var fromParts = trim(from.split('/'));
-    var toParts = trim(to.split('/'));
-    var length = Math.min(fromParts.length, toParts.length);
-    var samePartsLength = length;
-    for (var i = 0; i < length; i++) {
-      if (fromParts[i] !== toParts[i]) {
-        samePartsLength = i;
-        break;
-      }
-    }
-    var outputParts = [];
-    for (var i = samePartsLength; i < fromParts.length; i++) {
-      outputParts.push('..');
-    }
-    outputParts = outputParts.concat(toParts.slice(samePartsLength));
-    return outputParts.join('/');
-  }
-  var sep = '/';
-  var delimiter = ':';
-  function dirname(path) {
-    var result = splitPath(path),
-      root = result[0],
-      dir = result[1];
-    if (!root && !dir) {
-      // No dirname whatsoever
-      return '.';
-    }
-    if (dir) {
-      // It has a dirname, strip trailing slash
-      dir = dir.substr(0, dir.length - 1);
-    }
-    return root + dir;
-  }
-  function basename(path, ext) {
-    var f = splitPath(path)[2];
-    // TODO: make this comparison case-insensitive on windows?
-    if (ext && f.substr(-1 * ext.length) === ext) {
-      f = f.substr(0, f.length - ext.length);
-    }
-    return f;
-  }
-  function extname(path) {
-    return splitPath(path)[3];
-  }
-  var path = {
-    extname: extname,
-    basename: basename,
-    dirname: dirname,
-    sep: sep,
-    delimiter: delimiter,
-    relative: relative,
-    join: join,
-    isAbsolute: isAbsolute,
-    normalize: normalize,
-    resolve: resolve
-  };
-  function filter(xs, f) {
-    if (xs.filter) return xs.filter(f);
-    var res = [];
-    for (var i = 0; i < xs.length; i++) {
-      if (f(xs[i], i, xs)) res.push(xs[i]);
-    }
-    return res;
-  }
-
-  // String.prototype.substr - negative index don't work in IE8
-  var substr = 'ab'.substr(-1) === 'b' ? function (str, start, len) {
-    return str.substr(start, len);
-  } : function (str, start, len) {
-    if (start < 0) start = str.length + start;
-    return str.substr(start, len);
-  };
-
   var listeners = ['onabort', 'onclose', 'onerror', 'onversionchange'];
   var readonlyProperties$1 = ['name', 'version', 'objectStoreNames'];
 
@@ -11518,7 +11330,7 @@
     }
     if (fs && CFG.deleteDatabaseFiles !== false) {
       closeCachedWebSQLConnections(name, function () {
-        fs.unlink(path.join(CFG.databaseBasePath || '', escapedDatabaseName), function (err) {
+        fs.unlink(joinPath(CFG.databaseBasePath || '', escapedDatabaseName), function (err) {
           if (err && err.code !== 'ENOENT') {
             // Ignore if file is already deleted
             var removalError = /** @type {Error & {code?: number}} */
@@ -11532,7 +11344,7 @@
       });
       return;
     }
-    var sqliteDB = __openDatabase(path.join(CFG.databaseBasePath || '', escapedDatabaseName), '1', name, CFG.DEFAULT_DB_SIZE);
+    var sqliteDB = __openDatabase(joinPath(CFG.databaseBasePath || '', escapedDatabaseName), '1', name, CFG.DEFAULT_DB_SIZE);
     sqliteDB.transaction(function (tx) {
       tx.executeSql('SELECT "name" FROM __sys__', [], function (tx, data) {
         var tables = data.rows;
@@ -11593,7 +11405,7 @@
       success();
     } else {
       // eslint-disable-next-line unicorn/no-top-level-assignment-in-function -- Necessary?
-      sysdb = __openDatabase(typeof CFG.memoryDatabase === 'string' ? CFG.memoryDatabase : path.join(typeof CFG.sysDatabaseBasePath === 'string' ? CFG.sysDatabaseBasePath : CFG.databaseBasePath || '', '__sysdb__' + (CFG.addSQLiteExtension !== false ? '.sqlite' : '')), '1', 'System Database', CFG.DEFAULT_DB_SIZE);
+      sysdb = __openDatabase(typeof CFG.memoryDatabase === 'string' ? CFG.memoryDatabase : joinPath(typeof CFG.sysDatabaseBasePath === 'string' ? CFG.sysDatabaseBasePath : CFG.databaseBasePath || '', '__sysdb__' + (CFG.addSQLiteExtension !== false ? '.sqlite' : '')), '1', 'System Database', CFG.DEFAULT_DB_SIZE);
       sysdb.transaction(function (systx) {
         systx.executeSql('CREATE TABLE IF NOT EXISTS dbVersions (name BLOB, version INT);', [], function (systx) {
           if (!CFG.useSQLiteIndexes) {
@@ -11835,7 +11647,7 @@
                 req.transaction.__addNonRequestToTransactionQueue(
                 /**
                  * @param {import('websql-configurable/lib/websql/WebSQLTransaction.js').default} tx
-                 * @param {ObjectArray} args
+                 * @param {any[]} args
                  * @param {(result?: any, req?: import('./IDBRequest.js').IDBRequestFull) => void} finished
                  * @returns {void}
                  */
@@ -12049,7 +11861,7 @@
       if ((useMemoryDatabase || useDatabaseCache) && Object.hasOwn(websqlDBCache, name) && Object.hasOwn(websqlDBCache[name], version)) {
         db = websqlDBCache[name][version];
       } else {
-        db = /** @type {DatabaseFull} */me.__openDatabase(useMemoryDatabase ? CFG.memoryDatabase : path.join(CFG.databaseBasePath || '', escapedDatabaseName), '1', name, CFG.DEFAULT_DB_SIZE);
+        db = /** @type {DatabaseFull} */me.__openDatabase(useMemoryDatabase ? CFG.memoryDatabase : joinPath(CFG.databaseBasePath || '', escapedDatabaseName), '1', name, CFG.DEFAULT_DB_SIZE);
         if (useDatabaseCache) {
           if (!Object.hasOwn(websqlDBCache, name)) {
             websqlDBCache[name] = {};
@@ -12558,7 +12370,10 @@
    *   },
    *   __count: boolean,
    *   __prefetchedIndex: Integer,
-   *   __prefetchedData: null|SQLResultSetRowList|{
+   *   __prefetchedData: null|{
+   *     length: number;
+   *     item(index: number): any;
+   *   }|{
    *     data: RowItemNonNull[],
    *     length: Integer,
    *     item: (index: Integer) => RowItemNonNull