CommandSocket - JS Core
A note about development progress...
The CommandSocket framework is functional, but nevertheless still in its infancy. While the basic functionality should work as documented, bugs are still likely.
Table of Contents
Install from NPM with
$ npm install --save @command-socket/core
- A centralized server which can spin up individual CommandSockets in connection with any number of clients.
- A CommandSocket client that can be used in the browser.
- A CommandSocket client that can be used in a NodeJS environment.
Each of these packages provides a specific part of the total framework of the CommandSocket system.
Begin by spinning up a CommandSocket server (see Related Packages if you are unsure where to find this).
// ### SERVER SIDE ### //;;;
Then, in your choice of environment, create a client and point it to the location of the server that you've just started. Don't worry about which environment you're starting the client in (browser or NodeJS), both implementations expose the exact same functionality.
// ### CLIENT SIDE ### //;// OR;;;;;
And voilà! You have a connected server-client pair!
The client also exposes
on open and
on close events, so you can perform any desired action when such an event occurs, for example: logging it to the console.
// ### CLIENT SIDE ### //client.getEvents.OPEN.subscribeconsole.log"Socket successfully connected!";client.getEvents.CLOSE.subscribeconsole.log"Socket closed.";
Now that you have this connected pair, you can invoke a command on the server from the client. In this example, we'll use one of the built-in commands that comes packaged with the CommandSocket framework.
// ### CLIENT SIDE ### //;;console.log"Connected Socket IP: " + identity.ip;console.log"Connected Socket ID: " + identity.id;// If the above `client.invoke(...) call causes an compile error within// TypeScript, you may have to specify 'undefined' as the second argument.// This is due to the way that the type-checking system requires a value// to be passed even though the parameter's type is 'void'.
Note that it is also just as easy to invoke a command on the client from the server!
After all is said and done, remember to close the server when you are done with it.
// ### SERVER SIDE ### //server.close;
See the wiki for full documentation.
@command-socket/core is made available under the GNU General Public License v3.
Copyright (C) 2019 Trevor Sears