use defaults for expected proccess envs

Author: laidrivm

.env_example

@@ -2,4 +2,7 @@ PORT=3000
 ADDRESS=laidrivm.com
 SOURCE=local
 # SOURCE=https://github.com/laidrivm/articles
-# GITHUB_TOKEN=unath
+GITHUB_TOKEN=unath
+# GITHUB_TOKEN=ghp_...
+ARTICLES=articles
+PUBLIC=public

build.js

@@ -33,13 +33,13 @@
   "scripts": {
     "format": "prettier --write 'src/**/*.{css,html,ts,tsx}'",
     "lint": "eslint 'src/**/*.{css,html,ts,tsx}' --fix",
-    "build": "bun run build.js",
+    "build": "bun run src/build.ts",
     "test": "bun test --watch --timeout 1000 --rerun-each 2 --coverage",
     "generate_dev": "bun src/generate.tsx",
     "server_dev": "bun run --watch src/index.ts",
     "dev": "bun run build && bun run generate_dev && bun run server_dev",
-    "generate": "bun out/generate.js",
-    "server": "bun out/index.js",
+    "generate": "bun run out/generate.js",
+    "server": "bun run out/index.js",
     "prod": "bun run generate && bun run server",
     "clean": "bun run src/public-clean-up.ts"
   }

package.json

@@ -0,0 +1,58 @@
+import path from 'path'
+import {mkdir} from 'node:fs/promises'
+
+import esbuild from 'esbuild'
+import cssModulesPlugin from 'esbuild-css-modules-plugin'
+
+import * as EnvUtils from './envutils.ts'
+
+esbuild
+  .build({
+    entryPoints: ['./src/index.ts', './src/generate.tsx'],
+    bundle: true,
+    metafile: true,
+    outdir: './out',
+    outbase: 'src',
+    platform: 'node',
+    format: 'esm',
+    target: 'esnext',
+    external: [],
+    nodePaths: ['node_modules']
+  })
+  .catch(() => process.exit(1))
+
+EnvUtils.initDefaults()
+
+const pub = Bun.file(process.env.PUBLIC)
+
+if (!(await pub.exists())) {
+  await mkdir(process.env.PUBLIC, {recursive: true})
+}
+
+const fonts = Bun.file(path.join(process.env.PUBLIC, 'fonts'))
+if (!(await fonts.exists('./public/fonts'))) {
+  await mkdir(path.join(process.env.PUBLIC, 'fonts'), {recursive: true})
+}
+
+esbuild
+  .build({
+    entryPoints: ['./src/styles/main.css'],
+    bundle: true,
+    outfile: './public/main.css',
+    minify: true,
+    metafile: true,
+    loader: {
+      '.ttf.woff2': 'file',
+      '.woff2': 'file'
+    },
+    plugins: [
+      cssModulesPlugin({
+        inject: true,
+        minify: true,
+        targets: '>= 0.25%'
+      })
+    ],
+    publicPath: '/', // Set public path for file references
+    assetNames: 'fonts/[name]' // Output assets to the fonts directory
+  })
+  .catch(() => process.exit(1))

src/build.ts

@@ -0,0 +1,30 @@
+export function initDefaults(): void {
+  if (!process.env.PORT) {
+    process.env.PORT = '3000'
+    console.log(`Using default port: ${process.env.PORT}`)
+  }
+  if (!process.env.ADDRESS) {
+    process.env.ADDRESS = 'localhost'
+    console.log(`Using default site address: ${process.env.ADDRESS}`)
+  }
+  if (!process.env.SOURCE) {
+    process.env.SOURCE = 'local'
+    console.log(`Using default source for the content: ${process.env.SOURCE}`)
+  }
+  if (!process.env.GITHUB_TOKEN) {
+    process.env.GITHUB_TOKEN = 'unauth'
+    console.log(`Using default token for GitHub: ${process.env.GITHUB_TOKEN}`)
+  }
+  if (!process.env.ARTICLES) {
+    process.env.ARTICLES = 'articles'
+    console.log(
+      `Using default directory to store content sources: ${process.env.ARTICLES}`
+    )
+  }
+  if (!process.env.PUBLIC) {
+    process.env.PUBLIC = 'public'
+    console.log(
+      `Using default directory to render and serve pages: ${process.env.PUBLIC}`
+    )
+  }
+}

src/envutils.ts

@@ -1,6 +1,7 @@
 import {join} from 'path'
 import {rm} from 'node:fs/promises'
 
+import * as EnvUtils from './envutils.ts'
 import type {Indexes, PageEntry, ArticleProcessingConfig} from './types.ts'
 import pullArticles from './pullarticles.ts'
 import {processArticles, processIndexes} from './processpages.tsx'
@@ -68,7 +69,7 @@ interface SiteGenerationConfig {
  * Generate static site with configurable options
  * @param config Site generation configuration
  */
-async function generateSite(config: SiteGenerationConfig = {}): Promise<void> {
+async function generateSite(config: SiteGenerationConfig = {}): void {
   const {
     articlesPath = process.env.ARTICLES,
     publicPath = process.env.PUBLIC,
@@ -106,34 +107,5 @@ async function generateSite(config: SiteGenerationConfig = {}): Promise<void> {
   }
 }
 
-/**
- * Validate if arguments are already loaded in the environment
- */
-function hasRequiredEnvVars(): boolean {
-  const requiredVars = [
-    'PORT',
-    'ADDRESS',
-    'SOURCE',
-    'GITHUB_TOKEN',
-    'ARTICLES',
-    'PUBLIC'
-  ]
-  return requiredVars.every(varName => !!process.env[varName])
-}
-
-async function initializeSiteGeneration(): Promise<void> {
-  try {
-    if (!hasRequiredEnvVars()) {
-      const dotEnv = await Bun.file('.env')
-      if (!(await dotEnv.exists())) {
-        throw new Error('No .env file found')
-      }
-    }
-    await generateSite()
-  } catch (error) {
-    console.error('Site generation initialization error:', error)
-    process.exit(1)
-  }
-}
-
-initializeSiteGeneration()
+EnvUtils.initDefaults()
+await generateSite()

src/generate.tsx

@@ -1,32 +1,12 @@
 import {Elysia} from 'elysia'
 import {staticPlugin} from '@elysiajs/static'
 
+import * as EnvUtils from './envutils.ts'
+
 const key = await Bun.file('certs/key.pem').text()
 const cert = await Bun.file('certs/cert.pem').text()
 
-function hasRequiredEnvVars(): boolean {
-  const requiredVars = [
-    'PORT',
-    'ADDRESS',
-    'SOURCE',
-    'GITHUB_TOKEN',
-    'ARTICLES',
-    'PUBLIC'
-  ]
-  return requiredVars.every(varName => !!process.env[varName])
-}
-
-try {
-  if (!hasRequiredEnvVars()) {
-    const dotEnv = await Bun.file('.env')
-    if (!(await dotEnv.exists())) {
-      throw new Error('No .env file found')
-    }
-  }
-} catch (error) {
-  console.error('Site serving initialization error:', error)
-  process.exit(1)
-}
+EnvUtils.initDefaults()
 
 const app = new Elysia()
   .use(

src/index.ts

@@ -2,14 +2,16 @@ import {existsSync, statSync, rmdirSync} from 'node:fs'
 import {readdir} from 'node:fs/promises'
 import path from 'path'
 
+import * as EnvUtils from './envutils.ts'
+
 const EXCEPTIONS = [
   'favicon.png',
   'mellon-for-incubators.pdf',
   'og_image-min.jpg',
   'robots.txt'
 ]
 
-async function deleteRecursively(dirPath: string) {
+async function deleteRecursively(dirPath: string): void {
   if (!existsSync(dirPath)) return
 
   const items = await readdir(dirPath)
@@ -44,8 +46,8 @@ async function deleteRecursively(dirPath: string) {
   }
 }
 
-async function cleanupPublicDirectory() {
-  process.env.PUBLIC = process.env.PUBLIC ? process.env.PUBLIC : 'public'
+async function cleanupPublicDirectory(): void {
+  EnvUtils.initDefaults()
   const publicDir = process.env.PUBLIC
 
   if (!existsSync(publicDir)) {

src/public-clean-up.ts

@@ -5,7 +5,14 @@ import {Octokit} from 'octokit'
 import {Buffer} from 'buffer/'
 
 const IGNORE_LIST: string[] = ['README.md', '.git', '.gitignore']
-const IMAGE_EXTENSIONS: string[] = ['.png', '.jpg', '.jpeg', '.gif', '.svg', '.webp']
+const IMAGE_EXTENSIONS: string[] = [
+  '.png',
+  '.jpg',
+  '.jpeg',
+  '.gif',
+  '.svg',
+  '.webp'
+]
 
 /**
  * Parse GitHub repository details from URL
@@ -68,10 +75,10 @@ async function downloadFile(
 
     // Decode file content (GitHub API returns base64 encoded content)
     const fileContent = Buffer.from(data.content, 'base64')
-    
+
     const localFilePath = path.join(articlesDir, item.path)
     await fs.mkdir(path.dirname(localFilePath), {recursive: true})
-    
+
     if (item.name.endsWith('.md')) {
       // For markdown files, convert to utf-8 string before writing
       await fs.writeFile(localFilePath, fileContent.toString('utf-8'))
@@ -120,7 +127,7 @@ async function processRepoContents(
       if (item.type === 'dir') {
         await processRepoContents(octokit, owner, repo, item.path, articlesDir)
       } else if (
-        item.type === 'file' && 
+        item.type === 'file' &&
         (item.name.endsWith('.md') || isImage(item.name))
       ) {
         await downloadFile(octokit, owner, repo, item, articlesDir)
@@ -148,10 +155,6 @@ async function pullArticles(
     const githubToken = config?.githubToken || process.env.GITHUB_TOKEN
     const sourceUrl = config?.sourceUrl || process.env.SOURCE
 
-    if (!sourceUrl) {
-      throw new Error('Missing SOURCE environment variable')
-    }
-
     const octokit = createOctokitClient(githubToken)
 
     const {owner, repo} = parseRepoDetails(sourceUrl)
@@ -168,4 +171,4 @@ async function pullArticles(
   }
 }
 
-export default pullArticles
+export default pullArticles