gulpfile.js

/* eslint-disable no-undef */
/*jshint esversion:6 */

/**
 * USE with
 * 
 * gulp init - Concatenates Abrantes with the plugins in this Gulpfile
 * gulp minify - Minifies Abrantes and the plugins
 * 
 * 
 */

// eslint-disable-next-line no-unused-vars
const { src, dest, series, watch } = require('gulp');
const concat = require('gulp-concat');
const terser = require('gulp-terser');
const rename = require('gulp-rename');
const sourcemaps = require('gulp-sourcemaps');

/**
 * List of files to be included in the build. The order is important as some plugins may depend on others.
 * You can comment out plugins that you don't want to include in the build.
 */
const myBuild = [
        'Abrantes.js', // Core Abrantes library
        'plugins/ga4-gtag.js', // Google Analytics 4 (gtag.js)
        // 'plugins/matomo.js',
        'plugins/hotjar.js', // Hotjar
        // 'plugins/clarity.js', // Microsoft Clarity
        'plugins/formtrack.js', // Form tracking 
        'plugins/add2DL.js', // Add to Data Layer (Google Tag Manager)
        'plugins/log.js', // Simple logging plugin
        'plugins/seed.js', // Seed plugin for consistent random values (login in multiple devices or cookies disabled)
        'plugins/hubspot.js', // HubSpot Enterprise tracking
];

/**
 * It will concatenate Abrantes with the plugins in the src of this function
 */
function init() {
    return src(myBuild)
        .pipe(concat("AbrantesPlus.js"))
        .pipe(dest('./'));
}

/**
 * Minifies the file wih Abrantes and the plugins
 */
function minify() {
    return src([
        'AbrantesPlus.js',
    ])
        .pipe(sourcemaps.init())
        .pipe(terser())
        .pipe(rename({ suffix: ".min" }))
        .pipe(sourcemaps.write('./'))
        .pipe(dest('./'));
}

/**
 * Creates the ES6 module version (AbrantesPlusMod.js)
 * Concatenates files and adds module export at the end
 */
function initMod() {
    const { Transform } = require('stream');

    // Custom transform to add ES6 export at the end
    const addModuleExport = new Transform({
        objectMode: true,
        transform(file, encoding, callback) {
            if (file.isBuffer()) {
                const moduleExport = `
// ES6 Module export - also expose globally for backward compatibility
if (typeof window !== 'undefined') {
    window.Abrantes = Abrantes;
}

export default Abrantes;
`;
                file.contents = Buffer.concat([file.contents, Buffer.from(moduleExport)]);
            }
            callback(null, file);
        }
    });

    return src(myBuild)
        .pipe(concat("AbrantesPlusMod.js"))
        .pipe(addModuleExport)
        .pipe(dest('./'));
}

/**
 * Minifies the ES6 module version
 */
function minifyMod() {
    return src([
        'AbrantesPlusMod.js',
    ])
        .pipe(sourcemaps.init())
        .pipe(terser({
            module: true
        }))
        .pipe(rename({ suffix: ".min" }))
        .pipe(sourcemaps.write('./'))
        .pipe(dest('./'));
}

// Build all outputs in strict order to avoid sourcemap/minify races.
const build = series(init, minify, initMod, minifyMod);

exports.init = init;
exports.initMod = initMod;
exports.minify = minify;
exports.minifyMod = minifyMod;
exports.build = build;
exports.default = build;