# core/parsers/report.parser.ts

> 33 lines of code and 9 definitions.

Tree: GovLab Quality
Language: typescript
Layer: processing
Canonical: https://banes-lab.com/anatomy/quality#file-quality-core-parsers-report-parser-ts
Source text: https://banes-lab.com/source/quality/core/parsers/report.parser.ts.txt

Listed in [core/parsers](https://banes-lab.com/api/source/quality/core/parsers.md), after [core/parsers/record.parser.ts](https://banes-lab.com/source/quality/core/parsers/record.parser.ts.md) and before [core/parsers/specifier.parser.ts](https://banes-lab.com/source/quality/core/parsers/specifier.parser.ts.md).

## Definitions

- `sarifFinding` (lexical_declaration, line 14)
- `parseSarifReport` (lexical_declaration, line 33, exported)
- `cleanUri` (lexical_declaration, line 9)
- `FILE_SCHEMES` (lexical_declaration, line 7)
- `scheme` (lexical_declaration, line 10)
- `location` (lexical_declaration, line 18)
- `physical` (lexical_declaration, line 19)
- `region` (lexical_declaration, line 20)
- `artifact` (lexical_declaration, line 21)

## Contained in

- [core/parsers](https://banes-lab.com/anatomy/quality/folder-quality-core-parsers.md)

## Uses

- [core/factories/finding.factory.ts](https://banes-lab.com/source/quality/core/factories/finding.factory.ts.md)
- [core/parsers/record.parser.ts](https://banes-lab.com/source/quality/core/parsers/record.parser.ts.md)
- [core/selectors/record.selector.ts](https://banes-lab.com/source/quality/core/selectors/record.selector.ts.md)

## Used by

- [core/adapters/tool.pmd.adapter.ts](https://banes-lab.com/source/quality/core/adapters/tool.pmd.adapter.ts.md)

## Linked from

- [core/adapters](https://banes-lab.com/anatomy/quality/folder-quality-core-adapters.md)
- [core/factories](https://banes-lab.com/anatomy/quality/folder-quality-core-factories.md)
- [core/parsers](https://banes-lab.com/anatomy/quality/folder-quality-core-parsers.md)
- [core/selectors](https://banes-lab.com/anatomy/quality/folder-quality-core-selectors.md)

## Source

```typescript
import { firstRecord, numberField, recordAt, recordsAt, stringField } from "#core/selectors/record.selector";
import type { Finding } from "#types/finding.types";
import { POSITION } from "#configuration/constants/tool.constants";
import { jsonRecord } from "#core/parsers/record.parser";
import { toolFinding } from "#core/factories/finding.factory";

const FILE_SCHEMES = ["file:///", "file://", "file:/"];

const cleanUri = function cleanUri(uri: string): string {
    const scheme = FILE_SCHEMES.find((prefix) => uri.startsWith(prefix));
    return scheme === undefined ? uri : uri.slice(scheme.length);
};

const sarifFinding = function sarifFinding(
    result: Record<string, unknown>,
    context: { ecosystem: string; tool: string },
): Finding {
    const location = firstRecord(recordsAt(result, "locations"));
    const physical = recordAt(location, "physicalLocation");
    const region = recordAt(physical, "region");
    const artifact = recordAt(physical, "artifactLocation");
    return toolFinding({
        column: numberField(region, "startColumn", POSITION),
        ecosystem: context.ecosystem,
        file: cleanUri(stringField(artifact, "uri")),
        line: numberField(region, "startLine", POSITION),
        message: stringField(recordAt(result, "message"), "text"),
        ruleId: stringField(result, "ruleId", context.tool),
        tool: context.tool,
    });
};

export const parseSarifReport = function parseSarifReport(stdout: string, ecosystem: string, tool: string): Finding[] {
    return recordsAt(jsonRecord(stdout || "{}"), "runs").flatMap((run) =>
        recordsAt(run, "results").map((result) => sarifFinding(result, { ecosystem, tool })),
    );
};
```