vpsgui 1.2.0

package/dist/config.js

@@ -0,0 +1,164 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CONFIG_VERSION = void 0;
+exports.configDir = configDir;
+exports.configPath = configPath;
+exports.readConfig = readConfig;
+exports.writeConfig = writeConfig;
+exports.resolveProfileName = resolveProfileName;
+exports.loadCredentials = loadCredentials;
+exports.normaliseUrl = normaliseUrl;
+const fs_1 = require("fs");
+const os = __importStar(require("os"));
+const path = __importStar(require("path"));
+/**
+ * On-disk credentials for the CLI.
+ *
+ * The format is shared verbatim with the Python SDK, because `npm i -g vpsgui`
+ * and `pip install vpsgui` both put a `vpsgui` executable on PATH and only one
+ * of them can win. Sharing the file means it does not matter which one does:
+ * whichever binary runs, `vpsgui login` and every other command see the same
+ * profiles. Any change here has to land in sdk/python/vpsgui/config.py too.
+ */
+exports.CONFIG_VERSION = 1;
+function configDir() {
+    // VPSGUI_CONFIG_DIR exists so CI and tests never touch a real operator's
+    // credentials.
+    return process.env.VPSGUI_CONFIG_DIR || path.join(os.homedir(), '.vpsgui');
+}
+function configPath() {
+    return path.join(configDir(), 'config.json');
+}
+function empty() {
+    return { version: exports.CONFIG_VERSION, current: 'default', profiles: {} };
+}
+async function readConfig() {
+    let raw;
+    try {
+        raw = await fs_1.promises.readFile(configPath(), 'utf8');
+    }
+    catch (e) {
+        // A missing file is the normal state before the first login.
+        if (e.code === 'ENOENT')
+            return empty();
+        throw e;
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        throw new Error(`${configPath()} is not valid JSON. Fix or delete it, then run: vpsgui login`);
+    }
+    const cfg = parsed;
+    return {
+        version: typeof cfg.version === 'number' ? cfg.version : exports.CONFIG_VERSION,
+        current: typeof cfg.current === 'string' ? cfg.current : 'default',
+        profiles: cfg.profiles && typeof cfg.profiles === 'object' ? cfg.profiles : {},
+    };
+}
+/**
+ * Write the config with owner-only permissions.
+ *
+ * The mode is set on the temp file before any token reaches the disk; creating
+ * it 0644 and chmod-ing afterwards would leave a window where any local user
+ * could read the token.
+ */
+async function writeConfig(config) {
+    const dir = configDir();
+    await fs_1.promises.mkdir(dir, { recursive: true, mode: 0o700 });
+    const tmp = path.join(dir, `.config.json.${process.pid}.tmp`);
+    await fs_1.promises.writeFile(tmp, JSON.stringify(config, null, 2) + '\n', { mode: 0o600 });
+    await fs_1.promises.rename(tmp, configPath());
+    // rename preserves the temp file's mode, but an existing config.json created
+    // by an older version may still be 0644.
+    try {
+        await fs_1.promises.chmod(configPath(), 0o600);
+    }
+    catch {
+        // Windows and some network filesystems do not implement POSIX modes.
+    }
+}
+/**
+ * The profile to use, honouring `--profile`, then VPSGUI_PROFILE, then the
+ * `current` recorded at the last login.
+ */
+function resolveProfileName(config, explicit) {
+    return explicit || process.env.VPSGUI_PROFILE || config.current || 'default';
+}
+/**
+ * Credentials for a command, or null when there is no usable source.
+ *
+ * The environment wins over the config file so CI can run without a login step,
+ * and so an operator can override a saved profile for one command.
+ */
+async function loadCredentials(explicitProfile) {
+    const envUrl = process.env.VPSGUI_API_URL;
+    const envToken = process.env.VPSGUI_AGENT_TOKEN;
+    if (envUrl && envToken) {
+        return { url: envUrl, token: envToken, source: 'environment' };
+    }
+    const config = await readConfig();
+    const name = resolveProfileName(config, explicitProfile);
+    const profile = config.profiles[name];
+    if (!profile || !profile.url || !profile.token)
+        return null;
+    return { url: profile.url, token: profile.token, source: `profile "${name}"` };
+}
+/**
+ * Turn what an operator types into an API root.
+ *
+ * People paste the address bar - "vps.example.com", "http://1.2.3.4:46509",
+ * "https://host/api/v1/" - and every one of those should work rather than
+ * producing a 404 they have to debug.
+ */
+function normaliseUrl(input) {
+    let url = input.trim();
+    if (!url)
+        throw new Error('Enter the agent URL.');
+    if (!/^https?:\/\//i.test(url)) {
+        // Bare IPs and localhost are almost always a plain-HTTP agent on the LAN;
+        // a hostname typed without a scheme is almost always a public HTTPS one.
+        const host = url.split('/')[0].split(':')[0];
+        const isLocal = host === 'localhost' || host === '127.0.0.1' || /^\d+\.\d+\.\d+\.\d+$/.test(host);
+        url = (isLocal ? 'http://' : 'https://') + url;
+    }
+    url = url.replace(/\/+$/, '');
+    if (!/\/api\/v1$/.test(url))
+        url += '/api/v1';
+    return url;
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { VpsguiClient, VpsguiError } from './client';
+export type { VpsguiClientConfig, AgentInfo, CommandResult, MutationResult, TelemetryPoint, ProcessItem, NodeSpec, TopologyLayer, HealthCheck, ContainerItem, DockerImageItem, FileItem, FileReadResult, FirewallRule, FirewallRuleInput, SecretItem, AuditLogEvent, SystemUser, NetworkInterfaceInfo, IpInfoResult, StoragePartition, BackupItem, Deployment, DatabaseInstance, ProxyRule, CatalogItem, AutomationWorkflow, QueueJob, PackagesResult, } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACrD,YAAY,EACV,kBAAkB,EAClB,SAAS,EACT,aAAa,EACb,cAAc,EACd,cAAc,EACd,WAAW,EACX,QAAQ,EACR,aAAa,EACb,WAAW,EACX,aAAa,EACb,eAAe,EACf,QAAQ,EACR,cAAc,EACd,YAAY,EACZ,iBAAiB,EACjB,UAAU,EACV,aAAa,EACb,UAAU,EACV,oBAAoB,EACpB,YAAY,EACZ,gBAAgB,EAChB,UAAU,EACV,UAAU,EACV,gBAAgB,EAChB,SAAS,EACT,WAAW,EACX,kBAAkB,EAClB,QAAQ,EACR,cAAc,GACf,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VpsguiError = exports.VpsguiClient = void 0;
+var client_1 = require("./client");
+Object.defineProperty(exports, "VpsguiClient", { enumerable: true, get: function () { return client_1.VpsguiClient; } });
+Object.defineProperty(exports, "VpsguiError", { enumerable: true, get: function () { return client_1.VpsguiError; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,mCAAqD;AAA5C,sGAAA,YAAY,OAAA;AAAE,qGAAA,WAAW,OAAA"}

package/dist/types.d.ts

@@ -0,0 +1,391 @@
+/**
+ * Types for the VPSGUI agent REST API.
+ *
+ * These mirror what the agent actually returns. Fields the agent cannot determine are `null` rather
+ * than absent or invented - for example `smartHealth` (needs smartctl), per-process `cpuPercent` on
+ * Windows, and `city`/`region` from ipinfo's country-level /lite tier.
+ */
+export interface VpsguiClientConfig {
+    /** e.g. `https://vps.example.com/api/v1` */
+    baseUrl: string;
+    /** Agent token. Required for every endpoint except `health()`. */
+    token?: string;
+    /** Default per-request timeout in ms (default 15000). */
+    timeout?: number;
+}
+export interface AgentInfo {
+    version: string;
+    shellEnabled: boolean;
+    fileRoots: string[];
+    platform: string;
+    unimplementedFeatures: string[];
+    /** Whether an ipinfo.io token is configured. Never the token itself. */
+    ipinfoConfigured?: boolean;
+}
+/** Result of a command the agent ran. `success` is false when the command exited non-zero. */
+export interface CommandResult {
+    success: boolean;
+    output: string;
+    action?: string;
+}
+export interface MutationResult {
+    success: boolean;
+    path?: string;
+    error?: string;
+}
+export interface TelemetryPoint {
+    timestamp: string;
+    cpuPercent: number;
+    ramPercent: number;
+    swapPercent: number;
+    diskPercent: number;
+    netRxKbps: number;
+    netTxKbps: number;
+    iowaitPercent: number;
+    /** null when the host exposes no thermal zone. */
+    tempC: number | null;
+    powerWatts: number | null;
+    cpuCores: number;
+    cpuModel: string;
+    memoryTotalBytes: number;
+    memoryUsedBytes: number;
+    memoryFreeBytes: number;
+    swapTotalBytes: number;
+    diskTotalBytes: number;
+    diskUsedBytes: number;
+    loadAverage: number[];
+    uptimeSeconds: number;
+    osName: string;
+    osPlatform: string;
+    osArch: string;
+    hostname: string;
+}
+export interface ProcessItem {
+    pid: number;
+    user: string;
+    /** null on Windows - tasklist reports no per-process CPU. */
+    cpuPercent: number | null;
+    memoryPercent: number;
+    memoryMb: number;
+    command: string;
+    threads: number | null;
+    state: string;
+}
+export interface NodeSpec {
+    id: string;
+    name: string;
+    status: string;
+    agentStatus: string;
+    agentVersion: string;
+    location: {
+        city: string | null;
+        country: string | null;
+        countryCode: string | null;
+        flagIcon: string;
+        provider: string | null;
+    };
+    hardware: {
+        cpuCores: number;
+        cpuModel: string;
+        ramGb: number;
+        swapGb: number;
+        diskGb: number;
+        diskType: string | null;
+        architecture: string;
+    };
+    os: {
+        name: string;
+        family: string;
+        version: string;
+        kernel: string;
+        uptimeSeconds: number;
+    };
+    network: {
+        ipAddress: string;
+        /** null - the agent cannot know its own NAT address; resolve it client-side. */
+        publicIp: string | null;
+        hostname: string;
+        sshPort: number;
+    };
+    tags: string[];
+    isFavorite: boolean;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface TopologyLayer {
+    level: string;
+    items: Array<{
+        id: string;
+        title: string;
+        type: string;
+        status: string;
+        desc: string;
+    }>;
+}
+export interface HealthCheck {
+    id: string;
+    category: string;
+    name: string;
+    target: string;
+    status: 'green' | 'yellow' | 'red';
+    latencyMs: number;
+    message: string;
+    lastCheck: string;
+}
+export interface ContainerItem {
+    id: string;
+    name: string;
+    image: string;
+    state: string;
+    status: string;
+    ports: Array<{
+        publicPort: number;
+        privatePort: number;
+        type: string;
+    }>;
+    cpuPercent: number;
+    memoryUsageMb: number;
+    created: string | null;
+}
+export interface DockerImageItem {
+    id: string;
+    repository: string;
+    tag: string;
+    size: string;
+    sizeMb: number;
+    digest: string | null;
+    created: string | null;
+}
+export interface FileItem {
+    name: string;
+    path: string;
+    type: 'file' | 'directory' | 'symlink';
+    isDirectory: boolean;
+    size: number;
+    sizeBytes: number;
+    permissions: string;
+    owner: string;
+    group: string;
+    extension?: string;
+    modifiedAt: string | null;
+    /** False when the agent's credential deny list blocks this path. */
+    readable: boolean;
+}
+export interface FileReadResult {
+    path: string;
+    content: string;
+    /** True when the file exceeded the read cap; saving it back would truncate the original. */
+    truncated: boolean;
+    sizeBytes: number;
+    editable: boolean;
+}
+export interface FirewallRule {
+    id: string;
+    nodeId: string;
+    action: 'allow' | 'deny' | 'reject' | 'limit';
+    direction: 'inbound' | 'outbound';
+    protocol: string;
+    port: string;
+    sourceIp: string;
+    comment: string;
+    status: 'active' | 'disabled';
+}
+export interface FirewallRuleInput {
+    action: 'allow' | 'deny' | 'reject' | 'limit' | 'delete';
+    /** A single port, an inclusive range (`6000:6010`), or a comma list (`80,443`). */
+    port?: string;
+    protocol?: 'tcp' | 'udp' | 'any';
+    source?: string;
+    /** Required for `delete` - ufw removes rules by their number in `ufw status numbered`. */
+    ruleNumber?: number;
+}
+export interface SecretItem {
+    id: string;
+    name: string;
+    type: string;
+    environment: string;
+    /** Always a fixed mask; the list endpoint never returns values. */
+    maskedValue: string;
+    updatedBy: string;
+    updatedAt?: string;
+}
+export interface AuditLogEvent {
+    id: string;
+    timestamp: string;
+    actor: {
+        name: string;
+        email: string;
+        avatarUrl: string;
+    };
+    action: string;
+    category: string;
+    target: string;
+    ipAddress: string;
+    status: 'success' | 'warning' | 'failure';
+    details?: string;
+}
+export interface SystemUser {
+    id: string;
+    username: string;
+    uid: number;
+    gid: number;
+    fullName: string;
+    home: string;
+    shell: string;
+    /** UID below 1000 and not root - a service account rather than a person. */
+    isSystem: boolean;
+    canLogin: boolean;
+    groups: string[];
+    lastLogin: string | null;
+}
+export interface NetworkInterfaceInfo {
+    name: string;
+    mac: string;
+    ipv4: string;
+    ipv6: string;
+    type: 'ethernet' | 'wireless' | 'virtual' | 'loopback';
+    rxBytes: number;
+    txBytes: number;
+    rxSpeedMbps: number;
+    txSpeedMbps: number;
+    status: 'up' | 'down';
+}
+export interface IpInfoResult {
+    ip: string | null;
+    /** null only when the provider genuinely reported nothing (e.g. a bogon address). */
+    city: string | null;
+    region: string | null;
+    /** Display name, resolved from the two-letter code ipinfo returns. */
+    country: string | null;
+    countryCode: string | null;
+    continent?: string | null;
+    /** Operator name, split out of ipinfo's combined "AS15169 Google LLC" field. */
+    org: string | null;
+    asn: string | null;
+    latitude?: number | null;
+    longitude?: number | null;
+    timezone?: string | null;
+    postal?: string | null;
+    /** Reverse DNS, when the provider reports it. */
+    hostname?: string | null;
+    /** Which provider answered, or null when none did. */
+    source: string | null;
+}
+export interface StoragePartition {
+    device: string;
+    mountPoint: string;
+    fsType: string;
+    totalGb: number;
+    usedGb: number;
+    freeGb: number;
+    totalBytes: number;
+    usedBytes: number;
+    freeBytes: number;
+    usagePercent: number;
+    /** null - SMART needs smartctl and raw device access, which the agent does not use. */
+    smartHealth: 'passed' | 'warning' | 'failing' | null;
+}
+export interface BackupItem {
+    id: string;
+    name: string;
+    path: string;
+    sizeBytes: number;
+    size: string;
+    target: string;
+    date: string;
+    status: string;
+}
+export interface Deployment {
+    id: string;
+    path: string;
+    app: string;
+    branch: string;
+    commit: string;
+    message: string;
+    committedAt: string | null;
+    remote: string;
+    dirtyCount: number;
+    ahead: number;
+    behind: number;
+    status: 'clean' | 'modified' | 'behind';
+}
+export interface DatabaseInstance {
+    name: string;
+    engine: string;
+    port: number;
+    /** null - reporting these would require credentials the agent does not hold. */
+    size: string | null;
+    tables: number | null;
+    keys: number | null;
+    status: string;
+}
+export interface ProxyRule {
+    id: string;
+    domain: string;
+    upstream: string;
+    ssl: string;
+    /** Certificate notAfter as ISO-8601, or '' when the vhost has no certificate. */
+    expires: string;
+    status: string;
+}
+export interface CatalogItem {
+    id: string;
+    name: string;
+    category: string;
+    version: string;
+    description: string;
+    iconName: string;
+    publisher: string;
+    official: boolean;
+    /** null - the agent queries no registry, so popularity metrics are not available. */
+    downloadsCount: number | null;
+    rating: number | null;
+    tags: string[];
+    image?: string;
+    /** Ready-to-run command for catalog entries that are not a single container. */
+    installCommand?: string;
+    defaultPorts?: number[];
+    defaultEnv?: Record<string, string>;
+}
+export interface AutomationWorkflow {
+    id: string;
+    name: string;
+    description: string;
+    status: string;
+    triggerType: string;
+    schedule?: string;
+    stepsCount: number;
+    /** The full cron command, suitable for running on demand. */
+    command?: string;
+    source?: string;
+    steps: unknown[];
+}
+export interface QueueJob {
+    id: string;
+    title: string;
+    nodeName: string;
+    type: string;
+    status: string;
+    progressPercent: number;
+    startedAt: string;
+    logs?: string[];
+}
+export interface PackagesResult {
+    packages: Array<{
+        name: string;
+        category: string;
+        installed: boolean;
+        /** null when the binary is present but reported no parseable version. */
+        version: string | null;
+        description: string;
+    }>;
+    languages: Array<{
+        name: string;
+        category: string;
+        installed: boolean;
+        version: string | null;
+        binary: string;
+        description: string;
+    }>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,10 @@
+"use strict";
+/**
+ * Types for the VPSGUI agent REST API.
+ *
+ * These mirror what the agent actually returns. Fields the agent cannot determine are `null` rather
+ * than absent or invented - for example `smartHealth` (needs smartctl), per-process `cpuPercent` on
+ * Windows, and `city`/`region` from ipinfo's country-level /lite tier.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG"}

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "vpsgui",
+  "version": "1.2.0",
+  "description": "Official CLI and Node.js/TypeScript SDK for the VPSGUI agent - sign in to a host, read telemetry, run commands, and drive Docker, files, firewall, secrets and backups.",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {},
+  "scripts": {
+    "build": "tsc && node -e \"require('fs').chmodSync('dist/cli.js', 0o755)\"",
+    "prepublishOnly": "npm run build",
+    "publish:npm": "npm publish --registry=https://registry.npmjs.org --access public",
+    "publish:github": "npm publish"
+  },
+  "keywords": [
+    "vpsgui",
+    "vps",
+    "server",
+    "infrastructure",
+    "docker",
+    "linux",
+    "monitoring",
+    "telemetry",
+    "devops",
+    "sdk",
+    "api-client",
+    "cli",
+    "command-line",
+    "terminal",
+    "ssh"
+  ],
+  "author": "NotGamerPratham <https://notgamerpratham.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/NotGamerPratham/vpsgui.git",
+    "directory": "sdk/node"
+  },
+  "homepage": "https://github.com/NotGamerPratham/vpsgui",
+  "bugs": {
+    "url": "https://github.com/NotGamerPratham/vpsgui/issues"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.19.0",
+    "typescript": "^5.5.0"
+  },
+  "bin": {
+    "vpsgui": "./dist/cli.js"
+  }
+}