modestbench 0.0.1

package/dist/reporters/registry.cjs

@@ -0,0 +1,255 @@
+"use strict";
+/**
+ * ModestBench Reporter Registry
+ *
+ * Plugin-based system for managing benchmark output formatters. Supports
+ * registration, retrieval, and lifecycle management of reporters.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ModestBenchReporterRegistry = exports.CompositeReporter = exports.BaseReporter = void 0;
+/**
+ * Base abstract reporter class providing common functionality
+ */
+class BaseReporter {
+    name;
+    options;
+    constructor(name, options = {}) {
+        this.name = name;
+        this.options = options;
+    }
+    /**
+     * Get reporter name
+     */
+    getName() {
+        return this.name;
+    }
+    /**
+     * Get reporter options
+     */
+    getOptions() {
+        return { ...this.options };
+    }
+    /**
+     * Utility method to format duration in human-readable format
+     */
+    formatDuration(nanoseconds) {
+        if (nanoseconds < 1000) {
+            return `${nanoseconds.toFixed(2)}ns`;
+        }
+        else if (nanoseconds < 1000000) {
+            return `${(nanoseconds / 1000).toFixed(2)}μs`;
+        }
+        else if (nanoseconds < 1000000000) {
+            return `${(nanoseconds / 1000000).toFixed(2)}ms`;
+        }
+        else {
+            return `${(nanoseconds / 1000000000).toFixed(2)}s`;
+        }
+    }
+    /**
+     * Utility method to format operations per second
+     */
+    formatOpsPerSecond(opsPerSecond) {
+        if (opsPerSecond < 1000) {
+            return `${opsPerSecond.toFixed(2)} ops/sec`;
+        }
+        else if (opsPerSecond < 1000000) {
+            return `${(opsPerSecond / 1000).toFixed(2)}K ops/sec`;
+        }
+        else if (opsPerSecond < 1000000000) {
+            return `${(opsPerSecond / 1000000).toFixed(2)}M ops/sec`;
+        }
+        else {
+            return `${(opsPerSecond / 1000000000).toFixed(2)}B ops/sec`;
+        }
+    }
+    /**
+     * Utility method to format percentage
+     */
+    formatPercentage(value) {
+        return `${value.toFixed(2)}%`;
+    }
+    /**
+     * Utility method to safely handle async operations
+     */
+    async safeAsync(operation) {
+        try {
+            return await operation();
+        }
+        catch (error) {
+            await this.onError(error instanceof Error ? error : new Error(String(error)));
+            return null;
+        }
+    }
+}
+exports.BaseReporter = BaseReporter;
+/**
+ * Composite reporter that broadcasts events to multiple reporters
+ */
+class CompositeReporter extends BaseReporter {
+    reporters;
+    constructor(reporters) {
+        super('composite', {});
+        this.reporters = [...reporters];
+    }
+    /**
+     * Add a reporter to the composite
+     */
+    addReporter(reporter) {
+        this.reporters.push(reporter);
+    }
+    /**
+     * Get all reporters in the composite
+     */
+    getReporters() {
+        return [...this.reporters];
+    }
+    async onEnd(run) {
+        await this.broadcastAsync('onEnd', run);
+    }
+    async onError(error) {
+        await this.broadcastAsync('onError', error);
+    }
+    async onFileEnd(result) {
+        await this.broadcastAsync('onFileEnd', result);
+    }
+    async onFileStart(file) {
+        await this.broadcastAsync('onFileStart', file);
+    }
+    async onProgress(state) {
+        await this.broadcastAsync('onProgress', state);
+    }
+    async onStart(run) {
+        await this.broadcastAsync('onStart', run);
+    }
+    async onSuiteEnd(result) {
+        await this.broadcastAsync('onSuiteEnd', result);
+    }
+    async onSuiteStart(suite) {
+        await this.broadcastAsync('onSuiteStart', suite);
+    }
+    async onTaskResult(result) {
+        await this.broadcastAsync('onTaskResult', result);
+    }
+    async onTaskStart(task) {
+        await this.broadcastAsync('onTaskStart', task);
+    }
+    /**
+     * Remove a reporter from the composite
+     */
+    removeReporter(reporter) {
+        const index = this.reporters.indexOf(reporter);
+        if (index >= 0) {
+            this.reporters.splice(index, 1);
+            return true;
+        }
+        return false;
+    }
+    /**
+     * Broadcast an event to all reporters with error handling
+     */
+    async broadcastAsync(method, ...args) {
+        const promises = this.reporters.map(async (reporter) => {
+            try {
+                const reporterMethod = reporter[method];
+                if (typeof reporterMethod === 'function') {
+                    // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment, @typescript-eslint/no-unsafe-call
+                    const result = reporterMethod(...args);
+                    // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access
+                    if (result && typeof result.then === 'function') {
+                        await result;
+                    }
+                }
+            }
+            catch (error) {
+                // Handle reporter-specific errors without affecting others
+                console.error(`Reporter error in ${reporter.constructor.name}.${method}:`, error);
+            }
+        });
+        await Promise.all(promises);
+    }
+}
+exports.CompositeReporter = CompositeReporter;
+/**
+ * Reporter registry implementation for managing multiple reporters
+ */
+class ModestBenchReporterRegistry {
+    reporters = new Map();
+    /**
+     * Clear all registered reporters
+     */
+    clear() {
+        this.reporters.clear();
+    }
+    /**
+     * Get a reporter by name
+     */
+    get(name) {
+        return this.reporters.get(name);
+    }
+    /**
+     * Get all registered reporters
+     */
+    getAll() {
+        const result = {};
+        this.reporters.forEach((reporter, name) => {
+            result[name] = reporter;
+        });
+        return result;
+    }
+    /**
+     * Get multiple reporters by names
+     */
+    getByNames(names) {
+        const result = [];
+        const missing = [];
+        for (const name of names) {
+            const reporter = this.reporters.get(name);
+            if (reporter) {
+                result.push(reporter);
+            }
+            else {
+                missing.push(name);
+            }
+        }
+        if (missing.length > 0) {
+            throw new Error(`Unknown reporters: ${missing.join(', ')}. Available: ${Array.from(this.reporters.keys()).join(', ')}`);
+        }
+        return result;
+    }
+    /**
+     * Get list of registered reporter names
+     */
+    getNames() {
+        return Array.from(this.reporters.keys());
+    }
+    /**
+     * Check if a reporter is registered
+     */
+    has(name) {
+        return this.reporters.has(name);
+    }
+    /**
+     * Register a reporter with a unique name
+     */
+    register(name, reporter) {
+        if (this.reporters.has(name)) {
+            throw new Error(`Reporter with name "${name}" is already registered`);
+        }
+        this.reporters.set(name, reporter);
+    }
+    /**
+     * Get count of registered reporters
+     */
+    size() {
+        return this.reporters.size;
+    }
+    /**
+     * Unregister a reporter
+     */
+    unregister(name) {
+        return this.reporters.delete(name);
+    }
+}
+exports.ModestBenchReporterRegistry = ModestBenchReporterRegistry;
+//# sourceMappingURL=registry.js.map

package/dist/reporters/registry.cjs.map

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

package/dist/reporters/registry.d.cts

@@ -0,0 +1,155 @@
+/**
+ * ModestBench Reporter Registry
+ *
+ * Plugin-based system for managing benchmark output formatters. Supports
+ * registration, retrieval, and lifecycle management of reporters.
+ */
+import type { BenchmarkRun, FileResult, ProgressState, Reporter, ReporterRegistry, SuiteResult, TaskResult } from "../types/index.cjs";
+/**
+ * Base abstract reporter class providing common functionality
+ */
+export declare abstract class BaseReporter implements Reporter {
+    protected readonly name: string;
+    protected readonly options: Record<string, unknown>;
+    constructor(name: string, options?: Record<string, unknown>);
+    /**
+     * Get reporter name
+     */
+    getName(): string;
+    /**
+     * Get reporter options
+     */
+    getOptions(): Record<string, unknown>;
+    /**
+     * Called when benchmark run completes
+     */
+    abstract onEnd(run: BenchmarkRun): Promise<void> | void;
+    /**
+     * Called when an error occurs
+     */
+    abstract onError(error: Error): Promise<void> | void;
+    /**
+     * Called when a file completes
+     */
+    abstract onFileEnd(result: FileResult): Promise<void> | void;
+    /**
+     * Called when a file starts execution
+     */
+    abstract onFileStart(file: string): Promise<void> | void;
+    /**
+     * Called for progress updates
+     */
+    abstract onProgress(state: ProgressState): Promise<void> | void;
+    /**
+     * Called when benchmark run starts
+     */
+    abstract onStart(run: BenchmarkRun): Promise<void> | void;
+    /**
+     * Called when a suite completes
+     */
+    abstract onSuiteEnd(result: SuiteResult): Promise<void> | void;
+    /**
+     * Called when a suite starts execution
+     */
+    abstract onSuiteStart(suite: string): Promise<void> | void;
+    /**
+     * Called when a task completes
+     */
+    abstract onTaskResult(result: TaskResult): Promise<void> | void;
+    /**
+     * Called when a task starts execution
+     */
+    abstract onTaskStart(task: string): Promise<void> | void;
+    /**
+     * Utility method to format duration in human-readable format
+     */
+    protected formatDuration(nanoseconds: number): string;
+    /**
+     * Utility method to format operations per second
+     */
+    protected formatOpsPerSecond(opsPerSecond: number): string;
+    /**
+     * Utility method to format percentage
+     */
+    protected formatPercentage(value: number): string;
+    /**
+     * Utility method to safely handle async operations
+     */
+    protected safeAsync<T>(operation: () => Promise<T>): Promise<null | T>;
+}
+/**
+ * Composite reporter that broadcasts events to multiple reporters
+ */
+export declare class CompositeReporter extends BaseReporter {
+    private readonly reporters;
+    constructor(reporters: Reporter[]);
+    /**
+     * Add a reporter to the composite
+     */
+    addReporter(reporter: Reporter): void;
+    /**
+     * Get all reporters in the composite
+     */
+    getReporters(): Reporter[];
+    onEnd(run: BenchmarkRun): Promise<void>;
+    onError(error: Error): Promise<void>;
+    onFileEnd(result: FileResult): Promise<void>;
+    onFileStart(file: string): Promise<void>;
+    onProgress(state: ProgressState): Promise<void>;
+    onStart(run: BenchmarkRun): Promise<void>;
+    onSuiteEnd(result: SuiteResult): Promise<void>;
+    onSuiteStart(suite: string): Promise<void>;
+    onTaskResult(result: TaskResult): Promise<void>;
+    onTaskStart(task: string): Promise<void>;
+    /**
+     * Remove a reporter from the composite
+     */
+    removeReporter(reporter: Reporter): boolean;
+    /**
+     * Broadcast an event to all reporters with error handling
+     */
+    private broadcastAsync;
+}
+/**
+ * Reporter registry implementation for managing multiple reporters
+ */
+export declare class ModestBenchReporterRegistry implements ReporterRegistry {
+    private readonly reporters;
+    /**
+     * Clear all registered reporters
+     */
+    clear(): void;
+    /**
+     * Get a reporter by name
+     */
+    get(name: string): Reporter | undefined;
+    /**
+     * Get all registered reporters
+     */
+    getAll(): Record<string, Reporter>;
+    /**
+     * Get multiple reporters by names
+     */
+    getByNames(names: string[]): Reporter[];
+    /**
+     * Get list of registered reporter names
+     */
+    getNames(): string[];
+    /**
+     * Check if a reporter is registered
+     */
+    has(name: string): boolean;
+    /**
+     * Register a reporter with a unique name
+     */
+    register(name: string, reporter: Reporter): void;
+    /**
+     * Get count of registered reporters
+     */
+    size(): number;
+    /**
+     * Unregister a reporter
+     */
+    unregister(name: string): boolean;
+}
+//# sourceMappingURL=registry.d.ts.map

package/dist/reporters/registry.d.cts.map

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

package/dist/reporters/registry.d.ts

@@ -0,0 +1,155 @@
+/**
+ * ModestBench Reporter Registry
+ *
+ * Plugin-based system for managing benchmark output formatters. Supports
+ * registration, retrieval, and lifecycle management of reporters.
+ */
+import type { BenchmarkRun, FileResult, ProgressState, Reporter, ReporterRegistry, SuiteResult, TaskResult } from "../types/index.js";
+/**
+ * Base abstract reporter class providing common functionality
+ */
+export declare abstract class BaseReporter implements Reporter {
+    protected readonly name: string;
+    protected readonly options: Record<string, unknown>;
+    constructor(name: string, options?: Record<string, unknown>);
+    /**
+     * Get reporter name
+     */
+    getName(): string;
+    /**
+     * Get reporter options
+     */
+    getOptions(): Record<string, unknown>;
+    /**
+     * Called when benchmark run completes
+     */
+    abstract onEnd(run: BenchmarkRun): Promise<void> | void;
+    /**
+     * Called when an error occurs
+     */
+    abstract onError(error: Error): Promise<void> | void;
+    /**
+     * Called when a file completes
+     */
+    abstract onFileEnd(result: FileResult): Promise<void> | void;
+    /**
+     * Called when a file starts execution
+     */
+    abstract onFileStart(file: string): Promise<void> | void;
+    /**
+     * Called for progress updates
+     */
+    abstract onProgress(state: ProgressState): Promise<void> | void;
+    /**
+     * Called when benchmark run starts
+     */
+    abstract onStart(run: BenchmarkRun): Promise<void> | void;
+    /**
+     * Called when a suite completes
+     */
+    abstract onSuiteEnd(result: SuiteResult): Promise<void> | void;
+    /**
+     * Called when a suite starts execution
+     */
+    abstract onSuiteStart(suite: string): Promise<void> | void;
+    /**
+     * Called when a task completes
+     */
+    abstract onTaskResult(result: TaskResult): Promise<void> | void;
+    /**
+     * Called when a task starts execution
+     */
+    abstract onTaskStart(task: string): Promise<void> | void;
+    /**
+     * Utility method to format duration in human-readable format
+     */
+    protected formatDuration(nanoseconds: number): string;
+    /**
+     * Utility method to format operations per second
+     */
+    protected formatOpsPerSecond(opsPerSecond: number): string;
+    /**
+     * Utility method to format percentage
+     */
+    protected formatPercentage(value: number): string;
+    /**
+     * Utility method to safely handle async operations
+     */
+    protected safeAsync<T>(operation: () => Promise<T>): Promise<null | T>;
+}
+/**
+ * Composite reporter that broadcasts events to multiple reporters
+ */
+export declare class CompositeReporter extends BaseReporter {
+    private readonly reporters;
+    constructor(reporters: Reporter[]);
+    /**
+     * Add a reporter to the composite
+     */
+    addReporter(reporter: Reporter): void;
+    /**
+     * Get all reporters in the composite
+     */
+    getReporters(): Reporter[];
+    onEnd(run: BenchmarkRun): Promise<void>;
+    onError(error: Error): Promise<void>;
+    onFileEnd(result: FileResult): Promise<void>;
+    onFileStart(file: string): Promise<void>;
+    onProgress(state: ProgressState): Promise<void>;
+    onStart(run: BenchmarkRun): Promise<void>;
+    onSuiteEnd(result: SuiteResult): Promise<void>;
+    onSuiteStart(suite: string): Promise<void>;
+    onTaskResult(result: TaskResult): Promise<void>;
+    onTaskStart(task: string): Promise<void>;
+    /**
+     * Remove a reporter from the composite
+     */
+    removeReporter(reporter: Reporter): boolean;
+    /**
+     * Broadcast an event to all reporters with error handling
+     */
+    private broadcastAsync;
+}
+/**
+ * Reporter registry implementation for managing multiple reporters
+ */
+export declare class ModestBenchReporterRegistry implements ReporterRegistry {
+    private readonly reporters;
+    /**
+     * Clear all registered reporters
+     */
+    clear(): void;
+    /**
+     * Get a reporter by name
+     */
+    get(name: string): Reporter | undefined;
+    /**
+     * Get all registered reporters
+     */
+    getAll(): Record<string, Reporter>;
+    /**
+     * Get multiple reporters by names
+     */
+    getByNames(names: string[]): Reporter[];
+    /**
+     * Get list of registered reporter names
+     */
+    getNames(): string[];
+    /**
+     * Check if a reporter is registered
+     */
+    has(name: string): boolean;
+    /**
+     * Register a reporter with a unique name
+     */
+    register(name: string, reporter: Reporter): void;
+    /**
+     * Get count of registered reporters
+     */
+    size(): number;
+    /**
+     * Unregister a reporter
+     */
+    unregister(name: string): boolean;
+}
+//# sourceMappingURL=registry.d.ts.map

package/dist/reporters/registry.d.ts.map

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