ysk-server-core 1.0.0

package/dist/hosting/software-catalog.js

@@ -0,0 +1,380 @@
+import { tl } from 'ysk-server-shared';
+/** Resolve display title under current request locale. */
+export function resolveSoftwareTitle(spec) {
+    const catalogKey = `catalog.sw.${spec.id.replace(/-/g, '_')}`;
+    const fromCatalog = tl(catalogKey);
+    // tl returns key itself when missing — prefer catalog when translated
+    if (fromCatalog && fromCatalog !== catalogKey)
+        return fromCatalog;
+    if (spec.titleKey)
+        return tl(spec.titleKey);
+    return spec.title;
+}
+/**
+ * Static catalog — never call tl() when building this array (module-load freezes default locale).
+ */
+export const SOFTWARE_CATALOG = [
+    {
+        id: 'vsftpd',
+        title: 'vsftpd (FTPS)',
+        bins: ['vsftpd'],
+        aptPackages: ['vsftpd'],
+        units: ['vsftpd'],
+        features: ['ftp'],
+        impactKeys: ['ftp']
+    },
+    {
+        id: 'db-util',
+        title: 'db-util (FTP user DB)',
+        titleKey: 'notes.auto.n0248',
+        bins: ['db_load'],
+        aptPackages: ['db-util'],
+        features: ['ftp']
+    },
+    {
+        id: 'nginx',
+        title: 'Nginx',
+        bins: ['nginx'],
+        aptPackages: ['nginx'],
+        units: ['nginx'],
+        dataPaths: ['/var/cache/nginx', '/var/log/nginx'],
+        impactKeys: ['sitesDown', 'reverseProxy'],
+        features: ['nginx']
+    },
+    {
+        id: 'apache2',
+        title: 'Apache HTTP Server',
+        bins: ['apache2', 'apache2ctl', 'httpd'],
+        aptPackages: ['apache2'],
+        units: ['apache2', 'httpd'],
+        dataPaths: ['/var/log/apache2', '/var/log/httpd'],
+        impactKeys: ['phpBackend', 'sitesDown'],
+        features: ['apache']
+    },
+    {
+        id: 'certbot',
+        title: 'Certbot (Let’s Encrypt)',
+        bins: ['certbot'],
+        aptPackages: ['certbot', 'python3-certbot-nginx'],
+        features: ['ssl']
+    },
+    {
+        id: 'mysql-client',
+        title: 'MySQL/MariaDB client',
+        titleKey: 'notes.auto.n0136',
+        // Ubuntu/Debian often ship `mariadb` client; older installs still use `mysql`
+        bins: ['mysql', 'mariadb'],
+        aptPackages: ['mariadb-client', 'default-mysql-client', 'mysql-client'],
+        features: ['mysql', 'mariadb']
+    },
+    {
+        id: 'mysql-server',
+        title: 'MySQL server',
+        titleKey: 'notes.auto.n0135',
+        bins: ['mysqld'],
+        aptPackages: ['mysql-server'],
+        units: ['mysql'],
+        features: ['mysql'],
+        dataPaths: ['/var/lib/mysql'],
+        impactKeys: ['database', 'dataLossPurge']
+    },
+    {
+        id: 'mariadb-server',
+        title: 'MariaDB server',
+        titleKey: 'notes.auto.n0133',
+        // Some releases only expose mariadbd; others still provide mysqld symlink
+        bins: ['mariadbd', 'mysqld'],
+        aptPackages: ['mariadb-server'],
+        units: ['mariadb'],
+        features: ['mariadb'],
+        dataPaths: ['/var/lib/mysql'],
+        impactKeys: ['database', 'dataLossPurge']
+    },
+    {
+        id: 'postgresql-client',
+        title: 'PostgreSQL client',
+        titleKey: 'notes.auto.n0159',
+        bins: ['psql'],
+        aptPackages: ['postgresql-client'],
+        features: ['postgres']
+    },
+    {
+        id: 'postgresql',
+        title: 'PostgreSQL server',
+        titleKey: 'notes.auto.n0157',
+        bins: ['postgres'],
+        aptPackages: ['postgresql'],
+        units: ['postgresql'],
+        features: ['postgres'],
+        dataPaths: ['/var/lib/postgresql'],
+        impactKeys: ['database', 'dataLossPurge']
+    },
+    {
+        id: 'redis-tools',
+        title: 'Redis client',
+        titleKey: 'notes.auto.n0174',
+        bins: ['redis-cli'],
+        aptPackages: ['redis-tools'],
+        features: ['redis']
+    },
+    {
+        id: 'redis-server',
+        title: 'Redis server',
+        titleKey: 'notes.auto.n0171',
+        bins: ['redis-server'],
+        aptPackages: ['redis-server'],
+        units: ['redis-server'],
+        features: ['redis'],
+        dataPaths: ['/var/lib/redis'],
+        impactKeys: ['cache']
+    },
+    {
+        id: 'ufw',
+        title: 'UFW firewall',
+        titleKey: 'notes.auto.n0017',
+        bins: ['ufw'],
+        aptPackages: ['ufw'],
+        features: ['firewall'],
+        impactKeys: ['firewall']
+    },
+    {
+        id: 'fail2ban',
+        title: 'fail2ban',
+        bins: ['fail2ban-client'],
+        aptPackages: ['fail2ban'],
+        units: ['fail2ban'],
+        features: ['fail2ban'],
+        impactKeys: ['intrusion']
+    },
+    {
+        id: 'postfix',
+        title: 'Postfix',
+        bins: ['postfix'],
+        aptPackages: ['postfix'],
+        units: ['postfix'],
+        features: ['email'],
+        dataPaths: ['/var/spool/postfix'],
+        impactKeys: ['mailOutbound', 'mailQueue']
+    },
+    {
+        id: 'dovecot',
+        title: 'Dovecot',
+        bins: ['dovecot'],
+        aptPackages: ['dovecot-core', 'dovecot-imapd'],
+        units: ['dovecot'],
+        features: ['email'],
+        dataPaths: ['/var/mail'],
+        impactKeys: ['mailInbound']
+    },
+    {
+        id: 'opendkim',
+        title: 'OpenDKIM',
+        bins: ['opendkim'],
+        aptPackages: ['opendkim', 'opendkim-tools'],
+        units: ['opendkim'],
+        features: ['email'],
+        impactKeys: ['mailDkim']
+    },
+    {
+        id: 'pdns-server',
+        title: 'PowerDNS',
+        bins: ['pdns_server', 'pdnsutil'],
+        aptPackages: ['pdns-server', 'pdns-backend-bind'],
+        units: ['pdns'],
+        features: ['dns'],
+        impactKeys: ['dns']
+    },
+    {
+        id: 'git',
+        title: 'Git',
+        bins: ['git'],
+        aptPackages: ['git'],
+        // 'all' = included in full-catalog install only — never auto-attached to
+        // every feature uninstall via listSoftwareForFeature(feature).
+        features: ['git', 'all'],
+        uninstallProtected: true,
+        impactKeys: ['controlPlane'],
+    },
+    {
+        id: 'node',
+        title: 'Node.js',
+        bins: ['node'],
+        aptPackages: [],
+        features: ['node'],
+        installer: 'runtime-node',
+        runtimeVersion: '20',
+        dataPaths: ['/usr/local/ysk/node'],
+        impactKeys: ['runtimeStack'],
+    },
+    {
+        id: 'pm2',
+        title: 'PM2',
+        bins: ['pm2'],
+        aptPackages: [],
+        npmPackages: ['pm2'],
+        features: ['node'],
+        installer: 'npm-global',
+        impactKeys: ['runtimeStack'],
+    },
+    {
+        id: 'php',
+        title: 'PHP',
+        bins: ['php'],
+        aptPackages: [],
+        features: ['php'],
+        installer: 'runtime-php',
+        runtimeVersion: '8.3',
+        impactKeys: ['phpBackend', 'runtimeStack'],
+    },
+    {
+        id: 'python',
+        title: 'Python 3',
+        bins: ['python3'],
+        aptPackages: [],
+        features: ['python'],
+        installer: 'runtime-python',
+        runtimeVersion: '3.12',
+        dataPaths: ['/usr/local/ysk/python'],
+        impactKeys: ['runtimeStack'],
+    },
+    {
+        id: 'go',
+        title: 'Go',
+        bins: ['go'],
+        aptPackages: [],
+        features: ['go'],
+        installer: 'runtime-go',
+        runtimeVersion: '1.22',
+        dataPaths: ['/usr/local/ysk/go'],
+        impactKeys: ['runtimeStack'],
+    },
+    {
+        id: 'rust',
+        title: 'Rust (cargo)',
+        bins: ['cargo'],
+        aptPackages: [],
+        features: ['rust'],
+        installer: 'runtime-rust',
+        runtimeVersion: 'stable',
+        dataPaths: ['/usr/local/ysk/rust'],
+        impactKeys: ['runtimeStack'],
+    },
+    {
+        id: 'java',
+        title: 'Java (OpenJDK)',
+        bins: ['java', 'javac'],
+        aptPackages: ['openjdk-21-jdk'],
+        features: ['java'],
+        installer: 'runtime-java',
+        runtimeVersion: '21',
+        impactKeys: ['runtimeStack'],
+    },
+    {
+        id: 'kotlin',
+        title: 'Kotlin',
+        bins: ['kotlin', 'kotlinc'],
+        aptPackages: [],
+        features: ['kotlin'],
+        installer: 'runtime-kotlin',
+        runtimeVersion: '2.1.0',
+        dataPaths: ['/usr/local/ysk/kotlin'],
+        impactKeys: ['runtimeStack'],
+    },
+    {
+        id: 'bun',
+        title: 'Bun',
+        bins: ['bun'],
+        aptPackages: [],
+        features: ['bun'],
+        installer: 'runtime-bun',
+        runtimeVersion: 'latest',
+        dataPaths: ['/usr/local/ysk/bun'],
+        impactKeys: ['runtimeStack'],
+    },
+    {
+        /** Host Browse real-browser engine — distro Chromium (also detects Google Chrome bins). */
+        id: 'chromium',
+        title: 'Chromium / Chrome',
+        bins: [
+            'google-chrome',
+            'google-chrome-stable',
+            'chromium',
+            'chromium-browser',
+        ],
+        // Prefer distro chromium; Ubuntu may use chromium-browser transitional package
+        aptPackages: ['chromium'],
+        features: ['hostBrowse'],
+        uninstallProtected: true,
+        impactKeys: ['controlPlane']
+    },
+    {
+        id: 'wireguard',
+        title: 'WireGuard',
+        bins: ['wg', 'wg-quick'],
+        aptPackages: ['wireguard', 'wireguard-tools', 'qrencode'],
+        features: ['vpn', 'wireguard'],
+    },
+    {
+        id: 'openvpn',
+        title: 'OpenVPN',
+        bins: ['openvpn'],
+        aptPackages: ['openvpn', 'easy-rsa'],
+        features: ['vpn', 'openvpn'],
+    },
+    {
+        id: 'shadowsocks',
+        title: 'Shadowsocks (ss-server)',
+        bins: ['ss-server'],
+        aptPackages: ['shadowsocks-libev'],
+        features: ['vpn', 'outline'],
+    },
+    {
+        id: 'tigervnc',
+        title: 'TigerVNC server',
+        // Debian/Ubuntu: tigervncserver wrapper + Xtigervnc; legacy may ship vncserver/Xvnc
+        bins: ['tigervncserver', 'vncserver', 'Xtigervnc', 'Xvnc', 'x0vncserver'],
+        // Debian/Ubuntu package names vary; installer tries what apt provides
+        aptPackages: [
+            'tigervnc-standalone-server',
+            'tigervnc-common',
+            'tigervnc-tools',
+        ],
+        features: ['vnc', 'tigervnc'],
+    },
+    {
+        id: 'novnc',
+        title: 'noVNC + websockify',
+        bins: ['websockify', 'novnc_proxy'],
+        aptPackages: ['novnc', 'websockify'],
+        features: ['vnc', 'novnc'],
+    },
+    {
+        id: 'vnc-desktop-xfce',
+        title: 'XFCE desktop (for VNC)',
+        bins: ['startxfce4', 'xfce4-session'],
+        aptPackages: ['xfce4', 'xfce4-goodies', 'dbus-x11'],
+        features: ['vnc'],
+    },
+    {
+        id: 'tigervnc-viewer',
+        title: 'TigerVNC viewer',
+        bins: ['vncviewer', 'xtigervncviewer'],
+        aptPackages: ['tigervnc-viewer'],
+        features: ['vnc'],
+    },
+];
+export function getSoftware(id) {
+    return SOFTWARE_CATALOG.find((s) => s.id === id);
+}
+/**
+ * Software tied to a panel feature.
+ * Specs tagged with features:['all'] are only returned when feature is exactly
+ * 'all' (full inventory / full-stack install) — never when filtering a single
+ * feature such as 'python' or 'nginx' (so git is not uninstalled with Python).
+ */
+export function listSoftwareForFeature(feature) {
+    if (feature === 'all' || !feature)
+        return [...SOFTWARE_CATALOG];
+    return SOFTWARE_CATALOG.filter((s) => s.features.includes(feature));
+}
+//# sourceMappingURL=software-catalog.js.map

package/dist/hosting/software-catalog.js.map

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

package/dist/hosting/software-install.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Probe + one-click install for catalog software (panel only).
+ */
+import type { HostExecutor } from '../host/executor.js';
+import { type SoftwareId, type SoftwareSpec } from './software-catalog.js';
+import { type BlockReason } from './system-apply.js';
+export type SoftwareStatus = {
+    id: SoftwareId | string;
+    title: string;
+    installed: boolean;
+    active?: string;
+    bins: string[];
+    missingBins: string[];
+    features: string[];
+};
+export type SoftwareInstallStep = {
+    name: string;
+    status: 'ok' | 'skipped' | 'failed' | 'blocked';
+    detail?: string;
+};
+export type SoftwareInstallResult = {
+    ok: boolean;
+    executed: boolean;
+    blocked?: boolean;
+    blockReason?: BlockReason;
+    blockMessage?: string;
+    id: string;
+    title: string;
+    installed: boolean;
+    notes: string[];
+    steps: SoftwareInstallStep[];
+    status: SoftwareStatus;
+    /** UI must open SQL engine switch dialog instead of bare apt */
+    code?: 'needs_exclusive_switch' | string;
+    switchTarget?: 'mysql' | 'mariadb';
+    blockedByExclusive?: string;
+};
+/** In-process auth from sql-engine-switch only (not HTTP-forgable alone). */
+export type ExclusiveSwitchAuth = {
+    __yskSqlEngineSwitch: true;
+};
+export declare function probeSoftware(host: HostExecutor, spec: SoftwareSpec): Promise<SoftwareStatus>;
+export declare function probeAllSoftware(host: HostExecutor, feature?: string): Promise<SoftwareStatus[]>;
+export declare function installSoftware(input: {
+    host: HostExecutor;
+    id: string;
+    dataDir?: string;
+    /** enable units after apt (default true) */
+    enableUnits?: boolean;
+    /**
+     * Only sql-engine-switch may set this after user confirmed exclusive switch.
+     * Without it, installing mysql-server while MariaDB is present (or reverse) is refused.
+     */
+    exclusiveSwitchAuth?: ExclusiveSwitchAuth;
+    /** Live log sink for SSE UIs */
+    onLog?: (stream: 'stdout' | 'stderr' | 'status', line: string) => void;
+}): Promise<SoftwareInstallResult>;
+export declare function installSoftwareBatch(input: {
+    host: HostExecutor;
+    ids: string[];
+    dataDir?: string;
+    onLog?: (stream: 'stdout' | 'stderr' | 'status', line: string) => void;
+}): Promise<{
+    ok: boolean;
+    blocked?: boolean;
+    blockMessage?: string;
+    results: SoftwareInstallResult[];
+    notes: string[];
+}>;
+export declare function installForFeature(input: {
+    host: HostExecutor;
+    feature: string;
+    dataDir?: string;
+    /** only missing (default true) */
+    onlyMissing?: boolean;
+    onLog?: (stream: 'stdout' | 'stderr' | 'status', line: string) => void;
+}): Promise<{
+    ok: boolean;
+    blocked?: boolean;
+    blockMessage?: string;
+    results: SoftwareInstallResult[];
+    missingBefore: SoftwareStatus[];
+    notes: string[];
+    code?: string;
+    switchTarget?: 'mysql' | 'mariadb';
+    blockedByExclusive?: string;
+}>;
+//# sourceMappingURL=software-install.d.ts.map

package/dist/hosting/software-install.d.ts.map

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