dockhand/routes/api/hawser/connect/+server.ts

/**
 * Hawser Edge WebSocket Connect Endpoint
 *
 * This endpoint handles WebSocket connections from Hawser agents running in Edge mode.
 * In development: WebSocket is handled by Bun.serve in vite.config.ts on port 5174
 * In production: WebSocket is handled by the server wrapper in server.ts
 *
 * The HTTP GET endpoint returns connection info for clients.
 */

import { json } from '@sveltejs/kit';
import type { RequestHandler } from './$types';
import { isEdgeConnected, getAllEdgeConnections } from '$lib/server/hawser';

/**
 * GET /api/hawser/connect
 * Returns status of the Hawser Edge connection endpoint
 * This is used for health checks and debugging
 */
export const GET: RequestHandler = async () => {
	const connections = getAllEdgeConnections();
	const connectionList = Array.from(connections.entries()).map(([envId, conn]) => ({
		environmentId: envId,
		agentId: conn.agentId,
		agentName: conn.agentName,
		agentVersion: conn.agentVersion,
		dockerVersion: conn.dockerVersion,
		hostname: conn.hostname,
		capabilities: conn.capabilities,
		connectedAt: conn.connectedAt.toISOString(),
		lastHeartbeat: conn.lastHeartbeat.toISOString()
	}));

	return json({
		status: 'ready',
		message: 'Hawser Edge WebSocket endpoint. Connect via WebSocket.',
		protocol: 'wss://<host>/api/hawser/connect',
		activeConnections: connectionList.length,
		connections: connectionList
	});
};

/**
 * POST /api/hawser/connect
 * This is a fallback for non-WebSocket clients.
 * Returns instructions for connecting via WebSocket.
 */
export const POST: RequestHandler = async () => {
	return json(
		{
			error: 'WebSocket required',
			message: 'This endpoint requires a WebSocket connection. Use the ws:// or wss:// protocol.',
			instructions: [
				'1. Generate a token in Settings > Environments > [Environment] > Hawser',
				'2. Configure your Hawser agent with DOCKHAND_SERVER_URL and TOKEN',
				'3. The agent will connect automatically'
			]
		},
		{ status: 426 }
	); // 426 Upgrade Required
};