@fly/sprites/dist/sprite.js

JavaScript/TypeScript SDK for Sprites - remote command execution

/**
 * Sprite class representing a sprite instance
 */
import { spawn, exec, execFile } from './exec.js';
/**
 * Represents a sprite instance
 */
export class Sprite {
    // Core properties
    name;
    client;
    // Additional properties from API
    id;
    organizationName;
    status;
    config;
    environment;
    createdAt;
    updatedAt;
    bucketName;
    primaryRegion;
    constructor(name, client) {
        this.name = name;
        this.client = client;
    }
    /**
     * Spawn a command on the sprite (event-based API, most Node.js-like)
     */
    spawn(command, args = [], options = {}) {
        return spawn(this, command, args, options);
    }
    /**
     * Execute a command and return a promise with the output
     */
    async exec(command, options = {}) {
        return exec(this, command, options);
    }
    /**
     * Execute a file with arguments and return a promise with the output
     */
    async execFile(file, args = [], options = {}) {
        return execFile(this, file, args, options);
    }
    /**
     * Create a detachable tmux session
     */
    createSession(command, args = [], options = {}) {
        return spawn(this, command, args, {
            ...options,
            detachable: true,
            tty: true,
        });
    }
    /**
     * Attach to an existing session
     */
    attachSession(sessionId, options = {}) {
        return spawn(this, 'tmux', ['attach', '-t', sessionId], {
            ...options,
            sessionId,
            tty: true,
        });
    }
    /**
     * List active sessions
     */
    async listSessions() {
        const response = await fetch(`${this.client.baseURL}/v1/sprites/${this.name}/exec`, {
            method: 'GET',
            headers: {
                'Authorization': `Bearer ${this.client.token}`,
            },
            signal: AbortSignal.timeout(30000),
        });
        if (!response.ok) {
            const body = await response.text();
            throw new Error(`Failed to list sessions (status ${response.status}): ${body}`);
        }
        const result = await response.json();
        const sessions = [];
        if (result.sessions && Array.isArray(result.sessions)) {
            for (const s of result.sessions) {
                const session = {
                    id: s.id,
                    command: s.command,
                    created: new Date(s.created),
                    bytesPerSecond: s.bytes_per_second || 0,
                    isActive: s.is_active || false,
                };
                if (s.last_activity) {
                    session.lastActivity = new Date(s.last_activity);
                }
                sessions.push(session);
            }
        }
        return sessions;
    }
    /**
     * Delete this sprite
     */
    async delete() {
        await this.client.deleteSprite(this.name);
    }
    /**
     * Alias for delete()
     */
    async destroy() {
        await this.delete();
    }
    /**
     * Upgrade this sprite to the latest version
     */
    async upgrade() {
        await this.client.upgradeSprite(this.name);
    }
}
//# sourceMappingURL=sprite.js.map