@vforsh/argus-watcher 0.1.11 → 0.1.13

package/dist/cdp/visualCapture.js

@@ -0,0 +1,156 @@
+import { resolveFirstSelectorNodeId } from './dom/selector.js';
+/**
+ * Resolve a viewport/selector/clip request into the top-level page session that can capture pixels.
+ * Frame targets use their selected frame session for DOM lookup, then translate the clip to page pixels.
+ */
+export const createVisualCapturePlan = async (session, pageSession, request) => {
+    const subject = resolveVisualCaptureSubject(request);
+    const targetContext = session.getTargetContext?.();
+    if (targetContext?.kind === 'frame' && pageSession) {
+        return createFrameCapturePlan({
+            frameSession: session,
+            pageSession,
+            frameContext: targetContext,
+            subject,
+        });
+    }
+    const clip = await resolveSubjectClip(session, subject);
+    if (!clip) {
+        return { session };
+    }
+    return {
+        session,
+        clip,
+        viewport: await resolveViewportSize(session),
+    };
+};
+const createFrameCapturePlan = async (options) => {
+    const frameClip = await resolveFrameViewportClip(options.pageSession, options.frameContext.frameId);
+    const pageViewport = await resolveViewportSize(options.pageSession);
+    const subjectClip = await resolveSubjectClip(options.frameSession, options.subject);
+    if (!subjectClip) {
+        return {
+            session: options.pageSession,
+            clip: frameClip,
+            viewport: pageViewport,
+        };
+    }
+    return {
+        session: options.pageSession,
+        clip: offsetClip(frameClip, subjectClip),
+        viewport: pageViewport,
+    };
+};
+const resolveFrameViewportClip = async (pageSession, frameId) => {
+    const owner = (await pageSession.sendAndWait('DOM.getFrameOwner', {
+        frameId,
+    }));
+    if (owner.backendNodeId == null && owner.nodeId == null) {
+        throw new Error(`Unable to resolve iframe owner for frame: ${frameId}`);
+    }
+    return resolveNodeClip(pageSession, owner);
+};
+const resolveSelectorClip = async (session, selector) => {
+    const nodeId = await resolveFirstSelectorNodeId(session, selector);
+    if (!nodeId) {
+        throw new Error(`No element found for selector: ${selector}`);
+    }
+    return resolveNodeClip(session, { nodeId });
+};
+const resolveSubjectClip = async (session, subject) => {
+    switch (subject.kind) {
+        case 'viewport':
+            return null;
+        case 'selector':
+            return resolveSelectorClip(session, subject.selector);
+        case 'clip':
+            return resolveViewportRectClip(session, subject.clip);
+    }
+};
+export const resolveVisualCaptureSubject = (request) => {
+    if (request.selector) {
+        return { kind: 'selector', selector: request.selector };
+    }
+    if (request.clip) {
+        return { kind: 'clip', clip: request.clip };
+    }
+    return { kind: 'viewport' };
+};
+const resolveViewportRectClip = async (session, clip) => {
+    const viewport = await resolveVisualViewport(session);
+    return {
+        x: clip.x,
+        y: clip.y,
+        width: clip.width,
+        height: clip.height,
+        // CDP clip rectangles always need the current viewport scale, even when x/y are already viewport-relative.
+        scale: viewport?.scale ?? 1,
+    };
+};
+const resolveNodeClip = async (session, target) => {
+    const boxResult = await session.sendAndWait('DOM.getBoxModel', target.nodeId != null ? { nodeId: target.nodeId } : { backendNodeId: target.backendNodeId });
+    const quad = boxResult.model?.content ??
+        boxResult.model?.border;
+    if (!quad || quad.length < 8) {
+        throw new Error('Unable to compute element box model');
+    }
+    const rect = quadToRect(quad);
+    if (rect.width <= 0 || rect.height <= 0) {
+        throw new Error('Element has zero area');
+    }
+    const viewport = await resolveVisualViewport(session);
+    const pageX = viewport?.pageX ?? 0;
+    const pageY = viewport?.pageY ?? 0;
+    const scale = viewport?.scale ?? 1;
+    return {
+        x: rect.x - pageX,
+        y: rect.y - pageY,
+        width: rect.width,
+        height: rect.height,
+        scale,
+    };
+};
+const resolveVisualViewport = async (session) => {
+    const metrics = await session.sendAndWait('Page.getLayoutMetrics');
+    const payload = metrics;
+    return payload.cssVisualViewport ?? payload.visualViewport;
+};
+const resolveViewportSize = async (session) => {
+    const viewport = await resolveVisualViewport(session);
+    if (isPositiveFiniteNumber(viewport?.clientWidth) && isPositiveFiniteNumber(viewport?.clientHeight)) {
+        return { width: viewport.clientWidth, height: viewport.clientHeight };
+    }
+    const evaluated = (await session.sendAndWait('Runtime.evaluate', {
+        expression: '({width: window.visualViewport?.width ?? window.innerWidth, height: window.visualViewport?.height ?? window.innerHeight})',
+        returnByValue: true,
+    }));
+    const width = evaluated.result?.value?.width;
+    const height = evaluated.result?.value?.height;
+    if (!isPositiveFiniteNumber(width) || !isPositiveFiniteNumber(height)) {
+        throw new Error('Unable to compute viewport size');
+    }
+    return { width, height };
+};
+const isPositiveFiniteNumber = (value) => typeof value === 'number' && Number.isFinite(value) && value > 0;
+const offsetClip = (outer, inner) => ({
+    x: outer.x + inner.x,
+    y: outer.y + inner.y,
+    width: inner.width,
+    height: inner.height,
+    scale: outer.scale,
+});
+const quadToRect = (quad) => {
+    const xs = [quad[0], quad[2], quad[4], quad[6]];
+    const ys = [quad[1], quad[3], quad[5], quad[7]];
+    const minX = Math.min(...xs);
+    const maxX = Math.max(...xs);
+    const minY = Math.min(...ys);
+    const maxY = Math.max(...ys);
+    return {
+        x: minX,
+        y: minY,
+        width: maxX - minX,
+        height: maxY - minY,
+    };
+};
+//# sourceMappingURL=visualCapture.js.map

package/dist/cdp/visualCapture.js.map

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

package/dist/events.d.ts

@@ -92,7 +92,7 @@ export type HttpRequestEvent = {
     /** Unique watcher identifier. */
     watcherId: string;
     /** The requested endpoint. */
-    endpoint: 'logs' | 'tail' | 'net' | 'net/requests' | 'net/request' | 'net/request/body' | 'net/tail' | 'net/clear' | 'net/ws' | 'net/ws/connection' | 'net/sse' | 'auth/cookies' | 'auth/cookies/get' | 'auth/cookies/set' | 'auth/cookies/delete' | 'auth/cookies/clear' | 'auth/state' | 'auth/state/load' | 'eval' | 'trace/start' | 'trace/stop' | 'screenshot' | 'snapshot' | 'locate/role' | 'locate/text' | 'locate/label' | 'code/list' | 'code/read' | 'code/grep' | 'code/edit' | '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' | 'dialog/status' | 'dialog/handle' | 'visibility' | 'storage/local' | 'storage/session' | 'reload' | 'shutdown' | 'tabs' | 'targets' | 'attach' | 'detach';
+    endpoint: 'logs' | 'tail' | 'net' | 'net/requests' | 'net/request' | 'net/request/body' | 'net/tail' | 'net/clear' | 'net/mock' | 'net/mock/add' | 'net/mock/remove' | 'net/mock/clear' | 'net/ws' | 'net/ws/connection' | 'net/sse' | 'auth/cookies' | 'auth/cookies/get' | 'auth/cookies/set' | 'auth/cookies/delete' | 'auth/cookies/clear' | 'auth/state' | 'auth/state/load' | 'eval' | 'trace/start' | 'trace/stop' | 'record' | 'record/start' | 'record/stop' | 'screenshot' | 'snapshot' | 'locate/role' | 'locate/text' | 'locate/label' | 'code/list' | 'code/read' | 'code/grep' | 'code/edit' | 'dom/tree' | 'dom/info' | 'dom/hover' | 'dom/click' | 'dom/drag' | 'dom/keydown' | 'dom/add' | 'dom/remove' | 'dom/modify' | 'dom/set-file' | 'dom/focus' | 'dom/fill' | 'dom/scroll' | 'dom/scroll-to' | 'emulation' | 'throttle' | 'dialog/status' | 'dialog/handle' | 'visibility' | 'storage/local' | 'storage/session' | 'reload' | 'shutdown' | 'tabs' | 'extension/diagnostics' | 'targets' | 'attach' | 'detach';
     /** IP address of the requester (best-effort). */
     remoteAddress: string | null;
     /** Parsed query parameters. */

package/dist/events.d.ts.map

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

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

@@ -1,11 +1,6 @@
-import { type AuthCookieClearRequest, type AuthCookieDeleteRequest, type AuthCookieGetRequest, type AuthCookieSetRequest } from '@vforsh/argus-core';
-import type { RouteHandler } from './types.js';
-export declare const validateCookieGetPayload: (payload: AuthCookieGetRequest) => string | null;
-export declare const validateCookieDeletePayload: (payload: AuthCookieDeleteRequest) => string | null;
-export declare const validateCookieSetPayload: (payload: AuthCookieSetRequest) => string | null;
-export declare const validateCookieClearPayload: (payload: AuthCookieClearRequest) => string | null;
-export declare const handleCookieGet: RouteHandler;
-export declare const handleCookieSet: RouteHandler;
-export declare const handleCookieDelete: RouteHandler;
-export declare const handleCookieClear: RouteHandler;
+import type { WatcherRouteDefinition } from './defineRoute.js';
+export declare const cookieGetRoute: WatcherRouteDefinition;
+export declare const cookieSetRoute: WatcherRouteDefinition;
+export declare const cookieDeleteRoute: WatcherRouteDefinition;
+export declare const cookieClearRoute: WatcherRouteDefinition;
 //# sourceMappingURL=authCookies.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"authCookies.d.ts","sourceRoot":"","sources":["../../../src/http/routes/authCookies.ts"],"names":[],"mappings":"AAAA,OAAO,EAGN,KAAK,sBAAsB,EAG3B,KAAK,uBAAuB,EAE5B,KAAK,oBAAoB,EAEzB,KAAK,oBAAoB,EAEzB,MAAM,oBAAoB,CAAA;AAC3B,OAAO,KAAK,EAAgB,YAAY,EAAE,MAAM,YAAY,CAAA;AAO5D,eAAO,MAAM,wBAAwB,GAAI,SAAS,oBAAoB,KAAG,MAAM,GAAG,IAWjF,CAAA;AAED,eAAO,MAAM,2BAA2B,GAAI,SAAS,uBAAuB,KAAG,MAAM,GAAG,IAA8C,CAAA;AAEtI,eAAO,MAAM,wBAAwB,GAAI,SAAS,oBAAoB,KAAG,MAAM,GAAG,IA0CjF,CAAA;AAED,eAAO,MAAM,0BAA0B,GAAI,SAAS,sBAAsB,KAAG,MAAM,GAAG,IAkBrF,CAAA;AA8CD,eAAO,MAAM,eAAe,cAQ1B,CAAA;AAEF,eAAO,MAAM,eAAe,cAQ1B,CAAA;AAEF,eAAO,MAAM,kBAAkB,cAQ7B,CAAA;AAEF,eAAO,MAAM,iBAAiB,cAQ5B,CAAA"}
+{"version":3,"file":"authCookies.d.ts","sourceRoot":"","sources":["../../../src/http/routes/authCookies.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAA;AAoH9D,eAAO,MAAM,cAAc,wBAQzB,CAAA;AAEF,eAAO,MAAM,cAAc,wBAQzB,CAAA;AAEF,eAAO,MAAM,iBAAiB,wBAQ5B,CAAA;AAEF,eAAO,MAAM,gBAAgB,wBAQ3B,CAAA"}

package/dist/http/routes/authCookies.js

@@ -1,9 +1,8 @@
 import { normalizeCookieDomainFilter, normalizeCookieSameSite, } from '@vforsh/argus-core';
-import { emitRequest } from './types.js';
 import { clearAuthCookies, deleteAuthCookie, inspectAuthCookie, setAuthCookie } from '../../cdp/auth.js';
-import { readJsonBody, respondError, respondInvalidBody, respondJson } from '../httpUtils.js';
+import { defineJsonRoute } from './defineRoute.js';
 const CLEAR_SCOPES = new Set(['origin', 'site', 'domain', 'browserContext']);
-export const validateCookieGetPayload = (payload) => {
+const validateCookieGetPayload = (payload) => {
     const identityError = validateCookieIdentityPayload(payload);
     if (identityError) {
         return identityError;
@@ -13,8 +12,8 @@ export const validateCookieGetPayload = (payload) => {
     }
     return null;
 };
-export const validateCookieDeletePayload = (payload) => validateCookieIdentityPayload(payload);
-export const validateCookieSetPayload = (payload) => {
+const validateCookieDeletePayload = (payload) => validateCookieIdentityPayload(payload);
+const validateCookieSetPayload = (payload) => {
     if (!payload.cookie || typeof payload.cookie !== 'object') {
         return 'cookie is required';
     }
@@ -54,7 +53,7 @@ export const validateCookieSetPayload = (payload) => {
     }
     return null;
 };
-export const validateCookieClearPayload = (payload) => {
+const validateCookieClearPayload = (payload) => {
     if (!CLEAR_SCOPES.has(payload.scope)) {
         return 'scope must be one of: origin, site, domain, browserContext';
     }
@@ -72,26 +71,14 @@ export const validateCookieClearPayload = (payload) => {
     }
     return null;
 };
-const createAuthCookieRoute = (options) => {
-    return async (req, res, _url, ctx) => {
-        const payload = await readJsonBody(req, res);
-        if (!payload) {
-            return;
-        }
-        const validationError = options.validate(payload);
-        if (validationError) {
-            respondInvalidBody(res, validationError);
-            return;
-        }
-        emitRequest(ctx, res, options.endpoint);
-        try {
-            respondJson(res, await options.run(payload, ctx));
-        }
-        catch (error) {
-            respondError(res, error);
-        }
-    };
-};
+const createAuthCookieRoute = (options) => defineJsonRoute({
+    method: 'POST',
+    path: `/${options.endpoint}`,
+    parseBody: true,
+    endpoint: options.endpoint,
+    validate: options.validate,
+    handle: ({ ctx, body: payload }) => options.run(payload, ctx),
+});
 const validateCookieIdentityPayload = (payload) => {
     if (typeof payload.name !== 'string' || payload.name.trim() === '') {
         return 'name is required';
@@ -107,7 +94,7 @@ const validateCookieIdentityPayload = (payload) => {
     }
     return null;
 };
-export const handleCookieGet = createAuthCookieRoute({
+export const cookieGetRoute = createAuthCookieRoute({
     endpoint: 'auth/cookies/get',
     validate: validateCookieGetPayload,
     run: (payload, ctx) => inspectAuthCookie(ctx.cdpSession, {
@@ -115,7 +102,7 @@ export const handleCookieGet = createAuthCookieRoute({
         readBrowserCookies: ctx.readBrowserCookies,
     }),
 });
-export const handleCookieSet = createAuthCookieRoute({
+export const cookieSetRoute = createAuthCookieRoute({
     endpoint: 'auth/cookies/set',
     validate: validateCookieSetPayload,
     run: (payload, ctx) => setAuthCookie(ctx.cdpSession, {
@@ -123,7 +110,7 @@ export const handleCookieSet = createAuthCookieRoute({
         readBrowserCookies: ctx.readBrowserCookies,
     }),
 });
-export const handleCookieDelete = createAuthCookieRoute({
+export const cookieDeleteRoute = createAuthCookieRoute({
     endpoint: 'auth/cookies/delete',
     validate: validateCookieDeletePayload,
     run: (payload, ctx) => deleteAuthCookie(ctx.cdpSession, {
@@ -131,7 +118,7 @@ export const handleCookieDelete = createAuthCookieRoute({
         readBrowserCookies: ctx.readBrowserCookies,
     }),
 });
-export const handleCookieClear = createAuthCookieRoute({
+export const cookieClearRoute = createAuthCookieRoute({
     endpoint: 'auth/cookies/clear',
     validate: validateCookieClearPayload,
     run: (payload, ctx) => clearAuthCookies(ctx.cdpSession, {

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

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

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

@@ -1,27 +1,35 @@
+import type { HttpRequestEventMetadata } from '../server.js';
 import type { DomNodeHandle } from '../../cdp/dom/selector.js';
 import type { WatcherRouteDefinition } from './defineRoute.js';
 import type { RouteContext } from './types.js';
 /**
  * Body shape required by `defineDomTargetRoute`. Routes that need extra fields
- * (e.g. `wait`, `value`) extend this type.
+ * (e.g. `value`) extend this type.
  */
 export type DomTargetRequestBody = {
     selector?: string;
     ref?: string;
     all?: boolean;
     text?: string;
+    /** Optional bounded wait (ms) for the selector to match before resolving. */
+    wait?: number;
 };
 type DomTargetRouteInput<TBody extends DomTargetRequestBody, TExtra extends object> = {
     method?: 'POST';
     path: string;
     /** Endpoint label used by `emitRequest`. */
-    endpoint: string;
+    endpoint: HttpRequestEventMetadata['endpoint'];
     /**
      * Verb used in the "Selector matched N elements; pass all=true to {action}…"
      * error message returned when the request matches more than one node and
      * `all` is false.
      */
     action: string;
+    /**
+     * Extra body validation, run after the shared selector/ref/all checks.
+     * Returns an error message to respond 400 `invalid_request`, or null.
+     */
+    validate?: (payload: TBody) => string | null;
     /**
      * Run the DOM action against the resolved handles. Receives both the
      * "filtered" handles (subject to `text`/`all`) and `allHandles` for routes
@@ -40,10 +48,11 @@ type DomTargetRouteInput<TBody extends DomTargetRequestBody, TExtra extends obje
 };
 /**
  * Build a `WatcherRouteDefinition` for routes that resolve an element target
- * (selector/ref + text/all) and perform a DOM action.
+ * (selector/ref + text/all/wait) and perform a DOM action.
  *
- * Centralizes the body-parse → emit → resolve → handle multiple/missing
- * → run → respond pipeline shared by hover/focus and similar routes.
+ * Centralizes the body-parse → validate → emit → resolve → handle
+ * multiple/missing → run → respond pipeline shared by hover/focus/fill and
+ * similar routes.
  */
 export declare const defineDomTargetRoute: <TBody extends DomTargetRequestBody, TExtra extends object>(input: DomTargetRouteInput<TBody, TExtra>) => WatcherRouteDefinition;
 export {};

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

@@ -1 +1 @@
-{"version":3,"file":"defineDomTargetRoute.d.ts","sourceRoot":"","sources":["../../../src/http/routes/defineDomTargetRoute.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAA;AAC9D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAA;AAC9D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAM9C;;;GAGG;AACH,MAAM,MAAM,oBAAoB,GAAG;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,GAAG,CAAC,EAAE,OAAO,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;CACb,CAAA;AAED,KAAK,mBAAmB,CAAC,KAAK,SAAS,oBAAoB,EAAE,MAAM,SAAS,MAAM,IAAI;IACrF,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;IACZ,4CAA4C;IAC5C,QAAQ,EAAE,MAAM,CAAA;IAChB;;;;OAIG;IACH,MAAM,EAAE,MAAM,CAAA;IACd;;;;;;;;OAQG;IACH,GAAG,EAAE,CAAC,KAAK,EAAE;QAAE,OAAO,EAAE,aAAa,EAAE,CAAC;QAAC,UAAU,EAAE,aAAa,EAAE,CAAC;QAAC,OAAO,EAAE,KAAK,CAAC;QAAC,GAAG,EAAE,YAAY,CAAA;KAAE,KAAK,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM,CAAA;CACtI,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,GAAI,KAAK,SAAS,oBAAoB,EAAE,MAAM,SAAS,MAAM,EAC7F,OAAO,mBAAmB,CAAC,KAAK,EAAE,MAAM,CAAC,KACvC,sBAiCD,CAAA"}
+{"version":3,"file":"defineDomTargetRoute.d.ts","sourceRoot":"","sources":["../../../src/http/routes/defineDomTargetRoute.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAA;AAC5D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAA;AAC9D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAA;AAC9D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAK9C;;;GAGG;AACH,MAAM,MAAM,oBAAoB,GAAG;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,GAAG,CAAC,EAAE,OAAO,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,6EAA6E;IAC7E,IAAI,CAAC,EAAE,MAAM,CAAA;CACb,CAAA;AAED,KAAK,mBAAmB,CAAC,KAAK,SAAS,oBAAoB,EAAE,MAAM,SAAS,MAAM,IAAI;IACrF,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;IACZ,4CAA4C;IAC5C,QAAQ,EAAE,wBAAwB,CAAC,UAAU,CAAC,CAAA;IAC9C;;;;OAIG;IACH,MAAM,EAAE,MAAM,CAAA;IACd;;;OAGG;IACH,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,KAAK,KAAK,MAAM,GAAG,IAAI,CAAA;IAC5C;;;;;;;;OAQG;IACH,GAAG,EAAE,CAAC,KAAK,EAAE;QAAE,OAAO,EAAE,aAAa,EAAE,CAAC;QAAC,UAAU,EAAE,aAAa,EAAE,CAAC;QAAC,OAAO,EAAE,KAAK,CAAC;QAAC,GAAG,EAAE,YAAY,CAAA;KAAE,KAAK,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM,CAAA;CACtI,CAAA;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,oBAAoB,GAAI,KAAK,SAAS,oBAAoB,EAAE,MAAM,SAAS,MAAM,EAC7F,OAAO,mBAAmB,CAAC,KAAK,EAAE,MAAM,CAAC,KACvC,sBA6BA,CAAA"}

package/dist/http/routes/defineDomTargetRoute.js

@@ -1,45 +1,39 @@
 import { resolveElementTargets } from '../../cdp/dom/selector.js';
-import { respondError, respondJson } from '../httpUtils.js';
-import { readDomTargetPayload, respondMissingElementRef, respondMultipleMatches, respondTargetResolutionError } from './domSelectorRoute.js';
-import { emitRequest } from './types.js';
+import { defineJsonRoute } from './defineRoute.js';
+import { respondMissingElementRef, respondMultipleMatches, respondTargetResolutionError, validateDomTargetBody } from './domSelectorRoute.js';
 /**
  * Build a `WatcherRouteDefinition` for routes that resolve an element target
- * (selector/ref + text/all) and perform a DOM action.
+ * (selector/ref + text/all/wait) and perform a DOM action.
  *
- * Centralizes the body-parse → emit → resolve → handle multiple/missing
- * → run → respond pipeline shared by hover/focus and similar routes.
+ * Centralizes the body-parse → validate → emit → resolve → handle
+ * multiple/missing → run → respond pipeline shared by hover/focus/fill and
+ * similar routes.
  */
-export const defineDomTargetRoute = (input) => ({
+export const defineDomTargetRoute = (input) => defineJsonRoute({
     method: input.method ?? 'POST',
     path: input.path,
-    handler: async (req, res, _url, ctx) => {
-        const parsed = await readDomTargetPayload(req, res);
-        if (!parsed)
-            return;
-        const { payload, all } = parsed;
-        emitRequest(ctx, res, input.endpoint);
-        try {
-            const resolved = await resolveElementTargets(ctx.cdpSession, ctx.elementRefs, {
-                selector: payload.selector,
-                ref: payload.ref,
-                all,
-                text: payload.text,
-            });
-            if (resolved.missingRef && payload.ref) {
-                return respondMissingElementRef(res, payload.ref);
-            }
-            const { allHandles, handles } = resolved;
-            if (!all && allHandles.length > 1) {
-                return respondMultipleMatches(res, allHandles.length, input.action);
-            }
-            const extra = await input.run({ handles, allHandles, payload, ctx });
-            respondJson(res, { ok: true, matches: allHandles.length, ...extra });
+    parseBody: true,
+    endpoint: input.endpoint,
+    validate: (payload) => validateDomTargetBody(payload) ?? input.validate?.(payload) ?? null,
+    handle: async ({ res, ctx, body: payload }) => {
+        const all = payload.all ?? false;
+        const resolved = await resolveElementTargets(ctx.cdpSession, ctx.elementRefs, {
+            selector: payload.selector,
+            ref: payload.ref,
+            all,
+            text: payload.text,
+            waitMs: payload.wait,
+        });
+        if (resolved.missingRef && payload.ref) {
+            return respondMissingElementRef(res, payload.ref);
         }
-        catch (error) {
-            if (respondTargetResolutionError(res, error))
-                return;
-            respondError(res, error);
+        const { allHandles, handles } = resolved;
+        if (!all && allHandles.length > 1) {
+            return respondMultipleMatches(res, allHandles.length, input.action);
         }
+        const extra = await input.run({ handles, allHandles, payload, ctx });
+        return { ok: true, matches: allHandles.length, ...extra };
     },
+    handleError: respondTargetResolutionError,
 });
 //# sourceMappingURL=defineDomTargetRoute.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"defineDomTargetRoute.js","sourceRoot":"","sources":["../../../src/http/routes/defineDomTargetRoute.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAA;AACjE,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAC3D,OAAO,EAAE,oBAAoB,EAAE,wBAAwB,EAAE,sBAAsB,EAAE,4BAA4B,EAAE,MAAM,uBAAuB,CAAA;AAC5I,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAoCxC;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CACnC,KAAyC,EAChB,EAAE,CAAC,CAAC;IAC7B,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,MAAM;IAC9B,IAAI,EAAE,KAAK,CAAC,IAAI;IAChB,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;QACtC,MAAM,MAAM,GAAG,MAAM,oBAAoB,CAAQ,GAAG,EAAE,GAAG,CAAC,CAAA;QAC1D,IAAI,CAAC,MAAM;YAAE,OAAM;QAEnB,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,MAAM,CAAA;QAC/B,WAAW,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,CAAC,QAA6C,CAAC,CAAA;QAE1E,IAAI,CAAC;YACJ,MAAM,QAAQ,GAAG,MAAM,qBAAqB,CAAC,GAAG,CAAC,UAAU,EAAE,GAAG,CAAC,WAAW,EAAE;gBAC7E,QAAQ,EAAE,OAAO,CAAC,QAAQ;gBAC1B,GAAG,EAAE,OAAO,CAAC,GAAG;gBAChB,GAAG;gBACH,IAAI,EAAE,OAAO,CAAC,IAAI;aAClB,CAAC,CAAA;YACF,IAAI,QAAQ,CAAC,UAAU,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;gBACxC,OAAO,wBAAwB,CAAC,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC,CAAA;YAClD,CAAC;YAED,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,QAAQ,CAAA;YACxC,IAAI,CAAC,GAAG,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACnC,OAAO,sBAAsB,CAAC,GAAG,EAAE,UAAU,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;YACpE,CAAC;YAED,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,CAAA;YACpE,WAAW,CAAC,GAAG,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,UAAU,CAAC,MAAM,EAAE,GAAG,KAAK,EAAE,CAAC,CAAA;QACrE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,IAAI,4BAA4B,CAAC,GAAG,EAAE,KAAK,CAAC;gBAAE,OAAM;YACpD,YAAY,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;QACzB,CAAC;IACF,CAAC;CACD,CAAC,CAAA"}
+{"version":3,"file":"defineDomTargetRoute.js","sourceRoot":"","sources":["../../../src/http/routes/defineDomTargetRoute.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAA;AACjE,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAClD,OAAO,EAAE,wBAAwB,EAAE,sBAAsB,EAAE,4BAA4B,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAA;AA2C7I;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CACnC,KAAyC,EAChB,EAAE,CAC3B,eAAe,CAAgD;IAC9D,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,MAAM;IAC9B,IAAI,EAAE,KAAK,CAAC,IAAI;IAChB,SAAS,EAAE,IAAI;IACf,QAAQ,EAAE,KAAK,CAAC,QAAQ;IACxB,QAAQ,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,qBAAqB,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,IAAI,IAAI;IAC1F,MAAM,EAAE,KAAK,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE;QAC7C,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,KAAK,CAAA;QAChC,MAAM,QAAQ,GAAG,MAAM,qBAAqB,CAAC,GAAG,CAAC,UAAU,EAAE,GAAG,CAAC,WAAW,EAAE;YAC7E,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,GAAG;YACH,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,MAAM,EAAE,OAAO,CAAC,IAAI;SACpB,CAAC,CAAA;QACF,IAAI,QAAQ,CAAC,UAAU,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;YACxC,OAAO,wBAAwB,CAAC,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC,CAAA;QAClD,CAAC;QAED,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,QAAQ,CAAA;QACxC,IAAI,CAAC,GAAG,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACnC,OAAO,sBAAsB,CAAC,GAAG,EAAE,UAAU,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;QACpE,CAAC;QAED,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,CAAA;QACpE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,UAAU,CAAC,MAAM,EAAE,GAAG,KAAK,EAAE,CAAA;IAC1D,CAAC;IACD,WAAW,EAAE,4BAA4B;CACzC,CAAC,CAAA"}

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

@@ -12,6 +12,15 @@ type JsonRouteInput<TBody, TResponse extends object> = {
     method: 'GET' | 'POST';
     path: string;
     bodySchema?: ProtocolSchema<TBody>;
+    parseBody?: boolean;
+    /**
+     * Route-specific body validation, run after schema parsing and before the
+     * request event is emitted. Return an error message to respond 400
+     * `invalid_request`, or null when the body is valid. Prefer `bodySchema`
+     * when a protocol schema exists; use this for validation rules that a
+     * schema cannot express.
+     */
+    validate?: (body: TBody) => string | null;
     endpoint?: HttpRequestEventMetadata['endpoint'];
     extensionOnly?: boolean;
     handle: (input: JsonRouteHandlerInput<TBody>) => Promise<TResponse | void> | TResponse | void;

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

@@ -1 +1 @@
-{"version":3,"file":"defineRoute.d.ts","sourceRoot":"","sources":["../../../src/http/routes/defineRoute.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA;AACjC,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAA;AAC5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAK5D,MAAM,MAAM,sBAAsB,GAAG;IACpC,MAAM,EAAE,KAAK,GAAG,MAAM,CAAA;IACtB,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,YAAY,CAAA;IACrB,aAAa,CAAC,EAAE,OAAO,CAAA;CACvB,CAAA;AAED,KAAK,cAAc,CAAC,KAAK,EAAE,SAAS,SAAS,MAAM,IAAI;IACtD,MAAM,EAAE,KAAK,GAAG,MAAM,CAAA;IACtB,IAAI,EAAE,MAAM,CAAA;IACZ,UAAU,CAAC,EAAE,cAAc,CAAC,KAAK,CAAC,CAAA;IAClC,QAAQ,CAAC,EAAE,wBAAwB,CAAC,UAAU,CAAC,CAAA;IAC/C,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,MAAM,EAAE,CAAC,KAAK,EAAE,qBAAqB,CAAC,KAAK,CAAC,KAAK,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,SAAS,GAAG,IAAI,CAAA;IAC7F,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,IAAI,CAAC,cAAc,EAAE,KAAK,EAAE,OAAO,KAAK,OAAO,GAAG,IAAI,CAAA;CAC1E,CAAA;AAED,MAAM,MAAM,qBAAqB,CAAC,KAAK,IAAI;IAC1C,GAAG,EAAE,IAAI,CAAC,eAAe,CAAA;IACzB,GAAG,EAAE,IAAI,CAAC,cAAc,CAAA;IACxB,GAAG,EAAE,GAAG,CAAA;IACR,GAAG,EAAE,YAAY,CAAA;IACjB,IAAI,EAAE,KAAK,CAAA;CACX,CAAA;AAED,0GAA0G;AAC1G,eAAO,MAAM,eAAe,GAAI,KAAK,GAAG,SAAS,EAAE,SAAS,SAAS,MAAM,GAAG,MAAM,EACnF,OAAO,cAAc,CAAC,KAAK,EAAE,SAAS,CAAC,KACrC,sBAqCD,CAAA"}
+{"version":3,"file":"defineRoute.d.ts","sourceRoot":"","sources":["../../../src/http/routes/defineRoute.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA;AACjC,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAA;AAC5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAK5D,MAAM,MAAM,sBAAsB,GAAG;IACpC,MAAM,EAAE,KAAK,GAAG,MAAM,CAAA;IACtB,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,YAAY,CAAA;IACrB,aAAa,CAAC,EAAE,OAAO,CAAA;CACvB,CAAA;AAED,KAAK,cAAc,CAAC,KAAK,EAAE,SAAS,SAAS,MAAM,IAAI;IACtD,MAAM,EAAE,KAAK,GAAG,MAAM,CAAA;IACtB,IAAI,EAAE,MAAM,CAAA;IACZ,UAAU,CAAC,EAAE,cAAc,CAAC,KAAK,CAAC,CAAA;IAClC,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,KAAK,KAAK,MAAM,GAAG,IAAI,CAAA;IACzC,QAAQ,CAAC,EAAE,wBAAwB,CAAC,UAAU,CAAC,CAAA;IAC/C,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,MAAM,EAAE,CAAC,KAAK,EAAE,qBAAqB,CAAC,KAAK,CAAC,KAAK,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,SAAS,GAAG,IAAI,CAAA;IAC7F,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,IAAI,CAAC,cAAc,EAAE,KAAK,EAAE,OAAO,KAAK,OAAO,GAAG,IAAI,CAAA;CAC1E,CAAA;AAED,MAAM,MAAM,qBAAqB,CAAC,KAAK,IAAI;IAC1C,GAAG,EAAE,IAAI,CAAC,eAAe,CAAA;IACzB,GAAG,EAAE,IAAI,CAAC,cAAc,CAAA;IACxB,GAAG,EAAE,GAAG,CAAA;IACR,GAAG,EAAE,YAAY,CAAA;IACjB,IAAI,EAAE,KAAK,CAAA;CACX,CAAA;AAED,0GAA0G;AAC1G,eAAO,MAAM,eAAe,GAAI,KAAK,GAAG,SAAS,EAAE,SAAS,SAAS,MAAM,GAAG,MAAM,EACnF,OAAO,cAAc,CAAC,KAAK,EAAE,SAAS,CAAC,KACrC,sBAsCD,CAAA"}

package/dist/http/routes/defineRoute.js

@@ -7,25 +7,25 @@ export const defineJsonRoute = (input) => ({
     path: input.path,
     extensionOnly: input.extensionOnly,
     handler: async (req, res, url, ctx) => {
-        const rawBody = input.bodySchema ? await readJsonBody(req, res) : undefined;
-        if (input.bodySchema && rawBody == null) {
+        const shouldReadBody = input.bodySchema != null || input.parseBody === true;
+        const rawBody = shouldReadBody ? await readJsonBody(req, res) : undefined;
+        if (shouldReadBody && rawBody == null) {
             return;
         }
         const parsedBody = input.bodySchema?.parse(rawBody);
         if (parsedBody && !parsedBody.ok) {
             return respondInvalidBody(res, formatProtocolValidationIssues(parsedBody.issues));
         }
+        const body = (parsedBody?.value ?? rawBody);
+        const validationError = input.validate?.(body);
+        if (validationError) {
+            return respondInvalidBody(res, validationError);
+        }
         if (input.endpoint) {
             emitRequest(ctx, res, input.endpoint);
         }
         try {
-            const response = await input.handle({
-                req,
-                res,
-                url,
-                ctx,
-                body: parsedBody?.value,
-            });
+            const response = await input.handle({ req, res, url, ctx, body });
             if (response) {
                 respondJson(res, response);
             }

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

@@ -1 +1 @@
-{"version":3,"file":"defineRoute.js","sourceRoot":"","sources":["../../../src/http/routes/defineRoute.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,8BAA8B,EAAE,MAAM,oBAAoB,CAAA;AACnE,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAC7F,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AA2BxC,0GAA0G;AAC1G,MAAM,CAAC,MAAM,eAAe,GAAG,CAC9B,KAAuC,EACd,EAAE,CAAC,CAAC;IAC7B,MAAM,EAAE,KAAK,CAAC,MAAM;IACpB,IAAI,EAAE,KAAK,CAAC,IAAI;IAChB,aAAa,EAAE,KAAK,CAAC,aAAa;IAClC,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE;QACrC,MAAM,OAAO,GAAG,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,MAAM,YAAY,CAAU,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;QACpF,IAAI,KAAK,CAAC,UAAU,IAAI,OAAO,IAAI,IAAI,EAAE,CAAC;YACzC,OAAM;QACP,CAAC;QAED,MAAM,UAAU,GAAG,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,OAAO,CAAC,CAAA;QACnD,IAAI,UAAU,IAAI,CAAC,UAAU,CAAC,EAAE,EAAE,CAAC;YAClC,OAAO,kBAAkB,CAAC,GAAG,EAAE,8BAA8B,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAA;QAClF,CAAC;QAED,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;YACpB,WAAW,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAA;QACtC,CAAC;QAED,IAAI,CAAC;YACJ,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC;gBACnC,GAAG;gBACH,GAAG;gBACH,GAAG;gBACH,GAAG;gBACH,IAAI,EAAE,UAAU,EAAE,KAAc;aAChC,CAAC,CAAA;YACF,IAAI,QAAQ,EAAE,CAAC;gBACd,WAAW,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAA;YAC3B,CAAC;QACF,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,CAAC;gBACrC,OAAM;YACP,CAAC;YACD,YAAY,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;QACzB,CAAC;IACF,CAAC;CACD,CAAC,CAAA"}
+{"version":3,"file":"defineRoute.js","sourceRoot":"","sources":["../../../src/http/routes/defineRoute.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,8BAA8B,EAAE,MAAM,oBAAoB,CAAA;AACnE,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAC7F,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAoCxC,0GAA0G;AAC1G,MAAM,CAAC,MAAM,eAAe,GAAG,CAC9B,KAAuC,EACd,EAAE,CAAC,CAAC;IAC7B,MAAM,EAAE,KAAK,CAAC,MAAM;IACpB,IAAI,EAAE,KAAK,CAAC,IAAI;IAChB,aAAa,EAAE,KAAK,CAAC,aAAa;IAClC,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE;QACrC,MAAM,cAAc,GAAG,KAAK,CAAC,UAAU,IAAI,IAAI,IAAI,KAAK,CAAC,SAAS,KAAK,IAAI,CAAA;QAC3E,MAAM,OAAO,GAAG,cAAc,CAAC,CAAC,CAAC,MAAM,YAAY,CAAU,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;QAClF,IAAI,cAAc,IAAI,OAAO,IAAI,IAAI,EAAE,CAAC;YACvC,OAAM;QACP,CAAC;QAED,MAAM,UAAU,GAAG,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,OAAO,CAAC,CAAA;QACnD,IAAI,UAAU,IAAI,CAAC,UAAU,CAAC,EAAE,EAAE,CAAC;YAClC,OAAO,kBAAkB,CAAC,GAAG,EAAE,8BAA8B,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAA;QAClF,CAAC;QAED,MAAM,IAAI,GAAG,CAAC,UAAU,EAAE,KAAK,IAAI,OAAO,CAAU,CAAA;QACpD,MAAM,eAAe,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC,IAAI,CAAC,CAAA;QAC9C,IAAI,eAAe,EAAE,CAAC;YACrB,OAAO,kBAAkB,CAAC,GAAG,EAAE,eAAe,CAAC,CAAA;QAChD,CAAC;QAED,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;YACpB,WAAW,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAA;QACtC,CAAC;QAED,IAAI,CAAC;YACJ,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAA;YACjE,IAAI,QAAQ,EAAE,CAAC;gBACd,WAAW,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAA;YAC3B,CAAC;QACF,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,CAAC;gBACrC,OAAM;YACP,CAAC;YACD,YAAY,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;QACzB,CAAC;IACF,CAAC;CACD,CAAC,CAAA"}

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

@@ -5,18 +5,11 @@ type SelectorPayload = {
     all?: unknown;
 };
 /**
- * Shared parser for DOM routes that require a selector and optional `all` toggle.
- * Keeps route modules focused on the actual DOM operation.
+ * Validate the shared DOM target body shape (exactly one of selector/ref, plus
+ * an optional `all` toggle). Returns an error message, or null when valid.
+ * Used as the base `validate` step by DOM routes built on `defineJsonRoute`.
  */
-export declare const readDomTargetPayload: <T extends SelectorPayload>(req: http.IncomingMessage, res: http.ServerResponse) => Promise<{
-    payload: T;
-    all: boolean;
-} | null>;
-/** Backwards-compatible alias used by selector-only routes while they migrate to ref support. */
-export declare const readDomSelectorPayload: <T extends SelectorPayload>(req: http.IncomingMessage, res: http.ServerResponse) => Promise<{
-    payload: T;
-    all: boolean;
-} | null>;
+export declare const validateDomTargetBody: (payload: SelectorPayload) => string | null;
 export declare const respondMultipleMatches: (res: http.ServerResponse, matches: number, action: string) => void;
 export declare const respondMissingElementRef: (res: http.ServerResponse, ref: string) => void;
 export declare const respondTargetResolutionError: (res: http.ServerResponse, error: unknown) => boolean;

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

@@ -1 +1 @@
-{"version":3,"file":"domSelectorRoute.d.ts","sourceRoot":"","sources":["../../../src/http/routes/domSelectorRoute.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA;AAGjC,KAAK,eAAe,GAAG;IACtB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,GAAG,CAAC,EAAE,OAAO,CAAA;IACb,GAAG,CAAC,EAAE,OAAO,CAAA;CACb,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,oBAAoB,GAAU,CAAC,SAAS,eAAe,EACnE,KAAK,IAAI,CAAC,eAAe,EACzB,KAAK,IAAI,CAAC,cAAc,KACtB,OAAO,CAAC;IAAE,OAAO,EAAE,CAAC,CAAC;IAAC,GAAG,EAAE,OAAO,CAAA;CAAE,GAAG,IAAI,CAoB7C,CAAA;AAED,iGAAiG;AACjG,eAAO,MAAM,sBAAsB,GA1BQ,CAAC,SAAS,eAAe,OAC9D,IAAI,CAAC,eAAe,OACpB,IAAI,CAAC,cAAc,KACtB,OAAO,CAAC;IAAE,OAAO,EAAE,CAAC,CAAC;IAAC,GAAG,EAAE,OAAO,CAAA;CAAE,GAAG,IAAI,CAuBY,CAAA;AAE1D,eAAO,MAAM,sBAAsB,GAAI,KAAK,IAAI,CAAC,cAAc,EAAE,SAAS,MAAM,EAAE,QAAQ,MAAM,KAAG,IAYlG,CAAA;AAED,eAAO,MAAM,wBAAwB,GAAI,KAAK,IAAI,CAAC,cAAc,EAAE,KAAK,MAAM,KAAG,IAYhF,CAAA;AAED,eAAO,MAAM,4BAA4B,GAAI,KAAK,IAAI,CAAC,cAAc,EAAE,OAAO,OAAO,KAAG,OAavF,CAAA"}
+{"version":3,"file":"domSelectorRoute.d.ts","sourceRoot":"","sources":["../../../src/http/routes/domSelectorRoute.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA;AAGjC,KAAK,eAAe,GAAG;IACtB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,GAAG,CAAC,EAAE,OAAO,CAAA;IACb,GAAG,CAAC,EAAE,OAAO,CAAA;CACb,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,GAAI,SAAS,eAAe,KAAG,MAAM,GAAG,IAYzE,CAAA;AAED,eAAO,MAAM,sBAAsB,GAAI,KAAK,IAAI,CAAC,cAAc,EAAE,SAAS,MAAM,EAAE,QAAQ,MAAM,KAAG,IAYlG,CAAA;AAED,eAAO,MAAM,wBAAwB,GAAI,KAAK,IAAI,CAAC,cAAc,EAAE,KAAK,MAAM,KAAG,IAYhF,CAAA;AAED,eAAO,MAAM,4BAA4B,GAAI,KAAK,IAAI,CAAC,cAAc,EAAE,OAAO,OAAO,KAAG,OAavF,CAAA"}