ellipsis-com 0.0.1

package/README.md

@@ -0,0 +1,92 @@
+# ellipsis-com
+
+Serial communication management with command/response macros defined by regular expressions. The library wraps a serial port, executes macros, and exposes a manager for discovering and interacting with devices.
+
+## Features
+- Connect to serial ports with a configured baud rate
+- Send command macros and wait for regex-matched responses
+- Manage multiple devices via a central manager
+
+## Install
+
+```bash
+npm install
+```
+
+## Build
+
+```bash
+npm run build
+```
+
+## Test
+
+```bash
+npm test
+```
+
+## Basic usage
+
+```ts
+import { ComManager } from '../ComManager'
+import { ComMacro } from '../ComMacro'
+
+/**
+ * This demo works with the arduino-demo sketch.
+ */
+async function demo() {
+    const manager = new ComManager()
+
+    // Initialise the manager with a com type that has some macros.
+    // The init macro is required and is used to identify the type of a port when it is connected. 
+    // The other macros are optional and can be used to define commands that can be sent to the device.
+    await manager.init(
+        [{
+            name: 'myType',
+            baud: 9600,
+            startupDelay: 2000, // optional delay to wait for device to startup after connecting and before sending init
+            macros: {
+                // Command to initialise and identify type - must have key 'init':
+                init: [new ComMacro('INFO', /MOCK\sDEVICE\sV\d+.?\d*[\n\r]+STATUS: OK[\n\r]+CMD DONE$/gm)], // regex to identify device as being of myType
+
+                // Basic command and response pattern - can be named anything:
+                getData: [new ComMacro('GET DATA', /CMD DONE$/gm)],
+
+                // Command with parameters:
+                setData: [new ComMacro('SET DATA {val}', /CMD DONE$/gm)],
+
+                // Command with a sequence of commands and responses:
+                deleteData: [
+                    new ComMacro('DEL DATA', /Are you sure\? \(Y\/N\)$/gm),
+                    new ComMacro('Y', /CMD DONE$/gm)
+                ]
+            }
+        }]
+    )
+
+    // Send the getData command to the first port of type 'myType':
+    let data = await manager.send('myType', 0, 'getData')
+    console.log('\nGet data response - ', data[0], '\n') // data is an array of responses matching the regex for the macro
+
+    // Send the setData command with a parameter:
+    await manager.send('myType', 0, 'setData', {val: 'abc123'})
+    data = await manager.send('myType', 0, 'getData')
+    console.log('\nData changed - ', data[0], '\n')
+
+    // Delete the data using the deleteData command which has a sequence of commands and responses:
+    await manager.send('myType', 0, 'deleteData')
+    data = await manager.send('myType', 0, 'getData')
+    console.log('\nAfter deletion - ', data[0], '\n')
+}
+
+demo()
+```
+
+## Project structure
+- src/ComPort.ts: serial port wrapper with read/write/macro support
+- src/ComType.ts: device type definition and macro configuration
+- src/ComMacro.ts: command/response macro definition
+- src/ComManager.ts: device discovery and access by type
+
+## License
+ISC

package/__mocks__/serialport.ts

@@ -0,0 +1,119 @@
+import { EventEmitter } from 'events';
+
+export class SerialPort extends EventEmitter {
+  private _isOpen: boolean = false;
+  public path: string;
+  public baudRate: number;
+
+  static mockPortsList: any[] = [];
+  static mockWriteResponse: Error | null = null;
+  static mockOpenResponse: Error | null = null;
+  static mockCloseResponse: Error | null = null;
+  static nextResponse: string | null = null;
+
+  constructor(options: { path: string; baudRate: number; autoOpen?: boolean }) {
+    super();
+    this.path = options.path;
+    this.baudRate = options.baudRate;
+
+    if (options.autoOpen !== false) {
+      setTimeout(() => this.open(() => {}), 0);
+    }
+  }
+
+  get isOpen(): boolean {
+    return this._isOpen;
+  }
+
+  open(callback: (err: Error | null) => void): void {
+    
+    setTimeout(() => {
+      if (SerialPort.mockOpenResponse) {
+        callback(SerialPort.mockOpenResponse)
+        SerialPort.mockOpenResponse = null; // reset after use
+      } else {
+        this._isOpen = true;
+        callback(null);
+      }
+    }, 0);
+  }
+
+  write(data: string, callback?: (err: Error | null) => void): void {
+    setTimeout(() => {
+      if (callback) {
+        callback(SerialPort.mockWriteResponse)
+        SerialPort.mockWriteResponse = null; // reset after use
+      }
+
+      if(SerialPort.nextResponse) {
+        setTimeout(() => {
+            if(SerialPort.nextResponse) {
+                this.simulateData(SerialPort.nextResponse)
+                SerialPort.nextResponse = null; // reset after use
+            }
+        }, 0);
+      }
+    }, 0);
+  }
+
+  close(callback?: (err: Error | null) => void): void {
+    setTimeout(() => {
+      this._isOpen = false;
+      if (callback) {
+        callback(SerialPort.mockCloseResponse)
+        SerialPort.mockCloseResponse = null; // reset after use
+      }
+    }, 0);
+  }
+
+  // Method to simulate receiving data
+  simulateData(data: string | Buffer): void {
+    if(data === null) {
+        throw new Error('Data cannot be null')
+    }
+    this.emit('data', Buffer.from(data));
+  }
+
+  // Method to simulate errors
+  simulateError(error: Error): void {
+    this.emit('error', error);
+  }
+
+  static async list(): Promise<any[]> {
+    /**
+        PortInfo {
+            path: string;
+            manufacturer: string | undefined;
+            serialNumber: string | undefined;
+            pnpId: string | undefined;
+            locationId: string | undefined;
+            productId: string | undefined;
+            vendorId: string | undefined;
+        }
+     */
+    return Promise.resolve(SerialPort.mockPortsList);
+  }
+
+  // Helper methods for tests
+  static resetMocks(): void {
+    SerialPort.mockPortsList = [];
+    SerialPort.mockWriteResponse = null;
+    SerialPort.mockOpenResponse = null;
+  }
+
+  static setMockPorts(ports: any[]): void {
+    SerialPort.mockPortsList = ports;
+  }
+
+  static setMockWriteError(error: Error | null): void {
+    SerialPort.mockWriteResponse = error;
+  }
+
+  static setMockOpenError(error: Error | null): void {
+    SerialPort.mockOpenResponse = error;
+  }
+
+  static setNextResponse(data: string) {
+    SerialPort.nextResponse = data;
+  }
+}

package/arduino-demo/arduino-demo.ino

@@ -0,0 +1,68 @@
+String storedData = "Initial Data";
+bool awaitingDeleteConfirm = false;
+
+void setup() {
+  Serial.begin(9600);
+  Serial.println("DEVICE READY");
+}
+
+void loop() {
+  if (Serial.available() > 0) {
+    String input = Serial.readStringUntil('\n');
+    input.trim(); // Remove whitespace/line endings
+
+    // Handle Delete Confirmation State
+    if (awaitingDeleteConfirm) {
+      handleDeleteConfirmation(input);
+    } else {
+      processCommand(input);
+    }
+  }
+}
+
+void processCommand(String cmd) {
+  if (cmd == "INFO") {
+    Serial.println("MOCK DEVICE V1.0");
+    Serial.println("STATUS: OK");
+    finish();
+  } 
+  else if (cmd == "GET DATA") {
+    Serial.print("DATA: ");
+    Serial.println(storedData);
+    finish();
+  } 
+  else if (cmd.startsWith("SET DATA ")) {
+    // Extract everything after "SET DATA "
+    storedData = cmd.substring(9);
+    Serial.println("DATA UPDATED");
+    finish();
+  } 
+  else if (cmd == "DEL DATA") {
+    Serial.println("Are you sure? (Y/N)");
+    awaitingDeleteConfirm = true;
+    // Note: No 'finish()' here because we are waiting for user input
+  } 
+  else {
+    Serial.println("ERROR: UNKNOWN COMMAND");
+  }
+}
+
+void handleDeleteConfirmation(String response) {
+  response.toUpperCase();
+  if (response == "Y") {
+    storedData = "";
+    Serial.println("DATA DELETED");
+    awaitingDeleteConfirm = false;
+    finish();
+  } else if (response == "N") {
+    Serial.println("DELETE ABORTED");
+    awaitingDeleteConfirm = false;
+    finish();
+  } else {
+    Serial.println("INVALID RESPONSE. PLEASE ENTER Y OR N:");
+  }
+}
+
+void finish() {
+  Serial.println("CMD DONE");
+}

package/dist/ComMacro.d.ts

@@ -0,0 +1,7 @@
+export declare class ComMacro {
+    command: string;
+    response: RegExp;
+    constructor(command: string, response: RegExp);
+    toString(): string;
+}
+//# sourceMappingURL=ComMacro.d.ts.map

package/dist/ComMacro.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ComMacro.d.ts","sourceRoot":"","sources":["../src/ComMacro.ts"],"names":[],"mappings":"AACA,qBAAa,QAAQ;IAEN,OAAO,EAAE,MAAM;IACf,QAAQ,EAAE,MAAM;gBADhB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM;IAG3B,QAAQ;CAGX"}

package/dist/ComMacro.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ComMacro = void 0;
+class ComMacro {
+    constructor(command, response) {
+        this.command = command;
+        this.response = response;
+    }
+    toString() {
+        return `ComMacro(command='${this.command}', response=${this.response.toString()})`;
+    }
+}
+exports.ComMacro = ComMacro;
+//# sourceMappingURL=ComMacro.js.map

package/dist/ComMacro.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ComMacro.js","sourceRoot":"","sources":["../src/ComMacro.ts"],"names":[],"mappings":";;;AACA,MAAa,QAAQ;IACjB,YACW,OAAe,EACf,QAAgB;QADhB,YAAO,GAAP,OAAO,CAAQ;QACf,aAAQ,GAAR,QAAQ,CAAQ;IACvB,CAAC;IAEL,QAAQ;QACJ,OAAO,qBAAqB,IAAI,CAAC,OAAO,eAAe,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,GAAG,CAAC;IACvF,CAAC;CACJ;AATD,4BASC"}

package/dist/ComManager.d.ts

@@ -0,0 +1,30 @@
+import { ComType } from './ComType';
+import { ComPort } from './ComPort';
+export declare function enableDebug(enable?: boolean): void;
+/**
+ * Maintains a list of ports and types, and handles scanning for new ports and matching them to types.
+ */
+export declare class ComManager {
+    ports: ComPort[];
+    types: ComType[];
+    refreshInterval: number;
+    defaultTimeout: number | undefined;
+    private refreshIntervalHandle;
+    constructor();
+    init(types?: ComType[]): Promise<void>;
+    private scheduleRefresh;
+    getComPort(typeName: string, index_name: number | string): ComPort;
+    scanPorts(): Promise<void>;
+    /**
+     * Load the com types from the OpenAPI document.
+     * TODO: This method needs to be moved into the bb-com-extension.
+     * @returns
+     */
+    list(type: string, operationId: string, params: {
+        [key: string]: any;
+    }): Promise<string[][]>;
+    send(type: string, index_name: number | string, operationId: string, params?: {
+        [key: string]: any;
+    }): Promise<string[]>;
+}
+//# sourceMappingURL=ComManager.d.ts.map

package/dist/ComManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ComManager.d.ts","sourceRoot":"","sources":["../src/ComManager.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAInC,wBAAgB,WAAW,CAAC,MAAM,UAAO,QAMxC;AAGD;;GAEG;AACH,qBAAa,UAAU;IACrB,KAAK,EAAE,OAAO,EAAE,CAAK;IACrB,KAAK,EAAE,OAAO,EAAE,CAAK;IACrB,eAAe,SAAQ;IACvB,cAAc,EAAE,MAAM,GAAG,SAAS,CAAY;IAE9C,OAAO,CAAC,qBAAqB,CAA8B;;IAIrD,IAAI,CAAC,KAAK,GAAE,OAAO,EAAO;IAchC,OAAO,CAAC,eAAe;IAyBvB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO;IAqB5D,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IA2EhC;;;;OAIG;IAgFG,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;KAAC,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;IAS1F,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAC,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;KAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;CAK3H"}

package/dist/ComManager.js

@@ -0,0 +1,240 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ComManager = void 0;
+exports.enableDebug = enableDebug;
+const serialport_1 = require("serialport");
+const ComPort_1 = require("./ComPort");
+// TODO: Adopt a propper logging system.
+let debug;
+function enableDebug(enable = true) {
+    if (enable) {
+        debug = console.log;
+    }
+    else {
+        debug = () => { };
+    }
+}
+enableDebug(false);
+/**
+ * Maintains a list of ports and types, and handles scanning for new ports and matching them to types.
+ */
+class ComManager {
+    constructor() {
+        this.ports = [];
+        this.types = [];
+        this.refreshInterval = 60000; // 60 seconds
+        this.defaultTimeout = undefined; // assigned to ports on creation
+        this.refreshIntervalHandle = null;
+    }
+    async init(types = []) {
+        this.types = types;
+        try {
+            await this.scanPorts();
+            debug("ComManager initialized.");
+        }
+        catch (err) {
+            console.error("Error initializing ComManager: ", err);
+            setTimeout(() => this.init(), 1000); // retry
+        }
+        this.scheduleRefresh();
+    }
+    scheduleRefresh() {
+        // Clear any current job:
+        if (this.refreshIntervalHandle) {
+            clearInterval(this.refreshIntervalHandle);
+        }
+        // A negative interval disables refreshing:
+        if (this.refreshInterval < 0) {
+            debug('ComManager auto-refresh disabled.');
+            return;
+        }
+        // Schedule a new job:
+        this.refreshIntervalHandle = setTimeout(async () => {
+            debug('Rescanning com ports...');
+            try {
+                this.scanPorts();
+            }
+            catch (err) {
+                console.error("Error scanning ports: ", err);
+            }
+            finally {
+                this.scheduleRefresh(); // reschedule the next refresh
+            }
+        }, this.refreshInterval);
+    }
+    getComPort(typeName, index_name) {
+        const typePorts = this.ports.filter(p => p.type?.name === typeName);
+        if (typeof index_name === 'string') {
+            const port = typePorts.find(p => p.name === index_name);
+            if (!port) {
+                throw new Error(`Port with name ${index_name} not found for type ${typeName}.`);
+            }
+            return port;
+        }
+        const index = index_name;
+        // Make sure the port exists and has a known type:
+        if (index >= typePorts.length) {
+            throw new Error(`Port with index ${index} not found. ${typePorts.length} ports found of type ${typeName}.`); // TODO: Create custom not found error class.
+        }
+        return typePorts[index];
+    }
+    async scanPorts() {
+        debug(`Scanning serial ports...`);
+        try {
+            const ports = await serialport_1.SerialPort.list();
+            await Promise.all(ports.map(async (p) => {
+                // Send hello message to existing ports:
+                const existingPort = this.ports.find(existing => existing.path === p.path);
+                if (existingPort && existingPort.type) {
+                    try {
+                        debug(`Sending hello message to port ${existingPort.path} of type ${existingPort.type?.name}...`);
+                        await existingPort.send('init');
+                        debug(`Response received from port ${existingPort.path}.`);
+                    }
+                    catch (err) {
+                        debug(`Port ${existingPort.path} of type ${existingPort.type?.name} is not responding.`);
+                        // Close the port if open:
+                        if (existingPort.state !== 'closed') {
+                            await existingPort.close();
+                        }
+                    }
+                    return;
+                }
+                // Remove existing ports of unknown type so that we can try again:
+                if (existingPort && !existingPort.type) {
+                    debug(`Removing existing port ${existingPort.path} of unknown type for re-detection.`);
+                    this.ports = this.ports.filter(p => p.path !== existingPort.path);
+                }
+                // Add new port:
+                const port = new ComPort_1.ComPort(p.path);
+                if (this.defaultTimeout) {
+                    port.timeout = this.defaultTimeout;
+                }
+                port.path = p.path;
+                port.manufacturer = p.manufacturer;
+                port.serialNumber = p.serialNumber;
+                port.pnpId = p.pnpId;
+                port.locationId = p.locationId;
+                port.productId = p.productId;
+                port.vendorId = p.vendorId;
+                this.ports.push(port);
+                // Check if the port supports one of the known com types:
+                for (let type of this.types) {
+                    try {
+                        // Try to set the type:
+                        if (!await port.setType(type)) {
+                            continue;
+                        }
+                        // If the type was set without error, then the port
+                        // supports this type:
+                        debug(`Com port of type ${type.name} found at path ${port.path}`);
+                        // Open the port for background use:
+                        await port.connect();
+                        break;
+                    }
+                    catch (err) {
+                        debug(`Failed to add type to port: ${port.toString()}`);
+                        console.error(err);
+                        continue;
+                    }
+                }
+            }));
+            debug(`Com ports: \n\t${this.ports.map(p => p.toString()).join(',\n\t')}`);
+        }
+        catch (error) {
+            console.error(`Error scanning serial ports: ${error.message}`);
+        }
+    }
+    /**
+     * Load the com types from the OpenAPI document.
+     * TODO: This method needs to be moved into the bb-com-extension.
+     * @returns
+     */
+    //   loadTypes() {
+    //     if(!this.openapiDoc['x-bb-com-types']) {
+    //       debug("No com types found in OpenAPI document.")
+    //       return
+    //     }
+    //     // Iterate over all com types in the OpenAPI document:
+    //     Object.keys(this.openapiDoc['x-bb-com-types']).forEach( (name: string) => {
+    //       const comType = this.openapiDoc['x-bb-com-types'][name]
+    //       // Ensure the baud rate is a number:
+    //       if(typeof comType.baud === 'string') {
+    //         comType.baud = parseInt(comType.baud)
+    //       }
+    //       // Extract all macros that specify this com type by name:
+    //       const macros = {} as {[method: string]: ComMacro[]}
+    //       Object.values(this.openapiDoc.paths).forEach( (path: any) => {
+    //         Object.keys(path)
+    //         .filter(method => ['get', 'post', 'put', 'patch', 'delete'].includes(method))
+    //         .filter(method => path[method]['x-bb-com-macro'])
+    //         .forEach(method => {
+    //           if(!path[method]['x-bb-com-macro'].commands ||
+    //             !path[method]['x-bb-com-macro'].responses ||
+    //             path[method]['x-bb-com-macro'].commands.length !== path[method]['x-bb-com-macro'].responses.length) 
+    //           {
+    //             throw new Error('x-bb-com-macro commands and responses must be arrays of the same length in openapi.json at path '+path+'/'+method+'.')
+    //           }
+    //           if(!path[method].operationId) {
+    //             throw new Error(`OperationId missing for method ${method} at path ${path} in openapi.json.`)
+    //           }
+    //           macros[path[method].operationId] = (path[method]['x-bb-com-macro'].commands as string[]).map((c, i) => (
+    //             new ComMacro(c, new RegExp(path[method]['x-bb-com-macro'].responses[i].replace(/^\\/|\\/$/g, ''), 'gm'))
+    //           ))
+    //         })
+    //       })
+    //       // Init macro:
+    //       if(!comType.initCommands || comType.initCommands.length === 0) {
+    //         throw new Error(`Com type '${name}' is missing init commands.`)
+    //       }
+    //       if(!comType.initResponses || comType.initResponses.length === 0) {
+    //         throw new Error(`Com type '${name}' is missing init responses.`)
+    //       }
+    //       if(comType.initCommands.length !== comType.initResponses.length) {
+    //         throw new Error(`Com type '${name}' init commands and responses must be arrays of the same length.`)
+    //       }
+    //       macros.init = []
+    //       comType.initCommands.forEach((cmd: string, i: number) => {
+    //         // Extract flags and strip slashes if present:
+    //         let response = comType.initResponses[i] as string
+    //         let flags = ''
+    //         if(response.startsWith('/')) {
+    //           const lastSlash = response.lastIndexOf('/')
+    //           if(lastSlash < response.length - 1) {
+    //             flags = response.substring(lastSlash + 1)
+    //           }
+    //           response = response.substring(1, lastSlash)
+    //         }
+    //         // Add the macro:
+    //         macros.init.push(
+    //           new ComMacro(
+    //             cmd,
+    //             new RegExp(response, flags)
+    //           )
+    //         )
+    //       })
+    //       // Add the com type:
+    //       this.types.push(new ComType(
+    //         name,
+    //         comType.baud,
+    //         macros as {[method: string]: ComMacro[], init: ComMacro[]}
+    //       ))
+    //       debug(`Loaded com type ${comType.toString()}`);
+    //     })
+    //   }
+    async list(type, operationId, params) {
+        const results = [];
+        const ports = this.ports.filter(p => p.type?.name === type);
+        for (let index = 0; index < ports.length; index++) {
+            results.push(await this.send(type, index, operationId, params));
+        }
+        return results;
+    }
+    async send(type, index_name, operationId, params) {
+        const port = this.getComPort(type, index_name);
+        const responses = await port.send(operationId, params);
+        return responses;
+    }
+}
+exports.ComManager = ComManager;
+//# sourceMappingURL=ComManager.js.map

package/dist/ComManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ComManager.js","sourceRoot":"","sources":["../src/ComManager.ts"],"names":[],"mappings":"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"}