package Torello.Browser.BrowserAPI;

// *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** ***
// Java-HTML Imports
// *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** ***

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

import Torello.Java.ReadOnly.ReadOnlyList;
import Torello.Java.ReadOnly.ReadOnlyArrayList;

import Torello.JavaDoc.Annotations.StaticFunctional;
import Torello.JavaDoc.Annotations.JDHeaderBackgroundImg;

import Torello.Browser.BrowserAPI.NestedHelpers.Commands.Security$$Commands;


// *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** ***
// JDK Imports
// *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** ***

import javax.json.JsonObject;
import javax.json.JsonValue;

/**
 * <SPAN CLASS=COPIEDJDK><B>Security</B></SPAN>
 * <EMBED CLASS='external-html' DATA-FILE-ID=CDP.CODE_GEN_NOTE>
 */
@StaticFunctional@JDHeaderBackgroundImg(EmbedTagFileID="CDP.WOOD_PLANK_NOTE")
public class Security
{
    // No Pubic Constructors
    private Security() { }


    // ********************************************************************************************
    // ********************************************************************************************
    // Eliminated Types
    // ********************************************************************************************
    // ********************************************************************************************


    /**
     * An internal certificate ID value.

     * <EMBED CLASS='external-html' DATA-CTAS='int' DATA-FILE-ID=CDP.EliminatedType
     *     DATA-NAME=CertificateId>
     */
    public static final String CertificateId =
        "CertificateId has been eliminated.\n" +
        "It was replaced with the standard Java-Type: int";


    // ********************************************************************************************
    // ********************************************************************************************
    // Enumerated String Constants Lists
    // ********************************************************************************************
    // ********************************************************************************************


    /**
     * The action to take when a certificate error occurs. continue will continue processing the
     * request and cancel will cancel the request.
     * <BR /><BR /><B CLASS=StrEnumType>String-Enumeration Type</B>
     */
    public static final ReadOnlyList<String> CertificateErrorAction = new ReadOnlyArrayList<>
        (String.class, "cancel", "continue");

    /**
     * A description of mixed content (HTTP resources on HTTPS pages), as defined by
     * https://www.w3.org/TR/mixed-content/#categories
     * <BR /><BR /><B CLASS=StrEnumType>String-Enumeration Type</B>
     */
    public static final ReadOnlyList<String> MixedContentType = new ReadOnlyArrayList<>
        (String.class, "blockable", "none", "optionally-blockable");

    /**
     * <CODE>[No Description Provided by Google]</CODE>
     * 
     * <BR /><B CLASS=Exp-Top>EXPERIMENTAL</B>
     * <BR /><BR /><B CLASS=StrEnumType>String-Enumeration Type</B>
     */
    public static final ReadOnlyList<String> SafetyTipStatus = new ReadOnlyArrayList<>
        (String.class, "badReputation", "lookalike");

    /**
     * The security level of a page or resource.
     * <BR /><BR /><B CLASS=StrEnumType>String-Enumeration Type</B>
     */
    public static final ReadOnlyList<String> SecurityState = new ReadOnlyArrayList<>
        (String.class, "info", "insecure", "insecure-broken", "neutral", "secure", "unknown");



    // ********************************************************************************************
    // ********************************************************************************************
    // Basic Types
    // ********************************************************************************************
    // ********************************************************************************************


    /**
     * Details about the security state of the page certificate.
     * 
     * <BR /><B CLASS=Exp-Top>EXPERIMENTAL</B>
     * <EMBED CLASS=globalDefs DATA-DOMAIN=Security DATA-API=BrowserAPI>
     */
    @JDHeaderBackgroundImg(EmbedTagFileID="CDP.NESTED_TYPE_JDHBI")
    public static class CertificateSecurityState
        extends BaseType<CertificateSecurityState>
        implements java.io.Serializable
    {
        /** <EMBED CLASS='external-html' DATA-FILE-ID=SVUID> */
        protected static final long serialVersionUID = 1;

        private static final NestedHelper<Security.CertificateSecurityState> singleton =
            Torello.Browser.BrowserAPI.NestedHelpers.Types.
                Security$$CertificateSecurityState$$.singleton;

        /** Protocol name (e.g. "TLS 1.2" or "QUIC"). */
        public final String protocol;

        /** Key Exchange used by the connection, or the empty string if not applicable. */
        public final String keyExchange;

        /**
         * (EC)DH group used by the connection, if applicable.
         * <BR /><B CLASS=Opt-Top>OPTIONAL</B>
         */
        public final String keyExchangeGroup;

        /** Cipher name. */
        public final String cipher;

        /**
         * TLS MAC. Note that AEAD ciphers do not have separate MACs.
         * <BR /><B CLASS=Opt-Top>OPTIONAL</B>
         */
        public final String mac;

        /** Page certificate. */
        public final String[] certificate;

        /** Certificate subject name. */
        public final String subjectName;

        /** Name of the issuing CA. */
        public final String issuer;

        /** Certificate valid from date. */
        public final Number validFrom;

        /** Certificate valid to (expiration) date */
        public final Number validTo;

        /**
         * The highest priority network error code, if the certificate has an error.
         * <BR /><B CLASS=Opt-Top>OPTIONAL</B>
         */
        public final String certificateNetworkError;

        /** True if the certificate uses a weak signature algorithm. */
        public final boolean certificateHasWeakSignature;

        /** True if the certificate has a SHA1 signature in the chain. */
        public final boolean certificateHasSha1Signature;

        /** True if modern SSL */
        public final boolean modernSSL;

        /** True if the connection is using an obsolete SSL protocol. */
        public final boolean obsoleteSslProtocol;

        /** True if the connection is using an obsolete SSL key exchange. */
        public final boolean obsoleteSslKeyExchange;

        /** True if the connection is using an obsolete SSL cipher. */
        public final boolean obsoleteSslCipher;

        /** True if the connection is using an obsolete SSL signature. */
        public final boolean obsoleteSslSignature;

        /** Constructor.  Please review this class' fields for documentation. */
        public CertificateSecurityState(
                ReadOnlyList<Boolean> isPresent, String protocol, String keyExchange,
                String keyExchangeGroup, String cipher, String mac, String[] certificate,
                String subjectName, String issuer, Number validFrom, Number validTo,
                String certificateNetworkError, boolean certificateHasWeakSignature,
                boolean certificateHasSha1Signature, boolean modernSSL,
                boolean obsoleteSslProtocol, boolean obsoleteSslKeyExchange,
                boolean obsoleteSslCipher, boolean obsoleteSslSignature
            )
        {
            super(singleton, Domains.Security, "CertificateSecurityState", 18);

            this.protocol                       = protocol;
            this.keyExchange                    = keyExchange;
            this.keyExchangeGroup               = keyExchangeGroup;
            this.cipher                         = cipher;
            this.mac                            = mac;
            this.certificate                    = certificate;
            this.subjectName                    = subjectName;
            this.issuer                         = issuer;
            this.validFrom                      = validFrom;
            this.validTo                        = validTo;
            this.certificateNetworkError        = certificateNetworkError;
            this.certificateHasWeakSignature    = certificateHasWeakSignature;
            this.certificateHasSha1Signature    = certificateHasSha1Signature;
            this.modernSSL                      = modernSSL;
            this.obsoleteSslProtocol            = obsoleteSslProtocol;
            this.obsoleteSslKeyExchange         = obsoleteSslKeyExchange;
            this.obsoleteSslCipher              = obsoleteSslCipher;
            this.obsoleteSslSignature           = obsoleteSslSignature;

            this.isPresent = (isPresent == null)
                ? singleton.generateIsPresentList(this)
                : THROWS.check(isPresent, 18, "Security.CertificateSecurityState");
        }

        /** Creates an instance of this class from a {@link JsonObject}.*/
        public static CertificateSecurityState fromJSON(JsonObject jo)
        { return singleton.fromJSON(jo); }

        /** Returns this class's {@link NestedDescriptor} singleton-instance. class / type.*/
        public static NestedDescriptor<CertificateSecurityState> descriptor()
        { return singleton.descriptor(); }
    }

    /**
     * Information about insecure content on the page.
     * 
     * <BR /><B CLASS=Dep-Top>DEPRECATED</B>
     * <EMBED CLASS=globalDefs DATA-DOMAIN=Security DATA-API=BrowserAPI>
     */
    @JDHeaderBackgroundImg(EmbedTagFileID="CDP.NESTED_TYPE_JDHBI")
    public static class InsecureContentStatus
        extends BaseType<InsecureContentStatus>
        implements java.io.Serializable
    {
        /** <EMBED CLASS='external-html' DATA-FILE-ID=SVUID> */
        protected static final long serialVersionUID = 1;

        private static final NestedHelper<Security.InsecureContentStatus> singleton =
            Torello.Browser.BrowserAPI.NestedHelpers.Types.
                Security$$InsecureContentStatus$$.singleton;

        /** Always false. */
        public final boolean ranMixedContent;

        /** Always false. */
        public final boolean displayedMixedContent;

        /** Always false. */
        public final boolean containedMixedForm;

        /** Always false. */
        public final boolean ranContentWithCertErrors;

        /** Always false. */
        public final boolean displayedContentWithCertErrors;

        /**
         * Always set to unknown.
         * <EMBED CLASS='external-html' DATA-D=Security DATA-C=SecurityState DATA-F=ranInsecureContentStyle DATA-FILE-ID=CDP.EL2>
         * @see BaseType#enumStrList(String)
         */
        public final String ranInsecureContentStyle;

        /**
         * Always set to unknown.
         * <EMBED CLASS='external-html' DATA-D=Security DATA-C=SecurityState DATA-F=displayedInsecureContentStyle DATA-FILE-ID=CDP.EL2>
         * @see BaseType#enumStrList(String)
         */
        public final String displayedInsecureContentStyle;

        /** Constructor.  Please review this class' fields for documentation. */
        public InsecureContentStatus(
                ReadOnlyList<Boolean> isPresent, boolean ranMixedContent,
                boolean displayedMixedContent, boolean containedMixedForm,
                boolean ranContentWithCertErrors, boolean displayedContentWithCertErrors,
                String ranInsecureContentStyle, String displayedInsecureContentStyle
            )
        {
            super(singleton, Domains.Security, "InsecureContentStatus", 7);

            this.ranMixedContent                = ranMixedContent;
            this.displayedMixedContent          = displayedMixedContent;
            this.containedMixedForm             = containedMixedForm;
            this.ranContentWithCertErrors       = ranContentWithCertErrors;
            this.displayedContentWithCertErrors = displayedContentWithCertErrors;
            this.ranInsecureContentStyle        = ranInsecureContentStyle;
            this.displayedInsecureContentStyle  = displayedInsecureContentStyle;

            this.isPresent = (isPresent == null)
                ? singleton.generateIsPresentList(this)
                : THROWS.check(isPresent, 7, "Security.InsecureContentStatus");
        }

        /** Creates an instance of this class from a {@link JsonObject}.*/
        public static InsecureContentStatus fromJSON(JsonObject jo)
        { return singleton.fromJSON(jo); }

        /** Returns this class's {@link NestedDescriptor} singleton-instance. class / type.*/
        public static NestedDescriptor<InsecureContentStatus> descriptor()
        { return singleton.descriptor(); }
    }

    /**
     * <CODE>[No Description Provided by Google]</CODE>
     * 
     * <BR /><B CLASS=Exp-Top>EXPERIMENTAL</B>
     * <EMBED CLASS=globalDefs DATA-DOMAIN=Security DATA-API=BrowserAPI>
     */
    @JDHeaderBackgroundImg(EmbedTagFileID="CDP.NESTED_TYPE_JDHBI")
    public static class SafetyTipInfo
        extends BaseType<SafetyTipInfo>
        implements java.io.Serializable
    {
        /** <EMBED CLASS='external-html' DATA-FILE-ID=SVUID> */
        protected static final long serialVersionUID = 1;

        private static final NestedHelper<Security.SafetyTipInfo> singleton =
            Torello.Browser.BrowserAPI.NestedHelpers.Types.
                Security$$SafetyTipInfo$$.singleton;

        /**
         * Describes whether the page triggers any safety tips or reputation warnings. Default is unknown.
         * <EMBED CLASS='external-html' DATA-D=Security DATA-C=SafetyTipStatus DATA-F=safetyTipStatus DATA-FILE-ID=CDP.EL2>
         * @see BaseType#enumStrList(String)
         */
        public final String safetyTipStatus;

        /**
         * The URL the safety tip suggested ("Did you mean?"). Only filled in for lookalike matches.
         * <BR /><B CLASS=Opt-Top>OPTIONAL</B>
         */
        public final String safeUrl;

        /** Constructor.  Please review this class' fields for documentation. */
        public SafetyTipInfo
            (ReadOnlyList<Boolean> isPresent, String safetyTipStatus, String safeUrl)
        {
            super(singleton, Domains.Security, "SafetyTipInfo", 2);

            this.safetyTipStatus    = safetyTipStatus;
            this.safeUrl            = safeUrl;

            this.isPresent = (isPresent == null)
                ? singleton.generateIsPresentList(this)
                : THROWS.check(isPresent, 2, "Security.SafetyTipInfo");
        }

        /** Creates an instance of this class from a {@link JsonObject}.*/
        public static SafetyTipInfo fromJSON(JsonObject jo)
        { return singleton.fromJSON(jo); }

        /** Returns this class's {@link NestedDescriptor} singleton-instance. class / type.*/
        public static NestedDescriptor<SafetyTipInfo> descriptor()
        { return singleton.descriptor(); }
    }

    /**
     * An explanation of an factor contributing to the security state.
     * 
     * <EMBED CLASS=globalDefs DATA-DOMAIN=Security DATA-API=BrowserAPI>
     */
    @JDHeaderBackgroundImg(EmbedTagFileID="CDP.NESTED_TYPE_JDHBI")
    public static class SecurityStateExplanation
        extends BaseType<SecurityStateExplanation>
        implements java.io.Serializable
    {
        /** <EMBED CLASS='external-html' DATA-FILE-ID=SVUID> */
        protected static final long serialVersionUID = 1;

        private static final NestedHelper<Security.SecurityStateExplanation> singleton =
            Torello.Browser.BrowserAPI.NestedHelpers.Types.
                Security$$SecurityStateExplanation$$.singleton;

        /**
         * Security state representing the severity of the factor being explained.
         * <EMBED CLASS='external-html' DATA-D=Security DATA-C=SecurityState DATA-F=securityState DATA-FILE-ID=CDP.EL2>
         * @see BaseType#enumStrList(String)
         */
        public final String securityState;

        /** Title describing the type of factor. */
        public final String title;

        /** Short phrase describing the type of factor. */
        public final String summary;

        /** Full text explanation of the factor. */
        public final String description;

        /**
         * The type of mixed content described by the explanation.
         * <EMBED CLASS='external-html' DATA-D=Security DATA-C=MixedContentType DATA-F=mixedContentType DATA-FILE-ID=CDP.EL2>
         * @see BaseType#enumStrList(String)
         */
        public final String mixedContentType;

        /** Page certificate. */
        public final String[] certificate;

        /**
         * Recommendations to fix any issues.
         * <BR /><B CLASS=Opt-Top>OPTIONAL</B>
         */
        public final String[] recommendations;

        /** Constructor.  Please review this class' fields for documentation. */
        public SecurityStateExplanation(
                ReadOnlyList<Boolean> isPresent, String securityState, String title,
                String summary, String description, String mixedContentType, String[] certificate,
                String[] recommendations
            )
        {
            super(singleton, Domains.Security, "SecurityStateExplanation", 7);

            this.securityState      = securityState;
            this.title              = title;
            this.summary            = summary;
            this.description        = description;
            this.mixedContentType   = mixedContentType;
            this.certificate        = certificate;
            this.recommendations    = recommendations;

            this.isPresent = (isPresent == null)
                ? singleton.generateIsPresentList(this)
                : THROWS.check(isPresent, 7, "Security.SecurityStateExplanation");
        }

        /** Creates an instance of this class from a {@link JsonObject}.*/
        public static SecurityStateExplanation fromJSON(JsonObject jo)
        { return singleton.fromJSON(jo); }

        /** Returns this class's {@link NestedDescriptor} singleton-instance. class / type.*/
        public static NestedDescriptor<SecurityStateExplanation> descriptor()
        { return singleton.descriptor(); }
    }

    /**
     * Security state information about the page.
     * 
     * <BR /><B CLASS=Exp-Top>EXPERIMENTAL</B>
     * <EMBED CLASS=globalDefs DATA-DOMAIN=Security DATA-API=BrowserAPI>
     */
    @JDHeaderBackgroundImg(EmbedTagFileID="CDP.NESTED_TYPE_JDHBI")
    public static class VisibleSecurityState
        extends BaseType<VisibleSecurityState>
        implements java.io.Serializable
    {
        /** <EMBED CLASS='external-html' DATA-FILE-ID=SVUID> */
        protected static final long serialVersionUID = 1;

        private static final NestedHelper<Security.VisibleSecurityState> singleton =
            Torello.Browser.BrowserAPI.NestedHelpers.Types.
                Security$$VisibleSecurityState$$.singleton;

        /**
         * The security level of the page.
         * <EMBED CLASS='external-html' DATA-D=Security DATA-C=SecurityState DATA-F=securityState DATA-FILE-ID=CDP.EL2>
         * @see BaseType#enumStrList(String)
         */
        public final String securityState;

        /**
         * Security state details about the page certificate.
         * <BR /><B CLASS=Opt-Top>OPTIONAL</B>
         */
        public final Security.CertificateSecurityState certificateSecurityState;

        /**
         * The type of Safety Tip triggered on the page. Note that this field will be set even if the Safety Tip UI was not actually shown.
         * <BR /><B CLASS=Opt-Top>OPTIONAL</B>
         */
        public final Security.SafetyTipInfo safetyTipInfo;

        /** Array of security state issues ids. */
        public final String[] securityStateIssueIds;

        /** Constructor.  Please review this class' fields for documentation. */
        public VisibleSecurityState(
                ReadOnlyList<Boolean> isPresent, String securityState,
                CertificateSecurityState certificateSecurityState, SafetyTipInfo safetyTipInfo,
                String[] securityStateIssueIds
            )
        {
            super(singleton, Domains.Security, "VisibleSecurityState", 4);

            this.securityState              = securityState;
            this.certificateSecurityState   = certificateSecurityState;
            this.safetyTipInfo              = safetyTipInfo;
            this.securityStateIssueIds      = securityStateIssueIds;

            this.isPresent = (isPresent == null)
                ? singleton.generateIsPresentList(this)
                : THROWS.check(isPresent, 4, "Security.VisibleSecurityState");
        }

        /** Creates an instance of this class from a {@link JsonObject}.*/
        public static VisibleSecurityState fromJSON(JsonObject jo)
        { return singleton.fromJSON(jo); }

        /** Returns this class's {@link NestedDescriptor} singleton-instance. class / type.*/
        public static NestedDescriptor<VisibleSecurityState> descriptor()
        { return singleton.descriptor(); }
    }


    // ********************************************************************************************
    // ********************************************************************************************
    // Event Types
    // ********************************************************************************************
    // ********************************************************************************************


    /**
     * There is a certificate error. If overriding certificate errors is enabled, then it should be
     * handled with the <CODE>handleCertificateError</CODE> command. Note: this event does not fire if the
     * certificate error has been allowed internally. Only one client per target should override
     * certificate errors at the same time.
     * 
     * <BR /><B CLASS=Dep-Top>DEPRECATED</B>
     * <EMBED CLASS=globalDefs DATA-DOMAIN=Security DATA-API=BrowserAPI>
     */
    @JDHeaderBackgroundImg(EmbedTagFileID="CDP.NESTED_EVENT_JDHBI")
    public static class certificateError
        extends BrowserEvent<certificateError>
        implements java.io.Serializable
    {
        /** <EMBED CLASS='external-html' DATA-FILE-ID=SVUID> */
        protected static final long serialVersionUID = 1;

        private static final NestedHelper<Security.certificateError> singleton =
            Torello.Browser.BrowserAPI.NestedHelpers.Events.
                Security$$certificateError$$.singleton;

        /** The ID of the event. */
        public final int eventId;

        /** The type of the error. */
        public final String errorType;

        /** The url that was requested. */
        public final String requestURL;

        /** Constructor.  Please review this class' fields for documentation. */
        public certificateError
            (ReadOnlyList<Boolean> isPresent, int eventId, String errorType, String requestURL)
        {
            super(singleton, Domains.Security, "certificateError", 3);

            this.eventId    = eventId;
            this.errorType  = errorType;
            this.requestURL = requestURL;

            this.isPresent = (isPresent == null)
                ? singleton.generateIsPresentList(this)
                : THROWS.check(isPresent, 3, "Security.certificateError");
        }

        /** Creates an instance of this class from a {@link JsonObject}.*/
        public static certificateError fromJSON(JsonObject jo)
        { return singleton.fromJSON(jo); }

        /** Returns this class's {@link NestedDescriptor} singleton-instance. class / type.*/
        public static NestedDescriptor<certificateError> descriptor()
        { return singleton.descriptor(); }
    }

    /**
     * The security state of the page changed. No longer being sent.
     * 
     * <BR /><B CLASS=Dep-Top>DEPRECATED</B>
     * <EMBED CLASS=globalDefs DATA-DOMAIN=Security DATA-API=BrowserAPI>
     */
    @JDHeaderBackgroundImg(EmbedTagFileID="CDP.NESTED_EVENT_JDHBI")
    public static class securityStateChanged
        extends BrowserEvent<securityStateChanged>
        implements java.io.Serializable
    {
        /** <EMBED CLASS='external-html' DATA-FILE-ID=SVUID> */
        protected static final long serialVersionUID = 1;

        private static final NestedHelper<Security.securityStateChanged> singleton =
            Torello.Browser.BrowserAPI.NestedHelpers.Events.
                Security$$securityStateChanged$$.singleton;

        /**
         * Security state.
         * <EMBED CLASS='external-html' DATA-D=Security DATA-C=SecurityState DATA-F=securityState DATA-FILE-ID=CDP.EL2>
         * @see BaseType#enumStrList(String)
         */
        public final String securityState;

        /**
         * True if the page was loaded over cryptographic transport such as HTTPS.
         * <BR /><B CLASS=Dep-Top>DEPRECATED</B>
         */
        public final boolean schemeIsCryptographic;

        /**
         * Previously a list of explanations for the security state. Now always
         * empty.
         * <BR /><B CLASS=Dep-Top>DEPRECATED</B>
         */
        public final Security.SecurityStateExplanation[] explanations;

        /**
         * Information about insecure content on the page.
         * <BR /><B CLASS=Dep-Top>DEPRECATED</B>
         */
        public final Security.InsecureContentStatus insecureContentStatus;

        /**
         * Overrides user-visible description of the state. Always omitted.
         * <BR /><B CLASS=Opt-Top>OPTIONAL</B><B CLASS=Dep-Top>DEPRECATED</B>
         */
        public final String summary;

        /** Constructor.  Please review this class' fields for documentation. */
        public securityStateChanged(
                ReadOnlyList<Boolean> isPresent, String securityState,
                boolean schemeIsCryptographic, SecurityStateExplanation[] explanations,
                InsecureContentStatus insecureContentStatus, String summary
            )
        {
            super(singleton, Domains.Security, "securityStateChanged", 5);

            this.securityState          = securityState;
            this.schemeIsCryptographic  = schemeIsCryptographic;
            this.explanations           = explanations;
            this.insecureContentStatus  = insecureContentStatus;
            this.summary                = summary;

            this.isPresent = (isPresent == null)
                ? singleton.generateIsPresentList(this)
                : THROWS.check(isPresent, 5, "Security.securityStateChanged");
        }

        /** Creates an instance of this class from a {@link JsonObject}.*/
        public static securityStateChanged fromJSON(JsonObject jo)
        { return singleton.fromJSON(jo); }

        /** Returns this class's {@link NestedDescriptor} singleton-instance. class / type.*/
        public static NestedDescriptor<securityStateChanged> descriptor()
        { return singleton.descriptor(); }
    }

    /**
     * The security state of the page changed.
     * 
     * <BR /><B CLASS=Exp-Top>EXPERIMENTAL</B>
     * <EMBED CLASS=globalDefs DATA-DOMAIN=Security DATA-API=BrowserAPI>
     */
    @JDHeaderBackgroundImg(EmbedTagFileID="CDP.NESTED_EVENT_JDHBI")
    public static class visibleSecurityStateChanged
        extends BrowserEvent<visibleSecurityStateChanged>
        implements java.io.Serializable
    {
        /** <EMBED CLASS='external-html' DATA-FILE-ID=SVUID> */
        protected static final long serialVersionUID = 1;

        private static final NestedHelper<Security.visibleSecurityStateChanged> singleton =
            Torello.Browser.BrowserAPI.NestedHelpers.Events.
                Security$$visibleSecurityStateChanged$$.singleton;

        /** Security state information about the page. */
        public final Security.VisibleSecurityState visibleSecurityState;

        /** Constructor.  Please review this class' fields for documentation. */
        public visibleSecurityStateChanged
            (ReadOnlyList<Boolean> isPresent, VisibleSecurityState visibleSecurityState)
        {
            super(singleton, Domains.Security, "visibleSecurityStateChanged", 1);

            this.visibleSecurityState = visibleSecurityState;

            this.isPresent = (isPresent == null)
                ? singleton.generateIsPresentList(this)
                : THROWS.check(isPresent, 1, "Security.visibleSecurityStateChanged");
        }

        /** Creates an instance of this class from a {@link JsonObject}.*/
        public static visibleSecurityStateChanged fromJSON(JsonObject jo)
        { return singleton.fromJSON(jo); }

        /** Returns this class's {@link NestedDescriptor} singleton-instance. class / type.*/
        public static NestedDescriptor<visibleSecurityStateChanged> descriptor()
        { return singleton.descriptor(); }
    }




    // ********************************************************************************************
    // ********************************************************************************************
    // Commands
    // ********************************************************************************************
    // ********************************************************************************************


    /**
     * Disables tracking security state changes.
     * 
     * @return An instance of <CODE>{@link Script}&lt;Void&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 /><DIV CLASS=JDHint>
     * 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 <Void>} to ensure that
     * the Browser Function has run to completion.
     * </DIV>
     */
    public static Script<Void> disable()
    {
        // Ultra-Simple Request JSON - Because this method has no parameters
        final String requestJSON = "{\"method\":\"Security.disable\"}";

        return Script.NO_RET(Domains.Security, "disable", requestJSON);
    }

    /**
     * Enables tracking security state changes.
     * 
     * @return An instance of <CODE>{@link Script}&lt;Void&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 /><DIV CLASS=JDHint>
     * 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 <Void>} to ensure that
     * the Browser Function has run to completion.
     * </DIV>
     */
    public static Script<Void> enable()
    {
        // Ultra-Simple Request JSON - Because this method has no parameters
        final String requestJSON = "{\"method\":\"Security.enable\"}";

        return Script.NO_RET(Domains.Security, "enable", requestJSON);
    }

    /**
     * Handles a certificate error that fired a certificateError event.
     * 
     * <BR /><B CLASS=Dep-Top>DEPRECATED</B>
     * 
     * @param eventId The ID of the event.
     * 
     * @param action The action to take on the certificate error.
     * 
     * @return An instance of <CODE>{@link Script}&lt;Void&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 /><DIV CLASS=JDHint>
     * 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 <Void>} to ensure that
     * the Browser Function has run to completion.
     * </DIV>
     */
    public static Script<Void> handleCertificateError(int eventId, String action)
    {
        // Convert all Method Parameters into a JSON Request-Object (as a String)
        final String requestJSON = WriteJSON.get(
            Security$$Commands.handleCertificateError$$, "Security.handleCertificateError",
            eventId, action
        );

        return Script.NO_RET(Domains.Security, "handleCertificateError", requestJSON);
    }

    /**
     * Enable/disable whether all certificate errors should be ignored.
     * 
     * @param ignore If true, all certificate errors will be ignored.
     * 
     * @return An instance of <CODE>{@link Script}&lt;Void&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 /><DIV CLASS=JDHint>
     * 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 <Void>} to ensure that
     * the Browser Function has run to completion.
     * </DIV>
     */
    public static Script<Void> setIgnoreCertificateErrors(boolean ignore)
    {
        // Build the JSON Request-Object (as a String); only 1 Parameter is passed
        final String requestJSON = WriteJSON.get(
            CDPTypes.PRIMITIVE_BOOLEAN, "ignore", false, "Security.setIgnoreCertificateErrors",
            ignore
        );

        return Script.NO_RET(Domains.Security, "setIgnoreCertificateErrors", requestJSON);
    }

    /**
     * Enable/disable overriding certificate errors. If enabled, all certificate error events need to
     * be handled by the DevTools client and should be answered with <CODE>handleCertificateError</CODE> commands.
     * 
     * <BR /><B CLASS=Dep-Top>DEPRECATED</B>
     * 
     * @param override If true, certificate errors will be overridden.
     * 
     * @return An instance of <CODE>{@link Script}&lt;Void&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 /><DIV CLASS=JDHint>
     * 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 <Void>} to ensure that
     * the Browser Function has run to completion.
     * </DIV>
     */
    public static Script<Void> setOverrideCertificateErrors(boolean override)
    {
        // Build the JSON Request-Object (as a String); only 1 Parameter is passed
        final String requestJSON = WriteJSON.get(
            CDPTypes.PRIMITIVE_BOOLEAN, "override", false,
            "Security.setOverrideCertificateErrors", override
        );

        return Script.NO_RET(Domains.Security, "setOverrideCertificateErrors", requestJSON);
    }


}