List Boards

//native

/**

 * List Boards

 * List Jira Software boards, optionally filtered by type, name or project. Paginated with `start_at` / `max_results`; the response carries `isLast`.

 */

export async function main(

  auth: RT.Jira,

  type: "scrum" | "kanban" | "simple" | undefined,

  name: string | undefined,

  project_key_or_id: string | undefined,

  start_at: number | undefined,

  max_results: number | undefined

) {

  const url = new URL(

    `https://${auth.domain}.atlassian.net/rest/agile/1.0/board`

  )

  if (type != null && type !== "") {

    url.searchParams.append("type", type)

  }

  if (name != null && name !== "") {

    url.searchParams.append("name", name)

  }

  if (project_key_or_id != null && project_key_or_id !== "") {

    url.searchParams.append("projectKeyOrId", project_key_or_id)

  }

  if (start_at != null) {

    url.searchParams.append("startAt", String(start_at))

  }

  if (max_results != null) {

    url.searchParams.append("maxResults", String(max_results))

  }

  const response = await fetch(url, {

    method: "GET",

    headers: {

      Authorization: `Basic ${btoa(`${auth.username}:${auth.password}`)}`,

      Accept: "application/json",

    },

  })

  if (!response.ok) {

    throw new Error(`${response.status} ${await response.text()}`)

  }

  return await response.json()

}