manyplug 1.3.0

package/src/ui.js

@@ -0,0 +1,70 @@
+import ora from 'ora';
+import chalk from 'chalk';
+import readline from 'node:readline';
+
+// ------------------------------------------------------------
+// format utils  (used by install, remove, init, sync-update)
+// ------------------------------------------------------------
+
+export function formatSize(bytes) {
+	if (!bytes) return '0 B';
+	const units = ['B', 'KB', 'MB', 'GB'];
+	let i = 0, n = bytes;
+	while (n >= 1024 && i < units.length - 1) { n /= 1024; i++; }
+	return `${n.toFixed(2)} ${units[i]}`;
+}
+
+export function formatDuration(ms) {
+	if (ms < 1000)  return `${ms.toFixed(0)}ms`;
+	if (ms < 60000) return `${(ms / 1000).toFixed(1)}s`;
+	return `${(ms / 60000).toFixed(1)}m`;
+}
+
+// ------------------------------------------------------------
+// spinner  (used by sync-update, install)
+// ------------------------------------------------------------
+
+export function createSpinner(text) {
+	const sp = ora({
+		text,
+		spinner: { frames: ['⠋','⠙','⠹','⠸','⠼','⠴','⠦','⠧','⠇','⠏'], interval: 80 },
+		color: 'cyan'
+	});
+	return {
+		start:   (t)  => { if (t) sp.text = t; sp.start(); },
+		succeed: (t)  => sp.succeed(t),
+		fail:    (t)  => sp.fail(t),
+		warn:    (t)  => sp.warn(t),
+		stop:    ()   => sp.stop(),
+		setText: (t)  => { sp.text = t; }
+	};
+}
+
+// ------------------------------------------------------------
+// confirm prompt  (used by sync-update, remove)
+// ------------------------------------------------------------
+
+export function confirm(message, defaultValue = true) {
+	const hint = defaultValue ? '[Y/n]' : '[y/N]';
+	const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+	const ask = () => new Promise(res => rl.question(`${message} ${hint} `, res));
+
+	return (async () => {
+		while (true) {
+			const a = (await ask()).trim().toLowerCase();
+			if (a === '')               { rl.close(); return defaultValue; }
+			if (['y','yes'].includes(a)) { rl.close(); return true; }
+			if (['n','no'].includes(a))  { rl.close(); return false; }
+			console.log('  please answer y or n');
+		}
+	})();
+}
+
+// ------------------------------------------------------------
+// mirror status line  (used by registry-ops callback)
+// ------------------------------------------------------------
+
+export function mirrorLine(mirror, status, err) {
+	const icon = status === 'ok' ? chalk.green('+') : chalk.red('x');
+	console.log(`  ${icon} ${mirror.name}${err ? ': ' + err : ''}`);
+}

package/src/utils.js

@@ -0,0 +1,71 @@
+import { exec } from 'node:child_process';
+import fs from 'fs-extra';
+import path from 'path';
+import os from 'node:os';
+import { formatSize } from './ui.js';
+
+// ------------------------------------------------------------
+
+export function run(cmd, cwd) {
+	return new Promise((res, rej) =>
+		exec(cmd, { cwd }, (err, stdout, stderr) => {
+			if (err) { err.stderr = stderr; return rej(err); }
+			res(stdout);
+		})
+	);
+}
+
+export async function getDirSize(dir) {
+	let total = 0;
+	for (const entry of await fs.readdir(dir, { withFileTypes: true })) {
+		const p = path.join(dir, entry.name);
+		total += entry.isDirectory() ? await getDirSize(p) : (await fs.stat(p)).size;
+	}
+	return total;
+}
+
+// sparse-clones a single plugin dir from a git repo into pluginsDir
+export async function installPluginFromRepo({ plugin, repo }, pluginsDir) {
+	const tmp     = path.join(os.tmpdir(), `manyplug-${Date.now()}`);
+	const repoDir = path.join(tmp, 'repo');
+	await fs.mkdir(tmp, { recursive: true });
+
+	try {
+		process.stdout.write(`  cloning ${repo}... `);
+		await run(`git clone --filter=blob:none --no-checkout ${repo} ${repoDir}`);
+		await run(`git sparse-checkout init --cone`, repoDir);
+		await run(`git sparse-checkout set ${plugin}`, repoDir);
+		await run(`git checkout`, repoDir);
+		console.log('ok');
+
+		const src  = path.join(repoDir, plugin);
+		const dest = path.join(pluginsDir, plugin);
+
+		if (!await fs.pathExists(src))
+			throw new Error(`plugin "${plugin}" not found in repo`);
+
+		const size = await getDirSize(src);
+		process.stdout.write(`  copying ${formatSize(size)}... `);
+		await fs.mkdir(pluginsDir, { recursive: true });
+		await fs.cp(src, dest, { recursive: true });
+		console.log('ok');
+
+		return { finalPath: dest, size };
+	} finally {
+		await fs.rm(tmp, { recursive: true, force: true });
+	}
+}
+
+export async function installNpmDeps(deps, pluginDir) {
+	const list = Object.entries(deps)
+		.map(([n, v]) => `${n}@${v === '*' ? 'latest' : v}`)
+		.join(' ');
+	if (!list) return;
+	process.stdout.write(`  npm install ${list}... `);
+	try {
+		await run(`npm install ${list}`, pluginDir);
+		console.log('ok');
+	} catch (e) {
+		console.warn(`warn: npm install failed: ${e.message}`);
+	}
+}

package/src/validate.js

@@ -0,0 +1,121 @@
+import fs from 'fs-extra';
+import path from 'path';
+import { execSync } from 'node:child_process';
+
+const VALID_CATEGORIES = ['games', 'media', 'utility', 'service', 'admin', 'fun'];
+
+// ------------------------------------------------------------
+// rules — each returns an error string or null
+// ------------------------------------------------------------
+
+const RULES = {
+	name:    v => typeof v !== 'string' || !v              ? 'required string'
+	            : !/^[a-z0-9-]+$/.test(v)                  ? 'lowercase letters, numbers, hyphens only'
+	            : v.length < 2 || v.length > 50             ? 'length must be 2-50'
+	            : null,
+
+	version: v => typeof v !== 'string' || !v              ? 'required string'
+	            : !/^\d+\.\d+\.\d+/.test(v)                ? 'must be semver (e.g. 1.0.0)'
+	            : null,
+
+	category: v => !VALID_CATEGORIES.includes(v)           ? `must be one of: ${VALID_CATEGORIES.join(', ')}`
+	             : null,
+
+	service:  v => v !== undefined && typeof v !== 'boolean' ? 'must be boolean' : null,
+	local:    v => v !== undefined && typeof v !== 'boolean' ? 'must be boolean' : null,
+	main:     v => v !== undefined && typeof v !== 'string'  ? 'must be string'  : null,
+
+	dependencies:         v => v !== undefined && typeof v !== 'object' ? 'must be object' : null,
+	externalDependencies: v => {
+		if (v === undefined) return null;
+		if (typeof v !== 'object') return 'must be object';
+		for (const [n, c] of Object.entries(v)) {
+			if (typeof c === 'string') continue;
+			if (typeof c !== 'object') return `${n}: must be string or object`;
+			if (c.command  !== undefined && typeof c.command  !== 'string')  return `${n}.command must be string`;
+			if (c.optional !== undefined && typeof c.optional !== 'boolean') return `${n}.optional must be boolean`;
+		}
+		return null;
+	}
+};
+
+const REQUIRED = ['name', 'version', 'category'];
+const KNOWN    = new Set([...REQUIRED, 'service', 'local', 'description', 'author', 'license', 'main', 'dependencies', 'externalDependencies']);
+
+function commandExists(cmd) {
+	try {
+		execSync(process.platform === 'win32' ? `where ${cmd}` : `command -v ${cmd}`, { stdio: 'pipe' });
+		return true;
+	} catch { return false; }
+}
+
+// ------------------------------------------------------------
+// validate command
+// ------------------------------------------------------------
+
+export async function validateCommand(pluginPath = '.') {
+	const abs = path.resolve(pluginPath);
+
+	if (!await fs.pathExists(abs)) {
+		console.error(`error: path not found: ${pluginPath}`);
+		process.exit(1);
+	}
+
+	const manifestPath = path.join(abs, 'manyplug.json');
+	if (!await fs.pathExists(manifestPath)) {
+		console.error(`error: manyplug.json not found in ${pluginPath}`);
+		console.error('  hint: run "manyplug init <name>" to scaffold a plugin');
+		process.exit(1);
+	}
+
+	let manifest;
+	try { manifest = await fs.readJson(manifestPath); }
+	catch (e) { console.error(`error: invalid manyplug.json: ${e.message}`); process.exit(1); }
+
+	const errors = [], warnings = [];
+	const err  = (field, msg) => errors.push(`  error   ${field.padEnd(24)} ${msg}`);
+	const warn = (field, msg) => warnings.push(`  warning ${field.padEnd(24)} ${msg}`);
+
+	// required fields
+	for (const f of REQUIRED)
+		if (!(f in manifest)) err(f, 'missing required field');
+
+	// field rules
+	for (const [f, v] of Object.entries(manifest)) {
+		if (!KNOWN.has(f)) { warn(f, 'unknown field'); continue; }
+		const msg = RULES[f]?.(v);
+		if (msg) err(f, msg);
+	}
+
+	// entry point
+	const main = manifest.main || 'index.js';
+	if (!await fs.pathExists(path.join(abs, main)))
+		warn('main', `entry point not found: ${main}`);
+
+	// locale
+	if (!await fs.pathExists(path.join(abs, 'locale')))
+		warn('locale', 'no locale/ directory (i18n recommended)');
+
+	// external deps
+	for (const [n, c] of Object.entries(manifest.externalDependencies || {})) {
+		const cmd = typeof c === 'string' ? c : c.command;
+		const opt = typeof c === 'object' && c.optional;
+		if (!commandExists(cmd))
+			(opt ? warn : err)(`externalDeps.${n}`, `command not found: ${cmd}`);
+	}
+
+	// output
+	const name = manifest.name || path.basename(abs);
+	console.log(`${name}@${manifest.version || '?'}  path=${abs}`);
+
+	if (errors.length || warnings.length) {
+		if (errors.length)   console.log('\n' + errors.join('\n'));
+		if (warnings.length) console.log('\n' + warnings.join('\n'));
+	} else {
+		console.log('ok  all checks passed');
+	}
+
+	console.log(`\nerrors=${errors.length}  warnings=${warnings.length}`);
+
+	if (errors.length) process.exit(1);
+}