npm - opencodespaces - Versions diffs - 0.1.0 - Mend

opencodespaces 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (26) hide show

package/README.md +104 -0
package/dist/commands/login.d.ts +7 -0
package/dist/commands/login.js +42 -0
package/dist/commands/logout.d.ts +7 -0
package/dist/commands/logout.js +20 -0
package/dist/commands/sessions.d.ts +7 -0
package/dist/commands/sessions.js +76 -0
package/dist/commands/ssh.d.ts +12 -0
package/dist/commands/ssh.js +141 -0
package/dist/commands/sync.d.ts +14 -0
package/dist/commands/sync.js +353 -0
package/dist/commands/whoami.d.ts +7 -0
package/dist/commands/whoami.js +50 -0
package/dist/index.d.ts +18 -0
package/dist/index.js +38 -0
package/dist/lib/api.d.ts +96 -0
package/dist/lib/api.js +130 -0
package/dist/lib/auth.d.ts +34 -0
package/dist/lib/auth.js +174 -0
package/dist/lib/config.d.ts +74 -0
package/dist/lib/config.js +184 -0
package/dist/lib/version.d.ts +4 -0
package/dist/lib/version.js +4 -0
package/dist/utils/logger.d.ts +45 -0
package/dist/utils/logger.js +66 -0
package/package.json +58 -0

package/dist/lib/auth.d.ts ADDED Viewed

@@ -0,0 +1,34 @@
+/**
+ * Authentication via Browser OAuth
+ *
+ * Flow:
+ * 1. CLI starts local HTTP server on available port
+ * 2. Opens browser to server's /api/auth/cli endpoint with redirect URL
+ * 3. User authenticates via Google OAuth
+ * 4. Server redirects back to localhost with JWT token
+ * 5. CLI stores token in credentials file
+ */
+interface AuthResult {
+    success: boolean;
+    token?: string;
+    email?: string;
+    name?: string;
+    error?: string;
+}
+/**
+ * Perform browser-based OAuth login
+ */
+export declare function browserLogin(serverUrl?: string): Promise<AuthResult>;
+/**
+ * Check if user is logged in
+ */
+export declare function isLoggedIn(): boolean;
+/**
+ * Get stored credentials
+ */
+export declare function getCredentials(): import("./config.js").Credentials | null;
+/**
+ * Logout - remove stored credentials
+ */
+export declare function logout(): void;
+export {};

package/dist/lib/auth.js ADDED Viewed

@@ -0,0 +1,174 @@
+/**
+ * Authentication via Browser OAuth
+ *
+ * Flow:
+ * 1. CLI starts local HTTP server on available port
+ * 2. Opens browser to server's /api/auth/cli endpoint with redirect URL
+ * 3. User authenticates via Google OAuth
+ * 4. Server redirects back to localhost with JWT token
+ * 5. CLI stores token in credentials file
+ */
+import http from 'http';
+import { URL } from 'url';
+import open from 'open';
+import { saveCredentials, loadCredentials, deleteCredentials, getServerUrl, } from './config.js';
+// Port range to try for local OAuth callback server
+const PORT_RANGE_START = 9876;
+const PORT_RANGE_END = 9900;
+/**
+ * Find an available port in the range
+ */
+async function findAvailablePort() {
+    for (let port = PORT_RANGE_START; port <= PORT_RANGE_END; port++) {
+        try {
+            await new Promise((resolve, reject) => {
+                const server = http.createServer();
+                server.listen(port, () => {
+                    server.close();
+                    resolve();
+                });
+                server.on('error', reject);
+            });
+            return port;
+        }
+        catch {
+            // Port in use, try next
+        }
+    }
+    throw new Error(`No available port in range ${PORT_RANGE_START}-${PORT_RANGE_END}`);
+}
+/**
+ * Start local server and wait for OAuth callback
+ */
+function startCallbackServer(port) {
+    return new Promise((resolve) => {
+        let timeoutId;
+        let resolved = false;
+        const cleanup = (result) => {
+            if (resolved)
+                return;
+            resolved = true;
+            clearTimeout(timeoutId);
+            server.close();
+            resolve(result);
+        };
+        const server = http.createServer((req, res) => {
+            const url = new URL(req.url || '/', `http://localhost:${port}`);
+            // Handle callback
+            if (url.pathname === '/callback') {
+                const token = url.searchParams.get('token');
+                const email = url.searchParams.get('email');
+                const name = url.searchParams.get('name');
+                const error = url.searchParams.get('error');
+                // Send response to browser
+                res.writeHead(200, { 'Content-Type': 'text/html' });
+                if (token) {
+                    res.end(`
+            <!DOCTYPE html>
+            <html>
+            <head>
+              <title>OpenCodeSpaces - Login Successful</title>
+              <style>
+                body { font-family: system-ui, sans-serif; display: flex; justify-content: center; align-items: center; height: 100vh; margin: 0; background: #0f172a; color: #f1f5f9; }
+                .container { text-align: center; padding: 2rem; }
+                h1 { color: #22c55e; margin-bottom: 0.5rem; }
+                p { color: #94a3b8; }
+              </style>
+            </head>
+            <body>
+              <div class="container">
+                <h1>✓ Login Successful</h1>
+                <p>You can close this window and return to your terminal.</p>
+              </div>
+            </body>
+            </html>
+          `);
+                    // Close server after short delay to ensure response is sent
+                    setTimeout(() => {
+                        cleanup({ success: true, token, email: email || undefined, name: name || undefined });
+                    }, 100);
+                }
+                else {
+                    res.end(`
+            <!DOCTYPE html>
+            <html>
+            <head>
+              <title>OpenCodeSpaces - Login Failed</title>
+              <style>
+                body { font-family: system-ui, sans-serif; display: flex; justify-content: center; align-items: center; height: 100vh; margin: 0; background: #0f172a; color: #f1f5f9; }
+                .container { text-align: center; padding: 2rem; }
+                h1 { color: #ef4444; margin-bottom: 0.5rem; }
+                p { color: #94a3b8; }
+              </style>
+            </head>
+            <body>
+              <div class="container">
+                <h1>✗ Login Failed</h1>
+                <p>${error || 'Unknown error occurred'}</p>
+              </div>
+            </body>
+            </html>
+          `);
+                    setTimeout(() => {
+                        cleanup({ success: false, error: error || 'Login failed' });
+                    }, 100);
+                }
+            }
+            else {
+                // Unknown path
+                res.writeHead(404);
+                res.end('Not found');
+            }
+        });
+        server.listen(port);
+        // Timeout after 5 minutes
+        timeoutId = setTimeout(() => {
+            cleanup({ success: false, error: 'Login timed out' });
+        }, 5 * 60 * 1000);
+    });
+}
+/**
+ * Perform browser-based OAuth login
+ */
+export async function browserLogin(serverUrl) {
+    const server = getServerUrl(serverUrl);
+    const port = await findAvailablePort();
+    const redirectUrl = `http://localhost:${port}/callback`;
+    // Build auth URL
+    const authUrl = `${server}/api/auth/cli?redirect=${encodeURIComponent(redirectUrl)}`;
+    // Start callback server
+    const authPromise = startCallbackServer(port);
+    // Open browser
+    await open(authUrl);
+    // Wait for callback
+    const result = await authPromise;
+    // Save credentials if successful
+    if (result.success && result.token) {
+        saveCredentials({
+            server,
+            token: result.token,
+            email: result.email,
+            name: result.name,
+        });
+    }
+    return result;
+}
+/**
+ * Check if user is logged in
+ */
+export function isLoggedIn() {
+    const creds = loadCredentials();
+    return !!creds?.token;
+}
+/**
+ * Get stored credentials
+ */
+export function getCredentials() {
+    return loadCredentials();
+}
+/**
+ * Logout - remove stored credentials
+ */
+export function logout() {
+    deleteCredentials();
+}

package/dist/lib/config.d.ts ADDED Viewed

@@ -0,0 +1,74 @@
+/**
+ * Configuration Management
+ *
+ * Priority: CLI argument > Environment variable > Config file > Default
+ */
+export declare const DEFAULT_IGNORES: string[];
+export interface Config {
+    server?: string;
+    ignores?: string[];
+}
+export interface Credentials {
+    server: string;
+    token: string;
+    email?: string;
+    name?: string;
+    expiresAt?: string;
+}
+/**
+ * Ensure config directory exists
+ */
+export declare function ensureConfigDir(): void;
+/**
+ * Get config directory path
+ */
+export declare function getConfigDir(): string;
+/**
+ * Get keys directory path
+ */
+export declare function getKeysDir(): string;
+/**
+ * Load configuration
+ */
+export declare function loadConfig(): Config;
+/**
+ * Save configuration
+ */
+export declare function saveConfig(config: Config): void;
+/**
+ * Get server URL with priority:
+ * 1. CLI argument (serverArg)
+ * 2. Environment variable (OPENCODESPACES_SERVER)
+ * 3. Config file (server key)
+ * 4. Credentials file (server from last login)
+ * 5. Default
+ */
+export declare function getServerUrl(serverArg?: string): string;
+/**
+ * Load stored credentials
+ */
+export declare function loadCredentials(): Credentials | null;
+/**
+ * Save credentials
+ */
+export declare function saveCredentials(credentials: Credentials): void;
+/**
+ * Delete credentials
+ */
+export declare function deleteCredentials(): void;
+/**
+ * Get ignore list from config or defaults
+ */
+export declare function getIgnoreList(): string[];
+/**
+ * Save SSH key for a session
+ */
+export declare function saveSessionKey(sessionId: string, privateKey: string): string;
+/**
+ * Delete SSH key for a session
+ */
+export declare function deleteSessionKey(sessionId: string): void;
+/**
+ * Get SSH key path for a session
+ */
+export declare function getSessionKeyPath(sessionId: string): string;

package/dist/lib/config.js ADDED Viewed

@@ -0,0 +1,184 @@
+/**
+ * Configuration Management
+ *
+ * Priority: CLI argument > Environment variable > Config file > Default
+ */
+import fs from 'fs';
+import path from 'path';
+import os from 'os';
+const CONFIG_DIR = path.join(os.homedir(), '.opencodespaces');
+const CONFIG_FILE = path.join(CONFIG_DIR, 'config.json');
+const CREDENTIALS_FILE = path.join(CONFIG_DIR, 'credentials.json');
+const KEYS_DIR = path.join(CONFIG_DIR, 'keys');
+// Default server URL
+const DEFAULT_SERVER = 'https://app.opencodespaces.dev';
+// Default ignore patterns for sync
+export const DEFAULT_IGNORES = [
+    'node_modules/',
+    '.git/',
+    '.DS_Store',
+    '*.log',
+    'dist/',
+    'build/',
+    'coverage/',
+    '.next/',
+    '__pycache__/',
+    'venv/',
+    '.venv/',
+    '.turbo/',
+    '.cache/',
+];
+/**
+ * Ensure config directory exists
+ */
+export function ensureConfigDir() {
+    if (!fs.existsSync(CONFIG_DIR)) {
+        fs.mkdirSync(CONFIG_DIR, { recursive: true });
+    }
+    if (!fs.existsSync(KEYS_DIR)) {
+        fs.mkdirSync(KEYS_DIR, { recursive: true });
+    }
+}
+/**
+ * Get config directory path
+ */
+export function getConfigDir() {
+    return CONFIG_DIR;
+}
+/**
+ * Get keys directory path
+ */
+export function getKeysDir() {
+    return KEYS_DIR;
+}
+/**
+ * Load configuration
+ */
+export function loadConfig() {
+    try {
+        if (fs.existsSync(CONFIG_FILE)) {
+            const content = fs.readFileSync(CONFIG_FILE, 'utf-8');
+            return JSON.parse(content);
+        }
+    }
+    catch {
+        // Ignore parse errors
+    }
+    return {};
+}
+/**
+ * Save configuration
+ */
+export function saveConfig(config) {
+    ensureConfigDir();
+    fs.writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2));
+}
+/**
+ * Get server URL with priority:
+ * 1. CLI argument (serverArg)
+ * 2. Environment variable (OPENCODESPACES_SERVER)
+ * 3. Config file (server key)
+ * 4. Credentials file (server from last login)
+ * 5. Default
+ */
+export function getServerUrl(serverArg) {
+    // 1. CLI argument
+    if (serverArg) {
+        return normalizeServerUrl(serverArg);
+    }
+    // 2. Environment variable
+    const envServer = process.env.OPENCODESPACES_SERVER;
+    if (envServer) {
+        return normalizeServerUrl(envServer);
+    }
+    // 3. Config file
+    const config = loadConfig();
+    if (config.server) {
+        return normalizeServerUrl(config.server);
+    }
+    // 4. Credentials file (use last logged-in server)
+    const creds = loadCredentials();
+    if (creds?.server) {
+        return normalizeServerUrl(creds.server);
+    }
+    // 5. Default
+    return DEFAULT_SERVER;
+}
+/**
+ * Normalize server URL (add https:// if missing, remove trailing slash)
+ */
+function normalizeServerUrl(url) {
+    let normalized = url.trim();
+    // Add protocol if missing
+    if (!normalized.startsWith('http://') && !normalized.startsWith('https://')) {
+        normalized = 'https://' + normalized;
+    }
+    // Remove trailing slash
+    if (normalized.endsWith('/')) {
+        normalized = normalized.slice(0, -1);
+    }
+    return normalized;
+}
+/**
+ * Load stored credentials
+ */
+export function loadCredentials() {
+    try {
+        if (fs.existsSync(CREDENTIALS_FILE)) {
+            const content = fs.readFileSync(CREDENTIALS_FILE, 'utf-8');
+            return JSON.parse(content);
+        }
+    }
+    catch {
+        // Ignore parse errors
+    }
+    return null;
+}
+/**
+ * Save credentials
+ */
+export function saveCredentials(credentials) {
+    ensureConfigDir();
+    fs.writeFileSync(CREDENTIALS_FILE, JSON.stringify(credentials, null, 2), {
+        mode: 0o600, // Restrict to owner only
+    });
+}
+/**
+ * Delete credentials
+ */
+export function deleteCredentials() {
+    if (fs.existsSync(CREDENTIALS_FILE)) {
+        fs.unlinkSync(CREDENTIALS_FILE);
+    }
+}
+/**
+ * Get ignore list from config or defaults
+ */
+export function getIgnoreList() {
+    const config = loadConfig();
+    return config.ignores || DEFAULT_IGNORES;
+}
+/**
+ * Save SSH key for a session
+ */
+export function saveSessionKey(sessionId, privateKey) {
+    ensureConfigDir();
+    const keyPath = path.join(KEYS_DIR, sessionId);
+    fs.writeFileSync(keyPath, privateKey, { mode: 0o600 });
+    return keyPath;
+}
+/**
+ * Delete SSH key for a session
+ */
+export function deleteSessionKey(sessionId) {
+    const keyPath = path.join(KEYS_DIR, sessionId);
+    if (fs.existsSync(keyPath)) {
+        fs.unlinkSync(keyPath);
+    }
+}
+/**
+ * Get SSH key path for a session
+ */
+export function getSessionKeyPath(sessionId) {
+    return path.join(KEYS_DIR, sessionId);
+}

package/dist/lib/version.d.ts ADDED Viewed

@@ -0,0 +1,4 @@
+/**
+ * CLI Version
+ */
+export declare const version = "0.1.0";

package/dist/lib/version.js ADDED Viewed

@@ -0,0 +1,4 @@
+/**
+ * CLI Version
+ */
+export const version = '0.1.0';

package/dist/utils/logger.d.ts ADDED Viewed

@@ -0,0 +1,45 @@
+/**
+ * Logger utility with colored output
+ */
+export declare const logger: {
+    /**
+     * Info message (blue)
+     */
+    info(message: string): void;
+    /**
+     * Success message (green)
+     */
+    success(message: string): void;
+    /**
+     * Warning message (yellow)
+     */
+    warn(message: string): void;
+    /**
+     * Error message (red)
+     */
+    error(message: string): void;
+    /**
+     * Plain message (no prefix)
+     */
+    log(message: string): void;
+    /**
+     * Dimmed message (for secondary info)
+     */
+    dim(message: string): void;
+    /**
+     * Bold message
+     */
+    bold(message: string): void;
+    /**
+     * Sync status arrow (up = local to remote)
+     */
+    syncUp(message: string): void;
+    /**
+     * Sync status arrow (down = remote to local)
+     */
+    syncDown(message: string): void;
+    /**
+     * Sync active indicator
+     */
+    syncActive(message: string): void;
+};

package/dist/utils/logger.js ADDED Viewed

@@ -0,0 +1,66 @@
+/**
+ * Logger utility with colored output
+ */
+import chalk from 'chalk';
+export const logger = {
+    /**
+     * Info message (blue)
+     */
+    info(message) {
+        console.log(chalk.blue('ℹ'), message);
+    },
+    /**
+     * Success message (green)
+     */
+    success(message) {
+        console.log(chalk.green('✓'), message);
+    },
+    /**
+     * Warning message (yellow)
+     */
+    warn(message) {
+        console.log(chalk.yellow('⚠'), message);
+    },
+    /**
+     * Error message (red)
+     */
+    error(message) {
+        console.error(chalk.red('✗'), message);
+    },
+    /**
+     * Plain message (no prefix)
+     */
+    log(message) {
+        console.log(message);
+    },
+    /**
+     * Dimmed message (for secondary info)
+     */
+    dim(message) {
+        console.log(chalk.dim(message));
+    },
+    /**
+     * Bold message
+     */
+    bold(message) {
+        console.log(chalk.bold(message));
+    },
+    /**
+     * Sync status arrow (up = local to remote)
+     */
+    syncUp(message) {
+        console.log(chalk.cyan('↑'), message);
+    },
+    /**
+     * Sync status arrow (down = remote to local)
+     */
+    syncDown(message) {
+        console.log(chalk.cyan('↓'), message);
+    },
+    /**
+     * Sync active indicator
+     */
+    syncActive(message) {
+        console.log(chalk.cyan('⟳'), message);
+    },
+};

package/package.json ADDED Viewed

@@ -0,0 +1,58 @@
+{
+  "name": "opencodespaces",
+  "version": "0.1.0",
+  "description": "CLI for OpenCodeSpaces - Connect your local IDE to cloud sessions",
+  "type": "module",
+  "bin": {
+    "opencodespaces": "./dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc -w",
+    "start": "node dist/index.js",
+    "prepublishOnly": "npm run build"
+  },
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "opencodespaces",
+    "cli",
+    "ide",
+    "sync",
+    "mutagen",
+    "ssh",
+    "cloud-development",
+    "remote-development",
+    "vscode",
+    "jetbrains"
+  ],
+  "author": "Johann Zelger <j.zelger@techdivision.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/techdivision-rnd/opencodespaces.git",
+    "directory": "packages/cli"
+  },
+  "bugs": {
+    "url": "https://github.com/techdivision-rnd/opencodespaces/issues"
+  },
+  "homepage": "https://github.com/techdivision-rnd/opencodespaces/tree/master/packages/cli#readme",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "chalk": "^5.3.0",
+    "commander": "^12.1.0",
+    "inquirer": "^12.4.0",
+    "open": "^10.1.0",
+    "ora": "^8.1.1",
+    "ws": "^8.18.0"
+  },
+  "devDependencies": {
+    "@types/inquirer": "^9.0.7",
+    "@types/node": "^22.10.2",
+    "@types/ws": "^8.5.13",
+    "typescript": "^5.7.2"
+  }
+}