Module api 

The moocfi endpoints, one stage boundary at a time.

Order per request, as Suotar’s middleware runs it: the JSON body parse (size, then syntax), the credential, the envelope and item validation, the item-keyed load, the auth/requestGate/ parse faults, resolve request-level then per item, then afterWrite and respond. The write-back commits before the response — or its deliberate absence — leaves the process, which is what makes a timeout that landed distinguishable from one that did not.

Macros

endpoint_handlers 🔒

Actix binds one handler per route, so the endpoint each route serves is all these differ by.

Structs

Answer 🔒

What a request is answered with, and what its call-log entry records about the answer.

FaultRunner 🔒

Enums

Body 🔒

Delivery 🔒

ParsedBody 🔒

What Express’s JSON parser made of the body before any route ran.

ParsedRequest 🔒

Import resolves as a batch; every other endpoint answers item by item.

PerItemRequest 🔒

Constants

IMPORT_STRING_FIELDS 🔒

MAX_BODY_BYTES 🔒

Express’s 5mb.

RAW_BODY_LIMIT 🔒

Functions

answer 🔒

Resolves one request against the working set, which the caller then commits along with call.

authorized 🔒

completion_key 🔒

Suotar’s intra-batch duplicate key. The enrolment and the language are deliberately not in it.

credential_accepted 🔒

Exactly Bearer <token>: case-sensitive, one space, no other scheme.

deliver 🔒

endpoint 🔒

enrich_verify_addresses 🔒

fall_through

Anything under the prefix that no route serves, including a wrong method. A valid key falls through to Suotar’s internal routes, whose refusal is a bare string rather than the envelope.

import_attainments

is_strict_date 🔒

Moment’s strict YYYY-MM-DD: that exact shape, and a day the calendar has.

item_effect_response 🔒

item_problem 🔒

The endpoint’s own item check, worded and ordered as Suotar’s.

leave_unconfirmed 🔒

A send that never answered: the submission exists but Sisu’s acceptance was never recorded.

list_by_course

load 🔒

non_empty_string 🔒

parse_body 🔒

parse_envelope 🔒

Suotar’s envelope checks in its order; Ok(None) is the empty batch, answered with [].

pre_route_rejection 🔒

The body parser runs before the credential check, so its failures win over a missing key.

read_body 🔒

Stops reading past the limit, so an oversized body costs no more than the limit.

resolve_enrolments

resolve_import_batch 🔒

Resolves an import batch and writes what survived its checks, returning each item’s answer and the submission it wrote. Err is the request-level answer that replaces the whole batch.

resolve_persons

resolve_world 🔒

run 🔒

terminal 🔒

None for an item-shaped effect, which shapes one item rather than the whole answer.

truncate 🔒

typed 🔒

Cannot fail on an item that passed item_problem; the message is for the day the two drift.

unique_field 🔒

Collects the distinct values of one field across a request’s items, in first-seen order.

validate_course_codes

verify_attainments