modestbench 0.0.3 → 0.2.0

package/dist/core/output-path-resolver.cjs

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveOutputPath = void 0;
+const node_path_1 = require("node:path");
+/**
+ * Resolves the final output path for a reporter
+ *
+ * @param outputDir - Optional output directory from --output flag
+ * @param outputFile - Optional output filename from --output-file flag
+ * @param defaultFilename - Default filename to use if none specified
+ * @returns Resolved output path, or undefined if no output to file requested
+ */
+const resolveOutputPath = (outputDir, outputFile, defaultFilename) => {
+    // If outputFile is provided
+    if (outputFile) {
+        // If outputFile is absolute, use as-is
+        if ((0, node_path_1.isAbsolute)(outputFile)) {
+            return outputFile;
+        }
+        // If outputDir specified, join them
+        if (outputDir) {
+            return (0, node_path_1.join)(outputDir, outputFile);
+        }
+        // Otherwise, resolve relative to cwd
+        return (0, node_path_1.resolve)(process.cwd(), outputFile);
+    }
+    // Fall back to default behavior
+    if (outputDir && defaultFilename) {
+        return (0, node_path_1.join)(outputDir, defaultFilename);
+    }
+    return undefined;
+};
+exports.resolveOutputPath = resolveOutputPath;
+//# sourceMappingURL=output-path-resolver.js.map

package/dist/core/output-path-resolver.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-path-resolver.js","sourceRoot":"","sources":["../../src/core/output-path-resolver.ts"],"names":[],"mappings":";;;AAAA,yCAAsD;AAEtD;;;;;;;GAOG;AACI,MAAM,iBAAiB,GAAG,CAC/B,SAAkB,EAClB,UAAmB,EACnB,eAAwB,EACJ,EAAE;IACtB,4BAA4B;IAC5B,IAAI,UAAU,EAAE,CAAC;QACf,uCAAuC;QACvC,IAAI,IAAA,sBAAU,EAAC,UAAU,CAAC,EAAE,CAAC;YAC3B,OAAO,UAAU,CAAC;QACpB,CAAC;QAED,oCAAoC;QACpC,IAAI,SAAS,EAAE,CAAC;YACd,OAAO,IAAA,gBAAI,EAAC,SAAS,EAAE,UAAU,CAAC,CAAC;QACrC,CAAC;QAED,qCAAqC;QACrC,OAAO,IAAA,mBAAO,EAAC,OAAO,CAAC,GAAG,EAAE,EAAE,UAAU,CAAC,CAAC;IAC5C,CAAC;IAED,gCAAgC;IAChC,IAAI,SAAS,IAAI,eAAe,EAAE,CAAC;QACjC,OAAO,IAAA,gBAAI,EAAC,SAAS,EAAE,eAAe,CAAC,CAAC;IAC1C,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC,CAAC;AA3BW,QAAA,iBAAiB,qBA2B5B"}

package/dist/core/output-path-resolver.d.cts

@@ -0,0 +1,10 @@
+/**
+ * Resolves the final output path for a reporter
+ *
+ * @param outputDir - Optional output directory from --output flag
+ * @param outputFile - Optional output filename from --output-file flag
+ * @param defaultFilename - Default filename to use if none specified
+ * @returns Resolved output path, or undefined if no output to file requested
+ */
+export declare const resolveOutputPath: (outputDir?: string, outputFile?: string, defaultFilename?: string) => string | undefined;
+//# sourceMappingURL=output-path-resolver.d.ts.map

package/dist/core/output-path-resolver.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-path-resolver.d.ts","sourceRoot":"","sources":["../../src/core/output-path-resolver.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,eAAO,MAAM,iBAAiB,GAC5B,YAAY,MAAM,EAClB,aAAa,MAAM,EACnB,kBAAkB,MAAM,KACvB,MAAM,GAAG,SAuBX,CAAC"}

package/dist/core/output-path-resolver.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Resolves the final output path for a reporter
+ *
+ * @param outputDir - Optional output directory from --output flag
+ * @param outputFile - Optional output filename from --output-file flag
+ * @param defaultFilename - Default filename to use if none specified
+ * @returns Resolved output path, or undefined if no output to file requested
+ */
+export declare const resolveOutputPath: (outputDir?: string, outputFile?: string, defaultFilename?: string) => string | undefined;
+//# sourceMappingURL=output-path-resolver.d.ts.map

package/dist/core/output-path-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-path-resolver.d.ts","sourceRoot":"","sources":["../../src/core/output-path-resolver.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,eAAO,MAAM,iBAAiB,GAC5B,YAAY,MAAM,EAClB,aAAa,MAAM,EACnB,kBAAkB,MAAM,KACvB,MAAM,GAAG,SAuBX,CAAC"}

package/dist/core/output-path-resolver.js

@@ -0,0 +1,30 @@
+import { isAbsolute, join, resolve } from 'node:path';
+/**
+ * Resolves the final output path for a reporter
+ *
+ * @param outputDir - Optional output directory from --output flag
+ * @param outputFile - Optional output filename from --output-file flag
+ * @param defaultFilename - Default filename to use if none specified
+ * @returns Resolved output path, or undefined if no output to file requested
+ */
+export const resolveOutputPath = (outputDir, outputFile, defaultFilename) => {
+    // If outputFile is provided
+    if (outputFile) {
+        // If outputFile is absolute, use as-is
+        if (isAbsolute(outputFile)) {
+            return outputFile;
+        }
+        // If outputDir specified, join them
+        if (outputDir) {
+            return join(outputDir, outputFile);
+        }
+        // Otherwise, resolve relative to cwd
+        return resolve(process.cwd(), outputFile);
+    }
+    // Fall back to default behavior
+    if (outputDir && defaultFilename) {
+        return join(outputDir, defaultFilename);
+    }
+    return undefined;
+};
+//# sourceMappingURL=output-path-resolver.js.map

package/dist/core/output-path-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-path-resolver.js","sourceRoot":"","sources":["../../src/core/output-path-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEtD;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAC/B,SAAkB,EAClB,UAAmB,EACnB,eAAwB,EACJ,EAAE;IACtB,4BAA4B;IAC5B,IAAI,UAAU,EAAE,CAAC;QACf,uCAAuC;QACvC,IAAI,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YAC3B,OAAO,UAAU,CAAC;QACpB,CAAC;QAED,oCAAoC;QACpC,IAAI,SAAS,EAAE,CAAC;YACd,OAAO,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;QACrC,CAAC;QAED,qCAAqC;QACrC,OAAO,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,UAAU,CAAC,CAAC;IAC5C,CAAC;IAED,gCAAgC;IAChC,IAAI,SAAS,IAAI,eAAe,EAAE,CAAC;QACjC,OAAO,IAAI,CAAC,SAAS,EAAE,eAAe,CAAC,CAAC;IAC1C,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC,CAAC"}

package/dist/errors/base.cjs

@@ -0,0 +1,130 @@
+"use strict";
+/**
+ * ModestBench Custom Error System
+ *
+ * Base error classes providing structured error handling with error codes,
+ * documentation URLs, and consistent error display.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isModestBenchError = exports.ModestBenchError = exports.ModestBenchAggregateError = void 0;
+/**
+ * Base URL for error documentation
+ */
+const ERROR_DOC_BASE_URL = 'https://boneskull.github.io/modestbench/reference/errors';
+/**
+ * Abstract base class for ModestBench aggregate errors
+ *
+ * Extends AggregateError to support multiple errors with ModestBench error
+ * system features.
+ */
+class ModestBenchAggregateError extends AggregateError {
+    /**
+     * Error name (matches class name)
+     */
+    name;
+    /**
+     * Create a new ModestBench aggregate error
+     *
+     * @param errors - Array of errors that occurred
+     * @param message - Human-readable error message
+     * @param options - Optional Error options (e.g., cause)
+     */
+    constructor(errors, message, options) {
+        super(errors, message, options);
+        this.name = this.constructor.name;
+    }
+    /**
+     * Get the documentation URL for this error
+     *
+     * Returns a URL to the error reference page with an anchor to the specific
+     * error.
+     *
+     * @returns Documentation URL
+     */
+    getDocUrl() {
+        // Use the error class name as the anchor (e.g., ConfigValidationError -> #configvalidationerror)
+        const anchor = this.name.toLowerCase();
+        return `${ERROR_DOC_BASE_URL}#${anchor}`;
+    }
+    /**
+     * Convert error to string with code, documentation URL, and nested errors
+     *
+     * @returns Formatted error string
+     */
+    toString() {
+        let result = `${this.name} [${this.code}]: ${this.message}\n`;
+        result += `See: ${this.getDocUrl()}\n`;
+        if (this.errors.length > 0) {
+            result += `\nContains ${this.errors.length} error(s):\n`;
+            this.errors.forEach((err, index) => {
+                const errMsg = err instanceof Error ? err.message : String(err);
+                result += `  ${index + 1}. ${errMsg}\n`;
+            });
+        }
+        return result;
+    }
+}
+exports.ModestBenchAggregateError = ModestBenchAggregateError;
+/**
+ * Abstract base class for all ModestBench errors
+ *
+ * Provides:
+ *
+ * - Unique error codes with ERR_MB_ prefix
+ * - Documentation URL generation
+ * - Consistent error display format
+ * - TypeScript type safety
+ */
+class ModestBenchError extends Error {
+    /**
+     * Error name (matches class name)
+     */
+    name;
+    /**
+     * Create a new ModestBench error
+     *
+     * @param message - Human-readable error message
+     * @param options - Optional Error options (e.g., cause)
+     */
+    constructor(message, options) {
+        super(message, options);
+        this.name = this.constructor.name;
+    }
+    /**
+     * Get the documentation URL for this error
+     *
+     * Returns a URL to the error reference page with an anchor to the specific
+     * error.
+     *
+     * @returns Documentation URL
+     */
+    getDocUrl() {
+        // Use the error class name as the anchor (e.g., ConfigValidationError -> #configvalidationerror)
+        const anchor = this.name.toLowerCase();
+        return `${ERROR_DOC_BASE_URL}#${anchor}`;
+    }
+    /**
+     * Convert error to string with code and documentation URL
+     *
+     * @returns Formatted error string
+     */
+    toString() {
+        return `${this.name} [${this.code}]: ${this.message}\nSee: ${this.getDocUrl()}`;
+    }
+}
+exports.ModestBenchError = ModestBenchError;
+/**
+ * Type guard to check if an error is a ModestBench error
+ *
+ * @param error - The error to check
+ * @returns True if the error is a ModestBench error
+ */
+const isModestBenchError = (error) => {
+    return (typeof error === 'object' &&
+        error !== null &&
+        'code' in error &&
+        typeof error.code === 'string' &&
+        error.code.startsWith('ERR_MB_'));
+};
+exports.isModestBenchError = isModestBenchError;
+//# sourceMappingURL=base.js.map

package/dist/errors/base.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../src/errors/base.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH;;GAEG;AACH,MAAM,kBAAkB,GACtB,0DAA0D,CAAC;AAE7D;;;;;GAKG;AACH,MAAsB,yBAA0B,SAAQ,cAAc;IAOpE;;OAEG;IACsB,IAAI,CAAS;IAEtC;;;;;;OAMG;IACH,YAAY,MAAiB,EAAE,OAAe,EAAE,OAAsB;QACpE,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QAChC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;IACpC,CAAC;IAED;;;;;;;OAOG;IACH,SAAS;QACP,iGAAiG;QACjG,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;QACvC,OAAO,GAAG,kBAAkB,IAAI,MAAM,EAAE,CAAC;IAC3C,CAAC;IAED;;;;OAIG;IACM,QAAQ;QACf,IAAI,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,MAAM,IAAI,CAAC,OAAO,IAAI,CAAC;QAC9D,MAAM,IAAI,QAAQ,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC;QAEvC,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC3B,MAAM,IAAI,cAAc,IAAI,CAAC,MAAM,CAAC,MAAM,cAAc,CAAC;YACzD,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE;gBACjC,MAAM,MAAM,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBAChE,MAAM,IAAI,KAAK,KAAK,GAAG,CAAC,KAAK,MAAM,IAAI,CAAC;YAC1C,CAAC,CAAC,CAAC;QACL,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AAzDD,8DAyDC;AAED;;;;;;;;;GASG;AACH,MAAsB,gBAAiB,SAAQ,KAAK;IAOlD;;OAEG;IACsB,IAAI,CAAS;IAEtC;;;;;OAKG;IACH,YAAY,OAAe,EAAE,OAAsB;QACjD,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;IACpC,CAAC;IAED;;;;;;;OAOG;IACH,SAAS;QACP,iGAAiG;QACjG,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;QACvC,OAAO,GAAG,kBAAkB,IAAI,MAAM,EAAE,CAAC;IAC3C,CAAC;IAED;;;;OAIG;IACM,QAAQ;QACf,OAAO,GAAG,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,MAAM,IAAI,CAAC,OAAO,UAAU,IAAI,CAAC,SAAS,EAAE,EAAE,CAAC;IAClF,CAAC;CACF;AA7CD,4CA6CC;AAED;;;;;GAKG;AACI,MAAM,kBAAkB,GAAG,CAChC,KAAc,EACa,EAAE;IAC7B,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,MAAM,IAAI,KAAK;QACf,OAAQ,KAA2B,CAAC,IAAI,KAAK,QAAQ;QACpD,KAA0B,CAAC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,CACvD,CAAC;AACJ,CAAC,CAAC;AAVW,QAAA,kBAAkB,sBAU7B"}

package/dist/errors/base.d.cts

@@ -0,0 +1,97 @@
+/**
+ * ModestBench Custom Error System
+ *
+ * Base error classes providing structured error handling with error codes,
+ * documentation URLs, and consistent error display.
+ */
+/**
+ * Abstract base class for ModestBench aggregate errors
+ *
+ * Extends AggregateError to support multiple errors with ModestBench error
+ * system features.
+ */
+export declare abstract class ModestBenchAggregateError extends AggregateError {
+    /**
+     * Unique error code for this error type Must be in format:
+     * ERR_MB_CATEGORY_DESCRIPTION
+     */
+    abstract readonly code: string;
+    /**
+     * Error name (matches class name)
+     */
+    readonly name: string;
+    /**
+     * Create a new ModestBench aggregate error
+     *
+     * @param errors - Array of errors that occurred
+     * @param message - Human-readable error message
+     * @param options - Optional Error options (e.g., cause)
+     */
+    constructor(errors: unknown[], message: string, options?: ErrorOptions);
+    /**
+     * Get the documentation URL for this error
+     *
+     * Returns a URL to the error reference page with an anchor to the specific
+     * error.
+     *
+     * @returns Documentation URL
+     */
+    getDocUrl(): string;
+    /**
+     * Convert error to string with code, documentation URL, and nested errors
+     *
+     * @returns Formatted error string
+     */
+    toString(): string;
+}
+/**
+ * Abstract base class for all ModestBench errors
+ *
+ * Provides:
+ *
+ * - Unique error codes with ERR_MB_ prefix
+ * - Documentation URL generation
+ * - Consistent error display format
+ * - TypeScript type safety
+ */
+export declare abstract class ModestBenchError extends Error {
+    /**
+     * Unique error code for this error type Must be in format:
+     * ERR_MB_CATEGORY_DESCRIPTION
+     */
+    abstract readonly code: string;
+    /**
+     * Error name (matches class name)
+     */
+    readonly name: string;
+    /**
+     * Create a new ModestBench error
+     *
+     * @param message - Human-readable error message
+     * @param options - Optional Error options (e.g., cause)
+     */
+    constructor(message: string, options?: ErrorOptions);
+    /**
+     * Get the documentation URL for this error
+     *
+     * Returns a URL to the error reference page with an anchor to the specific
+     * error.
+     *
+     * @returns Documentation URL
+     */
+    getDocUrl(): string;
+    /**
+     * Convert error to string with code and documentation URL
+     *
+     * @returns Formatted error string
+     */
+    toString(): string;
+}
+/**
+ * Type guard to check if an error is a ModestBench error
+ *
+ * @param error - The error to check
+ * @returns True if the error is a ModestBench error
+ */
+export declare const isModestBenchError: (error: unknown) => error is ModestBenchError;
+//# sourceMappingURL=base.d.ts.map

package/dist/errors/base.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/errors/base.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH;;;;;GAKG;AACH,8BAAsB,yBAA0B,SAAQ,cAAc;IACpE;;;OAGG;IACH,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAE/B;;OAEG;IACH,SAAyB,IAAI,EAAE,MAAM,CAAC;IAEtC;;;;;;OAMG;gBACS,MAAM,EAAE,OAAO,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;IAKtE;;;;;;;OAOG;IACH,SAAS,IAAI,MAAM;IAMnB;;;;OAIG;IACM,QAAQ,IAAI,MAAM;CAc5B;AAED;;;;;;;;;GASG;AACH,8BAAsB,gBAAiB,SAAQ,KAAK;IAClD;;;OAGG;IACH,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAE/B;;OAEG;IACH,SAAyB,IAAI,EAAE,MAAM,CAAC;IAEtC;;;;;OAKG;gBACS,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;IAKnD;;;;;;;OAOG;IACH,SAAS,IAAI,MAAM;IAMnB;;;;OAIG;IACM,QAAQ,IAAI,MAAM;CAG5B;AAED;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,GAC7B,OAAO,OAAO,KACb,KAAK,IAAI,gBAQX,CAAC"}

package/dist/errors/base.d.ts

@@ -0,0 +1,97 @@
+/**
+ * ModestBench Custom Error System
+ *
+ * Base error classes providing structured error handling with error codes,
+ * documentation URLs, and consistent error display.
+ */
+/**
+ * Abstract base class for ModestBench aggregate errors
+ *
+ * Extends AggregateError to support multiple errors with ModestBench error
+ * system features.
+ */
+export declare abstract class ModestBenchAggregateError extends AggregateError {
+    /**
+     * Unique error code for this error type Must be in format:
+     * ERR_MB_CATEGORY_DESCRIPTION
+     */
+    abstract readonly code: string;
+    /**
+     * Error name (matches class name)
+     */
+    readonly name: string;
+    /**
+     * Create a new ModestBench aggregate error
+     *
+     * @param errors - Array of errors that occurred
+     * @param message - Human-readable error message
+     * @param options - Optional Error options (e.g., cause)
+     */
+    constructor(errors: unknown[], message: string, options?: ErrorOptions);
+    /**
+     * Get the documentation URL for this error
+     *
+     * Returns a URL to the error reference page with an anchor to the specific
+     * error.
+     *
+     * @returns Documentation URL
+     */
+    getDocUrl(): string;
+    /**
+     * Convert error to string with code, documentation URL, and nested errors
+     *
+     * @returns Formatted error string
+     */
+    toString(): string;
+}
+/**
+ * Abstract base class for all ModestBench errors
+ *
+ * Provides:
+ *
+ * - Unique error codes with ERR_MB_ prefix
+ * - Documentation URL generation
+ * - Consistent error display format
+ * - TypeScript type safety
+ */
+export declare abstract class ModestBenchError extends Error {
+    /**
+     * Unique error code for this error type Must be in format:
+     * ERR_MB_CATEGORY_DESCRIPTION
+     */
+    abstract readonly code: string;
+    /**
+     * Error name (matches class name)
+     */
+    readonly name: string;
+    /**
+     * Create a new ModestBench error
+     *
+     * @param message - Human-readable error message
+     * @param options - Optional Error options (e.g., cause)
+     */
+    constructor(message: string, options?: ErrorOptions);
+    /**
+     * Get the documentation URL for this error
+     *
+     * Returns a URL to the error reference page with an anchor to the specific
+     * error.
+     *
+     * @returns Documentation URL
+     */
+    getDocUrl(): string;
+    /**
+     * Convert error to string with code and documentation URL
+     *
+     * @returns Formatted error string
+     */
+    toString(): string;
+}
+/**
+ * Type guard to check if an error is a ModestBench error
+ *
+ * @param error - The error to check
+ * @returns True if the error is a ModestBench error
+ */
+export declare const isModestBenchError: (error: unknown) => error is ModestBenchError;
+//# sourceMappingURL=base.d.ts.map

package/dist/errors/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/errors/base.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH;;;;;GAKG;AACH,8BAAsB,yBAA0B,SAAQ,cAAc;IACpE;;;OAGG;IACH,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAE/B;;OAEG;IACH,SAAyB,IAAI,EAAE,MAAM,CAAC;IAEtC;;;;;;OAMG;gBACS,MAAM,EAAE,OAAO,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;IAKtE;;;;;;;OAOG;IACH,SAAS,IAAI,MAAM;IAMnB;;;;OAIG;IACM,QAAQ,IAAI,MAAM;CAc5B;AAED;;;;;;;;;GASG;AACH,8BAAsB,gBAAiB,SAAQ,KAAK;IAClD;;;OAGG;IACH,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAE/B;;OAEG;IACH,SAAyB,IAAI,EAAE,MAAM,CAAC;IAEtC;;;;;OAKG;gBACS,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;IAKnD;;;;;;;OAOG;IACH,SAAS,IAAI,MAAM;IAMnB;;;;OAIG;IACM,QAAQ,IAAI,MAAM;CAG5B;AAED;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,GAC7B,OAAO,OAAO,KACb,KAAK,IAAI,gBAQX,CAAC"}

package/dist/errors/base.js

@@ -0,0 +1,124 @@
+/**
+ * ModestBench Custom Error System
+ *
+ * Base error classes providing structured error handling with error codes,
+ * documentation URLs, and consistent error display.
+ */
+/**
+ * Base URL for error documentation
+ */
+const ERROR_DOC_BASE_URL = 'https://boneskull.github.io/modestbench/reference/errors';
+/**
+ * Abstract base class for ModestBench aggregate errors
+ *
+ * Extends AggregateError to support multiple errors with ModestBench error
+ * system features.
+ */
+export class ModestBenchAggregateError extends AggregateError {
+    /**
+     * Error name (matches class name)
+     */
+    name;
+    /**
+     * Create a new ModestBench aggregate error
+     *
+     * @param errors - Array of errors that occurred
+     * @param message - Human-readable error message
+     * @param options - Optional Error options (e.g., cause)
+     */
+    constructor(errors, message, options) {
+        super(errors, message, options);
+        this.name = this.constructor.name;
+    }
+    /**
+     * Get the documentation URL for this error
+     *
+     * Returns a URL to the error reference page with an anchor to the specific
+     * error.
+     *
+     * @returns Documentation URL
+     */
+    getDocUrl() {
+        // Use the error class name as the anchor (e.g., ConfigValidationError -> #configvalidationerror)
+        const anchor = this.name.toLowerCase();
+        return `${ERROR_DOC_BASE_URL}#${anchor}`;
+    }
+    /**
+     * Convert error to string with code, documentation URL, and nested errors
+     *
+     * @returns Formatted error string
+     */
+    toString() {
+        let result = `${this.name} [${this.code}]: ${this.message}\n`;
+        result += `See: ${this.getDocUrl()}\n`;
+        if (this.errors.length > 0) {
+            result += `\nContains ${this.errors.length} error(s):\n`;
+            this.errors.forEach((err, index) => {
+                const errMsg = err instanceof Error ? err.message : String(err);
+                result += `  ${index + 1}. ${errMsg}\n`;
+            });
+        }
+        return result;
+    }
+}
+/**
+ * Abstract base class for all ModestBench errors
+ *
+ * Provides:
+ *
+ * - Unique error codes with ERR_MB_ prefix
+ * - Documentation URL generation
+ * - Consistent error display format
+ * - TypeScript type safety
+ */
+export class ModestBenchError extends Error {
+    /**
+     * Error name (matches class name)
+     */
+    name;
+    /**
+     * Create a new ModestBench error
+     *
+     * @param message - Human-readable error message
+     * @param options - Optional Error options (e.g., cause)
+     */
+    constructor(message, options) {
+        super(message, options);
+        this.name = this.constructor.name;
+    }
+    /**
+     * Get the documentation URL for this error
+     *
+     * Returns a URL to the error reference page with an anchor to the specific
+     * error.
+     *
+     * @returns Documentation URL
+     */
+    getDocUrl() {
+        // Use the error class name as the anchor (e.g., ConfigValidationError -> #configvalidationerror)
+        const anchor = this.name.toLowerCase();
+        return `${ERROR_DOC_BASE_URL}#${anchor}`;
+    }
+    /**
+     * Convert error to string with code and documentation URL
+     *
+     * @returns Formatted error string
+     */
+    toString() {
+        return `${this.name} [${this.code}]: ${this.message}\nSee: ${this.getDocUrl()}`;
+    }
+}
+/**
+ * Type guard to check if an error is a ModestBench error
+ *
+ * @param error - The error to check
+ * @returns True if the error is a ModestBench error
+ */
+export const isModestBenchError = (error) => {
+    return (typeof error === 'object' &&
+        error !== null &&
+        'code' in error &&
+        typeof error.code === 'string' &&
+        error.code.startsWith('ERR_MB_'));
+};
+//# sourceMappingURL=base.js.map

package/dist/errors/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../src/errors/base.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,kBAAkB,GACtB,0DAA0D,CAAC;AAE7D;;;;;GAKG;AACH,MAAM,OAAgB,yBAA0B,SAAQ,cAAc;IAOpE;;OAEG;IACsB,IAAI,CAAS;IAEtC;;;;;;OAMG;IACH,YAAY,MAAiB,EAAE,OAAe,EAAE,OAAsB;QACpE,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QAChC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;IACpC,CAAC;IAED;;;;;;;OAOG;IACH,SAAS;QACP,iGAAiG;QACjG,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;QACvC,OAAO,GAAG,kBAAkB,IAAI,MAAM,EAAE,CAAC;IAC3C,CAAC;IAED;;;;OAIG;IACM,QAAQ;QACf,IAAI,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,MAAM,IAAI,CAAC,OAAO,IAAI,CAAC;QAC9D,MAAM,IAAI,QAAQ,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC;QAEvC,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC3B,MAAM,IAAI,cAAc,IAAI,CAAC,MAAM,CAAC,MAAM,cAAc,CAAC;YACzD,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE;gBACjC,MAAM,MAAM,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBAChE,MAAM,IAAI,KAAK,KAAK,GAAG,CAAC,KAAK,MAAM,IAAI,CAAC;YAC1C,CAAC,CAAC,CAAC;QACL,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AAED;;;;;;;;;GASG;AACH,MAAM,OAAgB,gBAAiB,SAAQ,KAAK;IAOlD;;OAEG;IACsB,IAAI,CAAS;IAEtC;;;;;OAKG;IACH,YAAY,OAAe,EAAE,OAAsB;QACjD,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;IACpC,CAAC;IAED;;;;;;;OAOG;IACH,SAAS;QACP,iGAAiG;QACjG,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;QACvC,OAAO,GAAG,kBAAkB,IAAI,MAAM,EAAE,CAAC;IAC3C,CAAC;IAED;;;;OAIG;IACM,QAAQ;QACf,OAAO,GAAG,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,MAAM,IAAI,CAAC,OAAO,UAAU,IAAI,CAAC,SAAS,EAAE,EAAE,CAAC;IAClF,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAChC,KAAc,EACa,EAAE;IAC7B,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,MAAM,IAAI,KAAK;QACf,OAAQ,KAA2B,CAAC,IAAI,KAAK,QAAQ;QACpD,KAA0B,CAAC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,CACvD,CAAC;AACJ,CAAC,CAAC"}

package/dist/errors/cli.cjs

@@ -0,0 +1,58 @@
+"use strict";
+/**
+ * CLI-related errors
+ *
+ * Errors that occur during command-line interface operations.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UnknownError = exports.InvalidDateFormatError = exports.InvalidArgumentError = void 0;
+const base_js_1 = require("./base.cjs");
+/**
+ * Invalid CLI argument
+ *
+ * Thrown when a CLI argument is invalid or cannot be parsed.
+ */
+class InvalidArgumentError extends base_js_1.ModestBenchError {
+    code = 'ERR_MB_CLI_INVALID_ARGUMENT';
+}
+exports.InvalidArgumentError = InvalidArgumentError;
+/**
+ * Invalid date format
+ *
+ * Thrown when a date string cannot be parsed into a valid date.
+ */
+class InvalidDateFormatError extends base_js_1.ModestBenchError {
+    code = 'ERR_MB_CLI_INVALID_DATE_FORMAT';
+}
+exports.InvalidDateFormatError = InvalidDateFormatError;
+/**
+ * Unknown error
+ *
+ * Thrown at the CLI boundary to wrap unexpected errors that are not ModestBench
+ * errors. This ensures all errors have proper structure and documentation
+ * links.
+ */
+class UnknownError extends base_js_1.ModestBenchError {
+    code = 'ERR_MB_UNKNOWN';
+    /**
+     * Create a new UnknownError wrapping an unexpected error
+     *
+     * @param message - The error message (typically from the original error)
+     * @param options - Error options with the original error as the cause
+     */
+    constructor(message, options) {
+        super(message, options);
+    }
+    /**
+     * Override toString to show full details of the wrapped error
+     */
+    toString() {
+        let result = super.toString();
+        if (this.cause instanceof Error && this.cause.stack) {
+            result += '\n\nOriginal error:\n' + this.cause.stack;
+        }
+        return result;
+    }
+}
+exports.UnknownError = UnknownError;
+//# sourceMappingURL=cli.js.map

package/dist/errors/cli.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/errors/cli.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAEH,wCAA6C;AAE7C;;;;GAIG;AACH,MAAa,oBAAqB,SAAQ,0BAAgB;IAC/C,IAAI,GAAG,6BAA6B,CAAC;CAC/C;AAFD,oDAEC;AAED;;;;GAIG;AACH,MAAa,sBAAuB,SAAQ,0BAAgB;IACjD,IAAI,GAAG,gCAAgC,CAAC;CAClD;AAFD,wDAEC;AAED;;;;;;GAMG;AACH,MAAa,YAAa,SAAQ,0BAAgB;IACvC,IAAI,GAAG,gBAAgB,CAAC;IAEjC;;;;;OAKG;IACH,YAAY,OAAe,EAAE,OAAqB;QAChD,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC1B,CAAC;IAED;;OAEG;IACM,QAAQ;QACf,IAAI,MAAM,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC;QAE9B,IAAI,IAAI,CAAC,KAAK,YAAY,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;YACpD,MAAM,IAAI,uBAAuB,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC;QACvD,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AAzBD,oCAyBC"}