indexeddbshim 17.2.1 → 17.3.0

package/dist/Key.d.ts

@@ -18,6 +18,7 @@ export type KeyForStoreCallback = (arg1: "failure" | null, arg2?: number | undef
 export type ArrayBufferView = NodeJS.TypedArray | DataView;
 export type BufferSource = ArrayBufferView | ArrayBuffer;
 export type KeyType = "number" | "date" | "string" | "binary" | "array";
+export type WebSQLTransaction = import("websql-configurable/lib/websql/WebSQLTransaction.js").default;
 export type Value = any;
 export type Key = any;
 export type KeyPathArray = KeyPath[];
@@ -177,14 +178,14 @@ export function isKeyInRange(key: Key, range: import("./IDBKeyRange.js").IDBKeyR
 export function findMultiEntryMatches(keyEntry: Key, range: import("./IDBKeyRange.js").IDBKeyRangeFull | undefined): Key[];
 /**
  *
- * @param {SQLTransaction} tx
+ * @param {WebSQLTransaction} tx
  * @param {import('./IDBObjectStore.js').IDBObjectStoreFull} store
  * @param {Integer} num
  * @param {CurrentNumberCallback} successCb
  * @param {SQLFailureCallback} failCb
  * @returns {void}
  */
-export function assignCurrentNumber(tx: SQLTransaction, store: import("./IDBObjectStore.js").IDBObjectStoreFull, num: Integer, successCb: CurrentNumberCallback, failCb: SQLFailureCallback): void;
+export function assignCurrentNumber(tx: WebSQLTransaction, store: import("./IDBObjectStore.js").IDBObjectStoreFull, num: Integer, successCb: CurrentNumberCallback, failCb: SQLFailureCallback): void;
 /**
  * @callback KeyForStoreCallback
  * @param {"failure"|null} arg1
@@ -194,21 +195,21 @@ export function assignCurrentNumber(tx: SQLTransaction, store: import("./IDBObje
  */
 /**
  *
- * @param {SQLTransaction} tx
+ * @param {WebSQLTransaction} tx
  * @param {import('./IDBObjectStore.js').IDBObjectStoreFull} store
  * @param {KeyForStoreCallback} cb
  * @param {SQLFailureCallback} sqlFailCb
  * @returns {void}
  */
-export function generateKeyForStore(tx: SQLTransaction, store: import("./IDBObjectStore.js").IDBObjectStoreFull, cb: KeyForStoreCallback, sqlFailCb: SQLFailureCallback): void;
+export function generateKeyForStore(tx: WebSQLTransaction, store: import("./IDBObjectStore.js").IDBObjectStoreFull, cb: KeyForStoreCallback, sqlFailCb: SQLFailureCallback): void;
 /**
  *
- * @param {SQLTransaction} tx
+ * @param {WebSQLTransaction} tx
  * @param {import('./IDBObjectStore.js').IDBObjectStoreFull} store
  * @param {Key} key
  * @param {(num?: Integer) => void} successCb
  * @param {SQLFailureCallback} sqlFailCb
  * @returns {void}
  */
-export function possiblyUpdateKeyGenerator(tx: SQLTransaction, store: import("./IDBObjectStore.js").IDBObjectStoreFull, key: Key, successCb: (num?: Integer) => void, sqlFailCb: SQLFailureCallback): void;
+export function possiblyUpdateKeyGenerator(tx: WebSQLTransaction, store: import("./IDBObjectStore.js").IDBObjectStoreFull, key: Key, successCb: (num?: Integer) => void, sqlFailCb: SQLFailureCallback): void;
 //# sourceMappingURL=Key.d.ts.map

package/dist/Key.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Key.d.ts","sourceRoot":"","sources":["../src/Key.js"],"names":[],"mappings":"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"}
+{"version":3,"file":"Key.d.ts","sourceRoot":"","sources":["../src/Key.js"],"names":[],"mappings":"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"}

package/dist/Sca.d.ts

@@ -22,6 +22,21 @@ export function decode(obj: string): AnyValue;
  * @returns {AnyValue}
  */
 export function clone(val: AnyValue): AnyValue;
+/**
+ * Per spec, a transaction must appear inactive to any code that runs
+ *   reentrantly *during* the structured clone of a value passed to
+ *   `add()`/`put()`/`IDBCursor#update()` (e.g. a getter on the value being
+ *   stored) -- even though the transaction is otherwise active for the
+ *   duration of that same call. `__active` is restored in a `finally` so a
+ *   `DataCloneError` (or any other throw from `clone()`) can't leave the
+ *   transaction permanently stuck inactive.
+ * @param {{__active: boolean}} transaction
+ * @param {AnyValue} val
+ * @returns {AnyValue}
+ */
+export function cloneWithInactiveTransaction(transaction: {
+    __active: boolean;
+}, val: AnyValue): AnyValue;
 /**
  * @param {(preset: import('typeson-registry').Preset) =>
  *   import('typeson-registry').Preset} func

package/dist/Sca.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Sca.d.ts","sourceRoot":"","sources":["../src/Sca.js"],"names":[],"mappings":"uBAsDa,GAAG;AAlChB;;;;;;;;GAQG;AACH,4BALW,QAAQ,SACR,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,GAEnB,MAAM,CAwBlB;AAED;;GAEG;AAEH;;;GAGG;AACH,4BAHW,MAAM,GACJ,QAAQ,CAIpB;AAED;;;GAGG;AACH,2BAHW,QAAQ,GACN,QAAQ,CAMpB;AA/DD;;;;GAIG;AACH,+BAJW,CAAC,MAAM,EAAE,OAAO,kBAAkB,EAAE,MAAM,KACpD,OAAW,kBAAkB,EAAE,MAAM,GACzB,IAAI,CAKhB"}
+{"version":3,"file":"Sca.d.ts","sourceRoot":"","sources":["../src/Sca.js"],"names":[],"mappings":"uBAsDa,GAAG;AAlChB;;;;;;;;GAQG;AACH,4BALW,QAAQ,SACR,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,GAEnB,MAAM,CAwBlB;AAED;;GAEG;AAEH;;;GAGG;AACH,4BAHW,MAAM,GACJ,QAAQ,CAIpB;AAED;;;GAGG;AACH,2BAHW,QAAQ,GACN,QAAQ,CAMpB;AAED;;;;;;;;;;;GAWG;AACH,0DAJW;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAC,OACnB,QAAQ,GACN,QAAQ,CASpB;AApFD;;;;GAIG;AACH,+BAJW,CAAC,MAAM,EAAE,OAAO,kBAAkB,EAAE,MAAM,KACpD,OAAW,kBAAkB,EAAE,MAAM,GACzB,IAAI,CAKhB"}

package/dist/indexeddbshim-Key.js

@@ -1,4 +1,4 @@
-/*! indexeddbshim - v17.2.1 - 8/18/2026 */
+/*! indexeddbshim - v17.3.0 - 8/24/2026 */
 
 (function (global, factory) {
   typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports) :
@@ -152,7 +152,8 @@
    *   ) => import('typeson').Preset,
    *   avoidAutoShim: boolean,
    *   win: {
-   *     openDatabase: (name: string, version: string, displayName: string, estimatedSize: number) => import('websql-configurable').default
+   *     openDatabase: (name: string, version: string, displayName: string, estimatedSize: number) =>
+   *       import('websql-configurable/lib/websql/WebSQLDatabase.js').default
    *   },
    *   DEFAULT_DB_SIZE: number,
    *   useSQLiteIndexes: boolean,
@@ -450,18 +451,29 @@
     DATA_CLONE_ERR: 25
   };
 
+  /**
+   * @typedef {globalThis.DOMException & {
+   *   _code: number,
+   *   _name: string|Code|LegacyCode,
+   *   _message: string
+   * }} DOMExceptionFull
+   */
+
   /**
    *
    * @returns {typeof DOMException}
    */
   function createNonNativeDOMExceptionClass() {
     /**
+     * @class
      * @param {string|undefined} message
      * @param {Code|LegacyCode} name
+     * @this {DOMExceptionFull}
      * @returns {void}
      */
     function DOMException(message, name) {
       // const err = Error.prototype.constructor.call(this, message); // Any use to this? Won't set this.message
+      // @ts-expect-error It's ok
       this[Symbol.toStringTag] = 'DOMException';
       this._code = Object.hasOwn(codes, name) ? codes[(/** @type {Code} */name)] : legacyCodes[(/** @type {LegacyCode} */name)] || 0;
       this._name = name || 'Error';
@@ -511,13 +523,14 @@
          */
         get: function get() {
           if (!(this instanceof DOMException ||
-          // @ts-expect-error Just checking
+          // @ts-ignore Just checking; needed under some TS versions
           this instanceof DummyDOMException ||
-          // @ts-expect-error Just checking
+          // @ts-ignore Just checking; needed under some TS versions
           this instanceof Error)) {
             throw new TypeError('Illegal invocation');
           }
-          return this[prop === 'name' ? '_name' : '_message'];
+          var me = /** @type {DOMExceptionFull} */ /** @type {unknown} */this;
+          return me[prop === 'name' ? '_name' : '_message'];
         }
       });
     });
@@ -537,7 +550,7 @@
     });
     var keys = Object.keys(codes);
 
-    /** @type {(keyof codes)[]} */
+    /** @type {(keyof typeof codes)[]} */
     keys.forEach(function (codeName) {
       Object.defineProperty(DOMException.prototype, codeName, {
         enumerable: true,
@@ -550,7 +563,7 @@
         value: codes[codeName]
       });
     });
-    /** @type {(keyof legacyCodes)[]} */
+    /** @type {(keyof typeof legacyCodes)[]} */
     Object.keys(legacyCodes).forEach(function (codeName) {
       Object.defineProperty(DOMException.prototype, codeName, {
         enumerable: true,
@@ -570,7 +583,7 @@
       value: DOMException
     });
 
-    // @ts-expect-error We don't need all its properties
+    // @ts-ignore We don't need all its properties; needed under some TS versions
     return DOMException;
   }
   var ShimNonNativeDOMException = createNonNativeDOMExceptionClass();
@@ -582,6 +595,7 @@
    * @returns {Error}
    */
   function createNonNativeDOMException(name, message) {
+    // @ts-ignore It's ok; needed under some TS versions
     return new ShimNonNativeDOMException(message, name);
   }
 
@@ -795,6 +809,10 @@
    * @typedef {"number"|"date"|"string"|"binary"|"array"} KeyType
    */
 
+  /**
+   * @typedef {import('websql-configurable/lib/websql/WebSQLTransaction.js').default} WebSQLTransaction
+   */
+
   /**
    * @typedef {any} Value
    */
@@ -1349,10 +1367,23 @@
         }
       case 'binary':
         {
-          // May throw (if detached)
           // Get a copy of the bytes held by the buffer source
           // https://heycam.github.io/webidl/#ref-for-dfn-get-buffer-source-copy-2
-          var octets = getCopyBytesHeldByBufferSource(/** @type {BufferSource} */input);
+          // A detached buffer/view can't be read -- the engine itself throws
+          //   (e.g. "Cannot perform Construct on a detached ArrayBuffer")
+          //   rather than us being able to detect this up front, so treat any
+          //   such failure the same as any other invalid key rather than
+          //   letting that native error escape uncaught.
+          var octets;
+          try {
+            octets = getCopyBytesHeldByBufferSource(/** @type {BufferSource} */input);
+          } catch (_unused) {
+            return {
+              type: type,
+              invalid: true,
+              message: 'Could not read the buffer source (it may be detached)'
+            };
+          }
           return {
             type: 'binary',
             value: octets
@@ -1841,7 +1872,7 @@
 
   /**
    *
-   * @param {SQLTransaction} tx
+   * @param {WebSQLTransaction} tx
    * @param {import('./IDBObjectStore.js').IDBObjectStoreFull} store
    * @param {CurrentNumberCallback} func
    * @param {SQLFailureCallback} sqlFailCb
@@ -1852,7 +1883,7 @@
       if (data.rows.length !== 1) {
         func(1);
       } else {
-        func(data.rows.item(0).currNum);
+        func(/** @type {{currNum: number}} */data.rows.item(0).currNum);
       }
     }, function (tx, error) {
       sqlFailCb(createDOMException('DataError', 'Could not get the auto increment value for key', error));
@@ -1862,7 +1893,7 @@
 
   /**
    *
-   * @param {SQLTransaction} tx
+   * @param {WebSQLTransaction} tx
    * @param {import('./IDBObjectStore.js').IDBObjectStoreFull} store
    * @param {Integer} num
    * @param {CurrentNumberCallback} successCb
@@ -1887,7 +1918,7 @@
    * Bump up the auto-inc counter if the key path-resolved value is valid
    *   (greater than old value and >=1) OR if a manually passed in key is
    *   valid (numeric and >= 1) and >= any primaryKey.
-   * @param {SQLTransaction} tx
+   * @param {WebSQLTransaction} tx
    * @param {import('./IDBObjectStore.js').IDBObjectStoreFull} store
    * @param {Integer} num
    * @param {CurrentNumberCallback} successCb
@@ -1895,13 +1926,18 @@
    * @returns {void}
    */
   function setCurrentNumber(tx, store, num, successCb, failCb) {
-    num = 1 + (num === MAX_ALLOWED_CURRENT_NUMBER
-    // Since incrementing by one will have no effect in JavaScript on this
-    // unsafe max, we represent the max as a number incremented by two.
-    // The getting of the current number is never returned to the user and
-    // is only used in safe comparisons, so it is safe for us to represent
-    // it in this manner
-    ? num + 1 : num);
+    // Since incrementing by one has no effect in JavaScript on this unsafe
+    //   max (`MAX_ALLOWED_CURRENT_NUMBER + 1 === MAX_ALLOWED_CURRENT_NUMBER`
+    //   in IEEE 754 double precision), we represent the max as a number
+    //   incremented by two instead -- computed as a single `+ 2` rather
+    //   than two chained `+ 1`s, as the latter *also* rounds back to the
+    //   original value (each addition independently hits the same
+    //   unrepresentable `+ 1` and rounds down, so the two `+ 1`s don't
+    //   compose into a `+ 2`).
+    //   The getting of the current number is never returned to the user and
+    //   is only used in safe comparisons, so it is safe for us to represent
+    //   it in this manner
+    num += num === MAX_ALLOWED_CURRENT_NUMBER ? 2 : 1;
     return assignCurrentNumber(tx, store, num, successCb, failCb);
   }
 
@@ -1915,7 +1951,7 @@
 
   /**
    *
-   * @param {SQLTransaction} tx
+   * @param {WebSQLTransaction} tx
    * @param {import('./IDBObjectStore.js').IDBObjectStoreFull} store
    * @param {KeyForStoreCallback} cb
    * @param {SQLFailureCallback} sqlFailCb
@@ -1942,7 +1978,7 @@
   //     so we do not return a key
   /**
    *
-   * @param {SQLTransaction} tx
+   * @param {WebSQLTransaction} tx
    * @param {import('./IDBObjectStore.js').IDBObjectStoreFull} store
    * @param {Key} key
    * @param {(num?: Integer) => void} successCb