@spec build_exchange!(String.t(), map(), map()) :: Bourse.Exchange.t()

Builds an offline replay exchange with fixture case options merged.

The market and currency reference caches supply cache-derived fields needed by accepted-request reconstruction and focused parser tests.

@spec capture_category(String.t(), atom()) ::
  Bourse.RecordedResponseFixtures.Capture.category() | nil

Returns the capture category for a configured target.

@spec capture_fixture(String.t(), atom(), keyword()) ::
  {:ok, map()} | {:error, term()}

Captures and scrubs one configured live response fixture.

@spec capture_targets() :: [{String.t(), atom()}]

Returns every {venue, method} pair supported by the live capture pipeline.

@spec currencies_fixture_path(String.t()) :: String.t()

Absolute path to a venue's static currencies cache.

@spec currencies_root() :: String.t()

Directory for recorded currencies caches.

@spec decode_call_opts(map()) :: keyword()

Decodes persisted call_opts from a legacy fixture JSON map.

@spec error_fixture_root() :: String.t()

Root directory for committed real error recordings.

@spec fixture_file_id(String.t()) :: String.t()

Returns the on-disk fixture filename id for a venue.

@spec fixture_path(String.t(), atom()) :: String.t()

Absolute path for a legacy recorded response fixture file.

@spec fixture_root() :: String.t()

Root directory for legacy recorded response fixtures.

@spec infer_market_type(map()) :: String.t()

Infers a coarse market-type label from a fixture case (for coverage reporting).

@spec load_fixture!(String.t()) :: map()

Loads and decodes a static fixture JSON file.

@spec markets_fixture_path(String.t()) :: String.t()

Absolute path to a venue's static markets cache.

@spec markets_root() :: String.t()

Directory for recorded markets caches.

@spec oracle_identity(String.t(), atom()) :: map() | nil

Returns stable oracle identity fields for a configured target.

@spec required_credentials(String.t(), atom()) :: [String.t()] | nil

Returns the environment variables required by one capture target.

@spec safety_violations(term()) :: [String.t()]

Returns corpus paths whose sensitive fields are not masked.

@spec scrub_fixture(term(), Bourse.Credentials.t() | nil) :: term()

Recursively masks credential and account identity material in a fixture.

@spec static_root() :: String.t()

Root for vendored market and currency reference caches.