@lad-tech/nsc-toolkit 1.12.1 → 1.13.0

package/CHANGELOG.md

@@ -1,6 +1,6 @@
-## [1.12.1](https://github.com/lad-tech/nsc-toolkit/compare/v1.12.0...v1.12.1) (2023-08-07)
+# [1.13.0](https://github.com/lad-tech/nsc-toolkit/compare/v1.12.1...v1.13.0) (2023-08-09)
 
 
-### Bug Fixes
+### Features
 
-* Обработка строковых форматов сообщений ([#63](https://github.com/lad-tech/nsc-toolkit/issues/63)) ([8f89cd7](https://github.com/lad-tech/nsc-toolkit/commit/8f89cd78bd35babd58951103e366dcdcb0dc26fc))
+* New options for adapter dependency ([#65](https://github.com/lad-tech/nsc-toolkit/issues/65)) ([49f0239](https://github.com/lad-tech/nsc-toolkit/commit/49f02393cadda967626542b14a72087a3d684b4e))

package/README.md

@@ -95,203 +95,212 @@ npm i
 
 1. Файл `service.schema.json`. Каждый сервис описывается в формате json. 
 
-Ниже представлена схема описания.
+    Ниже представлена схема описания.
 
-```json
-{
-  "$schema": "http://json-schema.org/draft-04/schema#",
-  "type": "object",
-  "properties": {
-    "name": {
-      "type": "string"
-    },
-    "description": {
-      "type": "string"
-    },
-    "methods": {
-      "type": "object",
-      "additionalProperties": {
-        "type": "object",
-        "properties": {
-          "action": { "type": "string" },
-          "description": { "type": "string" },
-          "options": { "$ref": "#/$defs/options" },
-          "request": { "type": "object" },
-          "response": { "type": "object" }
-        },
-        "required": ["action", "description", "options"]
-      }
-    },
-    "events": {
+    ```json
+    {
+      "$schema": "http://json-schema.org/draft-04/schema#",
       "type": "object",
       "properties": {
-        "list": {
+        "name": {
+          "type": "string"
+        },
+        "description": {
+          "type": "string"
+        },
+        "methods": {
           "type": "object",
           "additionalProperties": {
             "type": "object",
             "properties": {
               "action": { "type": "string" },
-              "options": {
-                "type": "object",
-                "properties": {
-                  "stream": { "type": "boolean" }
-                },
-              },
               "description": { "type": "string" },
-              "event": { "type": "object" }
+              "options": { "$ref": "#/$defs/options" },
+              "request": { "type": "object" },
+              "response": { "type": "object" }
             },
-            "required": ["action", "description", "event"]
-          },
+            "required": ["action", "description", "options"]
+          }
         },
-        "streamOptions": {
+        "events": {
           "type": "object",
           "properties": {
-            "prefix": { "type": "string" },
-            "actions": {
-              "type": "array",
-              "items": {
+            "list": {
+              "type": "object",
+              "additionalProperties": {
                 "type": "object",
                 "properties": {
                   "action": { "type": "string" },
-                  "storage": { "type": "string" },
-                  "retentionPolicy": { "type": "string" },
-                  "discardPolicy": { "type": "string" },
-                  "messageTTL": { "type": "number" },
-                  "duplicateTrackingTime": { "type": "number" },
-                  "replication": { "type": "number" },
-                  "rollUps": { "type": "boolean" }
+                  "options": {
+                    "type": "object",
+                    "properties": {
+                      "stream": { "type": "boolean" }
+                    },
+                  },
+                  "description": { "type": "string" },
+                  "event": { "type": "object" }
                 },
-                "required": ["action"]
-              }
+                "required": ["action", "description", "event"]
+              },
+            },
+            "streamOptions": {
+              "type": "object",
+              "properties": {
+                "prefix": { "type": "string" },
+                "actions": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "action": { "type": "string" },
+                      "storage": { "type": "string" },
+                      "retentionPolicy": { "type": "string" },
+                      "discardPolicy": { "type": "string" },
+                      "messageTTL": { "type": "number" },
+                      "duplicateTrackingTime": { "type": "number" },
+                      "replication": { "type": "number" },
+                      "rollUps": { "type": "boolean" }
+                    },
+                    "required": ["action"]
+                  }
+                }
+              },
+              "required": ["prefix", "actions"]
             }
           },
-          "required": ["prefix", "actions"]
+          "required": ["list"]
         }
       },
-      "required": ["list"]
-    }
-  },
-  "required": ["name", "description", "methods"],
+      "required": ["name", "description", "methods"],
 
-  "$defs": {
-    "options": {
-      "type": "object",
-      "properties": {
-        "useStream": {
+      "$defs": {
+        "options": {
           "type": "object",
           "properties": {
-            "request": { "type": "boolean" },
-            "response": { "type": "boolean" }
-          }
-        },
-        "cache": { "type": "number" },
-        "runTimeValidation": {
-          "type": "object",
-          "properties": {
-            "request": { "type": "boolean" },
-            "response": { "type": "boolean" }
+            "useStream": {
+              "type": "object",
+              "properties": {
+                "request": { "type": "boolean" },
+                "response": { "type": "boolean" }
+              }
+            },
+            "cache": { "type": "number" },
+            "runTimeValidation": {
+              "type": "object",
+              "properties": {
+                "request": { "type": "boolean" },
+                "response": { "type": "boolean" }
+              }
+            }
           }
         }
       }
     }
-  }
-}
-```
-
-Пояснения к схеме:
-- `name` 一 название сервиса;
-- `description` 一 описание сервиса;
-- `methods` 一 набор методов для реализации схемы `request`/`reply`;
-  - `action` 一 идентификатор запроса;
-  - `description` 一 описание метода;
-  - `request` 一 JSON Schema входных данных;
-  - `response` 一 JSON Schema выходных данных;
-  - `options` 一 настройки метода;
-    - `useStream` 一 использование Web-стримов для входных и выходных данных;
-      - `request` 一 Web-стрим на входе;
-      - `response` 一 Web-стрим на выходе;
-    - `cache` 一 кеширование запроса (задается в минутах);
-    - `runTimeValidation` 一 использование runtime для валидации параметров;
-      - `request` 一 для входных данных;
-      - `response` 一 для выходных данных;
-- `events` 一 набор событий, генерируемый сервисом для реализации схемы `pub`/`sub`;
-  - `list` 一 массив объектов событий, генерируемых сервисом;
-    - `action` 一 идентификатор события;
-    - `description` 一 описание события;
-    - `options` 一 необязательные настройки события;
-      - `stream` 一 булевый флаг, маркирующий, что событие является стримом;
-    - `event` 一 JSON Schema события;
-  - `name` 一 идентификатор события;
-  - `description` 一 описание события;
-  - `event` 一 JSON Schema события;
-- `streamOptions` 一 настройки стрима;
-  - `prefix` 一 префикс ко всем темам, у которых включена опция `stream: true`;
-  - `actions` 一 массив объектов настроек стримов;
-    - `action` 一 паттерн для тем, на которые будут применяться данные настройки (если указана `*`, то применяется ко всем событиям с опцией `stream: true`);
-    - `storage` 一 хранилище для сообщений стрима (доступные варианты `file`|`memory`, по умолчанию `file`);
-    - `retentionPolicy` 一 по каким правилам будут удаляться сообщения из стрима (доступные варианты `limits`|`interest`|`workQueue`, по умолчанию `limits`);
-    - `discardPolicy` 一 определяет, какие сообщения будут отброшены при достижении лимита (доступные варианты `old`|`new`, по умолчанию `old`);
-    - `messageTTL` 一 срок жизни сообщения (задается в секундах, по умолчанию 2 недели);
-    - `duplicateTrackingTime` 一 временной отрезок, на котором работает дедубликация сообщений (задается в секундах, по умолчанию 1 день);
-    - `replication` 一 количество реплик стрима (по умолчанию 1);
-    - `rollUps` 一 флаг, разрешающий удалить все сообщения из стрима (по умолчанию `true`).
-
-Файл позволяет описать все возможности создаваемого сервиса:
-  - синхронные методы;
-  - генерируемые сообщения;
-  - настройки стримов для сообщений. 
+    ```
+
+    Пояснения к схеме:
+   - `name` 一 название сервиса;
+   - `description` 一 описание сервиса;
+   - `methods` 一 набор методов для реализации схемы `request`/`reply`;
+     - `action` 一 идентификатор запроса;
+     - `description` 一 описание метода;
+     - `request` 一 JSON Schema входных данных;
+     - `response` 一 JSON Schema выходных данных;
+     - `options` 一 настройки метода;
+       - `useStream` 一 использование Web-стримов для входных и выходных данных;
+         - `request` 一 Web-стрим на входе;
+         - `response` 一 Web-стрим на выходе;
+       - `cache` 一 кеширование запроса (задается в минутах);
+       - `runTimeValidation` 一 использование runtime для валидации параметров;
+         - `request` 一 для входных данных;
+         - `response` 一 для выходных данных;
+   - `events` 一 набор событий, генерируемый сервисом для реализации схемы `pub`/`sub`;
+     - `list` 一 массив объектов событий, генерируемых сервисом;
+       - `action` 一 идентификатор события;
+       - `description` 一 описание события;
+       - `options` 一 необязательные настройки события;
+         - `stream` 一 булевый флаг, маркирующий, что событие является стримом;
+       - `event` 一 JSON Schema события;
+     - `name` 一 идентификатор события;
+     - `description` 一 описание события;
+     - `event` 一 JSON Schema события;
+   - `streamOptions` 一 настройки стрима;
+     - `prefix` 一 префикс ко всем темам, у которых включена опция `stream: true`;
+     - `actions` 一 массив объектов настроек стримов;
+       - `action` 一 паттерн для тем, на которые будут применяться данные настройки (если указана `*`, то применяется ко всем событиям с опцией `stream: true`);
+       - `storage` 一 хранилище для сообщений стрима (доступные варианты `file`|`memory`, по умолчанию `file`);
+       - `retentionPolicy` 一 по каким правилам будут удаляться сообщения из стрима (доступные варианты `limits`|`interest`|`workQueue`, по умолчанию `limits`);
+       - `discardPolicy` 一 определяет, какие сообщения будут отброшены при достижении лимита (доступные варианты `old`|`new`, по умолчанию `old`);
+       - `messageTTL` 一 срок жизни сообщения (задается в секундах, по умолчанию 2 недели);
+       - `duplicateTrackingTime` 一 временной отрезок, на котором работает дедубликация сообщений (задается в секундах, по умолчанию 1 день);
+       - `replication` 一 количество реплик стрима (по умолчанию 1);
+       - `rollUps` 一 флаг, разрешающий удалить все сообщения из стрима (по умолчанию `true`).
+
+    Файл позволяет описать все возможности создаваемого сервиса:
+     - синхронные методы;
+     - генерируемые сообщения;
+     - настройки стримов для сообщений. 
   
-Сервис предполагается создавать из описания с помощью кодогенерации. Используется библиотека для кодогенерации сервиса из описания [nsc-cli](https://github.com/lad-tech/nsc-cli).
+    Сервис предполагается создавать из описания с помощью кодогенерации. Используется библиотека для кодогенерации сервиса из описания [nsc-cli](https://github.com/lad-tech/nsc-cli).
 
-2. Класс `Service`. Чтобы создать сервис, необходимо создать экземпляр этого класса и вызвать метод `start`.
+1. Класс `Service`. Чтобы создать сервис, необходимо создать экземпляр этого класса и вызвать метод `start`.
 
-Принимаемые параметры при создании экземпляра:
+    Принимаемые параметры при создании экземпляра:
 
-- `name` 一 имя сервиса.
-- `brokerConnection` 一 необязательный параметр для подключения к брокеру NATS. Если его не передать, то будет использоваться внутренняя реализация брокера, и приложение будет собираться в монолит. 
-- `methods` 一 массив методов. `BaseMethod` это один из базовых классов библиотеки, который необходимо расширить, чтобы создать метод с бизнес-логикой.
-- `events` 一 описание генерируемых событий. Следует передать весь блок `events` из `service.schema.json`.
-- `cache` 一 настройки межмикросервисного кеширования.
-  - `service` 一 реализация интерфейса для сервиса кеширования;
-  - `timeout` 一 время, в рамках которого необходимо ожидать ответа от кеша (задается в миллисекундах).
-- `loggerOutputFormatter` 一 реализация класса форматера для логов. Для логирования используется библиотека [@lad-tech/toolbelt](https://github.com/lad-tech/toolbelt).
-- `gracefulShutdown` 一 настройки по завершению работы сервиса.
-  - `additional` 一 массив дополнительных сервисов, которые могут завершать свою работу. Необходим, чтобы сервисы реализовывали нужный интерфейс.
-  - `timeout` 一 время, в рамках которого ожидается штатная остановка сервиса.
+   - `name` 一 имя сервиса.
+   - `brokerConnection` 一 необязательный параметр для подключения к брокеру NATS. Если его не передать, то будет использоваться внутренняя реализация брокера, и приложение будет собираться в монолит. 
+   - `methods` 一 массив методов. `BaseMethod` это один из базовых классов библиотеки, который необходимо расширить, чтобы создать метод с бизнес-логикой.
+   - `events` 一 описание генерируемых событий. Следует передать весь блок `events` из `service.schema.json`.
+   - `cache` 一 настройки межмикросервисного кеширования.
+     - `service` 一 реализация интерфейса для сервиса кеширования;
+     - `timeout` 一 время, в рамках которого необходимо ожидать ответа от кеша (задается в миллисекундах).
+   - `loggerOutputFormatter` 一 реализация класса форматера для логов. Для логирования используется библиотека [@lad-tech/toolbelt](https://github.com/lad-tech/toolbelt).
+   - `gracefulShutdown` 一 настройки по завершению работы сервиса.
+     - `additional` 一 массив дополнительных сервисов, которые могут завершать свою работу. Необходим, чтобы сервисы реализовывали нужный интерфейс.
+     - `timeout` 一 время, в рамках которого ожидается штатная остановка сервиса.
 
-Публичные методы:
+    Публичные методы:
 
-- `getRootBaggage` 一 получение корневого багажа для распределенной трассировки. Источником могут служить заголовки http-запроса. Если подобные источники отсутствуют, то создается новый корневой багаж.
-- `endRootSpan` 一 завершение корневого `Span` по `id` трассировки. Необходим для внедрения распределенных трассировок.
-- `buildService` 一 метод, чтобы создать экземпляр клиента. Все используемые при запросах клиенты (сервисы) должны создаваться через этот метод, если необходимо использовать полную функциональность библиотеки.
-- `start` 一 запуск сервиса.
-- `stop` 一 остановка сервиса.
+    - `getRootBaggage` 一 получение корневого багажа для распределенной трассировки. Источником могут служить заголовки http-запроса. Если подобные источники отсутствуют, то создается новый корневой багаж.
+   - `endRootSpan` 一 завершение корневого `Span` по `id` трассировки. Необходим для внедрения распределенных трассировок.
+   - `buildService` 一 метод, чтобы создать экземпляр клиента. Все используемые при запросах клиенты (сервисы) должны создаваться через этот метод, если необходимо использовать полную функциональность библиотеки.
+   - `start` 一 запуск сервиса.
+   - `stop` 一 остановка сервиса.
 
-3. Класс `Client`. Чтобы создать клиент для сервиса, необходимо расширить класс `Client` и описать в нем все доступные извне вызовы методов. Для вызова метода используется приватный метод `CLient.request`. Пример создания клиента можно [посмотреть тут](./examples/MathService/index.ts).
+2. Класс `Client`. Чтобы создать клиент для сервиса, необходимо расширить класс `Client` и описать в нем все доступные извне вызовы методов. Для вызова метода используется приватный метод `CLient.request`. Пример создания клиента можно [посмотреть тут](./examples/MathService/index.ts).
 
-Публичные методы:
+    Публичные методы:
 
-- `getListener` 一 метод получения объекта `EventEmitter` для подписки на события сервиса.
+   - `getListener` 一 метод получения объекта `EventEmitter` для подписки на события сервиса.
 
-4. Класс `Container`. Реализует DI-контейнре. Сам класс не доступен для импорта, а доступен только его экземпляр, что позволяет реализовать шаблон Singlton. В микросервисном варианте контейнер один на сервис. В монолитном варианте использования контейнер один на все приложение. За счет использользования объектов Symbol в качестве ключей для привязки зависимостей исключены коллизии при привязки зависимостей в разных частях приложения через один контейнре. Для привязки зависимости к ключу необходимо указать тип зависимости. Это нужно чтобы библиотека могла корректно создать ээкземпляр зависимости. Всего существуют 3 вида зависимостей:
+3. Класс `Container`. Реализует DI-контейнре. Сам класс не доступен для импорта, а доступен только его экземпляр, что позволяет реализовать шаблон Singlton. В микросервисном варианте контейнер один на сервис. В монолитном варианте использования контейнер один на все приложение. За счет использользования объектов Symbol в качестве ключей для привязки зависимостей исключены коллизии при привязки зависимостей в разных частях приложения через один контейнре. Для привязки зависимости к ключу необходимо указать тип зависимости. Это нужно чтобы библиотека могла корректно создать ээкземпляр зависимости. Всего существуют 3 вида зависимостей:
 
-- `service` 一 сервис как зависимости.
-- `adapter` 一 класс с набором асинхронных методов. Например репозиторий или фасад от стороннего API.
-- `constant`一 обычный объект. Например объект с конфигурацией.
-
-Публичные методы:
-
-- `bind` 一 привязать реализацию к ключу.
-- `unbind` 一 отвязать реализацию от ключа.
-- `get` 一 получить реализацию по ключу.
-- `getInstance` 一 получить экземпляр реализации. Для зависимости с типом `service` нельзя получить экземпляр через этот метод поскольку для создания экземпляра сервиса требуется контекст в рамках которого он будет работать. Для зависимости с типом `constant` вернется привязанный объект. 
-
-5. Декораторы. Применение декораторов:
-* `@service`:
-  - Если в методе сервиса вызывается метод другого сервиса, то клиент сервиса зависимости следует подключить через декоратор `@service`, а к самому классу метода применить декоратор `@related`. Тогда при вызове метода сервиса не пропадет контекст запроса и можно будет использовать распределенные трассировки. 
-  - Инъекция через декоратор `@service` позволяет использовать функциональность сборки приложения в монолит. 
-* `@instance`:  
-  - Используется для инъекции других зависимостей, например, объектов репозиториев. В него можно передать готовый объект с набором асинхронных методов. При вызове этих методов из его логики они будут видны в трассировках. Для получения таких зависимостей рекомендуется использовать DI-контейнеры.
+   - `service` 一 сервис как зависимости.
+   - `adapter` 一 класс с набором синхронных или асинхронных методов. Например репозиторий или фасад от стороннего API. Этот тип зависимости можно настроить с помощью необязательного объекта настроек. У опций адаптера могут быть следующие настройки:
+     - `singlton` 一 Булевое значение. Если передать `true` то адаптер станет singlton'ом. Объект будет создан один раз и дальше будет всегда использоваться один экземпляр.
+     - `init` 一 Булевое значение. Для того что бы использовать этот флаг адаптер должен реализовывать следующий интерфейс
+      ```js
+      {
+        init: () => Promise<any>;
+        close: () => Promise<any>;
+      }
+      ```
+      Если адаптер реализует требуемые методы и при передачи флага `init` при привязки адаптера адаптер можно будет инициализировать через контейнер использую метод контейнера `init`. Если к контейнеру было привязано несколько адаптеров, которые необходимо инициализировать, то после вызова метода контейнера `init` все адаптеры будут инициализированны последовательно. Метод инициализации вернет массив инициализированных экземпляров адаптеров. Каждый адаптер с настройкой `init` также становится singlton'ом.
+   - `constant`一 обычный объект. Например объект с конфигурацией.
+
+    Публичные методы:
+
+   - `bind` 一 привязать реализацию к ключу.
+   - `unbind` 一 отвязать реализацию от ключа.
+   - `get` 一 получить реализацию по ключу.
+   - `getInstance` 一 получить экземпляр реализации. Для зависимости с типом `service` нельзя получить экземпляр через этот метод поскольку для создания экземпляра сервиса требуется контекст в рамках которого он будет работать. Для зависимости с типом `constant` вернется привязанный объект. 
+
+4. Декораторы. Применение декораторов:
+   * `@service`:
+     - Если в методе сервиса вызывается метод другого сервиса, то клиент сервиса зависимости следует подключить через декоратор `@service`, а к самому классу метода применить декоратор `@related`. Тогда при вызове метода сервиса не пропадет контекст запроса и можно будет использовать распределенные трассировки. 
+     - Инъекция через декоратор `@service` позволяет использовать функциональность сборки приложения в монолит. 
+   * `@instance`:  
+     - Используется для инъекции других зависимостей, например, объектов репозиториев. В него можно передать готовый объект с набором асинхронных методов. При вызове этих методов из его логики они будут видны в трассировках. Для получения таких зависимостей рекомендуется использовать DI-контейнеры.
 
 ## Рекомендации
 

package/dist/Container.js

@@ -5,6 +5,7 @@ const _1 = require(".");
 class Container {
     constructor() {
         this.container = new Map();
+        this.singltons = new Map();
     }
     buildDependency(key) {
         const deepDependency = this.get(key);
@@ -45,11 +46,16 @@ class Container {
     isConstantDependency(dependency) {
         return dependency.type === _1.DependencyType.CONSTANT;
     }
-    bind(key, type, value) {
-        this.container.set(key, { type, value });
+    bind(key, type, value, options) {
+        this.container.set(key, { type, value, options });
     }
-    unbind(key) {
+    async unbind(key) {
         this.container.delete(key);
+        const instance = this.singltons.get(key);
+        if (instance === null || instance === void 0 ? void 0 : instance.init) {
+            await instance.value.close();
+        }
+        this.singltons.delete(key);
     }
     get(key) {
         const dependency = this.container.get(key);
@@ -59,6 +65,7 @@ class Container {
         return this.inject(dependency);
     }
     getInstance(key) {
+        var _a, _b, _c;
         const { dependency, constructor } = this.get(key);
         if (this.isServiceDependency(dependency)) {
             throw new Error(`Unable to get service instance`);
@@ -67,10 +74,29 @@ class Container {
             return dependency.value;
         }
         if (this.isAdapterDependency(dependency)) {
-            return new dependency.value(...constructor);
+            if (this.singltons.has(key)) {
+                return this.singltons.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 });
+            }
+            return adapter;
         }
         return null;
     }
+    async initDependencies() {
+        var _a;
+        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);
+            }
+        }
+        return initialized;
+    }
 }
 exports.container = new Container();
 //# sourceMappingURL=Container.js.map

package/dist/Container.js.map

@@ -1 +1 @@
-{"version":3,"file":"Container.js","sourceRoot":"","sources":["../src/Container.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Container.js","sourceRoot":"","sources":["../src/Container.ts"],"names":[],"mappings":"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"}

package/dist/interfaces.js.map

@@ -1 +1 @@
-{"version":3,"file":"interfaces.js","sourceRoot":"","sources":["../src/interfaces.ts"],"names":[],"mappings":";AAAA,SAAS;;;AAuKI,QAAA,cAAc,GAAG;IAC5B,OAAO,EAAE,SAAS;IAClB,OAAO,EAAE,SAAS;IAClB,QAAQ,EAAE,UAAU,EAAE,iBAAiB;CAC/B,CAAC"}
+{"version":3,"file":"interfaces.js","sourceRoot":"","sources":["../src/interfaces.ts"],"names":[],"mappings":";AAAA,SAAS;;;AA2KI,QAAA,cAAc,GAAG;IAC5B,OAAO,EAAE,SAAS;IAClB,OAAO,EAAE,SAAS;IAClB,QAAQ,EAAE,UAAU,EAAE,iBAAiB;CAC/B,CAAC"}

package/dist/types/Container.d.ts

@@ -1,28 +1,39 @@
-import { DependencyType, ClientService } from '.';
+import { DependencyType, ClientService, 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;
+export type Singlton = {
+    singlton: true;
+};
+export type NeedInit = {
+    init: true;
+};
+export type AdapterOptions = Singlton | NeedInit;
 type Dependency = Service | Adapter | Constant;
 type ContainerValue = {
     type: DependencyType;
     value: Dependency;
+    options?: AdapterOptions;
 };
 declare class Container {
     private readonly container;
+    private readonly singltons;
     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>): 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 & InitializableService>, options?: NeedInit): void;
     bind<R extends Record<string, any>>(key: symbol, type: typeof DependencyType.CONSTANT, value: R): void;
-    unbind(key: symbol): void;
+    unbind(key: symbol): Promise<void>;
     get(key: symbol): {
         dependency: ContainerValue;
         constructor: unknown[];
     };
     getInstance<R = Constant>(key: symbol): R | null;
+    initDependencies(): Promise<InitializableService[]>;
 }
 export declare const container: Container;
 export {};

package/dist/types/interfaces.d.ts

@@ -134,6 +134,9 @@ export interface CacheService {
     get: (key: string) => Promise<string | undefined>;
     delete: (key: string) => Promise<void>;
 }
+export type InitializableService = GracefulShutdownAdditionalService & {
+    init: () => Promise<any>;
+};
 export type DependencyType = typeof DependencyType[keyof typeof DependencyType];
 export declare const DependencyType: {
     readonly SERVICE: "service";

package/package.json

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