@spec filter_by_max_price([resource()], String.t() | non_neg_integer()) :: [
  resource()
]

Keeps the resources with at least one payment option at or below a price.

The price is compared in atomic token units against each accepted PaymentRequirements entry's amount (falling back to the legacy maxAmountRequired). Entries without a parsable amount never match. Raises ArgumentError when max_price itself is not a non-negative integer or decimal string, since that is a programmer error.

Examples

iex> resources = [
...>   %{resource: "https://a.example", accepts: [%{"scheme" => "exact", "amount" => "10000"}]},
...>   %{resource: "https://b.example", accepts: [%{"scheme" => "exact", "amount" => "250000"}]}
...> ]
iex> resources
...> |> X402.Extensions.Bazaar.filter_by_max_price("100000")
...> |> Enum.map(& &1.resource)
["https://a.example"]

@spec filter_by_network([resource()], String.t()) :: [resource()]

Keeps the resources that accept payment on the given CAIP-2 network.

Examples

iex> resources = [
...>   %{resource: "https://a.example", accepts: [%{"scheme" => "exact", "network" => "eip155:8453"}]},
...>   %{resource: "https://b.example", accepts: [%{"scheme" => "exact", "network" => "solana:mainnet"}]}
...> ]
iex> resources
...> |> X402.Extensions.Bazaar.filter_by_network("eip155:8453")
...> |> Enum.map(& &1.resource)
["https://a.example"]

@spec filter_by_scheme([resource()], String.t()) :: [resource()]

Keeps the resources that accept payment with the given scheme.

Examples

iex> resources = [
...>   %{resource: "https://a.example", accepts: [%{"scheme" => "exact", "network" => "eip155:8453"}]},
...>   %{resource: "https://b.example", accepts: [%{"scheme" => "upto", "network" => "eip155:8453"}]}
...> ]
iex> resources
...> |> X402.Extensions.Bazaar.filter_by_scheme("upto")
...> |> Enum.map(& &1.resource)
["https://b.example"]

@spec list_resources(
  X402.Facilitator.server() | keyword(),
  keyword()
) ::
  {:ok, discovery_response()}
  | {:error,
     X402.Facilitator.Error.t() | NimbleOptions.ValidationError.t() | term()}

Lists discoverable x402 resources from a facilitator's bazaar as typed maps.

Queries GET /discovery/resources through X402.Facilitator.list_resources/2 (accepting the same filter and pagination parameters) and parses every discovered entry with parse_resource/1. Parsing is fail-closed: a structurally invalid entry returns {:error, %X402.Facilitator.Error{type: :malformed_facilitator_response, reason: {:invalid_resource, index, reason}}} instead of partial data.

When called with just a keyword list — list_resources(limit: 20) — the parameters apply to the default X402.Facilitator process name.

Examples

{:ok, %{items: items, pagination: pagination}} =
  X402.Extensions.Bazaar.list_resources(MyFacilitator,
    network: "eip155:8453",
    limit: 20
  )

Enum.map(items, & &1.resource)

@spec parse_resource(term()) :: {:ok, resource()} | {:error, term()}

Parses one raw discovered-resource map into a typed map.

Validates the required fields from the v2 specification (§8.3): resource, type, x402Version, accepts (a list of PaymentRequirements maps), and lastUpdated (Unix timestamp or ISO 8601 string). Optional description, mimeType, metadata, and extensions fields default to nil when absent and are rejected when mistyped.

Examples

iex> {:ok, parsed} = X402.Extensions.Bazaar.parse_resource(%{
...>   "resource" => "https://api.example.com/premium-data",
...>   "type" => "http",
...>   "x402Version" => 2,
...>   "accepts" => [%{"scheme" => "exact", "network" => "eip155:8453", "amount" => "10000"}],
...>   "lastUpdated" => 1_703_123_456
...> })
iex> {parsed.resource, parsed.x402_version, parsed.last_updated}
{"https://api.example.com/premium-data", 2, 1703123456}

iex> X402.Extensions.Bazaar.parse_resource(%{"type" => "http"})
{:error, {:missing_field, "resource"}}

iex> X402.Extensions.Bazaar.parse_resource(%{
...>   "resource" => "https://api.example.com",
...>   "type" => "http",
...>   "x402Version" => 2,
...>   "accepts" => "exact",
...>   "lastUpdated" => 1
...> })
{:error, {:invalid_field, "accepts"}}