@reblu/site-blocks 0.23.0 → 0.24.0

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # @reblu/site-blocks
 
+## 0.24.0
+
+### Minor Changes
+
+- c7f3a43: Course catalogue filters are tenant config (REB-1234).
+  - `@reblu/site-contracts`: new `AcademyConfigPublic` and `AcademyCatalogFiltersPublic` types for `GET /api/site/academy/config`.
+  - `@reblu/site-client`: new `client.academy.config()`, returning `{ catalogFilters: { category, instructor, price } }` as switched on in nexus. A filter the tenant never set is `true`.
+  - `@reblu/site-blocks`: `CourseCatalogFilters` gains a category filter (`categories` + `hrefs.category`, `active.category`) and an `enabled` prop. Pass `catalogFilters` as `enabled` and only the switched-on filters render; with all off it renders nothing. Without `enabled` and `categories` the output is unchanged.
+
+### Patch Changes
+
+- Updated dependencies [c7f3a43]
+  - @reblu/site-contracts@1.24.0
+
 ## 0.23.0
 
 ### Minor Changes

package/README.md

@@ -29,7 +29,7 @@ colour on the red background. See `docs/theming/theming.md`.
 | `Treatment`, `ParentPage`, `ProfileCard`, `ProductCard`                                                       | `.`        | Presentational organisms over the SITE API contracts. RSC-safe. `Specialty`: deprecated alias, see below.                    |
 | `ProfessionalFields`                                                                                          | `.`        | The tenant's own professional fields (`professional.fields`) on a team card or profile. RSC-safe. See below.                 |
 | `ShopFilters`                                                                                                 | `.`        | Plug-and-play shop filter chrome over `GET /api/site/shop/facets`. RSC-safe. See "Shop filters" below.                       |
-| `CourseCatalogFilters`, `DEFAULT_COURSE_PRICE_BANDS`                                                         | `.`        | Course catalogue filters by instructor and price (`client.academy.instructors()`). RSC-safe. See "Course catalogue filters". |
+| `CourseCatalogFilters`, `DEFAULT_COURSE_PRICE_BANDS`                                                         | `.`        | Course catalogue filters by category, instructor and price, each switchable per tenant (`client.academy.config()`). RSC-safe. See "Course catalogue filters". |
 | `CartLineList`, `CartSummary`, `CartAdjustmentsNotice`, `AddedToCartToast`, `CheckoutLoginPrompt`, `CheckoutForm`, `OrderConfirmation` | `.`        | Cart & checkout organisms. RSC-safe by construction. See "Cart & checkout" below.                                            |
 | `PageBlocks`, `FaqAccordion`                                                                                  | `.`        | Registry-block renderer (`PageDetail.blocks`) and native `<details>` FAQ. Server Components. See "Page blocks" below.        |
 | `ProductTrustItems`, `DEFAULT_TRUST_ICONS`                                                                    | `.`        | Store-wide trust messages from `ShopConfig.productTrustItems`. Server Component. See "Product trust items" below.            |
@@ -991,13 +991,19 @@ import { CourseSyllabus } from '@reblu/site-blocks/client'
   and `course-syllabus-preview`. No slot was renamed in REB-1135. It renders
   nothing for a course without modules.
 
-## Course catalogue filters — `CourseCatalogFilters` (REB-547)
+## Course catalogue filters — `CourseCatalogFilters` (REB-547, REB-1234)
 
-Drop-in filters for the academy catalogue: an instructor filter fed by
+Drop-in filters for the academy catalogue: a category filter fed by
+`client.academy.categories()`, an instructor filter fed by
 `client.academy.instructors()` (instructors of published courses, sorted by
 name) and a price filter (bands in integer cents plus «Gratis»). Each option
-maps 1:1 onto a `client.academy.courses()` param: `instructor`, `priceMin`,
-`priceMax`, `free`. Same RSC-safe contract as `ShopFilters`: every option is a
+maps 1:1 onto a `client.academy.courses()` param: `category`, `instructor`,
+`priceMin`, `priceMax`, `free`.
+
+Which filters show is the tenant's choice, made in nexus › Formación ›
+Configuración › «Filtros del catálogo» and served by `client.academy.config()`
+as `catalogFilters`. Pass it as `enabled`: the component renders only the
+filters switched on, with no SITE code change when the tenant flips one. Same RSC-safe contract as `ShopFilters`: every option is a
 real `<a href>`; pass `onChange` only from a `'use client'` boundary.
 
 ```tsx
@@ -1013,14 +1019,17 @@ export default async function CoursesPage({
   const sp = await searchParams
   const num = (v?: string) => (v ? Number(v) : undefined)
   const active: AcademyCourseListQuery = {
+    category: sp.category,
     instructor: sp.instructor,
     priceMin: num(sp.priceMin),
     priceMax: num(sp.priceMax),
     free: sp.free === 'true',
   }
-  const [courses, instructors] = await Promise.all([
+  const [courses, categories, instructors, academy] = await Promise.all([
     client.academy.courses(active),
+    client.academy.categories(),
     client.academy.instructors(),
+    client.academy.config(),
   ])
 
   // Keep the other params; `free` and a price band exclude each other.
@@ -1035,10 +1044,14 @@ export default async function CoursesPage({
 
   return (
     <>
+      {/* Your search box stays: it is not a switchable filter. */}
       <CourseCatalogFilters
+        enabled={academy.catalogFilters}
+        categories={categories.data}
         instructors={instructors.data}
         active={active}
         hrefs={{
+          category: (slug) => href({ category: slug }),
           instructor: (id) => href({ instructor: id }),
           price: (min, max) => href({ priceMin: min, priceMax: max, free: false }),
           free: (next) => href({ free: next, priceMin: undefined, priceMax: undefined }),
@@ -1051,6 +1064,15 @@ export default async function CoursesPage({
 }
 ```
 
+- **Tenant switches.** `enabled` takes `{ category, instructor, price }`; a
+  key that is missing counts as on, so leaving out `enabled` shows every filter
+  (the behaviour before REB-1234). A tenant that never set the switches gets
+  all three `true` from `client.academy.config()`. With every filter off the
+  component renders nothing, and the search box (yours) stays.
+- **Category needs data and an href.** The category group shows only with
+  `categories` and `hrefs.category`; without them the component behaves as
+  before. An active category slug that is no longer listed keeps the group
+  visible, so it can be cleared.
 - **Price is integer cents.** The default bands (`DEFAULT_COURSE_PRICE_BANDS`)
   are EUR: up to 50, 50 to 150, 150 to 300, from 300. Pass `priceBands` for
   another catalogue and `currencyCode` / `locale` for the labels.

package/dist/index.cjs

@@ -14824,6 +14824,8 @@ var DEFAULT_COURSE_PRICE_BANDS = [
   { min: 3e4 }
 ];
 var DEFAULT_COURSE_CATALOG_FILTERS_LABELS = {
+  category: "Categor\xEDa",
+  allCategories: "Todas",
   instructor: "Docente",
   allInstructors: "Todos",
   price: "Precio",
@@ -14847,6 +14849,8 @@ function bandLabel(band, t, currencyCode, locale) {
 }
 function CourseCatalogFilters({
   instructors,
+  categories = [],
+  enabled = {},
   hrefs,
   active = {},
   onChange,
@@ -14858,9 +14862,39 @@ function CourseCatalogFilters({
 }) {
   const t = { ...DEFAULT_COURSE_CATALOG_FILTERS_LABELS, ...labels };
   const named = instructors.filter((i) => instructorName(i) !== "");
-  const showInstructors = named.length > 0 || active.instructor !== void 0;
+  const sortedCategories = [...categories].sort((a, b2) => a.sortOrder - b2.sortOrder);
+  const categoryHref = hrefs.category;
+  const showCategories = enabled.category !== false && categoryHref !== void 0 && (sortedCategories.length > 0 || active.category !== void 0);
+  const showInstructors = enabled.instructor !== false && (named.length > 0 || active.instructor !== void 0);
+  const showPrice = enabled.price !== false;
   const isFree = Boolean(active.free);
+  if (!showCategories && !showInstructors && !showPrice) return null;
   return /* @__PURE__ */ (0, import_jsx_runtime17.jsxs)("div", { className: (0, import_utils15.cn)("space-y-6", className), "data-slot": "course-catalog-filters", children: [
+    showCategories && /* @__PURE__ */ (0, import_jsx_runtime17.jsxs)(FilterFieldset, { legend: t.category, children: [
+      /* @__PURE__ */ (0, import_jsx_runtime17.jsx)(
+        OptionLink,
+        {
+          href: categoryHref(void 0),
+          active: active.category === void 0,
+          label: t.allCategories,
+          onActivate: onChange ? () => onChange({ category: void 0 }) : void 0
+        }
+      ),
+      sortedCategories.map((category) => {
+        const isActive = active.category === category.slug;
+        const next2 = isActive ? void 0 : category.slug;
+        return /* @__PURE__ */ (0, import_jsx_runtime17.jsx)(
+          OptionLink,
+          {
+            href: categoryHref(next2),
+            active: isActive,
+            label: category.name,
+            onActivate: onChange ? () => onChange({ category: next2 }) : void 0
+          },
+          category.id
+        );
+      })
+    ] }),
     showInstructors && /* @__PURE__ */ (0, import_jsx_runtime17.jsxs)(FilterFieldset, { legend: t.instructor, children: [
       /* @__PURE__ */ (0, import_jsx_runtime17.jsx)(
         OptionLink,
@@ -14886,7 +14920,7 @@ function CourseCatalogFilters({
         );
       })
     ] }),
-    /* @__PURE__ */ (0, import_jsx_runtime17.jsxs)(FilterFieldset, { legend: t.price, children: [
+    showPrice && /* @__PURE__ */ (0, import_jsx_runtime17.jsxs)(FilterFieldset, { legend: t.price, children: [
       /* @__PURE__ */ (0, import_jsx_runtime17.jsx)(
         OptionLink,
         {
@@ -14921,6 +14955,7 @@ function CourseCatalogFilters({
         onClick: onChange ? (event) => {
           event.preventDefault();
           onChange({
+            category: void 0,
             instructor: void 0,
             priceMin: void 0,
             priceMax: void 0,