PraugaFlexDoc.HostExecution (prauga_flexdoc v0.4.5)

Framework-neutral implementation of FlexDoc's existing API-host execution envelope.

This first native Elixir slice intentionally advertises no host-only capabilities.

Summary

result()

t()

uploaded_file()

Validates the marker and executes one canonical FlexDoc request envelope.

Creates a native executor from a non-empty exact HTTP(S) origin allowlist.

@type result() :: %{status: pos_integer(), body: map()}

@type t() :: %PraugaFlexDoc.HostExecution{allowed_origins: MapSet.t(String.t())}

@type uploaded_file() :: %{
  filename: String.t(),
  content_type: String.t(),
  data: binary()
}

@spec handle(t(), String.t() | nil, term(), %{
  optional(non_neg_integer()) => uploaded_file()
}) ::
  result()

Validates the marker and executes one canonical FlexDoc request envelope.

@spec new!([String.t()]) :: t()

Creates a native executor from a non-empty exact HTTP(S) origin allowlist.