feat: add inferadb-ledger-proto crate

Author: evansims

.github/workflows/canary.yml

@@ -61,6 +61,7 @@ jobs:
               - 'crates/types/**'
               - 'crates/store/**'
               - 'crates/state/**'
+              - 'crates/proto/**'
               - 'crates/raft/**'
               - 'crates/sdk/**'
               - 'proto/**'
@@ -459,7 +460,7 @@ jobs:
 
           # Update inter-crate dependency versions to use exact prerelease version
           # (semver ranges like ^0.1.0 don't match prereleases)
-          for crate in inferadb-ledger-types inferadb-ledger-store inferadb-ledger-state inferadb-ledger-raft inferadb-ledger-sdk; do
+          for crate in inferadb-ledger-types inferadb-ledger-store inferadb-ledger-state inferadb-ledger-proto inferadb-ledger-raft inferadb-ledger-sdk; do
             sed -i "s/\(${crate} = { version = \)\"[^\"]*\"/\1\"=${CRATE_VERSION}\"/" Cargo.toml
           done
 
@@ -474,7 +475,7 @@ jobs:
         env:
           CARGO_REGISTRY_TOKEN: ${{ steps.auth.outputs.token }}
         run: |
-          for crate in inferadb-ledger-types inferadb-ledger-store inferadb-ledger-state inferadb-ledger-raft inferadb-ledger-sdk; do
+          for crate in inferadb-ledger-types inferadb-ledger-store inferadb-ledger-state inferadb-ledger-proto inferadb-ledger-raft inferadb-ledger-sdk; do
             echo "Publishing ${crate}..."
             cargo publish -p "${crate}" --token "$CARGO_REGISTRY_TOKEN" --allow-dirty
             echo "Waiting for crates.io to index..."

.github/workflows/nightly.yml

@@ -103,7 +103,7 @@ jobs:
 
           # Check if library files changed since last nightly
           LIBRARY_CHANGES=$(git diff --name-only "$LAST_SHA"..HEAD -- \
-            crates/types crates/store crates/state crates/raft crates/sdk \
+            crates/types crates/store crates/state crates/proto crates/raft crates/sdk \
             proto Cargo.toml Cargo.lock | wc -l)
 
           if [ "$LIBRARY_CHANGES" -gt 0 ]; then
@@ -536,7 +536,7 @@ jobs:
 
           # Update inter-crate dependency versions to use exact prerelease version
           # (semver ranges like ^0.1.0 don't match prereleases)
-          for crate in inferadb-ledger-types inferadb-ledger-store inferadb-ledger-state inferadb-ledger-raft inferadb-ledger-sdk; do
+          for crate in inferadb-ledger-types inferadb-ledger-store inferadb-ledger-state inferadb-ledger-proto inferadb-ledger-raft inferadb-ledger-sdk; do
             sed -i "s/\(${crate} = { version = \)\"[^\"]*\"/\1\"=${VERSION}\"/" Cargo.toml
           done
 
@@ -551,7 +551,7 @@ jobs:
         env:
           CARGO_REGISTRY_TOKEN: ${{ steps.auth.outputs.token }}
         run: |
-          for crate in inferadb-ledger-types inferadb-ledger-store inferadb-ledger-state inferadb-ledger-raft inferadb-ledger-sdk; do
+          for crate in inferadb-ledger-types inferadb-ledger-store inferadb-ledger-state inferadb-ledger-proto inferadb-ledger-raft inferadb-ledger-sdk; do
             echo "Publishing ${crate}..."
             cargo publish -p "${crate}" --token "$CARGO_REGISTRY_TOKEN" --allow-dirty
             echo "Waiting for crates.io to index..."

.github/workflows/release.yml

@@ -494,6 +494,14 @@ jobs:
           echo "Waiting for crates.io to index..."
           sleep 45
 
+      - name: Publish inferadb-ledger-proto
+        env:
+          CARGO_REGISTRY_TOKEN: ${{ steps.auth.outputs.token }}
+        run: |
+          cargo publish -p inferadb-ledger-proto --token "$CARGO_REGISTRY_TOKEN" --allow-dirty
+          echo "Waiting for crates.io to index..."
+          sleep 45
+
       - name: Publish inferadb-ledger-raft
         env:
           CARGO_REGISTRY_TOKEN: ${{ steps.auth.outputs.token }}

Cargo.lock

@@ -4,6 +4,7 @@ members = [
     "crates/types",
     "crates/store",
     "crates/state",
+    "crates/proto",
     "crates/raft",
     "crates/server",
     "crates/sdk",
@@ -124,6 +125,7 @@ async-stream = "0.3"
 inferadb-ledger-types = { version = "0.1.0", path = "crates/types" }
 inferadb-ledger-store = { version = "0.1.0", path = "crates/store" }
 inferadb-ledger-state = { version = "0.1.0", path = "crates/state" }
+inferadb-ledger-proto = { version = "0.1.0", path = "crates/proto" }
 inferadb-ledger-raft = { version = "0.1.0", path = "crates/raft" }
 inferadb-ledger-server = { path = "crates/server" }
 inferadb-ledger-sdk = { version = "0.1.0", path = "crates/sdk" }

Cargo.toml

@@ -0,0 +1,42 @@
+[package]
+name = "inferadb-ledger-proto"
+description = "Protobuf types and conversions for InferaDB Ledger"
+version.workspace = true
+edition.workspace = true
+rust-version.workspace = true
+license.workspace = true
+repository.workspace = true
+authors.workspace = true
+documentation = "https://docs.rs/inferadb-ledger-proto"
+readme = "README.md"
+keywords = ["protobuf", "grpc", "ledger", "types"]
+categories = ["encoding", "network-programming"]
+
+[dependencies]
+# Internal
+inferadb-ledger-types.workspace = true
+
+# gRPC / proto
+tonic.workspace = true
+tonic-prost.workspace = true
+prost.workspace = true
+prost-types.workspace = true
+
+# Raft (for Vote type in conversions)
+openraft.workspace = true
+
+# Error handling (for tonic::Status in TryFrom)
+snafu.workspace = true
+
+[build-dependencies]
+tonic-build.workspace = true
+tonic-prost-build.workspace = true
+
+[dev-dependencies]
+inferadb-ledger-test-utils.workspace = true
+proptest.workspace = true
+uuid.workspace = true
+chrono.workspace = true
+
+[lints]
+workspace = true

crates/proto/Cargo.toml

@@ -1,4 +1,4 @@
-//! Build script for inferadb-ledger-raft.
+//! Build script for inferadb-ledger-proto.
 //!
 //! Compiles protobuf definitions into Rust code using tonic-prost-build.
 //! When publishing to crates.io, proto files aren't available, so we use

crates/raft/build.rs crates/proto/build.rscrates/raft/build.rs renamed to crates/proto/build.rs

@@ -12,23 +12,28 @@
 //! # Usage
 //!
 //! ```ignore
-//! use crate::proto_convert::*;
+//! use inferadb_ledger_proto::convert;
 //!
 //! // Domain to proto
 //! let proto_op: proto::Operation = domain_op.into();
 //!
-//! // Proto to domain  
+//! // Proto to domain
 //! let domain_vote: Vote<LedgerNodeId> = proto_vote.into();
 //! ```
+//!
+//! # Note
+//!
+//! The `NamespaceStatus` conversion lives in the `raft` crate because it
+//! depends on `inferadb_ledger_state::system::NamespaceStatus`.
 
-use inferadb_ledger_types::merkle::MerkleProof as InternalMerkleProof;
+use inferadb_ledger_types::{
+    BlockRetentionMode, BlockRetentionPolicy, LedgerNodeId,
+    merkle::MerkleProof as InternalMerkleProof,
+};
 use openraft::Vote;
 use tonic::Status;
 
-use crate::{
-    proto,
-    types::{BlockRetentionMode, BlockRetentionPolicy, LedgerNodeId},
-};
+use crate::proto;
 
 // =============================================================================
 // Vote conversions (openraft::Vote <-> proto::RaftVote)
@@ -237,24 +242,6 @@ impl TryFrom<proto::Operation> for inferadb_ledger_types::Operation {
     }
 }
 
-// =============================================================================
-// NamespaceStatus conversions
-// =============================================================================
-
-impl From<inferadb_ledger_state::system::NamespaceStatus> for proto::NamespaceStatus {
-    fn from(status: inferadb_ledger_state::system::NamespaceStatus) -> Self {
-        use inferadb_ledger_state::system::NamespaceStatus;
-
-        match status {
-            NamespaceStatus::Active => proto::NamespaceStatus::Active,
-            NamespaceStatus::Migrating => proto::NamespaceStatus::Migrating,
-            NamespaceStatus::Suspended => proto::NamespaceStatus::Suspended,
-            NamespaceStatus::Deleting => proto::NamespaceStatus::Deleting,
-            NamespaceStatus::Deleted => proto::NamespaceStatus::Deleted,
-        }
-    }
-}
-
 // =============================================================================
 // Entity conversions (inferadb_ledger_types::Entity -> proto::Entity)
 // =============================================================================
@@ -956,36 +943,6 @@ mod tests {
         );
     }
 
-    // -------------------------------------------------------------------------
-    // NamespaceStatus conversion tests
-    // -------------------------------------------------------------------------
-
-    #[test]
-    fn test_namespace_status_all_variants() {
-        use inferadb_ledger_state::system::NamespaceStatus;
-
-        assert_eq!(
-            proto::NamespaceStatus::from(NamespaceStatus::Active),
-            proto::NamespaceStatus::Active
-        );
-        assert_eq!(
-            proto::NamespaceStatus::from(NamespaceStatus::Migrating),
-            proto::NamespaceStatus::Migrating
-        );
-        assert_eq!(
-            proto::NamespaceStatus::from(NamespaceStatus::Suspended),
-            proto::NamespaceStatus::Suspended
-        );
-        assert_eq!(
-            proto::NamespaceStatus::from(NamespaceStatus::Deleting),
-            proto::NamespaceStatus::Deleting
-        );
-        assert_eq!(
-            proto::NamespaceStatus::from(NamespaceStatus::Deleted),
-            proto::NamespaceStatus::Deleted
-        );
-    }
-
     // -------------------------------------------------------------------------
     // Entity conversion tests
     // -------------------------------------------------------------------------

crates/raft/src/proto_convert.rs crates/proto/src/convert.rscrates/raft/src/proto_convert.rs renamed to crates/proto/src/convert.rs

@@ -0,0 +1,30 @@
+//! Protobuf types and conversions for InferaDB Ledger.
+//!
+//! This crate provides:
+//! - Generated protobuf types and gRPC service traits ([`proto`])
+//! - Bidirectional conversions between domain types and proto types ([`convert`])
+//!
+//! # Architecture
+//!
+//! Extracted from the `raft` crate so that consumers needing only wire-format
+//! types (e.g., the SDK) can avoid pulling in Raft consensus internals.
+
+#![deny(unsafe_code)]
+// gRPC services return tonic::Status (176 bytes) - standard practice for gRPC error handling
+#![allow(clippy::result_large_err)]
+
+/// Generated protobuf types and service traits.
+pub mod proto {
+    #![allow(clippy::all)]
+    #![allow(missing_docs)]
+
+    // Use pre-generated code when proto files aren't available (crates.io)
+    #[cfg(use_pregenerated_proto)]
+    include!("generated/ledger.v1.rs");
+
+    // Use build-time generated code in development
+    #[cfg(not(use_pregenerated_proto))]
+    tonic::include_proto!("ledger.v1");
+}
+
+pub mod convert;