@vforsh/argus-client 0.2.0 → 0.4.0

package/dist/client/methods/page.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"page.js","sourceRoot":"","sources":["../../../src/client/methods/page.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAErD,gEAAgE;AAChE,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,GAAkB,EAAE,EAAE,CAAC,CAAC;IACzD,QAAQ,EAAE,KAAK,EAAE,SAAiB,EAAE,OAAwB,EAA2B,EAAE;QACxF,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,EAAE,QAAQ,IAAI,OAAO,EAAE,GAAG,CAAC,IAAI,OAAO,EAAE,CAAC,IAAI,IAAI,IAAI,OAAO,EAAE,CAAC,IAAI,IAAI,CAAA;QACxG,IAAI,CAAC,SAAS,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAA;QAClE,CAAC;QAED,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,cAAc,CAAmB,GAAG,EAAE,SAAS,EAAE;YACvE,IAAI,EAAE,YAAY;YAClB,SAAS,EAAE,GAAG,CAAC,gBAAgB;YAC/B,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,OAAO;SACb,CAAC,CAAA;QAEF,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAA;IACxD,CAAC;IAED,UAAU,EAAE,KAAK,EAAE,SAAiB,EAAE,OAA0B,EAA6B,EAAE;QAC9F,IAAI,OAAO,EAAE,MAAM,KAAK,MAAM,IAAI,OAAO,EAAE,MAAM,KAAK,MAAM,EAAE,CAAC;YAC9D,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAA;QACnD,CAAC;QAED,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,cAAc,CAAqB,GAAG,EAAE,SAAS,EAAE;YACzE,IAAI,EAAE,aAAa;YACnB,SAAS,EAAE,GAAG,CAAC,gBAAgB;YAC/B,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,OAAO;SACb,CAAC,CAAA;QAEF,OAAO,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAA;IACtD,CAAC;IAED,MAAM,EAAE,KAAK,EAAE,SAAiB,EAAE,UAAyB,EAAE,EAAiB,EAAE;QAC/E,MAAM,cAAc,CAAiB,GAAG,EAAE,SAAS,EAAE;YACpD,IAAI,EAAE,SAAS;YACf,SAAS,EAAE,GAAG,CAAC,gBAAgB;YAC/B,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,EAAE,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,KAAK,EAAE;SACnD,CAAC,CAAA;IACH,CAAC;CACD,CAAC,CAAA"}

package/dist/client/queryParams.d.ts

@@ -1,4 +1,6 @@
 import type { LogsOptions, NetOptions } from '../types.js';
+/** Build the query string for the log listing and tail routes. */
 export declare const buildLogsParams: (options: LogsOptions) => URLSearchParams;
+/** Build the query string for the network listing and tail routes. */
 export declare const buildNetParams: (options: NetOptions) => URLSearchParams;
 //# sourceMappingURL=queryParams.d.ts.map

package/dist/client/queryParams.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"queryParams.d.ts","sourceRoot":"","sources":["../../src/client/queryParams.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAG1D,eAAO,MAAM,eAAe,GAAI,SAAS,WAAW,KAAG,eA+CtD,CAAA;AAED,eAAO,MAAM,cAAc,GAAI,SAAS,UAAU,KAAG,eA0BpD,CAAA"}
+{"version":3,"file":"queryParams.d.ts","sourceRoot":"","sources":["../../src/client/queryParams.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAE1D,kEAAkE;AAClE,eAAO,MAAM,eAAe,GAAI,SAAS,WAAW,KAAG,eAiBtD,CAAA;AAED,sEAAsE;AACtE,eAAO,MAAM,cAAc,GAAI,SAAS,UAAU,KAAG,eA0BpD,CAAA"}

package/dist/client/queryParams.js

@@ -1,142 +1,107 @@
-import { parseDurationMs } from '../time/parseDurationMs.js';
+import { NET_PARTIES, NET_SCOPES, normalizeMatchPatterns, parseDurationMs, toSearchParams } from '@vforsh/argus-core';
+/** Build the query string for the log listing and tail routes. */
 export const buildLogsParams = (options) => {
-    const params = new URLSearchParams();
-    const after = normalizeQueryValue(options.after);
-    if (after != null) {
-        params.set('after', after);
-    }
-    if (after != null && options.sinceEpoch != null) {
+    if (options.after != null && options.sinceEpoch != null) {
         throw new Error('Use either after or sinceEpoch, not both');
     }
-    const sinceEpoch = normalizeQueryValue(options.sinceEpoch);
-    if (sinceEpoch) {
-        params.set('sinceEpoch', sinceEpoch);
-    }
-    const limit = normalizeNonNegativeNumber('limit', options.limit);
-    if (limit != null) {
-        params.set('limit', String(limit));
-    }
-    const levels = normalizeLevels(options.levels);
-    if (levels) {
-        params.set('levels', levels);
-    }
-    const match = normalizeMatch(options.match);
-    if (match) {
-        for (const pattern of match) {
-            params.append('match', pattern);
-        }
-    }
-    const matchCase = normalizeMatchCase(options.matchCase);
-    if (matchCase) {
-        params.set('matchCase', matchCase);
-    }
-    const source = normalizeQueryValue(options.source);
-    if (source) {
-        params.set('source', source);
-    }
-    const sinceTs = resolveSinceTs(options.since);
-    if (sinceTs != null) {
-        params.set('sinceTs', String(sinceTs));
-    }
-    return params;
+    const query = {
+        after: options.after,
+        sinceEpoch: options.sinceEpoch,
+        limit: requireNonNegative('limit', options.limit),
+        levels: normalizeLevels(options.levels),
+        match: requireMatchPatterns(options.match),
+        matchCase: requireMatchCase(options.matchCase),
+        source: options.source,
+        sinceTs: resolveSinceTs(options.since),
+    };
+    return toSearchParams(query);
 };
+/** Build the query string for the network listing and tail routes. */
 export const buildNetParams = (options) => {
-    const params = new URLSearchParams();
-    const after = normalizeNonNegativeNumber('after', options.after);
-    if (after != null) {
-        params.set('after', String(after));
-    }
-    const limit = normalizeNonNegativeNumber('limit', options.limit);
-    if (limit != null) {
-        params.set('limit', String(limit));
-    }
-    const sinceTs = resolveSinceTs(options.since);
-    if (sinceTs != null) {
-        params.set('sinceTs', String(sinceTs));
-    }
-    const grep = normalizeQueryValue(options.grep);
-    if (grep) {
-        params.set('grep', grep);
-    }
-    appendRepeatedQueryValues(params, 'ignoreHost', options.ignoreHost);
-    appendRepeatedQueryValues(params, 'ignorePattern', options.ignorePattern);
-    return params;
+    if (options.scope != null && options.frame != null) {
+        throw new Error('Cannot combine scope and frame filters. Use one or the other.');
+    }
+    const query = {
+        after: requireNonNegative('after', options.after),
+        limit: requireNonNegative('limit', options.limit),
+        sinceTs: resolveSinceTs(options.since),
+        grep: options.grep,
+        host: requireNonEmptyValues('host', options.host),
+        method: requireNonEmptyValues('method', options.method),
+        status: requireNonEmptyValues('status', options.status),
+        resourceType: requireNonEmptyValues('resourceType', options.resourceType),
+        mime: requireNonEmptyValues('mime', options.mime),
+        scope: requireChoice('scope', options.scope, NET_SCOPES),
+        frame: options.frame,
+        party: requireChoice('party', options.party, NET_PARTIES),
+        failedOnly: options.failedOnly,
+        minDurationMs: requireNonNegative('minDurationMs', options.minDurationMs),
+        minTransferBytes: requireNonNegative('minTransferBytes', options.minTransferBytes),
+        ignoreHost: requireNonEmptyValues('ignoreHost', options.ignoreHost),
+        ignorePattern: requireNonEmptyValues('ignorePattern', options.ignorePattern),
+    };
+    return toSearchParams(query);
 };
 const normalizeLevels = (levels) => {
     if (levels == null) {
         return undefined;
     }
-    if (Array.isArray(levels)) {
-        const normalized = levels.map((level) => level.trim()).filter(Boolean);
-        if (normalized.length === 0) {
-            return undefined;
-        }
-        return normalized.join(',');
+    if (!Array.isArray(levels)) {
+        return levels;
     }
-    const trimmed = levels.trim();
-    return trimmed ? trimmed : undefined;
+    const normalized = levels.map((level) => level.trim()).filter(Boolean);
+    return normalized.length > 0 ? normalized.join(',') : undefined;
 };
-const normalizeMatch = (match) => {
+const requireMatchPatterns = (match) => {
     if (match == null) {
         return undefined;
     }
-    const values = Array.isArray(match) ? match : [match];
-    const normalized = values.map((value) => value.trim());
-    if (normalized.some((value) => value.length === 0)) {
-        throw new Error('Invalid match value: empty pattern.');
+    const result = normalizeMatchPatterns(Array.isArray(match) ? match : [match]);
+    if (result.error) {
+        throw new Error(result.error);
     }
-    return normalized;
-};
-const normalizeMatchCase = (matchCase) => {
-    if (matchCase == null) {
-        return undefined;
-    }
-    if (matchCase !== 'sensitive' && matchCase !== 'insensitive') {
-        throw new Error(`Invalid matchCase value: ${matchCase}`);
-    }
-    return matchCase;
+    return result.patterns;
 };
+const requireMatchCase = (matchCase) => requireChoice('matchCase', matchCase, ['sensitive', 'insensitive']);
 const resolveSinceTs = (value) => {
     if (value == null) {
         return undefined;
     }
-    const durationMs = typeof value === 'number' ? normalizeNonNegativeNumber('since', value) : parseDurationOrThrow(value);
-    if (durationMs == null) {
-        return undefined;
+    const durationMs = typeof value === 'number' ? requireNonNegative('since', value) : parseDurationOrThrow(value);
+    return durationMs == null ? undefined : Date.now() - durationMs;
+};
+const parseDurationOrThrow = (value) => {
+    const duration = parseDurationMs(value);
+    if (duration == null) {
+        throw new Error(`Invalid since value: ${value}`);
     }
-    return Date.now() - durationMs;
+    return duration;
 };
-const normalizeQueryValue = (value) => {
+const requireNonNegative = (label, value) => {
     if (value == null) {
         return undefined;
     }
-    const trimmed = value.trim();
-    return trimmed ? trimmed : undefined;
+    if (!Number.isFinite(value) || value < 0) {
+        throw new Error(`Invalid ${label} value: ${value}`);
+    }
+    return value;
 };
-const appendRepeatedQueryValues = (params, key, values) => {
+const requireNonEmptyValues = (label, values) => {
     if (!values || values.length === 0) {
-        return;
+        return undefined;
     }
     for (const value of values) {
-        const normalized = normalizeQueryValue(value);
-        if (!normalized) {
-            throw new Error(`Invalid ${key} value: ${value}`);
+        if (!value.trim()) {
+            throw new Error(`Invalid ${label} value: ${value}`);
         }
-        params.append(key, normalized);
     }
+    return values;
 };
-const parseDurationOrThrow = (value) => {
-    const duration = parseDurationMs(value);
-    if (duration == null) {
-        throw new Error(`Invalid since value: ${value}`);
-    }
-    return duration;
-};
-const normalizeNonNegativeNumber = (label, value) => {
+const requireChoice = (label, value, allowed) => {
     if (value == null) {
         return undefined;
     }
-    if (!Number.isFinite(value) || value < 0) {
+    if (!allowed.includes(value)) {
         throw new Error(`Invalid ${label} value: ${value}`);
     }
     return value;

package/dist/client/queryParams.js.map

@@ -1 +1 @@
-{"version":3,"file":"queryParams.js","sourceRoot":"","sources":["../../src/client/queryParams.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAA;AAE5D,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,OAAoB,EAAmB,EAAE;IACxE,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAA;IACpC,MAAM,KAAK,GAAG,mBAAmB,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;IAChD,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC;QACnB,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,CAAA;IAC3B,CAAC;IACD,IAAI,KAAK,IAAI,IAAI,IAAI,OAAO,CAAC,UAAU,IAAI,IAAI,EAAE,CAAC;QACjD,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAA;IAC5D,CAAC;IACD,MAAM,UAAU,GAAG,mBAAmB,CAAC,OAAO,CAAC,UAAU,CAAC,CAAA;IAC1D,IAAI,UAAU,EAAE,CAAC;QAChB,MAAM,CAAC,GAAG,CAAC,YAAY,EAAE,UAAU,CAAC,CAAA;IACrC,CAAC;IAED,MAAM,KAAK,GAAG,0BAA0B,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,CAAA;IAChE,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC;QACnB,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAA;IACnC,CAAC;IAED,MAAM,MAAM,GAAG,eAAe,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;IAC9C,IAAI,MAAM,EAAE,CAAC;QACZ,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAA;IAC7B,CAAC;IAED,MAAM,KAAK,GAAG,cAAc,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;IAC3C,IAAI,KAAK,EAAE,CAAC;QACX,KAAK,MAAM,OAAO,IAAI,KAAK,EAAE,CAAC;YAC7B,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;QAChC,CAAC;IACF,CAAC;IAED,MAAM,SAAS,GAAG,kBAAkB,CAAC,OAAO,CAAC,SAAS,CAAC,CAAA;IACvD,IAAI,SAAS,EAAE,CAAC;QACf,MAAM,CAAC,GAAG,CAAC,WAAW,EAAE,SAAS,CAAC,CAAA;IACnC,CAAC;IAED,MAAM,MAAM,GAAG,mBAAmB,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;IAClD,IAAI,MAAM,EAAE,CAAC;QACZ,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAA;IAC7B,CAAC;IAED,MAAM,OAAO,GAAG,cAAc,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;IAC7C,IAAI,OAAO,IAAI,IAAI,EAAE,CAAC;QACrB,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAA;IACvC,CAAC;IAED,OAAO,MAAM,CAAA;AACd,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,OAAmB,EAAmB,EAAE;IACtE,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAA;IACpC,MAAM,KAAK,GAAG,0BAA0B,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,CAAA;IAChE,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC;QACnB,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAA;IACnC,CAAC;IAED,MAAM,KAAK,GAAG,0BAA0B,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,CAAA;IAChE,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC;QACnB,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAA;IACnC,CAAC;IAED,MAAM,OAAO,GAAG,cAAc,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;IAC7C,IAAI,OAAO,IAAI,IAAI,EAAE,CAAC;QACrB,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAA;IACvC,CAAC;IAED,MAAM,IAAI,GAAG,mBAAmB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;IAC9C,IAAI,IAAI,EAAE,CAAC;QACV,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;IACzB,CAAC;IAED,yBAAyB,CAAC,MAAM,EAAE,YAAY,EAAE,OAAO,CAAC,UAAU,CAAC,CAAA;IACnE,yBAAyB,CAAC,MAAM,EAAE,eAAe,EAAE,OAAO,CAAC,aAAa,CAAC,CAAA;IAEzE,OAAO,MAAM,CAAA;AACd,CAAC,CAAA;AAED,MAAM,eAAe,GAAG,CAAC,MAA0B,EAAsB,EAAE;IAC1E,IAAI,MAAM,IAAI,IAAI,EAAE,CAAC;QACpB,OAAO,SAAS,CAAA;IACjB,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3B,MAAM,UAAU,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;QACtE,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC7B,OAAO,SAAS,CAAA;QACjB,CAAC;QACD,OAAO,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IAC5B,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,EAAE,CAAA;IAC7B,OAAO,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAA;AACrC,CAAC,CAAA;AAED,MAAM,cAAc,GAAG,CAAC,KAAyB,EAAwB,EAAE;IAC1E,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC;QACnB,OAAO,SAAS,CAAA;IACjB,CAAC;IAED,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAA;IACrD,MAAM,UAAU,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAA;IACtD,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,EAAE,CAAC;QACpD,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAA;IACvD,CAAC;IAED,OAAO,UAAU,CAAA;AAClB,CAAC,CAAA;AAED,MAAM,kBAAkB,GAAG,CAAC,SAAuC,EAA2C,EAAE;IAC/G,IAAI,SAAS,IAAI,IAAI,EAAE,CAAC;QACvB,OAAO,SAAS,CAAA;IACjB,CAAC;IAED,IAAI,SAAS,KAAK,WAAW,IAAI,SAAS,KAAK,aAAa,EAAE,CAAC;QAC9D,MAAM,IAAI,KAAK,CAAC,4BAA4B,SAAS,EAAE,CAAC,CAAA;IACzD,CAAC;IAED,OAAO,SAAS,CAAA;AACjB,CAAC,CAAA;AAED,MAAM,cAAc,GAAG,CAAC,KAAuB,EAAsB,EAAE;IACtE,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC;QACnB,OAAO,SAAS,CAAA;IACjB,CAAC;IAED,MAAM,UAAU,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,0BAA0B,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,oBAAoB,CAAC,KAAK,CAAC,CAAA;IACvH,IAAI,UAAU,IAAI,IAAI,EAAE,CAAC;QACxB,OAAO,SAAS,CAAA;IACjB,CAAC;IAED,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,UAAU,CAAA;AAC/B,CAAC,CAAA;AAED,MAAM,mBAAmB,GAAG,CAAC,KAAc,EAAsB,EAAE;IAClE,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC;QACnB,OAAO,SAAS,CAAA;IACjB,CAAC;IAED,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAA;IAC5B,OAAO,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAA;AACrC,CAAC,CAAA;AAED,MAAM,yBAAyB,GAAG,CAAC,MAAuB,EAAE,GAAW,EAAE,MAAiB,EAAQ,EAAE;IACnG,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACpC,OAAM;IACP,CAAC;IAED,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC5B,MAAM,UAAU,GAAG,mBAAmB,CAAC,KAAK,CAAC,CAAA;QAC7C,IAAI,CAAC,UAAU,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,WAAW,GAAG,WAAW,KAAK,EAAE,CAAC,CAAA;QAClD,CAAC;QACD,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,UAAU,CAAC,CAAA;IAC/B,CAAC;AACF,CAAC,CAAA;AAED,MAAM,oBAAoB,GAAG,CAAC,KAAa,EAAU,EAAE;IACtD,MAAM,QAAQ,GAAG,eAAe,CAAC,KAAK,CAAC,CAAA;IACvC,IAAI,QAAQ,IAAI,IAAI,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,wBAAwB,KAAK,EAAE,CAAC,CAAA;IACjD,CAAC;IACD,OAAO,QAAQ,CAAA;AAChB,CAAC,CAAA;AAED,MAAM,0BAA0B,GAAG,CAAC,KAAa,EAAE,KAAc,EAAsB,EAAE;IACxF,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC;QACnB,OAAO,SAAS,CAAA;IACjB,CAAC;IAED,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QAC1C,MAAM,IAAI,KAAK,CAAC,WAAW,KAAK,WAAW,KAAK,EAAE,CAAC,CAAA;IACpD,CAAC;IAED,OAAO,KAAK,CAAA;AACb,CAAC,CAAA"}
+{"version":3,"file":"queryParams.js","sourceRoot":"","sources":["../../src/client/queryParams.ts"],"names":[],"mappings":"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"}

package/dist/client/watcherHandle.d.ts

@@ -0,0 +1,9 @@
+import type { ArgusClient, WatcherClient } from '../types.js';
+/**
+ * Build a {@link WatcherClient}: the same API with `watcherId` pre-bound.
+ *
+ * `evalValue` is bound by hand rather than through {@link bind} so its generic
+ * type parameter survives.
+ */
+export declare const createWatcherClient: (client: ArgusClient, watcherId: string) => WatcherClient;
+//# sourceMappingURL=watcherHandle.d.ts.map

package/dist/client/watcherHandle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watcherHandle.d.ts","sourceRoot":"","sources":["../../src/client/watcherHandle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAoB,aAAa,EAAE,MAAM,aAAa,CAAA;AAQ/E;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,GAAI,QAAQ,WAAW,EAAE,WAAW,MAAM,KAAG,aAmB3E,CAAA"}

package/dist/client/watcherHandle.js

@@ -0,0 +1,29 @@
+/** Pre-apply `watcherId` as the first argument of a watcher-scoped method. */
+const bind = (method, watcherId) => (...args) => method(watcherId, ...args);
+/**
+ * Build a {@link WatcherClient}: the same API with `watcherId` pre-bound.
+ *
+ * `evalValue` is bound by hand rather than through {@link bind} so its generic
+ * type parameter survives.
+ */
+export const createWatcherClient = (client, watcherId) => ({
+    logs: bind(client.logs, watcherId),
+    logCursor: bind(client.logCursor, watcherId),
+    beginLogEpoch: bind(client.beginLogEpoch, watcherId),
+    net: bind(client.net, watcherId),
+    netRequest: bind(client.netRequest, watcherId),
+    netClear: bind(client.netClear, watcherId),
+    eval: bind(client.eval, watcherId),
+    evalValue: (expression, options) => client.evalValue(watcherId, expression, options),
+    evalUntil: bind(client.evalUntil, watcherId),
+    domClick: bind(client.domClick, watcherId),
+    visibility: bind(client.visibility, watcherId),
+    reload: bind(client.reload, watcherId),
+    traceStart: bind(client.traceStart, watcherId),
+    traceStop: bind(client.traceStop, watcherId),
+    screenshot: bind(client.screenshot, watcherId),
+    record: bind(client.record, watcherId),
+    recordStart: bind(client.recordStart, watcherId),
+    recordStop: bind(client.recordStop, watcherId),
+});
+//# sourceMappingURL=watcherHandle.js.map

package/dist/client/watcherHandle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"watcherHandle.js","sourceRoot":"","sources":["../../src/client/watcherHandle.ts"],"names":[],"mappings":"AAEA,8EAA8E;AAC9E,MAAM,IAAI,GACT,CAAyB,MAA4C,EAAE,SAAiB,EAAE,EAAE,CAC5F,CAAC,GAAG,IAAO,EAAK,EAAE,CACjB,MAAM,CAAC,SAAS,EAAE,GAAG,IAAI,CAAC,CAAA;AAE5B;;;;;GAKG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,MAAmB,EAAE,SAAiB,EAAiB,EAAE,CAAC,CAAC;IAC9F,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC;IAClC,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,SAAS,CAAC;IAC5C,aAAa,EAAE,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,SAAS,CAAC;IACpD,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,SAAS,CAAC;IAChC,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,SAAS,CAAC;IAC9C,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,SAAS,CAAC;IAC1C,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC;IAClC,SAAS,EAAE,CAAc,UAAkB,EAAE,OAA0B,EAAc,EAAE,CAAC,MAAM,CAAC,SAAS,CAAI,SAAS,EAAE,UAAU,EAAE,OAAO,CAAC;IAC3I,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,SAAS,CAAC;IAC5C,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,SAAS,CAAC;IAC1C,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,SAAS,CAAC;IAC9C,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC;IACtC,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,SAAS,CAAC;IAC9C,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,SAAS,CAAC;IAC5C,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,SAAS,CAAC;IAC9C,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC;IACtC,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,SAAS,CAAC;IAChD,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,SAAS,CAAC;CAC9C,CAAC,CAAA"}

package/dist/client/watcherRequest.d.ts

@@ -1,4 +1,4 @@
-import type { WatcherRecord } from '@vforsh/argus-core';
+import type { WatcherRecord, ResponseData } from '@vforsh/argus-core';
 import type { HttpOptions } from '../http/fetchJson.js';
 type RegistryContext = {
     registryPath?: string;
@@ -16,5 +16,15 @@ export declare const requestWatcher: <T>(context: RegistryContext, watcherId: st
     watcher: WatcherRecord;
     data: T;
 }>;
+/**
+ * Issue a watcher request and return the response payload without its `ok` discriminant.
+ *
+ * SDK methods throw on failure, so the caller already knows `ok` was `true`; stripping it
+ * here means a method never has to re-list the response fields to drop one of them, and a
+ * new protocol field reaches callers without touching the method.
+ */
+export declare const requestWatcherData: <T extends {
+    ok: true;
+}>(context: RegistryContext, watcherId: string, options: WatcherRequestOptions) => Promise<ResponseData<T>>;
 export {};
 //# sourceMappingURL=watcherRequest.d.ts.map

package/dist/client/watcherRequest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"watcherRequest.d.ts","sourceRoot":"","sources":["../../src/client/watcherRequest.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAIvD,KAAK,eAAe,GAAG;IACtB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,KAAK,EAAE,MAAM,CAAA;CACb,CAAA;AAED,KAAK,qBAAqB,GAAG;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,eAAe,CAAA;IACvB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,MAAM,CAAC,EAAE,WAAW,CAAC,QAAQ,CAAC,CAAA;IAC9B,IAAI,CAAC,EAAE,OAAO,CAAA;CACd,CAAA;AAED,eAAO,MAAM,WAAW,GAAU,CAAC,EAAE,SAAS,eAAe,EAAE,WAAW,MAAM,EAAE,UAAU,CAAC,OAAO,EAAE,aAAa,KAAK,OAAO,CAAC,CAAC,CAAC,KAAG,OAAO,CAAC,CAAC,CAQ7I,CAAA;AAED,eAAO,MAAM,cAAc,GAAU,CAAC,EACrC,SAAS,eAAe,EACxB,WAAW,MAAM,EACjB,SAAS,qBAAqB,KAC5B,OAAO,CAAC;IAAE,OAAO,EAAE,aAAa,CAAC;IAAC,IAAI,EAAE,CAAC,CAAA;CAAE,CAa3C,CAAA"}
+{"version":3,"file":"watcherRequest.d.ts","sourceRoot":"","sources":["../../src/client/watcherRequest.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAUrE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAGvD,KAAK,eAAe,GAAG;IACtB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,KAAK,EAAE,MAAM,CAAA;CACb,CAAA;AAED,KAAK,qBAAqB,GAAG;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,eAAe,CAAA;IACvB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,MAAM,CAAC,EAAE,WAAW,CAAC,QAAQ,CAAC,CAAA;IAC9B,IAAI,CAAC,EAAE,OAAO,CAAA;CACd,CAAA;AAED,eAAO,MAAM,WAAW,GAAU,CAAC,EAAE,SAAS,eAAe,EAAE,WAAW,MAAM,EAAE,UAAU,CAAC,OAAO,EAAE,aAAa,KAAK,OAAO,CAAC,CAAC,CAAC,KAAG,OAAO,CAAC,CAAC,CAQ7I,CAAA;AAED,eAAO,MAAM,cAAc,GAAU,CAAC,EACrC,SAAS,eAAe,EACxB,WAAW,MAAM,EACjB,SAAS,qBAAqB,KAC5B,OAAO,CAAC;IAAE,OAAO,EAAE,aAAa,CAAC;IAAC,IAAI,EAAE,CAAC,CAAA;CAAE,CAuB3C,CAAA;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,GAAU,CAAC,SAAS;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,EAC9D,SAAS,eAAe,EACxB,WAAW,MAAM,EACjB,SAAS,qBAAqB,KAC5B,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAIzB,CAAA"}

package/dist/client/watcherRequest.js

@@ -1,5 +1,5 @@
+import { buildWatcherUrl, classifyWatcherFailure, formatError, formatWatcherTransportError, readAndPruneRegistry, removeWatcherAndPersist, shouldEvictWatcherOnFailure, } from '@vforsh/argus-core';
 import { fetchJson } from '../http/fetchJson.js';
-import { readAndPruneRegistry, removeWatcherAndPersist } from '../registry/readAndPruneRegistry.js';
 export const withWatcher = async (context, watcherId, callback) => {
     const registry = await readAndPruneRegistry({ registryPath: context.registryPath, ttlMs: context.ttlMs });
     const watcher = registry.watchers[watcherId];
@@ -18,22 +18,28 @@ export const requestWatcher = async (context, watcherId, options) => withWatcher
         return { watcher, data };
     }
     catch (error) {
-        await removeWatcherAndPersist(watcher.id, context.registryPath);
+        // One classifier and one eviction policy, shared with the CLI: the same outage must not
+        // leave the shared registry in a different state depending on which stack observed it.
+        const failure = classifyWatcherFailure(error);
+        if (failure === 'api-rejection') {
+            throw new Error(`${watcher.id}: ${formatError(error)}`);
+        }
+        if (shouldEvictWatcherOnFailure(failure)) {
+            await removeWatcherAndPersist(watcher.id, context.registryPath);
+        }
         throw new Error(formatWatcherTransportError(watcher, error));
     }
 });
-const buildWatcherUrl = (watcher, path, query) => {
-    const qs = query?.toString();
-    return `http://${watcher.host}:${watcher.port}${path}${qs ? `?${qs}` : ''}`;
-};
-const formatWatcherTransportError = (watcher, error) => `${watcher.id}: failed to reach watcher (${formatUnknownError(error)})`;
-const formatUnknownError = (error) => {
-    if (!error) {
-        return 'unknown error';
-    }
-    if (error instanceof Error) {
-        return error.message;
-    }
-    return String(error);
+/**
+ * Issue a watcher request and return the response payload without its `ok` discriminant.
+ *
+ * SDK methods throw on failure, so the caller already knows `ok` was `true`; stripping it
+ * here means a method never has to re-list the response fields to drop one of them, and a
+ * new protocol field reaches callers without touching the method.
+ */
+export const requestWatcherData = async (context, watcherId, options) => {
+    const { data } = await requestWatcher(context, watcherId, options);
+    const { ok: _ok, ...rest } = data;
+    return rest;
 };
 //# sourceMappingURL=watcherRequest.js.map

package/dist/client/watcherRequest.js.map

@@ -1 +1 @@
-{"version":3,"file":"watcherRequest.js","sourceRoot":"","sources":["../../src/client/watcherRequest.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAA;AAChD,OAAO,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,MAAM,qCAAqC,CAAA;AAenG,MAAM,CAAC,MAAM,WAAW,GAAG,KAAK,EAAK,OAAwB,EAAE,SAAiB,EAAE,QAAgD,EAAc,EAAE;IACjJ,MAAM,QAAQ,GAAG,MAAM,oBAAoB,CAAC,EAAE,YAAY,EAAE,OAAO,CAAC,YAAY,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAA;IACzG,MAAM,OAAO,GAAG,QAAQ,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAA;IAC5C,IAAI,CAAC,OAAO,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,sBAAsB,SAAS,EAAE,CAAC,CAAA;IACnD,CAAC;IAED,OAAO,QAAQ,CAAC,OAAO,CAAC,CAAA;AACzB,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,cAAc,GAAG,KAAK,EAClC,OAAwB,EACxB,SAAiB,EACjB,OAA8B,EACiB,EAAE,CACjD,WAAW,CAAC,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;IACjD,IAAI,CAAC;QACJ,MAAM,IAAI,GAAG,MAAM,SAAS,CAAI,eAAe,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,EAAE;YACtF,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,IAAI,EAAE,OAAO,CAAC,IAAI;SAClB,CAAC,CAAA;QACF,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAA;IACzB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,MAAM,uBAAuB,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC,YAAY,CAAC,CAAA;QAC/D,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAA;IAC7D,CAAC;AACF,CAAC,CAAC,CAAA;AAEH,MAAM,eAAe,GAAG,CAAC,OAA6C,EAAE,IAAY,EAAE,KAAuB,EAAU,EAAE;IACxH,MAAM,EAAE,GAAG,KAAK,EAAE,QAAQ,EAAE,CAAA;IAC5B,OAAO,UAAU,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,IAAI,GAAG,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAA;AAC5E,CAAC,CAAA;AAED,MAAM,2BAA2B,GAAG,CAAC,OAAkC,EAAE,KAAc,EAAU,EAAE,CAClG,GAAG,OAAO,CAAC,EAAE,8BAA8B,kBAAkB,CAAC,KAAK,CAAC,GAAG,CAAA;AAExE,MAAM,kBAAkB,GAAG,CAAC,KAAc,EAAU,EAAE;IACrD,IAAI,CAAC,KAAK,EAAE,CAAC;QACZ,OAAO,eAAe,CAAA;IACvB,CAAC;IACD,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC5B,OAAO,KAAK,CAAC,OAAO,CAAA;IACrB,CAAC;IACD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAA;AACrB,CAAC,CAAA"}
+{"version":3,"file":"watcherRequest.js","sourceRoot":"","sources":["../../src/client/watcherRequest.ts"],"names":[],"mappings":"AACA,OAAO,EACN,eAAe,EACf,sBAAsB,EACtB,WAAW,EACX,2BAA2B,EAC3B,oBAAoB,EACpB,uBAAuB,EACvB,2BAA2B,GAC3B,MAAM,oBAAoB,CAAA;AAE3B,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAA;AAehD,MAAM,CAAC,MAAM,WAAW,GAAG,KAAK,EAAK,OAAwB,EAAE,SAAiB,EAAE,QAAgD,EAAc,EAAE;IACjJ,MAAM,QAAQ,GAAG,MAAM,oBAAoB,CAAC,EAAE,YAAY,EAAE,OAAO,CAAC,YAAY,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAA;IACzG,MAAM,OAAO,GAAG,QAAQ,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAA;IAC5C,IAAI,CAAC,OAAO,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,sBAAsB,SAAS,EAAE,CAAC,CAAA;IACnD,CAAC;IAED,OAAO,QAAQ,CAAC,OAAO,CAAC,CAAA;AACzB,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,cAAc,GAAG,KAAK,EAClC,OAAwB,EACxB,SAAiB,EACjB,OAA8B,EACiB,EAAE,CACjD,WAAW,CAAC,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;IACjD,IAAI,CAAC;QACJ,MAAM,IAAI,GAAG,MAAM,SAAS,CAAI,eAAe,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,EAAE;YACtF,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,IAAI,EAAE,OAAO,CAAC,IAAI;SAClB,CAAC,CAAA;QACF,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAA;IACzB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,wFAAwF;QACxF,uFAAuF;QACvF,MAAM,OAAO,GAAG,sBAAsB,CAAC,KAAK,CAAC,CAAA;QAC7C,IAAI,OAAO,KAAK,eAAe,EAAE,CAAC;YACjC,MAAM,IAAI,KAAK,CAAC,GAAG,OAAO,CAAC,EAAE,KAAK,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;QACxD,CAAC;QAED,IAAI,2BAA2B,CAAC,OAAO,CAAC,EAAE,CAAC;YAC1C,MAAM,uBAAuB,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC,YAAY,CAAC,CAAA;QAChE,CAAC;QAED,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAA;IAC7D,CAAC;AACF,CAAC,CAAC,CAAA;AAEH;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,KAAK,EACtC,OAAwB,EACxB,SAAiB,EACjB,OAA8B,EACH,EAAE;IAC7B,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,cAAc,CAAI,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,CAAA;IACrE,MAAM,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,GAAG,IAAI,CAAA;IACjC,OAAO,IAAI,CAAA;AACZ,CAAC,CAAA"}

package/dist/eval/ArgusEvalError.d.ts

@@ -0,0 +1,30 @@
+/** The page exception shape carried by `EvalResponse.exception`. */
+type EvalException = {
+    text: string;
+    details?: unknown;
+};
+/**
+ * Thrown when an expression raises inside the page.
+ *
+ * Only value-returning eval APIs (`evalValue`, `evalUntil`) throw this. Raw
+ * `client.eval` keeps reporting page exceptions in its `exception` field so callers
+ * can inspect a failure without a try/catch.
+ */
+export declare class ArgusEvalError extends Error {
+    /** Structured exception detail from the page, when the transport provided one. */
+    readonly details?: unknown;
+    /**
+     * @param text Page-side exception text, used as the error message.
+     * @param details Optional structured exception detail from CDP.
+     */
+    constructor(text: string, details?: unknown);
+    /**
+     * Build an error from a watcher exception payload.
+     *
+     * CDP reports `text` as a bare `"Uncaught"` for thrown errors and puts the real
+     * message plus stack in `details.description`, so prefer that when present.
+     */
+    static fromException(exception: EvalException): ArgusEvalError;
+}
+export {};
+//# sourceMappingURL=ArgusEvalError.d.ts.map

package/dist/eval/ArgusEvalError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ArgusEvalError.d.ts","sourceRoot":"","sources":["../../src/eval/ArgusEvalError.ts"],"names":[],"mappings":"AAAA,oEAAoE;AACpE,KAAK,aAAa,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAA;AAExD;;;;;;GAMG;AACH,qBAAa,cAAe,SAAQ,KAAK;IACxC,kFAAkF;IAClF,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAA;IAE1B;;;OAGG;gBACS,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO;IAM3C;;;;;OAKG;IACH,MAAM,CAAC,aAAa,CAAC,SAAS,EAAE,aAAa,GAAG,cAAc;CAG9D"}

package/dist/eval/ArgusEvalError.js

@@ -0,0 +1,37 @@
+/**
+ * Thrown when an expression raises inside the page.
+ *
+ * Only value-returning eval APIs (`evalValue`, `evalUntil`) throw this. Raw
+ * `client.eval` keeps reporting page exceptions in its `exception` field so callers
+ * can inspect a failure without a try/catch.
+ */
+export class ArgusEvalError extends Error {
+    /** Structured exception detail from the page, when the transport provided one. */
+    details;
+    /**
+     * @param text Page-side exception text, used as the error message.
+     * @param details Optional structured exception detail from CDP.
+     */
+    constructor(text, details) {
+        super(text);
+        this.name = 'ArgusEvalError';
+        this.details = details;
+    }
+    /**
+     * Build an error from a watcher exception payload.
+     *
+     * CDP reports `text` as a bare `"Uncaught"` for thrown errors and puts the real
+     * message plus stack in `details.description`, so prefer that when present.
+     */
+    static fromException(exception) {
+        return new ArgusEvalError(readExceptionDescription(exception.details) ?? exception.text, exception.details);
+    }
+}
+const readExceptionDescription = (details) => {
+    if (details == null || typeof details !== 'object' || !('description' in details)) {
+        return undefined;
+    }
+    const { description } = details;
+    return typeof description === 'string' && description.trim() ? description : undefined;
+};
+//# sourceMappingURL=ArgusEvalError.js.map

package/dist/eval/ArgusEvalError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ArgusEvalError.js","sourceRoot":"","sources":["../../src/eval/ArgusEvalError.ts"],"names":[],"mappings":"AAGA;;;;;;GAMG;AACH,MAAM,OAAO,cAAe,SAAQ,KAAK;IACxC,kFAAkF;IACzE,OAAO,CAAU;IAE1B;;;OAGG;IACH,YAAY,IAAY,EAAE,OAAiB;QAC1C,KAAK,CAAC,IAAI,CAAC,CAAA;QACX,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAA;QAC5B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;IACvB,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,aAAa,CAAC,SAAwB;QAC5C,OAAO,IAAI,cAAc,CAAC,wBAAwB,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,SAAS,CAAC,IAAI,EAAE,SAAS,CAAC,OAAO,CAAC,CAAA;IAC5G,CAAC;CACD;AAED,MAAM,wBAAwB,GAAG,CAAC,OAAgB,EAAsB,EAAE;IACzE,IAAI,OAAO,IAAI,IAAI,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,CAAC,CAAC,aAAa,IAAI,OAAO,CAAC,EAAE,CAAC;QACnF,OAAO,SAAS,CAAA;IACjB,CAAC;IAED,MAAM,EAAE,WAAW,EAAE,GAAG,OAAoC,CAAA;IAC5D,OAAO,OAAO,WAAW,KAAK,QAAQ,IAAI,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAA;AACvF,CAAC,CAAA"}

package/dist/eval/pollEval.d.ts

@@ -0,0 +1,81 @@
+/**
+ * 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.
+ */
+/** Per-iteration context handed to stop conditions and result observers. */
+export type EvalPollContext<TResponse> = {
+    response: TResponse;
+    /** 1-based poll iteration. */
+    iteration: number;
+    /** 1-based attempt number within the iteration, when the caller retries. */
+    attempt: number;
+};
+/** Verdict from a stop condition: matched, not matched, or the condition itself failed. */
+export type EvalPollStopDecision = {
+    ok: true;
+    matched: boolean;
+} | {
+    ok: false;
+    error: string;
+};
+/** Outcome of one injected eval attempt. */
+export type EvalPollAttempt<TResponse, TFailure> = {
+    ok: true;
+    response: TResponse;
+    attempt: number;
+} | {
+    ok: false;
+    failure: TFailure;
+    attempt: number;
+};
+/** Inputs for {@link pollEval}. */
+export type EvalPollInput<TResponse, TFailure> = {
+    /** Perform one eval. Callers wrap their own retry policy in here. */
+    runEval: (iteration: number) => Promise<EvalPollAttempt<TResponse, TFailure>>;
+    /** Delay between polls in milliseconds. */
+    intervalMs: number;
+    /** Stop after this many polls. Unlimited when omitted. */
+    count?: number;
+    /** Give up after this much wall-clock time. Unlimited when omitted. */
+    totalTimeoutMs?: number;
+    /** Decide whether to stop. Omitted means "never match" — useful for streaming. */
+    shouldStop?: (context: EvalPollContext<TResponse>) => EvalPollStopDecision;
+    /** Observe every result, including the matching one. */
+    onResult?: (response: TResponse, context: EvalPollContext<TResponse>) => void | Promise<void>;
+    /** Cancel the loop. Yields an `interrupted` outcome rather than throwing. */
+    signal?: AbortSignal;
+};
+/** Terminal state of a poll loop. */
+export type EvalPollOutcome<TResponse, TFailure> = {
+    kind: 'matched';
+    response: TResponse;
+    iteration: number;
+    attempt: number;
+} | {
+    kind: 'exhausted';
+    iterations: number;
+} | {
+    kind: 'timeout';
+    elapsedMs: number;
+} | {
+    kind: 'interrupted';
+} | {
+    kind: 'eval-error';
+    failure: TFailure;
+} | {
+    kind: 'condition-error';
+    error: string;
+};
+/**
+ * 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 declare const pollEval: <TResponse, TFailure>(input: EvalPollInput<TResponse, TFailure>) => Promise<EvalPollOutcome<TResponse, TFailure>>;
+//# sourceMappingURL=pollEval.d.ts.map

package/dist/eval/pollEval.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pollEval.d.ts","sourceRoot":"","sources":["../../src/eval/pollEval.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,4EAA4E;AAC5E,MAAM,MAAM,eAAe,CAAC,SAAS,IAAI;IACxC,QAAQ,EAAE,SAAS,CAAA;IACnB,8BAA8B;IAC9B,SAAS,EAAE,MAAM,CAAA;IACjB,4EAA4E;IAC5E,OAAO,EAAE,MAAM,CAAA;CACf,CAAA;AAED,2FAA2F;AAC3F,MAAM,MAAM,oBAAoB,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAA;AAEhG,4CAA4C;AAC5C,MAAM,MAAM,eAAe,CAAC,SAAS,EAAE,QAAQ,IAC5C;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAClD;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAA;AAEpD,mCAAmC;AACnC,MAAM,MAAM,aAAa,CAAC,SAAS,EAAE,QAAQ,IAAI;IAChD,qEAAqE;IACrE,OAAO,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,eAAe,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAA;IAC7E,2CAA2C;IAC3C,UAAU,EAAE,MAAM,CAAA;IAClB,0DAA0D;IAC1D,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,uEAAuE;IACvE,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,kFAAkF;IAClF,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,eAAe,CAAC,SAAS,CAAC,KAAK,oBAAoB,CAAA;IAC1E,wDAAwD;IACxD,QAAQ,CAAC,EAAE,CAAC,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,eAAe,CAAC,SAAS,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC7F,6EAA6E;IAC7E,MAAM,CAAC,EAAE,WAAW,CAAA;CACpB,CAAA;AAED,qCAAqC;AACrC,MAAM,MAAM,eAAe,CAAC,SAAS,EAAE,QAAQ,IAC5C;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,EAAE,SAAS,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAC5E;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GACzC;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACtC;IAAE,IAAI,EAAE,aAAa,CAAA;CAAE,GACvB;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,OAAO,EAAE,QAAQ,CAAA;CAAE,GACzC;IAAE,IAAI,EAAE,iBAAiB,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAA;AAE7C;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,GAAU,SAAS,EAAE,QAAQ,EAAE,OAAO,aAAa,CAAC,SAAS,EAAE,QAAQ,CAAC,KAAG,OAAO,CAAC,eAAe,CAAC,SAAS,EAAE,QAAQ,CAAC,CAwC3I,CAAA"}