edfcore 0.6.156 → 0.6.157

package/dist/constants.d.ts

@@ -109,5 +109,5 @@ export declare const SIGNAL_FIELD_BLOCK_OFFSETS: {
     readonly reserved: 224;
 };
 /** Published package version. Kept in sync with package.json by a test. */
-export declare const VERSION = "0.6.156";
+export declare const VERSION = "0.6.157";
 //# sourceMappingURL=constants.d.ts.map

package/dist/constants.js

@@ -79,5 +79,5 @@ export const SIGNAL_FIELD_BLOCK_OFFSETS = {
     reserved: 224,
 };
 /** Published package version. Kept in sync with package.json by a test. */
-export const VERSION = '0.6.156';
+export const VERSION = '0.6.157';
 //# sourceMappingURL=constants.js.map

package/dist/io/blob.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"blob.d.ts","sourceRoot":"","sources":["../../src/io/blob.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAe,MAAM,aAAa,CAAC;AAGrE;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,QAAQ,GAAG,UAAU,CA+BrD"}
+{"version":3,"file":"blob.d.ts","sourceRoot":"","sources":["../../src/io/blob.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAe,MAAM,aAAa,CAAC;AAGrE;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,QAAQ,GAAG,UAAU,CAuDrD"}

package/dist/io/blob.js

@@ -31,6 +31,27 @@ export function blobSource(blob) {
             `${describeValue(blob)}. Next: pass the File an <input type="file"> or a drop event hands ` +
             'you, or byteSource(bytes) if you already have the bytes in memory.', { offset: 0, requestedLength: 0 });
     }
+    /*
+     * The SIZE, which the check above only established is a number.
+     *
+     * `fileHandleSource` refuses a `byteLength` that is not a byte count (0.6.85) and `fileSource`
+     * refuses the one it reads off the handle; this is the third adapter that takes a size and the
+     * one that took whatever arrived. `BlobLike` is a structural shim precisely so a caller can
+     * IMPLEMENT it — a stream-backed file, a mocked blob in a test, a wrapper around a native file
+     * picker — and an implementation is where a computed `size` comes from.
+     *
+     * A `NaN` did not fail; it disabled the range guard. `assertReadRange` compares every read
+     * against `byteLength`, every comparison against `NaN` is false, so the check silently stopped
+     * happening and the source advertised `byteLength: NaN` to everything downstream. A negative or
+     * fractional size passed the same way. `options.ts` names this shape exactly: "a guard written
+     * as `if (value < 1)` simply does not fire".
+     */
+    if (!Number.isSafeInteger(blob.size) || blob.size < 0) {
+        throw new EdfSourceError(`blobSource() was given ${describeValue(blob.size)} as the blob's size, which is not a ` +
+            'byte count edfcore can address, so no read could be bounded by it. Next: pass a real ' +
+            'Blob or File, whose size the platform sets, or byteSource(bytes) if you built the ' +
+            'bytes yourself.', { offset: 0, requestedLength: 0 });
+    }
     const byteLength = blob.size;
     return {
         byteLength,

package/dist/io/blob.js.map

@@ -1 +1 @@
-{"version":3,"file":"blob.js","sourceRoot":"","sources":["../../src/io/blob.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE/E;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,IAAc;IACvC;;;;;;OAMG;IACH,MAAM,KAAK,GAAG,IAAmC,CAAC;IAClD,IAAI,OAAO,KAAK,EAAE,IAAI,KAAK,QAAQ,IAAI,OAAO,KAAK,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;QACzE,MAAM,IAAI,cAAc,CACtB,2FAA2F;YACzF,GAAG,aAAa,CAAC,IAAI,CAAC,qEAAqE;YAC3F,oEAAoE,EACtE,EAAE,MAAM,EAAE,CAAC,EAAE,eAAe,EAAE,CAAC,EAAE,CAClC,CAAC;IACJ,CAAC;IACD,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC;IAE7B,OAAO;QACL,UAAU;QACV,KAAK,CAAC,IAAI,CAAC,MAAc,EAAE,MAAc,EAAE,OAAqB;YAC9D,cAAc,CAAC,OAAO,CAAC,CAAC;YACxB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC;YAC5C,IAAI,MAAM,KAAK,CAAC;gBAAE,OAAO,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC;YAC3C,kEAAkE;YAClE,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;YACvE,cAAc,CAAC,OAAO,CAAC,CAAC;YACxB,OAAO,eAAe,CAAC,IAAI,UAAU,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;QACjE,CAAC;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"blob.js","sourceRoot":"","sources":["../../src/io/blob.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE/E;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,IAAc;IACvC;;;;;;OAMG;IACH,MAAM,KAAK,GAAG,IAAmC,CAAC;IAClD,IAAI,OAAO,KAAK,EAAE,IAAI,KAAK,QAAQ,IAAI,OAAO,KAAK,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;QACzE,MAAM,IAAI,cAAc,CACtB,2FAA2F;YACzF,GAAG,aAAa,CAAC,IAAI,CAAC,qEAAqE;YAC3F,oEAAoE,EACtE,EAAE,MAAM,EAAE,CAAC,EAAE,eAAe,EAAE,CAAC,EAAE,CAClC,CAAC;IACJ,CAAC;IACD;;;;;;;;;;;;;;OAcG;IACH,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;QACtD,MAAM,IAAI,cAAc,CACtB,0BAA0B,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,sCAAsC;YACtF,uFAAuF;YACvF,oFAAoF;YACpF,iBAAiB,EACnB,EAAE,MAAM,EAAE,CAAC,EAAE,eAAe,EAAE,CAAC,EAAE,CAClC,CAAC;IACJ,CAAC;IACD,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC;IAE7B,OAAO;QACL,UAAU;QACV,KAAK,CAAC,IAAI,CAAC,MAAc,EAAE,MAAc,EAAE,OAAqB;YAC9D,cAAc,CAAC,OAAO,CAAC,CAAC;YACxB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC;YAC5C,IAAI,MAAM,KAAK,CAAC;gBAAE,OAAO,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC;YAC3C,kEAAkE;YAClE,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;YACvE,cAAc,CAAC,OAAO,CAAC,CAAC;YACxB,OAAO,eAAe,CAAC,IAAI,UAAU,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;QACjE,CAAC;KACF,CAAC;AACJ,CAAC"}

package/docs/CHANGELOG.md

@@ -6,6 +6,18 @@ alone does not tell you whether you were affected.
 edfcore is pre-1.0. Patch releases have carried behaviour changes where the old behaviour was a
 defect; those are called out below.
 
+## 0.6.157
+
+- **Fixed** `blobSource` accepting a `size` that is not a byte count. A `NaN` did not fail — it
+  disabled the range guard, since `assertReadRange` compares every read against `byteLength` and
+  every comparison against `NaN` is false — and the source then advertised `byteLength: NaN`
+  downstream.
+- Negative and fractional sizes passed the same way. `fileHandleSource` has refused all of them
+  since 0.6.85 and `fileSource` validates the size it reads off the handle; this was the third
+  adapter that takes one.
+- `BlobLike` is a structural shim so a caller can implement it, which is where a computed size
+  comes from.
+
 ## 0.6.156
 
 - **Fixed** `decodeAnnotations` and `readAnnotations` walking a `signalIndices` that is not a list.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "edfcore",
-  "version": "0.6.156",
+  "version": "0.6.157",
   "description": "Modern, typed, zero-dependency reader for EDF, EDF+, BDF and BDF+ biosignal files. Works in browsers and Node with true random access.",
   "keywords": [
     "edf",

package/src/constants.ts

@@ -93,4 +93,4 @@ export const SIGNAL_FIELD_BLOCK_OFFSETS = {
 } as const;
 
 /** Published package version. Kept in sync with package.json by a test. */
-export const VERSION = '0.6.156';
+export const VERSION = '0.6.157';

package/src/io/blob.ts

@@ -37,6 +37,30 @@ export function blobSource(blob: BlobLike): ByteSource {
       { offset: 0, requestedLength: 0 },
     );
   }
+  /*
+   * The SIZE, which the check above only established is a number.
+   *
+   * `fileHandleSource` refuses a `byteLength` that is not a byte count (0.6.85) and `fileSource`
+   * refuses the one it reads off the handle; this is the third adapter that takes a size and the
+   * one that took whatever arrived. `BlobLike` is a structural shim precisely so a caller can
+   * IMPLEMENT it — a stream-backed file, a mocked blob in a test, a wrapper around a native file
+   * picker — and an implementation is where a computed `size` comes from.
+   *
+   * A `NaN` did not fail; it disabled the range guard. `assertReadRange` compares every read
+   * against `byteLength`, every comparison against `NaN` is false, so the check silently stopped
+   * happening and the source advertised `byteLength: NaN` to everything downstream. A negative or
+   * fractional size passed the same way. `options.ts` names this shape exactly: "a guard written
+   * as `if (value < 1)` simply does not fire".
+   */
+  if (!Number.isSafeInteger(blob.size) || blob.size < 0) {
+    throw new EdfSourceError(
+      `blobSource() was given ${describeValue(blob.size)} as the blob's size, which is not a ` +
+        'byte count edfcore can address, so no read could be bounded by it. Next: pass a real ' +
+        'Blob or File, whose size the platform sets, or byteSource(bytes) if you built the ' +
+        'bytes yourself.',
+      { offset: 0, requestedLength: 0 },
+    );
+  }
   const byteLength = blob.size;
 
   return {