@powernukkitx/cli 1.0.0 → 1.0.2

package/dist/commands/info.js

@@ -1,42 +1,41 @@
-import { existsSync } from 'node:fs';
-import { readdir } from 'node:fs/promises';
-import { join } from 'node:path';
-import { freemem, totalmem } from 'node:os';
-import { defineCommand } from 'citty';
-import { intro, outro, log, section, isJson, json } from '../ui/output.js';
-import { c } from '../ui/theme.js';
-import { resolveServerDir } from '../services/server.js';
-import { t } from '../i18n/index.js';
-export const infoCmd = defineCommand({
-    meta: { description: 'Show server information' },
-    args: {},
-    async run() {
-        const serverPath = await resolveServerDir();
-        const installed = serverPath !== null;
-        let plugins = [], worlds = [];
-        if (serverPath && existsSync(join(serverPath, 'plugins'))) {
-            plugins = (await readdir(join(serverPath, 'plugins'))).filter(f => f.endsWith('.jar'));
-        }
-        if (serverPath && existsSync(join(serverPath, 'worlds'))) {
-            worlds = await readdir(join(serverPath, 'worlds'));
-        }
-        const freeMb = Math.round(freemem() / 1024 / 1024);
-        const totalMb = Math.round(totalmem() / 1024 / 1024);
-        if (isJson())
-            json({
-                status: installed ? 'installed' : 'not_installed',
-                serverDir: serverPath, plugins: plugins.length, worlds: worlds.length,
-                ram: { freeMb, totalMb },
-            });
-        intro(`📊 ${t('info.title')}`);
-        section(t('info.server'));
-        log.info(`${t('info.status').padEnd(12)} ${installed ? c.green('✔ ' + t('info.installed')) : c.red('✘ ' + t('info.notInstalled'))}`);
-        if (serverPath)
-            log.info(`${t('info.path').padEnd(12)} ${c.accent(serverPath)}`);
-        log.info(`${t('info.plugins').padEnd(12)} ${plugins.length}`);
-        log.info(`${t('info.worlds').padEnd(12)} ${worlds.length}`);
-        section(t('info.system'));
-        log.info(`${t('info.ram').padEnd(12)} ${freeMb} Mo / ${totalMb} Mo`);
-        outro(installed ? t('info.ready') : t('info.notReady'));
-    },
-});
+import { existsSync } from 'node:fs';
+import { readdir } from 'node:fs/promises';
+import { join } from 'node:path';
+import { freemem, totalmem } from 'node:os';
+import { defineCommand } from 'citty';
+import { intro, outro, log, section, isJson, json } from '../ui/output.js';
+import { c } from '../ui/theme.js';
+import { resolveServerDir } from '../services/server.js';
+export const infoCmd = defineCommand({
+    meta: { description: 'Show server information' },
+    args: {},
+    async run() {
+        const serverPath = await resolveServerDir();
+        const installed = serverPath !== null;
+        let plugins = [], worlds = [];
+        if (serverPath && existsSync(join(serverPath, 'plugins'))) {
+            plugins = (await readdir(join(serverPath, 'plugins'))).filter(f => f.endsWith('.jar'));
+        }
+        if (serverPath && existsSync(join(serverPath, 'worlds'))) {
+            worlds = await readdir(join(serverPath, 'worlds'));
+        }
+        const freeMb = Math.round(freemem() / 1024 / 1024);
+        const totalMb = Math.round(totalmem() / 1024 / 1024);
+        if (isJson())
+            json({
+                status: installed ? 'installed' : 'not_installed',
+                serverDir: serverPath, plugins: plugins.length, worlds: worlds.length,
+                ram: { freeMb, totalMb },
+            });
+        intro(`📊 ${"Server info"}`);
+        section("Server");
+        log.info(`${"Status".padEnd(12)} ${installed ? c.green('✔ ' + "Installed") : c.red('✘ ' + "Not installed")}`);
+        if (serverPath)
+            log.info(`${"Path".padEnd(12)} ${c.accent(serverPath)}`);
+        log.info(`${"Plugins".padEnd(12)} ${plugins.length}`);
+        log.info(`${"Worlds".padEnd(12)} ${worlds.length}`);
+        section("System");
+        log.info(`${"Free RAM".padEnd(12)} ${freeMb} MB / ${totalMb} MB`);
+        outro(installed ? "Ready to start with 'pnx start'" : "Run 'pnx init' to create a server");
+    },
+});

package/dist/commands/init.d.ts

@@ -1,2 +1,2 @@
-import type { CommandDef } from 'citty';
-export declare const initCmd: CommandDef;
+import type { CommandDef } from 'citty';
+export declare const initCmd: CommandDef;

package/dist/commands/init.js

@@ -1,66 +1,87 @@
-import { existsSync } from 'node:fs';
-import { mkdir } from 'node:fs/promises';
-import { join, resolve } from 'node:path';
-import { cwd } from 'node:process';
-import { defineCommand } from 'citty';
-import { intro, outro, log, spin, progress } from '../ui/output.js';
-import { promptText, promptConfirm } from '../ui/prompts.js';
-import { getLatestRelease, downloadCore } from '../services/release.js';
-import { startScripts } from '../services/server.js';
-import { downloadFile } from '../infra/http.js';
-import { JAR_NAME } from '../infra/paths.js';
-import { t } from '../i18n/index.js';
-export const initCmd = defineCommand({
-    meta: { description: 'Create a new PowerNukkitX server' },
-    args: {
-        dir: { type: 'string', description: 'Target directory' },
-        dev: { type: 'boolean', description: 'Install dev version', default: false },
-    },
-    async run({ args }) {
-        intro(`⚡ ${t('init.title')}`);
-        let target = args.dir;
-        if (!target) {
-            target = await promptText({
-                message: t('init.promptDir'),
-                defaultValue: 'pnx-server',
-                validate: v => {
-                    if (!v || !v.trim())
-                        return 'Required';
-                    if (existsSync(join(resolve(cwd(), v), JAR_NAME)))
-                        return t('init.alreadyExists');
-                    return undefined;
-                },
-            });
-        }
-        const serverDir = resolve(cwd(), target);
-        if (existsSync(join(serverDir, JAR_NAME)) && args.dir) {
-            log.error(t('init.alreadyExists'));
-            process.exit(1);
-        }
-        try {
-            const sp = spin(t('init.fetchingInfo'));
-            const release = await getLatestRelease();
-            sp.stop(`${t('init.latestVersion')}: ${release.tag}`);
-            await mkdir(serverDir, { recursive: true });
-            log.step(t('init.downloading'));
-            const { size } = await downloadCore(release, join(serverDir, JAR_NAME), pct => progress(pct, JAR_NAME));
-            log.success(t('init.downloaded', (size / 1024 / 1024).toFixed(1)));
-            const sp2 = spin(t('init.downloadingScripts'));
-            for (const s of startScripts())
-                await downloadFile(s.url, join(serverDir, s.name));
-            sp2.stop(t('init.scriptsDownloaded'));
-            log.success(t('init.success'));
-            if (await promptConfirm(t('init.launchPrompt'), false)) {
-                const { runStart } = await import('./start.js');
-                await runStart({ dir: serverDir });
-            }
-            else {
-                outro(t('init.success'));
-            }
-        }
-        catch (e) {
-            log.error(e.message);
-            process.exit(1);
-        }
-    },
-});
+import { existsSync } from 'node:fs';
+import { mkdir } from 'node:fs/promises';
+import { join, resolve } from 'node:path';
+import { cwd } from 'node:process';
+import { defineCommand } from 'citty';
+import { intro, outro, log, spin, progress, isJson } from '../ui/output.js';
+import { promptText, promptConfirm, promptSelect } from '../ui/prompts.js';
+import { listReleases, downloadCore } from '../services/release.js';
+import { startScripts, setDefaultServer } from '../services/server.js';
+import { downloadFile } from '../infra/http.js';
+import { JAR_NAME } from '../infra/paths.js';
+export const initCmd = defineCommand({
+    meta: { description: 'Create a new PowerNukkitX server' },
+    args: {
+        dir: { type: 'string', description: 'Target directory' },
+        version: { type: 'string', description: 'Version to install (tag), skips the picker' },
+        dev: { type: 'boolean', description: 'Install dev version', default: false },
+    },
+    async run({ args }) {
+        intro(`⚡ ${"Create a PowerNukkitX server"}`);
+        let target = args.dir;
+        if (!target) {
+            target = await promptText({
+                message: "Server directory?",
+                defaultValue: 'pnx-server',
+                validate: v => {
+                    if (!v || !v.trim())
+                        return 'Required';
+                    if (existsSync(join(resolve(cwd(), v), JAR_NAME)))
+                        return "A server already exists here";
+                    return undefined;
+                },
+            });
+        }
+        const serverDir = resolve(cwd(), target);
+        if (existsSync(join(serverDir, JAR_NAME)) && args.dir) {
+            log.error("A server already exists here");
+            process.exit(1);
+        }
+        try {
+            const sp = spin("Fetching versions...");
+            const releases = await listReleases();
+            sp.stop(`${String(releases.length)} versions found`);
+            if (releases.length === 0)
+                throw new Error("No releases available");
+            let release;
+            if (args.version) {
+                const wanted = args.version.replace(/^v/, '');
+                release = releases.find(r => r.tag === args.version || r.version === wanted);
+                if (!release)
+                    throw new Error(`Version ${args.version} not found`);
+            }
+            else if (isJson()) {
+                release = releases[0];
+            }
+            else {
+                const chosen = await promptSelect("Select a version", releases.map((r, i) => ({
+                    value: r.tag,
+                    label: i === 0 ? `${r.tag} (${"latest"})` : r.tag,
+                    hint: r.prerelease ? "pre-release" : undefined,
+                })));
+                release = releases.find(r => r.tag === chosen) ?? releases[0];
+            }
+            await mkdir(serverDir, { recursive: true });
+            log.step("Downloading");
+            const { size } = await downloadCore(release, join(serverDir, JAR_NAME), pct => progress(pct, JAR_NAME));
+            log.success(`Downloaded (${(size / 1024 / 1024).toFixed(1)} MB)`);
+            const sp2 = spin("Downloading start scripts...");
+            for (const s of startScripts())
+                await downloadFile(s.url, join(serverDir, s.name));
+            sp2.stop("Start scripts downloaded");
+            await setDefaultServer(serverDir);
+            log.success("Server ready!");
+            if (await promptConfirm("Start the server now?", false)) {
+                const { runStart } = await import('./start.js');
+                await runStart({ dir: serverDir });
+            }
+            else {
+                outro("Server ready!");
+            }
+        }
+        catch (e) {
+            log.error(e.message);
+            process.exit(1);
+        }
+    },
+});

package/dist/commands/install.js

@@ -0,0 +1,45 @@
+import { join } from 'node:path';
+import { defineCommand } from 'citty';
+import { intro, outro, log, spin, progress } from '../ui/output.js';
+import { promptText } from '../ui/prompts.js';
+import { resolveServerDir } from '../services/server.js';
+import { installApprovedPlugin } from '../services/plugins.js';
+export async function runInstall(slug) {
+    intro(`📦 ${"Install plugin"}`);
+    let name = slug?.trim();
+    if (!name) {
+        const answer = await promptText({ message: "Plugin slug? (owner.name)", placeholder: 'Owner.Plugin' });
+        name = answer?.trim();
+    }
+    if (!name) {
+        log.info("No plugin specified");
+        outro('');
+        return;
+    }
+    const serverPath = (await resolveServerDir()) ?? '.';
+    const pluginsDir = join(serverPath, 'plugins');
+    const sp = spin(name);
+    try {
+        const entry = await installApprovedPlugin(name, pluginsDir, (pct, f) => progress(pct, f));
+        sp.stop(`${entry.name} v${entry.version}`);
+        log.success(`Installed ${entry.name}`);
+        log.info("Restart the server to load plugins");
+    }
+    catch (e) {
+        const msg = e?.message ?? '';
+        if (msg.startsWith('not-approved'))
+            sp.fail(`${name} is not approved or does not exist`);
+        else if (msg.startsWith('no-file'))
+            sp.fail(`No file for ${name}`);
+        else
+            sp.fail(`Failed to install ${name}`);
+    }
+    outro('');
+}
+export const installCmd = defineCommand({
+    meta: { name: 'install', description: 'Install an approved plugin by slug (owner.name)' },
+    args: { slug: { type: 'positional', description: 'Plugin slug, e.g. RedstoneCloud.CloudBridge', required: false } },
+    async run({ args }) {
+        await runInstall(args.slug);
+    },
+});

package/dist/commands/logs.d.ts

@@ -1,2 +1,2 @@
-import type { CommandDef } from 'citty';
-export declare const logsCmd: CommandDef;
+import type { CommandDef } from 'citty';
+export declare const logsCmd: CommandDef;

package/dist/commands/logs.js

@@ -1,61 +1,60 @@
-import { existsSync, readdirSync, statSync, readFileSync, watch } from 'node:fs';
-import { join } from 'node:path';
-import { defineCommand } from 'citty';
-import { intro, log } from '../ui/output.js';
-import { c } from '../ui/theme.js';
-import { resolveServerDir } from '../services/server.js';
-import { t } from '../i18n/index.js';
-export const logsCmd = defineCommand({
-    meta: { description: 'View server logs' },
-    args: {
-        lines: { type: 'string', description: 'Number of lines to show', default: '50' },
-        follow: { type: 'boolean', description: 'Follow log output', default: true },
-    },
-    async run({ args }) {
-        intro(`📋 ${t('logs.title')}`);
-        const serverPath = await resolveServerDir();
-        if (!serverPath) {
-            log.error(t('logs.noServer'));
-            process.exit(1);
-        }
-        const logsDir = join(serverPath, 'logs');
-        if (!existsSync(logsDir)) {
-            log.error(t('logs.noLogs'));
-            process.exit(1);
-        }
-        const files = readdirSync(logsDir)
-            .filter(f => f.endsWith('.log') || f === 'latest.log')
-            .map(f => ({ name: f, mtime: statSync(join(logsDir, f)).mtime.getTime() }))
-            .sort((a, b) => b.mtime - a.mtime);
-        if (files.length === 0) {
-            log.error(t('logs.noLogs'));
-            process.exit(1);
-        }
-        const logPath = join(logsDir, files[0].name);
-        log.step(t('logs.watching', files[0].name));
-        const n = parseInt(args.lines) || 50;
-        const content = readFileSync(logPath, 'utf-8');
-        const colorize = (line) => line.replace(/\[ERROR\]/g, c.red('[ERROR]'))
-            .replace(/\[WARN\]/g, c.yellow('[WARN]'))
-            .replace(/\[INFO\]/g, c.blue('[INFO]'));
-        for (const line of content.split('\n').filter(Boolean).slice(-n)) {
-            process.stdout.write(colorize(line) + '\n');
-        }
-        if (args.follow) {
-            log.dim(t('logs.liveMode'));
-            process.on('SIGINT', () => { process.stdout.write('\n'); process.exit(0); });
-            let buf = content;
-            watch(logPath, () => {
-                try {
-                    const updated = readFileSync(logPath, 'utf-8');
-                    if (updated.length > buf.length) {
-                        process.stdout.write(updated.slice(buf.length));
-                        buf = updated;
-                    }
-                }
-                catch { /* rotation en cours */ }
-            });
-            await new Promise(() => { });
-        }
-    },
-});
+import { existsSync, readdirSync, statSync, readFileSync, watch } from 'node:fs';
+import { join } from 'node:path';
+import { defineCommand } from 'citty';
+import { intro, log } from '../ui/output.js';
+import { c } from '../ui/theme.js';
+import { resolveServerDir } from '../services/server.js';
+export const logsCmd = defineCommand({
+    meta: { description: 'View server logs' },
+    args: {
+        lines: { type: 'string', description: 'Number of lines to show', default: '50' },
+        follow: { type: 'boolean', description: 'Follow log output', default: true },
+    },
+    async run({ args }) {
+        intro(`📋 ${"Server logs"}`);
+        const serverPath = await resolveServerDir();
+        if (!serverPath) {
+            log.error("No server detected");
+            process.exit(1);
+        }
+        const logsDir = join(serverPath, 'logs');
+        if (!existsSync(logsDir)) {
+            log.error("No log files found");
+            process.exit(1);
+        }
+        const files = readdirSync(logsDir)
+            .filter(f => f.endsWith('.log') || f === 'latest.log')
+            .map(f => ({ name: f, mtime: statSync(join(logsDir, f)).mtime.getTime() }))
+            .sort((a, b) => b.mtime - a.mtime);
+        if (files.length === 0) {
+            log.error("No log files found");
+            process.exit(1);
+        }
+        const logPath = join(logsDir, files[0].name);
+        log.step(`Reading ${files[0].name}`);
+        const n = parseInt(args.lines) || 50;
+        const content = readFileSync(logPath, 'utf-8');
+        const colorize = (line) => line.replace(/\[ERROR\]/g, c.red('[ERROR]'))
+            .replace(/\[WARN\]/g, c.yellow('[WARN]'))
+            .replace(/\[INFO\]/g, c.blue('[INFO]'));
+        for (const line of content.split('\n').filter(Boolean).slice(-n)) {
+            process.stdout.write(colorize(line) + '\n');
+        }
+        if (args.follow) {
+            log.dim("Live mode (Ctrl+C to quit)");
+            process.on('SIGINT', () => { process.stdout.write('\n'); process.exit(0); });
+            let buf = content;
+            watch(logPath, () => {
+                try {
+                    const updated = readFileSync(logPath, 'utf-8');
+                    if (updated.length > buf.length) {
+                        process.stdout.write(updated.slice(buf.length));
+                        buf = updated;
+                    }
+                }
+                catch { }
+            });
+            await new Promise(() => { });
+        }
+    },
+});

package/dist/commands/menu.js

@@ -1,86 +1,94 @@
-import { intro, outro, log } from '../ui/output.js';
-import { promptSelect } from '../ui/prompts.js';
-import { detectServers } from '../services/server.js';
-import { loadPid, isAlive } from '../services/process.js';
-import { t } from '../i18n/index.js';
-/** Menu interactif racine, contextuel à l'état du serveur. */
-export async function runMenu() {
-    const servers = detectServers();
-    const hasServer = servers.length > 0;
-    const pid = await loadPid();
-    const running = pid !== null && isAlive(pid.pid);
-    intro(`⚡ ${t('menu.title')}`);
-    if (running)
-        log.info(t('menu.statusRunning', String(pid.pid)));
-    else if (hasServer)
-        log.info(t('menu.statusStopped'));
-    else
-        log.warn(t('menu.statusNoServer'));
-    const options = [];
-    if (!hasServer)
-        options.push({ value: 'create', label: t('menu.create') });
-    if (hasServer && !running)
-        options.push({ value: 'start', label: t('menu.start') });
-    if (running)
-        options.push({ value: 'stop', label: t('menu.stop') });
-    if (hasServer) {
-        options.push({ value: 'plugins', label: t('menu.plugins') });
-        options.push({ value: 'update', label: t('menu.update') });
-        options.push({ value: 'backup', label: t('menu.backup') });
-    }
-    options.push({ value: 'doctor', label: t('menu.doctor') });
-    options.push({ value: 'info', label: t('menu.info') });
-    options.push({ value: 'lang', label: t('menu.lang') });
-    options.push({ value: 'quit', label: t('menu.quit') });
-    const choice = await promptSelect(t('menu.prompt'), options);
-    switch (choice) {
-        case 'create': {
-            const { initCmd } = await import('./init.js');
-            await initCmd.run({ args: {} });
-            break;
-        }
-        case 'start': {
-            const { runStart } = await import('./start.js');
-            await runStart({});
-            break;
-        }
-        case 'stop': {
-            const { runStop } = await import('./stop.js');
-            await runStop();
-            break;
-        }
-        case 'plugins': {
-            const { installCmd } = await import('./plugin/install.js');
-            await installCmd.run({ args: {} });
-            break;
-        }
-        case 'update': {
-            const { runUpdate } = await import('./update.js');
-            await runUpdate();
-            break;
-        }
-        case 'backup': {
-            const { runBackup } = await import('./backup.js');
-            await runBackup();
-            break;
-        }
-        case 'doctor': {
-            const { doctorCmd } = await import('./doctor.js');
-            await doctorCmd.run({ args: {} });
-            break;
-        }
-        case 'info': {
-            const { infoCmd } = await import('./info.js');
-            await infoCmd.run({ args: {} });
-            break;
-        }
-        case 'lang': {
-            const { langCmd } = await import('./lang.js');
-            await langCmd.run({ args: {} });
-            break;
-        }
-        case 'quit':
-            outro(t('menu.bye'));
-            break;
-    }
-}
+import { intro, outro, log } from '../ui/output.js';
+import { promptSelect, promptText } from '../ui/prompts.js';
+import { resolveServerDir } from '../services/server.js';
+import { loadPid, isAlive } from '../services/process.js';
+import { c } from '../ui/theme.js';
+export async function runMenu() {
+    while (true) {
+        const done = await menuStep();
+        if (done)
+            return;
+        await promptText({ message: "Press enter to return to the menu", placeholder: '' });
+    }
+}
+async function menuStep() {
+    const serverPath = await resolveServerDir();
+    const hasServer = serverPath !== null;
+    const pid = await loadPid();
+    const running = pid !== null && isAlive(pid.pid);
+    intro(c.green(`⚡ ${"PowerNukkitX Menu"}`));
+    if (running)
+        log.info(`Server running (PID ${String(pid.pid)})`);
+    else if (hasServer)
+        log.info("Server stopped");
+    else
+        log.warn("No server detected");
+    const options = [];
+    if (!hasServer)
+        options.push({ value: 'create', label: "Create a server" });
+    if (hasServer && !running)
+        options.push({ value: 'start', label: "Start the server" });
+    if (running)
+        options.push({ value: 'stop', label: "Stop the server" });
+    if (hasServer) {
+        options.push({ value: 'plugins', label: "Manage plugins" });
+        options.push({ value: 'install', label: "Install a plugin" });
+        options.push({ value: 'update', label: "Update the core" });
+        options.push({ value: 'backup', label: "Backup" });
+    }
+    options.push({ value: 'doctor', label: "Diagnostics" });
+    options.push({ value: 'info', label: "Information" });
+    options.push({ value: 'quit', label: "Quit" });
+    const choice = await promptSelect("What do you want to do?", options);
+    switch (choice) {
+        case 'create': {
+            const { initCmd } = await import('./init.js');
+            await initCmd.run({ args: {} });
+            break;
+        }
+        case 'start': {
+            const { runStart } = await import('./start.js');
+            await runStart({});
+            break;
+        }
+        case 'stop': {
+            const { runStop } = await import('./stop.js');
+            await runStop();
+            break;
+        }
+        case 'plugins': {
+            const { installCmd } = await import('./plugin/install.js');
+            await installCmd.run({ args: {} });
+            break;
+        }
+        case 'install': {
+            const { runInstall } = await import('./install.js');
+            await runInstall();
+            break;
+        }
+        case 'update': {
+            const { runUpdate } = await import('./update.js');
+            await runUpdate();
+            break;
+        }
+        case 'backup': {
+            const { runBackup } = await import('./backup.js');
+            await runBackup();
+            break;
+        }
+        case 'doctor': {
+            const { doctorCmd } = await import('./doctor.js');
+            await doctorCmd.run({ args: {} });
+            break;
+        }
+        case 'info': {
+            const { infoCmd } = await import('./info.js');
+            await infoCmd.run({ args: {} });
+            break;
+        }
+        case 'quit':
+            outro("See you soon!");
+            return true;
+    }
+    return false;
+}

package/dist/commands/plugin/index.d.ts

@@ -1,2 +1,2 @@
-import type { CommandDef } from 'citty';
-export declare const pluginCmd: CommandDef;
+import type { CommandDef } from 'citty';
+export declare const pluginCmd: CommandDef;