@lad-tech/nsc-toolkit 1.14.0 → 1.15.1

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.1](https://github.com/lad-tech/nsc-toolkit/compare/v1.15.0...v1.15.1) (2023-08-16)
 
 
-### Features
+### Bug Fixes
 
-* 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))
+* singlton inject ([9627f1c](https://github.com/lad-tech/nsc-toolkit/commit/9627f1c6c5b82e73b910a8480697dcafa1abd14f))

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);
@@ -86,13 +107,14 @@ class Container {
         throw new Error(`Unknown dependency type for key ${key.toString()}`);
     }
     async initDependencies() {
-        var _a;
+        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)) {
                 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 });
             }
         }
         return initialized;

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> | 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.1",
   "description": "Toolkit for create microservices around NATS",
   "main": "dist/index.js",
   "types": "./dist/types/index.d.ts",