njsparser 0.1.0

package/README.md

@@ -0,0 +1,75 @@
+# njsparser (JS)
+
+A powerful parser and explorer for any website built with [NextJS](https://nextjs.org).
+Ported from the Python library `njsparser`.
+
+- Parses flight data (from the `self.__next_f.push` scripts).
+- Parses next data from `__NEXT_DATA__` script.
+- Parses build manifests.
+- Searches for build id.
+
+## Installation
+
+```bash
+bun install njsparser
+# or
+npm install njsparser
+```
+
+## Usage
+
+### Parsing Flight Data
+
+```javascript
+import { BeautifulFD, get_flight_data } from 'njsparser';
+
+const html = `...`; // Fetch your HTML
+
+// Using BeautifulFD for easy searching
+const fd = new BeautifulFD(html);
+
+// Find specific data types
+import { Data, RSCPayload } from 'njsparser';
+
+const rsc = fd.find({ class_filters: [RSCPayload] });
+console.log(rsc.build_id);
+
+const data = fd.find_all({ class_filters: [Data] });
+data.forEach(item => {
+    console.log(item.content);
+});
+```
+
+### Parsing `__NEXT_DATA__`
+
+```javascript
+import { get_next_data } from 'njsparser';
+
+const data = get_next_data(html);
+console.log(data.props.pageProps);
+```
+
+### Tools
+
+```javascript
+import { has_nextjs, find_build_id } from 'njsparser';
+
+if (has_nextjs(html)) {
+    console.log("NextJS detected!");
+    console.log("Build ID:", find_build_id(html));
+}
+```
+
+## API Reference
+
+Most functions from the Python library are available in JS with similar signatures.
+
+- `BeautifulFD(html)`
+- `get_flight_data(html)`
+- `get_next_data(html)`
+- `find_build_id(html)`
+- `has_nextjs(html)`
+- `get_next_static_urls(html)`
+- `get_base_path(html)`
+
+See source code for more details.

package/_.js

@@ -0,0 +1,10 @@
+import {
+    BeautifulFD,
+    get_flight_data
+} from './index.js';
+
+const html = await Bun.file('/home/kaki/.config/JetBrains/IntelliJIdea2025.3/scratches/scratch_2.html').text();
+const fd = new BeautifulFD(html);
+console.log(fd.find_all());
+console.log(await Bun.write('./_.json', JSON.stringify(fd.find_all(), null, 4)));
+// console.log(await Bun.write('./_.json', JSON.stringify(get_flight_data(html), null, 4)));