import { json } from '@sveltejs/kit'; import { unixSocketRequest, httpsAgentRequest } from '$lib/server/docker'; import type { DockerClientConfig } from '$lib/server/docker'; import type { RequestHandler } from './$types'; interface TestConnectionRequest { connectionType: 'socket' | 'direct' | 'hawser-standard' | 'hawser-edge'; socketPath?: string; host?: string; port?: number; protocol?: string; tlsCa?: string; tlsCert?: string; tlsKey?: string; tlsSkipVerify?: boolean; hawserToken?: string; } function cleanPem(pem: string): string { return pem .split('\n') .map((line) => line.trim()) .filter((line) => line.length > 0) .join('\n'); } function buildDockerClientConfig(config: TestConnectionRequest): DockerClientConfig | null { const protocol = config.protocol || 'http'; if (protocol !== 'https') return null; return { type: 'https', host: config.host || 'localhost', port: config.port || 2376, ca: config.tlsCa ? cleanPem(config.tlsCa) || undefined : undefined, cert: config.tlsCert ? cleanPem(config.tlsCert) || undefined : undefined, key: config.tlsKey ? cleanPem(config.tlsKey) || undefined : undefined, skipVerify: config.tlsSkipVerify || false }; } /** * Test Docker connection with provided configuration (without saving to database) * * @openapi * summary: Test a Docker/Hawser connection configuration WITHOUT saving it as an environment * body: {connectionType:string!, socketPath:string, host:string, port:integer, protocol:string, tlsCa:string, tlsCert:string, tlsKey:string, tlsSkipVerify:boolean, hawserToken:string} * body-example: {"connectionType":"socket","socketPath":"/var/run/docker.sock"} * resp-200: {success:boolean!, info:{serverVersion:string, containers:integer, images:integer, name:string}, hawser:{}} * resp-200-desc: success:false with a human-readable error message is also returned as HTTP 200 (connection failures are not transport errors) * resp-400: Host is required for direct/hawser-standard connection types */ export const POST: RequestHandler = async ({ request }) => { try { const config: TestConnectionRequest = await request.json(); // Build fetch options based on connection type let response: Response; if (config.connectionType === 'socket') { const socketPath = config.socketPath || '/var/run/docker.sock'; response = await unixSocketRequest(socketPath, '/info'); } else if (config.connectionType === 'hawser-edge') { // Edge mode - cannot test directly, agent connects to us return json({ success: true, info: { message: 'Edge mode environments are tested when the agent connects' }, isEdgeMode: true }); } else { // Direct or Hawser Standard - HTTP/HTTPS connection const protocol = config.protocol || 'http'; const host = config.host; const port = config.port || 2375; if (!host) { return json({ success: false, error: 'Host is required' }, { status: 400 }); } const headers: Record = { 'Content-Type': 'application/json' }; if (config.connectionType === 'hawser-standard' && config.hawserToken) { headers['X-Hawser-Token'] = config.hawserToken; } const tlsConfig = buildDockerClientConfig(config); if (tlsConfig) { response = await httpsAgentRequest(tlsConfig, '/info', {}, false, headers); } else { const url = `http://${host}:${port}/info`; response = await fetch(url, { headers, signal: AbortSignal.timeout(10000), keepalive: false }); } } if (!response.ok) { const error = await response.text(); throw new Error(`Docker API error: ${response.status} - ${error}`); } const info = await response.json(); // For Hawser Standard, also try to fetch Hawser info let hawserInfo = null; if (config.connectionType === 'hawser-standard' && config.host) { try { const protocol = config.protocol || 'http'; const hawserHeaders: Record = {}; if (config.hawserToken) { hawserHeaders['X-Hawser-Token'] = config.hawserToken; } let hawserResp: Response; const tlsConfig = buildDockerClientConfig(config); if (tlsConfig) { hawserResp = await httpsAgentRequest(tlsConfig, '/_hawser/info', {}, false, hawserHeaders); } else { const hawserUrl = `http://${config.host}:${config.port || 2375}/_hawser/info`; hawserResp = await fetch(hawserUrl, { headers: hawserHeaders, signal: AbortSignal.timeout(5000), keepalive: false }); } if (hawserResp.ok) { hawserInfo = await hawserResp.json(); } } catch { // Hawser info fetch failed, continue without it } } return json({ success: true, info: { serverVersion: info.ServerVersion, containers: info.Containers, images: info.Images, name: info.Name }, hawser: hawserInfo }); } catch (error) { const rawMessage = error instanceof Error ? error.message : 'Connection failed'; console.error('Failed to test connection:', rawMessage); // Provide more helpful error messages let message = rawMessage; if (rawMessage.includes('401') || rawMessage.toLowerCase().includes('unauthorized')) { message = 'Invalid token - check that the Hawser token matches'; } else if (rawMessage.includes('403') || rawMessage.toLowerCase().includes('forbidden')) { message = 'Access forbidden - check token permissions'; } else if (rawMessage.includes('ECONNREFUSED') || rawMessage.includes('Connection refused')) { message = 'Connection refused - is Docker/Hawser running?'; } else if (rawMessage.includes('ETIMEDOUT') || rawMessage.includes('timeout') || rawMessage.includes('Timeout')) { message = 'Connection timed out - check host and port'; } else if (rawMessage.includes('ENOTFOUND') || rawMessage.includes('getaddrinfo')) { message = 'Host not found - check the hostname'; } else if (rawMessage.includes('EHOSTUNREACH')) { message = 'Host unreachable - check network connectivity'; } else if (rawMessage.includes('ENOENT') || rawMessage.includes('no such file')) { message = 'Socket not found - check the socket path'; } else if (rawMessage.includes('EACCES') || rawMessage.includes('permission denied')) { message = 'Permission denied - check socket permissions'; } else if (rawMessage.includes('typo in the url') || rawMessage.includes('Was there a typo')) { message = 'Connection failed - check host and port'; } else if (rawMessage.includes('self signed certificate') || rawMessage.includes('UNABLE_TO_VERIFY_LEAF_SIGNATURE')) { message = 'TLS certificate error - provide CA certificate for self-signed certs'; } else if (rawMessage.includes('CERT_ALTNAME_INVALID') || rawMessage.includes('ERR_TLS_CERT_ALTNAME_INVALID')) { message = 'Certificate hostname mismatch - your certificate\'s Subject Alternative Name (SAN) doesn\'t match the host. Regenerate with: -addext "subjectAltName=DNS:hostname,IP:x.x.x.x"'; } else if (rawMessage.includes('certificate') || rawMessage.includes('SSL') || rawMessage.includes('TLS')) { message = 'TLS/SSL error - check certificate configuration'; } return json({ success: false, error: message }, { status: 200 }); } };