vrack2-core 1.0.5 → 1.1.0

package/lib/boot/DeviceManager.js

@@ -22,15 +22,6 @@ var __importStar = (this && this.__importStar) || function (mod) {
     __setModuleDefault(result, mod);
     return result;
 };
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
@@ -124,35 +115,33 @@ class DeviceManager extends BootClass_1.default {
      *
      * @see IDeivceInfo
     */
-    getDeviceInfo(vendor, device) {
-        return __awaiter(this, void 0, void 0, function* () {
-            const di = [vendor, device].join('.');
-            const DeviceClass = yield this.get(di);
-            const dev = new DeviceClass('1', di, this);
-            const result = { actions: {}, metrics: {}, inputs: {}, outputs: {}, options: {}, description: '' };
-            try {
-                const preOptions = dev.checkOptions();
-                for (const oName in preOptions)
-                    result.options[oName] = preOptions[oName].export();
-                const dInputs = dev.inputs();
-                for (const iName in dInputs)
-                    result.inputs[iName] = dInputs[iName].export();
-                const dOutputs = dev.outputs();
-                for (const oName in dOutputs)
-                    result.outputs[oName] = dOutputs[oName].export();
-                const dActions = dev.actions();
-                for (const aName in dActions)
-                    result.actions[aName] = dActions[aName].export();
-                const dMetrics = dev.metrics();
-                for (const mName in dMetrics)
-                    result.metrics[mName] = dMetrics[mName].export();
-                result.description = dev.description();
-            }
-            catch (error) {
-                throw ErrorManager_1.default.make('DM_GET_INFO_EXCEPTION').setTrace(new Error).add(error);
-            }
-            return result;
-        });
+    async getDeviceInfo(vendor, device) {
+        const di = [vendor, device].join('.');
+        const DeviceClass = await this.get(di);
+        const dev = new DeviceClass('1', di, this);
+        const result = { actions: {}, metrics: {}, inputs: {}, outputs: {}, options: {}, description: '' };
+        try {
+            const preOptions = dev.checkOptions();
+            for (const oName in preOptions)
+                result.options[oName] = preOptions[oName].export();
+            const dInputs = dev.inputs();
+            for (const iName in dInputs)
+                result.inputs[iName] = dInputs[iName].export();
+            const dOutputs = dev.outputs();
+            for (const oName in dOutputs)
+                result.outputs[oName] = dOutputs[oName].export();
+            const dActions = dev.actions();
+            for (const aName in dActions)
+                result.actions[aName] = dActions[aName].export();
+            const dMetrics = dev.metrics();
+            for (const mName in dMetrics)
+                result.metrics[mName] = dMetrics[mName].export();
+            result.description = dev.description();
+        }
+        catch (error) {
+            throw ErrorManager_1.default.make('DM_GET_INFO_EXCEPTION').setTrace(new Error).add(error);
+        }
+        return result;
     }
     /**
      * Method for updating the device list
@@ -226,23 +215,21 @@ class DeviceManager extends BootClass_1.default {
      * example "vrack.System" where "vrack" is vendor and "System" is device class
      * @param {string} device Device path string
     */
-    get(device, updateList = true) {
-        return __awaiter(this, void 0, void 0, function* () {
-            const p = this.devices.get(device); // return device path or undefined
-            if (typeof p === 'string') {
-                const deviceClass = yield Promise.resolve(`${p}`).then(s => __importStar(require(s))); // try import
-                if (deviceClass.default)
-                    return deviceClass.default;
-            }
-            // Устройство не найдено, но не исключено что если перестроить дерево 
-            // вендоров и устройств все будет так же
-            // По умолчанию мы попытаемся обновить дерево
-            if (updateList) {
-                yield this.updateDeviceList();
-                return yield this.get(device, false);
-            }
-            throw ErrorManager_1.default.make('DM_DEVICE_NOT_FOUND', { device });
-        });
+    async get(device, updateList = true) {
+        const p = this.devices.get(device); // return device path or undefined
+        if (typeof p === 'string') {
+            const deviceClass = await Promise.resolve(`${p}`).then(s => __importStar(require(s))); // try import
+            if (deviceClass.default)
+                return deviceClass.default;
+        }
+        // Устройство не найдено, но не исключено что если перестроить дерево 
+        // вендоров и устройств все будет так же
+        // По умолчанию мы попытаемся обновить дерево
+        if (updateList) {
+            await this.updateDeviceList();
+            return await this.get(device, false);
+        }
+        throw ErrorManager_1.default.make('DM_DEVICE_NOT_FOUND', { device });
     }
     /**
      * Find vendor by name

package/lib/boot/StructureStorage.js

@@ -3,15 +3,6 @@
  * Copyright © 2024 Boris Bobylev. All rights reserved.
  * Licensed under the Apache License, Version 2.0
 */
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
@@ -59,33 +50,29 @@ class StructureStorage extends BootClass_1.default {
      *
      * @see StructureStorage.process
     */
-    beforeLoadedUpdate() {
-        return __awaiter(this, void 0, void 0, function* () {
-            const fp = this.makeFilePath(this.Container.id);
-            let structure = {};
-            try {
-                if ((0, fs_1.existsSync)(fp))
-                    structure = ImportManager_1.default.importJSON(fp);
-                const cStruct = yield this.Container.getStructure();
-                this.updateStructure(cStruct, structure, this.Container.id);
-            }
-            catch (error) {
-                this.error(error);
-            }
-        });
+    async beforeLoadedUpdate() {
+        const fp = this.makeFilePath(this.Container.id);
+        let structure = {};
+        try {
+            if ((0, fs_1.existsSync)(fp))
+                structure = ImportManager_1.default.importJSON(fp);
+            const cStruct = await this.Container.getStructure();
+            this.updateStructure(cStruct, structure, this.Container.id);
+        }
+        catch (error) {
+            this.error(error);
+        }
     }
     /**
      * Returns structure by container identifier
      *
      * @param id Container ID
     */
-    getById(id) {
-        return __awaiter(this, void 0, void 0, function* () {
-            const fp = this.makeFilePath(id);
-            if (!(0, fs_1.existsSync)(fp))
-                throw ErrorManager_1.default.make('SS_STRUCT_NOT_FOUND', { id });
-            return ImportManager_1.default.importJSON(fp);
-        });
+    async getById(id) {
+        const fp = this.makeFilePath(id);
+        if (!(0, fs_1.existsSync)(fp))
+            throw ErrorManager_1.default.make('SS_STRUCT_NOT_FOUND', { id });
+        return ImportManager_1.default.importJSON(fp);
     }
     /**
      * Updating the container structure
@@ -93,11 +80,9 @@ class StructureStorage extends BootClass_1.default {
      * @param id Container ID
      * @param structure updated container structure object
     */
-    updateById(id, structure) {
-        return __awaiter(this, void 0, void 0, function* () {
-            const cStruct = yield this.getById(id);
-            this.updateStructure(cStruct, structure, id);
-        });
+    async updateById(id, structure) {
+        const cStruct = await this.getById(id);
+        this.updateStructure(cStruct, structure, id);
     }
     /**
      * Updates the display structure parameter from the file structure

package/lib/errors/ErrorManager.js

@@ -33,7 +33,7 @@ class ErrorManager {
         const reg2 = this.getRegistered(short);
         if (reg1 !== null || reg2 !== null) {
             // Если уже есть идентичная запись - просто игнорим
-            if ((reg1 === null || reg1 === void 0 ? void 0 : reg1.code) === (reg2 === null || reg2 === void 0 ? void 0 : reg2.code) && (reg1 === null || reg1 === void 0 ? void 0 : reg1.short) === (reg2 === null || reg2 === void 0 ? void 0 : reg2.short)) {
+            if (reg1?.code === reg2?.code && reg1?.short === reg2?.short) {
                 return;
             }
             else {

package/lib/service/Device.js

@@ -3,15 +3,6 @@
  * Copyright © 2022 Boris Bobylev. All rights reserved.
  * Licensed under the Apache License, Version 2.0
 */
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
@@ -195,9 +186,7 @@ class Device {
      * Used when there is a need to execute before starting the rack
      * and wait for asynchronous code to execute (initialization of some file databases, etc.)
     */
-    processPromise() {
-        return __awaiter(this, void 0, void 0, function* () { return; });
-    }
+    async processPromise() { return; }
     /**
      * Myby todo?
      *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vrack2-core",
-  "version": "1.0.5",
+  "version": "1.1.0",
   "description": "Фреймворк для создания событийно-ориентированных сервисов на JavaScript/TypeScript",
   "main": "./lib/index",
   "scripts": {},

package/src/ReactiveRef.ts

@@ -0,0 +1,83 @@
+/**
+ * Простой реактивный ref-аналог (как в Vue 3), но только для объектов.
+ * Поддерживает глубокую реактивность вложенных plain-объектов.
+ * Массивы НЕ отслеживаются внутри — только при переприсвоении свойства целиком.
+ * 
+ * @example
+ * ```ts
+ * const state = new ReactiveRef({ user: { name: 'Alice' }, items: [1, 2] });
+ * 
+ * state.watch(() => console.log('изменилось!'));
+ * 
+ * state.value.user.name = 'Bob';        // вызовет callback
+ * state.value.items = [1, 2, 3];        // вызовет callback
+ * state.value.items.push(4);            // НЕ вызовет (мутация массива)
+ * ```
+ */
+export default class ReactiveRef<T extends object> {
+  /**
+   * Хранимое значение
+  */
+  private _value: T;
+
+  /**
+   * Калбек для обработки при измении значения
+  */
+  private watcher: () => void = () => {};
+
+  /**
+   * При создании иницируем объектом
+  */
+  constructor(initialValue: T) {
+    this._value = this.makeReactive(initialValue);
+  }
+
+  /**
+   * Getter value
+  */
+  get value(): T {
+    return this._value;
+  }
+
+  /**
+   * Назначает обработчик который будет вызван при изменении объекта
+  */
+  watch(callback: () => void) {
+    this.watcher = callback;
+  }
+
+  /**
+   * Возвращает true если это простой объект не являющийся массивом или null
+   * Null кстати тоже объект внутри JS из-за чего эта проверка очень актуальна
+  */
+  private isPlainObject(val: unknown): val is Record<string, unknown> {
+    return val !== null && typeof val === 'object' && !Array.isArray(val);
+  }
+
+  /**
+   * Делает переданный объект (если он объект) реактивным 
+   * Причем делает свойства объекта тоже реактивными рекурсивно
+  */
+  private makeReactive<TObj extends object>(obj: TObj): TObj {
+    if ((obj as any).__isReactive) return obj;
+
+    const handler: ProxyHandler<TObj> = {
+      set: (target, key, value) => {
+        const oldValue = target[key as keyof TObj];
+        const isOwn = Object.prototype.hasOwnProperty.call(target, key); 
+
+        // Рекурсивно реактивизируем только обычные объекты (не массивы!)
+        const nextValue = this.isPlainObject(value) ? this.makeReactive(value) : value;
+        target[key as keyof TObj] = nextValue;
+        // Уведомляем только при изменении значения
+        if (!isOwn || oldValue !== nextValue) this.watcher();
+        return true;
+      },
+    };
+
+    const proxy = new Proxy(obj, handler);
+    (proxy as any).__isReactive = true;
+    return proxy;
+  }
+
+}

package/src/UniversalWorkers.ts

@@ -0,0 +1,127 @@
+// UniversalWorker.ts
+import { ChildProcess, fork } from 'child_process';
+import { Worker as WorkerThread, parentPort, workerData, isMainThread } from 'worker_threads';
+
+
+type UniversalWorkerOptions = {
+  isolated?: boolean;
+  scriptPath: string;
+  workerData?: any;
+};
+
+export default class UniversalWorker {
+
+  private impl: {
+    send: (msg: any) => void;
+    on: (event: 'message' | 'exit' | 'error', handler: (...args: any[]) => void) => void;
+    kill: () => void;
+  };
+
+  /**
+   * Создает новые воркер
+   * 
+   * Если параметр isolated = true будет создан форк 
+   * иначе будет использоваться WorkerThread
+  */
+  constructor(options: UniversalWorkerOptions) {
+    const { isolated = true, scriptPath, workerData } = options;
+
+    if (isolated) {
+      // child_process
+      const proc = fork(scriptPath, [], {
+        env: { ...process.env, VRACK2_WORKER_DATA: JSON.stringify(workerData) }
+      });
+      this.impl = {
+        send: (msg) => proc.send(msg),
+        on: (ev, handler) => proc.on(ev, handler),
+        kill: () => proc.kill()
+      };
+    } else {
+      // worker_threads
+      const wt = new WorkerThread(scriptPath, { workerData });
+      this.impl = {
+        send: (msg) => wt.postMessage(msg),
+        on: (ev, handler) => {
+          if (ev === 'message') wt.on('message', handler);
+          else if (ev === 'error') wt.on('error', handler);
+          else if (ev === 'exit') wt.on('exit', handler as (code: number) => void);
+        },
+        kill: () => wt.terminate()
+      };
+    }
+  }
+
+  /**
+   * Отправляет внутрь воркера обхект способный к сериализации
+  */
+  send(msg: any): void {
+    this.impl.send(msg);
+  }
+
+  /**
+   * Подписывает на события воркера
+   * 
+   * Доступно только message exit error
+  */
+  on(event: 'message' | 'exit' | 'error', handler: (...args: any[]) => void): void {
+    this.impl.on(event, handler);
+  }
+
+  /**
+   * Убивает процесс
+  */
+  kill() {
+    this.impl.kill();
+  }
+
+  /**
+   * @see kill
+  */
+  terminate() {
+    this.impl.kill();
+  }
+}
+
+
+export type WorkerMessageHandler = (message: any) => void;
+
+/**
+ * Определяет - является ли процесс форкнутым 
+ * Основанно на проверке метода process.send которая есть только у фокрнутого процесса
+*/
+export const isForked = typeof process.send === 'function';
+
+/**
+ * Определяет - является ли данный инстанс дочерним - не важно используя worker_threads или fork
+ * Проверяет !isMainThread || isForked
+*/
+export const isChild = !isMainThread || isForked;
+
+/**
+ * Получение данных сверху, которые были переданны при создании воркера
+ * В случае использования worker_threads - workerData
+ * Если же это форк - парсит устаноленнюу переменную окружения VRACK2_WORKER_DATA
+*/
+export function getWorkerData(): any {
+  if (!isMainThread) return workerData;
+  if (isForked) return JSON.parse(process.env.VRACK2_WORKER_DATA || '{}');
+  throw new Error('getWorkerData() called in main process');
+}
+
+/**
+ * Отправка данных наверх в родительский процесс
+*/
+export function sendMessage(message: any): void {
+  if (!isMainThread) return parentPort?.postMessage(message);
+  if (isForked) { process.send?.(message); return }
+  throw new Error('sendMessage() called in main process');
+}
+
+/**
+ * Позволяет подписаться на данные которые приходят сверху
+*/
+export function onMessage(handler: WorkerMessageHandler): void {
+  if (!isMainThread) parentPort?.on('message', handler);
+  else if (isForked)  process.on('message', handler); 
+  else throw new Error('onMessage() called in main process');
+}

package/tsconfig.json

@@ -11,7 +11,8 @@
     // "disableReferencedProjectLoad": true,             /* Reduce the number of projects loaded automatically by TypeScript. */
 
     /* Language and Environment */
-    "target": "es2016",                                  /* Set the JavaScript language version for emitted JavaScript and include compatible library declarations. */
+    // "target": "es2016",                                  /* Set the JavaScript language version for emitted JavaScript and include compatible library declarations. */
+    "target": "es2021",                                  /* Set the JavaScript language version for emitted JavaScript and include compatible library declarations. */
     // "lib": [],                                        /* Specify a set of bundled library declaration files that describe the target runtime environment. */
     // "jsx": "preserve",                                /* Specify what JSX code is generated. */
     // "experimentalDecorators": true,                   /* Enable experimental support for TC39 stage 2 draft decorators. */
@@ -26,7 +27,7 @@
 
     /* Modules */
     "module": "commonjs",                                /* Specify what module code is generated. */
-    // "rootDir": "./",                                  /* Specify the root folder within your source files. */
+    "rootDir": "./src",                                  /* Specify the root folder within your source files. */
     // "moduleResolution": "node",                       /* Specify how TypeScript looks up a file from a given module specifier. */
     // "baseUrl": "./",                                  /* Specify the base directory to resolve non-relative module names. */
     // "paths": {},                                      /* Specify a set of entries that re-map imports to additional lookup locations. */