Routes & Settings

What the express adapter mounts, and the settings the module takes.

Mounting

bxsnew bxModules.bxactivitypub.adapters.express().mount( app, ap, options )

Mount it before your own routes. Account and post routes answer ActivityPub requests (Accept: application/activity+json); a browser asking for the same path is redirected to the url from your host, and anything else passes through to your app.

The adapter reads its own settings (the last four in the settings table); options overrides them for one mount. inboxRateLimit keys on req.ip, so behind a proxy set trust proxy or trust proxy header first.

Routes

Ids are these stable paths, never slugs — slugs change, ids can't. Each object's url points at its human-facing page instead.

Settings

Every setting has a default in the module's ModuleConfig.bx. Override any of them in your app's boxlang.json; ${env.NAME:default} placeholders work too:

json{
	"modules": {
		"bxactivitypub": {
			"settings": {
				"datasource": "${env.AP_DATASOURCE:mydb}",
				"inboxRateLimit": 300
			}
		}
	}
}

Settings passed in code, to new ActivityPub( host, settings ) or mount( app, ap, options ), win over both. ap.getSettings() returns the settings in effect.