@reblu/site-client 5.6.0 → 5.7.0

package/CHANGELOG.md

@@ -1,5 +1,54 @@
 # @reblu/site-client
 
+## 5.7.0
+
+### Minor Changes
+
+- 614e826: Shop checkout: full-invoice opt-in and the buyer's identifier (REB-73).
+
+  `ShopCheckoutInput` gains the optional `wantsFullInvoice` flag, and
+  `ShopBillingInput` the optional `billingIdType` (`NIF` for a Spanish
+  NIF/NIE/CIF; `02` EU VAT id, `03` passport, `04` ID document of the country
+  of residence, `05` residence certificate, `06` other document) and
+  `billingIdCountry` (ISO 3166-1 alpha-2, required for `02`–`06`). A full
+  invoice needs the identifier, the billing name and a billing address; without
+  the identifier the invoice is simplified.
+
+  `ShopErrorCode` gains two checkout codes, both answered before any payment:
+  `BILLING_DATA_REQUIRED` (HTTP 422, `details.field: 'billing'`) when the
+  opt-in, or a total over the tenant's simplified-invoice cap, comes without
+  those three; and `INVOICING_NOT_READY` (HTTP 503) when the shop cannot issue
+  invoices yet. Existing clients that send only `billing.billingNif` keep
+  working: its type is derived from the billing address country.
+
+- 614e826: Shop checkout: no full-invoice opt-in on a shop that issues no invoices (REB-73).
+  - `ShopErrorCode` gains `FULL_INVOICE_UNAVAILABLE` (HTTP 422,
+    `details.field: 'wantsFullInvoice'`): `wantsFullInvoice: true` sent to a shop
+    whose invoicing is off (`ShopConfig.simplifiedInvoiceCapCents` is `null`) is
+    refused before any payment instead of succeeding without an invoice. Clients
+    that never send the opt-in are unaffected. The union is additive: a SITE
+    with an exhaustive `switch` over `ShopErrorCode` (or a
+    `Record<ShopErrorCode, …>`) must add the new member when it upgrades.
+  - `@reblu/site-blocks`: new `shopIssuesInvoices(config)`; `FullInvoiceFields`
+    takes `issuesInvoices` (default `true`) and renders nothing when it is
+    `false`, and `toCheckoutInvoiceFields(value, overCap, issuesInvoices)`
+    returns no opt-in and no billing block then. Default Spanish copy for the
+    new code in `getShopErrorMessage`.
+
+- 614e826: Shop: the order's invoice and the simplified-invoice cap (REB-73).
+  - `ShopOrder` gains the optional `invoice: { number, url } | null`
+    (`ShopOrderInvoice`): once the sale invoice is issued, its number and the
+    shop's authenticated client-portal route that serves it — never a signed
+    URL, so the link does not expire; the buyer signs in to open it.
+  - `ShopConfig` gains `simplifiedInvoiceCapCents` (cents, never above the legal
+    300000; `null` while the shop issues no invoices): above it, checkout needs
+    the buyer's identifier, name and billing address.
+  - `@reblu/site-blocks`: new drop-in `OrderInvoiceLink`, which
+    `OrderConfirmation` now renders under a confirmed order (labels
+    `invoiceLinkLabel`/`invoiceSignInHint`), and default Spanish copy for the
+    `BILLING_DATA_REQUIRED`/`INVOICING_NOT_READY` checkout codes in
+    `getShopErrorMessage`.
+
 ## 5.6.0
 
 ### Minor Changes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reblu/site-client",
-  "version": "5.6.0",
+  "version": "5.7.0",
   "description": "Framework-agnostic HTTP client for the Reblu SITE API — dependency-free, injectable cache adapter, typed by @reblu/site-contracts.",
   "license": "Apache-2.0",
   "author": "Reblu — Adolfo Unturbe",
@@ -47,7 +47,7 @@
     "access": "public"
   },
   "peerDependencies": {
-    "@reblu/site-contracts": "^1.14.0"
+    "@reblu/site-contracts": "^1.15.0"
   },
   "devDependencies": {
     "@size-limit/preset-small-lib": "^11.1.6",
@@ -58,7 +58,7 @@
     "typescript": "^5.8.3",
     "vitest": "^4.0.15",
     "@reblu/config": "0.0.1",
-    "@reblu/site-contracts": "^1.14.0"
+    "@reblu/site-contracts": "^1.15.0"
   },
   "size-limit": [
     {