@fontoxml/fontoxml-development-tools 3.10.0 → 3.12.0-beta.1

package/src/modules/review/src/command.upgrade.controller.js

@@ -1,59 +0,0 @@
-import fs from 'fs-extra';
-import path from 'path';
-
-import constants from './utilities/constants.js';
-import FontoxmlReviewManifest from './utilities/FontoxmlReviewManifest.js';
-import setEntryVisibility from './utilities/setEntryVisibility.js';
-import validateInstance from './utilities/validateInstance.js';
-
-export default async function upgradeCommand(req, res) {
-	res.caption(req.command.getLongName());
-
-	// Check if the given version exist.
-	const sdkVersions = await req.fdt.license.getVersionsForProduct('review');
-	const version = req.options.version;
-	if (!sdkVersions.includes(version)) {
-		throw new Error(
-			`Could not upgrade to version (${version}), please check if it is a valid version. The latest version is ${sdkVersions.getLatestStable()}, run \`fdt review versions\` to get a list of all available versions.`
-		);
-	}
-
-	const destroySpinner = res.spinner(
-		`Upgrading your Fonto Review instance to ${version}...`
-	);
-
-	const directoryPath = path.resolve(
-		req.options.location ? req.options.location : process.cwd()
-	);
-	const manifestFilePath = path.join(
-		directoryPath,
-		constants.MANIFEST_FILENAME
-	);
-	let currentVersion;
-	return validateInstance(directoryPath)
-		.then(() => setEntryVisibility(manifestFilePath, true))
-		.then(() => FontoxmlReviewManifest.fromJsonFile(manifestFilePath))
-		.then((manifest) => {
-			currentVersion = manifest.reviewVersion;
-			manifest.reviewVersion = version;
-			return fs.writeJson(manifestFilePath, manifest);
-		})
-		.then(() => setEntryVisibility(manifestFilePath, false))
-		.then(() =>
-			req.fdt.license.sendTelemetry({
-				product: req.command.parent.name,
-				type: 'docker',
-				version,
-				currentVersion,
-				action: req.command.name,
-			})
-		)
-		.then(() => destroySpinner())
-		.catch((error) => {
-			res.notice(
-				`See our documentation at ${constants.DOCUMENTATION_EXECUTE_ERROR} for help.`
-			);
-
-			throw error;
-		});
-}

package/src/modules/review/src/command.upgrade.js

@@ -1,42 +0,0 @@
-import path from 'path';
-import { fileURLToPath } from 'url';
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-
-export default (moduleRegistration, reviewCommand) => {
-	reviewCommand
-		.addCommand(
-			'upgrade',
-			path.resolve(__dirname, 'command.upgrade.controller.js')
-		)
-		.setDescription(
-			'Upgrade an existing Fonto Review instance to the specified version.'
-		)
-
-		.addOption(
-			'location',
-			'l',
-			'The directory of the instance to upgrade. If not set this defaults to the current working directory.',
-			false
-		)
-		.addOption(
-			'version',
-			null,
-			'The version to upgrade to. Can be either a specific version or "nightly". Be warned: nightly can be unstable or may not work at all.',
-			true
-		)
-
-		.addExample(
-			`${
-				moduleRegistration.getAppInfo().name
-			} review upgrade --version x.x.x`,
-			'Upgrade the Fonto Review instance located at the current working directory to version x.x.x.'
-		)
-		.addExample(
-			`${
-				moduleRegistration.getAppInfo().name
-			} review upgrade --location /opt/my-instance/ --version x.x.x`,
-			'Upgrade the Fonto Review instance located at "/opt/my-instance/" to version x.x.x.'
-		);
-};

package/src/modules/review/src/command.versions.controller.js

@@ -1,12 +0,0 @@
-export default async function versionsCommand(req, res) {
-	res.caption(req.command.getLongName());
-
-	const all = req.options.all;
-	const destroySpinner = res.spinner(
-		`Retrieving ${all ? 'all ' : ''}Fonto Review versions...`
-	);
-	const sdkVersions = await req.fdt.license.getVersionsForProduct('review');
-	destroySpinner();
-	res.caption('Fonto Review versions');
-	res.list(all ? sdkVersions.getAll() : sdkVersions.getAllStable(), '-');
-}

package/src/modules/review/src/command.versions.js

@@ -1,25 +0,0 @@
-import path from 'path';
-import { fileURLToPath } from 'url';
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-
-export default (moduleRegistration, reviewCommand) => {
-	reviewCommand
-		.addCommand(
-			'versions',
-			path.resolve(__dirname, 'command.versions.controller.js')
-		)
-		.setDescription('List the available Fonto Review versions.')
-
-		.addHiddenOption(
-			'all',
-			undefined,
-			'Include nightly and prerelease versions.'
-		)
-
-		.addExample(
-			`${moduleRegistration.getAppInfo().name} review versions`,
-			'Request the available versions for Fonto Review.'
-		);
-};

package/src/modules/review/src/utilities/FontoxmlReviewManifest.js

@@ -1,30 +0,0 @@
-import fs from 'fs-extra';
-
-export default class FontoxmlReviewManifest {
-	constructor(reviewVersion) {
-		this.reviewVersion = reviewVersion;
-	}
-
-	static fromJsonFile(filePath) {
-		return fs
-			.exists(filePath)
-			.then((exists) => {
-				if (!exists) {
-					throw new Error(`The file ${filePath} does not exist.`);
-				}
-			})
-			.then(() => fs.readJson(filePath))
-			.then((content) => {
-				FontoxmlReviewManifest.validate(content);
-				return new FontoxmlReviewManifest(content.reviewVersion);
-			});
-	}
-
-	static validate(input) {
-		if (!input.reviewVersion) {
-			throw new Error(
-				"The Fonto Review manifest file does not contain a 'reviewVersion'."
-			);
-		}
-	}
-}

package/src/modules/review/src/utilities/cleanup.js

@@ -1,70 +0,0 @@
-import fs from 'fs-extra';
-import path from 'path';
-
-import constants from './constants.js';
-import executeAndLog from './executeAndLog.js';
-
-export default async function cleanup(
-	temporaryDirectoryPath,
-	projectName,
-	res,
-	verbosityLevel
-) {
-	const temporaryDirectoryExists = await fs.exists(temporaryDirectoryPath);
-	if (!temporaryDirectoryExists) {
-		return;
-	}
-
-	const destroySpinner = res.spinner('Removing temporary resources...');
-
-	try {
-		const dockerComposeFileExists = await fs.exists(
-			path.join(temporaryDirectoryPath, 'docker-compose.yml')
-		);
-
-		const errors = [];
-		const tasks = [
-			async () => {
-				if (dockerComposeFileExists && projectName) {
-					await executeAndLog(
-						res,
-						'docker-compose',
-						verbosityLevel === constants.VERBOSITY_LEVEL_DEBUG
-							? [
-									'-p',
-									projectName,
-									'--verbose',
-									'down',
-									'--rmi',
-									'local',
-							  ]
-							: ['-p', projectName, 'down', '--rmi', 'local'],
-						temporaryDirectoryPath,
-						verbosityLevel
-					);
-				}
-			},
-			async () => {
-				await fs.remove(temporaryDirectoryPath);
-			},
-		];
-
-		// Run all cleanup tasks in order. Continue on errors. But collect the errors.
-		for (let i = 0; i < tasks.length; i++) {
-			try {
-				await tasks[i]();
-			} catch (error) {
-				errors.push(error);
-			}
-		}
-
-		// Only throw if a task have failed.
-		if (errors.length > 0) {
-			throw errors[0];
-		}
-	} catch (error) {
-		throw error;
-	} finally {
-		destroySpinner();
-	}
-}

package/src/modules/review/src/utilities/constants.js

@@ -1,42 +0,0 @@
-import path from 'path';
-import { fileURLToPath } from 'url';
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-
-export default {
-	DEFAULT_IMAGE_NAME: 'fonto-review',
-	DEFAULT_IMAGE_TAG: 'latest',
-	VERBOSITY_LEVEL_DEBUG: 'debug',
-	VERBOSITY_LEVEL_NORMAL: 'normal',
-	VERBOSITY_LEVEL_VERBOSE: 'verbose',
-	DOCUMENTATION_CONFIGURATION_GUIDE:
-		'https://documentation.fontoxml.com/latest/configuration-13d2d631668c',
-	DOCUMENTATION_GETTING_STARTED_GUIDE:
-		'https://documentation.fontoxml.com/latest/getting-started-8ca615260377',
-	DOCUMENTATION_EXECUTE_ERROR:
-		'https://documentation.fontoxml.com/latest/review-9c9f35e6d1bf',
-	INSTANCE_BUILD_DIRECTORY_PATH: path.join(
-		__dirname,
-		'..',
-		'..',
-		'instanceBuild'
-	),
-	INSTANCE_DEV_BUILD_DIRECTORY_PATH: path.join(
-		__dirname,
-		'..',
-		'..',
-		'instanceDevBuild'
-	),
-	INSTANCE_TEMPLATE_DIRECTORY_PATH: path.join(
-		__dirname,
-		'..',
-		'..',
-		'instanceTemplate'
-	),
-	MANIFEST_FILENAME: '.fontoxmlReviewManifest',
-	REQUIRED_CONFIGURATION: [],
-	TEMPORARY_DIRECTORY_NAME: '.reviewTmp',
-	TEMPORARY_BUILD_DIRECTORY_NAME: '.reviewBuildTmp',
-	WHITELIST: ['nlog.config'],
-};

package/src/modules/review/src/utilities/copyWhitelistedFiles.js

@@ -1,22 +0,0 @@
-import fs from 'fs-extra';
-import path from 'path';
-
-export default function copyWhitelistedFiles(
-	whitelistedFiles,
-	sourceDirectory,
-	destinationDirectory
-) {
-	return Promise.all(
-		whitelistedFiles.map((item) => {
-			const itemPath = path.join(sourceDirectory, item);
-			return fs.exists(itemPath).then((exists) => {
-				if (exists) {
-					return fs.copy(
-						itemPath,
-						path.join(destinationDirectory, item)
-					);
-				}
-			});
-		})
-	);
-}

package/src/modules/review/src/utilities/executeAndLog.js

@@ -1,63 +0,0 @@
-import cp from 'child_process';
-
-import constants from './constants.js';
-
-export default function executeAndLog(
-	res,
-	command,
-	args,
-	currentWorkingDirectoryPath,
-	verbosityLevel,
-	showStdout,
-	processCreatedCallback
-) {
-	return new Promise((resolve, reject) => {
-		const errors = [];
-		const childProcess = cp.spawn(command, args, {
-			cwd: currentWorkingDirectoryPath,
-		});
-		const verbose = verbosityLevel !== constants.VERBOSITY_LEVEL_NORMAL;
-
-		if (processCreatedCallback) {
-			processCreatedCallback(process);
-		}
-
-		childProcess.stdout.on('data', (data) => {
-			if (verbose || showStdout) {
-				res.log(data);
-			}
-		});
-
-		childProcess.stderr.on('data', (data) => {
-			if (verbosityLevel === constants.VERBOSITY_LEVEL_DEBUG) {
-				res.log(data);
-			} else {
-				errors.push(data.toString());
-			}
-		});
-
-		childProcess.on('error', (error) => {
-			res.error(error);
-		});
-
-		childProcess.on('close', (code) => {
-			if (code === 0) {
-				if (verbose) {
-					res.debug(
-						`${command} ${args.join(' ')} exited with code ${code}`
-					);
-				}
-				resolve();
-			} else {
-				if (verbosityLevel !== constants.VERBOSITY_LEVEL_DEBUG) {
-					errors.forEach((error) => res.log(error));
-				}
-				reject(
-					new Error(
-						`${command} ${args.join(' ')} exited with code ${code}`
-					)
-				);
-			}
-		});
-	});
-}

package/src/modules/review/src/utilities/getVerbosityLevel.js

@@ -1,11 +0,0 @@
-import constants from './constants.js';
-
-export default function getVerbosityLevel(verbose, debug) {
-	if (debug) {
-		return constants.VERBOSITY_LEVEL_DEBUG;
-	}
-	if (verbose) {
-		return constants.VERBOSITY_LEVEL_VERBOSE;
-	}
-	return constants.VERBOSITY_LEVEL_NORMAL;
-}

package/src/modules/review/src/utilities/getWhitelist.js

@@ -1,16 +0,0 @@
-import fs from 'fs-extra';
-import path from 'path';
-
-import constants from './constants.js';
-
-export default function getWhitelist() {
-	return fs
-		.readdir(constants.INSTANCE_TEMPLATE_DIRECTORY_PATH)
-		.then((entries) => {
-			return entries.map((entry) => path.basename(entry));
-		})
-		.then((whitelist) => {
-			whitelist.push(...constants.WHITELIST);
-			return whitelist;
-		});
-}

package/src/modules/review/src/utilities/validateInstance.js

@@ -1,45 +0,0 @@
-import fs from 'fs-extra';
-import path from 'path';
-
-import constants from './constants.js';
-import FontoxmlReviewManifest from './FontoxmlReviewManifest.js';
-
-export default function validateInstance(directoryPath) {
-	const manifestFilePath = path.join(
-		directoryPath,
-		constants.MANIFEST_FILENAME
-	);
-	return fs
-		.exists(directoryPath)
-		.then((exists) => {
-			if (!exists) {
-				throw new Error(`Directory "${directoryPath}" does not exist.`);
-			}
-		})
-		.then(() => fs.exists(manifestFilePath))
-		.then((exists) => {
-			// Verify fontoxmlReviewManifest file is present and valid.
-			if (!exists) {
-				throw new Error(
-					'The Fonto Review manifest file does not exist.'
-				);
-			} else {
-				return FontoxmlReviewManifest.fromJsonFile(manifestFilePath);
-			}
-		})
-		.then(() => {
-			return Promise.all(
-				constants.REQUIRED_CONFIGURATION.map((entryName) => {
-					return fs
-						.exists(path.join(directoryPath, entryName))
-						.then((exists) => {
-							if (!exists) {
-								throw new Error(
-									`Directory "${directoryPath}" does not contain a valid Fonto Review instance. Missing "${entryName}".`
-								);
-							}
-						});
-				})
-			);
-		});
-}

package/src/modules/schema-compiler/src/command.build.controller.js

@@ -1,256 +0,0 @@
-import fs from 'fs-extra';
-import path from 'path';
-
-import cleanup from './utilities/cleanup.js';
-import constants from './utilities/copyWhitelistedFiles.js';
-import executeAndLog from './utilities/executeAndLog.js';
-import FontoxmlSchemaCompilerManifest from './utilities/FontoxmlSchemaCompilerManifest.js';
-import getVerbosityLevel from './utilities/getVerbosityLevel.js';
-import getWhitelist from './utilities/getWhitelist.js';
-import setEntryVisibility from './utilities/setEntryVisibility.js';
-import validateInstance from './utilities/validateInstance.js';
-
-export default function buildCommand(req, res) {
-	res.caption(req.command.getLongName());
-
-	const directoryPath = path.resolve(
-		req.options.location ? req.options.location : process.cwd()
-	);
-	const temporaryDirectoryPath = path.join(
-		directoryPath,
-		constants.TEMPORARY_BUILD_DIRECTORY_NAME
-	);
-	const imageName = req.options['image-name']
-		? req.options['image-name']
-		: constants.DEFAULT_IMAGE_NAME;
-	const imageTag = req.options['image-tag']
-		? req.options['image-tag']
-		: constants.DEFAULT_IMAGE_TAG;
-	const manifestFilePath = path.join(
-		directoryPath,
-		constants.MANIFEST_FILENAME
-	);
-	const verbosityLevel = getVerbosityLevel(
-		req.options.verbose,
-		req.options.debug
-	);
-
-	let pidToKillOnForceExit = null;
-	const setPidToKillOnForceExit = (process) => {
-		pidToKillOnForceExit = process && process.pid;
-	};
-
-	// Ensure we cleanup before exiting.
-	let stopping = false;
-	process.on('SIGINT', (_code) => {
-		if (stopping) {
-			if (pidToKillOnForceExit) {
-				process.kill(pidToKillOnForceExit);
-			}
-			process.exit();
-			return;
-		}
-
-		stopping = true;
-		res.log('Gracefully stopping... (press Ctrl+C again to force)');
-		return cleanup(
-			temporaryDirectoryPath,
-			undefined,
-			res,
-			verbosityLevel
-		).then(process.exit);
-	});
-
-	return (
-		validateInstance(directoryPath)
-			// Cleanup possible remaining resources from a previous build or run.
-			.then(() =>
-				cleanup(temporaryDirectoryPath, undefined, res, verbosityLevel)
-			)
-			.then(() => {
-				const destroySpinner = res.spinner(
-					`Building the production image "${imageName}:${imageTag}" at "${directoryPath}"...`
-				);
-
-				// Retrieve data for the docker image
-				return FontoxmlSchemaCompilerManifest.fromJsonFile(
-					manifestFilePath
-				).then((manifestObj) => {
-					const requestObj = {
-						'schema-compiler': {
-							docker: {
-								version: manifestObj.schemaCompilerVersion,
-							},
-						},
-					};
-
-					return req.fdt.license
-						.getDataForProducts(requestObj)
-						.catch((error) => {
-							if (error.statusCode === 404) {
-								error.solution =
-									'This error might be caused by requesting a nonexistent Fonto Schema Compiler version, please check your version.';
-							}
-							throw error;
-						})
-						.then((productData) => {
-							const dockerData =
-								productData.products['schema-compiler'].docker;
-
-							// Create a hidden temporary directory.
-							return (
-								fs
-									.mkdir(temporaryDirectoryPath)
-									.then(() =>
-										setEntryVisibility(
-											temporaryDirectoryPath,
-											false
-										)
-									)
-									// Copy the instance files into the temporary directory.
-									.then(() => {
-										// Rewrite the version in the Dockerfile.
-										return fs
-											.readFile(
-												path.join(
-													constants.INSTANCE_BUILD_DIRECTORY_PATH,
-													'Dockerfile'
-												),
-												'utf8'
-											)
-											.then((dockerContent) =>
-												dockerContent.replace(
-													'${schemaCompilerImage}',
-													dockerData.image
-												)
-											)
-											.then((fixedDockerContent) =>
-												fs.writeFile(
-													path.join(
-														temporaryDirectoryPath,
-														'Dockerfile'
-													),
-													fixedDockerContent,
-													'utf8'
-												)
-											);
-									})
-									.then(() => getWhitelist())
-									.then((whitelist) =>
-										copyWhitelistedFiles(
-											whitelist,
-											directoryPath,
-											path.join(
-												temporaryDirectoryPath,
-												'instance'
-											)
-										)
-									)
-
-									// Pull the docker image
-									.then(() => {
-										return executeAndLog(
-											res,
-											'docker',
-											[
-												'login',
-												dockerData.registry,
-												'-u',
-												dockerData.login,
-												'-p',
-												dockerData.password,
-											],
-											null,
-											constants.VERBOSITY_LEVEL_NORMAL,
-											false,
-											setPidToKillOnForceExit
-										)
-											.then(() =>
-												executeAndLog(
-													res,
-													'docker',
-													['pull', dockerData.image],
-													null,
-													verbosityLevel,
-													false,
-													setPidToKillOnForceExit
-												)
-											)
-											.then(() =>
-												executeAndLog(
-													res,
-													'docker',
-													[
-														'logout',
-														dockerData.registry,
-													],
-													null,
-													constants.VERBOSITY_LEVEL_NORMAL,
-													false,
-													setPidToKillOnForceExit
-												)
-											)
-											.catch(() => {
-												throw new Error(
-													'Failed to retrieve the image file.'
-												);
-											});
-									})
-
-									// Build the docker image.
-									.then(() =>
-										executeAndLog(
-											res,
-											'docker',
-											[
-												'build',
-												'-t',
-												`${imageName}:${imageTag}`,
-												'.',
-											],
-											temporaryDirectoryPath,
-											verbosityLevel,
-											false,
-											setPidToKillOnForceExit
-										)
-									)
-									.then(() =>
-										req.fdt.license.sendTelemetry({
-											product: req.command.parent.name,
-											type: 'docker',
-											version:
-												manifestObj.schemaCompilerVersion,
-											action: req.command.name,
-										})
-									)
-									.then(() => destroySpinner())
-							);
-						});
-				});
-			})
-			// Cleanup temporary directory.
-			.then(() =>
-				cleanup(temporaryDirectoryPath, undefined, res, verbosityLevel)
-			)
-			.catch((error) => {
-				if (!stopping) {
-					res.notice(
-						`See our documentation at ${constants.DOCUMENTATION_EXECUTE_ERROR} for help.`
-					);
-				}
-
-				return cleanup(
-					temporaryDirectoryPath,
-					undefined,
-					res,
-					verbosityLevel
-				)
-					.then(() => {
-						throw error;
-					})
-					.catch(() => {
-						throw error;
-					});
-			})
-	);
-}