apex-mutation-testing 1.0.0-dev-6.13527894120-1

package/LICENSE.md

@@ -0,0 +1,9 @@
+MIT License
+
+Copyright (c) 2025 Sebastien Colladon
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -0,0 +1,143 @@
+# Apex Mutation Testing
+
+[![NPM](https://img.shields.io/npm/v/apex-mutation-testing.svg?label=apex-mutation-testing)](https://www.npmjs.com/package/apex-mutation-testing) [![Downloads/week](https://img.shields.io/npm/dw/apex-mutation-testing.svg)](https://npmjs.org/package/apex-mutation-testing) [![License](https://img.shields.io/badge/License-BSD%203--Clause-brightgreen.svg)](https://raw.githubusercontent.com/salesforcecli/apex-mutation-testing/main/LICENSE.txt)
+![GitHub Sponsors](https://img.shields.io/github/sponsors/scolladon)
+
+## Disclaimer
+
+This project is in its early stages and requires further development and testing.
+It provides a solid foundation for implementing additional features and improvements.
+You are welcome to contribute by logging issue, proposing enhancements or pull requests.
+
+## TL;DR
+
+```sh
+sf plugins install apex-mutation-testing
+```
+
+```sh
+sf apex mutation test run --class-file MyClass --test-file MyClassTest
+```
+
+## What is it mutation testing ?
+
+Mutation testing is a software testing technique that evaluates the quality of your test suite by introducing small changes (mutations) to your code and checking if your tests can detect these changes. It helps identify weaknesses in your test coverage by measuring how effectively your tests can catch intentional bugs. cf [wikipedia](https://en.wikipedia.org/wiki/Mutation_testing)
+
+The apex-mutation-testing plugin implements this technique for Salesforce Apex code by:
+
+1. Parsing your Apex class to identify potential mutation points
+2. Generating mutated versions of your code with specific changes
+3. Deploying each mutated version to a Salesforce org
+4. Running your test class against each mutation
+5. Analyzing the results to determine if your tests:
+    - Detected the mutation (killed the mutant)
+    - Failed to detect the mutation (created a zombie)
+    - Caused a test failure unrelated to the mutation
+6. Generating a detailed report showing mutation coverage and test effectiveness
+
+This process helps you identify areas where your tests may be insufficient and provides insights into improving your test quality.
+
+cf this [idea](https://ideas.salesforce.com/s/idea/a0B8W00000GdmxmUAB/use-mutation-testing-to-stop-developers-from-cheating-on-apex-tests) for more information about the community appetit
+
+## How to use it?
+
+Fast unit tests are crucial for mutation testing as each detected mutation is deployed and tested individually. The plugin generates numerous mutations, and having quick-running tests allows for:
+1. Efficient execution of the mutation testing process
+2. Faster feedback on test coverage quality
+3. Ability to test more mutations within time constraints
+4. Reduced resource consumption during testing
+5. More iterations and improvements in test quality
+
+The more the test interacts with the database (dml or soql) the more times the test will take
+
+### Test Coverage Requirements
+
+To maximize the benefits of mutation testing, your test class should have very high code coverage (ideally 100%). Here's why:
+
+1. **Mutation Detection**: Mutations can only be detected in code that is executed by your tests. Uncovered code means undetectable mutations.
+
+2. **Accurate Metrics**: High coverage ensures the mutation score accurately reflects your test suite's effectiveness.
+
+3. **Meaningful Results**: With high coverage, the mutation test results provide actionable insights about your test quality.
+
+Before running mutation testing:
+- Ensure your test class achieves maximum coverage
+- Verify all critical paths are tested
+- Include edge case scenarios
+- Validate test assertions are comprehensive
+
+Remember, mutation testing complements but doesn't replace good test coverage. It helps identify weaknesses in your existing tests, but only for the code they already cover.
+
+<!-- commands -->
+* [`sf apex mutation test run`](#sf-apex-mutation-test-run)
+
+## `sf apex mutation test run`
+
+Evaluate test coverage quality by injecting mutations and measuring test detection rates
+
+```
+USAGE
+  $ sf apex mutation test run -c <value> -t <value> -o <value> [--json] [--flags-dir <value>] [-r <value>] [--api-version
+    <value>]
+
+FLAGS
+  -c, --apex-class=<value>   (required) Apex class name to mutate
+  -o, --target-org=<value>   (required) Username or alias of the target org. Not required if the `target-org`
+                             configuration variable is already set.
+  -r, --report-dir=<value>   [default: mutations] Path to the directory where mutation test reports will be generated
+  -t, --test-class=<value>   (required) Apex test class name to validate mutations
+      --api-version=<value>  Override the api version used for api requests made by this command
+
+GLOBAL FLAGS
+  --flags-dir=<value>  Import flag values from a directory.
+  --json               Format output as json.
+
+DESCRIPTION
+  Evaluate test coverage quality by injecting mutations and measuring test detection rates
+
+  The Apex Mutation Testing plugin helps evaluate the effectiveness of your Apex test classes by introducing mutations
+  into your code and checking if your tests can detect these changes:
+
+  The plugin provides insights into how trustworthy your test suite is by measuring its ability to catch intentional
+  code changes.
+
+EXAMPLES
+  Run mutation testing on a class with its test file:
+
+    $ sf apex mutation test run --class-file MyClass --test-file MyClassTest
+```
+<!-- commandsstop -->
+
+## Backlog
+
+- **Expand Mutation Types**: Add more mutation operators to test different code patterns
+- **Smart Mutation Detection**: Implement logic to identify relevant mutations for specific code contexts
+- **Coverage Analysis**: Detect untested code paths that mutations won't affect
+- **Performance Optimization**: Add CPU time monitoring to fail fast on non ending mutation
+- **Better Configurability**: Pass threashold and use more information from test class
+- **Additional Features**: Explore other mutation testing enhancements and quality metrics
+
+## Changelog
+
+[changelog.md](CHANGELOG.md) is available for consultation.
+
+## Versioning
+
+Versioning follows [SemVer](http://semver.org/) specification.
+
+## Authors
+
+- **Sebastien Colladon** - Developer - [scolladon](https://github.com/scolladon)
+
+Special thanks to **Sara Sali** for her [presentation at Dreamforce](https://www.youtube.com/watch?v=8PjzrTaNNns) about apex mutation testing
+This repository is basically a port of her idea / repo to a sf plugin.
+
+## Contributing
+
+Contributions are what make the trailblazer community such an amazing place. I regard this component as a way to inspire and learn from others. Any contributions you make are **appreciated**.
+
+See [contributing.md](CONTRIBUTING.md) for sgd contribution principles.
+
+## License
+
+This project license is MIT - see the [LICENSE.md](LICENSE.md) file for details

package/lib/adapter/apexClassRepository.d.ts

@@ -0,0 +1,10 @@
+import { Connection } from '@salesforce/core';
+import { ApexClass } from '../type/ApexClass.js';
+export declare class ApexClassRepository {
+    protected readonly connection: Connection;
+    constructor(connection: Connection);
+    read(name: string): Promise<{
+        [name: string]: import("@jsforce/jsforce-node").SObjectFieldType | null;
+    } & import("@jsforce/jsforce-node").Record>;
+    update(apexClass: ApexClass): Promise<import("@jsforce/jsforce-node").SaveResult>;
+}

package/lib/adapter/apexClassRepository.js

@@ -0,0 +1,34 @@
+export class ApexClassRepository {
+    connection;
+    constructor(connection) {
+        this.connection = connection;
+    }
+    async read(name) {
+        return (await this.connection.tooling
+            .sobject('ApexClass')
+            .find({ Name: name })
+            .execute())[0];
+    }
+    async update(apexClass) {
+        const container = await this.connection.tooling
+            .sobject('MetadataContainer')
+            .create({
+            Name: `MutationTest_${Date.now()}`,
+        });
+        // Create ApexClassMember for the mutated version
+        await this.connection.tooling.sobject('ApexClassMember').create({
+            MetadataContainerId: container.id,
+            ContentEntityId: apexClass.Id,
+            Body: apexClass.Body,
+        });
+        // Create ContainerAsyncRequest to deploy
+        return await this.connection.tooling
+            .sobject('ContainerAsyncRequest')
+            .create({
+            IsCheckOnly: false,
+            MetadataContainerId: container.id,
+            IsRunTests: true,
+        });
+    }
+}
+//# sourceMappingURL=apexClassRepository.js.map

package/lib/adapter/apexClassRepository.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"apexClassRepository.js","sourceRoot":"","sources":["../../src/adapter/apexClassRepository.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,mBAAmB;IACC;IAA/B,YAA+B,UAAsB;QAAtB,eAAU,GAAV,UAAU,CAAY;IAAG,CAAC;IAElD,KAAK,CAAC,IAAI,CAAC,IAAY;QAC5B,OAAO,CACL,MAAM,IAAI,CAAC,UAAU,CAAC,OAAO;aAC1B,OAAO,CAAC,WAAW,CAAC;aACpB,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;aACpB,OAAO,EAAE,CACb,CAAC,CAAC,CAAC,CAAA;IACN,CAAC;IAEM,KAAK,CAAC,MAAM,CAAC,SAAoB;QACtC,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,OAAO;aAC5C,OAAO,CAAC,mBAAmB,CAAC;aAC5B,MAAM,CAAC;YACN,IAAI,EAAE,gBAAgB,IAAI,CAAC,GAAG,EAAE,EAAE;SACnC,CAAC,CAAA;QAEJ,iDAAiD;QACjD,MAAM,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC,MAAM,CAAC;YAC9D,mBAAmB,EAAE,SAAS,CAAC,EAAE;YACjC,eAAe,EAAE,SAAS,CAAC,EAAE;YAC7B,IAAI,EAAE,SAAS,CAAC,IAAI;SACrB,CAAC,CAAA;QAEF,yCAAyC;QACzC,OAAO,MAAM,IAAI,CAAC,UAAU,CAAC,OAAO;aACjC,OAAO,CAAC,uBAAuB,CAAC;aAChC,MAAM,CAAC;YACN,WAAW,EAAE,KAAK;YAClB,mBAAmB,EAAE,SAAS,CAAC,EAAE;YACjC,UAAU,EAAE,IAAI;SACjB,CAAC,CAAA;IACN,CAAC;CACF"}

package/lib/adapter/apexTestRunner.d.ts

@@ -0,0 +1,7 @@
+import { TestResult, TestService } from '@salesforce/apex-node';
+import { Connection } from '@salesforce/core';
+export declare class ApexTestRunner {
+    protected readonly testService: TestService;
+    constructor(connection: Connection);
+    run(className: string): Promise<TestResult>;
+}

package/lib/adapter/apexTestRunner.js

@@ -0,0 +1,16 @@
+import { TestService } from '@salesforce/apex-node';
+export class ApexTestRunner {
+    testService;
+    constructor(connection) {
+        this.testService = new TestService(connection);
+    }
+    async run(className) {
+        return (await this.testService.runTestAsynchronous({
+            tests: [{ className }],
+            testLevel: "RunSpecifiedTests" /* TestLevel.RunSpecifiedTests */,
+            skipCodeCoverage: true,
+            maxFailedTests: 0,
+        }));
+    }
+}
+//# sourceMappingURL=apexTestRunner.js.map

package/lib/adapter/apexTestRunner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"apexTestRunner.js","sourceRoot":"","sources":["../../src/adapter/apexTestRunner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyB,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAG1E,MAAM,OAAO,cAAc;IACN,WAAW,CAAa;IAC3C,YAAY,UAAsB;QAChC,IAAI,CAAC,WAAW,GAAG,IAAI,WAAW,CAAC,UAAU,CAAC,CAAA;IAChD,CAAC;IAEM,KAAK,CAAC,GAAG,CAAC,SAAiB;QAChC,OAAO,CAAC,MAAM,IAAI,CAAC,WAAW,CAAC,mBAAmB,CAAC;YACjD,KAAK,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC;YACtB,SAAS,uDAA6B;YACtC,gBAAgB,EAAE,IAAI;YACtB,cAAc,EAAE,CAAC;SAClB,CAAC,CAAe,CAAA;IACnB,CAAC;CACF"}

package/lib/commands/apex/mutation/test/run.d.ts

@@ -0,0 +1,17 @@
+import { SfCommand } from '@salesforce/sf-plugins-core';
+export type ApexMutationTestResult = {
+    score: number;
+};
+export default class ApexMutationTest extends SfCommand<ApexMutationTestResult> {
+    static readonly summary: string;
+    static readonly description: string;
+    static readonly examples: string[];
+    static readonly flags: {
+        'apex-class': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        'test-class': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        'report-dir': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        'target-org': import("@oclif/core/interfaces").OptionFlag<import("@salesforce/core").Org, import("@oclif/core/interfaces").CustomOptions>;
+        'api-version': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<ApexMutationTestResult>;
+}

package/lib/commands/apex/mutation/test/run.js

@@ -0,0 +1,55 @@
+import { Messages } from '@salesforce/core';
+import { Flags, SfCommand } from '@salesforce/sf-plugins-core';
+import { ApexMutationHTMLReporter } from '../../../../reporter/HTMLReporter.js';
+import { MutationTestingService } from '../../../../service/mutationTestingService.js';
+Messages.importMessagesDirectoryFromMetaUrl(import.meta.url);
+const messages = Messages.loadMessages('apex-mutation-testing', 'apex.mutation.test.run');
+export default class ApexMutationTest extends SfCommand {
+    static summary = messages.getMessage('summary');
+    static description = messages.getMessage('description');
+    static examples = messages.getMessages('examples');
+    static flags = {
+        'apex-class': Flags.string({
+            char: 'c',
+            summary: messages.getMessage('flags.apex-class.summary'),
+            required: true,
+        }),
+        'test-class': Flags.string({
+            char: 't',
+            summary: messages.getMessage('flags.test-class.summary'),
+            required: true,
+        }),
+        'report-dir': Flags.directory({
+            char: 'r',
+            summary: messages.getMessage('flags.report-dir.summary'),
+            exists: true,
+            default: 'mutations',
+        }),
+        'target-org': Flags.requiredOrg(),
+        'api-version': Flags.orgApiVersion(),
+    };
+    async run() {
+        // parse the provided flags
+        const { flags } = await this.parse(ApexMutationTest);
+        const connection = flags['target-org'].getConnection(flags['api-version']);
+        this.log(messages.getMessage('info.CommandIsRunning', [
+            flags['apex-class'],
+            flags['test-class'],
+        ]));
+        const mutationTestingService = new MutationTestingService(this.progress, this.spinner, connection, {
+            apexClassName: flags['apex-class'],
+            apexClassTestName: flags['test-class'],
+        });
+        const mutationResult = await mutationTestingService.process();
+        const htmlReporter = new ApexMutationHTMLReporter();
+        await htmlReporter.generateReport(mutationResult, flags['report-dir']);
+        this.log(messages.getMessage('info.reportGenerated', [flags['report-dir']]));
+        const score = mutationTestingService.calculateScore(mutationResult);
+        this.log(messages.getMessage('info.CommandSuccess', [score]));
+        this.info(messages.getMessage('info.EncourageSponsorship'));
+        return {
+            score,
+        };
+    }
+}
+//# sourceMappingURL=run.js.map

package/lib/commands/apex/mutation/test/run.js.map

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

package/lib/mutator/baseListener.d.ts

@@ -0,0 +1,5 @@
+import { ApexParserListener } from 'apex-parser';
+import { ApexMutation } from '../type/ApexMutation.js';
+export declare class BaseListener implements ApexParserListener {
+    _mutations: ApexMutation[];
+}

package/lib/mutator/baseListener.js

@@ -0,0 +1,5 @@
+// @ts-ignore: Base type with just a common _mutations property
+export class BaseListener {
+    _mutations = [];
+}
+//# sourceMappingURL=baseListener.js.map

package/lib/mutator/baseListener.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"baseListener.js","sourceRoot":"","sources":["../../src/mutator/baseListener.ts"],"names":[],"mappings":"AAGA,+DAA+D;AAC/D,MAAM,OAAO,YAAY;IACvB,UAAU,GAAmB,EAAE,CAAA;CAChC"}

package/lib/mutator/boundaryConditionMutator.d.ts

@@ -0,0 +1,6 @@
+import { BaseListener } from './baseListener.js';
+import { ParserRuleContext } from 'antlr4ts';
+export declare class BoundaryConditionMutator extends BaseListener {
+    private REPLACEMENT_MAP;
+    enterParExpression(ctx: ParserRuleContext): void;
+}

package/lib/mutator/boundaryConditionMutator.js

@@ -0,0 +1,33 @@
+import { BaseListener } from './baseListener.js';
+import { TerminalNode } from 'antlr4ts/tree/index.js';
+export class BoundaryConditionMutator extends BaseListener {
+    REPLACEMENT_MAP = {
+        '!=': '==',
+        '==': '!=',
+        '<': '<=',
+        '<=': '<',
+        '>': '>=',
+        '>=': '>',
+        '===': '!==',
+        '!==': '===',
+    };
+    // Target rule
+    // expression: expression ('<=' | '>=' | '>' | '<') expression
+    enterParExpression(ctx) {
+        if (ctx.childCount === 3) {
+            const symbol = ctx.getChild(1).getChild(1);
+            if (symbol instanceof TerminalNode) {
+                const symbolText = symbol.text;
+                const replacement = this.REPLACEMENT_MAP[symbolText];
+                if (replacement) {
+                    this._mutations.push({
+                        mutationName: this.constructor.name,
+                        token: symbol,
+                        replacement,
+                    });
+                }
+            }
+        }
+    }
+}
+//# sourceMappingURL=boundaryConditionMutator.js.map

package/lib/mutator/boundaryConditionMutator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"boundaryConditionMutator.js","sourceRoot":"","sources":["../../src/mutator/boundaryConditionMutator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAGhD,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAA;AAErD,MAAM,OAAO,wBAAyB,SAAQ,YAAY;IAChD,eAAe,GAA2B;QAChD,IAAI,EAAE,IAAI;QACV,IAAI,EAAE,IAAI;QACV,GAAG,EAAE,IAAI;QACT,IAAI,EAAE,GAAG;QACT,GAAG,EAAE,IAAI;QACT,IAAI,EAAE,GAAG;QACT,KAAK,EAAE,KAAK;QACZ,KAAK,EAAE,KAAK;KACb,CAAA;IAED,cAAc;IACd,8DAA8D;IAC9D,kBAAkB,CAAC,GAAsB;QACvC,IAAI,GAAG,CAAC,UAAU,KAAK,CAAC,EAAE,CAAC;YACzB,MAAM,MAAM,GAAG,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAA;YAC1C,IAAI,MAAM,YAAY,YAAY,EAAE,CAAC;gBACnC,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAA;gBAC9B,MAAM,WAAW,GAAG,IAAI,CAAC,eAAe,CAAC,UAAU,CAAC,CAAA;gBACpD,IAAI,WAAW,EAAE,CAAC;oBAChB,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;wBACnB,YAAY,EAAE,IAAI,CAAC,WAAW,CAAC,IAAI;wBACnC,KAAK,EAAE,MAAM;wBACb,WAAW;qBACZ,CAAC,CAAA;gBACJ,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;CACF"}

package/lib/mutator/incrementMutator.d.ts

@@ -0,0 +1,8 @@
+import { BaseListener } from './baseListener.js';
+import { ParserRuleContext } from 'antlr4ts';
+export declare class IncrementMutator extends BaseListener {
+    private REPLACEMENT_MAP;
+    enterPostOpExpression(ctx: ParserRuleContext): void;
+    enterPreOpExpression(ctx: ParserRuleContext): void;
+    private processOperation;
+}

package/lib/mutator/incrementMutator.js

@@ -0,0 +1,37 @@
+import { BaseListener } from './baseListener.js';
+import { TerminalNode } from 'antlr4ts/tree/index.js';
+export class IncrementMutator extends BaseListener {
+    REPLACEMENT_MAP = {
+        '++': '--',
+        '--': '++',
+    };
+    // Target rule
+    // expression :
+    //  | expression ('++' | '--')
+    //  | ('+' | '-' | '++' | '--') expression
+    enterPostOpExpression(ctx) {
+        this.processOperation(ctx);
+    }
+    enterPreOpExpression(ctx) {
+        this.processOperation(ctx);
+    }
+    processOperation(ctx) {
+        if (ctx.childCount === 2) {
+            let symbol = null;
+            if (ctx.getChild(0) instanceof TerminalNode) {
+                symbol = ctx.getChild(0);
+            }
+            else if (ctx.getChild(1) instanceof TerminalNode) {
+                symbol = ctx.getChild(1);
+            }
+            if (symbol !== null && symbol.text in this.REPLACEMENT_MAP) {
+                this._mutations.push({
+                    mutationName: this.constructor.name,
+                    token: symbol,
+                    replacement: this.REPLACEMENT_MAP[symbol.text],
+                });
+            }
+        }
+    }
+}
+//# sourceMappingURL=incrementMutator.js.map

package/lib/mutator/incrementMutator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"incrementMutator.js","sourceRoot":"","sources":["../../src/mutator/incrementMutator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAGhD,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAA;AAErD,MAAM,OAAO,gBAAiB,SAAQ,YAAY;IACxC,eAAe,GAA2B;QAChD,IAAI,EAAE,IAAI;QACV,IAAI,EAAE,IAAI;KACX,CAAA;IAED,cAAc;IACd,eAAe;IACf,8BAA8B;IAC9B,0CAA0C;IAC1C,qBAAqB,CAAC,GAAsB;QAC1C,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAA;IAC5B,CAAC;IAED,oBAAoB,CAAC,GAAsB;QACzC,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAA;IAC5B,CAAC;IAEO,gBAAgB,CAAC,GAAsB;QAC7C,IAAI,GAAG,CAAC,UAAU,KAAK,CAAC,EAAE,CAAC;YACzB,IAAI,MAAM,GAAwB,IAAI,CAAA;YACtC,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,YAAY,YAAY,EAAE,CAAC;gBAC5C,MAAM,GAAG,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAiB,CAAA;YAC1C,CAAC;iBAAM,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,YAAY,YAAY,EAAE,CAAC;gBACnD,MAAM,GAAG,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAiB,CAAA;YAC1C,CAAC;YAED,IAAI,MAAM,KAAK,IAAI,IAAI,MAAM,CAAC,IAAI,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;gBAC3D,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;oBACnB,YAAY,EAAE,IAAI,CAAC,WAAW,CAAC,IAAI;oBACnC,KAAK,EAAE,MAAM;oBACb,WAAW,EAAE,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,IAAI,CAAC;iBAC/C,CAAC,CAAA;YACJ,CAAC;QACH,CAAC;IACH,CAAC;CACF"}

package/lib/mutator/mutationListener.d.ts

@@ -0,0 +1,9 @@
+import { ApexMutation } from '../type/ApexMutation.js';
+import { BaseListener } from './baseListener.js';
+import { ApexParserListener } from 'apex-parser';
+export declare class MutationListener implements ApexParserListener {
+    private listeners;
+    _mutations: ApexMutation[];
+    getMutations(): ApexMutation[];
+    constructor(listeners: BaseListener[]);
+}

package/lib/mutator/mutationListener.js

@@ -0,0 +1,36 @@
+// @ts-ignore: Just a proxy doing accumulation of mutations
+export class MutationListener {
+    listeners;
+    _mutations = [];
+    getMutations() {
+        return this._mutations;
+    }
+    constructor(listeners) {
+        this.listeners = listeners;
+        // Share mutations array across all listeners
+        this.listeners
+            .filter(listener => '_mutations' in listener)
+            .forEach(listener => {
+            ;
+            listener._mutations = this._mutations;
+        });
+        // Create a proxy that automatically forwards all method calls to listeners
+        return new Proxy(this, {
+            get: (target, prop) => {
+                if (prop in target) {
+                    return target[prop];
+                }
+                // Return a function that calls the method on all listeners that have it
+                return (...args) => {
+                    this.listeners.forEach(listener => {
+                        if (prop in listener && typeof listener[prop] === 'function') {
+                            ;
+                            listener[prop].apply(listener, args);
+                        }
+                    });
+                };
+            },
+        });
+    }
+}
+//# sourceMappingURL=mutationListener.js.map

package/lib/mutator/mutationListener.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mutationListener.js","sourceRoot":"","sources":["../../src/mutator/mutationListener.ts"],"names":[],"mappings":"AAKA,2DAA2D;AAC3D,MAAM,OAAO,gBAAgB;IACnB,SAAS,CAAgB;IACjC,UAAU,GAAmB,EAAE,CAAA;IAExB,YAAY;QACjB,OAAO,IAAI,CAAC,UAAU,CAAA;IACxB,CAAC;IAED,YAAY,SAAyB;QACnC,IAAI,CAAC,SAAS,GAAG,SAAS,CAAA;QAC1B,6CAA6C;QAC7C,IAAI,CAAC,SAAS;aACX,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,YAAY,IAAI,QAAQ,CAAC;aAC5C,OAAO,CAAC,QAAQ,CAAC,EAAE;YAClB,CAAC;YAAC,QAAyB,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAA;QAC1D,CAAC,CAAC,CAAA;QAEJ,2EAA2E;QAC3E,OAAO,IAAI,KAAK,CAAC,IAAI,EAAE;YACrB,GAAG,EAAE,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE;gBACpB,IAAI,IAAI,IAAI,MAAM,EAAE,CAAC;oBACnB,OAAO,MAAM,CAAC,IAAI,CAAC,CAAA;gBACrB,CAAC;gBAED,wEAAwE;gBACxE,OAAO,CAAC,GAAG,IAAQ,EAAE,EAAE;oBACrB,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE;wBAChC,IAAI,IAAI,IAAI,QAAQ,IAAI,OAAO,QAAQ,CAAC,IAAI,CAAC,KAAK,UAAU,EAAE,CAAC;4BAC7D,CAAC;4BAAC,QAAQ,CAAC,IAAI,CAAc,CAAC,KAAK,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAA;wBACrD,CAAC;oBACH,CAAC,CAAC,CAAA;gBACJ,CAAC,CAAA;YACH,CAAC;SACF,CAAC,CAAA;IACJ,CAAC;CACF"}

package/lib/reporter/HTMLReporter.d.ts

@@ -0,0 +1,5 @@
+import { ApexMutationTestResult } from '../type/ApexMutationTestResult.js';
+export declare class ApexMutationHTMLReporter {
+    generateReport(apexMutationTestResult: ApexMutationTestResult, outputDir?: string): Promise<void>;
+    private transformApexResults;
+}

package/lib/reporter/HTMLReporter.js

@@ -0,0 +1,75 @@
+import { writeFile } from 'node:fs/promises';
+import * as path from 'path';
+export class ApexMutationHTMLReporter {
+    async generateReport(apexMutationTestResult, outputDir = 'reports') {
+        const reportData = this.transformApexResults(apexMutationTestResult);
+        // Generate and write the HTML file with the report data embedded
+        const htmlContent = createReportHtml(reportData);
+        await writeFile(path.join(outputDir, 'index.html'), htmlContent);
+    }
+    transformApexResults(apexMutationTestResult) {
+        const mutationTestResult = {
+            schemaVersion: '2.0.0',
+            config: {}, // You can add your configuration here
+            thresholds: {
+                high: 80,
+                low: 60,
+            },
+            files: {},
+        };
+        const fileResult = {
+            language: 'java',
+            source: apexMutationTestResult.sourceFileContent,
+            mutants: apexMutationTestResult.mutants.map(mutant => ({
+                id: mutant.id,
+                mutatorName: mutant.mutatorName,
+                replacement: mutant.replacement,
+                status: mutant.status,
+                static: false,
+                coveredBy: ['0'],
+                killedBy: mutant.status === 'Killed' ? ['0'] : undefined,
+                testsCompleted: 1,
+                location: {
+                    start: {
+                        line: mutant.location.start.line,
+                        column: mutant.location.start.column,
+                    },
+                    end: {
+                        line: mutant.location.end.line,
+                        column: mutant.location.end.column,
+                    },
+                },
+            })),
+        };
+        mutationTestResult.files[`${apexMutationTestResult.sourceFile}.java`] =
+            fileResult;
+        return mutationTestResult;
+    }
+}
+const createReportHtml = report => {
+    return `<!DOCTYPE html>
+  <html>
+  <head>
+    <meta charset="utf-8">
+    <script src="https://cdn.jsdelivr.net/npm/mutation-testing-elements@3.5.1/dist/mutation-test-elements.min.js"></script>
+  </head>
+  <body>
+    <mutation-test-report-app titlePostfix="apex-mutation-testing">
+      Your browser doesn't support <a href="https://caniuse.com/#search=custom%20elements">custom elements</a>.
+      Please use a latest version of an evergreen browser (Firefox, Chrome, Safari, Opera, Edge, etc).
+    </mutation-test-report-app>
+    <script>
+      const app = document.querySelector('mutation-test-report-app');
+      app.report = ${escapeHtmlTags(JSON.stringify(report))};
+    </script>
+  </body>
+  </html>`;
+};
+/**
+ * Escapes the HTML tags inside strings in a JSON input by breaking them apart.
+ */
+function escapeHtmlTags(json) {
+    const j = json.replace(/</g, '<"+"');
+    return j;
+}
+//# sourceMappingURL=HTMLReporter.js.map

package/lib/reporter/HTMLReporter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HTMLReporter.js","sourceRoot":"","sources":["../../src/reporter/HTMLReporter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAC5C,OAAO,KAAK,IAAI,MAAM,MAAM,CAAA;AAG5B,MAAM,OAAO,wBAAwB;IACnC,KAAK,CAAC,cAAc,CAClB,sBAA8C,EAC9C,YAAoB,SAAS;QAE7B,MAAM,UAAU,GAAG,IAAI,CAAC,oBAAoB,CAAC,sBAAsB,CAAC,CAAA;QACpE,iEAAiE;QACjE,MAAM,WAAW,GAAG,gBAAgB,CAAC,UAAU,CAAC,CAAA;QAChD,MAAM,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,YAAY,CAAC,EAAE,WAAW,CAAC,CAAA;IAClE,CAAC;IAEO,oBAAoB,CAAC,sBAA8C;QACzE,MAAM,kBAAkB,GAAG;YACzB,aAAa,EAAE,OAAO;YACtB,MAAM,EAAE,EAAE,EAAE,sCAAsC;YAClD,UAAU,EAAE;gBACV,IAAI,EAAE,EAAE;gBACR,GAAG,EAAE,EAAE;aACR;YACD,KAAK,EAAE,EAAE;SACV,CAAA;QAED,MAAM,UAAU,GAAG;YACjB,QAAQ,EAAE,MAAM;YAChB,MAAM,EAAE,sBAAsB,CAAC,iBAAiB;YAChD,OAAO,EAAE,sBAAsB,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;gBACrD,EAAE,EAAE,MAAM,CAAC,EAAE;gBACb,WAAW,EAAE,MAAM,CAAC,WAAW;gBAC/B,WAAW,EAAE,MAAM,CAAC,WAAW;gBAC/B,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,MAAM,EAAE,KAAK;gBACb,SAAS,EAAE,CAAC,GAAG,CAAC;gBAChB,QAAQ,EAAE,MAAM,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS;gBACxD,cAAc,EAAE,CAAC;gBACjB,QAAQ,EAAE;oBACR,KAAK,EAAE;wBACL,IAAI,EAAE,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI;wBAChC,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM;qBACrC;oBACD,GAAG,EAAE;wBACH,IAAI,EAAE,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI;wBAC9B,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM;qBACnC;iBACF;aACF,CAAC,CAAC;SACJ,CAAA;QAED,kBAAkB,CAAC,KAAK,CAAC,GAAG,sBAAsB,CAAC,UAAU,OAAO,CAAC;YACnE,UAAU,CAAA;QAEZ,OAAO,kBAAkB,CAAA;IAC3B,CAAC;CACF;AAED,MAAM,gBAAgB,GAAG,MAAM,CAAC,EAAE;IAChC,OAAO;;;;;;;;;;;;;qBAaY,cAAc,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;;;UAGjD,CAAA;AACV,CAAC,CAAA;AAED;;GAEG;AACH,SAAS,cAAc,CAAC,IAAY;IAClC,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;IACpC,OAAO,CAAC,CAAA;AACV,CAAC"}

package/lib/service/mutantGenerator.d.ts

@@ -0,0 +1,6 @@
+import { ApexMutation } from '../type/ApexMutation.js';
+export declare class MutantGenerator {
+    private tokenStream?;
+    compute(classContent: string): ApexMutation[];
+    mutate(mutation: ApexMutation): string;
+}

package/lib/service/mutantGenerator.js

@@ -0,0 +1,28 @@
+import { BoundaryConditionMutator } from '../mutator/boundaryConditionMutator.js';
+import { IncrementMutator } from '../mutator/incrementMutator.js';
+import { MutationListener } from '../mutator/mutationListener.js';
+import { ApexLexer, ApexParser, CaseInsensitiveInputStream, CommonTokenStream, ParseTreeWalker, } from 'apex-parser';
+import { TokenStreamRewriter } from 'antlr4ts';
+export class MutantGenerator {
+    tokenStream;
+    compute(classContent) {
+        const lexer = new ApexLexer(new CaseInsensitiveInputStream('other', classContent));
+        this.tokenStream = new CommonTokenStream(lexer);
+        const parser = new ApexParser(this.tokenStream);
+        const tree = parser.compilationUnit();
+        const incrementListener = new IncrementMutator();
+        const boundaryListener = new BoundaryConditionMutator();
+        const listener = new MutationListener([incrementListener, boundaryListener]);
+        ParseTreeWalker.DEFAULT.walk(listener, tree);
+        return listener.getMutations();
+    }
+    mutate(mutation) {
+        // Create a new token stream rewriter
+        const rewriter = new TokenStreamRewriter(this.tokenStream);
+        // Apply the mutation by replacing the original token with the replacement text
+        rewriter.replace(mutation.token.symbol.tokenIndex, mutation.token.symbol.tokenIndex, mutation.replacement);
+        // Get the mutated code
+        return rewriter.getText();
+    }
+}
+//# sourceMappingURL=mutantGenerator.js.map

package/lib/service/mutantGenerator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mutantGenerator.js","sourceRoot":"","sources":["../../src/service/mutantGenerator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,wCAAwC,CAAA;AACjF,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAA;AACjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAA;AAEjE,OAAO,EACL,SAAS,EACT,UAAU,EAEV,0BAA0B,EAC1B,iBAAiB,EACjB,eAAe,GAChB,MAAM,aAAa,CAAA;AAEpB,OAAO,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAA;AAG9C,MAAM,OAAO,eAAe;IAClB,WAAW,CAAoB;IAChC,OAAO,CAAC,YAAoB;QACjC,MAAM,KAAK,GAAG,IAAI,SAAS,CACzB,IAAI,0BAA0B,CAAC,OAAO,EAAE,YAAY,CAAC,CACtD,CAAA;QACD,IAAI,CAAC,WAAW,GAAG,IAAI,iBAAiB,CAAC,KAAK,CAAC,CAAA;QAC/C,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,WAAW,CAAC,CAAA;QAC/C,MAAM,IAAI,GAAG,MAAM,CAAC,eAAe,EAAE,CAAA;QAErC,MAAM,iBAAiB,GAAG,IAAI,gBAAgB,EAAE,CAAA;QAChD,MAAM,gBAAgB,GAAG,IAAI,wBAAwB,EAAE,CAAA;QAEvD,MAAM,QAAQ,GAAG,IAAI,gBAAgB,CAAC,CAAC,iBAAiB,EAAE,gBAAgB,CAAC,CAAC,CAAA;QAE5E,eAAe,CAAC,OAAO,CAAC,IAAI,CAAC,QAA8B,EAAE,IAAI,CAAC,CAAA;QAElE,OAAO,QAAQ,CAAC,YAAY,EAAE,CAAA;IAChC,CAAC;IAEM,MAAM,CAAC,QAAsB;QAClC,qCAAqC;QACrC,MAAM,QAAQ,GAAG,IAAI,mBAAmB,CAAC,IAAI,CAAC,WAAY,CAAC,CAAA;QAC3D,+EAA+E;QAC/E,QAAQ,CAAC,OAAO,CACd,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,UAAU,EAChC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,UAAU,EAChC,QAAQ,CAAC,WAAW,CACrB,CAAA;QAED,uBAAuB;QACvB,OAAO,QAAQ,CAAC,OAAO,EAAE,CAAA;IAC3B,CAAC;CACF"}

package/lib/service/mutationTestingService.d.ts

@@ -0,0 +1,17 @@
+import { Connection } from '@salesforce/core';
+import { Progress, Spinner } from '@salesforce/sf-plugins-core';
+import { ApexMutationTestResult } from '../type/ApexMutationTestResult.js';
+export declare class MutationTestingService {
+    protected readonly progress: Progress;
+    protected readonly spinner: Spinner;
+    protected readonly connection: Connection;
+    protected readonly apexClassName: string;
+    protected readonly apexClassTestName: string;
+    constructor(progress: Progress, spinner: Spinner, connection: Connection, { apexClassName, apexClassTestName, }: {
+        apexClassName: string;
+        apexClassTestName: string;
+    });
+    process(): Promise<ApexMutationTestResult>;
+    calculateScore(mutationResult: ApexMutationTestResult): number;
+    private buildMutantResult;
+}