@rollupdate/hctl 0.0.0-stage → 3.0.0

package/dist/robot/client.js

@@ -0,0 +1,719 @@
+// ============================================================================
+// 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 empty responses (204 No Content, or 200 with empty body)
+        const text = await response.text();
+        if (!text) {
+            return {};
+        }
+        return JSON.parse(text);
+    }
+    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 await this.request("/server");
+    }
+    async getServer(serverIpOrNumber) {
+        return await this.request(`/server/${serverIpOrNumber}`);
+    }
+    async updateServerName(serverIpOrNumber, name) {
+        return await this.request(`/server/${serverIpOrNumber}`, {
+            method: "POST",
+            body: this.encodeParams({ server_name: name }),
+        });
+    }
+    // =========================================================================
+    // Cancellation
+    // =========================================================================
+    async getCancellation(serverIpOrNumber) {
+        return await 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 await 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 await this.request("/reset");
+    }
+    async getResetOptions(serverIpOrNumber) {
+        return await this.request(`/reset/${serverIpOrNumber}`);
+    }
+    async resetServer(serverIpOrNumber, type = "sw") {
+        return await this.request(`/reset/${serverIpOrNumber}`, {
+            method: "POST",
+            body: this.encodeParams({ type }),
+        });
+    }
+    // =========================================================================
+    // Boot Configuration
+    // =========================================================================
+    async getBootConfig(serverIpOrNumber) {
+        return await this.request(`/boot/${serverIpOrNumber}`);
+    }
+    // Rescue System
+    async getRescue(serverIpOrNumber) {
+        return await 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 await this.request(`/boot/${serverIpOrNumber}/rescue`, {
+            method: "POST",
+            body: this.encodeParams(params),
+        });
+    }
+    async deactivateRescue(serverIpOrNumber) {
+        return await this.request(`/boot/${serverIpOrNumber}/rescue`, {
+            method: "DELETE",
+        });
+    }
+    async getLastRescue(serverIpOrNumber) {
+        return await this.request(`/boot/${serverIpOrNumber}/rescue/last`);
+    }
+    // Linux Install
+    async getLinux(serverIpOrNumber) {
+        return await 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 await this.request(`/boot/${serverIpOrNumber}/linux`, {
+            method: "POST",
+            body: this.encodeParams(params),
+        });
+    }
+    async deactivateLinux(serverIpOrNumber) {
+        return await this.request(`/boot/${serverIpOrNumber}/linux`, {
+            method: "DELETE",
+        });
+    }
+    async getLastLinux(serverIpOrNumber) {
+        return await this.request(`/boot/${serverIpOrNumber}/linux/last`);
+    }
+    // VNC Install
+    async getVnc(serverIpOrNumber) {
+        return await 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 await this.request(`/boot/${serverIpOrNumber}/vnc`, {
+            method: "POST",
+            body: this.encodeParams(params),
+        });
+    }
+    async deactivateVnc(serverIpOrNumber) {
+        return await this.request(`/boot/${serverIpOrNumber}/vnc`, {
+            method: "DELETE",
+        });
+    }
+    // Windows Install
+    async getWindows(serverIpOrNumber) {
+        return await this.request(`/boot/${serverIpOrNumber}/windows`);
+    }
+    async activateWindows(serverIpOrNumber, dist, lang) {
+        const params = { dist };
+        if (lang) {
+            params.lang = lang;
+        }
+        return await this.request(`/boot/${serverIpOrNumber}/windows`, {
+            method: "POST",
+            body: this.encodeParams(params),
+        });
+    }
+    async deactivateWindows(serverIpOrNumber) {
+        return await this.request(`/boot/${serverIpOrNumber}/windows`, {
+            method: "DELETE",
+        });
+    }
+    // =========================================================================
+    // IP Management
+    // =========================================================================
+    async listIps() {
+        return await this.request("/ip");
+    }
+    async getIp(ip) {
+        return await this.request(`/ip/${ip}`);
+    }
+    async updateIp(ip, trafficWarnings, trafficHourly, trafficDaily, trafficMonthly) {
+        return await this.request(`/ip/${ip}`, {
+            method: "POST",
+            body: this.encodeParams(this.buildTrafficParams(trafficWarnings, trafficHourly, trafficDaily, trafficMonthly)),
+        });
+    }
+    async getIpMac(ip) {
+        return await this.request(`/ip/${ip}/mac`);
+    }
+    async generateIpMac(ip) {
+        return await this.request(`/ip/${ip}/mac`, {
+            method: "PUT",
+        });
+    }
+    async deleteIpMac(ip) {
+        await this.request(`/ip/${ip}/mac`, {
+            method: "DELETE",
+        });
+    }
+    // =========================================================================
+    // Subnet Management
+    // =========================================================================
+    async listSubnets() {
+        return await this.request("/subnet");
+    }
+    async getSubnet(netIp) {
+        return await this.request(`/subnet/${netIp}`);
+    }
+    async updateSubnet(netIp, trafficWarnings, trafficHourly, trafficDaily, trafficMonthly) {
+        return await this.request(`/subnet/${netIp}`, {
+            method: "POST",
+            body: this.encodeParams(this.buildTrafficParams(trafficWarnings, trafficHourly, trafficDaily, trafficMonthly)),
+        });
+    }
+    async getSubnetMac(netIp) {
+        return await this.request(`/subnet/${netIp}/mac`);
+    }
+    async generateSubnetMac(netIp) {
+        return await this.request(`/subnet/${netIp}/mac`, {
+            method: "PUT",
+        });
+    }
+    async deleteSubnetMac(netIp) {
+        await this.request(`/subnet/${netIp}/mac`, {
+            method: "DELETE",
+        });
+    }
+    // =========================================================================
+    // Failover
+    // =========================================================================
+    async listFailovers() {
+        return await this.request("/failover");
+    }
+    async getFailover(failoverIp) {
+        return await this.request(`/failover/${failoverIp}`);
+    }
+    async switchFailover(failoverIp, activeServerIp) {
+        return await 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 await this.request("/rdns");
+    }
+    async getRdns(ip) {
+        return await this.request(`/rdns/${ip}`);
+    }
+    async createRdns(ip, ptr) {
+        return await this.request(`/rdns/${ip}`, {
+            method: "PUT",
+            body: this.encodeParams({ ptr }),
+        });
+    }
+    async updateRdns(ip, ptr) {
+        return await 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 await this.request("/key");
+    }
+    async getSshKey(fingerprint) {
+        return await this.request(`/key/${fingerprint}`);
+    }
+    async createSshKey(name, data) {
+        return await this.request("/key", {
+            method: "POST",
+            body: this.encodeParams({ name, data }),
+        });
+    }
+    async updateSshKey(fingerprint, name) {
+        return await 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 await this.request(`/firewall/${serverIpOrNumber}`);
+    }
+    async updateFirewall(serverIpOrNumber, status, rules) {
+        const params = { status };
+        if (rules) {
+            params["rules[input]"] = JSON.stringify(rules.input);
+        }
+        return await 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 await this.request("/firewall/template");
+    }
+    async getFirewallTemplate(templateId) {
+        return await 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 await 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 await 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 await this.request("/vswitch");
+    }
+    async getVSwitch(id) {
+        return await this.request(`/vswitch/${id}`);
+    }
+    async createVSwitch(name, vlan) {
+        return await 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;
+        }
+        await 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) {
+        await 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 await this.request("/storagebox");
+    }
+    async getStorageBox(id) {
+        return await 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 await this.request(`/storagebox/${id}`, {
+            method: "POST",
+            body: this.encodeParams(params),
+        });
+    }
+    async resetStorageBoxPassword(id) {
+        return await this.request(`/storagebox/${id}/password`, {
+            method: "POST",
+        });
+    }
+    // Snapshots
+    async listStorageBoxSnapshots(id) {
+        return await this.request(`/storagebox/${id}/snapshot`);
+    }
+    async createStorageBoxSnapshot(id) {
+        return await 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 await 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 await this.request(`/storagebox/${id}/snapshotplan`, {
+            method: "POST",
+            body: this.encodeParams(params),
+        });
+    }
+    // Subaccounts
+    async listStorageBoxSubaccounts(id) {
+        return await 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 await 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 await 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 await 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 await this.request("/traffic", {
+            method: "POST",
+            body: this.encodeParams(params),
+        });
+    }
+    // =========================================================================
+    // Wake on LAN
+    // =========================================================================
+    async getWol(serverIpOrNumber) {
+        return await this.request(`/wol/${serverIpOrNumber}`);
+    }
+    async sendWol(serverIpOrNumber) {
+        return await this.request(`/wol/${serverIpOrNumber}`, {
+            method: "POST",
+        });
+    }
+    // =========================================================================
+    // Server Ordering
+    // =========================================================================
+    async listServerProducts() {
+        return await this.request("/order/server/product");
+    }
+    async listServerMarketProducts() {
+        return await this.request("/order/server_market/product");
+    }
+    async listServerTransactions() {
+        return await this.request("/order/server/transaction");
+    }
+    async getServerTransaction(transactionId) {
+        return await 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 await 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 await 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;
+    }
+}