repositories / pi-ext

pi-ext

bugabingas pi extensions

owned by bugabinga

extensions/web/spawn.ts

Raw
// Shared spawn helper for running external commands

import { spawn } from "node:child_process";

export function spawnToText(
	cmd: string,
	args: string[],
	input?: string,
): Promise<string> {
	return new Promise((resolve, reject) => {
		const proc = spawn(cmd, args);
		let stdout = "";
		let stderr = "";
		proc.stdout.on("data", (d: Buffer) => (stdout += d));
		proc.stderr.on("data", (d: Buffer) => (stderr += d));
		proc.on("close", (code) => {
			if (code === 0) resolve(stdout);
			else reject(new Error(stderr || `${cmd}: ${code}`));
		});
		proc.on("error", reject);
		if (input !== undefined) {
			proc.stdin.write(input);
			proc.stdin.end();
		}
	});
}

/**
 * Check if a command is available on PATH.
 * Returns null if available, or an install hint string if not.
 */
const availableCommands = new Map<string, string | null>();

export async function checkToolAvailability(
	cmd: string,
	installHint: string,
): Promise<string | null> {
	const cached = availableCommands.get(cmd);
	if (cached !== undefined) return cached;

	try {
		await spawnToText("which", [cmd]);
		availableCommands.set(cmd, null);
		return null;
	} catch {
		availableCommands.set(cmd, installHint);
		return installHint;
	}
}

// Tool install hints
export const TOOL_HINTS = {
	pandoc:
		"pandoc is not installed. Install with: brew install pandoc / apt install pandoc / conda install pandoc",
	pdftotext:
		"pdftotext (poppler-utils) is not installed. Install with: brew install poppler / apt install poppler-utils",
	identify:
		"identify (ImageMagick) is not installed. Install with: brew install imagemagick / apt install imagemagick",
	ffprobe:
		"ffprobe (ffmpeg) is not installed. Install with: brew install ffmpeg / apt install ffmpeg",
} as const;