@steambrew/ttc 1.0.4 → 1.1.0

package/Compiler.ts

@@ -1,234 +1,259 @@
-import { OutputOptions, RollupOptions, rollup } from "rollup";
-import json from '@rollup/plugin-json';
-import commonjs from '@rollup/plugin-commonjs';
-import replace from '@rollup/plugin-replace';
-import typescript from '@rollup/plugin-typescript';
-import { nodeResolve } from '@rollup/plugin-node-resolve';
-import terser from '@rollup/plugin-terser';
-import babel from '@rollup/plugin-babel';
-
-import chalk from 'chalk'
-import { Logger } from "./Logger";
-import fs from 'fs';
-
-declare global {
-    interface Window {
-        PLUGIN_LIST: any
-    }
-}
-
-declare const pluginName: string, millennium_main: any, MILLENNIUM_BACKEND_IPC: any
-
-export interface TranspilerProps {
-    bTersePlugin?: boolean,
-    strPluginInternalName: string
-}
-
-const WrappedCallServerMethod = "const __call_server_method__ = (methodName, kwargs) => Millennium.callServerMethod(pluginName, methodName, kwargs)"
-const WrappedCallable = "const __wrapped_callable__ = (route) => MILLENNIUM_API.callable(__call_server_method__, route)"
-
-/**
- * @description Append the active plugin to the global plugin 
- * list and notify that the frontend Loaded.
- */
-function ExecutePluginModule() {
-	// Assign the plugin on plugin list. 
-	Object.assign(window.PLUGIN_LIST[pluginName], millennium_main)
-	// Run the rolled up plugins default exported function 
-	millennium_main["default"]();
-	MILLENNIUM_BACKEND_IPC.postMessage(1, { pluginName: pluginName })
-}
-
-/**
- * @description Append the active plugin to the global plugin 
- * list and notify that the frontend Loaded.
- */
-function ExecuteWebkitModule() {
-	// Assign the plugin on plugin list. 
-	Object.assign(window.PLUGIN_LIST[pluginName], millennium_main)
-	// Run the rolled up plugins default exported function 
-	millennium_main["default"]();
-}
-
-/**
- * @description Simple bootstrap function that initializes PLUGIN_LIST 
- * for current plugin given that is doesnt exist. 
- */
-function InitializePlugins() {
-	/** 
-	 * This function is called n times depending on n plugin count,
-	 * Create the plugin list if it wasn't already created 
-	 */
-	!window.PLUGIN_LIST && (window.PLUGIN_LIST = {})
-
-	// initialize a container for the plugin
-	if (!window.PLUGIN_LIST[pluginName]) {
-		window.PLUGIN_LIST[pluginName] = {};
-	}
-}
-
-const ContructFunctions = (parts: any) => { return parts.join('\n'); }
-
-function InsertMillennium(props: TranspilerProps) 
-{
-    const generateBundle = (_: unknown, bundle: any) => {	
-		for (const fileName in bundle) {
-			if (bundle[fileName].type != 'chunk') continue 
-			
-            Logger.Info("Injecting Millennium shims into module... " + chalk.green.bold("okay"))
-
-			bundle[fileName].code = ContructFunctions([    
-				`const pluginName = "${props.strPluginInternalName}";`,
-				InitializePlugins.toString(), InitializePlugins.name + "()",
-				WrappedCallServerMethod, WrappedCallable, bundle[fileName].code,
-				ExecutePluginModule.toString(), ExecutePluginModule.name + "()"
-			])
-		}
-    }
-
-    return { name: String(), generateBundle };
-}
-
-function InsertWebkitMillennium(props: TranspilerProps) 
-{
-    const generateBundle = (_: unknown, bundle: any) => {	
-		for (const fileName in bundle) {
-			if (bundle[fileName].type != 'chunk') continue 
-			
-            Logger.Info("Injecting Millennium shims into webkit module... " + chalk.green.bold("okay"))
-
-			bundle[fileName].code = ContructFunctions([    
-				`const pluginName = "${props.strPluginInternalName}";`,
-                InitializePlugins.toString(), InitializePlugins.name + "()",
-				WrappedCallServerMethod, WrappedCallable, bundle[fileName].code,
-				ExecuteWebkitModule.toString(), ExecuteWebkitModule.name + "()"
-			])
-		}
-    }
-
-    return { name: String(), generateBundle };
-}
-
-function GetPluginComponents(props: TranspilerProps) {
-	const pluginList = [
-        InsertMillennium(props),
-        typescript({
-            tsconfig: `./${GetFrontEndDirectory()}/tsconfig.json`
-        }), 
-        nodeResolve(), commonjs(), json(),
-		replace({
-			delimiters: ['', ''],
-			preventAssignment: true,
-            'process.env.NODE_ENV'        : JSON.stringify('production'),
-			'Millennium.callServerMethod' : `__call_server_method__`,
-            'client.callable'             : `__wrapped_callable__`,
-			'client.pluginSelf'           : 'window.PLUGIN_LIST[pluginName]',
-            'client.Millennium.exposeObj(': 'client.Millennium.exposeObj(exports, '
-		}),
-	]
-	
-	if (props.bTersePlugin) {
-		pluginList.push(terser())
-	}
-	return pluginList
-}
-
-function GetWebkitPluginComponents(props: TranspilerProps) {
-	const pluginList = [
-        InsertWebkitMillennium(props), 
-        typescript({
-            tsconfig: './webkit/tsconfig.json'
-        }), 
-        nodeResolve(), commonjs(), json(),
-        replace({
-			delimiters: ['', ''],
-			preventAssignment: true,
-			'Millennium.callServerMethod': `__call_server_method__`,
-            'webkit.callable': `__wrapped_callable__`,
-		}),
-        babel({
-            presets: ['@babel/preset-env', '@babel/preset-react'],
-            babelHelpers: 'bundled',
-        })
-	]
-	
-    props.bTersePlugin && pluginList.push(terser())
-	return pluginList
-}
-
-const GetFrontEndDirectory = () => {
-    const pluginJsonPath = './plugin.json';
-    try {
-        return JSON.parse(fs.readFileSync(pluginJsonPath, 'utf8'))?.frontend ?? "frontend";
-    } 
-    catch (error) {
-        return "frontend";
-    }
-}
-
-export const TranspilerPluginComponent = async (props: TranspilerProps) => {
-    
-    const frontendRollupConfig: RollupOptions = {
-        input: `./${GetFrontEndDirectory()}/index.tsx`,
-        plugins: GetPluginComponents(props),
-        context: 'window',
-        external: (id) => { 
-            if (id === '@steambrew/webkit') {
-                Logger.Error('The @steambrew/webkit module should not be included in the frontend module, use @steambrew/client instead. Please remove it from the frontend module and try again.')
-                process.exit(1)
-            }
-
-            return id === '@steambrew/client' || id === 'react' || id === 'react-dom'
-        },
-        output: {
-            name: "millennium_main",
-            file: ".millennium/Dist/index.js",
-            globals: {
-                "react"            : "window.SP_REACT",
-                "react-dom"        : "window.SP_REACTDOM",
-                "@steambrew/client": "window.MILLENNIUM_API"
-            },
-            exports: 'named',
-            format: 'iife'
-        }
-    }
-
-    const webkitRollupConfig: RollupOptions = {
-        input: `./webkit/index.tsx`,
-        plugins: GetWebkitPluginComponents(props),
-        context: 'window',
-        external: (id) => {
-            if (id === '@steambrew/client') {
-              Logger.Error('The @steambrew/client module should not be included in the webkit module, use @steambrew/webkit instead. Please remove it from the webkit module and try again.')
-              process.exit(1)
-            }
-
-            return id === '@steambrew/webkit'
-        },
-        output: {
-            name: "millennium_main",
-            file: ".millennium/Dist/webkit.js",
-            exports: 'named',
-            format: 'iife',
-            globals: {
-                "@steambrew/webkit": "window.MILLENNIUM_API"
-            },
-        }
-    }
-
-    Logger.Info("Starting build; this may take a few moments...")
-
-    try {
-        await (await rollup(frontendRollupConfig)).write(frontendRollupConfig.output as OutputOptions);
-
-        if (fs.existsSync(`./webkit/index.tsx`)) {
-            Logger.Info("Compiling webkit module...")
-            await (await rollup(webkitRollupConfig)).write(webkitRollupConfig.output as OutputOptions);
-        }
-        
-        Logger.Info('Build succeeded!', Number((performance.now() - global.PerfStartTime).toFixed(3)), 'ms elapsed.')
-    }
-    catch (exception) {
-        Logger.Error('Build failed!', exception)
-    }
+import { OutputOptions, RollupOptions, rollup } from "rollup";
+import json from '@rollup/plugin-json';
+import commonjs from '@rollup/plugin-commonjs';
+import replace from '@rollup/plugin-replace';
+import typescript from '@rollup/plugin-typescript';
+import resolve from '@rollup/plugin-node-resolve';
+import terser from '@rollup/plugin-terser';
+import babel from '@rollup/plugin-babel';
+
+import chalk from 'chalk'
+import { Logger } from "./Logger";
+import fs from 'fs';
+
+import injectProcessEnv from 'rollup-plugin-inject-process-env';
+import dotenv from 'dotenv';
+
+const envConfig = dotenv.config().parsed || {};
+
+if (envConfig) {
+    Logger.Info("Injecting environment variables...")
+}
+
+const envVars = Object.keys(envConfig).reduce((acc: any, key) => {
+  acc[`process.env.${key}`] = JSON.stringify(envConfig[key]);
+  return acc;
+}, {});
+
+declare global {
+    interface Window {
+        PLUGIN_LIST: any
+    }
+}
+
+declare const pluginName: string, millennium_main: any, MILLENNIUM_BACKEND_IPC: any
+
+export interface TranspilerProps {
+    bTersePlugin?: boolean,
+    strPluginInternalName: string
+}
+
+const WrappedCallServerMethod = "const __call_server_method__ = (methodName, kwargs) => Millennium.callServerMethod(pluginName, methodName, kwargs)"
+const WrappedCallable = "const __wrapped_callable__ = (route) => MILLENNIUM_API.callable(__call_server_method__, route)"
+
+/**
+ * @description Append the active plugin to the global plugin 
+ * list and notify that the frontend Loaded.
+ */
+function ExecutePluginModule() {
+	// Assign the plugin on plugin list. 
+	Object.assign(window.PLUGIN_LIST[pluginName], millennium_main)
+	// Run the rolled up plugins default exported function 
+	millennium_main["default"]();
+	MILLENNIUM_BACKEND_IPC.postMessage(1, { pluginName: pluginName })
+}
+
+/**
+ * @description Append the active plugin to the global plugin 
+ * list and notify that the frontend Loaded.
+ */
+function ExecuteWebkitModule() {
+	// Assign the plugin on plugin list. 
+	Object.assign(window.PLUGIN_LIST[pluginName], millennium_main)
+	// Run the rolled up plugins default exported function 
+	millennium_main["default"]();
+}
+
+/**
+ * @description Simple bootstrap function that initializes PLUGIN_LIST 
+ * for current plugin given that is doesnt exist. 
+ */
+function InitializePlugins() {
+	/** 
+	 * This function is called n times depending on n plugin count,
+	 * Create the plugin list if it wasn't already created 
+	 */
+	!window.PLUGIN_LIST && (window.PLUGIN_LIST = {})
+
+	// initialize a container for the plugin
+	if (!window.PLUGIN_LIST[pluginName]) {
+		window.PLUGIN_LIST[pluginName] = {};
+	}
+}
+
+const ContructFunctions = (parts: any) => { return parts.join('\n'); }
+
+function InsertMillennium(props: TranspilerProps) 
+{
+    const generateBundle = (_: unknown, bundle: any) => {	
+		for (const fileName in bundle) {
+			if (bundle[fileName].type != 'chunk') continue 
+			
+            Logger.Info("Injecting Millennium shims into module... " + chalk.green.bold("okay"))
+
+			bundle[fileName].code = ContructFunctions([    
+				`const pluginName = "${props.strPluginInternalName}";`,
+				InitializePlugins.toString(), InitializePlugins.name + "()",
+				WrappedCallServerMethod, WrappedCallable, bundle[fileName].code,
+				ExecutePluginModule.toString(), ExecutePluginModule.name + "()"
+			])
+		}
+    }
+
+    return { name: String(), generateBundle };
+}
+
+function InsertWebkitMillennium(props: TranspilerProps) 
+{
+    const generateBundle = (_: unknown, bundle: any) => {	
+		for (const fileName in bundle) {
+			if (bundle[fileName].type != 'chunk') continue 
+			
+            Logger.Info("Injecting Millennium shims into webkit module... " + chalk.green.bold("okay"))
+
+			bundle[fileName].code = ContructFunctions([    
+				`const pluginName = "${props.strPluginInternalName}";`,
+                InitializePlugins.toString(), InitializePlugins.name + "()",
+				WrappedCallServerMethod, WrappedCallable, bundle[fileName].code,
+				ExecuteWebkitModule.toString(), ExecuteWebkitModule.name + "()"
+			])
+		}
+    }
+
+    return { name: String(), generateBundle };
+}
+
+function GetPluginComponents(props: TranspilerProps) {
+
+    let tsConfigPath = `./${GetFrontEndDirectory()}/tsconfig.json`
+
+    if (!fs.existsSync(tsConfigPath)) {
+        tsConfigPath = './tsconfig.json'
+    }
+
+	const pluginList = [
+        InsertMillennium(props),
+        typescript({
+            tsconfig: tsConfigPath
+        }), 
+        resolve(), commonjs(), json(),
+        injectProcessEnv(envVars),
+		replace({
+			delimiters: ['', ''],
+			preventAssignment: true,
+            'process.env.NODE_ENV'        : JSON.stringify('production'),
+			'Millennium.callServerMethod' : `__call_server_method__`,
+            'client.callable'             : `__wrapped_callable__`,
+			'client.pluginSelf'           : 'window.PLUGIN_LIST[pluginName]',
+            'client.Millennium.exposeObj(': 'client.Millennium.exposeObj(exports, '
+		}),
+	]
+	
+	if (props.bTersePlugin) {
+		pluginList.push(terser())
+	}
+	return pluginList
+}
+
+function GetWebkitPluginComponents(props: TranspilerProps) {
+	const pluginList = [
+        InsertWebkitMillennium(props), 
+        typescript({
+            tsconfig: './webkit/tsconfig.json'
+        }), 
+        resolve(), commonjs(), json(),
+        injectProcessEnv(envVars),
+        replace({
+			delimiters: ['', ''],
+			preventAssignment: true,
+			'Millennium.callServerMethod': `__call_server_method__`,
+            'webkit.callable': `__wrapped_callable__`,
+		}),
+        babel({
+            presets: ['@babel/preset-env', '@babel/preset-react'],
+            babelHelpers: 'bundled',
+        })
+	]
+	
+    props.bTersePlugin && pluginList.push(terser())
+	return pluginList
+}
+
+const GetFrontEndDirectory = () => {
+    const pluginJsonPath = './plugin.json';
+    try {
+        return JSON.parse(fs.readFileSync(pluginJsonPath, 'utf8'))?.frontend ?? "frontend";
+    } 
+    catch (error) {
+        return "frontend";
+    }
+}
+
+export const TranspilerPluginComponent = async (props: TranspilerProps) => {
+    
+    const frontendRollupConfig: RollupOptions = {
+        input: `./${GetFrontEndDirectory()}/index.tsx`,
+        plugins: GetPluginComponents(props),
+        context: 'window',
+        external: (id) => { 
+            if (id === '@steambrew/webkit') {
+                Logger.Error('The @steambrew/webkit module should not be included in the frontend module, use @steambrew/client instead. Please remove it from the frontend module and try again.')
+                process.exit(1)
+            }
+
+            return id === '@steambrew/client' || id === 'react' || id === 'react-dom'
+        },
+        output: {
+            name: "millennium_main",
+            file: ".millennium/Dist/index.js",
+            globals: {
+                "react"            : "window.SP_REACT",
+                "react-dom"        : "window.SP_REACTDOM",
+                "@steambrew/client": "window.MILLENNIUM_API"
+            },
+            exports: 'named',
+            format: 'iife'
+        }
+    }
+
+    Logger.Info("Starting build; this may take a few moments...")
+
+    try {
+        await (await rollup(frontendRollupConfig)).write(frontendRollupConfig.output as OutputOptions);
+
+        if (fs.existsSync(`./webkit/index.tsx`)) {
+            Logger.Info("Compiling webkit module...")
+            
+            const webkitRollupConfig: RollupOptions = {
+                input: `./webkit/index.tsx`,
+                plugins: GetWebkitPluginComponents(props),
+                context: 'window',
+                external: (id) => {
+                    if (id === '@steambrew/client') {
+                    Logger.Error('The @steambrew/client module should not be included in the webkit module, use @steambrew/webkit instead. Please remove it from the webkit module and try again.')
+                    process.exit(1)
+                    }
+
+                    return id === '@steambrew/webkit'
+                },
+                output: {
+                    name: "millennium_main",
+                    file: ".millennium/Dist/webkit.js",
+                    exports: 'named',
+                    format: 'iife',
+                    globals: {
+                        "@steambrew/webkit": "window.MILLENNIUM_API"
+                    },
+                }
+            }
+
+            await (await rollup(webkitRollupConfig)).write(webkitRollupConfig.output as OutputOptions);
+        }
+        
+        Logger.Info('Build succeeded!', Number((performance.now() - global.PerfStartTime).toFixed(3)), 'ms elapsed.')
+    }
+    catch (exception) {
+        Logger.Error('Build failed!', exception)
+        process.exit(1)
+    }
 }

package/Linter.ts

@@ -1,44 +1,44 @@
-import chalk from 'chalk'
-import path from 'path'
-import { existsSync, readFile } from 'fs'
-
-export const ValidatePlugin = (target: string): Promise<any> => {
-
-    return new Promise<any>((resolve, reject) => {
-        if (!existsSync(target)) {
-            console.error(chalk.red.bold(`\n[-] --target [${target}] `) + chalk.red("is not a valid system path"))
-            reject() 
-            return
-        }
-        
-        const pluginModule = path.join(target, "plugin.json")
-        
-        if (!existsSync(pluginModule)) {
-            console.error(chalk.red.bold(`\n[-] --target [${target}] `) + chalk.red("is not a valid plugin (missing plugin.json)"))
-            reject()
-            return
-        }
-        
-        readFile(pluginModule, 'utf8', (err, data) => {
-            if (err) {
-                console.error(chalk.red.bold(`\n[-] couldn't read plugin.json from [${pluginModule}]`))
-                reject()
-                return
-            }
-        
-            try {
-                if (!("name" in JSON.parse(data))) {
-                    console.error(chalk.red.bold(`\n[-] target plugin doesn't contain "name" in plugin.json [${pluginModule}]`))
-                    reject()
-                }
-                else {
-                    resolve(JSON.parse(data)) 
-                }
-            } 
-            catch (parseError) {
-                console.error(chalk.red.bold(`\n[-] couldn't parse JSON in plugin.json from [${pluginModule}]`))
-                reject()
-            }
-        });
-    })
+import chalk from 'chalk'
+import path from 'path'
+import { existsSync, readFile } from 'fs'
+
+export const ValidatePlugin = (target: string): Promise<any> => {
+
+    return new Promise<any>((resolve, reject) => {
+        if (!existsSync(target)) {
+            console.error(chalk.red.bold(`\n[-] --target [${target}] `) + chalk.red("is not a valid system path"))
+            reject() 
+            return
+        }
+        
+        const pluginModule = path.join(target, "plugin.json")
+        
+        if (!existsSync(pluginModule)) {
+            console.error(chalk.red.bold(`\n[-] --target [${target}] `) + chalk.red("is not a valid plugin (missing plugin.json)"))
+            reject()
+            return
+        }
+        
+        readFile(pluginModule, 'utf8', (err, data) => {
+            if (err) {
+                console.error(chalk.red.bold(`\n[-] couldn't read plugin.json from [${pluginModule}]`))
+                reject()
+                return
+            }
+        
+            try {
+                if (!("name" in JSON.parse(data))) {
+                    console.error(chalk.red.bold(`\n[-] target plugin doesn't contain "name" in plugin.json [${pluginModule}]`))
+                    reject()
+                }
+                else {
+                    resolve(JSON.parse(data)) 
+                }
+            } 
+            catch (parseError) {
+                console.error(chalk.red.bold(`\n[-] couldn't parse JSON in plugin.json from [${pluginModule}]`))
+                reject()
+            }
+        });
+    })
 }

package/Logger.ts

@@ -1,49 +1,49 @@
-import chalk from 'chalk'
-
-const Logger = {
-
-    Info: (...LogMessage: any) => {
-        console.log(chalk.magenta.bold("++"), ...LogMessage)
-    },
-
-    Warn: (...LogMessage: any) => {
-        console.log(chalk.yellow.bold("**"), ...LogMessage)
-    },
-
-    Error: (...LogMessage: any) => {
-        console.log(chalk.red.bold("!!"), ...LogMessage)
-    },
-
-    Tree: (strTitle: string, LogObject: any) => { 
-
-        console.log(chalk.magenta.bold("++"), strTitle);
-
-        const isLocalPath = (strTestPath: string): boolean => {
-            // Regular expression to match common file path patterns
-            const filePathRegex = /^(\/|\.\/|\.\.\/|\w:\/)?([\w-.]+\/)*[\w-.]+\.\w+$/;
-            return filePathRegex.test(strTestPath);
-        }
-
-        const entries = Object.entries(LogObject);
-        const totalEntries = entries.length;
-
-        for (const [index, [key, value]] of entries.entries()) {
-
-            const connector = index === totalEntries - 1 ? "    " : "    "
-            let color = chalk.white
-
-            switch (typeof value) {
-                case typeof String(): {
-                    color = isLocalPath(value as string) ? chalk.blueBright : chalk.white; 
-                    break
-                }
-                case typeof Boolean(): color = chalk.green; break
-                case typeof Number(): color = chalk.yellow; break
-            }
-
-            console.log(chalk.magenta.bold(` ${connector}──${key}:`), color(value))
-        }
-    }
-}
-
+import chalk from 'chalk'
+
+const Logger = {
+
+    Info: (...LogMessage: any) => {
+        console.log(chalk.magenta.bold("++"), ...LogMessage)
+    },
+
+    Warn: (...LogMessage: any) => {
+        console.log(chalk.yellow.bold("**"), ...LogMessage)
+    },
+
+    Error: (...LogMessage: any) => {
+        console.error(chalk.red.bold("!!"), ...LogMessage)
+    },
+
+    Tree: (strTitle: string, LogObject: any) => { 
+
+        console.log(chalk.magenta.bold("++"), strTitle);
+
+        const isLocalPath = (strTestPath: string): boolean => {
+            // Regular expression to match common file path patterns
+            const filePathRegex = /^(\/|\.\/|\.\.\/|\w:\/)?([\w-.]+\/)*[\w-.]+\.\w+$/;
+            return filePathRegex.test(strTestPath);
+        }
+
+        const entries = Object.entries(LogObject);
+        const totalEntries = entries.length;
+
+        for (const [index, [key, value]] of entries.entries()) {
+
+            const connector = index === totalEntries - 1 ? "    " : "    "
+            let color = chalk.white
+
+            switch (typeof value) {
+                case typeof String(): {
+                    color = isLocalPath(value as string) ? chalk.blueBright : chalk.white; 
+                    break
+                }
+                case typeof Boolean(): color = chalk.green; break
+                case typeof Number(): color = chalk.yellow; break
+            }
+
+            console.log(chalk.magenta.bold(` ${connector}──${key}:`), color(value))
+        }
+    }
+}
+
 export { Logger }

package/Parameters.ts

@@ -1,72 +1,72 @@
-import chalk from 'chalk'
-import { Logger } from "./Logger"
-
-/***
- * @brief print the parameter list to the stdout
- */
-export const PrintParamHelp = () => {
-
-    console.log(
-        "millennium-ttc parameter list:" +
-        "\n\t" + chalk.magenta("--help") + ": display parameter list" +
-        "\n\t" + chalk.bold.red("--build") + ": " + chalk.bold.red("(required)") + ": build type [dev, prod] (prod minifies code)" +
-        "\n\t" + chalk.magenta("--target") + ": path to plugin, default to cwd"
-    );
-}
-
-export enum BuildType {
-    DevBuild, ProdBuild
-}
-
-export interface ParameterProps {
-    type: BuildType, 
-    targetPlugin: string // path
-}
-
-export const ValidateParameters = (args: Array<string>): ParameterProps => {
-
-    let typeProp: BuildType = BuildType.DevBuild, targetProp: string = process.cwd()
-
-    if (args.includes("--help")) {
-        PrintParamHelp()
-        process.exit();
-    }
-    
-    // startup args are invalid
-    if (!args.includes("--build")) {
-        Logger.Error("Received invalid arguments...");
-        PrintParamHelp();
-        process.exit();
-    }
-    
-    for (let i = 0; i < args.length; i++) 
-    {
-        if (args[i] === "--build") 
-        {
-            const BuildMode: string = args[i + 1]
-
-            switch (BuildMode) {
-                case "dev": typeProp = BuildType.DevBuild; break
-                case "prod": typeProp = BuildType.ProdBuild; break
-                default: {
-                    Logger.Error('--build parameter must be preceded by build type [dev, prod]');
-                    process.exit();
-                }
-            }
-        }
-    
-        if (args[i] == "--target") {
-            if (args[i + 1] === undefined) {
-                Logger.Error('--target parameter must be preceded by system path');
-                process.exit();
-            }
-
-            targetProp = args[i + 1]
-        }
-    }
-
-    return {
-        type: typeProp,
-        targetPlugin: targetProp
-    }
+import chalk from 'chalk'
+import { Logger } from "./Logger"
+
+/***
+ * @brief print the parameter list to the stdout
+ */
+export const PrintParamHelp = () => {
+
+    console.log(
+        "millennium-ttc parameter list:" +
+        "\n\t" + chalk.magenta("--help") + ": display parameter list" +
+        "\n\t" + chalk.bold.red("--build") + ": " + chalk.bold.red("(required)") + ": build type [dev, prod] (prod minifies code)" +
+        "\n\t" + chalk.magenta("--target") + ": path to plugin, default to cwd"
+    );
+}
+
+export enum BuildType {
+    DevBuild, ProdBuild
+}
+
+export interface ParameterProps {
+    type: BuildType, 
+    targetPlugin: string // path
+}
+
+export const ValidateParameters = (args: Array<string>): ParameterProps => {
+
+    let typeProp: BuildType = BuildType.DevBuild, targetProp: string = process.cwd()
+
+    if (args.includes("--help")) {
+        PrintParamHelp()
+        process.exit();
+    }
+    
+    // startup args are invalid
+    if (!args.includes("--build")) {
+        Logger.Error("Received invalid arguments...");
+        PrintParamHelp();
+        process.exit();
+    }
+    
+    for (let i = 0; i < args.length; i++) 
+    {
+        if (args[i] === "--build") 
+        {
+            const BuildMode: string = args[i + 1]
+
+            switch (BuildMode) {
+                case "dev": typeProp = BuildType.DevBuild; break
+                case "prod": typeProp = BuildType.ProdBuild; break
+                default: {
+                    Logger.Error('--build parameter must be preceded by build type [dev, prod]');
+                    process.exit();
+                }
+            }
+        }
+    
+        if (args[i] == "--target") {
+            if (args[i + 1] === undefined) {
+                Logger.Error('--target parameter must be preceded by system path');
+                process.exit();
+            }
+
+            targetProp = args[i + 1]
+        }
+    }
+
+    return {
+        type: typeProp,
+        targetPlugin: targetProp
+    }
 }

package/VersionMon.ts

@@ -1,28 +1,28 @@
-import path from 'path';
-import { fileURLToPath } from 'url';
-import { readFile } from 'fs/promises';
-import { dirname } from 'path';
-import { Logger } from './Logger';
-
-export const CheckForUpdates = async (): Promise<boolean> => {
-    return new Promise<boolean>(async (resolve) => {
-        const packageJsonPath = path.resolve(dirname(fileURLToPath(import.meta.url)), '../package.json');
-        const packageJson = JSON.parse(await readFile(packageJsonPath, 'utf8'));
-    
-        fetch("https://registry.npmjs.org/@steambrew/ttc").then(response => response.json()).then(json => {
-
-            if (json?.["dist-tags"]?.latest != packageJson.version) {
-  
-                Logger.Tree(`@steambrew/ttc@${packageJson.version} requires update to ${json?.["dist-tags"]?.latest}`, {
-                    cmd: `run "npm install @steambrew/ttc@${json?.["dist-tags"]?.latest}" to get latest updates!`
-                })
-
-                resolve(true)
-            }
-            else {
-                Logger.Info(`@steambrew/ttc@${packageJson.version} is up-to-date!`)
-                resolve(false)
-            }
-        })
-    })
+import path from 'path';
+import { fileURLToPath } from 'url';
+import { readFile } from 'fs/promises';
+import { dirname } from 'path';
+import { Logger } from './Logger';
+
+export const CheckForUpdates = async (): Promise<boolean> => {
+    return new Promise<boolean>(async (resolve) => {
+        const packageJsonPath = path.resolve(dirname(fileURLToPath(import.meta.url)), '../package.json');
+        const packageJson = JSON.parse(await readFile(packageJsonPath, 'utf8'));
+    
+        fetch("https://registry.npmjs.org/@steambrew/ttc").then(response => response.json()).then(json => {
+
+            if (json?.["dist-tags"]?.latest != packageJson.version) {
+  
+                Logger.Tree(`@steambrew/ttc@${packageJson.version} requires update to ${json?.["dist-tags"]?.latest}`, {
+                    cmd: `run "npm install @steambrew/ttc@${json?.["dist-tags"]?.latest}" to get latest updates!`
+                })
+
+                resolve(true)
+            }
+            else {
+                Logger.Info(`@steambrew/ttc@${packageJson.version} is up-to-date!`)
+                resolve(false)
+            }
+        })
+    })
 }

package/dist/index.js

@@ -9,9 +9,11 @@ import json from '@rollup/plugin-json';
 import commonjs from '@rollup/plugin-commonjs';
 import replace from '@rollup/plugin-replace';
 import typescript from '@rollup/plugin-typescript';
-import { nodeResolve } from '@rollup/plugin-node-resolve';
+import resolve from '@rollup/plugin-node-resolve';
 import terser from '@rollup/plugin-terser';
 import babel from '@rollup/plugin-babel';
+import injectProcessEnv from 'rollup-plugin-inject-process-env';
+import dotenv from 'dotenv';
 import { performance as performance$1 } from 'perf_hooks';
 
 const Logger = {
@@ -22,7 +24,7 @@ const Logger = {
         console.log(chalk.yellow.bold("**"), ...LogMessage);
     },
     Error: (...LogMessage) => {
-        console.log(chalk.red.bold("!!"), ...LogMessage);
+        console.error(chalk.red.bold("!!"), ...LogMessage);
     },
     Tree: (strTitle, LogObject) => {
         console.log(chalk.magenta.bold("++"), strTitle);
@@ -164,6 +166,14 @@ const ValidatePlugin = (target) => {
     });
 };
 
+const envConfig = dotenv.config().parsed || {};
+if (envConfig) {
+    Logger.Info("Injecting environment variables...");
+}
+const envVars = Object.keys(envConfig).reduce((acc, key) => {
+    acc[`process.env.${key}`] = JSON.stringify(envConfig[key]);
+    return acc;
+}, {});
 const WrappedCallServerMethod = "const __call_server_method__ = (methodName, kwargs) => Millennium.callServerMethod(pluginName, methodName, kwargs)";
 const WrappedCallable = "const __wrapped_callable__ = (route) => MILLENNIUM_API.callable(__call_server_method__, route)";
 /**
@@ -236,12 +246,17 @@ function InsertWebkitMillennium(props) {
     return { name: String(), generateBundle };
 }
 function GetPluginComponents(props) {
+    let tsConfigPath = `./${GetFrontEndDirectory()}/tsconfig.json`;
+    if (!fs.existsSync(tsConfigPath)) {
+        tsConfigPath = './tsconfig.json';
+    }
     const pluginList = [
         InsertMillennium(props),
         typescript({
-            tsconfig: `./${GetFrontEndDirectory()}/tsconfig.json`
+            tsconfig: tsConfigPath
         }),
-        nodeResolve(), commonjs(), json(),
+        resolve(), commonjs(), json(),
+        injectProcessEnv(envVars),
         replace({
             delimiters: ['', ''],
             preventAssignment: true,
@@ -263,7 +278,8 @@ function GetWebkitPluginComponents(props) {
         typescript({
             tsconfig: './webkit/tsconfig.json'
         }),
-        nodeResolve(), commonjs(), json(),
+        resolve(), commonjs(), json(),
+        injectProcessEnv(envVars),
         replace({
             delimiters: ['', ''],
             preventAssignment: true,
@@ -311,38 +327,39 @@ const TranspilerPluginComponent = async (props) => {
             format: 'iife'
         }
     };
-    const webkitRollupConfig = {
-        input: `./webkit/index.tsx`,
-        plugins: GetWebkitPluginComponents(props),
-        context: 'window',
-        external: (id) => {
-            if (id === '@steambrew/client') {
-                Logger.Error('The @steambrew/client module should not be included in the webkit module, use @steambrew/webkit instead. Please remove it from the webkit module and try again.');
-                process.exit(1);
-            }
-            return id === '@steambrew/webkit';
-        },
-        output: {
-            name: "millennium_main",
-            file: ".millennium/Dist/webkit.js",
-            exports: 'named',
-            format: 'iife',
-            globals: {
-                "@steambrew/webkit": "window.MILLENNIUM_API"
-            },
-        }
-    };
     Logger.Info("Starting build; this may take a few moments...");
     try {
         await (await rollup(frontendRollupConfig)).write(frontendRollupConfig.output);
         if (fs.existsSync(`./webkit/index.tsx`)) {
             Logger.Info("Compiling webkit module...");
+            const webkitRollupConfig = {
+                input: `./webkit/index.tsx`,
+                plugins: GetWebkitPluginComponents(props),
+                context: 'window',
+                external: (id) => {
+                    if (id === '@steambrew/client') {
+                        Logger.Error('The @steambrew/client module should not be included in the webkit module, use @steambrew/webkit instead. Please remove it from the webkit module and try again.');
+                        process.exit(1);
+                    }
+                    return id === '@steambrew/webkit';
+                },
+                output: {
+                    name: "millennium_main",
+                    file: ".millennium/Dist/webkit.js",
+                    exports: 'named',
+                    format: 'iife',
+                    globals: {
+                        "@steambrew/webkit": "window.MILLENNIUM_API"
+                    },
+                }
+            };
             await (await rollup(webkitRollupConfig)).write(webkitRollupConfig.output);
         }
         Logger.Info('Build succeeded!', Number((performance.now() - global.PerfStartTime).toFixed(3)), 'ms elapsed.');
     }
     catch (exception) {
         Logger.Error('Build failed!', exception);
+        process.exit(1);
     }
 };
 
@@ -357,11 +374,11 @@ const CheckModuleUpdates = async () => {
 const StartCompilerModule = () => {
     const parameters = ValidateParameters(process.argv.slice(2));
     const bTersePlugin = parameters.type == BuildType.ProdBuild;
-    // Logger.Tree("Transpiler config: ", {
-    //     target: parameters.targetPlugin,
-    //     build: BuildType[parameters.type],
-    //     minify: bTersePlugin
-    // })
+    Logger.Tree("Transpiler config: ", {
+        target: parameters.targetPlugin,
+        build: BuildType[parameters.type],
+        minify: bTersePlugin
+    });
     ValidatePlugin(parameters.targetPlugin).then((json) => {
         const props = {
             bTersePlugin: bTersePlugin,

package/index.ts

@@ -1,66 +1,67 @@
-#!/usr/bin/env node
-
-/**
- * this component serves as:
- * - typescript transpiler
- * - rollup configurator
- */
-import { BuildType, ValidateParameters } from "./Parameters"
-import { CheckForUpdates } from "./VersionMon"
-import { ValidatePlugin } from './Linter'
-import { TranspilerPluginComponent, TranspilerProps } from './Compiler'
-import { performance } from 'perf_hooks';
-// import { Logger } from './Logger'
-
-declare global {
-    var PerfStartTime: number;
-}
-
-const CheckModuleUpdates = async () => {
-    return await CheckForUpdates()
-}
-
-const StartCompilerModule = () => {
-
-    const parameters   = ValidateParameters( process.argv.slice(2) );
-    const bTersePlugin = parameters.type == BuildType.ProdBuild
-
-    // Logger.Tree("Transpiler config: ", {
-    //     target: parameters.targetPlugin,
-    //     build: BuildType[parameters.type],
-    //     minify: bTersePlugin
-    // })
-
-    ValidatePlugin(parameters.targetPlugin).then((json: any) => {
-
-        const props: TranspilerProps = {
-            bTersePlugin: bTersePlugin,
-            strPluginInternalName: json?.name
-        }
-
-        TranspilerPluginComponent(props)
-    })
-
-    /**
-     * plugin is invalid, we close the proccess as it has already been handled
-     */
-    .catch(() => {
-        process.exit()
-    }) 
-}
-
-const Initialize = () => {
-    global.PerfStartTime = performance.now();
-
-    // Check for --no-update flag
-    if (process.argv.includes("--no-update")) {
-        StartCompilerModule()
-        return
-    }
-
-    CheckModuleUpdates().then((needsUpdate: boolean) => {
-        needsUpdate ? process.exit() : StartCompilerModule()
-    })
-}
-
+#!/usr/bin/env node
+
+/**
+ * this component serves as:
+ * - typescript transpiler
+ * - rollup configurator
+ */
+import { BuildType, ValidateParameters } from "./Parameters"
+import { CheckForUpdates } from "./VersionMon"
+import { ValidatePlugin } from './Linter'
+import { TranspilerPluginComponent, TranspilerProps } from './Compiler'
+import { performance } from 'perf_hooks';
+import { Logger } from "./Logger";
+// import { Logger } from './Logger'
+
+declare global {
+    var PerfStartTime: number;
+}
+
+const CheckModuleUpdates = async () => {
+    return await CheckForUpdates()
+}
+
+const StartCompilerModule = () => {
+
+    const parameters   = ValidateParameters( process.argv.slice(2) );
+    const bTersePlugin = parameters.type == BuildType.ProdBuild
+
+    Logger.Tree("Transpiler config: ", {
+        target: parameters.targetPlugin,
+        build: BuildType[parameters.type],
+        minify: bTersePlugin
+    })
+
+    ValidatePlugin(parameters.targetPlugin).then((json: any) => {
+
+        const props: TranspilerProps = {
+            bTersePlugin: bTersePlugin,
+            strPluginInternalName: json?.name
+        }
+
+        TranspilerPluginComponent(props)
+    })
+
+    /**
+     * plugin is invalid, we close the proccess as it has already been handled
+     */
+    .catch(() => {
+        process.exit()
+    }) 
+}
+
+const Initialize = () => {
+    global.PerfStartTime = performance.now();
+
+    // Check for --no-update flag
+    if (process.argv.includes("--no-update")) {
+        StartCompilerModule()
+        return
+    }
+
+    CheckModuleUpdates().then((needsUpdate: boolean) => {
+        needsUpdate ? process.exit() : StartCompilerModule()
+    })
+}
+
 Initialize();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@steambrew/ttc",
-  "version": "1.0.4",
+  "version": "1.1.0",
   "type": "module",
   "main": "dist/index.js",
   "module": "dist/index.js",
@@ -18,21 +18,23 @@
   "license": "ISC",
   "description": "A tiny typescript compiler for Millennium plugins.",
   "dependencies": {
+    "@babel/preset-env": "^7.26.0",
+    "@babel/preset-react": "^7.25.9",
+    "@rollup/plugin-babel": "^6.0.4",
     "@rollup/plugin-commonjs": "^28.0.1",
     "@rollup/plugin-json": "^6.1.0",
     "@rollup/plugin-node-resolve": "^15.3.0",
     "@rollup/plugin-replace": "^6.0.1",
     "@rollup/plugin-terser": "^0.4.4",
     "@rollup/plugin-typescript": "^12.1.1",
-    "@rollup/plugin-babel": "^6.0.4",
-    "@babel/preset-react": "^7.25.9",
-    "@babel/preset-env": "^7.26.0",
-    "rollup": "^4.28.0",
     "chalk": "^5.3.0",
+    "dotenv": "^16.4.7",
     "fs": "^0.0.1-security",
+    "rollup": "^4.28.0",
+    "rollup-plugin-inject-process-env": "^1.3.1",
     "tslib": "^2.8.1"
   },
   "devDependencies": {
     "@types/node": "^22.10.1"
   }
-}
+}

package/rollup.config.js

@@ -1,29 +1,31 @@
-import commonjs from '@rollup/plugin-commonjs';
-import typescript from '@rollup/plugin-typescript';
-import json from '@rollup/plugin-json';
-
-export default {
-  input: 'index.ts',
-  context: 'window',
-  output: {
-    file: 'dist/index.js'
-  },
-  plugins: [commonjs(), typescript(), json()],
-  external: [
-    "chalk", 
-    "path", 
-    "url", 
-    "fs/promises", 
-    "fs", 
-    "rollup", 
-    "@rollup/plugin-json", 
-    "@rollup/plugin-commonjs", 
-    "@rollup/plugin-replace", 
-    "@rollup/plugin-typescript", 
-    "@rollup/plugin-node-resolve",
-    "rollup-plugin-import-css",
-    "@rollup/plugin-terser",
-    "@rollup/plugin-babel",
-    "perf_hooks",
-  ]
+import commonjs from '@rollup/plugin-commonjs';
+import typescript from '@rollup/plugin-typescript';
+import json from '@rollup/plugin-json';
+
+export default {
+  input: 'index.ts',
+  context: 'window',
+  output: {
+    file: 'dist/index.js'
+  },
+  plugins: [commonjs(), typescript(), json()],
+  external: [
+    "chalk", 
+    "path", 
+    "url", 
+    "fs/promises", 
+    "fs", 
+    "rollup", 
+    "@rollup/plugin-json", 
+    "@rollup/plugin-commonjs", 
+    "@rollup/plugin-replace", 
+    "@rollup/plugin-typescript", 
+    "@rollup/plugin-node-resolve",
+    "rollup-plugin-import-css",
+    "@rollup/plugin-terser",
+    "@rollup/plugin-babel",
+    "rollup-plugin-inject-process-env",
+    "dotenv",
+    "perf_hooks",
+  ]
 };

package/tsconfig.json

@@ -1,24 +1,24 @@
-{
-    "compilerOptions": {
-      "outDir": "dist",
-      "module": "ESNext",
-      "target": "ES2020",
-      "jsx": "react",
-      "jsxFactory": "window.SP_REACT.createElement",
-      "declaration": false,
-      "moduleResolution": "node",
-      "noUnusedLocals": true,
-      "noUnusedParameters": true,
-      "esModuleInterop": true,
-      "noImplicitReturns": true,
-      "noImplicitThis": true,
-      "noImplicitAny": true,
-      "strict": true,
-      "ignoreDeprecations": "5.0",
-      "allowSyntheticDefaultImports": true,
-      "skipLibCheck": true
-    },
-    "include": ["./"],
-    "exclude": ["node_modules"]
-}
+{
+    "compilerOptions": {
+      "outDir": "dist",
+      "module": "ESNext",
+      "target": "ES2020",
+      "jsx": "react",
+      "jsxFactory": "window.SP_REACT.createElement",
+      "declaration": false,
+      "moduleResolution": "node",
+      "noUnusedLocals": true,
+      "noUnusedParameters": true,
+      "esModuleInterop": true,
+      "noImplicitReturns": true,
+      "noImplicitThis": true,
+      "noImplicitAny": true,
+      "strict": true,
+      "ignoreDeprecations": "5.0",
+      "allowSyntheticDefaultImports": true,
+      "skipLibCheck": true
+    },
+    "include": ["./"],
+    "exclude": ["node_modules"]
+}