refactor: merge resume into site (#8)

Author: mcous

.vscode/settings.json

@@ -1,16 +1,30 @@
 {
   "cSpell.words": [
+    "alexa",
     "astro",
     "astrojs",
+    "automocking",
+    "bearimy",
     "fontsource",
+    "hvac",
     "iconify",
+    "ihop",
     "mcous",
+    "mechatronics",
+    "opentrons",
     "preact",
+    "preconfigured",
     "rehype",
     "résumé",
     "sonarjs",
+    "tada",
     "tailwindcss",
-    "unocss"
+    "typechecked",
+    "unocss",
+    "viam",
+    "viam’s",
+    "vite",
+    "vitest"
   ],
   "typescript.tsdk": "node_modules/typescript/lib",
   "eslint.validate": ["astro"]

astro.config.mjs

@@ -5,12 +5,15 @@ import { defineConfig } from 'astro/config'
 import remarkEmoji from 'remark-emoji'
 import unoCss from 'unocss/astro'
 
+import { resumePDF } from './etc/resume-pdf'
+
 export default defineConfig({
   site: 'https://michael.cousins.io',
   integrations: [
     mdx({ remarkPlugins: [[remarkEmoji, { accessible: 'true' }]] }),
     sitemap(),
     unoCss({ injectReset: true }),
     preact(),
+    resumePDF(),
   ],
 })

etc/resume-pdf.js

@@ -0,0 +1,97 @@
+import { spawn } from 'node:child_process'
+import path from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+import { chromium } from 'playwright'
+
+const SOURCE_PATHNAME = '/resume/'
+const PDF_FILENAME = 'michael-cousins.pdf'
+
+/**
+ * Astro middleware to build and serve the resume PDF.
+ *
+ * @type {() => import('astro').AstroIntegration}
+ */
+export const resumePDF = () => {
+  let baseURL = ''
+
+  return {
+    name: 'resume-pdf',
+    hooks: {
+      'astro:config:done': ({ config }) => {
+        baseURL = `http://localhost:${config.server.port}/`
+      },
+      'astro:server:setup': ({ server }) => {
+        server.middlewares.use(`/${PDF_FILENAME}`, (_, response, next) => {
+          renderResumePDF(baseURL)
+            .then((contents) => {
+              response.setHeader('Content-Type', 'application/pdf')
+              response.end(contents)
+            })
+            .catch((error) => next(error))
+        })
+      },
+      'astro:build:done': async ({ dir }) => {
+        const outputFile = path.join(fileURLToPath(dir), PDF_FILENAME)
+
+        await buildResumePDF(baseURL, outputFile)
+      },
+    },
+  }
+}
+
+/**
+ * Render the resume PDF to a buffer or file path
+ *
+ * @param {string} baseURL URL of the server
+ * @param {string} [outputFile] output file, if needed
+ * @returns buffer of PDF contents
+ */
+async function renderResumePDF(baseURL, outputFile) {
+  const browser = await chromium.launch()
+  const page = await browser.newPage({ baseURL })
+  const pdfOptions = outputFile ? { path: outputFile } : {}
+
+  await page.goto(SOURCE_PATHNAME)
+  const result = await page.pdf({ tagged: true, ...pdfOptions })
+  await browser.close()
+
+  return result
+}
+
+/**
+ * Build the resume PDF to a file from the preview server.
+ *
+ * @param {string} baseURL URL of the server
+ * @param {string} [outputFile] output file, if needed
+ */
+async function buildResumePDF(baseURL, outputFile) {
+  const { end } = await launchPreviewServer()
+
+  try {
+    await renderResumePDF(baseURL, outputFile)
+  } finally {
+    end()
+  }
+}
+
+/**
+ * Launch the preview server.
+ *
+ * @returns {Promise<{end: () => void}>} the URL of the server
+ */
+async function launchPreviewServer() {
+  const server = spawn('pnpm', ['exec', 'astro', 'preview'])
+  const end = () => server.kill()
+
+  return new Promise((resolve, reject) => {
+    server.stdout.on('data', () => {
+      resolve({ end })
+    })
+
+    server.stdout.on('error', (error) => {
+      end()
+      reject(error)
+    })
+  })
+}

package.json

@@ -10,12 +10,13 @@
   "author": "Michael Cousins <michael@cousins.io> (https://michael.cousins.io)",
   "type": "module",
   "scripts": {
-    "all": "astro sync && concurrently -g pnpm:lint pnpm:check pnpm:coverage pnpm:build",
+    "all": "astro sync && pnpm run lint && pnpm run check && pnpm run coverage && pnpm run build",
     "build": "astro build",
     "check": "astro check",
     "coverage": "vitest run --coverage",
     "format": "prettier --write . && eslint --fix .",
     "lint": "prettier --check . && eslint .",
+    "prepare": "playwright install chromium",
     "preview": "astro build && astro preview",
     "start": "astro dev",
     "test": "vitest"
@@ -24,6 +25,10 @@
     "parserOptions": {
       "project": "./tsconfig.json"
     },
+    "env": {
+      "browser": true,
+      "node": true
+    },
     "extends": [
       "@mcous/eslint-config",
       "@unocss",
@@ -40,6 +45,8 @@
           "varsIgnorePattern": "^_"
         }
       ],
+      "promise/always-return": "off",
+      "promise/no-callback-in-promise": "off",
       "simple-import-sort/imports": "error",
       "simple-import-sort/exports": "error"
     },
@@ -95,7 +102,6 @@
     "@unocss/eslint-config": "^0.58.5",
     "@unocss/preset-icons": "^0.58.5",
     "@vitest/coverage-istanbul": "^1.3.1",
-    "concurrently": "^8.2.2",
     "eslint": "^8.57.0",
     "eslint-config-prettier": "^9.1.0",
     "eslint-plugin-astro": "^0.31.4",
@@ -108,6 +114,7 @@
     "eslint-plugin-unicorn": "^51.0.1",
     "eslint-plugin-vitest": "^0.3.22",
     "jsdom": "^24.0.0",
+    "playwright": "^1.42.1",
     "prettier": "^3.2.5",
     "prettier-plugin-astro": "^0.13.0",
     "remark-emoji": "^4.0.1",