@fedify/fedify 2.5.0-dev.2609 → 2.5.0-dev.2618

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 { p as verifyRequest } from "../http-TgeyuTDM.mjs";
+import { p as verifyRequest } from "../http-NYqvoigN.mjs";
 import { i as rsaPrivateKey2 } from "../keys-DIJNHW-Y.mjs";
-import { n as getAuthenticatedDocumentLoader, t as createAuthenticatedDocumentLoader } from "../docloader-B9RO5nh9.mjs";
+import { n as getAuthenticatedDocumentLoader, t as createAuthenticatedDocumentLoader } from "../docloader-kYMkiXaB.mjs";
 import { configure, reset } from "@logtape/logtape";
 import { FetchError, UrlError } from "@fedify/vocab-runtime";
 import { mockDocumentLoader, test } from "@fedify/fixture";

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-CTA2i08a.mjs";
+import { n as kvCache, t as MockKvStore } from "../kv-cache-BdFnnrOU.mjs";
 import { preloadedContexts } from "@fedify/vocab-runtime";
 import { deepStrictEqual, throws } from "node:assert";
 import { createTestMeterProvider, mockDocumentLoader, test } from "@fedify/fixture";

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-B0o18_Ni.cjs");
+const require_kv_cache = require("../kv-cache-CcGUsFoZ.cjs");
 exports.getAuthenticatedDocumentLoader = require_kv_cache.getAuthenticatedDocumentLoader;
 exports.kvCache = require_kv_cache.kvCache;

package/dist/utils/mod.d.ts

@@ -1,3 +1,3 @@
 /// <reference lib="esnext.temporal" />
-import { n as getAuthenticatedDocumentLoader, t as kvCache } from "../mod-B7j30IQf.js";
+import { n as getAuthenticatedDocumentLoader, t as kvCache } from "../mod-CQC9xlLZ.js";
 export { getAuthenticatedDocumentLoader, 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-CMgOYiLU.js";
+import { n as getAuthenticatedDocumentLoader, t as kvCache } from "../kv-cache-1BO1Deou.js";
 export { getAuthenticatedDocumentLoader, kvCache };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fedify/fedify",
-  "version": "2.5.0-dev.2609+017171aa",
+  "version": "2.5.0-dev.2618+6a7cb6bb",
   "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.5.0-dev.2609+017171aa",
-    "@fedify/vocab": "2.5.0-dev.2609+017171aa",
-    "@fedify/vocab-runtime": "2.5.0-dev.2609+017171aa",
-    "@fedify/webfinger": "2.5.0-dev.2609+017171aa"
+    "@fedify/uri-template": "2.5.0-dev.2618+6a7cb6bb",
+    "@fedify/vocab": "2.5.0-dev.2618+6a7cb6bb",
+    "@fedify/webfinger": "2.5.0-dev.2618+6a7cb6bb",
+    "@fedify/vocab-runtime": "2.5.0-dev.2618+6a7cb6bb"
   },
   "devDependencies": {
     "@std/assert": "npm:@jsr/std__assert@^0.226.0",
@@ -165,8 +165,8 @@
     "tsx": "^4.21.0",
     "typescript": "^6.0.3",
     "wrangler": "^4.17.0",
-    "@fedify/fixture": "2.0.0",
-    "@fedify/vocab-tools": "^2.5.0-dev.2609+017171aa"
+    "@fedify/vocab-tools": "^2.5.0-dev.2618+6a7cb6bb",
+    "@fedify/fixture": "2.0.0"
   },
   "scripts": {
     "build:self": "tsdown",

package/skills/fedify/SKILL.md

@@ -244,7 +244,66 @@ deliveries have no retry.
 > those must be distinct activities.  Use a fresh UUID or counter in the
 > fragment.
 
-See <https://fedify.dev/manual/send.md>.
+### Observing outbound delivery
+
+Register callbacks with `federation.setOutboundObservers()` or the builder's
+matching method.  Registration replaces the whole set; `{}` clears it.  Active
+sends keep the callbacks selected when they began.  Observers use the existing
+context and work without OpenTelemetry.
+
+Choose callbacks by the question you need to answer:
+
+| Callback         | Reports                                                                    |
+| ---------------- | -------------------------------------------------------------------------- |
+| `onBroadcast`    | One send or forward invocation, including preparation and its result.      |
+| `onDelivery`     | Each destination's plan, handoff, or preparation failure.                  |
+| `onAttempt`      | The outcome of one concrete send, including each retry or gateway attempt. |
+| `onHttpExchange` | Each actual HTTP request and its response or fetch error.                  |
+| `onWorker`       | The local result and scheduling actions of a fanout or outbox worker.      |
+
+`onBroadcast` and `onDelivery` also cover automatic portable replication.
+Broadcasts have a `broadcastId`; destinations have a `deliveryId`.  An
+`onDelivery` event can refer to an unknown broadcast when it comes from legacy
+fanout work.  These IDs group reports; they do not prove remote receipt.
+The `event.activity` reference is a snapshot of known `id` and `type` IRI
+strings; it may be empty on `started` and can gain facts later.
+
+For broadcasts, narrow `event.stage` before reading `event.result.type`.
+For deliveries, narrow `event.stage` and, for handoffs, `event.result.type`.
+Attempt reports have a fresh `attemptId` and an `outcome`; their
+`httpExchangeCount` counts actual fetches, including redirects and signature
+challenges.  A failure before the first fetch has a count of zero.  Worker
+reports distinguish normal local completion from an escaping error.  Their
+`actions` record enqueues, retries, deferrals, direct handoffs, abandonment,
+and failed drops.  A completed worker does not imply remote success or queue
+acknowledgment.
+
+Header capture is off by default.  Set `requestHeaders` or `responseHeaders`
+with an allowlist and byte limit to add redacted header snapshots to exchange
+reports.  `responseBodyCapture` separately invokes `onBody` with a bounded
+stream and deadline; read it incrementally and honor its cancellation signal.
+Use `senderPayload: true` only when the attempt report needs a privacy-filtered
+projection of the outgoing activity.  These options do not change the bytes
+sent or signed.  Treat all captured evidence as sensitive application data.
+
+Callbacks are awaited, and callback or logging errors do not replace delivery
+results.  A callback that never settles can still delay the send.  If you
+record events in the background, handle rejection, shutdown, and persistence
+in the application.
+
+Use the `dispatchId` send or forward option to carry an application correlation
+ID through queues.  Event `provenance` preserves known source facts; `local`
+describes the current execution.  Optional `trace` contains the operation's
+own span IDs when tracing is enabled.  Older queue messages can lack these
+facts.  Consumers warn and omit malformed queued provenance so delivery can
+continue.  Invalid `dispatchId` values on new sends raise an error before
+preparation; the limit is 1,024 UTF-8 bytes.  Reusing an ID does not
+deduplicate sends.
+
+For typed examples, report variants, and capture limits, see the
+[sending manual].
+
+[sending manual]: https://fedify.dev/manual/send.md
 
 
 Vocabulary imports