Get library analytics usage data.

//native

type Figma = {

  token: string;

};

/**

 * Get library analytics usage data.

 * Returns a list of library analytics usage data broken down by the requested dimension.

 */

export async function main(

  auth: Figma,

  file_key: string,

  cursor: string | undefined,

  group_by: "component" | "file" | undefined,

  order: "asc" | "desc" | undefined,

) {

  const url = new URL(

    `https://api.figma.com/v1/analytics/libraries/${file_key}/usages`,

  );

  for (const [k, v] of [

    ["cursor", cursor],

    ["group_by", group_by],

    ["order", order],

  ]) {

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

      url.searchParams.append(k, v);

    }

  }

  const response = await fetch(url, {

    method: "GET",

    headers: {

      Authorization: "Bearer " + auth.token,

    },

    body: undefined,

  });

  if (!response.ok) {

    const text = await response.text();

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

  }

  return await response.json();

}