Skip to main content

appcore_gateway/
lib.rs

1// =============================================================================
2//        #######
3//     ###       ###     F: lib.rs
4//    ##   ## ##   ##    P: AppCore-Runtime
5//         ## ##
6//                       C: 2026/07/26 08:53:09 by dnettoRaw
7//    ##   ## ##   ##    U: 2026/08/02 12:48:56 by dnettoRaw
8//      ###########      S: 1.0.1-rc.8
9// =============================================================================
10
11//! Multi-tenant Gateway capability for the `AppCore` Runtime.
12
13#![deny(missing_docs)]
14
15pub mod authorization;
16pub mod capability;
17pub mod config;
18pub mod connection;
19pub mod diagnostics;
20pub mod error;
21mod failure_diagnostic;
22mod federated_route;
23pub mod federation;
24mod federation_auth;
25mod federation_transport;
26pub mod ha;
27pub mod heartbeat;
28pub mod mesh;
29mod mesh_route;
30pub mod metrics;
31mod peer_route;
32pub mod registry;
33pub mod resolver;
34mod route_admission;
35mod route_fencing;
36pub mod router;
37pub mod runtime;
38pub mod service;
39pub mod session;
40pub mod socket;
41mod socket_lifecycle;
42mod socket_ownership;
43pub mod state;
44mod telemetry;
45pub mod tenant;
46mod tenant_directory;
47
48pub use appcore_distributed_contracts::{
49    OpaqueContentEnvelopeV1, OpaqueEnvelopeDecision, OpaqueEnvelopeDeduplicator,
50    OpaqueEnvelopePolicy, OPAQUE_CONTENT_ENVELOPE_SCHEMA_V1,
51};
52pub use authorization::{
53    client_connection_hash, gateway_token_claims, worker_connection_hash,
54    GATEWAY_CONNECTION_TOKEN_TTL_MS,
55};
56pub use capability::{
57    gateway_capability_descriptor, GatewayCapability, GATEWAY_RUNTIME_CAPABILITY,
58};
59pub use config::{
60    GatewayConfig, GATEWAY_ADAPTER_NAME, GATEWAY_PROVIDER_ID, MAX_GATEWAY_AFFINITY_KEY_BYTES,
61    MAX_GATEWAY_WORKER_INFLIGHT,
62};
63pub use connection::{ClientConnection, WorkerConnection, WorkerConnectionKey};
64pub use diagnostics::{
65    GatewayCapabilitySnapshot, GatewayDiagnosticsQuery, GatewayDiagnosticsSnapshot,
66    GatewayPeerSnapshot,
67};
68pub use error::{GatewayError, GatewayResult};
69pub use federation::{
70    GatewayFederationRequestV2, GatewayFederationResponseV2, GATEWAY_FEDERATION_PATH_V2,
71    GATEWAY_FEDERATION_SCHEMA_V2,
72};
73pub use federation_auth::{gateway_federation_token_claims, GATEWAY_FEDERATION_TOKEN_TTL_MS};
74#[cfg(feature = "ha-redis")]
75pub use ha::redis::{
76    RedisGatewayCredential, RedisGatewayRegistryConfig, RedisGatewayRegistryProvider,
77    MAX_GATEWAY_REDIS_NAMESPACE_BYTES,
78};
79pub use ha::{
80    GatewayFederationUrl, GatewayHaCoordinator, GatewayHaCoordinatorConfig,
81    GatewayHaCoordinatorSnapshot, GatewayHaLifecycle, GatewayHaLifecycleSnapshot, GatewayHaMode,
82    GatewayHaOwnershipSnapshot, GatewayHaOwnershipSource, GatewayHaSessionSnapshot,
83    GatewayHaTenantBinding, GatewayHaWorkerSnapshot, GatewayInstanceLease,
84    GatewayLocalRequestClaim, GatewayRegistryError, GatewayRegistryFuture, GatewayRegistryProvider,
85    GatewayRegistryResult, GatewayRequestFence, GatewaySessionRecord, GatewayWorkerRecord,
86    GatewayWorkerRegistration, MAX_GATEWAY_INSTANCE_LEASE_TTL_MS, MAX_GATEWAY_REGISTRY_CONCURRENCY,
87    MAX_GATEWAY_RESOLVE_CANDIDATES,
88};
89pub use heartbeat::spawn_heartbeat_pruner;
90pub use mesh::{
91    MeshPeerRequest, MeshPeerResponse, MeshPeerTransport, MESH_HTTP_SCHEMA_V1, MESH_PEER_RELAY_PATH,
92};
93pub use metrics::GatewayMetrics;
94pub use registry::{CapabilityRegistry, CapabilityRegistryStats};
95pub use resolver::{
96    CapabilityResolver, SelectionPolicy, WorkerSelectionError, WorkerSelectionInput,
97    WorkerSelectionPolicy,
98};
99pub use router::EnvelopeRouter;
100pub use runtime::{
101    GatewayRuntime, GatewayRuntimeDetails, GatewayRuntimeSnapshot, GatewayRuntimeState,
102};
103pub use service::make_gateway_router;
104pub use session::GatewaySession;
105pub use state::GatewayState;
106pub use telemetry::{
107    GatewayCapabilityTelemetrySnapshot, GatewayTelemetryExportError, GatewayTelemetryExporter,
108    GatewayTelemetrySnapshot, MAX_GATEWAY_TELEMETRY_CAPABILITIES,
109};
110pub use tenant::TenantState;
111pub use tenant_directory::SharedTenantState;
112
113#[cfg(test)]
114mod tests;
115
116pub use failure_diagnostic::{GatewayFailureCodeV1, GatewayFailureDiagnosticV1};