v0.3.8-pre.009

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

@@ -1,5 +1,5 @@
 // file: crates/ksp-store-lib/src/lib.rs
-// version: 11
+// version: 12
 
 #![warn(missing_docs)]
 #![deny(unreachable_pub)]
@@ -121,8 +121,14 @@ pub use ksp_store_api::MAX_RAW_UNIX_MILLIS;
 pub use ksp_store_api::Pubkey;
 /// Persistable acquisition observation linked to one complete canonical RAW account state.
 pub use ksp_store_api::RawAccountObservation;
+/// Backend-independent random-access inspection query for RAW account observations.
+pub use ksp_store_api::RawAccountObservationInspectionQuery;
+/// Read capability for random-access RAW account-observation inspection.
+pub use ksp_store_api::RawAccountObservationInspectionRead;
 /// Read capability for persisted RAW account-state observations.
 pub use ksp_store_api::RawAccountObservationRead;
+/// Safe observation summary for one canonical RAW account-state acquisition.
+pub use ksp_store_api::RawAccountObservationSummary;
 /// Write capability for additional observations of already persisted RAW account states.
 pub use ksp_store_api::RawAccountObservationWrite;
 /// Canonical complete N1 RAW account state independent from acquisition transport.
@@ -195,8 +201,14 @@ pub use ksp_store_api::RawTransactionInspectionQuery;
 pub use ksp_store_api::RawTransactionInspectionRead;
 /// Persistable acquisition observation linked to one canonical RAW transaction.
 pub use ksp_store_api::RawTransactionObservation;
+/// Backend-independent random-access inspection query for RAW transaction observations.
+pub use ksp_store_api::RawTransactionObservationInspectionQuery;
+/// Read capability for random-access RAW transaction-observation inspection.
+pub use ksp_store_api::RawTransactionObservationInspectionRead;
 /// Read capability for persisted RAW transaction observations.
 pub use ksp_store_api::RawTransactionObservationRead;
+/// Safe observation summary for one canonical RAW transaction acquisition.
+pub use ksp_store_api::RawTransactionObservationSummary;
 /// Write capability for additional observations of already persisted RAW transactions.
 pub use ksp_store_api::RawTransactionObservationWrite;
 /// Backend-independent list query for canonical RAW transactions.

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

@@ -1,5 +1,5 @@
 // file: crates/ksp-store-lib/src/store.rs
-// version: 9
+// version: 10
 
 /// Opaque common Store runtime facade.
 ///
@@ -116,6 +116,36 @@ impl std::fmt::Debug for Store {
     }
 }
 
+impl ksp_store_api::RawAccountObservationInspectionRead for Store {
+    fn inspect_raw_account_observations<'a>(
+        &'a self,
+        query: &'a ksp_store_api::RawAccountObservationInspectionQuery,
+    ) -> ksp_store_api::StoreApiFuture<'a, ksp_store_api::Result<ksp_store_api::RawInspectionPage<ksp_store_api::RawAccountObservationSummary>>> {
+        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_observations(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::RawAccountObservationRead for Store {
     fn get_raw_account_observation<'a>(
         &'a self,
@@ -424,6 +454,36 @@ impl ksp_store_api::RawTransactionWrite for Store {
     }
 }
 
+impl ksp_store_api::RawTransactionObservationInspectionRead for Store {
+    fn inspect_raw_transaction_observations<'a>(
+        &'a self,
+        query: &'a ksp_store_api::RawTransactionObservationInspectionQuery,
+    ) -> ksp_store_api::StoreApiFuture<'a, ksp_store_api::Result<ksp_store_api::RawInspectionPage<ksp_store_api::RawTransactionObservationSummary>>> {
+        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_transaction_observations(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::RawTransactionObservationRead for Store {
     fn get_raw_transaction_observation<'a>(
         &'a self,