virtualizorjs 1.0.5 → 2.1.0

package/dist/index.d.ts

@@ -0,0 +1,383 @@
+interface VirtualizorError {
+    code: number;
+    msg: string;
+}
+interface VirtualizorResponse {
+    title?: string;
+    timenow?: number;
+    time_taken?: string;
+    error?: VirtualizorError[];
+}
+interface AsyncTaskResult extends VirtualizorResponse {
+    done?: 1;
+    taskid?: string;
+}
+type VirtType = 'kvm' | 'xen' | 'openvz' | 'lxc' | 'proxmox' | 'virtuozzo' | 'xcp' | 'hyperv';
+
+interface VirtualizorConfig {
+    host: string;
+    apiKey: string;
+    apiPass?: string;
+    port?: number;
+    https?: boolean;
+    rejectUnauthorized?: boolean;
+    timeout?: number;
+}
+interface ResolvedConfig {
+    host: string;
+    apiKey: string;
+    apiPass: string;
+    port: number;
+    https: boolean;
+    rejectUnauthorized: boolean;
+    timeout: number;
+}
+
+declare class VirtualizorApiError extends Error {
+    readonly code: number;
+    constructor(message: string, code: number);
+}
+type Params = Record<string, string | number | undefined>;
+declare class HttpClient {
+    private readonly config;
+    constructor(config: ResolvedConfig);
+    parseResponse<T extends VirtualizorResponse>(data: T): T;
+    request<T extends VirtualizorResponse>(act: string, queryParams?: Params, bodyParams?: Params): Promise<T>;
+    private rawRequest;
+}
+
+interface Plan {
+    pid: string;
+    plan_name: string;
+    disk: string;
+    ram: string;
+    bandwidth: string;
+    cpu: string;
+    virt?: string;
+}
+interface CreatePlanParams {
+    plan_name: string;
+    disk: number;
+    ram: number;
+    bandwidth: number;
+    cpu: number;
+    virt?: string;
+}
+
+declare class PlansResource {
+    private readonly http;
+    constructor(http: HttpClient);
+    list(): Promise<Record<string, Plan>>;
+    create(params: CreatePlanParams): Promise<AsyncTaskResult>;
+    delete(planId: string): Promise<AsyncTaskResult>;
+}
+
+interface Task {
+    id: string;
+    action: string;
+    status: string;
+    vpsid?: string;
+    data?: unknown;
+}
+
+declare class TasksResource {
+    private readonly http;
+    constructor(http: HttpClient);
+    get(taskId: string): Promise<Task | undefined>;
+    wait(taskId: string, options?: {
+        pollIntervalMs?: number;
+        timeoutMs?: number;
+    }): Promise<Task>;
+}
+
+interface User {
+    uid: string;
+    email: string;
+    fname?: string;
+    lname?: string;
+    status: string;
+    type: string;
+}
+interface CreateUserParams {
+    email: string;
+    password: string;
+    fname?: string;
+    lname?: string;
+    acttype?: number;
+}
+
+declare class UsersResource {
+    private readonly http;
+    constructor(http: HttpClient);
+    list(): Promise<Record<string, User>>;
+    create(params: CreateUserParams): Promise<AsyncTaskResult>;
+    delete(uid: string): Promise<AsyncTaskResult>;
+    suspend(uid: string): Promise<AsyncTaskResult>;
+    unsuspend(uid: string): Promise<AsyncTaskResult>;
+}
+
+interface VPSData {
+    os_type?: number | string;
+    rtc?: number | string;
+    unprivileged?: number | string;
+    vnc_auto_port?: number | string;
+    nested_virt?: number | string;
+    vga_vram?: number | string;
+    discard?: number | string;
+    vlan_tag?: number | string;
+    enable_guest_agent?: number | string;
+    ssd_emulation?: number | string;
+    machine_type?: number | string;
+    bios?: string;
+    enable_tpm?: number | string;
+    disable_password?: string;
+    ssh_options?: string;
+    added_keys?: unknown[];
+    io_uring?: number | string;
+    min_ram?: number | string;
+    vga?: number | string;
+    vga_memory?: number | string;
+    cpu_flags?: number | string;
+    scsi_controller?: number | string;
+    demo?: string | null;
+    enable_cpu_threshold?: number | string;
+    cpu_threshold?: number | string;
+    cpu_threshold_time?: number | string;
+    disable_guest_agent?: number | string;
+    disable_autostart?: number | string;
+    iothread?: number | string;
+    nesting?: number | string;
+    suspended_time?: number | string;
+    multiqueue?: number | string;
+    freeze_fs_on_backup?: number | string;
+    enable_ver_scaling?: number | string;
+    ver_max_ram?: string | number;
+    ver_ram_threshold?: string | number;
+    ver_ram_inc_by?: string | number;
+    ver_max_cpu?: string | number;
+    ver_cpu_threshold?: string | number;
+    ver_cpu_inc_by?: string | number;
+    random_ipv6?: number | string;
+    encrypted_pass?: number | string;
+    vm_admin_name?: string;
+    crypted_pass?: string | null;
+    crypted_salt?: string | null;
+    custom_ipv6_on_edit?: number | string;
+    docker_info?: unknown | null;
+}
+interface VPS {
+    vpsid: string;
+    vps_name?: string;
+    uuid?: string;
+    serid?: string | number;
+    time?: string | number;
+    edittime?: string | number;
+    virt?: VirtType | string;
+    uid?: string | number;
+    plid?: string | number;
+    hostname: string;
+    osid?: string | number;
+    os_name: string;
+    iso?: string;
+    sec_iso?: string;
+    boot?: string;
+    space?: string | number;
+    inodes?: string | number;
+    ram: string;
+    burst?: string | number;
+    swap?: string | number;
+    cpu?: string | number;
+    cores?: string | number;
+    cpupin?: string | number;
+    cpu_percent?: string | number;
+    bandwidth: string;
+    network_speed?: string | number;
+    upload_speed?: string | number;
+    io?: string | number;
+    ubc?: string;
+    acpi?: string | number;
+    apic?: string | number;
+    pae?: string | number;
+    shadow?: string | number;
+    vnc?: string | number;
+    vncport?: string | number;
+    vnc_passwd?: string;
+    hvm?: string | number;
+    suspended?: string | number;
+    suspend_reason?: string | null;
+    nw_suspended?: string | null;
+    rescue?: string | number;
+    band_suspend?: string | number;
+    tuntap?: string | number;
+    ppp?: string | number;
+    ploop?: string | number;
+    dns_nameserver?: string;
+    osreinstall_limit?: string | number;
+    preferences?: unknown | null;
+    nic_type?: string;
+    vif_type?: string;
+    virtio?: string | number;
+    pv_on_hvm?: string | number;
+    disks?: unknown | null;
+    kvm_cache?: string | number;
+    io_mode?: string | number;
+    cpu_mode?: string;
+    total_iops_sec?: string | number;
+    read_bytes_sec?: string | number;
+    write_bytes_sec?: string | number;
+    kvm_vga?: string | number;
+    acceleration?: string | number;
+    vnc_keymap?: string;
+    routing?: string | number;
+    mg?: string;
+    used_bandwidth?: string | number;
+    cached_disk?: unknown;
+    webuzo?: string | number;
+    disable_ebtables?: string | number;
+    install_xentools?: string | number;
+    admin_managed?: string | number;
+    rdp?: string | number;
+    topology_sockets?: string | number;
+    topology_cores?: string | number;
+    topology_threads?: string | number;
+    mac?: string;
+    notes?: string | null;
+    disable_nw_config?: string | number;
+    locked?: string;
+    openvz_features?: string;
+    speed_cap?: string;
+    numa?: string | number;
+    bpid?: string | number;
+    bserid?: string | number;
+    timezone?: string | null;
+    ha?: string | number;
+    load_balancer?: string | number;
+    data?: VPSData;
+    fwid?: string | number;
+    admin_fwid?: string | number;
+    current_resource?: unknown | null;
+    plan_expiry?: string | number;
+    machine_status?: string | number;
+    tags?: string | null;
+    server_name?: string;
+    email?: string;
+    pid?: string | number;
+    type?: string | number;
+    os_distro?: string;
+    stid?: number[];
+    ips?: Record<string, string>;
+}
+interface ListVPSParams {
+    user?: string | number;
+    vpsid?: string | number;
+    vpsname?: string;
+    vpsip?: string;
+    vpshostname?: string;
+    vsstatus?: string;
+    vstype?: VirtType;
+    serid?: number;
+    plid?: number;
+    bpid?: number;
+}
+interface CreateVPSParams {
+    hostname: string;
+    rootpass: string;
+    osid: number;
+    plid?: number;
+    user_email?: string;
+    ips?: number;
+    ips_int?: number;
+    space?: number;
+    ram?: number;
+    burst?: number;
+    bandwidth?: number;
+    cpu?: number;
+    cpu_percent?: number;
+    virt?: VirtType;
+    serid?: number;
+    node_select?: 0 | 1;
+    recipe?: number;
+    sshkey?: string;
+    nopassword?: 0 | 1;
+}
+interface RebuildVPSParams {
+    /** OS template ID to rebuild with */
+    osid: number;
+    /** New root password for the VPS */
+    newpass: string;
+    /** Must be set to 1 to confirm the rebuild */
+    conf: 1;
+    /** Format primary disk (0 = no, 1 = yes); defaults to 0 */
+    format_primary?: 0 | 1;
+    /** Send rebuild notification email (0 = no, 1 = yes) */
+    eu_send_rebuild_email?: 0 | 1;
+    /** Recipe ID to apply post-rebuild */
+    recipe?: number;
+    /** SSH key to inject */
+    sshkey?: string;
+}
+interface CloneVPSParams {
+    /** Hostname for the new cloned VPS */
+    hostname: string;
+    /** Root password for the new cloned VPS */
+    rootpass: string;
+    /** Source server ID (server where the VPS lives) */
+    from_server: number;
+    /** Destination server ID (server to clone into) */
+    to_server: number;
+}
+interface MigrateVPSParams {
+    /** Destination server ID */
+    serid: number;
+    /** Source server IP address */
+    from_ip: string;
+    /** Source server API/root password */
+    from_pass: string;
+    /** 0 = ignore VDF conflicts, 1 = error on conflict */
+    ignore_if_vdfconflict?: 0 | 1;
+    /** 0 = use gzip compression, 1 = disable gzip */
+    disable_gzip?: 0 | 1;
+    /** 0 = offline migration, 1 = live migration */
+    online?: 0 | 1;
+}
+interface VPSStatsResponse extends VirtualizorResponse {
+    vs_stats?: unknown;
+    vs_bandwidth?: unknown;
+    time_taken?: string;
+}
+interface VNCInfo extends VirtualizorResponse {
+    novnc?: string;
+    [key: string]: unknown;
+}
+
+declare class VpsResource {
+    private readonly http;
+    constructor(http: HttpClient);
+    list(filters?: ListVPSParams): Promise<Record<string, VPS>>;
+    get(vpsId: string): Promise<VPS>;
+    create(params: CreateVPSParams): Promise<AsyncTaskResult>;
+    delete(vpsId: string): Promise<AsyncTaskResult>;
+    start(vpsId: string): Promise<AsyncTaskResult>;
+    stop(vpsId: string): Promise<AsyncTaskResult>;
+    restart(vpsId: string): Promise<AsyncTaskResult>;
+    poweroff(vpsId: string): Promise<AsyncTaskResult>;
+    suspend(vpsId: string): Promise<AsyncTaskResult>;
+    unsuspend(vpsId: string): Promise<AsyncTaskResult>;
+    rebuild(vpsId: string, params: RebuildVPSParams): Promise<AsyncTaskResult>;
+    clone(vpsId: string, params: CloneVPSParams): Promise<AsyncTaskResult>;
+    migrate(vpsId: string, params: MigrateVPSParams): Promise<AsyncTaskResult>;
+    status(vpsId: string): Promise<unknown>;
+    vnc(vpsId: string): Promise<VNCInfo>;
+    stats(vpsId: string): Promise<VPSStatsResponse>;
+}
+
+declare class VirtualizorClient {
+    readonly vps: VpsResource;
+    readonly users: UsersResource;
+    readonly plans: PlansResource;
+    readonly tasks: TasksResource;
+    constructor(config: VirtualizorConfig);
+}
+declare function createVirtualizorClient(config: VirtualizorConfig): VirtualizorClient;
+
+export { type AsyncTaskResult, type CloneVPSParams, type CreatePlanParams, type CreateUserParams, type CreateVPSParams, type ListVPSParams, type MigrateVPSParams, type Plan, type RebuildVPSParams, type Task, type User, type VPS, type VirtType, VirtualizorApiError, VirtualizorClient, type VirtualizorConfig, createVirtualizorClient };

package/dist/index.js

@@ -0,0 +1,276 @@
+'use strict';
+
+var http = require('http');
+var https = require('https');
+
+function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
+
+var http__default = /*#__PURE__*/_interopDefault(http);
+var https__default = /*#__PURE__*/_interopDefault(https);
+
+// src/http.ts
+
+// src/auth.ts
+function buildQueryString(params, apiKey, apiPass) {
+  const clean = {};
+  for (const [key, value] of Object.entries(params)) {
+    if (value !== void 0) {
+      clean[key] = value;
+    }
+  }
+  const urlParams = new URLSearchParams();
+  urlParams.set("api", "json");
+  urlParams.set("adminapikey", apiKey);
+  urlParams.set("adminapipass", apiPass);
+  for (const [key, value] of Object.entries(clean)) {
+    urlParams.set(key, String(value));
+  }
+  return `?${urlParams.toString()}`;
+}
+
+// src/http.ts
+var VirtualizorApiError = class extends Error {
+  code;
+  constructor(message, code) {
+    super(message);
+    this.name = "VirtualizorApiError";
+    this.code = code;
+  }
+};
+var HttpClient = class {
+  constructor(config) {
+    this.config = config;
+  }
+  parseResponse(data) {
+    if (data.error && data.error.length > 0) {
+      const first = data.error[0];
+      if (first) {
+        throw new VirtualizorApiError(first.msg, first.code);
+      }
+    }
+    return data;
+  }
+  async request(act, queryParams = {}, bodyParams = {}) {
+    const allQueryParams = { act, ...queryParams };
+    const qs = buildQueryString(allQueryParams, this.config.apiKey, this.config.apiPass);
+    const path = `/index.php${qs}`;
+    const bodyString = Object.entries(bodyParams).filter(([, v]) => v !== void 0).map(([k, v]) => `${encodeURIComponent(k)}=${encodeURIComponent(String(v))}`).join("&");
+    const data = await this.rawRequest(path, bodyString || void 0);
+    return this.parseResponse(data);
+  }
+  rawRequest(path, body) {
+    const transport = this.config.https ? https__default.default : http__default.default;
+    const options = {
+      host: this.config.host,
+      port: this.config.port,
+      path,
+      method: body ? "POST" : "GET",
+      headers: {
+        "Content-Type": "application/x-www-form-urlencoded",
+        ...body ? { "Content-Length": Buffer.byteLength(body) } : {}
+      },
+      ...this.config.https ? { agent: new https__default.default.Agent({ rejectUnauthorized: this.config.rejectUnauthorized }) } : {}
+    };
+    return new Promise((resolve, reject) => {
+      const req = transport.request(options, (res) => {
+        let raw = "";
+        res.on("data", (chunk) => {
+          raw += chunk.toString();
+        });
+        res.on("end", () => {
+          if (res.statusCode === 302 || res.statusCode === 301) {
+            reject(
+              new Error(
+                `Redirect detected (status ${res.statusCode}). Authentication failed. Check your API credentials. Location: ${res.headers.location}`
+              )
+            );
+            return;
+          }
+          try {
+            resolve(JSON.parse(raw));
+          } catch {
+            console.debug("[Virtualizor] Raw response (first 500 chars):", raw.slice(0, 500));
+            reject(new Error(`Failed to parse response: ${raw.slice(0, 200)}`));
+          }
+        });
+      });
+      req.setTimeout(this.config.timeout, () => {
+        req.destroy(new Error(`Request timed out after ${this.config.timeout}ms`));
+      });
+      req.on("error", reject);
+      if (body) {
+        req.write(body);
+      }
+      req.end();
+    });
+  }
+};
+
+// src/resources/plans.ts
+var PlansResource = class {
+  constructor(http2) {
+    this.http = http2;
+  }
+  async list() {
+    const res = await this.http.request("plans", {}, {});
+    return res.plans;
+  }
+  async create(params) {
+    return this.http.request("addplan", {}, params);
+  }
+  async delete(planId) {
+    return this.http.request("plans", {}, { delete: planId });
+  }
+};
+
+// src/resources/tasks.ts
+var TasksResource = class {
+  constructor(http2) {
+    this.http = http2;
+  }
+  async get(taskId) {
+    const res = await this.http.request("tasks", { taskid: taskId }, {});
+    return res.tasks[taskId];
+  }
+  async wait(taskId, options = {}) {
+    const { pollIntervalMs = 2e3, timeoutMs = 12e4 } = options;
+    const deadline = Date.now() + timeoutMs;
+    while (Date.now() < deadline) {
+      const task = await this.get(taskId);
+      if (!task) throw new Error(`Task ${taskId} not found`);
+      if (task.status === "1" || task.status === "done") return task;
+      if (task.status === "error" || task.status === "-1") {
+        throw new Error(`Task ${taskId} failed`);
+      }
+      await new Promise((r) => setTimeout(r, pollIntervalMs));
+    }
+    throw new Error(`Task ${taskId} timed out after ${timeoutMs}ms`);
+  }
+};
+
+// src/resources/users.ts
+var UsersResource = class {
+  constructor(http2) {
+    this.http = http2;
+  }
+  async list() {
+    const res = await this.http.request("users", {}, {});
+    return res.users;
+  }
+  async create(params) {
+    return this.http.request("adduser", {}, params);
+  }
+  async delete(uid) {
+    return this.http.request("users", {}, { delete: uid });
+  }
+  async suspend(uid) {
+    return this.http.request("users", {}, { suspend: uid });
+  }
+  async unsuspend(uid) {
+    return this.http.request("users", {}, { unsuspend: uid });
+  }
+};
+
+// src/resources/vps.ts
+var VpsResource = class {
+  constructor(http2) {
+    this.http = http2;
+  }
+  async list(filters = {}) {
+    const res = await this.http.request("vs", {}, filters);
+    return res.vs ?? {};
+  }
+  async get(vpsId) {
+    const res = await this.http.request("vs", { vpsid: vpsId }, {});
+    const vps = res.vs[vpsId];
+    if (!vps) throw new Error(`VPS ${vpsId} not found in response`);
+    return vps;
+  }
+  async create(params) {
+    return this.http.request("addvs", {}, params);
+  }
+  async delete(vpsId) {
+    return this.http.request("vs", { delete: vpsId }, {});
+  }
+  async start(vpsId) {
+    return this.http.request("vs", { vpsid: vpsId, action: "start" }, {});
+  }
+  async stop(vpsId) {
+    return this.http.request("vs", { vpsid: vpsId, action: "stop" }, {});
+  }
+  async restart(vpsId) {
+    return this.http.request("vs", { vpsid: vpsId, action: "restart" }, {});
+  }
+  async poweroff(vpsId) {
+    return this.http.request("vs", { vpsid: vpsId, action: "poweroff" }, {});
+  }
+  async suspend(vpsId) {
+    return this.http.request("vs", { suspend: vpsId }, {});
+  }
+  async unsuspend(vpsId) {
+    return this.http.request("vs", { unsuspend: vpsId }, {});
+  }
+  async rebuild(vpsId, params) {
+    return this.http.request("rebuild", {}, {
+      vpsid: vpsId,
+      reos: 1,
+      ...params
+    });
+  }
+  async clone(vpsId, params) {
+    return this.http.request("clone", {}, {
+      vpsid: vpsId,
+      ...params
+    });
+  }
+  async migrate(vpsId, params) {
+    return this.http.request("migrate", {}, {
+      vpsid: vpsId,
+      migrate: 1,
+      migrate_but: 1,
+      ...params
+    });
+  }
+  async status(vpsId) {
+    return this.http.request("vstatus", { vpsid: vpsId }, {});
+  }
+  async vnc(vpsId) {
+    return this.http.request("vnc", { vpsid: vpsId }, {});
+  }
+  async stats(vpsId) {
+    return this.http.request("vps_stats", {}, { vpsid: vpsId });
+  }
+};
+
+// src/client.ts
+var VirtualizorClient = class {
+  vps;
+  users;
+  plans;
+  tasks;
+  constructor(config) {
+    const resolved = {
+      host: config.host,
+      apiKey: config.apiKey,
+      apiPass: config.apiPass ?? "",
+      port: config.port ?? 4085,
+      https: config.https ?? true,
+      rejectUnauthorized: config.rejectUnauthorized ?? false,
+      timeout: config.timeout ?? 3e4
+    };
+    const http2 = new HttpClient(resolved);
+    this.vps = new VpsResource(http2);
+    this.users = new UsersResource(http2);
+    this.plans = new PlansResource(http2);
+    this.tasks = new TasksResource(http2);
+  }
+};
+function createVirtualizorClient(config) {
+  return new VirtualizorClient(config);
+}
+
+exports.VirtualizorApiError = VirtualizorApiError;
+exports.VirtualizorClient = VirtualizorClient;
+exports.createVirtualizorClient = createVirtualizorClient;
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map