@doswiftly/storefront-operations 20.1.0 → 20.2.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.1.0
+- **Schema version**: 20.2.0
 - **Queries**: 52
 - **Mutations**: 44
 - **Fragments**: 104

package/CHANGELOG.md

@@ -1,5 +1,41 @@
 # Changelog
 
+## 20.2.0
+
+### Minor Changes
+
+- 17fedcf: Addresses now carry a structured building / flat number alongside the free-form street line.
+
+  **Why**: Polish addresses — and carriers like InPost as well as VAT invoicing — need the building number as a discrete field rather than mixed into a single street line (e.g. `"ul. Piękna 5/3"` must split into building `5`, flat `3`). The `MailingAddress` type and the cart / mailing address inputs now expose `buildingNumber` and `flatNumber` so storefronts can collect and display them precisely.
+
+  **Additive (backward-compatible)**:
+  1. `MailingAddress` (read) gains `buildingNumber` and `flatNumber` — populated on cart, order and saved customer addresses; `null` when only the free-form line was provided.
+  2. The address inputs (`CartAddressInput`, `MailingAddressInput`) accept optional `buildingNumber` and `flatNumber`. For a Polish street delivery without a pickup point the building number is now required server-side — omitting it returns a `BUILDING_NUMBER_REQUIRED` user error instead of silently guessing it from the street text.
+
+  **Usage example**:
+
+  ```ts
+  await cartSetShippingAddress({
+    cartId,
+    address: {
+      streetLine1: "ul. Piękna 5/3",
+      buildingNumber: "5",
+      flatNumber: "3",
+      city: "Warszawa",
+      postalCode: "00-001",
+      country: "PL",
+    },
+  });
+
+  // reading it back
+  const { buildingNumber, flatNumber } = order.shippingAddress;
+  ```
+
+  **Migration checklist for existing storefronts**:
+  - [ ] Add a `buildingNumber` (and optional `flatNumber`) field to your address forms.
+  - [ ] For Polish street addresses, send `buildingNumber`, or handle the `BUILDING_NUMBER_REQUIRED` user error returned by the cart address mutations.
+  - [ ] Optionally render `buildingNumber` / `flatNumber` when displaying saved or order addresses.
+
 ## 20.1.0
 
 ### Minor Changes

package/fragments.graphql

@@ -257,6 +257,8 @@ fragment MailingAddress on MailingAddress {
   id
   streetLine1
   streetLine2
+  buildingNumber
+  flatNumber
   city
   company
   country

package/llms-full.txt

@@ -1,6 +1,6 @@
 # DoSwiftly Storefront Operations — Full Reference
 
-> Schema version: **20.1.0**
+> Schema version: **20.2.0**
 > 52 queries · 44 mutations · 104 fragments
 
 Auto-generated from `.graphql` source files. Do not edit by hand — this file is
@@ -2937,6 +2937,8 @@ fragment MailingAddress on MailingAddress {
   id
   streetLine1
   streetLine2
+  buildingNumber
+  flatNumber
   city
   company
   country

package/operations.json

@@ -1,5 +1,5 @@
 {
-  "schemaVersion": "20.1.0",
+  "schemaVersion": "20.2.0",
   "queries": [
     {
       "name": "Shop",
@@ -2117,7 +2117,7 @@
       "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  regon\n  pickupPoint {\n    ...PickupPoint\n  }\n}",
+      "body": "fragment MailingAddress on MailingAddress {\n  id\n  streetLine1\n  streetLine2\n  buildingNumber\n  flatNumber\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.1.0",
+  "version": "20.2.0",
   "description": "GraphQL operations for DoSwiftly Storefront - SSOT from backend",
   "homepage": "https://doswiftly.pl",
   "publishConfig": {

package/schema.graphql

@@ -1049,6 +1049,11 @@ 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`, `vatNumber`, `regon`).
 """
 input CartAddressInput {
+  """
+  Building / house number as a discrete field, overlaid on `streetLine1`. Required for delivery and billing addresses in Poland (`country: PL`) without a `pickupPoint` — carriers (e.g. InPost) and invoicing need the building number split out from the street name.
+  """
+  buildingNumber: String
+
   """City"""
   city: String!
 
@@ -1061,6 +1066,11 @@ input CartAddressInput {
   """First name"""
   firstName: String
 
+  """
+  Flat / apartment number as a discrete field — optional companion to `buildingNumber`.
+  """
+  flatNumber: String
+
   """Last name"""
   lastName: String
 
@@ -3836,6 +3846,11 @@ 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`, `regon`) and an optional `pickupPoint` for parcel locker / collection-point delivery.
 """
 type MailingAddress implements Node {
+  """
+  Building / house number as a discrete field, overlaid on `streetLine1`. Populated for structured addresses (required for PL delivery / billing without a pickup point); null when only the free-form `streetLine1` was provided.
+  """
+  buildingNumber: String
+
   """City / town."""
   city: String
 
@@ -3853,6 +3868,11 @@ type MailingAddress implements Node {
   """Buyer first name."""
   firstName: String
 
+  """
+  Flat / apartment number as a discrete field — optional companion to `buildingNumber`.
+  """
+  flatNumber: String
+
   """
   Country-aware ordered address lines, ready to render line by line in UI without manual formatting. The exact line layout depends on country (e.g. PL puts postal code before city, US after state).
   """
@@ -3944,6 +3964,11 @@ type MailingAddressEdge {
 
 """Input for mailing address"""
 input MailingAddressInput {
+  """
+  Building / house number as a discrete field, overlaid on `streetLine1`. Required for saved Polish addresses (`country: PL`) — used for carrier delivery and invoicing.
+  """
+  buildingNumber: String
+
   """City"""
   city: String
 
@@ -3956,6 +3981,11 @@ input MailingAddressInput {
   """First name"""
   firstName: String
 
+  """
+  Flat / apartment number as a discrete field — optional companion to `buildingNumber`.
+  """
+  flatNumber: String
+
   """Last name"""
   lastName: String