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 Storage
{
    // ********************************************************************************************
    // ********************************************************************************************
    // Class Header Stuff
    // ********************************************************************************************
    // ********************************************************************************************


    // No Pubic Constructors
    private Storage () { }

    // 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 : Storage.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>(2);
        parameterNames.put("clearDataForOrigin", v);
        Collections.addAll(v, new String[]
        { "origin", "storageTypes", });

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

        v = new Vector<String>(2);
        parameterNames.put("setCookies", v);
        Collections.addAll(v, new String[]
        { "cookies", "browserContextId", });

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

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

        v = new Vector<String>(2);
        parameterNames.put("overrideQuotaForOrigin", v);
        Collections.addAll(v, new String[]
        { "origin", "quotaSize", });

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

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

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

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

        parameterNames.put("getTrustTokens", EMPTY_VEC_STR);

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


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

    /** Enum of possible storage types. */
    public static final String[] StorageType =
    { 
        "appcache", "cookies", "file_systems", "indexeddb", "local_storage", "shader_cache", 
        "websql", "service_workers", "cache_storage", "all", "other", 
    };
    
    /** Usage for a storage type. */
    public static class UsageForType
        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, }; }
        
        /** Name of storage type. */
        public final String storageType;
        
        /** Storage usage (bytes). */
        public final Number usage;
        
        /**
         * Constructor
         *
         * @param storageType Name of storage type.
         * 
         * @param usage Storage usage (bytes).
         */
        public UsageForType(String storageType, Number usage)
        {
            // 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 (storageType == null) BRDPC.throwNPE("storageType");
            if (usage == null)       BRDPC.throwNPE("usage");
            
            // 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("storageType", storageType, "Storage.StorageType", Storage.StorageType);
            
            this.storageType  = storageType;
            this.usage        = usage;
        }
        
        /**
         * JSON Object Constructor
         * @param jo A Json-Object having data about an instance of {@code 'UsageForType'}.
         */
        public UsageForType (JsonObject jo)
        {
            this.storageType  = ReadJSON.getString(jo, "storageType", false, true);
            this.usage        = ReadNumberJSON.get(jo, "usage", 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;
        
            UsageForType o = (UsageForType) other;
        
            return
                    Objects.equals(this.storageType, o.storageType)
                &&  Objects.equals(this.usage, o.usage);
        }
        
        /** Generates a Hash-Code for {@code 'this'} instance */
        public int hashCode()
        {
            return
                    Objects.hashCode(this.storageType)
                +   Objects.hashCode(this.usage);
        }
    }
    
    /**
     * Pair of issuer origin and number of available (signed, but not used) Trust
     * Tokens from that issuer.
     * <BR />
     * <BR /><B>EXPERIMENTAL</B>
     */
    public static class TrustTokens
        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, }; }
        
        /** <CODE>[No Description Provided by Google]</CODE> */
        public final String issuerOrigin;
        
        /** <CODE>[No Description Provided by Google]</CODE> */
        public final Number count;
        
        /**
         * Constructor
         *
         * @param issuerOrigin -
         * 
         * @param count -
         */
        public TrustTokens(String issuerOrigin, Number count)
        {
            // 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 (issuerOrigin == null) BRDPC.throwNPE("issuerOrigin");
            if (count == null)        BRDPC.throwNPE("count");
            
            this.issuerOrigin  = issuerOrigin;
            this.count         = count;
        }
        
        /**
         * JSON Object Constructor
         * @param jo A Json-Object having data about an instance of {@code 'TrustTokens'}.
         */
        public TrustTokens (JsonObject jo)
        {
            this.issuerOrigin  = ReadJSON.getString(jo, "issuerOrigin", false, true);
            this.count         = ReadNumberJSON.get(jo, "count", 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;
        
            TrustTokens o = (TrustTokens) other;
        
            return
                    Objects.equals(this.issuerOrigin, o.issuerOrigin)
                &&  Objects.equals(this.count, o.count);
        }
        
        /** Generates a Hash-Code for {@code 'this'} instance */
        public int hashCode()
        {
            return
                    Objects.hashCode(this.issuerOrigin)
                +   Objects.hashCode(this.count);
        }
    }
    
    /** A cache's contents have been modified. */
    public static class cacheStorageContentUpdated
        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, }; }
        
        /** Origin to update. */
        public final String origin;
        
        /** Name of cache in origin. */
        public final String cacheName;
        
        /**
         * Constructor
         *
         * @param origin Origin to update.
         * 
         * @param cacheName Name of cache in origin.
         */
        public cacheStorageContentUpdated(String origin, String cacheName)
        {
            super("Storage", "cacheStorageContentUpdated", 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 (origin == null)    BRDPC.throwNPE("origin");
            if (cacheName == null) BRDPC.throwNPE("cacheName");
            
            this.origin     = origin;
            this.cacheName  = cacheName;
        }
        
        /**
         * JSON Object Constructor
         * @param jo A Json-Object having data about an instance of {@code 'cacheStorageContentUpdated'}.
         */
        public cacheStorageContentUpdated (JsonObject jo)
        {
            super("Storage", "cacheStorageContentUpdated", 2);
        
            this.origin     = ReadJSON.getString(jo, "origin", false, true);
            this.cacheName  = ReadJSON.getString(jo, "cacheName", 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;
        
            cacheStorageContentUpdated o = (cacheStorageContentUpdated) other;
        
            return
                    Objects.equals(this.origin, o.origin)
                &&  Objects.equals(this.cacheName, o.cacheName);
        }
        
        /** Generates a Hash-Code for {@code 'this'} instance */
        public int hashCode()
        {
            return
                    Objects.hashCode(this.origin)
                +   Objects.hashCode(this.cacheName);
        }
    }
    
    /** A cache has been added/deleted. */
    public static class cacheStorageListUpdated
        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, }; }
        
        /** Origin to update. */
        public final String origin;
        
        /**
         * Constructor
         *
         * @param origin Origin to update.
         */
        public cacheStorageListUpdated(String origin)
        {
            super("Storage", "cacheStorageListUpdated", 1);
            
            // 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 (origin == null) BRDPC.throwNPE("origin");
            
            this.origin  = origin;
        }
        
        /**
         * JSON Object Constructor
         * @param jo A Json-Object having data about an instance of {@code 'cacheStorageListUpdated'}.
         */
        public cacheStorageListUpdated (JsonObject jo)
        {
            super("Storage", "cacheStorageListUpdated", 1);
        
            this.origin  = ReadJSON.getString(jo, "origin", 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;
        
            cacheStorageListUpdated o = (cacheStorageListUpdated) other;
        
            return
                    Objects.equals(this.origin, o.origin);
        }
        
        /** Generates a Hash-Code for {@code 'this'} instance */
        public int hashCode()
        {
            return
                    Objects.hashCode(this.origin);
        }
    }
    
    /** The origin's IndexedDB object store has been modified. */
    public static class indexedDBContentUpdated
        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, false, }; }
        
        /** Origin to update. */
        public final String origin;
        
        /** Database to update. */
        public final String databaseName;
        
        /** ObjectStore to update. */
        public final String objectStoreName;
        
        /**
         * Constructor
         *
         * @param origin Origin to update.
         * 
         * @param databaseName Database to update.
         * 
         * @param objectStoreName ObjectStore to update.
         */
        public indexedDBContentUpdated
            (String origin, String databaseName, String objectStoreName)
        {
            super("Storage", "indexedDBContentUpdated", 3);
            
            // 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 (origin == null)          BRDPC.throwNPE("origin");
            if (databaseName == null)    BRDPC.throwNPE("databaseName");
            if (objectStoreName == null) BRDPC.throwNPE("objectStoreName");
            
            this.origin           = origin;
            this.databaseName     = databaseName;
            this.objectStoreName  = objectStoreName;
        }
        
        /**
         * JSON Object Constructor
         * @param jo A Json-Object having data about an instance of {@code 'indexedDBContentUpdated'}.
         */
        public indexedDBContentUpdated (JsonObject jo)
        {
            super("Storage", "indexedDBContentUpdated", 3);
        
            this.origin           = ReadJSON.getString(jo, "origin", false, true);
            this.databaseName     = ReadJSON.getString(jo, "databaseName", false, true);
            this.objectStoreName  = ReadJSON.getString(jo, "objectStoreName", 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;
        
            indexedDBContentUpdated o = (indexedDBContentUpdated) other;
        
            return
                    Objects.equals(this.origin, o.origin)
                &&  Objects.equals(this.databaseName, o.databaseName)
                &&  Objects.equals(this.objectStoreName, o.objectStoreName);
        }
        
        /** Generates a Hash-Code for {@code 'this'} instance */
        public int hashCode()
        {
            return
                    Objects.hashCode(this.origin)
                +   Objects.hashCode(this.databaseName)
                +   Objects.hashCode(this.objectStoreName);
        }
    }
    
    /** The origin's IndexedDB database list has been modified. */
    public static class indexedDBListUpdated
        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, }; }
        
        /** Origin to update. */
        public final String origin;
        
        /**
         * Constructor
         *
         * @param origin Origin to update.
         */
        public indexedDBListUpdated(String origin)
        {
            super("Storage", "indexedDBListUpdated", 1);
            
            // 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 (origin == null) BRDPC.throwNPE("origin");
            
            this.origin  = origin;
        }
        
        /**
         * JSON Object Constructor
         * @param jo A Json-Object having data about an instance of {@code 'indexedDBListUpdated'}.
         */
        public indexedDBListUpdated (JsonObject jo)
        {
            super("Storage", "indexedDBListUpdated", 1);
        
            this.origin  = ReadJSON.getString(jo, "origin", 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;
        
            indexedDBListUpdated o = (indexedDBListUpdated) other;
        
            return
                    Objects.equals(this.origin, o.origin);
        }
        
        /** Generates a Hash-Code for {@code 'this'} instance */
        public int hashCode()
        {
            return
                    Objects.hashCode(this.origin);
        }
    }
    
    
    // Counter for keeping the WebSocket Request ID's distinct.
    private static int counter = 1;
    
    /**
     * Clears storage for origin.
     * 
     * @param origin Security origin.
     * 
     * @param storageTypes Comma separated list of StorageType to clear.
     * 
     * @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> clearDataForOrigin
        (String origin, String storageTypes)
    {
        // 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 (origin == null)       BRDPC.throwNPE("origin");
        if (storageTypes == null) BRDPC.throwNPE("storageTypes");
        
        final int       webSocketID = 37000000 + 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("clearDataForOrigin"),
            parameterNames.get("clearDataForOrigin"),
            optionals, webSocketID,
            "Storage.clearDataForOrigin",
            origin, storageTypes
        );
        
        // This Remote Command does not have a Return-Value.
        return new Script<>
            (BRDPC.defaultSender, webSocketID, requestJSON, BRDPC.NoReturnValues);
    }
    
    /**
     * Returns all browser cookies.
     * 
     * @param browserContextId Browser context to use when called on the browser endpoint.
     * <BR /><B>OPTIONAL</B>
     * 
     * @return An instance of <CODE>{@link Script}&lt;String, {@link JsonObject},
     * {@link Network.Cookie}[]&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 Network.Cookie}[]&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 Network.Cookie}[] (<B>cookies</B></CODE>)
     *     <BR />Array of cookie objects.
     * </LI>
     * </UL> */
    public static Script<String, JsonObject, Network.Cookie[]> getCookies
        (String browserContextId)
    {
        final int       webSocketID = 37001000 + counter++;
        final boolean[] optionals   = { true, };
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("getCookies"),
            parameterNames.get("getCookies"),
            optionals, webSocketID,
            "Storage.getCookies",
            browserContextId
        );
        
        // 'JSON Binding' ... Converts Browser Response-JSON to 'Network.Cookie[]'
        Function<JsonObject, Network.Cookie[]> responseProcessor = (JsonObject jo) ->
            (jo.getJsonArray("cookies") == null)
                ? null
                : RJArrDimN.objArr(jo.getJsonArray("cookies"), null, 0, Network.Cookie[].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);
    }
    
    /**
     * Sets given cookies.
     * 
     * @param cookies Cookies to be set.
     * 
     * @param browserContextId Browser context to use when called on the browser endpoint.
     * <BR /><B>OPTIONAL</B>
     * 
     * @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> setCookies
        (Network.CookieParam[] cookies, String browserContextId)
    {
        // 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 (cookies == null) BRDPC.throwNPE("cookies");
        
        final int       webSocketID = 37002000 + counter++;
        final boolean[] optionals   = { false, true, };
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("setCookies"),
            parameterNames.get("setCookies"),
            optionals, webSocketID,
            "Storage.setCookies",
            cookies, browserContextId
        );
        
        // This Remote Command does not have a Return-Value.
        return new Script<>
            (BRDPC.defaultSender, webSocketID, requestJSON, BRDPC.NoReturnValues);
    }
    
    /**
     * Clears cookies.
     * 
     * @param browserContextId Browser context to use when called on the browser endpoint.
     * <BR /><B>OPTIONAL</B>
     * 
     * @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> clearCookies(String browserContextId)
    {
        final int       webSocketID = 37003000 + counter++;
        final boolean[] optionals   = { true, };
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("clearCookies"),
            parameterNames.get("clearCookies"),
            optionals, webSocketID,
            "Storage.clearCookies",
            browserContextId
        );
        
        // This Remote Command does not have a Return-Value.
        return new Script<>
            (BRDPC.defaultSender, webSocketID, requestJSON, BRDPC.NoReturnValues);
    }
    
    /**
     * Returns usage and quota in bytes.
     * 
     * @param origin Security origin.
     * 
     * @return An instance of <CODE>{@link Script}&lt;String, {@link JsonObject},
     * {@link Ret4}&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 Ret4} 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 Ret4}</B>
     *
     * <BR /><BR /><UL CLASS=JDUL>
     * <LI><CODE><B>Ret4.a:</B> Number (<B>usage</B>)</CODE>
     *     <BR />Storage usage (bytes).
     *     <BR /><BR /></LI>
     * <LI><CODE><B>Ret4.b:</B> Number (<B>quota</B>)</CODE>
     *     <BR />Storage quota (bytes).
     *     <BR /><BR /></LI>
     * <LI><CODE><B>Ret4.c:</B> Boolean (<B>overrideActive</B>)</CODE>
     *     <BR />Whether or not the origin has an active storage quota override
     *     <BR /><BR /></LI>
     * <LI><CODE><B>Ret4.d:</B> {@link Storage.UsageForType}[] (<B>usageBreakdown</B>)</CODE>
     *     <BR />Storage usage per type (bytes).
     *     </LI>
     * </UL>
     */
    public static Script<String, JsonObject, Ret4<Number, Number, Boolean, Storage.UsageForType[]>> getUsageAndQuota
        (String origin)
    {
        // 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 (origin == null) BRDPC.throwNPE("origin");
        
        final int       webSocketID = 37004000 + counter++;
        final boolean[] optionals   = { false, };
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("getUsageAndQuota"),
            parameterNames.get("getUsageAndQuota"),
            optionals, webSocketID,
            "Storage.getUsageAndQuota",
            origin
        );
        
        // 'JSON Binding' ... Converts Browser Response-JSON into Java-Type 'Ret4'
        Function<JsonObject, Ret4<Number, Number, Boolean, Storage.UsageForType[]>> 
            responseProcessor = (JsonObject jo) -> new Ret4<>(
                ReadNumberJSON.get(jo, "usage", false, true),
                ReadNumberJSON.get(jo, "quota", false, true),
                ReadBoxedJSON.getBoolean(jo, "overrideActive", true),
                (jo.getJsonArray("usageBreakdown") == null)
                    ? null
                    : RJArrDimN.objArr(jo.getJsonArray("usageBreakdown"), null, 0, Storage.UsageForType[].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);
    }
    
    /**
     * Override quota for the specified origin
     * <BR /><B>EXPERIMENTAL</B>
     * 
     * @param origin Security origin.
     * 
     * @param quotaSize 
     * The quota size (in bytes) to override the original quota with.
     * If this is called multiple times, the overridden quota will be equal to
     * the quotaSize provided in the final call. If this is called without
     * specifying a quotaSize, the quota will be reset to the default value for
     * the specified origin. If this is called multiple times with different
     * origins, the override will be maintained for each origin until it is
     * disabled (called without a quotaSize).
     * <BR /><B>OPTIONAL</B>
     * 
     * @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> overrideQuotaForOrigin
        (String origin, Number quotaSize)
    {
        // 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 (origin == null) BRDPC.throwNPE("origin");
        
        final int       webSocketID = 37005000 + counter++;
        final boolean[] optionals   = { false, true, };
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("overrideQuotaForOrigin"),
            parameterNames.get("overrideQuotaForOrigin"),
            optionals, webSocketID,
            "Storage.overrideQuotaForOrigin",
            origin, quotaSize
        );
        
        // This Remote Command does not have a Return-Value.
        return new Script<>
            (BRDPC.defaultSender, webSocketID, requestJSON, BRDPC.NoReturnValues);
    }
    
    /**
     * Registers origin to be notified when an update occurs to its cache storage list.
     * 
     * @param origin Security origin.
     * 
     * @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> trackCacheStorageForOrigin(String origin)
    {
        // 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 (origin == null) BRDPC.throwNPE("origin");
        
        final int       webSocketID = 37006000 + counter++;
        final boolean[] optionals   = { false, };
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("trackCacheStorageForOrigin"),
            parameterNames.get("trackCacheStorageForOrigin"),
            optionals, webSocketID,
            "Storage.trackCacheStorageForOrigin",
            origin
        );
        
        // This Remote Command does not have a Return-Value.
        return new Script<>
            (BRDPC.defaultSender, webSocketID, requestJSON, BRDPC.NoReturnValues);
    }
    
    /**
     * Registers origin to be notified when an update occurs to its IndexedDB.
     * 
     * @param origin Security origin.
     * 
     * @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> trackIndexedDBForOrigin(String origin)
    {
        // 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 (origin == null) BRDPC.throwNPE("origin");
        
        final int       webSocketID = 37007000 + counter++;
        final boolean[] optionals   = { false, };
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("trackIndexedDBForOrigin"),
            parameterNames.get("trackIndexedDBForOrigin"),
            optionals, webSocketID,
            "Storage.trackIndexedDBForOrigin",
            origin
        );
        
        // This Remote Command does not have a Return-Value.
        return new Script<>
            (BRDPC.defaultSender, webSocketID, requestJSON, BRDPC.NoReturnValues);
    }
    
    /**
     * Unregisters origin from receiving notifications for cache storage.
     * 
     * @param origin Security origin.
     * 
     * @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> untrackCacheStorageForOrigin(String origin)
    {
        // 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 (origin == null) BRDPC.throwNPE("origin");
        
        final int       webSocketID = 37008000 + counter++;
        final boolean[] optionals   = { false, };
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("untrackCacheStorageForOrigin"),
            parameterNames.get("untrackCacheStorageForOrigin"),
            optionals, webSocketID,
            "Storage.untrackCacheStorageForOrigin",
            origin
        );
        
        // This Remote Command does not have a Return-Value.
        return new Script<>
            (BRDPC.defaultSender, webSocketID, requestJSON, BRDPC.NoReturnValues);
    }
    
    /**
     * Unregisters origin from receiving notifications for IndexedDB.
     * 
     * @param origin Security origin.
     * 
     * @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> untrackIndexedDBForOrigin(String origin)
    {
        // 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 (origin == null) BRDPC.throwNPE("origin");
        
        final int       webSocketID = 37009000 + counter++;
        final boolean[] optionals   = { false, };
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("untrackIndexedDBForOrigin"),
            parameterNames.get("untrackIndexedDBForOrigin"),
            optionals, webSocketID,
            "Storage.untrackIndexedDBForOrigin",
            origin
        );
        
        // This Remote Command does not have a Return-Value.
        return new Script<>
            (BRDPC.defaultSender, webSocketID, requestJSON, BRDPC.NoReturnValues);
    }
    
    /**
     * Returns the number of stored Trust Tokens per issuer for the
     * current browsing context.
     * <BR /><B>EXPERIMENTAL</B>
     * 
     * @return An instance of <CODE>{@link Script}&lt;String, {@link JsonObject},
     * {@link Storage.TrustTokens}[]&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 Storage.TrustTokens}[]&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 Storage.TrustTokens}[] (<B>tokens</B></CODE>)
     *     <BR />-
     * </LI>
     * </UL> */
    public static Script<String, JsonObject, Storage.TrustTokens[]> getTrustTokens()
    {
        final int          webSocketID = 37010000 + 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("getTrustTokens"),
            parameterNames.get("getTrustTokens"),
            optionals, webSocketID,
            "Storage.getTrustTokens"
        );
        
        // 'JSON Binding' ... Converts Browser Response-JSON to 'Storage.TrustTokens[]'
        Function<JsonObject, Storage.TrustTokens[]> responseProcessor = (JsonObject jo) ->
            (jo.getJsonArray("tokens") == null)
                ? null
                : RJArrDimN.objArr(jo.getJsonArray("tokens"), null, 0, Storage.TrustTokens[].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);
    }
    
    /**
     * Removes all Trust Tokens issued by the provided issuerOrigin.
     * Leaves other stored data, including the issuer's Redemption Records, intact.
     * <BR /><B>EXPERIMENTAL</B>
     * 
     * @param issuerOrigin -
     * 
     * @return An instance of <CODE>{@link Script}&lt;String, {@link JsonObject},
     * Boolean&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,
     * Boolean&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>Boolean (<B>didDeleteTokens</B></CODE>)
     *     <BR />True if any tokens were deleted, false otherwise.
     * </LI>
     * </UL> */
    public static Script<String, JsonObject, Boolean> clearTrustTokens(String issuerOrigin)
    {
        // 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 (issuerOrigin == null) BRDPC.throwNPE("issuerOrigin");
        
        final int       webSocketID = 37011000 + counter++;
        final boolean[] optionals   = { false, };
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("clearTrustTokens"),
            parameterNames.get("clearTrustTokens"),
            optionals, webSocketID,
            "Storage.clearTrustTokens",
            issuerOrigin
        );
        
        // 'JSON Binding' ... Converts Browser Response-JSON to 'Boolean'
        Function<JsonObject, Boolean> responseProcessor = (JsonObject jo) ->
            ReadPrimJSON.getBoolean(jo, "didDeleteTokens");
        
        // 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);
    }
    
}