vrack2-core 1.0.4 → 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.d.ts

@@ -40,6 +40,12 @@ export default class Device {
      * @example 'vrack.KeyManager'
     */
     type: string;
+    /**
+     * Флаг общей работы
+     * Если флаг === false = все порты перестают принимать или отправлять данные/события
+     *
+    */
+    works: boolean;
     /**
      * Allows access to port management.
     */
@@ -136,6 +142,11 @@ export default class Device {
      * @param data  data for action
     */
     beforeAction(action: string, data: any): boolean;
+    /**
+     * Должен вызываться перед завершением сервиса
+     * Но может не вызываться (зависит от реализации)
+    */
+    beforeTerminate(): void;
     /**
      * Prepare options
      *

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 };
 };
@@ -58,6 +49,7 @@ class Device {
         this.id = id;
         this.type = type;
         this.Container = Container;
+        this.works = true;
         this.ports = {
             input: {},
             output: {}
@@ -118,6 +110,11 @@ class Device {
      * @param data  data for action
     */
     beforeAction(action, data) { return true; }
+    /**
+     * Должен вызываться перед завершением сервиса
+     * Но может не вызываться (зависит от реализации)
+    */
+    beforeTerminate() { return; }
     /**
      * Prepare options
      *
@@ -189,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?
      *
@@ -268,7 +263,8 @@ class Device {
     */
     addInputHandler(name, action) {
         name = ImportManager_1.default.camelize('input.' + name);
-        this[name] = action;
+        const a = this;
+        a[name] = action;
     }
     /**
      * Adding a handle for the action
@@ -278,7 +274,8 @@ class Device {
     */
     addActionHandler(name, action) {
         name = ImportManager_1.default.camelize('action.' + name);
-        this[name] = action;
+        const a = this;
+        a[name] = action;
     }
     /**
      * Informs the rack that the unit cannot continue to operate.

package/lib/service/DevicePort.d.ts

@@ -18,6 +18,7 @@ export default class DevicePort {
     required: boolean;
     /**  Ссылка на устройсто владельца */
     Device: Device;
+    bind: ((data: any) => {}) | null;
     /**
      * Список слушателей порта
      * Используется для захвата порта. Если какие либо данные будут проброшены

package/lib/service/DevicePort.js

@@ -18,6 +18,7 @@ class DevicePort {
         this.connected = false;
         /** Port connection list. One port can have multiple connections */
         this.connections = [];
+        this.bind = null;
         /**
          * Список слушателей порта
          * Используется для захвата порта. Если какие либо данные будут проброшены
@@ -40,6 +41,10 @@ class DevicePort {
      * Calling the incoming port when calling a connection
     */
     push(data) {
+        if (!this.Device.works)
+            return;
+        if (this.bind !== null)
+            return this.bind(data);
         // Если у нас есть слушатели порта
         // Передаем им данные и пересоздаем Map
         if (this.listens.size) {

package/package.json

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

package/src/Container.ts

@@ -107,6 +107,9 @@ ErrorManager.register('Container', 'XR1K10R0OOUC', 'CTR_INCOMPATIBLE_PORTS', 'In
 ErrorManager.register('Container', 'MmVoDOQwaYkx', 'CTR_INCORRECT_BOOSTRAP', 'The required DeviceManager class is not specified correctly', {})
 ErrorManager.register('Container', 'e090R0MLyb7y', 'CTR_CONF_EXTENDS_PROBLEM', 'Problem with extending service configuration.', {})
 
+ErrorManager.register('Container', 'LYC0VA1AWYKU', 'CTR_IGNORE_SERVICE_AUTORELOAD', 'Error that ignores service restart flag', {})
+
+
 
 /**
  * Contains the structure of the service
@@ -474,7 +477,9 @@ export default class Container extends EventEmitter {
                 this.structure[dconf.id].ports.push(
                     Object.assign({ port: subkey, direct: 'input' }, pList[subkey])
                 )
-                if (handler in dev) ndp.push = dev[handler].bind(dev)
+                
+                // биндимся а не заменяем push для контроля внутри push
+                if (handler in dev) ndp.bind = dev[handler].bind(dev)
             }
         }
 

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/src/service/Device.ts

@@ -54,6 +54,13 @@ export default class Device {
     */
     type: string;
 
+    /**
+     * Флаг общей работы
+     * Если флаг === false = все порты перестают принимать или отправлять данные/события
+     * 
+    */
+    works: boolean
+
     /**
      * Allows access to port management. 
     */
@@ -83,6 +90,7 @@ export default class Device {
         this.id = id
         this.type = type
         this.Container = Container
+        this.works = true
         this.ports = {
             input: {},
             output: {}
@@ -165,6 +173,12 @@ export default class Device {
      * @param data  data for action
     */
     beforeAction(action: string, data: any) { return true }
+    
+    /**
+     * Должен вызываться перед завершением сервиса
+     * Но может не вызываться (зависит от реализации)
+    */
+    beforeTerminate(){ return }
 
     /**
      * Prepare options 
@@ -330,7 +344,8 @@ export default class Device {
     */
     addInputHandler(name: string, action: (data: any) => any) {
         name = ImportManager.camelize('input.' + name)
-        this[name as keyof Device] = action
+        const a = this as any
+        a[name] = action
     }
 
     /**
@@ -341,7 +356,8 @@ export default class Device {
     */
     addActionHandler(name: string, action: (data: any) => any) {
         name = ImportManager.camelize('action.' + name)
-        this[name as keyof Device] = action
+        const a = this as any
+        a[name] = action
     }
 
     /**
@@ -353,4 +369,5 @@ export default class Device {
     terminate(error: Error, action: string) {
         return this.makeEvent('device.terminate', action, error, [])
     }
+    
 }

package/src/service/DevicePort.ts

@@ -30,6 +30,8 @@ export default class DevicePort {
     /**  Ссылка на устройсто владельца */
     Device: Device
 
+    bind: ((data: any) => {}) | null = null;
+
     /**
      * Список слушателей порта
      * Используется для захвата порта. Если какие либо данные будут проброшены 
@@ -56,6 +58,9 @@ export default class DevicePort {
      * Calling the incoming port when calling a connection 
     */
     push(data: any): any { 
+        if (!this.Device.works) return
+        if (this.bind !== null) return this.bind(data)
+
         // Если у нас есть слушатели порта
         // Передаем им данные и пересоздаем Map
         if (this.listens.size) {