@reblu/site-contracts 1.12.0 → 1.13.0

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @reblu/site-contracts
 
+## 1.13.0
+
+### Minor Changes
+
+- 7a00471: Featured pages per page category (REB-869). `@reblu/site-contracts` adds `PagesListQuery`, the query of `GET /api/site/pages`, including the new `featured` flag. `@reblu/site-client`: `pages.list({ category, featured: true })` returns that category's featured pages (max 3) in the tenant's order, skipping unpublished, deleted or moved pages, and an empty list when nothing is featured; the new `pages.featured(category, { limit?, fallback?, cache? })` helper returns the featured pages, or the category's first `limit` pages in normal order when none are featured, so a landing teaser is never empty. `limit` must be an integer >= 1: above 3 it is clamped to 3; 0, negative, fractional or NaN throw a `RangeError` before any request. Against an API that predates `featured`, the flag is ignored and `pages.featured()` silently degrades to the category's first `limit` pages. `@reblu/site-blocks` adds `PageCardGrid`, the page-card grid `ParentPage` already rendered for its child pages, as a drop-in (`pages`, `pageHref`, `heading`); cards are keyed by category + slug, an empty `heading` renders no `<h2>`. `ParentPage` now renders through it with unchanged markup (including the empty `<h2>` for `childPagesLabel=''`).
+
 ## 1.12.0
 
 ### Minor Changes

package/README.md

@@ -132,6 +132,16 @@ may exist in both `tratamientos` and `especialidades`. Consequences for a SITE:
   legacy slug-only reference **only when that slug is unique** — otherwise
   `resolved` is `null`. Build the embed's href from `resolved.category`.
 
+### Featured pages per category (REB-869)
+
+`PagesListQuery` is the query of `GET /api/site/pages`. With `category` set,
+`featured: true` returns that category's featured pages (max 3) in the order
+the tenant chose in nexus, instead of the normal listing. Unpublished,
+deleted or moved pages are skipped; nothing featured → empty `data` (the API
+never falls back). For a teaser that falls back to the category's first pages,
+use `@reblu/site-client`'s `pages.featured(category)` with
+`@reblu/site-blocks`' `PageCardGrid`.
+
 ### Shop — product trust items (REB-858)
 
 `ShopConfig.productTrustItems` is the store-wide list of short trust messages

package/dist/index.d.cts

@@ -111,6 +111,8 @@ export type PageSlug = {    slug: string;    type: "SERVICE" | "CUSTOM";    upda
 
 export type PageType = "custom" | "service" | "treatments" | "specialties" | "team" | "generic"
 
+export type PagesListQuery = {    type?: ("custom" | "service" | "treatments" | "specialties" | "team" | "generic")[] | undefined;    category?: string | undefined;    page?: unknown;    pageSize?: unknown;    sort?: "order" | "-publishedAt" | undefined;    featured?: boolean | undefined;}
+
 export type PagesListSort = "order" | "-publishedAt"
 
 export type PaginationMeta = {    total?: number | undefined;    page?: number | undefined;    limit?: number | undefined;    pages?: number | undefined;}

package/dist/index.d.ts

@@ -111,6 +111,8 @@ export type PageSlug = {    slug: string;    type: "SERVICE" | "CUSTOM";    upda
 
 export type PageType = "custom" | "service" | "treatments" | "specialties" | "team" | "generic"
 
+export type PagesListQuery = {    type?: ("custom" | "service" | "treatments" | "specialties" | "team" | "generic")[] | undefined;    category?: string | undefined;    page?: unknown;    pageSize?: unknown;    sort?: "order" | "-publishedAt" | undefined;    featured?: boolean | undefined;}
+
 export type PagesListSort = "order" | "-publishedAt"
 
 export type PaginationMeta = {    total?: number | undefined;    page?: number | undefined;    limit?: number | undefined;    pages?: number | undefined;}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reblu/site-contracts",
-  "version": "1.12.0",
+  "version": "1.13.0",
   "private": false,
   "description": "Public, dependency-free TypeScript types for the Reblu SITE API (types only — no Zod, no Prisma at runtime).",
   "license": "Apache-2.0",