@yume-chan/stream-extra 0.0.18 → 0.0.19

package/CHANGELOG.json

@@ -1,23 +1,35 @@
 {
-  "name": "@yume-chan/stream-extra",
-  "entries": [
-    {
-      "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": {}
-    }
-  ]
+    "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,6 +1,13 @@
 # Change Log - @yume-chan/stream-extra
 
-This log was last generated on Wed, 25 Jan 2023 21:33:49 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
@@ -13,4 +20,3 @@ Wed, 25 Jan 2023 21:33:49 GMT
 Tue, 18 Oct 2022 09:32:30 GMT
 
 _Initial release_
-

package/README.md

@@ -40,4 +40,4 @@ web-streams-polyfill package's `ReadableStream#pipeTo` only uses public methods,
 
 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, WritableStream, type ReadableWritablePair } 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,EAAE,KAAK,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAExD,OAAO,EACH,sBAAsB,EAEzB,MAAM,eAAe,CAAC;AAKvB,OAAO,EACH,cAAc,EACd,cAAc,EACd,KAAK,oBAAoB,EAC5B,MAAM,aAAa,CAAC;AAGrB,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"}
+{"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,56 +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) {
-                    // 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();
-            },
-        });
-    }
-}
+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":"AAEA,OAAO,EACH,sBAAsB,EACtB,gCAAgC,GACnC,MAAM,eAAe,CAAC;AACvB,OAAO,EACH,kBAAkB,GAErB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACH,cAAc,EACd,cAAc,GAEjB,MAAM,aAAa,CAAC;AAErB,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"}
+{"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, type 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?: unknown): 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,EACH,KAAK,cAAc,EACnB,KAAK,2BAA2B,EACnC,MAAM,aAAa,CAAC;AAErB,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;IAuBrC,MAAM,CAAC,MAAM,CAAC,EAAE,OAAO;CAGjC"}
+{"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,124 +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) {
-                    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);
-    }
-}
+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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"}

package/esm/chunk.d.ts

@@ -1,5 +1,8 @@
-import { TransformStream } from "./stream.js";
-export declare class ChunkStream extends TransformStream<Uint8Array, Uint8Array> {
-    constructor(size: number);
+import { TransformStream } from "../src/stream.js";
+export declare class DistributionStream extends TransformStream<
+    Uint8Array,
+    Uint8Array
+> {
+    constructor(size: number, combine?: boolean);
 }
-//# sourceMappingURL=chunk.d.ts.map
+//# sourceMappingURL=chunk.d.ts.map

package/esm/chunk.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chunk.d.ts","sourceRoot":"","sources":["../src/chunk.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C,qBAAa,WAAY,SAAQ,eAAe,CAAC,UAAU,EAAE,UAAU,CAAC;gBACjD,IAAI,EAAE,MAAM;CAWlC"}
+{"version":3,"file":"chunk.d.ts","sourceRoot":"","sources":["../src/chunk.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C,qBAAa,kBAAmB,SAAQ,eAAe,CACnD,UAAU,EACV,UAAU,CACb;gBACsB,IAAI,EAAE,MAAM,EAAE,OAAO,UAAQ;CA+DnD"}