@fedify/fedify 2.4.0-dev.2149 → 2.4.0-dev.2157

package/dist/sig/mod.cjs

@@ -1,7 +1,7 @@
 const { URLPattern } = require("urlpattern-polyfill");
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_http = require("../http-C_jobbLz.cjs");
-const require_portable_collection = require("../portable-collection-CWgXwOdR.cjs");
+const require_http = require("../http-BObQoB0j.cjs");
+const require_portable_collection = require("../portable-collection-B8ojoQ50.cjs");
 exports.attachSignature = require_http.attachSignature;
 exports.createProof = require_http.createProof;
 exports.createSignature = require_http.createSignature;

package/dist/sig/mod.js

@@ -1,5 +1,5 @@
 import { Temporal } from "temporal-polyfill";
 import { URLPattern } from "urlpattern-polyfill";
-import { B as fetchKeyDetailed, C as attachSignature, E as detachSignature, F as verifySignature, H as importJwk, L as exportJwk, M as signJsonLd, P as verifyJsonLd, T as createSignature, V as generateCryptoKeyPair, a as signRequest, d as createProof, dt as parseAcceptSignature, f as hasProofLike, ft as validateAcceptSignature, g as verifyPortableObjectProof, h as verifyObject, k as hasSignatureLike, lt as formatAcceptSignature, o as verifyRequest, p as signObject, s as verifyRequestDetailed, ut as fulfillAcceptSignature, y as verifyProof, z as fetchKey } from "../http-CBRurnlR.js";
-import { n as doesActorOwnKey, r as getKeyOwner, t as verifyPortableObject } from "../portable-collection-CyhFWEB-.js";
+import { A as hasSignatureLike, B as fetchKey, D as detachSignature, E as createSignature, F as verifyJsonLd, H as generateCryptoKeyPair, I as verifySignature, N as signJsonLd, R as exportJwk, U as importJwk, V as fetchKeyDetailed, _ as verifyPortableObjectProof, a as signRequest, b as verifyProof, dt as fulfillAcceptSignature, f as createProof, ft as parseAcceptSignature, g as verifyObject, m as signObject, o as verifyRequest, p as hasProofLike, pt as validateAcceptSignature, s as verifyRequestDetailed, ut as formatAcceptSignature, w as attachSignature } from "../http-Dgtt45-K.js";
+import { n as doesActorOwnKey, r as getKeyOwner, t as verifyPortableObject } from "../portable-collection-C3xEzYri.js";
 export { attachSignature, createProof, createSignature, detachSignature, doesActorOwnKey, exportJwk, fetchKey, fetchKeyDetailed, formatAcceptSignature, fulfillAcceptSignature, generateCryptoKeyPair, getKeyOwner, hasProofLike, hasSignatureLike, importJwk, parseAcceptSignature, signJsonLd, signObject, signRequest, validateAcceptSignature, verifyJsonLd, verifyObject, verifyPortableObject, verifyPortableObjectProof, verifyProof, verifyRequest, verifyRequestDetailed, verifySignature };

package/dist/sig/owner.test.mjs

@@ -6,7 +6,7 @@ import { t as assertFalse } from "../assert_false-CPdRnc3E.mjs";
 import "../std__assert-DvMDRPes.mjs";
 import { t as assert } from "../assert-D1Eafmd_.mjs";
 import { o as rsaPublicKey1, s as rsaPublicKey2 } from "../keys-DIJNHW-Y.mjs";
-import { n as getKeyOwner, t as doesActorOwnKey } from "../owner-Cn6CFYBy.mjs";
+import { n as getKeyOwner, t as doesActorOwnKey } from "../owner-D63yPo_i.mjs";
 import { Create, CryptographicKey, lookupObject } from "@fedify/vocab";
 import { createTestTracerProvider, mockDocumentLoader, test } from "@fedify/fixture";
 //#region src/sig/owner.test.ts

package/dist/sig/portable-collection.test.mjs

@@ -2,12 +2,12 @@ import "temporal-polyfill";
 import "urlpattern-polyfill";
 globalThis.addEventListener = () => {};
 import { n as ed25519PrivateKey, r as ed25519PublicKey } from "../keys-DIJNHW-Y.mjs";
-import { t as verifyPortableObject } from "../portable-collection-B3swTTja.mjs";
+import { t as verifyPortableObject } from "../portable-collection-_lZg-osX.mjs";
 import { Collection, CollectionPage, Note, OrderedCollection, Person, traverseCollection } from "@fedify/vocab";
 import { test } from "@fedify/fixture";
 import { FetchError, encodeMultibase, exportDidKey, preloadedContexts } from "@fedify/vocab-runtime";
-import serialize from "json-canon";
 import { deepStrictEqual, ok, strictEqual } from "node:assert/strict";
+import serialize from "json-canon";
 //#region src/sig/portable-collection.test.ts
 const AS = "https://www.w3.org/ns/activitystreams#";
 const context = [

package/dist/sig/portable-key.test.mjs

@@ -2,18 +2,18 @@ import { Temporal } from "temporal-polyfill";
 import "urlpattern-polyfill";
 globalThis.addEventListener = () => {};
 import { t as MemoryKvStore } from "../kv-DCHkaJ9-.mjs";
-import { i as fetchKey } from "../key-BtO7WCfP.mjs";
-import { h as verifyJsonLd, p as signJsonLd } from "../ld-YYBfDbe_.mjs";
-import { n as createProof, u as verifyProof } from "../proof-DWkXfZIU.mjs";
-import { d as verifyRequest, f as verifyRequestDetailed, l as signRequest } from "../http-BoH-e8sR.mjs";
+import { i as fetchKey } from "../key-CPM4r6tP.mjs";
+import { h as verifyJsonLd, p as signJsonLd } from "../ld-lU_ZqzsQ.mjs";
+import { d as verifyProof, r as createProof } from "../proof-C2YwD8a_.mjs";
+import { d as verifyRequest, f as verifyRequestDetailed, l as signRequest } from "../http-CGcLv8rh.mjs";
 import { a as rsaPrivateKey3, c as rsaPublicKey3, i as rsaPrivateKey2, n as ed25519PrivateKey, r as ed25519PublicKey, s as rsaPublicKey2 } from "../keys-DIJNHW-Y.mjs";
-import { n as getKeyOwner, t as doesActorOwnKey } from "../owner-Cn6CFYBy.mjs";
+import { n as getKeyOwner, t as doesActorOwnKey } from "../owner-D63yPo_i.mjs";
 import { t as KvKeyCache } from "../keycache-BInaECGj.mjs";
 import { Create, CryptographicKey, Multikey, Note, Person } from "@fedify/vocab";
 import { test } from "@fedify/fixture";
 import { FetchError, encodeMultibase, exportDidKey, exportSpki, parseIri, preloadedContexts } from "@fedify/vocab-runtime";
-import serialize from "json-canon";
 import { deepStrictEqual, ok, strictEqual } from "node:assert/strict";
+import serialize from "json-canon";
 //#region src/sig/portable-key.test.ts
 const did = await exportDidKey(ed25519PublicKey.publicKey);
 const didKeyId = `${did}#${did.slice(8)}`;

package/dist/sig/proof.test.mjs

@@ -10,10 +10,10 @@ import "../std__assert-DvMDRPes.mjs";
 import { t as assertRejects } from "../assert_rejects-CTptdYck.mjs";
 import { t as assert } from "../assert-D1Eafmd_.mjs";
 import { r as normalizeOutgoingActivityJsonLd } from "../outgoing-jsonld-4IJqPYos.mjs";
-import { i as signObject, n as createProof, o as verifyObject, r as hasProofLike, s as verifyPortableObjectProof, u as verifyProof } from "../proof-DWkXfZIU.mjs";
-import { d as verifyRequest } from "../http-BoH-e8sR.mjs";
+import { a as signObject, c as verifyPortableObjectProof, d as verifyProof, i as hasProofLike, r as createProof, s as verifyObject } from "../proof-C2YwD8a_.mjs";
+import { d as verifyRequest } from "../http-CGcLv8rh.mjs";
 import { i as rsaPrivateKey2, n as ed25519PrivateKey, r as ed25519PublicKey, s as rsaPublicKey2, t as ed25519Multikey } from "../keys-DIJNHW-Y.mjs";
-import { t as getAuthenticatedDocumentLoader } from "../docloader-C4h6PL7m.mjs";
+import { t as getAuthenticatedDocumentLoader } from "../docloader-BMqr3hji.mjs";
 import { Create, DataIntegrityProof, Document, Multikey, Note, PUBLIC_COLLECTION, Place, Translation } from "@fedify/vocab";
 import { createTestMeterProvider, mockDocumentLoader, test } from "@fedify/fixture";
 import { decodeMultibase, encodeMultibase, exportDidKey, exportMultibaseKey, formatIri, importMultibaseKey, parseIri } from "@fedify/vocab-runtime";

package/dist/{tasks-dbCShlCb.mjs → tasks-IG3pHfvZ.mjs}

@@ -1,7 +1,7 @@
 import "temporal-polyfill";
 import "urlpattern-polyfill";
 globalThis.addEventListener = () => {};
-import { t as mockDocumentLoader } from "./dist-BQvArojP.mjs";
+import { t as mockDocumentLoader } from "./dist-DJQM4u7i.mjs";
 import { t as MemoryKvStore } from "./kv-DCHkaJ9-.mjs";
 import { Note } from "@fedify/vocab";
 //#region src/testing/tasks.ts

package/dist/{temporal-CFI__wjQ.mjs → temporal-q6FSekcN.mjs}

@@ -1,7 +1,7 @@
 import { Temporal } from "temporal-polyfill";
 import "urlpattern-polyfill";
 globalThis.addEventListener = () => {};
-import { c as getNormalizationContextLoader } from "./ld-YYBfDbe_.mjs";
+import { c as getNormalizationContextLoader } from "./ld-lU_ZqzsQ.mjs";
 import jsonld from "@fedify/vocab-runtime/jsonld";
 //#region src/federation/temporal.ts
 function isPlainObject(value) {

package/dist/testing/context.test.mjs

@@ -1,7 +1,7 @@
 import "temporal-polyfill";
 import "urlpattern-polyfill";
 globalThis.addEventListener = () => {};
-import { n as test } from "../dist-BQvArojP.mjs";
+import { n as test } from "../dist-DJQM4u7i.mjs";
 import { strictEqual } from "node:assert/strict";
 //#region src/testing/context.test.ts
 test("ignored nested test steps return false", async (t) => {

package/dist/testing/kv.test.mjs

@@ -1,12 +1,12 @@
 import { Temporal } from "temporal-polyfill";
 import "urlpattern-polyfill";
 globalThis.addEventListener = () => {};
-import { n as test } from "../dist-BQvArojP.mjs";
+import { n as test } from "../dist-DJQM4u7i.mjs";
 import { t as MemoryKvStore } from "../kv-DCHkaJ9-.mjs";
 import { t as ManualClockKvStore } from "../kv-DBRWVx3Q.mjs";
-import { n as baseOptions, o as stringSchema, t as MockQueue } from "../tasks-dbCShlCb.mjs";
+import { n as baseOptions, o as stringSchema, t as MockQueue } from "../tasks-IG3pHfvZ.mjs";
 import { t as assertEquals } from "../assert_equals-Z6IcEbWU.mjs";
-import { o as createFederation } from "../middleware-CBGR92fz.mjs";
+import { o as createFederation } from "../middleware-xdukzV3x.mjs";
 //#region src/testing/kv.test.ts
 test("ManualClockKvStore keeps an entry at its exact expiration instant", async () => {
 	const kv = new ManualClockKvStore();

package/dist/testing/mod.d.mts

@@ -694,6 +694,28 @@ type ObjectAuthorizePredicate<TContextData, TParam extends string> = (context: R
  * @since 1.8.0
  */
 type CustomCollectionDispatcher<TItem, TParam extends string, TContext extends Context<TContextData>, TContextData> = (context: TContext, values: Record<TParam, string>, cursor: string | null) => PageItems<TItem> | null | Promise<PageItems<TItem> | null>;
+/**
+ * A callback that maps a custom collection to the identifier of the actor
+ * that owns it, so that the collection can be served as an [FEP-ef61]
+ * portable collection through the gateway endpoint, e.g.,
+ * `GET /.well-known/apgateway/did:key:z6Mk.../users/alice/bookmarks`.
+ *
+ * Fedify serves such a request only if the returned actor is a portable actor
+ * whose ID is under the requested DID.  The owner has to come from
+ * the application's data, not from the request, since the DID in the request
+ * path is not evidence that this server hosts collections for it.
+ *
+ * [FEP-ef61]: https://w3id.org/fep/ef61
+ *
+ * @template TContextData The context data to pass to the {@link Context}.
+ * @template TParam The parameter names of the requested URL.
+ * @param context The context.
+ * @param values The parameters of the requested URL.
+ * @returns The internal identifier of the actor that owns the collection, or
+ *          `null` if the collection is not a portable collection.
+ * @since 2.4.0
+ */
+type PortableCollectionOwnerMapper<TContextData, TParam extends string> = (context: Context<TContextData>, values: Record<TParam, string>) => string | null | Promise<string | null>;
 /**
  * A callback that counts the number of items in a custom collection.
  *
@@ -2786,6 +2808,21 @@ interface CustomCollectionCallbackSetters<TParam extends string, TContext extend
    * @since 0.7.0
    */
   authorize(predicate: ObjectAuthorizePredicate<TContextData, string>): CustomCollectionCallbackSetters<TParam, TContext, TContextData>;
+  /**
+   * Maps the custom collection to the actor that owns it, so that it is also
+   * served as an [FEP-ef61] portable collection through the gateway endpoint,
+   * e.g., `GET /.well-known/apgateway/did:key:z6Mk.../users/alice/bookmarks`,
+   * if the owner is a portable actor under the requested DID.  Without it,
+   * the custom collection is not served through the gateway endpoint.
+   *
+   * [FEP-ef61]: https://w3id.org/fep/ef61
+   * @param mapper A callback that returns the identifier of the actor that
+   *               owns the collection, or `null` if the collection is not
+   *               portable.
+   * @returns The setters object so that settings can be chained.
+   * @since 2.4.0
+   */
+  mapPortableOwner(mapper: PortableCollectionOwnerMapper<TContextData, TParam>): CustomCollectionCallbackSetters<TParam, TContext, TContextData>;
 }
 /**
  * Represents an object with a type ID, which is either a constructor or an
@@ -3040,6 +3077,35 @@ interface Context<TContextData> {
    * @throws {RouterError} If no outbox dispatcher is available.
    */
   getOutboxUri(identifier: string): URL;
+  /**
+   * Builds the [FEP-ef61] portable ID of an actor's outbox with the given
+   * identifier under the given DID authority.
+   *
+   * The path is the same as the one {@link Context.getOutboxUri} builds, but
+   * the result is an `ap+ef61:` URI whose authority is the DID, e.g.,
+   * `ap+ef61://did:key:z6Mk.../users/alice/outbox`.  If a portable actor has
+   * it as its `outbox` and its ID is under the same DID, the collection is
+   * served through the FEP-ef61 gateway endpoint, e.g.,
+   * `/.well-known/apgateway/did:key:z6Mk.../users/alice/outbox`, by the same
+   * collection dispatcher.
+   *
+   * The returned `URL` keeps the DID authority percent-encoded, because
+   * the `URL` class cannot represent the canonical form.  Use `formatIri()`
+   * from `@fedify/vocab-runtime` to get the canonical string.
+   *
+   * [FEP-ef61]: https://w3id.org/fep/ef61
+   *
+   * @param identifier The actor's identifier.
+   * @param authority The DID that controls the actor, e.g.,
+   *                  `did:key:z6Mk...`.  It must be a bare DID, without
+   *                  a path, query, or fragment.
+   * @returns The outbox's portable ID.
+   * @throws {RouterError} If no outbox dispatcher is available.
+   * @throws {TypeError} If the authority is not a DID, or it is a `did:key`
+   *                     DID that is not encoded in base58-btc.
+   * @since 2.4.0
+   */
+  getPortableOutboxUri(identifier: string, authority: string): URL;
   /**
    * Builds the URI of an actor's media upload endpoint with the given
    * identifier.  This is the endpoint advertised under `endpoints.uploadMedia`
@@ -3071,6 +3137,35 @@ interface Context<TContextData> {
    * @throws {RouterError} If no following collection is available.
    */
   getFollowingUri(identifier: string): URL;
+  /**
+   * Builds the [FEP-ef61] portable ID of an actor's following collection with the given
+   * identifier under the given DID authority.
+   *
+   * The path is the same as the one {@link Context.getFollowingUri} builds, but
+   * the result is an `ap+ef61:` URI whose authority is the DID, e.g.,
+   * `ap+ef61://did:key:z6Mk.../users/alice/following`.  If a portable actor has
+   * it as its `following` and its ID is under the same DID, the collection is
+   * served through the FEP-ef61 gateway endpoint, e.g.,
+   * `/.well-known/apgateway/did:key:z6Mk.../users/alice/following`, by the same
+   * collection dispatcher.
+   *
+   * The returned `URL` keeps the DID authority percent-encoded, because
+   * the `URL` class cannot represent the canonical form.  Use `formatIri()`
+   * from `@fedify/vocab-runtime` to get the canonical string.
+   *
+   * [FEP-ef61]: https://w3id.org/fep/ef61
+   *
+   * @param identifier The actor's identifier.
+   * @param authority The DID that controls the actor, e.g.,
+   *                  `did:key:z6Mk...`.  It must be a bare DID, without
+   *                  a path, query, or fragment.
+   * @returns The following collection's portable ID.
+   * @throws {RouterError} If no following collection is available.
+   * @throws {TypeError} If the authority is not a DID, or it is a `did:key`
+   *                     DID that is not encoded in base58-btc.
+   * @since 2.4.0
+   */
+  getPortableFollowingUri(identifier: string, authority: string): URL;
   /**
    * Builds the URI of an actor's followers collection with the given
    * identifier.
@@ -3079,6 +3174,35 @@ interface Context<TContextData> {
    * @throws {RouterError} If no followers collection is available.
    */
   getFollowersUri(identifier: string): URL;
+  /**
+   * Builds the [FEP-ef61] portable ID of an actor's followers collection with the given
+   * identifier under the given DID authority.
+   *
+   * The path is the same as the one {@link Context.getFollowersUri} builds, but
+   * the result is an `ap+ef61:` URI whose authority is the DID, e.g.,
+   * `ap+ef61://did:key:z6Mk.../users/alice/followers`.  If a portable actor has
+   * it as its `followers` and its ID is under the same DID, the collection is
+   * served through the FEP-ef61 gateway endpoint, e.g.,
+   * `/.well-known/apgateway/did:key:z6Mk.../users/alice/followers`, by the same
+   * collection dispatcher.
+   *
+   * The returned `URL` keeps the DID authority percent-encoded, because
+   * the `URL` class cannot represent the canonical form.  Use `formatIri()`
+   * from `@fedify/vocab-runtime` to get the canonical string.
+   *
+   * [FEP-ef61]: https://w3id.org/fep/ef61
+   *
+   * @param identifier The actor's identifier.
+   * @param authority The DID that controls the actor, e.g.,
+   *                  `did:key:z6Mk...`.  It must be a bare DID, without
+   *                  a path, query, or fragment.
+   * @returns The followers collection's portable ID.
+   * @throws {RouterError} If no followers collection is available.
+   * @throws {TypeError} If the authority is not a DID, or it is a `did:key`
+   *                     DID that is not encoded in base58-btc.
+   * @since 2.4.0
+   */
+  getPortableFollowersUri(identifier: string, authority: string): URL;
   /**
    * Builds the URI of an actor's liked collection with the given identifier.
    * @param identifier The actor's identifier.
@@ -3087,6 +3211,35 @@ interface Context<TContextData> {
    * @since 0.11.0
    */
   getLikedUri(identifier: string): URL;
+  /**
+   * Builds the [FEP-ef61] portable ID of an actor's liked collection with the given
+   * identifier under the given DID authority.
+   *
+   * The path is the same as the one {@link Context.getLikedUri} builds, but
+   * the result is an `ap+ef61:` URI whose authority is the DID, e.g.,
+   * `ap+ef61://did:key:z6Mk.../users/alice/liked`.  If a portable actor has
+   * it as its `liked` and its ID is under the same DID, the collection is
+   * served through the FEP-ef61 gateway endpoint, e.g.,
+   * `/.well-known/apgateway/did:key:z6Mk.../users/alice/liked`, by the same
+   * collection dispatcher.
+   *
+   * The returned `URL` keeps the DID authority percent-encoded, because
+   * the `URL` class cannot represent the canonical form.  Use `formatIri()`
+   * from `@fedify/vocab-runtime` to get the canonical string.
+   *
+   * [FEP-ef61]: https://w3id.org/fep/ef61
+   *
+   * @param identifier The actor's identifier.
+   * @param authority The DID that controls the actor, e.g.,
+   *                  `did:key:z6Mk...`.  It must be a bare DID, without
+   *                  a path, query, or fragment.
+   * @returns The liked collection's portable ID.
+   * @throws {RouterError} If no liked collection is available.
+   * @throws {TypeError} If the authority is not a DID, or it is a `did:key`
+   *                     DID that is not encoded in base58-btc.
+   * @since 2.4.0
+   */
+  getPortableLikedUri(identifier: string, authority: string): URL;
   /**
    * Builds the URI of an actor's featured collection with the given identifier.
    * @param identifier The actor's identifier.
@@ -3095,6 +3248,35 @@ interface Context<TContextData> {
    * @since 0.11.0
    */
   getFeaturedUri(identifier: string): URL;
+  /**
+   * Builds the [FEP-ef61] portable ID of an actor's featured collection with the given
+   * identifier under the given DID authority.
+   *
+   * The path is the same as the one {@link Context.getFeaturedUri} builds, but
+   * the result is an `ap+ef61:` URI whose authority is the DID, e.g.,
+   * `ap+ef61://did:key:z6Mk.../users/alice/featured`.  If a portable actor has
+   * it as its `featured` and its ID is under the same DID, the collection is
+   * served through the FEP-ef61 gateway endpoint, e.g.,
+   * `/.well-known/apgateway/did:key:z6Mk.../users/alice/featured`, by the same
+   * collection dispatcher.
+   *
+   * The returned `URL` keeps the DID authority percent-encoded, because
+   * the `URL` class cannot represent the canonical form.  Use `formatIri()`
+   * from `@fedify/vocab-runtime` to get the canonical string.
+   *
+   * [FEP-ef61]: https://w3id.org/fep/ef61
+   *
+   * @param identifier The actor's identifier.
+   * @param authority The DID that controls the actor, e.g.,
+   *                  `did:key:z6Mk...`.  It must be a bare DID, without
+   *                  a path, query, or fragment.
+   * @returns The featured collection's portable ID.
+   * @throws {RouterError} If no featured collection is available.
+   * @throws {TypeError} If the authority is not a DID, or it is a `did:key`
+   *                     DID that is not encoded in base58-btc.
+   * @since 2.4.0
+   */
+  getPortableFeaturedUri(identifier: string, authority: string): URL;
   /**
    * Builds the URI of an actor's featured tags collection with the given
    * identifier.
@@ -3104,6 +3286,35 @@ interface Context<TContextData> {
    * @since 0.11.0
    */
   getFeaturedTagsUri(identifier: string): URL;
+  /**
+   * Builds the [FEP-ef61] portable ID of an actor's featured tags collection with the given
+   * identifier under the given DID authority.
+   *
+   * The path is the same as the one {@link Context.getFeaturedTagsUri} builds, but
+   * the result is an `ap+ef61:` URI whose authority is the DID, e.g.,
+   * `ap+ef61://did:key:z6Mk.../users/alice/tags`.  If a portable actor has
+   * it as its `featuredTags` and its ID is under the same DID, the collection is
+   * served through the FEP-ef61 gateway endpoint, e.g.,
+   * `/.well-known/apgateway/did:key:z6Mk.../users/alice/tags`, by the same
+   * collection dispatcher.
+   *
+   * The returned `URL` keeps the DID authority percent-encoded, because
+   * the `URL` class cannot represent the canonical form.  Use `formatIri()`
+   * from `@fedify/vocab-runtime` to get the canonical string.
+   *
+   * [FEP-ef61]: https://w3id.org/fep/ef61
+   *
+   * @param identifier The actor's identifier.
+   * @param authority The DID that controls the actor, e.g.,
+   *                  `did:key:z6Mk...`.  It must be a bare DID, without
+   *                  a path, query, or fragment.
+   * @returns The featured tags collection's portable ID.
+   * @throws {RouterError} If no featured tags collection is available.
+   * @throws {TypeError} If the authority is not a DID, or it is a `did:key`
+   *                     DID that is not encoded in base58-btc.
+   * @since 2.4.0
+   */
+  getPortableFeaturedTagsUri(identifier: string, authority: string): URL;
   /**
    * Determines the type of the URI and extracts the associated data.
    * @param uri The URI to parse.
@@ -3363,6 +3574,38 @@ interface Context<TContextData> {
    * @since 1.8.0
    */
   getCollectionUri<TParam extends Record<string, string>>(name: string | symbol, values: TParam): URL;
+  /**
+   * Builds the [FEP-ef61] portable ID of a custom collection with the given
+   * name and values under the given DID authority.
+   *
+   * The path is the same as the one {@link Context.getCollectionUri} builds,
+   * but the result is an `ap+ef61:` URI whose authority is the DID, e.g.,
+   * `ap+ef61://did:key:z6Mk.../users/alice/bookmarks`.  If the collection
+   * dispatcher maps the collection to a portable actor under the same DID
+   * with `CustomCollectionCallbackSetters.mapPortableOwner()`, the
+   * collection is served through the FEP-ef61 gateway endpoint, e.g.,
+   * `/.well-known/apgateway/did:key:z6Mk.../users/alice/bookmarks`.
+   *
+   * The returned `URL` keeps the DID authority percent-encoded, because
+   * the `URL` class cannot represent the canonical form.  Use `formatIri()`
+   * from `@fedify/vocab-runtime` to get the canonical string.
+   *
+   * [FEP-ef61]: https://w3id.org/fep/ef61
+   *
+   * @param name The name of the collection, which can be a string or a symbol.
+   * @param values The values of the URI parameters.
+   * @param authority The DID that controls the collection, e.g.,
+   *                  `did:key:z6Mk...`.  It must be a bare DID, without
+   *                  a path, query, or fragment.
+   * @returns The collection's portable ID.
+   * @throws {RouterError} If no collection dispatcher is available for
+   *                       the name.
+   * @throws {TypeError} If values are invalid, or the authority is not a DID
+   *                     or is a `did:key` DID that is not encoded in
+   *                     base58-btc.
+   * @since 2.4.0
+   */
+  getPortableCollectionUri<TParam extends Record<string, string>>(name: string | symbol, values: TParam, authority: string): URL;
 }
 /**
  * Information about an [FEP-ef61] portable object requested through
@@ -3379,7 +3622,7 @@ interface PortableRequest {
    */
   readonly authority: string;
   /**
-   * The ID of the requested portable object, e.g.,
+   * The ID of the requested portable object or collection, e.g.,
    * `ap+ef61://did:key:z6Mk.../notes/123`, without a query.  Like other
    * portable IDs, the `URL` keeps the DID authority percent-encoded; use
    * `formatIri()` from `@fedify/vocab-runtime` to get the canonical string.
@@ -3433,12 +3676,14 @@ interface RequestContext<TContextData> extends Context<TContextData> {
    * Information about the [FEP-ef61] portable object requested through
    * the gateway endpoint, e.g.,
    * `GET /.well-known/apgateway/did:key:z6Mk.../notes/123`, which is served
-   * by an object dispatcher or the actor dispatcher.  It is `undefined` for
-   * ordinary requests.
+   * by an object dispatcher, the actor dispatcher, or a collection
+   * dispatcher.  It is `undefined` for ordinary requests.
    *
    * The authority comes from the request path, so it is not evidence that
    * this server hosts objects for the DID.  An object dispatcher or the actor
-   * dispatcher has to check that by itself.
+   * dispatcher has to check that by itself.  A portable collection is served
+   * only if its owner, which the actor dispatcher looks up without this
+   * property, is a portable actor under the DID.
    *
    * It describes the incoming request, so it stays the same in contexts
    * derived from this one, e.g., by {@link RequestContext.getObject}.
@@ -3520,6 +3765,150 @@ interface RequestContext<TContextData> extends Context<TContextData> {
    * @since 2.4.0
    */
   getPortableInboxUri(identifier: string, authority?: string): URL;
+  /**
+   * Builds the [FEP-ef61] portable ID of an actor's outbox with the given
+   * identifier.  It works the same as {@link Context.getPortableOutboxUri}, except that
+   * the authority can be omitted while handling a portable gateway request.
+   * In that case, the DID in {@link RequestContext.portableRequest} is used.
+   *
+   * [FEP-ef61]: https://w3id.org/fep/ef61
+   *
+   * @param identifier The actor's identifier.
+   * @param authority The DID that controls the actor, e.g.,
+   *                  `did:key:z6Mk...`.  Defaults to the DID of the requested
+   *                  portable object or collection.
+   * @returns The outbox's portable ID.
+   * @throws {RouterError} If no outbox dispatcher is available.
+   * @throws {TypeError} If the authority is not a DID, it is a `did:key` DID
+   *                     that is not encoded in base58-btc, or the authority
+   *                     is omitted outside a portable gateway request.
+   * @since 2.4.0
+   */
+  getPortableOutboxUri(identifier: string, authority?: string): URL;
+  /**
+   * Builds the [FEP-ef61] portable ID of an actor's following collection with the given
+   * identifier.  It works the same as {@link Context.getPortableFollowingUri}, except that
+   * the authority can be omitted while handling a portable gateway request.
+   * In that case, the DID in {@link RequestContext.portableRequest} is used.
+   *
+   * [FEP-ef61]: https://w3id.org/fep/ef61
+   *
+   * @param identifier The actor's identifier.
+   * @param authority The DID that controls the actor, e.g.,
+   *                  `did:key:z6Mk...`.  Defaults to the DID of the requested
+   *                  portable object or collection.
+   * @returns The following collection's portable ID.
+   * @throws {RouterError} If no following collection is available.
+   * @throws {TypeError} If the authority is not a DID, it is a `did:key` DID
+   *                     that is not encoded in base58-btc, or the authority
+   *                     is omitted outside a portable gateway request.
+   * @since 2.4.0
+   */
+  getPortableFollowingUri(identifier: string, authority?: string): URL;
+  /**
+   * Builds the [FEP-ef61] portable ID of an actor's followers collection with the given
+   * identifier.  It works the same as {@link Context.getPortableFollowersUri}, except that
+   * the authority can be omitted while handling a portable gateway request.
+   * In that case, the DID in {@link RequestContext.portableRequest} is used.
+   *
+   * [FEP-ef61]: https://w3id.org/fep/ef61
+   *
+   * @param identifier The actor's identifier.
+   * @param authority The DID that controls the actor, e.g.,
+   *                  `did:key:z6Mk...`.  Defaults to the DID of the requested
+   *                  portable object or collection.
+   * @returns The followers collection's portable ID.
+   * @throws {RouterError} If no followers collection is available.
+   * @throws {TypeError} If the authority is not a DID, it is a `did:key` DID
+   *                     that is not encoded in base58-btc, or the authority
+   *                     is omitted outside a portable gateway request.
+   * @since 2.4.0
+   */
+  getPortableFollowersUri(identifier: string, authority?: string): URL;
+  /**
+   * Builds the [FEP-ef61] portable ID of an actor's liked collection with the given
+   * identifier.  It works the same as {@link Context.getPortableLikedUri}, except that
+   * the authority can be omitted while handling a portable gateway request.
+   * In that case, the DID in {@link RequestContext.portableRequest} is used.
+   *
+   * [FEP-ef61]: https://w3id.org/fep/ef61
+   *
+   * @param identifier The actor's identifier.
+   * @param authority The DID that controls the actor, e.g.,
+   *                  `did:key:z6Mk...`.  Defaults to the DID of the requested
+   *                  portable object or collection.
+   * @returns The liked collection's portable ID.
+   * @throws {RouterError} If no liked collection is available.
+   * @throws {TypeError} If the authority is not a DID, it is a `did:key` DID
+   *                     that is not encoded in base58-btc, or the authority
+   *                     is omitted outside a portable gateway request.
+   * @since 2.4.0
+   */
+  getPortableLikedUri(identifier: string, authority?: string): URL;
+  /**
+   * Builds the [FEP-ef61] portable ID of an actor's featured collection with the given
+   * identifier.  It works the same as {@link Context.getPortableFeaturedUri}, except that
+   * the authority can be omitted while handling a portable gateway request.
+   * In that case, the DID in {@link RequestContext.portableRequest} is used.
+   *
+   * [FEP-ef61]: https://w3id.org/fep/ef61
+   *
+   * @param identifier The actor's identifier.
+   * @param authority The DID that controls the actor, e.g.,
+   *                  `did:key:z6Mk...`.  Defaults to the DID of the requested
+   *                  portable object or collection.
+   * @returns The featured collection's portable ID.
+   * @throws {RouterError} If no featured collection is available.
+   * @throws {TypeError} If the authority is not a DID, it is a `did:key` DID
+   *                     that is not encoded in base58-btc, or the authority
+   *                     is omitted outside a portable gateway request.
+   * @since 2.4.0
+   */
+  getPortableFeaturedUri(identifier: string, authority?: string): URL;
+  /**
+   * Builds the [FEP-ef61] portable ID of an actor's featured tags collection with the given
+   * identifier.  It works the same as {@link Context.getPortableFeaturedTagsUri}, except that
+   * the authority can be omitted while handling a portable gateway request.
+   * In that case, the DID in {@link RequestContext.portableRequest} is used.
+   *
+   * [FEP-ef61]: https://w3id.org/fep/ef61
+   *
+   * @param identifier The actor's identifier.
+   * @param authority The DID that controls the actor, e.g.,
+   *                  `did:key:z6Mk...`.  Defaults to the DID of the requested
+   *                  portable object or collection.
+   * @returns The featured tags collection's portable ID.
+   * @throws {RouterError} If no featured tags collection is available.
+   * @throws {TypeError} If the authority is not a DID, it is a `did:key` DID
+   *                     that is not encoded in base58-btc, or the authority
+   *                     is omitted outside a portable gateway request.
+   * @since 2.4.0
+   */
+  getPortableFeaturedTagsUri(identifier: string, authority?: string): URL;
+  /**
+   * Builds the [FEP-ef61] portable ID of a custom collection with the given
+   * name and values.  It works the same as
+   * {@link Context.getPortableCollectionUri}, except that the authority can
+   * be omitted while handling a portable gateway request.  In that case,
+   * the DID in {@link RequestContext.portableRequest} is used.
+   *
+   * [FEP-ef61]: https://w3id.org/fep/ef61
+   *
+   * @param name The name of the collection, which can be a string or a symbol.
+   * @param values The values of the URI parameters.
+   * @param authority The DID that controls the collection, e.g.,
+   *                  `did:key:z6Mk...`.  Defaults to the DID of the requested
+   *                  portable object or collection.
+   * @returns The collection's portable ID.
+   * @throws {RouterError} If no collection dispatcher is available for
+   *                       the name.
+   * @throws {TypeError} If values are invalid, the authority is not a DID,
+   *                     it is a `did:key` DID that is not encoded in
+   *                     base58-btc, or the authority is omitted outside
+   *                     a portable gateway request.
+   * @since 2.4.0
+   */
+  getPortableCollectionUri<TParam extends Record<string, string>>(name: string | symbol, values: TParam, authority?: string): URL;
   /**
    * Creates a new context with the same properties as this one,
    * but with the given data.

package/dist/testing/mod.mjs

@@ -1,9 +1,9 @@
 import "temporal-polyfill";
 import "urlpattern-polyfill";
 globalThis.addEventListener = () => {};
-import { r as testDefinitions } from "../dist-BQvArojP.mjs";
-import { n as createOutboxContext, r as createRequestContext, t as createInboxContext } from "../context-DfSVPcJ8.mjs";
+import { r as testDefinitions } from "../dist-DJQM4u7i.mjs";
+import { n as createOutboxContext, r as createRequestContext, t as createInboxContext } from "../context-B2rlkkyJ.mjs";
 import { t as ManualClockKvStore } from "../kv-DBRWVx3Q.mjs";
-import { a as numberSchema, i as makeSchema, n as baseOptions, o as stringSchema, r as envelopeSchema, t as MockQueue } from "../tasks-dbCShlCb.mjs";
-import "../testing-otQhu4aD.mjs";
+import { a as numberSchema, i as makeSchema, n as baseOptions, o as stringSchema, r as envelopeSchema, t as MockQueue } from "../tasks-IG3pHfvZ.mjs";
+import "../testing-C1itIjqW.mjs";
 export { ManualClockKvStore, MockQueue, baseOptions, createInboxContext, createOutboxContext, createRequestContext, envelopeSchema, makeSchema, numberSchema, stringSchema, testDefinitions };

package/dist/{testing-otQhu4aD.mjs → testing-C1itIjqW.mjs}

@@ -1,8 +1,8 @@
 import "temporal-polyfill";
 import "urlpattern-polyfill";
 globalThis.addEventListener = () => {};
-import "./dist-BQvArojP.mjs";
-import "./context-DfSVPcJ8.mjs";
+import "./dist-DJQM4u7i.mjs";
+import "./context-B2rlkkyJ.mjs";
 import "./kv-DBRWVx3Q.mjs";
-import "./tasks-dbCShlCb.mjs";
+import "./tasks-IG3pHfvZ.mjs";
 export {};