0.1.0-pre.004

kb-store/src/contracts.rs

@@ -0,0 +1,152 @@
+// file: kb-store/src/contracts.rs
+// version: 1
+
+//! Backend-neutral storage contracts used by pipeline crates.
+
+mod dto;
+mod entity;
+mod error;
+mod health;
+mod pagination;
+mod repository;
+
+/// Core account key insert contract.
+pub use crate::contracts::dto::CoreAccountKeyInsert;
+/// Core account key source category.
+pub use crate::contracts::dto::CoreAccountKeySource;
+/// Core balance change insert contract.
+pub use crate::contracts::dto::CoreBalanceChangeInsert;
+/// Core balance change kind.
+pub use crate::contracts::dto::CoreBalanceChangeKind;
+/// Complete normalized core extraction write bundle.
+pub use crate::contracts::dto::CoreExtractionBundle;
+/// Failure details persisted for one canonical to core extraction attempt.
+pub use crate::contracts::dto::CoreExtractionFailure;
+/// Bounded canonical transaction selection filter for core extraction.
+pub use crate::contracts::dto::CoreExtractionSelectionFilter;
+/// Core inner instruction insert contract.
+pub use crate::contracts::dto::CoreInnerInstructionInsert;
+/// Core instruction insert contract.
+pub use crate::contracts::dto::CoreInstructionInsert;
+/// Core instruction lifecycle mark request.
+pub use crate::contracts::dto::CoreInstructionLifecycleMark;
+/// Core instruction processing state.
+pub use crate::contracts::dto::CoreInstructionProcessingState;
+/// Core instruction replay filter contract.
+pub use crate::contracts::dto::CoreInstructionReplayFilter;
+/// Core log insert contract.
+pub use crate::contracts::dto::CoreLogInsert;
+/// Core transaction insert contract.
+pub use crate::contracts::dto::CoreTransactionInsert;
+/// One machine-readable decoder coverage declaration row.
+pub use crate::contracts::dto::DecodeCoverageDeclarationInsert;
+/// One observed coverage classification row owned by one decode attempt.
+pub use crate::contracts::dto::DecodeCoverageObservationInsert;
+/// One row of aggregated decoder coverage diagnostics.
+pub use crate::contracts::dto::DecodeCoverageSummaryRow;
+/// Failed decode attempt persisted in the common ledger.
+pub use crate::contracts::dto::DecodeFailure;
+/// One processor-owned decoded observation row.
+pub use crate::contracts::dto::DecodeObservationInsert;
+/// Atomic persistence bundle for one decoder and one contextual input.
+pub use crate::contracts::dto::DecodePersistenceBundle;
+/// Bounded contextual instruction selection filter for decode campaigns.
+pub use crate::contracts::dto::DecodeSelectionFilter;
+/// Decoded event insert contract.
+pub use crate::contracts::dto::DecodedEventInsert;
+/// Insert or upsert result contract returned by repositories.
+pub use crate::contracts::dto::InsertOutcome;
+/// Maximum number of materialized rows returned by one bounded query.
+pub use crate::contracts::dto::MAX_MATERIALIZED_EVENT_QUERY_ROWS;
+/// Atomic persistence bundle for one materializer and one decoded observation.
+pub use crate::contracts::dto::MaterializationPersistenceBundle;
+/// Bounded read-only materialized event selection.
+pub use crate::contracts::dto::MaterializedEventFilter;
+/// Materialized event insert contract.
+pub use crate::contracts::dto::MaterializedEventInsert;
+/// One materialized output returned by a bounded query.
+pub use crate::contracts::dto::MaterializedEventQueryRow;
+/// One processor-owned materialized output row.
+pub use crate::contracts::dto::MaterializedOutputInsert;
+/// Stable processing ledger identity.
+pub use crate::contracts::dto::ProcessingLedgerIdentity;
+/// Processing ledger mark request contract.
+pub use crate::contracts::dto::ProcessingLedgerMark;
+/// Stable processing ledger status.
+pub use crate::contracts::dto::ProcessingLedgerStatus;
+/// Raw payload lifecycle mark request.
+pub use crate::contracts::dto::RawPayloadLifecycleMark;
+/// Raw payload processing state.
+pub use crate::contracts::dto::RawPayloadProcessingState;
+/// Raw payload retention state.
+pub use crate::contracts::dto::RawPayloadRetentionState;
+/// Canonical raw Solana transaction insert contract.
+pub use crate::contracts::dto::RawTransactionInsert;
+/// Store backend diagnostic contract.
+pub use crate::contracts::dto::StoreBackendDescriptor;
+/// Store backend kind contract.
+pub use crate::contracts::dto::StoreBackendKind;
+/// Store migration diagnostic snapshot contract.
+pub use crate::contracts::dto::StoreMigrationSnapshot;
+/// Store migration status contract.
+pub use crate::contracts::dto::StoreMigrationStatus;
+/// Transaction acquisition observation insert contract.
+pub use crate::contracts::dto::TransactionObservationInsert;
+/// Transaction acquisition observation origin.
+pub use crate::contracts::dto::TransactionObservationOrigin;
+/// Transaction acquisition observation status.
+pub use crate::contracts::dto::TransactionObservationStatus;
+/// Core account key SQL-like row contract.
+pub use crate::contracts::entity::CoreAccountKeyRow;
+/// Core balance change SQL-like row contract.
+pub use crate::contracts::entity::CoreBalanceChangeRow;
+/// Core inner instruction SQL-like row contract.
+pub use crate::contracts::entity::CoreInnerInstructionRow;
+/// Core instruction SQL-like row contract.
+pub use crate::contracts::entity::CoreInstructionRow;
+/// Core log SQL-like row contract.
+pub use crate::contracts::entity::CoreLogRow;
+/// Core transaction SQL-like row contract.
+pub use crate::contracts::entity::CoreTransactionRow;
+/// Decoded event SQL-like row contract.
+pub use crate::contracts::entity::DecodedEventRow;
+/// Materialized event SQL-like row contract.
+pub use crate::contracts::entity::MaterializedEventRow;
+/// Processing ledger SQL-like row contract.
+pub use crate::contracts::entity::ProcessingLedgerRow;
+/// Canonical raw Solana transaction SQL-like row contract.
+pub use crate::contracts::entity::RawTransactionRow;
+/// Transaction acquisition observation SQL-like row contract.
+pub use crate::contracts::entity::TransactionObservationRow;
+/// Storage error helper functions.
+pub use crate::contracts::error::storage_contract_error;
+/// Store backend health snapshot.
+pub use crate::contracts::health::StoreHealthSnapshot;
+/// Store backend health status.
+pub use crate::contracts::health::StoreHealthStatus;
+/// Default repository page size.
+pub use crate::contracts::pagination::DEFAULT_PAGE_SIZE;
+/// Maximum repository page size.
+pub use crate::contracts::pagination::MAX_PAGE_SIZE;
+/// Page request contract for repository list operations.
+pub use crate::contracts::pagination::PageRequest;
+/// Sort direction for repository list operations.
+pub use crate::contracts::pagination::SortDirection;
+/// Canonical transaction to core extraction storage behavior.
+pub use crate::contracts::repository::CoreExtractionStore;
+/// Core Solana storage behavior.
+pub use crate::contracts::repository::CoreTransactionStore;
+/// Contextual instruction decode and materialization storage behavior.
+pub use crate::contracts::repository::DecodePipelineStore;
+/// Decoded event storage behavior.
+pub use crate::contracts::repository::DecodedEventStore;
+/// Materialized event storage behavior.
+pub use crate::contracts::repository::MaterializedEventStore;
+/// Processing ledger storage behavior.
+pub use crate::contracts::repository::ProcessingLedgerStore;
+/// Program observation storage behavior.
+pub use crate::contracts::repository::ProgramObservationStore;
+/// Raw transaction storage behavior.
+pub use crate::contracts::repository::RawTransactionStore;
+/// Store health storage behavior.
+pub use crate::contracts::repository::StoreHealthStore;