TIER API Rules

extends: [[spectral:oas, all]]
rules:
  tier-info-contact:
    description: TIER/Dott OpenAPI must declare an info.contact block.
    severity: warn
    given: $.info
    then:
      field: contact
      function: truthy
  tier-operation-id-camel:
    description: All operationIds use camelCase.
    severity: warn
    given: $.paths.*[get,post,put,delete,patch]
    then:
      field: operationId
      function: pattern
      functionOptions:
        match: '^[a-z][a-zA-Z0-9]+$'
  tier-tag-title-case:
    description: Tags use Title Case.
    severity: warn
    given: $.tags[*].name
    then:
      function: pattern
      functionOptions:
        match: '^[A-Z][A-Za-z0-9 ]+$'
  tier-summary-title-case:
    description: Operation summaries are written in Title Case.
    severity: warn
    given: $.paths.*[get,post,put,delete,patch].summary
    then:
      function: pattern
      functionOptions:
        match: '^(?:[A-Z][a-zA-Z0-9]*)(?:\s+[A-Za-z0-9]+)*$'
  tier-gbfs-system-id-param:
    description: City-scoped feeds must accept the {system_id} path parameter.
    severity: warn
    given: $.paths['/{system_id}/gbfs.json'].get.parameters
    then:
      function: truthy