Foundation / checks (deploy) (push) Successful in 6s
Foundation / checks (checks) (push) Failing after 40s
Foundation / checks (ecs) (push) Successful in 1m55s
Foundation / checks (postgres) (push) Failing after 53s
Foundation / checks (tsan) (push) Failing after 33s
Foundation / checks (network) (push) Failing after 3m1s
Foundation / postgres-tools (push) Canceled after 0s
Foundation / server-image (push) Canceled after 0s
Foundation / image (push) Canceled after 0s
Foundation / checks (client) (push) Canceled after 3m53s
78 lines
3.7 KiB
C++
78 lines
3.7 KiB
C++
#pragma once
|
|
#include "evo/persistence/postgres.hpp"
|
|
#include "evo/persistence/region_lease.hpp"
|
|
#include <chrono>
|
|
#include <cstdint>
|
|
#include <expected>
|
|
#include <vector>
|
|
|
|
namespace evo::persistence {
|
|
// Schema v15, ADR-0100. These operations allocate identity, never a biological
|
|
// body. Each call is one statement on the caller's connection, without retries.
|
|
enum class LifeReservationError : std::uint8_t {
|
|
existing_life,
|
|
fenced,
|
|
not_available, // Missing allocator/reservation, or reservation belongs elsewhere.
|
|
exhausted,
|
|
invalid,
|
|
store,
|
|
unknown // May have committed. Reconnect and retry the SAME request to reconcile.
|
|
};
|
|
struct LifeReservationFailure {
|
|
LifeReservationError kind{};
|
|
PgFailure cause{};
|
|
};
|
|
enum class LifeRefusal : std::uint8_t {
|
|
none = 0, // Reserved only; NOT successful spawn.
|
|
insufficient_funding = 1,
|
|
no_placement = 2,
|
|
cancelled = 3,
|
|
existing_life = 4
|
|
};
|
|
struct LifeReservation {
|
|
std::uint64_t identity{}, region{};
|
|
LifeRefusal refusal{};
|
|
friend bool operator==(const LifeReservation&, const LifeReservation&) = default;
|
|
};
|
|
struct PrimitiveLifeBinding {
|
|
Uuid account{};
|
|
std::uint64_t request{}, identity{}, born{};
|
|
Uuid commit{};
|
|
std::uint64_t commit_sequence{};
|
|
friend bool operator==(const PrimitiveLifeBinding&, const PrimitiveLifeBinding&) = default;
|
|
};
|
|
struct PrimitiveLifeOutcome {
|
|
LifeReservation reservation;
|
|
std::optional<PrimitiveLifeBinding> published;
|
|
friend bool operator==(const PrimitiveLifeOutcome&, const PrimitiveLifeOutcome&) = default;
|
|
};
|
|
// Exact retry returns the original identity/owning region/refusal, even after
|
|
// account control moves. The result grants no authority in the returned region.
|
|
// request_id is in the new-life namespace, separate from M10 probe action IDs.
|
|
[[nodiscard]] std::expected<LifeReservation, LifeReservationFailure>
|
|
reserve_primitive_life(Postgres& db, RegionKey key, const LeaseGrant& lease, const Uuid& account,
|
|
std::uint64_t generation, std::uint64_t request_id, std::uint32_t rules,
|
|
std::chrono::milliseconds timeout);
|
|
// Requires control in the reservation's owning region. First refusal is final;
|
|
// repeats return it. Passing none or an unknown enum value is invalid.
|
|
[[nodiscard]] std::expected<LifeRefusal, LifeReservationFailure>
|
|
reject_primitive_life(Postgres& db, RegionKey key, const LeaseGrant& lease, const Uuid& account,
|
|
std::uint64_t generation, std::uint64_t request_id, LifeRefusal reason,
|
|
std::chrono::milliseconds timeout);
|
|
// Bounded durable binding set for checkpoint reconciliation; session generations
|
|
// are intentionally absent and must be reacquired after recovery.
|
|
[[nodiscard]] std::expected<std::vector<PrimitiveLifeBinding>, LifeReservationFailure>
|
|
load_primitive_lives(Postgres& db, RegionKey key, std::chrono::milliseconds timeout);
|
|
// Authenticated world/account/request lookup. A missing value is unknown; a
|
|
// present pending reservation is still not a published life.
|
|
[[nodiscard]] std::expected<std::optional<PrimitiveLifeOutcome>, LifeReservationFailure>
|
|
query_primitive_life(Postgres& db, RegionKey key, const LeaseGrant& lease, const Uuid& account,
|
|
std::uint64_t generation, std::uint64_t request_id,
|
|
std::chrono::milliseconds timeout);
|
|
// Read-only, lease-fenced lookup used before claiming durable account control.
|
|
// Returns no value when the account has no active (non-refused) life reservation.
|
|
[[nodiscard]] std::expected<std::optional<std::uint64_t>, LifeReservationFailure>
|
|
primitive_life_owner(Postgres& db, RegionKey key, const LeaseGrant& lease, const Uuid& account,
|
|
std::chrono::milliseconds timeout);
|
|
} // namespace evo::persistence
|