@reblu/site-contracts 1.2.0 → 1.4.0

package/CHANGELOG.md

@@ -1,5 +1,35 @@
 # @reblu/site-contracts
 
+## 1.4.0
+
+### Minor Changes
+
+- 87b7fa0: Add typed `Config.openingHours` (REB-826): `ConfigOpeningHours`,
+  `ConfigOpeningHoursRange`, `ConfigOpeningHoursDay`.
+
+  Additive: a new optional-shaped (`null` when not configured) field on the
+  existing `Config` type. A SITE build that has not migrated its `Config` type
+  yet keeps working unchanged — the extra field is simply ignored at runtime.
+  Replaces the previous untyped convention of stashing opening hours inside
+  `Config.metadata`.
+
+## 1.3.0
+
+### Minor Changes
+
+- baa36cf: Expose each taxonomy axis's selection mode on `ShopFacets` (REB-809).
+
+  `ShopFacets.taxonomies[].selectionMode` is a new required field: `'single' |
+'multiple'`, mirroring REB-801's per-axis `TaxonomySelectionMode`. It reflects
+  how many terms a PRODUCT may carry on that axis, not how many the SITE
+  storefront filter may select at once — `GET /api/site/shop/products`'s
+  `taxonomy[<key>]` param still accepts only one term slug per axis regardless
+  of this value (see `@reblu/site-blocks`'s `ShopFilters` docs).
+
+  Additive: a new required field on the existing `ShopFacets` shape, populated
+  for every axis. A SITE build that has not migrated its `ShopFacets` type yet
+  keeps working unchanged — the extra field is simply ignored at runtime.
+
 ## 1.2.0
 
 ### Minor Changes
@@ -20,6 +50,43 @@
   new exported type. The existing `validationFieldLabel` field is unchanged and
   still present for a SITE build that has not migrated to the new array yet.
 
+- 7ff47d7: Add the cookie-consent fields to `Analytics` (REB-642). _Entry added after
+  publishing (REB-787): these fields shipped in 1.2.0, but no changeset
+  targeted this package, so the generated notes above left them out._
+
+  `GET /api/site/analytics` now also returns what a SITE needs to run the
+  `@reblu/site-next/consent` banner. There is still one request, and the root
+  layout already makes it:
+  - `consentRequired: boolean`: `true` when the tenant has a valid GA4 or
+    Clarity id (computed from the already-validated `gaId`/`clarityId`, so an
+    id that fails validation never requires a banner). reCAPTCHA is excluded
+    on purpose because it is strictly necessary. `false` means no configured
+    vendor needs consent, so the SITE can skip the banner.
+    `<ConsentedAnalytics>` does not read this field.
+  - `cookiePolicyVersion: string | null`: a content hash of the tenant's cookie
+    policy. It is the same algorithm as `cookiePolicyVersion()` in
+    `@reblu/site-next/consent-server` on the same text, and a shared test
+    vector keeps the two identical. Pass it to
+    `<ConsentProvider policyVersion>`. When the tenant edits the policy in
+    nexus, the hash changes and visitors are asked again. `null` means no
+    policy is stored.
+  - `cookieBanner`: the banner copy the tenant edits in nexus:
+    `{ enabled, title, body, acceptLabel, rejectLabel, manageLabel, policyUrl }`.
+    A `null` text field means the SDK default applies. Map `body` to the
+    banner's `description` text and `policyUrl` to `policyHref`. The buttons
+    and categories are fixed and have no field here.
+  - `cookieInventory`: `{ vendor, category }[]`, where `category` is
+    `'necessary' | 'analytics' | 'marketing'`. It lists only the vendors this
+    SITE actually loads, and is meant for the cookie-policy table.
+
+  **Consumer note:** the four fields are required on the `Analytics` type.
+  Runtime responses always include them, but code that builds an `Analytics`
+  object by hand (for example test fixtures) must now set them. A neutral
+  fixture is `consentRequired: false`, `cookiePolicyVersion: null`,
+  `cookieBanner: { enabled: true, title: null, body: null, acceptLabel: null,
+rejectLabel: null, manageLabel: null, policyUrl: null }`,
+  `cookieInventory: []`.
+
 ## 1.1.0
 
 ### Minor Changes

package/dist/index.d.cts

@@ -39,7 +39,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;    contactFormMode: "NOT_CONFIGURED" | "DISABLED" | "DB_ONLY" | "WEBHOOK" | "RESEND";    features: Record<string, unknown>;}
+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>;}
 
 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;}
 
@@ -47,6 +47,12 @@ export type ConfigFiscal = {    taxId: string | null;    taxIdKind: "NIF" | "CIF
 
 export type ConfigFiscalRegistry = {    name: string;    number: string;}
 
+export type ConfigOpeningHours = {    ranges: {        days: ("MON" | "TUE" | "WED" | "THU" | "FRI" | "SAT" | "SUN")[];        opens: string;        closes: string;    }[];    note?: string | undefined;}
+
+export type ConfigOpeningHoursDay = "MON" | "TUE" | "WED" | "THU" | "FRI" | "SAT" | "SUN"
+
+export type ConfigOpeningHoursRange = {    days: ("MON" | "TUE" | "WED" | "THU" | "FRI" | "SAT" | "SUN")[];    opens: string;    closes: string;}
+
 export type ConfigSocial = {    linkedin: string | null;    twitter: string | null;    facebook: string | null;    instagram: string | null;    youtube: string | null;}
 
 export type ConfigTaxIdKind = "NIF" | "CIF"
@@ -145,7 +151,7 @@ export type ShopDiscountApplication = {    valid: boolean;    discount: number;
 
 export type ShopEmailCheck = {    exists: boolean;}
 
-export type ShopFacets = {    taxonomies: {        key: string;        label: string;        showAsBadge: boolean;        terms: {            slug: string;            name: string;            count: number;        }[];    }[];    attributes: {        key: string;        label: string;        valueType: "boolean" | "text" | "select" | "multiselect";        options: {            value: string;            label: string;            count: number;        }[];    }[];    price: {        min: number;        max: number;    };    onSale: {        count: number;    };}
+export type ShopFacets = {    taxonomies: {        key: string;        label: string;        showAsBadge: boolean;        selectionMode: "single" | "multiple";        terms: {            slug: string;            name: string;            count: number;        }[];    }[];    attributes: {        key: string;        label: string;        valueType: "boolean" | "text" | "select" | "multiselect";        options: {            value: string;            label: string;            count: number;        }[];    }[];    price: {        min: number;        max: number;    };    onSale: {        count: number;    };}
 
 export type ShopInventoryRef = {    stockQuantity: number;    reservedQuantity: number;    lowStockThreshold: number | null;}
 
@@ -171,6 +177,8 @@ export type ShopSort = "price_asc" | "price_desc" | "newest" | "on_sale"
 
 export type ShopTaxRateRef = {    rate: number;    type: "IVA" | "IGIC" | "RETENTION" | "OTHER";    isExempt: boolean;}
 
+export type ShopTaxonomySelectionMode = "single" | "multiple"
+
 export type ShopTaxonomyTermRef = {    taxonomyKey: string;    taxonomyLabel: string;    showAsBadge: boolean;    slug: string;    name: string;    imageUrl: string | null;}
 
 export type ShopValidateCartInput = {    items: {        productId: string;        quantity: number;        variantId?: string | null | undefined;    }[];}

package/dist/index.d.ts

@@ -39,7 +39,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;    contactFormMode: "NOT_CONFIGURED" | "DISABLED" | "DB_ONLY" | "WEBHOOK" | "RESEND";    features: Record<string, unknown>;}
+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>;}
 
 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;}
 
@@ -47,6 +47,12 @@ export type ConfigFiscal = {    taxId: string | null;    taxIdKind: "NIF" | "CIF
 
 export type ConfigFiscalRegistry = {    name: string;    number: string;}
 
+export type ConfigOpeningHours = {    ranges: {        days: ("MON" | "TUE" | "WED" | "THU" | "FRI" | "SAT" | "SUN")[];        opens: string;        closes: string;    }[];    note?: string | undefined;}
+
+export type ConfigOpeningHoursDay = "MON" | "TUE" | "WED" | "THU" | "FRI" | "SAT" | "SUN"
+
+export type ConfigOpeningHoursRange = {    days: ("MON" | "TUE" | "WED" | "THU" | "FRI" | "SAT" | "SUN")[];    opens: string;    closes: string;}
+
 export type ConfigSocial = {    linkedin: string | null;    twitter: string | null;    facebook: string | null;    instagram: string | null;    youtube: string | null;}
 
 export type ConfigTaxIdKind = "NIF" | "CIF"
@@ -145,7 +151,7 @@ export type ShopDiscountApplication = {    valid: boolean;    discount: number;
 
 export type ShopEmailCheck = {    exists: boolean;}
 
-export type ShopFacets = {    taxonomies: {        key: string;        label: string;        showAsBadge: boolean;        terms: {            slug: string;            name: string;            count: number;        }[];    }[];    attributes: {        key: string;        label: string;        valueType: "boolean" | "text" | "select" | "multiselect";        options: {            value: string;            label: string;            count: number;        }[];    }[];    price: {        min: number;        max: number;    };    onSale: {        count: number;    };}
+export type ShopFacets = {    taxonomies: {        key: string;        label: string;        showAsBadge: boolean;        selectionMode: "single" | "multiple";        terms: {            slug: string;            name: string;            count: number;        }[];    }[];    attributes: {        key: string;        label: string;        valueType: "boolean" | "text" | "select" | "multiselect";        options: {            value: string;            label: string;            count: number;        }[];    }[];    price: {        min: number;        max: number;    };    onSale: {        count: number;    };}
 
 export type ShopInventoryRef = {    stockQuantity: number;    reservedQuantity: number;    lowStockThreshold: number | null;}
 
@@ -171,6 +177,8 @@ export type ShopSort = "price_asc" | "price_desc" | "newest" | "on_sale"
 
 export type ShopTaxRateRef = {    rate: number;    type: "IVA" | "IGIC" | "RETENTION" | "OTHER";    isExempt: boolean;}
 
+export type ShopTaxonomySelectionMode = "single" | "multiple"
+
 export type ShopTaxonomyTermRef = {    taxonomyKey: string;    taxonomyLabel: string;    showAsBadge: boolean;    slug: string;    name: string;    imageUrl: string | null;}
 
 export type ShopValidateCartInput = {    items: {        productId: string;        quantity: number;        variantId?: string | null | undefined;    }[];}

package/package.json

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