kiwivm-cli 0.1.0 → 0.2.0

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../src/types.ts","../src/client.ts","../src/index.ts"],"sourcesContent":["export interface KiwiVMResponse {\n  error: number;\n  message?: string;\n}\n\nexport class KiwiVMError extends Error {\n  public readonly errorCode: number;\n  public readonly rawResponse: KiwiVMResponse;\n\n  constructor(message: string, errorCode: number, rawResponse: KiwiVMResponse) {\n    super(message);\n    this.name = \"KiwiVMError\";\n    this.errorCode = errorCode;\n    this.rawResponse = rawResponse;\n  }\n}\n\nexport interface ServiceInfo extends KiwiVMResponse {\n  hostname?: string;\n  node_alias?: string;\n  node_location?: string;\n  location_ipv6_ready?: number;\n  plan?: string;\n  plan_monthly_data?: number;\n  plan_disk?: number;\n  plan_ram?: number;\n  plan_swap?: number;\n  os?: string;\n  email?: string;\n  data_counter?: number;\n  data_next_reset?: number;\n  ip_addresses?: string[];\n  private_ip_addresses?: string[];\n  ip_nullroutes?: Record<\n    string,\n    {\n      nullroute_timestamp: number;\n      nullroute_duration_s: number;\n      log: string;\n    }\n  >;\n  iso1?: string;\n  iso2?: string;\n  available_isos?: string[];\n  plan_max_ipv6s?: number;\n  rdns_api_available?: number;\n  plan_private_network_available?: number;\n  location_private_network_available?: number;\n  ptr?: Record<string, string>;\n  suspended?: number;\n  policy_violation?: number;\n  suspension_count?: number;\n  total_abuse_points?: number;\n  max_abuse_points?: number;\n}\n\nexport interface LiveServiceInfo extends ServiceInfo {\n  vm_type?: \"ovz\" | \"kvm\";\n  vz_status?: Record<string, unknown>;\n  vz_quota?: Record<string, unknown>;\n  ve_status?: \"Starting\" | \"Running\" | \"Stopped\";\n  ve_mac1?: string;\n  ve_used_disk_space_b?: number;\n  ve_disk_quota_gb?: number;\n  is_cpu_throttled?: number;\n  is_disk_throttled?: number;\n  ssh_port?: number;\n  live_hostname?: string;\n  load_average?: string;\n  mem_available_kb?: number;\n  swap_total_kb?: number;\n  swap_available_kb?: number;\n  screendump_png_base64?: string;\n}\n\nexport interface Snapshot {\n  fileName: string;\n  os: string;\n  description: string;\n  size: number;\n  md5: string;\n  sticky: number;\n  purgesIn: number;\n  downloadLink: string;\n  downloadLinkSSL: string;\n}\n\nexport interface Backup {\n  backupToken: string;\n  size: number;\n  os: string;\n  md5: string;\n  timestamp: number;\n}\n","import type { KiwiVMResponse } from \"./types.ts\";\nimport { KiwiVMError } from \"./types.ts\";\n\nconst API_BASE = \"https://api.64clouds.com/v1\";\n\nexport interface ClientOptions {\n  veid: string;\n  apiKey: string;\n}\n\nexport class KiwiVMClient {\n  private veid: string;\n  private apiKey: string;\n\n  constructor(options: ClientOptions) {\n    this.veid = options.veid;\n    this.apiKey = options.apiKey;\n  }\n\n  async call<T extends KiwiVMResponse = KiwiVMResponse>(\n    endpoint: string,\n    params: Record<string, string | number | boolean | undefined> = {},\n  ): Promise<T> {\n    const body = new URLSearchParams();\n    body.set(\"veid\", this.veid);\n    body.set(\"api_key\", this.apiKey);\n    for (const [key, value] of Object.entries(params)) {\n      if (value !== undefined) {\n        body.set(key, String(value));\n      }\n    }\n\n    const response = await fetch(`${API_BASE}/${endpoint}`, {\n      method: \"POST\",\n      headers: { \"Content-Type\": \"application/x-www-form-urlencoded\" },\n      body,\n    });\n\n    if (!response.ok) {\n      throw new Error(`HTTP ${response.status}: ${response.statusText}`);\n    }\n\n    const data = (await response.json()) as T & KiwiVMResponse;\n\n    if (data.error !== 0) {\n      throw new KiwiVMError(\n        data.message ?? `API error: ${data.error}`,\n        data.error,\n        data,\n      );\n    }\n\n    return data as T;\n  }\n}\n","#!/usr/bin/env node\n\nimport { KiwiVMClient } from \"./client.ts\";\nimport { KiwiVMError } from \"./types.ts\";\n\nfunction parseFlags(args: string[]): Record<string, string> {\n  const flags: Record<string, string> = {};\n  for (let i = 0; i < args.length; i++) {\n    const arg = args[i];\n    if (!arg?.startsWith(\"--\")) continue;\n    const eqIdx = arg.indexOf(\"=\");\n    if (eqIdx !== -1) {\n      const key = arg.slice(2, eqIdx);\n      const value = arg.slice(eqIdx + 1);\n      flags[toCamelCase(key)] = value;\n    } else {\n      const next = args[i + 1];\n      if (next !== undefined && !next.startsWith(\"--\")) {\n        const key = arg.slice(2);\n        flags[toCamelCase(key)] = next;\n        i++;\n      } else {\n        // --flag with no value (treat as boolean/empty string)\n        const key = arg.slice(2);\n        flags[toCamelCase(key)] = \"\";\n      }\n    }\n  }\n  return flags;\n}\n\nfunction toCamelCase(key: string): string {\n  // Known mappings: kebab-case flags that need camelCase API param names\n  const known: Record<string, string> = {\n    \"backup-token\": \"backupToken\",\n    \"new-hostname\": \"newHostname\",\n    \"ssh-keys\": \"sshKeys\",\n    \"source-veid\": \"sourceVeid\",\n    \"source-token\": \"sourceToken\",\n    \"record-id\": \"recordId\",\n    \"api-key\": \"apiKey\",\n    \"rate-limit\": \"rateLimit\",\n  };\n  if (known[key]) return known[key];\n\n  // Default: convert --some-flag to someFlag\n  return key.replace(/-([a-z])/g, (_, c: string) => c.toUpperCase());\n}\n\nfunction getCommandFromArgs(args: string[]): {\n  positional: string[];\n  flags: Record<string, string>;\n} {\n  const positional: string[] = [];\n  let i = 0;\n  while (i < args.length) {\n    const arg = args[i];\n    if (!arg || arg.startsWith(\"--\")) {\n      break;\n    }\n    positional.push(arg);\n    i++;\n  }\n  const flagArgs = args.slice(i);\n  const flags = parseFlags(flagArgs);\n  return { positional, flags };\n}\n\nasync function main() {\n  const args = process.argv.slice(2);\n  const { positional, flags } = getCommandFromArgs(args);\n\n  const category = positional[0] ?? \"\";\n  const action = positional[1] ?? \"\";\n\n  // Handle help before auth (no credentials needed)\n  if (category === \"\" || category === \"help\") {\n    const { run } = await import(\"./commands/help.ts\");\n    const text = await run();\n    console.log(text as string);\n    return;\n  }\n\n  // Resolve auth: flags first, then env vars\n  const flagVeid = flags[\"veid\"];\n  const flagApiKey = flags[\"apiKey\"];\n  const resolvedVeid = flagVeid || process.env[\"KIWIVM_VEID\"];\n  const resolvedApiKey = flagApiKey || process.env[\"KIWIVM_API_KEY\"];\n\n  if (!resolvedVeid || !resolvedApiKey) {\n    console.error(\n      \"Error: VEID and API key are required. Use --veid and --api-key flags, or set KIWIVM_VEID and KIWIVM_API_KEY environment variables.\",\n    );\n    process.exit(1);\n  }\n\n  // Strip auth flags before passing to handlers\n  const handlerFlags = { ...flags };\n  delete handlerFlags[\"veid\"];\n  delete handlerFlags[\"apiKey\"];\n\n  const client = new KiwiVMClient({\n    veid: resolvedVeid,\n    apiKey: resolvedApiKey,\n  });\n\n  try {\n    let result: unknown;\n\n    switch (category) {\n      case \"power\": {\n        const { run } = await import(\"./commands/power.ts\");\n        result = await run(action, handlerFlags, client);\n        break;\n      }\n      case \"info\": {\n        const { run } = await import(\"./commands/info.ts\");\n        result = await run(action, handlerFlags, client);\n        break;\n      }\n      case \"snapshot\": {\n        const { run } = await import(\"./commands/snapshot.ts\");\n        result = await run(action, handlerFlags, client);\n        break;\n      }\n      case \"backup\": {\n        const { run } = await import(\"./commands/backup.ts\");\n        result = await run(action, handlerFlags, client);\n        break;\n      }\n      case \"system\": {\n        const { run } = await import(\"./commands/system.ts\");\n        result = await run(action, handlerFlags, client);\n        break;\n      }\n      case \"network\": {\n        const { run } = await import(\"./commands/network.ts\");\n        result = await run(action, handlerFlags, client);\n        break;\n      }\n      case \"monitoring\": {\n        const { run } = await import(\"./commands/monitoring.ts\");\n        result = await run(action, handlerFlags, client);\n        break;\n      }\n      case \"admin\": {\n        const { run } = await import(\"./commands/admin.ts\");\n        result = await run(action, handlerFlags, client);\n        break;\n      }\n      default: {\n        console.error(`Unknown category: ${category}`);\n        console.error(\"Run 'kiwivm-cli help' for usage.\");\n        process.exit(1);\n      }\n    }\n\n    console.log(JSON.stringify(result));\n  } catch (error) {\n    const message =\n      error instanceof KiwiVMError ? error.message : String(error);\n    console.error(`Error: ${message}`);\n    process.exit(1);\n  }\n}\n\nexport { main };\n\n// Only auto-run when executed directly (not when imported by tests)\nif (!process.env[\"VITEST\"]) {\n  main();\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.mjs","names":["list","help.run","power.start","power.stop","power.restart","power.kill","info.info","info.status","system.hostname","system.password","admin.suspensions","admin.unsuspend","migrate.clone","snapshot.list","snapshot.create","snapshot.deleteSnapshot","snapshot.restore","snapshot.sticky","snapshot.exportSnapshot","snapshot.importSnapshot","backup.list","backup.copy","system.osList","system.osReinstall","system.sshKeyShow","system.sshKeySet","network.rdnsSet","network.ipv6Add","network.ipv6Delete","network.privateIpList","network.privateIpAssign","network.privateIpDelete","iso.mount","iso.unmount","shell.exec","shell.script","migrate.locations","migrate.migrateStart","stats.usage","stats.audit","stats.rateLimit","admin.violationsList","admin.violationsResolve","admin.notificationsGet","admin.notificationsSet"],"sources":["../src/types.ts","../src/client.ts","../src/commands/admin.ts","../src/commands/backup.ts","../src/commands/help.ts","../src/commands/info.ts","../src/commands/iso.ts","../src/commands/migrate.ts","../src/commands/network.ts","../src/commands/power.ts","../src/commands/shell.ts","../src/commands/snapshot.ts","../src/commands/stats.ts","../src/commands/system.ts","../src/index.ts"],"sourcesContent":["export interface KiwiVMResponse {\n  error: number;\n  message?: string;\n}\n\nexport class KiwiVMError extends Error {\n  public readonly errorCode: number;\n  public readonly rawResponse: KiwiVMResponse;\n\n  constructor(message: string, errorCode: number, rawResponse: KiwiVMResponse) {\n    super(message);\n    this.name = \"KiwiVMError\";\n    this.errorCode = errorCode;\n    this.rawResponse = rawResponse;\n  }\n}\n\nexport interface ServiceInfo extends KiwiVMResponse {\n  vm_type?: \"ovz\" | \"kvm\";\n  hostname?: string;\n  node_alias?: string;\n  node_location?: string;\n  location_ipv6_ready?: number;\n  monthly_data_multiplier?: number;\n  plan?: string;\n  plan_monthly_data?: number;\n  plan_disk?: number;\n  plan_ram?: number;\n  plan_swap?: number;\n  os?: string;\n  email?: string;\n  data_counter?: number;\n  data_next_reset?: number;\n  ip_addresses?: string[];\n  private_ip_addresses?: string[];\n  ip_nullroutes?: Record<\n    string,\n    {\n      nullroute_timestamp: number;\n      nullroute_duration_s: number;\n      log: string;\n    }\n  >;\n  iso1?: string;\n  iso2?: string;\n  available_isos?: string[];\n  plan_max_ipv6s?: number;\n  rdns_api_available?: number;\n  plan_private_network_available?: number;\n  location_private_network_available?: number;\n  ptr?: Record<string, string>;\n  suspended?: number;\n  policy_violation?: number;\n  suspension_count?: number;\n  total_abuse_points?: number;\n  max_abuse_points?: number;\n}\n\nexport interface LiveServiceInfo extends ServiceInfo {\n  vz_status?: Record<string, unknown>;\n  vz_quota?: Record<string, unknown>;\n  ve_status?: \"Starting\" | \"Running\" | \"Stopped\";\n  ve_mac1?: string;\n  ve_used_disk_space_b?: number;\n  ve_disk_quota_gb?: number;\n  is_cpu_throttled?: number;\n  is_disk_throttled?: number;\n  ssh_port?: number;\n  live_hostname?: string;\n  load_average?: string;\n  mem_available_kb?: number;\n  swap_total_kb?: number;\n  swap_available_kb?: number;\n  screendump_png_base64?: string;\n}\n\nexport interface Snapshot {\n  fileName: string;\n  os: string;\n  description: string;\n  size: number;\n  md5: string;\n  sticky: number;\n  purgesIn: number;\n  downloadLink: string;\n  downloadLinkSSL: string;\n}\n\nexport interface Backup {\n  backupToken: string;\n  size: number;\n  os: string;\n  md5: string;\n  timestamp: number;\n}\n\nexport interface RateLimitStatus extends KiwiVMResponse {\n  remaining_points_15min: number;\n  remaining_points_24h: number;\n}\n\nexport interface SuspensionRecord {\n  record_id: number;\n  flag: string;\n  is_soft: number;\n  evidence_record_id: number;\n  abuse_points: number;\n}\n\nexport interface SuspensionDetailsResponse extends KiwiVMResponse {\n  suspension_count: number;\n  total_abuse_points: number;\n  max_abuse_points: number;\n  suspensions: SuspensionRecord[];\n  evidence: Record<string, string>;\n}\n\nexport interface PolicyViolation {\n  record_id: number;\n  timestamp: number;\n  suspend_at: number;\n  flag: string;\n  is_soft: number;\n  abuse_points: number;\n  evidence_data: string;\n}\n\nexport interface PolicyViolationsResponse extends KiwiVMResponse {\n  total_abuse_points: number;\n  max_abuse_points: number;\n  policy_violations: PolicyViolation[];\n}\n\nexport interface NotificationPreference {\n  id: number;\n  name: string;\n  description: string;\n  value: number;\n}\n\nexport interface NotificationPreferencesResponse extends KiwiVMResponse {\n  email_preferences: NotificationPreference[];\n  notificationEmail: string;\n}\n\nexport interface NotificationSetResponse extends KiwiVMResponse {\n  submitted_email_preferences: Record<string, number>;\n  updated_email_preferences: Record<string, number>;\n  friendly_descriptions: Record<string, string>;\n}\n","import type { KiwiVMResponse } from \"./types.ts\";\nimport { KiwiVMError } from \"./types.ts\";\n\nconst API_BASE = \"https://api.64clouds.com/v1\";\n\nexport interface ClientOptions {\n  veid: string;\n  apiKey: string;\n}\n\nexport class KiwiVMClient {\n  private veid: string;\n  private apiKey: string;\n\n  constructor(options: ClientOptions) {\n    this.veid = options.veid;\n    this.apiKey = options.apiKey;\n  }\n\n  async call<T extends KiwiVMResponse = KiwiVMResponse>(\n    endpoint: string,\n    params: Record<string, string | number | boolean | undefined> = {},\n  ): Promise<T> {\n    const body = new URLSearchParams();\n    body.set(\"veid\", this.veid);\n    body.set(\"api_key\", this.apiKey);\n    for (const [key, value] of Object.entries(params)) {\n      if (value !== undefined) {\n        body.set(key, String(value));\n      }\n    }\n\n    const response = await fetch(`${API_BASE}/${endpoint}`, {\n      method: \"POST\",\n      headers: { \"Content-Type\": \"application/x-www-form-urlencoded\" },\n      body,\n    });\n\n    if (!response.ok) {\n      throw new Error(`HTTP ${response.status}: ${response.statusText}`);\n    }\n\n    const data = (await response.json()) as T & KiwiVMResponse;\n\n    if (data.error !== 0) {\n      throw new KiwiVMError(\n        data.message ?? `API error: ${data.error}`,\n        data.error,\n        data,\n      );\n    }\n\n    return data as T;\n  }\n}\n","import type { KiwiVMClient } from \"../client.ts\";\n\nexport async function suspensions(\n  _args: string[],\n  _flags: Record<string, string>,\n  client: KiwiVMClient,\n): Promise<unknown> {\n  return client.call(\"getSuspensionDetails\");\n}\n\nexport async function unsuspend(\n  args: string[],\n  _flags: Record<string, string>,\n  client: KiwiVMClient,\n): Promise<unknown> {\n  const recordId = args[0];\n  if (!recordId) {\n    throw new Error(\"unsuspend requires a <record-id> argument\");\n  }\n  return client.call(\"unsuspend\", { record_id: recordId });\n}\n\nexport async function violationsList(\n  _args: string[],\n  _flags: Record<string, string>,\n  client: KiwiVMClient,\n): Promise<unknown> {\n  return client.call(\"getPolicyViolations\");\n}\n\nexport async function violationsResolve(\n  args: string[],\n  _flags: Record<string, string>,\n  client: KiwiVMClient,\n): Promise<unknown> {\n  const recordId = args[0];\n  if (!recordId) {\n    throw new Error(\"violations resolve requires a <record-id> argument\");\n  }\n  return client.call(\"resolvePolicyViolation\", { record_id: recordId });\n}\n\nexport async function notificationsGet(\n  _args: string[],\n  _flags: Record<string, string>,\n  client: KiwiVMClient,\n): Promise<unknown> {\n  return client.call(\"kiwivm/getNotificationPreferences\");\n}\n\nexport async function notificationsSet(\n  args: string[],\n  _flags: Record<string, string>,\n  client: KiwiVMClient,\n): Promise<unknown> {\n  const prefs = args[0];\n  if (!prefs) {\n    throw new Error(\"notifications set requires a <json> argument\");\n  }\n  return client.call(\"kiwivm/setNotificationPreferences\", {\n    json_notification_preferences: prefs,\n  });\n}\n","import type { KiwiVMClient } from \"../client.ts\";\n\nexport async function list(\n  _args: string[],\n  _flags: Record<string, string>,\n  client: KiwiVMClient,\n): Promise<unknown> {\n  return client.call(\"backup/list\");\n}\n\nexport async function copy(\n  args: string[],\n  _flags: Record<string, string>,\n  client: KiwiVMClient,\n): Promise<unknown> {\n  const token = args[0];\n  if (!token) {\n    throw new Error(\"backup copy requires a <token> argument\");\n  }\n  return client.call(\"backup/copyToSnapshot\", { backupToken: token });\n}\n","const HELP = `Usage: kiwivm-cli <command> [<subcommand>] [args...] [--flags...]\n\nAuth: --veid <VEID> --api-key <KEY>  (or KIWIVM_VEID / KIWIVM_API_KEY env vars)\n\nCommands:\n\n  start                         Start the VPS\n  stop                          Stop the VPS\n  restart                       Reboot the VPS\n  kill                          Force-stop a stuck VPS\n\n  info                          Get service info (plan, IPs, bandwidth, etc.)\n  status                        Get live status (CPU, RAM, disk, uptime)\n\n  snapshot list                 List all snapshots\n  snapshot create [--desc]      Create a new snapshot\n  snapshot delete <token>       Delete a snapshot\n  snapshot restore <token>      Restore from snapshot\n  snapshot sticky <token>       Toggle sticky (--on | --off)\n  snapshot export <token>       Generate transfer token\n  snapshot import <veid> <token> Import snapshot from another instance\n\n  backup list                   List automatic backups\n  backup copy <token>           Convert backup to restorable snapshot\n\n  os list                       List available OS templates\n  os reinstall <template>       Reinstall OS\n\n  hostname <name>               Set new hostname\n  password                      Reset root password\n\n  ssh-key                       Show SSH keys\n  ssh-key set <keys>            Set SSH keys\n\n  rdns set <ip> <ptr>           Set reverse DNS record\n\n  ipv6 add                      Assign new IPv6 /64 subnet\n  ipv6 delete <subnet>          Release IPv6 subnet\n\n  private-ip list               List available private IPs\n  private-ip assign [<ip>]      Assign private IP (random if omitted)\n  private-ip delete <ip>        Release private IP\n\n  iso mount <name>              Mount ISO for boot (VM must be off)\n  iso unmount                   Unmount ISO, boot from disk\n\n  shell exec <command>          Execute command synchronously\n  shell script <script>         Execute script asynchronously\n\n  migrate locations             List available migration locations\n  migrate start <location>      Start migration to new location\n  clone <ip> <password> [--port] Clone from external server (OVZ only)\n\n  stats usage                   Get detailed usage statistics\n  stats audit                   Get audit log\n  stats rate-limit              Check API rate limit status\n\n  suspensions                   View suspension details\n  unsuspend <record-id>         Clear abuse issue and unsuspend\n  violations                    View policy violations\n  violations resolve <record-id> Resolve policy violation\n\n  notifications                 Get notification preferences\n  notifications set <json>      Update notification preferences\n\nOutput: JSON to stdout. Errors to stderr with exit code 1.\n`;\n\nexport async function run(): Promise<string> {\n  return HELP;\n}\n","import type { KiwiVMClient } from \"../client.ts\";\nimport type { LiveServiceInfo, ServiceInfo } from \"../types.ts\";\n\nexport async function info(\n  _args: string[],\n  _flags: Record<string, string>,\n  client: KiwiVMClient,\n): Promise<unknown> {\n  return client.call<ServiceInfo>(\"getServiceInfo\");\n}\n\nexport async function status(\n  _args: string[],\n  _flags: Record<string, string>,\n  client: KiwiVMClient,\n): Promise<unknown> {\n  return client.call<LiveServiceInfo>(\"getLiveServiceInfo\");\n}\n","import type { KiwiVMClient } from \"../client.ts\";\n\nexport async function mount(\n  args: string[],\n  _flags: Record<string, string>,\n  client: KiwiVMClient,\n): Promise<unknown> {\n  const iso = args[0];\n  if (!iso) {\n    throw new Error(\"iso mount requires a <name> argument\");\n  }\n  return client.call(\"iso/mount\", { iso });\n}\n\nexport async function unmount(\n  _args: string[],\n  _flags: Record<string, string>,\n  client: KiwiVMClient,\n): Promise<unknown> {\n  return client.call(\"iso/unmount\");\n}\n","import type { KiwiVMClient } from \"../client.ts\";\n\nexport async function locations(\n  _args: string[],\n  _flags: Record<string, string>,\n  client: KiwiVMClient,\n): Promise<unknown> {\n  return client.call(\"migrate/getLocations\");\n}\n\nexport async function migrateStart(\n  args: string[],\n  _flags: Record<string, string>,\n  client: KiwiVMClient,\n): Promise<unknown> {\n  const location = args[0];\n  if (!location) {\n    throw new Error(\"migrate start requires a <location> argument\");\n  }\n  return client.call(\"migrate/start\", { location });\n}\n\nexport async function clone(\n  args: string[],\n  flags: Record<string, string>,\n  client: KiwiVMClient,\n): Promise<unknown> {\n  const ip = args[0];\n  const password = args[1];\n  if (!ip || !password) {\n    throw new Error(\"clone requires both <ip> and <password> arguments\");\n  }\n  return client.call(\"cloneFromExternalServer\", {\n    externalServerIP: ip,\n    externalServerSSHport: flags[\"port\"] || \"22\",\n    externalServerRootPassword: password,\n  });\n}\n","import type { KiwiVMClient } from \"../client.ts\";\n\nexport async function rdnsSet(\n  args: string[],\n  _flags: Record<string, string>,\n  client: KiwiVMClient,\n): Promise<unknown> {\n  const ip = args[0];\n  const ptr = args[1];\n  if (!ip || !ptr) {\n    throw new Error(\"rdns set requires both <ip> and <ptr> arguments\");\n  }\n  return client.call(\"setPTR\", { ip, ptr });\n}\n\nexport async function ipv6Add(\n  _args: string[],\n  _flags: Record<string, string>,\n  client: KiwiVMClient,\n): Promise<unknown> {\n  return client.call(\"ipv6/add\");\n}\n\nexport async function ipv6Delete(\n  args: string[],\n  _flags: Record<string, string>,\n  client: KiwiVMClient,\n): Promise<unknown> {\n  const ip = args[0];\n  if (!ip) {\n    throw new Error(\"ipv6 delete requires a <subnet> argument\");\n  }\n  return client.call(\"ipv6/delete\", { ip });\n}\n\nexport async function privateIpList(\n  _args: string[],\n  _flags: Record<string, string>,\n  client: KiwiVMClient,\n): Promise<unknown> {\n  return client.call(\"privateIp/getAvailableIps\");\n}\n\nexport async function privateIpAssign(\n  args: string[],\n  _flags: Record<string, string>,\n  client: KiwiVMClient,\n): Promise<unknown> {\n  return client.call(\"privateIp/assign\", { ip: args[0] });\n}\n\nexport async function privateIpDelete(\n  args: string[],\n  _flags: Record<string, string>,\n  client: KiwiVMClient,\n): Promise<unknown> {\n  const ip = args[0];\n  if (!ip) {\n    throw new Error(\"private-ip delete requires an <ip> argument\");\n  }\n  return client.call(\"privateIp/delete\", { ip });\n}\n","import type { KiwiVMClient } from \"../client.ts\";\n\nexport async function start(\n  _args: string[],\n  _flags: Record<string, string>,\n  client: KiwiVMClient,\n): Promise<unknown> {\n  return client.call(\"start\");\n}\n\nexport async function stop(\n  _args: string[],\n  _flags: Record<string, string>,\n  client: KiwiVMClient,\n): Promise<unknown> {\n  return client.call(\"stop\");\n}\n\nexport async function restart(\n  _args: string[],\n  _flags: Record<string, string>,\n  client: KiwiVMClient,\n): Promise<unknown> {\n  return client.call(\"restart\");\n}\n\nexport async function kill(\n  _args: string[],\n  _flags: Record<string, string>,\n  client: KiwiVMClient,\n): Promise<unknown> {\n  return client.call(\"kill\");\n}\n","import type { KiwiVMClient } from \"../client.ts\";\n\nexport async function exec(\n  args: string[],\n  _flags: Record<string, string>,\n  client: KiwiVMClient,\n): Promise<unknown> {\n  const command = args[0];\n  if (!command) {\n    throw new Error(\"shell exec requires a <command> argument\");\n  }\n  return client.call(\"basicShell/exec\", { command });\n}\n\nexport async function script(\n  args: string[],\n  _flags: Record<string, string>,\n  client: KiwiVMClient,\n): Promise<unknown> {\n  const scriptContent = args[0];\n  if (!scriptContent) {\n    throw new Error(\"shell script requires a <script> argument\");\n  }\n  return client.call(\"shellScript/exec\", { script: scriptContent });\n}\n","import type { KiwiVMClient } from \"../client.ts\";\n\nexport async function list(\n  _args: string[],\n  _flags: Record<string, string>,\n  client: KiwiVMClient,\n): Promise<unknown> {\n  return client.call(\"snapshot/list\");\n}\n\nexport async function create(\n  _args: string[],\n  flags: Record<string, string>,\n  client: KiwiVMClient,\n): Promise<unknown> {\n  return client.call(\"snapshot/create\", {\n    description: flags[\"desc\"] || flags[\"description\"],\n  });\n}\n\nexport async function deleteSnapshot(\n  args: string[],\n  _flags: Record<string, string>,\n  client: KiwiVMClient,\n): Promise<unknown> {\n  const token = args[0];\n  if (!token) {\n    throw new Error(\"snapshot delete requires a <token> argument\");\n  }\n  return client.call(\"snapshot/delete\", { snapshot: token });\n}\n\nexport async function restore(\n  args: string[],\n  _flags: Record<string, string>,\n  client: KiwiVMClient,\n): Promise<unknown> {\n  const token = args[0];\n  if (!token) {\n    throw new Error(\"snapshot restore requires a <token> argument\");\n  }\n  return client.call(\"snapshot/restore\", { snapshot: token });\n}\n\nexport async function sticky(\n  args: string[],\n  flags: Record<string, string>,\n  client: KiwiVMClient,\n): Promise<unknown> {\n  const token = args[0];\n  if (!token) {\n    throw new Error(\"snapshot sticky requires a <token> argument\");\n  }\n  if (flags[\"on\"] !== undefined && flags[\"off\"] !== undefined) {\n    throw new Error(\"snapshot sticky requires exactly one of --on or --off\");\n  }\n  if (flags[\"on\"] === undefined && flags[\"off\"] === undefined) {\n    throw new Error(\"snapshot sticky requires exactly one of --on or --off\");\n  }\n  const stickyVal = flags[\"on\"] !== undefined ? 1 : 0;\n  return client.call(\"snapshot/toggleSticky\", {\n    snapshot: token,\n    sticky: stickyVal,\n  });\n}\n\nexport async function exportSnapshot(\n  args: string[],\n  _flags: Record<string, string>,\n  client: KiwiVMClient,\n): Promise<unknown> {\n  const token = args[0];\n  if (!token) {\n    throw new Error(\"snapshot export requires a <token> argument\");\n  }\n  return client.call(\"snapshot/export\", { snapshot: token });\n}\n\nexport async function importSnapshot(\n  args: string[],\n  _flags: Record<string, string>,\n  client: KiwiVMClient,\n): Promise<unknown> {\n  const sourceVeid = args[0];\n  const sourceToken = args[1];\n  if (!sourceVeid || !sourceToken) {\n    throw new Error(\n      \"snapshot import requires both <sourceVeid> and <sourceToken> arguments\",\n    );\n  }\n  return client.call(\"snapshot/import\", { sourceVeid, sourceToken });\n}\n","import type { KiwiVMClient } from \"../client.ts\";\n\nexport async function usage(\n  _args: string[],\n  _flags: Record<string, string>,\n  client: KiwiVMClient,\n): Promise<unknown> {\n  return client.call(\"getRawUsageStats\");\n}\n\nexport async function audit(\n  _args: string[],\n  _flags: Record<string, string>,\n  client: KiwiVMClient,\n): Promise<unknown> {\n  return client.call(\"getAuditLog\");\n}\n\nexport async function rateLimit(\n  _args: string[],\n  _flags: Record<string, string>,\n  client: KiwiVMClient,\n): Promise<unknown> {\n  return client.call(\"getRateLimitStatus\");\n}\n","import type { KiwiVMClient } from \"../client.ts\";\n\nexport async function hostname(\n  args: string[],\n  _flags: Record<string, string>,\n  client: KiwiVMClient,\n): Promise<unknown> {\n  const name = args[0];\n  if (!name) {\n    throw new Error(\"hostname requires a <name> argument\");\n  }\n  return client.call(\"setHostname\", { newHostname: name });\n}\n\nexport async function password(\n  _args: string[],\n  _flags: Record<string, string>,\n  client: KiwiVMClient,\n): Promise<unknown> {\n  return client.call(\"resetRootPassword\");\n}\n\nexport async function osList(\n  _args: string[],\n  _flags: Record<string, string>,\n  client: KiwiVMClient,\n): Promise<unknown> {\n  return client.call(\"getAvailableOS\");\n}\n\nexport async function osReinstall(\n  args: string[],\n  _flags: Record<string, string>,\n  client: KiwiVMClient,\n): Promise<unknown> {\n  const os = args[0];\n  if (!os) {\n    throw new Error(\"os reinstall requires a <template> argument\");\n  }\n  return client.call(\"reinstallOS\", { os });\n}\n\nexport async function sshKeyShow(\n  _args: string[],\n  _flags: Record<string, string>,\n  client: KiwiVMClient,\n): Promise<unknown> {\n  return client.call(\"getSshKeys\");\n}\n\nexport async function sshKeySet(\n  args: string[],\n  _flags: Record<string, string>,\n  client: KiwiVMClient,\n): Promise<unknown> {\n  const keys = args[0];\n  if (!keys) {\n    throw new Error(\"ssh-key set requires a <keys> argument\");\n  }\n  return client.call(\"updateSshKeys\", { ssh_keys: keys });\n}\n","#!/usr/bin/env node\n\nimport { KiwiVMClient } from \"./client.ts\";\nimport * as admin from \"./commands/admin.ts\";\nimport * as backup from \"./commands/backup.ts\";\nimport * as help from \"./commands/help.ts\";\nimport * as info from \"./commands/info.ts\";\nimport * as iso from \"./commands/iso.ts\";\nimport * as migrate from \"./commands/migrate.ts\";\nimport * as network from \"./commands/network.ts\";\nimport * as power from \"./commands/power.ts\";\nimport * as shell from \"./commands/shell.ts\";\nimport * as snapshot from \"./commands/snapshot.ts\";\nimport * as stats from \"./commands/stats.ts\";\nimport * as system from \"./commands/system.ts\";\nimport { KiwiVMError } from \"./types.ts\";\n\ntype Handler = (\n  args: string[],\n  flags: Record<string, string>,\n  client: KiwiVMClient,\n) => Promise<unknown>;\n\ninterface SubcommandRoutes {\n  default?: Handler;\n  [subcommand: string]: Handler | undefined;\n}\n\nfunction parseFlags(args: string[]): Record<string, string> {\n  const flags: Record<string, string> = {};\n  for (let i = 0; i < args.length; i++) {\n    const arg = args[i];\n    if (!arg?.startsWith(\"--\")) continue;\n    const eqIdx = arg.indexOf(\"=\");\n    if (eqIdx !== -1) {\n      const key = arg.slice(2, eqIdx);\n      const value = arg.slice(eqIdx + 1);\n      flags[toCamelCase(key)] = value;\n    } else {\n      const next = args[i + 1];\n      if (next !== undefined && !next.startsWith(\"--\")) {\n        const key = arg.slice(2);\n        flags[toCamelCase(key)] = next;\n        i++;\n      } else {\n        const key = arg.slice(2);\n        flags[toCamelCase(key)] = \"1\";\n      }\n    }\n  }\n  return flags;\n}\n\nfunction toCamelCase(key: string): string {\n  const known: Record<string, string> = {\n    \"backup-token\": \"backupToken\",\n    \"new-hostname\": \"newHostname\",\n    \"ssh-keys\": \"sshKeys\",\n    \"source-veid\": \"sourceVeid\",\n    \"source-token\": \"sourceToken\",\n    \"record-id\": \"recordId\",\n    \"api-key\": \"apiKey\",\n    \"rate-limit\": \"rateLimit\",\n  };\n  if (known[key]) return known[key];\n\n  return key.replace(/-([a-z])/g, (_, c: string) => c.toUpperCase());\n}\n\nfunction getCommandFromArgs(args: string[]): {\n  positional: string[];\n  flags: Record<string, string>;\n} {\n  const positional: string[] = [];\n  let i = 0;\n  while (i < args.length) {\n    const arg = args[i];\n    if (!arg || arg.startsWith(\"--\")) {\n      break;\n    }\n    positional.push(arg);\n    i++;\n  }\n  const flagArgs = args.slice(i);\n  const flags = parseFlags(flagArgs);\n  return { positional, flags };\n}\n\nasync function main() {\n  const args = process.argv.slice(2);\n  const { positional, flags } = getCommandFromArgs(args);\n\n  const command = positional[0] ?? \"\";\n\n  if (command === \"\" || command === \"help\") {\n    console.log(await help.run());\n    return;\n  }\n\n  const flagVeid = flags[\"veid\"];\n  const flagApiKey = flags[\"apiKey\"];\n  const resolvedVeid = flagVeid || process.env[\"KIWIVM_VEID\"];\n  const resolvedApiKey = flagApiKey || process.env[\"KIWIVM_API_KEY\"];\n\n  if (!resolvedVeid || !resolvedApiKey) {\n    console.error(\n      \"Error: VEID and API key are required. Use --veid and --api-key flags, or set KIWIVM_VEID and KIWIVM_API_KEY environment variables.\",\n    );\n    process.exit(1);\n  }\n\n  const handlerFlags = { ...flags };\n  delete handlerFlags[\"veid\"];\n  delete handlerFlags[\"apiKey\"];\n\n  const client = new KiwiVMClient({\n    veid: resolvedVeid,\n    apiKey: resolvedApiKey,\n  });\n\n  try {\n    let result: unknown;\n\n    const ROUTES: Record<string, Handler | SubcommandRoutes> = {\n      start: power.start,\n      stop: power.stop,\n      restart: power.restart,\n      kill: power.kill,\n      info: info.info,\n      status: info.status,\n      hostname: system.hostname,\n      password: system.password,\n      suspensions: admin.suspensions,\n      unsuspend: admin.unsuspend,\n      clone: migrate.clone,\n\n      snapshot: {\n        list: snapshot.list,\n        create: snapshot.create,\n        delete: snapshot.deleteSnapshot,\n        restore: snapshot.restore,\n        sticky: snapshot.sticky,\n        export: snapshot.exportSnapshot,\n        import: snapshot.importSnapshot,\n      },\n      backup: {\n        list: backup.list,\n        copy: backup.copy,\n      },\n      os: {\n        list: system.osList,\n        reinstall: system.osReinstall,\n      },\n      \"ssh-key\": {\n        default: system.sshKeyShow,\n        set: system.sshKeySet,\n      },\n      rdns: {\n        set: network.rdnsSet,\n      },\n      ipv6: {\n        add: network.ipv6Add,\n        delete: network.ipv6Delete,\n      },\n      \"private-ip\": {\n        list: network.privateIpList,\n        assign: network.privateIpAssign,\n        delete: network.privateIpDelete,\n      },\n      iso: {\n        mount: iso.mount,\n        unmount: iso.unmount,\n      },\n      shell: {\n        exec: shell.exec,\n        script: shell.script,\n      },\n      migrate: {\n        locations: migrate.locations,\n        start: migrate.migrateStart,\n      },\n      stats: {\n        usage: stats.usage,\n        audit: stats.audit,\n        \"rate-limit\": stats.rateLimit,\n      },\n      violations: {\n        default: admin.violationsList,\n        resolve: admin.violationsResolve,\n      },\n      notifications: {\n        default: admin.notificationsGet,\n        set: admin.notificationsSet,\n      },\n    };\n\n    const route = ROUTES[command];\n\n    if (!route) {\n      console.error(`Unknown command: ${command}`);\n      console.error(\"Run 'kiwivm-cli help' for usage.\");\n      process.exit(1);\n    }\n\n    if (typeof route === \"function\") {\n      result = await route(positional.slice(1), handlerFlags, client);\n    } else {\n      const subcommand = positional[1];\n      let handler: Handler | undefined;\n\n      if (subcommand && subcommand in route) {\n        handler = route[subcommand];\n      } else if (!subcommand && route.default) {\n        handler = route.default;\n      }\n\n      if (!handler) {\n        const valid = Object.keys(route)\n          .filter((k) => k !== \"default\")\n          .join(\", \");\n        const sc = subcommand || \"(none)\";\n        console.error(\n          `Unknown subcommand for ${command}: ${sc}. Valid: ${valid}`,\n        );\n        process.exit(1);\n      }\n\n      result = await handler(positional.slice(2), handlerFlags, client);\n    }\n\n    console.log(JSON.stringify(result));\n  } catch (error) {\n    const message =\n      error instanceof KiwiVMError ? error.message : String(error);\n    console.error(`Error: ${message}`);\n    process.exit(1);\n  }\n}\n\nexport { main };\n\nif (!process.env[\"VITEST\"]) {\n  main();\n}\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kiwivm-cli",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "CLI for managing KiwiVM (BuyVM) VPS instances",
   "license": "MIT",
   "type": "module",

package/src/commands/admin.test.ts

@@ -1,13 +1,20 @@
 import { describe, expect, it, vi } from "vitest";
 import type { KiwiVMClient } from "../client.ts";
-import { run } from "./admin.ts";
+import {
+  notificationsGet,
+  notificationsSet,
+  suspensions,
+  unsuspend,
+  violationsList,
+  violationsResolve,
+} from "./admin.ts";
 
 function mockClient() {
   const call = vi.fn();
   return { client: { call } as unknown as KiwiVMClient, call };
 }
 
-describe("admin command", () => {
+describe("admin handlers", () => {
   describe("suspensions", () => {
     it("calls getSuspensionDetails", async () => {
       const { client, call } = mockClient();
@@ -16,50 +23,156 @@ describe("admin command", () => {
         suspensions: [{ reason: "abuse", createdAt: "2025-01-01" }],
       });
 
-      const result = await run("suspensions", {}, client);
+      const result = await suspensions([], {}, client);
 
-      expect(client.call).toHaveBeenCalledExactlyOnceWith(
-        "getSuspensionDetails",
-      );
+      expect(call).toHaveBeenCalledExactlyOnceWith("getSuspensionDetails");
       expect(result).toMatchObject({
         suspensions: [{ reason: "abuse" }],
       });
     });
+
+    it("propagates errors from the client", async () => {
+      const { client, call } = mockClient();
+      call.mockRejectedValueOnce(new Error("API failure"));
+
+      await expect(suspensions([], {}, client)).rejects.toThrow("API failure");
+    });
   });
 
   describe("unsuspend", () => {
-    it("calls unsuspend with record-id flag", async () => {
+    it("calls unsuspend with recordId from args", async () => {
       const { client, call } = mockClient();
       call.mockResolvedValueOnce({ error: 0 });
 
-      await run("unsuspend", { recordId: "42" }, client);
+      await unsuspend(["11851"], {}, client);
 
-      expect(client.call).toHaveBeenCalledExactlyOnceWith("unsuspend", {
-        recordId: "42",
+      expect(call).toHaveBeenCalledExactlyOnceWith("unsuspend", {
+        record_id: "11851",
       });
     });
+
+    it("throws when no record ID provided", async () => {
+      const { client } = mockClient();
+
+      await expect(unsuspend([], {}, client)).rejects.toThrow("record");
+    });
+
+    it("propagates errors from the client", async () => {
+      const { client, call } = mockClient();
+      call.mockRejectedValueOnce(new Error("Record not found"));
+
+      await expect(unsuspend(["999"], {}, client)).rejects.toThrow(
+        "Record not found",
+      );
+    });
   });
 
-  describe("resolve", () => {
-    it("calls resolvePolicyViolation with record-id flag", async () => {
+  describe("violationsList", () => {
+    it("calls getPolicyViolations", async () => {
+      const { client, call } = mockClient();
+      call.mockResolvedValueOnce({
+        error: 0,
+        violations: [{ id: 14, reason: "abuse" }],
+      });
+
+      const result = await violationsList([], {}, client);
+
+      expect(call).toHaveBeenCalledExactlyOnceWith("getPolicyViolations");
+      expect(result).toMatchObject({
+        violations: [{ id: 14, reason: "abuse" }],
+      });
+    });
+
+    it("propagates errors from the client", async () => {
+      const { client, call } = mockClient();
+      call.mockRejectedValueOnce(new Error("API failure"));
+
+      await expect(violationsList([], {}, client)).rejects.toThrow(
+        "API failure",
+      );
+    });
+  });
+
+  describe("violationsResolve", () => {
+    it("calls resolvePolicyViolation with recordId from args", async () => {
       const { client, call } = mockClient();
       call.mockResolvedValueOnce({ error: 0 });
 
-      await run("resolve", { recordId: "42" }, client);
+      await violationsResolve(["14"], {}, client);
+
+      expect(call).toHaveBeenCalledExactlyOnceWith("resolvePolicyViolation", {
+        record_id: "14",
+      });
+    });
+
+    it("throws when no record ID provided", async () => {
+      const { client } = mockClient();
 
-      expect(client.call).toHaveBeenCalledExactlyOnceWith(
-        "resolvePolicyViolation",
-        { recordId: "42" },
+      await expect(violationsResolve([], {}, client)).rejects.toThrow("record");
+    });
+
+    it("propagates errors from the client", async () => {
+      const { client, call } = mockClient();
+      call.mockRejectedValueOnce(new Error("Failed to resolve"));
+
+      await expect(violationsResolve(["14"], {}, client)).rejects.toThrow(
+        "Failed to resolve",
+      );
+    });
+  });
+
+  describe("notificationsGet", () => {
+    it("calls kiwivm/getNotificationPreferences", async () => {
+      const { client, call } = mockClient();
+      call.mockResolvedValueOnce({
+        error: 0,
+        preferences: { "1": 1, "2": 0 },
+      });
+
+      const result = await notificationsGet([], {}, client);
+
+      expect(call).toHaveBeenCalledExactlyOnceWith(
+        "kiwivm/getNotificationPreferences",
+      );
+      expect(result).toMatchObject({ preferences: { "1": 1, "2": 0 } });
+    });
+
+    it("propagates errors from the client", async () => {
+      const { client, call } = mockClient();
+      call.mockRejectedValueOnce(new Error("API failure"));
+
+      await expect(notificationsGet([], {}, client)).rejects.toThrow(
+        "API failure",
       );
     });
   });
 
-  it("propagates errors from the client", async () => {
-    const { client, call } = mockClient();
-    call.mockRejectedValueOnce(new Error("Record not found"));
+  describe("notificationsSet", () => {
+    it("calls kiwivm/setNotificationPreferences with JSON from args", async () => {
+      const { client, call } = mockClient();
+      call.mockResolvedValueOnce({ error: 0 });
+
+      await notificationsSet(['{"1":1,"2":0}'], {}, client);
+
+      expect(call).toHaveBeenCalledExactlyOnceWith(
+        "kiwivm/setNotificationPreferences",
+        { json_notification_preferences: '{"1":1,"2":0}' },
+      );
+    });
+
+    it("throws when no preferences JSON provided", async () => {
+      const { client } = mockClient();
+
+      await expect(notificationsSet([], {}, client)).rejects.toThrow(/json/);
+    });
+
+    it("propagates errors from the client", async () => {
+      const { client, call } = mockClient();
+      call.mockRejectedValueOnce(new Error("Invalid preferences"));
 
-    await expect(run("unsuspend", { recordId: "999" }, client)).rejects.toThrow(
-      "Record not found",
-    );
+      await expect(notificationsSet(['{"1":1}'], {}, client)).rejects.toThrow(
+        "Invalid preferences",
+      );
+    });
   });
 });

package/src/commands/admin.ts

@@ -1,25 +1,63 @@
 import type { KiwiVMClient } from "../client.ts";
 
-export async function run(
-  action: string,
-  flags: Record<string, string>,
+export async function suspensions(
+  _args: string[],
+  _flags: Record<string, string>,
   client: KiwiVMClient,
 ): Promise<unknown> {
-  switch (action) {
-    case "suspensions":
-      return client.call("getSuspensionDetails");
-    case "unsuspend":
-      return client.call("unsuspend", { recordId: flags["recordId"] });
-    case "resolve":
-      if (flags["recordId"] !== undefined) {
-        return client.call("resolvePolicyViolation", {
-          recordId: flags["recordId"],
-        });
-      }
-      return client.call("getPolicyViolations");
-    default:
-      throw new Error(
-        `Unknown admin action: ${action}. Valid: suspensions, unsuspend, resolve`,
-      );
+  return client.call("getSuspensionDetails");
+}
+
+export async function unsuspend(
+  args: string[],
+  _flags: Record<string, string>,
+  client: KiwiVMClient,
+): Promise<unknown> {
+  const recordId = args[0];
+  if (!recordId) {
+    throw new Error("unsuspend requires a <record-id> argument");
+  }
+  return client.call("unsuspend", { record_id: recordId });
+}
+
+export async function violationsList(
+  _args: string[],
+  _flags: Record<string, string>,
+  client: KiwiVMClient,
+): Promise<unknown> {
+  return client.call("getPolicyViolations");
+}
+
+export async function violationsResolve(
+  args: string[],
+  _flags: Record<string, string>,
+  client: KiwiVMClient,
+): Promise<unknown> {
+  const recordId = args[0];
+  if (!recordId) {
+    throw new Error("violations resolve requires a <record-id> argument");
+  }
+  return client.call("resolvePolicyViolation", { record_id: recordId });
+}
+
+export async function notificationsGet(
+  _args: string[],
+  _flags: Record<string, string>,
+  client: KiwiVMClient,
+): Promise<unknown> {
+  return client.call("kiwivm/getNotificationPreferences");
+}
+
+export async function notificationsSet(
+  args: string[],
+  _flags: Record<string, string>,
+  client: KiwiVMClient,
+): Promise<unknown> {
+  const prefs = args[0];
+  if (!prefs) {
+    throw new Error("notifications set requires a <json> argument");
   }
+  return client.call("kiwivm/setNotificationPreferences", {
+    json_notification_preferences: prefs,
+  });
 }

package/src/commands/backup.test.ts

@@ -1,15 +1,15 @@
 import { describe, expect, it, vi } from "vitest";
 import type { KiwiVMClient } from "../client.ts";
-import { run } from "./backup.ts";
+import { copy, list } from "./backup.ts";
 
 function mockClient() {
   const call = vi.fn();
   return { client: { call } as unknown as KiwiVMClient, call };
 }
 
-describe("backup command", () => {
+describe("backup handlers", () => {
   describe("list", () => {
-    it("calls backup/list", async () => {
+    it("calls client.call('backup/list')", async () => {
       const { client, call } = mockClient();
       const backups = {
         error: 0,
@@ -25,42 +25,45 @@ describe("backup command", () => {
       };
       call.mockResolvedValueOnce(backups);
 
-      const result = await run("list", {}, client);
+      const result = await list([], {}, client);
 
-      expect(client.call).toHaveBeenCalledExactlyOnceWith("backup/list");
+      expect(call).toHaveBeenCalledExactlyOnceWith("backup/list");
       expect(result).toEqual(backups);
     });
 
-    it("does not pass any extra params", async () => {
+    it("propagates errors from the client", async () => {
       const { client, call } = mockClient();
-      call.mockResolvedValueOnce({ error: 0, backups: [] });
+      call.mockRejectedValueOnce(new Error("API failure"));
 
-      await run("list", {}, client);
-
-      expect(client.call).toHaveBeenCalledExactlyOnceWith("backup/list");
+      await expect(list([], {}, client)).rejects.toThrow("API failure");
     });
   });
 
   describe("copy", () => {
-    it("calls backup/copyToSnapshot with backupToken", async () => {
+    it("calls backup/copyToSnapshot with backup token from args", async () => {
       const { client, call } = mockClient();
       call.mockResolvedValueOnce({ error: 0 });
 
-      await run("copy", { backupToken: "tok1" }, client);
+      await copy(["abc123"], {}, client);
 
-      expect(client.call).toHaveBeenCalledExactlyOnceWith(
-        "backup/copyToSnapshot",
-        { backupToken: "tok1" },
-      );
+      expect(call).toHaveBeenCalledExactlyOnceWith("backup/copyToSnapshot", {
+        backupToken: "abc123",
+      });
     });
-  });
 
-  it("propagates errors from the client", async () => {
-    const { client, call } = mockClient();
-    call.mockRejectedValueOnce(new Error("Backup not found"));
+    it("throws when no backup token provided", async () => {
+      const { client } = mockClient();
+
+      await expect(copy([], {}, client)).rejects.toThrow("token");
+    });
 
-    await expect(run("copy", { backupToken: "bad" }, client)).rejects.toThrow(
-      "Backup not found",
-    );
+    it("propagates errors from the client", async () => {
+      const { client, call } = mockClient();
+      call.mockRejectedValueOnce(new Error("Backup not found"));
+
+      await expect(copy(["bad"], {}, client)).rejects.toThrow(
+        "Backup not found",
+      );
+    });
   });
 });

package/src/commands/backup.ts

@@ -1,23 +1,21 @@
 import type { KiwiVMClient } from "../client.ts";
-import type { Backup, KiwiVMResponse } from "../types.ts";
 
-interface BackupListResponse extends KiwiVMResponse {
-  backups: Backup[];
+export async function list(
+  _args: string[],
+  _flags: Record<string, string>,
+  client: KiwiVMClient,
+): Promise<unknown> {
+  return client.call("backup/list");
 }
 
-export async function run(
-  action: string,
-  flags: Record<string, string>,
+export async function copy(
+  args: string[],
+  _flags: Record<string, string>,
   client: KiwiVMClient,
 ): Promise<unknown> {
-  switch (action) {
-    case "list":
-      return client.call<BackupListResponse>("backup/list");
-    case "copy":
-      return client.call("backup/copyToSnapshot", {
-        backupToken: flags["backupToken"],
-      });
-    default:
-      throw new Error(`Unknown backup action: ${action}. Valid: list, copy`);
+  const token = args[0];
+  if (!token) {
+    throw new Error("backup copy requires a <token> argument");
   }
+  return client.call("backup/copyToSnapshot", { backupToken: token });
 }

package/src/commands/help.test.ts

@@ -14,18 +14,38 @@ describe("help command", () => {
     expect(result).toContain("kiwivm-cli");
   });
 
-  it("lists available command categories", async () => {
+  it("lists key command names in help text", async () => {
     const result = await run();
 
-    // Spot-check a few categories
-    expect(result).toContain("power");
+    // Flat commands
+    expect(result).toContain("start");
+    expect(result).toContain("stop");
     expect(result).toContain("info");
+    expect(result).toContain("status");
+    // Subcommand categories
     expect(result).toContain("snapshot");
     expect(result).toContain("backup");
-    expect(result).toContain("system");
-    expect(result).toContain("network");
-    expect(result).toContain("monitoring");
-    expect(result).toContain("admin");
+    // System actions
+    expect(result).toContain("os");
+    expect(result).toContain("hostname");
+    expect(result).toContain("password");
+    expect(result).toContain("ssh-key");
+    // Network
+    expect(result).toContain("rdns");
+    expect(result).toContain("ipv6");
+    expect(result).toContain("private-ip");
+    // New categories
+    expect(result).toContain("iso");
+    expect(result).toContain("shell");
+    expect(result).toContain("migrate");
+    expect(result).toContain("clone");
+    // Stats
+    expect(result).toContain("stats");
+    // Admin
+    expect(result).toContain("suspensions");
+    expect(result).toContain("unsuspend");
+    expect(result).toContain("violations");
+    expect(result).toContain("notifications");
   });
 
   it("mentions global flags --veid and --api-key", async () => {