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


    // No Pubic Constructors
    private Memory () { }

    // 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 : Memory.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;

        parameterNames.put("getDOMCounters", EMPTY_VEC_STR);

        parameterNames.put("prepareForLeakDetection", EMPTY_VEC_STR);

        parameterNames.put("forciblyPurgeJavaScriptMemory", EMPTY_VEC_STR);

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

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

        v = new Vector<String>(2);
        parameterNames.put("startSampling", v);
        Collections.addAll(v, new String[]
        { "samplingInterval", "suppressRandomness", });

        parameterNames.put("stopSampling", EMPTY_VEC_STR);

        parameterNames.put("getAllTimeSamplingProfile", EMPTY_VEC_STR);

        parameterNames.put("getBrowserSamplingProfile", EMPTY_VEC_STR);

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


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

    /** Memory pressure level. */
    public static final String[] PressureLevel =
    { "moderate", "critical", };
    
    /** Heap profile sample. */
    public static class SamplingProfileNode
        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, }; }
        
        /** Size of the sampled allocation. */
        public final Number size;
        
        /** Total bytes attributed to this sample. */
        public final Number total;
        
        /** Execution stack at the point of allocation. */
        public final String[] stack;
        
        /**
         * Constructor
         *
         * @param size Size of the sampled allocation.
         * 
         * @param total Total bytes attributed to this sample.
         * 
         * @param stack Execution stack at the point of allocation.
         */
        public SamplingProfileNode(Number size, Number total, String[] stack)
        {
            // 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 (size == null)  BRDPC.throwNPE("size");
            if (total == null) BRDPC.throwNPE("total");
            if (stack == null) BRDPC.throwNPE("stack");
            
            this.size   = size;
            this.total  = total;
            this.stack  = stack;
        }
        
        /**
         * JSON Object Constructor
         * @param jo A Json-Object having data about an instance of {@code 'SamplingProfileNode'}.
         */
        public SamplingProfileNode (JsonObject jo)
        {
            this.size   = ReadNumberJSON.get(jo, "size", false, true);
            this.total  = ReadNumberJSON.get(jo, "total", false, true);
            this.stack = (jo.getJsonArray("stack") == null)
                ? null
                : ReadArrJSON.DimN.strArr(jo.getJsonArray("stack"), 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;
        
            SamplingProfileNode o = (SamplingProfileNode) other;
        
            return
                    Objects.equals(this.size, o.size)
                &&  Objects.equals(this.total, o.total)
                &&  Arrays.deepEquals(this.stack, o.stack);
        }
        
        /** Generates a Hash-Code for {@code 'this'} instance */
        public int hashCode()
        {
            return
                    Objects.hashCode(this.size)
                +   Objects.hashCode(this.total)
                +   Arrays.deepHashCode(this.stack);
        }
    }
    
    /** Array of heap profile samples. */
    public static class SamplingProfile
        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 Memory.SamplingProfileNode[] samples;
        
        /** <CODE>[No Description Provided by Google]</CODE> */
        public final Memory.Module[] modules;
        
        /**
         * Constructor
         *
         * @param samples -
         * 
         * @param modules -
         */
        public SamplingProfile(Memory.SamplingProfileNode[] samples, Memory.Module[] modules)
        {
            // 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 (samples == null) BRDPC.throwNPE("samples");
            if (modules == null) BRDPC.throwNPE("modules");
            
            this.samples  = samples;
            this.modules  = modules;
        }
        
        /**
         * JSON Object Constructor
         * @param jo A Json-Object having data about an instance of {@code 'SamplingProfile'}.
         */
        public SamplingProfile (JsonObject jo)
        {
            this.samples = (jo.getJsonArray("samples") == null)
                ? null
                : ReadArrJSON.DimN.objArr(jo.getJsonArray("samples"), null, 0, Memory.SamplingProfileNode[].class);
        
            this.modules = (jo.getJsonArray("modules") == null)
                ? null
                : ReadArrJSON.DimN.objArr(jo.getJsonArray("modules"), null, 0, Memory.Module[].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;
        
            SamplingProfile o = (SamplingProfile) other;
        
            return
                    Arrays.deepEquals(this.samples, o.samples)
                &&  Arrays.deepEquals(this.modules, o.modules);
        }
        
        /** Generates a Hash-Code for {@code 'this'} instance */
        public int hashCode()
        {
            return
                    Arrays.deepHashCode(this.samples)
                +   Arrays.deepHashCode(this.modules);
        }
    }
    
    /** Executable module information */
    public static class Module
        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, }; }
        
        /** Name of the module. */
        public final String name;
        
        /** UUID of the module. */
        public final String uuid;
        
        /**
         * Base address where the module is loaded into memory. Encoded as a decimal
         * or hexadecimal (0x prefixed) string.
         */
        public final String baseAddress;
        
        /** Size of the module in bytes. */
        public final Number size;
        
        /**
         * Constructor
         *
         * @param name Name of the module.
         * 
         * @param uuid UUID of the module.
         * 
         * @param baseAddress 
         * Base address where the module is loaded into memory. Encoded as a decimal
         * or hexadecimal (0x prefixed) string.
         * 
         * @param size Size of the module in bytes.
         */
        public Module(String name, String uuid, String baseAddress, Number size)
        {
            // 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 (uuid == null)        BRDPC.throwNPE("uuid");
            if (baseAddress == null) BRDPC.throwNPE("baseAddress");
            if (size == null)        BRDPC.throwNPE("size");
            
            this.name         = name;
            this.uuid         = uuid;
            this.baseAddress  = baseAddress;
            this.size         = size;
        }
        
        /**
         * JSON Object Constructor
         * @param jo A Json-Object having data about an instance of {@code 'Module'}.
         */
        public Module (JsonObject jo)
        {
            this.name         = ReadJSON.getString(jo, "name", false, true);
            this.uuid         = ReadJSON.getString(jo, "uuid", false, true);
            this.baseAddress  = ReadJSON.getString(jo, "baseAddress", false, true);
            this.size         = ReadNumberJSON.get(jo, "size", 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;
        
            Module o = (Module) other;
        
            return
                    Objects.equals(this.name, o.name)
                &&  Objects.equals(this.uuid, o.uuid)
                &&  Objects.equals(this.baseAddress, o.baseAddress)
                &&  Objects.equals(this.size, o.size);
        }
        
        /** Generates a Hash-Code for {@code 'this'} instance */
        public int hashCode()
        {
            return
                    Objects.hashCode(this.name)
                +   Objects.hashCode(this.uuid)
                +   Objects.hashCode(this.baseAddress)
                +   Objects.hashCode(this.size);
        }
    }
    
    
    // Counter for keeping the WebSocket Request ID's distinct.
    private static int counter = 1;
    
    /**
     * <CODE>[No Description Provided by Google]</CODE>
     * 
     * @return An instance of <CODE>{@link Script}&lt;String, {@link JsonObject},
     * {@link Ret3}&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 Ret3} 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 Ret3}</B>
     *
     * <BR /><BR /><UL CLASS=JDUL>
     * <LI><CODE><B>Ret3.a:</B> Integer (<B>documents</B>)</CODE>
     *     <BR />-
     *     <BR /><BR /></LI>
     * <LI><CODE><B>Ret3.b:</B> Integer (<B>nodes</B>)</CODE>
     *     <BR />-
     *     <BR /><BR /></LI>
     * <LI><CODE><B>Ret3.c:</B> Integer (<B>jsEventListeners</B>)</CODE>
     *     <BR />-
     *     </LI>
     * </UL>
     */
    public static Script<String, JsonObject, Ret3<Integer, Integer, Integer>> getDOMCounters()
    {
        final int          webSocketID = 29000000 + 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("getDOMCounters"),
            parameterNames.get("getDOMCounters"),
            optionals, webSocketID,
            "Memory.getDOMCounters"
        );
        
        // 'JSON Binding' ... Converts Browser Response-JSON into Java-Type 'Ret3'
        Function<JsonObject, Ret3<Integer, Integer, Integer>> 
            responseProcessor = (JsonObject jo) -> new Ret3<>(
                ReadBoxedJSON.getInteger(jo, "documents", true),
                ReadBoxedJSON.getInteger(jo, "nodes", true),
                ReadBoxedJSON.getInteger(jo, "jsEventListeners", 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);
    }
    
    /**
     * <CODE>[No Description Provided by Google]</CODE>
     * 
     * @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> prepareForLeakDetection()
    {
        final int          webSocketID = 29001000 + 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("prepareForLeakDetection"),
            parameterNames.get("prepareForLeakDetection"),
            optionals, webSocketID,
            "Memory.prepareForLeakDetection"
        );
        
        // This Remote Command does not have a Return-Value.
        return new Script<>
            (BRDPC.defaultSender, webSocketID, requestJSON, BRDPC.NoReturnValues);
    }
    
    /**
     * Simulate OomIntervention by purging V8 memory.
     * 
     * @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> forciblyPurgeJavaScriptMemory()
    {
        final int          webSocketID = 29002000 + 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("forciblyPurgeJavaScriptMemory"),
            parameterNames.get("forciblyPurgeJavaScriptMemory"),
            optionals, webSocketID,
            "Memory.forciblyPurgeJavaScriptMemory"
        );
        
        // This Remote Command does not have a Return-Value.
        return new Script<>
            (BRDPC.defaultSender, webSocketID, requestJSON, BRDPC.NoReturnValues);
    }
    
    /**
     * Enable/disable suppressing memory pressure notifications in all processes.
     * 
     * @param suppressed If true, memory pressure notifications will be suppressed.
     * 
     * @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> setPressureNotificationsSuppressed
        (boolean suppressed)
    {
        final int       webSocketID = 29003000 + counter++;
        final boolean[] optionals   = { false, };
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("setPressureNotificationsSuppressed"),
            parameterNames.get("setPressureNotificationsSuppressed"),
            optionals, webSocketID,
            "Memory.setPressureNotificationsSuppressed",
            suppressed
        );
        
        // This Remote Command does not have a Return-Value.
        return new Script<>
            (BRDPC.defaultSender, webSocketID, requestJSON, BRDPC.NoReturnValues);
    }
    
    /**
     * Simulate a memory pressure notification in all processes.
     * 
     * @param level Memory pressure level of the notification.
     * 
     * @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> simulatePressureNotification(String level)
    {
        // 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 (level == null) BRDPC.throwNPE("level");
        
        // 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("level", level, "Memory.PressureLevel", Memory.PressureLevel);
        
        final int       webSocketID = 29004000 + counter++;
        final boolean[] optionals   = { false, };
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("simulatePressureNotification"),
            parameterNames.get("simulatePressureNotification"),
            optionals, webSocketID,
            "Memory.simulatePressureNotification",
            level
        );
        
        // This Remote Command does not have a Return-Value.
        return new Script<>
            (BRDPC.defaultSender, webSocketID, requestJSON, BRDPC.NoReturnValues);
    }
    
    /**
     * Start collecting native memory profile.
     * 
     * @param samplingInterval Average number of bytes between samples.
     * <BR /><B>OPTIONAL</B>
     * 
     * @param suppressRandomness Do not randomize intervals between samples.
     * <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> startSampling
        (Integer samplingInterval, Boolean suppressRandomness)
    {
        final int       webSocketID = 29005000 + counter++;
        final boolean[] optionals   = { true, true, };
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("startSampling"),
            parameterNames.get("startSampling"),
            optionals, webSocketID,
            "Memory.startSampling",
            samplingInterval, suppressRandomness
        );
        
        // This Remote Command does not have a Return-Value.
        return new Script<>
            (BRDPC.defaultSender, webSocketID, requestJSON, BRDPC.NoReturnValues);
    }
    
    /**
     * Stop collecting native memory profile.
     * 
     * @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> stopSampling()
    {
        final int          webSocketID = 29006000 + 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("stopSampling"),
            parameterNames.get("stopSampling"),
            optionals, webSocketID,
            "Memory.stopSampling"
        );
        
        // This Remote Command does not have a Return-Value.
        return new Script<>
            (BRDPC.defaultSender, webSocketID, requestJSON, BRDPC.NoReturnValues);
    }
    
    /**
     * Retrieve native memory allocations profile
     * collected since renderer process startup.
     * 
     * @return An instance of <CODE>{@link Script}&lt;String, {@link JsonObject},
     * {@link Memory.SamplingProfile}&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 Memory.SamplingProfile}&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 Memory.SamplingProfile} (<B>profile</B></CODE>)
     *     <BR />-
     * </LI>
     * </UL> */
    public static Script<String, JsonObject, Memory.SamplingProfile> getAllTimeSamplingProfile()
    {
        final int          webSocketID = 29007000 + 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("getAllTimeSamplingProfile"),
            parameterNames.get("getAllTimeSamplingProfile"),
            optionals, webSocketID,
            "Memory.getAllTimeSamplingProfile"
        );
        
        // 'JSON Binding' ... Converts Browser Response-JSON to 'Memory.SamplingProfile'
        Function<JsonObject, Memory.SamplingProfile> responseProcessor = (JsonObject jo) ->
            ReadJSON.getObject(jo, "profile", Memory.SamplingProfile.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);
    }
    
    /**
     * Retrieve native memory allocations profile
     * collected since browser process startup.
     * 
     * @return An instance of <CODE>{@link Script}&lt;String, {@link JsonObject},
     * {@link Memory.SamplingProfile}&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 Memory.SamplingProfile}&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 Memory.SamplingProfile} (<B>profile</B></CODE>)
     *     <BR />-
     * </LI>
     * </UL> */
    public static Script<String, JsonObject, Memory.SamplingProfile> getBrowserSamplingProfile()
    {
        final int          webSocketID = 29008000 + 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("getBrowserSamplingProfile"),
            parameterNames.get("getBrowserSamplingProfile"),
            optionals, webSocketID,
            "Memory.getBrowserSamplingProfile"
        );
        
        // 'JSON Binding' ... Converts Browser Response-JSON to 'Memory.SamplingProfile'
        Function<JsonObject, Memory.SamplingProfile> responseProcessor = (JsonObject jo) ->
            ReadJSON.getObject(jo, "profile", Memory.SamplingProfile.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);
    }
    
    /**
     * Retrieve native memory allocations profile collected since last
     * <CODE>startSampling</CODE> call.
     * 
     * @return An instance of <CODE>{@link Script}&lt;String, {@link JsonObject},
     * {@link Memory.SamplingProfile}&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 Memory.SamplingProfile}&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 Memory.SamplingProfile} (<B>profile</B></CODE>)
     *     <BR />-
     * </LI>
     * </UL> */
    public static Script<String, JsonObject, Memory.SamplingProfile> getSamplingProfile()
    {
        final int          webSocketID = 29009000 + 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("getSamplingProfile"),
            parameterNames.get("getSamplingProfile"),
            optionals, webSocketID,
            "Memory.getSamplingProfile"
        );
        
        // 'JSON Binding' ... Converts Browser Response-JSON to 'Memory.SamplingProfile'
        Function<JsonObject, Memory.SamplingProfile> responseProcessor = (JsonObject jo) ->
            ReadJSON.getObject(jo, "profile", Memory.SamplingProfile.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);
    }
    
}