jevhooks.git / third-party / rustcrates / aldebaran-axum

For agents, on top of README.md, which they read first.

Notes for agents

No function here defaults a content type or a cache policy. A response that forgot one is a bug the compiler can find; keep it a required argument.

One crate for both families on purpose. The Worker family answers over axum too, so a second adapter would duplicate every function. What needs worker goes in aldebaran-worker; do not add the worker dependency here, or the native family would build the Workers runtime.

axum is default-features = false (the workspace entry). Add a feature to the consumer, not here.

The keep-alive feature exists because of wasm, not taste. event_stream and everything else must keep building for wasm32-unknown-unknown with the feature off (cargo check -p aldebaran-axum --target wasm32-unknown-unknown). Anything that needs tokio's timer goes behind the feature. The keep-alive line and its 15 seconds are axum's own defaults, kept so a property that moves off Sse sends the same bytes on the wire.