@doswiftly/storefront-operations 20.0.0 → 20.1.0

package/AGENTS.md

@@ -27,7 +27,7 @@ consumer's `codegen.ts` references this package's `.graphql` files as
 live in the consumer's repo.
 
 <!-- AUTOGEN:STATS:BEGIN — auto-regenerated, do not edit by hand -->
-- **Schema version**: 20.0.0
+- **Schema version**: 20.1.0
 - **Queries**: 52
 - **Mutations**: 44
 - **Fragments**: 104

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 20.1.0
+
+### Minor Changes
+
+- e1bda76: Cart addresses now carry full B2B invoice identity end to end. `cartSetShippingAddress` and `cartSetBillingAddress` accept an EU VAT number (`vatNumber`, e.g. `PL1234567890`) alongside the existing tax ID and business registry number, and the cart address now returns all three (`taxId`, `vatNumber`, `regon`) — so a storefront can display and re-confirm exactly what the buyer entered. These values are carried onto the resulting order at checkout, ready for reverse-charge and cross-border B2B invoices.
+
+  Signed-in shoppers also get their saved default shipping and billing address — including those B2B fields — prefilled into the cart automatically when they create a cart or log in. Anything the shopper has already typed is never overwritten.
+
 ## 20.0.0
 
 ### Major Changes

package/README.md

@@ -472,7 +472,7 @@ full executable body of each operation.
 | Fragment | On Type | Description |
 | --- | --- | --- |
 | `PickupPoint` | `PickupPoint` | Selected pickup point (parcel locker or collection point) attached to a delivery address. Returned on `MailingAddress.pickupPoint` when the buyer chose a non-home delivery method (`deliveryType` other than `HOME`). Null for home delivery. |
-| `MailingAddress` | `MailingAddress` | Customer mailing address — full street/city/state/country/postal code with names and phone. `isDefault` flips when this address is the default for shipping. Carries B2B invoicing fields (`taxId`, `vatNumber`) and the selected `pickupPoint` for parcel locker / collection point deliveries. Spread on the address book UI, checkout shipping/billing forms, and order summaries. |
+| `MailingAddress` | `MailingAddress` | Customer mailing address — full street/city/state/country/postal code with names and phone. `isDefault` flips when this address is the default for shipping. Carries B2B invoicing fields (`taxId`, `vatNumber`, `regon`) and the selected `pickupPoint` for parcel locker / collection point deliveries. Spread on the address book UI, checkout shipping/billing forms, and order summaries. |
 | `CustomerAccessToken` | `CustomerAccessToken` | Customer access token returned by `customerLogin` / `customerSignup` / `customerActivate` / `customerResetPassword` / `customerRefreshToken`. The token's JWT TTL is 24h; cookie max-age is 30d. |
 | `Customer` | `Customer` | Customer profile — basic info plus B2B fields (`taxId`, `vatNumber`, `regon`, `companyName`), default address, lifetime stats (`orderCount`, `totalSpent`), marketing preferences. Use on profile / settings pages. |
 | `Order` | `Order` | Order summary — number, totals (cost / tax / shipping), payment + fulfillment status, shipping address, item count, lifecycle timestamps, plus payment capability signal (`canCreatePayment` + `paymentMethodType`) the storefront uses to decide post-completion payment flow without hard-coded provider checks. Spread on the order list, order detail, and the `cartComplete` mutation result. Line items are not included here. |

package/fragments.graphql

@@ -252,7 +252,7 @@ fragment PickupPoint on PickupPoint {
   address
 }
 
-# Customer mailing address — full street/city/state/country/postal code with names and phone. `isDefault` flips when this address is the default for shipping. Carries B2B invoicing fields (`taxId`, `vatNumber`) and the selected `pickupPoint` for parcel locker / collection point deliveries. Spread on the address book UI, checkout shipping/billing forms, and order summaries.
+# Customer mailing address — full street/city/state/country/postal code with names and phone. `isDefault` flips when this address is the default for shipping. Carries B2B invoicing fields (`taxId`, `vatNumber`, `regon`) and the selected `pickupPoint` for parcel locker / collection point deliveries. Spread on the address book UI, checkout shipping/billing forms, and order summaries.
 fragment MailingAddress on MailingAddress {
   id
   streetLine1
@@ -271,6 +271,7 @@ fragment MailingAddress on MailingAddress {
   isDefault
   taxId
   vatNumber
+  regon
   pickupPoint {
     ...PickupPoint
   }

package/llms-full.txt

@@ -1,6 +1,6 @@
 # DoSwiftly Storefront Operations — Full Reference
 
-> Schema version: **20.0.0**
+> Schema version: **20.1.0**
 > 52 queries · 44 mutations · 104 fragments
 
 Auto-generated from `.graphql` source files. Do not edit by hand — this file is
@@ -2927,7 +2927,7 @@ fragment PickupPoint on PickupPoint {
 
 **Section**: Customer
 
-**Description**: Customer mailing address — full street/city/state/country/postal code with names and phone. `isDefault` flips when this address is the default for shipping. Carries B2B invoicing fields (`taxId`, `vatNumber`) and the selected `pickupPoint` for parcel locker / collection point deliveries. Spread on the address book UI, checkout shipping/billing forms, and order summaries.
+**Description**: Customer mailing address — full street/city/state/country/postal code with names and phone. `isDefault` flips when this address is the default for shipping. Carries B2B invoicing fields (`taxId`, `vatNumber`, `regon`) and the selected `pickupPoint` for parcel locker / collection point deliveries. Spread on the address book UI, checkout shipping/billing forms, and order summaries.
 
 **Uses fragments**: `PickupPoint`
 
@@ -2951,6 +2951,7 @@ fragment MailingAddress on MailingAddress {
   isDefault
   taxId
   vatNumber
+  regon
   pickupPoint {
     ...PickupPoint
   }

package/operations.json

@@ -1,5 +1,5 @@
 {
-  "schemaVersion": "20.0.0",
+  "schemaVersion": "20.1.0",
   "queries": [
     {
       "name": "Shop",
@@ -2112,12 +2112,12 @@
       "name": "MailingAddress",
       "kind": "fragment",
       "section": "Customer",
-      "description": "Customer mailing address — full street/city/state/country/postal code with names and phone. `isDefault` flips when this address is the default for shipping. Carries B2B invoicing fields (`taxId`, `vatNumber`) and the selected `pickupPoint` for parcel locker / collection point deliveries. Spread on the address book UI, checkout shipping/billing forms, and order summaries.",
+      "description": "Customer mailing address — full street/city/state/country/postal code with names and phone. `isDefault` flips when this address is the default for shipping. Carries B2B invoicing fields (`taxId`, `vatNumber`, `regon`) and the selected `pickupPoint` for parcel locker / collection point deliveries. Spread on the address book UI, checkout shipping/billing forms, and order summaries.",
       "variables": [],
       "fragmentRefs": [
         "PickupPoint"
       ],
-      "body": "fragment MailingAddress on MailingAddress {\n  id\n  streetLine1\n  streetLine2\n  city\n  company\n  country\n  countryCode\n  firstName\n  lastName\n  name\n  phone\n  state\n  stateCode\n  postalCode\n  isDefault\n  taxId\n  vatNumber\n  pickupPoint {\n    ...PickupPoint\n  }\n}",
+      "body": "fragment MailingAddress on MailingAddress {\n  id\n  streetLine1\n  streetLine2\n  city\n  company\n  country\n  countryCode\n  firstName\n  lastName\n  name\n  phone\n  state\n  stateCode\n  postalCode\n  isDefault\n  taxId\n  vatNumber\n  regon\n  pickupPoint {\n    ...PickupPoint\n  }\n}",
       "onType": "MailingAddress"
     },
     {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@doswiftly/storefront-operations",
-  "version": "20.0.0",
+  "version": "20.1.0",
   "description": "GraphQL operations for DoSwiftly Storefront - SSOT from backend",
   "homepage": "https://doswiftly.pl",
   "publishConfig": {

package/schema.graphql

@@ -1046,7 +1046,7 @@ type CartAddLinesPayload {
 }
 
 """
-Mailing address used as the shipping or billing address on a cart. Carries an optional pickup point (for parcel locker / collection-point delivery) and optional B2B fields (`taxId`, `regon`).
+Mailing address used as the shipping or billing address on a cart. Carries an optional pickup point (for parcel locker / collection-point delivery) and optional B2B fields (`taxId`, `vatNumber`, `regon`).
 """
 input CartAddressInput {
   """City"""
@@ -1093,6 +1093,11 @@ input CartAddressInput {
   Buyer tax ID for B2B invoicing (Polish NIP). Persisted on the resulting order at checkout completion.
   """
   taxId: String
+
+  """
+  Buyer EU VAT number for cross-border B2B invoicing (e.g. PL1234567890). Persisted on the resulting order at checkout completion.
+  """
+  vatNumber: String
 }
 
 """
@@ -3828,7 +3833,7 @@ enum LoyaltyTransactionType {
 }
 
 """
-A mailing address — shipping or billing — used on a cart, on the resulting order, or saved in a customer address book. Carries optional B2B fields (`taxId`, `vatNumber`) and an optional `pickupPoint` for parcel locker / collection-point delivery.
+A mailing address — shipping or billing — used on a cart, on the resulting order, or saved in a customer address book. Carries optional B2B fields (`taxId`, `vatNumber`, `regon`) and an optional `pickupPoint` for parcel locker / collection-point delivery.
 """
 type MailingAddress implements Node {
   """City / town."""
@@ -3881,6 +3886,11 @@ type MailingAddress implements Node {
   """Postal / ZIP code."""
   postalCode: String
 
+  """
+  Buyer business registry number (Polish REGON) carried on a cart address for B2B invoicing. Populated on cart shipping/billing addresses; null on customer address-book entries (REGON is customer-level).
+  """
+  regon: String
+
   """State / province / region name."""
   state: String