Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
20 commits
Select commit Hold shift + click to select a range
3b4f00a
feat(persistence): persist annotation chapter targets and fallback st…
ur1el0 Nov 13, 2026
643acca
fix(reader): support annotation editing, quote navigation, and non-bl…
ur1el0 Nov 13, 2026
d5eb7c2
feat(audio): configure background playback mode and lock-screen remot…
ur1el0 Nov 13, 2026
0e228d6
test(plans): add XCTest coverage for Plans 01-04 persistence, margina…
ur1el0 Nov 13, 2026
14a7c8c
docs(plans): add multi-chapter catalog and cache remediation plan
ur1el0 Nov 13, 2026
f3952ca
fix(gutenberg): prioritize classic books, deduplicate editions, and e…
ur1el0 Nov 13, 2026
75f3008
feat(standard-ebooks): add open-source XHTML catalog and chapter endp…
ur1el0 Nov 13, 2026
1c3a91b
test(providers): cover Gutenberg parser edge cases and Standard Ebook…
ur1el0 Nov 13, 2026
3554c8a
feat(library): integrate Standard Ebooks and self-heal external chapt…
ur1el0 Nov 13, 2026
5d0952a
test(library): cover Standard Ebooks decoding and cache invalidation …
ur1el0 Nov 13, 2026
5c37d20
docs(handoff): summarize multi-chapter changes and next steps
ur1el0 Nov 13, 2026
54378d5
fix(library): mark external chapter parser version nonisolated
ur1el0 Nov 13, 2026
98452ee
feat(gutenberg): add recent and popular discovery
ur1el0 Nov 13, 2026
293225b
fix(reader): preserve chapter divisions and unknown counts
ur1el0 Nov 13, 2026
1425506
test(gutenberg): cover fresh and popular discovery
ur1el0 Nov 13, 2026
14a755a
feat(library): show recent and popular Gutenberg shelves
ur1el0 Nov 13, 2026
c56d711
docs(catalog): document Gutenberg discovery sources
ur1el0 Nov 13, 2026
dde09be
fix(standard-ebooks): avoid XML element truthiness
ur1el0 Nov 14, 2026
55f77c3
test(standard-ebooks): cover empty main fallback
ur1el0 Nov 14, 2026
27760c3
test(reader): isolate pagination regression test on main actor
ur1el0 Nov 14, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 2 additions & 1 deletion backend/api/v1/api.py
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
from fastapi import APIRouter
from api.v1.endpoints import health, stories, shelf, gutenberg, auth, manga
from api.v1.endpoints import health, stories, shelf, gutenberg, auth, manga, standard_ebooks

api_router = APIRouter()

Expand All @@ -8,5 +8,6 @@
api_router.include_router(shelf.router, tags=["shelf"])
api_router.include_router(gutenberg.router, tags=["gutenberg"])
api_router.include_router(manga.router, tags=["manga"])
api_router.include_router(standard_ebooks.router, tags=["standard-ebooks"])
api_router.include_router(auth.router, tags=["auth"])

8 changes: 6 additions & 2 deletions backend/api/v1/endpoints/gutenberg.py
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
from typing import Optional
from typing import Literal, Optional
from fastapi import APIRouter, Depends, Path, Query, status

from core.operator_auth import require_ingestion_api_key
Expand All @@ -23,8 +23,12 @@ async def ingest_gutenberg_book(
async def get_gutenberg_stories(
topic: Optional[str] = Query(default=None, max_length=50, description="Topic or genre filter for Gutenberg"),
search: Optional[str] = Query(default=None, max_length=200, description="Search term across title and author"),
sort: Literal["catalog", "popular", "recent"] = Query(
default="catalog",
description="Select the catalog snapshot, popular titles, or recent Gutenberg additions",
),
):
return await gutenberg_service.get_gutenberg_stories(topic=topic, search=search)
return await gutenberg_service.get_gutenberg_stories(topic=topic, search=search, sort=sort)


@router.get("/public/gutenberg/{gutenberg_id}", response_model=StoryDTO)
Expand Down
24 changes: 24 additions & 0 deletions backend/api/v1/endpoints/standard_ebooks.py
Original file line number Diff line number Diff line change
@@ -0,0 +1,24 @@
from typing import Optional
from fastapi import APIRouter, Query

from schemas import ChapterDTO, StoryDTO
from services import standard_ebooks as standard_ebooks_service

router = APIRouter()


@router.get("/public/standard-ebooks", response_model=list[StoryDTO])
async def get_standard_ebooks_stories(
topic: Optional[str] = Query(default=None, description="Filter Standard Ebooks by subject (e.g. fiction, horror)"),
search: Optional[str] = Query(default=None, description="Search keyword for title or author"),
):
"""Retrieve curated public-domain classics from Standard Ebooks."""
return await standard_ebooks_service.get_standard_ebooks_stories(topic=topic, search=search)


@router.get("/public/standard-ebooks/chapters", response_model=list[ChapterDTO])
async def get_standard_ebooks_chapters(
book_id: str = Query(..., description="Standard Ebooks slug path (e.g. bram-stoker/dracula)"),
):
"""Retrieve structured semantic XHTML chapters for a Standard Ebooks work."""
return await standard_ebooks_service.get_standard_ebooks_chapters(book_id=book_id)
Loading
Loading