@lad-tech/nsc-toolkit 1.14.0 → 1.15.0

package/CHANGELOG.md

@@ -1,6 +1,6 @@
-# [1.14.0](https://github.com/lad-tech/nsc-toolkit/compare/v1.13.1...v1.14.0) (2023-08-15)
+# [1.15.0](https://github.com/lad-tech/nsc-toolkit/compare/v1.14.0...v1.15.0) (2023-08-16)
 
 
 ### Features
 
-* debug logs for sync methods ([#70](https://github.com/lad-tech/nsc-toolkit/issues/70)) ([30a3b5a](https://github.com/lad-tech/nsc-toolkit/commit/30a3b5afc66bb79f99b67bac56075cf308ae41ef))
+* 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/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.14.0",
+  "version": "1.15.0",
   "description": "Toolkit for create microservices around NATS",
   "main": "dist/index.js",
   "types": "./dist/types/index.d.ts",