From 257396ccf3a49181d3dcb2b904f0494718407845 Mon Sep 17 00:00:00 2001
From: Alena Petraki <alena.petraki@gmail.com>
Date: Wed, 25 Oct 2023 11:48:47 +0300
Subject: [PATCH] =?UTF-8?q?=D0=92=20=D0=BF=D0=B0=D1=80=D0=B0=D0=BC=D0=B5?=
 =?UTF-8?q?=D1=82=D1=80=D0=B0=D1=85=20ListExtensionsRequest=20=D0=BF=D0=B5?=
 =?UTF-8?q?=D1=80=D0=B5=D0=B4=D0=B0=D0=B5=D1=82=D1=81=D1=8F=20=D1=81=D0=BF?=
 =?UTF-8?q?=D0=B8=D1=81=D0=BE=D0=BA=20=D1=81=D0=BE=D1=81=D1=82=D0=BE=D1=8F?=
 =?UTF-8?q?=D0=BD=D0=B8=D0=B9=20=D0=B2=D0=BC=D0=B5=D1=81=D1=82=D0=BE=20?=
 =?UTF-8?q?=D1=84=D0=BB=D0=B0=D0=B3=D0=BE=D0=B2=20installed/not=5Finstalle?=
 =?UTF-8?q?d?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 proto/extensions/manager_service.proto | 28 ++++++++++++--------------
 1 file changed, 13 insertions(+), 15 deletions(-)

diff --git a/proto/extensions/manager_service.proto b/proto/extensions/manager_service.proto
index 9e2506b..96ea0bd 100644
--- a/proto/extensions/manager_service.proto
+++ b/proto/extensions/manager_service.proto
@@ -52,28 +52,27 @@ service ExtensionManagerService {
   // Получить список зарегистрированных сервисов
   rpc ListRegisteredExtensions(ListRegisteredExtensionsRequest) returns (ListRegisteredExtensionsResponse) {} // Получить список сервисов
 
-  // ListExtensions - получить статус расширения
+  // ListExtensions - получить информацию о расширениях
   rpc ListExtensions(ListExtensionsRequest) returns (ListExtensionsResponse) {} // Получить описание сервиса
 }
 
-// ListExtensionsRequest - запрос на получение статуса расширений в пространстве и окружении.
-// Если список расширений в запросе не передан, возвращаются расширения в соответствии с
-// переданными опциями (`installed/uninstalled`):
-// - если в ListExtensionsRequest.extensions передан список расширений, то флаги игнорируются
-//   и возвращается информация о переданных в запросе расширениях
-// - `installed:false, uninstalled:false` (равноценно `installed:true, uninstalled:false`) -
-//   возвращается информация об установленных расширениях
-// - `installed:false, uninstalled:true` - вернуть только зарегистрированные, но не установленные расширения
-// - `installed:true, uninstalled:true` - вернуть информацию о всех зарегистрированных расширениях
+// ListExtensionsRequest - запрос на получение статуса расширений в пространстве и окружении
 message ListExtensionsRequest {
   repeated string extensions = 1; // Имя расширения (опционально), regexp
   string space_id = 2; // Пространство имен расширения
   string env_id = 3; // Идентификатор окружения
-  bool installed = 4; // Вернуть установленные расширения (по умолчанию)
-  bool not_installed = 5; // Вернуть не установленные расширения
+
+  // Вернуть список расширений, которые находятся в одном из переданных состояний
+  // Если список состояний пустой, по умолчанию возвращаются расширения в любом состоянии,
+  // РєСЂРѕРјРµ NOT_INSTALLED
+  repeated State state = 4;
 }
 
-// GetExtensionResponse - описание расширения
+// ListExtensionsResponse - описание расширений. Результирующий список возвращается всегда
+// в отсортированном виде:
+// - Если `ListExtensionsRequest.extensions` пустой, то отсортированный по идентификатору расширения
+// - Если `ListExtensionsRequest.extensions` заполнен, то возвращаются расширения в соответствующем
+//   запросу порядке
 message ListExtensionsResponse {
   message ExtensionInfo {
     string extension = 10100; // Имя расширения
@@ -82,7 +81,6 @@ message ListExtensionsResponse {
     string msg = 10200; // Сообщение
     string error = 10300; // Ошибка (state == ERROR)
     bool not_found = 10350; // Расширение не найдено
-    bool installed = 10400; // Расширение установлено
     bool update_available = 10500; // Доступно обновление
     string installed_version = 10510; // Установленная версия расширения
     string available_version = 10520; // Доступная версия расширения
@@ -127,7 +125,7 @@ message ListRegisteredExtensionsResponse {
 // space_extensions (Пространство/Расширения)
 
 enum State {
-  UNKNOWN = 0;
+  NOT_INSTALLED = 0;
   INSTALLED = 1;
   IN_PROGRESS = 2;
   FAIL = 3;
-- 
GitLab