@vforsh/argus-core 0.3.0 → 0.4.0

package/dist/protocol/http/throttle.js

@@ -1,2 +1,28 @@
-export {};
+import { defineProtocolSchema, invalidProtocolPayload, validProtocolPayload } from '../schema.js';
+import { optionalEnum, optionalNumber, readFields, requireObject } from '../schemaFields.js';
+/** Actions accepted by POST /throttle. */
+export const THROTTLE_ACTIONS = ['set', 'clear'];
+/** Schema for POST /throttle request payloads. */
+export const throttleRequestSchema = defineProtocolSchema((value) => {
+    const invalid = requireObject(value);
+    if (invalid)
+        return invalid;
+    const fields = readFields(value, {
+        action: (source, key) => optionalEnum(source, key, THROTTLE_ACTIONS),
+        rate: (source, key) => optionalNumber(source, key, { min: 1 }),
+    });
+    if (!fields.ok)
+        return fields;
+    const { action, rate } = fields.value;
+    if (action == null) {
+        return invalidProtocolPayload(`action must be one of: ${THROTTLE_ACTIONS.join(', ')}`);
+    }
+    if (action === 'clear') {
+        return validProtocolPayload({ action });
+    }
+    if (rate == null) {
+        return invalidProtocolPayload('rate must be a finite number >= 1');
+    }
+    return validProtocolPayload({ action, rate });
+});
 //# sourceMappingURL=throttle.js.map

package/dist/protocol/http/throttle.js.map

@@ -1 +1 @@
-{"version":3,"file":"throttle.js","sourceRoot":"","sources":["../../../src/protocol/http/throttle.ts"],"names":[],"mappings":""}
+{"version":3,"file":"throttle.js","sourceRoot":"","sources":["../../../src/protocol/http/throttle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAA;AACjG,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAsC5F,0CAA0C;AAC1C,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,KAAK,EAAE,OAAO,CAAU,CAAA;AAEzD,kDAAkD;AAClD,MAAM,CAAC,MAAM,qBAAqB,GAAG,oBAAoB,CAAkB,CAAC,KAAK,EAAE,EAAE;IACpF,MAAM,OAAO,GAAG,aAAa,CAAkB,KAAK,CAAC,CAAA;IACrD,IAAI,OAAO;QAAE,OAAO,OAAO,CAAA;IAE3B,MAAM,MAAM,GAAG,UAAU,CAAC,KAAgC,EAAE;QAC3D,MAAM,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE,CAAC,YAAY,CAAC,MAAM,EAAE,GAAG,EAAE,gBAAgB,CAAC;QACpE,IAAI,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE,CAAC,cAAc,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC;KAC9D,CAAC,CAAA;IACF,IAAI,CAAC,MAAM,CAAC,EAAE;QAAE,OAAO,MAAM,CAAA;IAC7B,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,CAAC,KAAK,CAAA;IAErC,IAAI,MAAM,IAAI,IAAI,EAAE,CAAC;QACpB,OAAO,sBAAsB,CAAC,0BAA0B,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IACvF,CAAC;IACD,IAAI,MAAM,KAAK,OAAO,EAAE,CAAC;QACxB,OAAO,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC,CAAA;IACxC,CAAC;IACD,IAAI,IAAI,IAAI,IAAI,EAAE,CAAC;QAClB,OAAO,sBAAsB,CAAC,mCAAmC,CAAC,CAAA;IACnE,CAAC;IAED,OAAO,oBAAoB,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAA;AAC9C,CAAC,CAAC,CAAA"}

package/dist/protocol/http/trace.d.ts

@@ -1,3 +1,4 @@
+import type { Ok } from './errors.js';
 /** Request payload for POST /trace/start. */
 export type TraceStartRequest = {
     outFile?: string;
@@ -5,23 +6,25 @@ export type TraceStartRequest = {
     options?: string;
 };
 /** Response payload for POST /trace/start. */
-export type TraceStartResponse = {
-    ok: true;
+export type TraceStartResponse = Ok<{
     traceId: string;
     sessionName: string;
     outFile: string;
-};
+}>;
 /** Request payload for POST /trace/stop. */
 export type TraceStopRequest = {
     traceId?: string;
     outFile?: string;
 };
 /** Response payload for POST /trace/stop. */
-export type TraceStopResponse = {
-    ok: true;
+export type TraceStopResponse = Ok<{
     sessionName: string;
     outFile: string;
     eventCount: number;
     durationMs: number;
-};
+}>;
+/** Schema for POST /trace/start request payloads. */
+export declare const traceStartRequestSchema: import("../schema.js").ProtocolSchema<TraceStartRequest>;
+/** Schema for POST /trace/stop request payloads. */
+export declare const traceStopRequestSchema: import("../schema.js").ProtocolSchema<TraceStopRequest>;
 //# sourceMappingURL=trace.d.ts.map

package/dist/protocol/http/trace.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"trace.d.ts","sourceRoot":"","sources":["../../../src/protocol/http/trace.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,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,8CAA8C;AAC9C,MAAM,MAAM,kBAAkB,GAAG;IAChC,EAAE,EAAE,IAAI,CAAA;IACR,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,6CAA6C;AAC7C,MAAM,MAAM,iBAAiB,GAAG;IAC/B,EAAE,EAAE,IAAI,CAAA;IACR,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE,MAAM,CAAA;IACf,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;CAClB,CAAA"}
+{"version":3,"file":"trace.d.ts","sourceRoot":"","sources":["../../../src/protocol/http/trace.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,aAAa,CAAA;AAErC,6CAA6C;AAC7C,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,8CAA8C;AAC9C,MAAM,MAAM,kBAAkB,GAAG,EAAE,CAAC;IACnC,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE,MAAM,CAAA;CACf,CAAC,CAAA;AAEF,4CAA4C;AAC5C,MAAM,MAAM,gBAAgB,GAAG;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,OAAO,CAAC,EAAE,MAAM,CAAA;CAChB,CAAA;AAED,6CAA6C;AAC7C,MAAM,MAAM,iBAAiB,GAAG,EAAE,CAAC;IAClC,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE,MAAM,CAAA;IACf,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;CAClB,CAAC,CAAA;AAEF,qDAAqD;AACrD,eAAO,MAAM,uBAAuB,0DAYlC,CAAA;AAEF,oDAAoD;AACpD,eAAO,MAAM,sBAAsB,yDAWjC,CAAA"}

package/dist/protocol/http/trace.js

@@ -1,2 +1,30 @@
-export {};
+import { defineProtocolSchema, validProtocolPayload } from '../schema.js';
+import { compact, optionalNonEmptyString, optionalString, readFields, requireObject } from '../schemaFields.js';
+/** Schema for POST /trace/start request payloads. */
+export const traceStartRequestSchema = defineProtocolSchema((value) => {
+    const invalid = requireObject(value);
+    if (invalid)
+        return invalid;
+    const fields = readFields(value, {
+        outFile: optionalString,
+        categories: optionalString,
+        options: optionalString,
+    });
+    if (!fields.ok)
+        return fields;
+    return validProtocolPayload(compact(fields.value));
+});
+/** Schema for POST /trace/stop request payloads. */
+export const traceStopRequestSchema = defineProtocolSchema((value) => {
+    const invalid = requireObject(value);
+    if (invalid)
+        return invalid;
+    const fields = readFields(value, {
+        traceId: optionalNonEmptyString,
+        outFile: optionalString,
+    });
+    if (!fields.ok)
+        return fields;
+    return validProtocolPayload(compact(fields.value));
+});
 //# sourceMappingURL=trace.js.map

package/dist/protocol/http/trace.js.map

@@ -1 +1 @@
-{"version":3,"file":"trace.js","sourceRoot":"","sources":["../../../src/protocol/http/trace.ts"],"names":[],"mappings":""}
+{"version":3,"file":"trace.js","sourceRoot":"","sources":["../../../src/protocol/http/trace.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAA;AACzE,OAAO,EAAE,OAAO,EAAE,sBAAsB,EAAE,cAAc,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AA+B/G,qDAAqD;AACrD,MAAM,CAAC,MAAM,uBAAuB,GAAG,oBAAoB,CAAoB,CAAC,KAAK,EAAE,EAAE;IACxF,MAAM,OAAO,GAAG,aAAa,CAAoB,KAAK,CAAC,CAAA;IACvD,IAAI,OAAO;QAAE,OAAO,OAAO,CAAA;IAE3B,MAAM,MAAM,GAAG,UAAU,CAAC,KAAgC,EAAE;QAC3D,OAAO,EAAE,cAAc;QACvB,UAAU,EAAE,cAAc;QAC1B,OAAO,EAAE,cAAc;KACvB,CAAC,CAAA;IACF,IAAI,CAAC,MAAM,CAAC,EAAE;QAAE,OAAO,MAAM,CAAA;IAE7B,OAAO,oBAAoB,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAA;AACnD,CAAC,CAAC,CAAA;AAEF,oDAAoD;AACpD,MAAM,CAAC,MAAM,sBAAsB,GAAG,oBAAoB,CAAmB,CAAC,KAAK,EAAE,EAAE;IACtF,MAAM,OAAO,GAAG,aAAa,CAAmB,KAAK,CAAC,CAAA;IACtD,IAAI,OAAO;QAAE,OAAO,OAAO,CAAA;IAE3B,MAAM,MAAM,GAAG,UAAU,CAAC,KAAgC,EAAE;QAC3D,OAAO,EAAE,sBAAsB;QAC/B,OAAO,EAAE,cAAc;KACvB,CAAC,CAAA;IACF,IAAI,CAAC,MAAM,CAAC,EAAE;QAAE,OAAO,MAAM,CAAA;IAE7B,OAAO,oBAAoB,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAA;AACnD,CAAC,CAAC,CAAA"}

package/dist/protocol/http/visibility.d.ts

@@ -1,3 +1,4 @@
+import type { Ok } from './errors.js';
 /**
  * Visibility lock controls whether the attached page should behave as if
  * visible/focused even when the Chrome window is backgrounded or covered.
@@ -20,11 +21,14 @@ export type VisibilityRequest = {
  * it is remembered by the watcher and re-applied on the next attach when
  * `attached` is `false`.
  */
-export type VisibilityResponse = {
-    ok: true;
+export type VisibilityResponse = Ok<{
     /** Whether the watcher was attached to a CDP target at response time. */
     attached: boolean;
     /** Current desired visibility lock. */
     state: VisibilityLock;
-};
+}>;
+/** Actions accepted by POST /visibility. */
+export declare const VISIBILITY_ACTIONS: readonly ["show", "hide"];
+/** Schema for POST /visibility request payloads. */
+export declare const visibilityRequestSchema: import("../schema.js").ProtocolSchema<VisibilityRequest>;
 //# sourceMappingURL=visibility.d.ts.map

package/dist/protocol/http/visibility.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"visibility.d.ts","sourceRoot":"","sources":["../../../src/protocol/http/visibility.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,SAAS,CAAA;AAEhD,wCAAwC;AACxC,MAAM,MAAM,iBAAiB,GAAG;IAC/B,qEAAqE;IACrE,MAAM,EAAE,MAAM,GAAG,MAAM,CAAA;CACvB,CAAA;AAED;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAChC,EAAE,EAAE,IAAI,CAAA;IACR,yEAAyE;IACzE,QAAQ,EAAE,OAAO,CAAA;IACjB,uCAAuC;IACvC,KAAK,EAAE,cAAc,CAAA;CACrB,CAAA"}
+{"version":3,"file":"visibility.d.ts","sourceRoot":"","sources":["../../../src/protocol/http/visibility.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,aAAa,CAAA;AAErC;;;;;;;;;;GAUG;AACH,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,SAAS,CAAA;AAEhD,wCAAwC;AACxC,MAAM,MAAM,iBAAiB,GAAG;IAC/B,qEAAqE;IACrE,MAAM,EAAE,MAAM,GAAG,MAAM,CAAA;CACvB,CAAA;AAED;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,GAAG,EAAE,CAAC;IACnC,yEAAyE;IACzE,QAAQ,EAAE,OAAO,CAAA;IACjB,uCAAuC;IACvC,KAAK,EAAE,cAAc,CAAA;CACrB,CAAC,CAAA;AAEF,4CAA4C;AAC5C,eAAO,MAAM,kBAAkB,2BAA4B,CAAA;AAE3D,oDAAoD;AACpD,eAAO,MAAM,uBAAuB,0DAclC,CAAA"}

package/dist/protocol/http/visibility.js

@@ -1,2 +1,20 @@
-export {};
+import { defineProtocolSchema, invalidProtocolPayload, validProtocolPayload } from '../schema.js';
+import { optionalEnum, readFields, requireObject } from '../schemaFields.js';
+/** Actions accepted by POST /visibility. */
+export const VISIBILITY_ACTIONS = ['show', 'hide'];
+/** Schema for POST /visibility request payloads. */
+export const visibilityRequestSchema = defineProtocolSchema((value) => {
+    const invalid = requireObject(value);
+    if (invalid)
+        return invalid;
+    const fields = readFields(value, {
+        action: (source, key) => optionalEnum(source, key, VISIBILITY_ACTIONS),
+    });
+    if (!fields.ok)
+        return fields;
+    if (fields.value.action == null) {
+        return invalidProtocolPayload('Visibility action must be "show" or "hide"');
+    }
+    return validProtocolPayload({ action: fields.value.action });
+});
 //# sourceMappingURL=visibility.js.map

package/dist/protocol/http/visibility.js.map

@@ -1 +1 @@
-{"version":3,"file":"visibility.js","sourceRoot":"","sources":["../../../src/protocol/http/visibility.ts"],"names":[],"mappings":""}
+{"version":3,"file":"visibility.js","sourceRoot":"","sources":["../../../src/protocol/http/visibility.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAA;AACjG,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAkC5E,4CAA4C;AAC5C,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,MAAM,EAAE,MAAM,CAAU,CAAA;AAE3D,oDAAoD;AACpD,MAAM,CAAC,MAAM,uBAAuB,GAAG,oBAAoB,CAAoB,CAAC,KAAK,EAAE,EAAE;IACxF,MAAM,OAAO,GAAG,aAAa,CAAoB,KAAK,CAAC,CAAA;IACvD,IAAI,OAAO;QAAE,OAAO,OAAO,CAAA;IAE3B,MAAM,MAAM,GAAG,UAAU,CAAC,KAAgC,EAAE;QAC3D,MAAM,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE,CAAC,YAAY,CAAC,MAAM,EAAE,GAAG,EAAE,kBAAkB,CAAC;KACtE,CAAC,CAAA;IACF,IAAI,CAAC,MAAM,CAAC,EAAE;QAAE,OAAO,MAAM,CAAA;IAE7B,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,IAAI,IAAI,EAAE,CAAC;QACjC,OAAO,sBAAsB,CAAC,4CAA4C,CAAC,CAAA;IAC5E,CAAC;IAED,OAAO,oBAAoB,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAA;AAC7D,CAAC,CAAC,CAAA"}

package/dist/protocol/http.d.ts

@@ -1,24 +1,26 @@
 export * from './schema.js';
-export type * from './http/status.js';
+export * from './schemaFields.js';
+export * from './http/status.js';
 export type * from './http/logs.js';
 export type * from './http/net.js';
 export * from './http/netMock.js';
-export type * from './http/eval.js';
-export type * from './http/trace.js';
+export * from './http/eval.js';
+export * from './http/trace.js';
 export * from './http/record.js';
-export type * from './http/screenshot.js';
-export type * from './http/snapshot.js';
-export type * from './http/locate.js';
-export type * from './http/code.js';
+export * from './http/screenshot.js';
+export * from './http/snapshot.js';
+export * from './http/locate.js';
+export * from './http/code.js';
 export * from './http/dom.js';
 export * from './http/domInteraction.js';
-export type * from './http/storage.js';
-export type * from './http/auth.js';
-export { AUTH_STATE_METADATA_SCHEMA_VERSION } from './http/auth.js';
-export type * from './http/emulation.js';
-export type * from './http/throttle.js';
-export type * from './http/dialog.js';
-export type * from './http/visibility.js';
-export type * from './http/extension.js';
-export type * from './http/errors.js';
+export * from './http/storage.js';
+export * from './http/auth.js';
+export * from './http/emulation.js';
+export * from './http/throttle.js';
+export * from './http/dialog.js';
+export * from './http/visibility.js';
+export * from './http/extension.js';
+export * from './http/errors.js';
+export * from './http/query.js';
+export type * from './scenario.js';
 //# sourceMappingURL=http.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/protocol/http.ts"],"names":[],"mappings":"AACA,cAAc,aAAa,CAAA;AAC3B,mBAAmB,kBAAkB,CAAA;AACrC,mBAAmB,gBAAgB,CAAA;AACnC,mBAAmB,eAAe,CAAA;AAClC,cAAc,mBAAmB,CAAA;AACjC,mBAAmB,gBAAgB,CAAA;AACnC,mBAAmB,iBAAiB,CAAA;AACpC,cAAc,kBAAkB,CAAA;AAChC,mBAAmB,sBAAsB,CAAA;AACzC,mBAAmB,oBAAoB,CAAA;AACvC,mBAAmB,kBAAkB,CAAA;AACrC,mBAAmB,gBAAgB,CAAA;AACnC,cAAc,eAAe,CAAA;AAC7B,cAAc,0BAA0B,CAAA;AACxC,mBAAmB,mBAAmB,CAAA;AACtC,mBAAmB,gBAAgB,CAAA;AACnC,OAAO,EAAE,kCAAkC,EAAE,MAAM,gBAAgB,CAAA;AACnE,mBAAmB,qBAAqB,CAAA;AACxC,mBAAmB,oBAAoB,CAAA;AACvC,mBAAmB,kBAAkB,CAAA;AACrC,mBAAmB,sBAAsB,CAAA;AACzC,mBAAmB,qBAAqB,CAAA;AACxC,mBAAmB,kBAAkB,CAAA"}
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/protocol/http.ts"],"names":[],"mappings":"AACA,cAAc,aAAa,CAAA;AAC3B,cAAc,mBAAmB,CAAA;AACjC,cAAc,kBAAkB,CAAA;AAChC,mBAAmB,gBAAgB,CAAA;AACnC,mBAAmB,eAAe,CAAA;AAClC,cAAc,mBAAmB,CAAA;AACjC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,kBAAkB,CAAA;AAChC,cAAc,sBAAsB,CAAA;AACpC,cAAc,oBAAoB,CAAA;AAClC,cAAc,kBAAkB,CAAA;AAChC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,eAAe,CAAA;AAC7B,cAAc,0BAA0B,CAAA;AACxC,cAAc,mBAAmB,CAAA;AACjC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,qBAAqB,CAAA;AACnC,cAAc,oBAAoB,CAAA;AAClC,cAAc,kBAAkB,CAAA;AAChC,cAAc,sBAAsB,CAAA;AACpC,cAAc,qBAAqB,CAAA;AACnC,cAAc,kBAAkB,CAAA;AAChC,cAAc,iBAAiB,CAAA;AAC/B,mBAAmB,eAAe,CAAA"}

package/dist/protocol/http.js

@@ -1,8 +1,24 @@
 // Barrel re-exports — keeps existing import paths working.
 export * from './schema.js';
+export * from './schemaFields.js';
+export * from './http/status.js';
 export * from './http/netMock.js';
+export * from './http/eval.js';
+export * from './http/trace.js';
 export * from './http/record.js';
+export * from './http/screenshot.js';
+export * from './http/snapshot.js';
+export * from './http/locate.js';
+export * from './http/code.js';
 export * from './http/dom.js';
 export * from './http/domInteraction.js';
-export { AUTH_STATE_METADATA_SCHEMA_VERSION } from './http/auth.js';
+export * from './http/storage.js';
+export * from './http/auth.js';
+export * from './http/emulation.js';
+export * from './http/throttle.js';
+export * from './http/dialog.js';
+export * from './http/visibility.js';
+export * from './http/extension.js';
+export * from './http/errors.js';
+export * from './http/query.js';
 //# sourceMappingURL=http.js.map

package/dist/protocol/http.js.map

@@ -1 +1 @@
-{"version":3,"file":"http.js","sourceRoot":"","sources":["../../src/protocol/http.ts"],"names":[],"mappings":"AAAA,2DAA2D;AAC3D,cAAc,aAAa,CAAA;AAI3B,cAAc,mBAAmB,CAAA;AAGjC,cAAc,kBAAkB,CAAA;AAKhC,cAAc,eAAe,CAAA;AAC7B,cAAc,0BAA0B,CAAA;AAGxC,OAAO,EAAE,kCAAkC,EAAE,MAAM,gBAAgB,CAAA"}
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../../src/protocol/http.ts"],"names":[],"mappings":"AAAA,2DAA2D;AAC3D,cAAc,aAAa,CAAA;AAC3B,cAAc,mBAAmB,CAAA;AACjC,cAAc,kBAAkB,CAAA;AAGhC,cAAc,mBAAmB,CAAA;AACjC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,kBAAkB,CAAA;AAChC,cAAc,sBAAsB,CAAA;AACpC,cAAc,oBAAoB,CAAA;AAClC,cAAc,kBAAkB,CAAA;AAChC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,eAAe,CAAA;AAC7B,cAAc,0BAA0B,CAAA;AACxC,cAAc,mBAAmB,CAAA;AACjC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,qBAAqB,CAAA;AACnC,cAAc,oBAAoB,CAAA;AAClC,cAAc,kBAAkB,CAAA;AAChC,cAAc,sBAAsB,CAAA;AACpC,cAAc,qBAAqB,CAAA;AACnC,cAAc,kBAAkB,CAAA;AAChC,cAAc,iBAAiB,CAAA"}

package/dist/protocol/native-messaging.d.ts

@@ -0,0 +1,276 @@
+/**
+ * Native Messaging wire protocol shared by the Chrome extension and argus-watcher.
+ *
+ * This module is the single definition of the extension <-> watcher contract. The two
+ * peers ship as independently versioned npm packages, so a field added on one side and
+ * forgotten on the other would compile cleanly and only fail at runtime in a user's
+ * Chrome — importing both ends from here makes that a compile error instead.
+ *
+ * The extension bundles this with esbuild: keep it types plus erasable constants only,
+ * so the extension's no-runtime-dependencies property survives.
+ */
+/**
+ * Version of the native-messaging wire contract.
+ *
+ * Bump on any breaking change to the message shapes below. Peers exchange it in the
+ * `host_info` handshake and refuse to proceed on a mismatch.
+ */
+export declare const NATIVE_MESSAGING_PROTOCOL_VERSION: 2;
+/** Type-level alias for the current native-messaging protocol version. */
+export type NativeMessagingProtocolVersion = typeof NATIVE_MESSAGING_PROTOCOL_VERSION;
+export type TabAttachedMessage = {
+    type: 'tab_attached';
+    tabId: number;
+    url: string;
+    title: string;
+    faviconUrl?: string;
+    topFrameId?: string | null;
+    frames?: FrameSnapshot[];
+};
+export type TabDetachedMessage = {
+    type: 'tab_detached';
+    tabId: number;
+    reason: string;
+};
+export type CdpEventMessage = {
+    type: 'cdp_event';
+    tabId: number;
+    method: string;
+    params: unknown;
+    sessionId?: string;
+};
+/** Why the extension published a frame snapshot; informational (diagnostics/logs only). */
+export type FrameSnapshotReason = 'navigation_resync' | 'child_attached' | 'child_detached' | 'requested';
+/**
+ * Authoritative frame table for one attached tab, pushed by the extension whenever its
+ * table changes and returned in response to {@link FrameSnapshotRequestMessage}.
+ *
+ * `frames` is always the FULL table for the tab (never a delta) so applying a snapshot is
+ * idempotent: the watcher replaces its copy wholesale instead of replaying synthetic
+ * `Page.frameNavigated`/`Page.frameDetached` events. Real CDP events still flow as
+ * `cdp_event` and remain the immediate-reaction channel; snapshots are the reconciliation.
+ */
+export type FrameSnapshotMessage = {
+    type: 'frame_snapshot';
+    tabId: number;
+    topFrameId: string | null;
+    frames: FrameSnapshot[];
+    reason: FrameSnapshotReason;
+    /** Present when this snapshot answers a `frame_snapshot_request`; absent on pushes. */
+    requestId?: number;
+};
+/**
+ * Host -> extension pull for the current frame table (bootstrap and target recovery).
+ * With `refresh: true` the extension re-reads `Page.getFrameTree` for the root and every
+ * child session before answering, so the reply reflects Chrome, not just cached state.
+ */
+export type FrameSnapshotRequestMessage = {
+    type: 'frame_snapshot_request';
+    requestId: number;
+    tabId: number;
+    refresh?: boolean;
+};
+export type CdpResponseMessage = {
+    type: 'cdp_response';
+    requestId: number;
+    result?: unknown;
+    error?: {
+        code?: number;
+        message: string;
+    };
+};
+export type CookieQueryResponseMessage = {
+    type: 'cookie_query_response';
+    requestId: number;
+    cookies?: NativeCookie[];
+    error?: {
+        message: string;
+    };
+};
+export type ListTabsResponseMessage = {
+    type: 'list_tabs_response';
+    requestId: number;
+    tabs: TabInfo[];
+};
+export type TabActionResponseMessage = {
+    type: 'tab_action_response';
+    requestId: number;
+    ok: boolean;
+    tab?: TabInfo;
+    watcherId?: string;
+    error?: {
+        message: string;
+    };
+};
+/**
+ * Outcome of a control-host tab action, as both peers model it in memory.
+ *
+ * This is the discriminated form of {@link TabActionResponseMessage}, whose `ok`/`tab`/
+ * `error` fields are independently optional on the wire. Producers build this and
+ * serialize it; consumers reconstruct it on receipt.
+ */
+export type TabActionResult = {
+    ok: true;
+    tab: TabInfo;
+    watcherId?: string;
+} | {
+    ok: false;
+    error: string;
+};
+export type ControlStatusResponseMessage = {
+    type: 'control_status_response';
+    requestId: number;
+    diagnostics: ControlDiagnostics;
+};
+export type TargetSelectedMessage = {
+    type: 'target_selected';
+    tabId: number;
+    frameId?: string | null;
+};
+export type HostInfoMessage = {
+    type: 'host_info';
+    watcherId: string;
+    watcherHost: string;
+    watcherPort: number;
+    pid: number;
+    /**
+     * Native-messaging protocol version the host was built against.
+     *
+     * Absent when an older watcher predates the handshake — treat that as an
+     * unknown, incompatible version rather than as a match.
+     */
+    protocolVersion?: NativeMessagingProtocolVersion;
+};
+export type HostReadyMessage = {
+    type: 'host_ready';
+};
+export type TargetInfoMessage = {
+    type: 'target_info';
+    targetId: string;
+    title: string | null;
+    url: string | null;
+    attachedAt: number;
+    targetReady?: boolean | null;
+};
+export type InitTabWatcherMessage = {
+    type: 'init_tab_watcher';
+    watcherId?: string;
+};
+export type TabInfo = {
+    tabId: number;
+    url: string;
+    title: string;
+    faviconUrl?: string;
+    attached: boolean;
+    watcherId?: string;
+};
+/** Runtime state of the extension-level control bridge. */
+export type ExtensionControlBridgeStatus = {
+    connected: boolean;
+    watcherId: string | null;
+    watcherHost: string | null;
+    watcherPort: number | null;
+    pid: number | null;
+    lastMessageAt: number | null;
+};
+/** Runtime state for one tab-scoped extension watcher bridge. */
+export type ExtensionTabBridgeStatus = {
+    tabId: number;
+    connected: boolean;
+    watcherId: string | null;
+    watcherHost: string | null;
+    watcherPort: number | null;
+    pid: number | null;
+    targetId: string | null;
+    targetTitle: string | null;
+    targetUrl: string | null;
+    targetReady: boolean | null;
+    lastMessageAt: number | null;
+};
+/** Recent extension-side event surfaced for diagnostics. */
+export type ExtensionRecentEvent = {
+    ts: number;
+    level: 'info' | 'error';
+    source: 'popup' | 'bridge' | 'debugger';
+    message: string;
+};
+/**
+ * Diagnostics snapshot the extension reports over the control bridge.
+ *
+ * `GET /extension/diagnostics` reshapes this into {@link ExtensionDiagnosticsResponse};
+ * both use the same member types so a diagnostics change lands in one place.
+ */
+export type ControlDiagnostics = {
+    extensionId: string | null;
+    extensionVersion: string | null;
+    control: ExtensionControlBridgeStatus;
+    tabWatchers: ExtensionTabBridgeStatus[];
+    recentEvents: ExtensionRecentEvent[];
+};
+export type FrameSnapshot = {
+    frameId: string;
+    parentFrameId: string | null;
+    url: string;
+    title: string | null;
+    sessionId: string | null;
+};
+export type NativeCookie = {
+    name: string;
+    value: string;
+    domain: string;
+    path: string;
+    secure: boolean;
+    httpOnly: boolean;
+    session: boolean;
+    expires: number | null;
+    sameSite: string | null;
+};
+export type ExtensionToHost = TabAttachedMessage | TabDetachedMessage | CdpEventMessage | CdpResponseMessage | CookieQueryResponseMessage | TargetSelectedMessage | FrameSnapshotMessage;
+export type ExtensionToControlHost = ListTabsResponseMessage | TabActionResponseMessage | ControlStatusResponseMessage;
+export type ExtensionToTabHost = ExtensionToHost | InitTabWatcherMessage;
+export type AttachTabWatcherMessage = {
+    type: 'attach_tab_watcher';
+    requestId: number;
+    tabId: number;
+    watcherId?: string;
+};
+export type DetachTabWatcherMessage = {
+    type: 'detach_tab_watcher';
+    requestId: number;
+    tabId: number;
+};
+export type DetachTabMessage = {
+    type: 'detach_tab';
+    tabId: number;
+};
+export type CdpCommandMessage = {
+    type: 'cdp_command';
+    requestId: number;
+    tabId: number;
+    method: string;
+    params?: Record<string, unknown>;
+    sessionId?: string;
+};
+export type ListTabsMessage = {
+    type: 'list_tabs';
+    requestId: number;
+    filter?: {
+        url?: string;
+        title?: string;
+    };
+};
+export type ControlStatusMessage = {
+    type: 'control_status';
+    requestId: number;
+};
+export type CookieQueryMessage = {
+    type: 'cookie_query';
+    requestId: number;
+    tabId: number;
+    domain?: string;
+    url?: string;
+};
+export type HostToExtension = DetachTabMessage | CdpCommandMessage | CookieQueryMessage | FrameSnapshotRequestMessage | HostInfoMessage | HostReadyMessage | TargetInfoMessage;
+export type ControlHostToExtension = AttachTabWatcherMessage | DetachTabWatcherMessage | ListTabsMessage | ControlStatusMessage | HostInfoMessage | HostReadyMessage;
+export type TabHostToExtension = HostToExtension;
+//# sourceMappingURL=native-messaging.d.ts.map

package/dist/protocol/native-messaging.d.ts.map

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

package/dist/protocol/native-messaging.js

@@ -0,0 +1,19 @@
+/**
+ * Native Messaging wire protocol shared by the Chrome extension and argus-watcher.
+ *
+ * This module is the single definition of the extension <-> watcher contract. The two
+ * peers ship as independently versioned npm packages, so a field added on one side and
+ * forgotten on the other would compile cleanly and only fail at runtime in a user's
+ * Chrome — importing both ends from here makes that a compile error instead.
+ *
+ * The extension bundles this with esbuild: keep it types plus erasable constants only,
+ * so the extension's no-runtime-dependencies property survives.
+ */
+/**
+ * Version of the native-messaging wire contract.
+ *
+ * Bump on any breaking change to the message shapes below. Peers exchange it in the
+ * `host_info` handshake and refuse to proceed on a mismatch.
+ */
+export const NATIVE_MESSAGING_PROTOCOL_VERSION = 2;
+//# sourceMappingURL=native-messaging.js.map

package/dist/protocol/native-messaging.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-messaging.js","sourceRoot":"","sources":["../../src/protocol/native-messaging.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,iCAAiC,GAAG,CAAU,CAAA"}

package/dist/protocol/scenario.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Host-bridge types for bundled eval scenarios.
+ *
+ * These describe the in-page capability object handed to a scenario's `export default`,
+ * not an HTTP payload — the members are functions returning promises and are never
+ * serialized over the wire. They live outside `protocol/http/` for exactly that reason.
+ */
+import type { LogEpoch, LogEvent, LogLevel } from './logs.js';
+import type { ScreenshotClipRegion, ScreenshotResponse } from './http/screenshot.js';
+/** Page-side screenshot options accepted by scenario artifact helpers. */
+export type ArgusScenarioScreenshotOptions = {
+    /** Crop to the first matching element. */
+    selector?: string;
+    /** Crop to a viewport-relative rectangle. Mutually exclusive with `selector`. */
+    clip?: ScreenshotClipRegion;
+};
+/** Filters for reading watcher logs from a scenario cursor. */
+export type ArgusScenarioLogOptions = {
+    /** Only include these severity levels. */
+    levels?: LogLevel[];
+    /** Match event text against any supplied regular expression. */
+    match?: string | string[];
+    /** Regex case handling. Defaults to case-sensitive. */
+    matchCase?: 'sensitive' | 'insensitive';
+    /** Case-insensitive substring filter over the event source. */
+    source?: string;
+    /** Maximum number of matching events. Defaults to 500; maximum 5000. */
+    limit?: number;
+};
+/** Result of reading scenario logs after a cursor. */
+export type ArgusScenarioLogsResult = {
+    events: LogEvent[];
+    /** Cursor to use for the next read. */
+    nextCursor: LogEpoch;
+};
+/** Stateful log window created at a scenario-defined baseline. */
+export type ArgusScenarioLogSession = {
+    /** Current session cursor. It advances after each successful read. */
+    readonly cursor: LogEpoch;
+    /** Read matching logs since the session cursor and advance it. */
+    read: (options?: ArgusScenarioLogOptions) => Promise<ArgusScenarioLogsResult>;
+};
+/** Log cursor helpers available to bundled scenario entrypoints. */
+export type ArgusScenarioLogs = {
+    /** Return the watcher's current log cursor without downloading events. */
+    cursor: () => Promise<LogEpoch>;
+    /** Read matching logs produced strictly after `cursor`. */
+    read: (cursor: LogEpoch, options?: ArgusScenarioLogOptions) => Promise<ArgusScenarioLogsResult>;
+    /** Capture the current cursor and return a stateful log window. */
+    session: () => Promise<ArgusScenarioLogSession>;
+};
+/** Host capabilities passed to `export default` in a bundled eval file. */
+export type ArgusScenarioContext = {
+    /** Frozen string arguments supplied by `--arg` / `--args`. */
+    readonly args: Readonly<Record<string, string>>;
+    /** Capture a screenshot using a watcher-generated safe artifact path. */
+    screenshot: (options?: ArgusScenarioScreenshotOptions) => Promise<ScreenshotResponse>;
+    /** Capture or replace `checkpoints/<name>.png` under the watcher artifact directory. */
+    checkpoint: (name: string, options?: ArgusScenarioScreenshotOptions) => Promise<ScreenshotResponse>;
+    /** Cursor and session helpers for logs produced during the scenario. */
+    readonly logs: ArgusScenarioLogs;
+};
+//# sourceMappingURL=scenario.d.ts.map

package/dist/protocol/scenario.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scenario.d.ts","sourceRoot":"","sources":["../../src/protocol/scenario.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAA;AAC7D,OAAO,KAAK,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AAEpF,0EAA0E;AAC1E,MAAM,MAAM,8BAA8B,GAAG;IAC5C,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,iFAAiF;IACjF,IAAI,CAAC,EAAE,oBAAoB,CAAA;CAC3B,CAAA;AAED,+DAA+D;AAC/D,MAAM,MAAM,uBAAuB,GAAG;IACrC,0CAA0C;IAC1C,MAAM,CAAC,EAAE,QAAQ,EAAE,CAAA;IACnB,gEAAgE;IAChE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;IACzB,uDAAuD;IACvD,SAAS,CAAC,EAAE,WAAW,GAAG,aAAa,CAAA;IACvC,+DAA+D;IAC/D,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,wEAAwE;IACxE,KAAK,CAAC,EAAE,MAAM,CAAA;CACd,CAAA;AAED,sDAAsD;AACtD,MAAM,MAAM,uBAAuB,GAAG;IACrC,MAAM,EAAE,QAAQ,EAAE,CAAA;IAClB,uCAAuC;IACvC,UAAU,EAAE,QAAQ,CAAA;CACpB,CAAA;AAED,kEAAkE;AAClE,MAAM,MAAM,uBAAuB,GAAG;IACrC,sEAAsE;IACtE,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAA;IACzB,kEAAkE;IAClE,IAAI,EAAE,CAAC,OAAO,CAAC,EAAE,uBAAuB,KAAK,OAAO,CAAC,uBAAuB,CAAC,CAAA;CAC7E,CAAA;AAED,oEAAoE;AACpE,MAAM,MAAM,iBAAiB,GAAG;IAC/B,0EAA0E;IAC1E,MAAM,EAAE,MAAM,OAAO,CAAC,QAAQ,CAAC,CAAA;IAC/B,2DAA2D;IAC3D,IAAI,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,uBAAuB,KAAK,OAAO,CAAC,uBAAuB,CAAC,CAAA;IAC/F,mEAAmE;IACnE,OAAO,EAAE,MAAM,OAAO,CAAC,uBAAuB,CAAC,CAAA;CAC/C,CAAA;AAED,2EAA2E;AAC3E,MAAM,MAAM,oBAAoB,GAAG;IAClC,8DAA8D;IAC9D,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;IAC/C,yEAAyE;IACzE,UAAU,EAAE,CAAC,OAAO,CAAC,EAAE,8BAA8B,KAAK,OAAO,CAAC,kBAAkB,CAAC,CAAA;IACrF,wFAAwF;IACxF,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,8BAA8B,KAAK,OAAO,CAAC,kBAAkB,CAAC,CAAA;IACnG,wEAAwE;IACxE,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAA;CAChC,CAAA"}

package/dist/protocol/scenario.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=scenario.js.map