FluentInputFile BufferSize parameter question

[Hwiet]

What's the purpose of the BufferSize parameter when using InputFileMode.Buffer, and would there be a situation where a developer would not set it equal to the MaximumFileSize parameter?

When I did not provide a value for BufferSize (default 10KB) and MaximumFileSize (default 10MB), I noticed that FluentInputFileEventArgs.Buffer.BytesRead is only MaximumFileSize % BufferSize. So if an uploaded file is 33KB, the buffer would only contain the last 3KB of the file data.

I noticed this when I used the Download from a stream example in the Blazor docs to allow the user to download their uploaded file as an alternative to providing a preview on the webpage (minimal repo here). When the uploaded file was larger than 10KB, the downloaded file was not a proper file. Obviously, the issue was fixed when I set BufferSize equal to the MaximumFileSize, which is why I ask this question.

[Hwiet]

Answered my own question by looking at the code provided in the docs for InputFileMode.Buffer.

When the file size is larger than BufferSize, multiple buffers of BufferSize are emitted by the OnProgressChange callback. By concatenating the data in the buffers, you get all the bytes of the file.

Updated my repo in case it helps someone. Someday I'll do a PR on the docs to explicitly spell out this detail of InputFileMode.Buffer...