rustango_cms/api/
changes.rs1use axum::response::{IntoResponse, Response};
35use axum::Json;
36use chrono::{DateTime, Utc};
37use rustango::core::Column as _;
38use rustango::extractors::{SessionUser, Tenant};
39use rustango::sql::{CounterPool as _, FetcherPool as _};
40
41use crate::media::Media;
42use crate::navigation::{Menu, MenuItem};
43use crate::page::{Page, PageStatus};
44use crate::snippet::Snippet;
45
46pub async fn changes(
48 tenant: Tenant,
49 SessionUser(session_user): SessionUser,
50 rustango::tenancy::member_auth::CurrentMember(member): rustango::tenancy::member_auth::CurrentMember,
51 crate::api::auth::BearerMember(bearer): crate::api::auth::BearerMember,
52) -> Response {
53 let viewer = member.as_ref().or(bearer.as_ref()).or(session_user.as_ref());
54 match changes_inner(tenant.pool(), viewer).await {
55 Ok(resp) => resp,
56 Err(e) => {
57 tracing::error!(target: "rustango_cms::api", error = %e, "changes failed");
58 crate::api::error::ApiError::internal().into_response()
59 }
60 }
61}
62
63fn entry(count: usize, latest: Option<DateTime<Utc>>) -> serde_json::Value {
65 serde_json::json!({
66 "count": count,
67 "latest": latest.map(|t| t.to_rfc3339()),
68 })
69}
70
71fn newest(times: impl Iterator<Item = Option<DateTime<Utc>>>) -> Option<DateTime<Utc>> {
73 times.flatten().max()
74}
75
76fn to_usize(n: i64) -> usize {
77 usize::try_from(n).unwrap_or(0)
78}
79
80async fn media_fingerprint(
83 pool: &rustango::sql::Pool,
84 denied: &[i64],
85 images: bool,
86) -> Result<(usize, Option<DateTime<Utc>>), rustango::sql::ExecError> {
87 let listed = || {
88 let qs = Media::objects();
89 let qs = if images {
90 qs.where_(Media::kind.eq("image".to_owned()))
91 } else {
92 qs.where_(Media::kind.ne("image".to_owned()))
93 };
94 if denied.is_empty() {
95 qs
96 } else {
97 qs.where_(
98 Media::collection_id
99 .is_null()
100 .or(Media::collection_id.not_in(denied.iter().copied())),
101 )
102 }
103 };
104 let count = listed().count(pool).await?;
105 let latest = listed()
106 .order_by(&[("uploaded_at", true)])
107 .first(pool)
108 .await?
109 .and_then(|m| m.uploaded_at.get().copied());
110 Ok((to_usize(count), latest))
111}
112
113pub async fn changes_inner(
114 pool: &rustango::sql::Pool,
115 viewer: Option<&rustango::tenancy::auth::User>,
116) -> Result<Response, rustango::sql::ExecError> {
117 let mut pages: Vec<Page> = Page::objects()
119 .where_(Page::status.is_in([
120 PageStatus::Published.as_str().to_owned(),
121 PageStatus::Archived.as_str().to_owned(),
122 ]))
123 .fetch(pool)
124 .await?;
125 pages.retain(|p| p.locale_variant_of.is_none());
126 let triples: Vec<(i64, String, i64)> = pages
127 .iter()
128 .map(|p| {
129 (
130 p.id.get().copied().unwrap_or_default(),
131 p.path.clone(),
132 p.page_type_id,
133 )
134 })
135 .collect();
136 let denied = crate::view_restriction::denied_page_ids(pool, viewer, &triples).await;
137 pages.retain(|p| !denied.contains(&p.id.get().copied().unwrap_or_default()));
138
139 let collection_ids: Vec<i64> = crate::media::MediaCollection::objects()
144 .fetch(pool)
145 .await?
146 .iter()
147 .filter_map(|c| c.id.get().copied())
148 .collect();
149 let denied: Vec<i64> =
150 crate::collection_view_restriction::denied_collection_ids(pool, viewer, &collection_ids)
151 .await
152 .into_iter()
153 .collect();
154 let (images, documents) = (
155 media_fingerprint(pool, &denied, true).await?,
156 media_fingerprint(pool, &denied, false).await?,
157 );
158
159 let snippets = (
160 Snippet::objects().count(pool).await?,
161 Snippet::objects()
162 .order_by(&[("updated_at", true)])
163 .first(pool)
164 .await?
165 .and_then(|s| s.updated_at.get().copied()),
166 );
167
168 let menus = Menu::objects().count(pool).await? + MenuItem::objects().count(pool).await?;
172
173 Ok(Json(serde_json::json!({
174 "meta": {
175 "checked_at": Utc::now().to_rfc3339(),
176 "usage": "Re-fetch a collection when its `count` or `latest` \
179 differs from the values you hold, passing the \
180 `latest` you held as `?updated_since=`.",
181 },
182 "collections": {
183 "pages": entry(
184 pages.len(),
185 newest(pages.iter().map(|p| p.updated_at.get().copied())),
186 ),
187 "images": entry(images.0, images.1),
188 "documents": entry(documents.0, documents.1),
189 "snippets": entry(to_usize(snippets.0), snippets.1),
190 "menus": entry(to_usize(menus), None),
191 },
192 }))
193 .into_response())
194}
195
196#[cfg(test)]
197mod tests {
198 use super::*;
199
200 fn t(s: &str) -> Option<DateTime<Utc>> {
201 Some(DateTime::parse_from_rfc3339(s).unwrap().with_timezone(&Utc))
202 }
203
204 #[test]
205 fn newest_picks_the_latest_and_ignores_missing() {
206 let got = newest(
207 [t("2026-01-01T00:00:00Z"), None, t("2026-06-01T00:00:00Z")].into_iter(),
208 );
209 assert_eq!(got, t("2026-06-01T00:00:00Z"));
210 }
211
212 #[test]
213 fn newest_of_nothing_is_none() {
214 assert_eq!(newest(std::iter::empty()), None);
215 assert_eq!(newest([None, None].into_iter()), None);
216 }
217
218 #[test]
219 fn an_entry_carries_both_halves_of_the_signal() {
220 let e = entry(3, t("2026-01-01T00:00:00Z"));
222 assert_eq!(e["count"], 3);
223 assert!(e["latest"].is_string());
224
225 let empty = entry(0, None);
226 assert_eq!(empty["count"], 0);
227 assert!(empty["latest"].is_null());
228 }
229}