List Users

//native

async function getManagementToken(auth: RT.Auth0): Promise<string> {

  const response = await fetch(`https://${auth.domain}/oauth/token`, {

    method: "POST",

    headers: { "Content-Type": "application/json" },

    body: JSON.stringify({

      grant_type: "client_credentials",

      client_id: auth.client_id,

      client_secret: auth.client_secret,

      audience: `https://${auth.domain}/api/v2/`,

    }),

  })

  if (!response.ok) {

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

  }

  const { access_token } = (await response.json()) as { access_token: string }

  return access_token

}

/**

 * List Users

 * Search and list users in the tenant. Use `q` (Lucene query syntax, e.g. email:"jane@example.com") to filter; page and per_page paginate.

 */

export async function main(

  auth: RT.Auth0,

  q: string | undefined,

  page: number | undefined,

  per_page: number | undefined,

  sort: string | undefined,

  include_totals: boolean | undefined

) {

  const token = await getManagementToken(auth)

  const url = new URL(`https://${auth.domain}/api/v2/users`)

  if (q !== undefined && q !== "") {

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

    url.searchParams.append("search_engine", "v3")

  }

  if (page !== undefined) url.searchParams.append("page", String(page))

  if (per_page !== undefined)

    url.searchParams.append("per_page", String(per_page))

  if (sort !== undefined && sort !== "") url.searchParams.append("sort", sort)

  if (include_totals !== undefined)

    url.searchParams.append("include_totals", String(include_totals))

  const response = await fetch(url, {

    method: "GET",

    headers: {

      Authorization: `Bearer ${token}`,

      Accept: "application/json",

    },

  })

  if (!response.ok) {

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

  }

  return await response.json()

}