edf2csv 0.6.54 → 0.6.56

package/docs/CHANGELOG.md

@@ -3,6 +3,36 @@
 Notable changes to edf2csv. Versions follow [semantic versioning](https://semver.org); while the
 major version is 0, a minor bump may contain breaking changes.
 
+## 0.6.56
+
+### Fixed: the `UNREADABLE` case list, four of the six things it covers
+
+The reference gave a missing file, a directory where a file was expected, a permission failure
+and a file that changed size mid-read. Missing: a path running through a regular file, which
+0.6.12 taught the reader to word as "part of the path is a file, not a directory"; anything that
+is not a regular file, such as a socket or a fifo; and calling a method on a closed `EdfFile`,
+which is where a library caller meets this code most often.
+
+Third time a message change in this line has left prose behind it, after 0.6.20 and 0.6.42 — and
+the same remedy each time: diff the list against the function, don't read it.
+
+## 0.6.55
+
+### Fixed: the API reference's first example serialised `startDateTime` the one way it must not
+
+```js
+console.log(`start ${file.header.startDateTime?.toISOString() ?? 'unknown'}`);
+```
+
+That is the opening worked example on the page, and `toISOString()` is precisely what the same
+page warns against six hundred lines later, in the paragraph explaining why `formatWallClock`
+exists: the `Z` asserts UTC over digits the format never assigned a zone to, so a reader
+converting to local time moves the recording by their own offset — "13:43:04 in the file becomes
+08:43:04 in New York".
+
+The `EdfHeader` field list called it "a UTC `Date`" flatly, which is the belief that produces the
+mistake. Both now say what the source comment says, and the example uses `formatWallClock`.
+
 ## 0.6.54
 
 ### Fixed: the FAQ's truncation transcript punctuated the hint differently from the tool

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "edf2csv",
-  "version": "0.6.54",
+  "version": "0.6.56",
   "description": "Convert EDF, EDF+ and BDF biosignal recordings (European Data Format) to CSV from the command line. Local, streaming, and never resamples or alters units.",
   "keywords": [
     "edf",