@yume-chan/stream-extra 0.0.17 → 0.0.19

package/CHANGELOG.json

@@ -1,11 +1,35 @@
 {
-  "name": "@yume-chan/stream-extra",
-  "entries": [
-    {
-      "version": "0.0.17",
-      "tag": "@yume-chan/stream-extra_v0.0.17",
-      "date": "Tue, 18 Oct 2022 09:32:30 GMT",
-      "comments": {}
-    }
-  ]
+    "name": "@yume-chan/stream-extra",
+    "entries": [
+        {
+            "version": "0.0.19",
+            "tag": "@yume-chan/stream-extra_v0.0.19",
+            "date": "Sun, 09 Apr 2023 05:55:33 GMT",
+            "comments": {
+                "none": [
+                    {
+                        "comment": "Add an option to combine small chunks into target size in `ChunkStream`, and rename it to `DistributionStream`"
+                    }
+                ]
+            }
+        },
+        {
+            "version": "0.0.18",
+            "tag": "@yume-chan/stream-extra_v0.0.18",
+            "date": "Wed, 25 Jan 2023 21:33:49 GMT",
+            "comments": {
+                "none": [
+                    {
+                        "comment": "Change to load native Web Streams API implementation from `globalThis` if available"
+                    }
+                ]
+            }
+        },
+        {
+            "version": "0.0.17",
+            "tag": "@yume-chan/stream-extra_v0.0.17",
+            "date": "Tue, 18 Oct 2022 09:32:30 GMT",
+            "comments": {}
+        }
+    ]
 }

package/CHANGELOG.md

@@ -1,9 +1,22 @@
 # Change Log - @yume-chan/stream-extra
 
-This log was last generated on Tue, 18 Oct 2022 09:32:30 GMT and should not be manually modified.
+This log was last generated on Sun, 09 Apr 2023 05:55:33 GMT and should not be manually modified.
+
+## 0.0.19
+Sun, 09 Apr 2023 05:55:33 GMT
+
+### Updates
+
+- Add an option to combine small chunks into target size in `ChunkStream`, and rename it to `DistributionStream`
+
+## 0.0.18
+Wed, 25 Jan 2023 21:33:49 GMT
+
+### Updates
+
+- Change to load native Web Streams API implementation from `globalThis` if available
 
 ## 0.0.17
 Tue, 18 Oct 2022 09:32:30 GMT
 
 _Initial release_
-

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2020-2022 Simon Chan
+Copyright (c) 2020-2023 Simon Chan
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -1,11 +1,43 @@
 # @yume-chan/stream-extra
 
-Some useful extensions for Web Streams API.
+Some useful extensions for working with binary streams. Conforms to the [Web Streams API](https://streams.spec.whatwg.org/).
 
-Currently it's using [web-streams-polyfill](https://github.com/MattiasBuelens/web-streams-polyfill) because it's hard to load native implementations from both browsers and Node.js. (An experimental implementation using Top Level Await is available in `native.ts`, but not exported).
+## Find an implementation
+
+If all of `ReadableStream`, `WritableStream` and `TransformStream` fields are available on `globalThis`, they will be used. Otherwise, the [web-streams-polyfill](https://github.com/MattiasBuelens/web-streams-polyfill) package will be used.
+
+Google Chrome 89 and Mozilla Firefox 102 provide full support for Web Streams API natively.
+
+In Node.js, it's not possible to load the `stream/web` module while keeping the compatibility with both Web and bundlers:
+
+-   Webpack has poor support with Top Level Await, for example, Hot Module Replacement doesn't work when any module is using TLA.
+-   Web doesn't have the `module` module, thus requires a shim in import map.
+
+Assigning `ReadableStream`, `WritableStream` and `TransformStream` from `stream/web` module to `globalThis`, before loading this library, will still work. Other custom polyfill can also be loaded this way.
+
+## Compatibility issue with `ReadableStream#pipeTo` and `ReadableStream#pipeThrough`
+
+The [Web Streams API spec](https://streams.spec.whatwg.org/#readable-stream-pipe-to) specifies that `ReadableStream#pipeTo` must check the argument to be an instance of `WritableStream`, so it can optimize the performance by calling internal methods directly.
+
+Native implementations will perform this check, so `new globalThis.ReadableStream().pipeTo(new Polyfill.WritableStream())` will throw an error.
+
+The `WrapReadableStream` class can be used to bypass this check:
+
+```ts
+import { WrapReadableStream } from "@yume-chan/stream-extra";
+import { WritableStream as PolyfillWritableStream } from "web-streams-polyfill";
+
+const nativeReadable = new globalThis.ReadableStream();
+const wrappedReadable = new WrapReadableStream(new globalThis.ReadableStream());
+
+nativeReadable.pipeTo(new PolyfillWritableStream()); // Error
+wrappedReadable.pipeTo(new PolyfillWritableStream()); // OK
+```
+
+web-streams-polyfill package's `ReadableStream#pipeTo` only uses public methods, so it can be used with any `WritableStream` implementation.
 
 ## `BufferedReadableStream`
 
 Allowing reading specified amount of data by buffering incoming data.
 
-It's not a Web Stream API `ReadableStream`, because `ReadableStream` doesn't allow hinting the desired read size (except using BYOB readable, but causes extra allocations for small reads).
+It's not a Web Streams API `ReadableStream`, because `ReadableStream` doesn't allow hinting the desired read size (except using BYOB readable, but causes extra allocations for small reads).

package/esm/buffered-transform.d.ts

@@ -1,11 +1,12 @@
-import type { ValueOrPromise } from '@yume-chan/struct';
-import { BufferedReadableStream } from './buffered.js';
-import { ReadableStream, ReadableWritablePair, WritableStream } from './stream.js';
-export declare class BufferedTransformStream<T> implements ReadableWritablePair<T, Uint8Array> {
-    private _readable;
-    get readable(): ReadableStream<T>;
-    private _writable;
-    get writable(): WritableStream<Uint8Array>;
-    constructor(transform: (stream: BufferedReadableStream) => ValueOrPromise<T>);
-}
+import type { ValueOrPromise } from "@yume-chan/struct";
+import { BufferedReadableStream } from "./buffered.js";
+import type { ReadableWritablePair } from "./stream.js";
+import { ReadableStream, WritableStream } from "./stream.js";
+export declare class BufferedTransformStream<T> implements ReadableWritablePair<T, Uint8Array> {
+    private _readable;
+    get readable(): ReadableStream<T>;
+    private _writable;
+    get writable(): WritableStream<Uint8Array>;
+    constructor(transform: (stream: BufferedReadableStream) => ValueOrPromise<T>);
+}
 //# sourceMappingURL=buffered-transform.d.ts.map

package/esm/buffered-transform.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"buffered-transform.d.ts","sourceRoot":"","sources":["../src/buffered-transform.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,sBAAsB,EAAoC,MAAM,eAAe,CAAC;AAEzF,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAGnF,qBAAa,uBAAuB,CAAC,CAAC,CAAE,YAAW,oBAAoB,CAAC,CAAC,EAAE,UAAU,CAAC;IAClF,OAAO,CAAC,SAAS,CAAoB;IACrC,IAAW,QAAQ,sBAA6B;IAEhD,OAAO,CAAC,SAAS,CAA6B;IAC9C,IAAW,QAAQ,+BAA6B;gBAEpC,SAAS,EAAE,CAAC,MAAM,EAAE,sBAAsB,KAAK,cAAc,CAAC,CAAC,CAAC;CA4C/E"}
+{"version":3,"file":"buffered-transform.d.ts","sourceRoot":"","sources":["../src/buffered-transform.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAExD,OAAO,EACH,sBAAsB,EAEzB,MAAM,eAAe,CAAC;AAGvB,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAG7D,qBAAa,uBAAuB,CAAC,CAAC,CAClC,YAAW,oBAAoB,CAAC,CAAC,EAAE,UAAU,CAAC;IAE9C,OAAO,CAAC,SAAS,CAAoB;IACrC,IAAW,QAAQ,sBAElB;IAED,OAAO,CAAC,SAAS,CAA6B;IAC9C,IAAW,QAAQ,+BAElB;gBAGG,SAAS,EAAE,CAAC,MAAM,EAAE,sBAAsB,KAAK,cAAc,CAAC,CAAC,CAAC;CA8CvE"}

package/esm/buffered-transform.js

@@ -1,50 +1,56 @@
-import { BufferedReadableStream, BufferedReadableStreamEndedError } from './buffered.js';
-import { PushReadableStream } from './push-readable.js';
-import { ReadableStream, WritableStream } from './stream.js';
-// TODO: BufferedTransformStream: find better implementation
-export class BufferedTransformStream {
-    _readable;
-    get readable() { return this._readable; }
-    _writable;
-    get writable() { return this._writable; }
-    constructor(transform) {
-        // Convert incoming chunks to a `BufferedReadableStream`
-        let sourceStreamController;
-        const buffered = new BufferedReadableStream(new PushReadableStream(controller => sourceStreamController = controller));
-        this._readable = new ReadableStream({
-            async pull(controller) {
-                try {
-                    const value = await transform(buffered);
-                    controller.enqueue(value);
-                }
-                catch (e) {
-                    // TODO: BufferedTransformStream: The semantic of stream ending is not clear
-                    // If the `transform` started but did not finish, it should really be an error?
-                    // But we can't detect that, unless there is a `peek` method on buffered stream.
-                    if (e instanceof BufferedReadableStreamEndedError) {
-                        controller.close();
-                        return;
-                    }
-                    throw e;
-                }
-            },
-            cancel: (reason) => {
-                // Propagate cancel to the source stream
-                // So future writes will be rejected
-                buffered.cancel(reason);
-            }
-        });
-        this._writable = new WritableStream({
-            async write(chunk) {
-                await sourceStreamController.enqueue(chunk);
-            },
-            abort() {
-                sourceStreamController.close();
-            },
-            close() {
-                sourceStreamController.close();
-            },
-        });
-    }
-}
+import { BufferedReadableStream, BufferedReadableStreamEndedError, } from "./buffered.js";
+import { PushReadableStream } from "./push-readable.js";
+import { ReadableStream, WritableStream } from "./stream.js";
+// TODO: BufferedTransformStream: find better implementation
+export class BufferedTransformStream {
+    _readable;
+    get readable() {
+        return this._readable;
+    }
+    _writable;
+    get writable() {
+        return this._writable;
+    }
+    constructor(transform) {
+        // Convert incoming chunks to a `BufferedReadableStream`
+        let sourceStreamController;
+        const buffered = new BufferedReadableStream(new PushReadableStream((controller) => {
+            sourceStreamController = controller;
+        }));
+        this._readable = new ReadableStream({
+            async pull(controller) {
+                try {
+                    const value = await transform(buffered);
+                    controller.enqueue(value);
+                }
+                catch (e) {
+                    // Treat `BufferedReadableStreamEndedError` as a normal end.
+                    // If the `transform` method doesn't have enough data to return a value,
+                    // it should throw another error to indicate that.
+                    if (e instanceof BufferedReadableStreamEndedError) {
+                        controller.close();
+                        return;
+                    }
+                    throw e;
+                }
+            },
+            cancel: (reason) => {
+                // Propagate cancel to the source stream
+                // So future writes will be rejected
+                return buffered.cancel(reason);
+            },
+        });
+        this._writable = new WritableStream({
+            async write(chunk) {
+                await sourceStreamController.enqueue(chunk);
+            },
+            abort() {
+                sourceStreamController.close();
+            },
+            close() {
+                sourceStreamController.close();
+            },
+        });
+    }
+}
 //# sourceMappingURL=buffered-transform.js.map

package/esm/buffered-transform.js.map

@@ -1 +1 @@
-{"version":3,"file":"buffered-transform.js","sourceRoot":"","sources":["../src/buffered-transform.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,gCAAgC,EAAE,MAAM,eAAe,CAAC;AACzF,OAAO,EAAE,kBAAkB,EAAgC,MAAM,oBAAoB,CAAC;AACtF,OAAO,EAAE,cAAc,EAAwB,cAAc,EAAE,MAAM,aAAa,CAAC;AAEnF,4DAA4D;AAC5D,MAAM,OAAO,uBAAuB;IACxB,SAAS,CAAoB;IACrC,IAAW,QAAQ,KAAK,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC;IAExC,SAAS,CAA6B;IAC9C,IAAW,QAAQ,KAAK,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC;IAEhD,YAAY,SAAgE;QACxE,wDAAwD;QACxD,IAAI,sBAAiE,CAAC;QAEtE,MAAM,QAAQ,GAAG,IAAI,sBAAsB,CAAC,IAAI,kBAAkB,CAC9D,UAAU,CAAC,EAAE,CACT,sBAAsB,GAAG,UAAU,CAC1C,CAAC,CAAC;QAEH,IAAI,CAAC,SAAS,GAAG,IAAI,cAAc,CAAI;YACnC,KAAK,CAAC,IAAI,CAAC,UAAU;gBACjB,IAAI;oBACA,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,QAAQ,CAAC,CAAC;oBACxC,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;iBAC7B;gBAAC,OAAO,CAAC,EAAE;oBACR,4EAA4E;oBAC5E,+EAA+E;oBAC/E,gFAAgF;oBAChF,IAAI,CAAC,YAAY,gCAAgC,EAAE;wBAC/C,UAAU,CAAC,KAAK,EAAE,CAAC;wBACnB,OAAO;qBACV;oBACD,MAAM,CAAC,CAAC;iBACX;YACL,CAAC;YACD,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE;gBACf,wCAAwC;gBACxC,oCAAoC;gBACpC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YAC5B,CAAC;SACJ,CAAC,CAAC;QAEH,IAAI,CAAC,SAAS,GAAG,IAAI,cAAc,CAAC;YAChC,KAAK,CAAC,KAAK,CAAC,KAAK;gBACb,MAAM,sBAAsB,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YAChD,CAAC;YACD,KAAK;gBACD,sBAAsB,CAAC,KAAK,EAAE,CAAC;YACnC,CAAC;YACD,KAAK;gBACD,sBAAsB,CAAC,KAAK,EAAE,CAAC;YACnC,CAAC;SACJ,CAAC,CAAC;IACP,CAAC;CACJ"}
+{"version":3,"file":"buffered-transform.js","sourceRoot":"","sources":["../src/buffered-transform.ts"],"names":[],"mappings":"AAEA,OAAO,EACH,sBAAsB,EACtB,gCAAgC,GACnC,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAExD,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7D,4DAA4D;AAC5D,MAAM,OAAO,uBAAuB;IAGxB,SAAS,CAAoB;IACrC,IAAW,QAAQ;QACf,OAAO,IAAI,CAAC,SAAS,CAAC;IAC1B,CAAC;IAEO,SAAS,CAA6B;IAC9C,IAAW,QAAQ;QACf,OAAO,IAAI,CAAC,SAAS,CAAC;IAC1B,CAAC;IAED,YACI,SAAgE;QAEhE,wDAAwD;QACxD,IAAI,sBAAiE,CAAC;QAEtE,MAAM,QAAQ,GAAG,IAAI,sBAAsB,CACvC,IAAI,kBAAkB,CAAa,CAAC,UAAU,EAAE,EAAE;YAC9C,sBAAsB,GAAG,UAAU,CAAC;QACxC,CAAC,CAAC,CACL,CAAC;QAEF,IAAI,CAAC,SAAS,GAAG,IAAI,cAAc,CAAI;YACnC,KAAK,CAAC,IAAI,CAAC,UAAU;gBACjB,IAAI;oBACA,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,QAAQ,CAAC,CAAC;oBACxC,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;iBAC7B;gBAAC,OAAO,CAAC,EAAE;oBACR,4DAA4D;oBAC5D,wEAAwE;oBACxE,kDAAkD;oBAClD,IAAI,CAAC,YAAY,gCAAgC,EAAE;wBAC/C,UAAU,CAAC,KAAK,EAAE,CAAC;wBACnB,OAAO;qBACV;oBACD,MAAM,CAAC,CAAC;iBACX;YACL,CAAC;YACD,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE;gBACf,wCAAwC;gBACxC,oCAAoC;gBACpC,OAAO,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YACnC,CAAC;SACJ,CAAC,CAAC;QAEH,IAAI,CAAC,SAAS,GAAG,IAAI,cAAc,CAAC;YAChC,KAAK,CAAC,KAAK,CAAC,KAAK;gBACb,MAAM,sBAAsB,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YAChD,CAAC;YACD,KAAK;gBACD,sBAAsB,CAAC,KAAK,EAAE,CAAC;YACnC,CAAC;YACD,KAAK;gBACD,sBAAsB,CAAC,KAAK,EAAE,CAAC;YACnC,CAAC;SACJ,CAAC,CAAC;IACP,CAAC;CACJ"}

package/esm/buffered.d.ts

@@ -1,28 +1,30 @@
-import type { ReadableStream, ReadableStreamDefaultReader } from "./stream.js";
-export declare class BufferedReadableStreamEndedError extends Error {
-    constructor();
-}
-export declare class BufferedReadableStream {
-    private buffered;
-    private bufferedOffset;
-    private bufferedLength;
-    protected readonly stream: ReadableStream<Uint8Array>;
-    protected readonly reader: ReadableStreamDefaultReader<Uint8Array>;
-    constructor(stream: ReadableStream<Uint8Array>);
-    private readSource;
-    private readAsync;
-    /**
-     *
-     * @param length
-     * @returns
-     */
-    read(length: number): Uint8Array | Promise<Uint8Array>;
-    /**
-     * Return a readable stream with unconsumed data (if any) and
-     * all data from the wrapped stream.
-     * @returns A `ReadableStream`
-     */
-    release(): ReadableStream<Uint8Array>;
-    cancel(reason?: any): Promise<void>;
-}
+import type { ReadableStream, ReadableStreamDefaultReader } from "./stream.js";
+export declare class BufferedReadableStreamEndedError extends Error {
+    constructor();
+}
+export declare class BufferedReadableStream {
+    private buffered;
+    private bufferedOffset;
+    private bufferedLength;
+    private _position;
+    get position(): number;
+    protected readonly stream: ReadableStream<Uint8Array>;
+    protected readonly reader: ReadableStreamDefaultReader<Uint8Array>;
+    constructor(stream: ReadableStream<Uint8Array>);
+    private readSource;
+    private readAsync;
+    /**
+     *
+     * @param length
+     * @returns
+     */
+    read(length: number): Uint8Array | Promise<Uint8Array>;
+    /**
+     * Return a readable stream with unconsumed data (if any) and
+     * all data from the wrapped stream.
+     * @returns A `ReadableStream`
+     */
+    release(): ReadableStream<Uint8Array>;
+    cancel(reason?: unknown): Promise<void>;
+}
 //# sourceMappingURL=buffered.d.ts.map

package/esm/buffered.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"buffered.d.ts","sourceRoot":"","sources":["../src/buffered.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,2BAA2B,EAAE,MAAM,aAAa,CAAC;AAE/E,qBAAa,gCAAiC,SAAQ,KAAK;;CAO1D;AAED,qBAAa,sBAAsB;IAC/B,OAAO,CAAC,QAAQ,CAAyB;IACzC,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,cAAc,CAAK;IAE3B,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC,UAAU,CAAC,CAAC;IAEtD,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,2BAA2B,CAAC,UAAU,CAAC,CAAC;gBAEhD,MAAM,EAAE,cAAc,CAAC,UAAU,CAAC;YAKvC,UAAU;YAQV,SAAS;IAmDvB;;;;OAIG;IACI,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;IAoB7D;;;;OAIG;IACI,OAAO,IAAI,cAAc,CAAC,UAAU,CAAC;IA6BrC,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG;CAG7B"}
+{"version":3,"file":"buffered.d.ts","sourceRoot":"","sources":["../src/buffered.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,2BAA2B,EAAE,MAAM,aAAa,CAAC;AAE/E,qBAAa,gCAAiC,SAAQ,KAAK;;CAO1D;AAED,qBAAa,sBAAsB;IAC/B,OAAO,CAAC,QAAQ,CAAyB;IACzC,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,cAAc,CAAK;IAE3B,OAAO,CAAC,SAAS,CAAK;IACtB,IAAW,QAAQ,WAElB;IAED,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC,UAAU,CAAC,CAAC;IACtD,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,2BAA2B,CAAC,UAAU,CAAC,CAAC;gBAEhD,MAAM,EAAE,cAAc,CAAC,UAAU,CAAC;YAKvC,UAAU;YASV,SAAS;IAmDvB;;;;OAIG;IACI,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;IAoB7D;;;;OAIG;IACI,OAAO,IAAI,cAAc,CAAC,UAAU,CAAC;IAuBrC,MAAM,CAAC,MAAM,CAAC,EAAE,OAAO;CAGjC"}

package/esm/buffered.js

@@ -1,131 +1,129 @@
-import { PushReadableStream } from "./push-readable.js";
-export class BufferedReadableStreamEndedError extends Error {
-    constructor() {
-        super('Stream ended');
-        // Fix Error's prototype chain when compiling to ES5
-        Object.setPrototypeOf(this, new.target.prototype);
-    }
-}
-export class BufferedReadableStream {
-    buffered;
-    bufferedOffset = 0;
-    bufferedLength = 0;
-    stream;
-    reader;
-    constructor(stream) {
-        this.stream = stream;
-        this.reader = stream.getReader();
-    }
-    async readSource() {
-        const { done, value } = await this.reader.read();
-        if (done) {
-            throw new BufferedReadableStreamEndedError();
-        }
-        return value;
-    }
-    async readAsync(length, initial) {
-        let result;
-        let index;
-        if (initial) {
-            result = new Uint8Array(length);
-            result.set(initial);
-            index = initial.byteLength;
-            length -= initial.byteLength;
-        }
-        else {
-            const array = await this.readSource();
-            if (array.byteLength === length) {
-                return array;
-            }
-            if (array.byteLength > length) {
-                this.buffered = array;
-                this.bufferedOffset = length;
-                this.bufferedLength = array.byteLength - length;
-                return array.subarray(0, length);
-            }
-            result = new Uint8Array(length);
-            result.set(array);
-            index = array.byteLength;
-            length -= array.byteLength;
-        }
-        while (length > 0) {
-            const array = await this.readSource();
-            if (array.byteLength === length) {
-                result.set(array, index);
-                return result;
-            }
-            if (array.byteLength > length) {
-                this.buffered = array;
-                this.bufferedOffset = length;
-                this.bufferedLength = array.byteLength - length;
-                result.set(array.subarray(0, length), index);
-                return result;
-            }
-            result.set(array, index);
-            index += array.byteLength;
-            length -= array.byteLength;
-        }
-        return result;
-    }
-    /**
-     *
-     * @param length
-     * @returns
-     */
-    read(length) {
-        // PERF: Add a synchronous path for reading from internal buffer
-        if (this.buffered) {
-            const array = this.buffered;
-            const offset = this.bufferedOffset;
-            if (this.bufferedLength > length) {
-                // PERF: `subarray` is slow
-                // don't use it until absolutely necessary
-                this.bufferedOffset += length;
-                this.bufferedLength -= length;
-                return array.subarray(offset, offset + length);
-            }
-            this.buffered = undefined;
-            return this.readAsync(length, array.subarray(offset));
-        }
-        return this.readAsync(length);
-    }
-    /**
-     * Return a readable stream with unconsumed data (if any) and
-     * all data from the wrapped stream.
-     * @returns A `ReadableStream`
-     */
-    release() {
-        if (this.buffered) {
-            return new PushReadableStream(async (controller) => {
-                // Put the remaining data back to the stream
-                await controller.enqueue(this.buffered);
-                // Manually pipe the stream
-                while (true) {
-                    try {
-                        const { done, value } = await this.reader.read();
-                        if (done) {
-                            controller.close();
-                            break;
-                        }
-                        else {
-                            await controller.enqueue(value);
-                        }
-                    }
-                    catch (e) {
-                        controller.error(e);
-                        break;
-                    }
-                }
-            });
-        }
-        else {
-            // Simply release the reader and return the stream
-            this.reader.releaseLock();
-            return this.stream;
-        }
-    }
-    cancel(reason) {
-        return this.reader.cancel(reason);
-    }
-}
+import { PushReadableStream } from "./push-readable.js";
+export class BufferedReadableStreamEndedError extends Error {
+    constructor() {
+        super("Stream ended");
+        // Fix Error's prototype chain when compiling to ES5
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+}
+export class BufferedReadableStream {
+    buffered;
+    bufferedOffset = 0;
+    bufferedLength = 0;
+    _position = 0;
+    get position() {
+        return this._position;
+    }
+    stream;
+    reader;
+    constructor(stream) {
+        this.stream = stream;
+        this.reader = stream.getReader();
+    }
+    async readSource() {
+        const { done, value } = await this.reader.read();
+        if (done) {
+            throw new BufferedReadableStreamEndedError();
+        }
+        this._position += value.byteLength;
+        return value;
+    }
+    async readAsync(length, initial) {
+        let result;
+        let index;
+        if (initial) {
+            result = new Uint8Array(length);
+            result.set(initial);
+            index = initial.byteLength;
+            length -= initial.byteLength;
+        }
+        else {
+            const array = await this.readSource();
+            if (array.byteLength === length) {
+                return array;
+            }
+            if (array.byteLength > length) {
+                this.buffered = array;
+                this.bufferedOffset = length;
+                this.bufferedLength = array.byteLength - length;
+                return array.subarray(0, length);
+            }
+            result = new Uint8Array(length);
+            result.set(array);
+            index = array.byteLength;
+            length -= array.byteLength;
+        }
+        while (length > 0) {
+            const array = await this.readSource();
+            if (array.byteLength === length) {
+                result.set(array, index);
+                return result;
+            }
+            if (array.byteLength > length) {
+                this.buffered = array;
+                this.bufferedOffset = length;
+                this.bufferedLength = array.byteLength - length;
+                result.set(array.subarray(0, length), index);
+                return result;
+            }
+            result.set(array, index);
+            index += array.byteLength;
+            length -= array.byteLength;
+        }
+        return result;
+    }
+    /**
+     *
+     * @param length
+     * @returns
+     */
+    read(length) {
+        // PERF: Add a synchronous path for reading from internal buffer
+        if (this.buffered) {
+            const array = this.buffered;
+            const offset = this.bufferedOffset;
+            if (this.bufferedLength > length) {
+                // PERF: `subarray` is slow
+                // don't use it until absolutely necessary
+                this.bufferedOffset += length;
+                this.bufferedLength -= length;
+                return array.subarray(offset, offset + length);
+            }
+            this.buffered = undefined;
+            return this.readAsync(length, array.subarray(offset));
+        }
+        return this.readAsync(length);
+    }
+    /**
+     * Return a readable stream with unconsumed data (if any) and
+     * all data from the wrapped stream.
+     * @returns A `ReadableStream`
+     */
+    release() {
+        if (this.buffered) {
+            return new PushReadableStream(async (controller) => {
+                // Put the remaining data back to the stream
+                await controller.enqueue(this.buffered);
+                // Manually pipe the stream
+                while (true) {
+                    const { done, value } = await this.reader.read();
+                    if (done) {
+                        return;
+                    }
+                    else {
+                        await controller.enqueue(value);
+                    }
+                }
+            });
+        }
+        else {
+            // Simply release the reader and return the stream
+            this.reader.releaseLock();
+            return this.stream;
+        }
+    }
+    cancel(reason) {
+        return this.reader.cancel(reason);
+    }
+}
 //# sourceMappingURL=buffered.js.map

package/esm/buffered.js.map

@@ -1 +1 @@
-{"version":3,"file":"buffered.js","sourceRoot":"","sources":["../src/buffered.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"buffered.js","sourceRoot":"","sources":["../src/buffered.ts"],"names":[],"mappings":"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"}