qcobjects-cli 2.5.143-beta → 2.5.144-beta

package/src/cli-commands-build-esbuild.ts

@@ -0,0 +1,375 @@
+/**
+ * QCObjects CLI 2.5
+ * ________________
+ *
+ * Author: Jean Machuca <correojean@gmail.com>
+ *
+ * Cross Browser Javascript Framework for MVC Patterns
+ * QuickCorp/QCObjects is licensed under the
+ * GNU Lesser General Public License v3.0
+ * [LICENSE] (https://github.com/QuickCorp/QCObjects/blob/master/LICENSE.txt)
+ *
+ * Permissions of this copyleft license are conditioned on making available
+ * complete source code of licensed works and modifications under the same
+ * license or the GNU GPLv3. Copyright and license notices must be preserved.
+ * Contributors provide an express grant of patent rights. However, a larger
+ * work using the licensed work through interfaces provided by the licensed
+ * work may be distributed under different terms and without source code for
+ * the larger work.
+ *
+ * Copyright (C) 2015 Jean Machuca,<correojean@gmail.com>
+ *
+ * Everyone is permitted to copy and distribute verbatim copies of this
+ * license document, but changing it is not allowed.
+*/
+/*eslint no-unused-vars: "off"*/
+/*eslint no-redeclare: "off"*/
+/*eslint no-empty: "off"*/
+/*eslint strict: "off"*/
+/*eslint no-mixed-operators: "off"*/
+/*eslint no-undef: "off"*/
+"use strict";
+import path from "node:path";
+import { readFileSync, writeFileSync } from "node:fs";
+import fs from "node:fs/promises";
+import glob from "glob";
+import esbuild, { BuildOptions, Format } from "esbuild";
+import alias from "esbuild-plugin-alias";
+import { Package, InheritClass, logger } from "qcobjects";
+
+const externalPackages = [
+  "node:fs", "node:path", "node:os", "node:util", "node:events", 
+  "node:stream", "node:http", "node:https", "node:crypto", "node:zlib", 
+  "node:buffer", "node:url", "node:querystring", "node:child_process", 
+  "node:cluster", "node:dgram", "node:dns", "node:net", "node:readline", 
+  "node:repl", "node:tls", "node:tty", "node:vm", "node:worker_threads"
+];
+
+// Function to detect and add the extension
+const nameToExtension = (name: string, ext: string, settings: BuildOptions): string => {
+  function isPackage(name: string): boolean {
+    return !name.startsWith(".") && !name.startsWith("/") && !name.includes("/");
+  }
+
+  const hasExtension = /\.[^/\\]+$/.test(name);
+  const isExternalPackage = name.startsWith("qcobjects") || 
+                          name.startsWith("qcobjects-sdk") ||
+                          name.startsWith("node:") ||
+                          name.startsWith("fs") ||
+                          name.startsWith("path") ||
+                          name.startsWith("os") ||
+                          name.startsWith("util") ||
+                          name.startsWith("events") ||
+                          name.startsWith("stream") ||
+                          name.startsWith("http") ||
+                          name.startsWith("https") ||
+                          name.startsWith("crypto") ||
+                          name.startsWith("zlib") ||
+                          name.startsWith("buffer") ||
+                          name.startsWith("url") ||
+                          name.startsWith("querystring") ||
+                          name.startsWith("child_process") ||
+                          name.startsWith("cluster") ||
+                          name.startsWith("dgram") ||
+                          name.startsWith("dns") ||
+                          name.startsWith("net") ||
+                          name.startsWith("readline") ||
+                          name.startsWith("repl") ||
+                          name.startsWith("tls") ||
+                          name.startsWith("tty") ||
+                          name.startsWith("vm") ||
+                          name.startsWith("worker_threads")
+                          || externalPackages.includes(name);
+  
+  if (!hasExtension && !isPackage(name) && !isExternalPackage) {
+    name += ext;
+  }
+
+  return name;
+};
+
+// Function to add .cjs and .mjs extensions to import/export/require statements
+const addExtensions = (filePath: string, toExt: string, settings: BuildOptions): void => {
+  const content = readFileSync(filePath, "utf8");
+  const updatedContent = content
+    .replace(/(from\s+['"])(.*?)(['"])/g, (match, p1, p2, p3) => {
+      return `${p1}${nameToExtension(p2, toExt, settings)}${p3}`;
+    })
+    .replace(/(import\s+['"])(.*?)(['"])/g, (match, p1, p2, p3) => {
+      return `${p1}${nameToExtension(p2, toExt, settings)}${p3}`;
+    })
+    .replace(/(export\s+['"])(.*?)(['"])/g, (match, p1, p2, p3) => {
+      return `${p1}${nameToExtension(p2, toExt, settings)}${p3}`;
+    })
+    .replace(/(require\s*\(\s*['"])(.*?)(['"]\s*\))/g, (match, p1, p2, p3) => {
+      return `${p1}${nameToExtension(p2, toExt, settings)}${p3}`;
+    });
+  writeFileSync(filePath, updatedContent, "utf8");
+};
+
+const copyDir = async (source: string, dest: string, exclude: string[]): Promise<void> => {
+  source = path.resolve(source);
+  dest = path.resolve(dest);
+  const dname = path.basename(source);
+  const dirExcluded = exclude.includes(dname);
+
+  const isDir = async (d: string): Promise<boolean> => {
+    try {
+      const stat = await fs.stat(d);
+      return stat.isDirectory();
+    } catch {
+      return false;
+    }
+  };
+
+  const isFile = async (d: string): Promise<boolean> => {
+    try {
+      const stat = await fs.stat(d);
+      return stat.isFile();
+    } catch {
+      return false;
+    }
+  };
+
+  if (await isDir(source) && !dirExcluded) {
+    await fs.mkdir(dest, { recursive: true });
+    const paths = await fs.readdir(source, { withFileTypes: true });
+    const dirs = paths.filter(d => d.isDirectory());
+    const files = paths.filter(f => f.isFile());
+
+    for (const f of files) {
+      const sourceFile = path.resolve(source, f.name);
+      const destFile = path.resolve(dest, f.name);
+      const fileExcluded = exclude.includes(f.name);
+      if (await isFile(sourceFile) && !fileExcluded) {
+        logger.debug(`[build:esbuild] Copying files from ${sourceFile} to ${destFile} excluding ${exclude}...`);
+        await fs.copyFile(sourceFile, destFile);
+        logger.debug(`[build:esbuild] Copying files from ${sourceFile} to ${destFile} excluding ${exclude}...DONE!`);
+      }
+    }
+
+    for (const d of dirs) {
+      const sourceDir = path.resolve(source, d.name);
+      const destDir = path.resolve(dest, d.name);
+      await copyDir(sourceDir, destDir, exclude);
+    }
+  }
+};
+
+const ignorePlugin = {
+  name: "transform-qcobjects-imports",
+  setup(build: any) {
+    build.onResolve({ filter: /^(qcobjects|qcobjects-sdk)$/ }, (args: any) => {
+      if (args.kind === "dynamic-import") {
+        return { 
+          path: args.path,
+          namespace: "qcobjects-transform"
+        };
+      }
+      return {
+        external: true,
+        path: args.path
+      };
+    });
+
+    build.onResolve({ filter: /.*/, namespace: "file" }, (args: any) => {
+      if (args.kind === "dynamic-import") {
+        return {
+          external: true,
+          path: args.path
+        };
+      }
+      return null;
+    });
+
+    build.onLoad({ filter: /.*/, namespace: "qcobjects-transform" }, (args: any) => {
+      return {
+        contents: `
+          module.exports = __toESM(require("${args.path}"), true);
+        `,
+        loader: "js"
+      };
+    });
+  }
+};
+
+export class CommandHandler extends InheritClass {
+  choiceOption: {
+    [x: string]: any;
+    build_esbuild: () => Promise<void>;
+  };
+
+  constructor({
+    switchCommander
+  }: { switchCommander: any }) {
+    super({ switchCommander });
+    this.choiceOption = {
+      async build_esbuild() {
+        try {
+          logger.info("[build:esbuild] Starting esbuild process...");
+
+          // Get all TypeScript entry points
+          const entryPoints = glob.sync("src/**/*.ts");
+
+          // Copy templates
+          await copyDir("./src/templates", "./build/templates", []);
+          await copyDir("./src/templates", "./public/cjs/templates", []);
+          await copyDir("./src/templates", "./public/esm/templates", []);
+          await copyDir("./src/templates", "./public/browser/templates", []);
+
+          const baseSettings: BuildOptions = {
+            entryPoints,
+            bundle: false,
+            outdir: "public/cjs",
+            format: "cjs" as Format,    
+            target: ["node22"],
+            tsconfig: "tsconfig.json",
+            globalName: "global",
+            minify: false,
+            keepNames: true,
+            sourcemap: true,
+            splitting: false,
+            chunkNames: "chunks/[name]-[hash]",
+            plugins: [
+              ignorePlugin,
+              alias({
+                "types": path.join(process.cwd(), "src/types/global/index.d.ts")
+              })
+            ]
+          };
+
+          const cjsSettings: BuildOptions = {
+            ...baseSettings,
+            outdir: "public/cjs",
+            format: "cjs" as Format,
+            platform: "node",
+            outExtension: {
+              ".js": ".cjs"
+            },
+            plugins: [
+              ignorePlugin,
+              {
+                name: "transform-dynamic-imports",
+                setup(build: any) {
+                  build.onEnd(() => {
+                    const files = glob.sync("public/cjs/**/*.cjs");
+                    for (const file of files) {
+                      let content = readFileSync(file, "utf8");
+                      content = content.replace(
+                        /await\s+import\(['"]([^'"]+)['"]\)/g,
+                        "__toESM(require(\"$1\"), true)"
+                      );
+                      writeFileSync(file, content, "utf8");
+                    }
+                  });
+                }
+              },
+              {
+                name: "add-extensions",
+                setup(build: any) {
+                  build.onEnd(() => {
+                    entryPoints.forEach((entry: string) => {
+                      const outputFilePath = path.join("./public/cjs", entry.replace("src/", "").replace(".ts", ".cjs"));
+                      addExtensions(outputFilePath, ".cjs", cjsSettings);
+                    });
+                  });
+                }
+              }
+            ]
+          };
+
+          const esmSettings: BuildOptions = {
+            ...baseSettings,
+            outdir: "public/esm",
+            format: "esm" as Format,
+            platform: "browser",
+            outExtension: {
+              ".js": ".mjs"
+            },
+            plugins: [
+              {
+                name: "transform-requires",
+                setup(build: any) {
+                  build.onEnd(() => {
+                    const files = glob.sync("public/esm/**/*.mjs");
+                    for (const file of files) {
+                      let content = readFileSync(file, "utf8");
+                      // Transform require statements to dynamic imports
+                      content = content.replace(
+                        /const\s+{([^}]+)}\s*=\s*require\(['"]([^'"]+)['"]\)/g,
+                        "import { $1 } from \"$2\""
+                      );
+                      content = content.replace(
+                        /const\s+([^=]+)\s*=\s*require\(['"]([^'"]+)['"]\)/g,
+                        "import $1 from \"$2\""
+                      );
+                      writeFileSync(file, content, "utf8");
+                    }
+                  });
+                }
+              },
+              {
+                name: "add-extensions",
+                setup(build: any) {
+                  build.onEnd(() => {
+                    entryPoints.forEach((entry: string) => {
+                      const outputFilePath = path.join("./public/esm", entry.replace("src/", "").replace(".ts", ".mjs"));
+                      addExtensions(outputFilePath, ".mjs", esmSettings);
+                    });
+                  });
+                }
+              }
+            ]
+          };
+
+          const browserSettings: BuildOptions = {
+            ...baseSettings,
+            outdir: "public/browser",
+            format: "iife" as Format,
+            platform: "browser",
+            outExtension: {
+              ".js": ".js"
+            }
+          };
+
+          // Build all formats
+          await Promise.all([
+            esbuild.build(cjsSettings),
+            esbuild.build(esmSettings),
+            esbuild.build(browserSettings)
+          ]);
+
+          logger.info("[build:esbuild] Build process completed successfully!");
+        } catch (e: any) {
+          logger.error(`[build:esbuild] Build process failed: ${e.message}`);
+          process.exit(1);
+        }
+      }
+    };
+
+    const commandHandler = this;
+    logger.debug("Loading command build:esbuild...");
+
+    // Register both commands
+    switchCommander.program.command("build:esbuild")
+      .allowExcessArguments(false)
+      .description("Builds the project using esbuild for CJS, ESM, and browser formats")
+      .action(function () {
+        commandHandler.choiceOption.build_esbuild.call(commandHandler);
+      });
+
+    // Add alias
+    switchCommander.program.command("build:esb")
+      .allowExcessArguments(false)
+      .description("Alias for build:esbuild - Builds the project using esbuild")
+      .action(function () {
+        commandHandler.choiceOption.build_esbuild.call(commandHandler);
+      });
+
+    logger.debug("Loading command build:esbuild... DONE.");
+  }
+}
+
+Package("com.qcobjects.cli.commands.build.esbuild", [
+  CommandHandler
+]);

package/src/cli-commands-build-typescript.ts

@@ -0,0 +1,139 @@
+/**
+ * QCObjects CLI 2.5
+ * ________________
+ *
+ * Author: Jean Machuca <correojean@gmail.com>
+ *
+ * Cross Browser Javascript Framework for MVC Patterns
+ * QuickCorp/QCObjects is licensed under the
+ * GNU Lesser General Public License v3.0
+ * [LICENSE] (https://github.com/QuickCorp/QCObjects/blob/master/LICENSE.txt)
+ *
+ * Permissions of this copyleft license are conditioned on making available
+ * complete source code of licensed works and modifications under the same
+ * license or the GNU GPLv3. Copyright and license notices must be preserved.
+ * Contributors provide an express grant of patent rights. However, a larger
+ * work using the licensed work through interfaces provided by the licensed
+ * work may be distributed under different terms and without source code for
+ * the larger work.
+ *
+ * Copyright (C) 2015 Jean Machuca,<correojean@gmail.com>
+ *
+ * Everyone is permitted to copy and distribute verbatim copies of this
+ * license document, but changing it is not allowed.
+*/
+/*eslint no-unused-vars: "off"*/
+/*eslint no-redeclare: "off"*/
+/*eslint no-empty: "off"*/
+/*eslint strict: "off"*/
+/*eslint no-mixed-operators: "off"*/
+/*eslint no-undef: "off"*/
+"use strict";
+import path from "node:path";
+import ts from "typescript";
+import { Package, InheritClass, logger } from "qcobjects";
+
+export class CommandHandler extends InheritClass {
+  choiceOption: {
+    [x: string]: any;
+    build_typescript: (configFile: string) => void;
+  };
+
+  constructor({
+    switchCommander
+  }: { switchCommander: any }) {
+    super({ switchCommander });
+    this.choiceOption = {
+      build_typescript(configFile) {
+        try {
+          logger.info(`[build:typescript] Building TypeScript with config file: ${configFile}...`);
+          
+          // Resolve the path to the tsconfig file
+          const configPath = path.resolve(process.cwd(), configFile);
+
+          // Parse the tsconfig file
+          const parsedCommandLine = ts.getParsedCommandLineOfConfigFile(configPath, {}, {
+            ...ts.sys,
+            onUnRecoverableConfigFileDiagnostic: diagnostic => {
+              logger.warn(ts.formatDiagnostic(diagnostic, {
+                getCanonicalFileName: (fileName) => fileName,
+                getCurrentDirectory: ts.sys.getCurrentDirectory,
+                getNewLine: () => ts.sys.newLine,
+              }));
+              process.exit(1);
+            }
+          });
+
+          if (!parsedCommandLine) {
+            logger.warn('Failed to parse tsconfig file');
+            process.exit(1);
+          }
+
+          // Create a program with the parsed settings
+          const program = ts.createProgram({
+            rootNames: parsedCommandLine.fileNames,
+            options: parsedCommandLine.options,
+          });
+
+          // Emit the compiled files
+          const emitResult = program.emit();
+
+          // Report any diagnostics (errors or warnings)
+          const allDiagnostics = ts.getPreEmitDiagnostics(program).concat(emitResult.diagnostics);
+
+          allDiagnostics.forEach(diagnostic => {
+            if (diagnostic.file && diagnostic.start) {
+              const { line, character } = diagnostic.file.getLineAndCharacterOfPosition(diagnostic.start);
+              const message = ts.flattenDiagnosticMessageText(diagnostic.messageText, '\n');
+              logger.warn(`${diagnostic.file.fileName} (${line + 1},${character + 1}): ${message}`);
+            } else {
+              logger.warn(ts.flattenDiagnosticMessageText(diagnostic.messageText, '\n'));
+            }
+          });
+
+          // Check if any files were emitted
+          const emittedFiles = emitResult.emittedFiles || [];
+          if (emittedFiles.length > 0) {
+            logger.info('Emitted files:');
+            emittedFiles.forEach(file => logger.info(file));
+          }
+
+          // Exit with an appropriate code
+          const exitCode = emitResult.emitSkipped ? 1 : 0;
+          logger.info(`Process completed with code '${exitCode}'.`);
+          if (exitCode !== 0) {
+            process.exit(exitCode);
+          }
+        } catch (e: any) {
+          logger.warn(`Something went wrong trying to build TypeScript: ${e.message}`);
+          process.exit(1);
+        }
+      }
+    };
+
+    const commandHandler = this;
+    logger.debug("Loading command build:typescript...");
+
+    // Register both commands
+    const buildCommand = switchCommander.program.command("build:typescript <configFile>")
+      .allowExcessArguments(false)
+      .description("Builds TypeScript files using the specified config file")
+      .action(function (configFile: string) {
+        commandHandler.choiceOption.build_typescript.call(commandHandler, configFile);
+      });
+
+    // Add alias
+    switchCommander.program.command("build:ts <configFile>")
+      .allowExcessArguments(false)
+      .description("Alias for build:typescript - Builds TypeScript files using the specified config file")
+      .action(function (configFile: string) {
+        commandHandler.choiceOption.build_typescript.call(commandHandler, configFile);
+      });
+
+    logger.debug("Loading command build:typescript... DONE.");
+  }
+}
+
+Package("com.qcobjects.cli.commands.build.typescript", [
+  CommandHandler
+]); 

package/src/cli-commands-jira.ts

@@ -1,5 +1,5 @@
 /**
- * QCObjects CLI 2.4.x
+ * QCObjects CLI 2.5
  * ________________
  *
  * Author: Jean Machuca <correojean@gmail.com>

package/src/cli-commands-version.ts

@@ -1,5 +1,5 @@
 /**
- * QCObjects CLI 2.4.x
+ * QCObjects CLI 2.5
  * ________________
  *
  * Author: Jean Machuca <correojean@gmail.com>

package/src/cli-commands.ts

@@ -1,5 +1,5 @@
 /**
- * QCObjects CLI 2.4.x
+ * QCObjects CLI 2.5
  * ________________
  *
  * Author: Jean Machuca <correojean@gmail.com>
@@ -35,3 +35,5 @@
 export * as versionCommand from "./cli-commands-version";
 export * as jiraCommand from "./cli-commands-jira";
 export * as publishStatic from "./cli-commands-publish-static";
+export * as buildTypescript from "./cli-commands-build-typescript";
+export * as buildEsbuild from "./cli-commands-build-esbuild";

package/src/cli-main.ts

@@ -1,5 +1,5 @@
 /**
- * QCObjects CLI 2.4.x
+ * QCObjects CLI 2.5
  * ________________
  *
  * Author: Jean Machuca <correojean@gmail.com>

package/src/client_services.ts

@@ -1,5 +1,5 @@
 /**
- * QCObjects CLI 2.4.x
+ * QCObjects CLI 2.5
  * ________________
  *
  * Author: Jean Machuca <correojean@gmail.com>

package/src/collab-server.ts

@@ -1,6 +1,6 @@
 "use strict";
 /**
- * QCObjects CLI 2.4.x
+ * QCObjects CLI 2.5
  * ________________
  *
  * Author: Jean Machuca <correojean@gmail.com>

package/src/common-pipelog.ts

@@ -1,5 +1,5 @@
 /**
- * QCObjects CLI 2.4.x
+ * QCObjects CLI 2.5
  * ________________
  *
  * Author: Jean Machuca <correojean@gmail.com>