@ebowwa/hetzner 0.2.2 → 0.3.1

package/errors.js

@@ -1,345 +0,0 @@
-"use strict";
-/**
- * Hetzner Cloud API error types and utilities
- */
-var __extends = (this && this.__extends) || (function () {
-    var extendStatics = function (d, b) {
-        extendStatics = Object.setPrototypeOf ||
-            ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||
-            function (d, b) { for (var p in b) if (Object.prototype.hasOwnProperty.call(b, p)) d[p] = b[p]; };
-        return extendStatics(d, b);
-    };
-    return function (d, b) {
-        if (typeof b !== "function" && b !== null)
-            throw new TypeError("Class extends value " + String(b) + " is not a constructor or null");
-        extendStatics(d, b);
-        function __() { this.constructor = d; }
-        d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
-    };
-})();
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.HetznerTimeoutError = exports.HetznerActionError = exports.HetznerServiceError = exports.HetznerConflictError = exports.HetznerInvalidInputError = exports.HetznerResourceLimitError = exports.HetznerResourceLockedError = exports.HetznerRateLimitError = exports.HetznerNotFoundError = exports.HetznerForbiddenError = exports.HetznerUnauthorizedError = exports.HetznerAPIError = exports.HetznerErrorCode = void 0;
-exports.createHetznerError = createHetznerError;
-exports.isRetryableError = isRetryableError;
-exports.isRateLimitError = isRateLimitError;
-exports.isResourceLockedError = isResourceLockedError;
-exports.calculateRetryDelay = calculateRetryDelay;
-exports.defaultErrorHandler = defaultErrorHandler;
-// ============================================================================
-// Error Codes
-// ============================================================================
-/**
- * Hetzner API error codes
- * @see https://docs.hetzner.cloud/#errors
- */
-var HetznerErrorCode;
-(function (HetznerErrorCode) {
-    // Authentication errors
-    HetznerErrorCode["Unauthorized"] = "unauthorized";
-    HetznerErrorCode["InvalidInput"] = "invalid_input";
-    HetznerErrorCode["JSONError"] = "json_error";
-    HetznerErrorCode["Forbidden"] = "forbidden";
-    // Resource errors
-    HetznerErrorCode["NotFound"] = "not_found";
-    HetznerErrorCode["ResourceLocked"] = "locked";
-    HetznerErrorCode["ResourceLimitExceeded"] = "resource_limit_exceeded";
-    HetznerErrorCode["UniquenessError"] = "uniqueness_error";
-    // Rate limiting
-    HetznerErrorCode["RateLimitExceeded"] = "rate_limit_exceeded";
-    // Conflict errors
-    HetznerErrorCode["Conflict"] = "conflict";
-    HetznerErrorCode["ServiceError"] = "service_error";
-    // Server-specific errors
-    HetznerErrorCode["ServerNotStopped"] = "server_not_stopped";
-    HetznerErrorCode["ServerAlreadyStopped"] = "server_already_stopped";
-    HetznerErrorCode["InvalidServerType"] = "invalid_server_type";
-    // IP/network errors
-    HetznerErrorCode["IpNotOwned"] = "ip_not_owned";
-    HetznerErrorCode["IpAlreadyAssigned"] = "ip_already_assigned";
-    // Volume errors
-    HetznerErrorCode["VolumeAlreadyAttached"] = "volume_already_attached";
-    HetznerErrorCode["VolumeSizeNotMultiple"] = "volume_size_not_multiple";
-    // Firewall errors
-    HetznerErrorCode["FirewallInUse"] = "firewall_in_use";
-    // Certificate errors
-    HetznerErrorCode["CertificateValidationFailed"] = "certificate_validation_failed";
-    HetznerErrorCode["CertificatePending"] = "certificate_pending";
-})(HetznerErrorCode || (exports.HetznerErrorCode = HetznerErrorCode = {}));
-// ============================================================================
-// Error Classes
-// ============================================================================
-/**
- * Base Hetzner API error
- */
-var HetznerAPIError = /** @class */ (function (_super) {
-    __extends(HetznerAPIError, _super);
-    function HetznerAPIError(message, code, details) {
-        var _this = _super.call(this, message) || this;
-        _this.code = code;
-        _this.details = details;
-        _this.name = "HetznerAPIError";
-        return _this;
-    }
-    return HetznerAPIError;
-}(Error));
-exports.HetznerAPIError = HetznerAPIError;
-/**
- * Authentication error (401)
- */
-var HetznerUnauthorizedError = /** @class */ (function (_super) {
-    __extends(HetznerUnauthorizedError, _super);
-    function HetznerUnauthorizedError(message) {
-        if (message === void 0) { message = "Unauthorized: Invalid API token"; }
-        var _this = _super.call(this, message, HetznerErrorCode.Unauthorized) || this;
-        _this.name = "HetznerUnauthorizedError";
-        return _this;
-    }
-    return HetznerUnauthorizedError;
-}(HetznerAPIError));
-exports.HetznerUnauthorizedError = HetznerUnauthorizedError;
-/**
- * Forbidden error (403)
- */
-var HetznerForbiddenError = /** @class */ (function (_super) {
-    __extends(HetznerForbiddenError, _super);
-    function HetznerForbiddenError(message) {
-        if (message === void 0) { message = "Forbidden: Insufficient permissions"; }
-        var _this = _super.call(this, message, HetznerErrorCode.Forbidden) || this;
-        _this.name = "HetznerForbiddenError";
-        return _this;
-    }
-    return HetznerForbiddenError;
-}(HetznerAPIError));
-exports.HetznerForbiddenError = HetznerForbiddenError;
-/**
- * Resource not found error (404)
- */
-var HetznerNotFoundError = /** @class */ (function (_super) {
-    __extends(HetznerNotFoundError, _super);
-    function HetznerNotFoundError(resource, id) {
-        var _this = _super.call(this, "".concat(resource, " with ID ").concat(id, " not found"), HetznerErrorCode.NotFound, { resource: resource, id: id }) || this;
-        _this.name = "HetznerNotFoundError";
-        return _this;
-    }
-    return HetznerNotFoundError;
-}(HetznerAPIError));
-exports.HetznerNotFoundError = HetznerNotFoundError;
-/**
- * Rate limit exceeded error (429)
- */
-var HetznerRateLimitError = /** @class */ (function (_super) {
-    __extends(HetznerRateLimitError, _super);
-    function HetznerRateLimitError(message, rateLimitInfo) {
-        if (message === void 0) { message = "Rate limit exceeded"; }
-        var _this = _super.call(this, message, HetznerErrorCode.RateLimitExceeded, rateLimitInfo) || this;
-        _this.rateLimitInfo = rateLimitInfo;
-        _this.name = "HetznerRateLimitError";
-        return _this;
-    }
-    Object.defineProperty(HetznerRateLimitError.prototype, "resetInMs", {
-        /**
-         * Get the number of milliseconds until the rate limit resets
-         */
-        get: function () {
-            if (!this.rateLimitInfo)
-                return 60000; // Default to 1 minute
-            return Math.max(0, this.rateLimitInfo.reset * 1000 - Date.now());
-        },
-        enumerable: false,
-        configurable: true
-    });
-    Object.defineProperty(HetznerRateLimitError.prototype, "resetTime", {
-        /**
-         * Get a human-readable reset time
-         */
-        get: function () {
-            if (!this.rateLimitInfo)
-                return "unknown";
-            return new Date(this.rateLimitInfo.reset * 1000).toISOString();
-        },
-        enumerable: false,
-        configurable: true
-    });
-    return HetznerRateLimitError;
-}(HetznerAPIError));
-exports.HetznerRateLimitError = HetznerRateLimitError;
-/**
- * Resource locked error
- */
-var HetznerResourceLockedError = /** @class */ (function (_super) {
-    __extends(HetznerResourceLockedError, _super);
-    function HetznerResourceLockedError(resource, id, actionInProgress) {
-        var _this = _super.call(this, "".concat(resource, " ").concat(id, " is locked").concat(actionInProgress ? " by ".concat(actionInProgress) : ""), HetznerErrorCode.ResourceLocked, { resource: resource, id: id, actionInProgress: actionInProgress }) || this;
-        _this.actionInProgress = actionInProgress;
-        _this.name = "HetznerResourceLockedError";
-        return _this;
-    }
-    return HetznerResourceLockedError;
-}(HetznerAPIError));
-exports.HetznerResourceLockedError = HetznerResourceLockedError;
-/**
- * Resource limit exceeded error
- */
-var HetznerResourceLimitError = /** @class */ (function (_super) {
-    __extends(HetznerResourceLimitError, _super);
-    function HetznerResourceLimitError(resource, limit) {
-        var _this = _super.call(this, "Resource limit exceeded: ".concat(resource, " (limit: ").concat(limit, ")"), HetznerErrorCode.ResourceLimitExceeded, { resource: resource, limit: limit }) || this;
-        _this.name = "HetznerResourceLimitError";
-        return _this;
-    }
-    return HetznerResourceLimitError;
-}(HetznerAPIError));
-exports.HetznerResourceLimitError = HetznerResourceLimitError;
-/**
- * Invalid input error
- */
-var HetznerInvalidInputError = /** @class */ (function (_super) {
-    __extends(HetznerInvalidInputError, _super);
-    function HetznerInvalidInputError(message, fields) {
-        var _this = _super.call(this, message, HetznerErrorCode.InvalidInput, { fields: fields }) || this;
-        _this.fields = fields;
-        _this.name = "HetznerInvalidInputError";
-        return _this;
-    }
-    return HetznerInvalidInputError;
-}(HetznerAPIError));
-exports.HetznerInvalidInputError = HetznerInvalidInputError;
-/**
- * Conflict error
- */
-var HetznerConflictError = /** @class */ (function (_super) {
-    __extends(HetznerConflictError, _super);
-    function HetznerConflictError(message, details) {
-        var _this = _super.call(this, message, HetznerErrorCode.Conflict, details) || this;
-        _this.name = "HetznerConflictError";
-        return _this;
-    }
-    return HetznerConflictError;
-}(HetznerAPIError));
-exports.HetznerConflictError = HetznerConflictError;
-/**
- * Service error (5xx)
- */
-var HetznerServiceError = /** @class */ (function (_super) {
-    __extends(HetznerServiceError, _super);
-    function HetznerServiceError(message, statusCode) {
-        var _this = _super.call(this, message, HetznerErrorCode.ServiceError, { statusCode: statusCode }) || this;
-        _this.statusCode = statusCode;
-        _this.name = "HetznerServiceError";
-        return _this;
-    }
-    return HetznerServiceError;
-}(HetznerAPIError));
-exports.HetznerServiceError = HetznerServiceError;
-/**
- * Action failed error
- */
-var HetznerActionError = /** @class */ (function (_super) {
-    __extends(HetznerActionError, _super);
-    function HetznerActionError(actionError, actionId) {
-        var _this = _super.call(this, "Action ".concat(actionId, " failed: ").concat(actionError.code, " - ").concat(actionError.message), actionError.code, { actionError: actionError, actionId: actionId }) || this;
-        _this.actionError = actionError;
-        _this.actionId = actionId;
-        _this.name = "HetznerActionError";
-        return _this;
-    }
-    return HetznerActionError;
-}(HetznerAPIError));
-exports.HetznerActionError = HetznerActionError;
-/**
- * Timeout error for action polling
- */
-var HetznerTimeoutError = /** @class */ (function (_super) {
-    __extends(HetznerTimeoutError, _super);
-    function HetznerTimeoutError(actionId, timeout, lastProgress) {
-        var _this = _super.call(this, "Action ".concat(actionId, " timed out after ").concat(timeout, "ms (last progress: ").concat(lastProgress, "%)"), "timeout", { actionId: actionId, timeout: timeout, lastProgress: lastProgress }) || this;
-        _this.lastProgress = lastProgress;
-        _this.name = "HetznerTimeoutError";
-        return _this;
-    }
-    return HetznerTimeoutError;
-}(HetznerAPIError));
-exports.HetznerTimeoutError = HetznerTimeoutError;
-// ============================================================================
-// Error Factory
-// ============================================================================
-/**
- * Parse Hetzner API error response and create appropriate error
- */
-function createHetznerError(statusCode, body) {
-    var error = body.error;
-    if (!error) {
-        return new HetznerServiceError("HTTP ".concat(statusCode, ": ").concat(JSON.stringify(body)), statusCode);
-    }
-    switch (statusCode) {
-        case 401:
-            return new HetznerUnauthorizedError(error.message);
-        case 403:
-            return new HetznerForbiddenError(error.message);
-        case 404:
-            return new HetznerNotFoundError("resource", "unknown");
-        case 429:
-            return new HetznerRateLimitError(error.message);
-        case 400:
-            if (error.code === HetznerErrorCode.ResourceLocked) {
-                return new HetznerResourceLockedError("resource", "unknown", error.message);
-            }
-            if (error.code === HetznerErrorCode.InvalidInput) {
-                return new HetznerInvalidInputError(error.message);
-            }
-            return new HetznerInvalidInputError(error.message);
-        case 409:
-            return new HetznerConflictError(error.message, error.details);
-        default:
-            if (statusCode >= 500) {
-                return new HetznerServiceError(error.message, statusCode);
-            }
-            return new HetznerAPIError(error.message, error.code, error.details);
-    }
-}
-/**
- * Check if an error is retryable
- */
-function isRetryableError(error) {
-    if (error instanceof HetznerRateLimitError)
-        return true;
-    if (error instanceof HetznerResourceLockedError)
-        return true;
-    if (error instanceof HetznerServiceError)
-        return true;
-    if (error instanceof HetznerConflictError)
-        return true;
-    return false;
-}
-/**
- * Check if an error is a rate limit error
- */
-function isRateLimitError(error) {
-    return error instanceof HetznerRateLimitError;
-}
-/**
- * Check if an error is a resource locked error
- */
-function isResourceLockedError(error) {
-    return error instanceof HetznerResourceLockedError;
-}
-/**
- * Calculate retry delay with exponential backoff
- */
-function calculateRetryDelay(attempt, baseDelay, maxDelay) {
-    if (baseDelay === void 0) { baseDelay = 1000; }
-    if (maxDelay === void 0) { maxDelay = 60000; }
-    var delay = baseDelay * Math.pow(2, attempt);
-    // Add jitter (±25%)
-    var jitter = delay * 0.25 * (Math.random() * 2 - 1);
-    return Math.min(maxDelay, delay + jitter);
-}
-/**
- * Default error handler that logs to console
- */
-function defaultErrorHandler(error) {
-    console.error("[Hetzner API Error] ".concat(error.name, ": ").concat(error.message));
-    if (error.details) {
-        console.error("Details:", error.details);
-    }
-}