npm - @lad-tech/nsc-toolkit - Versions diffs - 1.28.3 → 2.0.1 - Mend

@lad-tech/nsc-toolkit 1.28.3 → 2.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (9) hide show

package/CHANGELOG.md ADDED Viewed

@@ -0,0 +1,6 @@
+## [2.0.1](https://github.com/lad-tech/nsc-toolkit/compare/v2.0.0...v2.0.1) (2025-07-07)
+### Bug Fixes
+* Fix off method ([#151](https://github.com/lad-tech/nsc-toolkit/issues/151)) ([a6eafb4](https://github.com/lad-tech/nsc-toolkit/commit/a6eafb4679f2846496afde639b52dca86b2afc97))

package/README.md CHANGED Viewed

@@ -11,9 +11,6 @@
   - [Быстрый старт](#быстрый-старт)
     - [Переменные окружения](#переменные-окружения)
   - [Основные компоненты библиотеки](#основные-компоненты-библиотеки)
-  - [Рекомендации](#рекомендации)
-  - [Пример использования](#пример-использования)
-    - [Описание каталога `examples`](#описание-каталога-examples)
   - [Сворачивание сервисов в монолитное приложение](#сворачивание-сервисов-в-монолитное-приложение)
   - [Инверсия зависимостей и DI-контейнер](#инверсия-зависимостей-и-di-контейнер)
@@ -275,11 +272,11 @@ npm i
    - `getListener` 一 метод получения объекта `EventEmitter` для подписки на события сервиса.
-3. Класс `Container`. Реализует DI-контейнре. Сам класс не доступен для импорта, а доступен только его экземпляр, что позволяет реализовать шаблон Singlton. В микросервисном варианте контейнер один на сервис. В монолитном варианте использования контейнер один на все приложение. За счет использования объектов Symbol в качестве ключей для привязки зависимостей исключены коллизии при привязках зависимостей в разных частях приложения через один контейнер. Для привязки зависимости к ключу необходимо указать тип зависимости. Это нужно чтобы библиотека могла корректно создать экземпляр зависимости. Всего существуют 3 вида зависимостей:
+3. Класс `Container`. Реализует DI-контейнре. Сам класс не доступен для импорта, а доступен только его экземпляр, что позволяет реализовать шаблон Singleton. В микросервисном варианте контейнер один на сервис. В монолитном варианте использования контейнер один на все приложение. За счет использования объектов Symbol в качестве ключей для привязки зависимостей исключены коллизии при привязках зависимостей в разных частях приложения через один контейнер. Для привязки зависимости к ключу необходимо указать тип зависимости. Это нужно чтобы библиотека могла корректно создать экземпляр зависимости. Всего существуют 3 вида зависимостей:
    - `service` 一 сервис как зависимости.
    - `adapter` 一 класс с набором синхронных или асинхронных методов. Например репозиторий или фасад от стороннего API. Этот тип зависимости можно настроить с помощью необязательного объекта настроек. У опций адаптера могут быть следующие настройки:
-     - `singlton` 一 Булевое значение. Если передать `true` то адаптер станет singlton'ом. Объект будет создан один раз и дальше будет всегда использоваться один экземпляр.
+     - `singleton` 一 Булевое значение. Если передать `true` то адаптер станет singleton'ом. Объект будет создан один раз и дальше будет всегда использоваться один экземпляр.
      - `init` 一 Булевое значение. Для того что бы использовать этот флаг адаптер должен реализовывать следующий интерфейс
       ```js
       {
@@ -287,7 +284,7 @@ npm i
         close: () => Promise<any>;
       }
       ```
-      Если адаптер реализует требуемые методы и при передачи флага `init` при привязки адаптера адаптер можно будет инициализировать через контейнер использую метод контейнера `init`. Если к контейнеру было привязано несколько адаптеров, которые необходимо инициализировать, то после вызова метода контейнера `init` все адаптеры будут инициализированны последовательно. Метод инициализации вернет массив инициализированных экземпляров адаптеров. Каждый адаптер с настройкой `init` также становится singlton'ом.
+      Если адаптер реализует требуемые методы и при передачи флага `init` при привязки адаптера адаптер можно будет инициализировать через контейнер использую метод контейнера `init`. Если к контейнеру было привязано несколько адаптеров, которые необходимо инициализировать, то после вызова метода контейнера `init` все адаптеры будут инициализированны последовательно. Метод инициализации вернет массив инициализированных экземпляров адаптеров. Каждый адаптер с настройкой `init` также становится singleton'ом.
    - `constant`一 обычный объект. Например, объект с конфигурацией.
    - Альтернативный синтаксис привязки с учетом вышеизложенной информации
    ```js
@@ -296,7 +293,7 @@ npm i
       // константа
       container.symbol(key2).to.Constant({ obj: 'value' });
       //  Синглтон
-      container.symbol(key).to.Singlton(mySingleton);
+      container.symbol(key).to.Singleton(mySingleton);
       // Сервис с автоинициазлзацией
       container.symbol(key).to.Initializable(InitializableService);
       // Сервис

package/dist/Container.js CHANGED Viewed

@@ -5,7 +5,7 @@ const _1 = require(".");
 class Container {
     constructor() {
         this.container = new Map();
-        this.singltons = new Map();
+        this.singletons = new Map();
     }
     buildDependency(key) {
         const deepDependency = this.get(key);
@@ -55,11 +55,11 @@ class Container {
                 Adapter: (value, options) => {
                     this.container.set(key, { type: _1.DependencyType.ADAPTER, value, options });
                 },
-                Singlton: (value) => {
-                    this.container.set(key, { type: _1.DependencyType.ADAPTER, value, options: { singlton: true } });
+                Singleton: (value) => {
+                    this.container.set(key, { type: _1.DependencyType.ADAPTER, value, options: { singleton: true } });
                 },
                 Constant: (value) => {
-                    this.container.set(key, { type: _1.DependencyType.CONSTANT, value, options: { singlton: true } });
+                    this.container.set(key, { type: _1.DependencyType.CONSTANT, value, options: { singleton: true } });
                 },
                 Initializable: (value) => {
                     this.container.set(key, { type: _1.DependencyType.ADAPTER, value, options: { init: true } });
@@ -72,11 +72,11 @@ class Container {
     }
     async unbind(key) {
         this.container.delete(key);
-        const instance = this.singltons.get(key);
+        const instance = this.singletons.get(key);
         if (instance === null || instance === void 0 ? void 0 : instance.init) {
             await instance.value.close();
         }
-        this.singltons.delete(key);
+        this.singletons.delete(key);
     }
     get(key) {
         const dependency = this.container.get(key);
@@ -95,12 +95,12 @@ class Container {
             return dependency.value;
         }
         if (this.isAdapterDependency(dependency)) {
-            if (this.singltons.has(key)) {
-                return this.singltons.get(key).value;
+            if (this.singletons.has(key)) {
+                return this.singletons.get(key).value;
             }
             const adapter = new dependency.value(...constructor);
-            if (((_a = dependency.options) === null || _a === void 0 ? void 0 : _a.singlton) || ((_b = dependency.options) === null || _b === void 0 ? void 0 : _b.init)) {
-                this.singltons.set(key, { value: adapter, init: (_c = dependency.options) === null || _c === void 0 ? void 0 : _c.init });
+            if (((_a = dependency.options) === null || _a === void 0 ? void 0 : _a.singleton) || ((_b = dependency.options) === null || _b === void 0 ? void 0 : _b.init)) {
+                this.singletons.set(key, { value: adapter, init: (_c = dependency.options) === null || _c === void 0 ? void 0 : _c.init });
             }
             return adapter;
         }
@@ -110,11 +110,11 @@ class Container {
         var _a, _b;
         const initialized = [];
         for await (const [key, dependency] of this.container) {
-            if (this.isAdapterDependency(dependency) && ((_a = dependency.options) === null || _a === void 0 ? void 0 : _a.init) && !this.singltons.has(key)) {
+            if (this.isAdapterDependency(dependency) && ((_a = dependency.options) === null || _a === void 0 ? void 0 : _a.init) && !this.singletons.has(key)) {
                 const instance = this.getInstance(key);
                 await (instance === null || instance === void 0 ? void 0 : instance.init());
                 initialized.push(instance);
-                this.singltons.set(key, { value: instance, init: (_b = dependency.options) === null || _b === void 0 ? void 0 : _b.init });
+                this.singletons.set(key, { value: instance, init: (_b = dependency.options) === null || _b === void 0 ? void 0 : _b.init });
             }
         }
         return initialized;

package/dist/Root.js CHANGED Viewed

@@ -43,7 +43,7 @@ class Root {
     getExpired(expired, ownTimeout) {
         try {
             if (!expired) {
-                const timeout = ownTimeout || this.castToNumber(this.getSettingFromEnv('DEFAULT_REPONSE_TIMEOUT'));
+                const timeout = ownTimeout || this.castToNumber(this.getSettingFromEnv('DEFAULT_RESPONSE_TIMEOUT'));
                 return Date.now() + timeout;
             }
             if (ownTimeout) {

package/dist/Service.js CHANGED Viewed

@@ -4,11 +4,11 @@ exports.Service = void 0;
 const Root_1 = require("./Root");
 const nats_1 = require("nats");
 const _1 = require(".");
-const sdk_trace_base_1 = require("@opentelemetry/sdk-trace-base");
+const sdk_trace_node_1 = require("@opentelemetry/sdk-trace-node");
 const resources_1 = require("@opentelemetry/resources");
 const semantic_conventions_1 = require("@opentelemetry/semantic-conventions");
 const api_1 = require("@opentelemetry/api");
-const exporter_jaeger_1 = require("@opentelemetry/exporter-jaeger");
+const exporter_trace_otlp_http_1 = require("@opentelemetry/exporter-trace-otlp-http");
 const node_stream_1 = require("node:stream");
 const promises_1 = require("node:stream/promises");
 const toolbelt_1 = require("@lad-tech/toolbelt");
@@ -99,21 +99,23 @@ class Service extends Root_1.Root {
      * Create global Tracer
      */
     createTracer() {
-        const provider = new sdk_trace_base_1.BasicTracerProvider({
-            resource: new resources_1.Resource({
-                [semantic_conventions_1.SemanticResourceAttributes.SERVICE_NAME]: this.options.name,
+        const agentUrl = this.getSettingFromEnv('OTEL_AGENT', false);
+        const collectorOptions = {
+            url: agentUrl,
+            concurrencyLimit: 10,
+        };
+        const exporter = new exporter_trace_otlp_http_1.OTLPTraceExporter(collectorOptions);
+        const provider = new sdk_trace_node_1.NodeTracerProvider({
+            resource: (0, resources_1.resourceFromAttributes)({
+                [semantic_conventions_1.ATTR_SERVICE_NAME]: this.options.name,
             }),
+            spanProcessors: [
+                new sdk_trace_node_1.BatchSpanProcessor(exporter, {
+                    maxQueueSize: 25,
+                    scheduledDelayMillis: 10000,
+                }),
+            ],
         });
-        let host;
-        let port;
-        const agentUrl = this.getSettingFromEnv('OTEL_AGENT', false);
-        if (agentUrl) {
-            const agent = agentUrl.split(':');
-            host = agent[0];
-            port = parseInt(agent[1]) || undefined;
-        }
-        const exporter = new exporter_jaeger_1.JaegerExporter({ host, port });
-        provider.addSpanProcessor(new sdk_trace_base_1.SimpleSpanProcessor(exporter));
         provider.register();
     }
     finishSpan(span, error, tag) {

package/dist/types/Container.d.ts CHANGED Viewed

@@ -2,15 +2,15 @@ import { ClientService, DependencyType, InitializableService, Tag } from '.';
 type Constant = Record<string, any>;
 type Service<R extends Constant = Constant> = ClientService<R>;
 export type Adapter<R extends Constant = Constant> = new (...args: any[]) => R;
-export type Singlton = {
-    singlton: true;
+export type Singleton = {
+    singleton: true;
     tag?: Tag;
 };
 export type NeedInit = {
     init: true;
     tag?: Tag;
 };
-export type AdapterOptions = Singlton | NeedInit;
+export type AdapterOptions = Singleton | NeedInit;
 type Dependency = Service | Adapter | Constant;
 type ContainerValue = {
     type: DependencyType;
@@ -19,14 +19,14 @@ type ContainerValue = {
 };
 declare class Container {
     private readonly container;
-    private readonly singltons;
+    private readonly singletons;
     private buildDependency;
     private inject;
     private isServiceDependency;
     private isAdapterDependency;
     private isConstantDependency;
     bind<R extends Record<string, any>>(key: symbol, type: typeof DependencyType.SERVICE, value: ClientService<R>): void;
-    bind<R extends Record<string, any>>(key: symbol, type: typeof DependencyType.ADAPTER, value: Adapter<R>, options?: Singlton): void;
+    bind<R extends Record<string, any>>(key: symbol, type: typeof DependencyType.ADAPTER, value: Adapter<R>, options?: Singleton): void;
     bind<R extends Record<string, any>>(key: symbol, type: typeof DependencyType.ADAPTER, value: Adapter<R & InitializableService>, options?: NeedInit): void;
     bind<R extends Record<string, any>>(key: symbol, type: typeof DependencyType.CONSTANT, value: R): void;
     symbol(key: symbol): {
@@ -34,7 +34,7 @@ declare class Container {
             Adapter: <R extends Record<string, any>>(value: Adapter<R> | Adapter<R & import("./interfaces").GracefulShutdownAdditionalService & {
                 init: () => Promise<any>;
             }>, options?: AdapterOptions) => void;
-            Singlton: <R_1 extends Record<string, any>>(value: Adapter<R_1>) => void;
+            Singleton: <R_1 extends Record<string, any>>(value: Adapter<R_1>) => void;
             Constant: <R_2 extends Record<string, any>>(value: R_2) => void;
             Initializable: <R_3 extends Record<string, any>>(value: Adapter<R_3 & import("./interfaces").GracefulShutdownAdditionalService & {
                 init: () => Promise<any>;

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@lad-tech/nsc-toolkit",
-  "version": "1.28.3",
+  "version": "2.0.1",
   "description": "Toolkit for create microservices around NATS",
   "main": "dist/index.js",
   "types": "./dist/types/index.d.ts",
@@ -15,7 +15,7 @@
     "@commitlint/cli": "^17.2.0",
     "@commitlint/config-conventional": "^17.2.0",
     "@semantic-release/changelog": "^6.0.2",
-    "@semantic-release/npm": "^9.0.1",
+    "@semantic-release/npm": "^12.0.2",
     "@types/jest": "^27.5.2",
     "@types/node": "^22.13.13",
     "eslint": "^7.32.0",
@@ -29,19 +29,19 @@
     "lefthook": "^1.2.0",
     "prettier": "^2.6.1",
     "prettier-eslint": "^13.0.0",
-    "semantic-release": "^19.0.5",
+    "semantic-release": "^24.2.6",
     "ts-jest": "^29.1.0",
     "typescript": "^5.1.3"
   },
   "dependencies": {
     "@lad-tech/toolbelt": "^1.3.1",
-    "@opentelemetry/api": "^1.1.0",
-    "@opentelemetry/exporter-jaeger": "^1.3.1",
-    "@opentelemetry/resources": "^1.3.1",
-    "@opentelemetry/sdk-trace-base": "^1.3.1",
-    "@opentelemetry/semantic-conventions": "^1.3.1",
+    "@opentelemetry/api": "^1.9.0",
+    "@opentelemetry/exporter-trace-otlp-http": "^0.202.0",
+    "@opentelemetry/resources": "^2.0.1",
+    "@opentelemetry/sdk-trace-node": "^2.0.1",
+    "@opentelemetry/semantic-conventions": "^1.34.0",
     "ajv": "^8.11.0",
-    "nats": "^2.29.3",
+    "nats": "^2.15.0",
     "reflect-metadata": "^0.1.13"
   },
   "peerDependencies": {

package/.vscode/launch.json DELETED Viewed

@@ -1,77 +0,0 @@
-{
-  // Use IntelliSense to learn about possible attributes.
-  // Hover to view descriptions of existing attributes.
-  // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
-  "version": "0.2.0",
-  "configurations": [
-    {
-      "type": "node",
-      "request": "launch",
-      "name": "Launch NSC_Example_Gate_Micro",
-      "skipFiles": ["<node_internals>/**"],
-      "program": "${workspaceFolder}/examples/HttpGate/dist/examples/HttpGate/start.micro.js",
-      "outFiles": ["${workspaceFolder}/examples/HttpGate/dist/**/*.js"],
-      "preLaunchTask": "buildGateMicro",
-      "outputCapture": "std",
-      "env": {
-        "NODE_PATH": "${workspaceFolder}/examples/HttpGate/dist",
-        "LOG_LEVEL": "info",
-        "NATS_HOST": "nats://localhost:4222",
-        "DEFAULT_RESPONSE_TIMEOUT": "50000",
-        "ENVIRONMENT": "local",
-        "OTEL_AGENT": "http://localhost:4318/v1/traces"
-      }
-    },
-    {
-      "type": "node",
-      "request": "launch",
-      "name": "Launch NSC_Example_Gate_Mono",
-      "skipFiles": ["<node_internals>/**"],
-      "program": "${workspaceFolder}/examples/HttpGate/dist/examples/HttpGate/start.mono.js",
-      "outFiles": ["${workspaceFolder}/examples/HttpGate/dist/**/*.js"],
-      "preLaunchTask": "buildGateMono",
-      "outputCapture": "std",
-      "env": {
-        "NODE_PATH": "${workspaceFolder}/examples/HttpGate/dist",
-        "LOG_LEVEL": "info",
-        "NATS_HOST": "nats://localhost:4222",
-        "DEFAULT_RESPONSE_TIMEOUT": "50000",
-        "ENVIRONMENT": "local"
-      }
-    },
-    {
-      "type": "node",
-      "request": "launch",
-      "name": "Launch NSC_Example_Logic",
-      "skipFiles": ["<node_internals>/**"],
-      "program": "${workspaceFolder}/examples/LogicService",
-      "outFiles": ["${workspaceFolder}/examples/LogicService/dist/**/*.js"],
-      "preLaunchTask": "buildLogic",
-      "outputCapture": "std",
-      "env": {
-        "NODE_PATH": "${workspaceFolder}/examples/LogicService/dist",
-        "LOG_LEVEL": "info",
-        "NATS_HOST": "nats://localhost:4222",
-        "ENVIRONMENT": "local",
-        "OTEL_AGENT": "http://localhost:4318/v1/traces"
-      }
-    },
-    {
-      "type": "node",
-      "request": "launch",
-      "name": "Launch NSC_Example_Math",
-      "skipFiles": ["<node_internals>/**"],
-      "program": "${workspaceFolder}/examples/MathService",
-      "outFiles": ["${workspaceFolder}/examples/MathService/dist/**/*.js"],
-      "preLaunchTask": "buildMath",
-      "outputCapture": "std",
-      "env": {
-        "NODE_PATH": "${workspaceFolder}/examples/MathService/dist",
-        "LOG_LEVEL": "info",
-        "NATS_HOST": "nats://localhost:4222",
-        "ENVIRONMENT": "local",
-        "OTEL_AGENT": "http://localhost:4318/v1/traces"
-      }
-    }
-  ]
-}

package/.vscode/tasks.json DELETED Viewed

@@ -1,25 +0,0 @@
-{
-  "version": "2.0.0",
-  "tasks": [
-    {
-      "label": "buildGateMicro",
-      "type": "shell",
-      "command": "cd ${workspaceFolder}/examples/HttpGate/ && npm run buildMicro",
-    },
-    {
-      "label": "buildGateMono",
-      "type": "shell",
-      "command": "cd ${workspaceFolder}/examples/HttpGate/ && npm run buildMono",
-    },
-    {
-      "label": "buildLogic",
-      "type": "shell",
-      "command": "cd ${workspaceFolder}/examples/LogicService/ && npm run build",
-    },
-    {
-      "label": "buildMath",
-      "type": "shell",
-      "command": "cd ${workspaceFolder}/examples/MathService/ && npm run build",
-    }
-  ]
-}