readline-pager 0.6.5 → 0.7.2

package/README.md

@@ -12,7 +12,7 @@
   <img src="https://img.shields.io/github/stars/devmor-j/readline-pager" alt="stars">
 </p>
 
-⚡ High-performance paginated file reader for Node.js. Efficiently process large text files without loading them into memory.
+⚡ High-performance paginated file reader for Node.js. Process large text files efficiently without loading them into memory.
 
 - 📦 Zero dependencies
 - ⚡ Up to ~3× faster than Node.js `readline`
@@ -20,7 +20,7 @@
 - 🔁 Async (`for await...of`) and sync (`for...of`) iteration
 - 📄 Page-based reading with manual control (`next`, `nextSync`)
 - 🔀 Forward and backward reading support
-- 🧪 Fully typed with high test coverage (>90%)
+- 🧪 Fully typed with over 90% test coverage
 
 > **Important:**  
 > Performance depends heavily on the `chunkSize` option. Tune it for your storage device. A value of **64 KiB** is usually a good starting point. Increasing it may improve throughput until you reach the best value for your hardware.
@@ -69,7 +69,7 @@ const pager = createPager("./bigfile.txt");
 while ((page = pager.nextSync()) !== null) {}
 
 // Native C++
-for await (const page of createNativePager("./bigfile.txt")) {
+for (const page of createNativePager("./bigfile.txt")) {
 }
 ```
 
@@ -79,38 +79,37 @@ for await (const page of createNativePager("./bigfile.txt")) {
 
 ```ts
 createPager(filepath, {
-  chunkSize?: number,   // default: 64 * 1024 (64 KiB)
-  pageSize?: number,    // default: 1_000
-  delimiter?: string,   // default: "\n"
-  prefetch?: number,    // default: 8
-  backward?: boolean,   // default: false
-  useWorker?: boolean,  // default: false
-  tryNative?: boolean,  // default: true
+  chunkSize?: number,           // default: 64 * 1024 (64 KiB)
+  pageSize?: number,            // default: 1_000
+  delimiter?: string,           // default: "\n"
+  prefetch?: number,            // default: 8
+  backward?: boolean,           // default: false
+  output?: "string" | "buffer", // default: "string"
 });
 
 createNativePager(filepath, {
-  pageSize?: number,    // default: 1_000
-  delimiter?: string,   // default: "\n"
-  backward?: boolean,   // default: false
+  pageSize?: number,            // default: 1_000
+  delimiter?: string,           // default: "\n"
+  backward?: boolean,           // default: false
+  output?: "string" | "buffer", // default: "string"
 });
 ```
 
-- `chunkSize` — number of bytes read per I/O operation.
-- `pageSize` — number of lines per page.
-- `delimiter` — line separator.
-- `prefetch` — maximum number of pages buffered internally.
-- `backward` — read the file from end to start.
-- `useWorker` — offload reading to a worker thread (forward reading only).
-- `tryNative` — attempts to use the native reader, falls back to the non-native version if it fails.
+- `chunkSize` — Number of bytes read per I/O operation.
+- `pageSize` — Number of lines per page.
+- `delimiter` — Line separator.
+- `prefetch` — Maximum number of pages buffered internally.
+- `backward` — Read the file from end to start.
+- `output` — Controls the page data type.
 
 > **Note:**
-> `createNativePager` requires x86 AVX2 or ARM NEON CPU instruction set extensions and will throw if they are not available. It also does **not** support multi-character delimiters due to fast SIMD-based scanning.
+> `createNativePager` requires x86 AVX2 or ARM NEON CPU instruction set extensions and will throw if they are not available. It also does **not** support multi-character delimiters because it uses fast SIMD-based scanning.
 
 ---
 
 ## 📚 API
 
-### `pager.next(): Promise<string[] | null>`
+### `pager.next(): Promise<string[] | Buffer | null>`
 
 Returns the next page asynchronously.
 
@@ -124,7 +123,7 @@ Empty lines are preserved.
 > - A completely empty file (`0` bytes) produces `[""]` on the first read.
 > - A file containing multiple empty lines returns each line as an empty string.
 
-### `pager.nextSync(): string[] | null`
+### `pager.nextSync(): string[] | Buffer | null`
 
 Synchronous version of `pager.next()`.
 

package/dist/main.cjs

@@ -5,7 +5,6 @@ Object.defineProperties(exports, {
 const require_native = require("./native.cjs");
 let node_fs = require("node:fs");
 let node_fs_promises = require("node:fs/promises");
-let node_worker_threads = require("node:worker_threads");
 //#region src/helper.ts
 function createRingBuffer(capacity) {
 	if (!Number.isFinite(capacity) || capacity <= 0) throw new RangeError("capacity must be a positive number");
@@ -93,8 +92,10 @@ function createRingBuffer(capacity) {
 //#endregion
 //#region src/reader/backward.reader.ts
 function createBackwardReader(filepath, options) {
-	const { chunkSize, pageSize, delimiter, prefetch } = options;
+	const { chunkSize, pageSize, delimiter, prefetch, output } = options;
 	const pageQueue = createRingBuffer(Math.max(2, prefetch + 1));
+	const isBufferOutput = output === "buffer";
+	const emptyPage = isBufferOutput ? Buffer.allocUnsafe(0) : [""];
 	const local = [];
 	let fd = null;
 	let fdSync = null;
@@ -116,13 +117,15 @@ function createBackwardReader(filepath, options) {
 	function flushTail() {
 		if (flushed) return;
 		flushed = true;
-		if (buffer.length > 0) local.push(buffer);
-		else if (startsWithDelimiter) local.push("");
-		buffer = "";
-		while (local.length > 0) {
-			const page = local.slice(local.length - Math.min(pageSize, local.length));
-			local.length -= page.length;
-			pageQueue.push(page);
+		if (!isBufferOutput) {
+			if (buffer.length > 0) local.push(buffer);
+			else if (startsWithDelimiter) local.push("");
+			buffer = "";
+			while (local.length > 0) {
+				const page = local.slice(local.length - Math.min(pageSize, local.length));
+				local.length -= page.length;
+				pageQueue.push(page);
+			}
 		}
 		done = true;
 		pageQueue.wake();
@@ -130,7 +133,7 @@ function createBackwardReader(filepath, options) {
 	fdSync = (0, node_fs.openSync)(filepath, "r");
 	pos = (0, node_fs.statSync)(filepath).size;
 	if (pos === 0) {
-		pageQueue.push([""]);
+		pageQueue.push(emptyPage);
 		done = true;
 		flushed = true;
 		pageQueue.wake();
@@ -140,7 +143,7 @@ function createBackwardReader(filepath, options) {
 		pos = (await fd.stat()).size;
 		if (pos === 0) {
 			if (!done) {
-				pageQueue.push([""]);
+				pageQueue.push(emptyPage);
 				done = true;
 				flushed = true;
 			}
@@ -159,9 +162,12 @@ function createBackwardReader(filepath, options) {
 				pos -= readSize;
 				const buf = Buffer.allocUnsafe(readSize);
 				const { bytesRead } = await fd.read(buf, 0, readSize, pos);
-				buffer = buf.toString("utf8", 0, bytesRead) + buffer;
-				if (pos === 0 && buffer.startsWith(delimiter)) startsWithDelimiter = true;
-				consumeBuffer();
+				if (isBufferOutput) pageQueue.push(buf.subarray(0, bytesRead));
+				else {
+					buffer = buf.toString("utf8", 0, bytesRead) + buffer;
+					if (pos === 0 && buffer.startsWith(delimiter)) startsWithDelimiter = true;
+					consumeBuffer();
+				}
 			}
 			if (pos === 0 && !flushed) {
 				flushTail();
@@ -183,9 +189,12 @@ function createBackwardReader(filepath, options) {
 			pos -= readSize;
 			const buf = Buffer.allocUnsafe(readSize);
 			const bytesRead = (0, node_fs.readSync)(fdSync, buf, 0, readSize, pos);
-			buffer = buf.toString("utf8", 0, bytesRead) + buffer;
-			if (pos === 0 && buffer.startsWith(delimiter)) startsWithDelimiter = true;
-			consumeBuffer();
+			if (isBufferOutput) pageQueue.push(buf.subarray(0, bytesRead));
+			else {
+				buffer = buf.toString("utf8", 0, bytesRead) + buffer;
+				if (pos === 0 && buffer.startsWith(delimiter)) startsWithDelimiter = true;
+				consumeBuffer();
+			}
 		}
 		if (pos === 0 && !flushed) {
 			flushTail();
@@ -269,8 +278,10 @@ function createBackwardReader(filepath, options) {
 //#endregion
 //#region src/reader/forward.reader.ts
 function createForwardReader(filepath, options) {
-	const { chunkSize, pageSize, delimiter, prefetch } = options;
+	const { chunkSize, pageSize, delimiter, prefetch, output } = options;
 	const pageQueue = createRingBuffer(Math.max(2, prefetch + 1));
+	const isBufferOutput = output === "buffer";
+	const emptyPage = isBufferOutput ? Buffer.allocUnsafe(0) : [""];
 	const local = [];
 	let fd = null;
 	let fdSync = null;
@@ -292,16 +303,18 @@ function createForwardReader(filepath, options) {
 	function flushTail() {
 		if (flushed) return;
 		flushed = true;
-		local.push(buffer.length > 0 ? buffer : "");
-		buffer = "";
-		while (local.length > 0) pageQueue.push(local.splice(0, pageSize));
+		if (!isBufferOutput) {
+			local.push(buffer.length > 0 ? buffer : "");
+			buffer = "";
+			while (local.length > 0) pageQueue.push(local.splice(0, pageSize));
+		}
 		done = true;
 		pageQueue.wake();
 	}
 	fdSync = (0, node_fs.openSync)(filepath, "r");
 	size = (0, node_fs.statSync)(filepath).size;
 	if (size === 0) {
-		pageQueue.push([""]);
+		pageQueue.push(emptyPage);
 		done = true;
 		flushed = true;
 		pageQueue.wake();
@@ -311,7 +324,7 @@ function createForwardReader(filepath, options) {
 		size = (await fd.stat()).size;
 		if (size === 0) {
 			if (!done) {
-				pageQueue.push([""]);
+				pageQueue.push(emptyPage);
 				done = true;
 				flushed = true;
 			}
@@ -330,8 +343,11 @@ function createForwardReader(filepath, options) {
 				const buf = Buffer.allocUnsafe(readSize);
 				const { bytesRead } = await fd.read(buf, 0, readSize, pos);
 				pos += bytesRead;
-				buffer = buffer + buf.toString("utf8", 0, bytesRead);
-				consumeBuffer();
+				if (isBufferOutput) pageQueue.push(buf.subarray(0, bytesRead));
+				else {
+					buffer = buffer + buf.toString("utf8", 0, bytesRead);
+					consumeBuffer();
+				}
 			}
 			if (pos >= size && !flushed) {
 				flushTail();
@@ -353,8 +369,11 @@ function createForwardReader(filepath, options) {
 			const buf = Buffer.allocUnsafe(readSize);
 			const bytesRead = (0, node_fs.readSync)(fdSync, buf, 0, readSize, pos);
 			pos += bytesRead;
-			buffer = buffer + buf.toString("utf8", 0, bytesRead);
-			consumeBuffer();
+			if (isBufferOutput) pageQueue.push(buf.subarray(0, bytesRead));
+			else {
+				buffer = buffer + buf.toString("utf8", 0, bytesRead);
+				consumeBuffer();
+			}
 		}
 		if (pos >= size && !flushed) {
 			flushTail();
@@ -436,117 +455,20 @@ function createForwardReader(filepath, options) {
 	};
 }
 //#endregion
-//#region src/reader/worker.reader.ts
-const workerFile = new URL("./worker.mjs", require("url").pathToFileURL(__filename).href);
-function createWorkerReader(filepath, options) {
-	const { prefetch } = options;
-	let done = false;
-	let closed = false;
-	const pageQueue = createRingBuffer(Math.max(2, prefetch + 1));
-	const worker = new node_worker_threads.Worker(new URL(workerFile, require("url").pathToFileURL(__filename).href), { workerData: {
-		filepath,
-		options
-	} });
-	worker.on("message", (msg) => {
-		switch (msg.type) {
-			case "page":
-				pageQueue.push(msg.data);
-				break;
-			case "done":
-			case "error":
-				done = true;
-				pageQueue.wake();
-				break;
-		}
-	});
-	worker.on("error", () => {
-		done = true;
-		pageQueue.wake();
-	});
-	worker.on("exit", () => {
-		done = true;
-		pageQueue.wake();
-	});
-	async function next() {
-		if (closed) return null;
-		return pageQueue.shift(done);
-	}
-	function nextSync() {
-		if (closed) return null;
-		return pageQueue.shiftSync();
-	}
-	async function close() {
-		if (closed) return;
-		closed = true;
-		done = true;
-		pageQueue.clear();
-		try {
-			await worker.terminate();
-		} catch {}
-	}
-	function tryClose() {
-		close().catch(() => {});
-	}
-	return {
-		next,
-		nextSync,
-		close,
-		async *[Symbol.asyncIterator]() {
-			try {
-				while (true) {
-					const p = await next();
-					if (!p) break;
-					yield p;
-				}
-			} finally {
-				tryClose();
-			}
-		},
-		*[Symbol.iterator]() {
-			try {
-				while (true) {
-					const p = nextSync();
-					if (!p) break;
-					yield p;
-				}
-			} finally {
-				tryClose();
-			}
-		}
-	};
-}
-//#endregion
 //#region src/main.ts
 function createPager(filepath, options = {}) {
-	const { chunkSize = 64 * 1024, pageSize = 1e3, delimiter = "\n", prefetch = 8, backward = false, useWorker = false, tryNative = true } = options;
+	const { chunkSize = 64 * 1024, pageSize = 1e3, delimiter = "\n", prefetch = 8, backward = false, output = "string" } = options;
 	if (!filepath) throw new Error("filepath required");
 	if (pageSize < 1) throw new RangeError("pageSize must be >= 1");
 	if (prefetch < 1) throw new RangeError("prefetch must be >= 1");
-	if (useWorker) {
-		if (backward) throw new Error("backward not supported with useWorker");
-		if (tryNative) throw new Error("tryNative not supported with useWorker");
-	}
-	if (tryNative) {
-		if (delimiter.length !== 1) throw new RangeError("native reader only supports single-character delimiters");
-	}
 	const readerOptions = {
 		chunkSize,
 		pageSize,
 		prefetch,
-		delimiter
+		delimiter,
+		output
 	};
-	let nativeReader;
-	if (tryNative) {
-		const nativeOptions = {
-			pageSize,
-			delimiter,
-			backward
-		};
-		try {
-			nativeReader = require_native.createNativePager(filepath, nativeOptions);
-		} catch {}
-	}
-	const reader = tryNative && nativeReader ? nativeReader : useWorker ? createWorkerReader(filepath, readerOptions) : backward ? createBackwardReader(filepath, readerOptions) : createForwardReader(filepath, readerOptions);
+	const reader = backward ? createBackwardReader(filepath, readerOptions) : createForwardReader(filepath, readerOptions);
 	if (process.env.PAGER_TEST_CLEANUPS) {
 		globalThis.__pager_test_cleanups__ ??= [];
 		globalThis.__pager_test_cleanups__.push(reader.close);

package/dist/main.d.cts

@@ -1,6 +1,9 @@
-import { a as PagerOptions, i as Pager, n as NativeAddon, o as ReaderOptions, r as NativeReaderOptions, s as WorkerMessage, t as createNativePager } from "./native-_NmVYcF6.cjs";
+import { a as Output, c as PagerOptions, i as NativeReaderOptions, l as ReaderOptions, n as AsyncFunction, o as PageOutput, r as NativeAddon, s as Pager, t as createNativePager, u as ResolvePageOutput } from "./native-7x1Vhdaw.cjs";
 
 //#region src/main.d.ts
-declare function createPager(filepath: string, options?: PagerOptions): Pager;
+declare function createPager<T extends Output>(filepath: string, options: PagerOptions & {
+  output: T;
+}): Pager<T>;
+declare function createPager(filepath: string, options?: PagerOptions): Pager<"string">;
 //#endregion
-export { NativeAddon, NativeReaderOptions, Pager, PagerOptions, ReaderOptions, WorkerMessage, createNativePager, createPager, createPager as default };
+export { AsyncFunction, NativeAddon, NativeReaderOptions, Output, PageOutput, Pager, PagerOptions, ReaderOptions, ResolvePageOutput, createNativePager, createPager, createPager as default };

package/dist/main.d.mts

@@ -1,6 +1,9 @@
-import { a as PagerOptions, i as Pager, n as NativeAddon, o as ReaderOptions, r as NativeReaderOptions, s as WorkerMessage, t as createNativePager } from "./native-DGzYrMHK.mjs";
+import { a as Output, c as PagerOptions, i as NativeReaderOptions, l as ReaderOptions, n as AsyncFunction, o as PageOutput, r as NativeAddon, s as Pager, t as createNativePager, u as ResolvePageOutput } from "./native-D6SBIgoE.mjs";
 
 //#region src/main.d.ts
-declare function createPager(filepath: string, options?: PagerOptions): Pager;
+declare function createPager<T extends Output>(filepath: string, options: PagerOptions & {
+  output: T;
+}): Pager<T>;
+declare function createPager(filepath: string, options?: PagerOptions): Pager<"string">;
 //#endregion
-export { NativeAddon, NativeReaderOptions, Pager, PagerOptions, ReaderOptions, WorkerMessage, createNativePager, createPager, createPager as default };
+export { AsyncFunction, NativeAddon, NativeReaderOptions, Output, PageOutput, Pager, PagerOptions, ReaderOptions, ResolvePageOutput, createNativePager, createPager, createPager as default };

package/dist/main.mjs

@@ -1,11 +1,6 @@
 import { createNativePager } from "./native.mjs";
-import { createRequire } from "node:module";
 import { closeSync, openSync, readSync, statSync } from "node:fs";
 import { open } from "node:fs/promises";
-import { Worker } from "node:worker_threads";
-//#region \0rolldown/runtime.js
-var __require = /* @__PURE__ */ createRequire(import.meta.url);
-//#endregion
 //#region src/helper.ts
 function createRingBuffer(capacity) {
 	if (!Number.isFinite(capacity) || capacity <= 0) throw new RangeError("capacity must be a positive number");
@@ -93,8 +88,10 @@ function createRingBuffer(capacity) {
 //#endregion
 //#region src/reader/backward.reader.ts
 function createBackwardReader(filepath, options) {
-	const { chunkSize, pageSize, delimiter, prefetch } = options;
+	const { chunkSize, pageSize, delimiter, prefetch, output } = options;
 	const pageQueue = createRingBuffer(Math.max(2, prefetch + 1));
+	const isBufferOutput = output === "buffer";
+	const emptyPage = isBufferOutput ? Buffer.allocUnsafe(0) : [""];
 	const local = [];
 	let fd = null;
 	let fdSync = null;
@@ -116,13 +113,15 @@ function createBackwardReader(filepath, options) {
 	function flushTail() {
 		if (flushed) return;
 		flushed = true;
-		if (buffer.length > 0) local.push(buffer);
-		else if (startsWithDelimiter) local.push("");
-		buffer = "";
-		while (local.length > 0) {
-			const page = local.slice(local.length - Math.min(pageSize, local.length));
-			local.length -= page.length;
-			pageQueue.push(page);
+		if (!isBufferOutput) {
+			if (buffer.length > 0) local.push(buffer);
+			else if (startsWithDelimiter) local.push("");
+			buffer = "";
+			while (local.length > 0) {
+				const page = local.slice(local.length - Math.min(pageSize, local.length));
+				local.length -= page.length;
+				pageQueue.push(page);
+			}
 		}
 		done = true;
 		pageQueue.wake();
@@ -130,7 +129,7 @@ function createBackwardReader(filepath, options) {
 	fdSync = openSync(filepath, "r");
 	pos = statSync(filepath).size;
 	if (pos === 0) {
-		pageQueue.push([""]);
+		pageQueue.push(emptyPage);
 		done = true;
 		flushed = true;
 		pageQueue.wake();
@@ -140,7 +139,7 @@ function createBackwardReader(filepath, options) {
 		pos = (await fd.stat()).size;
 		if (pos === 0) {
 			if (!done) {
-				pageQueue.push([""]);
+				pageQueue.push(emptyPage);
 				done = true;
 				flushed = true;
 			}
@@ -159,9 +158,12 @@ function createBackwardReader(filepath, options) {
 				pos -= readSize;
 				const buf = Buffer.allocUnsafe(readSize);
 				const { bytesRead } = await fd.read(buf, 0, readSize, pos);
-				buffer = buf.toString("utf8", 0, bytesRead) + buffer;
-				if (pos === 0 && buffer.startsWith(delimiter)) startsWithDelimiter = true;
-				consumeBuffer();
+				if (isBufferOutput) pageQueue.push(buf.subarray(0, bytesRead));
+				else {
+					buffer = buf.toString("utf8", 0, bytesRead) + buffer;
+					if (pos === 0 && buffer.startsWith(delimiter)) startsWithDelimiter = true;
+					consumeBuffer();
+				}
 			}
 			if (pos === 0 && !flushed) {
 				flushTail();
@@ -183,9 +185,12 @@ function createBackwardReader(filepath, options) {
 			pos -= readSize;
 			const buf = Buffer.allocUnsafe(readSize);
 			const bytesRead = readSync(fdSync, buf, 0, readSize, pos);
-			buffer = buf.toString("utf8", 0, bytesRead) + buffer;
-			if (pos === 0 && buffer.startsWith(delimiter)) startsWithDelimiter = true;
-			consumeBuffer();
+			if (isBufferOutput) pageQueue.push(buf.subarray(0, bytesRead));
+			else {
+				buffer = buf.toString("utf8", 0, bytesRead) + buffer;
+				if (pos === 0 && buffer.startsWith(delimiter)) startsWithDelimiter = true;
+				consumeBuffer();
+			}
 		}
 		if (pos === 0 && !flushed) {
 			flushTail();
@@ -269,8 +274,10 @@ function createBackwardReader(filepath, options) {
 //#endregion
 //#region src/reader/forward.reader.ts
 function createForwardReader(filepath, options) {
-	const { chunkSize, pageSize, delimiter, prefetch } = options;
+	const { chunkSize, pageSize, delimiter, prefetch, output } = options;
 	const pageQueue = createRingBuffer(Math.max(2, prefetch + 1));
+	const isBufferOutput = output === "buffer";
+	const emptyPage = isBufferOutput ? Buffer.allocUnsafe(0) : [""];
 	const local = [];
 	let fd = null;
 	let fdSync = null;
@@ -292,16 +299,18 @@ function createForwardReader(filepath, options) {
 	function flushTail() {
 		if (flushed) return;
 		flushed = true;
-		local.push(buffer.length > 0 ? buffer : "");
-		buffer = "";
-		while (local.length > 0) pageQueue.push(local.splice(0, pageSize));
+		if (!isBufferOutput) {
+			local.push(buffer.length > 0 ? buffer : "");
+			buffer = "";
+			while (local.length > 0) pageQueue.push(local.splice(0, pageSize));
+		}
 		done = true;
 		pageQueue.wake();
 	}
 	fdSync = openSync(filepath, "r");
 	size = statSync(filepath).size;
 	if (size === 0) {
-		pageQueue.push([""]);
+		pageQueue.push(emptyPage);
 		done = true;
 		flushed = true;
 		pageQueue.wake();
@@ -311,7 +320,7 @@ function createForwardReader(filepath, options) {
 		size = (await fd.stat()).size;
 		if (size === 0) {
 			if (!done) {
-				pageQueue.push([""]);
+				pageQueue.push(emptyPage);
 				done = true;
 				flushed = true;
 			}
@@ -330,8 +339,11 @@ function createForwardReader(filepath, options) {
 				const buf = Buffer.allocUnsafe(readSize);
 				const { bytesRead } = await fd.read(buf, 0, readSize, pos);
 				pos += bytesRead;
-				buffer = buffer + buf.toString("utf8", 0, bytesRead);
-				consumeBuffer();
+				if (isBufferOutput) pageQueue.push(buf.subarray(0, bytesRead));
+				else {
+					buffer = buffer + buf.toString("utf8", 0, bytesRead);
+					consumeBuffer();
+				}
 			}
 			if (pos >= size && !flushed) {
 				flushTail();
@@ -353,8 +365,11 @@ function createForwardReader(filepath, options) {
 			const buf = Buffer.allocUnsafe(readSize);
 			const bytesRead = readSync(fdSync, buf, 0, readSize, pos);
 			pos += bytesRead;
-			buffer = buffer + buf.toString("utf8", 0, bytesRead);
-			consumeBuffer();
+			if (isBufferOutput) pageQueue.push(buf.subarray(0, bytesRead));
+			else {
+				buffer = buffer + buf.toString("utf8", 0, bytesRead);
+				consumeBuffer();
+			}
 		}
 		if (pos >= size && !flushed) {
 			flushTail();
@@ -436,117 +451,20 @@ function createForwardReader(filepath, options) {
 	};
 }
 //#endregion
-//#region src/reader/worker.reader.ts
-const workerFile = typeof import.meta !== "undefined" ? new URL("./worker.mjs", import.meta.url) : __require.resolve("./worker.cjs");
-function createWorkerReader(filepath, options) {
-	const { prefetch } = options;
-	let done = false;
-	let closed = false;
-	const pageQueue = createRingBuffer(Math.max(2, prefetch + 1));
-	const worker = new Worker(new URL(workerFile, import.meta.url), { workerData: {
-		filepath,
-		options
-	} });
-	worker.on("message", (msg) => {
-		switch (msg.type) {
-			case "page":
-				pageQueue.push(msg.data);
-				break;
-			case "done":
-			case "error":
-				done = true;
-				pageQueue.wake();
-				break;
-		}
-	});
-	worker.on("error", () => {
-		done = true;
-		pageQueue.wake();
-	});
-	worker.on("exit", () => {
-		done = true;
-		pageQueue.wake();
-	});
-	async function next() {
-		if (closed) return null;
-		return pageQueue.shift(done);
-	}
-	function nextSync() {
-		if (closed) return null;
-		return pageQueue.shiftSync();
-	}
-	async function close() {
-		if (closed) return;
-		closed = true;
-		done = true;
-		pageQueue.clear();
-		try {
-			await worker.terminate();
-		} catch {}
-	}
-	function tryClose() {
-		close().catch(() => {});
-	}
-	return {
-		next,
-		nextSync,
-		close,
-		async *[Symbol.asyncIterator]() {
-			try {
-				while (true) {
-					const p = await next();
-					if (!p) break;
-					yield p;
-				}
-			} finally {
-				tryClose();
-			}
-		},
-		*[Symbol.iterator]() {
-			try {
-				while (true) {
-					const p = nextSync();
-					if (!p) break;
-					yield p;
-				}
-			} finally {
-				tryClose();
-			}
-		}
-	};
-}
-//#endregion
 //#region src/main.ts
 function createPager(filepath, options = {}) {
-	const { chunkSize = 64 * 1024, pageSize = 1e3, delimiter = "\n", prefetch = 8, backward = false, useWorker = false, tryNative = true } = options;
+	const { chunkSize = 64 * 1024, pageSize = 1e3, delimiter = "\n", prefetch = 8, backward = false, output = "string" } = options;
 	if (!filepath) throw new Error("filepath required");
 	if (pageSize < 1) throw new RangeError("pageSize must be >= 1");
 	if (prefetch < 1) throw new RangeError("prefetch must be >= 1");
-	if (useWorker) {
-		if (backward) throw new Error("backward not supported with useWorker");
-		if (tryNative) throw new Error("tryNative not supported with useWorker");
-	}
-	if (tryNative) {
-		if (delimiter.length !== 1) throw new RangeError("native reader only supports single-character delimiters");
-	}
 	const readerOptions = {
 		chunkSize,
 		pageSize,
 		prefetch,
-		delimiter
+		delimiter,
+		output
 	};
-	let nativeReader;
-	if (tryNative) {
-		const nativeOptions = {
-			pageSize,
-			delimiter,
-			backward
-		};
-		try {
-			nativeReader = createNativePager(filepath, nativeOptions);
-		} catch {}
-	}
-	const reader = tryNative && nativeReader ? nativeReader : useWorker ? createWorkerReader(filepath, readerOptions) : backward ? createBackwardReader(filepath, readerOptions) : createForwardReader(filepath, readerOptions);
+	const reader = backward ? createBackwardReader(filepath, readerOptions) : createForwardReader(filepath, readerOptions);
 	if (process.env.PAGER_TEST_CLEANUPS) {
 		globalThis.__pager_test_cleanups__ ??= [];
 		globalThis.__pager_test_cleanups__.push(reader.close);

package/dist/native-7x1Vhdaw.d.cts

@@ -0,0 +1,44 @@
+//#region src/types.d.ts
+type AsyncFunction = () => Promise<void>;
+type Output = "string" | "buffer";
+type PageOutput = string[] | Buffer;
+type ResolvePageOutput<T extends Output> = T extends "buffer" ? Buffer : string[];
+interface ReaderOptions {
+  chunkSize: number;
+  pageSize: number;
+  delimiter: string;
+  prefetch: number;
+  output: Output;
+}
+interface NativeReaderOptions {
+  pageSize: number;
+  delimiter: string;
+  backward: boolean;
+  output: Output;
+}
+type PagerOptions = Partial<ReaderOptions> & {
+  backward?: boolean;
+};
+type AddonFD = object | null;
+type AddonData = Buffer | null;
+interface NativeAddon {
+  open: (filepath: string, pageSize: number, delimiter: string, backward: boolean) => AddonFD;
+  next: (fd: AddonFD) => Promise<AddonData>;
+  nextSync: (fd: AddonFD) => AddonData;
+  close: (fd: AddonFD) => Promise<void>;
+}
+interface Pager<T extends Output = "string"> {
+  next(): Promise<ResolvePageOutput<T> | null>;
+  nextSync(): ResolvePageOutput<T> | null;
+  close(): Promise<void>;
+  [Symbol.asyncIterator](): AsyncIterator<ResolvePageOutput<T>>;
+  [Symbol.iterator](): Iterator<ResolvePageOutput<T>>;
+}
+//#endregion
+//#region src/native.d.ts
+declare function createNativePager<T extends Output>(filepath: string, options: Partial<NativeReaderOptions> & {
+  output: T;
+}): Pager<T>;
+declare function createNativePager(filepath: string, options?: Partial<NativeReaderOptions>): Pager<"string">;
+//#endregion
+export { Output as a, PagerOptions as c, NativeReaderOptions as i, ReaderOptions as l, AsyncFunction as n, PageOutput as o, NativeAddon as r, Pager as s, createNativePager as t, ResolvePageOutput as u };

package/dist/native-D6SBIgoE.d.mts

@@ -0,0 +1,44 @@
+//#region src/types.d.ts
+type AsyncFunction = () => Promise<void>;
+type Output = "string" | "buffer";
+type PageOutput = string[] | Buffer;
+type ResolvePageOutput<T extends Output> = T extends "buffer" ? Buffer : string[];
+interface ReaderOptions {
+  chunkSize: number;
+  pageSize: number;
+  delimiter: string;
+  prefetch: number;
+  output: Output;
+}
+interface NativeReaderOptions {
+  pageSize: number;
+  delimiter: string;
+  backward: boolean;
+  output: Output;
+}
+type PagerOptions = Partial<ReaderOptions> & {
+  backward?: boolean;
+};
+type AddonFD = object | null;
+type AddonData = Buffer | null;
+interface NativeAddon {
+  open: (filepath: string, pageSize: number, delimiter: string, backward: boolean) => AddonFD;
+  next: (fd: AddonFD) => Promise<AddonData>;
+  nextSync: (fd: AddonFD) => AddonData;
+  close: (fd: AddonFD) => Promise<void>;
+}
+interface Pager<T extends Output = "string"> {
+  next(): Promise<ResolvePageOutput<T> | null>;
+  nextSync(): ResolvePageOutput<T> | null;
+  close(): Promise<void>;
+  [Symbol.asyncIterator](): AsyncIterator<ResolvePageOutput<T>>;
+  [Symbol.iterator](): Iterator<ResolvePageOutput<T>>;
+}
+//#endregion
+//#region src/native.d.ts
+declare function createNativePager<T extends Output>(filepath: string, options: Partial<NativeReaderOptions> & {
+  output: T;
+}): Pager<T>;
+declare function createNativePager(filepath: string, options?: Partial<NativeReaderOptions>): Pager<"string">;
+//#endregion
+export { Output as a, PagerOptions as c, NativeReaderOptions as i, ReaderOptions as l, AsyncFunction as n, PageOutput as o, NativeAddon as r, Pager as s, createNativePager as t, ResolvePageOutput as u };

package/dist/native.cjs

@@ -28,11 +28,12 @@ function loadNativeAddon() {
 	}
 }
 function createNativePager(filepath, options = {}) {
-	const { pageSize = 1e3, delimiter = "\n", backward = false } = options;
+	const { pageSize = 1e3, delimiter = "\n", backward = false, output = "string" } = options;
 	if (!filepath) throw new Error("filepath required");
 	if (pageSize < 1) throw new RangeError("pageSize must be >= 1");
 	if (delimiter?.length > 1) throw new RangeError("native reader only supports single-character delimiters");
 	const nativeReader = loadNativeAddon();
+	const isBufferOutput = output === "buffer";
 	if (process.env.PAGER_TEST_CLEANUPS) {
 		globalThis.__pager_test_cleanups__ ??= [];
 		globalThis.__pager_test_cleanups__.push(nativeReader.close);
@@ -41,15 +42,15 @@ function createNativePager(filepath, options = {}) {
 	let closed = false;
 	async function next() {
 		if (closed || !fd) return null;
-		const data = await nativeReader.next(fd);
-		if (!data) return null;
-		return data.toString("utf8").split(delimiter);
+		const buf = await nativeReader.next(fd);
+		if (!buf) return null;
+		return isBufferOutput ? buf : buf.toString("utf8").split(delimiter);
 	}
 	function nextSync() {
 		if (closed || !fd) return null;
-		const data = nativeReader.nextSync(fd);
-		if (!data) return null;
-		return data.toString("utf8").split(delimiter);
+		const buf = nativeReader.nextSync(fd);
+		if (!buf) return null;
+		return isBufferOutput ? buf : buf.toString("utf8").split(delimiter);
 	}
 	async function close() {
 		if (closed || !fd) return;

package/dist/native.d.cts

@@ -1,2 +1,2 @@
-import { t as createNativePager } from "./native-_NmVYcF6.cjs";
+import { t as createNativePager } from "./native-7x1Vhdaw.cjs";
 export { createNativePager };

package/dist/native.d.mts

@@ -1,2 +1,2 @@
-import { t as createNativePager } from "./native-DGzYrMHK.mjs";
+import { t as createNativePager } from "./native-D6SBIgoE.mjs";
 export { createNativePager };

package/dist/native.mjs

@@ -27,11 +27,12 @@ function loadNativeAddon() {
 	}
 }
 function createNativePager(filepath, options = {}) {
-	const { pageSize = 1e3, delimiter = "\n", backward = false } = options;
+	const { pageSize = 1e3, delimiter = "\n", backward = false, output = "string" } = options;
 	if (!filepath) throw new Error("filepath required");
 	if (pageSize < 1) throw new RangeError("pageSize must be >= 1");
 	if (delimiter?.length > 1) throw new RangeError("native reader only supports single-character delimiters");
 	const nativeReader = loadNativeAddon();
+	const isBufferOutput = output === "buffer";
 	if (process.env.PAGER_TEST_CLEANUPS) {
 		globalThis.__pager_test_cleanups__ ??= [];
 		globalThis.__pager_test_cleanups__.push(nativeReader.close);
@@ -40,15 +41,15 @@ function createNativePager(filepath, options = {}) {
 	let closed = false;
 	async function next() {
 		if (closed || !fd) return null;
-		const data = await nativeReader.next(fd);
-		if (!data) return null;
-		return data.toString("utf8").split(delimiter);
+		const buf = await nativeReader.next(fd);
+		if (!buf) return null;
+		return isBufferOutput ? buf : buf.toString("utf8").split(delimiter);
 	}
 	function nextSync() {
 		if (closed || !fd) return null;
-		const data = nativeReader.nextSync(fd);
-		if (!data) return null;
-		return data.toString("utf8").split(delimiter);
+		const buf = nativeReader.nextSync(fd);
+		if (!buf) return null;
+		return isBufferOutput ? buf : buf.toString("utf8").split(delimiter);
 	}
 	async function close() {
 		if (closed || !fd) return;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "readline-pager",
-  "version": "0.6.5",
+  "version": "0.7.2",
   "scripts": {
     "build:js": "tsdown",
     "build:native": "node-gyp rebuild",
@@ -13,20 +13,20 @@
     "benchmark:bun": "bun test/benchmark.ts"
   },
   "devDependencies": {
-    "@types/bun": "~1.3.11",
+    "@types/bun": "~1.3.12",
     "@types/deno": "~2.5.0",
-    "@types/node": "~25.5.0",
+    "@types/node": "~25.6.0",
     "node-gyp": "~12.2.0",
-    "prettier": "~3.8.1",
+    "prettier": "~3.8.2",
     "prettier-plugin-organize-imports": "~4.3.0",
-    "tsdown": "~0.21.6",
+    "tsdown": "~0.21.7",
     "typescript": "~6.0.2"
   },
   "optionalDependencies": {
-    "@devmor-j/readline-pager-linux-arm64": "0.6.5",
-    "@devmor-j/readline-pager-linux-musl-arm64": "0.6.5",
-    "@devmor-j/readline-pager-linux-musl-x64": "0.6.5",
-    "@devmor-j/readline-pager-linux-x64": "0.6.5"
+    "@devmor-j/readline-pager-linux-arm64": "0.7.2",
+    "@devmor-j/readline-pager-linux-musl-arm64": "0.7.2",
+    "@devmor-j/readline-pager-linux-musl-x64": "0.7.2",
+    "@devmor-j/readline-pager-linux-x64": "0.7.2"
   },
   "gypfile": false,
   "type": "module",
@@ -60,7 +60,7 @@
     "avx2",
     "neon"
   ],
-  "description": "High-performance paginated file reader for Node.js. Efficiently process large text files without loading them into memory.",
+  "description": "High-performance paginated file reader for Node.js. Process large text files efficiently without loading them into memory.",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/devmor-j/readline-pager.git"

package/dist/native-DGzYrMHK.d.mts

@@ -1,46 +0,0 @@
-//#region src/types.d.ts
-interface ReaderOptions {
-  chunkSize: number;
-  pageSize: number;
-  delimiter: string;
-  prefetch: number;
-}
-interface PagerOptions extends Partial<ReaderOptions> {
-  backward?: boolean;
-  useWorker?: boolean;
-  tryNative?: boolean;
-}
-interface NativeReaderOptions {
-  pageSize: number;
-  delimiter: string;
-  backward: boolean;
-}
-type WorkerMessage = {
-  type: "page";
-  data: string[];
-} | {
-  type: "error";
-  error: unknown;
-} | {
-  type: "done";
-};
-type AddonFD = object | null;
-type AddonData = Buffer | null;
-interface NativeAddon {
-  open: (filepath: string, pageSize: number, delimiter: string, backward: boolean) => AddonFD;
-  next: (fd: AddonFD) => Promise<AddonData>;
-  nextSync: (fd: AddonFD) => AddonData;
-  close: (fd: AddonFD) => Promise<void>;
-}
-interface Pager {
-  next(): Promise<string[] | null>;
-  nextSync(): string[] | null;
-  close(): Promise<void>;
-  [Symbol.asyncIterator](): AsyncIterator<string[]>;
-  [Symbol.iterator](): Iterator<string[]>;
-}
-//#endregion
-//#region src/native.d.ts
-declare function createNativePager(filepath: string, options?: Partial<NativeReaderOptions>): Pager;
-//#endregion
-export { PagerOptions as a, Pager as i, NativeAddon as n, ReaderOptions as o, NativeReaderOptions as r, WorkerMessage as s, createNativePager as t };

package/dist/native-_NmVYcF6.d.cts

@@ -1,46 +0,0 @@
-//#region src/types.d.ts
-interface ReaderOptions {
-  chunkSize: number;
-  pageSize: number;
-  delimiter: string;
-  prefetch: number;
-}
-interface PagerOptions extends Partial<ReaderOptions> {
-  backward?: boolean;
-  useWorker?: boolean;
-  tryNative?: boolean;
-}
-interface NativeReaderOptions {
-  pageSize: number;
-  delimiter: string;
-  backward: boolean;
-}
-type WorkerMessage = {
-  type: "page";
-  data: string[];
-} | {
-  type: "error";
-  error: unknown;
-} | {
-  type: "done";
-};
-type AddonFD = object | null;
-type AddonData = Buffer | null;
-interface NativeAddon {
-  open: (filepath: string, pageSize: number, delimiter: string, backward: boolean) => AddonFD;
-  next: (fd: AddonFD) => Promise<AddonData>;
-  nextSync: (fd: AddonFD) => AddonData;
-  close: (fd: AddonFD) => Promise<void>;
-}
-interface Pager {
-  next(): Promise<string[] | null>;
-  nextSync(): string[] | null;
-  close(): Promise<void>;
-  [Symbol.asyncIterator](): AsyncIterator<string[]>;
-  [Symbol.iterator](): Iterator<string[]>;
-}
-//#endregion
-//#region src/native.d.ts
-declare function createNativePager(filepath: string, options?: Partial<NativeReaderOptions>): Pager;
-//#endregion
-export { PagerOptions as a, Pager as i, NativeAddon as n, ReaderOptions as o, NativeReaderOptions as r, WorkerMessage as s, createNativePager as t };

package/dist/worker.cjs

@@ -1,52 +0,0 @@
-let node_fs_promises = require("node:fs/promises");
-let node_worker_threads = require("node:worker_threads");
-//#region src/worker.ts
-const { filepath, options } = node_worker_threads.workerData;
-const { chunkSize, pageSize, delimiter } = options;
-const backpressure = pageSize * 8;
-function post(msg) {
-	if (!node_worker_threads.parentPort) process.exit(1);
-	node_worker_threads.parentPort.postMessage(msg);
-}
-(async () => {
-	try {
-		const fd = await (0, node_fs_promises.open)(filepath, "r");
-		const { size } = await fd.stat();
-		let pos = 0;
-		let buffer = "";
-		const local = [];
-		while (pos < size) {
-			const readSize = Math.min(chunkSize, size - pos);
-			const buf = Buffer.allocUnsafe(readSize);
-			const { bytesRead } = await fd.read(buf, 0, readSize, pos);
-			pos += bytesRead;
-			buffer = buffer + buf.toString("utf8", 0, bytesRead);
-			let idx;
-			while ((idx = buffer.indexOf(delimiter)) !== -1) {
-				const line = buffer.slice(0, idx);
-				buffer = buffer.slice(idx + delimiter.length);
-				local.push(line);
-				if (local.length >= pageSize) {
-					post({
-						type: "page",
-						data: local.splice(0, pageSize)
-					});
-					if (local.length > backpressure) await new Promise((r) => setImmediate(r));
-				}
-			}
-		}
-		local.push(buffer);
-		while (local.length > 0) post({
-			type: "page",
-			data: local.splice(0, pageSize)
-		});
-		post({ type: "done" });
-		await fd.close();
-	} catch (err) {
-		post({
-			type: "error",
-			error: err
-		});
-	}
-})();
-//#endregion

package/dist/worker.d.cts

@@ -1 +0,0 @@
-export { };

package/dist/worker.d.mts

@@ -1 +0,0 @@
-export { };

package/dist/worker.mjs

@@ -1,53 +0,0 @@
-import { open } from "node:fs/promises";
-import { parentPort, workerData } from "node:worker_threads";
-//#region src/worker.ts
-const { filepath, options } = workerData;
-const { chunkSize, pageSize, delimiter } = options;
-const backpressure = pageSize * 8;
-function post(msg) {
-	if (!parentPort) process.exit(1);
-	parentPort.postMessage(msg);
-}
-(async () => {
-	try {
-		const fd = await open(filepath, "r");
-		const { size } = await fd.stat();
-		let pos = 0;
-		let buffer = "";
-		const local = [];
-		while (pos < size) {
-			const readSize = Math.min(chunkSize, size - pos);
-			const buf = Buffer.allocUnsafe(readSize);
-			const { bytesRead } = await fd.read(buf, 0, readSize, pos);
-			pos += bytesRead;
-			buffer = buffer + buf.toString("utf8", 0, bytesRead);
-			let idx;
-			while ((idx = buffer.indexOf(delimiter)) !== -1) {
-				const line = buffer.slice(0, idx);
-				buffer = buffer.slice(idx + delimiter.length);
-				local.push(line);
-				if (local.length >= pageSize) {
-					post({
-						type: "page",
-						data: local.splice(0, pageSize)
-					});
-					if (local.length > backpressure) await new Promise((r) => setImmediate(r));
-				}
-			}
-		}
-		local.push(buffer);
-		while (local.length > 0) post({
-			type: "page",
-			data: local.splice(0, pageSize)
-		});
-		post({ type: "done" });
-		await fd.close();
-	} catch (err) {
-		post({
-			type: "error",
-			error: err
-		});
-	}
-})();
-//#endregion
-export {};