@reblu/site-blocks 0.21.0 → 0.22.0

package/CHANGELOG.md

@@ -1,5 +1,27 @@
 # @reblu/site-blocks
 
+## 0.22.0
+
+### Minor Changes
+
+- 01d0e15: Academy catalogue filters by price and instructor (REB-547). `@reblu/site-contracts` exports `AcademyCourseListQuery`, the documented query of `GET /api/site/academy/courses`. `@reblu/site-client` adds `academy.instructors()` (instructors of published courses, for the filter), and `AcademyCourseListParams` is now that query type, so the SDK cannot drift from the API. `@reblu/site-blocks` adds `CourseCatalogFilters`, a drop-in instructor and price filter (bands in integer cents plus «Gratis»), RSC-safe like `ShopFilters`.
+- d1db04e: Tenant-configurable interest question on the contact form (REB-759).
+  - `Config.contactInterest`: `{ label, options }` or `null`, the tenant's own question and options from nexus. `null` means the field must not render; there is no default catalogue.
+  - `ContactFormInput.interests`: the chosen option labels (up to 20). The server keeps only labels the tenant offers.
+  - New drop-in `ContactInterestField` in `@reblu/site-blocks`: a controlled checkbox group that renders nothing when the tenant has no question. Slots: `contact-interest`, `contact-interest-option`.
+
+- 5ca48ee: Discount code usage limits are enforced before payment (REB-912).
+  - New `ShopErrorCode` `DISCOUNT_LIMIT_REACHED` (400): checkout refuses a discount code that has used up its total uses (slots held by open payment sessions count), before any payment session is created. The buyer can continue without the code.
+  - `DEFAULT_SHOP_ERROR_MESSAGES.DISCOUNT_LIMIT_REACHED`: «Este código ya ha alcanzado su límite de usos».
+  - A per-customer limit still answers `DISCOUNT_INVALID` with a neutral message.
+
+### Patch Changes
+
+- Updated dependencies [01d0e15]
+- Updated dependencies [d1db04e]
+- Updated dependencies [5ca48ee]
+  - @reblu/site-contracts@1.22.0
+
 ## 0.21.0
 
 ### Minor Changes

package/README.md

@@ -29,6 +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". |
 | `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.            |
@@ -634,6 +635,27 @@ NIF/NIE or ID document, name and billing address), `INVOICING_NOT_READY`
 (503) and `FULL_INVOICE_UNAVAILABLE` (422 — `wantsFullInvoice: true` sent to a
 shop that issues no invoices).
 
+A discount code that has used up its total uses is refused by checkout
+BEFORE any payment session exists, with `DISCOUNT_LIMIT_REACHED` (400, REB-912)
+and the default copy «Este código ya ha alcanzado su límite de usos». Let the
+buyer remove the code and continue; nothing was charged. Slots held by open
+payment sessions count, so the last use can never be sold twice. A
+per-customer limit keeps answering `DISCOUNT_INVALID` with a neutral message,
+so the response never reveals whether an email already bought.
+
+```tsx
+import { getShopErrorMessage } from '@reblu/site-blocks'
+import { ApiError } from '@reblu/site-client'
+
+try {
+  await client.shop.checkout(body)
+} catch (error) {
+  if (error instanceof ApiError && error.body?.code === 'DISCOUNT_LIMIT_REACHED') {
+    setDiscountError(getShopErrorMessage('DISCOUNT_LIMIT_REACHED')) // offer «continuar sin código»
+  }
+}
+```
+
 ## Product trust items
 
 `ProductTrustItems` renders the store-wide trust messages (shipping, returns,
@@ -969,6 +991,78 @@ 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)
+
+Drop-in filters for the academy catalogue: 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
+real `<a href>`; pass `onChange` only from a `'use client'` boundary.
+
+```tsx
+import { CourseCatalogFilters } from '@reblu/site-blocks'
+import type { AcademyCourseListQuery } from '@reblu/site-contracts'
+import { client } from '@/lib/reblu'
+
+export default async function CoursesPage({
+  searchParams,
+}: {
+  searchParams: Promise<Record<string, string | undefined>>
+}) {
+  const sp = await searchParams
+  const num = (v?: string) => (v ? Number(v) : undefined)
+  const active: AcademyCourseListQuery = {
+    instructor: sp.instructor,
+    priceMin: num(sp.priceMin),
+    priceMax: num(sp.priceMax),
+    free: sp.free === 'true',
+  }
+  const [courses, instructors] = await Promise.all([
+    client.academy.courses(active),
+    client.academy.instructors(),
+  ])
+
+  // Keep the other params; `free` and a price band exclude each other.
+  const href = (patch: Partial<AcademyCourseListQuery>) => {
+    const next = new URLSearchParams()
+    for (const [k, v] of Object.entries({ ...active, ...patch })) {
+      if (v !== undefined && v !== false) next.set(k, String(v))
+    }
+    const qs = next.toString()
+    return qs ? `/cursos?${qs}` : '/cursos'
+  }
+
+  return (
+    <>
+      <CourseCatalogFilters
+        instructors={instructors.data}
+        active={active}
+        hrefs={{
+          instructor: (id) => href({ instructor: id }),
+          price: (min, max) => href({ priceMin: min, priceMax: max, free: false }),
+          free: (next) => href({ free: next, priceMin: undefined, priceMax: undefined }),
+          clearAll: () => '/cursos',
+        }}
+      />
+      {/* render courses.data */}
+    </>
+  )
+}
+```
+
+- **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.
+- **«Gratis» wins.** The API applies `free=true` over any price range, so no
+  band shows as active while it is on; the component's `onChange` patches turn
+  one off when the other is picked, and `hrefs` should do the same.
+- **Unnamed instructors** (no first or last name) are not offered. An active
+  instructor id that is no longer listed keeps the group visible, so it can be
+  cleared.
+- Spanish default labels (`DEFAULT_COURSE_CATALOG_FILTERS_LABELS`), all
+  overridable through `labels`.
+
 ## Free-preview lesson — `LessonPreview` (REB-1135)
 
 A lesson the owner marked «Vista previa gratuita», for visitors who have not
@@ -1171,6 +1265,37 @@ renderer (`headingOffset` demotes its headings under yours).
 `markdownToPlainText` drops images and anything the sanitiser strips, and cuts
 at a word boundary with `…` within `maxLength`.
 
+## Contact form interest question — `ContactInterestField` (REB-759)
+
+The tenant's own optional question on the contact form, e.g. «¿Qué tratamiento
+te interesa?», with the options it configured in nexus (Integraciones →
+Formulario de Contacto). Pass `config.contactInterest` from `/api/site/config`
+and send the chosen labels as `interests`. Unconfigured (`null`, or an older
+base-api) renders nothing. **Never supply your own fallback list**: there is no
+default catalogue, and the server keeps only labels the tenant offers.
+
+```tsx
+'use client'
+import { useState } from 'react'
+import { ContactInterestField } from '@reblu/site-blocks'
+import type { Config } from '@reblu/site-contracts'
+
+export function ContactFormInterest({ config }: { config: Config }) {
+  const [interests, setInterests] = useState<string[]>([])
+  // ...on submit: client.contactForm.submit({ ...fields, interests })
+  return (
+    <ContactInterestField
+      interest={config.contactInterest}
+      value={interests}
+      onChange={setInterests}
+    />
+  )
+}
+```
+
+Styling: `data-slot="contact-interest"` (the `<fieldset>`, its `<legend>` is the
+question) and `data-slot="contact-interest-option"` (each `<label>`).
+
 ## GDPR rights form — `DataRequestForm` (REB-980)
 
 Drop-in form for a SITE's public rights page (e.g. `/derechos-rgpd`): request