@vforsh/argus-watcher 0.1.2 → 0.1.4

package/dist/buffer/LogBuffer.js.map

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

package/dist/buffer/NetBuffer.d.ts

@@ -0,0 +1,29 @@
+import type { NetworkRequestSummary } from '@vforsh/argus-core';
+export type NetFilters = {
+    grep?: string;
+    sinceTs?: number;
+};
+/** In-memory ring buffer for network request summaries with long-poll waiters. */
+export declare class NetBuffer {
+    private readonly maxSize;
+    private events;
+    private nextId;
+    private waiters;
+    constructor(maxSize: number);
+    /** Add a network summary and return the stored entry with id. */
+    add(event: Omit<NetworkRequestSummary, 'id'>): NetworkRequestSummary;
+    /** List events after the given id, respecting filters and limit. */
+    listAfter(after: number, filters: NetFilters, limit: number): NetworkRequestSummary[];
+    /** Wait for events after an id or timeout. */
+    waitForAfter(after: number, filters: NetFilters, limit: number, timeoutMs: number): Promise<NetworkRequestSummary[]>;
+    /** Get buffer size and id boundaries. */
+    getStats(): {
+        size: number;
+        count: number;
+        minId: number | null;
+        maxId: number | null;
+    };
+    private trim;
+    private flushWaiters;
+}
+//# sourceMappingURL=NetBuffer.d.ts.map

package/dist/buffer/NetBuffer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NetBuffer.d.ts","sourceRoot":"","sources":["../../src/buffer/NetBuffer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAA;AAE/D,MAAM,MAAM,UAAU,GAAG;IACxB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,MAAM,CAAA;CAChB,CAAA;AAUD,kFAAkF;AAClF,qBAAa,SAAS;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAQ;IAChC,OAAO,CAAC,MAAM,CAA8B;IAC5C,OAAO,CAAC,MAAM,CAAI;IAClB,OAAO,CAAC,OAAO,CAAe;gBAElB,OAAO,EAAE,MAAM;IAI3B,iEAAiE;IACjE,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,qBAAqB,EAAE,IAAI,CAAC,GAAG,qBAAqB;IAQpE,oEAAoE;IACpE,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,GAAG,qBAAqB,EAAE;IAKrF,8CAA8C;IAC9C,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,EAAE,CAAC;IAgBpH,yCAAyC;IACzC,QAAQ,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE;IAavF,OAAO,CAAC,IAAI;IAOZ,OAAO,CAAC,YAAY;CAiBpB"}

package/dist/buffer/NetBuffer.js

@@ -0,0 +1,85 @@
+/** In-memory ring buffer for network request summaries with long-poll waiters. */
+export class NetBuffer {
+    maxSize;
+    events = [];
+    nextId = 1;
+    waiters = [];
+    constructor(maxSize) {
+        this.maxSize = maxSize;
+    }
+    /** Add a network summary and return the stored entry with id. */
+    add(event) {
+        const entry = { ...event, id: this.nextId++ };
+        this.events.push(entry);
+        this.trim();
+        this.flushWaiters();
+        return entry;
+    }
+    /** List events after the given id, respecting filters and limit. */
+    listAfter(after, filters, limit) {
+        const filtered = this.events.filter((event) => event.id > after && matchesFilters(event, filters));
+        return filtered.slice(0, limit);
+    }
+    /** Wait for events after an id or timeout. */
+    waitForAfter(after, filters, limit, timeoutMs) {
+        const immediate = this.listAfter(after, filters, limit);
+        if (immediate.length > 0) {
+            return Promise.resolve(immediate);
+        }
+        return new Promise((resolve) => {
+            const timer = setTimeout(() => {
+                this.waiters = this.waiters.filter((waiter) => waiter.timer !== timer);
+                resolve([]);
+            }, timeoutMs);
+            this.waiters.push({ after, filters, limit, resolve, timer });
+        });
+    }
+    /** Get buffer size and id boundaries. */
+    getStats() {
+        if (this.events.length === 0) {
+            return { size: this.maxSize, count: 0, minId: null, maxId: null };
+        }
+        return {
+            size: this.maxSize,
+            count: this.events.length,
+            minId: this.events[0]?.id ?? null,
+            maxId: this.events[this.events.length - 1]?.id ?? null,
+        };
+    }
+    trim() {
+        if (this.events.length <= this.maxSize) {
+            return;
+        }
+        this.events = this.events.slice(this.events.length - this.maxSize);
+    }
+    flushWaiters() {
+        if (this.waiters.length === 0) {
+            return;
+        }
+        const remaining = [];
+        for (const waiter of this.waiters) {
+            const events = this.listAfter(waiter.after, waiter.filters, waiter.limit);
+            if (events.length > 0) {
+                clearTimeout(waiter.timer);
+                waiter.resolve(events);
+                continue;
+            }
+            remaining.push(waiter);
+        }
+        this.waiters = remaining;
+    }
+}
+const matchesFilters = (event, filters) => {
+    if (filters.sinceTs && event.ts < filters.sinceTs) {
+        return false;
+    }
+    if (filters.grep) {
+        const haystack = event.url.toLowerCase();
+        const needle = filters.grep.toLowerCase();
+        if (!haystack.includes(needle)) {
+            return false;
+        }
+    }
+    return true;
+};
+//# sourceMappingURL=NetBuffer.js.map

package/dist/buffer/NetBuffer.js.map

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

package/dist/cdp/accessibility.d.ts

@@ -0,0 +1,18 @@
+import type { SnapshotResponse } from '@vforsh/argus-core';
+import type { CdpSessionHandle } from './connection.js';
+export type FetchSnapshotOptions = {
+    selector?: string;
+    depth?: number;
+    interactive?: boolean;
+};
+/**
+ * Fetch an accessibility tree snapshot.
+ *
+ * 1. Enable Accessibility domain
+ * 2. Optionally resolve a CSS selector to scope the tree
+ * 3. Fetch the AX tree via CDP
+ * 4. Reconstruct flat array into nested tree
+ * 5. Apply filters (skip ignored, flatten generic, interactive-only, depth)
+ */
+export declare const fetchAccessibilitySnapshot: (session: CdpSessionHandle, options: FetchSnapshotOptions) => Promise<SnapshotResponse>;
+//# sourceMappingURL=accessibility.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"accessibility.d.ts","sourceRoot":"","sources":["../../src/cdp/accessibility.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAc,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AACtE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAoCvD,MAAM,MAAM,oBAAoB,GAAG;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,OAAO,CAAA;CACrB,CAAA;AA6ED;;;;;;;;GAQG;AACH,eAAO,MAAM,0BAA0B,GAAU,SAAS,gBAAgB,EAAE,SAAS,oBAAoB,KAAG,OAAO,CAAC,gBAAgB,CAmEnI,CAAA"}

package/dist/cdp/accessibility.js

@@ -0,0 +1,300 @@
+// ─────────────────────────────────────────────────────────────────────────────
+// Constants
+// ─────────────────────────────────────────────────────────────────────────────
+const INTERACTIVE_ROLES = new Set([
+    'button',
+    'checkbox',
+    'combobox',
+    'link',
+    'listbox',
+    'menuitem',
+    'menuitemcheckbox',
+    'menuitemradio',
+    'option',
+    'radio',
+    'searchbox',
+    'slider',
+    'spinbutton',
+    'switch',
+    'tab',
+    'textbox',
+    'treeitem',
+]);
+/** Structural containers with no semantic meaning — flatten them away. */
+const GENERIC_ROLES = new Set(['generic', 'none', 'presentation']);
+/** Landmark and structural roles preserved as context in interactive mode. */
+const LANDMARK_ROLES = new Set([
+    'banner',
+    'complementary',
+    'contentinfo',
+    'form',
+    'main',
+    'navigation',
+    'region',
+    'search',
+    'dialog',
+    'alertdialog',
+    'heading',
+    'group',
+    'list',
+    'toolbar',
+    'menu',
+    'menubar',
+    'tablist',
+    'tree',
+    'treegrid',
+    'grid',
+    'table',
+]);
+/** Properties worth surfacing in the output. */
+const RELEVANT_PROPERTIES = new Set([
+    'checked',
+    'disabled',
+    'expanded',
+    'focused',
+    'level',
+    'required',
+    'selected',
+    'readonly',
+    'pressed',
+    'valuemin',
+    'valuemax',
+    'valuetext',
+    'autocomplete',
+    'multiselectable',
+    'orientation',
+]);
+// ─────────────────────────────────────────────────────────────────────────────
+// Public API
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Fetch an accessibility tree snapshot.
+ *
+ * 1. Enable Accessibility domain
+ * 2. Optionally resolve a CSS selector to scope the tree
+ * 3. Fetch the AX tree via CDP
+ * 4. Reconstruct flat array into nested tree
+ * 5. Apply filters (skip ignored, flatten generic, interactive-only, depth)
+ */
+export const fetchAccessibilitySnapshot = async (session, options) => {
+    await session.sendAndWait('Accessibility.enable');
+    // Always fetch the full tree — getPartialAXTree with fetchRelatives:false
+    // returns only a single node without descendants, which is not useful.
+    const axResult = (await session.sendAndWait('Accessibility.getFullAXTree'));
+    let nodes = axResult.nodes ?? [];
+    // If a CSS selector is provided, scope to that DOM subtree.
+    // Since the AX tree structure doesn't always mirror DOM containment
+    // (e.g. forms without aria-label are invisible, their children parent up),
+    // we collect all backendDOMNodeIds within the DOM subtree and filter AX nodes by those.
+    if (options.selector) {
+        // Use Runtime.evaluate to get all backendNodeIds in the subtree efficiently
+        const resolveResult = (await session.sendAndWait('Runtime.evaluate', {
+            expression: `document.querySelector(${JSON.stringify(options.selector)})`,
+            returnByValue: false,
+        }));
+        if (!resolveResult.result?.objectId || resolveResult.result.subtype === 'null') {
+            throw new Error(`No element found for selector: ${options.selector}`);
+        }
+        // Enable DOM and load the document tree so requestNode/querySelectorAll work.
+        await session.sendAndWait('DOM.enable');
+        await session.sendAndWait('DOM.getDocument', { depth: -1 });
+        const domNode = (await session.sendAndWait('DOM.requestNode', {
+            objectId: resolveResult.result.objectId,
+        }));
+        if (!domNode.nodeId) {
+            throw new Error('Unable to resolve DOM node');
+        }
+        const allDescendants = (await session.sendAndWait('DOM.querySelectorAll', {
+            nodeId: domNode.nodeId,
+            selector: '*',
+        }));
+        const descendantNodeIds = allDescendants.nodeIds ?? [];
+        // Collect backendNodeIds for root + all descendants
+        const backendIds = new Set();
+        const allDomNodeIds = [domNode.nodeId, ...descendantNodeIds];
+        for (const nid of allDomNodeIds) {
+            const desc = (await session.sendAndWait('DOM.describeNode', { nodeId: nid, depth: 0 }));
+            if (desc.node?.backendNodeId != null) {
+                backendIds.add(desc.node.backendNodeId);
+            }
+        }
+        // Filter AX nodes: keep those with matching backendDOMNodeId
+        // Plus all their AX descendants (for text nodes etc. that don't have backendDOMNodeId)
+        nodes = filterByDomSubtree(nodes, backendIds);
+    }
+    const totalNodes = nodes.length;
+    const roots = buildTree(nodes, {
+        depth: options.depth,
+        interactive: options.interactive ?? false,
+    });
+    const returnedNodes = countNodes(roots);
+    return { ok: true, roots, totalNodes, returnedNodes };
+};
+/**
+ * Reconstruct the flat CDP AXNode array into a nested AXTreeNode tree.
+ *
+ * 1. Index all nodes by nodeId into a Map.
+ * 2. Find root nodes (parentId absent or not in map).
+ * 3. Recursively build tree with filtering.
+ */
+const buildTree = (cdpNodes, options) => {
+    const nodeMap = new Map();
+    for (const node of cdpNodes) {
+        nodeMap.set(node.nodeId, node);
+    }
+    const rootIds = [];
+    for (const node of cdpNodes) {
+        if (!node.parentId || !nodeMap.has(node.parentId)) {
+            rootIds.push(node.nodeId);
+        }
+    }
+    const results = [];
+    for (const rootId of rootIds) {
+        results.push(...convertNode(nodeMap, rootId, 0, options));
+    }
+    return results;
+};
+/**
+ * Convert a single CdpAXNode to AXTreeNode(s).
+ * Returns an array because ignored/generic nodes get flattened (children become siblings).
+ */
+const convertNode = (nodeMap, nodeId, currentDepth, options) => {
+    const cdpNode = nodeMap.get(nodeId);
+    if (!cdpNode) {
+        return [];
+    }
+    const role = extractStringValue(cdpNode.role) ?? 'unknown';
+    const name = extractStringValue(cdpNode.name) ?? '';
+    // Recurse into children first (needed for interactive filtering)
+    const childIds = cdpNode.childIds ?? [];
+    const depthExceeded = options.depth != null && currentDepth >= options.depth;
+    const childResults = [];
+    if (!depthExceeded) {
+        for (const childId of childIds) {
+            childResults.push(...convertNode(nodeMap, childId, currentDepth + 1, options));
+        }
+    }
+    // Skip ignored nodes — pass through children
+    if (cdpNode.ignored) {
+        return childResults;
+    }
+    // Flatten generic container nodes with no name — pass through children
+    if (GENERIC_ROLES.has(role) && !name) {
+        return childResults;
+    }
+    // Skip InlineTextBox nodes — Chrome rendering detail, always repeat parent StaticText
+    if (role === 'InlineTextBox') {
+        return [];
+    }
+    // Build the output node
+    const result = { role, name };
+    const value = extractStringValue(cdpNode.value);
+    if (value != null && value !== '') {
+        result.value = value;
+    }
+    const properties = extractProperties(cdpNode.properties);
+    if (properties && Object.keys(properties).length > 0) {
+        result.properties = properties;
+    }
+    if (childResults.length > 0) {
+        result.children = childResults;
+    }
+    // Interactive-only filter: keep node if it is interactive or has interactive descendants
+    if (options.interactive) {
+        const isInteractive = INTERACTIVE_ROLES.has(role);
+        const hasInteractiveDescendant = childResults.length > 0;
+        if (!isInteractive && !hasInteractiveDescendant) {
+            return [];
+        }
+        // Non-interactive node with interactive descendants — keep as context only if meaningful
+        if (!isInteractive && !name && !LANDMARK_ROLES.has(role)) {
+            return childResults;
+        }
+    }
+    return [result];
+};
+// ─────────────────────────────────────────────────────────────────────────────
+// Helpers
+// ─────────────────────────────────────────────────────────────────────────────
+const extractStringValue = (axValue) => {
+    if (!axValue || axValue.value == null) {
+        return undefined;
+    }
+    return String(axValue.value);
+};
+const extractProperties = (properties) => {
+    if (!properties || properties.length === 0) {
+        return undefined;
+    }
+    const result = {};
+    for (const prop of properties) {
+        if (!RELEVANT_PROPERTIES.has(prop.name)) {
+            continue;
+        }
+        const val = prop.value?.value;
+        if (val == null) {
+            continue;
+        }
+        if (typeof val === 'boolean' || typeof val === 'number' || typeof val === 'string') {
+            // Skip false/default values to reduce noise
+            if (typeof val === 'boolean' && !val) {
+                continue;
+            }
+            result[prop.name] = val;
+        }
+    }
+    return Object.keys(result).length > 0 ? result : undefined;
+};
+/**
+ * Filter AX nodes to those whose backendDOMNodeId is in the given set,
+ * plus their AX children (which may not have backendDOMNodeId, e.g. StaticText).
+ * Rewires parentId so the topmost matching nodes become roots.
+ */
+const filterByDomSubtree = (allNodes, backendIds) => {
+    const nodeMap = new Map();
+    for (const node of allNodes) {
+        nodeMap.set(node.nodeId, node);
+    }
+    // Start with AX nodes that directly match a DOM backendNodeId
+    const matchedAxIds = new Set();
+    for (const node of allNodes) {
+        if (node.backendDOMNodeId != null && backendIds.has(node.backendDOMNodeId)) {
+            matchedAxIds.add(node.nodeId);
+        }
+    }
+    // BFS: also include all AX descendants of matched nodes
+    const finalIds = new Set(matchedAxIds);
+    const queue = [...matchedAxIds];
+    while (queue.length > 0) {
+        const id = queue.shift();
+        const node = nodeMap.get(id);
+        if (node?.childIds) {
+            for (const childId of node.childIds) {
+                if (!finalIds.has(childId)) {
+                    finalIds.add(childId);
+                    queue.push(childId);
+                }
+            }
+        }
+    }
+    // Filter and rewire: nodes whose parent is not in the set become roots
+    return allNodes
+        .filter((n) => finalIds.has(n.nodeId))
+        .map((n) => {
+        if (n.parentId && !finalIds.has(n.parentId)) {
+            return { ...n, parentId: undefined };
+        }
+        return n;
+    });
+};
+const countNodes = (nodes) => {
+    let count = 0;
+    for (const node of nodes) {
+        count++;
+        if (node.children) {
+            count += countNodes(node.children);
+        }
+    }
+    return count;
+};
+//# sourceMappingURL=accessibility.js.map

package/dist/cdp/accessibility.js.map

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

package/dist/cdp/connection.d.ts

@@ -0,0 +1,39 @@
+export type CdpEventMeta = {
+    sessionId?: string | null;
+};
+export type CdpEventHandler = (params: unknown, meta: CdpEventMeta) => void;
+export type CdpSendOptions = {
+    /** Optional timeout for this CDP command (ms). */
+    timeoutMs?: number;
+    /** Optional child protocol session within the current root target. */
+    sessionId?: string;
+};
+export type CdpTargetContext = {
+    kind: 'page';
+} | {
+    kind: 'frame';
+    frameId: string;
+    executionContextId: number | null;
+    sessionId?: string | null;
+};
+export type CdpSessionHandle = {
+    isAttached: () => boolean;
+    sendAndWait: (method: string, params?: Record<string, unknown>, options?: CdpSendOptions) => Promise<unknown>;
+    onEvent: (method: string, handler: CdpEventHandler) => () => void;
+    /** Active target context for commands that need frame-aware behavior. */
+    getTargetContext?: () => CdpTargetContext;
+};
+type CdpConnection = {
+    sendAndWait: (method: string, params?: Record<string, unknown>, options?: CdpSendOptions) => Promise<unknown>;
+    handleMessage: (data: unknown) => void;
+    close: (reason?: string) => void;
+};
+export type CdpSessionController = {
+    session: CdpSessionHandle;
+    attach: (socket: WebSocket) => CdpConnection;
+    detach: (reason?: string) => void;
+};
+export declare const createCdpSessionHandle: () => CdpSessionController;
+export declare const createCdpNotAttachedError: () => Error;
+export {};
+//# sourceMappingURL=connection.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../../src/cdp/connection.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GAAG;IAC1B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CACzB,CAAA;AAED,MAAM,MAAM,eAAe,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY,KAAK,IAAI,CAAA;AAE3E,MAAM,MAAM,cAAc,GAAG;IAC5B,kDAAkD;IAClD,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,sEAAsE;IACtE,SAAS,CAAC,EAAE,MAAM,CAAA;CAClB,CAAA;AAED,MAAM,MAAM,gBAAgB,GACzB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IACA,IAAI,EAAE,OAAO,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IACf,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAA;IACjC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CACxB,CAAA;AAEJ,MAAM,MAAM,gBAAgB,GAAG;IAC9B,UAAU,EAAE,MAAM,OAAO,CAAA;IACzB,WAAW,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,EAAE,cAAc,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;IAC7G,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,KAAK,MAAM,IAAI,CAAA;IACjE,yEAAyE;IACzE,gBAAgB,CAAC,EAAE,MAAM,gBAAgB,CAAA;CACzC,CAAA;AAQD,KAAK,aAAa,GAAG;IACpB,WAAW,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,EAAE,cAAc,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;IAC7G,aAAa,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAA;IACtC,KAAK,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,KAAK,IAAI,CAAA;CAChC,CAAA;AAID,MAAM,MAAM,oBAAoB,GAAG;IAClC,OAAO,EAAE,gBAAgB,CAAA;IACzB,MAAM,EAAE,CAAC,MAAM,EAAE,SAAS,KAAK,aAAa,CAAA;IAC5C,MAAM,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,KAAK,IAAI,CAAA;CACjC,CAAA;AAED,eAAO,MAAM,sBAAsB,QAAO,oBA6HzC,CAAA;AAED,eAAO,MAAM,yBAAyB,QAAO,KAI5C,CAAA"}

package/dist/cdp/connection.js

@@ -0,0 +1,131 @@
+let nextId = 1;
+export const createCdpSessionHandle = () => {
+    let connection = null;
+    const handlers = new Map();
+    const session = {
+        isAttached: () => Boolean(connection),
+        sendAndWait: async (method, params, options) => {
+            if (!connection) {
+                throw createCdpNotAttachedError();
+            }
+            return connection.sendAndWait(method, params, options);
+        },
+        onEvent: (method, handler) => {
+            let bucket = handlers.get(method);
+            if (!bucket) {
+                bucket = new Set();
+                handlers.set(method, bucket);
+            }
+            bucket.add(handler);
+            return () => {
+                bucket?.delete(handler);
+            };
+        },
+    };
+    const attach = (socket) => {
+        const pendingRequests = new Map();
+        const sendAndWait = async (method, params, options) => {
+            const id = nextId++;
+            return new Promise((resolve, reject) => {
+                const pending = { resolve, reject };
+                if (options?.timeoutMs) {
+                    pending.timer = setTimeout(() => {
+                        pendingRequests.delete(id);
+                        reject(new Error(`CDP request timed out after ${options.timeoutMs}ms`));
+                    }, options.timeoutMs);
+                }
+                pendingRequests.set(id, pending);
+                try {
+                    socket.send(JSON.stringify({ id, method, params }));
+                }
+                catch (error) {
+                    pendingRequests.delete(id);
+                    if (pending.timer) {
+                        clearTimeout(pending.timer);
+                    }
+                    reject(error instanceof Error ? error : new Error(String(error)));
+                }
+            });
+        };
+        const handleMessage = (data) => {
+            const message = parseMessage(data);
+            if (!message || typeof message !== 'object') {
+                return;
+            }
+            const payload = message;
+            if (payload.id != null) {
+                const pending = pendingRequests.get(payload.id);
+                if (!pending) {
+                    return;
+                }
+                pendingRequests.delete(payload.id);
+                if (pending.timer) {
+                    clearTimeout(pending.timer);
+                }
+                if (payload.error) {
+                    pending.reject(new Error(payload.error.message ?? 'CDP request failed'));
+                    return;
+                }
+                pending.resolve(payload.result);
+                return;
+            }
+            if (payload.method) {
+                const bucket = handlers.get(payload.method);
+                if (!bucket || bucket.size === 0) {
+                    return;
+                }
+                for (const handler of bucket) {
+                    try {
+                        handler(payload.params, { sessionId: null });
+                    }
+                    catch {
+                        // Ignore handler errors to keep dispatch resilient.
+                    }
+                }
+            }
+        };
+        const close = (reason) => {
+            for (const pending of pendingRequests.values()) {
+                pending.reject(new Error(reason ?? 'CDP connection closed'));
+                if (pending.timer) {
+                    clearTimeout(pending.timer);
+                }
+            }
+            pendingRequests.clear();
+        };
+        const nextConnection = {
+            sendAndWait,
+            handleMessage,
+            close,
+        };
+        connection = nextConnection;
+        return nextConnection;
+    };
+    const detach = (reason) => {
+        if (connection) {
+            connection.close(reason);
+        }
+        connection = null;
+    };
+    return { session, attach, detach };
+};
+export const createCdpNotAttachedError = () => {
+    const error = new Error('Watcher not attached to a CDP target');
+    error.code = 'cdp_not_attached';
+    return error;
+};
+const parseMessage = (data) => {
+    if (typeof data === 'string') {
+        try {
+            return JSON.parse(data);
+        }
+        catch {
+            return null;
+        }
+    }
+    if (data instanceof ArrayBuffer) {
+        return parseMessage(new TextDecoder().decode(data));
+    }
+    return null;
+};
+//# sourceMappingURL=connection.js.map