@fedify/fedify 2.4.0-dev.1951 → 2.4.0-dev.1959

package/dist/testing/mod.d.mts

@@ -1943,6 +1943,33 @@ interface FederationOptions<TContextData> {
    * are prefixed with `["_fedify"]`.
    */
   kvPrefixes?: Partial<FederationKvPrefixes>;
+  /**
+   * The time-to-live for a remote actor's public key cached under
+   * {@link FederationKvPrefixes.publicKey}.  Once it expires, the next
+   * signature verification that needs the key refetches it from the remote
+   * server and caches it again.
+   *
+   * Shortening it bounds how long a revoked or rotated key stays in the cache,
+   * at the cost of more requests to remote servers; refetching an expired key
+   * fails while the peer is unavailable, so a very short value makes
+   * verification depend on the peer being reachable.
+   * @default `{ days: 30 }`
+   * @since 2.4.0
+   */
+  publicKeyTtl?: Temporal.DurationLike;
+  /**
+   * The time-to-live for a remote origin's remembered HTTP Message Signatures
+   * spec cached under {@link FederationKvPrefixes.httpMessageSignaturesSpec}.
+   * Once it expires, the next delivery to that origin relearns the spec by
+   * double-knocking and remembers it again.
+   *
+   * Shortening it makes Fedify notice a peer's spec upgrade sooner, at the
+   * cost of an extra signed request per delivery whenever the first spec tried
+   * is rejected.
+   * @default `{ days: 90 }`
+   * @since 2.4.0
+   */
+  httpMessageSignaturesSpecTtl?: Temporal.DurationLike;
   /**
    * The message queue for sending and receiving activities.  If not provided,
    * activities will not be queued and will be processed immediately.
@@ -3564,6 +3591,48 @@ declare function createOutboxContext<TContextData>(args: Partial<OutboxContext<T
   federation: Federation<TContextData>;
 }): OutboxContext<TContextData>;
 //#endregion
+//#region src/testing/kv.d.ts
+/**
+ * A {@link KvStore} decorator whose entry expiry is driven by a virtual clock
+ * instead of wall-clock time.
+ *
+ * {@link MemoryKvStore} decides expiry by comparing timestamps rather than by
+ * scheduling timers, so a test that wants to observe a TTL elapsing would
+ * otherwise have to sleep for longer than the TTL and hope the runner keeps
+ * up.  That makes such tests both slow and load-sensitive.
+ *
+ * This decorator keeps the TTLs itself and never passes them to the store it
+ * wraps, so nothing expires until {@link advance} moves the clock.  Cache
+ * hits, expiry, and repopulation therefore all become deterministic, without
+ * patching any global and without a test-only entry point in the library
+ * itself.  The clock starts at the Unix epoch and only ever moves forward.
+ */
+declare class ManualClockKvStore implements KvStore {
+  #private;
+  /**
+   * Present only when the wrapped store has its own `cas()`.  Callers such as
+   * the task deduplication planner test `kv.cas != null` to decide whether a
+   * conditional write is available, so the decorator must not advertise a
+   * capability the wrapped store lacks.
+   */
+  readonly cas?: (key: KvKey, expectedValue: unknown, newValue: unknown, options?: KvStoreSetOptions) => Promise<boolean>;
+  constructor(inner?: KvStore);
+  /**
+   * The current reading of the virtual clock.
+   */
+  get now(): Temporal.Instant;
+  /**
+   * Moves the virtual clock forward.  Any entry whose TTL has elapsed by the
+   * new time reads as missing from this point on, exactly as it would once a
+   * real `KvStore` had let it expire.
+   */
+  advance(duration: Temporal.DurationLike): void;
+  get<T = unknown>(key: KvKey): Promise<T | undefined>;
+  set(key: KvKey, value: unknown, options?: KvStoreSetOptions): Promise<void>;
+  delete(key: KvKey): Promise<void>;
+  list(prefix?: KvKey): AsyncIterable<KvStoreListEntry>;
+}
+//#endregion
 //#region src/testing/tasks.d.ts
 /** Federation options (sans `queue`) shared by the task suites. */
 declare const baseOptions: Omit<FederationOptions<void>, "queue">;
@@ -3650,4 +3719,4 @@ interface TestDefinition {
 }
 declare const testDefinitions: TestDefinition[];
 //#endregion
-export { type Envelope, MockQueue, type MockQueueOptions, baseOptions, createInboxContext, createOutboxContext, createRequestContext, envelopeSchema, makeSchema, numberSchema, stringSchema, testDefinitions };
+export { type Envelope, ManualClockKvStore, MockQueue, type MockQueueOptions, baseOptions, createInboxContext, createOutboxContext, createRequestContext, envelopeSchema, makeSchema, numberSchema, stringSchema, testDefinitions };

package/dist/testing/mod.mjs

@@ -3,5 +3,7 @@ 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-CbS35fLr.mjs";
-import { a as numberSchema, i as makeSchema, n as baseOptions, o as stringSchema, r as envelopeSchema, t as MockQueue } from "../testing-D13ymFKy.mjs";
-export { MockQueue, baseOptions, createInboxContext, createOutboxContext, createRequestContext, envelopeSchema, makeSchema, numberSchema, stringSchema, testDefinitions };
+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-hbky2gMN.mjs";
+export { ManualClockKvStore, MockQueue, baseOptions, createInboxContext, createOutboxContext, createRequestContext, envelopeSchema, makeSchema, numberSchema, stringSchema, testDefinitions };

package/dist/testing-hbky2gMN.mjs

@@ -0,0 +1,8 @@
+import "temporal-polyfill";
+import "urlpattern-polyfill";
+globalThis.addEventListener = () => {};
+import "./dist-BQvArojP.mjs";
+import "./context-CbS35fLr.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-CBlRfA-_.mjs";
 import "../std__assert-CxFT0MNt.mjs";
 import { t as assertRejects } from "../assert_rejects-wFbSPn1O.mjs";
-import { l as verifyRequest } from "../http-Cssq59HU.mjs";
+import { l as verifyRequest } from "../http-DyXZdUng.mjs";
 import { i as rsaPrivateKey2 } from "../keys-DIJNHW-Y.mjs";
-import { t as getAuthenticatedDocumentLoader } from "../docloader-DantBD_9.mjs";
+import { t as getAuthenticatedDocumentLoader } from "../docloader-4YqMWBpt.mjs";
 import { mockDocumentLoader, test } from "@fedify/fixture";
 import { 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-CoMnysg5.mjs";
+import { n as kvCache, t as MockKvStore } from "../kv-cache-BubmP7z9.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-D3gKJwUK.cjs");
+const require_kv_cache = require("../kv-cache-Btl0s7i7.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-CMUnx7rx.js";
+import { n as getAuthenticatedDocumentLoader, t as kvCache } from "../kv-cache-DjFxdXjk.js";
 export { getAuthenticatedDocumentLoader, kvCache };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fedify/fedify",
-  "version": "2.4.0-dev.1951+5c417eb8",
+  "version": "2.4.0-dev.1959+0da7be03",
   "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.1951+5c417eb8",
-    "@fedify/vocab": "2.4.0-dev.1951+5c417eb8",
-    "@fedify/vocab-runtime": "2.4.0-dev.1951+5c417eb8",
-    "@fedify/webfinger": "2.4.0-dev.1951+5c417eb8"
+    "@fedify/uri-template": "2.4.0-dev.1959+0da7be03",
+    "@fedify/vocab-runtime": "2.4.0-dev.1959+0da7be03",
+    "@fedify/webfinger": "2.4.0-dev.1959+0da7be03",
+    "@fedify/vocab": "2.4.0-dev.1959+0da7be03"
   },
   "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/vocab-tools": "^2.4.0-dev.1951+5c417eb8",
-    "@fedify/fixture": "2.0.0"
+    "@fedify/fixture": "2.0.0",
+    "@fedify/vocab-tools": "^2.4.0-dev.1959+0da7be03"
   },
   "scripts": {
     "build:self": "tsdown",