typings: add JSDoc typings for inspector

Added JSDoc typings for the `inspector` lib module.

PR-URL: #38390
Reviewed-By: James M Snell <[email protected]>
Reviewed-By: Adrian Estrada <[email protected]>
Reviewed-By: Rich Trott <[email protected]>
Reviewed-By: Michaël Zasso <[email protected]>

lib/inspector.js

@@ -53,13 +53,22 @@ class Session extends EventEmitter {
     this[messageCallbacksSymbol] = new SafeMap();
   }
 
+  /**
+   * Connects the session to the inspector back-end.
+   * @returns {void}
+   */
   connect() {
     if (this[connectionSymbol])
       throw new ERR_INSPECTOR_ALREADY_CONNECTED('The inspector session');
     this[connectionSymbol] =
       new Connection((message) => this[onMessageSymbol](message));
   }
 
+  /**
+   * Connects the session to the main thread
+   * inspector back-end.
+   * @returns {void}
+   */
   connectToMainThread() {
     if (isMainThread)
       throw new ERR_INSPECTOR_NOT_WORKER();
@@ -93,6 +102,13 @@ class Session extends EventEmitter {
     }
   }
 
+  /**
+   * Posts a message to the inspector back-end.
+   * @param {string} method
+   * @param {Record<unknown, unknown>} [params]
+   * @param {Function} [callback]
+   * @returns {void}
+   */
   post(method, params, callback) {
     validateString(method, 'method');
     if (!callback && typeof params === 'function') {
@@ -120,6 +136,12 @@ class Session extends EventEmitter {
     this[connectionSymbol].dispatch(JSONStringify(message));
   }
 
+  /**
+   * Immediately closes the session, all pending
+   * message callbacks will be called with an
+   * error.
+   * @returns {void}
+   */
   disconnect() {
     if (!this[connectionSymbol])
       return;
@@ -134,6 +156,13 @@ class Session extends EventEmitter {
   }
 }
 
+/**
+ * Activates inspector on host and port.
+ * @param {number} [port]
+ * @param {string} [host]
+ * @param {boolean} [wait]
+ * @returns {void}
+ */
 function inspectorOpen(port, host, wait) {
   if (isEnabled()) {
     throw new ERR_INSPECTOR_ALREADY_ACTIVATED();
@@ -143,6 +172,12 @@ function inspectorOpen(port, host, wait) {
     waitForDebugger();
 }
 
+/**
+ * Blocks until a client (existing or connected later)
+ * has sent the `Runtime.runIfWaitingForDebugger`
+ * command.
+ * @returns {void}
+ */
 function inspectorWaitForDebugger() {
   if (!waitForDebugger())
     throw new ERR_INSPECTOR_NOT_ACTIVE();
@@ -151,7 +186,7 @@ function inspectorWaitForDebugger() {
 module.exports = {
   open: inspectorOpen,
   close: process._debugEnd,
-  url: url,
+  url,
   waitForDebugger: inspectorWaitForDebugger,
   // This is dynamically added during bootstrap,
   // where the console from the VM is still available