@powernukkitx/cli 0.0.2 → 1.0.0

package/dist/commands/plugin/info.js

@@ -0,0 +1,40 @@
+import { defineCommand } from 'citty';
+import { intro, outro, log, spin } from '../../ui/output.js';
+import { c } from '../../ui/theme.js';
+import { promptText } from '../../ui/prompts.js';
+import { getPluginDetail } from '../../services/plugins.js';
+import { t } from '../../i18n/index.js';
+export const infoCmd = defineCommand({
+    meta: { description: 'Show plugin details' },
+    args: { slug: { type: 'positional', description: 'Plugin slug', required: false } },
+    async run({ args }) {
+        const slug = args.slug ?? await promptText({ message: t('plugin.slugPrompt') });
+        const sp = spin(slug);
+        try {
+            const d = await getPluginDetail(slug);
+            sp.stop(d.name);
+            intro(`📖 ${d.name}`);
+            if (d.description)
+                log.dim(d.description);
+            log.info(`Author:    ${c.accent(d.author)}`);
+            log.info(`Version:   ${c.green(d.latest_version)}`);
+            log.info(`Downloads: ${c.cyan(d.downloads >= 1000 ? (d.downloads / 1000).toFixed(1) + 'k' : String(d.downloads))}`);
+            log.info(`Updated:   ${new Date(d.updated_at).toLocaleDateString()}`);
+            if (d.tags.length)
+                log.info(`Tags: ${d.tags.map(tag => c.cyan(tag)).join(', ')}`);
+            if (d.repository_url)
+                log.info(`Repo: ${c.blue(d.repository_url)}`);
+            if (d.releases.length) {
+                log.step(t('plugin.versionsAvailable'));
+                for (const r of d.releases.slice(0, 5)) {
+                    const stable = r.is_stable ? c.green('●') : c.dim('○');
+                    log.raw(`  ${stable} v${r.version}  ${c.dim(new Date(r.created_at).toLocaleDateString())}`);
+                }
+            }
+            outro('');
+        }
+        catch {
+            sp.fail(t('plugin.notFound', slug));
+        }
+    },
+});

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

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

package/dist/commands/plugin/install.js

@@ -0,0 +1,57 @@
+import { join } from 'node:path';
+import { defineCommand } from 'citty';
+import { intro, outro, log, spin, progress } from '../../ui/output.js';
+import { promptMulti } from '../../ui/prompts.js';
+import { resolveServerDir } from '../../services/server.js';
+import { searchPlugins, installPlugin, installFromUrl } from '../../services/plugins.js';
+import { t } from '../../i18n/index.js';
+export const installCmd = defineCommand({
+    meta: { description: 'Install plugins' },
+    args: { names: { type: 'positional', description: 'Plugin slugs or .jar URLs', required: false } },
+    async run({ args }) {
+        const serverPath = (await resolveServerDir()) ?? '.';
+        const pluginsDir = join(serverPath, 'plugins');
+        let names = args.names ? [args.names] : [];
+        if (names.length === 0) {
+            intro(`📦 ${t('plugin.titleInstall')}`);
+            const sp = spin(t('plugin.fetching'));
+            const resp = await searchPlugins({ sort: 'stars', limit: 50 });
+            sp.stop(`${resp.plugins.length} plugins`);
+            names = await promptMulti(t('plugin.selectInstall'), resp.plugins.map(p => ({ value: p.slug, label: p.name, hint: p.description })));
+            if (names.length === 0) {
+                log.info(t('plugin.noneSelected'));
+                return;
+            }
+        }
+        intro(`📦 ${t('plugin.titleInstall')}`);
+        for (const name of names) {
+            if (name.startsWith('http://') || name.startsWith('https://')) {
+                try {
+                    const file = await installFromUrl(name, pluginsDir, (pct, f) => progress(pct, f));
+                    log.success(t('plugin.installSuccess', file));
+                }
+                catch {
+                    log.error(t('plugin.urlInvalid'));
+                }
+                continue;
+            }
+            const sp = spin(name);
+            try {
+                const entry = await installPlugin(name, pluginsDir, (pct, f) => progress(pct, f));
+                sp.stop(`${entry.name} v${entry.version}`);
+                log.success(t('plugin.installSuccess', entry.name));
+            }
+            catch (e) {
+                const msg = e.message;
+                if (msg.startsWith('no-release'))
+                    sp.fail(t('plugin.noRelease', name));
+                else if (msg.startsWith('no-file'))
+                    sp.fail(t('plugin.noFile', name));
+                else
+                    sp.fail(t('plugin.installError', name));
+            }
+        }
+        log.info(t('plugin.restartHint'));
+        outro('');
+    },
+});

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

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

package/dist/commands/plugin/installed.js

@@ -0,0 +1,42 @@
+import { existsSync } from 'node:fs';
+import { readdir } from 'node:fs/promises';
+import { join } from 'node:path';
+import { defineCommand } from 'citty';
+import { intro, outro, log, isJson, json } from '../../ui/output.js';
+import { c } from '../../ui/theme.js';
+import { resolveServerDir } from '../../services/server.js';
+import { getInstalled } from '../../services/plugins.js';
+import { t } from '../../i18n/index.js';
+export const installedCmd = defineCommand({
+    meta: { description: 'List installed plugins' },
+    args: {},
+    async run() {
+        const serverPath = await resolveServerDir();
+        const pluginsDir = serverPath ? join(serverPath, 'plugins') : 'plugins';
+        if (!existsSync(pluginsDir)) {
+            if (isJson())
+                json({ plugins: [] });
+            log.warn(t('plugin.noPluginsDir'));
+            return;
+        }
+        const jars = (await readdir(pluginsDir)).filter(f => f.endsWith('.jar'));
+        if (isJson())
+            json({ plugins: jars.map(j => ({ file: j })) });
+        intro(`📁 ${t('plugin.titleInstalled')}`);
+        if (jars.length === 0) {
+            log.warn(t('plugin.noPlugins'));
+            return;
+        }
+        const tracked = await getInstalled();
+        for (const j of jars) {
+            const meta = tracked.find(p => p.fileName === j);
+            if (meta)
+                log.raw(`  ${c.accent('●')} ${c.bold(meta.name)}  ${c.dim('v' + meta.version)}`);
+            else
+                log.raw(`  ${c.dim('○')} ${j.replace('.jar', '')}`);
+        }
+        log.info(t('plugin.count', String(jars.length)));
+        log.info(t('plugin.restartHint'));
+        outro('');
+    },
+});

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

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

package/dist/commands/plugin/list.js

@@ -0,0 +1,49 @@
+import { defineCommand } from 'citty';
+import { intro, outro, log, spin, isJson, json } from '../../ui/output.js';
+import { c } from '../../ui/theme.js';
+import { searchPlugins } from '../../services/plugins.js';
+import { t } from '../../i18n/index.js';
+function stars(n) {
+    const full = '★'.repeat(Math.min(Math.floor(n / 10), 5));
+    const empty = '☆'.repeat(5 - full.length);
+    return (n >= 50 ? c.yellow : c.dim)(full + empty);
+}
+function dl(n) { return n >= 1000 ? `${(n / 1000).toFixed(1)}k` : String(n); }
+/** Rendu partagé (utilisé par `list` et `search`). */
+export async function renderList(params) {
+    const sp = spin(t('plugin.fetching'));
+    try {
+        const resp = await searchPlugins(params);
+        sp.stop(`${resp.plugins.length} plugins`);
+        if (isJson())
+            json({ plugins: resp.plugins, count: resp.count });
+        intro(`📋 ${t('plugin.titleList')}`);
+        for (const p of resp.plugins) {
+            log.raw(`  ${c.accent.bold(p.name)}  ${c.dim('by ' + p.author)}  ${stars(p.stars)}  ${c.cyan(dl(p.downloads) + ' dl')}  ${c.dim('v' + p.version)}`);
+            if (p.description)
+                log.raw(`    ${c.dim(p.description)}`);
+            log.raw(`    ${c.dim('→')} ${c.blue('pnx plugin install ' + p.slug)}\n`);
+        }
+        if (resp.count > resp.plugins.length)
+            log.info(`${resp.plugins.length}/${resp.count}`);
+        outro('');
+    }
+    catch (e) {
+        sp.fail(t('plugin.fetchError', e.message));
+    }
+}
+export const listCmd = defineCommand({
+    meta: { description: 'List available plugins' },
+    args: {
+        sort: { type: 'string', description: 'Sort: newest|updated|stars' },
+        limit: { type: 'string', description: 'Results per page', default: '20' },
+        page: { type: 'string', description: 'Page number', default: '1' },
+        query: { type: 'string', description: 'Search query' },
+    },
+    run: ({ args }) => renderList({
+        sort: args.sort,
+        limit: parseInt(args.limit),
+        page: parseInt(args.page),
+        q: args.query,
+    }),
+});

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

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

package/dist/commands/plugin/remove.js

@@ -0,0 +1,45 @@
+import { existsSync } from 'node:fs';
+import { readdir, rm } from 'node:fs/promises';
+import { join } from 'node:path';
+import { defineCommand } from 'citty';
+import { intro, outro, log } from '../../ui/output.js';
+import { promptMulti, promptConfirm } from '../../ui/prompts.js';
+import { resolveServerDir } from '../../services/server.js';
+import { removeInstalled } from '../../services/plugins.js';
+import { t } from '../../i18n/index.js';
+export const removeCmd = defineCommand({
+    meta: { description: 'Remove installed plugins' },
+    args: { names: { type: 'positional', description: 'Plugin names', required: false } },
+    async run({ args }) {
+        const serverPath = (await resolveServerDir()) ?? '.';
+        const pluginsDir = join(serverPath, 'plugins');
+        if (!existsSync(pluginsDir)) {
+            log.error(t('plugin.noPluginsDir'));
+            return;
+        }
+        const jars = (await readdir(pluginsDir)).filter(f => f.endsWith('.jar'));
+        if (jars.length === 0) {
+            log.warn(t('plugin.noPlugins'));
+            return;
+        }
+        let names = args.names ? [args.names] : [];
+        if (names.length === 0) {
+            names = await promptMulti(t('plugin.selectRemove'), jars.map(j => ({ value: j, label: j.replace('.jar', '') })));
+        }
+        intro(`🗑️ ${t('plugin.titleRemove')}`);
+        for (const name of names) {
+            const target = name.endsWith('.jar') ? name : `${name}.jar`;
+            const found = jars.find(j => j.toLowerCase() === target.toLowerCase());
+            if (!found) {
+                log.warn(t('plugin.notFound', name));
+                continue;
+            }
+            if (await promptConfirm(t('plugin.removeConfirm', found), false)) {
+                await rm(join(pluginsDir, found));
+                await removeInstalled(found.replace('.jar', ''));
+                log.success(t('plugin.removed', found));
+            }
+        }
+        outro('');
+    },
+});

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

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

package/dist/commands/plugin/search.js

@@ -0,0 +1,12 @@
+import { defineCommand } from 'citty';
+import { promptText } from '../../ui/prompts.js';
+import { renderList } from './list.js';
+import { t } from '../../i18n/index.js';
+export const searchCmd = defineCommand({
+    meta: { description: 'Search plugins' },
+    args: { term: { type: 'positional', description: 'Search term', required: false } },
+    async run({ args }) {
+        const term = args.term ?? await promptText({ message: t('plugin.searchPrompt') });
+        await renderList({ q: term, limit: 20, page: 1 });
+    },
+});

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

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

package/dist/commands/plugin/update.js

@@ -0,0 +1,53 @@
+import { existsSync } from 'node:fs';
+import { readdir } from 'node:fs/promises';
+import { join } from 'node:path';
+import { defineCommand } from 'citty';
+import { intro, outro, log, spin, progress } from '../../ui/output.js';
+import { promptMulti } from '../../ui/prompts.js';
+import { resolveServerDir } from '../../services/server.js';
+import { getInstalled, updatePlugin } from '../../services/plugins.js';
+import { t } from '../../i18n/index.js';
+export const updateCmd = defineCommand({
+    meta: { description: 'Update installed plugins' },
+    args: { names: { type: 'positional', description: 'Plugin slugs', required: false } },
+    async run({ args }) {
+        const serverPath = (await resolveServerDir()) ?? '.';
+        const pluginsDir = join(serverPath, 'plugins');
+        if (!existsSync(pluginsDir)) {
+            log.error(t('plugin.noPluginsDir'));
+            return;
+        }
+        const jars = (await readdir(pluginsDir)).filter(f => f.endsWith('.jar'));
+        let names = args.names ? [args.names] : [];
+        if (names.length === 0) {
+            names = await promptMulti(t('plugin.selectUpdate'), jars.map(j => ({ value: j.replace('.jar', ''), label: j.replace('.jar', '') })));
+        }
+        intro(`🔄 ${t('plugin.titleUpdate')}`);
+        const tracked = await getInstalled();
+        for (const slug of names) {
+            const sp = spin(slug);
+            try {
+                const meta = tracked.find(p => p.slug === slug);
+                const existingJar = jars.find(j => j.toLowerCase().startsWith(slug.toLowerCase()));
+                const entry = await updatePlugin(slug, pluginsDir, meta?.version, existingJar, (pct, f) => progress(pct, f));
+                if (!entry) {
+                    sp.stop(t('plugin.alreadyLatest', slug, meta?.version ?? '?'));
+                    continue;
+                }
+                sp.stop(`${entry.name} v${entry.version}`);
+                log.success(t('plugin.updated', entry.name, entry.version));
+            }
+            catch (e) {
+                const msg = e.message;
+                if (msg.startsWith('no-release'))
+                    sp.fail(t('plugin.noRelease', slug));
+                else if (msg.startsWith('no-file'))
+                    sp.fail(t('plugin.noFile', slug));
+                else
+                    sp.fail(t('plugin.installError', slug));
+            }
+        }
+        log.info(t('plugin.restartHint'));
+        outro('');
+    },
+});

package/dist/commands/plugin.d.ts

@@ -1,12 +1 @@
-export declare function pluginListCmd(options?: {
-    sort?: string;
-    limit?: number;
-    page?: number;
-    q?: string;
-}): Promise<void>;
-export declare function pluginSearchCmd(term?: string): Promise<void>;
-export declare function pluginInfoCmd(slug?: string): Promise<void>;
-export declare function pluginInstallCmd(names: string[]): Promise<void>;
-export declare function pluginInstalledCmd(): Promise<void>;
-export declare function pluginRemoveCmd(names: string[]): Promise<void>;
-export declare function pluginUpdateCmd(names: string[]): Promise<void>;
+export {};