@fedify/vocab-runtime 2.5.0-dev.2339 → 2.5.0-dev.2358

package/dist/tests/request-6JGmUBqf.cjs

@@ -0,0 +1,210 @@
+const require_rolldown_runtime = require("./rolldown-runtime-emK7D4bc.cjs");
+const require_url = require("./url-BNakuZ8k.cjs");
+let node_process = require("node:process");
+node_process = require_rolldown_runtime.__toESM(node_process, 1);
+//#region deno.json
+var name = "@fedify/vocab-runtime";
+var version = "2.5.0-dev.2358+1d1813b7";
+//#endregion
+//#region src/request.ts
+/**
+* Error thrown when fetching a JSON-LD document failed.
+*/
+var FetchError = class extends Error {
+	/**
+	* The URL that failed to fetch.
+	*/
+	url;
+	/**
+	* The HTTP response that failed, if available.
+	*/
+	response;
+	/**
+	* Constructs a new `FetchError`.
+	*
+	* @param url The URL that failed to fetch.
+	* @param message Error message.
+	* @param response The failed HTTP response, if available.
+	*/
+	constructor(url, message, response) {
+		super(message == null ? url.toString() : `${url}: ${message}`);
+		this.name = "FetchError";
+		this.url = typeof url === "string" ? new URL(url) : url;
+		this.response = response;
+	}
+};
+const MAX_CAUSE_DEPTH = 8;
+/**
+* Guesses whether an error thrown by a document loader is transient,
+* i.e., whether fetching the same document again later could succeed.
+*
+* This is a heuristic classification, not a guarantee.  Callers that retry
+* on transient errors should still bound the number of retries.  The rules
+* are:
+*
+*  -  A {@link UrlError} is transient only if its
+*     {@link UrlError.reason | reason} is `"dns"`; URLs disallowed by SSRF
+*     protection are permanent.
+*  -  A {@link FetchError} with a {@link FetchError.response | response} is
+*     transient if the status is 5xx, 408 (Request Timeout), or 429 (Too Many
+*     Requests); other statuses such as 404 are permanent.
+*  -  A {@link FetchError} without a response is classified by its `cause`,
+*     which is how timeouts are reported.  Without a cause, it is permanent
+*     (e.g., redirect loops, too many redirections, or bodies that exceed the
+*     size limit).
+*  -  A `TimeoutError` or `AbortError` is transient.
+*  -  A `TypeError` from parsing an invalid URL is permanent; any other
+*     `TypeError` is transient, since `fetch()` reports network failures
+*     that way.
+*  -  A `SyntaxError` (a malformed JSON body) is permanent.
+*  -  An `AggregateError`, e.g., from trying several gateways, is transient
+*     if any of its errors is.
+*  -  Any other error is treated as transient.
+*
+* @param error The error thrown by a document loader.
+* @returns `true` if the error is likely transient, `false` if retrying is
+*          unlikely to help.
+* @since 2.5.0
+*/
+function isTransientFetchError(error) {
+	return classifyFetchError(error, /* @__PURE__ */ new Set(), 0);
+}
+function classifyFetchError(error, path, depth) {
+	if (depth > MAX_CAUSE_DEPTH || path.has(error)) return true;
+	path.add(error);
+	try {
+		return classifyErrorShape(error, path, depth);
+	} finally {
+		path.delete(error);
+	}
+}
+function classifyErrorShape(error, path, depth) {
+	if (!(error instanceof Error) && !isNamedError(error)) return true;
+	const name = error.name;
+	if (error instanceof require_url.UrlError || name === "UrlError") return error.reason === "dns";
+	if (name === "BodyTooLargeError") return false;
+	if (error instanceof FetchError || name === "FetchError") {
+		const response = error.response;
+		if (isResponseLike(response)) {
+			const status = response.status;
+			return status >= 500 || status === 408 || status === 429;
+		}
+		const cause = error.cause;
+		if (cause == null) return false;
+		return classifyFetchError(cause, path, depth + 1);
+	}
+	if (error instanceof AggregateError || name === "AggregateError") {
+		const errors = error.errors;
+		if (!Array.isArray(errors) || errors.length < 1) return true;
+		return errors.some((e) => classifyFetchError(e, path, depth + 1));
+	}
+	if (name === "TimeoutError" || name === "AbortError") return true;
+	if (error instanceof TypeError || name === "TypeError") {
+		const cause = error.cause;
+		return !isInvalidUrlError(error) && !isInvalidUrlError(cause);
+	}
+	if (error instanceof SyntaxError || name === "SyntaxError") return false;
+	return true;
+}
+function isNamedError(error) {
+	return typeof error === "object" && error != null && typeof error.name === "string";
+}
+function isResponseLike(value) {
+	return typeof value === "object" && value != null && typeof value.status === "number";
+}
+function isInvalidUrlError(error) {
+	if (typeof error !== "object" || error == null) return false;
+	const { code, message } = error;
+	return code === "ERR_INVALID_URL" || typeof message === "string" && message.startsWith("Invalid URL");
+}
+/**
+* The `Accept` header value for fetching ActivityPub objects.  ActivityPub
+* and FEP-ef61 gateways require the ActivityStreams profile on the JSON-LD
+* media type.
+*/
+const ACTIVITYPUB_ACCEPT = "application/activity+json, application/ld+json; profile=\"https://www.w3.org/ns/activitystreams\"";
+/**
+* Creates a request for the given URL.
+* @param url The URL to create the request for.
+* @param options The options for the request.
+* @returns The created request.
+* @internal
+*/
+function createActivityPubRequest(url, options = {}) {
+	return new Request(url, {
+		headers: {
+			Accept: ACTIVITYPUB_ACCEPT,
+			"User-Agent": typeof options.userAgent === "string" ? options.userAgent : getUserAgent(options.userAgent)
+		},
+		redirect: "manual"
+	});
+}
+/**
+* Gets the user agent string for the given application and URL.
+* @param options The options for making the user agent string.
+* @returns The user agent string.
+* @since 1.3.0
+*/
+function getUserAgent({ software, url } = {}) {
+	const fedify = `Fedify/${version}`;
+	const runtime = globalThis.Deno?.version?.deno != null ? `Deno/${Deno.version.deno}` : globalThis.process?.versions?.bun != null ? `Bun/${node_process.default.versions.bun}` : "navigator" in globalThis && navigator.userAgent === "Cloudflare-Workers" ? navigator.userAgent : globalThis.process?.versions?.node != null ? `Node.js/${node_process.default.versions.node}` : null;
+	const userAgent = software == null ? [fedify] : [software, fedify];
+	if (runtime != null) userAgent.push(runtime);
+	if (url != null) userAgent.push(`+${url.toString()}`);
+	return `${userAgent.shift()} (${userAgent.join("; ")})`;
+}
+/**
+* Logs the request.
+* @param request The request to log.
+* @internal
+*/
+function logRequest(logger, request) {
+	logger.debug("Fetching document: {method} {url} {headers}", {
+		method: request.method,
+		url: request.url,
+		headers: Object.fromEntries(request.headers.entries())
+	});
+}
+//#endregion
+Object.defineProperty(exports, "FetchError", {
+	enumerable: true,
+	get: function() {
+		return FetchError;
+	}
+});
+Object.defineProperty(exports, "createActivityPubRequest", {
+	enumerable: true,
+	get: function() {
+		return createActivityPubRequest;
+	}
+});
+Object.defineProperty(exports, "getUserAgent", {
+	enumerable: true,
+	get: function() {
+		return getUserAgent;
+	}
+});
+Object.defineProperty(exports, "isTransientFetchError", {
+	enumerable: true,
+	get: function() {
+		return isTransientFetchError;
+	}
+});
+Object.defineProperty(exports, "logRequest", {
+	enumerable: true,
+	get: function() {
+		return logRequest;
+	}
+});
+Object.defineProperty(exports, "name", {
+	enumerable: true,
+	get: function() {
+		return name;
+	}
+});
+Object.defineProperty(exports, "version", {
+	enumerable: true,
+	get: function() {
+		return version;
+	}
+});

package/dist/tests/request-D7wirQVZ.mjs

@@ -0,0 +1,167 @@
+import { n as UrlError } from "./url-DMxmp7ZG.mjs";
+import process from "node:process";
+//#region deno.json
+var name = "@fedify/vocab-runtime";
+var version = "2.5.0-dev.2358+1d1813b7";
+//#endregion
+//#region src/request.ts
+/**
+* Error thrown when fetching a JSON-LD document failed.
+*/
+var FetchError = class extends Error {
+	/**
+	* The URL that failed to fetch.
+	*/
+	url;
+	/**
+	* The HTTP response that failed, if available.
+	*/
+	response;
+	/**
+	* Constructs a new `FetchError`.
+	*
+	* @param url The URL that failed to fetch.
+	* @param message Error message.
+	* @param response The failed HTTP response, if available.
+	*/
+	constructor(url, message, response) {
+		super(message == null ? url.toString() : `${url}: ${message}`);
+		this.name = "FetchError";
+		this.url = typeof url === "string" ? new URL(url) : url;
+		this.response = response;
+	}
+};
+const MAX_CAUSE_DEPTH = 8;
+/**
+* Guesses whether an error thrown by a document loader is transient,
+* i.e., whether fetching the same document again later could succeed.
+*
+* This is a heuristic classification, not a guarantee.  Callers that retry
+* on transient errors should still bound the number of retries.  The rules
+* are:
+*
+*  -  A {@link UrlError} is transient only if its
+*     {@link UrlError.reason | reason} is `"dns"`; URLs disallowed by SSRF
+*     protection are permanent.
+*  -  A {@link FetchError} with a {@link FetchError.response | response} is
+*     transient if the status is 5xx, 408 (Request Timeout), or 429 (Too Many
+*     Requests); other statuses such as 404 are permanent.
+*  -  A {@link FetchError} without a response is classified by its `cause`,
+*     which is how timeouts are reported.  Without a cause, it is permanent
+*     (e.g., redirect loops, too many redirections, or bodies that exceed the
+*     size limit).
+*  -  A `TimeoutError` or `AbortError` is transient.
+*  -  A `TypeError` from parsing an invalid URL is permanent; any other
+*     `TypeError` is transient, since `fetch()` reports network failures
+*     that way.
+*  -  A `SyntaxError` (a malformed JSON body) is permanent.
+*  -  An `AggregateError`, e.g., from trying several gateways, is transient
+*     if any of its errors is.
+*  -  Any other error is treated as transient.
+*
+* @param error The error thrown by a document loader.
+* @returns `true` if the error is likely transient, `false` if retrying is
+*          unlikely to help.
+* @since 2.5.0
+*/
+function isTransientFetchError(error) {
+	return classifyFetchError(error, /* @__PURE__ */ new Set(), 0);
+}
+function classifyFetchError(error, path, depth) {
+	if (depth > MAX_CAUSE_DEPTH || path.has(error)) return true;
+	path.add(error);
+	try {
+		return classifyErrorShape(error, path, depth);
+	} finally {
+		path.delete(error);
+	}
+}
+function classifyErrorShape(error, path, depth) {
+	if (!(error instanceof Error) && !isNamedError(error)) return true;
+	const name = error.name;
+	if (error instanceof UrlError || name === "UrlError") return error.reason === "dns";
+	if (name === "BodyTooLargeError") return false;
+	if (error instanceof FetchError || name === "FetchError") {
+		const response = error.response;
+		if (isResponseLike(response)) {
+			const status = response.status;
+			return status >= 500 || status === 408 || status === 429;
+		}
+		const cause = error.cause;
+		if (cause == null) return false;
+		return classifyFetchError(cause, path, depth + 1);
+	}
+	if (error instanceof AggregateError || name === "AggregateError") {
+		const errors = error.errors;
+		if (!Array.isArray(errors) || errors.length < 1) return true;
+		return errors.some((e) => classifyFetchError(e, path, depth + 1));
+	}
+	if (name === "TimeoutError" || name === "AbortError") return true;
+	if (error instanceof TypeError || name === "TypeError") {
+		const cause = error.cause;
+		return !isInvalidUrlError(error) && !isInvalidUrlError(cause);
+	}
+	if (error instanceof SyntaxError || name === "SyntaxError") return false;
+	return true;
+}
+function isNamedError(error) {
+	return typeof error === "object" && error != null && typeof error.name === "string";
+}
+function isResponseLike(value) {
+	return typeof value === "object" && value != null && typeof value.status === "number";
+}
+function isInvalidUrlError(error) {
+	if (typeof error !== "object" || error == null) return false;
+	const { code, message } = error;
+	return code === "ERR_INVALID_URL" || typeof message === "string" && message.startsWith("Invalid URL");
+}
+/**
+* The `Accept` header value for fetching ActivityPub objects.  ActivityPub
+* and FEP-ef61 gateways require the ActivityStreams profile on the JSON-LD
+* media type.
+*/
+const ACTIVITYPUB_ACCEPT = "application/activity+json, application/ld+json; profile=\"https://www.w3.org/ns/activitystreams\"";
+/**
+* Creates a request for the given URL.
+* @param url The URL to create the request for.
+* @param options The options for the request.
+* @returns The created request.
+* @internal
+*/
+function createActivityPubRequest(url, options = {}) {
+	return new Request(url, {
+		headers: {
+			Accept: ACTIVITYPUB_ACCEPT,
+			"User-Agent": typeof options.userAgent === "string" ? options.userAgent : getUserAgent(options.userAgent)
+		},
+		redirect: "manual"
+	});
+}
+/**
+* Gets the user agent string for the given application and URL.
+* @param options The options for making the user agent string.
+* @returns The user agent string.
+* @since 1.3.0
+*/
+function getUserAgent({ software, url } = {}) {
+	const fedify = `Fedify/${version}`;
+	const runtime = globalThis.Deno?.version?.deno != null ? `Deno/${Deno.version.deno}` : globalThis.process?.versions?.bun != null ? `Bun/${process.versions.bun}` : "navigator" in globalThis && navigator.userAgent === "Cloudflare-Workers" ? navigator.userAgent : globalThis.process?.versions?.node != null ? `Node.js/${process.versions.node}` : null;
+	const userAgent = software == null ? [fedify] : [software, fedify];
+	if (runtime != null) userAgent.push(runtime);
+	if (url != null) userAgent.push(`+${url.toString()}`);
+	return `${userAgent.shift()} (${userAgent.join("; ")})`;
+}
+/**
+* Logs the request.
+* @param request The request to log.
+* @internal
+*/
+function logRequest(logger, request) {
+	logger.debug("Fetching document: {method} {url} {headers}", {
+		method: request.method,
+		url: request.url,
+		headers: Object.fromEntries(request.headers.entries())
+	});
+}
+//#endregion
+export { logRequest as a, isTransientFetchError as i, createActivityPubRequest as n, name as o, getUserAgent as r, version as s, FetchError as t };

package/dist/tests/request.test.cjs

@@ -1,5 +1,6 @@
 const require_rolldown_runtime = require("./rolldown-runtime-emK7D4bc.cjs");
-const require_request = require("./request-lSaiCxqI.cjs");
+const require_request = require("./request-6JGmUBqf.cjs");
+const require_url = require("./url-BNakuZ8k.cjs");
 let node_test = require("node:test");
 let node_process = require("node:process");
 node_process = require_rolldown_runtime.__toESM(node_process, 1);
@@ -43,4 +44,60 @@ let node_assert = require("node:assert");
 (0, node_test.test)("createActivityPubRequest() asks for the ActivityStreams profile", () => {
 	(0, node_assert.deepStrictEqual)(require_request.createActivityPubRequest("https://example.com/object").headers.get("Accept"), "application/activity+json, application/ld+json; profile=\"https://www.w3.org/ns/activitystreams\"");
 });
+(0, node_test.test)("isTransientFetchError() classifies document loader errors", () => {
+	const url = "https://example.com/object";
+	const response = (status) => new Response(null, { status });
+	(0, node_assert.deepStrictEqual)(require_request.isTransientFetchError(new require_request.FetchError(url, "HTTP 503", response(503))), true);
+	(0, node_assert.deepStrictEqual)(require_request.isTransientFetchError(new require_request.FetchError(url, "HTTP 408", response(408))), true);
+	(0, node_assert.deepStrictEqual)(require_request.isTransientFetchError(new require_request.FetchError(url, "HTTP 429", response(429))), true);
+	(0, node_assert.deepStrictEqual)(require_request.isTransientFetchError(new require_request.FetchError(url, "HTTP 404", response(404))), false);
+	(0, node_assert.deepStrictEqual)(require_request.isTransientFetchError(new require_request.FetchError(url, "HTTP 410", response(410))), false);
+	(0, node_assert.deepStrictEqual)(require_request.isTransientFetchError(new require_request.FetchError(url, "Redirect loop detected")), false);
+	const timeout = new require_request.FetchError(url, "Timed out after 1000 ms");
+	timeout.cause = new DOMException("Timed out", "TimeoutError");
+	(0, node_assert.deepStrictEqual)(require_request.isTransientFetchError(timeout), true);
+	const tooLarge = new require_request.FetchError(url, "Body exceeds the limit");
+	tooLarge.name = "BodyTooLargeError";
+	(0, node_assert.deepStrictEqual)(require_request.isTransientFetchError(tooLarge), false);
+	(0, node_assert.deepStrictEqual)(require_request.isTransientFetchError(new require_url.UrlError("DNS lookup failed", { reason: "dns" })), true);
+	(0, node_assert.deepStrictEqual)(require_request.isTransientFetchError(new require_url.UrlError("Disallowed private URL")), false);
+	(0, node_assert.deepStrictEqual)(require_request.isTransientFetchError(new TypeError("fetch failed", { cause: /* @__PURE__ */ new Error("ECONNRESET") })), true);
+	let invalidUrl;
+	try {
+		new URL("::");
+	} catch (error) {
+		invalidUrl = error;
+	}
+	(0, node_assert.deepStrictEqual)(require_request.isTransientFetchError(invalidUrl), false);
+	(0, node_assert.deepStrictEqual)(require_request.isTransientFetchError(new TypeError("Failed to parse URL from ::", { cause: Object.assign(/* @__PURE__ */ new TypeError("Invalid URL"), { code: "ERR_INVALID_URL" }) })), false);
+	(0, node_assert.deepStrictEqual)(require_request.isTransientFetchError(/* @__PURE__ */ new SyntaxError("Bad JSON")), false);
+	(0, node_assert.deepStrictEqual)(require_request.isTransientFetchError(new DOMException("Aborted", "AbortError")), true);
+	(0, node_assert.deepStrictEqual)(require_request.isTransientFetchError(/* @__PURE__ */ new Error("unknown")), true);
+});
+(0, node_test.test)("isTransientFetchError() recognizes errors from other package copies", () => {
+	(0, node_assert.deepStrictEqual)(require_request.isTransientFetchError(Object.assign(/* @__PURE__ */ new Error("DNS lookup failed"), {
+		name: "UrlError",
+		reason: "dns"
+	})), true);
+	(0, node_assert.deepStrictEqual)(require_request.isTransientFetchError(Object.assign(/* @__PURE__ */ new Error("HTTP 404"), {
+		name: "FetchError",
+		url: new URL("https://example.com/"),
+		response: new Response(null, { status: 404 })
+	})), false);
+});
+(0, node_test.test)("isTransientFetchError() classifies aggregate errors by their members", () => {
+	const notFound = (url) => new require_request.FetchError(url, "HTTP 404", new Response(null, { status: 404 }));
+	const unavailable = (url) => new require_request.FetchError(url, "HTTP 503", new Response(null, { status: 503 }));
+	(0, node_assert.deepStrictEqual)(require_request.isTransientFetchError(new AggregateError([notFound("https://a.example/"), notFound("https://b.example/")])), false);
+	(0, node_assert.deepStrictEqual)(require_request.isTransientFetchError(new AggregateError([notFound("https://a.example/"), unavailable("https://b.example/")])), true);
+	(0, node_assert.deepStrictEqual)(require_request.isTransientFetchError(/* @__PURE__ */ new AggregateError([])), true);
+	const gone = new require_request.FetchError("https://a.example/", "HTTP 410", new Response(null, { status: 410 }));
+	(0, node_assert.deepStrictEqual)(require_request.isTransientFetchError(new AggregateError([gone, gone])), false);
+	(0, node_assert.deepStrictEqual)(require_request.isTransientFetchError(new AggregateError([new require_request.FetchError("https://a.example/", "a", void 0), new require_request.FetchError("https://b.example/", "b", void 0)].map((e) => Object.assign(e, { cause: gone })))), false);
+});
+(0, node_test.test)("isTransientFetchError() tolerates cyclic causes", () => {
+	const error = new require_request.FetchError("https://example.com/", "cyclic");
+	error.cause = error;
+	(0, node_assert.deepStrictEqual)(require_request.isTransientFetchError(error), true);
+});
 //#endregion

package/dist/tests/request.test.mjs

@@ -1,4 +1,5 @@
-import { n as createActivityPubRequest, o as version, r as getUserAgent } from "./request-BM1AsOPj.mjs";
+import { i as isTransientFetchError, n as createActivityPubRequest, r as getUserAgent, s as version, t as FetchError } from "./request-D7wirQVZ.mjs";
+import { n as UrlError } from "./url-DMxmp7ZG.mjs";
 import { test } from "node:test";
 import process from "node:process";
 import { deepStrictEqual } from "node:assert";
@@ -41,5 +42,61 @@ test("getUserAgent()", () => {
 test("createActivityPubRequest() asks for the ActivityStreams profile", () => {
 	deepStrictEqual(createActivityPubRequest("https://example.com/object").headers.get("Accept"), "application/activity+json, application/ld+json; profile=\"https://www.w3.org/ns/activitystreams\"");
 });
+test("isTransientFetchError() classifies document loader errors", () => {
+	const url = "https://example.com/object";
+	const response = (status) => new Response(null, { status });
+	deepStrictEqual(isTransientFetchError(new FetchError(url, "HTTP 503", response(503))), true);
+	deepStrictEqual(isTransientFetchError(new FetchError(url, "HTTP 408", response(408))), true);
+	deepStrictEqual(isTransientFetchError(new FetchError(url, "HTTP 429", response(429))), true);
+	deepStrictEqual(isTransientFetchError(new FetchError(url, "HTTP 404", response(404))), false);
+	deepStrictEqual(isTransientFetchError(new FetchError(url, "HTTP 410", response(410))), false);
+	deepStrictEqual(isTransientFetchError(new FetchError(url, "Redirect loop detected")), false);
+	const timeout = new FetchError(url, "Timed out after 1000 ms");
+	timeout.cause = new DOMException("Timed out", "TimeoutError");
+	deepStrictEqual(isTransientFetchError(timeout), true);
+	const tooLarge = new FetchError(url, "Body exceeds the limit");
+	tooLarge.name = "BodyTooLargeError";
+	deepStrictEqual(isTransientFetchError(tooLarge), false);
+	deepStrictEqual(isTransientFetchError(new UrlError("DNS lookup failed", { reason: "dns" })), true);
+	deepStrictEqual(isTransientFetchError(new UrlError("Disallowed private URL")), false);
+	deepStrictEqual(isTransientFetchError(new TypeError("fetch failed", { cause: /* @__PURE__ */ new Error("ECONNRESET") })), true);
+	let invalidUrl;
+	try {
+		new URL("::");
+	} catch (error) {
+		invalidUrl = error;
+	}
+	deepStrictEqual(isTransientFetchError(invalidUrl), false);
+	deepStrictEqual(isTransientFetchError(new TypeError("Failed to parse URL from ::", { cause: Object.assign(/* @__PURE__ */ new TypeError("Invalid URL"), { code: "ERR_INVALID_URL" }) })), false);
+	deepStrictEqual(isTransientFetchError(/* @__PURE__ */ new SyntaxError("Bad JSON")), false);
+	deepStrictEqual(isTransientFetchError(new DOMException("Aborted", "AbortError")), true);
+	deepStrictEqual(isTransientFetchError(/* @__PURE__ */ new Error("unknown")), true);
+});
+test("isTransientFetchError() recognizes errors from other package copies", () => {
+	deepStrictEqual(isTransientFetchError(Object.assign(/* @__PURE__ */ new Error("DNS lookup failed"), {
+		name: "UrlError",
+		reason: "dns"
+	})), true);
+	deepStrictEqual(isTransientFetchError(Object.assign(/* @__PURE__ */ new Error("HTTP 404"), {
+		name: "FetchError",
+		url: new URL("https://example.com/"),
+		response: new Response(null, { status: 404 })
+	})), false);
+});
+test("isTransientFetchError() classifies aggregate errors by their members", () => {
+	const notFound = (url) => new FetchError(url, "HTTP 404", new Response(null, { status: 404 }));
+	const unavailable = (url) => new FetchError(url, "HTTP 503", new Response(null, { status: 503 }));
+	deepStrictEqual(isTransientFetchError(new AggregateError([notFound("https://a.example/"), notFound("https://b.example/")])), false);
+	deepStrictEqual(isTransientFetchError(new AggregateError([notFound("https://a.example/"), unavailable("https://b.example/")])), true);
+	deepStrictEqual(isTransientFetchError(/* @__PURE__ */ new AggregateError([])), true);
+	const gone = new FetchError("https://a.example/", "HTTP 410", new Response(null, { status: 410 }));
+	deepStrictEqual(isTransientFetchError(new AggregateError([gone, gone])), false);
+	deepStrictEqual(isTransientFetchError(new AggregateError([new FetchError("https://a.example/", "a", void 0), new FetchError("https://b.example/", "b", void 0)].map((e) => Object.assign(e, { cause: gone })))), false);
+});
+test("isTransientFetchError() tolerates cyclic causes", () => {
+	const error = new FetchError("https://example.com/", "cyclic");
+	error.cause = error;
+	deepStrictEqual(isTransientFetchError(error), true);
+});
 //#endregion
 export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fedify/vocab-runtime",
-  "version": "2.5.0-dev.2339+5e786861",
+  "version": "2.5.0-dev.2358+1d1813b7",
   "homepage": "https://fedify.dev/",
   "repository": {
     "type": "git",

package/src/mod.ts

@@ -70,6 +70,7 @@ export {
   FetchError,
   getUserAgent,
   type GetUserAgentOptions,
+  isTransientFetchError,
   logRequest,
 } from "./request.ts";
 export {