mirror of
https://github.com/HeyPuter/puter
synced 2024-11-14 22:06:00 +00:00
354 lines
15 KiB
JavaScript
354 lines
15 KiB
JavaScript
/*
|
|
Copyright (C) 2024 Puter Technologies Inc.
|
|
|
|
This file is part of Puter.com.
|
|
|
|
Puter.com is free software: you can redistribute it and/or modify
|
|
it under the terms of the GNU Affero General Public License as published
|
|
by the Free Software Foundation, either version 3 of the License, or
|
|
(at your option) any later version.
|
|
|
|
This program is distributed in the hope that it will be useful,
|
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
GNU Affero General Public License for more details.
|
|
|
|
You should have received a copy of the GNU Affero General Public License
|
|
along with this program. If not, see <https://www.gnu.org/licenses/>.
|
|
*/
|
|
import { encode } from 'html-entities';
|
|
import fs from 'fs';
|
|
import path from 'path';
|
|
import webpack from 'webpack';
|
|
import CleanCSS from 'clean-css';
|
|
import uglifyjs from 'uglify-js';
|
|
import { lib_paths, css_paths, js_paths } from './src/static-assets.js';
|
|
import { fileURLToPath } from 'url';
|
|
|
|
// Polyfill __dirname, which doesn't exist in modules mode
|
|
const __dirname = path.dirname(fileURLToPath(import.meta.url));
|
|
|
|
/**
|
|
* Builds the application by performing various tasks such as cleaning the distribution directory,
|
|
* merging and minifying JavaScript and CSS files, bundling GUI core files, handling images,
|
|
* and preparing the final distribution package. The process involves concatenating library
|
|
* scripts, optimizing them for production, and copying essential assets to the distribution
|
|
* directory. The function also supports a verbose mode for logging detailed information during
|
|
* the build process.
|
|
*
|
|
* @param {Object} [options] - Optional parameters to customize the build process.
|
|
* @param {boolean} [options.verbose=false] - Specifies whether to log detailed information during the build.
|
|
*
|
|
* @async
|
|
* @returns {Promise<void>} A promise that resolves when the build process is complete.
|
|
*
|
|
* @example
|
|
* build({ verbose: true }).then(() => {
|
|
* console.log('Build process completed successfully.');
|
|
* }).catch(error => {
|
|
* console.error('Build process failed:', error);
|
|
* });
|
|
*/
|
|
async function build(options){
|
|
// -----------------------------------------------
|
|
// Delete ./dist/ directory if it exists and create a new one
|
|
// -----------------------------------------------
|
|
if(fs.existsSync(path.join(__dirname, 'dist'))){
|
|
fs.rmSync(path.join(__dirname, 'dist'), {recursive: true});
|
|
}
|
|
fs.mkdirSync(path.join(__dirname, 'dist'));
|
|
|
|
// -----------------------------------------------
|
|
// Concat/merge the JS libraries and save them to ./dist/libs.js
|
|
// -----------------------------------------------
|
|
let js = '';
|
|
for(let i = 0; i < lib_paths.length; i++){
|
|
const file = path.join(__dirname, 'src', lib_paths[i]);
|
|
// js
|
|
if(file.endsWith('.js') && !file.endsWith('.min.js')){
|
|
let minified_code = await uglifyjs.minify(fs.readFileSync(file).toString(), {mangle: false});
|
|
if(minified_code && minified_code.code){
|
|
js += minified_code.code;
|
|
if(options?.verbose)
|
|
console.log('minified: ', file);
|
|
}
|
|
}else{
|
|
js += fs.readFileSync(file);
|
|
if(options?.verbose)
|
|
console.log('skipped minification: ', file);
|
|
}
|
|
|
|
js += '\n\n\n';
|
|
}
|
|
|
|
// -----------------------------------------------
|
|
// Combine all images into a single js file
|
|
// -----------------------------------------------
|
|
let icons = 'window.icons = [];\n\n\n';
|
|
fs.readdirSync(path.join(__dirname, 'src/icons')).forEach(file => {
|
|
// skip dotfiles
|
|
if(file.startsWith('.'))
|
|
return;
|
|
// load image
|
|
let buff = new Buffer.from(fs.readFileSync(path.join(__dirname, 'src/icons') + '/' + file));
|
|
// convert to base64
|
|
let base64data = buff.toString('base64');
|
|
// add to `window.icons`
|
|
if(file.endsWith('.png'))
|
|
icons += `window.icons['${file}'] = "data:image/png;base64,${base64data}";\n`;
|
|
else if(file.endsWith('.svg'))
|
|
icons += `window.icons['${file}'] = "data:image/svg+xml;base64,${base64data}";\n`;
|
|
});
|
|
|
|
// -----------------------------------------------
|
|
// concat/merge the CSS files and save them to ./dist/bundle.min.css
|
|
// -----------------------------------------------
|
|
let css = '';
|
|
for(let i = 0; i < css_paths.length; i++){
|
|
let fullpath = path.join(__dirname, 'src', css_paths[i]);
|
|
// minify CSS files if not already minified, then concatenate
|
|
if(css_paths[i].endsWith('.css') && !css_paths[i].endsWith('.min.css')){
|
|
const minified_css = new CleanCSS({}).minify(fs.readFileSync(fullpath).toString());
|
|
css += minified_css.styles;
|
|
}
|
|
// otherwise, just concatenate the file
|
|
else
|
|
css += fs.readFileSync(path.join(__dirname, 'src', css_paths[i]));
|
|
|
|
// add newlines between files
|
|
css += '\n\n\n';
|
|
}
|
|
fs.writeFileSync(path.join(__dirname, 'dist', 'bundle.min.css'), css);
|
|
|
|
// -----------------------------------------------
|
|
// Bundle GUI core and merge all files into a single JS file
|
|
// -----------------------------------------------
|
|
let main_array = [];
|
|
for(let i = 0; i < js_paths.length; i++){
|
|
main_array.push(path.join(__dirname, 'src', js_paths[i]));
|
|
}
|
|
webpack({
|
|
mode: 'production',
|
|
entry: {
|
|
main: main_array,
|
|
},
|
|
output: {
|
|
path: path.resolve(__dirname, 'dist'),
|
|
filename: '[name].js',
|
|
},
|
|
optimization: {
|
|
minimize: true,
|
|
},
|
|
}, (err, stats) => {
|
|
if(err){
|
|
console.error(err);
|
|
return;
|
|
}
|
|
if(options?.verbose)
|
|
console.log(stats.toString());
|
|
// write to ./dist/bundle.min.js
|
|
fs.writeFileSync(path.join(__dirname, 'dist', 'bundle.min.js'), icons + '\n\n\n' + js + '\n\n\n' + fs.readFileSync(path.join(__dirname, 'dist', 'main.js')));
|
|
// remove ./dist/main.js
|
|
fs.unlinkSync(path.join(__dirname, 'dist', 'main.js'));
|
|
});
|
|
|
|
// Copy index.js to dist/gui.js
|
|
// Prepend `window.gui_env="prod";` to `./dist/gui.js`
|
|
fs.writeFileSync(
|
|
path.join(__dirname, 'dist', 'gui.js'),
|
|
`window.gui_env="prod"; \n\n` + fs.readFileSync(path.join(__dirname, 'src', 'index.js'))
|
|
);
|
|
|
|
const copy_these = [
|
|
'images',
|
|
'favicons',
|
|
'browserconfig.xml',
|
|
'manifest.json',
|
|
'favicon.ico',
|
|
'security.txt',
|
|
];
|
|
|
|
const recursive_copy = (src, dest) => {
|
|
const stat = fs.statSync(src);
|
|
if ( stat.isDirectory() ) {
|
|
if( ! fs.existsSync(dest) ) fs.mkdirSync(dest);
|
|
const files = fs.readdirSync(src);
|
|
for ( const file of files ) {
|
|
recursive_copy(path.join(src, file), path.join(dest, file));
|
|
}
|
|
} else {
|
|
fs.copyFileSync(src, dest);
|
|
}
|
|
};
|
|
|
|
for ( const to_copy of copy_these ) {
|
|
recursive_copy(path.join(__dirname, 'src', to_copy), path.join(__dirname, 'dist', to_copy));
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Generates the HTML content for the GUI based on the specified configuration options. The function
|
|
* creates a new HTML document with the specified title, description, and other metadata. The function
|
|
* also includes the necessary CSS and JavaScript files, as well as the required meta tags for social
|
|
* media sharing and search engine optimization. The function is designed to be used in development
|
|
* environments to generate the HTML content for the GUI.
|
|
*
|
|
* @param {Object} options - The configuration options for the GUI.
|
|
* @param {string} options.env - The environment in which the GUI is running (e.g., "dev" or "prod").
|
|
* @param {string} options.api_origin - The origin of the API server.
|
|
* @param {string} options.title - The title of the GUI.
|
|
* @param {string} options.company - The name of the company or organization.
|
|
* @param {string} options.description - The description of the GUI.
|
|
* @param {string} options.app_description - The description of the application.
|
|
* @param {string} options.short_description - The short description of the GUI.
|
|
* @param {string} options.origin - The origin of the GUI.
|
|
* @param {string} options.social_card - The URL of the social media card image.
|
|
* @returns {string} The HTML content for the GUI based on the specified configuration options.
|
|
*
|
|
*/
|
|
function generateDevHtml(options){
|
|
let start_t = Date.now();
|
|
|
|
// final html string
|
|
let h = '';
|
|
|
|
h += `<!DOCTYPE html>`;
|
|
h += `<html lang="en">`;
|
|
|
|
h += `<head>`;
|
|
h += `<title>${encode((options.title))}</title>`
|
|
h += `<meta name="author" content="${encode(options.company)}">`
|
|
// description
|
|
let description = options.description;
|
|
// if app_description is set, use that instead
|
|
if(options.app_description){
|
|
description = options.app_description;
|
|
}
|
|
// if no app_description is set, use short_description if set
|
|
else if(options.short_description){
|
|
description = options.short_description;
|
|
}
|
|
|
|
// description
|
|
h += `<meta name="description" content="${encode((description).replace(/\n/g, " "))}">`
|
|
// facebook domain verification
|
|
h += `<meta name="facebook-domain-verification" content="e29w3hjbnnnypf4kzk2cewcdaxym1y" />`;
|
|
// canonical url
|
|
h += `<link rel="canonical" href="${options.origin}">`;
|
|
|
|
// DEV: load every CSS file individually
|
|
if(options.env === 'dev'){
|
|
for(let i = 0; i < css_paths.length; i++){
|
|
h += `<link rel="stylesheet" href="${css_paths[i]}">`;
|
|
}
|
|
}
|
|
|
|
// Facebook meta tags
|
|
h += `<meta property="og:url" content="https://${options.domain}">`;
|
|
h += `<meta property="og:type" content="website">`;
|
|
h += `<meta property="og:title" content="${encode(options.title)}">`;
|
|
h += `<meta property="og:description" content="${encode((options.short_description).replace(/\n/g, " "))}">`;
|
|
h += `<meta property="og:image" content="${options.social_card}">`;
|
|
|
|
// Twitter meta tags
|
|
h += `<meta name="twitter:card" content="summary_large_image">`;
|
|
h += `<meta property="twitter:domain" content="${options.domain}">`;
|
|
h += `<meta property="twitter:url" content="https://${options.domain}">`;
|
|
h += `<meta name="twitter:title" content="${encode(options.title)}">`;
|
|
h += `<meta name="twitter:description" content="${encode((options.short_description).replace(/\n/g, " "))}">`;
|
|
h += `<meta name="twitter:image" content="${options.social_card}">`;
|
|
|
|
// favicons
|
|
h += `
|
|
<link rel="apple-touch-icon" sizes="57x57" href="/favicons/apple-icon-57x57.png">
|
|
<link rel="apple-touch-icon" sizes="60x60" href="/favicons/apple-icon-60x60.png">
|
|
<link rel="apple-touch-icon" sizes="72x72" href="/favicons/apple-icon-72x72.png">
|
|
<link rel="apple-touch-icon" sizes="76x76" href="/favicons/apple-icon-76x76.png">
|
|
<link rel="apple-touch-icon" sizes="114x114" href="/favicons/apple-icon-114x114.png">
|
|
<link rel="apple-touch-icon" sizes="120x120" href="/favicons/apple-icon-120x120.png">
|
|
<link rel="apple-touch-icon" sizes="144x144" href="/favicons/apple-icon-144x144.png">
|
|
<link rel="apple-touch-icon" sizes="152x152" href="/favicons/apple-icon-152x152.png">
|
|
<link rel="apple-touch-icon" sizes="180x180" href="/favicons/apple-icon-180x180.png">
|
|
<link rel="icon" type="image/png" sizes="192x192" href="/favicons/android-icon-192x192.png">
|
|
<link rel="icon" type="image/png" sizes="32x32" href="/favicons/favicon-32x32.png">
|
|
<link rel="icon" type="image/png" sizes="96x96" href="/favicons/favicon-96x96.png">
|
|
<link rel="icon" type="image/png" sizes="16x16" href="/favicons/favicon-16x16.png">
|
|
<link rel="manifest" href="/manifest.json">
|
|
<meta name="msapplication-TileColor" content="#ffffff">
|
|
<meta name="msapplication-TileImage" content="/favicons/ms-icon-144x144.png">
|
|
<meta name="theme-color" content="#ffffff">`;
|
|
|
|
// preload images when applicable
|
|
h += `<link rel="preload" as="image" href="./images/wallpaper.webp">`;
|
|
h += `</head>`;
|
|
|
|
h += `<body>`;
|
|
|
|
// To indicate that the GUI is running to any 3rd-party scripts that may be running on the page
|
|
// specifically, the `puter.js` script
|
|
// This line is also present verbatim in `src/index.js` for production builds
|
|
h += `<script>window.puter_gui_enabled = true;</script>`;
|
|
|
|
// DEV: load every JS library individually
|
|
if(options.env === 'dev'){
|
|
for(let i = 0; i < lib_paths.length; i++){
|
|
h += `<script src="${lib_paths[i]}"></script>`;
|
|
}
|
|
}
|
|
|
|
// load images and icons as base64 for performance
|
|
if(options.env === 'dev'){
|
|
h += `<script>`;
|
|
h += `window.icons = {};`
|
|
fs.readdirSync(path.join(__dirname, 'src/icons')).forEach(file => {
|
|
// skip dotfiles
|
|
if(file.startsWith('.'))
|
|
return;
|
|
// load image
|
|
let buff = new Buffer.from(fs.readFileSync(path.join(__dirname, 'src/icons') + '/' + file));
|
|
// convert to base64
|
|
let base64data = buff.toString('base64');
|
|
// add to `window.icons`
|
|
if(file.endsWith('.png'))
|
|
h += `window.icons['${file}'] = "data:image/png;base64,${base64data}";\n`;
|
|
else if(file.endsWith('.svg'))
|
|
h += `window.icons['${file}'] = "data:image/svg+xml;base64,${base64data}";\n`;
|
|
});
|
|
h += `</script>`;
|
|
}
|
|
|
|
|
|
// PROD: gui.js
|
|
if(options.env === 'prod'){
|
|
h += `<script src="/dist/gui.js"></script>`;
|
|
}
|
|
// DEV: load every JS file individually
|
|
else{
|
|
for(let i = 0; i < js_paths.length; i++){
|
|
h += `<script type="module" src="${js_paths[i]}"></script>`;
|
|
}
|
|
// load GUI
|
|
h += `<script type="module" src="/index.js"></script>`;
|
|
}
|
|
|
|
// ----------------------------------------
|
|
// Initialize GUI with config options
|
|
// ----------------------------------------
|
|
h += `
|
|
<script type="text/javascript">
|
|
window.addEventListener('load', function() {`
|
|
h += `gui()`;
|
|
h += `});
|
|
</script>`;
|
|
|
|
h += `</body>
|
|
|
|
</html>`;
|
|
|
|
console.log(`/index.js: ` + (Date.now() - start_t)/1000);
|
|
return h;
|
|
}
|
|
|
|
// export
|
|
export { generateDevHtml, build };
|