@cparra/apexdocs 3.17.1-beta.0 → 3.17.1-beta.2

package/dist/{Apexdocs-ChhmlY0h.js → Apexdocs-C2wTTG_T.js}

@@ -3561,7 +3561,7 @@ var __async$3 = (__this, __arguments, generator) => {
     step((generator = generator.apply(__this, __arguments)).next());
   });
 };
-function generateDocs(unparsedBundles, config) {
+function generateDocs(unparsedBundles, config, debugLogger) {
   const translations = mergeTranslations({ markdown: config.translations });
   const convertToReferences = apply(parsedFilesToReferenceGuide, config);
   const convertToRenderableBundle = apply(parsedFilesToRenderableBundle, config);
@@ -3580,7 +3580,7 @@ function generateDocs(unparsedBundles, config) {
   }
   return _function.pipe(
     TE__namespace.right(replaceMacros(unparsedBundles, config.macros)),
-    TE__namespace.flatMap((unparsedBundles2) => generateForApex(filterApexSourceFiles(unparsedBundles2), config)),
+    TE__namespace.flatMap((unparsedBundles2) => generateForApex(filterApexSourceFiles(unparsedBundles2), config, debugLogger)),
     TE__namespace.chain((parsedApexFiles) => {
       return _function.pipe(
         reflectCustomFieldsAndObjectsAndMetadataRecords(
@@ -3643,10 +3643,9 @@ function replaceMacros(unparsedBundles, macros) {
     });
   });
 }
-function generateForApex(apexBundles, config) {
+function generateForApex(apexBundles, config, debugLogger) {
   const filterOutOfScope = apply(filterScope, config.scope);
   const removeExcluded = apply(removeExcludedTags, config.excludeTags);
-  const debugLogger = void 0;
   return _function.pipe(
     apexBundles,
     (bundles) => reflectApexSourceBestEffort(
@@ -3657,13 +3656,24 @@ function generateForApex(apexBundles, config) {
       },
       debugLogger
     ),
-    TE__namespace.map(({ successes }) => {
-      return successes;
-    }),
-    TE__namespace.map(filterOutOfScope),
-    TE__namespace.map(addInheritedMembersToTypes),
-    TE__namespace.map(addInheritanceChainToTypes),
-    TE__namespace.map(removeExcluded)
+    TE__namespace.flatMap(({ successes, errors }) => {
+      const filtered = _function.pipe(
+        TE__namespace.right(successes),
+        TE__namespace.map(filterOutOfScope),
+        TE__namespace.map(addInheritedMembersToTypes),
+        TE__namespace.map(addInheritanceChainToTypes),
+        TE__namespace.map(removeExcluded)
+      );
+      return _function.pipe(
+        filtered,
+        TE__namespace.flatMap((parsed) => {
+          if (errors.errors.length > 0) {
+            return TE__namespace.left(errors);
+          }
+          return TE__namespace.right(parsed);
+        })
+      );
+    })
   );
 }
 function transformReferenceHook(config) {
@@ -3833,16 +3843,20 @@ var __spreadValues$7 = (a, b) => {
   return a;
 };
 var __spreadProps$6 = (a, b) => __defProps$6(a, __getOwnPropDescs$6(b));
-function generate$1(bundles, config) {
+function generate$1(bundles, config, debugLogger) {
   return _function.pipe(
-    generateDocumentationBundle(bundles, config),
+    generateDocumentationBundle(bundles, config, debugLogger),
     TE__namespace.flatMap((files) => writeFilesToSystem$1(files, config.targetDir))
   );
 }
-function generateDocumentationBundle(bundles, config) {
-  return generateDocs(bundles, __spreadProps$6(__spreadValues$7({}, config), {
-    referenceGuideTemplate
-  }));
+function generateDocumentationBundle(bundles, config, debugLogger) {
+  return generateDocs(
+    bundles,
+    __spreadProps$6(__spreadValues$7({}, config), {
+      referenceGuideTemplate
+    }),
+    debugLogger
+  );
 }
 function writeFilesToSystem$1(files, outputDir) {
   return _function.pipe(
@@ -4823,12 +4837,15 @@ function openApi(logger, fileBodies, config) {
     });
     const debugLogger = {
       onStart: (filePath) => {
+        if (!logger.isDebugEnabled()) return;
         logger.debug(`Parsing: ${filePath}`);
       },
       onSuccess: (filePath) => {
+        if (!logger.isDebugEnabled()) return;
         logger.logSingle(`Parsing: ${filePath} OK`, "green");
       },
       onFailure: (filePath, errorMessage) => {
+        if (!logger.isDebugEnabled()) return;
         logger.logSingle(`Parsing: ${filePath} FAILED`, "red");
         logger.debug(`Parsing error: ${filePath} - ${errorMessage}`);
       }
@@ -4842,9 +4859,7 @@ function openApi(logger, fileBodies, config) {
       debugLogger
     )();
     if (E__namespace.isLeft(reflectedEither)) {
-      const errors = reflectedEither.left;
-      logger.error(errors);
-      return;
+      return E__namespace.left(reflectedEither.left);
     }
     const { successes: parsedFiles, errors: recoverableErrors } = reflectedEither.right;
     if (recoverableErrors.errors.length > 0) {
@@ -4879,13 +4894,24 @@ function openApi(logger, fileBodies, config) {
     const processor = new OpenApiDocsProcessor(logger);
     Transpiler.generate(filteredTypes, processor);
     const generatedFiles = processor.fileBuilder().files();
-    yield _function.pipe(
+    const writeResult = yield _function.pipe(
       writeFiles(generatedFiles, config.targetDir, (file) => {
         logger.logSingle(`${file.outputDocPath} processed.`, "green");
       }),
-      TE__namespace.mapError((error) => logger.error(error))
+      TE__namespace.mapLeft((error) => new FileWritingError("An error occurred while writing files to the system.", error))
     )();
+    if (E__namespace.isLeft(writeResult)) {
+      return E__namespace.left(writeResult.left);
+    }
     ErrorLogger.logErrors(logger, filteredTypes);
+    if (recoverableErrors.errors.length > 0) {
+      return E__namespace.left(
+        new ReflectionErrors(
+          recoverableErrors.errors.map((e) => __spreadValues$2({}, e))
+        )
+      );
+    }
+    return E__namespace.right(void 0);
   });
 }
 function filterByScopes(logger, manifest) {
@@ -6277,6 +6303,21 @@ class Apexdocs {
 const readFiles = apply(processFiles, new DefaultFileSystem());
 function processMarkdown(config, logger) {
   return __async(this, null, function* () {
+    const debugLogger = {
+      onStart: (filePath) => {
+        if (!logger.isDebugEnabled()) return;
+        logger.debug(`Parsing: ${filePath}`);
+      },
+      onSuccess: (filePath) => {
+        if (!logger.isDebugEnabled()) return;
+        logger.logSingle(`Parsing: ${filePath} OK`, "green");
+      },
+      onFailure: (filePath, errorMessage) => {
+        if (!logger.isDebugEnabled()) return;
+        logger.logSingle(`Parsing: ${filePath} FAILED`, "red");
+        logger.debug(`Parsing error: ${filePath} - ${errorMessage}`);
+      }
+    };
     return _function.pipe(
       resolveAndValidateSourceDirectories(config),
       E__namespace.mapLeft((error) => new FileReadingError(`Failed to resolve source directories: ${error.message}`, error)),
@@ -6289,7 +6330,7 @@ function processMarkdown(config, logger) {
         )
       ),
       TE__namespace.fromEither,
-      TE__namespace.flatMap((fileBodies) => generate$1(fileBodies, config)),
+      TE__namespace.flatMap((fileBodies) => generate$1(fileBodies, config, debugLogger)),
       TE__namespace.map(() => "\u2714\uFE0F Documentation generated successfully!"),
       // Best-effort behavior: if there were recoverable parse/reflection failures, they should be returned here
       // (for presentation to the user at the end of the run), not thrown earlier.

package/dist/cli/generate.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 'use strict';
 
-var Apexdocs = require('../Apexdocs-ChhmlY0h.js');
+var Apexdocs = require('../Apexdocs-C2wTTG_T.js');
 var cosmiconfig = require('cosmiconfig');
 var yargs = require('yargs');
 var E = require('fp-ts/Either');

package/dist/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 'use strict';
 
-var Apexdocs = require('./Apexdocs-ChhmlY0h.js');
+var Apexdocs = require('./Apexdocs-C2wTTG_T.js');
 var E = require('fp-ts/Either');
 require('fp-ts/function');
 require('fp-ts/TaskEither');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cparra/apexdocs",
-  "version": "3.17.1-beta.0",
+  "version": "3.17.1-beta.2",
   "description": "Library with CLI capabilities to generate documentation for Salesforce Apex classes.",
   "engines": {
     "node": ">=18"