@alorel-personal/build-tools/commands/build.js

"use strict";
const tslib_1 = require("tslib");
const fs = require("fs");
const lodash_1 = require("lodash");
const moment = require("moment");
const os_1 = require("os");
const path_1 = require("path");
const rimraf_1 = require("rimraf");
const typescript_lazy_get_decorator_1 = require("typescript-lazy-get-decorator");
const ext_1 = require("../const/ext");
const addConfig_1 = require("../fns/add-cmd/addConfig");
const cmdName_1 = require("../fns/cmdName");
const execLocal_1 = require("../fns/execLocal");
const getBin_1 = require("../fns/getBin");
const mkTsconfig_1 = require("../fns/mkTsconfig");
const readJson_1 = require("../fns/readJson");
const unlinkSafe_1 = require("../fns/unlinkSafe");
const xSpawn_1 = require("../fns/xSpawn");
const BuildTarget_1 = require("../interfaces/BuildTarget");
const cli_serialiser_1 = require("../lib/cli-serialiser");
const Log_1 = require("../lib/Log");
const tmp_1 = require("../lib/tmp");
const command = cmdName_1.cmdName(__filename);
const defaultUmdName = (() => {
    try {
        return readJson_1.readJson("./package.json" /* PKG_JSON_PATH */).name;
    }
    catch (_a) {
        return undefined;
    }
})();
const tscBin = getBin_1.getBin('typescript', 'tsc');
const rollupCmdFile = require.resolve(`../lib/build/cmd.${ext_1.ext}`);
const cmd = {
    builder(argv) {
        return addConfig_1.addConfig(argv, command)
            .option('entry', {
            alias: 'e',
            default: 'src/index.ts',
            describe: 'Entry file',
            type: 'string'
        })
            .option('externals', {
            alias: 'x',
            coerce: lodash_1.castArray,
            default: [],
            describe: 'External dependencies',
            type: 'array'
        })
            .option('ignore-umd-externals', {
            alias: 'iux',
            coerce(v) {
                let out = ['tslib'];
                if (v && v.length) {
                    out.push(...v);
                    out = lodash_1.uniq(out);
                }
                return out;
            },
            default: ['tslib'],
            describe: 'Override the externals option and always bundle the following packages in UMD',
            type: 'array'
        })
            .option('license-banner', {
            alias: 'lb',
            default: false,
            describe: 'Include the license as a banner in FESM & UMD bundles',
            type: 'boolean'
        })
            .option('out', {
            alias: 'o',
            default: 'dist',
            describe: 'Output directory',
            type: 'string'
        })
            .option('rollup', {
            alias: 'r',
            default: 'rollup.config.js',
            describe: 'Path ro rollup config file',
            type: 'string'
        })
            .option('targets', {
            alias: 't',
            choices: BuildTarget_1.allBuildTargets,
            coerce: lodash_1.castArray,
            default: BuildTarget_1.allBuildTargets,
            describe: 'Build targets',
            type: 'array'
        })
            .option('umd-name', {
            alias: 'u',
            default: defaultUmdName,
            describe: 'UMD global variable name',
            type: 'string'
        })
            .option('tsconfig', {
            alias: 'ts',
            coerce(path) {
                let out = {};
                let last;
                do {
                    last = readJson_1.readJson(path);
                    if (!last) {
                        throw new Error(`Path not found: ${path}`);
                    }
                    out = lodash_1.omit(lodash_1.merge(lodash_1.cloneDeep(last), out), ['extends']);
                    if (last.extends) {
                        path = last.extends;
                    }
                } while (last && last.extends);
                return out;
            },
            describe: 'Path to tsconfig file to inherit from',
            type: 'string'
        });
    },
    command,
    describe: 'Build the project',
    handler(c) {
        const start = Date.now();
        validate(c);
        Log_1.Log.info(`Clearing ${c.out}`);
        rimraf_1.sync(c.out);
        Log_1.Log.success(`${c.out} cleared.`);
        const tmpTsconfigs = [];
        try {
            buildCJsOrDeclaration(c, tmpTsconfigs);
            buildESM(c, tmpTsconfigs);
            buildRollup(c);
            Log_1.Log.info('Writing package.json');
            new PackageJsonBuilder(c).write();
            Log_1.Log.success('Wrote package.json');
            Log_1.Log.success(`Build finished in ${getDuration(start)}`);
        }
        catch (e) {
            Log_1.Log.err(`Build errored in ${getDuration(start)}`);
            throw e;
        }
        finally {
            tmpTsconfigs.forEach(unlinkSafe_1.unlinkSafe);
        }
    }
};
function validate(c) {
    if (c.targets.includes(BuildTarget_1.BuildTarget.UMD) && !c.umdName) {
        throw new Error('umd-name is required when one of the targets is UMD');
    }
    if (!c.targets.length) {
        throw new Error('No targets specified');
    }
    for (const t of c.targets) {
        if (!BuildTarget_1.isBuildTarget(t)) {
            throw new Error(`Unknown build target: ${JSON.stringify(t)}`);
        }
    }
}
function buildRollup(c) {
    const incUMD = c.targets.includes(BuildTarget_1.BuildTarget.UMD);
    const incFESM5 = c.targets.includes(BuildTarget_1.BuildTarget.FESM5);
    const incFESM2015 = c.targets.includes(BuildTarget_1.BuildTarget.FESM2015);
    const banner = (() => {
        if (c.lb) {
            let e = null;
            for (const p of ['LICENSE', 'LICENSE.txt']) {
                try {
                    const contents = fs.readFileSync(p, 'utf8');
                    return [
                        '/*!',
                        contents,
                        '*/',
                        '',
                        ''
                    ].join(os_1.EOL);
                }
                catch (err) {
                    e = err;
                }
            }
            if (e) {
                Log_1.Log.warn(`Unable to set license banner: ${e.stack || e.toString() || e.message}`);
            }
        }
        return null;
    })();
    if (!incUMD && !incFESM5 && !incFESM2015) {
        Log_1.Log.info("Skipping UMD" /* SKIP_UMD */);
        Log_1.Log.info("Skipping FESM5" /* SKIP_FESM5 */);
        Log_1.Log.info("Skipping FESM2015" /* SKIP_FESM2015 */);
        return;
    }
    const stdConf = lodash_1.merge({ output: { sourcemap: true } }, loadRollupConfig(c));
    stdConf.input = c.entry;
    stdConf.plugins = [];
    if (c.externals && c.externals.length) {
        if (Array.isArray(stdConf.external)) {
            stdConf.external.unshift(...c.externals);
            stdConf.external = lodash_1.uniq(c.externals);
        }
        else {
            stdConf.external = c.externals;
        }
    }
    if (banner && !lodash_1.has(stdConf, 'output.banner')) {
        lodash_1.set(stdConf, 'output.banner', banner);
    }
    lodash_1.set(stdConf, 'output.name', c.umdName);
    lodash_1.set(stdConf, 'output.amd.id', readJson_1.readJson("./package.json" /* PKG_JSON_PATH */).name);
    const execOpts = {
        cwd: process.cwd(),
        stdio: 'inherit'
    };
    const stdArgs = [
        '--opts',
        cli_serialiser_1.CLISerialiser.serialise(stdConf),
        '--tsconfig',
        cli_serialiser_1.CLISerialiser.serialise(c.tsconfig),
        '--ignored-externals',
        cli_serialiser_1.CLISerialiser.serialise(c.ignoreUmdExternals),
        '--dist',
        c.out
    ];
    if (incFESM2015) {
        throwIfErrored(execLocal_1.execLocal(rollupCmdFile, stdArgs.concat('--formats', BuildTarget_1.BuildTarget.FESM2015), execOpts));
    }
    else {
        Log_1.Log.info("Skipping FESM2015" /* SKIP_FESM2015 */);
    }
    if (incFESM5 || incUMD) {
        const formats = [];
        if (incFESM5) {
            formats.push(BuildTarget_1.BuildTarget.FESM5);
        }
        else {
            Log_1.Log.info("Skipping FESM5" /* SKIP_FESM5 */);
        }
        if (incUMD) {
            formats.push(BuildTarget_1.BuildTarget.UMD);
        }
        else {
            Log_1.Log.info("Skipping UMD" /* SKIP_UMD */);
        }
        throwIfErrored(execLocal_1.execLocal(rollupCmdFile, stdArgs.concat('--formats', ...formats), execOpts));
    }
    else {
        Log_1.Log.info("Skipping FESM5" /* SKIP_FESM5 */);
        Log_1.Log.info("Skipping UMD" /* SKIP_UMD */);
    }
}
class PackageJsonBuilder {
    constructor(cfg) {
        this.cfg = cfg;
        this.pkgJson = readJson_1.readJson("./package.json" /* PKG_JSON_PATH */) || {};
    }
    get _base() {
        const ext$ = path_1.extname(this.cfg.entry);
        return path_1.basename(this.cfg.entry, ext$);
    }
    get _baseJS() {
        return this._base + '.js';
    }
    get browser() {
        if (this.cfg.targets.includes(BuildTarget_1.BuildTarget.UMD)) {
            return '_bundle/umd.js';
        }
        return null;
    }
    get esm2015() {
        if (this.cfg.targets.includes(BuildTarget_1.BuildTarget.ESM2015)) {
            return `_bundle/esm2015/${this._baseJS}`;
        }
        return this.fesm5;
    }
    get esm5() {
        if (this.cfg.targets.includes(BuildTarget_1.BuildTarget.ESM5)) {
            return `_bundle/esm5/${this._baseJS}`;
        }
        return this.fesm5;
    }
    get fesm2015() {
        if (this.cfg.targets.includes(BuildTarget_1.BuildTarget.FESM2015)) {
            return '_bundle/fesm2015.js';
        }
        return null;
    }
    get fesm5() {
        if (this.cfg.targets.includes(BuildTarget_1.BuildTarget.FESM5)) {
            return '_bundle/fesm5.js';
        }
        return null;
    }
    get jsdelivr() {
        if (this.browser) {
            return `_bundle/umd.min.js`;
        }
        return null;
    }
    get main() {
        if (this.cfg.targets.includes(BuildTarget_1.BuildTarget.CJS)) {
            return this._baseJS;
        }
        else if (this.browser) {
            return this.browser;
        }
        else {
            throw new Error('Unable to resolve main file');
        }
    }
    get module() {
        return this.fesm5 || this.esm5;
    }
    get types() {
        if (this.cfg.targets.includes(BuildTarget_1.BuildTarget.DECLARATION)) {
            return `${this._base}.d.ts`;
        }
        return null;
    }
    write() {
        for (const p of ['main', 'browser', 'jsdelivr', 'fesm5', 'esm5', 'fesm2015', 'esm2015', 'types', 'module']) {
            if (this[p]) {
                this.pkgJson[p] = this[p];
            }
            else {
                delete this.pkgJson[p];
            }
        }
        if (this.types) {
            this.pkgJson.typings = this.types;
        }
        else {
            delete this.pkgJson.typings;
        }
        fs.writeFileSync("./package.json" /* PKG_JSON_PATH */, JSON.stringify(this.pkgJson, null, 2 /* INDENT */));
        this.write = lodash_1.noop;
    }
}
tslib_1.__decorate([
    typescript_lazy_get_decorator_1.LazyGetter(),
    tslib_1.__metadata("design:type", String),
    tslib_1.__metadata("design:paramtypes", [])
], PackageJsonBuilder.prototype, "_base", null);
tslib_1.__decorate([
    typescript_lazy_get_decorator_1.LazyGetter(),
    tslib_1.__metadata("design:type", String),
    tslib_1.__metadata("design:paramtypes", [])
], PackageJsonBuilder.prototype, "_baseJS", null);
tslib_1.__decorate([
    typescript_lazy_get_decorator_1.LazyGetter(),
    tslib_1.__metadata("design:type", Object),
    tslib_1.__metadata("design:paramtypes", [])
], PackageJsonBuilder.prototype, "browser", null);
tslib_1.__decorate([
    typescript_lazy_get_decorator_1.LazyGetter(),
    tslib_1.__metadata("design:type", Object),
    tslib_1.__metadata("design:paramtypes", [])
], PackageJsonBuilder.prototype, "esm2015", null);
tslib_1.__decorate([
    typescript_lazy_get_decorator_1.LazyGetter(),
    tslib_1.__metadata("design:type", Object),
    tslib_1.__metadata("design:paramtypes", [])
], PackageJsonBuilder.prototype, "esm5", null);
tslib_1.__decorate([
    typescript_lazy_get_decorator_1.LazyGetter(),
    tslib_1.__metadata("design:type", Object),
    tslib_1.__metadata("design:paramtypes", [])
], PackageJsonBuilder.prototype, "fesm2015", null);
tslib_1.__decorate([
    typescript_lazy_get_decorator_1.LazyGetter(),
    tslib_1.__metadata("design:type", Object),
    tslib_1.__metadata("design:paramtypes", [])
], PackageJsonBuilder.prototype, "fesm5", null);
tslib_1.__decorate([
    typescript_lazy_get_decorator_1.LazyGetter(),
    tslib_1.__metadata("design:type", Object),
    tslib_1.__metadata("design:paramtypes", [])
], PackageJsonBuilder.prototype, "jsdelivr", null);
tslib_1.__decorate([
    typescript_lazy_get_decorator_1.LazyGetter(),
    tslib_1.__metadata("design:type", Object),
    tslib_1.__metadata("design:paramtypes", [])
], PackageJsonBuilder.prototype, "main", null);
tslib_1.__decorate([
    typescript_lazy_get_decorator_1.LazyGetter(),
    tslib_1.__metadata("design:type", Object),
    tslib_1.__metadata("design:paramtypes", [])
], PackageJsonBuilder.prototype, "module", null);
tslib_1.__decorate([
    typescript_lazy_get_decorator_1.LazyGetter(),
    tslib_1.__metadata("design:type", Object),
    tslib_1.__metadata("design:paramtypes", [])
], PackageJsonBuilder.prototype, "types", null);
function loadRollupConfig(c) {
    try {
        if (c.rollup) {
            const fullPath = path_1.join(process.cwd(), c.rollup);
            const contents = fs.readFileSync(fullPath, 'utf8');
            const reg = /export\s+default/g;
            if (reg.test(contents)) {
                try {
                    const newContents = contents.replace(reg, 'module.exports = ');
                    fs.writeFileSync(fullPath, newContents);
                    return lodash_1.cloneDeep(require(fullPath));
                }
                finally {
                    fs.writeFileSync(fullPath, contents);
                }
            }
            else {
                return lodash_1.cloneDeep(require(fullPath));
            }
        }
    }
    catch (_a) {
        //noop
    }
    return {};
}
function buildESM(c, tmpTsConfigs) {
    if (c.targets.includes(BuildTarget_1.BuildTarget.ESM5)) {
        Log_1.Log.info('Building ESM5');
        spawnTsc(makeTmpTsconfig(c, tmpTsConfigs, {
            compilerOptions: {
                declaration: false,
                module: 'es2015',
                outDir: path_1.join(c.out, '_bundle', 'esm5'),
                target: 'es5'
            }
        }));
        Log_1.Log.success('Built ESM5');
    }
    else {
        Log_1.Log.info('Skipping ESM5');
    }
    if (c.targets.includes(BuildTarget_1.BuildTarget.ESM2015)) {
        Log_1.Log.info('Building ESM2015');
        spawnTsc(makeTmpTsconfig(c, tmpTsConfigs, {
            compilerOptions: {
                declaration: false,
                module: 'es2015',
                outDir: path_1.join(c.out, '_bundle', 'esm2015'),
                target: 'esnext'
            }
        }));
        Log_1.Log.success('Built ESM2015');
    }
    else {
        Log_1.Log.info('Skipping ESM2015');
    }
}
function buildCJsOrDeclaration(c, tmpTsconfigs) {
    const needsDeclaration = c.targets.includes(BuildTarget_1.BuildTarget.DECLARATION);
    if (c.targets.includes(BuildTarget_1.BuildTarget.CJS)) {
        if (!needsDeclaration) {
            Log_1.Log.info('Skipping declaration');
        }
        const building = needsDeclaration ? 'CommonJS + declaration' : 'CommonJS';
        Log_1.Log.info(`Building ${building}`);
        spawnTsc(makeTmpTsconfig(c, tmpTsconfigs, {
            compilerOptions: {
                declaration: needsDeclaration,
                module: 'commonjs',
                outDir: c.out
            }
        }));
        Log_1.Log.success(`Built ${building}`);
    }
    else if (needsDeclaration) {
        Log_1.Log.info('Skipping commonjs');
        Log_1.Log.info('Building declaration');
        spawnTsc(makeTmpTsconfig(c, tmpTsconfigs, {
            compilerOptions: {
                declaration: true,
                emitDeclarationOnly: true,
                module: 'commonjs',
                outDir: c.out,
                sourceMap: false
            }
        }));
        Log_1.Log.success('Built declaration');
    }
    else {
        Log_1.Log.info('Skipping commonjs');
        Log_1.Log.info('Skipping declaration');
    }
}
function makeTmpTsconfig(c, cleanupArray, overrides) {
    const path = tmp_1.tmp.fileSync({
        dir: process.cwd(),
        postfix: '.json',
        prefix: ".alobuild-tsconfig-" /* TSCONFIG_PREFIX */
    }).name;
    const tsconfig = mkTsconfig_1.mkTsconfig(lodash_1.merge(lodash_1.cloneDeep(c.tsconfig), overrides || {}));
    delete tsconfig.compilerOptions.outFile;
    fs.writeFileSync(path, JSON.stringify(tsconfig, null, 2 /* INDENT */));
    cleanupArray.push(path);
    return path;
}
function spawnTsc(tsconfigPath) {
    const proc = xSpawn_1.xSpawnSync(process.execPath, [tscBin, '-p', tsconfigPath], { stdio: 'inherit' });
    throwIfErrored(proc);
}
function throwIfErrored(res) {
    if (res.status !== 0) {
        throw new Error(`Process exited with code ${res.status}`);
    }
}
function getDuration(startPoint) {
    const d = moment.duration(Date.now() - startPoint);
    return [
        d.hours().toString(),
        lodash_1.padStart(d.minutes().toString(), 2 /* PAD */, "0" /* PAD_CHAR */),
        lodash_1.padStart(d.seconds().toString(), 2 /* PAD */, "0" /* PAD_CHAR */)
    ].join(':') + `.${lodash_1.padStart(d.milliseconds().toString(), 3 /* PAD_MS */, "0" /* PAD_CHAR */)}`;
}
// Cleanup on startup
fs.readdirSync(process.cwd(), 'utf8')
    .filter(p => p.startsWith(".alobuild-tsconfig-" /* TSCONFIG_PREFIX */) && p.endsWith('.json'))
    .forEach(unlinkSafe_1.unlinkSafe);
module.exports = cmd;