feedparser-rs 0.2.0 → 0.3.0

package/README.md

@@ -1,6 +1,10 @@
 # feedparser-rs
 
-High-performance RSS/Atom/JSON Feed parser written in Rust with Node.js bindings.
+[![npm](https://img.shields.io/npm/v/feedparser-rs)](https://www.npmjs.com/package/feedparser-rs)
+[![Node](https://img.shields.io/node/v/feedparser-rs)](https://www.npmjs.com/package/feedparser-rs)
+[![License](https://img.shields.io/npm/l/feedparser-rs)](LICENSE)
+
+High-performance RSS/Atom/JSON Feed parser for Node.js, written in Rust.
 
 Drop-in replacement for Python's `feedparser` library, offering 10-100x performance improvement.
 
@@ -8,9 +12,10 @@ Drop-in replacement for Python's `feedparser` library, offering 10-100x performa
 
 - **Fast**: Written in Rust, 10-100x faster than Python feedparser
 - **Tolerant**: Handles malformed feeds with bozo flag (like feedparser)
-- **Multi-format**: Supports RSS 0.9x/1.0/2.0, Atom 0.3/1.0, JSON Feed 1.0/1.1
-- **Zero-copy**: Efficient parsing with minimal allocations
+- **Multi-format**: RSS 0.9x/1.0/2.0, Atom 0.3/1.0, JSON Feed 1.0/1.1
+- **HTTP fetching**: Built-in URL fetching with compression support
 - **TypeScript**: Full TypeScript definitions included
+- **Zero-copy**: Efficient parsing with minimal allocations
 
 ## Installation
 
@@ -22,12 +27,14 @@ yarn add feedparser-rs
 pnpm add feedparser-rs
 ```
 
+> [!IMPORTANT]
+> Requires Node.js 18 or later.
+
 ## Quick Start
 
 ```javascript
 import { parse } from 'feedparser-rs';
 
-// Parse from string
 const feed = parse(`
   <?xml version="1.0"?>
   <rss version="2.0">
@@ -44,8 +51,28 @@ const feed = parse(`
 console.log(feed.feed.title);  // "My Blog"
 console.log(feed.entries[0].title);  // "Hello World"
 console.log(feed.version);  // "rss20"
+```
+
+## HTTP Fetching
+
+Fetch and parse feeds directly from URLs:
+
+```javascript
+import { fetchAndParse } from 'feedparser-rs';
+
+const feed = await fetchAndParse('https://example.com/feed.xml');
+console.log(feed.feed.title);
+console.log(`Fetched ${feed.entries.length} entries`);
+```
+
+> [!TIP]
+> `fetchAndParse` automatically handles compression (gzip, deflate, brotli) and follows redirects.
+
+### Parsing from Buffer
+
+```javascript
+import { parse } from 'feedparser-rs';
 
-// Parse from Buffer (e.g., HTTP response)
 const response = await fetch('https://example.com/feed.xml');
 const buffer = Buffer.from(await response.arrayBuffer());
 const feed = parse(buffer);
@@ -66,24 +93,23 @@ Parse a feed from bytes or string.
 **Throws:**
 - `Error` if parsing fails catastrophically
 
-**Example:**
-```javascript
-const feed = parse('<rss version="2.0">...</rss>');
-console.log(feed.feed.title);
-console.log(feed.entries.length);
-```
+### `fetchAndParse(url: string): Promise<ParsedFeed>`
+
+Fetch and parse a feed from URL.
+
+**Parameters:**
+- `url` - Feed URL to fetch
+
+**Returns:**
+- Promise resolving to `ParsedFeed` object
 
 ### `detectFormat(source: Buffer | string | Uint8Array): string`
 
 Detect feed format without full parsing.
 
-**Parameters:**
-- `source` - Feed content as Buffer, string, or Uint8Array
-
 **Returns:**
 - Format string: `"rss20"`, `"atom10"`, `"json11"`, etc.
 
-**Example:**
 ```javascript
 const format = detectFormat('<feed xmlns="http://www.w3.org/2005/Atom">...</feed>');
 console.log(format);  // "atom10"
@@ -114,22 +140,11 @@ interface FeedMeta {
   link?: string;
   links: Link[];
   subtitle?: string;
-  subtitle_detail?: TextConstruct;
   updated?: number;  // Milliseconds since epoch
   author?: string;
-  author_detail?: Person;
   authors: Person[];
-  contributors: Person[];
-  publisher?: string;
-  publisher_detail?: Person;
   language?: string;
-  rights?: string;
-  rights_detail?: TextConstruct;
-  generator?: string;
-  generator_detail?: Generator;
   image?: Image;
-  icon?: string;
-  logo?: string;
   tags: Tag[];
   id?: string;
   ttl?: number;
@@ -142,94 +157,21 @@ interface FeedMeta {
 interface Entry {
   id?: string;
   title?: string;
-  title_detail?: TextConstruct;
   link?: string;
   links: Link[];
   summary?: string;
-  summary_detail?: TextConstruct;
   content: Content[];
   published?: number;  // Milliseconds since epoch
   updated?: number;
-  created?: number;
-  expired?: number;
   author?: string;
-  author_detail?: Person;
   authors: Person[];
-  contributors: Person[];
-  publisher?: string;
-  publisher_detail?: Person;
   tags: Tag[];
   enclosures: Enclosure[];
-  comments?: string;
-  source?: Source;
 }
 ```
 
-### Other Types
-
-```typescript
-interface TextConstruct {
-  value: string;
-  type: "text" | "html" | "xhtml";
-  language?: string;
-  base?: string;
-}
-
-interface Link {
-  href: string;
-  rel?: string;
-  type?: string;
-  title?: string;
-  length?: number;
-  hreflang?: string;
-}
-
-interface Person {
-  name?: string;
-  email?: string;
-  uri?: string;
-}
-
-interface Tag {
-  term: string;
-  scheme?: string;
-  label?: string;
-}
-
-interface Image {
-  url: string;
-  title?: string;
-  link?: string;
-  width?: number;
-  height?: number;
-  description?: string;
-}
-
-interface Enclosure {
-  url: string;
-  length?: number;
-  type?: string;
-}
-
-interface Content {
-  value: string;
-  type?: string;
-  language?: string;
-  base?: string;
-}
-
-interface Generator {
-  value: string;
-  uri?: string;
-  version?: string;
-}
-
-interface Source {
-  title?: string;
-  link?: string;
-  id?: string;
-}
-```
+> [!NOTE]
+> See `index.d.ts` for complete type definitions including `Link`, `Person`, `Tag`, `Image`, `Enclosure`, and more.
 
 ## Error Handling
 
@@ -248,11 +190,9 @@ console.log(feed.feed.title);  // "Broken"
 
 ## Dates
 
-All date fields are returned as milliseconds since Unix epoch (number type). Convert to JavaScript Date:
+All date fields are returned as milliseconds since Unix epoch. Convert to JavaScript Date:
 
 ```javascript
-const feed = parse(xmlWithDates);
-
 const entry = feed.entries[0];
 if (entry.published) {
   const date = new Date(entry.published);
@@ -262,23 +202,35 @@ if (entry.published) {
 
 ## Performance
 
-Benchmarks vs Python feedparser (parsing 100KB RSS feed):
+Benchmarks on Apple M1 Pro:
+
+| Feed Size | Time | Throughput |
+|-----------|------|------------|
+| Small (2 KB) | 0.01 ms | 187 MB/s |
+| Medium (20 KB) | 0.09 ms | 214 MB/s |
+| Large (200 KB) | 0.94 ms | 213 MB/s |
+
+### vs Python feedparser
 
-| Library | Time | Speedup |
-|---------|------|---------|
-| feedparser-rs | 0.5ms | 100x |
-| feedparser (Python) | 50ms | 1x |
+| Operation | feedparser-rs | Python feedparser | Speedup |
+|-----------|---------------|-------------------|---------|
+| Parse 20 KB RSS | 0.09 ms | 8.5 ms | **94x** |
+| Parse 200 KB RSS | 0.94 ms | 85 ms | **90x** |
 
-See [benchmarks/](../../benchmarks/) for detailed results and methodology.
+> [!TIP]
+> For best performance, pass `Buffer` instead of `string` to avoid UTF-8 conversion overhead.
 
 ## Platform Support
 
 Pre-built binaries available for:
-- macOS (Intel & Apple Silicon)
-- Linux (x64, ARM64)
-- Windows (x64)
 
-Supported Node.js versions: 18, 20, 22
+| Platform | Architecture |
+|----------|--------------|
+| macOS | Intel (x64), Apple Silicon (arm64) |
+| Linux | x64, arm64 |
+| Windows | x64 |
+
+Supported Node.js versions: 18, 20, 22+
 
 ## Development
 
@@ -291,15 +243,23 @@ npm run build
 
 # Run tests
 npm test
+
+# Run tests with coverage
+npm run test:coverage
 ```
 
 ## License
 
-MIT OR Apache-2.0
+Licensed under either of:
+
+- [Apache License, Version 2.0](../../LICENSE-APACHE)
+- [MIT License](../../LICENSE-MIT)
+
+at your option.
 
 ## Links
 
 - [GitHub](https://github.com/bug-ops/feedparser-rs)
 - [npm](https://www.npmjs.com/package/feedparser-rs)
-- [Documentation](https://docs.rs/feedparser-rs-core)
+- [Rust API Documentation](https://docs.rs/feedparser-rs)
 - [Changelog](../../CHANGELOG.md)

package/index.d.ts

@@ -81,6 +81,12 @@ export interface Entry {
   comments?: string
   /** Source feed reference */
   source?: Source
+  /** Podcast transcripts */
+  podcastTranscripts: Array<PodcastTranscript>
+  /** Podcast persons */
+  podcastPersons: Array<PodcastPerson>
+  /** License URL (Creative Commons, etc.) */
+  license?: string
 }
 
 /** Feed metadata */
@@ -99,6 +105,8 @@ export interface FeedMeta {
   subtitleDetail?: TextConstruct
   /** Last update date (milliseconds since epoch) */
   updated?: number
+  /** Initial publication date (milliseconds since epoch) */
+  published?: number
   /** Primary author name */
   author?: string
   /** Detailed author information */
@@ -133,6 +141,16 @@ export interface FeedMeta {
   id?: string
   /** Time-to-live (update frequency hint) in minutes */
   ttl?: number
+  /** License URL (Creative Commons, etc.) */
+  license?: string
+  /** Syndication module metadata (RSS 1.0) */
+  syndication?: SyndicationMeta
+  /** Dublin Core creator (author fallback) */
+  dcCreator?: string
+  /** Dublin Core publisher */
+  dcPublisher?: string
+  /** Dublin Core rights (copyright) */
+  dcRights?: string
 }
 
 /** Generator metadata */
@@ -214,8 +232,87 @@ export interface ParsedFeed {
   version: string
   /** XML namespaces (prefix -> URI) */
   namespaces: Record<string, string>
+  /** HTTP status code (if fetched from URL) */
+  status?: number
+  /** Final URL after redirects (if fetched from URL) */
+  href?: string
+  /** ETag header from HTTP response */
+  etag?: string
+  /** Last-Modified header from HTTP response */
+  modified?: string
+  /** HTTP response headers (if fetched from URL) */
+  headers?: Record<string, string>
 }
 
+/**
+ * Parse feed from HTTP/HTTPS URL with conditional GET support
+ *
+ * Fetches the feed from the given URL and parses it. Supports conditional GET
+ * using ETag and Last-Modified headers for bandwidth-efficient caching.
+ *
+ * # Arguments
+ *
+ * * `url` - HTTP or HTTPS URL to fetch
+ * * `etag` - Optional ETag from previous fetch for conditional GET
+ * * `modified` - Optional Last-Modified timestamp from previous fetch
+ * * `user_agent` - Optional custom User-Agent header
+ *
+ * # Returns
+ *
+ * Parsed feed result with HTTP metadata fields populated:
+ * - `status`: HTTP status code (200, 304, etc.)
+ * - `href`: Final URL after redirects
+ * - `etag`: ETag header value (for next request)
+ * - `modified`: Last-Modified header value (for next request)
+ * - `headers`: Full HTTP response headers
+ *
+ * On 304 Not Modified, returns a feed with empty entries but status=304.
+ *
+ * # Examples
+ *
+ * ```javascript
+ * const feedparser = require('feedparser-rs');
+ *
+ * // First fetch
+ * const feed = await feedparser.parseUrl("https://example.com/feed.xml");
+ * console.log(feed.feed.title);
+ * console.log(`ETag: ${feed.etag}`);
+ *
+ * // Subsequent fetch with caching
+ * const feed2 = await feedparser.parseUrl(
+ *   "https://example.com/feed.xml",
+ *   feed.etag,
+ *   feed.modified
+ * );
+ *
+ * if (feed2.status === 304) {
+ *   console.log("Feed not modified, use cached version");
+ * }
+ * ```
+ */
+export declare function parseUrl(url: string, etag?: string | undefined | null, modified?: string | undefined | null, userAgent?: string | undefined | null): ParsedFeed
+
+/**
+ * Parse feed from URL with custom resource limits
+ *
+ * Like `parseUrl` but allows specifying custom limits for DoS protection.
+ *
+ * # Examples
+ *
+ * ```javascript
+ * const feedparser = require('feedparser-rs');
+ *
+ * const feed = await feedparser.parseUrlWithOptions(
+ *   "https://example.com/feed.xml",
+ *   null, // etag
+ *   null, // modified
+ *   null, // user_agent
+ *   10485760 // max_size: 10MB
+ * );
+ * ```
+ */
+export declare function parseUrlWithOptions(url: string, etag?: string | undefined | null, modified?: string | undefined | null, userAgent?: string | undefined | null, maxSize?: number | undefined | null): ParsedFeed
+
 /**
  * Parse an RSS/Atom/JSON Feed with custom size limit
  *
@@ -244,6 +341,32 @@ export interface Person {
   uri?: string
 }
 
+/** Podcast person metadata */
+export interface PodcastPerson {
+  /** Person's name */
+  name: string
+  /** Person's role (e.g., "host", "guest") */
+  role?: string
+  /** Person's group (e.g., "cast", "crew") */
+  group?: string
+  /** Person's image URL */
+  img?: string
+  /** Person's URL/website */
+  href?: string
+}
+
+/** Podcast transcript metadata */
+export interface PodcastTranscript {
+  /** Transcript URL */
+  url: string
+  /** Transcript type (e.g., "text/plain", "application/srt") */
+  type?: string
+  /** Transcript language */
+  language?: string
+  /** Relationship type (e.g., "captions", "chapters") */
+  rel?: string
+}
+
 /** Source reference (for entries) */
 export interface Source {
   /** Source title */
@@ -254,6 +377,16 @@ export interface Source {
   id?: string
 }
 
+/** Syndication module metadata (RSS 1.0) */
+export interface SyndicationMeta {
+  /** Update period (hourly, daily, weekly, monthly, yearly) */
+  updatePeriod?: string
+  /** Number of times updated per period */
+  updateFrequency?: number
+  /** Base date for update schedule (ISO 8601) */
+  updateBase?: string
+}
+
 /** Tag/category */
 export interface Tag {
   /** Tag term/label */

package/index.js

@@ -77,8 +77,8 @@ function requireNative() {
       try {
         const binding = require('feedparser-rs-android-arm64')
         const bindingPackageVersion = require('feedparser-rs-android-arm64/package.json').version
-        if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.2.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.2.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -93,8 +93,8 @@ function requireNative() {
       try {
         const binding = require('feedparser-rs-android-arm-eabi')
         const bindingPackageVersion = require('feedparser-rs-android-arm-eabi/package.json').version
-        if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.2.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.2.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -114,8 +114,8 @@ function requireNative() {
       try {
         const binding = require('feedparser-rs-win32-x64-gnu')
         const bindingPackageVersion = require('feedparser-rs-win32-x64-gnu/package.json').version
-        if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.2.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.2.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -130,8 +130,8 @@ function requireNative() {
       try {
         const binding = require('feedparser-rs-win32-x64-msvc')
         const bindingPackageVersion = require('feedparser-rs-win32-x64-msvc/package.json').version
-        if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.2.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.2.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -147,8 +147,8 @@ function requireNative() {
       try {
         const binding = require('feedparser-rs-win32-ia32-msvc')
         const bindingPackageVersion = require('feedparser-rs-win32-ia32-msvc/package.json').version
-        if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.2.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.2.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -163,8 +163,8 @@ function requireNative() {
       try {
         const binding = require('feedparser-rs-win32-arm64-msvc')
         const bindingPackageVersion = require('feedparser-rs-win32-arm64-msvc/package.json').version
-        if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.2.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.2.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -182,8 +182,8 @@ function requireNative() {
     try {
       const binding = require('feedparser-rs-darwin-universal')
       const bindingPackageVersion = require('feedparser-rs-darwin-universal/package.json').version
-      if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-        throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+      if (bindingPackageVersion !== '0.2.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+        throw new Error(`Native binding package version mismatch, expected 0.2.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
       }
       return binding
     } catch (e) {
@@ -198,8 +198,8 @@ function requireNative() {
       try {
         const binding = require('feedparser-rs-darwin-x64')
         const bindingPackageVersion = require('feedparser-rs-darwin-x64/package.json').version
-        if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.2.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.2.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -214,8 +214,8 @@ function requireNative() {
       try {
         const binding = require('feedparser-rs-darwin-arm64')
         const bindingPackageVersion = require('feedparser-rs-darwin-arm64/package.json').version
-        if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.2.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.2.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -234,8 +234,8 @@ function requireNative() {
       try {
         const binding = require('feedparser-rs-freebsd-x64')
         const bindingPackageVersion = require('feedparser-rs-freebsd-x64/package.json').version
-        if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.2.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.2.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -250,8 +250,8 @@ function requireNative() {
       try {
         const binding = require('feedparser-rs-freebsd-arm64')
         const bindingPackageVersion = require('feedparser-rs-freebsd-arm64/package.json').version
-        if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.2.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.2.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -271,8 +271,8 @@ function requireNative() {
         try {
           const binding = require('feedparser-rs-linux-x64-musl')
           const bindingPackageVersion = require('feedparser-rs-linux-x64-musl/package.json').version
-          if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.2.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.2.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -287,8 +287,8 @@ function requireNative() {
         try {
           const binding = require('feedparser-rs-linux-x64-gnu')
           const bindingPackageVersion = require('feedparser-rs-linux-x64-gnu/package.json').version
-          if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.2.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.2.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -305,8 +305,8 @@ function requireNative() {
         try {
           const binding = require('feedparser-rs-linux-arm64-musl')
           const bindingPackageVersion = require('feedparser-rs-linux-arm64-musl/package.json').version
-          if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.2.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.2.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -321,8 +321,8 @@ function requireNative() {
         try {
           const binding = require('feedparser-rs-linux-arm64-gnu')
           const bindingPackageVersion = require('feedparser-rs-linux-arm64-gnu/package.json').version
-          if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.2.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.2.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -339,8 +339,8 @@ function requireNative() {
         try {
           const binding = require('feedparser-rs-linux-arm-musleabihf')
           const bindingPackageVersion = require('feedparser-rs-linux-arm-musleabihf/package.json').version
-          if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.2.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.2.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -355,8 +355,8 @@ function requireNative() {
         try {
           const binding = require('feedparser-rs-linux-arm-gnueabihf')
           const bindingPackageVersion = require('feedparser-rs-linux-arm-gnueabihf/package.json').version
-          if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.2.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.2.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -373,8 +373,8 @@ function requireNative() {
         try {
           const binding = require('feedparser-rs-linux-loong64-musl')
           const bindingPackageVersion = require('feedparser-rs-linux-loong64-musl/package.json').version
-          if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.2.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.2.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -389,8 +389,8 @@ function requireNative() {
         try {
           const binding = require('feedparser-rs-linux-loong64-gnu')
           const bindingPackageVersion = require('feedparser-rs-linux-loong64-gnu/package.json').version
-          if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.2.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.2.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -407,8 +407,8 @@ function requireNative() {
         try {
           const binding = require('feedparser-rs-linux-riscv64-musl')
           const bindingPackageVersion = require('feedparser-rs-linux-riscv64-musl/package.json').version
-          if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.2.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.2.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -423,8 +423,8 @@ function requireNative() {
         try {
           const binding = require('feedparser-rs-linux-riscv64-gnu')
           const bindingPackageVersion = require('feedparser-rs-linux-riscv64-gnu/package.json').version
-          if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.2.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.2.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -440,8 +440,8 @@ function requireNative() {
       try {
         const binding = require('feedparser-rs-linux-ppc64-gnu')
         const bindingPackageVersion = require('feedparser-rs-linux-ppc64-gnu/package.json').version
-        if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.2.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.2.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -456,8 +456,8 @@ function requireNative() {
       try {
         const binding = require('feedparser-rs-linux-s390x-gnu')
         const bindingPackageVersion = require('feedparser-rs-linux-s390x-gnu/package.json').version
-        if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.2.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.2.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -476,8 +476,8 @@ function requireNative() {
       try {
         const binding = require('feedparser-rs-openharmony-arm64')
         const bindingPackageVersion = require('feedparser-rs-openharmony-arm64/package.json').version
-        if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.2.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.2.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -492,8 +492,8 @@ function requireNative() {
       try {
         const binding = require('feedparser-rs-openharmony-x64')
         const bindingPackageVersion = require('feedparser-rs-openharmony-x64/package.json').version
-        if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.2.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.2.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -508,8 +508,8 @@ function requireNative() {
       try {
         const binding = require('feedparser-rs-openharmony-arm')
         const bindingPackageVersion = require('feedparser-rs-openharmony-arm/package.json').version
-        if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.2.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.2.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -574,4 +574,6 @@ if (!nativeBinding) {
 module.exports = nativeBinding
 module.exports.detectFormat = nativeBinding.detectFormat
 module.exports.parse = nativeBinding.parse
+module.exports.parseUrl = nativeBinding.parseUrl
+module.exports.parseUrlWithOptions = nativeBinding.parseUrlWithOptions
 module.exports.parseWithOptions = nativeBinding.parseWithOptions

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "feedparser-rs",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "High-performance RSS/Atom/JSON Feed parser for Node.js",
   "main": "index.js",
   "types": "index.d.ts",
@@ -47,4 +47,4 @@
     "@napi-rs/cli": "^3.5",
     "c8": "^10.1.3"
   }
-}
+}