@raisenow/tamaro-cli 3.0.0-dev.1 → 3.0.0-dev.3

package/README.md

@@ -36,6 +36,9 @@ Available commands:
 - [`unarchive`](#unarchive)
 - [`update-epms`](#update-epms)
 - [`validate`](#validate)
+- [`typecheck`](#typecheck)
+- [`lint`](#lint)
+- [`format`](#format)
 
 ## `dev`
 
@@ -288,6 +291,39 @@ cd /path/to/tamaro-configurations/configs/epms-demo
 pnpx @raisenow/tamaro-cli validate
 ```
 
+## `typecheck`
+
+Typecheck the current Tamaro configuration.
+
+### Example
+
+```bash
+cd /path/to/tamaro-configurations/configs/epms-demo
+pnpx @raisenow/tamaro-cli typecheck
+```
+
+## `lint`
+
+Lint the current Tamaro configuration with ESLint.
+
+### Example
+
+```bash
+cd /path/to/tamaro-configurations/configs/epms-demo
+pnpx @raisenow/tamaro-cli lint
+```
+
+## `format`
+
+Format the current Tamaro configuration with Prettier.
+
+### Example
+
+```bash
+cd /path/to/tamaro-configurations/configs/epms-demo
+pnpx @raisenow/tamaro-cli format
+```
+
 # Development
 
 Use the versions declared in `package.json`:

package/dist/cli.js

@@ -1,73 +1,24 @@
 #!/usr/bin/env node
 import { createRequire } from "node:module";
+import { assertAwsProfileValid, assertAwsProfilesPresent, assertCrtExists, assertTagValid, awsAuthenticate, halt, logDataTable, logError, logInfo, logSuccess, logTitle, notify, prepareAwsCliFlags, promptAwsProfile, promptConfirmation, runCommandSync } from "@rnw-npm/cli-helpers";
 import { createCommand } from "commander";
 import fs from "node:fs";
 import path from "node:path";
 import dedent from "dedent";
-import { S3 } from "@aws-sdk/client-s3";
-import { execaCommandSync } from "execa";
-import prompts from "prompts";
-import chalk from "chalk";
-import columnify from "columnify";
-import envPaths from "env-paths";
 import * as yaml from "js-yaml";
+import envPaths from "env-paths";
 import { z } from "zod";
 import ky from "ky";
 import { createServer } from "node:http";
 import open from "open";
-import notifier from "node-notifier";
-import console$1 from "node:console";
 import { globSync } from "glob";
 import Handlebars from "handlebars";
 import helpers from "handlebars-helpers";
 import { config } from "dotenv";
 import { getPortPromise } from "portfinder";
-//#region src/lib/logging.ts
-const logTitle = (title) => {
-	console.log(chalk.bold(title));
-};
-const logError = (message) => {
-	if (message) console.log(chalk.red(message));
-};
-const logSuccess = (message) => {
-	if (message) console.log(chalk.green(message));
-};
-const logInfo = (message) => {
-	if (message) console.log(chalk.blue(message));
-};
-const logCommand = (cmd) => {
-	console.log(`\n${chalk.dim(dedent(cmd))}\n`);
-};
-const logDataTable = (data) => {
-	console.log(columnify(data, { showHeaders: false }));
-	console.log("");
-};
-const createTerminalLink = (text, url) => {
-	return `\u001B]8;;${url}\u001B\\${text}\u001B]8;;\u001B\\`;
-};
-//#endregion
-//#region src/lib/command.ts
-const halt = (message) => {
-	logError(message);
-	process.exit(1);
-};
-const prepareCommand = (cmd) => {
-	return cmd.replaceAll("\n", " ").replaceAll(/[ \t]{2,}/g, " ").trim();
-};
-const runCommandSync = (cmd, options) => {
-	return execaCommandSync(prepareCommand(cmd), options);
-};
-const promptConfirmation = async (message, skipConfirmation) => {
-	if (skipConfirmation) return;
-	const { confirmed } = await prompts([{
-		initial: false,
-		message,
-		name: "confirmed",
-		type: "confirm"
-	}], { onCancel: () => halt() });
-	if (!confirmed) halt("Operation cancelled.");
-};
-//#endregion
+import prompts from "prompts";
+import columnify from "columnify";
+import { S3 } from "@aws-sdk/client-s3";
 //#region src/lib/constants.ts
 const DEFAULT_TAG = "latest";
 const DEFAULT_PORT = 1234;
@@ -75,113 +26,16 @@ const DEFAULT_HTTP_TIMEOUT = 1e4;
 const AWS_S3_BUCKET_TAMARO = "tamaro.raisenow.com";
 const AWS_S3_BUCKET_TAMARO_EMAIL_CONFIG_STAGE = "rnw-stage-email-service";
 const AWS_S3_BUCKET_TAMARO_EMAIL_CONFIG_PROD = "rnw-email-service";
+const AWS_CLOUDFRONT_DISTRIBUTION_ID = "EHJ1OM458YQ0I";
 const EPMS_API_BASE_URL_STAGE = "https://api.stage.mesos.raisenow.net";
 const EPMS_API_BASE_URL_PROD = "https://api.raisenow.io";
 const EPMS_AUTH_BASE_URL_STAGE = "https://login.stage.mesos.raisenow.net";
 const EPMS_AUTH_BASE_URL_PROD = "https://login.raisenow.com";
 const EPMS_OAUTH_CLIENT_ID = "tamaro-cli";
 const AUTH_PORT = 4571;
-const AWS_CLOUDFRONT_DISTRIBUTION_ID = "EHJ1OM458YQ0I";
-const HTTPS_CRT_FILE = "localhost.crt";
-const HTTPS_KEY_FILE = "localhost.key";
 const CACHE_DIR = envPaths("tamaro-cli", { suffix: "" }).cache;
 const TAMARO_VERSION_IN_URL_REGEX = /tamaro-core\/(.*)\/index.js/;
 //#endregion
-//#region src/lib/aws.ts
-const awsAuthenticate = (options) => {
-	if (options.ci)
- /**
-	* Don't try to authenticate the user.
-	* This is done when CLI is running within an automated system like pipeline,
-	* In this case "AWS_ACCESS_KEY_ID" and "AWS_SECRET_ACCESS_KEY" are used instead of "AWS_PROFILE".
-	*/
-	return;
-	try {
-		checkIdentity(options);
-	} catch {
-		login(options);
-	}
-};
-const assertProfilesPresent = () => {
-	if (getAvailableProfiles().length === 0) halt(dedent`
-        No AWS profiles found.
-        Run "aws configure sso" to set up SSO-enabled profile.
-        Check the wiki for more information:
-        https://raisenow.atlassian.net/wiki/x/lIrWvg
-      `);
-};
-const getAvailableProfiles = () => {
-	const { stdout } = execaCommandSync("aws configure list-profiles");
-	return stdout.split("\n");
-};
-/**
-* Returns caller identity data (output is ignored here).
-* Fails in case of expired SSO session.
-*/
-const checkIdentity = (options) => {
-	execaCommandSync(`aws sts get-caller-identity ${prepareFlags(options)}`);
-};
-/**
-* Opens SSO authentication page in the browser.
-* Fails if user canceled authentication process.
-*/
-const login = (options) => {
-	const flags = prepareFlags(options);
-	try {
-		execaCommandSync(`aws sso login ${flags}`, { stdio: "inherit" });
-		console.log("");
-	} catch {
-		halt("Login failed.");
-	}
-};
-const prepareFlags = (options) => {
-	const flags = [];
-	const { profile } = options;
-	if (profile) flags.push(`--profile ${profile}`);
-	return flags.join(" ");
-};
-const assertProfileValid = (profile) => {
-	const profiles = getAvailableProfiles();
-	if (!profiles.includes(profile)) halt(dedent`
-        AWS profile "${profile}" is not found.
-        Available profiles are: ${profiles.map((v) => `"${v}"`).join(", ")}.
-      `);
-};
-const promptProfile = async () => {
-	const { profile } = await prompts([{
-		choices: getAvailableProfiles().filter((v) => !!v).map((v) => ({
-			title: v,
-			value: v
-		})),
-		message: "Select AWS profile",
-		name: "profile",
-		type: "select"
-	}], { onCancel: () => halt() });
-	return profile;
-};
-const s3 = new S3({});
-const getConfigDeployments = async (configName) => {
-	const widgetJs = (await s3.listObjectsV2({
-		Bucket: "tamaro.raisenow.com",
-		Prefix: `${configName}/`
-	})).Contents?.filter((file) => file.Key?.endsWith(`/index.html`)) ?? [];
-	const deployments = [];
-	for (const file of widgetJs) {
-		const key = file.Key ?? "";
-		const parts = key.split("/");
-		if (parts.length < 2 || !file.LastModified) continue;
-		const tag = parts.at(-2);
-		const date = file.LastModified.toISOString();
-		const fullUrl = `https://${AWS_S3_BUCKET_TAMARO}/${key}`;
-		deployments.push({
-			date,
-			fullUrl,
-			tag
-		});
-	}
-	return deployments;
-};
-//#endregion
 //#region src/lib/resolve.ts
 const resolveAccountUuidFromConfig = (rawConfig, field) => {
 	const epmsConfig = z.object({ [field]: z.record(z.string(), z.unknown()) }).safeParse(rawConfig);
@@ -292,6 +146,11 @@ const createAuthorizer = (baseUrl, clientId, clientSecret) => {
 	}] } });
 };
 //#endregion
+//#region src/lib/logging.ts
+const createTerminalLink = (text, url) => {
+	return `\u001B]8;;${url}\u001B\\${text}\u001B]8;;\u001B\\`;
+};
+//#endregion
 //#region src/lib/epms/auth/authCallback.html
 var authCallback_default = "<!doctype html>\n<html>\n  <head\n    ><title>Authenticating</title></head\n  >\n  <body>\n    <p>Authenticating</p>\n    <script>\n      const hash = window.location.hash.substring(1)\n      const params = new URLSearchParams(hash)\n      const data = {\n        access_token: params.get('access_token'),\n        token_type: params.get('token_type'),\n        expires_in: parseInt(params.get('expires_in') || '0', 10),\n      }\n      fetch('/token', {\n        method: 'POST',\n        headers: {'Content-Type': 'application/json'},\n        body: JSON.stringify(data),\n      })\n        .then(() => {\n          document.querySelector('p').textContent =\n            'Authentication successful! You can close this tab.'\n        })\n        .catch(() => {\n          document.querySelector('p').textContent =\n            'Authentication failed. Please try again.'\n        })\n    <\/script>\n  </body>\n</html>\n";
 //#endregion
@@ -516,17 +375,6 @@ const assertUserIsSuperAdmin = async (epmsClient) => {
 	}
 };
 //#endregion
-//#region src/lib/notifier.ts
-const notify = (args) => {
-	const { message = "", title } = args;
-	notifier.notify({
-		contentImage: "https://assets.raisenow.io/favicon.png",
-		message: dedent(message),
-		sound: "Funk",
-		title
-	});
-};
-//#endregion
 //#region src/commands/archive.ts
 const archive = async (options) => {
 	assertIsNotArchived();
@@ -585,7 +433,7 @@ const archiveEpms = async (configName, dryrun) => {
 };
 const assertOptionsValid$7 = (options) => {
 	const { profile } = options;
-	if (profile) assertProfileValid(profile);
+	if (profile) assertAwsProfileValid(profile);
 };
 const assertIsNotArchived = () => {
 	if (path.basename(path.dirname(process.cwd())) === "_archived") halt("This configuration is already archived.");
@@ -780,21 +628,15 @@ const getOutDir = (configName) => {
 	return path.resolve(getConfigsPackageRoot(), "dist", configName);
 };
 //#endregion
-//#region src/lib/validators/assertTagValid.ts
-const assertTagValid = (tag) => {
-	const regex = /^[\w.-]+$/;
-	if (!regex.test(tag)) halt(`Flag "--tag" has forbidden format. Allowed format: ${regex.toString()}.`);
-};
-//#endregion
 //#region src/commands/update-epms.ts
 const updateEpms = async (options) => {
 	const configName = getConfigName();
 	if (!options.profile && !options.ci) {
-		assertProfilesPresent();
-		options.profile = await promptProfile();
+		assertAwsProfilesPresent();
+		options.profile = await promptAwsProfile();
 	}
 	if (options.profile) {
-		assertProfileValid(options.profile);
+		assertAwsProfileValid(options.profile);
 		process.env.AWS_PROFILE = options.profile;
 	}
 	awsAuthenticate(options);
@@ -864,13 +706,13 @@ const deploy = async (options) => {
 	const outDir = getOutDir(configName);
 	assertOutDir(configName);
 	if (!options.profile && !options.ci) {
-		assertProfilesPresent();
-		options.profile = await promptProfile();
+		assertAwsProfilesPresent();
+		options.profile = await promptAwsProfile();
 	}
 	assertOptionsValid$6(options);
 	await validate();
 	awsAuthenticate(options);
-	const flags = prepareFlags(options);
+	const flags = prepareAwsCliFlags(options);
 	const { dryrun, tag } = options;
 	const dryRunFlag = dryrun ? `--dryrun` : "";
 	const deployUrl = `s3://${AWS_S3_BUCKET_TAMARO}/${configName}/${tag}`;
@@ -879,54 +721,47 @@ const deploy = async (options) => {
 	/**
 	* Sync all files except entrypoint (without deleting old files)
 	*/
-	const cmdSyncAll = `
-    aws s3 sync ${outDir} ${deployUrl}
-      --acl public-read
-      --exclude ${outDir}/${entryFilename}
-      --cache-control max-age=31536000
-      ${flags}
-      ${dryRunFlag}
-  `;
-	logTitle("Deploying to AWS S3...");
-	logCommand(cmdSyncAll);
 	try {
-		runCommandSync(cmdSyncAll, { stdout: "inherit" });
+		logTitle("Deploying to AWS S3...");
+		runCommandSync(dedent`
+        aws s3 sync ${outDir} ${deployUrl}
+          --acl public-read
+          --exclude ${outDir}/${entryFilename}
+          --cache-control max-age=31536000
+          ${flags}
+          ${dryRunFlag}
+      `, { stdout: "inherit" });
 	} catch (error) {
 		halt(error.stderr);
 	}
 	/**
 	* Copy entrypoint
 	*/
-	const cmdCpEntry = `
-    aws s3 cp ${outDir}/${entryFilename} ${deployUrl}/${entryFilename}
-      --acl public-read
-      --cache-control max-age=64800
-      ${flags}
-      ${dryRunFlag}
-  `;
-	logCommand(cmdCpEntry);
 	try {
-		runCommandSync(cmdCpEntry, { stdout: "inherit" });
+		runCommandSync(dedent`
+        aws s3 cp ${outDir}/${entryFilename} ${deployUrl}/${entryFilename}
+          --acl public-read
+          --cache-control max-age=64800
+          ${flags}
+          ${dryRunFlag}
+      `, { stdout: "inherit" });
 	} catch (error) {
 		halt(error.stderr);
 	}
-	if (!dryRunFlag) {
-		/**
-		* Invalidate cloudfront cache
-		*/
-		const cmdInvalidateCache = `
-    aws cloudfront create-invalidation
-      --distribution-id ${AWS_CLOUDFRONT_DISTRIBUTION_ID}
-      --paths /${configName}/${tag}/*
-      ${flags}
-  `;
+	if (!dryRunFlag)
+ /**
+	* Invalidate cloudfront cache
+	*/
+	try {
 		logTitle("\nInvalidating edge cache...");
-		logCommand(cmdInvalidateCache);
-		try {
-			runCommandSync(cmdInvalidateCache);
-		} catch (error) {
-			halt(error.stderr);
-		}
+		runCommandSync(dedent`
+        aws cloudfront create-invalidation
+          --distribution-id ${AWS_CLOUDFRONT_DISTRIBUTION_ID}
+          --paths /${configName}/${tag}/*
+          ${flags}
+      `);
+	} catch (error) {
+		halt(error.stderr);
 	}
 	if (options.forceSkipEpmsSync) logTitle("⚠️  EPMS sync skipped. You better know what you are doing.");
 	else await updateEpms(options);
@@ -939,7 +774,7 @@ const deploy = async (options) => {
 	});
 	process.on("exit", () => {
 		notify({
-			message: dedent`
+			message: `
         Bundle for "${configName}" is deployed with tag "${tag}".
         Demo page: ${demoPage}
         Entry point: ${entryPoint}
@@ -950,36 +785,20 @@ const deploy = async (options) => {
 };
 const assertOptionsValid$6 = (options) => {
 	const { profile, tag } = options;
-	if (profile) assertProfileValid(profile);
+	if (profile) assertAwsProfileValid(profile);
 	assertTagValid(tag);
 };
 //#endregion
-//#region src/lib/https.ts
-const assertCrtExists = () => {
-	const configsPackageRoot = getConfigsPackageRoot();
-	const certFile = path.resolve(configsPackageRoot, HTTPS_CRT_FILE);
-	const keyFile = path.resolve(configsPackageRoot, HTTPS_KEY_FILE);
-	if (fs.existsSync(certFile) && fs.existsSync(keyFile)) return;
-	halt(dedent`
-      Files "${HTTPS_CRT_FILE}" and/or "${HTTPS_KEY_FILE}" are not found.
-      You need to generate local certificates first.
-      1. Install mkcert:
-        brew install mkcert
-      2. Generate the certificate and key in the repository root:
-        mkcert -install -cert-file ${HTTPS_CRT_FILE} -key-file ${HTTPS_KEY_FILE} localhost 127.0.0.1 0.0.0.0 ::1
-    `);
-};
-//#endregion
 //#region src/commands/preview.ts
 const preview = async () => {
 	const configName = getConfigName();
 	const configsPackageRoot = getConfigsPackageRoot();
+	const relativeOutDir = path.relative(configsPackageRoot, getOutDir(configName));
 	assertOutDir(configName);
-	assertCrtExists();
-	const cmd = `pnpm sirv ${path.relative(configsPackageRoot, getOutDir(configName))} --cors --http2 --cert ${HTTPS_CRT_FILE} --key ${HTTPS_KEY_FILE} --port ${await getPortPromise({ port: Number(DEFAULT_PORT) })}`;
-	logTitle(`Running web-server for pre-built bundle...`);
-	logCommand(cmd);
-	runCommandSync(cmd, {
+	assertCrtExists(configsPackageRoot);
+	const port = await getPortPromise({ port: Number(DEFAULT_PORT) });
+	logTitle("\nRunning web-server for pre-built bundle...");
+	runCommandSync(`pnpm sirv ${relativeOutDir} --cors --http2 --cert localhost.crt --key localhost.key --port ${port}`, {
 		cwd: configsPackageRoot,
 		stdio: "inherit"
 	});
@@ -991,27 +810,23 @@ const build = async (options) => {
 	const configsPackageRoot = getConfigsPackageRoot();
 	const outDir = getOutDir(configName);
 	if (options.deploy && !options.profile && !options.ci) {
-		assertProfilesPresent();
-		options.profile = await promptProfile();
+		assertAwsProfilesPresent();
+		options.profile = await promptAwsProfile();
 	}
 	assertOptionsValid$5(options);
 	await validate();
-	const cmd = `pnpm vite build`;
-	const env = {
-		...process.env,
-		BABEL: options.babel ? "true" : "false",
-		CONFIG_NAME: configName,
-		MINIFY: options.minify ? "true" : "false"
-	};
 	logTitle(`Building optimised (minified) bundle of "${configName}" customer configuration...`);
-	logCommand(cmd);
-	runCommandSync(cmd, {
+	runCommandSync(`pnpm vite build`, {
 		cwd: configsPackageRoot,
-		env,
+		env: {
+			BABEL: options.babel ? "true" : "false",
+			CONFIG_NAME: configName,
+			MINIFY: options.minify ? "true" : "false"
+		},
 		stdio: "inherit"
 	});
 	logTitle(`\nBundle for "${configName}" customer configuration is done.`);
-	console$1.log(`Path: ${outDir}\n`);
+	console.log(`Path: ${outDir}\n`);
 	process.on("exit", () => {
 		notify({
 			message: `Bundle for "${configName}" customer configuration is done.`,
@@ -1022,8 +837,9 @@ const build = async (options) => {
 	if (options.deploy) await deploy(options);
 };
 const assertOptionsValid$5 = (options) => {
-	const { profile } = options;
-	if (profile) assertProfileValid(profile);
+	const { preview, profile } = options;
+	if (preview) assertCrtExists(getConfigsPackageRoot());
+	if (profile) assertAwsProfileValid(profile);
 };
 //#endregion
 //#region src/commands/deploy-email-config.ts
@@ -1032,28 +848,26 @@ const deployEmailConfig = async (options) => {
 	const emailConfigPath = `${getInputDir(configName)}/email-config`;
 	assertEmailConfigPathExists(emailConfigPath);
 	if (!options.profile && !options.ci) {
-		assertProfilesPresent();
-		options.profile = await promptProfile();
+		assertAwsProfilesPresent();
+		options.profile = await promptAwsProfile();
 	}
 	if (!options.bucket) options.bucket = options.ci ? AWS_S3_BUCKET_TAMARO_EMAIL_CONFIG_PROD : await promptBucketTamaroEmailConfig$1();
 	assertOptionsValid$4(options);
 	await validate();
 	awsAuthenticate(options);
-	const flags = prepareFlags(options);
+	const flags = prepareAwsCliFlags(options);
 	const dryRunFlag = options.dryrun ? `--dryrun` : "";
 	const deployUrl = `s3://${options.bucket}/${configName}`;
 	if (dryRunFlag) logTitle("🧪 DRY RUN MODE - No actual changes will be made 🧪");
-	const cmd = `
-    aws s3 sync ${emailConfigPath} ${deployUrl}
-      --delete
-      --exact-timestamps
-      ${flags}
-      ${dryRunFlag}
-  `;
-	logTitle(`Deploying email configuration for "${configName}" customer configuration to AWS S3...`);
-	logCommand(cmd);
 	try {
-		runCommandSync(cmd, { stdout: "inherit" });
+		logTitle(`Deploying email configuration for "${configName}" customer configuration to AWS S3...`);
+		runCommandSync(dedent`
+        aws s3 sync ${emailConfigPath} ${deployUrl}
+          --delete
+          --exact-timestamps
+          ${flags}
+          ${dryRunFlag}
+      `, { stdout: "inherit" });
 	} catch (error) {
 		halt(error.stderr);
 	}
@@ -1068,7 +882,7 @@ const deployEmailConfig = async (options) => {
 };
 const assertOptionsValid$4 = (options) => {
 	const { bucket, profile } = options;
-	if (profile) assertProfileValid(profile);
+	if (profile) assertAwsProfileValid(profile);
 	if (bucket) assertBucketValid$1(bucket);
 };
 const assertEmailConfigPathExists = (distPath) => {
@@ -1097,27 +911,87 @@ const promptBucketTamaroEmailConfig$1 = async () => {
 const dev = async (options) => {
 	const configName = getConfigName();
 	const configsPackageRoot = getConfigsPackageRoot();
-	const cmd = `pnpm vite dev --port ${await getPortPromise({ port: Number(DEFAULT_PORT) })}`;
-	const env = {
-		...process.env,
-		CONFIG_NAME: configName,
-		LOCAL_CORE: options.localCore ? "true" : "false"
-	};
+	assertCrtExists(configsPackageRoot);
+	const port = await getPortPromise({ port: Number(DEFAULT_PORT) });
 	logTitle(`\nStarting Vite dev server for "${configName}" configuration...`);
-	logCommand(cmd);
-	runCommandSync(cmd, {
+	runCommandSync(`pnpm vite dev --port ${port}`, {
+		cwd: configsPackageRoot,
+		env: {
+			CONFIG_NAME: configName,
+			LOCAL_CORE: options.localCore ? "true" : "false"
+		},
+		stdio: "inherit"
+	});
+};
+//#endregion
+//#region src/commands/format.ts
+const format = () => {
+	const configsPackageRoot = getConfigsPackageRoot();
+	const relativeCwd = path.relative(configsPackageRoot, process.cwd());
+	logTitle("Formatting root with Prettier...");
+	runCommandSync("pnpm prettier --write . \"!configs/**\"", {
+		cwd: configsPackageRoot,
+		shell: true,
+		stdio: "inherit"
+	});
+	logTitle(`\nFormatting config folder "${relativeCwd}" with Prettier...`);
+	runCommandSync(`pnpm prettier --write ${relativeCwd}`, {
+		cwd: configsPackageRoot,
+		shell: true,
+		stdio: "inherit"
+	});
+};
+//#endregion
+//#region src/commands/lint.ts
+const lint = () => {
+	const configsPackageRoot = getConfigsPackageRoot();
+	const relativeCwd = path.relative(configsPackageRoot, process.cwd());
+	const env = { DEBUG: "eslint:eslint-helpers" };
+	logTitle("Linting root with ESLint...");
+	runCommandSync("pnpm eslint --ignore-pattern \"configs/\" .", {
+		cwd: configsPackageRoot,
+		env,
+		shell: true,
+		stdio: "inherit"
+	});
+	logTitle(`\nLinting config folder "${relativeCwd}" with ESLint...`);
+	runCommandSync(`pnpm eslint ${relativeCwd}`, {
 		cwd: configsPackageRoot,
 		env,
+		shell: true,
 		stdio: "inherit"
 	});
 };
 //#endregion
+//#region src/lib/aws.ts
+const getConfigDeployments = async (configName) => {
+	const widgetJs = (await new S3({}).listObjectsV2({
+		Bucket: "tamaro.raisenow.com",
+		Prefix: `${configName}/`
+	})).Contents?.filter((file) => file.Key?.endsWith(`/index.html`)) ?? [];
+	const deployments = [];
+	for (const file of widgetJs) {
+		const key = file.Key ?? "";
+		const parts = key.split("/");
+		if (parts.length < 2 || !file.LastModified) continue;
+		const tag = parts.at(-2);
+		const date = file.LastModified.toISOString();
+		const fullUrl = `https://${AWS_S3_BUCKET_TAMARO}/${key}`;
+		deployments.push({
+			date,
+			fullUrl,
+			tag
+		});
+	}
+	return deployments;
+};
+//#endregion
 //#region src/commands/list-deployed.ts
 const listDeployed = async (options) => {
 	const configName = getConfigName();
 	if (!options.profile && !options.ci) {
-		assertProfilesPresent();
-		options.profile = await promptProfile();
+		assertAwsProfilesPresent();
+		options.profile = await promptAwsProfile();
 	}
 	assertOptionsValid$3(options);
 	awsAuthenticate(options);
@@ -1148,7 +1022,18 @@ const listDeployed = async (options) => {
 };
 const assertOptionsValid$3 = (options) => {
 	const { profile } = options;
-	if (profile) assertProfileValid(profile);
+	if (profile) assertAwsProfileValid(profile);
+};
+//#endregion
+//#region src/commands/typecheck.ts
+const typecheck = () => {
+	const configsPackageRoot = getConfigsPackageRoot();
+	const relativeCwd = path.relative(configsPackageRoot, process.cwd());
+	logTitle("Running TypeScript type-checking...");
+	runCommandSync(`pnpm tsc --project ${relativeCwd}/tsconfig.json`, {
+		cwd: configsPackageRoot,
+		stdio: "inherit"
+	});
 };
 //#endregion
 //#region src/commands/unarchive.ts
@@ -1209,7 +1094,7 @@ const unarchiveEpms = async (configName, dryrun) => {
 };
 const assertOptionsValid$2 = (options) => {
 	const { profile } = options;
-	if (profile) assertProfileValid(profile);
+	if (profile) assertAwsProfileValid(profile);
 };
 const assertIsArchived = () => {
 	if (path.basename(path.dirname(process.cwd())) !== "_archived") halt("This configuration is not archived. Only archived configurations can be unarchived.");
@@ -1222,42 +1107,39 @@ const assertRestoreTargetDoesNotExist = (restoreTarget) => {
 const undeploy = async (options) => {
 	const configName = getConfigName();
 	if (!options.profile && !options.ci) {
-		assertProfilesPresent();
-		options.profile = await promptProfile();
+		assertAwsProfilesPresent();
+		options.profile = await promptAwsProfile();
 	}
 	assertOptionsValid$1(options);
 	awsAuthenticate(options);
-	const flags = prepareFlags(options);
+	const flags = prepareAwsCliFlags(options);
 	const { all, dryrun, tag = DEFAULT_TAG } = options;
 	const dryRunFlag = dryrun ? `--dryrun` : "";
 	const deployUrl = all ? `s3://${AWS_S3_BUCKET_TAMARO}/${configName}/` : `s3://${AWS_S3_BUCKET_TAMARO}/${configName}/${tag}/`;
 	const description = all ? `all tags of "${configName}"` : `tag "${tag}" of "${configName}"`;
 	if (dryRunFlag) logTitle("🧪 DRY RUN MODE - No actual changes will be made 🧪");
-	await promptConfirmation(`Are you sure you want to undeploy ${description}?`, options.ci);
-	const cmd = `
-    aws s3 rm ${deployUrl}
-      --recursive
-      ${flags}
-      ${dryRunFlag}
-  `;
-	logTitle(`Undeploying ${description} from AWS S3...`);
-	logCommand(cmd);
+	if (!options.ci) await promptConfirmation(`Are you sure you want to undeploy ${description}?`);
 	try {
-		runCommandSync(cmd, { stdout: "inherit" });
+		logTitle(`Undeploying ${description} from AWS S3...`);
+		runCommandSync(dedent`
+        aws s3 rm ${deployUrl}
+          --recursive
+          ${flags}
+          ${dryRunFlag}
+      `, { stdout: "inherit" });
 	} catch (error) {
 		halt(error.stderr);
 	}
 	if (!dryRunFlag) {
-		const cmdInvalidateCache = `
-      aws cloudfront create-invalidation
-        --distribution-id ${AWS_CLOUDFRONT_DISTRIBUTION_ID}
-        --paths ${all ? `/${configName}/*` : `/${configName}/${tag}/*`}
-        ${flags}
-    `;
-		logTitle("\nInvalidating edge cache...");
-		logCommand(cmdInvalidateCache);
+		const invalidationPath = all ? `/${configName}/*` : `/${configName}/${tag}/*`;
 		try {
-			runCommandSync(cmdInvalidateCache);
+			logTitle("\nInvalidating edge cache...");
+			runCommandSync(dedent`
+        aws cloudfront create-invalidation
+          --distribution-id ${AWS_CLOUDFRONT_DISTRIBUTION_ID}
+          --paths ${invalidationPath}
+          ${flags}
+      `);
 		} catch (error) {
 			halt(error.stderr);
 		}
@@ -1273,7 +1155,7 @@ const undeploy = async (options) => {
 };
 const assertOptionsValid$1 = (options) => {
 	const { all, profile, tag } = options;
-	if (profile) assertProfileValid(profile);
+	if (profile) assertAwsProfileValid(profile);
 	if (all && tag) halt("Flags \"--tag\" and \"--all\" must not be used together.");
 	if (!all && tag) assertTagValid(tag);
 };
@@ -1282,8 +1164,8 @@ const assertOptionsValid$1 = (options) => {
 const undeployEmailConfig = async (options) => {
 	const configName = getConfigName();
 	if (!options.profile && !options.ci) {
-		assertProfilesPresent();
-		options.profile = await promptProfile();
+		assertAwsProfilesPresent();
+		options.profile = await promptAwsProfile();
 	}
 	if (options.ci) options.bucket = AWS_S3_BUCKET_TAMARO_EMAIL_CONFIG_PROD;
 	if (!options.bucket) if (options.ci) options.bucket = AWS_S3_BUCKET_TAMARO_EMAIL_CONFIG_PROD;
@@ -1292,21 +1174,19 @@ const undeployEmailConfig = async (options) => {
 	else options.bucket = await promptBucketTamaroEmailConfig();
 	assertOptionsValid(options);
 	awsAuthenticate(options);
-	const flags = prepareFlags(options);
+	const flags = prepareAwsCliFlags(options);
 	const dryRunFlag = options.dryrun ? `--dryrun` : "";
 	const deployUrl = `s3://${options.bucket}/${configName}/`;
-	await promptConfirmation(`Are you sure you want to undeploy the email configuration for "${configName}" from "${options.bucket}"?`, options.ci);
+	if (!options.ci) await promptConfirmation(`Are you sure you want to undeploy the email configuration for "${configName}" from "${options.bucket}"?`);
 	if (dryRunFlag) logTitle("🧪 DRY RUN MODE - No actual changes will be made 🧪");
-	const cmd = `
-    aws s3 rm ${deployUrl}
-      --recursive
-      ${flags}
-      ${dryRunFlag}
-  `;
-	logTitle(`Undeploying email configuration for "${configName}" from AWS S3...`);
-	logCommand(cmd);
 	try {
-		runCommandSync(cmd, { stdout: "inherit" });
+		logTitle(`Undeploying email configuration for "${configName}" from AWS S3...`);
+		runCommandSync(dedent`
+        aws s3 rm ${deployUrl}
+          --recursive
+          ${flags}
+          ${dryRunFlag}
+      `, { stdout: "inherit" });
 	} catch (error) {
 		halt(error.stderr);
 	}
@@ -1321,7 +1201,7 @@ const undeployEmailConfig = async (options) => {
 };
 const assertOptionsValid = (options) => {
 	const { bucket, profile } = options;
-	if (profile) assertProfileValid(profile);
+	if (profile) assertAwsProfileValid(profile);
 	if (bucket) assertBucketValid(bucket);
 };
 const assertBucketValid = (bucket) => {
@@ -1345,30 +1225,25 @@ const promptBucketTamaroEmailConfig = async () => {
 //#endregion
 //#region package.json
 var name = "@raisenow/tamaro-cli";
-var version = "3.0.0-dev.1";
+var version = "3.0.0-dev.3";
 //#endregion
 //#region src/cli.ts
-/**
-* Makes the script crash on unhandled rejections instead of silently
-* ignoring them. In the future, promise rejections that are not handled will
-* terminate the Node.js process with a non-zero exit code.
-*/
-process.on("unhandledRejection", (error) => {
-	throw error;
-});
 const cli = createCommand().name(name).description("CLI for Tamaro Customer Configurations development").version(version, "-v, --version");
 cli.command("dev").description("Run the local dev-server").option("--local-core", "Load Tamaro Core from \"https://localhost:1234/src/index.ts\" rather than from CDN", false).action(dev);
 cli.command("build").description("Build an optimised (minified) bundle").option("--preview", "Run a local web server for pre-built bundle", false).option("--babel", "Use Babel for transpilation", true).option("--no-babel", "Do not use Babel for transpilation").option("--minify", "Minify the bundle", true).option("--no-minify", "Do not minify the bundle").option("--profile <profile>", "AWS profile").option("--ci", "CI environment", false).option("--deploy", "Deploy customer configuration bundle to AWS S3", false).option("--force-skip-epms-sync", "Skip the EPMS sync entirely. Only use this in emergencies.", false).option("--tag <tag>", "Tag which should be used for the deployment of the bundle", DEFAULT_TAG).action(build);
 cli.command("preview").description("Run a local web server for pre-built bundle").action(preview);
-cli.command("deploy").description("Deploy a pre-built Tamaro Core or customer configuration bundle to AWS S3").option("--profile <profile>", "AWS profile").option("--ci", "CI environment", false).option("--tag <tag>", "Tag which should be used for the deployment of the bundle", DEFAULT_TAG).option("--dryrun", "Displays the operations that would be performed without actually running them", false).option("--force-skip-epms-sync", "Skip the EPMS sync entirely. Only use this in emergencies.", false).action(deploy);
+cli.command("deploy").description("Deploy a pre-built customer configuration bundle to AWS S3").option("--profile <profile>", "AWS profile").option("--ci", "CI environment", false).option("--tag <tag>", "Tag which should be used for the deployment of the bundle", DEFAULT_TAG).option("--dryrun", "Displays the operations that would be performed without actually running them", false).option("--force-skip-epms-sync", "Skip the EPMS sync entirely. Only use this in emergencies.", false).action(deploy);
 cli.command("list-deployed").description("List deployments of customer configuration").option("--profile <profile>", "AWS profile").option("--ci", "CI environment", false).action(listDeployed);
 cli.command("deploy-email-config").description("Deploy a widget's email configuration to AWS S3").option("--profile <profile>", "AWS profile").option("--ci", "CI environment", false).option("--bucket <bucket>", "AWS bucket for email configs").option("--dryrun", "Displays the operations that would be performed without actually running them", false).action(deployEmailConfig);
-cli.command("undeploy").description("Undeploy a Tamaro Core or customer configuration bundle from AWS S3").option("--profile <profile>", "AWS profile").option("--ci", "CI environment", false).option("--tag <tag>", "Tag which should be undeployed").option("--all", "Undeploy all tags", false).option("--dryrun", "Displays the operations that would be performed without actually running them", false).action(undeploy);
+cli.command("undeploy").description("Undeploy a customer configuration bundle from AWS S3").option("--profile <profile>", "AWS profile").option("--ci", "CI environment", false).option("--tag <tag>", "Tag which should be undeployed").option("--all", "Undeploy all tags", false).option("--dryrun", "Displays the operations that would be performed without actually running them", false).action(undeploy);
 cli.command("undeploy-email-config").description("Undeploy a widget's email configuration from AWS S3").option("--profile <profile>", "AWS profile").option("--ci", "CI environment", false).option("--bucket <bucket>", "AWS bucket for email configs").option("--stage", "Undeploy from stage environment (alternative to --bucket)").option("--prod", "Undeploy from prod environment (alternative to --bucket)").option("--dryrun", "Displays the operations that would be performed without actually running them", false).action(undeployEmailConfig);
 cli.command("archive").description("Archive a customer configuration by moving it to the _archived folder").option("--profile <profile>", "AWS profile").option("--ci", "CI environment", false).option("--dryrun", "Displays the operations that would be performed without actually running them", false).option("--force-skip-epms-sync", "Skip EPMS archive sync (emergency use only)", false).action(archive);
 cli.command("unarchive").description("Unarchive a customer configuration by restoring it from the _archived folder").option("--profile <profile>", "AWS profile").option("--ci", "CI environment", false).option("--dryrun", "Displays the operations that would be performed without actually running them", false).option("--force-skip-epms-sync", "Skip EPMS unarchive sync (emergency use only)", false).action(unarchive);
 cli.command("update-epms").description("Update EPMS with the currently deployed widget tags.").option("--profile <profile>", "AWS profile").option("--ci", "CI environment", false).option("--dryrun", "Displays the operations that would be performed without actually running them", false).option("--tag <tag>", "Tag which should be set for the deployment", DEFAULT_TAG).action(updateEpms);
 cli.command("validate").description("Validate the current Tamaro configuration to avoid common errors").action(validate);
+cli.command("typecheck").description("Typecheck the current Tamaro configuration").action(typecheck);
+cli.command("lint").description("Lint the current Tamaro configuration with ESLint").action(lint);
+cli.command("format").description("Format the current Tamaro configuration with Prettier").action(format);
 try {
 	logTitle(`${name} ${version}\n`);
 	await cli.parseAsync(process.argv);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@raisenow/tamaro-cli",
-  "version": "3.0.0-dev.1",
+  "version": "3.0.0-dev.3",
   "author": {
     "name": "RaiseNow",
     "email": "development@raisenow.com"
@@ -14,7 +14,7 @@
   },
   "dependencies": {
     "@aws-sdk/client-s3": "^3.1068.0",
-    "chalk": "^5.6.2",
+    "@rnw-npm/cli-helpers": "^2.0.0-dev.1",
     "columnify": "^1.6.0",
     "commander": "^14.0.3",
     "dedent": "^1.7.2",
@@ -22,11 +22,10 @@
     "env-paths": "^4.0.0",
     "execa": "^9.6.1",
     "glob": "^13.0.6",
-    "handlebars-helpers": "^0.10.0",
     "handlebars": "^4.7.9",
+    "handlebars-helpers": "^0.10.0",
     "js-yaml": "^4.2.0",
     "ky": "^1.14.3",
-    "node-notifier": "^10.0.1",
     "open": "^11.0.0",
     "portfinder": "^1.0.38",
     "prompts": "^2.4.2",
@@ -38,7 +37,6 @@
     "@types/columnify": "^1.5.4",
     "@types/handlebars-helpers": "^0.5.6",
     "@types/js-yaml": "^4.0.9",
-    "@types/node-notifier": "^8.0.5",
     "@types/node": "^24.13.2",
     "@types/prompts": "^2.4.9",
     "eslint": "^10.5.0",