Skip to content

[codex] Lazy parse deprecated iTunes summaries#5

Draft
nathangathright wants to merge 1 commit into
podverse:developfrom
TeamPodlink:codex/lazy-itunes-summary
Draft

[codex] Lazy parse deprecated iTunes summaries#5
nathangathright wants to merge 1 commit into
podverse:developfrom
TeamPodlink:codex/lazy-itunes-summary

Conversation

@nathangathright

Copy link
Copy Markdown

Summary

  • Avoid eagerly HTML-decoding deprecated <itunes:summary> values during XML parsing.
  • Stop emitting summary fields by default for feed and item objects; callers can opt back in with includeItunesSummary.
  • Keep itunes:summary as a lazy fallback for description when no better description/content field exists.

Why

Some large feeds, including Anchor feeds with long back catalogs, include hundreds of thousands of escaped HTML entities inside <itunes:summary>. Since the tag is deprecated and usually duplicates <description>, parsing and exposing it eagerly can trip downstream entity expansion limits without adding useful data.

Validation

  • npx jest src/parser/__test__/feed.test.ts src/parser/__test__/item.test.ts --runInBand
  • npm test -- --runInBand
  • npm run lint:typecheck
  • npm run build
  • Parsed https://anchor.fm/s/7c624c84/podcast/rss from dist successfully: 1,426 items, no default summary fields.

@nathangathright nathangathright force-pushed the codex/lazy-itunes-summary branch from b1ec845 to 2bd4383 Compare May 25, 2026 20:09
@nathangathright nathangathright force-pushed the codex/lazy-itunes-summary branch from 2bd4383 to 2bcf1f8 Compare May 29, 2026 23:28
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant