package Torello.Browser;

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.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><CODE>[No Description Provided by Google]</CODE></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 IndexedDB
{
    // ********************************************************************************************
    // ********************************************************************************************
    // Class Header Stuff
    // ********************************************************************************************
    // ********************************************************************************************


    // No Pubic Constructors
    private IndexedDB () { }

    // 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 : IndexedDB.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("clearObjectStore", v);
        Collections.addAll(v, new String[]
        { "securityOrigin", "databaseName", "objectStoreName", });

        v = new Vector<String>(2);
        parameterNames.put("deleteDatabase", v);
        Collections.addAll(v, new String[]
        { "securityOrigin", "databaseName", });

        v = new Vector<String>(4);
        parameterNames.put("deleteObjectStoreEntries", v);
        Collections.addAll(v, new String[]
        { "securityOrigin", "databaseName", "objectStoreName", "keyRange", });

        parameterNames.put("disable", EMPTY_VEC_STR);

        parameterNames.put("enable", EMPTY_VEC_STR);

        v = new Vector<String>(7);
        parameterNames.put("requestData", v);
        Collections.addAll(v, new String[]
        { "securityOrigin", "databaseName", "objectStoreName", "indexName", "skipCount", "pageSize", "keyRange", });

        v = new Vector<String>(3);
        parameterNames.put("getMetadata", v);
        Collections.addAll(v, new String[]
        { "securityOrigin", "databaseName", "objectStoreName", });

        v = new Vector<String>(2);
        parameterNames.put("requestDatabase", v);
        Collections.addAll(v, new String[]
        { "securityOrigin", "databaseName", });

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


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

    /** Database with an array of object stores. */
    public static class DatabaseWithObjectStores
        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, }; }
        
        /** Database name. */
        public final String name;
        
        /**
         * Database version (type is not 'integer', as the standard
         * requires the version number to be 'unsigned long long')
         */
        public final Number version;
        
        /** Object stores in this database. */
        public final IndexedDB.ObjectStore[] objectStores;
        
        /**
         * Constructor
         *
         * @param name Database name.
         * 
         * @param version 
         * Database version (type is not 'integer', as the standard
         * requires the version number to be 'unsigned long long')
         * 
         * @param objectStores Object stores in this database.
         */
        public DatabaseWithObjectStores
            (String name, Number version, IndexedDB.ObjectStore[] objectStores)
        {
            // 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)         BRDPC.throwNPE("name");
            if (version == null)      BRDPC.throwNPE("version");
            if (objectStores == null) BRDPC.throwNPE("objectStores");
            
            this.name          = name;
            this.version       = version;
            this.objectStores  = objectStores;
        }
        
        /**
         * JSON Object Constructor
         * @param jo A Json-Object having data about an instance of {@code 'DatabaseWithObjectStores'}.
         */
        public DatabaseWithObjectStores (JsonObject jo)
        {
            this.name          = ReadJSON.getString(jo, "name", false, true);
            this.version       = ReadNumberJSON.get(jo, "version", false, true);
            this.objectStores = (jo.getJsonArray("objectStores") == null)
                ? null
                : ReadArrJSON.DimN.objArr(jo.getJsonArray("objectStores"), null, 0, IndexedDB.ObjectStore[].class);
        
        }
        
        
        /** Checks whether {@code 'this'} equals an input Java-{@code Object} */
        public boolean equals(Object other)
        {
            if (other == null)                       return false;
            if (other.getClass() != this.getClass()) return false;
        
            DatabaseWithObjectStores o = (DatabaseWithObjectStores) other;
        
            return
                    Objects.equals(this.name, o.name)
                &&  Objects.equals(this.version, o.version)
                &&  Arrays.deepEquals(this.objectStores, o.objectStores);
        }
        
        /** Generates a Hash-Code for {@code 'this'} instance */
        public int hashCode()
        {
            return
                    Objects.hashCode(this.name)
                +   Objects.hashCode(this.version)
                +   Arrays.deepHashCode(this.objectStores);
        }
    }
    
    /** Object store. */
    public static class ObjectStore
        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, }; }
        
        /** Object store name. */
        public final String name;
        
        /** Object store key path. */
        public final IndexedDB.KeyPath keyPath;
        
        /** If true, object store has auto increment flag set. */
        public final boolean autoIncrement;
        
        /** Indexes in this object store. */
        public final IndexedDB.ObjectStoreIndex[] indexes;
        
        /**
         * Constructor
         *
         * @param name Object store name.
         * 
         * @param keyPath Object store key path.
         * 
         * @param autoIncrement If true, object store has auto increment flag set.
         * 
         * @param indexes Indexes in this object store.
         */
        public ObjectStore(
                String name, IndexedDB.KeyPath keyPath, boolean autoIncrement, 
                IndexedDB.ObjectStoreIndex[] indexes
            )
        {
            // 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)    BRDPC.throwNPE("name");
            if (keyPath == null) BRDPC.throwNPE("keyPath");
            if (indexes == null) BRDPC.throwNPE("indexes");
            
            this.name           = name;
            this.keyPath        = keyPath;
            this.autoIncrement  = autoIncrement;
            this.indexes        = indexes;
        }
        
        /**
         * JSON Object Constructor
         * @param jo A Json-Object having data about an instance of {@code 'ObjectStore'}.
         */
        public ObjectStore (JsonObject jo)
        {
            this.name           = ReadJSON.getString(jo, "name", false, true);
            this.keyPath        = ReadJSON.getObject(jo, "keyPath", IndexedDB.KeyPath.class, false, true);
            this.autoIncrement  = ReadPrimJSON.getBoolean(jo, "autoIncrement");
            this.indexes = (jo.getJsonArray("indexes") == null)
                ? null
                : ReadArrJSON.DimN.objArr(jo.getJsonArray("indexes"), null, 0, IndexedDB.ObjectStoreIndex[].class);
        
        }
        
        
        /** Checks whether {@code 'this'} equals an input Java-{@code Object} */
        public boolean equals(Object other)
        {
            if (other == null)                       return false;
            if (other.getClass() != this.getClass()) return false;
        
            ObjectStore o = (ObjectStore) other;
        
            return
                    Objects.equals(this.name, o.name)
                &&  Objects.equals(this.keyPath, o.keyPath)
                &&  (this.autoIncrement == o.autoIncrement)
                &&  Arrays.deepEquals(this.indexes, o.indexes);
        }
        
        /** Generates a Hash-Code for {@code 'this'} instance */
        public int hashCode()
        {
            return
                    Objects.hashCode(this.name)
                +   this.keyPath.hashCode()
                +   (this.autoIncrement ? 1 : 0)
                +   Arrays.deepHashCode(this.indexes);
        }
    }
    
    /** Object store index. */
    public static class ObjectStoreIndex
        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, }; }
        
        /** Index name. */
        public final String name;
        
        /** Index key path. */
        public final IndexedDB.KeyPath keyPath;
        
        /** If true, index is unique. */
        public final boolean unique;
        
        /** If true, index allows multiple entries for a key. */
        public final boolean multiEntry;
        
        /**
         * Constructor
         *
         * @param name Index name.
         * 
         * @param keyPath Index key path.
         * 
         * @param unique If true, index is unique.
         * 
         * @param multiEntry If true, index allows multiple entries for a key.
         */
        public ObjectStoreIndex
            (String name, IndexedDB.KeyPath keyPath, boolean unique, boolean multiEntry)
        {
            // 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)    BRDPC.throwNPE("name");
            if (keyPath == null) BRDPC.throwNPE("keyPath");
            
            this.name        = name;
            this.keyPath     = keyPath;
            this.unique      = unique;
            this.multiEntry  = multiEntry;
        }
        
        /**
         * JSON Object Constructor
         * @param jo A Json-Object having data about an instance of {@code 'ObjectStoreIndex'}.
         */
        public ObjectStoreIndex (JsonObject jo)
        {
            this.name        = ReadJSON.getString(jo, "name", false, true);
            this.keyPath     = ReadJSON.getObject(jo, "keyPath", IndexedDB.KeyPath.class, false, true);
            this.unique      = ReadPrimJSON.getBoolean(jo, "unique");
            this.multiEntry  = ReadPrimJSON.getBoolean(jo, "multiEntry");
        }
        
        
        /** Checks whether {@code 'this'} equals an input Java-{@code Object} */
        public boolean equals(Object other)
        {
            if (other == null)                       return false;
            if (other.getClass() != this.getClass()) return false;
        
            ObjectStoreIndex o = (ObjectStoreIndex) other;
        
            return
                    Objects.equals(this.name, o.name)
                &&  Objects.equals(this.keyPath, o.keyPath)
                &&  (this.unique == o.unique)
                &&  (this.multiEntry == o.multiEntry);
        }
        
        /** Generates a Hash-Code for {@code 'this'} instance */
        public int hashCode()
        {
            return
                    Objects.hashCode(this.name)
                +   this.keyPath.hashCode()
                +   (this.unique ? 1 : 0)
                +   (this.multiEntry ? 1 : 0);
        }
    }
    
    /** Key. */
    public static class Key
        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, true, true, true, true, }; }
        
        /** Key type. */
        public final String type;
        
        /**
         * Number value.
         * <BR />
         * <BR /><B>OPTIONAL</B>
         */
        public final Number number;
        
        /**
         * String value.
         * <BR />
         * <BR /><B>OPTIONAL</B>
         */
        public final String string;
        
        /**
         * Date value.
         * <BR />
         * <BR /><B>OPTIONAL</B>
         */
        public final Number date;
        
        /**
         * Array value.
         * <BR />
         * <BR /><B>OPTIONAL</B>
         */
        public final IndexedDB.Key[] array;
        
        /**
         * Constructor
         *
         * @param type Key type.
         * <BR />Acceptable Values: ["number", "string", "date", "array"]
         * 
         * @param number Number value.
         * <BR /><B>OPTIONAL</B>
         * 
         * @param string String value.
         * <BR /><B>OPTIONAL</B>
         * 
         * @param date Date value.
         * <BR /><B>OPTIONAL</B>
         * 
         * @param array Array value.
         * <BR /><B>OPTIONAL</B>
         */
        public Key
            (String type, Number number, String string, Number date, IndexedDB.Key[] array)
        {
            // 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 (type == null) BRDPC.throwNPE("type");
            
            // Exception-Check(s) to ensure that if any parameters which must adhere to a
            // provided List of Enumerated Values, fails, then IllegalArgumentException shall throw.
            
            BRDPC.checkIAE(
                "type", type,
                "number", "string", "date", "array"
            );
            
            this.type    = type;
            this.number  = number;
            this.string  = string;
            this.date    = date;
            this.array   = array;
        }
        
        /**
         * JSON Object Constructor
         * @param jo A Json-Object having data about an instance of {@code 'Key'}.
         */
        public Key (JsonObject jo)
        {
            this.type    = ReadJSON.getString(jo, "type", false, true);
            this.number  = ReadNumberJSON.get(jo, "number", true, false);
            this.string  = ReadJSON.getString(jo, "string", true, false);
            this.date    = ReadNumberJSON.get(jo, "date", true, false);
            this.array = (jo.getJsonArray("array") == null)
                ? null
                : ReadArrJSON.DimN.objArr(jo.getJsonArray("array"), null, 0, IndexedDB.Key[].class);
        
        }
        
        
        /** Checks whether {@code 'this'} equals an input Java-{@code Object} */
        public boolean equals(Object other)
        {
            if (other == null)                       return false;
            if (other.getClass() != this.getClass()) return false;
        
            Key o = (Key) other;
        
            return
                    Objects.equals(this.type, o.type)
                &&  Objects.equals(this.number, o.number)
                &&  Objects.equals(this.string, o.string)
                &&  Objects.equals(this.date, o.date)
                &&  Arrays.deepEquals(this.array, o.array);
        }
        
        /** Generates a Hash-Code for {@code 'this'} instance */
        public int hashCode()
        {
            return
                    Objects.hashCode(this.type)
                +   Objects.hashCode(this.number)
                +   Objects.hashCode(this.string)
                +   Objects.hashCode(this.date)
                +   Arrays.deepHashCode(this.array);
        }
    }
    
    /** Key range. */
    public static class KeyRange
        extends BaseType
        implements java.io.Serializable
    {
        /** For Object Serialization.  java.io.Serializable */
        protected static final long serialVersionUID = 1;
        
        public boolean[] optionals()
        { return new boolean[] { true, true, false, false, }; }
        
        /**
         * Lower bound.
         * <BR />
         * <BR /><B>OPTIONAL</B>
         */
        public final IndexedDB.Key lower;
        
        /**
         * Upper bound.
         * <BR />
         * <BR /><B>OPTIONAL</B>
         */
        public final IndexedDB.Key upper;
        
        /** If true lower bound is open. */
        public final boolean lowerOpen;
        
        /** If true upper bound is open. */
        public final boolean upperOpen;
        
        /**
         * Constructor
         *
         * @param lower Lower bound.
         * <BR /><B>OPTIONAL</B>
         * 
         * @param upper Upper bound.
         * <BR /><B>OPTIONAL</B>
         * 
         * @param lowerOpen If true lower bound is open.
         * 
         * @param upperOpen If true upper bound is open.
         */
        public KeyRange
            (IndexedDB.Key lower, IndexedDB.Key upper, boolean lowerOpen, boolean upperOpen)
        {
            this.lower      = lower;
            this.upper      = upper;
            this.lowerOpen  = lowerOpen;
            this.upperOpen  = upperOpen;
        }
        
        /**
         * JSON Object Constructor
         * @param jo A Json-Object having data about an instance of {@code 'KeyRange'}.
         */
        public KeyRange (JsonObject jo)
        {
            this.lower      = ReadJSON.getObject(jo, "lower", IndexedDB.Key.class, true, false);
            this.upper      = ReadJSON.getObject(jo, "upper", IndexedDB.Key.class, true, false);
            this.lowerOpen  = ReadPrimJSON.getBoolean(jo, "lowerOpen");
            this.upperOpen  = ReadPrimJSON.getBoolean(jo, "upperOpen");
        }
        
        
        /** Checks whether {@code 'this'} equals an input Java-{@code Object} */
        public boolean equals(Object other)
        {
            if (other == null)                       return false;
            if (other.getClass() != this.getClass()) return false;
        
            KeyRange o = (KeyRange) other;
        
            return
                    Objects.equals(this.lower, o.lower)
                &&  Objects.equals(this.upper, o.upper)
                &&  (this.lowerOpen == o.lowerOpen)
                &&  (this.upperOpen == o.upperOpen);
        }
        
        /** Generates a Hash-Code for {@code 'this'} instance */
        public int hashCode()
        {
            return
                    this.lower.hashCode()
                +   this.upper.hashCode()
                +   (this.lowerOpen ? 1 : 0)
                +   (this.upperOpen ? 1 : 0);
        }
    }
    
    /** Data entry. */
    public static class DataEntry
        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, }; }
        
        /** Key object. */
        public final RunTime.RemoteObject key;
        
        /** Primary key object. */
        public final RunTime.RemoteObject primaryKey;
        
        /** Value object. */
        public final RunTime.RemoteObject value;
        
        /**
         * Constructor
         *
         * @param key Key object.
         * 
         * @param primaryKey Primary key object.
         * 
         * @param value Value object.
         */
        public DataEntry
            (RunTime.RemoteObject key, RunTime.RemoteObject primaryKey, RunTime.RemoteObject 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 (key == null)        BRDPC.throwNPE("key");
            if (primaryKey == null) BRDPC.throwNPE("primaryKey");
            if (value == null)      BRDPC.throwNPE("value");
            
            this.key         = key;
            this.primaryKey  = primaryKey;
            this.value       = value;
        }
        
        /**
         * JSON Object Constructor
         * @param jo A Json-Object having data about an instance of {@code 'DataEntry'}.
         */
        public DataEntry (JsonObject jo)
        {
            this.key         = ReadJSON.getObject(jo, "key", RunTime.RemoteObject.class, false, true);
            this.primaryKey  = ReadJSON.getObject(jo, "primaryKey", RunTime.RemoteObject.class, false, true);
            this.value       = ReadJSON.getObject(jo, "value", RunTime.RemoteObject.class, false, true);
        }
        
        
        /** Checks whether {@code 'this'} equals an input Java-{@code Object} */
        public boolean equals(Object other)
        {
            if (other == null)                       return false;
            if (other.getClass() != this.getClass()) return false;
        
            DataEntry o = (DataEntry) other;
        
            return
                    Objects.equals(this.key, o.key)
                &&  Objects.equals(this.primaryKey, o.primaryKey)
                &&  Objects.equals(this.value, o.value);
        }
        
        /** Generates a Hash-Code for {@code 'this'} instance */
        public int hashCode()
        {
            return
                    this.key.hashCode()
                +   this.primaryKey.hashCode()
                +   this.value.hashCode();
        }
    }
    
    /** Key path. */
    public static class KeyPath
        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, true, true, }; }
        
        /** Key path type. */
        public final String type;
        
        /**
         * String value.
         * <BR />
         * <BR /><B>OPTIONAL</B>
         */
        public final String string;
        
        /**
         * Array value.
         * <BR />
         * <BR /><B>OPTIONAL</B>
         */
        public final String[] array;
        
        /**
         * Constructor
         *
         * @param type Key path type.
         * <BR />Acceptable Values: ["null", "string", "array"]
         * 
         * @param string String value.
         * <BR /><B>OPTIONAL</B>
         * 
         * @param array Array value.
         * <BR /><B>OPTIONAL</B>
         */
        public KeyPath(String type, String string, String[] array)
        {
            // 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 (type == null) BRDPC.throwNPE("type");
            
            // Exception-Check(s) to ensure that if any parameters which must adhere to a
            // provided List of Enumerated Values, fails, then IllegalArgumentException shall throw.
            
            BRDPC.checkIAE(
                "type", type,
                "null", "string", "array"
            );
            
            this.type    = type;
            this.string  = string;
            this.array   = array;
        }
        
        /**
         * JSON Object Constructor
         * @param jo A Json-Object having data about an instance of {@code 'KeyPath'}.
         */
        public KeyPath (JsonObject jo)
        {
            this.type    = ReadJSON.getString(jo, "type", false, true);
            this.string  = ReadJSON.getString(jo, "string", true, false);
            this.array = (jo.getJsonArray("array") == null)
                ? null
                : ReadArrJSON.DimN.strArr(jo.getJsonArray("array"), null, 0, String[].class);
        
        }
        
        
        /** Checks whether {@code 'this'} equals an input Java-{@code Object} */
        public boolean equals(Object other)
        {
            if (other == null)                       return false;
            if (other.getClass() != this.getClass()) return false;
        
            KeyPath o = (KeyPath) other;
        
            return
                    Objects.equals(this.type, o.type)
                &&  Objects.equals(this.string, o.string)
                &&  Arrays.deepEquals(this.array, o.array);
        }
        
        /** Generates a Hash-Code for {@code 'this'} instance */
        public int hashCode()
        {
            return
                    Objects.hashCode(this.type)
                +   Objects.hashCode(this.string)
                +   Arrays.deepHashCode(this.array);
        }
    }
    
    
    // Counter for keeping the WebSocket Request ID's distinct.
    private static int counter = 1;
    
    /**
     * Clears all entries from an object store.
     * 
     * @param securityOrigin Security origin.
     * 
     * @param databaseName Database name.
     * 
     * @param objectStoreName Object store name.
     * 
     * @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> clearObjectStore
        (String securityOrigin, String databaseName, String objectStoreName)
    {
        // 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 (securityOrigin == null)  BRDPC.throwNPE("securityOrigin");
        if (databaseName == null)    BRDPC.throwNPE("databaseName");
        if (objectStoreName == null) BRDPC.throwNPE("objectStoreName");
        
        final int       webSocketID = 24000000 + counter++;
        final boolean[] optionals   = { false, false, false, };
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("clearObjectStore"),
            parameterNames.get("clearObjectStore"),
            optionals, webSocketID,
            "IndexedDB.clearObjectStore",
            securityOrigin, databaseName, objectStoreName
        );
        
        // This Remote Command does not have a Return-Value.
        return new Script<>
            (BRDPC.defaultSender, webSocketID, requestJSON, BRDPC.NoReturnValues);
    }
    
    /**
     * Deletes a database.
     * 
     * @param securityOrigin Security origin.
     * 
     * @param databaseName Database name.
     * 
     * @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> deleteDatabase
        (String securityOrigin, String databaseName)
    {
        // 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 (securityOrigin == null) BRDPC.throwNPE("securityOrigin");
        if (databaseName == null)   BRDPC.throwNPE("databaseName");
        
        final int       webSocketID = 24001000 + counter++;
        final boolean[] optionals   = { false, false, };
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("deleteDatabase"),
            parameterNames.get("deleteDatabase"),
            optionals, webSocketID,
            "IndexedDB.deleteDatabase",
            securityOrigin, databaseName
        );
        
        // This Remote Command does not have a Return-Value.
        return new Script<>
            (BRDPC.defaultSender, webSocketID, requestJSON, BRDPC.NoReturnValues);
    }
    
    /**
     * Delete a range of entries from an object store
     * 
     * @param securityOrigin -
     * 
     * @param databaseName -
     * 
     * @param objectStoreName -
     * 
     * @param keyRange Range of entry keys to delete
     * 
     * @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> deleteObjectStoreEntries(
            String securityOrigin, String databaseName, String objectStoreName, 
            IndexedDB.KeyRange keyRange
        )
    {
        // 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 (securityOrigin == null)  BRDPC.throwNPE("securityOrigin");
        if (databaseName == null)    BRDPC.throwNPE("databaseName");
        if (objectStoreName == null) BRDPC.throwNPE("objectStoreName");
        if (keyRange == null)        BRDPC.throwNPE("keyRange");
        
        final int       webSocketID = 24002000 + counter++;
        final boolean[] optionals   = { false, false, false, false, };
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("deleteObjectStoreEntries"),
            parameterNames.get("deleteObjectStoreEntries"),
            optionals, webSocketID,
            "IndexedDB.deleteObjectStoreEntries",
            securityOrigin, databaseName, objectStoreName, keyRange
        );
        
        // This Remote Command does not have a Return-Value.
        return new Script<>
            (BRDPC.defaultSender, webSocketID, requestJSON, BRDPC.NoReturnValues);
    }
    
    /**
     * Disables events from backend.
     * 
     * @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 = 24003000 + 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,
            "IndexedDB.disable"
        );
        
        // This Remote Command does not have a Return-Value.
        return new Script<>
            (BRDPC.defaultSender, webSocketID, requestJSON, BRDPC.NoReturnValues);
    }
    
    /**
     * Enables events from backend.
     * 
     * @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 = 24004000 + 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,
            "IndexedDB.enable"
        );
        
        // This Remote Command does not have a Return-Value.
        return new Script<>
            (BRDPC.defaultSender, webSocketID, requestJSON, BRDPC.NoReturnValues);
    }
    
    /**
     * Requests data from object store or index.
     * 
     * @param securityOrigin Security origin.
     * 
     * @param databaseName Database name.
     * 
     * @param objectStoreName Object store name.
     * 
     * @param indexName Index name, empty string for object store data requests.
     * 
     * @param skipCount Number of records to skip.
     * 
     * @param pageSize Number of records to fetch.
     * 
     * @param keyRange Key range.
     * <BR /><B>OPTIONAL</B>
     * 
     * @return An instance of <CODE>{@link Script}&lt;String, {@link JsonObject},
     * {@link Ret2}&gt;</CODE>
     *
     * <BR /><BR />This {@link Script} may be <B STYLE='color:red'>executed</B> (using 
     * {@link Script#exec()}), and a {@link Promise} returned.
     *
     * <BR /><BR />When the {@code Promise} is <B STYLE='color: red'>awaited</B>
     * (using {@link Promise#await()}), the {@code Ret2} will subsequently
     * be returned from that call.
     * 
     * <BR /><BR />The <B STYLE='color: red'>returned</B> values are encapsulated
     * in an instance of <B>{@link Ret2}</B>
     *
     * <BR /><BR /><UL CLASS=JDUL>
     * <LI><CODE><B>Ret2.a:</B> {@link IndexedDB.DataEntry}[] (<B>objectStoreDataEntries</B>)</CODE>
     *     <BR />Array of object store data entries.
     *     <BR /><BR /></LI>
     * <LI><CODE><B>Ret2.b:</B> Boolean (<B>hasMore</B>)</CODE>
     *     <BR />If true, there are more entries to fetch in the given range.
     *     </LI>
     * </UL>
     */
    public static Script<String, JsonObject, Ret2<IndexedDB.DataEntry[], Boolean>> requestData(
            String securityOrigin, String databaseName, String objectStoreName, String indexName, 
            int skipCount, int pageSize, IndexedDB.KeyRange keyRange
        )
    {
        // 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 (securityOrigin == null)  BRDPC.throwNPE("securityOrigin");
        if (databaseName == null)    BRDPC.throwNPE("databaseName");
        if (objectStoreName == null) BRDPC.throwNPE("objectStoreName");
        if (indexName == null)       BRDPC.throwNPE("indexName");
        
        final int       webSocketID = 24005000 + counter++;
        final boolean[] optionals   = { false, false, false, false, false, false, true, };
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("requestData"),
            parameterNames.get("requestData"),
            optionals, webSocketID,
            "IndexedDB.requestData",
            securityOrigin, databaseName, objectStoreName, indexName, skipCount, pageSize, keyRange
        );
        
        // 'JSON Binding' ... Converts Browser Response-JSON into Java-Type 'Ret2'
        Function<JsonObject, Ret2<IndexedDB.DataEntry[], Boolean>> 
            responseProcessor = (JsonObject jo) -> new Ret2<>(
                (jo.getJsonArray("objectStoreDataEntries") == null)
                    ? null
                    : ReadArrJSON.DimN.objArr(jo.getJsonArray("objectStoreDataEntries"), null, 0, IndexedDB.DataEntry[].class),
                ReadBoxedJSON.getBoolean(jo, "hasMore", true)
            );
        
        // Pass the 'defaultSender' to Script-Constructor
        // The sender that is used can be changed before executing script.
        return new Script<>(BRDPC.defaultSender, webSocketID, requestJSON, responseProcessor);
    }
    
    /**
     * Gets metadata of an object store
     * 
     * @param securityOrigin Security origin.
     * 
     * @param databaseName Database name.
     * 
     * @param objectStoreName Object store name.
     * 
     * @return An instance of <CODE>{@link Script}&lt;String, {@link JsonObject},
     * {@link Ret2}&gt;</CODE>
     *
     * <BR /><BR />This {@link Script} may be <B STYLE='color:red'>executed</B> (using 
     * {@link Script#exec()}), and a {@link Promise} returned.
     *
     * <BR /><BR />When the {@code Promise} is <B STYLE='color: red'>awaited</B>
     * (using {@link Promise#await()}), the {@code Ret2} will subsequently
     * be returned from that call.
     * 
     * <BR /><BR />The <B STYLE='color: red'>returned</B> values are encapsulated
     * in an instance of <B>{@link Ret2}</B>
     *
     * <BR /><BR /><UL CLASS=JDUL>
     * <LI><CODE><B>Ret2.a:</B> Number (<B>entriesCount</B>)</CODE>
     *     <BR />the entries count
     *     <BR /><BR /></LI>
     * <LI><CODE><B>Ret2.b:</B> Number (<B>keyGeneratorValue</B>)</CODE>
     *     <BR />the current value of key generator, to become the next inserted
     *     key into the object store. Valid if objectStore.autoIncrement
     *     is true.
     *     </LI>
     * </UL>
     */
    public static Script<String, JsonObject, Ret2<Number, Number>> getMetadata
        (String securityOrigin, String databaseName, String objectStoreName)
    {
        // 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 (securityOrigin == null)  BRDPC.throwNPE("securityOrigin");
        if (databaseName == null)    BRDPC.throwNPE("databaseName");
        if (objectStoreName == null) BRDPC.throwNPE("objectStoreName");
        
        final int       webSocketID = 24006000 + counter++;
        final boolean[] optionals   = { false, false, false, };
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("getMetadata"),
            parameterNames.get("getMetadata"),
            optionals, webSocketID,
            "IndexedDB.getMetadata",
            securityOrigin, databaseName, objectStoreName
        );
        
        // 'JSON Binding' ... Converts Browser Response-JSON into Java-Type 'Ret2'
        Function<JsonObject, Ret2<Number, Number>> 
            responseProcessor = (JsonObject jo) -> new Ret2<>(
                ReadNumberJSON.get(jo, "entriesCount", false, true),
                ReadNumberJSON.get(jo, "keyGeneratorValue", false, true)
            );
        
        // Pass the 'defaultSender' to Script-Constructor
        // The sender that is used can be changed before executing script.
        return new Script<>(BRDPC.defaultSender, webSocketID, requestJSON, responseProcessor);
    }
    
    /**
     * Requests database with given name in given frame.
     * 
     * @param securityOrigin Security origin.
     * 
     * @param databaseName Database name.
     * 
     * @return An instance of <CODE>{@link Script}&lt;String, {@link JsonObject},
     * {@link IndexedDB.DatabaseWithObjectStores}&gt;</CODE>
     * 
     * <BR /><BR />This <B>script</B> may be <B STYLE='color: red'>executed</B>, using
     * {@link Script#exec()}, and afterwards, a {@link Promise}<CODE>&lt;JsonObject,
     * {@link IndexedDB.DatabaseWithObjectStores}&gt;</CODE> will be returned.
     *
     * <BR /><BR />Finally, the <B>{@code Promise}</B> may be <B STYLE='color: red'>awaited</B>,
     * using {@link Promise#await()}, <I>and the returned result of this Browser Function may
      * may be retrieved.</I>
     *
     * <BR /><BR />This Browser Function <B STYLE='color: red'>returns</B>
     * <BR /><BR /><UL CLASS=JDUL>
     * <LI><CODE>{@link IndexedDB.DatabaseWithObjectStores} (<B>databaseWithObjectStores</B></CODE>)
     *     <BR />Database with an array of object stores.
     * </LI>
     * </UL> */
    public static Script<String, JsonObject, IndexedDB.DatabaseWithObjectStores> requestDatabase
        (String securityOrigin, String databaseName)
    {
        // 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 (securityOrigin == null) BRDPC.throwNPE("securityOrigin");
        if (databaseName == null)   BRDPC.throwNPE("databaseName");
        
        final int       webSocketID = 24007000 + counter++;
        final boolean[] optionals   = { false, false, };
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("requestDatabase"),
            parameterNames.get("requestDatabase"),
            optionals, webSocketID,
            "IndexedDB.requestDatabase",
            securityOrigin, databaseName
        );
        
        // 'JSON Binding' ... Converts Browser Response-JSON to 'IndexedDB.DatabaseWithObjectStores'
        Function<JsonObject, IndexedDB.DatabaseWithObjectStores> responseProcessor = (JsonObject jo) ->
            ReadJSON.getObject(jo, "databaseWithObjectStores", IndexedDB.DatabaseWithObjectStores.class, false, true);
        
        // Pass the 'defaultSender' to Script-Constructor
        // The sender that is used can be changed before executing script.
        return new Script<>(BRDPC.defaultSender, webSocketID, requestJSON, responseProcessor);
    }
    
    /**
     * Requests database names for given security origin.
     * 
     * @param securityOrigin Security origin.
     * 
     * @return An instance of <CODE>{@link Script}&lt;String, {@link JsonObject},
     * String[]&gt;</CODE>
     * 
     * <BR /><BR />This <B>script</B> may be <B STYLE='color: red'>executed</B>, using
     * {@link Script#exec()}, and afterwards, a {@link Promise}<CODE>&lt;JsonObject,
     * String[]&gt;</CODE> will be returned.
     *
     * <BR /><BR />Finally, the <B>{@code Promise}</B> may be <B STYLE='color: red'>awaited</B>,
     * using {@link Promise#await()}, <I>and the returned result of this Browser Function may
      * may be retrieved.</I>
     *
     * <BR /><BR />This Browser Function <B STYLE='color: red'>returns</B>
     * <BR /><BR /><UL CLASS=JDUL>
     * <LI><CODE>String[] (<B>databaseNames</B></CODE>)
     *     <BR />Database names for origin.
     * </LI>
     * </UL> */
    public static Script<String, JsonObject, String[]> requestDatabaseNames
        (String securityOrigin)
    {
        // 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 (securityOrigin == null) BRDPC.throwNPE("securityOrigin");
        
        final int       webSocketID = 24008000 + counter++;
        final boolean[] optionals   = { false, };
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("requestDatabaseNames"),
            parameterNames.get("requestDatabaseNames"),
            optionals, webSocketID,
            "IndexedDB.requestDatabaseNames",
            securityOrigin
        );
        
        // 'JSON Binding' ... Converts Browser Response-JSON to 'String[]'
        Function<JsonObject, String[]> responseProcessor = (JsonObject jo) ->
            (jo.getJsonArray("databaseNames") == null)
                ? null
                : ReadArrJSON.DimN.strArr(jo.getJsonArray("databaseNames"), null, 0, String[].class);
        
        // Pass the 'defaultSender' to Script-Constructor
        // The sender that is used can be changed before executing script.
        return new Script<>(BRDPC.defaultSender, webSocketID, requestJSON, responseProcessor);
    }
    
}