chore: stop Protocol types being globally available (#5899)

We should import them just like any other module. This commit makes that
change. It does not change any behaviours or the types themselves.

EXPECTED_PROTOCOL_DIFF as we're updating the structure of it.

src/Accessibility.ts

@@ -14,12 +14,9 @@
  * limitations under the License.
  */
 
-// Used as a TypeDef
-// eslint-disable-next-line no-unused-vars
 import { CDPSession } from './Connection';
-// Used as a TypeDef
-// eslint-disable-next-line no-unused-vars
 import { ElementHandle } from './JSHandle';
+import Protocol from './protocol';
 
 interface SerializedAXNode {
   role: string;

src/Browser.ts

@@ -18,6 +18,7 @@ import { helper, assert } from './helper';
 import { Target } from './Target';
 import * as EventEmitter from 'events';
 import { Events } from './Events';
+import Protocol from './protocol';
 import { Connection } from './Connection';
 import { Page } from './Page';
 import { ChildProcess } from 'child_process';

src/Connection.ts

@@ -18,6 +18,7 @@ import { Events } from './Events';
 import * as debug from 'debug';
 const debugProtocol = debug('puppeteer:protocol');
 
+import Protocol from './protocol';
 import type { ConnectionTransport } from './ConnectionTransport';
 import * as EventEmitter from 'events';
 

src/Coverage.ts

@@ -15,6 +15,7 @@
  */
 
 import { helper, debugError, assert, PuppeteerEventListener } from './helper';
+import Protocol from './protocol';
 import { CDPSession } from './Connection';
 
 import { EVALUATION_SCRIPT_URL } from './ExecutionContext';

src/EmulationManager.ts

@@ -15,6 +15,7 @@
  */
 import { CDPSession } from './Connection';
 import type { Viewport } from './PuppeteerViewport';
+import Protocol from './protocol';
 
 export class EmulationManager {
   _client: CDPSession;

src/ExecutionContext.ts

@@ -19,6 +19,7 @@ import { createJSHandle, JSHandle, ElementHandle } from './JSHandle';
 import { CDPSession } from './Connection';
 import { DOMWorld } from './DOMWorld';
 import { Frame } from './FrameManager';
+import Protocol from './protocol';
 
 export const EVALUATION_SCRIPT_URL = '__puppeteer_evaluation_script__';
 const SOURCE_URL_REGEX = /^[\040\t]*\/\/[@#] sourceURL=\s*(\S*?)\s*$/m;

src/FileChooser.ts

@@ -15,6 +15,7 @@
  */
 
 import { ElementHandle } from './JSHandle';
+import Protocol from './protocol';
 import { assert } from './helper';
 
 export class FileChooser {

src/FrameManager.ts

@@ -27,6 +27,7 @@ import { JSHandle, ElementHandle } from './JSHandle';
 import { MouseButtonInput } from './Input';
 import { Page } from './Page';
 import { Response } from './Response';
+import Protocol from './protocol';
 
 const UTILITY_WORLD_NAME = '__puppeteer_utility_world__';
 

src/JSHandle.ts

@@ -21,6 +21,7 @@ import { CDPSession } from './Connection';
 import { KeyInput } from './USKeyboardLayout';
 import { FrameManager, Frame } from './FrameManager';
 import { getQueryHandlerAndSelector } from './QueryHandler';
+import Protocol from './protocol';
 
 interface BoxModel {
   content: Array<{ x: number; y: number }>;

src/NetworkManager.ts

@@ -15,6 +15,7 @@
  */
 import * as EventEmitter from 'events';
 import { helper, assert, debugError } from './helper';
+import Protocol from './protocol';
 import { Events } from './Events';
 import { CDPSession } from './Connection';
 import { FrameManager } from './FrameManager';

src/Page.ts

@@ -39,6 +39,7 @@ import { TimeoutSettings } from './TimeoutSettings';
 import { FileChooser } from './FileChooser';
 import { ConsoleMessage } from './ConsoleMessage';
 import { PuppeteerLifeCycleEvent } from './LifecycleWatcher';
+import Protocol from './protocol';
 
 const writeFileAsync = helper.promisify(fs.writeFile);
 

src/Request.ts

@@ -17,6 +17,7 @@ import { CDPSession } from './Connection';
 import { Frame } from './FrameManager';
 import { Response } from './Response';
 import { helper, assert, debugError } from './helper';
+import Protocol from './protocol';
 
 export class Request {
   _requestId: string;

src/Response.ts

@@ -17,6 +17,7 @@ import { CDPSession } from './Connection';
 import { Frame } from './FrameManager';
 import { Request } from './Request';
 import { SecurityDetails } from './SecurityDetails';
+import Protocol from './protocol';
 
 interface RemoteAddress {
   ip: string;

src/SecurityDetails.ts

@@ -14,6 +14,8 @@
  * limitations under the License.
  */
 
+import Protocol from './protocol';
+
 export class SecurityDetails {
   private _subjectName: string;
   private _issuer: string;

src/Target.ts

@@ -20,6 +20,7 @@ import { Worker as PuppeteerWorker } from './Worker';
 import { CDPSession } from './Connection';
 import { Browser, BrowserContext } from './Browser';
 import type { Viewport } from './PuppeteerViewport';
+import Protocol from './protocol';
 
 export class Target {
   _targetInfo: Protocol.Target.TargetInfo;

src/Worker.ts

@@ -18,6 +18,7 @@ import { debugError } from './helper';
 import { ExecutionContext } from './ExecutionContext';
 import { JSHandle } from './JSHandle';
 import { CDPSession } from './Connection';
+import Protocol from './protocol';
 
 type ConsoleAPICalledCallback = (
   eventType: string,

src/helper.ts

@@ -18,6 +18,7 @@ import * as debug from 'debug';
 import * as fs from 'fs';
 import { CDPSession } from './Connection';
 import { promisify } from 'util';
+import Protocol from './protocol';
 
 const openAsync = promisify(fs.open);
 const writeAsync = promisify(fs.write);

src/protocol.d.ts

@@ -1,7 +1,7 @@
 // This is generated from /utils/protocol-types-generator/index.js
 type binary = string;
-declare global {
+
-  module Protocol {
+declare module Protocol {
   export module Accessibility {
       /**
        * Unique accessibility node identifier.
@@ -15499,6 +15499,4 @@ unsubscribes current runtime agent from Runtime.bindingCalled notifications.
     "Schema.getDomains": Schema.getDomainsReturnValue;
   }
 }
-}
-
 export default Protocol;

utils/protocol-types-generator/index.js

@@ -1,6 +1,7 @@
 // @ts-check
 const path = require('path');
 const puppeteer = require('../..');
+const { execSync } = require('child_process');
 
 const fetchAndGenerateProtocolDefinitions = () =>
   puppeteer
@@ -21,8 +22,8 @@ const fetchAndGenerateProtocolDefinitions = () =>
       await browser.close();
       const output = `// This is generated from /utils/protocol-types-generator/index.js
   type binary = string;
-declare global {
+
-  module Protocol {${json.domains
+declare module Protocol {${json.domains
         .map(
           (domain) => `${
             domain.description
@@ -182,7 +183,6 @@ declare global {
       .join('')}
     }
   }
-}
 
 export default Protocol;
 `;
@@ -204,8 +204,13 @@ const writeOutputToDisk = ({ output, version }) => {
   console.log(`You should commit the changes.`);
 };
 
+const lastCommitMessage = () => {
+  return execSync('git log --no-merges -n 1', { encoding: 'utf8' });
+};
+
 const cli = async () => {
   const scriptToRun = process.argv[2];
+  const changeExpected = lastCommitMessage().includes('EXPECTED_PROTOCOL_DIFF');
 
   if (scriptToRun === 'update') {
     writeOutputToDisk(await fetchAndGenerateProtocolDefinitions());
@@ -216,6 +221,12 @@ const cli = async () => {
     });
     if (output === outputOnDisk) {
       console.log(`Success: ${relativeProtocolOutputPath} is up to date.`);
+    } else if (changeExpected) {
+      console.log(`Warning: ${relativeProtocolOutputPath} is out of date`);
+
+      console.log(
+        '  continuing because EXPECTED_PROTOCOL_DIFF was found in the last commit message.'
+      );
     } else {
       console.log(`Error: ${relativeProtocolOutputPath} is out of date.`);
       console.log(