rosinterface 1.3.0 → 1.3.2

package/dist/core/RestProtocol.js

@@ -49,6 +49,7 @@ class RestProtocol {
             const response = await fetch(url, fetchOptions);
             if (!response.ok) {
                 const rosError = await RosError_1.RosError.fromResponse(response, cmd);
+                // IDEMPOTENCY LOGIC
                 if (options?.idempotent && rosError.isDuplicate) {
                     const keyField = options.idempotencyKey || 'name';
                     if (body && body[keyField]) {
@@ -57,6 +58,7 @@ class RestProtocol {
                 }
                 throw rosError;
             }
+            // Handle 204 No Content (Success but no body, common in DELETE/PUT)
             if (response.status === 204) {
                 return null;
             }
@@ -89,10 +91,20 @@ class RestProtocol {
         }
         throw new Error(`Idempotency Failed: Item with ${keyField}='${value}' exists but could not be retrieved.`);
     }
+    /**
+     * Translates CLI commands to REST API logic according to Mikrotik v7 Docs.
+     * Mappings:
+     * - /print  -> GET
+     * - /add    -> PUT  (Fixed: Docs say PUT is for Create)
+     * - /set    -> PATCH
+     * - /remove -> DELETE
+     * - others  -> POST (Universal)
+     */
     translateToRest(cmd, params) {
         let cleanPath = cmd.replace(/\/+$/, '');
-        let method = 'POST';
+        let method = 'POST'; // Default safe verb
         let body = { ...params };
+        // CASE: PRINT (Read)
         if (cleanPath.endsWith('/print')) {
             if (Object.keys(params).length > 0) {
                 method = 'POST';
@@ -117,10 +129,12 @@ class RestProtocol {
                 body = undefined;
             }
         }
+        // CASE: ADD (Create) -> PUT
         else if (cleanPath.endsWith('/add')) {
             method = 'PUT';
             cleanPath = cleanPath.replace(/\/add$/, '');
         }
+        // CASE: SET (Update) -> PATCH
         else if (cleanPath.endsWith('/set')) {
             method = 'PATCH';
             cleanPath = cleanPath.replace(/\/set$/, '');
@@ -132,6 +146,7 @@ class RestProtocol {
                 throw new Error("RestProtocol: To use 'set' (PATCH), you must provide the '.id' parameter.");
             }
         }
+        // CASE: REMOVE (Delete) -> DELETE
         else if (cleanPath.endsWith('/remove')) {
             method = 'DELETE';
             cleanPath = cleanPath.replace(/\/remove$/, '');

package/dist/core/RestProtocol.js.map

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

package/dist/core/RosError.d.ts

@@ -6,13 +6,28 @@ export declare class RosError extends Error {
     readonly isRosError = true;
     readonly timestamp: Date;
     constructor(status: number, detail: string, command: string, rawResponse?: any | undefined);
+    /** Resource missing (404) */
     get isNotFound(): boolean;
+    /** Authentication failure (401) */
     get isAuthError(): boolean;
+    /** Permissions failure (403) */
     get isPermissionError(): boolean;
+    /** * Critical: Detects if the error is due to a duplicate item.
+     * Useful for Idempotency logic.
+     */
     get isDuplicate(): boolean;
+    /** Rate Limiting hit (429) */
     get isRateLimit(): boolean;
+    /** True if the error is likely temporary (503, 429, etc) */
     get isRetryable(): boolean;
+    /**
+     * static factory to parse a Fetch Response and throw/return a typed RosError.
+     * Encapsulates all the "dirty" JSON parsing logic from RouterOS.
+     */
     static fromResponse(response: Response, command: string): Promise<RosError>;
+    /**
+     * Custom generic JSON representation for logging systems (DataDog, Sentry, etc.)
+     */
     toJSON(): {
         errorType: string;
         status: number;

package/dist/core/RosError.js

@@ -1,9 +1,21 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.RosError = void 0;
+/**
+ * core/RosError.ts
+ *
+ * Sophisticated Error wrapper for RouterOS interactions.
+ * Features:
+ * - Semantic Getters (isNotFound, isAuthError, etc.)
+ * - Static Factory for parsing raw Fetch Responses.
+ * - JSON serialization support.
+ */
 const HttpConstants_1 = require("./HttpConstants");
 class RosError extends Error {
-    constructor(status, detail, command, rawResponse) {
+    constructor(status, detail, command, rawResponse // Saves the full JSON body for deep debugging
+    ) {
+        // Construct a highly readable log message
+        // Format: "RouterOS [404] Not Found (/ip/address/print) -> Item *99 not found"
         const prefix = HttpConstants_1.RosHttpMessages[status] || 'Unknown Error';
         super(`RouterOS [${status}] ${prefix} (${command}) -> ${detail}`);
         this.status = status;
@@ -13,40 +25,60 @@ class RosError extends Error {
         this.isRosError = true;
         this.name = 'RosError';
         this.timestamp = new Date();
+        // Fix for extending built-ins in TypeScript/ES6
         Object.setPrototypeOf(this, RosError.prototype);
     }
+    // --- 1. Surgical Precision Getters ---
+    /** Resource missing (404) */
     get isNotFound() {
         return this.status === HttpConstants_1.RosHttpStatus.NOT_FOUND;
     }
+    /** Authentication failure (401) */
     get isAuthError() {
         return this.status === HttpConstants_1.RosHttpStatus.UNAUTHORIZED;
     }
+    /** Permissions failure (403) */
     get isPermissionError() {
         return this.status === HttpConstants_1.RosHttpStatus.FORBIDDEN;
     }
+    /** * Critical: Detects if the error is due to a duplicate item.
+     * Useful for Idempotency logic.
+     */
     get isDuplicate() {
         if (this.status !== HttpConstants_1.RosHttpStatus.BAD_REQUEST)
             return false;
         const msg = this.detail.toLowerCase();
         return msg.includes('already exists') || msg.includes('already have');
     }
+    /** Rate Limiting hit (429) */
     get isRateLimit() {
         return this.status === HttpConstants_1.RosHttpStatus.TOO_MANY_REQUESTS;
     }
+    /** True if the error is likely temporary (503, 429, etc) */
     get isRetryable() {
+        // We import the logic from HttpConstants to keep it DRY
+        // (Assuming you exported the helper function, otherwise implement logic here)
         return [429, 503, 504, 502].includes(this.status);
     }
+    // --- 2. Factory Method (The Logic Cleaner) ---
+    /**
+     * static factory to parse a Fetch Response and throw/return a typed RosError.
+     * Encapsulates all the "dirty" JSON parsing logic from RouterOS.
+     */
     static async fromResponse(response, command) {
         const status = response.status;
         let detail = response.statusText;
         let rawBody = null;
         try {
             const text = await response.text();
+            // Try parsing JSON
             try {
                 rawBody = JSON.parse(text);
+                // RouterOS usually puts the error in 'detail' or 'message'
                 detail = rawBody.detail || rawBody.message || text;
             }
             catch {
+                // If not JSON, use the raw text (e.g. HTML from a proxy)
                 detail = text || detail;
             }
         }
@@ -55,6 +87,9 @@ class RosError extends Error {
         }
         return new RosError(status, detail, command, rawBody);
     }
+    /**
+     * Custom generic JSON representation for logging systems (DataDog, Sentry, etc.)
+     */
     toJSON() {
         return {
             errorType: 'RosError',

package/dist/core/RosError.js.map

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

package/dist/core/RosProtocol.d.ts

@@ -1,5 +1,26 @@
+/**
+ * RosProtocol.ts
+ * * This module is the "mathematical heart" of the library.
+ * It strictly handles the encoding and decoding of packet lengths
+ * according to MikroTik's proprietary standard.
+ * * Refactored and adapted from:
+ * - node-routeros/src/connector/Transmitter.ts
+ * - node-routeros/src/connector/Receiver.ts
+ */
 export declare class RosProtocol {
+    /**
+     * Converts a string (command) into a Buffer ready to be sent over the socket.
+     * Includes the variable Length Encoding calculation.
+     * * @param str The command or parameter (e.g., "/ip/address/print" or "=disabled=yes")
+     */
     static encodeSentence(str: string): Buffer;
+    /**
+     * Attempts to read the length of the next packet in the buffer.
+     * Refactored from Receiver.ts
+     * * @param buffer The raw data buffer received from the socket
+     * @returns An object containing the message length and the header byte size,
+     * or NULL if there is not enough data yet.
+     */
     static decodeLength(buffer: Buffer): {
         length: number;
         byteLength: number;

package/dist/core/RosProtocol.js

@@ -1,23 +1,45 @@
 "use strict";
+/**
+ * RosProtocol.ts
+ * * This module is the "mathematical heart" of the library.
+ * It strictly handles the encoding and decoding of packet lengths
+ * according to MikroTik's proprietary standard.
+ * * Refactored and adapted from:
+ * - node-routeros/src/connector/Transmitter.ts
+ * - node-routeros/src/connector/Receiver.ts
+ */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.RosProtocol = void 0;
 class RosProtocol {
+    /**
+     * Converts a string (command) into a Buffer ready to be sent over the socket.
+     * Includes the variable Length Encoding calculation.
+     * * @param str The command or parameter (e.g., "/ip/address/print" or "=disabled=yes")
+     */
     static encodeSentence(str) {
+        // Convert String to Bytes (Native UTF-8)
+        // Note: The legacy library used 'win1252' via iconv-lite.
+        // In 2025/26 and RouterOS v7, UTF-8 is preferable and requires no external dependencies.
         const encoded = Buffer.from(str, 'utf8');
         const len = encoded.length;
         let offset = 0;
         let header;
+        // Calculate how many bytes are needed to specify the length.
+        // This logic is adopted directly from Transmitter.ts logic.
         if (len < 0x80) {
+            // 1 byte for length
             header = Buffer.alloc(1);
             header[offset++] = len;
         }
         else if (len < 0x4000) {
+            // 2 bytes
             header = Buffer.alloc(2);
             const lenBytes = len | 0x8000;
             header[offset++] = (lenBytes >> 8) & 0xff;
             header[offset++] = lenBytes & 0xff;
         }
         else if (len < 0x200000) {
+            // 3 bytes
             header = Buffer.alloc(3);
             const lenBytes = len | 0xc00000;
             header[offset++] = (lenBytes >> 16) & 0xff;
@@ -25,6 +47,7 @@ class RosProtocol {
             header[offset++] = lenBytes & 0xff;
         }
         else if (len < 0x10000000) {
+            // 4 bytes
             header = Buffer.alloc(4);
             const lenBytes = len | 0xe0000000;
             header[offset++] = (lenBytes >> 24) & 0xff;
@@ -33,6 +56,7 @@ class RosProtocol {
             header[offset++] = lenBytes & 0xff;
         }
         else {
+            // 5 bytes (Extreme cases for giant payloads)
             header = Buffer.alloc(5);
             header[offset++] = 0xf0;
             header[offset++] = (len >> 24) & 0xff;
@@ -40,39 +64,54 @@ class RosProtocol {
             header[offset++] = (len >> 8) & 0xff;
             header[offset++] = len & 0xff;
         }
+        // 3. Concatenate the header (length) with the body (command)
         return Buffer.concat([header, encoded]);
     }
+    /**
+     * Attempts to read the length of the next packet in the buffer.
+     * Refactored from Receiver.ts
+     * * @param buffer The raw data buffer received from the socket
+     * @returns An object containing the message length and the header byte size,
+     * or NULL if there is not enough data yet.
+     */
     static decodeLength(buffer) {
         if (buffer.length === 0)
             return null;
         const b = buffer[0];
+        // Inverse bitwise logic to detect which length scheme was used
+        // Case 1 byte (0xxxxxxx)
         if ((b & 0x80) === 0x00) {
             return { length: b, byteLength: 1 };
         }
+        // Case 2 bytes (10xxxxxx ...)
         if ((b & 0xC0) === 0x80) {
             if (buffer.length < 2)
-                return null;
+                return null; // Missing data
             const len = ((b & 0x3F) << 8) | buffer[1];
             return { length: len, byteLength: 2 };
         }
+        // Case 3 bytes (110xxxxx ...)
         if ((b & 0xE0) === 0xC0) {
             if (buffer.length < 3)
                 return null;
             const len = ((b & 0x1F) << 16) | (buffer[1] << 8) | buffer[2];
             return { length: len, byteLength: 3 };
         }
+        // Case 4 bytes (1110xxxx ...)
         if ((b & 0xF0) === 0xE0) {
             if (buffer.length < 4)
                 return null;
             const len = ((b & 0x0F) << 24) | (buffer[1] << 16) | (buffer[2] << 8) | buffer[3];
             return { length: len, byteLength: 4 };
         }
+        // Case 5 bytes (11110000 ...)
         if (b === 0xF0) {
             if (buffer.length < 5)
                 return null;
             const len = (buffer[1] << 24) | (buffer[2] << 16) | (buffer[3] << 8) | buffer[4];
             return { length: len, byteLength: 5 };
         }
+        // If we reach here, the initial byte is invalid according to the protocol
         return null;
     }
 }

package/dist/core/RosProtocol.js.map

@@ -1 +1 @@
-{"version":3,"file":"RosProtocol.js","sourceRoot":"","sources":["../../src/core/RosProtocol.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"RosProtocol.js","sourceRoot":"","sources":["../../src/core/RosProtocol.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AAEH,MAAa,WAAW;IAEpB;;;;OAIG;IACI,MAAM,CAAC,cAAc,CAAC,GAAW;QACpC,yCAAyC;QACzC,0DAA0D;QAC1D,yFAAyF;QACzF,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QAEzC,MAAM,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC;QAC3B,IAAI,MAAM,GAAG,CAAC,CAAC;QACf,IAAI,MAAc,CAAC;QAEnB,6DAA6D;QAC7D,4DAA4D;QAC5D,IAAI,GAAG,GAAG,IAAI,EAAE,CAAC;YACb,oBAAoB;YACpB,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YACzB,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,GAAG,CAAC;QAC3B,CAAC;aAAM,IAAI,GAAG,GAAG,MAAM,EAAE,CAAC;YACtB,UAAU;YACV,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YACzB,MAAM,QAAQ,GAAG,GAAG,GAAG,MAAM,CAAC;YAC9B,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,QAAQ,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC;YAC1C,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,QAAQ,GAAG,IAAI,CAAC;QACvC,CAAC;aAAM,IAAI,GAAG,GAAG,QAAQ,EAAE,CAAC;YACxB,UAAU;YACV,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YACzB,MAAM,QAAQ,GAAG,GAAG,GAAG,QAAQ,CAAC;YAChC,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,QAAQ,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC;YAC3C,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,QAAQ,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC;YAC1C,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,QAAQ,GAAG,IAAI,CAAC;QACvC,CAAC;aAAM,IAAI,GAAG,GAAG,UAAU,EAAE,CAAC;YAC1B,UAAU;YACV,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YACzB,MAAM,QAAQ,GAAG,GAAG,GAAG,UAAU,CAAC;YAClC,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,QAAQ,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC;YAC3C,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,QAAQ,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC;YAC3C,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,QAAQ,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC;YAC1C,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,QAAQ,GAAG,IAAI,CAAC;QACvC,CAAC;aAAM,CAAC;YACJ,6CAA6C;YAC7C,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YACzB,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,CAAC;YACxB,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC;YACtC,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC;YACtC,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC;YACrC,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,GAAG,GAAG,IAAI,CAAC;QAClC,CAAC;QAED,6DAA6D;QAC7D,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC5C,CAAC;IAED;;;;;;OAMG;IACI,MAAM,CAAC,YAAY,CAAC,MAAc;QACrC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QAErC,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QAEpB,+DAA+D;QAE/D,yBAAyB;QACzB,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;YACtB,OAAO,EAAE,MAAM,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC;QACxC,CAAC;QAED,8BAA8B;QAC9B,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;YACtB,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC;gBAAE,OAAO,IAAI,CAAC,CAAC,eAAe;YACnD,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;YAC1C,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC;QAC1C,CAAC;QAED,8BAA8B;QAC9B,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;YACtB,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC;gBAAE,OAAO,IAAI,CAAC;YACnC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;YAC9D,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC;QAC1C,CAAC;QAED,8BAA8B;QAC9B,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;YACtB,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC;gBAAE,OAAO,IAAI,CAAC;YACnC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;YAClF,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC;QAC1C,CAAC;QAED,8BAA8B;QAC9B,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;YACb,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC;gBAAE,OAAO,IAAI,CAAC;YACnC,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;YACjF,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC;QAC1C,CAAC;QAED,0EAA0E;QAC1E,OAAO,IAAI,CAAC;IAChB,CAAC;CACJ;AA5GD,kCA4GC"}

package/dist/core/SchemaMapper.d.ts

@@ -1,14 +1,55 @@
 import { MikrotikClient } from '../client/MikrotikClient';
+/**
+ * SchemaMapper
+ * * Responsible for the "Auto-Topology Discovery" feature.
+ * * It automatically detects the router's capabilities (Version, Architecture, Packages)
+ * upon connection and builds a map of "Smart Paths".
+ * * This allows the developer to use abstract aliases (like 'wifi') without worrying
+ * if the underlying router is running RouterOS v6 (legacy) or v7 (modern).
+ */
 export declare class SchemaMapper {
+    /** Full RouterOS version string (e.g., "7.12.1" or "6.49.10") */
     version: string;
+    /** The major version number (e.g., 7 or 6). Vital for logic branching. */
     majorVersion: number;
+    /** The hardware model name (e.g., "CCR2004-1G-12S+2XS") */
     boardName: string;
+    /** The CPU architecture (e.g., "arm64", "mipsbe", "tile") */
     architecture: string;
+    /** Flag indicating if the router has wireless capabilities installed */
     hasWireless: boolean;
+    /** Internal dictionary to store path translations */
     private pathAliases;
+    /**
+     * Scans the connected router to determine its specifications and capabilities.
+     * This method should be called immediately after a successful login.
+     * * @param client The active MikrotikClient instance.
+     */
     load(client: MikrotikClient): Promise<void>;
+    /**
+     * defines the translation rules for aliases based on the RouterOS version.
+     */
     private buildPathMap;
+    /**
+     * Resolves an abstract path alias to the concrete RouterOS path.
+     * * @example
+     * // On RouterOS v7:
+     * schema.resolve('wifi') // Returns "/interface/wifi"
+     * * // On RouterOS v6:
+     * schema.resolve('wifi') // Returns "/interface/wireless"
+     * * // Non-aliases are returned as is:
+     * schema.resolve('/ip/address') // Returns "/ip/address"
+     * * @param path The path alias or full path to resolve.
+     * @returns The actual menu path for the connected router.
+     */
     resolve(path: string): string;
+    /**
+     * Helper to determine if the connected router is running RouterOS v7 or higher.
+     * Useful for conditional logic in developer scripts.
+     */
     isV7(): boolean;
+    /**
+     * Helper to check if the router is running on ARM architecture (Performance tuning).
+     */
     isArm(): boolean;
 }

package/dist/core/SchemaMapper.js

@@ -1,25 +1,49 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SchemaMapper = void 0;
+/**
+ * SchemaMapper
+ * * Responsible for the "Auto-Topology Discovery" feature.
+ * * It automatically detects the router's capabilities (Version, Architecture, Packages)
+ * upon connection and builds a map of "Smart Paths".
+ * * This allows the developer to use abstract aliases (like 'wifi') without worrying
+ * if the underlying router is running RouterOS v6 (legacy) or v7 (modern).
+ */
 class SchemaMapper {
     constructor() {
+        /** Full RouterOS version string (e.g., "7.12.1" or "6.49.10") */
         this.version = '';
+        /** The major version number (e.g., 7 or 6). Vital for logic branching. */
         this.majorVersion = 0;
+        /** The hardware model name (e.g., "CCR2004-1G-12S+2XS") */
         this.boardName = '';
+        /** The CPU architecture (e.g., "arm64", "mipsbe", "tile") */
         this.architecture = '';
+        /** Flag indicating if the router has wireless capabilities installed */
         this.hasWireless = false;
+        /** Internal dictionary to store path translations */
         this.pathAliases = {};
     }
+    /**
+     * Scans the connected router to determine its specifications and capabilities.
+     * This method should be called immediately after a successful login.
+     * * @param client The active MikrotikClient instance.
+     */
     async load(client) {
         try {
+            // 1. Fetch vital system information
+            // We use the raw command to avoid circular dependency logic here
             const resourceCollection = await client.command('/system/resource').print();
             const resource = resourceCollection.first();
             if (resource) {
                 this.version = resource.version || '0.0.0';
+                // Extract the first number from "7.12.1" -> 7
                 this.majorVersion = parseInt(this.version.split('.')[0]);
                 this.boardName = resource['board-name'] || 'unknown';
                 this.architecture = resource['architecture-name'] || 'unknown';
             }
+            // 2. Detect installed packages (to determine if WiFi/IoT/Container features exist)
+            // Wrapped in try-catch because read-only users might not have permission to view packages.
             try {
                 const packages = await client.command('/system/package').print();
                 this.hasWireless = packages.filter(p => p.name === 'wireless' || p.name === 'wifiwave2' || p.name === 'wifi').count() > 0;
@@ -27,36 +51,67 @@ class SchemaMapper {
             catch (e) {
                 console.warn('[SchemaMapper] Warning: Could not scan packages (Permission denied?). Defaulting features to false.');
             }
+            // 3. Build the Smart Path Map based on the detected version
             this.buildPathMap();
             console.log(`Schema Loaded: RouterOS v${this.version} (${this.architecture}) on ${this.boardName}`);
         }
         catch (error) {
             console.error('Schema Discovery Failed:', error);
+            // Fallback: Assume v6 if detection fails to prevent crashes
             this.majorVersion = 6;
             this.buildPathMap();
         }
     }
+    /**
+     * defines the translation rules for aliases based on the RouterOS version.
+     */
     buildPathMap() {
         if (this.majorVersion >= 7) {
+            // --- MODERN ROUTEROS v7 MAPPINGS ---
+            // WiFi: v7 uses the new 'wifi' package (formerly wifiwave2) or legacy wireless
+            // We default to the modern interface, but this could be refined further.
             this.pathAliases['wifi'] = '/interface/wifi';
+            // Routing protocols structure changed significantly in v7
             this.pathAliases['bgp'] = '/routing/bgp/connection';
             this.pathAliases['ospf'] = '/routing/ospf/instance';
-            this.pathAliases['firewall'] = '/ip/firewall/filter';
+            this.pathAliases['firewall'] = '/ip/firewall/filter'; // Standard
         }
         else {
+            // --- LEGACY ROUTEROS v6 MAPPINGS ---
             this.pathAliases['wifi'] = '/interface/wireless';
             this.pathAliases['bgp'] = '/routing/bgp/peer';
-            this.pathAliases['ospf'] = '/routing/ospf/instance';
+            this.pathAliases['ospf'] = '/routing/ospf/instance'; // OSPFv2 usually
             this.pathAliases['firewall'] = '/ip/firewall/filter';
         }
     }
+    /**
+     * Resolves an abstract path alias to the concrete RouterOS path.
+     * * @example
+     * // On RouterOS v7:
+     * schema.resolve('wifi') // Returns "/interface/wifi"
+     * * // On RouterOS v6:
+     * schema.resolve('wifi') // Returns "/interface/wireless"
+     * * // Non-aliases are returned as is:
+     * schema.resolve('/ip/address') // Returns "/ip/address"
+     * * @param path The path alias or full path to resolve.
+     * @returns The actual menu path for the connected router.
+     */
     resolve(path) {
+        // Remove leading slash for dictionary lookup consistency
         const cleanPath = path.startsWith('/') ? path.substring(1) : path;
+        // Return the mapped alias if it exists, otherwise return the original path
         return this.pathAliases[cleanPath] || path;
     }
+    /**
+     * Helper to determine if the connected router is running RouterOS v7 or higher.
+     * Useful for conditional logic in developer scripts.
+     */
     isV7() {
         return this.majorVersion >= 7;
     }
+    /**
+     * Helper to check if the router is running on ARM architecture (Performance tuning).
+     */
     isArm() {
         return this.architecture === 'arm' || this.architecture === 'arm64';
     }

package/dist/core/SchemaMapper.js.map

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

package/dist/core/SocketClient.d.ts

@@ -1,23 +1,57 @@
 import { EventEmitter } from 'events';
 import { Buffer } from 'buffer';
+/**
+ * Configuration options for the Socket Client.
+ */
 export interface SocketClientOptions {
+    /** Target IP address or Hostname */
     host: string;
+    /** Target Port (default: 8728 for plain, 8729 for SSL) */
     port: number;
+    /** Connection timeout in seconds (default: 10) */
     timeout?: number;
+    /** Enable SSL/TLS encryption (default: false) */
     useTLS?: boolean;
+    /** If true, allows self-signed certificates (default: false) */
     rejectUnauthorized?: boolean;
+    /** Enable TCP Keep-Alive to prevent idle disconnects (default: true) */
     keepAlive?: boolean;
 }
+/**
+ * Low-level TCP/TLS Client.
+ * Responsibilities:
+ * 1. Transport Layer: Decides between 'net' (Plain) and 'tls' (Secure).
+ * 2. Event Handling: Manages socket errors, closures, and timeouts.
+ * 3. Framing: Buffers incoming raw bytes and splits them into valid MikroTik words.
+ */
 export declare class SocketClient extends EventEmitter {
     private socket;
     private options;
     connected: boolean;
     private receiveBuffer;
     constructor(options: SocketClientOptions);
+    /**
+     * Establishes the connection to the router.
+     * Supports both Plain TCP and TLS based on configuration.
+     * @returns Promise that resolves when the connection is fully established.
+     */
     connect(): Promise<void>;
+    /**
+     * Writes raw bytes to the socket stream.
+     */
     write(data: Buffer): void;
+    /**
+     * Gracefully closes the connection.
+     */
     close(): void;
+    /**
+     * Forcefully destroys the connection.
+     */
     destroy(): void;
     private cleanup;
+    /**
+     * CORE LOGIC: TCP Framing.
+     * Extracts valid MikroTik "Words" from the TCP stream.
+     */
     private handleDataChunk;
 }