0.3.16-pre.3.fix.2

crates/ksp-store-postgres-lib/src/lib.rs

@@ -1,5 +1,5 @@
 // file: crates/ksp-store-postgres-lib/src/lib.rs
-// version: 26
+// version: 27
 #![warn(missing_docs)]
 #![deny(unreachable_pub)]
 #![forbid(unsafe_code)]
@@ -53,59 +53,112 @@ mod runtime;
 mod schema;
 mod schema_v003;
 
+/// Stable KSP error code for unsupported PostgreSQL retention compaction.
 pub use self::error::ERROR_CODE_POSTGRES_RETENTION_COMPACTION_UNSUPPORTED;
+/// Safe backend-local error returned to the common Store facade.
 pub use self::error::PostgresBackendError;
+/// Safe backend-local error classification used by the common Store facade.
 pub use self::error::PostgresBackendErrorKind;
+/// Opaque physical PostgreSQL backend owning its connection pool.
 pub use self::runtime::PostgresBackend;
+/// Safe PostgreSQL readiness projection returned through the backend bridge.
 pub use self::runtime::PostgresBackendHealthSnapshot;
+/// Safe PostgreSQL pool counter projection returned through the backend bridge.
 pub use self::runtime::PostgresBackendRuntimeSnapshot;
+/// Physical PostgreSQL settings bridge consumed only by the backend crate.
 pub use self::runtime::PostgresBackendSettings;
+/// TLS mode accepted by the physical PostgreSQL settings bridge.
 pub use self::runtime::PostgresBackendTlsMode;
 
+/// Crate-owned tracing target for PostgreSQL backend behavior.
 pub(crate) use self::constants::TRACING_TARGET;
+/// Private bounded health probe consumed by the physical backend runtime.
 pub(crate) use self::health::probe_health;
-pub(crate) use self::migration::bootstrap as legacy_bootstrap;
-pub(crate) use self::migration::current_migration_version as legacy_current_migration_version;
-pub(crate) use self::migration_v003::bootstrap;
-pub(crate) use self::migration_v003::current_migration_version;
+/// Frozen V000-V002 migration/bootstrap runner consumed only by the V003 extension.
+pub(crate) use self::migration::bootstrap;
+/// Frozen V000-V002 latest migration version consumed only by the V003 extension.
+pub(crate) use self::migration::current_migration_version;
+/// Current V003 migration/bootstrap runner consumed by the physical backend runtime.
+pub(crate) use self::migration_v003::bootstrap_v003;
+/// Current embedded V003 migration version consumed by the private health probe.
+pub(crate) use self::migration_v003::current_migration_version_v003;
+/// Private RAW account cursor decoder consumed by the physical RAW account module.
 pub(crate) use self::raw_account::cursor::decode_raw_account_cursor;
+/// Private RAW account cursor encoder consumed by the physical RAW account module.
 pub(crate) use self::raw_account::cursor::encode_raw_account_cursor;
+/// Private physical account page-limit converter consumed by the physical RAW account module.
 pub(crate) use self::raw_account::cursor::raw_account_physical_page_limit;
+/// Private RAW account observation reader consumed by the physical backend runtime.
 pub(crate) use self::raw_account::get_raw_account_observation;
+/// Private RAW account state reader consumed by the physical backend runtime.
 pub(crate) use self::raw_account::get_raw_account_state;
+/// Private safe RAW account-observation inspection reader consumed by the physical backend runtime.
 pub(crate) use self::raw_account::inspect_raw_account_observations;
+/// Private data-free RAW account-state inspection reader consumed by the physical backend runtime.
 pub(crate) use self::raw_account::inspect_raw_account_states;
+/// Private RAW account-state list reader consumed by the physical backend runtime.
 pub(crate) use self::raw_account::list_raw_account_states;
+/// Private atomic RAW account acquisition writer consumed by the physical backend runtime.
 pub(crate) use self::raw_account::persist_raw_account_acquisition;
+/// Private additional RAW account observation writer consumed by the physical backend runtime.
 pub(crate) use self::raw_account::record_raw_account_observation;
+/// Private RAW transaction cursor decoder consumed by the physical RAW module.
 pub(crate) use self::raw_transaction::cursor::decode_raw_transaction_cursor;
+/// Private RAW transaction cursor encoder consumed by the physical RAW module.
 pub(crate) use self::raw_transaction::cursor::encode_raw_transaction_cursor;
+/// Private physical page-limit converter consumed by the physical RAW module.
 pub(crate) use self::raw_transaction::cursor::raw_transaction_physical_page_limit;
+/// Private RAW transaction reader consumed by the physical backend runtime.
 pub(crate) use self::raw_transaction::get_raw_transaction;
+/// Private RAW transaction observation reader consumed by the physical backend runtime.
 pub(crate) use self::raw_transaction::get_raw_transaction_observation;
+/// Private RAW transaction retention-state reader consumed by the physical backend runtime.
 pub(crate) use self::raw_transaction::get_raw_transaction_retention_state;
+/// Private RAW transaction tombstone reader consumed by the physical backend runtime.
 pub(crate) use self::raw_transaction::get_raw_transaction_tombstone;
+/// Private safe RAW transaction-observation inspection reader consumed by the physical backend runtime.
 pub(crate) use self::raw_transaction::inspect_raw_transaction_observations;
+/// Private payload-free RAW transaction inspection reader consumed by the physical backend runtime.
 pub(crate) use self::raw_transaction::inspect_raw_transactions;
+/// Private RAW transaction list reader consumed by the physical backend runtime.
 pub(crate) use self::raw_transaction::list_raw_transactions;
+/// Private atomic RAW transaction acquisition writer consumed by the physical backend runtime.
 pub(crate) use self::raw_transaction::persist_raw_transaction_acquisition;
+/// Private additional RAW transaction observation writer consumed by the physical backend runtime.
 pub(crate) use self::raw_transaction::record_raw_transaction_observation;
+/// Private RAW transaction retention transition writer consumed by the physical backend runtime.
 pub(crate) use self::raw_transaction::transition_raw_transaction_retention;
+/// Private Deadpool error mapper shared with the health probe.
 pub(crate) use self::runtime::map_pool_error;
+/// Private Deadpool status projector shared with the health probe.
 pub(crate) use self::runtime::runtime_snapshot_from_status;
+/// Private physical schema resource descriptor consumed by the frozen migration engine.
 pub(crate) use self::schema::SchemaResource;
+/// Private physical schema resource compatibility state consumed by the frozen migration engine.
 pub(crate) use self::schema::SchemaResourceState;
+/// Private V000 schema resource inventory consumed by the migration engines.
 pub(crate) use self::schema::V000_RESOURCES;
+/// Private V001 schema resource inventory consumed by the migration engines.
 pub(crate) use self::schema::V001_RESOURCES;
+/// Private V002 schema resource inventory consumed by the migration engines.
 pub(crate) use self::schema::V002_RESOURCES;
+/// Private physical schema resource inspector consumed by the migration engines.
 pub(crate) use self::schema::inspect_resource;
+/// Private managed-schema adoption probe consumed by the frozen migration engine.
 pub(crate) use self::schema::managed_schema_objects_exist;
+/// Private V001 external-schema compatibility gate consumed by the migration engines.
 pub(crate) use self::schema::verify_v001_external_compatibility;
+/// Private V002 external-schema compatibility gate consumed by the migration engines.
 pub(crate) use self::schema::verify_v002_external_compatibility;
+/// Private V003 schema resource inventory consumed by the V003 migration extension.
 pub(crate) use self::schema_v003::V003_RESOURCES;
+/// Private V003 schema resource descriptor consumed by the V003 migration extension.
 pub(crate) use self::schema_v003::V003SchemaResource;
+/// Private V003 schema compatibility state consumed by the V003 migration extension.
 pub(crate) use self::schema_v003::V003SchemaResourceState;
+/// Private V003 schema inspector consumed by the V003 migration extension.
 pub(crate) use self::schema_v003::inspect_v003_resource;
+/// Private V003 external-schema compatibility gate consumed by the V003 migration extension.
 pub(crate) use self::schema_v003::verify_v003_external_compatibility;
 
 const _: &str = crate::TRACING_TARGET;