@evanp/activitypub-bot 0.8.0

package/README.md

@@ -0,0 +1,82 @@
+# activitypub.bot
+
+An ActivityPub server-side bot framework
+
+activitypub.bot is [social bot](https://en.wikipedia.org/wiki/Social_bot) server
+which helps developers create and deploy semi-autonomous actors on the
+[ActivityPub](https://activitypub.rocks/) network. Unlike general-purpose social
+networking servers, the bot software does not use a remote API like the
+ActivityPub API or the Mastodon API. Instead, the bot software runs inside the
+server, using an in-process API.
+
+activitypub.bot was originally developed as sample code for [ActivityPub: Programming for the Social Web](https://evanp.me/activitypub-book/) (2024) from O'Reilly Media.
+
+## Table of Contents
+
+- [Security](#security)
+- [Background](#background)
+- [Install](#install)
+- [Usage](#usage)
+- [API](#api)
+- [Contributing](#contributing)
+- [License](#license)
+
+## Security
+
+### Any optional sections
+
+## Background
+
+[Mastodon](https://joinmastodon.org/) and other ActivityPub servers implement bots using their API. This requires having a separate deployment for the API client, either as a long-running process, a cron job, or some other implementation.
+
+This server, instead, deploys the bot code inside the server process. This simplifies the interactions between the bot and the server, with the downside that deploying a new bot requires re-deploying the server.
+
+## Install
+
+The easiest way to install this server is using [Helm](https://helm.sh). See the [evanp/activitypub-bot-chart](https://github.com/evanp/activitypub-bot-chart) for instructions.
+
+There is also a Docker image at [ghcr.io/evanp/activitypub-bot](https://ghcr.io/evanp/activitypub-bot).
+
+It's also an [npm](https://npmjs.org/) package.
+
+## Usage
+
+```
+```
+
+Note: The `license` badge image link at the top of this file should be updated with the correct `:user` and `:repo`.
+
+### Any optional sections
+
+## API
+
+### Any optional sections
+
+## More optional sections
+
+## Contributing
+
+See [the contributing file](CONTRIBUTING.md)!
+
+PRs accepted.
+
+Small note: If editing the Readme, please conform to the [standard-readme](https://github.com/RichardLitt/standard-readme) specification.
+
+### Any optional sections
+
+## License
+
+Copyright (C) 2023-2025 Evan Prodromou <evan@prodromou.name>
+
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU Affero General Public License as published
+by the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+GNU Affero General Public License for more details.
+
+You should have received a copy of the GNU Affero General Public License
+along with this program.  If not, see <https://www.gnu.org/licenses/>.

package/bots/index.js

@@ -0,0 +1,7 @@
+import DoNothingBot from '../lib/bots/donothing.js'
+import OKBot from '../lib/bots/ok.js'
+
+export default {
+  ok: new OKBot('ok'),
+  null: new DoNothingBot('null')
+}

package/docs/activitypub.bot.drawio

@@ -0,0 +1,110 @@
+<mxfile host="app.diagrams.net" modified="2024-01-14T17:20:53.624Z" agent="Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:121.0) Gecko/20100101 Firefox/121.0" etag="UDjGppbSRivOII49-YrU" version="22.1.16" type="github">
+  <diagram id="C5RBs43oDa-KdzZeNtuy" name="Page-1">
+    <mxGraphModel dx="2074" dy="1057" grid="1" gridSize="10" guides="1" tooltips="1" connect="1" arrows="1" fold="1" page="1" pageScale="1" pageWidth="827" pageHeight="1169" math="0" shadow="0">
+      <root>
+        <mxCell id="WIyWlLk6GJQsqaUBKTNV-0" />
+        <mxCell id="WIyWlLk6GJQsqaUBKTNV-1" parent="WIyWlLk6GJQsqaUBKTNV-0" />
+        <mxCell id="zkfFHV4jXpPFQw0GAbJ--0" value="BotServer" style="swimlane;fontStyle=2;align=center;verticalAlign=top;childLayout=stackLayout;horizontal=1;startSize=26;horizontalStack=0;resizeParent=1;resizeLast=0;collapsible=1;marginBottom=0;rounded=0;shadow=0;strokeWidth=1;" parent="WIyWlLk6GJQsqaUBKTNV-1" vertex="1">
+          <mxGeometry x="220" y="120" width="160" height="138" as="geometry">
+            <mxRectangle x="230" y="140" width="160" height="26" as="alternateBounds" />
+          </mxGeometry>
+        </mxCell>
+        <mxCell id="zkfFHV4jXpPFQw0GAbJ--1" value="Name" style="text;align=left;verticalAlign=top;spacingLeft=4;spacingRight=4;overflow=hidden;rotatable=0;points=[[0,0.5],[1,0.5]];portConstraint=eastwest;" parent="zkfFHV4jXpPFQw0GAbJ--0" vertex="1">
+          <mxGeometry y="26" width="160" height="26" as="geometry" />
+        </mxCell>
+        <mxCell id="zkfFHV4jXpPFQw0GAbJ--2" value="Phone Number" style="text;align=left;verticalAlign=top;spacingLeft=4;spacingRight=4;overflow=hidden;rotatable=0;points=[[0,0.5],[1,0.5]];portConstraint=eastwest;rounded=0;shadow=0;html=0;" parent="zkfFHV4jXpPFQw0GAbJ--0" vertex="1">
+          <mxGeometry y="52" width="160" height="26" as="geometry" />
+        </mxCell>
+        <mxCell id="zkfFHV4jXpPFQw0GAbJ--3" value="Email Address" style="text;align=left;verticalAlign=top;spacingLeft=4;spacingRight=4;overflow=hidden;rotatable=0;points=[[0,0.5],[1,0.5]];portConstraint=eastwest;rounded=0;shadow=0;html=0;" parent="zkfFHV4jXpPFQw0GAbJ--0" vertex="1">
+          <mxGeometry y="78" width="160" height="26" as="geometry" />
+        </mxCell>
+        <mxCell id="zkfFHV4jXpPFQw0GAbJ--4" value="" style="line;html=1;strokeWidth=1;align=left;verticalAlign=middle;spacingTop=-1;spacingLeft=3;spacingRight=3;rotatable=0;labelPosition=right;points=[];portConstraint=eastwest;" parent="zkfFHV4jXpPFQw0GAbJ--0" vertex="1">
+          <mxGeometry y="104" width="160" height="8" as="geometry" />
+        </mxCell>
+        <mxCell id="zkfFHV4jXpPFQw0GAbJ--5" value="Purchase Parking Pass" style="text;align=left;verticalAlign=top;spacingLeft=4;spacingRight=4;overflow=hidden;rotatable=0;points=[[0,0.5],[1,0.5]];portConstraint=eastwest;" parent="zkfFHV4jXpPFQw0GAbJ--0" vertex="1">
+          <mxGeometry y="112" width="160" height="26" as="geometry" />
+        </mxCell>
+        <mxCell id="zkfFHV4jXpPFQw0GAbJ--6" value="Activity" style="swimlane;fontStyle=0;align=center;verticalAlign=top;childLayout=stackLayout;horizontal=1;startSize=26;horizontalStack=0;resizeParent=1;resizeLast=0;collapsible=1;marginBottom=0;rounded=0;shadow=0;strokeWidth=1;" parent="WIyWlLk6GJQsqaUBKTNV-1" vertex="1">
+          <mxGeometry x="120" y="360" width="160" height="138" as="geometry">
+            <mxRectangle x="130" y="380" width="160" height="26" as="alternateBounds" />
+          </mxGeometry>
+        </mxCell>
+        <mxCell id="zkfFHV4jXpPFQw0GAbJ--7" value="Student Number" style="text;align=left;verticalAlign=top;spacingLeft=4;spacingRight=4;overflow=hidden;rotatable=0;points=[[0,0.5],[1,0.5]];portConstraint=eastwest;" parent="zkfFHV4jXpPFQw0GAbJ--6" vertex="1">
+          <mxGeometry y="26" width="160" height="26" as="geometry" />
+        </mxCell>
+        <mxCell id="zkfFHV4jXpPFQw0GAbJ--8" value="Average Mark" style="text;align=left;verticalAlign=top;spacingLeft=4;spacingRight=4;overflow=hidden;rotatable=0;points=[[0,0.5],[1,0.5]];portConstraint=eastwest;rounded=0;shadow=0;html=0;" parent="zkfFHV4jXpPFQw0GAbJ--6" vertex="1">
+          <mxGeometry y="52" width="160" height="26" as="geometry" />
+        </mxCell>
+        <mxCell id="zkfFHV4jXpPFQw0GAbJ--9" value="" style="line;html=1;strokeWidth=1;align=left;verticalAlign=middle;spacingTop=-1;spacingLeft=3;spacingRight=3;rotatable=0;labelPosition=right;points=[];portConstraint=eastwest;" parent="zkfFHV4jXpPFQw0GAbJ--6" vertex="1">
+          <mxGeometry y="78" width="160" height="8" as="geometry" />
+        </mxCell>
+        <mxCell id="zkfFHV4jXpPFQw0GAbJ--10" value="Is Eligible To Enroll" style="text;align=left;verticalAlign=top;spacingLeft=4;spacingRight=4;overflow=hidden;rotatable=0;points=[[0,0.5],[1,0.5]];portConstraint=eastwest;fontStyle=4" parent="zkfFHV4jXpPFQw0GAbJ--6" vertex="1">
+          <mxGeometry y="86" width="160" height="26" as="geometry" />
+        </mxCell>
+        <mxCell id="zkfFHV4jXpPFQw0GAbJ--11" value="Get Seminars Taken" style="text;align=left;verticalAlign=top;spacingLeft=4;spacingRight=4;overflow=hidden;rotatable=0;points=[[0,0.5],[1,0.5]];portConstraint=eastwest;" parent="zkfFHV4jXpPFQw0GAbJ--6" vertex="1">
+          <mxGeometry y="112" width="160" height="26" as="geometry" />
+        </mxCell>
+        <mxCell id="zkfFHV4jXpPFQw0GAbJ--12" value="" style="endArrow=block;endSize=10;endFill=0;shadow=0;strokeWidth=1;rounded=0;edgeStyle=elbowEdgeStyle;elbow=vertical;" parent="WIyWlLk6GJQsqaUBKTNV-1" source="zkfFHV4jXpPFQw0GAbJ--6" target="zkfFHV4jXpPFQw0GAbJ--0" edge="1">
+          <mxGeometry width="160" relative="1" as="geometry">
+            <mxPoint x="200" y="203" as="sourcePoint" />
+            <mxPoint x="200" y="203" as="targetPoint" />
+          </mxGeometry>
+        </mxCell>
+        <mxCell id="zkfFHV4jXpPFQw0GAbJ--13" value="Object" style="swimlane;fontStyle=0;align=center;verticalAlign=top;childLayout=stackLayout;horizontal=1;startSize=26;horizontalStack=0;resizeParent=1;resizeLast=0;collapsible=1;marginBottom=0;rounded=0;shadow=0;strokeWidth=1;" parent="WIyWlLk6GJQsqaUBKTNV-1" vertex="1">
+          <mxGeometry x="330" y="360" width="160" height="70" as="geometry">
+            <mxRectangle x="340" y="380" width="170" height="26" as="alternateBounds" />
+          </mxGeometry>
+        </mxCell>
+        <mxCell id="zkfFHV4jXpPFQw0GAbJ--14" value="Salary" style="text;align=left;verticalAlign=top;spacingLeft=4;spacingRight=4;overflow=hidden;rotatable=0;points=[[0,0.5],[1,0.5]];portConstraint=eastwest;" parent="zkfFHV4jXpPFQw0GAbJ--13" vertex="1">
+          <mxGeometry y="26" width="160" height="26" as="geometry" />
+        </mxCell>
+        <mxCell id="zkfFHV4jXpPFQw0GAbJ--15" value="" style="line;html=1;strokeWidth=1;align=left;verticalAlign=middle;spacingTop=-1;spacingLeft=3;spacingRight=3;rotatable=0;labelPosition=right;points=[];portConstraint=eastwest;" parent="zkfFHV4jXpPFQw0GAbJ--13" vertex="1">
+          <mxGeometry y="52" width="160" height="8" as="geometry" />
+        </mxCell>
+        <mxCell id="zkfFHV4jXpPFQw0GAbJ--16" value="" style="endArrow=block;endSize=10;endFill=0;shadow=0;strokeWidth=1;rounded=0;edgeStyle=elbowEdgeStyle;elbow=vertical;" parent="WIyWlLk6GJQsqaUBKTNV-1" source="zkfFHV4jXpPFQw0GAbJ--13" target="zkfFHV4jXpPFQw0GAbJ--0" edge="1">
+          <mxGeometry width="160" relative="1" as="geometry">
+            <mxPoint x="210" y="373" as="sourcePoint" />
+            <mxPoint x="310" y="271" as="targetPoint" />
+          </mxGeometry>
+        </mxCell>
+        <mxCell id="zkfFHV4jXpPFQw0GAbJ--17" value="Bot" style="swimlane;fontStyle=0;align=center;verticalAlign=top;childLayout=stackLayout;horizontal=1;startSize=26;horizontalStack=0;resizeParent=1;resizeLast=0;collapsible=1;marginBottom=0;rounded=0;shadow=0;strokeWidth=1;" parent="WIyWlLk6GJQsqaUBKTNV-1" vertex="1">
+          <mxGeometry x="508" y="120" width="160" height="216" as="geometry">
+            <mxRectangle x="550" y="140" width="160" height="26" as="alternateBounds" />
+          </mxGeometry>
+        </mxCell>
+        <mxCell id="zkfFHV4jXpPFQw0GAbJ--23" value="" style="line;html=1;strokeWidth=1;align=left;verticalAlign=middle;spacingTop=-1;spacingLeft=3;spacingRight=3;rotatable=0;labelPosition=right;points=[];portConstraint=eastwest;" parent="zkfFHV4jXpPFQw0GAbJ--17" vertex="1">
+          <mxGeometry y="26" width="160" height="8" as="geometry" />
+        </mxCell>
+        <mxCell id="zkfFHV4jXpPFQw0GAbJ--24" value="+ powerUp(object)" style="text;align=left;verticalAlign=top;spacingLeft=4;spacingRight=4;overflow=hidden;rotatable=0;points=[[0,0.5],[1,0.5]];portConstraint=eastwest;" parent="zkfFHV4jXpPFQw0GAbJ--17" vertex="1">
+          <mxGeometry y="34" width="160" height="26" as="geometry" />
+        </mxCell>
+        <mxCell id="zkfFHV4jXpPFQw0GAbJ--25" value="+ powerDown(object)" style="text;align=left;verticalAlign=top;spacingLeft=4;spacingRight=4;overflow=hidden;rotatable=0;points=[[0,0.5],[1,0.5]];portConstraint=eastwest;" parent="zkfFHV4jXpPFQw0GAbJ--17" vertex="1">
+          <mxGeometry y="60" width="160" height="26" as="geometry" />
+        </mxCell>
+        <mxCell id="dP12apakX7S5GaSoqi7g-0" value="+ onReply(object)" style="text;align=left;verticalAlign=top;spacingLeft=4;spacingRight=4;overflow=hidden;rotatable=0;points=[[0,0.5],[1,0.5]];portConstraint=eastwest;" vertex="1" parent="zkfFHV4jXpPFQw0GAbJ--17">
+          <mxGeometry y="86" width="160" height="26" as="geometry" />
+        </mxCell>
+        <mxCell id="dP12apakX7S5GaSoqi7g-1" value="+ onMention(object)" style="text;align=left;verticalAlign=top;spacingLeft=4;spacingRight=4;overflow=hidden;rotatable=0;points=[[0,0.5],[1,0.5]];portConstraint=eastwest;" vertex="1" parent="zkfFHV4jXpPFQw0GAbJ--17">
+          <mxGeometry y="112" width="160" height="26" as="geometry" />
+        </mxCell>
+        <mxCell id="zkfFHV4jXpPFQw0GAbJ--26" value="" style="endArrow=open;shadow=0;strokeWidth=1;rounded=0;endFill=1;edgeStyle=elbowEdgeStyle;elbow=vertical;" parent="WIyWlLk6GJQsqaUBKTNV-1" source="zkfFHV4jXpPFQw0GAbJ--0" target="zkfFHV4jXpPFQw0GAbJ--17" edge="1">
+          <mxGeometry x="0.5" y="41" relative="1" as="geometry">
+            <mxPoint x="380" y="192" as="sourcePoint" />
+            <mxPoint x="540" y="192" as="targetPoint" />
+            <mxPoint x="-40" y="32" as="offset" />
+          </mxGeometry>
+        </mxCell>
+        <mxCell id="zkfFHV4jXpPFQw0GAbJ--27" value="1" style="resizable=0;align=left;verticalAlign=bottom;labelBackgroundColor=none;fontSize=12;" parent="zkfFHV4jXpPFQw0GAbJ--26" connectable="0" vertex="1">
+          <mxGeometry x="-1" relative="1" as="geometry">
+            <mxPoint y="4" as="offset" />
+          </mxGeometry>
+        </mxCell>
+        <mxCell id="zkfFHV4jXpPFQw0GAbJ--28" value="0.." style="resizable=0;align=right;verticalAlign=bottom;labelBackgroundColor=none;fontSize=12;" parent="zkfFHV4jXpPFQw0GAbJ--26" connectable="0" vertex="1">
+          <mxGeometry x="1" relative="1" as="geometry">
+            <mxPoint x="-7" y="4" as="offset" />
+          </mxGeometry>
+        </mxCell>
+      </root>
+    </mxGraphModel>
+  </diagram>
+</mxfile>

package/index.js

@@ -0,0 +1,23 @@
+import { makeApp } from './lib/app.js'
+
+const DATABASE_URL = process.env.DATABASE_URL || 'sqlite::memory:'
+const ORIGIN = process.env.ORIGIN || 'https://activitypubbot.test'
+const PORT = process.env.PORT || 9000 // HAL
+const BOTS_CONFIG_FILE = process.env.BOTS_CONFIG_FILE || './bots/index.js'
+const LOG_LEVEL = process.env.LOG_LEVEL || (process.env.NODE_ENV === 'test' ? 'silent' : 'info')
+
+const bots = (await import(BOTS_CONFIG_FILE)).default
+
+const app = await makeApp(DATABASE_URL, ORIGIN, bots, LOG_LEVEL)
+
+const server = app.listen(parseInt(PORT), () => {
+  app.locals.logger.info(`Listening on port ${PORT}`)
+})
+
+process.on('SIGTERM', () => {
+  console.log('Received SIGTERM')
+  server.close(async () => {
+    await app.cleanup()
+    process.exit(0)
+  })
+})

package/lib/activitydistributor.js

@@ -0,0 +1,263 @@
+import assert from 'node:assert'
+import as2 from './activitystreams.js'
+import { LRUCache } from 'lru-cache'
+import PQueue from 'p-queue'
+import { setTimeout } from 'node:timers/promises'
+
+export class ActivityDistributor {
+  static #MAX_CACHE_SIZE = 1000000
+  static #CONCURRENCY = 32
+  static #MAX_ATTEMPTS = 16
+  static #PUBLIC = [
+    'https://www.w3.org/ns/activitystreams#Public',
+    'as:Public',
+    'Public'
+  ]
+
+  #client = null
+  #formatter = null
+  #actorStorage = null
+  #directInboxCache = null
+  #sharedInboxCache = null
+  #queue = null
+  #retryQueue = null
+  #logger = null
+
+  constructor (client, formatter, actorStorage, logger = null) {
+    this.#client = client
+    this.#formatter = formatter
+    this.#actorStorage = actorStorage
+    this.#logger = logger.child({ class: this.constructor.name })
+    this.#directInboxCache = new LRUCache({ max: ActivityDistributor.#MAX_CACHE_SIZE })
+    this.#sharedInboxCache = new LRUCache({ max: ActivityDistributor.#MAX_CACHE_SIZE })
+    this.#queue = new PQueue({ concurrency: ActivityDistributor.#CONCURRENCY })
+    this.#retryQueue = new PQueue()
+  }
+
+  async distribute (activity, username) {
+    const stripped = await this.#strip(activity)
+    const actorId = this.#formatter.format({ username })
+
+    const delivered = new Set()
+    const localDelivered = new Set()
+
+    for await (const recipient of this.#public(activity, username)) {
+      if (await this.#isLocal(recipient)) {
+        if (recipient !== actorId && !localDelivered.has(recipient)) {
+          localDelivered.add(recipient)
+          this.#queue.add(() =>
+            this.#deliverLocal(recipient, stripped, username))
+        }
+      } else {
+        const inbox = await this.#getInbox(recipient, username)
+        if (!inbox) {
+          this.#logger.warn({ id: recipient.id }, 'No inbox')
+        } else if (!delivered.has(inbox)) {
+          delivered.add(inbox)
+          this.#queue.add(() =>
+            this.#deliver(inbox, stripped, username)
+          )
+        }
+      }
+    }
+
+    for await (const recipient of this.#private(activity, username)) {
+      if (await this.#isLocal(recipient)) {
+        if (recipient !== actorId && !localDelivered.has(recipient)) {
+          localDelivered.add(recipient)
+          this.#queue.add(() =>
+            this.#deliverLocal(recipient, stripped, username))
+        }
+      } else {
+        const inbox = await this.#getDirectInbox(recipient, username)
+        if (!inbox) {
+          this.#logger.warn({ id: recipient.id }, 'No direct inbox')
+        } else if (!delivered.has(inbox)) {
+          delivered.add(inbox)
+          this.#queue.add(() =>
+            this.#deliver(inbox, stripped, username)
+          )
+        }
+      }
+    }
+  }
+
+  async onIdle () {
+    await this.#retryQueue.onIdle()
+    await this.#queue.onIdle()
+  }
+
+  async * #public (activity, username) {
+    const followers = this.#formatter.format({
+      username,
+      collection: 'followers'
+    })
+    for (const prop of ['to', 'cc', 'audience']) {
+      const p = activity.get(prop)
+      if (p) {
+        for (const value of p) {
+          const id = value.id
+          if (id === followers ||
+            ActivityDistributor.#PUBLIC.includes(id)) {
+            for await (const follower of this.#actorStorage.items(username, 'followers')) {
+              yield follower.id
+            }
+          } else {
+            yield id
+          }
+        }
+      }
+    }
+  }
+
+  async * #private (activity, username) {
+    const followers = this.#formatter.format({
+      username,
+      collection: 'followers'
+    })
+    for (const prop of ['bto', 'bcc']) {
+      const p = activity.get(prop)
+      if (p) {
+        for (const value of p) {
+          const id = value.id
+          if (id === followers ||
+            ActivityDistributor.#PUBLIC.includes(id)) {
+            for await (const follower of this.#actorStorage.items(username, 'followers')) {
+              yield follower.id
+            }
+          } else {
+            yield id
+          }
+        }
+      }
+    }
+  }
+
+  async #getInbox (actorId, username) {
+    assert.ok(actorId)
+    assert.equal(typeof actorId, 'string')
+    assert.ok(username)
+    assert.equal(typeof username, 'string')
+
+    let sharedInbox = this.#sharedInboxCache.get(actorId)
+
+    if (sharedInbox) {
+      return sharedInbox
+    }
+
+    const obj = await this.#client.get(actorId, username)
+
+    // Get the shared inbox if it exists
+
+    const endpoints = obj.get('endpoints')
+    if (endpoints) {
+      const firstEndpoint = Array.from(endpoints)[0]
+      const sharedInboxEndpoint = firstEndpoint.get('sharedInbox')
+      if (sharedInboxEndpoint) {
+        const firstSharedInbox = Array.from(sharedInboxEndpoint)[0]
+        sharedInbox = firstSharedInbox.id
+        this.#sharedInboxCache.set(actorId, sharedInbox)
+        return sharedInbox
+      }
+    }
+
+    let directInbox = this.#directInboxCache.get(actorId)
+    if (directInbox) {
+      return directInbox
+    }
+
+    if (!obj.inbox) {
+      return null
+    }
+    const inboxes = Array.from(obj.inbox)
+    if (inboxes.length === 0) {
+      return null
+    }
+    directInbox = inboxes[0].id
+    this.#directInboxCache.set(actorId, directInbox)
+    return directInbox
+  }
+
+  async #getDirectInbox (actorId, username) {
+    assert.ok(actorId)
+    assert.equal(typeof actorId, 'string')
+    assert.ok(username)
+    assert.equal(typeof username, 'string')
+    let directInbox = this.#directInboxCache.get(actorId)
+    if (directInbox) {
+      return directInbox
+    }
+
+    const obj = await this.#client.get(actorId, username)
+
+    if (!obj.inbox) {
+      return null
+    }
+    const inboxes = Array.from(obj.inbox)
+    if (inboxes.length === 0) {
+      return null
+    }
+    directInbox = inboxes[0].id
+    this.#directInboxCache.set(actorId, directInbox)
+    return directInbox
+  }
+
+  async #strip (activity) {
+    const exported = await activity.export({ useOriginalContext: true })
+    delete exported.bcc
+    delete exported.bto
+    return await as2.import(exported)
+  }
+
+  async #deliver (inbox, activity, username, attempt = 1) {
+    try {
+      await this.#client.post(inbox, activity, username)
+      this.#logInfo(`Delivered ${activity.id} to ${inbox}`)
+    } catch (error) {
+      if (!error.status) {
+        this.#logError(`Could not deliver ${activity.id} to ${inbox}: ${error.message}`)
+        this.#logError(error.stack)
+      } else if (error.status >= 300 && error.status < 400) {
+        this.#logError(`Unexpected redirect code delivering ${activity.id} to ${inbox}: ${error.status} ${error.message}`)
+      } else if (error.status >= 400 && error.status < 500) {
+        this.#logError(`Bad request delivering ${activity.id} to ${inbox}: ${error.status} ${error.message}`)
+      } else if (error.status >= 500 && error.status < 600) {
+        if (attempt >= ActivityDistributor.#MAX_ATTEMPTS) {
+          this.#logError(`Server error delivering ${activity.id} to ${inbox}: ${error.status} ${error.message}; giving up after ${attempt} attempts`)
+        }
+        const delay = Math.round((2 ** (attempt - 1) * 1000) * (0.5 + Math.random()))
+        this.#logWarning(`Server error delivering ${activity.id} to ${inbox}: ${error.status} ${error.message}; will retry in ${delay} ms (${attempt} of ${ActivityDistributor.#MAX_ATTEMPTS})`)
+        this.#retryQueue.add(() => setTimeout(delay).then(() => this.#deliver(inbox, activity, username, attempt + 1)))
+      }
+    }
+  }
+
+  #logError (message) {
+    if (this.#logger) {
+      this.#logger.error(message)
+    }
+  }
+
+  #logWarning (message) {
+    if (this.#logger) {
+      this.#logger.warn(message)
+    }
+  }
+
+  #logInfo (message) {
+    if (this.#logger) {
+      this.#logger.info(message)
+    }
+  }
+
+  #isLocal (id) {
+    return this.#formatter.isLocal(id)
+  }
+
+  async #deliverLocal (id, activity) {
+    const username = this.#formatter.getUserName(id)
+    if (username) {
+      await this.#actorStorage.addToCollection(username, 'inbox', activity)
+    }
+  }
+}