Struct GenericId 

pub struct GenericId<T: IdCategory> { /* private fields */ }

Generic identifier value object for domain entities

Purpose

Provides the foundational ID implementation that all specific entity IDs build upon. This generic approach ensures consistency while allowing type-safe specialization.

Design Principles

• Type Safety: Each entity gets its own distinct ID type
• Validation: Consistent validation rules across all ID types
• Serialization: Uniform JSON/database representation
• Cross-Language: Clear specification for Go implementation

Architecture Notes

This is the base implementation that specific ID value objects compose. It should not be used directly - instead use the specific ID types like PipelineId, StageId, etc.

Cross-Language Mapping

• Rust: GenericId<T> with phantom type parameter
• Go: GenericID[T any] with type parameter
• JSON: String representation of ULID
• SQLite: TEXT column with ULID string
• Time-Ordered: Natural chronological sorting

Implementations

impl<T: IdCategory> GenericId<T>

pub fn new() -> Self

Creates a new time-ordered entity ID with category validation

Time Ordering

ULIDs are naturally sorted by creation time, making them perfect for:

• Database indexes (sequential inserts)
• Event ordering
• Chronological queries
• Debugging (time-based ID inspection)

pub fn from_ulid(ulid: Ulid) -> Result<Self, PipelineError>

Creates an entity ID from an existing ULID with validation

pub fn from_timestamp_ms(timestamp_ms: u64) -> Result<Self, PipelineError>

Creates an entity ID from a timestamp (useful for range queries)

Use Cases

• Creating boundary IDs for time-range queries
• Testing with specific timestamps
• Migration scenarios requiring specific timestamp IDs

pub fn from_string(s: &str) -> Result<Self, PipelineError>

Creates an entity ID from a string representation

Format

Accepts standard ULID string format (26 characters, base32 encoded) Example: “01ARZ3NDEKTSV4RRFFQ69G5FAV”

pub fn as_ulid(&self) -> Ulid

Gets the underlying ULID value

pub fn timestamp_ms(&self) -> u64

Gets the timestamp component of the ULID

Returns

Milliseconds since Unix epoch when this ID was created

Use Cases

• Time-range queries
• Debugging creation times
• Audit trails

pub fn datetime(&self) -> DateTime<Utc>

Gets the creation time as a DateTime

Use Cases

• Human-readable timestamps
• Time-based filtering
• Audit logs

pub fn to_lowercase(&self) -> String

Converts to lowercase string representation

Use Cases

• Case-insensitive systems
• URL paths
• Database systems that prefer lowercase

pub fn category(&self) -> &'static str

Gets the ID category name

pub fn validate(&self) -> Result<(), PipelineError>

Validates the ID using category-specific rules

pub fn is_nil(&self) -> bool

Checks if this is a nil (zero) ULID

Trait Implementations

impl<T: IdCategory> AsRef<Ulid> for GenericId<T>

fn as_ref(&self) -> &Ulid

Converts this type into a shared reference of the (usually inferred) input type.

impl<T: Clone + IdCategory> Clone for GenericId<T>

fn clone(&self) -> GenericId<T>

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<T: Debug + IdCategory> Debug for GenericId<T>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<T: IdCategory> Default for GenericId<T>

fn default() -> Self

Returns the “default value” for a type.

impl<'de, T: IdCategory> Deserialize<'de> for GenericId<T>

fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<T: IdCategory> Display for GenericId<T>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<T: IdCategory> From<GenericId<T>> for Ulid

fn from(id: GenericId<T>) -> Self

Converts to this type from the input type.

impl<T: IdCategory> From<Ulid> for GenericId<T>

fn from(ulid: Ulid) -> Self

Converts to this type from the input type.

impl<T: IdCategory> FromStr for GenericId<T>

type Err = PipelineError

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Self, Self::Err>

Parses a string s to return a value of this type.

impl<T: IdCategory> Hash for GenericId<T>

fn hash<H: Hasher>(&self, state: &mut H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl<T: Ord + IdCategory> Ord for GenericId<T>

fn cmp(&self, other: &GenericId<T>) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl<T: PartialEq + IdCategory> PartialEq for GenericId<T>

fn eq(&self, other: &GenericId<T>) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<T: PartialOrd + IdCategory> PartialOrd for GenericId<T>

fn partial_cmp(&self, other: &GenericId<T>) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

Tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

Tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

Tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl<T: IdCategory> Serialize for GenericId<T>

fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>

where S: Serializer,

Serialize this value into the given Serde serializer.

impl<T: Eq + IdCategory> Eq for GenericId<T>

impl<T: IdCategory> StructuralPartialEq for GenericId<T>