@kastov/node-supervisord 2.0.0

package/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 bramanda48
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,76 @@
+<a name="readme-top"></a>
+
+<div align="center">
+  <a href="https://github.com/bramanda48/node-supervisord">
+    <img src="https://i.ibb.co/z5VT3Br/supervisord.png" alt="Supervisord" width="150px">
+  </a>
+  <h2 align="center">node-supervisord</h2>
+  <div align="center">
+    <p align="center">A Node.js library for communicating with the Supervisord XML-RPC API</p>
+    <div>
+        <a href="https://github.com/bramanda48/node-supervisord/releases/"><img src="https://img.shields.io/github/release/bramanda48/node-supervisord?include_prereleases=&sort=semver&color=blue" alt="GitHub release"></a>
+        <a href="https://github.com/bramanda48/node-supervisord#license"><img src="https://img.shields.io/badge/License-MIT-blue" alt="License"></a>
+    </div>
+  </div>
+</div>
+
+## Installation & Usage
+
+Install node-supervisord using npm:
+
+```bash
+npm install --save node-supervisord
+```
+
+Install node-supervisord using yarn:
+
+```bash
+yarn add node-supervisord
+```
+
+Example usage :
+
+```ts
+import { SupervisordClient } from "node-supervisord";
+
+// Without authentication options
+const client = new SupervisordClient("http://localhost:9001");
+
+// With authentication options
+const client = new SupervisordClient("http://localhost:9001", {
+  username: "your-username",
+  password: "your-passwword",
+});
+
+// Example get api version
+const version = await client.getAPIVersion();
+console.log(version);
+```
+
+To see the available methods, you can visit [http://supervisord.org/api.html](http://supervisord.org/api.html)
+
+## Contributing
+
+If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!
+
+1. Fork the Project
+2. Create your Feature Branch (`git checkout -b feature/AmazingFeature`)
+3. Commit your Changes (`git commit -m 'Add some AmazingFeature'`)
+4. Push to the Branch (`git push origin feature/AmazingFeature`)
+5. Open a Pull Request
+
+## Releasing
+
+1. Go to [Publish Release](https://github.com/bramanda48/node-supervisord/actions/workflows/publish-release.yaml) page, click Run workflow
+2. Fill the vendor version and then run the flow
+3. GitHub Actions will take care of the rest
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE.md](https://github.com/bramanda48/node-supervisord/blob/master/LICENSE.md) file for details.
+
+## Acknowledgments
+
+Inspiration, code snippets, icon, etc.
+
+- [Template Typescript](https://github.com/malang-dev/template-typescript) by Malang.dev.

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { SupervisordClientMethod } from './methods';
+export { SupervisordClient } from './supervisord-client';
+export type { SupervisordClientOptions } from './supervisord-client';

package/dist/index.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SupervisordClient = exports.SupervisordClientMethod = void 0;
+var methods_1 = require("./methods");
+Object.defineProperty(exports, "SupervisordClientMethod", { enumerable: true, get: function () { return methods_1.SupervisordClientMethod; } });
+var supervisord_client_1 = require("./supervisord-client");
+Object.defineProperty(exports, "SupervisordClient", { enumerable: true, get: function () { return supervisord_client_1.SupervisordClient; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,qCAAoD;AAA3C,kHAAA,uBAAuB,OAAA;AAChC,2DAAyD;AAAhD,uHAAA,iBAAiB,OAAA"}

package/dist/interfaces.d.ts

@@ -0,0 +1,62 @@
+export interface ConfigInfo {
+    autostart: boolean;
+    command: string;
+    exitcodes: number[];
+    group: string;
+    group_prio: number;
+    inuse: boolean;
+    killasgroup: boolean;
+    name: string;
+    process_prio: number;
+    redirect_stderr: boolean;
+    startretries: number;
+    startsecs: number;
+    stdout_capture_maxbytes: number;
+    stdout_events_enabled: boolean;
+    stdout_logfile: string;
+    stdout_logfile_backups: number;
+    stdout_logfile_maxbytes: number;
+    stdout_syslog: boolean;
+    stopsignal: number;
+    stopwaitsecs: number;
+    stderr_capture_maxbytes: number;
+    stderr_events_enabled: boolean;
+    stderr_logfile: string;
+    stderr_logfile_backups: number;
+    stderr_logfile_maxbytes: number;
+    stderr_syslog: boolean;
+}
+export interface ProcessInfo {
+    name: string;
+    group: string;
+    start: number;
+    stop: number;
+    now: number;
+    state: number;
+    statename: string;
+    spawnerr: string;
+    exitstatus: number;
+    logfile: string;
+    stdout_logfile: string;
+    stderr_logfile: string;
+    pid: number;
+    description: string;
+}
+export interface State {
+    state: number;
+    statename: string;
+}
+export interface ProcessStatusInfo {
+    name: string;
+    group: string;
+    status: number;
+    description: string;
+}
+export interface MulticallArgs {
+    methodName: string;
+    params: any[];
+}
+export interface MulticallResult {
+    faultCode: number;
+    faultString: string;
+}

package/dist/interfaces.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=interfaces.js.map

package/dist/interfaces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interfaces.js","sourceRoot":"","sources":["../src/interfaces.ts"],"names":[],"mappings":""}

package/dist/methods.d.ts

@@ -0,0 +1,296 @@
+import { ConfigInfo, MulticallArgs, ProcessInfo, ProcessStatusInfo, State } from './interfaces';
+export declare const $SupervisorMethod: string[];
+export declare class SupervisordClientMethod {
+}
+export interface SupervisordClientMethod {
+    /**
+     * Return the version of the RPC API used by supervisord
+     *
+     * @return {string}
+     */
+    getAPIVersion(): Promise<string>;
+    /**
+     * @deprecated
+     * Return the version of the RPC API used by supervisord
+     *
+     * @return {string}
+     */
+    getVersion(): Promise<string>;
+    /**
+     * Return the version of the supervisor package in use by supervisord
+     *
+     * @return {string} version id
+     */
+    getSupervisorVersion(): Promise<string>;
+    /**
+     * Return identifying string of supervisord
+     *
+     * @return {string} identifying string
+     */
+    getIdentification(): Promise<string>;
+    /**
+     * Return current state of supervisord as a struct
+     *
+     * @return {State} A struct with keys int statecode, string statename
+     */
+    getState(): Promise<State>;
+    /**
+     * Return the PID of supervisord
+     *
+     * @return {number} PID
+     */
+    getPID(): Promise<number>;
+    /**
+     * Read length bytes from the main log starting at offset
+     *
+     * @param {number} offset offset to start reading from
+     * @param {number} length number of bytes to read from the log
+     * @return {string} Bytes of log
+     */
+    readLog(offset: number, length: number): Promise<string>;
+    /**
+     * Clear the main log
+     *
+     * @return {boolean} always returns True unless error
+     */
+    clearLog(): Promise<boolean>;
+    /**
+     * Shut down the supervisor process
+     *
+     * @return {boolean} always returns True unless error
+     */
+    shutdown(): Promise<boolean>;
+    /**
+     * Restart the supervisor process
+     *
+     * @return {boolean} always returns True unless error
+     */
+    restart(): Promise<boolean>;
+    /**
+     * Get info about a process named name
+     *
+     * @param {string} name The name of the process (or `group:name`)
+     * @return {ProcessInfo}  A structure containing data about the process
+     */
+    getProcessInfo(name: string): Promise<ProcessInfo>;
+    /**
+     * Get info about all processes
+     *
+     * @return {ProcessInfo[]} An array of process status results
+     */
+    getAllProcessInfo(): Promise<ProcessInfo[]>;
+    /**
+     * Get info about all available process configurations. Each struct represents a single process (i.e. groups get flattened)
+     *
+     * @return {ConfigInfo[]} An array of process config info structs
+     */
+    getAllConfigInfo(): Promise<ConfigInfo[]>;
+    /**
+     * Start a process
+     *
+     * @param {string} name Process name (or group:name, or group:*)
+     * @param {boolean} wait Wait for process to be fully started `(optional)` `(default: true)`
+     * @return {boolean} always returns True unless error
+     */
+    startProcess(name: string, wait?: boolean): Promise<boolean>;
+    /**
+     * Start all processes listed in the configuration file
+     *
+     * @param {boolean} wait Wait for process to be fully started `(optional)` `(default: true)`
+     * @return {ProcessStatusInfo[]} An array of process status info structs
+     */
+    startAllProcesses(wait?: boolean): Promise<ProcessStatusInfo[]>;
+    /**
+     * Start all processes in the group named `name`
+     *
+     * @param {string} name The group name
+     * @param {boolean} wait Wait for process to be fully started `(optional)` `(default: true)`
+     * @return {ProcessStatusInfo} An array of process status info structs
+     */
+    startProcessGroup(name: string, wait?: boolean): Promise<ProcessStatusInfo[]>;
+    /**
+     * Stop a process named by name
+     *
+     * @param {string} name The name of the process to stop (or `group:name`)
+     * @param {boolean} wait Wait for process to be fully stopped `(optional)` `(default: true)`
+     * @return {boolean} always returns True unless error
+     */
+    stopProcess(name: string, wait?: boolean): Promise<boolean>;
+    /**
+     * Stop all processes in the process group named `name`
+     *
+     * @param {string} name The group name
+     * @param {boolean} wait Wait for process to be fully stopped `(optional)` `(default: true)`
+     * @return {ProcessStatusInfo[]} always returns True unless error
+     */
+    stopProcessGroup(name: string, wait?: boolean): Promise<ProcessStatusInfo[]>;
+    /**
+     * Stop all processes in the process list
+     *
+     * @param {boolean} wait Wait for process to be fully started `(optional)` `(default: true)`
+     * @return {ProcessStatusInfo[]} An array of process status info structs
+     */
+    stopAllProcesses(wait?: boolean): Promise<ProcessStatusInfo[]>;
+    /**
+     * Send an arbitrary UNIX signal to the process named by name
+     *
+     * @param {string} name Name of the process to signal (or `group:name`)
+     * @param {string | number} signal Signal to send, as name (`HUP`) or number (`1`)
+     * @return {boolean} true on success
+     */
+    signalProcess(name: string, signal: string | number): Promise<boolean>;
+    /**
+     * Send a signal to all processes in the group named `name`
+     *
+     * @param {string} name The group name
+     * @param {string | number} signal Signal to send, as name (`HUP`) or number (`1`)
+     * @return {ProcessStatusInfo[]} An array of process status info structs
+     */
+    signalProcessGroup(name: string, signal: string | number): Promise<ProcessStatusInfo[]>;
+    /**
+     * Send a string of chars to the stdin of the process name
+     * - If non-7-bit data is sent (unicode), it is encoded to utf-8 before being sent to the process’ stdin
+     * - If chars is not a string or is not unicode, raise INCORRECT_PARAMETERS
+     * - If the process is not running, raise NOT_RUNNING
+     * - If the process’ stdin cannot accept input (e.g. it was closed by the child process), raise NO_FILE
+     *
+     * @param {string} name The process name to send to (or `group:name`)
+     * @param {string} chars The character data to send to the process
+     * @return {boolean} always returns True unless error
+     */
+    sendProcessStdin(name: string, chars: string): Promise<boolean>;
+    /**
+     * Send an event that will be received by event listener subprocesses subscribing to the RemoteCommunicationEvent
+     *
+     * @param {string} type String for the `type` key in the event header
+     * @param {string} data Data for the event body
+     * @return {boolean} always returns True unless error
+     */
+    sendRemoteCommEvent(type: string, data: string): Promise<boolean>;
+    /**
+     * Reload the configuration. The result contains three arrays containing names of process groups:
+     * - `added` gives the process groups that have been added
+     * - `changed` gives the process groups whose contents have changed
+     * - `removed` gives the process groups that are no longer in the configuration
+     *
+     * @return {any} `[[added, changed, removed]]`
+     */
+    reloadConfig(): Promise<any>;
+    /**
+     * Update the config for a running process from config file
+     *
+     * @param {string} name Name of process group to add
+     * @return {boolean} true on success
+     */
+    addProcessGroup(name: string): Promise<boolean>;
+    /**
+     * Remove a stopped process from the active configuration
+     *
+     * @param {string} name Name of process group to remove
+     * @return {boolean} Indicates whether the removal was successful
+     */
+    removeProcessGroup(name: string): Promise<boolean>;
+    /**
+     * Read length bytes from name’s stdout log starting at offset
+     *
+     * @param {string} name The name of the process (or `group:name`)
+     * @param {number} offset to start reading from
+     * @param {number} length Number of bytes to read from the log
+     * @return {string} Bytes of log
+     */
+    readProcessStdoutLog(name: string, offset: number, length: number): Promise<string>;
+    /**
+     * Read length bytes from name’s stderr log starting at offset
+     *
+     * @param {string} name The name of the process (or `group:name`)
+     * @param {number} offset to start reading from
+     * @param {number} length Number of bytes to read from the log
+     * @return {string} Bytes of log
+     */
+    readProcessStderrLog(name: string, offset: number, length: number): Promise<string>;
+    /**
+     * Provides a more efficient way to tail the (stdout) log than readProcessStdoutLog().
+     * Use readProcessStdoutLog() to read chunks and tailProcessStdoutLog() to tail.
+     *
+     * Requests (length) bytes from the (name)'s log, starting at (offset).
+     * - If the total log size is greater than (offset + length),
+     * the overflow flag is set and the (offset) is automatically increased to position the buffer at the end of the log.
+     * - If less than (length) bytes are available, the maximum number of available bytes will be returned.
+     * (offset) returned is always the last offset in the log +1.
+     *
+     * @param {string} name The name of the process (or `group:name`)
+     * @param {number} offset to start reading from
+     * @param {number} length Maximum number of bytes to return
+     * @return {any} `[string bytes, int offset, bool overflow]`
+     */
+    tailProcessStdoutLog(name: string, offset: number, length: number): Promise<any>;
+    /**
+     * Provides a more efficient way to tail the (stderr) log than readProcessStderrLog().
+     * Use readProcessStderrLog() to read chunks and tailProcessStderrLog() to tail.
+     *
+     * Requests (length) bytes from the (name)'s log, starting at (offset).
+     * - If the total log size is greater than (offset + length),
+     * the overflow flag is set and the (offset) is automatically increased to position the buffer at the end of the log.
+     * - If less than (length) bytes are available, the maximum number of available bytes will be returned.
+     * (offset) returned is always the last offset in the log +1.
+     *
+     * @param {string} name The name of the process (or `group:name`)
+     * @param {number} offset to start reading from
+     * @param {number} length Maximum number of bytes to return
+     * @return {any} `[string bytes, int offset, bool overflow]`
+     */
+    tailProcessStderrLog(name: string, offset: number, length: number): Promise<any>;
+    /**
+     * Clear the stdout and stderr logs for the named process and reopen them
+     *
+     * @param {string} name The name of the process (or `group:name`)
+     * @return {boolean} always returns True unless error
+     */
+    clearProcessLogs(name: string): Promise<boolean>;
+    /**
+     * Clear the stdout and stderr logs for the named process and reopen them
+     *
+     * @param {string} name The name of the process (or `group:name`)
+     * @return {boolean} always returns True unless error
+     */
+    clearProcessLog(name: string): Promise<boolean>;
+    /**
+     * Clear all process log files
+     *
+     * @return {ProcessStatusInfo[]} An array of process status info structs
+     */
+    clearAllProcessLogs(): Promise<ProcessStatusInfo[]>;
+    /**
+     * Return an array listing the available method names
+     *
+     * @return {string[]} An array of method names available (strings)
+     */
+    listMethods(): Promise<string[]>;
+    /**
+     * Return a string showing the method's documentation
+     *
+     * @param {string} name The name of the method
+     * @return {string} The documentation for the method name
+     */
+    methodHelp(name: string): Promise<string>;
+    /**
+     * Return an array describing the method signature in the form [rtype, ptype, ptype…]
+     * where rtype is the return data type of the method, and ptypes are the parameter data types
+     * that the method accepts in method argument order
+     *
+     * @param {string} name The name of the method
+     * @return {string[]} The result
+     */
+    methodSignature(name: string): Promise<string[]>;
+    /**
+     * Process an array of calls, and return an array of results.
+     * Calls should be structs of the form {'methodName': string, 'params': array}.
+     * Each result will either be a single-item array containing the result value,
+     * or a struct of the form {'faultCode': int, 'faultString': string}.
+     * This is useful when you need to make lots of small calls without lots of round trips.
+     *
+     * @param {MulticallArgs[]} calls An array of call requests
+     * @return {any} The result
+     */
+    multicall(calls: MulticallArgs[]): Promise<any>;
+}

package/dist/methods.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SupervisordClientMethod = exports.$SupervisorMethod = void 0;
+exports.$SupervisorMethod = [
+    'supervisor.addProcessGroup',
+    'supervisor.clearAllProcessLogs',
+    'supervisor.clearLog',
+    'supervisor.clearProcessLog',
+    'supervisor.clearProcessLogs',
+    'supervisor.getAPIVersion',
+    'supervisor.getAllConfigInfo',
+    'supervisor.getAllProcessInfo',
+    'supervisor.getIdentification',
+    'supervisor.getPID',
+    'supervisor.getProcessInfo',
+    'supervisor.getState',
+    'supervisor.getSupervisorVersion',
+    'supervisor.getVersion', // deprecated
+    'supervisor.readLog',
+    'supervisor.readMainLog', // deprecated
+    'supervisor.readProcessLog', // deprecated
+    'supervisor.readProcessStderrLog',
+    'supervisor.readProcessStdoutLog',
+    'supervisor.reloadConfig',
+    'supervisor.removeProcessGroup',
+    'supervisor.restart',
+    'supervisor.sendProcessStdin',
+    'supervisor.sendRemoteCommEvent',
+    'supervisor.signalProcess',
+    'supervisor.signalProcessGroup',
+    'supervisor.shutdown',
+    'supervisor.startAllProcesses',
+    'supervisor.startProcess',
+    'supervisor.startProcessGroup',
+    'supervisor.stopAllProcesses',
+    'supervisor.stopProcess',
+    'supervisor.stopProcessGroup',
+    'supervisor.tailProcessLog', // deprecated
+    'supervisor.tailProcessStderrLog',
+    'supervisor.tailProcessStdoutLog',
+    'system.listMethods',
+    'system.methodHelp',
+    'system.methodSignature',
+    'system.multicall',
+];
+// eslint-disable-next-line @typescript-eslint/no-unsafe-declaration-merging
+class SupervisordClientMethod {
+}
+exports.SupervisordClientMethod = SupervisordClientMethod;
+//# sourceMappingURL=methods.js.map

package/dist/methods.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"methods.js","sourceRoot":"","sources":["../src/methods.ts"],"names":[],"mappings":";;;AAEa,QAAA,iBAAiB,GAAG;IAC7B,4BAA4B;IAC5B,gCAAgC;IAChC,qBAAqB;IACrB,4BAA4B;IAC5B,6BAA6B;IAC7B,0BAA0B;IAC1B,6BAA6B;IAC7B,8BAA8B;IAC9B,8BAA8B;IAC9B,mBAAmB;IACnB,2BAA2B;IAC3B,qBAAqB;IACrB,iCAAiC;IACjC,uBAAuB,EAAE,aAAa;IACtC,oBAAoB;IACpB,wBAAwB,EAAE,aAAa;IACvC,2BAA2B,EAAE,aAAa;IAC1C,iCAAiC;IACjC,iCAAiC;IACjC,yBAAyB;IACzB,+BAA+B;IAC/B,oBAAoB;IACpB,6BAA6B;IAC7B,gCAAgC;IAChC,0BAA0B;IAC1B,+BAA+B;IAC/B,qBAAqB;IACrB,8BAA8B;IAC9B,yBAAyB;IACzB,8BAA8B;IAC9B,6BAA6B;IAC7B,wBAAwB;IACxB,6BAA6B;IAC7B,2BAA2B,EAAE,aAAa;IAC1C,iCAAiC;IACjC,iCAAiC;IACjC,oBAAoB;IACpB,mBAAmB;IACnB,wBAAwB;IACxB,kBAAkB;CACrB,CAAC;AAEF,4EAA4E;AAC5E,MAAa,uBAAuB;CAAG;AAAvC,0DAAuC"}

package/dist/supervisord-client.d.ts

@@ -0,0 +1,12 @@
+import { XmlRpcValue } from '@foxglove/xmlrpc';
+import { SupervisordClientMethod } from './methods';
+export interface SupervisordClientOptions {
+    username: string;
+    password: string;
+}
+export declare class SupervisordClient extends SupervisordClientMethod {
+    private client;
+    constructor(connectionUrl: string, options?: SupervisordClientOptions);
+    _call(method: string, params: XmlRpcValue[]): Promise<XmlRpcValue>;
+    private createHeaders;
+}

package/dist/supervisord-client.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SupervisordClient = void 0;
+const xmlrpc_1 = require("@foxglove/xmlrpc");
+const methods_1 = require("./methods");
+class SupervisordClient extends methods_1.SupervisordClientMethod {
+    client;
+    constructor(connectionUrl, options) {
+        super();
+        this.client = new xmlrpc_1.XmlRpcClient(connectionUrl, {
+            encoding: 'utf-8',
+            headers: this.createHeaders(options),
+        });
+    }
+    async _call(method, params) {
+        return this.client.methodCall(method, params);
+    }
+    createHeaders(options) {
+        if (!options) {
+            return undefined;
+        }
+        const { username, password } = options;
+        const encoded = Buffer.from(username + ':' + password).toString('base64');
+        return { Authorization: `Basic ${encoded}` };
+    }
+}
+exports.SupervisordClient = SupervisordClient;
+methods_1.$SupervisorMethod.forEach((method) => {
+    const methodName = method.split('.').pop();
+    SupervisordClient.prototype[methodName] = function (...params) {
+        return this._call(method, params);
+    };
+});
+//# sourceMappingURL=supervisord-client.js.map

package/dist/supervisord-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"supervisord-client.js","sourceRoot":"","sources":["../src/supervisord-client.ts"],"names":[],"mappings":";;;AAAA,6CAA6D;AAE7D,uCAAuE;AAOvE,MAAa,iBAAkB,SAAQ,iCAAuB;IAClD,MAAM,CAAe;IAE7B,YAAY,aAAqB,EAAE,OAAkC;QACjE,KAAK,EAAE,CAAC;QAER,IAAI,CAAC,MAAM,GAAG,IAAI,qBAAY,CAAC,aAAa,EAAE;YAC1C,QAAQ,EAAE,OAAO;YACjB,OAAO,EAAE,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC;SACvC,CAAC,CAAC;IACP,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,MAAc,EAAE,MAAqB;QAC7C,OAAO,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClD,CAAC;IAEO,aAAa,CAAC,OAAkC;QACpD,IAAI,CAAC,OAAO,EAAE,CAAC;YACX,OAAO,SAAS,CAAC;QACrB,CAAC;QAED,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC;QACvC,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,GAAG,GAAG,GAAG,QAAQ,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAC1E,OAAO,EAAE,aAAa,EAAE,SAAS,OAAO,EAAE,EAAE,CAAC;IACjD,CAAC;CACJ;AAzBD,8CAyBC;AAED,2BAAiB,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE;IACjC,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC;IAC1C,iBAAiB,CAAC,SAAiB,CAAC,UAAU,CAAC,GAAG,UAAU,GAAG,MAAqB;QACjF,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,CAAC,CAAC;AACN,CAAC,CAAC,CAAC"}

package/eslint.config.mjs

@@ -0,0 +1,163 @@
+import typescriptEslintEslintPlugin from '@typescript-eslint/eslint-plugin';
+import perfectionist from 'eslint-plugin-perfectionist';
+import tsParser from '@typescript-eslint/parser';
+import { FlatCompat } from '@eslint/eslintrc';
+import { fileURLToPath } from 'node:url';
+import paths from 'eslint-plugin-paths';
+import globals from 'globals';
+import path from 'node:path';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const compat = new FlatCompat({
+    baseDirectory: __dirname,
+});
+
+export default [
+    {
+        ignores: ['**/.eslintrc.js', 'prisma/**/*', '.hygen.js', '.hygen/**/*'],
+    },
+    ...compat.extends('plugin:@typescript-eslint/recommended', 'plugin:prettier/recommended'),
+    perfectionist.configs['recommended-alphabetical'],
+    {
+        plugins: {
+            '@typescript-eslint': typescriptEslintEslintPlugin,
+            paths,
+        },
+
+        languageOptions: {
+            globals: {
+                ...globals.node,
+            },
+
+            parser: tsParser,
+            ecmaVersion: 'latest',
+            sourceType: 'commonjs',
+
+            parserOptions: {
+                project: 'tsconfig.json',
+                tsconfigRootDir: __dirname,
+            },
+        },
+
+        rules: {
+            'perfectionist/sort-imports': [
+                'error',
+                {
+                    type: 'line-length',
+                    order: 'desc',
+                    ignoreCase: true,
+                    specialCharacters: 'keep',
+                    internalPattern: ['^~/.+'],
+                    tsconfigRootDir: '.',
+                    partitionByComment: false,
+                    partitionByNewLine: false,
+                    newlinesBetween: 'always',
+                    maxLineLength: undefined,
+                    tsconfigRootDir: __dirname,
+
+                    groups: [
+                        'type',
+                        ['builtin', 'external'],
+                        'internal-type',
+                        'internal',
+                        'nestJs',
+                        'remnawave',
+                        'aliasCommon',
+                        { newlinesBetween: 'never' },
+                        'aliasLibs',
+                        'aliasIntegrationModules',
+                        'aliasModules',
+                        'aliasScheduler',
+                        'aliasQueue',
+                        ['parent-type', 'sibling-type', 'index-type'],
+                        ['parent', 'sibling', 'index'],
+                        'object',
+                        'unknown',
+                    ],
+
+                    customGroups: {
+                        value: {
+                            aliasModules: '@modules/*.',
+                            aliasCommon: '@common/*.',
+                            aliasLibs: '@libs/*.',
+                            aliasIntegrationModules: '@integration-modules/*.',
+                            aliasScheduler: '@scheduler/*.',
+                            aliasQueue: '@queue/*.',
+                            remnawave: '@remnawave/*.',
+                            nestJs: '@nestjs/*.',
+                        },
+                    },
+
+                    environment: 'node',
+                },
+            ],
+            'perfectionist/sort-decorators': [
+                'error',
+                {
+                    groups: [
+                        'unknown',
+                        'httpCodes',
+                        'filters',
+                        'guards',
+                        'controllers',
+                        'nestJSMethods',
+                    ],
+
+                    customGroups: {
+                        httpCodes: ['HttpCode'],
+                        filters: ['UseFilters'],
+                        guards: ['UseGuards'],
+                        controllers: ['Controller'],
+                        nestJSMethods: ['Post', 'Get', 'Put', 'Delete', 'Patch', 'Options', 'Head'],
+                    },
+                },
+            ],
+
+            'perfectionist/sort-objects': ['off'],
+            'perfectionist/sort-classes': ['off'],
+            'perfectionist/sort-switch-case': ['off'],
+            'perfectionist/sort-object-types': ['off'],
+            'perfectionist/sort-interfaces': ['off'],
+            'perfectionist/sort-union-types': ['off'],
+            'perfectionist/sort-named-imports': ['off'],
+            'perfectionist/sort-modules': ['off'],
+            'paths/alias': 'error',
+            '@typescript-eslint/interface-name-prefix': 'off',
+            '@typescript-eslint/explicit-function-return-type': 'off',
+            '@typescript-eslint/explicit-module-boundary-types': 'off',
+            '@typescript-eslint/no-explicit-any': 'off',
+            '@typescript-eslint/no-namespace': 'off',
+            'linebreak-style': 0,
+            'no-console': 'warn',
+
+            'prettier/prettier': [
+                'error',
+                {
+                    bracketSpacing: true,
+                    tabWidth: 4,
+                    printWidth: 100,
+                    singleQuote: true,
+                    trailingComma: 'all',
+
+                    overrides: [
+                        {
+                            files: ['*.js', '*.jsx', '*.ts', '*.tsx'],
+
+                            options: {
+                                parser: 'typescript',
+                            },
+                        },
+                        {
+                            files: ['*.md', '*.json', '*.yaml', '*.yml'],
+
+                            options: {
+                                tabWidth: 2,
+                            },
+                        },
+                    ],
+                },
+            ],
+        },
+    },
+];

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@kastov/node-supervisord",
+  "version": "2.0.0",
+  "description": "A Node.js library for communicating with the Supervisord XML-RPC API",
+  "keywords": [
+    "supervisor",
+    "supervisord",
+    "sdk",
+    "typescript",
+    "module",
+    "addon"
+  ],
+  "homepage": "https://github.com/kastov/node-supervisord",
+  "repository": {
+    "type": "git",
+    "url": "git+ssh://git@github.com/kastov/node-supervisord.git"
+  },
+  "license": "MIT",
+  "private": false,
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "prepare": "husky",
+    "prebuild": "rimraf dist",
+    "format": "prettier --write .",
+    "build": "tsc -b tsconfig.build.json",
+    "lint": "eslint \"src/**/*.ts\" --fix",
+    "lint-staged": "lint-staged"
+  },
+  "devDependencies": {
+    "husky": "^9.0.11",
+    "lint-staged": "^15.2.2",
+    "prettier-plugin-organize-imports": "^3.2.4",
+    "rimraf": "^5.0.5",
+    "@types/node": "^24.10.1",
+    "@typescript-eslint/eslint-plugin": "8.49.0",
+    "@typescript-eslint/parser": "8.49.0",
+    "eslint": "9.39.1",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-paths": "^1.1.0",
+    "eslint-plugin-perfectionist": "^4.15.1",
+    "eslint-plugin-prettier": "^5.5.4",
+    "prettier": "^3.7.4",
+    "typescript": "^5.9.3"
+  },
+  "lint-staged": {
+    "src/**/*.{ts|test.ts}": [
+      "eslint --max-warnings 0 \"src/**/*.ts\"",
+      "prettier --write --ignore-unknown"
+    ]
+  },
+  "dependencies": {
+    "@foxglove/xmlrpc": "^1.3.0"
+  }
+}