@evcraddock/slug-federation
v0.1.0
Published
Reusable Slugkit ActivityPub and federation helpers.
Readme
@evcraddock/slug-federation
Reusable Slugkit ActivityPub and federation helpers.
Exports
- Runtime config and URL helpers:
readActivityPubRuntimeConfig,buildActivityPubActorUrls, andisActivityPubPublicOriginSafeForFederation. - Actor helpers:
validateActivityPubActorUsername,normalizeActivityPubActorInput,readActorDisplayName, andreadActorHandle. - Safety helpers:
assertSafeActivityPubRemoteUrl. - Key helpers:
generateActivityPubActorKeyPair,importActivityPubActorKeyPair, andimportActivityPubActorHttpSignatureSender. - Outbox helpers:
buildActivityPubPostUrl,renderActivityPubSimpleHtml, andescapeActivityPubHtml. - Types for runtime config, actor URLs, key pairs, delivery recipients/jobs, and JSON profile metadata.
Generated-site ownership
Generated sites keep local federation modules for domain configuration, database persistence, private key ownership, route mounting, and delivery operations. This package only provides reusable helpers at stable seams.
Operational upgrade notes
Treat ActivityPub domain and key material as site-owned operational state. Do not rotate keys, change public origins, or alter actor identifiers just because a package version changes. Apply patch releases for safety checks, serialization fixes, and helper hardening while keeping site-local wrappers reviewable.
