@zenfs/core 2.7.3 → 2.7.4

package/dist/internal/filesystem.d.ts

@@ -117,6 +117,7 @@ export interface StreamOptions {
     start?: number;
     end?: number;
     autoClose?: boolean;
+    chunkSize?: number;
 }
 /**
  * Provides a consistent and easy to use internal API.

package/dist/internal/filesystem.js

@@ -1,7 +1,8 @@
 // SPDX-License-Identifier: LGPL-3.0-or-later
 import { withErrno } from 'kerium';
 import { ioctl_default_ops_async, ioctl_default_ops_sync } from './ioctl.js';
-const _chunkSize = 0x1000;
+/** Default bytes per chunk for streamed reads, matching Node's default stream `highWaterMark` */
+const defaultChunkSize = 0x10000;
 /**
  * Provides a consistent and easy to use internal API.
  * Default implementations for `exists` and `existsSync` are included.
@@ -97,17 +98,22 @@ export class FileSystem {
      * @privateRemarks The default implementation of `streamRead` uses "chunked" `read`s
      */
     streamRead(path, options) {
+        const { chunkSize = defaultChunkSize } = options;
+        let offset = options.start ?? 0;
+        let end = options.end;
         return new ReadableStream({
-            start: async (controller) => {
-                const { size } = await this.stat(path);
-                const { start = 0, end = size } = options;
-                for (let offset = start; offset < end; offset += _chunkSize) {
-                    const bytesRead = offset + _chunkSize > end ? end - offset : _chunkSize;
-                    const buffer = new Uint8Array(bytesRead);
-                    await this.read(path, buffer, offset, offset + bytesRead).catch(controller.error.bind(controller));
-                    controller.enqueue(buffer);
+            pull: async (controller) => {
+                end ??= (await this.stat(path)).size;
+                if (offset >= end) {
+                    controller.close();
+                    return;
                 }
-                controller.close();
+                const buffer = new Uint8Array(Math.min(chunkSize, end - offset));
+                await this.read(path, buffer, offset, offset + buffer.byteLength);
+                offset += buffer.byteLength;
+                controller.enqueue(buffer);
+                if (offset >= end)
+                    controller.close();
             },
             type: 'bytes',
         });

package/dist/node/streams.d.ts

@@ -1,10 +1,10 @@
-/// <reference path="../../types/readable-stream.d.ts" preserve="true" />
 import type { Abortable } from 'node:events';
 import type * as fs from 'node:fs';
 import type { CreateReadStreamOptions, CreateWriteStreamOptions } from 'node:fs/promises';
 import type { Callback } from '../utils.js';
 import type { FileHandle } from './promises.js';
-import { Readable, Writable } from 'readable-stream';
+import { Readable } from '@zenfs/streams/readable';
+import { Writable } from '@zenfs/streams/writable';
 interface FSImplementation {
     open?: (...args: unknown[]) => unknown;
     close?: (...args: unknown[]) => unknown;

package/dist/node/streams.js

@@ -1,6 +1,8 @@
+import { eos } from '@zenfs/streams/end-of-stream';
+import { Readable } from '@zenfs/streams/readable';
+import { Writable } from '@zenfs/streams/writable';
 import { Errno, Exception, UV } from 'kerium';
 import { warn } from 'kerium/log';
-import { finished, Readable, Writable } from 'readable-stream';
 /**
  * A ReadStream implementation that wraps an underlying global ReadableStream.
  */
@@ -16,7 +18,11 @@ export class ReadStream extends Readable {
             .then(handle => {
             this._path = handle['vfs'].path;
             // `end` is inclusive for streams, but the internal range is not
-            const internal = handle.readableWebStream({ start: opts.start, end: opts.end === undefined ? undefined : opts.end + 1 });
+            const internal = handle.readableWebStream({
+                start: opts.start,
+                end: opts.end === undefined ? undefined : opts.end + 1,
+                chunkSize: opts.highWaterMark,
+            });
             this.reader = internal.getReader();
             this.pending = false;
         })
@@ -46,7 +52,7 @@ export class ReadStream extends Readable {
      * Closing before the stream has finished reports `ERR_STREAM_PREMATURE_CLOSE`.
      */
     close(callback = () => null) {
-        finished(this, error => callback(error ?? null));
+        eos(this, error => callback(error ?? null));
         this.destroy();
     }
     get path() {

package/dist/vfs/file.js

@@ -93,8 +93,8 @@ import { _chown, InodeFlags, isBlockDevice, isCharacterDevice } from '../interna
 import '../polyfills.js';
 import { validateFD } from '../utils.js';
 import { cacheOf } from './vcache.js';
-/** The chunk size used when streaming reads and writes */
-const streamChunkSize = 0x1000;
+/** Default bytes per chunk for streamed reads, matching Node's default stream `highWaterMark` */
+const streamChunkSize = 0x10000;
 /**
  * @internal
  */
@@ -608,19 +608,25 @@ let Handle = (() => {
             if (this.closed)
                 throw UV('EBADF', 'streamRead', this.path);
             const { vnode } = this;
+            const { chunkSize = streamChunkSize } = options;
+            let offset = options.start ?? 0;
+            let end = options.end;
             return new ReadableStream({
-                async start(controller) {
+                async pull(controller) {
                     const env_15 = { stack: [], error: void 0, hasError: false };
                     try {
                         const _ = __addDisposableResource(env_15, await vnode.lock('ro'), false);
-                        const { start = 0, end = vnode.inode.size } = options;
-                        for (let offset = start; offset < end; offset += streamChunkSize) {
-                            const bytesRead = offset + streamChunkSize > end ? end - offset : streamChunkSize;
-                            const buffer = new Uint8Array(bytesRead);
-                            await vnode.read(buffer, offset, offset + bytesRead).catch(controller.error.bind(controller));
-                            controller.enqueue(buffer);
+                        end ??= vnode.inode.size;
+                        if (offset >= end) {
+                            controller.close();
+                            return;
                         }
-                        controller.close();
+                        const buffer = new Uint8Array(Math.min(chunkSize, end - offset));
+                        await vnode.read(buffer, offset, offset + buffer.byteLength);
+                        offset += buffer.byteLength;
+                        controller.enqueue(buffer);
+                        if (offset >= end)
+                            controller.close();
                     }
                     catch (e_15) {
                         env_15.error = e_15;

package/dist/vfs/vnode.js

@@ -1,6 +1,6 @@
 // SPDX-License-Identifier: LGPL-3.0-or-later
 import { RwLockable } from 'kerium/locks';
-import { Resource } from 'utilium/cache';
+import { addRange, Resource } from 'utilium/cache';
 import { InodeFlags, isBlockDevice, isCharacterDevice } from '../internal/inode.js';
 /**
  * A VFS-level node, roughly equivalent to Linux's in-memory `struct inode`.
@@ -57,17 +57,7 @@ export class VNode extends RwLockable {
     }
     /** Add a range to `dirtyRanges`, merging overlapping and adjacent ranges */
     markDirty(start, end) {
-        this.dirtyRanges.push({ start, end });
-        this.dirtyRanges.sort((a, b) => a.start - b.start);
-        const merged = [];
-        for (const range of this.dirtyRanges) {
-            const last = merged.at(-1);
-            if (last && range.start <= last.end)
-                last.end = Math.max(last.end, range.end);
-            else
-                merged.push(range);
-        }
-        this.dirtyRanges = merged;
+        addRange(this.dirtyRanges, start, end);
     }
     /**
      * Copy `[start, end)` from the cache into `buffer`.
@@ -75,12 +65,10 @@ export class VNode extends RwLockable {
      */
     copyFromCache(buffer, start, end) {
         let pos = start;
-        for (const region of this.data.regions) {
+        for (const region of this.data.regionsIn(start, end)) {
             const regionEnd = region.offset + region.data.byteLength;
             if (regionEnd <= pos)
                 continue;
-            if (region.offset >= end)
-                break;
             if (region.offset > pos) {
                 buffer.fill(0, pos - start, region.offset - start);
                 pos = region.offset;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@zenfs/core",
-	"version": "2.7.3",
+	"version": "2.7.4",
 	"description": "A filesystem, anywhere",
 	"funding": {
 		"type": "individual",
@@ -69,18 +69,19 @@
 		"lint": "eslint src tests",
 		"test": "npx -s zenfs-test --clean; npx -s zenfs-test -abcpn; tests/fetch/run.sh; npx -s zenfs-test --report-only",
 		"test:native": "npx -s zenfs-test tests/native-setup.ts --verbose",
+		"test:perf": "zbench",
 		"build": "tsc --build",
 		"dev": "tsc --build --watch",
 		"prepublishOnly": "npm run build"
 	},
 	"dependencies": {
 		"@types/node": "^26.0.0",
+		"@zenfs/streams": "^1.0.0",
 		"buffer": "^6.0.3",
 		"eventemitter3": "^5.0.1",
 		"kerium": "^1.5.0",
 		"memium": "^1.0.0",
-		"readable-stream": "^4.5.2",
-		"utilium": "^3.0.0"
+		"utilium": "^3.7.0"
 	},
 	"devDependencies": {
 		"@eslint/js": "^10.0.1",
@@ -91,7 +92,8 @@
 		"prettier": "^3.2.5",
 		"typedoc": "^0.28.18",
 		"typescript": "^6.0.0",
-		"typescript-eslint": "^8.58.0"
+		"typescript-eslint": "^8.58.0",
+		"zbench-js": "^0.1.0"
 	},
 	"prettier": {
 		"singleQuote": true,

package/tests/fs/streams.test.ts

@@ -141,4 +141,64 @@ suite('Streams', config('streams'), () => {
 		// Closing invalidates the descriptor, so it fails range validation
 		assert.throws(() => fileHandle.createWriteStream(), { code: 'ERR_OUT_OF_RANGE' });
 	});
+
+	// A file large enough to span several chunks, so the read path has to stitch
+	// them back together and the vnode cache has to grow to hold them.
+	const large = Buffer.alloc(200 * 1024);
+	for (let i = 0; i < large.length; i++) large[i] = (i * 31 + 7) & 0xff;
+
+	test('createReadStream reads a multi-chunk file byte for byte', async () => {
+		await fs.promises.writeFile('large.bin', large);
+
+		const chunks: Uint8Array[] = [];
+		for await (const chunk of fs.createReadStream('large.bin')) chunks.push(chunk as Uint8Array);
+
+		assert.deepEqual(Buffer.concat(chunks), large);
+	});
+
+	test('createReadStream honors highWaterMark as the chunk size', async () => {
+		await fs.promises.writeFile('large.bin', large);
+
+		const highWaterMark = 64 * 1024;
+		const sizes: number[] = [];
+		for await (const chunk of fs.createReadStream('large.bin', { highWaterMark })) sizes.push((chunk as Uint8Array).byteLength);
+
+		// Every chunk but the last is a full highWaterMark, and they sum to the file
+		assert.deepEqual(sizes.slice(0, -1), Array(sizes.length - 1).fill(highWaterMark));
+		assert.equal(
+			sizes.reduce((a, b) => a + b, 0),
+			large.length
+		);
+	});
+
+	test('createReadStream with start and end spanning chunks', async () => {
+		await fs.promises.writeFile('large.bin', large);
+
+		// `end` is inclusive, and this range deliberately starts and stops mid-chunk
+		const start = 1000;
+		const end = 150_000;
+		const chunks: Uint8Array[] = [];
+		for await (const chunk of fs.createReadStream('large.bin', { start, end, highWaterMark: 8192 })) chunks.push(chunk as Uint8Array);
+
+		assert.deepEqual(Buffer.concat(chunks), large.subarray(start, end + 1));
+	});
+
+	test('a read stream does not read past the end of the file', async () => {
+		await fs.promises.writeFile('small.bin', large.subarray(0, 10));
+
+		const chunks: Uint8Array[] = [];
+		for await (const chunk of fs.createReadStream('small.bin', { highWaterMark: 64 * 1024 })) chunks.push(chunk as Uint8Array);
+
+		assert.equal(chunks.length, 1);
+		assert.deepEqual(chunks[0], large.subarray(0, 10));
+	});
+
+	test('a read stream over an empty file ends without a chunk', async () => {
+		await fs.promises.writeFile('empty.bin', '');
+
+		const chunks: unknown[] = [];
+		for await (const chunk of fs.createReadStream('empty.bin')) chunks.push(chunk);
+
+		assert.deepEqual(chunks, []);
+	});
 });

package/tests/perf/append.ts

@@ -0,0 +1,34 @@
+// SPDX-License-Identifier: LGPL-3.0-or-later
+// Sequential appends into one region. Every write extends the same region, so a region that
+// allocates exactly what it needs copies the whole file on each append.
+import type { FileHandle } from '@zenfs/core/promises';
+import { fs, mount, piece } from './common.ts';
+
+interface Config {
+	writes: number;
+}
+
+interface State {
+	data: Buffer;
+	handle?: FileHandle;
+}
+
+export async function setup(): Promise<State> {
+	await mount('perf-append');
+	return { data: Buffer.alloc(piece, 0x11) };
+}
+
+export async function before(config: Config, state: State): Promise<void> {
+	state.handle = await fs.promises.open('/a', 'w');
+}
+
+export async function test(config: Config, state: State) {
+	for (let i = 0; i < config.writes; i++) await state.handle!.write(state.data, 0, state.data.length, i * piece);
+
+	return { writes: config.writes, bytes: config.writes * piece };
+}
+
+export async function after(config: Config, state: State): Promise<void> {
+	await state.handle!.close();
+	await fs.promises.rm('/a');
+}

package/tests/perf/common.ts

@@ -0,0 +1,31 @@
+// SPDX-License-Identifier: LGPL-3.0-or-later
+import { configureSingle, fs, InMemory } from '@zenfs/core';
+
+export { fs };
+
+export const KB = 1024;
+export const MB = 1024 * 1024;
+
+/**
+ * A piece and the stride between pieces, chosen so consecutive writes never merge into one region:
+ * the 12 KB hole between them is wider than `regionGapThreshold`.
+ */
+export const piece = 4 * KB;
+export const stride = 16 * KB;
+
+/** A fresh in-memory filesystem, so no configuration inherits another's cached vnodes. */
+export async function mount(name: string): Promise<void> {
+	await configureSingle({ backend: InMemory, name });
+}
+
+/** Split a buffer the way a stream writer feeds it. */
+export function chunks(buffer: Buffer, size: number): Buffer[] {
+	const out: Buffer[] = [];
+	for (let i = 0; i < buffer.length; i += size) out.push(buffer.subarray(i, Math.min(i + size, buffer.length)));
+	return out;
+}
+
+/** Give the event loop a moment, so work queued by the previous phase never lands in the timed one. */
+export function settle(): Promise<void> {
+	return new Promise(resolve => setTimeout(resolve, 50));
+}

package/tests/perf/config.json

@@ -0,0 +1,84 @@
+{
+	"flags": {
+		"prep": ["writeFile", "stream"]
+	},
+	"tests": [
+		{
+			"path": "stream-read.ts",
+			"name": "Read with createReadStream",
+			"flags": ["prep"],
+			"measure": {
+				"bytes": { "throughput": "s", "aggregate_throughput": "s", "unit": "MB" },
+				"files": { "cost": true, "unit": "file" }
+			},
+			"configurations": [
+				{ "name": "4K x2000", "value": { "size": 4096, "count": 2000, "hwm": 65536 } },
+				{ "name": "256K x200", "value": { "size": 262144, "count": 200, "hwm": 65536 } },
+				{ "name": "8M x8", "cpu": 1, "mem": 1, "value": { "size": 8388608, "count": 8, "hwm": 65536 } },
+				{
+					"name": "8M x8, hwm 1M",
+					"cpu": 1,
+					"mem": 1,
+					"value": { "size": 8388608, "count": 8, "hwm": 1048576 }
+				}
+			]
+		},
+		{
+			"path": "stream-write.ts",
+			"name": "Write with createWriteStream",
+			"measure": {
+				"bytes": { "throughput": "s", "aggregate_throughput": "s", "unit": "MB" },
+				"files": { "cost": true, "unit": "file" }
+			},
+			"configurations": [
+				{ "name": "4K x2000", "value": { "size": 4096, "count": 2000, "hwm": 65536 } },
+				{ "name": "256K x200", "value": { "size": 262144, "count": 200, "hwm": 65536 } },
+				{ "name": "8M x8", "cpu": 1, "mem": 1, "value": { "size": 8388608, "count": 8, "hwm": 65536 } },
+				{
+					"name": "8M x8, hwm 1M",
+					"cpu": 1,
+					"mem": 1,
+					"value": { "size": 8388608, "count": 8, "hwm": 1048576 }
+				}
+			]
+		},
+		{
+			"path": "fragmented-read.ts",
+			"name": "Read across many cached regions",
+			"measure": {
+				"reads": { "cost": true, "aggregate_cost": true, "unit": "read" }
+			},
+			"configurations": [
+				{ "name": "128 regions", "value": { "regions": 128, "reads": 4000 } },
+				{ "name": "512 regions", "value": { "regions": 512, "reads": 4000 } },
+				{ "name": "2048 regions", "cpu": 1, "value": { "regions": 2048, "reads": 4000 } },
+				{ "name": "8192 regions", "cpu": 2, "mem": 1, "value": { "regions": 8192, "reads": 4000 } }
+			]
+		},
+		{
+			"path": "fragmented-write.ts",
+			"name": "Scattered writes into one file",
+			"measure": {
+				"writes": { "cost": true, "aggregate_cost": true, "unit": "write" }
+			},
+			"configurations": [
+				{ "name": "512 writes", "value": { "writes": 512 } },
+				{ "name": "2048 writes", "cpu": 1, "value": { "writes": 2048 } },
+				{ "name": "8192 writes", "cpu": 2, "mem": 1, "value": { "writes": 8192 } }
+			]
+		},
+		{
+			"path": "append.ts",
+			"name": "Append 4 KB at a time",
+			"measure": {
+				"bytes": { "throughput": "s", "unit": "MB" },
+				"writes": { "cost": true, "aggregate_cost": true, "unit": "write" }
+			},
+			"configurations": [
+				{ "name": "500 appends", "value": { "writes": 500 } },
+				{ "name": "2000 appends", "value": { "writes": 2000 } },
+				{ "name": "8000 appends", "cpu": 1, "value": { "writes": 8000 } }
+			]
+		}
+	]
+}

package/tests/perf/fragmented-read.ts

@@ -0,0 +1,41 @@
+// SPDX-License-Identifier: LGPL-3.0-or-later
+// Reads spread across a file with many disjoint cached regions.
+
+import type { FileHandle } from '@zenfs/core/promises';
+import { fs, mount, piece, stride } from './common.ts';
+
+interface Config {
+	/** Cached regions to build, one per scattered write */
+	regions: number;
+	reads: number;
+}
+
+interface State {
+	handle: FileHandle;
+	target: Buffer;
+}
+
+export async function setup(config: Config): Promise<State> {
+	await mount('perf-fragmented-read');
+
+	await fs.promises.writeFile('/f', Buffer.alloc(config.regions * stride));
+	const handle = await fs.promises.open('/f', 'r+');
+
+	const data = Buffer.alloc(piece, 0xcd);
+	for (let i = 0; i < config.regions; i++) await handle.write(data, 0, data.length, i * stride);
+
+	return { handle, target: Buffer.allocUnsafe(piece) };
+}
+
+export async function test(config: Config, state: State) {
+	// Backwards, so a scan that starts at region zero pays its worst case on every read
+	for (let i = 0; i < config.reads; i++)
+		await state.handle.read(state.target, 0, state.target.length, (config.regions - 1 - (i % config.regions)) * stride);
+
+	return { reads: config.reads, bytes: config.reads * piece };
+}
+
+export async function teardown(config: Config, state: State): Promise<void> {
+	await state.handle.close();
+	await fs.promises.rm('/f');
+}

package/tests/perf/fragmented-write.ts

@@ -0,0 +1,37 @@
+// SPDX-License-Identifier: LGPL-3.0-or-later
+// Writes that each land in their own region, so the region list grows by one per write.
+// Anything that walks the whole list — or re-sorts the dirty ranges — per write shows up as
+// quadratic here.
+import type { FileHandle } from '@zenfs/core/promises';
+import { fs, mount, piece, stride } from './common.ts';
+
+interface Config {
+	writes: number;
+}
+
+interface State {
+	data: Buffer;
+	handle?: FileHandle;
+}
+
+export async function setup(): Promise<State> {
+	await mount('perf-fragmented-write');
+	return { data: Buffer.alloc(piece, 0xcd) };
+}
+
+/** A fresh file each iteration: the point is the cost of building the region list, not of reusing it. */
+export async function before(config: Config, state: State): Promise<void> {
+	await fs.promises.writeFile('/f', Buffer.alloc(config.writes * stride));
+	state.handle = await fs.promises.open('/f', 'r+');
+}
+
+export async function test(config: Config, state: State) {
+	for (let i = 0; i < config.writes; i++) await state.handle!.write(state.data, 0, state.data.length, i * stride);
+
+	return { writes: config.writes, bytes: config.writes * piece };
+}
+
+export async function after(config: Config, state: State): Promise<void> {
+	await state.handle!.close();
+	await fs.promises.rm('/f');
+}

package/tests/perf/stream-read.ts

@@ -0,0 +1,48 @@
+// SPDX-License-Identifier: LGPL-3.0-or-later
+// Reading through `createReadStream`: the VFS cache lookup, `copyFromCache`, and the stream's own
+// chunking, with the files written outside the timed window.
+import { pipeline } from 'node:stream/promises';
+import { chunks, fs, mount, settle } from './common.ts';
+
+interface Config {
+	size: number;
+	count: number;
+	/** Stream highWaterMark, which is also the read chunk size */
+	hwm: number;
+	prep: 'writeFile' | 'stream';
+}
+
+interface State {
+	buffer: Buffer;
+	parts: Buffer[];
+}
+
+export async function setup(config: Config): Promise<State> {
+	await mount('perf-stream-read');
+	const buffer = Buffer.alloc(config.size, 0xab);
+	return { buffer, parts: chunks(buffer, config.hwm) };
+}
+
+export async function before(config: Config, state: State): Promise<void> {
+	for (let i = 0; i < config.count; i++) {
+		if (config.prep == 'stream') await pipeline(state.parts, fs.createWriteStream(`/w${i}`, { highWaterMark: config.hwm }));
+		else await fs.promises.writeFile(`/w${i}`, state.buffer);
+	}
+	await settle();
+}
+
+export async function test(config: Config) {
+	let bytes = 0;
+
+	for (let i = 0; i < config.count; i++) {
+		for await (const chunk of fs.createReadStream(`/w${i}`, { highWaterMark: config.hwm })) bytes += (chunk as Buffer).length;
+	}
+
+	if (bytes != config.size * config.count) throw new Error(`short read: ${bytes} of ${config.size * config.count}`);
+
+	return { bytes, files: config.count };
+}
+
+export async function after(config: Config): Promise<void> {
+	for (let i = 0; i < config.count; i++) await fs.promises.rm(`/w${i}`);
+}

package/tests/perf/stream-write.ts

@@ -0,0 +1,31 @@
+// SPDX-License-Identifier: LGPL-3.0-or-later
+// Writing through `createWriteStream`: how the cache grows as a file is appended to one chunk at a
+// time. A region that reallocates exactly on every append makes this quadratic in the file's size.
+import { pipeline } from 'node:stream/promises';
+import { chunks, fs, mount, settle } from './common.ts';
+
+interface Config {
+	size: number;
+	count: number;
+	hwm: number;
+}
+
+interface State {
+	parts: Buffer[];
+}
+
+export async function setup(config: Config): Promise<State> {
+	await mount('perf-stream-write');
+	return { parts: chunks(Buffer.alloc(config.size, 0xab), config.hwm) };
+}
+
+export async function test(config: Config, state: State) {
+	for (let i = 0; i < config.count; i++) await pipeline(state.parts, fs.createWriteStream(`/w${i}`, { highWaterMark: config.hwm }));
+
+	return { bytes: config.size * config.count, files: config.count };
+}
+
+export async function after(config: Config): Promise<void> {
+	for (let i = 0; i < config.count; i++) await fs.promises.rm(`/w${i}`);
+	await settle();
+}

package/tests/setup.ts

@@ -8,7 +8,7 @@ export const data = join(import.meta.dirname, 'data');
 
 export const tmp = join(import.meta.dirname, 'tmp');
 
-if (!existsSync(tmp)) mkdirSync(tmp);
+if (!existsSync(tmp)) mkdirSync(tmp, { recursive: true });
 
 export async function copyAsync(_path: string, fs: NodeFS = _fs): Promise<void> {
 	const path = relative(data, _path) || '/';

package/types/README.md

@@ -1 +0,0 @@
-This directory contains declaration files. Due to numerous TypeScript shenanigans, placing them into `src` is a really bad idea. Instead, we put them here.

package/types/readable-stream.d.ts

@@ -1,18 +0,0 @@
-/*
-@types/readable-stream has *many* problems:
-https://github.com/DefinitelyTyped/DefinitelyTyped/discussions/71923
-https://github.com/DefinitelyTyped/DefinitelyTyped/discussions/71307
-https://github.com/DefinitelyTyped/DefinitelyTyped/discussions/71083
-https://github.com/DefinitelyTyped/DefinitelyTyped/discussions/66049
-... and many more
-
-This allows us to bypass those problems.
-
-Warning: Do not install @types/readable-stream alongside this package!
-*/
-
-/// <reference types="node" preserve="true" />
-declare module 'readable-stream' {
-	import { finished, Readable, Writable } from 'node:stream';
-	export { finished, Readable, Writable };
-}