@fedify/vocab-runtime 2.5.0-dev.2332 → 2.5.0-dev.2355

package/deno.json

@@ -1,6 +1,6 @@
 {
   "name": "@fedify/vocab-runtime",
-  "version": "2.5.0-dev.2332+d4e3f91f",
+  "version": "2.5.0-dev.2355+c92a1cb1",
   "license": "MIT",
   "exports": {
     ".": "./src/mod.ts",

package/dist/{docloader-BMHljyYb.d.cts → docloader-BBnBpbsG.d.cts}

@@ -24,6 +24,39 @@ declare class FetchError extends Error {
   constructor(url: URL | string, message?: string, response?: Response);
 }
 /**
+* 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
+*/
+declare function isTransientFetchError(error: unknown): boolean;
+/**
 * Options for creating a request.
 * @internal
 */
@@ -267,4 +300,4 @@ declare function getDocumentLoader({
   userAgent
 }?: GetDocumentLoaderOptions): DocumentLoader;
 //#endregion
-export { logRequest as _, DocumentLoaderOptions as a, getDocumentLoader as c, withDocumentLoaderTimeout as d, CreateRequestOptions as f, getUserAgent as g, createActivityPubRequest as h, DocumentLoaderFactoryOptions as i, getRemoteDocument as l, GetUserAgentOptions as m, DocumentLoader as n, GetDocumentLoaderOptions as o, FetchError as p, DocumentLoaderFactory as r, RemoteDocument as s, AuthenticatedDocumentLoaderFactory as t, resolveDocumentLoaderTimeout as u };
+export { isTransientFetchError as _, DocumentLoaderOptions as a, getDocumentLoader as c, withDocumentLoaderTimeout as d, CreateRequestOptions as f, getUserAgent as g, createActivityPubRequest as h, DocumentLoaderFactoryOptions as i, getRemoteDocument as l, GetUserAgentOptions as m, DocumentLoader as n, GetDocumentLoaderOptions as o, FetchError as p, DocumentLoaderFactory as r, RemoteDocument as s, AuthenticatedDocumentLoaderFactory as t, resolveDocumentLoaderTimeout as u, logRequest as v };

package/dist/{docloader-BMHljyYb.d.ts → docloader-BBnBpbsG.d.ts}

@@ -24,6 +24,39 @@ declare class FetchError extends Error {
   constructor(url: URL | string, message?: string, response?: Response);
 }
 /**
+* 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
+*/
+declare function isTransientFetchError(error: unknown): boolean;
+/**
 * Options for creating a request.
 * @internal
 */
@@ -267,4 +300,4 @@ declare function getDocumentLoader({
   userAgent
 }?: GetDocumentLoaderOptions): DocumentLoader;
 //#endregion
-export { logRequest as _, DocumentLoaderOptions as a, getDocumentLoader as c, withDocumentLoaderTimeout as d, CreateRequestOptions as f, getUserAgent as g, createActivityPubRequest as h, DocumentLoaderFactoryOptions as i, getRemoteDocument as l, GetUserAgentOptions as m, DocumentLoader as n, GetDocumentLoaderOptions as o, FetchError as p, DocumentLoaderFactory as r, RemoteDocument as s, AuthenticatedDocumentLoaderFactory as t, resolveDocumentLoaderTimeout as u };
+export { isTransientFetchError as _, DocumentLoaderOptions as a, getDocumentLoader as c, withDocumentLoaderTimeout as d, CreateRequestOptions as f, getUserAgent as g, createActivityPubRequest as h, DocumentLoaderFactoryOptions as i, getRemoteDocument as l, GetUserAgentOptions as m, DocumentLoader as n, GetDocumentLoaderOptions as o, FetchError as p, DocumentLoaderFactory as r, RemoteDocument as s, AuthenticatedDocumentLoaderFactory as t, resolveDocumentLoaderTimeout as u, logRequest as v };

package/dist/internal/jsonld-cache.d.cts

@@ -1,5 +1,5 @@
 /// <reference lib="esnext.temporal" />
-import { n as DocumentLoader } from "../docloader-BMHljyYb.cjs";
+import { n as DocumentLoader } from "../docloader-BBnBpbsG.cjs";
 
 //#region src/internal/jsonld-cache.d.ts
 /**

package/dist/internal/jsonld-cache.d.ts

@@ -1,5 +1,5 @@
 /// <reference lib="esnext.temporal" />
-import { n as DocumentLoader } from "../docloader-BMHljyYb.js";
+import { n as DocumentLoader } from "../docloader-BBnBpbsG.js";
 
 //#region src/internal/jsonld-cache.d.ts
 /**

package/dist/internal/portable-dereference.d.cts

@@ -1,6 +1,6 @@
 /// <reference lib="esnext.temporal" />
-import { n as DocumentLoader, s as RemoteDocument } from "../docloader-BMHljyYb.cjs";
-import { r as PortableObjectVerifier } from "../portable-6Aj-7dZJ.cjs";
+import { n as DocumentLoader, s as RemoteDocument } from "../docloader-BBnBpbsG.cjs";
+import { r as PortableObjectVerifier } from "../portable-Dfvcg_Wy.cjs";
 import { Span, TracerProvider } from "@opentelemetry/api";
 
 //#region src/internal/portable-dereference.d.ts

package/dist/internal/portable-dereference.d.ts

@@ -1,6 +1,6 @@
 /// <reference lib="esnext.temporal" />
-import { n as DocumentLoader, s as RemoteDocument } from "../docloader-BMHljyYb.js";
-import { r as PortableObjectVerifier } from "../portable-nkTiqH0w.js";
+import { n as DocumentLoader, s as RemoteDocument } from "../docloader-BBnBpbsG.js";
+import { r as PortableObjectVerifier } from "../portable-BDydjp5H.js";
 import { Span, TracerProvider } from "@opentelemetry/api";
 
 //#region src/internal/portable-dereference.d.ts

package/dist/mod.cjs

@@ -16,7 +16,7 @@ let _multiformats_base_x = require("@multiformats/base-x");
 _multiformats_base_x = require_rolldown_runtime.__toESM(_multiformats_base_x, 1);
 //#region deno.json
 var name = "@fedify/vocab-runtime";
-var version = "2.5.0-dev.2332+d4e3f91f";
+var version = "2.5.0-dev.2355+c92a1cb1";
 //#endregion
 //#region src/request.ts
 /**
@@ -45,6 +45,90 @@ var FetchError = class extends Error {
 		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
@@ -1800,6 +1884,7 @@ exports.importPkcs1 = importPkcs1;
 exports.importSpki = importSpki;
 exports.isDecimal = isDecimal;
 exports.isGatewayUrl = require_url.isGatewayUrl;
+exports.isTransientFetchError = isTransientFetchError;
 exports.isValidPublicIPv4Address = require_url.isValidPublicIPv4Address;
 exports.isValidPublicIPv6Address = require_url.isValidPublicIPv6Address;
 exports.logRequest = logRequest;

package/dist/mod.d.cts

@@ -1,6 +1,6 @@
 /// <reference lib="esnext.temporal" />
-import { _ as logRequest, a as DocumentLoaderOptions, c as getDocumentLoader, d as withDocumentLoaderTimeout, f as CreateRequestOptions, g as getUserAgent, h as createActivityPubRequest, i as DocumentLoaderFactoryOptions, l as getRemoteDocument, m as GetUserAgentOptions, n as DocumentLoader, o as GetDocumentLoaderOptions, p as FetchError, r as DocumentLoaderFactory, s as RemoteDocument, t as AuthenticatedDocumentLoaderFactory, u as resolveDocumentLoaderTimeout } from "./docloader-BMHljyYb.cjs";
-import { i as PortableObjectVerifierOptions, n as PortableObjectVerification, r as PortableObjectVerifier, t as PortableObjectReferrer } from "./portable-6Aj-7dZJ.cjs";
+import { _ as isTransientFetchError, a as DocumentLoaderOptions, c as getDocumentLoader, d as withDocumentLoaderTimeout, f as CreateRequestOptions, g as getUserAgent, h as createActivityPubRequest, i as DocumentLoaderFactoryOptions, l as getRemoteDocument, m as GetUserAgentOptions, n as DocumentLoader, o as GetDocumentLoaderOptions, p as FetchError, r as DocumentLoaderFactory, s as RemoteDocument, t as AuthenticatedDocumentLoaderFactory, u as resolveDocumentLoaderTimeout, v as logRequest } from "./docloader-BBnBpbsG.cjs";
+import { i as PortableObjectVerifierOptions, n as PortableObjectVerification, r as PortableObjectVerifier, t as PortableObjectReferrer } from "./portable-Dfvcg_Wy.cjs";
 import { TracerProvider } from "@opentelemetry/api";
 
 //#region src/contexts.d.ts
@@ -803,4 +803,4 @@ declare function isValidPublicIPv4Address(address: string): boolean;
 declare function isValidPublicIPv6Address(address: string): boolean;
 declare function expandIPv6Address(address: string): string;
 //#endregion
-export { type AuthenticatedDocumentLoaderFactory, type CreateRequestOptions, type Decimal, type DidKeyVerificationMethod, type DocumentLoader, type DocumentLoaderFactory, type DocumentLoaderFactoryOptions, type DocumentLoaderOptions, FetchError, type FetchPortableMediaOptions, type GetDocumentLoaderOptions, type GetUserAgentOptions, type Json, LanguageString, type ParsedDigestMultibase, type ParsedHashlink, type PortableMedia, type PortableObjectReferrer, type PortableObjectVerification, type PortableObjectVerifier, type PortableObjectVerifierOptions, type PropertyPreprocessor, type PropertyPreprocessorContext, type RemoteDocument, UrlError, arePortableUrisEqual, canParseDecimal, canonicalizePortableUri, computeDigestMultibase, createActivityPubRequest, createHashlink, decodeMultibase, encodeMultibase, encodingFromBaseData, expandIPv6Address, exportDidKey, exportMultibaseKey, exportSpki, fetchPortableMedia, formatIri, fromCompatibleEf61Id, getDocumentLoader, getFe34Origin, getGatewayHints, getRemoteDocument, getUserAgent, haveSameFe34Origin, haveSameIriOrigin, importDidKey, importMultibaseKey, importPem, importPkcs1, importSpki, isDecimal, isGatewayUrl, isValidPublicIPv4Address, isValidPublicIPv6Address, logRequest, normalizeLanguageTag, parseDecimal, parseDidKeyVerificationMethod, parseDigestMultibase, parseGatewayUrl, parseHashlink, parseIri, parseJsonLdId, preloadedContexts, resolveDocumentLoaderTimeout, toCompatibleEf61Id, validatePublicUrl, verifyDigestMultibase, verifyHashlink, withDocumentLoaderTimeout, withGatewayHints, withoutGatewayHints };
+export { type AuthenticatedDocumentLoaderFactory, type CreateRequestOptions, type Decimal, type DidKeyVerificationMethod, type DocumentLoader, type DocumentLoaderFactory, type DocumentLoaderFactoryOptions, type DocumentLoaderOptions, FetchError, type FetchPortableMediaOptions, type GetDocumentLoaderOptions, type GetUserAgentOptions, type Json, LanguageString, type ParsedDigestMultibase, type ParsedHashlink, type PortableMedia, type PortableObjectReferrer, type PortableObjectVerification, type PortableObjectVerifier, type PortableObjectVerifierOptions, type PropertyPreprocessor, type PropertyPreprocessorContext, type RemoteDocument, UrlError, arePortableUrisEqual, canParseDecimal, canonicalizePortableUri, computeDigestMultibase, createActivityPubRequest, createHashlink, decodeMultibase, encodeMultibase, encodingFromBaseData, expandIPv6Address, exportDidKey, exportMultibaseKey, exportSpki, fetchPortableMedia, formatIri, fromCompatibleEf61Id, getDocumentLoader, getFe34Origin, getGatewayHints, getRemoteDocument, getUserAgent, haveSameFe34Origin, haveSameIriOrigin, importDidKey, importMultibaseKey, importPem, importPkcs1, importSpki, isDecimal, isGatewayUrl, isTransientFetchError, isValidPublicIPv4Address, isValidPublicIPv6Address, logRequest, normalizeLanguageTag, parseDecimal, parseDidKeyVerificationMethod, parseDigestMultibase, parseGatewayUrl, parseHashlink, parseIri, parseJsonLdId, preloadedContexts, resolveDocumentLoaderTimeout, toCompatibleEf61Id, validatePublicUrl, verifyDigestMultibase, verifyHashlink, withDocumentLoaderTimeout, withGatewayHints, withoutGatewayHints };

package/dist/mod.d.ts

@@ -1,6 +1,6 @@
 /// <reference lib="esnext.temporal" />
-import { _ as logRequest, a as DocumentLoaderOptions, c as getDocumentLoader, d as withDocumentLoaderTimeout, f as CreateRequestOptions, g as getUserAgent, h as createActivityPubRequest, i as DocumentLoaderFactoryOptions, l as getRemoteDocument, m as GetUserAgentOptions, n as DocumentLoader, o as GetDocumentLoaderOptions, p as FetchError, r as DocumentLoaderFactory, s as RemoteDocument, t as AuthenticatedDocumentLoaderFactory, u as resolveDocumentLoaderTimeout } from "./docloader-BMHljyYb.js";
-import { i as PortableObjectVerifierOptions, n as PortableObjectVerification, r as PortableObjectVerifier, t as PortableObjectReferrer } from "./portable-nkTiqH0w.js";
+import { _ as isTransientFetchError, a as DocumentLoaderOptions, c as getDocumentLoader, d as withDocumentLoaderTimeout, f as CreateRequestOptions, g as getUserAgent, h as createActivityPubRequest, i as DocumentLoaderFactoryOptions, l as getRemoteDocument, m as GetUserAgentOptions, n as DocumentLoader, o as GetDocumentLoaderOptions, p as FetchError, r as DocumentLoaderFactory, s as RemoteDocument, t as AuthenticatedDocumentLoaderFactory, u as resolveDocumentLoaderTimeout, v as logRequest } from "./docloader-BBnBpbsG.js";
+import { i as PortableObjectVerifierOptions, n as PortableObjectVerification, r as PortableObjectVerifier, t as PortableObjectReferrer } from "./portable-BDydjp5H.js";
 import { TracerProvider } from "@opentelemetry/api";
 //#region src/contexts.d.ts
 declare const preloadedContexts: Record<string, unknown>;
@@ -802,4 +802,4 @@ declare function isValidPublicIPv4Address(address: string): boolean;
 declare function isValidPublicIPv6Address(address: string): boolean;
 declare function expandIPv6Address(address: string): string;
 //#endregion
-export { type AuthenticatedDocumentLoaderFactory, type CreateRequestOptions, type Decimal, type DidKeyVerificationMethod, type DocumentLoader, type DocumentLoaderFactory, type DocumentLoaderFactoryOptions, type DocumentLoaderOptions, FetchError, type FetchPortableMediaOptions, type GetDocumentLoaderOptions, type GetUserAgentOptions, type Json, LanguageString, type ParsedDigestMultibase, type ParsedHashlink, type PortableMedia, type PortableObjectReferrer, type PortableObjectVerification, type PortableObjectVerifier, type PortableObjectVerifierOptions, type PropertyPreprocessor, type PropertyPreprocessorContext, type RemoteDocument, UrlError, arePortableUrisEqual, canParseDecimal, canonicalizePortableUri, computeDigestMultibase, createActivityPubRequest, createHashlink, decodeMultibase, encodeMultibase, encodingFromBaseData, expandIPv6Address, exportDidKey, exportMultibaseKey, exportSpki, fetchPortableMedia, formatIri, fromCompatibleEf61Id, getDocumentLoader, getFe34Origin, getGatewayHints, getRemoteDocument, getUserAgent, haveSameFe34Origin, haveSameIriOrigin, importDidKey, importMultibaseKey, importPem, importPkcs1, importSpki, isDecimal, isGatewayUrl, isValidPublicIPv4Address, isValidPublicIPv6Address, logRequest, normalizeLanguageTag, parseDecimal, parseDidKeyVerificationMethod, parseDigestMultibase, parseGatewayUrl, parseHashlink, parseIri, parseJsonLdId, preloadedContexts, resolveDocumentLoaderTimeout, toCompatibleEf61Id, validatePublicUrl, verifyDigestMultibase, verifyHashlink, withDocumentLoaderTimeout, withGatewayHints, withoutGatewayHints };
+export { type AuthenticatedDocumentLoaderFactory, type CreateRequestOptions, type Decimal, type DidKeyVerificationMethod, type DocumentLoader, type DocumentLoaderFactory, type DocumentLoaderFactoryOptions, type DocumentLoaderOptions, FetchError, type FetchPortableMediaOptions, type GetDocumentLoaderOptions, type GetUserAgentOptions, type Json, LanguageString, type ParsedDigestMultibase, type ParsedHashlink, type PortableMedia, type PortableObjectReferrer, type PortableObjectVerification, type PortableObjectVerifier, type PortableObjectVerifierOptions, type PropertyPreprocessor, type PropertyPreprocessorContext, type RemoteDocument, UrlError, arePortableUrisEqual, canParseDecimal, canonicalizePortableUri, computeDigestMultibase, createActivityPubRequest, createHashlink, decodeMultibase, encodeMultibase, encodingFromBaseData, expandIPv6Address, exportDidKey, exportMultibaseKey, exportSpki, fetchPortableMedia, formatIri, fromCompatibleEf61Id, getDocumentLoader, getFe34Origin, getGatewayHints, getRemoteDocument, getUserAgent, haveSameFe34Origin, haveSameIriOrigin, importDidKey, importMultibaseKey, importPem, importPkcs1, importSpki, isDecimal, isGatewayUrl, isTransientFetchError, isValidPublicIPv4Address, isValidPublicIPv6Address, logRequest, normalizeLanguageTag, parseDecimal, parseDidKeyVerificationMethod, parseDigestMultibase, parseGatewayUrl, parseHashlink, parseIri, parseJsonLdId, preloadedContexts, resolveDocumentLoaderTimeout, toCompatibleEf61Id, validatePublicUrl, verifyDigestMultibase, verifyHashlink, withDocumentLoaderTimeout, withGatewayHints, withoutGatewayHints };

package/dist/mod.js

@@ -12,7 +12,7 @@ import { PublicKeyInfo } from "pkijs";
 import baseX from "@multiformats/base-x";
 //#region deno.json
 var name = "@fedify/vocab-runtime";
-var version = "2.5.0-dev.2332+d4e3f91f";
+var version = "2.5.0-dev.2355+c92a1cb1";
 //#endregion
 //#region src/request.ts
 /**
@@ -41,6 +41,90 @@ var FetchError = class extends Error {
 		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
@@ -1763,4 +1847,4 @@ async function fetchPortableMedia(media, options = {}) {
 	}, options.signal, timeout);
 }
 //#endregion
-export { FetchError, LanguageString, UrlError, arePortableUrisEqual, canParseDecimal, canonicalizePortableUri, computeDigestMultibase, createActivityPubRequest, createHashlink, decodeMultibase, encodeMultibase, encodingFromBaseData, expandIPv6Address, exportDidKey, exportMultibaseKey, exportSpki, fetchPortableMedia, formatIri, fromCompatibleEf61Id, getDocumentLoader, getFe34Origin, getGatewayHints, getRemoteDocument, getUserAgent, haveSameFe34Origin, haveSameIriOrigin, importDidKey, importMultibaseKey, importPem, importPkcs1, importSpki, isDecimal, isGatewayUrl, isValidPublicIPv4Address, isValidPublicIPv6Address, logRequest, normalizeLanguageTag, parseDecimal, parseDidKeyVerificationMethod, parseDigestMultibase, parseGatewayUrl, parseHashlink, parseIri, parseJsonLdId, preloadedContexts, resolveDocumentLoaderTimeout, toCompatibleEf61Id, validatePublicUrl, verifyDigestMultibase, verifyHashlink, withDocumentLoaderTimeout, withGatewayHints, withoutGatewayHints };
+export { FetchError, LanguageString, UrlError, arePortableUrisEqual, canParseDecimal, canonicalizePortableUri, computeDigestMultibase, createActivityPubRequest, createHashlink, decodeMultibase, encodeMultibase, encodingFromBaseData, expandIPv6Address, exportDidKey, exportMultibaseKey, exportSpki, fetchPortableMedia, formatIri, fromCompatibleEf61Id, getDocumentLoader, getFe34Origin, getGatewayHints, getRemoteDocument, getUserAgent, haveSameFe34Origin, haveSameIriOrigin, importDidKey, importMultibaseKey, importPem, importPkcs1, importSpki, isDecimal, isGatewayUrl, isTransientFetchError, isValidPublicIPv4Address, isValidPublicIPv6Address, logRequest, normalizeLanguageTag, parseDecimal, parseDidKeyVerificationMethod, parseDigestMultibase, parseGatewayUrl, parseHashlink, parseIri, parseJsonLdId, preloadedContexts, resolveDocumentLoaderTimeout, toCompatibleEf61Id, validatePublicUrl, verifyDigestMultibase, verifyHashlink, withDocumentLoaderTimeout, withGatewayHints, withoutGatewayHints };

package/dist/{portable-nkTiqH0w.d.ts → portable-BDydjp5H.d.ts}

@@ -1,5 +1,5 @@
 /// <reference lib="esnext.temporal" />
-import { n as DocumentLoader } from "./docloader-BMHljyYb.js";
+import { n as DocumentLoader } from "./docloader-BBnBpbsG.js";
 import { TracerProvider } from "@opentelemetry/api";
 
 //#region src/portable.d.ts

package/dist/{portable-6Aj-7dZJ.d.cts → portable-Dfvcg_Wy.d.cts}

@@ -1,5 +1,5 @@
 /// <reference lib="esnext.temporal" />
-import { n as DocumentLoader } from "./docloader-BMHljyYb.cjs";
+import { n as DocumentLoader } from "./docloader-BBnBpbsG.cjs";
 import { TracerProvider } from "@opentelemetry/api";
 
 //#region src/portable.d.ts

package/dist/tests/{body-B8-N24Wt.cjs → body-BsbzxRBV.cjs}

@@ -1,4 +1,4 @@
-const require_request = require("./request-Bf4ZTr5h.cjs");
+const require_request = require("./request-DtExxXoM.cjs");
 let _logtape_logtape = require("@logtape/logtape");
 //#region src/body.ts
 /** Decoded JSON body limit: 16 MiB.  @internal */

package/dist/tests/{body-QNeqKF6t.mjs → body-CS1w_3TA.mjs}

@@ -1,4 +1,4 @@
-import { t as FetchError } from "./request-C2niWNLL.mjs";
+import { t as FetchError } from "./request-BWJ0Niez.mjs";
 import { getLogger } from "@logtape/logtape";
 //#region src/body.ts
 /** Decoded JSON body limit: 16 MiB.  @internal */

package/dist/tests/body.test.cjs

@@ -1,4 +1,4 @@
-const require_body = require("./body-B8-N24Wt.cjs");
+const require_body = require("./body-BsbzxRBV.cjs");
 let node_assert_strict = require("node:assert/strict");
 let node_test = require("node:test");
 let node_zlib = require("node:zlib");

package/dist/tests/body.test.mjs

@@ -1,4 +1,4 @@
-import { i as readBoundedText, t as BodyTooLargeError } from "./body-QNeqKF6t.mjs";
+import { i as readBoundedText, t as BodyTooLargeError } from "./body-CS1w_3TA.mjs";
 import { deepStrictEqual, ok, rejects } from "node:assert/strict";
 import { test } from "node:test";
 import { gunzipSync, gzipSync } from "node:zlib";

package/dist/tests/decimal.test.cjs

@@ -1,11 +1,12 @@
+require("./request-DtExxXoM.cjs");
 require("./url-BNakuZ8k.cjs");
-require("./docloader-U8lx6Ahe.cjs");
+require("./docloader-D5LysMb_.cjs");
 require("./key-C-AYkdJJ.cjs");
 require("./multibase-B5Mea7Ip.cjs");
 require("./digest-3FeH2Y-Q.cjs");
 require("./langtag-DASCPgl3.cjs");
 require("./langstr-h89Kjekh.cjs");
-require("./portable-media-CriQQ3xz.cjs");
+require("./portable-media-nBsL1fe6.cjs");
 let node_test = require("node:test");
 let node_assert = require("node:assert");
 //#region src/decimal.ts

package/dist/tests/decimal.test.mjs

@@ -1,11 +1,12 @@
+import "./request-BWJ0Niez.mjs";
 import "./url-DMxmp7ZG.mjs";
-import "./docloader-_FC4G4HE.mjs";
+import "./docloader-B23NKiGE.mjs";
 import "./key-C2Db_TAJ.mjs";
 import "./multibase-BPnF_L4e.mjs";
 import "./digest-COC7xDiQ.mjs";
 import "./langtag-CD3zHKPN.mjs";
 import "./langstr-Dw8IBDZl.mjs";
-import "./portable-media-B4LO-ao_.mjs";
+import "./portable-media-DvcYLpOn.mjs";
 import { test } from "node:test";
 import { deepStrictEqual, throws } from "node:assert";
 //#region src/decimal.ts

package/dist/tests/{docloader-_FC4G4HE.mjs → docloader-B23NKiGE.mjs}

@@ -1,8 +1,8 @@
-import { a as name, i as logRequest, n as createActivityPubRequest, o as version, t as FetchError } from "./request-C2niWNLL.mjs";
-import { i as readBoundedText, n as MAX_BODY_SIZE, r as readBoundedBytes, t as BodyTooLargeError } from "./body-QNeqKF6t.mjs";
+import { a as logRequest, n as createActivityPubRequest, o as name, s as version, t as FetchError } from "./request-BWJ0Niez.mjs";
+import { n as UrlError, x as validatePublicUrl } from "./url-DMxmp7ZG.mjs";
+import { i as readBoundedText, n as MAX_BODY_SIZE, r as readBoundedBytes, t as BodyTooLargeError } from "./body-CS1w_3TA.mjs";
 import { t as preloadedContexts } from "./contexts-duRA_dDC.mjs";
 import { t as HttpHeaderLink } from "./link-Cevmc87v.mjs";
-import { n as UrlError, x as validatePublicUrl } from "./url-DMxmp7ZG.mjs";
 import { getLogger } from "@logtape/logtape";
 import { SpanKind, SpanStatusCode, trace } from "@opentelemetry/api";
 //#region src/docloader.ts

package/dist/tests/{docloader-U8lx6Ahe.cjs → docloader-D5LysMb_.cjs}

@@ -1,8 +1,8 @@
-const require_request = require("./request-Bf4ZTr5h.cjs");
-const require_body = require("./body-B8-N24Wt.cjs");
+const require_request = require("./request-DtExxXoM.cjs");
+const require_url = require("./url-BNakuZ8k.cjs");
+const require_body = require("./body-BsbzxRBV.cjs");
 const require_contexts = require("./contexts-C9Lj11SC.cjs");
 const require_link = require("./link-DlKm8bEr.cjs");
-const require_url = require("./url-BNakuZ8k.cjs");
 let _logtape_logtape = require("@logtape/logtape");
 let _opentelemetry_api = require("@opentelemetry/api");
 //#region src/docloader.ts

package/dist/tests/docloader.test.cjs

@@ -1,14 +1,14 @@
 const require_rolldown_runtime = require("./rolldown-runtime-emK7D4bc.cjs");
-const require_request = require("./request-Bf4ZTr5h.cjs");
-const require_contexts = require("./contexts-C9Lj11SC.cjs");
+const require_request = require("./request-DtExxXoM.cjs");
 const require_url = require("./url-BNakuZ8k.cjs");
-const require_docloader = require("./docloader-U8lx6Ahe.cjs");
+const require_contexts = require("./contexts-C9Lj11SC.cjs");
+const require_docloader = require("./docloader-D5LysMb_.cjs");
 const require_jsonld = require("./jsonld-CmDhHNTx.cjs");
 let node_zlib = require("node:zlib");
 let _logtape_logtape = require("@logtape/logtape");
-let node_assert = require("node:assert");
 let node_dns_promises = require("node:dns/promises");
 node_dns_promises = require_rolldown_runtime.__toESM(node_dns_promises, 1);
+let node_assert = require("node:assert");
 let _fedify_fixture = require("@fedify/fixture");
 let node_http = require("node:http");
 //#region ../../node_modules/.pnpm/glob-to-regexp@0.4.1/node_modules/glob-to-regexp/index.js

package/dist/tests/docloader.test.mjs

@@ -1,12 +1,12 @@
-import { t as FetchError } from "./request-C2niWNLL.mjs";
-import { n as cid_v1_default, t as preloadedContexts } from "./contexts-duRA_dDC.mjs";
+import { t as FetchError } from "./request-BWJ0Niez.mjs";
 import { n as UrlError } from "./url-DMxmp7ZG.mjs";
-import { i as withDocumentLoaderTimeout, n as getRemoteDocument, r as resolveDocumentLoaderTimeout, t as getDocumentLoader } from "./docloader-_FC4G4HE.mjs";
+import { n as cid_v1_default, t as preloadedContexts } from "./contexts-duRA_dDC.mjs";
+import { i as withDocumentLoaderTimeout, n as getRemoteDocument, r as resolveDocumentLoaderTimeout, t as getDocumentLoader } from "./docloader-B23NKiGE.mjs";
 import { t as jsonld_default } from "./jsonld-DweIJ07b.mjs";
 import { gzipSync } from "node:zlib";
 import { configure, reset } from "@logtape/logtape";
-import { deepStrictEqual, ok, rejects, throws } from "node:assert";
 import dns from "node:dns/promises";
+import { deepStrictEqual, ok, rejects, throws } from "node:assert";
 import { test } from "@fedify/fixture";
 import { createServer } from "node:http";
 //#region \0rolldown/runtime.js

package/dist/tests/internal/portable-dereference.test.cjs

@@ -1,6 +1,6 @@
 const require_url = require("../url-BNakuZ8k.cjs");
 const require_jsonld_cache = require("../jsonld-cache-BEXiiM-V.cjs");
-const require_portable_dereference = require("../portable-dereference-qTLMqe2_.cjs");
+const require_portable_dereference = require("../portable-dereference-DaTBBvCj.cjs");
 let node_assert_strict = require("node:assert/strict");
 let node_test = require("node:test");
 //#region src/internal/portable-dereference.test.ts

package/dist/tests/internal/portable-dereference.test.mjs

@@ -1,6 +1,6 @@
 import { S as withGatewayHints, _ as parseIri } from "../url-DMxmp7ZG.mjs";
 import { n as createScopedContextLoader } from "../jsonld-cache-DFnWsLuZ.mjs";
-import { a as recordPortableReferrer, i as isPortableIri, n as getPortableGatewayCandidates, r as getReferrerGateways, t as createSnapshotContextLoader } from "../portable-dereference-DmTYDy2p.mjs";
+import { a as recordPortableReferrer, i as isPortableIri, n as getPortableGatewayCandidates, r as getReferrerGateways, t as createSnapshotContextLoader } from "../portable-dereference-sGRs_qdT.mjs";
 import { deepStrictEqual, ok, throws } from "node:assert/strict";
 import { test } from "node:test";
 //#region src/internal/portable-dereference.test.ts

package/dist/tests/{portable-media-B4LO-ao_.mjs → portable-media-DvcYLpOn.mjs}

@@ -1,6 +1,6 @@
-import { r as getUserAgent } from "./request-C2niWNLL.mjs";
-import { r as readBoundedBytes } from "./body-QNeqKF6t.mjs";
+import { r as getUserAgent } from "./request-BWJ0Niez.mjs";
 import { g as parseGatewayUrl, x as validatePublicUrl } from "./url-DMxmp7ZG.mjs";
+import { r as readBoundedBytes } from "./body-CS1w_3TA.mjs";
 import { a as verifyDigestMultibase, i as parseHashlink, r as parseDigestMultibase } from "./digest-COC7xDiQ.mjs";
 //#region src/portable-media.ts
 function resolveTimeout(value, fallback) {

package/dist/tests/{portable-media-CriQQ3xz.cjs → portable-media-nBsL1fe6.cjs}

@@ -1,6 +1,6 @@
-const require_request = require("./request-Bf4ZTr5h.cjs");
-const require_body = require("./body-B8-N24Wt.cjs");
+const require_request = require("./request-DtExxXoM.cjs");
 const require_url = require("./url-BNakuZ8k.cjs");
+const require_body = require("./body-BsbzxRBV.cjs");
 const require_digest = require("./digest-3FeH2Y-Q.cjs");
 //#region src/portable-media.ts
 function resolveTimeout(value, fallback) {

package/dist/tests/portable-media.test.cjs

@@ -1,5 +1,5 @@
 const require_digest = require("./digest-3FeH2Y-Q.cjs");
-const require_portable_media = require("./portable-media-CriQQ3xz.cjs");
+const require_portable_media = require("./portable-media-nBsL1fe6.cjs");
 let node_assert_strict = require("node:assert/strict");
 let node_test = require("node:test");
 let node_http = require("node:http");

package/dist/tests/portable-media.test.mjs

@@ -1,5 +1,5 @@
 import { n as createHashlink, t as computeDigestMultibase } from "./digest-COC7xDiQ.mjs";
-import { t as fetchPortableMedia } from "./portable-media-B4LO-ao_.mjs";
+import { t as fetchPortableMedia } from "./portable-media-DvcYLpOn.mjs";
 import { deepStrictEqual, equal, rejects } from "node:assert/strict";
 import { test } from "node:test";
 import { createServer } from "node:http";

package/dist/tests/portable-workers.test.cjs

@@ -2,7 +2,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_url = require("./url-BNakuZ8k.cjs");
 const require_key = require("./key-C-AYkdJJ.cjs");
 const require_digest = require("./digest-3FeH2Y-Q.cjs");
-const require_portable_dereference = require("./portable-dereference-qTLMqe2_.cjs");
+const require_portable_dereference = require("./portable-dereference-DaTBBvCj.cjs");
 let node_assert_strict = require("node:assert/strict");
 let _fedify_fixture = require("@fedify/fixture");
 //#region src/portable-workers.test.ts

package/dist/tests/portable-workers.test.mjs

@@ -1,7 +1,7 @@
 import { _ as parseIri, i as canonicalizePortableUri, o as formatIri, s as fromCompatibleEf61Id, y as toCompatibleEf61Id } from "./url-DMxmp7ZG.mjs";
 import { i as importDidKey, t as exportDidKey } from "./key-C2Db_TAJ.mjs";
 import { n as createHashlink, o as verifyHashlink, t as computeDigestMultibase } from "./digest-COC7xDiQ.mjs";
-import { n as getPortableGatewayCandidates } from "./portable-dereference-DmTYDy2p.mjs";
+import { n as getPortableGatewayCandidates } from "./portable-dereference-sGRs_qdT.mjs";
 import { deepStrictEqual, equal } from "node:assert/strict";
 import { test, testDefinitions } from "@fedify/fixture";
 //#region src/portable-workers.test.ts