Skip to content

ReefLogic C++ API Reference

This section catalogues the public C++ surface of the ReefLogic shared commons library, the operational and admin servers, and the cross-server shared helpers. Each card links to a namespace page that lists headers, classes, public members and free functions. The pages are generated from header comments, so signatures and descriptions stay in sync with the code.

reeflogic::commons

Shared building blocks used by every ReefLogic binary: configuration parsing, OIDC token validation, gRPC server bootstrap, PostgreSQL connection pooling, logging, JWT utilities, secret-key handling, and crypto primitives (AES-GCM, PBKDF2, ML-KEM, ML-DSA).

  • 24 headers
  • 55 classes
  • 12 free functions
  • 9 macros

reeflogic::commons::role_wire

C++ API surface in reeflogic::commons::role_wire.

  • 1 header
  • 0 classes
  • 0 free functions
  • 0 macros

reeflogic::reef_server_common::authn

Bearer-token extraction and Authorization header parsing used by both servers' gRPC AuthN filter chains (admin, init, and survey).

  • 1 header
  • 0 classes
  • 1 free function
  • 0 macros

reeflogic::reef_server_common::command_envelope

Header-only templates that abstract the RequestT/ReplyT/KindEnumT shape shared by AdminExecuteRequest/Reply and RuntimeExecuteRequest/Reply: AuthZ policy resolution from proto enum metadata, the (invalid_argument | pqxx::failure | ReefLogicRuntimeError) try/catch wrapper, kind/oneof alignment checks, and Set*Status reply-envelope helpers.

  • 1 header
  • 0 classes
  • 9 free functions
  • 0 macros

reeflogic::reef_server_common::oidc_validator_config

C++ API surface in reeflogic::reef_server_common::oidc_validator_config.

  • 1 header
  • 0 classes
  • 0 free functions
  • 1 macro

reeflogic::reef_server_common::runtime

Process-lifetime bootstrap shims: SIGINT/SIGTERM signal handlers, the global ShutdownSignal() flag both main.cc bodies poll, the no-throw logger flush wrapper, and the RAII PgUtilityShutdownScope guard.

  • 1 header
  • 1 class
  • 4 free functions
  • 0 macros

reeflogic::server_admin

Admin server business layer: gRPC service implementations, the command-handler dispatcher, the DB operation utility that fronts every transaction, and the per-domain command handlers (grant, role, permission, tenant, OIDC provider).

  • 13 headers
  • 15 classes
  • 3 free functions
  • 0 macros

reeflogic::server_admin::db

Per-domain query operation objects (permission, role, tenant) and OIDC row mapping helpers invoked from DbOperationUtility read paths.

  • 4 headers
  • 3 classes
  • 0 free functions
  • 0 macros

reeflogic::server_survey

Operational ("reef logic") server business layer: ReefSurveyService::execute dispatch, the tenant-scope AuthN interceptor that pools per-tenant OidcTokenValidators and verifies the JWT tenant claim against t_tenants.uuid, the runtime command-handler stub, and the slim db_operation_utility that loads tenant-scope OIDC validator rows.

  • 7 headers
  • 8 classes
  • 2 free functions
  • 1 macro