notion-mcp-server/build/utils/retry-after.js

Notion MCP server with token auth: connect Claude Code, Claude Desktop, Cursor, VS Code, Codex and any MCP client to Notion. Search, create and edit pages, query databases, comment and upload files. Runs headless in CI and agents.

import { APIResponseError, UnknownHTTPResponseError } from "@notionhq/client";
// How long Notion asked us to wait before trying again. It says so in two
// places: the Retry-After header, and (on 429 and 529 since 2026-09-24) the
// error body's `additional_data.retry_after`, a string of whole seconds. The
// header wins when both are present.
const RETRY_AFTER_HEADER = "retry-after";
const RETRY_AFTER_FIELD = "retry_after";
const MS_PER_SECOND = 1_000;
// Non-negative seconds, as Notion sends them ("2", "0.5"). Number() alone
// would also take "", " ", "0x10" and "1e3".
const SECONDS = /^\d+(\.\d+)?$/;
// An HTTP date in the one form RFC 9110 says senders use (IMF-fixdate,
// "Sun, 06 Nov 1994 08:49:37 GMT"). Date.parse alone would also take "5, 5".
const HTTP_DATE = /^[A-Z][a-z]{2}, \d{2} [A-Z][a-z]{2} \d{4} \d{2}:\d{2}:\d{2} GMT$/;
// Seconds, or an HTTP date, as milliseconds from now. Anything else is not a
// wait Notion asked for, so the caller falls back to its own backoff.
export function parseRetryAfter(raw) {
    if (!raw)
        return null;
    const value = raw.trim();
    if (SECONDS.test(value))
        return Number(value) * MS_PER_SECOND;
    if (HTTP_DATE.test(value)) {
        const dateMs = Date.parse(value);
        if (!Number.isNaN(dateMs))
            return Math.max(0, dateMs - Date.now());
    }
    return null;
}
// The SDK types `headers` as `unknown` (see fetch-types.d.ts). At runtime it's
// either a `Headers`-like object with `get` (node-fetch, native fetch) or a
// plain header-name → value record (legacy / test stubs). Handle both without
// assertions by feature-detecting.
function readRetryAfterHeader(headers) {
    if (headers === null || typeof headers !== "object")
        return null;
    if ("get" in headers && typeof headers.get === "function") {
        const value = headers.get(RETRY_AFTER_HEADER);
        return typeof value === "string" ? value : null;
    }
    for (const [key, value] of Object.entries(headers)) {
        if (key.toLowerCase() !== RETRY_AFTER_HEADER)
            continue;
        const first = Array.isArray(value) ? value[0] : value;
        return typeof first === "string" ? first : null;
    }
    return null;
}
function readRetryAfterField(additionalData) {
    const value = additionalData?.[RETRY_AFTER_FIELD];
    const first = Array.isArray(value) ? value[0] : value;
    return typeof first === "string" ? first : null;
}
export function readRetryAfterMs(err) {
    if (!APIResponseError.isAPIResponseError(err) &&
        !UnknownHTTPResponseError.isUnknownHTTPResponseError(err)) {
        return null;
    }
    return (parseRetryAfter(readRetryAfterHeader(err.headers)) ??
        parseRetryAfter(readRetryAfterField(err.additional_data)));
}