@rollupdate/hctl 0.0.0-stage → 3.0.0

package/dist/cloud/types.d.ts

@@ -0,0 +1,437 @@
+export type Labels = Record<string, string>;
+export interface CloudAction {
+    command: string;
+    error: {
+        code: string;
+        message: string;
+    } | null;
+    finished: string | null;
+    id: number;
+    progress: number;
+    resources: {
+        id: number;
+        type: string;
+    }[];
+    started: string;
+    status: "running" | "success" | "error";
+}
+export interface PaginationMeta {
+    pagination: {
+        page: number;
+        per_page: number;
+        previous_page: number | null;
+        next_page: number | null;
+        last_page: number;
+        total_entries: number;
+    };
+}
+export interface CloudApiError {
+    error: {
+        code: string;
+        message: string;
+        details?: unknown;
+    };
+}
+export interface Protection {
+    delete: boolean;
+    rebuild?: boolean;
+}
+export interface Datacenter {
+    description: string;
+    id: number;
+    location: Location;
+    name: string;
+    server_types: {
+        supported: number[];
+        available: number[];
+        available_for_migration: number[];
+    };
+}
+export interface Location {
+    city: string;
+    country: string;
+    description: string;
+    id: number;
+    latitude: number;
+    longitude: number;
+    name: string;
+    network_zone: string;
+}
+export interface ServerType {
+    architecture: "x86" | "arm";
+    cores: number;
+    cpu_type: "shared" | "dedicated";
+    deprecated: boolean;
+    deprecation?: {
+        announced: string;
+        unavailable_after: string;
+    } | null;
+    description: string;
+    disk: number;
+    id: number;
+    memory: number;
+    name: string;
+    prices: ServerTypePrice[];
+    storage_type: "local" | "network";
+}
+export interface ServerTypePrice {
+    included_traffic: number;
+    location: string;
+    price_hourly: {
+        net: string;
+        gross: string;
+    };
+    price_monthly: {
+        net: string;
+        gross: string;
+    };
+}
+export interface ISO {
+    architecture: "x86" | "arm" | null;
+    deprecation?: {
+        announced: string;
+        unavailable_after: string;
+    } | null;
+    description: string;
+    id: number;
+    name: string;
+    type: "public" | "private";
+}
+export interface Image {
+    architecture: "x86" | "arm";
+    bound_to: number | null;
+    created: string;
+    created_from: {
+        id: number;
+        name: string;
+    } | null;
+    deleted: string | null;
+    deprecated: string | null;
+    description: string;
+    disk_size: number;
+    id: number;
+    image_size: number | null;
+    labels: Labels;
+    name: string | null;
+    os_flavor: string;
+    os_version: string | null;
+    protection: Protection;
+    rapid_deploy: boolean;
+    status: "available" | "creating" | "unavailable";
+    type: "system" | "snapshot" | "backup" | "app";
+}
+export interface CloudSshKey {
+    created: string;
+    fingerprint: string;
+    id: number;
+    labels: Labels;
+    name: string;
+    public_key: string;
+}
+export interface CloudServer {
+    backup_window: string | null;
+    created: string;
+    datacenter?: Datacenter;
+    id: number;
+    image: Image | null;
+    included_traffic: number;
+    ingoing_traffic: number | null;
+    iso: ISO | null;
+    labels: Labels;
+    load_balancers: number[];
+    location: Location;
+    locked: boolean;
+    name: string;
+    outgoing_traffic: number | null;
+    placement_group?: {
+        id: number;
+        name: string;
+        type: string;
+    } | null;
+    primary_disk_size: number;
+    private_net: {
+        network: number;
+        ip: string;
+        alias_ips: string[];
+        mac_address: string;
+    }[];
+    protection: Protection;
+    public_net: {
+        ipv4: {
+            ip: string;
+            dns_ptr: string;
+            blocked: boolean;
+        } | null;
+        ipv6: {
+            ip: string;
+            dns_ptr: {
+                ip: string;
+                dns_ptr: string;
+            }[];
+            blocked: boolean;
+        } | null;
+        floating_ips: number[];
+        firewalls: {
+            id: number;
+            status: "applied" | "pending";
+        }[];
+    };
+    rescue_enabled: boolean;
+    server_type?: ServerType;
+    status: "running" | "initializing" | "starting" | "stopping" | "off" | "deleting" | "migrating" | "rebuilding" | "unknown";
+    volumes: number[];
+}
+export interface Network {
+    created: string;
+    expose_routes_to_vswitch: boolean;
+    id: number;
+    ip_range: string;
+    labels: Labels;
+    load_balancers: number[];
+    name: string;
+    protection: Protection;
+    routes: NetworkRoute[];
+    servers: number[];
+    subnets: NetworkSubnet[];
+}
+export interface NetworkSubnet {
+    gateway: string;
+    ip_range: string;
+    network_zone: string;
+    type: "cloud" | "server" | "vswitch";
+    vswitch_id?: number | null;
+}
+export interface NetworkRoute {
+    destination: string;
+    gateway: string;
+}
+export interface CloudFirewall {
+    applied_to: CloudFirewallAppliedTo[];
+    created: string;
+    id: number;
+    labels: Labels;
+    name: string;
+    rules: CloudFirewallRule[];
+}
+export interface CloudFirewallRule {
+    description: string | null;
+    destination_ips: string[];
+    direction: "in" | "out";
+    port: string | null;
+    protocol: "tcp" | "udp" | "icmp" | "esp" | "gre";
+    source_ips: string[];
+}
+export interface CloudFirewallAppliedTo {
+    label_selector?: {
+        selector: string;
+    };
+    server?: {
+        id: number;
+    };
+    type: "server" | "label_selector";
+}
+export interface FloatingIp {
+    blocked: boolean;
+    created: string;
+    description: string;
+    dns_ptr: {
+        ip: string;
+        dns_ptr: string;
+    }[];
+    home_location: Location;
+    id: number;
+    ip: string;
+    labels: Labels;
+    name: string;
+    protection: Protection;
+    server: number | null;
+    type: "ipv4" | "ipv6";
+}
+export interface PrimaryIp {
+    assignee_id: number | null;
+    assignee_type: "server" | "load_balancer" | "unassigned";
+    auto_delete: boolean;
+    blocked: boolean;
+    created: string;
+    dns_ptr: {
+        ip: string;
+        dns_ptr: string;
+    }[];
+    id: number;
+    ip: string;
+    labels: Labels;
+    location: Location;
+    name: string;
+    protection: Protection;
+    type: "ipv4" | "ipv6";
+}
+export interface Volume {
+    created: string;
+    format: string | null;
+    id: number;
+    labels: Labels;
+    linux_device: string | null;
+    location: Location;
+    name: string;
+    protection: Protection;
+    server: number | null;
+    size: number;
+    status: "creating" | "available" | "attached";
+}
+export interface LoadBalancer {
+    algorithm: {
+        type: "round_robin" | "least_connections";
+    };
+    created: string;
+    id: number;
+    included_traffic: number;
+    ingoing_traffic: number | null;
+    labels: Labels;
+    load_balancer_type: LoadBalancerType;
+    location: Location;
+    name: string;
+    outgoing_traffic: number | null;
+    private_net: {
+        network: number;
+        ip: string;
+    }[];
+    protection: Protection;
+    public_net: {
+        enabled: boolean;
+        ipv4: {
+            ip: string;
+            dns_ptr: string;
+        };
+        ipv6: {
+            ip: string;
+            dns_ptr: string;
+        };
+    };
+    services: LoadBalancerService[];
+    targets: LoadBalancerTarget[];
+}
+export interface LoadBalancerType {
+    deprecated: string | null;
+    description: string;
+    id: number;
+    max_assigned_certificates: number;
+    max_connections: number;
+    max_services: number;
+    max_targets: number;
+    name: string;
+    prices: ServerTypePrice[];
+}
+export interface LoadBalancerTarget {
+    health_status: {
+        listen_port: number;
+        status: "healthy" | "unhealthy" | "unknown";
+    }[];
+    ip?: {
+        ip: string;
+    };
+    label_selector?: {
+        selector: string;
+    };
+    server?: {
+        id: number;
+    };
+    type: "server" | "label_selector" | "ip";
+    use_private_ip: boolean;
+}
+export interface LoadBalancerService {
+    destination_port: number;
+    health_check: {
+        protocol: "tcp" | "http" | "https";
+        port: number;
+        interval: number;
+        timeout: number;
+        retries: number;
+        http?: {
+            domain: string | null;
+            path: string;
+            response: string | null;
+            status_codes: string[];
+            tls: boolean;
+        };
+    };
+    http?: {
+        cookie_name: string;
+        cookie_lifetime: number;
+        certificates: number[];
+        redirect_http: boolean;
+        sticky_sessions: boolean;
+    };
+    listen_port: number;
+    protocol: "tcp" | "http" | "https";
+    proxyprotocol: boolean;
+}
+export interface Certificate {
+    certificate: string | null;
+    created: string;
+    domain_names: string[];
+    fingerprint: string | null;
+    id: number;
+    labels: Labels;
+    name: string;
+    not_valid_after: string;
+    not_valid_before: string;
+    status: {
+        issuance: "pending" | "completed" | "failed";
+        renewal: "scheduled" | "pending" | "failed" | "unavailable";
+        error?: {
+            code: string;
+            message: string;
+        } | null;
+    } | null;
+    type: "uploaded" | "managed";
+    used_by: {
+        id: number;
+        type: string;
+    }[];
+}
+export interface PlacementGroup {
+    created: string;
+    id: number;
+    labels: Labels;
+    name: string;
+    servers: number[];
+    type: "spread";
+}
+export interface PriceAmount {
+    gross: string;
+    net: string;
+}
+/** Location-bound price entry; hourly is absent on floating IPs. */
+export interface IpPrice {
+    location: string;
+    price_hourly?: PriceAmount;
+    price_monthly: PriceAmount;
+}
+export interface PricingServerTypePrice extends ServerTypePrice {
+    price_per_tb_traffic?: PriceAmount;
+}
+export interface NamedTypePricing {
+    name: string;
+    prices: PricingServerTypePrice[];
+}
+export interface IpTypePricing {
+    prices: IpPrice[];
+    type: "ipv4" | "ipv6";
+}
+export interface CloudPricing {
+    currency: string;
+    floating_ips: IpTypePricing[];
+    image: {
+        price_per_gb_month: PriceAmount;
+    };
+    load_balancer_types: NamedTypePricing[];
+    primary_ips: IpTypePricing[];
+    server_backup: {
+        percentage: string;
+    };
+    server_types: NamedTypePricing[];
+    vat_rate: string;
+    volume: {
+        price_per_gb_month: PriceAmount;
+    };
+}

package/dist/cloud/types.js

@@ -0,0 +1,5 @@
+// ============================================================================
+// Hetzner Cloud API Types
+// Based on: https://docs.hetzner.cloud/
+// ============================================================================
+export {};

package/dist/config.d.ts

@@ -0,0 +1 @@
+export { type Config, type CredentialSource, clearConfig, clearConfigFile, clearKeychain, getCredentials, getCredentialsFromEnv, getCredentialsFromFile, getKeychainCredentials, hasCredentials, hasCredentialsSync, hasKeychainSupport, loadConfig, promptLogin, requireCredentials, saveConfig, saveToKeychain, } from "./shared/config.js";

package/dist/config.js

@@ -0,0 +1,2 @@
+// Re-export from new location for backward compatibility
+export { clearConfig, clearConfigFile, clearKeychain, getCredentials, getCredentialsFromEnv, getCredentialsFromFile, getKeychainCredentials, hasCredentials, hasCredentialsSync, hasKeychainSupport, loadConfig, promptLogin, requireCredentials, saveConfig, saveToKeychain, } from "./shared/config.js";

package/dist/formatter.d.ts

@@ -0,0 +1,3 @@
+export { formatAuctionDetails, formatAuctionList, } from "./auction/formatter.js";
+export { formatBootConfig, formatCancellation, formatFailoverList, formatFailoverSwitch, formatFirewall, formatFirewallTemplateList, formatIpDetails, formatIpList, formatLinuxActivation, formatRdnsList, formatRescueActivation, formatResetOptions, formatResetResult, formatServerDetails, formatServerList, formatServerMarketProductList, formatServerProductList, formatSshKeyDetails, formatSshKeyList, formatStorageBoxDetails, formatStorageBoxList, formatStorageBoxSnapshots, formatStorageBoxSubaccounts, formatSubnetList, formatTraffic, formatTransactionList, formatVSwitchDetails, formatVSwitchList, formatWolResult, } from "./robot/formatter.js";
+export { colorize, colors, createTable, error, formatBytes, formatDate, formatDateTime, formatJson, formatStatus, heading, info, success, warning, } from "./shared/formatter.js";

package/dist/formatter.js

@@ -0,0 +1,6 @@
+// Re-export shared formatter utilities
+// Auction formatters
+export { formatAuctionDetails, formatAuctionList, } from "./auction/formatter.js";
+// Re-export robot-specific formatters for backward compatibility
+export { formatBootConfig, formatCancellation, formatFailoverList, formatFailoverSwitch, formatFirewall, formatFirewallTemplateList, formatIpDetails, formatIpList, formatLinuxActivation, formatRdnsList, formatRescueActivation, formatResetOptions, formatResetResult, formatServerDetails, formatServerList, formatServerMarketProductList, formatServerProductList, formatSshKeyDetails, formatSshKeyList, formatStorageBoxDetails, formatStorageBoxList, formatStorageBoxSnapshots, formatStorageBoxSubaccounts, formatSubnetList, formatTraffic, formatTransactionList, formatVSwitchDetails, formatVSwitchList, formatWolResult, } from "./robot/formatter.js";
+export { colorize, colors, createTable, error, formatBytes, formatDate, formatDateTime, formatJson, formatStatus, heading, info, success, warning, } from "./shared/formatter.js";

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+export { type AuctionFetchMetadata, type AuctionFetchOptions, type AuctionFetchResult, type AuctionSource, DEFAULT_AUCTION_CACHE_BASE_URL, fetchAuctionData, fetchAuctionServers, filterAuctionServers, getAuctionDataUrl, sortAuctionServers, } from "./auction/client.js";
+export { computeDiff, type DiffResult, type PriceChange, } from "./auction/diff.js";
+export { getLatestSnapshot, getSnapshotServers, openDatabase, pruneSnapshots, type StoredSnapshot, saveSnapshot, } from "./auction/store.js";
+export type { AuctionDiskData, AuctionFilterOptions, AuctionIpPrice, AuctionResponse, AuctionServer, } from "./auction/types.js";
+export { HetznerCloudClient } from "./cloud/client.js";
+export { createContext, deleteContext, getActiveContext, listContexts, resolveToken, useContext, validateCloudToken, } from "./cloud/context.js";
+export type { Certificate, CloudAction, CloudApiError, CloudFirewall, CloudFirewallAppliedTo, CloudFirewallRule, CloudServer, CloudSshKey, Datacenter, FloatingIp, Image, ISO, Labels, LoadBalancer, LoadBalancerService, LoadBalancerTarget, LoadBalancerType, Location, Network, NetworkRoute, NetworkSubnet, PaginationMeta, PlacementGroup, PrimaryIp, Protection, ServerType, ServerTypePrice, Volume, } from "./cloud/types.js";
+export { HetznerRobotClient } from "./robot/client.js";
+export type { ApiError, ApiResponse, BootConfig, Cancellation, CpanelConfig, Failover, Firewall, FirewallRule, FirewallTemplate, IP, LinuxConfig, Mac, PleskConfig, ProductPrice, Rdns, RescueConfig, Reset, ResetType, Server, ServerDetails, ServerMarketProduct, ServerProduct, ServerSubnet, ServerTransaction, ServerTransactionProduct, SshKey, StorageBox, StorageBoxSnapshot, StorageBoxSnapshotPlan, StorageBoxSubaccount, Subnet, Traffic, TrafficData, VncConfig, VSwitch, VSwitchCloudNetwork, VSwitchServer, VSwitchSubnet, VSwitchSummary, WindowsConfig, Wol, } from "./robot/types.js";
+export { type Config, clearConfig, getCredentials, hasCredentials, loadConfig, promptLogin, requireCredentials, saveConfig, } from "./shared/config.js";
+export { colorize, colors, error, formatBytes, formatDate, formatDateTime, formatJson, formatStatus, heading, info, success, warning, } from "./shared/formatter.js";
+export { generateReference } from "./shared/reference.js";

package/dist/index.js

@@ -0,0 +1,21 @@
+// ============================================================================
+// hctl - Main Library Export
+// ============================================================================
+// Auction Client
+export { DEFAULT_AUCTION_CACHE_BASE_URL, fetchAuctionData, fetchAuctionServers, filterAuctionServers, getAuctionDataUrl, sortAuctionServers, } from "./auction/client.js";
+// Auction Diff
+export { computeDiff, } from "./auction/diff.js";
+// Auction Store
+export { getLatestSnapshot, getSnapshotServers, openDatabase, pruneSnapshots, saveSnapshot, } from "./auction/store.js";
+// Cloud Client
+export { HetznerCloudClient } from "./cloud/client.js";
+// Cloud Context
+export { createContext, deleteContext, getActiveContext, listContexts, resolveToken, useContext, validateCloudToken, } from "./cloud/context.js";
+// Robot Client
+export { HetznerRobotClient } from "./robot/client.js";
+// Configuration utilities (for CLI integration)
+export { clearConfig, getCredentials, hasCredentials, loadConfig, promptLogin, requireCredentials, saveConfig, } from "./shared/config.js";
+// Formatter utilities (for custom output)
+export { colorize, colors, error, formatBytes, formatDate, formatDateTime, formatJson, formatStatus, heading, info, success, warning, } from "./shared/formatter.js";
+// Reference documentation (for LLM context)
+export { generateReference } from "./shared/reference.js";