Struct ForgeService 

pub struct ForgeService { /* private fields */ }

The forge service. One instance is built at server startup and shared (Arc) across requests. All durable state lives under plugin_dir.

Implementations

impl ForgeService

pub fn new( cfg: ForgeConfig, plugin_dir: impl Into<PathBuf>, ) -> Result<Self, ForgeError>

Build a forge rooted at plugin_dir. Creates the on-disk layout (repos/, issues/, pulls/, hosted/, marks/) if absent. The git CGI service is rooted at plugin_dir/repos.

pub fn with_loopback(self, lb: Arc<dyn LoopbackFetch>) -> Self

Inject the loopback fetcher (the server’s reqwest client) used to verify and re-fetch pod-hosted bodies.

pub fn with_spine(self, spine: Arc<dyn SpineStore>) -> Self

Override the spine store (tests inject an in-memory store).

pub fn token_key(&self) -> &[u8; 32]

The forge instance HMAC key (for token minting/verification).

pub fn resolve_agent(&self, req: &ForgeRequest) -> ForgeAgent

Resolve the caller identity from req’s Authorization header (forge token or NIP-98). The server may instead pass a ForgeAgent::Pod directly to Self::handle when it has a pod session; this helper is for the token/NIP-98 schemes.

pub fn prefix(&self) -> String

The configured, normalised URL prefix (/forge).

pub fn plugin_dir(&self) -> &Path

The plugin data directory.

pub async fn handle( &self, req: ForgeRequest, agent: ForgeAgent, ) -> Result<ForgeResponse, ForgeError>

Single entry point. The embedding server maps its native request to a ForgeRequest, WAC-gates the scope, and calls this.

Trait Implementations

impl Clone for ForgeService

fn clone(&self) -> ForgeService

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ForgeService

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.