hetzner-robot-cli 1.0.0

package/dist/client.js

@@ -0,0 +1,656 @@
+// ============================================================================
+// Hetzner Robot API Client
+// Base URL: https://robot-ws.your-server.de
+// Auth: HTTP Basic Authentication
+// ============================================================================
+const BASE_URL = 'https://robot-ws.your-server.de';
+export class HetznerRobotClient {
+    auth;
+    constructor(username, password) {
+        this.auth = Buffer.from(`${username}:${password}`).toString('base64');
+    }
+    async request(endpoint, options = {}) {
+        const url = `${BASE_URL}${endpoint}`;
+        const headers = {
+            Authorization: `Basic ${this.auth}`,
+            'Content-Type': 'application/x-www-form-urlencoded',
+            Accept: 'application/json',
+            ...options.headers,
+        };
+        const response = await fetch(url, {
+            ...options,
+            headers,
+        });
+        if (!response.ok) {
+            let errorMessage = `HTTP ${response.status}: ${response.statusText}`;
+            try {
+                const errorBody = await response.json();
+                if (errorBody.error) {
+                    errorMessage = `${errorBody.error.code ?? 'ERROR'}: ${errorBody.error.message ?? 'Unknown error'}`;
+                }
+            }
+            catch {
+                // Use default error message
+            }
+            throw new Error(errorMessage);
+        }
+        // Handle 204 No Content
+        if (response.status === 204) {
+            return {};
+        }
+        return response.json();
+    }
+    encodeParams(params) {
+        const parts = [];
+        for (const [key, value] of Object.entries(params)) {
+            if (value === undefined)
+                continue;
+            if (Array.isArray(value)) {
+                for (const v of value) {
+                    parts.push(`${encodeURIComponent(key)}[]=${encodeURIComponent(v)}`);
+                }
+            }
+            else {
+                parts.push(`${encodeURIComponent(key)}=${encodeURIComponent(String(value))}`);
+            }
+        }
+        return parts.join('&');
+    }
+    buildTrafficParams(trafficWarnings, trafficHourly, trafficDaily, trafficMonthly) {
+        return {
+            traffic_warnings: trafficWarnings,
+            traffic_hourly: trafficHourly,
+            traffic_daily: trafficDaily,
+            traffic_monthly: trafficMonthly,
+        };
+    }
+    // =========================================================================
+    // Server Management
+    // =========================================================================
+    async listServers() {
+        return this.request('/server');
+    }
+    async getServer(serverIpOrNumber) {
+        return this.request(`/server/${serverIpOrNumber}`);
+    }
+    async updateServerName(serverIpOrNumber, name) {
+        return this.request(`/server/${serverIpOrNumber}`, {
+            method: 'POST',
+            body: this.encodeParams({ server_name: name }),
+        });
+    }
+    // =========================================================================
+    // Cancellation
+    // =========================================================================
+    async getCancellation(serverIpOrNumber) {
+        return this.request(`/server/${serverIpOrNumber}/cancellation`);
+    }
+    async cancelServer(serverIpOrNumber, cancellationDate, cancellationReason) {
+        const params = {};
+        if (cancellationDate)
+            params.cancellation_date = cancellationDate;
+        if (cancellationReason)
+            params.cancellation_reason = cancellationReason;
+        return this.request(`/server/${serverIpOrNumber}/cancellation`, {
+            method: 'POST',
+            body: this.encodeParams(params),
+        });
+    }
+    async revokeCancellation(serverIpOrNumber) {
+        await this.request(`/server/${serverIpOrNumber}/cancellation`, {
+            method: 'DELETE',
+        });
+    }
+    // =========================================================================
+    // Reset
+    // =========================================================================
+    async listResetOptions() {
+        return this.request('/reset');
+    }
+    async getResetOptions(serverIpOrNumber) {
+        return this.request(`/reset/${serverIpOrNumber}`);
+    }
+    async resetServer(serverIpOrNumber, type = 'sw') {
+        return this.request(`/reset/${serverIpOrNumber}`, {
+            method: 'POST',
+            body: this.encodeParams({ type }),
+        });
+    }
+    // =========================================================================
+    // Boot Configuration
+    // =========================================================================
+    async getBootConfig(serverIpOrNumber) {
+        return this.request(`/boot/${serverIpOrNumber}`);
+    }
+    // Rescue System
+    async getRescue(serverIpOrNumber) {
+        return this.request(`/boot/${serverIpOrNumber}/rescue`);
+    }
+    async activateRescue(serverIpOrNumber, os, arch, authorizedKeys) {
+        const params = { os };
+        if (arch)
+            params.arch = arch;
+        if (authorizedKeys)
+            params.authorized_key = authorizedKeys;
+        return this.request(`/boot/${serverIpOrNumber}/rescue`, {
+            method: 'POST',
+            body: this.encodeParams(params),
+        });
+    }
+    async deactivateRescue(serverIpOrNumber) {
+        return this.request(`/boot/${serverIpOrNumber}/rescue`, {
+            method: 'DELETE',
+        });
+    }
+    async getLastRescue(serverIpOrNumber) {
+        return this.request(`/boot/${serverIpOrNumber}/rescue/last`);
+    }
+    // Linux Install
+    async getLinux(serverIpOrNumber) {
+        return this.request(`/boot/${serverIpOrNumber}/linux`);
+    }
+    async activateLinux(serverIpOrNumber, dist, arch, lang, authorizedKeys) {
+        const params = { dist };
+        if (arch)
+            params.arch = arch;
+        if (lang)
+            params.lang = lang;
+        if (authorizedKeys)
+            params.authorized_key = authorizedKeys;
+        return this.request(`/boot/${serverIpOrNumber}/linux`, {
+            method: 'POST',
+            body: this.encodeParams(params),
+        });
+    }
+    async deactivateLinux(serverIpOrNumber) {
+        return this.request(`/boot/${serverIpOrNumber}/linux`, {
+            method: 'DELETE',
+        });
+    }
+    async getLastLinux(serverIpOrNumber) {
+        return this.request(`/boot/${serverIpOrNumber}/linux/last`);
+    }
+    // VNC Install
+    async getVnc(serverIpOrNumber) {
+        return this.request(`/boot/${serverIpOrNumber}/vnc`);
+    }
+    async activateVnc(serverIpOrNumber, dist, arch, lang) {
+        const params = { dist };
+        if (arch)
+            params.arch = arch;
+        if (lang)
+            params.lang = lang;
+        return this.request(`/boot/${serverIpOrNumber}/vnc`, {
+            method: 'POST',
+            body: this.encodeParams(params),
+        });
+    }
+    async deactivateVnc(serverIpOrNumber) {
+        return this.request(`/boot/${serverIpOrNumber}/vnc`, {
+            method: 'DELETE',
+        });
+    }
+    // Windows Install
+    async getWindows(serverIpOrNumber) {
+        return this.request(`/boot/${serverIpOrNumber}/windows`);
+    }
+    async activateWindows(serverIpOrNumber, dist, lang) {
+        const params = { dist };
+        if (lang)
+            params.lang = lang;
+        return this.request(`/boot/${serverIpOrNumber}/windows`, {
+            method: 'POST',
+            body: this.encodeParams(params),
+        });
+    }
+    async deactivateWindows(serverIpOrNumber) {
+        return this.request(`/boot/${serverIpOrNumber}/windows`, {
+            method: 'DELETE',
+        });
+    }
+    // =========================================================================
+    // IP Management
+    // =========================================================================
+    async listIps() {
+        return this.request('/ip');
+    }
+    async getIp(ip) {
+        return this.request(`/ip/${ip}`);
+    }
+    async updateIp(ip, trafficWarnings, trafficHourly, trafficDaily, trafficMonthly) {
+        return this.request(`/ip/${ip}`, {
+            method: 'POST',
+            body: this.encodeParams(this.buildTrafficParams(trafficWarnings, trafficHourly, trafficDaily, trafficMonthly)),
+        });
+    }
+    async getIpMac(ip) {
+        return this.request(`/ip/${ip}/mac`);
+    }
+    async generateIpMac(ip) {
+        return this.request(`/ip/${ip}/mac`, {
+            method: 'PUT',
+        });
+    }
+    async deleteIpMac(ip) {
+        await this.request(`/ip/${ip}/mac`, {
+            method: 'DELETE',
+        });
+    }
+    // =========================================================================
+    // Subnet Management
+    // =========================================================================
+    async listSubnets() {
+        return this.request('/subnet');
+    }
+    async getSubnet(netIp) {
+        return this.request(`/subnet/${netIp}`);
+    }
+    async updateSubnet(netIp, trafficWarnings, trafficHourly, trafficDaily, trafficMonthly) {
+        return this.request(`/subnet/${netIp}`, {
+            method: 'POST',
+            body: this.encodeParams(this.buildTrafficParams(trafficWarnings, trafficHourly, trafficDaily, trafficMonthly)),
+        });
+    }
+    async getSubnetMac(netIp) {
+        return this.request(`/subnet/${netIp}/mac`);
+    }
+    async generateSubnetMac(netIp) {
+        return this.request(`/subnet/${netIp}/mac`, {
+            method: 'PUT',
+        });
+    }
+    async deleteSubnetMac(netIp) {
+        await this.request(`/subnet/${netIp}/mac`, {
+            method: 'DELETE',
+        });
+    }
+    // =========================================================================
+    // Failover
+    // =========================================================================
+    async listFailovers() {
+        return this.request('/failover');
+    }
+    async getFailover(failoverIp) {
+        return this.request(`/failover/${failoverIp}`);
+    }
+    async switchFailover(failoverIp, activeServerIp) {
+        return this.request(`/failover/${failoverIp}`, {
+            method: 'POST',
+            body: this.encodeParams({ active_server_ip: activeServerIp }),
+        });
+    }
+    async deleteFailoverRouting(failoverIp) {
+        await this.request(`/failover/${failoverIp}`, {
+            method: 'DELETE',
+        });
+    }
+    // =========================================================================
+    // Reverse DNS
+    // =========================================================================
+    async listRdns() {
+        return this.request('/rdns');
+    }
+    async getRdns(ip) {
+        return this.request(`/rdns/${ip}`);
+    }
+    async createRdns(ip, ptr) {
+        return this.request(`/rdns/${ip}`, {
+            method: 'PUT',
+            body: this.encodeParams({ ptr }),
+        });
+    }
+    async updateRdns(ip, ptr) {
+        return this.request(`/rdns/${ip}`, {
+            method: 'POST',
+            body: this.encodeParams({ ptr }),
+        });
+    }
+    async deleteRdns(ip) {
+        await this.request(`/rdns/${ip}`, {
+            method: 'DELETE',
+        });
+    }
+    // =========================================================================
+    // SSH Keys
+    // =========================================================================
+    async listSshKeys() {
+        return this.request('/key');
+    }
+    async getSshKey(fingerprint) {
+        return this.request(`/key/${fingerprint}`);
+    }
+    async createSshKey(name, data) {
+        return this.request('/key', {
+            method: 'POST',
+            body: this.encodeParams({ name, data }),
+        });
+    }
+    async updateSshKey(fingerprint, name) {
+        return this.request(`/key/${fingerprint}`, {
+            method: 'POST',
+            body: this.encodeParams({ name }),
+        });
+    }
+    async deleteSshKey(fingerprint) {
+        await this.request(`/key/${fingerprint}`, {
+            method: 'DELETE',
+        });
+    }
+    // =========================================================================
+    // Firewall
+    // =========================================================================
+    async getFirewall(serverIpOrNumber) {
+        return this.request(`/firewall/${serverIpOrNumber}`);
+    }
+    async updateFirewall(serverIpOrNumber, status, rules) {
+        const params = { status };
+        if (rules) {
+            params['rules[input]'] = JSON.stringify(rules.input);
+        }
+        return this.request(`/firewall/${serverIpOrNumber}`, {
+            method: 'POST',
+            body: this.encodeParams(params),
+        });
+    }
+    async deleteFirewall(serverIpOrNumber) {
+        await this.request(`/firewall/${serverIpOrNumber}`, {
+            method: 'DELETE',
+        });
+    }
+    // Firewall Templates
+    async listFirewallTemplates() {
+        return this.request('/firewall/template');
+    }
+    async getFirewallTemplate(templateId) {
+        return this.request(`/firewall/template/${templateId}`);
+    }
+    async createFirewallTemplate(name, filterIpv6, whitelistHos, isDefault, rules) {
+        const params = { name };
+        if (filterIpv6 !== undefined)
+            params.filter_ipv6 = filterIpv6;
+        if (whitelistHos !== undefined)
+            params.whitelist_hos = whitelistHos;
+        if (isDefault !== undefined)
+            params.is_default = isDefault;
+        if (rules)
+            params['rules[input]'] = JSON.stringify(rules.input);
+        return this.request('/firewall/template', {
+            method: 'POST',
+            body: this.encodeParams(params),
+        });
+    }
+    async updateFirewallTemplate(templateId, name, filterIpv6, whitelistHos, isDefault, rules) {
+        const params = {};
+        if (name)
+            params.name = name;
+        if (filterIpv6 !== undefined)
+            params.filter_ipv6 = filterIpv6;
+        if (whitelistHos !== undefined)
+            params.whitelist_hos = whitelistHos;
+        if (isDefault !== undefined)
+            params.is_default = isDefault;
+        if (rules)
+            params['rules[input]'] = JSON.stringify(rules.input);
+        return this.request(`/firewall/template/${templateId}`, {
+            method: 'POST',
+            body: this.encodeParams(params),
+        });
+    }
+    async deleteFirewallTemplate(templateId) {
+        await this.request(`/firewall/template/${templateId}`, {
+            method: 'DELETE',
+        });
+    }
+    // =========================================================================
+    // vSwitch
+    // =========================================================================
+    async listVSwitches() {
+        return this.request('/vswitch');
+    }
+    async getVSwitch(id) {
+        return this.request(`/vswitch/${id}`);
+    }
+    async createVSwitch(name, vlan) {
+        return this.request('/vswitch', {
+            method: 'POST',
+            body: this.encodeParams({ name, vlan }),
+        });
+    }
+    async updateVSwitch(id, name, vlan) {
+        const params = {};
+        if (name)
+            params.name = name;
+        if (vlan !== undefined)
+            params.vlan = vlan;
+        return this.request(`/vswitch/${id}`, {
+            method: 'POST',
+            body: this.encodeParams(params),
+        });
+    }
+    async deleteVSwitch(id, cancellationDate) {
+        const params = {};
+        if (cancellationDate)
+            params.cancellation_date = cancellationDate;
+        await this.request(`/vswitch/${id}`, {
+            method: 'DELETE',
+            body: this.encodeParams(params),
+        });
+    }
+    async addServerToVSwitch(vswitchId, serverIpOrNumber) {
+        return this.request(`/vswitch/${vswitchId}/server`, {
+            method: 'POST',
+            body: this.encodeParams({ server: String(serverIpOrNumber) }),
+        });
+    }
+    async removeServerFromVSwitch(vswitchId, serverIpOrNumber) {
+        await this.request(`/vswitch/${vswitchId}/server`, {
+            method: 'DELETE',
+            body: this.encodeParams({ server: String(serverIpOrNumber) }),
+        });
+    }
+    // =========================================================================
+    // Storage Box
+    // =========================================================================
+    async listStorageBoxes() {
+        return this.request('/storagebox');
+    }
+    async getStorageBox(id) {
+        return this.request(`/storagebox/${id}`);
+    }
+    async updateStorageBox(id, name, webdav, samba, ssh, externalReachability, zfs) {
+        const params = {};
+        if (name)
+            params.storagebox_name = name;
+        if (webdav !== undefined)
+            params.webdav = webdav;
+        if (samba !== undefined)
+            params.samba = samba;
+        if (ssh !== undefined)
+            params.ssh = ssh;
+        if (externalReachability !== undefined)
+            params.external_reachability = externalReachability;
+        if (zfs !== undefined)
+            params.zfs = zfs;
+        return this.request(`/storagebox/${id}`, {
+            method: 'POST',
+            body: this.encodeParams(params),
+        });
+    }
+    async resetStorageBoxPassword(id) {
+        return this.request(`/storagebox/${id}/password`, {
+            method: 'POST',
+        });
+    }
+    // Snapshots
+    async listStorageBoxSnapshots(id) {
+        return this.request(`/storagebox/${id}/snapshot`);
+    }
+    async createStorageBoxSnapshot(id) {
+        return this.request(`/storagebox/${id}/snapshot`, {
+            method: 'POST',
+        });
+    }
+    async deleteStorageBoxSnapshot(id, snapshotName) {
+        await this.request(`/storagebox/${id}/snapshot/${snapshotName}`, {
+            method: 'DELETE',
+        });
+    }
+    async revertStorageBoxSnapshot(id, snapshotName) {
+        await this.request(`/storagebox/${id}/snapshot/${snapshotName}/revert`, {
+            method: 'POST',
+        });
+    }
+    // Snapshot Plan
+    async getStorageBoxSnapshotPlan(id) {
+        return this.request(`/storagebox/${id}/snapshotplan`);
+    }
+    async updateStorageBoxSnapshotPlan(id, status, minute, hour, dayOfWeek, dayOfMonth, maxSnapshots) {
+        const params = { status };
+        if (minute !== undefined)
+            params.minute = minute;
+        if (hour !== undefined)
+            params.hour = hour;
+        if (dayOfWeek !== undefined)
+            params.day_of_week = dayOfWeek;
+        if (dayOfMonth !== undefined)
+            params.day_of_month = dayOfMonth;
+        if (maxSnapshots !== undefined)
+            params.max_snapshots = maxSnapshots;
+        return this.request(`/storagebox/${id}/snapshotplan`, {
+            method: 'POST',
+            body: this.encodeParams(params),
+        });
+    }
+    // Subaccounts
+    async listStorageBoxSubaccounts(id) {
+        return this.request(`/storagebox/${id}/subaccount`);
+    }
+    async createStorageBoxSubaccount(id, homedirectory, samba, ssh, externalReachability, webdav, readonly, comment) {
+        const params = { homedirectory };
+        if (samba !== undefined)
+            params.samba = samba;
+        if (ssh !== undefined)
+            params.ssh = ssh;
+        if (externalReachability !== undefined)
+            params.external_reachability = externalReachability;
+        if (webdav !== undefined)
+            params.webdav = webdav;
+        if (readonly !== undefined)
+            params.readonly = readonly;
+        if (comment)
+            params.comment = comment;
+        return this.request(`/storagebox/${id}/subaccount`, {
+            method: 'POST',
+            body: this.encodeParams(params),
+        });
+    }
+    async updateStorageBoxSubaccount(id, username, samba, ssh, externalReachability, webdav, readonly, comment) {
+        const params = {};
+        if (samba !== undefined)
+            params.samba = samba;
+        if (ssh !== undefined)
+            params.ssh = ssh;
+        if (externalReachability !== undefined)
+            params.external_reachability = externalReachability;
+        if (webdav !== undefined)
+            params.webdav = webdav;
+        if (readonly !== undefined)
+            params.readonly = readonly;
+        if (comment !== undefined)
+            params.comment = comment;
+        return this.request(`/storagebox/${id}/subaccount/${username}`, {
+            method: 'PUT',
+            body: this.encodeParams(params),
+        });
+    }
+    async deleteStorageBoxSubaccount(id, username) {
+        await this.request(`/storagebox/${id}/subaccount/${username}`, {
+            method: 'DELETE',
+        });
+    }
+    async resetStorageBoxSubaccountPassword(id, username) {
+        return this.request(`/storagebox/${id}/subaccount/${username}/password`, {
+            method: 'POST',
+        });
+    }
+    // =========================================================================
+    // Traffic
+    // =========================================================================
+    async getTraffic(ips, subnets, from, to, type = 'month') {
+        const params = {
+            type,
+            from,
+            to,
+        };
+        if (ips.length > 0)
+            params.ip = ips;
+        if (subnets.length > 0)
+            params.subnet = subnets;
+        return this.request('/traffic', {
+            method: 'POST',
+            body: this.encodeParams(params),
+        });
+    }
+    // =========================================================================
+    // Wake on LAN
+    // =========================================================================
+    async getWol(serverIpOrNumber) {
+        return this.request(`/wol/${serverIpOrNumber}`);
+    }
+    async sendWol(serverIpOrNumber) {
+        return this.request(`/wol/${serverIpOrNumber}`, {
+            method: 'POST',
+        });
+    }
+    // =========================================================================
+    // Server Ordering
+    // =========================================================================
+    async listServerProducts() {
+        return this.request('/order/server/product');
+    }
+    async listServerMarketProducts() {
+        return this.request('/order/server_market/product');
+    }
+    async listServerTransactions() {
+        return this.request('/order/server/transaction');
+    }
+    async getServerTransaction(transactionId) {
+        return this.request(`/order/server/transaction/${transactionId}`);
+    }
+    async orderServer(productId, authorizedKeys, password, dist, arch, lang, location, addons, test) {
+        const params = this.buildOrderParams(productId, authorizedKeys, password, dist, arch, lang, addons, test);
+        if (location)
+            params.location = location;
+        return this.request('/order/server/transaction', {
+            method: 'POST',
+            body: this.encodeParams(params),
+        });
+    }
+    async orderServerMarket(productId, authorizedKeys, password, dist, arch, lang, addons, test) {
+        const params = this.buildOrderParams(productId, authorizedKeys, password, dist, arch, lang, addons, test);
+        return this.request('/order/server_market/transaction', {
+            method: 'POST',
+            body: this.encodeParams(params),
+        });
+    }
+    buildOrderParams(productId, authorizedKeys, password, dist, arch, lang, addons, test) {
+        const params = {
+            product_id: productId,
+        };
+        if (authorizedKeys)
+            params.authorized_key = authorizedKeys;
+        if (password)
+            params.password = password;
+        if (dist)
+            params.dist = dist;
+        if (arch)
+            params.arch = arch;
+        if (lang)
+            params.lang = lang;
+        if (addons)
+            params.addon = addons;
+        if (test !== undefined)
+            params.test = test;
+        return params;
+    }
+}

package/dist/config.d.ts

@@ -0,0 +1,41 @@
+export interface Config {
+    user?: string;
+    password?: string;
+}
+/**
+ * Load configuration from file
+ */
+export declare function loadConfig(): Config;
+/**
+ * Save configuration to file
+ */
+export declare function saveConfig(cfg: Config): void;
+/**
+ * Clear saved configuration
+ */
+export declare function clearConfig(): void;
+/**
+ * Get credentials from environment variables, config file, or prompt
+ */
+export declare function getCredentials(): {
+    user: string;
+    password: string;
+} | null;
+/**
+ * Check if credentials are configured
+ */
+export declare function hasCredentials(): boolean;
+/**
+ * Interactive login prompt
+ */
+export declare function promptLogin(): Promise<{
+    user: string;
+    password: string;
+}>;
+/**
+ * Get credentials, prompting if necessary
+ */
+export declare function requireCredentials(): Promise<{
+    user: string;
+    password: string;
+}>;