@vforsh/argus-watcher 0.1.2 → 0.1.4

package/dist/cdp/remoteObject.js

@@ -0,0 +1,94 @@
+export const serializeRemoteObjects = async (values, cdp) => {
+    if (!cdp) {
+        return values.map((value) => serializeRemoteObjectSync(value));
+    }
+    return Promise.all(values.map((value) => serializeRemoteObject(value, cdp)));
+};
+export const serializeRemoteObject = async (value, cdp) => {
+    if (!value || typeof value !== 'object') {
+        return value;
+    }
+    const record = value;
+    if (record.unserializableValue) {
+        return record.unserializableValue;
+    }
+    if (record.value !== undefined) {
+        return record.value;
+    }
+    if (record.preview?.properties) {
+        const preview = {};
+        for (const prop of record.preview.properties) {
+            preview[prop.name] = prop.value ?? '';
+        }
+        return preview;
+    }
+    if (cdp && record.objectId && record.type === 'object') {
+        const expanded = await expandRemoteObjectViaGetProperties(record, cdp);
+        if (expanded) {
+            return expanded;
+        }
+    }
+    return record.description ?? record.subtype ?? record.type ?? 'Object';
+};
+const serializeRemoteObjectSync = (value) => {
+    if (!value || typeof value !== 'object') {
+        return value;
+    }
+    const record = value;
+    if (record.unserializableValue) {
+        return record.unserializableValue;
+    }
+    if (record.value !== undefined) {
+        return record.value;
+    }
+    if (record.preview?.properties) {
+        const preview = {};
+        for (const prop of record.preview.properties) {
+            preview[prop.name] = prop.value ?? '';
+        }
+        return preview;
+    }
+    return record.description ?? record.subtype ?? record.type ?? 'Object';
+};
+const expandRemoteObjectViaGetProperties = async (record, cdp) => {
+    if (!record.objectId) {
+        return null;
+    }
+    let result;
+    try {
+        result = await cdp.sendAndWait('Runtime.getProperties', {
+            objectId: record.objectId,
+            ownProperties: true,
+            accessorPropertiesOnly: false,
+        });
+    }
+    catch {
+        return null;
+    }
+    const payload = result;
+    if (!Array.isArray(payload.result) || payload.result.length === 0) {
+        return null;
+    }
+    const out = {};
+    const limit = 50;
+    let added = 0;
+    for (const prop of payload.result) {
+        if (added >= limit) {
+            out['…'] = `+${payload.result.length - limit} more`;
+            break;
+        }
+        const name = prop?.name;
+        if (typeof name !== 'string' || name.trim() === '' || name === '__proto__') {
+            continue;
+        }
+        // Keep this shallow and deterministic: use CDP-provided scalar values/previews/descriptions,
+        // but don't recursively expand nested objects (that can be expensive and/or cyclic).
+        out[name] = serializeRemoteObjectSync(prop.value);
+        added += 1;
+    }
+    if (Object.keys(out).length === 0) {
+        return null;
+    }
+    return out;
+};
+//# sourceMappingURL=remoteObject.js.map

package/dist/cdp/remoteObject.js.map

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

package/dist/cdp/screenshot.d.ts

@@ -0,0 +1,10 @@
+import type { ScreenshotRequest, ScreenshotResponse } from '@vforsh/argus-core';
+import type { CdpSessionHandle } from './connection.js';
+export type Screenshotter = {
+    capture: (request: ScreenshotRequest) => Promise<ScreenshotResponse>;
+};
+export declare const createScreenshotter: (options: {
+    session: CdpSessionHandle;
+    artifactsDir: string;
+}) => Screenshotter;
+//# sourceMappingURL=screenshot.d.ts.map

package/dist/cdp/screenshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"screenshot.d.ts","sourceRoot":"","sources":["../../src/cdp/screenshot.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAA;AAC/E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAWvD,MAAM,MAAM,aAAa,GAAG;IAC3B,OAAO,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,OAAO,CAAC,kBAAkB,CAAC,CAAA;CACpE,CAAA;AAED,eAAO,MAAM,mBAAmB,GAAI,SAAS;IAAE,OAAO,EAAE,gBAAgB,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,KAAG,aAsBlG,CAAA"}

package/dist/cdp/screenshot.js

@@ -0,0 +1,83 @@
+import fs from 'node:fs/promises';
+import { ensureArtifactsDir, ensureParentDir, resolveArtifactPath } from '../artifacts.js';
+import { getDomRootId } from './dom/selector.js';
+export const createScreenshotter = (options) => {
+    const capture = async (request) => {
+        const format = request.format ?? 'png';
+        if (format !== 'png') {
+            throw new Error(`Unsupported screenshot format: ${format}`);
+        }
+        await ensureArtifactsDir(options.artifactsDir);
+        const defaultName = `screenshots/${new Date().toISOString().replace(/[:.]/g, '-')}.png`;
+        const { absolutePath, displayPath } = resolveArtifactPath(options.artifactsDir, request.outFile, defaultName);
+        await ensureParentDir(absolutePath);
+        const result = await captureScreenshot(options.session, {
+            selector: request.selector,
+            format,
+        });
+        await fs.writeFile(absolutePath, Buffer.from(result.data, 'base64'));
+        return { ok: true, outFile: displayPath, clipped: result.clipped };
+    };
+    return { capture };
+};
+const captureScreenshot = async (session, options) => {
+    let clip;
+    if (options.selector) {
+        clip = await resolveClip(session, options.selector);
+    }
+    const payload = await session.sendAndWait('Page.captureScreenshot', {
+        format: options.format,
+        clip,
+    });
+    const response = payload;
+    if (!response.data) {
+        throw new Error('Failed to capture screenshot');
+    }
+    return { data: response.data, clipped: Boolean(clip) };
+};
+const resolveClip = async (session, selector) => {
+    await session.sendAndWait('DOM.enable');
+    const rootId = await getDomRootId(session);
+    const queryResult = await session.sendAndWait('DOM.querySelector', { nodeId: rootId, selector });
+    const nodeId = queryResult.nodeId;
+    if (!nodeId) {
+        throw new Error(`No element found for selector: ${selector}`);
+    }
+    const boxResult = await session.sendAndWait('DOM.getBoxModel', { nodeId });
+    const quad = boxResult.model?.content ??
+        boxResult.model?.border;
+    if (!quad || quad.length < 8) {
+        throw new Error('Unable to compute element box model');
+    }
+    const rect = quadToRect(quad);
+    if (rect.width <= 0 || rect.height <= 0) {
+        throw new Error('Element has zero area');
+    }
+    const metrics = await session.sendAndWait('Page.getLayoutMetrics');
+    const viewport = metrics.visualViewport;
+    const pageX = viewport?.pageX ?? 0;
+    const pageY = viewport?.pageY ?? 0;
+    const scale = viewport?.scale ?? 1;
+    return {
+        x: rect.x - pageX,
+        y: rect.y - pageY,
+        width: rect.width,
+        height: rect.height,
+        scale,
+    };
+};
+const quadToRect = (quad) => {
+    const xs = [quad[0], quad[2], quad[4], quad[6]];
+    const ys = [quad[1], quad[3], quad[5], quad[7]];
+    const minX = Math.min(...xs);
+    const maxX = Math.max(...xs);
+    const minY = Math.min(...ys);
+    const maxY = Math.max(...ys);
+    return {
+        x: minX,
+        y: minY,
+        width: maxX - minX,
+        height: maxY - minY,
+    };
+};
+//# sourceMappingURL=screenshot.js.map

package/dist/cdp/screenshot.js.map

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

package/dist/cdp/storageLocal.d.ts

@@ -0,0 +1,8 @@
+import type { StorageLocalRequest, StorageLocalResponse } from '@vforsh/argus-core';
+import type { CdpSessionHandle } from './connection.js';
+/**
+ * Execute a localStorage operation in the attached page.
+ * Throws an Error on CDP failures or origin mismatch.
+ */
+export declare const executeStorageLocal: (session: CdpSessionHandle, request: StorageLocalRequest) => Promise<StorageLocalResponse>;
+//# sourceMappingURL=storageLocal.d.ts.map

package/dist/cdp/storageLocal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storageLocal.d.ts","sourceRoot":"","sources":["../../src/cdp/storageLocal.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAA;AACnF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAEvD;;;GAGG;AACH,eAAO,MAAM,mBAAmB,GAAU,SAAS,gBAAgB,EAAE,SAAS,mBAAmB,KAAG,OAAO,CAAC,oBAAoB,CA2B/H,CAAA"}

package/dist/cdp/storageLocal.js

@@ -0,0 +1,70 @@
+/**
+ * Execute a localStorage operation in the attached page.
+ * Throws an Error on CDP failures or origin mismatch.
+ */
+export const executeStorageLocal = async (session, request) => {
+    const { action, key, value, origin } = request;
+    // Build the JS expression based on action
+    const expression = buildExpression(action, key, value, origin);
+    const result = await session.sendAndWait('Runtime.evaluate', {
+        expression,
+        awaitPromise: false,
+        returnByValue: true,
+    }, { timeoutMs: 5000 });
+    const payload = result;
+    if (payload.exceptionDetails) {
+        const message = payload.exceptionDetails.exception?.description ?? payload.exceptionDetails.text ?? 'Unknown error';
+        throw new Error(message);
+    }
+    return payload.result?.value;
+};
+const buildExpression = (action, key, value, origin) => {
+    // IIFE to execute and return JSON-serializable result
+    return `(() => {
+		const currentOrigin = (() => {
+			try {
+				return new URL(location.href).origin
+			} catch {
+				throw new Error('Cannot determine origin: page is on a non-http URL (e.g., about:blank)')
+			}
+		})()
+
+		${origin ? `if (currentOrigin !== ${JSON.stringify(origin)}) { throw new Error('Origin mismatch: page is on ' + currentOrigin + ', requested ' + ${JSON.stringify(origin)}) }` : ''}
+
+		${buildActionCode(action, key, value)}
+	})()`;
+};
+const buildActionCode = (action, key, value) => {
+    switch (action) {
+        case 'get':
+            return `
+				const val = localStorage.getItem(${JSON.stringify(key)})
+				return { ok: true, origin: currentOrigin, key: ${JSON.stringify(key)}, exists: val !== null, value: val }
+			`;
+        case 'set':
+            return `
+				localStorage.setItem(${JSON.stringify(key)}, ${JSON.stringify(value)})
+				return { ok: true, origin: currentOrigin, key: ${JSON.stringify(key)} }
+			`;
+        case 'remove':
+            return `
+				localStorage.removeItem(${JSON.stringify(key)})
+				return { ok: true, origin: currentOrigin, key: ${JSON.stringify(key)} }
+			`;
+        case 'list':
+            return `
+				const keys = Object.keys(localStorage).sort()
+				return { ok: true, origin: currentOrigin, keys }
+			`;
+        case 'clear':
+            return `
+				const count = localStorage.length
+				localStorage.clear()
+				return { ok: true, origin: currentOrigin, cleared: count }
+			`;
+        default:
+            // Should never happen due to type safety, but include for robustness
+            return `throw new Error('Unknown action: ' + ${JSON.stringify(action)})`;
+    }
+};
+//# sourceMappingURL=storageLocal.js.map

package/dist/cdp/storageLocal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storageLocal.js","sourceRoot":"","sources":["../../src/cdp/storageLocal.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,KAAK,EAAE,OAAyB,EAAE,OAA4B,EAAiC,EAAE;IACnI,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAA;IAE9C,0CAA0C;IAC1C,MAAM,UAAU,GAAG,eAAe,CAAC,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,CAAC,CAAA;IAE9D,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,WAAW,CACvC,kBAAkB,EAClB;QACC,UAAU;QACV,YAAY,EAAE,KAAK;QACnB,aAAa,EAAE,IAAI;KACnB,EACD,EAAE,SAAS,EAAE,IAAI,EAAE,CACnB,CAAA;IAED,MAAM,OAAO,GAAG,MAGf,CAAA;IAED,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;QAC9B,MAAM,OAAO,GAAG,OAAO,CAAC,gBAAgB,CAAC,SAAS,EAAE,WAAW,IAAI,OAAO,CAAC,gBAAgB,CAAC,IAAI,IAAI,eAAe,CAAA;QACnH,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,CAAA;IACzB,CAAC;IAED,OAAO,OAAO,CAAC,MAAM,EAAE,KAA6B,CAAA;AACrD,CAAC,CAAA;AAED,MAAM,eAAe,GAAG,CACvB,MAAqC,EACrC,GAAuB,EACvB,KAAyB,EACzB,MAA0B,EACjB,EAAE;IACX,sDAAsD;IACtD,OAAO;;;;;;;;;IASJ,MAAM,CAAC,CAAC,CAAC,yBAAyB,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,yFAAyF,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE;;IAEjL,eAAe,CAAC,MAAM,EAAE,GAAG,EAAE,KAAK,CAAC;MACjC,CAAA;AACN,CAAC,CAAA;AAED,MAAM,eAAe,GAAG,CAAC,MAAqC,EAAE,GAAuB,EAAE,KAAyB,EAAU,EAAE;IAC7H,QAAQ,MAAM,EAAE,CAAC;QAChB,KAAK,KAAK;YACT,OAAO;uCAC6B,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC;qDACL,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC;IACpE,CAAA;QACF,KAAK,KAAK;YACT,OAAO;2BACiB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC;qDACnB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC;IACpE,CAAA;QACF,KAAK,QAAQ;YACZ,OAAO;8BACoB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC;qDACI,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC;IACpE,CAAA;QACF,KAAK,MAAM;YACV,OAAO;;;IAGN,CAAA;QACF,KAAK,OAAO;YACX,OAAO;;;;IAIN,CAAA;QACF;YACC,qEAAqE;YACrE,OAAO,wCAAwC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,CAAA;IAC1E,CAAC;AACF,CAAC,CAAA"}

package/dist/cdp/text-filter.d.ts

@@ -0,0 +1,6 @@
+import type { CdpSessionHandle } from './connection.js';
+/**
+ * Filter CDP node IDs by textContent, supporting exact match and /regex/flags.
+ */
+export declare const filterNodesByText: (session: CdpSessionHandle, nodeIds: number[], text: string) => Promise<number[]>;
+//# sourceMappingURL=text-filter.d.ts.map

package/dist/cdp/text-filter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-filter.d.ts","sourceRoot":"","sources":["../../src/cdp/text-filter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAEvD;;GAEG;AACH,eAAO,MAAM,iBAAiB,GAAU,SAAS,gBAAgB,EAAE,SAAS,MAAM,EAAE,EAAE,MAAM,MAAM,KAAG,OAAO,CAAC,MAAM,EAAE,CA6BpH,CAAA"}

package/dist/cdp/text-filter.js

@@ -0,0 +1,36 @@
+import { matchesTextPattern, parseTextPattern } from '@vforsh/argus-core';
+/**
+ * Filter CDP node IDs by textContent, supporting exact match and /regex/flags.
+ */
+export const filterNodesByText = async (session, nodeIds, text) => {
+    const pattern = parseTextPattern(text);
+    const filtered = [];
+    for (const nodeId of nodeIds) {
+        const resolved = (await session.sendAndWait('DOM.resolveNode', { nodeId }));
+        const objectId = resolved.object?.objectId;
+        if (!objectId) {
+            continue;
+        }
+        const evalResult = (await session.sendAndWait('Runtime.callFunctionOn', {
+            objectId,
+            functionDeclaration: 'function() { return this.textContent?.trim(); }',
+            returnByValue: true,
+        }));
+        const trimmedText = evalResult.result?.value;
+        if (typeof trimmedText !== 'string') {
+            continue;
+        }
+        if (pattern.type === 'exact') {
+            if (trimmedText === pattern.value) {
+                filtered.push(nodeId);
+            }
+        }
+        else {
+            if (matchesTextPattern(trimmedText, pattern)) {
+                filtered.push(nodeId);
+            }
+        }
+    }
+    return filtered;
+};
+//# sourceMappingURL=text-filter.js.map

package/dist/cdp/text-filter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-filter.js","sourceRoot":"","sources":["../../src/cdp/text-filter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAoB,MAAM,oBAAoB,CAAA;AAG3F;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,KAAK,EAAE,OAAyB,EAAE,OAAiB,EAAE,IAAY,EAAqB,EAAE;IACxH,MAAM,OAAO,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAA;IACtC,MAAM,QAAQ,GAAa,EAAE,CAAA;IAC7B,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC9B,MAAM,QAAQ,GAAG,CAAC,MAAM,OAAO,CAAC,WAAW,CAAC,iBAAiB,EAAE,EAAE,MAAM,EAAE,CAAC,CAAuC,CAAA;QACjH,MAAM,QAAQ,GAAG,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAA;QAC1C,IAAI,CAAC,QAAQ,EAAE,CAAC;YACf,SAAQ;QACT,CAAC;QACD,MAAM,UAAU,GAAG,CAAC,MAAM,OAAO,CAAC,WAAW,CAAC,wBAAwB,EAAE;YACvE,QAAQ;YACR,mBAAmB,EAAE,iDAAiD;YACtE,aAAa,EAAE,IAAI;SACnB,CAAC,CAAqC,CAAA;QACvC,MAAM,WAAW,GAAG,UAAU,CAAC,MAAM,EAAE,KAAK,CAAA;QAC5C,IAAI,OAAO,WAAW,KAAK,QAAQ,EAAE,CAAC;YACrC,SAAQ;QACT,CAAC;QACD,IAAI,OAAO,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YAC9B,IAAI,WAAW,KAAK,OAAO,CAAC,KAAK,EAAE,CAAC;gBACnC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;YACtB,CAAC;QACF,CAAC;aAAM,CAAC;YACP,IAAI,kBAAkB,CAAC,WAAW,EAAE,OAAO,CAAC,EAAE,CAAC;gBAC9C,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;YACtB,CAAC;QACF,CAAC;IACF,CAAC;IACD,OAAO,QAAQ,CAAA;AAChB,CAAC,CAAA"}

package/dist/cdp/throttle.d.ts

@@ -0,0 +1,6 @@
+import type { CdpSessionHandle } from './connection.js';
+/** Apply CPU throttle rate to a CDP session. */
+export declare const applyThrottle: (session: CdpSessionHandle, rate: number) => Promise<void>;
+/** Clear CPU throttle (reset to rate 1). */
+export declare const clearThrottle: (session: CdpSessionHandle) => Promise<void>;
+//# sourceMappingURL=throttle.d.ts.map

package/dist/cdp/throttle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"throttle.d.ts","sourceRoot":"","sources":["../../src/cdp/throttle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAEvD,gDAAgD;AAChD,eAAO,MAAM,aAAa,GAAU,SAAS,gBAAgB,EAAE,MAAM,MAAM,KAAG,OAAO,CAAC,IAAI,CAEzF,CAAA;AAED,4CAA4C;AAC5C,eAAO,MAAM,aAAa,GAAU,SAAS,gBAAgB,KAAG,OAAO,CAAC,IAAI,CAE3E,CAAA"}

package/dist/cdp/throttle.js

@@ -0,0 +1,9 @@
+/** Apply CPU throttle rate to a CDP session. */
+export const applyThrottle = async (session, rate) => {
+    await session.sendAndWait('Emulation.setCPUThrottlingRate', { rate });
+};
+/** Clear CPU throttle (reset to rate 1). */
+export const clearThrottle = async (session) => {
+    await session.sendAndWait('Emulation.setCPUThrottlingRate', { rate: 1 });
+};
+//# sourceMappingURL=throttle.js.map

package/dist/cdp/throttle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"throttle.js","sourceRoot":"","sources":["../../src/cdp/throttle.ts"],"names":[],"mappings":"AAEA,gDAAgD;AAChD,MAAM,CAAC,MAAM,aAAa,GAAG,KAAK,EAAE,OAAyB,EAAE,IAAY,EAAiB,EAAE;IAC7F,MAAM,OAAO,CAAC,WAAW,CAAC,gCAAgC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAA;AACtE,CAAC,CAAA;AAED,4CAA4C;AAC5C,MAAM,CAAC,MAAM,aAAa,GAAG,KAAK,EAAE,OAAyB,EAAiB,EAAE;IAC/E,MAAM,OAAO,CAAC,WAAW,CAAC,gCAAgC,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAA;AACzE,CAAC,CAAA"}

package/dist/cdp/tracing.d.ts

@@ -0,0 +1,15 @@
+import type { TraceStartRequest, TraceStartResponse, TraceStopResponse } from '@vforsh/argus-core';
+import type { CdpSessionHandle } from './connection.js';
+export type TraceRecorder = {
+    start: (options: TraceStartRequest) => Promise<TraceStartResponse>;
+    stop: (options: {
+        traceId?: string;
+        outFile?: string;
+    }) => Promise<TraceStopResponse>;
+    onDetached: (reason?: string) => void;
+};
+export declare const createTraceRecorder: (options: {
+    session: CdpSessionHandle;
+    artifactsDir: string;
+}) => TraceRecorder;
+//# sourceMappingURL=tracing.d.ts.map

package/dist/cdp/tracing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracing.d.ts","sourceRoot":"","sources":["../../src/cdp/tracing.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAClG,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAkBvD,MAAM,MAAM,aAAa,GAAG;IAC3B,KAAK,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,OAAO,CAAC,kBAAkB,CAAC,CAAA;IAClE,IAAI,EAAE,CAAC,OAAO,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,iBAAiB,CAAC,CAAA;IACrF,UAAU,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,KAAK,IAAI,CAAA;CACrC,CAAA;AAED,eAAO,MAAM,mBAAmB,GAAI,SAAS;IAAE,OAAO,EAAE,gBAAgB,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,KAAG,aA0KlG,CAAA"}

package/dist/cdp/tracing.js

@@ -0,0 +1,159 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import crypto from 'node:crypto';
+import { ensureArtifactsDir, ensureParentDir, resolveArtifactPath } from '../artifacts.js';
+export const createTraceRecorder = (options) => {
+    let active = null;
+    const createDeferred = () => {
+        let resolveCompletion;
+        let rejectCompletion;
+        const completion = new Promise((resolve, reject) => {
+            resolveCompletion = resolve;
+            rejectCompletion = reject;
+        });
+        return { completion, resolveCompletion, rejectCompletion };
+    };
+    const finalizeTraceFile = async (state) => {
+        if (state.stream.closed) {
+            return;
+        }
+        state.stream.write(']}');
+        await new Promise((resolve) => state.stream.end(resolve));
+    };
+    options.session.onEvent('Tracing.dataCollected', (params) => {
+        if (!active) {
+            return;
+        }
+        const payload = params;
+        if (!Array.isArray(payload.value) || payload.value.length === 0) {
+            return;
+        }
+        for (const event of payload.value) {
+            const json = JSON.stringify(event);
+            if (active.hasWritten) {
+                active.stream.write(`,${json}`);
+            }
+            else {
+                active.stream.write(json);
+                active.hasWritten = true;
+            }
+            active.eventCount += 1;
+        }
+    });
+    const resolveFinalPath = async (state, outFile) => {
+        if (!outFile?.trim()) {
+            return { absolutePath: state.absolutePath, displayPath: state.outFile };
+        }
+        const { absolutePath, displayPath } = resolveArtifactPath(options.artifactsDir, outFile, `traces/${state.sessionName}.json`);
+        if (absolutePath === state.absolutePath) {
+            return { absolutePath, displayPath };
+        }
+        await ensureParentDir(absolutePath);
+        try {
+            await fs.promises.rename(state.absolutePath, absolutePath);
+        }
+        catch (error) {
+            const nodeError = error;
+            if (nodeError.code !== 'EXDEV') {
+                throw error;
+            }
+            await fs.promises.copyFile(state.absolutePath, absolutePath);
+            await fs.promises.unlink(state.absolutePath);
+        }
+        state.absolutePath = absolutePath;
+        state.outFile = displayPath;
+        return { absolutePath, displayPath };
+    };
+    options.session.onEvent('Tracing.tracingComplete', () => {
+        if (!active) {
+            return;
+        }
+        void finalizeTraceFile(active)
+            .then(() => {
+            active?.resolveCompletion();
+        })
+            .catch((error) => {
+            active?.rejectCompletion(error instanceof Error ? error : new Error(String(error)));
+        })
+            .finally(() => {
+            active = null;
+        });
+    });
+    const start = async (request) => {
+        if (active) {
+            throw new Error('Tracing already active');
+        }
+        await ensureArtifactsDir(options.artifactsDir);
+        const traceId = crypto.randomUUID();
+        const sessionName = `trace-${new Date().toISOString().replace(/[:.]/g, '-')}`;
+        const defaultName = `traces/${sessionName}.json`;
+        const { absolutePath, displayPath } = resolveArtifactPath(options.artifactsDir, request.outFile, defaultName);
+        await ensureParentDir(absolutePath);
+        const stream = fs.createWriteStream(path.resolve(absolutePath), { encoding: 'utf8' });
+        stream.write('{"traceEvents":[', 'utf8');
+        const deferred = createDeferred();
+        active = {
+            traceId,
+            sessionName,
+            absolutePath: path.resolve(absolutePath),
+            outFile: displayPath,
+            stream,
+            hasWritten: false,
+            eventCount: 0,
+            startedAt: Date.now(),
+            state: 'recording',
+            completion: deferred.completion,
+            resolveCompletion: deferred.resolveCompletion,
+            rejectCompletion: deferred.rejectCompletion,
+        };
+        await options.session.sendAndWait('Tracing.start', {
+            categories: request.categories,
+            options: request.options,
+            transferMode: 'ReportEvents',
+        });
+        return { ok: true, traceId, sessionName, outFile: displayPath };
+    };
+    const stop = async ({ traceId, outFile }) => {
+        if (!active) {
+            throw new Error('No active trace to stop');
+        }
+        if (traceId && traceId !== active.traceId) {
+            throw new Error('Trace id does not match active trace');
+        }
+        const current = active;
+        if (current.state === 'stopping') {
+            await current.completion;
+            await resolveFinalPath(current, outFile);
+            return {
+                ok: true,
+                sessionName: current.sessionName,
+                outFile: current.outFile,
+                eventCount: current.eventCount,
+                durationMs: Math.max(0, Date.now() - current.startedAt),
+            };
+        }
+        current.state = 'stopping';
+        await options.session.sendAndWait('Tracing.end', {}, { timeoutMs: 15_000 });
+        await current.completion;
+        await resolveFinalPath(current, outFile);
+        return {
+            ok: true,
+            sessionName: current.sessionName,
+            outFile: current.outFile,
+            eventCount: current.eventCount,
+            durationMs: Math.max(0, Date.now() - current.startedAt),
+        };
+    };
+    const onDetached = (reason) => {
+        if (!active) {
+            return;
+        }
+        const error = new Error(reason ?? 'CDP detached while tracing');
+        active.rejectCompletion(error);
+        void finalizeTraceFile(active).finally(() => {
+            active = null;
+        });
+    };
+    return { start, stop, onDetached };
+};
+//# sourceMappingURL=tracing.js.map

package/dist/cdp/tracing.js.map

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

package/dist/cdp/watcher.d.ts

@@ -1,5 +1,6 @@
 import type { LogEvent, WatcherMatch, WatcherChrome } from '@vforsh/argus-core';
 import type { IgnoreMatcher } from './ignoreList.js';
+import type { CdpSessionController, CdpSessionHandle } from './connection.js';
 /** Minimal CDP target metadata needed for attachment. */
 export type CdpTarget = {
     /** CDP target id (from Chrome `/json` endpoint). */
@@ -10,6 +11,10 @@ export type CdpTarget = {
     url: string;
     /** WebSocket URL used to connect to the target via the Chrome DevTools Protocol. */
     webSocketDebuggerUrl: string;
+    /** Target type (e.g., 'page', 'iframe', 'worker', 'service_worker'). */
+    type: string;
+    /** Parent target ID for nested targets (e.g., iframes within pages). Null for top-level pages. */
+    parentId: string | null;
 };
 /** Current CDP attachment status. */
 export type CdpStatus = {
@@ -17,7 +22,11 @@ export type CdpStatus = {
     target: {
         title: string | null;
         url: string | null;
+        type: string | null;
+        parentId: string | null;
     } | null;
+    /** Best-effort reason for detachment. Null when attached. */
+    reason?: string | null;
 };
 type PageIntlInfo = {
     timezone: string | null;
@@ -33,13 +42,19 @@ export type CdpWatcherOptions = {
         url: string;
         title: string | null;
     }) => void;
+    onPageLoad?: () => void;
     onPageIntl?: (info: PageIntlInfo) => void;
+    onAttach?: (session: CdpSessionHandle, target: CdpTarget) => Promise<void> | void;
+    onDetach?: (reason: string) => void;
+    sessionHandle?: CdpSessionController;
     ignoreMatcher?: IgnoreMatcher | null;
     stripUrlPrefixes?: string[];
 };
-/** Start CDP polling + websocket subscriptions for console/exception events. */
-export declare const startCdpWatcher: (options: CdpWatcherOptions) => {
+export type CdpWatcherHandle = {
+    session: CdpSessionHandle;
     stop: () => Promise<void>;
 };
+/** Start CDP polling + websocket subscriptions for console/exception events. */
+export declare const startCdpWatcher: (options: CdpWatcherOptions) => CdpWatcherHandle;
 export {};
 //# sourceMappingURL=watcher.d.ts.map

package/dist/cdp/watcher.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"watcher.d.ts","sourceRoot":"","sources":["../../src/cdp/watcher.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAY,YAAY,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AACzF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAMpD,yDAAyD;AACzD,MAAM,MAAM,SAAS,GAAG;IACvB,oDAAoD;IACpD,EAAE,EAAE,MAAM,CAAA;IAEV,gDAAgD;IAChD,KAAK,EAAE,MAAM,CAAA;IAEb,+BAA+B;IAC/B,GAAG,EAAE,MAAM,CAAA;IAEX,oFAAoF;IACpF,oBAAoB,EAAE,MAAM,CAAA;CAC5B,CAAA;AAED,qCAAqC;AACrC,MAAM,MAAM,SAAS,GAAG;IACvB,QAAQ,EAAE,OAAO,CAAA;IACjB,MAAM,EAAE;QACP,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;QACpB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;KAClB,GAAG,IAAI,CAAA;CACR,CAAA;AAED,KAAK,YAAY,GAAG;IACnB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;CACrB,CAAA;AAED,yCAAyC;AACzC,MAAM,MAAM,iBAAiB,GAAG;IAC/B,MAAM,EAAE,aAAa,CAAA;IACrB,KAAK,CAAC,EAAE,YAAY,CAAA;IACpB,KAAK,EAAE,CAAC,KAAK,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,KAAK,IAAI,CAAA;IAC5C,QAAQ,EAAE,CAAC,MAAM,EAAE,SAAS,KAAK,IAAI,CAAA;IACrC,gBAAgB,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,KAAK,IAAI,CAAA;IACxE,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,YAAY,KAAK,IAAI,CAAA;IACzC,aAAa,CAAC,EAAE,aAAa,GAAG,IAAI,CAAA;IACpC,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAA;CAC3B,CAAA;AAED,gFAAgF;AAChF,eAAO,MAAM,eAAe,GAAI,SAAS,iBAAiB,KAAG;IAAE,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAgHvF,CAAA"}
+{"version":3,"file":"watcher.d.ts","sourceRoot":"","sources":["../../src/cdp/watcher.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAY,YAAY,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAEzF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAMpD,OAAO,KAAK,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAG7E,yDAAyD;AACzD,MAAM,MAAM,SAAS,GAAG;IACvB,oDAAoD;IACpD,EAAE,EAAE,MAAM,CAAA;IAEV,gDAAgD;IAChD,KAAK,EAAE,MAAM,CAAA;IAEb,+BAA+B;IAC/B,GAAG,EAAE,MAAM,CAAA;IAEX,oFAAoF;IACpF,oBAAoB,EAAE,MAAM,CAAA;IAE5B,wEAAwE;IACxE,IAAI,EAAE,MAAM,CAAA;IAEZ,kGAAkG;IAClG,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;CACvB,CAAA;AAED,qCAAqC;AACrC,MAAM,MAAM,SAAS,GAAG;IACvB,QAAQ,EAAE,OAAO,CAAA;IACjB,MAAM,EAAE;QACP,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;QACpB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;QAClB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;QACnB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;KACvB,GAAG,IAAI,CAAA;IACR,6DAA6D;IAC7D,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CACtB,CAAA;AAED,KAAK,YAAY,GAAG;IACnB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;CACrB,CAAA;AAED,yCAAyC;AACzC,MAAM,MAAM,iBAAiB,GAAG;IAC/B,MAAM,EAAE,aAAa,CAAA;IACrB,KAAK,CAAC,EAAE,YAAY,CAAA;IACpB,KAAK,EAAE,CAAC,KAAK,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,KAAK,IAAI,CAAA;IAC5C,QAAQ,EAAE,CAAC,MAAM,EAAE,SAAS,KAAK,IAAI,CAAA;IACrC,gBAAgB,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,KAAK,IAAI,CAAA;IACxE,UAAU,CAAC,EAAE,MAAM,IAAI,CAAA;IACvB,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,YAAY,KAAK,IAAI,CAAA;IACzC,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,gBAAgB,EAAE,MAAM,EAAE,SAAS,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;IACjF,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAA;IACnC,aAAa,CAAC,EAAE,oBAAoB,CAAA;IACpC,aAAa,CAAC,EAAE,aAAa,GAAG,IAAI,CAAA;IACpC,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAA;CAC3B,CAAA;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC9B,OAAO,EAAE,gBAAgB,CAAA;IACzB,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CACzB,CAAA;AAED,gFAAgF;AAChF,eAAO,MAAM,eAAe,GAAI,SAAS,iBAAiB,KAAG,gBAyH5D,CAAA"}