Open-source status page, incident response and uptime monitoring
TypeScript alertingincident-managementmcpmcp-servermonitoringmonitoring-as-codeobservabilityon-callopen-sourcesrestatus-pagestatuspagesynthetic-monitoringterraformtinybirdtursouptimeuptime-checkeruptime-monitor
import { safeFetch } from "@openstatus/utils";
import { Effect, Schedule } from "effect";
export class WebhookSendError extends Error {
readonly httpStatus?: number;
constructor(
message: string,
opts?: { httpStatus?: number; cause?: unknown },
) {
super(message, { cause: opts?.cause });
this.name = "WebhookSendError";
this.httpStatus = opts?.httpStatus;
}
}
// Network errors and timeouts (no status) are transient; 5xx and 429 may clear.
// Other 4xx are client errors that won't succeed on retry.
const isRetryable = (err: WebhookSendError): boolean =>
err.httpStatus === undefined ||
err.httpStatus >= 500 ||
err.httpStatus === 429;
const describeFailure = (status: number) =>
status >= 300 && status < 400
? `Webhook redirected (${status}); only 307/308 to the same host are followed`
: `Webhook returned ${status}`;
const retryPolicy = {
schedule: Schedule.exponential("200 millis").pipe(Schedule.jittered),
times: 3,
while: isRetryable,
};
/**
* POST to a webhook with exponential-backoff retries on transient failures.
* Rejects with `WebhookSendError` once retries are exhausted.
*/
export function postWebhookWithRetry(opts: {
url: string;
headers: Record<string, string>;
body: string;
timeoutMs: number;
}): Promise<void> {
const send = Effect.tryPromise({
try: (signal) =>
safeFetch(opts.url, {
method: "POST",
headers: opts.headers,
body: opts.body,
signal,
}),
catch: (cause) => new WebhookSendError("Webhook request failed", { cause }),
}).pipe(
Effect.timeoutOrElse({
duration: `${opts.timeoutMs} millis`,
orElse: () =>
Effect.fail(
new WebhookSendError(`Webhook timed out after ${opts.timeoutMs}ms`),
),
}),
Effect.flatMap((response) =>
response.ok
? Effect.void
: Effect.fail(
new WebhookSendError(describeFailure(response.status), {
httpStatus: response.status,
}),
),
),
Effect.retry(retryPolicy),
);
return Effect.runPromise(send);
}