@cleaver/breakcheck-core 0.2.4 → 0.3.0

package/dist/lib/config.d.ts

@@ -0,0 +1,18 @@
+import type { LoadedProjectConfig, ProjectConfig, ProjectConfigLoadOptions, ResolvedProjectConfig } from "../types/config.js";
+export declare const PROJECT_CONFIG_FILENAME = "breakcheck.config.json";
+export declare const PROJECT_CONFIG_VERSION: 1;
+/** Validates and normalizes an in-memory project configuration. */
+export declare function validateProjectConfig(value: unknown, sourcePath?: string): ProjectConfig;
+/** Finds the nearest project configuration at or above `cwd`. */
+export declare function findProjectConfig(cwd?: string): Promise<string | undefined>;
+/** Loads exactly one selected or discovered project configuration. */
+export declare function loadProjectConfig(options?: ProjectConfigLoadOptions): Promise<LoadedProjectConfig | undefined>;
+/**
+ * Loads configuration and resolves all configured filesystem paths. When no
+ * storage directory is configured, the legacy project-root behavior remains.
+ */
+export declare function resolveProjectConfig(options?: ProjectConfigLoadOptions): Promise<ResolvedProjectConfig>;
+/** Serializes a validated project configuration with stable formatting. */
+export declare function serializeProjectConfig(config: ProjectConfig): string;
+/** Creates a project configuration without overwriting an existing path. */
+export declare function writeProjectConfig(configPath: string, config: ProjectConfig): Promise<void>;

package/dist/lib/config.js

@@ -0,0 +1,363 @@
+import { access, readFile, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { findRootDir } from "./root.js";
+export const PROJECT_CONFIG_FILENAME = "breakcheck.config.json";
+export const PROJECT_CONFIG_VERSION = 1;
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function sourceLabel(sourcePath) {
+    return sourcePath ? ` in ${sourcePath}` : "";
+}
+function invalidConfig(message, sourcePath, cause) {
+    return new Error(`Invalid Breakcheck configuration${sourceLabel(sourcePath)}: ${message}`, {
+        cause,
+    });
+}
+function assertKnownKeys(value, allowed, context, sourcePath) {
+    const unknown = Object.keys(value).filter((key) => !allowed.includes(key));
+    if (unknown.length > 0) {
+        throw invalidConfig(`${context} contains unsupported field(s): ${unknown.join(", ")}.`, sourcePath);
+    }
+}
+function requiredString(value, field, sourcePath) {
+    if (typeof value !== "string" || value.trim().length === 0) {
+        throw invalidConfig(`${field} must be a non-empty string.`, sourcePath);
+    }
+    return value;
+}
+function optionalString(value, field, sourcePath) {
+    if (value === undefined)
+        return undefined;
+    return requiredString(value, field, sourcePath);
+}
+function validateBaseUrl(value, sourcePath) {
+    const baseUrl = requiredString(value, "baseUrl", sourcePath);
+    let parsed;
+    try {
+        parsed = new URL(baseUrl);
+    }
+    catch (error) {
+        throw invalidConfig(`baseUrl must be a valid HTTP(S) URL.`, sourcePath, error);
+    }
+    if ((parsed.protocol !== "http:" && parsed.protocol !== "https:") ||
+        !parsed.hostname) {
+        throw invalidConfig(`baseUrl must be a valid HTTP(S) URL.`, sourcePath);
+    }
+    return baseUrl;
+}
+function validateInteger(value, field, minimum, sourcePath) {
+    if (typeof value !== "number" ||
+        !Number.isInteger(value) ||
+        value < minimum) {
+        throw invalidConfig(`${field} must be an integer greater than or equal to ${minimum}.`, sourcePath);
+    }
+    return value;
+}
+function validateStringArray(value, field, sourcePath) {
+    if (!Array.isArray(value) || value.some((item) => typeof item !== "string")) {
+        throw invalidConfig(`${field} must be an array of strings.`, sourcePath);
+    }
+    return [...value];
+}
+function validateCommand(value, field, sourcePath) {
+    if (!Array.isArray(value) ||
+        value.length === 0 ||
+        value.some((argument) => typeof argument !== "string") ||
+        typeof value[0] !== "string" ||
+        value[0].trim().length === 0) {
+        throw invalidConfig(`${field} must be a non-empty array of strings.`, sourcePath);
+    }
+    const command = [];
+    for (const argument of value) {
+        if (typeof argument !== "string") {
+            throw invalidConfig(`${field} must be a non-empty array of strings.`, sourcePath);
+        }
+        command.push(argument);
+    }
+    return command;
+}
+function validateCommandList(value, field, sourcePath) {
+    if (!Array.isArray(value)) {
+        throw invalidConfig(`${field} must be an array of command arrays.`, sourcePath);
+    }
+    return value.map((command, index) => validateCommand(command, `${field}[${index}]`, sourcePath));
+}
+function validateEnvironment(value, sourcePath) {
+    if (!isRecord(value)) {
+        throw invalidConfig("check.server.env must be an object of strings.", sourcePath);
+    }
+    const environment = {};
+    for (const [key, entry] of Object.entries(value)) {
+        if (!/^[A-Za-z_][A-Za-z0-9_]*$/.test(key) || typeof entry !== "string") {
+            throw invalidConfig("check.server.env keys must be environment variable names and values must be strings.", sourcePath);
+        }
+        environment[key] = entry;
+    }
+    return environment;
+}
+function validateCheckServerConfig(value, sourcePath) {
+    if (!isRecord(value)) {
+        throw invalidConfig("check.server must be an object.", sourcePath);
+    }
+    assertKnownKeys(value, ["start", "stop", "cwd", "env", "readyPath", "timeoutMs"], "check.server", sourcePath);
+    const readyPath = optionalString(value.readyPath, "check.server.readyPath", sourcePath);
+    if (readyPath !== undefined &&
+        (!readyPath.startsWith("/") || readyPath.startsWith("//"))) {
+        throw invalidConfig("check.server.readyPath must be a root-relative path beginning with one slash.", sourcePath);
+    }
+    return {
+        start: validateCommand(value.start, "check.server.start", sourcePath),
+        ...(value.stop === undefined
+            ? {}
+            : { stop: validateCommand(value.stop, "check.server.stop", sourcePath) }),
+        ...(value.cwd === undefined
+            ? {}
+            : { cwd: requiredString(value.cwd, "check.server.cwd", sourcePath) }),
+        ...(value.env === undefined
+            ? {}
+            : { env: validateEnvironment(value.env, sourcePath) }),
+        ...(readyPath === undefined ? {} : { readyPath }),
+        ...(value.timeoutMs === undefined
+            ? {}
+            : {
+                timeoutMs: validateInteger(value.timeoutMs, "check.server.timeoutMs", 1, sourcePath),
+            }),
+    };
+}
+function validateCheckConfig(value, sourcePath) {
+    if (value === undefined)
+        return undefined;
+    if (!isRecord(value)) {
+        throw invalidConfig("check must be an object.", sourcePath);
+    }
+    assertKnownKeys(value, ["routesFile", "baselineSnapshot", "prepare", "server", "reportDir"], "check", sourcePath);
+    const prepare = value.prepare === undefined
+        ? undefined
+        : validateCommandList(value.prepare, "check.prepare", sourcePath);
+    const server = value.server === undefined
+        ? undefined
+        : validateCheckServerConfig(value.server, sourcePath);
+    const reportDir = optionalString(value.reportDir, "check.reportDir", sourcePath);
+    return {
+        routesFile: requiredString(value.routesFile, "check.routesFile", sourcePath),
+        baselineSnapshot: requiredString(value.baselineSnapshot, "check.baselineSnapshot", sourcePath),
+        ...(prepare === undefined ? {} : { prepare }),
+        ...(server === undefined ? {} : { server }),
+        ...(reportDir === undefined ? {} : { reportDir }),
+    };
+}
+function validateCrawlConfig(value, sourcePath) {
+    if (value === undefined)
+        return undefined;
+    if (!isRecord(value)) {
+        throw invalidConfig("crawl must be an object.", sourcePath);
+    }
+    assertKnownKeys(value, [
+        "crawlerType",
+        "maxDepth",
+        "maxConcurrency",
+        "includePatterns",
+        "excludePatterns",
+    ], "crawl", sourcePath);
+    const crawlerType = value.crawlerType;
+    if (crawlerType !== undefined &&
+        crawlerType !== "cheerio" &&
+        crawlerType !== "playwright") {
+        throw invalidConfig(`crawl.crawlerType must be either "cheerio" or "playwright".`, sourcePath);
+    }
+    return {
+        ...(crawlerType === undefined ? {} : { crawlerType }),
+        ...(value.maxDepth === undefined
+            ? {}
+            : {
+                maxDepth: validateInteger(value.maxDepth, "crawl.maxDepth", 0, sourcePath),
+            }),
+        ...(value.maxConcurrency === undefined
+            ? {}
+            : {
+                maxConcurrency: validateInteger(value.maxConcurrency, "crawl.maxConcurrency", 1, sourcePath),
+            }),
+        ...(value.includePatterns === undefined
+            ? {}
+            : {
+                includePatterns: validateStringArray(value.includePatterns, "crawl.includePatterns", sourcePath),
+            }),
+        ...(value.excludePatterns === undefined
+            ? {}
+            : {
+                excludePatterns: validateStringArray(value.excludePatterns, "crawl.excludePatterns", sourcePath),
+            }),
+    };
+}
+function validateComparisonConfig(value, sourcePath) {
+    if (value === undefined)
+        return undefined;
+    if (!isRecord(value)) {
+        throw invalidConfig("comparison must be an object.", sourcePath);
+    }
+    assertKnownKeys(value, ["rulesDir"], "comparison", sourcePath);
+    const rulesDir = optionalString(value.rulesDir, "comparison.rulesDir", sourcePath);
+    return rulesDir === undefined ? {} : { rulesDir };
+}
+/** Validates and normalizes an in-memory project configuration. */
+export function validateProjectConfig(value, sourcePath) {
+    if (!isRecord(value)) {
+        throw invalidConfig("the root value must be an object.", sourcePath);
+    }
+    if (value.version !== 1 && value.version !== 2) {
+        throw invalidConfig("version must be 1 or 2.", sourcePath);
+    }
+    assertKnownKeys(value, value.version === 1
+        ? ["version", "baseUrl", "storageDir", "crawl", "comparison"]
+        : ["version", "baseUrl", "storageDir", "crawl", "comparison", "check"], "the root object", sourcePath);
+    const config = { version: value.version };
+    if (value.baseUrl !== undefined) {
+        config.baseUrl = validateBaseUrl(value.baseUrl, sourcePath);
+    }
+    if (value.storageDir !== undefined) {
+        config.storageDir = requiredString(value.storageDir, "storageDir", sourcePath);
+    }
+    const crawl = validateCrawlConfig(value.crawl, sourcePath);
+    if (crawl !== undefined)
+        config.crawl = crawl;
+    const comparison = validateComparisonConfig(value.comparison, sourcePath);
+    if (comparison !== undefined)
+        config.comparison = comparison;
+    const check = validateCheckConfig(value.check, sourcePath);
+    if (check !== undefined) {
+        if (value.version !== 2) {
+            throw invalidConfig("check settings require configuration version 2.", sourcePath);
+        }
+        config.check = check;
+    }
+    return config;
+}
+async function pathExists(filePath) {
+    try {
+        await access(filePath);
+        return true;
+    }
+    catch (error) {
+        if (error instanceof Error && "code" in error && error.code === "ENOENT") {
+            return false;
+        }
+        throw error;
+    }
+}
+/** Finds the nearest project configuration at or above `cwd`. */
+export async function findProjectConfig(cwd = process.cwd()) {
+    let directory = path.resolve(cwd);
+    while (true) {
+        const candidate = path.join(directory, PROJECT_CONFIG_FILENAME);
+        if (await pathExists(candidate))
+            return candidate;
+        const parent = path.dirname(directory);
+        if (parent === directory)
+            return undefined;
+        directory = parent;
+    }
+}
+/** Loads exactly one selected or discovered project configuration. */
+export async function loadProjectConfig(options = {}) {
+    const cwd = path.resolve(options.cwd ?? process.cwd());
+    if (options.configPath !== undefined && options.noConfig) {
+        throw new Error("--config and --no-config cannot be used together.");
+    }
+    if (options.noConfig)
+        return undefined;
+    if (options.configPath !== undefined &&
+        options.configPath.trim().length === 0) {
+        throw new Error("--config requires a file path.");
+    }
+    const configPath = options.configPath !== undefined
+        ? path.resolve(cwd, options.configPath)
+        : await findProjectConfig(cwd);
+    if (configPath === undefined)
+        return undefined;
+    let content;
+    try {
+        content = await readFile(configPath, "utf8");
+    }
+    catch (error) {
+        throw new Error(`Unable to read Breakcheck configuration ${configPath}.`, {
+            cause: error,
+        });
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(content);
+    }
+    catch (error) {
+        throw invalidConfig("file is not valid JSON.", configPath, error);
+    }
+    return {
+        configPath,
+        config: validateProjectConfig(parsed, configPath),
+    };
+}
+/**
+ * Loads configuration and resolves all configured filesystem paths. When no
+ * storage directory is configured, the legacy project-root behavior remains.
+ */
+export async function resolveProjectConfig(options = {}) {
+    const cwd = path.resolve(options.cwd ?? process.cwd());
+    const loaded = await loadProjectConfig({ ...options, cwd });
+    const config = loaded?.config;
+    const configDirectory = loaded ? path.dirname(loaded.configPath) : cwd;
+    const storageDir = config?.storageDir === undefined
+        ? await findRootDir(cwd)
+        : path.resolve(configDirectory, config.storageDir);
+    let check;
+    if (config?.check) {
+        const server = config.check.server;
+        check = {
+            configDirectory,
+            routesFile: path.resolve(configDirectory, config.check.routesFile),
+            baselineSnapshot: config.check.baselineSnapshot,
+            prepare: config.check.prepare,
+            reportDir: path.resolve(configDirectory, config.check.reportDir ?? path.join(storageDir, "reports")),
+            ...(server === undefined
+                ? {}
+                : {
+                    server: {
+                        start: server.start,
+                        ...(server.stop === undefined ? {} : { stop: server.stop }),
+                        ...(server.env === undefined ? {} : { env: server.env }),
+                        ...(server.readyPath === undefined
+                            ? {}
+                            : { readyPath: server.readyPath }),
+                        ...(server.timeoutMs === undefined
+                            ? {}
+                            : { timeoutMs: server.timeoutMs }),
+                        cwd: path.resolve(configDirectory, server.cwd ?? "."),
+                    },
+                }),
+        };
+    }
+    return {
+        ...(loaded ? { configPath: loaded.configPath } : {}),
+        storageDir: path.resolve(storageDir),
+        ...(config?.baseUrl === undefined ? {} : { baseUrl: config.baseUrl }),
+        crawl: { ...(config?.crawl ?? {}) },
+        ...(config?.comparison?.rulesDir === undefined
+            ? {}
+            : {
+                rulesDir: path.resolve(configDirectory, config.comparison.rulesDir),
+            }),
+        ...(check === undefined ? {} : { check }),
+    };
+}
+/** Serializes a validated project configuration with stable formatting. */
+export function serializeProjectConfig(config) {
+    return `${JSON.stringify(validateProjectConfig(config), null, 2)}\n`;
+}
+/** Creates a project configuration without overwriting an existing path. */
+export async function writeProjectConfig(configPath, config) {
+    const absolutePath = path.resolve(configPath);
+    await writeFile(absolutePath, serializeProjectConfig(config), {
+        encoding: "utf8",
+        flag: "wx",
+    });
+}
+//# sourceMappingURL=config.js.map

package/dist/lib/config.js.map

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

package/dist/lib/crawlee-logger.d.ts

@@ -0,0 +1,2 @@
+import type { Logger as PinoLogger } from "pino";
+export declare function configureCrawleeLogger(pinoLogger: PinoLogger): void;

package/dist/lib/crawlee-logger.js

@@ -0,0 +1,43 @@
+import { Logger as CrawleeLogger, log as crawleeLog, LogLevel } from "crawlee";
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+class PinoCrawleeLogger extends CrawleeLogger {
+    pinoLogger;
+    constructor(pinoLogger) {
+        super({});
+        this.pinoLogger = pinoLogger;
+    }
+    _log(level, message, data, exception, opts = {}) {
+        const component = typeof opts.prefix === "string" ? opts.prefix : undefined;
+        const prefix = component ? `${component}: ` : "";
+        const suffix = typeof opts.suffix === "string" ? ` ${opts.suffix}` : "";
+        const fields = {
+            ...(isRecord(data) ? data : {}),
+            ...(component ? { component } : {}),
+            ...(exception !== undefined ? { err: exception } : {}),
+        };
+        const logMessage = `${prefix}${message}${suffix}`;
+        switch (level) {
+            case LogLevel.ERROR:
+                this.pinoLogger.error(fields, logMessage);
+                break;
+            case LogLevel.SOFT_FAIL:
+            case LogLevel.WARNING:
+                this.pinoLogger.warn(fields, logMessage);
+                break;
+            case LogLevel.DEBUG:
+            case LogLevel.PERF:
+                this.pinoLogger.debug(fields, logMessage);
+                break;
+            case LogLevel.INFO:
+            default:
+                this.pinoLogger.info(fields, logMessage);
+                break;
+        }
+    }
+}
+export function configureCrawleeLogger(pinoLogger) {
+    crawleeLog.setOptions({ logger: new PinoCrawleeLogger(pinoLogger) });
+}
+//# sourceMappingURL=crawlee-logger.js.map

package/dist/lib/crawlee-logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"crawlee-logger.js","sourceRoot":"","sources":["../../src/lib/crawlee-logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,aAAa,EAAE,GAAG,IAAI,UAAU,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAG/E,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED,MAAM,iBAAkB,SAAQ,aAAa;IACd,UAAU;IAAvC,YAA6B,UAAsB;QACjD,KAAK,CAAC,EAAE,CAAC,CAAC;0BADiB,UAAU;IAEvC,CAAC;IAEQ,IAAI,CACX,KAAe,EACf,OAAe,EACf,IAAc,EACd,SAAmB,EACnB,IAAI,GAA4B,EAAE;QAElC,MAAM,SAAS,GAAG,OAAO,IAAI,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;QAC5E,MAAM,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC,GAAG,SAAS,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QACjD,MAAM,MAAM,GAAG,OAAO,IAAI,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACxE,MAAM,MAAM,GAAG;YACb,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;YAC/B,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACnC,GAAG,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACvD,CAAC;QACF,MAAM,UAAU,GAAG,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,EAAE,CAAC;QAElD,QAAQ,KAAK,EAAE,CAAC;YACd,KAAK,QAAQ,CAAC,KAAK;gBACjB,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;gBAC1C,MAAM;YACR,KAAK,QAAQ,CAAC,SAAS,CAAC;YACxB,KAAK,QAAQ,CAAC,OAAO;gBACnB,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;gBACzC,MAAM;YACR,KAAK,QAAQ,CAAC,KAAK,CAAC;YACpB,KAAK,QAAQ,CAAC,IAAI;gBAChB,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;gBAC1C,MAAM;YACR,KAAK,QAAQ,CAAC,IAAI,CAAC;YACnB;gBACE,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;gBACzC,MAAM;QACV,CAAC;IACH,CAAC;CACF;AAED,MAAM,UAAU,sBAAsB,CAAC,UAAsB;IAC3D,UAAU,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,IAAI,iBAAiB,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;AACvE,CAAC"}

package/dist/lib/logger.d.ts

@@ -1,8 +1,13 @@
-type LogLevel = "fatal" | "error" | "warn" | "info" | "debug" | "trace";
+import { pino } from "pino";
+type LogLevel = "fatal" | "error" | "warn" | "info" | "debug" | "trace" | "silent";
 export interface LoggerConfig {
     useJsonLogs?: boolean;
     level?: LogLevel;
 }
-export declare function createLogger(config?: LoggerConfig): import("pino").Logger<never, boolean>;
-export declare const logger: import("pino").Logger<never, boolean>;
+export declare function createLogger(config?: LoggerConfig): pino.Logger<never, boolean>;
+/**
+ * Configure the shared Breakcheck logger and the Crawlee logger together.
+ */
+export declare function configureLogger(config?: LoggerConfig): pino.Logger<never, boolean>;
+export declare let logger: pino.Logger<never, boolean>;
 export {};

package/dist/lib/logger.js

@@ -1,4 +1,5 @@
 import { pino } from "pino";
+import { configureCrawleeLogger } from "./crawlee-logger.js";
 // Determine the log level from the environment variable, defaulting to 'info'
 const logLevel = process.env.LOG_LEVEL || "info";
 // Create a logger with the specified configuration
@@ -20,7 +21,16 @@ export function createLogger(config = {}) {
         transport,
     });
 }
+/**
+ * Configure the shared Breakcheck logger and the Crawlee logger together.
+ */
+export function configureLogger(config = {}) {
+    logger = createLogger(config);
+    configureCrawleeLogger(logger);
+    return logger;
+}
 // Create the default shared logger instance (for backward compatibility)
 // This will use pretty logging by default for CLI, but can be overridden
-export const logger = createLogger({ useJsonLogs: false });
+export let logger = createLogger({ useJsonLogs: false });
+configureCrawleeLogger(logger);
 //# sourceMappingURL=logger.js.map

package/dist/lib/logger.js.map

@@ -1 +1 @@
-{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/lib/logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAK5B,8EAA8E;AAC9E,MAAM,QAAQ,GAAc,OAAO,CAAC,GAAG,CAAC,SAAsB,IAAI,MAAM,CAAC;AAQzE,mDAAmD;AACnD,MAAM,UAAU,YAAY,CAAC,SAAuB,EAAE;IACpD,MAAM,EAAE,WAAW,GAAG,KAAK,EAAE,KAAK,GAAG,QAAQ,EAAE,GAAG,MAAM,CAAC;IAEzD,gDAAgD;IAChD,MAAM,SAAS,GAAG,WAAW;QAC3B,CAAC,CAAC,SAAS,CAAC,4BAA4B;QACxC,CAAC,CAAC;YACE,MAAM,EAAE,aAAa;YACrB,OAAO,EAAE;gBACP,QAAQ,EAAE,IAAI;gBACd,aAAa,EAAE,cAAc;gBAC7B,MAAM,EAAE,cAAc;aACvB;SACF,CAAC;IAEN,OAAO,IAAI,CAAC;QACV,KAAK;QACL,SAAS;KACV,CAAC,CAAC;AACL,CAAC;AAED,yEAAyE;AACzE,yEAAyE;AACzE,MAAM,CAAC,MAAM,MAAM,GAAG,YAAY,CAAC,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC,CAAC"}
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/lib/logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAM7D,8EAA8E;AAC9E,MAAM,QAAQ,GAAc,OAAO,CAAC,GAAG,CAAC,SAAsB,IAAI,MAAM,CAAC;AAQzE,mDAAmD;AACnD,MAAM,UAAU,YAAY,CAAC,MAAM,GAAiB,EAAE;IACpD,MAAM,EAAE,WAAW,GAAG,KAAK,EAAE,KAAK,GAAG,QAAQ,EAAE,GAAG,MAAM,CAAC;IAEzD,gDAAgD;IAChD,MAAM,SAAS,GAAG,WAAW;QAC3B,CAAC,CAAC,SAAS,CAAC,4BAA4B;QACxC,CAAC,CAAC;YACE,MAAM,EAAE,aAAa;YACrB,OAAO,EAAE;gBACP,QAAQ,EAAE,IAAI;gBACd,aAAa,EAAE,cAAc;gBAC7B,MAAM,EAAE,cAAc;aACvB;SACF,CAAC;IAEN,OAAO,IAAI,CAAC;QACV,KAAK;QACL,SAAS;KACV,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,MAAM,GAAiB,EAAE;IACvD,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;IAC9B,sBAAsB,CAAC,MAAM,CAAC,CAAC;IAC/B,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,yEAAyE;AACzE,yEAAyE;AACzE,MAAM,CAAC,IAAI,MAAM,GAAG,YAAY,CAAC,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC,CAAC;AACzD,sBAAsB,CAAC,MAAM,CAAC,CAAC"}

package/dist/lib/root.d.ts

@@ -4,4 +4,4 @@
  *
  * @returns The absolute path to the root directory
  */
-export declare function findRootDir(): Promise<string>;
+export declare function findRootDir(startDir?: string): Promise<string>;

package/dist/lib/root.js

@@ -1,23 +1,34 @@
-import { findUp, pathExists } from "find-up";
-import fs from "fs/promises";
-import path from "path";
+import { findUp } from "find-up";
+import { access, readFile } from "node:fs/promises";
+import path from "node:path";
+async function pathExists(filePath) {
+    try {
+        await access(filePath);
+        return true;
+    }
+    catch (error) {
+        if (error instanceof Error && "code" in error && error.code === "ENOENT")
+            return false;
+        throw error;
+    }
+}
 /**
  * Finds the root directory of the project by looking for a package.json file
  * that contains a "workspaces" configuration.
  *
  * @returns The absolute path to the root directory
  */
-export async function findRootDir() {
+export async function findRootDir(startDir = process.cwd()) {
     const rootPackageJsonPath = await findUp(async (directory) => {
         const packageJsonPath = path.join(directory, "package.json");
         const exists = await pathExists(packageJsonPath);
         if (exists) {
-            const packageJson = JSON.parse(await fs.readFile(packageJsonPath, "utf8"));
+            const packageJson = JSON.parse(await readFile(packageJsonPath, "utf8"));
             if (packageJson.workspaces) {
                 return packageJsonPath;
             }
         }
-    }, { type: "file" });
+    }, { type: "file", cwd: startDir });
     return rootPackageJsonPath
         ? path.dirname(rootPackageJsonPath)
         : process.cwd();

package/dist/lib/root.js.map

@@ -1 +1 @@
-{"version":3,"file":"root.js","sourceRoot":"","sources":["../../src/lib/root.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC7C,OAAO,EAAE,MAAM,aAAa,CAAC;AAC7B,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW;IAC/B,MAAM,mBAAmB,GAAG,MAAM,MAAM,CACtC,KAAK,EAAE,SAAS,EAAE,EAAE;QAClB,MAAM,eAAe,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;QAC7D,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,eAAe,CAAC,CAAC;QACjD,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAC5B,MAAM,EAAE,CAAC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC,CAC3C,CAAC;YACF,IAAI,WAAW,CAAC,UAAU,EAAE,CAAC;gBAC3B,OAAO,eAAe,CAAC;YACzB,CAAC;QACH,CAAC;IACH,CAAC,EACD,EAAE,IAAI,EAAE,MAAM,EAAE,CACjB,CAAC;IAEF,OAAO,mBAAmB;QACxB,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,mBAAmB,CAAC;QACnC,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;AACpB,CAAC"}
+{"version":3,"file":"root.js","sourceRoot":"","sources":["../../src/lib/root.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,KAAK,UAAU,UAAU,CAAC,QAAgB;IACxC,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,QAAQ,CAAC,CAAC;QACvB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,KAAK,IAAI,MAAM,IAAI,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ;YACtE,OAAO,KAAK,CAAC;QACf,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,QAAQ,GAAW,OAAO,CAAC,GAAG,EAAE;IAEhC,MAAM,mBAAmB,GAAG,MAAM,MAAM,CACtC,KAAK,EAAE,SAAS,EAAE,EAAE;QAClB,MAAM,eAAe,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;QAC7D,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,eAAe,CAAC,CAAC;QACjD,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC,CAAC,CAAC;YACxE,IAAI,WAAW,CAAC,UAAU,EAAE,CAAC;gBAC3B,OAAO,eAAe,CAAC;YACzB,CAAC;QACH,CAAC;IACH,CAAC,EACD,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,CAChC,CAAC;IAEF,OAAO,mBAAmB;QACxB,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,mBAAmB,CAAC;QACnC,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;AACpB,CAAC"}

package/dist/lib/storage.d.ts

@@ -0,0 +1,12 @@
+/** Resolved locations for all Breakcheck-managed artifacts. */
+export interface StorageContext {
+    storageDir: string;
+    snapshotsDir: string;
+    comparisonsDir: string;
+}
+/** Resolves an explicit artifact root or the legacy project root. */
+export declare function resolveStorageContext(storageDir?: string): Promise<StorageContext>;
+export declare function resolveStorageEntry(storageDir: string, name: string, kind: string): string;
+export declare function deleteStorageEntry(storageDir: string, name: string, kind: string): Promise<boolean>;
+export declare function listStorageDirectories(storageDir: string): Promise<string[]>;
+export declare function deleteAllStorageEntries(storageDir: string, kind: string): Promise<string[]>;

package/dist/lib/storage.js

@@ -0,0 +1,76 @@
+import { lstat, readdir, rm } from "node:fs/promises";
+import path from "node:path";
+import { findRootDir } from "./root.js";
+/** Resolves an explicit artifact root or the legacy project root. */
+export async function resolveStorageContext(storageDir) {
+    const resolvedStorageDir = path.resolve(storageDir ?? (await findRootDir()));
+    return {
+        storageDir: resolvedStorageDir,
+        snapshotsDir: path.join(resolvedStorageDir, "snapshots"),
+        comparisonsDir: path.join(resolvedStorageDir, "comparisons"),
+    };
+}
+function isErrnoException(error) {
+    return (error instanceof Error && "code" in error && typeof error.code === "string");
+}
+export function resolveStorageEntry(storageDir, name, kind) {
+    if (name.length === 0 ||
+        name.trim().length === 0 ||
+        name === "." ||
+        name === ".." ||
+        name.includes("/") ||
+        name.includes("\\")) {
+        throw new Error(`Invalid ${kind} name "${name}". Names must be a single path component.`);
+    }
+    const resolvedStorageDir = path.resolve(storageDir);
+    const resolvedEntry = path.resolve(resolvedStorageDir, name);
+    if (path.dirname(resolvedEntry) !== resolvedStorageDir) {
+        throw new Error(`Invalid ${kind} name "${name}". Names must remain inside the storage directory.`);
+    }
+    return resolvedEntry;
+}
+export async function deleteStorageEntry(storageDir, name, kind) {
+    const entryPath = resolveStorageEntry(storageDir, name, kind);
+    let entryStats;
+    try {
+        entryStats = await lstat(entryPath);
+    }
+    catch (error) {
+        if (isErrnoException(error) && error.code === "ENOENT") {
+            return false;
+        }
+        throw error;
+    }
+    if (!entryStats.isDirectory()) {
+        throw new Error(`Cannot delete ${kind} "${name}": it is not a directory.`);
+    }
+    await rm(entryPath, { recursive: true });
+    return true;
+}
+export async function listStorageDirectories(storageDir) {
+    let entries;
+    try {
+        entries = await readdir(storageDir, { withFileTypes: true });
+    }
+    catch (error) {
+        if (isErrnoException(error) && error.code === "ENOENT") {
+            return [];
+        }
+        throw error;
+    }
+    return entries
+        .filter((entry) => entry.isDirectory())
+        .map((entry) => entry.name)
+        .sort();
+}
+export async function deleteAllStorageEntries(storageDir, kind) {
+    const names = await listStorageDirectories(storageDir);
+    const deletedNames = [];
+    for (const name of names) {
+        if (await deleteStorageEntry(storageDir, name, kind)) {
+            deletedNames.push(name);
+        }
+    }
+    return deletedNames;
+}
+//# sourceMappingURL=storage.js.map