@eighty4/dank 0.0.1-0 → 0.0.1-2

package/lib/dank.ts

@@ -3,20 +3,77 @@ export type DankConfig = {
     // buildTag?:  (() => Promise<string> | string) | string
     // mapping url to fs paths of webpages to build
     pages: Record<`/${string}`, `./${string}.html`>
+
+    services?: Array<DevService>
+}
+
+export type DevService = {
+    command: string
+    cwd?: string
+    env?: Record<string, string>
 }
 
 export async function defineConfig(
     c: Partial<DankConfig>,
 ): Promise<DankConfig> {
-    if (typeof c.pages === 'undefined' || Object.keys(c.pages).length === 0) {
+    validatePages(c.pages)
+    validateDevServices(c.services)
+    return c as DankConfig
+}
+
+function validatePages(pages?: DankConfig['pages']) {
+    if (
+        pages === null ||
+        typeof pages === 'undefined' ||
+        Object.keys(pages).length === 0
+    ) {
         throw Error('DankConfig.pages is required')
     }
-    for (const [urlPath, htmlPath] of Object.entries(c.pages)) {
+    for (const [urlPath, htmlPath] of Object.entries(pages)) {
         if (typeof htmlPath !== 'string' || !htmlPath.endsWith('.html')) {
             throw Error(
                 `DankConfig.pages['${urlPath}'] must configure an html file`,
             )
         }
     }
-    return c as DankConfig
+}
+
+function validateDevServices(services: DankConfig['services']) {
+    if (services === null || typeof services === 'undefined') {
+        return
+    }
+    if (!Array.isArray(services)) {
+        throw Error(`DankConfig.services must be an array`)
+    }
+    for (let i = 0; i < services.length; i++) {
+        const s = services[i]
+        if (s.command === null || typeof s.command === 'undefined') {
+            throw Error(`DankConfig.services[${i}].command is required`)
+        } else if (typeof s.command !== 'string' || s.command.length === 0) {
+            throw Error(
+                `DankConfig.services[${i}].command must be a non-empty string`,
+            )
+        }
+        if (s.cwd !== null && typeof s.cwd !== 'undefined') {
+            if (typeof s.cwd !== 'string' || s.cwd.trim().length === 0) {
+                throw Error(
+                    `DankConfig.services[${i}].cwd must be a non-empty string`,
+                )
+            }
+        }
+        if (s.env !== null && typeof s.env !== 'undefined') {
+            if (typeof s.env !== 'object') {
+                throw Error(
+                    `DankConfig.services[${i}].env must be an env variable map`,
+                )
+            }
+            for (const [k, v] of Object.entries(s.env)) {
+                if (typeof v !== 'string') {
+                    throw Error(
+                        `DankConfig.services[${i}].env[${k}] must be a string`,
+                    )
+                }
+            }
+        }
+    }
 }

package/lib/serve.ts

@@ -13,6 +13,7 @@ import {
     type FrontendFetcher,
 } from './http.ts'
 import { copyAssets } from './public.ts'
+import { startDevServices } from './services.ts'
 
 const isPreview = isPreviewBuild()
 
@@ -37,6 +38,7 @@ export async function serveWebsite(c: DankConfig): Promise<never> {
         isPreview ? 'preview' : 'dev server',
         `is live at http://127.0.0.1:${PORT}`,
     )
+    startDevServices(c)
     return new Promise(() => {})
 }
 
@@ -73,8 +75,6 @@ async function startEsbuildWatch(c: DankConfig): Promise<{ port: number }> {
         }),
     )
 
-    console.log(entryPoints)
-
     const ctx = await esbuildDevContext(
         createGlobalDefinitions(),
         entryPoints,

package/lib/services.ts

@@ -0,0 +1,75 @@
+import { spawn } from 'node:child_process'
+import { basename, isAbsolute, resolve } from 'node:path'
+import type { DankConfig, DevService } from './dank.ts'
+
+export function startDevServices(c: DankConfig) {
+    if (c.services?.length) {
+        const ac = new AbortController()
+        try {
+            for (const s of c.services) {
+                startService(s, ac.signal)
+            }
+        } catch (e) {
+            ac.abort()
+            throw e
+        }
+    }
+}
+
+function startService(s: DevService, signal: AbortSignal) {
+    const splitCmdAndArgs = s.command.split(/\s+/)
+    const cmd = splitCmdAndArgs[0]
+    const args = splitCmdAndArgs.length === 1 ? [] : splitCmdAndArgs.slice(1)
+    const spawned = spawn(cmd, args, {
+        cwd: resolveCwd(s.cwd),
+        env: s.env,
+        signal,
+        detached: false,
+        shell: false,
+    })
+
+    const stdoutLabel = logLabel(s.cwd, cmd, args, 32)
+    spawned.stdout.on('data', chunk => printChunk(stdoutLabel, chunk))
+
+    const stderrLabel = logLabel(s.cwd, cmd, args, 31)
+    spawned.stderr.on('data', chunk => printChunk(stderrLabel, chunk))
+
+    spawned.on('exit', () => {
+        console.log(`[${s.command}]`, 'exit')
+    })
+}
+
+function printChunk(label: string, c: Buffer) {
+    for (const l of parseChunk(c)) console.log(label, l)
+}
+
+function parseChunk(c: Buffer): Array<string> {
+    return c
+        .toString()
+        .replace(/\r?\n$/, '')
+        .split(/\r?\n/)
+}
+
+function resolveCwd(p?: string): string | undefined {
+    if (!p || isAbsolute(p)) {
+        return p
+    } else {
+        return resolve(process.cwd(), p)
+    }
+}
+
+function logLabel(
+    cwd: string | undefined,
+    cmd: string,
+    args: Array<string>,
+    ansiColor: number,
+): string {
+    cwd = !cwd
+        ? './'
+        : cwd.startsWith('/')
+          ? `/.../${basename(cwd)}`
+          : cwd.startsWith('.')
+            ? cwd
+            : `./${cwd}`
+    return `\u001b[${ansiColor}m[\u001b[1m${cmd}\u001b[22m ${args.join(' ')} \u001b[2;3m${cwd}\u001b[22;23m]\u001b[0m`
+}

package/lib_js/dank.js

@@ -1,11 +1,49 @@
 export async function defineConfig(c) {
-    if (typeof c.pages === 'undefined' || Object.keys(c.pages).length === 0) {
+    validatePages(c.pages);
+    validateDevServices(c.services);
+    return c;
+}
+function validatePages(pages) {
+    if (pages === null ||
+        typeof pages === 'undefined' ||
+        Object.keys(pages).length === 0) {
         throw Error('DankConfig.pages is required');
     }
-    for (const [urlPath, htmlPath] of Object.entries(c.pages)) {
+    for (const [urlPath, htmlPath] of Object.entries(pages)) {
         if (typeof htmlPath !== 'string' || !htmlPath.endsWith('.html')) {
             throw Error(`DankConfig.pages['${urlPath}'] must configure an html file`);
         }
     }
-    return c;
+}
+function validateDevServices(services) {
+    if (services === null || typeof services === 'undefined') {
+        return;
+    }
+    if (!Array.isArray(services)) {
+        throw Error(`DankConfig.services must be an array`);
+    }
+    for (let i = 0; i < services.length; i++) {
+        const s = services[i];
+        if (s.command === null || typeof s.command === 'undefined') {
+            throw Error(`DankConfig.services[${i}].command is required`);
+        }
+        else if (typeof s.command !== 'string' || s.command.length === 0) {
+            throw Error(`DankConfig.services[${i}].command must be a non-empty string`);
+        }
+        if (s.cwd !== null && typeof s.cwd !== 'undefined') {
+            if (typeof s.cwd !== 'string' || s.cwd.trim().length === 0) {
+                throw Error(`DankConfig.services[${i}].cwd must be a non-empty string`);
+            }
+        }
+        if (s.env !== null && typeof s.env !== 'undefined') {
+            if (typeof s.env !== 'object') {
+                throw Error(`DankConfig.services[${i}].env must be an env variable map`);
+            }
+            for (const [k, v] of Object.entries(s.env)) {
+                if (typeof v !== 'string') {
+                    throw Error(`DankConfig.services[${i}].env[${k}] must be a string`);
+                }
+            }
+        }
+    }
 }

package/lib_js/serve.js

@@ -7,6 +7,7 @@ import { isPreviewBuild } from "./flags.js";
 import { HtmlEntrypoint } from "./html.js";
 import { createBuiltDistFilesFetcher, createLocalProxyFilesFetcher, createWebServer, } from "./http.js";
 import { copyAssets } from "./public.js";
+import { startDevServices } from "./services.js";
 const isPreview = isPreviewBuild();
 // alternate port for --preview bc of service worker
 const PORT = isPreview ? 4000 : 3000;
@@ -25,6 +26,7 @@ export async function serveWebsite(c) {
     }
     createWebServer(PORT, frontend).listen(PORT);
     console.log(isPreview ? 'preview' : 'dev server', `is live at http://127.0.0.1:${PORT}`);
+    startDevServices(c);
     return new Promise(() => { });
 }
 async function startEsbuildWatch(c) {
@@ -52,7 +54,6 @@ async function startEsbuildWatch(c) {
         await html.writeTo(watchDir);
         return html;
     }));
-    console.log(entryPoints);
     const ctx = await esbuildDevContext(createGlobalDefinitions(), entryPoints, watchDir);
     await ctx.watch();
     await ctx.serve({

package/lib_js/services.js

@@ -0,0 +1,63 @@
+import { spawn } from 'node:child_process';
+import { basename, isAbsolute, resolve } from 'node:path';
+export function startDevServices(c) {
+    if (c.services?.length) {
+        const ac = new AbortController();
+        try {
+            for (const s of c.services) {
+                startService(s, ac.signal);
+            }
+        }
+        catch (e) {
+            ac.abort();
+            throw e;
+        }
+    }
+}
+function startService(s, signal) {
+    const splitCmdAndArgs = s.command.split(/\s+/);
+    const cmd = splitCmdAndArgs[0];
+    const args = splitCmdAndArgs.length === 1 ? [] : splitCmdAndArgs.slice(1);
+    const spawned = spawn(cmd, args, {
+        cwd: resolveCwd(s.cwd),
+        env: s.env,
+        signal,
+        detached: false,
+        shell: false,
+    });
+    const stdoutLabel = logLabel(s.cwd, cmd, args, 32);
+    spawned.stdout.on('data', chunk => printChunk(stdoutLabel, chunk));
+    const stderrLabel = logLabel(s.cwd, cmd, args, 31);
+    spawned.stderr.on('data', chunk => printChunk(stderrLabel, chunk));
+    spawned.on('exit', () => {
+        console.log(`[${s.command}]`, 'exit');
+    });
+}
+function printChunk(label, c) {
+    for (const l of parseChunk(c))
+        console.log(label, l);
+}
+function parseChunk(c) {
+    return c
+        .toString()
+        .replace(/\r?\n$/, '')
+        .split(/\r?\n/);
+}
+function resolveCwd(p) {
+    if (!p || isAbsolute(p)) {
+        return p;
+    }
+    else {
+        return resolve(process.cwd(), p);
+    }
+}
+function logLabel(cwd, cmd, args, ansiColor) {
+    cwd = !cwd
+        ? './'
+        : cwd.startsWith('/')
+            ? `/.../${basename(cwd)}`
+            : cwd.startsWith('.')
+                ? cwd
+                : `./${cwd}`;
+    return `\u001b[${ansiColor}m[\u001b[1m${cmd}\u001b[22m ${args.join(' ')} \u001b[2;3m${cwd}\u001b[22;23m]\u001b[0m`;
+}

package/lib_types/dank.d.ts

@@ -1,4 +1,10 @@
 export type DankConfig = {
     pages: Record<`/${string}`, `./${string}.html`>;
+    services?: Array<DevService>;
+};
+export type DevService = {
+    command: string;
+    cwd?: string;
+    env?: Record<string, string>;
 };
 export declare function defineConfig(c: Partial<DankConfig>): Promise<DankConfig>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eighty4/dank",
-  "version": "0.0.1-0",
+  "version": "0.0.1-2",
   "type": "module",
   "bin": "./lib_js/bin.js",
   "exports": {