@reblu/site-blocks 0.23.0 → 0.25.0

package/CHANGELOG.md

@@ -1,5 +1,31 @@
 # @reblu/site-blocks
 
+## 0.25.0
+
+### Minor Changes
+
+- 1860554: New `CoursePurchaseTerms`: the drop-in for what a buyer must see before paying for a course (REB-1199). It shows the withdrawal waiver, the access duration and the refund guarantee from `AcademyCourseDetail`. Each term renders only when the course carries it; with none, nothing renders. It is a Server Component. The default copy is Spanish and can be replaced with `labels`. Also exports `DEFAULT_COURSE_PURCHASE_TERMS_LABELS`.
+
+### Patch Changes
+
+- Updated dependencies [1860554]
+- Updated dependencies [82ab415]
+  - @reblu/site-contracts@1.25.0
+
+## 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

@@ -25,11 +25,12 @@ colour on the red background. See `docs/theming/theming.md`.
 | `sanitizeHtml`                                                                                                | `.`        | Sanitises an HTML string before `dangerouslySetInnerHTML` — the **HTML boundary**. See "Security boundaries" below.          |
 | `MarkdownRenderer`                                                                                            | `.`        | Canonical Blog renderer: `marked` → **hast-util-sanitize** (XSS) → component map, with a YouTube-domain allowlist. RSC-safe. |
 | `CourseDescription`                                                                                           | `.`        | Drop-in for the rich-text course `description` (`client.academy.bySlug()`). Server Component. See "Rich-text descriptions".  |
+| `CoursePurchaseTerms`, `DEFAULT_COURSE_PURCHASE_TERMS_LABELS`                                                 | `.`        | What the buyer sees before paying: withdrawal waiver, access duration, refund guarantee. Server Component. See "Course purchase terms". |
 | `LessonPreview`, `DEFAULT_LESSON_PREVIEW_LABELS`                                                              | `.`        | A public free-preview lesson: hosted video player + sanitised body (`getLessonPreview()`). Server Component. See "Free-preview lesson".  |
 | `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 +992,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 +1020,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 +1045,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 +1065,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.
@@ -1105,6 +1128,33 @@ export default async function Page({ params }) {
   `lesson-preview-badge`, `lesson-preview-duration`, `lesson-preview-player`,
   `lesson-preview-content`.
 
+## Course purchase terms — `CoursePurchaseTerms` (REB-1199)
+
+What a buyer must see before paying for a course, from `client.academy.bySlug()`:
+
+- **Withdrawal waiver** (`withdrawalWaiverRequired`): checkout asks for a separate box in which the buyer requests immediate access and waives the 14-day withdrawal right.
+- **Access duration** (`accessDurationMonths`): months of access after enrolment. `null` means no end date, and nothing is shown.
+- **Refund guarantee** (`refundGuarantee`): the course's terms. `null` means none, and nothing is shown.
+
+Each term renders only when the course carries it. A course with none renders nothing, not even the heading. It is a Server Component, RSC-safe. The copy is Spanish and neutral; replace any text with `labels`.
+
+```tsx
+import { CoursePurchaseTerms } from '@reblu/site-blocks'
+
+const course = await client.academy.bySlug(slug)
+
+<CoursePurchaseTerms course={course} heading='Antes de comprar' />
+
+// In another language:
+<CoursePurchaseTerms
+  course={course}
+  labels={{
+    withdrawalWaiver: 'Immediate access: you waive the 14-day withdrawal right.',
+    accessDuration: (months) => `Access for ${months} months.`,
+  }}
+/>
+```
+
 ## Page blocks
 
 `PageBlocks` renders a page's registry blocks (`PageDetail.blocks` from