Portable gateway-domain contracts for Athena.
This crate intentionally stays free of Actix and runtime registry concerns.
It owns the reusable request/response DTOs and normalization helpers that
power /gateway/* routes across adapters, SDKs, deferred queue payloads,
and future server splits.
The current scope covers:
- gateway operation kinds,
- fetch/insert/update/delete/rpc request bodies,
- delete-side resource-ID lookup planning and explicit column normalization,
- deferred gateway queue payloads,
- gateway authorization right naming and wildcard matching helpers,
- fetch request parsing and post-processing helpers,
- fetch body preprocessing for legacy and structured gateway fetch requests,
- legacy
GET /datacompatibility planning and cache-key derivation, - fetch singleflight coordination for cache-equivalent gateway reads,
- metadata-aware fetch condition builders and stats-rollup type fallbacks,
- PostgREST compatibility parsing and filter conversion helpers,
- RPC compatibility parsing for legacy
/rpc/{function_name}routes, - gateway resource-ID fallback resolution heuristics for insert/delete/upsert paths,
- row-response metadata,
- schema/table normalization helpers for gateway requests,
/gateway/queryrequest parsing, normalization, and bounded compatibility planning,/gateway/updaterequest planning, condition coercion, and derived write-right helpers,/gateway/deleterequest planning, resource-ID lookup planning, and derived delete-right helpers,- relation-select compatibility rewrite helpers for bounded
/gateway/querySQL-to-structured-fetch translation, - structured-fetch SQL compilation, metadata loading, and execution helpers.