spliterator 1.5.2 → 1.6.2

package/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "spliterator",
-	"version": "1.5.2",
-	"description": "Line-delimited file utilities",
+	"version": "1.6.2",
+	"description": "Line-delimited iterator library for CSV, NDJSON, and other delimited formats.",
 	"keywords": [
 		"csv",
 		"ndjson",
@@ -29,15 +29,18 @@
 	"exports": {
 		"./package.json": "./package.json",
 		".": "./out/index.js",
-		"./node/fs": "./out/lib/node/fs.js",
+		"./node/fs": "./out/node/fs/index.js",
 		"./test/utils": "./out/test/utils.js"
 	},
+	"bin": "./out/node/cli/index.js",
 	"files": [
 		"out/index.d.ts",
 		"out/index.d.ts.map",
 		"out/index.js.map",
 		"out/index.js",
-		"out/lib/**/*"
+		"out/lib/**/*",
+		"out/node/**/*",
+		"out/cli/**/*"
 	],
 	"scripts": {
 		"demo": "node out/examples/simple-iteration.js",
@@ -54,13 +57,15 @@
 	},
 	"prettier": "@sister.software/prettier-config",
 	"dependencies": {
-		"change-case": "^5.4.4"
+		"change-case": "^5.4.4",
+		"yargs": "^17.2.1"
 	},
 	"devDependencies": {
 		"@sister.software/eslint-config": "7.1.3",
 		"@sister.software/prettier-config": "7.1.3",
 		"@sister.software/tsconfig": "7.1.3",
 		"@types/node": "^22.10.2",
+		"@types/yargs": "^17.0.33",
 		"colorette": "^2.0.20",
 		"eslint": "^9.13.0",
 		"eslint-config-prettier": "^9.1.0",

package/out/lib/DelimitedChunkReader.d.ts

@@ -1,67 +0,0 @@
-/**
- * @copyright Sister Software
- * @license AGPL-3.0
- * @author Teffen Ellis, et al.
- */
-import { CharacterSequenceInput } from "./CharacterSequence.js";
-import { AsyncDataResource, ByteRange } from "./shared.js";
-/**
- * Options for the delimited chunk reader.
- */
-export interface DeliminatedChunkReaderInit {
-    /**
-     * The desired number of chunks. This is a target, not a guarantee.
-     *
-     * This will never be less than 1, nor greater than the number of delimiters in the file, nor
-     * greater than the byte length of the file.
-     */
-    chunks?: number;
-    /**
-     * The character to delimit by. Typically a newline or comma.
-     */
-    delimiter?: CharacterSequenceInput;
-    /**
-     * Whether to close the file handle after reading.
-     */
-    autoClose?: boolean;
-    /**
-     * The limit of bytes to read from the file.
-     */
-    limit?: number;
-}
-/**
- * Given a file handle containing delimited data and a desired slice count, returns an array of
- * slices of the buffer between delimiters.
- *
- * This is an advanced function so an analogy is provided:
- *
- * Suppose you had to manually search through a very large book page by page to find where each
- * chapter begins and ends. For a book with 1,000,000 pages, a single person would take a long time
- * to go through it all.
- *
- * You could add more people to the task by laying out all the pages, measuring the length and
- * assigning each person a length of pages to traverse.
- *
- * There's a few ways to go about this:
- *
- * We could approach this in serial -- having the first worker start from page 1 and scanning until
- * they find the beginning of the next chapter, handing off the range to the next worker. This is
- * how `AsyncSlidingWindow` approaches the problem.
- *
- * However this is inefficient because no matter how many workers we have, they must wait for the
- * previous worker to finish before they can start. Ideally, a desired number of workers would be
- * able to scan their own _length_ of pages simultaneously, and settle up on the boundaries of the
- * chapters they find.
- *
- * `DeliminatedChunkReader` is like the second approach. Given a desired number of chunks
- *
- * @returns A contiguous array of slices of the buffer separated by a delimiter.
- */
-export declare class DelimitedChunkReader {
-    static fromAsync(
-    /**
-     * The buffer containing newline-delimited data.
-     */
-    source: AsyncDataResource, init?: DeliminatedChunkReaderInit): Promise<ByteRange[]>;
-}
-//# sourceMappingURL=DelimitedChunkReader.d.ts.map

package/out/lib/DelimitedChunkReader.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"DelimitedChunkReader.d.ts","sourceRoot":"","sources":["../../lib/DelimitedChunkReader.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAqB,sBAAsB,EAAE,MAAM,wBAAwB,CAAA;AAClF,OAAO,EAAE,iBAAiB,EAAE,SAAS,EAAwC,MAAM,aAAa,CAAA;AAGhG;;GAEG;AACH,MAAM,WAAW,0BAA0B;IAC1C;;;;;OAKG;IACH,MAAM,CAAC,EAAE,MAAM,CAAA;IAEf;;OAEG;IACH,SAAS,CAAC,EAAE,sBAAsB,CAAA;IAElC;;OAEG;IACH,SAAS,CAAC,EAAE,OAAO,CAAA;IAEnB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;CACd;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,qBAAa,oBAAoB;WACnB,SAAS;IACrB;;OAEG;IACH,MAAM,EAAE,iBAAiB,EACzB,IAAI,GAAE,0BAA+B,GACnC,OAAO,CAAC,SAAS,EAAE,CAAC;CAyFvB"}

package/out/lib/DelimitedChunkReader.js

@@ -1,113 +0,0 @@
-/**
- * @copyright Sister Software
- * @license AGPL-3.0
- * @author Teffen Ellis, et al.
- */
-import { CharacterSequence } from "./CharacterSequence.js";
-import { isFileResourceLike } from "./shared.js";
-import { AsyncSlidingWindow } from "./SlidingWindow.js";
-/**
- * Given a file handle containing delimited data and a desired slice count, returns an array of
- * slices of the buffer between delimiters.
- *
- * This is an advanced function so an analogy is provided:
- *
- * Suppose you had to manually search through a very large book page by page to find where each
- * chapter begins and ends. For a book with 1,000,000 pages, a single person would take a long time
- * to go through it all.
- *
- * You could add more people to the task by laying out all the pages, measuring the length and
- * assigning each person a length of pages to traverse.
- *
- * There's a few ways to go about this:
- *
- * We could approach this in serial -- having the first worker start from page 1 and scanning until
- * they find the beginning of the next chapter, handing off the range to the next worker. This is
- * how `AsyncSlidingWindow` approaches the problem.
- *
- * However this is inefficient because no matter how many workers we have, they must wait for the
- * previous worker to finish before they can start. Ideally, a desired number of workers would be
- * able to scan their own _length_ of pages simultaneously, and settle up on the boundaries of the
- * chapters they find.
- *
- * `DeliminatedChunkReader` is like the second approach. Given a desired number of chunks
- *
- * @returns A contiguous array of slices of the buffer separated by a delimiter.
- */
-export class DelimitedChunkReader {
-    static async fromAsync(
-    /**
-     * The buffer containing newline-delimited data.
-     */
-    source, init = {}) {
-        let file;
-        if (isFileResourceLike(source)) {
-            file = source;
-        }
-        else {
-            const { NodeFileResource } = await import("spliterator/node/fs");
-            file = await NodeFileResource.open(source);
-        }
-        const byteLimit = init.limit ?? file.size;
-        // const byteLimit = init.limit ?? (await fileHandle.stat()).size
-        const delimiter = new CharacterSequence(init.delimiter);
-        const delimiterLength = delimiter.length;
-        const desiredSlices = Math.min(Math.max(1, init.chunks ?? 2), byteLimit / delimiterLength, byteLimit);
-        const fallback = [[0, byteLimit]];
-        if (desiredSlices === 1) {
-            return fallback;
-        }
-        const ranges = [];
-        const chunkSize = Math.floor(byteLimit / desiredSlices);
-        for (let i = 0; i < desiredSlices; i++) {
-            const previousSlice = ranges[i - 1] ?? [0, 0];
-            const chunkEnd = Math.min(i * chunkSize, byteLimit);
-            const searchStart = Math.max(chunkEnd - delimiterLength * 2, previousSlice[1]);
-            const searchEnd = Math.min(chunkEnd + delimiterLength * 2, byteLimit);
-            const reverse = new AsyncSlidingWindow(file, {
-                delimiter,
-                position: searchStart,
-                byteLength: searchEnd,
-            });
-            const forward = new AsyncSlidingWindow(file, {
-                delimiter,
-                position: searchStart,
-                byteLength: searchEnd,
-            });
-            const [previousRange, nextRange] = await Promise.all([
-                // We look backward to find the previous delimiter at a midpoint in the chunk...
-                reverse.previous(),
-                // And forward to find the next delimiter.
-                forward.next(),
-            ]);
-            if (i === 0) {
-                // The first slice is always from the beginning of the file to the first delimiter.
-                ranges.push(nextRange.value);
-                continue;
-            }
-            if (previousRange.done || nextRange.done)
-                break;
-            if (i === desiredSlices - 1) {
-                const range = [previousRange.value[0] + delimiterLength, byteLimit];
-                // We need to fix the previous slice to end at the previous delimiter.
-                previousSlice[1] = previousRange.value[0] - delimiterLength;
-                // The last slice is always from the last delimiter to the end of the file.
-                ranges.push(range);
-                break;
-            }
-            // We need to fix the previous slice to end at the previous delimiter.
-            previousSlice[1] = previousRange.value[0] - delimiterLength;
-            // And we need to fix the current slice to start at the previous delimiter.
-            nextRange.value[0] = previousRange.value[0] + delimiterLength;
-            // We can now add the current slice to the list.
-            ranges.push(nextRange.value);
-        }
-        if (!ranges.length)
-            return fallback;
-        if (init.autoClose) {
-            await file[Symbol.asyncDispose]?.();
-        }
-        return ranges;
-    }
-}
-//# sourceMappingURL=DelimitedChunkReader.js.map

package/out/lib/DelimitedChunkReader.js.map

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

package/out/lib/DelimiterTransformer.d.ts

@@ -1,27 +0,0 @@
-/**
- * @copyright Sister Software
- * @license AGPL-3.0
- * @author Teffen Ellis, et al.
- */
-import { CharacterSequenceInput } from "./CharacterSequence.js";
-import { TypedArray } from "./shared.js";
-/**
- * Options for the `DelimiterTransformer` class.
- */
-export interface DelimiterTransformerOptions {
-    /**
-     * The delimiter to use when splitting fields.
-     *
-     * @default `Delimiter.Comma`
-     */
-    delimiter?: CharacterSequenceInput;
-}
-/**
- * A transform stream that splits incoming text into fields using a delimiter.
- *
- * This is useful for parsing CSV files, for example.
- */
-export declare class DelimiterTransformer<T extends TypedArray = TypedArray> extends TransformStream<T, T[]> {
-    constructor(options?: DelimiterTransformerOptions);
-}
-//# sourceMappingURL=DelimiterTransformer.d.ts.map

package/out/lib/DelimiterTransformer.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"DelimiterTransformer.d.ts","sourceRoot":"","sources":["../../lib/DelimiterTransformer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAqB,sBAAsB,EAA6B,MAAM,wBAAwB,CAAA;AAC7G,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAExC;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC3C;;;;OAIG;IACH,SAAS,CAAC,EAAE,sBAAsB,CAAA;CAClC;AAED;;;;GAIG;AACH,qBAAa,oBAAoB,CAAC,CAAC,SAAS,UAAU,GAAG,UAAU,CAAE,SAAQ,eAAe,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;gBACvF,OAAO,GAAE,2BAAgC;CAerD"}

package/out/lib/DelimiterTransformer.js

@@ -1,26 +0,0 @@
-/**
- * @copyright Sister Software
- * @license AGPL-3.0
- * @author Teffen Ellis, et al.
- */
-import { CharacterSequence, Delimiters, takeDelimited } from "./CharacterSequence.js";
-/**
- * A transform stream that splits incoming text into fields using a delimiter.
- *
- * This is useful for parsing CSV files, for example.
- */
-export class DelimiterTransformer extends TransformStream {
-    constructor(options = {}) {
-        const delimiter = new CharacterSequence(options.delimiter ?? Delimiters.Comma);
-        super({
-            transform: (line, controller) => {
-                if (line.length === 0) {
-                    return;
-                }
-                const columns = Array.from(takeDelimited(line, delimiter));
-                controller.enqueue(columns);
-            },
-        });
-    }
-}
-//# sourceMappingURL=DelimiterTransformer.js.map

package/out/lib/DelimiterTransformer.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"DelimiterTransformer.js","sourceRoot":"","sources":["../../lib/DelimiterTransformer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,iBAAiB,EAA0B,UAAU,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAA;AAe7G;;;;GAIG;AACH,MAAM,OAAO,oBAAwD,SAAQ,eAAuB;IACnG,YAAY,UAAuC,EAAE;QACpD,MAAM,SAAS,GAAG,IAAI,iBAAiB,CAAC,OAAO,CAAC,SAAS,IAAI,UAAU,CAAC,KAAK,CAAC,CAAA;QAE9E,KAAK,CAAC;YACL,SAAS,EAAE,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE;gBAC/B,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBACvB,OAAM;gBACP,CAAC;gBAED,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,CAAA;gBAE1D,UAAU,CAAC,OAAO,CAAC,OAAyB,CAAC,CAAA;YAC9C,CAAC;SACD,CAAC,CAAA;IACH,CAAC;CACD"}

package/out/lib/node/fs.d.ts

@@ -1,98 +0,0 @@
-/**
- * @copyright Sister Software
- * @license AGPL-3.0
- * @author Teffen Ellis, et al.
- */
-import { type PathLike } from "node:fs";
-import { TypedArray } from "type-fest";
-import { ByteRangeReader, ReadBytesOptions, StatsLike, TypedArrayFallback, type FileHandleLike, type FileResourceLike } from "../shared.js";
-export interface NodeFileResourceInit {
-    name?: string;
-    type?: string;
-    position?: number;
-    byteLength?: number;
-    lastModified?: number;
-    blockSize?: number;
-}
-/**
- * An isomorphic file resource which can be read from and disposed.
- */
-export declare class NodeFileResource implements FileResourceLike, ByteRangeReader, AsyncDisposable {
-    #private;
-    /**
-     * The last modified timestamp of the file.
-     */
-    readonly lastModified: number;
-    /**
-     * The name of the file.
-     */
-    readonly name: string;
-    /**
-     * @deprecated This property is not supported in Node.js.
-     */
-    readonly webkitRelativePath = "";
-    readonly blockSize?: number;
-    /**
-     * The byte length of the file.
-     */
-    readonly size: number;
-    /**
-     * The byte length of the file.
-     *
-     * Alias for {@linkcode #byteLength}.
-     */
-    get byteLength(): number;
-    readonly type: string;
-    constructor(handle: FileHandleLike, init: NodeFileResourceInit);
-    /**
-     * Read a range of bytes from the file.
-     *
-     * @param options - The options for reading the byte range.
-     */
-    read<B extends TypedArray>(options?: ReadBytesOptions & {
-        buffer?: B;
-    }): Promise<TypedArrayFallback<B>>;
-    /**
-     * Read the entire file as a byte array.
-     *
-     * @see {@linkcode slice} to create a sliced view of the file.
-     * @see {@linkcode arrayBuffer} to read the file as an array buffer.
-     */
-    bytes(): Promise<Uint8Array>;
-    /**
-     * Read the entire file as an array buffer.
-     *
-     * @see {@linkcode slice} to create a sliced view of the file.
-     * @see {@linkcode bytes} to read the file as a byte array.
-     */
-    arrayBuffer(): Promise<ArrayBuffer>;
-    /**
-     * Slice the file into a new file resource.
-     *
-     * Note that the slice is a view of the original file, thus we're really just creating a new file
-     * resource with a different byte range.
-     *
-     * @param start - The starting byte offset.
-     * @param end - The ending byte offset.
-     * @param contentType - The content type of the slice.
-     *
-     * @returns A new file resource representing the sliced view of the file.
-     */
-    slice(start?: number, end?: number, contentType?: string): NodeFileResource;
-    /**
-     * Read the entire file as a string.
-     */
-    text(): Promise<string>;
-    /**
-     * Create a readable stream of the file.
-     */
-    stream(): ReadableStream<Uint8Array>;
-    [Symbol.asyncDispose](): Promise<void>;
-    dispose(): Promise<void>;
-    /**
-     * Create a new file resource from a file handle or path.
-     */
-    static open(input: FileHandleLike | PathLike, stats?: StatsLike, init?: NodeFileResourceInit): Promise<NodeFileResource>;
-}
-export default NodeFileResource;
-//# sourceMappingURL=fs.d.ts.map

package/out/lib/node/fs.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"fs.d.ts","sourceRoot":"","sources":["../../../lib/node/fs.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAA0B,KAAK,QAAQ,EAAE,MAAM,SAAS,CAAA;AAG/D,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AACtC,OAAO,EACN,eAAe,EAEf,gBAAgB,EAChB,SAAS,EACT,kBAAkB,EAClB,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,MAAM,cAAc,CAAA;AAErB,MAAM,WAAW,oBAAoB;IACpC,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,SAAS,CAAC,EAAE,MAAM,CAAA;CAClB;AAED;;GAEG;AACH,qBAAa,gBAAiB,YAAW,gBAAgB,EAAE,eAAe,EAAE,eAAe;;IAG1F;;OAEG;IACH,SAAgB,YAAY,EAAE,MAAM,CAAA;IACpC;;OAEG;IACH,SAAgB,IAAI,EAAE,MAAM,CAAA;IAC5B;;OAEG;IACH,SAAgB,kBAAkB,MAAK;IAEvC,SAAgB,SAAS,CAAC,EAAE,MAAM,CAAA;IAElC;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IAErB;;;;OAIG;IACH,IAAW,UAAU,IAAI,MAAM,CAE9B;IAMD,SAAgB,IAAI,EAAE,MAAM,CAAA;gBAEhB,MAAM,EAAE,cAAc,EAAE,IAAI,EAAE,oBAAoB;IAW9D;;;;OAIG;IACG,IAAI,CAAC,CAAC,SAAS,UAAU,EAAE,OAAO,GAAE,gBAAgB,GAAG;QAAE,MAAM,CAAC,EAAE,CAAC,CAAA;KAAO,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC;IAwBjH;;;;;OAKG;IACU,KAAK,IAAI,OAAO,CAAC,UAAU,CAAC;IAIzC;;;;;OAKG;IACI,WAAW,IAAI,OAAO,CAAC,WAAW,CAAC;IAI1C;;;;;;;;;;;OAWG;IACI,KAAK,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,gBAAgB;IAelF;;OAEG;IACU,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC;IAOpC;;OAEG;IACI,MAAM,IAAI,cAAc,CAAC,UAAU,CAAC;IAI9B,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5C,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAI/B;;OAEG;WACU,IAAI,CAChB,KAAK,EAAE,cAAc,GAAG,QAAQ,EAChC,KAAK,CAAC,EAAE,SAAS,EACjB,IAAI,GAAE,oBAAyB,GAC7B,OAAO,CAAC,gBAAgB,CAAC;CAqB5B;AAED,eAAe,gBAAgB,CAAA"}

package/out/lib/node/fs.js

@@ -1,162 +0,0 @@
-/**
- * @copyright Sister Software
- * @license AGPL-3.0
- * @author Teffen Ellis, et al.
- */
-import { read } from "node:fs";
-import { open } from "node:fs/promises";
-import * as path from "node:path";
-import { isFileHandleLike, } from "../shared.js";
-/**
- * An isomorphic file resource which can be read from and disposed.
- */
-export class NodeFileResource {
-    #handle;
-    /**
-     * The last modified timestamp of the file.
-     */
-    lastModified;
-    /**
-     * The name of the file.
-     */
-    name;
-    /**
-     * @deprecated This property is not supported in Node.js.
-     */
-    webkitRelativePath = "";
-    blockSize;
-    /**
-     * The byte length of the file.
-     */
-    size;
-    /**
-     * The byte length of the file.
-     *
-     * Alias for {@linkcode #byteLength}.
-     */
-    get byteLength() {
-        return this.size;
-    }
-    /**
-     * The byte position of the file.
-     */
-    #position;
-    type;
-    constructor(handle, init) {
-        this.#handle = handle;
-        this.lastModified = init.lastModified ?? Date.now();
-        this.name = init.name ?? "";
-        this.#position = init.position ?? 0;
-        this.size = (init.byteLength ?? 0) - this.#position;
-        this.blockSize = init.blockSize;
-        this.type = init.type ?? "";
-    }
-    /**
-     * Read a range of bytes from the file.
-     *
-     * @param options - The options for reading the byte range.
-     */
-    async read(options = {}) {
-        const byteLength = options.length ?? this.size;
-        const offset = options.offset ?? 0;
-        const buffer = (options.buffer ?? new Uint8Array(byteLength));
-        const position = options.position ?? this.#position;
-        await new Promise((resolve, reject) => read(this.#handle.fd, {
-            buffer,
-            offset,
-            position,
-        }, (error) => {
-            if (error)
-                reject(error);
-            else
-                resolve();
-        }));
-        return buffer;
-    }
-    /**
-     * Read the entire file as a byte array.
-     *
-     * @see {@linkcode slice} to create a sliced view of the file.
-     * @see {@linkcode arrayBuffer} to read the file as an array buffer.
-     */
-    async bytes() {
-        return this.read();
-    }
-    /**
-     * Read the entire file as an array buffer.
-     *
-     * @see {@linkcode slice} to create a sliced view of the file.
-     * @see {@linkcode bytes} to read the file as a byte array.
-     */
-    arrayBuffer() {
-        return this.bytes().then((bytes) => bytes.buffer);
-    }
-    /**
-     * Slice the file into a new file resource.
-     *
-     * Note that the slice is a view of the original file, thus we're really just creating a new file
-     * resource with a different byte range.
-     *
-     * @param start - The starting byte offset.
-     * @param end - The ending byte offset.
-     * @param contentType - The content type of the slice.
-     *
-     * @returns A new file resource representing the sliced view of the file.
-     */
-    slice(start, end, contentType) {
-        start = start ?? 0;
-        end = end ?? this.size;
-        const byteLength = Math.max(0, end - start);
-        return new NodeFileResource(this.#handle, {
-            name: this.name,
-            type: contentType ?? this.type,
-            position: this.#position + start,
-            byteLength,
-            lastModified: this.lastModified,
-        });
-    }
-    /**
-     * Read the entire file as a string.
-     */
-    async text() {
-        const buffer = await this.bytes();
-        const decoder = new TextDecoder();
-        return decoder.decode(buffer);
-    }
-    /**
-     * Create a readable stream of the file.
-     */
-    stream() {
-        return this.#handle.readableWebStream();
-    }
-    async [Symbol.asyncDispose]() {
-        return this.#handle.close();
-    }
-    dispose() {
-        return this.#handle.close();
-    }
-    /**
-     * Create a new file resource from a file handle or path.
-     */
-    static async open(input, stats, init = {}) {
-        let handle;
-        let name = "";
-        if (isFileHandleLike(input)) {
-            handle = input;
-        }
-        else {
-            handle = await open(input, "r");
-            name = (init.name ?? typeof init.name === "string") ? init.name : path.basename(input.toString());
-        }
-        stats = stats ?? (await handle.stat());
-        return new NodeFileResource(handle, {
-            lastModified: stats.mtimeMs,
-            byteLength: stats.size,
-            ...init,
-            name,
-            blockSize: stats.blksize,
-        });
-    }
-}
-export default NodeFileResource;
-//# sourceMappingURL=fs.js.map

package/out/lib/node/fs.js.map

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