Struct StoredResource 

pub struct StoredResource { /* private fields */ }

A FHIR resource with persistence metadata.

StoredResource wraps a FHIR resource (stored as JSON) along with metadata required for persistence operations:

• Identity: Resource type and ID
• Versioning: Version ID for optimistic locking
• Tenancy: Tenant that owns the resource
• FHIR Version: The FHIR specification version (R4, R4B, R5, R6)
• Timestamps: Creation, modification, and deletion times
• ETag: For HTTP caching and conditional updates

Examples

use helios_persistence::types::StoredResource;
use helios_persistence::tenant::TenantId;
use helios_fhir::FhirVersion;
use serde_json::json;

let resource = StoredResource::new(
    "Patient",
    "123",
    TenantId::new("acme"),
    json!({
        "resourceType": "Patient",
        "id": "123",
        "name": [{"family": "Smith"}]
    }),
    FhirVersion::default(),
);

assert_eq!(resource.resource_type(), "Patient");
assert_eq!(resource.id(), "123");
assert_eq!(resource.version_id(), "1");

Implementations

impl StoredResource

pub fn new( resource_type: impl Into<String>, id: impl Into<String>, tenant_id: TenantId, content: Value, fhir_version: FhirVersion, ) -> Self

Creates a new stored resource with the given properties.

This creates a new resource with:

• Version ID set to “1”
• Created and last_modified set to current time
• ETag derived from version ID

pub fn from_storage( resource_type: impl Into<String>, id: impl Into<String>, version_id: impl Into<String>, tenant_id: TenantId, content: Value, created_at: DateTime<Utc>, last_modified: DateTime<Utc>, deleted_at: Option<DateTime<Utc>>, fhir_version: FhirVersion, ) -> Self

Creates a stored resource from existing data (e.g., loaded from database).

pub fn resource_type(&self) -> &str

Returns the FHIR resource type.

pub fn id(&self) -> &str

Returns the resource’s logical ID.

pub fn version_id(&self) -> &str

Returns the version ID.

pub fn tenant_id(&self) -> &TenantId

Returns the tenant that owns this resource.

pub fn fhir_version(&self) -> FhirVersion

Returns the FHIR specification version of this resource.

pub fn content(&self) -> &Value

Returns the resource content as JSON.

pub fn content_mut(&mut self) -> &mut Value

Returns a mutable reference to the resource content.

pub fn into_content(self) -> Value

Consumes self and returns the content.

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

Returns when the resource was created.

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

Returns when the resource was last modified.

pub fn deleted_at(&self) -> Option<DateTime<Utc>>

Returns when the resource was deleted, if applicable.

pub fn is_deleted(&self) -> bool

Returns true if the resource has been deleted.

pub fn etag(&self) -> &str

Returns the ETag for HTTP caching.

pub fn method(&self) -> Option<ResourceMethod>

Returns the HTTP method that created this version.

pub fn url(&self) -> String

Returns the full URL path for this resource (e.g., “Patient/123”).

pub fn versioned_url(&self) -> String

Returns the versioned URL path (e.g., “Patient/123/_history/1”).

pub fn new_version(self, content: Value, method: ResourceMethod) -> Self

Creates a new version of this resource with updated content.

The new version will have:

• Incremented version ID
• Updated last_modified timestamp
• New ETag
• Same FHIR version as the original

pub fn mark_deleted(self) -> Self

Marks this resource as deleted.

Creates a new version with the deleted_at timestamp set.

pub fn matches_etag(&self, etag: &str) -> bool

Checks if the given ETag matches this resource’s ETag.

Used for If-Match conditional updates.

pub fn meta(&self) -> ResourceMeta

Returns the FHIR Meta element for this resource.

Trait Implementations

impl Clone for StoredResource

fn clone(&self) -> StoredResource

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for StoredResource

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for StoredResource

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for StoredResource

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

where __S: Serializer,

Serialize this value into the given Serde serializer.