eleventy-plugin-podcaster 2.0.2 → 2.1.0

package/CLAUDE.md

@@ -0,0 +1,54 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Commands
+
+```bash
+npm test          # run all tests (AVA)
+npx ava test/someTestFile.js  # run a single test file
+npx eslint src/   # lint source files
+```
+
+There is no build step — the plugin is used directly from source.
+
+## Architecture
+
+`eleventy.config.js` is the plugin entry point. It registers 8 sub-plugins and 3 optional features:
+
+**Core sub-plugins (always active):**
+
+- `podcastFeed.js` — RSS feed generation; creates `episodePost` and `episodePostWithChapters` collections via virtual templates
+- `podcastData.js` — Computes podcast-level `eleventyComputed` fields: `feedPath`, `imagePath`, `episodeUrlBase`, `copyrightNotice`
+- `episodeData.js` — Parses `seasonNumber`/`episodeNumber` from filenames; constructs episode `url` and `permalink`
+- `calculateEpisodeSizeAndDuration.js` — Reads audio metadata from local files or S3; caches results; uses `music-metadata`
+- `calculateEpisodeFilename.js` — Matches episode posts to audio files by season/episode number
+- `readableFilters.js` — Adds `readableDate`, `readableDuration`, `readableSize` filters
+- `chapters.js` — Filter for normalizing chapter data to JSON-LD; template in `src/chapters.njk`
+
+**Optional features (opt-in via plugin options):**
+
+- `drafts.js` — Filters draft posts; controlled by `INCLUDE_DRAFTS` env var or `ELEVENTY_RUN_MODE`
+- `excerpts.js` — Auto-generates episode excerpts from front matter, HTML comments, or first paragraph
+- `pageTitle.js` — Computes `pageTitle` with configurable separator
+
+**Options:** `handleDrafts`, `handleExcerpts`, `handlePageTitles` (individual flags), or `optionalFeatures: true` (enables all three). `episodePostsDirectory` and `episodeFilesDirectory` override the default directory names.
+
+## Tests
+
+Tests use AVA and are configured in `ava.config.js`. Each test file typically builds a fixture site using Eleventy's programmatic API and asserts on the output.
+
+Fixture sites live in `fixtures/` — each is a minimal Eleventy site with `eleventy.config.js`, `_data/podcast.json`, episode markdown files in `episode-posts/`, and audio files in `episode-files/`.
+
+Key environment variables used in tests:
+
+- `SKIP_EPISODE_CALCULATIONS` — skip audio metadata calculation (speeds up tests that don't need it)
+- `INCLUDE_DRAFTS` — controls draft inclusion
+- `ELEVENTY_RUN_MODE` — `'build'` or `'serve'`
+
+## Conventions
+
+- All source files are ES modules (`"type": "module"` in package.json)
+- Computed episode/podcast fields are set via Eleventy's `eleventyComputed` pattern
+- No Luxon — duration logic uses native `Intl` / `Date`; see `src/readableDuration.js`
+- Commit messages: short past-tense verb phrases, no body, no co-author lines (e.g. `Removed Luxon dependency`)

package/jsconfig.json

@@ -0,0 +1,5 @@
+{
+  "compilerOptions": {
+    "checkJs": false
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "eleventy-plugin-podcaster",
-  "version": "2.0.2",
+  "version": "2.1.0",
   "description": "An Eleventy plugin that allows you to create a podcast and its accompanying website",
   "main": "eleventy.config.js",
   "exports": {
@@ -29,7 +29,7 @@
   "license": "ISC",
   "dependencies": {
     "@11ty/eleventy": "^3.0.0",
-    "@11ty/eleventy-plugin-rss": "^2.0.1",
+    "@11ty/eleventy-plugin-rss": "^3.0.0",
     "@aws-sdk/client-s3": "^3.862.0",
     "@tsmx/human-readable": "^2.0.3",
     "dom-serializer": "^2.0.0",
@@ -40,8 +40,8 @@
   "devDependencies": {
     "ava": "^6.1.3",
     "dotenv": "^17.2.1",
-    "fast-xml-parser": "^4.4.0",
-    "mock-aws-s3-v3": "^6.0.5",
+    "fast-xml-parser": "^5.5.9",
+    "mock-aws-s3-v3": "^6.1.12",
     "neostandard": "^0.11.4"
   }
 }

package/src/podcastFeed.js

@@ -13,7 +13,9 @@ export default function (eleventyConfig, options = {}) {
     eleventyExcludeFromCollections: true,
     eleventyImport: {
       collections: ['episodePost']
-    }
+    },
+    script: options?.feedScript,
+    stylesheet: options?.feedStylesheet
   })
 
   const chaptersPath = path.join(import.meta.dirname, './chapters.njk')

package/src/podcastFeed.njk

@@ -5,12 +5,14 @@ eleventyAllowMissingExtension: true
 ---
 {%- set siteUrl %}{{ podcast.siteUrl or site.url }}{% endset -%}
 <?xml version="1.0" encoding="utf-8"?>
+{% if stylesheet %}<?xml-stylesheet type="text/xsl" href="{{ stylesheet }}" ?>{% endif %}
 <rss version="2.0"
   xmlns:atom="http://www.w3.org/2005/Atom"
   xmlns:itunes="http://www.itunes.com/dtds/podcast-1.0.dtd"
   xmlns:content="http://purl.org/rss/1.0/modules/content/"
   xmlns:podcast="https://podcastindex.org/namespace/1.0">
   <channel>
+    {% if script %}<script src="{{ script }}" xmlns="http://www.w3.org/1999/xhtml"></script>{% endif %}
     <title>{{ podcast.title }}</title>
     <link>{{ siteUrl }}</link>
     <atom:link href="{{ permalink | htmlBaseUrl(siteUrl) }}" rel="self" type="application/rss+xml" />