@f3liz/rescript-autogen-openapi 0.3.1

package/lib/es6/src/Codegen.mjs

@@ -0,0 +1,423 @@
+// Generated by ReScript, PLEASE EDIT WITH CARE
+
+import * as Config from "./types/Config.mjs";
+import * as Pipeline from "./core/Pipeline.mjs";
+import * as Belt_Array from "@rescript/runtime/lib/es6/Belt_Array.js";
+import * as FileSystem from "./core/FileSystem.mjs";
+import * as SpecDiffer from "./core/SpecDiffer.mjs";
+import * as SpecMerger from "./core/SpecMerger.mjs";
+import * as DocOverride from "./core/DocOverride.mjs";
+import * as Stdlib_Array from "@rescript/runtime/lib/es6/Stdlib_Array.js";
+import * as Stdlib_JsExn from "@rescript/runtime/lib/es6/Stdlib_JsExn.js";
+import * as OpenAPIParser from "./core/OpenAPIParser.mjs";
+import * as Stdlib_Option from "@rescript/runtime/lib/es6/Stdlib_Option.js";
+import * as Stdlib_Result from "@rescript/runtime/lib/es6/Stdlib_Result.js";
+import * as ModuleGenerator from "./generators/ModuleGenerator.mjs";
+import * as JsConvertCase from "js-convert-case";
+import * as SchemaRefResolver from "./core/SchemaRefResolver.mjs";
+import * as DiffReportGenerator from "./generators/DiffReportGenerator.mjs";
+import * as Primitive_exceptions from "@rescript/runtime/lib/es6/Primitive_exceptions.js";
+import * as ThinWrapperGenerator from "./generators/ThinWrapperGenerator.mjs";
+import * as TypeScriptDtsGenerator from "./generators/TypeScriptDtsGenerator.mjs";
+import * as ComponentSchemaGenerator from "./generators/ComponentSchemaGenerator.mjs";
+import * as TypeScriptWrapperGenerator from "./generators/TypeScriptWrapperGenerator.mjs";
+
+function generateSingleSpecPure(spec, config) {
+  try {
+    let targets = Stdlib_Option.getOr(config.targets, Config.defaultTargets());
+    let allEndpoints = OpenAPIParser.getAllEndpoints(spec);
+    let includeTags = config.includeTags;
+    let endpoints = includeTags !== undefined ? OpenAPIParser.filterByTags(allEndpoints, includeTags, Stdlib_Option.getOr(config.excludeTags, [])) : allEndpoints;
+    let baseOutput = targets.rescriptApi ? Pipeline.combine([
+        ComponentSchemaGenerator.generate(spec, config.outputDir),
+        config.modulePerTag ? ModuleGenerator.generateTagModuleFiles(endpoints, config.outputDir, undefined, config.docOverrideDir) : ModuleGenerator.generateFlatModuleFile("API", endpoints, config.outputDir, config.docOverrideDir)
+      ]) : Pipeline.empty;
+    let wrapperOutput = targets.rescriptWrapper ? ThinWrapperGenerator.generateWrapper(spec, endpoints, undefined, config.outputDir, JsConvertCase.toPascalCase(spec.info.title) + "Wrapper", "", undefined) : Pipeline.empty;
+    let dtsOutput = targets.typescriptDts ? TypeScriptDtsGenerator.generate(spec, endpoints, Stdlib_Option.getOr(config.dtsOutputDir, config.outputDir)) : Pipeline.empty;
+    let tsWrapperOutput = targets.typescriptWrapper ? TypeScriptWrapperGenerator.generate(endpoints, Stdlib_Option.getOr(config.wrapperOutputDir, config.outputDir), "../generated") : Pipeline.empty;
+    return {
+      TAG: "Ok",
+      _0: Pipeline.combine([
+        baseOutput,
+        wrapperOutput,
+        dtsOutput,
+        tsWrapperOutput
+      ])
+    };
+  } catch (raw_err) {
+    let err = Primitive_exceptions.internalToException(raw_err);
+    if (err.RE_EXN_ID === "JsExn") {
+      return {
+        TAG: "Error",
+        _0: {
+          TAG: "UnknownError",
+          message: Stdlib_Option.getOr(Stdlib_JsExn.message(err._1), "Unknown error"),
+          context: undefined
+        }
+      };
+    } else {
+      return {
+        TAG: "Error",
+        _0: {
+          TAG: "UnknownError",
+          message: "Unknown error",
+          context: undefined
+        }
+      };
+    }
+  }
+}
+
+async function generateSingleSpec(spec, config) {
+  let err = generateSingleSpecPure(spec, config);
+  if (err.TAG !== "Ok") {
+    return {
+      TAG: "Error",
+      _0: err._0
+    };
+  }
+  let output = err._0;
+  let errors = FileSystem.writeFiles(output.files);
+  if (errors.TAG !== "Ok") {
+    return {
+      TAG: "Error",
+      _0: {
+        TAG: "UnknownError",
+        message: `Failed to write files: ` + errors._0.join(", "),
+        context: undefined
+      }
+    };
+  }
+  let match = config.generateDocOverrides;
+  let overrideFiles;
+  if (match !== undefined) {
+    if (match) {
+      let allEndpoints = OpenAPIParser.getAllEndpoints(spec);
+      let includeTags = config.includeTags;
+      let endpoints = includeTags !== undefined ? OpenAPIParser.filterByTags(allEndpoints, includeTags, Stdlib_Option.getOr(config.excludeTags, [])) : allEndpoints;
+      let files = DocOverride.generateOverrideFiles(spec, endpoints, Stdlib_Option.getOr(config.docOverrideDir, "./docs"), spec.info.title, config.modulePerTag, undefined);
+      overrideFiles = Stdlib_Result.getOr(FileSystem.writeFiles(files), []);
+    } else {
+      overrideFiles = [];
+    }
+  } else {
+    overrideFiles = [];
+  }
+  return {
+    TAG: "Ok",
+    _0: {
+      generatedFiles: errors._0.concat(overrideFiles),
+      diff: undefined,
+      warnings: output.warnings
+    }
+  };
+}
+
+function processForkPure(baseSpec, baseEndpoints, fork, config) {
+  try {
+    let forkEndpoints = OpenAPIParser.getAllEndpoints(fork.spec);
+    let diff = SpecDiffer.generateDiff(baseSpec, fork.spec, baseEndpoints, forkEndpoints);
+    let diffReportFile = config.generateDiffReport ? ({
+        path: FileSystem.makePath(config.outputDir, fork.name + `-diff.md`),
+        content: DiffReportGenerator.generateMarkdownReport(diff, "base", fork.name)
+      }) : undefined;
+    let match = SpecMerger.mergeSpecs(baseSpec, fork.spec, baseEndpoints, forkEndpoints, config.strategy);
+    let sharedSpec = match[0];
+    let sharedEndpoints = OpenAPIParser.getAllEndpoints(sharedSpec);
+    let extensionEndpoints = OpenAPIParser.getAllEndpoints(match[1]);
+    let mergeReportFile_path = FileSystem.makePath(config.outputDir, fork.name + `-merge.md`);
+    let mergeReportFile_content = DiffReportGenerator.generateMergeReport(SpecMerger.getMergeStats(baseEndpoints, forkEndpoints, Stdlib_Option.flatMap(baseSpec.components, c => c.schemas), Stdlib_Option.flatMap(fork.spec.components, c => c.schemas)), "base", fork.name);
+    let mergeReportFile = {
+      path: mergeReportFile_path,
+      content: mergeReportFile_content
+    };
+    let match$1 = config.strategy;
+    let codeOutput;
+    if (match$1 === "Separate") {
+      codeOutput = Pipeline.fromFile({
+        path: FileSystem.makePath(config.outputDir, fork.name + `.res`),
+        content: ModuleGenerator.generateFlatModuleCode(JsConvertCase.toPascalCase(fork.name), forkEndpoints, config.docOverrideDir)
+      });
+    } else {
+      let baseName = Stdlib_Option.getOrThrow(config.baseInstanceName, "baseInstanceName required");
+      let basePrefix = Stdlib_Option.getOr(config.baseModulePrefix, JsConvertCase.toPascalCase(baseName));
+      codeOutput = ModuleGenerator.generateSeparatePerTagModules(baseName, basePrefix, fork.name, undefined, sharedEndpoints, extensionEndpoints, Stdlib_Option.flatMap(sharedSpec.components, c => c.schemas), Stdlib_Option.flatMap(fork.spec.components, c => c.schemas), config.outputDir, config.docOverrideDir);
+    }
+    let targets = Stdlib_Option.getOr(config.targets, {
+      rescriptApi: true,
+      rescriptWrapper: false,
+      typescriptDts: false,
+      typescriptWrapper: false
+    });
+    let match$2 = config.strategy;
+    let match$3;
+    match$3 = match$2 === "Separate" ? [
+        fork.spec,
+        forkEndpoints,
+        [],
+        ""
+      ] : [
+        sharedSpec,
+        sharedEndpoints,
+        extensionEndpoints,
+        Stdlib_Option.getOr(config.baseModulePrefix, Stdlib_Option.getOr(Stdlib_Option.map(config.baseInstanceName, prim => JsConvertCase.toPascalCase(prim)), ""))
+      ];
+    let wExt = match$3[2];
+    let wShared = match$3[1];
+    let wSpec = match$3[0];
+    let wrapperOutput = targets.rescriptWrapper ? ThinWrapperGenerator.generateWrapper(wSpec, wShared, wExt, FileSystem.makePath(config.outputDir, fork.name), JsConvertCase.toPascalCase(fork.name) + "Wrapper", JsConvertCase.toPascalCase(fork.name), match$3[3]) : Pipeline.empty;
+    let allWEndpoints = wShared.concat(wExt);
+    let dtsOutput = targets.typescriptDts ? TypeScriptDtsGenerator.generate(wSpec, allWEndpoints, FileSystem.makePath(Stdlib_Option.getOr(config.dtsOutputDir, config.outputDir), fork.name)) : Pipeline.empty;
+    let tsWrapperOutput = targets.typescriptWrapper ? TypeScriptWrapperGenerator.generate(allWEndpoints, FileSystem.makePath(Stdlib_Option.getOr(config.wrapperOutputDir, config.outputDir), fork.name), `../../generated/` + fork.name) : Pipeline.empty;
+    let reports = Pipeline.fromFiles(Belt_Array.concatMany([
+      [mergeReportFile],
+      Stdlib_Option.getOr(Stdlib_Option.map(diffReportFile, f => [f]), [])
+    ]));
+    return {
+      TAG: "Ok",
+      _0: Pipeline.combine([
+        reports,
+        codeOutput,
+        wrapperOutput,
+        dtsOutput,
+        tsWrapperOutput
+      ])
+    };
+  } catch (raw_err) {
+    let err = Primitive_exceptions.internalToException(raw_err);
+    if (err.RE_EXN_ID === "JsExn") {
+      return {
+        TAG: "Error",
+        _0: {
+          TAG: "UnknownError",
+          message: Stdlib_Option.getOr(Stdlib_JsExn.message(err._1), "Unknown error"),
+          context: undefined
+        }
+      };
+    } else {
+      return {
+        TAG: "Error",
+        _0: {
+          TAG: "UnknownError",
+          message: "Unknown error",
+          context: undefined
+        }
+      };
+    }
+  }
+}
+
+function generateMultiSpecPure(baseSpec, forkSpecs, config) {
+  try {
+    let baseEndpoints = OpenAPIParser.getAllEndpoints(baseSpec);
+    let forkResults = forkSpecs.map(fork => processForkPure(baseSpec, baseEndpoints, fork, config));
+    let match = forkResults.find(Stdlib_Result.isError);
+    let exit = 0;
+    if (match !== undefined) {
+      if (match.TAG !== "Ok") {
+        return {
+          TAG: "Error",
+          _0: match._0
+        };
+      }
+      exit = 1;
+    } else {
+      exit = 1;
+    }
+    if (exit === 1) {
+      let outputs = Stdlib_Array.filterMap(forkResults, res => {
+        if (res.TAG === "Ok") {
+          return res._0;
+        }
+      });
+      let targets = Stdlib_Option.getOr(config.targets, Config.defaultTargets());
+      let baseName = Stdlib_Option.getOrThrow(config.baseInstanceName, "baseInstanceName required");
+      let basePrefix = Stdlib_Option.getOr(config.baseModulePrefix, JsConvertCase.toPascalCase(baseName));
+      let baseOutputDir = FileSystem.makePath(config.outputDir, baseName);
+      let baseWrappers = Pipeline.combine([
+        targets.rescriptWrapper ? ThinWrapperGenerator.generateWrapper(baseSpec, baseEndpoints, undefined, baseOutputDir, basePrefix + "Wrapper", basePrefix, undefined) : Pipeline.empty,
+        targets.typescriptDts ? TypeScriptDtsGenerator.generate(baseSpec, baseEndpoints, FileSystem.makePath(Stdlib_Option.getOr(config.dtsOutputDir, config.outputDir), baseName)) : Pipeline.empty,
+        targets.typescriptWrapper ? TypeScriptWrapperGenerator.generate(baseEndpoints, FileSystem.makePath(Stdlib_Option.getOr(config.wrapperOutputDir, config.outputDir), baseName), `../../generated/` + baseName) : Pipeline.empty
+      ]);
+      return {
+        TAG: "Ok",
+        _0: Pipeline.combine(outputs.concat([baseWrappers]))
+      };
+    }
+  } catch (raw_err) {
+    let err = Primitive_exceptions.internalToException(raw_err);
+    if (err.RE_EXN_ID === "JsExn") {
+      return {
+        TAG: "Error",
+        _0: {
+          TAG: "UnknownError",
+          message: Stdlib_Option.getOr(Stdlib_JsExn.message(err._1), "Unknown error"),
+          context: undefined
+        }
+      };
+    } else {
+      return {
+        TAG: "Error",
+        _0: {
+          TAG: "UnknownError",
+          message: "Unknown error",
+          context: undefined
+        }
+      };
+    }
+  }
+}
+
+async function generateMultiSpec(baseSpec, forkSpecs, config) {
+  let err = generateMultiSpecPure(baseSpec, forkSpecs, config);
+  if (err.TAG !== "Ok") {
+    return {
+      TAG: "Error",
+      _0: err._0
+    };
+  }
+  let output = err._0;
+  return Stdlib_Result.mapError(Stdlib_Result.map(FileSystem.writeFiles(output.files), filePaths => ({
+    generatedFiles: filePaths,
+    diff: undefined,
+    warnings: output.warnings
+  })), errors => ({
+    TAG: "UnknownError",
+    message: `Failed to write files: ` + errors.join(", "),
+    context: undefined
+  }));
+}
+
+async function compareSpecs(baseSpec, forkSpec, baseNameOpt, forkNameOpt, outputPath) {
+  let baseName = baseNameOpt !== undefined ? baseNameOpt : "base";
+  let forkName = forkNameOpt !== undefined ? forkNameOpt : "fork";
+  let diff = SpecDiffer.generateDiff(baseSpec, forkSpec, OpenAPIParser.getAllEndpoints(baseSpec), OpenAPIParser.getAllEndpoints(forkSpec));
+  Stdlib_Option.forEach(outputPath, path => {
+    FileSystem.writeFile({
+      path: path,
+      content: DiffReportGenerator.generateMarkdownReport(diff, baseName, forkName)
+    });
+  });
+  return diff;
+}
+
+async function generate(config) {
+  let message = await SchemaRefResolver.resolve(config.specPath, undefined);
+  if (message.TAG !== "Ok") {
+    return {
+      TAG: "Error",
+      _0: {
+        TAG: "SpecResolutionError",
+        url: config.specPath,
+        message: message._0
+      }
+    };
+  }
+  let baseSpec = message._0;
+  let forkConfigs = config.forkSpecs;
+  if (forkConfigs === undefined) {
+    return await generateSingleSpec(baseSpec, config);
+  }
+  if (forkConfigs.length === 0) {
+    return await generateSingleSpec(baseSpec, config);
+  }
+  let forkResults = await Promise.all(forkConfigs.map(async f => Stdlib_Result.map(await SchemaRefResolver.resolve(f.specPath, undefined), spec => ({
+    name: f.name,
+    spec: spec
+  }))));
+  let match = forkResults.find(Stdlib_Result.isError);
+  if (match !== undefined && match.TAG !== "Ok") {
+    return {
+      TAG: "Error",
+      _0: {
+        TAG: "SpecResolutionError",
+        url: "",
+        message: match._0
+      }
+    };
+  }
+  return await generateMultiSpec(baseSpec, Stdlib_Array.filterMap(forkResults, res => {
+    if (res.TAG === "Ok") {
+      return res._0;
+    }
+  }), config);
+}
+
+function createDefaultConfig(url, outputDir) {
+  return {
+    specPath: url,
+    forkSpecs: undefined,
+    outputDir: outputDir,
+    strategy: "SharedBase",
+    modulePerTag: true,
+    includeTags: undefined,
+    excludeTags: undefined,
+    generateDiffReport: true,
+    breakingChangeHandling: "Warn",
+    generateDocOverrides: undefined,
+    docOverrideDir: undefined,
+    targets: undefined,
+    dtsOutputDir: undefined,
+    wrapperOutputDir: undefined,
+    baseInstanceName: undefined,
+    baseModulePrefix: undefined
+  };
+}
+
+async function generateFromUrl(url, outputDir, config) {
+  let init = Stdlib_Option.getOr(config, createDefaultConfig(url, outputDir));
+  return await generate({
+    specPath: url,
+    forkSpecs: init.forkSpecs,
+    outputDir: init.outputDir,
+    strategy: init.strategy,
+    modulePerTag: init.modulePerTag,
+    includeTags: init.includeTags,
+    excludeTags: init.excludeTags,
+    generateDiffReport: init.generateDiffReport,
+    breakingChangeHandling: init.breakingChangeHandling,
+    generateDocOverrides: init.generateDocOverrides,
+    docOverrideDir: init.docOverrideDir,
+    targets: init.targets,
+    dtsOutputDir: init.dtsOutputDir,
+    wrapperOutputDir: init.wrapperOutputDir,
+    baseInstanceName: init.baseInstanceName,
+    baseModulePrefix: init.baseModulePrefix
+  });
+}
+
+async function generateFromFile(filePath, outputDir, config) {
+  let init = Stdlib_Option.getOr(config, createDefaultConfig(filePath, outputDir));
+  return await generate({
+    specPath: filePath,
+    forkSpecs: init.forkSpecs,
+    outputDir: init.outputDir,
+    strategy: init.strategy,
+    modulePerTag: init.modulePerTag,
+    includeTags: init.includeTags,
+    excludeTags: init.excludeTags,
+    generateDiffReport: init.generateDiffReport,
+    breakingChangeHandling: init.breakingChangeHandling,
+    generateDocOverrides: init.generateDocOverrides,
+    docOverrideDir: init.docOverrideDir,
+    targets: init.targets,
+    dtsOutputDir: init.dtsOutputDir,
+    wrapperOutputDir: init.wrapperOutputDir,
+    baseInstanceName: init.baseInstanceName,
+    baseModulePrefix: init.baseModulePrefix
+  });
+}
+
+export {
+  generateSingleSpecPure,
+  generateSingleSpec,
+  processForkPure,
+  generateMultiSpecPure,
+  generateMultiSpec,
+  compareSpecs,
+  generate,
+  createDefaultConfig,
+  generateFromUrl,
+  generateFromFile,
+}
+/* FileSystem Not a pure module */

package/lib/es6/src/Types.d.ts

@@ -0,0 +1,286 @@
+import type { t as Config_t } from './types/Config';
+export type jsonSchemaType = "String" | "Number" | "Integer" | "Boolean" | "Object" | "Null" | "Unknown" | {
+    TAG: "Array";
+    _0: jsonSchemaType;
+};
+export type jsonSchema = {
+    readonly type: (undefined | jsonSchemaType);
+    readonly properties: (undefined | {
+        [id: string]: jsonSchema;
+    });
+    readonly items: (undefined | jsonSchema);
+    readonly required: (undefined | string[]);
+    readonly enum: (undefined | unknown[]);
+    readonly "$ref": (undefined | string);
+    readonly allOf: (undefined | jsonSchema[]);
+    readonly oneOf: (undefined | jsonSchema[]);
+    readonly anyOf: (undefined | jsonSchema[]);
+    readonly description: (undefined | string);
+    readonly format: (undefined | string);
+    readonly minLength: (undefined | number);
+    readonly maxLength: (undefined | number);
+    readonly minimum: (undefined | number);
+    readonly maximum: (undefined | number);
+    readonly pattern: (undefined | string);
+    readonly nullable: (undefined | boolean);
+};
+export type httpMethod = "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
+export type mediaType = {
+    readonly schema: (undefined | jsonSchema);
+    readonly example: (undefined | unknown);
+    readonly examples: (undefined | {
+        [id: string]: unknown;
+    });
+};
+export type requestBody = {
+    readonly description: (undefined | string);
+    readonly content: {
+        [id: string]: mediaType;
+    };
+    readonly required: (undefined | boolean);
+};
+export type response = {
+    readonly description: string;
+    readonly content: (undefined | {
+        [id: string]: mediaType;
+    });
+};
+export type parameter = {
+    readonly name: string;
+    readonly in: string;
+    readonly description: (undefined | string);
+    readonly required: (undefined | boolean);
+    readonly schema: (undefined | jsonSchema);
+};
+export type operation = {
+    readonly operationId: (undefined | string);
+    readonly summary: (undefined | string);
+    readonly description: (undefined | string);
+    readonly tags: (undefined | string[]);
+    readonly requestBody: (undefined | requestBody);
+    readonly responses: {
+        [id: string]: response;
+    };
+    readonly parameters: (undefined | parameter[]);
+};
+export type endpoint = {
+    readonly path: string;
+    readonly method: string;
+    readonly operationId: (undefined | string);
+    readonly summary: (undefined | string);
+    readonly description: (undefined | string);
+    readonly tags: (undefined | string[]);
+    readonly requestBody: (undefined | requestBody);
+    readonly responses: {
+        [id: string]: response;
+    };
+    readonly parameters: (undefined | parameter[]);
+};
+export type pathItem = {
+    readonly get: (undefined | operation);
+    readonly post: (undefined | operation);
+    readonly put: (undefined | operation);
+    readonly patch: (undefined | operation);
+    readonly delete: (undefined | operation);
+    readonly head: (undefined | operation);
+    readonly options: (undefined | operation);
+    readonly parameters: (undefined | parameter[]);
+};
+export type components = {
+    readonly schemas: (undefined | {
+        [id: string]: jsonSchema;
+    });
+};
+export type info = {
+    readonly title: string;
+    readonly version: string;
+    readonly description: (undefined | string);
+};
+export type openAPISpec = {
+    readonly openapi: string;
+    readonly info: info;
+    readonly paths: {
+        [id: string]: pathItem;
+    };
+    readonly components: (undefined | components);
+};
+export type generationStrategy = "Separate" | "SharedBase";
+export type breakingChangeHandling = "Error" | "Warn" | "Ignore";
+export type forkSpecConfig = {
+    readonly name: string;
+    readonly specPath: string;
+};
+export type generationTargets = {
+    readonly rescriptApi: boolean;
+    readonly rescriptWrapper: boolean;
+    readonly typescriptDts: boolean;
+    readonly typescriptWrapper: boolean;
+};
+export type generationConfig = Config_t;
+export type forkSpec = {
+    readonly name: string;
+    readonly spec: openAPISpec;
+};
+export type errorContext = {
+    readonly path: string;
+    readonly operation: string;
+    readonly schema: (undefined | unknown);
+};
+export type codegenError = {
+    TAG: "SpecResolutionError";
+    readonly url: string;
+    readonly message: string;
+} | {
+    TAG: "SchemaParseError";
+    readonly context: errorContext;
+    readonly reason: string;
+} | {
+    TAG: "ReferenceError";
+    readonly ref: string;
+    readonly context: errorContext;
+} | {
+    TAG: "ValidationError";
+    readonly schema: string;
+    readonly input: unknown;
+    readonly issues: string[];
+} | {
+    TAG: "CircularSchemaError";
+    readonly ref: string;
+    readonly depth: number;
+    readonly path: string;
+} | {
+    TAG: "FileWriteError";
+    readonly filePath: string;
+    readonly message: string;
+} | {
+    TAG: "InvalidConfigError";
+    readonly field: string;
+    readonly message: string;
+} | {
+    TAG: "UnknownError";
+    readonly message: string;
+    readonly context: (undefined | errorContext);
+};
+export type warning = {
+    TAG: "FallbackToJson";
+    readonly reason: string;
+    readonly context: errorContext;
+} | {
+    TAG: "UnsupportedFeature";
+    readonly feature: string;
+    readonly fallback: string;
+    readonly location: string;
+} | {
+    TAG: "DepthLimitReached";
+    readonly depth: number;
+    readonly path: string;
+} | {
+    TAG: "MissingSchema";
+    readonly ref: string;
+    readonly location: string;
+} | {
+    TAG: "IntersectionNotFullySupported";
+    readonly location: string;
+    readonly note: string;
+} | {
+    TAG: "ComplexUnionSimplified";
+    readonly location: string;
+    readonly types: string;
+};
+export type endpointDiff = {
+    readonly path: string;
+    readonly method: string;
+    readonly requestBodyChanged: boolean;
+    readonly responseChanged: boolean;
+    readonly breakingChange: boolean;
+};
+export type schemaDiff = {
+    readonly name: string;
+    readonly breakingChange: boolean;
+};
+export type specDiff = {
+    readonly addedEndpoints: endpoint[];
+    readonly removedEndpoints: endpoint[];
+    readonly modifiedEndpoints: endpointDiff[];
+    readonly addedSchemas: string[];
+    readonly removedSchemas: string[];
+    readonly modifiedSchemas: schemaDiff[];
+};
+export type generationSuccess = {
+    readonly generatedFiles: string[];
+    readonly diff: (undefined | specDiff);
+    readonly warnings: warning[];
+};
+export type generationResult = {
+    TAG: "Ok";
+    _0: generationSuccess;
+} | {
+    TAG: "Error";
+    _0: codegenError;
+};
+export type CodegenError_context = {
+    readonly path: string;
+    readonly operation: string;
+    readonly schema: (undefined | unknown);
+};
+export type CodegenError_t = {
+    TAG: "SpecResolutionError";
+    readonly url: string;
+    readonly message: string;
+} | {
+    TAG: "SchemaParseError";
+    readonly context: CodegenError_context;
+    readonly reason: string;
+} | {
+    TAG: "ReferenceError";
+    readonly ref: string;
+    readonly context: CodegenError_context;
+} | {
+    TAG: "ValidationError";
+    readonly schema: string;
+    readonly input: unknown;
+    readonly issues: string[];
+} | {
+    TAG: "CircularSchemaError";
+    readonly ref: string;
+    readonly depth: number;
+    readonly path: string;
+} | {
+    TAG: "FileWriteError";
+    readonly filePath: string;
+    readonly message: string;
+} | {
+    TAG: "InvalidConfigError";
+    readonly field: string;
+    readonly message: string;
+} | {
+    TAG: "UnknownError";
+    readonly message: string;
+    readonly context: (undefined | CodegenError_context);
+};
+export type Warning_t = {
+    TAG: "FallbackToJson";
+    readonly reason: string;
+    readonly context: CodegenError_context;
+} | {
+    TAG: "UnsupportedFeature";
+    readonly feature: string;
+    readonly fallback: string;
+    readonly location: string;
+} | {
+    TAG: "DepthLimitReached";
+    readonly depth: number;
+    readonly path: string;
+} | {
+    TAG: "MissingSchema";
+    readonly ref: string;
+    readonly location: string;
+} | {
+    TAG: "IntersectionNotFullySupported";
+    readonly location: string;
+    readonly note: string;
+} | {
+    TAG: "ComplexUnionSimplified";
+    readonly location: string;
+    readonly types: string;
+};