v0.3.8-pre.005

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

@@ -1,5 +1,5 @@
 // file: crates/ksp-store-lib/src/lib.rs
-// version: 10
+// version: 11
 
 #![warn(missing_docs)]
 #![deny(unreachable_pub)]
@@ -12,7 +12,8 @@
 //! `RawTransaction` capabilities. `0.3.4-pre.008` adds the four `RawAccount*` capabilities
 //! on both the physical backend and this common facade, completing the canonical RAW runtime inventory at
 //! ten capabilities without exposing physical types. The `0.3.8` inspection
-//! contracts are reexported here before backend/facade dispatch is opened.
+//! contracts are reexported here. `0.3.8-pre.004` dispatches transaction inspection
+//! and `0.3.8-pre.005` completes inspection dispatch with RAW account states.
 //!
 //! The default `postgres` feature compiles the official PostgreSQL backend as
 //! an optional implementation dependency. No backend implementation type is

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

@@ -1,5 +1,5 @@
 // file: crates/ksp-store-lib/src/store.rs
-// version: 8
+// version: 9
 
 /// Opaque common Store runtime facade.
 ///
@@ -228,6 +228,36 @@ impl ksp_store_api::RawAccountStateRead for Store {
     }
 }
 
+impl ksp_store_api::RawAccountStateInspectionRead for Store {
+    fn inspect_raw_account_states<'a>(
+        &'a self,
+        query: &'a ksp_store_api::RawAccountStateInspectionQuery,
+    ) -> ksp_store_api::StoreApiFuture<'a, ksp_store_api::Result<ksp_store_api::RawInspectionPage<ksp_store_api::RawAccountStateSummary>>> {
+        let network_check = validate_operation_network(&self.network, query.network(), self.backend_kind);
+        if let std::result::Result::Err(error) = network_check {
+            return std::boxed::Box::pin(async move {
+                return std::result::Result::Err(error);
+            });
+        }
+        return std::boxed::Box::pin(async move {
+            #[cfg(feature = "postgres")]
+            {
+                return match &self.runtime {
+                    StoreRuntime::Postgres(backend) => {
+                        let result = backend.inspect_raw_account_states(query).await;
+                        result.map_err(|error| return map_postgres_error(error, self.backend_kind, self.network.as_str()))
+                    },
+                };
+            }
+            #[cfg(not(feature = "postgres"))]
+            {
+                let _ = query;
+                return std::result::Result::Err(unavailable_runtime_error(self.backend_kind));
+            }
+        });
+    }
+}
+
 impl ksp_store_api::RawAccountStateWrite for Store {
     fn persist_raw_account_acquisition<'a>(
         &'a self,

crates/ksp-store-lib/tests/dependency_boundary.rs

@@ -1,5 +1,5 @@
 // file: crates/ksp-store-lib/tests/dependency_boundary.rs
-// version: 9
+// version: 10
 
 #![warn(missing_docs)]
 #![deny(unreachable_pub)]
@@ -60,11 +60,12 @@ fn pre_005_facade_exposes_no_physical_postgres_types_or_environment_bypass() {
 }
 
 #[test]
-fn v0_3_8_pre_004_facade_dispatches_eleven_raw_capabilities_without_physical_leak() {
+fn v0_3_8_pre_005_facade_dispatches_twelve_raw_capabilities_without_physical_leak() {
     let store = include_str!("../src/store.rs");
     for required in [
         "impl ksp_store_api::RawAccountObservationRead for Store",
         "impl ksp_store_api::RawAccountObservationWrite for Store",
+        "impl ksp_store_api::RawAccountStateInspectionRead for Store",
         "impl ksp_store_api::RawAccountStateRead for Store",
         "impl ksp_store_api::RawAccountStateWrite for Store",
         "impl ksp_store_api::RawTransactionInspectionRead for Store",
@@ -80,7 +81,7 @@ fn v0_3_8_pre_004_facade_dispatches_eleven_raw_capabilities_without_physical_lea
     ] {
         assert!(store.contains(required), "missing pre.008 Store capability dispatch contract: {required}");
     }
-    assert_eq!(store.matches("impl ksp_store_api::Raw").count(), 11);
+    assert_eq!(store.matches("impl ksp_store_api::Raw").count(), 12);
     for forbidden in ["tokio_postgres::", "deadpool_postgres::", "CREATE TABLE", "INSERT INTO", "UPDATE ksp_", "DELETE FROM"] {
         assert!(!store.contains(forbidden), "pre.008 facade leaked physical backend material: {forbidden}");
     }

crates/ksp-store-lib/tests/hardening_completeness.rs

@@ -1,5 +1,5 @@
 // file: crates/ksp-store-lib/tests/hardening_completeness.rs
-// version: 8
+// version: 9
 
 #![warn(missing_docs)]
 #![deny(unreachable_pub)]
@@ -292,11 +292,12 @@ fn pre_009_facade_production_sources_keep_config_env_physical_sql_and_backend_ha
 }
 
 #[test]
-fn v0_3_8_pre_004_facade_raw_capability_inventory_is_exactly_eleven() {
+fn v0_3_8_pre_005_facade_raw_capability_inventory_is_exactly_twelve() {
     let store = include_str!("../src/store.rs");
     let capability_impls = [
         "impl ksp_store_api::RawAccountObservationRead for Store",
         "impl ksp_store_api::RawAccountObservationWrite for Store",
+        "impl ksp_store_api::RawAccountStateInspectionRead for Store",
         "impl ksp_store_api::RawAccountStateRead for Store",
         "impl ksp_store_api::RawAccountStateWrite for Store",
         "impl ksp_store_api::RawTransactionInspectionRead for Store",
@@ -310,22 +311,22 @@ fn v0_3_8_pre_004_facade_raw_capability_inventory_is_exactly_eleven() {
     for implementation in capability_impls {
         assert_eq!(store.matches(implementation).count(), 1, "unexpected Store capability implementation inventory: {implementation}");
     }
-    assert_eq!(store.matches("impl ksp_store_api::Raw").count(), 11);
-    assert_eq!(store.matches("validate_operation_network(").count(), 15);
+    assert_eq!(store.matches("impl ksp_store_api::Raw").count(), 12);
+    assert_eq!(store.matches("validate_operation_network(").count(), 16);
     return;
 }
 
 #[test]
-fn v0_3_8_pre_004_facade_and_backend_capability_sets_match_with_transaction_inspection_only() {
+fn v0_3_8_pre_005_facade_and_backend_capability_sets_match_with_both_inspection_capabilities() {
     let store = include_str!("../src/store.rs");
     let backend = include_str!("../../ksp-store-postgres-lib/src/runtime.rs");
     let store_traits = raw_capability_trait_names(store, " for Store");
     let backend_traits = raw_capability_trait_names(backend, " for PostgresBackend");
-    assert_eq!(store_traits.len(), 11);
-    assert_eq!(backend_traits.len(), 11);
+    assert_eq!(store_traits.len(), 12);
+    assert_eq!(backend_traits.len(), 12);
     assert_eq!(store_traits, backend_traits);
     assert!(store_traits.contains(&"RawTransactionInspectionRead"));
-    assert!(!store_traits.contains(&"RawAccountStateInspectionRead"));
+    assert!(store_traits.contains(&"RawAccountStateInspectionRead"));
     for forbidden in ["RawAccountRetentionRead", "RawAccountRetentionWrite", "RawAccountDelete", "RawAccountCompaction"] {
         assert!(!store_traits.contains(&forbidden), "unexpected account capability added to Store: {forbidden}");
         assert!(!backend_traits.contains(&forbidden), "unexpected account capability added to PostgreSQL backend: {forbidden}");

crates/ksp-store-lib/tests/public_api.rs

@@ -1,5 +1,5 @@
 // file: crates/ksp-store-lib/tests/public_api.rs
-// version: 10
+// version: 11
 
 #![warn(missing_docs)]
 #![deny(unreachable_pub)]
@@ -81,6 +81,7 @@ fn assert_raw_capabilities<T>()
 where
     T: ksp_store_lib::RawAccountObservationRead
         + ksp_store_lib::RawAccountObservationWrite
+        + ksp_store_lib::RawAccountStateInspectionRead
         + ksp_store_lib::RawAccountStateRead
         + ksp_store_lib::RawAccountStateWrite
         + ksp_store_lib::RawTransactionInspectionRead
@@ -96,7 +97,7 @@ where
 }
 
 #[test]
-fn v0_3_8_pre_004_store_facade_implements_raw_transaction_inspection_as_capability_11_of_11() {
+fn v0_3_8_pre_005_store_facade_implements_both_inspection_capabilities_as_12_of_12() {
     assert_raw_capabilities::<ksp_store_lib::Store>();
     return;
 }