@vforsh/argus-client 0.2.0 → 0.4.0

package/dist/eval/pollEval.js

@@ -0,0 +1,65 @@
+/**
+ * Transport-agnostic eval polling loop shared by the CLI (`eval --interval`,
+ * `eval-until`) and the SDK (`evalUntil`), so loop semantics stay identical.
+ *
+ * The loop owns only timing and stop conditions. Everything environment-specific —
+ * how an eval is performed, retry policy, signal handling, output — is injected by
+ * the caller. In particular this module installs no process listeners: cancellation
+ * is an `AbortSignal` so it stays safe to use inside a library.
+ */
+/**
+ * Poll `runEval` until a stop condition matches, the budget runs out, or the signal aborts.
+ *
+ * Results are reported to `onResult` before stop conditions are checked, so streaming
+ * callers print the matching iteration too.
+ */
+export const pollEval = async (input) => {
+    const startTime = Date.now();
+    let iteration = 0;
+    while (!input.signal?.aborted) {
+        if (input.totalTimeoutMs != null) {
+            const elapsedMs = Date.now() - startTime;
+            if (elapsedMs >= input.totalTimeoutMs) {
+                return { kind: 'timeout', elapsedMs };
+            }
+        }
+        iteration += 1;
+        const result = await input.runEval(iteration);
+        if (!result.ok) {
+            return { kind: 'eval-error', failure: result.failure };
+        }
+        const context = { response: result.response, iteration, attempt: result.attempt };
+        // Streaming callers print the matched iteration too, so emit before checking stop conditions.
+        await input.onResult?.(result.response, context);
+        const decision = input.shouldStop?.(context);
+        if (decision) {
+            if (!decision.ok) {
+                return { kind: 'condition-error', error: decision.error };
+            }
+            if (decision.matched) {
+                return { kind: 'matched', response: result.response, iteration, attempt: result.attempt };
+            }
+        }
+        if (input.count != null && iteration >= input.count) {
+            return { kind: 'exhausted', iterations: iteration };
+        }
+        await sleep(input.intervalMs, input.signal);
+    }
+    return { kind: 'interrupted' };
+};
+/** Resolve after `durationMs`, or immediately once `signal` aborts. */
+const sleep = async (durationMs, signal) => {
+    if (signal?.aborted) {
+        return;
+    }
+    await new Promise((resolve) => {
+        const finish = () => {
+            clearTimeout(timer);
+            signal?.removeEventListener('abort', finish);
+            resolve();
+        };
+        const timer = setTimeout(finish, durationMs);
+        signal?.addEventListener('abort', finish, { once: true });
+    });
+};
+//# sourceMappingURL=pollEval.js.map

package/dist/eval/pollEval.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pollEval.js","sourceRoot":"","sources":["../../src/eval/pollEval.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AA8CH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,KAAK,EAAuB,KAAyC,EAAiD,EAAE;IAC/I,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;IAC5B,IAAI,SAAS,GAAG,CAAC,CAAA;IAEjB,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;QAC/B,IAAI,KAAK,CAAC,cAAc,IAAI,IAAI,EAAE,CAAC;YAClC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAA;YACxC,IAAI,SAAS,IAAI,KAAK,CAAC,cAAc,EAAE,CAAC;gBACvC,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,CAAA;YACtC,CAAC;QACF,CAAC;QAED,SAAS,IAAI,CAAC,CAAA;QACd,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,CAAA;QAC7C,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;YAChB,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAA;QACvD,CAAC;QAED,MAAM,OAAO,GAA+B,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAA;QAC7G,8FAA8F;QAC9F,MAAM,KAAK,CAAC,QAAQ,EAAE,CAAC,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;QAEhD,MAAM,QAAQ,GAAG,KAAK,CAAC,UAAU,EAAE,CAAC,OAAO,CAAC,CAAA;QAC5C,IAAI,QAAQ,EAAE,CAAC;YACd,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBAClB,OAAO,EAAE,IAAI,EAAE,iBAAiB,EAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAE,CAAA;YAC1D,CAAC;YACD,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;gBACtB,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAA;YAC1F,CAAC;QACF,CAAC;QAED,IAAI,KAAK,CAAC,KAAK,IAAI,IAAI,IAAI,SAAS,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;YACrD,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,CAAA;QACpD,CAAC;QAED,MAAM,KAAK,CAAC,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;IAC5C,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,CAAA;AAC/B,CAAC,CAAA;AAED,uEAAuE;AACvE,MAAM,KAAK,GAAG,KAAK,EAAE,UAAkB,EAAE,MAAoB,EAAiB,EAAE;IAC/E,IAAI,MAAM,EAAE,OAAO,EAAE,CAAC;QACrB,OAAM;IACP,CAAC;IAED,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;QACnC,MAAM,MAAM,GAAG,GAAS,EAAE;YACzB,YAAY,CAAC,KAAK,CAAC,CAAA;YACnB,MAAM,EAAE,mBAAmB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAA;YAC5C,OAAO,EAAE,CAAA;QACV,CAAC,CAAA;QAED,MAAM,KAAK,GAAG,UAAU,CAAC,MAAM,EAAE,UAAU,CAAC,CAAA;QAC5C,MAAM,EAAE,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAA;IAC1D,CAAC,CAAC,CAAA;AACH,CAAC,CAAA"}

package/dist/index.d.ts

@@ -1,5 +1,8 @@
-export type { ArgusClient, ArgusClientOptions, EvalOptions, EvalResult, ListOptions, ListResult, LogsMode, LogsOptions, LogsResult, LogCursorResult, LogEpochResult, NetOptions, NetResult, ScreenshotOptions, ScreenshotResult, TraceStartOptions, TraceStartResult, TraceStopOptions, TraceStopResult, } from './types.js';
+export type { ArgusClient, ArgusClientOptions, DomClickOptions, DomClickResult, EvalOptions, EvalResult, EvalUntilOptions, EvalUntilResult, EvalValueOptions, ListOptions, ListResult, LogsMode, LogsOptions, LogsResult, LogCursorResult, LogEpochResult, NetClearResult, NetOptions, NetResult, RecordCaptureOptions, RecordOptions, RecordStartResult, RecordStopOptions, RecordStopResult, ReloadOptions, ScreenshotOptions, ScreenshotResult, TraceStartOptions, TraceStartResult, TraceStopOptions, TraceStopResult, VisibilityOptions, VisibilityResult, WatcherClient, } from './types.js';
 export { createArgusClient } from './client/createArgusClient.js';
+export { ArgusEvalError } from './eval/ArgusEvalError.js';
+export { pollEval } from './eval/pollEval.js';
+export type { EvalPollAttempt, EvalPollContext, EvalPollInput, EvalPollOutcome, EvalPollStopDecision } from './eval/pollEval.js';
 export type { LogEpoch } from '@vforsh/argus-core';
 export type { NetworkRequestDetail } from '@vforsh/argus-core';
 //# 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,YAAY,EACX,WAAW,EACX,kBAAkB,EAClB,WAAW,EACX,UAAU,EACV,WAAW,EACX,UAAU,EACV,QAAQ,EACR,WAAW,EACX,UAAU,EACV,eAAe,EACf,cAAc,EACd,UAAU,EACV,SAAS,EACT,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,GACf,MAAM,YAAY,CAAA;AACnB,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAA;AACjE,YAAY,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAA;AAClD,YAAY,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACX,WAAW,EACX,kBAAkB,EAClB,eAAe,EACf,cAAc,EACd,WAAW,EACX,UAAU,EACV,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,WAAW,EACX,UAAU,EACV,QAAQ,EACR,WAAW,EACX,UAAU,EACV,eAAe,EACf,cAAc,EACd,cAAc,EACd,UAAU,EACV,SAAS,EACT,oBAAoB,EACpB,aAAa,EACb,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,aAAa,EACb,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,iBAAiB,EACjB,gBAAgB,EAChB,aAAa,GACb,MAAM,YAAY,CAAA;AACnB,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAA;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAA;AACzD,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAA;AAC7C,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,aAAa,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAA;AAChI,YAAY,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAA;AAClD,YAAY,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAA"}

package/dist/index.js

@@ -1,2 +1,4 @@
 export { createArgusClient } from './client/createArgusClient.js';
+export { ArgusEvalError } from './eval/ArgusEvalError.js';
+export { pollEval } from './eval/pollEval.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAqBA,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAoCA,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAA;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAA;AACzD,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAA"}

package/dist/types.d.ts

@@ -1,4 +1,4 @@
-import type { LogEvent, LogEpoch, LogLevel, NetworkRequestDetail, NetworkRequestSummary, ScreenshotClipRegion, StatusResponse, WatcherRecord } from '@vforsh/argus-core';
+import type { DomClickRequest, DomClickResponse, EvalRequest, EvalResponse, LogEvent, LogEpoch, LogLevel, NetClearResponse, NetQuery, NetResponse, NetworkRequestDetail, RecordRequest, RecordStartRequest, RecordStartResponse, RecordStopRequest, RecordStopResponse, ReloadRequest, ResponseData, ScreenshotRequest, ScreenshotResponse, StatusResponse, TraceStartRequest, TraceStartResponse, TraceStopRequest, TraceStopResponse, VisibilityRequest, VisibilityResponse, WatcherRecord } from '@vforsh/argus-core';
 /** Options for configuring the Argus client. */
 export type ArgusClientOptions = {
     /** Override registry path instead of using `ARGUS_REGISTRY_PATH` / default. */
@@ -23,6 +23,13 @@ export type ListResult = {
     status?: StatusResponse;
     /** Error message when unreachable. */
     error?: string;
+    /**
+     * Set when the watcher answered but speaks an incompatible protocol version.
+     *
+     * The watcher is still reachable and `status` is still populated, but commands issued
+     * against it may fail in ways this SDK cannot interpret.
+     */
+    protocolMismatch?: string;
 };
 /** Controls how log event args are returned. */
 export type LogsMode = 'preview' | 'full';
@@ -62,92 +69,116 @@ export type LogEpochResult = {
     epoch: LogEpoch;
 };
 /** Options for fetching network request summaries. */
-export type NetOptions = {
-    after?: number;
-    limit?: number;
+export type NetOptions = Omit<NetQuery, 'sinceTs' | 'timeoutMs'> & {
     /**
      * Filter by time window.
      * - If string: parsed like CLI (e.g. "10m", "2h")
      * - If number: treated as durationMs
+     *
+     * Sugar over the wire's absolute `sinceTs`.
      */
     since?: string | number;
-    /** Substring match over redacted URLs. */
-    grep?: string;
-    /** Ignore requests by host name (exact host or subdomain match). */
-    ignoreHost?: string[];
-    /** Ignore requests whose URL contains one of these substrings. */
-    ignorePattern?: string[];
 };
 /** Network request summary results with pagination cursor. */
-export type NetResult = {
-    requests: NetworkRequestSummary[];
-    nextAfter: number;
-};
-/** Options for evaluating a JS expression in the connected page. */
-export type EvalOptions = {
-    /** JS expression to execute. */
-    expression: string;
-    /** String-only values exposed to the expression as `args`. */
-    args?: Record<string, string>;
-    /** Await promises before returning. Defaults to true. */
-    awaitPromise?: boolean;
-    /**
-     * Enable Chrome's REPL mode for console-style evaluation.
-     * Defaults to true and allows native top-level `await`.
-     */
-    replMode?: boolean;
-    /** Command timeout in milliseconds. */
-    timeoutMs?: number;
-    /** Return by value when possible. Defaults to true. */
-    returnByValue?: boolean;
-    /** Install the temporary host bridge expected by bundled Argus scenario code. */
-    scenario?: boolean;
-};
+export type NetResult = ResponseData<NetResponse>;
+/**
+ * Options for evaluating a JS expression in the connected page.
+ *
+ * This *is* the POST /eval body — it is sent verbatim — so it aliases the protocol
+ * request type rather than restating it.
+ */
+export type EvalOptions = EvalRequest;
 /** Result of a remote evaluation. */
-export type EvalResult = {
-    result: unknown;
-    type: string | null;
-    exception: {
-        text: string;
-        details?: unknown;
-    } | null;
-};
+export type EvalResult = ResponseData<EvalResponse>;
 /** Options for starting a Chrome trace. */
-export type TraceStartOptions = {
-    outFile?: string;
-    categories?: string;
-    options?: string;
-};
+export type TraceStartOptions = TraceStartRequest;
 /** Trace start result metadata. */
-export type TraceStartResult = {
-    traceId: string;
-    sessionName: string;
-    outFile: string;
-};
+export type TraceStartResult = ResponseData<TraceStartResponse>;
 /** Options for stopping an active trace. */
-export type TraceStopOptions = {
-    traceId?: string;
-    outFile?: string;
-};
+export type TraceStopOptions = TraceStopRequest;
 /** Trace stop result metadata. */
-export type TraceStopResult = {
-    sessionName: string;
-    outFile: string;
-    eventCount: number;
-    durationMs: number;
-};
+export type TraceStopResult = ResponseData<TraceStopResponse>;
 /** Options for capturing a screenshot. */
-export type ScreenshotOptions = {
-    outFile?: string;
-    selector?: string;
-    /** Viewport-relative crop rectangle in CSS pixels. Mutually exclusive with `selector`. */
-    clip?: ScreenshotClipRegion;
-    format?: 'png';
-};
+export type ScreenshotOptions = ScreenshotRequest;
 /** Screenshot result metadata. */
-export type ScreenshotResult = {
-    outFile: string;
-    clipped: boolean;
+export type ScreenshotResult = ResponseData<ScreenshotResponse>;
+/** Options for clicking in the connected page. Mirrors CLI `argus click` semantics. */
+export type DomClickOptions = DomClickRequest;
+/** Result of a click, reporting selector matches separately from actual clicks. */
+export type DomClickResult = ResponseData<DomClickResponse>;
+/** Result of clearing the watcher's buffered network log. */
+export type NetClearResult = ResponseData<NetClearResponse>;
+/** Options for the page visibility lock. */
+export type VisibilityOptions = VisibilityRequest;
+/**
+ * Visibility lock result. The desired lock is sticky across detach/reattach:
+ * the watcher remembers it and re-applies on the next attach when `attached` is false.
+ */
+export type VisibilityResult = ResponseData<VisibilityResponse>;
+/** Options for reloading the connected page. */
+export type ReloadOptions = ReloadRequest;
+/** Shared options for video recording requests. */
+export type RecordOptions = RecordStartRequest;
+/** Options for a fixed-duration one-shot recording. */
+export type RecordCaptureOptions = RecordRequest;
+/** Metadata returned when a recording starts. */
+export type RecordStartResult = ResponseData<RecordStartResponse>;
+/** Metadata returned when a recording is finalized. */
+export type RecordStopResult = ResponseData<RecordStopResponse>;
+/** Options for stopping an active recording. */
+export type RecordStopOptions = RecordStopRequest;
+/**
+ * Options for {@link ArgusClient.evalValue}.
+ *
+ * Omits `returnByValue` (always true) and adds {@link EvalValueOptions.jsonValue}.
+ */
+export type EvalValueOptions = Omit<EvalOptions, 'expression' | 'returnByValue' | 'jsonValue'> & {
+    /**
+     * Have the page serialize the result, so the JSON string — not a structured object —
+     * crosses the transport. Defaults to true.
+     *
+     * This exists because transports disagree about raw `returnByValue` results: the
+     * extension relay (Chrome's `chrome.debugger` serialization) returns object keys
+     * sorted alphabetically at every nesting level, while a direct CDP watcher preserves
+     * insertion order. Values are identical either way, but structural comparisons of the
+     * same page state produce different bytes per transport — which silently breaks
+     * snapshot assertions in verification runners. Serializing in the page normalizes both
+     * to insertion order, and makes `Date` round-trip as an ISO string (via `toJSON`)
+     * instead of `{}`.
+     *
+     * Evaluation semantics are unaffected: statement lists, top-level `await`, REPL-mode
+     * redeclaration, and promise unwrapping behave the same either way.
+     *
+     * Set to false for the raw transport-native value — one less serialization round-trip
+     * for large payloads you never compare structurally, at the cost of transport-dependent
+     * key order.
+     */
+    jsonValue?: boolean;
+};
+/** Options for {@link ArgusClient.evalUntil}. */
+export type EvalUntilOptions = EvalValueOptions & {
+    /** Delay between polls in milliseconds. Defaults to 250. */
+    intervalMs?: number;
+    /** Give up after this much wall-clock time. Defaults to 30000. */
+    totalTimeoutMs?: number;
+    /** Give up after this many polls. Unlimited when omitted. */
+    count?: number;
+    /**
+     * Stop condition evaluated against each poll's value.
+     * Defaults to a truthiness check on the returned value.
+     */
+    predicate?: (value: unknown, iteration: number) => boolean;
+    /** Abort the poll loop early. The returned promise rejects when aborted. */
+    signal?: AbortSignal;
+};
+/** Result of a successful {@link ArgusClient.evalUntil} poll. */
+export type EvalUntilResult = {
+    /** The value that satisfied the predicate. */
+    value: unknown;
+    /** 1-based poll iteration that matched. */
+    iteration: number;
+    /** Wall-clock milliseconds spent polling. */
+    elapsedMs: number;
 };
 /** Argus client API. */
 export type ArgusClient = {
@@ -163,13 +194,73 @@ export type ArgusClient = {
     net: (watcherId: string, options?: NetOptions) => Promise<NetResult>;
     /** Fetch the detailed record for one buffered network request. */
     netRequest: (watcherId: string, request: number | string) => Promise<NetworkRequestDetail>;
-    /** Evaluate a JS expression in the connected page. */
+    /** Clear the watcher's buffered network log. */
+    netClear: (watcherId: string) => Promise<NetClearResult>;
+    /**
+     * Evaluate a JS expression in the connected page and return the raw envelope.
+     * Page-side exceptions are reported in `exception`, not thrown.
+     */
     eval: (watcherId: string, options: EvalOptions) => Promise<EvalResult>;
+    /**
+     * Evaluate a JS expression and return its value directly.
+     *
+     * Unlike {@link ArgusClient.eval}, a page-side exception rejects with an `Error`
+     * carrying `exception.text` as its message. Results are normalized across transports
+     * by default — see {@link EvalValueOptions.jsonValue}.
+     *
+     * @throws {Error} When the expression throws in the page.
+     */
+    evalValue: <T = unknown>(watcherId: string, expression: string, options?: EvalValueOptions) => Promise<T>;
+    /**
+     * Poll an expression until it satisfies a predicate (truthy by default).
+     *
+     * @throws {Error} On page-side exceptions, total-timeout expiry, poll-count
+     * exhaustion, or abort via {@link EvalUntilOptions.signal}.
+     */
+    evalUntil: (watcherId: string, expression: string, options?: EvalUntilOptions) => Promise<EvalUntilResult>;
+    /** Click in the connected page by selector, element ref, or viewport coordinates. */
+    domClick: (watcherId: string, options: DomClickOptions) => Promise<DomClickResult>;
+    /** Lock the page shown+focused, or release the lock. */
+    visibility: (watcherId: string, options: VisibilityOptions) => Promise<VisibilityResult>;
+    /** Reload the connected page. Page-scoped even when the active target is an iframe. */
+    reload: (watcherId: string, options?: ReloadOptions) => Promise<void>;
     /** Start Chrome tracing and write to disk on the watcher. */
     traceStart: (watcherId: string, options?: TraceStartOptions) => Promise<TraceStartResult>;
     /** Stop an active Chrome trace and finalize the file. */
     traceStop: (watcherId: string, options?: TraceStopOptions) => Promise<TraceStopResult>;
     /** Capture a screenshot and write to disk on the watcher. */
     screenshot: (watcherId: string, options?: ScreenshotOptions) => Promise<ScreenshotResult>;
+    /** Capture a fixed-duration silent video and write it to disk on the watcher. */
+    record: (watcherId: string, options: RecordCaptureOptions) => Promise<RecordStopResult>;
+    /** Begin an open-ended silent video recording. Finalize with `recordStop`. */
+    recordStart: (watcherId: string, options?: RecordOptions) => Promise<RecordStartResult>;
+    /** Stop the active recording and finalize the file. */
+    recordStop: (watcherId: string, options?: RecordStopOptions) => Promise<RecordStopResult>;
+    /** Bind every watcher-scoped method to `watcherId`, removing id-threading at call sites. */
+    watcher: (watcherId: string) => WatcherClient;
+};
+/**
+ * Watcher-scoped subset of {@link ArgusClient}: everything that takes a watcher id first.
+ * `evalValue` is excluded because a mapped type erases its generic type parameter;
+ * {@link WatcherClient} redeclares it explicitly.
+ */
+type WatcherScopedApi = Omit<ArgusClient, 'list' | 'watcher' | 'evalValue'>;
+/**
+ * The same API as {@link ArgusClient} with `watcherId` pre-bound.
+ *
+ * @example
+ * const page = client.watcher('playground')
+ * const count = await page.evalValue<number>('document.querySelectorAll("li").length')
+ */
+export type WatcherClient = {
+    [K in keyof WatcherScopedApi]: WatcherScopedApi[K] extends (watcherId: string, ...rest: infer A) => infer R ? (...args: A) => R : never;
+} & {
+    /**
+     * Evaluate a JS expression and return its value directly.
+     *
+     * @throws {Error} When the expression throws in the page.
+     */
+    evalValue: <T = unknown>(expression: string, options?: EvalValueOptions) => Promise<T>;
 };
+export {};
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,oBAAoB,EACpB,qBAAqB,EACrB,oBAAoB,EACpB,cAAc,EACd,aAAa,EACb,MAAM,oBAAoB,CAAA;AAE3B,gDAAgD;AAChD,MAAM,MAAM,kBAAkB,GAAG;IAChC,+EAA+E;IAC/E,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,uFAAuF;IACvF,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,iCAAiC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAA;CAClB,CAAA;AAED,sDAAsD;AACtD,MAAM,MAAM,WAAW,GAAG;IACzB,kDAAkD;IAClD,KAAK,CAAC,EAAE,MAAM,CAAA;CACd,CAAA;AAED,yDAAyD;AACzD,MAAM,MAAM,UAAU,GAAG;IACxB,oDAAoD;IACpD,OAAO,EAAE,aAAa,CAAA;IACtB,4CAA4C;IAC5C,SAAS,EAAE,OAAO,CAAA;IAClB,sCAAsC;IACtC,MAAM,CAAC,EAAE,cAAc,CAAA;IACvB,sCAAsC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAA;CACd,CAAA;AAED,gDAAgD;AAChD,MAAM,MAAM,QAAQ,GAAG,SAAS,GAAG,MAAM,CAAA;AAEzC,gDAAgD;AAChD,MAAM,MAAM,WAAW,GAAG;IACzB,IAAI,CAAC,EAAE,QAAQ,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,GAAG,QAAQ,EAAE,CAAA;IAC5B,yCAAyC;IACzC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;IACzB,gDAAgD;IAChD,SAAS,CAAC,EAAE,WAAW,GAAG,aAAa,CAAA;IACvC,4CAA4C;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,+DAA+D;IAC/D,KAAK,CAAC,EAAE,QAAQ,CAAA;IAChB,0EAA0E;IAC1E,UAAU,CAAC,EAAE,QAAQ,CAAA;IACrB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;CACvB,CAAA;AAED,iDAAiD;AACjD,MAAM,MAAM,UAAU,GAAG;IACxB,MAAM,EAAE,QAAQ,EAAE,CAAA;IAClB,UAAU,EAAE,QAAQ,CAAA;CACpB,CAAA;AAED,wEAAwE;AACxE,MAAM,MAAM,eAAe,GAAG;IAC7B,MAAM,EAAE,QAAQ,CAAA;CAChB,CAAA;AAED,4EAA4E;AAC5E,MAAM,MAAM,cAAc,GAAG;IAC5B,KAAK,EAAE,QAAQ,CAAA;CACf,CAAA;AAED,sDAAsD;AACtD,MAAM,MAAM,UAAU,GAAG;IACxB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;IACd;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IACvB,0CAA0C;IAC1C,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,oEAAoE;IACpE,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;IACrB,kEAAkE;IAClE,aAAa,CAAC,EAAE,MAAM,EAAE,CAAA;CACxB,CAAA;AAED,8DAA8D;AAC9D,MAAM,MAAM,SAAS,GAAG;IACvB,QAAQ,EAAE,qBAAqB,EAAE,CAAA;IACjC,SAAS,EAAE,MAAM,CAAA;CACjB,CAAA;AAED,oEAAoE;AACpE,MAAM,MAAM,WAAW,GAAG;IACzB,gCAAgC;IAChC,UAAU,EAAE,MAAM,CAAA;IAClB,8DAA8D;IAC9D,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC7B,yDAAyD;IACzD,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,uCAAuC;IACvC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,uDAAuD;IACvD,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,iFAAiF;IACjF,QAAQ,CAAC,EAAE,OAAO,CAAA;CAClB,CAAA;AAED,qCAAqC;AACrC,MAAM,MAAM,UAAU,GAAG;IACxB,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;AAED,2CAA2C;AAC3C,MAAM,MAAM,iBAAiB,GAAG;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,OAAO,CAAC,EAAE,MAAM,CAAA;CAChB,CAAA;AAED,mCAAmC;AACnC,MAAM,MAAM,gBAAgB,GAAG;IAC9B,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE,MAAM,CAAA;CACf,CAAA;AAED,4CAA4C;AAC5C,MAAM,MAAM,gBAAgB,GAAG;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,OAAO,CAAC,EAAE,MAAM,CAAA;CAChB,CAAA;AAED,kCAAkC;AAClC,MAAM,MAAM,eAAe,GAAG;IAC7B,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE,MAAM,CAAA;IACf,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;CAClB,CAAA;AAED,0CAA0C;AAC1C,MAAM,MAAM,iBAAiB,GAAG;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,0FAA0F;IAC1F,IAAI,CAAC,EAAE,oBAAoB,CAAA;IAC3B,MAAM,CAAC,EAAE,KAAK,CAAA;CACd,CAAA;AAED,kCAAkC;AAClC,MAAM,MAAM,gBAAgB,GAAG;IAC9B,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,OAAO,CAAA;CAChB,CAAA;AAED,wBAAwB;AACxB,MAAM,MAAM,WAAW,GAAG;IACzB,uCAAuC;IACvC,IAAI,EAAE,CAAC,OAAO,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,UAAU,EAAE,CAAC,CAAA;IACtD,uCAAuC;IACvC,IAAI,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,UAAU,CAAC,CAAA;IACvE,oEAAoE;IACpE,SAAS,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,eAAe,CAAC,CAAA;IAC1D,4EAA4E;IAC5E,aAAa,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,CAAA;IAC7D,sDAAsD;IACtD,GAAG,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,KAAK,OAAO,CAAC,SAAS,CAAC,CAAA;IACpE,kEAAkE;IAClE,UAAU,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,KAAK,OAAO,CAAC,oBAAoB,CAAC,CAAA;IAC1F,sDAAsD;IACtD,IAAI,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,KAAK,OAAO,CAAC,UAAU,CAAC,CAAA;IACtE,6DAA6D;IAC7D,UAAU,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,iBAAiB,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAA;IACzF,yDAAyD;IACzD,SAAS,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,gBAAgB,KAAK,OAAO,CAAC,eAAe,CAAC,CAAA;IACtF,6DAA6D;IAC7D,UAAU,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,iBAAiB,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAA;CACzF,CAAA"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@vforsh/argus-client",
-	"version": "0.2.0",
+	"version": "0.4.0",
 	"repository": {
 		"type": "git",
 		"url": "git+https://github.com/vforsh/argus.git",
@@ -22,7 +22,7 @@
 		"access": "public"
 	},
 	"dependencies": {
-		"@vforsh/argus-core": "^0.2.0"
+		"@vforsh/argus-core": "^0.4.0"
 	},
 	"scripts": {
 		"clean": "node ../../scripts/clean-dist.mjs",

package/dist/registry/readAndPruneRegistry.d.ts

@@ -1,11 +0,0 @@
-import type { RegistryV1 } from '@vforsh/argus-core';
-type RegistryOptions = {
-    registryPath?: string;
-    ttlMs?: number;
-};
-/** Read + prune stale entries atomically (locked read-modify-write). */
-export declare const readAndPruneRegistry: (options?: RegistryOptions) => Promise<RegistryV1>;
-/** Remove a watcher entry atomically (locked read-modify-write). */
-export declare const removeWatcherAndPersist: (id: string, registryPath?: string) => Promise<RegistryV1>;
-export {};
-//# sourceMappingURL=readAndPruneRegistry.d.ts.map

package/dist/registry/readAndPruneRegistry.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"readAndPruneRegistry.d.ts","sourceRoot":"","sources":["../../src/registry/readAndPruneRegistry.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAEpD,KAAK,eAAe,GAAG;IACtB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,KAAK,CAAC,EAAE,MAAM,CAAA;CACd,CAAA;AAED,wEAAwE;AACxE,eAAO,MAAM,oBAAoB,GAAU,UAAS,eAAoB,KAAG,OAAO,CAAC,UAAU,CAM5F,CAAA;AAED,oEAAoE;AACpE,eAAO,MAAM,uBAAuB,GAAU,IAAI,MAAM,EAAE,eAAe,MAAM,KAAG,OAAO,CAAC,UAAU,CAEnG,CAAA"}

package/dist/registry/readAndPruneRegistry.js

@@ -1,14 +0,0 @@
-import { DEFAULT_TTL_MS, pruneStaleWatchers, removeWatcherEntry, updateRegistry } from '@vforsh/argus-core';
-/** Read + prune stale entries atomically (locked read-modify-write). */
-export const readAndPruneRegistry = async (options = {}) => {
-    const ttlMs = options.ttlMs ?? DEFAULT_TTL_MS;
-    return updateRegistry((registry) => {
-        const { registry: pruned } = pruneStaleWatchers(registry, Date.now(), ttlMs);
-        return pruned;
-    }, options.registryPath);
-};
-/** Remove a watcher entry atomically (locked read-modify-write). */
-export const removeWatcherAndPersist = async (id, registryPath) => {
-    return updateRegistry((registry) => removeWatcherEntry(registry, id), registryPath);
-};
-//# sourceMappingURL=readAndPruneRegistry.js.map

package/dist/registry/readAndPruneRegistry.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"readAndPruneRegistry.js","sourceRoot":"","sources":["../../src/registry/readAndPruneRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AAQ3G,wEAAwE;AACxE,MAAM,CAAC,MAAM,oBAAoB,GAAG,KAAK,EAAE,UAA2B,EAAE,EAAuB,EAAE;IAChG,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,cAAc,CAAA;IAC7C,OAAO,cAAc,CAAC,CAAC,QAAQ,EAAE,EAAE;QAClC,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,kBAAkB,CAAC,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,KAAK,CAAC,CAAA;QAC5E,OAAO,MAAM,CAAA;IACd,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CAAA;AACzB,CAAC,CAAA;AAED,oEAAoE;AACpE,MAAM,CAAC,MAAM,uBAAuB,GAAG,KAAK,EAAE,EAAU,EAAE,YAAqB,EAAuB,EAAE;IACvG,OAAO,cAAc,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,kBAAkB,CAAC,QAAQ,EAAE,EAAE,CAAC,EAAE,YAAY,CAAC,CAAA;AACpF,CAAC,CAAA"}

package/dist/time/parseDurationMs.d.ts

@@ -1,2 +0,0 @@
-export declare const parseDurationMs: (value: string) => number | null;
-//# sourceMappingURL=parseDurationMs.d.ts.map

package/dist/time/parseDurationMs.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"parseDurationMs.d.ts","sourceRoot":"","sources":["../../src/time/parseDurationMs.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,eAAe,GAAI,OAAO,MAAM,KAAG,MAAM,GAAG,IAoBxD,CAAA"}

package/dist/time/parseDurationMs.js

@@ -1,18 +0,0 @@
-export const parseDurationMs = (value) => {
-    const trimmed = value.trim();
-    if (!trimmed) {
-        return null;
-    }
-    const match = trimmed.match(/^([0-9]+(?:\.[0-9]+)?)(ms|s|m|h|d)?$/);
-    if (!match) {
-        return null;
-    }
-    const amount = Number(match[1]);
-    if (!Number.isFinite(amount)) {
-        return null;
-    }
-    const unit = match[2] ?? 's';
-    const multiplier = unit === 'ms' ? 1 : unit === 's' ? 1_000 : unit === 'm' ? 60_000 : unit === 'h' ? 3_600_000 : 86_400_000;
-    return amount * multiplier;
-};
-//# sourceMappingURL=parseDurationMs.js.map

package/dist/time/parseDurationMs.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"parseDurationMs.js","sourceRoot":"","sources":["../../src/time/parseDurationMs.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,KAAa,EAAiB,EAAE;IAC/D,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAA;IAC5B,IAAI,CAAC,OAAO,EAAE,CAAC;QACd,OAAO,IAAI,CAAA;IACZ,CAAC;IAED,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,sCAAsC,CAAC,CAAA;IACnE,IAAI,CAAC,KAAK,EAAE,CAAC;QACZ,OAAO,IAAI,CAAA;IACZ,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;IAC/B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QAC9B,OAAO,IAAI,CAAA;IACZ,CAAC;IAED,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,GAAG,CAAA;IAC5B,MAAM,UAAU,GAAG,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAA;IAE3H,OAAO,MAAM,GAAG,UAAU,CAAA;AAC3B,CAAC,CAAA"}