${title}

import type { HttpRequest, HttpResponseInit, InvocationContext, } from "@azure/functions"; import { createDocument, type ZodOpenApiSecuritySchemeObject, } from "zod-openapi"; import { openAPIPaths, openAPISchemas, openAPISecuritySchemas, openAPITags, } from "../utils/openapi-utils"; import { CONTENT_TYPES, SUPPORTED_CONTENT_TYPES_MSG } from "../utils/constants"; import { responseError } from "../utils/response-utils"; import { getStore } from "../utils/store"; export async function openAPIHandler( request: HttpRequest, context: InvocationContext ): Promise { const { authLevel, openapi, serviceName } = getStore(); const { title = serviceName.toUpperCase(), version = process.env["NODE_ENV"] || "TEST", servers, } = openapi || {}; context.log("Serving OpenAPI schema...", authLevel); try { const securitySchemes: Record = {}; if (authLevel) { securitySchemes["functionsKey"] = openAPISecuritySchemas.functionsKey; } const openAPISpec = createDocument({ openapi: "3.1.0", info: { title, version }, security: authLevel ? [{ functionsKey: [] }] : [], servers, tags: Object.values(openAPITags), paths: openAPIPaths, components: { schemas: openAPISchemas, securitySchemes, }, }); const { searchParams } = new URL(request.url); const isDownloadJSON = searchParams.get("download") === "json"; if (isDownloadJSON) { const headers = new Headers({ "Content-Disposition": `attachment; filename="${title}_${version}_openapi.json"`, }); return { status: 200, jsonBody: openAPISpec, headers }; } const accept = request.headers.get("accept"); if (!accept || accept.includes(CONTENT_TYPES.JSON)) { return { status: 200, jsonBody: openAPISpec }; } if (accept.includes(CONTENT_TYPES.HTML)) { const html = generateSwaggerUI(title, openAPISpec); return { status: 200, headers: { "Content-Type": CONTENT_TYPES.HTML }, body: html, }; } return { status: 406, body: SUPPORTED_CONTENT_TYPES_MSG }; } catch (error) { return responseError(error, context); } } function generateSwaggerUI(title: string, openAPISpec: object) { return /* html */ ` ${title}

`; }