@vforsh/argus-core 0.1.2 → 0.1.3

package/dist/protocol/http/dom.d.ts

@@ -0,0 +1,392 @@
+/**
+ * A node in the DOM element tree.
+ * Only contains element nodes (nodeType === 1); text/comment nodes are filtered out.
+ */
+export type DomNode = {
+    /** CDP node ID. */
+    nodeId: number;
+    /** Lowercased tag name (e.g. "div", "span"). */
+    tag: string;
+    /** Attribute key-value pairs. */
+    attributes: Record<string, string>;
+    /** Child element nodes. Omitted or empty if no children or truncated. */
+    children?: DomNode[];
+    /** True if children were omitted due to depth/maxNodes limits. */
+    truncated?: boolean;
+};
+/**
+ * Detailed info about a single DOM element.
+ */
+export type DomElementInfo = {
+    /** CDP node ID. */
+    nodeId: number;
+    /** Lowercased tag name. */
+    tag: string;
+    /** Attribute key-value pairs. */
+    attributes: Record<string, string>;
+    /** Number of direct child element nodes. */
+    childElementCount: number;
+    /** Element's outerHTML (may be truncated or null on error). */
+    outerHTML: string | null;
+    /** True if outerHTML was truncated due to size limits. */
+    outerHTMLTruncated: boolean;
+};
+/**
+ * Request payload for POST /dom/tree.
+ */
+export type DomTreeRequest = {
+    /** CSS selector to match element(s). */
+    selector: string;
+    /** Max depth to traverse (0 = root only). Default: 2. */
+    depth?: number;
+    /** Max total nodes to return. Default: 5000. */
+    maxNodes?: number;
+    /** Allow multiple matches. If false and >1 match, error. Default: false. */
+    all?: boolean;
+    /** Filter elements by trimmed textContent. Plain string = exact match. /regex/flags = regex test. */
+    text?: string;
+};
+/**
+ * Response payload for POST /dom/tree.
+ */
+export type DomTreeResponse = {
+    ok: true;
+    /** Number of elements matched by selector. */
+    matches: number;
+    /** Subtree roots (one per match). Empty if no matches. */
+    roots: DomNode[];
+    /** True if output was truncated due to maxNodes or depth. */
+    truncated: boolean;
+    /** Reason for truncation if truncated is true. */
+    truncatedReason?: 'max_nodes' | 'depth';
+};
+/**
+ * Request payload for POST /dom/info.
+ */
+export type DomInfoRequest = {
+    /** CSS selector to match element(s). */
+    selector: string;
+    /** Allow multiple matches. If false and >1 match, error. Default: false. */
+    all?: boolean;
+    /** Max characters for outerHTML. Default: 50000. */
+    outerHtmlMaxChars?: number;
+    /** Filter elements by trimmed textContent. Plain string = exact match. /regex/flags = regex test. */
+    text?: string;
+};
+/**
+ * Response payload for POST /dom/info.
+ */
+export type DomInfoResponse = {
+    ok: true;
+    /** Number of elements matched by selector. */
+    matches: number;
+    /** Element info (one per match). Empty if no matches. */
+    elements: DomElementInfo[];
+};
+/**
+ * Request payload for POST /dom/hover.
+ */
+export type DomHoverRequest = {
+    /** CSS selector to match element(s). */
+    selector: string;
+    /** Allow multiple matches. If false and >1 match, error. Default: false. */
+    all?: boolean;
+    /** Filter elements by trimmed textContent. Plain string = exact match. /regex/flags = regex test. */
+    text?: string;
+};
+/**
+ * Response payload for POST /dom/hover.
+ */
+export type DomHoverResponse = {
+    ok: true;
+    /** Number of elements matched by selector. */
+    matches: number;
+    /** Number of elements hovered. */
+    hovered: number;
+};
+/**
+ * Request payload for POST /dom/click.
+ */
+/** Mouse button for click commands. Default: 'left'. */
+export type MouseButton = 'left' | 'middle' | 'right';
+export type DomClickRequest = {
+    /** CSS selector to match element(s). */
+    selector?: string;
+    /** Allow multiple matches. If false and >1 match, error. Default: false. */
+    all?: boolean;
+    /** Viewport x-coordinate, or x-offset from element top-left when selector is set. */
+    x?: number;
+    /** Viewport y-coordinate, or y-offset from element top-left when selector is set. */
+    y?: number;
+    /** Mouse button to click. Default: 'left'. */
+    button?: MouseButton;
+    /** Filter elements by trimmed textContent. Plain string = exact match. /regex/flags = regex test. */
+    text?: string;
+    /** Wait up to this many ms for selector to appear before executing. */
+    wait?: number;
+};
+/**
+ * Response payload for POST /dom/click.
+ */
+export type DomClickResponse = {
+    ok: true;
+    /** Number of elements matched by selector. */
+    matches: number;
+    /** Number of elements clicked. */
+    clicked: number;
+};
+/**
+ * Request payload for POST /dom/keydown.
+ */
+export type DomKeydownRequest = {
+    /** Key name (e.g. "Enter", "a", "ArrowUp"). */
+    key: string;
+    /** Optional CSS selector — focus element before dispatching. */
+    selector?: string;
+    /** Comma-separated modifier names: "shift,ctrl,alt,meta". */
+    modifiers?: string;
+};
+/**
+ * Response payload for POST /dom/keydown.
+ */
+export type DomKeydownResponse = {
+    ok: true;
+    /** The key that was dispatched. */
+    key: string;
+    /** Resolved modifier bitmask (Alt=1, Ctrl=2, Meta=4, Shift=8). */
+    modifiers: number;
+    /** Whether a selector was focused before dispatch. */
+    focused: boolean;
+};
+/** Valid positions for insertAdjacentHTML. */
+export type DomInsertPosition = 'beforebegin' | 'afterbegin' | 'beforeend' | 'afterend';
+/**
+ * Request payload for POST /dom/add.
+ */
+export type DomAddRequest = {
+    /** CSS selector to match target element(s). */
+    selector: string;
+    /** HTML string to insert. */
+    html: string;
+    /** Insert position relative to matched element. Default: 'beforeend'. */
+    position?: DomInsertPosition;
+    /** Allow multiple matches. If false and >1 match, error. Default: false. */
+    all?: boolean;
+    /** Zero-based index of the match to insert at (mutually exclusive with all). */
+    nth?: number;
+    /** Expected match count; request fails if mismatch (prevents accidental inserts). */
+    expect?: number;
+    /** Insert text content instead of HTML (uses insertAdjacentText). */
+    text?: boolean;
+};
+/**
+ * Response payload for POST /dom/add.
+ */
+export type DomAddResponse = {
+    ok: true;
+    /** Number of elements matched by selector. */
+    matches: number;
+    /** Number of elements where HTML was inserted. */
+    inserted: number;
+};
+/**
+ * Request payload for POST /dom/remove.
+ */
+export type DomRemoveRequest = {
+    /** CSS selector to match element(s) to remove. */
+    selector: string;
+    /** Allow multiple matches. If false and >1 match, error. Default: false. */
+    all?: boolean;
+    /** Filter elements by trimmed textContent. Plain string = exact match. /regex/flags = regex test. */
+    text?: string;
+};
+/**
+ * Response payload for POST /dom/remove.
+ */
+export type DomRemoveResponse = {
+    ok: true;
+    /** Number of elements matched by selector. */
+    matches: number;
+    /** Number of elements removed. */
+    removed: number;
+};
+/**
+ * Request payload for POST /dom/modify.
+ * Discriminated union based on 'type' field.
+ */
+export type DomModifyRequest = {
+    /** CSS selector to match element(s). */
+    selector: string;
+    /** Allow multiple matches. If false and >1 match, error. Default: false. */
+    all?: boolean;
+    /** Filter elements by trimmed textContent. Plain string = exact match. /regex/flags = regex test. */
+    text?: string;
+} & ({
+    type: 'attr';
+    set?: Record<string, string | true>;
+    remove?: string[];
+} | {
+    type: 'class';
+    add?: string[];
+    remove?: string[];
+    toggle?: string[];
+} | {
+    type: 'style';
+    set?: Record<string, string>;
+    remove?: string[];
+} | {
+    type: 'text';
+    value: string;
+} | {
+    type: 'html';
+    value: string;
+});
+/**
+ * Response payload for POST /dom/modify.
+ */
+export type DomModifyResponse = {
+    ok: true;
+    /** Number of elements matched by selector. */
+    matches: number;
+    /** Number of elements modified. */
+    modified: number;
+};
+/**
+ * Request payload for POST /dom/set-file.
+ */
+export type DomSetFileRequest = {
+    /** CSS selector to match file input element(s). */
+    selector: string;
+    /** Absolute file paths to set on the input. */
+    files: string[];
+    /** Allow multiple matches. If false and >1 match, error. Default: false. */
+    all?: boolean;
+    /** Filter elements by trimmed textContent. Plain string = exact match. /regex/flags = regex test. */
+    text?: string;
+    /** Wait up to this many ms for selector to appear before executing. */
+    wait?: number;
+};
+/**
+ * Response payload for POST /dom/set-file.
+ */
+export type DomSetFileResponse = {
+    ok: true;
+    /** Number of elements matched by selector. */
+    matches: number;
+    /** Number of file inputs updated. */
+    updated: number;
+};
+/**
+ * Request payload for POST /dom/scroll-to.
+ * At least one of selector, to, or by must be provided.
+ */
+export type DomScrollToRequest = {
+    /** CSS selector to match element(s). */
+    selector?: string;
+    /** Allow multiple matches. If false and >1 match, error. Default: false. */
+    all?: boolean;
+    /** Filter elements by trimmed textContent. Plain string = exact match. /regex/flags = regex test. */
+    text?: string;
+    /** Scroll to absolute position { x, y }. Applies to viewport or matched element. */
+    to?: {
+        x: number;
+        y: number;
+    };
+    /** Scroll by delta { x, y }. Applies to viewport or matched element. */
+    by?: {
+        x: number;
+        y: number;
+    };
+};
+/**
+ * Response payload for POST /dom/scroll-to.
+ */
+export type DomScrollToResponse = {
+    ok: true;
+    /** Number of elements matched by selector (only when selector is used). */
+    matches?: number;
+    /** Number of elements scrolled (only when selector is used). */
+    scrolled?: number;
+    /** Final horizontal scroll position. */
+    scrollX: number;
+    /** Final vertical scroll position. */
+    scrollY: number;
+};
+/**
+ * Request payload for POST /dom/scroll.
+ * Emulates touch scroll gestures via CDP Input.emulateTouchScrollGesture.
+ */
+export type DomScrollRequest = {
+    /** CSS selector to match element(s) — scroll origin is element center. */
+    selector?: string;
+    /** Allow multiple matches. If false and >1 match, error. Default: false. */
+    all?: boolean;
+    /** Filter elements by trimmed textContent. Plain string = exact match. /regex/flags = regex test. */
+    text?: string;
+    /** Viewport x-coordinate to scroll at (alternative to selector). */
+    x?: number;
+    /** Viewport y-coordinate to scroll at (alternative to selector). */
+    y?: number;
+    /** Scroll delta. Required. Positive y = scroll down. */
+    delta: {
+        x: number;
+        y: number;
+    };
+};
+/**
+ * Response payload for POST /dom/scroll.
+ */
+export type DomScrollResponse = {
+    ok: true;
+    /** Number of elements matched by selector (only when selector is used). */
+    matches?: number;
+    /** Number of elements scrolled (only when selector is used). */
+    scrolled?: number;
+};
+/**
+ * Request payload for POST /dom/fill.
+ */
+export type DomFillRequest = {
+    /** CSS selector to match input/textarea/contenteditable element(s). */
+    selector: string;
+    /** Value to fill into the element. */
+    value: string;
+    /** Allow multiple matches. If false and >1 match, error. Default: false. */
+    all?: boolean;
+    /** Filter elements by trimmed textContent. Plain string = exact match. /regex/flags = regex test. */
+    text?: string;
+    /** Wait up to this many ms for selector to appear before executing. */
+    wait?: number;
+};
+/**
+ * Response payload for POST /dom/fill.
+ */
+export type DomFillResponse = {
+    ok: true;
+    /** Number of elements matched by selector. */
+    matches: number;
+    /** Number of elements filled. */
+    filled: number;
+};
+/**
+ * Request payload for POST /dom/focus.
+ */
+export type DomFocusRequest = {
+    /** CSS selector to match element(s). */
+    selector: string;
+    /** Allow multiple matches. If false and >1 match, error. Default: false. */
+    all?: boolean;
+    /** Filter elements by trimmed textContent. Plain string = exact match. /regex/flags = regex test. */
+    text?: string;
+};
+/**
+ * Response payload for POST /dom/focus.
+ */
+export type DomFocusResponse = {
+    ok: true;
+    /** Number of elements matched by selector. */
+    matches: number;
+    /** Number of elements focused. */
+    focused: number;
+};
+//# sourceMappingURL=dom.d.ts.map

package/dist/protocol/http/dom.d.ts.map

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

package/dist/protocol/http/dom.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=dom.js.map

package/dist/protocol/http/dom.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dom.js","sourceRoot":"","sources":["../../../src/protocol/http/dom.ts"],"names":[],"mappings":""}

package/dist/protocol/http/emulation.d.ts

@@ -0,0 +1,92 @@
+/** Viewport emulation parameters for device metrics override. */
+export type EmulationViewport = {
+    /** Viewport width in CSS pixels. Must be a positive integer. */
+    width: number;
+    /** Viewport height in CSS pixels. Must be a positive integer. */
+    height: number;
+    /** Device scale factor (DPR). Must be a finite number greater than 0. */
+    deviceScaleFactor: number;
+    /** Whether to emulate a mobile device. */
+    mobile: boolean;
+};
+/**
+ * Desired emulation state sent to the watcher.
+ *
+ * Each field is independently optional:
+ * - `null` means "reset this aspect to default".
+ * - `undefined` / missing means "leave unchanged" (only meaningful for partial updates; on first set, missing = default).
+ */
+export type EmulationState = {
+    /** Viewport dimensions, DPR, and mobile flag. Null clears device metrics override. */
+    viewport?: EmulationViewport | null;
+    /** Touch emulation toggle. Null disables touch emulation. */
+    touch?: {
+        enabled: boolean;
+    } | null;
+    /**
+     * User-agent override.
+     * - `{ value: "<string>" }` sets the override.
+     * - `{ value: null }` restores the baseline (pre-emulation) user-agent.
+     * - `null` / missing leaves unchanged on partial update; on clear restores baseline.
+     */
+    userAgent?: {
+        value: string | null;
+    } | null;
+};
+/** POST /emulation request payload (action-based, like /storage/local). */
+export type EmulationRequest = {
+    action: 'set';
+    state: EmulationState;
+} | {
+    action: 'clear';
+};
+/** POST /emulation response for the `set` action. */
+export type EmulationSetResponse = {
+    ok: true;
+    /** Whether the watcher is currently attached to a CDP target. */
+    attached: boolean;
+    /** Whether the emulation state was applied to the current CDP session. False if queued (detached) or apply failed. */
+    applied: boolean;
+    /** The desired emulation state after the operation. */
+    state: EmulationState | null;
+    /** Optional error details when `applied` is false due to a CDP failure. */
+    error?: {
+        message: string;
+        code?: string;
+    } | null;
+};
+/** POST /emulation response for the `clear` action. */
+export type EmulationClearResponse = {
+    ok: true;
+    /** Whether the watcher is currently attached to a CDP target. */
+    attached: boolean;
+    /** Whether the clear was applied (metrics + touch + UA restored). */
+    applied: boolean;
+    /** Always null after clear. */
+    state: null;
+    /** Optional error details when `applied` is false due to a CDP failure. */
+    error?: {
+        message: string;
+        code?: string;
+    } | null;
+};
+/** GET /emulation response. */
+export type EmulationStatusResponse = {
+    ok: true;
+    /** Whether the watcher is currently attached to a CDP target. */
+    attached: boolean;
+    /** Whether the desired state is currently applied to the attached target. */
+    applied: boolean;
+    /** Current desired emulation state. Null when no emulation is active. */
+    state: EmulationState | null;
+    /** Best-effort baseline values captured on attach. `userAgent` is null when detached or not yet resolved. */
+    baseline: {
+        userAgent: string | null;
+    };
+    /** Last error from a failed apply attempt, if any. */
+    lastError?: {
+        message: string;
+        code?: string;
+    } | null;
+};
+//# sourceMappingURL=emulation.d.ts.map

package/dist/protocol/http/emulation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emulation.d.ts","sourceRoot":"","sources":["../../../src/protocol/http/emulation.ts"],"names":[],"mappings":"AAAA,iEAAiE;AACjE,MAAM,MAAM,iBAAiB,GAAG;IAC/B,gEAAgE;IAChE,KAAK,EAAE,MAAM,CAAA;IACb,iEAAiE;IACjE,MAAM,EAAE,MAAM,CAAA;IACd,yEAAyE;IACzE,iBAAiB,EAAE,MAAM,CAAA;IACzB,0CAA0C;IAC1C,MAAM,EAAE,OAAO,CAAA;CACf,CAAA;AAED;;;;;;GAMG;AACH,MAAM,MAAM,cAAc,GAAG;IAC5B,sFAAsF;IACtF,QAAQ,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAAA;IACnC,6DAA6D;IAC7D,KAAK,CAAC,EAAE;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAA;IACnC;;;;;OAKG;IACH,SAAS,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,GAAG,IAAI,CAAA;CAC3C,CAAA;AAED,2EAA2E;AAC3E,MAAM,MAAM,gBAAgB,GAAG;IAAE,MAAM,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,cAAc,CAAA;CAAE,GAAG;IAAE,MAAM,EAAE,OAAO,CAAA;CAAE,CAAA;AAE7F,qDAAqD;AACrD,MAAM,MAAM,oBAAoB,GAAG;IAClC,EAAE,EAAE,IAAI,CAAA;IACR,iEAAiE;IACjE,QAAQ,EAAE,OAAO,CAAA;IACjB,sHAAsH;IACtH,OAAO,EAAE,OAAO,CAAA;IAChB,uDAAuD;IACvD,KAAK,EAAE,cAAc,GAAG,IAAI,CAAA;IAC5B,2EAA2E;IAC3E,KAAK,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAA;CACjD,CAAA;AAED,uDAAuD;AACvD,MAAM,MAAM,sBAAsB,GAAG;IACpC,EAAE,EAAE,IAAI,CAAA;IACR,iEAAiE;IACjE,QAAQ,EAAE,OAAO,CAAA;IACjB,qEAAqE;IACrE,OAAO,EAAE,OAAO,CAAA;IAChB,+BAA+B;IAC/B,KAAK,EAAE,IAAI,CAAA;IACX,2EAA2E;IAC3E,KAAK,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAA;CACjD,CAAA;AAED,+BAA+B;AAC/B,MAAM,MAAM,uBAAuB,GAAG;IACrC,EAAE,EAAE,IAAI,CAAA;IACR,iEAAiE;IACjE,QAAQ,EAAE,OAAO,CAAA;IACjB,6EAA6E;IAC7E,OAAO,EAAE,OAAO,CAAA;IAChB,yEAAyE;IACzE,KAAK,EAAE,cAAc,GAAG,IAAI,CAAA;IAC5B,6GAA6G;IAC7G,QAAQ,EAAE;QAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAA;IACtC,sDAAsD;IACtD,SAAS,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAA;CACrD,CAAA"}

package/dist/protocol/http/emulation.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=emulation.js.map

package/dist/protocol/http/emulation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"emulation.js","sourceRoot":"","sources":["../../../src/protocol/http/emulation.ts"],"names":[],"mappings":""}

package/dist/protocol/http/errors.d.ts

@@ -0,0 +1,9 @@
+/** Standard error payload for API failures. */
+export type ErrorResponse = {
+    ok: false;
+    error: {
+        message: string;
+        code?: string;
+    };
+};
+//# sourceMappingURL=errors.d.ts.map

package/dist/protocol/http/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/protocol/http/errors.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C,MAAM,MAAM,aAAa,GAAG;IAC3B,EAAE,EAAE,KAAK,CAAA;IACT,KAAK,EAAE;QACN,OAAO,EAAE,MAAM,CAAA;QACf,IAAI,CAAC,EAAE,MAAM,CAAA;KACb,CAAA;CACD,CAAA"}

package/dist/protocol/http/errors.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=errors.js.map

package/dist/protocol/http/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/protocol/http/errors.ts"],"names":[],"mappings":""}

package/dist/protocol/http/eval.d.ts

@@ -0,0 +1,23 @@
+/** Request payload for POST /eval. */
+export type EvalRequest = {
+    expression: string;
+    awaitPromise?: boolean;
+    /**
+     * Enable Chrome's REPL evaluation mode.
+     * This allows native top-level `await` and console-like repeated declarations.
+     */
+    replMode?: boolean;
+    timeoutMs?: number;
+    returnByValue?: boolean;
+};
+/** Response payload for POST /eval. */
+export type EvalResponse = {
+    ok: true;
+    result: unknown;
+    type: string | null;
+    exception: {
+        text: string;
+        details?: unknown;
+    } | null;
+};
+//# sourceMappingURL=eval.d.ts.map

package/dist/protocol/http/eval.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"eval.d.ts","sourceRoot":"","sources":["../../../src/protocol/http/eval.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,MAAM,MAAM,WAAW,GAAG;IACzB,UAAU,EAAE,MAAM,CAAA;IAClB,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,aAAa,CAAC,EAAE,OAAO,CAAA;CACvB,CAAA;AAED,uCAAuC;AACvC,MAAM,MAAM,YAAY,GAAG;IAC1B,EAAE,EAAE,IAAI,CAAA;IACR,MAAM,EAAE,OAAO,CAAA;IACf,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACnB,SAAS,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAA;CACrD,CAAA"}

package/dist/protocol/http/eval.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=eval.js.map

package/dist/protocol/http/eval.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"eval.js","sourceRoot":"","sources":["../../../src/protocol/http/eval.ts"],"names":[],"mappings":""}

package/dist/protocol/http/logs.d.ts

@@ -0,0 +1,15 @@
+import type { LogEvent } from '../logs.js';
+/** Response payload for GET /logs. */
+export type LogsResponse = {
+    ok: true;
+    events: LogEvent[];
+    nextAfter: number;
+};
+/** Response payload for GET /tail. */
+export type TailResponse = {
+    ok: true;
+    events: LogEvent[];
+    nextAfter: number;
+    timedOut: boolean;
+};
+//# sourceMappingURL=logs.d.ts.map

package/dist/protocol/http/logs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logs.d.ts","sourceRoot":"","sources":["../../../src/protocol/http/logs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAE1C,sCAAsC;AACtC,MAAM,MAAM,YAAY,GAAG;IAC1B,EAAE,EAAE,IAAI,CAAA;IACR,MAAM,EAAE,QAAQ,EAAE,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;CACjB,CAAA;AAED,sCAAsC;AACtC,MAAM,MAAM,YAAY,GAAG;IAC1B,EAAE,EAAE,IAAI,CAAA;IACR,MAAM,EAAE,QAAQ,EAAE,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,OAAO,CAAA;CACjB,CAAA"}

package/dist/protocol/http/logs.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=logs.js.map

package/dist/protocol/http/logs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logs.js","sourceRoot":"","sources":["../../../src/protocol/http/logs.ts"],"names":[],"mappings":""}

package/dist/protocol/http/net.d.ts

@@ -0,0 +1,27 @@
+/** Network request summary captured from CDP. */
+export type NetworkRequestSummary = {
+    id: number;
+    ts: number;
+    requestId: string;
+    url: string;
+    method: string;
+    resourceType: string | null;
+    status: number | null;
+    encodedDataLength: number | null;
+    errorText: string | null;
+    durationMs: number | null;
+};
+/** Response payload for GET /net. */
+export type NetResponse = {
+    ok: true;
+    requests: NetworkRequestSummary[];
+    nextAfter: number;
+};
+/** Response payload for GET /net/tail. */
+export type NetTailResponse = {
+    ok: true;
+    requests: NetworkRequestSummary[];
+    nextAfter: number;
+    timedOut: boolean;
+};
+//# sourceMappingURL=net.d.ts.map

package/dist/protocol/http/net.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"net.d.ts","sourceRoot":"","sources":["../../../src/protocol/http/net.ts"],"names":[],"mappings":"AAAA,iDAAiD;AACjD,MAAM,MAAM,qBAAqB,GAAG;IACnC,EAAE,EAAE,MAAM,CAAA;IACV,EAAE,EAAE,MAAM,CAAA;IACV,SAAS,EAAE,MAAM,CAAA;IACjB,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,EAAE,MAAM,CAAA;IACd,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAA;IAChC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;CAEzB,CAAA;AAED,qCAAqC;AACrC,MAAM,MAAM,WAAW,GAAG;IACzB,EAAE,EAAE,IAAI,CAAA;IACR,QAAQ,EAAE,qBAAqB,EAAE,CAAA;IACjC,SAAS,EAAE,MAAM,CAAA;CACjB,CAAA;AAED,0CAA0C;AAC1C,MAAM,MAAM,eAAe,GAAG;IAC7B,EAAE,EAAE,IAAI,CAAA;IACR,QAAQ,EAAE,qBAAqB,EAAE,CAAA;IACjC,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,OAAO,CAAA;CACjB,CAAA"}

package/dist/protocol/http/net.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=net.js.map

package/dist/protocol/http/net.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"net.js","sourceRoot":"","sources":["../../../src/protocol/http/net.ts"],"names":[],"mappings":""}

package/dist/protocol/http/screenshot.d.ts

@@ -0,0 +1,13 @@
+/** Request payload for POST /screenshot. */
+export type ScreenshotRequest = {
+    outFile?: string;
+    selector?: string;
+    format?: 'png';
+};
+/** Response payload for POST /screenshot. */
+export type ScreenshotResponse = {
+    ok: true;
+    outFile: string;
+    clipped: boolean;
+};
+//# sourceMappingURL=screenshot.d.ts.map

package/dist/protocol/http/screenshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"screenshot.d.ts","sourceRoot":"","sources":["../../../src/protocol/http/screenshot.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAC5C,MAAM,MAAM,iBAAiB,GAAG;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,MAAM,CAAC,EAAE,KAAK,CAAA;CACd,CAAA;AAED,6CAA6C;AAC7C,MAAM,MAAM,kBAAkB,GAAG;IAChC,EAAE,EAAE,IAAI,CAAA;IACR,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,OAAO,CAAA;CAChB,CAAA"}

package/dist/protocol/http/screenshot.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=screenshot.js.map