@vforsh/argus-core 0.2.0 → 0.4.0

package/dist/protocol/http/storage.js

@@ -1,2 +1,32 @@
-export {};
+import { defineProtocolSchema, invalidProtocolPayload, validProtocolPayload } from '../schema.js';
+import { compact, optionalEnum, optionalString, readFields, requireObject } from '../schemaFields.js';
+/** Operations accepted by POST /storage/<area>. */
+export const STORAGE_ACTIONS = ['get', 'set', 'remove', 'list', 'clear'];
+/** Operations that address a single key. */
+const KEYED_STORAGE_ACTIONS = new Set(['get', 'set', 'remove']);
+/** Schema for POST /storage/<area> request payloads. */
+export const storageRequestSchema = defineProtocolSchema((value) => {
+    const invalid = requireObject(value);
+    if (invalid)
+        return invalid;
+    const fields = readFields(value, {
+        action: (source, key) => optionalEnum(source, key, STORAGE_ACTIONS),
+        key: optionalString,
+        value: optionalString,
+        origin: optionalString,
+    });
+    if (!fields.ok)
+        return fields;
+    const { action, key, value: entryValue, origin } = fields.value;
+    if (action == null) {
+        return invalidProtocolPayload(`action must be one of: ${STORAGE_ACTIONS.join(', ')}`);
+    }
+    if (KEYED_STORAGE_ACTIONS.has(action) && !key) {
+        return invalidProtocolPayload(`key is required for the ${action} action`);
+    }
+    if (action === 'set' && typeof entryValue !== 'string') {
+        return invalidProtocolPayload('value is required for the set action');
+    }
+    return validProtocolPayload(compact({ action, key, value: entryValue, origin }));
+});
 //# sourceMappingURL=storage.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"storage.js","sourceRoot":"","sources":["../../../src/protocol/http/storage.ts"],"names":[],"mappings":""}
+{"version":3,"file":"storage.js","sourceRoot":"","sources":["../../../src/protocol/http/storage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAA;AACjG,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAkDrG,mDAAmD;AACnD,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAU,CAAA;AAEjF,4CAA4C;AAC5C,MAAM,qBAAqB,GAAG,IAAI,GAAG,CAAgB,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAA;AAE9E,wDAAwD;AACxD,MAAM,CAAC,MAAM,oBAAoB,GAAG,oBAAoB,CAAiB,CAAC,KAAK,EAAE,EAAE;IAClF,MAAM,OAAO,GAAG,aAAa,CAAiB,KAAK,CAAC,CAAA;IACpD,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,eAAe,CAAC;QACnE,GAAG,EAAE,cAAc;QACnB,KAAK,EAAE,cAAc;QACrB,MAAM,EAAE,cAAc;KACtB,CAAC,CAAA;IACF,IAAI,CAAC,MAAM,CAAC,EAAE;QAAE,OAAO,MAAM,CAAA;IAC7B,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC,KAAK,CAAA;IAE/D,IAAI,MAAM,IAAI,IAAI,EAAE,CAAC;QACpB,OAAO,sBAAsB,CAAC,0BAA0B,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IACtF,CAAC;IACD,IAAI,qBAAqB,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;QAC/C,OAAO,sBAAsB,CAAC,2BAA2B,MAAM,SAAS,CAAC,CAAA;IAC1E,CAAC;IACD,IAAI,MAAM,KAAK,KAAK,IAAI,OAAO,UAAU,KAAK,QAAQ,EAAE,CAAC;QACxD,OAAO,sBAAsB,CAAC,sCAAsC,CAAC,CAAA;IACtE,CAAC;IAED,OAAO,oBAAoB,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC,CAAC,CAAA;AACjF,CAAC,CAAC,CAAA"}

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

@@ -1,3 +1,4 @@
+import type { ErrorDetail, Ok } from './errors.js';
 /**
  * CPU throttle state.
  * Rate 1 = no throttle, 4 = 4x slowdown. Must be >= 1.
@@ -13,36 +14,28 @@ export type ThrottleRequest = {
     action: 'clear';
 };
 /** POST /throttle response for the `set` action. */
-export type ThrottleSetResponse = {
-    ok: true;
+export type ThrottleSetResponse = Ok<{
     attached: boolean;
     applied: boolean;
     state: ThrottleState | null;
-    error?: {
-        message: string;
-        code?: string;
-    } | null;
-};
+    error?: ErrorDetail | null;
+}>;
 /** POST /throttle response for the `clear` action. */
-export type ThrottleClearResponse = {
-    ok: true;
+export type ThrottleClearResponse = Ok<{
     attached: boolean;
     applied: boolean;
     state: null;
-    error?: {
-        message: string;
-        code?: string;
-    } | null;
-};
+    error?: ErrorDetail | null;
+}>;
 /** GET /throttle response. */
-export type ThrottleStatusResponse = {
-    ok: true;
+export type ThrottleStatusResponse = Ok<{
     attached: boolean;
     applied: boolean;
     state: ThrottleState | null;
-    lastError?: {
-        message: string;
-        code?: string;
-    } | null;
-};
+    lastError?: ErrorDetail | null;
+}>;
+/** Actions accepted by POST /throttle. */
+export declare const THROTTLE_ACTIONS: readonly ["set", "clear"];
+/** Schema for POST /throttle request payloads. */
+export declare const throttleRequestSchema: import("../schema.js").ProtocolSchema<ThrottleRequest>;
 //# sourceMappingURL=throttle.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"throttle.d.ts","sourceRoot":"","sources":["../../../src/protocol/http/throttle.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG;IAC3B,IAAI,EAAE,MAAM,CAAA;CACZ,CAAA;AAED,sCAAsC;AACtC,MAAM,MAAM,eAAe,GAAG;IAAE,MAAM,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,MAAM,EAAE,OAAO,CAAA;CAAE,CAAA;AAEnF,oDAAoD;AACpD,MAAM,MAAM,mBAAmB,GAAG;IACjC,EAAE,EAAE,IAAI,CAAA;IACR,QAAQ,EAAE,OAAO,CAAA;IACjB,OAAO,EAAE,OAAO,CAAA;IAChB,KAAK,EAAE,aAAa,GAAG,IAAI,CAAA;IAC3B,KAAK,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAA;CACjD,CAAA;AAED,sDAAsD;AACtD,MAAM,MAAM,qBAAqB,GAAG;IACnC,EAAE,EAAE,IAAI,CAAA;IACR,QAAQ,EAAE,OAAO,CAAA;IACjB,OAAO,EAAE,OAAO,CAAA;IAChB,KAAK,EAAE,IAAI,CAAA;IACX,KAAK,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAA;CACjD,CAAA;AAED,8BAA8B;AAC9B,MAAM,MAAM,sBAAsB,GAAG;IACpC,EAAE,EAAE,IAAI,CAAA;IACR,QAAQ,EAAE,OAAO,CAAA;IACjB,OAAO,EAAE,OAAO,CAAA;IAChB,KAAK,EAAE,aAAa,GAAG,IAAI,CAAA;IAC3B,SAAS,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAA;CACrD,CAAA"}
+{"version":3,"file":"throttle.d.ts","sourceRoot":"","sources":["../../../src/protocol/http/throttle.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,EAAE,EAAE,MAAM,aAAa,CAAA;AAElD;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG;IAC3B,IAAI,EAAE,MAAM,CAAA;CACZ,CAAA;AAED,sCAAsC;AACtC,MAAM,MAAM,eAAe,GAAG;IAAE,MAAM,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,MAAM,EAAE,OAAO,CAAA;CAAE,CAAA;AAEnF,oDAAoD;AACpD,MAAM,MAAM,mBAAmB,GAAG,EAAE,CAAC;IACpC,QAAQ,EAAE,OAAO,CAAA;IACjB,OAAO,EAAE,OAAO,CAAA;IAChB,KAAK,EAAE,aAAa,GAAG,IAAI,CAAA;IAC3B,KAAK,CAAC,EAAE,WAAW,GAAG,IAAI,CAAA;CAC1B,CAAC,CAAA;AAEF,sDAAsD;AACtD,MAAM,MAAM,qBAAqB,GAAG,EAAE,CAAC;IACtC,QAAQ,EAAE,OAAO,CAAA;IACjB,OAAO,EAAE,OAAO,CAAA;IAChB,KAAK,EAAE,IAAI,CAAA;IACX,KAAK,CAAC,EAAE,WAAW,GAAG,IAAI,CAAA;CAC1B,CAAC,CAAA;AAEF,8BAA8B;AAC9B,MAAM,MAAM,sBAAsB,GAAG,EAAE,CAAC;IACvC,QAAQ,EAAE,OAAO,CAAA;IACjB,OAAO,EAAE,OAAO,CAAA;IAChB,KAAK,EAAE,aAAa,GAAG,IAAI,CAAA;IAC3B,SAAS,CAAC,EAAE,WAAW,GAAG,IAAI,CAAA;CAC9B,CAAC,CAAA;AAEF,0CAA0C;AAC1C,eAAO,MAAM,gBAAgB,2BAA4B,CAAA;AAEzD,kDAAkD;AAClD,eAAO,MAAM,qBAAqB,wDAsBhC,CAAA"}

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