@vertaaux/cli 0.2.0

package/dist/config/loader.js

@@ -0,0 +1,167 @@
+/**
+ * Configuration loader using cosmiconfig with Ajv validation.
+ *
+ * Searches for configuration in multiple formats:
+ * - .vertaaux.yml / .vertaaux.yaml
+ * - .vertaaux.json
+ * - vertaaux.config.js / vertaaux.config.mjs
+ * - package.json (vertaaux key)
+ *
+ * Validates against JSON Schema and merges with defaults.
+ */
+import { cosmiconfig } from "cosmiconfig";
+import Ajv from "ajv";
+import addFormats from "ajv-formats";
+import { createRequire } from "module";
+import { mergeWithDefaults } from "./defaults.js";
+// Import JSON schema (using createRequire for JSON imports in ESM)
+const require = createRequire(import.meta.url);
+let configSchema;
+try {
+    configSchema = require("../../schemas/vertaaux.config.schema.json");
+}
+catch {
+    throw new Error("Schema files not found. The CLI package may be corrupted or incompletely installed.\n" +
+        "Try reinstalling: npm install -g @vertaaux/cli");
+}
+/**
+ * Error thrown when config validation fails.
+ */
+export class ConfigValidationError extends Error {
+    errors;
+    constructor(errors, filePath) {
+        const errorMessages = errors
+            ?.map((e) => `  - ${e.instancePath || "config"}: ${e.message}`)
+            .join("\n");
+        super(`Invalid VertaaUX configuration${filePath ? ` in ${filePath}` : ""}:\n${errorMessages}`);
+        this.errors = errors;
+        this.name = "ConfigValidationError";
+    }
+}
+/**
+ * Error thrown when config file cannot be loaded.
+ */
+export class ConfigLoadError extends Error {
+    cause;
+    constructor(message, cause) {
+        super(message);
+        this.cause = cause;
+        this.name = "ConfigLoadError";
+    }
+}
+// Create cosmiconfig explorer
+const explorer = cosmiconfig("vertaaux", {
+    searchPlaces: [
+        ".vertaaux.yml",
+        ".vertaaux.yaml",
+        ".vertaaux.json",
+        "vertaaux.config.js",
+        "vertaaux.config.mjs",
+        "vertaaux.config.cjs",
+        "package.json",
+    ],
+});
+// Create Ajv validator instance (Ajv 8 exports class directly in ESM)
+const ajv = new Ajv({ strict: false, allErrors: true });
+addFormats(ajv);
+const validateConfig = ajv.compile(configSchema);
+/**
+ * Load configuration from file and environment.
+ *
+ * Searches for config file starting from current working directory
+ * and walking up the directory tree.
+ *
+ * @param searchFrom - Directory to start search from (defaults to cwd)
+ * @returns Merged configuration with defaults
+ *
+ * @example
+ * ```typescript
+ * const config = await loadConfig();
+ * console.log(config.mode); // 'basic' (default or from config)
+ * ```
+ */
+export async function loadConfig(searchFrom) {
+    let fileConfig = {};
+    let configFilePath;
+    try {
+        const result = await explorer.search(searchFrom);
+        if (result && !result.isEmpty) {
+            fileConfig = result.config;
+            configFilePath = result.filepath;
+            // Validate against schema
+            if (!validateConfig(fileConfig)) {
+                throw new ConfigValidationError(validateConfig.errors, configFilePath);
+            }
+        }
+    }
+    catch (error) {
+        // Re-throw validation errors
+        if (error instanceof ConfigValidationError) {
+            throw error;
+        }
+        // Wrap other errors
+        throw new ConfigLoadError(`Failed to load config: ${error instanceof Error ? error.message : String(error)}`, error);
+    }
+    // Merge with defaults
+    const mergedConfig = mergeWithDefaults(fileConfig);
+    // Environment variable overrides
+    if (process.env.VERTAAUX_API_KEY && !mergedConfig.apiKey) {
+        mergedConfig.apiKey = process.env.VERTAAUX_API_KEY;
+    }
+    return mergedConfig;
+}
+/**
+ * Load configuration from a specific file path.
+ *
+ * @param filePath - Path to config file
+ * @returns Merged configuration with defaults
+ */
+export async function loadConfigFile(filePath) {
+    try {
+        const result = await explorer.load(filePath);
+        if (!result || result.isEmpty) {
+            throw new ConfigLoadError(`Config file is empty: ${filePath}`);
+        }
+        const fileConfig = result.config;
+        // Validate against schema
+        if (!validateConfig(fileConfig)) {
+            throw new ConfigValidationError(validateConfig.errors, filePath);
+        }
+        return mergeWithDefaults(fileConfig);
+    }
+    catch (error) {
+        if (error instanceof ConfigValidationError ||
+            error instanceof ConfigLoadError) {
+            throw error;
+        }
+        throw new ConfigLoadError(`Failed to load config from ${filePath}: ${error instanceof Error ? error.message : String(error)}`, error);
+    }
+}
+/**
+ * Resolve configuration from explicit path or auto-detection.
+ *
+ * If an explicit path is provided, loads that file directly.
+ * Otherwise, falls back to cosmiconfig auto-detection.
+ *
+ * @param explicitPath - Optional explicit config file path (from --config flag)
+ * @returns Merged configuration with defaults
+ */
+export async function resolveConfig(explicitPath) {
+    if (explicitPath) {
+        const { existsSync } = await import("fs");
+        const pathMod = await import("path");
+        const resolvedPath = pathMod.resolve(process.cwd(), explicitPath);
+        if (!existsSync(resolvedPath)) {
+            throw new ConfigLoadError(`Config file not found: ${explicitPath}`);
+        }
+        return loadConfigFile(resolvedPath);
+    }
+    return loadConfig();
+}
+/**
+ * Clear the config cache.
+ * Useful for testing or when config files change.
+ */
+export function clearConfigCache() {
+    explorer.clearCaches();
+}

package/dist/config/schema.d.ts

@@ -0,0 +1,55 @@
+/**
+ * TypeScript interface matching the JSON Schema for VertaaUX config.
+ *
+ * @see ../../../schemas/vertaaux.config.schema.json
+ */
+export type AuditMode = "basic" | "standard" | "deep";
+export type OutputFormat = "auto" | "json" | "sarif" | "junit" | "html" | "human";
+export type GroupBy = "severity" | "category" | "route";
+export type FailOnSeverity = "error" | "warning" | "info";
+export type CITemplate = "github" | "gitlab" | "circleci" | "azure" | "jenkins" | "none";
+export interface OutputConfig {
+    /** Output format. 'auto' detects based on environment. */
+    format?: OutputFormat;
+    /** How to group issues in output */
+    groupBy?: GroupBy;
+}
+export interface BaselineConfig {
+    /** Path to baseline file */
+    path?: string;
+    /** Automatically update baseline with fixed issues */
+    autoUpdate?: boolean;
+}
+export interface CIConfig {
+    /** CI template for output formatting */
+    template?: CITemplate;
+}
+/**
+ * VertaaUX CLI configuration.
+ * Can be loaded from .vertaaux.yml, .vertaaux.json, or package.json.
+ */
+export interface VertaauxConfig {
+    /** JSON Schema reference for editor autocompletion */
+    $schema?: string;
+    /** API key for authentication (prefer env var) */
+    apiKey?: string;
+    /** Default URL to audit when none provided */
+    defaultUrl?: string;
+    /** Audit depth: basic, standard, or deep */
+    mode?: AuditMode;
+    /** Output configuration */
+    output?: OutputConfig;
+    /** Minimum passing score (0-100) */
+    threshold?: number;
+    /** Fail if issues at or above this severity */
+    failOn?: FailOnSeverity;
+    /** Baseline configuration */
+    baseline?: BaselineConfig;
+    /** CI-specific configuration */
+    ci?: CIConfig;
+    /** Audit timeout in milliseconds */
+    timeout?: number;
+    /** Poll interval in milliseconds */
+    interval?: number;
+}
+//# sourceMappingURL=schema.d.ts.map

package/dist/config/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/config/schema.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,UAAU,GAAG,MAAM,CAAC;AACtD,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC;AAClF,MAAM,MAAM,OAAO,GAAG,UAAU,GAAG,UAAU,GAAG,OAAO,CAAC;AACxD,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;AAC1D,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,QAAQ,GAAG,UAAU,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;AAEzF,MAAM,WAAW,YAAY;IAC3B,0DAA0D;IAC1D,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,oCAAoC;IACpC,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,4BAA4B;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sDAAsD;IACtD,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,QAAQ;IACvB,wCAAwC;IACxC,QAAQ,CAAC,EAAE,UAAU,CAAC;CACvB;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,sDAAsD;IACtD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kDAAkD;IAClD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,8CAA8C;IAC9C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4CAA4C;IAC5C,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,2BAA2B;IAC3B,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,oCAAoC;IACpC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+CAA+C;IAC/C,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,6BAA6B;IAC7B,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,gCAAgC;IAChC,EAAE,CAAC,EAAE,QAAQ,CAAC;IACd,oCAAoC;IACpC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oCAAoC;IACpC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB"}

package/dist/config/schema.js

@@ -0,0 +1,6 @@
+/**
+ * TypeScript interface matching the JSON Schema for VertaaUX config.
+ *
+ * @see ../../../schemas/vertaaux.config.schema.json
+ */
+export {};

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+/**
+ * VertaaUX CLI - UX audits, accessibility checks, and CI gating.
+ *
+ * Refactored to use Commander.js for command parsing with config file support.
+ * Maintains backward compatibility with existing command syntax.
+ */
+export {};
+//# 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":";AACA;;;;;GAKG"}