@thymian/plugin-reporter 0.1.0

package/README.md

@@ -0,0 +1,11 @@
+# Thymian
+
+Add resilience and HTTP conformance to your API development workflow. Thymian is a lightweight, language-agnostic library that helps you build robust APIs.
+
+## @thymian/reporter
+
+Event-based reporting for test results and issues.
+
+## Documentation
+
+For comprehensive documentation, visit [Thymian Documentation](https://thymian.dev/).

package/dist/formatter.d.ts

@@ -0,0 +1,18 @@
+import type { ThymianReport, ThymianReportSeverity } from '@thymian/core';
+export type ThymianReportStatistics = {
+    numberOfReports: number;
+    numberOfItems: number;
+    severityCounts: Record<ThymianReportSeverity, number>;
+};
+export type ReportAnalysis = {
+    reports: ThymianReport[];
+    statistics: ThymianReportStatistics;
+};
+export declare function analyze(reports: ThymianReport[]): ReportAnalysis;
+export interface Formatter<Options = Record<PropertyKey, unknown>> {
+    options: Options;
+    init(options: Options): void | Promise<void>;
+    report(report: ThymianReport): void | Promise<void>;
+    flush(): string | undefined | Promise<string | undefined>;
+}
+//# sourceMappingURL=formatter.d.ts.map

package/dist/formatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatter.d.ts","sourceRoot":"","sources":["../src/formatter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EAEb,qBAAqB,EACtB,MAAM,eAAe,CAAC;AAEvB,MAAM,MAAM,uBAAuB,GAAG;IACpC,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;CACvD,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,UAAU,EAAE,uBAAuB,CAAC;CACrC,CAAC;AAQF,wBAAgB,OAAO,CAAC,OAAO,EAAE,aAAa,EAAE,GAAG,cAAc,CAsBhE;AAED,MAAM,WAAW,SAAS,CAAC,OAAO,GAAG,MAAM,CAAC,WAAW,EAAE,OAAO,CAAC;IAC/D,OAAO,EAAE,OAAO,CAAC;IAEjB,IAAI,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE7C,MAAM,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpD,KAAK,IAAI,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;CAC3D"}

package/dist/formatter.js

@@ -0,0 +1,24 @@
+function countItems(reports) {
+    return reports.flatMap((report) => report.sections?.flatMap((s) => s.items) ?? []);
+}
+export function analyze(reports) {
+    const items = countItems(reports);
+    const severityCounts = {
+        error: 0,
+        warn: 0,
+        hint: 0,
+        info: 0,
+    };
+    for (const item of items) {
+        severityCounts[item.severity]++;
+    }
+    return {
+        reports,
+        statistics: {
+            numberOfReports: reports.length,
+            numberOfItems: items.length,
+            severityCounts,
+        },
+    };
+}
+//# sourceMappingURL=formatter.js.map

package/dist/formatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatter.js","sourceRoot":"","sources":["../src/formatter.ts"],"names":[],"mappings":"AAiBA,SAAS,UAAU,CAAC,OAAwB;IAC1C,OAAO,OAAO,CAAC,OAAO,CACpB,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAC3D,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,OAAwB;IAC9C,MAAM,KAAK,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;IAElC,MAAM,cAAc,GAA0C;QAC5D,KAAK,EAAE,CAAC;QACR,IAAI,EAAE,CAAC;QACP,IAAI,EAAE,CAAC;QACP,IAAI,EAAE,CAAC;KACR,CAAC;IAEF,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,cAAc,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;IAClC,CAAC;IAED,OAAO;QACL,OAAO;QACP,UAAU,EAAE;YACV,eAAe,EAAE,OAAO,CAAC,MAAM;YAC/B,aAAa,EAAE,KAAK,CAAC,MAAM;YAC3B,cAAc;SACf;KACF,CAAC;AACJ,CAAC"}

package/dist/formatters/csv.d.ts

@@ -0,0 +1,17 @@
+import type { Logger, ThymianReport } from '@thymian/core';
+import type { Formatter } from '../formatter.js';
+export type CsvFormatterOptions = {
+    path: string;
+};
+export declare class CsvFormatter implements Formatter<CsvFormatterOptions> {
+    private readonly logger;
+    private stream;
+    options: CsvFormatterOptions;
+    constructor(logger: Logger);
+    flush(): Promise<string | undefined>;
+    init(options: CsvFormatterOptions): Promise<void>;
+    report(report: ThymianReport): Promise<void>;
+}
+export declare function thymianReportToCsvLines(report: ThymianReport): string[];
+export declare function csvSafe(str: string | undefined): string;
+//# sourceMappingURL=csv.d.ts.map

package/dist/formatters/csv.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"csv.d.ts","sourceRoot":"","sources":["../../src/formatters/csv.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAE3D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,qBAAa,YAAa,YAAW,SAAS,CAAC,mBAAmB,CAAC;IAKrD,OAAO,CAAC,QAAQ,CAAC,MAAM;IAJnC,OAAO,CAAC,MAAM,CAAe;IAE7B,OAAO,EAAG,mBAAmB,CAAC;gBAED,MAAM,EAAE,MAAM;IAE3C,KAAK,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAUpC,IAAI,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAmBjD,MAAM,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;CAmB7C;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,EAAE,CAkBvE;AAED,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAavD"}

package/dist/formatters/csv.js

@@ -0,0 +1,74 @@
+import { createWriteStream } from 'node:fs';
+export class CsvFormatter {
+    logger;
+    stream;
+    options;
+    constructor(logger) {
+        this.logger = logger;
+    }
+    flush() {
+        return new Promise((resolve) => {
+            this.stream.end(() => {
+                this.logger.debug(`Wrote CSV report to ${this.options.path}`);
+                resolve(undefined);
+            });
+        });
+    }
+    init(options) {
+        this.options = options;
+        this.stream = createWriteStream(options.path, 'utf-8');
+        this.stream.on('error', (err) => {
+            this.logger.error(`Failed to write CSV report to ${this.options.path}: ${err.message}`);
+        });
+        return new Promise((resolve) => {
+            this.stream.on('ready', () => {
+                this.stream.write('source,section,severity,ruleName,message,details\n');
+                resolve();
+            });
+        });
+    }
+    report(report) {
+        return new Promise((resolve, reject) => {
+            const lines = thymianReportToCsvLines(report);
+            if (lines.length === 0) {
+                resolve();
+                return;
+            }
+            const data = lines.join('');
+            this.stream.write(data, (err) => {
+                if (err) {
+                    reject(err);
+                }
+                else {
+                    resolve();
+                }
+            });
+        });
+    }
+}
+export function thymianReportToCsvLines(report) {
+    const lines = [];
+    if (!report.sections || report.sections.length === 0) {
+        // Report with no sections — emit a single row with source and message
+        lines.push(`${csvSafe(report.source)},,,,${csvSafe(report.message)},\n`);
+        return lines;
+    }
+    for (const section of report.sections) {
+        for (const item of section.items) {
+            lines.push(`${csvSafe(report.source)},${csvSafe(section.heading)},${csvSafe(item.severity)},${csvSafe(item.ruleName)},${csvSafe(item.message)},${csvSafe(item.details)}\n`);
+        }
+    }
+    return lines;
+}
+export function csvSafe(str) {
+    if (!str) {
+        return '';
+    }
+    // Escape double quotes by doubling them, wrap in quotes if needed
+    const escaped = str.replaceAll('"', '""').replaceAll('\n', ' ');
+    if (escaped.includes(',') || escaped.includes('"') || escaped.includes(' ')) {
+        return `"${escaped}"`;
+    }
+    return escaped;
+}
+//# sourceMappingURL=csv.js.map

package/dist/formatters/csv.js.map

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

package/dist/formatters/markdown.d.ts

@@ -0,0 +1,17 @@
+import type { Logger, ThymianReport, ThymianReportSeverity } from '@thymian/core';
+import { type Formatter } from '../formatter.js';
+export declare const details: (text: string) => string;
+export declare function mapSeverityToBadge(severity: ThymianReportSeverity): string;
+export type MarkdownFormatterOptions = {
+    path: string;
+};
+export declare class MarkdownFormatter implements Formatter<MarkdownFormatterOptions> {
+    private readonly logger;
+    options: MarkdownFormatterOptions;
+    private readonly reports;
+    constructor(logger: Logger);
+    init(options: MarkdownFormatterOptions): void;
+    report(report: ThymianReport): void;
+    flush(): Promise<string | undefined>;
+}
+//# sourceMappingURL=markdown.d.ts.map

package/dist/formatters/markdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../../src/formatters/markdown.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,MAAM,EACN,aAAa,EACb,qBAAqB,EACtB,MAAM,eAAe,CAAC;AAGvB,OAAO,EAAW,KAAK,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAG1D,eAAO,MAAM,OAAO,GAAI,MAAM,MAAM,KAAG,MAK1B,CAAC;AAEd,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,qBAAqB,GAAG,MAAM,CAW1E;AAED,MAAM,MAAM,wBAAwB,GAAG;IACrC,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,qBAAa,iBAAkB,YAAW,SAAS,CAAC,wBAAwB,CAAC;IAK/D,OAAO,CAAC,QAAQ,CAAC,MAAM;IAJnC,OAAO,EAAG,wBAAwB,CAAC;IAEnC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAuB;gBAElB,MAAM,EAAE,MAAM;IAE3C,IAAI,CAAC,OAAO,EAAE,wBAAwB,GAAG,IAAI;IAI7C,MAAM,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI;IAI7B,KAAK,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;CAuE3C"}

package/dist/formatters/markdown.js

@@ -0,0 +1,85 @@
+import * as path from 'node:path';
+import { mkdir, writeFile } from 'fs/promises';
+import { analyze } from '../formatter.js';
+import { errorSymbol, hintSymbol, warnSymbol } from '../style.js';
+export const details = (text) => `
+  <details>
+  <summary>More details</summary>
+  ${text}
+  </details>`;
+export function mapSeverityToBadge(severity) {
+    if (severity === 'error') {
+        return `${errorSymbol} error`;
+    }
+    if (severity === 'warn') {
+        return `${warnSymbol} warning`;
+    }
+    if (severity === 'hint') {
+        return `${hintSymbol} hint`;
+    }
+    return 'info';
+}
+export class MarkdownFormatter {
+    logger;
+    options;
+    reports = [];
+    constructor(logger) {
+        this.logger = logger;
+    }
+    init(options) {
+        this.options = options;
+    }
+    report(report) {
+        this.reports.push(report);
+    }
+    async flush() {
+        if (this.reports.length === 0) {
+            return undefined;
+        }
+        const analysis = analyze(this.reports);
+        const lines = [];
+        lines.push('# Thymian Report');
+        const { numberOfReports, numberOfItems, severityCounts } = analysis.statistics;
+        lines.push(`A total of ${numberOfReports} reports with ${numberOfItems} items were found.`);
+        lines.push(`Of these there are ${severityCounts.error} errors, ${severityCounts.warn} warnings, ${severityCounts.hint} hints and ${severityCounts.info} infos.`);
+        lines.push('');
+        for (const report of analysis.reports) {
+            lines.push(`## ${report.source}`);
+            lines.push('');
+            if (report.message) {
+                lines.push(`  ${report.message}`);
+                lines.push('');
+                lines.push('');
+            }
+            if (report.sections) {
+                for (const section of report.sections) {
+                    lines.push(`### ${section.heading}`);
+                    lines.push('');
+                    for (const item of section.items) {
+                        const sev = mapSeverityToBadge(item.severity);
+                        lines.push(`- **${sev}**: ${item.message}`);
+                        if (item.ruleName) {
+                            lines.push(`<br/>  *Rule: ${item.ruleName}*`);
+                        }
+                        if (item.details) {
+                            lines.push(details(item.details));
+                        }
+                        if (item.links && item.links.length > 0) {
+                            lines.push('  Related links:');
+                            for (const link of item.links) {
+                                lines.push(`  - [${link.title ?? link.url}](${link.url})`);
+                            }
+                        }
+                    }
+                    lines.push('');
+                }
+            }
+            lines.push('');
+        }
+        await mkdir(path.dirname(this.options.path), { recursive: true });
+        await writeFile(this.options.path, lines.join('\n'), 'utf-8');
+        this.logger.debug(`Wrote Markdown report to ${this.options.path}.`);
+        return undefined;
+    }
+}
+//# sourceMappingURL=markdown.js.map

package/dist/formatters/markdown.js.map

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

package/dist/formatters/text.d.ts

@@ -0,0 +1,15 @@
+import type { ThymianReport, ThymianReportSeverity } from '@thymian/core';
+import { type Formatter } from '../formatter.js';
+export declare function formatSeverityPrefix(severity: ThymianReportSeverity): string;
+export type TextFormatterOptions = {
+    summaryOnly: boolean;
+    path?: string;
+};
+export declare class TextFormatter implements Formatter<Partial<TextFormatterOptions>> {
+    options: TextFormatterOptions;
+    private readonly reports;
+    init(options: Partial<TextFormatterOptions>): void;
+    flush(): Promise<string | undefined>;
+    report(report: ThymianReport): void;
+}
+//# sourceMappingURL=text.d.ts.map

package/dist/formatters/text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.d.ts","sourceRoot":"","sources":["../../src/formatters/text.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAI1E,OAAO,EAAW,KAAK,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAQ1D,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,qBAAqB,GAAG,MAAM,CAY5E;AAED,MAAM,MAAM,oBAAoB,GAAG;IACjC,WAAW,EAAE,OAAO,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,qBAAa,aAAc,YAAW,SAAS,CAAC,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAC5E,OAAO,EAAG,oBAAoB,CAAC;IAE/B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAuB;IAE/C,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,oBAAoB,CAAC,GAAG,IAAI;IAO5C,KAAK,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAqE1C,MAAM,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI;CAGpC"}

package/dist/formatters/text.js

@@ -0,0 +1,84 @@
+import * as path from 'node:path';
+import { stripVTControlCharacters } from 'node:util';
+import chalk from 'chalk';
+import { mkdir, writeFile } from 'fs/promises';
+import { analyze } from '../formatter.js';
+import { errorSymbol, hintSymbol, successSymbol, warnSymbol, } from '../style.js';
+export function formatSeverityPrefix(severity) {
+    if (severity === 'hint') {
+        return `${chalk.blue(`${hintSymbol} ${severity}`)}: `;
+    }
+    if (severity === 'warn') {
+        return `${chalk.yellow(`${warnSymbol} warning`)}: `;
+    }
+    if (severity === 'error') {
+        return `${chalk.red(`${errorSymbol} ${severity}`)}: `;
+    }
+    return '';
+}
+export class TextFormatter {
+    options;
+    reports = [];
+    init(options) {
+        this.options = {
+            summaryOnly: false,
+            ...options,
+        };
+    }
+    async flush() {
+        if (this.reports.length === 0) {
+            const message = `${chalk.green(successSymbol)} No problems found`;
+            if (this.options.path) {
+                const plainText = stripVTControlCharacters(message);
+                await mkdir(path.dirname(this.options.path), { recursive: true });
+                await writeFile(this.options.path, plainText, 'utf-8');
+            }
+            return message;
+        }
+        const analysis = analyze(this.reports);
+        const lines = [];
+        if (!this.options.summaryOnly) {
+            for (const report of analysis.reports) {
+                lines.push(`${report.source} ${Array.from({
+                    length: Math.max(1, 80 - report.source.length),
+                })
+                    .map(() => '─')
+                    .join('')}`);
+                lines.push('');
+                if (report.message) {
+                    lines.push(`  ${report.message}`);
+                    lines.push('');
+                    lines.push('');
+                }
+                if (report.sections && report.sections.length > 0) {
+                    for (const section of report.sections) {
+                        lines.push(`  ${chalk.bold(section.heading)}`);
+                        lines.push('');
+                        for (const item of section.items) {
+                            const prefix = formatSeverityPrefix(item.severity);
+                            lines.push(`    ${prefix}${item.message}`);
+                            if (item.ruleName) {
+                                lines.push(`       ${chalk.dim(item.ruleName)}`);
+                            }
+                        }
+                        lines.push('');
+                    }
+                }
+            }
+        }
+        lines.push('');
+        const { error, warn, hint } = analysis.statistics.severityCounts;
+        lines.push(`Found ${chalk.red(`${error} ${error === 1 ? 'error' : 'errors'}`)}, ${chalk.yellow(`${warn} ${warn === 1 ? 'warning' : 'warnings'}`)} and ${chalk.blue(`${hint} ${hint === 1 ? 'hint' : 'hints'}`)}.`);
+        const coloredOutput = lines.join('\n');
+        if (this.options.path) {
+            const plainText = stripVTControlCharacters(coloredOutput);
+            await mkdir(path.dirname(this.options.path), { recursive: true });
+            await writeFile(this.options.path, plainText, 'utf-8');
+        }
+        return coloredOutput;
+    }
+    report(report) {
+        this.reports.push(report);
+    }
+}
+//# sourceMappingURL=text.js.map

package/dist/formatters/text.js.map

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

package/dist/get-formatters.d.ts

@@ -0,0 +1,27 @@
+import { type Logger } from '@thymian/core';
+import type { Formatter } from './formatter.js';
+import { type CsvFormatterOptions } from './formatters/csv.js';
+import { type MarkdownFormatterOptions } from './formatters/markdown.js';
+import { type TextFormatterOptions } from './formatters/text.js';
+export type Formatters = {
+    text: Partial<TextFormatterOptions>;
+    markdown: Partial<MarkdownFormatterOptions>;
+    csv: Partial<CsvFormatterOptions>;
+};
+export type ReporterPluginOptions = {
+    formatters?: Partial<Formatters>;
+};
+export type FormatterConstructor<T> = (logger: Logger) => Formatter<T>;
+export type FormatterRegistryEntry<K extends keyof Formatters> = {
+    factory: FormatterConstructor<Formatters[K]>;
+    prepareOptions: <T = Formatters[K]>(options: Formatters[K], pluginOptions: {
+        cwd: string;
+        logger: Logger;
+    }) => Formatters[K] | T;
+};
+export declare const FORMATTER_REGISTRY: {
+    [K in keyof Formatters]: FormatterRegistryEntry<K>;
+};
+export declare function isValidFormatter(name: string): name is keyof Formatters;
+export declare function getFormatters(config: ReporterPluginOptions['formatters'], cwd: string, logger: Logger): Promise<Formatter[]>;
+//# sourceMappingURL=get-formatters.d.ts.map

package/dist/get-formatters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-formatters.d.ts","sourceRoot":"","sources":["../src/get-formatters.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,MAAM,EAAoB,MAAM,eAAe,CAAC;AAE9D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAgB,KAAK,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC7E,OAAO,EAEL,KAAK,wBAAwB,EAC9B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAiB,KAAK,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAEhF,MAAM,MAAM,UAAU,GAAG;IACvB,IAAI,EAAE,OAAO,CAAC,oBAAoB,CAAC,CAAC;IACpC,QAAQ,EAAE,OAAO,CAAC,wBAAwB,CAAC,CAAC;IAC5C,GAAG,EAAE,OAAO,CAAC,mBAAmB,CAAC,CAAC;CACnC,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,UAAU,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;CAClC,CAAC;AAEF,MAAM,MAAM,oBAAoB,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC;AAEvE,MAAM,MAAM,sBAAsB,CAAC,CAAC,SAAS,MAAM,UAAU,IAAI;IAC/D,OAAO,EAAE,oBAAoB,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7C,cAAc,EAAE,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,EAChC,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,EACtB,aAAa,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,KAC3C,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;CACxB,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE;KAC9B,CAAC,IAAI,MAAM,UAAU,GAAG,sBAAsB,CAAC,CAAC,CAAC;CAoC1C,CAAC;AAEX,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,IAAI,MAAM,UAAU,CAEvE;AAED,wBAAsB,aAAa,CACjC,MAAM,EAAE,qBAAqB,CAAC,YAAY,CAAM,EAChD,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,SAAS,EAAE,CAAC,CA+BtB"}

package/dist/get-formatters.js

@@ -0,0 +1,61 @@
+import { join } from 'node:path';
+import { ThymianBaseError } from '@thymian/core';
+import { CsvFormatter } from './formatters/csv.js';
+import { MarkdownFormatter, } from './formatters/markdown.js';
+import { TextFormatter } from './formatters/text.js';
+export const FORMATTER_REGISTRY = {
+    text: {
+        factory: () => new TextFormatter(),
+        prepareOptions: (options, { cwd }) => ({
+            summaryOnly: false,
+            ...options,
+            ...(typeof options.path === 'string'
+                ? { path: join(cwd, options.path) }
+                : {}),
+        }),
+    },
+    markdown: {
+        factory: (logger) => new MarkdownFormatter(logger),
+        prepareOptions: (options, pluginOptions) => ({
+            path: join(pluginOptions.cwd, typeof options.path === 'string'
+                ? options.path
+                : '.thymian/reports/report.md'),
+            ...options,
+        }),
+    },
+    csv: {
+        factory: (logger) => new CsvFormatter(logger),
+        prepareOptions: (options, { cwd }) => ({
+            path: join(cwd, typeof options.path === 'string'
+                ? options.path
+                : '.thymian/reports/report.csv'),
+            ...options,
+        }),
+    },
+};
+export function isValidFormatter(name) {
+    return Object.hasOwn(FORMATTER_REGISTRY, name);
+}
+export async function getFormatters(config = {}, cwd, logger) {
+    return Promise.all(Object.entries(config).map(async ([name, options]) => {
+        if (!isValidFormatter(name)) {
+            throw new ThymianBaseError(`Unknown formatter "${name}". Available formatters: ${Object.keys(FORMATTER_REGISTRY).join(', ')}.`, {
+                name: 'UnknownFormatterError',
+                ref: 'https://thymian.dev/references/errors/unknown-formatter-error/',
+                suggestions: [
+                    'If you want to add your own formatter, implement a new plugin and listen on the `core.report` event and/or open a Github issue.',
+                ],
+            });
+        }
+        const formatterConfig = FORMATTER_REGISTRY[name];
+        const formatter = formatterConfig.factory(logger);
+        const preparedOptions = formatterConfig.prepareOptions(options, {
+            cwd,
+            logger,
+        });
+        // we know that the options are valid, so we can safely cast them
+        await formatter.init(preparedOptions);
+        return formatter;
+    }));
+}
+//# sourceMappingURL=get-formatters.js.map

package/dist/get-formatters.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+import { type ThymianPlugin } from '@thymian/core';
+import { type Formatters } from './get-formatters.js';
+export type ReporterPluginOptions = {
+    formatters?: Partial<Formatters>;
+};
+export declare const reporterPlugin: ThymianPlugin<ReporterPluginOptions>;
+export default reporterPlugin;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,aAAa,EAAsB,MAAM,eAAe,CAAC;AAEvE,OAAO,EAAE,KAAK,UAAU,EAAiB,MAAM,qBAAqB,CAAC;AAErE,MAAM,MAAM,qBAAqB,GAAG;IAClC,UAAU,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;CAClC,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,aAAa,CAAC,qBAAqB,CAgH/D,CAAC;AAEF,eAAe,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,100 @@
+import {} from '@thymian/core';
+import { getFormatters } from './get-formatters.js';
+export const reporterPlugin = {
+    name: '@thymian/plugin-reporter',
+    options: {
+        type: 'object',
+        additionalProperties: false,
+        properties: {
+            formatters: {
+                nullable: true,
+                description: 'Configuration for different report formatters',
+                type: 'object',
+                properties: {
+                    text: {
+                        nullable: true,
+                        description: 'Configuration for the text (console) formatter',
+                        type: 'object',
+                        properties: {
+                            summaryOnly: {
+                                description: 'When true, only shows the summary without detailed reports',
+                                type: 'boolean',
+                                nullable: true,
+                            },
+                            path: {
+                                description: 'File path where the plain text report will be saved (ANSI escape codes are stripped)',
+                                type: 'string',
+                                nullable: true,
+                            },
+                        },
+                        additionalProperties: false,
+                    },
+                    markdown: {
+                        description: 'Configuration for the Markdown formatter',
+                        nullable: true,
+                        type: 'object',
+                        properties: {
+                            path: {
+                                description: 'File path where the markdown report will be saved',
+                                type: 'string',
+                                nullable: true,
+                            },
+                        },
+                        additionalProperties: false,
+                    },
+                    csv: {
+                        description: 'Configuration for the CSV formatter',
+                        nullable: true,
+                        type: 'object',
+                        properties: {
+                            path: {
+                                description: 'File path where the CSV report will be saved',
+                                type: 'string',
+                                nullable: true,
+                            },
+                        },
+                        additionalProperties: false,
+                    },
+                },
+                additionalProperties: false,
+            },
+        },
+    },
+    version: '0.x',
+    events: {
+        listensOn: ['core.report'],
+    },
+    actions: {
+        listensOn: ['core.report.flush', 'core.close'],
+    },
+    async plugin(emitter, logger, { formatters: userFormatters, cwd }) {
+        const formatters = Object.fromEntries(Object.entries({
+            text: {},
+            ...(userFormatters ?? {}),
+        }).filter(([, options]) => options != null));
+        let hasFlushed = false;
+        const flushReporters = async () => {
+            if (hasFlushed) {
+                return {};
+            }
+            hasFlushed = true;
+            const results = await Promise.all(reporters.map(async (r) => r.flush()));
+            // Collect text output from formatters that return strings (e.g. TextFormatter)
+            const textParts = results.filter((r) => typeof r === 'string');
+            return textParts.length > 0 ? { text: textParts.join('\n') } : {};
+        };
+        const reporters = await getFormatters(formatters, cwd, logger);
+        emitter.on('core.report', async (report) => {
+            reporters.forEach((r) => r.report(report));
+        });
+        emitter.onAction('core.report.flush', async (_event, ctx) => {
+            ctx.reply(await flushReporters());
+        });
+        emitter.onAction('core.close', async (_event, ctx) => {
+            await flushReporters();
+            ctx.reply();
+        });
+    },
+};
+export default reporterPlugin;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/style.d.ts

@@ -0,0 +1,5 @@
+export declare const errorSymbol = "\u2716";
+export declare const warnSymbol = "\u26A0";
+export declare const hintSymbol = "\u2139";
+export declare const successSymbol = "\u2713";
+//# sourceMappingURL=style.d.ts.map

package/dist/style.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"style.d.ts","sourceRoot":"","sources":["../src/style.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,WAAW,WAAM,CAAC;AAC/B,eAAO,MAAM,UAAU,WAAM,CAAC;AAC9B,eAAO,MAAM,UAAU,WAAM,CAAC;AAC9B,eAAO,MAAM,aAAa,WAAM,CAAC"}

package/dist/style.js

@@ -0,0 +1,5 @@
+export const errorSymbol = '✖';
+export const warnSymbol = '⚠';
+export const hintSymbol = 'ℹ';
+export const successSymbol = '✓';
+//# sourceMappingURL=style.js.map

package/dist/style.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"style.js","sourceRoot":"","sources":["../src/style.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,WAAW,GAAG,GAAG,CAAC;AAC/B,MAAM,CAAC,MAAM,UAAU,GAAG,GAAG,CAAC;AAC9B,MAAM,CAAC,MAAM,UAAU,GAAG,GAAG,CAAC;AAC9B,MAAM,CAAC,MAAM,aAAa,GAAG,GAAG,CAAC"}

package/dist/utils.d.ts

@@ -0,0 +1,2 @@
+export declare function createList(list: string[]): string;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,CAgBjD"}

package/dist/utils.js

@@ -0,0 +1,17 @@
+export function createList(list) {
+    if (list.length === 0) {
+        return '';
+    }
+    else if (list.length === 1) {
+        return `${list[0]}`;
+    }
+    else {
+        // length >= 2
+        const last = list.at(-1);
+        return (list
+            .slice(0, list.length - 1)
+            .map((el) => `${el}`)
+            .join(', ') + ` and ${last}`);
+    }
+}
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,UAAU,CAAC,IAAc;IACvC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO,EAAE,CAAC;IACZ,CAAC;SAAM,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7B,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IACtB,CAAC;SAAM,CAAC;QACN,cAAc;QACd,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAW,CAAC;QAEnC,OAAO,CACL,IAAI;aACD,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;aACzB,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC;aACpB,IAAI,CAAC,IAAI,CAAC,GAAG,QAAQ,IAAI,EAAE,CAC/B,CAAC;IACJ,CAAC;AACH,CAAC"}

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "@thymian/plugin-reporter",
+  "version": "0.1.0",
+  "license": "AGPL-3.0-only",
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "!**/*.tsbuildinfo"
+  ],
+  "dependencies": {
+    "chalk": "^4.1.2",
+    "tslib": "^2.3.0",
+    "@thymian/core": "0.1.0"
+  }
+}