cursus-bin 0.9.2

//! Forge-client resolution at the binary boundary.
//!
//! Reads environment variables and config to pick between the GitHub and
//! GitLab forge implementations, returning a [`cursus::forge::CodeForgeClient`]
//! plus any auth-kind signals callers need.

mod github;
mod gitlab;

#[cfg(test)]
mod tests;

use std::sync::Arc;

pub(crate) use github::build_octocrab;
pub(crate) use gitlab::{GitLabHandles, gitlab_handles};

/// Outcome of resolving the active forge client.
pub(crate) struct ForgeClientOutcome {
	pub(crate) client: Arc<dyn cursus::forge::CodeForgeClient>,
	pub(crate) gitlab_uses_job_token_only: bool,
}

/// Dispatches to the appropriate forge client constructor based on which
/// `[github].enabled` / `[gitlab].enabled` flag is set.
///
/// The "more than one enabled" case is rejected at `Config::load`, so it
/// should be unreachable here; the defensive arm returns an error rather
/// than panicking.
pub(crate) async fn resolve_forge_client(
	env: &cursus::Env,
	config: &Option<cursus::model::config::Config>,
	octocrab: Option<Arc<octocrab::Octocrab>>,
	gitlab_handles: Option<&GitLabHandles>,
) -> Result<ForgeClientOutcome, String> {
	let cfg = config.as_ref();
	let github_enabled = cfg.is_some_and(|c| c.github.enabled);
	let gitlab_enabled = cfg.is_some_and(|c| c.gitlab.enabled);
	match (github_enabled, gitlab_enabled) {
		(true, false) => Ok(ForgeClientOutcome {
			client: github::resolve_github_forge_client(env, config, octocrab).await?,
			gitlab_uses_job_token_only: false,
		}),
		(false, true) => {
			let handles = gitlab_handles
				.ok_or_else(|| "GitLab client unavailable; check credentials".to_string())?;
			let outcome = gitlab::resolve_gitlab_forge_client_from_handles(handles);
			Ok(ForgeClientOutcome {
				client: outcome.client,
				gitlab_uses_job_token_only: outcome.uses_job_token_only,
			})
		}
		(false, false) => Err(
			"No forge enabled; set [github].enabled or [gitlab].enabled in .cursus/config.toml"
				.to_string(),
		),
		_ => Err("More than one forge is enabled in .cursus/config.toml.".to_string()),
	}
}

/// Wrapper around [`resolve_forge_client`] that unpacks the outcome into the
/// shape `Env`'s builder expects. Kept separate so the `try_main` function
/// can stay compact.
///
/// Returns `(Result<client, reason>, gitlab_uses_job_token_only)`. The bool
/// is `false` whenever forge resolution fails or the active forge is GitHub.
pub(crate) async fn resolve_forge_client_for_env(
	env: &cursus::Env,
	config: &Option<cursus::model::config::Config>,
	octocrab: Option<Arc<octocrab::Octocrab>>,
	gitlab_handles: Option<&GitLabHandles>,
) -> (
	Result<Arc<dyn cursus::forge::CodeForgeClient>, String>,
	bool,
) {
	match resolve_forge_client(env, config, octocrab, gitlab_handles).await {
		Ok(outcome) => (Ok(outcome.client), outcome.gitlab_uses_job_token_only),
		Err(reason) => (Err(reason), false),
	}
}