@graphcommerce/magento-graphql 11.0.0-canary.45 → 11.0.0-canary.47

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Change Log
 
+## 11.0.0-canary.47
+
+### Patch Changes
+
+- [#2659](https://github.com/graphcommerce-org/graphcommerce/pull/2659) [`8623e57`](https://github.com/graphcommerce-org/graphcommerce/commit/8623e5755c24cd202e4eb32cc0650eaa3b40e682) - Schema defintions for 246,247 and 248 ([@paales](https://github.com/paales))
+
+- [#2659](https://github.com/graphcommerce-org/graphcommerce/pull/2659) [`e7fe659`](https://github.com/graphcommerce-org/graphcommerce/commit/e7fe65994325510863afb526e8b2caaeba5e66f1) - Support the Magento 2.4.9 guest-order lookup, which renamed the `guestOrder` argument type `OrderInformationInput` → `GuestOrderInformationInput` and swapped the `postcode` lookup field for `lastname`. The `GuestOrder` query and the guest order form now use the new type/field, and `schema-249` re-declares `guestOrder(input: GuestOrderInformationInput!)` so operations keep validating on older backends via the mesh version shim. ([@paales](https://github.com/paales))
+
+- [#2659](https://github.com/graphcommerce-org/graphcommerce/pull/2659) [`5cead7c`](https://github.com/graphcommerce-org/graphcommerce/commit/5cead7c445e2497266a49fae2b8744536f54939e) - Make every field the `schema-<version>` backfills add to an existing type nullable. These folders are layered onto an older Magento backend that does not have the field, so it can never produce a value: a non-null declaration made codegen emit a required property (breaking `getStoreConfig` in `algolia-products` with "Type 'StoreConfig' is missing the following properties … and 15 more" on a 2.4.7 backend) and, worse, would nullify the whole parent object at runtime because a non-null field resolving to null propagates upward. Brand-new types keep their original nullability. ([@paales](https://github.com/paales))
+
+## 11.0.0-canary.46
+
 ## 11.0.0-canary.45
 
 ## 10.1.0-canary.44

package/package.json

@@ -2,7 +2,7 @@
   "name": "@graphcommerce/magento-graphql",
   "homepage": "https://www.graphcommerce.org/",
   "repository": "github:graphcommerce-org/graphcommerce",
-  "version": "11.0.0-canary.45",
+  "version": "11.0.0-canary.47",
   "sideEffects": false,
   "main": "index.ts",
   "prettier": "@graphcommerce/prettier-config-pwa",
@@ -25,10 +25,10 @@
     "./mesh/magentoOrderItemResolvers.ts": "./mesh/magentoOrderItemResolvers.ts"
   },
   "peerDependencies": {
-    "@graphcommerce/eslint-config-pwa": "^11.0.0-canary.45",
-    "@graphcommerce/graphql": "^11.0.0-canary.45",
-    "@graphcommerce/prettier-config-pwa": "^11.0.0-canary.45",
-    "@graphcommerce/typescript-config-pwa": "^11.0.0-canary.45",
+    "@graphcommerce/eslint-config-pwa": "^11.0.0-canary.47",
+    "@graphcommerce/graphql": "^11.0.0-canary.47",
+    "@graphcommerce/prettier-config-pwa": "^11.0.0-canary.47",
+    "@graphcommerce/typescript-config-pwa": "^11.0.0-canary.47",
     "graphql": "^16.0.0",
     "next": "*",
     "react": "^19.2.0",

package/schema-246/AvailablePaymentMethod.graphqls

@@ -0,0 +1,6 @@
+type AvailablePaymentMethod {
+  """
+  If the payment method is an online integration
+  """
+  is_deferred: Boolean @deprecated(reason: "Magento >= 2.4.6")
+}

package/schema-246/CartAddress.graphqls

@@ -0,0 +1,39 @@
+type BillingCartAddress {
+  """
+  The unique id of the customer address.
+  """
+  uid: String @deprecated(reason: "Magento >= 2.4.6")
+  """
+  The VAT company number for billing or shipping address.
+  """
+  vat_id: String @deprecated(reason: "Magento >= 2.4.6")
+}
+
+input CartAddressInput {
+  """
+  The VAT company number for billing or shipping address.
+  """
+  vat_id: String @deprecated(reason: "Magento >= 2.4.6")
+}
+
+interface CartAddressInterface {
+  """
+  The unique id of the customer address.
+  """
+  uid: String @deprecated(reason: "Magento >= 2.4.6")
+  """
+  The VAT company number for billing or shipping address.
+  """
+  vat_id: String @deprecated(reason: "Magento >= 2.4.6")
+}
+
+type ShippingCartAddress {
+  """
+  The unique id of the customer address.
+  """
+  uid: String @deprecated(reason: "Magento >= 2.4.6")
+  """
+  The VAT company number for billing or shipping address.
+  """
+  vat_id: String @deprecated(reason: "Magento >= 2.4.6")
+}

package/schema-246/{Customer-orders.graphqls → CustomerOrder.graphqls}

@@ -1,40 +1,61 @@
-enum ScopeTypeEnum {
-  GLOBAL
-  WEBSITE
-  STORE
-}
-
-input CustomerOrderSortInput {
-  sort_direction: SortEnum!
-  sort_field: CustomerOrderSortableField!
-}
-
-enum CustomerOrderSortableField {
-  NUMBER
-  CREATED_AT
-}
-
-extend type Customer {
+type Customer {
   orders(
-    """
-    Defines the filter to use for searching customer orders.
-    """
-    filter: CustomerOrdersFilterInput
     """
     Specifies which page of results to return. The default value is 1.
     """
     currentPage: Int = 1
     """
-    Specifies the maximum number of results to return at once. The default value is 20.
+    Defines the filter to use for searching customer orders.
     """
-    pageSize: Int = 20
+    filter: CustomerOrdersFilterInput
     """
-    Specifies which field to sort on, and whether to return the results in ascending or descending order.
+    Specifies the maximum number of results to return at once. The default value is 20.
     """
-    sort: CustomerOrderSortInput
+    pageSize: Int = 20
     """
     Specifies the scope to search for customer orders. The Store request header identifies the customer's store view code. The default value of STORE limits the search to the value specified in the header. Specify WEBSITE to expand the search to include all customer orders assigned to the website that is defined in the header, or specify GLOBAL to include all customer orders across all websites and stores.
     """
     scope: ScopeTypeEnum
+    """
+    Specifies which field to sort on, and whether to return the results in ascending or descending order.
+    """
+    sort: CustomerOrderSortInput
   ): CustomerOrders
 }
+
+"""
+This enumeration defines the scope type for customer orders.
+"""
+enum ScopeTypeEnum {
+  GLOBAL @deprecated
+  STORE @deprecated
+  WEBSITE @deprecated
+}
+
+"""
+CustomerOrderSortInput specifies the field to use for sorting search results and indicates whether the results are sorted in ascending or descending order.
+"""
+input CustomerOrderSortInput {
+  """
+  This enumeration indicates whether to return results in ascending or descending order
+  """
+  sort_direction: SortEnum!
+  """
+  Specifies the field to use for sorting
+  """
+  sort_field: CustomerOrderSortableField!
+}
+
+"""
+Specifies the field to use for sorting
+"""
+enum CustomerOrderSortableField {
+  """
+  Sorts customer orders by created_at field
+  """
+  CREATED_AT @deprecated
+  """
+  Sorts customer orders by number
+  """
+  NUMBER @deprecated
+}

package/schema-246/{SelectedShippingMethod.graphqls → Totals.graphqls}

@@ -1,4 +1,10 @@
 type SelectedShippingMethod {
+  """
+  The cost of shipping using this shipping method, excluding tax.
+  """
   price_excl_tax: Money @deprecated(reason: "Magento >= 2.4.6")
+  """
+  The cost of shipping using this shipping method, including tax.
+  """
   price_incl_tax: Money @deprecated(reason: "Magento >= 2.4.6")
 }

package/schema-247/AttributeValueInput.graphqls

@@ -0,0 +1,48 @@
+input CustomerAddressInput {
+  """
+  Custom attributes assigned to the customer address.
+  """
+  custom_attributesV2: [AttributeValueInput] @deprecated(reason: "Magento >= 2.4.7")
+}
+
+"""
+Specifies the value for attribute.
+"""
+input AttributeValueInput {
+  """
+  The code of the attribute.
+  """
+  attribute_code: String!
+  """
+  An array containing selected options for a select or multiselect attribute.
+  """
+  selected_options: [AttributeInputSelectedOption]
+  """
+  The value assigned to the attribute.
+  """
+  value: String
+}
+
+"""
+Specifies selected option for a select or multiselect attribute value.
+"""
+input AttributeInputSelectedOption {
+  """
+  The attribute option value.
+  """
+  value: String!
+}
+
+input CustomerCreateInput {
+  """
+  The customer's custom attributes.
+  """
+  custom_attributes: [AttributeValueInput] @deprecated(reason: "Magento >= 2.4.7")
+}
+
+input CustomerUpdateInput {
+  """
+  The customer's custom attributes.
+  """
+  custom_attributes: [AttributeValueInput] @deprecated(reason: "Magento >= 2.4.7")
+}

package/schema-247/{Cart-itemsV2.graphqls → Cart.graphqls}

@@ -1,72 +1,72 @@
-type CartItems {
-  """
-  An array of products that have been added to the cart.
-  """
-  items: [CartItemInterface]!
+type Cart {
+  itemsV2(currentPage: Int = 1, pageSize: Int = 20, sort: QuoteItemsSortInput): CartItems
+    @deprecated(reason: "Magento >= 2.4.7")
+}
+
+"""
+Specifies the field to use for sorting quote items
+"""
+input QuoteItemsSortInput {
   """
-  Metadata for pagination rendering.
+  Specifies the quote items field to sort by
   """
-  page_info: SearchResultPageInfo
+  field: SortQuoteItemsEnum!
   """
-  The number of returned cart items.
+  Specifies the order of quote items' sorting
   """
-  total_count: Int!
+  order: SortEnum!
 }
 
 """
 Specifies the field to use for sorting quote items
 """
 enum SortQuoteItemsEnum {
-  ITEM_ID
-  CREATED_AT
-  UPDATED_AT
-  PRODUCT_ID
-  SKU
-  NAME
-  DESCRIPTION
-  WEIGHT
-  QTY
-  PRICE
+  BASE_DISCOUNT_AMOUNT
+  BASE_DISCOUNT_TAX_COMPENSATION_AMOUNT
   BASE_PRICE
+  BASE_PRICE_INC_TAX
+  BASE_ROW_TOTAL
+  BASE_ROW_TOTAL_INC_TAX
+  BASE_TAX_AMOUNT
+  BASE_TAX_BEFORE_DISCOUNT
+  CREATED_AT
   CUSTOM_PRICE
-  DISCOUNT_PERCENT
+  DESCRIPTION
   DISCOUNT_AMOUNT
-  BASE_DISCOUNT_AMOUNT
-  TAX_PERCENT
-  TAX_AMOUNT
-  BASE_TAX_AMOUNT
+  DISCOUNT_PERCENT
+  DISCOUNT_TAX_COMPENSATION_AMOUNT
+  FREE_SHIPPING
+  ITEM_ID
+  NAME
+  ORIGINAL_CUSTOM_PRICE
+  PRICE
+  PRICE_INC_TAX
+  PRODUCT_ID
+  PRODUCT_TYPE
+  QTY
   ROW_TOTAL
-  BASE_ROW_TOTAL
+  ROW_TOTAL_INC_TAX
   ROW_TOTAL_WITH_DISCOUNT
   ROW_WEIGHT
-  PRODUCT_TYPE
-  BASE_TAX_BEFORE_DISCOUNT
+  SKU
+  TAX_AMOUNT
   TAX_BEFORE_DISCOUNT
-  ORIGINAL_CUSTOM_PRICE
-  PRICE_INC_TAX
-  BASE_PRICE_INC_TAX
-  ROW_TOTAL_INC_TAX
-  BASE_ROW_TOTAL_INC_TAX
-  DISCOUNT_TAX_COMPENSATION_AMOUNT
-  BASE_DISCOUNT_TAX_COMPENSATION_AMOUNT
-  FREE_SHIPPING
+  TAX_PERCENT
+  UPDATED_AT
+  WEIGHT
 }
 
-"""
-Specifies the field to use for sorting quote items
-"""
-input QuoteItemsSortInput {
+type CartItems {
   """
-  Specifies the quote items field to sort by
+  An array of products that have been added to the cart.
   """
-  field: SortQuoteItemsEnum!
+  items: [CartItemInterface]!
   """
-  Specifies the order of quote items' sorting
+  Metadata for pagination rendering.
   """
-  order: SortEnum!
-}
-
-type Cart {
-  itemsV2(pageSize: Int = 20, currentPage: Int = 1, sort: QuoteItemsSortInput): CartItems
-    @deprecated(reason: "Magento >= 2.4.7")
+  page_info: SearchResultPageInfo
+  """
+  The number of returned cart items.
+  """
+  total_count: Int!
 }

package/schema-247/CartAddress.graphqls

@@ -1,3 +1,22 @@
+type BillingCartAddress {
+  """
+  The customer's fax number.
+  """
+  fax: String @deprecated(reason: "Magento >= 2.4.7")
+  """
+  The middle name of the person associated with the billing/shipping address.
+  """
+  middlename: String @deprecated(reason: "Magento >= 2.4.7")
+  """
+  An honorific, such as Dr., Mr., or Mrs.
+  """
+  prefix: String @deprecated(reason: "Magento >= 2.4.7")
+  """
+  A value such as Sr., Jr., or III.
+  """
+  suffix: String @deprecated(reason: "Magento >= 2.4.7")
+}
+
 input CartAddressInput {
   """
   The customer's fax number.
@@ -17,7 +36,7 @@ input CartAddressInput {
   suffix: String @deprecated(reason: "Magento >= 2.4.7")
 }
 
-type BillingCartAdress {
+interface CartAddressInterface {
   """
   The customer's fax number.
   """

package/schema-247/CartItemInterface.graphqls

@@ -0,0 +1,41 @@
+type BundleCartItem {
+  """
+  True if requested quantity is less than available stock, false otherwise.
+  """
+  is_available: Boolean @deprecated(reason: "Magento >= 2.4.7")
+}
+
+interface CartItemInterface {
+  """
+  True if requested quantity is less than available stock, false otherwise.
+  """
+  is_available: Boolean @deprecated(reason: "Magento >= 2.4.7")
+}
+
+type ConfigurableCartItem {
+  """
+  True if requested quantity is less than available stock, false otherwise.
+  """
+  is_available: Boolean @deprecated(reason: "Magento >= 2.4.7")
+}
+
+type DownloadableCartItem {
+  """
+  True if requested quantity is less than available stock, false otherwise.
+  """
+  is_available: Boolean @deprecated(reason: "Magento >= 2.4.7")
+}
+
+type SimpleCartItem {
+  """
+  True if requested quantity is less than available stock, false otherwise.
+  """
+  is_available: Boolean @deprecated(reason: "Magento >= 2.4.7")
+}
+
+type VirtualCartItem {
+  """
+  True if requested quantity is less than available stock, false otherwise.
+  """
+  is_available: Boolean @deprecated(reason: "Magento >= 2.4.7")
+}

package/schema-247/{Mutation-confirmEmail.graphqls → Confirmation.graphqls}

@@ -1,55 +1,53 @@
-# This is a commpatibility file: This does not implement any working functionality and only serves as a way to make the schema compatible with Magento 2.4.7
-
-type StoreConfig {
+type Mutation {
   """
-  Indicates if the new accounts need confirmation.
+  Confirms the email address for a customer.
   """
-  create_account_confirmation: Boolean
+  confirmEmail(
+    """
+    An input object to identify the customer to confirm the email.
+    """
+    input: ConfirmEmailInput!
+  ): CustomerOutput @deprecated(reason: "Magento >= 2.4.7")
 }
 
 """
-List of account confirmation statuses.
+Contains details about a customer email address to confirm.
 """
-enum ConfirmationStatusEnum {
+input ConfirmEmailInput {
   """
-  Account confirmed
+  The key to confirm the email address.
   """
-  ACCOUNT_CONFIRMED
+  confirmation_key: String!
   """
-  Account confirmation not required
+  The email address to be confirmed.
   """
-  ACCOUNT_CONFIRMATION_NOT_REQUIRED
+  email: String!
 }
 
 type Customer {
   """
   The customer's confirmation status.
   """
-  confirmation_status: ConfirmationStatusEnum!
+  confirmation_status: ConfirmationStatusEnum @deprecated(reason: "Magento >= 2.4.7")
 }
 
 """
-Contains details about a customer email address to confirm.
+List of account confirmation statuses.
 """
-input ConfirmEmailInput {
+enum ConfirmationStatusEnum {
   """
-  The key to confirm the email address.
+  Account confirmation not required
   """
-  confirmation_key: String!
+  ACCOUNT_CONFIRMATION_NOT_REQUIRED
   """
-  The email address to be confirmed.
+  Account confirmed
   """
-  email: String!
+  ACCOUNT_CONFIRMED
 }
 
-type Mutation {
+type StoreConfig {
   """
-  Confirms the email address for a customer.
+  Indicates if the new accounts need confirmation.
   """
-  confirmEmail(
-    """
-    An input object to identify the customer to confirm the email.
-    """
-    input: ConfirmEmailInput!
-  ): CustomerOutput @deprecated(reason: "Magento >= 2.4.7")
+  create_account_confirmation: Boolean @deprecated(reason: "Magento >= 2.4.7")
 }

package/schema-247/CustomerOrder.graphqls

@@ -1,3 +1,14 @@
 type CustomerOrder {
-  applied_coupons: [AppliedCoupon]
+  """
+  Coupons applied to the order.
+  """
+  applied_coupons: [AppliedCoupon] @deprecated(reason: "Magento >= 2.4.7")
+  """
+  Order customer email.
+  """
+  email: String @deprecated(reason: "Magento >= 2.4.7")
+  """
+  The token that can be used to retrieve the order using order query.
+  """
+  token: String @deprecated(reason: "Magento >= 2.4.7")
 }

package/schema-247/CustomizableOptionInput.graphqls

@@ -0,0 +1,6 @@
+input CustomizableOptionInput {
+  """
+  The unique ID for a `CartItemInterface` object.
+  """
+  uid: ID @deprecated(reason: "Magento >= 2.4.7")
+}

package/schema-247/Discount.graphqls

@@ -0,0 +1,15 @@
+type Discount {
+  """
+  The type of the entity the discount is applied to.
+  """
+  applied_to: CartDiscountType @deprecated(reason: "Magento >= 2.4.7")
+  """
+  The coupon related to the discount.
+  """
+  coupon: AppliedCoupon @deprecated(reason: "Magento >= 2.4.7")
+}
+
+enum CartDiscountType {
+  ITEM
+  SHIPPING
+}

package/schema-247/FilterMatchTypeInput.graphqls

@@ -0,0 +1,11 @@
+input FilterMatchTypeInput {
+  """
+  Filter match type for fine-tuned results. Possible values FULL or PARTIAL. If match_type is not provided, returned results will default to FULL match.
+  """
+  match_type: FilterMatchTypeEnum @deprecated(reason: "Magento >= 2.4.7")
+}
+
+enum FilterMatchTypeEnum {
+  FULL
+  PARTIAL
+}

package/schema-247/{Query-guestOrder.graphqls → GuestOrder.graphqls}

@@ -1,8 +1,12 @@
-type CustomerOrder {
+type Query {
+  """
+  Retrieve guest order details based on number, email and postcode.
+  """
+  guestOrder(input: OrderInformationInput!): CustomerOrder @deprecated(reason: "Magento >= 2.4.7")
   """
-  Order customer email.
+  Retrieve guest order details based on token.
   """
-  email: String
+  guestOrderByToken(input: OrderTokenInput!): CustomerOrder @deprecated(reason: "Magento >= 2.4.7")
 }
 
 """
@@ -23,9 +27,12 @@ input OrderInformationInput {
   postcode: String!
 }
 
-type Query {
+"""
+Input to retrieve an order based on token.
+"""
+input OrderTokenInput {
   """
-  Retrieve guest order details based on number, email and postcode.
+  Order token.
   """
-  guestOrder(input: OrderInformationInput!): CustomerOrder @deprecated(reason: "Magento >= 2.4.7")
+  token: String!
 }

package/schema-247/Mutation-contactUs.graphqls

@@ -1,3 +1,15 @@
+type Mutation {
+  """
+  Send a 'Contact Us' email to the merchant.
+  """
+  contactUs(
+    """
+    An input object that defines shopper information.
+    """
+    input: ContactUsInput!
+  ): ContactUsOutput @deprecated(reason: "Magento >= 2.4.7")
+}
+
 input ContactUsInput {
   """
   The shopper's comment to the merchant.
@@ -26,15 +38,3 @@ type ContactUsOutput {
   """
   status: Boolean!
 }
-
-type Mutation {
-  """
-  Send a 'Contact Us' email to the merchant.
-  """
-  contactUs(
-    """
-    An input object that defines shopper information.
-    """
-    input: ContactUsInput!
-  ): ContactUsOutput @deprecated(reason: "Magento >= 2.4.7")
-}

package/schema-247/Mutation-createGuestCart.graphqls

@@ -1,3 +1,11 @@
+type Mutation {
+  """
+  Create a new shopping cart
+  """
+  createGuestCart(input: CreateGuestCartInput): CreateGuestCartOutput
+    @deprecated(reason: "Magento >= 2.4.7")
+}
+
 input CreateGuestCartInput {
   """
   Optional client-generated ID
@@ -11,11 +19,3 @@ type CreateGuestCartOutput {
   """
   cart: Cart
 }
-
-type Mutation {
-  """
-  Create a new shopping cart
-  """
-  createGuestCart(input: CreateGuestCartInput): CreateGuestCartOutput
-    @deprecated(reason: "Magento >= 2.4.7")
-}