/*
|
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");
|
}
|
|
buffer() {
|
const source = this.source();
|
if (Buffer.isBuffer(source)) return source;
|
return Buffer.from(source, "utf8");
|
}
|
|
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;
|