@reblu/site-contracts 1.11.0 → 1.12.0

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @reblu/site-contracts
 
+## 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

@@ -169,6 +169,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;}
 

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;}
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reblu/site-contracts",
-  "version": "1.11.0",
+  "version": "1.12.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",