Function fetchResource

lib/src/client.ts:26–87

(
  subject: string,
  /**
   * Pass the Store if you want to directly add the resource (and its possible
   * nested child Resources) to the Store.
   */
  store?: Store,
  /**
   * Pass a server URL if you want to use the `/path` endpoint to indirectly
   * fetch through that server.
   */
  from?: string,
)

 * Does not add it to the store. If you need that, use `Store.fetchResource`.
 */
export async function fetchResource(
  subject: string,
  /**
   * Pass the Store if you want to directly add the resource (and its possible
   * nested child Resources) to the Store.
   */
  store?: Store,
  /**
   * Pass a server URL if you want to use the `/path` endpoint to indirectly
   * fetch through that server.
   */
  from?: string,
): Promise<Resource> {
  let resource = new Resource(subject);
  try {
    tryValidURL(subject);
    const requestHeaders: HeadersObject = {};
    requestHeaders['Accept'] = 'application/ad+json';
    // Sign the request if there is an agent present
    store &&
      store.getAgent() &&
      (await signRequest(subject, store.getAgent(), requestHeaders));
    let url = subject;
    if (from !== undefined) {
      const newURL = new URL(`${from}/path`);
      newURL.searchParams.set('path', subject);
      url = newURL.href;
    }
    if (fetch == undefined) {
      throw new AtomicError(
        `No window object available this lib currently requires the DOM for fetching`,
      );
    }
    const response = await fetch(url, {
      headers: requestHeaders,
    });
    const body = await response.text();
    if (response.status == 200) {
      try {
        const json = JSON.parse(body);
        resource = parseJsonADResource(json, resource, store);
      } catch (e) {
        throw new AtomicError(
          `Could not parse JSON from fetching ${subject}. Is it an Atomic Data resource? Error message: ${e.message}`,
        );
      }
    } else if (response.status == 401) {
      throw new AtomicError(
        `You don't have the rights to do view ${subject}. Are you signed in with the right Agent? More detailed error from server: ${body}`,
        ErrorType.Unauthorized,
      );
    } else {
      const error = new AtomicError(`${response.status} error: ${body}`);
      resource.setError(error);
    }
  } catch (e) {
    resource.setError(e);
  }