Retrieves a list of categories

//native

type Discourse = {

  apiKey: string;

  defaultHost: string;

  apiUsername: string;

};

/**

 * Retrieves a list of categories

 *

 */

export async function main(

  auth: Discourse,

  include_subcategories: "true" | undefined,

) {

  const url = new URL(`https://${auth.defaultHost}/categories.json`);

  for (const [k, v] of [["include_subcategories", include_subcategories]]) {

    if (v !== undefined && v !== "" && k !== undefined) {

      url.searchParams.append(k, v);

    }

  }

  const response = await fetch(url, {

    method: "GET",

    headers: {

      "API-KEY": auth.apiKey,

      "API-USERNAME": auth.apiUsername,

    },

    body: undefined,

  });

  if (!response.ok) {

    const text = await response.text();

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

  }

  return await response.json();

}