@hasna/uptime 0.1.1 → 0.1.3

package/dist/checks.d.ts

@@ -1,10 +1,32 @@
-import type { CheckAttemptResult, Monitor } from "./types.js";
+import type { BrowserFailedRequest, CheckAttemptResult, EvidenceArtifact, Monitor } from "./types.js";
 export type FetchLike = (input: string, init: RequestInit) => Promise<{
     status: number;
 }>;
+export type BrowserPageRunner = (monitor: Monitor) => Promise<BrowserPageRunnerResult>;
+export interface BrowserPageRunnerResult {
+    finalUrl?: string | null;
+    navigationStatus?: number | null;
+    consoleErrors?: string[];
+    pageErrors?: string[];
+    failedRequests?: BrowserFailedRequest[];
+    screenshot?: (Partial<EvidenceArtifact> & {
+        ref: string;
+        path?: string;
+    }) | null;
+    artifacts?: Array<Partial<EvidenceArtifact> & {
+        ref: string;
+        path?: string;
+    }>;
+    latencyMs?: number | null;
+}
 export declare function runMonitorCheck(monitor: Monitor, options?: {
     fetch?: FetchLike;
+    browserPage?: BrowserPageRunner;
 }): Promise<CheckAttemptResult>;
 export declare function runHttpCheck(monitor: Monitor, fetchImpl?: FetchLike): Promise<CheckAttemptResult>;
 export declare function runTcpCheck(monitor: Monitor): Promise<CheckAttemptResult>;
+export declare function runBrowserPageCheck(monitor: Monitor, options?: {
+    fetch?: FetchLike;
+    runner?: BrowserPageRunner;
+}): Promise<CheckAttemptResult>;
 //# sourceMappingURL=checks.d.ts.map

package/dist/checks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"checks.d.ts","sourceRoot":"","sources":["../src/checks.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE9D,MAAM,MAAM,SAAS,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,KAAK,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAE1F,wBAAsB,eAAe,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,SAAS,CAAA;CAAO,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAMxH;AAED,wBAAsB,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,GAAE,SAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CA+B9G;AAED,wBAAsB,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAsB/E"}
+{"version":3,"file":"checks.d.ts","sourceRoot":"","sources":["../src/checks.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAuB,kBAAkB,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE3H,MAAM,MAAM,SAAS,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,KAAK,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAC1F,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,uBAAuB,CAAC,CAAC;AAEvF,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,cAAc,CAAC,EAAE,oBAAoB,EAAE,CAAC;IACxC,UAAU,CAAC,EAAE,CAAC,OAAO,CAAC,gBAAgB,CAAC,GAAG;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,IAAI,CAAC;IACjF,SAAS,CAAC,EAAE,KAAK,CAAC,OAAO,CAAC,gBAAgB,CAAC,GAAG;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC9E,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,wBAAsB,eAAe,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,SAAS,CAAC;IAAC,WAAW,CAAC,EAAE,iBAAiB,CAAA;CAAO,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAQzJ;AAED,wBAAsB,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,GAAE,SAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CA+B9G;AAED,wBAAsB,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAsB/E;AAED,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,OAAO,EAChB,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,SAAS,CAAC;IAAC,MAAM,CAAC,EAAE,iBAAiB,CAAA;CAAO,GAC9D,OAAO,CAAC,kBAAkB,CAAC,CAqD7B"}

package/dist/checks.js

@@ -7,7 +7,11 @@ async function runMonitorCheck(monitor, options = {}) {
   }
   if (monitor.kind === "http")
     return runHttpCheck(monitor, options.fetch ?? fetch);
-  return runTcpCheck(monitor);
+  if (monitor.kind === "browser_page")
+    return runBrowserPageCheck(monitor, { fetch: options.fetch, runner: options.browserPage });
+  if (monitor.kind === "tcp")
+    return runTcpCheck(monitor);
+  return { status: "down", latencyMs: null, error: `unsupported monitor kind: ${monitor.kind ?? "unknown"}` };
 }
 async function runHttpCheck(monitor, fetchImpl = fetch) {
   if (!monitor.url)
@@ -65,8 +69,133 @@ async function runTcpCheck(monitor) {
     });
   });
 }
+async function runBrowserPageCheck(monitor, options = {}) {
+  if (!monitor.url)
+    return { status: "down", latencyMs: null, error: "missing url" };
+  validateBrowserPageUrl(monitor.url);
+  if (!options.runner) {
+    const evidence = normalizeBrowserEvidence(monitor.url, {
+      finalUrl: monitor.url,
+      navigationStatus: null,
+      pageErrors: ["browser_page checks require a configured browser runner"]
+    });
+    return {
+      status: "down",
+      latencyMs: null,
+      statusCode: null,
+      error: "browser_page checks require a configured browser runner",
+      evidence
+    };
+  }
+  const started = performance.now();
+  try {
+    const raw = await options.runner(monitor);
+    const latencyMs = raw.latencyMs ?? Math.round((performance.now() - started) * 100) / 100;
+    const evidence = normalizeBrowserEvidence(monitor.url, raw);
+    const statusCode = raw.navigationStatus ?? evidence.navigationStatus;
+    const statusOk = statusCode == null ? false : monitor.expectedStatus == null ? statusCode >= 200 && statusCode < 400 : statusCode === monitor.expectedStatus;
+    const browserFailures = evidence.consoleErrors.length + evidence.pageErrors.length + evidence.failedRequests.length;
+    return {
+      status: statusOk && browserFailures === 0 ? "up" : "down",
+      latencyMs,
+      statusCode,
+      error: statusOk ? browserFailures === 0 ? null : `browser page captured ${browserFailures} error signal${browserFailures === 1 ? "" : "s"}` : `unexpected navigation status ${statusCode ?? "unknown"}`,
+      evidence
+    };
+  } catch (error) {
+    const safeError = redactText(error instanceof Error ? error.message : String(error));
+    const evidence = normalizeBrowserEvidence(monitor.url, {
+      finalUrl: monitor.url,
+      navigationStatus: null,
+      pageErrors: [safeError]
+    });
+    return {
+      status: "down",
+      latencyMs: Math.round((performance.now() - started) * 100) / 100,
+      statusCode: null,
+      error: safeError,
+      evidence
+    };
+  }
+}
+function normalizeBrowserEvidence(sourceUrl, raw) {
+  return {
+    kind: "browser_page",
+    finalUrl: raw.finalUrl ? redactUrl(raw.finalUrl) : redactUrl(sourceUrl),
+    navigationStatus: raw.navigationStatus ?? null,
+    consoleErrors: sanitizeStrings(raw.consoleErrors ?? []),
+    pageErrors: sanitizeStrings(raw.pageErrors ?? []),
+    failedRequests: (raw.failedRequests ?? []).slice(0, 50).map((request) => ({
+      url: redactUrl(request.url),
+      statusCode: request.statusCode ?? null,
+      error: request.error ? redactText(request.error) : null
+    })),
+    screenshot: raw.screenshot ? sanitizeArtifact(raw.screenshot) : null,
+    artifacts: (raw.artifacts ?? []).slice(0, 20).map(sanitizeArtifact),
+    redacted: true,
+    redactionStatus: "redacted",
+    retentionClass: "short"
+  };
+}
+function validateBrowserPageUrl(value) {
+  const parsed = new URL(value);
+  if (parsed.protocol !== "http:" && parsed.protocol !== "https:") {
+    throw new Error("browser_page monitors require an http or https URL");
+  }
+  if (parsed.username || parsed.password) {
+    throw new Error("browser_page URLs must not contain userinfo");
+  }
+}
+function sanitizeStrings(values) {
+  return values.slice(0, 50).map(redactText).filter(Boolean);
+}
+function sanitizeArtifact(artifact) {
+  const ref = artifact.ref.trim();
+  if (artifact.path || ref.startsWith("/") || ref.toLowerCase().startsWith("file:")) {
+    throw new Error("browser evidence artifacts must use redacted artifact refs, not local paths");
+  }
+  if (!artifact.sha256 || !/^[a-f0-9]{64}$/i.test(artifact.sha256)) {
+    throw new Error("browser evidence artifacts require a sha256 checksum");
+  }
+  const bytes = artifact.bytes;
+  if (!Number.isInteger(bytes) || bytes == null || bytes < 0) {
+    throw new Error("browser evidence artifacts require a byte size");
+  }
+  return {
+    ref: redactText(ref),
+    sha256: artifact.sha256,
+    bytes,
+    contentType: redactText(artifact.contentType ?? "application/octet-stream") || "application/octet-stream",
+    retentionClass: "short"
+  };
+}
+function redactUrl(value) {
+  try {
+    const parsed = new URL(value);
+    if (parsed.protocol !== "http:" && parsed.protocol !== "https:") {
+      return "[blocked-url]";
+    }
+    parsed.username = "";
+    parsed.password = "";
+    parsed.hash = "";
+    for (const key of parsed.searchParams.keys()) {
+      if (isSecretKey(key))
+        parsed.searchParams.set(key, "[redacted]");
+    }
+    return parsed.toString();
+  } catch {
+    return redactText(value);
+  }
+}
+function redactText(value) {
+  return value.replace(/\/(?:home|Users)\/[^\s"'<>]+/g, "[local-path]").replace(/Bearer\s+[A-Za-z0-9._~+/=-]+/gi, "Bearer [redacted]").replace(/((?:token|secret|password|passwd|api[_-]?key|access[_-]?token|auth|credential|session)[=:]\s*)[^\s&]+/gi, "$1[redacted]");
+}
+function isSecretKey(value) {
+  return /(token|secret|password|passwd|api[_-]?key|access[_-]?token|auth|credential|session)/i.test(value);
+}
 export {
   runTcpCheck,
   runMonitorCheck,
-  runHttpCheck
+  runHttpCheck,
+  runBrowserPageCheck
 };