Phoenix router macros for mounting UCP and ACP routes.

Usage

defmodule MyAppWeb.Router do
  use Phoenix.Router
  use Bazaar.Phoenix.Router

  pipeline :api do
    plug :accepts, ["json"]
    plug Bazaar.Plugs.UCP
  end

  # Optional: Add schema validation
  pipeline :bazaar_validated do
    plug Bazaar.Plugs.ValidateRequest
    plug Bazaar.Plugs.ValidateResponse
  end

  scope "/" do
    pipe_through [:api, :bazaar_validated]

    # UCP protocol (default)
    bazaar_routes "/", MyApp.Commerce.Handler

    # ACP protocol
    bazaar_routes "/acp", MyApp.Commerce.Handler, protocol: :acp
  end
end

Schema Validation

Bazaar includes plugs for validating requests and responses against Smelter-generated Ecto schemas:

• Bazaar.Plugs.ValidateRequest - Validates incoming request bodies
• Bazaar.Plugs.ValidateResponse - Validates outgoing response bodies

Both plugs are optional but recommended for catching schema violations early in development.

Generated Routes (UCP)

Generated Routes (ACP)

ACP uses slightly different URL patterns and HTTP methods:

Note: ACP does not have a discovery endpoint.

Options

bazaar_routes "/api/v1", MyApp.Handler,
  protocol: :ucp,               # Protocol: :ucp (default) or :acp
  only: [:checkout, :orders],   # Limit capabilities
  discovery: true,              # Include discovery endpoint (UCP only)
  webhooks: true,               # Include webhook endpoint
  order_updates: false,         # Mount PUT /orders/:id (beyond the spec's REST binding)
  validate_requests: true,      # Enable request validation (requires plug in pipeline)
  validate_responses: true      # Enable response validation (requires plug in pipeline)