Update docs, fixes #399

Author: pozylon

changelog.md

@@ -19,7 +19,8 @@ registerProductDiscoverabilityFilter({ hiddenTagValue: 'hidden' });
 **Attention: If you upgrade to this version from <3, first upgrade to the latest v3 to not miss any migrations.**
 
 ## Major
-- Removed `CARD` type for payments. We never used it and it doesn't make sense to provide card data in plaintext.
+- Added `Mutation.updateCartPaymentInvoice`, `Mutation.updateCartPaymentGeneric`, `Mutation.updateCartDeliveryPickUp`, `Mutation.updateCartDeliveryShipping`. Those mutations do not only change the provider's configuration but also set the provider as current provider on the cart/orderId provided. As this new flow is superior to the old one involving calling multiple mutations and holding a deliveryId/paymentId in memory for clients, we deprecated the following mutations: `Mutation.updateOrderDeliveryShipping`, `Mutation.updateOrderDeliveryPickUp`, `Mutation.updateOrderPaymentInvoice`, `Mutation.updateOrderPaymentGeneric`, `Mutation.setOrderPaymentProvider`, `Mutation.setOrderDeliveryProvider`
+- Removed `CARD` type for payments. We never used it and it doesn't make sense to provide card data in plaintext. Removing `Mutation.updateOrderPaymentCard`.
 - Boolean filter types do not support an undefined or null state of values and whenever the key is set in a filter query and it's of type SWITCH (for ex. `[{ key: "meta.feeds.googleAds" }]` it will only show products that have a value of true. You can still do a "NOT" filtering by explicitly providing a value of false or 0: `[{ key: "meta.feeds.googleAds", value: "false" }]`
 - `Query.eventsCount` and `Query.events` now accept a DateFilterInput (start/end range) for the created date.
 - The Locale Context has been refactored and all API's that had the old chaotic naming: What was once countryContext, currencyContext or localeContext is now countryCode, currencyCode, locale throughout the system: The type of locale fields in the API are now validated at the GraphQL Server level. This effects a lot of plugins too, please check migration-v4.md.

docs/docs/extend/order-fulfilment/carts.md

@@ -83,7 +83,7 @@ query {
 By using `Mutation.updateCart` you can change the active payment provider for that order (input parameter
 `paymentProviderId`).
 
-To set payment provider related options, use `Mutation.updateOrderPaymentInvoice` or `Mutation.updateOrderPaymentGeneric`.
+To set payment provider related options, use `Mutation.updateCartPaymentInvoice` or `Mutation.updateCartPaymentGeneric`.
 
 ## Delivery Provider configuration
 
@@ -121,8 +121,8 @@ query {
 By using `Mutation.updateCart` you can change the active delivery provider for that order (input
 parameter `deliveryProviderId`).
 
-To set delivery provider related options, use `Mutation.updateOrderDeliveryPickUp` or
-`Mutation.updateOrderDeliveryShipping`. Pick up providers usually want a pickup location, shipping
+To set delivery provider related options, use `Mutation.updateCartDeliveryPickUp` or
+`Mutation.updateCartDeliveryShipping`. Pick up providers usually want a pickup location, shipping
 providers usually want to know an address to ship a parcel to.
 
 ## Discounts

docs/docs/platform-configuration/plugins/apple-iap.md

@@ -64,12 +64,10 @@ signPaymentProviderForCredentialRegistration(
 3. **Create Order**: Create an order with the purchased product and set transaction metadata:
 
 ```graphql
-updateOrderPayment(
-  orderPaymentId: "order-payment-id"
-  paymentPayment: {
-    meta: {
-      transactionIdentifier: "apple-transaction-id"
-    }
+updateCartPaymentGeneric(
+  paymentProviderId: "apple-iap-provider-id"
+  meta: {
+    transactionIdentifier: "apple-transaction-id"
   }
 )
 ```

docs/docs/tutorials/sausage-pricing.md

@@ -236,38 +236,18 @@ mutation addCartProduct {
 }
 ```
 
-Tell Unchained more about the guy who orders:
+Tell Unchained more about the guy who orders and optionally set payment and delivery providers:
 
 ```
 mutation updateContact {
-  updateCart(contact: { emailAddress: "hello@unchained.local" }, billingAddress: {firstName: "Pascal", addressLine: "Haha", postalCode: "5556", city: "somewhere"}) {
+  updateCart(contact: { emailAddress: "hello@unchained.local" }, billingAddress: {firstName: "Pascal", addressLine: "Haha", postalCode: "5556", city: "somewhere"}, 
+        paymentProviderId: "PROVIDER_ID"
+        deliveryProviderId: "PROVIDER_ID") {
     _id
   }
 }
 ```
 
-Set order payment provider (optional):
-
-```
-mutation SetOrderPaymentProvider{
-    setOrderPaymentProvider(
-      orderId: "ORDERID",
-      paymentProviderId: "PROVIDER_ID"
-    )
-  }
-```
-
-Set order delivery provider (optional):
-
-```
-mutation SetOrderDeliverProvider {
-    setOrderDeliveryProvider(
-      orderId: "ORDERID",
-      deliveryProviderId: "PROVIDER_ID"
-    )
-  }
-```
-
 Checkout the cart:
 
 ```

packages/api/src/schema/mutation.ts

@@ -236,7 +236,7 @@ export default [
         @deprecated(reason: "Use updateCart or updateCartPayment* mutations instead")
 
       """
-      Update the cart using a Shipping Delivery Provider with specific configuration
+      Update the cart by changing the delivery provider and using a shipping specific configuration
       """
       updateCartDeliveryShipping(
         orderId: ID
@@ -246,7 +246,7 @@ export default [
       ): Order!
 
       """
-      Update the cart using a PickUp Delivery Provider with specific configuration
+      Update the cart by changing the delivery provider and using a pick up specific configuration
       """
       updateCartDeliveryPickUp(
         orderId: ID
@@ -256,12 +256,12 @@ export default [
       ): Order!
 
       """
-      Update the cart using an invoice-type payment provider with specific configuration
+      Update the cart by changing the payment provider and using an invoice-type specific configuration
       """
       updateCartPaymentInvoice(orderId: ID, paymentProviderId: ID!, meta: JSON): Order!
 
       """
-      Update the cart using a generic payment provider with specific configuration
+      Update the cart by changing the payment provider and using a generic specific configuration
       """
       updateCartPaymentGeneric(orderId: ID, paymentProviderId: ID!, meta: JSON): Order!