feat(facets): all-facets panel with under-filter counts (faceted plan Phase 7)

The 9 Batch A facets could not be SET from the web UI, the facets
endpoint had no in-app consumer, and the registry's libraryTypes hints
rendered nowhere. This phase closes all three.

- ONE UNION-ALL sqlc query (FacetCountsUnderFilters) computes all 14
  listable facets in a single round trip: each arm omits its OWN
  facet's filter block and carries every other registered facet's
  block (copied mechanically from SearchMediaItemsUnified) — classic
  faceted semantics: with filters active each facet counts under the
  others; with none, blocks are neutral and the counts are the v1
  global-per-library ones. One query serves both cases. The 14
  per-column Batch C queries are deleted.
- Endpoint: no facet param → the new all-facets shape
  ({facets: {param: [{value, display?, count}]}}), filters bound via
  the shared ParseMediaSearchParams, library_id optional (the
  All-Libraries view, family lens still enforced); facet=X keeps the
  pinned single-facet shape (now routed through the same query with
  neutral filters).
- SSR partial GET /media-items/facet-panel: templ renders the drawer's
  value lists — registry order, Batch D library-type scoping
  (FacetsForLibraryType: manga_type on manga, reading_direction on
  manga+comics, narrator on audiobooks; All view = union), prettified
  genre labels + language display names, active values marked. Family
  lens: out-of-set explicit library_id is 403.
- Drawer wiring: the panel fetches on drawer open and after every
  apply with the CURRENT filter query string; a value click toggles
  that facet's comma-joined filter (hidden input where the drawer has
  no field — same as deep links) and re-applies the form; chips and
  URL stay in sync. Values are server-rendered (rendering doctrine);
  bookshelf.ts owns only the click/fetch orchestration.
- prettifyGenre moves to internal/utils as the canonical
  implementation (services' display enrichment shares it; templ wraps
  it; the TS port in bookshelf.ts is unchanged).
- Drift guard extended: FacetCountsUnderFiltersParams must carry every
  registry facet's param, the bools as pgtype.Bool.

Tests: under-filter exactness (own-block omission, OR-within,
AND-across), family lens (hidden values absent; 403 on both shapes),
all-shape + pinned-shape coexistence, partial rendering with Batch D
scoping + active marking + 403. Full container suite green except the
documented pre-existing TestAdminCreateUser red.
This commit is contained in:
John O'Keefe committed 2026-10-20 08:24:36 -04:00
1 parent 6152137156
commit f52bb6f073
18 files changed
+3001 -911

No files matched your search

+29
View File
@@ -109,6 +109,35 @@ func TestFacetRegistrySQLDrift(t *testing.T) {
t.Errorf("Batch A facet %s missing from SearchMediaItemsUnified", wire)
}
}
// Phase 7: the counts query (FacetCountsUnderFilters) carries the
// same filter blocks — copied mechanically from the search query —
// so the panel's under-filter counts and the grid's rows can never
// disagree about what a filter means. Reflect the generated params
// struct the same way.
countParamsType := reflect.TypeOf(database.FacetCountsUnderFiltersParams{})
countTags := map[string]bool{}
for i := 0; i < countParamsType.NumField(); i++ {
tag := strings.Split(countParamsType.Field(i).Tag.Get("db"), ",")[0]
countTags[tag] = true
}
for _, want := range []string{"user_id", "library_id", "limit"} {
if !countTags[want] {
t.Errorf("FacetCountsUnderFilters missing %s param", want)
}
}
for _, f := range facetRegistry {
wire := f.WireParam()
if f.Kind == FacetRange {
if !countTags["year_min"] || !countTags["year_max"] {
t.Error("year range must bind year_min/year_max in FacetCountsUnderFilters")
}
continue
}
if !countTags[wire] {
t.Errorf("registry facet %q missing from FacetCountsUnderFilters (each arm binds every OTHER facet's block, so every facet's param must exist)", wire)
}
}
}
func TestFacetsForLibraryType(t *testing.T) {