@riddledc/riddle-proof 0.7.26 → 0.7.27

package/dist/{chunk-SDSBS64X.js → chunk-FUWINYNX.js}

@@ -119,6 +119,11 @@ function jsonRecord(value) {
   if (!isRecord(value)) return void 0;
   return Object.fromEntries(Object.entries(value).map(([key, child]) => [key, toJsonValue(child)]));
 }
+function stringRecord(value) {
+  if (!isRecord(value)) return void 0;
+  const entries = Object.entries(value).map(([key, child]) => [key, String(child)]).filter(([key]) => key.trim());
+  return entries.length ? Object.fromEntries(entries) : void 0;
+}
 function toJsonValue(value) {
   if (value === null || value === void 0) return null;
   if (typeof value === "string" || typeof value === "boolean") return value;
@@ -190,6 +195,33 @@ function normalizeSetupActions(value) {
   if (!Array.isArray(value)) throw new Error("target.setup_actions must be an array.");
   return value.map(normalizeSetupAction);
 }
+function normalizeNetworkMock(input, index) {
+  if (!isRecord(input)) throw new Error(`target.network_mocks[${index}] must be an object.`);
+  const url = stringValue(input.url) || stringValue(input.glob) || stringValue(input.pattern);
+  if (!url) throw new Error(`target.network_mocks[${index}] requires url.`);
+  const status = numberValue(input.status) ?? 200;
+  if (!Number.isInteger(status) || status < 100 || status > 599) {
+    throw new Error(`target.network_mocks[${index}].status must be an HTTP status code.`);
+  }
+  const body = stringValue(input.body) ?? stringValue(input.body_text) ?? stringValue(input.bodyText);
+  const hasJsonBody = Object.prototype.hasOwnProperty.call(input, "body_json") || Object.prototype.hasOwnProperty.call(input, "bodyJson") || Object.prototype.hasOwnProperty.call(input, "json");
+  return {
+    label: normalizeName(input.label || input.name, `network-mock-${index + 1}`),
+    url,
+    method: stringValue(input.method)?.toUpperCase(),
+    status,
+    content_type: stringValue(input.content_type) || stringValue(input.contentType),
+    headers: stringRecord(input.headers),
+    body,
+    body_json: hasJsonBody ? toJsonValue(input.body_json ?? input.bodyJson ?? input.json) : void 0,
+    required: input.required === false ? false : true
+  };
+}
+function normalizeNetworkMocks(value) {
+  if (value === void 0) return void 0;
+  if (!Array.isArray(value)) throw new Error("target.network_mocks must be an array.");
+  return value.map(normalizeNetworkMock);
+}
 function normalizeCheck(input, index) {
   if (!isRecord(input)) throw new Error(`checks[${index}] must be an object.`);
   const type = stringValue(input.type);
@@ -259,7 +291,8 @@ function normalizeRiddleProofProfile(input, options = {}) {
       timeout_sec: timeoutSecValue(targetInput.timeout_sec) ?? timeoutSecValue(targetInput.timeoutSec) ?? timeoutSecValue(targetInput.riddle_timeout_sec) ?? timeoutSecValue(targetInput.riddleTimeoutSec),
       wait_for_selector: stringValue(targetInput.wait_for_selector) || stringValue(targetInput.waitForSelector),
       wait_ms: numberValue(targetInput.wait_ms) ?? numberValue(targetInput.waitMs),
-      setup_actions: normalizeSetupActions(targetInput.setup_actions ?? targetInput.setupActions)
+      setup_actions: normalizeSetupActions(targetInput.setup_actions ?? targetInput.setupActions),
+      network_mocks: normalizeNetworkMocks(targetInput.network_mocks ?? targetInput.networkMocks)
     },
     checks,
     artifacts: Array.isArray(input.artifacts) ? input.artifacts.map((item) => String(item)).filter(Boolean) : ["screenshot", "console", "dom_summary", "proof_json"],
@@ -531,6 +564,50 @@ function assessSetupActionsFromEvidence(profile, evidence) {
     message: failed.length ? `Setup actions failed in ${failed.length} viewport action(s).` : void 0
   };
 }
+function assessNetworkMocksFromEvidence(profile, evidence) {
+  const mocks = profile.target.network_mocks || [];
+  if (!mocks.length) return void 0;
+  const events = evidence.network_mocks || [];
+  const failed = [];
+  const requiredMocks = mocks.filter((mock) => mock.required !== false);
+  for (const mock of requiredMocks) {
+    const hits = events.filter((event) => event.label === mock.label && event.ok !== false).length;
+    if (hits < 1) {
+      failed.push({
+        label: mock.label,
+        url: mock.url,
+        method: mock.method || null,
+        reason: "required_mock_not_hit"
+      });
+    }
+  }
+  for (const event of events) {
+    if (event.ok === false) {
+      failed.push({
+        label: event.label ?? null,
+        url: event.url ?? null,
+        method: event.method ?? null,
+        reason: event.reason ?? event.error ?? "mock_failed"
+      });
+    }
+  }
+  return {
+    type: "network_mocks_succeeded",
+    label: "network mocks succeeded",
+    status: failed.length ? "failed" : "passed",
+    evidence: {
+      mock_count: mocks.length,
+      required_count: requiredMocks.length,
+      hit_count: events.filter((event) => event.ok !== false).length,
+      hits_by_label: Object.fromEntries(mocks.map((mock) => [
+        mock.label,
+        events.filter((event) => event.label === mock.label && event.ok !== false).length
+      ])),
+      failed
+    },
+    message: failed.length ? `Network mocks failed or were not hit for ${failed.length} mock(s).` : void 0
+  };
+}
 function profileStatusFromEvidence(profile, evidence, checks) {
   if (!evidence) return "proof_insufficient";
   const viewports = evidence.viewports || [];
@@ -545,6 +622,7 @@ function profileStatusFromEvidence(profile, evidence, checks) {
 function assessRiddleProofProfileEvidence(profile, evidence, options = {}) {
   const capturedAt = evidence?.captured_at || (/* @__PURE__ */ new Date()).toISOString();
   const checks = evidence ? [
+    assessNetworkMocksFromEvidence(profile, evidence),
     assessSetupActionsFromEvidence(profile, evidence),
     ...profile.checks.map((check) => assessCheckFromEvidence(check, evidence))
   ].filter((check) => Boolean(check)) : [];
@@ -761,6 +839,49 @@ function horizontalBoundsOverflowPx(value) {
 function assessProfile(profile, evidence) {
   const checks = [];
   const viewports = evidence.viewports || [];
+  if (profile.target && Array.isArray(profile.target.network_mocks) && profile.target.network_mocks.length) {
+    const events = evidence.network_mocks || [];
+    const requiredMocks = profile.target.network_mocks.filter((mock) => mock && mock.required !== false);
+    const failed = [];
+    for (const mock of requiredMocks) {
+      const hits = events.filter((event) => event && event.label === mock.label && event.ok !== false).length;
+      if (hits < 1) {
+        failed.push({
+          label: mock.label,
+          url: mock.url,
+          method: mock.method || null,
+          reason: "required_mock_not_hit",
+        });
+      }
+    }
+    for (const event of events) {
+      if (event && event.ok === false) {
+        failed.push({
+          label: event.label || null,
+          url: event.url || null,
+          method: event.method || null,
+          reason: event.reason || event.error || "mock_failed",
+        });
+      }
+    }
+    const hitsByLabel = {};
+    for (const mock of profile.target.network_mocks) {
+      hitsByLabel[mock.label] = events.filter((event) => event && event.label === mock.label && event.ok !== false).length;
+    }
+    checks.push({
+      type: "network_mocks_succeeded",
+      label: "network mocks succeeded",
+      status: failed.length ? "failed" : "passed",
+      evidence: {
+        mock_count: profile.target.network_mocks.length,
+        required_count: requiredMocks.length,
+        hit_count: events.filter((event) => event && event.ok !== false).length,
+        hits_by_label: hitsByLabel,
+        failed,
+      },
+      message: failed.length ? "Network mocks failed or were not hit for " + failed.length + " mock(s)." : undefined,
+    });
+  }
   if (profile.target && Array.isArray(profile.target.setup_actions) && profile.target.setup_actions.length) {
     const actionCount = profile.target.setup_actions.length;
     const failed = [];
@@ -950,6 +1071,7 @@ const profileSlug = ${serializableSlug};
 const capturedAt = new Date().toISOString();
 const consoleEvents = [];
 const pageErrors = [];
+const networkMockEvents = [];
 page.on("console", (message) => {
   const type = message.type();
   if (type === "error" || type === "warning" || type === "assert") {
@@ -996,6 +1118,49 @@ function compactSetupResultText(value) {
 async function setupLocatorVisible(locator, index) {
   return await locator.nth(index).isVisible({ timeout: 1000 }).catch(() => false);
 }
+async function registerNetworkMocks(mocks) {
+  for (const mock of mocks || []) {
+    await page.route(mock.url, async (route) => {
+      const request = route.request();
+      const method = request.method ? request.method() : "";
+      if (mock.method && method.toUpperCase() !== String(mock.method).toUpperCase()) {
+        await route.continue();
+        return;
+      }
+      try {
+        const headers = { ...(mock.headers || {}) };
+        let body = mock.body || "";
+        let contentType = mock.content_type || headers["content-type"] || headers["Content-Type"] || "text/plain";
+        if (mock.body_json !== undefined) {
+          body = JSON.stringify(mock.body_json);
+          contentType = mock.content_type || headers["content-type"] || headers["Content-Type"] || "application/json";
+        }
+        networkMockEvents.push({
+          ok: true,
+          label: mock.label,
+          url: request.url(),
+          method,
+          status: mock.status || 200,
+        });
+        await route.fulfill({
+          status: mock.status || 200,
+          headers,
+          contentType,
+          body,
+        });
+      } catch (error) {
+        networkMockEvents.push({
+          ok: false,
+          label: mock.label,
+          url: request.url(),
+          method,
+          error: String(error && error.message ? error.message : error).slice(0, 1000),
+        });
+        throw error;
+      }
+    });
+  }
+}
 async function executeSetupAction(action, ordinal) {
   const type = setupActionType(action);
   const base = { ok: false, action: type || "unknown", ordinal, selector: action.selector || null };
@@ -1257,6 +1422,7 @@ function buildProfileEvidence(currentViewports) {
       fatal_count: consoleEvents.filter((event) => event.type === "error" || event.type === "assert").length,
     },
     page_errors: pageErrors,
+    network_mocks: networkMockEvents.slice(),
     dom_summary: {
       expected_viewport_count: expectedViewportCount,
       viewport_count: currentViewports.length,
@@ -1266,6 +1432,8 @@ function buildProfileEvidence(currentViewports) {
       overflow_px: currentViewports.map((viewport) => viewport.overflow_px),
       bounds_overflow_px: currentViewports.map((viewport) => viewport.bounds_overflow_px),
       overflow_offender_counts: currentViewports.map((viewport) => (viewport.overflow_offenders || []).length),
+      network_mock_count: (profile.target.network_mocks || []).length,
+      network_mock_hit_count: networkMockEvents.filter((event) => event.ok !== false).length,
     },
   };
 }
@@ -1279,6 +1447,9 @@ async function saveProfileArtifacts(currentViewports) {
   }
   return result;
 }
+await registerNetworkMocks(profile.target.network_mocks || []);
+consoleEvents.length = 0;
+pageErrors.length = 0;
 let result = await saveProfileArtifacts(viewports);
 for (const viewport of profile.target.viewports || []) {
   viewports.push(await captureViewport(viewport));

package/dist/cli.cjs

@@ -6992,6 +6992,11 @@ function jsonRecord(value) {
   if (!isRecord(value)) return void 0;
   return Object.fromEntries(Object.entries(value).map(([key, child]) => [key, toJsonValue(child)]));
 }
+function stringRecord(value) {
+  if (!isRecord(value)) return void 0;
+  const entries = Object.entries(value).map(([key, child]) => [key, String(child)]).filter(([key]) => key.trim());
+  return entries.length ? Object.fromEntries(entries) : void 0;
+}
 function toJsonValue(value) {
   if (value === null || value === void 0) return null;
   if (typeof value === "string" || typeof value === "boolean") return value;
@@ -7063,6 +7068,33 @@ function normalizeSetupActions(value) {
   if (!Array.isArray(value)) throw new Error("target.setup_actions must be an array.");
   return value.map(normalizeSetupAction);
 }
+function normalizeNetworkMock(input, index) {
+  if (!isRecord(input)) throw new Error(`target.network_mocks[${index}] must be an object.`);
+  const url = stringValue2(input.url) || stringValue2(input.glob) || stringValue2(input.pattern);
+  if (!url) throw new Error(`target.network_mocks[${index}] requires url.`);
+  const status = numberValue(input.status) ?? 200;
+  if (!Number.isInteger(status) || status < 100 || status > 599) {
+    throw new Error(`target.network_mocks[${index}].status must be an HTTP status code.`);
+  }
+  const body = stringValue2(input.body) ?? stringValue2(input.body_text) ?? stringValue2(input.bodyText);
+  const hasJsonBody = Object.prototype.hasOwnProperty.call(input, "body_json") || Object.prototype.hasOwnProperty.call(input, "bodyJson") || Object.prototype.hasOwnProperty.call(input, "json");
+  return {
+    label: normalizeName(input.label || input.name, `network-mock-${index + 1}`),
+    url,
+    method: stringValue2(input.method)?.toUpperCase(),
+    status,
+    content_type: stringValue2(input.content_type) || stringValue2(input.contentType),
+    headers: stringRecord(input.headers),
+    body,
+    body_json: hasJsonBody ? toJsonValue(input.body_json ?? input.bodyJson ?? input.json) : void 0,
+    required: input.required === false ? false : true
+  };
+}
+function normalizeNetworkMocks(value) {
+  if (value === void 0) return void 0;
+  if (!Array.isArray(value)) throw new Error("target.network_mocks must be an array.");
+  return value.map(normalizeNetworkMock);
+}
 function normalizeCheck(input, index) {
   if (!isRecord(input)) throw new Error(`checks[${index}] must be an object.`);
   const type = stringValue2(input.type);
@@ -7132,7 +7164,8 @@ function normalizeRiddleProofProfile(input, options = {}) {
       timeout_sec: timeoutSecValue(targetInput.timeout_sec) ?? timeoutSecValue(targetInput.timeoutSec) ?? timeoutSecValue(targetInput.riddle_timeout_sec) ?? timeoutSecValue(targetInput.riddleTimeoutSec),
       wait_for_selector: stringValue2(targetInput.wait_for_selector) || stringValue2(targetInput.waitForSelector),
       wait_ms: numberValue(targetInput.wait_ms) ?? numberValue(targetInput.waitMs),
-      setup_actions: normalizeSetupActions(targetInput.setup_actions ?? targetInput.setupActions)
+      setup_actions: normalizeSetupActions(targetInput.setup_actions ?? targetInput.setupActions),
+      network_mocks: normalizeNetworkMocks(targetInput.network_mocks ?? targetInput.networkMocks)
     },
     checks,
     artifacts: Array.isArray(input.artifacts) ? input.artifacts.map((item) => String(item)).filter(Boolean) : ["screenshot", "console", "dom_summary", "proof_json"],
@@ -7404,6 +7437,50 @@ function assessSetupActionsFromEvidence(profile, evidence) {
     message: failed.length ? `Setup actions failed in ${failed.length} viewport action(s).` : void 0
   };
 }
+function assessNetworkMocksFromEvidence(profile, evidence) {
+  const mocks = profile.target.network_mocks || [];
+  if (!mocks.length) return void 0;
+  const events = evidence.network_mocks || [];
+  const failed = [];
+  const requiredMocks = mocks.filter((mock) => mock.required !== false);
+  for (const mock of requiredMocks) {
+    const hits = events.filter((event) => event.label === mock.label && event.ok !== false).length;
+    if (hits < 1) {
+      failed.push({
+        label: mock.label,
+        url: mock.url,
+        method: mock.method || null,
+        reason: "required_mock_not_hit"
+      });
+    }
+  }
+  for (const event of events) {
+    if (event.ok === false) {
+      failed.push({
+        label: event.label ?? null,
+        url: event.url ?? null,
+        method: event.method ?? null,
+        reason: event.reason ?? event.error ?? "mock_failed"
+      });
+    }
+  }
+  return {
+    type: "network_mocks_succeeded",
+    label: "network mocks succeeded",
+    status: failed.length ? "failed" : "passed",
+    evidence: {
+      mock_count: mocks.length,
+      required_count: requiredMocks.length,
+      hit_count: events.filter((event) => event.ok !== false).length,
+      hits_by_label: Object.fromEntries(mocks.map((mock) => [
+        mock.label,
+        events.filter((event) => event.label === mock.label && event.ok !== false).length
+      ])),
+      failed
+    },
+    message: failed.length ? `Network mocks failed or were not hit for ${failed.length} mock(s).` : void 0
+  };
+}
 function profileStatusFromEvidence(profile, evidence, checks) {
   if (!evidence) return "proof_insufficient";
   const viewports = evidence.viewports || [];
@@ -7418,6 +7495,7 @@ function profileStatusFromEvidence(profile, evidence, checks) {
 function assessRiddleProofProfileEvidence(profile, evidence, options = {}) {
   const capturedAt = evidence?.captured_at || (/* @__PURE__ */ new Date()).toISOString();
   const checks = evidence ? [
+    assessNetworkMocksFromEvidence(profile, evidence),
     assessSetupActionsFromEvidence(profile, evidence),
     ...profile.checks.map((check) => assessCheckFromEvidence(check, evidence))
   ].filter((check) => Boolean(check)) : [];
@@ -7618,6 +7696,49 @@ function horizontalBoundsOverflowPx(value) {
 function assessProfile(profile, evidence) {
   const checks = [];
   const viewports = evidence.viewports || [];
+  if (profile.target && Array.isArray(profile.target.network_mocks) && profile.target.network_mocks.length) {
+    const events = evidence.network_mocks || [];
+    const requiredMocks = profile.target.network_mocks.filter((mock) => mock && mock.required !== false);
+    const failed = [];
+    for (const mock of requiredMocks) {
+      const hits = events.filter((event) => event && event.label === mock.label && event.ok !== false).length;
+      if (hits < 1) {
+        failed.push({
+          label: mock.label,
+          url: mock.url,
+          method: mock.method || null,
+          reason: "required_mock_not_hit",
+        });
+      }
+    }
+    for (const event of events) {
+      if (event && event.ok === false) {
+        failed.push({
+          label: event.label || null,
+          url: event.url || null,
+          method: event.method || null,
+          reason: event.reason || event.error || "mock_failed",
+        });
+      }
+    }
+    const hitsByLabel = {};
+    for (const mock of profile.target.network_mocks) {
+      hitsByLabel[mock.label] = events.filter((event) => event && event.label === mock.label && event.ok !== false).length;
+    }
+    checks.push({
+      type: "network_mocks_succeeded",
+      label: "network mocks succeeded",
+      status: failed.length ? "failed" : "passed",
+      evidence: {
+        mock_count: profile.target.network_mocks.length,
+        required_count: requiredMocks.length,
+        hit_count: events.filter((event) => event && event.ok !== false).length,
+        hits_by_label: hitsByLabel,
+        failed,
+      },
+      message: failed.length ? "Network mocks failed or were not hit for " + failed.length + " mock(s)." : undefined,
+    });
+  }
   if (profile.target && Array.isArray(profile.target.setup_actions) && profile.target.setup_actions.length) {
     const actionCount = profile.target.setup_actions.length;
     const failed = [];
@@ -7807,6 +7928,7 @@ const profileSlug = ${serializableSlug};
 const capturedAt = new Date().toISOString();
 const consoleEvents = [];
 const pageErrors = [];
+const networkMockEvents = [];
 page.on("console", (message) => {
   const type = message.type();
   if (type === "error" || type === "warning" || type === "assert") {
@@ -7853,6 +7975,49 @@ function compactSetupResultText(value) {
 async function setupLocatorVisible(locator, index) {
   return await locator.nth(index).isVisible({ timeout: 1000 }).catch(() => false);
 }
+async function registerNetworkMocks(mocks) {
+  for (const mock of mocks || []) {
+    await page.route(mock.url, async (route) => {
+      const request = route.request();
+      const method = request.method ? request.method() : "";
+      if (mock.method && method.toUpperCase() !== String(mock.method).toUpperCase()) {
+        await route.continue();
+        return;
+      }
+      try {
+        const headers = { ...(mock.headers || {}) };
+        let body = mock.body || "";
+        let contentType = mock.content_type || headers["content-type"] || headers["Content-Type"] || "text/plain";
+        if (mock.body_json !== undefined) {
+          body = JSON.stringify(mock.body_json);
+          contentType = mock.content_type || headers["content-type"] || headers["Content-Type"] || "application/json";
+        }
+        networkMockEvents.push({
+          ok: true,
+          label: mock.label,
+          url: request.url(),
+          method,
+          status: mock.status || 200,
+        });
+        await route.fulfill({
+          status: mock.status || 200,
+          headers,
+          contentType,
+          body,
+        });
+      } catch (error) {
+        networkMockEvents.push({
+          ok: false,
+          label: mock.label,
+          url: request.url(),
+          method,
+          error: String(error && error.message ? error.message : error).slice(0, 1000),
+        });
+        throw error;
+      }
+    });
+  }
+}
 async function executeSetupAction(action, ordinal) {
   const type = setupActionType(action);
   const base = { ok: false, action: type || "unknown", ordinal, selector: action.selector || null };
@@ -8114,6 +8279,7 @@ function buildProfileEvidence(currentViewports) {
       fatal_count: consoleEvents.filter((event) => event.type === "error" || event.type === "assert").length,
     },
     page_errors: pageErrors,
+    network_mocks: networkMockEvents.slice(),
     dom_summary: {
       expected_viewport_count: expectedViewportCount,
       viewport_count: currentViewports.length,
@@ -8123,6 +8289,8 @@ function buildProfileEvidence(currentViewports) {
       overflow_px: currentViewports.map((viewport) => viewport.overflow_px),
       bounds_overflow_px: currentViewports.map((viewport) => viewport.bounds_overflow_px),
       overflow_offender_counts: currentViewports.map((viewport) => (viewport.overflow_offenders || []).length),
+      network_mock_count: (profile.target.network_mocks || []).length,
+      network_mock_hit_count: networkMockEvents.filter((event) => event.ok !== false).length,
     },
   };
 }
@@ -8136,6 +8304,9 @@ async function saveProfileArtifacts(currentViewports) {
   }
   return result;
 }
+await registerNetworkMocks(profile.target.network_mocks || []);
+consoleEvents.length = 0;
+pageErrors.length = 0;
 let result = await saveProfileArtifacts(viewports);
 for (const viewport of profile.target.viewports || []) {
   viewports.push(await captureViewport(viewport));

package/dist/cli.js

@@ -10,7 +10,7 @@ import {
   profileStatusExitCode,
   resolveRiddleProofProfileTargetUrl,
   resolveRiddleProofProfileTimeoutSec
-} from "./chunk-SDSBS64X.js";
+} from "./chunk-FUWINYNX.js";
 import {
   createRiddleApiClient,
   parseRiddleViewport

package/dist/index.cjs

@@ -8833,6 +8833,11 @@ function jsonRecord(value) {
   if (!isRecord2(value)) return void 0;
   return Object.fromEntries(Object.entries(value).map(([key, child]) => [key, toJsonValue(child)]));
 }
+function stringRecord(value) {
+  if (!isRecord2(value)) return void 0;
+  const entries = Object.entries(value).map(([key, child]) => [key, String(child)]).filter(([key]) => key.trim());
+  return entries.length ? Object.fromEntries(entries) : void 0;
+}
 function toJsonValue(value) {
   if (value === null || value === void 0) return null;
   if (typeof value === "string" || typeof value === "boolean") return value;
@@ -8904,6 +8909,33 @@ function normalizeSetupActions(value) {
   if (!Array.isArray(value)) throw new Error("target.setup_actions must be an array.");
   return value.map(normalizeSetupAction);
 }
+function normalizeNetworkMock(input, index) {
+  if (!isRecord2(input)) throw new Error(`target.network_mocks[${index}] must be an object.`);
+  const url = stringValue5(input.url) || stringValue5(input.glob) || stringValue5(input.pattern);
+  if (!url) throw new Error(`target.network_mocks[${index}] requires url.`);
+  const status = numberValue3(input.status) ?? 200;
+  if (!Number.isInteger(status) || status < 100 || status > 599) {
+    throw new Error(`target.network_mocks[${index}].status must be an HTTP status code.`);
+  }
+  const body = stringValue5(input.body) ?? stringValue5(input.body_text) ?? stringValue5(input.bodyText);
+  const hasJsonBody = Object.prototype.hasOwnProperty.call(input, "body_json") || Object.prototype.hasOwnProperty.call(input, "bodyJson") || Object.prototype.hasOwnProperty.call(input, "json");
+  return {
+    label: normalizeName(input.label || input.name, `network-mock-${index + 1}`),
+    url,
+    method: stringValue5(input.method)?.toUpperCase(),
+    status,
+    content_type: stringValue5(input.content_type) || stringValue5(input.contentType),
+    headers: stringRecord(input.headers),
+    body,
+    body_json: hasJsonBody ? toJsonValue(input.body_json ?? input.bodyJson ?? input.json) : void 0,
+    required: input.required === false ? false : true
+  };
+}
+function normalizeNetworkMocks(value) {
+  if (value === void 0) return void 0;
+  if (!Array.isArray(value)) throw new Error("target.network_mocks must be an array.");
+  return value.map(normalizeNetworkMock);
+}
 function normalizeCheck(input, index) {
   if (!isRecord2(input)) throw new Error(`checks[${index}] must be an object.`);
   const type = stringValue5(input.type);
@@ -8973,7 +9005,8 @@ function normalizeRiddleProofProfile(input, options = {}) {
       timeout_sec: timeoutSecValue(targetInput.timeout_sec) ?? timeoutSecValue(targetInput.timeoutSec) ?? timeoutSecValue(targetInput.riddle_timeout_sec) ?? timeoutSecValue(targetInput.riddleTimeoutSec),
       wait_for_selector: stringValue5(targetInput.wait_for_selector) || stringValue5(targetInput.waitForSelector),
       wait_ms: numberValue3(targetInput.wait_ms) ?? numberValue3(targetInput.waitMs),
-      setup_actions: normalizeSetupActions(targetInput.setup_actions ?? targetInput.setupActions)
+      setup_actions: normalizeSetupActions(targetInput.setup_actions ?? targetInput.setupActions),
+      network_mocks: normalizeNetworkMocks(targetInput.network_mocks ?? targetInput.networkMocks)
     },
     checks,
     artifacts: Array.isArray(input.artifacts) ? input.artifacts.map((item) => String(item)).filter(Boolean) : ["screenshot", "console", "dom_summary", "proof_json"],
@@ -9245,6 +9278,50 @@ function assessSetupActionsFromEvidence(profile, evidence) {
     message: failed.length ? `Setup actions failed in ${failed.length} viewport action(s).` : void 0
   };
 }
+function assessNetworkMocksFromEvidence(profile, evidence) {
+  const mocks = profile.target.network_mocks || [];
+  if (!mocks.length) return void 0;
+  const events = evidence.network_mocks || [];
+  const failed = [];
+  const requiredMocks = mocks.filter((mock) => mock.required !== false);
+  for (const mock of requiredMocks) {
+    const hits = events.filter((event) => event.label === mock.label && event.ok !== false).length;
+    if (hits < 1) {
+      failed.push({
+        label: mock.label,
+        url: mock.url,
+        method: mock.method || null,
+        reason: "required_mock_not_hit"
+      });
+    }
+  }
+  for (const event of events) {
+    if (event.ok === false) {
+      failed.push({
+        label: event.label ?? null,
+        url: event.url ?? null,
+        method: event.method ?? null,
+        reason: event.reason ?? event.error ?? "mock_failed"
+      });
+    }
+  }
+  return {
+    type: "network_mocks_succeeded",
+    label: "network mocks succeeded",
+    status: failed.length ? "failed" : "passed",
+    evidence: {
+      mock_count: mocks.length,
+      required_count: requiredMocks.length,
+      hit_count: events.filter((event) => event.ok !== false).length,
+      hits_by_label: Object.fromEntries(mocks.map((mock) => [
+        mock.label,
+        events.filter((event) => event.label === mock.label && event.ok !== false).length
+      ])),
+      failed
+    },
+    message: failed.length ? `Network mocks failed or were not hit for ${failed.length} mock(s).` : void 0
+  };
+}
 function profileStatusFromEvidence(profile, evidence, checks) {
   if (!evidence) return "proof_insufficient";
   const viewports = evidence.viewports || [];
@@ -9259,6 +9336,7 @@ function profileStatusFromEvidence(profile, evidence, checks) {
 function assessRiddleProofProfileEvidence(profile, evidence, options = {}) {
   const capturedAt = evidence?.captured_at || (/* @__PURE__ */ new Date()).toISOString();
   const checks = evidence ? [
+    assessNetworkMocksFromEvidence(profile, evidence),
     assessSetupActionsFromEvidence(profile, evidence),
     ...profile.checks.map((check) => assessCheckFromEvidence(check, evidence))
   ].filter((check) => Boolean(check)) : [];
@@ -9475,6 +9553,49 @@ function horizontalBoundsOverflowPx(value) {
 function assessProfile(profile, evidence) {
   const checks = [];
   const viewports = evidence.viewports || [];
+  if (profile.target && Array.isArray(profile.target.network_mocks) && profile.target.network_mocks.length) {
+    const events = evidence.network_mocks || [];
+    const requiredMocks = profile.target.network_mocks.filter((mock) => mock && mock.required !== false);
+    const failed = [];
+    for (const mock of requiredMocks) {
+      const hits = events.filter((event) => event && event.label === mock.label && event.ok !== false).length;
+      if (hits < 1) {
+        failed.push({
+          label: mock.label,
+          url: mock.url,
+          method: mock.method || null,
+          reason: "required_mock_not_hit",
+        });
+      }
+    }
+    for (const event of events) {
+      if (event && event.ok === false) {
+        failed.push({
+          label: event.label || null,
+          url: event.url || null,
+          method: event.method || null,
+          reason: event.reason || event.error || "mock_failed",
+        });
+      }
+    }
+    const hitsByLabel = {};
+    for (const mock of profile.target.network_mocks) {
+      hitsByLabel[mock.label] = events.filter((event) => event && event.label === mock.label && event.ok !== false).length;
+    }
+    checks.push({
+      type: "network_mocks_succeeded",
+      label: "network mocks succeeded",
+      status: failed.length ? "failed" : "passed",
+      evidence: {
+        mock_count: profile.target.network_mocks.length,
+        required_count: requiredMocks.length,
+        hit_count: events.filter((event) => event && event.ok !== false).length,
+        hits_by_label: hitsByLabel,
+        failed,
+      },
+      message: failed.length ? "Network mocks failed or were not hit for " + failed.length + " mock(s)." : undefined,
+    });
+  }
   if (profile.target && Array.isArray(profile.target.setup_actions) && profile.target.setup_actions.length) {
     const actionCount = profile.target.setup_actions.length;
     const failed = [];
@@ -9664,6 +9785,7 @@ const profileSlug = ${serializableSlug};
 const capturedAt = new Date().toISOString();
 const consoleEvents = [];
 const pageErrors = [];
+const networkMockEvents = [];
 page.on("console", (message) => {
   const type = message.type();
   if (type === "error" || type === "warning" || type === "assert") {
@@ -9710,6 +9832,49 @@ function compactSetupResultText(value) {
 async function setupLocatorVisible(locator, index) {
   return await locator.nth(index).isVisible({ timeout: 1000 }).catch(() => false);
 }
+async function registerNetworkMocks(mocks) {
+  for (const mock of mocks || []) {
+    await page.route(mock.url, async (route) => {
+      const request = route.request();
+      const method = request.method ? request.method() : "";
+      if (mock.method && method.toUpperCase() !== String(mock.method).toUpperCase()) {
+        await route.continue();
+        return;
+      }
+      try {
+        const headers = { ...(mock.headers || {}) };
+        let body = mock.body || "";
+        let contentType = mock.content_type || headers["content-type"] || headers["Content-Type"] || "text/plain";
+        if (mock.body_json !== undefined) {
+          body = JSON.stringify(mock.body_json);
+          contentType = mock.content_type || headers["content-type"] || headers["Content-Type"] || "application/json";
+        }
+        networkMockEvents.push({
+          ok: true,
+          label: mock.label,
+          url: request.url(),
+          method,
+          status: mock.status || 200,
+        });
+        await route.fulfill({
+          status: mock.status || 200,
+          headers,
+          contentType,
+          body,
+        });
+      } catch (error) {
+        networkMockEvents.push({
+          ok: false,
+          label: mock.label,
+          url: request.url(),
+          method,
+          error: String(error && error.message ? error.message : error).slice(0, 1000),
+        });
+        throw error;
+      }
+    });
+  }
+}
 async function executeSetupAction(action, ordinal) {
   const type = setupActionType(action);
   const base = { ok: false, action: type || "unknown", ordinal, selector: action.selector || null };
@@ -9971,6 +10136,7 @@ function buildProfileEvidence(currentViewports) {
       fatal_count: consoleEvents.filter((event) => event.type === "error" || event.type === "assert").length,
     },
     page_errors: pageErrors,
+    network_mocks: networkMockEvents.slice(),
     dom_summary: {
       expected_viewport_count: expectedViewportCount,
       viewport_count: currentViewports.length,
@@ -9980,6 +10146,8 @@ function buildProfileEvidence(currentViewports) {
       overflow_px: currentViewports.map((viewport) => viewport.overflow_px),
       bounds_overflow_px: currentViewports.map((viewport) => viewport.bounds_overflow_px),
       overflow_offender_counts: currentViewports.map((viewport) => (viewport.overflow_offenders || []).length),
+      network_mock_count: (profile.target.network_mocks || []).length,
+      network_mock_hit_count: networkMockEvents.filter((event) => event.ok !== false).length,
     },
   };
 }
@@ -9993,6 +10161,9 @@ async function saveProfileArtifacts(currentViewports) {
   }
   return result;
 }
+await registerNetworkMocks(profile.target.network_mocks || []);
+consoleEvents.length = 0;
+pageErrors.length = 0;
 let result = await saveProfileArtifacts(viewports);
 for (const viewport of profile.target.viewports || []) {
   viewports.push(await captureViewport(viewport));

package/dist/index.d.cts

@@ -10,5 +10,5 @@ export { CreateCaptureDiagnosticInput, DEFAULT_DIAGNOSTIC_ARRAY_LIMIT, DEFAULT_D
 export { BuildVisualProofSessionInput, RIDDLE_PROOF_VISUAL_SESSION_FINGERPRINT_VERSION, RIDDLE_PROOF_VISUAL_SESSION_VERSION, VisualProofSessionMismatch, buildVisualProofSession, compareVisualProofSessionFingerprint, parseVisualProofSession, visualSessionFingerprint, visualSessionFingerprintBasis } from './proof-session.cjs';
 export { AssessPlayabilityOptions, RIDDLE_PROOF_PLAYABILITY_ASSESSMENT_VERSION, RIDDLE_PROOF_PLAYABILITY_VERSION, RiddleProofPlayabilityAssessment, RiddleProofPlayabilityEvidence, assessPlayabilityEvidence, extractPlayabilityEvidence, isRiddleProofPlayabilityMode } from './playability.cjs';
 export { AssessBasicGameplayOptions, AttachBasicGameplayArtifactOptions, BASIC_GAMEPLAY_ACTION_TYPES, BASIC_GAMEPLAY_PROGRESS_CHECK_TYPES, BasicGameplayActionResult, BasicGameplayActionType, BasicGameplayArtifactResolution, BasicGameplayAssessmentSummary, BasicGameplayBoundsOffender, BasicGameplayCanvasState, BasicGameplayCatchRecord, BasicGameplayChangeSummary, BasicGameplayFailureCode, BasicGameplayFixReference, BasicGameplayMetric, BasicGameplayMobileEvidence, BasicGameplayProgressCheckType, BasicGameplayProgressionCheck, BasicGameplayProofArtifact, BasicGameplayResponsiveViewportEvidence, BasicGameplayRouteReference, BasicGameplaySnapshot, BasicGameplaySuiteFailure, BasicGameplayWarningCode, CreateBasicGameplayCatchSummaryInput, RIDDLE_PROOF_BASIC_GAMEPLAY_ASSESSMENT_VERSION, RIDDLE_PROOF_BASIC_GAMEPLAY_CATCH_VERSION, RIDDLE_PROOF_BASIC_GAMEPLAY_VERSION, RiddleProofBasicGameplayAssessment, RiddleProofBasicGameplayCatchSummary, RiddleProofBasicGameplayEvidence, RiddleProofBasicGameplayRouteAssessment, RiddleProofBasicGameplayRouteEvidence, assessBasicGameplayEvidence, assessBasicGameplayProgressionCheck, assessBasicGameplayProgressionChecks, assessBasicGameplayRoute, attachBasicGameplayArtifactScreenshotHashes, augmentBasicGameplayAssessmentWithProgressionChecks, compactBasicGameplayText, createBasicGameplayCatchRecords, createBasicGameplayCatchSummary, extractBasicGameplayEvidence, resolveBasicGameplayProgressionCheckWithArtifactScreenshots, sanitizeBasicGameplayJsonString } from './basic-gameplay.cjs';
-export { NormalizeRiddleProofProfileOptions, RIDDLE_PROOF_PROFILE_CHECK_TYPES, RIDDLE_PROOF_PROFILE_EVIDENCE_VERSION, RIDDLE_PROOF_PROFILE_RESULT_VERSION, RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES, RIDDLE_PROOF_PROFILE_STATUSES, RIDDLE_PROOF_PROFILE_VERSION, RiddleProofProfile, RiddleProofProfileArtifactRef, RiddleProofProfileBaselinePolicy, RiddleProofProfileBoundsOffender, RiddleProofProfileCheck, RiddleProofProfileCheckResult, RiddleProofProfileCheckType, RiddleProofProfileEvidence, RiddleProofProfileFailureAction, RiddleProofProfileResult, RiddleProofProfileRouteEvidence, RiddleProofProfileRunner, RiddleProofProfileSetupAction, RiddleProofProfileSetupActionType, RiddleProofProfileStatus, RiddleProofProfileTarget, RiddleProofProfileViewport, RiddleProofProfileViewportEvidence, assessRiddleProofProfileEvidence, buildRiddleProofProfileScript, collectRiddleProfileArtifactRefs, createRiddleProofProfileConfigurationError, createRiddleProofProfileEnvironmentBlockedResult, createRiddleProofProfileInsufficientResult, extractRiddleProofProfileResult, normalizeRiddleProofProfile, profileStatusExitCode, resolveRiddleProofProfileRouteUrl, resolveRiddleProofProfileTargetUrl, resolveRiddleProofProfileTimeoutSec, slugifyRiddleProofProfileName, summarizeRiddleProofProfileResult } from './profile.cjs';
+export { NormalizeRiddleProofProfileOptions, RIDDLE_PROOF_PROFILE_CHECK_TYPES, RIDDLE_PROOF_PROFILE_EVIDENCE_VERSION, RIDDLE_PROOF_PROFILE_RESULT_VERSION, RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES, RIDDLE_PROOF_PROFILE_STATUSES, RIDDLE_PROOF_PROFILE_VERSION, RiddleProofProfile, RiddleProofProfileArtifactRef, RiddleProofProfileBaselinePolicy, RiddleProofProfileBoundsOffender, RiddleProofProfileCheck, RiddleProofProfileCheckResult, RiddleProofProfileCheckType, RiddleProofProfileEvidence, RiddleProofProfileFailureAction, RiddleProofProfileNetworkMock, RiddleProofProfileResult, RiddleProofProfileRouteEvidence, RiddleProofProfileRunner, RiddleProofProfileSetupAction, RiddleProofProfileSetupActionType, RiddleProofProfileStatus, RiddleProofProfileTarget, RiddleProofProfileViewport, RiddleProofProfileViewportEvidence, assessRiddleProofProfileEvidence, buildRiddleProofProfileScript, collectRiddleProfileArtifactRefs, createRiddleProofProfileConfigurationError, createRiddleProofProfileEnvironmentBlockedResult, createRiddleProofProfileInsufficientResult, extractRiddleProofProfileResult, normalizeRiddleProofProfile, profileStatusExitCode, resolveRiddleProofProfileRouteUrl, resolveRiddleProofProfileTargetUrl, resolveRiddleProofProfileTimeoutSec, slugifyRiddleProofProfileName, summarizeRiddleProofProfileResult } from './profile.cjs';
 export { DEFAULT_RIDDLE_API_BASE_URL, DEFAULT_RIDDLE_API_KEY_FILE, RiddleApiError, RiddleClientConfig, RiddleFetch, RiddlePollJobOptions, RiddlePollJobResult, RiddlePollProgressSnapshot, RiddlePollSummary, RiddlePreviewDeployResult, RiddleRunScriptInput, RiddleServerPreviewInput, RiddleServerPreviewResult, createRiddleApiClient, deployRiddleStaticPreview, isTerminalRiddleJobStatus, parseRiddleViewport, pollRiddleJob, resolveRiddleApiKey, riddleRequestJson, runRiddleScript, runRiddleServerPreview } from './riddle-client.cjs';

package/dist/index.d.ts

@@ -10,5 +10,5 @@ export { CreateCaptureDiagnosticInput, DEFAULT_DIAGNOSTIC_ARRAY_LIMIT, DEFAULT_D
 export { BuildVisualProofSessionInput, RIDDLE_PROOF_VISUAL_SESSION_FINGERPRINT_VERSION, RIDDLE_PROOF_VISUAL_SESSION_VERSION, VisualProofSessionMismatch, buildVisualProofSession, compareVisualProofSessionFingerprint, parseVisualProofSession, visualSessionFingerprint, visualSessionFingerprintBasis } from './proof-session.js';
 export { AssessPlayabilityOptions, RIDDLE_PROOF_PLAYABILITY_ASSESSMENT_VERSION, RIDDLE_PROOF_PLAYABILITY_VERSION, RiddleProofPlayabilityAssessment, RiddleProofPlayabilityEvidence, assessPlayabilityEvidence, extractPlayabilityEvidence, isRiddleProofPlayabilityMode } from './playability.js';
 export { AssessBasicGameplayOptions, AttachBasicGameplayArtifactOptions, BASIC_GAMEPLAY_ACTION_TYPES, BASIC_GAMEPLAY_PROGRESS_CHECK_TYPES, BasicGameplayActionResult, BasicGameplayActionType, BasicGameplayArtifactResolution, BasicGameplayAssessmentSummary, BasicGameplayBoundsOffender, BasicGameplayCanvasState, BasicGameplayCatchRecord, BasicGameplayChangeSummary, BasicGameplayFailureCode, BasicGameplayFixReference, BasicGameplayMetric, BasicGameplayMobileEvidence, BasicGameplayProgressCheckType, BasicGameplayProgressionCheck, BasicGameplayProofArtifact, BasicGameplayResponsiveViewportEvidence, BasicGameplayRouteReference, BasicGameplaySnapshot, BasicGameplaySuiteFailure, BasicGameplayWarningCode, CreateBasicGameplayCatchSummaryInput, RIDDLE_PROOF_BASIC_GAMEPLAY_ASSESSMENT_VERSION, RIDDLE_PROOF_BASIC_GAMEPLAY_CATCH_VERSION, RIDDLE_PROOF_BASIC_GAMEPLAY_VERSION, RiddleProofBasicGameplayAssessment, RiddleProofBasicGameplayCatchSummary, RiddleProofBasicGameplayEvidence, RiddleProofBasicGameplayRouteAssessment, RiddleProofBasicGameplayRouteEvidence, assessBasicGameplayEvidence, assessBasicGameplayProgressionCheck, assessBasicGameplayProgressionChecks, assessBasicGameplayRoute, attachBasicGameplayArtifactScreenshotHashes, augmentBasicGameplayAssessmentWithProgressionChecks, compactBasicGameplayText, createBasicGameplayCatchRecords, createBasicGameplayCatchSummary, extractBasicGameplayEvidence, resolveBasicGameplayProgressionCheckWithArtifactScreenshots, sanitizeBasicGameplayJsonString } from './basic-gameplay.js';
-export { NormalizeRiddleProofProfileOptions, RIDDLE_PROOF_PROFILE_CHECK_TYPES, RIDDLE_PROOF_PROFILE_EVIDENCE_VERSION, RIDDLE_PROOF_PROFILE_RESULT_VERSION, RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES, RIDDLE_PROOF_PROFILE_STATUSES, RIDDLE_PROOF_PROFILE_VERSION, RiddleProofProfile, RiddleProofProfileArtifactRef, RiddleProofProfileBaselinePolicy, RiddleProofProfileBoundsOffender, RiddleProofProfileCheck, RiddleProofProfileCheckResult, RiddleProofProfileCheckType, RiddleProofProfileEvidence, RiddleProofProfileFailureAction, RiddleProofProfileResult, RiddleProofProfileRouteEvidence, RiddleProofProfileRunner, RiddleProofProfileSetupAction, RiddleProofProfileSetupActionType, RiddleProofProfileStatus, RiddleProofProfileTarget, RiddleProofProfileViewport, RiddleProofProfileViewportEvidence, assessRiddleProofProfileEvidence, buildRiddleProofProfileScript, collectRiddleProfileArtifactRefs, createRiddleProofProfileConfigurationError, createRiddleProofProfileEnvironmentBlockedResult, createRiddleProofProfileInsufficientResult, extractRiddleProofProfileResult, normalizeRiddleProofProfile, profileStatusExitCode, resolveRiddleProofProfileRouteUrl, resolveRiddleProofProfileTargetUrl, resolveRiddleProofProfileTimeoutSec, slugifyRiddleProofProfileName, summarizeRiddleProofProfileResult } from './profile.js';
+export { NormalizeRiddleProofProfileOptions, RIDDLE_PROOF_PROFILE_CHECK_TYPES, RIDDLE_PROOF_PROFILE_EVIDENCE_VERSION, RIDDLE_PROOF_PROFILE_RESULT_VERSION, RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES, RIDDLE_PROOF_PROFILE_STATUSES, RIDDLE_PROOF_PROFILE_VERSION, RiddleProofProfile, RiddleProofProfileArtifactRef, RiddleProofProfileBaselinePolicy, RiddleProofProfileBoundsOffender, RiddleProofProfileCheck, RiddleProofProfileCheckResult, RiddleProofProfileCheckType, RiddleProofProfileEvidence, RiddleProofProfileFailureAction, RiddleProofProfileNetworkMock, RiddleProofProfileResult, RiddleProofProfileRouteEvidence, RiddleProofProfileRunner, RiddleProofProfileSetupAction, RiddleProofProfileSetupActionType, RiddleProofProfileStatus, RiddleProofProfileTarget, RiddleProofProfileViewport, RiddleProofProfileViewportEvidence, assessRiddleProofProfileEvidence, buildRiddleProofProfileScript, collectRiddleProfileArtifactRefs, createRiddleProofProfileConfigurationError, createRiddleProofProfileEnvironmentBlockedResult, createRiddleProofProfileInsufficientResult, extractRiddleProofProfileResult, normalizeRiddleProofProfile, profileStatusExitCode, resolveRiddleProofProfileRouteUrl, resolveRiddleProofProfileTargetUrl, resolveRiddleProofProfileTimeoutSec, slugifyRiddleProofProfileName, summarizeRiddleProofProfileResult } from './profile.js';
 export { DEFAULT_RIDDLE_API_BASE_URL, DEFAULT_RIDDLE_API_KEY_FILE, RiddleApiError, RiddleClientConfig, RiddleFetch, RiddlePollJobOptions, RiddlePollJobResult, RiddlePollProgressSnapshot, RiddlePollSummary, RiddlePreviewDeployResult, RiddleRunScriptInput, RiddleServerPreviewInput, RiddleServerPreviewResult, createRiddleApiClient, deployRiddleStaticPreview, isTerminalRiddleJobStatus, parseRiddleViewport, pollRiddleJob, resolveRiddleApiKey, riddleRequestJson, runRiddleScript, runRiddleServerPreview } from './riddle-client.js';

package/dist/index.js

@@ -58,7 +58,7 @@ import {
   resolveRiddleProofProfileTimeoutSec,
   slugifyRiddleProofProfileName,
   summarizeRiddleProofProfileResult
-} from "./chunk-SDSBS64X.js";
+} from "./chunk-FUWINYNX.js";
 import {
   DEFAULT_RIDDLE_API_BASE_URL,
   DEFAULT_RIDDLE_API_KEY_FILE,

package/dist/profile.cjs

@@ -162,6 +162,11 @@ function jsonRecord(value) {
   if (!isRecord(value)) return void 0;
   return Object.fromEntries(Object.entries(value).map(([key, child]) => [key, toJsonValue(child)]));
 }
+function stringRecord(value) {
+  if (!isRecord(value)) return void 0;
+  const entries = Object.entries(value).map(([key, child]) => [key, String(child)]).filter(([key]) => key.trim());
+  return entries.length ? Object.fromEntries(entries) : void 0;
+}
 function toJsonValue(value) {
   if (value === null || value === void 0) return null;
   if (typeof value === "string" || typeof value === "boolean") return value;
@@ -233,6 +238,33 @@ function normalizeSetupActions(value) {
   if (!Array.isArray(value)) throw new Error("target.setup_actions must be an array.");
   return value.map(normalizeSetupAction);
 }
+function normalizeNetworkMock(input, index) {
+  if (!isRecord(input)) throw new Error(`target.network_mocks[${index}] must be an object.`);
+  const url = stringValue(input.url) || stringValue(input.glob) || stringValue(input.pattern);
+  if (!url) throw new Error(`target.network_mocks[${index}] requires url.`);
+  const status = numberValue(input.status) ?? 200;
+  if (!Number.isInteger(status) || status < 100 || status > 599) {
+    throw new Error(`target.network_mocks[${index}].status must be an HTTP status code.`);
+  }
+  const body = stringValue(input.body) ?? stringValue(input.body_text) ?? stringValue(input.bodyText);
+  const hasJsonBody = Object.prototype.hasOwnProperty.call(input, "body_json") || Object.prototype.hasOwnProperty.call(input, "bodyJson") || Object.prototype.hasOwnProperty.call(input, "json");
+  return {
+    label: normalizeName(input.label || input.name, `network-mock-${index + 1}`),
+    url,
+    method: stringValue(input.method)?.toUpperCase(),
+    status,
+    content_type: stringValue(input.content_type) || stringValue(input.contentType),
+    headers: stringRecord(input.headers),
+    body,
+    body_json: hasJsonBody ? toJsonValue(input.body_json ?? input.bodyJson ?? input.json) : void 0,
+    required: input.required === false ? false : true
+  };
+}
+function normalizeNetworkMocks(value) {
+  if (value === void 0) return void 0;
+  if (!Array.isArray(value)) throw new Error("target.network_mocks must be an array.");
+  return value.map(normalizeNetworkMock);
+}
 function normalizeCheck(input, index) {
   if (!isRecord(input)) throw new Error(`checks[${index}] must be an object.`);
   const type = stringValue(input.type);
@@ -302,7 +334,8 @@ function normalizeRiddleProofProfile(input, options = {}) {
       timeout_sec: timeoutSecValue(targetInput.timeout_sec) ?? timeoutSecValue(targetInput.timeoutSec) ?? timeoutSecValue(targetInput.riddle_timeout_sec) ?? timeoutSecValue(targetInput.riddleTimeoutSec),
       wait_for_selector: stringValue(targetInput.wait_for_selector) || stringValue(targetInput.waitForSelector),
       wait_ms: numberValue(targetInput.wait_ms) ?? numberValue(targetInput.waitMs),
-      setup_actions: normalizeSetupActions(targetInput.setup_actions ?? targetInput.setupActions)
+      setup_actions: normalizeSetupActions(targetInput.setup_actions ?? targetInput.setupActions),
+      network_mocks: normalizeNetworkMocks(targetInput.network_mocks ?? targetInput.networkMocks)
     },
     checks,
     artifacts: Array.isArray(input.artifacts) ? input.artifacts.map((item) => String(item)).filter(Boolean) : ["screenshot", "console", "dom_summary", "proof_json"],
@@ -574,6 +607,50 @@ function assessSetupActionsFromEvidence(profile, evidence) {
     message: failed.length ? `Setup actions failed in ${failed.length} viewport action(s).` : void 0
   };
 }
+function assessNetworkMocksFromEvidence(profile, evidence) {
+  const mocks = profile.target.network_mocks || [];
+  if (!mocks.length) return void 0;
+  const events = evidence.network_mocks || [];
+  const failed = [];
+  const requiredMocks = mocks.filter((mock) => mock.required !== false);
+  for (const mock of requiredMocks) {
+    const hits = events.filter((event) => event.label === mock.label && event.ok !== false).length;
+    if (hits < 1) {
+      failed.push({
+        label: mock.label,
+        url: mock.url,
+        method: mock.method || null,
+        reason: "required_mock_not_hit"
+      });
+    }
+  }
+  for (const event of events) {
+    if (event.ok === false) {
+      failed.push({
+        label: event.label ?? null,
+        url: event.url ?? null,
+        method: event.method ?? null,
+        reason: event.reason ?? event.error ?? "mock_failed"
+      });
+    }
+  }
+  return {
+    type: "network_mocks_succeeded",
+    label: "network mocks succeeded",
+    status: failed.length ? "failed" : "passed",
+    evidence: {
+      mock_count: mocks.length,
+      required_count: requiredMocks.length,
+      hit_count: events.filter((event) => event.ok !== false).length,
+      hits_by_label: Object.fromEntries(mocks.map((mock) => [
+        mock.label,
+        events.filter((event) => event.label === mock.label && event.ok !== false).length
+      ])),
+      failed
+    },
+    message: failed.length ? `Network mocks failed or were not hit for ${failed.length} mock(s).` : void 0
+  };
+}
 function profileStatusFromEvidence(profile, evidence, checks) {
   if (!evidence) return "proof_insufficient";
   const viewports = evidence.viewports || [];
@@ -588,6 +665,7 @@ function profileStatusFromEvidence(profile, evidence, checks) {
 function assessRiddleProofProfileEvidence(profile, evidence, options = {}) {
   const capturedAt = evidence?.captured_at || (/* @__PURE__ */ new Date()).toISOString();
   const checks = evidence ? [
+    assessNetworkMocksFromEvidence(profile, evidence),
     assessSetupActionsFromEvidence(profile, evidence),
     ...profile.checks.map((check) => assessCheckFromEvidence(check, evidence))
   ].filter((check) => Boolean(check)) : [];
@@ -804,6 +882,49 @@ function horizontalBoundsOverflowPx(value) {
 function assessProfile(profile, evidence) {
   const checks = [];
   const viewports = evidence.viewports || [];
+  if (profile.target && Array.isArray(profile.target.network_mocks) && profile.target.network_mocks.length) {
+    const events = evidence.network_mocks || [];
+    const requiredMocks = profile.target.network_mocks.filter((mock) => mock && mock.required !== false);
+    const failed = [];
+    for (const mock of requiredMocks) {
+      const hits = events.filter((event) => event && event.label === mock.label && event.ok !== false).length;
+      if (hits < 1) {
+        failed.push({
+          label: mock.label,
+          url: mock.url,
+          method: mock.method || null,
+          reason: "required_mock_not_hit",
+        });
+      }
+    }
+    for (const event of events) {
+      if (event && event.ok === false) {
+        failed.push({
+          label: event.label || null,
+          url: event.url || null,
+          method: event.method || null,
+          reason: event.reason || event.error || "mock_failed",
+        });
+      }
+    }
+    const hitsByLabel = {};
+    for (const mock of profile.target.network_mocks) {
+      hitsByLabel[mock.label] = events.filter((event) => event && event.label === mock.label && event.ok !== false).length;
+    }
+    checks.push({
+      type: "network_mocks_succeeded",
+      label: "network mocks succeeded",
+      status: failed.length ? "failed" : "passed",
+      evidence: {
+        mock_count: profile.target.network_mocks.length,
+        required_count: requiredMocks.length,
+        hit_count: events.filter((event) => event && event.ok !== false).length,
+        hits_by_label: hitsByLabel,
+        failed,
+      },
+      message: failed.length ? "Network mocks failed or were not hit for " + failed.length + " mock(s)." : undefined,
+    });
+  }
   if (profile.target && Array.isArray(profile.target.setup_actions) && profile.target.setup_actions.length) {
     const actionCount = profile.target.setup_actions.length;
     const failed = [];
@@ -993,6 +1114,7 @@ const profileSlug = ${serializableSlug};
 const capturedAt = new Date().toISOString();
 const consoleEvents = [];
 const pageErrors = [];
+const networkMockEvents = [];
 page.on("console", (message) => {
   const type = message.type();
   if (type === "error" || type === "warning" || type === "assert") {
@@ -1039,6 +1161,49 @@ function compactSetupResultText(value) {
 async function setupLocatorVisible(locator, index) {
   return await locator.nth(index).isVisible({ timeout: 1000 }).catch(() => false);
 }
+async function registerNetworkMocks(mocks) {
+  for (const mock of mocks || []) {
+    await page.route(mock.url, async (route) => {
+      const request = route.request();
+      const method = request.method ? request.method() : "";
+      if (mock.method && method.toUpperCase() !== String(mock.method).toUpperCase()) {
+        await route.continue();
+        return;
+      }
+      try {
+        const headers = { ...(mock.headers || {}) };
+        let body = mock.body || "";
+        let contentType = mock.content_type || headers["content-type"] || headers["Content-Type"] || "text/plain";
+        if (mock.body_json !== undefined) {
+          body = JSON.stringify(mock.body_json);
+          contentType = mock.content_type || headers["content-type"] || headers["Content-Type"] || "application/json";
+        }
+        networkMockEvents.push({
+          ok: true,
+          label: mock.label,
+          url: request.url(),
+          method,
+          status: mock.status || 200,
+        });
+        await route.fulfill({
+          status: mock.status || 200,
+          headers,
+          contentType,
+          body,
+        });
+      } catch (error) {
+        networkMockEvents.push({
+          ok: false,
+          label: mock.label,
+          url: request.url(),
+          method,
+          error: String(error && error.message ? error.message : error).slice(0, 1000),
+        });
+        throw error;
+      }
+    });
+  }
+}
 async function executeSetupAction(action, ordinal) {
   const type = setupActionType(action);
   const base = { ok: false, action: type || "unknown", ordinal, selector: action.selector || null };
@@ -1300,6 +1465,7 @@ function buildProfileEvidence(currentViewports) {
       fatal_count: consoleEvents.filter((event) => event.type === "error" || event.type === "assert").length,
     },
     page_errors: pageErrors,
+    network_mocks: networkMockEvents.slice(),
     dom_summary: {
       expected_viewport_count: expectedViewportCount,
       viewport_count: currentViewports.length,
@@ -1309,6 +1475,8 @@ function buildProfileEvidence(currentViewports) {
       overflow_px: currentViewports.map((viewport) => viewport.overflow_px),
       bounds_overflow_px: currentViewports.map((viewport) => viewport.bounds_overflow_px),
       overflow_offender_counts: currentViewports.map((viewport) => (viewport.overflow_offenders || []).length),
+      network_mock_count: (profile.target.network_mocks || []).length,
+      network_mock_hit_count: networkMockEvents.filter((event) => event.ok !== false).length,
     },
   };
 }
@@ -1322,6 +1490,9 @@ async function saveProfileArtifacts(currentViewports) {
   }
   return result;
 }
+await registerNetworkMocks(profile.target.network_mocks || []);
+consoleEvents.length = 0;
+pageErrors.length = 0;
 let result = await saveProfileArtifacts(viewports);
 for (const viewport of profile.target.viewports || []) {
   viewports.push(await captureViewport(viewport));

package/dist/profile.d.cts

@@ -29,6 +29,17 @@ interface RiddleProofProfileSetupAction {
     after_ms?: number;
     continue_on_failure?: boolean;
 }
+interface RiddleProofProfileNetworkMock {
+    label: string;
+    url: string;
+    method?: string;
+    status: number;
+    content_type?: string;
+    headers?: Record<string, string>;
+    body?: string;
+    body_json?: JsonValue;
+    required?: boolean;
+}
 interface RiddleProofProfileTarget {
     url?: string;
     route?: string;
@@ -38,6 +49,7 @@ interface RiddleProofProfileTarget {
     wait_for_selector?: string;
     wait_ms?: number;
     setup_actions?: RiddleProofProfileSetupAction[];
+    network_mocks?: RiddleProofProfileNetworkMock[];
 }
 interface RiddleProofProfileCheck {
     type: RiddleProofProfileCheckType;
@@ -126,6 +138,7 @@ interface RiddleProofProfileEvidence {
     page_errors: Array<{
         message: string;
     }>;
+    network_mocks?: Array<Record<string, JsonValue>>;
     dom_summary?: Record<string, JsonValue>;
 }
 interface RiddleProofProfileCheckResult {
@@ -209,4 +222,4 @@ declare function buildRiddleProofProfileScript(profile: RiddleProofProfile): str
 declare function collectRiddleProfileArtifactRefs(input: unknown): RiddleProofProfileArtifactRef[];
 declare function extractRiddleProofProfileResult(input: unknown): RiddleProofProfileResult | undefined;
 
-export { type NormalizeRiddleProofProfileOptions, RIDDLE_PROOF_PROFILE_CHECK_TYPES, RIDDLE_PROOF_PROFILE_EVIDENCE_VERSION, RIDDLE_PROOF_PROFILE_RESULT_VERSION, RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES, RIDDLE_PROOF_PROFILE_STATUSES, RIDDLE_PROOF_PROFILE_VERSION, type RiddleProofProfile, type RiddleProofProfileArtifactRef, type RiddleProofProfileBaselinePolicy, type RiddleProofProfileBoundsOffender, type RiddleProofProfileCheck, type RiddleProofProfileCheckResult, type RiddleProofProfileCheckType, type RiddleProofProfileEvidence, type RiddleProofProfileFailureAction, type RiddleProofProfileResult, type RiddleProofProfileRouteEvidence, type RiddleProofProfileRunner, type RiddleProofProfileSetupAction, type RiddleProofProfileSetupActionType, type RiddleProofProfileStatus, type RiddleProofProfileTarget, type RiddleProofProfileViewport, type RiddleProofProfileViewportEvidence, assessRiddleProofProfileEvidence, buildRiddleProofProfileScript, collectRiddleProfileArtifactRefs, createRiddleProofProfileConfigurationError, createRiddleProofProfileEnvironmentBlockedResult, createRiddleProofProfileInsufficientResult, extractRiddleProofProfileResult, normalizeRiddleProofProfile, profileStatusExitCode, resolveRiddleProofProfileRouteUrl, resolveRiddleProofProfileTargetUrl, resolveRiddleProofProfileTimeoutSec, slugifyRiddleProofProfileName, summarizeRiddleProofProfileResult };
+export { type NormalizeRiddleProofProfileOptions, RIDDLE_PROOF_PROFILE_CHECK_TYPES, RIDDLE_PROOF_PROFILE_EVIDENCE_VERSION, RIDDLE_PROOF_PROFILE_RESULT_VERSION, RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES, RIDDLE_PROOF_PROFILE_STATUSES, RIDDLE_PROOF_PROFILE_VERSION, type RiddleProofProfile, type RiddleProofProfileArtifactRef, type RiddleProofProfileBaselinePolicy, type RiddleProofProfileBoundsOffender, type RiddleProofProfileCheck, type RiddleProofProfileCheckResult, type RiddleProofProfileCheckType, type RiddleProofProfileEvidence, type RiddleProofProfileFailureAction, type RiddleProofProfileNetworkMock, type RiddleProofProfileResult, type RiddleProofProfileRouteEvidence, type RiddleProofProfileRunner, type RiddleProofProfileSetupAction, type RiddleProofProfileSetupActionType, type RiddleProofProfileStatus, type RiddleProofProfileTarget, type RiddleProofProfileViewport, type RiddleProofProfileViewportEvidence, assessRiddleProofProfileEvidence, buildRiddleProofProfileScript, collectRiddleProfileArtifactRefs, createRiddleProofProfileConfigurationError, createRiddleProofProfileEnvironmentBlockedResult, createRiddleProofProfileInsufficientResult, extractRiddleProofProfileResult, normalizeRiddleProofProfile, profileStatusExitCode, resolveRiddleProofProfileRouteUrl, resolveRiddleProofProfileTargetUrl, resolveRiddleProofProfileTimeoutSec, slugifyRiddleProofProfileName, summarizeRiddleProofProfileResult };

package/dist/profile.d.ts

@@ -29,6 +29,17 @@ interface RiddleProofProfileSetupAction {
     after_ms?: number;
     continue_on_failure?: boolean;
 }
+interface RiddleProofProfileNetworkMock {
+    label: string;
+    url: string;
+    method?: string;
+    status: number;
+    content_type?: string;
+    headers?: Record<string, string>;
+    body?: string;
+    body_json?: JsonValue;
+    required?: boolean;
+}
 interface RiddleProofProfileTarget {
     url?: string;
     route?: string;
@@ -38,6 +49,7 @@ interface RiddleProofProfileTarget {
     wait_for_selector?: string;
     wait_ms?: number;
     setup_actions?: RiddleProofProfileSetupAction[];
+    network_mocks?: RiddleProofProfileNetworkMock[];
 }
 interface RiddleProofProfileCheck {
     type: RiddleProofProfileCheckType;
@@ -126,6 +138,7 @@ interface RiddleProofProfileEvidence {
     page_errors: Array<{
         message: string;
     }>;
+    network_mocks?: Array<Record<string, JsonValue>>;
     dom_summary?: Record<string, JsonValue>;
 }
 interface RiddleProofProfileCheckResult {
@@ -209,4 +222,4 @@ declare function buildRiddleProofProfileScript(profile: RiddleProofProfile): str
 declare function collectRiddleProfileArtifactRefs(input: unknown): RiddleProofProfileArtifactRef[];
 declare function extractRiddleProofProfileResult(input: unknown): RiddleProofProfileResult | undefined;
 
-export { type NormalizeRiddleProofProfileOptions, RIDDLE_PROOF_PROFILE_CHECK_TYPES, RIDDLE_PROOF_PROFILE_EVIDENCE_VERSION, RIDDLE_PROOF_PROFILE_RESULT_VERSION, RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES, RIDDLE_PROOF_PROFILE_STATUSES, RIDDLE_PROOF_PROFILE_VERSION, type RiddleProofProfile, type RiddleProofProfileArtifactRef, type RiddleProofProfileBaselinePolicy, type RiddleProofProfileBoundsOffender, type RiddleProofProfileCheck, type RiddleProofProfileCheckResult, type RiddleProofProfileCheckType, type RiddleProofProfileEvidence, type RiddleProofProfileFailureAction, type RiddleProofProfileResult, type RiddleProofProfileRouteEvidence, type RiddleProofProfileRunner, type RiddleProofProfileSetupAction, type RiddleProofProfileSetupActionType, type RiddleProofProfileStatus, type RiddleProofProfileTarget, type RiddleProofProfileViewport, type RiddleProofProfileViewportEvidence, assessRiddleProofProfileEvidence, buildRiddleProofProfileScript, collectRiddleProfileArtifactRefs, createRiddleProofProfileConfigurationError, createRiddleProofProfileEnvironmentBlockedResult, createRiddleProofProfileInsufficientResult, extractRiddleProofProfileResult, normalizeRiddleProofProfile, profileStatusExitCode, resolveRiddleProofProfileRouteUrl, resolveRiddleProofProfileTargetUrl, resolveRiddleProofProfileTimeoutSec, slugifyRiddleProofProfileName, summarizeRiddleProofProfileResult };
+export { type NormalizeRiddleProofProfileOptions, RIDDLE_PROOF_PROFILE_CHECK_TYPES, RIDDLE_PROOF_PROFILE_EVIDENCE_VERSION, RIDDLE_PROOF_PROFILE_RESULT_VERSION, RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES, RIDDLE_PROOF_PROFILE_STATUSES, RIDDLE_PROOF_PROFILE_VERSION, type RiddleProofProfile, type RiddleProofProfileArtifactRef, type RiddleProofProfileBaselinePolicy, type RiddleProofProfileBoundsOffender, type RiddleProofProfileCheck, type RiddleProofProfileCheckResult, type RiddleProofProfileCheckType, type RiddleProofProfileEvidence, type RiddleProofProfileFailureAction, type RiddleProofProfileNetworkMock, type RiddleProofProfileResult, type RiddleProofProfileRouteEvidence, type RiddleProofProfileRunner, type RiddleProofProfileSetupAction, type RiddleProofProfileSetupActionType, type RiddleProofProfileStatus, type RiddleProofProfileTarget, type RiddleProofProfileViewport, type RiddleProofProfileViewportEvidence, assessRiddleProofProfileEvidence, buildRiddleProofProfileScript, collectRiddleProfileArtifactRefs, createRiddleProofProfileConfigurationError, createRiddleProofProfileEnvironmentBlockedResult, createRiddleProofProfileInsufficientResult, extractRiddleProofProfileResult, normalizeRiddleProofProfile, profileStatusExitCode, resolveRiddleProofProfileRouteUrl, resolveRiddleProofProfileTargetUrl, resolveRiddleProofProfileTimeoutSec, slugifyRiddleProofProfileName, summarizeRiddleProofProfileResult };

package/dist/profile.js

@@ -19,7 +19,7 @@ import {
   resolveRiddleProofProfileTimeoutSec,
   slugifyRiddleProofProfileName,
   summarizeRiddleProofProfileResult
-} from "./chunk-SDSBS64X.js";
+} from "./chunk-FUWINYNX.js";
 export {
   RIDDLE_PROOF_PROFILE_CHECK_TYPES,
   RIDDLE_PROOF_PROFILE_EVIDENCE_VERSION,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@riddledc/riddle-proof",
-  "version": "0.7.26",
+  "version": "0.7.27",
   "description": "Reusable Riddle Proof contracts and helpers for evidence-backed agent changes.",
   "license": "MIT",
   "author": "RiddleDC",