script-src now allow-lists the guard by sha256 of its rendered bytes (middleware.ScriptHashThemeFlashGuard) instead of 'unsafe-inline' — the guard is the app's only inline <script>. security_headers_test.go renders templates.ThemeFlashGuard() and fails with the replacement hash if the script text ever drifts. Executing anti-XSS strict CSP surfaced three latent violations the eval-removal sweep couldn't see (hash mode is stricter than eval mode, because inline event handler ATTRIBUTES now count against script-src): 1. admin_archived / admin_library: 15 native onclick=/onsubmit= handlers (modal open/close, folder-browser picker, purge button) converted to Alpine @click/@submit component methods — openCreateLibraryModal, hideModal, pickBrowsePath added to the admin component; purgeArchivedItems promoted from its window global into the component and the (window as any) exposure removed. 2. dashboard/docs: onclick handlers converted — dashboard's event.stopPropagation() → @click.stop; docs' sidebar/search closers → closeDocsSidebar/closeSearchResults component methods. 3. 8 onerror= image-fallback attributes (cover placeholders app-wide + audiobook cover hide) replaced by data-fallback attributes handled by one delegated capture-phase listener in web/src/image_fallback.ts — works for htmx-swapped content without re-binding. Verified: theme guard applies a saved theme on public pages under the hash CSP; 14-page authenticated sweep clean; admin pages clean under the promoted admin; admin-library modal open/close bindings exercised; readers render error-free; go build/vet/middleware-test, tsc, vp check/test (146), build:ts all green.
39 lines
1.4 KiB
TypeScript
39 lines
1.4 KiB
TypeScript
// Delegated image-fallback handling for strict CSP.
|
|
//
|
|
// Cover images used to carry inline `onerror` attributes; under the
|
|
// hash-allow-listed script-src (no 'unsafe-inline') the browser refuses to
|
|
// execute them. This module restores the same behavior with one
|
|
// capture-phase listener on <html>, so htmx-swapped containers are covered
|
|
// without any per-element re-binding.
|
|
//
|
|
// Opt-ins via data attributes on the element:
|
|
// data-fallback="hide" → hide the element instead of swapping the src
|
|
// (audiobook covers: placeholder would overflow)
|
|
// default → swap a broken cover to the placeholder SVG
|
|
|
|
const PLACEHOLDER = "/static/placeholder-book.svg";
|
|
|
|
let armed = false;
|
|
|
|
function onResourceError(event: Event) {
|
|
const target = event.target;
|
|
// Only interested in resource elements (img/audio/video/source), not
|
|
// generic events bubbling up (error does not bubble, but capture sees it).
|
|
if (!(target instanceof HTMLImageElement)) return;
|
|
|
|
if (target.dataset.fallback === "hide") {
|
|
target.style.display = "none";
|
|
return;
|
|
}
|
|
// Never chase our own placeholder (if it 404s, stop).
|
|
if (target.src.endsWith(PLACEHOLDER)) return;
|
|
target.src = PLACEHOLDER;
|
|
}
|
|
|
|
export function armImageFallbacks() {
|
|
if (armed) return;
|
|
armed = true;
|
|
// Capture is required: 'error' doesn't bubble.
|
|
document.documentElement.addEventListener("error", onResourceError, true);
|
|
}
|