@vforsh/argus-watcher 0.1.2 → 0.1.4

package/dist/http/routes/postThrottle.js

@@ -0,0 +1,38 @@
+import { emitRequest } from './types.js';
+import { respondJson, respondInvalidBody, respondError, readJsonBody } from '../httpUtils.js';
+export const handle = async (req, res, _url, ctx) => {
+    const payload = await readJsonBody(req, res);
+    if (!payload) {
+        return;
+    }
+    const validActions = ['set', 'clear'];
+    const action = payload.action;
+    if (!action || !validActions.includes(action)) {
+        return respondInvalidBody(res, `action must be one of: ${validActions.join(', ')}`);
+    }
+    emitRequest(ctx, res, 'throttle');
+    const session = ctx.cdpSession.isAttached() ? ctx.cdpSession : null;
+    if (action === 'clear') {
+        try {
+            const response = await ctx.throttleController.clearDesired(session);
+            respondJson(res, response);
+        }
+        catch (error) {
+            respondError(res, error);
+        }
+        return;
+    }
+    // action === 'set'
+    const setPayload = payload;
+    if (typeof setPayload.rate !== 'number' || !Number.isFinite(setPayload.rate) || setPayload.rate < 1) {
+        return respondInvalidBody(res, 'rate must be a finite number >= 1');
+    }
+    try {
+        const response = await ctx.throttleController.setDesired(setPayload.rate, session);
+        respondJson(res, response);
+    }
+    catch (error) {
+        respondError(res, error);
+    }
+};
+//# sourceMappingURL=postThrottle.js.map

package/dist/http/routes/postThrottle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"postThrottle.js","sourceRoot":"","sources":["../../../src/http/routes/postThrottle.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AACxC,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAE7F,MAAM,CAAC,MAAM,MAAM,GAAiB,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;IACjE,MAAM,OAAO,GAAG,MAAM,YAAY,CAAkB,GAAG,EAAE,GAAG,CAAC,CAAA;IAC7D,IAAI,CAAC,OAAO,EAAE,CAAC;QACd,OAAM;IACP,CAAC;IAED,MAAM,YAAY,GAAG,CAAC,KAAK,EAAE,OAAO,CAAU,CAAA;IAC9C,MAAM,MAAM,GAAI,OAA+B,CAAC,MAAM,CAAA;IACtD,IAAI,CAAC,MAAM,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,MAAuC,CAAC,EAAE,CAAC;QAChF,OAAO,kBAAkB,CAAC,GAAG,EAAE,0BAA0B,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IACpF,CAAC;IAED,WAAW,CAAC,GAAG,EAAE,GAAG,EAAE,UAAU,CAAC,CAAA;IAEjC,MAAM,OAAO,GAAG,GAAG,CAAC,UAAU,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAA;IAEnE,IAAI,MAAM,KAAK,OAAO,EAAE,CAAC;QACxB,IAAI,CAAC;YACJ,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,kBAAkB,CAAC,YAAY,CAAC,OAAO,CAAC,CAAA;YACnE,WAAW,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAA;QAC3B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,YAAY,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;QACzB,CAAC;QACD,OAAM;IACP,CAAC;IAED,mBAAmB;IACnB,MAAM,UAAU,GAAG,OAA6B,CAAA;IAChD,IAAI,OAAO,UAAU,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,UAAU,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;QACrG,OAAO,kBAAkB,CAAC,GAAG,EAAE,mCAAmC,CAAC,CAAA;IACpE,CAAC;IAED,IAAI,CAAC;QACJ,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,kBAAkB,CAAC,UAAU,CAAC,UAAU,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;QAClF,WAAW,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAA;IAC3B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,YAAY,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;IACzB,CAAC;AACF,CAAC,CAAA"}

package/dist/http/routes/postTraceStart.d.ts

@@ -0,0 +1,3 @@
+import type { RouteHandler } from './types.js';
+export declare const handle: RouteHandler;
+//# sourceMappingURL=postTraceStart.d.ts.map

package/dist/http/routes/postTraceStart.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postTraceStart.d.ts","sourceRoot":"","sources":["../../../src/http/routes/postTraceStart.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAI9C,eAAO,MAAM,MAAM,EAAE,YAcpB,CAAA"}

package/dist/http/routes/postTraceStart.js

@@ -0,0 +1,17 @@
+import { emitRequest } from './types.js';
+import { respondJson, respondError, readJsonBody } from '../httpUtils.js';
+export const handle = async (req, res, _url, ctx) => {
+    const payload = await readJsonBody(req, res);
+    if (!payload) {
+        return;
+    }
+    emitRequest(ctx, res, 'trace/start');
+    try {
+        const response = await ctx.traceRecorder.start(payload);
+        respondJson(res, response);
+    }
+    catch (error) {
+        respondError(res, error);
+    }
+};
+//# sourceMappingURL=postTraceStart.js.map

package/dist/http/routes/postTraceStart.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"postTraceStart.js","sourceRoot":"","sources":["../../../src/http/routes/postTraceStart.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AACxC,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAEzE,MAAM,CAAC,MAAM,MAAM,GAAiB,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;IACjE,MAAM,OAAO,GAAG,MAAM,YAAY,CAAoB,GAAG,EAAE,GAAG,CAAC,CAAA;IAC/D,IAAI,CAAC,OAAO,EAAE,CAAC;QACd,OAAM;IACP,CAAC;IAED,WAAW,CAAC,GAAG,EAAE,GAAG,EAAE,aAAa,CAAC,CAAA;IAEpC,IAAI,CAAC;QACJ,MAAM,QAAQ,GAAuB,MAAM,GAAG,CAAC,aAAa,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;QAC3E,WAAW,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAA;IAC3B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,YAAY,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;IACzB,CAAC;AACF,CAAC,CAAA"}

package/dist/http/routes/postTraceStop.d.ts

@@ -0,0 +1,3 @@
+import type { RouteHandler } from './types.js';
+export declare const handle: RouteHandler;
+//# sourceMappingURL=postTraceStop.d.ts.map

package/dist/http/routes/postTraceStop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postTraceStop.d.ts","sourceRoot":"","sources":["../../../src/http/routes/postTraceStop.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAI9C,eAAO,MAAM,MAAM,EAAE,YAcpB,CAAA"}

package/dist/http/routes/postTraceStop.js

@@ -0,0 +1,17 @@
+import { emitRequest } from './types.js';
+import { respondJson, respondError, readJsonBody } from '../httpUtils.js';
+export const handle = async (req, res, _url, ctx) => {
+    const payload = await readJsonBody(req, res);
+    if (!payload) {
+        return;
+    }
+    emitRequest(ctx, res, 'trace/stop');
+    try {
+        const response = await ctx.traceRecorder.stop(payload);
+        respondJson(res, response);
+    }
+    catch (error) {
+        respondError(res, error);
+    }
+};
+//# sourceMappingURL=postTraceStop.js.map

package/dist/http/routes/postTraceStop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"postTraceStop.js","sourceRoot":"","sources":["../../../src/http/routes/postTraceStop.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AACxC,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAEzE,MAAM,CAAC,MAAM,MAAM,GAAiB,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;IACjE,MAAM,OAAO,GAAG,MAAM,YAAY,CAAmB,GAAG,EAAE,GAAG,CAAC,CAAA;IAC9D,IAAI,CAAC,OAAO,EAAE,CAAC;QACd,OAAM;IACP,CAAC;IAED,WAAW,CAAC,GAAG,EAAE,GAAG,EAAE,YAAY,CAAC,CAAA;IAEnC,IAAI,CAAC;QACJ,MAAM,QAAQ,GAAsB,MAAM,GAAG,CAAC,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QACzE,WAAW,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAA;IAC3B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,YAAY,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;IACzB,CAAC;AACF,CAAC,CAAA"}

package/dist/http/routes/types.d.ts

@@ -0,0 +1,9 @@
+import type http from 'node:http';
+import type { HttpRequestEventMetadata, HttpServerOptions } from '../server.js';
+/** Uniform handler signature for all route modules. */
+export type RouteHandler = (req: http.IncomingMessage, res: http.ServerResponse, url: URL, ctx: RouteContext) => Promise<void> | void;
+/** Context passed to every route handler (alias for HttpServerOptions). */
+export type RouteContext = HttpServerOptions;
+/** Emit an HTTP request event via `ctx.onRequest`. Replaces per-handler boilerplate. */
+export declare const emitRequest: (ctx: RouteContext, res: http.ServerResponse, endpoint: HttpRequestEventMetadata["endpoint"], query?: HttpRequestEventMetadata["query"]) => void;
+//# sourceMappingURL=types.d.ts.map

package/dist/http/routes/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/http/routes/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA;AACjC,OAAO,KAAK,EAAE,wBAAwB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAA;AAE/E,uDAAuD;AACvD,MAAM,MAAM,YAAY,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,eAAe,EAAE,GAAG,EAAE,IAAI,CAAC,cAAc,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,YAAY,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;AAErI,2EAA2E;AAC3E,MAAM,MAAM,YAAY,GAAG,iBAAiB,CAAA;AAE5C,wFAAwF;AACxF,eAAO,MAAM,WAAW,GACvB,KAAK,YAAY,EACjB,KAAK,IAAI,CAAC,cAAc,EACxB,UAAU,wBAAwB,CAAC,UAAU,CAAC,EAC9C,QAAQ,wBAAwB,CAAC,OAAO,CAAC,KACvC,IAOF,CAAA"}

package/dist/http/routes/types.js

@@ -0,0 +1,10 @@
+/** Emit an HTTP request event via `ctx.onRequest`. Replaces per-handler boilerplate. */
+export const emitRequest = (ctx, res, endpoint, query) => {
+    ctx.onRequest?.({
+        endpoint,
+        remoteAddress: res.req.socket.remoteAddress ?? null,
+        query,
+        ts: Date.now(),
+    });
+};
+//# sourceMappingURL=types.js.map

package/dist/http/routes/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/http/routes/types.ts"],"names":[],"mappings":"AASA,wFAAwF;AACxF,MAAM,CAAC,MAAM,WAAW,GAAG,CAC1B,GAAiB,EACjB,GAAwB,EACxB,QAA8C,EAC9C,KAAyC,EAClC,EAAE;IACT,GAAG,CAAC,SAAS,EAAE,CAAC;QACf,QAAQ;QACR,aAAa,EAAE,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,aAAa,IAAI,IAAI;QACnD,KAAK;QACL,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE;KACd,CAAC,CAAA;AACH,CAAC,CAAA"}

package/dist/http/server.d.ts

@@ -1,10 +1,37 @@
-import type { WatcherRecord } from '@vforsh/argus-core';
+import type { LogLevel, WatcherRecord } from '@vforsh/argus-core';
 import type { LogBuffer } from '../buffer/LogBuffer.js';
+import type { NetBuffer } from '../buffer/NetBuffer.js';
+import type { CdpSessionHandle } from '../cdp/connection.js';
+import type { RuntimeEditor } from '../cdp/editor.js';
+import type { TraceRecorder } from '../cdp/tracing.js';
+import type { Screenshotter } from '../cdp/screenshot.js';
+import type { CdpSourceHandle } from '../sources/types.js';
+import type { EmulationController } from '../emulation/EmulationController.js';
+import type { ThrottleController } from '../throttle/ThrottleController.js';
+/** Optional metadata for the HTTP request event. */
+export type HttpRequestEventMetadata = {
+    endpoint: 'logs' | 'tail' | 'net' | 'net/tail' | 'eval' | 'trace/start' | 'trace/stop' | 'screenshot' | 'snapshot' | 'code/list' | 'code/read' | 'code/grep' | 'dom/tree' | 'dom/info' | 'dom/hover' | 'dom/click' | 'dom/keydown' | 'dom/add' | 'dom/remove' | 'dom/modify' | 'dom/set-file' | 'dom/focus' | 'dom/fill' | 'dom/scroll' | 'dom/scroll-to' | 'emulation' | 'throttle' | 'storage/local' | 'reload' | 'shutdown' | 'targets' | 'attach' | 'detach';
+    remoteAddress: string | null;
+    query?: {
+        after?: number;
+        limit?: number;
+        levels?: LogLevel[];
+        match?: string[];
+        matchCase?: 'sensitive' | 'insensitive';
+        source?: string;
+        sinceTs?: number;
+        timeoutMs?: number;
+        grep?: string;
+    };
+    ts: number;
+};
 /** Options for the watcher HTTP server. */
 export type HttpServerOptions = {
     host: string;
     port: number;
     buffer: LogBuffer;
+    /** Network buffer for /net endpoints. Null when net capture is disabled. */
+    netBuffer: NetBuffer | null;
     getWatcher: () => WatcherRecord;
     getCdpStatus: () => {
         attached: boolean;
@@ -13,6 +40,20 @@ export type HttpServerOptions = {
             url: string | null;
         } | null;
     };
+    cdpSession: CdpSessionHandle;
+    traceRecorder: TraceRecorder;
+    screenshotter: Screenshotter;
+    runtimeEditor: RuntimeEditor;
+    /** Emulation controller for GET/POST /emulation endpoints. */
+    emulationController: EmulationController;
+    /** Throttle controller for GET/POST /throttle endpoints. */
+    throttleController: ThrottleController;
+    /** Source handle for extension mode (enables /targets, /attach, /detach endpoints). */
+    sourceHandle?: CdpSourceHandle;
+    /** Optional callback invoked when logs or tail are requested. */
+    onRequest?: (event: HttpRequestEventMetadata) => void;
+    /** Optional callback invoked when a shutdown request is received. */
+    onShutdown?: () => void | Promise<void>;
 };
 /** Handle for the running HTTP server. */
 export type HttpServerHandle = {

package/dist/http/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/http/server.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAuE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAC5H,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAA;AAEvD,2CAA2C;AAC3C,MAAM,MAAM,iBAAiB,GAAG;IAC/B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,SAAS,CAAA;IACjB,UAAU,EAAE,MAAM,aAAa,CAAA;IAC/B,YAAY,EAAE,MAAM;QAAE,QAAQ,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE;YAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;YAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;SAAE,GAAG,IAAI,CAAA;KAAE,CAAA;CACtG,CAAA;AAED,0CAA0C;AAC1C,MAAM,MAAM,gBAAgB,GAAG;IAC9B,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAC1B,CAAA;AAED,4DAA4D;AAC5D,eAAO,MAAM,eAAe,GAAU,SAAS,iBAAiB,KAAG,OAAO,CAAC,gBAAgB,CAuC1F,CAAA"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/http/server.ts"],"names":[],"mappings":"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"}

package/dist/http/server.js

@@ -1,18 +1,10 @@
 import http from 'node:http';
+import { dispatch } from './router.js';
 /** Start HTTP server bound to localhost for watcher API. */
 export const startHttpServer = async (options) => {
-    const server = http.createServer(async (req, res) => {
+    const server = http.createServer((req, res) => {
         const url = new URL(req.url ?? '/', `http://${req.headers.host ?? options.host}`);
-        if (req.method === 'GET' && url.pathname === '/status') {
-            return respondJson(res, buildStatus(options));
-        }
-        if (req.method === 'GET' && url.pathname === '/logs') {
-            return handleLogs(url, res, options);
-        }
-        if (req.method === 'GET' && url.pathname === '/tail') {
-            return handleTail(url, res, options);
-        }
-        respondJson(res, { ok: false, error: { message: 'Not found', code: 'not_found' } }, 404);
+        dispatch(req, res, url, options);
     });
     await new Promise((resolve, reject) => {
         server.once('error', reject);
@@ -33,75 +25,4 @@ export const startHttpServer = async (options) => {
         }),
     };
 };
-const handleLogs = (url, res, options) => {
-    const after = clampNumber(url.searchParams.get('after'), 0);
-    const limit = clampNumber(url.searchParams.get('limit'), 500, 1, 5000);
-    const levels = parseLevels(url.searchParams.get('levels'));
-    const grep = url.searchParams.get('grep') ?? undefined;
-    const sinceTs = clampNumber(url.searchParams.get('sinceTs'), undefined);
-    const events = options.buffer.listAfter(after, { levels, grep, sinceTs }, limit);
-    const nextAfter = events.length > 0 ? (events[events.length - 1]?.id ?? after) : after;
-    const response = { ok: true, events, nextAfter };
-    respondJson(res, response);
-};
-const handleTail = async (url, res, options) => {
-    const after = clampNumber(url.searchParams.get('after'), 0);
-    const limit = clampNumber(url.searchParams.get('limit'), 500, 1, 5000);
-    const timeoutMs = clampNumber(url.searchParams.get('timeoutMs'), 25_000, 1000, 120_000);
-    const levels = parseLevels(url.searchParams.get('levels'));
-    const grep = url.searchParams.get('grep') ?? undefined;
-    const events = await options.buffer.waitForAfter(after, { levels, grep }, limit, timeoutMs);
-    const nextAfter = events.length > 0 ? (events[events.length - 1]?.id ?? after) : after;
-    const response = { ok: true, events, nextAfter, timedOut: events.length === 0 };
-    respondJson(res, response);
-};
-const buildStatus = (options) => {
-    const watcher = options.getWatcher();
-    const buffer = options.buffer.getStats();
-    const cdpStatus = options.getCdpStatus();
-    return {
-        ok: true,
-        id: watcher.id,
-        pid: watcher.pid,
-        attached: cdpStatus.attached,
-        target: cdpStatus.target,
-        buffer,
-        watcher,
-    };
-};
-const respondJson = (res, body, status = 200) => {
-    const payload = JSON.stringify(body);
-    res.statusCode = status;
-    res.setHeader('Content-Type', 'application/json');
-    res.end(payload);
-};
-const clampNumber = (value, fallback, min, max) => {
-    if (value == null) {
-        return fallback ?? 0;
-    }
-    const parsed = Number(value);
-    if (!Number.isFinite(parsed)) {
-        return fallback ?? 0;
-    }
-    if (min != null && parsed < min) {
-        return min;
-    }
-    if (max != null && parsed > max) {
-        return max;
-    }
-    return parsed;
-};
-const parseLevels = (value) => {
-    if (!value) {
-        return undefined;
-    }
-    const levels = value
-        .split(',')
-        .map((item) => item.trim())
-        .filter(Boolean);
-    if (levels.length === 0) {
-        return undefined;
-    }
-    return levels;
-};
 //# sourceMappingURL=server.js.map

package/dist/http/server.js.map

@@ -1 +1 @@
-{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/http/server.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/http/server.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAA;AAW5B,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAoFtC,4DAA4D;AAC5D,MAAM,CAAC,MAAM,eAAe,GAAG,KAAK,EAAE,OAA0B,EAA6B,EAAE;IAC9F,MAAM,MAAM,GAAG,IAAI,CAAC,YAAY,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;QAC7C,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,GAAG,EAAE,UAAU,GAAG,CAAC,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC,CAAA;QACjF,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,OAAO,CAAC,CAAA;IACjC,CAAC,CAAC,CAAA;IAEF,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QAC3C,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAA;QAC5B,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAA;IAC3D,CAAC,CAAC,CAAA;IAEF,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,EAAE,CAAA;IAChC,MAAM,IAAI,GAAG,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAA;IAEjF,OAAO;QACN,IAAI;QACJ,KAAK,EAAE,GAAG,EAAE,CACX,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC/B,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;gBACtB,IAAI,KAAK,EAAE,CAAC;oBACX,MAAM,CAAC,KAAK,CAAC,CAAA;oBACb,OAAM;gBACP,CAAC;gBACD,OAAO,EAAE,CAAA;YACV,CAAC,CAAC,CAAA;QACH,CAAC,CAAC;KACH,CAAA;AACF,CAAC,CAAA"}

package/dist/index.d.ts

@@ -1,27 +1,84 @@
 import type { WatcherMatch, WatcherChrome, WatcherRecord, LogEvent } from '@vforsh/argus-core';
+import Emittery from 'emittery';
+import { type PageIndicatorOptions } from './cdp/pageIndicator.js';
+import type { ArgusWatcherEventMap } from './events.js';
+/** Context for the optional log filename builder callback. */
+export type BuildFilenameContext = {
+    /** Unique watcher identifier. */
+    watcherId: string;
+    /** Watcher start time as milliseconds since Unix epoch. */
+    startedAt: number;
+    /** Watcher start time formatted for use in a filename (ISO but with ":" replaced by "-"). */
+    startedAtSafe: string;
+    /** Sequence number of the log file within the current watcher session (starts at 1). */
+    fileIndex: number;
+};
+/** Configuration for artifacts storage (logs, traces, screenshots). */
+export type ArtifactsOptions = {
+    /**
+     * Base directory for all artifacts.
+     * Defaults to `$TMPDIR/argus/<watcherId>`.
+     */
+    base?: string;
+    /** Optional file log persistence settings. Disabled by default. */
+    logs?: {
+        /** Enable file logging. Defaults to `false`. */
+        enabled?: boolean;
+        /** Whether to include ISO timestamps in log records. Defaults to `false`. */
+        includeTimestamps?: boolean;
+        /** Max number of log files to keep for this watcher. Defaults to `5`. */
+        maxFiles?: number;
+        /** Optional callback to customize the log filename. Return null/undefined to use default. */
+        buildFilename?: (context: BuildFilenameContext) => string | undefined | null;
+    };
+    /** Trace recording settings. Enabled by default. */
+    traces?: {
+        /** Enable trace recording. Defaults to `true`. */
+        enabled?: boolean;
+    };
+    /** Screenshot capture settings. Enabled by default. */
+    screenshots?: {
+        /** Enable screenshot capture. Defaults to `true`. */
+        enabled?: boolean;
+    };
+};
+/** Configuration for network request capture. */
+export type NetOptions = {
+    /** Enable network request capture. Defaults to `false`. */
+    enabled?: boolean;
+};
+/** Page console logging level for watcher lifecycle and request logs. */
+export type PageConsoleLogging = 'none' | 'minimal' | 'full';
+/** Source mode for CDP connection. */
+export type WatcherSourceMode = 'cdp' | 'extension';
 /** Options to start a watcher server. */
 export type StartWatcherOptions = {
     /** Unique watcher identifier (used for registry presence and removal on shutdown). */
     id: string;
+    /**
+     * Source mode for CDP connection.
+     * - `cdp` (default): Connect directly to Chrome via WebSocket.
+     * - `extension`: Connect via Chrome extension Native Messaging.
+     */
+    source?: WatcherSourceMode;
     /** Host/interface to bind the watcher HTTP server to. Defaults to `127.0.0.1`. */
     host?: string;
     /** Port to bind the watcher HTTP server to. Defaults to `0` (ephemeral). */
     port?: number;
-    /** Criteria for which Chrome target(s) to attach to. */
+    /** Criteria for which Chrome target(s) to attach to. Only used in CDP mode. */
     match?: WatcherMatch;
-    /** Chrome DevTools Protocol (CDP) connection settings. Defaults to `127.0.0.1:9222`. */
+    /** Chrome DevTools Protocol (CDP) connection settings. Defaults to `127.0.0.1:9222`. Only used in CDP mode. */
     chrome?: WatcherChrome;
     /** Max buffered log events before older entries are dropped. Defaults to `50_000`. */
     bufferSize?: number;
     /** How often (in ms) to refresh the watcher record in the registry. Defaults to `15_000`. */
     heartbeatMs?: number;
-    /** Optional file log persistence settings. */
-    fileLogs?: {
-        /** Directory to store watcher logs. Required when fileLogs is set. */
-        logsDir: string;
-        /** Max number of log files to keep for this watcher. Defaults to `5`. */
-        maxFiles?: number;
-    };
+    /**
+     * Artifacts storage configuration for logs, traces, and screenshots.
+     * All artifacts are stored under `artifacts.base` (default: `$TMPDIR/argus`).
+     * Subdirectories: `logs/`, `traces/`, `screenshots/`.
+     */
+    artifacts?: ArtifactsOptions;
     /** Optional ignore list filtering when selecting log/exception locations. */
     ignoreList?: {
         /** Enable ignore list filtering for log/exception locations. */
@@ -29,8 +86,6 @@ export type StartWatcherOptions = {
         /** Regex patterns (as strings) to ignore when selecting a stack frame. */
         rules?: string[];
     };
-    /** Whether to include ISO timestamps in log records. Defaults to `false`. */
-    includeTimestamps?: boolean;
     location?: {
         /**
          * Strip these literal prefixes from event.file for display/logging.
@@ -38,18 +93,66 @@ export type StartWatcherOptions = {
          */
         stripUrlPrefixes?: string[];
     };
+    /**
+     * Optional in-page indicator showing that the watcher is attached.
+     * When enabled, a small badge is injected into the page. Clicking it shows watcher info.
+     * The indicator auto-removes via TTL if the watcher dies without cleanup.
+     * Supported in both direct CDP and Chrome extension modes.
+     */
+    pageIndicator?: PageIndicatorOptions;
+    /**
+     * Network request capture configuration.
+     * When enabled, captures HTTP requests and exposes them via `/net` and `/net/tail` endpoints.
+     * Disabled by default. Only supported in CDP mode.
+     */
+    net?: NetOptions;
+    /**
+     * Write watcher lifecycle and request logs into the attached page's DevTools console.
+     * - `none`: Do not write anything.
+     * - `minimal` (default): Write attach/detach lifecycle messages.
+     * - `full`: Same as minimal, plus log every HTTP request to the watcher API.
+     */
+    pageConsoleLogging?: PageConsoleLogging;
+    /**
+     * Optional JavaScript to inject on attach and document start.
+     * The script is provided as raw text to keep watcher package filesystem-agnostic.
+     */
+    inject?: {
+        script: string;
+        exposeArgus?: boolean;
+    };
 };
 /** Handle returned by startWatcher. */
 export type WatcherHandle = {
-    close: () => Promise<void>;
+    /**
+     * The current watcher record (including id/bind address/port and CDP match settings).
+     *
+     * This is the shape announced in the local registry and the same metadata served via the HTTP API.
+     */
     watcher: WatcherRecord;
+    /**
+     * Event emitter for watcher lifecycle and request events.
+     * Subscribe to 'cdpAttached', 'cdpDetached', and 'httpRequested'.
+     */
+    events: Emittery<ArgusWatcherEventMap>;
+    /**
+     * Stop the watcher and release resources.
+     *
+     * Shuts down CDP attachment, stops the HTTP server, closes any artifact writers (file logs),
+     * clears event listeners, and removes the watcher from the local registry.
+     *
+     * Safe to call multiple times.
+     */
+    close: () => Promise<void>;
 };
 /**
- * Start a watcher that connects to Chrome CDP, buffers console logs, and exposes the HTTP API.
- * @param options - Configuration for binding, CDP matching, and buffering.
+ * Start a watcher that connects to Chrome (via CDP or extension), buffers console logs, and exposes the HTTP API.
+ * @param options - Configuration for binding, source mode, and buffering.
  * @returns A handle that can be closed to stop the watcher and clean up registry state.
  */
 export declare const startWatcher: (options: StartWatcherOptions) => Promise<WatcherHandle>;
 /** Log event shape emitted by watchers. */
 export type { LogEvent };
+export type { ArgusWatcherEventMap, CdpAttachedEvent, CdpDetachedEvent, HttpRequestEvent, LogRequestQuery, NetRequestQuery } from './events.js';
+export type { PageIndicatorOptions, PageIndicatorPosition } from './cdp/pageIndicator.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAA;AAS9F,yCAAyC;AACzC,MAAM,MAAM,mBAAmB,GAAG;IACjC,sFAAsF;IACtF,EAAE,EAAE,MAAM,CAAA;IACV,kFAAkF;IAClF,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,4EAA4E;IAC5E,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,wDAAwD;IACxD,KAAK,CAAC,EAAE,YAAY,CAAA;IACpB,wFAAwF;IACxF,MAAM,CAAC,EAAE,aAAa,CAAA;IACtB,sFAAsF;IACtF,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,6FAA6F;IAC7F,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,8CAA8C;IAC9C,QAAQ,CAAC,EAAE;QACV,sEAAsE;QACtE,OAAO,EAAE,MAAM,CAAA;QACf,yEAAyE;QACzE,QAAQ,CAAC,EAAE,MAAM,CAAA;KACjB,CAAA;IACD,6EAA6E;IAC7E,UAAU,CAAC,EAAE;QACZ,gEAAgE;QAChE,OAAO,CAAC,EAAE,OAAO,CAAA;QACjB,0EAA0E;QAC1E,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;KAChB,CAAA;IACD,6EAA6E;IAC7E,iBAAiB,CAAC,EAAE,OAAO,CAAA;IAC3B,QAAQ,CAAC,EAAE;QACV;;;WAGG;QACH,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAA;KAC3B,CAAA;CACD,CAAA;AAED,uCAAuC;AACvC,MAAM,MAAM,aAAa,GAAG;IAC3B,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IAC1B,OAAO,EAAE,aAAa,CAAA;CACtB,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,YAAY,GAAU,SAAS,mBAAmB,KAAG,OAAO,CAAC,aAAa,CAsFtF,CAAA;AAED,2CAA2C;AAC3C,YAAY,EAAE,QAAQ,EAAE,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}