System API Complete Reference

interface SystemInfo {
    hostname: string;
    os_name: string;
    os_version: string;
    os_edition: string;
    kernel_version: string;
    architecture: string;
    cpu_count: number;
    cpu_brand: string;
    cpu_vendor: string;
    cpu_frequency: number;
    total_memory: number;
    used_memory: number;
    available_memory: number;
    total_swap: number;
    used_swap: number;
    uptime: number;
    boot_time: number;
    load_average: LoadAverage;
}

interface ProcessInfo {
    pid: number;
    name: string;
    exe?: string;
    cmd: string[];
    cpu_usage: number;
    memory: number;
    virtual_memory: number;
    status: string;
    start_time: number;
    run_time: number;
    parent_pid?: number;
    user_id?: string;
    disk_read: number;
    disk_write: number;
}

interface NetworkStats {
    total_received: number;
    total_transmitted: number;
    download_speed: number;
    upload_speed: number;
    interfaces: NetworkInterface[];
}

interface NetworkInterface {
    name: string;
    received: number;
    transmitted: number;
    packets_received: number;
    packets_transmitted: number;
    errors_received: number;
    errors_transmitted: number;
    mac_address: string;
    ip_addresses: string[];
}

interface DiskInfo {
    name: string;
    mount_point: string;
    file_system: string;
    total_space: number;
    available_space: number;
    used_space: number;
    usage_percent: number;
    is_removable: boolean;
    disk_type: string;
}

__sys__.$resolve("./config.json"); // "/project/config.json"
__sys__.$join("src", "utils", "file.ts"); // "src/utils/file.ts"
__sys__.$dirname("/path/to/file.txt"); // "/path/to"
__sys__.$basename("/path/to/file.txt"); // "file.txt"
__sys__.$extname("file.txt"); // ".txt"

// Read operations
const text = __sys__.$read("config.txt");
const json = __sys__.$readJson("data.json");
const lines = __sys__.$readLines("log.txt");

// Write operations
__sys__.$write("output.txt", "Hello World");
__sys__.$writeJson("data.json", { key: "value" });
__sys__.$appendLine("log.txt", "New entry");

__sys__.$mkdir("new/nested/directory");
const files = __sys__.$ls("src");
const dirs = __sys__.$lsDirs("src");
const allFiles = __sys__.$lsRecursive("src");

interface FileStats {
    size: number;
    is_file: boolean;
    is_dir: boolean;
    is_symlink: boolean;
    modified: number;
    created: number;
    accessed: number;
    readonly: boolean;
    permissions: number;
}

if (__sys__.$exists("file.txt")) {
    const stats = __sys__.$stats("file.txt");
    const size = __sys__.$sizeHuman("file.txt");
    const modified = __sys__.$modifiedAt("file.txt");
}

interface SearchMatch {
    file: string;
    line: number;
    content: string;
}

// Find TypeScript files
const tsFiles = __sys__.$findByExt("src", "ts");

// Find files matching pattern
const configs = __sys__.$find(".", ".*\\.config\\..*");

// Search for text in files
const matches = __sys__.$grep("src", "TODO");
matches.forEach((m) => {
    console.log(`${m.file}:${m.line}: ${m.content}`);
});

// File operations
__sys__.$copy("source.txt", "backup.txt");
__sys__.$move("old.txt", "new.txt");
__sys__.$rm("temp.txt");

// Validation
const hash = __sys__.$hash("file.txt");
const valid = __sys__.$verify("file.txt", hash);

// Comparison
if (__sys__.$isNewer("file1.txt", "file2.txt")) {
    console.log("file1.txt is newer");
}

// Permissions (Unix only)
__sys__.$chmod("script.sh", "755");

import type {
    SystemInfo,
    CpuInfo,
    CpuUsage,
    MemoryInfo,
    DiskInfo,
    NetworkStats,
    NetworkInterface,
    ProcessInfo,
    ProcessStats,
    FileStats,
    SearchMatch,
    PathCheck,
} from "xypriss";

import { XyPrissError } from "xypriss";

try {
    const content = __sys__.$read("file.txt");
} catch (error) {
    if (error instanceof XyPrissError) {
        console.error(`Operation failed: ${error.message}`);
    }
}

// This blocks until complete
const files = __sys__.$lsRecursive("large-directory");

// For large operations, consider running in worker threads

// Cache system info (changes rarely)
const systemInfo = __sys__.$info();

// Cache file lists (update periodically)
const fileCache = new Map<string, string[]>();