@puls-dev/hcloud 0.5.3

package/dist/ssh_key.js

@@ -0,0 +1,87 @@
+import { BaseBuilder } from '@puls-dev/core';
+import { Output } from '@puls-dev/core';
+import { getHCloudApi } from './api.js';
+export class SSHKeyBuilder extends BaseBuilder {
+    out = {
+        id: new Output(),
+        fingerprint: new Output(),
+    };
+    _publicKey;
+    keyId;
+    log(msg) {
+        console.log(`   🔑 [HCloud.SSHKey] ${msg}`);
+    }
+    constructor(name) {
+        super(name);
+        this.discoveryPromise = this.discoverKey(name);
+    }
+    async discoverKey(name) {
+        const api = getHCloudApi();
+        const data = await api.get('/ssh_keys');
+        const match = data.ssh_keys.find(k => k.name === name) ?? null;
+        if (match) {
+            this.keyId = match.id;
+            this.out.id.resolve(match.id);
+            this.out.fingerprint.resolve(match.fingerprint);
+        }
+        return match;
+    }
+    publicKey(key) {
+        this._publicKey = key.trim();
+        return this;
+    }
+    getDiff(existing) {
+        const diffs = [];
+        if (this._publicKey && existing && existing.public_key.trim() !== this._publicKey) {
+            diffs.push({ field: "publicKey", declared: this._publicKey, live: existing.public_key });
+        }
+        return diffs;
+    }
+    async deploy() {
+        const api = getHCloudApi();
+        const existing = await this.discoveryPromise;
+        if (!existing) {
+            if (!this._publicKey) {
+                throw new Error(`Cannot create SSH Key '${this.name}': publicKey must be specified.`);
+            }
+            this.log(`Creating SSH Key...`);
+            const res = await api.post('/ssh_keys', {
+                name: this.name,
+                public_key: this._publicKey,
+            });
+            this.keyId = res.ssh_key.id;
+            this.out.id.resolve(res.ssh_key.id);
+            this.out.fingerprint.resolve(res.ssh_key.fingerprint);
+            this.log(`Created SSH Key with ID ${this.keyId}`);
+        }
+        else {
+            const diffs = this.getDiff(existing);
+            if (diffs.length > 0) {
+                this.log(`SSH Key public key has drifted. Re-creating...`);
+                await api.delete(`/ssh_keys/${this.keyId}`);
+                const res = await api.post('/ssh_keys', {
+                    name: this.name,
+                    public_key: this._publicKey,
+                });
+                this.keyId = res.ssh_key.id;
+                this.out.id.resolve(res.ssh_key.id);
+                this.out.fingerprint.resolve(res.ssh_key.fingerprint);
+            }
+            else {
+                this.log(`SSH Key already exists and is up to date.`);
+            }
+        }
+    }
+    async destroy() {
+        const existing = await this.discoveryPromise;
+        if (existing) {
+            this.log(`Deleting SSH Key...`);
+            const api = getHCloudApi();
+            await api.delete(`/ssh_keys/${this.keyId}`);
+            this.log(`Deleted SSH Key.`);
+        }
+        else {
+            this.log(`SSH Key does not exist. Skipping deletion.`);
+        }
+    }
+}

package/dist/types/hcloud.d.ts

@@ -0,0 +1,31 @@
+export declare const OS_IMAGE: {
+    readonly UBUNTU_24_04: "ubuntu-24.04";
+    readonly UBUNTU_22_04: "ubuntu-22.04";
+    readonly DEBIAN_12: "debian-12";
+    readonly DEBIAN_11: "debian-11";
+    readonly ROCKY_9: "rocky-9";
+    readonly ALMALINUX_9: "almalinux-9";
+};
+export declare const LOCATION: {
+    readonly NBG1: "nbg1";
+    readonly FSN1: "fsn1";
+    readonly HEL1: "hel1";
+    readonly ASH: "ash";
+    readonly HIL: "hil";
+};
+export declare const SERVER_TYPE: {
+    readonly CX22: "cx22";
+    readonly CPX11: "cpx11";
+    readonly CPX21: "cpx21";
+    readonly CPX31: "cpx31";
+    readonly CPX41: "cpx41";
+    readonly CPX51: "cpx51";
+    readonly CAX11: "cax11";
+    readonly CAX21: "cax21";
+    readonly CAX31: "cax31";
+    readonly CAX41: "cax41";
+};
+export declare const NETWORK: {
+    readonly ANY: "0.0.0.0/0";
+    readonly ANY_V6: "::/0";
+};

package/dist/types/hcloud.js

@@ -0,0 +1,31 @@
+export const OS_IMAGE = {
+    UBUNTU_24_04: "ubuntu-24.04",
+    UBUNTU_22_04: "ubuntu-22.04",
+    DEBIAN_12: "debian-12",
+    DEBIAN_11: "debian-11",
+    ROCKY_9: "rocky-9",
+    ALMALINUX_9: "almalinux-9",
+};
+export const LOCATION = {
+    NBG1: "nbg1", // Nuremberg, Germany
+    FSN1: "fsn1", // Falkenstein, Germany
+    HEL1: "hel1", // Helsinki, Finland
+    ASH: "ash", // Ashburn, Virginia, USA
+    HIL: "hil", // Hillsboro, Oregon, USA
+};
+export const SERVER_TYPE = {
+    CX22: "cx22", // 2 vCPU, 4 GB RAM (Intel)
+    CPX11: "cpx11", // 2 vCPU, 2 GB RAM (AMD)
+    CPX21: "cpx21", // 3 vCPU, 4 GB RAM (AMD)
+    CPX31: "cpx31", // 4 vCPU, 8 GB RAM (AMD)
+    CPX41: "cpx41", // 8 vCPU, 16 GB RAM (AMD)
+    CPX51: "cpx51", // 16 vCPU, 32 GB RAM (AMD)
+    CAX11: "cax11", // 2 vCPU, 4 GB RAM (Ampere ARM)
+    CAX21: "cax21", // 4 vCPU, 8 GB RAM (Ampere ARM)
+    CAX31: "cax31", // 8 vCPU, 16 GB RAM (Ampere ARM)
+    CAX41: "cax41", // 16 vCPU, 32 GB RAM (Ampere ARM)
+};
+export const NETWORK = {
+    ANY: "0.0.0.0/0",
+    ANY_V6: "::/0",
+};

package/package.json

@@ -0,0 +1,19 @@
+{
+  "name": "@puls-dev/hcloud",
+  "version": "0.5.3",
+  "description": "Hetzner Cloud (HCloud) Provider for Puls IaC",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "test": "find src -name '*.test.ts' | xargs tsx --test --test-concurrency=1"
+  },
+  "dependencies": {
+    "@puls-dev/core": "*"
+  },
+  "files": [
+    "dist"
+  ]
+}