Add Kindle EPUB compatibility fixer

Introduce an optional Kindle EPUB compatibility fixer and integrate it into the ebook organization flow. Adds a new config key (ebook_kindle_fix_enabled, default false), a settings API update, and a UI toggle (visible when preferred format is EPUB). Implements src/lib/utils/epub-fixer.ts (uses adm-zip and cheerio) to apply fixes: add UTF-8 XML declarations, remove body/#bodymatter fragments from links, validate/normalize dc:language, and remove stray <img> tags without src. organize-files.processor now detects EPUB downloads, runs the fixer (produces a temp fixed EPUB), uses the fixed file for organization, logs fixes, and cleans up temporary files; fix failures are non-blocking and the original download is preserved. Adds dependencies adm-zip and @types/adm-zip and updates documentation and types/UI to expose the new setting. Also includes helper functions to detect EPUB paths in downloads.
This commit is contained in:
kikootwo
2026-02-03 16:34:57 -05:00
parent 863f8466ea
commit 2ef9ac7be1
11 changed files with 677 additions and 233 deletions
@@ -254,6 +254,32 @@ export function EbookTab({ ebook, onChange, onSuccess, onError, markAsSaved }: E
</p>
</div>
</div>
{/* Kindle Fix Toggle - Only shown when EPUB is selected */}
{(ebook.preferredFormat === 'epub' || !ebook.preferredFormat) && (
<div className="flex items-start gap-4 pt-2 border-t border-gray-200 dark:border-gray-700 mt-4">
<input
type="checkbox"
id="kindle-fix-enabled"
checked={ebook.kindleFixEnabled ?? false}
onChange={(e) => updateEbook('kindleFixEnabled', e.target.checked)}
className="mt-1 h-5 w-5 rounded border-gray-300 text-blue-600 focus:ring-blue-500"
/>
<div className="flex-1">
<label
htmlFor="kindle-fix-enabled"
className="block text-sm font-medium text-gray-900 dark:text-gray-100 cursor-pointer"
>
Fix EPUB for Kindle import
</label>
<p className="text-sm text-gray-600 dark:text-gray-400 mt-1">
Apply compatibility fixes before organizing EPUB files. Fixes encoding declarations,
broken hyperlinks, invalid language tags, and orphaned image elements that can
cause Kindle import failures.
</p>
</div>
</div>
)}
</div>
</div>
)}