fix(#3435): hive-forge issue/pr show fail on forgejo's null-for-empty reactions

Forgejo returns a bare `null` body (not `[]`) for a reactions list when
nothing has reacted yet. issue_reactions/comment_reactions deserialized
straight into forgejo-api's typed Vec<Reaction>, which has no null
tolerance, so issue show / pr show / view failed on every item with zero
reactions - i.e. nearly everything.

Generalize pr_status's existing null_as_empty (same quirk, hit earlier
on combined-status statuses) into a shared helper in verbs/mod.rs, and
fetch reactions via the raw JSON path (Client::get_api_json) with a
NullableVec<T> wrapper instead of the typed client's bare Vec<Reaction>.

Also names the failing request in errors going forward, since
get_api_json's error context includes the URL - closes the gap the
issue itself flagged (the old error said what didn't parse but not
what was fetched).
This commit is contained in:
damocles 2026-08-18 15:24:49 +02:00
commit 8b83eca0c1
2 changed files with 67 additions and 22 deletions

View file

@ -49,6 +49,7 @@ use std::fmt::Write as _;
use anyhow::Result;
use forgejo_api::structs::{Attachment, Reaction};
use serde::Deserialize;
use serde_json::{Value, json};
use time::OffsetDateTime;
use time::format_description::well_known::Rfc3339;
@ -381,6 +382,42 @@ pub(crate) fn dependency_summaries(
.collect())
}
/// Deserialize a possibly-null JSON array as an empty `Vec`.
///
/// Several Forgejo list endpoints return an explicit `null` body instead of
/// `[]` when the collection is empty — a commit's combined-status
/// `statuses` field when no CI is configured (`pr_status`'s own use of
/// this), and issue/comment reactions when nothing has reacted yet (a real
/// incident: `issue show`/`pr show` failing on *every* item because every
/// item's reaction fetch hit this). `#[serde(default)]` alone only
/// covers a *missing* key — a *present* `null` still fails to deserialize
/// into a bare `Vec<T>`, which is why this explicit `deserialize_with` is
/// needed rather than the derive default.
pub(crate) fn null_as_empty<'de, D, T>(de: D) -> Result<Vec<T>, D::Error>
where
D: serde::Deserializer<'de>,
T: Deserialize<'de>,
{
Ok(Option::<Vec<T>>::deserialize(de)?.unwrap_or_default())
}
/// A JSON array that tolerates Forgejo's null-for-empty quirk (see
/// [`null_as_empty`]). Used to fetch reactions directly via
/// [`Client::get_api_json`] rather than through forgejo-api's generated
/// client, which deserializes straight into a bare `Vec<Reaction>` with no
/// null tolerance and fails on exactly the common case of "nothing has
/// reacted to this yet".
struct NullableVec<T>(Vec<T>);
impl<'de, T: Deserialize<'de>> Deserialize<'de> for NullableVec<T> {
fn deserialize<D>(de: D) -> Result<Self, D::Error>
where
D: serde::Deserializer<'de>,
{
Ok(Self(null_as_empty(de)?))
}
}
/// The current reactions on an issue or PR itself (not a comment) — each
/// entry's `content` is Forgejo's shortcode (`"+1"`, `"heart"`, …, the
/// same vocabulary GitHub uses), `user` its login. Same shared-index
@ -397,11 +434,11 @@ pub(crate) fn issue_reactions(
name: &str,
number: u64,
) -> Result<Vec<Value>> {
let (_, reactions) = client
.api()
.issue_get_issue_reactions(owner, name, index(number)?)
.send()?;
Ok(reaction_values(reactions))
let reactions: NullableVec<Reaction> = client.get_api_json(
&format!("/repos/{owner}/{name}/issues/{number}/reactions"),
&[],
)?;
Ok(reaction_values(reactions.0))
}
/// The current reactions on a single comment, by comment id (not the
@ -417,11 +454,11 @@ pub(crate) fn comment_reactions(
name: &str,
comment_id: u64,
) -> Result<Vec<Value>> {
let reactions = client
.api()
.issue_get_comment_reactions(owner, name, index(comment_id)?)
.send()?;
Ok(reaction_values(reactions))
let reactions: NullableVec<Reaction> = client.get_api_json(
&format!("/repos/{owner}/{name}/issues/comments/{comment_id}/reactions"),
&[],
)?;
Ok(reaction_values(reactions.0))
}
fn reaction_values(reactions: Vec<Reaction>) -> Vec<Value> {
@ -488,7 +525,23 @@ pub(crate) fn attachment_json(assets: Option<&[Attachment]>) -> Vec<Value> {
#[cfg(test)]
mod tests {
use super::{pct_encode, reviewed_older_head};
use super::{NullableVec, pct_encode, reviewed_older_head};
#[test]
fn nullable_vec_treats_a_json_null_as_empty() {
// The exact shape of the real incident this guards: Forgejo answers
// a reactions (or combined-status) list with a bare `null` body
// when the collection is empty, not `[]` — deserializing straight
// into `Vec<T>` fails on it, `NullableVec<T>` must not.
let v: NullableVec<i64> = serde_json::from_str("null").unwrap();
assert_eq!(v.0, Vec::<i64>::new());
}
#[test]
fn nullable_vec_passes_a_real_array_through() {
let v: NullableVec<i64> = serde_json::from_str("[1,2,3]").unwrap();
assert_eq!(v.0, vec![1, 2, 3]);
}
#[test]
fn review_on_an_older_commit_is_stale() {

View file

@ -12,7 +12,6 @@
use anyhow::{Context, Result, bail};
use clap::Args as ClapArgs;
use forgejo_api::structs::IssueGetCommentsQuery;
use serde::Deserialize;
use serde_json::Value;
use crate::client::{Client, index};
@ -60,23 +59,16 @@ pub fn run(client: &Client, args: Args) -> Result<()> {
/// than `[]`, and `#[serde(default)]` only covers a *missing* key — a
/// present null still fails to deserialize. So a doc-only repo makes the
/// whole verb error out on exactly the PRs where "no CI here" is the
/// answer worth printing.
/// answer worth printing. See [`super::null_as_empty`] (shared with the
/// reaction-listing helpers, which hit the same quirk).
#[derive(serde::Deserialize, Default)]
pub(crate) struct CombinedStatus {
#[serde(default)]
pub state: String,
#[serde(default, deserialize_with = "null_as_empty")]
#[serde(default, deserialize_with = "super::null_as_empty")]
pub statuses: Vec<Value>,
}
/// Deserialize a possibly-null JSON array as an empty `Vec`.
fn null_as_empty<'de, D>(de: D) -> Result<Vec<Value>, D::Error>
where
D: serde::Deserializer<'de>,
{
Ok(Option::<Vec<Value>>::deserialize(de)?.unwrap_or_default())
}
/// CI-only path for an explicit commit. Exit code mirrors the CI verdict.
fn sha_status(client: &Client, sha: &str) -> Result<()> {
let (state, statuses) = fetch_combined(client, sha)?;