typings: add JSDoc typings for inspector

Added JSDoc typings for the `inspector` lib module.
PR-URL: #38390
Reviewed-By: James M Snell <jasnell@gmail.com>
Reviewed-By: Adrian Estrada <edsadr@gmail.com>
Reviewed-By: Rich Trott <rtrott@gmail.com>
Reviewed-By: Michaël Zasso <targos@protonmail.com>

Author: VoltrexKeyva

lib/inspector.js

@@ -53,13 +53,22 @@ class Session extends EventEmitter {
 this[messageCallbacksSymbol]=newSafeMap();
 }
 
+/**
+ * Connects the session to the inspector back-end.
+ * @returns {void}
+ */
 connect(){
 if(this[connectionSymbol])
 thrownewERR_INSPECTOR_ALREADY_CONNECTED('The inspector session');
 this[connectionSymbol]=
 newConnection((message)=>this[onMessageSymbol](message));
 }
 
+/**
+ * Connects the session to the main thread
+ * inspector back-end.
+ * @returns {void}
+ */
 connectToMainThread(){
 if(isMainThread)
 thrownewERR_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&&typeofparams==='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}
+ */
 functioninspectorOpen(port,host,wait){
 if(isEnabled()){
 thrownewERR_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}
+ */
 functioninspectorWaitForDebugger(){
 if(!waitForDebugger())
 thrownewERR_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