@vforsh/argus 0.1.2 → 0.1.4

package/dist/commands/doctor.js

@@ -0,0 +1,142 @@
+import { accessSync, constants } from 'node:fs';
+import { getArgusHomeDir, getRegistryPath } from '@vforsh/argus-core';
+import { fetchJson } from '../httpClient.js';
+import { loadRegistry } from '../registry.js';
+import { createOutput } from '../output/io.js';
+import { resolveChromeBin } from '../utils/chromeBin.js';
+export const runDoctor = async (options) => {
+    const output = createOutput(options);
+    const argusHomeEnv = process.env.ARGUS_HOME ?? null;
+    const registryEnv = process.env.ARGUS_REGISTRY_PATH ?? null;
+    const resolvedHome = getArgusHomeDir();
+    const registryPath = getRegistryPath();
+    const registryReadable = checkReadable(registryPath);
+    const registryStatus = registryReadable ? 'ok' : 'warn';
+    const registryMessage = registryReadable
+        ? `registry path readable: ${registryPath}`
+        : `registry path not readable: ${registryPath}`;
+    const hasWebSocket = Boolean(globalThis.WebSocket);
+    const websocketStatus = hasWebSocket ? 'ok' : 'fail';
+    const websocketMessage = hasWebSocket ? 'WebSocket available' : 'WebSocket unavailable (Node 18+ required)';
+    const chromeBinEnv = process.env.ARGUS_CHROME_BIN ?? null;
+    const chromeBin = resolveChromeBin();
+    const chromeStatus = chromeBin ? 'ok' : 'warn';
+    const chromeMessage = chromeBin ? `chrome bin: ${chromeBin}` : 'chrome bin not found (set ARGUS_CHROME_BIN)';
+    const cdpHost = '127.0.0.1';
+    const cdpPort = 9222;
+    const cdpResult = await checkCdp(cdpHost, cdpPort);
+    const cdpStatus = cdpResult.ok ? 'ok' : 'warn';
+    const cdpMessage = cdpResult.ok
+        ? `cdp reachable: ${cdpHost}:${cdpPort} (${cdpResult.version})`
+        : `cdp unreachable: ${cdpHost}:${cdpPort} (${cdpResult.error})`;
+    let registry = null;
+    let registryLoadError = null;
+    try {
+        registry = await loadRegistry();
+    }
+    catch (error) {
+        registryLoadError = error instanceof Error ? error.message : String(error);
+    }
+    const watcherEntries = registry ? Object.values(registry.watchers) : [];
+    const watcherReports = [];
+    for (const watcher of watcherEntries) {
+        const statusResult = await checkWatcherStatus(watcher.host, watcher.port);
+        if (!statusResult.ok) {
+            watcherReports.push({
+                id: watcher.id,
+                host: watcher.host,
+                port: watcher.port,
+                status: 'warn',
+                message: `unreachable (${statusResult.error})`,
+            });
+            continue;
+        }
+        watcherReports.push({
+            id: watcher.id,
+            host: watcher.host,
+            port: watcher.port,
+            status: 'ok',
+            message: statusResult.status.attached ? 'attached' : 'detached',
+            attached: statusResult.status.attached,
+            target: statusResult.status.target,
+        });
+    }
+    if (options.json) {
+        output.writeJson({
+            registry: {
+                argusHomeEnv,
+                registryEnv,
+                resolvedHome,
+                registryPath,
+                readable: registryReadable,
+                loadError: registryLoadError,
+            },
+            websocket: { available: hasWebSocket },
+            chromeBin: { env: chromeBinEnv, resolved: chromeBin },
+            cdp: cdpResult.ok
+                ? { host: cdpHost, port: cdpPort, reachable: true, version: cdpResult.version }
+                : { host: cdpHost, port: cdpPort, reachable: false, error: cdpResult.error },
+            watchers: watcherReports,
+        });
+        return;
+    }
+    output.writeHuman(`${formatStatus(registryStatus)} ${registryMessage}`);
+    output.writeHuman(`INFO ARGUS_HOME=${argusHomeEnv ?? 'unset'} ARGUS_REGISTRY_PATH=${registryEnv ?? 'unset'}`);
+    output.writeHuman(`INFO resolved ARGUS_HOME=${resolvedHome}`);
+    if (registryLoadError) {
+        output.writeHuman(`WARN registry load failed: ${registryLoadError}`);
+    }
+    output.writeHuman(`${formatStatus(websocketStatus)} ${websocketMessage}`);
+    output.writeHuman(`${formatStatus(chromeStatus)} ${chromeMessage}`);
+    output.writeHuman(`${formatStatus(cdpStatus)} ${cdpMessage}`);
+    if (watcherReports.length === 0) {
+        output.writeHuman('WARN no registered watchers');
+        return;
+    }
+    for (const report of watcherReports) {
+        const targetLabel = report.target?.title || report.target?.url
+            ? ` (${report.target?.title ?? ''}${report.target?.title && report.target?.url ? ' • ' : ''}${report.target?.url ?? ''})`
+            : '';
+        output.writeHuman(`${formatStatus(report.status)} watcher ${report.id} ${report.host}:${report.port} ${report.message}${targetLabel}`.trim());
+    }
+};
+const checkReadable = (path) => {
+    try {
+        accessSync(path, constants.R_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+};
+const checkWatcherStatus = async (host, port) => {
+    const url = `http://${host}:${port}/status`;
+    try {
+        const status = await fetchJson(url, { timeoutMs: 2_000 });
+        return { ok: true, status };
+    }
+    catch (error) {
+        return { ok: false, error: error instanceof Error ? error.message : String(error) };
+    }
+};
+const checkCdp = async (host, port) => {
+    const url = `http://${host}:${port}/json/version`;
+    try {
+        const response = await fetchJson(url, { timeoutMs: 1_500 });
+        if (!response.Browser) {
+            return { ok: false, error: 'invalid response' };
+        }
+        return { ok: true, version: response.Browser };
+    }
+    catch (error) {
+        return { ok: false, error: error instanceof Error ? error.message : String(error) };
+    }
+};
+const formatStatus = (status) => {
+    if (status === 'ok')
+        return 'OK';
+    if (status === 'fail')
+        return 'FAIL';
+    return 'WARN';
+};
+//# sourceMappingURL=doctor.js.map

package/dist/commands/doctor.js.map

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

package/dist/commands/domAdd.d.ts

@@ -0,0 +1,17 @@
+/** Options for the dom add command. */
+export type DomAddOptions = {
+    selector: string;
+    html?: string;
+    htmlFile?: string;
+    htmlStdin?: boolean;
+    position?: string;
+    all?: boolean;
+    nth?: string;
+    first?: boolean;
+    expect?: string;
+    text?: boolean;
+    json?: boolean;
+};
+/** Execute the dom add command for a watcher id. */
+export declare const runDomAdd: (id: string | undefined, options: DomAddOptions) => Promise<void>;
+//# sourceMappingURL=domAdd.d.ts.map

package/dist/commands/domAdd.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"domAdd.d.ts","sourceRoot":"","sources":["../../src/commands/domAdd.ts"],"names":[],"mappings":"AAOA,uCAAuC;AACvC,MAAM,MAAM,aAAa,GAAG;IAC3B,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,GAAG,CAAC,EAAE,OAAO,CAAA;IACb,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,IAAI,CAAC,EAAE,OAAO,CAAA;CACd,CAAA;AAED,oDAAoD;AACpD,eAAO,MAAM,SAAS,GAAU,IAAI,MAAM,GAAG,SAAS,EAAE,SAAS,aAAa,KAAG,OAAO,CAAC,IAAI,CAuG5F,CAAA"}

package/dist/commands/domAdd.js

@@ -0,0 +1,181 @@
+import { readFile } from 'node:fs/promises';
+import { createOutput } from '../output/io.js';
+import { formatError } from '../cli/parse.js';
+import { resolvePath } from '../utils/paths.js';
+import { requestWatcherJson, writeRequestError } from '../watchers/requestWatcher.js';
+/** Execute the dom add command for a watcher id. */
+export const runDomAdd = async (id, options) => {
+    const output = createOutput(options);
+    if (!options.selector || options.selector.trim() === '') {
+        output.writeWarn('--selector or --testid is required');
+        process.exitCode = 2;
+        return;
+    }
+    const position = normalizePosition(options.position);
+    if (!position) {
+        output.writeWarn('--position must be one of: beforebegin, afterbegin, beforeend, afterend (aliases: before, after, prepend, append)');
+        process.exitCode = 2;
+        return;
+    }
+    if (options.all && (options.nth != null || options.first)) {
+        output.writeWarn('Cannot combine --all with --nth or --first');
+        process.exitCode = 2;
+        return;
+    }
+    if (options.nth != null && options.first) {
+        output.writeWarn('Cannot combine --nth with --first');
+        process.exitCode = 2;
+        return;
+    }
+    const nth = options.first ? 0 : parseNonNegativeInt(options.nth, '--nth', output);
+    if (options.nth != null && nth == null) {
+        process.exitCode = 2;
+        return;
+    }
+    const expect = parseNonNegativeInt(options.expect, '--expect', output);
+    if (options.expect != null && expect == null) {
+        process.exitCode = 2;
+        return;
+    }
+    const html = await resolveHtmlInput(options, output);
+    if (html == null) {
+        process.exitCode = 2;
+        return;
+    }
+    if (!html) {
+        output.writeWarn('HTML content is empty. Provide non-empty --html, --html-file, or --html-stdin input.');
+        process.exitCode = 2;
+        return;
+    }
+    const result = await requestWatcherJson({
+        id,
+        path: '/dom/add',
+        method: 'POST',
+        body: {
+            selector: options.selector,
+            html,
+            position,
+            all: options.all ?? false,
+            nth,
+            expect,
+            text: options.text ?? false,
+        },
+        timeoutMs: 30_000,
+        returnErrorResponse: true,
+    });
+    if (!result.ok) {
+        writeRequestError(result, output);
+        return;
+    }
+    const response = result.data;
+    if (!response.ok) {
+        const errorResp = response;
+        if (options.json) {
+            output.writeJson(response);
+        }
+        else {
+            output.writeWarn(`Error: ${errorResp.error.message}`);
+        }
+        process.exitCode = 1;
+        return;
+    }
+    const successResp = response;
+    if (options.json) {
+        output.writeJson(successResp);
+        return;
+    }
+    if (successResp.matches === 0) {
+        output.writeWarn(`No element found for selector: ${options.selector}`);
+        output.writeWarn(`Hint: run \`argus dom tree${id ? ` ${id}` : ''} --selector "${options.selector}" --all\``);
+        process.exitCode = 1;
+        return;
+    }
+    const label = successResp.inserted === 1 ? 'element' : 'elements';
+    const prefix = result.watcher.id ? `${result.watcher.id}: ` : '';
+    output.writeHuman(`${prefix}Inserted at ${successResp.inserted}/${successResp.matches} ${label} (${position}) for selector: ${options.selector}`);
+};
+const normalizePosition = (value) => {
+    if (!value) {
+        return 'beforeend';
+    }
+    const normalized = value.trim().toLowerCase();
+    if (normalized === '') {
+        return null;
+    }
+    const aliases = {
+        before: 'beforebegin',
+        after: 'afterend',
+        prepend: 'afterbegin',
+        append: 'beforeend',
+    };
+    if (normalized in aliases) {
+        return aliases[normalized];
+    }
+    const validPositions = ['beforebegin', 'afterbegin', 'beforeend', 'afterend'];
+    if (validPositions.includes(normalized)) {
+        return normalized;
+    }
+    return null;
+};
+const parseNonNegativeInt = (value, label, output) => {
+    if (value == null) {
+        return undefined;
+    }
+    const parsed = Number(value);
+    if (!Number.isFinite(parsed) || !Number.isInteger(parsed) || parsed < 0) {
+        output.writeWarn(`${label} must be a non-negative integer`);
+        return null;
+    }
+    return parsed;
+};
+const resolveHtmlInput = async (options, output) => {
+    const wantsStdin = options.htmlStdin === true || options.html === '-';
+    const hasHtmlValue = options.html != null && options.html !== '-';
+    const hasFile = options.htmlFile != null;
+    if (hasHtmlValue && hasFile) {
+        output.writeWarn('Cannot combine --html with --html-file');
+        return null;
+    }
+    if (hasHtmlValue && options.htmlStdin) {
+        output.writeWarn('Cannot combine --html with --html-stdin');
+        return null;
+    }
+    if (hasFile && wantsStdin) {
+        output.writeWarn('Cannot combine --html-file with stdin input');
+        return null;
+    }
+    if (hasFile) {
+        try {
+            return await readFile(resolvePath(options.htmlFile ?? ''), 'utf8');
+        }
+        catch (error) {
+            output.writeWarn(`Failed to read --html-file: ${formatError(error)}`);
+            return null;
+        }
+    }
+    if (wantsStdin) {
+        try {
+            return await readStdin();
+        }
+        catch (error) {
+            output.writeWarn(`Failed to read stdin: ${formatError(error)}`);
+            return null;
+        }
+    }
+    if (hasHtmlValue) {
+        return options.html ?? null;
+    }
+    output.writeWarn('Provide --html, --html-file, or --html-stdin (or pass --html -)');
+    return null;
+};
+const readStdin = async () => new Promise((resolve, reject) => {
+    let data = '';
+    process.stdin.setEncoding('utf8');
+    process.stdin.on('data', (chunk) => {
+        data += chunk;
+    });
+    process.stdin.on('end', () => resolve(data));
+    process.stdin.on('error', (error) => reject(error));
+    process.stdin.resume();
+});
+//# sourceMappingURL=domAdd.js.map

package/dist/commands/domAdd.js.map

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

package/dist/commands/domAddScript.d.ts

@@ -0,0 +1,14 @@
+/** Options for the dom add-script command. */
+export type DomAddScriptOptions = {
+    src?: string;
+    file?: string;
+    stdin?: boolean;
+    type?: string;
+    /** Script element id attribute (mapped from CLI --id to avoid clash with watcher id positional). */
+    scriptId?: string;
+    target?: string;
+    json?: boolean;
+};
+/** Execute the dom add-script command for a watcher id. */
+export declare const runDomAddScript: (id: string | undefined, code: string | undefined, options: DomAddScriptOptions) => Promise<void>;
+//# sourceMappingURL=domAddScript.d.ts.map

package/dist/commands/domAddScript.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"domAddScript.d.ts","sourceRoot":"","sources":["../../src/commands/domAddScript.ts"],"names":[],"mappings":"AAOA,8CAA8C;AAC9C,MAAM,MAAM,mBAAmB,GAAG;IACjC,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,oGAAoG;IACpG,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,OAAO,CAAA;CACd,CAAA;AAED,2DAA2D;AAC3D,eAAO,MAAM,eAAe,GAAU,IAAI,MAAM,GAAG,SAAS,EAAE,MAAM,MAAM,GAAG,SAAS,EAAE,SAAS,mBAAmB,KAAG,OAAO,CAAC,IAAI,CA6DlI,CAAA"}

package/dist/commands/domAddScript.js

@@ -0,0 +1,172 @@
+import { readFile } from 'node:fs/promises';
+import { evalOnce } from '../eval/evalClient.js';
+import { createOutput } from '../output/io.js';
+import { formatError } from '../cli/parse.js';
+import { resolvePath } from '../utils/paths.js';
+import { resolveWatcherOrExit } from '../watchers/requestWatcher.js';
+/** Execute the dom add-script command for a watcher id. */
+export const runDomAddScript = async (id, code, options) => {
+    const output = createOutput(options);
+    const target = resolveTarget(options.target, output);
+    if (!target) {
+        process.exitCode = 2;
+        return;
+    }
+    const input = await resolveCodeInput(code, options, output);
+    if (!input) {
+        process.exitCode = 2;
+        return;
+    }
+    const resolved = await resolveWatcherOrExit({ id }, output);
+    if (!resolved)
+        return;
+    const { watcher } = resolved;
+    const scriptConfig = {
+        type: options.type,
+        id: options.scriptId,
+        target,
+    };
+    const isSrc = input.kind === 'src';
+    const expression = isSrc ? buildSrcScriptExpression(input.value, scriptConfig) : buildInlineScriptExpression(input.value, scriptConfig);
+    const result = await evalOnce({
+        watcher,
+        expression,
+        awaitPromise: isSrc,
+        returnByValue: true,
+        failOnException: true,
+    });
+    if (!result.ok) {
+        if (options.json && result.response) {
+            output.writeJson(result.response);
+        }
+        if (result.kind === 'exception' && result.response?.exception) {
+            output.writeWarn(`Exception: ${result.response.exception.text}`);
+        }
+        else {
+            output.writeWarn(result.error);
+        }
+        process.exitCode = 1;
+        return;
+    }
+    if (options.json) {
+        output.writeJson(result.response);
+        return;
+    }
+    const prefix = watcher.id ? `${watcher.id}: ` : '';
+    if (isSrc) {
+        output.writeHuman(`${prefix}Script loaded from ${input.value} into <${target}>`);
+    }
+    else {
+        output.writeHuman(`${prefix}Script added to <${target}>`);
+    }
+};
+const resolveCodeInput = async (code, options, output) => {
+    const wantsStdin = options.stdin === true || code === '-';
+    const hasInline = code != null && code !== '-';
+    const hasFile = options.file != null;
+    const hasSrc = options.src != null;
+    const sourceCount = [hasInline, hasFile, wantsStdin, hasSrc].filter(Boolean).length;
+    if (sourceCount > 1) {
+        output.writeWarn('Provide only one of: inline code, --file, --stdin, or --src');
+        return null;
+    }
+    if (hasSrc) {
+        const url = options.src.trim();
+        if (!url) {
+            output.writeWarn('--src value is empty');
+            return null;
+        }
+        return { kind: 'src', value: url };
+    }
+    if (hasFile) {
+        try {
+            const content = await readFile(resolvePath(options.file), 'utf8');
+            if (!content.trim()) {
+                output.writeWarn(`File is empty: ${options.file}`);
+                return null;
+            }
+            return { kind: 'inline', value: content };
+        }
+        catch (error) {
+            output.writeWarn(`Failed to read --file: ${formatError(error)}`);
+            return null;
+        }
+    }
+    if (wantsStdin) {
+        try {
+            const content = await readStdin();
+            if (!content.trim()) {
+                output.writeWarn('Stdin input is empty');
+                return null;
+            }
+            return { kind: 'inline', value: content };
+        }
+        catch (error) {
+            output.writeWarn(`Failed to read stdin: ${formatError(error)}`);
+            return null;
+        }
+    }
+    if (hasInline) {
+        if (!code.trim()) {
+            output.writeWarn('Code is empty');
+            return null;
+        }
+        return { kind: 'inline', value: code };
+    }
+    output.writeWarn('Provide inline code, --file, --stdin (or pass - as code), or --src.');
+    return null;
+};
+const buildInlineScriptExpression = (code, config) => {
+    const doubleEncoded = JSON.stringify(JSON.stringify(code));
+    const attrs = buildAttrLines(config);
+    return `(() => {
+  const s = document.createElement('script');
+  s.textContent = JSON.parse(${doubleEncoded});${attrs}
+  document.${config.target}.appendChild(s);
+  return { ok: true, target: ${JSON.stringify(config.target)} };
+})()`;
+};
+const buildSrcScriptExpression = (url, config) => {
+    const attrs = buildAttrLines(config);
+    return `(() => {
+  return new Promise((resolve, reject) => {
+    const s = document.createElement('script');
+    s.src = ${JSON.stringify(url)};${attrs}
+    s.onload = () => resolve({ ok: true, src: s.src, target: ${JSON.stringify(config.target)} });
+    s.onerror = () => reject(new Error('Failed to load script: ' + s.src));
+    document.${config.target}.appendChild(s);
+  });
+})()`;
+};
+const buildAttrLines = (config) => {
+    let lines = '';
+    if (config.type) {
+        lines += `\n  s.type = ${JSON.stringify(config.type)};`;
+    }
+    if (config.id) {
+        lines += `\n  s.id = ${JSON.stringify(config.id)};`;
+    }
+    return lines;
+};
+const resolveTarget = (value, output) => {
+    if (!value) {
+        return 'head';
+    }
+    const normalized = value.trim().toLowerCase();
+    if (normalized === 'head' || normalized === 'body') {
+        return normalized;
+    }
+    output.writeWarn('--target must be "head" or "body"');
+    return null;
+};
+const readStdin = async () => new Promise((resolve, reject) => {
+    let data = '';
+    process.stdin.setEncoding('utf8');
+    process.stdin.on('data', (chunk) => {
+        data += chunk;
+    });
+    process.stdin.on('end', () => resolve(data));
+    process.stdin.on('error', (error) => reject(error));
+    process.stdin.resume();
+});
+//# sourceMappingURL=domAddScript.js.map

package/dist/commands/domAddScript.js.map

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

package/dist/commands/domClick.d.ts

@@ -0,0 +1,13 @@
+/** Options for the dom click command. */
+export type DomClickOptions = {
+    selector?: string;
+    pos?: string;
+    button?: string;
+    all?: boolean;
+    text?: string;
+    wait?: string;
+    json?: boolean;
+};
+/** Execute the dom click command for a watcher id. */
+export declare const runDomClick: (id: string | undefined, options: DomClickOptions) => Promise<void>;
+//# sourceMappingURL=domClick.d.ts.map

package/dist/commands/domClick.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"domClick.d.ts","sourceRoot":"","sources":["../../src/commands/domClick.ts"],"names":[],"mappings":"AAKA,yCAAyC;AACzC,MAAM,MAAM,eAAe,GAAG;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,GAAG,CAAC,EAAE,OAAO,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,OAAO,CAAA;CACd,CAAA;AAED,sDAAsD;AACtD,eAAO,MAAM,WAAW,GAAU,IAAI,MAAM,GAAG,SAAS,EAAE,SAAS,eAAe,KAAG,OAAO,CAAC,IAAI,CAuHhG,CAAA"}