watchfor 0.18.0 → 0.19.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -94,7 +94,7 @@ await wf.statusPages.updateAnnouncement("<page-id>", notice.id!, {
94
94
 
95
95
  ### Live diagnostics
96
96
 
97
- Run any of 24 checks from WatchFor's probe fleet against **any public
97
+ Run any of 26 checks from WatchFor's probe fleet against **any public
98
98
  target**, monitored or not — this measures right now, rather than reading
99
99
  what WatchFor recorded:
100
100
 
@@ -113,7 +113,8 @@ if (!dns.success) console.log("finding:", dns.error);
113
113
  console.log("runs left this hour:", dns.remaining);
114
114
 
115
115
  // Graded checks (tls-grade, http-headers, cwv-check, mcp-check, email-health,
116
- // mail-server-check, cdn-check, smart-audit, dns-health) also return the
116
+ // mail-server-check, cdn-check, smart-audit, dns-health, php-version-checker,
117
+ // software-exposure-checker) also return the
117
118
  // dashboard's WatchFor Grade: letter, rubric id and what holds it down.
118
119
  const headers = await wf.diagnostics.run("http-headers", {
119
120
  target: "https://example.com",
package/dist/schema.d.ts CHANGED
@@ -2119,6 +2119,8 @@ export interface components {
2119
2119
  | "tls-grade"
2120
2120
  | "mcp-check"
2121
2121
  | "http-headers"
2122
+ | "php-version-checker"
2123
+ | "software-exposure-checker"
2122
2124
  | "api-tester"
2123
2125
  | "cdn-check"
2124
2126
  | "sitemap-check"
@@ -2211,6 +2213,8 @@ export interface components {
2211
2213
  | "tls-grade"
2212
2214
  | "mcp-check"
2213
2215
  | "http-headers"
2216
+ | "php-version-checker"
2217
+ | "software-exposure-checker"
2214
2218
  | "api-tester"
2215
2219
  | "cdn-check"
2216
2220
  | "sitemap-check"
@@ -2232,7 +2236,7 @@ export interface components {
2232
2236
  timed_out?: boolean;
2233
2237
  /** @description The probe's raw result — shape depends on the check (response, metrics, error). Composite checks return their aggregate here. */
2234
2238
  result: unknown;
2235
- /** @description Graded checks only (tls-grade, http-headers, cwv-check, mcp-check, email-health with variant all, mail-server-check, cdn-check, smart-audit, dns-health): the dashboard's letter with the findings that set it. Omitted for other checks. */
2239
+ /** @description Graded checks only (smart-audit, cwv-check, tls-grade, mcp-check, http-headers, cdn-check, mail-server-check, email-health with variant all, dns-health, php-version-checker, software-exposure-checker): the dashboard's letter with the findings that set it. Omitted for other checks. */
2236
2240
  grade?: components["schemas"]["WatchForGrade"];
2237
2241
  /** @description Runs left for this check in the current window; null = unlimited. Pace long investigations by this. */
2238
2242
  remaining: number | null;
@@ -2260,6 +2264,8 @@ export interface components {
2260
2264
  | "tls-grade"
2261
2265
  | "mcp-check"
2262
2266
  | "http-headers"
2267
+ | "php-version-checker"
2268
+ | "software-exposure-checker"
2263
2269
  | "api-tester"
2264
2270
  | "cdn-check"
2265
2271
  | "sitemap-check"
@@ -4354,6 +4360,10 @@ export interface components {
4354
4360
  /** @default true */
4355
4361
  followRedirects: boolean;
4356
4362
  };
4363
+ /** @description Options for the `php-version-checker` diagnostic. Which PHP version does this site announce (X-Powered-By, Server), is it vulnerable to php2shell (CVE-2026-109618/109619) or other known CVEs, and is its branch past end of life — graded A+…F? */
4364
+ DiagnosticOptionsPhpVersionChecker: Record<string, never>;
4365
+ /** @description Options for the `software-exposure-checker` diagnostic. Which software versions does this page reveal in its headers and HTML — web server, PHP, CMS, JavaScript libraries — and which are outdated, past end of life or have known CVEs, graded A+…F? */
4366
+ DiagnosticOptionsSoftwareExposureChecker: Record<string, never>;
4357
4367
  /** @description Options for the `api-tester` diagnostic. What does this API endpoint answer to a full request (method, headers, body) — status, headers and the complete response body? */
4358
4368
  DiagnosticOptionsApiTester: {
4359
4369
  /**
@@ -4663,6 +4673,7 @@ export interface operations {
4663
4673
  query?: never;
4664
4674
  header?: never;
4665
4675
  path: {
4676
+ /** @description Shell-style name. Names the browser runtime reserves are refused on PUT with 400 (they can still be deleted): PATH, HOME, TMPDIR, CI, DEBUG, FORCE_COLOR, NO_COLOR, HTTP_PROXY, HTTPS_PROXY, NO_PROXY, ALL_PROXY and anything starting with NODE_, PLAYWRIGHT_, PW_, WF_, LD_, UV_ or SSL_. */
4666
4677
  name: string;
4667
4678
  };
4668
4679
  cookie?: never;
@@ -4707,6 +4718,7 @@ export interface operations {
4707
4718
  query?: never;
4708
4719
  header?: never;
4709
4720
  path: {
4721
+ /** @description Shell-style name. Names the browser runtime reserves are refused on PUT with 400 (they can still be deleted): PATH, HOME, TMPDIR, CI, DEBUG, FORCE_COLOR, NO_COLOR, HTTP_PROXY, HTTPS_PROXY, NO_PROXY, ALL_PROXY and anything starting with NODE_, PLAYWRIGHT_, PW_, WF_, LD_, UV_ or SSL_. */
4710
4722
  name: string;
4711
4723
  };
4712
4724
  cookie?: never;
@@ -4786,6 +4798,8 @@ export interface operations {
4786
4798
  | "tls-grade"
4787
4799
  | "mcp-check"
4788
4800
  | "http-headers"
4801
+ | "php-version-checker"
4802
+ | "software-exposure-checker"
4789
4803
  | "api-tester"
4790
4804
  | "cdn-check"
4791
4805
  | "sitemap-check"
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "watchfor",
3
- "version": "0.18.0",
3
+ "version": "0.19.0",
4
4
  "description": "Official TypeScript SDK + CLI for WatchFor — uptime & infrastructure monitoring (monitors, alert rules, incidents, maintenance windows) over the REST API.",
5
5
  "keywords": [
6
6
  "watchfor",