@mapcreator/api 3.3.0 → 5.0.0-alpha.12

package/src/traits/Injectable.js

@@ -1,221 +0,0 @@
-/*
- * BSD 3-Clause License
- *
- * Copyright (c) 2020, Mapcreator
- * All rights reserved.
- *
- * Redistribution and use in source and binary forms, with or without
- * modification, are permitted provided that the following conditions are met:
- *
- *  Redistributions of source code must retain the above copyright notice, this
- *   list of conditions and the following disclaimer.
- *
- *  Redistributions in binary form must reproduce the above copyright notice,
- *   this list of conditions and the following disclaimer in the documentation
- *   and/or other materials provided with the distribution.
- *
- *  Neither the name of the copyright holder nor the names of its
- *   contributors may be used to endorse or promote products derived from
- *   this software without specific prior written permission.
- *
- * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
- * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
- * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
- * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
- * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
- * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
- * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
- * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
- * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
- * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- */
-
-import ResourceBase from '../resources/base/ResourceBase';
-import { hasTrait, isParentOf } from '../utils/reflection';
-import Trait from './Trait';
-
-/**
- * Adds the possibility to inject proxies/methods
- *
- * @mixin
- */
-export default class Injectable extends Trait {
-  /**
-   * Inject proxies and methods during the constructor
-   */
-  initializer () {
-    const injectable = this.constructor._injectable || {};
-
-    for (const name of Object.keys(injectable)) {
-      const { value, isProxy } = injectable[name];
-
-      if (isProxy) {
-        this.injectProxy(name, value);
-      } else {
-        this.inject(name, value);
-      }
-    }
-  }
-
-  /**
-   * Inject a proxy property into future instances
-   *
-   * @param {string|object} name - Name of the property
-   * @param {function?} value - Either a resource or a function that returns a proxy
-   *
-   * @example
-   *
-   * Mapcreator.injectProxy({Domain});
-   *
-   * // After creating new api instance
-   *
-   * api.domains // returns proxy
-   */
-  static injectProxy (name, value) {
-    if (value) {
-      if (typeof this._injectable === 'undefined') {
-        this._injectable = {};
-      }
-
-      this._injectable[name] = { value, isProxy: true };
-    } else {
-      // Handle vue-style injections `.inject({ Foo, Bar, Baz })`
-      for (const key of Object.keys(name)) {
-        this.inject(key, name[key]);
-      }
-    }
-  }
-
-  /**
-   * Inject a property into future instances
-   *
-   * @param {string|object} name - Name of the property
-   * @param {function?} value - Any function that does not return a proxy
-   *
-   */
-  static inject (name, value) {
-    if (value) {
-      if (typeof this._injectable === 'undefined') {
-        this._injectable = {};
-      }
-
-      this._injectable[name] = { value, isProxy: false };
-    } else {
-      // Handle vue-style injections `.inject({ Foo, Bar, Baz })`
-      for (const key of Object.keys(name)) {
-        this.inject(key, name[key]);
-      }
-    }
-  }
-
-  /**
-   * Prevent a property from being injected
-   * @param {string} name - Name of the property
-   */
-  static uninject (name) {
-    if (typeof this._injectable !== 'undefined') {
-      delete this._injectable[name];
-    }
-  }
-
-  /**
-   * Inject a proxy
-   * @param {string} name - Name of the property
-   * @param {function?} value - Either a resource or a function that returns a proxy
-   */
-  injectProxy (name, value) {
-    if (!value) {
-      // Handle vue-style injections `.inject({ Foo, Bar, Baz })`
-      for (const key of Object.keys(name)) {
-        this.injectProxy(key, name[key]);
-      }
-    } else if (isParentOf(ResourceBase, value)) {
-      this._injectProxy(name, value);
-    } else {
-      this._inject(name, value);
-    }
-  }
-
-  /**
-   * Inject a property into the instance
-   *
-   * @param {string|object} name - Name of the property
-   * @param {function?} value - Any function that does not return a proxy
-   *
-   */
-  inject (name, value) {
-    this._inject(name, value, false);
-  }
-
-  /**
-   * Revert a proxy injection in instance, won't delete non-injected properties
-   *
-   * @param {string} name - property name
-   * @throws Error when the property was not injected
-   */
-  uninject (name) {
-    const descriptor = Object.getOwnPropertyDescriptor(this, name);
-    const value = descriptor.value || descriptor.get || {};
-
-    if (!value.injected) {
-      throw new Error(`Property "${name}" was not injected, can't un-inject`);
-    }
-
-    if (value.original) {
-      Object.defineProperty(this, name, value.original);
-    } else {
-      Object.defineProperty(this, name, {
-        // eslint-disable-next-line no-undefined
-        value: undefined,
-        enumerable: false,
-        writable: true,
-      });
-    }
-  }
-
-  _injectProxy (name, value) {
-    if (name === value.name) {
-      name = `${name.replace(/^\w/, c => c.toLowerCase())}s`;
-    }
-
-    const OwnableResource = require('./OwnableResource').default;
-
-    if (hasTrait(value, OwnableResource)) {
-      const OwnedResourceProxy = require('../proxy/OwnedResourceProxy').default;
-
-      this._inject(name, function () {
-        return new OwnedResourceProxy(this.api, this, value);
-      });
-    } else if (isParentOf(ResourceBase, value) && this._proxyResourceList) {
-      // returns a SimpleResourceProxy
-      this._inject(name, function () {
-        return this._proxyResourceList(value);
-      });
-    } else {
-      const ResourceProxy = require('../proxy/ResourceProxy').default;
-
-      this._inject(name, function () {
-        return new ResourceProxy(this, value);
-      });
-    }
-  }
-
-  _inject (name, value, getter = true) {
-    const func = (...args) => value.apply(this, args);
-    const original = Object.getOwnPropertyDescriptor(this, name);
-
-    func.injected = true;
-
-    // Store the original property descriptor if available
-    if (original) {
-      func.original = original;
-    }
-
-    Object.defineProperty(this, name, {
-      enumerable: false,
-      configurable: true,
-
-      [getter ? 'get' : 'value']: func,
-    });
-  }
-}

package/src/traits/OwnableResource.js

@@ -1,56 +0,0 @@
-/*
- * BSD 3-Clause License
- *
- * Copyright (c) 2020, Mapcreator
- * All rights reserved.
- *
- * Redistribution and use in source and binary forms, with or without
- * modification, are permitted provided that the following conditions are met:
- *
- *  Redistributions of source code must retain the above copyright notice, this
- *   list of conditions and the following disclaimer.
- *
- *  Redistributions in binary form must reproduce the above copyright notice,
- *   this list of conditions and the following disclaimer in the documentation
- *   and/or other materials provided with the distribution.
- *
- *  Neither the name of the copyright holder nor the names of its
- *   contributors may be used to endorse or promote products derived from
- *   this software without specific prior written permission.
- *
- * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
- * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
- * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
- * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
- * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
- * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
- * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
- * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
- * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
- * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- */
-
-import OrganisationProxy from '../proxy/OrganisationProxy';
-import Trait from './Trait';
-
-/**
- * Provides a {@link ResourceBase} with functions for dealing with being ownable by an organisation
- * @mixin
- */
-export default class OwnableResource extends Trait {
-  /**
-   * Get the list of associated organisations
-   * @returns {SimpleResourceProxy} - A proxy for accessing the resource
-   */
-  get organisations () {
-    return new OrganisationProxy(this.api, this);
-  }
-
-  /**
-   * If the resource can be owned by an organisation
-   * @returns {boolean} - Can be owned by an organisation
-   */
-  get ownable () {
-    return true;
-  }
-}

package/src/traits/Trait.js

@@ -1,43 +0,0 @@
-/*
- * BSD 3-Clause License
- *
- * Copyright (c) 2020, Mapcreator
- * All rights reserved.
- *
- * Redistribution and use in source and binary forms, with or without
- * modification, are permitted provided that the following conditions are met:
- *
- *  Redistributions of source code must retain the above copyright notice, this
- *   list of conditions and the following disclaimer.
- *
- *  Redistributions in binary form must reproduce the above copyright notice,
- *   this list of conditions and the following disclaimer in the documentation
- *   and/or other materials provided with the distribution.
- *
- *  Neither the name of the copyright holder nor the names of its
- *   contributors may be used to endorse or promote products derived from
- *   this software without specific prior written permission.
- *
- * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
- * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
- * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
- * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
- * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
- * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
- * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
- * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
- * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
- * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- */
-
-/**
- * Trait interface
- * @interface
- * @mixin
- */
-export default class Trait {
-  /**
-   * Optional initialization method
-   */
-  initializer () { }
-}

package/src/utils/Logger.js

@@ -1,137 +0,0 @@
-/*
- * BSD 3-Clause License
- *
- * Copyright (c) 2020, Mapcreator
- * All rights reserved.
- *
- * Redistribution and use in source and binary forms, with or without
- * modification, are permitted provided that the following conditions are met:
- *
- *  Redistributions of source code must retain the above copyright notice, this
- *   list of conditions and the following disclaimer.
- *
- *  Redistributions in binary form must reproduce the above copyright notice,
- *   this list of conditions and the following disclaimer in the documentation
- *   and/or other materials provided with the distribution.
- *
- *  Neither the name of the copyright holder nor the names of its
- *   contributors may be used to endorse or promote products derived from
- *   this software without specific prior written permission.
- *
- * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
- * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
- * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
- * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
- * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
- * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
- * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
- * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
- * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
- * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- */
-
-/**
- * Simple logger implementation
- */
-export default class Logger {
-  /**
-   * Create a Logger instance
-   * @param {string} [logLevel=warn] - Log level
-   */
-  constructor (logLevel = 'warn') {
-    this.logLevel = logLevel;
-  }
-
-  /**
-   * Get available log levels
-   * @returns {Array<string>} - Log levels
-   */
-  getLogLevels () {
-    return [
-      'debug',
-      'info',
-      'warn',
-      'error',
-      'none',
-    ];
-  }
-
-  /**
-   * Log a message
-   * @param {string} message - Message to be logged
-   * @param {string} level - Log level
-   */
-  log (message, level = 'info') {
-    if (level === 'none') {
-      return;
-    }
-
-    if (this._shouldLog(level)) {
-      // eslint-disable-next-line no-console
-      console[level](message);
-    }
-  }
-
-  /**
-   * Log a debug message
-   * @param {string} message - Message to be logged
-   */
-  debug (message) {
-    this.log(message, 'debug');
-  }
-
-  /**
-   * Log an informative message
-   * @param {string} message - Message to be logged
-   */
-  info (message) {
-    this.log(message, 'info');
-  }
-
-  /**
-   * Log a warning message
-   * @param {string} message - Message to be logged
-   */
-  warn (message) {
-    this.log(message, 'warn');
-  }
-
-  /**
-   * Log an error message
-   * @param {string} message - Message to be logged
-   */
-  error (message) {
-    this.log(message, 'error');
-  }
-
-  /**
-   * Get the current log level
-   * @returns {string} - log level
-   */
-  get logLevel () {
-    return this._logLevel;
-  }
-
-  /**
-   * Set the current log level
-   * @param {string} value - log level
-   * @throws {Logger#getLogLevels}
-   */
-  set logLevel (value) {
-    value = value.toLowerCase();
-
-    if (!this.getLogLevels().includes(value)) {
-      throw new TypeError(`Expected one of ${this.getLogLevels().join(', ')}. Got ${value}`);
-    }
-
-    this._logLevel = value;
-  }
-
-  _shouldLog (level) {
-    const logLevels = this.getLogLevels();
-    const targetLevel = logLevels.findIndex(x => x === level);
-    const currentLevel = logLevels.findIndex(x => x === this.logLevel);
-
-    return targetLevel >= currentLevel;
-  }
-}

package/src/utils/Singleton.js

@@ -1,49 +0,0 @@
-/*
- * BSD 3-Clause License
- *
- * Copyright (c) 2020, Mapcreator
- * All rights reserved.
- *
- * Redistribution and use in source and binary forms, with or without
- * modification, are permitted provided that the following conditions are met:
- *
- *  Redistributions of source code must retain the above copyright notice, this
- *   list of conditions and the following disclaimer.
- *
- *  Redistributions in binary form must reproduce the above copyright notice,
- *   this list of conditions and the following disclaimer in the documentation
- *   and/or other materials provided with the distribution.
- *
- *  Neither the name of the copyright holder nor the names of its
- *   contributors may be used to endorse or promote products derived from
- *   this software without specific prior written permission.
- *
- * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
- * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
- * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
- * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
- * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
- * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
- * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
- * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
- * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
- * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- */
-
-/**
- * Singletons will always return the same instance
- *
- * @private
- */
-export default class Singleton {
-  constructor () {
-    if (!this.constructor.instance) {
-      this.constructor.instance = this;
-      this._instanceCount = 0;
-    }
-
-    this._instanceCount++;
-
-    return this.constructor.instance;
-  }
-}

package/src/utils/StaticClass.js

@@ -1,43 +0,0 @@
-/*
- * BSD 3-Clause License
- *
- * Copyright (c) 2020, Mapcreator
- * All rights reserved.
- *
- * Redistribution and use in source and binary forms, with or without
- * modification, are permitted provided that the following conditions are met:
- *
- *  Redistributions of source code must retain the above copyright notice, this
- *   list of conditions and the following disclaimer.
- *
- *  Redistributions in binary form must reproduce the above copyright notice,
- *   this list of conditions and the following disclaimer in the documentation
- *   and/or other materials provided with the distribution.
- *
- *  Neither the name of the copyright holder nor the names of its
- *   contributors may be used to endorse or promote products derived from
- *   this software without specific prior written permission.
- *
- * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
- * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
- * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
- * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
- * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
- * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
- * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
- * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
- * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
- * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- */
-
-import StaticClassError from '../errors/StaticClassError';
-
-/**
- * Disables the constructor and throws a {@link StaticClassError} when an instance is created.
- * @protected
- */
-export default class StaticClass {
-  constructor () {
-    throw new StaticClassError();
-  }
-}

package/src/utils/Unobservable.js

@@ -1,47 +0,0 @@
-/*
- * BSD 3-Clause License
- *
- * Copyright (c) 2020, Mapcreator
- * All rights reserved.
- *
- * Redistribution and use in source and binary forms, with or without
- * modification, are permitted provided that the following conditions are met:
- *
- *  Redistributions of source code must retain the above copyright notice, this
- *   list of conditions and the following disclaimer.
- *
- *  Redistributions in binary form must reproduce the above copyright notice,
- *   this list of conditions and the following disclaimer in the documentation
- *   and/or other materials provided with the distribution.
- *
- *  Neither the name of the copyright holder nor the names of its
- *   contributors may be used to endorse or promote products derived from
- *   this software without specific prior written permission.
- *
- * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
- * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
- * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
- * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
- * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
- * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
- * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
- * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
- * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
- * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- */
-
-/**
- * Makes an object and it's children unobservable by frameworks like Vuejs
- * @protected
- */
-export default class Unobservable {
-  /**
-   * Overrides the `Object.prototype.toString.call(obj)` result
-   * @returns {string} - type name
-   * @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Symbol/toStringTag
-   */
-  get [Symbol.toStringTag] () {
-    // Anything can go here really as long as it's not 'Object'
-    return this.constructor.name;
-  }
-}

package/src/utils/base64.js

@@ -1,93 +0,0 @@
-/*
- * BSD 3-Clause License
- *
- * Copyright (c) 2020, Mapcreator
- * All rights reserved.
- *
- * Redistribution and use in source and binary forms, with or without
- * modification, are permitted provided that the following conditions are met:
- *
- *  Redistributions of source code must retain the above copyright notice, this
- *   list of conditions and the following disclaimer.
- *
- *  Redistributions in binary form must reproduce the above copyright notice,
- *   this list of conditions and the following disclaimer in the documentation
- *   and/or other materials provided with the distribution.
- *
- *  Neither the name of the copyright holder nor the names of its
- *   contributors may be used to endorse or promote products derived from
- *   this software without specific prior written permission.
- *
- * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
- * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
- * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
- * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
- * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
- * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
- * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
- * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
- * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
- * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- */
-
-/**
- * Base64 encode data
- *
- * @param {Buffer|ArrayBuffer} buffer - input buffer
- * @author Jon Leighton
- * @license MIT
- * @see https://gist.github.com/jonleighton/958841
- * @returns {string} - base 64 encoded data
- * @private
- */
-export function base64Encode (buffer) {
-  let base64 = '';
-  const encodings = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/';
-
-  const bytes = new Uint8Array(buffer);
-  const byteLength = bytes.byteLength;
-  const byteRemainder = byteLength % 3;
-  const mainLength = byteLength - byteRemainder;
-
-  let a, b, c, d;
-  let chunk;
-
-  // Main loop deals with bytes in chunks of 3
-  for (let i = 0; i < mainLength; i += 3) {
-    // Combine the three bytes into a single integer
-    chunk = bytes[i] * 65536 | bytes[i + 1] * 256 | bytes[i + 2];
-
-    // Use bitmasks to extract 6-bit segments from the triplet
-    a = (chunk & 16515072) >> 18; // 16515072 = (2^6 - 1) << 18
-    b = (chunk & 258048) >> 12; // 258048   = (2^6 - 1) << 12
-    c = (chunk & 4032) >> 6; // 4032     = (2^6 - 1) << 6
-    d = chunk & 63; // 63       = 2^6 - 1
-
-    // Convert the raw binary segments to the appropriate ASCII encoding
-    base64 += encodings[a] + encodings[b] + encodings[c] + encodings[d];
-  }
-
-  // Deal with the remaining bytes and padding
-  if (byteRemainder === 1) {
-    chunk = bytes[mainLength];
-
-    a = (chunk & 252) >> 2; // 252 = (2^6 - 1) << 2
-
-    // Set the 4 least significant bits to zero
-    b = (chunk & 3) << 4; // 3   = 2^2 - 1
-
-    base64 += `${encodings[a] + encodings[b]}==`;
-  } else if (byteRemainder === 2) {
-    chunk = bytes[mainLength] * 256 | bytes[mainLength + 1];
-
-    a = (chunk & 64512) >> 10; // 64512 = (2^6 - 1) << 10
-    b = (chunk & 1008) >> 4; // 1008  = (2^6 - 1) << 4
-
-    // Set the 2 least significant bits to zero
-    c = (chunk & 15) << 2; // 15    = 2^4 - 1
-
-    base64 += `${encodings[a] + encodings[b] + encodings[c]}=`;
-  }
-
-  return base64;
-}