indexeddbshim 17.0.0 → 17.2.0

package/dist/indexeddbshim-Key.js

@@ -1,4 +1,4 @@
-/*! indexeddbshim - v17.0.0 - 7/28/2026 */
+/*! indexeddbshim - v17.2.0 - 8/18/2026 */
 
 (function (global, factory) {
   typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports) :
@@ -101,6 +101,13 @@
   function _slicedToArray(r, e) {
     return _arrayWithHoles(r) || _iterableToArrayLimit(r, e) || _unsupportedIterableToArray(r, e) || _nonIterableRest();
   }
+  function _taggedTemplateLiteral(e, t) {
+    return t || (t = e.slice(0)), Object.freeze(Object.defineProperties(e, {
+      raw: {
+        value: Object.freeze(t)
+      }
+    }));
+  }
   function _toConsumableArray(r) {
     return _arrayWithoutHoles(r) || _iterableToArray(r) || _unsupportedIterableToArray(r) || _nonIterableSpread();
   }
@@ -165,6 +172,7 @@
    *   sqlBusyTimeout: number,
    *   sqlTrace: () => void,
    *   sqlProfile: () => void,
+   *   escapeNULForSQLiteStatements: boolean,
    *   createIndexes: boolean
    * }} ConfigValues
    */
@@ -319,8 +327,8 @@
   // Callback not used by default
   'sqlProfile',
   // Callback not used by default
-
-  'createIndexes'].forEach(function (prop) {
+  // Defaults to true except in Node builds where we can preserve literal NUL with better-sqlite3
+  'escapeNULForSQLiteStatements', 'createIndexes'].forEach(function (prop) {
     /** @type {(val: any) => void} */
     var validator;
     if (Array.isArray(prop)) {
@@ -630,11 +638,11 @@
   // eslint-disable-next-line @stylistic/operator-linebreak -- Need JSDoc
   ?
   /**
-  * @param {string} name
-  * @param {string} message
-  * @param {ErrorLike} [error]
-  * @returns {DOMException}
-  */
+   * @param {string} name
+   * @param {string} message
+   * @param {ErrorLike} [error]
+   * @returns {DOMException}
+   */
   function (name, message, error) {
     logError(name, message, error);
     return createNativeDOMException(name, message);
@@ -642,11 +650,11 @@
   // eslint-disable-next-line @stylistic/operator-linebreak -- Need JSDoc
   :
   /**
-  * @param {string} name
-  * @param {string} message
-  * @param {ErrorLike} [error]
-  * @returns {Error}
-  */
+   * @param {string} name
+   * @param {string} message
+   * @param {ErrorLike} [error]
+   * @returns {Error}
+   */
   function (name, message, error) {
     logError(name, message, error);
     return createNonNativeDOMException(name, message);
@@ -678,7 +686,8 @@
    * @returns {string}
    */
   function escapeSQLiteStatement(arg) {
-    return escapeUnmatchedSurrogates(arg.replaceAll('^', '^^').replaceAll('\0', '^0'));
+    var escaped = arg.replaceAll('^', '^^');
+    return escapeUnmatchedSurrogates(CFG.escapeNULForSQLiteStatements === false ? escaped : escaped.replaceAll('\0', '^0'));
   }
 
   /**
@@ -772,6 +781,8 @@
     return result;
   }
 
+  var _templateObject, _templateObject2;
+
   /**
    * @typedef {NodeJS.TypedArray|DataView} ArrayBufferView
    */
@@ -801,14 +812,14 @@
    */
 
   /**
-  * @typedef {object} KeyValueObject
-  * @property {KeyType|"NaN"|"null"|"undefined"|"boolean"|"object"|"symbol"|
-  *   "function"|"bigint"} type If not `KeyType`, indicates invalid value
-  * @property {Value} [value]
-  * @property {boolean} [invalid]
-  * @property {string} [message]
-  * @todo Specify acceptable `value` more precisely
-  */
+   * @typedef {object} KeyValueObject
+   * @property {KeyType|"NaN"|"null"|"undefined"|"boolean"|"object"|"symbol"|
+   *   "function"|"bigint"} type If not `KeyType`, indicates invalid value
+   * @property {Value} [value]
+   * @property {boolean} [invalid]
+   * @property {string} [message]
+   * @todo Specify acceptable `value` more precisely
+   */
 
   /**
    * @typedef {number|string|Date|ArrayBuffer} ValueTypePrimitive
@@ -1047,14 +1058,22 @@
           _iterator.f();
         }
         encoded.push(keyTypeToEncodedChar.invalid + '-'); // append an extra item, so empty arrays sort correctly
-        return keyTypeToEncodedChar.array + '-' + JSON.stringify(encoded);
+        var encodedKey = JSON.stringify(encoded);
+        if (CFG.escapeNULForSQLiteStatements === false) {
+          encodedKey = encodedKey.replaceAll(String.raw(_templateObject || (_templateObject = _taggedTemplateLiteral(["\0"], ["\\u0000"]))), '\0');
+        }
+        return keyTypeToEncodedChar.array + '-' + encodedKey;
       },
       /**
        * @param {string} key
        * @returns {ValueTypeArray}
        */
       decode: function decode(key) {
-        var decoded = JSON.parse(key.slice(2));
+        var decodedKey = key.slice(2);
+        if (CFG.escapeNULForSQLiteStatements === false) {
+          decodedKey = decodedKey.replaceAll('\0', String.raw(_templateObject2 || (_templateObject2 = _taggedTemplateLiteral(["\0"], ["\\u0000"]))));
+        }
+        var decoded = JSON.parse(decodedKey);
         decoded.pop(); // remove the extra item
         for (var i = 0; i < decoded.length; i++) {
           var item = decoded[i];
@@ -1240,10 +1259,10 @@
   }
 
   /**
-  * Currently not in use.
-  * @param {Value} input
-  * @returns {KeyValueObject}
-  */
+   * Currently not in use.
+   * @param {Value} input
+   * @returns {KeyValueObject}
+   */
   function convertValueToMultiEntryKey(input) {
     return convertValueToKeyValueDecoded(input, null, true, true);
   }
@@ -1278,17 +1297,17 @@
   }
 
   /**
-  * Shortcut utility to avoid returning full keys from `convertValueToKey`
-  *   and subsequent need to process in calling code unless `fullKeys` is
-  *   set; may throw.
-  * @param {Value} input
-  * @param {Value[]|null} [seen]
-  * @param {boolean} [multiEntry]
-  * @param {boolean} [fullKeys]
-  * @throws {TypeError} See `getCopyBytesHeldByBufferSource`
-  * @todo Document other allowable `input`
-  * @returns {KeyValueObject}
-  */
+   * Shortcut utility to avoid returning full keys from `convertValueToKey`
+   *   and subsequent need to process in calling code unless `fullKeys` is
+   *   set; may throw.
+   * @param {Value} input
+   * @param {Value[]|null} [seen]
+   * @param {boolean} [multiEntry]
+   * @param {boolean} [fullKeys]
+   * @throws {TypeError} See `getCopyBytesHeldByBufferSource`
+   * @todo Document other allowable `input`
+   * @returns {KeyValueObject}
+   */
   function convertValueToKeyValueDecoded(input, seen, multiEntry, fullKeys) {
     seen || (seen = []);
     if (seen.includes(input)) {
@@ -1444,12 +1463,12 @@
   }
 
   /**
-  * An internal utility.
-  * @param {Value} input
-  * @param {Value[]|null|undefined} [seen]
-  * @throws {DOMException} `DataError`
-  * @returns {KeyValueObject}
-  */
+   * An internal utility.
+   * @param {Value} input
+   * @param {Value[]|null|undefined} [seen]
+   * @throws {DOMException} `DataError`
+   * @returns {KeyValueObject}
+   */
   function convertValueToKeyRethrowingAndIfInvalid(input, seen) {
     var key = convertValueToKey(input, seen);
     if (key.invalid) {
@@ -1470,26 +1489,26 @@
     return extractKeyValueDecodedFromValueUsingKeyPath(value, keyPath, multiEntry, true);
   }
   /**
-  * Not currently in use.
-  * @param {Value} value
-  * @param {KeyPath} keyPath
-  * @param {boolean} multiEntry
-  * @returns {KeyPathEvaluateValue}
-  */
+   * Not currently in use.
+   * @param {Value} value
+   * @param {KeyPath} keyPath
+   * @param {boolean} multiEntry
+   * @returns {KeyPathEvaluateValue}
+   */
   function evaluateKeyPathOnValue(value, keyPath, multiEntry) {
     return evaluateKeyPathOnValueToDecodedValue(value, keyPath);
   }
 
   /**
-  * May throw, return `{failure: true}` (e.g., non-object on keyPath resolution)
-  *    or `{invalid: true}` (e.g., `NaN`).
-  * @param {Value} value
-  * @param {KeyPath} keyPath
-  * @param {boolean} [multiEntry]
-  * @param {boolean} [fullKeys]
-  * @returns {KeyValueObject|KeyPathEvaluateValue}
-  * @todo Document other possible return?
-  */
+   * May throw, return `{failure: true}` (e.g., non-object on keyPath resolution)
+   *    or `{invalid: true}` (e.g., `NaN`).
+   * @param {Value} value
+   * @param {KeyPath} keyPath
+   * @param {boolean} [multiEntry]
+   * @param {boolean} [fullKeys]
+   * @returns {KeyValueObject|KeyPathEvaluateValue}
+   * @todo Document other possible return?
+   */
   function extractKeyValueDecodedFromValueUsingKeyPath(value, keyPath, multiEntry, fullKeys) {
     var r = evaluateKeyPathOnValueToDecodedValue(value, keyPath);
     if (r.failure) {
@@ -1719,11 +1738,11 @@
   }
 
   /**
-  * Not currently in use but keeping for spec parity.
-  * @param {Key} key
-  * @throws {Error} Upon a "bad key"
-  * @returns {ValueType}
-  */
+   * Not currently in use but keeping for spec parity.
+   * @param {Key} key
+   * @throws {Error} Upon a "bad key"
+   * @returns {ValueType}
+   */
   function convertKeyToValue(key) {
     var type = key.type,
       value = key.value;
@@ -1815,10 +1834,10 @@
    */
 
   /**
-  * @callback SQLFailureCallback
-  * @param {DOMException|Error} exception
-  * @returns {void}
-  */
+   * @callback SQLFailureCallback
+   * @param {DOMException|Error} exception
+   * @returns {void}
+   */
 
   /**
    *