@cparra/apexdocs 3.0.0-alpha.9 → 3.0.0-beta.1

package/dist/cli/generate.js

@@ -5,6 +5,7 @@ var _function = require('fp-ts/function');
 var TE = require('fp-ts/TaskEither');
 var yaml = require('js-yaml');
 var path = require('path');
+var E = require('fp-ts/Either');
 var T = require('fp-ts/Task');
 var A = require('fp-ts/lib/Array');
 var apexReflection = require('@cparra/apex-reflection');
@@ -13,6 +14,7 @@ var fastXmlParser = require('fast-xml-parser');
 var Handlebars = require('handlebars');
 var defaults = require('../defaults-DGKfeZq-.js');
 var fs = require('fs');
+var TE$1 = require('fp-ts/lib/TaskEither');
 var chalk = require('chalk');
 var cosmiconfig = require('cosmiconfig');
 var yargs = require('yargs');
@@ -38,10 +40,12 @@ function _interopNamespaceDefault(e) {
 var TE__namespace = /*#__PURE__*/_interopNamespaceDefault(TE);
 var yaml__namespace = /*#__PURE__*/_interopNamespaceDefault(yaml);
 var path__namespace = /*#__PURE__*/_interopNamespaceDefault(path);
+var E__namespace = /*#__PURE__*/_interopNamespaceDefault(E);
 var T__namespace = /*#__PURE__*/_interopNamespaceDefault(T);
 var A__namespace = /*#__PURE__*/_interopNamespaceDefault(A);
 var O__namespace = /*#__PURE__*/_interopNamespaceDefault(O);
 var fs__namespace = /*#__PURE__*/_interopNamespaceDefault(fs);
+var TE__namespace$1 = /*#__PURE__*/_interopNamespaceDefault(TE$1);
 var yargs__namespace = /*#__PURE__*/_interopNamespaceDefault(yargs);
 
 function apply(fn, ...front) {
@@ -663,12 +667,16 @@ function getTypeGroup$1(type, config) {
 }
 
 function parseApexMetadata(input) {
-  var _a;
+  return _function.pipe(input, parse, E__namespace.map(toMap));
+}
+function parse(input) {
+  return E__namespace.tryCatch(() => new fastXmlParser.XMLParser().parse(input), E__namespace.toError);
+}
+function toMap(metadata) {
   const map = /* @__PURE__ */ new Map();
-  const xml = new fastXmlParser.XMLParser().parse(input);
-  map.set("apiVersion", (_a = xml.ApexClass.apiVersion) != null ? _a : "");
-  if (xml.ApexClass.status) {
-    map.set("status", xml.ApexClass.status);
+  map.set("apiVersion", String(metadata.ApexClass.apiVersion));
+  if (metadata.ApexClass.status) {
+    map.set("status", String(metadata.ApexClass.status));
   }
   return map;
 }
@@ -692,7 +700,7 @@ var __spreadValues$d = (a, b) => {
   return a;
 };
 var __spreadProps$d = (a, b) => __defProps$d(a, __getOwnPropDescs$d(b));
-var __async$5 = (__this, __arguments, generator) => {
+var __async$6 = (__this, __arguments, generator) => {
   return new Promise((resolve, reject) => {
     var fulfilled = (value) => {
       try {
@@ -725,7 +733,7 @@ class ReflectionError {
   }
 }
 function reflectAsync(rawSource) {
-  return __async$5(this, null, function* () {
+  return __async$6(this, null, function* () {
     return new Promise((resolve, reject) => {
       const result = apexReflection.reflect(rawSource);
       if (result.typeMirror) {
@@ -738,17 +746,17 @@ function reflectAsync(rawSource) {
     });
   });
 }
-function myPipeSeq(apexBundles) {
+function reflectBundles(apexBundles) {
   const semiGroupReflectionError = {
     concat: (x, y) => new ReflectionErrors([...x.errors, ...y.errors])
   };
   const Ap = TE__namespace.getApplicativeTaskValidation(T__namespace.ApplyPar, semiGroupReflectionError);
-  return _function.pipe(apexBundles, A__namespace.traverse(Ap)(myPipe));
+  return _function.pipe(apexBundles, A__namespace.traverse(Ap)(reflectBundle));
 }
-function myPipe(apexBundle) {
+function reflectBundle(apexBundle) {
   const convertToParsedFile = apply(toParsedFile, apexBundle.filePath);
   const withMetadata = apply(addMetadata, apexBundle.metadataContent);
-  return _function.pipe(apexBundle, reflectAsTask, TE__namespace.map(convertToParsedFile), TE__namespace.map(withMetadata));
+  return _function.pipe(apexBundle, reflectAsTask, TE__namespace.map(convertToParsedFile), TE__namespace.flatMap(withMetadata));
 }
 function reflectAsTask(apexBundle) {
   return TE__namespace.tryCatch(
@@ -767,28 +775,45 @@ function toParsedFile(filePath, typeMirror) {
   };
 }
 function addMetadata(rawMetadataContent, parsedFile) {
-  return __spreadProps$d(__spreadValues$d({}, parsedFile), {
-    type: addFileMetadataToTypeAnnotation(parsedFile.type, rawMetadataContent)
-  });
+  return TE__namespace.fromEither(
+    _function.pipe(
+      parsedFile.type,
+      (type) => addFileMetadataToTypeAnnotation(type, rawMetadataContent),
+      E__namespace.map((type) => __spreadProps$d(__spreadValues$d({}, parsedFile), { type })),
+      E__namespace.mapLeft((error) => errorToReflectionErrors(error, parsedFile.source.filePath))
+    )
+  );
+}
+function errorToReflectionErrors(error, filePath) {
+  return new ReflectionErrors([new ReflectionError(filePath, error.message)]);
 }
 function addFileMetadataToTypeAnnotation(type, metadata) {
+  const concatAnnotationToType = apply(concatAnnotations, type);
   return _function.pipe(
     O__namespace.fromNullable(metadata),
-    O__namespace.map((metadata2) => {
-      const metadataParams = parseApexMetadata(metadata2);
-      metadataParams.forEach((value, key) => {
-        const declaration = `${key}: ${value}`;
-        type.annotations.push({
-          rawDeclaration: declaration,
-          name: declaration,
-          type: declaration
-        });
-      });
-      return type;
-    }),
-    O__namespace.getOrElse(() => type)
+    O__namespace.map(concatAnnotationToType),
+    O__namespace.getOrElse(() => E__namespace.right(type))
   );
 }
+function concatAnnotations(type, metadataInput) {
+  return _function.pipe(
+    metadataInput,
+    parseApexMetadata,
+    E__namespace.map((metadataMap) => __spreadProps$d(__spreadValues$d({}, type), {
+      annotations: [...type.annotations, ...mapToAnnotations(metadataMap)]
+    }))
+  );
+}
+function mapToAnnotations(metadata) {
+  return Array.from(metadata.entries()).map(([key, value]) => {
+    const declaration = `${key}: ${value}`;
+    return {
+      name: declaration,
+      type: declaration,
+      rawDeclaration: declaration
+    };
+  });
+}
 
 function createInheritanceChain(repository, classMirror) {
   return _function.pipe(
@@ -1578,7 +1603,7 @@ var __spreadValues$7 = (a, b) => {
   return a;
 };
 var __spreadProps$7 = (a, b) => __defProps$7(a, __getOwnPropDescs$7(b));
-var __async$4 = (__this, __arguments, generator) => {
+var __async$5 = (__this, __arguments, generator) => {
   return new Promise((resolve, reject) => {
     var fulfilled = (value) => {
       try {
@@ -1612,8 +1637,7 @@ function generateDocs(apexBundles, config) {
   const sortTypeMembers = apply(sortMembers, config.sortMembersAlphabetically);
   return _function.pipe(
     apexBundles,
-    myPipeSeq,
-    //checkForReflectionErrors,
+    reflectBundles,
     TE__namespace.map(filterOutOfScope),
     TE__namespace.map(addInheritedMembersToTypes),
     TE__namespace.map(addInheritanceChainToTypes),
@@ -1629,7 +1653,7 @@ function generateDocs(apexBundles, config) {
 }
 function transformReferenceHook(config) {
   function _execute(references, parsedFiles, transformReference) {
-    return __async$4(this, null, function* () {
+    return __async$5(this, null, function* () {
       return {
         references: yield execTransformReferenceHook(Object.values(references), transformReference),
         parsedFiles
@@ -1650,8 +1674,8 @@ function transformDocumentationBundleHook(config) {
 function passThroughHook(value) {
   return value;
 }
-const execTransformReferenceHook = (_0, ..._1) => __async$4(void 0, [_0, ..._1], function* (references, hook = passThroughHook) {
-  const hooked = references.map((reference) => __async$4(void 0, null, function* () {
+const execTransformReferenceHook = (_0, ..._1) => __async$5(void 0, [_0, ..._1], function* (references, hook = passThroughHook) {
+  const hooked = references.map((reference) => __async$5(void 0, null, function* () {
     const hookedResult = yield hook(reference);
     return __spreadValues$7(__spreadValues$7({}, reference), hookedResult);
   }));
@@ -1661,24 +1685,24 @@ const execTransformReferenceHook = (_0, ..._1) => __async$4(void 0, [_0, ..._1],
     return acc;
   }, {});
 });
-const documentationBundleHook = (bundle, config) => __async$4(void 0, null, function* () {
+const documentationBundleHook = (bundle, config) => __async$5(void 0, null, function* () {
   return {
     referenceGuide: yield transformReferenceGuide(bundle.referenceGuide, config.transformReferenceGuide),
     docs: yield transformDocs(bundle.docs, config.transformDocs, config.transformDocPage)
   };
 });
-const transformReferenceGuide = (_0, ..._1) => __async$4(void 0, [_0, ..._1], function* (referenceGuide, hook = passThroughHook) {
+const transformReferenceGuide = (_0, ..._1) => __async$5(void 0, [_0, ..._1], function* (referenceGuide, hook = passThroughHook) {
   const result = yield hook(referenceGuide);
   if (isSkip(result)) {
     return result;
   }
   return __spreadValues$7(__spreadValues$7({}, referenceGuide), yield hook(referenceGuide));
 });
-const transformDocs = (_0, ..._1) => __async$4(void 0, [_0, ..._1], function* (docs, transformDocsHook = passThroughHook, transformDocPageHook = passThroughHook) {
+const transformDocs = (_0, ..._1) => __async$5(void 0, [_0, ..._1], function* (docs, transformDocsHook = passThroughHook, transformDocPageHook = passThroughHook) {
   const transformed = yield transformDocsHook(docs);
   return Promise.all(transformed.map((doc) => transformDocPage(doc, transformDocPageHook)));
 });
-const transformDocPage = (_0, ..._1) => __async$4(void 0, [_0, ..._1], function* (doc, hook = passThroughHook) {
+const transformDocPage = (_0, ..._1) => __async$5(void 0, [_0, ..._1], function* (doc, hook = passThroughHook) {
   return __spreadValues$7(__spreadValues$7({}, doc), yield hook(doc));
 });
 function postHookCompile(bundle) {
@@ -1716,6 +1740,21 @@ ${yamlString}---
 `;
 }
 
+const referenceGuideTemplate = `
+# Apex Reference Guide
+
+{{#each this}}
+## {{@key}}
+
+{{#each this}}
+### {{link title}}
+
+{{{renderContent description}}}
+
+{{/each}}
+{{/each}}
+`.trim();
+
 var __defProp$6 = Object.defineProperty;
 var __defProps$6 = Object.defineProperties;
 var __getOwnPropDescs$6 = Object.getOwnPropertyDescriptors;
@@ -1735,73 +1774,30 @@ var __spreadValues$6 = (a, b) => {
   return a;
 };
 var __spreadProps$6 = (a, b) => __defProps$6(a, __getOwnPropDescs$6(b));
-class FileWriter {
-  static write(files, outputDir, onWriteCallback) {
-    files.forEach((file) => {
-      const { outputDocPath, content } = this.getTargetLocation(file, outputDir);
-      fs__namespace.mkdirSync(path__namespace.dirname(outputDocPath), { recursive: true });
-      fs__namespace.writeFileSync(outputDocPath, content, "utf8");
-      onWriteCallback == null ? void 0 : onWriteCallback(file);
-    });
-  }
-  static getTargetLocation(file, outputDir) {
-    return __spreadProps$6(__spreadValues$6({}, file), {
-      outputDocPath: path__namespace.join(outputDir, file.outputDocPath)
-    });
-  }
+const mkdir = TE__namespace$1.taskify(fs__namespace.mkdir);
+const writeFile = TE__namespace$1.taskify(fs__namespace.writeFile);
+function writeFiles(files, outputDir, onWriteCallback) {
+  return _function.pipe(
+    files,
+    TE__namespace$1.traverseArray((file) => writeSingle(file, outputDir, onWriteCallback))
+  );
 }
-
-class Logger {
-  /**
-   * Logs a message with optional arguments.
-   * @param message The message to log.
-   * @param args Optional arguments.
-   */
-  static log(message, ...args) {
-    this.logSingle(message);
-    args.forEach((arg) => {
-      this.logSingle(arg);
-    });
-  }
-  /**
-   * Logs an error message with optional arguments.
-   * @param message The error message to log.
-   * @param args Optional arguments.
-   */
-  static error(message, ...args) {
-    this.logSingle(message, "red");
-    args.forEach(() => {
-      this.logSingle(message, "red");
-    });
-  }
-  static logSingle(text, color = "green") {
-    if (this.currentFrame > 9) {
-      this.currentFrame = 0;
-    }
-    const logMessage = `${this.getChalkFn(color)((/* @__PURE__ */ new Date()).toLocaleString() + ": ")}${text}
-`;
-    process.stdout.write(logMessage);
-  }
-  static getChalkFn(color) {
-    return color === "green" ? chalk.green : chalk.red;
-  }
+function writeSingle(file, outputDir, onWriteCallback) {
+  const ensureDirectoryExists = ({ outputDocPath }) => mkdir(path__namespace.dirname(outputDocPath), { recursive: true });
+  const writeContents = (file2) => writeFile(file2.outputDocPath, file2.content, "utf8");
+  return _function.pipe(
+    resolveTargetLocation(file, outputDir),
+    (file2) => TE__namespace$1.right(file2),
+    TE__namespace$1.tapIO(ensureDirectoryExists),
+    TE__namespace$1.flatMap(writeContents),
+    TE__namespace$1.map(() => onWriteCallback == null ? void 0 : onWriteCallback(file))
+  );
+}
+function resolveTargetLocation(file, outputDir) {
+  return __spreadProps$6(__spreadValues$6({}, file), {
+    outputDocPath: path__namespace.join(outputDir, file.outputDocPath)
+  });
 }
-Logger.currentFrame = 0;
-
-const referenceGuideTemplate = `
-# Apex Reference Guide
-
-{{#each this}}
-## {{@key}}
-
-{{#each this}}
-### {{link title}}
-
-{{{renderContent description}}}
-
-{{/each}}
-{{/each}}
-`.trim();
 
 var __defProp$5 = Object.defineProperty;
 var __defProps$5 = Object.defineProperties;
@@ -1832,25 +1828,8 @@ class FileWritingError {
 function generate(bundles, config) {
   return _function.pipe(
     generateDocumentationBundle(bundles, config),
-    TE__namespace.flatMap((files) => writeFilesToSystem(files, config.targetDir)),
-    TE__namespace.mapLeft((error) => {
-      if (error._tag === "HookError") {
-        Logger.error("Error(s) occurred while processing hooks. Please review the following issues:");
-        Logger.error(error.error);
-        return;
-      }
-      if (error._tag === "FileWritingError") {
-        Logger.error(error.message);
-        Logger.error(error.error);
-        return;
-      }
-      const errorMessages = [
-        "Error(s) occurred while parsing files. Please review the following issues:",
-        ...error.errors.map(formatReflectionError)
-      ].join("\n");
-      Logger.error(errorMessages);
-    })
-  )();
+    TE__namespace.flatMap((files) => writeFilesToSystem(files, config.targetDir))
+  );
 }
 function generateDocumentationBundle(bundles, config) {
   return generateDocs(bundles, __spreadProps$5(__spreadValues$5({}, config), {
@@ -1858,26 +1837,56 @@ function generateDocumentationBundle(bundles, config) {
   }));
 }
 function writeFilesToSystem(files, outputDir) {
-  try {
-    FileWriter.write(
-      [files.referenceGuide, ...files.docs].filter((file) => !isSkip(file)),
-      outputDir
-    );
-    return TE__namespace.right(void 0);
-  } catch (error) {
-    return TE__namespace.left(new FileWritingError("An error occurred while writing files to the system.", error));
-  }
-}
-function formatReflectionError(error) {
-  return `Source file: ${error.file}
-${error.message}
-`;
+  return _function.pipe(
+    [files.referenceGuide, ...files.docs].filter((file) => !isSkip(file)),
+    (files2) => writeFiles(files2, outputDir),
+    TE__namespace.mapLeft((error) => {
+      return new FileWritingError("An error occurred while writing files to the system.", error);
+    })
+  );
 }
 
 function createManifest(typeParser, reflect) {
   return new Manifest(typeParser.parse(reflect));
 }
 
+class Logger {
+  /**
+   * Logs a message with optional arguments.
+   * @param message The message to log.
+   * @param args Optional arguments.
+   */
+  static log(message, ...args) {
+    this.logSingle(message);
+    args.forEach((arg) => {
+      this.logSingle(arg);
+    });
+  }
+  /**
+   * Logs an error message with optional arguments.
+   * @param message The error message to log.
+   * @param args Optional arguments.
+   */
+  static error(message, ...args) {
+    this.logSingle(message, "red");
+    args.forEach(() => {
+      this.logSingle(message, "red");
+    });
+  }
+  static logSingle(text, color = "green") {
+    if (this.currentFrame > 9) {
+      this.currentFrame = 0;
+    }
+    const logMessage = `${this.getChalkFn(color)((/* @__PURE__ */ new Date()).toLocaleString() + ": ")}${text}
+`;
+    process.stdout.write(logMessage);
+  }
+  static getChalkFn(color) {
+    return color === "green" ? chalk.green : chalk.red;
+  }
+}
+Logger.currentFrame = 0;
+
 var __defProp$4 = Object.defineProperty;
 var __defProps$4 = Object.defineProperties;
 var __getOwnPropDescs$4 = Object.getOwnPropertyDescriptors;
@@ -1904,20 +1913,7 @@ class RawBodyParser {
   parse(reflect) {
     const types = this.typeBundles.map((currentBundle) => {
       Logger.log(`Parsing file: ${currentBundle.filePath}`);
-      const result = reflect(currentBundle);
-      if (!!result.typeMirror && !!currentBundle.metadataContent) {
-        const metadataParams = parseApexMetadata(currentBundle.metadataContent);
-        metadataParams.forEach((value, key) => {
-          var _a;
-          const declaration = `${key}: ${value}`;
-          (_a = result.typeMirror) == null ? void 0 : _a.annotations.push({
-            rawDeclaration: declaration,
-            name: declaration,
-            type: declaration
-          });
-        });
-      }
-      return result;
+      return reflect(currentBundle);
     }).filter((reflectionResult) => {
       return reflectionResult.typeMirror;
     }).map((reflectionResult) => reflectionResult.typeMirror);
@@ -2055,39 +2051,6 @@ class TypesRepository {
   }
 }
 
-class Settings {
-  constructor(config) {
-    this.config = config;
-  }
-  static build(config) {
-    Settings.instance = new Settings(config);
-  }
-  static getInstance() {
-    if (!Settings.instance) {
-      throw new Error("Settings has not been initialized");
-    }
-    return Settings.instance;
-  }
-  get scope() {
-    return this.config.scope;
-  }
-  get targetGenerator() {
-    return this.config.targetGenerator;
-  }
-  get indexOnly() {
-    return this.config.indexOnly;
-  }
-  getOpenApiTitle() {
-    return this.config.openApiTitle;
-  }
-  getNamespace() {
-    return this.config.namespace;
-  }
-  openApiFileName() {
-    return this.config.openApiFileName;
-  }
-}
-
 class Transpiler {
   static generate(types, processor) {
     var _a;
@@ -2096,9 +2059,6 @@ class Transpiler {
       if (apexTypeA.name > apexTypeB.name) return 1;
       return 0;
     });
-    if (Settings.getInstance().indexOnly) {
-      return;
-    }
     sortedTypes.forEach((currentType) => {
       processor.onProcess(currentType);
     });
@@ -2234,6 +2194,33 @@ class OpenApi {
   }
 }
 
+class OpenApiSettings {
+  constructor(config) {
+    this.config = config;
+  }
+  static build(config) {
+    OpenApiSettings.instance = new OpenApiSettings(config);
+  }
+  static getInstance() {
+    if (!OpenApiSettings.instance) {
+      throw new Error("Settings has not been initialized");
+    }
+    return OpenApiSettings.instance;
+  }
+  getOpenApiTitle() {
+    return this.config.openApiTitle;
+  }
+  getNamespace() {
+    return this.config.namespace;
+  }
+  openApiFileName() {
+    return this.config.openApiFileName;
+  }
+  getVersion() {
+    return this.config.version;
+  }
+}
+
 class ClassMirrorWrapper {
   constructor(classMirror) {
     this.classMirror = classMirror;
@@ -2749,7 +2736,7 @@ var __spreadProps$1 = (a, b) => __defProps$1(a, __getOwnPropDescs$1(b));
 function createOpenApiFile(fileName, openApiModel) {
   const content = JSON.stringify(__spreadProps$1(__spreadValues$1({}, openApiModel), { namespace: void 0 }), null, 2);
   return {
-    outputDocPath: "",
+    outputDocPath: `${fileName}.json`,
     content,
     frontmatter: null,
     group: null
@@ -2759,15 +2746,19 @@ function createOpenApiFile(fileName, openApiModel) {
 class OpenApiDocsProcessor {
   constructor() {
     this.onAfterProcess = () => {
-      const page = createOpenApiFile(Settings.getInstance().openApiFileName(), this.openApiModel);
+      const page = createOpenApiFile(OpenApiSettings.getInstance().openApiFileName(), this.openApiModel);
       this._fileContainer.pushFile(page);
     };
     this._fileContainer = new FileContainer();
-    const title = Settings.getInstance().getOpenApiTitle();
+    const title = OpenApiSettings.getInstance().getOpenApiTitle();
     if (!title) {
       throw Error("No OpenApi title was provided.");
     }
-    this.openApiModel = new OpenApi(title, "1.0.0", Settings.getInstance().getNamespace());
+    this.openApiModel = new OpenApi(
+      title,
+      OpenApiSettings.getInstance().getVersion(),
+      OpenApiSettings.getInstance().getNamespace()
+    );
   }
   fileBuilder() {
     return this._fileContainer;
@@ -2814,17 +2805,51 @@ class OpenApiDocsProcessor {
   }
 }
 
+var __async$4 = (__this, __arguments, generator) => {
+  return new Promise((resolve, reject) => {
+    var fulfilled = (value) => {
+      try {
+        step(generator.next(value));
+      } catch (e) {
+        reject(e);
+      }
+    };
+    var rejected = (value) => {
+      try {
+        step(generator.throw(value));
+      } catch (e) {
+        reject(e);
+      }
+    };
+    var step = (x) => x.done ? resolve(x.value) : Promise.resolve(x.value).then(fulfilled, rejected);
+    step((generator = generator.apply(__this, __arguments)).next());
+  });
+};
 function openApi(fileBodies, config) {
-  const manifest = createManifest(new RawBodyParser(fileBodies), reflectionWithLogger);
-  TypesRepository.getInstance().populateAll(manifest.types);
-  const filteredTypes = filterByScopes(manifest);
-  const processor = new OpenApiDocsProcessor();
-  Transpiler.generate(filteredTypes, processor);
-  const generatedFiles = processor.fileBuilder().files();
-  FileWriter.write(generatedFiles, config.targetDir, (file) => {
-    Logger.logSingle(`${file.outputDocPath} processed.`, "green");
+  return __async$4(this, null, function* () {
+    OpenApiSettings.build({
+      sourceDirectory: config.sourceDir,
+      outputDir: config.targetDir,
+      openApiFileName: config.fileName,
+      openApiTitle: config.title,
+      namespace: config.namespace,
+      version: config.apiVersion
+    });
+    const manifest = createManifest(new RawBodyParser(fileBodies), reflectionWithLogger);
+    TypesRepository.getInstance().populateAll(manifest.types);
+    const filteredTypes = filterByScopes(manifest);
+    const processor = new OpenApiDocsProcessor();
+    Transpiler.generate(filteredTypes, processor);
+    const generatedFiles = processor.fileBuilder().files();
+    yield _function.pipe(
+      writeFiles(generatedFiles, config.targetDir, (file) => {
+        Logger.logSingle(`${file.outputDocPath} processed.`, "green");
+      }),
+      TE__namespace.map(() => Logger.logSingle("\u2714\uFE0F Documentation generated successfully!")),
+      TE__namespace.mapError((error) => Logger.error(error))
+    )();
+    ErrorLogger.logErrors(filteredTypes);
   });
-  ErrorLogger.logErrors(filteredTypes);
 }
 function reflectionWithLogger(apexBundle) {
   var _a;
@@ -3017,23 +3042,50 @@ class Apexdocs {
         const fileBodies = yield ApexFileReader.processFiles(
           new DefaultFileSystem(),
           config.sourceDir,
-          config.includeMetadata
+          config.targetGenerator === "markdown" ? config.includeMetadata : false
         );
         switch (config.targetGenerator) {
           case "markdown":
-            yield generate(fileBodies, config);
+            yield generateMarkdownDocumentation(fileBodies, config)();
             break;
           case "openapi":
-            openApi(fileBodies, config);
+            yield openApi(fileBodies, config);
             break;
         }
-        Logger.logSingle("\u2714\uFE0F Documentation generated successfully!");
       } catch (error) {
-        Logger.logSingle("\u274C An error occurred while generating the documentation.", "red");
+        Logger.logSingle(`\u274C An error occurred while generating the documentation: ${error}`, "red");
       }
     });
   }
 }
+function generateMarkdownDocumentation(fileBodies, config) {
+  return _function.pipe(
+    generate(fileBodies, config),
+    TE__namespace.map(() => Logger.logSingle("\u2714\uFE0F Documentation generated successfully!")),
+    TE__namespace.mapLeft((error) => {
+      if (error._tag === "HookError") {
+        Logger.error("Error(s) occurred while processing hooks. Please review the following issues:");
+        Logger.error(error.error);
+        return;
+      }
+      if (error._tag === "FileWritingError") {
+        Logger.error(error.message);
+        Logger.error(error.error);
+        return;
+      }
+      const errorMessages = [
+        "Error(s) occurred while parsing files. Please review the following issues:",
+        ...error.errors.map(formatReflectionError)
+      ].join("\n");
+      Logger.error(errorMessages);
+    })
+  );
+}
+function formatReflectionError(error) {
+  return `Source file: ${error.file}
+${error.message}
+`;
+}
 
 const markdownOptions = {
   sourceDir: {
@@ -3082,6 +3134,40 @@ const markdownOptions = {
   }
 };
 
+const openApiOptions = {
+  sourceDir: {
+    type: "string",
+    alias: "s",
+    demandOption: true,
+    describe: "The directory location which contains your apex .cls classes."
+  },
+  targetDir: {
+    type: "string",
+    alias: "t",
+    default: defaults.defaults.targetDir,
+    describe: "The directory location where the OpenApi file will be generated."
+  },
+  fileName: {
+    type: "string",
+    default: "openapi",
+    describe: "The name of the OpenApi file to be generated."
+  },
+  namespace: {
+    type: "string",
+    describe: "The package namespace, if any. This will be added to the API file Server Url."
+  },
+  title: {
+    type: "string",
+    default: "Apex REST API",
+    describe: "The title of the OpenApi file."
+  },
+  apiVersion: {
+    type: "string",
+    default: "1.0.0",
+    describe: "The version of the OpenApi file."
+  }
+};
+
 var __defProp = Object.defineProperty;
 var __defProps = Object.defineProperties;
 var __getOwnPropDescs = Object.getOwnPropertyDescriptors;
@@ -3133,7 +3219,11 @@ function _extractYargs(config) {
     "markdown",
     "Generate documentation from Apex classes as a Markdown site.",
     (yargs2) => yargs2.options(markdownOptions)
-  ).command("openapi", "Generate an OpenApi REST specification from Apex classes.").demandCommand().parseSync();
+  ).command(
+    "openapi",
+    "Generate an OpenApi REST specification from Apex classes.",
+    () => yargs__namespace.options(openApiOptions)
+  ).demandCommand().parseSync();
 }
 function extractArgs() {
   return __async(this, null, function* () {