@d-zero/beholder 4.0.0 → 4.1.1

package/dist/to-page-error-entry.js

@@ -0,0 +1,19 @@
+/**
+ * Converts an uncaught exception / unhandled Promise rejection (captured via
+ * `page.on('pageerror')`) into a `ConsoleLogEntry`.
+ * @param error - The value emitted by `page.on('pageerror')`; typed as `unknown`
+ * because Puppeteer allows non-`Error` throw values (e.g. `throw 'oops'`)
+ * @param pageUrl - The URL (without hash) of the page that produced the error
+ * @returns The console log entry, with `type: 'pageerror'`
+ */
+export function toPageErrorEntry(error, pageUrl) {
+    const isErr = error instanceof Error;
+    return {
+        pageUrl,
+        type: 'pageerror',
+        text: isErr ? error.message : String(error),
+        args: [],
+        stack: isErr ? error.stack : undefined,
+        ts: Date.now(),
+    };
+}

package/dist/types.d.ts

@@ -12,6 +12,7 @@ import type { Meta } from './meta/types.js';
 import type { CDNType } from '@d-zero/shared/detect-cdn';
 import type { CompressType } from '@d-zero/shared/detect-compress';
 import type { ExURL } from '@d-zero/shared/parse-url';
+import type { ConsoleMessageType } from 'puppeteer';
 /**
  * Scraped page data returned by the scraper after successfully processing a page.
  */
@@ -367,6 +368,8 @@ export type ScrapeResult = {
     pageData?: PageData;
     /** All sub-resources captured during the page load. */
     resources: ResourceEntry[];
+    /** All console messages and uncaught page errors captured during the page load. */
+    consoleLogs: ConsoleLogEntry[];
     /** Details about why the page was ignored, present when `type` is `"skipped"`. */
     ignored?: {
         url: ExURL;
@@ -398,6 +401,38 @@ export type ResourceEntry = {
     /** The URL (without hash) of the page that triggered this resource load. */
     pageUrl: string;
 };
+/**
+ * A single console message or uncaught page error captured during page scraping.
+ * Captured via Puppeteer's `console` and `pageerror` page events; internal pages only.
+ */
+export type ConsoleLogEntry = {
+    /** The URL (without hash) of the page that produced this message. */
+    pageUrl: string;
+    /**
+     * The console message type (Puppeteer's `ConsoleMessageType`, e.g. `"log"`, `"warn"`, `"error"`),
+     * or `"pageerror"` for an uncaught exception / unhandled Promise rejection.
+     */
+    type: ConsoleMessageType | 'pageerror';
+    /** The message text, or the error's `message` for `"pageerror"` entries. */
+    text: string;
+    /**
+     * Arguments passed to the console call, resolved via `JSHandle.jsonValue()`.
+     * An individual argument is `undefined` when it could not be resolved (e.g. a
+     * destroyed execution context or a value `jsonValue()` cannot serialize).
+     * Always empty for `"pageerror"` entries.
+     */
+    args: unknown[];
+    /** Source location of the message, or `undefined` when unavailable (always `undefined` for `"pageerror"`). */
+    location?: {
+        url?: string;
+        lineNumber?: number;
+        columnNumber?: number;
+    };
+    /** Stack trace text, present only for `"pageerror"` entries. */
+    stack?: string;
+    /** Timestamp (ms since epoch) when the message was captured. */
+    ts: number;
+};
 /**
  * Event payload describing a phase transition in the scraping lifecycle.
  * Phases proceed roughly in order: scrapeStart -> openPage ->

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@d-zero/beholder",
-	"version": "4.0.0",
+	"version": "4.1.1",
 	"description": "Page-level scraper for web crawling and auditing",
 	"author": "D-ZERO",
 	"license": "MIT",
@@ -20,8 +20,8 @@
 		"clean": "tsc --build --clean"
 	},
 	"dependencies": {
-		"@d-zero/puppeteer-page-scan": "4.6.5",
-		"@d-zero/shared": "0.22.2",
+		"@d-zero/puppeteer-page-scan": "4.6.6",
+		"@d-zero/shared": "0.22.3",
 		"debug": "4.4.3",
 		"puppeteer": "25.3.0",
 		"simple-wappalyzer": "1.1.100"
@@ -36,5 +36,5 @@
 		"url": "https://github.com/d-zero-dev/tools.git",
 		"directory": "packages/@d-zero/beholder"
 	},
-	"gitHead": "581df4a1796bd864f30980c759e6ada99914ffb7"
+	"gitHead": "a2f4e4a764db0930911c5c6f81696228b31926cb"
 }

package/src/index.ts

@@ -18,7 +18,7 @@ export { detectCompress } from '@d-zero/shared/detect-compress';
 export type { CompressType } from '@d-zero/shared/detect-compress';
 export { detectCDN } from '@d-zero/shared/detect-cdn';
 export type { CDNType } from '@d-zero/shared/detect-cdn';
-export type { ScrapeResult, ResourceEntry, PageData } from './types.js';
+export type { ScrapeResult, ResourceEntry, ConsoleLogEntry, PageData } from './types.js';
 export type { ScraperOptions, ChangePhaseEvent, ScraperEventTypes } from './types.js';
 export type {
 	Resource,