@cleaver/breakcheck-core 0.2.3 → 0.2.5

package/dist/core/rules/RulesEngine.js

@@ -1,116 +1,202 @@
 import * as cheerio from "cheerio";
-import { REGION_NAME_PATTERN, } from "../../types/rules.js";
+import { REGION_NAME_PATTERN } from "../../types/rules.js";
 import { processRulesDsl } from "./RulesDsl.js";
+function objectValue(value, context) {
+    if (typeof value !== "object" || value === null || Array.isArray(value))
+        throw new Error(`${context} must be an object.`);
+    return value;
+}
+function keysAre(modifiers, allowed, context) {
+    const extra = Object.keys(modifiers).find((key) => !allowed.includes(key));
+    if (extra)
+        throw new Error(`${context} has unsupported modifier "${extra}".`);
+}
+function requiredString(modifiers, key, context, nonEmpty = false) {
+    const value = modifiers[key];
+    if (typeof value !== "string" || (nonEmpty && value.length === 0))
+        throw new Error(`${context} requires ${nonEmpty ? "a non-empty" : "a string"} "${key}" modifier.`);
+    return value;
+}
+function compileRegex(pattern, context, modifier) {
+    try {
+        return new RegExp(pattern);
+    }
+    catch (error) {
+        throw new Error(`${context} has invalid ${modifier} regex: ${error instanceof Error ? error.message : String(error)}`, { cause: error });
+    }
+}
+function compileAction(value, selector, ruleIndex, actionIndex) {
+    const action = objectValue(value, `Rule ${ruleIndex} action ${actionIndex}`);
+    const actionName = action.action;
+    const context = `Rule ${ruleIndex} selector "${selector}" action ${actionIndex}`;
+    const modifiers = action.modifiers === undefined
+        ? {}
+        : objectValue(action.modifiers, `${context} modifiers`);
+    switch (actionName) {
+        case "include":
+        case "exclude": {
+            keysAre(modifiers, ["content_regex"], context);
+            const contentPattern = modifiers.content_regex;
+            if (contentPattern !== undefined && typeof contentPattern !== "string")
+                throw new Error(`${context} modifier "content_regex" must be a string.`);
+            return {
+                action: actionName,
+                ...(typeof contentPattern === "string"
+                    ? {
+                        contentRegex: compileRegex(contentPattern, context, "content_regex"),
+                    }
+                    : {}),
+            };
+        }
+        case "remove_attr":
+            keysAre(modifiers, ["attr"], context);
+            return {
+                action: "remove_attr",
+                attr: requiredString(modifiers, "attr", context, true),
+            };
+        case "rewrite_attr": {
+            keysAre(modifiers, ["attr", "regex", "replace"], context);
+            const attr = requiredString(modifiers, "attr", context, true);
+            const pattern = requiredString(modifiers, "regex", context);
+            return {
+                action: "rewrite_attr",
+                attr,
+                regex: compileRegex(pattern, context, "regex"),
+                replace: requiredString(modifiers, "replace", context),
+            };
+        }
+        case "rewrite_content": {
+            keysAre(modifiers, ["regex", "replace"], context);
+            const pattern = requiredString(modifiers, "regex", context);
+            return {
+                action: "rewrite_content",
+                regex: compileRegex(pattern, context, "regex"),
+                replace: requiredString(modifiers, "replace", context),
+            };
+        }
+        default:
+            throw new Error(`${context} has unsupported action "${String(actionName)}".`);
+    }
+}
+function validateSelector(selector, context) {
+    if (typeof selector !== "string" || selector.trim().length === 0)
+        throw new Error(`${context} requires a non-empty selector.`);
+    const cloned = selector.slice();
+    try {
+        cheerio.load("", {}, false)(cloned);
+    }
+    catch (error) {
+        throw new Error(`${context} has invalid selector "${cloned}": ${error instanceof Error ? error.message : String(error)}`, { cause: error });
+    }
+    return cloned;
+}
+function compileRuleset(value) {
+    const input = objectValue(value, "Ruleset");
+    if (!Array.isArray(input.rules))
+        throw new Error("Ruleset rules must be an array.");
+    const rules = input.rules.map((candidate, ruleIndex) => {
+        const rule = objectValue(candidate, `Rule ${ruleIndex}`);
+        const selector = validateSelector(rule.selector, `Rule ${ruleIndex}`);
+        if (!Array.isArray(rule.actions) || rule.actions.length === 0)
+            throw new Error(`Rule ${ruleIndex} selector "${selector}" requires at least one action.`);
+        return {
+            selector,
+            actions: rule.actions.map((action, actionIndex) => compileAction(action, selector, ruleIndex, actionIndex)),
+        };
+    });
+    const regionsValue = input.regions ?? [];
+    if (!Array.isArray(regionsValue))
+        throw new Error("Ruleset regions must be an array.");
+    const names = new Set();
+    const regions = regionsValue.map((candidate, regionIndex) => {
+        const region = objectValue(candidate, `Region ${regionIndex}`);
+        const selector = validateSelector(region.selector, `Region ${regionIndex}`);
+        if (typeof region.name !== "string" ||
+            !REGION_NAME_PATTERN.test(region.name))
+            throw new Error(`Invalid region name "${String(region.name)}". Region names must match [A-Za-z_][A-Za-z0-9_]*.`);
+        if (names.has(region.name))
+            throw new Error(`Duplicate region name: ${region.name}`);
+        names.add(region.name);
+        return { selector, name: region.name.slice() };
+    });
+    return { rules, regions };
+}
 export class RulesEngine {
     ruleset;
     constructor(ruleset) {
-        const regions = ruleset.regions ?? [];
-        this.validateRegions(regions);
-        this.ruleset = { ...ruleset, regions };
+        this.ruleset = ruleset;
     }
     static async create(rulesDirectoryOrRuleset) {
         const ruleset = typeof rulesDirectoryOrRuleset === "string"
             ? await processRulesDsl(rulesDirectoryOrRuleset)
-            : rulesDirectoryOrRuleset ?? { name: "none", rules: [] };
-        return new RulesEngine(ruleset);
+            : (rulesDirectoryOrRuleset ?? { name: "none", rules: [] });
+        return new RulesEngine(compileRuleset(ruleset));
     }
     process(html) {
         const $ = cheerio.load(html);
-        // Apply ordinary rules in declaration order before selecting regions.
         for (const rule of this.ruleset.rules) {
-            const elements = $(rule.selector);
-            elements.each((_, element) => {
-                if (element.type === "tag") {
-                    for (const action of rule.actions) {
-                        this.applyAction($, element, action);
-                    }
-                }
+            $(rule.selector).each((_, element) => {
+                if (element.type !== "tag" &&
+                    element.type !== "script" &&
+                    element.type !== "style")
+                    return;
+                for (const action of rule.actions)
+                    this.applyAction($, element, action);
             });
         }
-        const regions = this.ruleset.regions ?? [];
-        if (regions.length > 0) {
-            return this.serializeRegions($, regions);
-        }
-        return $.html();
+        return this.ruleset.regions.length ? this.serializeRegions($) : $.html();
     }
-    validateRegions(regions) {
-        const names = new Set();
-        for (const region of regions) {
-            if (!REGION_NAME_PATTERN.test(region.name)) {
-                throw new Error(`Invalid region name "${region.name}". Region names must match [A-Za-z_][A-Za-z0-9_]*.`);
-            }
-            if (names.has(region.name)) {
-                throw new Error(`Duplicate region name: ${region.name}`);
-            }
-            names.add(region.name);
-        }
-    }
-    serializeRegions($, regions) {
+    serializeRegions($) {
         const output = cheerio.load("<breakcheck-regions></breakcheck-regions>", {}, false);
         const root = output("breakcheck-regions");
-        const sortedRegions = [...regions].sort((left, right) => left.name < right.name ? -1 : left.name > right.name ? 1 : 0);
-        for (const region of sortedRegions) {
+        const regions = [...this.ruleset.regions].sort((left, right) => left.name.localeCompare(right.name));
+        for (const region of regions) {
             const fragments = [];
             $(region.selector).each((_, element) => {
-                if (element.type === "tag") {
+                if (element.type === "tag")
                     fragments.push($.html(element));
-                }
             });
-            if (fragments.length === 0) {
-                continue;
-            }
-            const wrapper = output("<region></region>").attr("name", region.name);
-            wrapper.append(fragments.join(""));
-            root.append(wrapper);
+            if (fragments.length)
+                root.append(output("<region></region>")
+                    .attr("name", region.name)
+                    .append(fragments.join("")));
         }
         return output.html();
     }
     applyAction($, element, action) {
-        const $element = $(element);
-        // Check content regex if specified
-        if (action.modifiers?.content_regex) {
-            const content = $element.text();
-            const regex = new RegExp(action.modifiers.content_regex);
-            if (!regex.test(content)) {
-                return;
-            }
-        }
+        const selected = $(element);
+        if ("contentRegex" in action &&
+            action.contentRegex &&
+            !action.contentRegex.test(selected.text()))
+            return;
         switch (action.action) {
-            case "exclude":
-                $element.remove();
-                break;
             case "include":
-                // No action needed for include
-                break;
+                return;
+            case "exclude":
+                selected.remove();
+                return;
             case "remove_attr":
-                if (action.modifiers && "attr" in action.modifiers) {
-                    $element.removeAttr(action.modifiers.attr);
-                }
-                break;
-            case "rewrite_attr":
-                if (action.modifiers &&
-                    "attr" in action.modifiers &&
-                    "regex" in action.modifiers &&
-                    "replace" in action.modifiers) {
-                    const currentValue = $element.attr(action.modifiers.attr);
-                    if (currentValue) {
-                        const regex = new RegExp(action.modifiers.regex);
-                        const newValue = currentValue.replace(regex, action.modifiers.replace);
-                        $element.attr(action.modifiers.attr, newValue);
-                    }
-                }
-                break;
+                selected.removeAttr(action.attr);
+                return;
+            case "rewrite_attr": {
+                const current = selected.attr(action.attr);
+                if (current !== undefined)
+                    selected.attr(action.attr, current.replace(action.regex, action.replace));
+                return;
+            }
             case "rewrite_content":
-                if (action.modifiers &&
-                    "regex" in action.modifiers &&
-                    "replace" in action.modifiers) {
-                    const content = $element.text();
-                    const regex = new RegExp(action.modifiers.regex);
-                    const newContent = content.replace(regex, action.modifiers.replace);
-                    $element.text(newContent);
-                }
-                break;
+                this.rewriteTextNodes($, element, action.regex, action.replace);
         }
     }
+    rewriteTextNodes($, element, regex, replace) {
+        $(element)
+            .contents()
+            .each((_, child) => {
+            if (child.type === "text")
+                child.data = child.data.replace(regex, replace);
+            else if (child.type === "tag")
+                this.rewriteTextNodes($, child, regex, replace);
+        });
+    }
 }
 //# sourceMappingURL=RulesEngine.js.map

package/dist/core/rules/RulesEngine.js.map

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

package/dist/core/snapshot/index.d.ts

@@ -1,4 +1,4 @@
-import { SnapshotConfig, SnapshotResult } from "../../types/api.js";
+import type { SnapshotConfig, SnapshotResult } from "../../types/api.js";
 import { SnapshotRepository } from "./classes/SnapshotRepository.js";
 export { LoadedSnapshot } from "./classes/LoadedSnapshot.js";
 export { SnapshotRepository } from "./classes/SnapshotRepository.js";

package/dist/core/snapshot/index.js

@@ -1,5 +1,6 @@
 import { Dataset } from "crawlee";
 import { logger } from "../../lib/logger.js";
+import { resolveUrlPaths } from "../crawler/url-paths.js";
 import { BreakcheckCrawler } from "../crawler/index.js";
 export { LoadedSnapshot } from "./classes/LoadedSnapshot.js";
 export { SnapshotRepository } from "./classes/SnapshotRepository.js";
@@ -20,7 +21,27 @@ export async function createSnapshot(config, snapshotRepository) {
             logger.error({ config }, "Snapshot creation failed: name is required");
             throw new Error("name is required");
         }
-        const crawler = new BreakcheckCrawler(config.crawlSettings);
+        const manifest = config.urlPaths === undefined
+            ? undefined
+            : resolveUrlPaths(config.baseUrl, config.urlPaths);
+        if (manifest?.issues.length) {
+            throw new Error(formatUrlPathIssues(manifest.issues));
+        }
+        const startUrls = manifest?.paths.map((urlPath) => new URL(urlPath, config.baseUrl).href);
+        if (startUrls &&
+            config.crawlSettings.maxRequests !== undefined &&
+            config.crawlSettings.maxRequests < startUrls.length) {
+            throw new Error(`maxRequests (${config.crawlSettings.maxRequests}) must be at least the number of unique manifest paths (${startUrls.length})`);
+        }
+        if (startUrls &&
+            (config.crawlSettings.includePatterns?.length ||
+                config.crawlSettings.excludePatterns?.length)) {
+            throw new Error("includePatterns and excludePatterns cannot be used with an exact URL manifest");
+        }
+        const crawler = new BreakcheckCrawler(config.crawlSettings, {
+            startUrls,
+            followLinks: config.urlPaths === undefined,
+        });
         const { datasetName, errors: crawlErrors } = await crawler.crawl();
         errors.push(...crawlErrors);
         const dataset = await Dataset.open(datasetName);
@@ -64,4 +85,18 @@ export async function createSnapshot(config, snapshotRepository) {
         };
     }
 }
+function formatUrlPathIssues(issues) {
+    return issues
+        .map((issue) => {
+        switch (issue.type) {
+            case "base":
+                return `${issue.message}: ${issue.value}`;
+            case "entry":
+                return `Manifest path ${issue.index + 1} (${issue.value}): ${issue.message}`;
+            case "manifest":
+                return issue.message;
+        }
+    })
+        .join("; ");
+}
 //# sourceMappingURL=index.js.map

package/dist/core/snapshot/index.js.map

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

package/dist/index.d.ts

@@ -1,10 +1,11 @@
 export * from "./api/index.js";
-export { createSnapshotFromConfig, listSnapshots, runComparison } from "./api/index.js";
+export { createSnapshotFromConfig, listSnapshots, runComparison, } from "./api/index.js";
 export * from "./core/view/index.js";
+export * from "./core/crawler/url-paths.js";
 export * from "./lib/logger.js";
 export { createLogger, logger } from "./lib/logger.js";
 export * from "./types/api.js";
-export type { ComparisonConfig, SnapshotConfig, SnapshotResult } from "./types/api.js";
+export type { ComparisonConfig, SnapshotConfig, SnapshotResult, } from "./types/api.js";
 export * from "./types/compare.js";
 export * from "./types/crawler.js";
 export type { CrawlError } from "./types/crawler.js";

package/dist/index.js

@@ -1,7 +1,8 @@
 export * from "./api/index.js";
 // Explicit exports for CLI and other consumers
-export { createSnapshotFromConfig, listSnapshots, runComparison } from "./api/index.js";
+export { createSnapshotFromConfig, listSnapshots, runComparison, } from "./api/index.js";
 export * from "./core/view/index.js";
+export * from "./core/crawler/url-paths.js";
 export * from "./lib/logger.js";
 export { createLogger, logger } from "./lib/logger.js";
 export * from "./types/api.js";

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,+CAA+C;AAC/C,OAAO,EACH,wBAAwB,EACxB,aAAa,EACb,aAAa,EAChB,MAAM,gBAAgB,CAAC;AACxB,cAAc,sBAAsB,CAAC;AACrC,cAAc,iBAAiB,CAAC;AAChC,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACvD,cAAc,gBAAgB,CAAC;AAM/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AAEnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,+CAA+C;AAC/C,OAAO,EACL,wBAAwB,EACxB,aAAa,EACb,aAAa,GACd,MAAM,gBAAgB,CAAC;AACxB,cAAc,sBAAsB,CAAC;AACrC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,iBAAiB,CAAC;AAChC,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACvD,cAAc,gBAAgB,CAAC;AAM/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AAEnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC"}

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;IAA7B,YAA6B,UAAsB;QACjD,KAAK,CAAC,EAAE,CAAC,CAAC;QADiB,eAAU,GAAV,UAAU,CAAY;IAEnD,CAAC;IAEQ,IAAI,CACX,KAAe,EACf,OAAe,EACf,IAAc,EACd,SAAmB,EACnB,OAAgC,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

@@ -4,5 +4,9 @@ export interface LoggerConfig {
     level?: LogLevel;
 }
 export declare function createLogger(config?: LoggerConfig): import("pino").Logger<never, boolean>;
-export declare const logger: import("pino").Logger<never, boolean>;
+/**
+ * Configure the shared Breakcheck logger and the Crawlee logger together.
+ */
+export declare function configureLogger(config?: LoggerConfig): import("pino").Logger<never, boolean>;
+export declare let logger: import("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;AAK7D,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;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,SAAuB,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/types/api.d.ts

@@ -34,6 +34,11 @@ export interface SnapshotConfig {
     name: string;
     /** Crawler configuration to use */
     crawlSettings: CrawlerConfig;
+    /**
+     * Optional root-relative paths to crawl exactly. When provided, link
+     * discovery is disabled and the base URL is not added automatically.
+     */
+    urlPaths?: string[];
     /** Optional path to generate a URL list file */
     urlListPath?: string;
 }

package/dist/types/rules.d.ts

@@ -13,19 +13,19 @@ export declare const REGION_NAME_PATTERN: RegExp;
 /**
  * Base interface for action modifiers
  */
-interface BaseActionModifiers {
+export interface ContentFilterModifiers {
     content_regex?: string;
 }
 /**
  * Modifiers for remove_attr action
  */
-interface RemoveAttrModifiers extends BaseActionModifiers {
+export interface RemoveAttrModifiers {
     attr: string;
 }
 /**
  * Modifiers for rewrite_attr action
  */
-interface RewriteAttrModifiers extends BaseActionModifiers {
+export interface RewriteAttrModifiers {
     attr: string;
     regex: string;
     replace: string;
@@ -33,21 +33,30 @@ interface RewriteAttrModifiers extends BaseActionModifiers {
 /**
  * Modifiers for rewrite_content action
  */
-interface RewriteContentModifiers extends BaseActionModifiers {
+export interface RewriteContentModifiers {
     regex: string;
     replace: string;
 }
 /**
  * Union type for all possible action modifiers
  */
-export type ActionModifiers = RemoveAttrModifiers | RewriteAttrModifiers | RewriteContentModifiers | BaseActionModifiers;
+export type ActionModifiers = RemoveAttrModifiers | RewriteAttrModifiers | RewriteContentModifiers | ContentFilterModifiers;
 /**
  * Represents a single action to be performed
  */
-export interface Action {
-    action: ActionType;
-    modifiers?: ActionModifiers;
-}
+export type Action = {
+    action: "include" | "exclude";
+    modifiers?: ContentFilterModifiers;
+} | {
+    action: "remove_attr";
+    modifiers: RemoveAttrModifiers;
+} | {
+    action: "rewrite_attr";
+    modifiers: RewriteAttrModifiers;
+} | {
+    action: "rewrite_content";
+    modifiers: RewriteContentModifiers;
+};
 /**
  * Represents a single rule with a selector and its actions
  */
@@ -71,4 +80,3 @@ export interface Ruleset {
     /** Named regions are optional for backwards-compatible inline rulesets. */
     regions?: Region[];
 }
-export {};

package/dist/types/rules.js.map

@@ -1 +1 @@
-{"version":3,"file":"rules.js","sourceRoot":"","sources":["../../src/types/rules.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAYH;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,0BAA0B,CAAC"}
+{"version":3,"file":"rules.js","sourceRoot":"","sources":["../../src/types/rules.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,0BAA0B,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cleaver/breakcheck-core",
-  "version": "0.2.3",
+  "version": "0.2.5",
   "type": "module",
   "engines": {
     "node": ">=22"