version_bump/plugins/forgejo

The Forgejo publish plugin (Codeberg and self-hosted Forgejo instances).

The Forgejo counterpart of the github plugin: authenticate with a Forgejo token, resolve the target repository and instance, and create a Forgejo release for the version semantic-release just determined. Forgejo runs Codeberg, so plugins = [..., "forgejo"] with a https://codeberg.org/... repository URL is the common setup.

Hooks implemented:

• verify_conditions: a FORGEJO_TOKEN/GITEA_TOKEN and a resolvable repository URL must be present, otherwise the pipeline aborts.
• publish: create the Forgejo release and return it.
• success: log that the release was published.

Unlike GitHub, Forgejo is self-hostable, so the API base URL is derived from the repository URL’s host — overridable with the url plugin option or the FORGEJO_URL/GITEA_URL environment variables (useful when the git remote host differs from the API host, e.g. an SSH alias or a custom port).

Effectful work (HTTP, environment access) is kept in the hook bodies; the pure decision logic lives in helpers (resolve_token, resolve_api_base, is_prerelease, verify) so it can be unit-tested without a network or live environment.

pub fn is_prerelease(next_release: release.NextRelease) -> Bool

pub fn plugin() -> plugin.Plugin

pub fn resolve_api_base(
  explicit: option.Option(String),
  host: String,
) -> String

pub fn verify(
  token: option.Option(String),
  config: config.Config,
) -> Result(Nil, error.ReleaseError)