@ebowwa/hetzner 0.2.2 → 0.3.1

package/client.js

@@ -1,234 +0,0 @@
-"use strict";
-/**
- * Hetzner Cloud API client
- * For server-side use only (requires API token)
- *
- * TODO: RE-REVIEW https://docs.hetzner.cloud/reference/cloud#authentication
- * - https://tailscale.com/kb/1150/cloud-hetzner
- */
-var __assign = (this && this.__assign) || function () {
-    __assign = Object.assign || function(t) {
-        for (var s, i = 1, n = arguments.length; i < n; i++) {
-            s = arguments[i];
-            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
-                t[p] = s[p];
-        }
-        return t;
-    };
-    return __assign.apply(this, arguments);
-};
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
-var __generator = (this && this.__generator) || function (thisArg, body) {
-    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
-    return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
-    function verb(n) { return function (v) { return step([n, v]); }; }
-    function step(op) {
-        if (f) throw new TypeError("Generator is already executing.");
-        while (g && (g = 0, op[0] && (_ = 0)), _) try {
-            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
-            if (y = 0, t) op = [op[0] & 2, t.value];
-            switch (op[0]) {
-                case 0: case 1: t = op; break;
-                case 4: _.label++; return { value: op[1], done: false };
-                case 5: _.label++; y = op[1]; op = [0]; continue;
-                case 7: op = _.ops.pop(); _.trys.pop(); continue;
-                default:
-                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
-                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
-                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
-                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
-                    if (t[2]) _.ops.pop();
-                    _.trys.pop(); continue;
-            }
-            op = body.call(thisArg, _);
-        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
-        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
-    }
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.HetznerClient = void 0;
-// Explicitly import fetch for Bun compatibility
-var bun_1 = require("bun");
-var config_js_1 = require("./config.js");
-// Use Bun's fetch if available, otherwise try global fetch
-var fetch = bun_1.fetch || globalThis.fetch;
-var auth_js_1 = require("./auth.js");
-var servers_js_1 = require("./servers.js");
-var actions_js_1 = require("./actions.js");
-var pricing_js_1 = require("./pricing.js");
-var ssh_keys_js_1 = require("./ssh-keys.js");
-var volumes_js_1 = require("./volumes.js");
-var errors_js_1 = require("./errors.js");
-var actions_js_2 = require("./actions.js");
-var HetznerClient = /** @class */ (function () {
-    function HetznerClient(apiToken) {
-        this.servers = new servers_js_1.ServerOperations(this);
-        this.actions = new actions_js_1.ActionOperations(this);
-        this.pricing = new pricing_js_1.PricingOperations(this);
-        this.ssh_keys = new ssh_keys_js_1.SSHKeyOperations(this);
-        this.volumes = new volumes_js_1.VolumeOperations(this);
-        this.apiToken = (0, auth_js_1.resolveApiToken)(apiToken);
-        // If no token from env or explicit, try CLI config
-        if (!this.apiToken) {
-            this.apiToken = (0, auth_js_1.getTokenFromCLI)();
-        }
-    }
-    Object.defineProperty(HetznerClient.prototype, "isAuthenticated", {
-        get: function () {
-            return (0, auth_js_1.isAuthenticated)(this.apiToken);
-        },
-        enumerable: false,
-        configurable: true
-    });
-    /**
-     * Make a request to the Hetzner Cloud API
-     *
-     * @param endpoint - API endpoint (e.g., "/servers")
-     * @param options - RequestInit options
-     * @returns Parsed JSON response
-     * @throws {HetznerAPIError} On API errors
-     */
-    HetznerClient.prototype.request = function (endpoint_1) {
-        return __awaiter(this, arguments, void 0, function (endpoint, options) {
-            var response, rateLimit, body, data;
-            if (options === void 0) { options = {}; }
-            return __generator(this, function (_a) {
-                switch (_a.label) {
-                    case 0: return [4 /*yield*/, fetch("".concat(config_js_1.HETZNER_API_BASE).concat(endpoint), __assign(__assign({}, options), { headers: __assign({ Authorization: "Bearer ".concat(this.apiToken), "Content-Type": "application/json" }, options.headers) }))];
-                    case 1:
-                        response = _a.sent();
-                        rateLimit = (0, actions_js_2.parseRateLimitHeaders)(response.headers);
-                        this.handleRateLimit(rateLimit);
-                        if (!!response.ok) return [3 /*break*/, 3];
-                        return [4 /*yield*/, response.json().catch(function () { return ({}); })];
-                    case 2:
-                        body = _a.sent();
-                        throw (0, errors_js_1.createHetznerError)(response.status, body);
-                    case 3: return [4 /*yield*/, response.json()];
-                    case 4:
-                        data = _a.sent();
-                        return [2 /*return*/, data];
-                }
-            });
-        });
-    };
-    /**
-     * Validate Hetzner API response with Zod schema
-     *
-     * @param schema - Zod schema to validate against
-     * @param data - Data to validate
-     * @returns Validated data
-     */
-    HetznerClient.prototype.validateResponse = function (schema, data) {
-        var result = schema.safeParse(data);
-        if (result.success) {
-            return result.data;
-        }
-        // Log validation errors but don't throw to maintain backward compatibility
-        console.warn("Hetzner API response validation warning:", result.error.issues);
-        return data;
-    };
-    /**
-     * Handle rate limit information from response headers
-     *
-     * @param rateLimit - Rate limit info from response
-     */
-    HetznerClient.prototype.handleRateLimit = function (rateLimit) {
-        if (!rateLimit)
-            return;
-        // Warn if rate limit is low
-        if (rateLimit.remaining < 100) {
-            console.warn("[Hetzner API] Rate limit low: ".concat(rateLimit.remaining, "/").concat(rateLimit.limit, " remaining. Resets at ").concat(new Date(rateLimit.reset * 1000).toISOString()));
-        }
-    };
-    /**
-     * Get current rate limit information
-     *
-     * Makes a lightweight request to check rate limit status
-     *
-     * @returns Rate limit info or null if not available
-     */
-    HetznerClient.prototype.getRateLimit = function () {
-        return __awaiter(this, void 0, void 0, function () {
-            var response, _a;
-            return __generator(this, function (_b) {
-                switch (_b.label) {
-                    case 0:
-                        _b.trys.push([0, 2, , 3]);
-                        return [4 /*yield*/, fetch("".concat(config_js_1.HETZNER_API_BASE, "/servers"), {
-                                headers: {
-                                    Authorization: "Bearer ".concat(this.apiToken),
-                                },
-                            })];
-                    case 1:
-                        response = _b.sent();
-                        return [2 /*return*/, (0, actions_js_2.parseRateLimitHeaders)(response.headers)];
-                    case 2:
-                        _a = _b.sent();
-                        return [2 /*return*/, null];
-                    case 3: return [2 /*return*/];
-                }
-            });
-        });
-    };
-    // Backward-compatible convenience methods (delegates to servers operations)
-    HetznerClient.prototype.listServers = function () {
-        return __awaiter(this, void 0, void 0, function () {
-            return __generator(this, function (_a) {
-                return [2 /*return*/, this.servers.list()];
-            });
-        });
-    };
-    HetznerClient.prototype.getServer = function (id) {
-        return __awaiter(this, void 0, void 0, function () {
-            return __generator(this, function (_a) {
-                return [2 /*return*/, this.servers.get(id)];
-            });
-        });
-    };
-    HetznerClient.prototype.createServer = function (options) {
-        return __awaiter(this, void 0, void 0, function () {
-            return __generator(this, function (_a) {
-                return [2 /*return*/, this.servers.create(options)];
-            });
-        });
-    };
-    HetznerClient.prototype.deleteServer = function (id) {
-        return __awaiter(this, void 0, void 0, function () {
-            return __generator(this, function (_a) {
-                return [2 /*return*/, this.servers.delete(id)];
-            });
-        });
-    };
-    HetznerClient.prototype.powerOn = function (id) {
-        return __awaiter(this, void 0, void 0, function () {
-            return __generator(this, function (_a) {
-                return [2 /*return*/, this.servers.powerOn(id)];
-            });
-        });
-    };
-    HetznerClient.prototype.powerOff = function (id) {
-        return __awaiter(this, void 0, void 0, function () {
-            return __generator(this, function (_a) {
-                return [2 /*return*/, this.servers.powerOff(id)];
-            });
-        });
-    };
-    HetznerClient.prototype.reboot = function (id) {
-        return __awaiter(this, void 0, void 0, function () {
-            return __generator(this, function (_a) {
-                return [2 /*return*/, this.servers.reboot(id)];
-            });
-        });
-    };
-    return HetznerClient;
-}());
-exports.HetznerClient = HetznerClient;

package/client.ts

@@ -1,177 +0,0 @@
-/**
- * Hetzner Cloud API client
- * For server-side use only (requires API token)
- *
- * TODO: RE-REVIEW https://docs.hetzner.cloud/reference/cloud#authentication
- * - https://tailscale.com/kb/1150/cloud-hetzner
- */
-
-// Explicitly import fetch for Bun compatibility
-import { fetch as bunFetch } from "bun";
-import { z } from "zod";
-import { HETZNER_API_BASE } from "./config.js";
-
-// Use Bun's fetch if available, otherwise try global fetch
-const fetch = bunFetch || (globalThis as any).fetch;
-import { resolveApiToken, getTokenFromCLI, isAuthenticated } from "./auth.js";
-import { ServerOperations } from "./servers.js";
-import { ActionOperations } from "./actions.js";
-import { PricingOperations } from "./pricing.js";
-import { SSHKeyOperations } from "./ssh-keys.js";
-import { VolumeOperations } from "./volumes.js";
-import {
-  HetznerListServersResponseSchema,
-  HetznerGetServerResponseSchema,
-  HetznerCreateServerResponseSchema,
-} from "./schemas.js";
-import {
-  createHetznerError,
-  isRateLimitError,
-} from "./errors.js";
-import {
-  parseRateLimitHeaders,
-  waitForRateLimitReset,
-} from "./actions.js";
-import type { RateLimitInfo } from "./types.js";
-
-export class HetznerClient {
-  private apiToken: string;
-
-  constructor(apiToken?: string) {
-    this.apiToken = resolveApiToken(apiToken);
-
-    // If no token from env or explicit, try CLI config
-    if (!this.apiToken) {
-      this.apiToken = getTokenFromCLI();
-    }
-  }
-
-  get isAuthenticated(): boolean {
-    return isAuthenticated(this.apiToken);
-  }
-
-  /**
-   * Make a request to the Hetzner Cloud API
-   *
-   * @param endpoint - API endpoint (e.g., "/servers")
-   * @param options - RequestInit options
-   * @returns Parsed JSON response
-   * @throws {HetznerAPIError} On API errors
-   */
-  async request<T>(endpoint: string, options: RequestInit = {}): Promise<T> {
-    const response = await fetch(`${HETZNER_API_BASE}${endpoint}`, {
-      ...options,
-      headers: {
-        Authorization: `Bearer ${this.apiToken}`,
-        "Content-Type": "application/json",
-        ...options.headers,
-      },
-    });
-
-    // Parse rate limit headers
-    const rateLimit = parseRateLimitHeaders(response.headers);
-    this.handleRateLimit(rateLimit);
-
-    if (!response.ok) {
-      const body = await response.json().catch(() => ({}));
-      throw createHetznerError(response.status, body);
-    }
-
-    const data = await response.json();
-    return data as T;
-  }
-
-  /**
-   * Validate Hetzner API response with Zod schema
-   *
-   * @param schema - Zod schema to validate against
-   * @param data - Data to validate
-   * @returns Validated data
-   */
-  private validateResponse<T>(schema: z.ZodType<T>, data: unknown): T {
-    const result = schema.safeParse(data);
-    if (result.success) {
-      return result.data;
-    }
-    // Log validation errors but don't throw to maintain backward compatibility
-    console.warn(
-      "Hetzner API response validation warning:",
-      result.error.issues
-    );
-    return data as T;
-  }
-
-  /**
-   * Handle rate limit information from response headers
-   *
-   * @param rateLimit - Rate limit info from response
-   */
-  private handleRateLimit(rateLimit: RateLimitInfo | null): void {
-    if (!rateLimit) return;
-
-    // Warn if rate limit is low
-    if (rateLimit.remaining < 100) {
-      console.warn(
-        `[Hetzner API] Rate limit low: ${rateLimit.remaining}/${rateLimit.limit} remaining. Resets at ${new Date(rateLimit.reset * 1000).toISOString()}`
-      );
-    }
-  }
-
-  /**
-   * Get current rate limit information
-   *
-   * Makes a lightweight request to check rate limit status
-   *
-   * @returns Rate limit info or null if not available
-   */
-  async getRateLimit(): Promise<RateLimitInfo | null> {
-    try {
-      const response = await fetch(`${HETZNER_API_BASE}/servers`, {
-        headers: {
-          Authorization: `Bearer ${this.apiToken}`,
-        },
-      });
-      return parseRateLimitHeaders(response.headers);
-    } catch {
-      return null;
-    }
-  }
-
-  readonly servers = new ServerOperations(this);
-  readonly actions = new ActionOperations(this);
-  readonly pricing = new PricingOperations(this);
-  readonly ssh_keys = new SSHKeyOperations(this);
-  readonly volumes = new VolumeOperations(this);
-
-  // Backward-compatible convenience methods (delegates to servers operations)
-  async listServers() {
-    return this.servers.list();
-  }
-
-  async getServer(id: number) {
-    return this.servers.get(id);
-  }
-
-  async createServer(options: import("./types.js").CreateServerOptions) {
-    return this.servers.create(options);
-  }
-
-  async deleteServer(id: number) {
-    return this.servers.delete(id);
-  }
-
-  async powerOn(id: number) {
-    return this.servers.powerOn(id);
-  }
-
-  async powerOff(id: number) {
-    return this.servers.powerOff(id);
-  }
-
-  async reboot(id: number) {
-    return this.servers.reboot(id);
-  }
-}
-
-// Re-export types for convenience
-export type * from "./types.js";

package/config.js

@@ -1,7 +0,0 @@
-"use strict";
-/**
- * Hetzner Cloud API configuration
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.HETZNER_API_BASE = void 0;
-exports.HETZNER_API_BASE = "https://api.hetzner.cloud/v1";

package/config.ts

@@ -1,5 +0,0 @@
-/**
- * Hetzner Cloud API configuration
- */
-
-export const HETZNER_API_BASE = "https://api.hetzner.cloud/v1";