Added wrapper

API_js/WebConsoleAPI.js

@@ -0,0 +1,103 @@
+/**
+ WebConsole API for WebConsole
+ Used to manage active connections
+ https://github.com/mesacarlos
+ 2019-2020 Carlos Mesa under MIT License.
+*/
+class WebConsoleAPI {
+	constructor(serverURI){
+		this.activeConnection = new WebConsoleConnector(serverURI);
+		this.activeConnection.subscribe(this.onMsg);
+		this.activeConnection.connect();
+	}
+	
+	/**
+	* Send password to server
+	*/
+	login(pwd){
+		this.activeConnection.sendToServer({
+			command: "LOGIN",
+			params: pwd
+		});
+	}
+	
+	/**
+	* Send console command to server
+	*/
+	sendConsoleCmd(cmd){
+		this.activeConnection.sendToServer({
+			command: "EXEC",
+			token: this.activeConnection.token,
+			params: cmd
+		});
+
+		this.activeConnection.commands.push(cmd);
+	}
+	
+	/**
+	* Asks server for CPU, RAM and players info
+	*/
+	askForInfo(){
+		this.activeConnection.sendToServer({
+			command: "PLAYERS",
+			token: this.activeConnection.token,
+		});
+
+		this.activeConnection.sendToServer({
+			command: "CPUUSAGE",
+			token: this.activeConnection.token,
+		});
+
+		this.activeConnection.sendToServer({
+			command: "RAMUSAGE",
+			token: this.activeConnection.token,
+		});
+	}
+
+	/**
+	* Asks server for full latest.log
+	*/
+	askForLogs(){
+		this.activeConnection.sendToServer({
+			command: "READLOGFILE",
+			token: this.activeConnection.token,
+		});
+	}
+	
+	/**
+	* This function is executed when a message is received from the server
+	*/
+	onMsg(message){
+		//Print JSON to console. You may remove this line:
+		console.log(message);
+		
+		//Type your code inside the switch cases:
+		switch (message.status) {
+			case 10:
+				//Console Output
+				//Info: The weird characters you probably get are the color indicators. Check the link below to learn how the official client parses them
+				//https://github.com/mesacarlos/WebConsole/blob/383b0e3420a948a61c7935ff84f40ff159fbd466/client/scripts/WebConsole.js#L128
+				break;
+			case 200:
+				//LoggedIn
+				break;
+			case 400:
+				//Unknown Command
+				break;
+			case 401:
+				//Waiting for login...
+				break;
+			case 1000:
+				//Connected players info
+				break;
+			case 1001:
+				//Cpu Usage info
+				break;
+			case 1002:
+				//RAM Usage info
+				break;
+			default:
+				console.log('Unknown server response:');
+		}
+	}
+}

API_js/WebConsoleConnector.js

@@ -0,0 +1,96 @@
+/**
+ WebConsole Connector for WebConsole
+ Used to connect to WebSocketsServer
+ https://github.com/mesacarlos
+ 2019-2020 Carlos Mesa under MIT License.
+*/
+class WebConsoleConnector {
+	
+	constructor(serverURI) {
+		this.serverURI = serverURI;
+		this.token;
+		this.subscribers = []; //List of functions called when a new message arrive
+		this.messages = []; //All messages retrieved since connection start
+		this.commands = []; //EXEC Commands sent by user to this server
+		this.isLogged = false; //Is logged in with valid pasword or not
+	}
+	
+	/**
+	* Connect to WebSocket
+	*/
+	connect(){
+		var connector = this;
+		this.websocket = new WebSocket(this.serverURI);
+		this.websocket.onopen = function(evt) { connector.onOpen(evt) };
+		this.websocket.onclose = function(evt) { connector.onClose(evt) };
+		this.websocket.onmessage = function(evt) { connector.onMessage(evt) };
+		this.websocket.onerror = function(evt) { connector.onError(evt) };
+	}
+	
+	/**
+	* Internal function
+	*/
+	onOpen(evt){
+		//Event: Connection opened
+	}
+	
+	/**
+	* Internal function
+	*/
+	onClose(evt){
+		console.log("Closed reason: " + evt.reason); //No reason provided (using chrome at least)
+	}
+	
+	/**
+	* Internal function
+	*/
+	onMessage(evt){
+		var obj = JSON.parse(evt.data);
+		
+		//Sucessfully connected? Save token
+		if(obj.status === 200){
+			this.token = obj.token;
+			this.isLogged = true;
+		}
+		
+		this.notify(obj); //Notify all subscribers
+		this.messages.push(obj);
+	}
+	
+	/**
+	* Internal function
+	*/
+	onError(evt){
+		//Error occurred on the connection
+	}
+	
+	/**
+	* Notifies a new message to all subscribers
+	*/
+	notify(obj){
+		this.subscribers.forEach(function(fun) {
+			fun(obj); //Calls function with this object
+		});
+	}
+	
+	/**
+	* Sends a WebSocket command to Server
+	*/
+	sendToServer(message){
+		this.websocket.send(JSON.stringify(message));
+	}
+	
+	/**
+	* Adds a function to subscriber list
+	*/
+	subscribe(func){
+		this.subscribers.push(func);
+	}
+	
+	/**
+	* Unsubscribe all subscribers
+	*/
+	removeSubscribers(){
+		this.subscribers = [];
+	}
+}

API_js/demo.html

@@ -0,0 +1,13 @@
+<!DOCTYPE html>
+<html>
+<head>
+	<script src="WebConsoleAPI.js"></script>
+	<script src="WebConsoleConnector.js"></script>
+</head>
+<body>
+	<h1>API demo</h1>
+	<p>Open your console (F12) and type: var webconsoleapi = new WebConsoleAPI("ws://localhost:8080");</p>
+	<p>Replace ws:// with wss:// if your server have SSL enabled, localhost with your server IP and 8080 with your port.</p>
+	<p>Then call login(pwd) to login, sendConsoleCmd(cmd) to execute a command, etc...</p>
+</body>
+</html>