Struct RenderService 

pub struct RenderService { /* private fields */ }

Top-level service that batches MDX rendering requests.

This service manages a pool of JavaScript renderers and provides batch rendering capabilities for MDX content. It handles resource limits, error recovery, and renderer lifecycle management.

Implementations

impl RenderService

pub fn new(config: RenderServiceConfig) -> Result<Self, String>

Creates a new render service with the given configuration.

Configuration is always validated, even in release builds.

Arguments

• config - Service configuration including static directory and resource limits

Returns

Ok(RenderService) if configuration is valid, Err with validation error if invalid

pub fn new_with_validation(config: RenderServiceConfig) -> Result<Self, String>

Creates a new render service with configuration validation.

This is an alias for new() which always validates configuration. Kept for backward compatibility.

Arguments

• config - Service configuration including static directory and resource limits

Returns

Ok(RenderService) if configuration is valid, Err with validation error if invalid

pub fn config(&self) -> &RenderServiceConfig

Returns a reference to the service configuration.

pub fn pool(&self) -> &RendererPool

Returns a reference to the renderer pool.

This is primarily useful for testing and advanced use cases.

pub fn render_batch( &self, input: &NamedMdxBatchInput, ) -> Result<BatchRenderOutcome, RenderBatchError>

Renders a batch of MDX files.

Error Recovery Strategy

This function implements graceful error recovery: individual file failures don’t stop the batch processing. Errors are collected and returned in the BatchRenderOutcome, allowing partial success scenarios. This is important for batch operations where some files may be invalid while others are valid.

Public API Error Type Consistency

This function returns Result<BatchRenderOutcome, RenderBatchError>, which is consistent with the service boundary pattern:

• Domain functions return Result<T, MdxError> (domain-specific errors)
• Service functions return Result<T, RenderBatchError> (service-level errors)
• HTTP handlers convert to anyhow::Error (framework-level errors)

Arguments

• input - Batch input containing MDX content, components, and settings

Returns

A BatchRenderOutcome containing rendered files and any errors

Errors

Returns RenderBatchError if resource limits are exceeded, custom engines are disabled but requested, or internal errors occur during rendering.

Trait Implementations

impl Clone for RenderService

fn clone(&self) -> RenderService

Returns a duplicate of the value.

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

Performs copy-assignment from source.