feedparser-rs 0.2.1 → 0.4.0

package/README.md

@@ -202,12 +202,23 @@ if (entry.published) {
 
 ## Performance
 
-Benchmarks vs Python feedparser (parsing 100KB RSS feed):
+Benchmarks on Apple M1 Pro:
 
-| Library | Time | Speedup |
-|---------|------|---------|
-| feedparser-rs | 0.5ms | 100x |
-| feedparser (Python) | 50ms | 1x |
+| 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
+
+| 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** |
+
+> [!TIP]
+> For best performance, pass `Buffer` instead of `string` to avoid UTF-8 conversion overhead.
 
 ## Platform Support
 

package/index.d.ts

@@ -81,6 +81,30 @@ 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
+  /** Geographic location (GeoRSS) */
+  geo?: GeoLocation
+  /** Dublin Core creator (author) */
+  dcCreator?: string
+  /** Dublin Core date (milliseconds since epoch) */
+  dcDate?: number
+  /** Dublin Core subject tags */
+  dcSubject: Array<string>
+  /** Dublin Core rights (copyright) */
+  dcRights?: string
+  /** Media RSS thumbnails */
+  mediaThumbnails: Array<MediaThumbnail>
+  /** Media RSS content */
+  mediaContent: Array<MediaContent>
+  /** iTunes episode metadata */
+  itunes?: ItunesEntryMeta
+  /** Podcast 2.0 episode metadata */
+  podcast?: PodcastEntryMeta
 }
 
 /** Feed metadata */
@@ -99,6 +123,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 +159,22 @@ 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
+  /** Geographic location (GeoRSS) */
+  geo?: GeoLocation
+  /** iTunes podcast metadata */
+  itunes?: ItunesFeedMeta
+  /** Podcast 2.0 metadata */
+  podcast?: PodcastMeta
 }
 
 /** Generator metadata */
@@ -145,6 +187,24 @@ export interface Generator {
   version?: string
 }
 
+/** Geographic location from GeoRSS namespace */
+export interface GeoLocation {
+  /** Type of geographic shape ("point", "line", "polygon", "box") */
+  geoType: string
+  /**
+   * Coordinate pairs as nested array [[lat, lng], ...]
+   *
+   * Format depends on geo_type:
+   * - "point": Single pair [[lat, lng]]
+   * - "line": Two or more pairs [[lat1, lng1], [lat2, lng2], ...]
+   * - "box": Two pairs [[lower-left-lat, lower-left-lng], [upper-right-lat, upper-right-lng]]
+   * - "polygon": Three or more pairs forming a closed shape [[lat1, lng1], ..., [lat1, lng1]]
+   */
+  coordinates: Array<Array<number>>
+  /** Coordinate Reference System (e.g., "EPSG:4326" for WGS84 latitude/longitude) */
+  crs?: string
+}
+
 /** Image metadata */
 export interface Image {
   /** Image URL */
@@ -161,6 +221,80 @@ export interface Image {
   description?: string
 }
 
+/** iTunes category */
+export interface ItunesCategory {
+  /** Category text */
+  text: string
+  /** Subcategory */
+  subcategory?: string
+}
+
+/** iTunes episode metadata */
+export interface ItunesEntryMeta {
+  /** Episode title override */
+  title?: string
+  /** Episode author */
+  author?: string
+  /**
+   * Episode duration in seconds
+   *
+   * Parsed from various formats: "3600", "60:00", "1:00:00"
+   */
+  duration?: number
+  /** Explicit content flag for this episode */
+  explicit?: boolean
+  /**
+   * Episode-specific artwork URL
+   *
+   * Note: URL from untrusted feed input. Validate before fetching.
+   */
+  image?: string
+  /** Episode number */
+  episode?: number
+  /** Season number */
+  season?: number
+  /** Episode type: "full", "trailer", or "bonus" */
+  episodeType?: string
+}
+
+/** iTunes podcast feed metadata */
+export interface ItunesFeedMeta {
+  /** Podcast author */
+  author?: string
+  /** Podcast owner information */
+  owner?: ItunesOwner
+  /** Podcast categories */
+  categories: Array<ItunesCategory>
+  /** Explicit content flag */
+  explicit?: boolean
+  /**
+   * Podcast artwork URL
+   *
+   * Note: URL from untrusted feed input. Validate before fetching.
+   */
+  image?: string
+  /** Podcast keywords */
+  keywords: Array<string>
+  /** Podcast type (episodic/serial) */
+  podcastType?: string
+  /** Podcast completion status */
+  complete?: boolean
+  /**
+   * New feed URL for migrated podcasts
+   *
+   * Note: URL from untrusted feed input. Validate before fetching.
+   */
+  newFeedUrl?: string
+}
+
+/** iTunes owner information */
+export interface ItunesOwner {
+  /** Owner name */
+  name?: string
+  /** Owner email */
+  email?: string
+}
+
 /** Link in feed or entry */
 export interface Link {
   /** Link URL */
@@ -177,6 +311,40 @@ export interface Link {
   hreflang?: string
 }
 
+/** Media RSS content */
+export interface MediaContent {
+  /**
+   * Media URL
+   *
+   * Note: URL from untrusted feed input. Validate before fetching.
+   */
+  url: string
+  /** MIME type */
+  type?: string
+  /** File size in bytes (converted from u64 with i64::MAX cap) */
+  filesize?: number
+  /** Width in pixels */
+  width?: number
+  /** Height in pixels */
+  height?: number
+  /** Duration in seconds (converted from u64 with i64::MAX cap) */
+  duration?: number
+}
+
+/** Media RSS thumbnail */
+export interface MediaThumbnail {
+  /**
+   * Thumbnail URL
+   *
+   * Note: URL from untrusted feed input. Validate before fetching.
+   */
+  url: string
+  /** Width in pixels */
+  width?: number
+  /** Height in pixels */
+  height?: number
+}
+
 /**
  * Parse an RSS/Atom/JSON Feed from bytes or string
  *
@@ -214,8 +382,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 +491,130 @@ export interface Person {
   uri?: string
 }
 
+/** Podcast chapters */
+export interface PodcastChapters {
+  /**
+   * Chapters URL
+   *
+   * Note: URL from untrusted feed input. Validate before fetching.
+   */
+  url: string
+  /** Chapters MIME type (e.g., "application/json+chapters", "application/xml+chapters") */
+  type: string
+}
+
+/** Podcast 2.0 episode metadata */
+export interface PodcastEntryMeta {
+  /** Episode transcripts */
+  transcript: Array<PodcastTranscript>
+  /** Episode chapters */
+  chapters?: PodcastChapters
+  /** Episode soundbites */
+  soundbite: Array<PodcastSoundbite>
+  /** Episode persons */
+  person: Array<PodcastPerson>
+}
+
+/** Podcast funding link */
+export interface PodcastFunding {
+  /**
+   * Funding URL
+   *
+   * Note: URL from untrusted feed input. Validate before fetching.
+   */
+  url: string
+  /** Funding message */
+  message?: string
+}
+
+/** Podcast 2.0 namespace metadata (feed level) */
+export interface PodcastMeta {
+  /** Podcast transcripts */
+  transcripts: Array<PodcastTranscript>
+  /** Podcast funding links */
+  funding: Array<PodcastFunding>
+  /** Podcast persons (hosts, etc.) */
+  persons: Array<PodcastPerson>
+  /** Podcast GUID */
+  guid?: string
+  /** Value-for-value payment information */
+  value?: PodcastValue
+}
+
+/** 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
+   *
+   * Note: URL from untrusted feed input. Validate before fetching.
+   */
+  img?: string
+  /**
+   * Person's URL/website
+   *
+   * Note: URL from untrusted feed input. Validate before fetching.
+   */
+  href?: string
+}
+
+/** Podcast soundbite */
+export interface PodcastSoundbite {
+  /** Start time in seconds */
+  startTime: number
+  /** Duration in seconds */
+  duration: number
+  /** Title */
+  title?: string
+}
+
+/** Podcast transcript metadata */
+export interface PodcastTranscript {
+  /**
+   * Transcript URL
+   *
+   * Note: URL from untrusted feed input. Validate before fetching.
+   */
+  url: string
+  /** Transcript type (e.g., "text/plain", "application/srt") */
+  type?: string
+  /** Transcript language */
+  language?: string
+  /** Relationship type (e.g., "captions", "chapters") */
+  rel?: string
+}
+
+/** Podcast 2.0 value element for monetization */
+export interface PodcastValue {
+  /** Payment type: "lightning", "hive", etc. */
+  type: string
+  /** Payment method: "keysend" for Lightning Network */
+  method: string
+  /** Suggested payment amount */
+  suggested?: string
+  /** List of payment recipients with split percentages */
+  recipients: Array<PodcastValueRecipient>
+}
+
+/** Value recipient for payment splitting */
+export interface PodcastValueRecipient {
+  /** Recipient's name */
+  name?: string
+  /** Recipient type: "node" for Lightning Network nodes */
+  type: string
+  /** Payment address (e.g., Lightning node public key) */
+  address: string
+  /** Payment split percentage */
+  split: number
+  /** Whether this is a fee recipient */
+  fee?: boolean
+}
+
 /** Source reference (for entries) */
 export interface Source {
   /** Source title */
@@ -254,6 +625,22 @@ export interface Source {
   id?: string
 }
 
+/** Syndication module metadata (RSS 1.0) */
+export interface SyndicationMeta {
+  /**
+   * Update period (hourly, daily, weekly, monthly, yearly)
+   *
+   * # Example
+   *
+   * "daily" with updateFrequency: 2 means the feed updates twice per day
+   */
+  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.3.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.3.0 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.3.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.3.0 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.3.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.3.0 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.3.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.3.0 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.3.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.3.0 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.3.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.3.0 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.3.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.3.0 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.3.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.3.0 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.3.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.3.0 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.3.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.3.0 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.3.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.3.0 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.3.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.3.0 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.3.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.3.0 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.3.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.3.0 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.3.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.3.0 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.3.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.3.0 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.3.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.3.0 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.3.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.3.0 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.3.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.3.0 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.3.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.3.0 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.3.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.3.0 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.3.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.3.0 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.3.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.3.0 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.3.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.3.0 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.3.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.3.0 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.3.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.3.0 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.1",
+  "version": "0.4.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"
   }
-}
+}