@nautical-commerce/graphql-schema 4.7.0 → 4.8.0

package/nautical/schema.graphql

@@ -1515,7 +1515,9 @@ type Attribute implements Node & ObjectWithMetadata {
   """The input type to use for entering attribute values in the dashboard."""
   inputType: AttributeInputTypeEnum!
 
-  """The values available for this attribute"""
+  """
+  ALL values defined for this attribute — the full catalogue of options it can take, NOT the values assigned to any particular product or variant. For the values assigned to a specific object, use the `values` field on SelectedAttribute (a sibling of `attribute`, one level up). Narrowed to a subset when `search` or `first` is supplied. Returns an empty list unless `inputType` is DROPDOWN or MULTISELECT — the other input types carry a unique value per object rather than a shared catalogue.
+  """
   values(search: String = null, first: Int = null): [AttributeValue!]!
 
   """Seller who created this attribute, if any"""
@@ -9957,10 +9959,10 @@ type Mutation {
   """Clear all seller shipping methods."""
   checkoutSellerShippingMethodsClear(checkoutId: ID!): CheckoutSellerShippingMethodsClear!
 
-  """Add a promo code (voucher or gift card)."""
+  """Add a voucher code to the checkout."""
   checkoutAddPromoCode(checkoutId: ID!, promoCode: String!): CheckoutAddPromoCode!
 
-  """Remove a promo code."""
+  """Remove a voucher code from the checkout."""
   checkoutRemovePromoCode(checkoutId: ID!, promoCode: String!): CheckoutRemovePromoCode!
 
   """Add purchase order numbers."""
@@ -19850,10 +19852,14 @@ type SalesVelocityReport {
 
 """Represents a selected attribute with its values"""
 type SelectedAttribute {
-  """The attribute definition"""
+  """
+  The attribute definition. Its `values` field lists every value the attribute CAN take — for the values actually assigned here, use the `values` field alongside this one, not the one nested inside it.
+  """
   attribute: Attribute!
 
-  """Values of the attribute"""
+  """
+  The values assigned to THIS object — this product, variant, or custom-field owner. Usually the field you want. Contrast `attribute.values`, which is the attribute's full catalogue of possible values and is identical for every object sharing it.
+  """
   values: [AttributeValue!]!
 
   """

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nautical-commerce/graphql-schema",
-  "version": "4.7.0",
+  "version": "4.8.0",
   "description": "Traide API GraphQL Schema",
   "main": "./nautical/schema.graphql",
   "scripts": {