@computesdk/railway 1.2.2 → 2.0.0

package/README.md

@@ -1,6 +1,6 @@
 # @computesdk/railway
 
-Railway provider for ComputeSDK that enables creating and managing containerized sandboxes on Railway's infrastructure.
+Railway provider for ComputeSDK - run commands in [Railway Sandboxes](https://docs.railway.com/sandboxes), ephemeral compute environments backed by the Railway platform.
 
 ## Installation
 
@@ -8,69 +8,88 @@ Railway provider for ComputeSDK that enables creating and managing containerized
 npm install @computesdk/railway
 ```
 
-## Configuration
+> **Requires Node.js >= 22** — the underlying `railway` SDK depends on Node 22 APIs (e.g. global `WebSocket`).
+
+## Setup
 
-The Railway provider requires the following environment variables:
+1. Create a Railway API token at [railway.com/account/tokens](https://railway.com/account/tokens).
+2. Find the environment ID you want sandboxes to run in (Railway project → environment settings).
+3. Set the environment variables:
 
 ```bash
-RAILWAY_API_KEY=your_railway_api_key
-RAILWAY_PROJECT_ID=your_railway_project_id
-RAILWAY_ENVIRONMENT_ID=your_railway_environment_id
+export RAILWAY_API_TOKEN=your_token_here
+export RAILWAY_ENVIRONMENT_ID=your_environment_id_here
 ```
 
 ## Quick Start
 
-### Gateway Mode (Recommended)
-
-Use the gateway for zero-config auto-detection:
+Configure `compute` with the Railway provider and create a sandbox:
 
 ```typescript
 import { compute } from 'computesdk';
+import { railway } from '@computesdk/railway';
+
+compute.setConfig({
+  provider: railway({
+    token: process.env.RAILWAY_API_TOKEN,
+    environmentId: process.env.RAILWAY_ENVIRONMENT_ID,
+  }),
+});
 
-// Auto-detects Railway from RAILWAY_API_KEY/RAILWAY_PROJECT_ID/RAILWAY_ENVIRONMENT_ID environment variables
 const sandbox = await compute.sandbox.create();
-console.log(`Created sandbox: ${sandbox.sandboxId}`);
+
+const result = await sandbox.runCommand('echo "hello from Railway"');
+console.log(result.stdout);
 
 await sandbox.destroy();
 ```
 
-### Direct Mode
-
-For direct SDK usage without the gateway:
+Alternatively, call the provider factory directly when you only need one provider:
 
 ```typescript
 import { railway } from '@computesdk/railway';
 
-const compute = railway({
-  apiKey: process.env.RAILWAY_API_KEY,
-  projectId: process.env.RAILWAY_PROJECT_ID,
-  environmentId: process.env.RAILWAY_ENVIRONMENT_ID
-});
+const sdk = railway({ token: process.env.RAILWAY_API_TOKEN });
+const sandbox = await sdk.sandbox.create();
+```
 
-const sandbox = await compute.sandbox.create();
-console.log(`Created sandbox: ${sandbox.sandboxId}`);
+## Configuration
 
-await sandbox.destroy();
+### Environment Variables
+
+| Variable | Required | Description |
+|---|---|---|
+| `RAILWAY_API_TOKEN` | Yes | Railway API token used to authenticate. |
+| `RAILWAY_ENVIRONMENT_ID` | Recommended | Railway environment the sandbox runs in. |
+
+### Config options
+
+```typescript
+railway({
+  token: '...',          // defaults to RAILWAY_API_TOKEN
+  environmentId: '...',  // defaults to RAILWAY_ENVIRONMENT_ID
+});
 ```
 
-## Currently Implemented
+Per-command execution timeouts are supported via `runCommand`'s options (`{ timeout: ms }`), which maps to Railway's `timeoutSec`.
+
+## Supported Features
 
-### Sandbox Operations
-- **create()** - Creates a new Railway service with Docker container deployment
-- **destroy()** - Deletes a Railway service
+| Feature | Supported | Notes |
+|---|---|---|
+| Command execution (`runCommand`) | ✅ | Backed by `sandbox.exec`. `timeout` is mapped to Railway's `timeoutSec`. |
+| Filesystem (`filesystem.*`) | ✅ | Implemented over the shell (`cat`/`base64`/`mkdir`/`ls`/`rm`) since Railway has no dedicated filesystem API. |
+| List sandboxes (`list`) | ✅ | Enumerates sandboxes in the configured environment. |
+| Get / destroy by ID | ✅ | Via `Sandbox.connect` / `sandbox.destroy`. |
+| Port exposure (`getUrl`) | ❌ | Railway sandboxes do not expose public per-port URLs. |
+| Templates / snapshots | ❌ | Railway templates are a build-time builder (`Sandbox.template()`), not an ID-addressable resource, so they are not mapped to ComputeSDK templates/snapshots. |
 
-### Supported Runtimes
-- **node** - Uses `node:alpine` Docker image
-- **python** - Uses `python:alpine` Docker image (default)
+## Limitations
 
-### Configuration Options
-- **apiKey** - Railway API authentication token
-- **projectId** - Railway project identifier
-- **environmentId** - Railway environment identifier
+- **No port exposure.** `getUrl` throws — Railway sandboxes don't publish public URLs per port.
+- **Filesystem is shell-based.** File operations run shell commands inside the sandbox, so they require a POSIX shell with `base64`, `ls`, and the usual coreutils (present on Railway's default image).
+- **Templates/snapshots are not exposed.** Use the underlying `railway` SDK's `Sandbox.template()` builder directly if you need custom base images.
 
-## Notes
+## License
 
-- Services are automatically deployed upon creation
-- Service names are generated with timestamp: `sandbox-{timestamp}`
-- All operations use Railway's GraphQL API
-- Environment variables take precedence over config options
+MIT

package/dist/index.d.mts

@@ -1,25 +1,16 @@
+import * as _computesdk_provider from '@computesdk/provider';
+import { Sandbox } from 'railway';
+export { Sandbox as RailwaySandbox } from 'railway';
+
 /**
- * Railway package placeholder.
- *
- * Railway support previously depended on the hosted control-plane transport,
- * which has been removed from computesdk.
- */
-/**
- * Railway configuration (kept for compile-time compatibility of callers).
+ * Railway-specific configuration options
  */
 interface RailwayConfig {
-    /** Railway API key */
-    apiKey?: string;
-    /** Railway project ID */
-    projectId?: string;
-    /** Railway environment ID */
+    /** Railway API token - falls back to the RAILWAY_API_TOKEN environment variable */
+    token?: string;
+    /** Railway environment ID - falls back to the RAILWAY_ENVIRONMENT_ID environment variable */
     environmentId?: string;
 }
-/**
- * Railway provider entrypoint.
- *
- * This package no longer provides a direct provider implementation.
- */
-declare function railway(_config: RailwayConfig): never;
+declare const railway: (config: RailwayConfig) => _computesdk_provider.Provider<Sandbox, any, any>;
 
 export { type RailwayConfig, railway };

package/dist/index.d.ts

@@ -1,25 +1,16 @@
+import * as _computesdk_provider from '@computesdk/provider';
+import { Sandbox } from 'railway';
+export { Sandbox as RailwaySandbox } from 'railway';
+
 /**
- * Railway package placeholder.
- *
- * Railway support previously depended on the hosted control-plane transport,
- * which has been removed from computesdk.
- */
-/**
- * Railway configuration (kept for compile-time compatibility of callers).
+ * Railway-specific configuration options
  */
 interface RailwayConfig {
-    /** Railway API key */
-    apiKey?: string;
-    /** Railway project ID */
-    projectId?: string;
-    /** Railway environment ID */
+    /** Railway API token - falls back to the RAILWAY_API_TOKEN environment variable */
+    token?: string;
+    /** Railway environment ID - falls back to the RAILWAY_ENVIRONMENT_ID environment variable */
     environmentId?: string;
 }
-/**
- * Railway provider entrypoint.
- *
- * This package no longer provides a direct provider implementation.
- */
-declare function railway(_config: RailwayConfig): never;
+declare const railway: (config: RailwayConfig) => _computesdk_provider.Provider<Sandbox, any, any>;
 
 export { type RailwayConfig, railway };

package/dist/index.js

@@ -23,11 +23,194 @@ __export(index_exports, {
   railway: () => railway
 });
 module.exports = __toCommonJS(index_exports);
-function railway(_config) {
-  throw new Error(
-    "@computesdk/railway is no longer supported after control-plane removal. Use a direct provider package (for example @computesdk/e2b, @computesdk/modal, @computesdk/vercel, or @computesdk/daytona) with computesdk provider/providers config."
-  );
+var import_railway = require("railway");
+var import_provider = require("@computesdk/provider");
+var DEFAULT_TIMEOUT_MS = 3e5;
+function resolveClientOptions(config) {
+  const token = config.token || (typeof process !== "undefined" ? process.env?.RAILWAY_API_TOKEN : void 0);
+  if (!token) {
+    throw new Error(
+      "Missing Railway API token.\n\nCreate a token at https://railway.com/account/tokens\nThen pass it: railway({ token: 'xxx' })\nOr set RAILWAY_API_TOKEN in your environment."
+    );
+  }
+  const environmentId = config.environmentId || (typeof process !== "undefined" ? process.env?.RAILWAY_ENVIRONMENT_ID : void 0);
+  return { token, environmentId };
+}
+function mapStatus(status) {
+  switch (status) {
+    case "RUNNING":
+    case "CREATING":
+      return "running";
+    case "DESTROYING":
+    case "DESTROYED":
+      return "stopped";
+    case "FAILED":
+      return "error";
+    default:
+      return "running";
+  }
 }
+var ENV_KEY_PATTERN = /^[A-Za-z_][A-Za-z0-9_]*$/;
+function composeCommand(command, options) {
+  let fullCommand = command;
+  if (options?.env && Object.keys(options.env).length > 0) {
+    const envPrefix = Object.entries(options.env).map(([k, v]) => {
+      if (!ENV_KEY_PATTERN.test(k)) {
+        throw new Error(
+          `Invalid environment variable name "${k}". Names must match ${ENV_KEY_PATTERN}.`
+        );
+      }
+      return `${k}="${(0, import_provider.escapeShellArg)(String(v))}"`;
+    }).join(" ");
+    fullCommand = `${envPrefix} ${fullCommand}`;
+  }
+  if (options?.cwd) {
+    fullCommand = `cd "${(0, import_provider.escapeShellArg)(options.cwd)}" && ${fullCommand}`;
+  }
+  if (options?.background) {
+    fullCommand = `nohup ${fullCommand} > /dev/null 2>&1 &`;
+  }
+  return fullCommand;
+}
+var railway = (0, import_provider.defineProvider)({
+  name: "railway",
+  methods: {
+    sandbox: {
+      create: async (config, options) => {
+        const client = resolveClientOptions(config);
+        try {
+          const sandbox = await import_railway.Sandbox.create({
+            token: client.token,
+            environmentId: client.environmentId,
+            ...options?.envs ? { env: options.envs } : {},
+            ...options?.idleTimeoutMinutes !== void 0 ? { idleTimeoutMinutes: options.idleTimeoutMinutes } : {},
+            ...options?.networkIsolation !== void 0 ? { networkIsolation: options.networkIsolation } : {}
+          });
+          return { sandbox, sandboxId: sandbox.id };
+        } catch (error) {
+          throw new Error(
+            `Failed to create Railway sandbox: ${error instanceof Error ? error.message : String(error)}`
+          );
+        }
+      },
+      getById: async (config, sandboxId) => {
+        const client = resolveClientOptions(config);
+        try {
+          const sandbox = await import_railway.Sandbox.connect(sandboxId, client);
+          return { sandbox, sandboxId };
+        } catch (error) {
+          if (error instanceof import_railway.SandboxNotFoundError) return null;
+          throw error;
+        }
+      },
+      list: async (config) => {
+        const client = resolveClientOptions(config);
+        try {
+          const infos = await import_railway.Sandbox.list(client);
+          const connected = await Promise.allSettled(
+            infos.map(async (info) => {
+              const sandbox = await import_railway.Sandbox.connect(info.id, client);
+              return { sandbox, sandboxId: info.id };
+            })
+          );
+          return connected.filter(
+            (r) => r.status === "fulfilled"
+          ).map((r) => r.value);
+        } catch {
+          return [];
+        }
+      },
+      destroy: async (config, sandboxId) => {
+        const client = resolveClientOptions(config);
+        try {
+          const sandbox = await import_railway.Sandbox.connect(sandboxId, client);
+          await sandbox.destroy();
+        } catch {
+        }
+      },
+      runCommand: async (sandbox, command, options) => {
+        const startTime = Date.now();
+        const fullCommand = composeCommand(command, options);
+        const timeoutSec = options?.timeout ? Math.ceil(options.timeout / 1e3) : void 0;
+        try {
+          const result = await sandbox.exec(
+            fullCommand,
+            timeoutSec ? { timeoutSec } : void 0
+          );
+          return {
+            stdout: result.stdout,
+            stderr: result.stderr,
+            // exitCode is null when a signal ended the command; surface as -1
+            exitCode: result.exitCode ?? -1,
+            durationMs: Date.now() - startTime
+          };
+        } catch (error) {
+          return {
+            stdout: "",
+            stderr: error instanceof Error ? error.message : String(error),
+            exitCode: 127,
+            durationMs: Date.now() - startTime
+          };
+        }
+      },
+      getInfo: async (sandbox) => ({
+        id: sandbox.id,
+        provider: "railway",
+        status: mapStatus(sandbox.status),
+        createdAt: new Date(sandbox.createdAt),
+        timeout: DEFAULT_TIMEOUT_MS,
+        metadata: { networkIsolation: sandbox.networkIsolation }
+      }),
+      getUrl: async (_sandbox, _options) => {
+        throw new Error(
+          "Railway sandboxes do not support exposing ports / public URLs. Use sandbox-to-sandbox networking within a Railway environment instead."
+        );
+      },
+      filesystem: {
+        readFile: async (sandbox, path, runCommand) => {
+          const arg = (0, import_provider.escapeShellArg)(path);
+          const result = await runCommand(sandbox, `test -f "${arg}" && base64 < "${arg}" | tr -d '\\n'`);
+          if (result.exitCode !== 0) throw new Error(`File not found or unreadable: ${path}`);
+          return Buffer.from(result.stdout, "base64").toString("utf8");
+        },
+        writeFile: async (sandbox, path, content, runCommand) => {
+          const arg = (0, import_provider.escapeShellArg)(path);
+          const encoded = Buffer.from(content).toString("base64");
+          const result = await runCommand(sandbox, `echo "${encoded}" | base64 -d > "${arg}"`);
+          if (result.exitCode !== 0) throw new Error(`Failed to write file ${path}: ${result.stderr}`);
+        },
+        mkdir: async (sandbox, path, runCommand) => {
+          const result = await runCommand(sandbox, `mkdir -p "${(0, import_provider.escapeShellArg)(path)}"`);
+          if (result.exitCode !== 0) throw new Error(`Failed to create directory ${path}: ${result.stderr}`);
+        },
+        readdir: async (sandbox, path, runCommand) => {
+          const result = await runCommand(sandbox, `ls -la "${(0, import_provider.escapeShellArg)(path)}"`);
+          if (result.exitCode !== 0) throw new Error(`Failed to list directory ${path}: ${result.stderr}`);
+          return (result.stdout || "").split("\n").filter((line) => line.trim() && !line.startsWith("total")).map((line) => {
+            const parts = line.trim().split(/\s+/);
+            const name = parts.slice(8).join(" ");
+            const isDirectory = line.startsWith("d");
+            return {
+              name,
+              type: isDirectory ? "directory" : "file",
+              size: parseInt(parts[4]) || 0,
+              modified: /* @__PURE__ */ new Date()
+            };
+          }).filter((entry) => entry.name && entry.name !== "." && entry.name !== "..");
+        },
+        exists: async (sandbox, path, runCommand) => {
+          const result = await runCommand(sandbox, `test -e "${(0, import_provider.escapeShellArg)(path)}"`);
+          return result.exitCode === 0;
+        },
+        remove: async (sandbox, path, runCommand) => {
+          const result = await runCommand(sandbox, `rm -rf "${(0, import_provider.escapeShellArg)(path)}"`);
+          if (result.exitCode !== 0) throw new Error(`Failed to remove ${path}: ${result.stderr}`);
+        }
+      },
+      getInstance: (sandbox) => sandbox
+    }
+  }
+});
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   railway

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * Railway package placeholder.\n *\n * Railway support previously depended on the hosted control-plane transport,\n * which has been removed from computesdk.\n */\n\n/**\n * Railway configuration (kept for compile-time compatibility of callers).\n */\nexport interface RailwayConfig {\n  /** Railway API key */\n  apiKey?: string;\n  /** Railway project ID */\n  projectId?: string;\n  /** Railway environment ID */\n  environmentId?: string;\n}\n\n/**\n * Railway provider entrypoint.\n *\n * This package no longer provides a direct provider implementation.\n */\nexport function railway(_config: RailwayConfig): never {\n  throw new Error(\n    '@computesdk/railway is no longer supported after control-plane removal. ' +\n      'Use a direct provider package (for example @computesdk/e2b, @computesdk/modal, @computesdk/vercel, or @computesdk/daytona) with computesdk provider/providers config.'\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAwBO,SAAS,QAAQ,SAA+B;AACrD,QAAM,IAAI;AAAA,IACR;AAAA,EAEF;AACF;","names":[]}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * Railway Provider - Factory-based Implementation\n *\n * Wraps Railway Sandboxes (https://docs.railway.com/sandboxes) using the\n * ComputeSDK provider factory. Railway exposes command execution via\n * `sandbox.exec`; it has no dedicated filesystem or port-exposure API, so the\n * filesystem block is implemented over the shell and `getUrl` throws.\n */\n\nimport { Sandbox, SandboxNotFoundError } from 'railway';\nimport { defineProvider, escapeShellArg } from '@computesdk/provider';\n\nimport type { CommandResult, RunCommandOptions, SandboxInfo } from '@computesdk/provider';\nimport type { CreateSandboxOptions, FileEntry } from 'computesdk';\n\ntype RailwaySandbox = Sandbox;\n\ntype CommandRunner = (\n  sandbox: RailwaySandbox,\n  command: string,\n  options?: RunCommandOptions\n) => Promise<CommandResult>;\n\n/**\n * Railway-specific configuration options\n */\nexport interface RailwayConfig {\n  /** Railway API token - falls back to the RAILWAY_API_TOKEN environment variable */\n  token?: string;\n  /** Railway environment ID - falls back to the RAILWAY_ENVIRONMENT_ID environment variable */\n  environmentId?: string;\n}\n\n/** Options accepted by the Railway SDK's create/connect/list calls. */\ninterface RailwayClientOptions {\n  token: string;\n  environmentId?: string;\n}\n\nconst DEFAULT_TIMEOUT_MS = 300000;\n\n/**\n * Resolve and validate credentials, falling back to environment variables.\n * Throws a helpful error when the token is missing.\n */\nfunction resolveClientOptions(config: RailwayConfig): RailwayClientOptions {\n  const token =\n    config.token || (typeof process !== 'undefined' ? process.env?.RAILWAY_API_TOKEN : undefined);\n\n  if (!token) {\n    throw new Error(\n      'Missing Railway API token.\\n\\n' +\n        'Create a token at https://railway.com/account/tokens\\n' +\n        \"Then pass it: railway({ token: 'xxx' })\\n\" +\n        'Or set RAILWAY_API_TOKEN in your environment.'\n    );\n  }\n\n  const environmentId =\n    config.environmentId ||\n    (typeof process !== 'undefined' ? process.env?.RAILWAY_ENVIRONMENT_ID : undefined);\n\n  return { token, environmentId };\n}\n\n/** Map Railway's sandbox status onto the ComputeSDK status enum. */\nfunction mapStatus(status: string): SandboxInfo['status'] {\n  switch (status) {\n    case 'RUNNING':\n    case 'CREATING':\n      return 'running';\n    case 'DESTROYING':\n    case 'DESTROYED':\n      return 'stopped';\n    case 'FAILED':\n      return 'error';\n    default:\n      return 'running';\n  }\n}\n\n/** Valid POSIX shell environment variable name. Keys cannot be quoted in an\n * assignment prefix, so anything outside this set is rejected rather than escaped. */\nconst ENV_KEY_PATTERN = /^[A-Za-z_][A-Za-z0-9_]*$/;\n\n/** Apply env/cwd/background options by composing a single shell command string. */\nfunction composeCommand(command: string, options?: RunCommandOptions): string {\n  let fullCommand = command;\n\n  if (options?.env && Object.keys(options.env).length > 0) {\n    const envPrefix = Object.entries(options.env)\n      .map(([k, v]) => {\n        if (!ENV_KEY_PATTERN.test(k)) {\n          throw new Error(\n            `Invalid environment variable name \"${k}\". Names must match ${ENV_KEY_PATTERN}.`\n          );\n        }\n        return `${k}=\"${escapeShellArg(String(v))}\"`;\n      })\n      .join(' ');\n    fullCommand = `${envPrefix} ${fullCommand}`;\n  }\n\n  if (options?.cwd) {\n    fullCommand = `cd \"${escapeShellArg(options.cwd)}\" && ${fullCommand}`;\n  }\n\n  if (options?.background) {\n    fullCommand = `nohup ${fullCommand} > /dev/null 2>&1 &`;\n  }\n\n  return fullCommand;\n}\n\nexport const railway = defineProvider<RailwaySandbox, RailwayConfig>({\n  name: 'railway',\n  methods: {\n    sandbox: {\n      create: async (config: RailwayConfig, options?: CreateSandboxOptions) => {\n        const client = resolveClientOptions(config);\n\n        try {\n          const sandbox = await Sandbox.create({\n            token: client.token,\n            environmentId: client.environmentId,\n            ...(options?.envs ? { env: options.envs } : {}),\n            ...(options?.idleTimeoutMinutes !== undefined\n              ? { idleTimeoutMinutes: options.idleTimeoutMinutes }\n              : {}),\n            ...(options?.networkIsolation !== undefined\n              ? { networkIsolation: options.networkIsolation }\n              : {}),\n          });\n\n          return { sandbox, sandboxId: sandbox.id };\n        } catch (error) {\n          throw new Error(\n            `Failed to create Railway sandbox: ${error instanceof Error ? error.message : String(error)}`\n          );\n        }\n      },\n\n      getById: async (config: RailwayConfig, sandboxId: string) => {\n        const client = resolveClientOptions(config);\n        try {\n          const sandbox = await Sandbox.connect(sandboxId, client);\n          return { sandbox, sandboxId };\n        } catch (error) {\n          // Only a missing sandbox maps to null; surface auth/network/config errors.\n          if (error instanceof SandboxNotFoundError) return null;\n          throw error;\n        }\n      },\n\n      list: async (config: RailwayConfig) => {\n        const client = resolveClientOptions(config);\n        try {\n          const infos = await Sandbox.list(client);\n          const connected = await Promise.allSettled(\n            infos.map(async (info) => {\n              const sandbox = await Sandbox.connect(info.id, client);\n              return { sandbox, sandboxId: info.id };\n            })\n          );\n          return connected\n            .filter(\n              (r): r is PromiseFulfilledResult<{ sandbox: RailwaySandbox; sandboxId: string }> =>\n                r.status === 'fulfilled'\n            )\n            .map((r) => r.value);\n        } catch {\n          return [];\n        }\n      },\n\n      destroy: async (config: RailwayConfig, sandboxId: string) => {\n        const client = resolveClientOptions(config);\n        try {\n          const sandbox = await Sandbox.connect(sandboxId, client);\n          await sandbox.destroy();\n        } catch {\n          /* already destroyed or unreachable */\n        }\n      },\n\n      runCommand: async (\n        sandbox: RailwaySandbox,\n        command: string,\n        options?: RunCommandOptions\n      ): Promise<CommandResult> => {\n        const startTime = Date.now();\n        const fullCommand = composeCommand(command, options);\n        const timeoutSec = options?.timeout ? Math.ceil(options.timeout / 1000) : undefined;\n\n        try {\n          const result = await sandbox.exec(\n            fullCommand,\n            timeoutSec ? { timeoutSec } : undefined\n          );\n          return {\n            stdout: result.stdout,\n            stderr: result.stderr,\n            // exitCode is null when a signal ended the command; surface as -1\n            exitCode: result.exitCode ?? -1,\n            durationMs: Date.now() - startTime,\n          };\n        } catch (error) {\n          return {\n            stdout: '',\n            stderr: error instanceof Error ? error.message : String(error),\n            exitCode: 127,\n            durationMs: Date.now() - startTime,\n          };\n        }\n      },\n\n      getInfo: async (sandbox: RailwaySandbox): Promise<SandboxInfo> => ({\n        id: sandbox.id,\n        provider: 'railway',\n        status: mapStatus(sandbox.status),\n        createdAt: new Date(sandbox.createdAt),\n        timeout: DEFAULT_TIMEOUT_MS,\n        metadata: { networkIsolation: sandbox.networkIsolation },\n      }),\n\n      getUrl: async (_sandbox: RailwaySandbox, _options: { port: number; protocol?: string }): Promise<string> => {\n        throw new Error(\n          'Railway sandboxes do not support exposing ports / public URLs. ' +\n            'Use sandbox-to-sandbox networking within a Railway environment instead.'\n        );\n      },\n\n      filesystem: {\n        readFile: async (sandbox: RailwaySandbox, path: string, runCommand: CommandRunner): Promise<string> => {\n          const arg = escapeShellArg(path);\n          const result = await runCommand(sandbox, `test -f \"${arg}\" && base64 < \"${arg}\" | tr -d '\\\\n'`);\n          if (result.exitCode !== 0) throw new Error(`File not found or unreadable: ${path}`);\n          return Buffer.from(result.stdout, 'base64').toString('utf8');\n        },\n\n        writeFile: async (sandbox: RailwaySandbox, path: string, content: string, runCommand: CommandRunner): Promise<void> => {\n          const arg = escapeShellArg(path);\n          const encoded = Buffer.from(content).toString('base64');\n          const result = await runCommand(sandbox, `echo \"${encoded}\" | base64 -d > \"${arg}\"`);\n          if (result.exitCode !== 0) throw new Error(`Failed to write file ${path}: ${result.stderr}`);\n        },\n\n        mkdir: async (sandbox: RailwaySandbox, path: string, runCommand: CommandRunner): Promise<void> => {\n          const result = await runCommand(sandbox, `mkdir -p \"${escapeShellArg(path)}\"`);\n          if (result.exitCode !== 0) throw new Error(`Failed to create directory ${path}: ${result.stderr}`);\n        },\n\n        readdir: async (sandbox: RailwaySandbox, path: string, runCommand: CommandRunner): Promise<FileEntry[]> => {\n          const result = await runCommand(sandbox, `ls -la \"${escapeShellArg(path)}\"`);\n          if (result.exitCode !== 0) throw new Error(`Failed to list directory ${path}: ${result.stderr}`);\n\n          return (result.stdout || '')\n            .split('\\n')\n            .filter((line) => line.trim() && !line.startsWith('total'))\n            .map((line) => {\n              // `ls -la` columns: perms links owner group size month day time name…\n              // The name is everything from the 9th column on, so it survives spaces.\n              const parts = line.trim().split(/\\s+/);\n              const name = parts.slice(8).join(' ');\n              const isDirectory = line.startsWith('d');\n              return {\n                name,\n                type: isDirectory ? ('directory' as const) : ('file' as const),\n                size: parseInt(parts[4]) || 0,\n                modified: new Date(),\n              };\n            })\n            .filter((entry) => entry.name && entry.name !== '.' && entry.name !== '..');\n        },\n\n        exists: async (sandbox: RailwaySandbox, path: string, runCommand: CommandRunner): Promise<boolean> => {\n          const result = await runCommand(sandbox, `test -e \"${escapeShellArg(path)}\"`);\n          return result.exitCode === 0;\n        },\n\n        remove: async (sandbox: RailwaySandbox, path: string, runCommand: CommandRunner): Promise<void> => {\n          const result = await runCommand(sandbox, `rm -rf \"${escapeShellArg(path)}\"`);\n          if (result.exitCode !== 0) throw new Error(`Failed to remove ${path}: ${result.stderr}`);\n        },\n      },\n\n      getInstance: (sandbox: RailwaySandbox): RailwaySandbox => sandbox,\n    },\n  },\n});\n\nexport type { Sandbox as RailwaySandbox } from 'railway';\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AASA,qBAA8C;AAC9C,sBAA+C;AA6B/C,IAAM,qBAAqB;AAM3B,SAAS,qBAAqB,QAA6C;AACzE,QAAM,QACJ,OAAO,UAAU,OAAO,YAAY,cAAc,QAAQ,KAAK,oBAAoB;AAErF,MAAI,CAAC,OAAO;AACV,UAAM,IAAI;AAAA,MACR;AAAA,IAIF;AAAA,EACF;AAEA,QAAM,gBACJ,OAAO,kBACN,OAAO,YAAY,cAAc,QAAQ,KAAK,yBAAyB;AAE1E,SAAO,EAAE,OAAO,cAAc;AAChC;AAGA,SAAS,UAAU,QAAuC;AACxD,UAAQ,QAAQ;AAAA,IACd,KAAK;AAAA,IACL,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AAAA,IACL,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT;AACE,aAAO;AAAA,EACX;AACF;AAIA,IAAM,kBAAkB;AAGxB,SAAS,eAAe,SAAiB,SAAqC;AAC5E,MAAI,cAAc;AAElB,MAAI,SAAS,OAAO,OAAO,KAAK,QAAQ,GAAG,EAAE,SAAS,GAAG;AACvD,UAAM,YAAY,OAAO,QAAQ,QAAQ,GAAG,EACzC,IAAI,CAAC,CAAC,GAAG,CAAC,MAAM;AACf,UAAI,CAAC,gBAAgB,KAAK,CAAC,GAAG;AAC5B,cAAM,IAAI;AAAA,UACR,sCAAsC,CAAC,uBAAuB,eAAe;AAAA,QAC/E;AAAA,MACF;AACA,aAAO,GAAG,CAAC,SAAK,gCAAe,OAAO,CAAC,CAAC,CAAC;AAAA,IAC3C,CAAC,EACA,KAAK,GAAG;AACX,kBAAc,GAAG,SAAS,IAAI,WAAW;AAAA,EAC3C;AAEA,MAAI,SAAS,KAAK;AAChB,kBAAc,WAAO,gCAAe,QAAQ,GAAG,CAAC,QAAQ,WAAW;AAAA,EACrE;AAEA,MAAI,SAAS,YAAY;AACvB,kBAAc,SAAS,WAAW;AAAA,EACpC;AAEA,SAAO;AACT;AAEO,IAAM,cAAU,gCAA8C;AAAA,EACnE,MAAM;AAAA,EACN,SAAS;AAAA,IACP,SAAS;AAAA,MACP,QAAQ,OAAO,QAAuB,YAAmC;AACvE,cAAM,SAAS,qBAAqB,MAAM;AAE1C,YAAI;AACF,gBAAM,UAAU,MAAM,uBAAQ,OAAO;AAAA,YACnC,OAAO,OAAO;AAAA,YACd,eAAe,OAAO;AAAA,YACtB,GAAI,SAAS,OAAO,EAAE,KAAK,QAAQ,KAAK,IAAI,CAAC;AAAA,YAC7C,GAAI,SAAS,uBAAuB,SAChC,EAAE,oBAAoB,QAAQ,mBAAmB,IACjD,CAAC;AAAA,YACL,GAAI,SAAS,qBAAqB,SAC9B,EAAE,kBAAkB,QAAQ,iBAAiB,IAC7C,CAAC;AAAA,UACP,CAAC;AAED,iBAAO,EAAE,SAAS,WAAW,QAAQ,GAAG;AAAA,QAC1C,SAAS,OAAO;AACd,gBAAM,IAAI;AAAA,YACR,qCAAqC,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,CAAC;AAAA,UAC7F;AAAA,QACF;AAAA,MACF;AAAA,MAEA,SAAS,OAAO,QAAuB,cAAsB;AAC3D,cAAM,SAAS,qBAAqB,MAAM;AAC1C,YAAI;AACF,gBAAM,UAAU,MAAM,uBAAQ,QAAQ,WAAW,MAAM;AACvD,iBAAO,EAAE,SAAS,UAAU;AAAA,QAC9B,SAAS,OAAO;AAEd,cAAI,iBAAiB,oCAAsB,QAAO;AAClD,gBAAM;AAAA,QACR;AAAA,MACF;AAAA,MAEA,MAAM,OAAO,WAA0B;AACrC,cAAM,SAAS,qBAAqB,MAAM;AAC1C,YAAI;AACF,gBAAM,QAAQ,MAAM,uBAAQ,KAAK,MAAM;AACvC,gBAAM,YAAY,MAAM,QAAQ;AAAA,YAC9B,MAAM,IAAI,OAAO,SAAS;AACxB,oBAAM,UAAU,MAAM,uBAAQ,QAAQ,KAAK,IAAI,MAAM;AACrD,qBAAO,EAAE,SAAS,WAAW,KAAK,GAAG;AAAA,YACvC,CAAC;AAAA,UACH;AACA,iBAAO,UACJ;AAAA,YACC,CAAC,MACC,EAAE,WAAW;AAAA,UACjB,EACC,IAAI,CAAC,MAAM,EAAE,KAAK;AAAA,QACvB,QAAQ;AACN,iBAAO,CAAC;AAAA,QACV;AAAA,MACF;AAAA,MAEA,SAAS,OAAO,QAAuB,cAAsB;AAC3D,cAAM,SAAS,qBAAqB,MAAM;AAC1C,YAAI;AACF,gBAAM,UAAU,MAAM,uBAAQ,QAAQ,WAAW,MAAM;AACvD,gBAAM,QAAQ,QAAQ;AAAA,QACxB,QAAQ;AAAA,QAER;AAAA,MACF;AAAA,MAEA,YAAY,OACV,SACA,SACA,YAC2B;AAC3B,cAAM,YAAY,KAAK,IAAI;AAC3B,cAAM,cAAc,eAAe,SAAS,OAAO;AACnD,cAAM,aAAa,SAAS,UAAU,KAAK,KAAK,QAAQ,UAAU,GAAI,IAAI;AAE1E,YAAI;AACF,gBAAM,SAAS,MAAM,QAAQ;AAAA,YAC3B;AAAA,YACA,aAAa,EAAE,WAAW,IAAI;AAAA,UAChC;AACA,iBAAO;AAAA,YACL,QAAQ,OAAO;AAAA,YACf,QAAQ,OAAO;AAAA;AAAA,YAEf,UAAU,OAAO,YAAY;AAAA,YAC7B,YAAY,KAAK,IAAI,IAAI;AAAA,UAC3B;AAAA,QACF,SAAS,OAAO;AACd,iBAAO;AAAA,YACL,QAAQ;AAAA,YACR,QAAQ,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AAAA,YAC7D,UAAU;AAAA,YACV,YAAY,KAAK,IAAI,IAAI;AAAA,UAC3B;AAAA,QACF;AAAA,MACF;AAAA,MAEA,SAAS,OAAO,aAAmD;AAAA,QACjE,IAAI,QAAQ;AAAA,QACZ,UAAU;AAAA,QACV,QAAQ,UAAU,QAAQ,MAAM;AAAA,QAChC,WAAW,IAAI,KAAK,QAAQ,SAAS;AAAA,QACrC,SAAS;AAAA,QACT,UAAU,EAAE,kBAAkB,QAAQ,iBAAiB;AAAA,MACzD;AAAA,MAEA,QAAQ,OAAO,UAA0B,aAAmE;AAC1G,cAAM,IAAI;AAAA,UACR;AAAA,QAEF;AAAA,MACF;AAAA,MAEA,YAAY;AAAA,QACV,UAAU,OAAO,SAAyB,MAAc,eAA+C;AACrG,gBAAM,UAAM,gCAAe,IAAI;AAC/B,gBAAM,SAAS,MAAM,WAAW,SAAS,YAAY,GAAG,kBAAkB,GAAG,iBAAiB;AAC9F,cAAI,OAAO,aAAa,EAAG,OAAM,IAAI,MAAM,iCAAiC,IAAI,EAAE;AAClF,iBAAO,OAAO,KAAK,OAAO,QAAQ,QAAQ,EAAE,SAAS,MAAM;AAAA,QAC7D;AAAA,QAEA,WAAW,OAAO,SAAyB,MAAc,SAAiB,eAA6C;AACrH,gBAAM,UAAM,gCAAe,IAAI;AAC/B,gBAAM,UAAU,OAAO,KAAK,OAAO,EAAE,SAAS,QAAQ;AACtD,gBAAM,SAAS,MAAM,WAAW,SAAS,SAAS,OAAO,oBAAoB,GAAG,GAAG;AACnF,cAAI,OAAO,aAAa,EAAG,OAAM,IAAI,MAAM,wBAAwB,IAAI,KAAK,OAAO,MAAM,EAAE;AAAA,QAC7F;AAAA,QAEA,OAAO,OAAO,SAAyB,MAAc,eAA6C;AAChG,gBAAM,SAAS,MAAM,WAAW,SAAS,iBAAa,gCAAe,IAAI,CAAC,GAAG;AAC7E,cAAI,OAAO,aAAa,EAAG,OAAM,IAAI,MAAM,8BAA8B,IAAI,KAAK,OAAO,MAAM,EAAE;AAAA,QACnG;AAAA,QAEA,SAAS,OAAO,SAAyB,MAAc,eAAoD;AACzG,gBAAM,SAAS,MAAM,WAAW,SAAS,eAAW,gCAAe,IAAI,CAAC,GAAG;AAC3E,cAAI,OAAO,aAAa,EAAG,OAAM,IAAI,MAAM,4BAA4B,IAAI,KAAK,OAAO,MAAM,EAAE;AAE/F,kBAAQ,OAAO,UAAU,IACtB,MAAM,IAAI,EACV,OAAO,CAAC,SAAS,KAAK,KAAK,KAAK,CAAC,KAAK,WAAW,OAAO,CAAC,EACzD,IAAI,CAAC,SAAS;AAGb,kBAAM,QAAQ,KAAK,KAAK,EAAE,MAAM,KAAK;AACrC,kBAAM,OAAO,MAAM,MAAM,CAAC,EAAE,KAAK,GAAG;AACpC,kBAAM,cAAc,KAAK,WAAW,GAAG;AACvC,mBAAO;AAAA,cACL;AAAA,cACA,MAAM,cAAe,cAAyB;AAAA,cAC9C,MAAM,SAAS,MAAM,CAAC,CAAC,KAAK;AAAA,cAC5B,UAAU,oBAAI,KAAK;AAAA,YACrB;AAAA,UACF,CAAC,EACA,OAAO,CAAC,UAAU,MAAM,QAAQ,MAAM,SAAS,OAAO,MAAM,SAAS,IAAI;AAAA,QAC9E;AAAA,QAEA,QAAQ,OAAO,SAAyB,MAAc,eAAgD;AACpG,gBAAM,SAAS,MAAM,WAAW,SAAS,gBAAY,gCAAe,IAAI,CAAC,GAAG;AAC5E,iBAAO,OAAO,aAAa;AAAA,QAC7B;AAAA,QAEA,QAAQ,OAAO,SAAyB,MAAc,eAA6C;AACjG,gBAAM,SAAS,MAAM,WAAW,SAAS,eAAW,gCAAe,IAAI,CAAC,GAAG;AAC3E,cAAI,OAAO,aAAa,EAAG,OAAM,IAAI,MAAM,oBAAoB,IAAI,KAAK,OAAO,MAAM,EAAE;AAAA,QACzF;AAAA,MACF;AAAA,MAEA,aAAa,CAAC,YAA4C;AAAA,IAC5D;AAAA,EACF;AACF,CAAC;","names":[]}

package/dist/index.mjs

@@ -1,9 +1,192 @@
 // src/index.ts
-function railway(_config) {
-  throw new Error(
-    "@computesdk/railway is no longer supported after control-plane removal. Use a direct provider package (for example @computesdk/e2b, @computesdk/modal, @computesdk/vercel, or @computesdk/daytona) with computesdk provider/providers config."
-  );
+import { Sandbox, SandboxNotFoundError } from "railway";
+import { defineProvider, escapeShellArg } from "@computesdk/provider";
+var DEFAULT_TIMEOUT_MS = 3e5;
+function resolveClientOptions(config) {
+  const token = config.token || (typeof process !== "undefined" ? process.env?.RAILWAY_API_TOKEN : void 0);
+  if (!token) {
+    throw new Error(
+      "Missing Railway API token.\n\nCreate a token at https://railway.com/account/tokens\nThen pass it: railway({ token: 'xxx' })\nOr set RAILWAY_API_TOKEN in your environment."
+    );
+  }
+  const environmentId = config.environmentId || (typeof process !== "undefined" ? process.env?.RAILWAY_ENVIRONMENT_ID : void 0);
+  return { token, environmentId };
 }
+function mapStatus(status) {
+  switch (status) {
+    case "RUNNING":
+    case "CREATING":
+      return "running";
+    case "DESTROYING":
+    case "DESTROYED":
+      return "stopped";
+    case "FAILED":
+      return "error";
+    default:
+      return "running";
+  }
+}
+var ENV_KEY_PATTERN = /^[A-Za-z_][A-Za-z0-9_]*$/;
+function composeCommand(command, options) {
+  let fullCommand = command;
+  if (options?.env && Object.keys(options.env).length > 0) {
+    const envPrefix = Object.entries(options.env).map(([k, v]) => {
+      if (!ENV_KEY_PATTERN.test(k)) {
+        throw new Error(
+          `Invalid environment variable name "${k}". Names must match ${ENV_KEY_PATTERN}.`
+        );
+      }
+      return `${k}="${escapeShellArg(String(v))}"`;
+    }).join(" ");
+    fullCommand = `${envPrefix} ${fullCommand}`;
+  }
+  if (options?.cwd) {
+    fullCommand = `cd "${escapeShellArg(options.cwd)}" && ${fullCommand}`;
+  }
+  if (options?.background) {
+    fullCommand = `nohup ${fullCommand} > /dev/null 2>&1 &`;
+  }
+  return fullCommand;
+}
+var railway = defineProvider({
+  name: "railway",
+  methods: {
+    sandbox: {
+      create: async (config, options) => {
+        const client = resolveClientOptions(config);
+        try {
+          const sandbox = await Sandbox.create({
+            token: client.token,
+            environmentId: client.environmentId,
+            ...options?.envs ? { env: options.envs } : {},
+            ...options?.idleTimeoutMinutes !== void 0 ? { idleTimeoutMinutes: options.idleTimeoutMinutes } : {},
+            ...options?.networkIsolation !== void 0 ? { networkIsolation: options.networkIsolation } : {}
+          });
+          return { sandbox, sandboxId: sandbox.id };
+        } catch (error) {
+          throw new Error(
+            `Failed to create Railway sandbox: ${error instanceof Error ? error.message : String(error)}`
+          );
+        }
+      },
+      getById: async (config, sandboxId) => {
+        const client = resolveClientOptions(config);
+        try {
+          const sandbox = await Sandbox.connect(sandboxId, client);
+          return { sandbox, sandboxId };
+        } catch (error) {
+          if (error instanceof SandboxNotFoundError) return null;
+          throw error;
+        }
+      },
+      list: async (config) => {
+        const client = resolveClientOptions(config);
+        try {
+          const infos = await Sandbox.list(client);
+          const connected = await Promise.allSettled(
+            infos.map(async (info) => {
+              const sandbox = await Sandbox.connect(info.id, client);
+              return { sandbox, sandboxId: info.id };
+            })
+          );
+          return connected.filter(
+            (r) => r.status === "fulfilled"
+          ).map((r) => r.value);
+        } catch {
+          return [];
+        }
+      },
+      destroy: async (config, sandboxId) => {
+        const client = resolveClientOptions(config);
+        try {
+          const sandbox = await Sandbox.connect(sandboxId, client);
+          await sandbox.destroy();
+        } catch {
+        }
+      },
+      runCommand: async (sandbox, command, options) => {
+        const startTime = Date.now();
+        const fullCommand = composeCommand(command, options);
+        const timeoutSec = options?.timeout ? Math.ceil(options.timeout / 1e3) : void 0;
+        try {
+          const result = await sandbox.exec(
+            fullCommand,
+            timeoutSec ? { timeoutSec } : void 0
+          );
+          return {
+            stdout: result.stdout,
+            stderr: result.stderr,
+            // exitCode is null when a signal ended the command; surface as -1
+            exitCode: result.exitCode ?? -1,
+            durationMs: Date.now() - startTime
+          };
+        } catch (error) {
+          return {
+            stdout: "",
+            stderr: error instanceof Error ? error.message : String(error),
+            exitCode: 127,
+            durationMs: Date.now() - startTime
+          };
+        }
+      },
+      getInfo: async (sandbox) => ({
+        id: sandbox.id,
+        provider: "railway",
+        status: mapStatus(sandbox.status),
+        createdAt: new Date(sandbox.createdAt),
+        timeout: DEFAULT_TIMEOUT_MS,
+        metadata: { networkIsolation: sandbox.networkIsolation }
+      }),
+      getUrl: async (_sandbox, _options) => {
+        throw new Error(
+          "Railway sandboxes do not support exposing ports / public URLs. Use sandbox-to-sandbox networking within a Railway environment instead."
+        );
+      },
+      filesystem: {
+        readFile: async (sandbox, path, runCommand) => {
+          const arg = escapeShellArg(path);
+          const result = await runCommand(sandbox, `test -f "${arg}" && base64 < "${arg}" | tr -d '\\n'`);
+          if (result.exitCode !== 0) throw new Error(`File not found or unreadable: ${path}`);
+          return Buffer.from(result.stdout, "base64").toString("utf8");
+        },
+        writeFile: async (sandbox, path, content, runCommand) => {
+          const arg = escapeShellArg(path);
+          const encoded = Buffer.from(content).toString("base64");
+          const result = await runCommand(sandbox, `echo "${encoded}" | base64 -d > "${arg}"`);
+          if (result.exitCode !== 0) throw new Error(`Failed to write file ${path}: ${result.stderr}`);
+        },
+        mkdir: async (sandbox, path, runCommand) => {
+          const result = await runCommand(sandbox, `mkdir -p "${escapeShellArg(path)}"`);
+          if (result.exitCode !== 0) throw new Error(`Failed to create directory ${path}: ${result.stderr}`);
+        },
+        readdir: async (sandbox, path, runCommand) => {
+          const result = await runCommand(sandbox, `ls -la "${escapeShellArg(path)}"`);
+          if (result.exitCode !== 0) throw new Error(`Failed to list directory ${path}: ${result.stderr}`);
+          return (result.stdout || "").split("\n").filter((line) => line.trim() && !line.startsWith("total")).map((line) => {
+            const parts = line.trim().split(/\s+/);
+            const name = parts.slice(8).join(" ");
+            const isDirectory = line.startsWith("d");
+            return {
+              name,
+              type: isDirectory ? "directory" : "file",
+              size: parseInt(parts[4]) || 0,
+              modified: /* @__PURE__ */ new Date()
+            };
+          }).filter((entry) => entry.name && entry.name !== "." && entry.name !== "..");
+        },
+        exists: async (sandbox, path, runCommand) => {
+          const result = await runCommand(sandbox, `test -e "${escapeShellArg(path)}"`);
+          return result.exitCode === 0;
+        },
+        remove: async (sandbox, path, runCommand) => {
+          const result = await runCommand(sandbox, `rm -rf "${escapeShellArg(path)}"`);
+          if (result.exitCode !== 0) throw new Error(`Failed to remove ${path}: ${result.stderr}`);
+        }
+      },
+      getInstance: (sandbox) => sandbox
+    }
+  }
+});
 export {
   railway
 };

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * Railway package placeholder.\n *\n * Railway support previously depended on the hosted control-plane transport,\n * which has been removed from computesdk.\n */\n\n/**\n * Railway configuration (kept for compile-time compatibility of callers).\n */\nexport interface RailwayConfig {\n  /** Railway API key */\n  apiKey?: string;\n  /** Railway project ID */\n  projectId?: string;\n  /** Railway environment ID */\n  environmentId?: string;\n}\n\n/**\n * Railway provider entrypoint.\n *\n * This package no longer provides a direct provider implementation.\n */\nexport function railway(_config: RailwayConfig): never {\n  throw new Error(\n    '@computesdk/railway is no longer supported after control-plane removal. ' +\n      'Use a direct provider package (for example @computesdk/e2b, @computesdk/modal, @computesdk/vercel, or @computesdk/daytona) with computesdk provider/providers config.'\n  );\n}\n"],"mappings":";AAwBO,SAAS,QAAQ,SAA+B;AACrD,QAAM,IAAI;AAAA,IACR;AAAA,EAEF;AACF;","names":[]}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * Railway Provider - Factory-based Implementation\n *\n * Wraps Railway Sandboxes (https://docs.railway.com/sandboxes) using the\n * ComputeSDK provider factory. Railway exposes command execution via\n * `sandbox.exec`; it has no dedicated filesystem or port-exposure API, so the\n * filesystem block is implemented over the shell and `getUrl` throws.\n */\n\nimport { Sandbox, SandboxNotFoundError } from 'railway';\nimport { defineProvider, escapeShellArg } from '@computesdk/provider';\n\nimport type { CommandResult, RunCommandOptions, SandboxInfo } from '@computesdk/provider';\nimport type { CreateSandboxOptions, FileEntry } from 'computesdk';\n\ntype RailwaySandbox = Sandbox;\n\ntype CommandRunner = (\n  sandbox: RailwaySandbox,\n  command: string,\n  options?: RunCommandOptions\n) => Promise<CommandResult>;\n\n/**\n * Railway-specific configuration options\n */\nexport interface RailwayConfig {\n  /** Railway API token - falls back to the RAILWAY_API_TOKEN environment variable */\n  token?: string;\n  /** Railway environment ID - falls back to the RAILWAY_ENVIRONMENT_ID environment variable */\n  environmentId?: string;\n}\n\n/** Options accepted by the Railway SDK's create/connect/list calls. */\ninterface RailwayClientOptions {\n  token: string;\n  environmentId?: string;\n}\n\nconst DEFAULT_TIMEOUT_MS = 300000;\n\n/**\n * Resolve and validate credentials, falling back to environment variables.\n * Throws a helpful error when the token is missing.\n */\nfunction resolveClientOptions(config: RailwayConfig): RailwayClientOptions {\n  const token =\n    config.token || (typeof process !== 'undefined' ? process.env?.RAILWAY_API_TOKEN : undefined);\n\n  if (!token) {\n    throw new Error(\n      'Missing Railway API token.\\n\\n' +\n        'Create a token at https://railway.com/account/tokens\\n' +\n        \"Then pass it: railway({ token: 'xxx' })\\n\" +\n        'Or set RAILWAY_API_TOKEN in your environment.'\n    );\n  }\n\n  const environmentId =\n    config.environmentId ||\n    (typeof process !== 'undefined' ? process.env?.RAILWAY_ENVIRONMENT_ID : undefined);\n\n  return { token, environmentId };\n}\n\n/** Map Railway's sandbox status onto the ComputeSDK status enum. */\nfunction mapStatus(status: string): SandboxInfo['status'] {\n  switch (status) {\n    case 'RUNNING':\n    case 'CREATING':\n      return 'running';\n    case 'DESTROYING':\n    case 'DESTROYED':\n      return 'stopped';\n    case 'FAILED':\n      return 'error';\n    default:\n      return 'running';\n  }\n}\n\n/** Valid POSIX shell environment variable name. Keys cannot be quoted in an\n * assignment prefix, so anything outside this set is rejected rather than escaped. */\nconst ENV_KEY_PATTERN = /^[A-Za-z_][A-Za-z0-9_]*$/;\n\n/** Apply env/cwd/background options by composing a single shell command string. */\nfunction composeCommand(command: string, options?: RunCommandOptions): string {\n  let fullCommand = command;\n\n  if (options?.env && Object.keys(options.env).length > 0) {\n    const envPrefix = Object.entries(options.env)\n      .map(([k, v]) => {\n        if (!ENV_KEY_PATTERN.test(k)) {\n          throw new Error(\n            `Invalid environment variable name \"${k}\". Names must match ${ENV_KEY_PATTERN}.`\n          );\n        }\n        return `${k}=\"${escapeShellArg(String(v))}\"`;\n      })\n      .join(' ');\n    fullCommand = `${envPrefix} ${fullCommand}`;\n  }\n\n  if (options?.cwd) {\n    fullCommand = `cd \"${escapeShellArg(options.cwd)}\" && ${fullCommand}`;\n  }\n\n  if (options?.background) {\n    fullCommand = `nohup ${fullCommand} > /dev/null 2>&1 &`;\n  }\n\n  return fullCommand;\n}\n\nexport const railway = defineProvider<RailwaySandbox, RailwayConfig>({\n  name: 'railway',\n  methods: {\n    sandbox: {\n      create: async (config: RailwayConfig, options?: CreateSandboxOptions) => {\n        const client = resolveClientOptions(config);\n\n        try {\n          const sandbox = await Sandbox.create({\n            token: client.token,\n            environmentId: client.environmentId,\n            ...(options?.envs ? { env: options.envs } : {}),\n            ...(options?.idleTimeoutMinutes !== undefined\n              ? { idleTimeoutMinutes: options.idleTimeoutMinutes }\n              : {}),\n            ...(options?.networkIsolation !== undefined\n              ? { networkIsolation: options.networkIsolation }\n              : {}),\n          });\n\n          return { sandbox, sandboxId: sandbox.id };\n        } catch (error) {\n          throw new Error(\n            `Failed to create Railway sandbox: ${error instanceof Error ? error.message : String(error)}`\n          );\n        }\n      },\n\n      getById: async (config: RailwayConfig, sandboxId: string) => {\n        const client = resolveClientOptions(config);\n        try {\n          const sandbox = await Sandbox.connect(sandboxId, client);\n          return { sandbox, sandboxId };\n        } catch (error) {\n          // Only a missing sandbox maps to null; surface auth/network/config errors.\n          if (error instanceof SandboxNotFoundError) return null;\n          throw error;\n        }\n      },\n\n      list: async (config: RailwayConfig) => {\n        const client = resolveClientOptions(config);\n        try {\n          const infos = await Sandbox.list(client);\n          const connected = await Promise.allSettled(\n            infos.map(async (info) => {\n              const sandbox = await Sandbox.connect(info.id, client);\n              return { sandbox, sandboxId: info.id };\n            })\n          );\n          return connected\n            .filter(\n              (r): r is PromiseFulfilledResult<{ sandbox: RailwaySandbox; sandboxId: string }> =>\n                r.status === 'fulfilled'\n            )\n            .map((r) => r.value);\n        } catch {\n          return [];\n        }\n      },\n\n      destroy: async (config: RailwayConfig, sandboxId: string) => {\n        const client = resolveClientOptions(config);\n        try {\n          const sandbox = await Sandbox.connect(sandboxId, client);\n          await sandbox.destroy();\n        } catch {\n          /* already destroyed or unreachable */\n        }\n      },\n\n      runCommand: async (\n        sandbox: RailwaySandbox,\n        command: string,\n        options?: RunCommandOptions\n      ): Promise<CommandResult> => {\n        const startTime = Date.now();\n        const fullCommand = composeCommand(command, options);\n        const timeoutSec = options?.timeout ? Math.ceil(options.timeout / 1000) : undefined;\n\n        try {\n          const result = await sandbox.exec(\n            fullCommand,\n            timeoutSec ? { timeoutSec } : undefined\n          );\n          return {\n            stdout: result.stdout,\n            stderr: result.stderr,\n            // exitCode is null when a signal ended the command; surface as -1\n            exitCode: result.exitCode ?? -1,\n            durationMs: Date.now() - startTime,\n          };\n        } catch (error) {\n          return {\n            stdout: '',\n            stderr: error instanceof Error ? error.message : String(error),\n            exitCode: 127,\n            durationMs: Date.now() - startTime,\n          };\n        }\n      },\n\n      getInfo: async (sandbox: RailwaySandbox): Promise<SandboxInfo> => ({\n        id: sandbox.id,\n        provider: 'railway',\n        status: mapStatus(sandbox.status),\n        createdAt: new Date(sandbox.createdAt),\n        timeout: DEFAULT_TIMEOUT_MS,\n        metadata: { networkIsolation: sandbox.networkIsolation },\n      }),\n\n      getUrl: async (_sandbox: RailwaySandbox, _options: { port: number; protocol?: string }): Promise<string> => {\n        throw new Error(\n          'Railway sandboxes do not support exposing ports / public URLs. ' +\n            'Use sandbox-to-sandbox networking within a Railway environment instead.'\n        );\n      },\n\n      filesystem: {\n        readFile: async (sandbox: RailwaySandbox, path: string, runCommand: CommandRunner): Promise<string> => {\n          const arg = escapeShellArg(path);\n          const result = await runCommand(sandbox, `test -f \"${arg}\" && base64 < \"${arg}\" | tr -d '\\\\n'`);\n          if (result.exitCode !== 0) throw new Error(`File not found or unreadable: ${path}`);\n          return Buffer.from(result.stdout, 'base64').toString('utf8');\n        },\n\n        writeFile: async (sandbox: RailwaySandbox, path: string, content: string, runCommand: CommandRunner): Promise<void> => {\n          const arg = escapeShellArg(path);\n          const encoded = Buffer.from(content).toString('base64');\n          const result = await runCommand(sandbox, `echo \"${encoded}\" | base64 -d > \"${arg}\"`);\n          if (result.exitCode !== 0) throw new Error(`Failed to write file ${path}: ${result.stderr}`);\n        },\n\n        mkdir: async (sandbox: RailwaySandbox, path: string, runCommand: CommandRunner): Promise<void> => {\n          const result = await runCommand(sandbox, `mkdir -p \"${escapeShellArg(path)}\"`);\n          if (result.exitCode !== 0) throw new Error(`Failed to create directory ${path}: ${result.stderr}`);\n        },\n\n        readdir: async (sandbox: RailwaySandbox, path: string, runCommand: CommandRunner): Promise<FileEntry[]> => {\n          const result = await runCommand(sandbox, `ls -la \"${escapeShellArg(path)}\"`);\n          if (result.exitCode !== 0) throw new Error(`Failed to list directory ${path}: ${result.stderr}`);\n\n          return (result.stdout || '')\n            .split('\\n')\n            .filter((line) => line.trim() && !line.startsWith('total'))\n            .map((line) => {\n              // `ls -la` columns: perms links owner group size month day time name…\n              // The name is everything from the 9th column on, so it survives spaces.\n              const parts = line.trim().split(/\\s+/);\n              const name = parts.slice(8).join(' ');\n              const isDirectory = line.startsWith('d');\n              return {\n                name,\n                type: isDirectory ? ('directory' as const) : ('file' as const),\n                size: parseInt(parts[4]) || 0,\n                modified: new Date(),\n              };\n            })\n            .filter((entry) => entry.name && entry.name !== '.' && entry.name !== '..');\n        },\n\n        exists: async (sandbox: RailwaySandbox, path: string, runCommand: CommandRunner): Promise<boolean> => {\n          const result = await runCommand(sandbox, `test -e \"${escapeShellArg(path)}\"`);\n          return result.exitCode === 0;\n        },\n\n        remove: async (sandbox: RailwaySandbox, path: string, runCommand: CommandRunner): Promise<void> => {\n          const result = await runCommand(sandbox, `rm -rf \"${escapeShellArg(path)}\"`);\n          if (result.exitCode !== 0) throw new Error(`Failed to remove ${path}: ${result.stderr}`);\n        },\n      },\n\n      getInstance: (sandbox: RailwaySandbox): RailwaySandbox => sandbox,\n    },\n  },\n});\n\nexport type { Sandbox as RailwaySandbox } from 'railway';\n"],"mappings":";AASA,SAAS,SAAS,4BAA4B;AAC9C,SAAS,gBAAgB,sBAAsB;AA6B/C,IAAM,qBAAqB;AAM3B,SAAS,qBAAqB,QAA6C;AACzE,QAAM,QACJ,OAAO,UAAU,OAAO,YAAY,cAAc,QAAQ,KAAK,oBAAoB;AAErF,MAAI,CAAC,OAAO;AACV,UAAM,IAAI;AAAA,MACR;AAAA,IAIF;AAAA,EACF;AAEA,QAAM,gBACJ,OAAO,kBACN,OAAO,YAAY,cAAc,QAAQ,KAAK,yBAAyB;AAE1E,SAAO,EAAE,OAAO,cAAc;AAChC;AAGA,SAAS,UAAU,QAAuC;AACxD,UAAQ,QAAQ;AAAA,IACd,KAAK;AAAA,IACL,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AAAA,IACL,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT;AACE,aAAO;AAAA,EACX;AACF;AAIA,IAAM,kBAAkB;AAGxB,SAAS,eAAe,SAAiB,SAAqC;AAC5E,MAAI,cAAc;AAElB,MAAI,SAAS,OAAO,OAAO,KAAK,QAAQ,GAAG,EAAE,SAAS,GAAG;AACvD,UAAM,YAAY,OAAO,QAAQ,QAAQ,GAAG,EACzC,IAAI,CAAC,CAAC,GAAG,CAAC,MAAM;AACf,UAAI,CAAC,gBAAgB,KAAK,CAAC,GAAG;AAC5B,cAAM,IAAI;AAAA,UACR,sCAAsC,CAAC,uBAAuB,eAAe;AAAA,QAC/E;AAAA,MACF;AACA,aAAO,GAAG,CAAC,KAAK,eAAe,OAAO,CAAC,CAAC,CAAC;AAAA,IAC3C,CAAC,EACA,KAAK,GAAG;AACX,kBAAc,GAAG,SAAS,IAAI,WAAW;AAAA,EAC3C;AAEA,MAAI,SAAS,KAAK;AAChB,kBAAc,OAAO,eAAe,QAAQ,GAAG,CAAC,QAAQ,WAAW;AAAA,EACrE;AAEA,MAAI,SAAS,YAAY;AACvB,kBAAc,SAAS,WAAW;AAAA,EACpC;AAEA,SAAO;AACT;AAEO,IAAM,UAAU,eAA8C;AAAA,EACnE,MAAM;AAAA,EACN,SAAS;AAAA,IACP,SAAS;AAAA,MACP,QAAQ,OAAO,QAAuB,YAAmC;AACvE,cAAM,SAAS,qBAAqB,MAAM;AAE1C,YAAI;AACF,gBAAM,UAAU,MAAM,QAAQ,OAAO;AAAA,YACnC,OAAO,OAAO;AAAA,YACd,eAAe,OAAO;AAAA,YACtB,GAAI,SAAS,OAAO,EAAE,KAAK,QAAQ,KAAK,IAAI,CAAC;AAAA,YAC7C,GAAI,SAAS,uBAAuB,SAChC,EAAE,oBAAoB,QAAQ,mBAAmB,IACjD,CAAC;AAAA,YACL,GAAI,SAAS,qBAAqB,SAC9B,EAAE,kBAAkB,QAAQ,iBAAiB,IAC7C,CAAC;AAAA,UACP,CAAC;AAED,iBAAO,EAAE,SAAS,WAAW,QAAQ,GAAG;AAAA,QAC1C,SAAS,OAAO;AACd,gBAAM,IAAI;AAAA,YACR,qCAAqC,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,CAAC;AAAA,UAC7F;AAAA,QACF;AAAA,MACF;AAAA,MAEA,SAAS,OAAO,QAAuB,cAAsB;AAC3D,cAAM,SAAS,qBAAqB,MAAM;AAC1C,YAAI;AACF,gBAAM,UAAU,MAAM,QAAQ,QAAQ,WAAW,MAAM;AACvD,iBAAO,EAAE,SAAS,UAAU;AAAA,QAC9B,SAAS,OAAO;AAEd,cAAI,iBAAiB,qBAAsB,QAAO;AAClD,gBAAM;AAAA,QACR;AAAA,MACF;AAAA,MAEA,MAAM,OAAO,WAA0B;AACrC,cAAM,SAAS,qBAAqB,MAAM;AAC1C,YAAI;AACF,gBAAM,QAAQ,MAAM,QAAQ,KAAK,MAAM;AACvC,gBAAM,YAAY,MAAM,QAAQ;AAAA,YAC9B,MAAM,IAAI,OAAO,SAAS;AACxB,oBAAM,UAAU,MAAM,QAAQ,QAAQ,KAAK,IAAI,MAAM;AACrD,qBAAO,EAAE,SAAS,WAAW,KAAK,GAAG;AAAA,YACvC,CAAC;AAAA,UACH;AACA,iBAAO,UACJ;AAAA,YACC,CAAC,MACC,EAAE,WAAW;AAAA,UACjB,EACC,IAAI,CAAC,MAAM,EAAE,KAAK;AAAA,QACvB,QAAQ;AACN,iBAAO,CAAC;AAAA,QACV;AAAA,MACF;AAAA,MAEA,SAAS,OAAO,QAAuB,cAAsB;AAC3D,cAAM,SAAS,qBAAqB,MAAM;AAC1C,YAAI;AACF,gBAAM,UAAU,MAAM,QAAQ,QAAQ,WAAW,MAAM;AACvD,gBAAM,QAAQ,QAAQ;AAAA,QACxB,QAAQ;AAAA,QAER;AAAA,MACF;AAAA,MAEA,YAAY,OACV,SACA,SACA,YAC2B;AAC3B,cAAM,YAAY,KAAK,IAAI;AAC3B,cAAM,cAAc,eAAe,SAAS,OAAO;AACnD,cAAM,aAAa,SAAS,UAAU,KAAK,KAAK,QAAQ,UAAU,GAAI,IAAI;AAE1E,YAAI;AACF,gBAAM,SAAS,MAAM,QAAQ;AAAA,YAC3B;AAAA,YACA,aAAa,EAAE,WAAW,IAAI;AAAA,UAChC;AACA,iBAAO;AAAA,YACL,QAAQ,OAAO;AAAA,YACf,QAAQ,OAAO;AAAA;AAAA,YAEf,UAAU,OAAO,YAAY;AAAA,YAC7B,YAAY,KAAK,IAAI,IAAI;AAAA,UAC3B;AAAA,QACF,SAAS,OAAO;AACd,iBAAO;AAAA,YACL,QAAQ;AAAA,YACR,QAAQ,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AAAA,YAC7D,UAAU;AAAA,YACV,YAAY,KAAK,IAAI,IAAI;AAAA,UAC3B;AAAA,QACF;AAAA,MACF;AAAA,MAEA,SAAS,OAAO,aAAmD;AAAA,QACjE,IAAI,QAAQ;AAAA,QACZ,UAAU;AAAA,QACV,QAAQ,UAAU,QAAQ,MAAM;AAAA,QAChC,WAAW,IAAI,KAAK,QAAQ,SAAS;AAAA,QACrC,SAAS;AAAA,QACT,UAAU,EAAE,kBAAkB,QAAQ,iBAAiB;AAAA,MACzD;AAAA,MAEA,QAAQ,OAAO,UAA0B,aAAmE;AAC1G,cAAM,IAAI;AAAA,UACR;AAAA,QAEF;AAAA,MACF;AAAA,MAEA,YAAY;AAAA,QACV,UAAU,OAAO,SAAyB,MAAc,eAA+C;AACrG,gBAAM,MAAM,eAAe,IAAI;AAC/B,gBAAM,SAAS,MAAM,WAAW,SAAS,YAAY,GAAG,kBAAkB,GAAG,iBAAiB;AAC9F,cAAI,OAAO,aAAa,EAAG,OAAM,IAAI,MAAM,iCAAiC,IAAI,EAAE;AAClF,iBAAO,OAAO,KAAK,OAAO,QAAQ,QAAQ,EAAE,SAAS,MAAM;AAAA,QAC7D;AAAA,QAEA,WAAW,OAAO,SAAyB,MAAc,SAAiB,eAA6C;AACrH,gBAAM,MAAM,eAAe,IAAI;AAC/B,gBAAM,UAAU,OAAO,KAAK,OAAO,EAAE,SAAS,QAAQ;AACtD,gBAAM,SAAS,MAAM,WAAW,SAAS,SAAS,OAAO,oBAAoB,GAAG,GAAG;AACnF,cAAI,OAAO,aAAa,EAAG,OAAM,IAAI,MAAM,wBAAwB,IAAI,KAAK,OAAO,MAAM,EAAE;AAAA,QAC7F;AAAA,QAEA,OAAO,OAAO,SAAyB,MAAc,eAA6C;AAChG,gBAAM,SAAS,MAAM,WAAW,SAAS,aAAa,eAAe,IAAI,CAAC,GAAG;AAC7E,cAAI,OAAO,aAAa,EAAG,OAAM,IAAI,MAAM,8BAA8B,IAAI,KAAK,OAAO,MAAM,EAAE;AAAA,QACnG;AAAA,QAEA,SAAS,OAAO,SAAyB,MAAc,eAAoD;AACzG,gBAAM,SAAS,MAAM,WAAW,SAAS,WAAW,eAAe,IAAI,CAAC,GAAG;AAC3E,cAAI,OAAO,aAAa,EAAG,OAAM,IAAI,MAAM,4BAA4B,IAAI,KAAK,OAAO,MAAM,EAAE;AAE/F,kBAAQ,OAAO,UAAU,IACtB,MAAM,IAAI,EACV,OAAO,CAAC,SAAS,KAAK,KAAK,KAAK,CAAC,KAAK,WAAW,OAAO,CAAC,EACzD,IAAI,CAAC,SAAS;AAGb,kBAAM,QAAQ,KAAK,KAAK,EAAE,MAAM,KAAK;AACrC,kBAAM,OAAO,MAAM,MAAM,CAAC,EAAE,KAAK,GAAG;AACpC,kBAAM,cAAc,KAAK,WAAW,GAAG;AACvC,mBAAO;AAAA,cACL;AAAA,cACA,MAAM,cAAe,cAAyB;AAAA,cAC9C,MAAM,SAAS,MAAM,CAAC,CAAC,KAAK;AAAA,cAC5B,UAAU,oBAAI,KAAK;AAAA,YACrB;AAAA,UACF,CAAC,EACA,OAAO,CAAC,UAAU,MAAM,QAAQ,MAAM,SAAS,OAAO,MAAM,SAAS,IAAI;AAAA,QAC9E;AAAA,QAEA,QAAQ,OAAO,SAAyB,MAAc,eAAgD;AACpG,gBAAM,SAAS,MAAM,WAAW,SAAS,YAAY,eAAe,IAAI,CAAC,GAAG;AAC5E,iBAAO,OAAO,aAAa;AAAA,QAC7B;AAAA,QAEA,QAAQ,OAAO,SAAyB,MAAc,eAA6C;AACjG,gBAAM,SAAS,MAAM,WAAW,SAAS,WAAW,eAAe,IAAI,CAAC,GAAG;AAC3E,cAAI,OAAO,aAAa,EAAG,OAAM,IAAI,MAAM,oBAAoB,IAAI,KAAK,OAAO,MAAM,EAAE;AAAA,QACzF;AAAA,MACF;AAAA,MAEA,aAAa,CAAC,YAA4C;AAAA,IAC5D;AAAA,EACF;AACF,CAAC;","names":[]}

package/package.json

@@ -1,9 +1,12 @@
 {
   "name": "@computesdk/railway",
-  "version": "1.2.2",
-  "description": "Railway provider for ComputeSDK - simple cloud deployment for containerized sandboxes",
-  "author": "ComputeSDK Team",
+  "version": "2.0.0",
+  "description": "Railway Sandboxes provider for ComputeSDK - run commands in Railway-hosted sandboxes",
+  "author": "ComputeSDK",
   "license": "MIT",
+  "engines": {
+    "node": ">=22"
+  },
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
   "types": "./dist/index.d.ts",
@@ -18,8 +21,9 @@
     "dist"
   ],
   "dependencies": {
-    "@computesdk/provider": "2.0.0",
-    "computesdk": "4.0.0"
+    "railway": "^3.1.1",
+    "@computesdk/provider": "2.1.3",
+    "computesdk": "4.1.3"
   },
   "keywords": [
     "computesdk",
@@ -28,9 +32,7 @@
     "code-execution",
     "cloud",
     "compute",
-    "containers",
-    "provider",
-    "deployment"
+    "provider"
   ],
   "repository": {
     "type": "git",