ysk-server-core 1.0.0

package/dist/hosting/runtime-latest.js

@@ -0,0 +1,180 @@
+/**
+ * Optional remote "latest" hints for runtimes (best-effort, cached on disk).
+ * Does not block install UI — panel supported list remains SSOT for install targets.
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+const CACHE_TTL_MS = 24 * 60 * 60 * 1000;
+function readCache(dataDir) {
+    const p = join(dataDir, 'cache', 'runtime-latest.json');
+    try {
+        if (!existsSync(p))
+            return { at: 0, byKind: {} };
+        const j = JSON.parse(readFileSync(p, 'utf8'));
+        return j?.byKind ? j : { at: 0, byKind: {} };
+    }
+    catch {
+        return { at: 0, byKind: {} };
+    }
+}
+function writeCache(dataDir, cache) {
+    try {
+        const dir = join(dataDir, 'cache');
+        mkdirSync(dir, { recursive: true });
+        writeFileSync(join(dir, 'runtime-latest.json'), JSON.stringify(cache, null, 2));
+    }
+    catch {
+        /* ignore */
+    }
+}
+function cmpVer(a, b) {
+    const na = a.replace(/^v/i, '').toLowerCase();
+    const nb = b.replace(/^v/i, '').toLowerCase();
+    if (na === 'latest' || na === 'stable')
+        return 1;
+    if (nb === 'latest' || nb === 'stable')
+        return -1;
+    const pa = na.split(/[.+_-]/).map((x) => parseInt(x, 10) || 0);
+    const pb = nb.split(/[.+_-]/).map((x) => parseInt(x, 10) || 0);
+    for (let i = 0; i < Math.max(pa.length, pb.length); i++) {
+        const d = (pa[i] ?? 0) - (pb[i] ?? 0);
+        if (d)
+            return d;
+    }
+    return 0;
+}
+async function fetchText(url, timeoutMs = 8_000) {
+    try {
+        const ac = new AbortController();
+        const t = setTimeout(() => ac.abort(), timeoutMs);
+        const res = await fetch(url, {
+            signal: ac.signal,
+            headers: { 'User-Agent': 'ysk-server-runtime-latest/1' },
+        });
+        clearTimeout(t);
+        if (!res.ok)
+            return null;
+        return await res.text();
+    }
+    catch {
+        return null;
+    }
+}
+async function fetchJson(url) {
+    const t = await fetchText(url);
+    if (!t)
+        return null;
+    try {
+        return JSON.parse(t);
+    }
+    catch {
+        return null;
+    }
+}
+/** Fetch remote latest string for a kind (best-effort). */
+export async function fetchRemoteLatest(kind) {
+    if (kind === 'node') {
+        // index.json is large; use latest-v22.x SHASUMS header path or dist/index
+        const j = (await fetchJson('https://nodejs.org/dist/index.json'));
+        if (Array.isArray(j) && j[0]?.version) {
+            const lts = j.find((x) => x.lts);
+            const ver = (lts?.version || j[0].version || '').replace(/^v/, '');
+            const major = ver.split('.')[0];
+            return { remote: major || ver, source: 'nodejs.org/dist/index.json' };
+        }
+    }
+    if (kind === 'php') {
+        // no single JSON; skip remote
+        return null;
+    }
+    if (kind === 'go') {
+        const j = (await fetchJson('https://go.dev/dl/?mode=json'));
+        if (Array.isArray(j)) {
+            const st = j.find((x) => x.stable) || j[0];
+            const v = (st?.version || '').replace(/^go/, '');
+            // panel uses 1.22 style
+            const m = v.match(/^(\d+\.\d+)/);
+            return m ? { remote: m[1], source: 'go.dev/dl' } : null;
+        }
+    }
+    if (kind === 'rust') {
+        return { remote: 'stable', source: 'rustup (channel)' };
+    }
+    if (kind === 'java') {
+        return { remote: '21', source: 'panel-default LTS' };
+    }
+    if (kind === 'kotlin') {
+        const t = await fetchText('https://api.github.com/repos/JetBrains/kotlin/releases/latest');
+        if (t) {
+            try {
+                const j = JSON.parse(t);
+                const v = (j.tag_name || '').replace(/^v/, '');
+                if (v)
+                    return { remote: v, source: 'github.com/JetBrains/kotlin' };
+            }
+            catch {
+                /* */
+            }
+        }
+    }
+    if (kind === 'bun') {
+        const t = await fetchText('https://api.github.com/repos/oven-sh/bun/releases/latest');
+        if (t) {
+            try {
+                const j = JSON.parse(t);
+                const v = (j.tag_name || '').replace(/^bun-v/, '').replace(/^v/, '');
+                if (v)
+                    return { remote: v, source: 'github.com/oven-sh/bun' };
+            }
+            catch {
+                /* */
+            }
+        }
+    }
+    if (kind === 'python') {
+        return null;
+    }
+    return null;
+}
+/**
+ * Build latest hint for UI: compare panel supported max vs cached remote.
+ */
+export async function getRuntimeLatestHint(input) {
+    const notes = [];
+    const panelLatest = input.panelSupported.length === 0
+        ? '—'
+        : input.panelSupported.reduce((a, b) => (cmpVer(a, b) >= 0 ? a : b));
+    const cache = readCache(input.dataDir);
+    const fresh = Date.now() - cache.at < CACHE_TTL_MS && !input.refresh;
+    let remote = cache.byKind[input.kind];
+    if (!fresh || !remote) {
+        const got = await fetchRemoteLatest(input.kind);
+        if (got) {
+            cache.byKind[input.kind] = got;
+            cache.at = Date.now();
+            writeCache(input.dataDir, cache);
+            remote = got;
+            notes.push('fetched remote latest');
+        }
+        else {
+            notes.push('remote latest unavailable');
+        }
+    }
+    else {
+        notes.push('cache hit');
+    }
+    const remoteLatest = remote?.remote;
+    const newerThanPanel = remoteLatest && panelLatest !== '—'
+        ? cmpVer(remoteLatest, panelLatest) > 0
+        : undefined;
+    return {
+        kind: input.kind,
+        panelLatest,
+        remoteLatest,
+        newerThanPanel,
+        source: remote?.source,
+        fetchedAt: cache.at ? new Date(cache.at).toISOString() : undefined,
+        notes,
+    };
+}
+//# sourceMappingURL=runtime-latest.js.map

package/dist/hosting/runtime-latest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-latest.js","sourceRoot":"","sources":["../../src/hosting/runtime-latest.ts"],"names":[],"mappings":"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"}

package/dist/hosting/runtime-panel-defaults.d.ts

@@ -0,0 +1,7 @@
+import type { RuntimeKind } from './runtime.js';
+export type PanelRuntimeDefaults = Partial<Record<RuntimeKind, string>>;
+export declare function loadPanelRuntimeDefaults(dataDir: string): PanelRuntimeDefaults;
+export declare function savePanelRuntimeDefault(dataDir: string, kind: RuntimeKind, version: string): PanelRuntimeDefaults;
+/** Prefer panel default, then hard-coded fallback. */
+export declare function resolvePanelRuntimeVersion(dataDir: string | undefined, kind: string): string;
+//# sourceMappingURL=runtime-panel-defaults.d.ts.map

package/dist/hosting/runtime-panel-defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-panel-defaults.d.ts","sourceRoot":"","sources":["../../src/hosting/runtime-panel-defaults.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAGhD,MAAM,MAAM,oBAAoB,GAAG,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC;AAMxE,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,oBAAoB,CAS9E;AAED,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,WAAW,EACjB,OAAO,EAAE,MAAM,GACd,oBAAoB,CAStB;AAED,sDAAsD;AACtD,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,IAAI,EAAE,MAAM,GACX,MAAM,CAMR"}

package/dist/hosting/runtime-panel-defaults.js

@@ -0,0 +1,43 @@
+/**
+ * Panel-preferred runtime versions (new projects / templates).
+ * Independent of host PATH default (CLI symlink / rustup).
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { defaultRuntimeVersion } from './runtime.js';
+function pathFor(dataDir) {
+    return join(dataDir, 'runtimes', 'panel-defaults.json');
+}
+export function loadPanelRuntimeDefaults(dataDir) {
+    const p = pathFor(dataDir);
+    if (!existsSync(p))
+        return {};
+    try {
+        const raw = JSON.parse(readFileSync(p, 'utf8'));
+        return raw && typeof raw === 'object' ? raw : {};
+    }
+    catch {
+        return {};
+    }
+}
+export function savePanelRuntimeDefault(dataDir, kind, version) {
+    const v = String(version ?? '').trim();
+    if (!v)
+        throw new Error('version required');
+    const dir = join(dataDir, 'runtimes');
+    mkdirSync(dir, { recursive: true });
+    const cur = loadPanelRuntimeDefaults(dataDir);
+    cur[kind] = v;
+    writeFileSync(pathFor(dataDir), JSON.stringify(cur, null, 2) + '\n', 'utf8');
+    return cur;
+}
+/** Prefer panel default, then hard-coded fallback. */
+export function resolvePanelRuntimeVersion(dataDir, kind) {
+    if (dataDir) {
+        const fromPanel = loadPanelRuntimeDefaults(dataDir)[kind];
+        if (fromPanel?.trim())
+            return fromPanel.trim();
+    }
+    return defaultRuntimeVersion(kind);
+}
+//# sourceMappingURL=runtime-panel-defaults.js.map

package/dist/hosting/runtime-panel-defaults.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-panel-defaults.js","sourceRoot":"","sources":["../../src/hosting/runtime-panel-defaults.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAIrD,SAAS,OAAO,CAAC,OAAe;IAC9B,OAAO,IAAI,CAAC,OAAO,EAAE,UAAU,EAAE,qBAAqB,CAAC,CAAC;AAC1D,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,OAAe;IACtD,MAAM,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3B,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;QAAE,OAAO,EAAE,CAAC;IAC9B,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,EAAE,MAAM,CAAC,CAAyB,CAAC;QACxE,OAAO,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IACnD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,uBAAuB,CACrC,OAAe,EACf,IAAiB,EACjB,OAAe;IAEf,MAAM,CAAC,GAAG,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACvC,IAAI,CAAC,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC;IAC5C,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IACtC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACpC,MAAM,GAAG,GAAG,wBAAwB,CAAC,OAAO,CAAC,CAAC;IAC9C,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACd,aAAa,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,MAAM,CAAC,CAAC;IAC7E,OAAO,GAAG,CAAC;AACb,CAAC;AAED,sDAAsD;AACtD,MAAM,UAAU,0BAA0B,CACxC,OAA2B,EAC3B,IAAY;IAEZ,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,SAAS,GAAG,wBAAwB,CAAC,OAAO,CAAC,CAAC,IAAmB,CAAC,CAAC;QACzE,IAAI,SAAS,EAAE,IAAI,EAAE;YAAE,OAAO,SAAS,CAAC,IAAI,EAAE,CAAC;IACjD,CAAC;IACD,OAAO,qBAAqB,CAAC,IAAI,CAAC,CAAC;AACrC,CAAC"}

package/dist/hosting/runtime-plugins.d.ts

@@ -0,0 +1,164 @@
+/**
+ * Companion tools / plugins for language runtimes (Node PM2, Python poetry, …).
+ * PHP apt extensions stay in php-extensions.ts; this catalog covers all kinds
+ * with a shared UI multi-select model.
+ */
+import type { RuntimeKind } from './runtime.js';
+export type RuntimePluginInstaller = 'npm-global' | 'apt' | 'pip'
+/** Official Poetry installer (avoids PEP 668 / bare pip on Ubuntu) */
+ | 'poetry-official' | 'go-install' | 'cargo-install' | 'rustup-component' | 'sdkman' | 'none';
+export type RuntimePluginSpec = {
+    id: string;
+    kind: RuntimeKind;
+    label: string;
+    hint?: string;
+    group?: string;
+    recommended?: boolean;
+    /** Always applied with runtime (not shown as optional, or shown locked) */
+    required?: boolean;
+    installer: RuntimePluginInstaller;
+    npmPackages?: string[];
+    aptPackages?: string[];
+    pipPackages?: string[];
+    /** e.g. github.com/air-verse/air@latest */
+    goModules?: string[];
+    cargoCrates?: string[];
+    /** rustup component add … */
+    rustupComponents?: string[];
+    /** bins used for “already installed” probe hints */
+    bins?: string[];
+};
+/**
+ * Curated hosting-oriented tools per runtime.
+ * Ids are stable API values sent as `plugins: string[]` on install.
+ */
+export declare const RUNTIME_PLUGINS: RuntimePluginSpec[];
+export declare function listRuntimePlugins(kind: RuntimeKind): RuntimePluginSpec[];
+export declare function defaultRuntimePluginIds(kind: RuntimeKind): string[];
+export declare function resolveRuntimePlugins(kind: RuntimeKind, pluginIds?: string[] | null): {
+    plugins: RuntimePluginSpec[];
+    ids: string[];
+};
+/**
+ * Bash lines appended to runtime install.sh (best-effort; do not fail whole install).
+ */
+export declare function buildRuntimePluginScriptLines(kind: RuntimeKind, pluginIds?: string[] | null): {
+    lines: string[];
+    ids: string[];
+    labels: string[];
+};
+/**
+ * Bash lines to uninstall companion tools (best-effort reverse of install).
+ * Skips `required` plugins. Caller should only pass ids the user confirmed.
+ */
+export declare function buildRuntimePluginUninstallScriptLines(kind: RuntimeKind, pluginIds: string[] | null | undefined): {
+    lines: string[];
+    ids: string[];
+    labels: string[];
+};
+export type RuntimePluginUninstallResult = {
+    ok: boolean;
+    kind: RuntimeKind;
+    notes: string[];
+    pluginIds: string[];
+    blocked?: boolean;
+    blockMessage?: string;
+    requiresExecute?: boolean;
+    requiresRoot?: boolean;
+};
+export type RuntimePluginInstallResult = RuntimePluginUninstallResult;
+/**
+ * Install companion plugins only (no full runtime tarball/apt stack).
+ */
+export declare function installRuntimePlugins(input: {
+    dataDir: string;
+    host: {
+        executeEnabled: () => boolean;
+        isRoot: () => boolean;
+        runCommand: (argv: string[], opts?: {
+            timeoutMs?: number;
+            onChunk?: (c: {
+                stream: 'stdout' | 'stderr';
+                text: string;
+            }) => void;
+            signal?: AbortSignal;
+        }) => Promise<{
+            exitCode: number;
+            stdout: string;
+            stderr: string;
+        }>;
+    };
+    kind: RuntimeKind;
+    plugins: string[];
+    onLog?: (ev: {
+        stream: 'stdout' | 'stderr';
+        line: string;
+    }) => void;
+    abortSignal?: AbortSignal;
+}): Promise<RuntimePluginInstallResult>;
+/**
+ * Uninstall selected companion plugins on the host (root + execute).
+ */
+export declare function uninstallRuntimePlugins(input: {
+    dataDir: string;
+    host: {
+        executeEnabled: () => boolean;
+        isRoot: () => boolean;
+        runCommand: (argv: string[], opts?: {
+            timeoutMs?: number;
+        }) => Promise<{
+            exitCode: number;
+            stdout: string;
+            stderr: string;
+        }>;
+    };
+    kind: RuntimeKind;
+    plugins: string[];
+}): Promise<RuntimePluginUninstallResult>;
+/** API / UI DTO (sync; installed flags filled by async probe helper) */
+export declare function runtimePluginsCatalogDto(kind: RuntimeKind): {
+    kind: RuntimeKind;
+    plugins: {
+        id: string;
+        label: string;
+        hint: string | undefined;
+        group: string | undefined;
+        recommended: boolean;
+        required: boolean;
+        installer: RuntimePluginInstaller;
+        bins: string[];
+        installed: boolean;
+    }[];
+    defaults: string[];
+};
+/** Shell PATH prefix shared by install scripts and probe (cargo/rustup homes). */
+export declare function pluginProbePathExport(): string;
+/**
+ * Probe which plugins already exist.
+ * - bins: command -v with cargo/rustup PATH
+ * - rustup-component: also `rustup component list --installed`
+ * Defaults = recommended && !installed.
+ */
+export declare function runtimePluginsCatalogWithProbe(kind: RuntimeKind, host: {
+    runCommand: (argv: string[], opts?: {
+        timeoutMs?: number;
+    }) => Promise<{
+        exitCode: number;
+        stdout: string;
+    }>;
+}): Promise<{
+    kind: RuntimeKind;
+    plugins: {
+        installed: boolean;
+        id: string;
+        label: string;
+        hint: string | undefined;
+        group: string | undefined;
+        recommended: boolean;
+        required: boolean;
+        installer: RuntimePluginInstaller;
+        bins: string[];
+    }[];
+    defaults: string[];
+}>;
+//# sourceMappingURL=runtime-plugins.d.ts.map

package/dist/hosting/runtime-plugins.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-plugins.d.ts","sourceRoot":"","sources":["../../src/hosting/runtime-plugins.ts"],"names":[],"mappings":"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"}