@itslanguage/api/organisations/index.js

The JavaScript API SDK for ITSLanguage.

import "core-js/modules/es.array.iterator";
import "core-js/modules/es.promise";
import "core-js/modules/es.regexp.to-string";
import "core-js/modules/web.dom-collections.iterator";
import "core-js/modules/web.url";

/**
 * This file contains the readily available functions which interact with the ITSLanguage
 * organisation API.
 *
 * @module api/organisations
 */
import { authorisedRequest } from '../communication';
/**
 * The URL for the organisation handler(s).
 * @type {string}
 */

var url = '/organisations';
/**
 * Create a new organisation.
 *
 * @param {Object} organisation - The organisation to create.
 * @param {string} [organisation.id] - The organisation id. If none is given, one is generated.
 * @param {Array} organisation.name - The name of the organisation.
 *
 * @returns {Promise} - The organisation creation promise.
 */

export function create(organisation) {
  return authorisedRequest('POST', url, organisation);
}
/**
 * Get a single organisation by its ID.
 *
 * @param {string} id - The ID of the desired organisation.
 *
 * @returns {Promise} - The promise for the organisation.
 */

export function getById(id) {
  return authorisedRequest('GET', url + "/" + id);
}
/**
 * Get a all organisations.
 *
 * By default all organisations are fetched though it is allowed to pass filters as a
 * `URLSearchParams` object.
 *
 * @param {URLSearchParams} [filters] - The filters to apply to the category list.
 *
 * @throws {Promise<string>} - If the given optional filters are not an instance of
 * `URLSearchParams`.
 *
 * @returns {Promise} - The promise for the organisations.
 */

export function getAll(filters) {
  var urlWithFilters = url;

  if (filters) {
    if (!(filters instanceof URLSearchParams)) {
      return Promise.reject(new Error('The filters should be a `URLSearchParams` object.'));
    }

    urlWithFilters += "?" + filters.toString();
  }

  return authorisedRequest('GET', urlWithFilters);
}