@reblu/site-contracts 1.8.0 → 1.9.0

package/CHANGELOG.md

@@ -1,5 +1,26 @@
 # @reblu/site-contracts
 
+## 1.9.0
+
+### Minor Changes
+
+- cc0ce0c: Add `ShopConfig.productTrustItems` (REB-858): store-wide product trust items,
+  optional `ShopProductTrustItem[] | null`, in the owner's display order. New
+  exported types `ShopProductTrustIcon` (the icons known today: `shipping |
+returns | secure-payment | support | gift | pickup | warranty | quality`) and
+  `ShopProductTrustItem` (`{ icon: ShopProductTrustIcon | (string & {}); text:
+string }`, open to extra keys).
+
+  The item shape is forward-compatible: a newer API may send an icon or an item
+  key this version does not know. Consumers must ignore items whose icon they
+  don't recognise (see the README).
+
+  Absent, `null` or `[]` all mean the SITE hides the block — no default items
+  are ever served. The API always emits the key (`null` when not configured);
+  it is optional in the type so the change is purely additive: existing typed
+  `ShopConfig` fixtures keep compiling, and a consumer on this version talking
+  to an older base-api (which does not emit the key) still validates.
+
 ## 1.8.0
 
 ### Minor Changes

package/README.md

@@ -113,6 +113,25 @@ longer offered as a choice for a new section in nexus. They will be removed
 after 2027-01-31, once no tenant data uses them (REB-852) — this release does
 not migrate existing data.
 
+### Shop — product trust items (REB-858)
+
+`ShopConfig.productTrustItems` is the store-wide list of short trust messages
+(shipping, returns, secure payment…) the owner configures in nexus, in display
+order. Absent, `null` or `[]` all mean **hide the block** — the API never
+serves default items.
+
+The shape is **forward-compatible** on purpose, so render it defensively:
+
+- **Ignore any item whose `icon` you don't recognise.** `icon` is typed as
+  `ShopProductTrustIcon | (string & {})`: today's icons are `shipping`,
+  `returns`, `secure-payment`, `support`, `gift`, `pickup`, `warranty` and
+  `quality`, but a newer API may add more. Skip unknown icons; never fail on
+  them.
+- **Ignore unknown item keys.** A newer API may add fields to an item.
+- Don't rely on the count or length bounds in the response type: at most 6
+  items and 1–80 characters of text are nexus write rules, not wire
+  guarantees.
+
 ## 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

@@ -157,7 +157,7 @@ export type ShopCheckoutInput = {    items: {        productId: string;        q
 
 export type ShopCheckoutSession = {    url: string;    sessionId: string;}
 
-export type ShopConfig = {    shopName: string | null;    defaultLowStockThreshold: number;    currencyCode: string;    stripePublishableKey: string | null;    stripeTestPublishableKey: string | null;    stripeTestMode: boolean;    shippingEnabled: boolean;    pickupEnabled: boolean;    taxEnabled: boolean;    taxIncludedInPrice: boolean;}
+export type ShopConfig = {    shopName: string | null;    defaultLowStockThreshold: number;    currencyCode: string;    stripePublishableKey: string | null;    stripeTestPublishableKey: string | null;    stripeTestMode: boolean;    shippingEnabled: boolean;    pickupEnabled: boolean;    taxEnabled: boolean;    taxIncludedInPrice: boolean;    productTrustItems?: {        [x: string]: unknown;        icon: (string & {}) | "shipping" | "returns" | "secure-payment" | "support" | "gift" | "pickup" | "warranty" | "quality";        text: string;    }[] | null | undefined;}
 
 export type ShopDiscountApplication = {    valid: boolean;    discount: number;    type: "PERCENTAGE" | "FIXED" | null;    code: string | null;    error?: string | undefined;}
 
@@ -185,6 +185,10 @@ export type ShopProductListItem = {    id: string;    slug: string;    name: str
 
 export type ShopProductListParams = {    page?: number | undefined;    limit?: number | undefined;    q?: string | undefined;    sort?: "price_asc" | "price_desc" | "newest" | "on_sale" | undefined;    category?: string | undefined;    priceMin?: number | undefined;    priceMax?: number | undefined;    onSale?: boolean | undefined;    taxonomy?: Record<string, string> | undefined;    attr?: Record<string, string | string[]> | undefined;}
 
+export type ShopProductTrustIcon = "shipping" | "returns" | "secure-payment" | "support" | "gift" | "pickup" | "warranty" | "quality"
+
+export type ShopProductTrustItem = {    [x: string]: unknown;    icon: (string & {}) | "shipping" | "returns" | "secure-payment" | "support" | "gift" | "pickup" | "warranty" | "quality";    text: string;}
+
 export type ShopProductVariant = {    id: string;    name: string;    sku: string | null;    price: number | null;    attributes: unknown;    isActive: boolean;    sortOrder: number;}
 
 export type ShopProductVideo = {    url: string;    title: string | null;    isExternal: boolean;    thumbnailUrl: string | null;    sortOrder: number;}

package/dist/index.d.ts

@@ -157,7 +157,7 @@ export type ShopCheckoutInput = {    items: {        productId: string;        q
 
 export type ShopCheckoutSession = {    url: string;    sessionId: string;}
 
-export type ShopConfig = {    shopName: string | null;    defaultLowStockThreshold: number;    currencyCode: string;    stripePublishableKey: string | null;    stripeTestPublishableKey: string | null;    stripeTestMode: boolean;    shippingEnabled: boolean;    pickupEnabled: boolean;    taxEnabled: boolean;    taxIncludedInPrice: boolean;}
+export type ShopConfig = {    shopName: string | null;    defaultLowStockThreshold: number;    currencyCode: string;    stripePublishableKey: string | null;    stripeTestPublishableKey: string | null;    stripeTestMode: boolean;    shippingEnabled: boolean;    pickupEnabled: boolean;    taxEnabled: boolean;    taxIncludedInPrice: boolean;    productTrustItems?: {        [x: string]: unknown;        icon: (string & {}) | "shipping" | "returns" | "secure-payment" | "support" | "gift" | "pickup" | "warranty" | "quality";        text: string;    }[] | null | undefined;}
 
 export type ShopDiscountApplication = {    valid: boolean;    discount: number;    type: "PERCENTAGE" | "FIXED" | null;    code: string | null;    error?: string | undefined;}
 
@@ -185,6 +185,10 @@ export type ShopProductListItem = {    id: string;    slug: string;    name: str
 
 export type ShopProductListParams = {    page?: number | undefined;    limit?: number | undefined;    q?: string | undefined;    sort?: "price_asc" | "price_desc" | "newest" | "on_sale" | undefined;    category?: string | undefined;    priceMin?: number | undefined;    priceMax?: number | undefined;    onSale?: boolean | undefined;    taxonomy?: Record<string, string> | undefined;    attr?: Record<string, string | string[]> | undefined;}
 
+export type ShopProductTrustIcon = "shipping" | "returns" | "secure-payment" | "support" | "gift" | "pickup" | "warranty" | "quality"
+
+export type ShopProductTrustItem = {    [x: string]: unknown;    icon: (string & {}) | "shipping" | "returns" | "secure-payment" | "support" | "gift" | "pickup" | "warranty" | "quality";    text: string;}
+
 export type ShopProductVariant = {    id: string;    name: string;    sku: string | null;    price: number | null;    attributes: unknown;    isActive: boolean;    sortOrder: number;}
 
 export type ShopProductVideo = {    url: string;    title: string | null;    isExternal: boolean;    thumbnailUrl: string | null;    sortOrder: number;}

package/package.json

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