From c000517fd17c525485d2e72a9f5af4f0231606dd Mon Sep 17 00:00:00 2001
From: Jan Andrle <andrle.jan@centrum.cz>
Date: Thu, 11 Jun 2026 14:01:51 +0200
Subject: [PATCH] :abc: Adds plan

---
 changelog/plans/plan-basic-episodes.md | 44 ++++++++++++++++++++++++++
 changelog/v1.0.md                      |  1 +
 2 files changed, 45 insertions(+)
 create mode 100644 changelog/plans/plan-basic-episodes.md

diff --git a/changelog/plans/plan-basic-episodes.md b/changelog/plans/plan-basic-episodes.md
new file mode 100644
index 0000000..673b40b
--- /dev/null
+++ b/changelog/plans/plan-basic-episodes.md
@@ -0,0 +1,44 @@
+# Basic Episodes Fetch
+
+## Overview
+This plan focuses on adding a minimal **episodes‑fetch** feature that pulls podcast episodes from the CommaFeed backend
+using environment variables for configuration.
+
+The plan is derived from:
+- `docs/dev/README.md` (API endpoints, authentication)
+- `src/` structure and existing route system
+- Build scripts in `bs/` – only linting is required at this stage.
+
+## Tasks
+1. **Environment handling** (TODO)
+	- Create a small helper (`@core/env.ts`) that reads `.env.ts` (or falls back to process.env).
+	- Expose constants: `COMMAFEED_URL`, `USERNAME`, `PASSWORD`.
+1. **API client** (TODO)
+	- Adds `src/api` folder to the project structure (update also @src/README.md).
+	- Implement a lightweight wrapper around `fetch` in `src/api/index.ts`.
+	- Build `authHeader()` that returns the Basic‑Auth header using env vars.
+1. **Episode service** (TODO)
+	- Add `src/api/episodes.ts` with `getEpisodes(feedId)` and `getEpisode(id)`.
+	- Add data types
+	- Use `/rest/feed/entries?feed_id=${feedId}` endpoint.
+1. **Route integration** (TODO)
+	- In `app-episodes/routes.ts`, call the service during `enter()` to pre‑fetch episodes.
+	- Pass fetched data via route context or set a global state (e.g., using Lit Labs signals).
+1. **Page update** (TODO)
+	- Update `<app-episodes>` to reflect loading state(s).
+	- Add episode list item component.
+	- Update `<app-episodes>` to render the episode list received from the route context.
+1. **Testing** (TODO)
+	- Add unit tests for `api/*.ts` using project test setup.
+	- Add unit test for created component(s)
+1. **Linting** (TODO)
+	- Ensure all new files satisfy the lint rule defined in `bs/dev/lint`.
+
+## Expected Output
+- Visiting `/episodes/` will display a list of episodes fetched from CommaFeed.
+- Episodes are identified by their `id` and displayed with title, publish date, and an audio link if available.
+- Authentication uses the env variables; no credentials are hard‑coded in source.
+
+---
+
+> **Note**: This plan intentionally keeps external dependencies minimal. It can be extended later for pagination, caching, or offline support.
diff --git a/changelog/v1.0.md b/changelog/v1.0.md
index c73927d..28311f3 100644
--- a/changelog/v1.0.md
+++ b/changelog/v1.0.md
@@ -2,3 +2,4 @@
 
 - [x] initial setup (`bs`, app structure, …)
 - [x] adds routing support
+- [ ] [episodes basic fetch](./plans/plan-basic-episodes.md)