acquia-dam-sdk/dist/client/index.mjs

Interact with the Acquia DAM API

/*
 * Acquia DAM
 * This is the interface for interacting with the Acquia DAM API.
 * Both [V1](https://docs.acquia.com/acquia-dam/api-v1) and [V2](https://docs.acquia.com/acquia-dam/api-v2) APIs are supported.
 *
 * Do not edit this class manually.
 */
/**
 * Manages client-server communication. This class should not be modified directly.
 * @class
 */
class ApiClient {
  _accessToken = '';
  __sdkIdentifier = 'dam-ts@1.0.2';
  baseUrlMap = new Map([['1', 'https://.widencollective.com/api/rest/'], ['2', 'https://api.widencollective.com/v2/']]);
  constructor(accessToken) {
    if (accessToken) {
      this.accessToken = accessToken;
    }
  }
  /**
   * Sets the collective key in the v1 API Base URL
   * @param key The collective key
   */
  set _collectiveKey(key) {
    this.baseUrlMap.set('1', `https://${key}.widencollective.com/api/rest/`);
  }
  /**
   * Sets the current access token.
   * @param token The Personal Access Token obtained from the DAM Admin UI or the Access Token obtained from the OAuth Authorization Code Flow.
   */
  set accessToken(token) {
    if (token === '') {
      this._collectiveKey = '';
    } else if (/^wat_[a-z]*_/.test(token)) {
      this._collectiveKey = token.split('_')[1] || '';
    } else if (/^[a-z]*\//.test(token)) {
      this._collectiveKey = token.split('/')[0] || '';
    } else {
      throw new AcquiaDAMError('SDK Error', undefined, 'Malformed Access Token');
    }
    this._accessToken = token;
  }
  /**
   * Sends a request to the DAM API
   * @param requestParams Information about the request to send
   * @returns The data in the response body
   */
  async sendRequest(requestParams) {
    const opts = {
      method: requestParams.method,
      headers: this.buildHeaders(requestParams)
    };
    const url = this.buildUrl(requestParams);
    if (requestParams.body) {
      opts.body = this.buildBody(requestParams);
    }
    const response = await fetch(url, opts);
    if (!response.ok) {
      const content = await this.parseBody(response);
      throw new AcquiaDAMError('HTTP Error', response.status, content);
    }
    return this.parseBody(response);
  }
  /**
   * Builds the full URL to send to the server
   * @param requestParams Information about the request
   * @returns The full URL to send
   */
  buildUrl(requestParams) {
    const base = this.baseUrlMap.get(requestParams.apiVersion);
    const queryString = requestParams.queryStringParams ? `?${new URLSearchParams(this.buildParams(requestParams.queryStringParams))}` : '';
    return `${base}${requestParams.path}${queryString}`;
  }
  /**
   * Builds the request headers
   * @param requestParams Information about the request
   * @returns The necessary headers including authentication
   */
  buildHeaders(requestParams) {
    if (!this._accessToken) {
      throw new AcquiaDAMError('SDK Error', undefined, 'Access token is not set');
    }
    const headers = new Headers();
    headers.set('Authorization', `Bearer ${this._accessToken}`);
    headers.set('x-acquia-sdk-client', this.__sdkIdentifier);
    if (requestParams.body && !(requestParams.body instanceof FormData)) {
      headers.set('Content-Type', 'application/json');
    }
    return headers;
  }
  /**
   * Builds the request body
   * @param requestParams Information about the request
   * @returns The request body to send to the server
   */
  buildBody(requestParams) {
    return requestParams.body instanceof FormData ? requestParams.body : JSON.stringify(requestParams.body);
  }
  /**
   * Builds the request query string
   * @param params The request parameters
   * @returns The query string
   */
  buildParams(params) {
    const result = {};
    Object.entries(params).forEach(([k, v]) => {
      result[k] = Array.isArray(v) ? v.join(',') : String(v);
    });
    return result;
  }
  /**
   * Parse the HTTP Response body
   * @param response The fetch API HTTP Response
   * @returns The body content
   */
  async parseBody(response) {
    if (!response.body) {
      return undefined;
    }
    if (response.headers.get('content-type')?.includes('application/json')) {
      const bodyContent = await response.json();
      return this.parseBodyValues(bodyContent);
    }
    return response.text();
  }
  /**
   * Transforms all timestamps into date objects
   * @param value The value to transform
   */
  parseBodyValues(value) {
    let newValue;
    if (Array.isArray(value)) {
      newValue = value.map(v => this.parseBodyValues(v));
    } else if (value && typeof value === 'object') {
      newValue = {};
      for (const [k, v] of Object.entries(value)) {
        newValue[k] = this.parseBodyValues(v);
      }
    } else if (typeof value === 'string' && /\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}Z/.test(value)) {
      newValue = new Date(value);
    } else {
      newValue = value;
    }
    return newValue;
  }
}
class AcquiaDAMError extends Error {
  constructor(type, statusCode, body) {
    const message = Object.entries({
      type,
      statusCode,
      body
    }).map(([k, v]) => {
      if (v === undefined) {
        return `${k}: N/A`;
      }
      return `${k}: ${JSON.stringify(v)}`;
    }).join('\n');
    super(message);
    this.type = type;
    this.statusCode = statusCode;
    this.body = body;
  }
}

export { AcquiaDAMError, ApiClient };