edfcore 0.6.197 → 0.6.198

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.197";
+export declare const VERSION = "0.6.198";
 //# 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.197';
+export const VERSION = '0.6.198';
 //# 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,CAuDrD"}
+{"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,CA8ErD"}

package/dist/io/blob.js

@@ -63,6 +63,26 @@ export function blobSource(blob) {
             // `Blob.slice` takes an EXCLUSIVE end, unlike an HTTP byte range.
             const buffer = await blob.slice(offset, offset + length).arrayBuffer();
             throwIfAborted(options);
+            /*
+             * Diagnosed HERE rather than left to `assertExactRead`, which is the argument `node.ts` makes
+             * for its own short read — and the case it names there is this one: "a picked `File`'s backing
+             * file shrank". It was the only adapter of the three without the diagnosis.
+             *
+             * `assertExactRead` exists for a `ByteSource` the CALLER wrote. Its message says a source
+             * "must resolve with exactly the requested number of bytes or reject", which accuses the
+             * browser of breaking a contract it kept: the platform answered correctly for a file that is
+             * now shorter than the one the picker measured. This module's own docblock calls that the one
+             * legitimate short read there is.
+             *
+             * Same shape as the HTTP buffered-body path (0.3.75) and the file handle (0.3.93).
+             */
+            if (buffer.byteLength < length) {
+                throw new EdfSourceError(`Reading bytes ${offset}..${offset + length - 1}: the blob ended after ` +
+                    `${buffer.byteLength} of them. This source was built for ${byteLength} bytes, so the ` +
+                    'range asked for is past the end of the blob as it is now. Next: a picked File is a ' +
+                    'handle on a file that can still change — the backing file was truncated or replaced ' +
+                    'since it was chosen, so ask for it again.', { offset, requestedLength: length, receivedLength: buffer.byteLength });
+            }
             return assertExactRead(new Uint8Array(buffer), offset, length);
         },
     };

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;;;;;;;;;;;;;;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"}
+{"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;;;;;;;;;;;;eAYG;YACH,IAAI,MAAM,CAAC,UAAU,GAAG,MAAM,EAAE,CAAC;gBAC/B,MAAM,IAAI,cAAc,CACtB,iBAAiB,MAAM,KAAK,MAAM,GAAG,MAAM,GAAG,CAAC,yBAAyB;oBACtE,GAAG,MAAM,CAAC,UAAU,uCAAuC,UAAU,iBAAiB;oBACtF,qFAAqF;oBACrF,sFAAsF;oBACtF,2CAA2C,EAC7C,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,CAAC,UAAU,EAAE,CACvE,CAAC;YACJ,CAAC;YACD,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,19 @@ 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.198
+
+- **Fixed** `blobSource` reporting a shrunk `File` as a `ByteSource` breaking its contract. Its own
+  docblock names this as the one legitimate short read there is — "a `File` whose backing file
+  changed on disk since the picker ran" — and then handed it to `assertExactRead`, whose message says
+  a source "must resolve with exactly the requested number of bytes or reject" and asks for a
+  `read()` that loops.
+- So the browser was accused of breaking a contract it kept, and the advice asked it to loop for
+  bytes that no longer exist.
+- `node.ts` diagnoses exactly this in its own reader and names this very case — "a picked `File`'s
+  backing file shrank". The HTTP buffered-body path got it in 0.3.75 and the file handle in 0.3.93;
+  `blobSource` was the third of three.
+
 ## 0.6.197
 
 - **Fixed** the three printers' flags being read as one side of a boolean when given as text —

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "edfcore",
-  "version": "0.6.197",
+  "version": "0.6.198",
   "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.197';
+export const VERSION = '0.6.198';

package/src/io/blob.ts

@@ -72,6 +72,29 @@ export function blobSource(blob: BlobLike): ByteSource {
       // `Blob.slice` takes an EXCLUSIVE end, unlike an HTTP byte range.
       const buffer = await blob.slice(offset, offset + length).arrayBuffer();
       throwIfAborted(options);
+      /*
+       * Diagnosed HERE rather than left to `assertExactRead`, which is the argument `node.ts` makes
+       * for its own short read — and the case it names there is this one: "a picked `File`'s backing
+       * file shrank". It was the only adapter of the three without the diagnosis.
+       *
+       * `assertExactRead` exists for a `ByteSource` the CALLER wrote. Its message says a source
+       * "must resolve with exactly the requested number of bytes or reject", which accuses the
+       * browser of breaking a contract it kept: the platform answered correctly for a file that is
+       * now shorter than the one the picker measured. This module's own docblock calls that the one
+       * legitimate short read there is.
+       *
+       * Same shape as the HTTP buffered-body path (0.3.75) and the file handle (0.3.93).
+       */
+      if (buffer.byteLength < length) {
+        throw new EdfSourceError(
+          `Reading bytes ${offset}..${offset + length - 1}: the blob ended after ` +
+            `${buffer.byteLength} of them. This source was built for ${byteLength} bytes, so the ` +
+            'range asked for is past the end of the blob as it is now. Next: a picked File is a ' +
+            'handle on a file that can still change — the backing file was truncated or replaced ' +
+            'since it was chosen, so ask for it again.',
+          { offset, requestedLength: length, receivedLength: buffer.byteLength },
+        );
+      }
       return assertExactRead(new Uint8Array(buffer), offset, length);
     },
   };