dbeaver/pro#9724 fix graphql schema for doc

server/bundles/io.cloudbeaver.server.ce/schema/service.core.graphqls

@@ -1,3 +1,7 @@
+####################################################
+# Core API
+####################################################
+
 extend type ServerConfig {
     serverURL: String! @deprecated
     rootURI: String!

server/bundles/io.cloudbeaver.server/schema/schema.graphqls

@@ -1,6 +1,10 @@
-# Any object (JSON)
+####################################################
+# Base schema
+####################################################
+
+"Any object (JSON)"
 scalar Object
-# Date/Time
+"Date/Time"
 scalar DateTime
 scalar Date
 

server/bundles/io.cloudbeaver.server/schema/service.core.graphqls

@@ -556,7 +556,7 @@ type ConnectionInfo {
     supportedDataFormats: [ ResultDataFormat! ]!
     configurationType: DriverConfigurationType
 
-    #Access properties
+    "Access properties"
     canViewSettings: Boolean!
     canEdit: Boolean!
     canDelete: Boolean!
@@ -737,7 +737,7 @@ input ConnectionConfig {
     "ID of database driver"
     driverId: ID
 
-    # Custom connection parameters (all optional)
+    "Custom connection parameters (all optional)"
     host: String
     port: String
     serverName: String

server/bundles/io.cloudbeaver.server/schema/service.events.datasource.graphqls

@@ -1,4 +1,7 @@
 ####################################################
+# Datasource events
+####################################################
+
 extend enum CBServerEventId {
 
     "Datasource created"

server/bundles/io.cloudbeaver.server/schema/service.events.sql.graphqls

@@ -1,3 +1,7 @@
+####################################################
+# SQL events
+####################################################
+
 extend enum CBServerEventId {
     "Database output log updated (e.g., DBMS in Oracle)"
     cb_database_output_log_updated,

server/bundles/io.cloudbeaver.server/schema/service.navigator.graphqls

@@ -1,4 +1,6 @@
+####################################################
 # Nodes, objects and properties
+####################################################
 
 type ObjectDescriptor {
     id: Int
@@ -143,7 +145,7 @@ extend type Query {
     "Refreshes node based on the node path"
     navRefreshNode( nodePath: ID! ): Boolean @deprecated # Use navReloadNode method from Mutation (24.2.4)
 
-    # contextId currently not using
+    "contextId currently not using"
     navGetStructContainers( projectId: ID, connectionId: ID!, contextId: ID, catalog: ID ): DatabaseStructContainers!
 
 }

server/bundles/io.cloudbeaver.server/schema/service.sql.graphqls

@@ -38,7 +38,7 @@ type SQLCompletionProposal {
 # Data read / SQL execution
 ####################################################
 
-# SQL context must be created for each SQL editor
+"SQL context must be created for each SQL editor"
 type SQLContextInfo {
 
     id: ID!
@@ -153,10 +153,12 @@ type SQLResultSet {
     "Returns list of rows in the result set. Each row contains data and metadata"
     rowsWithMetaData: [SQLResultRowMetaData] @since(version: "23.3.5")
 
-    # True means that resultset was generated by single entity query
-    # New rows can be added, old rows can be deleted
+    """
+    True means that resultset was generated by single entity query
+    New rows can be added, old rows can be deleted
+    """
     singleEntity: Boolean!
-    # server always returns hasMoreData = false
+    "server always returns hasMoreData = false"
     hasMoreData: Boolean!
     "Identifies if result set has row identifier. If true then it is possible update data or load LOB files"
     hasRowIdentifier: Boolean! @deprecated (reason: "use rowIdentifierState (25.3.4)")
@@ -213,7 +215,7 @@ type SQLQueryResults {
     updateRowCount: Float
     sourceQuery: String
 
-    # Actual data format of this result
+    "Actual data format of this result"
     dataFormat: ResultDataFormat
 
     resultSet: SQLResultSet
@@ -221,17 +223,17 @@ type SQLQueryResults {
 
 type SQLExecuteInfo {
 
-    # Status message
+    "Status message"
     statusMessage: String
-    # Execute time (ms)
+    "Execute time (ms)"
     duration: Int!
-    # Actual conditions applied to query
+    "Actual conditions applied to query"
     filterText: String
-    # Full query that was executed, contains all used filters
+    "Full query that was executed, contains all used filters"
     fullQuery: String
-    # Original query that was executed, without modifications
+    "Original query that was executed, without modifications"
     originalQuery: String
-    # Results
+    "Results"
     results: [ SQLQueryResults! ]!
 }
 

server/bundles/io.cloudbeaver.service.admin/schema/service.admin.graphqls

@@ -1,3 +1,7 @@
+####################################################
+# Administration API
+####################################################
+
 "Describes the type of the administrative subject (user or team)"
 enum AdminSubjectType {
     "User"

server/bundles/io.cloudbeaver.service.ai/schema/service.ai.events.graphqls

@@ -1,3 +1,7 @@
+####################################################
+# AI events
+####################################################
+
 extend enum CBServerEventId {
     cb_ai_chat_message_chunk @since(version: "25.1.1")
     cb_ai_chat_message_error @since(version: "25.1.1")

server/bundles/io.cloudbeaver.service.ai/schema/service.ai.graphqls

@@ -1,4 +1,7 @@
+####################################################
 # AI admin queries
+####################################################
+
 enum AIMessageType {
     SYSTEM,
     USER,

server/bundles/io.cloudbeaver.service.auth/schema/service.auth.graphqls

@@ -1,3 +1,7 @@
+####################################################
+# Authentication API
+####################################################
+
 enum AuthCredentialEncryption {
     none,
     plain,
@@ -15,11 +19,11 @@ type AuthCredentialInfo {
     displayName: String!
     description: String
 
-    # This field must be shown in admin panel
+    "This field must be shown in admin panel"
     admin: Boolean!
-    # This field must be shown in login form
+    "This field must be shown in login form"
     user: Boolean!
-    # This field can be used as user identifier
+    "This field can be used as user identifier"
 
     identifying: Boolean!
     possibleValues: [String]

server/bundles/io.cloudbeaver.service.data.transfer/schema/service.data.transfer.graphqls

@@ -1,4 +1,6 @@
+####################################################
 # Data transfer queries
+####################################################
 
 type DataTransferProcessorInfo {
     id: ID!

server/bundles/io.cloudbeaver.service.fs/schema/service.fs.graphqls

@@ -1,3 +1,7 @@
+####################################################
+# File system API
+####################################################
+
 type FSFile @since(version: "23.2.2") {
     "Name of the file or folder"
     name: String!

server/bundles/io.cloudbeaver.service.metadata/schema/service.metadata.graphqls

@@ -1,4 +1,6 @@
+####################################################
 # Metadata queries
+####################################################
 
 extend type Query {
 

server/bundles/io.cloudbeaver.service.rm/schema/service.rm.events.graphqls

@@ -1,3 +1,7 @@
+####################################################
+# Resource manager events
+####################################################
+
 extend enum CBServerEventId {
     "Resource manager resource created"
     cb_rm_resource_created,

server/bundles/io.cloudbeaver.service.rm/schema/service.rm.graphqls

@@ -1,4 +1,6 @@
+####################################################
 # Metadata queries
+####################################################
 
 type RMProject {
     id: ID!
@@ -17,7 +19,7 @@ type RMResource {
     name: String!
     folder: Boolean!
     length: Int!
-    # Properties map
+    "Properties map"
     properties: Object
 }