ysk-server-core 1.0.0

package/dist/hosting/software-probe/HostSoftwareProbe.d.ts

@@ -0,0 +1,45 @@
+/**
+ * HostSoftwareProbe — single class for:
+ *   presence (is installed)
+ *   version
+ *   upgrade
+ *
+ * Callers must not re-implement command -v / flavor for product software.
+ */
+import type { HostExecutor } from '../../host/executor.js';
+import type { SoftwarePresence, SoftwareProbeId, SoftwareUpgradeInfo, SoftwareVersionInfo } from './types.js';
+export type SqlServerFlavor = 'mysql' | 'mariadb' | 'none';
+export declare class HostSoftwareProbe {
+    private readonly host;
+    constructor(host: HostExecutor);
+    /** Low-level bin resolve — same PATH rules for all product code */
+    resolveBin(bin: string): Promise<string>;
+    binPresent(bin: string): Promise<boolean>;
+    /**
+     * Detect which SQL server flavor owns the host (exclusive).
+     * MariaDB wins if mariadbd or mariadb-server package present.
+     */
+    detectSqlFlavor(): Promise<SqlServerFlavor>;
+    isInstalled(id: SoftwareProbeId): Promise<boolean>;
+    presence(id: SoftwareProbeId): Promise<SoftwarePresence>;
+    version(id: SoftwareProbeId): Promise<SoftwareVersionInfo>;
+    upgrade(id: SoftwareProbeId): Promise<SoftwareUpgradeInfo>;
+    /**
+     * Batch catalog upgrade probe (one host round-trip when possible).
+     * Falls back to sequential upgrade() when batch output is unusable (tests / broken apt).
+     */
+    upgrades(ids?: SoftwareProbeId[]): Promise<SoftwareUpgradeInfo[]>;
+    /**
+     * Single bash loop over apt-cache policy for all probe packages.
+     * Returns null when stdout cannot be mapped (caller should sequential-fallback).
+     */
+    private upgradesBatch;
+    /** Convenience for service-console engines */
+    presenceForEngine(engine: string): Promise<{
+        server: SoftwarePresence;
+        client?: SoftwarePresence;
+    }>;
+}
+/** Factory helper */
+export declare function createHostSoftwareProbe(host: HostExecutor): HostSoftwareProbe;
+//# sourceMappingURL=HostSoftwareProbe.d.ts.map

package/dist/hosting/software-probe/HostSoftwareProbe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HostSoftwareProbe.d.ts","sourceRoot":"","sources":["../../../src/hosting/software-probe/HostSoftwareProbe.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAa3D,OAAO,KAAK,EACV,gBAAgB,EAChB,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACpB,MAAM,YAAY,CAAC;AAEpB,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;AAE3D,qBAAa,iBAAiB;IAChB,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,YAAY;IAE/C,mEAAmE;IACnE,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAIxC,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIzC;;;OAGG;IACG,eAAe,IAAI,OAAO,CAAC,eAAe,CAAC;IAwB3C,WAAW,CAAC,EAAE,EAAE,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC;IAKlD,QAAQ,CAAC,EAAE,EAAE,eAAe,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA6FxD,OAAO,CAAC,EAAE,EAAE,eAAe,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAyD1D,OAAO,CAAC,EAAE,EAAE,eAAe,GAAG,OAAO,CAAC,mBAAmB,CAAC;IA8DhE;;;OAGG;IACG,QAAQ,CAAC,GAAG,CAAC,EAAE,eAAe,EAAE,GAAG,OAAO,CAAC,mBAAmB,EAAE,CAAC;IAWvE;;;OAGG;YACW,aAAa;IAmG3B,8CAA8C;IACxC,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;QAC/C,MAAM,EAAE,gBAAgB,CAAC;QACzB,MAAM,CAAC,EAAE,gBAAgB,CAAC;KAC3B,CAAC;CAOH;AAED,qBAAqB;AACrB,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,YAAY,GAAG,iBAAiB,CAE7E"}

package/dist/hosting/software-probe/HostSoftwareProbe.js

@@ -0,0 +1,362 @@
+/**
+ * HostSoftwareProbe — single class for:
+ *   presence (is installed)
+ *   version
+ *   upgrade
+ *
+ * Callers must not re-implement command -v / flavor for product software.
+ */
+import { binPresent, resolveBin, unitIsActive, unitIsEnabled, } from './resolve-bin.js';
+import { ENGINE_TO_CLIENT_ID, ENGINE_TO_SERVER_ID, getProbeEntry, listProbeIds, } from './registry.js';
+export class HostSoftwareProbe {
+    host;
+    constructor(host) {
+        this.host = host;
+    }
+    /** Low-level bin resolve — same PATH rules for all product code */
+    resolveBin(bin) {
+        return resolveBin(this.host, bin);
+    }
+    binPresent(bin) {
+        return binPresent(this.host, bin);
+    }
+    /**
+     * Detect which SQL server flavor owns the host (exclusive).
+     * MariaDB wins if mariadbd or mariadb-server package present.
+     */
+    async detectSqlFlavor() {
+        if (await binPresent(this.host, 'mariadbd'))
+            return 'mariadb';
+        const pkg = await this.host.runCommand([
+            'bash',
+            '-c',
+            "dpkg -l 2>/dev/null | awk '/^ii/ && /mariadb-server/ {print \"mariadb\"; exit} /^ii/ && /mysql-server/ {print \"mysql\"; exit}'",
+        ], { timeoutMs: 10_000 });
+        const line = pkg.stdout.trim();
+        if (line === 'mariadb' || line === 'mysql')
+            return line;
+        // mysqld alone may be Oracle MySQL; if mysql --version says MariaDB treat as mariadb
+        if (await binPresent(this.host, 'mysqld')) {
+            const v = await this.host.runCommand(['bash', '-c', 'mysql --version 2>/dev/null || mysqld --version 2>/dev/null || true'], { timeoutMs: 5_000 });
+            if (/mariadb/i.test(v.stdout))
+                return 'mariadb';
+            return 'mysql';
+        }
+        return 'none';
+    }
+    async isInstalled(id) {
+        const p = await this.presence(id);
+        return p.installed;
+    }
+    async presence(id) {
+        const entry = getProbeEntry(id);
+        const notes = [];
+        if (!entry) {
+            return {
+                id,
+                installed: false,
+                resolvedBins: [],
+                missingBins: [],
+                notes: [`unknown software id: ${id}`],
+            };
+        }
+        const resolvedBins = [];
+        const missingBins = [];
+        for (const b of entry.bins) {
+            const path = await resolveBin(this.host, b);
+            if (path)
+                resolvedBins.push(path);
+            else
+                missingBins.push(b);
+        }
+        let installed = entry.bins.length === 0 ? false : resolvedBins.length > 0;
+        // Exclusive flavor for MySQL / MariaDB servers
+        let blockedByExclusive;
+        if (entry.requiresExclusiveFlavor || entry.exclusiveWith?.length) {
+            const flavor = await this.detectSqlFlavor();
+            if (id === 'mysql-server') {
+                if (flavor === 'mariadb') {
+                    installed = false;
+                    blockedByExclusive = 'mariadb-server';
+                    notes.push('host SQL flavor is MariaDB; Oracle MySQL server not installed');
+                }
+                else if (flavor === 'mysql') {
+                    installed = true;
+                }
+                else {
+                    installed = resolvedBins.length > 0 && !(await binPresent(this.host, 'mariadbd'));
+                }
+            }
+            else if (id === 'mariadb-server') {
+                if (flavor === 'mysql') {
+                    installed = false;
+                    blockedByExclusive = 'mysql-server';
+                    notes.push('host SQL flavor is Oracle MySQL; MariaDB server not installed');
+                }
+                else if (flavor === 'mariadb') {
+                    installed = true;
+                }
+                else {
+                    installed = (await binPresent(this.host, 'mariadbd')) || resolvedBins.length > 0;
+                }
+            }
+        }
+        const units = [];
+        for (const u of entry.units ?? []) {
+            try {
+                const active = await unitIsActive(this.host, u);
+                const enabled = await unitIsEnabled(this.host, u);
+                units.push({ name: u, active, enabled });
+            }
+            catch {
+                units.push({ name: u, active: 'unknown', enabled: 'unknown' });
+            }
+        }
+        // Optional: check primary dpkg package present
+        let packagesPresent;
+        if (entry.dpkgPackage) {
+            try {
+                const r = await this.host.runCommand([
+                    'bash',
+                    '-c',
+                    `dpkg-query -W -f='\${Status}' ${JSON.stringify(entry.dpkgPackage)} 2>/dev/null || true`,
+                ], { timeoutMs: 5_000 });
+                if (/install ok installed/i.test(r.stdout)) {
+                    packagesPresent = [entry.dpkgPackage];
+                }
+            }
+            catch {
+                /* ignore dpkg probe errors */
+            }
+        }
+        return {
+            id,
+            installed,
+            resolvedBins,
+            missingBins: installed ? [] : missingBins,
+            blockedByExclusive,
+            packagesPresent,
+            units: units.length ? units : undefined,
+            notes,
+        };
+    }
+    async version(id) {
+        const pres = await this.presence(id);
+        const entry = getProbeEntry(id);
+        const notes = [...pres.notes];
+        if (!pres.installed) {
+            return {
+                id,
+                installed: false,
+                source: 'unknown',
+                notes: notes.length ? notes : ['not installed'],
+            };
+        }
+        if (!entry) {
+            return { id, installed: false, source: 'unknown', notes: ['unknown id'] };
+        }
+        // CLI version first (may print to stderr, e.g. nginx -v)
+        if (entry.versionCommand?.length) {
+            const argv = entry.versionCommand;
+            const r = await this.host.runCommand(['bash', '-c', `${argv.map((a) => JSON.stringify(a)).join(' ')} 2>&1 || true`], { timeoutMs: 8_000 });
+            const raw = (r.stdout || r.stderr || '').trim();
+            // Ignore empty / pure whitespace; dpkg fallback otherwise
+            if (raw && !/^dpkg-query/i.test(raw)) {
+                const version = raw.split('\n')[0].slice(0, 160);
+                return { id, installed: true, version, raw, source: 'cli', notes };
+            }
+        }
+        // dpkg fallback
+        if (entry.dpkgPackage) {
+            const r = await this.host.runCommand([
+                'bash',
+                '-c',
+                `dpkg-query -W -f='\${Version}' ${JSON.stringify(entry.dpkgPackage)} 2>/dev/null || true`,
+            ], { timeoutMs: 5_000 });
+            const ver = r.stdout.trim();
+            if (ver) {
+                return {
+                    id,
+                    installed: true,
+                    version: ver,
+                    raw: ver,
+                    source: 'dpkg',
+                    notes,
+                };
+            }
+        }
+        return { id, installed: true, source: 'unknown', notes: [...notes, 'version unavailable'] };
+    }
+    async upgrade(id) {
+        const entry = getProbeEntry(id);
+        const packageName = entry?.dpkgPackage || entry?.aptPackages[0] || id;
+        const pres = await this.presence(id);
+        if (!entry) {
+            return {
+                id,
+                packageName,
+                installed: false,
+                upgradable: false,
+                source: 'none',
+                notes: ['unknown id'],
+            };
+        }
+        if (!pres.installed) {
+            return {
+                id,
+                packageName,
+                installed: false,
+                upgradable: false,
+                source: 'none',
+                notes: ['not installed'],
+            };
+        }
+        // apt-cache policy: Installed: / Candidate:
+        const r = await this.host.runCommand([
+            'bash',
+            '-c',
+            `apt-cache policy ${JSON.stringify(packageName)} 2>/dev/null | head -n 20 || true`,
+        ], { timeoutMs: 15_000 });
+        const text = r.stdout || '';
+        const instM = text.match(/Installed:\s*(\S+)/);
+        const candM = text.match(/Candidate:\s*(\S+)/);
+        const currentVersion = instM?.[1] && instM[1] !== '(none)' ? instM[1] : undefined;
+        const candidateVersion = candM?.[1] && candM[1] !== '(none)' ? candM[1] : undefined;
+        const upgradable = Boolean(currentVersion &&
+            candidateVersion &&
+            currentVersion !== candidateVersion &&
+            candidateVersion !== '(none)');
+        return {
+            id,
+            packageName,
+            installed: true,
+            currentVersion,
+            candidateVersion,
+            upgradable,
+            source: text.trim() ? 'apt' : 'none',
+            notes: upgradable
+                ? [`${packageName}: ${currentVersion} → ${candidateVersion}`]
+                : ['no upgrade candidate'],
+        };
+    }
+    /**
+     * Batch catalog upgrade probe (one host round-trip when possible).
+     * Falls back to sequential upgrade() when batch output is unusable (tests / broken apt).
+     */
+    async upgrades(ids) {
+        const list = ids?.length ? ids : listProbeIds();
+        const batch = await this.upgradesBatch(list);
+        if (batch)
+            return batch;
+        const out = [];
+        for (const id of list) {
+            out.push(await this.upgrade(id));
+        }
+        return out;
+    }
+    /**
+     * Single bash loop over apt-cache policy for all probe packages.
+     * Returns null when stdout cannot be mapped (caller should sequential-fallback).
+     */
+    async upgradesBatch(list) {
+        const specs = list.map((id) => {
+            const entry = getProbeEntry(id);
+            const packageName = entry?.dpkgPackage || entry?.aptPackages[0] || id;
+            return { id, packageName, entry };
+        });
+        const packages = [
+            ...new Set(specs
+                .map((s) => s.packageName)
+                .filter((p) => /^[a-zA-Z0-9.+_-]+$/.test(p))),
+        ];
+        if (!packages.length)
+            return [];
+        const pkgArgs = packages.map((p) => JSON.stringify(p)).join(' ');
+        const script = `
+set +e
+export LANG=C
+for p in ${pkgArgs}; do
+  out=$(apt-cache policy "$p" 2>/dev/null | head -n 16)
+  inst=$(printf '%s\\n' "$out" | awk '/^[[:space:]]*Installed:/{print $2; exit}')
+  cand=$(printf '%s\\n' "$out" | awk '/^[[:space:]]*Candidate:/{print $2; exit}')
+  [ -z "$inst" ] && inst="(none)"
+  [ -z "$cand" ] && cand="(none)"
+  printf '%s\\t%s\\t%s\\n' "$p" "$inst" "$cand"
+done
+`.trim();
+        const r = await this.host.runCommand(['bash', '-c', script], {
+            timeoutMs: 45_000,
+        });
+        const byPkg = new Map();
+        let parsed = 0;
+        for (const line of (r.stdout || '').trim().split('\n')) {
+            if (!line.includes('\t'))
+                continue;
+            const [name, inst, cand] = line.split('\t');
+            if (!name)
+                continue;
+            parsed += 1;
+            const current = inst && inst !== '(none)' ? inst.trim() : undefined;
+            const candidate = cand && cand !== '(none)' ? cand.trim() : undefined;
+            byPkg.set(name, {
+                current,
+                candidate,
+                source: r.stdout?.trim() ? 'apt' : 'none',
+            });
+        }
+        // Need a usable row per requested package; otherwise sequential fallback
+        if (parsed === 0 || packages.some((p) => !byPkg.has(p)))
+            return null;
+        return specs.map(({ id, packageName, entry }) => {
+            if (!entry) {
+                return {
+                    id,
+                    packageName,
+                    installed: false,
+                    upgradable: false,
+                    source: 'none',
+                    notes: ['unknown id'],
+                };
+            }
+            const row = byPkg.get(packageName);
+            if (!row?.current) {
+                return {
+                    id,
+                    packageName,
+                    installed: false,
+                    upgradable: false,
+                    source: 'none',
+                    notes: ['not installed'],
+                };
+            }
+            const upgradable = Boolean(row.candidate &&
+                row.current !== row.candidate &&
+                row.candidate !== '(none)');
+            return {
+                id,
+                packageName,
+                installed: true,
+                currentVersion: row.current,
+                candidateVersion: row.candidate,
+                upgradable,
+                source: row.source,
+                notes: upgradable
+                    ? [`${packageName}: ${row.current} → ${row.candidate}`]
+                    : ['no upgrade candidate'],
+            };
+        });
+    }
+    /** Convenience for service-console engines */
+    async presenceForEngine(engine) {
+        const serverId = ENGINE_TO_SERVER_ID[engine] ?? engine;
+        const clientId = ENGINE_TO_CLIENT_ID[engine];
+        const server = await this.presence(serverId);
+        const client = clientId ? await this.presence(clientId) : undefined;
+        return { server, client };
+    }
+}
+/** Factory helper */
+export function createHostSoftwareProbe(host) {
+    return new HostSoftwareProbe(host);
+}
+//# sourceMappingURL=HostSoftwareProbe.js.map

package/dist/hosting/software-probe/HostSoftwareProbe.js.map

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

package/dist/hosting/software-probe/index.d.ts

@@ -0,0 +1,6 @@
+export * from './types.js';
+export * from './resolve-bin.js';
+export * from './shell.js';
+export * from './registry.js';
+export * from './HostSoftwareProbe.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/hosting/software-probe/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hosting/software-probe/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,wBAAwB,CAAC"}

package/dist/hosting/software-probe/index.js

@@ -0,0 +1,6 @@
+export * from './types.js';
+export * from './resolve-bin.js';
+export * from './shell.js';
+export * from './registry.js';
+export * from './HostSoftwareProbe.js';
+//# sourceMappingURL=index.js.map

package/dist/hosting/software-probe/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/hosting/software-probe/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,wBAAwB,CAAC"}

package/dist/hosting/software-probe/registry.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Probe registry — built from SOFTWARE_CATALOG + exclusive / version metadata.
+ */
+import type { ProbeRegistryEntry, SoftwareProbeId } from './types.js';
+/** Extra aliases used by service-console engines → primary server probe id */
+export declare const ENGINE_TO_SERVER_ID: Record<string, SoftwareProbeId>;
+export declare const ENGINE_TO_CLIENT_ID: Record<string, SoftwareProbeId | undefined>;
+export declare function getProbeEntry(id: SoftwareProbeId): ProbeRegistryEntry | undefined;
+export declare function listProbeIds(): SoftwareProbeId[];
+export declare function allProbeEntries(): ProbeRegistryEntry[];
+//# sourceMappingURL=registry.d.ts.map

package/dist/hosting/software-probe/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/hosting/software-probe/registry.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAiFtE,8EAA8E;AAC9E,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAK/D,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,GAAG,SAAS,CAK3E,CAAC;AAEF,wBAAgB,aAAa,CAAC,EAAE,EAAE,eAAe,GAAG,kBAAkB,GAAG,SAAS,CAEjF;AAED,wBAAgB,YAAY,IAAI,eAAe,EAAE,CAEhD;AAED,wBAAgB,eAAe,IAAI,kBAAkB,EAAE,CAEtD"}

package/dist/hosting/software-probe/registry.js

@@ -0,0 +1,100 @@
+/**
+ * Probe registry — built from SOFTWARE_CATALOG + exclusive / version metadata.
+ */
+import { SOFTWARE_CATALOG } from '../software-catalog.js';
+const EXCLUSIVE = {
+    'mysql-server': ['mariadb-server'],
+    'mariadb-server': ['mysql-server'],
+};
+const VERSION_CMD = {
+    nginx: ['nginx', '-v'],
+    certbot: ['certbot', '--version'],
+    'mysql-client': ['mysql', '--version'],
+    'mysql-server': ['mysqld', '--version'],
+    'mariadb-server': ['mariadbd', '--version'],
+    'postgresql-client': ['psql', '--version'],
+    postgresql: ['postgres', '-V'],
+    'redis-tools': ['redis-cli', '--version'],
+    'redis-server': ['redis-server', '--version'],
+    ufw: ['ufw', 'version'],
+    fail2ban: ['fail2ban-client', 'version'],
+    postfix: ['postconf', '-d', 'mail_version'],
+    dovecot: ['dovecot', '--version'],
+    git: ['git', '--version'],
+    node: ['node', '--version'],
+    pm2: ['pm2', '-v'],
+    php: ['php', '-v'],
+    python: ['python3', '--version'],
+    go: ['go', 'version'],
+    rust: ['cargo', '--version'],
+    java: ['java', '-version'],
+    kotlin: ['kotlinc', '-version'],
+    bun: ['bun', '--version'],
+    vsftpd: ['vsftpd', '-v'],
+    'pdns-server': ['pdns_server', '--version'],
+    chromium: ['chromium', '--version'],
+};
+const DPKG_PRIMARY = {
+    nginx: 'nginx',
+    certbot: 'certbot',
+    'mysql-server': 'mysql-server',
+    'mariadb-server': 'mariadb-server',
+    postgresql: 'postgresql',
+    'postgresql-client': 'postgresql-client',
+    'redis-server': 'redis-server',
+    'redis-tools': 'redis-tools',
+    ufw: 'ufw',
+    fail2ban: 'fail2ban',
+    postfix: 'postfix',
+    dovecot: 'dovecot-core',
+    vsftpd: 'vsftpd',
+    'pdns-server': 'pdns-server',
+    git: 'git',
+    php: 'php-cli',
+    python: 'python3',
+    go: 'golang-go',
+    node: 'nodejs',
+    java: 'openjdk-21-jdk',
+    chromium: 'chromium',
+};
+function buildFromCatalog() {
+    const m = new Map();
+    for (const s of SOFTWARE_CATALOG) {
+        m.set(s.id, {
+            id: s.id,
+            title: s.title,
+            bins: [...s.bins],
+            aptPackages: [...s.aptPackages],
+            units: s.units ? [...s.units] : undefined,
+            exclusiveWith: EXCLUSIVE[s.id],
+            versionCommand: VERSION_CMD[s.id],
+            dpkgPackage: DPKG_PRIMARY[s.id] ?? s.aptPackages[0],
+            requiresExclusiveFlavor: s.id === 'mysql-server' || s.id === 'mariadb-server' ? true : undefined,
+        });
+    }
+    return m;
+}
+const REGISTRY = buildFromCatalog();
+/** Extra aliases used by service-console engines → primary server probe id */
+export const ENGINE_TO_SERVER_ID = {
+    mysql: 'mysql-server',
+    mariadb: 'mariadb-server',
+    postgres: 'postgresql',
+    redis: 'redis-server',
+};
+export const ENGINE_TO_CLIENT_ID = {
+    mysql: 'mysql-client',
+    mariadb: 'mysql-client',
+    postgres: 'postgresql-client',
+    redis: 'redis-tools',
+};
+export function getProbeEntry(id) {
+    return REGISTRY.get(id);
+}
+export function listProbeIds() {
+    return [...REGISTRY.keys()];
+}
+export function allProbeEntries() {
+    return [...REGISTRY.values()];
+}
+//# sourceMappingURL=registry.js.map

package/dist/hosting/software-probe/registry.js.map

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

package/dist/hosting/software-probe/resolve-bin.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Single PATH / absolute-path binary resolution for host probes.
+ * Do not re-implement command -v elsewhere for product software.
+ */
+import type { HostExecutor } from '../../host/executor.js';
+/** Standard PATH used for all product software probes */
+export declare const PROBE_PATH = "/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/usr/local/cargo/bin";
+/**
+ * Bash snippet: prepend YSK toolchain bins (node/go/bun/python) so probes find
+ * installs under /usr/local/ysk even when not symlinked into /usr/local/bin.
+ *
+ * Safe under `set -u` / `set -e` (used inside install.sh via shellBinExists).
+ * Avoids `for x in empty-glob` unbound-variable failures on some bash + nullglob.
+ */
+export declare function shellPrependYskToolchainPath(): string;
+export declare function absoluteBinCandidates(bin: string): string[];
+/**
+ * Resolve a bare binary name to an absolute path if present on the host.
+ * Returns empty string when missing.
+ */
+export declare function resolveBin(host: HostExecutor, bin: string): Promise<string>;
+/** Whether a bare binary name exists (product-wide standard). */
+export declare function binPresent(host: HostExecutor, bin: string): Promise<boolean>;
+export declare function unitIsActive(host: HostExecutor, unit: string): Promise<string | undefined>;
+export declare function unitIsEnabled(host: HostExecutor, unit: string): Promise<string | undefined>;
+/**
+ * Poll systemctl is-active until active (or timeout).
+ * Treats `activating` as transient; `failed` aborts early.
+ */
+export declare function waitUnitActive(host: HostExecutor, unit: string, opts?: {
+    timeoutMs?: number;
+    pollMs?: number;
+}): Promise<{
+    ok: boolean;
+    active: string;
+    notes: string[];
+}>;
+//# sourceMappingURL=resolve-bin.d.ts.map

package/dist/hosting/software-probe/resolve-bin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-bin.d.ts","sourceRoot":"","sources":["../../../src/hosting/software-probe/resolve-bin.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAE3D,yDAAyD;AACzD,eAAO,MAAM,UAAU,sFAC8D,CAAC;AAEtF;;;;;;GAMG;AACH,wBAAgB,4BAA4B,IAAI,MAAM,CAarD;AAED,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAU3D;AAuCD;;;GAGG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE,YAAY,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CA2BjF;AAED,iEAAiE;AACjE,wBAAsB,UAAU,CAAC,IAAI,EAAE,YAAY,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAElF;AAED,wBAAsB,YAAY,CAAC,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAUhG;AAED,wBAAsB,aAAa,CAAC,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAUjG;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAClC,IAAI,EAAE,YAAY,EAClB,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAC7C,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CA2B3D"}