@cparra/apexdocs 3.14.0 → 3.15.0-alpha.1

package/README.md

@@ -155,7 +155,9 @@ apexdocs changelog --previousVersionDir force-app-previous --currentVersionDir f
 | `--customObjectsGroupName`        | N/A   | The name under which custom objects will be grouped in the Reference Guide                                                                                                                               | `Custom Objects` | No       |
 | `--triggersGroupName`             | N/A   | The name under which triggers will be grouped in the Reference Guide                                                                                                                                     | `Triggers`       | No       |
 | `--includeFieldSecurityMetadata`  | N/A   | Whether to include the compliance category and security classification for fields in the generated files.                                                                                                | `false`          | No       |
-| `--includeInlineHelpTextMetadata` | N/A   | Whether to include the inline help text for fields in the generated files.                                                                                                                               | `false`          | No       |
+|| `--includeInlineHelpTextMetadata` | N/A   | Whether to include the inline help text for fields in the generated files.                                                                                                                               | `false`          | No       |
+|| `--parallelProcessing`            | N/A   | Whether to use parallel processing for reflection operations.                                                                                                                                            | `true`           | No       |
+|| `--workerThreads`                 | N/A   | Number of worker threads to use for parallel processing (defaults to number of CPU cores).                                                                                                              | CPU cores        | No       |
 
 > **Note:** The `*` in the Required column indicates that **one** of the source directory options must be specified:
 > - `--sourceDir` (single directory)
@@ -233,7 +235,9 @@ apexdocs openapi -s force-app -t docs -n MyNamespace --title "My Custom OpenApi
 | `--fileName`               | N/A   | The name of the changelog file to be generated.                                      | `changelog` | No       |
 | `--scope`                  | N/A   | The list of scope to respect when generating the changelog.                          | ['global']  | No       |
 | `--customObjectVisibility` | `-v`  | Controls which custom objects are documented. Values should be separated by a space. | ['public']  | No       |
-| `--skipIfNoChanges`        | N/A   | Whether to skip generating the changelog if there are no changes.                    | `true`      | No       |
+|| `--skipIfNoChanges`        | N/A   | Whether to skip generating the changelog if there are no changes.                    | `true`      | No       |
+|| `--parallelProcessing`     | N/A   | Whether to use parallel processing for reflection operations.                         | `true`      | No       |
+|| `--workerThreads`          | N/A   | Number of worker threads to use for parallel processing (defaults to number of CPU cores). | CPU cores   | No       |
 
 #### Sample Usage
 
@@ -243,6 +247,62 @@ apexdocs changelog -p force-app-previous -t force-app
 
 ---
 
+## ⚡ Parallel Processing
+
+ApexDocs supports parallel processing for reflection operations, significantly improving performance when processing large numbers of Apex files. This feature uses Node.js Worker Threads to process files in parallel while maintaining full compatibility with existing configurations.
+
+### Key Features
+
+- **Automatic**: Enabled by default in production environments
+- **Adaptive**: Automatically chooses between parallel and sequential processing based on file count and environment
+- **Configurable**: Control the number of worker threads used
+- **Safe**: Automatically disabled during tests to prevent interference
+
+### Configuration
+
+```typescript
+import { defineMarkdownConfig } from '@cparra/apexdocs';
+
+export default defineMarkdownConfig({
+  sourceDir: 'force-app',
+  targetDir: 'docs',
+  
+  // Enable/disable parallel processing (default: true in production)
+  parallelProcessing: true,
+  
+  // Set number of worker threads (default: CPU cores)
+  workerThreads: 4,
+});
+```
+
+### CLI Usage
+
+```bash
+# Use parallel processing (default)
+apexdocs markdown -s force-app
+
+# Disable parallel processing
+apexdocs markdown -s force-app --parallelProcessing false
+
+# Set custom worker thread count
+apexdocs markdown -s force-app --workerThreads 8
+```
+
+### Performance Benefits
+
+- **Large codebases**: Significant performance improvements for projects with many files
+- **Multi-core systems**: Better utilization of available CPU cores
+- **CI/CD pipelines**: Faster documentation generation in automated environments
+
+### When It's Used
+
+- **Parallel**: Multiple files + production environment + parallel enabled
+- **Sequential**: Single file OR test environment OR parallel disabled
+
+For more detailed information, see [PARALLEL_PROCESSING.md](PARALLEL_PROCESSING.md).
+
+---
+
 ## 🔬 Defining a configuration file
 
 You can also use a configuration file to define the parameters that will be used when generating the documentation.

package/dist/cli/generate.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 'use strict';
 
-var logger$1 = require('../logger-D4Q3KA6D.js');
+var logger$1 = require('../logger-B7fARcrW.js');
 var require$$0 = require('yargs');
 var cosmiconfig = require('cosmiconfig');
 var E = require('fp-ts/Either');
@@ -10,14 +10,17 @@ var _function = require('fp-ts/function');
 require('fp-ts/TaskEither');
 require('js-yaml');
 require('path');
-require('fp-ts/Task');
-require('fp-ts/lib/Array');
-require('@cparra/apex-reflection');
 require('fp-ts/Option');
-require('fast-xml-parser');
 require('handlebars');
 require('fp-ts/boolean');
+require('fast-xml-parser');
+require('fp-ts/Task');
 require('fp-ts/Array');
+require('worker_threads');
+require('os');
+require('fp-ts/lib/Array');
+require('@cparra/apex-reflection');
+require('uuid');
 require('fs');
 require('fp-ts/lib/TaskEither');
 require('minimatch');
@@ -141,6 +144,15 @@ const markdownOptions = {
   includeInlineHelpTextMetadata: {
     type: "boolean",
     describe: "Whether to include the inline help text for fields in the generated files."
+  },
+  parallelProcessing: {
+    type: "boolean",
+    describe: "Whether to use parallel processing for reflection operations.",
+    default: logger$1.markdownDefaults.parallelProcessing
+  },
+  workerThreads: {
+    type: "number",
+    describe: "Number of worker threads to use for parallel processing (defaults to number of CPU cores)."
   }
 };
 
@@ -256,6 +268,15 @@ const changeLogOptions = {
     type: "boolean",
     default: logger$1.changeLogDefaults.skipIfNoChanges,
     describe: "Skip the changelog generation if there are no changes between the previous and current version."
+  },
+  parallelProcessing: {
+    type: "boolean",
+    describe: "Whether to use parallel processing for reflection operations.",
+    default: logger$1.changeLogDefaults.parallelProcessing
+  },
+  workerThreads: {
+    type: "number",
+    describe: "Number of worker threads to use for parallel processing (defaults to number of CPU cores)."
   }
 };
 

package/dist/core/reflection/worker-thread/reflection-worker.js

@@ -0,0 +1,58 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const worker_threads_1 = require("worker_threads");
+const apex_reflection_1 = require("@cparra/apex-reflection");
+function processReflectionTask(task) {
+    return __awaiter(this, void 0, void 0, function* () {
+        try {
+            let result;
+            if (task.type === 'apex') {
+                const reflectionResult = (0, apex_reflection_1.reflect)(task.content);
+                if (reflectionResult.error) {
+                    throw reflectionResult.error;
+                }
+                result = reflectionResult.typeMirror;
+            }
+            else if (task.type === 'trigger') {
+                const reflectionResult = yield (0, apex_reflection_1.reflectTriggerAsync)(task.content);
+                if (reflectionResult.error) {
+                    throw reflectionResult.error;
+                }
+                result = reflectionResult.triggerMirror;
+            }
+            else {
+                throw new Error(`Unknown reflection type: ${task.type}`);
+            }
+            return {
+                id: task.id,
+                success: true,
+                result,
+            };
+        }
+        catch (error) {
+            return {
+                id: task.id,
+                success: false,
+                error: {
+                    message: error.message,
+                    filePath: task.filePath,
+                },
+            };
+        }
+    });
+}
+if (worker_threads_1.parentPort) {
+    worker_threads_1.parentPort.on('message', (task) => __awaiter(void 0, void 0, void 0, function* () {
+        const result = yield processReflectionTask(task);
+        worker_threads_1.parentPort.postMessage(result);
+    }));
+}

package/dist/index.d.ts

@@ -173,6 +173,8 @@ type CliConfigurableMarkdownConfig = {
   referenceGuideTitle: string;
   includeFieldSecurityMetadata: boolean;
   includeInlineHelpTextMetadata: boolean;
+  parallelProcessing?: boolean;
+  workerThreads?: number;
 };
 
 type UserDefinedMarkdownConfig = {
@@ -207,6 +209,8 @@ type UserDefinedChangelogConfig = {
   exclude: string[];
   skipIfNoChanges: boolean;
   translations?: UserTranslations['changelog'];
+  parallelProcessing?: boolean;
+  workerThreads?: number;
 } & Partial<ChangelogConfigurableHooks>;
 
 type UserDefinedConfig = UserDefinedMarkdownConfig | UserDefinedOpenApiConfig | UserDefinedChangelogConfig;

package/dist/index.js

@@ -1,19 +1,22 @@
 'use strict';
 
-var logger = require('./logger-D4Q3KA6D.js');
+var logger = require('./logger-B7fARcrW.js');
 var E = require('fp-ts/Either');
 require('fp-ts/function');
 require('fp-ts/TaskEither');
 require('js-yaml');
 require('path');
-require('fp-ts/Task');
-require('fp-ts/lib/Array');
-require('@cparra/apex-reflection');
 require('fp-ts/Option');
-require('fast-xml-parser');
 require('handlebars');
 require('fp-ts/boolean');
+require('fast-xml-parser');
+require('fp-ts/Task');
 require('fp-ts/Array');
+require('worker_threads');
+require('os');
+require('fp-ts/lib/Array');
+require('@cparra/apex-reflection');
+require('uuid');
 require('fs');
 require('fp-ts/lib/TaskEither');
 require('minimatch');