readline-pager 0.3.1 → 0.4.9

package/README.md

@@ -12,18 +12,18 @@
   <img src="https://img.shields.io/github/stars/devmor-j/readline-pager" alt="stars">
 </p>
 
-⚡ Memory-efficient paginated file reader for Node.js with async and sync iteration, prefetching, backward reading, and optional worker support. `readline-pager` reads large text files page-by-page without loading the entire file into memory.
+⚡ High-performance paginated file reader for Node.js. Efficiently process large text files without loading them into memory.
 
-- ✅ Zero dependencies
-- ✅ Async iterator (`for await...of`) + manual `next()` API
-- ✅ Sync iterator (`for...of`) + manual `nextSync()` API
-- ✅ Forward & backward reading (EOF → BOF)
-- ✅ Optional worker thread mode (forward only)
-- ✅ Up to ~3× faster than Node.js `readline`
-- ✅ ~97% test coverage & fully typed (TypeScript)
+- 📦 Zero dependencies
+- ⚡ Up to ~3× faster than Node.js `readline`
+- 🚀 Up to ~6× faster with optional native C++ acceleration
+- 🔁 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 (~95%)
 
 > **Important:**  
-> Performance depends heavily on the `chunkSize` option. Tune it for your specific I/O hardware. A value of **64 KB** is usually a good starting point. Increasing it may gradually improve throughput until reaching the optimal point for your hardware.
+> 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.
 
 ---
 
@@ -39,42 +39,52 @@ npm install readline-pager
 
 ```ts
 import { createPager } from "readline-pager";
-// const { createPager } = require("readline-pager");
 
-const pager = createPager("./bigfile.txt");
-
-// Async iteration
-for await (const page of pager) {
-  console.log(page[0]); // first line of the current page
+for await (const page of createPager("./bigfile.txt")) {
+  console.log(page[0]);
 }
+```
+
+---
+
+### Other usage patterns
+
+```ts
+import { createPager, createNativePager } from "readline-pager";
 
 // Sync iteration
-for (const page of pager) {
+for (const page of createPager("./bigfile.txt")) {
 }
 
-// Manual next
+// Manual async
+const pager = createPager("./bigfile.txt");
 while (true) {
   const page = await pager.next();
   if (!page) break;
 }
 
-// Manual nextSync (also with condition variation)
+// Manual sync
 let page;
-while ((page = pager.nextSync()) !== null) {
-  console.log(page[0]);
+const pager = createPager("./bigfile.txt");
+while ((page = pager.nextSync()) !== null) {}
+
+// Native C++ (fastest)
+for await (const page of createNativePager("./bigfile.txt")) {
 }
 ```
 
+---
+
 ## ⚙️ Options
 
 ```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
+  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
 });
 ```
 
@@ -82,7 +92,7 @@ createPager(filepath, {
 - `pageSize` — number of lines per page.
 - `delimiter` — line separator.
 - `prefetch` — maximum number of pages buffered internally.
-- `backward` — read the file from end → start (not supported with `useWorker`).
+- `backward` — read the file from end to start.
 - `useWorker` — offload reading to a worker thread (forward reading only).
 
 ---
@@ -113,58 +123,52 @@ Stops reading and releases resources asynchronously. Safe to call at any time.
 
 ---
 
-**Note:**
-Unlike Node.js `readline`, which may skip empty files or leading empty lines, `readline-pager` always returns all lines.
+### `createNativePager(filepath, options?): Pager`
+
+Creates a pager backed by the optional native C++ addon.
 
-- A completely empty file (`0` bytes) produces `[""]` on the first read.
-- A file containing multiple empty lines returns each line as an empty string (for example `["", ""]` for two empty lines).
+If the native addon is not available for the current platform, this function throws.
+
+---
+
+> **Note:**
+> Unlike Node.js `readline`, which may skip empty files or leading empty lines, `readline-pager` always returns all lines.
+>
+> - A completely empty file (`0` bytes) produces `[""]` on the first read.
+> - A file containing multiple empty lines returns each line as an empty string.
+
+---
 
 ## 📊 Benchmark
 
-Run the included benchmark:
+Run the benchmark locally:
 
 ```bash
-# default run
-npm run benchmark
+npm run benchmark:node
 
 # or customize with args
 node test/_benchmark.ts --lines=20000 --page-size=500 --backward
 ```
 
-> Test setup: generated text files with uuid, run on a fast NVMe machine with default options; values are averages from multiple runs. Results are machine-dependent.
->
-> The **Average Throughput (MB/s)** is computed for two strategies: reading files line by line and page by page.
->
-> In addition to _Node_, the two other popular JavaScript runtimes were also tested with `readline-pager`.
-
-### Line by line
-
-| Runtime / Method | 1M lines (35 MB) | 10M lines (353 MB) | 100M lines (3,529 MB) | 1,000M lines (35,286 MB) |
-| ---------------- | ---------------: | -----------------: | --------------------: | -----------------------: |
-| Node — node:line |              369 |                435 |                   455 |                      455 |
-| Deno — node:line |              203 |                230 |                   230 |                      229 |
-| Deno — deno:line |              738 |                901 |                   915 |                      809 |
-| Bun — node:line  |              246 |                279 |                   283 |                      280 |
-| Bun — bun:line   |              938 |              1,540 |                 1,668 |                    1,315 |
+> Test setup: generated text files (UUID lines), NVMe SSD, Node.js runtime.
+> Results are averaged across multiple runs. Actual performance depends on hardware.
 
-### Page by page
+---
 
-| Runtime / Method      | 1M lines (35 MB) | 10M lines (353 MB) | 100M lines (3,529 MB) | 1,000M lines (35,286 MB) |
-| --------------------- | ---------------: | -----------------: | --------------------: | -----------------------: |
-| Node — readline-pager |            1,053 |              1,311 |                 1,278 |                      936 |
-| Deno — deno:page      |              852 |                909 |                   908 |                      783 |
-| Deno — readline-pager |            1,131 |              1,268 |                 1,271 |                      911 |
-| Bun — bun:page        |              411 |                440 |                   449 |                      428 |
-| Bun — readline-pager  |              827 |              1,021 |                 1,040 |                      804 |
+### ⚡ Throughput (MB/s)
 
-**Runtime Environment:** Node.js v25.6.1 & Bun v1.3.9 & Deno 2.6.10
+| Method                 | 1M lines (35 MB) | 10M lines (353 MB) | 100M lines (3.5 GB) | 1B lines (35.3 GB) |
+| ---------------------- | ---------------: | -----------------: | ------------------: | -----------------: |
+| `readline`             |        ~370 MB/s |          ~460 MB/s |           ~460 MB/s |          ~460 MB/s |
+| `readline-pager` (JS)  |       ~1100 MB/s |         ~1300 MB/s |          ~1300 MB/s |         ~1150 MB/s |
+| `readline-pager` (C++) |       ~2200 MB/s |         ~2500 MB/s |          ~2500 MB/s |         ~2450 MB/s |
 
 ---
 
 ## 🛠 Development & Contributing
 
-- Minimum supported Node.js: **v18.12 (lts/hydrogen)**.
-- Development/test environment: **Node v25.6 & TypeScript v5.9**.
+- Minimum supported Node.js: **v18.12**
+- Development/test environment: **Node v25.8** and **TypeScript v6.0**
 
 Run tests:
 
@@ -173,7 +177,7 @@ npm ci
 npm test
 ```
 
-Contributions are welcome — feel free to open an issue or PR.
+Contributions are welcome. Open an issue or submit a PR.
 
 ---
 

package/dist/main.cjs

@@ -2,6 +2,7 @@ Object.defineProperties(exports, {
 	__esModule: { value: true },
 	[Symbol.toStringTag]: { value: "Module" }
 });
+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");
@@ -47,7 +48,7 @@ function createRingBuffer(capacity) {
 		}
 		return v;
 	}
-	async function shift(done = false) {
+	async function shift(done) {
 		if (count) return shiftSync();
 		if (done) return null;
 		await new Promise((r) => {
@@ -214,7 +215,7 @@ function createBackwardReader(filepath, options) {
 	}
 	async function next() {
 		if (closed) return null;
-		return await pageQueue.shift(done);
+		return pageQueue.shift(done);
 	}
 	function nextSync() {
 		if (closed) return null;
@@ -394,7 +395,7 @@ function createForwardReader(filepath, options) {
 	}
 	async function next() {
 		if (closed) return null;
-		return await pageQueue.shift(done);
+		return pageQueue.shift(done);
 	}
 	function nextSync() {
 		if (closed) return null;
@@ -460,16 +461,13 @@ function createForwardReader(filepath, options) {
 //#region src/reader/worker.reader.ts
 const workerFile = new URL("./worker.mjs", require("url").pathToFileURL(__filename).href);
 function createWorkerReader(filepath, options) {
-	const { chunkSize, pageSize, delimiter, prefetch } = options;
+	const { prefetch } = options;
 	const pageQueue = createRingBuffer(Math.max(2, prefetch + 1));
 	let done = false;
 	let closed = false;
 	const worker = new node_worker_threads.Worker(new URL(workerFile, require("url").pathToFileURL(__filename).href), { workerData: {
 		filepath,
-		chunkSize,
-		pageSize,
-		delimiter,
-		prefetch
+		options
 	} });
 	worker.on("message", (msg) => {
 		if (msg.type === "page") pageQueue.push(msg.data);
@@ -488,7 +486,7 @@ function createWorkerReader(filepath, options) {
 	});
 	async function next() {
 		if (closed) return null;
-		return await pageQueue.shift(done);
+		return pageQueue.shift(done);
 	}
 	function nextSync() {
 		if (closed) return null;
@@ -539,23 +537,20 @@ function createPager(filepath, options = {}) {
 	if (pageSize < 1) throw new RangeError("pageSize must be >= 1");
 	if (prefetch < 1) throw new RangeError("prefetch must be >= 1");
 	if (backward && useWorker) throw new Error("backward not supported with useWorker");
-	return useWorker ? createWorkerReader(filepath, {
-		chunkSize,
-		pageSize,
-		prefetch,
-		delimiter
-	}) : backward ? createBackwardReader(filepath, {
+	const _options = {
 		chunkSize,
 		pageSize,
 		prefetch,
 		delimiter
-	}) : createForwardReader(filepath, {
-		chunkSize,
-		pageSize,
-		prefetch,
-		delimiter
-	});
+	};
+	const reader = useWorker ? createWorkerReader(filepath, _options) : backward ? createBackwardReader(filepath, _options) : createForwardReader(filepath, _options);
+	if (process.env.TEST_CLEANUPS) {
+		globalThis.__test_cleanups__ ??= [];
+		globalThis.__test_cleanups__.push(reader.close);
+	}
+	return reader;
 }
 //#endregion
+exports.createNativePager = require_native.createNativePager;
 exports.createPager = createPager;
 exports.default = createPager;

package/dist/main.d.cts

@@ -1,21 +1,6 @@
-//#region src/types.d.ts
-interface ReaderOptions {
-  chunkSize: number;
-  pageSize: number;
-  delimiter: string;
-  prefetch: number;
-}
-interface PagerOptions extends Partial<ReaderOptions> {
-  backward?: boolean;
-  useWorker?: boolean;
-}
-interface Pager extends AsyncIterable<string[]>, Iterable<string[]> {
-  next(): Promise<string[] | null>;
-  nextSync(): string[] | null;
-  close(): Promise<void>;
-}
-//#endregion
+import { i as ReaderOptions, n as Pager, r as PagerOptions, t as createNativePager } from "./native-BNwCco1j.cjs";
+
 //#region src/main.d.ts
 declare function createPager(filepath: string, options?: PagerOptions): Pager;
 //#endregion
-export { Pager, PagerOptions, ReaderOptions, createPager, createPager as default };
+export { Pager, PagerOptions, ReaderOptions, createNativePager, createPager, createPager as default };

package/dist/main.d.mts

@@ -1,21 +1,6 @@
-//#region src/types.d.ts
-interface ReaderOptions {
-  chunkSize: number;
-  pageSize: number;
-  delimiter: string;
-  prefetch: number;
-}
-interface PagerOptions extends Partial<ReaderOptions> {
-  backward?: boolean;
-  useWorker?: boolean;
-}
-interface Pager extends AsyncIterable<string[]>, Iterable<string[]> {
-  next(): Promise<string[] | null>;
-  nextSync(): string[] | null;
-  close(): Promise<void>;
-}
-//#endregion
+import { i as ReaderOptions, n as Pager, r as PagerOptions, t as createNativePager } from "./native-BWytCdQz.mjs";
+
 //#region src/main.d.ts
 declare function createPager(filepath: string, options?: PagerOptions): Pager;
 //#endregion
-export { Pager, PagerOptions, ReaderOptions, createPager, createPager as default };
+export { Pager, PagerOptions, ReaderOptions, createNativePager, createPager, createPager as default };

package/dist/main.mjs

@@ -1,3 +1,4 @@
+import { createNativePager } from "./native.mjs";
 import { createRequire } from "node:module";
 import { closeSync, openSync, readSync, statSync } from "node:fs";
 import { open } from "node:fs/promises";
@@ -47,7 +48,7 @@ function createRingBuffer(capacity) {
 		}
 		return v;
 	}
-	async function shift(done = false) {
+	async function shift(done) {
 		if (count) return shiftSync();
 		if (done) return null;
 		await new Promise((r) => {
@@ -214,7 +215,7 @@ function createBackwardReader(filepath, options) {
 	}
 	async function next() {
 		if (closed) return null;
-		return await pageQueue.shift(done);
+		return pageQueue.shift(done);
 	}
 	function nextSync() {
 		if (closed) return null;
@@ -394,7 +395,7 @@ function createForwardReader(filepath, options) {
 	}
 	async function next() {
 		if (closed) return null;
-		return await pageQueue.shift(done);
+		return pageQueue.shift(done);
 	}
 	function nextSync() {
 		if (closed) return null;
@@ -460,16 +461,13 @@ function createForwardReader(filepath, options) {
 //#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 { chunkSize, pageSize, delimiter, prefetch } = options;
+	const { prefetch } = options;
 	const pageQueue = createRingBuffer(Math.max(2, prefetch + 1));
 	let done = false;
 	let closed = false;
 	const worker = new Worker(new URL(workerFile, import.meta.url), { workerData: {
 		filepath,
-		chunkSize,
-		pageSize,
-		delimiter,
-		prefetch
+		options
 	} });
 	worker.on("message", (msg) => {
 		if (msg.type === "page") pageQueue.push(msg.data);
@@ -488,7 +486,7 @@ function createWorkerReader(filepath, options) {
 	});
 	async function next() {
 		if (closed) return null;
-		return await pageQueue.shift(done);
+		return pageQueue.shift(done);
 	}
 	function nextSync() {
 		if (closed) return null;
@@ -539,22 +537,18 @@ function createPager(filepath, options = {}) {
 	if (pageSize < 1) throw new RangeError("pageSize must be >= 1");
 	if (prefetch < 1) throw new RangeError("prefetch must be >= 1");
 	if (backward && useWorker) throw new Error("backward not supported with useWorker");
-	return useWorker ? createWorkerReader(filepath, {
-		chunkSize,
-		pageSize,
-		prefetch,
-		delimiter
-	}) : backward ? createBackwardReader(filepath, {
+	const _options = {
 		chunkSize,
 		pageSize,
 		prefetch,
 		delimiter
-	}) : createForwardReader(filepath, {
-		chunkSize,
-		pageSize,
-		prefetch,
-		delimiter
-	});
+	};
+	const reader = useWorker ? createWorkerReader(filepath, _options) : backward ? createBackwardReader(filepath, _options) : createForwardReader(filepath, _options);
+	if (process.env.TEST_CLEANUPS) {
+		globalThis.__test_cleanups__ ??= [];
+		globalThis.__test_cleanups__.push(reader.close);
+	}
+	return reader;
 }
 //#endregion
-export { createPager, createPager as default };
+export { createNativePager, createPager, createPager as default };

package/dist/native-BNwCco1j.d.cts

@@ -0,0 +1,27 @@
+//#region src/types.d.ts
+interface ReaderOptions {
+  chunkSize: number;
+  pageSize: number;
+  delimiter: string;
+  prefetch: number;
+}
+interface PagerOptions extends Partial<ReaderOptions> {
+  backward?: boolean;
+  useWorker?: boolean;
+}
+interface Pager extends AsyncIterable<string[]>, Iterable<string[]> {
+  next(): Promise<string[] | null>;
+  nextSync(): string[] | null;
+  close(): Promise<void>;
+}
+//#endregion
+//#region src/native.d.ts
+declare function createNativePager(filepath: string, {
+  pageSize,
+  delimiter
+}?: {
+  pageSize?: number | undefined;
+  delimiter?: string | undefined;
+}): Pager;
+//#endregion
+export { ReaderOptions as i, Pager as n, PagerOptions as r, createNativePager as t };

package/dist/native-BWytCdQz.d.mts

@@ -0,0 +1,27 @@
+//#region src/types.d.ts
+interface ReaderOptions {
+  chunkSize: number;
+  pageSize: number;
+  delimiter: string;
+  prefetch: number;
+}
+interface PagerOptions extends Partial<ReaderOptions> {
+  backward?: boolean;
+  useWorker?: boolean;
+}
+interface Pager extends AsyncIterable<string[]>, Iterable<string[]> {
+  next(): Promise<string[] | null>;
+  nextSync(): string[] | null;
+  close(): Promise<void>;
+}
+//#endregion
+//#region src/native.d.ts
+declare function createNativePager(filepath: string, {
+  pageSize,
+  delimiter
+}?: {
+  pageSize?: number | undefined;
+  delimiter?: string | undefined;
+}): Pager;
+//#endregion
+export { ReaderOptions as i, Pager as n, PagerOptions as r, createNativePager as t };

package/dist/native.cjs

@@ -0,0 +1,91 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+let node_module = require("node:module");
+let node_os = require("node:os");
+//#region src/native.ts
+const require$1 = (0, node_module.createRequire)(require("url").pathToFileURL(__filename).href);
+function isMusl() {
+	if ((0, node_os.platform)() !== "linux") return false;
+	try {
+		return !(process.report?.getReport?.())?.header?.glibcVersionRuntime;
+	} catch {
+		return false;
+	}
+}
+function getPackageName() {
+	const p = (0, node_os.platform)();
+	const a = (0, node_os.arch)();
+	switch (p) {
+		case "darwin":
+		case "win32": return `@devmor-j/readline-pager-${p}-${a}`;
+		case "linux": return `@devmor-j/readline-pager-${p}-${isMusl() ? "musl-" : ""}${a}`;
+		default: throw new Error(`Unsupported platform: ${p}/${a}`);
+	}
+}
+function loadNativeAddon() {
+	try {
+		return require$1(getPackageName());
+	} catch {
+		const UNAVAILABLE = `Native addon not available for ${(0, node_os.platform)()}/${(0, node_os.arch)()}.`;
+		throw new Error(UNAVAILABLE);
+	}
+}
+function createNativePager(filepath, { pageSize = 1e3, delimiter = "\n" } = {}) {
+	const pagerNative = loadNativeAddon();
+	let fd = null;
+	let closed = false;
+	const init = () => {
+		fd = pagerNative.open(filepath, pageSize, delimiter);
+	};
+	const next = async () => {
+		if (closed || !fd) return null;
+		const data = await pagerNative.next(fd);
+		if (!data) return null;
+		return data.toString("utf8").split(delimiter);
+	};
+	const nextSync = () => {
+		if (closed || !fd) return null;
+		const data = pagerNative.nextSync(fd);
+		if (!data) return null;
+		return data.toString("utf8").split(delimiter);
+	};
+	const close = async () => {
+		if (!closed || fd) {
+			closed = true;
+			await pagerNative.close(fd);
+			fd = null;
+		}
+	};
+	function tryClose() {
+		close().catch(() => {});
+	}
+	init();
+	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
+exports.createNativePager = createNativePager;

package/dist/native.d.cts

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

package/dist/native.d.mts

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

package/dist/native.mjs

@@ -0,0 +1,90 @@
+import { createRequire } from "node:module";
+import { arch, platform } from "node:os";
+//#region src/native.ts
+const require = createRequire(import.meta.url);
+function isMusl() {
+	if (platform() !== "linux") return false;
+	try {
+		return !(process.report?.getReport?.())?.header?.glibcVersionRuntime;
+	} catch {
+		return false;
+	}
+}
+function getPackageName() {
+	const p = platform();
+	const a = arch();
+	switch (p) {
+		case "darwin":
+		case "win32": return `@devmor-j/readline-pager-${p}-${a}`;
+		case "linux": return `@devmor-j/readline-pager-${p}-${isMusl() ? "musl-" : ""}${a}`;
+		default: throw new Error(`Unsupported platform: ${p}/${a}`);
+	}
+}
+function loadNativeAddon() {
+	try {
+		return require(getPackageName());
+	} catch {
+		const UNAVAILABLE = `Native addon not available for ${platform()}/${arch()}.`;
+		throw new Error(UNAVAILABLE);
+	}
+}
+function createNativePager(filepath, { pageSize = 1e3, delimiter = "\n" } = {}) {
+	const pagerNative = loadNativeAddon();
+	let fd = null;
+	let closed = false;
+	const init = () => {
+		fd = pagerNative.open(filepath, pageSize, delimiter);
+	};
+	const next = async () => {
+		if (closed || !fd) return null;
+		const data = await pagerNative.next(fd);
+		if (!data) return null;
+		return data.toString("utf8").split(delimiter);
+	};
+	const nextSync = () => {
+		if (closed || !fd) return null;
+		const data = pagerNative.nextSync(fd);
+		if (!data) return null;
+		return data.toString("utf8").split(delimiter);
+	};
+	const close = async () => {
+		if (!closed || fd) {
+			closed = true;
+			await pagerNative.close(fd);
+			fd = null;
+		}
+	};
+	function tryClose() {
+		close().catch(() => {});
+	}
+	init();
+	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
+export { createNativePager };

package/dist/worker.cjs

@@ -1,7 +1,8 @@
 let node_fs_promises = require("node:fs/promises");
 let node_worker_threads = require("node:worker_threads");
 //#region src/worker.ts
-const { filepath, chunkSize, pageSize, delimiter } = node_worker_threads.workerData;
+const { filepath, options } = node_worker_threads.workerData;
+const { chunkSize, pageSize, delimiter } = options;
 (async () => {
 	const fd = await (0, node_fs_promises.open)(filepath, "r");
 	const { size } = await fd.stat();

package/dist/worker.mjs

@@ -1,7 +1,8 @@
 import { open } from "node:fs/promises";
 import { parentPort, workerData } from "node:worker_threads";
 //#region src/worker.ts
-const { filepath, chunkSize, pageSize, delimiter } = workerData;
+const { filepath, options } = workerData;
+const { chunkSize, pageSize, delimiter } = options;
 (async () => {
 	const fd = await open(filepath, "r");
 	const { size } = await fd.stat();

package/package.json

@@ -1,25 +1,33 @@
 {
   "name": "readline-pager",
-  "version": "0.3.1",
+  "version": "0.4.9",
   "scripts": {
     "build:js": "tsdown",
-    "build:native": "prebuildify --napi --strip && rm -rf ./build",
+    "build:native": "node-gyp rebuild",
     "build": "npm run build:native && npm run build:js",
+    "pkg:native": "node scripts/package-native.ts",
     "pretest": "npm run build",
-    "test": "node --test --experimental-test-coverage test/**/*.test.ts",
-    "prepublishOnly": "npm run build",
-    "benchmark": "node test/_benchmark.ts; bun test/_benchmark.ts; deno --allow-write --allow-read test/_benchmark.ts"
+    "test": "TEST_CLEANUPS=1 node --test --experimental-test-coverage test/**/*.test.ts",
+    "prepublishOnly": "npm run build && npm run test",
+    "benchmark:node": "node test/_benchmark.ts",
+    "benchmark:deno": "deno --allow-write --allow-read --allow-env test/_benchmark.ts",
+    "benchmark:bun": "bun test/_benchmark.ts"
   },
   "devDependencies": {
     "@types/bun": "~1.3.11",
     "@types/deno": "~2.5.0",
     "@types/node": "~25.5.0",
     "node-gyp": "~12.2.0",
-    "prebuildify": "~6.0.1",
     "prettier": "~3.8.1",
     "prettier-plugin-organize-imports": "~4.3.0",
-    "tsdown": "~0.21.4",
-    "typescript": "~5.9.3"
+    "tsdown": "~0.21.5",
+    "typescript": "~6.0.2"
+  },
+  "optionalDependencies": {
+    "@devmor-j/readline-pager-linux-arm64": "0.4.9",
+    "@devmor-j/readline-pager-linux-x64": "0.4.9",
+    "@devmor-j/readline-pager-linux-musl-arm64": "0.4.9",
+    "@devmor-j/readline-pager-linux-musl-x64": "0.4.9"
   },
   "gypfile": false,
   "type": "module",
@@ -38,9 +46,7 @@
   ],
   "keywords": [
     "nodejs",
-    "readline",
     "readline-pager",
-    "pager",
     "file-reader",
     "pagination",
     "large-files",
@@ -49,9 +55,21 @@
     "memory-efficient",
     "high-performance",
     "log-processing",
-    "backward-reading"
+    "backward-reading",
+    "native-addon",
+    "cpp",
+    "avx2",
+    "neon"
   ],
-  "description": "Memory-efficient, paginated file reader for Node.js with async iteration, prefetching, backward reading and optional worker support.",
+  "description": "High-performance paginated file reader for Node.js. Efficiently process large text files without loading them into memory.",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/devmor-j/readline-pager.git"
+  },
+  "homepage": "https://github.com/devmor-j/readline-pager#readme",
+  "bugs": {
+    "url": "https://github.com/devmor-j/readline-pager/issues"
+  },
   "engines": {
     "node": ">=18.12"
   },