Changeset dd568e7 in Klonkt for CHANGELOG.md

Timestamp:

07/19/2026 03:15:18 AM (7 weeks ago)

Author:

Robin <roboburr@…>

Branches:

main

Children:

bf72108

Parents:

d49b60b

git-author:

Robin <roboburr@…> (07/19/2026 03:14:01 AM)

git-committer:

Robin <roboburr@…> (07/19/2026 03:15:18 AM)

Message:

Feature: OAuth C2S outbox POST — apps can drive the account (phase 1 done)

Second half of AP Client-to-Server: a bearer-authenticated POST to
/ap/users/:slug/outbox accepts activities and translates them onto the existing
delivery machinery (deliverReply / sendInteraction / followActor /
deliverCreate) rather than reimplementing federation.

• ingestOutboxActivity(site, user, activity) dispatches Create(Note) (reply -> resolveRemoteNote + deliverReply; top-level -> a sanitized microblog post + deliverCreate), Like, Announce (+upsertBoostedNote), Follow, and Undo of Like/Announce/Follow. A bare Note is wrapped in a Create per AP section 6. Client "source" (plain) is preferred over "content" (HTML) for replies; top-level content is HtmlSanitizerService.sanitize()d. Unhandled verbs return a clear 400 rather than a silent no-op.
• Route: bearer via OAuthService.verifyBearer; the token is scoped to one site, so a slug mismatch is 403 and a readonly account is 403; no token is 401 with WWW-Authenticate. 201+Location for created objects, 202 for side-effect verbs. Declared after apJson (shared with the inbox handler) to avoid a TDZ on the const.

Verified live end to end against a running server with a real OAuth token:
top-level Note -> 201 + Location, stored published + sanitized (script stripped)
+ served as a valid Note at /ap/notes/<id>; Like/Follow -> 202; unresolvable
reply -> honest 502; no-token 401, wrong-site 403, unsupported type 400. 7 new
unit tests for the deterministic dispatch paths (80 green).

Ivory and other Mastodon-API clients are NOT supported by this: they speak
Mastodon's REST API (/api/v1/apps, /api/v1/instance, secret-based OAuth), not AP
C2S. That's a separate track (klonkt-demo-mastapi). Delete/Update of arbitrary
objects deferred (klonkt-demo-c2sdel). Beads: klonkt-demo-1w4.

Co-Authored-By: Claude Opus 4.8 <noreply@…>

File:

• CHANGELOG.md (modified) (1 diff)

CHANGELOG.md

@@ -15 +15 @@
   `/.well-known/oauth-authorization-server` (RFC 8414) exposes the metadata, so
   clients discover everything instead of hardcoding paths. Public clients + PKCE
-  only, no client secrets. The token-accepting outbox (POST) is the next phase.
+  only, no client secrets.
+- **The outbox accepts posts from apps (C2S, phase 1 complete).** A
+  bearer-authenticated `POST` to `/ap/users/:slug/outbox` now drives your account
+  from a client: publish a note, reply, like, boost, follow, and undo any of
+  those. Activities are translated onto the same delivery machinery the web UI
+  uses; a bare Note is wrapped in a Create per the spec; content is sanitized;
+  the token is scoped to one site so it can't post as another. Note: this is
+  ActivityPub C2S, which the Shaer apps speak. Mastodon clients (Ivory etc.) use
+  Mastodon's own API and are not supported by this.
 
 ### Fixed