package Torello.Browser.BrowserAPI;

import java.util.*;
import javax.json.*;
import javax.json.stream.*;
import java.io.*;

import java.lang.reflect.Method;
import java.lang.reflect.Parameter;
import java.util.function.Function;

import Torello.Browser.BrowserEvent;
import Torello.Browser.JavaScriptAPI.*;
import Torello.Browser.helper.*;

import Torello.Java.Additional.*;
import Torello.Java.JSON.*;

import static Torello.Java.JSON.JFlag.*;

import Torello.Java.StrCmpr;
import Torello.JavaDoc.StaticFunctional;
import Torello.JavaDoc.JDHeaderBackgroundImg;
import Torello.JavaDoc.Excuse;

/**
 * <SPAN CLASS=COPIEDJDK><B>Defines commands and events for Autofill.</B></SPAN>
 * 
 * <EMBED CLASS='external-html' DATA-FILE-ID=CODE_GEN_NOTE>
 */
@StaticFunctional(Excused={"counter"}, Excuses={Excuse.CONFIGURATION})
@JDHeaderBackgroundImg(EmbedTagFileID="WOOD_PLANK_NOTE")
public class Autofill
{
    // ********************************************************************************************
    // ********************************************************************************************
    // Class Header Stuff
    // ********************************************************************************************
    // ********************************************************************************************


    // No Pubic Constructors
    private Autofill () { }

    // These two Vector's are used by all the "Methods" exported by this class.  java.lang.reflect
    // is used to generate the JSON String's.  It saves thousands of lines of Auto-Generated Code.
    private static final Map<String, Vector<String>>    parameterNames = new HashMap<>();
    private static final Map<String, Vector<Class<?>>>  parameterTypes = new HashMap<>();

    // Some Methods do not take any parameters - for instance all the "enable()" and "disable()"
    // I simply could not get ride of RAW-TYPES and UNCHECKED warnings... so there are now,
    // offically, two empty-vectors.  One for String's, and the other for Classes.

    private static final Vector<String>     EMPTY_VEC_STR = new Vector<>();
    private static final Vector<Class<?>>   EMPTY_VEC_CLASS = new Vector<>();

    static
    {
        for (Method m : Autofill.class.getMethods())
        {
            // This doesn't work!  The parameter names are all "arg0" ... "argN"
            // It works for java.lang.reflect.Field, BUT NOT java.lang.reflect.Parameter!
            //
            // Vector<String> parameterNamesList = new Vector<>(); -- NOPE!

            Vector<Class<?>> parameterTypesList = new Vector<>();
        
            for (Parameter p : m.getParameters()) parameterTypesList.add(p.getType());

            parameterTypes.put(
                m.getName(),
                (parameterTypesList.size() > 0) ? parameterTypesList : EMPTY_VEC_CLASS
            );
        }
    }

    static
    {
        Vector<String> v = null;

        v = new Vector<String>(3);
        parameterNames.put("trigger", v);
        Collections.addAll(v, new String[]
        { "fieldId", "frameId", "card", });

        v = new Vector<String>(1);
        parameterNames.put("setAddresses", v);
        Collections.addAll(v, new String[]
        { "addresses", });

        parameterNames.put("disable", EMPTY_VEC_STR);

        parameterNames.put("enable", EMPTY_VEC_STR);
    }


    // ********************************************************************************************
    // ********************************************************************************************
    // Types - Static Inner Classes
    // ********************************************************************************************
    // ********************************************************************************************

    /** Specified whether a filled field was done so by using the html autocomplete attribute or autofill heuristics. */
    public static final String[] FillingStrategy =
    { "autocompleteAttribute", "autofillInferred", };
    
    /** <CODE>[No Description Provided by Google]</CODE> */
    public static class CreditCard
        extends BaseType
        implements java.io.Serializable
    {
        /** For Object Serialization.  java.io.Serializable */
        protected static final long serialVersionUID = 1;
        
        public boolean[] optionals()
        { return new boolean[] { false, false, false, false, false, }; }
        
        /** 16-digit credit card number. */
        public final String number;
        
        /** Name of the credit card owner. */
        public final String name;
        
        /** 2-digit expiry month. */
        public final String expiryMonth;
        
        /** 4-digit expiry year. */
        public final String expiryYear;
        
        /** 3-digit card verification code. */
        public final String cvc;
        
        /**
         * Constructor
         *
         * @param number 16-digit credit card number.
         * 
         * @param name Name of the credit card owner.
         * 
         * @param expiryMonth 2-digit expiry month.
         * 
         * @param expiryYear 4-digit expiry year.
         * 
         * @param cvc 3-digit card verification code.
         */
        public CreditCard
            (String number, String name, String expiryMonth, String expiryYear, String cvc)
        {
            // Exception-Check(s) to ensure that if any parameters which are not declared as
            // 'Optional', but have a 'null' value anyway, that a NullPointerException shall throw.
            
            if (number == null)      THROWS.throwNPE("number");
            if (name == null)        THROWS.throwNPE("name");
            if (expiryMonth == null) THROWS.throwNPE("expiryMonth");
            if (expiryYear == null)  THROWS.throwNPE("expiryYear");
            if (cvc == null)         THROWS.throwNPE("cvc");
            
            this.number       = number;
            this.name         = name;
            this.expiryMonth  = expiryMonth;
            this.expiryYear   = expiryYear;
            this.cvc          = cvc;
        }
        
        /**
         * JSON Object Constructor
         * @param jo A Json-Object having data about an instance of {@code 'CreditCard'}.
         */
        public CreditCard (JsonObject jo)
        {
            this.number       = ReadJSON.getString(jo, "number", false, true);
            this.name         = ReadJSON.getString(jo, "name", false, true);
            this.expiryMonth  = ReadJSON.getString(jo, "expiryMonth", false, true);
            this.expiryYear   = ReadJSON.getString(jo, "expiryYear", false, true);
            this.cvc          = ReadJSON.getString(jo, "cvc", false, true);
        }
        
        
        /** Checks whether {@code 'this'} equals an input Java-{@code Object} */
        public boolean equals(Object other)
        {
            if (this == other)                       return true;
            if (other == null)                       return false;
            if (other.getClass() != this.getClass()) return false;
        
            CreditCard o = (CreditCard) other;
        
            return
                    Objects.equals(this.number, o.number)
                &&  Objects.equals(this.name, o.name)
                &&  Objects.equals(this.expiryMonth, o.expiryMonth)
                &&  Objects.equals(this.expiryYear, o.expiryYear)
                &&  Objects.equals(this.cvc, o.cvc);
        }
        
        /** Generates a Hash-Code for {@code 'this'} instance */
        public int hashCode()
        {
            return
                    Objects.hashCode(this.number)
                +   Objects.hashCode(this.name)
                +   Objects.hashCode(this.expiryMonth)
                +   Objects.hashCode(this.expiryYear)
                +   Objects.hashCode(this.cvc);
        }
    }
    
    /** <CODE>[No Description Provided by Google]</CODE> */
    public static class AddressField
        extends BaseType
        implements java.io.Serializable
    {
        /** For Object Serialization.  java.io.Serializable */
        protected static final long serialVersionUID = 1;
        
        public boolean[] optionals()
        { return new boolean[] { false, false, }; }
        
        /** address field name, for example GIVEN_NAME. */
        public final String name;
        
        /** address field value, for example Jon Doe. */
        public final String value;
        
        /**
         * Constructor
         *
         * @param name address field name, for example GIVEN_NAME.
         * 
         * @param value address field value, for example Jon Doe.
         */
        public AddressField(String name, String value)
        {
            // Exception-Check(s) to ensure that if any parameters which are not declared as
            // 'Optional', but have a 'null' value anyway, that a NullPointerException shall throw.
            
            if (name == null)  THROWS.throwNPE("name");
            if (value == null) THROWS.throwNPE("value");
            
            this.name   = name;
            this.value  = value;
        }
        
        /**
         * JSON Object Constructor
         * @param jo A Json-Object having data about an instance of {@code 'AddressField'}.
         */
        public AddressField (JsonObject jo)
        {
            this.name   = ReadJSON.getString(jo, "name", false, true);
            this.value  = ReadJSON.getString(jo, "value", false, true);
        }
        
        
        /** Checks whether {@code 'this'} equals an input Java-{@code Object} */
        public boolean equals(Object other)
        {
            if (this == other)                       return true;
            if (other == null)                       return false;
            if (other.getClass() != this.getClass()) return false;
        
            AddressField o = (AddressField) other;
        
            return
                    Objects.equals(this.name, o.name)
                &&  Objects.equals(this.value, o.value);
        }
        
        /** Generates a Hash-Code for {@code 'this'} instance */
        public int hashCode()
        {
            return
                    Objects.hashCode(this.name)
                +   Objects.hashCode(this.value);
        }
    }
    
    /** A list of address fields. */
    public static class AddressFields
        extends BaseType
        implements java.io.Serializable
    {
        /** For Object Serialization.  java.io.Serializable */
        protected static final long serialVersionUID = 1;
        
        public boolean[] optionals()
        { return new boolean[] { false, }; }
        
        /** <CODE>[No Description Provided by Google]</CODE> */
        public final Autofill.AddressField[] fields;
        
        /**
         * Constructor
         *
         * @param fields -
         */
        public AddressFields(Autofill.AddressField[] fields)
        {
            // Exception-Check(s) to ensure that if any parameters which are not declared as
            // 'Optional', but have a 'null' value anyway, that a NullPointerException shall throw.
            
            if (fields == null) THROWS.throwNPE("fields");
            
            this.fields  = fields;
        }
        
        /**
         * JSON Object Constructor
         * @param jo A Json-Object having data about an instance of {@code 'AddressFields'}.
         */
        public AddressFields (JsonObject jo)
        {
            this.fields = (jo.getJsonArray("fields") == null)
                ? null
                : RJArrIntoStream.objArr(jo.getJsonArray("fields"), null, 0, Autofill.AddressField.class).toArray(Autofill.AddressField[]::new);
        
        }
        
        
        /** Checks whether {@code 'this'} equals an input Java-{@code Object} */
        public boolean equals(Object other)
        {
            if (this == other)                       return true;
            if (other == null)                       return false;
            if (other.getClass() != this.getClass()) return false;
        
            AddressFields o = (AddressFields) other;
        
            return
                    Arrays.deepEquals(this.fields, o.fields);
        }
        
        /** Generates a Hash-Code for {@code 'this'} instance */
        public int hashCode()
        {
            return
                    Arrays.deepHashCode(this.fields);
        }
    }
    
    /** <CODE>[No Description Provided by Google]</CODE> */
    public static class Address
        extends BaseType
        implements java.io.Serializable
    {
        /** For Object Serialization.  java.io.Serializable */
        protected static final long serialVersionUID = 1;
        
        public boolean[] optionals()
        { return new boolean[] { false, }; }
        
        /** fields and values defining an address. */
        public final Autofill.AddressField[] fields;
        
        /**
         * Constructor
         *
         * @param fields fields and values defining an address.
         */
        public Address(Autofill.AddressField[] fields)
        {
            // Exception-Check(s) to ensure that if any parameters which are not declared as
            // 'Optional', but have a 'null' value anyway, that a NullPointerException shall throw.
            
            if (fields == null) THROWS.throwNPE("fields");
            
            this.fields  = fields;
        }
        
        /**
         * JSON Object Constructor
         * @param jo A Json-Object having data about an instance of {@code 'Address'}.
         */
        public Address (JsonObject jo)
        {
            this.fields = (jo.getJsonArray("fields") == null)
                ? null
                : RJArrIntoStream.objArr(jo.getJsonArray("fields"), null, 0, Autofill.AddressField.class).toArray(Autofill.AddressField[]::new);
        
        }
        
        
        /** Checks whether {@code 'this'} equals an input Java-{@code Object} */
        public boolean equals(Object other)
        {
            if (this == other)                       return true;
            if (other == null)                       return false;
            if (other.getClass() != this.getClass()) return false;
        
            Address o = (Address) other;
        
            return
                    Arrays.deepEquals(this.fields, o.fields);
        }
        
        /** Generates a Hash-Code for {@code 'this'} instance */
        public int hashCode()
        {
            return
                    Arrays.deepHashCode(this.fields);
        }
    }
    
    /**
     * Defines how an address can be displayed like in chrome://settings/addresses.
     * Address UI is a two dimensional array, each inner array is an "address information line", and when rendered in a UI surface should be displayed as such.
     * The following address UI for instance:
     * [[{name: "GIVE_NAME", value: "Jon"}, {name: "FAMILY_NAME", value: "Doe"}], [{name: "CITY", value: "Munich"}, {name: "ZIP", value: "81456"}]]
     * should allow the receiver to render:
     * Jon Doe
     * Munich 81456
     */
    public static class AddressUI
        extends BaseType
        implements java.io.Serializable
    {
        /** For Object Serialization.  java.io.Serializable */
        protected static final long serialVersionUID = 1;
        
        public boolean[] optionals()
        { return new boolean[] { false, }; }
        
        /** A two dimension array containing the representation of values from an address profile. */
        public final Autofill.AddressFields[] addressFields;
        
        /**
         * Constructor
         *
         * @param addressFields A two dimension array containing the representation of values from an address profile.
         */
        public AddressUI(Autofill.AddressFields[] addressFields)
        {
            // Exception-Check(s) to ensure that if any parameters which are not declared as
            // 'Optional', but have a 'null' value anyway, that a NullPointerException shall throw.
            
            if (addressFields == null) THROWS.throwNPE("addressFields");
            
            this.addressFields  = addressFields;
        }
        
        /**
         * JSON Object Constructor
         * @param jo A Json-Object having data about an instance of {@code 'AddressUI'}.
         */
        public AddressUI (JsonObject jo)
        {
            this.addressFields = (jo.getJsonArray("addressFields") == null)
                ? null
                : RJArrIntoStream.objArr(jo.getJsonArray("addressFields"), null, 0, Autofill.AddressFields.class).toArray(Autofill.AddressFields[]::new);
        
        }
        
        
        /** Checks whether {@code 'this'} equals an input Java-{@code Object} */
        public boolean equals(Object other)
        {
            if (this == other)                       return true;
            if (other == null)                       return false;
            if (other.getClass() != this.getClass()) return false;
        
            AddressUI o = (AddressUI) other;
        
            return
                    Arrays.deepEquals(this.addressFields, o.addressFields);
        }
        
        /** Generates a Hash-Code for {@code 'this'} instance */
        public int hashCode()
        {
            return
                    Arrays.deepHashCode(this.addressFields);
        }
    }
    
    /** <CODE>[No Description Provided by Google]</CODE> */
    public static class FilledField
        extends BaseType
        implements java.io.Serializable
    {
        /** For Object Serialization.  java.io.Serializable */
        protected static final long serialVersionUID = 1;
        
        public boolean[] optionals()
        { return new boolean[] { false, false, false, false, false, false, false, false, }; }
        
        /** The type of the field, e.g text, password etc. */
        public final String htmlType;
        
        /** the html id */
        public final String id;
        
        /** the html name */
        public final String name;
        
        /** the field value */
        public final String value;
        
        /** The actual field type, e.g FAMILY_NAME */
        public final String autofillType;
        
        /** The filling strategy */
        public final String fillingStrategy;
        
        /** The frame the field belongs to */
        public final String frameId;
        
        /** The form field's DOM node */
        public final int fieldId;
        
        /**
         * Constructor
         *
         * @param htmlType The type of the field, e.g text, password etc.
         * 
         * @param id the html id
         * 
         * @param name the html name
         * 
         * @param value the field value
         * 
         * @param autofillType The actual field type, e.g FAMILY_NAME
         * 
         * @param fillingStrategy The filling strategy
         * 
         * @param frameId The frame the field belongs to
         * 
         * @param fieldId The form field's DOM node
         */
        public FilledField(
                String htmlType, String id, String name, String value, String autofillType, 
                String fillingStrategy, String frameId, int fieldId
            )
        {
            // Exception-Check(s) to ensure that if any parameters which are not declared as
            // 'Optional', but have a 'null' value anyway, that a NullPointerException shall throw.
            
            if (htmlType == null)        THROWS.throwNPE("htmlType");
            if (id == null)              THROWS.throwNPE("id");
            if (name == null)            THROWS.throwNPE("name");
            if (value == null)           THROWS.throwNPE("value");
            if (autofillType == null)    THROWS.throwNPE("autofillType");
            if (fillingStrategy == null) THROWS.throwNPE("fillingStrategy");
            if (frameId == null)         THROWS.throwNPE("frameId");
            
            // Exception-Check(s) to ensure that if any parameters which must adhere to a
            // provided List of Enumerated Values, fails, then IllegalArgumentException shall throw.
            
            THROWS.checkIAE("fillingStrategy", fillingStrategy, "Autofill.FillingStrategy", Autofill.FillingStrategy);
            
            this.htmlType         = htmlType;
            this.id               = id;
            this.name             = name;
            this.value            = value;
            this.autofillType     = autofillType;
            this.fillingStrategy  = fillingStrategy;
            this.frameId          = frameId;
            this.fieldId          = fieldId;
        }
        
        /**
         * JSON Object Constructor
         * @param jo A Json-Object having data about an instance of {@code 'FilledField'}.
         */
        public FilledField (JsonObject jo)
        {
            this.htmlType         = ReadJSON.getString(jo, "htmlType", false, true);
            this.id               = ReadJSON.getString(jo, "id", false, true);
            this.name             = ReadJSON.getString(jo, "name", false, true);
            this.value            = ReadJSON.getString(jo, "value", false, true);
            this.autofillType     = ReadJSON.getString(jo, "autofillType", false, true);
            this.fillingStrategy  = ReadJSON.getString(jo, "fillingStrategy", false, true);
            this.frameId          = ReadJSON.getString(jo, "frameId", false, true);
            this.fieldId          = ReadPrimJSON.getInt(jo, "fieldId");
        }
        
        
        /** Checks whether {@code 'this'} equals an input Java-{@code Object} */
        public boolean equals(Object other)
        {
            if (this == other)                       return true;
            if (other == null)                       return false;
            if (other.getClass() != this.getClass()) return false;
        
            FilledField o = (FilledField) other;
        
            return
                    Objects.equals(this.htmlType, o.htmlType)
                &&  Objects.equals(this.id, o.id)
                &&  Objects.equals(this.name, o.name)
                &&  Objects.equals(this.value, o.value)
                &&  Objects.equals(this.autofillType, o.autofillType)
                &&  Objects.equals(this.fillingStrategy, o.fillingStrategy)
                &&  Objects.equals(this.frameId, o.frameId)
                &&  Objects.equals(this.fieldId, o.fieldId);
        }
        
        /** Generates a Hash-Code for {@code 'this'} instance */
        public int hashCode()
        {
            return
                    Objects.hashCode(this.htmlType)
                +   Objects.hashCode(this.id)
                +   Objects.hashCode(this.name)
                +   Objects.hashCode(this.value)
                +   Objects.hashCode(this.autofillType)
                +   Objects.hashCode(this.fillingStrategy)
                +   Objects.hashCode(this.frameId)
                +   this.fieldId;
        }
    }
    
    /** Emitted when an address form is filled. */
    public static class addressFormFilled
        extends BrowserEvent
        implements java.io.Serializable
    {
        /** For Object Serialization.  java.io.Serializable */
        protected static final long serialVersionUID = 1;
        
        public boolean[] optionals()
        { return new boolean[] { false, false, }; }
        
        /** Information about the fields that were filled */
        public final Autofill.FilledField[] filledFields;
        
        /**
         * An UI representation of the address used to fill the form.
         * Consists of a 2D array where each child represents an address/profile line.
         */
        public final Autofill.AddressUI addressUi;
        
        /**
         * Constructor
         *
         * @param filledFields Information about the fields that were filled
         * 
         * @param addressUi 
         * An UI representation of the address used to fill the form.
         * Consists of a 2D array where each child represents an address/profile line.
         */
        public addressFormFilled
            (Autofill.FilledField[] filledFields, Autofill.AddressUI addressUi)
        {
            super("Autofill", "addressFormFilled", 2);
            
            // Exception-Check(s) to ensure that if any parameters which are not declared as
            // 'Optional', but have a 'null' value anyway, that a NullPointerException shall throw.
            
            if (filledFields == null) THROWS.throwNPE("filledFields");
            if (addressUi == null)    THROWS.throwNPE("addressUi");
            
            this.filledFields  = filledFields;
            this.addressUi     = addressUi;
        }
        
        /**
         * JSON Object Constructor
         * @param jo A Json-Object having data about an instance of {@code 'addressFormFilled'}.
         */
        public addressFormFilled (JsonObject jo)
        {
            super("Autofill", "addressFormFilled", 2);
        
            this.filledFields = (jo.getJsonArray("filledFields") == null)
                ? null
                : RJArrIntoStream.objArr(jo.getJsonArray("filledFields"), null, 0, Autofill.FilledField.class).toArray(Autofill.FilledField[]::new);
        
            this.addressUi     = ReadJSON.getObject(jo, "addressUi", Autofill.AddressUI.class, false, true);
        }
        
        
        /** Checks whether {@code 'this'} equals an input Java-{@code Object} */
        public boolean equals(Object other)
        {
            if (this == other)                       return true;
            if (other == null)                       return false;
            if (other.getClass() != this.getClass()) return false;
        
            addressFormFilled o = (addressFormFilled) other;
        
            return
                    Arrays.deepEquals(this.filledFields, o.filledFields)
                &&  Objects.equals(this.addressUi, o.addressUi);
        }
        
        /** Generates a Hash-Code for {@code 'this'} instance */
        public int hashCode()
        {
            return
                    Arrays.deepHashCode(this.filledFields)
                +   this.addressUi.hashCode();
        }
    }
    
    
    // Counter for keeping the WebSocket Request ID's distinct.
    private static int counter = 1;
    
    /**
     * Trigger autofill on a form identified by the fieldId.
     * If the field and related form cannot be autofilled, returns an error.
     * 
     * @param fieldId Identifies a field that serves as an anchor for autofill.
     * 
     * @param frameId Identifies the frame that field belongs to.
     * <BR /><B CLASS=Opt>OPTIONAL</B>
     * 
     * @param card Credit card information to fill out the form. Credit card data is not saved.
     * 
     * @return An instance of <CODE>{@link Script}&lt;String, {@link JsonObject},
     * {@link Ret0}&gt;</CODE>
     *
     * <BR /><BR />This {@code Script} instance must be <B STYLE='color:red'>executed</B> before the
     * browser receives the invocation-request.
     *
     * <BR /><BR />This Browser-Function <I>does not have</I> a return-value.  You may choose to
     * <B STYLE='color: red'>await</B> the {@link Promise}{@code <JsonObject,} {@link Ret0}
     * {@code >} to ensure the Browser Function has run to completion.
     */
    public static Script<String, JsonObject, Ret0> trigger
        (int fieldId, String frameId, Autofill.CreditCard card)
    {
        // Exception-Check(s) to ensure that if any parameters which are not declared as
        // 'Optional', but have a 'null' value anyway, that a NullPointerException shall throw.
        
        if (card == null) THROWS.throwNPE("card");
        
        final int       webSocketID = 11000000 + counter++;
        final boolean[] optionals   = { false, true, false, };
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("trigger"),
            parameterNames.get("trigger"),
            optionals, webSocketID,
            "Autofill.trigger",
            fieldId, frameId, card
        );
        
        // This Remote Command does not have a Return-Value.
        return new Script<>
            (webSocketID, requestJSON, VOID_RETURN.NoReturnValues);
    }
    
    /**
     * Set addresses so that developers can verify their forms implementation.
     * 
     * @param addresses -
     * 
     * @return An instance of <CODE>{@link Script}&lt;String, {@link JsonObject},
     * {@link Ret0}&gt;</CODE>
     *
     * <BR /><BR />This {@code Script} instance must be <B STYLE='color:red'>executed</B> before the
     * browser receives the invocation-request.
     *
     * <BR /><BR />This Browser-Function <I>does not have</I> a return-value.  You may choose to
     * <B STYLE='color: red'>await</B> the {@link Promise}{@code <JsonObject,} {@link Ret0}
     * {@code >} to ensure the Browser Function has run to completion.
     */
    public static Script<String, JsonObject, Ret0> setAddresses(Autofill.Address[] addresses)
    {
        // Exception-Check(s) to ensure that if any parameters which are not declared as
        // 'Optional', but have a 'null' value anyway, that a NullPointerException shall throw.
        
        if (addresses == null) THROWS.throwNPE("addresses");
        
        final int       webSocketID = 11001000 + counter++;
        final boolean[] optionals   = { false, };
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("setAddresses"),
            parameterNames.get("setAddresses"),
            optionals, webSocketID,
            "Autofill.setAddresses",
            (Object) addresses
        );
        
        // This Remote Command does not have a Return-Value.
        return new Script<>
            (webSocketID, requestJSON, VOID_RETURN.NoReturnValues);
    }
    
    /**
     * Disables autofill domain notifications.
     * 
     * @return An instance of <CODE>{@link Script}&lt;String, {@link JsonObject},
     * {@link Ret0}&gt;</CODE>
     *
     * <BR /><BR />This {@code Script} instance must be <B STYLE='color:red'>executed</B> before the
     * browser receives the invocation-request.
     *
     * <BR /><BR />This Browser-Function <I>does not have</I> a return-value.  You may choose to
     * <B STYLE='color: red'>await</B> the {@link Promise}{@code <JsonObject,} {@link Ret0}
     * {@code >} to ensure the Browser Function has run to completion.
     */
    public static Script<String, JsonObject, Ret0> disable()
    {
        final int          webSocketID = 11002000 + counter++;
        final boolean[]    optionals   = new boolean[0];
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("disable"),
            parameterNames.get("disable"),
            optionals, webSocketID,
            "Autofill.disable"
        );
        
        // This Remote Command does not have a Return-Value.
        return new Script<>
            (webSocketID, requestJSON, VOID_RETURN.NoReturnValues);
    }
    
    /**
     * Enables autofill domain notifications.
     * 
     * @return An instance of <CODE>{@link Script}&lt;String, {@link JsonObject},
     * {@link Ret0}&gt;</CODE>
     *
     * <BR /><BR />This {@code Script} instance must be <B STYLE='color:red'>executed</B> before the
     * browser receives the invocation-request.
     *
     * <BR /><BR />This Browser-Function <I>does not have</I> a return-value.  You may choose to
     * <B STYLE='color: red'>await</B> the {@link Promise}{@code <JsonObject,} {@link Ret0}
     * {@code >} to ensure the Browser Function has run to completion.
     */
    public static Script<String, JsonObject, Ret0> enable()
    {
        final int          webSocketID = 11003000 + counter++;
        final boolean[]    optionals   = new boolean[0];
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("enable"),
            parameterNames.get("enable"),
            optionals, webSocketID,
            "Autofill.enable"
        );
        
        // This Remote Command does not have a Return-Value.
        return new Script<>
            (webSocketID, requestJSON, VOID_RETURN.NoReturnValues);
    }
    
}