v0.3.3-pre.004

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

@@ -1,5 +1,5 @@
 // file: crates/ksp-store-postgres-lib/src/runtime.rs
-// version: 5
+// version: 6
 
 const APPLICATION_NAME: &str = "ksp-store";
 const MAX_CONNECTION_URI_BYTES: usize = 4_096;
@@ -332,6 +332,38 @@ impl PostgresBackend {
         return crate::probe_health(&self.pool).await;
     }
 
+    /// Reads one canonical RAW transaction without exposing physical PostgreSQL row types.
+    pub async fn get_raw_transaction(
+        &self,
+        reference: &ksp_store_api::RawTransactionReference,
+    ) -> std::result::Result<std::option::Option<ksp_store_api::RawTransaction>, crate::PostgresBackendError> {
+        return crate::get_raw_transaction(&self.pool, &self.network, reference).await;
+    }
+
+    /// Reads one persisted RAW transaction observation by producer-owned idempotence key.
+    pub async fn get_raw_transaction_observation(
+        &self,
+        observation_key: &ksp_store_api::RawObservationKey,
+    ) -> std::result::Result<std::option::Option<ksp_store_api::RawTransactionObservation>, crate::PostgresBackendError> {
+        return crate::get_raw_transaction_observation(&self.pool, &self.network, observation_key).await;
+    }
+
+    /// Reads the retention state of one canonical RAW transaction identity.
+    pub async fn get_raw_transaction_retention_state(
+        &self,
+        reference: &ksp_store_api::RawTransactionReference,
+    ) -> std::result::Result<std::option::Option<ksp_store_api::RawRetentionState>, crate::PostgresBackendError> {
+        return crate::get_raw_transaction_retention_state(&self.pool, &self.network, reference).await;
+    }
+
+    /// Reads the minimal durable tombstone only when one RAW transaction is purged.
+    pub async fn get_raw_transaction_tombstone(
+        &self,
+        reference: &ksp_store_api::RawTransactionReference,
+    ) -> std::result::Result<std::option::Option<ksp_store_api::RawTransactionTombstone>, crate::PostgresBackendError> {
+        return crate::get_raw_transaction_tombstone(&self.pool, &self.network, reference).await;
+    }
+
     /// Explicitly closes the pool and waits for all owned pooled objects to drain inside the supplied bound.
     pub async fn close(self, timeout: std::time::Duration) -> std::result::Result<(), crate::PostgresBackendError> {
         self.pool.close();