Implement Android RSS/Atom feed parser

- Add FeedParser.kt with automatic feed type detection - Add RSSParser.kt for RSS 2.0 feeds - Add AtomParser.kt for Atom 1.0 feeds - Add comprehensive unit tests for both parsers - Support iTunes namespace and enclosures - Fix pre-existing compilation issues in the codebase - Update build.gradle.kts with proper dependencies and AGP 8.5.0
2026-03-30 09:01:49 -04:00
parent ac5250b2af
commit d84b8ff4e8
19 changed files with 1555 additions and 18 deletions
--- a/native-route/android/src/main/java/com/rssuper/converters/FeedItemListConverter.kt
+++ b/native-route/android/src/main/java/com/rssuper/converters/FeedItemListConverter.kt
@@ -18,6 +18,6 @@ class FeedItemListConverter {

    @TypeConverter
    fun toFeedItemList(value: String?): List<FeedItem>? {
-        return value?.let { adapter.fromJson(it) }
+        return value?.let { adapter.fromJson(it) as? List<FeedItem> }
    }
 }
--- a/native-route/android/src/main/java/com/rssuper/models/ReadingPreferences.kt
+++ b/native-route/android/src/main/java/com/rssuper/models/ReadingPreferences.kt
@@ -4,6 +4,7 @@ import android.os.Parcelable
 import androidx.room.Entity
 import androidx.room.PrimaryKey
 import kotlinx.parcelize.Parcelize
+import kotlinx.parcelize.RawValue
 import com.squareup.moshi.Json
 import com.squareup.moshi.JsonClass

@@ -15,10 +16,10 @@ data class ReadingPreferences(
    val id: String = "default",
    
    @Json(name = "fontSize")
-    val fontSize: FontSize = FontSize.MEDIUM,
+    val fontSize: @RawValue FontSize = FontSize.MEDIUM,
    
    @Json(name = "lineHeight")
-    val lineHeight: LineHeight = LineHeight.NORMAL,
+    val lineHeight: @RawValue LineHeight = LineHeight.NORMAL,
    
    @Json(name = "showTableOfContents")
    val showTableOfContents: Boolean = false,
--- a/native-route/android/src/main/java/com/rssuper/models/SearchFilters.kt
+++ b/native-route/android/src/main/java/com/rssuper/models/SearchFilters.kt
@@ -7,6 +7,7 @@ import androidx.room.TypeConverters
 import com.rssuper.converters.DateConverter
 import com.rssuper.converters.StringListConverter
 import kotlinx.parcelize.Parcelize
+import kotlinx.parcelize.RawValue
 import com.squareup.moshi.Json
 import com.squareup.moshi.JsonClass
 import java.util.Date
@@ -32,10 +33,10 @@ data class SearchFilters(
    val authors: List<String>? = null,
    
    @Json(name = "contentType")
-    val contentType: ContentType? = null,
+    val contentType: @RawValue ContentType? = null,
    
    @Json(name = "sortOption")
-    val sortOption: SearchSortOption = SearchSortOption.RELEVANCE
+    val sortOption: @RawValue SearchSortOption = SearchSortOption.RELEVANCE
 ) : Parcelable

 sealed class ContentType(val value: String) {
--- a/native-route/android/src/main/java/com/rssuper/parsing/AtomParser.kt
+++ b/native-route/android/src/main/java/com/rssuper/parsing/AtomParser.kt
@@ -0,0 +1,240 @@
+package com.rssuper.parsing
+
+import com.rssuper.models.Enclosure
+import com.rssuper.models.Feed
+import com.rssuper.models.FeedItem
+import org.xmlpull.v1.XmlPullParser
+import org.xmlpull.v1.XmlPullParserFactory
+import java.io.StringReader
+
+object AtomParser {
+
+    private val ATOM_NS = "http://www.w3.org/2005/Atom"
+    private val ITUNES_NS = "http://www.itunes.com/dtds/podcast-1.0.dtd"
+    private val MEDIA_NS = "http://search.yahoo.com/mrss/"
+
+    fun parse(xml: String, feedUrl: String): Feed {
+        val factory = XmlPullParserFactory.newInstance()
+        factory.isNamespaceAware = true
+        val parser = factory.newPullParser()
+        parser.setInput(StringReader(xml))
+
+        var title: String? = null
+        var link: String? = null
+        var subtitle: String? = null
+        var updated: java.util.Date? = null
+        var generator: String? = null
+        val items = mutableListOf<FeedItem>()
+
+        var currentItem: MutableMap<String, Any?>? = null
+        var currentTag: String? = null
+        var inContent = false
+
+        var eventType = parser.eventType
+        while (eventType != XmlPullParser.END_DOCUMENT) {
+            when (eventType) {
+                XmlPullParser.START_TAG -> {
+                    val tagName = parser.name
+                    val namespace = parser.namespace
+
+                    when {
+                        tagName == "feed" -> {}
+                        tagName == "entry" -> {
+                            currentItem = mutableMapOf()
+                        }
+                        tagName == "title" -> {
+                            currentTag = tagName
+                            inContent = true
+                        }
+                        tagName == "link" -> {
+                            val href = parser.getAttributeValue(null, "href")
+                            val rel = parser.getAttributeValue(null, "rel")
+                            if (href != null) {
+                                if (currentItem != null) {
+                                    if (rel == "alternate" || rel == null) {
+                                        currentItem["link"] = href
+                                    } else if (rel == "enclosure") {
+                                        val type = parser.getAttributeValue(null, "type") ?: "application/octet-stream"
+                                        val length = parser.getAttributeValue(null, "length")?.toLongOrNull()
+                                        currentItem["enclosure"] = Enclosure(href, type, length)
+                                    }
+                                } else {
+                                    if (rel == "alternate" || rel == null) {
+                                        link = href
+                                    }
+                                }
+                            }
+                            currentTag = null
+                            inContent = false
+                        }
+                        tagName == "subtitle" -> {
+                            currentTag = tagName
+                            inContent = true
+                        }
+                        tagName == "summary" -> {
+                            currentTag = tagName
+                            inContent = true
+                        }
+                        tagName == "content" -> {
+                            currentTag = tagName
+                            inContent = true
+                        }
+                        tagName == "updated" || tagName == "published" -> {
+                            currentTag = tagName
+                            inContent = true
+                        }
+                        tagName == "name" -> {
+                            currentTag = tagName
+                            inContent = true
+                        }
+                        tagName == "uri" -> {
+                            currentTag = tagName
+                            inContent = true
+                        }
+                        tagName == "id" -> {
+                            currentTag = tagName
+                            inContent = true
+                        }
+                        tagName == "category" -> {
+                            val term = parser.getAttributeValue(null, "term")
+                            if (term != null && currentItem != null) {
+                                val cats = currentItem["categories"] as? MutableList<String> ?: mutableListOf()
+                                cats.add(term)
+                                currentItem["categories"] = cats
+                            }
+                            currentTag = null
+                            inContent = false
+                        }
+                        tagName == "generator" -> {
+                            currentTag = tagName
+                            inContent = true
+                        }
+                        tagName == "summary" && namespace == ITUNES_NS -> {
+                            if (currentItem != null) {
+                                currentItem["itunesSummary"] = readElementText(parser)
+                            }
+                        }
+                        tagName == "image" && namespace == ITUNES_NS -> {
+                            val href = parser.getAttributeValue(null, "href")
+                            if (href != null && currentItem != null) {
+                                currentItem["image"] = href
+                            }
+                        }
+                        tagName == "duration" && namespace == ITUNES_NS -> {
+                            currentItem?.put("duration", readElementText(parser))
+                        }
+                        tagName == "thumbnail" && namespace == MEDIA_NS -> {
+                            val url = parser.getAttributeValue(null, "url")
+                            if (url != null && currentItem != null) {
+                                currentItem["mediaThumbnail"] = url
+                            }
+                        }
+                        tagName == "enclosure" && namespace == MEDIA_NS -> {
+                            val url = parser.getAttributeValue(null, "url")
+                            val type = parser.getAttributeValue(null, "type")
+                            val length = parser.getAttributeValue(null, "length")?.toLongOrNull()
+                            if (url != null && type != null && currentItem != null) {
+                                currentItem["enclosure"] = Enclosure(url, type, length)
+                            }
+                        }
+                        else -> {}
+                    }
+                }
+
+                XmlPullParser.TEXT -> {
+                    val text = parser.text?.xmlTrimmed() ?: ""
+                    if (text.isNotEmpty() && inContent) {
+                        if (currentItem != null) {
+                            when (currentTag) {
+                                "title" -> currentItem["title"] = text
+                                "summary" -> currentItem["summary"] = text
+                                "content" -> currentItem["content"] = text
+                                "name" -> currentItem["author"] = text
+                                "id" -> currentItem["guid"] = text
+                                "updated", "published" -> currentItem[currentTag] = text
+                            }
+                        } else {
+                            when (currentTag) {
+                                "title" -> title = text
+                                "subtitle" -> subtitle = text
+                                "id" -> if (title == null) title = text
+                                "updated" -> updated = XmlDateParser.parse(text)
+                                "generator" -> generator = text
+                            }
+                        }
+                    }
+                }
+
+                XmlPullParser.END_TAG -> {
+                    val tagName = parser.name
+                    if (tagName == "entry" && currentItem != null) {
+                        items.add(buildFeedItem(currentItem))
+                        currentItem = null
+                    }
+                    if (tagName == currentTag) {
+                        currentTag = null
+                        inContent = false
+                    }
+                }
+            }
+            eventType = parser.next()
+        }
+
+        return Feed(
+            id = generateUuid(),
+            title = title ?: "Untitled Feed",
+            link = link,
+            subtitle = subtitle,
+            description = subtitle,
+            updated = updated,
+            generator = generator,
+            items = items,
+            rawUrl = feedUrl,
+            lastFetchedAt = java.util.Date()
+        )
+    }
+
+    private fun readElementText(parser: XmlPullParser): String {
+        var text = ""
+        var eventType = parser.eventType
+        while (eventType != XmlPullParser.END_TAG) {
+            if (eventType == XmlPullParser.TEXT) {
+                text = parser.text.xmlDecoded()
+            }
+            eventType = parser.next()
+        }
+        return text.xmlTrimmed()
+    }
+
+    @Suppress("UNCHECKED_CAST")
+    private fun buildFeedItem(item: Map<String, Any?>): FeedItem {
+        val title = item["title"] as? String ?: "Untitled"
+        val link = item["link"] as? String
+        val summary = item["summary"] as? String
+        val content = item["content"] as? String ?: summary
+        val itunesSummary = item["itunesSummary"] as? String
+        val author = item["author"] as? String
+        val guid = item["guid"] as? String ?: link ?: generateUuid()
+        val categories = item["categories"] as? List<String>
+        val enclosure = item["enclosure"] as? Enclosure
+
+        val updatedStr = item["updated"] as? String
+        val publishedStr = item["published"] as? String
+        val published = XmlDateParser.parse(publishedStr ?: updatedStr)
+        val updated = XmlDateParser.parse(updatedStr)
+
+        return FeedItem(
+            id = generateUuid(),
+            title = title,
+            link = link,
+            description = summary ?: itunesSummary,
+            content = content,
+            author = author,
+            published = published,
+            updated = updated,
+            categories = categories,
+            enclosure = enclosure,
+            guid = guid
+        )
+    }
+}
--- a/native-route/android/src/main/java/com/rssuper/parsing/FeedParser.kt
+++ b/native-route/android/src/main/java/com/rssuper/parsing/FeedParser.kt
@@ -0,0 +1,67 @@
+package com.rssuper.parsing
+
+import com.rssuper.models.Feed
+import org.xmlpull.v1.XmlPullParser
+import org.xmlpull.v1.XmlPullParserFactory
+import java.io.StringReader
+import java.util.Date
+
+object FeedParser {
+
+    fun parse(xml: String, feedUrl: String): ParseResult {
+        val feedType = detectFeedType(xml)
+        
+        return when (feedType) {
+            FeedType.RSS -> {
+                val feed = RSSParser.parse(xml, feedUrl)
+                ParseResult(FeedType.RSS, feed)
+            }
+            FeedType.Atom -> {
+                val feed = AtomParser.parse(xml, feedUrl)
+                ParseResult(FeedType.Atom, feed)
+            }
+        }
+    }
+
+    fun parseAsync(xml: String, feedUrl: String, callback: (Result<ParseResult>) -> Unit) {
+        try {
+            val result = parse(xml, feedUrl)
+            callback(Result.success(result))
+        } catch (e: Exception) {
+            callback(Result.failure(e))
+        }
+    }
+
+    private fun detectFeedType(xml: String): FeedType {
+        val factory = XmlPullParserFactory.newInstance()
+        factory.isNamespaceAware = true
+        val parser = factory.newPullParser()
+        parser.setInput(StringReader(xml))
+
+        var eventType = parser.eventType
+        while (eventType != XmlPullParser.END_DOCUMENT) {
+            if (eventType == XmlPullParser.START_TAG) {
+                val tagName = parser.name
+                return when {
+                    tagName.equals("rss", ignoreCase = true) -> FeedType.RSS
+                    tagName.equals("feed", ignoreCase = true) -> FeedType.Atom
+                    tagName.equals("RDF", ignoreCase = true) -> FeedType.RSS
+                    else -> {
+                        val namespace = parser.namespace
+                        if (namespace != null && namespace.isNotEmpty()) {
+                            when {
+                                tagName.equals("rss", ignoreCase = true) -> FeedType.RSS
+                                tagName.equals("feed", ignoreCase = true) -> FeedType.Atom
+                                else -> throw FeedParsingError.UnsupportedFeedType
+                            }
+                        } else {
+                            throw FeedParsingError.UnsupportedFeedType
+                        }
+                    }
+                }
+            }
+            eventType = parser.next()
+        }
+        throw FeedParsingError.UnsupportedFeedType
+    }
+}
--- a/native-route/android/src/main/java/com/rssuper/parsing/FeedType.kt
+++ b/native-route/android/src/main/java/com/rssuper/parsing/FeedType.kt
@@ -0,0 +1,16 @@
+package com.rssuper.parsing
+
+sealed class FeedType(val value: String) {
+    data object RSS : FeedType("rss")
+    data object Atom : FeedType("atom")
+
+    companion object {
+        fun fromString(value: String): FeedType {
+            return when (value.lowercase()) {
+                "rss" -> RSS
+                "atom" -> Atom
+                else -> throw IllegalArgumentException("Unknown feed type: $value")
+            }
+        }
+    }
+}
--- a/native-route/android/src/main/java/com/rssuper/parsing/ParseResult.kt
+++ b/native-route/android/src/main/java/com/rssuper/parsing/ParseResult.kt
@@ -0,0 +1,13 @@
+package com.rssuper.parsing
+
+import com.rssuper.models.Feed
+
+data class ParseResult(
+    val feedType: FeedType,
+    val feed: Feed
+)
+
+sealed class FeedParsingError : Exception() {
+    data object UnsupportedFeedType : FeedParsingError()
+    data object MalformedXml : FeedParsingError()
+}
--- a/native-route/android/src/main/java/com/rssuper/parsing/RSSParser.kt
+++ b/native-route/android/src/main/java/com/rssuper/parsing/RSSParser.kt
@@ -0,0 +1,188 @@
+package com.rssuper.parsing
+
+import com.rssuper.models.Enclosure
+import com.rssuper.models.Feed
+import com.rssuper.models.FeedItem
+import org.xmlpull.v1.XmlPullParser
+import org.xmlpull.v1.XmlPullParserFactory
+import java.io.StringReader
+import java.util.Date
+
+object RSSParser {
+
+    private val ITUNES_NS = "http://www.itunes.com/dtds/podcast-1.0.dtd"
+    private val CONTENT_NS = "http://purl.org/rss/1.0/modules/content/"
+
+    fun parse(xml: String, feedUrl: String): Feed {
+        val factory = XmlPullParserFactory.newInstance()
+        factory.isNamespaceAware = true
+        val parser = factory.newPullParser()
+        parser.setInput(StringReader(xml))
+
+        var title: String? = null
+        var link: String? = null
+        var description: String? = null
+        var language: String? = null
+        var lastBuildDate: Date? = null
+        var generator: String? = null
+        var ttl: Int? = null
+        val items = mutableListOf<FeedItem>()
+
+        var currentItem: MutableMap<String, Any?>? = null
+        var currentTag: String? = null
+
+        var eventType = parser.eventType
+        while (eventType != XmlPullParser.END_DOCUMENT) {
+            when (eventType) {
+                XmlPullParser.START_TAG -> {
+                    val tagName = parser.name
+                    val namespace = parser.namespace
+
+                    when {
+                        tagName == "channel" -> {}
+                        tagName == "item" -> {
+                            currentItem = mutableMapOf()
+                        }
+                        tagName == "title" || tagName == "description" || 
+                        tagName == "link" || tagName == "author" || 
+                        tagName == "guid" || tagName == "pubDate" || 
+                        tagName == "category" || tagName == "enclosure" -> {
+                            currentTag = tagName
+                        }
+                        tagName == "language" -> currentTag = tagName
+                        tagName == "lastBuildDate" -> currentTag = tagName
+                        tagName == "generator" -> currentTag = tagName
+                        tagName == "ttl" -> currentTag = tagName
+                        
+                        tagName == "subtitle" && namespace == ITUNES_NS -> {
+                            if (currentItem == null) {
+                                description = readElementText(parser)
+                            }
+                        }
+                        tagName == "summary" && namespace == ITUNES_NS -> {
+                            currentItem?.put("description", readElementText(parser))
+                        }
+                        tagName == "duration" && namespace == ITUNES_NS -> {
+                            currentItem?.put("duration", readElementText(parser))
+                        }
+                        tagName == "image" && namespace == ITUNES_NS -> {
+                            val href = parser.getAttributeValue(null, "href")
+                            if (href != null && currentItem != null) {
+                                currentItem.put("image", href)
+                            }
+                        }
+                        tagName == "encoded" && namespace == CONTENT_NS -> {
+                            currentItem?.put("content", readElementText(parser))
+                        }
+                        else -> {}
+                    }
+
+                    if (tagName == "enclosure" && currentItem != null) {
+                        val url = parser.getAttributeValue(null, "url")
+                        val type = parser.getAttributeValue(null, "type")
+                        val length = parser.getAttributeValue(null, "length")?.toLongOrNull()
+                        if (url != null && type != null) {
+                            currentItem["enclosure"] = Enclosure(url, type, length)
+                        }
+                    }
+                }
+                
+                XmlPullParser.TEXT -> {
+                    val text = parser.text?.xmlTrimmed() ?: ""
+                    if (text.isNotEmpty()) {
+                        if (currentItem != null) {
+                            when (currentTag) {
+                                "title" -> currentItem["title"] = text
+                                "description" -> currentItem["description"] = text
+                                "link" -> currentItem["link"] = text
+                                "author" -> currentItem["author"] = text
+                                "guid" -> currentItem["guid"] = text
+                                "pubDate" -> currentItem["pubDate"] = text
+                                "category" -> {
+                                    val cats = currentItem["categories"] as? MutableList<String> ?: mutableListOf()
+                                    cats.add(text)
+                                    currentItem["categories"] = cats
+                                }
+                            }
+                        } else {
+                            when (currentTag) {
+                                "title" -> title = text
+                                "link" -> link = text
+                                "description" -> description = text
+                                "language" -> language = text
+                                "lastBuildDate" -> lastBuildDate = XmlDateParser.parse(text)
+                                "generator" -> generator = text
+                                "ttl" -> ttl = text.toIntOrNull()
+                            }
+                        }
+                    }
+                }
+                
+                XmlPullParser.END_TAG -> {
+                    val tagName = parser.name
+                    if (tagName == "item" && currentItem != null) {
+                        items.add(buildFeedItem(currentItem))
+                        currentItem = null
+                    }
+                    currentTag = null
+                }
+            }
+            eventType = parser.next()
+        }
+
+        return Feed(
+            id = generateUuid(),
+            title = title ?: "Untitled Feed",
+            link = link,
+            description = description,
+            language = language,
+            lastBuildDate = lastBuildDate,
+            generator = generator,
+            ttl = ttl,
+            items = items,
+            rawUrl = feedUrl,
+            lastFetchedAt = Date()
+        )
+    }
+
+    private fun readElementText(parser: XmlPullParser): String {
+        var text = ""
+        var eventType = parser.eventType
+        while (eventType != XmlPullParser.END_TAG) {
+            if (eventType == XmlPullParser.TEXT) {
+                text = parser.text.xmlDecoded()
+            }
+            eventType = parser.next()
+        }
+        return text.xmlTrimmed()
+    }
+
+    @Suppress("UNCHECKED_CAST")
+    private fun buildFeedItem(item: Map<String, Any?>): FeedItem {
+        val title = item["title"] as? String ?: "Untitled"
+        val link = item["link"] as? String
+        val description = item["description"] as? String
+        val content = item["content"] as? String ?: description
+        val author = item["author"] as? String
+        val guid = item["guid"] as? String ?: link ?: generateUuid()
+        val categories = item["categories"] as? List<String>
+        val enclosure = item["enclosure"] as? Enclosure
+
+        val pubDateStr = item["pubDate"] as? String
+        val published = XmlDateParser.parse(pubDateStr)
+
+        return FeedItem(
+            id = generateUuid(),
+            title = title,
+            link = link,
+            description = description,
+            content = content,
+            author = author,
+            published = published,
+            updated = published,
+            categories = categories,
+            enclosure = enclosure,
+            guid = guid
+        )
+    }
+}
--- a/native-route/android/src/main/java/com/rssuper/parsing/XmlParsingUtilities.kt
+++ b/native-route/android/src/main/java/com/rssuper/parsing/XmlParsingUtilities.kt
@@ -0,0 +1,154 @@
+package com.rssuper.parsing
+
+import java.text.SimpleDateFormat
+import java.util.Locale
+import java.util.TimeZone
+import java.util.UUID
+import java.util.regex.Pattern
+
+object XmlDateParser {
+    private val iso8601WithFractional: SimpleDateFormat by lazy {
+        SimpleDateFormat("yyyy-MM-dd'T'HH:mm:ss.SSSXXX", Locale.US).apply {
+            timeZone = TimeZone.getTimeZone("UTC")
+        }
+    }
+
+    private val iso8601: SimpleDateFormat by lazy {
+        SimpleDateFormat("yyyy-MM-dd'T'HH:mm:ssXXX", Locale.US).apply {
+            timeZone = TimeZone.getTimeZone("UTC")
+        }
+    }
+
+    private val dateFormats: List<SimpleDateFormat> by lazy {
+        listOf(
+            SimpleDateFormat("EEE, dd MMM yyyy HH:mm:ss Z", Locale.US),
+            SimpleDateFormat("EEE, dd MMM yyyy HH:mm Z", Locale.US),
+            SimpleDateFormat("yyyy-MM-dd'T'HH:mm:ssZ", Locale.US),
+            SimpleDateFormat("yyyy-MM-dd'T'HH:mm:ss.SSSZ", Locale.US),
+            SimpleDateFormat("yyyy-MM-dd HH:mm:ss Z", Locale.US),
+            SimpleDateFormat("yyyy-MM-dd", Locale.US)
+        ).map {
+            SimpleDateFormat(it.toPattern(), Locale.US).apply {
+                timeZone = TimeZone.getTimeZone("UTC")
+            }
+        }
+    }
+
+    fun parse(value: String?): java.util.Date? {
+        val trimmed = value?.xmlTrimmed() ?: return null
+        if (trimmed.isEmpty()) return null
+
+        return try {
+            iso8601WithFractional.parse(trimmed)
+        } catch (e: Exception) {
+            try {
+                iso8601.parse(trimmed)
+            } catch (e: Exception) {
+                for (format in dateFormats) {
+                    try {
+                        return format.parse(trimmed)
+                    } catch (e: Exception) {
+                        continue
+                    }
+                }
+                null
+            }
+        }
+    }
+}
+
+fun String.xmlTrimmed(): String = this.trim { it <= ' ' }
+
+fun String.xmlNilIfEmpty(): String? {
+    val trimmed = this.xmlTrimmed()
+    return if (trimmed.isEmpty()) null else trimmed
+}
+
+fun String.xmlDecoded(): String {
+    return this
+        .replace(Regex("<!\\[CDATA\\[", RegexOption.IGNORE_CASE), "")
+        .replace(Regex("\\]\\]>", RegexOption.IGNORE_CASE), "")
+        .replace("&lt;", "<")
+        .replace("&gt;", ">")
+        .replace("&amp;", "&")
+        .replace("&quot;", "\"")
+        .replace("&apos;", "'")
+        .replace("&#39;", "'")
+        .replace("&#x27;", "'")
+}
+
+fun xmlInt64(value: String?): Long? {
+    val trimmed = value?.xmlTrimmed() ?: return null
+    if (trimmed.isEmpty()) return null
+    return trimmed.toLongOrNull()
+}
+
+fun xmlInt(value: String?): Int? {
+    val trimmed = value?.xmlTrimmed() ?: return null
+    if (trimmed.isEmpty()) return null
+    return trimmed.toIntOrNull()
+}
+
+fun xmlFirstTagValue(tag: String, inXml: String): String? {
+    val pattern = Pattern.compile("(?is)<(?:\\w+:)?$tag\\b[^>]*>(.*?)</(?:\\w+:)?$tag}>", Pattern.CASE_INSENSITIVE)
+    val matcher = pattern.matcher(inXml)
+    return if (matcher.find()) {
+        matcher.group(1)?.xmlDecoded()?.xmlTrimmed()
+    } else {
+        null
+    }
+}
+
+fun xmlAllTagValues(tag: String, inXml: String): List<String> {
+    val pattern = Pattern.compile("(?is)<(?:\\w+:)?$tag\\b[^>]*>(.*?)</(?:\\w+:)?$tag}>", Pattern.CASE_INSENSITIVE)
+    val matcher = pattern.matcher(inXml)
+    val results = mutableListOf<String>()
+    while (matcher.find()) {
+        matcher.group(1)?.xmlDecoded()?.xmlTrimmed()?.let { value ->
+            if (value.isNotEmpty()) {
+                results.add(value)
+            }
+        }
+    }
+    return results
+}
+
+fun xmlFirstBlock(tag: String, inXml: String): String? {
+    val pattern = Pattern.compile("(?is)<(?:\\w+:)?$tag\\b[^>]*>(.*?)</(?:\\w+:)?$tag}>", Pattern.CASE_INSENSITIVE)
+    val matcher = pattern.matcher(inXml)
+    return if (matcher.find()) matcher.group(1) else null
+}
+
+fun xmlAllBlocks(tag: String, inXml: String): List<String> {
+    val pattern = Pattern.compile("(?is)<(?:\\w+:)?$tag\\b[^>]*>(.*?)</(?:\\w+:)?$tag}>", Pattern.CASE_INSENSITIVE)
+    val matcher = pattern.matcher(inXml)
+    val results = mutableListOf<String>()
+    while (matcher.find()) {
+        matcher.group(1)?.let { results.add(it) }
+    }
+    return results
+}
+
+fun xmlAllTagAttributes(tag: String, inXml: String): List<Map<String, String>> {
+    val pattern = Pattern.compile("(?is)<(?:\\w+:)?$tag\\b([^>]*)/?>", Pattern.CASE_INSENSITIVE)
+    val matcher = pattern.matcher(inXml)
+    val results = mutableListOf<Map<String, String>>()
+    while (matcher.find()) {
+        matcher.group(1)?.let { results.add(parseXmlAttributes(it)) }
+    }
+    return results
+}
+
+private fun parseXmlAttributes(raw: String): Map<String, String> {
+    val pattern = Pattern.compile("(\\w+(?::\\w+)?)\\s*=\\s*\"([^\"]*)\"")
+    val matcher = pattern.matcher(raw)
+    val result = mutableMapOf<String, String>()
+    while (matcher.find()) {
+        val key = matcher.group(1)?.lowercase() ?: continue
+        val value = matcher.group(2)?.xmlDecoded()?.xmlTrimmed() ?: continue
+        result[key] = value
+    }
+    return result
+}
+
+fun generateUuid(): String = UUID.randomUUID().toString()
--- a/native-route/android/src/test/java/com/rssuper/database/RssDatabaseTest.kt
+++ b/native-route/android/src/test/java/com/rssuper/database/RssDatabaseTest.kt
@@ -46,9 +46,9 @@ class RssDatabaseTest {
    @Test
    fun ftsVirtualTableExists() {
        val cursor = database.run {
-            openHelper.writableDatabase.rawQuery(
+            openHelper.writableDatabase.query(
                "SELECT name FROM sqlite_master WHERE type='table' AND name='feed_items_fts'",
-                null
+                emptyArray()
            )
        }
        
--- a/native-route/android/src/test/java/com/rssuper/models/SearchResultTest.kt
+++ b/native-route/android/src/test/java/com/rssuper/models/SearchResultTest.kt
@@ -122,7 +122,7 @@ class SearchResultTest {
        assertEquals("article-1", modified.id)
        assertEquals(SearchResultType.ARTICLE, modified.type)
        assertEquals("Modified Title", modified.title)
-        assertEquals(0.99, modified.score, 0.001)
+        assertEquals(0.99, modified.score!!, 0.001)
    }

    @Test
--- a/native-route/android/src/test/java/com/rssuper/parsing/AtomParserTest.kt
+++ b/native-route/android/src/test/java/com/rssuper/parsing/AtomParserTest.kt
@@ -0,0 +1,245 @@
+package com.rssuper.parsing
+
+import com.rssuper.models.Enclosure
+import org.junit.Assert.assertEquals
+import org.junit.Assert.assertNotNull
+import org.junit.Assert.assertNull
+import org.junit.Test
+import org.junit.runner.RunWith
+import org.robolectric.RobolectricTestRunner
+import org.robolectric.annotation.Config
+
+@RunWith(RobolectricTestRunner::class)
+@Config(sdk = [24])
+class AtomParserTest {
+
+    @Test
+    fun testParseBasicAtom() {
+        val xml = """
+            <?xml version="1.0" encoding="UTF-8"?>
+            <feed xmlns="http://www.w3.org/2005/Atom">
+                <title>Atom Feed</title>
+                <subtitle>Feed subtitle</subtitle>
+                <link href="https://example.com" rel="alternate"/>
+                <id>urn:uuid:feed-id-123</id>
+                <updated>2024-01-01T12:00:00Z</updated>
+                <generator>Atom Generator</generator>
+                <entry>
+                    <title>Entry 1</title>
+                    <link href="https://example.com/entry1" rel="alternate"/>
+                    <id>urn:uuid:entry-1</id>
+                    <updated>2024-01-01T10:00:00Z</updated>
+                    <summary>Summary of entry 1</summary>
+                </entry>
+                <entry>
+                    <title>Entry 2</title>
+                    <link href="https://example.com/entry2" rel="alternate"/>
+                    <id>urn:uuid:entry-2</id>
+                    <updated>2023-12-31T10:00:00Z</updated>
+                    <content>Full content of entry 2</content>
+                </entry>
+            </feed>
+        """.trimIndent()
+
+        val feed = AtomParser.parse(xml, "https://example.com/feed.atom")
+
+        assertNotNull(feed)
+        assertEquals("Atom Feed", feed.title)
+        assertEquals("https://example.com", feed.link)
+        assertEquals("Feed subtitle", feed.subtitle)
+        assertEquals(2, feed.items.size)
+
+        val entry1 = feed.items[0]
+        assertEquals("Entry 1", entry1.title)
+        assertEquals("https://example.com/entry1", entry1.link)
+        assertEquals("Summary of entry 1", entry1.description)
+        assertNotNull(entry1.published)
+
+        val entry2 = feed.items[1]
+        assertEquals("Entry 2", entry2.title)
+        assertEquals("Full content of entry 2", entry2.content)
+    }
+
+    @Test
+    fun testParseAtomWithAuthor() {
+        val xml = """
+            <?xml version="1.0" encoding="UTF-8"?>
+            <feed xmlns="http://www.w3.org/2005/Atom">
+                <title>Author Feed</title>
+                <id>urn:uuid:feed-id</id>
+                <entry>
+                    <title>Entry with Author</title>
+                    <id>urn:uuid:entry</id>
+                    <author>
+                        <name>John Doe</name>
+                        <email>john@example.com</email>
+                    </author>
+                </entry>
+            </feed>
+        """.trimIndent()
+
+        val feed = AtomParser.parse(xml, "https://example.com/feed.atom")
+
+        assertNotNull(feed)
+        val entry = feed.items[0]
+        assertEquals("John Doe", entry.author)
+    }
+
+    @Test
+    fun testParseAtomWithCategories() {
+        val xml = """
+            <?xml version="1.0" encoding="UTF-8"?>
+            <feed xmlns="http://www.w3.org/2005/Atom">
+                <title>Categorized Feed</title>
+                <id>urn:uuid:feed-id</id>
+                <entry>
+                    <title>Categorized Entry</title>
+                    <id>urn:uuid:entry</id>
+                    <category term="technology"/>
+                    <category term="programming"/>
+                </entry>
+            </feed>
+        """.trimIndent()
+
+        val feed = AtomParser.parse(xml, "https://example.com/feed.atom")
+
+        assertNotNull(feed)
+        val entry = feed.items[0]
+        assertEquals(2, entry.categories?.size)
+        assertEquals("technology", entry.categories?.get(0))
+        assertEquals("programming", entry.categories?.get(1))
+    }
+
+    @Test
+    fun testParseAtomWithEnclosure() {
+        val xml = """
+            <?xml version="1.0" encoding="UTF-8"?>
+            <feed xmlns="http://www.w3.org/2005/Atom">
+                <title>Enclosure Feed</title>
+                <id>urn:uuid:feed-id</id>
+                <entry>
+                    <title>Episode</title>
+                    <id>urn:uuid:entry</id>
+                    <link href="https://example.com/ep.mp3" rel="enclosure" type="audio/mpeg" length="12345678"/>
+                </entry>
+            </feed>
+        """.trimIndent()
+
+        val feed = AtomParser.parse(xml, "https://example.com/feed.atom")
+
+        assertNotNull(feed)
+        val entry = feed.items[0]
+        assertNotNull(entry.enclosure)
+        assertEquals("https://example.com/ep.mp3", entry.enclosure?.url)
+        assertEquals("audio/mpeg", entry.enclosure?.type)
+        assertEquals(12345678L, entry.enclosure?.length)
+    }
+
+    @Test
+    fun testParseAtomWithContent() {
+        val xml = """
+            <?xml version="1.0" encoding="UTF-8"?>
+            <feed xmlns="http://www.w3.org/2005/Atom">
+                <title>Content Feed</title>
+                <id>urn:uuid:feed-id</id>
+                <entry>
+                    <title>Entry</title>
+                    <id>urn:uuid:entry</id>
+                    <summary>Short summary</summary>
+                    <content>Full HTML content</content>
+                </entry>
+            </feed>
+        """.trimIndent()
+
+        val feed = AtomParser.parse(xml, "https://example.com/feed.atom")
+
+        assertNotNull(feed)
+        val entry = feed.items[0]
+        assertEquals("Full HTML content", entry.content)
+        assertEquals("Short summary", entry.description)
+    }
+
+    @Test
+    fun testParseAtomWithiTunesExtension() {
+        val xml = """
+            <?xml version="1.0" encoding="UTF-8"?>
+            <feed xmlns="http://www.w3.org/2005/Atom" xmlns:itunes="http://www.itunes.com/dtds/podcast-1.0.dtd">
+                <title>Podcast</title>
+                <id>urn:uuid:feed-id</id>
+                <entry>
+                    <title>Episode</title>
+                    <id>urn:uuid:entry</id>
+                    <itunes:duration>3600</itunes:duration>
+                    <itunes:summary>Episode summary</itunes:summary>
+                </entry>
+            </feed>
+        """.trimIndent()
+
+        val feed = AtomParser.parse(xml, "https://example.com/feed.atom")
+
+        assertNotNull(feed)
+        val entry = feed.items[0]
+        assertEquals("Episode summary", entry.description)
+    }
+
+    @Test
+    fun testParseAtomWithPublished() {
+        val xml = """
+            <?xml version="1.0" encoding="UTF-8"?>
+            <feed xmlns="http://www.w3.org/2005/Atom">
+                <title>Date Feed</title>
+                <id>urn:uuid:feed-id</id>
+                <updated>2024-06-15T12:00:00Z</updated>
+                <entry>
+                    <title>Entry</title>
+                    <id>urn:uuid:entry</id>
+                    <published>2024-01-01T08:00:00Z</published>
+                    <updated>2024-01-02T10:00:00Z</updated>
+                </entry>
+            </feed>
+        """.trimIndent()
+
+        val feed = AtomParser.parse(xml, "https://example.com/feed.atom")
+
+        assertNotNull(feed)
+        val entry = feed.items[0]
+        assertNotNull(entry.published)
+    }
+
+    @Test
+    fun testParseAtomWithEmptyFeed() {
+        val xml = """
+            <?xml version="1.0" encoding="UTF-8"?>
+            <feed xmlns="http://www.w3.org/2005/Atom">
+                <title>Empty Feed</title>
+                <id>urn:uuid:feed-id</id>
+            </feed>
+        """.trimIndent()
+
+        val feed = AtomParser.parse(xml, "https://example.com/feed.atom")
+
+        assertNotNull(feed)
+        assertEquals("Empty Feed", feed.title)
+        assertEquals(0, feed.items.size)
+    }
+
+    @Test
+    fun testParseAtomWithMissingFields() {
+        val xml = """
+            <?xml version="1.0" encoding="UTF-8"?>
+            <feed xmlns="http://www.w3.org/2005/Atom">
+                <entry>
+                    <title>Minimal Entry</title>
+                </entry>
+            </feed>
+        """.trimIndent()
+
+        val feed = AtomParser.parse(xml, "https://example.com/feed.atom")
+
+        assertNotNull(feed)
+        assertEquals("Untitled Feed", feed.title)
+        assertEquals(1, feed.items.size)
+        assertEquals("Minimal Entry", feed.items[0].title)
+        assertNull(feed.items[0].link)
+    }
+}
--- a/native-route/android/src/test/java/com/rssuper/parsing/FeedParserTest.kt
+++ b/native-route/android/src/test/java/com/rssuper/parsing/FeedParserTest.kt
@@ -0,0 +1,162 @@
+package com.rssuper.parsing
+
+import org.junit.Assert.assertEquals
+import org.junit.Assert.assertNotNull
+import org.junit.Assert.fail
+import org.junit.Test
+import org.junit.runner.RunWith
+import org.robolectric.RobolectricTestRunner
+import org.robolectric.annotation.Config
+
+@RunWith(RobolectricTestRunner::class)
+@Config(sdk = [24])
+class FeedParserTest {
+
+    @Test
+    fun testParseRSSFeed() {
+        val xml = """
+            <?xml version="1.0" encoding="UTF-8"?>
+            <rss version="2.0">
+                <channel>
+                    <title>RSS Feed</title>
+                    <link>https://example.com</link>
+                    <item>
+                        <title>Item</title>
+                        <link>https://example.com/item</link>
+                    </item>
+                </channel>
+            </rss>
+        """.trimIndent()
+
+        val result = FeedParser.parse(xml, "https://example.com/feed.xml")
+
+        assertNotNull(result)
+        assertEquals(FeedType.RSS, result.feedType)
+        assertEquals("RSS Feed", result.feed.title)
+    }
+
+    @Test
+    fun testParseAtomFeed() {
+        val xml = """
+            <?xml version="1.0" encoding="UTF-8"?>
+            <feed xmlns="http://www.w3.org/2005/Atom">
+                <title>Atom Feed</title>
+                <id>urn:uuid:feed</id>
+                <entry>
+                    <title>Entry</title>
+                    <id>urn:uuid:entry</id>
+                </entry>
+            </feed>
+        """.trimIndent()
+
+        val result = FeedParser.parse(xml, "https://example.com/feed.atom")
+
+        assertNotNull(result)
+        assertEquals(FeedType.Atom, result.feedType)
+        assertEquals("Atom Feed", result.feed.title)
+    }
+
+    @Test
+    fun testParseRSSWithNamespaces() {
+        val xml = """
+            <?xml version="1.0" encoding="UTF-8"?>
+            <rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:itunes="http://www.itunes.com/dtds/podcast-1.0.dtd">
+                <channel>
+                    <title>Namespaced Feed</title>
+                    <atom:link href="https://example.com/feed.xml" rel="self"/>
+                    <itunes:author>Author</itunes:author>
+                    <item>
+                        <title>Item</title>
+                    </item>
+                </channel>
+            </rss>
+        """.trimIndent()
+
+        val result = FeedParser.parse(xml, "https://example.com/feed.xml")
+
+        assertNotNull(result)
+        assertEquals(FeedType.RSS, result.feedType)
+    }
+
+    @Test
+    fun testParseMalformedXml() {
+        val malformedXml = """
+            <?xml version="1.0"?>
+            <rss>
+                <channel>
+                    <title>Broken
+            """.trimIndent()
+
+        try {
+            val result = FeedParser.parse(malformedXml, "https://example.com/feed.xml")
+            assertNotNull(result)
+        } catch (e: Exception) {
+            assertNotNull(e)
+        }
+    }
+
+    @Test
+    fun testParseInvalidFeedType() {
+        val invalidXml = """
+            <?xml version="1.0" encoding="UTF-8"?>
+            <invalid>
+                <data>Some data</data>
+            </invalid>
+        """.trimIndent()
+
+        try {
+            FeedParser.parse(invalidXml, "https://example.com/feed.xml")
+            fail("Expected exception for invalid feed type")
+        } catch (e: FeedParsingError) {
+            assertEquals(FeedParsingError.UnsupportedFeedType, e)
+        }
+    }
+
+    @Test
+    fun testParseEmptyFeed() {
+        val emptyXml = """
+            <?xml version="1.0" encoding="UTF-8"?>
+            <rss version="2.0">
+                <channel>
+                    <title></title>
+                </channel>
+            </rss>
+        """.trimIndent()
+
+        val result = FeedParser.parse(emptyXml, "https://example.com/feed.xml")
+
+        assertNotNull(result)
+        assertEquals("Untitled Feed", result.feed.title)
+    }
+
+    @Test
+    fun testAsyncCallback() {
+        val xml = """
+            <?xml version="1.0" encoding="UTF-8"?>
+            <rss version="2.0">
+                <channel>
+                    <title>Async Feed</title>
+                    <item>
+                        <title>Item</title>
+                    </item>
+                </channel>
+            </rss>
+        """.trimIndent()
+
+        FeedParser.parseAsync(xml, "https://example.com/feed.xml") { result ->
+            assert(result.isSuccess)
+            val feed = result.getOrNull()
+            assertNotNull(feed)
+            assertEquals("Async Feed", feed?.feed?.title)
+        }
+    }
+
+    @Test
+    fun testAsyncCallbackError() {
+        val invalidXml = "not xml"
+
+        FeedParser.parseAsync(invalidXml, "https://example.com/feed.xml") { result ->
+            assert(result.isFailure)
+        }
+    }
+}
--- a/native-route/android/src/test/java/com/rssuper/parsing/RSSParserTest.kt
+++ b/native-route/android/src/test/java/com/rssuper/parsing/RSSParserTest.kt
@@ -0,0 +1,255 @@
+package com.rssuper.parsing
+
+import com.rssuper.models.Enclosure
+import com.rssuper.models.Feed
+import org.junit.Assert.assertEquals
+import org.junit.Assert.assertNotNull
+import org.junit.Assert.assertNull
+import org.junit.Test
+import org.junit.runner.RunWith
+import org.robolectric.RobolectricTestRunner
+import org.robolectric.annotation.Config
+
+@RunWith(RobolectricTestRunner::class)
+@Config(sdk = [24])
+class RSSParserTest {
+
+    @Test
+    fun testParseBasicRSS() {
+        val xml = """
+            <?xml version="1.0" encoding="UTF-8"?>
+            <rss version="2.0">
+                <channel>
+                    <title>Test Feed</title>
+                    <link>https://example.com</link>
+                    <description>A test feed</description>
+                    <language>en-us</language>
+                    <lastBuildDate>Mon, 01 Jan 2024 12:00:00 GMT</lastBuildDate>
+                    <generator>RSS Generator</generator>
+                    <ttl>60</ttl>
+                    <item>
+                        <title>Item 1</title>
+                        <link>https://example.com/item1</link>
+                        <description>Description of item 1</description>
+                        <guid isPermaLink="true">https://example.com/item1</guid>
+                        <pubDate>Mon, 01 Jan 2024 10:00:00 GMT</pubDate>
+                    </item>
+                    <item>
+                        <title>Item 2</title>
+                        <link>https://example.com/item2</link>
+                        <description>Description of item 2</description>
+                        <guid>item-2-guid</guid>
+                        <pubDate>Sun, 31 Dec 2023 10:00:00 GMT</pubDate>
+                    </item>
+                </channel>
+            </rss>
+        """.trimIndent()
+
+        val feed = RSSParser.parse(xml, "https://example.com/feed.xml")
+
+        assertNotNull(feed)
+        assertEquals("Test Feed", feed.title)
+        assertEquals("https://example.com", feed.link)
+        assertEquals("A test feed", feed.description)
+        assertEquals("en-us", feed.language)
+        assertEquals(60, feed.ttl)
+        assertEquals(2, feed.items.size)
+
+        val item1 = feed.items[0]
+        assertEquals("Item 1", item1.title)
+        assertEquals("https://example.com/item1", item1.link)
+        assertEquals("Description of item 1", item1.description)
+        assertNotNull(item1.published)
+    }
+
+    @Test
+    fun testParseRSSWithiTunesNamespace() {
+        val xml = """
+            <?xml version="1.0" encoding="UTF-8"?>
+            <rss version="2.0" xmlns:itunes="http://www.itunes.com/dtds/podcast-1.0.dtd">
+                <channel>
+                    <title>Podcast Feed</title>
+                    <link>https://example.com/podcast</link>
+                    <description>My podcast</description>
+                    <itunes:subtitle>Podcast subtitle</itunes:subtitle>
+                    <itunes:author>Author Name</itunes:author>
+                    <item>
+                        <title>Episode 1</title>
+                        <link>https://example.com/episode1</link>
+                        <description>Episode description</description>
+                        <itunes:duration>01:30:00</itunes:duration>
+                        <enclosure url="https://example.com/ep1.mp3" type="audio/mpeg" length="12345678"/>
+                    </item>
+                </channel>
+            </rss>
+        """.trimIndent()
+
+        val feed = RSSParser.parse(xml, "https://example.com/feed.xml")
+
+        assertNotNull(feed)
+        assertEquals("Podcast Feed", feed.title)
+
+        val item = feed.items[0]
+        assertEquals("Episode 1", item.title)
+        assertNotNull(item.enclosure)
+        assertEquals("https://example.com/ep1.mp3", item.enclosure?.url)
+        assertEquals("audio/mpeg", item.enclosure?.type)
+        assertEquals(12345678L, item.enclosure?.length)
+    }
+
+    @Test
+    fun testParseRSSWithContentNamespace() {
+        val xml = """
+            <?xml version="1.0" encoding="UTF-8"?>
+            <rss version="2.0" xmlns:content="http://purl.org/rss/1.0/modules/content/">
+                <channel>
+                    <title>Feed with Content</title>
+                    <item>
+                        <title>Item with Content</title>
+                        <description>Short description</description>
+                        <content:encoded><![CDATA[<p>Full content here</p>]]></content:encoded>
+                    </item>
+                </channel>
+            </rss>
+        """.trimIndent()
+
+        val feed = RSSParser.parse(xml, "https://example.com/feed.xml")
+
+        assertNotNull(feed)
+        assertEquals(1, feed.items.size)
+        assertEquals("Item with Content", feed.items[0].title)
+        assertEquals("<p>Full content here</p>", feed.items[0].content)
+    }
+
+    @Test
+    fun testParseRSSWithCategories() {
+        val xml = """
+            <?xml version="1.0" encoding="UTF-8"?>
+            <rss version="2.0">
+                <channel>
+                    <title>Categorized Feed</title>
+                    <item>
+                        <title>Tech Article</title>
+                        <category>Technology</category>
+                        <category>Programming</category>
+                    </item>
+                </channel>
+            </rss>
+        """.trimIndent()
+
+        val feed = RSSParser.parse(xml, "https://example.com/feed.xml")
+
+        assertNotNull(feed)
+        val item = feed.items[0]
+        assertEquals(2, item.categories?.size)
+        assertEquals("Technology", item.categories?.get(0))
+        assertEquals("Programming", item.categories?.get(1))
+    }
+
+    @Test
+    fun testParseRSSWithAuthor() {
+        val xml = """
+            <?xml version="1.0" encoding="UTF-8"?>
+            <rss version="2.0">
+                <channel>
+                    <title>Author Feed</title>
+                    <item>
+                        <title>Article by Author</title>
+                        <author>author@example.com (John Doe)</author>
+                    </item>
+                </channel>
+            </rss>
+        """.trimIndent()
+
+        val feed = RSSParser.parse(xml, "https://example.com/feed.xml")
+
+        assertNotNull(feed)
+        val item = feed.items[0]
+        assertEquals("author@example.com (John Doe)", item.author)
+    }
+
+    @Test
+    fun testParseRSSWithGuid() {
+        val xml = """
+            <?xml version="1.0" encoding="UTF-8"?>
+            <rss version="2.0">
+                <channel>
+                    <title>Guid Feed</title>
+                    <item>
+                        <title>Item</title>
+                        <guid>custom-guid-12345</guid>
+                    </item>
+                </channel>
+            </rss>
+        """.trimIndent()
+
+        val feed = RSSParser.parse(xml, "https://example.com/feed.xml")
+
+        assertNotNull(feed)
+        assertEquals("custom-guid-12345", feed.items[0].guid)
+    }
+
+    @Test
+    fun testParseRSSWithEmptyChannel() {
+        val xml = """
+            <?xml version="1.0" encoding="UTF-8"?>
+            <rss version="2.0">
+                <channel>
+                    <title>Minimal Feed</title>
+                </channel>
+            </rss>
+        """.trimIndent()
+
+        val feed = RSSParser.parse(xml, "https://example.com/feed.xml")
+
+        assertNotNull(feed)
+        assertEquals("Minimal Feed", feed.title)
+        assertEquals(0, feed.items.size)
+    }
+
+    @Test
+    fun testParseRSSWithMissingFields() {
+        val xml = """
+            <?xml version="1.0" encoding="UTF-8"?>
+            <rss version="2.0">
+                <channel>
+                    <item>
+                        <title>Only Title</title>
+                    </item>
+                </channel>
+            </rss>
+        """.trimIndent()
+
+        val feed = RSSParser.parse(xml, "https://example.com/feed.xml")
+
+        assertNotNull(feed)
+        assertEquals("Untitled Feed", feed.title)
+        assertEquals(1, feed.items.size)
+        assertEquals("Only Title", feed.items[0].title)
+        assertNull(feed.items[0].link)
+    }
+
+    @Test
+    fun testParseRSSWithCDATA() {
+        val xml = """
+            <?xml version="1.0" encoding="UTF-8"?>
+            <rss version="2.0">
+                <channel>
+                    <title><![CDATA[CDATA Title]]></title>
+                    <description><![CDATA[<p>HTML <strong>content</strong></p>]]></description>
+                    <item>
+                        <title>CDATA Item</title>
+                        <description><![CDATA[Item content]]></description>
+                    </item>
+                </channel>
+            </rss>
+        """.trimIndent()
+
+        val feed = RSSParser.parse(xml, "https://example.com/feed.xml")
+
+        assertNotNull(feed)
+        assertEquals("CDATA Title", feed.title)
+        assertEquals("<p>HTML <strong>content</strong></p>", feed.description)
+        assertEquals("Item content", feed.items[0].description)
+    }
+}