Search fixed addresses

//native

function wapiUrl(auth: RT.InfobloxNios, path: string) {

  const host = auth.host

    .trim()

    .replace(/^https?:\/\//, "")

    .replace(/\/+$/, "")

  const version = auth.wapi_version.trim().replace(/^v/, "")

  return new URL(`https://${host}/wapi/v${version}/${path}`)

}

function basicAuth(auth: RT.InfobloxNios) {

  const bytes = new TextEncoder().encode(`${auth.username}:${auth.password}`)

  return `Basic ${btoa(String.fromCharCode(...bytes))}`

}

async function wapiError(response: Response) {

  const text = await response.text()

  if (response.status === 401) {

    return new Error(

      "401 Unauthorized: wrong username or password, or the user's admin group has no API access"

    )

  }

  try {

    // WAPI errors are JSON: {"Error": "AdmConDataNotFoundError: ...", "code": "Client.Ibap.Data.NotFound", "text": "..."}

    const { Error: error, code, text: detail } = JSON.parse(text)

    if (error) {

      const message =

        detail && !error.includes(detail) ? `${error}: ${detail}` : error

      return new Error(

        `${response.status} ${message}${code ? ` (${code})` : ""}`

      )

    }

  } catch {}

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

}

/**

 * Search fixed addresses

 * Search static DHCP reservations (fixedaddress) by MAC address (any of aa:bb:cc:dd:ee:ff, AA-BB-CC-DD-EE-FF or aabb.ccdd.eeff), IPv4 address, network CIDR, network view or extensible attribute values (extattr_filters {"Site": "Paris"}), one page at a time. Pass the returned next_page_id as page_id to get the next page; it is null on the last page.

 */

export async function main(

  auth: RT.InfobloxNios,

  mac: string | undefined,

  ipv4addr: string | undefined,

  network: string | undefined,

  network_view: string | undefined,

  extattr_filters: { [key: string]: string } | undefined,

  max_results: number | undefined,

  page_id: string | undefined,

  return_fields: string[] | undefined

) {

  const url = wapiUrl(auth, "fixedaddress")

  if (mac) {

    // NIOS stores MACs as aa:bb:cc:dd:ee:ff; accept AA-BB-..., aabb.ccdd.eeff and bare hex.

    const hex = mac

      .trim()

      .toLowerCase()

      .replace(/[^0-9a-f]/g, "")

    url.searchParams.append(

      "mac",

      hex.length === 12 ? hex.match(/../g)!.join(":") : mac.trim().toLowerCase()

    )

  }

  if (ipv4addr) url.searchParams.append("ipv4addr", ipv4addr)

  if (network) url.searchParams.append("network", network)

  if (network_view) url.searchParams.append("network_view", network_view)

  for (const [name, value] of Object.entries(extattr_filters ?? {})) {

    if (value != null && value !== "")

      url.searchParams.append(`*${name}`, String(value))

  }

  const fields = [

    "mac",

    "name",

    "network",

    "comment",

    "extattrs",

    ...(return_fields ?? []),

  ]

  url.searchParams.append("_return_fields+", fields.join(","))

  url.searchParams.append("_paging", "1")

  url.searchParams.append("_return_as_object", "1")

  url.searchParams.append("_max_results", String(max_results || 100))

  if (page_id) url.searchParams.append("_page_id", page_id)

  const response = await fetch(url, {

    headers: {

      Authorization: basicAuth(auth),

      Accept: "application/json",

    },

  })

  if (!response.ok) {

    throw await wapiError(response)

  }

  const data = await response.json()

  return { result: data.result, next_page_id: data.next_page_id ?? null }

}