apex-code-coverage-transformer 4.3.0 → 5.0.0

package/CHANGELOG.md

@@ -5,6 +5,17 @@
 
 All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
 
+## [5.0.0](https://github.com/mcarvin8/apex-code-coverage-transformer/compare/v4.3.0...v5.0.0) (2026-11-14)
+
+
+### ⚠ BREAKING CHANGES
+
+* handle sfdx-hardis coverage through plugin events ([#443](https://github.com/mcarvin8/apex-code-coverage-transformer/issues/443))
+
+### Features
+
+* handle sfdx-hardis coverage through plugin events ([#443](https://github.com/mcarvin8/apex-code-coverage-transformer/issues/443)) ([807f1f1](https://github.com/mcarvin8/apex-code-coverage-transformer/commit/807f1f1edcdce8e53b2522826ae7469c739e2575))
+
 ## [4.3.0](https://github.com/mcarvin8/apex-code-coverage-transformer/compare/v4.2.0...v4.3.0) (2026-11-09)
 
 

package/README.md

@@ -12,6 +12,9 @@ Transforms (and optionally merges) Apex code coverage JSON from Salesforce deplo
 > [!WARNING]
 > **v4 breaking change:** v3 and earlier automatically re-numbered deploy command coverage lines that Salesforce reported beyond the end of a file. Salesforce fixed this bug server-side in Winter '27 (API v68.0), regardless of the `--api-version` used on the deploy, so v4 removes the re-numbering and passes deploy coverage lines through exactly as reported. Test-command coverage is unaffected. See [Troubleshooting](#troubleshooting) for details.
 
+> [!WARNING]
+> **v5 breaking change:** Only affects users using this plugin's automated hooks with sfdx-hardis. The `finally` hook no longer runs after `sf hardis project deploy smart` or `sf hardis org test apex`, or after the `sf` commands sfdx-hardis runs under the hood, so coverage is no longer transformed twice. sfdx-hardis coverage now goes through [sfdx-hardis events](#sfdx-hardis-events), which require sfdx-hardis 8.24.1 or later with plugin events enabled. With an older sfdx-hardis, upgrade it or run `sf acc-transformer transform` after the sfdx-hardis command. The `deployCoverageJsonPath` and `testCoverageJsonPath` config keys are no longer needed for sfdx-hardis.
+
 <details>
   <summary>Table of Contents</summary>
 
@@ -34,7 +37,7 @@ Transforms (and optionally merges) Apex code coverage JSON from Salesforce deplo
 ## Prerequisites
 
 - [Salesforce CLI](https://developer.salesforce.com/tools/sfdxcli) (`sf`) installed
-- Node.js 22.19 or later
+- Node.js 22.22.2 or later (`apex-code-coverage-transformer-core` alone needs 22.19 or later)
 - A Salesforce DX project with `sfdx-project.json` and package directories
 - Use only the **json** coverage formatter from the Salesforce CLI; other formatters are not supported
 
@@ -122,9 +125,9 @@ sf apex get test --test-run-id <id> --code-coverage --output-dir "coverage"
 
 **SFDX Hardis** — coverage path: `hardis-report/apex-coverage-results.json`
 
-Works with [sfdx-hardis](https://github.com/hardisgroupcom/sfdx-hardis):
+Works with [sfdx-hardis](https://github.com/hardisgroupcom/sfdx-hardis) 8.24.1 or later: the plugin picks up the coverage automatically through [sfdx-hardis events](#sfdx-hardis-events) and posts a coverage summary on the Pull Request.
 
-- `sf hardis project deploy smart` (requires `COVERAGE_FORMATTER_JSON=true`)
+- `sf hardis project deploy smart|start|validate|quick`
 - `sf hardis org test apex`
 
 ## Command Reference
@@ -196,7 +199,7 @@ EXAMPLES
   `sf acc-transformer transform -j "coverage1.json" -j "coverage2.json" -r "coverage.xml" -f "sonar"`
 ```
 
-_See code: [src/commands/acc-transformer/transform.ts](https://github.com/mcarvin8/apex-code-coverage-transformer/blob/v4.3.0/src/commands/acc-transformer/transform.ts)_
+_See code: [src/commands/acc-transformer/transform.ts](https://github.com/mcarvin8/apex-code-coverage-transformer/blob/v5.0.0/src/commands/acc-transformer/transform.ts)_
 <!-- commandsstop -->
 
 ## Coverage Report Formats
@@ -527,8 +530,7 @@ Create `.apexcodecovtransformer.config.json` in the project root to transform co
 - `sf project deploy [start|validate|report|resume]`
 - `sf apex run test`
 - `sf apex get test`
-- `sf hardis project deploy smart` (if sfdx-hardis installed and `COVERAGE_FORMATTER_JSON=true`)
-- `sf hardis org test apex` (if sfdx-hardis installed)
+- `sf hardis project deploy [smart|start|validate|quick]` and `sf hardis org test apex` (see [sfdx-hardis events](#sfdx-hardis-events))
 
 > **Note:** The hook fires once per command and always processes a single coverage JSON. It cannot merge multiple inputs. If you need to merge coverage from multiple runs (e.g. split test batches), run the `sf acc-transformer transform` command manually with multiple `-j` flags after all runs complete.
 
@@ -544,6 +546,31 @@ Sample configs: [Salesforce CLI](https://raw.githubusercontent.com/mcarvin8/apex
 | `minCoverage`              | No         | Minimum required line coverage percentage (0–100). Exits with an error if overall coverage is below this threshold.                          |
 | `maxAnnotations`           | No         | Maximum `::warning` annotations emitted when `format` includes `github-actions` (default: `50`).                                             |
 | `excludePatterns`          | No         | Comma-separated glob patterns for file paths to exclude (e.g. `**/*Test*,**/mock/**`). Matched against the relative path from the repo root. |
+| `pullRequestComment`       | No         | sfdx-hardis events only: post the coverage summary as a Pull Request comment (default: `true`).                                              |
+
+### sfdx-hardis events
+
+sfdx-hardis 8.24.1 and later send an event as soon as Salesforce returns the result of a validation, a deployment or an Apex test run. The plugin listens to these events, so with sfdx-hardis you don't need `deployCoverageJsonPath` or `testCoverageJsonPath`: the event gives the path of `hardis-report/apex-coverage-results.json`.
+
+The coverage of sfdx-hardis commands only goes through these events. The `sf project deploy` and `sf apex run test` commands that sfdx-hardis starts under the hood are skipped by the hook, so the coverage is transformed once per run.
+
+| Event                         | Sent by                                                                                                       |
+| ----------------------------- | ------------------------------------------------------------------------------------------------------------- |
+| `sfdx-hardis:validation-done` | `sf hardis project deploy smart` in check mode, `sf hardis project deploy validate`, `deploy start --dry-run` |
+| `sfdx-hardis:deployment-done` | `sf hardis project deploy smart`, `sf hardis project deploy start`, `sf hardis project deploy quick`          |
+| `sfdx-hardis:apex-tests-done` | `sf hardis org test apex`                                                                                     |
+
+On each event, when `.apexcodecovtransformer.config.json` exists, the plugin:
+
+1. Writes the reports set by `format` and `outputReportPath`.
+2. Posts a markdown coverage summary (files sorted with the lowest coverage first) as a Pull Request comment, through the git provider sfdx-hardis is set up with (GitHub, GitLab, Azure DevOps, Bitbucket). There is one comment for validations, one for deployments and one for Apex test runs, and each later run updates its comment. The sfdx-hardis comments are left as they are. Set `pullRequestComment` to `false` to only write the reports.
+
+Notes:
+
+- The summary only counts Apex in the project's package directories, so it can differ from the org-wide coverage sfdx-hardis checks.
+- `minCoverage` marks the comment as failing but does not fail the sfdx-hardis command. Use the sfdx-hardis coverage threshold (`apexTestsMinCoverageOrgWide`) to fail the job.
+- A `deploy smart` run with several packages sends one event per package; each one overwrites the reports and the comment, so the last package wins.
+- Turning the sfdx-hardis events off (`disablePluginEvents: true` in `.sfdx-hardis.yml` or `SFDX_HARDIS_DISABLE_PLUGIN_EVENTS=true`) also turns off this plugin in sfdx-hardis commands.
 
 ## Programmatic Usage
 

package/lib/hooks/finally.js

@@ -1,70 +1,51 @@
 'use strict';
 import { existsSync } from 'node:fs';
-import { readFile } from 'node:fs/promises';
 import { resolve } from 'node:path';
 import TransformerTransform from '../commands/acc-transformer/transform.js';
-import { getRepoRoot } from '../utils/getRepoRoot.js';
-function buildCommandArgs(coverageJsonPath, outputReportPath, configFile) {
-    const args = ['--coverage-json', coverageJsonPath, '--output-report', outputReportPath];
-    const coverageFormat = configFile.format || 'sonar';
-    if (coverageFormat.trim() !== '') {
-        for (const format of coverageFormat.split(',')) {
-            args.push('--format', format.replace(/,/g, ''));
-        }
-    }
-    const ignorePackageDirs = configFile.ignorePackageDirectories || '';
-    if (ignorePackageDirs.trim() !== '') {
-        for (const dir of ignorePackageDirs.split(',')) {
-            args.push('--ignore-package-directory', dir.replace(/,/g, ''));
-        }
-    }
-    if (configFile.minCoverage !== undefined) {
-        args.push('--min-coverage', String(configFile.minCoverage));
-    }
-    if (configFile.maxAnnotations !== undefined) {
-        args.push('--max-annotations', String(configFile.maxAnnotations));
-    }
-    const excludePatterns = configFile.excludePatterns ?? '';
-    if (excludePatterns.trim() !== '') {
-        for (const pattern of excludePatterns.split(',')) {
-            args.push('--exclude-pattern', pattern.trim());
-        }
-    }
+import { getHookTransformOptions, isRunningUnderSfdxHardis, loadHookConfig, } from '../utils/hookConfig.js';
+const DEPLOY_COMMANDS = [
+    'project:deploy:validate',
+    'project:deploy:start',
+    'project:deploy:report',
+    'project:deploy:resume',
+];
+const TEST_COMMANDS = ['apex:run:test', 'apex:get:test'];
+function buildCommandArgs(coverageJsonPath, options) {
+    const args = ['--coverage-json', coverageJsonPath, '--output-report', resolve(options.outputReport)];
+    for (const format of options.formats)
+        args.push('--format', format);
+    for (const dir of options.ignorePackageDirectories)
+        args.push('--ignore-package-directory', dir);
+    if (options.minCoverage !== undefined)
+        args.push('--min-coverage', String(options.minCoverage));
+    if (options.maxAnnotations !== undefined)
+        args.push('--max-annotations', String(options.maxAnnotations));
+    for (const pattern of options.excludePatterns)
+        args.push('--exclude-pattern', pattern);
     return args;
 }
 export const hook = async function (options) {
     const commandId = options?.Command?.id ?? '';
     let commandType;
-    if ([
-        'project:deploy:validate',
-        'project:deploy:start',
-        'project:deploy:report',
-        'project:deploy:resume',
-        'hardis:project:deploy:smart',
-    ].includes(commandId)) {
+    if (DEPLOY_COMMANDS.includes(commandId)) {
         commandType = 'deploy';
     }
-    else if (['apex:run:test', 'apex:get:test', 'hardis:org:test:apex'].includes(commandId)) {
+    else if (TEST_COMMANDS.includes(commandId)) {
         commandType = 'test';
     }
     else {
         return;
     }
-    const { repoRoot } = await getRepoRoot();
-    if (!repoRoot) {
+    // An sf command started by sfdx-hardis: the sfdxHardisRunDone hook handles its coverage.
+    if (isRunningUnderSfdxHardis()) {
         return;
     }
-    let configFile;
-    const configPath = resolve(repoRoot, '.apexcodecovtransformer.config.json');
-    try {
-        const jsonString = await readFile(configPath, 'utf-8');
-        configFile = JSON.parse(jsonString);
-    }
-    catch {
+    const loaded = await loadHookConfig();
+    if (!loaded) {
         return;
     }
-    const outputReport = configFile.outputReportPath || 'coverage.xml';
-    const coverageJson = commandType === 'deploy' ? configFile.deployCoverageJsonPath || '.' : configFile.testCoverageJsonPath || '.';
+    const { config } = loaded;
+    const coverageJson = (commandType === 'deploy' ? config.deployCoverageJsonPath : config.testCoverageJsonPath) || '.';
     if (coverageJson.trim() === '.') {
         return;
     }
@@ -72,7 +53,6 @@ export const hook = async function (options) {
     if (!existsSync(coverageJsonPath)) {
         return;
     }
-    const commandArgs = buildCommandArgs(coverageJsonPath, resolve(outputReport), configFile);
-    await TransformerTransform.run(commandArgs);
+    await TransformerTransform.run(buildCommandArgs(coverageJsonPath, getHookTransformOptions(config)));
 };
 //# sourceMappingURL=finally.js.map

package/lib/hooks/finally.js.map

@@ -1 +1 @@
-{"version":3,"file":"finally.js","sourceRoot":"","sources":["../../src/hooks/finally.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"finally.js","sourceRoot":"","sources":["../../src/hooks/finally.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,OAAO,oBAAoB,MAAM,0CAA0C,CAAC;AAC5E,OAAO,EACL,uBAAuB,EAEvB,wBAAwB,EACxB,cAAc,GACf,MAAM,wBAAwB,CAAC;AAEhC,MAAM,eAAe,GAAG;IACtB,yBAAyB;IACzB,sBAAsB;IACtB,uBAAuB;IACvB,uBAAuB;CACxB,CAAC;AACF,MAAM,aAAa,GAAG,CAAC,eAAe,EAAE,eAAe,CAAC,CAAC;AAEzD,SAAS,gBAAgB,CAAC,gBAAwB,EAAE,OAA6B;IAC/E,MAAM,IAAI,GAAa,CAAC,iBAAiB,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC;IAC/G,KAAK,MAAM,MAAM,IAAI,OAAO,CAAC,OAAO;QAAE,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IACpE,KAAK,MAAM,GAAG,IAAI,OAAO,CAAC,wBAAwB;QAAE,IAAI,CAAC,IAAI,CAAC,4BAA4B,EAAE,GAAG,CAAC,CAAC;IACjG,IAAI,OAAO,CAAC,WAAW,KAAK,SAAS;QAAE,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC;IAChG,IAAI,OAAO,CAAC,cAAc,KAAK,SAAS;QAAE,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC;IACzG,KAAK,MAAM,OAAO,IAAI,OAAO,CAAC,eAAe;QAAE,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE,OAAO,CAAC,CAAC;IACvF,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,CAAC,MAAM,IAAI,GAAoB,KAAK,WAAW,OAAO;IAC1D,MAAM,SAAS,GAAG,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC;IAC7C,IAAI,WAA8B,CAAC;IACnC,IAAI,eAAe,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QACxC,WAAW,GAAG,QAAQ,CAAC;IACzB,CAAC;SAAM,IAAI,aAAa,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QAC7C,WAAW,GAAG,MAAM,CAAC;IACvB,CAAC;SAAM,CAAC;QACN,OAAO;IACT,CAAC;IAED,yFAAyF;IACzF,IAAI,wBAAwB,EAAE,EAAE,CAAC;QAC/B,OAAO;IACT,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,cAAc,EAAE,CAAC;IACtC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO;IACT,CAAC;IACD,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;IAE1B,MAAM,YAAY,GAAG,CAAC,WAAW,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,sBAAsB,CAAC,CAAC,CAAC,MAAM,CAAC,oBAAoB,CAAC,IAAI,GAAG,CAAC;IACrH,IAAI,YAAY,CAAC,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;QAChC,OAAO;IACT,CAAC;IAED,MAAM,gBAAgB,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAC/C,IAAI,CAAC,UAAU,CAAC,gBAAgB,CAAC,EAAE,CAAC;QAClC,OAAO;IACT,CAAC;IAED,MAAM,oBAAoB,CAAC,GAAG,CAAC,gBAAgB,CAAC,gBAAgB,EAAE,uBAAuB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;AACtG,CAAC,CAAC"}

package/lib/hooks/prerun.d.ts

@@ -0,0 +1,2 @@
+import { Hook } from '@oclif/core';
+export declare const hook: Hook<'prerun'>;

package/lib/hooks/prerun.js

@@ -0,0 +1,7 @@
+'use strict';
+import { markSfdxHardisParent } from '../utils/hookConfig.js';
+// Flag sfdx-hardis commands so the `sf` commands they start skip the `finally` hook.
+export const hook = async function (options) {
+    markSfdxHardisParent(options?.Command?.id ?? '');
+};
+//# sourceMappingURL=prerun.js.map

package/lib/hooks/prerun.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prerun.js","sourceRoot":"","sources":["../../src/hooks/prerun.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAIb,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAE9D,qFAAqF;AACrF,MAAM,CAAC,MAAM,IAAI,GAAmB,KAAK,WAAW,OAAO;IACzD,oBAAoB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;AACnD,CAAC,CAAC"}

package/lib/hooks/sfdxHardisRunDone.d.ts

@@ -0,0 +1,3 @@
+import { type SfdxHardisEventHookOptions, type SfdxHardisRunEvent } from 'sfdx-hardis/plugin-api';
+declare const hook: (options: SfdxHardisEventHookOptions<SfdxHardisRunEvent>) => Promise<void>;
+export default hook;

package/lib/hooks/sfdxHardisRunDone.js

@@ -0,0 +1,27 @@
+'use strict';
+// Listens to the events sfdx-hardis sends as soon as Salesforce returns the result of a validation,
+// a deployment or an Apex test run (declared under oclif.hooks in package.json). oclif only loads
+// this file when sfdx-hardis fires one of them.
+import { postPullRequestComment, uxLog, } from 'sfdx-hardis/plugin-api';
+import { handleSfdxHardisRunEvent, PLUGIN_NAME } from '../utils/sfdxHardisRunEvent.js';
+const hook = async function (options) {
+    // A failing hook is only a warning for sfdx-hardis, but it must never break the run.
+    try {
+        const outcome = await handleSfdxHardisRunEvent(options, {
+            postPullRequestComment,
+            log: (message) => uxLog('log', null, `[${PLUGIN_NAME}] ${message}`),
+            warn: (message) => uxLog('warning', null, `[${PLUGIN_NAME}] ${message}`),
+        });
+        if (!outcome.handled) {
+            uxLog('log', null, `[${PLUGIN_NAME}] Skipped ${options.event}: ${outcome.reason}`);
+        }
+        else if (!outcome.comment.posted) {
+            uxLog('log', null, `[${PLUGIN_NAME}] No Pull Request comment posted (${outcome.comment.reason ?? 'unknown'})`);
+        }
+    }
+    catch (error) {
+        uxLog('warning', null, `[${PLUGIN_NAME}] ${error.message}`);
+    }
+};
+export default hook;
+//# sourceMappingURL=sfdxHardisRunDone.js.map

package/lib/hooks/sfdxHardisRunDone.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sfdxHardisRunDone.js","sourceRoot":"","sources":["../../src/hooks/sfdxHardisRunDone.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,oGAAoG;AACpG,kGAAkG;AAClG,gDAAgD;AAChD,OAAO,EACL,sBAAsB,EAGtB,KAAK,GACN,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,wBAAwB,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAEvF,MAAM,IAAI,GAAG,KAAK,WAAW,OAAuD;IAClF,qFAAqF;IACrF,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,wBAAwB,CAAC,OAAO,EAAE;YACtD,sBAAsB;YACtB,GAAG,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,WAAW,KAAK,OAAO,EAAE,CAAC;YACnE,IAAI,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,KAAK,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,WAAW,KAAK,OAAO,EAAE,CAAC;SACzE,CAAC,CAAC;QACH,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;YACrB,KAAK,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,WAAW,aAAa,OAAO,CAAC,KAAK,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;QACrF,CAAC;aAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;YACnC,KAAK,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,WAAW,qCAAqC,OAAO,CAAC,OAAO,CAAC,MAAM,IAAI,SAAS,GAAG,CAAC,CAAC;QACjH,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,KAAK,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,WAAW,KAAM,KAAe,CAAC,OAAO,EAAE,CAAC,CAAC;IACzE,CAAC;AACH,CAAC,CAAC;AAEF,eAAe,IAAI,CAAC"}

package/lib/transformers/coverageTransformer.d.ts

@@ -1,5 +1,4 @@
 import { TransformCoverageOptions, TransformCoverageResult, TransformOptions } from '../utils/types.js';
-export { TransformOptions };
 /**
  * Transform Salesforce CLI Apex coverage JSON into one or more report formats.
  *

package/lib/transformers/coverageTransformer.js.map

@@ -1 +1 @@
-{"version":3,"file":"coverageTransformer.js","sourceRoot":"","sources":["../../src/transformers/coverageTransformer.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"coverageTransformer.js","sourceRoot":"","sources":["../../src/transformers/coverageTransformer.ts"],"names":[],"mappings":"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"}

package/lib/utils/hookConfig.d.ts

@@ -0,0 +1,43 @@
+import { CoverageFormat } from './types.js';
+export declare const HOOK_CONFIG_FILE_NAME = ".apexcodecovtransformer.config.json";
+/** Contents of `.apexcodecovtransformer.config.json`. */
+export type HookFile = {
+    deployCoverageJsonPath?: string;
+    testCoverageJsonPath?: string;
+    outputReportPath?: string;
+    format?: string;
+    ignorePackageDirectories?: string;
+    minCoverage?: number;
+    maxAnnotations?: number;
+    excludePatterns?: string;
+    /** sfdx-hardis events only: post the coverage summary as a Pull Request comment. Defaults to true. */
+    pullRequestComment?: boolean;
+};
+/**
+ * Set by the prerun hook while an sfdx-hardis command runs. sfdx-hardis passes its environment to the
+ * `sf` commands it starts (`sf project deploy start`, `sf apex run test`...), so the `finally` hook of
+ * those child commands can leave the coverage to the sfdx-hardis events instead of running twice.
+ */
+export declare const SFDX_HARDIS_PARENT_ENV = "APEX_CODE_COVERAGE_TRANSFORMER_IN_SFDX_HARDIS";
+export declare function markSfdxHardisParent(commandId: string, env?: NodeJS.ProcessEnv): void;
+export declare function isRunningUnderSfdxHardis(env?: NodeJS.ProcessEnv): boolean;
+/** Options shared by every hook, parsed from the comma-separated values of the config file. */
+export type HookTransformOptions = {
+    outputReport: string;
+    formats: CoverageFormat[];
+    ignorePackageDirectories: string[];
+    excludePatterns: string[];
+    minCoverage?: number;
+    maxAnnotations?: number;
+};
+/** Split a comma-separated config value into trimmed, non-empty entries. */
+export declare function splitList(value: string | undefined): string[];
+/**
+ * Load `.apexcodecovtransformer.config.json` from the root of the Salesforce DX project.
+ * Returns undefined when there is no project or no readable config: the hooks are opt-in.
+ */
+export declare function loadHookConfig(cwd?: string): Promise<{
+    repoRoot: string;
+    config: HookFile;
+} | undefined>;
+export declare function getHookTransformOptions(config: HookFile): HookTransformOptions;

package/lib/utils/hookConfig.js

@@ -0,0 +1,58 @@
+'use strict';
+import { readFile } from 'node:fs/promises';
+import { resolve } from 'node:path';
+import { getRepoRoot } from './getRepoRoot.js';
+export const HOOK_CONFIG_FILE_NAME = '.apexcodecovtransformer.config.json';
+/**
+ * Set by the prerun hook while an sfdx-hardis command runs. sfdx-hardis passes its environment to the
+ * `sf` commands it starts (`sf project deploy start`, `sf apex run test`...), so the `finally` hook of
+ * those child commands can leave the coverage to the sfdx-hardis events instead of running twice.
+ */
+export const SFDX_HARDIS_PARENT_ENV = 'APEX_CODE_COVERAGE_TRANSFORMER_IN_SFDX_HARDIS';
+export function markSfdxHardisParent(commandId, env = process.env) {
+    if (commandId.startsWith('hardis:'))
+        env[SFDX_HARDIS_PARENT_ENV] = 'true';
+}
+export function isRunningUnderSfdxHardis(env = process.env) {
+    return env[SFDX_HARDIS_PARENT_ENV] === 'true';
+}
+/** Split a comma-separated config value into trimmed, non-empty entries. */
+export function splitList(value) {
+    return (value ?? '')
+        .split(',')
+        .map((entry) => entry.trim())
+        .filter((entry) => entry !== '');
+}
+/**
+ * Load `.apexcodecovtransformer.config.json` from the root of the Salesforce DX project.
+ * Returns undefined when there is no project or no readable config: the hooks are opt-in.
+ */
+export async function loadHookConfig(cwd) {
+    let repoRoot;
+    try {
+        // getRepoRoot throws when no sfdx-project.json is found, so repoRoot is always set here.
+        repoRoot = (await getRepoRoot(cwd)).repoRoot;
+    }
+    catch {
+        return undefined;
+    }
+    try {
+        const config = JSON.parse(await readFile(resolve(repoRoot, HOOK_CONFIG_FILE_NAME), 'utf-8'));
+        return { repoRoot, config };
+    }
+    catch {
+        return undefined;
+    }
+}
+export function getHookTransformOptions(config) {
+    const formats = splitList(config.format);
+    return {
+        outputReport: config.outputReportPath || 'coverage.xml',
+        formats: (formats.length > 0 ? formats : ['sonar']),
+        ignorePackageDirectories: splitList(config.ignorePackageDirectories),
+        excludePatterns: splitList(config.excludePatterns),
+        minCoverage: config.minCoverage,
+        maxAnnotations: config.maxAnnotations,
+    };
+}
+//# sourceMappingURL=hookConfig.js.map

package/lib/utils/hookConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hookConfig.js","sourceRoot":"","sources":["../../src/utils/hookConfig.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAG/C,MAAM,CAAC,MAAM,qBAAqB,GAAG,qCAAqC,CAAC;AAgB3E;;;;GAIG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,+CAA+C,CAAC;AAEtF,MAAM,UAAU,oBAAoB,CAAC,SAAiB,EAAE,GAAG,GAAsB,OAAO,CAAC,GAAG;IAC1F,IAAI,SAAS,CAAC,UAAU,CAAC,SAAS,CAAC;QAAE,GAAG,CAAC,sBAAsB,CAAC,GAAG,MAAM,CAAC;AAC5E,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,GAAG,GAAsB,OAAO,CAAC,GAAG;IAC3E,OAAO,GAAG,CAAC,sBAAsB,CAAC,KAAK,MAAM,CAAC;AAChD,CAAC;AAYD,4EAA4E;AAC5E,MAAM,UAAU,SAAS,CAAC,KAAyB;IACjD,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC;SACjB,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;SAC5B,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,EAAE,CAAC,CAAC;AACrC,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,GAAY;IAC/C,IAAI,QAAgB,CAAC;IACrB,IAAI,CAAC;QACH,yFAAyF;QACzF,QAAQ,GAAG,CAAC,MAAM,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,QAAkB,CAAC;IACzD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,OAAO,CAAC,QAAQ,EAAE,qBAAqB,CAAC,EAAE,OAAO,CAAC,CAAa,CAAC;QACzG,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;IAC9B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,MAAgB;IACtD,MAAM,OAAO,GAAG,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACzC,OAAO;QACL,YAAY,EAAE,MAAM,CAAC,gBAAgB,IAAI,cAAc;QACvD,OAAO,EAAE,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAqB;QACvE,wBAAwB,EAAE,SAAS,CAAC,MAAM,CAAC,wBAAwB,CAAC;QACpE,eAAe,EAAE,SAAS,CAAC,MAAM,CAAC,eAAe,CAAC;QAClD,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,cAAc,EAAE,MAAM,CAAC,cAAc;KACtC,CAAC;AACJ,CAAC"}

package/lib/utils/sfdxHardisRunEvent.d.ts

@@ -0,0 +1,36 @@
+import type { PluginPullRequestCommentRequest, PluginPullRequestCommentResult, SfdxHardisRunEvent } from 'sfdx-hardis/plugin-api';
+import { TransformCoverageResult } from './types.js';
+export declare const PLUGIN_NAME = "apex-code-coverage-transformer";
+export declare const PULL_REQUEST_COMMENT_TITLE = "Apex code coverage";
+/** GitHub rejects comments over 65536 characters; keep room for the sfdx-hardis wrapper. */
+export declare const MAX_COMMENT_LENGTH = 60000;
+/** One Pull Request comment per kind of run; the next run of the same kind updates it. */
+export declare function getCommentKey(event: Pick<SfdxHardisRunEvent, 'event' | 'data'>): string;
+/** Build the comment body from the markdown report, with the minimum coverage verdict on top. */
+export declare function buildCommentMarkdown(markdownReport: string, result: TransformCoverageResult, minCoverage?: number): string;
+/** Cut at the last full line under the limit, with a note pointing to the full reports. */
+export declare function truncateMarkdown(markdown: string, maxLength: number): string;
+export type SfdxHardisRunEventDeps = {
+    postPullRequestComment: (request: PluginPullRequestCommentRequest) => Promise<PluginPullRequestCommentResult>;
+    log: (message: string) => void;
+    warn: (message: string) => void;
+    /** Directory to search upward from for `sfdx-project.json`. Defaults to `process.cwd()`. */
+    cwd?: string;
+};
+export type SfdxHardisRunEventOutcome = {
+    handled: false;
+    reason: 'no-coverage-file' | 'no-config';
+} | {
+    handled: true;
+    reportPaths: string[];
+    passed: boolean;
+    comment: PluginPullRequestCommentResult | {
+        posted: false;
+        reason: 'disabled';
+    };
+};
+/**
+ * Transform the coverage file sent by an sfdx-hardis run event into the reports set in
+ * `.apexcodecovtransformer.config.json`, then post the coverage summary as a Pull Request comment.
+ */
+export declare function handleSfdxHardisRunEvent(event: Pick<SfdxHardisRunEvent, 'event' | 'data'>, deps: SfdxHardisRunEventDeps): Promise<SfdxHardisRunEventOutcome>;

package/lib/utils/sfdxHardisRunEvent.js

@@ -0,0 +1,81 @@
+'use strict';
+import { resolve } from 'node:path';
+import { transformCoverage } from '../transformers/coverageTransformer.js';
+import { getHookTransformOptions, loadHookConfig } from './hookConfig.js';
+export const PLUGIN_NAME = 'apex-code-coverage-transformer';
+export const PULL_REQUEST_COMMENT_TITLE = 'Apex code coverage';
+/** GitHub rejects comments over 65536 characters; keep room for the sfdx-hardis wrapper. */
+export const MAX_COMMENT_LENGTH = 60_000;
+/** One Pull Request comment per kind of run; the next run of the same kind updates it. */
+export function getCommentKey(event) {
+    if (event.event === 'sfdx-hardis:apex-tests-done')
+        return 'apex-tests';
+    return event.data.checkOnly ? 'validation' : 'deployment';
+}
+/** Build the comment body from the markdown report, with the minimum coverage verdict on top. */
+export function buildCommentMarkdown(markdownReport, result, minCoverage) {
+    // sfdx-hardis renders the comment title, so drop the report's own H1.
+    const report = markdownReport.replace(/^# .*\n+/, '').trim();
+    const percent = (result.summary.lineRate * 100).toFixed(2);
+    const lines = [];
+    if (minCoverage !== undefined) {
+        lines.push(result.passed
+            ? `✅ Coverage of ${percent}% meets the minimum of ${minCoverage}%.`
+            : `❌ Coverage of ${percent}% is below the minimum of ${minCoverage}%.`, '');
+    }
+    lines.push(report, '');
+    lines.push("_Only Apex in this repository's package directories is counted, so this can differ from the org-wide coverage reported by sfdx-hardis._");
+    return truncateMarkdown(lines.join('\n'), MAX_COMMENT_LENGTH);
+}
+/** Cut at the last full line under the limit, with a note pointing to the full reports. */
+export function truncateMarkdown(markdown, maxLength) {
+    if (markdown.length <= maxLength)
+        return markdown;
+    const note = '\n\n_Truncated: see the coverage reports of the job for every file._';
+    const cut = markdown.lastIndexOf('\n', maxLength - note.length);
+    return `${markdown.slice(0, cut > 0 ? cut : maxLength - note.length)}${note}`;
+}
+/**
+ * Transform the coverage file sent by an sfdx-hardis run event into the reports set in
+ * `.apexcodecovtransformer.config.json`, then post the coverage summary as a Pull Request comment.
+ */
+export async function handleSfdxHardisRunEvent(event, deps) {
+    const { coverageFile } = event.data;
+    if (!coverageFile)
+        return { handled: false, reason: 'no-coverage-file' };
+    const loaded = await loadHookConfig(deps.cwd);
+    if (!loaded)
+        return { handled: false, reason: 'no-config' };
+    const options = getHookTransformOptions(loaded.config);
+    const base = {
+        inputs: [coverageFile],
+        cwd: deps.cwd,
+        ignorePackageDirectories: options.ignorePackageDirectories,
+        excludePatterns: options.excludePatterns,
+        minCoverage: options.minCoverage,
+        maxAnnotations: options.maxAnnotations,
+    };
+    const result = await transformCoverage({
+        ...base,
+        formats: options.formats,
+        outputReport: resolve(deps.cwd ?? process.cwd(), options.outputReport),
+    });
+    const reportPaths = result.reports.map((report) => report.path);
+    deps.log(`The coverage report has been written to: ${reportPaths.join(', ')}`);
+    for (const warning of result.warnings)
+        deps.warn(warning);
+    if (loaded.config.pullRequestComment === false) {
+        return { handled: true, reportPaths, passed: result.passed, comment: { posted: false, reason: 'disabled' } };
+    }
+    const markdownReport = result.reports.find((report) => report.format === 'markdown')?.content ??
+        (await transformCoverage({ ...base, formats: ['markdown'], write: false })).reports[0].content;
+    const comment = await deps.postPullRequestComment({
+        pluginName: PLUGIN_NAME,
+        messageKey: getCommentKey(event),
+        title: PULL_REQUEST_COMMENT_TITLE,
+        markdown: buildCommentMarkdown(markdownReport, result, options.minCoverage),
+        status: result.passed ? 'valid' : 'invalid',
+    });
+    return { handled: true, reportPaths, passed: result.passed, comment };
+}
+//# sourceMappingURL=sfdxHardisRunEvent.js.map

package/lib/utils/sfdxHardisRunEvent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sfdxHardisRunEvent.js","sourceRoot":"","sources":["../../src/utils/sfdxHardisRunEvent.ts"],"names":[],"mappings":"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"}

package/lib/utils/types.d.ts

@@ -137,16 +137,6 @@ export type SonarCoverageObject = {
         '@version': string;
     };
 };
-export type HookFile = {
-    deployCoverageJsonPath: string;
-    testCoverageJsonPath: string;
-    outputReportPath: string;
-    format: string;
-    ignorePackageDirectories: string;
-    minCoverage?: number;
-    maxAnnotations?: number;
-    excludePatterns?: string;
-};
 export type CoberturaLine = {
     '@number': number;
     '@hits': number;

package/oclif.manifest.json

@@ -130,5 +130,5 @@
       ]
     }
   },
-  "version": "4.3.0"
+  "version": "5.0.0"
 }

package/package.json

@@ -1,11 +1,12 @@
 {
   "name": "apex-code-coverage-transformer",
   "description": "Transform Salesforce Apex code coverage JSON for SonarQube, SonarCloud, GitHub, GitLab, Azure, and Bitbucket",
-  "version": "4.3.0",
+  "version": "5.0.0",
   "dependencies": {
     "@oclif/core": "5.1.11",
     "@salesforce/core": "9.4.4",
-    "@salesforce/sf-plugins-core": "13.0.8"
+    "@salesforce/sf-plugins-core": "13.0.8",
+    "sfdx-hardis": "8.24.1-beta202611122321.0"
   },
   "devDependencies": {
     "@actions/core": "3.0.1",
@@ -31,7 +32,7 @@
     "wireit": "0.15.0"
   },
   "engines": {
-    "node": ">=22.19.0"
+    "node": ">=22.22.2"
   },
   "files": [
     "/lib",
@@ -78,7 +79,11 @@
       }
     },
     "hooks": {
-      "finally": "./lib/hooks/finally"
+      "prerun": "./lib/hooks/prerun",
+      "finally": "./lib/hooks/finally",
+      "sfdx-hardis:validation-done": "./lib/hooks/sfdxHardisRunDone",
+      "sfdx-hardis:deployment-done": "./lib/hooks/sfdxHardisRunDone",
+      "sfdx-hardis:apex-tests-done": "./lib/hooks/sfdxHardisRunDone"
     },
     "devPlugins": [
       "@oclif/plugin-help"