The schema of a table

//native

type Grist = {

  apiKey: string;

  host: string;

};

/**

 * The schema of a table

 * The schema follows [frictionlessdata's table-schema standard](https://specs.frictionlessdata.io/table-schema/).

 */

export async function main(

  auth: Grist,

  docId: string,

  tableId: string | undefined,

  header: "colId" | "label" | undefined,

) {

  const url = new URL(

    `https://${auth.host}/api/docs/${docId}/download/table-schema`,

  );

  for (const [k, v] of [

    ["tableId", tableId],

    ["header", header],

  ]) {

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

      url.searchParams.append(k, v);

    }

  }

  const response = await fetch(url, {

    method: "GET",

    headers: {

      Authorization: "Bearer " + auth.apiKey,

    },

    body: undefined,

  });

  if (!response.ok) {

    const text = await response.text();

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

  }

  return await response.text();

}