alchemy 2.0.0-beta.76 → 2.0.0-beta.77

package/src/Railway/Postgres.ts

@@ -2,12 +2,12 @@ import { randomBytes } from "node:crypto";
 import type {
   EnvironmentResponseVolumeInstancesEdgesItemNode,
   ProjectResponseServicesEdgesItemNode,
-  ServiceCreateResponse,
+  CreateServiceResponse,
   ServiceInstanceResponse,
   ServiceResponse,
-  ServiceUpdateResponse,
+  UpdateServiceResponse,
   TcpProxiesResultItem,
-  TcpProxyCreateResponse,
+  CreateTcpProxyResponse,
   VolumeInstanceResponse,
   VolumeState,
 } from "@distilled.cloud/railway";
@@ -333,15 +333,15 @@ class VolumePending extends Data.TaggedError("Railway.PostgresVolumePending")<{
 
 type CloudService =
   | ServiceResponse
-  | ServiceCreateResponse
-  | ServiceUpdateResponse
+  | CreateServiceResponse
+  | UpdateServiceResponse
   | ProjectResponseServicesEdgesItemNode;
 
 type CloudInstance =
   | EnvironmentResponseVolumeInstancesEdgesItemNode
   | VolumeInstanceResponse;
 
-type CloudProxy = TcpProxiesResultItem | TcpProxyCreateResponse;
+type CloudProxy = TcpProxiesResultItem | CreateTcpProxyResponse;
 
 const projectIdOf = (value: unknown): string | undefined => {
   if (value === null || typeof value !== "object") return undefined;
@@ -608,7 +608,7 @@ const findProxy = (
  * operation is already in progress". Already-gone proxies are a no-op.
  */
 const deleteProxy = (id: string) =>
-  railway.tcpProxyDelete({ id }).pipe(
+  railway.deleteTcpProxy({ id }).pipe(
     Effect.retry({
       while: (e) =>
         e._tag === "RailwayInternalError" &&
@@ -659,7 +659,7 @@ const upsertVariable = (input: {
   name: string;
   value: string;
 }) =>
-  railway.variableUpsert({
+  railway.upsertVariable({
     input: {
       projectId: input.projectId,
       environmentId: input.environmentId,
@@ -781,7 +781,7 @@ const waitForVolume = (
 };
 
 const stampVolumeName = (volumeId: string, name: string) =>
-  railway.volumeUpdate({
+  railway.updateVolume({
     volumeId,
     input: { name },
   });
@@ -988,7 +988,7 @@ export const PostgresProvider = () =>
 
       if (current === undefined) {
         const created = yield* railway
-          .serviceCreate({
+          .createService({
             input: {
               projectId,
               environmentId,
@@ -1013,7 +1013,7 @@ export const PostgresProvider = () =>
       }
 
       if (current.name !== name) {
-        current = yield* railway.serviceUpdate({
+        current = yield* railway.updateService({
           id: current.id,
           input: { name },
         });
@@ -1030,7 +1030,7 @@ export const PostgresProvider = () =>
         props.region !== undefined && props.region !== observedRegion;
       const sleepOn = instance?.sleepApplication !== false;
       if (imageChanged || regionChanged || sleepOn) {
-        yield* railway.serviceInstanceUpdate({
+        yield* railway.updateServiceInstance({
           environmentId,
           serviceId: current.id,
           input: {
@@ -1073,7 +1073,7 @@ export const PostgresProvider = () =>
         );
       }
       if (volume === undefined) {
-        const created = yield* railway.volumeCreate({
+        const created = yield* railway.createVolume({
           input: {
             projectId,
             environmentId,
@@ -1115,7 +1115,7 @@ export const PostgresProvider = () =>
       const mountChanged = observedMount !== POSTGRES_MOUNT_PATH;
       const attached = observedServiceId === current.id;
       if (mountChanged || !attached) {
-        yield* railway.volumeInstanceUpdate({
+        yield* railway.updateVolumeInstance({
           volumeId: volume.volumeId,
           environmentId,
           input: {
@@ -1132,7 +1132,7 @@ export const PostgresProvider = () =>
       let proxy = yield* findProxy(environmentId, current.id, POSTGRES_PORT);
       if (wantPublic && proxy === undefined) {
         const created = yield* railway
-          .tcpProxyCreate({
+          .createTcpProxy({
             input: {
               applicationPort: POSTGRES_PORT,
               environmentId,
@@ -1173,7 +1173,7 @@ export const PostgresProvider = () =>
       if (!deployFailed(finalStatus) && !deployReady(finalStatus)) {
         const wedged = instance?.latestDeployment?.id;
         if (wedged != null && wedged.length > 0) {
-          yield* railway.deploymentCancel({ id: wedged }).pipe(Effect.ignore);
+          yield* railway.cancelDeployment({ id: wedged }).pipe(Effect.ignore);
         }
         yield* railway
           .serviceInstanceDeployV2({ environmentId, serviceId: current.id })
@@ -1220,14 +1220,14 @@ export const PostgresProvider = () =>
           !deployFailed(latest.status)
         ) {
           yield* railway
-            .deploymentCancel({ id: latest.id })
+            .cancelDeployment({ id: latest.id })
             .pipe(Effect.ignore);
         }
       }
       // Delete the SERVICE next — its teardown cascades onto the proxies.
       if (serviceId.length > 0) {
         yield* railway
-          .serviceDelete({
+          .deleteService({
             id: serviceId,
             ...(environmentId.length > 0 ? { environmentId } : {}),
           })
@@ -1265,7 +1265,7 @@ export const PostgresProvider = () =>
       }
       if (output.volumeId.length > 0) {
         yield* railway
-          .volumeDelete({ volumeId: output.volumeId })
+          .deleteVolume({ volumeId: output.volumeId })
           .pipe(
             Effect.catchTag(["RailwayNotFound", "NotFound"], () => Effect.void),
           );

package/src/Railway/PrivateNetwork.ts

@@ -943,7 +943,7 @@ export const PrivateNetworkEndpointProvider = () =>
           prefix: desiredPrefix,
         });
         if (available) {
-          yield* railway.privateNetworkEndpointRename({
+          yield* railway.renamePrivateNetworkEndpoint({
             dnsName: desiredPrefix,
             id: current.publicId,
             privateNetworkId,
@@ -970,7 +970,7 @@ export const PrivateNetworkEndpointProvider = () =>
       const id = output.publicId;
       if (id.length === 0) return;
       yield* railway
-        .privateNetworkEndpointDelete({ id })
+        .deletePrivateNetworkEndpoint({ id })
         .pipe(
           Effect.catchTag(["RailwayNotFound", "NotFound"], () => Effect.void),
         );

package/src/Railway/Project.ts

@@ -1,7 +1,7 @@
 import type {
-  ProjectCreateResponse,
+  CreateProjectResponse,
   ProjectResponse,
-  ProjectUpdateResponse,
+  UpdateProjectResponse,
   ProjectsResponseEdgesItemNode,
 } from "@distilled.cloud/railway";
 import * as railway from "@distilled.cloud/railway";
@@ -157,8 +157,8 @@ export class ProjectNotCreated extends Data.TaggedError(
 
 type CloudProject =
   | ProjectResponse
-  | ProjectCreateResponse
-  | ProjectUpdateResponse
+  | CreateProjectResponse
+  | UpdateProjectResponse
   | ProjectsResponseEdgesItemNode;
 
 /** Workspace id from a get-by-id or list-node Project payload. */
@@ -244,7 +244,7 @@ export const createProject = (input: {
   defaultEnvironmentName?: string;
 }) =>
   waitOutCreateRateLimit(
-    railway.projectCreate({
+    railway.createProject({
       input: {
         name: input.name,
         workspaceId: input.workspaceId,
@@ -398,7 +398,7 @@ export const ProjectProvider = () =>
         props.description !== undefined &&
         props.description !== observedDescription;
       if (nameChanged || descriptionChanged) {
-        current = yield* railway.projectUpdate({
+        current = yield* railway.updateProject({
           id: current.id,
           input: {
             ...(nameChanged ? { name } : {}),
@@ -420,7 +420,7 @@ export const ProjectProvider = () =>
       const projectId = output.projectId;
       if (projectId.length === 0) return;
       yield* railway
-        .projectDelete({ id: projectId })
+        .deleteProject({ id: projectId })
         .pipe(
           Effect.catchTag(["RailwayNotFound", "NotFound"], () => Effect.void),
         );

package/src/Railway/ProjectEnvironment.ts

@@ -1,6 +1,6 @@
 import type {
-  EnvironmentCreateResponse,
-  EnvironmentRenameResponse,
+  CreateEnvironmentResponse,
+  RenameEnvironmentResponse,
   EnvironmentResponse,
   EnvironmentsResponseEdgesItemNode,
 } from "@distilled.cloud/railway";
@@ -169,8 +169,8 @@ export class EnvironmentProjectRequired extends Data.TaggedError(
 
 type CloudEnvironment =
   | EnvironmentResponse
-  | EnvironmentCreateResponse
-  | EnvironmentRenameResponse
+  | CreateEnvironmentResponse
+  | RenameEnvironmentResponse
   | EnvironmentsResponseEdgesItemNode;
 
 const toAttrs = (
@@ -323,7 +323,7 @@ export const EnvironmentProvider = () =>
 
       if (current === undefined) {
         const created = yield* waitOutCreateRateLimit(
-          railway.environmentCreate({
+          railway.createEnvironment({
             input: {
               name,
               projectId,
@@ -345,7 +345,7 @@ export const EnvironmentProvider = () =>
       }
 
       if (current.name !== name) {
-        current = yield* railway.environmentRename({
+        current = yield* railway.renameEnvironment({
           id: current.id,
           input: { name },
         });
@@ -358,7 +358,7 @@ export const EnvironmentProvider = () =>
       const environmentId = output.environmentId;
       if (environmentId.length === 0) return;
       yield* railway
-        .environmentDelete({ id: environmentId })
+        .deleteEnvironment({ id: environmentId })
         .pipe(
           Effect.catchTag(["RailwayNotFound", "NotFound"], () => Effect.void),
         );

package/src/Railway/Providers.ts

@@ -1,7 +1,7 @@
 import * as Layer from "effect/Layer";
 import * as FetchHttpClient from "effect/unstable/http/FetchHttpClient";
 import { CredentialsStoreLive } from "../Auth/Credentials.ts";
-import { ProfileLive } from "../Auth/Profile.ts";
+import { ProfileStoreLive } from "../Auth/Profile.ts";
 import * as Command from "../Command/index.ts";
 import * as Provider from "../Provider.ts";
 import { Random, RandomProvider } from "../Random.ts";
@@ -165,7 +165,7 @@ export const providers = () =>
     Layer.provideMerge(fromCredentials()),
     Layer.provideMerge(Credentials.fromAuthProvider()),
     Layer.provideMerge(RailwayAuth),
-    Layer.provideMerge(ProfileLive),
+    Layer.provideMerge(ProfileStoreLive),
     Layer.provideMerge(CredentialsStoreLive),
     Layer.provideMerge(FetchHttpClient.layer),
     Layer.provideMerge(Command.providers()),

package/src/Railway/Redis.ts

@@ -1,10 +1,10 @@
 import { randomBytes } from "node:crypto";
 import type {
   ProjectResponseServicesEdgesItemNode,
-  ServiceCreateResponse,
+  CreateServiceResponse,
   ServiceInstanceResponse,
   ServiceResponse,
-  ServiceUpdateResponse,
+  UpdateServiceResponse,
 } from "@distilled.cloud/railway";
 import * as railway from "@distilled.cloud/railway";
 import * as Data from "effect/Data";
@@ -289,8 +289,8 @@ class RedisDeployPending extends Data.TaggedError(
 
 type CloudService =
   | ServiceResponse
-  | ServiceCreateResponse
-  | ServiceUpdateResponse
+  | CreateServiceResponse
+  | UpdateServiceResponse
   | ProjectResponseServicesEdgesItemNode;
 
 const projectIdOf = (value: unknown): string | undefined => {
@@ -486,7 +486,7 @@ const upsertVariable = (input: {
   name: string;
   value: string;
 }) =>
-  railway.variableUpsert({
+  railway.upsertVariable({
     input: {
       projectId: input.projectId,
       environmentId: input.environmentId,
@@ -703,7 +703,7 @@ export const RedisProvider = () =>
 
       if (current === undefined) {
         const created = yield* railway
-          .serviceCreate({
+          .createService({
             input: {
               projectId,
               environmentId,
@@ -728,7 +728,7 @@ export const RedisProvider = () =>
       }
 
       if (current.name !== name) {
-        current = yield* railway.serviceUpdate({
+        current = yield* railway.updateService({
           id: current.id,
           input: { name },
         });
@@ -745,7 +745,7 @@ export const RedisProvider = () =>
       const observedStart = instance?.startCommand ?? undefined;
       const startChanged = (observedStart ?? undefined) !== startCommand;
       if (imageChanged || regionChanged || startChanged) {
-        yield* railway.serviceInstanceUpdate({
+        yield* railway.updateServiceInstance({
           environmentId,
           serviceId: current.id,
           input: {
@@ -791,7 +791,7 @@ export const RedisProvider = () =>
       const serviceId = output.serviceId;
       if (serviceId.length === 0) return;
       yield* railway
-        .serviceDelete({
+        .deleteService({
           id: serviceId,
           ...(output.environmentId.length > 0
             ? { environmentId: output.environmentId }

package/src/Railway/Sandbox.ts

@@ -1,8 +1,8 @@
 import type {
   SandboxCheckpointsResultItem,
-  SandboxCreateResponse,
+  CreateSandboxResponse,
   SandboxDestroyResponse,
-  SandboxExecResponse,
+  ExecSandboxResponse,
   SandboxHeartbeatResponse,
   SandboxNetworkIsolation,
   SandboxResponse,
@@ -289,7 +289,7 @@ class SandboxPending extends Data.TaggedError("Railway.SandboxPending")<{
 
 type CloudSandbox =
   | SandboxResponse
-  | SandboxCreateResponse
+  | CreateSandboxResponse
   | SandboxDestroyResponse
   | SandboxHeartbeatResponse
   | SandboxesResponseEdgesItemNode;
@@ -455,7 +455,7 @@ export const execSandbox = Effect.fn(function* (input: {
   command: string;
   timeoutSec?: number;
 }) {
-  return yield* railway.sandboxExec({
+  return yield* railway.execSandbox({
     command: input.command,
     environmentId: input.environmentId,
     id: input.sandboxId,
@@ -486,7 +486,7 @@ export const createSandboxCheckpoint = Effect.fn(function* (input: {
   environmentId: string;
   name: string;
 }) {
-  return yield* railway.sandboxCheckpointCreate({
+  return yield* railway.createSandboxCheckpoint({
     environmentId: input.environmentId,
     name: input.name,
     sandboxId: input.sandboxId,
@@ -527,7 +527,7 @@ export const renameSandboxCheckpoint = Effect.fn(function* (input: {
       name: input.name,
     });
   }
-  return yield* railway.sandboxCheckpointRename({
+  return yield* railway.renameSandboxCheckpoint({
     environmentId: input.environmentId,
     id: found.id,
     name: input.newName,
@@ -547,7 +547,7 @@ export const deleteSandboxCheckpoint = Effect.fn(function* (input: {
   const found = findCheckpoint(items, input.name);
   if (found === undefined) return;
   yield* railway
-    .sandboxCheckpointDelete({
+    .deleteSandboxCheckpoint({
       environmentId: input.environmentId,
       id: found.id,
     })
@@ -559,7 +559,7 @@ export type ExecRequest = {
   timeoutSec?: number;
 };
 
-export type ExecResult = SandboxExecResponse;
+export type ExecResult = ExecSandboxResponse;
 
 /**
  * Run a command inside a {@link Sandbox}. Control-plane GraphQL —
@@ -589,7 +589,7 @@ export const Exec = Binding.Service<Exec>("Railway.Sandbox.Exec");
 export interface ExecClient {
   (
     request: ExecRequest,
-  ): Effect.Effect<ExecResult, railway.SandboxExecError, RuntimeContext>;
+  ): Effect.Effect<ExecResult, railway.ExecSandboxError, RuntimeContext>;
 }
 
 /**
@@ -717,7 +717,7 @@ export const SandboxProvider = () =>
           : undefined;
 
       if (current === undefined) {
-        const created = yield* railway.sandboxCreate({
+        const created = yield* railway.createSandbox({
           input: {
             environmentId,
             ...(props.idleTimeoutMinutes !== undefined

package/src/Railway/Service.ts

@@ -59,6 +59,12 @@ export interface ServiceProps extends PlatformProps {
    * (`image` without `main`). A content-hash change updates in place.
    */
   main?: string;
+  /**
+   * Local Docker context uploaded with Railway `up`. Paths are relative to the
+   * initial working directory. Limited to a 32 MiB archive, 10,000 entries,
+   * ASCII paths, and no symlinks; Docker ignore files apply.
+   */
+  context?: string;
   /**
    * Docker image Railway should run.
    *
@@ -79,6 +85,12 @@ export interface ServiceProps extends PlatformProps {
    * `hashicorp/http-echo`.
    */
   port?: number;
+  /**
+   * Whether to create and manage a generated `*.up.railway.app` domain.
+   * Existing unowned generated or custom domains are not removed.
+   * @default true
+   */
+  publicDomain?: boolean;
   /**
    * Additional environment variables. Merged after binding-injected
    * `env`. Upserted as service-scoped Railway variables with
@@ -136,6 +148,21 @@ export interface ServiceProps extends PlatformProps {
    * {@link RailwayBuildOptions} (`build.install`).
    */
   buildCommand?: string;
+  /**
+   * Pre-deploy step Railway runs after the image build and before
+   * start (migrations, seed). Omit to leave the current Railway setting
+   * unchanged. Pass `{ command: null }` to clear it.
+   *
+   * @see https://docs.railway.com/deployments/pre-deploy-command
+   */
+  preDeploy?: {
+    /**
+     * Shell command Railway executes in a separate container after
+     * build and before start. Must exit 0 or the deployment fails.
+     * Pass `null` to clear it.
+     */
+    command: string | null;
+  };
   /**
    * Start command (`pnpm start`).
    */
@@ -186,7 +213,9 @@ export interface ServiceProps extends PlatformProps {
    */
   autoUpdates?: boolean;
   /**
-   * Dockerfile path relative to {@link rootDirectory}.
+   * Dockerfile path relative to {@link rootDirectory}, or to {@link context}
+   * for a local context.
+   * @default "Dockerfile"
    */
   dockerfilePath?: string;
   /**
@@ -344,6 +373,19 @@ const createServiceRuntimeContext = (id: string): ServiceRuntimeContext => {
  * ) {}
  * ```
  *
+ * ### Local Docker context
+ * `context` is a directory Railway builds with `up`. Mutually exclusive
+ * with `image` (without `main`) and `repo`. Docker ignore files apply.
+ *
+ * **Example:** Upload a local Dockerfile
+ * ```typescript
+ * const api = yield* Railway.Service("Api", {
+ *   project: site,
+ *   context: "./api",
+ *   port: 80,
+ * });
+ * ```
+ *
  * ### The public URL
  * Yield the Service in the Stack. `api.url` is
  * `https://{name}.up.railway.app`.
@@ -360,6 +402,22 @@ const createServiceRuntimeContext = (id: string): ServiceRuntimeContext => {
  * );
  * ```
  *
+ * ### Private service
+ * `publicDomain: false` skips the generated `*.up.railway.app` hostname.
+ * `url` / `domain` stay unset. Reach it on the private mesh at
+ * `{name}.railway.internal`. Unowned generated or custom domains are
+ * left alone.
+ *
+ * **Example:** Private-only service
+ * ```typescript
+ * const worker = yield* Railway.Service("Worker", {
+ *   project: site,
+ *   image: "hashicorp/http-echo",
+ *   port: 5678,
+ *   publicDomain: false,
+ * });
+ * ```
+ *
  * ### Pin a region
  * Omit `region` to use Railway's default. Updating it is in place.
  *
@@ -409,6 +467,19 @@ const createServiceRuntimeContext = (id: string): ServiceRuntimeContext => {
  * });
  * ```
  *
+ * ### Pre-deploy
+ * Railway runs `preDeploy.command` after the image build and before
+ * start — the same setting as the dashboard Pre-deploy Command.
+ *
+ * **Example:** Run migrations before traffic
+ * ```typescript
+ * const api = yield* Railway.Service("Api", {
+ *   project: site,
+ *   image: "hashicorp/http-echo",
+ *   preDeploy: { command: "bun --cwd apps/api migrate" },
+ * });
+ * ```
+ *
  * ### Cron
  * `cronSchedule` runs the service on a cron expression.
  *