temps-add-plugin

Add a plugin

Every feature crate plugs into the server through TempsPlugin. The plugin builds the crate's services from shared ones, publishes its own services for other plugins, and returns its router and OpenAPI document.

• Trait and runtime: crates/temps-core/src/plugin.rs (TempsPlugin, ServiceRegistrationContext, PluginContext, PluginRoutes, RequiredService, PluginManager).
• Smallest complete example: crates/temps-flags/src/plugin.rs (one service, one router, one OpenAPI doc, no background work).
• Example with declared requirements: crates/temps-error-tracking/src/plugin.rs.
• Example with deferred initialisation: crates/temps-blob/src/plugin.rs.
• Where plugins are registered: register_builtin_plugins in crates/temps-cli/src/commands/serve/console/startup/plugins.rs.

1. The crate

A new crate under crates/:

• Add it to members in the root Cargo.toml.
• End its Cargo.toml with [lints] / workspace = true.
• Typical layout, as in temps-flags: lib.rs, error.rs, services/, handlers/{mod,handler,types,audit}.rs, plugin.rs. Re-export the plugin from lib.rs (pub use plugin::FlagsPlugin;).
• Add a description to [package].

2. Implement TempsPlugin

Shape of crates/temps-flags/src/plugin.rs:

pub struct FlagsPlugin;

impl TempsPlugin for FlagsPlugin {
    fn name(&self) -> &'static str {
        "flags"
    }

    fn register_services<'a>(
        &'a self,
        context: &'a ServiceRegistrationContext,
    ) -> Pin<Box<dyn Future<Output = Result<(), PluginError>> + Send + 'a>> {
        Box::pin(async move {
            let db = context.require_service::<DatabaseConnection>();
            context.register_service(Arc::new(FlagService::new(db)));
            Ok(())
        })
    }

    fn configure_routes(&self, context: &PluginContext) -> Option<PluginRoutes> {
        let flag_service = context.require_service::<FlagService>();
        let audit_service = context.require_service::<dyn AuditLogger>();
        let project_access_checker = context.get_service::<dyn temps_core::ProjectAccessChecker>();
        let app_state = Arc::new(FlagsAppState { flag_service, audit_service, project_access_checker });
        Some(PluginRoutes::new(configure_routes().with_state(app_state)))
    }

    fn openapi_schema(&self) -> Option<OpenApi> {
        Some(<FlagsApiDoc as OpenApiTrait>::openapi())
    }
}