serial-core 0.1.0 → 0.2.0-dev.2

package/dist/core/QueueManager.d.ts

@@ -0,0 +1,33 @@
+/**
+ * QueueManager acts as an intermediate buffer.
+ * It prevents serial port saturation and guarantees messages
+ * leave in the order they arrived (FIFO).
+ */
+export declare class QueueManager {
+    private queue;
+    private isProcessing;
+    private _currentAlias;
+    private writeHandler;
+    constructor(writeHandler: (data: Buffer | string) => Promise<void>);
+    /**
+     * Adds a command to the queue and returns a promise
+     * that resolves when the command has been drained to the port.
+     */
+    add(data: Buffer | string, options?: {
+        alias?: string;
+        timeout?: number;
+    }): Promise<void>;
+    /**
+     * Getter for the alias of the command currently processing (or just processed).
+     * Useful for correlating responses.
+     */
+    get currentAlias(): string | undefined;
+    /**
+     * Clears the queue (useful on abrupt disconnections)
+     */
+    clear(): void;
+    /**
+     * Recursive processing loop
+     */
+    private process;
+}

package/dist/index.cjs

@@ -0,0 +1 @@
+var e=Object.create,t=Object.defineProperty,n=Object.getOwnPropertyDescriptor,r=Object.getOwnPropertyNames,i=Object.getPrototypeOf,a=Object.prototype.hasOwnProperty,o=(e,i,o,s)=>{if(i&&typeof i==`object`||typeof i==`function`)for(var c=r(i),l=0,u=c.length,d;l<u;l++)d=c[l],!a.call(e,d)&&d!==o&&t(e,d,{get:(e=>i[e]).bind(null,d),enumerable:!(s=n(i,d))||s.enumerable});return e},s=(n,r,a)=>(a=n==null?{}:e(i(n)),o(r||!n||!n.__esModule?t(a,`default`,{value:n,enumerable:!0}):a,n));const c=s(require(`serialport`)),l=s(require(`events`)),u={DISCONNECTED:`DISCONNECTED`,SCANNING:`SCANNING`,CONNECTING:`CONNECTING`,CONNECTED:`CONNECTED`,RECONNECTING:`RECONNECTING`};var d=class{queue=[];isProcessing=!1;_currentAlias=void 0;writeHandler;constructor(e){this.writeHandler=e}add(e,t){return new Promise((n,r)=>{this.queue.push({data:e,resolve:n,reject:r,alias:t?.alias,timeout:t?.timeout}),this.process()})}get currentAlias(){return this._currentAlias}clear(){this.queue.forEach(e=>e.reject(Error(`Queue cleared due to disconnection`))),this.queue=[],this.isProcessing=!1}async process(){if(this.isProcessing||this.queue.length===0)return;this.isProcessing=!0;let e=this.queue.shift();if(!e){this.isProcessing=!1;return}this._currentAlias=e.alias;let t=null,n=!1;try{e.timeout&&e.timeout>0&&(t=setTimeout(()=>{n=!0,e.reject(Error(`Command timeout after ${e.timeout}ms`)),this.isProcessing=!1,this.process()},e.timeout)),await this.writeHandler(e.data),n||(t&&clearTimeout(t),e.resolve())}catch(r){n||(t&&clearTimeout(t),e.reject(r instanceof Error?r:Error(String(r))))}finally{n||(this.isProcessing=!1,this.process())}}},f=class{static async findPort(e,t){if(!e&&!t)throw Error(`VendorID or ProductID is required for automatic scanning.`);try{let n=await c.SerialPort.list(),r=n.find(n=>{let r=n.vendorId?.toLowerCase()||``,i=n.productId?.toLowerCase()||``,a=(e||``).toLowerCase().replace(`0x`,``),o=(t||``).toLowerCase().replace(`0x`,``),s=e?r.includes(a):!0,c=t?i.includes(o):!0;return s&&c});return r?r.path:null}catch(e){return console.error(`Error scanning ports:`,e),null}}},p=class e{static instance;lockedPorts=new Set;constructor(){}static getInstance(){return e.instance||=new e,e.instance}register(e){return this.lockedPorts.has(e)?!1:(this.lockedPorts.add(e),!0)}unregister(e){this.lockedPorts.delete(e)}isLocked(e){return this.lockedPorts.has(e)}},m=class extends l.EventEmitter{port=null;queue;_status=u.DISCONNECTED;config;intentionalDisconnect=!1;reconnectTimer=null;constructor(e){super(),this.config=e,this.queue=new d(async e=>this.performWrite(e)),this.config.autoConnect&&this.connect()}get status(){return this._status}setStatus(e){this._status!==e&&(this._status=e,this.emit(`status`,e))}async connect(){if(this._status===u.CONNECTED||this._status===u.CONNECTING)return;this.intentionalDisconnect=!1,this.setStatus(u.SCANNING);let e=this.config.path;if(!e)try{let t=await f.findPort(this.config.vendorId,this.config.productId);if(t)e=t;else{this.handleConnectionFailure(`Device not found in scan`);return}}catch(e){this.handleConnectionFailure(`Error scanning: ${e}`);return}if(p.getInstance().isLocked(e)){this.handleConnectionFailure(`Port ${e} occupied by another internal instance`);return}if(!p.getInstance().register(e)){this.handleConnectionFailure(`Could not lock port ${e}`);return}this.setStatus(u.CONNECTING),this.openPort(e)}openPort(e){if(this.port=new c.SerialPort({path:e,baudRate:this.config.baudRate,autoOpen:!1}),this.port.open(t=>{if(t){this.handleConnectionFailure(t.message);return}this.config.handshake?this.performHandshake():(this.setStatus(u.CONNECTED),this.emit(`connected`,{path:e,baudRate:this.config.baudRate}))}),this.config.parser){let e=this.port.pipe(this.config.parser);e.on(`data`,e=>this.emit(`data`,e,this.queue.currentAlias)),e.on(`error`,e=>this.emit(`error`,e))}else this.port.on(`data`,e=>this.emit(`data`,e,this.queue.currentAlias));this.port.on(`error`,e=>{this.emit(`error`,e)}),this.port.on(`close`,()=>{this.cleanup(),this.emit(`disconnected`,this.intentionalDisconnect?`Manual`:`Unexpected`),this.intentionalDisconnect?this.setStatus(u.DISCONNECTED):(this.setStatus(u.RECONNECTING),this.scheduleReconnect())})}async disconnect(){if(this.intentionalDisconnect=!0,this.reconnectTimer&&clearTimeout(this.reconnectTimer),this.port&&this.port.isOpen)return new Promise(e=>{this.port?.close(()=>e())})}send(e,t){return this._status===u.CONNECTED?this.queue.add(e,t):Promise.reject(Error(`Port not connected`))}performWrite(e){return new Promise((t,n)=>{if(!this.port||!this.port.isOpen)return n(Error(`Port closed during write`));let r=!this.port.write(e,e=>{if(e)return n(e);r||t()});r&&this.port.once(`drain`,t)})}handleConnectionFailure(e){this.emit(`error`,Error(`Connection failure: ${e}`)),this.cleanup(),this.intentionalDisconnect||(this.setStatus(u.RECONNECTING),this.scheduleReconnect())}scheduleReconnect(){this.reconnectTimer&&clearTimeout(this.reconnectTimer),this.reconnectTimer=setTimeout(()=>{this.connect()},this.config.reconnectInterval)}cleanup(){this.port&&this.port.path&&p.getInstance().unregister(this.port.path),this.port&&(this.port.removeAllListeners(),this.port=null),this.config.parser&&(this.config.parser.removeAllListeners(`data`),this.config.parser.removeAllListeners(`error`)),this.intentionalDisconnect&&this.queue.clear()}performHandshake(){if(!this.port||!this.port.isOpen||!this.config.handshake)return;let{command:e,pattern:t,timeout:n}=this.config.handshake,r,i=e=>{let n=``;n=Buffer.isBuffer(e)?e.toString():typeof e==`string`?e:String(e);let r=typeof t==`string`?new RegExp(t):t;r.test(n)&&(a(),this.setStatus(u.CONNECTED),this.emit(`connected`,{path:this.port.path,baudRate:this.config.baudRate}))},a=()=>{clearTimeout(r),this.removeListener(`data`,o)},o=e=>i(e);this.on(`data`,o),r=setTimeout(()=>{a(),this.handleConnectionFailure(`Handshake timeout (pattern: ${t})`)},n),this.performWrite(e).catch(e=>{a(),this.handleConnectionFailure(`Error writing handshake: ${e.message}`)})}};function h(e){return Buffer.isBuffer(e)?e:e instanceof Uint8Array?Buffer.from(e.buffer,e.byteOffset,e.byteLength):(Array.isArray(e),Buffer.from(e))}function g(e){return e}function _(e,t=`utf8`){return e.toString(t)}function v(e){return e.toString(`ascii`)}function y(e){return[...e]}exports.PortScanner=f,exports.SerialService=m,exports.SerialStatus=u,exports.toArray=y,exports.toAscii=v,exports.toBuffer=h,exports.toString=_,exports.toUint8Array=g;

package/dist/index.d.cts

@@ -0,0 +1,13 @@
+/**
+ * @license GPL-3.0 serial-core
+ *
+ * Created by (c) Danidoble.
+ *
+ * This source code is licensed under the GPL-3.0 license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+export { SerialService } from './SerialService.ts';
+export { SerialStatus } from './types.ts';
+export type { SerialConfig, SerialEvents } from './types.ts';
+export * from './utils/buffers.ts';
+export { PortScanner } from './core/PortScanner.ts';

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @license GPL-3.0 serial-core
+ *
+ * Created by (c) Danidoble.
+ *
+ * This source code is licensed under the GPL-3.0 license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+export { SerialService } from './SerialService.ts';
+export { SerialStatus } from './types.ts';
+export type { SerialConfig, SerialEvents } from './types.ts';
+export * from './utils/buffers.ts';
+export { PortScanner } from './core/PortScanner.ts';

package/dist/index.js

@@ -0,0 +1 @@
+import{SerialPort as e}from"serialport";import{EventEmitter as t}from"events";const n={DISCONNECTED:`DISCONNECTED`,SCANNING:`SCANNING`,CONNECTING:`CONNECTING`,CONNECTED:`CONNECTED`,RECONNECTING:`RECONNECTING`};var r=class{queue=[];isProcessing=!1;_currentAlias=void 0;writeHandler;constructor(e){this.writeHandler=e}add(e,t){return new Promise((n,r)=>{this.queue.push({data:e,resolve:n,reject:r,alias:t?.alias,timeout:t?.timeout}),this.process()})}get currentAlias(){return this._currentAlias}clear(){this.queue.forEach(e=>e.reject(Error(`Queue cleared due to disconnection`))),this.queue=[],this.isProcessing=!1}async process(){if(this.isProcessing||this.queue.length===0)return;this.isProcessing=!0;let e=this.queue.shift();if(!e){this.isProcessing=!1;return}this._currentAlias=e.alias;let t=null,n=!1;try{e.timeout&&e.timeout>0&&(t=setTimeout(()=>{n=!0,e.reject(Error(`Command timeout after ${e.timeout}ms`)),this.isProcessing=!1,this.process()},e.timeout)),await this.writeHandler(e.data),n||(t&&clearTimeout(t),e.resolve())}catch(r){n||(t&&clearTimeout(t),e.reject(r instanceof Error?r:Error(String(r))))}finally{n||(this.isProcessing=!1,this.process())}}},i=class{static async findPort(t,n){if(!t&&!n)throw Error(`VendorID or ProductID is required for automatic scanning.`);try{let r=await e.list(),i=r.find(e=>{let r=e.vendorId?.toLowerCase()||``,i=e.productId?.toLowerCase()||``,a=(t||``).toLowerCase().replace(`0x`,``),o=(n||``).toLowerCase().replace(`0x`,``),s=t?r.includes(a):!0,c=n?i.includes(o):!0;return s&&c});return i?i.path:null}catch(e){return console.error(`Error scanning ports:`,e),null}}},a=class e{static instance;lockedPorts=new Set;constructor(){}static getInstance(){return e.instance||=new e,e.instance}register(e){return this.lockedPorts.has(e)?!1:(this.lockedPorts.add(e),!0)}unregister(e){this.lockedPorts.delete(e)}isLocked(e){return this.lockedPorts.has(e)}},o=class extends t{port=null;queue;_status=n.DISCONNECTED;config;intentionalDisconnect=!1;reconnectTimer=null;constructor(e){super(),this.config=e,this.queue=new r(async e=>this.performWrite(e)),this.config.autoConnect&&this.connect()}get status(){return this._status}setStatus(e){this._status!==e&&(this._status=e,this.emit(`status`,e))}async connect(){if(this._status===n.CONNECTED||this._status===n.CONNECTING)return;this.intentionalDisconnect=!1,this.setStatus(n.SCANNING);let e=this.config.path;if(!e)try{let t=await i.findPort(this.config.vendorId,this.config.productId);if(t)e=t;else{this.handleConnectionFailure(`Device not found in scan`);return}}catch(e){this.handleConnectionFailure(`Error scanning: ${e}`);return}if(a.getInstance().isLocked(e)){this.handleConnectionFailure(`Port ${e} occupied by another internal instance`);return}if(!a.getInstance().register(e)){this.handleConnectionFailure(`Could not lock port ${e}`);return}this.setStatus(n.CONNECTING),this.openPort(e)}openPort(t){if(this.port=new e({path:t,baudRate:this.config.baudRate,autoOpen:!1}),this.port.open(e=>{if(e){this.handleConnectionFailure(e.message);return}this.config.handshake?this.performHandshake():(this.setStatus(n.CONNECTED),this.emit(`connected`,{path:t,baudRate:this.config.baudRate}))}),this.config.parser){let e=this.port.pipe(this.config.parser);e.on(`data`,e=>this.emit(`data`,e,this.queue.currentAlias)),e.on(`error`,e=>this.emit(`error`,e))}else this.port.on(`data`,e=>this.emit(`data`,e,this.queue.currentAlias));this.port.on(`error`,e=>{this.emit(`error`,e)}),this.port.on(`close`,()=>{this.cleanup(),this.emit(`disconnected`,this.intentionalDisconnect?`Manual`:`Unexpected`),this.intentionalDisconnect?this.setStatus(n.DISCONNECTED):(this.setStatus(n.RECONNECTING),this.scheduleReconnect())})}async disconnect(){if(this.intentionalDisconnect=!0,this.reconnectTimer&&clearTimeout(this.reconnectTimer),this.port&&this.port.isOpen)return new Promise(e=>{this.port?.close(()=>e())})}send(e,t){return this._status===n.CONNECTED?this.queue.add(e,t):Promise.reject(Error(`Port not connected`))}performWrite(e){return new Promise((t,n)=>{if(!this.port||!this.port.isOpen)return n(Error(`Port closed during write`));let r=!this.port.write(e,e=>{if(e)return n(e);r||t()});r&&this.port.once(`drain`,t)})}handleConnectionFailure(e){this.emit(`error`,Error(`Connection failure: ${e}`)),this.cleanup(),this.intentionalDisconnect||(this.setStatus(n.RECONNECTING),this.scheduleReconnect())}scheduleReconnect(){this.reconnectTimer&&clearTimeout(this.reconnectTimer),this.reconnectTimer=setTimeout(()=>{this.connect()},this.config.reconnectInterval)}cleanup(){this.port&&this.port.path&&a.getInstance().unregister(this.port.path),this.port&&(this.port.removeAllListeners(),this.port=null),this.config.parser&&(this.config.parser.removeAllListeners(`data`),this.config.parser.removeAllListeners(`error`)),this.intentionalDisconnect&&this.queue.clear()}performHandshake(){if(!this.port||!this.port.isOpen||!this.config.handshake)return;let{command:e,pattern:t,timeout:r}=this.config.handshake,i,a=e=>{let r=``;r=Buffer.isBuffer(e)?e.toString():typeof e==`string`?e:String(e);let i=typeof t==`string`?new RegExp(t):t;i.test(r)&&(o(),this.setStatus(n.CONNECTED),this.emit(`connected`,{path:this.port.path,baudRate:this.config.baudRate}))},o=()=>{clearTimeout(i),this.removeListener(`data`,s)},s=e=>a(e);this.on(`data`,s),i=setTimeout(()=>{o(),this.handleConnectionFailure(`Handshake timeout (pattern: ${t})`)},r),this.performWrite(e).catch(e=>{o(),this.handleConnectionFailure(`Error writing handshake: ${e.message}`)})}};function s(e){return Buffer.isBuffer(e)?e:e instanceof Uint8Array?Buffer.from(e.buffer,e.byteOffset,e.byteLength):(Array.isArray(e),Buffer.from(e))}function c(e){return e}function l(e,t=`utf8`){return e.toString(t)}function u(e){return e.toString(`ascii`)}function d(e){return[...e]}export{i as PortScanner,o as SerialService,n as SerialStatus,d as toArray,u as toAscii,s as toBuffer,l as toString,c as toUint8Array};

package/dist/types.d.cts

@@ -0,0 +1,39 @@
+export declare const SerialStatus: {
+    readonly DISCONNECTED: "DISCONNECTED";
+    readonly SCANNING: "SCANNING";
+    readonly CONNECTING: "CONNECTING";
+    readonly CONNECTED: "CONNECTED";
+    readonly RECONNECTING: "RECONNECTING";
+};
+export type SerialStatus = (typeof SerialStatus)[keyof typeof SerialStatus];
+export interface SerialConfig {
+    baudRate: number;
+    path?: string;
+    vendorId?: string;
+    productId?: string;
+    reconnectInterval: number;
+    autoConnect: boolean;
+    parser?: NodeJS.ReadWriteStream;
+    handshake?: {
+        command: string | Buffer;
+        pattern: string | RegExp;
+        timeout: number;
+    };
+}
+export interface QueueItem {
+    data: Buffer | string;
+    alias?: string;
+    timeout?: number;
+    resolve: () => void;
+    reject: (err: Error) => void;
+}
+export interface SerialEvents {
+    status: (status: SerialStatus) => void;
+    data: (data: Buffer | string, alias?: string) => void;
+    error: (err: Error) => void;
+    connected: (info: {
+        path: string;
+        baudRate: number;
+    }) => void;
+    disconnected: (reason: string) => void;
+}

package/dist/types.d.ts

@@ -0,0 +1,39 @@
+export declare const SerialStatus: {
+    readonly DISCONNECTED: "DISCONNECTED";
+    readonly SCANNING: "SCANNING";
+    readonly CONNECTING: "CONNECTING";
+    readonly CONNECTED: "CONNECTED";
+    readonly RECONNECTING: "RECONNECTING";
+};
+export type SerialStatus = (typeof SerialStatus)[keyof typeof SerialStatus];
+export interface SerialConfig {
+    baudRate: number;
+    path?: string;
+    vendorId?: string;
+    productId?: string;
+    reconnectInterval: number;
+    autoConnect: boolean;
+    parser?: NodeJS.ReadWriteStream;
+    handshake?: {
+        command: string | Buffer;
+        pattern: string | RegExp;
+        timeout: number;
+    };
+}
+export interface QueueItem {
+    data: Buffer | string;
+    alias?: string;
+    timeout?: number;
+    resolve: () => void;
+    reject: (err: Error) => void;
+}
+export interface SerialEvents {
+    status: (status: SerialStatus) => void;
+    data: (data: Buffer | string, alias?: string) => void;
+    error: (err: Error) => void;
+    connected: (info: {
+        path: string;
+        baudRate: number;
+    }) => void;
+    disconnected: (reason: string) => void;
+}

package/dist/utils/buffers.d.cts

@@ -0,0 +1,27 @@
+/**
+ * Optimized helpers for Buffer operations.
+ * Designed to minimize unnecessary copies and validations where possible.
+ */
+/**
+ * Efficiently converts various input types to Buffer.
+ * If input is already a Buffer, returns it as is (zero-copy).
+ */
+export declare function toBuffer(data: string | number[] | Uint8Array | Buffer): Buffer;
+/**
+ * Converts a Buffer to Uint8Array.
+ * In Node.js, Buffers ARE Uint8Arrays, so this is ideally zero-copy.
+ */
+export declare function toUint8Array(buf: Buffer): Uint8Array;
+/**
+ * Converts a Buffer to string with optional encoding (default utf8).
+ * Wrapper alias for toString().
+ */
+export declare function toString(buf: Buffer, encoding?: BufferEncoding): string;
+/**
+ * Optimally converts to ASCII.
+ */
+export declare function toAscii(buf: Buffer): string;
+/**
+ * Converts a Buffer to an Array of numbers (bytes).
+ */
+export declare function toArray(buf: Buffer): number[];

package/dist/utils/buffers.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Optimized helpers for Buffer operations.
+ * Designed to minimize unnecessary copies and validations where possible.
+ */
+/**
+ * Efficiently converts various input types to Buffer.
+ * If input is already a Buffer, returns it as is (zero-copy).
+ */
+export declare function toBuffer(data: string | number[] | Uint8Array | Buffer): Buffer;
+/**
+ * Converts a Buffer to Uint8Array.
+ * In Node.js, Buffers ARE Uint8Arrays, so this is ideally zero-copy.
+ */
+export declare function toUint8Array(buf: Buffer): Uint8Array;
+/**
+ * Converts a Buffer to string with optional encoding (default utf8).
+ * Wrapper alias for toString().
+ */
+export declare function toString(buf: Buffer, encoding?: BufferEncoding): string;
+/**
+ * Optimally converts to ASCII.
+ */
+export declare function toAscii(buf: Buffer): string;
+/**
+ * Converts a Buffer to an Array of numbers (bytes).
+ */
+export declare function toArray(buf: Buffer): number[];

package/package.json

@@ -1,58 +1,72 @@
 {
-    "name": "serial-core",
-    "type": "module",
-    "version": "0.1.0",
-    "description": "A easy way to work with serial ports in Node.js",
-    "author": "Danidoble <danidoble@gmail.com>",
-    "license": "GPL-3.0-only",
-    "homepage": "https://github.com/danidoble/serial-core#readme",
-    "repository": {
-        "type": "git",
-        "url": "git+https://github.com/danidoble/serial-core.git"
-    },
-    "bugs": {
-        "url": "https://github.com/danidoble/serial-core/issues"
-    },
-    "exports": {
-        ".": {
-            "require": "./dist/serial-core.cjs",
-            "import": "./dist/serial-core.mjs"
-        },
-        "./package.json": "./package.json"
-    },
-    "main": "./dist/serial-core.cjs",
-    "module": "./dist/serial-core.mjs",
-    "types": "./dist/serial-core.d.cts",
-    "files": [
-        "dist"
-    ],
-    "engines": {
-        "node": ">=22"
-    },
-    "scripts": {
-        "build": "prettier --write ./lib/ && tsdown",
-        "dev": "tsdown --watch",
-        "test": "vitest",
-        "typecheck": "tsc --noEmit",
-        "prepublishOnly": "npm run build",
-        "clean": "rm -rf ./dist/",
-        "format": "prettier --write ./lib/"
-    },
-    "devDependencies": {
-        "@danidoble/webserial-vending-commands": "^1.0.3",
-        "@serialport/binding-mock": "^10.2.2",
-        "@serialport/parser-byte-length": "^13.0.0",
-        "@serialport/parser-delimiter": "^13.0.0",
-        "@serialport/parser-inter-byte-timeout": "^13.0.0",
-        "@types/node": "^25.0.3",
-        "bumpp": "^10.3.2",
-        "prettier": "3.7.4",
-        "serialport": "^13.0.0",
-        "tsdown": "^0.18.4",
-        "typescript": "^5.9.3",
-        "vitest": "^4.0.16"
-    },
-    "peerDependencies": {
-        "serialport": "^13.0.0"
+  "name": "serial-core",
+  "type": "module",
+  "version": "0.2.0-dev.2",
+  "description": "Resilient serial communication service with automatic reconnection and queues.",
+  "author": "Danidoble <danidoble@gmail.com>",
+  "license": "GPL-3.0-only",
+  "homepage": "https://github.com/danidoble/serial-core#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/danidoble/serial-core.git"
+  },
+  "bugs": {
+    "url": "https://github.com/danidoble/serial-core/issues"
+  },
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs",
+      "types": "./dist/index.d.ts"
     }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "dev": "tsdown --watch",
+    "build": "prettier --write ./src/ && tsdown",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest",
+    "prepublishOnly": "npm run build",
+    "clean": "rm -rf ./dist/",
+    "format": "prettier --write ./src/",
+    "lint": "eslint ."
+  },
+  "keywords": [
+    "serialport",
+    "iot",
+    "resilience",
+    "typescript",
+    "queue",
+    "handshake",
+    "auto-discovery",
+    "parser",
+    "scanner",
+    "reconnection",
+    "event-driven"
+  ],
+  "devDependencies": {
+    "@eslint/js": "^9.39.2",
+    "@types/node": "^20.0.0",
+    "bumpp": "^10.4.0",
+    "eslint": "^9.39.2",
+    "globals": "^17.0.0",
+    "jiti": "^2.6.1",
+    "prettier": "^3.8.0",
+    "serialport": "^13.0.0",
+    "tsdown": "^0.2.17",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.53.0",
+    "vitest": "^4.0.17"
+  },
+  "peerDependencies": {
+    "serialport": "^13.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
 }

package/dist/serial-core.cjs

@@ -1 +0,0 @@
-let e=require(`serialport`);var t=class extends CustomEvent{constructor(e,t){super(e,t)}},n=class extends EventTarget{_listeners={debug:!1};_debug=!1;_listenersCallbacks=[];dispatch(e,n={}){let r=new t(e,{detail:n});this.dispatchEvent(r),this._debug&&this.dispatchEvent(new t(`debug`,{detail:{type:e,data:n}}))}dispatchAsync(e,t={},n=100){setTimeout(()=>this.dispatch(e,t),n)}on(e,t){this._listeners[e]!==void 0&&!this._listeners[e]&&(this._listeners[e]=!0),this._listenersCallbacks.push({key:e,callback:t}),this.addEventListener(e,t)}off(e,t){this._listenersCallbacks=this._listenersCallbacks.filter(n=>!(n.key===e&&n.callback===t)),this.removeEventListener(e,t)}serialRegisterAvailableListener(e){this._listeners[e]||(this._listeners[e]=!1)}get availableListeners(){return Object.keys(this._listeners).sort().map(e=>({type:e,listening:this._listeners[e]}))}removeAllListeners(){for(let e of this._listenersCallbacks)[`internal:queue`].includes(e.key)||(this._listenersCallbacks=this._listenersCallbacks.filter(t=>!(t.key===e.key&&t.callback===e.callback)),this.removeEventListener(e.key,e.callback));for(let e of Object.keys(this._listeners))this._listeners[e]=!1}},r=class extends n{config={path:``,baudRate:9600,dataBits:8,lock:!0,stopBits:1,parity:`none`,rtscts:!1,xon:!1,xoff:!1,xany:!1,hupcl:!0};filters={};port=null;queue=[];connectionCmd=null;timeoutAfterWrite=500;timeoutInstance=null;lastAction=null;wasConnected=!1;channelNumber=1;isConnected=!1;constructor({port:e=null}){super(),this.port=e,this.initListeners()}setFilters({vendorId:e,productId:t}){return this.filters={...this.filters,vendorId:e||null},this.filters={...this.filters,productId:t||null},this}getFilters(){return this.filters}setConfig(e){return this.config={...this.config,...e},this}getConfig(){return this.config}async getAvailablePorts(){return(await e.SerialPort.list()).filter(e=>!(!e.path||!e.vendorId||!e.productId||this.filters.vendorId&&e.vendorId.toLowerCase()!==this.filters.vendorId.toLowerCase()||this.filters.productId&&e.productId.toLowerCase()!==this.filters.productId.toLowerCase()))}getConnectionCmd(){return this.connectionCmd}initListeners(){this.on(`internal:queue`,()=>this.runQueue())}async runQueue(){this.port&&this.port.isOpen&&this.queue.length!==0&&(this.timeoutInstance||await this.write())}async onTimeout(e,t){if(!this.wasConnected&&this.lastAction===`connection:start`){this.port?.close(),this.isConnected=!1,this.wasConnected=!1;return}this.timeoutInstance&&=(clearTimeout(this.timeoutInstance),null),this.dispatch(`internal:queue`),this.dispatch(`serial:timeout`,{message:`Operation timed out`,bytes:e,action:t}),console.error(`Timeout after write`,this.lastAction)}startListeningPort(){this.port&&(this.port.open(e=>{if(!this.port)return console.log(`Port is not defined`);if(e)return console.log(`Error opening port: `,e.message);if(!this.connectionCmd)throw Error(`Connection command is not defined`);this.lastAction=`connection:start`,this.timeoutInstance=setTimeout(()=>this.onTimeout(this.connectionCmd,this.lastAction),this.timeoutAfterWrite),this.port.write(this.connectionCmd)}),this.initParser())}onDataReceived(e){this.timeoutInstance&&=(clearTimeout(this.timeoutInstance),null),this.isConnected===!1&&(this.dispatch(`serial:connected`),this.wasConnected=!0,this.isConnected=!0),this.serialMessage(e),this.dispatch(`internal:queue`)}async write(){if(!this.port||this.queue.length===0)return;let e=this.queue[0];this.queue=this.queue.slice(1),this.lastAction=e.action||null,this.timeoutInstance=setTimeout(()=>this.onTimeout(e.bytes,this.lastAction),this.timeoutAfterWrite),this.port.write(e.bytes),this.dispatch(`serial:sent`,e)}async connect(){if(!this.port||!this.port.isOpen)return await this.openPort();if(!this.connectionCmd)throw Error(`Connection command is not defined`);this.appendToQueue(this.connectionCmd,this.port?.isOpen?`connect`:`connection:start`),this.dispatch(`internal:queue`)}async disconnect(){!this.port||!this.port.isOpen||(this.port.close(),this.isConnected=!1,this.wasConnected=!1,this.dispatch(`serial:disconnected`))}async appendToQueue(e,t){if([`connect`,`connection:start`].includes(t)&&(!this.port||!this.port.isOpen))return await this.openPort();this.queue.push({bytes:e,action:t}),this.dispatch(`internal:queue`)}async openPort(){if(this.port&&this.port.isOpen)return;if(this.port&&this.port instanceof e.SerialPortMock&&!this.port.isOpen){this.startListeningPort();return}let t=[],n=this.config;if(!this.config.path){if(t=await this.getAvailablePorts(),t.length===0)throw Error(`Port path is not defined`);t.length>1&&console.warn(`Multiple ports found, using the first one:`,t),n.path=t[0].path}this.port=new e.SerialPort({...n,autoOpen:!1}),this.startListeningPort()}stringToUint8Array(e){return console.warn(`stringToUint8Array is not recommended to use`),Buffer.from(e)}uint8ArrayToHexArray(e){return Array.from(e).map(e=>e.toString(16).toLowerCase().padStart(2,`0`))}stringToArrayHex(e){return Array.from(e).map(e=>e.charCodeAt(0).toString(16))}asciiToHex(e,t=``){let n=[];for(let t=0,r=e.length;t<r;t++){let r=Number(e.charCodeAt(t)).toString(16);n.push(r)}return n.join(t)}fixHexArray(e,t=2){return e.map(e=>typeof e==`string`?e.padStart(t,`0`).toLowerCase():e.toString(16).padStart(t,`0`).toLowerCase())}};exports.Core=r;

package/dist/serial-core.d.cts

@@ -1,140 +0,0 @@
-import { SerialPort, SerialPortMock } from "serialport";
-
-//#region lib/types/events.d.ts
-
-interface AvailableListener {
-  type: string;
-  listening: boolean;
-}
-type AvailableListeners = AvailableListener[];
-type DataType = string | number | boolean | object | null;
-// EventListenerOrEventListenerObject is not defined in node so we define it here
-interface EventListener {
-  (evt: Event): void;
-}
-interface EventListenerObject {
-  handleEvent(object: Event): void;
-}
-type EventListenerOrEventListenerObject = EventListener | EventListenerObject | ((event: SerialEventListener) => void);
-interface Dispatcher$1 {
-  dispatch(type: string, data?: DataType): void;
-  dispatchAsync(type: string, data?: DataType, ms?: number): void;
-  on(type: string, callback: EventListenerOrEventListenerObject): void;
-  off(type: string, callback: EventListenerOrEventListenerObject): void;
-  serialRegisterAvailableListener(type: string): void;
-  availableListeners: AvailableListeners;
-}
-interface Listeners {
-  [key: string]: boolean;
-  debug: boolean;
-}
-interface ListenersCallbacks {
-  key: string;
-  callback: EventListenerOrEventListenerObject;
-}
-//#endregion
-//#region lib/events/dispatcher.d.ts
-declare class Dispatcher extends EventTarget implements Dispatcher$1 {
-  protected _listeners: Listeners;
-  protected _debug: boolean;
-  protected _listenersCallbacks: ListenersCallbacks[];
-  dispatch(type: string, data?: DataType): void;
-  dispatchAsync(type: string, data?: DataType, ms?: number): void;
-  on(type: string, callback: EventListenerOrEventListenerObject): void;
-  off(type: string, callback: EventListenerOrEventListenerObject): void;
-  serialRegisterAvailableListener(type: string): void;
-  get availableListeners(): AvailableListeners;
-  removeAllListeners(): void;
-}
-//#endregion
-//#region lib/types/core.d.ts
-interface CoreConfig {
-  /** The system path of the serial port you want to open. For example, `/dev/tty.XXX` on Mac/Linux, or `COM1` on Windows */
-  path: string;
-  /**
-   * The baud rate of the port to be opened. This should match one of the commonly available baud rates, such as 110, 300, 1200, 2400, 4800, 9600, 14400, 19200, 38400, 57600, or 115200. Custom rates are supported best effort per platform. The device connected to the serial port is not guaranteed to support the requested baud rate, even if the port itself supports that baud rate.
-   */
-  baudRate: number;
-  /** Must be one of these: 5, 6, 7, or 8 defaults to 8 */
-  dataBits?: 5 | 6 | 7 | 8;
-  /** Prevent other processes from opening the port. Windows does not currently support `false`. Defaults to true */
-  lock?: boolean;
-  /** Must be 1, 1.5 or 2 defaults to 1 */
-  stopBits?: 1 | 1.5 | 2;
-  parity?: 'none' | 'even' | 'odd' | undefined;
-  /** Flow control Setting. Defaults to false */
-  rtscts?: boolean;
-  /** Flow control Setting. Defaults to false */
-  xon?: boolean;
-  /** Flow control Setting. Defaults to false */
-  xoff?: boolean;
-  /** Flow control Setting defaults to false*/
-  xany?: boolean;
-  /** drop DTR on close. Defaults to true */
-  hupcl?: boolean;
-}
-interface PortFilter {
-  vendorId?: string | null;
-  productId?: string | null;
-}
-interface PortInfo {
-  path: string;
-  manufacturer?: string;
-  serialNumber?: string;
-  pnpId?: string;
-  locationId?: string;
-  vendorId?: string;
-  productId?: string;
-}
-interface QueueItem {
-  action?: string;
-  bytes?: Uint8Array;
-}
-//#endregion
-//#region lib/serial/core.d.ts
-declare abstract class Core extends Dispatcher {
-  protected config: CoreConfig;
-  protected filters: PortFilter;
-  protected port: SerialPort | SerialPortMock | null;
-  protected queue: QueueItem[];
-  protected connectionCmd: Uint8Array | null;
-  protected timeoutAfterWrite: number;
-  protected timeoutInstance: ReturnType<typeof setTimeout> | null;
-  protected lastAction: null | string;
-  protected wasConnected: boolean;
-  channelNumber: number;
-  protected isConnected: boolean;
-  constructor({
-    port
-  }: {
-    port: SerialPort | SerialPortMock | null;
-  });
-  setFilters({
-    vendorId,
-    productId
-  }: PortFilter): Core;
-  getFilters(): PortFilter;
-  setConfig(config: CoreConfig): Core;
-  getConfig(): CoreConfig;
-  protected getAvailablePorts(): Promise<PortInfo[]>;
-  getConnectionCmd(): Uint8Array<ArrayBufferLike> | null;
-  protected initListeners(): void;
-  protected runQueue(): Promise<void>;
-  protected onTimeout(bytes: Uint8Array, event: string | null): Promise<void>;
-  protected startListeningPort(): void;
-  protected abstract initParser(): void;
-  protected onDataReceived(buffer: Buffer): void;
-  protected abstract serialMessage(buffer: Buffer): void;
-  protected write(): Promise<void>;
-  connect(): Promise<void>;
-  disconnect(): Promise<void>;
-  protected appendToQueue(bytes: Uint8Array, action: string): Promise<void>;
-  protected openPort(): Promise<void>;
-  stringToUint8Array(str: string): Uint8Array;
-  uint8ArrayToHexArray(array: Uint8Array): Array<string>;
-  stringToArrayHex(string: string): string[];
-  asciiToHex(asciiString: string, joinWith?: string): string;
-  fixHexArray(array: Array<string | number>, size?: number): string[];
-}
-//#endregion
-export { Core };

package/dist/serial-core.d.mts

@@ -1,140 +0,0 @@
-import { SerialPort, SerialPortMock } from "serialport";
-
-//#region lib/types/events.d.ts
-
-interface AvailableListener {
-  type: string;
-  listening: boolean;
-}
-type AvailableListeners = AvailableListener[];
-type DataType = string | number | boolean | object | null;
-// EventListenerOrEventListenerObject is not defined in node so we define it here
-interface EventListener {
-  (evt: Event): void;
-}
-interface EventListenerObject {
-  handleEvent(object: Event): void;
-}
-type EventListenerOrEventListenerObject = EventListener | EventListenerObject | ((event: SerialEventListener) => void);
-interface Dispatcher$1 {
-  dispatch(type: string, data?: DataType): void;
-  dispatchAsync(type: string, data?: DataType, ms?: number): void;
-  on(type: string, callback: EventListenerOrEventListenerObject): void;
-  off(type: string, callback: EventListenerOrEventListenerObject): void;
-  serialRegisterAvailableListener(type: string): void;
-  availableListeners: AvailableListeners;
-}
-interface Listeners {
-  [key: string]: boolean;
-  debug: boolean;
-}
-interface ListenersCallbacks {
-  key: string;
-  callback: EventListenerOrEventListenerObject;
-}
-//#endregion
-//#region lib/events/dispatcher.d.ts
-declare class Dispatcher extends EventTarget implements Dispatcher$1 {
-  protected _listeners: Listeners;
-  protected _debug: boolean;
-  protected _listenersCallbacks: ListenersCallbacks[];
-  dispatch(type: string, data?: DataType): void;
-  dispatchAsync(type: string, data?: DataType, ms?: number): void;
-  on(type: string, callback: EventListenerOrEventListenerObject): void;
-  off(type: string, callback: EventListenerOrEventListenerObject): void;
-  serialRegisterAvailableListener(type: string): void;
-  get availableListeners(): AvailableListeners;
-  removeAllListeners(): void;
-}
-//#endregion
-//#region lib/types/core.d.ts
-interface CoreConfig {
-  /** The system path of the serial port you want to open. For example, `/dev/tty.XXX` on Mac/Linux, or `COM1` on Windows */
-  path: string;
-  /**
-   * The baud rate of the port to be opened. This should match one of the commonly available baud rates, such as 110, 300, 1200, 2400, 4800, 9600, 14400, 19200, 38400, 57600, or 115200. Custom rates are supported best effort per platform. The device connected to the serial port is not guaranteed to support the requested baud rate, even if the port itself supports that baud rate.
-   */
-  baudRate: number;
-  /** Must be one of these: 5, 6, 7, or 8 defaults to 8 */
-  dataBits?: 5 | 6 | 7 | 8;
-  /** Prevent other processes from opening the port. Windows does not currently support `false`. Defaults to true */
-  lock?: boolean;
-  /** Must be 1, 1.5 or 2 defaults to 1 */
-  stopBits?: 1 | 1.5 | 2;
-  parity?: 'none' | 'even' | 'odd' | undefined;
-  /** Flow control Setting. Defaults to false */
-  rtscts?: boolean;
-  /** Flow control Setting. Defaults to false */
-  xon?: boolean;
-  /** Flow control Setting. Defaults to false */
-  xoff?: boolean;
-  /** Flow control Setting defaults to false*/
-  xany?: boolean;
-  /** drop DTR on close. Defaults to true */
-  hupcl?: boolean;
-}
-interface PortFilter {
-  vendorId?: string | null;
-  productId?: string | null;
-}
-interface PortInfo {
-  path: string;
-  manufacturer?: string;
-  serialNumber?: string;
-  pnpId?: string;
-  locationId?: string;
-  vendorId?: string;
-  productId?: string;
-}
-interface QueueItem {
-  action?: string;
-  bytes?: Uint8Array;
-}
-//#endregion
-//#region lib/serial/core.d.ts
-declare abstract class Core extends Dispatcher {
-  protected config: CoreConfig;
-  protected filters: PortFilter;
-  protected port: SerialPort | SerialPortMock | null;
-  protected queue: QueueItem[];
-  protected connectionCmd: Uint8Array | null;
-  protected timeoutAfterWrite: number;
-  protected timeoutInstance: ReturnType<typeof setTimeout> | null;
-  protected lastAction: null | string;
-  protected wasConnected: boolean;
-  channelNumber: number;
-  protected isConnected: boolean;
-  constructor({
-    port
-  }: {
-    port: SerialPort | SerialPortMock | null;
-  });
-  setFilters({
-    vendorId,
-    productId
-  }: PortFilter): Core;
-  getFilters(): PortFilter;
-  setConfig(config: CoreConfig): Core;
-  getConfig(): CoreConfig;
-  protected getAvailablePorts(): Promise<PortInfo[]>;
-  getConnectionCmd(): Uint8Array<ArrayBufferLike> | null;
-  protected initListeners(): void;
-  protected runQueue(): Promise<void>;
-  protected onTimeout(bytes: Uint8Array, event: string | null): Promise<void>;
-  protected startListeningPort(): void;
-  protected abstract initParser(): void;
-  protected onDataReceived(buffer: Buffer): void;
-  protected abstract serialMessage(buffer: Buffer): void;
-  protected write(): Promise<void>;
-  connect(): Promise<void>;
-  disconnect(): Promise<void>;
-  protected appendToQueue(bytes: Uint8Array, action: string): Promise<void>;
-  protected openPort(): Promise<void>;
-  stringToUint8Array(str: string): Uint8Array;
-  uint8ArrayToHexArray(array: Uint8Array): Array<string>;
-  stringToArrayHex(string: string): string[];
-  asciiToHex(asciiString: string, joinWith?: string): string;
-  fixHexArray(array: Array<string | number>, size?: number): string[];
-}
-//#endregion
-export { Core };

package/dist/serial-core.mjs

@@ -1 +0,0 @@
-import{SerialPort as e,SerialPortMock as t}from"serialport";var n=class extends CustomEvent{constructor(e,t){super(e,t)}},r=class extends EventTarget{_listeners={debug:!1};_debug=!1;_listenersCallbacks=[];dispatch(e,t={}){let r=new n(e,{detail:t});this.dispatchEvent(r),this._debug&&this.dispatchEvent(new n(`debug`,{detail:{type:e,data:t}}))}dispatchAsync(e,t={},n=100){setTimeout(()=>this.dispatch(e,t),n)}on(e,t){this._listeners[e]!==void 0&&!this._listeners[e]&&(this._listeners[e]=!0),this._listenersCallbacks.push({key:e,callback:t}),this.addEventListener(e,t)}off(e,t){this._listenersCallbacks=this._listenersCallbacks.filter(n=>!(n.key===e&&n.callback===t)),this.removeEventListener(e,t)}serialRegisterAvailableListener(e){this._listeners[e]||(this._listeners[e]=!1)}get availableListeners(){return Object.keys(this._listeners).sort().map(e=>({type:e,listening:this._listeners[e]}))}removeAllListeners(){for(let e of this._listenersCallbacks)[`internal:queue`].includes(e.key)||(this._listenersCallbacks=this._listenersCallbacks.filter(t=>!(t.key===e.key&&t.callback===e.callback)),this.removeEventListener(e.key,e.callback));for(let e of Object.keys(this._listeners))this._listeners[e]=!1}},i=class extends r{config={path:``,baudRate:9600,dataBits:8,lock:!0,stopBits:1,parity:`none`,rtscts:!1,xon:!1,xoff:!1,xany:!1,hupcl:!0};filters={};port=null;queue=[];connectionCmd=null;timeoutAfterWrite=500;timeoutInstance=null;lastAction=null;wasConnected=!1;channelNumber=1;isConnected=!1;constructor({port:e=null}){super(),this.port=e,this.initListeners()}setFilters({vendorId:e,productId:t}){return this.filters={...this.filters,vendorId:e||null},this.filters={...this.filters,productId:t||null},this}getFilters(){return this.filters}setConfig(e){return this.config={...this.config,...e},this}getConfig(){return this.config}async getAvailablePorts(){return(await e.list()).filter(e=>!(!e.path||!e.vendorId||!e.productId||this.filters.vendorId&&e.vendorId.toLowerCase()!==this.filters.vendorId.toLowerCase()||this.filters.productId&&e.productId.toLowerCase()!==this.filters.productId.toLowerCase()))}getConnectionCmd(){return this.connectionCmd}initListeners(){this.on(`internal:queue`,()=>this.runQueue())}async runQueue(){this.port&&this.port.isOpen&&this.queue.length!==0&&(this.timeoutInstance||await this.write())}async onTimeout(e,t){if(!this.wasConnected&&this.lastAction===`connection:start`){this.port?.close(),this.isConnected=!1,this.wasConnected=!1;return}this.timeoutInstance&&=(clearTimeout(this.timeoutInstance),null),this.dispatch(`internal:queue`),this.dispatch(`serial:timeout`,{message:`Operation timed out`,bytes:e,action:t}),console.error(`Timeout after write`,this.lastAction)}startListeningPort(){this.port&&(this.port.open(e=>{if(!this.port)return console.log(`Port is not defined`);if(e)return console.log(`Error opening port: `,e.message);if(!this.connectionCmd)throw Error(`Connection command is not defined`);this.lastAction=`connection:start`,this.timeoutInstance=setTimeout(()=>this.onTimeout(this.connectionCmd,this.lastAction),this.timeoutAfterWrite),this.port.write(this.connectionCmd)}),this.initParser())}onDataReceived(e){this.timeoutInstance&&=(clearTimeout(this.timeoutInstance),null),this.isConnected===!1&&(this.dispatch(`serial:connected`),this.wasConnected=!0,this.isConnected=!0),this.serialMessage(e),this.dispatch(`internal:queue`)}async write(){if(!this.port||this.queue.length===0)return;let e=this.queue[0];this.queue=this.queue.slice(1),this.lastAction=e.action||null,this.timeoutInstance=setTimeout(()=>this.onTimeout(e.bytes,this.lastAction),this.timeoutAfterWrite),this.port.write(e.bytes),this.dispatch(`serial:sent`,e)}async connect(){if(!this.port||!this.port.isOpen)return await this.openPort();if(!this.connectionCmd)throw Error(`Connection command is not defined`);this.appendToQueue(this.connectionCmd,this.port?.isOpen?`connect`:`connection:start`),this.dispatch(`internal:queue`)}async disconnect(){!this.port||!this.port.isOpen||(this.port.close(),this.isConnected=!1,this.wasConnected=!1,this.dispatch(`serial:disconnected`))}async appendToQueue(e,t){if([`connect`,`connection:start`].includes(t)&&(!this.port||!this.port.isOpen))return await this.openPort();this.queue.push({bytes:e,action:t}),this.dispatch(`internal:queue`)}async openPort(){if(this.port&&this.port.isOpen)return;if(this.port&&this.port instanceof t&&!this.port.isOpen){this.startListeningPort();return}let n=[],r=this.config;if(!this.config.path){if(n=await this.getAvailablePorts(),n.length===0)throw Error(`Port path is not defined`);n.length>1&&console.warn(`Multiple ports found, using the first one:`,n),r.path=n[0].path}this.port=new e({...r,autoOpen:!1}),this.startListeningPort()}stringToUint8Array(e){return console.warn(`stringToUint8Array is not recommended to use`),Buffer.from(e)}uint8ArrayToHexArray(e){return Array.from(e).map(e=>e.toString(16).toLowerCase().padStart(2,`0`))}stringToArrayHex(e){return Array.from(e).map(e=>e.charCodeAt(0).toString(16))}asciiToHex(e,t=``){let n=[];for(let t=0,r=e.length;t<r;t++){let r=Number(e.charCodeAt(t)).toString(16);n.push(r)}return n.join(t)}fixHexArray(e,t=2){return e.map(e=>typeof e==`string`?e.padStart(t,`0`).toLowerCase():e.toString(16).padStart(t,`0`).toLowerCase())}};export{i as Core};