cmd.service.md

CMDService

The CMD service lets you command child processes in Node.js (using the graphscript-node dist). It's a pretty straightforward process, you provide routes with commands and arguments as they fit into normal child process callbacks.

See services/cmd/childproces.js for a boilerplate node process you can run that sets up a CMDService to enable cross-process message passing by listening to process.stdin the same way other message passing services listen, including all of the helpful utilities like running functions or subscribing across processes.

type CMDRoute = {
   command:string|ChildProcess,
   args?:string[],
   options?:{shell:true, stdio:'inherit',[key:string]:any},
   env?:any,
   cwd?:any,
   signal?:any,
   stdout?:(data:any)=>void,
   onerror?:(error:Error)=>void,
   onclose?:(code: number | null, signal: NodeJS.Signals | null)=>void
} & GraphNodeProperties

type CMDInfo = {
   process:ChildProcess,
   _id:string,
   controller:AbortController,
   send:(data:Serializable)=>boolean,
   request:(message:ServiceMessage|any, method?:string) => Promise<any>,
   post:(route:string, args:any, method?:string) => boolean,
   run:(route:any, args?:any, method?:string) => Promise<any>,
   subscribe:(route:any, callback?:((res:any)=>void)|string) => number,
   unsubscribe:(route:any, sub:number) => Promise<boolean>
} & CMDRoute


import { CMDService } from "./CMD.node";
import { remoteGraphRoutes } from '../remote/remote.routes';

const service = new CMDService({
   routes:[remoteGraphRoutes]
}); //now we can send/receive messages

console.log("Child process listening...") 

//....

Then create childprocess.js in your root (for this example)

import { CMDService } from "./CMD.node";
import { remoteGraphRoutes } from '../remote/remote.routes';

const service = new CMDService({
    routes:[remoteGraphRoutes]
}); //now we can send/receive messages

console.log("Child process listening...") 
 

and from your main program, add the following after instantiating a CMDService

//....

 
const p = service.createProcess({
    command:'node',
    args:['childprocess.js']
});

and now you can interact with it nodes across child processes!