Bundling

Currently artemis requires that we have all of our JavaScript code in one .js file. However, while very simple scripts may only be one file, if we decide to import an artemis function or split our code into multiple files we now have multiple files that need to be combine into one .js file.

A Bundler can help us perform this task.

The TypeScript code below imports a function and the Registry interface from artemis.

import { getRegistry } from "./artemis-api/mod";
import { WindowsError } from "./artemis-api/src/windows/errors";
import { Registry } from "./artemis-api/types/windows/registry";

interface InstalledPrograms {
  name: string;
  version: string;
  install_location: string;
  install_source: string;
  language: string;
  publisher: string;
  install_string: string;
  install_date: string;
  uninstall_string: string;
  url_info: string;
  reg_path: string;
}

function grab_info(reg: Registry[]): InstalledPrograms[] {
  const programs: InstalledPrograms[] = [];
  const min_size = 3;
  for (const entries of reg) {
    if (entries.values.length < min_size) {
      continue;
    }
    const program: InstalledPrograms = {
      name: "",
      version: "",
      install_location: "",
      install_source: "",
      language: "",
      publisher: "",
      install_string: "",
      install_date: "",
      uninstall_string: "",
      url_info: "",
      reg_path: entries.path,
    };

    for (const value of entries.values) {
      switch (value.value) {
        case "DisplayName":
          program.name = value.data;
          break;
        case "DisplayVersion":
          program.version = value.data;
          break;
        case "InstallDate":
          program.install_date = value.data;
          break;
        case "InstallLocation":
          program.install_location = value.data;
          break;
        case "InstallSource":
          program.install_source = value.data;
          break;
        case "Language":
          program.language = value.data;
          break;
        case "Publisher":
          program.publisher = value.data;
          break;
        case "UninstallString":
          program.uninstall_string = value.data;
          break;
        case "URLInfoAbout":
          program.url_info = value.data;
          break;
        default:
          continue;
      }
    }
    programs.push(program);
  }
  return programs;
}

function main() {
  const path = "C:\\Windows\\System32\\config\\SOFTWARE";

  const reg = getRegistry(path);
  if (reg instanceof WindowsError) {
    console.error(reg);
    return;
  }
  const programs: Registry[] = [];
  for (const entries of reg) {
    if (
      !entries.path.includes(
        "Microsoft\\Windows\\CurrentVersion\\Uninstall",
      )
    ) {
      continue;
    }
    programs.push(entries);
  }
  return grab_info(programs);
}

main();

Lets save this code to the file main.ts. Before we can compile the code to JavaScript we have to include (bundle) mod.ts and registry.ts.

There are multiple types of bundler applications that can help us with this task. One of the most popular ones is esbuild

Esbuild

esbuild is a popular Bundler for JavaScript. It can be run as a standalone binary. Once you have esbuild installed you can transpile and bundle your TypeScript with the following command:

esbuild --bundle --outfile=out.js main.ts

info

esbuild can also minify JavaScript code! This can dramatically reduce the size of your script

esbuild --bundle --minify --outfile=out.js main.ts

The above commands will use the main.ts file and bundle all of its pre-requisite files into one .js file using esbuild.

Output

(() => {
  // ./artemis-api/src/utils/error.ts
  var ErrorBase = class extends Error {
    name;
    message;
    constructor(name, message) {
      super();
      this.name = name;
      this.message = message;
    }
  };

  // ./artemis-api/src/windows/errors.ts
  var WindowsError = class extends ErrorBase {
  };

  // ./artemis-api/src/windows/registry.ts
  function getRegistry(path) {
    try {
      const data = js_registry(path);
      return data;
    } catch (err) {
      return new WindowsError(
        "REGISTRY",
        `failed to parse registry file ${path}: ${err}`
      );
    }
  }

  // main.ts
  function grab_info(reg) {
    const programs = [];
    const min_size = 3;
    for (const entries of reg) {
      if (entries.values.length < min_size) {
        continue;
      }
      const program = {
        name: "",
        version: "",
        install_location: "",
        install_source: "",
        language: "",
        publisher: "",
        install_string: "",
        install_date: "",
        uninstall_string: "",
        url_info: "",
        reg_path: entries.path
      };
      for (const value of entries.values) {
        switch (value.value) {
          case "DisplayName":
            program.name = value.data;
            break;
          case "DisplayVersion":
            program.version = value.data;
            break;
          case "InstallDate":
            program.install_date = value.data;
            break;
          case "InstallLocation":
            program.install_location = value.data;
            break;
          case "InstallSource":
            program.install_source = value.data;
            break;
          case "Language":
            program.language = value.data;
            break;
          case "Publisher":
            program.publisher = value.data;
            break;
          case "UninstallString":
            program.uninstall_string = value.data;
            break;
          case "URLInfoAbout":
            program.url_info = value.data;
            break;
          default:
            continue;
        }
      }
      programs.push(program);
    }
    return programs;
  }
  function main() {
    const path = "C:\\Windows\\System32\\config\\SOFTWARE";
    const reg = getRegistry(path);
    if (reg instanceof WindowsError) {
      console.error(reg);
      return;
    }
    const programs = [];
    for (const entries of reg) {
      if (!entries.path.includes(
        "Microsoft\\Windows\\CurrentVersion\\Uninstall"
      )) {
        continue;
      }
      programs.push(entries);
    }
    return grab_info(programs);
  }
  main();
})();

The JavaScript code above was generated by esbuild and is now ready to be executed by artemis!

If you choose to minify the JavaScript you would get something like this:

(()=>{var c=class extends Error{name;message;constructor(_,M){super(),this.name=_,this.message=M}};var e=class extends c{};function U(I){try{return js_registry(I)}catch(_){return new e("REGISTRY",`failed to parse registry file ${I}: ${_}`)}}function ge(I){let _=[];for(let T of I){if(T.values.length<3)continue;let E={name:"",version:"",install_location:"",install_source:"",language:"",publisher:"",install_string:"",install_date:"",uninstall_string:"",url_info:"",reg_path:T.path};for(let w of T.values)switch(w.value){case"DisplayName":E.name=w.data;break;case"DisplayVersion":E.version=w.data;break;case"InstallDate":E.install_date=w.data;break;case"InstallLocation":E.install_location=w.data;break;case"InstallSource":E.install_source=w.data;break;case"Language":E.language=w.data;break;case"Publisher":E.publisher=w.data;break;case"UninstallString":E.uninstall_string=w.data;break;case"URLInfoAbout":E.url_info=w.data;break;default:continue}_.push(E)}return _}function _e(){let _=U("C:\\Windows\\System32\\config\\SOFTWARE");if(_ instanceof e){console.error(_);return}let M=[];for(let T of _)T.path.includes("Microsoft\\Windows\\CurrentVersion\\Uninstall")&&M.push(T);return ge(M)}_e();})();