@lad-tech/nsc-toolkit 1.13.1 → 1.15.0

package/CHANGELOG.md

@@ -1,6 +1,6 @@
-## [1.13.1](https://github.com/lad-tech/nsc-toolkit/compare/v1.13.0...v1.13.1) (2023-08-09)
+# [1.15.0](https://github.com/lad-tech/nsc-toolkit/compare/v1.14.0...v1.15.0) (2023-08-16)
 
 
-### Bug Fixes
+### Features
 
-* getInstance not return null ([#67](https://github.com/lad-tech/nsc-toolkit/issues/67)) ([1182481](https://github.com/lad-tech/nsc-toolkit/commit/1182481b5e13cc129b30643877ceaa4d67ebc483))
+* symbol().to syntax ([#72](https://github.com/lad-tech/nsc-toolkit/issues/72)) ([90e361e](https://github.com/lad-tech/nsc-toolkit/commit/90e361e001ad0b0686ed066e15102fb90209ead9))

package/README.md

@@ -273,7 +273,7 @@ npm i
 
    - `getListener` 一 метод получения объекта `EventEmitter` для подписки на события сервиса.
 
-3. Класс `Container`. Реализует DI-контейнре. Сам класс не доступен для импорта, а доступен только его экземпляр, что позволяет реализовать шаблон Singlton. В микросервисном варианте контейнер один на сервис. В монолитном варианте использования контейнер один на все приложение. За счет использользования объектов Symbol в качестве ключей для привязки зависимостей исключены коллизии при привязки зависимостей в разных частях приложения через один контейнре. Для привязки зависимости к ключу необходимо указать тип зависимости. Это нужно чтобы библиотека могла корректно создать ээкземпляр зависимости. Всего существуют 3 вида зависимостей:
+3. Класс `Container`. Реализует DI-контейнре. Сам класс не доступен для импорта, а доступен только его экземпляр, что позволяет реализовать шаблон Singlton. В микросервисном варианте контейнер один на сервис. В монолитном варианте использования контейнер один на все приложение. За счет использования объектов Symbol в качестве ключей для привязки зависимостей исключены коллизии при привязках зависимостей в разных частях приложения через один контейнер. Для привязки зависимости к ключу необходимо указать тип зависимости. Это нужно чтобы библиотека могла корректно создать экземпляр зависимости. Всего существуют 3 вида зависимостей:
 
    - `service` 一 сервис как зависимости.
    - `adapter` 一 класс с набором синхронных или асинхронных методов. Например репозиторий или фасад от стороннего API. Этот тип зависимости можно настроить с помощью необязательного объекта настроек. У опций адаптера могут быть следующие настройки:
@@ -286,7 +286,22 @@ npm i
       }
       ```
       Если адаптер реализует требуемые методы и при передачи флага `init` при привязки адаптера адаптер можно будет инициализировать через контейнер использую метод контейнера `init`. Если к контейнеру было привязано несколько адаптеров, которые необходимо инициализировать, то после вызова метода контейнера `init` все адаптеры будут инициализированны последовательно. Метод инициализации вернет массив инициализированных экземпляров адаптеров. Каждый адаптер с настройкой `init` также становится singlton'ом.
-   - `constant`一 обычный объект. Например объект с конфигурацией.
+   - `constant`一 обычный объект. Например, объект с конфигурацией.
+   - Альтернативный синтаксис привязки с учетом вышеизложенной информации
+   ```js
+      // Простой адаптер
+      container.symbol(key).to.Adapter(InitializableService);
+      // константа
+      container.symbol(key2).to.Constant({ obj: 'value' });
+      //  Синглтон
+      container.symbol(key).to.Singlton(mySingleton);
+      // Сервис с автоинициазлзацией
+      container.symbol(key).to.Initializable(InitializableService);
+      // Сервис
+      container.symbol(key).to.Service(MyService);
+      
+
+    ```
 
     Публичные методы:
 
@@ -464,4 +479,4 @@ Service/
 ┌---------┐    ┌───────────-┐    ┌───────────---┐    ┌---------┐
 | GetUser |--->│ Repository |--->| Configurator |--->| Storage |
 └---------┘    └─────-─────-┘    └─────-─────---┘    └---------┘
-```
+```

package/dist/Container.js

@@ -49,6 +49,27 @@ class Container {
     bind(key, type, value, options) {
         this.container.set(key, { type, value, options });
     }
+    symbol(key) {
+        return {
+            to: {
+                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 } });
+                },
+                Constant: (value) => {
+                    this.container.set(key, { type: _1.DependencyType.CONSTANT, value, options: { singlton: true } });
+                },
+                Initializable: (value) => {
+                    this.container.set(key, { type: _1.DependencyType.ADAPTER, value, options: { init: true } });
+                },
+                Service: (value) => {
+                    this.container.set(key, { type: _1.DependencyType.SERVICE, value });
+                },
+            },
+        };
+    }
     async unbind(key) {
         this.container.delete(key);
         const instance = this.singltons.get(key);

package/dist/Service.js

@@ -167,11 +167,6 @@ class Service extends Root_1.Root {
                 dependences[key] = new Proxy(instance, trap);
             });
         }
-        dependences['logger'] = new toolbelt_1.Logs.Logger({
-            location: `${this.serviceName}.${method.settings.action}`,
-            metadata: baggage,
-            outputFormatter: this.options.loggerOutputFormatter,
-        });
         return dependences;
     }
     /**
@@ -183,7 +178,6 @@ class Service extends Root_1.Root {
         for (const key in dependencies) {
             context[key] = dependencies[key];
         }
-        context['emitter'] = this.emitter;
         return context;
     }
     /**
@@ -333,17 +327,27 @@ class Service extends Root_1.Root {
         const tracer = api_1.trace.getTracer('');
         const context = this.getContext(baggage);
         const span = tracer.startSpan(subject, undefined, context);
+        const logger = new toolbelt_1.Logs.Logger({
+            location: `${this.serviceName}.${Method.settings.action}`,
+            metadata: baggage,
+            outputFormatter: this.options.loggerOutputFormatter,
+        });
         try {
             const requestedDependencies = this.createObjectWithDependencies(Method, tracer, this.getNextBaggage(span, baggage));
             const context = this.createMethodContext(Method, requestedDependencies);
+            context['logger'] = logger;
+            context['emitter'] = this.emitter;
+            const response = await context.handler.call(context, payload);
             const result = {
-                payload: await context.handler.call(context, payload),
+                payload: response,
             };
+            logger.debug({ request: payload, response });
             this.finishSpan(span);
             return result;
         }
         catch (error) {
-            this.logger.error(error);
+            logger.debug({ request: payload });
+            logger.error(error);
             this.finishSpan(span, error);
             return this.buildErrorMessage(error);
         }

package/dist/types/Container.d.ts

@@ -1,4 +1,4 @@
-import { DependencyType, ClientService, InitializableService } from '.';
+import { ClientService, DependencyType, InitializableService } 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;
@@ -27,6 +27,19 @@ declare class Container {
     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 & InitializableService>, options?: NeedInit): void;
     bind<R extends Record<string, any>>(key: symbol, type: typeof DependencyType.CONSTANT, value: R): void;
+    symbol(key: symbol): {
+        to: {
+            Adapter: <R extends Record<string, any>>(value: Adapter<R & import("./interfaces").GracefulShutdownAdditionalService & {
+                init: () => Promise<any>;
+            }>, options?: AdapterOptions) => void;
+            Singlton: <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>;
+            }>) => void;
+            Service: <R_4 extends Record<string, any>>(value: ClientService<R_4>) => void;
+        };
+    };
     unbind(key: symbol): Promise<void>;
     get(key: symbol): {
         dependency: ContainerValue;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lad-tech/nsc-toolkit",
-  "version": "1.13.1",
+  "version": "1.15.0",
   "description": "Toolkit for create microservices around NATS",
   "main": "dist/index.js",
   "types": "./dist/types/index.d.ts",