Something went wrong. Try again.
A one-stop-shop capsuleer manager for EVE Online pod.aaronmallen.dev
Something went wrong. Try again.
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302130313041305130613071308130913101311131213131314131513161317131813191320132113221323132413251326132713281329133013311332133313341335133613371338133913401341134213431344134513461347134813491350135113521353135413551356135713581359136013611362136313641365136613671368136913701371137213731374137513761377137813791380138113821383138413851386138713881389139013911392139313941395139613971398139914001401140214031404140514061407140814091410141114121413141414151416141714181419142014211422142314241425142614271428142914301431143214331434143514361437143814391440144114421443144414451446144714481449145014511452145314541455145614571458145914601461146214631464146514661467146814691470147114721473147414751476147714781479148014811482148314841485148614871488148914901491149214931494149514961497149814991500150115021503150415051506150715081509151015111512151315141515151615171518151915201521152215231524152515261527152815291530153115321533153415351536153715381539154015411542154315441545154615471548154915501551155215531554155515561557155815591560156115621563156415651566156715681569157015711572157315741575157615771578157915801581158215831584158515861587158815891590159115921593159415951596159715981599160016011602160316041605160616071608160916101611161216131614161516161617161816191620162116221623162416251626162716281629163016311632163316341635163616371638163916401641164216431644164516461647164816491650165116521653165416551656165716581659166016611662166316641665166616671668166916701671167216731674167516761677167816791680168116821683168416851686168716881689169016911692169316941695169616971698169917001701170217031704170517061707170817091710171117121713171417151716171717181719172017211722172317241725172617271728172917301731173217331734173517361737173817391740174117421743174417451746174717481749175017511752175317541755175617571758175917601761176217631764176517661767176817691770177117721773177417751776177717781779178017811782178317841785178617871788178917901791179217931794179517961797179817991800180118021803180418051806180718081809181018111812181318141815181618171818181918201821182218231824182518261827182818291830183118321833183418351836183718381839184018411842184318441845184618471848184918501851185218531854185518561857185818591860186118621863186418651866186718681869187018711872187318741875187618771878187918801881188218831884188518861887188818891890189118921893189418951896189718981899190019011902190319041905190619071908190919101911191219131914191519161917191819191920192119221923192419251926192719281929193019311932193319341935193619371938193919401941194219431944194519461947194819491950195119521953195419551956use std::collections::HashSet;
use chrono::{DateTime, Utc};
use crate::{ clients::{self, Error, esi, esi::scopes, eve_image, eve_sso::Grant}, store::{ Database, images, model::{Alliance, Bloodline, Character, Corporation, Credential, Faction, OwnerType, Race}, repo::{character, infra, org, sde}, }, sync::{ job::{JobCtx, JobKey, JobKind}, jobs::resolve::resolve_item_type, subject::Subject, },};
const CONSTELLATION_ID_FLOOR: i64 = 20_000_000;const REGION_ID_FLOOR: i64 = 10_000_000;const SOLAR_SYSTEM_ID_CEIL: i64 = 32_000_000;const SOLAR_SYSTEM_ID_FLOOR: i64 = 30_000_000;const STRUCTURE_ID_FLOOR: i64 = 1_000_000_000_000;
enum StructureOutcome { Inaccessible, Resolved, Unattempted,}
pub async fn resolve_stockpile_location( db: &Database, esi: &esi::Client, image: &eve_image::Client, image_store: &images::Store, grant: &Grant, location_id: i64,) -> Result<(), Error> { if (SOLAR_SYSTEM_ID_FLOOR..SOLAR_SYSTEM_ID_CEIL).contains(&location_id) { return Ok(()); } let ctx = JobCtx { db, esi, image, image_store, key: JobKey::new(JobKind::AssetSync, Subject::Character(*grant.character_id())), grant: Some(grant), sso: None, }; if (REGION_ID_FLOOR..CONSTELLATION_ID_FLOOR).contains(&location_id) { return resolve_region(&ctx, location_id).await; } if (CONSTELLATION_ID_FLOOR..SOLAR_SYSTEM_ID_FLOOR).contains(&location_id) { return resolve_constellation(&ctx, location_id).await; } if location_id >= STRUCTURE_ID_FLOOR { resolve_asset_references(&ctx, &[], &[], &[location_id]).await } else { resolve_asset_references(&ctx, &[], &[location_id], &[]).await }}
/// Splits raw location ids into stations and structures on the structure-id floor and resolves/// both, so a sync that only stores a `location_id` still earns a name for it.////// Best-effort by design: a structure the subject cannot dock at is recorded in/// `inaccessible_structures` and costs nothing but a name, so it must never fail the calling job.pub async fn resolve_location_ids(ctx: &JobCtx<'_>, location_ids: &[i64]) { let mut seen = HashSet::new(); let mut stations = Vec::new(); let mut structures = Vec::new(); for &location_id in location_ids { if location_id == 0 || !seen.insert(location_id) { continue; } if location_id >= STRUCTURE_ID_FLOOR { structures.push(location_id); } else { stations.push(location_id); } }
if let Err(error) = resolve_asset_references(ctx, &[], &stations, &structures).await { tracing::warn!(job = ?ctx.key.kind, "location resolution failed: {error}"); }}
pub async fn resolve_asset_references( ctx: &JobCtx<'_>, type_ids: &[i64], station_ids: &[i64], structure_ids: &[i64],) -> Result<(), Error> { for &type_id in type_ids { resolve_item_type(ctx, type_id).await?; }
for &station_id in station_ids { match resolve_station(ctx, station_id).await { Ok(()) => {} Err(Error::Http(error)) if is_access_miss(&error) => { tracing::warn!(station_id, "station not resolvable (403/404); leaving name unresolved"); } Err(error) => return Err(error), } }
if structure_ids.is_empty() { return Ok(()); } let Some(grant) = ctx.grant else { tracing::debug!("asset subject has no grant; leaving structure names unresolved"); return Ok(()); }; let (owner_id, owner_type) = match ctx.key.subject { Subject::Character(id) => (id, OwnerType::Character), Subject::Corporation(id) => (id, OwnerType::Corporation), }; let candidates = structure_grant_candidates(ctx, grant).await; for &structure_id in structure_ids { match load_bearing_pos_code(ctx, &candidates, owner_id, owner_type, structure_id).await? { StructureOutcome::Resolved | StructureOutcome::Unattempted => {} StructureOutcome::Inaccessible => { sde::mark_inaccessible_structure(ctx.db, owner_id, owner_type, structure_id).await?; } } } Ok(())}
/// Resolves a single POS (Player-Owned Structure) id to a persisted structure, the keystone every/// location id in the asset/killmail naming pipeline funnels through. The name is load-bearing in/// both senses: it names load-bearing POS code, and if this path misbehaves the FK cascade in/// `resolve_owner_corporation` leaves the structure unresolved and `AssetSync` never completes for/// any subject holding assets there.async fn load_bearing_pos_code( ctx: &JobCtx<'_>, candidates: &[Grant], owner_id: i64, owner_type: OwnerType, structure_id: i64,) -> Result<StructureOutcome, Error> { if sde::get_structure(ctx.db, structure_id).await?.is_some() { return Ok(StructureOutcome::Resolved); } if sde::is_structure_inaccessible(ctx.db, owner_id, owner_type, structure_id).await? { // Already recorded inaccessible for this subject; treat as done rather than re-attempting or re-marking it. return Ok(StructureOutcome::Resolved); } if candidates.is_empty() { return Ok(StructureOutcome::Unattempted); } attempt_structure_candidates(ctx, candidates, structure_id).await}
async fn attempt_structure_candidates( ctx: &JobCtx<'_>, candidates: &[Grant], structure_id: i64,) -> Result<StructureOutcome, Error> { for grant in candidates { match ctx.esi.universe().structure(structure_id, grant).await { Ok(structure) => { resolve_owner_corporation(ctx, structure.owner_id).await?; resolve_solar_system(ctx, structure.solar_system_id).await?; if let Some(type_id) = structure.type_id { resolve_item_type(ctx, i64::from(type_id)).await?; } sde::upsert_structure(ctx.db, &(structure_id, structure).into()).await?; return Ok(StructureOutcome::Resolved); } Err(clients::Error::Http(error)) if is_access_miss(&error) => { tracing::warn!( structure_id, "structure not accessible via a candidate grant (403/404); trying remaining grants" ); } Err(error) => return Err(error), } } tracing::warn!( structure_id, "structure not accessible to any scoped grant; recording as unresolvable" ); Ok(StructureOutcome::Inaccessible)}
/// Scoped grants to try resolving a structure with, in priority order: `subject_grant` first (if it carries/// `UNIVERSE_STRUCTURES`), then other characters' scoped, non-reauth credentials, with the corporation's/// authorizing character sorted ahead of the rest.async fn structure_grant_candidates(ctx: &JobCtx<'_>, subject_grant: &Grant) -> Vec<Grant> { let mut seen: HashSet<i64> = HashSet::new(); let mut candidates: Vec<Grant> = Vec::new(); if subject_grant.has_scope(scopes::UNIVERSE_STRUCTURES) { seen.insert(*subject_grant.character_id()); candidates.push(subject_grant.clone()); }
let Ok(credentials) = infra::all(ctx.db).await else { return candidates; }; let preferred = corp_authorizing_character(&credentials, ctx.key.subject);
let mut others: Vec<Grant> = Vec::new(); for credential in &credentials { if credential.owner_type() != OwnerType::Character || credential.needs_reauth() || !credential_has_scope(credential, scopes::UNIVERSE_STRUCTURES) || !seen.insert(credential.owner_id()) { continue; } others.push(grant_from_credential(credential)); } others.sort_by_key(|grant| usize::from(Some(*grant.character_id()) != preferred)); candidates.extend(others); candidates}
fn corp_authorizing_character(credentials: &[Credential], subject: Subject) -> Option<i64> { let Subject::Corporation(corp_id) = subject else { return None; }; credentials .iter() .find(|credential| credential.owner_type() == OwnerType::Corporation && credential.owner_id() == corp_id) .and_then(Credential::authorized_by)}
fn credential_has_scope(credential: &Credential, scope: &str) -> bool { credential .scopes() .as_deref() .is_some_and(|scopes| scopes.split_whitespace().any(|granted| granted == scope))}
/// Builds a `Grant` from a stored credential as-is, with no expiry check or refresh.////// An expired candidate's token 401s, which propagates as a hard error here — only a 403/404 (access denied)/// falls through to try the next candidate in `attempt_structure_candidates`.fn grant_from_credential(credential: &Credential) -> Grant { let expires_at = DateTime::from_timestamp(credential.expires_at(), 0).unwrap_or_else(Utc::now); let scopes = credential .scopes() .as_deref() .map(|granted| granted.split_whitespace().map(str::to_owned).collect()) .unwrap_or_default(); Grant::from_stored( credential.access_token(), credential.owner_id(), expires_at, credential.refresh_token(), scopes, )}
fn is_access_miss(error: &reqwest::Error) -> bool { matches!( error.status(), Some(reqwest::StatusCode::FORBIDDEN | reqwest::StatusCode::NOT_FOUND) )}
fn is_unfetchable_character(error: &reqwest::Error) -> bool { matches!( error.status(), Some(reqwest::StatusCode::NOT_FOUND | reqwest::StatusCode::UNPROCESSABLE_ENTITY) )}
async fn resolve_station(ctx: &JobCtx<'_>, station_id: i64) -> Result<(), Error> { if sde::get_station(ctx.db, station_id).await?.is_some() { return Ok(()); } let station = ctx.esi.universe().station(station_id).await?; resolve_item_type(ctx, i64::from(station.type_id)).await?; if let Some(owner_id) = station.owner { resolve_owner_corporation(ctx, owner_id).await?; } if let Some(race_id) = station.race_id { resolve_race(ctx, i64::from(race_id)).await?; } let system = ctx.esi.universe().solar_system(station.system_id).await?; let constellation = ctx.esi.universe().constellation(system.constellation_id).await?; let region = ctx.esi.universe().region(constellation.region_id).await?; sde::insert_station_with_geography( ctx.db, &station.into(), &system.into(), &constellation.into(), ®ion.into(), ) .await?; Ok(())}
pub async fn resolve_constellation(ctx: &JobCtx<'_>, constellation_id: i64) -> Result<(), Error> { if sde::get_constellation(ctx.db, constellation_id).await?.is_some() { return Ok(()); } let constellation = ctx.esi.universe().constellation(constellation_id).await?; resolve_region(ctx, constellation.region_id).await?; sde::upsert_constellation(ctx.db, &constellation.into()).await?; Ok(())}
pub async fn resolve_region(ctx: &JobCtx<'_>, region_id: i64) -> Result<(), Error> { if sde::get_region(ctx.db, region_id).await?.is_some() { return Ok(()); } let region = ctx.esi.universe().region(region_id).await?; sde::upsert_region(ctx.db, ®ion.into()).await?; Ok(())}
pub async fn resolve_solar_system(ctx: &JobCtx<'_>, system_id: i64) -> Result<(), Error> { if sde::get_solar_system(ctx.db, system_id).await?.is_some() { return Ok(()); } let system = ctx.esi.universe().solar_system(system_id).await?; let constellation = ctx.esi.universe().constellation(system.constellation_id).await?; let region = ctx.esi.universe().region(constellation.region_id).await?; sde::upsert_region(ctx.db, ®ion.into()).await?; sde::upsert_constellation(ctx.db, &constellation.into()).await?; sde::upsert_solar_system(ctx.db, &system.into()).await?; Ok(())}
pub(crate) async fn resolve_owner_corporation(ctx: &JobCtx<'_>, owner_id: i64) -> Result<(), Error> { if org::get_corporation(ctx.db, owner_id).await?.is_some() { return Ok(()); } let info = ctx.esi.corporation().info(owner_id).await?; let alliance_id = info.alliance_id; let faction_id = info.faction_id; let ceo_id = info.ceo_id; let corporation = Corporation::from((owner_id, info));
// NPC corporations report ceo_id = 1 (EVE's "nobody"); GET /characters/1/ answers 422. A real // CEO who has been biomassed answers 404. In either case persist the corporation without a CEO // so station/structure owner names still resolve, instead of aborting the whole sync. let ceo_info = match ctx.esi.character().public_info(ceo_id).await { Ok(ceo_info) => ceo_info, Err(Error::Http(error)) if is_unfetchable_character(&error) => { if let Some(id) = corporation.alliance_id() { ensure_alliance(ctx, id).await?; } org::upsert_corporation(ctx.db, &corporation).await?; return Ok(()); } Err(error) => return Err(error), }; let race_id = ceo_info.race_id; let bloodline_id = ceo_info.bloodline_id; let ceo = Character::from((ceo_id, ceo_info));
let alliance = match alliance_id { Some(id) => Some(Alliance::from((id, ctx.esi.alliance().info(id).await?))), None => None, }; let faction = match faction_id { Some(id) => Some(resolve_faction(ctx, id).await?), None => None, }; // The CEO carries its own alliance/faction, which can differ from the corporation's (or exist when // the corp has none). upsert_with_org only persists the corp-side rows, so resolve the CEO's ends // too or the non-deferrable characters.alliance_id/faction_id FKs fail at commit. if let Some(id) = ceo.alliance_id() { ensure_alliance(ctx, id).await?; } if let Some(id) = ceo.faction_id() { ensure_faction(ctx, id).await?; } // The reference CEO's own corporation can differ from the corp being resolved — NPC megacorp // CEO-agents commonly belong to other NPC corps. upsert_with_org inserts only this owner corp, so // ensure the CEO's corp row exists too or the deferred characters.corporation_id FK fails at // commit and AssetSync never completes for any toon holding assets in such a station/structure. if ceo.corporation_id() != owner_id { ensure_corporation_present(ctx, ceo.corporation_id()).await?; } let race = resolve_race_model(ctx, i64::from(race_id)).await?; let bloodline = resolve_bloodline(ctx, i64::from(bloodline_id)).await?;
character::upsert_with_org( ctx.db, &ceo, &bloodline, &race, &corporation, alliance.as_ref(), faction.as_ref(), ) .await?; Ok(())}
pub(crate) async fn ensure_alliance(ctx: &JobCtx<'_>, alliance_id: i64) -> Result<(), Error> { if org::get_alliance(ctx.db, alliance_id).await?.is_some() { return Ok(()); } let alliance = Alliance::from((alliance_id, ctx.esi.alliance().info(alliance_id).await?)); org::upsert_alliance(ctx.db, &alliance).await?; Ok(())}
// Resolve a full characters row for an untracked id, ensuring its corp/alliance/faction/race/// bloodline rows first — the characters table's alliance_id/faction_id FKs are non-deferrable, so// they must already exist when upsert_with_org commits (mirrors the CEO resolution above). A char// ESI can't fetch (404 biomassed / 422 invalid id) is tolerated as a no-op rather than aborting.pub(crate) async fn ensure_character_present(ctx: &JobCtx<'_>, character_id: i64) -> Result<(), Error> { if character::get(ctx.db, character_id).await?.is_some() { return Ok(()); } let info = match ctx.esi.character().public_info(character_id).await { Ok(info) => info, Err(Error::Http(error)) if is_unfetchable_character(&error) => return Ok(()), Err(error) => return Err(error), }; let race_id = info.race_id; let bloodline_id = info.bloodline_id; let character = Character::from((character_id, info));
let corporation = Corporation::from(( character.corporation_id(), ctx.esi.corporation().info(character.corporation_id()).await?, )); if let Some(id) = corporation.alliance_id() { ensure_alliance(ctx, id).await?; } if let Some(id) = character.alliance_id() { ensure_alliance(ctx, id).await?; } if let Some(id) = character.faction_id() { ensure_faction(ctx, id).await?; } let race = resolve_race_model(ctx, i64::from(race_id)).await?; let bloodline = resolve_bloodline(ctx, i64::from(bloodline_id)).await?;
character::upsert_with_org(ctx.db, &character, &bloodline, &race, &corporation, None, None).await?; Ok(())}
// Persist a corporation as a bare row (plus its alliance, the only org FK on the corporations// table) without recursing into its own CEO. corporations.ceo_id/creator_id/home_station_id are// plain integers with no FK, so a corp row alone satisfies a referencing characters.corporation_id,// which bounds the work to one extra (cache-friendly) ESI corp fetch and avoids CEO-of-CEO cycles.pub(crate) async fn ensure_corporation_present(ctx: &JobCtx<'_>, corporation_id: i64) -> Result<(), Error> { if let Some(existing) = org::get_corporation(ctx.db, corporation_id).await? { // A leftover corp row from a removed character can reference an alliance that's since been // deleted; re-seed it and re-upsert so the deferred alliance_id FK doesn't 787 at commit. if let Some(alliance_id) = existing.alliance_id() && org::get_alliance(ctx.db, alliance_id).await?.is_none() { ensure_alliance(ctx, alliance_id).await?; org::upsert_corporation(ctx.db, &existing).await?; } return Ok(()); } let corporation = Corporation::from((corporation_id, ctx.esi.corporation().info(corporation_id).await?)); if let Some(id) = corporation.alliance_id() { ensure_alliance(ctx, id).await?; } org::upsert_corporation(ctx.db, &corporation).await?; Ok(())}
async fn ensure_faction(ctx: &JobCtx<'_>, faction_id: i64) -> Result<(), Error> { if sde::get_faction(ctx.db, faction_id).await?.is_some() { return Ok(()); } let faction = resolve_faction(ctx, faction_id).await?; sde::upsert_faction(ctx.db, &faction).await?; Ok(())}
async fn resolve_race(ctx: &JobCtx<'_>, race_id: i64) -> Result<(), Error> { if sde::get_race(ctx.db, race_id).await?.is_some() { return Ok(()); } let race = resolve_race_model(ctx, race_id).await?; sde::upsert_race(ctx.db, &race).await?; Ok(())}
async fn resolve_race_model(ctx: &JobCtx<'_>, race_id: i64) -> Result<Race, Error> { if let Some(race) = sde::get_race(ctx.db, race_id).await? { return Ok(race); } let lookup_id = i32::try_from(race_id).map_err(|_| Error::Internal(format!("race id {race_id} out of range for ESI lookup")))?; ctx .esi .races() .list() .await? .into_iter() .find(|race| race.race_id == lookup_id) .map(Race::from) .ok_or_else(|| Error::Internal(format!("race {race_id} not in /universe/races")))}
async fn resolve_faction(ctx: &JobCtx<'_>, faction_id: i64) -> Result<Faction, Error> { if let Some(faction) = sde::get_faction(ctx.db, faction_id).await? { return Ok(faction); } ctx .esi .faction() .list() .await? .into_iter() .find(|faction| faction.faction_id == faction_id) .map(Faction::from) .ok_or_else(|| Error::Internal(format!("faction {faction_id} not in /universe/factions")))}
async fn resolve_bloodline(ctx: &JobCtx<'_>, bloodline_id: i64) -> Result<Bloodline, Error> { if let Some(bloodline) = sde::get_bloodline(ctx.db, bloodline_id).await? { return Ok(bloodline); } let lookup_id = i32::try_from(bloodline_id) .map_err(|_| Error::Internal(format!("bloodline id {bloodline_id} out of range for ESI lookup")))?; ctx .esi .bloodlines() .list() .await? .into_iter() .find(|bloodline| bloodline.bloodline_id == lookup_id) .map(Bloodline::from) .ok_or_else(|| Error::Internal(format!("bloodline {bloodline_id} not in /universe/bloodlines")))}
#[cfg(test)]mod tests { use std::sync::Arc;
use wiremock::{ Mock, MockServer, ResponseTemplate, matchers::{method, path}, };
use super::*; use crate::{ clients::{esi, eve_image, http}, store::{ self, images, model::{Alliance, Constellation, Gender, Region, SolarSystem}, repo::sde, }, sync::job::{JobKey, JobKind}, };
const STRUCTURE_ID: i64 = 1_021_000_000_000;
const STATION_ID: i64 = 60_003_760;
const SYSTEM_ID: i64 = 30_000_142;
const CONSTELLATION_ID: i64 = 20_000_020;
const REGION_ID: i64 = 10_000_002;
const OWNER_CORP_ID: i64 = 1_000_035;
struct Harness { db: store::Database, esi: Arc<esi::Client>, image: eve_image::Client, image_store: images::Store, _images_dir: tempfile::TempDir, }
impl Harness { async fn new(base_url: &str) -> Self { let db = store::open_test().await.unwrap(); let http = http::Client::builder(http::Cache::new(db.clone())).build(); let esi = Arc::new(esi::Client::with_base_url(http.clone(), base_url.to_owned())); let image = eve_image::Client::with_base_url(http.clone(), base_url.to_owned()); let images_dir = tempfile::tempdir().unwrap(); let image_store = images::Store::new(images_dir.path().to_path_buf()); Self { db, esi, image, image_store, _images_dir: images_dir, } } }
fn ctx_with<'a>(harness: &'a Harness, grant: Option<&'a Grant>, subject: Subject) -> JobCtx<'a> { JobCtx { db: &harness.db, esi: &harness.esi, image: &harness.image, image_store: &harness.image_store, key: JobKey::new(JobKind::AssetSync, subject), grant, sso: None, } }
async fn seed_character(db: &store::Database, id: i64) { let alliance_id = 99_000_001; let alliance = Alliance::new(alliance_id, OWNER_CORP_ID, id, "2003-01-01", "Test Alliance", "TST"); let race = Race::new(2, alliance_id, "A race.", "Caldari"); let mut corp = Corporation::new(OWNER_CORP_ID, "Test Corp", "TSC"); corp.set_ceo_id(id); corp.set_creator_id(id); corp.set_member_count(1); corp.set_tax_rate(0.0); let bloodline = Bloodline::new(1, OWNER_CORP_ID, 2, 3, "A bloodline.", 4, 5, "Civire", 4, 4); let character = Character::new(id, 1, OWNER_CORP_ID, 2, "2003-05-12", Gender::Male, "Pilot"); character::insert_with_org(db, &character, &bloodline, &race, &corp, Some(&alliance), None) .await .unwrap(); }
async fn seed_geography(db: &store::Database) { sde::upsert_region( db, &Region { description: None, id: REGION_ID, name: "The Forge".to_owned(), }, ) .await .unwrap(); sde::upsert_constellation( db, &Constellation { id: CONSTELLATION_ID, name: "Kimotoro".to_owned(), position_x: 0.0, position_y: 0.0, position_z: 0.0, region_id: REGION_ID, }, ) .await .unwrap(); sde::upsert_solar_system( db, &SolarSystem { constellation_id: CONSTELLATION_ID, id: SYSTEM_ID, name: "Jita".to_owned(), position_x: 0.0, position_y: 0.0, position_z: 0.0, security_class: None, security_status: 0.9, star_id: None, }, ) .await .unwrap(); }
async fn mount_structure_ok(server: &MockServer, expected: u64) { Mock::given(method("GET")) .and(path(format!("/universe/structures/{STRUCTURE_ID}/"))) .respond_with(ResponseTemplate::new(200).set_body_json(serde_json::json!({ "name": "A Player Structure", "owner_id": OWNER_CORP_ID, "solar_system_id": SYSTEM_ID, }))) .expect(expected) .mount(server) .await; }
fn scoped_grant() -> Grant { Grant::new_test_with_scopes("structure-token", 100, vec![scopes::UNIVERSE_STRUCTURES.to_owned()]) }
async fn mount_npc_station(server: &MockServer) { Mock::given(method("GET")) .and(path(format!("/universe/stations/{STATION_ID}/"))) .respond_with(ResponseTemplate::new(200).set_body_json(serde_json::json!({ "max_dockable_ship_volume": 50_000_000.0, "name": "Jita IV - Moon 4 - Caldari Navy Assembly Plant", "office_rental_cost": 10_000.0, "position": { "x": 1.0, "y": 2.0, "z": 3.0 }, "reprocessing_efficiency": 0.5, "reprocessing_stations_take": 0.05, "services": [], "station_id": STATION_ID, "system_id": SYSTEM_ID, "type_id": 1529, }))) .mount(server) .await; mount_item_type(server).await; Mock::given(method("GET")) .and(path(format!("/universe/systems/{SYSTEM_ID}/"))) .respond_with(ResponseTemplate::new(200).set_body_json(serde_json::json!({ "constellation_id": CONSTELLATION_ID, "name": "Jita", "position": { "x": 1.0, "y": 2.0, "z": 3.0 }, "security_status": 0.946, "system_id": SYSTEM_ID, }))) .mount(server) .await; Mock::given(method("GET")) .and(path(format!("/universe/constellations/{CONSTELLATION_ID}/"))) .respond_with(ResponseTemplate::new(200).set_body_json(serde_json::json!({ "constellation_id": CONSTELLATION_ID, "name": "Kimotoro", "position": { "x": 1.0, "y": 2.0, "z": 3.0 }, "region_id": REGION_ID, "systems": [SYSTEM_ID], }))) .mount(server) .await; Mock::given(method("GET")) .and(path(format!("/universe/regions/{REGION_ID}/"))) .respond_with(ResponseTemplate::new(200).set_body_json(serde_json::json!({ "constellations": [CONSTELLATION_ID], "description": "The Forge.", "name": "The Forge", "region_id": REGION_ID, }))) .mount(server) .await; }
async fn mount_item_type(server: &MockServer) { Mock::given(method("GET")) .and(path("/universe/types/1529/")) .respond_with(ResponseTemplate::new(200).set_body_json(serde_json::json!({ "description": "A station.", "group_id": 15, "name": "Caldari Station", "published": true, "type_id": 1529, }))) .mount(server) .await; Mock::given(method("GET")) .and(path("/universe/groups/15/")) .respond_with(ResponseTemplate::new(200).set_body_json(serde_json::json!({ "category_id": 3, "group_id": 15, "name": "Station", "published": true, "types": [1529], }))) .mount(server) .await; Mock::given(method("GET")) .and(path("/universe/categories/3/")) .respond_with(ResponseTemplate::new(200).set_body_json(serde_json::json!({ "category_id": 3, "groups": [15], "name": "Station", "published": true, }))) .mount(server) .await; }
async fn mount_owner_corporation_stack(server: &MockServer) { Mock::given(method("GET")) .and(path(format!("/corporations/{OWNER_CORP_ID}/"))) .respond_with(ResponseTemplate::new(200).set_body_json(serde_json::json!({ "ceo_id": 3_004_029, "creator_id": 3_004_029, "member_count": 10_000, "name": "Caldari Navy", "tax_rate": 0.0, "ticker": "CN", }))) .mount(server) .await; Mock::given(method("GET")) .and(path("/characters/3004029/")) .respond_with(ResponseTemplate::new(200).set_body_json(serde_json::json!({ "birthday": "2003-01-01T00:00:00Z", "bloodline_id": 5, "corporation_id": OWNER_CORP_ID, "gender": "male", "name": "Caldari Navy CEO", "race_id": 1, }))) .mount(server) .await; Mock::given(method("GET")) .and(path("/universe/races/")) .respond_with(ResponseTemplate::new(200).set_body_json(serde_json::json!([ { "alliance_id": 500_001, "description": "The Caldari.", "name": "Caldari", "race_id": 1 }, ]))) .mount(server) .await; Mock::given(method("GET")) .and(path("/universe/bloodlines/")) .respond_with(ResponseTemplate::new(200).set_body_json(serde_json::json!([ { "bloodline_id": 5, "charisma": 6, "corporation_id": OWNER_CORP_ID, "description": "The Civire.", "intelligence": 7, "memory": 5, "name": "Civire", "perception": 5, "race_id": 1, "ship_type_id": 601, "willpower": 5 }, ]))) .mount(server) .await; }
fn ctx_no_grant<'a>(harness: &'a Harness) -> JobCtx<'a> { ctx_with(harness, None, Subject::Character(0)) }
mod ensure_corporation_present { use super::*;
const STALE_CORP_ID: i64 = 98_000_001;
const STALE_ALLIANCE_ID: i64 = 99_000_009;
async fn seed_stale_corp_with_dangling_alliance(db: &store::Database) { let alliance = Alliance::new( STALE_ALLIANCE_ID, STALE_CORP_ID, 1, "2003-01-01", "Gone Alliance", "GONE", ); org::upsert_alliance(db, &alliance).await.unwrap(); let mut corp = Corporation::new(STALE_CORP_ID, "Stale Corp", "STAL"); corp.set_alliance_id(STALE_ALLIANCE_ID); corp.set_ceo_id(1); corp.set_creator_id(1); corp.set_member_count(1); corp.set_tax_rate(0.0); org::upsert_corporation(db, &corp).await.unwrap(); sqlx::query("PRAGMA foreign_keys = OFF") .execute(db.writer()) .await .unwrap(); sqlx::query("DELETE FROM alliances WHERE id = ?") .bind(STALE_ALLIANCE_ID) .execute(db.writer()) .await .unwrap(); sqlx::query("PRAGMA foreign_keys = ON") .execute(db.writer()) .await .unwrap(); }
#[tokio::test] async fn it_leaves_a_present_corp_untouched_when_its_alliance_is_intact() { let server = MockServer::start().await; let harness = Harness::new(&server.uri()).await; seed_character(&harness.db, 100).await; let ctx = ctx_no_grant(&harness);
ensure_corporation_present(&ctx, OWNER_CORP_ID) .await .expect("a present corp with a live alliance needs no ESI and no re-upsert");
assert!( org::get_corporation(&harness.db, OWNER_CORP_ID) .await .unwrap() .is_some() ); }
#[tokio::test] async fn it_re_seeds_a_dangling_alliance_on_a_present_corp_without_refetching_it() { let server = MockServer::start().await; Mock::given(method("GET")) .and(path(format!("/alliances/{STALE_ALLIANCE_ID}/"))) .respond_with(ResponseTemplate::new(200).set_body_json(serde_json::json!({ "creator_corporation_id": STALE_CORP_ID, "creator_id": 1, "date_founded": "2003-01-01T00:00:00Z", "executor_corporation_id": STALE_CORP_ID, "name": "Gone Alliance", "ticker": "GONE", }))) .mount(&server) .await; Mock::given(method("GET")) .and(path(format!("/corporations/{STALE_CORP_ID}/"))) .respond_with(ResponseTemplate::new(200)) .expect(0) .mount(&server) .await; let harness = Harness::new(&server.uri()).await; seed_stale_corp_with_dangling_alliance(&harness.db).await; let ctx = ctx_no_grant(&harness);
ensure_corporation_present(&ctx, STALE_CORP_ID) .await .expect("a present-but-stale corp re-seeds its alliance instead of 787-ing at commit");
assert!( org::get_alliance(&harness.db, STALE_ALLIANCE_ID) .await .unwrap() .is_some(), "the dangling alliance_id is re-seeded so the deferred FK holds" ); assert!( org::get_corporation(&harness.db, STALE_CORP_ID) .await .unwrap() .is_some(), "the stale corp row is preserved, never deleted" ); } }
mod resolve_asset_references { use pretty_assertions::assert_eq; use wiremock::matchers::header;
use super::*;
#[tokio::test] async fn it_leaves_a_structure_unmarked_without_the_structures_scope() { let server = MockServer::start().await; Mock::given(method("GET")) .and(path(format!("/universe/structures/{STRUCTURE_ID}/"))) .respond_with(ResponseTemplate::new(200)) .expect(0) .mount(&server) .await; let harness = Harness::new(&server.uri()).await; let grant = Grant::new_test("no-scope-token", 100); let ctx = ctx_with(&harness, Some(&grant), Subject::Character(100));
resolve_asset_references(&ctx, &[], &[], &[STRUCTURE_ID]).await.unwrap();
assert!(sde::get_structure(&harness.db, STRUCTURE_ID).await.unwrap().is_none()); assert!( !sde::is_structure_inaccessible(&harness.db, 100, OwnerType::Character, STRUCTURE_ID) .await .unwrap(), "without the scope the id stays unmarked, so a later re-auth can still resolve it" ); }
#[tokio::test] async fn it_marks_an_inaccessible_structure_for_the_owning_character() { let server = MockServer::start().await; Mock::given(method("GET")) .and(path(format!("/universe/structures/{STRUCTURE_ID}/"))) .respond_with(ResponseTemplate::new(403)) .mount(&server) .await; let harness = Harness::new(&server.uri()).await; let grant = scoped_grant(); let ctx = ctx_with(&harness, Some(&grant), Subject::Character(100));
resolve_asset_references(&ctx, &[], &[], &[STRUCTURE_ID]).await.unwrap();
assert!( sde::is_structure_inaccessible(&harness.db, 100, OwnerType::Character, STRUCTURE_ID) .await .unwrap(), "a 403 structure is marked inaccessible for the owner" ); assert!( sde::get_structure(&harness.db, STRUCTURE_ID).await.unwrap().is_none(), "an inaccessible structure leaves no cache row" ); }
#[tokio::test] async fn it_marks_an_inaccessible_structure_per_subject_for_a_corporation() { let server = MockServer::start().await; Mock::given(method("GET")) .and(path(format!("/universe/structures/{STRUCTURE_ID}/"))) .respond_with(ResponseTemplate::new(404)) .mount(&server) .await; let harness = Harness::new(&server.uri()).await; let grant = scoped_grant(); let ctx = ctx_with(&harness, Some(&grant), Subject::Corporation(OWNER_CORP_ID));
resolve_asset_references(&ctx, &[], &[], &[STRUCTURE_ID]).await.unwrap();
assert!( sde::is_structure_inaccessible(&harness.db, OWNER_CORP_ID, OwnerType::Corporation, STRUCTURE_ID) .await .unwrap(), "the mark is keyed to the corporation subject" ); assert!( !sde::is_structure_inaccessible(&harness.db, OWNER_CORP_ID, OwnerType::Character, STRUCTURE_ID) .await .unwrap(), "the character owner of the same id is unaffected" ); }
#[tokio::test] async fn it_resolves_a_referenced_item_type() { let server = MockServer::start().await; mount_item_type(&server).await; let harness = Harness::new(&server.uri()).await; let ctx = ctx_with(&harness, None, Subject::Character(100));
resolve_asset_references(&ctx, &[1529], &[], &[]).await.unwrap();
assert!( sde::get_item_type(&harness.db, 1529).await.unwrap().is_some(), "the referenced item type is resolved before persist" ); }
#[tokio::test] async fn it_resolves_a_referenced_npc_station() { let server = MockServer::start().await; mount_npc_station(&server).await; let harness = Harness::new(&server.uri()).await; let ctx = ctx_with(&harness, None, Subject::Character(100));
resolve_asset_references(&ctx, &[], &[STATION_ID], &[]).await.unwrap();
let station = sde::get_station(&harness.db, STATION_ID) .await .unwrap() .expect("the NPC station is cached"); assert_eq!(station.name(), "Jita IV - Moon 4 - Caldari Navy Assembly Plant"); }
#[tokio::test] async fn it_resolves_and_caches_a_structure() { let server = MockServer::start().await; mount_structure_ok(&server, 1).await; let harness = Harness::new(&server.uri()).await; seed_character(&harness.db, 100).await; seed_geography(&harness.db).await; let grant = scoped_grant(); let ctx = ctx_with(&harness, Some(&grant), Subject::Character(100));
resolve_asset_references(&ctx, &[], &[], &[STRUCTURE_ID]).await.unwrap();
let structure = sde::get_structure(&harness.db, STRUCTURE_ID) .await .unwrap() .expect("the structure is cached"); assert_eq!(structure.name(), "A Player Structure"); }
#[tokio::test] async fn it_tolerates_an_inaccessible_station_without_erroring() { let server = MockServer::start().await; Mock::given(method("GET")) .and(path(format!("/universe/stations/{STATION_ID}/"))) .respond_with(ResponseTemplate::new(404)) .mount(&server) .await; let harness = Harness::new(&server.uri()).await; let ctx = ctx_with(&harness, None, Subject::Character(100));
resolve_asset_references(&ctx, &[], &[STATION_ID], &[]).await.unwrap();
assert!( sde::get_station(&harness.db, STATION_ID).await.unwrap().is_none(), "a 403/404 station is left unresolved, not fatal" ); }
async fn seed_scoped_credential(db: &store::Database, character_id: i64, access_token: &str) { infra::upsert( db, character_id, OwnerType::Character, access_token, "refresh", i64::MAX / 2, None, Some(scopes::UNIVERSE_STRUCTURES), ) .await .unwrap(); }
async fn mount_structure_for_token(server: &MockServer, token: &str, status: u16) { let response = if status == 200 { ResponseTemplate::new(200).set_body_json(serde_json::json!({ "name": "A Player Structure", "owner_id": OWNER_CORP_ID, "solar_system_id": SYSTEM_ID, })) } else { ResponseTemplate::new(status) }; Mock::given(method("GET")) .and(path(format!("/universe/structures/{STRUCTURE_ID}/"))) .and(header("Authorization", format!("Bearer {token}"))) .respond_with(response) .expect(1) .mount(server) .await; }
#[tokio::test] async fn it_resolves_a_corp_referenced_structure_via_a_character_grant() { let server = MockServer::start().await; mount_structure_ok(&server, 1).await; let harness = Harness::new(&server.uri()).await; seed_character(&harness.db, 100).await; seed_geography(&harness.db).await; seed_scoped_credential(&harness.db, 100, "char-token").await; let corp_grant = Grant::new_test("corp-token", OWNER_CORP_ID); let ctx = ctx_with(&harness, Some(&corp_grant), Subject::Corporation(OWNER_CORP_ID));
resolve_asset_references(&ctx, &[], &[], &[STRUCTURE_ID]).await.unwrap();
let structure = sde::get_structure(&harness.db, STRUCTURE_ID) .await .unwrap() .expect("the corp-referenced structure is resolved via a scoped character grant"); assert_eq!(structure.name(), "A Player Structure"); assert!( !sde::is_structure_inaccessible(&harness.db, OWNER_CORP_ID, OwnerType::Corporation, STRUCTURE_ID) .await .unwrap(), "a resolved structure is never marked inaccessible" ); }
#[tokio::test] async fn it_falls_through_a_denied_grant_to_a_scoped_grant_that_succeeds() { let server = MockServer::start().await; mount_structure_for_token(&server, "token-a", 403).await; mount_structure_for_token(&server, "token-b", 200).await; let harness = Harness::new(&server.uri()).await; seed_character(&harness.db, 100).await; seed_geography(&harness.db).await; infra::upsert( &harness.db, OWNER_CORP_ID, OwnerType::Corporation, "corp-token", "refresh", i64::MAX / 2, Some(100), None, ) .await .unwrap(); seed_scoped_credential(&harness.db, 100, "token-a").await; seed_scoped_credential(&harness.db, 200, "token-b").await; let corp_grant = Grant::new_test("corp-token", OWNER_CORP_ID); let ctx = ctx_with(&harness, Some(&corp_grant), Subject::Corporation(OWNER_CORP_ID));
resolve_asset_references(&ctx, &[], &[], &[STRUCTURE_ID]).await.unwrap();
assert!( sde::get_structure(&harness.db, STRUCTURE_ID).await.unwrap().is_some(), "a 403 from the first candidate does not stop the second scoped grant from resolving it" ); assert!( !sde::is_structure_inaccessible(&harness.db, OWNER_CORP_ID, OwnerType::Corporation, STRUCTURE_ID) .await .unwrap(), "a structure resolved by a later candidate is never marked inaccessible" ); }
#[tokio::test] async fn it_marks_inaccessible_only_after_every_scoped_grant_is_denied() { let server = MockServer::start().await; Mock::given(method("GET")) .and(path(format!("/universe/structures/{STRUCTURE_ID}/"))) .respond_with(ResponseTemplate::new(403)) .mount(&server) .await; let harness = Harness::new(&server.uri()).await; seed_scoped_credential(&harness.db, 100, "token-a").await; seed_scoped_credential(&harness.db, 200, "token-b").await; let corp_grant = Grant::new_test("corp-token", OWNER_CORP_ID); let ctx = ctx_with(&harness, Some(&corp_grant), Subject::Corporation(OWNER_CORP_ID));
resolve_asset_references(&ctx, &[], &[], &[STRUCTURE_ID]).await.unwrap();
assert!( sde::is_structure_inaccessible(&harness.db, OWNER_CORP_ID, OwnerType::Corporation, STRUCTURE_ID) .await .unwrap(), "every scoped grant 403ing marks the structure inaccessible for the subject" ); assert!( sde::get_structure(&harness.db, STRUCTURE_ID).await.unwrap().is_none(), "an all-denied structure leaves no cache row" ); }
#[tokio::test] async fn it_leaves_a_structure_unattempted_when_no_credential_carries_the_scope() { let server = MockServer::start().await; Mock::given(method("GET")) .and(path(format!("/universe/structures/{STRUCTURE_ID}/"))) .respond_with(ResponseTemplate::new(200)) .expect(0) .mount(&server) .await; let harness = Harness::new(&server.uri()).await; infra::upsert( &harness.db, 100, OwnerType::Character, "unscoped-token", "refresh", i64::MAX / 2, None, Some(scopes::CHARACTER_ASSETS), ) .await .unwrap(); let corp_grant = Grant::new_test("corp-token", OWNER_CORP_ID); let ctx = ctx_with(&harness, Some(&corp_grant), Subject::Corporation(OWNER_CORP_ID));
resolve_asset_references(&ctx, &[], &[], &[STRUCTURE_ID]).await.unwrap();
assert!( sde::get_structure(&harness.db, STRUCTURE_ID).await.unwrap().is_none(), "no scoped grant means no fetch attempt" ); assert!( !sde::is_structure_inaccessible(&harness.db, OWNER_CORP_ID, OwnerType::Corporation, STRUCTURE_ID) .await .unwrap(), "an unattempted structure is never marked inaccessible, so a later re-auth can still resolve it" ); } }
mod resolve_bloodline { use super::*;
#[tokio::test] async fn it_errors_when_the_bloodline_id_overflows_an_i32() { let server = MockServer::start().await; let harness = Harness::new(&server.uri()).await; let ctx = ctx_no_grant(&harness);
let result = resolve_bloodline(&ctx, i64::from(i32::MAX) + 1).await;
assert!(matches!(result, Err(Error::Internal(_)))); }
#[tokio::test] async fn it_errors_when_the_bloodline_is_absent_from_the_esi_list() { let server = MockServer::start().await; Mock::given(method("GET")) .and(path("/universe/bloodlines/")) .respond_with(ResponseTemplate::new(200).set_body_json(serde_json::json!([]))) .mount(&server) .await; let harness = Harness::new(&server.uri()).await; let ctx = ctx_no_grant(&harness);
let result = resolve_bloodline(&ctx, 5).await;
assert!(matches!(result, Err(Error::Internal(_)))); }
#[tokio::test] async fn it_fetches_a_bloodline_from_the_esi_list() { let server = MockServer::start().await; Mock::given(method("GET")) .and(path("/universe/bloodlines/")) .respond_with(ResponseTemplate::new(200).set_body_json(serde_json::json!([ { "bloodline_id": 5, "charisma": 6, "corporation_id": OWNER_CORP_ID, "description": "The Civire.", "intelligence": 7, "memory": 5, "name": "Civire", "perception": 5, "race_id": 1, "ship_type_id": 601, "willpower": 5 }, ]))) .mount(&server) .await; let harness = Harness::new(&server.uri()).await; let ctx = ctx_no_grant(&harness);
let bloodline = resolve_bloodline(&ctx, 5).await.unwrap();
assert_eq!(bloodline.name(), "Civire"); }
#[tokio::test] async fn it_short_circuits_when_the_bloodline_is_already_cached() { let server = MockServer::start().await; let harness = Harness::new(&server.uri()).await; seed_character(&harness.db, 100).await; sde::upsert_bloodline( &harness.db, &Bloodline::new(5, OWNER_CORP_ID, 2, 3, "The Civire.", 4, 5, "Civire", 4, 4), ) .await .unwrap(); let ctx = ctx_no_grant(&harness);
let bloodline = resolve_bloodline(&ctx, 5).await.unwrap();
assert_eq!(bloodline.name(), "Civire"); } }
mod resolve_faction { use super::*;
#[tokio::test] async fn it_errors_when_the_faction_is_absent_from_the_esi_list() { let server = MockServer::start().await; Mock::given(method("GET")) .and(path("/universe/factions/")) .respond_with(ResponseTemplate::new(200).set_body_json(serde_json::json!([]))) .mount(&server) .await; let harness = Harness::new(&server.uri()).await; let ctx = ctx_no_grant(&harness);
let result = resolve_faction(&ctx, 500_001).await;
assert!(matches!(result, Err(Error::Internal(_)))); }
#[tokio::test] async fn it_fetches_a_faction_from_the_esi_list() { let server = MockServer::start().await; Mock::given(method("GET")) .and(path("/universe/factions/")) .respond_with(ResponseTemplate::new(200).set_body_json(serde_json::json!([ { "corporation_id": OWNER_CORP_ID, "description": "The State.", "faction_id": 500_001, "is_unique": true, "name": "Caldari State", "size_factor": 5.0, "station_count": 100, "station_system_count": 50 }, ]))) .mount(&server) .await; let harness = Harness::new(&server.uri()).await; let ctx = ctx_no_grant(&harness);
let faction = resolve_faction(&ctx, 500_001).await.unwrap();
assert_eq!(faction.name(), "Caldari State"); }
#[tokio::test] async fn it_short_circuits_when_the_faction_is_already_cached() { let server = MockServer::start().await; let harness = Harness::new(&server.uri()).await; sde::upsert_faction(&harness.db, &Faction::new(500_001, "Caldari State", true, 5.0, 100, 50)) .await .unwrap(); let ctx = ctx_no_grant(&harness);
let faction = resolve_faction(&ctx, 500_001).await.unwrap();
assert_eq!(faction.name(), "Caldari State"); } }
mod resolve_owner_corporation { use super::*;
#[tokio::test] async fn it_ensures_the_ceos_own_corp_when_it_differs_from_the_owner_corp() { const CEO_ID: i64 = 3_004_125; const CEO_OWN_CORP_ID: i64 = 1_000_038; const CEO_OWN_CORP_CEO_ID: i64 = 3_009_999; let server = MockServer::start().await; Mock::given(method("GET")) .and(path(format!("/corporations/{OWNER_CORP_ID}/"))) .respond_with(ResponseTemplate::new(200).set_body_json(serde_json::json!({ "ceo_id": CEO_ID, "creator_id": CEO_ID, "member_count": 10_000, "name": "Ishukone", "tax_rate": 0.0, "ticker": "ISK", }))) .mount(&server) .await; Mock::given(method("GET")) .and(path(format!("/characters/{CEO_ID}/"))) .respond_with(ResponseTemplate::new(200).set_body_json(serde_json::json!({ "birthday": "2003-01-01T00:00:00Z", "bloodline_id": 5, "corporation_id": CEO_OWN_CORP_ID, "gender": "male", "name": "Mens Reppola", "race_id": 1, }))) .mount(&server) .await; Mock::given(method("GET")) .and(path(format!("/corporations/{CEO_OWN_CORP_ID}/"))) .respond_with(ResponseTemplate::new(200).set_body_json(serde_json::json!({ "ceo_id": CEO_OWN_CORP_CEO_ID, "creator_id": CEO_OWN_CORP_CEO_ID, "member_count": 5_000, "name": "Ishukone Watch", "tax_rate": 0.0, "ticker": "IWA", }))) .expect(1) .mount(&server) .await; Mock::given(method("GET")) .and(path("/universe/races/")) .respond_with(ResponseTemplate::new(200).set_body_json(serde_json::json!([ { "alliance_id": 500_001, "description": "The Caldari.", "name": "Caldari", "race_id": 1 }, ]))) .mount(&server) .await; Mock::given(method("GET")) .and(path("/universe/bloodlines/")) .respond_with(ResponseTemplate::new(200).set_body_json(serde_json::json!([ { "bloodline_id": 5, "charisma": 6, "corporation_id": OWNER_CORP_ID, "description": "The Civire.", "intelligence": 7, "memory": 5, "name": "Civire", "perception": 5, "race_id": 1, "ship_type_id": 601, "willpower": 5 }, ]))) .mount(&server) .await; let harness = Harness::new(&server.uri()).await; let ctx = ctx_no_grant(&harness);
resolve_owner_corporation(&ctx, OWNER_CORP_ID) .await .expect("the CEO's own corp row is ensured first, so resolution commits without a 787");
assert!( org::get_corporation(&harness.db, CEO_OWN_CORP_ID) .await .unwrap() .is_some(), "the CEO's own corporation is persisted as a bare row to satisfy the deferred FK" ); assert!( org::get_corporation(&harness.db, OWNER_CORP_ID) .await .unwrap() .is_some(), "the owner corporation is persisted too" ); assert!( character::get(&harness.db, CEO_ID).await.unwrap().is_some(), "the reference CEO is persisted now that its corp FK is satisfied" ); assert!( character::get(&harness.db, CEO_OWN_CORP_CEO_ID) .await .unwrap() .is_none(), "the CEO's corp is persisted corp-row-only, not recursively expanded into a CEO character" ); }
#[tokio::test] async fn it_persists_a_corp_without_a_ceo_when_the_ceo_is_not_found() { let server = MockServer::start().await; Mock::given(method("GET")) .and(path(format!("/corporations/{OWNER_CORP_ID}/"))) .respond_with(ResponseTemplate::new(200).set_body_json(serde_json::json!({ "alliance_id": 99_000_001, "ceo_id": 3_004_029, "creator_id": 3_004_029, "member_count": 10_000, "name": "Caldari Navy", "tax_rate": 0.0, "ticker": "CN", }))) .mount(&server) .await; Mock::given(method("GET")) .and(path("/characters/3004029/")) .respond_with(ResponseTemplate::new(404)) .mount(&server) .await; Mock::given(method("GET")) .and(path("/alliances/99000001/")) .respond_with(ResponseTemplate::new(200).set_body_json(serde_json::json!({ "creator_corporation_id": OWNER_CORP_ID, "creator_id": 3_004_029, "date_founded": "2003-01-01T00:00:00Z", "executor_corporation_id": OWNER_CORP_ID, "name": "Test Alliance", "ticker": "TST", }))) .mount(&server) .await; let harness = Harness::new(&server.uri()).await; let ctx = ctx_no_grant(&harness);
resolve_owner_corporation(&ctx, OWNER_CORP_ID) .await .expect("a 404 CEO is tolerated, not fatal");
assert!( org::get_corporation(&harness.db, OWNER_CORP_ID) .await .unwrap() .is_some() ); assert!( org::get_alliance(&harness.db, 99_000_001).await.unwrap().is_some(), "the corp's alliance row is ensured first so the deferred alliance_id FK holds at commit" ); assert!( character::get(&harness.db, 3_004_029).await.unwrap().is_none(), "no CEO character row is created when the CEO 404s" ); }
#[tokio::test] async fn it_persists_an_npc_corp_without_a_ceo_when_the_ceo_is_unprocessable() { let server = MockServer::start().await; Mock::given(method("GET")) .and(path(format!("/corporations/{OWNER_CORP_ID}/"))) .respond_with(ResponseTemplate::new(200).set_body_json(serde_json::json!({ "ceo_id": 1, "creator_id": 1, "member_count": 10_000, "name": "Caldari Navy", "tax_rate": 0.0, "ticker": "CN", }))) .mount(&server) .await; Mock::given(method("GET")) .and(path("/characters/1/")) .respond_with(ResponseTemplate::new(422)) .mount(&server) .await; let harness = Harness::new(&server.uri()).await; let ctx = ctx_no_grant(&harness);
resolve_owner_corporation(&ctx, OWNER_CORP_ID) .await .expect("a 422 CEO is tolerated, not fatal");
let corporation = org::get_corporation(&harness.db, OWNER_CORP_ID) .await .unwrap() .expect("the NPC owner corporation is still persisted so station names resolve"); assert_eq!(corporation.name(), "Caldari Navy"); assert!( character::get(&harness.db, 1).await.unwrap().is_none(), "no CEO character row is created for an unfetchable NPC-corp CEO" ); }
#[tokio::test] async fn it_propagates_a_non_miss_error_from_the_ceo_fetch() { let server = MockServer::start().await; Mock::given(method("GET")) .and(path(format!("/corporations/{OWNER_CORP_ID}/"))) .respond_with(ResponseTemplate::new(200).set_body_json(serde_json::json!({ "ceo_id": 3_004_029, "creator_id": 3_004_029, "member_count": 10_000, "name": "Caldari Navy", "tax_rate": 0.0, "ticker": "CN", }))) .mount(&server) .await; Mock::given(method("GET")) .and(path("/characters/3004029/")) .respond_with(ResponseTemplate::new(500)) .mount(&server) .await; let harness = Harness::new(&server.uri()).await; let ctx = ctx_no_grant(&harness);
let result = resolve_owner_corporation(&ctx, OWNER_CORP_ID).await;
assert!( result.is_err(), "a 500 CEO fetch still aborts; only 404/422 are tolerated" ); assert!( org::get_corporation(&harness.db, OWNER_CORP_ID) .await .unwrap() .is_none(), "nothing is persisted when the CEO fetch fails with an untolerated status" ); }
#[tokio::test] async fn it_resolves_the_alliance_and_faction_when_the_corporation_carries_them() { let server = MockServer::start().await; Mock::given(method("GET")) .and(path(format!("/corporations/{OWNER_CORP_ID}/"))) .respond_with(ResponseTemplate::new(200).set_body_json(serde_json::json!({ "alliance_id": 99_000_001, "ceo_id": 3_004_029, "creator_id": 3_004_029, "faction_id": 500_001, "member_count": 10_000, "name": "Caldari Navy", "tax_rate": 0.0, "ticker": "CN", }))) .mount(&server) .await; Mock::given(method("GET")) .and(path("/characters/3004029/")) .respond_with(ResponseTemplate::new(200).set_body_json(serde_json::json!({ "birthday": "2003-01-01T00:00:00Z", "bloodline_id": 5, "corporation_id": OWNER_CORP_ID, "gender": "male", "name": "Caldari Navy CEO", "race_id": 1, }))) .mount(&server) .await; Mock::given(method("GET")) .and(path("/alliances/99000001/")) .respond_with(ResponseTemplate::new(200).set_body_json(serde_json::json!({ "creator_corporation_id": OWNER_CORP_ID, "creator_id": 3_004_029, "date_founded": "2003-01-01T00:00:00Z", "executor_corporation_id": OWNER_CORP_ID, "name": "Test Alliance", "ticker": "TST", }))) .mount(&server) .await; Mock::given(method("GET")) .and(path("/universe/factions/")) .respond_with(ResponseTemplate::new(200).set_body_json(serde_json::json!([ { "corporation_id": OWNER_CORP_ID, "description": "The State.", "faction_id": 500_001, "is_unique": true, "name": "Caldari State", "size_factor": 5.0, "station_count": 100, "station_system_count": 50 }, ]))) .mount(&server) .await; Mock::given(method("GET")) .and(path("/universe/races/")) .respond_with(ResponseTemplate::new(200).set_body_json(serde_json::json!([ { "alliance_id": 500_001, "description": "The Caldari.", "name": "Caldari", "race_id": 1 }, ]))) .mount(&server) .await; Mock::given(method("GET")) .and(path("/universe/bloodlines/")) .respond_with(ResponseTemplate::new(200).set_body_json(serde_json::json!([ { "bloodline_id": 5, "charisma": 6, "corporation_id": OWNER_CORP_ID, "description": "The Civire.", "intelligence": 7, "memory": 5, "name": "Civire", "perception": 5, "race_id": 1, "ship_type_id": 601, "willpower": 5 }, ]))) .mount(&server) .await; let harness = Harness::new(&server.uri()).await; let ctx = ctx_no_grant(&harness);
resolve_owner_corporation(&ctx, OWNER_CORP_ID).await.unwrap();
assert!( org::get_corporation(&harness.db, OWNER_CORP_ID) .await .unwrap() .is_some() ); assert!(org::get_alliance(&harness.db, 99_000_001).await.unwrap().is_some()); assert!(sde::get_faction(&harness.db, 500_001).await.unwrap().is_some()); }
#[tokio::test] async fn it_resolves_the_ceos_own_alliance_and_faction_when_the_corp_carries_neither() { let server = MockServer::start().await; Mock::given(method("GET")) .and(path(format!("/corporations/{OWNER_CORP_ID}/"))) .respond_with(ResponseTemplate::new(200).set_body_json(serde_json::json!({ "ceo_id": 3_004_029, "creator_id": 3_004_029, "member_count": 10_000, "name": "Caldari Navy", "tax_rate": 0.0, "ticker": "CN", }))) .mount(&server) .await; Mock::given(method("GET")) .and(path("/characters/3004029/")) .respond_with(ResponseTemplate::new(200).set_body_json(serde_json::json!({ "alliance_id": 99_000_002, "birthday": "2003-01-01T00:00:00Z", "bloodline_id": 5, "corporation_id": OWNER_CORP_ID, "faction_id": 500_001, "gender": "male", "name": "Caldari Navy CEO", "race_id": 1, }))) .mount(&server) .await; Mock::given(method("GET")) .and(path("/alliances/99000002/")) .respond_with(ResponseTemplate::new(200).set_body_json(serde_json::json!({ "creator_corporation_id": OWNER_CORP_ID, "creator_id": 3_004_029, "date_founded": "2003-01-01T00:00:00Z", "executor_corporation_id": OWNER_CORP_ID, "name": "CEO Personal Alliance", "ticker": "CPA", }))) .mount(&server) .await; Mock::given(method("GET")) .and(path("/universe/factions/")) .respond_with(ResponseTemplate::new(200).set_body_json(serde_json::json!([ { "corporation_id": OWNER_CORP_ID, "description": "The State.", "faction_id": 500_001, "is_unique": true, "name": "Caldari State", "size_factor": 5.0, "station_count": 100, "station_system_count": 50 }, ]))) .mount(&server) .await; Mock::given(method("GET")) .and(path("/universe/races/")) .respond_with(ResponseTemplate::new(200).set_body_json(serde_json::json!([ { "alliance_id": 500_001, "description": "The Caldari.", "name": "Caldari", "race_id": 1 }, ]))) .mount(&server) .await; Mock::given(method("GET")) .and(path("/universe/bloodlines/")) .respond_with(ResponseTemplate::new(200).set_body_json(serde_json::json!([ { "bloodline_id": 5, "charisma": 6, "corporation_id": OWNER_CORP_ID, "description": "The Civire.", "intelligence": 7, "memory": 5, "name": "Civire", "perception": 5, "race_id": 1, "ship_type_id": 601, "willpower": 5 }, ]))) .mount(&server) .await; let harness = Harness::new(&server.uri()).await; let ctx = ctx_no_grant(&harness);
resolve_owner_corporation(&ctx, OWNER_CORP_ID) .await .expect("the CEO's own alliance and faction are resolved, so no FK violation at commit");
assert!( org::get_alliance(&harness.db, 99_000_002).await.unwrap().is_some(), "the CEO's personal alliance is persisted even though the corp has none" ); assert!( sde::get_faction(&harness.db, 500_001).await.unwrap().is_some(), "the CEO's faction is persisted even though the corp has none" ); assert!(character::get(&harness.db, 3_004_029).await.unwrap().is_some()); }
#[tokio::test] async fn it_resolves_the_full_owner_org_stack_when_uncached() { let server = MockServer::start().await; mount_owner_corporation_stack(&server).await; let harness = Harness::new(&server.uri()).await; let ctx = ctx_no_grant(&harness);
resolve_owner_corporation(&ctx, OWNER_CORP_ID).await.unwrap();
let corporation = org::get_corporation(&harness.db, OWNER_CORP_ID) .await .unwrap() .expect("the owner corporation is cached"); assert_eq!(corporation.name(), "Caldari Navy"); assert!(character::get(&harness.db, 3_004_029).await.unwrap().is_some()); assert!(sde::get_race(&harness.db, 1).await.unwrap().is_some()); assert!(sde::get_bloodline(&harness.db, 5).await.unwrap().is_some()); }
#[tokio::test] async fn it_short_circuits_when_the_corporation_is_already_cached() { let server = MockServer::start().await; let harness = Harness::new(&server.uri()).await; seed_character(&harness.db, 100).await; let ctx = ctx_no_grant(&harness);
resolve_owner_corporation(&ctx, OWNER_CORP_ID).await.unwrap();
assert!( org::get_corporation(&harness.db, OWNER_CORP_ID) .await .unwrap() .is_some() ); } }
mod resolve_race { use super::*;
#[tokio::test] async fn it_fetches_and_persists_a_race_from_the_esi_list() { let server = MockServer::start().await; Mock::given(method("GET")) .and(path("/universe/races/")) .respond_with(ResponseTemplate::new(200).set_body_json(serde_json::json!([ { "alliance_id": 500_001, "description": "The Caldari.", "name": "Caldari", "race_id": 1 }, ]))) .mount(&server) .await; let harness = Harness::new(&server.uri()).await; let ctx = ctx_no_grant(&harness);
resolve_race(&ctx, 1).await.unwrap();
let race = sde::get_race(&harness.db, 1) .await .unwrap() .expect("the race is cached"); assert_eq!(race.name(), "Caldari"); }
#[tokio::test] async fn it_short_circuits_when_the_race_is_already_cached() { let server = MockServer::start().await; let harness = Harness::new(&server.uri()).await; sde::upsert_race(&harness.db, &Race::new(1, 500_001, "The Caldari.", "Caldari")) .await .unwrap(); let ctx = ctx_no_grant(&harness);
resolve_race(&ctx, 1).await.unwrap();
assert!(sde::get_race(&harness.db, 1).await.unwrap().is_some()); } }
mod resolve_race_model { use super::*;
#[tokio::test] async fn it_errors_when_the_race_id_overflows_an_i32() { let server = MockServer::start().await; let harness = Harness::new(&server.uri()).await; let ctx = ctx_no_grant(&harness);
let result = resolve_race_model(&ctx, i64::from(i32::MAX) + 1).await;
assert!(matches!(result, Err(Error::Internal(_)))); }
#[tokio::test] async fn it_errors_when_the_race_is_absent_from_the_esi_list() { let server = MockServer::start().await; Mock::given(method("GET")) .and(path("/universe/races/")) .respond_with(ResponseTemplate::new(200).set_body_json(serde_json::json!([]))) .mount(&server) .await; let harness = Harness::new(&server.uri()).await; let ctx = ctx_no_grant(&harness);
let result = resolve_race_model(&ctx, 7).await;
assert!(matches!(result, Err(Error::Internal(_)))); } }
mod resolve_solar_system { use super::*;
#[tokio::test] async fn it_resolves_the_system_with_its_constellation_and_region_when_uncached() { let server = MockServer::start().await; Mock::given(method("GET")) .and(path(format!("/universe/systems/{SYSTEM_ID}/"))) .respond_with(ResponseTemplate::new(200).set_body_json(serde_json::json!({ "constellation_id": CONSTELLATION_ID, "name": "Jita", "position": { "x": 1.0, "y": 2.0, "z": 3.0 }, "security_status": 0.946, "system_id": SYSTEM_ID, }))) .mount(&server) .await; Mock::given(method("GET")) .and(path(format!("/universe/constellations/{CONSTELLATION_ID}/"))) .respond_with(ResponseTemplate::new(200).set_body_json(serde_json::json!({ "constellation_id": CONSTELLATION_ID, "name": "Kimotoro", "position": { "x": 1.0, "y": 2.0, "z": 3.0 }, "region_id": REGION_ID, "systems": [SYSTEM_ID], }))) .mount(&server) .await; Mock::given(method("GET")) .and(path(format!("/universe/regions/{REGION_ID}/"))) .respond_with(ResponseTemplate::new(200).set_body_json(serde_json::json!({ "constellations": [CONSTELLATION_ID], "description": "The Forge.", "name": "The Forge", "region_id": REGION_ID, }))) .mount(&server) .await; let harness = Harness::new(&server.uri()).await; let ctx = ctx_no_grant(&harness);
resolve_solar_system(&ctx, SYSTEM_ID).await.unwrap();
let system = sde::get_solar_system(&harness.db, SYSTEM_ID) .await .unwrap() .expect("the system is cached"); assert_eq!(system.name(), "Jita"); assert!( sde::get_constellation(&harness.db, CONSTELLATION_ID) .await .unwrap() .is_some() ); assert!(sde::get_region(&harness.db, REGION_ID).await.unwrap().is_some()); }
#[tokio::test] async fn it_short_circuits_when_the_system_is_already_cached() { let server = MockServer::start().await; let harness = Harness::new(&server.uri()).await; seed_geography(&harness.db).await; let ctx = ctx_no_grant(&harness);
resolve_solar_system(&ctx, SYSTEM_ID).await.unwrap();
assert!(sde::get_solar_system(&harness.db, SYSTEM_ID).await.unwrap().is_some()); } }
mod resolve_stockpile_location { use super::*;
#[tokio::test] async fn it_resolves_a_constellation_and_its_region_for_a_stockpile() { let server = MockServer::start().await; Mock::given(method("GET")) .and(path(format!("/universe/constellations/{CONSTELLATION_ID}/"))) .respond_with(ResponseTemplate::new(200).set_body_json(serde_json::json!({ "constellation_id": CONSTELLATION_ID, "name": "Kimotoro", "position": { "x": 1.0, "y": 2.0, "z": 3.0 }, "region_id": REGION_ID, "systems": [SYSTEM_ID], }))) .mount(&server) .await; Mock::given(method("GET")) .and(path(format!("/universe/regions/{REGION_ID}/"))) .respond_with(ResponseTemplate::new(200).set_body_json(serde_json::json!({ "constellations": [CONSTELLATION_ID], "description": "The Forge.", "name": "The Forge", "region_id": REGION_ID, }))) .mount(&server) .await; let harness = Harness::new(&server.uri()).await; let grant = Grant::new_test("token", 100);
resolve_stockpile_location( &harness.db, &harness.esi, &harness.image, &harness.image_store, &grant, CONSTELLATION_ID, ) .await .unwrap();
assert!( sde::get_constellation(&harness.db, CONSTELLATION_ID) .await .unwrap() .is_some(), "the picked constellation is cached" ); assert!( sde::get_region(&harness.db, REGION_ID).await.unwrap().is_some(), "its parent region is resolved too, satisfying the constellation's region FK" ); }
#[tokio::test] async fn it_resolves_a_region_picked_for_a_stockpile() { let server = MockServer::start().await; Mock::given(method("GET")) .and(path(format!("/universe/regions/{REGION_ID}/"))) .respond_with(ResponseTemplate::new(200).set_body_json(serde_json::json!({ "constellations": [CONSTELLATION_ID], "description": "The Forge.", "name": "The Forge", "region_id": REGION_ID, }))) .mount(&server) .await; let harness = Harness::new(&server.uri()).await; let grant = Grant::new_test("token", 100);
resolve_stockpile_location( &harness.db, &harness.esi, &harness.image, &harness.image_store, &grant, REGION_ID, ) .await .unwrap();
assert!( sde::get_region(&harness.db, REGION_ID).await.unwrap().is_some(), "a region chosen for a stockpile is resolved into the universe cache" ); }
#[tokio::test] async fn it_resolves_a_station_picked_for_a_stockpile() { let server = MockServer::start().await; mount_npc_station(&server).await; let harness = Harness::new(&server.uri()).await; let grant = Grant::new_test("token", 100);
resolve_stockpile_location( &harness.db, &harness.esi, &harness.image, &harness.image_store, &grant, STATION_ID, ) .await .unwrap();
assert!( sde::get_station(&harness.db, STATION_ID).await.unwrap().is_some(), "an NPC station chosen for a stockpile is resolved into the universe cache" ); }
#[tokio::test] async fn it_short_circuits_a_solar_system_without_touching_esi() { let server = MockServer::start().await; let harness = Harness::new(&server.uri()).await; let grant = Grant::new_test("token", 100);
resolve_stockpile_location( &harness.db, &harness.esi, &harness.image, &harness.image_store, &grant, SYSTEM_ID, ) .await .unwrap(); } }}