node-appctl

NodeJS IPC Tool

Command Format

This package provides simple process intercommunication mechanism via TCP or IPC. Communication performed using JSON commands:

{
  "command": "getSomeValue",
  "data": {}
}

Where command is the command name, and data is the command payload (optional).

Server

const appctl = require('node-appctl');

// For TCP connection:
const server = appctl.createServer({
    port: 4000,
    host: 'localhost'
});

// -OR- For IPC connection:
const server = appctl.createServer({
    path: '/path/to/appctl.sock'
});

server.register('exampleCommand', (data) => {
    // `data` -- is the optional command payload...
    // You can either return sync response, or Promise object.
    // The returned value should be JSON serializable.
});

// Now the server is listening for the `getSomeValue` command,
// and will send registered function response to the client.

Client

const appctl = require('node-appctl');

// For TCP connection:
const client = appctl.createClient({
    port: 4000
});

// -OR- For IPC connection:
const client = appctl.createClient({
    path: '/path/to/appctl.sock'
});

client.emit('exampleCommand', {hello: 'World'})
    .then((res) => {
        // ...
    })
    .catch((err) => console.error(err));