Struct MarkdownService

pub struct MarkdownService;

Service for markdown validation and sanitisation.

Implementations

impl MarkdownService

pub fn new() -> Self

Creates a new MarkdownService instance.

pub fn message_render( &self, metadata: &MessageMetadata, body: &NonEmptyText, corrects: Option<Uuid>, ) -> PatientResult<NonEmptyText>

Validates and sanitises markdown content for coordination thread messages.

Constructs properly formatted markdown from message metadata and body content. Escapes markdown syntax in body to prevent unintended formatting whilst preserving readability.

Body escaping rules:

• # at line start → \# (prevents headers)
• Triple backticks → \``` (prevents code blocks)
• Standalone ---, ***, ___ → escaped (prevents horizontal rules)

Message format produced:

**Message ID:** <uuid>
**Timestamp:** <iso8601>
**Author ID:** <uuid>
**Author name:** <name>
**Author role:** <role>
**Corrects:** <uuid> (optional)

Body content here

Arguments

• metadata - Message metadata containing ID, timestamp, and author details
• body - User-provided content to be escaped (guaranteed non-empty by type)
• corrects - Optional UUID of message being corrected

Returns

Formatted markdown message with metadata and escaped body content.

Errors

Returns PatientError::InvalidInput if role serialization fails.

pub fn thread_render(&self, messages: &[Message]) -> PatientResult<NonEmptyText>

Renders multiple messages into a complete markdown thread.

Takes a collection of messages and renders them all to markdown format. Each message is rendered with its metadata and body, separated by horizontal rules. The thread starts with a level-1 header “# Thread”.

Arguments

• messages - Slice of messages to render

Returns

Complete markdown content with all messages rendered and separated.

Errors

Returns PatientError::InvalidInput if any message has an empty body.

pub fn thread_parse(&self, content: &str) -> PatientResult<Vec<Message>>

Parses a markdown thread file into structured messages.

Reads a complete coordination thread from markdown format, splitting on horizontal rules (---) to separate individual messages. Each message is parsed to extract variables and body content with markdown escaping reversed. The thread-level header (level-1) is ignored as it’s not part of individual messages.

Thread format expected:

# Thread Title

**Variable1:** Value1
**Variable2:** Value2

Body content here

---

**Variable1:** Value1

Next message
...

Arguments

• content - Complete markdown content from messages.md file

Returns

Vector of parsed Message structures with strong typing.

Errors

Returns PatientError::InvalidInput if content cannot be parsed correctly.

Trait Implementations

impl Clone for MarkdownService

fn clone(&self) -> MarkdownService

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for MarkdownService

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

Formats the value using the given formatter.

impl Default for MarkdownService

fn default() -> Self

Returns the “default value” for a type.