@cparra/apexdocs 3.19.9-beta.1 → 3.19.9-beta.3

package/dist/cli/generate.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 'use strict';
 
-var logger$1 = require('../logger-BA26xTtD.js');
+var logger$1 = require('../logger-Bm8lUpMI.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 logger = require('./logger-BA26xTtD.js');
+var logger = require('./logger-Bm8lUpMI.js');
 var E = require('fp-ts/Either');
 require('fp-ts/function');
 require('fp-ts/TaskEither');

package/dist/{logger-BA26xTtD.js → logger-Bm8lUpMI.js}

@@ -2995,14 +2995,18 @@ var __spreadValues$f = (a, b) => {
   return a;
 };
 var __spreadProps$d = (a, b) => __defProps$d(a, __getOwnPropDescs$d(b));
-function reflectCustomObjectSources(objectBundles) {
+function reflectCustomObjectSources(objectBundles, debugLogger = noopReflectionDebugLogger) {
   const semiGroupReflectionError = {
     concat: (x, y) => new ReflectionErrors([...x.errors, ...y.errors])
   };
   const Ap = TE__namespace.getApplicativeTaskValidation(T__namespace.ApplyPar, semiGroupReflectionError);
-  return _function.pipe(objectBundles, A__namespace$1.traverse(Ap)(reflectCustomObjectSource));
+  return _function.pipe(
+    objectBundles,
+    A__namespace$1.traverse(Ap)((bundle) => reflectCustomObjectSource(bundle, debugLogger))
+  );
 }
-function reflectCustomObjectSource(objectSource) {
+function reflectCustomObjectSource(objectSource, debugLogger) {
+  debugLogger.onStart(objectSource.filePath);
   return _function.pipe(
     E__namespace.tryCatch(() => new fastXmlParser.XMLParser().parse(objectSource.content), E__namespace.toError),
     E__namespace.flatMap(validate$2),
@@ -3011,7 +3015,14 @@ function reflectCustomObjectSource(objectSource) {
     E__namespace.map(parseInlineFields),
     E__namespace.map(addTypeName),
     E__namespace.map((metadata) => toParsedFile$4(objectSource.filePath, metadata)),
-    E__namespace.mapLeft((error) => new ReflectionErrors([new ReflectionError(objectSource.filePath, error.message)])),
+    E__namespace.mapLeft((error) => {
+      debugLogger.onFailure(objectSource.filePath, error.message);
+      return new ReflectionErrors([new ReflectionError(objectSource.filePath, error.message)]);
+    }),
+    E__namespace.map((parsedFile) => {
+      debugLogger.onSuccess(objectSource.filePath);
+      return parsedFile;
+    }),
     TE__namespace.fromEither
   );
 }
@@ -3107,14 +3118,18 @@ var __spreadValues$e = (a, b) => {
   return a;
 };
 var __spreadProps$c = (a, b) => __defProps$c(a, __getOwnPropDescs$c(b));
-function reflectCustomFieldSources(customFieldSources) {
+function reflectCustomFieldSources(customFieldSources, debugLogger = noopReflectionDebugLogger) {
   const semiGroupReflectionError = {
     concat: (x, y) => new ReflectionErrors([...x.errors, ...y.errors])
   };
   const Ap = TE__namespace.getApplicativeTaskValidation(T__namespace.ApplyPar, semiGroupReflectionError);
-  return _function.pipe(customFieldSources, A__namespace$1.traverse(Ap)(reflectCustomFieldSource));
+  return _function.pipe(
+    customFieldSources,
+    A__namespace$1.traverse(Ap)((bundle) => reflectCustomFieldSource(bundle, debugLogger))
+  );
 }
-function reflectCustomFieldSource(customFieldSource) {
+function reflectCustomFieldSource(customFieldSource, debugLogger) {
+  debugLogger.onStart(customFieldSource.filePath);
   return _function.pipe(
     E__namespace.tryCatch(() => new fastXmlParser.XMLParser().parse(customFieldSource.content), E__namespace.toError),
     E__namespace.flatMap(validate$1),
@@ -3122,7 +3137,14 @@ function reflectCustomFieldSource(customFieldSource) {
     E__namespace.map((metadata) => addName(metadata, customFieldSource.name)),
     E__namespace.map((metadata) => addParentName$1(metadata, customFieldSource.parentName)),
     E__namespace.map((metadata) => toParsedFile$3(customFieldSource.filePath, metadata)),
-    E__namespace.mapLeft((error) => new ReflectionErrors([new ReflectionError(customFieldSource.filePath, error.message)])),
+    E__namespace.map((parsed) => {
+      debugLogger.onSuccess(customFieldSource.filePath);
+      return parsed;
+    }),
+    E__namespace.mapLeft((error) => {
+      debugLogger.onFailure(customFieldSource.filePath, error.message);
+      return new ReflectionErrors([new ReflectionError(customFieldSource.filePath, error.message)]);
+    }),
     TE__namespace.fromEither
   );
 }
@@ -3186,10 +3208,14 @@ var __spreadValues$d = (a, b) => {
   return a;
 };
 var __spreadProps$b = (a, b) => __defProps$b(a, __getOwnPropDescs$b(b));
-function reflectCustomMetadataSources(customMetadataSources) {
-  return _function.pipe(customMetadataSources, A__namespace$1.traverse(TE__namespace.ApplicativePar)(reflectCustomMetadataSource));
+function reflectCustomMetadataSources(customMetadataSources, debugLogger = noopReflectionDebugLogger) {
+  return _function.pipe(
+    customMetadataSources,
+    A__namespace$1.traverse(TE__namespace.ApplicativePar)((bundle) => reflectCustomMetadataSource(bundle, debugLogger))
+  );
 }
-function reflectCustomMetadataSource(customMetadataSource) {
+function reflectCustomMetadataSource(customMetadataSource, debugLogger) {
+  debugLogger.onStart(customMetadataSource.filePath);
   return _function.pipe(
     E__namespace.tryCatch(() => new fastXmlParser.XMLParser().parse(customMetadataSource.content), E__namespace.toError),
     E__namespace.flatMap(validate),
@@ -3197,7 +3223,14 @@ function reflectCustomMetadataSource(customMetadataSource) {
     E__namespace.map((metadata) => addNames(metadata, customMetadataSource.name, customMetadataSource.apiName)),
     E__namespace.map((metadata) => addParentName(metadata, customMetadataSource.parentName)),
     E__namespace.map((metadata) => toParsedFile$2(customMetadataSource.filePath, metadata)),
-    E__namespace.mapLeft((error) => new ReflectionErrors([new ReflectionError(customMetadataSource.filePath, error.message)])),
+    E__namespace.mapLeft((error) => {
+      debugLogger.onFailure(customMetadataSource.filePath, error.message);
+      return new ReflectionErrors([new ReflectionError(customMetadataSource.filePath, error.message)]);
+    }),
+    E__namespace.map((parsed) => {
+      debugLogger.onSuccess(customMetadataSource.filePath);
+      return parsed;
+    }),
     TE__namespace.fromEither
   );
 }
@@ -3256,7 +3289,7 @@ var __spreadValues$c = (a, b) => {
   return a;
 };
 var __spreadProps$a = (a, b) => __defProps$a(a, __getOwnPropDescs$a(b));
-function reflectCustomFieldsAndObjectsAndMetadataRecords(objectBundles, visibilitiesToDocument) {
+function reflectCustomFieldsAndObjectsAndMetadataRecords(objectBundles, visibilitiesToDocument, debugLogger = noopReflectionDebugLogger) {
   function filterNonPublished(parsedFiles) {
     return parsedFiles.filter((parsedFile) => parsedFile.type.deploymentStatus === "Deployed");
   }
@@ -3278,14 +3311,14 @@ function reflectCustomFieldsAndObjectsAndMetadataRecords(objectBundles, visibili
     (object) => object.type === "custommetadata"
   );
   function generateForFields(fields) {
-    return _function.pipe(fields, reflectCustomFieldSources);
+    return _function.pipe(fields, (bundles) => reflectCustomFieldSources(bundles, debugLogger));
   }
   function generateForMetadata(metadata) {
-    return _function.pipe(metadata, reflectCustomMetadataSources);
+    return _function.pipe(metadata, (bundles) => reflectCustomMetadataSources(bundles, debugLogger));
   }
   return _function.pipe(
     customObjects,
-    reflectCustomObjectSources,
+    (bundles) => reflectCustomObjectSources(bundles, debugLogger),
     TE__namespace.map(filterNonPublished),
     TE__namespace.map(filter),
     TE__namespace.bindTo("filterResult"),
@@ -3399,19 +3432,36 @@ var __async$4 = (__this, __arguments, generator) => {
     step((generator = generator.apply(__this, __arguments)).next());
   });
 };
-function reflectTriggerSource(triggerBundles) {
+function reflectTriggerSource(triggerBundles, debugLogger = noopReflectionDebugLogger) {
   const semiGroupReflectionError = {
     concat: (x, y) => new ReflectionErrors([...x.errors, ...y.errors])
   };
   const Ap = TE__namespace.getApplicativeTaskValidation(T__namespace.ApplyPar, semiGroupReflectionError);
-  return _function.pipe(triggerBundles, A__namespace.traverse(Ap)(reflectBundle$1));
+  return _function.pipe(
+    triggerBundles,
+    A__namespace.traverse(Ap)((bundle) => reflectBundle$1(bundle, debugLogger))
+  );
 }
-function reflectBundle$1(triggerBundle) {
+function reflectBundle$1(triggerBundle, debugLogger) {
   const convertToParsedFile = apply(
     toParsedFile$1,
     triggerBundle.filePath
   );
-  return _function.pipe(triggerBundle, reflectAsTask, TE__namespace.map(convertToParsedFile));
+  debugLogger.onStart(triggerBundle.filePath);
+  return _function.pipe(
+    triggerBundle,
+    reflectAsTask,
+    TE__namespace.map((triggerMirror) => {
+      debugLogger.onSuccess(triggerBundle.filePath);
+      return triggerMirror;
+    }),
+    TE__namespace.map(convertToParsedFile),
+    TE__namespace.mapLeft((errs) => {
+      const msg = errs.errors.map((e) => e.message).join(" | ");
+      debugLogger.onFailure(triggerBundle.filePath, msg);
+      return errs;
+    })
+  );
 }
 function toParsedFile$1(filePath, triggerMirror) {
   return {
@@ -3457,14 +3507,18 @@ var __spreadValues$a = (a, b) => {
     }
   return a;
 };
-function reflectLwcSource(triggerBundles) {
+function reflectLwcSource(triggerBundles, debugLogger = noopReflectionDebugLogger) {
   const semiGroupReflectionError = {
     concat: (x, y) => new ReflectionErrors([...x.errors, ...y.errors])
   };
   const Ap = TE__namespace.getApplicativeTaskValidation(T__namespace.ApplyPar, semiGroupReflectionError);
-  return _function.pipe(triggerBundles, A__namespace.traverse(Ap)(reflectBundle));
+  return _function.pipe(
+    triggerBundles,
+    A__namespace.traverse(Ap)((bundle) => reflectBundle(bundle, debugLogger))
+  );
 }
-function reflectBundle(lwcBundle) {
+function reflectBundle(lwcBundle, debugLogger) {
+  debugLogger.onStart(lwcBundle.filePath);
   return _function.pipe(
     E__namespace.tryCatch(() => {
       const alwaysArray = [
@@ -3482,8 +3536,15 @@ function reflectBundle(lwcBundle) {
       const bundle = result["LightningComponentBundle"];
       return transformBooleanProperties(bundle);
     }, E__namespace.toError),
+    E__namespace.map((parsed) => {
+      debugLogger.onSuccess(lwcBundle.filePath);
+      return parsed;
+    }),
     E__namespace.map((parsed) => toParsedFile(lwcBundle.filePath, lwcBundle.name, parsed)),
-    E__namespace.mapLeft((error) => new ReflectionErrors([new ReflectionError(lwcBundle.filePath, error.message)])),
+    E__namespace.mapLeft((error) => {
+      debugLogger.onFailure(lwcBundle.filePath, error.message);
+      return new ReflectionErrors([new ReflectionError(lwcBundle.filePath, error.message)]);
+    }),
     TE__namespace.fromEither
   );
 }
@@ -3580,33 +3641,40 @@ function generateDocs(unparsedBundles, config, debugLogger) {
   }
   return _function.pipe(
     TE__namespace.right(replaceMacros(unparsedBundles, config.macros)),
-    TE__namespace.flatMap((unparsedBundles2) => generateForApex(filterApexSourceFiles(unparsedBundles2), config, debugLogger)),
-    TE__namespace.chain((parsedApexFiles) => {
-      return _function.pipe(
-        reflectCustomFieldsAndObjectsAndMetadataRecords(
-          filterCustomObjectsFieldsAndMetadataRecords(unparsedBundles),
-          config.customObjectVisibility
-        ),
-        TE__namespace.map((parsedObjectFiles) => [...parsedApexFiles, ...parsedObjectFiles])
-      );
-    }),
-    TE__namespace.chain((parsedFiles) => {
-      return _function.pipe(
-        reflectTriggerSource(filterTriggerFiles(unparsedBundles)),
-        TE__namespace.map((parsedTriggerFiles) => [...parsedFiles, ...parsedTriggerFiles])
-      );
-    }),
-    TE__namespace.chain((parsedFiles) => {
+    TE__namespace.bindW("unparsedBundles", (unparsedBundles2) => TE__namespace.right(unparsedBundles2)),
+    TE__namespace.bindW(
+      "apex",
+      ({ unparsedBundles: unparsedBundles2 }) => generateForApex(filterApexSourceFiles(unparsedBundles2), config, debugLogger)
+    ),
+    TE__namespace.bindW(
+      "objects",
+      ({ unparsedBundles: unparsedBundles2 }) => reflectCustomFieldsAndObjectsAndMetadataRecords(
+        filterCustomObjectsFieldsAndMetadataRecords(unparsedBundles2),
+        config.customObjectVisibility,
+        debugLogger
+      )
+    ),
+    TE__namespace.bindW(
+      "triggers",
+      ({ unparsedBundles: unparsedBundles2 }) => reflectTriggerSource(filterTriggerFiles(unparsedBundles2), debugLogger)
+    ),
+    TE__namespace.bindW("lwcs", ({ unparsedBundles: unparsedBundles2 }) => {
       if (!config.experimentalLwcSupport) {
-        return TE__namespace.right(parsedFiles);
+        return TE__namespace.right([]);
       }
       return _function.pipe(
-        reflectLwcSource(filterLwcFiles(unparsedBundles)),
-        TE__namespace.map((parsedFiles2) => parsedFiles2.filter((file) => file.type.isExposed)),
-        TE__namespace.map((parsedLwcFiles) => [...parsedFiles, ...parsedLwcFiles])
+        reflectLwcSource(filterLwcFiles(unparsedBundles2), debugLogger),
+        TE__namespace.map((files) => files.filter((file) => file.type.isExposed))
       );
     }),
-    TE__namespace.map((parsedFiles) => sort(filterOutCustomFieldsAndMetadata(parsedFiles))),
+    TE__namespace.flatMap(({ apex, objects, triggers, lwcs }) => {
+      const allParsed = [...apex.parsed, ...objects, ...triggers, ...lwcs];
+      const sorted = sort(filterOutCustomFieldsAndMetadata(allParsed));
+      if (apex.reflectionErrors.errors.length > 0) {
+        return TE__namespace.left(apex.reflectionErrors);
+      }
+      return TE__namespace.right(sorted);
+    }),
     TE__namespace.bindTo("parsedFiles"),
     TE__namespace.bind(
       "references",
@@ -3666,12 +3734,10 @@ function generateForApex(apexBundles, config, debugLogger) {
       );
       return _function.pipe(
         filtered,
-        TE__namespace.flatMap((parsed) => {
-          if (errors.errors.length > 0) {
-            return TE__namespace.left(errors);
-          }
-          return TE__namespace.right(parsed);
-        })
+        TE__namespace.map((parsed) => ({
+          parsed,
+          reflectionErrors: errors
+        }))
       );
     })
   );
@@ -5616,7 +5682,8 @@ function generateChangeLog(oldBundles, newBundles, config, debugLogger) {
         ({ bundles: bundles2, apex }) => _function.pipe(
           reflectCustomFieldsAndObjectsAndMetadataRecords(
             filterCustomObjectsFieldsAndMetadataRecords(bundles2),
-            config.customObjectVisibility
+            config.customObjectVisibility,
+            debugLogger
           ),
           TE__namespace.map((parsedObjectFiles) => ({
             parsedFiles: [...apex.parsedFiles, ...parsedObjectFiles],
@@ -5630,7 +5697,7 @@ function generateChangeLog(oldBundles, newBundles, config, debugLogger) {
       TE__namespace.bind(
         "all",
         ({ objects, bundles: bundles2 }) => _function.pipe(
-          reflectTriggerSource(filterTriggerFiles(bundles2)),
+          reflectTriggerSource(filterTriggerFiles(bundles2), debugLogger),
           TE__namespace.map((parsedTriggerFiles) => ({
             parsedFiles: [...objects.parsedFiles, ...parsedTriggerFiles],
             errors: objects.errors

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cparra/apexdocs",
-  "version": "3.19.9-beta.1",
+  "version": "3.19.9-beta.3",
   "description": "Library with CLI capabilities to generate documentation for Salesforce Apex classes.",
   "engines": {
     "node": ">=18"
@@ -96,7 +96,7 @@
     ]
   },
   "dependencies": {
-    "@cparra/apex-reflection": "2.23.10-dev.20260107145611",
+    "@cparra/apex-reflection": "2.23.7",
     "@salesforce/source-deploy-retrieve": "^12.20.1",
     "@types/js-yaml": "^4.0.9",
     "@types/yargs": "^17.0.32",