[Web Payments] Add Spinners and timeout while waiting for UpdateWith

components/payments/content/payment_request_spec.h

 // Copyright 2017 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 #ifndef COMPONENTS_PAYMENTS_CONTENT_PAYMENT_REQUEST_SPEC_H_
 #define COMPONENTS_PAYMENTS_CONTENT_PAYMENT_REQUEST_SPEC_H_
 
 #include <set>
 #include <string>
 #include <vector>
 
 #include "base/macros.h"
 #include "base/observer_list.h"
 #include "components/payments/content/payment_request.mojom.h"
 #include "components/payments/core/currency_formatter.h"
 #include "components/payments/core/payment_options_provider.h"
 
 namespace payments {
 
 // Identifier for the basic card payment method in the PaymentMethodData.
 extern const char kBasicCardMethodName[];
 
 // The spec contains all the options that the merchant has specified about this
 // Payment Request. It's a (mostly) read-only view, which can be updated in
 // certain occasions by the merchant (see API).
 class PaymentRequestSpec : public PaymentOptionsProvider {
  public:
+  // This enum represents which bit of information was changed to trigger an
+  // update roundtrip with the website.
+  enum class UpdateReason {
+    NONE,
+    SHIPPING_OPTION,
+    SHIPPING_ADDRESS,
+  };
+
   // Any class call add itself as Observer via AddObserver() and receive
   // notification about spec events.
   class Observer {
    public:
     // Called when the provided spec (details, options, method_data) is invalid.
     virtual void OnInvalidSpecProvided() = 0;
 
+    // Called when the website is notified that the user selected shipping
+    // options or a shipping address. This will be followed by a call to
+    // OnSpecUpdated or the PaymentRequest being aborted due to a timeout.
+    virtual void OnStartUpdating(UpdateReason reason) {}
+
     // Called when the provided spec has changed.
     virtual void OnSpecUpdated() = 0;
 
    protected:
     virtual ~Observer() {}
   };
 
   PaymentRequestSpec(mojom::PaymentOptionsPtr options,
                      mojom::PaymentDetailsPtr details,
                      std::vector<mojom::PaymentMethodDataPtr> method_data,
@@ skipping 35 matching lines @@
   // request's currency. Will use currency of the "total" display item, because
   // all items are supposed to have the same currency in a given request.
   std::string GetFormattedCurrencyCode();
 
   mojom::PaymentShippingOption* selected_shipping_option() const {
     return selected_shipping_option_;
   }
 
   const mojom::PaymentDetails& details() const { return *details_.get(); }
 
+  void StartWaitingForUpdateWith(UpdateReason reason);
+
  private:
   friend class PaymentRequestDialogView;
   void add_observer_for_testing(Observer* observer_for_testing) {
     observer_for_testing_ = observer_for_testing;
   }
 
   // Validates the |method_data| and fills |supported_card_networks_|,
   // |supported_card_networks_set_| and |basic_card_specified_networks_|.
   void PopulateValidatedMethodData(
       const std::vector<mojom::PaymentMethodDataPtr>& method_data);
@@ skipping 39 matching lines @@
   // notified.
   base::ObserverList<Observer> observers_;
   Observer* observer_for_testing_;
 
   DISALLOW_COPY_AND_ASSIGN(PaymentRequestSpec);
 };
 
 }  // namespace payments
 
 #endif  // COMPONENTS_PAYMENTS_CONTENT_PAYMENT_REQUEST_SPEC_H_