Create collaboration

//native

type Box = {

  token: string;

};

/**

 * Create collaboration

 * Adds a collaboration for a single user or a single group to a file

or folder.

 */

export async function main(

  auth: Box,

  fields: string | undefined,

  notify: string | undefined,

  body: {

    item: { type?: "file" | "folder"; id?: string };

    accessible_by: { type: "user" | "group"; id?: string; login?: string };

    role:

      | "editor"

      | "viewer"

      | "previewer"

      | "uploader"

      | "previewer uploader"

      | "viewer uploader"

      | "co-owner";

    is_access_only?: false | true;

    can_view_path?: false | true;

    expires_at?: string;

  },

) {

  const url = new URL(`https://api.box.com/2.0/collaborations`);

  for (const [k, v] of [

    ["fields", fields],

    ["notify", notify],

  ]) {

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

      url.searchParams.append(k, v);

    }

  }

  const response = await fetch(url, {

    method: "POST",

    headers: {

      "Content-Type": "application/json",

      Authorization: "Bearer " + auth.token,

    },

    body: JSON.stringify(body),

  });

  if (!response.ok) {

    const text = await response.text();

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

  }

  return await response.json();

}