\r\n

Loading API Documentation...

\r\n

\r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n\r\n`;\r\n\r\n return new Response(html, {\r\n status: 200,\r\n headers: {\r\n \"Content-Type\": \"text/html; charset=utf-8\",\r\n \"Cache-Control\": \"public, max-age=300, stale-while-revalidate=3600\",\r\n // Security headers handled by middleware\r\n \"Referrer-Policy\": \"strict-origin-when-cross-origin\",\r\n },\r\n });\r\n }\r\n\r\n /**\r\n * Serves OAuth2 redirect page for Swagger UI authentication\r\n */\r\n static serveOAuth2Redirect(): Response {\r\n const html = `\r\n\r\n\r\n\r\n \r\n OAuth2 Redirect\r\n\r\n\r\n \r\n\r\n`;\r\n\r\n return new Response(html, {\r\n status: 200,\r\n headers: {\r\n \"Content-Type\": \"text/html; charset=utf-8\",\r\n \"Cache-Control\": \"public, max-age=86400\", // Cache for 24 hours\r\n },\r\n });\r\n }\r\n\r\n /**\r\n * Serves Redocly-style documentation with enhanced features\r\n */\r\n static serveRedocDocs(request: Request): Response {\r\n try {\r\n const url = new URL(request.url);\r\n const specUrl = `${url.origin}/api/v1/openapi.json`;\r\n console.log(`Redoc will fetch OpenAPI spec from: ${specUrl}`);\r\n\r\n const title = \"🛡️ ZenPay API Documentation 📚\";\r\n\r\n const html = `\r\n\r\n\r\n\r\n \r\n \r\n ${title}\r\n \r\n \r\n\r\n\r\n

Loading API Documentation...

\r\n \r\n \r\n \r\n\r\n`;\r\n\r\n return new Response(html, {\r\n status: 200,\r\n headers: {\r\n \"Content-Type\": \"text/html; charset=utf-8\",\r\n \"Cache-Control\": \"public, max-age=300, stale-while-revalidate=3600\",\r\n // Security headers handled by middleware\r\n \"Referrer-Policy\": \"strict-origin-when-cross-origin\",\r\n },\r\n });\r\n } catch (error) {\r\n // Return error page\r\n const errorHtml = `\r\n\r\n\r\n\r\n \r\n \r\n API Documentation Error\r\n \r\n\r\n\r\n

\r\n

API Documentation Unavailable

\r\n

The API documentation could not be loaded at this time.

\r\n

\r\n Error: ${error.message}\r\n

\r\n

This usually happens when:

\r\n

The OpenAPI specification file is not accessible
The server is still initializing
There's a configuration error

\r\n \r\n

\r\n\r\n`;\r\n\r\n return new Response(errorHtml, {\r\n status: 500,\r\n headers: {\r\n \"Content-Type\": \"text/html; charset=utf-8\",\r\n // Security headers handled by middleware\r\n },\r\n });\r\n }\r\n }\r\n\r\n /**\r\n * Serves interactive Fiberplane playground for API testing\r\n */\r\n static async serveFiberplanePlayground(request: Request): Promise {\r\n try {\r\n // Use the loader instance that was set by API Gateway\r\n if (!this.loader) {\r\n throw new Error(\"OpenAPI loader not initialized. DocsHandler.setLoader() must be called first.\");\r\n }\r\n\r\n // Get OpenAPI spec directly from loader (no HTTP request needed)\r\n const openApiSpec = this.loader.getSpec();\r\n\r\n const title = \"🛡️ ZenPay API Playground ⚔️\";\r\n\r\n const html = `\r\n\r\n\r\n\r\n \r\n \r\n ${title}\r\n \r\n\r\n\r\n

\r\n

${title}

\r\n

Interactive API Testing Environment

\r\n

\r\n \r\n

\r\n

API Endpoints

\r\n

Loading API endpoints...

\r\n

\r\n \r\n

\r\n

Request Builder

\r\n

Select an endpoint from the left to start building a request.

\r\n

\r\n \r\n

\r\n

Response

\r\n

Ready to send requests...

\r\n

\r\n\r\n \r\n\r\n`;\r\n\r\n return new Response(html, {\r\n status: 200,\r\n headers: {\r\n \"Content-Type\": \"text/html; charset=utf-8\",\r\n \"Cache-Control\": \"public, max-age=300, stale-while-revalidate=3600\",\r\n // Security headers handled by middleware\r\n \"Referrer-Policy\": \"strict-origin-when-cross-origin\",\r\n },\r\n });\r\n } catch (error) {\r\n console.error(\"Error in serveFiberplanePlayground:\", error);\r\n\r\n const errorHtml = `\r\n\r\n\r\n\r\n \r\n \r\n Playground Error\r\n \r\n\r\n\r\n

\r\n

API Playground Unavailable

\r\n

The API playground could not be loaded at this time.

\r\n

\r\n Error: ${error.message}\r\n

\r\n

This usually happens when:

\r\n

The OpenAPI specification file is not accessible
The server is still initializing
There's a configuration error

\r\n \r\n

\r\n\r\n`;\r\n\r\n return new Response(errorHtml, {\r\n status: 500,\r\n headers: {\r\n \"Content-Type\": \"text/html; charset=utf-8\",\r\n // Security headers handled by middleware\r\n },\r\n });\r\n }\r\n }\r\n}\r\n","deleted","label",[171,172,153],"src","handlers","permalink","https://www.val.town/x/ianmenethil/ZenServer/code/src/handlers/docsHandler.ts","extension","actionData","errors"]