rosinterface 1.0.0

package/dist/client/CommandBuilder.d.ts

@@ -0,0 +1,32 @@
+import { MikrotikClient, Subscription } from './MikrotikClient';
+import { MikrotikCollection } from '../utils/MikrotikCollection';
+export declare class CommandBuilder<T extends Record<string, any>> {
+    private readonly client;
+    private readonly menuPath;
+    private queryParams;
+    private propList;
+    private isPersistentRequest;
+    private static queryCache;
+    private static readonly CACHE_TTL_MS;
+    constructor(client: MikrotikClient, menuPath: string);
+    where(key: string, value: string | number | boolean): this;
+    whereExists(key: string): this;
+    select(fields: string[]): this;
+    persistent(): this;
+    findBy(criteria: Partial<T>): Promise<MikrotikCollection<T>>;
+    findOne(criteria: Partial<T>): Promise<T | null>;
+    print(extraParams?: Record<string, any>): Promise<MikrotikCollection<T>>;
+    private pruneCache;
+    first(): Promise<T | null>;
+    add(data: Partial<T>): Promise<string>;
+    set(id: string, data: Partial<T>): Promise<void>;
+    remove(id: string | string[]): Promise<void>;
+    listen(callback: (item: T) => void): Subscription;
+    listenMonitor(callback: (item: T) => void): Subscription;
+    private invalidatePathCache;
+    private shouldDefer;
+    private isClientConnected;
+    private getParams;
+    private formatValue;
+    private prepareParams;
+}

package/dist/client/CommandBuilder.js

@@ -0,0 +1,168 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CommandBuilder = void 0;
+const Helpers_1 = require("../utils/Helpers");
+const MikrotikCollection_1 = require("../utils/MikrotikCollection");
+const OfflineQueue_1 = require("../core/OfflineQueue");
+class CommandBuilder {
+    constructor(client, menuPath) {
+        this.queryParams = {};
+        this.propList = [];
+        this.isPersistentRequest = false;
+        this.client = client;
+        this.menuPath = menuPath.startsWith('/') ? menuPath : '/' + menuPath;
+        if (this.menuPath.endsWith('/') && this.menuPath.length > 1) {
+            this.menuPath = this.menuPath.slice(0, -1);
+        }
+    }
+    where(key, value) {
+        const kebabKey = (0, Helpers_1.camelToKebab)(key);
+        const formattedValue = this.formatValue(value);
+        this.queryParams[`?${kebabKey}`] = formattedValue;
+        return this;
+    }
+    whereExists(key) {
+        const kebabKey = (0, Helpers_1.camelToKebab)(key);
+        this.queryParams[`?${kebabKey}`] = '';
+        return this;
+    }
+    select(fields) {
+        const kebabFields = fields.map(f => (0, Helpers_1.camelToKebab)(f));
+        this.propList.push(...kebabFields);
+        return this;
+    }
+    persistent() {
+        this.isPersistentRequest = true;
+        return this;
+    }
+    async findBy(criteria) {
+        for (const [key, value] of Object.entries(criteria)) {
+            this.where(key, value);
+        }
+        return this.print();
+    }
+    async findOne(criteria) {
+        const collection = await this.findBy(criteria);
+        return collection.first();
+    }
+    async print(extraParams) {
+        const fluentParams = this.getParams();
+        const finalParams = { ...fluentParams, ...extraParams };
+        const host = this.client.options?.host || 'default';
+        const cacheKey = `${host}:${this.menuPath}:${JSON.stringify(finalParams)}`;
+        const cached = CommandBuilder.queryCache.get(cacheKey);
+        if (cached && Date.now() < cached.expires) {
+            return new MikrotikCollection_1.MikrotikCollection(cached.data);
+        }
+        const rawData = await this.client.write(`${this.menuPath}/print`, finalParams);
+        CommandBuilder.queryCache.set(cacheKey, {
+            data: rawData,
+            expires: Date.now() + CommandBuilder.CACHE_TTL_MS
+        });
+        if (Math.random() > 0.95)
+            this.pruneCache();
+        return new MikrotikCollection_1.MikrotikCollection(rawData);
+    }
+    pruneCache() {
+        const now = Date.now();
+        for (const [key, val] of CommandBuilder.queryCache.entries()) {
+            if (now > val.expires)
+                CommandBuilder.queryCache.delete(key);
+        }
+    }
+    async first() {
+        const collection = await this.print();
+        return collection.first();
+    }
+    async add(data) {
+        const params = this.prepareParams(data);
+        if (this.shouldDefer()) {
+            OfflineQueue_1.OfflineQueue.enqueue({ action: 'add', path: this.menuPath, params: params });
+            return 'QUEUED_OFFLINE';
+        }
+        const response = await this.client.write(`${this.menuPath}/add`, params);
+        this.invalidatePathCache();
+        const retItem = response.find(r => r.ret);
+        return retItem ? retItem.ret : '';
+    }
+    async set(id, data) {
+        const params = this.prepareParams(data);
+        params['.id'] = id;
+        if (this.shouldDefer()) {
+            OfflineQueue_1.OfflineQueue.enqueue({ action: 'set', path: this.menuPath, params: params });
+            return;
+        }
+        await this.client.write(`${this.menuPath}/set`, params);
+        this.invalidatePathCache();
+    }
+    async remove(id) {
+        const ids = Array.isArray(id) ? id.join(',') : id;
+        const params = { '.id': ids };
+        if (this.shouldDefer()) {
+            OfflineQueue_1.OfflineQueue.enqueue({ action: 'remove', path: this.menuPath, params: params });
+            return;
+        }
+        await this.client.write(`${this.menuPath}/remove`, params);
+        this.invalidatePathCache();
+    }
+    listen(callback) {
+        const params = this.getParams();
+        return this.client.stream(`${this.menuPath}/print`, params, callback);
+    }
+    listenMonitor(callback) {
+        const rawParams = this.getParams();
+        const actionParams = {};
+        for (const [key, value] of Object.entries(rawParams)) {
+            const cleanKey = key.startsWith('?') ? key.substring(1) : key;
+            actionParams[cleanKey] = value;
+        }
+        let cmd = this.menuPath;
+        if (!cmd.endsWith('monitor-traffic') && !cmd.endsWith('torch')) {
+            cmd = `${cmd}/monitor-traffic`;
+        }
+        return this.client.stream(cmd, actionParams, callback);
+    }
+    invalidatePathCache() {
+        const host = this.client.options?.host || 'default';
+        const prefix = `${host}:${this.menuPath}`;
+        for (const key of CommandBuilder.queryCache.keys()) {
+            if (key.startsWith(prefix)) {
+                CommandBuilder.queryCache.delete(key);
+            }
+        }
+    }
+    shouldDefer() {
+        if (!this.isPersistentRequest)
+            return false;
+        return !this.isClientConnected();
+    }
+    isClientConnected() {
+        const socket = this.client['socket'];
+        return socket && socket['connected'] === true;
+    }
+    getParams() {
+        const params = { ...this.queryParams };
+        if (this.propList.length > 0) {
+            params['.proplist'] = this.propList.join(',');
+        }
+        return params;
+    }
+    formatValue(value) {
+        if (typeof value === 'boolean') {
+            return value ? 'yes' : 'no';
+        }
+        return String(value);
+    }
+    prepareParams(data) {
+        const params = {};
+        for (const [key, value] of Object.entries(data)) {
+            const kebabKey = (0, Helpers_1.camelToKebab)(key);
+            params[kebabKey] = this.formatValue(value);
+        }
+        return params;
+    }
+}
+exports.CommandBuilder = CommandBuilder;
+CommandBuilder.queryCache = new Map();
+CommandBuilder.CACHE_TTL_MS = 5000;
+//# sourceMappingURL=CommandBuilder.js.map

package/dist/client/CommandBuilder.js.map

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

package/dist/client/MikrotikClient.d.ts

@@ -0,0 +1,43 @@
+import { SocketClientOptions } from "../core/SocketClient";
+import { CommandBuilder } from "./CommandBuilder";
+import { SchemaMapper } from '../core/SchemaMapper';
+import { CircuitBreakerOptions } from '../core/CircuitBreaker';
+import { FileManager } from '../features/FileManager';
+import { MetricDefinition } from '../features/PrometheusExporter';
+export interface MikrotikOptions extends SocketClientOptions {
+    user?: string;
+    password?: string;
+    allowInsecureConfig?: boolean;
+    rateLimit?: number;
+    circuitBreaker?: CircuitBreakerOptions;
+}
+export interface Subscription {
+    stop: () => Promise<void>;
+}
+export declare class MikrotikClient {
+    private socket;
+    private readonly options;
+    private readonly isConfigFromEnv;
+    readonly files: FileManager;
+    readonly schema: SchemaMapper;
+    private rateLimiter;
+    private breaker;
+    private pendingCommands;
+    private currentSentence;
+    constructor(options: MikrotikOptions);
+    connect(): Promise<void>;
+    private printSeriousWarning;
+    close(): void;
+    command<T extends Record<string, any> = any>(path: string): CommandBuilder<T>;
+    getMetrics(path: string, metrics: MetricDefinition[], params?: Record<string, any>): Promise<string>;
+    write(command: string, parameters?: Record<string, string | boolean | number>): Promise<any[]>;
+    stream(command: string, parameters: Record<string, string | boolean | number> | undefined, callback: (data: any) => void): Subscription;
+    private generateTag;
+    private buildPayload;
+    private sendPayload;
+    private login;
+    private writeInternal;
+    private processIncomingWord;
+    private routeSentence;
+    private rejectAllCommands;
+}

package/dist/client/MikrotikClient.js

@@ -0,0 +1,276 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MikrotikClient = void 0;
+const dotenv = __importStar(require("dotenv"));
+const Auth_1 = require("../core/Auth");
+const SocketClient_1 = require("../core/SocketClient");
+const RosProtocol_1 = require("../core/RosProtocol");
+const ResultParser_1 = require("./ResultParser");
+const CommandBuilder_1 = require("./CommandBuilder");
+const SchemaMapper_1 = require("../core/SchemaMapper");
+const RateLimiter_1 = require("../core/RateLimiter");
+const CircuitBreaker_1 = require("../core/CircuitBreaker");
+const FileManager_1 = require("../features/FileManager");
+const PrometheusExporter_1 = require("../features/PrometheusExporter");
+dotenv.config();
+class MikrotikClient {
+    constructor(options) {
+        this.isConfigFromEnv = false;
+        this.schema = new SchemaMapper_1.SchemaMapper();
+        this.pendingCommands = new Map();
+        this.currentSentence = {};
+        const envHost = process.env.MIKROTIK_HOST;
+        const envUser = process.env.MIKROTIK_USER;
+        const envPass = process.env.MIKROTIK_PASS;
+        const envPort = process.env.MIKROTIK_PORT;
+        this.isConfigFromEnv = !!(envHost && envUser && envPass);
+        this.options = {
+            host: envHost || options.host,
+            user: envUser || options.user,
+            password: envPass || options.password,
+            port: envPort ? Number(envPort) : options.port,
+            useTLS: options.useTLS ?? false,
+            rejectUnauthorized: options.rejectUnauthorized ?? false,
+            allowInsecureConfig: options.allowInsecureConfig ?? false,
+            timeout: options.timeout || 10,
+            rateLimit: options.rateLimit || 50,
+        };
+        this.rateLimiter = new RateLimiter_1.RateLimiter(this.options.rateLimit);
+        this.breaker = new CircuitBreaker_1.CircuitBreaker(options.circuitBreaker);
+        this.files = new FileManager_1.FileManager(this);
+        if (!this.isConfigFromEnv && this.options.allowInsecureConfig) {
+            this.printSeriousWarning();
+        }
+        this.socket = new SocketClient_1.SocketClient(this.options);
+        this.socket.on('data', (word) => this.processIncomingWord(word));
+        this.socket.on('close', () => this.rejectAllCommands(new Error('Connection closed')));
+        this.socket.on('error', (err) => this.rejectAllCommands(err));
+    }
+    async connect() {
+        if (!this.isConfigFromEnv && !this.options.allowInsecureConfig) {
+            throw new Error('FATAL: Insecure Configuration. Use .env or allowInsecureConfig: true');
+        }
+        await this.breaker.execute(async () => {
+            await this.socket.connect();
+            await this.login();
+            await this.schema.load(this);
+        });
+    }
+    printSeriousWarning() {
+        const border = "=".repeat(60);
+        console.warn(`\n\x1b[33m${border}\x1b[0m`);
+        console.warn('\x1b[43m\x1b[30m %s \x1b[0m', ' SERIOUS SECURITY ADVISORY ');
+        console.warn('\x1b[33m%s\x1b[0m', 'Using hardcoded credentials. Please use .env file.');
+        console.warn(`\x1b[33m${border}\x1b[0m\n`);
+    }
+    close() {
+        this.socket.close();
+    }
+    command(path) {
+        const realPath = this.schema.resolve(path);
+        return new CommandBuilder_1.CommandBuilder(this, realPath);
+    }
+    async getMetrics(path, metrics, params) {
+        const data = await this.command(path).print(params);
+        return PrometheusExporter_1.PrometheusExporter.export(data, metrics);
+    }
+    async write(command, parameters) {
+        return this.breaker.execute(async () => {
+            await this.rateLimiter.acquire();
+            return new Promise((resolve, reject) => {
+                const tag = this.generateTag();
+                const payload = this.buildPayload(command, parameters, tag);
+                this.pendingCommands.set(tag, {
+                    resolve,
+                    reject,
+                    data: [],
+                    isStream: false,
+                    startTime: Date.now()
+                });
+                this.sendPayload(payload);
+            });
+        });
+    }
+    stream(command, parameters, callback) {
+        const tag = this.generateTag();
+        this.rateLimiter.acquire().then(() => {
+            const payload = this.buildPayload(command, parameters, tag);
+            this.pendingCommands.set(tag, {
+                reject: (err) => console.error(`Stream error [${tag}]:`, err),
+                data: [],
+                isStream: true,
+                onData: callback,
+                startTime: Date.now()
+            });
+            this.sendPayload(payload);
+        });
+        return {
+            stop: async () => {
+                await this.writeInternal('/cancel', { 'tag': tag });
+            }
+        };
+    }
+    generateTag() {
+        return 't' + Math.random().toString(36).substring(2, 9);
+    }
+    buildPayload(command, params, tag) {
+        const payload = [command];
+        if (params) {
+            for (const [key, value] of Object.entries(params)) {
+                const prefix = key.startsWith('?') ? '' : '=';
+                payload.push(`${prefix}${key}=${value}`);
+            }
+        }
+        payload.push(`.tag=${tag}`);
+        return payload;
+    }
+    sendPayload(payload) {
+        for (const word of payload) {
+            this.socket.write(RosProtocol_1.RosProtocol.encodeSentence(word));
+        }
+        this.socket.write(RosProtocol_1.RosProtocol.encodeSentence(''));
+    }
+    async login() {
+        return new Promise(async (resolve, reject) => {
+            try {
+                const response = await this.writeInternal('/login', {
+                    name: this.options.user || '',
+                    password: this.options.password || ''
+                });
+                const lastMsg = response[response.length - 1] || {};
+                if (lastMsg['ret']) {
+                    const challenge = lastMsg['ret'];
+                    const md5Response = Auth_1.Auth.calculateLegacyMD5(this.options.password || '', challenge);
+                    await this.writeInternal('/login', {
+                        name: this.options.user || '',
+                        response: md5Response
+                    });
+                }
+                resolve();
+            }
+            catch (error) {
+                reject(error);
+            }
+        });
+    }
+    writeInternal(command, parameters) {
+        return new Promise((resolve, reject) => {
+            const tag = this.generateTag();
+            const payload = this.buildPayload(command, parameters, tag);
+            this.pendingCommands.set(tag, {
+                resolve,
+                reject,
+                data: [],
+                isStream: false,
+                startTime: Date.now()
+            });
+            this.sendPayload(payload);
+        });
+    }
+    processIncomingWord(word) {
+        if (word.length === 0) {
+            this.routeSentence(this.currentSentence);
+            this.currentSentence = {};
+            return;
+        }
+        if (word.startsWith('!'))
+            this.currentSentence['!type'] = word;
+        else if (word.startsWith('.tag='))
+            this.currentSentence['.tag'] = word.substring(5);
+        else if (word.startsWith('=')) {
+            const parts = word.substring(1).split('=');
+            this.currentSentence[parts[0]] = parts.slice(1).join('=');
+        }
+        else if (word.startsWith('ret=')) {
+            this.currentSentence['ret'] = word.substring(4);
+        }
+        else {
+            this.currentSentence[word] = true;
+        }
+    }
+    routeSentence(sentence) {
+        const tag = sentence['.tag'];
+        const type = sentence['!type'];
+        if (!tag || !this.pendingCommands.has(tag))
+            return;
+        const cmd = this.pendingCommands.get(tag);
+        if (type === '!re') {
+            const cleanObj = { ...sentence };
+            delete cleanObj['!type'];
+            delete cleanObj['.tag'];
+            if (cmd.isStream && cmd.onData) {
+                const parsed = ResultParser_1.ResultParser.parse([cleanObj])[0];
+                cmd.onData(parsed);
+            }
+            else {
+                cmd.data.push(cleanObj);
+            }
+        }
+        else if (type === '!done') {
+            const duration = Date.now() - cmd.startTime;
+            this.rateLimiter.submitFeedback(duration);
+            if (!cmd.isStream && cmd.resolve) {
+                if (cmd.data.length === 0 && Object.keys(sentence).length > 2) {
+                    const cleanObj = { ...sentence };
+                    delete cleanObj['!type'];
+                    delete cleanObj['.tag'];
+                    cmd.data.push(cleanObj);
+                }
+                cmd.resolve(ResultParser_1.ResultParser.parse(cmd.data));
+            }
+            this.pendingCommands.delete(tag);
+        }
+        else if (type === '!trap') {
+            const duration = Date.now() - cmd.startTime;
+            this.rateLimiter.submitFeedback(duration);
+            const errorMsg = sentence['message'] || 'Unknown MikroTik Error';
+            if (errorMsg.includes('interrupted')) {
+                this.pendingCommands.delete(tag);
+                return;
+            }
+            cmd.reject(new Error(errorMsg));
+            this.pendingCommands.delete(tag);
+        }
+    }
+    rejectAllCommands(error) {
+        for (const [tag, cmd] of this.pendingCommands) {
+            cmd.reject(error);
+        }
+        this.pendingCommands.clear();
+    }
+}
+exports.MikrotikClient = MikrotikClient;
+//# sourceMappingURL=MikrotikClient.js.map

package/dist/client/MikrotikClient.js.map

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

package/dist/client/MikrotikPool.d.ts

@@ -0,0 +1,18 @@
+import { MikrotikOptions, Subscription } from './MikrotikClient';
+import { CommandBuilder } from './CommandBuilder';
+export interface PoolOptions extends MikrotikOptions {
+    poolSize?: number;
+}
+export declare class MikrotikPool {
+    private clients;
+    private readonly options;
+    private nextClientIndex;
+    private isConnected;
+    constructor(options: PoolOptions);
+    connect(): Promise<void>;
+    close(): void;
+    private getScheduledClient;
+    command<T extends Record<string, any> = any>(path: string): CommandBuilder<T>;
+    write(command: string, parameters?: Record<string, any>): Promise<any[]>;
+    stream(command: string, parameters: Record<string, any> | undefined, callback: (data: any) => void): Subscription;
+}

package/dist/client/MikrotikPool.js

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MikrotikPool = void 0;
+const MikrotikClient_1 = require("./MikrotikClient");
+const CommandBuilder_1 = require("./CommandBuilder");
+class MikrotikPool {
+    constructor(options) {
+        this.clients = [];
+        this.nextClientIndex = 0;
+        this.isConnected = false;
+        this.options = {
+            poolSize: 5,
+            ...options
+        };
+    }
+    async connect() {
+        if (this.isConnected)
+            return;
+        console.log(`🚀 Initializing Pool with ${this.options.poolSize} connections...`);
+        const connectionPromises = [];
+        for (let i = 0; i < (this.options.poolSize || 5); i++) {
+            const client = new MikrotikClient_1.MikrotikClient(this.options);
+            this.clients.push(client);
+            connectionPromises.push(client.connect());
+        }
+        await Promise.all(connectionPromises);
+        this.isConnected = true;
+        console.log(`✅ Pool Ready: ${this.clients.length} sockets connected.`);
+    }
+    close() {
+        this.clients.forEach(client => client.close());
+        this.isConnected = false;
+        this.clients = [];
+    }
+    getScheduledClient() {
+        if (this.clients.length === 0) {
+            throw new Error('Pool is not connected. Call connect() first.');
+        }
+        const client = this.clients[this.nextClientIndex];
+        this.nextClientIndex = (this.nextClientIndex + 1) % this.clients.length;
+        return client;
+    }
+    command(path) {
+        const selectedClient = this.getScheduledClient();
+        return new CommandBuilder_1.CommandBuilder(selectedClient, path);
+    }
+    write(command, parameters) {
+        return this.getScheduledClient().write(command, parameters);
+    }
+    stream(command, parameters, callback) {
+        return this.getScheduledClient().stream(command, parameters, callback);
+    }
+}
+exports.MikrotikPool = MikrotikPool;
+//# sourceMappingURL=MikrotikPool.js.map

package/dist/client/MikrotikPool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MikrotikPool.js","sourceRoot":"","sources":["../../src/client/MikrotikPool.ts"],"names":[],"mappings":";;;AAAA,qDAAiF;AACjF,qDAAkD;AAelD,MAAa,YAAY;IAMrB,YAAY,OAAoB;QALxB,YAAO,GAAqB,EAAE,CAAC;QAE/B,oBAAe,GAAW,CAAC,CAAC;QAC5B,gBAAW,GAAY,KAAK,CAAC;QAGjC,IAAI,CAAC,OAAO,GAAG;YACX,QAAQ,EAAE,CAAC;YACX,GAAG,OAAO;SACb,CAAC;IACN,CAAC;IAKM,KAAK,CAAC,OAAO;QAChB,IAAI,IAAI,CAAC,WAAW;YAAE,OAAO;QAE7B,OAAO,CAAC,GAAG,CAAC,6BAA6B,IAAI,CAAC,OAAO,CAAC,QAAQ,iBAAiB,CAAC,CAAC;QAEjF,MAAM,kBAAkB,GAAoB,EAAE,CAAC;QAE/C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YACpD,MAAM,MAAM,GAAG,IAAI,+BAAc,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAChD,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAE1B,kBAAkB,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;QAC9C,CAAC;QAGD,MAAM,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;QACtC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;QACxB,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,CAAC,OAAO,CAAC,MAAM,qBAAqB,CAAC,CAAC;IAC3E,CAAC;IAKM,KAAK;QACR,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;QAC/C,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC;QACzB,IAAI,CAAC,OAAO,GAAG,EAAE,CAAC;IACtB,CAAC;IAMO,kBAAkB;QACtB,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC5B,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;QACpE,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAGlD,IAAI,CAAC,eAAe,GAAG,CAAC,IAAI,CAAC,eAAe,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;QAExE,OAAO,MAAM,CAAC;IAClB,CAAC;IAMM,OAAO,CAAsC,IAAY;QAE5D,MAAM,cAAc,GAAG,IAAI,CAAC,kBAAkB,EAAE,CAAC;QACjD,OAAO,IAAI,+BAAc,CAAI,cAAc,EAAE,IAAI,CAAC,CAAC;IACvD,CAAC;IAKM,KAAK,CAAC,OAAe,EAAE,UAAgC;QAC1D,OAAO,IAAI,CAAC,kBAAkB,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IAChE,CAAC;IAMM,MAAM,CACT,OAAe,EACf,UAA2C,EAC3C,QAA6B;QAE7B,OAAO,IAAI,CAAC,kBAAkB,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC;IAC3E,CAAC;CACJ;AA1FD,oCA0FC"}

package/dist/client/ResultParser.d.ts

@@ -0,0 +1,5 @@
+export declare class ResultParser {
+    static parse(rawData: any[]): any[];
+    private static parseItem;
+    private static inferType;
+}