@fedify/fedify 2.0.0-dev.1726 → 2.0.0-dev.1750

package/dist/testing/docloader.test.js

@@ -3,17 +3,15 @@
       import { URLPattern } from "urlpattern-polyfill";
       globalThis.addEventListener = () => {};
     
-import "../type-D_8QzkEn.js";
+import "../lookup-CxJLpHHf.js";
 import { assertEquals } from "../assert_equals-DSbWqCm3.js";
 import "../assert-MZs1qjMx.js";
 import "../assert_instance_of-DHz7EHNU.js";
-import "../lookup-VSVPBU3J.js";
-import { mockDocumentLoader, test } from "../testing-e8Kpb1uV.js";
-import "../std__assert-X-_kMxKM.js";
-import "../assert_rejects-DiIiJbZn.js";
-import "../assert_is_error-BPGph1Jx.js";
-import "../assert_not_equals-f3m3epl3.js";
-import "../assert_throws-BOO88avQ.js";
+import { mockDocumentLoader, test } from "../testing-BHLtJbQx.js";
+import "../std__assert-DWivtrGR.js";
+import "../assert_rejects-Ce45JcFg.js";
+import "../assert_throws-BNXdRGWP.js";
+import "../assert_not_equals-C80BG-_5.js";
 
 //#region src/testing/docloader.test.ts
 test("mockDocumentLoader()", async () => {

package/dist/testing/mod.d.ts

@@ -1,75 +1,9 @@
 import { Temporal } from "@js-temporal/polyfill";
 import { URLPattern } from "urlpattern-polyfill";
 globalThis.addEventListener = () => {};
+import { DocumentLoader, GetUserAgentOptions, LanguageString } from "@fedify/vocab-runtime";
 import { Span, TracerProvider } from "@opentelemetry/api";
 
-//#region src/runtime/docloader.d.ts
-/**
- * A remote JSON-LD document and its context fetched by
- * a {@link DocumentLoader}.
- */
-interface RemoteDocument {
-  /**
-   * The URL of the context document.
-   */
-  contextUrl: string | null;
-  /**
-   * The fetched JSON-LD document.
-   */
-  document: unknown;
-  /**
-   * The URL of the fetched document.
-   */
-  documentUrl: string;
-}
-/**
- * Options for {@link DocumentLoader}.
- * @since 1.8.0
- */
-interface DocumentLoaderOptions {
-  /**
-   * An `AbortSignal` for cancellation.
-   * @since 1.8.0
-   */
-  signal?: AbortSignal;
-}
-/**
- * A JSON-LD document loader that fetches documents from the Web.
- * @param url The URL of the document to load.
- * @param options The options for the document loader.
- * @returns The loaded remote document.
- */
-type DocumentLoader = (url: string, options?: DocumentLoaderOptions) => Promise<RemoteDocument>;
-/**
- * A factory function that creates a {@link DocumentLoader} with options.
- * @param options The options for the document loader.
- * @returns The document loader.
- * @since 1.4.0
- */
-
-/**
- * Options for making `User-Agent` string.
- * @see {@link getUserAgent}
- * @since 1.3.0
- */
-interface GetUserAgentOptions {
-  /**
-   * An optional software name and version, e.g., `"Hollo/1.0.0"`.
-   */
-  software?: string | null;
-  /**
-   * An optional URL to append to the user agent string.
-   * Usually the URL of the ActivityPub instance.
-   */
-  url?: string | URL | null;
-}
-/**
- * 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
- */
-//#endregion
 //#region src/nodeinfo/types.d.ts
 /**
  * The type of the result of parsing JSON.
@@ -248,25 +182,6 @@ interface GetNodeInfoOptions {
  * @since 1.2.0
  */
 //#endregion
-//#region src/runtime/langstr.d.ts
-/**
- * A language-tagged string which corresponds to the `rdf:langString` type.
- */
-declare class LanguageString extends String {
-  /**
-   * The locale of the string.
-   * @since 2.0.0
-   */
-  readonly locale: Intl.Locale;
-  /**
-   * Constructs a new `LanguageString`.
-   * @param value A string value written in the given language.
-   * @param locale The language of the string.  If a string is given, it will
-   *               be parsed as a `Intl.Locale` object.
-   */
-  constructor(value: string, language: Intl.Locale | string);
-}
-//#endregion
 //#region src/vocab/vocab.d.ts
 /** Describes an object of any kind. The Object type serves as the base type for
  * most of the other kinds of objects defined in the Activity Vocabulary,
@@ -7637,9 +7552,7 @@ interface Federatable<TContextData> {
    *             must have one or more variables.
    * @param dispatcher An object dispatcher callback to register.
    */
-  setObjectDispatcher<TObject extends Object$1, TParam extends string>(cls: (new (...args: any[]) => TObject) & {
-    typeId: URL;
-  }, path: `${string}{${TParam}}${string}{${TParam}}${string}{${TParam}}${string}{${TParam}}${string}{${TParam}}${string}{${TParam}}${string}`, dispatcher: ObjectDispatcher<TContextData, TObject, TParam>): ObjectCallbackSetters<TContextData, TObject, TParam>;
+  setObjectDispatcher<TObject extends Object$1, TParam extends string>(cls: ConstructorWithTypeId<TObject>, path: `${string}{${TParam}}${string}{${TParam}}${string}{${TParam}}${string}{${TParam}}${string}{${TParam}}${string}{${TParam}}${string}`, dispatcher: ObjectDispatcher<TContextData, TObject, TParam>): ObjectCallbackSetters<TContextData, TObject, TParam>;
   /**
    * Registers an object dispatcher.
    *
@@ -7653,9 +7566,7 @@ interface Federatable<TContextData> {
    *             must have one or more variables.
    * @param dispatcher An object dispatcher callback to register.
    */
-  setObjectDispatcher<TObject extends Object$1, TParam extends string>(cls: (new (...args: any[]) => TObject) & {
-    typeId: URL;
-  }, path: `${string}{${TParam}}${string}{${TParam}}${string}{${TParam}}${string}{${TParam}}${string}{${TParam}}${string}`, dispatcher: ObjectDispatcher<TContextData, TObject, TParam>): ObjectCallbackSetters<TContextData, TObject, TParam>;
+  setObjectDispatcher<TObject extends Object$1, TParam extends string>(cls: ConstructorWithTypeId<TObject>, path: `${string}{${TParam}}${string}{${TParam}}${string}{${TParam}}${string}{${TParam}}${string}{${TParam}}${string}`, dispatcher: ObjectDispatcher<TContextData, TObject, TParam>): ObjectCallbackSetters<TContextData, TObject, TParam>;
   /**
    * Registers an object dispatcher.
    *
@@ -7669,9 +7580,7 @@ interface Federatable<TContextData> {
    *             must have one or more variables.
    * @param dispatcher An object dispatcher callback to register.
    */
-  setObjectDispatcher<TObject extends Object$1, TParam extends string>(cls: (new (...args: any[]) => TObject) & {
-    typeId: URL;
-  }, path: `${string}{${TParam}}${string}{${TParam}}${string}{${TParam}}${string}{${TParam}}${string}`, dispatcher: ObjectDispatcher<TContextData, TObject, TParam>): ObjectCallbackSetters<TContextData, TObject, TParam>;
+  setObjectDispatcher<TObject extends Object$1, TParam extends string>(cls: ConstructorWithTypeId<TObject>, path: `${string}{${TParam}}${string}{${TParam}}${string}{${TParam}}${string}{${TParam}}${string}`, dispatcher: ObjectDispatcher<TContextData, TObject, TParam>): ObjectCallbackSetters<TContextData, TObject, TParam>;
   /**
    * Registers an object dispatcher.
    *
@@ -7685,9 +7594,7 @@ interface Federatable<TContextData> {
    *             must have one or more variables.
    * @param dispatcher An object dispatcher callback to register.
    */
-  setObjectDispatcher<TObject extends Object$1, TParam extends string>(cls: (new (...args: any[]) => TObject) & {
-    typeId: URL;
-  }, path: `${string}${Rfc6570Expression<TParam>}${string}${Rfc6570Expression<TParam>}${string}${Rfc6570Expression<TParam>}${string}`, dispatcher: ObjectDispatcher<TContextData, TObject, TParam>): ObjectCallbackSetters<TContextData, TObject, TParam>;
+  setObjectDispatcher<TObject extends Object$1, TParam extends string>(cls: ConstructorWithTypeId<TObject>, path: `${string}${Rfc6570Expression<TParam>}${string}${Rfc6570Expression<TParam>}${string}${Rfc6570Expression<TParam>}${string}`, dispatcher: ObjectDispatcher<TContextData, TObject, TParam>): ObjectCallbackSetters<TContextData, TObject, TParam>;
   /**
    * Registers an object dispatcher.
    *
@@ -7701,9 +7608,7 @@ interface Federatable<TContextData> {
    *             must have one or more variables.
    * @param dispatcher An object dispatcher callback to register.
    */
-  setObjectDispatcher<TObject extends Object$1, TParam extends string>(cls: (new (...args: any[]) => TObject) & {
-    typeId: URL;
-  }, path: `${string}${Rfc6570Expression<TParam>}${string}${Rfc6570Expression<TParam>}${string}`, dispatcher: ObjectDispatcher<TContextData, TObject, TParam>): ObjectCallbackSetters<TContextData, TObject, TParam>;
+  setObjectDispatcher<TObject extends Object$1, TParam extends string>(cls: ConstructorWithTypeId<TObject>, path: `${string}${Rfc6570Expression<TParam>}${string}${Rfc6570Expression<TParam>}${string}`, dispatcher: ObjectDispatcher<TContextData, TObject, TParam>): ObjectCallbackSetters<TContextData, TObject, TParam>;
   /**
    * Registers an object dispatcher.
    *
@@ -7717,9 +7622,7 @@ interface Federatable<TContextData> {
    *             must have one or more variables.
    * @param dispatcher An object dispatcher callback to register.
    */
-  setObjectDispatcher<TObject extends Object$1, TParam extends string>(cls: (new (...args: any[]) => TObject) & {
-    typeId: URL;
-  }, path: `${string}${Rfc6570Expression<TParam>}${string}`, dispatcher: ObjectDispatcher<TContextData, TObject, TParam>): ObjectCallbackSetters<TContextData, TObject, TParam>;
+  setObjectDispatcher<TObject extends Object$1, TParam extends string>(cls: ConstructorWithTypeId<TObject>, path: `${string}${Rfc6570Expression<TParam>}${string}`, dispatcher: ObjectDispatcher<TContextData, TObject, TParam>): ObjectCallbackSetters<TContextData, TObject, TParam>;
   /**
    * Registers an inbox dispatcher.
    *
@@ -7860,9 +7763,7 @@ interface Federatable<TContextData> {
    *             The path must have one or more variables.
    * @param dispatcher A collection dispatcher callback to register.
    */
-  setCollectionDispatcher<TObject extends Object$1, TParam extends string>(name: string | symbol, itemType: (new (...args: any[]) => TObject) & {
-    typeId: URL;
-  }, path: `${string}${Rfc6570Expression<TParam>}${string}${Rfc6570Expression<TParam>}${string}${Rfc6570Expression<TParam>}${string}`, dispatcher: CustomCollectionDispatcher<TObject, TParam, RequestContext<TContextData>, TContextData>): CustomCollectionCallbackSetters<TParam, RequestContext<TContextData>, TContextData>;
+  setCollectionDispatcher<TObject extends Object$1, TParam extends string>(name: string | symbol, itemType: ConstructorWithTypeId<TObject>, path: `${string}${Rfc6570Expression<TParam>}${string}${Rfc6570Expression<TParam>}${string}${Rfc6570Expression<TParam>}${string}`, dispatcher: CustomCollectionDispatcher<TObject, TParam, RequestContext<TContextData>, TContextData>): CustomCollectionCallbackSetters<TParam, RequestContext<TContextData>, TContextData>;
   /**
    * Registers a collection of objects dispatcher.
    *
@@ -7877,9 +7778,7 @@ interface Federatable<TContextData> {
    *             The path must have one or more variables.
    * @param dispatcher A collection dispatcher callback to register.
    */
-  setCollectionDispatcher<TObject extends Object$1, TParam extends string>(name: string | symbol, itemType: (new (...args: any[]) => TObject) & {
-    typeId: URL;
-  }, path: `${string}${Rfc6570Expression<TParam>}${string}${Rfc6570Expression<TParam>}${string}`, dispatcher: CustomCollectionDispatcher<TObject, TParam, RequestContext<TContextData>, TContextData>): CustomCollectionCallbackSetters<TParam, RequestContext<TContextData>, TContextData>;
+  setCollectionDispatcher<TObject extends Object$1, TParam extends string>(name: string | symbol, itemType: ConstructorWithTypeId<TObject>, path: `${string}${Rfc6570Expression<TParam>}${string}${Rfc6570Expression<TParam>}${string}`, dispatcher: CustomCollectionDispatcher<TObject, TParam, RequestContext<TContextData>, TContextData>): CustomCollectionCallbackSetters<TParam, RequestContext<TContextData>, TContextData>;
   /**
    * Registers a collection of objects dispatcher.
    *
@@ -7894,9 +7793,7 @@ interface Federatable<TContextData> {
    *             The path must have one or more variables.
    * @param dispatcher A collection dispatcher callback to register.
    */
-  setCollectionDispatcher<TObject extends Object$1, TParam extends string>(name: string | symbol, itemType: (new (...args: any[]) => TObject) & {
-    typeId: URL;
-  }, path: `${string}${Rfc6570Expression<TParam>}${string}`, dispatcher: CustomCollectionDispatcher<TObject, TParam, RequestContext<TContextData>, TContextData>): CustomCollectionCallbackSetters<TParam, RequestContext<TContextData>, TContextData>;
+  setCollectionDispatcher<TObject extends Object$1, TParam extends string>(name: string | symbol, itemType: ConstructorWithTypeId<TObject>, path: `${string}${Rfc6570Expression<TParam>}${string}`, dispatcher: CustomCollectionDispatcher<TObject, TParam, RequestContext<TContextData>, TContextData>): CustomCollectionCallbackSetters<TParam, RequestContext<TContextData>, TContextData>;
   /**
    * Registers an ordered collection of objects dispatcher.
    *
@@ -7911,9 +7808,7 @@ interface Federatable<TContextData> {
    *             The path must have one or more variables.
    * @param dispatcher A collection dispatcher callback to register.
    */
-  setOrderedCollectionDispatcher<TObject extends Object$1, TParam extends string>(name: string | symbol, itemType: (new (...args: any[]) => TObject) & {
-    typeId: URL;
-  }, path: `${string}${Rfc6570Expression<TParam>}${string}${Rfc6570Expression<TParam>}${string}${Rfc6570Expression<TParam>}${string}`, dispatcher: CustomCollectionDispatcher<TObject, TParam, RequestContext<TContextData>, TContextData>): CustomCollectionCallbackSetters<TParam, RequestContext<TContextData>, TContextData>;
+  setOrderedCollectionDispatcher<TObject extends Object$1, TParam extends string>(name: string | symbol, itemType: ConstructorWithTypeId<TObject>, path: `${string}${Rfc6570Expression<TParam>}${string}${Rfc6570Expression<TParam>}${string}${Rfc6570Expression<TParam>}${string}`, dispatcher: CustomCollectionDispatcher<TObject, TParam, RequestContext<TContextData>, TContextData>): CustomCollectionCallbackSetters<TParam, RequestContext<TContextData>, TContextData>;
   /**
    * Registers an ordered collection of objects dispatcher.
    *
@@ -7928,9 +7823,7 @@ interface Federatable<TContextData> {
    *             The path must have one or more variables.
    * @param dispatcher A collection dispatcher callback to register.
    */
-  setOrderedCollectionDispatcher<TObject extends Object$1, TParam extends string>(name: string | symbol, itemType: (new (...args: any[]) => TObject) & {
-    typeId: URL;
-  }, path: `${string}${Rfc6570Expression<TParam>}${string}${Rfc6570Expression<TParam>}${string}`, dispatcher: CustomCollectionDispatcher<TObject, TParam, RequestContext<TContextData>, TContextData>): CustomCollectionCallbackSetters<TParam, RequestContext<TContextData>, TContextData>;
+  setOrderedCollectionDispatcher<TObject extends Object$1, TParam extends string>(name: string | symbol, itemType: ConstructorWithTypeId<TObject>, path: `${string}${Rfc6570Expression<TParam>}${string}${Rfc6570Expression<TParam>}${string}`, dispatcher: CustomCollectionDispatcher<TObject, TParam, RequestContext<TContextData>, TContextData>): CustomCollectionCallbackSetters<TParam, RequestContext<TContextData>, TContextData>;
   /**
    * Registers an ordered collection of objects dispatcher.
    *
@@ -7945,9 +7838,7 @@ interface Federatable<TContextData> {
    *             The path must have one or more variables.
    * @param dispatcher A collection dispatcher callback to register.
    */
-  setOrderedCollectionDispatcher<TObject extends Object$1, TParam extends string>(name: string | symbol, itemType: (new (...args: any[]) => TObject) & {
-    typeId: URL;
-  }, path: `${string}${Rfc6570Expression<TParam>}${string}`, dispatcher: CustomCollectionDispatcher<TObject, TParam, RequestContext<TContextData>, TContextData>): CustomCollectionCallbackSetters<TParam, RequestContext<TContextData>, TContextData>;
+  setOrderedCollectionDispatcher<TObject extends Object$1, TParam extends string>(name: string | symbol, itemType: ConstructorWithTypeId<TObject>, path: `${string}${Rfc6570Expression<TParam>}${string}`, dispatcher: CustomCollectionDispatcher<TObject, TParam, RequestContext<TContextData>, TContextData>): CustomCollectionCallbackSetters<TParam, RequestContext<TContextData>, TContextData>;
 }
 /**
  * An object that registers federation-related business logic and dispatches
@@ -8405,9 +8296,7 @@ interface Context<TContextData> {
    * @throws {TypeError} If values are invalid.
    * @since 0.7.0
    */
-  getObjectUri<TObject extends Object$1>(cls: (new (...args: any[]) => TObject) & {
-    typeId: URL;
-  }, values: Record<string, string>): URL;
+  getObjectUri<TObject extends Object$1>(cls: ConstructorWithTypeId<TObject>, values: Record<string, string>): URL;
   /**
    * Builds the URI of an actor's outbox with the given identifier.
    * @param identifier The actor's identifier.
@@ -8721,9 +8610,7 @@ interface RequestContext<TContextData> extends Context<TContextData> {
    * @throws {TypeError} If values are invalid.
    * @since 0.7.0
    */
-  getObject<TObject extends Object$1>(cls: (new (...args: any[]) => TObject) & {
-    typeId: URL;
-  }, values: Record<string, string>): Promise<TObject | null>;
+  getObject<TObject extends Object$1>(cls: ConstructorWithTypeId<TObject>, values: Record<string, string>): Promise<TObject | null>;
   /**
    * Gets the public key of the sender, if any exists and it is verified.
    * Otherwise, `null` is returned.
@@ -8867,9 +8754,7 @@ type ParseUriResult =
  * The case of an object URI.
  */ | {
   readonly type: "object";
-  readonly class: (new (...args: any[]) => Object$1) & {
-    typeId: URL;
-  };
+  readonly class: ConstructorWithTypeId<Object$1>;
   readonly typeId: URL;
   readonly values: Record<string, string>;
 }

package/dist/testing/mod.js

@@ -3,8 +3,7 @@
       import { URLPattern } from "urlpattern-polyfill";
       globalThis.addEventListener = () => {};
     
-import "../type-D_8QzkEn.js";
-import "../lookup-VSVPBU3J.js";
-import { createInboxContext, createRequestContext, test, testDefinitions } from "../testing-e8Kpb1uV.js";
+import "../lookup-CxJLpHHf.js";
+import { createInboxContext, createRequestContext, test, testDefinitions } from "../testing-BHLtJbQx.js";
 
 export { createInboxContext, createRequestContext, test, testDefinitions };

package/dist/{testing-e8Kpb1uV.js → testing-BHLtJbQx.js}

@@ -3,8 +3,7 @@
       import { URLPattern } from "urlpattern-polyfill";
       globalThis.addEventListener = () => {};
     
-import { __require, lookupWebFinger } from "./type-D_8QzkEn.js";
-import { RouterError, lookupObject, traverseCollection } from "./lookup-VSVPBU3J.js";
+import { RouterError, __require, lookupObject, lookupWebFinger, traverseCollection } from "./lookup-CxJLpHHf.js";
 import { configure, getConsoleSink, getLogger, reset } from "@logtape/logtape";
 import { trace } from "@opentelemetry/api";
 

package/dist/{types-Db4ukgX8.js → types-BtUjyi5y.js}

@@ -2,8 +2,8 @@
           import { Temporal } from "@js-temporal/polyfill";
           import { URLPattern } from "urlpattern-polyfill";
         
-import { getUserAgent } from "./docloader-DOmINJ1U.js";
 import { getLogger } from "@logtape/logtape";
+import { getUserAgent } from "@fedify/vocab-runtime";
 
 //#region src/nodeinfo/client.ts
 const logger = getLogger([

package/dist/{types-LjTL4QMx.cjs → types-CWgzGaqk.cjs}

@@ -3,8 +3,8 @@
           const { URLPattern } = require("urlpattern-polyfill");
         
 const require_chunk = require('./chunk-DqRYRqnO.cjs');
-const require_docloader = require('./docloader-Buh0Ah9G.cjs');
 const __logtape_logtape = require_chunk.__toESM(require("@logtape/logtape"));
+const __fedify_vocab_runtime = require_chunk.__toESM(require("@fedify/vocab-runtime"));
 
 //#region src/nodeinfo/client.ts
 const logger = (0, __logtape_logtape.getLogger)([
@@ -19,7 +19,7 @@ async function getNodeInfo(url, options = {}) {
 			const wellKnownUrl = new URL("/.well-known/nodeinfo", url);
 			const wellKnownResponse = await fetch(wellKnownUrl, { headers: {
 				Accept: "application/json",
-				"User-Agent": typeof options.userAgent === "string" ? options.userAgent : require_docloader.getUserAgent(options.userAgent)
+				"User-Agent": typeof options.userAgent === "string" ? options.userAgent : (0, __fedify_vocab_runtime.getUserAgent)(options.userAgent)
 			} });
 			if (!wellKnownResponse.ok) {
 				logger.error("Failed to fetch {url}: {status} {statusText}", {
@@ -42,7 +42,7 @@ async function getNodeInfo(url, options = {}) {
 		}
 		const response = await fetch(nodeInfoUrl, { headers: {
 			Accept: "application/json",
-			"User-Agent": typeof options.userAgent === "string" ? options.userAgent : require_docloader.getUserAgent(options.userAgent)
+			"User-Agent": typeof options.userAgent === "string" ? options.userAgent : (0, __fedify_vocab_runtime.getUserAgent)(options.userAgent)
 		} });
 		if (!response.ok) {
 			logger.error("Failed to fetch NodeInfo document from {url}: {status} {statusText}", {

package/dist/{runtime/authdocloader.test.js → utils/docloader.test.js}

@@ -3,25 +3,24 @@
       import { URLPattern } from "urlpattern-polyfill";
       globalThis.addEventListener = () => {};
     
-import { UrlError } from "../type-D_8QzkEn.js";
+import "../lookup-CxJLpHHf.js";
 import { assertEquals } from "../assert_equals-DSbWqCm3.js";
 import "../assert-MZs1qjMx.js";
 import "../assert_instance_of-DHz7EHNU.js";
-import "../lookup-VSVPBU3J.js";
-import "../actor-dO7jHa6A.js";
-import "../key-CIIkeide.js";
-import { verifyRequest } from "../http-Danw_xTY.js";
-import { getAuthenticatedDocumentLoader } from "../authdocloader-DevmXsTo.js";
-import { mockDocumentLoader, test } from "../testing-e8Kpb1uV.js";
-import "../std__assert-X-_kMxKM.js";
-import { assertRejects } from "../assert_rejects-DiIiJbZn.js";
-import "../assert_is_error-BPGph1Jx.js";
-import "../assert_not_equals-f3m3epl3.js";
-import "../assert_throws-BOO88avQ.js";
-import { rsaPrivateKey2 } from "../keys-DZ1bqhJz.js";
-import { esm_default } from "../esm-BODOj_Oi.js";
+import "../actor-CRS7Dbo1.js";
+import "../key-CcqQC_vj.js";
+import { verifyRequest } from "../http-DIsJckI7.js";
+import { getAuthenticatedDocumentLoader } from "../docloader-BvlqkI1M.js";
+import { mockDocumentLoader, test } from "../testing-BHLtJbQx.js";
+import "../std__assert-DWivtrGR.js";
+import { assertRejects } from "../assert_rejects-Ce45JcFg.js";
+import "../assert_throws-BNXdRGWP.js";
+import "../assert_not_equals-C80BG-_5.js";
+import { rsaPrivateKey2 } from "../keys-DSikT9wk.js";
+import { esm_default } from "../esm-BZMLn6gu.js";
+import { UrlError } from "@fedify/vocab-runtime";
 
-//#region src/runtime/authdocloader.test.ts
+//#region src/utils/docloader.test.ts
 test("getAuthenticatedDocumentLoader()", async (t) => {
 	esm_default.spyGlobal();
 	esm_default.get("begin:https://example.com/object", async (cl) => {

package/dist/utils/kv-cache.test.js

@@ -0,0 +1,209 @@
+
+      import { Temporal } from "@js-temporal/polyfill";
+      import { URLPattern } from "urlpattern-polyfill";
+      globalThis.addEventListener = () => {};
+    
+import "../lookup-CxJLpHHf.js";
+import { MockKvStore, kvCache } from "../kv-cache-z0lgwFi_.js";
+import { mockDocumentLoader, test } from "../testing-BHLtJbQx.js";
+import { preloadedContexts } from "@fedify/vocab-runtime";
+import { deepStrictEqual, throws } from "node:assert";
+
+//#region src/utils/kv-cache.test.ts
+test("kvCache()", async (t) => {
+	const kv = new MockKvStore();
+	await t.step("cached", async () => {
+		const loader = kvCache({
+			kv,
+			loader: mockDocumentLoader,
+			rules: [
+				["https://example.org/", Temporal.Duration.from({ days: 1 })],
+				[new URL("https://example.net/"), Temporal.Duration.from({ days: 1 })],
+				[new URLPattern("https://example.com/*"), Temporal.Duration.from({ days: 30 })]
+			],
+			prefix: ["_test", "cached"]
+		});
+		const result = await loader("https://example.com/object");
+		deepStrictEqual(result, {
+			contextUrl: null,
+			documentUrl: "https://example.com/object",
+			document: {
+				"@context": "https://www.w3.org/ns/activitystreams",
+				id: "https://example.com/object",
+				name: "Fetched object",
+				type: "Object"
+			}
+		});
+		const cache = await kv.get([
+			"_test",
+			"cached",
+			"https://example.com/object"
+		]);
+		deepStrictEqual(cache, result);
+		await kv.set([
+			"_test",
+			"cached",
+			"https://example.org/"
+		], {
+			contextUrl: null,
+			documentUrl: "https://example.org/",
+			document: { "id": "https://example.org/" }
+		});
+		const result2 = await loader("https://example.org/");
+		deepStrictEqual(result2, {
+			contextUrl: null,
+			documentUrl: "https://example.org/",
+			document: { "id": "https://example.org/" }
+		});
+		await kv.set([
+			"_test",
+			"cached",
+			"https://example.net/"
+		], {
+			contextUrl: null,
+			documentUrl: "https://example.net/",
+			document: { "id": "https://example.net/" }
+		});
+		const result3 = await loader("https://example.net/");
+		deepStrictEqual(result3, {
+			contextUrl: null,
+			documentUrl: "https://example.net/",
+			document: { "id": "https://example.net/" }
+		});
+	});
+	await t.step("not cached", async () => {
+		const loader = kvCache({
+			kv,
+			loader: mockDocumentLoader,
+			rules: [],
+			prefix: ["_test", "not cached"]
+		});
+		const result = await loader("https://example.com/object");
+		deepStrictEqual(result, {
+			contextUrl: null,
+			documentUrl: "https://example.com/object",
+			document: {
+				"@context": "https://www.w3.org/ns/activitystreams",
+				id: "https://example.com/object",
+				name: "Fetched object",
+				type: "Object"
+			}
+		});
+		const cache = await kv.get([
+			"test2",
+			"not cached",
+			"https://example.com/object"
+		]);
+		deepStrictEqual(cache, void 0);
+	});
+	await t.step("maximum cache duration", () => {
+		throws(() => kvCache({
+			kv,
+			loader: mockDocumentLoader,
+			rules: [["https://example.com/", Temporal.Duration.from({
+				days: 30,
+				seconds: 1
+			})]]
+		}), TypeError, "The maximum cache duration is 30 days");
+		throws(() => kvCache({
+			kv,
+			loader: mockDocumentLoader,
+			rules: [[new URLPattern("https://example.com/*"), Temporal.Duration.from({
+				days: 30,
+				seconds: 1
+			})]]
+		}), TypeError, "The maximum cache duration is 30 days");
+	});
+	await t.step("on kv store exception", async () => {
+		class KvStoreThrowsException {
+			get(_key) {
+				throw new Error("Failed to get key");
+			}
+			set(_key, _value, _options) {
+				throw new Error("Failed to set key");
+			}
+			delete(_key) {
+				throw new Error("Failed to delete key");
+			}
+		}
+		const loader = kvCache({
+			kv: new KvStoreThrowsException(),
+			loader: mockDocumentLoader,
+			rules: [
+				["https://example.org/", Temporal.Duration.from({ days: 1 })],
+				[new URL("https://example.net/"), Temporal.Duration.from({ days: 1 })],
+				[new URLPattern("https://example.com/*"), Temporal.Duration.from({ days: 30 })]
+			],
+			prefix: ["_test", "not cached"]
+		});
+		const result = await loader("https://example.com/object");
+		deepStrictEqual(result, {
+			contextUrl: null,
+			documentUrl: "https://example.com/object",
+			document: {
+				"@context": "https://www.w3.org/ns/activitystreams",
+				id: "https://example.com/object",
+				name: "Fetched object",
+				type: "Object"
+			}
+		});
+	});
+	await t.step("preloaded contexts bypass cache", async () => {
+		const kv$1 = new MockKvStore();
+		let loaderCalled = false;
+		const mockLoader = (url) => {
+			loaderCalled = true;
+			return Promise.resolve({
+				contextUrl: null,
+				documentUrl: url,
+				document: { "mock": "document" }
+			});
+		};
+		const loader = kvCache({
+			kv: kv$1,
+			loader: mockLoader,
+			prefix: ["_test", "preloaded"]
+		});
+		const activityStreamsUrl = "https://www.w3.org/ns/activitystreams";
+		loaderCalled = false;
+		const result = await loader(activityStreamsUrl);
+		deepStrictEqual(result, {
+			contextUrl: null,
+			documentUrl: activityStreamsUrl,
+			document: preloadedContexts[activityStreamsUrl]
+		});
+		deepStrictEqual(loaderCalled, false, "Loader should not be called for preloaded contexts");
+		const cachedValue = await kv$1.get([
+			"_test",
+			"preloaded",
+			activityStreamsUrl
+		]);
+		deepStrictEqual(cachedValue, void 0, "Preloaded contexts should not be cached in KV store");
+		const securityUrl = "https://w3id.org/security/v1";
+		loaderCalled = false;
+		const result2 = await loader(securityUrl);
+		deepStrictEqual(result2, {
+			contextUrl: null,
+			documentUrl: securityUrl,
+			document: preloadedContexts[securityUrl]
+		});
+		deepStrictEqual(loaderCalled, false, "Loader should not be called for preloaded contexts");
+		const nonPreloadedUrl = "https://example.com/not-preloaded";
+		loaderCalled = false;
+		const result3 = await loader(nonPreloadedUrl);
+		deepStrictEqual(result3, {
+			contextUrl: null,
+			documentUrl: nonPreloadedUrl,
+			document: { "mock": "document" }
+		});
+		deepStrictEqual(loaderCalled, true, "Loader should be called for non-preloaded URLs");
+		const cachedValue2 = await kv$1.get([
+			"_test",
+			"preloaded",
+			nonPreloadedUrl
+		]);
+		deepStrictEqual(cachedValue2, result3, "Non-preloaded URLs should be cached");
+	});
+});
+
+//#endregion

package/dist/utils/mod.cjs

@@ -0,0 +1,12 @@
+
+          const { Temporal } = require("@js-temporal/polyfill");
+          const { URLPattern } = require("urlpattern-polyfill");
+        
+require('../lookup-Doq5XdGY.cjs');
+require('../actor-JG822JBi.cjs');
+require('../http-CPqfuthT.cjs');
+const require_kv_cache = require('../kv-cache-gyMh96Y-.cjs');
+require('../utils-DyRU1gdZ.cjs');
+
+exports.getAuthenticatedDocumentLoader = require_kv_cache.getAuthenticatedDocumentLoader;
+exports.kvCache = require_kv_cache.kvCache;

package/dist/utils/mod.d.cts

@@ -0,0 +1,5 @@
+import "../vocab-CeDBzu-f.cjs";
+import "../http-M8k5mKc0.cjs";
+import "../kv-Bxr0Q87_.cjs";
+import { getAuthenticatedDocumentLoader, kvCache } from "../mod-VastcQsk.cjs";
+export { getAuthenticatedDocumentLoader, kvCache };

package/dist/utils/mod.d.ts

@@ -0,0 +1,7 @@
+import { Temporal } from "@js-temporal/polyfill";
+import { URLPattern } from "urlpattern-polyfill";
+import "../vocab-BCWe1Ih5.js";
+import "../http-BbO0ejuk.js";
+import "../kv-BKNZ-Tb-.js";
+import { getAuthenticatedDocumentLoader, kvCache } from "../mod-BYynOiJG.js";
+export { getAuthenticatedDocumentLoader, kvCache };

package/dist/utils/mod.js

@@ -0,0 +1,11 @@
+
+          import { Temporal } from "@js-temporal/polyfill";
+          import { URLPattern } from "urlpattern-polyfill";
+        
+import "../lookup-BE8ZMmug.js";
+import "../actor-CMgHXjhs.js";
+import "../http-BPsXiq3Y.js";
+import { getAuthenticatedDocumentLoader, kvCache } from "../kv-cache-CBOkGH5t.js";
+import "../utils-D-Va7aXC.js";
+
+export { getAuthenticatedDocumentLoader, kvCache };