hetzner-robot-cli 1.0.0

package/dist/types.d.ts

@@ -0,0 +1,352 @@
+export interface Server {
+    server_ip: string;
+    server_ipv6_net: string;
+    server_number: number;
+    server_name: string;
+    product: string;
+    dc: string;
+    traffic: string;
+    status: 'ready' | 'installing' | 'maintenance';
+    cancelled: boolean;
+    paid_until: string;
+    ip: string[];
+    subnet: ServerSubnet[];
+}
+export interface ServerSubnet {
+    ip: string;
+    mask: string;
+}
+export interface ServerDetails extends Server {
+    reset: boolean;
+    rescue: boolean;
+    vnc: boolean;
+    windows: boolean;
+    plesk: boolean;
+    cpanel: boolean;
+    wol: boolean;
+    hot_swap: boolean;
+}
+export interface Cancellation {
+    server_ip: string;
+    server_ipv6_net: string;
+    server_number: number;
+    server_name: string;
+    earliest_cancellation_date: string;
+    cancelled: boolean;
+    cancellation_date: string | null;
+    cancellation_reason: string[] | null;
+}
+export type ResetType = 'sw' | 'hw' | 'man' | 'power' | 'power_long';
+export interface Reset {
+    server_ip: string;
+    server_ipv6_net: string;
+    server_number: number;
+    type: ResetType[];
+    operating_status: string;
+}
+export interface BootConfig {
+    rescue: RescueConfig | null;
+    linux: LinuxConfig | null;
+    vnc: VncConfig | null;
+    windows: WindowsConfig | null;
+    plesk: PleskConfig | null;
+    cpanel: CpanelConfig | null;
+}
+interface BaseBootConfig {
+    server_ip: string;
+    server_ipv6_net: string;
+    server_number: number;
+    active: boolean;
+    password: string | null;
+}
+export interface RescueConfig extends BaseBootConfig {
+    os: string[];
+    arch: number[];
+    authorized_key: string[];
+    host_key: string[];
+}
+export interface LinuxConfig extends BaseBootConfig {
+    dist: string[];
+    arch: number[];
+    lang: string[];
+    authorized_key: string[];
+    host_key: string[];
+}
+export interface VncConfig extends BaseBootConfig {
+    dist: string[];
+    arch: number[];
+    lang: string[];
+}
+export interface WindowsConfig extends BaseBootConfig {
+    dist: string[];
+    lang: string[];
+}
+export interface PleskConfig extends BaseBootConfig {
+    dist: string[];
+    arch: number[];
+    lang: string[];
+    hostname: string | null;
+}
+export interface CpanelConfig extends BaseBootConfig {
+    dist: string[];
+    arch: number[];
+    lang: string[];
+    hostname: string | null;
+}
+export interface IP {
+    ip: string;
+    server_ip: string;
+    server_number: number;
+    locked: boolean;
+    separate_mac: string | null;
+    traffic_warnings: boolean;
+    traffic_hourly: number;
+    traffic_daily: number;
+    traffic_monthly: number;
+}
+export interface Mac {
+    ip: string;
+    mac: string;
+}
+export interface Subnet {
+    ip: string;
+    mask: string;
+    gateway: string;
+    server_ip: string;
+    server_number: number;
+    failover: boolean;
+    locked: boolean;
+    traffic_warnings: boolean;
+    traffic_hourly: number;
+    traffic_daily: number;
+    traffic_monthly: number;
+}
+export interface Failover {
+    ip: string;
+    netmask: string;
+    server_ip: string;
+    server_number: number;
+    active_server_ip: string;
+}
+export interface Rdns {
+    ip: string;
+    ptr: string;
+}
+export interface SshKey {
+    name: string;
+    fingerprint: string;
+    type: string;
+    size: number;
+    data: string;
+}
+export interface Firewall {
+    server_ip: string;
+    server_number: number;
+    status: 'active' | 'disabled' | 'in process';
+    filter_ipv6: boolean;
+    whitelist_hos: boolean;
+    port: 'main' | 'kvm';
+    rules: {
+        input: FirewallRule[];
+        output?: FirewallRule[];
+    };
+}
+export interface FirewallRule {
+    ip_version: string;
+    name: string;
+    dst_ip: string | null;
+    dst_port: string | null;
+    src_ip: string | null;
+    src_port: string | null;
+    protocol: string | null;
+    tcp_flags: string | null;
+    action: 'accept' | 'discard';
+}
+export interface FirewallTemplate {
+    id: number;
+    name: string;
+    filter_ipv6: boolean;
+    whitelist_hos: boolean;
+    is_default: boolean;
+    rules: {
+        input: FirewallRule[];
+        output?: FirewallRule[];
+    };
+}
+export interface VSwitch {
+    id: number;
+    name: string;
+    vlan: number;
+    cancelled: boolean;
+    server: VSwitchServer[];
+    subnet: VSwitchSubnet[];
+    cloud_network: VSwitchCloudNetwork[];
+}
+export interface VSwitchServer {
+    server_ip: string;
+    server_ipv6_net: string;
+    server_number: number;
+    status: 'ready' | 'in process' | 'failed';
+}
+export interface VSwitchSubnet {
+    ip: string;
+    mask: number;
+    gateway: string;
+}
+export interface VSwitchCloudNetwork {
+    id: number;
+    ip: string;
+    mask: number;
+    gateway: string;
+}
+export interface StorageBox {
+    id: number;
+    login: string;
+    name: string;
+    product: string;
+    cancelled: boolean;
+    locked: boolean;
+    location: string;
+    linked_server: number | null;
+    paid_until: string;
+    disk_quota: number;
+    disk_usage: number;
+    disk_usage_data: number;
+    disk_usage_snapshots: number;
+    webdav: boolean;
+    samba: boolean;
+    ssh: boolean;
+    external_reachability: boolean;
+    zfs: boolean;
+    server: string;
+    host_system: string;
+}
+export interface StorageBoxSnapshot {
+    name: string;
+    timestamp: string;
+    size: number;
+    size_formatted: string;
+}
+export interface StorageBoxSnapshotPlan {
+    status: 'enabled' | 'disabled';
+    minute: number;
+    hour: number;
+    day_of_week: number;
+    day_of_month: number;
+    max_snapshots: number;
+}
+export interface StorageBoxSubaccount {
+    username: string;
+    accountid: string;
+    server: string;
+    homedirectory: string;
+    samba: boolean;
+    ssh: boolean;
+    external_reachability: boolean;
+    webdav: boolean;
+    readonly: boolean;
+    createtime: string;
+    comment: string;
+}
+export interface Traffic {
+    ip: string;
+    type: 'day' | 'month' | 'year';
+    from: string;
+    to: string;
+    data: TrafficData[];
+}
+export interface TrafficData {
+    in: number;
+    out: number;
+    sum: number;
+    date?: string;
+}
+export interface Wol {
+    server_ip: string;
+    server_ipv6_net: string;
+    server_number: number;
+}
+export interface ServerProduct {
+    id: string;
+    name: string;
+    description: string[];
+    traffic: string;
+    dist: string[];
+    arch: number[];
+    lang: string[];
+    location: string[];
+    prices: ProductPrice[];
+    orderable_addons: string[];
+}
+export interface ProductPrice {
+    location: string;
+    price: {
+        net: string;
+        gross: string;
+    };
+    price_setup: {
+        net: string;
+        gross: string;
+    };
+    price_vat: {
+        net: string;
+        gross: string;
+    };
+    price_setup_vat: {
+        net: string;
+        gross: string;
+    };
+}
+export interface ServerMarketProduct {
+    id: number;
+    name: string;
+    description: string[];
+    traffic: string;
+    dist: string[];
+    arch: number[];
+    lang: string[];
+    cpu: string;
+    cpu_benchmark: number;
+    memory_size: number;
+    hdd_size: number;
+    hdd_text: string;
+    hdd_count: number;
+    datacenter: string;
+    network_speed: string;
+    price: string;
+    price_setup: string;
+    fixed_price: boolean;
+    next_reduce: number;
+    next_reduce_date: string;
+    orderable_addons: string[];
+}
+export interface ServerTransaction {
+    id: string;
+    date: string;
+    status: 'ready' | 'in process' | 'cancelled';
+    server_number: number | null;
+    server_ip: string | null;
+    authorized_key: string[];
+    host_key: string[];
+    comment: string;
+    product: ServerTransactionProduct;
+}
+export interface ServerTransactionProduct {
+    id: string;
+    name: string;
+    description: string[];
+    traffic: string;
+    dist: string;
+    arch: number;
+    lang: string;
+    location: string;
+}
+export type ApiResponse<T> = Record<string, T>;
+export interface ApiError {
+    error: {
+        status: number;
+        code: string;
+        message: string;
+    };
+}
+export {};

package/dist/types.js

@@ -0,0 +1,5 @@
+// ============================================================================
+// Hetzner Robot API Types
+// Based on: https://robot.hetzner.com/doc/webservice/en.html
+// ============================================================================
+export {};

package/package.json

@@ -0,0 +1,89 @@
+{
+  "name": "hetzner-robot-cli",
+  "version": "1.0.0",
+  "description": "Feature-complete CLI and Node.js library for the Hetzner Robot API (dedicated servers)",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./client": {
+      "types": "./dist/client.d.ts",
+      "import": "./dist/client.js"
+    },
+    "./types": {
+      "types": "./dist/types.d.ts",
+      "import": "./dist/types.js"
+    }
+  },
+  "bin": {
+    "hetzner": "./dist/cli.js"
+  },
+  "files": [
+    "dist/**/*.js",
+    "dist/**/*.d.ts",
+    "!dist/**/*.test.js",
+    "!dist/**/*.test.d.ts",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/cli.js",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src/",
+    "lint:fix": "eslint src/ --fix",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "audit": "npm audit",
+    "check": "npm run typecheck && npm run lint && npm run test",
+    "prepublishOnly": "npm run check && npm run build"
+  },
+  "keywords": [
+    "hetzner",
+    "robot",
+    "api",
+    "cli",
+    "dedicated-server",
+    "server-management",
+    "hetzner-robot",
+    "datacenter",
+    "hosting",
+    "cloud",
+    "infrastructure"
+  ],
+  "author": "",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ytspar/hetzner-robot-cli.git"
+  },
+  "bugs": {
+    "url": "https://github.com/ytspar/hetzner-robot-cli/issues"
+  },
+  "homepage": "https://github.com/ytspar/hetzner-robot-cli#readme",
+  "dependencies": {
+    "@inquirer/prompts": "^7.0.0",
+    "cli-table3": "^0.6.5",
+    "commander": "^14.0.2",
+    "dotenv": "^16.4.7"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.0.0",
+    "@types/node": "^22.0.0",
+    "@vitest/coverage-v8": "^2.1.0",
+    "eslint": "^9.0.0",
+    "eslint-plugin-security": "^3.0.0",
+    "typescript": "^5.7.0",
+    "typescript-eslint": "^8.0.0",
+    "vitest": "^2.1.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}