Update Autofill Private API to provide a list of available countries.

chrome/common/extensions/api/autofill_private.idl

 // Copyright 2015 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.
 
 // Use the <code>chrome.autofillPrivate</code> API to add, remove, or update
 // autofill data from the settings UI.
 namespace autofillPrivate {
   // Fields used as part of an address.
   enum AddressField {
     FULL_NAME,
@@ skipping 75 matching lines @@
 
     DOMString[]? phoneNumbers;
 
     DOMString[]? emailAddresses;
 
     DOMString? languageCode;
 
     AutofillMetadata? metadata;
   };
 
+  // An entry representing a country and its code.
+  dictionary CountryEntry {
+    // The internationalized name of the country.
+    DOMString? name;
+
+    // A two-character string representing the country.
+    DOMString? countryCode;
+  };
+
   // A component to be shown in an address editor. Different countries have
   // different components to their addresses.
   dictionary AddressComponent {
     // The field type.
     AddressField field;
 
     // The name of the field.
     DOMString fieldName;
 
     // A hint for the UI regarding whether the input is likely to be long.
@@ skipping 52 matching lines @@
 
     // The index into |phoneNumbers| at which the newly-added/edited phone
     // number resides.
     long indexOfNewNumber;
 
     // A two-character string representing the address' country. See
     // autofill_country.cc for a list of valid codes.
     DOMString countryCode;
   };
 
+  callback GetCountryListCallback = void(CountryEntry[] countries);
   callback GetAddressComponentsCallback = void(AddressComponents components);
   callback GetAddressListCallback = void(AddressEntry[] entries);
   callback ValidatePhoneNumbersCallback =
       void(DOMString[] validatedPhoneNumbers);
   callback GetCreditCardListCallback = void(CreditCardEntry[] entries);
 
   interface Functions {
     // Saves the given address. If |address| has an empty string as its ID, it
     // will be assigned a new one and added as a new entry.
-    //
     // |address|: The address entry to save.
     static void saveAddress(AddressEntry address);
 
+    // Gets the list of all countries.
+    // |callback|: Callback which will be called with the countries.
+    static void getCountryList(GetCountryListCallback callback);
+
     // Gets the address components for a given country code.
-    //
     // |countryCode|: A two-character string representing the address' country
     //     whose components should be returned. See autofill_country.cc for a
     //     list of valid codes.
     // |callback|: Callback which will be called with components.
     static void getAddressComponents(DOMString countryCode,
         GetAddressComponentsCallback callback);
 
     // Gets the list of addresses.
     // |callback|: Callback which will be called with the list of addresses.
     static void getAddressList(GetAddressListCallback callback);
 
     // Saves the given credit card. If |card| has an empty string as its
     // ID, it will be assigned a new one and added as a new entry.
-    //
     // |card|: The card entry to save.
     static void saveCreditCard(CreditCardEntry card);
 
     // Removes the entry (address or credit card) with the given ID.
-    //
     // |guid|: ID of the entry to remove. 
     static void removeEntry(DOMString guid);
 
     // Validates a newly-added phone number and invokes the callback with a list
     // of validated numbers. Note that if the newly-added number was invalid, it
     // will not be returned in the list of valid numbers.
-    //
     // |params|: The parameters to this function.
     // |callback|: Callback which will be called with validated phone numbers.
     static void validatePhoneNumbers(ValidatePhoneParams params,
         ValidatePhoneNumbersCallback callback);
 
     // Gets the list of credit cards.
     // |callback|: Callback which will be called with the list of credit cards.
     static void getCreditCardList(GetCreditCardListCallback callback);
 
     // Clears the data associated with a wallet card which was saved
     // locally so that the saved copy is masked (e.g., "Card ending
     // in 1234").
-    //
     // |guid|: GUID of the credit card to mask.
     static void maskCreditCard(DOMString guid);
   };
 
   interface Events {
     // Fired when the address list has changed, meaning that an entry has been
     // added, removed, or changed.
-    // 
     // |entries| The updated list of entries.
     static void onAddressListChanged(AddressEntry[] entries);
 
     // Fired when the credit card list has changed, meaning that an entry has
     // been added, removed, or changed.
-    // 
     // |entries| The updated list of entries.
     static void onCreditCardListChanged(CreditCardEntry[] entries);
   };
 };