feat(gateway): add client configuration endpoints and modal

Author: Lasim

services/backend/api-spec.json

@@ -19536,7 +19536,7 @@
         }
       }
     },
-    "/api/config/{client}": {
+    "/api/gateway/config/{client}": {
       "get": {
         "summary": "Get client-specific gateway configuration",
         "tags": [
@@ -19657,6 +19657,104 @@
         }
       }
     },
+    "/api/gateway/config/clients": {
+      "get": {
+        "summary": "List supported MCP client types",
+        "tags": [
+          "Gateway Configuration"
+        ],
+        "description": "Returns a list of all supported MCP client types that can be configured with the DeployStack Gateway.",
+        "security": [
+          {
+            "cookieAuth": []
+          },
+          {
+            "bearerAuth": []
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "List of supported MCP client types",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "clients": {
+                      "type": "array",
+                      "items": {
+                        "type": "string",
+                        "enum": [
+                          "claude-desktop",
+                          "cline",
+                          "vscode",
+                          "cursor",
+                          "windsurf"
+                        ]
+                      },
+                      "description": "List of supported MCP client types"
+                    }
+                  },
+                  "required": [
+                    "clients"
+                  ],
+                  "additionalProperties": false,
+                  "description": "List of supported MCP client types"
+                }
+              }
+            }
+          },
+          "401": {
+            "description": "Unauthorized - Authentication required",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "success": {
+                      "type": "boolean",
+                      "default": false
+                    },
+                    "error": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "success",
+                    "error"
+                  ],
+                  "description": "Unauthorized - Authentication required"
+                }
+              }
+            }
+          },
+          "403": {
+            "description": "Forbidden - Insufficient permissions",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "success": {
+                      "type": "boolean",
+                      "default": false
+                    },
+                    "error": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "success",
+                    "error"
+                  ],
+                  "description": "Forbidden - Insufficient permissions"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
     "/api/auth/email/register": {
       "post": {
         "summary": "User registration via email",

services/backend/api-spec.yaml

@@ -13433,7 +13433,7 @@ paths:
                   - success
                   - error
                 description: Internal Server Error - SMTP configuration or email sending failed
-  /api/config/{client}:
+  /api/gateway/config/{client}:
     get:
       summary: Get client-specific gateway configuration
       tags:
@@ -13513,6 +13513,71 @@ paths:
                   - success
                   - error
                 description: Forbidden - Insufficient permissions
+  /api/gateway/config/clients:
+    get:
+      summary: List supported MCP client types
+      tags:
+        - Gateway Configuration
+      description: Returns a list of all supported MCP client types that can be
+        configured with the DeployStack Gateway.
+      security:
+        - cookieAuth: []
+        - bearerAuth: []
+      responses:
+        "200":
+          description: List of supported MCP client types
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  clients:
+                    type: array
+                    items:
+                      type: string
+                      enum:
+                        - claude-desktop
+                        - cline
+                        - vscode
+                        - cursor
+                        - windsurf
+                    description: List of supported MCP client types
+                required:
+                  - clients
+                additionalProperties: false
+                description: List of supported MCP client types
+        "401":
+          description: Unauthorized - Authentication required
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  success:
+                    type: boolean
+                    default: false
+                  error:
+                    type: string
+                required:
+                  - success
+                  - error
+                description: Unauthorized - Authentication required
+        "403":
+          description: Forbidden - Insufficient permissions
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  success:
+                    type: boolean
+                    default: false
+                  error:
+                    type: string
+                required:
+                  - success
+                  - error
+                description: Forbidden - Insufficient permissions
   /api/auth/email/register:
     post:
       summary: User registration via email

services/backend/src/routes/gateway/config/get-client-config.ts

@@ -1,44 +1,12 @@
 import { type FastifyInstance } from 'fastify';
 import { requireAuthenticationAny, requireOAuthScope } from '../../../middleware/oauthMiddleware';
-
-// Reusable Schema Constants
-const CLIENT_PARAM_SCHEMA = {
-  type: 'object',
-  properties: {
-    client: {
-      type: 'string',
-      enum: ['claude-desktop', 'cline', 'vscode', 'cursor', 'windsurf'],
-      description: 'The MCP client type'
-    }
-  },
-  required: ['client'],
-  additionalProperties: false
-} as const;
-
-const SUCCESS_RESPONSE_SCHEMA = {
-  type: 'object',
-  description: 'Client-specific gateway configuration (format varies by client type)',
-  additionalProperties: true
-} as const;
-
-const ERROR_RESPONSE_SCHEMA = {
-  type: 'object',
-  properties: {
-    success: { type: 'boolean', default: false },
-    error: { type: 'string' }
-  },
-  required: ['success', 'error']
-} as const;
-
-// TypeScript interfaces
-interface ClientParams {
-  client: 'claude-desktop' | 'cline' | 'vscode' | 'cursor' | 'windsurf';
-}
-
-interface ErrorResponse {
-  success: boolean;
-  error: string;
-}
+import { 
+  CLIENT_PARAM_SCHEMA, 
+  SUCCESS_RESPONSE_SCHEMA, 
+  ERROR_RESPONSE_SCHEMA,
+  type ClientParams,
+  type ErrorResponse
+} from './schemas';
 
 // Client configuration generator
 function generateClientConfig(clientType: string): object {
@@ -92,7 +60,7 @@ function generateClientConfig(clientType: string): object {
 }
 
 export default async function getClientConfig(server: FastifyInstance) {
-  server.get('/config/:client', {
+  server.get('/gateway/config/:client', {
     preValidation: [
       requireAuthenticationAny(),
       requireOAuthScope('gateway:config:read')

services/backend/src/routes/gateway/config/list-clients.ts

@@ -0,0 +1,57 @@
+import { type FastifyInstance } from 'fastify';
+import { requireAuthenticationAny, requireOAuthScope } from '../../../middleware/oauthMiddleware';
+import { 
+  CLIENT_TYPES, 
+  CLIENTS_LIST_RESPONSE_SCHEMA, 
+  ERROR_RESPONSE_SCHEMA,
+  type ClientsListResponse,
+  type ErrorResponse
+} from './schemas';
+
+export default async function listClients(server: FastifyInstance) {
+  server.get('/gateway/config/clients', {
+    preValidation: [
+      requireAuthenticationAny(),
+      requireOAuthScope('gateway:config:read')
+    ],
+    schema: {
+      tags: ['Gateway Configuration'],
+      summary: 'List supported MCP client types',
+      description: 'Returns a list of all supported MCP client types that can be configured with the DeployStack Gateway.',
+      security: [
+        { cookieAuth: [] },
+        { bearerAuth: [] }
+      ],
+      response: {
+        200: {
+          ...CLIENTS_LIST_RESPONSE_SCHEMA,
+          description: 'List of supported MCP client types'
+        },
+        401: {
+          ...ERROR_RESPONSE_SCHEMA,
+          description: 'Unauthorized - Authentication required'
+        },
+        403: {
+          ...ERROR_RESPONSE_SCHEMA,
+          description: 'Forbidden - Insufficient permissions'
+        }
+      }
+    }
+  }, async (request, reply) => {
+    try {
+      const response: ClientsListResponse = {
+        clients: CLIENT_TYPES
+      };
+      
+      const jsonString = JSON.stringify(response);
+      return reply.status(200).type('application/json').send(jsonString);
+    } catch (error) {
+      const errorResponse: ErrorResponse = {
+        success: false,
+        error: error instanceof Error ? error.message : 'Internal server error'
+      };
+      const jsonString = JSON.stringify(errorResponse);
+      return reply.status(500).type('application/json').send(jsonString);
+    }
+  });
+}

services/backend/src/routes/gateway/config/schemas.ts

@@ -0,0 +1,65 @@
+// Shared schemas for gateway configuration endpoints
+
+// Supported MCP client types
+export const CLIENT_TYPES = ['claude-desktop', 'cline', 'vscode', 'cursor', 'windsurf'] as const;
+
+export type ClientType = typeof CLIENT_TYPES[number];
+
+// Reusable Schema Constants
+export const CLIENT_PARAM_SCHEMA = {
+  type: 'object',
+  properties: {
+    client: {
+      type: 'string',
+      enum: CLIENT_TYPES,
+      description: 'The MCP client type'
+    }
+  },
+  required: ['client'],
+  additionalProperties: false
+} as const;
+
+export const SUCCESS_RESPONSE_SCHEMA = {
+  type: 'object',
+  description: 'Client-specific gateway configuration (format varies by client type)',
+  additionalProperties: true
+} as const;
+
+export const CLIENTS_LIST_RESPONSE_SCHEMA = {
+  type: 'object',
+  properties: {
+    clients: {
+      type: 'array',
+      items: {
+        type: 'string',
+        enum: CLIENT_TYPES
+      },
+      description: 'List of supported MCP client types'
+    }
+  },
+  required: ['clients'],
+  additionalProperties: false
+} as const;
+
+export const ERROR_RESPONSE_SCHEMA = {
+  type: 'object',
+  properties: {
+    success: { type: 'boolean', default: false },
+    error: { type: 'string' }
+  },
+  required: ['success', 'error']
+} as const;
+
+// TypeScript interfaces
+export interface ClientParams {
+  client: ClientType;
+}
+
+export interface ClientsListResponse {
+  clients: readonly string[];
+}
+
+export interface ErrorResponse {
+  success: boolean;
+  error: string;
+}

services/backend/src/routes/gateway/index.ts

@@ -1,7 +1,9 @@
 import { type FastifyInstance } from 'fastify';
 import getClientConfig from './config/get-client-config';
+import listClients from './config/list-clients';
 
 export default async function gatewayRoutes(server: FastifyInstance) {
   // Register gateway configuration routes
   await server.register(getClientConfig);
+  await server.register(listClients);
 }

services/backend/src/routes/users/preferences/schemas.ts

@@ -5,6 +5,7 @@ import { DEFAULT_USER_PREFERENCES, type PreferenceValue } from '../../../config/
 
 // Helper function to generate schema properties from config
 function generateSchemaProperties() {
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
   const properties: Record<string, any> = {};
 
   for (const [key, defaultValue] of Object.entries(DEFAULT_USER_PREFERENCES)) {