Rendro.Artifact (Rendro v0.2.0)

A pure data carrier containing the rendered PDF bytes, a deterministic hash, and structured diagnostics from the render pipeline.

This is the primary boundary struct for async and ecosystem operations.

Summary

t()

Creates a new Artifact from the generated binary and the final Document. Hashes the binary using SHA-256 for deterministic caching and verification.

Wraps a transformed binary in a new artifact while preserving diagnostics and merging metadata from the source artifact.

@type t() :: %Rendro.Artifact{
  binary: binary(),
  diagnostics: [map()],
  hash: String.t(),
  metadata: map()
}

@spec new(binary(), Rendro.Document.t(), map()) :: t()

Creates a new Artifact from the generated binary and the final Document. Hashes the binary using SHA-256 for deterministic caching and verification.

@spec wrap(binary(), t(), map()) :: t()

Wraps a transformed binary in a new artifact while preserving diagnostics and merging metadata from the source artifact.