devtools-protocol 0.0.1565416 → 0.0.1566079

package/json/browser_protocol.json

@@ -17317,6 +17317,193 @@
                         }
                     ]
                 },
+                {
+                    "id": "DeviceBoundSessionEventId",
+                    "description": "A unique identifier for a device bound session event.",
+                    "experimental": true,
+                    "type": "string"
+                },
+                {
+                    "id": "DeviceBoundSessionFetchResult",
+                    "description": "A fetch result for a device bound session creation or refresh.",
+                    "experimental": true,
+                    "type": "string",
+                    "enum": [
+                        "Success",
+                        "KeyError",
+                        "SigningError",
+                        "ServerRequestedTermination",
+                        "InvalidSessionId",
+                        "InvalidChallenge",
+                        "TooManyChallenges",
+                        "InvalidFetcherUrl",
+                        "InvalidRefreshUrl",
+                        "TransientHttpError",
+                        "ScopeOriginSameSiteMismatch",
+                        "RefreshUrlSameSiteMismatch",
+                        "MismatchedSessionId",
+                        "MissingScope",
+                        "NoCredentials",
+                        "SubdomainRegistrationWellKnownUnavailable",
+                        "SubdomainRegistrationUnauthorized",
+                        "SubdomainRegistrationWellKnownMalformed",
+                        "SessionProviderWellKnownUnavailable",
+                        "RelyingPartyWellKnownUnavailable",
+                        "FederatedKeyThumbprintMismatch",
+                        "InvalidFederatedSessionUrl",
+                        "InvalidFederatedKey",
+                        "TooManyRelyingOriginLabels",
+                        "BoundCookieSetForbidden",
+                        "NetError",
+                        "ProxyError",
+                        "EmptySessionConfig",
+                        "InvalidCredentialsConfig",
+                        "InvalidCredentialsType",
+                        "InvalidCredentialsEmptyName",
+                        "InvalidCredentialsCookie",
+                        "PersistentHttpError",
+                        "RegistrationAttemptedChallenge",
+                        "InvalidScopeOrigin",
+                        "ScopeOriginContainsPath",
+                        "RefreshInitiatorNotString",
+                        "RefreshInitiatorInvalidHostPattern",
+                        "InvalidScopeSpecification",
+                        "MissingScopeSpecificationType",
+                        "EmptyScopeSpecificationDomain",
+                        "EmptyScopeSpecificationPath",
+                        "InvalidScopeSpecificationType",
+                        "InvalidScopeIncludeSite",
+                        "MissingScopeIncludeSite",
+                        "FederatedNotAuthorizedByProvider",
+                        "FederatedNotAuthorizedByRelyingParty",
+                        "SessionProviderWellKnownMalformed",
+                        "SessionProviderWellKnownHasProviderOrigin",
+                        "RelyingPartyWellKnownMalformed",
+                        "RelyingPartyWellKnownHasRelyingOrigins",
+                        "InvalidFederatedSessionProviderSessionMissing",
+                        "InvalidFederatedSessionWrongProviderOrigin",
+                        "InvalidCredentialsCookieCreationTime",
+                        "InvalidCredentialsCookieName",
+                        "InvalidCredentialsCookieParsing",
+                        "InvalidCredentialsCookieUnpermittedAttribute",
+                        "InvalidCredentialsCookieInvalidDomain",
+                        "InvalidCredentialsCookiePrefix",
+                        "InvalidScopeRulePath",
+                        "InvalidScopeRuleHostPattern",
+                        "ScopeRuleOriginScopedHostPatternMismatch",
+                        "ScopeRuleSiteScopedHostPatternMismatch",
+                        "SigningQuotaExceeded",
+                        "InvalidConfigJson",
+                        "InvalidFederatedSessionProviderFailedToRestoreKey",
+                        "FailedToUnwrapKey",
+                        "SessionDeletedDuringRefresh"
+                    ]
+                },
+                {
+                    "id": "CreationEventDetails",
+                    "description": "Session event details specific to creation.",
+                    "experimental": true,
+                    "type": "object",
+                    "properties": [
+                        {
+                            "name": "fetchResult",
+                            "description": "The result of the fetch attempt.",
+                            "$ref": "DeviceBoundSessionFetchResult"
+                        },
+                        {
+                            "name": "newSession",
+                            "description": "The session if there was a newly created session. This is populated for\nall successful creation events.",
+                            "optional": true,
+                            "$ref": "DeviceBoundSession"
+                        }
+                    ]
+                },
+                {
+                    "id": "RefreshEventDetails",
+                    "description": "Session event details specific to refresh.",
+                    "experimental": true,
+                    "type": "object",
+                    "properties": [
+                        {
+                            "name": "refreshResult",
+                            "description": "The result of a refresh.",
+                            "type": "string",
+                            "enum": [
+                                "Refreshed",
+                                "InitializedService",
+                                "Unreachable",
+                                "ServerError",
+                                "RefreshQuotaExceeded",
+                                "FatalError",
+                                "SigningQuotaExceeded"
+                            ]
+                        },
+                        {
+                            "name": "fetchResult",
+                            "description": "If there was a fetch attempt, the result of that.",
+                            "optional": true,
+                            "$ref": "DeviceBoundSessionFetchResult"
+                        },
+                        {
+                            "name": "newSession",
+                            "description": "The session display if there was a newly created session. This is populated\nfor any refresh event that modifies the session config.",
+                            "optional": true,
+                            "$ref": "DeviceBoundSession"
+                        },
+                        {
+                            "name": "wasFullyProactiveRefresh",
+                            "description": "See comments on `net::device_bound_sessions::RefreshEventResult::was_fully_proactive_refresh`.",
+                            "type": "boolean"
+                        }
+                    ]
+                },
+                {
+                    "id": "TerminationEventDetails",
+                    "description": "Session event details specific to termination.",
+                    "experimental": true,
+                    "type": "object",
+                    "properties": [
+                        {
+                            "name": "deletionReason",
+                            "description": "The reason for a session being deleted.",
+                            "type": "string",
+                            "enum": [
+                                "Expired",
+                                "FailedToRestoreKey",
+                                "FailedToUnwrapKey",
+                                "StoragePartitionCleared",
+                                "ClearBrowsingData",
+                                "ServerRequested",
+                                "InvalidSessionParams",
+                                "RefreshFatalError"
+                            ]
+                        }
+                    ]
+                },
+                {
+                    "id": "ChallengeEventDetails",
+                    "description": "Session event details specific to challenges.",
+                    "experimental": true,
+                    "type": "object",
+                    "properties": [
+                        {
+                            "name": "challengeResult",
+                            "description": "The result of a challenge.",
+                            "type": "string",
+                            "enum": [
+                                "Success",
+                                "NoSessionId",
+                                "NoSessionMatch",
+                                "CantSetBoundCookie"
+                            ]
+                        },
+                        {
+                            "name": "challenge",
+                            "description": "The challenge set.",
+                            "type": "string"
+                        }
+                    ]
+                },
                 {
                     "id": "LoadNetworkResourcePageResult",
                     "description": "An object providing the result of a network resource load.",
@@ -19390,6 +19577,55 @@
                             }
                         }
                     ]
+                },
+                {
+                    "name": "deviceBoundSessionEventOccurred",
+                    "description": "Triggered when a device bound session event occurs.",
+                    "experimental": true,
+                    "parameters": [
+                        {
+                            "name": "eventId",
+                            "description": "A unique identifier for this session event.",
+                            "$ref": "DeviceBoundSessionEventId"
+                        },
+                        {
+                            "name": "site",
+                            "description": "The site this session event is associated with.",
+                            "type": "string"
+                        },
+                        {
+                            "name": "succeeded",
+                            "description": "Whether this event was considered successful.",
+                            "type": "boolean"
+                        },
+                        {
+                            "name": "sessionId",
+                            "description": "The session ID this event is associated with. May not be populated for\nfailed events.",
+                            "optional": true,
+                            "type": "string"
+                        },
+                        {
+                            "name": "creationEventDetails",
+                            "description": "The below are the different session event type details. Exactly one is populated.",
+                            "optional": true,
+                            "$ref": "CreationEventDetails"
+                        },
+                        {
+                            "name": "refreshEventDetails",
+                            "optional": true,
+                            "$ref": "RefreshEventDetails"
+                        },
+                        {
+                            "name": "terminationEventDetails",
+                            "optional": true,
+                            "$ref": "TerminationEventDetails"
+                        },
+                        {
+                            "name": "challengeEventDetails",
+                            "optional": true,
+                            "$ref": "ChallengeEventDetails"
+                        }
+                    ]
                 }
             ]
         },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "devtools-protocol",
-  "version": "0.0.1565416",
+  "version": "0.0.1566079",
   "description": "The Chrome DevTools Protocol JSON",
   "repository": "https://github.com/ChromeDevTools/devtools-protocol",
   "author": "The Chromium Authors",

package/pdl/domains/Network.pdl

@@ -2123,12 +2123,161 @@ domain Network
       # See comments on `net::device_bound_sessions::Session::allowed_refresh_initiators_`.
       array of string allowedRefreshInitiators
 
+  # A unique identifier for a device bound session event.
+  experimental type DeviceBoundSessionEventId extends string
+
+  # A fetch result for a device bound session creation or refresh.
+  experimental type DeviceBoundSessionFetchResult extends string
+    enum
+      Success
+      KeyError
+      SigningError
+      ServerRequestedTermination
+      InvalidSessionId
+      InvalidChallenge
+      TooManyChallenges
+      InvalidFetcherUrl
+      InvalidRefreshUrl
+      TransientHttpError
+      ScopeOriginSameSiteMismatch
+      RefreshUrlSameSiteMismatch
+      MismatchedSessionId
+      MissingScope
+      NoCredentials
+      SubdomainRegistrationWellKnownUnavailable
+      SubdomainRegistrationUnauthorized
+      SubdomainRegistrationWellKnownMalformed
+      SessionProviderWellKnownUnavailable
+      RelyingPartyWellKnownUnavailable
+      FederatedKeyThumbprintMismatch
+      InvalidFederatedSessionUrl
+      InvalidFederatedKey
+      TooManyRelyingOriginLabels
+      BoundCookieSetForbidden
+      NetError
+      ProxyError
+      EmptySessionConfig
+      InvalidCredentialsConfig
+      InvalidCredentialsType
+      InvalidCredentialsEmptyName
+      InvalidCredentialsCookie
+      PersistentHttpError
+      RegistrationAttemptedChallenge
+      InvalidScopeOrigin
+      ScopeOriginContainsPath
+      RefreshInitiatorNotString
+      RefreshInitiatorInvalidHostPattern
+      InvalidScopeSpecification
+      MissingScopeSpecificationType
+      EmptyScopeSpecificationDomain
+      EmptyScopeSpecificationPath
+      InvalidScopeSpecificationType
+      InvalidScopeIncludeSite
+      MissingScopeIncludeSite
+      FederatedNotAuthorizedByProvider
+      FederatedNotAuthorizedByRelyingParty
+      SessionProviderWellKnownMalformed
+      SessionProviderWellKnownHasProviderOrigin
+      RelyingPartyWellKnownMalformed
+      RelyingPartyWellKnownHasRelyingOrigins
+      InvalidFederatedSessionProviderSessionMissing
+      InvalidFederatedSessionWrongProviderOrigin
+      InvalidCredentialsCookieCreationTime
+      InvalidCredentialsCookieName
+      InvalidCredentialsCookieParsing
+      InvalidCredentialsCookieUnpermittedAttribute
+      InvalidCredentialsCookieInvalidDomain
+      InvalidCredentialsCookiePrefix
+      InvalidScopeRulePath
+      InvalidScopeRuleHostPattern
+      ScopeRuleOriginScopedHostPatternMismatch
+      ScopeRuleSiteScopedHostPatternMismatch
+      SigningQuotaExceeded
+      InvalidConfigJson
+      InvalidFederatedSessionProviderFailedToRestoreKey
+      FailedToUnwrapKey
+      SessionDeletedDuringRefresh
+
+  # Session event details specific to creation.
+  experimental type CreationEventDetails extends object
+    properties
+      # The result of the fetch attempt.
+      DeviceBoundSessionFetchResult fetchResult
+      # The session if there was a newly created session. This is populated for
+      # all successful creation events.
+      optional DeviceBoundSession newSession
+
+  # Session event details specific to refresh.
+  experimental type RefreshEventDetails extends object
+    properties
+      # The result of a refresh.
+      enum refreshResult
+        Refreshed
+        InitializedService
+        Unreachable
+        ServerError
+        RefreshQuotaExceeded
+        FatalError
+        SigningQuotaExceeded
+      # If there was a fetch attempt, the result of that.
+      optional DeviceBoundSessionFetchResult fetchResult
+      # The session display if there was a newly created session. This is populated
+      # for any refresh event that modifies the session config.
+      optional DeviceBoundSession newSession
+      # See comments on `net::device_bound_sessions::RefreshEventResult::was_fully_proactive_refresh`.
+      boolean wasFullyProactiveRefresh
+
+  # Session event details specific to termination.
+  experimental type TerminationEventDetails extends object
+    properties
+      # The reason for a session being deleted.
+      enum deletionReason
+        Expired
+        FailedToRestoreKey
+        FailedToUnwrapKey
+        StoragePartitionCleared
+        ClearBrowsingData
+        ServerRequested
+        InvalidSessionParams
+        RefreshFatalError
+
+  # Session event details specific to challenges.
+  experimental type ChallengeEventDetails extends object
+    properties
+      # The result of a challenge.
+      enum challengeResult
+        Success
+        NoSessionId
+        NoSessionMatch
+        CantSetBoundCookie
+      # The challenge set.
+      string challenge
+
   # Triggered when the initial set of device bound sessions is added.
   experimental event deviceBoundSessionsAdded
     parameters
       # The device bound sessions.
       array of DeviceBoundSession sessions
 
+  # Triggered when a device bound session event occurs.
+  experimental event deviceBoundSessionEventOccurred
+    parameters
+      # A unique identifier for this session event.
+      DeviceBoundSessionEventId eventId
+      # The site this session event is associated with.
+      string site
+      # Whether this event was considered successful.
+      boolean succeeded
+      # The session ID this event is associated with. May not be populated for
+      # failed events.
+      optional string sessionId
+
+      # The below are the different session event type details. Exactly one is populated.
+      optional CreationEventDetails creationEventDetails
+      optional RefreshEventDetails refreshEventDetails
+      optional TerminationEventDetails terminationEventDetails
+      optional ChallengeEventDetails challengeEventDetails
+
   # Sets up tracking device bound sessions and fetching of initial set of sessions.
   experimental command enableDeviceBoundSessions
     parameters

package/types/protocol-mapping.d.ts

@@ -587,6 +587,11 @@ export namespace ProtocolMapping {
          * @experimental
          */
         'Network.deviceBoundSessionsAdded': [Protocol.Network.DeviceBoundSessionsAddedEvent];
+        /**
+         * Triggered when a device bound session event occurs.
+         * @experimental
+         */
+        'Network.deviceBoundSessionEventOccurred': [Protocol.Network.DeviceBoundSessionEventOccurredEvent];
         /**
          * Fired when the node should be inspected. This happens after call to `setInspectMode` or when
          * user manually inspects an element.

package/types/protocol-proxy-api.d.ts

@@ -3469,6 +3469,12 @@ export namespace ProtocolProxyApi {
          */
         on(event: 'deviceBoundSessionsAdded', listener: (params: Protocol.Network.DeviceBoundSessionsAddedEvent) => void): void;
 
+        /**
+         * Triggered when a device bound session event occurs.
+         * @experimental
+         */
+        on(event: 'deviceBoundSessionEventOccurred', listener: (params: Protocol.Network.DeviceBoundSessionEventOccurredEvent) => void): void;
+
     }
 
     export interface OverlayApi {

package/types/protocol-tests-proxy-api.d.ts

@@ -3727,6 +3727,14 @@ export namespace ProtocolTestsProxyApi {
         offDeviceBoundSessionsAdded(listener: (event: { params: Protocol.Network.DeviceBoundSessionsAddedEvent }) => void): void;
         onceDeviceBoundSessionsAdded(eventMatcher?: (event: { params: Protocol.Network.DeviceBoundSessionsAddedEvent }) => boolean): Promise<{ params: Protocol.Network.DeviceBoundSessionsAddedEvent }>;
 
+        /**
+         * Triggered when a device bound session event occurs.
+         * @experimental
+         */
+        onDeviceBoundSessionEventOccurred(listener: (event: { params: Protocol.Network.DeviceBoundSessionEventOccurredEvent }) => void): void;
+        offDeviceBoundSessionEventOccurred(listener: (event: { params: Protocol.Network.DeviceBoundSessionEventOccurredEvent }) => void): void;
+        onceDeviceBoundSessionEventOccurred(eventMatcher?: (event: { params: Protocol.Network.DeviceBoundSessionEventOccurredEvent }) => boolean): Promise<{ params: Protocol.Network.DeviceBoundSessionEventOccurredEvent }>;
+
     }
 
     export interface OverlayApi {

package/types/protocol.d.ts

@@ -13666,6 +13666,112 @@ export namespace Protocol {
             allowedRefreshInitiators: string[];
         }
 
+        /**
+         * A unique identifier for a device bound session event.
+         * @experimental
+         */
+        export type DeviceBoundSessionEventId = string;
+
+        /**
+         * A fetch result for a device bound session creation or refresh.
+         * @experimental
+         */
+        export type DeviceBoundSessionFetchResult = ('Success' | 'KeyError' | 'SigningError' | 'ServerRequestedTermination' | 'InvalidSessionId' | 'InvalidChallenge' | 'TooManyChallenges' | 'InvalidFetcherUrl' | 'InvalidRefreshUrl' | 'TransientHttpError' | 'ScopeOriginSameSiteMismatch' | 'RefreshUrlSameSiteMismatch' | 'MismatchedSessionId' | 'MissingScope' | 'NoCredentials' | 'SubdomainRegistrationWellKnownUnavailable' | 'SubdomainRegistrationUnauthorized' | 'SubdomainRegistrationWellKnownMalformed' | 'SessionProviderWellKnownUnavailable' | 'RelyingPartyWellKnownUnavailable' | 'FederatedKeyThumbprintMismatch' | 'InvalidFederatedSessionUrl' | 'InvalidFederatedKey' | 'TooManyRelyingOriginLabels' | 'BoundCookieSetForbidden' | 'NetError' | 'ProxyError' | 'EmptySessionConfig' | 'InvalidCredentialsConfig' | 'InvalidCredentialsType' | 'InvalidCredentialsEmptyName' | 'InvalidCredentialsCookie' | 'PersistentHttpError' | 'RegistrationAttemptedChallenge' | 'InvalidScopeOrigin' | 'ScopeOriginContainsPath' | 'RefreshInitiatorNotString' | 'RefreshInitiatorInvalidHostPattern' | 'InvalidScopeSpecification' | 'MissingScopeSpecificationType' | 'EmptyScopeSpecificationDomain' | 'EmptyScopeSpecificationPath' | 'InvalidScopeSpecificationType' | 'InvalidScopeIncludeSite' | 'MissingScopeIncludeSite' | 'FederatedNotAuthorizedByProvider' | 'FederatedNotAuthorizedByRelyingParty' | 'SessionProviderWellKnownMalformed' | 'SessionProviderWellKnownHasProviderOrigin' | 'RelyingPartyWellKnownMalformed' | 'RelyingPartyWellKnownHasRelyingOrigins' | 'InvalidFederatedSessionProviderSessionMissing' | 'InvalidFederatedSessionWrongProviderOrigin' | 'InvalidCredentialsCookieCreationTime' | 'InvalidCredentialsCookieName' | 'InvalidCredentialsCookieParsing' | 'InvalidCredentialsCookieUnpermittedAttribute' | 'InvalidCredentialsCookieInvalidDomain' | 'InvalidCredentialsCookiePrefix' | 'InvalidScopeRulePath' | 'InvalidScopeRuleHostPattern' | 'ScopeRuleOriginScopedHostPatternMismatch' | 'ScopeRuleSiteScopedHostPatternMismatch' | 'SigningQuotaExceeded' | 'InvalidConfigJson' | 'InvalidFederatedSessionProviderFailedToRestoreKey' | 'FailedToUnwrapKey' | 'SessionDeletedDuringRefresh');
+
+        /**
+         * Session event details specific to creation.
+         * @experimental
+         */
+        export interface CreationEventDetails {
+            /**
+             * The result of the fetch attempt.
+             */
+            fetchResult: DeviceBoundSessionFetchResult;
+            /**
+             * The session if there was a newly created session. This is populated for
+             * all successful creation events.
+             */
+            newSession?: DeviceBoundSession;
+        }
+
+        export const enum RefreshEventDetailsRefreshResult {
+            Refreshed = 'Refreshed',
+            InitializedService = 'InitializedService',
+            Unreachable = 'Unreachable',
+            ServerError = 'ServerError',
+            RefreshQuotaExceeded = 'RefreshQuotaExceeded',
+            FatalError = 'FatalError',
+            SigningQuotaExceeded = 'SigningQuotaExceeded',
+        }
+
+        /**
+         * Session event details specific to refresh.
+         * @experimental
+         */
+        export interface RefreshEventDetails {
+            /**
+             * The result of a refresh.
+             */
+            refreshResult: ('Refreshed' | 'InitializedService' | 'Unreachable' | 'ServerError' | 'RefreshQuotaExceeded' | 'FatalError' | 'SigningQuotaExceeded');
+            /**
+             * If there was a fetch attempt, the result of that.
+             */
+            fetchResult?: DeviceBoundSessionFetchResult;
+            /**
+             * The session display if there was a newly created session. This is populated
+             * for any refresh event that modifies the session config.
+             */
+            newSession?: DeviceBoundSession;
+            /**
+             * See comments on `net::device_bound_sessions::RefreshEventResult::was_fully_proactive_refresh`.
+             */
+            wasFullyProactiveRefresh: boolean;
+        }
+
+        export const enum TerminationEventDetailsDeletionReason {
+            Expired = 'Expired',
+            FailedToRestoreKey = 'FailedToRestoreKey',
+            FailedToUnwrapKey = 'FailedToUnwrapKey',
+            StoragePartitionCleared = 'StoragePartitionCleared',
+            ClearBrowsingData = 'ClearBrowsingData',
+            ServerRequested = 'ServerRequested',
+            InvalidSessionParams = 'InvalidSessionParams',
+            RefreshFatalError = 'RefreshFatalError',
+        }
+
+        /**
+         * Session event details specific to termination.
+         * @experimental
+         */
+        export interface TerminationEventDetails {
+            /**
+             * The reason for a session being deleted.
+             */
+            deletionReason: ('Expired' | 'FailedToRestoreKey' | 'FailedToUnwrapKey' | 'StoragePartitionCleared' | 'ClearBrowsingData' | 'ServerRequested' | 'InvalidSessionParams' | 'RefreshFatalError');
+        }
+
+        export const enum ChallengeEventDetailsChallengeResult {
+            Success = 'Success',
+            NoSessionId = 'NoSessionId',
+            NoSessionMatch = 'NoSessionMatch',
+            CantSetBoundCookie = 'CantSetBoundCookie',
+        }
+
+        /**
+         * Session event details specific to challenges.
+         * @experimental
+         */
+        export interface ChallengeEventDetails {
+            /**
+             * The result of a challenge.
+             */
+            challengeResult: ('Success' | 'NoSessionId' | 'NoSessionMatch' | 'CantSetBoundCookie');
+            /**
+             * The challenge set.
+             */
+            challenge: string;
+        }
+
         /**
          * An object providing the result of a network resource load.
          * @experimental
@@ -15125,6 +15231,37 @@ export namespace Protocol {
              */
             sessions: DeviceBoundSession[];
         }
+
+        /**
+         * Triggered when a device bound session event occurs.
+         * @experimental
+         */
+        export interface DeviceBoundSessionEventOccurredEvent {
+            /**
+             * A unique identifier for this session event.
+             */
+            eventId: DeviceBoundSessionEventId;
+            /**
+             * The site this session event is associated with.
+             */
+            site: string;
+            /**
+             * Whether this event was considered successful.
+             */
+            succeeded: boolean;
+            /**
+             * The session ID this event is associated with. May not be populated for
+             * failed events.
+             */
+            sessionId?: string;
+            /**
+             * The below are the different session event type details. Exactly one is populated.
+             */
+            creationEventDetails?: CreationEventDetails;
+            refreshEventDetails?: RefreshEventDetails;
+            terminationEventDetails?: TerminationEventDetails;
+            challengeEventDetails?: ChallengeEventDetails;
+        }
     }
 
     /**