hetzner-cli 2.0.0

package/dist/cloud/client.js

@@ -0,0 +1,706 @@
+// ============================================================================
+// 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 = 300000) {
+        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)
+    // =========================================================================
+    async listDatacenters() {
+        return this.listAll('/datacenters', 'datacenters');
+    }
+    async getDatacenter(id) {
+        const { datacenter } = await this.request(`/datacenters/${id}`);
+        return datacenter;
+    }
+    // =========================================================================
+    // Locations (read-only)
+    // =========================================================================
+    async listLocations() {
+        return this.listAll('/locations', 'locations');
+    }
+    async getLocation(id) {
+        const { location } = await this.request(`/locations/${id}`);
+        return location;
+    }
+    // =========================================================================
+    // Server Types (read-only)
+    // =========================================================================
+    async listServerTypes() {
+        return this.listAll('/server_types', 'server_types');
+    }
+    async getServerType(id) {
+        const { server_type } = await this.request(`/server_types/${id}`);
+        return server_type;
+    }
+    // =========================================================================
+    // Load Balancer Types (read-only)
+    // =========================================================================
+    async listLoadBalancerTypes() {
+        return this.listAll('/load_balancer_types', 'load_balancer_types');
+    }
+    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 this.listAll('/isos', 'isos', params);
+    }
+    async getIso(id) {
+        const { iso } = await this.request(`/isos/${id}`);
+        return iso;
+    }
+    // =========================================================================
+    // Servers
+    // =========================================================================
+    async listServers(params = {}) {
+        return this.listAll('/servers', 'servers', params);
+    }
+    async getServer(id) {
+        const { server } = await this.request(`/servers/${id}`);
+        return server;
+    }
+    async createServer(opts) {
+        return this.request('/servers', {
+            method: 'POST',
+            body: JSON.stringify(opts),
+        });
+    }
+    async deleteServer(id) {
+        return this.request(`/servers/${id}`, { method: 'DELETE' });
+    }
+    async updateServer(id, opts) {
+        return this.request(`/servers/${id}`, {
+            method: 'PUT',
+            body: JSON.stringify(opts),
+        });
+    }
+    async powerOnServer(id) {
+        return this.request(`/servers/${id}/actions/poweron`, { method: 'POST' });
+    }
+    async powerOffServer(id) {
+        return this.request(`/servers/${id}/actions/poweroff`, { method: 'POST' });
+    }
+    async rebootServer(id) {
+        return this.request(`/servers/${id}/actions/reboot`, { method: 'POST' });
+    }
+    async resetServer(id) {
+        return this.request(`/servers/${id}/actions/reset`, { method: 'POST' });
+    }
+    async shutdownServer(id) {
+        return this.request(`/servers/${id}/actions/shutdown`, { method: 'POST' });
+    }
+    async rebuildServer(id, image) {
+        return this.request(`/servers/${id}/actions/rebuild`, {
+            method: 'POST',
+            body: JSON.stringify({ image }),
+        });
+    }
+    async changeServerType(id, serverType, upgradeDisk) {
+        return 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 this.request(`/servers/${id}/actions/enable_rescue`, {
+            method: 'POST',
+            body: JSON.stringify({ type, ssh_keys: sshKeys }),
+        });
+    }
+    async disableServerRescue(id) {
+        return this.request(`/servers/${id}/actions/disable_rescue`, { method: 'POST' });
+    }
+    async enableServerBackup(id) {
+        return this.request(`/servers/${id}/actions/enable_backup`, { method: 'POST' });
+    }
+    async disableServerBackup(id) {
+        return this.request(`/servers/${id}/actions/disable_backup`, { method: 'POST' });
+    }
+    async createServerImage(id, opts) {
+        return this.request(`/servers/${id}/actions/create_image`, {
+            method: 'POST',
+            body: JSON.stringify(opts),
+        });
+    }
+    async attachIsoToServer(id, iso) {
+        return this.request(`/servers/${id}/actions/attach_iso`, {
+            method: 'POST',
+            body: JSON.stringify({ iso }),
+        });
+    }
+    async detachIsoFromServer(id) {
+        return this.request(`/servers/${id}/actions/detach_iso`, { method: 'POST' });
+    }
+    async resetServerPassword(id) {
+        return this.request(`/servers/${id}/actions/reset_password`, { method: 'POST' });
+    }
+    async setServerRdns(id, ip, dnsPtr) {
+        return this.request(`/servers/${id}/actions/change_dns_ptr`, {
+            method: 'POST',
+            body: JSON.stringify({ ip, dns_ptr: dnsPtr }),
+        });
+    }
+    async enableServerProtection(id, opts) {
+        return this.request(`/servers/${id}/actions/change_protection`, {
+            method: 'POST',
+            body: JSON.stringify(opts),
+        });
+    }
+    async requestServerConsole(id) {
+        return this.request(`/servers/${id}/actions/request_console`, { method: 'POST' });
+    }
+    async attachServerToNetwork(id, network, ip, aliasIps) {
+        return this.request(`/servers/${id}/actions/attach_to_network`, {
+            method: 'POST',
+            body: JSON.stringify({ network, ip, alias_ips: aliasIps }),
+        });
+    }
+    async detachServerFromNetwork(id, network) {
+        return this.request(`/servers/${id}/actions/detach_from_network`, {
+            method: 'POST',
+            body: JSON.stringify({ network }),
+        });
+    }
+    async addServerToPlacementGroup(id, placementGroup) {
+        return this.request(`/servers/${id}/actions/add_to_placement_group`, {
+            method: 'POST',
+            body: JSON.stringify({ placement_group: placementGroup }),
+        });
+    }
+    async removeServerFromPlacementGroup(id) {
+        return 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 this.request(`/servers/${id}/metrics${query}`);
+    }
+    // =========================================================================
+    // Networks
+    // =========================================================================
+    async listNetworks(params = {}) {
+        return this.listAll('/networks', 'networks', params);
+    }
+    async getNetwork(id) {
+        const { network } = await this.request(`/networks/${id}`);
+        return network;
+    }
+    async createNetwork(opts) {
+        return this.request('/networks', {
+            method: 'POST',
+            body: JSON.stringify(opts),
+        });
+    }
+    async deleteNetwork(id) {
+        await this.request(`/networks/${id}`, { method: 'DELETE' });
+    }
+    async updateNetwork(id, opts) {
+        return this.request(`/networks/${id}`, {
+            method: 'PUT',
+            body: JSON.stringify(opts),
+        });
+    }
+    async addSubnetToNetwork(id, subnet) {
+        return this.request(`/networks/${id}/actions/add_subnet`, {
+            method: 'POST',
+            body: JSON.stringify(subnet),
+        });
+    }
+    async deleteSubnetFromNetwork(id, ipRange) {
+        return this.request(`/networks/${id}/actions/delete_subnet`, {
+            method: 'POST',
+            body: JSON.stringify({ ip_range: ipRange }),
+        });
+    }
+    async addRouteToNetwork(id, route) {
+        return this.request(`/networks/${id}/actions/add_route`, {
+            method: 'POST',
+            body: JSON.stringify(route),
+        });
+    }
+    async deleteRouteFromNetwork(id, route) {
+        return this.request(`/networks/${id}/actions/delete_route`, {
+            method: 'POST',
+            body: JSON.stringify(route),
+        });
+    }
+    async changeNetworkIpRange(id, ipRange) {
+        return this.request(`/networks/${id}/actions/change_ip_range`, {
+            method: 'POST',
+            body: JSON.stringify({ ip_range: ipRange }),
+        });
+    }
+    async changeNetworkProtection(id, deleteProtection) {
+        return this.request(`/networks/${id}/actions/change_protection`, {
+            method: 'POST',
+            body: JSON.stringify({ delete: deleteProtection }),
+        });
+    }
+    // =========================================================================
+    // Cloud Firewalls
+    // =========================================================================
+    async listFirewalls(params = {}) {
+        return this.listAll('/firewalls', 'firewalls', params);
+    }
+    async getFirewall(id) {
+        const { firewall } = await this.request(`/firewalls/${id}`);
+        return firewall;
+    }
+    async createFirewall(opts) {
+        return this.request('/firewalls', {
+            method: 'POST',
+            body: JSON.stringify(opts),
+        });
+    }
+    async deleteFirewall(id) {
+        await this.request(`/firewalls/${id}`, { method: 'DELETE' });
+    }
+    async updateFirewall(id, opts) {
+        return this.request(`/firewalls/${id}`, {
+            method: 'PUT',
+            body: JSON.stringify(opts),
+        });
+    }
+    async setFirewallRules(id, rules) {
+        return this.request(`/firewalls/${id}/actions/set_rules`, {
+            method: 'POST',
+            body: JSON.stringify({ rules }),
+        });
+    }
+    async applyFirewall(id, applyTo) {
+        return this.request(`/firewalls/${id}/actions/apply_to_resources`, {
+            method: 'POST',
+            body: JSON.stringify({ apply_to: applyTo }),
+        });
+    }
+    async removeFirewallFromResources(id, removeFrom) {
+        return this.request(`/firewalls/${id}/actions/remove_from_resources`, {
+            method: 'POST',
+            body: JSON.stringify({ remove_from: removeFrom }),
+        });
+    }
+    // =========================================================================
+    // Floating IPs
+    // =========================================================================
+    async listFloatingIps(params = {}) {
+        return 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 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 this.request(`/floating_ips/${id}`, {
+            method: 'PUT',
+            body: JSON.stringify(opts),
+        });
+    }
+    async assignFloatingIp(id, serverId) {
+        return this.request(`/floating_ips/${id}/actions/assign`, {
+            method: 'POST',
+            body: JSON.stringify({ server: serverId }),
+        });
+    }
+    async unassignFloatingIp(id) {
+        return this.request(`/floating_ips/${id}/actions/unassign`, { method: 'POST' });
+    }
+    async changeFloatingIpProtection(id, deleteProtection) {
+        return this.request(`/floating_ips/${id}/actions/change_protection`, {
+            method: 'POST',
+            body: JSON.stringify({ delete: deleteProtection }),
+        });
+    }
+    async changeFloatingIpDnsPtr(id, ip, dnsPtr) {
+        return this.request(`/floating_ips/${id}/actions/change_dns_ptr`, {
+            method: 'POST',
+            body: JSON.stringify({ ip, dns_ptr: dnsPtr }),
+        });
+    }
+    // =========================================================================
+    // Primary IPs
+    // =========================================================================
+    async listPrimaryIps(params = {}) {
+        return 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 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 this.request(`/primary_ips/${id}`, {
+            method: 'PUT',
+            body: JSON.stringify(opts),
+        });
+    }
+    async assignPrimaryIp(id, assigneeId, assigneeType = 'server') {
+        return this.request(`/primary_ips/${id}/actions/assign`, {
+            method: 'POST',
+            body: JSON.stringify({ assignee_id: assigneeId, assignee_type: assigneeType }),
+        });
+    }
+    async unassignPrimaryIp(id) {
+        return this.request(`/primary_ips/${id}/actions/unassign`, { method: 'POST' });
+    }
+    async changePrimaryIpProtection(id, deleteProtection) {
+        return this.request(`/primary_ips/${id}/actions/change_protection`, {
+            method: 'POST',
+            body: JSON.stringify({ delete: deleteProtection }),
+        });
+    }
+    async changePrimaryIpDnsPtr(id, ip, dnsPtr) {
+        return this.request(`/primary_ips/${id}/actions/change_dns_ptr`, {
+            method: 'POST',
+            body: JSON.stringify({ ip, dns_ptr: dnsPtr }),
+        });
+    }
+    // =========================================================================
+    // Volumes
+    // =========================================================================
+    async listVolumes(params = {}) {
+        return this.listAll('/volumes', 'volumes', params);
+    }
+    async getVolume(id) {
+        const { volume } = await this.request(`/volumes/${id}`);
+        return volume;
+    }
+    async createVolume(opts) {
+        return this.request('/volumes', {
+            method: 'POST',
+            body: JSON.stringify(opts),
+        });
+    }
+    async deleteVolume(id) {
+        await this.request(`/volumes/${id}`, { method: 'DELETE' });
+    }
+    async updateVolume(id, opts) {
+        return this.request(`/volumes/${id}`, {
+            method: 'PUT',
+            body: JSON.stringify(opts),
+        });
+    }
+    async attachVolume(id, serverId, automount) {
+        return this.request(`/volumes/${id}/actions/attach`, {
+            method: 'POST',
+            body: JSON.stringify({ server: serverId, automount }),
+        });
+    }
+    async detachVolume(id) {
+        return this.request(`/volumes/${id}/actions/detach`, { method: 'POST' });
+    }
+    async resizeVolume(id, size) {
+        return this.request(`/volumes/${id}/actions/resize`, {
+            method: 'POST',
+            body: JSON.stringify({ size }),
+        });
+    }
+    async changeVolumeProtection(id, deleteProtection) {
+        return this.request(`/volumes/${id}/actions/change_protection`, {
+            method: 'POST',
+            body: JSON.stringify({ delete: deleteProtection }),
+        });
+    }
+    // =========================================================================
+    // Load Balancers
+    // =========================================================================
+    async listLoadBalancers(params = {}) {
+        return 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 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 this.request(`/load_balancers/${id}`, {
+            method: 'PUT',
+            body: JSON.stringify(opts),
+        });
+    }
+    async addTargetToLoadBalancer(id, target) {
+        return this.request(`/load_balancers/${id}/actions/add_target`, {
+            method: 'POST',
+            body: JSON.stringify(target),
+        });
+    }
+    async removeTargetFromLoadBalancer(id, target) {
+        return this.request(`/load_balancers/${id}/actions/remove_target`, {
+            method: 'POST',
+            body: JSON.stringify(target),
+        });
+    }
+    async addServiceToLoadBalancer(id, service) {
+        return this.request(`/load_balancers/${id}/actions/add_service`, {
+            method: 'POST',
+            body: JSON.stringify(service),
+        });
+    }
+    async updateServiceOnLoadBalancer(id, service) {
+        return this.request(`/load_balancers/${id}/actions/update_service`, {
+            method: 'POST',
+            body: JSON.stringify(service),
+        });
+    }
+    async deleteServiceFromLoadBalancer(id, listenPort) {
+        return this.request(`/load_balancers/${id}/actions/delete_service`, {
+            method: 'POST',
+            body: JSON.stringify({ listen_port: listenPort }),
+        });
+    }
+    async changeLoadBalancerAlgorithm(id, type) {
+        return this.request(`/load_balancers/${id}/actions/change_algorithm`, {
+            method: 'POST',
+            body: JSON.stringify({ type }),
+        });
+    }
+    async changeLoadBalancerType(id, loadBalancerType) {
+        return this.request(`/load_balancers/${id}/actions/change_type`, {
+            method: 'POST',
+            body: JSON.stringify({ load_balancer_type: loadBalancerType }),
+        });
+    }
+    async attachLoadBalancerToNetwork(id, network, ip) {
+        return this.request(`/load_balancers/${id}/actions/attach_to_network`, {
+            method: 'POST',
+            body: JSON.stringify({ network, ip }),
+        });
+    }
+    async detachLoadBalancerFromNetwork(id, network) {
+        return this.request(`/load_balancers/${id}/actions/detach_from_network`, {
+            method: 'POST',
+            body: JSON.stringify({ network }),
+        });
+    }
+    async enableLoadBalancerPublicInterface(id) {
+        return this.request(`/load_balancers/${id}/actions/enable_public_interface`, { method: 'POST' });
+    }
+    async disableLoadBalancerPublicInterface(id) {
+        return this.request(`/load_balancers/${id}/actions/disable_public_interface`, { method: 'POST' });
+    }
+    async changeLoadBalancerProtection(id, deleteProtection) {
+        return this.request(`/load_balancers/${id}/actions/change_protection`, {
+            method: 'POST',
+            body: JSON.stringify({ delete: deleteProtection }),
+        });
+    }
+    // =========================================================================
+    // Images
+    // =========================================================================
+    async listImages(params = {}) {
+        return this.listAll('/images', 'images', params);
+    }
+    async getImage(id) {
+        const { image } = await this.request(`/images/${id}`);
+        return image;
+    }
+    async updateImage(id, opts) {
+        return 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 this.request(`/images/${id}/actions/change_protection`, {
+            method: 'POST',
+            body: JSON.stringify({ delete: deleteProtection }),
+        });
+    }
+    // =========================================================================
+    // SSH Keys (Cloud)
+    // =========================================================================
+    async listSshKeys(params = {}) {
+        return 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 this.request('/ssh_keys', {
+            method: 'POST',
+            body: JSON.stringify(opts),
+        });
+    }
+    async updateSshKey(id, opts) {
+        return 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 this.listAll('/certificates', 'certificates', params);
+    }
+    async getCertificate(id) {
+        const { certificate } = await this.request(`/certificates/${id}`);
+        return certificate;
+    }
+    async createCertificate(opts) {
+        return this.request('/certificates', {
+            method: 'POST',
+            body: JSON.stringify(opts),
+        });
+    }
+    async updateCertificate(id, opts) {
+        return 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 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 this.request('/placement_groups', {
+            method: 'POST',
+            body: JSON.stringify(opts),
+        });
+    }
+    async updatePlacementGroup(id, opts) {
+        return 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 this.listAll('/actions', 'actions', params);
+    }
+}