@riddledc/riddle-proof 0.7.97 → 0.7.98

package/dist/index.cjs

@@ -8758,6 +8758,7 @@ var RIDDLE_PROOF_PROFILE_CHECK_TYPES = [
   "frame_no_horizontal_overflow",
   "text_visible",
   "text_absent",
+  "http_status",
   "link_status",
   "artifact_link_status",
   "route_inventory",
@@ -9507,16 +9508,27 @@ function normalizeCheck(input, index) {
   if (type === "route_inventory" && !expectedRoutes?.length) {
     throw new Error(`checks[${index}] route_inventory requires expected_routes.`);
   }
+  const isHttpStatusCheck = type === "http_status";
   const isLinkStatusCheck = type === "link_status" || type === "artifact_link_status";
-  const expectedStatus = isLinkStatusCheck ? normalizeHttpStatus(input.expected_status ?? input.expectedStatus ?? input.status, `checks[${index}] expected_status`) : void 0;
-  const allowedStatuses = isLinkStatusCheck ? normalizeHttpStatuses(
+  const isStatusCheck = isHttpStatusCheck || isLinkStatusCheck;
+  const requestUrl = stringFromOwn(input, "url", "endpoint_url", "endpointUrl", "endpoint", "request_url", "requestUrl", "path");
+  if (isHttpStatusCheck && !requestUrl) {
+    throw new Error(`checks[${index}] http_status requires url.`);
+  }
+  const method = stringFromOwn(input, "method", "http_method", "httpMethod")?.toUpperCase();
+  if (isHttpStatusCheck && method && !/^[A-Z]+$/.test(method)) {
+    throw new Error(`checks[${index}] http_status method must contain only letters.`);
+  }
+  const hasBodyJson = hasOwn(input, "body_json") || hasOwn(input, "bodyJson") || hasOwn(input, "json");
+  const expectedStatus = isStatusCheck ? normalizeHttpStatus(input.expected_status ?? input.expectedStatus ?? input.status, `checks[${index}] expected_status`) : void 0;
+  const allowedStatuses = isStatusCheck ? normalizeHttpStatuses(
     input.allowed_statuses ?? input.allowedStatuses ?? input.expected_statuses ?? input.expectedStatuses,
     `checks[${index}] allowed_statuses`
   ) : void 0;
   const maxLinks = isLinkStatusCheck ? normalizePositiveInteger(input.max_links ?? input.maxLinks ?? input.limit, `checks[${index}] max_links`, 500) : void 0;
-  const minBytes = isLinkStatusCheck ? normalizePositiveInteger(input.min_bytes ?? input.minBytes ?? input.min_response_bytes ?? input.minResponseBytes, `checks[${index}] min_bytes`) : void 0;
-  const expectedContentType = isLinkStatusCheck ? stringValue5(input.expected_content_type) || stringValue5(input.expectedContentType) || stringValue5(input.content_type) || stringValue5(input.contentType) : void 0;
-  const allowedContentTypes = isLinkStatusCheck ? normalizeStringList(
+  const minBytes = isStatusCheck ? normalizePositiveInteger(input.min_bytes ?? input.minBytes ?? input.min_response_bytes ?? input.minResponseBytes, `checks[${index}] min_bytes`) : void 0;
+  const expectedContentType = isStatusCheck ? stringValue5(input.expected_content_type) || stringValue5(input.expectedContentType) || stringValue5(input.content_type) || stringValue5(input.contentType) : void 0;
+  const allowedContentTypes = isStatusCheck ? normalizeStringList(
     input.allowed_content_types ?? input.allowedContentTypes ?? input.expected_content_types ?? input.expectedContentTypes,
     `checks[${index}] allowed_content_types`
   ) ?? (expectedContentType ? [expectedContentType] : void 0) : void 0;
@@ -9537,6 +9549,11 @@ function normalizeCheck(input, index) {
     expected_url: expectedUrl,
     expected_routes: expectedRoutes,
     selector: stringValue5(input.selector),
+    url: isHttpStatusCheck ? requestUrl : void 0,
+    method: isHttpStatusCheck ? method || "GET" : void 0,
+    headers: isHttpStatusCheck ? stringRecord(input.headers) : void 0,
+    body: isHttpStatusCheck ? stringValue5(input.body) : void 0,
+    body_json: isHttpStatusCheck && hasBodyJson ? toJsonValue(input.body_json ?? input.bodyJson ?? input.json) : void 0,
     expected_texts: expectedTexts,
     link_selector: stringValue5(input.link_selector) || stringValue5(input.linkSelector),
     source_selector: stringValue5(input.source_selector) || stringValue5(input.sourceSelector),
@@ -9560,7 +9577,7 @@ function normalizeCheck(input, index) {
     max_links: maxLinks,
     same_origin_only: isLinkStatusCheck ? input.same_origin_only === true || input.sameOriginOnly === true : void 0,
     dedupe: isLinkStatusCheck ? input.dedupe === false ? false : true : void 0,
-    require_nonzero_bytes: isLinkStatusCheck ? input.require_nonzero_bytes === true || input.requireNonzeroBytes === true : void 0,
+    require_nonzero_bytes: isStatusCheck ? input.require_nonzero_bytes === true || input.requireNonzeroBytes === true : void 0,
     min_bytes: minBytes,
     allowed_content_types: allowedContentTypes,
     allow_get_fallback: isLinkStatusCheck ? input.allow_get_fallback === false || input.allowGetFallback === false ? false : true : void 0,
@@ -9659,14 +9676,32 @@ function selectorKey(check) {
 function linkStatusSelector(check) {
   return check.selector || check.link_selector || "a[href]";
 }
-function linkStatusAllowedStatuses(check) {
+function httpStatusRequestUrl(check, baseUrl) {
+  const rawUrl = check.url || "";
+  if (!rawUrl) return "";
+  try {
+    return baseUrl ? new URL(rawUrl, baseUrl).href : new URL(rawUrl).href;
+  } catch {
+    return rawUrl;
+  }
+}
+function httpStatusMethod(check) {
+  return (check.method || "GET").toUpperCase();
+}
+function httpStatusKey(check, baseUrl) {
+  return `${httpStatusMethod(check)} ${httpStatusRequestUrl(check, baseUrl)}`;
+}
+function httpStatusAllowedStatuses(check) {
   if (check.allowed_statuses?.length) return check.allowed_statuses;
   if (check.expected_status !== void 0) return [check.expected_status];
   return void 0;
 }
-function linkStatusIsAllowed(status, check) {
+function linkStatusAllowedStatuses(check) {
+  return httpStatusAllowedStatuses(check);
+}
+function httpStatusIsAllowed(status, check) {
   if (status === void 0) return false;
-  const allowed = linkStatusAllowedStatuses(check);
+  const allowed = httpStatusAllowedStatuses(check);
   return allowed?.length ? allowed.includes(status) : status >= 200 && status < 400;
 }
 function linkStatusObservedBytes(result) {
@@ -9692,7 +9727,7 @@ function linkStatusContentTypeOk(result, check) {
 }
 function linkStatusResultOk(result, check) {
   const status = numberValue3(result.status);
-  if (!linkStatusIsAllowed(status, check)) return false;
+  if (!httpStatusIsAllowed(status, check)) return false;
   if (stringValue5(result.error)) return false;
   if (result.ok === false) return false;
   if (!linkStatusContentTypeOk(result, check)) return false;
@@ -9706,6 +9741,54 @@ function linkStatusResultOk(result, check) {
   }
   return true;
 }
+function httpStatusEvidenceForCheck(viewport, check) {
+  const evidence = viewport.http_statuses?.[httpStatusKey(check, viewport.url)];
+  return isRecord2(evidence) ? evidence : void 0;
+}
+function summarizeHttpStatusEvidence(viewport, check) {
+  const key = httpStatusKey(check, viewport.url);
+  const statusEvidence = httpStatusEvidenceForCheck(viewport, check);
+  if (!statusEvidence) {
+    return {
+      viewport: viewport.name,
+      key,
+      url: httpStatusRequestUrl(check, viewport.url),
+      method: httpStatusMethod(check),
+      ok: false,
+      status: null,
+      failures: [{ code: "http_status_evidence_missing" }]
+    };
+  }
+  const failures = [];
+  if (!linkStatusResultOk(statusEvidence, check)) {
+    failures.push({
+      code: "http_status_failed",
+      url: stringValue5(statusEvidence.url) ?? httpStatusRequestUrl(check, viewport.url),
+      status: numberValue3(statusEvidence.status) ?? null,
+      method: stringValue5(statusEvidence.method) ?? httpStatusMethod(check),
+      error: stringValue5(statusEvidence.error) ?? null,
+      content_type: stringValue5(statusEvidence.content_type) ?? null,
+      bytes: linkStatusObservedBytes(statusEvidence) ?? null,
+      allowed_statuses: httpStatusAllowedStatuses(check) ?? ["2xx", "3xx"],
+      min_bytes: check.min_bytes ?? null,
+      allowed_content_types: check.allowed_content_types ?? null
+    });
+  }
+  return {
+    viewport: viewport.name,
+    key,
+    url: stringValue5(statusEvidence.url) ?? httpStatusRequestUrl(check, viewport.url),
+    method: stringValue5(statusEvidence.method) ?? httpStatusMethod(check),
+    status: numberValue3(statusEvidence.status) ?? null,
+    status_text: stringValue5(statusEvidence.status_text) ?? null,
+    ok: failures.length === 0,
+    error: stringValue5(statusEvidence.error) ?? null,
+    content_type: stringValue5(statusEvidence.content_type) ?? null,
+    content_length: numberValue3(statusEvidence.content_length) ?? null,
+    bytes: linkStatusObservedBytes(statusEvidence) ?? null,
+    failures
+  };
+}
 function linkStatusEvidenceForCheck(viewport, check) {
   const evidence = viewport.link_statuses?.[linkStatusSelector(check)];
   return isRecord2(evidence) ? evidence : void 0;
@@ -10296,6 +10379,28 @@ function assessCheckFromEvidence(check, evidence) {
       message: failed ? `Text assertion failed in ${failed} viewport(s).` : void 0
     };
   }
+  if (check.type === "http_status") {
+    const url = httpStatusRequestUrl(check, evidence.target_url);
+    const method = httpStatusMethod(check);
+    const summaries = viewports.map((viewport) => summarizeHttpStatusEvidence(viewport, check));
+    const failed = summaries.filter((summary) => Array.isArray(summary.failures) && summary.failures.length > 0);
+    return {
+      type: check.type,
+      label: checkLabel(check),
+      status: failed.length ? "failed" : "passed",
+      evidence: {
+        url,
+        method,
+        allowed_statuses: httpStatusAllowedStatuses(check) || ["2xx", "3xx"],
+        require_nonzero_bytes: check.require_nonzero_bytes === true,
+        min_bytes: check.min_bytes ?? null,
+        allowed_content_types: check.allowed_content_types ?? null,
+        viewports: summaries.map((summary) => toJsonValue(summary)),
+        failures: failed.flatMap((summary) => Array.isArray(summary.failures) ? summary.failures.map((failure) => toJsonValue({ viewport: stringValue5(summary.viewport) ?? null, failure })) : [])
+      },
+      message: failed.length ? `HTTP status failed in ${failed.length} viewport(s).` : void 0
+    };
+  }
   if (check.type === "link_status" || check.type === "artifact_link_status") {
     const selector = linkStatusSelector(check);
     const summaries = viewports.map((viewport) => summarizeLinkStatusEvidence(viewport, check));
@@ -10905,16 +11010,37 @@ function textOrderMatch(texts, expectedTexts) {
 function linkStatusSelector(check) {
   return check.selector || check.link_selector || "a[href]";
 }
-function linkStatusAllowedStatuses(check) {
+function httpStatusRequestUrl(check, baseUrl) {
+  const rawUrl = check.url || "";
+  if (!rawUrl) return "";
+  try {
+    return baseUrl ? new URL(rawUrl, baseUrl).href : new URL(rawUrl).href;
+  } catch {
+    return rawUrl;
+  }
+}
+function httpStatusMethod(check) {
+  return String(check.method || "GET").toUpperCase();
+}
+function httpStatusKey(check, baseUrl) {
+  return httpStatusMethod(check) + " " + httpStatusRequestUrl(check, baseUrl);
+}
+function httpStatusAllowedStatuses(check) {
   if (Array.isArray(check.allowed_statuses) && check.allowed_statuses.length) return check.allowed_statuses;
   if (typeof check.expected_status === "number" && Number.isFinite(check.expected_status)) return [check.expected_status];
   return undefined;
 }
-function linkStatusIsAllowed(status, check) {
+function linkStatusAllowedStatuses(check) {
+  return httpStatusAllowedStatuses(check);
+}
+function httpStatusIsAllowed(status, check) {
   if (typeof status !== "number" || !Number.isFinite(status)) return false;
-  const allowed = linkStatusAllowedStatuses(check);
+  const allowed = httpStatusAllowedStatuses(check);
   return Array.isArray(allowed) && allowed.length ? allowed.includes(status) : status >= 200 && status < 400;
 }
+function linkStatusIsAllowed(status, check) {
+  return httpStatusIsAllowed(status, check);
+}
 function linkStatusObservedBytes(result) {
   const bytes = typeof result.bytes === "number" && Number.isFinite(result.bytes) ? result.bytes : undefined;
   const contentLength = typeof result.content_length === "number" && Number.isFinite(result.content_length) ? result.content_length : undefined;
@@ -10939,7 +11065,7 @@ function linkStatusContentTypeOk(result, check) {
 }
 function linkStatusResultOk(result, check) {
   if (!result || typeof result !== "object" || Array.isArray(result)) return false;
-  if (!linkStatusIsAllowed(result.status, check)) return false;
+  if (!httpStatusIsAllowed(result.status, check)) return false;
   if (typeof result.error === "string" && result.error.trim()) return false;
   if (result.ok === false) return false;
   if (!linkStatusContentTypeOk(result, check)) return false;
@@ -10953,6 +11079,50 @@ function linkStatusResultOk(result, check) {
   }
   return true;
 }
+function summarizeHttpStatusEvidence(viewport, check) {
+  const key = httpStatusKey(check, viewport && viewport.url);
+  const statusEvidence = viewport && viewport.http_statuses && viewport.http_statuses[key];
+  if (!statusEvidence || typeof statusEvidence !== "object" || Array.isArray(statusEvidence)) {
+    return {
+      viewport: viewport && viewport.name,
+      key,
+      url: httpStatusRequestUrl(check, viewport && viewport.url),
+      method: httpStatusMethod(check),
+      ok: false,
+      status: null,
+      failures: [{ code: "http_status_evidence_missing" }],
+    };
+  }
+  const failures = [];
+  if (!linkStatusResultOk(statusEvidence, check)) {
+    failures.push({
+      code: "http_status_failed",
+      url: typeof statusEvidence.url === "string" ? statusEvidence.url : httpStatusRequestUrl(check, viewport && viewport.url),
+      status: typeof statusEvidence.status === "number" && Number.isFinite(statusEvidence.status) ? statusEvidence.status : null,
+      method: typeof statusEvidence.method === "string" ? statusEvidence.method : httpStatusMethod(check),
+      error: typeof statusEvidence.error === "string" ? statusEvidence.error : null,
+      content_type: typeof statusEvidence.content_type === "string" ? statusEvidence.content_type : null,
+      bytes: linkStatusObservedBytes(statusEvidence) ?? null,
+      allowed_statuses: httpStatusAllowedStatuses(check) || ["2xx", "3xx"],
+      min_bytes: typeof check.min_bytes === "number" && Number.isFinite(check.min_bytes) ? check.min_bytes : null,
+      allowed_content_types: Array.isArray(check.allowed_content_types) ? check.allowed_content_types : null,
+    });
+  }
+  return {
+    viewport: viewport && viewport.name,
+    key,
+    url: typeof statusEvidence.url === "string" ? statusEvidence.url : httpStatusRequestUrl(check, viewport && viewport.url),
+    method: typeof statusEvidence.method === "string" ? statusEvidence.method : httpStatusMethod(check),
+    status: typeof statusEvidence.status === "number" && Number.isFinite(statusEvidence.status) ? statusEvidence.status : null,
+    status_text: typeof statusEvidence.status_text === "string" ? statusEvidence.status_text : null,
+    ok: failures.length === 0,
+    error: typeof statusEvidence.error === "string" ? statusEvidence.error : null,
+    content_type: typeof statusEvidence.content_type === "string" ? statusEvidence.content_type : null,
+    content_length: typeof statusEvidence.content_length === "number" && Number.isFinite(statusEvidence.content_length) ? statusEvidence.content_length : null,
+    bytes: linkStatusObservedBytes(statusEvidence) ?? null,
+    failures,
+  };
+}
 function summarizeLinkStatusEvidence(viewport, check) {
   const selector = linkStatusSelector(check);
   const linkEvidence = viewport && viewport.link_statuses && viewport.link_statuses[selector];
@@ -11708,6 +11878,31 @@ function assessProfile(profile, evidence) {
       });
       continue;
     }
+    if (check.type === "http_status") {
+      const url = httpStatusRequestUrl(check, evidence.target_url);
+      const method = httpStatusMethod(check);
+      const summaries = checkViewports.map((viewport) => summarizeHttpStatusEvidence(viewport, check));
+      const failed = summaries.filter((summary) => Array.isArray(summary.failures) && summary.failures.length > 0);
+      checks.push({
+        type: check.type,
+        label: check.label || check.type,
+        status: failed.length ? "failed" : "passed",
+        evidence: {
+          url,
+          method,
+          allowed_statuses: httpStatusAllowedStatuses(check) || ["2xx", "3xx"],
+          require_nonzero_bytes: check.require_nonzero_bytes === true,
+          min_bytes: check.min_bytes ?? null,
+          allowed_content_types: check.allowed_content_types ?? null,
+          viewports: summaries,
+          failures: failed.flatMap((summary) => Array.isArray(summary.failures)
+            ? summary.failures.map((failure) => ({ viewport: summary.viewport || null, failure }))
+            : []),
+        },
+        message: failed.length ? "HTTP status failed in " + failed.length + " viewport(s)." : undefined,
+      });
+      continue;
+    }
     if (check.type === "link_status" || check.type === "artifact_link_status") {
       const selector = linkStatusSelector(check);
       const summaries = checkViewports.map((viewport) => summarizeLinkStatusEvidence(viewport, check));
@@ -12905,6 +13100,65 @@ function linkProbeResponseFields(response, method) {
     content_length: contentLength,
   };
 }
+async function collectHttpStatus(check) {
+  const url = httpStatusRequestUrl(check, page.url() || targetUrl);
+  const method = httpStatusMethod(check);
+  const headers = check.headers && typeof check.headers === "object" && !Array.isArray(check.headers)
+    ? Object.fromEntries(Object.entries(check.headers).map(([key, value]) => [key, String(value)]).filter(([key]) => key.trim()))
+    : {};
+  let body;
+  if (check.body_json !== undefined) {
+    body = JSON.stringify(check.body_json);
+    if (!Object.keys(headers).some((key) => key.toLowerCase() === "content-type")) headers["content-type"] = "application/json";
+  } else if (typeof check.body === "string") {
+    body = check.body;
+  }
+  const options = {
+    method,
+    redirect: "follow",
+    cache: "no-store",
+    headers,
+  };
+  if (body !== undefined && method !== "GET" && method !== "HEAD") options.body = body;
+  const result = {
+    version: "riddle-proof.http-status.v1",
+    url,
+    method,
+    status: null,
+    ok: false,
+    error: null,
+    request_body_bytes: typeof body === "string" ? body.length : 0,
+    allowed_statuses: httpStatusAllowedStatuses(check) || ["2xx", "3xx"],
+    require_nonzero_bytes: check.require_nonzero_bytes === true,
+    min_bytes: typeof check.min_bytes === "number" && Number.isFinite(check.min_bytes) ? check.min_bytes : null,
+    allowed_content_types: Array.isArray(check.allowed_content_types) ? check.allowed_content_types : null,
+  };
+  try {
+    const response = await fetch(url, options);
+    Object.assign(result, linkProbeResponseFields(response, method));
+    result.url = url;
+    result.status_text = response.statusText || "";
+    const shouldReadBody = check.require_nonzero_bytes === true || (typeof check.min_bytes === "number" && Number.isFinite(check.min_bytes));
+    if (shouldReadBody) {
+      try {
+        const buffer = await response.arrayBuffer();
+        result.bytes = buffer.byteLength;
+      } catch (error) {
+        result.error = String(error && error.message ? error.message : error).slice(0, 500);
+      }
+    }
+    result.ok = linkProbeAllowed(result.status, check)
+      && linkProbeContentTypeAllowed(result, check)
+      && (check.require_nonzero_bytes !== true || ((linkProbeObservedBytes(result) || 0) > 0))
+      && (!(typeof check.min_bytes === "number" && Number.isFinite(check.min_bytes)) || ((linkProbeObservedBytes(result) || 0) >= check.min_bytes))
+      && !result.error;
+    return result;
+  } catch (error) {
+    result.error = String(error && error.message ? error.message : error).slice(0, 500);
+    result.ok = false;
+    return result;
+  }
+}
 async function probeLinkStatus(candidate, check) {
   const requireNonzeroBytes = check.require_nonzero_bytes === true;
   const minBytes = typeof check.min_bytes === "number" && Number.isFinite(check.min_bytes) ? Math.max(1, Math.floor(check.min_bytes)) : null;
@@ -13597,6 +13851,7 @@ async function captureViewport(viewport) {
   const frames = {};
   const text_sequences = {};
   const text_matches = {};
+  const http_statuses = {};
   const link_statuses = {};
   for (const check of profile.checks || []) {
     if (!profileCheckAppliesToViewport(check, viewport)) continue;
@@ -13623,6 +13878,10 @@ async function captureViewport(viewport) {
       selectors[check.selector] = selectors[check.selector] || await selectorStats(check.selector);
       frames[check.selector] = frames[check.selector] || await frameEvidence(check.selector);
     }
+    if (check.type === "http_status") {
+      const key = httpStatusKey(check, page.url() || targetUrl);
+      http_statuses[key] = http_statuses[key] || await collectHttpStatus(check);
+    }
     if (check.type === "link_status" || check.type === "artifact_link_status") {
       const selector = linkStatusSelector(check);
       link_statuses[selector] = link_statuses[selector] || await collectLinkStatus(check);
@@ -13690,6 +13949,7 @@ async function captureViewport(viewport) {
     frames,
     text_sequences,
     text_matches,
+    http_statuses,
     link_statuses,
     route_inventory: routeInventory,
     setup_action_results: setupActionResults,
@@ -13739,6 +13999,19 @@ function buildProfileEvidence(currentViewports) {
             ),
           })),
         })),
+      http_status: currentViewports
+        .filter((viewport) => viewport.http_statuses && Object.keys(viewport.http_statuses).length)
+        .map((viewport) => ({
+          viewport: viewport.name,
+          requests: Object.entries(viewport.http_statuses || {}).map(([key, statusSet]) => ({
+            key,
+            url: statusSet && statusSet.url,
+            method: statusSet && statusSet.method,
+            status: statusSet && statusSet.status,
+            ok: statusSet && statusSet.ok === true,
+            error: statusSet && statusSet.error,
+          })),
+        })),
       link_status: currentViewports
         .filter((viewport) => viewport.link_statuses && Object.keys(viewport.link_statuses).length)
         .map((viewport) => ({

package/dist/index.js

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