@reblu/site-contracts 1.11.0 → 1.13.0

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @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
+
+- fd17765: Site-level SEO (REB-651). `Config` gains optional `seoTitle`, `seoDescription` and `canonicalUrl`, all `string | null`. `seoTitle` and `seoDescription` are the site's own search title and description (the home page), apart from `siteName` and `siteDescription`; `null` means never set, so fall back to `siteName` and `siteDescription`. A set `seoTitle` is used as-is and never gets the template suffix. `canonicalUrl` is the site's https origin (no trailing slash), to use as Next's `metadataBase`. Purely additive.
+
 ## 1.11.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
@@ -169,6 +179,21 @@ another `"… · Brand"` template. For list/index routes, or an older API withou
 `@reblu/site-next/seo`. Both fields are optional in the types so the minor stays
 additive; `seoTitle`/`metaTitle` are unchanged.
 
+### Site SEO title, description and canonical URL (REB-651)
+
+`Config` carries the site's own search fields, apart from the identity fields
+`siteName`/`siteDescription` (which stay short for breadcrumbs and chrome):
+
+- `seoTitle` — the home page title. When set it is used **as-is**, never
+  suffixed by `seoTitleTemplate`. `null` → use `siteName`.
+- `seoDescription` — the home page description. `null` → `siteDescription`.
+- `canonicalUrl` — the site origin, `https://…` with no trailing slash, or
+  `null`. Use it as Next's `metadataBase` so relative Open Graph paths resolve.
+
+They are served raw (`null` = never set). `buildMetadata({ config, home: true })`
+from `@reblu/site-next/seo` applies the fallbacks for you. All three are
+optional in the types so the minor stays additive.
+
 ## How the types stay correct
 
 The types are re-derived from the response schemas that live in the Reblu API

package/dist/index.d.cts

@@ -45,7 +45,7 @@ export type BlogSlug = {    slug: string;    updatedAt: string;}
 
 export type BlogTag = {    id: string;    name: string;    slug: string;    color: string;}
 
-export type Config = {    siteName: string;    siteDescription: string | null;    language: string | null;    contactEmail: string | null;    keywords: string[];    businessType: string | null;    isSetupComplete: boolean;    logoLightExpandedUrl: string | null;    logoDarkExpandedUrl: string | null;    logoLightSmallUrl: string | null;    logoDarkSmallUrl: string | null;    ogImageUrl: string | null;    owner: {        name: string | null;        email: string | null;        jobTitle: string | null;    };    business: {        name: string | null;    };    address: {        street: string | null;        city: string | null;        region: string | null;        postalCode: string | null;        country: string | null;        telephone: string | null;        lat: number | null;        lng: number | null;    } | null;    fiscal: {        taxId: string | null;        taxIdKind: "NIF" | "CIF" | null;        legalName: string | null;        registry: {            name: string;            number: string;        } | null;    } | null;    social: {        linkedin: string | null;        twitter: string | null;        facebook: string | null;        instagram: string | null;        youtube: string | null;    } | null;    metadata: unknown;    openingHours: {        ranges: {            days: ("MON" | "TUE" | "WED" | "THU" | "FRI" | "SAT" | "SUN")[];            opens: string;            closes: string;        }[];        note?: string | undefined;    } | null;    contactFormMode: "NOT_CONFIGURED" | "DISABLED" | "DB_ONLY" | "WEBHOOK" | "RESEND";    features: Record<string, unknown>;    seoTitleTemplate?: string | undefined;}
+export type Config = {    siteName: string;    siteDescription: string | null;    language: string | null;    contactEmail: string | null;    keywords: string[];    businessType: string | null;    isSetupComplete: boolean;    logoLightExpandedUrl: string | null;    logoDarkExpandedUrl: string | null;    logoLightSmallUrl: string | null;    logoDarkSmallUrl: string | null;    ogImageUrl: string | null;    owner: {        name: string | null;        email: string | null;        jobTitle: string | null;    };    business: {        name: string | null;    };    address: {        street: string | null;        city: string | null;        region: string | null;        postalCode: string | null;        country: string | null;        telephone: string | null;        lat: number | null;        lng: number | null;    } | null;    fiscal: {        taxId: string | null;        taxIdKind: "NIF" | "CIF" | null;        legalName: string | null;        registry: {            name: string;            number: string;        } | null;    } | null;    social: {        linkedin: string | null;        twitter: string | null;        facebook: string | null;        instagram: string | null;        youtube: string | null;    } | null;    metadata: unknown;    openingHours: {        ranges: {            days: ("MON" | "TUE" | "WED" | "THU" | "FRI" | "SAT" | "SUN")[];            opens: string;            closes: string;        }[];        note?: string | undefined;    } | null;    contactFormMode: "NOT_CONFIGURED" | "DISABLED" | "DB_ONLY" | "WEBHOOK" | "RESEND";    features: Record<string, unknown>;    seoTitleTemplate?: string | undefined;    seoTitle?: string | null | undefined;    seoDescription?: string | null | undefined;    canonicalUrl?: string | null | undefined;}
 
 export type ConfigAddress = {    street: string | null;    city: string | null;    region: string | null;    postalCode: string | null;    country: string | null;    telephone: string | null;    lat: number | null;    lng: number | null;}
 
@@ -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

@@ -45,7 +45,7 @@ export type BlogSlug = {    slug: string;    updatedAt: string;}
 
 export type BlogTag = {    id: string;    name: string;    slug: string;    color: string;}
 
-export type Config = {    siteName: string;    siteDescription: string | null;    language: string | null;    contactEmail: string | null;    keywords: string[];    businessType: string | null;    isSetupComplete: boolean;    logoLightExpandedUrl: string | null;    logoDarkExpandedUrl: string | null;    logoLightSmallUrl: string | null;    logoDarkSmallUrl: string | null;    ogImageUrl: string | null;    owner: {        name: string | null;        email: string | null;        jobTitle: string | null;    };    business: {        name: string | null;    };    address: {        street: string | null;        city: string | null;        region: string | null;        postalCode: string | null;        country: string | null;        telephone: string | null;        lat: number | null;        lng: number | null;    } | null;    fiscal: {        taxId: string | null;        taxIdKind: "NIF" | "CIF" | null;        legalName: string | null;        registry: {            name: string;            number: string;        } | null;    } | null;    social: {        linkedin: string | null;        twitter: string | null;        facebook: string | null;        instagram: string | null;        youtube: string | null;    } | null;    metadata: unknown;    openingHours: {        ranges: {            days: ("MON" | "TUE" | "WED" | "THU" | "FRI" | "SAT" | "SUN")[];            opens: string;            closes: string;        }[];        note?: string | undefined;    } | null;    contactFormMode: "NOT_CONFIGURED" | "DISABLED" | "DB_ONLY" | "WEBHOOK" | "RESEND";    features: Record<string, unknown>;    seoTitleTemplate?: string | undefined;}
+export type Config = {    siteName: string;    siteDescription: string | null;    language: string | null;    contactEmail: string | null;    keywords: string[];    businessType: string | null;    isSetupComplete: boolean;    logoLightExpandedUrl: string | null;    logoDarkExpandedUrl: string | null;    logoLightSmallUrl: string | null;    logoDarkSmallUrl: string | null;    ogImageUrl: string | null;    owner: {        name: string | null;        email: string | null;        jobTitle: string | null;    };    business: {        name: string | null;    };    address: {        street: string | null;        city: string | null;        region: string | null;        postalCode: string | null;        country: string | null;        telephone: string | null;        lat: number | null;        lng: number | null;    } | null;    fiscal: {        taxId: string | null;        taxIdKind: "NIF" | "CIF" | null;        legalName: string | null;        registry: {            name: string;            number: string;        } | null;    } | null;    social: {        linkedin: string | null;        twitter: string | null;        facebook: string | null;        instagram: string | null;        youtube: string | null;    } | null;    metadata: unknown;    openingHours: {        ranges: {            days: ("MON" | "TUE" | "WED" | "THU" | "FRI" | "SAT" | "SUN")[];            opens: string;            closes: string;        }[];        note?: string | undefined;    } | null;    contactFormMode: "NOT_CONFIGURED" | "DISABLED" | "DB_ONLY" | "WEBHOOK" | "RESEND";    features: Record<string, unknown>;    seoTitleTemplate?: string | undefined;    seoTitle?: string | null | undefined;    seoDescription?: string | null | undefined;    canonicalUrl?: string | null | undefined;}
 
 export type ConfigAddress = {    street: string | null;    city: string | null;    region: string | null;    postalCode: string | null;    country: string | null;    telephone: string | null;    lat: number | null;    lng: number | null;}
 
@@ -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.11.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",