@reblu/site-blocks 0.31.0 → 0.33.0

package/CHANGELOG.md

@@ -1,5 +1,35 @@
 # @reblu/site-blocks
 
+## 0.33.0
+
+### Minor Changes
+
+- 8c2e641: REB-1236: the order confirmation screen says what happens next for each purchase type.
+  - `@reblu/site-contracts`: `ShopOrder.purchaseTexts?: ShopOrderPurchaseText[]` (`{ kind: 'shipping' | 'pickup' | 'digital' | 'service', label, text }`), one entry per purchase type in the order, with the shop's texts from nexus or their Spanish defaults. Optional: older servers do not send it.
+  - `@reblu/site-blocks`: `OrderConfirmation` renders `order.purchaseTexts` under a confirmed order, with no extra wiring. New optional prop `showPurchaseTexts` (default `true`). An order without the field renders as before.
+
+- fb9bfcc: REB-1236 follow-up: the pickup block of the order confirmation names the pickup point.
+  - `@reblu/site-contracts`: `ShopOrderPurchaseText.place?: { name, address: string[] }`, sent on the `pickup` entry with the pickup point frozen on the order (the same name and address lines as the confirmation email). Optional: absent on other kinds and on older servers.
+  - `@reblu/site-blocks`: `OrderConfirmation` shows that name and address in the pickup block, with no extra wiring.
+
+### Patch Changes
+
+- Updated dependencies [8c2e641]
+- Updated dependencies [fb9bfcc]
+  - @reblu/site-contracts@1.31.0
+
+## 0.32.0
+
+### Minor Changes
+
+- 93143eb: Reviews (REB-1272). `@reblu/site-contracts` exports the `Review` and `ReviewSource` types of `GET /api/site/reviews`. `@reblu/site-client` adds `client.reviews.list({ pageId?, limit? }, cache?)`: the tenant's published reviews in the order set in nexus, optionally only one page's (404 without the tenant's `reviews` module). `@reblu/site-blocks` adds `Reviews`, a Server Component drop-in: a responsive grid with an accessible star rating, the author, the date, the text and a «Ver en <fuente>» link to the original (new tab, `rel="noopener nofollow"`), plus an optional tenant `notice` above or below the grid. Every existing export and namespace is unchanged.
+
+### Patch Changes
+
+- Updated dependencies [25a6af3]
+- Updated dependencies [93143eb]
+  - @reblu/site-contracts@1.30.0
+
 ## 0.31.0
 
 ### Minor Changes

package/README.md

@@ -36,6 +36,7 @@ colour on the red background. See `docs/theming/theming.md`.
 | `ProductTrustItems`, `DEFAULT_TRUST_ICONS`                                                                    | `.`        | Store-wide trust messages from `ShopConfig.productTrustItems`. Server Component. See "Product trust items" below.            |
 | `TrustBadges`, `DEFAULT_TRUST_BADGE_HEADINGS`                                                                 | `.`        | The tenant's trust badges from `client.trustBadges.list()`, grouped by type. Server Component. See "Trust badges" below.     |
 | `ArbitrationBadge`                                                                                            | `.`        | The consumer-arbitration distinctive with its adhesion number, for the footer. Server Component. See "Consumer arbitration badge" below. |
+| `Reviews`                                                                                                     | `.`        | The tenant's published, verifiable reviews from `client.reviews.list()`. Server Component. See "Reviews" below.              |
 | `buildFaqPageJsonLd`, `collectFaqItems`                                                                       | `./seo`    | schema.org `FAQPage` structured data. Directive-free (also on `.`). See "Page blocks" below.                                 |
 | `useCollection`                                                                                               | `./client` | Headless filterable/sortable/paginated collection hook (facets, category, tag, search). Serves both page and blog indexes.   |
 | `Collection`                                                                                                  | `./client` | Token-driven presentational grid over `useCollection`.                                                                       |
@@ -333,7 +334,7 @@ for the wiring steps and a full example app).
 | `CartSummary`         | `.`        | `subtotal`, `discount?`, `autoDiscount?`, `shipping?`, `shippingEnabled?`, `total`, `notice?`                           | Yes                                                                               |
 | `CheckoutLoginPrompt` | `.`        | `open`, `email`, `onEmailChange`, `onClose`, `onSubmitEmail`, `onContinueAsGuest`                                       | Yes (renders `null` when `open` is false)                                         |
 | `CheckoutForm`        | `.`        | `contact`, `onContactChange`, `discountCode`, `onDiscountCodeChange`, `onApplyDiscount`, `onRemoveDiscount`, `onSubmit`, `autoDiscount?` | Yes                                                                               |
-| `OrderConfirmation`   | `.`        | `status`, `order`, `cartHref?`, `onRecheck?`                                                                            | Yes                                                                               |
+| `OrderConfirmation`   | `.`        | `status`, `order`, `cartHref?`, `onRecheck?`, `showPurchaseTexts?`                                                      | Yes                                                                               |
 | `OrderInvoiceLink`    | `.`        | `invoice` (`order.invoice`), `labels?`                                                                                  | Yes (renders `null` without an invoice)                                           |
 | `FullInvoiceFields`   | `.`        | `value`, `onChange`, `overCap`, `errors?`, `countries?`, `labels?`                                                      | Yes (controlled, no hooks)                                                        |
 
@@ -603,6 +604,29 @@ shown instead of a raw placeholder. A SITE that passes its own
 `labels.foundDescription` is unaffected: a text without `{email}` keeps the
 confirmation-email line, exactly as before.
 
+**REB-1236 — what happens next, per purchase type.** The order lookup
+carries `order.purchaseTexts: Array<{ kind, label, text }>`: one entry per
+purchase type in the order (`shipping`, `pickup`, `digital`, `service`; a
+mixed order gets one each, delivery first). `label` is the shop's checkout
+label for that type and `text` the shop's own text from nexus › Tienda ›
+Configuración › Confirmación, or its Spanish default. `OrderConfirmation`
+renders them under a confirmed order (`paid`/`found`/`timeout`) with no extra
+wiring; the SITE writes no copy of its own:
+
+```tsx
+const { status, order, recheck } = useShopOrderStatus(sessionId)
+
+// The per-type texts appear on their own. Pass showPurchaseTexts={false} to hide them.
+<OrderConfirmation status={status} order={order} sessionId={sessionId} onRecheck={recheck} />
+```
+
+The `pickup` entry also carries `place: { name, address }`, the pickup point
+frozen on the order, and the block shows it above the text (the same lines as
+the confirmation email).
+
+A server older than REB-1236 sends no `purchaseTexts`, and the screen renders
+as before.
+
 Every title/description is overridable via `labels` (see
 `OrderConfirmationLabels`). See `@reblu/site-next`'s README
 "`useShopOrderStatus` — the order-confirmation flow" for the full wiring
@@ -927,6 +951,56 @@ import { Truck } from 'my-icon-set'
 `icons` cannot add a new icon key: an item whose `icon` this version does not
 know is still skipped.
 
+## Reviews
+
+`Reviews` (REB-1272) renders the tenant's published reviews, managed in nexus
+(«Reseñas») and served by `client.reviews.list()`: a responsive grid of cards
+with the stars, the text, the author, the date and a «Ver en Google» link to
+the original review. Publishing, hiding or reordering a review in nexus changes
+the SITE on the next revalidation, with no deploy.
+
+```tsx
+import { Reviews } from '@reblu/site-blocks'
+
+export async function HomeReviews() {
+  const { data: reviews } = await client.reviews
+    .list({ limit: 6 }, { revalidate: 3600 })
+    .catch(() => ({ data: [] }))
+  return (
+    <Reviews
+      reviews={reviews}
+      heading='Reseñas verificadas'
+      notice='Reseñas publicadas en Google y Doctoralia; cada una enlaza a su original.'
+    />
+  )
+}
+
+// Only the reviews linked to one page (a treatment, a professional's profile):
+const { data: pageReviews } = await client.reviews.list({ pageId: page.id })
+```
+
+- **Verifiable or not shown.** A review renders only with an `https://` link to
+  its original, a rating of 1 to 5 and an author; anything else is skipped.
+  The link opens in a new tab with `rel="noopener nofollow"` and a visually
+  hidden «(se abre en una pestaña nueva)» (`newWindowLabel`). Its text is
+  `linkLabel(sourceName)`, «Ver en Google» by default.
+- **Notice.** `notice` is the tenant's short text on how its reviews are
+  checked. Spanish consumer law asks a business that shows reviews to say
+  whether and how it ensures they come from real customers; the exact wording
+  is the tenant's (pending legal review, REB-136). It goes below the grid, or
+  above it with `noticePosition='above'`.
+- Stars are one `role="img"` labelled «5 de 5 estrellas». A star-only review
+  (`text: null`) renders without a quote. The date is the calendar day the
+  review was written, formatted in `locale` (default `es-ES`), never shifted
+  by the visitor's time zone.
+- `null`, `undefined` or an empty list render nothing — no heading, no notice.
+- `heading` wraps everything in a `<section aria-labelledby={headingId}>`
+  (default id `reviews-heading`, level `headingLevel`, default 2).
+- Styling hooks: `className`, `cardClassName` (merge with `cn`);
+  `headingClassName`, `gridClassName` and `noticeClassName` follow the REB-997
+  slot rule and REPLACE their defaults (`text-xl font-semibold`,
+  `sm:grid-cols-2 lg:grid-cols-3`, `text-sm text-muted-foreground`).
+
 ## Trust badges
 
 `TrustBadges` renders the tenant's trust badges — partners, insurers, funding,