Issue

When using the FSA-to-Node adapter with createReadStream() and a range read where the start position is beyond the file end, the stream would throw an unhandled RangeError: Invalid typed array length instead of returning an empty buffer and closing gracefully.

Root Cause

The FsaNodeReadStream.__read__() method was attempting to create a Uint8Array with an offset (start) that exceeded the buffer's byte length:

const uint8 = new Uint8Array(buffer, start, end - start);

When start >= buffer.byteLength, this constructor call fails because you cannot create a typed array view with an offset beyond the buffer bounds.

Solution

Added a check to return an empty Uint8Array(0) when the start position is at or beyond the file size:

if (start >= buffer.byteLength) return new Uint8Array(0);

This matches the behavior of Node.js's native fs.createReadStream(), which returns an empty stream when reading past the file end.

Testing

Added two test cases:

1. Reading with start: 100 on a 4-byte file - returns empty buffer
2. Reading with start: 4 on a 4-byte file (exactly at end) - returns empty buffer

Both tests verify the stream closes properly without errors and produces an empty output.

All existing tests continue to pass (897 tests).

💬 Share your feedback on Copilot coding agent for the chance to win a $200 gift card! Click here to start the survey.