internal/handlers/openapi.go

package handlers

import (
	"net/http"

	"github.com/pinchtab/pinchtab/internal/web"
)

func (h *Handlers) HandleOpenAPI(w http.ResponseWriter, _ *http.Request) {
	security := h.endpointSecurityStates()
	web.JSON(w, 200, map[string]any{
		"openapi": "3.0.0",
		"info": map[string]any{
			"title":   "Pinchtab API",
			"version": "0.7.x-local",
		},
		"x-pinchtab-security": security,
		"paths": map[string]any{
			"/health":   map[string]any{"get": map[string]any{"summary": "Health"}},
			"/tabs":     map[string]any{"get": map[string]any{"summary": "List tabs"}},
			"/metrics":  map[string]any{"get": map[string]any{"summary": "Runtime metrics"}},
			"/help":     map[string]any{"get": map[string]any{"summary": "Human help"}},
			"/text":     map[string]any{"get": map[string]any{"summary": "Extract text", "parameters": []map[string]any{{"name": "maxChars", "in": "query", "schema": map[string]string{"type": "integer"}}, {"name": "format", "in": "query", "schema": map[string]string{"type": "string"}}}}},
			"/navigate": map[string]any{"post": map[string]any{"summary": "Navigate"}, "get": map[string]any{"summary": "Navigate (query params)"}},
			"/nav":      map[string]any{"get": map[string]any{"summary": "Navigate alias"}},
			"/action":   map[string]any{"post": map[string]any{"summary": "Single action"}, "get": map[string]any{"summary": "Single action (query params)"}},
			"/actions":  map[string]any{"post": map[string]any{"summary": "Batch actions"}},
			"/snapshot": map[string]any{"get": map[string]any{"summary": "Accessibility snapshot"}},
			"/evaluate": map[string]any{"post": map[string]any{
				"summary":            "Run JavaScript in the current tab",
				"description":        security["evaluate"].Message,
				"x-pinchtab-enabled": security["evaluate"].Enabled,
			}},
			"/tabs/{id}/evaluate": map[string]any{"post": map[string]any{
				"summary":            "Run JavaScript in a specific tab",
				"description":        security["evaluate"].Message,
				"x-pinchtab-enabled": security["evaluate"].Enabled,
			}},
			"/macro": map[string]any{"post": map[string]any{
				"summary":            "Macro action pipeline",
				"description":        security["macro"].Message,
				"x-pinchtab-enabled": security["macro"].Enabled,
			}},
			"/download": map[string]any{"get": map[string]any{
				"summary":            "Download a URL using the browser session",
				"description":        security["download"].Message,
				"x-pinchtab-enabled": security["download"].Enabled,
			}},
			"/tabs/{id}/download": map[string]any{"get": map[string]any{
				"summary":            "Download a URL with a specific tab context",
				"description":        security["download"].Message,
				"x-pinchtab-enabled": security["download"].Enabled,
			}},
			"/upload": map[string]any{"post": map[string]any{
				"summary":            "Set files on a file input",
				"description":        security["upload"].Message,
				"x-pinchtab-enabled": security["upload"].Enabled,
			}},
			"/tabs/{id}/upload": map[string]any{"post": map[string]any{
				"summary":            "Set files on a file input in a specific tab",
				"description":        security["upload"].Message,
				"x-pinchtab-enabled": security["upload"].Enabled,
			}},
			"/screencast": map[string]any{"get": map[string]any{
				"summary":            "Stream live tab frames",
				"description":        security["screencast"].Message,
				"x-pinchtab-enabled": security["screencast"].Enabled,
			}},
			"/screencast/tabs": map[string]any{"get": map[string]any{
				"summary":            "List tabs available for live capture",
				"description":        security["screencast"].Message,
				"x-pinchtab-enabled": security["screencast"].Enabled,
			}},
		},
	})
}