@rollupdate/hctl 3.0.0 → 3.1.0

package/README.md

@@ -322,6 +322,7 @@ hctl firewall template get|delete <id>
 ```bash
 hctl vswitch list
 hctl vswitch get <id>
+hctl vswitch servers [id]
 hctl vswitch create <name> <vlan>
 hctl vswitch update <id> [-n <name>] [-v <vlan>]
 hctl vswitch delete <id> [-y] [--date <YYYY-MM-DD>]
@@ -382,8 +383,10 @@ hctl cloud context active
 
 `hctl cloud context bootstrap` is an explicit opt-in assisted browser flow. It
 opens a visible local real-browser session so you can log in to the Hetzner Cloud
-Console yourself, including 2FA. `hctl` does not ask for or store your console
-password and does not scrape the one-time API token from the page. After Hetzner
+Console yourself, including 2FA. `hctl` attaches to the browser only after you
+press Enter, so no automation runs during login. It does not ask for or store
+your console password and does not scrape the one-time API token from the page.
+After Hetzner
 prepares the token form, `hctl` asks for confirmation again before generating
 the credential. Copy the resulting token yourself and paste it into the hidden
 CLI prompt. The token is then validated and saved as a normal `hctl` cloud
@@ -813,6 +816,8 @@ import type {
 |--------|-------------|
 | `listVSwitches()` | List vSwitches |
 | `getVSwitch(id)` | Get details |
+| `listVSwitchesWithServers()` | Get details for every vSwitch, including servers |
+| `addVSwitchServerNames(vswitches)` | Add server names to vSwitch details |
 | `createVSwitch(name, vlan)` | Create |
 | `updateVSwitch(id, name?, vlan?)` | Update |
 | `deleteVSwitch(id, date?)` | Delete |

package/dist/cloud/browser-bootstrap.d.ts

@@ -1,4 +1,5 @@
-import { connect } from "puppeteer-real-browser";
+import { type Options } from "chrome-launcher";
+import type { Page } from "playwright-core";
 export type CloudTokenPermission = "read" | "read-write";
 export interface CloudTokenBootstrapOptions {
     contextName: string;
@@ -12,5 +13,16 @@ export interface CloudTokenBootstrapOptions {
 export declare function normalizePermission(value: string): CloudTokenPermission;
 export declare function upsertEnvValue(content: string, key: string, value: string): string;
 export declare function writeEnvToken(envFile: string, token: string): void;
-export declare function browserConnectionOptions(): Parameters<typeof connect>[0];
+export declare function chromeLaunchOptions(startingUrl: string, extraFlags?: string[]): Options;
+export interface ConsoleBrowserSession {
+    attach: () => Promise<Page>;
+    close: () => Promise<void>;
+}
+/**
+ * Open Chrome without any automation attached. The user logs in to an ordinary
+ * browser session; `attach` connects only once they ask hctl to continue.
+ */
+export declare function launchConsoleBrowser(consoleUrl: string, extraFlags?: string[]): Promise<ConsoleBrowserSession>;
+export declare function submitApiTokenForm(page: Page): Promise<void>;
+export declare function automateTokenSetup(page: Page, options: CloudTokenBootstrapOptions, tokenName: string): Promise<void>;
 export declare function runCloudTokenBootstrap(options: CloudTokenBootstrapOptions): Promise<boolean>;

package/dist/cloud/browser-bootstrap.js

@@ -1,8 +1,7 @@
 import { chmodSync, existsSync, mkdirSync, readFileSync, writeFileSync, } from "node:fs";
 import { dirname, resolve } from "node:path";
 import { confirm, input, password } from "@inquirer/prompts";
-import { Launcher } from "chrome-launcher";
-import { connect } from "puppeteer-real-browser";
+import { Launcher, launch } from "chrome-launcher";
 import { createContext, validateCloudToken } from "./context.js";
 import { HETZNER_CLOUD_CONSOLE_URL } from "./token-instructions.js";
 const ENV_TOKEN_KEY = "HETZNER_CLOUD_TOKEN";
@@ -15,6 +14,7 @@ const READ_PERMISSION_SELECTOR = '[data-test="radio-item--read"]';
 const READ_WRITE_PERMISSION_SELECTOR = '[data-test="radio-item--read_write"]';
 const SELECT_ALL_MODIFIER = process.platform === "darwin" ? "Meta" : "Control";
 const DISABLE_FEATURES_FLAG = "--disable-features=";
+const ELEMENT_TIMEOUT_MS = 15_000;
 function sandboxedChromeFlags() {
     const flags = Launcher.defaultFlags()
         .filter((flag) => flag !== "--disable-component-update")
@@ -61,20 +61,57 @@ export function writeEnvToken(envFile, token) {
     writeFileSync(envFile, nextContent, { mode: 0o600 });
     chmodSync(envFile, 0o600);
 }
-export function browserConnectionOptions() {
+export function chromeLaunchOptions(startingUrl, extraFlags = []) {
     return {
-        args: [
+        chromeFlags: [
             ...sandboxedChromeFlags(),
             "--start-maximized",
             "--disable-dev-shm-usage",
+            ...extraFlags,
         ],
-        connectOption: {
-            defaultViewport: null,
+        // The defaults are already filtered into the flags above.
+        ignoreDefaultFlags: true,
+        startingUrl,
+    };
+}
+function findConsolePage(browser, consoleUrl) {
+    const { origin } = new URL(consoleUrl);
+    const pages = browser.contexts().flatMap((context) => context.pages());
+    const page = pages.filter((candidate) => candidate.url().startsWith(origin)).at(-1) ??
+        pages.at(-1);
+    if (!page) {
+        throw new Error("No browser tab is open. Rerun the bootstrap to continue.");
+    }
+    return page;
+}
+/**
+ * Open Chrome without any automation attached. The user logs in to an ordinary
+ * browser session; `attach` connects only once they ask hctl to continue.
+ */
+export async function launchConsoleBrowser(consoleUrl, extraFlags = []) {
+    const chrome = await launch(chromeLaunchOptions(consoleUrl, extraFlags));
+    let browser = null;
+    return {
+        attach: async () => {
+            try {
+                // Loaded here so other commands do not pay for it at startup.
+                const { chromium } = await import("playwright-core");
+                browser = await chromium.connectOverCDP(`http://127.0.0.1:${chrome.port}`);
+            }
+            catch (error) {
+                throw new Error("Could not connect to the browser. Keep the window open until setup finishes.", { cause: error });
+            }
+            return findConsolePage(browser, consoleUrl);
+        },
+        close: async () => {
+            try {
+                // Only disconnects: a browser attached over CDP keeps running.
+                await browser?.close();
+            }
+            finally {
+                chrome.kill();
+            }
         },
-        headless: false,
-        // puppeteer-real-browser otherwise injects --no-sandbox.
-        ignoreAllFlags: true,
-        turnstile: true,
     };
 }
 async function delay(ms) {
@@ -123,13 +160,14 @@ async function clickVisibleText(page, labels) {
 async function clickVisibleSelector(page, selector) {
     try {
         const element = await page.waitForSelector(selector, {
-            timeout: 15_000,
-            visible: true,
+            state: "visible",
+            timeout: ELEMENT_TIMEOUT_MS,
         });
         if (!element) {
             return false;
         }
-        await element.click();
+        // Styled controls can cover their own input, which fails actionability.
+        await element.click({ force: true, timeout: ELEMENT_TIMEOUT_MS });
         return true;
     }
     catch {
@@ -321,7 +359,10 @@ async function openApiTokenForm(page, tokenName, permission) {
     }
     await delay(1000);
     const inputReady = await page
-        .waitForSelector(DIALOG_INPUT_SELECTOR, { timeout: 15_000, visible: true })
+        .waitForSelector(DIALOG_INPUT_SELECTOR, {
+        state: "visible",
+        timeout: ELEMENT_TIMEOUT_MS,
+    })
         .then(Boolean)
         .catch(() => false);
     const filledTokenName = inputReady &&
@@ -336,7 +377,7 @@ async function openApiTokenForm(page, tokenName, permission) {
         throw new Error(`Could not select ${permission} token permissions.`);
     }
 }
-async function submitApiTokenForm(page) {
+export async function submitApiTokenForm(page) {
     const clickedFinalGenerate = await clickVisibleText(page, [
         "generate api token",
     ]);
@@ -345,20 +386,20 @@ async function submitApiTokenForm(page) {
     }
     await delay(1500);
 }
-async function automateTokenSetup(page, options, tokenName) {
+export async function automateTokenSetup(page, options, tokenName) {
     await ensureProjectOpen(page, options.projectName, options.createProject === true);
     await openApiTokenForm(page, tokenName, options.permission);
 }
 async function openConsole(projectName) {
-    const { browser, page } = await connect(browserConnectionOptions());
-    await page.goto(HETZNER_CLOUD_CONSOLE_URL, { waitUntil: "domcontentloaded" });
+    const session = await launchConsoleBrowser(HETZNER_CLOUD_CONSOLE_URL);
     console.log("");
     console.log("A local real-browser session is open.");
     console.log("Use the browser to log in to Hetzner Cloud, including 2FA.");
+    console.log("hctl does not control the browser until you press Enter.");
     console.log(`After login, hctl will prepare project '${projectName}'.`);
     console.log("");
     console.log("Leave the browser open until you have copied the generated token.");
-    return { browser, page };
+    return session;
 }
 export async function runCloudTokenBootstrap(options) {
     const tokenName = options.tokenName ?? `hctl-${options.projectName.toLowerCase()}`;
@@ -388,11 +429,12 @@ export async function runCloudTokenBootstrap(options) {
         console.log("Aborted.");
         return false;
     }
-    const { browser, page } = await openConsole(options.projectName);
+    const session = await openConsole(options.projectName);
     try {
         await input({
             message: "After logging in to Hetzner Cloud in the browser, press Enter to automate project/token setup.",
         });
+        const page = await session.attach();
         console.log("Automating Hetzner Console setup...");
         await automateTokenSetup(page, options, tokenName);
         console.log("");
@@ -433,6 +475,6 @@ export async function runCloudTokenBootstrap(options) {
         return true;
     }
     finally {
-        await browser.close();
+        await session.close();
     }
 }

package/dist/formatter.d.ts

@@ -1,3 +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 { 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, formatVSwitchServers, 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

@@ -2,5 +2,5 @@
 // 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 { 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, formatVSwitchServers, 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

@@ -6,7 +6,7 @@ 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 { ApiError, ApiResponse, BootConfig, Cancellation, CpanelConfig, Failover, Firewall, FirewallRule, FirewallTemplate, IP, LinuxConfig, Mac, NamedVSwitchServer, 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, VSwitchWithServerNames, 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/robot/client.d.ts

@@ -1,4 +1,4 @@
-import type { BootConfig, Cancellation, Failover, Firewall, FirewallRule, FirewallTemplate, IP, LinuxConfig, Mac, Rdns, RescueConfig, Reset, ResetType, Server, ServerDetails, ServerMarketProduct, ServerProduct, ServerTransaction, SshKey, StorageBox, StorageBoxSnapshot, StorageBoxSnapshotPlan, StorageBoxSubaccount, Subnet, Traffic, VncConfig, VSwitch, VSwitchSummary, WindowsConfig, Wol } from "./types.js";
+import type { BootConfig, Cancellation, Failover, Firewall, FirewallRule, FirewallTemplate, IP, LinuxConfig, Mac, Rdns, RescueConfig, Reset, ResetType, Server, ServerDetails, ServerMarketProduct, ServerProduct, ServerTransaction, SshKey, StorageBox, StorageBoxSnapshot, StorageBoxSnapshotPlan, StorageBoxSubaccount, Subnet, Traffic, VncConfig, VSwitch, VSwitchSummary, VSwitchWithServerNames, WindowsConfig, Wol } from "./types.js";
 export declare class HetznerRobotClient {
     private readonly auth;
     constructor(username: string, password: string);
@@ -171,6 +171,16 @@ export declare class HetznerRobotClient {
     deleteFirewallTemplate(templateId: number): Promise<void>;
     listVSwitches(): Promise<VSwitchSummary[]>;
     getVSwitch(id: number): Promise<VSwitch>;
+    /**
+     * Fetch full details for every vSwitch. The list endpoint omits servers, so
+     * this makes one extra request per vSwitch.
+     */
+    listVSwitchesWithServers(): Promise<VSwitch[]>;
+    /**
+     * Add server names, which vSwitch responses do not include. Costs one server
+     * list request, skipped when no server is attached.
+     */
+    addVSwitchServerNames(vswitches: VSwitch[]): Promise<VSwitchWithServerNames[]>;
     createVSwitch(name: string, vlan: number): Promise<VSwitch>;
     updateVSwitch(id: number, name?: string, vlan?: number): Promise<void>;
     deleteVSwitch(id: number, cancellationDate?: string): Promise<void>;

package/dist/robot/client.js

@@ -435,6 +435,32 @@ export class HetznerRobotClient {
     async getVSwitch(id) {
         return await this.request(`/vswitch/${id}`);
     }
+    /**
+     * Fetch full details for every vSwitch. The list endpoint omits servers, so
+     * this makes one extra request per vSwitch.
+     */
+    async listVSwitchesWithServers() {
+        const vswitches = await this.listVSwitches();
+        return await Promise.all(vswitches.map(({ id }) => this.getVSwitch(id)));
+    }
+    /**
+     * Add server names, which vSwitch responses do not include. Costs one server
+     * list request, skipped when no server is attached.
+     */
+    async addVSwitchServerNames(vswitches) {
+        const hasServers = vswitches.some(({ server }) => server.length > 0);
+        const servers = hasServers ? await this.listServers() : [];
+        const names = new Map(servers
+            .filter(({ server }) => server.server_name.length > 0)
+            .map(({ server }) => [server.server_number, server.server_name]));
+        return vswitches.map((vswitch) => ({
+            ...vswitch,
+            server: vswitch.server.map((srv) => ({
+                ...srv,
+                server_name: names.get(srv.server_number) ?? null,
+            })),
+        }));
+    }
     async createVSwitch(name, vlan) {
         return await this.request("/vswitch", {
             method: "POST",

package/dist/robot/commands/vswitch.js

@@ -1,6 +1,13 @@
 import { success } from "../../shared/formatter.js";
 import { asyncAction, confirmAction, output, } from "../../shared/helpers.js";
-import { formatVSwitchDetails, formatVSwitchList } from "../formatter.js";
+import { formatVSwitchDetails, formatVSwitchList, formatVSwitchServers, } from "../formatter.js";
+const DIGITS_ONLY_REGEX = /^\d+$/;
+function parseVSwitchId(value) {
+    if (!DIGITS_ONLY_REGEX.test(value)) {
+        throw new Error(`Invalid vSwitch ID: ${value}`);
+    }
+    return Number.parseInt(value, 10);
+}
 export function registerVSwitchCommands(parent) {
     const vswitch = parent.command("vswitch").description("vSwitch management");
     vswitch
@@ -19,6 +26,15 @@ export function registerVSwitchCommands(parent) {
         const vs = await client.getVSwitch(Number.parseInt(vswitchId, 10));
         output(vs, formatVSwitchDetails, options);
     }));
+    vswitch
+        .command("servers [id]")
+        .description("List servers attached to all vSwitches, or to one vSwitch")
+        .action(asyncAction(async (client, vswitchId, options) => {
+        const vswitches = vswitchId === undefined
+            ? await client.listVSwitchesWithServers()
+            : [await client.getVSwitch(parseVSwitchId(vswitchId))];
+        output(await client.addVSwitchServerNames(vswitches), formatVSwitchServers, options);
+    }));
     vswitch
         .command("create <name> <vlan>")
         .description("Create a new vSwitch")

package/dist/robot/formatter.d.ts

@@ -1,4 +1,4 @@
-import type { BootConfig, Cancellation, Failover, Firewall, FirewallTemplate, IP, LinuxConfig, Rdns, RescueConfig, Reset, Server, ServerDetails, ServerMarketProduct, ServerProduct, ServerTransaction, SshKey, StorageBox, StorageBoxSnapshot, StorageBoxSubaccount, Subnet, Traffic, VSwitch, VSwitchSummary, Wol } from "./types.js";
+import type { BootConfig, Cancellation, Failover, Firewall, FirewallTemplate, IP, LinuxConfig, Rdns, RescueConfig, Reset, Server, ServerDetails, ServerMarketProduct, ServerProduct, ServerTransaction, SshKey, StorageBox, StorageBoxSnapshot, StorageBoxSubaccount, Subnet, Traffic, VSwitch, VSwitchSummary, VSwitchWithServerNames, Wol } from "./types.js";
 export declare function formatServerList(servers: {
     server: Server;
 }[]): string;
@@ -31,6 +31,7 @@ export declare function formatFirewallTemplateList(templates: {
     firewall_template: FirewallTemplate;
 }[]): string;
 export declare function formatVSwitchList(vswitches: VSwitchSummary[]): string;
+export declare function formatVSwitchServers(vswitches: VSwitchWithServerNames[]): string;
 export declare function formatVSwitchDetails(vswitch: VSwitch): string;
 export declare function formatStorageBoxList(boxes: {
     storagebox: StorageBox;

package/dist/robot/formatter.js

@@ -324,6 +324,42 @@ export function formatVSwitchList(vswitches) {
     }
     return table.toString();
 }
+export function formatVSwitchServers(vswitches) {
+    if (vswitches.length === 0) {
+        return info("No vSwitches found.");
+    }
+    const table = createTable([
+        "vSwitch",
+        "Name",
+        "VLAN",
+        "Cancelled",
+        "Server IP",
+        "Server #",
+        "Server Name",
+        "Status",
+    ]);
+    for (const vswitch of vswitches) {
+        const identity = [
+            vswitch.id.toString(),
+            vswitch.name,
+            vswitch.vlan.toString(),
+            vswitch.cancelled ? colorize("Yes", "red") : "No",
+        ];
+        if (vswitch.server.length === 0) {
+            table.push([...identity, "-", "-", "-", "-"]);
+        }
+        for (const srv of vswitch.server) {
+            table.push([
+                ...identity,
+                srv.server_ip,
+                srv.server_number.toString(),
+                srv.server_name ?? "-",
+                formatStatus(srv.status),
+            ]);
+        }
+    }
+    return table.toString();
+}
 export function formatVSwitchDetails(vswitch) {
     const lines = [];
     lines.push(heading(`vSwitch ${vswitch.id}: ${vswitch.name}`));

package/dist/robot/types.d.ts

@@ -189,6 +189,12 @@ export interface VSwitchServer {
     server_number: number;
     status: "ready" | "in process" | "failed";
 }
+export interface NamedVSwitchServer extends VSwitchServer {
+    server_name: string | null;
+}
+export type VSwitchWithServerNames = Omit<VSwitch, "server"> & {
+    server: NamedVSwitchServer[];
+};
 export interface VSwitchSubnet {
     gateway: string;
     ip: string;

package/dist/shared/reference.js

@@ -182,6 +182,7 @@ hctl firewall template delete <id>      # Delete template (alias: rm)
 # --- vswitch: vSwitch Management ---
 hctl vswitch list                       # List all vSwitches (alias: ls)
 hctl vswitch get <id>                   # Get vSwitch details (alias: show)
+hctl vswitch servers [id]               # List servers on all vSwitches, or one (one API request per vSwitch, plus one for names)
 hctl vswitch create <name> <vlan>       # Create a new vSwitch
 hctl vswitch update <id>                # Update vSwitch
   -n, --name <name>                        #   New name

package/dist/shared/schemas.js

@@ -262,7 +262,15 @@ interface VSwitch {
   cloud_network: VSwitchCloudNetwork[];
 }
 
-type VSwitchSummary = Pick<VSwitch, 'id' | 'name' | 'vlan' | 'cancelled'>;`;
+type VSwitchSummary = Pick<VSwitch, 'id' | 'name' | 'vlan' | 'cancelled'>;
+
+interface NamedVSwitchServer extends VSwitchServer {
+  server_name: string | null;
+}
+
+type VSwitchWithServerNames = Omit<VSwitch, 'server'> & {
+  server: NamedVSwitchServer[];
+};`;
 const ROBOT_STORAGEBOX = `\
 interface StorageBox {
   id: number;
@@ -948,6 +956,7 @@ export const outputSchemas = {
     // --- vswitch ---
     "vswitch list": `${ROBOT_VSWITCH}\n\ntype Output = VSwitchSummary[];`,
     "vswitch get": `${ROBOT_VSWITCH}\n\ntype Output = VSwitch;`,
+    "vswitch servers": `${ROBOT_VSWITCH}\n\ntype Output = VSwitchWithServerNames[];`,
     // --- storagebox ---
     "storagebox list": `${ROBOT_STORAGEBOX}\n\ntype Output = { storagebox: StorageBox }[];`,
     "storagebox get": `${ROBOT_STORAGEBOX}\n\ntype Output = StorageBox;`,

package/dist/types.d.ts

@@ -1,2 +1,2 @@
 export type { AuctionDiskData, AuctionFilterOptions, AuctionIpPrice, AuctionResponse, AuctionServer, } from "./auction/types.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 { ApiError, ApiResponse, BootConfig, Cancellation, CpanelConfig, Failover, Firewall, FirewallRule, FirewallTemplate, IP, LinuxConfig, Mac, NamedVSwitchServer, 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, VSwitchWithServerNames, WindowsConfig, Wol, } from "./robot/types.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rollupdate/hctl",
-  "version": "3.0.0",
+  "version": "3.1.0",
   "description": "Unified CLI and Node.js library for Hetzner Robot API, Cloud API, and server auction",
   "type": "module",
   "main": "./dist/index.js",
@@ -100,7 +100,7 @@
     "commander": "^14.0.3",
     "dotenv": "^18.0.9",
     "keytar": "^7.9.0",
-    "puppeteer-real-browser": "^1.4.4"
+    "playwright-core": "^1.65.0"
   },
   "devDependencies": {
     "@biomejs/biome": "2.4.4",
@@ -124,10 +124,6 @@
   "allowScripts": {
     "better-sqlite3@12.11.1": true,
     "fsevents@2.3.3": true,
-    "keytar@7.9.0": true,
-    "sleep@6.1.0": true
-  },
-  "overrides": {
-    "rebrowser-puppeteer-core": "^25.16.0"
+    "keytar@7.9.0": true
   }
 }