Merge pull request #988

* fix(33305): fix snapshot version

* feat(33305): add new endpoint for the function specs

* feat(33305): add schemas for the function specs

* feat(33305): deprecating the old endpoint

* feat(33305): refactoring the list to add items

* feat(33305): add descriptions

* feat(33305): add supported events

* feat(33305): add transition event

* chore(33305): fix typos

Author: vanch3d

ext/hivemq-edge-openapi-2025.9-SNAPSHOT.yaml

@@ -14,7 +14,7 @@ info:
     ## OpenAPI
     HiveMQ's REST API provides an OpenAPI 3.0 schema definition that can imported into popular API tooling (e.g. Postman) or can be used to generate client-code for multiple programming languages.
   title: HiveMQ Edge REST API
-  version: 2025.4-SNAPSHOT
+  version: 2025.9-SNAPSHOT
   x-logo:
     url: https://www.hivemq.com/img/svg/hivemq-bee.svg
 tags:

ext/openAPI/components/schemas/BehaviorPolicyTransitionEvent.yaml

@@ -0,0 +1,9 @@
+type: string
+description: Accepted event in transition
+enum:
+  - Event.OnAny
+  - Connection.OnDisconnect
+  - Mqtt.OnInboundConnect
+  - Mqtt.OnInboundDisconnect
+  - Mqtt.OnInboundPublish
+  - Mqtt.OnInboundSubscribe

ext/openAPI/components/schemas/FunctionMetadata.yaml

@@ -0,0 +1,21 @@
+description: Metadata for operation functions
+type: object
+properties:
+  isTerminal:
+    type: boolean
+    description: The function is a terminal element of a pipeline
+  isDataOnly:
+    type: boolean
+    description: The function is only available for Data Policies
+  hasArguments:
+    type: boolean
+    description: The function has extra arguments
+  inLicenseAllowed:
+    type: boolean
+    description: The function can be used with the current user's license
+  supportedEvents:
+    type: array
+    items:
+      $ref: ./BehaviorPolicyTransitionEvent.yaml
+    
+

ext/openAPI/components/schemas/FunctionSpecs.yaml

@@ -0,0 +1,19 @@
+description: The configuration of a DataHub operation function
+type: object
+properties:
+  functionId:
+    type: string
+    description: The unique name of the function
+  metadata:
+    $ref: ./FunctionMetadata.yaml
+    description: The metadata associated with the function
+  schema:
+    $ref: ./JsonNode.yaml
+    description: the full JSON-Schema describimng the function and its arguments
+  uiSchema:
+    $ref: ./JsonNode.yaml
+    description: An optional UI Schema to customise the rendering of the configuraton form
+required:
+  - functionId
+  - metadata
+  - schema

ext/openAPI/components/schemas/FunctionSpecsList.yaml

@@ -0,0 +1,10 @@
+type: object
+description: List of function configurations
+properties:
+  items:
+    type: array
+    description: List of function configurations
+    items:
+      $ref: ./FunctionSpecs.yaml
+required:
+  - items

ext/openAPI/openapi.yaml

@@ -30,7 +30,7 @@ info:
     imported into popular API tooling (e.g. Postman) or can be used to generate
     client-code for multiple programming languages.
   title: HiveMQ Edge REST API
-  version: 2025.4-SNAPSHOT
+  version: 2025.9-SNAPSHOT
   x-logo:
     url: https://www.hivemq.com/img/svg/hivemq-bee.svg
 tags:
@@ -176,6 +176,8 @@ paths:
     $ref: paths/api_v1_data-hub_fsm.yaml
   /api/v1/data-hub/functions:
     $ref: paths/api_v1_data-hub_functions.yaml
+  /api/v1/data-hub/function-specs:
+    $ref: paths/api_v1_data-hub_function-specs.yaml
   /api/v1/data-hub/schemas:
     $ref: paths/api_v1_data-hub_schemas.yaml
   /api/v1/data-hub/schemas/{schemaId}:

ext/openAPI/paths/api_v1_data-hub_function-specs.yaml

@@ -0,0 +1,21 @@
+get:
+  description: >-
+    This endpoints provides the means to get information on the available
+    Functions for the HiveMQ Data Hub.
+  operationId: getFunctionSpecs
+  responses:
+    '200':
+      content:
+        application/json:
+          schema:
+            $ref: ../components/schemas/FunctionSpecsList.yaml
+      description: Success
+    '500':
+      content:
+        application/json:
+          schema:
+            $ref: ../components/schemas/ProblemDetails.yaml
+      description: Internal server error
+  summary: Get all functions as a list of function specifications
+  tags:
+    - Data Hub - Functions

ext/openAPI/paths/api_v1_data-hub_functions.yaml

@@ -1,4 +1,5 @@
 get:
+  deprecated: true
   description: >-
     This endpoints provides the means to get information on the available
     Functions for the HiveMQ Data Hub. The information is provided in form of a