feat(trogon-std): expose uuid v7 generator (#133)

Signed-off-by: Yordis Prieto <yordis.prieto@gmail.com>

Author: yordis

rsworkspace/AGENTS.md

@@ -0,0 +1,2 @@
+Always use `enum` over booleans in the edges such as HTTP, gRPC, Databases, etc,
+

rsworkspace/Cargo.lock

@@ -1,5 +1,7 @@
 Prefer domain-specific value objects over primitives (e.g. `AcpPrefix` not `String`). Each type's factory must guarantee correctness at construction—invalid instances should be unrepresentable. Validate per-type, not per-aggregate: avoid validating unrelated fields together in a single constructor.
 
+Untrusted input must use distinct `*Input` / `*Wire` / `*Request` types. Convert those boundary types into domain types exactly once. After conversion, domain values must be valid forever. Do not add `validate_foo(...)` helpers over a supposed domain struct; if a struct still needs a validator to be safe, it is not a domain type yet. Persist only validated domain types to storage, events, and runtime state. Never persist wire/input types.
+
 Every value object lives in its own file named after the type (e.g. `acp_prefix.rs`, `ext_method_name.rs`, `session_id.rs`). Never inline a value object into a config, aggregate, or service file. File layout: `src/{type_snake_case}.rs`; export in `lib.rs` as `pub use {module}::{Type, TypeError}`.
 
 Errors must be typed—use structs or enums, never `String` or `format!()`. Every error type must implement `Display` and `std::error::Error`. Never discard error context by converting a typed error into a string; wrap the source error as a field or variant instead.

rsworkspace/crates/AGENTS.md

@@ -9,6 +9,7 @@ workspace = true
 [features]
 test-support = []
 clap = ["dep:clap"]
+uuid = ["dep:uuid"]
 telemetry-http = [
     "dep:axum",
     "dep:opentelemetry",
@@ -29,6 +30,7 @@ serde_json = { workspace = true }
 tower-http = { workspace = true, optional = true }
 tracing = { workspace = true, optional = true }
 tracing-opentelemetry = { workspace = true, optional = true }
+uuid = { workspace = true, optional = true }
 
 [dev-dependencies]
 tokio = { workspace = true, features = ["macros", "rt-multi-thread"] }

rsworkspace/crates/trogon-std/Cargo.toml

@@ -41,6 +41,8 @@ pub mod secret_string;
 #[cfg(feature = "telemetry-http")]
 pub mod telemetry;
 pub mod time;
+#[cfg(feature = "uuid")]
+pub mod uuid;
 
 #[cfg(all(feature = "clap", not(coverage)))]
 pub use args::CliArgs;
@@ -57,3 +59,5 @@ pub use json::FailNextSerialize;
 pub use json::{JsonSerialize, StdJsonSerialize};
 pub use secret_string::{EmptySecret, SecretString};
 pub use time::{EpochClock, GetElapsed, GetNow, SystemClock};
+#[cfg(feature = "uuid")]
+pub use uuid::{NowV7, UuidV7Generator};

rsworkspace/crates/trogon-std/src/lib.rs

@@ -0,0 +1,25 @@
+use uuid::Uuid;
+
+pub trait NowV7 {
+    fn now_v7(&self) -> Uuid;
+}
+
+#[derive(Debug, Clone, Copy, Default, PartialEq, Eq)]
+pub struct UuidV7Generator;
+
+impl NowV7 for UuidV7Generator {
+    fn now_v7(&self) -> Uuid {
+        Uuid::now_v7()
+    }
+}
+
+#[cfg(test)]
+mod tests {
+    use super::{NowV7, UuidV7Generator};
+
+    #[test]
+    fn v7_generator_produces_version_7_uuids() {
+        let uuid = UuidV7Generator.now_v7();
+        assert_eq!(uuid.get_version_num(), 7);
+    }
+}