@doswiftly/storefront-operations 6.1.0 → 7.1.0

package/schema.graphql

@@ -1182,11 +1182,14 @@ type Category {
   sortOrder: Int!
 }
 
-"""Paginated category list"""
+"""Paginated category list (Relay Connection)"""
 type CategoryConnection {
-  """List of category edges"""
+  """List of category edges (cursor + node pairs)"""
   edges: [CategoryEdge!]!
 
+  """List of category nodes (shortcut without cursor)"""
+  nodes: [Category!]!
+
   """Pagination info"""
   pageInfo: PageInfo!
 
@@ -1230,15 +1233,6 @@ type CategoryFilterOption {
   slug: String!
 }
 
-"""Category tree structure"""
-type CategoryTree {
-  """Root categories"""
-  roots: [Category!]!
-
-  """Total categories count"""
-  totalCount: Int!
-}
-
 """Checkout object"""
 type Checkout {
   """Applied gift cards"""
@@ -2043,6 +2037,16 @@ type Customer implements Node {
   """Last name"""
   lastName: String
 
+  """
+  Lista meta properties (Relay Connection) — opcjonalnie scoped do namespace
+  """
+  metaProperties(first: Int = 10, namespace: String): MetaPropertyConnection!
+
+  """
+  Pojedyncze meta property po (namespace, key) — dla zalogowanego klienta zwraca także private
+  """
+  metaProperty(key: String!, namespace: String!): MetaProperty
+
   """Total orders count (UnsignedInt64 — BigInt-safe)"""
   orderCount: UnsignedInt64!
 
@@ -3283,6 +3287,16 @@ type MailingAddress implements Node {
 
   """Second line of street address"""
   streetLine2: String
+
+  """
+  Per-address tax ID (Polish NIP, 10 digits z checksum). B2B use case: różne dane firmowe per adres — np. faktura na firmę matkę z NIP A, dostawa na oddział z NIP B. Distinct from `Customer.taxId` (customer-level globally).
+  """
+  taxId: String
+
+  """
+  Per-address EU VAT number (e.g. PL1234567890). B2B cross-border: różny VAT per adres dostawy. Distinct from `Customer.vatNumber` (customer-level globally).
+  """
+  vatNumber: String
 }
 
 """Paginated mailing addresses (Relay Connection)"""
@@ -3340,6 +3354,14 @@ input MailingAddressInput {
 
   """Second line of street address"""
   streetLine2: String
+
+  """
+  Per-address Polish tax ID — NIP (10 digits with checksum). B2B use case: różne dane firmowe per adres dostawy/billing.
+  """
+  taxId: String
+
+  """Per-address EU VAT number (e.g. PL1234567890). Cross-border B2B."""
+  vatNumber: String
 }
 
 """
@@ -3412,6 +3434,119 @@ enum MenuItemType {
   SEARCH
 }
 
+"""
+Payload `customerMetaPropertiesSet` — bulk upsert własnych meta properties klienta
+"""
+type MetaPropertiesSetPayload {
+  """Upserted meta properties (puste gdy userErrors)"""
+  metaProperties: [MetaProperty!]!
+
+  """User errors (code z `MetaPropertyErrorCode` enum)"""
+  userErrors: [UserError!]!
+}
+
+"""Pojedyncze pole dodatkowe (meta property) na encji commerce"""
+type MetaProperty implements Node {
+  """Created at"""
+  createdAt: DateTime!
+
+  """Unique identifier"""
+  id: ID!
+
+  """
+  true = readable tylko przez authenticated context (admin/customer self). false (default) = readable również przez anonymous Storefront API.
+  """
+  isPrivate: Boolean!
+
+  """
+  Key w obrębie namespace (3-64 chars). Unique per (ownerType, ownerId, namespace).
+  """
+  key: String!
+
+  """
+  Namespace (3-64 chars). Zapobiega kolizji kluczy między aplikacjami. Reserved prefix: `doswiftly:` (platform).
+  """
+  namespace: String!
+
+  """Typ wartości — informuje klienta jak parse value."""
+  type: MetaPropertyValueType!
+
+  """Last updated at"""
+  updatedAt: DateTime!
+
+  """
+  Wartość — zawsze String. Klient parsuje zgodnie z polem `type` (np. INTEGER → parseInt, JSON → JSON.parse).
+  """
+  value: String!
+}
+
+"""Paginated meta property list (Relay Connection)"""
+type MetaPropertyConnection {
+  """Edges (cursor + node pairs)"""
+  edges: [MetaPropertyEdge!]!
+
+  """Nodes (shortcut bez cursor)"""
+  nodes: [MetaProperty!]!
+
+  """Page info"""
+  pageInfo: PageInfo!
+
+  """Total count (max po wszystkich pages)"""
+  totalCount: Int!
+}
+
+"""Payload `customerMetaPropertyDelete`"""
+type MetaPropertyDeletePayload {
+  """ID usuniętego meta property (null gdy userErrors)"""
+  deletedId: ID
+
+  """User errors (code z `MetaPropertyErrorCode` enum)"""
+  userErrors: [UserError!]!
+}
+
+"""Meta property edge (Relay pagination)"""
+type MetaPropertyEdge {
+  """Cursor for pagination"""
+  cursor: String!
+
+  """Meta property node"""
+  node: MetaProperty!
+}
+
+"""Input dla pojedynczego meta property w bulk set"""
+input MetaPropertyInput {
+  """Visibility — true = admin/customer-only, false = storefront-readable"""
+  isPrivate: Boolean = false
+
+  """Key (3-64 chars)"""
+  key: String!
+
+  """Namespace (3-64 chars, NOT starting with `doswiftly:`)"""
+  namespace: String!
+
+  """Typ wartości (driver walidacji backend-side)"""
+  type: MetaPropertyValueType!
+
+  """Wartość jako String (parse zgodnie z type)"""
+  value: String!
+}
+
+"""
+Typy wartości — STRING (max 255 chars), TEXT (no cap), INTEGER, DECIMAL, BOOLEAN ("true"/"false"), JSON (stringified), DATE (YYYY-MM-DD), DATE_TIME (ISO 8601), URL (http(s)://...), COLOR (#RRGGBB / #RRGGBBAA hex).
+"""
+enum MetaPropertyValueType {
+  BOOLEAN
+  COLOR
+  DATE
+  DATE_TIME
+  DECIMAL
+  INTEGER
+  JSON
+  STRING
+  TEXT
+  URL
+}
+
 """Monetary value with currency"""
 type Money {
   """Decimal money amount"""
@@ -3509,6 +3644,12 @@ type Mutation {
   """Logout customer (clears auth cookie)"""
   customerLogout: CustomerLogoutPayload!
 
+  """Bulk upsert własnych meta properties klienta (Bearer token wymagany)"""
+  customerMetaPropertiesSet(properties: [MetaPropertyInput!]!): MetaPropertiesSetPayload!
+
+  """Usuwa pojedyncze meta property klienta po (namespace, key)"""
+  customerMetaPropertyDelete(key: String!, namespace: String!): MetaPropertyDeletePayload!
+
   """Refresh access token"""
   customerRefreshToken: CustomerRefreshTokenPayload!
 
@@ -3624,6 +3765,12 @@ type Order implements Node {
   """Line items count"""
   itemCount: Int!
 
+  """Lista meta properties (Relay Connection)"""
+  metaProperties(first: Int = 10, namespace: String): MetaPropertyConnection!
+
+  """Pojedyncze meta property po (namespace, key)"""
+  metaProperty(key: String!, namespace: String!): MetaProperty
+
   """Order number (human-readable)"""
   orderNumber: String!
 
@@ -3903,9 +4050,9 @@ type Product implements Node {
   averageRating: Float
 
   """
-  Product category (free-text classification, e.g. "Footwear", "Electronics")
+  Wszystkie kategorie do których produkt należy (M2M przez ProductCategory junction). Posortowane po junction.sortOrder ASC. Empty list gdy produkt nie jest w żadnej kategorii.
   """
-  category: String
+  categories: [Category!]!
 
   """
   Compare-at price range (Money pair). Null gdy żaden variant nie ma compareAtPrice.
@@ -3944,6 +4091,12 @@ type Product implements Node {
   """
   isPurchasable: Boolean!
 
+  """Lista meta properties — Storefront API filtruje isPrivate=false"""
+  metaProperties(first: Int = 10, namespace: String): MetaPropertyConnection!
+
+  """Pojedyncze meta property — Storefront API filtruje isPrivate=false"""
+  metaProperty(key: String!, namespace: String!): MetaProperty
+
   """
   Per-product option definitions (Color, Size, …) with their available values. Use these to build a variant picker without aggregating `selectedOptions` manually.
   """
@@ -3957,6 +4110,11 @@ type Product implements Node {
   """
   priceRangeWithConversion: ConvertedPriceRange
 
+  """
+  Domyślna kategoria dla breadcrumb/nav (= categories[0] po sortOrder). Null gdy produkt nie jest w żadnej kategorii.
+  """
+  primaryCategory: Category
+
   """Similar products recommendations"""
   recommendations(first: Int = 4): ProductRecommendations
 
@@ -4143,11 +4301,6 @@ input ProductFilter {
   """Filter by variant price range"""
   price: PriceRangeFilter
 
-  """
-  Filter by product category (free-text classification, stored on Product.category). Distinct from `category: CategoryFilter` which selects by structured Category entity.
-  """
-  productCategory: String
-
   """
   Filter by product type enum (PHYSICAL/DIGITAL/SERVICE/SUBSCRIPTION/GIFT_CARD). Distinct from `productCategory` (free-text classification).
   """
@@ -4345,6 +4498,12 @@ type ProductVariant {
   """Whether variant is available for purchase"""
   isAvailable: Boolean!
 
+  """Lista meta properties — Storefront API filtruje isPrivate=false"""
+  metaProperties(first: Int = 10, namespace: String): MetaPropertyConnection!
+
+  """Pojedyncze meta property — Storefront API filtruje isPrivate=false"""
+  metaProperty(key: String!, namespace: String!): MetaProperty
+
   """Variant price (Money). Default field — industry-standard schema."""
   price: Money!
 
@@ -4478,20 +4637,30 @@ type Query {
   """Get cart by ID"""
   cart(id: ID!): Cart
 
-  """Get category tree"""
+  """
+  Lista kategorii (Relay Connection) z opcjonalnym filtrem rootsOnly/parentId
+  """
   categories(
-    """Cursor for pagination"""
+    """Forward pagination cursor (after this element)"""
     after: String
 
-    """Number of items to fetch"""
-    first: Int! = 20
+    """Backward pagination cursor (before this element)"""
+    before: String
+
+    """Forward pagination — first N elements"""
+    first: Int
 
-    """Filter by parent category ID"""
+    """Backward pagination — last N elements"""
+    last: Int
+
+    """
+    Filter by parent category ID — używaj `null` semantically dla "roots" via `rootsOnly` flag
+    """
     parentId: ID
 
-    """Only root categories"""
+    """Tylko root categories (parentId IS NULL)"""
     rootsOnly: Boolean! = false
-  ): CategoryTree!
+  ): CategoryConnection!
 
   """Get category by ID or slug"""
   category(