devtools-protocol 0.0.1702366 → 0.0.1704684

package/README.md

@@ -9,3 +9,23 @@ Use the [protocol viewer](https://chromedevtools.github.io/devtools-protocol/) f
 TypeScript definitions for the protocol's types are available in ['types/protocol.d.ts'](https://github.com/ChromeDevTools/devtools-protocol/tree/master/types). Mappings from Commands and events to these types are available in either generated `DomainApi` style in [`types/protocol-proxy-api.d.ts`](https://github.com/ChromeDevTools/devtools-protocol/blob/master/types/protocol-proxy-api.d.ts) or in simple name-to-type-interface style in [`types/protocol-mapping.d.ts`](https://github.com/ChromeDevTools/devtools-protocol/blob/master/types/protocol-mapping.d.ts).
 
 Also, this repo is published as the [`devtools-protocol`](https://www.npmjs.com/package/devtools-protocol) npm module.
+
+## Development
+
+The `.pdl` files, the `json/` files and the TypeScript definitions in `types/`
+are all generated by [`scripts/update-to-latest.sh`](scripts/update-to-latest.sh),
+which runs daily. Do not edit them by hand.
+
+The TypeScript generator itself lives in Chromium, at
+[`//third_party/blink/public/devtools_protocol/scripts/protocol_dts_generator.ts`](https://source.chromium.org/chromium/chromium/src/+/main:third_party/blink/public/devtools_protocol/scripts/protocol_dts_generator.ts),
+so that Chromium and this repo share a single source of truth. It is fetched
+into `tmp/chromium/` by the sparse checkout in `update-to-latest.sh`. Changes to
+the generator should be made in Chromium.
+
+To regenerate `types/` against an existing local Chromium checkout:
+
+```sh
+cd scripts
+CHROMIUM_PROTOCOL_SCRIPTS_DIR=/path/to/src/third_party/blink/public/devtools_protocol/scripts \
+  npm run build-protocol-dts
+```

package/json/browser_protocol.json

@@ -22571,6 +22571,12 @@
                             "description": "Frame swap timestamp.",
                             "optional": true,
                             "$ref": "Network.TimeSinceEpoch"
+                        },
+                        {
+                            "name": "monotonicTimestamp",
+                            "description": "Frame swap timestamp as monotonic time.",
+                            "optional": true,
+                            "$ref": "Network.MonotonicTime"
                         }
                     ]
                 },
@@ -26199,6 +26205,12 @@
                             "name": "status",
                             "$ref": "PreloadingStatus"
                         },
+                        {
+                            "name": "effectiveAction",
+                            "description": "The action currently performed by this attempt. This differs from\n`key.action` after a prerender-until-script attempt is upgraded in place\nto a full prerender.",
+                            "optional": true,
+                            "$ref": "SpeculationAction"
+                        },
                         {
                             "name": "prerenderStatus",
                             "optional": true,
@@ -27815,6 +27827,27 @@
                         }
                     ]
                 },
+                {
+                    "id": "PrivateVerificationTokensIssuerConfig",
+                    "description": "Configuration for a Private Verification Tokens issuer.",
+                    "experimental": true,
+                    "type": "object",
+                    "properties": [
+                        {
+                            "name": "issuerOrigin",
+                            "description": "Origin of the token issuer.",
+                            "type": "string"
+                        },
+                        {
+                            "name": "redeemerOrigins",
+                            "description": "Origins authorized to redeem tokens from this issuer.",
+                            "type": "array",
+                            "items": {
+                                "type": "string"
+                            }
+                        }
+                    ]
+                },
                 {
                     "id": "StorageBucketsDurability",
                     "type": "string",
@@ -28181,6 +28214,20 @@
                         }
                     ]
                 },
+                {
+                    "name": "getPrivateVerificationTokensIssuerConfigs",
+                    "description": "Returns the configured Private Verification Tokens issuers and their redeemer\norigins.",
+                    "experimental": true,
+                    "returns": [
+                        {
+                            "name": "configs",
+                            "type": "array",
+                            "items": {
+                                "$ref": "PrivateVerificationTokensIssuerConfig"
+                            }
+                        }
+                    ]
+                },
                 {
                     "name": "clearPrivateVerificationTokens",
                     "description": "Removes all Private Verification Tokens issued by the provided issuerOrigin.",

package/package.json

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

package/pdl/domains/Page.pdl

@@ -388,6 +388,8 @@ domain Page
       number scrollOffsetY
       # Frame swap timestamp.
       optional Network.TimeSinceEpoch timestamp
+      # Frame swap timestamp as monotonic time.
+      optional Network.MonotonicTime monotonicTimestamp
 
   # Javascript dialog type.
   type DialogType extends string

package/pdl/domains/Preload.pdl

@@ -287,6 +287,10 @@ experimental domain Preload
       PreloadingAttemptKey key
       PreloadPipelineId pipelineId
       PreloadingStatus status
+      # The action currently performed by this attempt. This differs from
+      # `key.action` after a prerender-until-script attempt is upgraded in place
+      # to a full prerender.
+      optional SpeculationAction effectiveAction
       optional PrerenderFinalStatus prerenderStatus
       # This is used to give users more information about the name of Mojo interface
       # that is incompatible with prerender and has caused the cancellation of the attempt.

package/pdl/domains/Storage.pdl

@@ -58,6 +58,14 @@ experimental domain Storage
       # Base64-encoded serialized token.
       string token
 
+  # Configuration for a Private Verification Tokens issuer.
+  experimental type PrivateVerificationTokensIssuerConfig extends object
+    properties
+      # Origin of the token issuer.
+      string issuerOrigin
+      # Origins authorized to redeem tokens from this issuer.
+      array of string redeemerOrigins
+
 
 
   type StorageBucketsDurability extends string
@@ -234,6 +242,12 @@ experimental domain Storage
     returns
       array of PrivateVerificationToken tokens
 
+  # Returns the configured Private Verification Tokens issuers and their redeemer
+  # origins.
+  experimental command getPrivateVerificationTokensIssuerConfigs
+    returns
+      array of PrivateVerificationTokensIssuerConfig configs
+
   # Removes all Private Verification Tokens issued by the provided issuerOrigin.
   experimental command clearPrivateVerificationTokens
     parameters

package/types/protocol-mapping.d.ts

@@ -1,12 +1,12 @@
-// Copyright (c) 2026 The Chromium Authors. All rights reserved.
+// Copyright 2026 The Chromium Authors
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 /**********************************************************************
- * Auto-generated by protocol-dts-generator.ts. Do not edit manually. *
+ * Auto-generated by protocol_dts_generator.ts. Do not edit manually. *
  **********************************************************************/
 
-import Protocol from './protocol'
+import Protocol from './protocol.js'
 
 /**
  * Mappings from protocol event and command names to the types required for them.
@@ -5862,6 +5862,15 @@ export namespace ProtocolMapping {
             paramsType: [];
             returnType: Protocol.Storage.GetPrivateVerificationTokensResponse;
         };
+        /**
+         * Returns the configured Private Verification Tokens issuers and their redeemer
+         * origins.
+         * @experimental
+         */
+        'Storage.getPrivateVerificationTokensIssuerConfigs': {
+            paramsType: [];
+            returnType: Protocol.Storage.GetPrivateVerificationTokensIssuerConfigsResponse;
+        };
         /**
          * Removes all Private Verification Tokens issued by the provided issuerOrigin.
          * @experimental

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

@@ -1,12 +1,12 @@
-// Copyright (c) 2026 The Chromium Authors. All rights reserved.
+// Copyright 2026 The Chromium Authors
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 /**********************************************************************
- * Auto-generated by protocol-dts-generator.ts. Do not edit manually. *
+ * Auto-generated by protocol_dts_generator.ts. Do not edit manually. *
  **********************************************************************/
 
-import Protocol from './protocol'
+import Protocol from './protocol.js'
 
 /**
  * API generated from Protocol commands and events.
@@ -4936,6 +4936,13 @@ export namespace ProtocolProxyApi {
          */
         getPrivateVerificationTokens(): Promise<Protocol.Storage.GetPrivateVerificationTokensResponse>;
 
+        /**
+         * Returns the configured Private Verification Tokens issuers and their redeemer
+         * origins.
+         * @experimental
+         */
+        getPrivateVerificationTokensIssuerConfigs(): Promise<Protocol.Storage.GetPrivateVerificationTokensIssuerConfigsResponse>;
+
         /**
          * Removes all Private Verification Tokens issued by the provided issuerOrigin.
          * @experimental

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

@@ -1,12 +1,12 @@
-// Copyright (c) 2026 The Chromium Authors. All rights reserved.
+// Copyright 2026 The Chromium Authors
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 /**********************************************************************
- * Auto-generated by protocol-dts-generator.ts. Do not edit manually. *
+ * Auto-generated by protocol_dts_generator.ts. Do not edit manually. *
  **********************************************************************/
 
-import Protocol from './protocol'
+import Protocol from './protocol.js'
 
 /**
  * API generated from Protocol commands and events.
@@ -5322,6 +5322,13 @@ export namespace ProtocolTestsProxyApi {
          */
         getPrivateVerificationTokens(): Promise<{id: number, result: Protocol.Storage.GetPrivateVerificationTokensResponse, sessionId: string}>;
 
+        /**
+         * Returns the configured Private Verification Tokens issuers and their redeemer
+         * origins.
+         * @experimental
+         */
+        getPrivateVerificationTokensIssuerConfigs(): Promise<{id: number, result: Protocol.Storage.GetPrivateVerificationTokensIssuerConfigsResponse, sessionId: string}>;
+
         /**
          * Removes all Private Verification Tokens issued by the provided issuerOrigin.
          * @experimental

package/types/protocol.d.ts

@@ -1,9 +1,9 @@
-// Copyright (c) 2026 The Chromium Authors. All rights reserved.
+// Copyright 2026 The Chromium Authors
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 /**********************************************************************
- * Auto-generated by protocol-dts-generator.ts. Do not edit manually. *
+ * Auto-generated by protocol_dts_generator.ts. Do not edit manually. *
  **********************************************************************/
 
 /**
@@ -13,6 +13,7 @@
 export namespace Protocol {
 
     export type integer = number
+    export type binary = string
 
     /**
      * This domain is deprecated - use Runtime or Log instead.
@@ -17129,6 +17130,10 @@ export namespace Protocol {
              * Frame swap timestamp.
              */
             timestamp?: Network.TimeSinceEpoch;
+            /**
+             * Frame swap timestamp as monotonic time.
+             */
+            monotonicTimestamp?: Network.MonotonicTime;
         }
 
         /**
@@ -19336,6 +19341,12 @@ export namespace Protocol {
             key: PreloadingAttemptKey;
             pipelineId: PreloadPipelineId;
             status: PreloadingStatus;
+            /**
+             * The action currently performed by this attempt. This differs from
+             * `key.action` after a prerender-until-script attempt is upgraded in place
+             * to a full prerender.
+             */
+            effectiveAction?: SpeculationAction;
             prerenderStatus?: PrerenderFinalStatus;
             /**
              * This is used to give users more information about the name of Mojo interface
@@ -20206,6 +20217,21 @@ export namespace Protocol {
             token: string;
         }
 
+        /**
+         * Configuration for a Private Verification Tokens issuer.
+         * @experimental
+         */
+        export interface PrivateVerificationTokensIssuerConfig {
+            /**
+             * Origin of the token issuer.
+             */
+            issuerOrigin: string;
+            /**
+             * Origins authorized to redeem tokens from this issuer.
+             */
+            redeemerOrigins: string[];
+        }
+
         export type StorageBucketsDurability = ('relaxed' | 'strict');
 
         export interface StorageBucket {
@@ -20416,6 +20442,10 @@ export namespace Protocol {
             tokens: PrivateVerificationToken[];
         }
 
+        export interface GetPrivateVerificationTokensIssuerConfigsResponse {
+            configs: PrivateVerificationTokensIssuerConfig[];
+        }
+
         export interface ClearPrivateVerificationTokensRequest {
             issuerOrigin: string;
         }