nstantpage-agent 0.2.2 → 0.3.1

package/dist/cli.js

@@ -20,7 +20,7 @@ const program = new Command();
 program
     .name('nstantpage')
     .description('Local development agent for nstantpage.com — run projects on your machine, preview in the cloud')
-    .version('0.2.0');
+    .version('0.3.0');
 program
     .command('login')
     .description('Authenticate with nstantpage.com')
@@ -28,12 +28,14 @@ program
 program
     .command('start')
     .description('Start the agent for a project (replaces cloud containers)')
-    .argument('[directory]', 'Project directory (defaults to current directory)', '.')
+    .argument('[directory]', 'Project directory (defaults to ~/.nstantpage/projects/<id>)', '.')
     .option('-p, --port <port>', 'Local dev server port', '3000')
     .option('-a, --api-port <port>', 'Local API server port (internal)', '18924')
     .option('--project-id <id>', 'Link to a specific project ID')
     .option('--gateway <url>', 'Gateway URL', 'wss://webprev.live')
+    .option('--backend <url>', 'Backend API URL (auto-detected from gateway)')
     .option('--token <token>', 'Auth token (skip login flow)')
+    .option('--dir <path>', 'Project directory override')
     .option('--no-dev', 'Skip starting the dev server (start manually later)')
     .action(startCommand);
 program

package/dist/commands/start.d.ts

@@ -2,9 +2,12 @@
  * Start command — launch the nstantpage agent
  *
  * Architecture:
- * 1. Start local API server (handles /live/* requests for file sync, checks, etc.)
- * 2. Start local dev server (Vite/Next.js — runs project on user's machine)
- * 3. Connect tunnel to gateway (relays requests from cloud to local machine)
+ * 1. Resolve or create project directory (~/.nstantpage/projects/{id}/)
+ * 2. Fetch project files from the backend API
+ * 3. Install dependencies (npm/pnpm)
+ * 4. Start local API server (handles /live/* requests for file sync, checks, etc.)
+ * 5. Start local dev server (Vite/Next.js — runs project on user's machine)
+ * 6. Connect tunnel to gateway (relays requests from cloud to local machine)
  *
  * The agent fully replaces Docker containers:
  * - Files are on the user's disk (no docker cp needed)
@@ -17,7 +20,9 @@ interface StartOptions {
     apiPort: string;
     projectId?: string;
     gateway: string;
+    backend?: string;
     token?: string;
+    dir?: string;
     noDev?: boolean;
 }
 export declare function startCommand(directory: string, options: StartOptions): Promise<void>;

package/dist/commands/start.js

@@ -2,9 +2,12 @@
  * Start command — launch the nstantpage agent
  *
  * Architecture:
- * 1. Start local API server (handles /live/* requests for file sync, checks, etc.)
- * 2. Start local dev server (Vite/Next.js — runs project on user's machine)
- * 3. Connect tunnel to gateway (relays requests from cloud to local machine)
+ * 1. Resolve or create project directory (~/.nstantpage/projects/{id}/)
+ * 2. Fetch project files from the backend API
+ * 3. Install dependencies (npm/pnpm)
+ * 4. Start local API server (handles /live/* requests for file sync, checks, etc.)
+ * 5. Start local dev server (Vite/Next.js — runs project on user's machine)
+ * 6. Connect tunnel to gateway (relays requests from cloud to local machine)
  *
  * The agent fully replaces Docker containers:
  * - Files are on the user's disk (no docker cp needed)
@@ -15,9 +18,85 @@
 import chalk from 'chalk';
 import path from 'path';
 import fs from 'fs';
+import os from 'os';
 import { getConfig } from '../config.js';
 import { TunnelClient } from '../tunnel.js';
 import { LocalServer } from '../localServer.js';
+import { PackageInstaller } from '../packageInstaller.js';
+const VERSION = '0.3.0';
+/**
+ * Resolve the backend API base URL.
+ * - If --backend is passed, use it
+ * - If gateway is local (ws://localhost), assume backend is localhost:5001
+ * - Otherwise, default to https://ntstantpage.com
+ */
+function resolveBackendUrl(options) {
+    if (options.backend)
+        return options.backend.replace(/\/$/, '');
+    const isLocal = /^wss?:\/\/(localhost|127\.0\.0\.1)/.test(options.gateway);
+    return isLocal ? 'http://localhost:5001' : 'https://ntstantpage.com';
+}
+/**
+ * Resolve project directory:
+ * - If --dir or [directory] arg given → use that
+ * - Otherwise → ~/.nstantpage/projects/{projectId}/
+ */
+function resolveProjectDir(directory, projectId, customDir) {
+    // Explicit --dir flag takes priority
+    if (customDir)
+        return path.resolve(customDir);
+    // If user passed a non-default directory argument (not '.')
+    if (directory !== '.')
+        return path.resolve(directory);
+    // Default: create in ~/.nstantpage/projects/{projectId}/
+    const defaultBase = path.join(os.homedir(), '.nstantpage', 'projects', projectId);
+    return defaultBase;
+}
+/**
+ * Fetch project files from the .NET backend and write them to disk.
+ */
+async function fetchProjectFiles(backendUrl, projectId, projectDir, token) {
+    const url = `${backendUrl}/api/sandbox/files?projectId=${projectId}`;
+    console.log(chalk.gray(`  Fetching project files...`));
+    const response = await fetch(url, {
+        headers: {
+            'Authorization': `Bearer ${token}`,
+            'Accept': 'application/json',
+        },
+    });
+    if (!response.ok) {
+        const text = await response.text().catch(() => '');
+        throw new Error(`Failed to fetch project files (${response.status}): ${text}`);
+    }
+    const data = await response.json();
+    if (!data.files || data.files.length === 0) {
+        throw new Error('No files returned from backend. Is the project ID correct?');
+    }
+    // Check if we already have this version (skip re-downloading)
+    const versionFile = path.join(projectDir, '.nstantpage-version');
+    const existingVersion = fs.existsSync(versionFile)
+        ? fs.readFileSync(versionFile, 'utf-8').trim()
+        : null;
+    if (existingVersion === String(data.versionId)) {
+        console.log(chalk.gray(`  Files up-to-date (version ${data.version})`));
+        return { fileCount: data.files.length, isNew: false };
+    }
+    // Write all files to disk
+    let written = 0;
+    for (const file of data.files) {
+        const filePath = path.join(projectDir, file.path);
+        const dir = path.dirname(filePath);
+        if (!fs.existsSync(dir)) {
+            fs.mkdirSync(dir, { recursive: true });
+        }
+        fs.writeFileSync(filePath, file.content, 'utf-8');
+        written++;
+    }
+    // Write version marker
+    fs.writeFileSync(versionFile, String(data.versionId), 'utf-8');
+    console.log(chalk.green(`  ✓ ${written} files downloaded (version ${data.version})`));
+    return { fileCount: written, isNew: true };
+}
 export async function startCommand(directory, options) {
     const conf = getConfig();
     // If --token was passed, persist it
@@ -36,53 +115,77 @@ export async function startCommand(directory, options) {
     if (!token && isLocalGateway) {
         token = 'local-dev';
     }
-    // Resolve project directory
-    const projectDir = path.resolve(directory);
-    if (!fs.existsSync(projectDir)) {
-        console.log(chalk.red(`✗ Directory not found: ${projectDir}`));
-        process.exit(1);
-    }
-    // Verify it's a project directory
-    if (!fs.existsSync(path.join(projectDir, 'package.json'))) {
-        console.log(chalk.red(`✗ No package.json found in ${projectDir}`));
-        console.log(chalk.gray('  Make sure you\'re in a project directory'));
-        process.exit(1);
-    }
     const devPort = parseInt(options.port, 10);
     const apiPort = parseInt(options.apiPort, 10);
     // Determine project ID
     let projectId = options.projectId || conf.get('projectId');
-    // Try .nstantpage.json in project dir
-    const localConfig = path.join(projectDir, '.nstantpage.json');
-    if (!projectId && fs.existsSync(localConfig)) {
-        try {
-            const data = JSON.parse(fs.readFileSync(localConfig, 'utf-8'));
-            projectId = data.projectId;
-        }
-        catch { }
-    }
     if (!projectId) {
         console.log(chalk.yellow('⚠ No project ID specified.'));
-        console.log(chalk.gray('  Use --project-id <id> or create a .nstantpage.json file'));
-        console.log(chalk.gray('  with { "projectId": "<your-project-id>" }'));
+        console.log(chalk.gray('  Use --project-id <id>'));
+        console.log(chalk.gray('  Example: npx nstantpage-agent start --project-id 1234'));
         process.exit(1);
     }
+    // Resolve project directory
+    const projectDir = resolveProjectDir(directory, projectId, options.dir);
+    // Create directory if it doesn't exist
+    if (!fs.existsSync(projectDir)) {
+        fs.mkdirSync(projectDir, { recursive: true });
+    }
     // Save project ID
     conf.set('projectId', projectId);
-    console.log(chalk.blue(`\n🚀 nstantpage agent v0.2.0\n`));
-    console.log(chalk.gray(`  Directory:    ${projectDir}`));
+    const backendUrl = resolveBackendUrl(options);
+    console.log(chalk.blue(`\n🚀 nstantpage agent v${VERSION}\n`));
     console.log(chalk.gray(`  Project ID:   ${projectId}`));
+    console.log(chalk.gray(`  Directory:    ${projectDir}`));
     console.log(chalk.gray(`  Dev server:   port ${devPort}`));
     console.log(chalk.gray(`  API server:   port ${apiPort}`));
-    console.log(chalk.gray(`  Gateway:      ${options.gateway}\n`));
-    // 1. Start local server (API + dev server)
+    console.log(chalk.gray(`  Gateway:      ${options.gateway}`));
+    console.log(chalk.gray(`  Backend:      ${backendUrl}\n`));
+    // 1. Fetch project files from the backend
+    try {
+        const { fileCount, isNew } = await fetchProjectFiles(backendUrl, projectId, projectDir, token);
+        // 2. Install dependencies if this is a new download or node_modules is missing
+        const hasNodeModules = fs.existsSync(path.join(projectDir, 'node_modules'));
+        if (isNew || !hasNodeModules) {
+            if (fs.existsSync(path.join(projectDir, 'package.json'))) {
+                console.log(chalk.gray('  Installing dependencies...'));
+                const installer = new PackageInstaller({ projectDir });
+                const result = await installer.install([], false);
+                if (result.success) {
+                    console.log(chalk.green(`  ✓ Dependencies installed`));
+                }
+                else {
+                    console.log(chalk.yellow(`  ⚠ Dependency installation had issues: ${result.output.slice(0, 200)}`));
+                }
+            }
+        }
+        else {
+            console.log(chalk.gray(`  Dependencies already installed`));
+        }
+    }
+    catch (err) {
+        console.log(chalk.yellow(`  ⚠ Could not fetch project files: ${err.message}`));
+        console.log(chalk.gray('    Continuing with existing local files (if any)...'));
+        // Don't exit — maybe local files exist from a previous run
+        if (!fs.existsSync(path.join(projectDir, 'package.json'))) {
+            console.log(chalk.red(`\n✗ No package.json found and cannot fetch files from backend.`));
+            console.log(chalk.gray('  Check your project ID and authentication.'));
+            process.exit(1);
+        }
+    }
+    // Save .nstantpage.json for future runs
+    const localConfigPath = path.join(projectDir, '.nstantpage.json');
+    if (!fs.existsSync(localConfigPath)) {
+        fs.writeFileSync(localConfigPath, JSON.stringify({ projectId }, null, 2), 'utf-8');
+    }
+    // 3. Start local server (API + dev server)
     const localServer = new LocalServer({
         projectDir,
         projectId,
         apiPort,
         devPort,
     });
-    // 2. Create tunnel client
+    // 4. Create tunnel client
     const tunnel = new TunnelClient({
         gatewayUrl: options.gateway,
         token,
@@ -133,6 +236,7 @@ export async function startCommand(directory, options) {
         console.log(chalk.blue.bold(`  ├──────────────────────────────────────────────┤`));
         console.log(chalk.white(`  │  Cloud:  https://${projectId}.webprev.live`));
         console.log(chalk.white(`  │  Local:  http://localhost:${devPort}`));
+        console.log(chalk.white(`  │  Files:  ${projectDir}`));
         console.log(chalk.blue.bold(`  └──────────────────────────────────────────────┘\n`));
         console.log(chalk.gray(`  Mode: ${chalk.green('Agent')} (no containers needed)`));
         console.log(chalk.gray(`  All builds, checks, and previews run on this machine.`));

package/dist/packageInstaller.js

@@ -18,7 +18,8 @@ export class PackageInstaller {
         const args = this.buildInstallArgs(pm, packages, dev);
         console.log(`  [Installer] ${pm} ${args.join(' ')}`);
         try {
-            const output = await this.runCommand(pm, args, 60_000);
+            const timeout = packages.length === 0 ? 120_000 : 60_000;
+            const output = await this.runCommand(pm, args, timeout);
             return {
                 success: true,
                 output,
@@ -57,6 +58,10 @@ export class PackageInstaller {
         return 'npm';
     }
     buildInstallArgs(pm, packages, dev) {
+        // If no packages specified, just run install (restore from lockfile)
+        if (packages.length === 0) {
+            return ['install'];
+        }
         const devFlag = dev
             ? (pm === 'npm' ? '--save-dev' : '-D')
             : '';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nstantpage-agent",
-  "version": "0.2.2",
+  "version": "0.3.1",
   "description": "Local development agent for nstantpage.com — run your projects locally, preview in the cloud. Replaces cloud containers for faster builds.",
   "type": "module",
   "bin": {