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

package/dist/cli/generate.js

@@ -2,16 +2,19 @@
 'use strict';
 
 var _function = require('fp-ts/function');
-var E = require('fp-ts/Either');
 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');
 var O = require('fp-ts/Option');
 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');
@@ -34,12 +37,15 @@ function _interopNamespaceDefault(e) {
   return Object.freeze(n);
 }
 
-var E__namespace = /*#__PURE__*/_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) {
@@ -145,25 +151,25 @@ function isInlineCode(content) {
   return Object.keys(content).includes("__type") && content.__type === "inline-code";
 }
 
-var __defProp$f = Object.defineProperty;
-var __defProps$f = Object.defineProperties;
-var __getOwnPropDescs$f = Object.getOwnPropertyDescriptors;
-var __getOwnPropSymbols$f = Object.getOwnPropertySymbols;
-var __hasOwnProp$f = Object.prototype.hasOwnProperty;
-var __propIsEnum$f = Object.prototype.propertyIsEnumerable;
-var __defNormalProp$f = (obj, key, value) => key in obj ? __defProp$f(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
-var __spreadValues$f = (a, b) => {
+var __defProp$g = Object.defineProperty;
+var __defProps$g = Object.defineProperties;
+var __getOwnPropDescs$g = Object.getOwnPropertyDescriptors;
+var __getOwnPropSymbols$g = Object.getOwnPropertySymbols;
+var __hasOwnProp$g = Object.prototype.hasOwnProperty;
+var __propIsEnum$g = Object.prototype.propertyIsEnumerable;
+var __defNormalProp$g = (obj, key, value) => key in obj ? __defProp$g(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __spreadValues$g = (a, b) => {
   for (var prop in b || (b = {}))
-    if (__hasOwnProp$f.call(b, prop))
-      __defNormalProp$f(a, prop, b[prop]);
-  if (__getOwnPropSymbols$f)
-    for (var prop of __getOwnPropSymbols$f(b)) {
-      if (__propIsEnum$f.call(b, prop))
-        __defNormalProp$f(a, prop, b[prop]);
+    if (__hasOwnProp$g.call(b, prop))
+      __defNormalProp$g(a, prop, b[prop]);
+  if (__getOwnPropSymbols$g)
+    for (var prop of __getOwnPropSymbols$g(b)) {
+      if (__propIsEnum$g.call(b, prop))
+        __defNormalProp$g(a, prop, b[prop]);
     }
   return a;
 };
-var __spreadProps$f = (a, b) => __defProps$f(a, __getOwnPropDescs$f(b));
+var __spreadProps$g = (a, b) => __defProps$g(a, __getOwnPropDescs$g(b));
 function adaptDescribable(describable, linkGenerator) {
   return {
     description: describableToRenderableContent(describable, linkGenerator)
@@ -215,7 +221,7 @@ function adaptDocumentable(documentable, linkGenerator, subHeadingLevel) {
   function extractCustomTags(type) {
     var _a2, _b2;
     const baseTags = ["description", "group", "author", "date", "see", "example", "throws", "exception"];
-    return (_b2 = (_a2 = type.docComment) == null ? void 0 : _a2.annotations.filter((currentAnnotation) => !baseTags.includes(currentAnnotation.name.toLowerCase())).map((currentAnnotation) => __spreadProps$f(__spreadValues$f({}, adaptDescribable(currentAnnotation.bodyLines, linkGenerator)), {
+    return (_b2 = (_a2 = type.docComment) == null ? void 0 : _a2.annotations.filter((currentAnnotation) => !baseTags.includes(currentAnnotation.name.toLowerCase())).map((currentAnnotation) => __spreadProps$g(__spreadValues$g({}, adaptDescribable(currentAnnotation.bodyLines, linkGenerator)), {
       name: currentAnnotation.name
     }))) != null ? _b2 : [];
   }
@@ -229,7 +235,7 @@ function adaptDocumentable(documentable, linkGenerator, subHeadingLevel) {
     var _a2, _b2;
     return (_b2 = (_a2 = type.docComment) == null ? void 0 : _a2.annotations.filter((currentAnnotation) => currentAnnotation.name.toLowerCase() === "see").map((currentAnnotation) => currentAnnotation.body)) != null ? _b2 : [];
   }
-  return __spreadProps$f(__spreadValues$f({}, adaptDescribable((_a = documentable.docComment) == null ? void 0 : _a.descriptionLines, linkGenerator)), {
+  return __spreadProps$g(__spreadValues$g({}, adaptDescribable((_a = documentable.docComment) == null ? void 0 : _a.descriptionLines, linkGenerator)), {
     annotations: documentable.annotations.map((annotation) => annotation.type.toUpperCase()),
     customTags: extractCustomTags(documentable),
     example: {
@@ -244,25 +250,25 @@ function adaptDocumentable(documentable, linkGenerator, subHeadingLevel) {
   });
 }
 
-var __defProp$e = Object.defineProperty;
-var __defProps$e = Object.defineProperties;
-var __getOwnPropDescs$e = Object.getOwnPropertyDescriptors;
-var __getOwnPropSymbols$e = Object.getOwnPropertySymbols;
-var __hasOwnProp$e = Object.prototype.hasOwnProperty;
-var __propIsEnum$e = Object.prototype.propertyIsEnumerable;
-var __defNormalProp$e = (obj, key, value) => key in obj ? __defProp$e(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
-var __spreadValues$e = (a, b) => {
+var __defProp$f = Object.defineProperty;
+var __defProps$f = Object.defineProperties;
+var __getOwnPropDescs$f = Object.getOwnPropertyDescriptors;
+var __getOwnPropSymbols$f = Object.getOwnPropertySymbols;
+var __hasOwnProp$f = Object.prototype.hasOwnProperty;
+var __propIsEnum$f = Object.prototype.propertyIsEnumerable;
+var __defNormalProp$f = (obj, key, value) => key in obj ? __defProp$f(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __spreadValues$f = (a, b) => {
   for (var prop in b || (b = {}))
-    if (__hasOwnProp$e.call(b, prop))
-      __defNormalProp$e(a, prop, b[prop]);
-  if (__getOwnPropSymbols$e)
-    for (var prop of __getOwnPropSymbols$e(b)) {
-      if (__propIsEnum$e.call(b, prop))
-        __defNormalProp$e(a, prop, b[prop]);
+    if (__hasOwnProp$f.call(b, prop))
+      __defNormalProp$f(a, prop, b[prop]);
+  if (__getOwnPropSymbols$f)
+    for (var prop of __getOwnPropSymbols$f(b)) {
+      if (__propIsEnum$f.call(b, prop))
+        __defNormalProp$f(a, prop, b[prop]);
     }
   return a;
 };
-var __spreadProps$e = (a, b) => __defProps$e(a, __getOwnPropDescs$e(b));
+var __spreadProps$f = (a, b) => __defProps$f(a, __getOwnPropDescs$f(b));
 function adaptMethod(method, linkGenerator, baseHeadingLevel) {
   var _a, _b, _c;
   function buildTitle(method2) {
@@ -292,7 +298,7 @@ function adaptMethod(method, linkGenerator, baseHeadingLevel) {
     returnType: {
       headingLevel: baseHeadingLevel + 1,
       heading: "Return Type",
-      value: __spreadProps$e(__spreadValues$e({}, adaptDescribable((_b = (_a = method.docComment) == null ? void 0 : _a.returnAnnotation) == null ? void 0 : _b.bodyLines, linkGenerator)), {
+      value: __spreadProps$f(__spreadValues$f({}, adaptDescribable((_b = (_a = method.docComment) == null ? void 0 : _a.returnAnnotation) == null ? void 0 : _b.bodyLines, linkGenerator)), {
         type: linkGenerator(method.typeReference.rawDeclaration)
       })
     },
@@ -351,13 +357,13 @@ function mapParameters(documentable, param, linkGenerator) {
   const paramAnnotation = (_a = documentable.docComment) == null ? void 0 : _a.paramAnnotations.find(
     (pa) => pa.paramName.toLowerCase() === param.name.toLowerCase()
   );
-  return __spreadProps$e(__spreadValues$e({}, adaptDescribable(paramAnnotation == null ? void 0 : paramAnnotation.bodyLines, linkGenerator)), {
+  return __spreadProps$f(__spreadValues$f({}, adaptDescribable(paramAnnotation == null ? void 0 : paramAnnotation.bodyLines, linkGenerator)), {
     name: param.name,
     type: linkGenerator(param.typeReference.rawDeclaration)
   });
 }
 function mapThrows(thrown, linkGenerator) {
-  return __spreadProps$e(__spreadValues$e({}, adaptDescribable(thrown.bodyLines, linkGenerator)), {
+  return __spreadProps$f(__spreadValues$f({}, adaptDescribable(thrown.bodyLines, linkGenerator)), {
     type: linkGenerator(thrown.exceptionName)
   });
 }
@@ -392,25 +398,25 @@ function adaptFieldOrProperty(field, linkGenerator, baseHeadingLevel) {
   };
 }
 
-var __defProp$d = Object.defineProperty;
-var __defProps$d = Object.defineProperties;
-var __getOwnPropDescs$d = Object.getOwnPropertyDescriptors;
-var __getOwnPropSymbols$d = Object.getOwnPropertySymbols;
-var __hasOwnProp$d = Object.prototype.hasOwnProperty;
-var __propIsEnum$d = Object.prototype.propertyIsEnumerable;
-var __defNormalProp$d = (obj, key, value) => key in obj ? __defProp$d(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
-var __spreadValues$d = (a, b) => {
+var __defProp$e = Object.defineProperty;
+var __defProps$e = Object.defineProperties;
+var __getOwnPropDescs$e = Object.getOwnPropertyDescriptors;
+var __getOwnPropSymbols$e = Object.getOwnPropertySymbols;
+var __hasOwnProp$e = Object.prototype.hasOwnProperty;
+var __propIsEnum$e = Object.prototype.propertyIsEnumerable;
+var __defNormalProp$e = (obj, key, value) => key in obj ? __defProp$e(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __spreadValues$e = (a, b) => {
   for (var prop in b || (b = {}))
-    if (__hasOwnProp$d.call(b, prop))
-      __defNormalProp$d(a, prop, b[prop]);
-  if (__getOwnPropSymbols$d)
-    for (var prop of __getOwnPropSymbols$d(b)) {
-      if (__propIsEnum$d.call(b, prop))
-        __defNormalProp$d(a, prop, b[prop]);
+    if (__hasOwnProp$e.call(b, prop))
+      __defNormalProp$e(a, prop, b[prop]);
+  if (__getOwnPropSymbols$e)
+    for (var prop of __getOwnPropSymbols$e(b)) {
+      if (__propIsEnum$e.call(b, prop))
+        __defNormalProp$e(a, prop, b[prop]);
     }
   return a;
 };
-var __spreadProps$d = (a, b) => __defProps$d(a, __getOwnPropDescs$d(b));
+var __spreadProps$e = (a, b) => __defProps$e(a, __getOwnPropDescs$e(b));
 function typeToRenderable(parsedFile, linkGenerator, config) {
   function getRenderable() {
     const { type } = parsedFile;
@@ -423,7 +429,7 @@ function typeToRenderable(parsedFile, linkGenerator, config) {
         return classTypeToClassSource(type, linkGenerator);
     }
   }
-  return __spreadProps$d(__spreadValues$d({}, getRenderable()), {
+  return __spreadProps$e(__spreadValues$e({}, getRenderable()), {
     filePath: parsedFile.source.filePath,
     namespace: config.namespace
   });
@@ -448,7 +454,7 @@ function baseTypeAdapter(type, linkGenerator, baseHeadingLevel) {
   };
 }
 function enumTypeToEnumSource(enumType, linkGenerator, baseHeadingLevel = 1) {
-  return __spreadProps$d(__spreadValues$d({
+  return __spreadProps$e(__spreadValues$e({
     type: "enum"
   }, baseTypeAdapter(enumType, linkGenerator, baseHeadingLevel)), {
     values: {
@@ -456,7 +462,7 @@ function enumTypeToEnumSource(enumType, linkGenerator, baseHeadingLevel = 1) {
       heading: "Values",
       value: enumType.values.map((value) => {
         var _a;
-        return __spreadProps$d(__spreadValues$d({}, adaptDescribable((_a = value.docComment) == null ? void 0 : _a.descriptionLines, linkGenerator)), {
+        return __spreadProps$e(__spreadValues$e({}, adaptDescribable((_a = value.docComment) == null ? void 0 : _a.descriptionLines, linkGenerator)), {
           value: value.name
         });
       })
@@ -464,7 +470,7 @@ function enumTypeToEnumSource(enumType, linkGenerator, baseHeadingLevel = 1) {
   });
 }
 function interfaceTypeToInterfaceSource(interfaceType, linkGenerator, baseHeadingLevel = 1) {
-  return __spreadProps$d(__spreadValues$d({
+  return __spreadProps$e(__spreadValues$e({
     type: "interface"
   }, baseTypeAdapter(interfaceType, linkGenerator, baseHeadingLevel)), {
     extends: interfaceType.extended_interfaces.map(linkGenerator),
@@ -476,7 +482,7 @@ function interfaceTypeToInterfaceSource(interfaceType, linkGenerator, baseHeadin
   });
 }
 function classTypeToClassSource(classType, linkGenerator, baseHeadingLevel = 1) {
-  return __spreadProps$d(__spreadValues$d({
+  return __spreadProps$e(__spreadValues$e({
     type: "class"
   }, baseTypeAdapter(classType, linkGenerator, baseHeadingLevel)), {
     classModifier: classType.classModifier,
@@ -509,7 +515,7 @@ function classTypeToClassSource(classType, linkGenerator, baseHeadingLevel = 1)
       headingLevel: baseHeadingLevel + 1,
       heading: "Classes",
       value: classType.classes.map(
-        (innerClass) => classTypeToClassSource(__spreadProps$d(__spreadValues$d({}, innerClass), { inheritanceChain: [] }), linkGenerator, baseHeadingLevel + 2)
+        (innerClass) => classTypeToClassSource(__spreadProps$e(__spreadValues$e({}, innerClass), { inheritanceChain: [] }), linkGenerator, baseHeadingLevel + 2)
       )
     },
     innerEnums: {
@@ -661,16 +667,59 @@ 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;
 }
 
+var __defProp$d = Object.defineProperty;
+var __defProps$d = Object.defineProperties;
+var __getOwnPropDescs$d = Object.getOwnPropertyDescriptors;
+var __getOwnPropSymbols$d = Object.getOwnPropertySymbols;
+var __hasOwnProp$d = Object.prototype.hasOwnProperty;
+var __propIsEnum$d = Object.prototype.propertyIsEnumerable;
+var __defNormalProp$d = (obj, key, value) => key in obj ? __defProp$d(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __spreadValues$d = (a, b) => {
+  for (var prop in b || (b = {}))
+    if (__hasOwnProp$d.call(b, prop))
+      __defNormalProp$d(a, prop, b[prop]);
+  if (__getOwnPropSymbols$d)
+    for (var prop of __getOwnPropSymbols$d(b)) {
+      if (__propIsEnum$d.call(b, prop))
+        __defNormalProp$d(a, prop, b[prop]);
+    }
+  return a;
+};
+var __spreadProps$d = (a, b) => __defProps$d(a, __getOwnPropDescs$d(b));
+var __async$6 = (__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());
+  });
+};
 class ReflectionErrors {
   constructor(errors) {
     this.errors = errors;
@@ -683,59 +732,88 @@ class ReflectionError {
     this.message = message;
   }
 }
-function checkForReflectionErrors(reflectionResult) {
-  function reduceReflectionResultIntoSingleEither(results) {
-    return results.reduce(
-      (acc, result) => {
-        E__namespace.isLeft(result) ? acc.errors.push(result.left) : acc.parsedFiles.push(result.right);
-        return acc;
-      },
-      {
-        errors: [],
-        parsedFiles: []
+function reflectAsync(rawSource) {
+  return __async$6(this, null, function* () {
+    return new Promise((resolve, reject) => {
+      const result = apexReflection.reflect(rawSource);
+      if (result.typeMirror) {
+        return resolve(result.typeMirror);
+      } else if (result.error) {
+        return reject(result.error);
+      } else {
+        return reject(new Error("Unknown error"));
       }
-    );
-  }
-  return _function.pipe(
-    reflectionResult,
-    reduceReflectionResultIntoSingleEither,
-    ({ errors, parsedFiles }) => errors.length ? E__namespace.left(new ReflectionErrors(errors)) : E__namespace.right(parsedFiles)
-  );
+    });
+  });
 }
-
-function reflectSourceCode(apexBundles) {
-  return apexBundles.map(reflectSourceBody);
+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)(reflectBundle));
+}
+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.flatMap(withMetadata));
+}
+function reflectAsTask(apexBundle) {
+  return TE__namespace.tryCatch(
+    () => reflectAsync(apexBundle.content),
+    (error) => new ReflectionErrors([new ReflectionError(apexBundle.filePath, error.message)])
+  );
 }
-function reflectSourceBody(apexBundle) {
-  const { filePath, content: input, metadataContent: metadata } = apexBundle;
-  const result = apexReflection.reflect(input);
-  return result.error ? E__namespace.left(new ReflectionError(filePath, result.error.message)) : E__namespace.right({
+function toParsedFile(filePath, typeMirror) {
+  return {
     source: {
       filePath,
-      name: result.typeMirror.name,
-      type: result.typeMirror.type_name
+      name: typeMirror.name,
+      type: typeMirror.type_name
     },
-    type: addFileMetadataToTypeAnnotation(result.typeMirror, metadata)
-  });
+    type: typeMirror
+  };
+}
+function addMetadata(rawMetadataContent, parsedFile) {
+  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(
@@ -1525,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 {
@@ -1559,15 +1637,13 @@ function generateDocs(apexBundles, config) {
   const sortTypeMembers = apply(sortMembers, config.sortMembersAlphabetically);
   return _function.pipe(
     apexBundles,
-    reflectSourceCode,
-    checkForReflectionErrors,
-    E__namespace.map(filterOutOfScope),
-    E__namespace.map(addInheritedMembersToTypes),
-    E__namespace.map(addInheritanceChainToTypes),
-    E__namespace.map(sortTypeMembers),
-    E__namespace.bindTo("parsedFiles"),
-    E__namespace.bind("references", ({ parsedFiles }) => E__namespace.right(convertToReferences(parsedFiles))),
-    TE__namespace.fromEither,
+    reflectBundles,
+    TE__namespace.map(filterOutOfScope),
+    TE__namespace.map(addInheritedMembersToTypes),
+    TE__namespace.map(addInheritanceChainToTypes),
+    TE__namespace.map(sortTypeMembers),
+    TE__namespace.bindTo("parsedFiles"),
+    TE__namespace.bind("references", ({ parsedFiles }) => TE__namespace.right(convertToReferences(parsedFiles))),
     TE__namespace.flatMap(({ parsedFiles, references }) => transformReferenceHook(config)({ references, parsedFiles })),
     TE__namespace.map(({ parsedFiles, references }) => convertToRenderableBundle(parsedFiles, references)),
     TE__namespace.map(convertToDocumentationBundleForTemplate),
@@ -1577,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
@@ -1598,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);
   }));
@@ -1609,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) {
@@ -1664,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;
@@ -1683,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;
@@ -1780,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), {
@@ -1806,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;
@@ -1852,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);
@@ -2003,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;
@@ -2044,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);
     });
@@ -2182,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;
@@ -2697,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
@@ -2707,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;
@@ -2762,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;
@@ -2965,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: {
@@ -3030,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;
@@ -3081,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* () {