TypeScript SDK for Railway that lets developers create sandboxes, run commands inside them, and manage sandbox filesystem files. It is useful for infrastructure-as-code workflows where you need to programmatically provision environments and execute commands, with support for streaming command output and reading or writing files to the sandbox.
Project status
- Actively maintained: The repository shows very recent upstream activity (last push on 2026-10-14) and multiple SDK updates published in October 2026 (v3.16.0 on 2026-10-14, v3.15.0 on 2026-10-12, v3.14.0 on 2026-10-12).
- Update cadence: Roughly every 1 to 10 days during mid-October 2026, with earlier 2026 updates also clustering in weeks (for example, v3.12.0 on 2026-09-29, then v3.11.0 on 2026-08-24). Overall, it looks like a generally steady, not dormant, release stream.
AI summary generated
Recent updates
v3.16.0
v3.16.0 adds support for configuring CDN caching per service in the Railway IaC DSL. The SDK and types now accept a new optional `cdn` block on service definitions, and the DSL docs describe the edge caching behavior.
Featuresv3.15.0
v3.15.0 adds support for Railway Functions to source their code from a local file via `fn(..., { codeFile })`. The SDK now reads the file at config evaluation time, base64-encodes it into the function service start command, and pins a default function runtime image.
Featuresv3.14.0
v3.14.0 adds typed support for Railway image auto-update maintenance windows and validates window bounds at IaC authoring time. It also expands IaC test coverage around deploy.preDeployTimeoutSeconds when using the preDeploy shorthand.
BreakingFeaturesv3.13.1
Release v3.13.1 is a small packaging change with a version bump from 3.13.0. The main modification is moving the `tsx` package from `dependencies` to `devDependencies`, and updating the lockfile accordingly.
Breakingv3.13.0
v3.13.0 introduces a new IaC option, `deploy.preDeployTimeoutSeconds`, and extends the Sandbox execution feature set with exec process controls, session capabilities, and a new HTTPS-based exec API (`execHttp`). The code diff shows significantly more behavioral changes around exec lifecycle, stdout/stderr sizing semantics, and cancellation/timeout handling than the release notes explicitly describe.
BreakingFeaturesv3.12.0
v3.12.0 adds support for publishing Railway-provided public HTTP domains on sandboxes and exposes them via the SDK. It also introduces an IaC feature to configure per-service tracing options inside Railway service environments. In addition, the GraphQL schema/types were regenerated, causing substantial type-level changes.
Featuresv3.11.0
v3.11.0 focuses on making `railway/iac` a thin authoring layer and updating the IaC CLI integration. Release notes only mention two internal PRs, one about PATH handling for node resolution in e2e tests, and one about slimming `railway/iac` into authoring-only behavior.
v3.10.0
v3.10.0 speeds up the live sandbox E2E suite and changes sandbox exec behavior to run commands through a login shell. The code diff also shows additional SDK and schema surface area changes beyond what is described in the release notes.
v3.9.0
Release v3.9.0 implements reuse of `/ws/files` connections across sequential file operations by pooling idle WebSocket sessions. It also updates the auto-release workflow to pass the repository name when dispatching the release workflow.
Featuresv3.8.1
v3.8.1 includes changes related to npm publishing identity and an asynchronous IaC ChangeSet apply behavior. The SDK update adds client-side polling for ChangeSet applies that start in an "applying" state.
Featuresv3.7.0
v3.7.0 adds a fix for interrupted sandbox exec sessions by detecting when the underlying exec socket closes before an exit frame is received. In that case, the exec handle now rejects with a dedicated error type that includes partial stdout and stderr.
BreakingFeaturesv3.6.0
v3.6.0 adds support for selecting a Railway region when creating sandboxes, and documents how region affects sandbox creation, templates, checkpoints, and forks. The code changes also expand the GraphQL-generated schema (including new fields and updated feature flag unions) beyond what the release notes mention.
Featuresv3.5.10
v3.5.10 adds support for restoring volume group membership from the environment canvas state, specifically using GraphQL canvas group references. It also updates the IaC graph generation so volume nodes can carry groupId based on those canvas group refs.
Featuresv3.5.9
v3.5.9 adds validation around IaC service image auto updates. The code enforces that autoUpdates is only supported for Docker image sources (Docker Hub and GHCR related registries), and adjusts IaC graph diffing to avoid planning drift when autoUpdates is present on unsupported sources.
Breakingv3.5.8
v3.5.8 updates the IaC graph generation to filter out canvas groups that are not referenced by resources in the imported environment. Instead of including all non-deleted groups, it now includes only groups referenced by services and buckets, plus their parent group chain.
Breaking