HTML Export Support

src/commands/convert/hdf2html.ts

@@ -0,0 +1,45 @@
+import {Command, Flags} from '@oclif/core'
+import fs from 'fs'
+import path from 'path'
+import {FromHDFToHTMLMapper as Mapper} from '@mitre/hdf-converters'
+
+// All selectable export types for an HTML export
+enum FileExportTypes {
+  Executive = 'Executive',
+  Manager = 'Manager',
+  Administrator = 'Administrator'
+}
+
+export default class HDF2HTML extends Command {
+  static usage = 'convert hdf2html -i <hdf-scan-results-json>... -o <output-html> [-h]'
+
+  static description = 'Translate an HDF file into a Heimdall Report HTML file'
+
+  static examples = ['saf convert hdf2html -i hdf_input.json -o report.html']
+
+  static flags = {
+    help: Flags.help({char: 'h'}),
+    input: Flags.string({char: 'i', required: true, multiple: true, description: 'Input HDF JSON file'}),
+    output: Flags.string({char: 'o', required: true, description: 'Output HTML file'}),
+  }
+
+  async run() {
+    const {flags} = await this.parse(HDF2HTML)
+
+    const files = []
+    for (const file of flags.input) {
+      // Create (somewhat) unique fileID for html reference
+      const idCore = path.basename(file).replace(' ', '-')
+      const idTail1 = Math.random() * 100
+      const idTail2 = Math.random() * 100
+
+      const data = fs.readFileSync(file, 'utf8')
+      const fileName = path.basename(file)
+      const fileID = `${idCore}-${idTail1}-${idTail2}`
+      files.push({data, fileName, fileID})
+    }
+
+    const converter = await new Mapper(files, FileExportTypes.Administrator).toHTML('/html/')
+    fs.writeFileSync(flags.output, converter)
+  }
+}

tailwind.config.js

@@ -0,0 +1,31 @@
+/** @type {import('tailwindcss').Config} */
+
+// Lookup constants
+const fs = require("fs");
+
+// Grabs template and dependencies for HTML export
+const files = {
+  [require.resolve(
+    "@mitre/hdf-converters/src/converters-from-hdf/html/template.html"
+  )]: "src/commands/convert/html/template.html",
+  [require.resolve("tw-elements/dist/js/tw-elements.umd.min.js")]:
+    "src/commands/convert/html/tw-elements.min.js",
+};
+for (const file in files) {
+  fs.copyFile(file, files[file], (err) => {
+    if (err) {
+      throw err;
+    }
+  });
+}
+
+module.exports = {
+  content: [
+    "./src/commands/convert/html/template.html",
+    "./node_modules/tw-elements/dist/js/**/*.js",
+  ],
+  theme: {
+    extend: {},
+  },
+  plugins: [require("tw-elements/dist/plugin.cjs")],
+};