@fedify/fedify 2.4.0-dev.2093 → 2.4.0-dev.2103

package/dist/testing/mod.d.mts

@@ -2035,8 +2035,11 @@ interface PortableInboxForwardingOptions {
   /**
    * How long a delivery waits for forwarding requests made immediately, i.e.,
    * when no outbox queue is configured, before Fedify responds to it.
-   * Requests still running afterwards continue in the background.  It does
-   * not apply when forwarding is queued.  It cannot have calendar units,
+   * Requests still running afterwards continue in the background.  It also
+   * bounds verifying the HTTP Signature that identifies the gateway which
+   * forwarded the delivery, with or without an outbox queue; if the
+   * verification does not finish in time, the activity is forwarded to that
+   * gateway as well.  It cannot have calendar units,
    * i.e., weeks, months, or years, and cannot be longer than
    * 2,147,483,647 milliseconds (about 24.8 days), the longest delay timers
    * support.
@@ -2890,6 +2893,37 @@ interface Context<TContextData> {
    * @throws {RouterError} If no actor dispatcher is available.
    */
   getActorUri(identifier: string): URL;
+  /**
+   * Builds the [FEP-ef61] portable ID of an actor with the given identifier
+   * under the given DID authority.
+   *
+   * The path is the same as the one {@link Context.getActorUri} builds, but
+   * the result is an `ap+ef61:` URI whose authority is the DID, e.g.,
+   * `ap+ef61://did:key:z6Mk.../users/alice`.  Such an actor can be served
+   * through the FEP-ef61 gateway endpoint,
+   * `/.well-known/apgateway/did:key:z6Mk.../users/alice`, by the same actor
+   * 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, e.g.,
+   * `ap+ef61://did:key:z6Mk.../users/alice`.
+   *
+   * [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.  A `did:key` DID must be
+   *                  encoded in base58-btc, as FEP-ef61 requires; see
+   *                  `exportDidKey()` from `@fedify/vocab-runtime`.
+   * @returns The actor's portable ID.
+   * @throws {RouterError} If no actor 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
+   */
+  getPortableActorUri(identifier: string, authority: string): URL;
   /**
    * Builds the URI of an object with the given class and values.
    * @param cls The class of the object.
@@ -2925,7 +2959,9 @@ interface Context<TContextData> {
    *                  a path, query, or fragment.
    * @returns The object's portable ID.
    * @throws {RouterError} If no object dispatcher is available for the class.
-   * @throws {TypeError} If values are invalid or the authority is not a DID.
+   * @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
    */
   getPortableObjectUri<TObject extends Object$1>(cls: ConstructorWithTypeId<TObject>, values: Record<string, string>, authority: string): URL;
@@ -2954,7 +2990,8 @@ interface Context<TContextData> {
    *                  a path, query, or fragment.
    * @returns The inbox's portable ID.
    * @throws {RouterError} If no inbox path is registered.
-   * @throws {TypeError} If the authority is not a DID.
+   * @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
    */
   getPortableInboxUri(identifier: string, authority: string): URL;
@@ -3335,12 +3372,13 @@ 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`.  It is
-   * `undefined` for ordinary requests.
+   * `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.
    *
    * The authority comes from the request path, so it is not evidence that
-   * this server hosts objects for the DID.  An object dispatcher has to check
-   * that by itself.
+   * this server hosts objects for the DID.  An object dispatcher or the actor
+   * dispatcher has to check that by itself.
    *
    * It describes the incoming request, so it stays the same in contexts
    * derived from this one, e.g., by {@link RequestContext.getObject}.
@@ -3349,6 +3387,31 @@ interface RequestContext<TContextData> extends Context<TContextData> {
    * @since 2.4.0
    */
   readonly portableRequest?: PortableRequest;
+  /**
+   * Builds the [FEP-ef61] portable ID of an actor with the given identifier.
+   * It works the same as {@link Context.getPortableActorUri}, except that
+   * the authority can be omitted while handling a portable gateway request.
+   * In that case, the DID in {@link RequestContext.portableRequest} is used.
+   *
+   * The DID in the request comes from the request path, so the default is
+   * only a convenience for building IDs; it is not evidence that this server
+   * hosts the actor for the DID.
+   *
+   * [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.  Defaults to the DID of
+   *                  the requested portable object.
+   * @returns The actor's portable ID.
+   * @throws {RouterError} If no actor 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
+   */
+  getPortableActorUri(identifier: string, authority?: string): URL;
   /**
    * Builds the [FEP-ef61] portable ID of an object with the given class and
    * values.  It works the same as {@link Context.getPortableObjectUri}, except
@@ -3366,9 +3429,10 @@ interface RequestContext<TContextData> extends Context<TContextData> {
    *                  the requested portable object.
    * @returns The object's portable ID.
    * @throws {RouterError} If no object dispatcher is available for the class.
-   * @throws {TypeError} If values are invalid, the authority is not a DID, or
-   *                     the authority is omitted outside a portable gateway
-   *                     request.
+   * @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
    */
   getPortableObjectUri<TObject extends Object$1>(cls: ConstructorWithTypeId<TObject>, values: Record<string, string>, authority?: string): URL;
@@ -3390,8 +3454,9 @@ interface RequestContext<TContextData> extends Context<TContextData> {
    *                  the requested portable object, if any.
    * @returns The inbox's portable ID.
    * @throws {RouterError} If no inbox path is registered.
-   * @throws {TypeError} If the authority is not a DID, or the authority is
-   *                     omitted outside a portable gateway request.
+   * @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
    */
   getPortableInboxUri(identifier: string, authority?: string): URL;

package/dist/testing/mod.mjs

@@ -2,8 +2,8 @@ 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-DlZhxdFT.mjs";
+import { n as createOutboxContext, r as createRequestContext, t as createInboxContext } from "../context-CoNRxGYp.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-CO_cEvQc.mjs";
+import "../testing-BWq1dCzx.mjs";
 export { ManualClockKvStore, MockQueue, baseOptions, createInboxContext, createOutboxContext, createRequestContext, envelopeSchema, makeSchema, numberSchema, stringSchema, testDefinitions };

package/dist/{testing-CO_cEvQc.mjs → testing-BWq1dCzx.mjs}

@@ -2,7 +2,7 @@ import "temporal-polyfill";
 import "urlpattern-polyfill";
 globalThis.addEventListener = () => {};
 import "./dist-BQvArojP.mjs";
-import "./context-DlZhxdFT.mjs";
+import "./context-CoNRxGYp.mjs";
 import "./kv-DBRWVx3Q.mjs";
 import "./tasks-dbCShlCb.mjs";
 export {};

package/dist/utils/docloader.test.mjs

@@ -5,9 +5,9 @@ import { t as esm_default } from "../esm-BHXXx4Wx.mjs";
 import { t as assertEquals } from "../assert_equals-Z6IcEbWU.mjs";
 import "../std__assert-DvMDRPes.mjs";
 import { t as assertRejects } from "../assert_rejects-CTptdYck.mjs";
-import { l as verifyRequest } from "../http-B2ftY0Ha.mjs";
+import { d as verifyRequest } from "../http-BU-8fUrz.mjs";
 import { i as rsaPrivateKey2 } from "../keys-DIJNHW-Y.mjs";
-import { t as getAuthenticatedDocumentLoader } from "../docloader-DJKcsAiF.mjs";
+import { t as getAuthenticatedDocumentLoader } from "../docloader-C1hAJnWc.mjs";
 import { mockDocumentLoader, test } from "@fedify/fixture";
 import { FetchError, UrlError } from "@fedify/vocab-runtime";
 //#region src/utils/docloader.test.ts

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

@@ -1,7 +1,7 @@
 import { Temporal } from "temporal-polyfill";
 import { URLPattern } from "urlpattern-polyfill";
 globalThis.addEventListener = () => {};
-import { n as kvCache, t as MockKvStore } from "../kv-cache-D0yYukqk.mjs";
+import { n as kvCache, t as MockKvStore } from "../kv-cache-DJFoGRWQ.mjs";
 import { deepStrictEqual, throws } from "node:assert";
 import { createTestMeterProvider, mockDocumentLoader, test } from "@fedify/fixture";
 import { preloadedContexts } from "@fedify/vocab-runtime";

package/dist/utils/mod.cjs

@@ -1,5 +1,5 @@
 const { URLPattern } = require("urlpattern-polyfill");
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_kv_cache = require("../kv-cache-BSJAlP4C.cjs");
+const require_kv_cache = require("../kv-cache-Bl5EBFrU.cjs");
 exports.getAuthenticatedDocumentLoader = require_kv_cache.getAuthenticatedDocumentLoader;
 exports.kvCache = require_kv_cache.kvCache;

package/dist/utils/mod.js

@@ -1,4 +1,4 @@
 import { Temporal } from "temporal-polyfill";
 import { URLPattern } from "urlpattern-polyfill";
-import { n as getAuthenticatedDocumentLoader, t as kvCache } from "../kv-cache-DmroAz3M.js";
+import { n as getAuthenticatedDocumentLoader, t as kvCache } from "../kv-cache-CxQu_cd4.js";
 export { getAuthenticatedDocumentLoader, kvCache };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fedify/fedify",
-  "version": "2.4.0-dev.2093+e9706a54",
+  "version": "2.4.0-dev.2103+3be829c0",
   "description": "An ActivityPub server framework",
   "keywords": [
     "ActivityPub",
@@ -151,10 +151,10 @@
     "structured-field-values": "^2.0.4",
     "temporal-polyfill": "^1.0.1",
     "urlpattern-polyfill": "^10.1.0",
-    "@fedify/uri-template": "2.4.0-dev.2093+e9706a54",
-    "@fedify/vocab": "2.4.0-dev.2093+e9706a54",
-    "@fedify/webfinger": "2.4.0-dev.2093+e9706a54",
-    "@fedify/vocab-runtime": "2.4.0-dev.2093+e9706a54"
+    "@fedify/uri-template": "2.4.0-dev.2103+3be829c0",
+    "@fedify/vocab-runtime": "2.4.0-dev.2103+3be829c0",
+    "@fedify/webfinger": "2.4.0-dev.2103+3be829c0",
+    "@fedify/vocab": "2.4.0-dev.2103+3be829c0"
   },
   "devDependencies": {
     "@std/assert": "npm:@jsr/std__assert@^0.226.0",
@@ -166,8 +166,8 @@
     "tsx": "^4.21.0",
     "typescript": "^6.0.0",
     "wrangler": "^4.17.0",
-    "@fedify/fixture": "2.0.0",
-    "@fedify/vocab-tools": "^2.4.0-dev.2093+e9706a54"
+    "@fedify/vocab-tools": "^2.4.0-dev.2103+3be829c0",
+    "@fedify/fixture": "2.0.0"
   },
   "scripts": {
     "build:self": "tsdown",