@rollupdate/hctl 0.0.0-stage → 3.0.0

package/dist/cloud/client.js

@@ -0,0 +1,755 @@
+// ============================================================================
+// Hetzner Cloud API Client
+// Base URL: https://api.hetzner.cloud/v1
+// Auth: Bearer Token
+// ============================================================================
+const BASE_URL = "https://api.hetzner.cloud/v1";
+export class HetznerCloudClient {
+    token;
+    constructor(token) {
+        this.token = token;
+    }
+    async request(endpoint, options = {}) {
+        const url = `${BASE_URL}${endpoint}`;
+        const headers = {
+            Authorization: `Bearer ${this.token}`,
+            "Content-Type": "application/json",
+            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);
+        }
+        if (response.status === 204) {
+            return {};
+        }
+        return response.json();
+    }
+    buildQuery(params) {
+        const parts = [];
+        for (const [key, value] of Object.entries(params)) {
+            if (value === undefined) {
+                continue;
+            }
+            parts.push(`${encodeURIComponent(key)}=${encodeURIComponent(String(value))}`);
+        }
+        return parts.length > 0 ? `?${parts.join("&")}` : "";
+    }
+    /**
+     * Fetch all pages of a paginated endpoint.
+     */
+    async listAll(endpoint, key, params = {}) {
+        const allItems = [];
+        let page = 1;
+        const perPage = 50;
+        while (true) {
+            const query = this.buildQuery({ ...params, page, per_page: perPage });
+            const response = await this.request(`${endpoint}${query}`);
+            const items = response[key];
+            if (!items || items.length === 0) {
+                break;
+            }
+            allItems.push(...items);
+            const meta = response.meta;
+            if (!meta?.pagination?.next_page) {
+                break;
+            }
+            page = meta.pagination.next_page;
+        }
+        return allItems;
+    }
+    /**
+     * Poll an action until it completes.
+     */
+    async waitForAction(actionId, timeoutMs = 300_000) {
+        const start = Date.now();
+        while (Date.now() - start < timeoutMs) {
+            const { action } = await this.request(`/actions/${actionId}`);
+            if (action.status === "success") {
+                return action;
+            }
+            if (action.status === "error") {
+                throw new Error(`Action ${actionId} failed: ${action.error?.message ?? "Unknown error"}`);
+            }
+            await new Promise((resolve) => setTimeout(resolve, 1000));
+        }
+        throw new Error(`Action ${actionId} timed out after ${timeoutMs}ms`);
+    }
+    // =========================================================================
+    // Datacenters (read-only)
+    // =========================================================================
+    // =========================================================================
+    // Pricing (read-only)
+    // =========================================================================
+    async getPricing() {
+        const { pricing } = await this.request("/pricing");
+        return pricing;
+    }
+    async listDatacenters(params = {}) {
+        return await this.listAll("/datacenters", "datacenters", params);
+    }
+    async getDatacenter(id) {
+        const { datacenter } = await this.request(`/datacenters/${id}`);
+        return datacenter;
+    }
+    // =========================================================================
+    // Locations (read-only)
+    // =========================================================================
+    async listLocations(params = {}) {
+        return await this.listAll("/locations", "locations", params);
+    }
+    async getLocation(id) {
+        const { location } = await this.request(`/locations/${id}`);
+        return location;
+    }
+    // =========================================================================
+    // Server Types (read-only)
+    // =========================================================================
+    async listServerTypes(params = {}) {
+        return await this.listAll("/server_types", "server_types", params);
+    }
+    async getServerType(id) {
+        const { server_type } = await this.request(`/server_types/${id}`);
+        return server_type;
+    }
+    // =========================================================================
+    // Load Balancer Types (read-only)
+    // =========================================================================
+    async listLoadBalancerTypes(params = {}) {
+        return await this.listAll("/load_balancer_types", "load_balancer_types", params);
+    }
+    async getLoadBalancerType(id) {
+        const { load_balancer_type } = await this.request(`/load_balancer_types/${id}`);
+        return load_balancer_type;
+    }
+    // =========================================================================
+    // ISOs (read-only)
+    // =========================================================================
+    async listIsos(params = {}) {
+        return await this.listAll("/isos", "isos", params);
+    }
+    async getIso(id) {
+        const { iso } = await this.request(`/isos/${id}`);
+        return iso;
+    }
+    // =========================================================================
+    // Servers
+    // =========================================================================
+    async listServers(params = {}) {
+        return await this.listAll("/servers", "servers", params);
+    }
+    async getServer(id) {
+        const { server } = await this.request(`/servers/${id}`);
+        return server;
+    }
+    async createServer(opts) {
+        return await this.request("/servers", {
+            method: "POST",
+            body: JSON.stringify(opts),
+        });
+    }
+    async deleteServer(id) {
+        return await this.request(`/servers/${id}`, {
+            method: "DELETE",
+        });
+    }
+    async updateServer(id, opts) {
+        return await this.request(`/servers/${id}`, {
+            method: "PUT",
+            body: JSON.stringify(opts),
+        });
+    }
+    async powerOnServer(id) {
+        return await this.request(`/servers/${id}/actions/poweron`, {
+            method: "POST",
+        });
+    }
+    async powerOffServer(id) {
+        return await this.request(`/servers/${id}/actions/poweroff`, {
+            method: "POST",
+        });
+    }
+    async rebootServer(id) {
+        return await this.request(`/servers/${id}/actions/reboot`, {
+            method: "POST",
+        });
+    }
+    async resetServer(id) {
+        return await this.request(`/servers/${id}/actions/reset`, {
+            method: "POST",
+        });
+    }
+    async shutdownServer(id) {
+        return await this.request(`/servers/${id}/actions/shutdown`, {
+            method: "POST",
+        });
+    }
+    async rebuildServer(id, image) {
+        return await this.request(`/servers/${id}/actions/rebuild`, {
+            method: "POST",
+            body: JSON.stringify({ image }),
+        });
+    }
+    async changeServerType(id, serverType, upgradeDisk) {
+        return await this.request(`/servers/${id}/actions/change_type`, {
+            method: "POST",
+            body: JSON.stringify({
+                server_type: serverType,
+                upgrade_disk: upgradeDisk,
+            }),
+        });
+    }
+    async enableServerRescue(id, type = "linux64", sshKeys) {
+        return await this.request(`/servers/${id}/actions/enable_rescue`, {
+            method: "POST",
+            body: JSON.stringify({ type, ssh_keys: sshKeys }),
+        });
+    }
+    async disableServerRescue(id) {
+        return await this.request(`/servers/${id}/actions/disable_rescue`, {
+            method: "POST",
+        });
+    }
+    async enableServerBackup(id) {
+        return await this.request(`/servers/${id}/actions/enable_backup`, {
+            method: "POST",
+        });
+    }
+    async disableServerBackup(id) {
+        return await this.request(`/servers/${id}/actions/disable_backup`, {
+            method: "POST",
+        });
+    }
+    async createServerImage(id, opts) {
+        return await this.request(`/servers/${id}/actions/create_image`, {
+            method: "POST",
+            body: JSON.stringify(opts),
+        });
+    }
+    async attachIsoToServer(id, iso) {
+        return await this.request(`/servers/${id}/actions/attach_iso`, {
+            method: "POST",
+            body: JSON.stringify({ iso }),
+        });
+    }
+    async detachIsoFromServer(id) {
+        return await this.request(`/servers/${id}/actions/detach_iso`, {
+            method: "POST",
+        });
+    }
+    async resetServerPassword(id) {
+        return await this.request(`/servers/${id}/actions/reset_password`, {
+            method: "POST",
+        });
+    }
+    async setServerRdns(id, ip, dnsPtr) {
+        return await this.request(`/servers/${id}/actions/change_dns_ptr`, {
+            method: "POST",
+            body: JSON.stringify({ ip, dns_ptr: dnsPtr }),
+        });
+    }
+    async enableServerProtection(id, opts) {
+        return await this.request(`/servers/${id}/actions/change_protection`, {
+            method: "POST",
+            body: JSON.stringify(opts),
+        });
+    }
+    async requestServerConsole(id) {
+        return await this.request(`/servers/${id}/actions/request_console`, {
+            method: "POST",
+        });
+    }
+    async attachServerToNetwork(id, network, ip, aliasIps) {
+        return await this.request(`/servers/${id}/actions/attach_to_network`, {
+            method: "POST",
+            body: JSON.stringify({ network, ip, alias_ips: aliasIps }),
+        });
+    }
+    async detachServerFromNetwork(id, network) {
+        return await this.request(`/servers/${id}/actions/detach_from_network`, {
+            method: "POST",
+            body: JSON.stringify({ network }),
+        });
+    }
+    async addServerToPlacementGroup(id, placementGroup) {
+        return await this.request(`/servers/${id}/actions/add_to_placement_group`, {
+            method: "POST",
+            body: JSON.stringify({ placement_group: placementGroup }),
+        });
+    }
+    async removeServerFromPlacementGroup(id) {
+        return await this.request(`/servers/${id}/actions/remove_from_placement_group`, {
+            method: "POST",
+        });
+    }
+    async getServerMetrics(id, type, start, end) {
+        const query = this.buildQuery({ type, start, end });
+        return await this.request(`/servers/${id}/metrics${query}`);
+    }
+    // =========================================================================
+    // Networks
+    // =========================================================================
+    async listNetworks(params = {}) {
+        return await this.listAll("/networks", "networks", params);
+    }
+    async getNetwork(id) {
+        const { network } = await this.request(`/networks/${id}`);
+        return network;
+    }
+    async createNetwork(opts) {
+        return await this.request("/networks", {
+            method: "POST",
+            body: JSON.stringify(opts),
+        });
+    }
+    async deleteNetwork(id) {
+        await this.request(`/networks/${id}`, { method: "DELETE" });
+    }
+    async updateNetwork(id, opts) {
+        return await this.request(`/networks/${id}`, {
+            method: "PUT",
+            body: JSON.stringify(opts),
+        });
+    }
+    async addSubnetToNetwork(id, subnet) {
+        return await this.request(`/networks/${id}/actions/add_subnet`, {
+            method: "POST",
+            body: JSON.stringify(subnet),
+        });
+    }
+    async deleteSubnetFromNetwork(id, ipRange) {
+        return await this.request(`/networks/${id}/actions/delete_subnet`, {
+            method: "POST",
+            body: JSON.stringify({ ip_range: ipRange }),
+        });
+    }
+    async addRouteToNetwork(id, route) {
+        return await this.request(`/networks/${id}/actions/add_route`, {
+            method: "POST",
+            body: JSON.stringify(route),
+        });
+    }
+    async deleteRouteFromNetwork(id, route) {
+        return await this.request(`/networks/${id}/actions/delete_route`, {
+            method: "POST",
+            body: JSON.stringify(route),
+        });
+    }
+    async changeNetworkIpRange(id, ipRange) {
+        return await this.request(`/networks/${id}/actions/change_ip_range`, {
+            method: "POST",
+            body: JSON.stringify({ ip_range: ipRange }),
+        });
+    }
+    async changeNetworkProtection(id, deleteProtection) {
+        return await this.request(`/networks/${id}/actions/change_protection`, {
+            method: "POST",
+            body: JSON.stringify({ delete: deleteProtection }),
+        });
+    }
+    // =========================================================================
+    // Cloud Firewalls
+    // =========================================================================
+    async listFirewalls(params = {}) {
+        return await this.listAll("/firewalls", "firewalls", params);
+    }
+    async getFirewall(id) {
+        const { firewall } = await this.request(`/firewalls/${id}`);
+        return firewall;
+    }
+    async createFirewall(opts) {
+        return await this.request("/firewalls", {
+            method: "POST",
+            body: JSON.stringify(opts),
+        });
+    }
+    async deleteFirewall(id) {
+        await this.request(`/firewalls/${id}`, { method: "DELETE" });
+    }
+    async updateFirewall(id, opts) {
+        return await this.request(`/firewalls/${id}`, {
+            method: "PUT",
+            body: JSON.stringify(opts),
+        });
+    }
+    async setFirewallRules(id, rules) {
+        return await this.request(`/firewalls/${id}/actions/set_rules`, {
+            method: "POST",
+            body: JSON.stringify({ rules }),
+        });
+    }
+    async applyFirewall(id, applyTo) {
+        return await this.request(`/firewalls/${id}/actions/apply_to_resources`, {
+            method: "POST",
+            body: JSON.stringify({ apply_to: applyTo }),
+        });
+    }
+    async removeFirewallFromResources(id, removeFrom) {
+        return await this.request(`/firewalls/${id}/actions/remove_from_resources`, {
+            method: "POST",
+            body: JSON.stringify({ remove_from: removeFrom }),
+        });
+    }
+    // =========================================================================
+    // Floating IPs
+    // =========================================================================
+    async listFloatingIps(params = {}) {
+        return await this.listAll("/floating_ips", "floating_ips", params);
+    }
+    async getFloatingIp(id) {
+        const { floating_ip } = await this.request(`/floating_ips/${id}`);
+        return floating_ip;
+    }
+    async createFloatingIp(opts) {
+        return await this.request("/floating_ips", {
+            method: "POST",
+            body: JSON.stringify(opts),
+        });
+    }
+    async deleteFloatingIp(id) {
+        await this.request(`/floating_ips/${id}`, { method: "DELETE" });
+    }
+    async updateFloatingIp(id, opts) {
+        return await this.request(`/floating_ips/${id}`, {
+            method: "PUT",
+            body: JSON.stringify(opts),
+        });
+    }
+    async assignFloatingIp(id, serverId) {
+        return await this.request(`/floating_ips/${id}/actions/assign`, {
+            method: "POST",
+            body: JSON.stringify({ server: serverId }),
+        });
+    }
+    async unassignFloatingIp(id) {
+        return await this.request(`/floating_ips/${id}/actions/unassign`, {
+            method: "POST",
+        });
+    }
+    async changeFloatingIpProtection(id, deleteProtection) {
+        return await this.request(`/floating_ips/${id}/actions/change_protection`, {
+            method: "POST",
+            body: JSON.stringify({ delete: deleteProtection }),
+        });
+    }
+    async changeFloatingIpDnsPtr(id, ip, dnsPtr) {
+        return await this.request(`/floating_ips/${id}/actions/change_dns_ptr`, {
+            method: "POST",
+            body: JSON.stringify({ ip, dns_ptr: dnsPtr }),
+        });
+    }
+    // =========================================================================
+    // Primary IPs
+    // =========================================================================
+    async listPrimaryIps(params = {}) {
+        return await this.listAll("/primary_ips", "primary_ips", params);
+    }
+    async getPrimaryIp(id) {
+        const { primary_ip } = await this.request(`/primary_ips/${id}`);
+        return primary_ip;
+    }
+    async createPrimaryIp(opts) {
+        return await this.request("/primary_ips", {
+            method: "POST",
+            body: JSON.stringify(opts),
+        });
+    }
+    async deletePrimaryIp(id) {
+        await this.request(`/primary_ips/${id}`, { method: "DELETE" });
+    }
+    async updatePrimaryIp(id, opts) {
+        return await this.request(`/primary_ips/${id}`, {
+            method: "PUT",
+            body: JSON.stringify(opts),
+        });
+    }
+    async assignPrimaryIp(id, assigneeId, assigneeType = "server") {
+        return await this.request(`/primary_ips/${id}/actions/assign`, {
+            method: "POST",
+            body: JSON.stringify({
+                assignee_id: assigneeId,
+                assignee_type: assigneeType,
+            }),
+        });
+    }
+    async unassignPrimaryIp(id) {
+        return await this.request(`/primary_ips/${id}/actions/unassign`, {
+            method: "POST",
+        });
+    }
+    async changePrimaryIpProtection(id, deleteProtection) {
+        return await this.request(`/primary_ips/${id}/actions/change_protection`, {
+            method: "POST",
+            body: JSON.stringify({ delete: deleteProtection }),
+        });
+    }
+    async changePrimaryIpDnsPtr(id, ip, dnsPtr) {
+        return await this.request(`/primary_ips/${id}/actions/change_dns_ptr`, {
+            method: "POST",
+            body: JSON.stringify({ ip, dns_ptr: dnsPtr }),
+        });
+    }
+    // =========================================================================
+    // Volumes
+    // =========================================================================
+    async listVolumes(params = {}) {
+        return await this.listAll("/volumes", "volumes", params);
+    }
+    async getVolume(id) {
+        const { volume } = await this.request(`/volumes/${id}`);
+        return volume;
+    }
+    async createVolume(opts) {
+        return await this.request("/volumes", {
+            method: "POST",
+            body: JSON.stringify(opts),
+        });
+    }
+    async deleteVolume(id) {
+        await this.request(`/volumes/${id}`, { method: "DELETE" });
+    }
+    async updateVolume(id, opts) {
+        return await this.request(`/volumes/${id}`, {
+            method: "PUT",
+            body: JSON.stringify(opts),
+        });
+    }
+    async attachVolume(id, serverId, automount) {
+        return await this.request(`/volumes/${id}/actions/attach`, {
+            method: "POST",
+            body: JSON.stringify({ server: serverId, automount }),
+        });
+    }
+    async detachVolume(id) {
+        return await this.request(`/volumes/${id}/actions/detach`, {
+            method: "POST",
+        });
+    }
+    async resizeVolume(id, size) {
+        return await this.request(`/volumes/${id}/actions/resize`, {
+            method: "POST",
+            body: JSON.stringify({ size }),
+        });
+    }
+    async changeVolumeProtection(id, deleteProtection) {
+        return await this.request(`/volumes/${id}/actions/change_protection`, {
+            method: "POST",
+            body: JSON.stringify({ delete: deleteProtection }),
+        });
+    }
+    // =========================================================================
+    // Load Balancers
+    // =========================================================================
+    async listLoadBalancers(params = {}) {
+        return await this.listAll("/load_balancers", "load_balancers", params);
+    }
+    async getLoadBalancer(id) {
+        const { load_balancer } = await this.request(`/load_balancers/${id}`);
+        return load_balancer;
+    }
+    async createLoadBalancer(opts) {
+        return await this.request("/load_balancers", {
+            method: "POST",
+            body: JSON.stringify(opts),
+        });
+    }
+    async deleteLoadBalancer(id) {
+        await this.request(`/load_balancers/${id}`, { method: "DELETE" });
+    }
+    async updateLoadBalancer(id, opts) {
+        return await this.request(`/load_balancers/${id}`, {
+            method: "PUT",
+            body: JSON.stringify(opts),
+        });
+    }
+    async addTargetToLoadBalancer(id, target) {
+        return await this.request(`/load_balancers/${id}/actions/add_target`, {
+            method: "POST",
+            body: JSON.stringify(target),
+        });
+    }
+    async removeTargetFromLoadBalancer(id, target) {
+        return await this.request(`/load_balancers/${id}/actions/remove_target`, {
+            method: "POST",
+            body: JSON.stringify(target),
+        });
+    }
+    async addServiceToLoadBalancer(id, service) {
+        return await this.request(`/load_balancers/${id}/actions/add_service`, {
+            method: "POST",
+            body: JSON.stringify(service),
+        });
+    }
+    async updateServiceOnLoadBalancer(id, service) {
+        return await this.request(`/load_balancers/${id}/actions/update_service`, {
+            method: "POST",
+            body: JSON.stringify(service),
+        });
+    }
+    async deleteServiceFromLoadBalancer(id, listenPort) {
+        return await this.request(`/load_balancers/${id}/actions/delete_service`, {
+            method: "POST",
+            body: JSON.stringify({ listen_port: listenPort }),
+        });
+    }
+    async changeLoadBalancerAlgorithm(id, type) {
+        return await this.request(`/load_balancers/${id}/actions/change_algorithm`, {
+            method: "POST",
+            body: JSON.stringify({ type }),
+        });
+    }
+    async changeLoadBalancerType(id, loadBalancerType) {
+        return await this.request(`/load_balancers/${id}/actions/change_type`, {
+            method: "POST",
+            body: JSON.stringify({ load_balancer_type: loadBalancerType }),
+        });
+    }
+    async attachLoadBalancerToNetwork(id, network, ip) {
+        return await this.request(`/load_balancers/${id}/actions/attach_to_network`, {
+            method: "POST",
+            body: JSON.stringify({ network, ip }),
+        });
+    }
+    async detachLoadBalancerFromNetwork(id, network) {
+        return await this.request(`/load_balancers/${id}/actions/detach_from_network`, {
+            method: "POST",
+            body: JSON.stringify({ network }),
+        });
+    }
+    async enableLoadBalancerPublicInterface(id) {
+        return await this.request(`/load_balancers/${id}/actions/enable_public_interface`, { method: "POST" });
+    }
+    async disableLoadBalancerPublicInterface(id) {
+        return await this.request(`/load_balancers/${id}/actions/disable_public_interface`, { method: "POST" });
+    }
+    async changeLoadBalancerProtection(id, deleteProtection) {
+        return await this.request(`/load_balancers/${id}/actions/change_protection`, {
+            method: "POST",
+            body: JSON.stringify({ delete: deleteProtection }),
+        });
+    }
+    // =========================================================================
+    // Images
+    // =========================================================================
+    async listImages(params = {}) {
+        return await this.listAll("/images", "images", params);
+    }
+    async getImage(id) {
+        const { image } = await this.request(`/images/${id}`);
+        return image;
+    }
+    async updateImage(id, opts) {
+        return await this.request(`/images/${id}`, {
+            method: "PUT",
+            body: JSON.stringify(opts),
+        });
+    }
+    async deleteImage(id) {
+        await this.request(`/images/${id}`, { method: "DELETE" });
+    }
+    async changeImageProtection(id, deleteProtection) {
+        return await this.request(`/images/${id}/actions/change_protection`, {
+            method: "POST",
+            body: JSON.stringify({ delete: deleteProtection }),
+        });
+    }
+    // =========================================================================
+    // SSH Keys (Cloud)
+    // =========================================================================
+    async listSshKeys(params = {}) {
+        return await this.listAll("/ssh_keys", "ssh_keys", params);
+    }
+    async getSshKey(id) {
+        const { ssh_key } = await this.request(`/ssh_keys/${id}`);
+        return ssh_key;
+    }
+    async createSshKey(opts) {
+        return await this.request("/ssh_keys", {
+            method: "POST",
+            body: JSON.stringify(opts),
+        });
+    }
+    async updateSshKey(id, opts) {
+        return await this.request(`/ssh_keys/${id}`, {
+            method: "PUT",
+            body: JSON.stringify(opts),
+        });
+    }
+    async deleteSshKey(id) {
+        await this.request(`/ssh_keys/${id}`, { method: "DELETE" });
+    }
+    // =========================================================================
+    // Certificates
+    // =========================================================================
+    async listCertificates(params = {}) {
+        return await this.listAll("/certificates", "certificates", params);
+    }
+    async getCertificate(id) {
+        const { certificate } = await this.request(`/certificates/${id}`);
+        return certificate;
+    }
+    async createCertificate(opts) {
+        return await this.request("/certificates", {
+            method: "POST",
+            body: JSON.stringify(opts),
+        });
+    }
+    async updateCertificate(id, opts) {
+        return await this.request(`/certificates/${id}`, {
+            method: "PUT",
+            body: JSON.stringify(opts),
+        });
+    }
+    async deleteCertificate(id) {
+        await this.request(`/certificates/${id}`, { method: "DELETE" });
+    }
+    // =========================================================================
+    // Placement Groups
+    // =========================================================================
+    async listPlacementGroups(params = {}) {
+        return await this.listAll("/placement_groups", "placement_groups", params);
+    }
+    async getPlacementGroup(id) {
+        const { placement_group } = await this.request(`/placement_groups/${id}`);
+        return placement_group;
+    }
+    async createPlacementGroup(opts) {
+        return await this.request("/placement_groups", {
+            method: "POST",
+            body: JSON.stringify(opts),
+        });
+    }
+    async updatePlacementGroup(id, opts) {
+        return await this.request(`/placement_groups/${id}`, {
+            method: "PUT",
+            body: JSON.stringify(opts),
+        });
+    }
+    async deletePlacementGroup(id) {
+        await this.request(`/placement_groups/${id}`, { method: "DELETE" });
+    }
+    // =========================================================================
+    // Actions (generic)
+    // =========================================================================
+    async getAction(id) {
+        const { action } = await this.request(`/actions/${id}`);
+        return action;
+    }
+    async listActions(params = {}) {
+        return await this.listAll("/actions", "actions", params);
+    }
+}