build: prepare v0.16.5-alpha release

CHANGELOG.md

@@ -8,6 +8,13 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ---
 
+## v0.16.5-alpha - 2022-12-05
+### Added
+- IntegrationState enum instead of untyped string.
+- Add pwd_protected field to IntegrationDriver object.
+### Fixed
+- Clear integration driver discovery data only at discovery restart, not when stopping it.
+
 ## v0.16.4-alpha - 2022-11-28
 ### Added
 - Save integration at end of integration setup flow. The setup flow cannot be started again if the integration already exists.

core-api/rest/openapi.yaml

@@ -1,7 +1,7 @@
 openapi: 3.0.3
 info:
   title: Remote Two REST API
-  version: 0.16.4
+  version: 0.16.6
   contact:
     name: API Support
     url: 'https://github.com/unfoldedcircle/core-api/issues'
@@ -1029,6 +1029,7 @@ paths:
         By default only new integration drivers are returned. If a driver is already configured it will be omitted from the
         results, unless the query parameter `new=false` is set.
 
+        - Previously discovered integrations are removed, only newly discovered integrations will be returned.
         - Emits the WebSocket event `integration_discovery` with `event_type: START` when discovery starts.
         - For each discovered driver the WebSocket event `integration_discovery` with `event_type: DISCOVER` is emitted.
       operationId: startIntegrationDiscovery
@@ -1066,8 +1067,7 @@ paths:
         - integrations
       summary: Stop discovery of external integration drivers.
       description: |
-        Stops the driver discovery. The current discovery status is returned in the response and afterwards removed from
-        the session. I.e. it can no longer be retrieved with `GET /intg/discover`.
+        Stops the driver discovery and returns the current discovery status in the response.
 
         Emits the WebSocket event `integration_discovery` with `event_type: STOP`.
       operationId: stopIntegrationDiscovery
@@ -9114,7 +9114,7 @@ components:
         - id
         - configured
         - name
-        - address
+        - driver_url
     IntegrationDiscoveryStatus:
       type: object
       properties:
@@ -9162,6 +9162,9 @@ components:
           maxLength: 2048
         auth_method:
           $ref: '#/components/schemas/IntgAuthMethod'
+        pwd_protected:
+          description: Driver requires a connection password.
+          type: boolean
         version:
           description: 'Driver version, [SemVer](https://semver.org/) preferred.'
           type: string
@@ -9371,6 +9374,18 @@ components:
         setup_data:
           description: Instance configuration object.
           type: object
+    IntegrationState:
+      type: string
+      enum:
+        - NOT_CONFIGURED
+        - UNKNOWN
+        - IDLE
+        - CONNECTING
+        - CONNECTED
+        - DISCONNECTED
+        - RECONNECTING
+        - ACTIVE
+        - ERROR
     IntegrationStatus:
       type: object
       description: |
@@ -9387,7 +9402,7 @@ components:
         driver_type:
           $ref: '#/components/schemas/IntegrationDriverType'
         state:
-          type: string
+          $ref: '#/components/schemas/IntegrationState'
       required:
         - name
         - driver_type