source: frontend/node_modules/webpack-sources/lib/Source.js

/*
        MIT License http://www.opensource.org/licenses/mit-license.php
        Author Tobias Koppers @sokra
*/

"use strict";

/**
 * @typedef {object} MapOptions
 * @property {boolean=} columns need columns?
 * @property {boolean=} module is module
 */

/**
 * @typedef {object} RawSourceMap
 * @property {number} version version
 * @property {string[]} sources sources
 * @property {string[]} names names
 * @property {string=} sourceRoot source root
 * @property {string[]=} sourcesContent sources content
 * @property {string} mappings mappings
 * @property {string} file file
 * @property {string=} debugId debug id
 * @property {number[]=} ignoreList ignore list
 */

/** @typedef {string | Buffer} SourceValue */

/**
 * @typedef {object} SourceAndMap
 * @property {SourceValue} source source
 * @property {RawSourceMap | null} map map
 */

/**
 * @typedef {object} HashLike
 * @property {(data: string | Buffer, inputEncoding?: string) => HashLike} update make hash update
 * @property {(encoding?: string) => string | Buffer} digest get hash digest
 */

class Source {
        /**
         * @returns {SourceValue} source
         */
        source() {
                throw new Error("Abstract");
        }

        /**
         * @returns {Buffer} buffer
         */
        buffer() {
                const source = this.source();
                if (Buffer.isBuffer(source)) return source;
                return Buffer.from(source, "utf8");
        }

        /**
         * @returns {Buffer[]} buffers
         */
        buffers() {
                return [this.buffer()];
        }

        /**
         * @returns {number} size
         */
        size() {
                return this.buffer().length;
        }

        /**
         * @param {MapOptions=} options map options
         * @returns {RawSourceMap | null} map
         */
        // eslint-disable-next-line no-unused-vars
        map(options) {
                return null;
        }

        /**
         * @param {MapOptions=} options map options
         * @returns {SourceAndMap} source and map
         */
        sourceAndMap(options) {
                return {
                        source: this.source(),
                        map: this.map(options),
                };
        }

        /**
         * @param {HashLike} hash hash
         * @returns {void}
         */
        // eslint-disable-next-line no-unused-vars
        updateHash(hash) {
                throw new Error("Abstract");
        }
}

module.exports = Source;