feat: resolve server url

[DmitryAnansky]

What/Why/How?

As openapiOperation.servers[0] already have servers resolved with priority of Operation--Path--Root (from higher to lower) we extend it to also resolve complex server url description with variables, default value will be selected and resolved in the final server url.

  - url: https://{region}-server-with-vars.com/v1
    description: Regional server
    variables:
      region:
        default: us
        enum:
          - us
          - eu
          - asia

Reference

Closes: https://github.com/Redocly/redocly/issues/11205

Testing

openapi: 3.1.0
info:
  title: Minimal API
  version: 1.0.0
security: []
servers:
  - url: https://{region}.{task}-server-with-vars.{domain}/v1
    description: Regional server
    variables:
      region:
        default: us
        enum:
          - us
          - eu
          - asia
      task:
        default: ping
      domain:
        default: com
  - url: https://top-level-server.com
    description: Production server
  - url: https://top-level-server-2.com
    description: Staging server
paths:
  /ping:
    servers:
      - url: https://path-level-server.com
        description: Ping-specific server
    get:
      operationId: ping
      summary: Ping the server
      servers:
        - url: https://{region}@{task}.{region}.operation-level.com/v1
          description: Regional server
          variables:
            region:
              default: us
              enum:
                - us
                - eu
                - asia
            task:
              default: ping
      responses:
        '200':
          description: Successful response

arazzo: 1.0.1
info:
  title: servers
  description: servers
  version: 1.0.0

sourceDescriptions:
  - name: servers
    type: openapi
    url: api-servers.yaml

workflows:
  - workflowId: get-servers
    description: get servers
    steps:
      - stepId: ping
        operationId: ping

Screenshots (optional)

Check yourself

• Code changed? - Tested with redoc/reference-docs/workflows (internal)
• All new/updated code is covered with tests
• New package installed? - Tested in different environments (browser/node)

Security

• Security impact of change has been considered
• Code follows company security practices and guidelines

[changeset-bot]

⚠️ No Changeset found

Latest commit: 697d11a

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

[github-actions]

Coverage report

St.❔	Category	Percentage	Covered / Total
🟡	Statements	79.57%	6922/8699
🟡	Branches	68.89%	2868/4163
🟡	Functions	75.55%	1140/1509
🟡	Lines	79.94%	6595/8250

Show files with reduced coverage 🔻

St.❔	File	Statements	Branches	Functions	Lines
🟡	... / get-request-data-from-openapi.ts	67.86% (-10.71% 🔻)	68.18% (-1.82% 🔻)	66.67% (-11.11% 🔻)	67.86% (-10.71% 🔻)

Test suite run success

1323 tests passing in 189 suites.

Report generated by 🧪jest coverage report action from 697d11a