@nodetool-ai/deploy 0.7.0-rc.11

package/dist/remote-users.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Remote user management for self-hosted deployments.
+ *
+ * This module provides SSH-based user management for Docker and SSH deployments.
+ * Operations are performed remotely via SSH, never transmitting plaintext tokens.
+ */
+import type { DockerDeployment } from "./deployment-config.js";
+export interface UserInfo {
+    user_id: string;
+    username: string;
+    role: "admin" | "user";
+    token_hash: string;
+    created_at: string;
+}
+export interface SSHConnectionHandle {
+    /**
+     * Execute a command on the remote host.
+     * @returns [exitCode, stdout, stderr]
+     */
+    execute(command: string, options?: {
+        check?: boolean;
+    }): Promise<[number, string, string]>;
+}
+/**
+ * Minimal SSH connection wrapper.
+ *
+ * Accepts a connected ssh2 `Client` instance and provides the `execute`
+ * helper needed by `RemoteUserManager`. The client type is kept generic
+ * (duck-typed) so that consumers can pass any ssh2-compatible client
+ * without requiring the `@types/ssh2` package at compile time.
+ */
+export declare class SimpleSSHConnection implements SSHConnectionHandle {
+    private readonly client;
+    constructor(client: SimpleSSHConnection["client"]);
+    execute(command: string, options?: {
+        check?: boolean;
+    }): Promise<[number, string, string]>;
+}
+/**
+ * Manages users on remote deployments via SSH.
+ */
+export declare class RemoteUserManager {
+    private readonly usersFile;
+    private readonly ssh;
+    constructor(deployment: DockerDeployment, usersFile: string, ssh: SSHConnectionHandle);
+    private hashToken;
+    private generateUserId;
+    private loadRemoteUsers;
+    private saveRemoteUsers;
+    /**
+     * Add a user to the remote deployment.
+     *
+     * @param username - Username to add.
+     * @param role - User role ("admin" or "user").
+     * @param token - Plaintext bearer token (generated locally, hashed before storage).
+     */
+    addUser(username: string, role: "admin" | "user", token: string): Promise<void>;
+    /**
+     * Remove a user from the remote deployment.
+     */
+    removeUser(username: string): Promise<void>;
+    /**
+     * Reset a user's token on the remote deployment.
+     *
+     * @param username - Username to reset.
+     * @param newToken - New plaintext token (generated locally).
+     */
+    resetToken(username: string, newToken: string): Promise<void>;
+    /**
+     * List all users from the remote deployment.
+     */
+    listUsers(): Promise<Record<string, UserInfo>>;
+}
+//# sourceMappingURL=remote-users.d.ts.map

package/dist/remote-users.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-users.d.ts","sourceRoot":"","sources":["../src/remote-users.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAUH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAM/D,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,OAAO,GAAG,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAWD,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,OAAO,CACL,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,GAC5B,OAAO,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACtC;AAED;;;;;;;GAOG;AACH,qBAAa,mBAAoB,YAAW,mBAAmB;IAC7D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAQrB;gBAEU,MAAM,EAAE,mBAAmB,CAAC,QAAQ,CAAC;IAI3C,OAAO,CACX,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,GAC5B,OAAO,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;CAuCrC;AAMD;;GAEG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAsB;gBAGxC,UAAU,EAAE,gBAAgB,EAC5B,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,mBAAmB;IAW1B,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,cAAc;YAKR,eAAe;YAqBf,eAAe;IA2B7B;;;;;;OAMG;IACG,OAAO,CACX,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,OAAO,GAAG,MAAM,EACtB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,IAAI,CAAC;IAqBhB;;OAEG;IACG,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAWjD;;;;;OAKG;IACG,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAqBnE;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;CAGrD"}

package/dist/remote-users.js

@@ -0,0 +1,172 @@
+/**
+ * Remote user management for self-hosted deployments.
+ *
+ * This module provides SSH-based user management for Docker and SSH deployments.
+ * Operations are performed remotely via SSH, never transmitting plaintext tokens.
+ */
+import { createHash, randomUUID } from "node:crypto";
+import { posix as posixPath } from "node:path";
+import * as yaml from "js-yaml";
+/** Shell-escape a string for safe interpolation in single-quoted POSIX contexts. */
+function shellQuote(s) {
+    return `'${s.replace(/'/g, "'\\''")}'`;
+}
+/**
+ * Minimal SSH connection wrapper.
+ *
+ * Accepts a connected ssh2 `Client` instance and provides the `execute`
+ * helper needed by `RemoteUserManager`. The client type is kept generic
+ * (duck-typed) so that consumers can pass any ssh2-compatible client
+ * without requiring the `@types/ssh2` package at compile time.
+ */
+export class SimpleSSHConnection {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    async execute(command, options) {
+        const check = options?.check ?? true;
+        return new Promise((resolve, reject) => {
+            this.client.exec(command, (err, stream) => {
+                if (err) {
+                    reject(err);
+                    return;
+                }
+                let stdout = "";
+                let stderr = "";
+                stream.on("data", (data) => {
+                    stdout += data.toString("utf-8");
+                });
+                stream.stderr.on("data", (data) => {
+                    stderr += data.toString("utf-8");
+                });
+                stream.on("close", (code) => {
+                    if (check && code !== 0) {
+                        reject(new Error(`Command failed (exit ${code}): ${command}\nSTDERR: ${stderr}`));
+                        return;
+                    }
+                    resolve([code, stdout, stderr]);
+                });
+            });
+        });
+    }
+}
+// ============================================================================
+// RemoteUserManager
+// ============================================================================
+/**
+ * Manages users on remote deployments via SSH.
+ */
+export class RemoteUserManager {
+    usersFile;
+    ssh;
+    constructor(deployment, usersFile, ssh) {
+        void deployment; // retained for context; SSH handle passed explicitly
+        this.usersFile = usersFile;
+        this.ssh = ssh;
+    }
+    // --------------------------------------------------------------------------
+    // Private helpers
+    // --------------------------------------------------------------------------
+    hashToken(token) {
+        return createHash("sha256").update(token, "utf-8").digest("hex");
+    }
+    generateUserId(username) {
+        const shortId = randomUUID().replace(/-/g, "").slice(0, 8);
+        return `user_${username}_${shortId}`;
+    }
+    async loadRemoteUsers() {
+        try {
+            const [exitCode, stdout] = await this.ssh.execute(`cat ${shellQuote(this.usersFile)} 2>/dev/null || echo '{}'`, { check: false });
+            if (exitCode !== 0) {
+                return {};
+            }
+            const data = yaml.load(stdout, {
+                schema: yaml.JSON_SCHEMA
+            });
+            return data?.users ?? {};
+        }
+        catch (e) {
+            console.warn(`Warning: Could not load remote users: ${e}`);
+            return {};
+        }
+    }
+    async saveRemoteUsers(users) {
+        // Ensure directory exists
+        const usersDir = posixPath.dirname(this.usersFile);
+        await this.ssh.execute(`mkdir -p ${shellQuote(usersDir)}`);
+        // Prepare file content
+        const content = yaml.dump({ users, version: "1.0" }, { flowLevel: -1 });
+        // Write via SSH using base64 to avoid escaping issues
+        const b64Content = Buffer.from(content, "utf-8").toString("base64");
+        await this.ssh.execute(`echo ${b64Content} | base64 -d > ${shellQuote(this.usersFile)}`);
+        // Set restrictive permissions
+        await this.ssh.execute(`chmod 0600 ${shellQuote(this.usersFile)}`);
+    }
+    // --------------------------------------------------------------------------
+    // Public API
+    // --------------------------------------------------------------------------
+    /**
+     * Add a user to the remote deployment.
+     *
+     * @param username - Username to add.
+     * @param role - User role ("admin" or "user").
+     * @param token - Plaintext bearer token (generated locally, hashed before storage).
+     */
+    async addUser(username, role, token) {
+        const users = await this.loadRemoteUsers();
+        if (username in users) {
+            throw new Error(`User '${username}' already exists on remote`);
+        }
+        const userId = this.generateUserId(username);
+        const createdAt = new Date().toISOString();
+        users[username] = {
+            user_id: userId,
+            username,
+            role,
+            token_hash: this.hashToken(token),
+            created_at: createdAt
+        };
+        await this.saveRemoteUsers(users);
+    }
+    /**
+     * Remove a user from the remote deployment.
+     */
+    async removeUser(username) {
+        const users = await this.loadRemoteUsers();
+        if (!(username in users)) {
+            throw new Error(`User '${username}' not found on remote`);
+        }
+        delete users[username];
+        await this.saveRemoteUsers(users);
+    }
+    /**
+     * Reset a user's token on the remote deployment.
+     *
+     * @param username - Username to reset.
+     * @param newToken - New plaintext token (generated locally).
+     */
+    async resetToken(username, newToken) {
+        const users = await this.loadRemoteUsers();
+        if (!(username in users)) {
+            throw new Error(`User '${username}' not found on remote`);
+        }
+        const existingUser = users[username];
+        const createdAt = new Date().toISOString();
+        users[username] = {
+            user_id: existingUser.user_id,
+            username,
+            role: existingUser.role,
+            token_hash: this.hashToken(newToken),
+            created_at: createdAt
+        };
+        await this.saveRemoteUsers(users);
+    }
+    /**
+     * List all users from the remote deployment.
+     */
+    async listUsers() {
+        return this.loadRemoteUsers();
+    }
+}
+//# sourceMappingURL=remote-users.js.map

package/dist/remote-users.js.map

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

package/dist/runpod-api.d.ts

@@ -0,0 +1,206 @@
+/**
+ * RunPod API Module
+ *
+ * Provides a clean interface to RunPod's REST and GraphQL APIs for managing
+ * templates and endpoints. Handles authentication, request/response processing,
+ * and error handling for all RunPod operations.
+ *
+ * Key Features:
+ * - Template management (create, update, delete, get)
+ * - Endpoint management (create, update, delete)
+ * - Network volume management
+ * - GraphQL query support
+ * - Proper error handling and logging
+ */
+/** GPU types available in RunPod using their official GPU ID codes. */
+export declare enum GPUType {
+    ADA_24 = "ADA_24",
+    ADA_32_PRO = "ADA_32_PRO",
+    ADA_48_PRO = "ADA_48_PRO",
+    ADA_80_PRO = "ADA_80_PRO",
+    AMPERE_16 = "AMPERE_16",
+    AMPERE_24 = "AMPERE_24",
+    AMPERE_48 = "AMPERE_48",
+    AMPERE_80 = "AMPERE_80",
+    HOPPER_141 = "HOPPER_141"
+}
+/** Compute types for RunPod endpoints. */
+export declare enum ComputeType {
+    CPU = "CPU",
+    GPU = "GPU"
+}
+/** CPU flavor IDs for RunPod endpoints. */
+export declare enum CPUFlavor {
+    CPU_3C = "cpu3c",
+    CPU_3G = "cpu3g",
+    CPU_5C = "cpu5c",
+    CPU_5G = "cpu5g"
+}
+/** Data center locations for RunPod endpoints. */
+export declare enum DataCenter {
+    US_CALIFORNIA_2 = "US-CA-2",
+    US_DELAWARE_1 = "US-DE-1",
+    US_GEORGIA_1 = "US-GA-1",
+    US_GEORGIA_2 = "US-GA-2",
+    US_ILLINOIS_1 = "US-IL-1",
+    US_KANSAS_2 = "US-KS-2",
+    US_KANSAS_3 = "US-KS-3",
+    US_NORTH_CAROLINA_1 = "US-NC-1",
+    US_TEXAS_1 = "US-TX-1",
+    US_TEXAS_3 = "US-TX-3",
+    US_TEXAS_4 = "US-TX-4",
+    US_WASHINGTON_1 = "US-WA-1",
+    CA_MONTREAL_1 = "CA-MTL-1",
+    CA_MONTREAL_2 = "CA-MTL-2",
+    CA_MONTREAL_3 = "CA-MTL-3",
+    EU_CZECH_REPUBLIC_1 = "EU-CZ-1",
+    EU_FRANCE_1 = "EU-FR-1",
+    EU_NETHERLANDS_1 = "EU-NL-1",
+    EU_ROMANIA_1 = "EU-RO-1",
+    EU_SWEDEN_1 = "EU-SE-1",
+    EUR_ICELAND_1 = "EUR-IS-1",
+    EUR_ICELAND_2 = "EUR-IS-2",
+    EUR_ICELAND_3 = "EUR-IS-3",
+    EUR_NORWAY_1 = "EUR-NO-1",
+    AP_JAPAN_1 = "AP-JP-1",
+    OC_AUSTRALIA_1 = "OC-AU-1"
+}
+/** CUDA versions available in RunPod. */
+export declare enum CUDAVersion {
+    CUDA_11_8 = "11.8",
+    CUDA_12_0 = "12.0",
+    CUDA_12_1 = "12.1",
+    CUDA_12_2 = "12.2",
+    CUDA_12_3 = "12.3",
+    CUDA_12_4 = "12.4",
+    CUDA_12_5 = "12.5",
+    CUDA_12_6 = "12.6",
+    CUDA_12_7 = "12.7",
+    CUDA_12_8 = "12.8"
+}
+/** Return all values of a string enum. */
+export declare function enumValues<T extends Record<string, string>>(e: T): string[];
+/** Print available options for an enum. */
+export declare function printEnumOptions<T extends Record<string, string>>(enumObj: T, title: string): void;
+export interface GraphQLResponse {
+    data?: Record<string, unknown>;
+    errors?: Array<{
+        message: string;
+    }>;
+}
+/**
+ * Run a GraphQL query against the RunPod API.
+ */
+export declare function runGraphqlQuery(query: string): Promise<Record<string, unknown>>;
+export type HttpMethod = "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
+/**
+ * Make a REST API call to RunPod.
+ *
+ * @param endpoint - The API endpoint (e.g., "endpoints", "templates")
+ * @param method   - HTTP method
+ * @param data     - Request body for POST/PUT/PATCH
+ * @returns API response data, or empty object for DELETE 204 responses
+ */
+export declare function makeRunpodApiCall(endpoint: string, method?: HttpMethod, data?: Record<string, unknown>): Promise<Record<string, unknown>>;
+/**
+ * Create a new network volume.
+ */
+export declare function createNetworkVolume(name: string, size: number, dataCenterId: string): Promise<Record<string, unknown>>;
+/**
+ * List all network volumes.
+ */
+export declare function listNetworkVolumes(): Promise<Record<string, unknown>>;
+/**
+ * Get details of a specific network volume.
+ */
+export declare function getNetworkVolume(volumeId: string): Promise<Record<string, unknown>>;
+/**
+ * Update a network volume.
+ */
+export declare function updateNetworkVolume(volumeId: string, name?: string, size?: number): Promise<Record<string, unknown>>;
+/**
+ * Get a RunPod template by name.
+ */
+export declare function getRunpodTemplateByName(templateName: string): Promise<Record<string, unknown> | null>;
+/**
+ * Delete a RunPod template by name.
+ */
+export declare function deleteRunpodTemplateByName(templateName: string): Promise<boolean>;
+/**
+ * Update an existing RunPod template with a new Docker image.
+ */
+export declare function updateRunpodTemplate(templateData: Record<string, unknown>, imageName: string, tag: string): Promise<boolean>;
+/**
+ * Create or update a RunPod template with the latest Docker image.
+ *
+ * Checks if a template with the given name exists:
+ * - If it exists, updates it with the new Docker image
+ * - If it doesn't exist, creates a new template
+ *
+ * @returns The template ID
+ */
+export declare function createOrUpdateRunpodTemplate(templateName: string, imageName: string, tag: string, env?: Record<string, string>): Promise<string>;
+/**
+ * Get a RunPod endpoint by name.
+ */
+export declare function getRunpodEndpointByName(endpointName: string, quiet?: boolean): Promise<Record<string, unknown> | null>;
+/**
+ * Update an existing RunPod endpoint with a new template.
+ */
+export declare function updateRunpodEndpoint(endpointId: string, templateId: string, extra?: Record<string, unknown>): Promise<boolean>;
+/**
+ * Delete a RunPod endpoint by name.
+ */
+export declare function deleteRunpodEndpointByName(endpointName: string): Promise<boolean>;
+export interface CreateOrUpdateEndpointOptions {
+    templateId: string;
+    name: string;
+    computeType?: string;
+    gpuTypeIds?: string[];
+    gpuCount?: number;
+    cpuFlavorIds?: string[];
+    vcpuCount?: number;
+    dataCenterIds?: string[];
+    workersMin?: number;
+    workersMax?: number;
+    idleTimeout?: number;
+    executionTimeoutMs?: number;
+    flashboot?: boolean;
+    networkVolumeId?: string;
+    allowedCudaVersions?: string[];
+}
+/**
+ * Create or update a RunPod serverless endpoint using the REST API.
+ *
+ * If an endpoint with the same name already exists, it will be updated
+ * with the new template. Otherwise a new endpoint is created.
+ *
+ * @returns The endpoint ID
+ */
+export declare function createOrUpdateRunpodEndpoint(opts: CreateOrUpdateEndpointOptions): Promise<string>;
+export interface CreateEndpointGraphQLOptions {
+    templateId: string;
+    name: string;
+    computeType?: string;
+    gpuTypeIds?: string[];
+    gpuCount?: number;
+    cpuFlavorIds?: string[];
+    vcpuCount?: number;
+    dataCenterIds?: string[];
+    workersMin?: number;
+    workersMax?: number;
+    idleTimeout?: number;
+    executionTimeoutMs?: number;
+    flashboot?: boolean;
+    networkVolumeId?: string;
+    allowedCudaVersions?: string[];
+}
+/**
+ * Create a RunPod serverless endpoint using raw GraphQL queries.
+ *
+ * If an endpoint with the same name already exists, it will be deleted first.
+ *
+ * @returns The endpoint ID
+ */
+export declare function createRunpodEndpointGraphql(opts: CreateEndpointGraphQLOptions): Promise<string>;
+//# sourceMappingURL=runpod-api.d.ts.map

package/dist/runpod-api.d.ts.map

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