computesdk 1.13.0 → 1.15.0

package/dist/index.js

@@ -1388,10 +1388,15 @@ var Server = class {
     this.stopHandler = handlers.stop;
     this.restartHandler = handlers.restart;
     this.updateStatusHandler = handlers.updateStatus;
+    this.logsHandler = handlers.logs;
   }
   /**
    * Start a new managed server with optional supervisor settings
    *
+   * **Install Phase:**
+   * If `install` is provided, it runs blocking before `start` (e.g., "npm install").
+   * The server status will be `installing` during this phase.
+   *
    * **Restart Policies:**
    * - `never` (default): No automatic restart on exit
    * - `on-failure`: Restart only on non-zero exit code
@@ -1409,14 +1414,15 @@ var Server = class {
    * // Basic server
    * const server = await sandbox.server.start({
    *   slug: 'web',
-   *   command: 'npm run dev',
+   *   start: 'npm run dev',
    *   path: '/app',
    * });
    *
-   * // With supervisor settings
+   * // With install command
    * const server = await sandbox.server.start({
    *   slug: 'api',
-   *   command: 'node server.js',
+   *   install: 'npm install',
+   *   start: 'node server.js',
    *   environment: { NODE_ENV: 'production' },
    *   restart_policy: 'always',
    *   max_restarts: 0, // unlimited
@@ -1468,6 +1474,29 @@ var Server = class {
   async updateStatus(slug, status) {
     await this.updateStatusHandler(slug, status);
   }
+  /**
+   * Retrieve captured output (logs) for a managed server
+   * @param slug - The server slug
+   * @param options - Options for log retrieval
+   * @returns Server logs info
+   *
+   * @example
+   * ```typescript
+   * // Get combined logs (default)
+   * const logs = await sandbox.server.logs('api');
+   * console.log(logs.logs);
+   *
+   * // Get only stdout
+   * const stdout = await sandbox.server.logs('api', { stream: 'stdout' });
+   *
+   * // Get only stderr
+   * const stderr = await sandbox.server.logs('api', { stream: 'stderr' });
+   * ```
+   */
+  async logs(slug, options) {
+    const response = await this.logsHandler(slug, options);
+    return response.data;
+  }
 };
 
 // src/client/resources/watcher.ts
@@ -1909,13 +1938,14 @@ var Overlay = class {
   /**
    * Create a new overlay from a template directory
    *
-   * The overlay symlinks files from the source directory into the target path,
-   * allowing instant access to template files. Heavy directories (node_modules,
-   * .venv, etc.) are copied in the background.
+   * The overlay copies files from the source directory into the target path
+   * for better isolation. Heavy directories (node_modules, .venv, etc.) are
+   * copied in the background. Use the `ignore` option to exclude files/directories.
    *
    * @param options - Overlay creation options
    * @param options.source - Absolute path to source directory
    * @param options.target - Relative path in sandbox
+   * @param options.ignore - Glob patterns to ignore (e.g., ["node_modules", "*.log"])
    * @returns Overlay info with copy status
    */
   async create(options) {
@@ -1959,8 +1989,8 @@ var Overlay = class {
       target: response.target,
       createdAt: response.created_at,
       stats: {
-        symlinkedFiles: response.stats.symlinked_files,
-        symlinkedDirs: response.stats.symlinked_dirs,
+        copiedFiles: response.stats.copied_files,
+        copiedDirs: response.stats.copied_dirs,
         skipped: response.stats.skipped
       },
       copyStatus: this.validateCopyStatus(response.copy_status),
@@ -2124,7 +2154,8 @@ var Sandbox = class {
       restart: async (slug) => this.restartServer(slug),
       updateStatus: async (slug, status) => {
         await this.updateServerStatus(slug, status);
-      }
+      },
+      logs: async (slug, options) => this.getServerLogs(slug, options)
     });
     this.watcher = new Watcher({
       create: async (path, options) => this.createWatcher(path, options),
@@ -2969,7 +3000,8 @@ API request failed (${response.status}): ${error}`
    *
    * @param options - Server configuration
    * @param options.slug - Unique server identifier
-   * @param options.command - Command to start the server
+   * @param options.install - Install command (optional, runs blocking before start, e.g., "npm install")
+   * @param options.start - Command to start the server (e.g., "npm run dev")
    * @param options.path - Working directory (optional)
    * @param options.env_file - Path to .env file relative to path (optional)
    * @param options.environment - Inline environment variables (merged with env_file if both provided)
@@ -2983,14 +3015,15 @@ API request failed (${response.status}): ${error}`
    * // Basic server
    * await sandbox.startServer({
    *   slug: 'web',
-   *   command: 'npm run dev',
+   *   start: 'npm run dev',
    *   path: '/app',
    * });
    *
-   * // With supervisor settings
+   * // With install command and supervisor settings
    * await sandbox.startServer({
    *   slug: 'api',
-   *   command: 'node server.js',
+   *   install: 'npm install',
+   *   start: 'node server.js',
    *   path: '/app',
    *   environment: { NODE_ENV: 'production', PORT: '3000' },
    *   restart_policy: 'on-failure',
@@ -3037,6 +3070,21 @@ API request failed (${response.status}): ${error}`
       }
     );
   }
+  /**
+   * Get logs for a managed server
+   * @param slug - Server slug
+   * @param options - Options for log retrieval
+   */
+  async getServerLogs(slug, options) {
+    const params = new URLSearchParams();
+    if (options?.stream) {
+      params.set("stream", options.stream);
+    }
+    const queryString = params.toString();
+    return this.request(
+      `/servers/${encodeURIComponent(slug)}/logs${queryString ? `?${queryString}` : ""}`
+    );
+  }
   /**
    * Update server status (internal use)
    * @param slug - Server slug
@@ -3318,7 +3366,9 @@ var PROVIDER_HEADERS = {
     tokenSecret: "X-Modal-Token-Secret"
   },
   railway: {
-    apiToken: "X-Railway-API-Token"
+    apiToken: "X-Railway-API-Key",
+    projectId: "X-Railway-Project-ID",
+    environmentId: "X-Railway-Environment-ID"
   },
   daytona: {
     apiKey: "X-Daytona-API-Key"