watchfor 0.17.2 → 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 +9 -3
- package/dist/client.d.ts +28 -0
- package/dist/client.js +24 -0
- package/dist/index.d.ts +1 -1
- package/dist/schema.d.ts +190 -1
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -48,6 +48,11 @@ await wf.monitors.reset(monitor.id!);
|
|
|
48
48
|
// Page integrity: after a deploy, check the pages and accept what that check saw.
|
|
49
49
|
await wf.monitors.acceptBaseline(integrityMonitorId, { fresh: true });
|
|
50
50
|
|
|
51
|
+
// MCP servers: before a release, keep tool drift quiet for 30 minutes (downtime still pages);
|
|
52
|
+
// a drift incident the user confirms was theirs is accepted as an expected change.
|
|
53
|
+
await wf.monitors.setExpectedChangeWindow(mcpMonitorId, { window: 30, note: "v2.4 release" });
|
|
54
|
+
await wf.incidents.acceptExpectedChange(19352, { note: "New search tool shipped in v2.4" });
|
|
55
|
+
|
|
51
56
|
// Browser checks: try a Playwright script once (nothing saved), then read the result.
|
|
52
57
|
const { id } = await wf.playwright.testRun({ script, target: "https://shop.example.com" });
|
|
53
58
|
const run = await wf.playwright.getTestRun(id); // status: queued | running | done | error
|
|
@@ -89,7 +94,7 @@ await wf.statusPages.updateAnnouncement("<page-id>", notice.id!, {
|
|
|
89
94
|
|
|
90
95
|
### Live diagnostics
|
|
91
96
|
|
|
92
|
-
Run any of
|
|
97
|
+
Run any of 26 checks from WatchFor's probe fleet against **any public
|
|
93
98
|
target**, monitored or not — this measures right now, rather than reading
|
|
94
99
|
what WatchFor recorded:
|
|
95
100
|
|
|
@@ -108,7 +113,8 @@ if (!dns.success) console.log("finding:", dns.error);
|
|
|
108
113
|
console.log("runs left this hour:", dns.remaining);
|
|
109
114
|
|
|
110
115
|
// Graded checks (tls-grade, http-headers, cwv-check, mcp-check, email-health,
|
|
111
|
-
// mail-server-check, cdn-check, smart-audit, dns-health
|
|
116
|
+
// mail-server-check, cdn-check, smart-audit, dns-health, php-version-checker,
|
|
117
|
+
// software-exposure-checker) also return the
|
|
112
118
|
// dashboard's WatchFor Grade: letter, rubric id and what holds it down.
|
|
113
119
|
const headers = await wf.diagnostics.run("http-headers", {
|
|
114
120
|
target: "https://example.com",
|
|
@@ -206,5 +212,5 @@ WATCHFOR_ORGANIZATION=<organization-id> npx watchfor summary
|
|
|
206
212
|
## Links
|
|
207
213
|
|
|
208
214
|
- API docs: https://watchfor.io/docs/api
|
|
209
|
-
- MCP server for AI agents (
|
|
215
|
+
- MCP server for AI agents (63 tools): https://watchfor.io/docs/api/mcp
|
|
210
216
|
- Create an API key: dashboard → Settings → API keys (`read` or `read+write` scope)
|
package/dist/client.d.ts
CHANGED
|
@@ -28,6 +28,12 @@ export type IntegrityBaseline = components["schemas"]["IntegrityBaseline"];
|
|
|
28
28
|
export type IntegrityBaselineAccept = components["schemas"]["IntegrityBaselineAccept"];
|
|
29
29
|
/** A fresh accept whose check has not landed yet (HTTP 202). */
|
|
30
30
|
export type IntegrityBaselineAcceptPending = components["schemas"]["IntegrityBaselineAcceptPending"];
|
|
31
|
+
/** `monitors.setExpectedChangeWindow()` — a release marker on an MCP
|
|
32
|
+
* monitor: drift does not page until `ends_at`. */
|
|
33
|
+
export type ExpectedChangeWindow = components["schemas"]["ExpectedChangeWindow"];
|
|
34
|
+
/** `incidents.acceptExpectedChange()` — a drift incident recorded as an
|
|
35
|
+
* intended change. */
|
|
36
|
+
export type ExpectedChangeAccept = components["schemas"]["ExpectedChangeAccept"];
|
|
31
37
|
export type PlaywrightTestRunAccepted = components["schemas"]["PlaywrightTestRunAccepted"];
|
|
32
38
|
export type PlaywrightTestRun = components["schemas"]["PlaywrightTestRun"];
|
|
33
39
|
export type PlaywrightRun = components["schemas"]["PlaywrightRun"];
|
|
@@ -317,6 +323,18 @@ export declare class WatchFor {
|
|
|
317
323
|
pages?: string[];
|
|
318
324
|
fresh?: boolean;
|
|
319
325
|
}, idempotencyKey?: string) => Promise<IntegrityBaselineAccept | IntegrityBaselineAcceptPending>;
|
|
326
|
+
/** MCP monitors: release marker — call it from a deploy pipeline
|
|
327
|
+
* before the rollout. For `window` minutes (1–60, default 15) the
|
|
328
|
+
* monitor's drift rules (Tool Inventory Changed) are silenced — only
|
|
329
|
+
* those, downtime still pages — and drift incidents opened inside
|
|
330
|
+
* the window resolve within a minute. Markers stack; 12 per hour per
|
|
331
|
+
* monitor (429). Page integrity monitors → 400 (use
|
|
332
|
+
* `acceptBaseline(id, { fresh: true })` after the deploy); no enabled
|
|
333
|
+
* drift rule → 409. */
|
|
334
|
+
setExpectedChangeWindow: (id: string, opts?: {
|
|
335
|
+
window?: number;
|
|
336
|
+
note?: string;
|
|
337
|
+
}, idempotencyKey?: string) => Promise<ExpectedChangeWindow>;
|
|
320
338
|
/** Browser checks: runs, newest first (`status` failed | flaky). */
|
|
321
339
|
runs: (id: string, params?: {
|
|
322
340
|
status?: "all" | "failed" | "flaky";
|
|
@@ -417,6 +435,16 @@ export declare class WatchFor {
|
|
|
417
435
|
* it (marking again returns the same one); delete that window to
|
|
418
436
|
* undo. */
|
|
419
437
|
markMaintenance: (id: number, idempotencyKey?: string) => Promise<MaintenanceMarking>;
|
|
438
|
+
/** Drift incidents only (an MCP monitor's Tool Inventory Changed;
|
|
439
|
+
* others → 400): mark the change as intended. An open incident is
|
|
440
|
+
* resolved asynchronously (`resolve_requested`; poll `get()`), and
|
|
441
|
+
* the accept is recorded on the incident and drift timelines and in
|
|
442
|
+
* the Activity log. Accepting again returns the first accept with
|
|
443
|
+
* `already_accepted: true`. `note` (≤ 500 chars) says why. Only call
|
|
444
|
+
* it when the user confirms the change was theirs. */
|
|
445
|
+
acceptExpectedChange: (id: number, body?: {
|
|
446
|
+
note?: string;
|
|
447
|
+
}, idempotencyKey?: string) => Promise<ExpectedChangeAccept>;
|
|
420
448
|
/** The incident's post-mortem. 404 when it has none yet —
|
|
421
449
|
* `updatePostmortem` creates it. */
|
|
422
450
|
getPostmortem: (id: number) => Promise<Postmortem>;
|
package/dist/client.js
CHANGED
|
@@ -268,6 +268,19 @@ export class WatchFor {
|
|
|
268
268
|
body: body ?? {},
|
|
269
269
|
idempotencyKey,
|
|
270
270
|
}),
|
|
271
|
+
/** MCP monitors: release marker — call it from a deploy pipeline
|
|
272
|
+
* before the rollout. For `window` minutes (1–60, default 15) the
|
|
273
|
+
* monitor's drift rules (Tool Inventory Changed) are silenced — only
|
|
274
|
+
* those, downtime still pages — and drift incidents opened inside
|
|
275
|
+
* the window resolve within a minute. Markers stack; 12 per hour per
|
|
276
|
+
* monitor (429). Page integrity monitors → 400 (use
|
|
277
|
+
* `acceptBaseline(id, { fresh: true })` after the deploy); no enabled
|
|
278
|
+
* drift rule → 409. */
|
|
279
|
+
setExpectedChangeWindow: (id, opts = {}, idempotencyKey) => this.request("POST", `/monitors/${id}/expected-change`, {
|
|
280
|
+
query: { window: opts.window },
|
|
281
|
+
body: opts.note === undefined ? {} : { note: opts.note },
|
|
282
|
+
idempotencyKey,
|
|
283
|
+
}),
|
|
271
284
|
/** Browser checks: runs, newest first (`status` failed | flaky). */
|
|
272
285
|
runs: (id, params = {}) => this.request("GET", `/monitors/${id}/runs`, { query: params }),
|
|
273
286
|
/** Browser checks: one run — steps, errors, Web Vitals, screenshot
|
|
@@ -343,6 +356,17 @@ export class WatchFor {
|
|
|
343
356
|
markMaintenance: (id, idempotencyKey) => this.request("POST", `/incidents/${id}/mark-maintenance`, {
|
|
344
357
|
idempotencyKey,
|
|
345
358
|
}),
|
|
359
|
+
/** Drift incidents only (an MCP monitor's Tool Inventory Changed;
|
|
360
|
+
* others → 400): mark the change as intended. An open incident is
|
|
361
|
+
* resolved asynchronously (`resolve_requested`; poll `get()`), and
|
|
362
|
+
* the accept is recorded on the incident and drift timelines and in
|
|
363
|
+
* the Activity log. Accepting again returns the first accept with
|
|
364
|
+
* `already_accepted: true`. `note` (≤ 500 chars) says why. Only call
|
|
365
|
+
* it when the user confirms the change was theirs. */
|
|
366
|
+
acceptExpectedChange: (id, body, idempotencyKey) => this.request("POST", `/incidents/${id}/expected-change`, {
|
|
367
|
+
body: body ?? {},
|
|
368
|
+
idempotencyKey,
|
|
369
|
+
}),
|
|
346
370
|
/** The incident's post-mortem. 404 when it has none yet —
|
|
347
371
|
* `updatePostmortem` creates it. */
|
|
348
372
|
getPostmortem: (id) => this.request("GET", `/incidents/${id}/postmortem`),
|
package/dist/index.d.ts
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
export { type ActivityEvent, type AlertingState, type AlertRule, type Announcement, type AnnouncementCreate, type AnnouncementUpdate, type ApiErrorBody, type BatchOperation, type BatchResult, type BulkResult, type Check, type CheckList, type CheckNowAck, type Contact, type ContactGroup, type Deleted, type DiagnosticCatalog, type DiagnosticCatalogEntry, type DiagnosticReport, type DiagnosticRun, type DiagnosticSlug, type Incident, type IncidentStats, type IntegrityBaseline, type IntegrityBaselineAccept, type IntegrityBaselineAcceptPending, type List, type MaintenanceMarking, type MaintenanceWindow, type Me, type Monitor, type MonitorDetail, type MonitorReset, type Notification, ORGANIZATION_HEADER, type Organization, type Plan, type PlaywrightRun, type PlaywrightRunSummary, type PlaywrightTestRun, type PlaywrightTestRunAccepted, type PlaywrightTestRunRequest, type Postmortem, type PostmortemUpdate, type ReportFilters, type ResponseTimeBucket, type ScriptVersion, type ScriptVersionSummary, type StatusPage, type StatusPageComponentCreate, type StatusPageCreate, type StatusPageUpdate, type Summary, type Uptime, type Variable, type VariableDeleted, WatchFor, WatchForError, type WatchForGrade, type WatchForOptions, } from "./client.js";
|
|
1
|
+
export { type ActivityEvent, type AlertingState, type AlertRule, type Announcement, type AnnouncementCreate, type AnnouncementUpdate, type ApiErrorBody, type BatchOperation, type BatchResult, type BulkResult, type Check, type CheckList, type CheckNowAck, type Contact, type ContactGroup, type Deleted, type DiagnosticCatalog, type DiagnosticCatalogEntry, type DiagnosticReport, type DiagnosticRun, type DiagnosticSlug, type ExpectedChangeAccept, type ExpectedChangeWindow, type Incident, type IncidentStats, type IntegrityBaseline, type IntegrityBaselineAccept, type IntegrityBaselineAcceptPending, type List, type MaintenanceMarking, type MaintenanceWindow, type Me, type Monitor, type MonitorDetail, type MonitorReset, type Notification, ORGANIZATION_HEADER, type Organization, type Plan, type PlaywrightRun, type PlaywrightRunSummary, type PlaywrightTestRun, type PlaywrightTestRunAccepted, type PlaywrightTestRunRequest, type Postmortem, type PostmortemUpdate, type ReportFilters, type ResponseTimeBucket, type ScriptVersion, type ScriptVersionSummary, type StatusPage, type StatusPageComponentCreate, type StatusPageCreate, type StatusPageUpdate, type Summary, type Uptime, type Variable, type VariableDeleted, WatchFor, WatchForError, type WatchForGrade, type WatchForOptions, } from "./client.js";
|
package/dist/schema.d.ts
CHANGED
|
@@ -455,6 +455,26 @@ export interface paths {
|
|
|
455
455
|
patch?: never;
|
|
456
456
|
trace?: never;
|
|
457
457
|
};
|
|
458
|
+
"/monitors/{id}/expected-change": {
|
|
459
|
+
parameters: {
|
|
460
|
+
query?: never;
|
|
461
|
+
header?: never;
|
|
462
|
+
path?: never;
|
|
463
|
+
cookie?: never;
|
|
464
|
+
};
|
|
465
|
+
get?: never;
|
|
466
|
+
put?: never;
|
|
467
|
+
/**
|
|
468
|
+
* Release marker — drift on this monitor doesn't page for the next N minutes (call before a deploy)
|
|
469
|
+
* @description MCP monitors (drift = the Tool Inventory Changed rule). Call it from a deploy pipeline before the rollout starts: for the window, the monitor's drift rules are silenced — only those, so downtime and every other rule still page — the drift incidents opened inside the window are resolved within a minute (timeline: "Resolved — expected change (release marker)"), and the drift timeline marks those changes "Expected — release marker". The dashboard shows "Expected change window until HH:MM" on the monitor. Markers stack (each its own window). Pick a window longer than the rollout plus one check interval: drift first seen after it pages as usual. 12 per hour per monitor (429 + `Retry-After`). Page integrity monitors → 400 (they use `POST /v1/monitors/{id}/baseline?fresh=true` after the deploy); no enabled drift rule → 409. Optional body: `{"note": "v2.4 release"}` (and `window`, when not in the query).
|
|
470
|
+
*/
|
|
471
|
+
post: operations["setMonitorExpectedChange"];
|
|
472
|
+
delete?: never;
|
|
473
|
+
options?: never;
|
|
474
|
+
head?: never;
|
|
475
|
+
patch?: never;
|
|
476
|
+
trace?: never;
|
|
477
|
+
};
|
|
458
478
|
"/monitors/{id}/uptime": {
|
|
459
479
|
parameters: {
|
|
460
480
|
query?: never;
|
|
@@ -634,6 +654,26 @@ export interface paths {
|
|
|
634
654
|
patch?: never;
|
|
635
655
|
trace?: never;
|
|
636
656
|
};
|
|
657
|
+
"/incidents/{id}/expected-change": {
|
|
658
|
+
parameters: {
|
|
659
|
+
query?: never;
|
|
660
|
+
header?: never;
|
|
661
|
+
path?: never;
|
|
662
|
+
cookie?: never;
|
|
663
|
+
};
|
|
664
|
+
get?: never;
|
|
665
|
+
put?: never;
|
|
666
|
+
/**
|
|
667
|
+
* Mark a drift incident as an expected change — resolves it and records it as intended
|
|
668
|
+
* @description Drift incidents only (an MCP monitor's Tool Inventory Changed; others → 400). The change was intended: an open incident is resolved through the manual-resolve path (asynchronous — 202; the channels get "resolved — accepted as an expected change by <key>"), and the accept is recorded on the incident timeline and the monitor's drift timeline ("Accepted as expected by <key>") and in the Activity log. A drift incident that already auto-resolved is only recorded (200). Accepting again returns the first accept with `already_accepted: true`. Optional body: `{"note": "why"}` (up to 500 characters).
|
|
669
|
+
*/
|
|
670
|
+
post: operations["acceptIncidentExpectedChange"];
|
|
671
|
+
delete?: never;
|
|
672
|
+
options?: never;
|
|
673
|
+
head?: never;
|
|
674
|
+
patch?: never;
|
|
675
|
+
trace?: never;
|
|
676
|
+
};
|
|
637
677
|
"/incidents/{id}/exclude": {
|
|
638
678
|
parameters: {
|
|
639
679
|
query?: never;
|
|
@@ -2079,6 +2119,8 @@ export interface components {
|
|
|
2079
2119
|
| "tls-grade"
|
|
2080
2120
|
| "mcp-check"
|
|
2081
2121
|
| "http-headers"
|
|
2122
|
+
| "php-version-checker"
|
|
2123
|
+
| "software-exposure-checker"
|
|
2082
2124
|
| "api-tester"
|
|
2083
2125
|
| "cdn-check"
|
|
2084
2126
|
| "sitemap-check"
|
|
@@ -2171,6 +2213,8 @@ export interface components {
|
|
|
2171
2213
|
| "tls-grade"
|
|
2172
2214
|
| "mcp-check"
|
|
2173
2215
|
| "http-headers"
|
|
2216
|
+
| "php-version-checker"
|
|
2217
|
+
| "software-exposure-checker"
|
|
2174
2218
|
| "api-tester"
|
|
2175
2219
|
| "cdn-check"
|
|
2176
2220
|
| "sitemap-check"
|
|
@@ -2192,7 +2236,7 @@ export interface components {
|
|
|
2192
2236
|
timed_out?: boolean;
|
|
2193
2237
|
/** @description The probe's raw result — shape depends on the check (response, metrics, error). Composite checks return their aggregate here. */
|
|
2194
2238
|
result: unknown;
|
|
2195
|
-
/** @description Graded checks only (tls-grade, http-headers,
|
|
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. */
|
|
2196
2240
|
grade?: components["schemas"]["WatchForGrade"];
|
|
2197
2241
|
/** @description Runs left for this check in the current window; null = unlimited. Pace long investigations by this. */
|
|
2198
2242
|
remaining: number | null;
|
|
@@ -2220,6 +2264,8 @@ export interface components {
|
|
|
2220
2264
|
| "tls-grade"
|
|
2221
2265
|
| "mcp-check"
|
|
2222
2266
|
| "http-headers"
|
|
2267
|
+
| "php-version-checker"
|
|
2268
|
+
| "software-exposure-checker"
|
|
2223
2269
|
| "api-tester"
|
|
2224
2270
|
| "cdn-check"
|
|
2225
2271
|
| "sitemap-check"
|
|
@@ -2982,6 +3028,45 @@ export interface components {
|
|
|
2982
3028
|
expires_at: string;
|
|
2983
3029
|
message?: string;
|
|
2984
3030
|
};
|
|
3031
|
+
/** @description A drift incident accepted as an intended change. `resolve_requested` = this call asked the alert-manager to resolve it (asynchronous — `incident` may still read firing; poll GET /v1/incidents/{id}). */
|
|
3032
|
+
ExpectedChangeAccept: {
|
|
3033
|
+
/** @constant */
|
|
3034
|
+
object: "expected_change";
|
|
3035
|
+
/** @constant */
|
|
3036
|
+
kind: "accepted";
|
|
3037
|
+
incident_id: number;
|
|
3038
|
+
/** Format: uuid */
|
|
3039
|
+
monitor_id: string;
|
|
3040
|
+
/** @description Who accepted it (dashboard user or API key) */
|
|
3041
|
+
accepted_by: string;
|
|
3042
|
+
/** Format: date-time */
|
|
3043
|
+
accepted_at: string;
|
|
3044
|
+
note?: string | null;
|
|
3045
|
+
resolve_requested: boolean;
|
|
3046
|
+
/** @description true = accepted before; nothing changed */
|
|
3047
|
+
already_accepted: boolean;
|
|
3048
|
+
incident: components["schemas"]["Incident"];
|
|
3049
|
+
};
|
|
3050
|
+
/** @description A release marker: until `ends_at`, drift on the monitor (the listed rules only) does not page, and drift incidents opened in the window are resolved within a minute. */
|
|
3051
|
+
ExpectedChangeWindow: {
|
|
3052
|
+
/** @constant */
|
|
3053
|
+
object: "expected_change_window";
|
|
3054
|
+
/** Format: uuid */
|
|
3055
|
+
monitor_id: string;
|
|
3056
|
+
window_minutes: number;
|
|
3057
|
+
/** Format: date-time */
|
|
3058
|
+
starts_at: string;
|
|
3059
|
+
/** Format: date-time */
|
|
3060
|
+
ends_at: string;
|
|
3061
|
+
/** @description The drift alert rules the window covers */
|
|
3062
|
+
rules: {
|
|
3063
|
+
/** Format: uuid */
|
|
3064
|
+
id: string;
|
|
3065
|
+
name: string;
|
|
3066
|
+
}[];
|
|
3067
|
+
note?: string | null;
|
|
3068
|
+
created_by: string;
|
|
3069
|
+
};
|
|
2985
3070
|
MonitorReset: {
|
|
2986
3071
|
/** @constant */
|
|
2987
3072
|
object?: "monitor_reset";
|
|
@@ -4275,6 +4360,10 @@ export interface components {
|
|
|
4275
4360
|
/** @default true */
|
|
4276
4361
|
followRedirects: boolean;
|
|
4277
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>;
|
|
4278
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? */
|
|
4279
4368
|
DiagnosticOptionsApiTester: {
|
|
4280
4369
|
/**
|
|
@@ -4584,6 +4673,7 @@ export interface operations {
|
|
|
4584
4673
|
query?: never;
|
|
4585
4674
|
header?: never;
|
|
4586
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_. */
|
|
4587
4677
|
name: string;
|
|
4588
4678
|
};
|
|
4589
4679
|
cookie?: never;
|
|
@@ -4628,6 +4718,7 @@ export interface operations {
|
|
|
4628
4718
|
query?: never;
|
|
4629
4719
|
header?: never;
|
|
4630
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_. */
|
|
4631
4722
|
name: string;
|
|
4632
4723
|
};
|
|
4633
4724
|
cookie?: never;
|
|
@@ -4707,6 +4798,8 @@ export interface operations {
|
|
|
4707
4798
|
| "tls-grade"
|
|
4708
4799
|
| "mcp-check"
|
|
4709
4800
|
| "http-headers"
|
|
4801
|
+
| "php-version-checker"
|
|
4802
|
+
| "software-exposure-checker"
|
|
4710
4803
|
| "api-tester"
|
|
4711
4804
|
| "cdn-check"
|
|
4712
4805
|
| "sitemap-check"
|
|
@@ -5351,6 +5444,51 @@ export interface operations {
|
|
|
5351
5444
|
};
|
|
5352
5445
|
};
|
|
5353
5446
|
};
|
|
5447
|
+
setMonitorExpectedChange: {
|
|
5448
|
+
parameters: {
|
|
5449
|
+
query?: {
|
|
5450
|
+
/** @description Minutes the window stays open (1–60, default 15). Out of range → 400, never clamped. */
|
|
5451
|
+
window?: number;
|
|
5452
|
+
};
|
|
5453
|
+
header?: {
|
|
5454
|
+
/** @description Unique key for safe retries (Stripe semantics, 24h window): the same key + body replays the original response instead of re-creating. */
|
|
5455
|
+
"Idempotency-Key"?: string;
|
|
5456
|
+
};
|
|
5457
|
+
path: {
|
|
5458
|
+
/** @description Resource id (UUID) */
|
|
5459
|
+
id: string;
|
|
5460
|
+
};
|
|
5461
|
+
cookie?: never;
|
|
5462
|
+
};
|
|
5463
|
+
requestBody?: {
|
|
5464
|
+
content: {
|
|
5465
|
+
"application/json": {
|
|
5466
|
+
window?: number;
|
|
5467
|
+
note?: string;
|
|
5468
|
+
};
|
|
5469
|
+
};
|
|
5470
|
+
};
|
|
5471
|
+
responses: {
|
|
5472
|
+
/** @description Window opened */
|
|
5473
|
+
201: {
|
|
5474
|
+
headers: {
|
|
5475
|
+
[name: string]: unknown;
|
|
5476
|
+
};
|
|
5477
|
+
content: {
|
|
5478
|
+
"application/json": components["schemas"]["ExpectedChangeWindow"];
|
|
5479
|
+
};
|
|
5480
|
+
};
|
|
5481
|
+
/** @description Error */
|
|
5482
|
+
default: {
|
|
5483
|
+
headers: {
|
|
5484
|
+
[name: string]: unknown;
|
|
5485
|
+
};
|
|
5486
|
+
content: {
|
|
5487
|
+
"application/json": components["schemas"]["Error"];
|
|
5488
|
+
};
|
|
5489
|
+
};
|
|
5490
|
+
};
|
|
5491
|
+
};
|
|
5354
5492
|
getMonitorUptime: {
|
|
5355
5493
|
parameters: {
|
|
5356
5494
|
query?: {
|
|
@@ -5821,6 +5959,57 @@ export interface operations {
|
|
|
5821
5959
|
};
|
|
5822
5960
|
};
|
|
5823
5961
|
};
|
|
5962
|
+
acceptIncidentExpectedChange: {
|
|
5963
|
+
parameters: {
|
|
5964
|
+
query?: never;
|
|
5965
|
+
header?: {
|
|
5966
|
+
/** @description Unique key for safe retries (Stripe semantics, 24h window): the same key + body replays the original response instead of re-creating. */
|
|
5967
|
+
"Idempotency-Key"?: string;
|
|
5968
|
+
};
|
|
5969
|
+
path: {
|
|
5970
|
+
/** @description Incident id (integer) */
|
|
5971
|
+
id: string;
|
|
5972
|
+
};
|
|
5973
|
+
cookie?: never;
|
|
5974
|
+
};
|
|
5975
|
+
requestBody?: {
|
|
5976
|
+
content: {
|
|
5977
|
+
"application/json": {
|
|
5978
|
+
/** @description Why the change was expected */
|
|
5979
|
+
note?: string;
|
|
5980
|
+
};
|
|
5981
|
+
};
|
|
5982
|
+
};
|
|
5983
|
+
responses: {
|
|
5984
|
+
/** @description Recorded (the incident was already resolved, or accepted before) */
|
|
5985
|
+
200: {
|
|
5986
|
+
headers: {
|
|
5987
|
+
[name: string]: unknown;
|
|
5988
|
+
};
|
|
5989
|
+
content: {
|
|
5990
|
+
"application/json": components["schemas"]["ExpectedChangeAccept"];
|
|
5991
|
+
};
|
|
5992
|
+
};
|
|
5993
|
+
/** @description Recorded; resolution requested */
|
|
5994
|
+
202: {
|
|
5995
|
+
headers: {
|
|
5996
|
+
[name: string]: unknown;
|
|
5997
|
+
};
|
|
5998
|
+
content: {
|
|
5999
|
+
"application/json": components["schemas"]["ExpectedChangeAccept"];
|
|
6000
|
+
};
|
|
6001
|
+
};
|
|
6002
|
+
/** @description Error */
|
|
6003
|
+
default: {
|
|
6004
|
+
headers: {
|
|
6005
|
+
[name: string]: unknown;
|
|
6006
|
+
};
|
|
6007
|
+
content: {
|
|
6008
|
+
"application/json": components["schemas"]["Error"];
|
|
6009
|
+
};
|
|
6010
|
+
};
|
|
6011
|
+
};
|
|
6012
|
+
};
|
|
5824
6013
|
excludeIncidentFromUptime: {
|
|
5825
6014
|
parameters: {
|
|
5826
6015
|
query?: never;
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "watchfor",
|
|
3
|
-
"version": "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",
|