@fabasoad/sarif-to-slack 1.3.4 → 1.3.5

package/.github/workflows/release.yml

@@ -28,7 +28,7 @@ jobs:
       ref-name: ${{ steps.metadata.outputs.ref-name }}
     steps:
       - name: Get GitHub token
-        uses: actions/create-github-app-token@v2
+        uses: actions/create-github-app-token@v3
         id: github-app
         with:
           app-id: ${{ vars.GH_APP_CONTENTS_CRUD_APP_ID }}

package/.pre-commit-config.yaml

@@ -40,7 +40,7 @@ repos:
     hooks:
       - id: detect-secrets
   - repo: https://github.com/gitleaks/gitleaks
-    rev: v8.30.0
+    rev: v8.30.1
     hooks:
       - id: gitleaks
   - repo: https://github.com/fabasoad/pre-commit-snyk
@@ -60,7 +60,7 @@ repos:
           - --hook-args=--log-level debug
         stages: ["pre-push"]
   - repo: https://github.com/google/osv-scanner
-    rev: v2.3.3
+    rev: v2.3.5
     hooks:
       - id: osv-scanner
         args:
@@ -69,7 +69,7 @@ repos:
         stages: ["pre-push"]
   # Markdown
   - repo: https://github.com/igorshubovych/markdownlint-cli
-    rev: v0.47.0
+    rev: v0.48.0
     hooks:
       - id: markdownlint-fix
         stages: ["pre-commit"]
@@ -81,7 +81,7 @@ repos:
         stages: ["pre-push"]
   # GitHub Actions
   - repo: https://github.com/rhysd/actionlint
-    rev: v1.7.10
+    rev: v1.7.12
     hooks:
       - id: actionlint
         args: ["-pyflakes=", "-shellcheck="]

package/.tool-versions

@@ -1 +1 @@
-nodejs 25.6.1
+nodejs 25.9.0

package/Makefile

@@ -43,7 +43,7 @@ npm/update:
 
 .PHONY: pre-commit/update
 pre-commit/update:
-	@pre-commit autoupdate
+	@command -v prek >/dev/null 2>&1 && prek auto-update || pre-commit autoupdate
 
 .PHONY: update
 update: npm/update pre-commit/update

package/api-extractor.json

@@ -264,7 +264,7 @@
     /**
      * (REQUIRED) Whether to generate the .d.ts rollup file.
      */
-    "enabled": true
+    "enabled": true,
 
     /**
      * Specifies the output path for a .d.ts rollup file to be generated without any trimming.
@@ -278,7 +278,7 @@
      * SUPPORTED TOKENS: <projectFolder>, <packageName>, <unscopedPackageName>
      * DEFAULT VALUE: "<projectFolder>/dist/<unscopedPackageName>.d.ts"
      */
-    // "untrimmedFilePath": "<projectFolder>/dist/<unscopedPackageName>.d.ts",
+    "untrimmedFilePath": "<projectFolder>/dist/index.d.ts",
 
     /**
      * Specifies the output path for a .d.ts rollup file to be generated with trimming for an "alpha" release.

package/dist/index.cjs

@@ -175,9 +175,9 @@ var import_zod2 = require("zod");
 var import_zod = require("zod");
 
 // src/metadata.json
-var version = "1.3.4";
-var sha = "7dcec52f94545c8b5319ca92f2e77130b7bd0f3a";
-var buildAt = "2026-02-13T14:07:20Z";
+var version = "1.3.5";
+var sha = "4b44572f95bfdaab5159a2bd89a3ed2b193b55aa";
+var buildAt = "2026-04-04T14:25:40Z";
 
 // src/system.ts
 function logMetadata() {
@@ -565,6 +565,7 @@ var Column = class {
     this.header = header;
     this._cells = new Array(cellsCount);
   }
+  header;
   _logger = new Logger("Column");
   _cells;
   get total() {
@@ -596,6 +597,7 @@ var Cell = class {
     this._value = _value;
     this._width = _value.toString().length;
   }
+  _value;
   _width;
   setWidth(width) {
     this._width = width > this._width ? width : this._width;
@@ -621,6 +623,8 @@ var Row = class {
     this._cells = Array.from({ length: cellsCount }, () => new Cell());
     this._totalWidth = 1;
   }
+  _header;
+  headerWidth;
   _logger = new Logger("Row");
   _cells;
   _totalWidth;
@@ -729,6 +733,9 @@ var TableGroupRepresentation = class extends Representation {
     this._keyPer = _keyPer;
     this._values = _values;
   }
+  _keyBy;
+  _keyPer;
+  _values;
   _logger = new Logger("TableGroupRepresentation");
   groupFindingsPer(findings) {
     return findings.reduce(

package/dist/index.d.ts

@@ -69,9 +69,494 @@
  *
  * @packageDocumentation
  */
-export { Color } from './model/color/Color';
-export { ColorOptions, ColorGroupCommon, ColorGroupByLevel, ColorGroupBySeverity } from './model/color/ColorOptions';
-export { SendIf } from './model/SendIf';
-export { SarifToSlackClient } from './SarifToSlackClient';
-export { FooterOptions, FooterType, IncludeAwareOptions, IncludeAwareWithValueOptions, RepresentationType, SarifFileExtension, SarifOptions, SarifToSlackClientOptions } from './types';
-//# sourceMappingURL=index.d.ts.map
+
+/**
+ * This class represents a color in hex format.
+ * @public
+ */
+export declare class Color {
+    /**
+     * A valid string that represents a color in hex format.
+     * @public
+     */
+    readonly color: string;
+    private constructor();
+    /**
+     * Creates an instance of {@link Color} class. Before creating an instance of
+     * {@link Color} class, it (if applicable) maps CI status into the hex color,
+     * and also validates color parameter to be a valid string that represents a
+     * color in hex format.
+     * @param color - Can be either undefined, valid color in hex format or GitHub
+     * CI status (one of: success, failure, cancelled, skipped).
+     * @returns An instance of {@link Color} or undefined if color parameter is falsy.
+     * @public
+     */
+    static from(color: string | undefined): Color | undefined;
+    private assertHexColor;
+    private mapColor;
+}
+
+/**
+ * Color schema for the findings with the certain level. Color is used by the
+ * level importance, i.e. if at least 1 error finding exists then
+ * {@link ColorGroupByLevel#error} color is used, then if at least 1 warning
+ * finding exists then {@link ColorGroupByLevel#warning} color is used, etc.
+ * @public
+ */
+export declare type ColorGroupByLevel = ColorGroupCommon & {
+    error?: Color;
+    warning?: Color;
+    note?: Color;
+};
+
+/**
+ * Color schema for the findings with the certain severity. Color is used by the
+ * severity importance, i.e. if at least 1 critical finding exists then
+ * {@link ColorGroupBySeverity#critical} color is used, then if at least 1 high
+ * finding exists then {@link ColorGroupBySeverity#high} color is used, etc.
+ * @public
+ */
+export declare type ColorGroupBySeverity = ColorGroupCommon & {
+    critical?: Color;
+    high?: Color;
+    medium?: Color;
+    low?: Color;
+};
+
+/**
+ * Base type that has common fields for both {@link ColorGroupByLevel} and
+ * {@link ColorGroupBySeverity}.
+ * @public
+ */
+export declare type ColorGroupCommon = {
+    none?: Color;
+    unknown?: Color;
+};
+
+/**
+ * Represents configuration of the color scheme. If both {@link ColorOptions#byLevel}
+ * and {@link ColorOptions#bySeverity} are defined, then {@link ColorOptions#bySeverity}
+ * takes precedence.
+ * @public
+ */
+export declare type ColorOptions = {
+    /**
+     * Default color if specific color was not found. It is a fallback option.
+     */
+    default?: Color;
+    /**
+     * Color scheme for the findings where certain level is presented.
+     */
+    byLevel?: ColorGroupByLevel;
+    /**
+     * Color scheme for the findings where certain severity is presented.
+     */
+    bySeverity?: ColorGroupBySeverity;
+    /**
+     * Color when no findings are found.
+     */
+    empty?: Color;
+};
+
+/**
+ * Options for the footer of a Slack message. "type" is ignored if "value" is
+ * not defined.
+ * @public
+ */
+export declare type FooterOptions = IncludeAwareWithValueOptions & {
+    type?: FooterType;
+};
+
+/**
+ * Enum representing the type of footer in a Slack message.
+ * @public
+ */
+export declare enum FooterType {
+    /**
+     * Represents a plain text footer. Text is not formatted and appears as-is.
+     */
+    PlainText = "plain_text",
+    /**
+     * Represents a footer with Markdown formatting. Text can include formatting
+     * such as bold, italics, and links.
+     */
+    Markdown = "mrkdwn"
+}
+
+/**
+ * Type representing properties that indicate whether to include certain information
+ * in the Slack message.
+ * @public
+ */
+export declare type IncludeAwareOptions = {
+    include: boolean;
+};
+
+/**
+ * Type representing properties that indicate whether to include certain information
+ * in the Slack message, along with an optional value.
+ * @public
+ */
+export declare type IncludeAwareWithValueOptions = IncludeAwareOptions & {
+    value?: string;
+};
+
+/**
+ * This represents what type of message should be sent. There are various options
+ * to show information from SARIF in Slack message.
+ * @public
+ */
+export declare enum RepresentationType {
+    /**
+     * Compact information about findings grouped by Run with the level representation.
+     * @example
+     * ```text
+     * [Run 1] Grype
+     * Error: 1, Warning: 4
+     * [Run 2] Grype
+     * Warning: 1, Note: 20
+     * ```
+     */
+    CompactGroupByRunPerLevel = 0,
+    /**
+     * Compact information about findings grouped by Run with the severity representation.
+     * @example
+     * ```text
+     * [Run 1] Grype
+     * Critical: 1, High: 3, Medium: 1
+     * [Run 2] Grype
+     * Medium: 1, Low: 20
+     * ```
+     */
+    CompactGroupByRunPerSeverity = 1,
+    /**
+     * Compact information about findings grouped by tool name with the level representation.
+     * @example
+     * ```text
+     * Grype
+     * Error: 1, Warning: 5, Note: 20
+     * ```
+     */
+    CompactGroupByToolNamePerLevel = 2,
+    /**
+     * Compact information about findings grouped by tool name with the severity representation.
+     * @example
+     * ```text
+     * Grype
+     * Critical: 1, High: 3, Medium: 2, Low: 20
+     * ```
+     */
+    CompactGroupByToolNamePerSeverity = 3,
+    /**
+     * Compact information about findings grouped by SARIF file with the level representation.
+     * @example
+     * ```text
+     * grype-results-01.sarif
+     * Error: 1, Warning: 2, Note: 1
+     * grype-results-02.sarif
+     * Warning: 3, Note: 19
+     * ```
+     */
+    CompactGroupBySarifPerLevel = 4,
+    /**
+     * Compact information about findings grouped by SARIF file with the severity
+     * representation.
+     * @example
+     * ```text
+     * grype-results-01.sarif
+     * High: 3, Medium: 1, Low: 11
+     * grype-results-02.sarif
+     * Critical: 1, Medium: 1, Low: 9
+     * ```
+     */
+    CompactGroupBySarifPerSeverity = 5,
+    /**
+     * Compact information about findings with the level representation.
+     * @example
+     * ```text
+     * Total
+     * Error: 1, Warning: 5, Note: 20
+     * ```
+     */
+    CompactTotalPerLevel = 6,
+    /**
+     * Compact information about findings with the severity representation.
+     * @example
+     * ```text
+     * Total
+     * Critical: 1, High: 3, Medium: 2, Low: 20
+     * ```
+     */
+    CompactTotalPerSeverity = 7,
+    /**
+     * Table information about findings grouped by Run with the level representation.
+     * @example
+     * ```text
+     * |       | Unknown | None | Note | Warning | Error | Total |
+     * | ----- | ------- | ---- | ---- | ------- | ----- | ----- |
+     * | 1     | 0       | 0    | 0    | 1       | 0     | 1     |
+     * | 2     | 0       | 0    | 9    | 20      | 10    | 39    |
+     * | 3     | 0       | 0    | 1    | 0       | 1     | 2     |
+     * | 4     | 0       | 0    | 5    | 5       | 0     | 10    |
+     * | ----- | ------- | ---- | ---- | ------- | ----- | ----- |
+     * | Total | 0       | 0    | 15   | 26      | 11    | 52    |
+     * ```
+     */
+    TableGroupByRunPerLevel = 8,
+    /**
+     * Table information about findings grouped by Run with the severity representation.
+     * @example
+     * ```text
+     * |       | Unknown | None | Low | Medium | High | Critical | Total |
+     * | ----- | ------- | ---- | --- | ------ | ---- | -------- | ----- |
+     * | 1     | 0       | 0    | 0   | 1      | 0    | 0        | 1     |
+     * | 2     | 0       | 0    | 9   | 20     | 10   | 0        | 39    |
+     * | 3     | 0       | 0    | 1   | 0      | 1    | 0        | 2     |
+     * | 4     | 0       | 0    | 5   | 5      | 0    | 0        | 10    |
+     * | ----- | ------- | ---- | --- | ------ | ---- | -------- | ----- |
+     * | Total | 0       | 0    | 15  | 26     | 11   | 0        | 52    |
+     * ```
+     */
+    TableGroupByRunPerSeverity = 9,
+    /**
+     * Table information about findings grouped by tool name with the level representation.
+     * @example
+     * ```text
+     * |        | Unknown | None | Note | Warning | Error | Total |
+     * | ------ | ------- | ---- | ---- | ------- | ----- | ----- |
+     * | CodeQL | 0       | 0    | 0    | 1       | 0     | 1     |
+     * | grype  | 0       | 0    | 9    | 20      | 10    | 39    |
+     * | Trivy  | 0       | 0    | 1    | 0       | 1     | 2     |
+     * | WizCLI | 0       | 0    | 5    | 5       | 0     | 10    |
+     * | ------ | ------- | ---- | ---- | ------- | ----- | ----- |
+     * | Total  | 0       | 0    | 15   | 26      | 11    | 52    |
+     * ```
+     */
+    TableGroupByToolNamePerLevel = 10,
+    /**
+     * Table information about findings grouped by tool name with the severity representation.
+     * @example
+     * ```text
+     * |        | Unknown | None | Low | Medium | High | Critical | Total |
+     * | ------ | ------- | ---- | --- | ------ | ---- | -------- | ----- |
+     * | CodeQL | 0       | 0    | 0   | 1      | 0    | 0        | 1     |
+     * | grype  | 0       | 0    | 9   | 20     | 10   | 0        | 39    |
+     * | Trivy  | 0       | 0    | 1   | 0      | 1    | 0        | 2     |
+     * | WizCLI | 0       | 0    | 5   | 5      | 0    | 0        | 10    |
+     * | ------ | ------- | ---- | --- | ------ | ---- | -------- | ----- |
+     * | Total  | 0       | 0    | 15  | 26     | 11   | 0        | 52    |
+     * ```
+     */
+    TableGroupByToolNamePerSeverity = 11,
+    /**
+     * Table information about findings grouped by SARIF file with the level representation.
+     * @example
+     * ```text
+     * |       | Unknown | None | Note | Warning | Error | Total |
+     * | ----- | ------- | ---- | ---- | ------- | ----- | ----- |
+     * | 1     | 0       | 0    | 0    | 1       | 0     | 1     |
+     * | 2     | 0       | 0    | 9    | 20      | 10    | 39    |
+     * | ----- | ------- | ---- | ---- | ------- | ----- | ----- |
+     * | Total | 0       | 0    | 9    | 21      | 10    | 40    |
+     * ```
+     */
+    TableGroupBySarifPerLevel = 12,
+    /**
+     * Table information about findings grouped by SARIF file with the severity representation.
+     * @example
+     * ```text
+     * |       | Unknown | None | Low | Medium | High | Critical | Total |
+     * | ----- | ------- | ---- | --- | ------ | ---- | -------- | ----- |
+     * | 1     | 0       | 0    | 0   | 1      | 0    | 0        | 1     |
+     * | 2     | 0       | 0    | 9   | 20     | 10   | 0        | 39    |
+     * | ----- | ------- | ---- | --- | ------ | ---- | -------- | ----- |
+     * | Total | 0       | 0    | 9   | 21     | 10   | 0        | 40    |
+     * ```
+     */
+    TableGroupBySarifPerSeverity = 13
+}
+
+/**
+ * SARIF file extension.
+ * @public
+ */
+export declare type SarifFileExtension = 'sarif' | 'json';
+
+/**
+ * Represents options for the provided SARIF file(s), such as path, should files
+ * from this path be retrieved recursively or not, and file extension.
+ * @public
+ */
+export declare type SarifOptions = {
+    path: string;
+    recursive?: boolean;
+    extension?: SarifFileExtension;
+};
+
+/**
+ * Service to convert SARIF files to Slack messages and send them.
+ * @public
+ */
+export declare class SarifToSlackClient {
+    private readonly _logger;
+    private _message?;
+    private _sarifModel?;
+    private _sendIf;
+    private constructor();
+    private static createRunIdGenerator;
+    /**
+     * Creates an instance of {@link SarifToSlackClient} class. It already has all
+     * properties and fields initialized.
+     * @param webhookUrl - Slack webhook URL.
+     * @param opts - An instance of {@link SarifToSlackClientOptions} type.
+     *
+     * @see SarifToSlackClientOptions
+     *
+     * @public
+     */
+    static create(webhookUrl: string, opts: SarifToSlackClientOptions): Promise<SarifToSlackClient>;
+    private static buildModel;
+    /**
+     * Sends a Slack message.
+     * @returns A promise that resolves when the message has been sent.
+     * @throws Error if a Slack message was not prepared for the given SARIF path.
+     * @public
+     */
+    send(): Promise<void>;
+    private get shouldSendMessage();
+}
+
+/**
+ * Options for the SarifToSlackClient.
+ * @public
+ */
+export declare type SarifToSlackClientOptions = {
+    sarif: SarifOptions;
+    username?: string;
+    iconUrl?: string;
+    color?: ColorOptions;
+    header?: IncludeAwareWithValueOptions;
+    footer?: FooterOptions;
+    actor?: IncludeAwareWithValueOptions;
+    run?: IncludeAwareOptions;
+    representation?: RepresentationType;
+    sendIf?: SendIf;
+};
+
+/**
+ * This enum represents the condition on when message should be sent. If this
+ * condition is satisfied then message is sent, otherwise - message is not sent.
+ * @public
+ */
+export declare enum SendIf {
+    /**
+     * Send message only if there is at least one finding with "Critical" severity.
+     * Since it is the higher possible severity, it is the same as "Critical" or
+     * higher.
+     */
+    SeverityCritical = 0,
+    /**
+     * Send message only if there is at least one finding with "High" severity.
+     */
+    SeverityHigh = 1,
+    /**
+     * Send message only if there is at least one finding with "High" severity or
+     * higher, that includes "High" and "Critical".
+     */
+    SeverityHighOrHigher = 2,
+    /**
+     * Send message only if there is at least one finding with "Medium" severity.
+     */
+    SeverityMedium = 3,
+    /**
+     * Send message only if there is at least one finding with "Medium" severity
+     * or higher, that includes "Medium", "High" and "Critical".
+     */
+    SeverityMediumOrHigher = 4,
+    /**
+     * Send message only if there is at least one finding with "Low" severity.
+     */
+    SeverityLow = 5,
+    /**
+     * Send message only if there is at least one finding with "Low" severity or
+     * higher, that includes "Low", "Medium", "High" and "Critical".
+     */
+    SeverityLowOrHigher = 6,
+    /**
+     * Send message only if there is at least one finding with "None" severity.
+     */
+    SeverityNone = 7,
+    /**
+     * Send message only if there is at least one finding with "None" severity or
+     * higher, that includes "None", "Low", "Medium", "High" and "Critical".
+     */
+    SeverityNoneOrHigher = 8,
+    /**
+     * Send message only if there is at least one finding with "Unknown" severity.
+     */
+    SeverityUnknown = 9,
+    /**
+     * Send message only if there is at least one finding with "Unknown" severity
+     * or higher, that includes "Unknown", "None", "Low", "Medium", "High" and "Critical".
+     */
+    SeverityUnknownOrHigher = 10,
+    /**
+     * Send message only if there is at least one finding with "Error" level.
+     * Since it is the higher possible level, it is the same as "Error" or higher.
+     */
+    LevelError = 11,
+    /**
+     * Send message only if there is at least one finding with "Warning" level.
+     */
+    LevelWarning = 12,
+    /**
+     * Send message only if there is at least one finding with "Warning" level or
+     * higher, that includes "Warning" and "Error".
+     */
+    LevelWarningOrHigher = 13,
+    /**
+     * Send message only if there is at least one finding with "Note" level.
+     */
+    LevelNote = 14,
+    /**
+     * Send message only if there is at least one finding with "Note" level or
+     * higher, that includes "Note", "Warning" and "Error.
+     */
+    LevelNoteOrHigher = 15,
+    /**
+     * Send message only if there is at least one finding with "None" level.
+     */
+    LevelNone = 16,
+    /**
+     * Send message only if there is at least one finding with "None" level or
+     * higher, that includes "None", "Note", "Warning" and "Error.
+     */
+    LevelNoneOrHigher = 17,
+    /**
+     * Send message only if there is at least one finding with "Unknown" level.
+     */
+    LevelUnknown = 18,
+    /**
+     * Send message only if there is at least one finding with "Unknown" level or
+     * higher, that includes "Unknown", "None", "Note", "Warning" and "Error.
+     */
+    LevelUnknownOrHigher = 19,
+    /**
+     * Always send a message.
+     */
+    Always = 20,
+    /**
+     * Send a message if at least 1 vulnerability is found.
+     */
+    Some = 21,
+    /**
+     * Send a message only if no vulnerabilities are found.
+     */
+    Empty = 22,
+    /**
+     * Never send a message.
+     */
+    Never = 23
+}
+
+export { }

package/dist/tsdoc-metadata.json

@@ -5,7 +5,7 @@
   "toolPackages": [
     {
       "packageName": "@microsoft/api-extractor",
-      "packageVersion": "7.56.3"
+      "packageVersion": "7.58.1"
     }
   ]
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fabasoad/sarif-to-slack",
-  "version": "1.3.4",
+  "version": "1.3.5",
   "description": "TypeScript library to send results of SARIF file to Slack webhook URL.",
   "main": "dist/index.cjs",
   "module": "dist/index.js",
@@ -42,20 +42,20 @@
   },
   "homepage": "https://github.com/fabasoad/sarif-to-slack#readme",
   "dependencies": {
-    "@slack/webhook": "~7.0.7",
+    "@slack/webhook": "~7.0.8",
     "@types/sarif": "~2.1.7",
     "tslog": "~4.10.2",
     "zod": "~4.3.6"
   },
   "devDependencies": {
-    "@biomejs/biome": "~2.3.15",
-    "@microsoft/api-documenter": "~7.28.9",
-    "@microsoft/api-extractor": "~7.56.3",
+    "@biomejs/biome": "~2.4.10",
+    "@microsoft/api-documenter": "~7.29.10",
+    "@microsoft/api-extractor": "~7.58.1",
     "@types/jest": "~30.0.0",
-    "jest": "~30.2.0",
-    "jest-circus": "~30.2.0",
-    "ts-jest": "~29.4.6",
+    "jest": "~30.3.0",
+    "jest-circus": "~30.3.0",
+    "ts-jest": "~29.4.9",
     "tsup": "~8.5.1",
-    "typescript": "~5.9.3"
+    "typescript": "~6.0.2"
   }
 }

package/tsconfig.json

@@ -3,11 +3,9 @@
   "compilerOptions": {
     "allowSyntheticDefaultImports": true,
     "alwaysStrict": true,
-    "baseUrl": ".",
     "declaration": true,
     "declarationDir": "dist",
     "declarationMap": true,
-    "downlevelIteration": true,
     "emitDecoratorMetadata": true,
     "esModuleInterop": true,
     "experimentalDecorators": true,
@@ -15,7 +13,8 @@
     "inlineSourceMap": true,
     "lib": ["es2024"],
     "module": "es2022",
-    "moduleResolution": "node",
+    "moduleResolution": "bundler",
+    "rootDir": "src",
     "newLine": "lf",
     "noFallthroughCasesInSwitch": true,
     "noImplicitAny": true,

package/dist/sarif-to-slack.d.ts

@@ -1,562 +0,0 @@
-/**
- * Sarif to Slack message converter library.
- *
- * @remarks
- * This library provides a client to send a Slack messages based on the provided
- * SARIF (Static Analysis Results Interchange Format) files.
- *
- * @example
- * ```typescript
- * import {
- *   Color,
- *   FooterType,
- *   RepresentationType,
- *   SarifToSlackClient,
- *   SendIf
- * } from '@fabasoad/sarif-to-slack';
- *
- * const client: SarifToSlackClient = await SarifToSlackClient.create({
- *   webhookUrl: 'https://hooks.slack.com/services/your/webhook/url',
- *   username: 'SARIF to Slack Bot',
- *   iconUrl: 'https://example.com/icon.png',
- *   color: {
- *     default: new Color('failure'),
- *     empty: new Color('success'),
- *     bySeverity: {
- *       critical: new Color('#ff0000'),
- *       high: new Color('#ff4500'),
- *       medium: new Color('#ffa500'),
- *       low: new Color('#ffff00'),
- *       none: new Color('#808080'),
- *       unknown: new Color('#800080'),
- *     },
- *     byLevel: {
- *       error: new Color('#ff0000'),
- *       warning: new Color('#ffa500'),
- *       note: new Color('#ffff00'),
- *       none: new Color('#808080'),
- *       unknown: new Color('#800080'),
- *     },
- *   },
- *   sarif: {
- *     path: 'path/to/your/sarif-files',
- *     recursive: true,
- *     extension: 'sarif',
- *   },
- *   header: {
- *     include: true,
- *     value: 'SARIF Analysis Results'
- *   },
- *   footer: {
- *     include: true,
- *     type: FooterType.PLAIN_TEXT,
- *     value: 'Generated by @fabasoad/sarif-to-slack'
- *   },
- *   actor: {
- *     include: true,
- *     value: 'fabasoad'
- *   },
- *   run: {
- *     include: true
- *   },
- *   representation: RepresentationType.CompactGroupByToolNamePerSeverity,
- *   sendIf: SendIf.MediumOrHigher,
- * });
- * await client.send();
- * ```
- *
- * @see {@link SarifToSlackClient}
- *
- * @packageDocumentation
- */
-
-/**
- * This class represents a color in hex format.
- * @public
- */
-export declare class Color {
-    /**
-     * A valid string that represents a color in hex format.
-     * @public
-     */
-    readonly color: string;
-    private constructor();
-    /**
-     * Creates an instance of {@link Color} class. Before creating an instance of
-     * {@link Color} class, it (if applicable) maps CI status into the hex color,
-     * and also validates color parameter to be a valid string that represents a
-     * color in hex format.
-     * @param color - Can be either undefined, valid color in hex format or GitHub
-     * CI status (one of: success, failure, cancelled, skipped).
-     * @returns An instance of {@link Color} or undefined if color parameter is falsy.
-     * @public
-     */
-    static from(color: string | undefined): Color | undefined;
-    private assertHexColor;
-    private mapColor;
-}
-
-/**
- * Color schema for the findings with the certain level. Color is used by the
- * level importance, i.e. if at least 1 error finding exists then
- * {@link ColorGroupByLevel#error} color is used, then if at least 1 warning
- * finding exists then {@link ColorGroupByLevel#warning} color is used, etc.
- * @public
- */
-export declare type ColorGroupByLevel = ColorGroupCommon & {
-    error?: Color;
-    warning?: Color;
-    note?: Color;
-};
-
-/**
- * Color schema for the findings with the certain severity. Color is used by the
- * severity importance, i.e. if at least 1 critical finding exists then
- * {@link ColorGroupBySeverity#critical} color is used, then if at least 1 high
- * finding exists then {@link ColorGroupBySeverity#high} color is used, etc.
- * @public
- */
-export declare type ColorGroupBySeverity = ColorGroupCommon & {
-    critical?: Color;
-    high?: Color;
-    medium?: Color;
-    low?: Color;
-};
-
-/**
- * Base type that has common fields for both {@link ColorGroupByLevel} and
- * {@link ColorGroupBySeverity}.
- * @public
- */
-export declare type ColorGroupCommon = {
-    none?: Color;
-    unknown?: Color;
-};
-
-/**
- * Represents configuration of the color scheme. If both {@link ColorOptions#byLevel}
- * and {@link ColorOptions#bySeverity} are defined, then {@link ColorOptions#bySeverity}
- * takes precedence.
- * @public
- */
-export declare type ColorOptions = {
-    /**
-     * Default color if specific color was not found. It is a fallback option.
-     */
-    default?: Color;
-    /**
-     * Color scheme for the findings where certain level is presented.
-     */
-    byLevel?: ColorGroupByLevel;
-    /**
-     * Color scheme for the findings where certain severity is presented.
-     */
-    bySeverity?: ColorGroupBySeverity;
-    /**
-     * Color when no findings are found.
-     */
-    empty?: Color;
-};
-
-/**
- * Options for the footer of a Slack message. "type" is ignored if "value" is
- * not defined.
- * @public
- */
-export declare type FooterOptions = IncludeAwareWithValueOptions & {
-    type?: FooterType;
-};
-
-/**
- * Enum representing the type of footer in a Slack message.
- * @public
- */
-export declare enum FooterType {
-    /**
-     * Represents a plain text footer. Text is not formatted and appears as-is.
-     */
-    PlainText = "plain_text",
-    /**
-     * Represents a footer with Markdown formatting. Text can include formatting
-     * such as bold, italics, and links.
-     */
-    Markdown = "mrkdwn"
-}
-
-/**
- * Type representing properties that indicate whether to include certain information
- * in the Slack message.
- * @public
- */
-export declare type IncludeAwareOptions = {
-    include: boolean;
-};
-
-/**
- * Type representing properties that indicate whether to include certain information
- * in the Slack message, along with an optional value.
- * @public
- */
-export declare type IncludeAwareWithValueOptions = IncludeAwareOptions & {
-    value?: string;
-};
-
-/**
- * This represents what type of message should be sent. There are various options
- * to show information from SARIF in Slack message.
- * @public
- */
-export declare enum RepresentationType {
-    /**
-     * Compact information about findings grouped by Run with the level representation.
-     * @example
-     * ```text
-     * [Run 1] Grype
-     * Error: 1, Warning: 4
-     * [Run 2] Grype
-     * Warning: 1, Note: 20
-     * ```
-     */
-    CompactGroupByRunPerLevel = 0,
-    /**
-     * Compact information about findings grouped by Run with the severity representation.
-     * @example
-     * ```text
-     * [Run 1] Grype
-     * Critical: 1, High: 3, Medium: 1
-     * [Run 2] Grype
-     * Medium: 1, Low: 20
-     * ```
-     */
-    CompactGroupByRunPerSeverity = 1,
-    /**
-     * Compact information about findings grouped by tool name with the level representation.
-     * @example
-     * ```text
-     * Grype
-     * Error: 1, Warning: 5, Note: 20
-     * ```
-     */
-    CompactGroupByToolNamePerLevel = 2,
-    /**
-     * Compact information about findings grouped by tool name with the severity representation.
-     * @example
-     * ```text
-     * Grype
-     * Critical: 1, High: 3, Medium: 2, Low: 20
-     * ```
-     */
-    CompactGroupByToolNamePerSeverity = 3,
-    /**
-     * Compact information about findings grouped by SARIF file with the level representation.
-     * @example
-     * ```text
-     * grype-results-01.sarif
-     * Error: 1, Warning: 2, Note: 1
-     * grype-results-02.sarif
-     * Warning: 3, Note: 19
-     * ```
-     */
-    CompactGroupBySarifPerLevel = 4,
-    /**
-     * Compact information about findings grouped by SARIF file with the severity
-     * representation.
-     * @example
-     * ```text
-     * grype-results-01.sarif
-     * High: 3, Medium: 1, Low: 11
-     * grype-results-02.sarif
-     * Critical: 1, Medium: 1, Low: 9
-     * ```
-     */
-    CompactGroupBySarifPerSeverity = 5,
-    /**
-     * Compact information about findings with the level representation.
-     * @example
-     * ```text
-     * Total
-     * Error: 1, Warning: 5, Note: 20
-     * ```
-     */
-    CompactTotalPerLevel = 6,
-    /**
-     * Compact information about findings with the severity representation.
-     * @example
-     * ```text
-     * Total
-     * Critical: 1, High: 3, Medium: 2, Low: 20
-     * ```
-     */
-    CompactTotalPerSeverity = 7,
-    /**
-     * Table information about findings grouped by Run with the level representation.
-     * @example
-     * ```text
-     * |       | Unknown | None | Note | Warning | Error | Total |
-     * | ----- | ------- | ---- | ---- | ------- | ----- | ----- |
-     * | 1     | 0       | 0    | 0    | 1       | 0     | 1     |
-     * | 2     | 0       | 0    | 9    | 20      | 10    | 39    |
-     * | 3     | 0       | 0    | 1    | 0       | 1     | 2     |
-     * | 4     | 0       | 0    | 5    | 5       | 0     | 10    |
-     * | ----- | ------- | ---- | ---- | ------- | ----- | ----- |
-     * | Total | 0       | 0    | 15   | 26      | 11    | 52    |
-     * ```
-     */
-    TableGroupByRunPerLevel = 8,
-    /**
-     * Table information about findings grouped by Run with the severity representation.
-     * @example
-     * ```text
-     * |       | Unknown | None | Low | Medium | High | Critical | Total |
-     * | ----- | ------- | ---- | --- | ------ | ---- | -------- | ----- |
-     * | 1     | 0       | 0    | 0   | 1      | 0    | 0        | 1     |
-     * | 2     | 0       | 0    | 9   | 20     | 10   | 0        | 39    |
-     * | 3     | 0       | 0    | 1   | 0      | 1    | 0        | 2     |
-     * | 4     | 0       | 0    | 5   | 5      | 0    | 0        | 10    |
-     * | ----- | ------- | ---- | --- | ------ | ---- | -------- | ----- |
-     * | Total | 0       | 0    | 15  | 26     | 11   | 0        | 52    |
-     * ```
-     */
-    TableGroupByRunPerSeverity = 9,
-    /**
-     * Table information about findings grouped by tool name with the level representation.
-     * @example
-     * ```text
-     * |        | Unknown | None | Note | Warning | Error | Total |
-     * | ------ | ------- | ---- | ---- | ------- | ----- | ----- |
-     * | CodeQL | 0       | 0    | 0    | 1       | 0     | 1     |
-     * | grype  | 0       | 0    | 9    | 20      | 10    | 39    |
-     * | Trivy  | 0       | 0    | 1    | 0       | 1     | 2     |
-     * | WizCLI | 0       | 0    | 5    | 5       | 0     | 10    |
-     * | ------ | ------- | ---- | ---- | ------- | ----- | ----- |
-     * | Total  | 0       | 0    | 15   | 26      | 11    | 52    |
-     * ```
-     */
-    TableGroupByToolNamePerLevel = 10,
-    /**
-     * Table information about findings grouped by tool name with the severity representation.
-     * @example
-     * ```text
-     * |        | Unknown | None | Low | Medium | High | Critical | Total |
-     * | ------ | ------- | ---- | --- | ------ | ---- | -------- | ----- |
-     * | CodeQL | 0       | 0    | 0   | 1      | 0    | 0        | 1     |
-     * | grype  | 0       | 0    | 9   | 20     | 10   | 0        | 39    |
-     * | Trivy  | 0       | 0    | 1   | 0      | 1    | 0        | 2     |
-     * | WizCLI | 0       | 0    | 5   | 5      | 0    | 0        | 10    |
-     * | ------ | ------- | ---- | --- | ------ | ---- | -------- | ----- |
-     * | Total  | 0       | 0    | 15  | 26     | 11   | 0        | 52    |
-     * ```
-     */
-    TableGroupByToolNamePerSeverity = 11,
-    /**
-     * Table information about findings grouped by SARIF file with the level representation.
-     * @example
-     * ```text
-     * |       | Unknown | None | Note | Warning | Error | Total |
-     * | ----- | ------- | ---- | ---- | ------- | ----- | ----- |
-     * | 1     | 0       | 0    | 0    | 1       | 0     | 1     |
-     * | 2     | 0       | 0    | 9    | 20      | 10    | 39    |
-     * | ----- | ------- | ---- | ---- | ------- | ----- | ----- |
-     * | Total | 0       | 0    | 9    | 21      | 10    | 40    |
-     * ```
-     */
-    TableGroupBySarifPerLevel = 12,
-    /**
-     * Table information about findings grouped by SARIF file with the severity representation.
-     * @example
-     * ```text
-     * |       | Unknown | None | Low | Medium | High | Critical | Total |
-     * | ----- | ------- | ---- | --- | ------ | ---- | -------- | ----- |
-     * | 1     | 0       | 0    | 0   | 1      | 0    | 0        | 1     |
-     * | 2     | 0       | 0    | 9   | 20     | 10   | 0        | 39    |
-     * | ----- | ------- | ---- | --- | ------ | ---- | -------- | ----- |
-     * | Total | 0       | 0    | 9   | 21     | 10   | 0        | 40    |
-     * ```
-     */
-    TableGroupBySarifPerSeverity = 13
-}
-
-/**
- * SARIF file extension.
- * @public
- */
-export declare type SarifFileExtension = 'sarif' | 'json';
-
-/**
- * Represents options for the provided SARIF file(s), such as path, should files
- * from this path be retrieved recursively or not, and file extension.
- * @public
- */
-export declare type SarifOptions = {
-    path: string;
-    recursive?: boolean;
-    extension?: SarifFileExtension;
-};
-
-/**
- * Service to convert SARIF files to Slack messages and send them.
- * @public
- */
-export declare class SarifToSlackClient {
-    private readonly _logger;
-    private _message?;
-    private _sarifModel?;
-    private _sendIf;
-    private constructor();
-    private static createRunIdGenerator;
-    /**
-     * Creates an instance of {@link SarifToSlackClient} class. It already has all
-     * properties and fields initialized.
-     * @param webhookUrl - Slack webhook URL.
-     * @param opts - An instance of {@link SarifToSlackClientOptions} type.
-     *
-     * @see SarifToSlackClientOptions
-     *
-     * @public
-     */
-    static create(webhookUrl: string, opts: SarifToSlackClientOptions): Promise<SarifToSlackClient>;
-    private static buildModel;
-    /**
-     * Sends a Slack message.
-     * @returns A promise that resolves when the message has been sent.
-     * @throws Error if a Slack message was not prepared for the given SARIF path.
-     * @public
-     */
-    send(): Promise<void>;
-    private get shouldSendMessage();
-}
-
-/**
- * Options for the SarifToSlackClient.
- * @public
- */
-export declare type SarifToSlackClientOptions = {
-    sarif: SarifOptions;
-    username?: string;
-    iconUrl?: string;
-    color?: ColorOptions;
-    header?: IncludeAwareWithValueOptions;
-    footer?: FooterOptions;
-    actor?: IncludeAwareWithValueOptions;
-    run?: IncludeAwareOptions;
-    representation?: RepresentationType;
-    sendIf?: SendIf;
-};
-
-/**
- * This enum represents the condition on when message should be sent. If this
- * condition is satisfied then message is sent, otherwise - message is not sent.
- * @public
- */
-export declare enum SendIf {
-    /**
-     * Send message only if there is at least one finding with "Critical" severity.
-     * Since it is the higher possible severity, it is the same as "Critical" or
-     * higher.
-     */
-    SeverityCritical = 0,
-    /**
-     * Send message only if there is at least one finding with "High" severity.
-     */
-    SeverityHigh = 1,
-    /**
-     * Send message only if there is at least one finding with "High" severity or
-     * higher, that includes "High" and "Critical".
-     */
-    SeverityHighOrHigher = 2,
-    /**
-     * Send message only if there is at least one finding with "Medium" severity.
-     */
-    SeverityMedium = 3,
-    /**
-     * Send message only if there is at least one finding with "Medium" severity
-     * or higher, that includes "Medium", "High" and "Critical".
-     */
-    SeverityMediumOrHigher = 4,
-    /**
-     * Send message only if there is at least one finding with "Low" severity.
-     */
-    SeverityLow = 5,
-    /**
-     * Send message only if there is at least one finding with "Low" severity or
-     * higher, that includes "Low", "Medium", "High" and "Critical".
-     */
-    SeverityLowOrHigher = 6,
-    /**
-     * Send message only if there is at least one finding with "None" severity.
-     */
-    SeverityNone = 7,
-    /**
-     * Send message only if there is at least one finding with "None" severity or
-     * higher, that includes "None", "Low", "Medium", "High" and "Critical".
-     */
-    SeverityNoneOrHigher = 8,
-    /**
-     * Send message only if there is at least one finding with "Unknown" severity.
-     */
-    SeverityUnknown = 9,
-    /**
-     * Send message only if there is at least one finding with "Unknown" severity
-     * or higher, that includes "Unknown", "None", "Low", "Medium", "High" and "Critical".
-     */
-    SeverityUnknownOrHigher = 10,
-    /**
-     * Send message only if there is at least one finding with "Error" level.
-     * Since it is the higher possible level, it is the same as "Error" or higher.
-     */
-    LevelError = 11,
-    /**
-     * Send message only if there is at least one finding with "Warning" level.
-     */
-    LevelWarning = 12,
-    /**
-     * Send message only if there is at least one finding with "Warning" level or
-     * higher, that includes "Warning" and "Error".
-     */
-    LevelWarningOrHigher = 13,
-    /**
-     * Send message only if there is at least one finding with "Note" level.
-     */
-    LevelNote = 14,
-    /**
-     * Send message only if there is at least one finding with "Note" level or
-     * higher, that includes "Note", "Warning" and "Error.
-     */
-    LevelNoteOrHigher = 15,
-    /**
-     * Send message only if there is at least one finding with "None" level.
-     */
-    LevelNone = 16,
-    /**
-     * Send message only if there is at least one finding with "None" level or
-     * higher, that includes "None", "Note", "Warning" and "Error.
-     */
-    LevelNoneOrHigher = 17,
-    /**
-     * Send message only if there is at least one finding with "Unknown" level.
-     */
-    LevelUnknown = 18,
-    /**
-     * Send message only if there is at least one finding with "Unknown" level or
-     * higher, that includes "Unknown", "None", "Note", "Warning" and "Error.
-     */
-    LevelUnknownOrHigher = 19,
-    /**
-     * Always send a message.
-     */
-    Always = 20,
-    /**
-     * Send a message if at least 1 vulnerability is found.
-     */
-    Some = 21,
-    /**
-     * Send a message only if no vulnerabilities are found.
-     */
-    Empty = 22,
-    /**
-     * Never send a message.
-     */
-    Never = 23
-}
-
-export { }