@vforsh/argus-watcher 0.1.2 → 0.1.3

package/dist/cdp/pageIndicator.js

@@ -0,0 +1,395 @@
+const BOT_SVG = `<svg xmlns="http://www.w3.org/2000/svg" width="19" height="19" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M12 8V4H8"/><rect width="16" height="12" x="4" y="8" rx="2"/><path d="M2 14h2"/><path d="M20 14h2"/><path d="M15 13v2"/><path d="M9 13v2"/></svg>`;
+const MIN_HEARTBEAT_MS = 500;
+const MIN_TTL_MS = 2000;
+export const validatePageIndicatorOptions = (options) => {
+    if (!options) {
+        return;
+    }
+    if (options.heartbeatMs !== undefined) {
+        if (!Number.isInteger(options.heartbeatMs) || options.heartbeatMs < MIN_HEARTBEAT_MS) {
+            throw new Error(`pageIndicator.heartbeatMs must be an integer >= ${MIN_HEARTBEAT_MS}`);
+        }
+    }
+    if (options.ttlMs !== undefined) {
+        if (!Number.isInteger(options.ttlMs) || options.ttlMs < MIN_TTL_MS) {
+            throw new Error(`pageIndicator.ttlMs must be an integer >= ${MIN_TTL_MS}`);
+        }
+    }
+};
+const DEFAULT_BG_COLOR = 'rgba(0, 0, 0, 0.75)';
+const DEFAULT_HOVER_BG_COLOR = 'rgba(0, 0, 0, 0.9)';
+const DEFAULT_ICON_COLOR = 'rgba(255, 255, 255, 0.95)';
+const DEFAULT_MARGIN = 8;
+const DEFAULT_SIZE = 19;
+export const createPageIndicatorController = (options) => {
+    const position = options.position ?? 'bottom-right';
+    const heartbeatMs = options.heartbeatMs ?? 2000;
+    const ttlMs = options.ttlMs ?? 6000;
+    const bgColor = options.bgColor ?? DEFAULT_BG_COLOR;
+    const hoverBgColor = DEFAULT_HOVER_BG_COLOR;
+    const iconColor = options.iconColor ?? DEFAULT_ICON_COLOR;
+    const margin = options.margin ?? DEFAULT_MARGIN;
+    const size = options.size ?? DEFAULT_SIZE;
+    let heartbeatTimer = null;
+    let currentSession = null;
+    let currentInfo = null;
+    const onAttach = (session, _target, info) => {
+        stop();
+        currentSession = session;
+        currentInfo = info;
+        void installIndicator(session, {
+            info,
+            position,
+            ttlMs,
+            bgColor,
+            hoverBgColor,
+            iconColor,
+            margin,
+            size,
+        });
+        heartbeatTimer = setInterval(() => {
+            if (!currentSession || !currentInfo) {
+                return;
+            }
+            void sendHeartbeat(currentSession, currentInfo);
+        }, heartbeatMs);
+    };
+    const onNavigation = (session, info) => {
+        currentInfo = info;
+        void installIndicator(session, {
+            info,
+            position,
+            ttlMs,
+            bgColor,
+            hoverBgColor,
+            iconColor,
+            margin,
+            size,
+        });
+    };
+    const reinstall = () => {
+        if (!currentSession || !currentInfo) {
+            return;
+        }
+        void installIndicator(currentSession, {
+            info: currentInfo,
+            position,
+            ttlMs,
+            bgColor,
+            hoverBgColor,
+            iconColor,
+            margin,
+            size,
+        });
+    };
+    const onDetach = () => {
+        if (heartbeatTimer) {
+            clearInterval(heartbeatTimer);
+            heartbeatTimer = null;
+        }
+        if (currentSession) {
+            void removeIndicator(currentSession).catch(() => { });
+        }
+        currentSession = null;
+        currentInfo = null;
+    };
+    const stop = () => {
+        onDetach();
+    };
+    return { onAttach, onNavigation, reinstall, onDetach, stop };
+};
+const installIndicator = async (session, params) => {
+    const { info, position, ttlMs, bgColor, hoverBgColor, iconColor, margin, size } = params;
+    const expression = buildInstallExpression({
+        info,
+        position,
+        ttlMs,
+        bgColor,
+        hoverBgColor,
+        iconColor,
+        margin,
+        size,
+    });
+    try {
+        await session.sendAndWait('Runtime.evaluate', {
+            expression,
+            returnByValue: true,
+        });
+    }
+    catch {
+        // Best-effort; page may not be ready
+    }
+};
+const sendHeartbeat = async (session, info) => {
+    const expression = buildHeartbeatExpression(info);
+    try {
+        await session.sendAndWait('Runtime.evaluate', {
+            expression,
+            returnByValue: true,
+        });
+    }
+    catch {
+        // Best-effort; CDP may be disconnected
+    }
+};
+const removeIndicator = async (session) => {
+    const expression = buildRemoveExpression();
+    try {
+        await session.sendAndWait('Runtime.evaluate', {
+            expression,
+            returnByValue: true,
+        });
+    }
+    catch {
+        // Best-effort; CDP may be unavailable
+    }
+};
+const buildInstallExpression = (params) => {
+    const { info, position, ttlMs, bgColor, hoverBgColor, iconColor, margin, size } = params;
+    const infoJson = JSON.stringify(info);
+    const svgWithSize = BOT_SVG.replace(/width="19"/, `width="${size}"`).replace(/height="19"/, `height="${size}"`);
+    const svgEscaped = svgWithSize.replace(/'/g, "\\'");
+    const positionStyles = {
+        'top-left': `top: ${margin}px; left: ${margin}px;`,
+        'top-center': `top: ${margin}px; left: 50%; transform: translateX(-50%);`,
+        'top-right': `top: ${margin}px; right: ${margin}px;`,
+        'bottom-left': `bottom: ${margin}px; left: ${margin}px;`,
+        'bottom-center': `bottom: ${margin}px; left: 50%; transform: translateX(-50%);`,
+        'bottom-right': `bottom: ${margin}px; right: ${margin}px;`,
+        'left-center': `top: 50%; left: ${margin}px; transform: translateY(-50%);`,
+        'right-center': `top: 50%; right: ${margin}px; transform: translateY(-50%);`,
+    };
+    const posStyle = positionStyles[position];
+    const tooltipText = `Argus Watcher: ${info.watcherId}`;
+    return `
+(function() {
+  var INDICATOR_ID = 'argus-watcher-indicator';
+  var STYLE_ID = 'argus-watcher-indicator-style';
+  var DIALOG_ID = 'argus-watcher-indicator-dialog';
+  var STATE_KEY = '__ARGUS_WATCHER_INDICATOR__';
+  var info = ${infoJson};
+  var ttlMs = ${ttlMs};
+  var svg = '${svgEscaped}';
+
+  var existing = document.getElementById(INDICATOR_ID);
+  if (existing) {
+    existing.remove();
+  }
+
+  if (window[STATE_KEY] && window[STATE_KEY].timerId) {
+    clearInterval(window[STATE_KEY].timerId);
+  }
+
+  // Inject styles for hover effects and dialog
+  var existingStyle = document.getElementById(STYLE_ID);
+  if (existingStyle) {
+    existingStyle.remove();
+  }
+  var style = document.createElement('style');
+  style.id = STYLE_ID;
+  style.textContent =
+    '#' + INDICATOR_ID + ' {' +
+      'transition: filter 0.15s ease, background 0.15s ease;' +
+    '}' +
+    '#' + INDICATOR_ID + ':hover {' +
+      'filter: brightness(1.4);' +
+      'background: ${hoverBgColor} !important;' +
+    '}' +
+    '#' + DIALOG_ID + '::backdrop {' +
+      'background: rgba(0, 0, 0, 0.5);' +
+    '}' +
+    '#' + DIALOG_ID + ' {' +
+      'border: 1px solid rgba(255, 255, 255, 0.15);' +
+      'border-radius: 10px;' +
+      'background: #1a1a1a;' +
+      'color: #e0e0e0;' +
+      'padding: 0;' +
+      'min-width: 320px;' +
+      'max-width: 480px;' +
+      'font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif;' +
+      'font-size: 13px;' +
+      'box-shadow: 0 8px 32px rgba(0, 0, 0, 0.5);' +
+    '}' +
+    '#' + DIALOG_ID + ' .argus-dialog-header {' +
+      'padding: 14px 18px 10px;' +
+      'font-size: 14px;' +
+      'font-weight: 600;' +
+      'color: #fff;' +
+      'border-bottom: 1px solid rgba(255, 255, 255, 0.1);' +
+    '}' +
+    '#' + DIALOG_ID + ' .argus-dialog-body {' +
+      'padding: 12px 18px;' +
+    '}' +
+    '#' + DIALOG_ID + ' .argus-dialog-row {' +
+      'display: flex;' +
+      'padding: 4px 0;' +
+      'gap: 12px;' +
+    '}' +
+    '#' + DIALOG_ID + ' .argus-dialog-label {' +
+      'flex-shrink: 0;' +
+      'width: 70px;' +
+      'color: rgba(255, 255, 255, 0.5);' +
+      'font-size: 12px;' +
+      'text-transform: uppercase;' +
+      'letter-spacing: 0.5px;' +
+      'padding-top: 1px;' +
+    '}' +
+    '#' + DIALOG_ID + ' .argus-dialog-value {' +
+      'color: #e0e0e0;' +
+      'word-break: break-all;' +
+    '}' +
+    '#' + DIALOG_ID + ' .argus-dialog-footer {' +
+      'display: flex;' +
+      'justify-content: flex-end;' +
+      'gap: 8px;' +
+      'padding: 10px 18px 14px;' +
+      'border-top: 1px solid rgba(255, 255, 255, 0.1);' +
+    '}' +
+    '#' + DIALOG_ID + ' button {' +
+      'border: 1px solid rgba(255, 255, 255, 0.2);' +
+      'border-radius: 6px;' +
+      'padding: 6px 16px;' +
+      'font-size: 13px;' +
+      'cursor: pointer;' +
+      'background: rgba(255, 255, 255, 0.08);' +
+      'color: #e0e0e0;' +
+    '}' +
+    '#' + DIALOG_ID + ' button:hover {' +
+      'background: rgba(255, 255, 255, 0.15);' +
+    '}';
+  document.documentElement.appendChild(style);
+
+  var el = document.createElement('div');
+  el.id = INDICATOR_ID;
+  el.setAttribute('data-testid', INDICATOR_ID);
+  el.setAttribute('title', '${tooltipText}');
+  el.style.cssText = 'position: fixed; ${posStyle} z-index: 2147483647; ' +
+    'background: ${bgColor}; color: ${iconColor}; ' +
+    'padding: 6px; border-radius: 6px; ' +
+    'cursor: pointer; display: flex; align-items: center; justify-content: center; ' +
+    'user-select: none; pointer-events: auto;';
+  el.innerHTML = svg;
+
+  el.addEventListener('click', function() {
+    var state = window[STATE_KEY];
+    var i = state ? state.info : info;
+    var attachedDate = new Date(i.attachedAt).toISOString();
+    var fields = [
+      ['ID', i.watcherId],
+      ['Host', i.watcherHost + ':' + i.watcherPort],
+      ['PID', String(i.watcherPid)],
+      ['Target', i.targetTitle || '(no title)'],
+      ['URL', i.targetUrl || '(no url)'],
+      ['Attached', attachedDate]
+    ];
+
+    var dialog = document.getElementById(DIALOG_ID);
+    if (!dialog) {
+      dialog = document.createElement('dialog');
+      dialog.id = DIALOG_ID;
+      dialog.addEventListener('click', function(e) {
+        if (e.target === dialog) {
+          dialog.close();
+        }
+      });
+      document.documentElement.appendChild(dialog);
+    }
+
+    var html = '<div class="argus-dialog-header">Argus Watcher</div>' +
+      '<div class="argus-dialog-body">';
+    for (var f = 0; f < fields.length; f++) {
+      html += '<div class="argus-dialog-row">' +
+        '<span class="argus-dialog-label">' + fields[f][0] + '</span>' +
+        '<span class="argus-dialog-value">' + fields[f][1] + '</span>' +
+        '</div>';
+    }
+    html += '</div>' +
+      '<div class="argus-dialog-footer">' +
+        '<button data-action="copy" type="button">Copy</button>' +
+        '<button data-action="close" type="button">Close</button>' +
+      '</div>';
+    dialog.innerHTML = html;
+
+    dialog.querySelector('[data-action="copy"]').addEventListener('click', function() {
+      var text = 'Argus Watcher Info\\n';
+      for (var c = 0; c < fields.length; c++) {
+        text += fields[c][0] + ': ' + fields[c][1] + '\\n';
+      }
+      navigator.clipboard.writeText(text.trim()).then(function() {
+        var btn = dialog.querySelector('[data-action="copy"]');
+        if (btn) {
+          btn.textContent = 'Copied!';
+          setTimeout(function() { btn.textContent = 'Copy'; }, 1500);
+        }
+      });
+    });
+
+    dialog.querySelector('[data-action="close"]').addEventListener('click', function() {
+      dialog.close();
+    });
+
+    dialog.showModal();
+  });
+
+  document.documentElement.appendChild(el);
+
+  var timerId = setInterval(function() {
+    var state = window[STATE_KEY];
+    if (!state) {
+      clearInterval(timerId);
+      var indicator = document.getElementById(INDICATOR_ID);
+      if (indicator) indicator.remove();
+      return;
+    }
+    if (Date.now() - state.lastSeenMs > state.ttlMs) {
+      clearInterval(state.timerId);
+      var indicator = document.getElementById(INDICATOR_ID);
+      if (indicator) indicator.remove();
+      delete window[STATE_KEY];
+    }
+  }, 1000);
+
+  window[STATE_KEY] = {
+    lastSeenMs: Date.now(),
+    ttlMs: ttlMs,
+    timerId: timerId,
+    info: info
+  };
+})();
+`;
+};
+const buildHeartbeatExpression = (info) => {
+    const infoJson = JSON.stringify(info);
+    return `
+(function() {
+  var STATE_KEY = '__ARGUS_WATCHER_INDICATOR__';
+  var state = window[STATE_KEY];
+  if (state) {
+    state.lastSeenMs = Date.now();
+    state.info = ${infoJson};
+  }
+})();
+`;
+};
+const buildRemoveExpression = () => {
+    return `
+(function() {
+  var INDICATOR_ID = 'argus-watcher-indicator';
+  var STYLE_ID = 'argus-watcher-indicator-style';
+  var DIALOG_ID = 'argus-watcher-indicator-dialog';
+  var STATE_KEY = '__ARGUS_WATCHER_INDICATOR__';
+  var state = window[STATE_KEY];
+  if (state && state.timerId) {
+    clearInterval(state.timerId);
+  }
+  delete window[STATE_KEY];
+  var el = document.getElementById(INDICATOR_ID);
+  if (el) el.remove();
+  var styleEl = document.getElementById(STYLE_ID);
+  if (styleEl) styleEl.remove();
+  var dialogEl = document.getElementById(DIALOG_ID);
+  if (dialogEl) dialogEl.remove();
+})();
+`;
+};
+//# sourceMappingURL=pageIndicator.js.map

package/dist/cdp/pageIndicator.js.map

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

package/dist/cdp/redaction.d.ts

@@ -0,0 +1,3 @@
+/** Redact URL query values while preserving keys. */
+export declare const redactUrl: (value: string) => string;
+//# sourceMappingURL=redaction.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"redaction.d.ts","sourceRoot":"","sources":["../../src/cdp/redaction.ts"],"names":[],"mappings":"AAEA,qDAAqD;AACrD,eAAO,MAAM,SAAS,GAAI,OAAO,MAAM,KAAG,MAmCzC,CAAA"}

package/dist/cdp/redaction.js

@@ -0,0 +1,35 @@
+const SENSITIVE_KEYS = new Set(['token', 'access_token', 'auth', 'authorization', 'code', 'password', 'pass']);
+/** Redact URL query values while preserving keys. */
+export const redactUrl = (value) => {
+    if (!value) {
+        return value;
+    }
+    let url;
+    try {
+        url = new URL(value);
+    }
+    catch {
+        return value;
+    }
+    if (!url.search) {
+        return value;
+    }
+    const params = new URLSearchParams(url.search);
+    const redacted = new URLSearchParams();
+    for (const [key, val] of params.entries()) {
+        const trimmedKey = key.trim();
+        if (!trimmedKey) {
+            continue;
+        }
+        const lowerKey = trimmedKey.toLowerCase();
+        if (SENSITIVE_KEYS.has(lowerKey) && val.trim()) {
+            redacted.append(trimmedKey, 'redacted');
+            continue;
+        }
+        redacted.append(trimmedKey, '');
+    }
+    const search = redacted.toString();
+    url.search = search ? `?${search}` : '';
+    return url.toString();
+};
+//# sourceMappingURL=redaction.js.map

package/dist/cdp/redaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redaction.js","sourceRoot":"","sources":["../../src/cdp/redaction.ts"],"names":[],"mappings":"AAAA,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC,CAAC,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC,CAAA;AAE9G,qDAAqD;AACrD,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,KAAa,EAAU,EAAE;IAClD,IAAI,CAAC,KAAK,EAAE,CAAC;QACZ,OAAO,KAAK,CAAA;IACb,CAAC;IAED,IAAI,GAAQ,CAAA;IACZ,IAAI,CAAC;QACJ,GAAG,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAA;IACrB,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,KAAK,CAAA;IACb,CAAC;IAED,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC;QACjB,OAAO,KAAK,CAAA;IACb,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;IAC9C,MAAM,QAAQ,GAAG,IAAI,eAAe,EAAE,CAAA;IAEtC,KAAK,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,EAAE,EAAE,CAAC;QAC3C,MAAM,UAAU,GAAG,GAAG,CAAC,IAAI,EAAE,CAAA;QAC7B,IAAI,CAAC,UAAU,EAAE,CAAC;YACjB,SAAQ;QACT,CAAC;QACD,MAAM,QAAQ,GAAG,UAAU,CAAC,WAAW,EAAE,CAAA;QACzC,IAAI,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC;YAChD,QAAQ,CAAC,MAAM,CAAC,UAAU,EAAE,UAAU,CAAC,CAAA;YACvC,SAAQ;QACT,CAAC;QACD,QAAQ,CAAC,MAAM,CAAC,UAAU,EAAE,EAAE,CAAC,CAAA;IAChC,CAAC;IAED,MAAM,MAAM,GAAG,QAAQ,CAAC,QAAQ,EAAE,CAAA;IAClC,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;IACvC,OAAO,GAAG,CAAC,QAAQ,EAAE,CAAA;AACtB,CAAC,CAAA"}

package/dist/cdp/remoteObject.d.ts

@@ -0,0 +1,6 @@
+export type CdpRuntimeClient = {
+    sendAndWait: (method: string, params?: Record<string, unknown>) => Promise<unknown>;
+};
+export declare const serializeRemoteObjects: (values: unknown[], cdp?: CdpRuntimeClient) => Promise<unknown[]>;
+export declare const serializeRemoteObject: (value: unknown, cdp?: CdpRuntimeClient) => Promise<unknown>;
+//# sourceMappingURL=remoteObject.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"remoteObject.d.ts","sourceRoot":"","sources":["../../src/cdp/remoteObject.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gBAAgB,GAAG;IAC9B,WAAW,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;CACnF,CAAA;AAYD,eAAO,MAAM,sBAAsB,GAAU,QAAQ,OAAO,EAAE,EAAE,MAAM,gBAAgB,KAAG,OAAO,CAAC,OAAO,EAAE,CAKzG,CAAA;AAED,eAAO,MAAM,qBAAqB,GAAU,OAAO,OAAO,EAAE,MAAM,gBAAgB,KAAG,OAAO,CAAC,OAAO,CA+BnG,CAAA"}

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;AAUvD,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,87 @@
+import fs from 'node:fs/promises';
+import { ensureArtifactsDir, ensureParentDir, resolveArtifactPath } from '../artifacts.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 documentResult = await session.sendAndWait('DOM.getDocument', { depth: 1 });
+    const root = documentResult;
+    const rootId = root.root?.nodeId;
+    if (!rootId) {
+        throw new Error('Unable to resolve DOM root');
+    }
+    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