Function endpointsToOAI31

src/lib/endpoints-to-oai31.ts:24–108

(
  endpoints: Array<Endpoint>,
  options: Options = defaultOptions,
)

import { AuthTypeString, Endpoint } from "../utils/types.js";

const endpointsToOAI31 = (
  endpoints: Array<Endpoint>,
  options: Options = defaultOptions,
): OpenApiBuilder => {
  const builder = createBuilderAndDocRoot(endpoints);
  const uniqueHosts = new Set<string>();
  const uniqueAuth = new Map<AuthTypeString, SecuritySchemeObject>();

  for (const endpoint of endpoints) {
    const fullPath = `/${endpoint.parts.map((p) => p.part).join("/")}`;
    const pathParameterObjects = createPathParameterTypes(endpoint);
    uniqueHosts.add(endpoint.host);

    const auth = endpoint.data.authentication;
    if (auth) {
      Object.values(auth).forEach((value) => {
        const securitySchema = createSecuritySchemeTypes(value);
        if (securitySchema) {
          uniqueAuth.set(formatAuthType(value.authType), securitySchema);
        }
      });
    }

    for (const method of Object.keys(endpoint.data.methods)) {
      const methodLower = method.toLowerCase();
      const endpointMethod = endpoint.data.methods[method]!;
      const queryParameterObjects = createQueryParameterTypes(
        endpointMethod.queryParameters,
      );
      const requestBody = createRequestTypes(endpointMethod.request, options);
      const responses = createResponseTypes(
        endpointMethod.response,
        endpointMethod.responseHeaders,
        options,
      );
      const security: SecurityRequirementObject[] = [];
      if (!isEmpty(endpoint.data.authentication)) {
        Object.values(endpoint.data.authentication).forEach((value) => {
          security.push({ [formatAuthType(value.authType)]: [] });
        });
      }
      const operation: OperationObject = {
        summary: fullPath,
        description: `**Host**: http://${endpoint.host}`,
        responses,
        ...(security && { security }),
      };
      const allParameterObjects = [
        ...pathParameterObjects,
        ...queryParameterObjects,
      ];
      if (allParameterObjects.length) {
        operation.parameters = allParameterObjects;
      }
      if (requestBody && shouldIncludeRequestBody(method)) {
        operation.requestBody = requestBody;
      }
      // The method (e.g. get) and the operation on it