fixup! Add stall detection to recover from frozen uploads

Author: m7kvqbe1

docs/api.md

@@ -354,6 +354,7 @@ An object used as the HTTP stack for making network requests. This is an abstrac
 interface HttpStack {
     createRequest(method: string, url: string): HttpRequest;
     getName(): string;
+    supportsProgressEvents(): boolean;
 }
 
 interface HttpRequest {
@@ -395,6 +396,14 @@ interface HttpResponse {
 
 ```
 
+The `supportsProgressEvents()` method should return `true` if the HTTP stack implementation supports progress events during upload, or `false` otherwise. This is used by tus-js-client to determine whether features like stall detection can be enabled. The built-in HTTP stacks have the following support:
+
+- `XHRHttpStack` (browser default): Returns `true` - XMLHttpRequest supports progress events
+- `NodeHttpStack` (Node.js default): Returns `true` - Node.js HTTP module supports progress events
+- `FetchHttpStack`: Returns `false` - Fetch API does not support upload progress events
+
+If you're implementing a custom HTTP stack, you should return `true` only if your implementation can reliably call the progress handler set via `setProgressHandler` during the upload process.
+
 #### urlStorage
 
 _Default value:_ Environment-specific implementation