stateset-primitives

Strongly-typed primitive types for commerce applications in Rust. Prevents entire classes of bugs at compile time by making it impossible to confuse an OrderId with a CustomerId, or to add Money in different currencies.

Features

• Newtype IDs: OrderId, CustomerId, ProductId, ShipmentId, PaymentId, InventoryItemId, SubscriptionId, CartId, and 9 more — all Copy + Eq + Hash + Serialize + Display
• Money: Amount + currency pair that prevents arithmetic across currencies
• CurrencyCode: Three-letter uppercase currency codes with zero-allocation storage (USD, EUR, GBP, ...)
• Sku: Validated product SKU — trimmed, non-empty, at most 128 characters
• Zero unsafe code, #[deny(unsafe_code)]

Usage

use stateset_primitives::{OrderId, CustomerId, Money, CurrencyCode, Sku};
use rust_decimal_macros::dec;
use uuid::Uuid;

// Type-safe IDs — can't accidentally swap them
let order_id: OrderId = Uuid::new_v4().into();
let customer_id: CustomerId = Uuid::new_v4().into();

// Money is currency-aware
let price = Money::new(dec!(29.99), CurrencyCode::USD);

// SKUs are validated and trimmed on construction
let sku = Sku::new("WBH-001").unwrap();
assert_eq!(sku.as_str(), "WBH-001");
assert!(Sku::new("   ").is_err());

Feature Flags

Part of StateSet iCommerce

The foundation every other crate builds on — stateset-core models, stateset-db storage, and stateset-pricing calculations all speak these types. Part of the StateSet iCommerce engine.

License

MIT OR Apache-2.0