craftclose 0.1.0

package/dist/connectors/pterodactyl.d.ts

@@ -0,0 +1,90 @@
+/**
+ * Pterodactyl Connector — Monitor and control servers via Pterodactyl Panel API
+ *
+ * Supports: status, power actions, console commands, file access, resource usage.
+ */
+import type { PterodactylConfig, HealthCheckResult } from "../types.js";
+export interface PterodactylConnectorOptions {
+    serverName: string;
+    config: PterodactylConfig;
+    /** Request timeout in ms (default: 10000) */
+    timeout?: number;
+}
+export interface PteroResourceUsage {
+    state: "running" | "starting" | "stopping" | "offline";
+    cpu: number;
+    memory_bytes: number;
+    memory_limit_bytes: number;
+    disk_bytes: number;
+    disk_limit_bytes: number;
+    network_rx: number;
+    network_tx: number;
+    uptime_ms: number;
+}
+export interface PteroFileEntry {
+    name: string;
+    size: number;
+    is_file: boolean;
+    modified_at: string;
+}
+export declare class PterodactylConnector {
+    private readonly serverName;
+    private readonly baseUrl;
+    private readonly headers;
+    private readonly timeout;
+    private cachedMemoryLimitMb;
+    private cachedDiskLimitMb;
+    constructor(options: PterodactylConnectorOptions);
+    /**
+     * Internal fetch helper with timeout and error formatting.
+     */
+    private request;
+    /**
+     * Test API connectivity and authentication.
+     * Caches memory/disk limits from the server details response.
+     */
+    testConnection(): Promise<boolean>;
+    /**
+     * Fetch and cache server limits if not already cached.
+     */
+    private ensureLimits;
+    /**
+     * Get server resource usage (CPU, RAM, disk, status).
+     */
+    getResources(): Promise<PteroResourceUsage>;
+    /**
+     * Get health check result mapped from Pterodactyl resources.
+     */
+    getHealth(): Promise<Partial<HealthCheckResult>>;
+    /**
+     * Send power action (start, stop, restart, kill).
+     */
+    power(action: "start" | "stop" | "restart" | "kill"): Promise<void>;
+    /**
+     * Send a console command. Fire-and-forget — response is not returned.
+     */
+    sendCommand(command: string): Promise<void>;
+    /**
+     * Read a file from the server (e.g., /logs/latest.log).
+     */
+    readFile(path: string): Promise<string>;
+    /**
+     * List files in a directory on the server.
+     */
+    listFiles(directory: string): Promise<PteroFileEntry[]>;
+    /**
+     * Get TPS via console command — not possible via REST API.
+     * Pterodactyl's /command endpoint is fire-and-forget; output is only available via WebSocket.
+     */
+    getTpsViaCommand(): Promise<number | null>;
+    /**
+     * Get players via console command — not possible via REST API.
+     * Player count is not in /resources. Requires RCON or WebSocket.
+     */
+    getPlayersViaCommand(): Promise<{
+        online: number;
+        max: number;
+        list: string[];
+    } | null>;
+}
+//# sourceMappingURL=pterodactyl.d.ts.map

package/dist/connectors/pterodactyl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pterodactyl.d.ts","sourceRoot":"","sources":["../../src/connectors/pterodactyl.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAExE,MAAM,WAAW,2BAA2B;IAC1C,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,iBAAiB,CAAC;IAC1B,6CAA6C;IAC7C,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,SAAS,GAAG,UAAU,GAAG,UAAU,GAAG,SAAS,CAAC;IACvD,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,EAAE,MAAM,CAAC;IACrB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyB;IACjD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IAGjC,OAAO,CAAC,mBAAmB,CAAuB;IAClD,OAAO,CAAC,iBAAiB,CAAuB;gBAEpC,OAAO,EAAE,2BAA2B;IAchD;;OAEG;YACW,OAAO;IAuBrB;;;OAGG;IACG,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC;IAuBxC;;OAEG;YACW,YAAY;IAK1B;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,kBAAkB,CAAC;IA0BjD;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAqBtD;;OAEG;IACG,KAAK,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAczE;;OAEG;IACG,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAYjD;;OAEG;IACG,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAW7C;;OAEG;IACG,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAmB7D;;;OAGG;IACG,gBAAgB,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAIhD;;;OAGG;IACG,oBAAoB,IAAI,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAA;KAAE,GAAG,IAAI,CAAC;CAG9F"}

package/dist/connectors/pterodactyl.js

@@ -0,0 +1,221 @@
+"use strict";
+/**
+ * Pterodactyl Connector — Monitor and control servers via Pterodactyl Panel API
+ *
+ * Supports: status, power actions, console commands, file access, resource usage.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PterodactylConnector = void 0;
+class PterodactylConnector {
+    serverName;
+    baseUrl;
+    headers;
+    timeout;
+    // Cached limits from testConnection / getServerDetails
+    cachedMemoryLimitMb = null;
+    cachedDiskLimitMb = null;
+    constructor(options) {
+        this.serverName = options.serverName;
+        this.timeout = options.timeout ?? 10_000;
+        // Normalize: strip trailing slash from panel_url
+        const panelUrl = options.config.panel_url.replace(/\/+$/u, "");
+        this.baseUrl = `${panelUrl}/api/client/servers/${options.config.server_id}`;
+        this.headers = {
+            "Authorization": `Bearer ${options.config.api_key}`,
+            "Content-Type": "application/json",
+            "Accept": "application/json",
+        };
+    }
+    /**
+     * Internal fetch helper with timeout and error formatting.
+     */
+    async request(path, options) {
+        const url = `${this.baseUrl}${path}`;
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), this.timeout);
+        try {
+            const response = await fetch(url, {
+                ...options,
+                headers: { ...this.headers, ...options?.headers },
+                signal: controller.signal,
+            });
+            return response;
+        }
+        catch (err) {
+            if (err instanceof DOMException && err.name === "AbortError") {
+                throw new Error(`[${this.serverName}] Pterodactyl request timed out: ${path}`);
+            }
+            const msg = err instanceof Error ? err.message : String(err);
+            throw new Error(`[${this.serverName}] Pterodactyl request failed: ${msg}`);
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+    /**
+     * Test API connectivity and authentication.
+     * Caches memory/disk limits from the server details response.
+     */
+    async testConnection() {
+        try {
+            const response = await this.request("/");
+            if (!response.ok)
+                return false;
+            const data = await response.json();
+            const attrs = data?.attributes;
+            if (!attrs)
+                return false;
+            if (attrs.limits) {
+                this.cachedMemoryLimitMb = attrs.limits.memory ?? null;
+                this.cachedDiskLimitMb = attrs.limits.disk ?? null;
+            }
+            console.log(`[CraftClose] Pterodactyl connected: ${this.serverName} — ` +
+                `${attrs.name ?? "unknown"} (RAM: ${attrs.limits?.memory ?? "?"}MB, Disk: ${attrs.limits?.disk ?? "?"}MB)`);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Fetch and cache server limits if not already cached.
+     */
+    async ensureLimits() {
+        if (this.cachedMemoryLimitMb !== null && this.cachedDiskLimitMb !== null)
+            return;
+        await this.testConnection();
+    }
+    /**
+     * Get server resource usage (CPU, RAM, disk, status).
+     */
+    async getResources() {
+        await this.ensureLimits();
+        const response = await this.request("/resources");
+        if (!response.ok) {
+            const body = await response.text().catch(() => "");
+            throw new Error(`[${this.serverName}] Pterodactyl /resources failed (${response.status}): ${body}`);
+        }
+        const data = await response.json();
+        const attrs = data?.attributes;
+        const res = attrs?.resources;
+        return {
+            state: attrs?.current_state ?? "offline",
+            cpu: res?.cpu_absolute ?? 0,
+            memory_bytes: res?.memory_bytes ?? 0,
+            memory_limit_bytes: (this.cachedMemoryLimitMb ?? 0) * 1024 * 1024,
+            disk_bytes: res?.disk_bytes ?? 0,
+            disk_limit_bytes: (this.cachedDiskLimitMb ?? 0) * 1024 * 1024,
+            network_rx: res?.network_rx_bytes ?? 0,
+            network_tx: res?.network_tx_bytes ?? 0,
+            uptime_ms: res?.uptime ?? 0,
+        };
+    }
+    /**
+     * Get health check result mapped from Pterodactyl resources.
+     */
+    async getHealth() {
+        const res = await this.getResources();
+        const ramUsedMb = res.memory_bytes / 1024 / 1024;
+        const ramTotalMb = res.memory_limit_bytes / 1024 / 1024;
+        const diskUsedMb = res.disk_bytes / 1024 / 1024;
+        const diskTotalMb = res.disk_limit_bytes / 1024 / 1024;
+        return {
+            online: res.state === "running",
+            cpu: res.cpu,
+            ram: ramTotalMb > 0
+                ? { used: Math.round(ramUsedMb), total: Math.round(ramTotalMb), percent: (ramUsedMb / ramTotalMb) * 100 }
+                : undefined,
+            disk: diskTotalMb > 0
+                ? { used: Math.round(diskUsedMb), total: Math.round(diskTotalMb), percent: (diskUsedMb / diskTotalMb) * 100 }
+                : undefined,
+            uptime: formatUptime(res.uptime_ms),
+        };
+    }
+    /**
+     * Send power action (start, stop, restart, kill).
+     */
+    async power(action) {
+        const response = await this.request("/power", {
+            method: "POST",
+            body: JSON.stringify({ signal: action }),
+        });
+        if (!response.ok) {
+            const body = await response.text().catch(() => "");
+            throw new Error(`[${this.serverName}] Pterodactyl power '${action}' failed (${response.status}): ${body}`);
+        }
+        console.log(`[CraftClose] Pterodactyl power '${action}' sent for ${this.serverName}`);
+    }
+    /**
+     * Send a console command. Fire-and-forget — response is not returned.
+     */
+    async sendCommand(command) {
+        const response = await this.request("/command", {
+            method: "POST",
+            body: JSON.stringify({ command }),
+        });
+        if (!response.ok) {
+            const body = await response.text().catch(() => "");
+            throw new Error(`[${this.serverName}] Pterodactyl command failed (${response.status}): ${body}`);
+        }
+    }
+    /**
+     * Read a file from the server (e.g., /logs/latest.log).
+     */
+    async readFile(path) {
+        const response = await this.request(`/files/contents?file=${encodeURIComponent(path)}`);
+        if (!response.ok) {
+            const body = await response.text().catch(() => "");
+            throw new Error(`[${this.serverName}] Pterodactyl readFile '${path}' failed (${response.status}): ${body}`);
+        }
+        return response.text();
+    }
+    /**
+     * List files in a directory on the server.
+     */
+    async listFiles(directory) {
+        const response = await this.request(`/files/list?directory=${encodeURIComponent(directory)}`);
+        if (!response.ok) {
+            const body = await response.text().catch(() => "");
+            throw new Error(`[${this.serverName}] Pterodactyl listFiles '${directory}' failed (${response.status}): ${body}`);
+        }
+        const data = await response.json();
+        const items = data?.data ?? [];
+        return items.map((item) => ({
+            name: item.attributes.name,
+            size: item.attributes.size,
+            is_file: item.attributes.is_file,
+            modified_at: item.attributes.modified_at,
+        }));
+    }
+    /**
+     * Get TPS via console command — not possible via REST API.
+     * Pterodactyl's /command endpoint is fire-and-forget; output is only available via WebSocket.
+     */
+    async getTpsViaCommand() {
+        return null;
+    }
+    /**
+     * Get players via console command — not possible via REST API.
+     * Player count is not in /resources. Requires RCON or WebSocket.
+     */
+    async getPlayersViaCommand() {
+        return null;
+    }
+}
+exports.PterodactylConnector = PterodactylConnector;
+/** Format milliseconds uptime as human-readable string (e.g. "2h 35m"). */
+function formatUptime(ms) {
+    const totalSeconds = Math.floor(ms / 1000);
+    const days = Math.floor(totalSeconds / 86400);
+    const hours = Math.floor((totalSeconds % 86400) / 3600);
+    const minutes = Math.floor((totalSeconds % 3600) / 60);
+    const parts = [];
+    if (days > 0)
+        parts.push(`${days}d`);
+    if (hours > 0)
+        parts.push(`${hours}h`);
+    if (minutes > 0 || parts.length === 0)
+        parts.push(`${minutes}m`);
+    return parts.join(" ");
+}
+//# sourceMappingURL=pterodactyl.js.map

package/dist/connectors/pterodactyl.js.map

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

package/dist/connectors/rcon.d.ts

@@ -0,0 +1,51 @@
+/**
+ * RCON Connector — Send commands to Minecraft servers via RCON protocol
+ *
+ * Handles TPS queries, player lists, and arbitrary console commands.
+ */
+import type { RconConfig } from "../types.js";
+export interface RconConnectorOptions {
+    serverName: string;
+    host: string;
+    config: RconConfig;
+    /** Connection timeout in ms (default: 5000) */
+    timeout?: number;
+}
+export declare class RconConnector {
+    private readonly options;
+    private rcon;
+    constructor(options: RconConnectorOptions);
+    /** Ensure the RCON client is connected. Reuses existing connection. */
+    private ensureConnected;
+    /**
+     * Test RCON connectivity and authentication.
+     */
+    testConnection(): Promise<boolean>;
+    /**
+     * Get current TPS (ticks per second).
+     * Parses the output of /tps command.
+     * @returns TPS value (0-20), or null if unavailable
+     */
+    getTps(): Promise<number | null>;
+    /**
+     * Get online player count and list.
+     */
+    getPlayers(): Promise<{
+        online: number;
+        max: number;
+        list: string[];
+    }>;
+    /**
+     * Get server version string.
+     */
+    getVersion(): Promise<string>;
+    /**
+     * Execute an arbitrary RCON command.
+     */
+    send(command: string): Promise<string>;
+    /**
+     * Close the RCON connection.
+     */
+    disconnect(): Promise<void>;
+}
+//# sourceMappingURL=rcon.d.ts.map

package/dist/connectors/rcon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rcon.d.ts","sourceRoot":"","sources":["../../src/connectors/rcon.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAG9C,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,UAAU,CAAC;IACnB,+CAA+C;IAC/C,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAuB;IAC/C,OAAO,CAAC,IAAI,CAAqB;gBAErB,OAAO,EAAE,oBAAoB;IAIzC,uEAAuE;YACzD,eAAe;IAkB7B;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC;IAUxC;;;;OAIG;IACG,MAAM,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAUtC;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAM5E;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC;IAMnC;;OAEG;IACG,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAK5C;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;CAMlC"}

package/dist/connectors/rcon.js

@@ -0,0 +1,95 @@
+"use strict";
+/**
+ * RCON Connector — Send commands to Minecraft servers via RCON protocol
+ *
+ * Handles TPS queries, player lists, and arbitrary console commands.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RconConnector = void 0;
+const rcon_client_1 = require("rcon-client");
+const parsers_js_1 = require("./parsers.js");
+class RconConnector {
+    options;
+    rcon = null;
+    constructor(options) {
+        this.options = options;
+    }
+    /** Ensure the RCON client is connected. Reuses existing connection. */
+    async ensureConnected() {
+        if (this.rcon) {
+            return this.rcon;
+        }
+        const { host, config, timeout } = this.options;
+        const rcon = new rcon_client_1.Rcon({
+            host: config.host ?? host,
+            port: config.port,
+            password: config.password,
+            timeout: timeout ?? 5000,
+        });
+        await rcon.connect();
+        this.rcon = rcon;
+        return rcon;
+    }
+    /**
+     * Test RCON connectivity and authentication.
+     */
+    async testConnection() {
+        try {
+            const rcon = await this.ensureConnected();
+            await rcon.send("list");
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Get current TPS (ticks per second).
+     * Parses the output of /tps command.
+     * @returns TPS value (0-20), or null if unavailable
+     */
+    async getTps() {
+        try {
+            const rcon = await this.ensureConnected();
+            const response = await rcon.send("tps");
+            return (0, parsers_js_1.parseTpsResponse)(response);
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Get online player count and list.
+     */
+    async getPlayers() {
+        const rcon = await this.ensureConnected();
+        const response = await rcon.send("list");
+        return (0, parsers_js_1.parsePlayersResponse)(response) ?? { online: 0, max: 0, list: [] };
+    }
+    /**
+     * Get server version string.
+     */
+    async getVersion() {
+        const rcon = await this.ensureConnected();
+        const response = await rcon.send("version");
+        return (0, parsers_js_1.stripColorCodes)(response).trim();
+    }
+    /**
+     * Execute an arbitrary RCON command.
+     */
+    async send(command) {
+        const rcon = await this.ensureConnected();
+        return rcon.send(command);
+    }
+    /**
+     * Close the RCON connection.
+     */
+    async disconnect() {
+        if (this.rcon) {
+            await this.rcon.end();
+            this.rcon = null;
+        }
+    }
+}
+exports.RconConnector = RconConnector;
+//# sourceMappingURL=rcon.js.map

package/dist/connectors/rcon.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rcon.js","sourceRoot":"","sources":["../../src/connectors/rcon.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAEH,6CAAmC;AAEnC,6CAAuF;AAUvF,MAAa,aAAa;IACP,OAAO,CAAuB;IACvC,IAAI,GAAgB,IAAI,CAAC;IAEjC,YAAY,OAA6B;QACvC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED,uEAAuE;IAC/D,KAAK,CAAC,eAAe;QAC3B,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,OAAO,IAAI,CAAC,IAAI,CAAC;QACnB,CAAC;QAED,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC;QAC/C,MAAM,IAAI,GAAG,IAAI,kBAAI,CAAC;YACpB,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,IAAI;YACzB,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,OAAO,EAAE,OAAO,IAAI,IAAI;SACzB,CAAC,CAAC;QAEH,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,cAAc;QAClB,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,eAAe,EAAE,CAAC;YAC1C,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACxB,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,MAAM;QACV,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,eAAe,EAAE,CAAC;YAC1C,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACxC,OAAO,IAAA,6BAAgB,EAAC,QAAQ,CAAC,CAAC;QACpC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,UAAU;QACd,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,eAAe,EAAE,CAAC;QAC1C,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACzC,OAAO,IAAA,iCAAoB,EAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;IAC3E,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,UAAU;QACd,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,eAAe,EAAE,CAAC;QAC1C,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC5C,OAAO,IAAA,4BAAe,EAAC,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC;IAC1C,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,IAAI,CAAC,OAAe;QACxB,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,eAAe,EAAE,CAAC;QAC1C,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC5B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,UAAU;QACd,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;YACtB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACnB,CAAC;IACH,CAAC;CACF;AA1FD,sCA0FC"}

package/dist/connectors/ssh.d.ts

@@ -0,0 +1,65 @@
+/**
+ * SSH Connector — Connect to Minecraft servers via SSH
+ *
+ * Handles health checks (CPU, RAM, disk), log tailing, and command execution.
+ */
+import type { SshConfig, HealthCheckResult } from "../types.js";
+export interface SshConnectorOptions {
+    serverName: string;
+    host: string;
+    config: SshConfig;
+    /** Path to server's latest.log (auto-detected if not specified) */
+    logPath?: string;
+    /** Connection timeout in ms (default: 10000) */
+    timeout?: number;
+}
+export declare class SshConnector {
+    private readonly options;
+    private conn;
+    private connected;
+    constructor(options: SshConnectorOptions);
+    /** Ensure the SSH client is connected. Reuses existing connection. */
+    private ensureConnected;
+    /**
+     * Execute a single command over SSH with a per-command timeout.
+     */
+    private execCommand;
+    /**
+     * Test SSH connectivity.
+     */
+    testConnection(): Promise<boolean>;
+    /**
+     * Get server health metrics via SSH.
+     */
+    getHealth(): Promise<Partial<HealthCheckResult>>;
+    /**
+     * Read the last N lines of the server log.
+     */
+    tailLog(lines?: number): Promise<string>;
+    /**
+     * Execute a command on the remote server (e.g., restart).
+     */
+    exec(command: string): Promise<{
+        stdout: string;
+        stderr: string;
+        code: number;
+    }>;
+    /**
+     * Create a local port forward through the SSH connection.
+     * Returns the local port number and a close function.
+     */
+    createTunnel(remoteHost: string, remotePort: number): Promise<{
+        localPort: number;
+        close: () => void;
+    }>;
+    /**
+     * Execute a Minecraft console command via docker exec.
+     * Useful when RCON isn't configured at all.
+     */
+    dockerRcon(containerName: string, command: string): Promise<string>;
+    /**
+     * Close the SSH connection.
+     */
+    disconnect(): Promise<void>;
+}
+//# sourceMappingURL=ssh.d.ts.map

package/dist/connectors/ssh.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ssh.d.ts","sourceRoot":"","sources":["../../src/connectors/ssh.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,KAAK,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEhE,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,SAAS,CAAC;IAClB,mEAAmE;IACnE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gDAAgD;IAChD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAqBD,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsB;IAC9C,OAAO,CAAC,IAAI,CAAuB;IACnC,OAAO,CAAC,SAAS,CAAS;gBAEd,OAAO,EAAE,mBAAmB;IAIxC,sEAAsE;YACxD,eAAe;IAoD7B;;OAEG;YACW,WAAW;IAiCzB;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC;IASxC;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAgDtD;;OAEG;IACG,OAAO,CAAC,KAAK,GAAE,MAAY,GAAG,OAAO,CAAC,MAAM,CAAC;IA4CnD;;OAEG;IACG,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAItF;;;OAGG;IACG,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,IAAI,CAAA;KAAE,CAAC;IAyB7G;;;OAGG;IACG,UAAU,CAAC,aAAa,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAUzE;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;CAOlC"}