Struct Atom 

pub struct Atom { /* private fields */ }

An immutable data container that represents a single version of content in the database.

Atoms are the fundamental building blocks of the database’s immutable data storage system. Each Atom contains:

• A unique identifier
• The source schema that defines its structure
• The public key of the creator
• Creation timestamp
• Optional reference to a previous version
• The actual content data

Atoms form a chain of versions through their prev_atom_uuid references, enabling complete version history tracking. Once created, an Atom’s content cannot be modified, ensuring data immutability.

Implementations

impl Atom

pub fn new( source_schema_name: String, source_pub_key: String, content: Value, ) -> Self

Creates a new Atom with the given parameters.

Arguments

• source_schema_name - Name of the schema that defines this Atom’s structure
• source_pub_key - Public key of the entity creating this Atom
• content - The actual data content stored in this Atom

Returns

A new Atom instance with a content-based UUID and current timestamp

pub fn with_prev_version(self, prev_atom_uuid: String) -> Self

Creates a new Atom that references a previous version

pub fn with_source_file_name(self, file_name: String) -> Self

Sets the source file name for atoms created from file uploads

pub fn with_status(self, status: AtomStatus) -> Self

pub const fn content(&self) -> &Value

Returns a reference to the Atom’s content.

This method provides read-only access to the stored data, maintaining the immutability principle.

pub fn set_status(&mut self, status: AtomStatus)

pub fn get_transformed_content(&self, transform: &str) -> Value

Applies a transformation to the Atom’s content and returns the result.

Currently supports:

• “lowercase”: Converts string content to lowercase

If the transformation is not recognized or cannot be applied, returns a clone of the original content.

Arguments

• transform - The name of the transformation to apply

pub fn uuid(&self) -> &str

Returns the unique identifier of this Atom.

This UUID uniquely identifies this specific version of the data and is used by Molecules to point to the current version.

pub fn source_schema_name(&self) -> &str

Returns the name of the schema that defines this Atom’s structure.

The schema name is used to validate the content structure and determine applicable permissions and payment requirements.

pub fn source_pub_key(&self) -> &str

Returns the public key of the entity that created this Atom.

This is used for authentication and permission validation when accessing or modifying the data.

pub fn source_file_name(&self) -> Option<&String>

Returns the original filename if this atom was created from a file upload.

This is used for tracking data provenance and auditing purposes.

pub const fn created_at(&self) -> DateTime<Utc>

Returns the timestamp when this Atom was created.

This timestamp is used for auditing and version history tracking.

pub const fn prev_atom_uuid(&self) -> Option<&String>

Returns the UUID of the previous version of this data, if any.

This forms the chain of version history, allowing traversal through all previous versions of the data.

Trait Implementations

impl Clone for Atom

fn clone(&self) -> Atom

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Atom

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Atom

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for Atom

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.